import {z} from 'zod' export type SleepInclude = 'stages'; export type ProviderName = 'apple' | 'samsung' | 'garmin' | 'health_connect' | 'google_health' | 'polar' | 'suunto' | 'whoop' | 'strava' | 'oura' | 'fitbit' | 'ultrahuman' | 'sensorbio' | 'withings' | 'unknown' | 'internal'; export type GetApiApiV1UsersUserIdEventsSleepArgs = {user_id: string, start_date: string, end_date: string, include?: Array | undefined, cursor?: (string | null) | undefined, limit?: number | undefined, provider?: (ProviderName | null) | undefined, source?: (string | null) | undefined, device_model?: (string | null) | undefined, data_source_id?: (string | null) | undefined, is_nap?: (boolean | null) | undefined, source_selection?: ('all' | 'per_session' | null) | undefined, filter_by_priority?: boolean | undefined, 'X-Open-Wearables-API-Key'?: (string | null) | undefined}; export type GetApiApiV1UsersUserIdEventsSleepOptions = {baseUrl: string, OAuth2PasswordBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const deviceType = z.enum(["watch", "band", "phone", "scale", "ring", "tablet", "chest_strap", "hr_sensor", "headphones", "head_mounted", "glasses", "smart_display", "bp_monitor", "glucose_meter", "thermometer", "sleep_monitor", "bike_computer", "fitness_machine", "other", "unknown"]); export const sourceMetadata = z.object({provider: z.string(), source: z.string().nullable().optional(), device: z.string().nullable().optional(), device_type: deviceType.nullable().optional(), device_id: z.string().nullable().optional(), device_name: z.string().nullable()}); export const sleepStagesSummary = z.object({awake_minutes: z.number().int().nullable().optional(), light_minutes: z.number().int().nullable().optional(), deep_minutes: z.number().int().nullable().optional(), rem_minutes: z.number().int().nullable().optional()}); export const sleepStageType = z.enum(["in_bed", "awake", "sleeping", "light", "deep", "rem", "unknown"]); export const sleepStage = z.object({stage: sleepStageType, start_time: z.string(), end_time: z.string()}); export const sleepSession = z.object({id: z.string(), start_time: z.string(), end_time: z.string(), zone_offset: z.string().nullable().optional(), source: sourceMetadata, duration_seconds: z.number().int(), sleep_duration_seconds: z.number().int().nullable().optional(), time_in_bed_seconds: z.number().int().nullable().optional(), efficiency_percent: z.number().nullable().optional(), stages: sleepStagesSummary.nullable().optional(), sleep_stage_intervals: z.array(sleepStage).nullable().optional(), is_nap: z.boolean().optional(), is_final: z.boolean()}); export const pagination = z.object({next_cursor: z.string().nullable().optional(), previous_cursor: z.string().nullable().optional(), has_more: z.boolean(), total_count: z.number().int().nullable().optional()}); export const resolution = z.enum(["raw", "1min", "5min", "15min", "1hour", "1day", "1week", "1month"]); export const timeseriesMetadata = z.object({resolution: resolution.nullable().optional(), sample_count: z.number().int().nullable().optional(), start_time: z.string().nullable().optional(), end_time: z.string().nullable().optional()}); export const paginatedResponseSleepSession = z.object({data: z.array(sleepSession), pagination: pagination, metadata: timeseriesMetadata}); 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 }; /** * List Sleep Sessions * * GET /api/v1/users/{user_id}/events/sleep */ export const getApiApiV1UsersUserIdEventsSleep = async (args: GetApiApiV1UsersUserIdEventsSleepArgs, options: GetApiApiV1UsersUserIdEventsSleepOptions) => { const {baseUrl, fetch: fetchFn = fetch, OAuth2PasswordBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.start_date != null) query.append("start_date", String(args.start_date)) if (args.end_date != null) query.append("end_date", String(args.end_date)) for (const item of args.include ?? []) query.append("include", String(item)) if (args.cursor != null) query.append("cursor", String(args.cursor)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.provider != null) query.append("provider", String(args.provider)) if (args.source != null) query.append("source", String(args.source)) if (args.device_model != null) query.append("device_model", String(args.device_model)) if (args.data_source_id != null) query.append("data_source_id", String(args.data_source_id)) if (args.is_nap != null) query.append("is_nap", String(args.is_nap)) if (args.source_selection != null) query.append("source_selection", String(args.source_selection)) if (args.filter_by_priority != null) query.append("filter_by_priority", String(args.filter_by_priority)) if (args['X-Open-Wearables-API-Key'] != null) headers.set("X-Open-Wearables-API-Key", String(args['X-Open-Wearables-API-Key'])) if (OAuth2PasswordBearer !== undefined) headers.set('authorization', `Bearer ${OAuth2PasswordBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/users/${encodeURIComponent(String(args.user_id))}/events/sleep${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(paginatedResponseSleepSession, await res.json()) };