import {z} from 'zod' export type GetApiTrainingStatusArgs = {startAt?: number | undefined, maxResults?: number | undefined, email: string, projectId?: string | undefined}; export type GetApiTrainingStatusOptions = {baseUrl?: string | undefined, Authorization?: string | undefined, fetch?: typeof fetch | undefined}; export const getApiTrainingStatusResponse = z.object({startAt: z.number().int().gte(-9007199254740991).lte(9007199254740991), maxResults: z.number().int().gte(-9007199254740991).lte(9007199254740991), user: z.object({id: z.string(), email: z.string(), name: z.string().nullable()}), isTrained: z.boolean(), externalTrainingStatuses: z.array(z.object({source: z.string(), status: z.enum(["TRAINED", "OVERDUE"]), message: z.string().nullable(), url: z.string().nullable(), updatedAt: z.string()})), documents: z.array(z.object({id: z.string(), itemKey: z.string().nullable(), title: z.string(), projectId: z.string(), state: z.enum(["NOT_REQUIRED", "OVERDUE", "TRAINED", "TRAINING_PERIOD"]), trainingSchedule: z.enum(["ONCE", "MONTHLY", "QUARTERLY", "YEARLY"]).nullable(), currentPeriod: z.object({start: z.string(), deadline: z.string()}).nullable(), nextPeriod: z.object({start: z.string(), deadline: z.string()}).nullable(), acknowledgement: z.object({acknowledgedAt: z.string(), inheritedFromPreviousRevision: z.boolean()}).nullable(), previousAcknowledgement: z.object({acknowledgedAt: z.string(), revision: z.number().int().gte(-9007199254740991).lte(9007199254740991).nullable(), controlledRevision: z.number().int().gte(-9007199254740991).lte(9007199254740991).nullable()}).nullable()}))}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get a user's training status by email * * GET /training/status */ export const getApiTrainingStatus = async (args: GetApiTrainingStatusArgs, options?: GetApiTrainingStatusOptions) => { const {baseUrl = "https://app.ketryx.com/api/v1", fetch: fetchFn = fetch, Authorization} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.startAt != null) query.append("startAt", String(args.startAt)) if (args.maxResults != null) query.append("maxResults", String(args.maxResults)) if (args.email != null) query.append("email", String(args.email)) if (args.projectId != null) query.append("projectId", String(args.projectId)) if (Authorization !== undefined) headers.set('authorization', `Bearer ${Authorization}`) const url = `${baseUrl.replace(/\/+$/, '')}/training/status${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(getApiTrainingStatusResponse, await res.json()) };