import {z} from 'zod' export type GetApiApiSessionIdArgs = {id: string}; export type GetApiApiSessionIdOptions = {baseUrl?: string | undefined, ApiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const screenConfig = z.object({width: z.number().optional(), height: z.number().optional()}); export const createSessionProfile = z.object({id: z.string().optional(), persistChanges: z.boolean().optional(), persistNetworkCache: z.boolean().optional()}); export const sessionWebBotAuth = z.object({signatureAgent: z.string(), onlyDomains: z.array(z.string()).optional()}); export const sessionLaunchState = z.object({useUltraStealth: z.boolean().optional(), useStealth: z.boolean().optional(), useProxy: z.boolean().optional(), solveCaptchas: z.boolean().optional(), solverType: z.literal("visual").optional(), adblock: z.boolean().optional(), trackers: z.boolean().optional(), annoyances: z.boolean().optional(), screen: screenConfig.optional(), enableWebRecording: z.boolean().optional(), enableVideoWebRecording: z.boolean().optional(), enableLogCapture: z.boolean().optional(), acceptCookies: z.boolean().optional(), profile: createSessionProfile.optional(), staticIpId: z.string().optional(), saveDownloads: z.boolean().optional(), enableWindowManager: z.boolean().optional(), enableWindowManagerTaskbar: z.boolean().optional(), viewOnlyLiveView: z.boolean().optional(), disablePasswordManager: z.boolean().optional(), enableAlwaysOpenPdfExternally: z.boolean().optional(), disablePostQuantumKeyAgreement: z.boolean().optional(), enableWebMcp: z.boolean().optional(), webBotAuth: sessionWebBotAuth.optional()}).nullable(); export const sessionDetail = z.object({id: z.string().optional(), teamId: z.string().optional(), status: z.enum(["active", "closed", "error", "close-error"]).optional(), startTime: z.string().nullable().optional(), endTime: z.string().nullable().optional(), createdAt: z.string().optional(), updatedAt: z.string().optional(), launchState: sessionLaunchState.optional(), creditsUsed: z.number().nullable().optional(), sessionUrl: z.string().optional(), liveUrl: z.string().optional(), token: z.string().optional(), wsEndpoint: z.string().optional(), webdriverEndpoint: z.string().optional(), computerActionEndpoint: z.string().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 }; /** * Get session by ID * * GET /api/session/{id} */ export const getApiApiSessionId = async (args: GetApiApiSessionIdArgs, options?: GetApiApiSessionIdOptions) => { const {baseUrl = "https://api.hyperbrowser.ai", fetch: fetchFn = fetch, ApiKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (ApiKeyAuth !== undefined) headers.set("x-api-key", ApiKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/api/session/${encodeURIComponent(String(args.id))}${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(sessionDetail, await res.json()) };