import {z} from 'zod' export type CreateApiV1NamespacesNamespaceDebugRecallArgs = {namespace: string, body: {num?: number | undefined, top_k?: number | undefined, filters: unknown, include_ground_truth?: boolean | undefined, rank_by: unknown}}; export type CreateApiV1NamespacesNamespaceDebugRecallOptions = {baseUrl?: string | undefined, bearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const id = z.union([z.string(), z.string(), z.number().int().gte(0)]); export const vector = z.union([z.array(z.number()), z.string()]); export const row = z.object({id: id, vector: vector.optional()}).and(z.record(z.string(), z.unknown())); export const createApiV1NamespacesNamespaceDebugRecallResponse = z.object({avg_recall: z.number(), avg_exhaustive_count: z.number(), avg_ann_count: z.number(), ground_truth: z.array(z.object({query_vector: z.array(z.number()), nearest_neighbors: z.array(row)})).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 }; /** * Evaluate recall. * * POST /v1/namespaces/{namespace}/_debug/recall */ export const createApiV1NamespacesNamespaceDebugRecall = async (args: CreateApiV1NamespacesNamespaceDebugRecallArgs, options?: CreateApiV1NamespacesNamespaceDebugRecallOptions) => { const {baseUrl = "https://undefined.turbopuffer.com", fetch: fetchFn = fetch, bearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (bearerAuth !== undefined) headers.set('authorization', `Bearer ${bearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/namespaces/${encodeURIComponent(String(args.namespace))}/_debug/recall${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(createApiV1NamespacesNamespaceDebugRecallResponse, await res.json()) };