Skip to content

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

Package listing

@kody/linear

src/get-team.ts

50 lines · 1.6 KB · TypeScript
import { linearGraphql } from './client.ts'
import { mapTeam, TEAM_FIELDS } from './models.ts'
import type { LinearAuthInput, LinearTeamSummary } from './types.ts'
import { optionalString, requireRecord, requireString } from './types.ts'
import { requireAuthMode } from './auth.ts'

export type GetTeamInput = LinearAuthInput & {
	/** Team UUID or key (e.g. `ENG`). */
	id: string
}

/**
 * Get one Linear team by UUID or key.
 * @example
 * import getTeam from 'kody:@kody/linear/get-team'
 * const team = await getTeam({ id: 'ENG' })
 */
export async function getTeam(input: GetTeamInput): Promise<LinearTeamSummary> {
	const id = requireString(input.id, 'id')
	const result = await linearGraphql<{ team: unknown }>({
		...input,
		operation: 'query',
		query: `query GetTeam($id: String!) {
			team(id: $id) { ${TEAM_FIELDS} }
		}`,
		variables: { id },
	})
	if (!result.data.team) throw new Error(`Linear team not found: ${id}`)
	return mapTeam(result.data.team)
}

/**
 * Get one Linear team by UUID or key.
 * @example
 * import getTeam from 'kody:@kody/linear/get-team'
 * const team = await getTeam({ id: 'ENG' })
 */
export default async function getTeamEntrypoint(
	params: Partial<GetTeamInput> & Record<string, unknown> = {},
) {
	const input = requireRecord(params, 'get-team')
	return getTeam({
		id: requireString(input.id, 'id'),
		integrationName: optionalString(input.integrationName, 'integrationName'),
		integration: optionalString(input.integration, 'integration'),
		account: optionalString(input.account, 'account'),
		secretName: optionalString(input.secretName, 'secretName'),
		auth: requireAuthMode(input.auth),
	})
}