Skip to content

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

Package listing

@kody/asana

src/get-task.ts

48 lines · 1.5 KB · TypeScript
import { asanaRequest } from './client.ts'
import { mapTask, TASK_FIELDS } from './models.ts'
import type { AsanaAuthInput, AsanaTaskSummary } from './types.ts'
import { optionalString, requireRecord, requireString } from './types.ts'
import { requireAuthMode } from './auth.ts'

export type GetTaskInput = AsanaAuthInput & {
	/** Task GID. */
	gid: string
}

/**
 * Get one Asana task by GID.
 * @example
 * import getTask from 'kody:@kody/asana/get-task'
 * const task = await getTask({ gid: '123' })
 */
export async function getTask(input: GetTaskInput): Promise<AsanaTaskSummary> {
	const gid = requireString(input.gid, 'gid')
	const result = await asanaRequest<unknown>({
		...input,
		operation: 'tasks.read',
		path: `/tasks/${encodeURIComponent(gid)}`,
		query: { opt_fields: TASK_FIELDS },
	})
	if (!result.data) throw new Error(`Asana task not found: ${gid}`)
	return mapTask(result.data)
}

/**
 * Get one Asana task by GID.
 * @example
 * import getTask from 'kody:@kody/asana/get-task'
 * const task = await getTask({ gid: '123' })
 */
export default async function getTaskEntrypoint(
	params: Partial<GetTaskInput> & Record<string, unknown> = {},
) {
	const input = requireRecord(params, 'get-task')
	return getTask({
		gid: requireString(input.gid, 'gid'),
		integrationName: optionalString(input.integrationName, 'integrationName'),
		integration: optionalString(input.integration, 'integration'),
		account: optionalString(input.account, 'account'),
		secretName: optionalString(input.secretName, 'secretName'),
		auth: requireAuthMode(input.auth),
	})
}