import {z} from 'zod' export type VisibilityLevel = 'public' | 'paid' | 'private' | 'kids'; export type Species = 'human' | 'animal' | 'other'; export type Gender = 'male' | 'female'; export type AgeGroup = 'child' | 'young' | 'adult' | 'senior'; export type PitchGroup = 'low' | 'mid' | 'high'; export type VoiceSortField = 'default' | 'name' | 'pitch' | 'rating' | 'created_at'; export type Direction = 'asc' | 'desc'; export type GetApiApiV2VoicesArgs = {limit?: number | undefined, offset?: number | undefined, visibility?: Array | undefined, species?: Array | undefined, gender?: Array | undefined, age_group?: Array | undefined, pitch_group?: Array | undefined, nationality?: Array | undefined, sort?: VoiceSortField | undefined, direction?: Direction | undefined, 'x-csrf-token'?: string | undefined, 'api-key'?: string | undefined, session_id?: string | undefined}; export type GetApiApiV2VoicesOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const visibilityLevel = z.enum(["public", "paid", "private", "kids"]); export const species = z.enum(["human", "animal", "other"]); export const gender = z.enum(["male", "female"]); export const ageGroup = z.enum(["child", "young", "adult", "senior"]); export const pitchGroup = z.enum(["low", "mid", "high"]); export const accentInfoCore = z.object({name: z.string(), short_name: z.string(), locale: z.string()}); export const subscriptionTierCore = z.object({name: z.string()}); export const accentSettingsPublic = z.object({favorite: z.boolean().optional(), semitones_correction: z.number().optional()}); export const accentPublic = z.object({id: z.string(), is_default: z.boolean(), native: z.boolean(), info: accentInfoCore, tiers: z.array(subscriptionTierCore), available: z.boolean().optional(), settings: accentSettingsPublic.optional()}); export const narrationStyleInfoCore = z.object({name: z.string()}); export const narrationStyleSettingPublic = z.object({favorite: z.boolean().optional()}); export const narrationStylePublic = z.object({id: z.string(), is_default: z.boolean(), info: narrationStyleInfoCore, settings: narrationStyleSettingPublic.optional()}); export const voicePublic = z.object({id: z.string(), owner_id: z.string(), name: z.string(), slug: z.string(), visibility: visibilityLevel, species: species.optional(), artist: z.string().optional(), verified_artist: z.boolean().optional(), gender: gender.optional(), pitch: z.number().optional(), age_group: ageGroup.optional(), pitch_group: pitchGroup.optional(), nationality: z.string().optional(), image_url: z.string().optional(), thumbnail_url: z.string().optional(), description: z.string().max(2048).optional(), rating: z.number().int().gte(0).lte(100), active: z.boolean(), created_at: z.string(), favorite: z.boolean().optional(), available: z.boolean().optional(), accents: z.array(accentPublic), narration_styles: z.array(narrationStylePublic), tiers: z.array(subscriptionTierCore)}); export const pagination = z.object({count: z.number().int(), limit: z.number().int(), offset: z.number().int()}); export const voiceListResponse = z.object({list: z.array(voicePublic), pagination: pagination}); 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 }; /** * Voice List * * GET /api/v2/voices */ export const getApiApiV2Voices = async (args: GetApiApiV2VoicesArgs, options: GetApiApiV2VoicesOptions) => { const {baseUrl, fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() const cookies: string[] = [] headers.set('accept', "application/json") if (args.limit != null) query.append("limit", String(args.limit)) if (args.offset != null) query.append("offset", String(args.offset)) for (const item of args.visibility ?? []) query.append("visibility", String(item)) for (const item of args.species ?? []) query.append("species", String(item)) for (const item of args.gender ?? []) query.append("gender", String(item)) for (const item of args.age_group ?? []) query.append("age_group", String(item)) for (const item of args.pitch_group ?? []) query.append("pitch_group", String(item)) for (const item of args.nationality ?? []) query.append("nationality", String(item)) if (args.sort != null) query.append("sort", String(args.sort)) if (args.direction != null) query.append("direction", String(args.direction)) if (args['x-csrf-token'] != null) headers.set("x-csrf-token", String(args['x-csrf-token'])) if (args['api-key'] != null) headers.set("api-key", String(args['api-key'])) if (args.session_id != null) cookies.push("session_id=" + encodeURIComponent(String(args.session_id))) if (cookies.length > 0) headers.set('cookie', cookies.join('; ')) const url = `${baseUrl.replace(/\/+$/, '')}/api/v2/voices${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(voiceListResponse, await res.json()) };