import {z} from 'zod' export type GetApiApiV1UsRulemakingRinsRinArgs = {rin: string, 'Idempotency-Key'?: (string | null) | undefined}; export type GetApiApiV1UsRulemakingRinsRinOptions = {baseUrl?: string | undefined, ApiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const agendaLatest = z.object({editionId: z.string(), season: z.string().nullable().optional(), year: z.number().int().nullable().optional(), runDate: z.string().nullable().optional(), title: z.string().nullable().optional(), stage: z.string().nullable().optional(), priority: z.string().nullable().optional(), rinStatus: z.string().nullable().optional(), major: z.string().nullable().optional(), agencyCode: z.string().nullable().optional(), agencyName: z.string().nullable().optional(), agencyAcronym: z.string().nullable().optional(), parentAgencyName: z.string().nullable().optional(), furtherInfoUrl: z.string().nullable().optional(), publicCommentUrl: z.string().nullable().optional(), sourceUrl: z.string().nullable().optional()}); export const agendaSummary = z.object({editions: z.number().int(), firstEdition: z.string().nullable().optional(), lastEdition: z.string().nullable().optional(), latest: agendaLatest.nullable().optional()}); export const reviewItem = z.object({reviewKey: z.string(), stage: z.string().nullable().optional(), stageNorm: z.string().nullable().optional(), title: z.string().nullable().optional(), dateReceived: z.string().nullable().optional(), dateCompleted: z.string().nullable().optional(), decision: z.string().nullable().optional(), economicallySignificant: z.boolean().nullable().optional(), status: z.string().nullable().optional(), agencyAcronym: z.string().nullable().optional(), meetingCount: z.number().int().optional(), linkStatus: z.string().nullable().optional(), frActId: z.string().nullable().optional(), frCitation: z.string().nullable().optional(), frPublicationDate: z.string().nullable().optional()}); export const docketLink = z.object({docketId: z.string(), agencyId: z.string().nullable().optional(), docketType: z.string().nullable().optional(), title: z.string().nullable().optional(), commentCount: z.number().int().nullable().optional(), lastModifiedAt: z.string().nullable().optional(), documentCount: z.number().int().optional(), openDocumentCount: z.number().int().optional(), sourceUrl: z.string()}); export const federalRegisterLink = z.object({documentNumber: z.string(), role: z.enum(["proposed", "final", "correction", "extension", "other"]), actId: z.string().nullable().optional(), citation: z.string().nullable().optional(), publicationDate: z.string().nullable().optional(), title: z.string().nullable().optional(), docKind: z.string().nullable().optional(), action: z.string().nullable().optional(), basis: z.string(), quality: z.enum(["verified", "candidate", "ambiguous"])}); export const cfrPartLink = z.object({cfrTitle: z.number().int(), cfrPart: z.string(), basis: z.string(), quality: z.enum(["verified", "candidate", "ambiguous"])}); export const simpleLink = z.object({key: z.string(), basis: z.string(), quality: z.enum(["verified", "candidate", "ambiguous"])}); export const coverageNote = z.object({source: z.string(), held: z.boolean(), note: z.string().nullable().optional()}); export const rinResponse = z.object({processingTimeMs: z.number().optional(), creditsConsumed: z.number().int().optional(), rin: z.string(), title: z.string().nullable().optional(), agencyCode: z.string().nullable().optional(), status: z.string().nullable().optional(), stage: z.string().nullable().optional(), isUmbrella: z.boolean().nullable().optional(), umbrellaBasis: z.string().nullable().optional(), agenda: agendaSummary.nullable().optional(), reviews: z.array(reviewItem).optional(), dockets: z.array(docketLink).optional(), federalRegister: z.array(federalRegisterLink).optional(), cfrParts: z.array(cfrPartLink).optional(), publicLaws: z.array(simpleLink).optional(), craDisapprovals: z.array(simpleLink).optional(), relatedRins: z.array(simpleLink).optional(), coverage: z.array(coverageNote).optional(), asOf: z.string().nullable().optional()}); 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 }; /** * Everything we hold for one RIN * * GET /api/v1/us/rulemaking/rins/{rin} * * Also accepts auth: ApiKeyHeader */ export const getApiApiV1UsRulemakingRinsRin = async (args: GetApiApiV1UsRulemakingRinsRinArgs, options?: GetApiApiV1UsRulemakingRinsRinOptions) => { const {baseUrl = "https://api.vaquill.ai", fetch: fetchFn = fetch, ApiKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Idempotency-Key'] != null) headers.set("Idempotency-Key", String(args['Idempotency-Key'])) if (ApiKeyAuth !== undefined) headers.set('authorization', `Bearer ${ApiKeyAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/us/rulemaking/rins/${encodeURIComponent(String(args.rin))}${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(rinResponse, await res.json()) };