Skip to content

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

Package listing

@kody/workos

src/list-organizations.ts

69 lines · 2.3 KB · TypeScript
import { workosRequest } from './client.ts'
import { mapOrganization } from './models.ts'
import type { WorkosAuthInput, WorkosOrganizationSummary, WorkosPageInfo } from './types.ts'
import { clampInt, compactRecord, optionalString, optionalStringArray, requireRecord } from './types.ts'

export type ListOrganizationsInput = WorkosAuthInput & {
	domains?: Array<string>
	limit?: number
	after?: string
	before?: string
	order?: 'asc' | 'desc'
}

export type ListOrganizationsResult = {
	items: Array<WorkosOrganizationSummary>
	pageInfo: WorkosPageInfo
}

/**
 * List WorkOS organizations in the API-key environment.
 * @example
 * import listOrganizations from 'kody:@kody/workos/list-organizations'
 * const { items } = await listOrganizations({ limit: 20 })
 */
export async function listOrganizations(
	input: ListOrganizationsInput = {},
): Promise<ListOrganizationsResult> {
	const result = await workosRequest<Array<unknown>>({
		...input,
		operation: 'organizations.read',
		path: '/organizations',
		query: compactRecord({
			domains: optionalStringArray(input.domains, 'domains'),
			limit: clampInt(input.limit, 1, 100, 10),
			after: optionalString(input.after, 'after'),
			before: optionalString(input.before, 'before'),
			order: optionalString(input.order, 'order'),
		}),
	})
	return {
		items: (Array.isArray(result.data) ? result.data : []).map(mapOrganization),
		pageInfo: result.pageInfo,
	}
}

/**
 * List WorkOS organizations in the API-key environment.
 * @example
 * import listOrganizations from 'kody:@kody/workos/list-organizations'
 * const result = await listOrganizations()
 */
export default async function listOrganizationsEntrypoint(
	params: ListOrganizationsInput & Record<string, unknown> = {},
) {
	const input = requireRecord(params, 'list-organizations')
	const order = optionalString(input.order, 'order')
	if (order !== undefined && order !== 'asc' && order !== 'desc') {
		throw new Error('order must be "asc" or "desc".')
	}
	return listOrganizations({
		domains: optionalStringArray(input.domains, 'domains'),
		limit: input.limit as number | undefined,
		after: optionalString(input.after, 'after'),
		before: optionalString(input.before, 'before'),
		order,
		account: optionalString(input.account, 'account'),
		secretName: optionalString(input.secretName, 'secretName'),
	})
}