import {z} from 'zod' export type GetApiApiV1ReadyOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const componentStatus = z.enum(["healthy", "degraded", "unhealthy"]); export const pluginHealth = z.object({avg_response_time_ms: z.number().int().gte(0).optional(), circuit_state: z.string().optional(), connection_pool_active_connections: z.number().int().gte(0).optional(), connection_pool_available_slots: z.number().int().gte(0).optional(), enabled: z.boolean(), error: z.string().optional(), memory: z.number().int().gte(0).optional(), pool_completed: z.number().int().gte(0).optional(), pool_queued: z.number().int().gte(0).optional(), recovering: z.boolean().optional(), recovery_percent: z.number().int().gte(0).optional(), shared_socket_active_connections: z.number().int().gte(0).optional(), shared_socket_available_slots: z.number().int().gte(0).optional(), shared_socket_registered_executions: z.number().int().gte(0).optional(), status: componentStatus, success_rate: z.number().optional(), uptime_ms: z.number().int().gte(0).optional()}); export const queueHealth = z.object({error: z.string().optional(), status: componentStatus}); export const poolStatus = z.object({available: z.number().int().gte(0), connected: z.boolean(), error: z.string().optional(), max_size: z.number().int().gte(0)}); export const redisHealth = z.object({error: z.string().optional(), primary_pool: poolStatus, reader_pool: poolStatus, status: componentStatus}); export const systemHealth = z.object({close_wait_count: z.number().int().gte(0), error: z.string().optional(), fd_count: z.number().int().gte(0), fd_limit: z.number().int().gte(0), fd_usage_percent: z.number().int().gte(0), status: componentStatus}); export const components = z.object({plugins: pluginHealth.optional(), queue: queueHealth, redis: redisHealth, system: systemHealth}); export const readinessResponse = z.object({components: components, ready: z.boolean(), reason: z.string().optional(), status: componentStatus, timestamp: z.string()}); 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 }; /** * Readiness endpoint that checks system resources, Redis, Queue, and plugins. * * GET /api/v1/ready */ export const getApiApiV1Ready = async (options: GetApiApiV1ReadyOptions) => { const {baseUrl, fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/ready${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(readinessResponse, await res.json()) };