Skip to content

Built for people who want to own their automations. Join the waitlist for an invite.

Package listing

@kody/asana

src/list-projects.ts

77 lines · 2.4 KB · TypeScript
import { asanaRequest } from './client.ts'
import { mapProject, PROJECT_FIELDS } from './models.ts'
import type { AsanaAuthInput, AsanaPageInfo, AsanaProjectSummary } from './types.ts'
import {
	clampInt,
	compactRecord,
	optionalBoolean,
	optionalString,
	requireRecord,
} from './types.ts'
import { requireAuthMode } from './auth.ts'

export type ListProjectsInput = AsanaAuthInput & {
	workspaceGid?: string
	teamGid?: string
	archived?: boolean
	limit?: number
	offset?: string
}

export type ListProjectsResult = {
	items: Array<AsanaProjectSummary>
	pageInfo: AsanaPageInfo
}

/**
 * List Asana projects, optionally filtered by workspace or team.
 * @example
 * import listProjects from 'kody:@kody/asana/list-projects'
 * const { items } = await listProjects({ workspaceGid: '123', limit: 25 })
 */
export async function listProjects(
	input: ListProjectsInput = {},
): Promise<ListProjectsResult> {
	const limit = clampInt(input.limit, 1, 100, 25)
	const result = await asanaRequest<Array<unknown>>({
		...input,
		operation: 'projects.read',
		path: '/projects',
		query: compactRecord({
			workspace: optionalString(input.workspaceGid, 'workspaceGid'),
			team: optionalString(input.teamGid, 'teamGid'),
			archived: optionalBoolean(input.archived, 'archived'),
			limit,
			offset: optionalString(input.offset, 'offset'),
			opt_fields: PROJECT_FIELDS,
		}),
	})
	return {
		items: (Array.isArray(result.data) ? result.data : []).map(mapProject),
		pageInfo: result.pageInfo,
	}
}

/**
 * List Asana projects, optionally filtered by workspace or team.
 * @example
 * import listProjects from 'kody:@kody/asana/list-projects'
 * const result = await listProjects()
 */
export default async function listProjectsEntrypoint(
	params: ListProjectsInput & Record<string, unknown> = {},
) {
	const input = requireRecord(params, 'list-projects')
	return listProjects({
		workspaceGid: optionalString(input.workspaceGid, 'workspaceGid'),
		teamGid: optionalString(input.teamGid, 'teamGid'),
		archived: optionalBoolean(input.archived, 'archived'),
		limit: input.limit as number | undefined,
		offset: optionalString(input.offset, 'offset'),
		integrationName: optionalString(input.integrationName, 'integrationName'),
		integration: optionalString(input.integration, 'integration'),
		account: optionalString(input.account, 'account'),
		secretName: optionalString(input.secretName, 'secretName'),
		auth: requireAuthMode(input.auth),
	})
}