surfsky 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1722 @@
+import { z } from "zod";
+//#region src/types.d.ts
+declare const os: z.ZodEnum<{
+  android: "android";
+  mac: "mac";
+  win: "win";
+}>;
+declare const arch: z.ZodEnum<{
+  arm: "arm";
+  x86: "x86";
+}>;
+declare const deviceType: z.ZodEnum<{
+  phone: "phone";
+  tablet: "tablet";
+}>;
+declare const waitUntil: z.ZodEnum<{
+  commit: "commit";
+  domcontentloaded: "domcontentloaded";
+  load: "load";
+  networkidle: "networkidle";
+}>;
+declare const proxyType: z.ZodEnum<{
+  mobile: "mobile";
+  residential: "residential";
+}>;
+declare const profileOrdering: z.ZodEnum<{
+  "-active": "-active";
+  "-created": "-created";
+  "-title": "-title";
+  active: "active";
+  created: "created";
+  title: "title";
+}>;
+declare const regionalPool: z.ZodEnum<{
+  asia: "asia";
+  centralasia: "centralasia";
+  eastasia: "eastasia";
+  europe: "europe";
+  mena: "mena";
+  northamerica: "northamerica";
+  oceania: "oceania";
+  sea: "sea";
+  southamerica: "southamerica";
+  southasia: "southasia";
+  western: "western";
+  westeurope: "westeurope";
+}>;
+type OS = z.infer<typeof os>;
+type Arch = z.infer<typeof arch>;
+type DeviceType = z.infer<typeof deviceType>;
+type WaitUntil = z.infer<typeof waitUntil>;
+type ProxyType = z.infer<typeof proxyType>;
+type ProfileOrdering = z.infer<typeof profileOrdering>;
+type RegionalPool = z.infer<typeof regionalPool>;
+type ExportFormat = "json" | "netscape";
+type MouseButton = "left" | "right" | "middle";
+type KeyModifier = "Alt" | "Control" | "Meta" | "Shift";
+type ScrollBehavior = "smooth" | "instant";
+/** A known value, or one the server added after this SDK was published. */
+type Loose<T extends string> = T | (string & {});
+declare function isRecord(value: unknown): value is Record<string, unknown>;
+type Closed<T> = { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K]; };
+declare const noiseSchema: z.ZodObject<{
+  webgl: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  canvas: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  audio: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  client_rects: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$loose>;
+type Noise = Closed<z.infer<typeof noiseSchema>>;
+declare const mediaDevicesSchema: z.ZodObject<{
+  video_in: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  audio_out: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  audio_in: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$loose>;
+type MediaDevices = Closed<z.infer<typeof mediaDevicesSchema>>;
+declare const geolocationSchema: z.ZodObject<{
+  latitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  longitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  accuracy: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$loose>;
+type Geolocation = Closed<z.infer<typeof geolocationSchema>>;
+declare const fingerprintSchema: z.ZodObject<{
+  os: z.ZodOptional<z.ZodNullable<z.ZodType<Loose<"android" | "mac" | "win">, string, z.core.$ZodTypeInternals<Loose<"android" | "mac" | "win">, string>>>>;
+  os_arch: z.ZodOptional<z.ZodNullable<z.ZodType<Loose<"arm" | "x86">, string, z.core.$ZodTypeInternals<Loose<"arm" | "x86">, string>>>>;
+  os_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  device_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  device_type: z.ZodOptional<z.ZodNullable<z.ZodType<Loose<"phone" | "tablet">, string, z.core.$ZodTypeInternals<Loose<"phone" | "tablet">, string>>>>;
+  user_agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  cpu: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  ram: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  renderer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  noise: z.ZodOptional<z.ZodNullable<z.ZodType<Closed<{
+    [x: string]: unknown;
+    webgl?: boolean | null | undefined;
+    canvas?: boolean | null | undefined;
+    audio?: boolean | null | undefined;
+    client_rects?: boolean | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    webgl?: boolean | null | undefined;
+    canvas?: boolean | null | undefined;
+    audio?: boolean | null | undefined;
+    client_rects?: boolean | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    webgl?: boolean | null | undefined;
+    canvas?: boolean | null | undefined;
+    audio?: boolean | null | undefined;
+    client_rects?: boolean | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    webgl?: boolean | null | undefined;
+    canvas?: boolean | null | undefined;
+    audio?: boolean | null | undefined;
+    client_rects?: boolean | null | undefined;
+  }>>>>>;
+  media_devices: z.ZodOptional<z.ZodNullable<z.ZodType<Closed<{
+    [x: string]: unknown;
+    video_in?: number | null | undefined;
+    audio_out?: number | null | undefined;
+    audio_in?: number | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    video_in?: number | null | undefined;
+    audio_out?: number | null | undefined;
+    audio_in?: number | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    video_in?: number | null | undefined;
+    audio_out?: number | null | undefined;
+    audio_in?: number | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    video_in?: number | null | undefined;
+    audio_out?: number | null | undefined;
+    audio_in?: number | null | undefined;
+  }>>>>>;
+  screen: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  languages: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+  timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  geolocation: z.ZodOptional<z.ZodNullable<z.ZodType<Closed<{
+    [x: string]: unknown;
+    latitude?: number | null | undefined;
+    longitude?: number | null | undefined;
+    accuracy?: number | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    latitude?: number | null | undefined;
+    longitude?: number | null | undefined;
+    accuracy?: number | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    latitude?: number | null | undefined;
+    longitude?: number | null | undefined;
+    accuracy?: number | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    latitude?: number | null | undefined;
+    longitude?: number | null | undefined;
+    accuracy?: number | null | undefined;
+  }>>>>>;
+  dns: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+type Fingerprint = Closed<z.infer<typeof fingerprintSchema>>;
+declare const storageOptionsSchema: z.ZodObject<{
+  cookies: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  passwords: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  extensions: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  localstorage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  history: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  bookmarks: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  serviceworkers: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$loose>;
+type StorageOptions = Closed<z.infer<typeof storageOptionsSchema>>;
+declare const browserSettings: z.ZodObject<{
+  inactive_kill_timeout: z.ZodOptional<z.ZodNumber>;
+  cache_enabled: z.ZodOptional<z.ZodBoolean>;
+  cache_key: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type BrowserSettings = z.infer<typeof browserSettings>;
+declare const shared: z.ZodObject<{
+  tier: z.ZodLiteral<"shared">;
+  country: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const premium: z.ZodObject<{
+  tier: z.ZodOptional<z.ZodLiteral<"premium">>;
+  country: z.ZodOptional<z.ZodString>;
+  region: z.ZodOptional<z.ZodString>;
+  city: z.ZodOptional<z.ZodString>;
+  type: z.ZodOptional<z.ZodEnum<{
+    mobile: "mobile";
+    residential: "residential";
+  }>>;
+  pool: z.ZodOptional<z.ZodEnum<{
+    asia: "asia";
+    centralasia: "centralasia";
+    eastasia: "eastasia";
+    europe: "europe";
+    mena: "mena";
+    northamerica: "northamerica";
+    oceania: "oceania";
+    sea: "sea";
+    southamerica: "southamerica";
+    southasia: "southasia";
+    western: "western";
+    westeurope: "westeurope";
+  }>>;
+  asn: z.ZodOptional<z.ZodNumber>;
+  lat: z.ZodOptional<z.ZodNumber>;
+  lon: z.ZodOptional<z.ZodNumber>;
+  session_minutes: z.ZodOptional<z.ZodNumber>;
+  unique_ip: z.ZodOptional<z.ZodBoolean>;
+  keep_asn: z.ZodOptional<z.ZodBoolean>;
+  keep_ip: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type SharedProxy = z.infer<typeof shared>;
+type PremiumProxy = z.infer<typeof premium>;
+/** A proxy URL of your own, or a selector for one of Surfsky's pools. */
+type ProxyLike = string | SharedProxy | PremiumProxy;
+declare const domainRoute: z.ZodObject<{
+  proxy: z.ZodString;
+  domain: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  domain_suffix: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  domain_keyword: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  domain_regex: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type DomainRoute = z.infer<typeof domainRoute>;
+declare const cookieInput: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>;
+type CookieInput = z.infer<typeof cookieInput>;
+declare const oneTimeStartRequest: z.ZodObject<{
+  fingerprint: z.ZodOptional<z.ZodType<Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>>>>;
+  proxy: z.ZodOptional<z.ZodNullable<z.ZodCustom<ProxyLike, ProxyLike>>>;
+  browser_settings: z.ZodOptional<z.ZodObject<{
+    inactive_kill_timeout: z.ZodOptional<z.ZodNumber>;
+    cache_enabled: z.ZodOptional<z.ZodBoolean>;
+    cache_key: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  enable_chromedriver: z.ZodOptional<z.ZodBoolean>;
+  extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  proxy_blacklist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  domain_routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    proxy: z.ZodString;
+    domain: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain_suffix: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain_keyword: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain_regex: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>>;
+  cookies: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strict>;
+declare const profileStartRequest: z.ZodObject<{
+  proxy: z.ZodOptional<z.ZodNullable<z.ZodCustom<ProxyLike, ProxyLike>>>;
+  browser_settings: z.ZodOptional<z.ZodObject<{
+    inactive_kill_timeout: z.ZodOptional<z.ZodNumber>;
+    cache_enabled: z.ZodOptional<z.ZodBoolean>;
+    cache_key: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  enable_chromedriver: z.ZodOptional<z.ZodBoolean>;
+  extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  proxy_blacklist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  domain_routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    proxy: z.ZodString;
+    domain: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain_suffix: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain_keyword: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain_regex: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>>;
+  fingerprint: z.ZodType<null | undefined, unknown, z.core.$ZodTypeInternals<null | undefined, unknown>>;
+  cookies: z.ZodType<null | undefined, unknown, z.core.$ZodTypeInternals<null | undefined, unknown>>;
+}, z.core.$strict>;
+declare const profileCreateRequest: z.ZodObject<{
+  title: z.ZodString;
+  fingerprint: z.ZodType<Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>>>;
+  description: z.ZodOptional<z.ZodString>;
+  proxy: z.ZodOptional<z.ZodNullable<z.ZodCustom<ProxyLike, ProxyLike>>>;
+  cookies: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  storage_options: z.ZodOptional<z.ZodType<Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>>>>;
+}, z.core.$strict>;
+declare const profileUpdateRequest: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  proxy: z.ZodOptional<z.ZodNullable<z.ZodCustom<ProxyLike, ProxyLike>>>;
+  fingerprint: z.ZodOptional<z.ZodPipe<z.ZodType<Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>>>, z.ZodTransform<{
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }, Closed<{
+    [x: string]: unknown;
+    os?: Loose<"android" | "mac" | "win"> | null | undefined;
+    os_arch?: Loose<"arm" | "x86"> | null | undefined;
+    os_version?: string | null | undefined;
+    device_model?: string | null | undefined;
+    device_type?: Loose<"phone" | "tablet"> | null | undefined;
+    user_agent?: string | null | undefined;
+    cpu?: number | null | undefined;
+    ram?: number | null | undefined;
+    renderer?: string | null | undefined;
+    noise?: Closed<{
+      [x: string]: unknown;
+      webgl?: boolean | null | undefined;
+      canvas?: boolean | null | undefined;
+      audio?: boolean | null | undefined;
+      client_rects?: boolean | null | undefined;
+    }> | null | undefined;
+    media_devices?: Closed<{
+      [x: string]: unknown;
+      video_in?: number | null | undefined;
+      audio_out?: number | null | undefined;
+      audio_in?: number | null | undefined;
+    }> | null | undefined;
+    screen?: string | null | undefined;
+    languages?: string[] | null | undefined;
+    timezone?: string | null | undefined;
+    geolocation?: Closed<{
+      [x: string]: unknown;
+      latitude?: number | null | undefined;
+      longitude?: number | null | undefined;
+      accuracy?: number | null | undefined;
+    }> | null | undefined;
+    dns?: string | null | undefined;
+  }>>>>;
+  storage_options: z.ZodOptional<z.ZodNullable<z.ZodType<Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>, z.core.$ZodTypeInternals<Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>, Closed<{
+    [x: string]: unknown;
+    cookies?: boolean | null | undefined;
+    passwords?: boolean | null | undefined;
+    extensions?: boolean | null | undefined;
+    localstorage?: boolean | null | undefined;
+    history?: boolean | null | undefined;
+    bookmarks?: boolean | null | undefined;
+    serviceworkers?: boolean | null | undefined;
+  }>>>>>;
+}, z.core.$strict>;
+declare const listPageRequest: z.ZodObject<{
+  page: z.ZodOptional<z.ZodNumber>;
+  page_len: z.ZodOptional<z.ZodNumber>;
+  ordering: z.ZodOptional<z.ZodEnum<{
+    "-active": "-active";
+    "-created": "-created";
+    "-title": "-title";
+    active: "active";
+    created: "created";
+    title: "title";
+  }>>;
+}, z.core.$strict>;
+declare const scrapeRequest: z.ZodObject<{
+  url: z.ZodString;
+  screenshot: z.ZodOptional<z.ZodBoolean>;
+  wait: z.ZodOptional<z.ZodNumber>;
+  wait_until: z.ZodOptional<z.ZodEnum<{
+    commit: "commit";
+    domcontentloaded: "domcontentloaded";
+    load: "load";
+    networkidle: "networkidle";
+  }>>;
+  wait_for: z.ZodOptional<z.ZodString>;
+  human_actions: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type OneTimeStartRequest = z.infer<typeof oneTimeStartRequest>;
+type ProfileStartRequest = z.infer<typeof profileStartRequest>;
+type ProfileCreateRequest = z.infer<typeof profileCreateRequest>;
+/** As the caller writes it; the parse strips the immutable fingerprint fields. */
+type ProfileUpdateRequest = z.input<typeof profileUpdateRequest>;
+type ListPageRequest = z.infer<typeof listPageRequest>;
+type ScrapeRequest = z.infer<typeof scrapeRequest>;
+type Parser<T> = (value: unknown) => T;
+declare const parseOneTimeStartRequest: Parser<OneTimeStartRequest>;
+declare const parseProfileStartRequest: Parser<ProfileStartRequest>;
+declare const parseProfileCreateRequest: Parser<ProfileCreateRequest>;
+declare const parseProfileUpdateRequest: Parser<z.output<typeof profileUpdateRequest>>;
+declare const parseScrapeRequest: Parser<ScrapeRequest>;
+declare const parseListPageRequest: Parser<ListPageRequest>;
+declare function parseProxyLike(value: unknown, what?: string): ProxyLike;
+interface InspectorPage {
+  page_title?: string | null;
+  page_url?: string | null;
+  devtools_url?: string | null;
+}
+interface Inspector {
+  list?: string | null;
+  pages?: InspectorPage[] | null;
+  screencast?: string | null;
+}
+interface Session {
+  internal_uuid: string;
+  ws_url: string;
+  inspector?: Inspector | null;
+}
+interface ProfileRef {
+  uuid: string;
+}
+interface ActiveProfile {
+  internal_uuid: string;
+  profile_uuid?: string | null;
+  one_time?: boolean | null;
+  started_at?: string | null;
+  active_seconds?: number | null;
+}
+interface ProfileSummary {
+  uuid: string;
+  title?: string | null;
+  description?: string | null;
+  proxy?: string | null;
+  status?: string | null;
+}
+interface Profile {
+  uuid: string;
+  title?: string | null;
+  description?: string | null;
+  start_pages?: unknown[] | null;
+  pinned_tag?: string | null;
+  proxy?: string | null;
+  status?: string | null;
+  storage_options?: StorageOptions | null;
+  last_active?: string | null;
+  fingerprint?: Fingerprint | null;
+  has_user_password?: boolean | null;
+  password_set_at?: string | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+}
+/** Cookies are camelCase on the wire, in the API and in CDP. */
+interface Cookie {
+  domain?: string | null;
+  name?: string | null;
+  value?: string | null;
+  path?: string | null;
+  expirationDate?: number | null;
+  hostOnly?: boolean | null;
+  httpOnly?: boolean | null;
+  sameSite?: string | null;
+  secure?: boolean | null;
+}
+interface ScrapeResult {
+  url?: string | null;
+  status?: number | null;
+  status_text?: string | null;
+  content?: string | null;
+  cookies?: Cookie[] | null;
+  /** base64 PNG when requested */
+  screenshot?: string | null;
+}
+interface BatchDeleteResult {
+  deleted_uuids: string[];
+  active_uuids: string[];
+  not_found_uuids: string[];
+}
+interface StopAllResult {
+  stopped: string[];
+  failed: unknown[];
+}
+interface ProxyCountry {
+  code: string;
+  name?: string | null;
+}
+interface ProxyRegion {
+  code: string;
+  name?: string | null;
+  country?: string | null;
+  country_code?: string | null;
+}
+interface ProxyCity {
+  code: string;
+  name?: string | null;
+  region?: string | null;
+  region_code?: string | null;
+  country?: string | null;
+  country_code?: string | null;
+}
+interface ProxyQuota {
+  remaining_bytes?: number | null;
+  remaining_gb?: number | null;
+}
+/** `-1` means unlimited. */
+interface SharedProxyQuota {
+  limit_gb?: number | null;
+  limit_bytes?: number | null;
+  used_bytes?: number | null;
+  remaining_bytes?: number | null;
+  remaining_gb?: number | null;
+  reset_time?: number | null;
+}
+interface TrafficVolume {
+  bytes?: number | null;
+  gb?: number | null;
+}
+interface TrafficStats {
+  "24h"?: TrafficVolume | null;
+  "7d"?: TrafficVolume | null;
+  "30d"?: TrafficVolume | null;
+}
+interface Renderer {
+  value: string;
+  platform?: string | null;
+  archs?: string[] | null;
+}
+interface Screen {
+  value: string;
+  platform?: string | null;
+  archs?: string[] | null;
+}
+interface DeviceModel {
+  value: string;
+  os?: string | null;
+  os_versions?: string[] | null;
+  archs?: string[] | null;
+  device_type?: string | null;
+}
+interface Extension {
+  uuid: string;
+  name?: string | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+}
+interface SessionLimits {
+  has_session_limits?: boolean | null;
+  spm?: number | null;
+  remaining?: number | null;
+  used?: number | null;
+  additional_spm?: number | null;
+  reset_time?: number | null;
+}
+interface BrowserLimits {
+  has_browser_limits?: boolean | null;
+  parallel_browsers?: number | null;
+  running?: number | null;
+  available?: number | null;
+}
+//#endregion
+//#region src/browser/actions.d.ts
+type Send = (method: string, params?: Record<string, unknown>) => Promise<any>;
+interface ClickOptions {
+  button?: MouseButton;
+  clickCount?: number;
+  modifiers?: KeyModifier[];
+  waitForVisible?: boolean;
+  scrollIntoView?: boolean;
+  preDelay?: number;
+  postDelay?: number;
+  timeout?: number;
+}
+type DblclickOptions = Omit<ClickOptions, "clickCount">;
+interface HoverOptions {
+  waitForVisible?: boolean;
+  scrollIntoView?: boolean;
+  timeout?: number;
+}
+interface PressOptions {
+  modifiers?: KeyModifier[];
+  delay?: number;
+}
+interface MouseClickOptions {
+  button?: MouseButton;
+  clickCount?: number;
+  modifiers?: KeyModifier[];
+  preDelay?: number;
+  postDelay?: number;
+}
+interface ScrollOptions {
+  deltaX?: number;
+  deltaY?: number;
+  duration?: number;
+}
+interface ScrollToOptions {
+  x?: number;
+  y?: number;
+  behavior?: ScrollBehavior;
+}
+interface DragOptions {
+  startX: number;
+  startY: number;
+  endX: number;
+  endY: number;
+  button?: MouseButton;
+}
+declare class Keyboard {
+  #private;
+  constructor(send: Send);
+  type(text: string): Promise<any>;
+  press(key: string, options?: PressOptions): Promise<any>;
+}
+declare class Mouse {
+  #private;
+  constructor(send: Send);
+  move(x: number, y: number): Promise<any>;
+  click(x: number, y: number, options?: MouseClickOptions): Promise<any>;
+  down(x: number, y: number, options?: {
+    button?: MouseButton;
+  }): Promise<any>;
+  up(x: number, y: number, options?: {
+    button?: MouseButton;
+  }): Promise<any>;
+  wheel(options?: {
+    deltaX?: number;
+    deltaY?: number;
+  }): Promise<any>;
+  drag(options: DragOptions): Promise<any>;
+}
+declare abstract class Actions {
+  readonly keyboard: Keyboard;
+  readonly mouse: Mouse;
+  constructor();
+  abstract send(method: string, params?: Record<string, unknown>): Promise<any>;
+  click(selector: string, options?: ClickOptions): Promise<any>;
+  dblclick(selector: string, options?: DblclickOptions): Promise<any>;
+  hover(selector: string, options?: HoverOptions): Promise<any>;
+  type(selector: string, text: string): Promise<any>;
+  fill(selector: string, text: string): Promise<any>;
+  scroll(options?: ScrollOptions): Promise<any>;
+  scrollIntoView(selector: string, options?: {
+    behavior?: ScrollBehavior;
+  }): Promise<any>;
+  scrollTo(options?: ScrollToOptions): Promise<any>;
+}
+//#endregion
+//#region src/errors.d.ts
+declare class SurfskyError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** No API token, or another unusable client setting. */
+declare class ConfigurationError extends SurfskyError {}
+/** A request that failed validation before it was sent. `cause` is the ZodError. */
+declare class ValidationError extends SurfskyError {
+  readonly issues: readonly z.core.$ZodIssue[];
+  constructor(message: string, error: z.ZodError);
+}
+interface APIErrorOptions {
+  statusCode?: number;
+  body?: unknown;
+  requestId?: string;
+  headers?: Record<string, string>;
+  retryAfter?: number;
+  cause?: unknown;
+}
+/** An error response from the API, or a request that never got one. */
+declare class APIError extends SurfskyError {
+  readonly statusCode: number | undefined;
+  readonly body: unknown;
+  readonly code: string | undefined;
+  readonly requestId: string | undefined;
+  readonly headers: Record<string, string> | undefined;
+  readonly retryAfter: number | undefined;
+  constructor(message: string, options?: APIErrorOptions);
+  toString(): string;
+}
+/** The request never reached the API. */
+declare class APIConnectionError extends APIError {}
+/** No response within the timeout. */
+declare class APITimeoutError extends APIConnectionError {}
+/** 400 or 422. */
+declare class BadRequestError extends APIError {}
+/** 401, or a 422 that rejects the token header. */
+declare class AuthenticationError extends APIError {}
+/** 402. */
+declare class PaymentRequiredError extends APIError {}
+/** 403. */
+declare class ForbiddenError extends APIError {}
+/** 404. */
+declare class NotFoundError extends APIError {}
+/** 409. */
+declare class ConflictError extends APIError {}
+/** 429. `retryAfter` is the server's hint in ms. */
+declare class RateLimitError extends APIError {}
+/** 429 with `shared_traffic_limit_reached`. */
+declare class SharedTrafficLimitError extends APIError {}
+/** 429 with `premium_traffic_limit_reached`. */
+declare class PremiumTrafficLimitError extends APIError {}
+/** 429 with `monthly_session_limit_reached`. */
+declare class MonthlySessionLimitError extends APIError {}
+/** 5xx. */
+declare class ServerError extends APIError {}
+/** An error reply to a CDP command, or a lost connection. */
+declare class CDPError extends SurfskyError {
+  readonly code: number | undefined;
+  constructor(message: string, options?: {
+    code?: number;
+    cause?: unknown;
+  });
+}
+/** A browser wait or command ran out of time. */
+declare class BrowserTimeoutError extends SurfskyError {}
+/** The page is gone. */
+declare class PageClosedError extends SurfskyError {}
+//#endregion
+//#region src/transport.d.ts
+type Params = Record<string, string | number | boolean | undefined>;
+/** One API call: the request plus how to read its reply. */
+interface Spec<T> {
+  method: string;
+  path: string;
+  json?: unknown;
+  params?: Params;
+  body?: BodyInit;
+  parse?: (data: any) => T;
+  acceptError?: (status: number, body: unknown) => boolean;
+  timeout?: number;
+}
+interface Logger {
+  debug(message: string): void;
+  info(message: string): void;
+  warn(message: string): void;
+  error(message: string): void;
+}
+//#endregion
+//#region src/browser/cdp.d.ts
+/** What the client needs from a socket; the native `WebSocket` fits. */
+interface WebSocketLike {
+  readonly readyState: number;
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+  addEventListener(type: string, listener: (event: any) => void): void;
+}
+type CreateWebSocket = (url: string) => WebSocketLike;
+type EventHandler = (params: any, sessionId: string | undefined) => void;
+interface CDPClientOptions {
+  createWebSocket?: CreateWebSocket;
+  onClose?: () => void;
+  logger?: Partial<Logger> | null;
+}
+declare class CDPClient {
+  #private;
+  readonly wsUrl: string;
+  onClose: (() => void) | undefined;
+  constructor(wsUrl: string, options?: CDPClientOptions);
+  get connected(): boolean;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  on(event: string, handler: EventHandler): void;
+  /** Put a command on the wire and hand back its reply to await later. */
+  post(method: string, params?: Record<string, unknown>, sessionId?: string): {
+    id: number;
+    reply: Promise<any>;
+  };
+  /** Drop a posted command nobody is going to await. */
+  forget(id: number): void;
+  send(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<any>;
+}
+//#endregion
+//#region src/util.d.ts
+/** A one-shot event: `wait()` resolves once `set()` was called. */
+declare class Flag {
+  #private;
+  get isSet(): boolean;
+  set(): void;
+  wait(): Promise<void>;
+}
+//#endregion
+//#region src/browser/page.d.ts
+type DialogHandler = (kind: string, message: string) => boolean | string | null | undefined;
+interface GotoOptions {
+  waitUntil?: WaitUntil;
+  /** ms */
+  timeout?: number;
+}
+interface WaitOptions {
+  /** ms */
+  timeout?: number;
+}
+interface EvaluateOptions {
+  args?: unknown[];
+  /** The isolated world the page cannot see (default), or the page's own context. */
+  isolated?: boolean;
+  awaitPromise?: boolean;
+}
+interface ScreenshotOptions {
+  selector?: string;
+  fullPage?: boolean;
+  format?: "png" | "jpeg" | "webp";
+  quality?: number;
+}
+/** A wait's time budget: poll loops `check()` it, single awaits `race()` against it. `null` is no limit. */
+declare class Deadline {
+  readonly timeout: number | null;
+  readonly message: string;
+  readonly until: number;
+  constructor(timeout: number | null | undefined, message: string);
+  error(): BrowserTimeoutError;
+  check(): void;
+  race<T>(promise: Promise<T>): Promise<T>;
+}
+declare class CapturedResponse {
+  readonly url: string;
+  readonly status: number;
+  readonly headers: Record<string, string>;
+  readonly body: Uint8Array;
+  constructor(url: string, status: number, headers: Record<string, string>, body: Uint8Array);
+  get text(): string;
+  json(): any;
+}
+/** The lifecycle wait of one `goto`. */
+declare class NavWaiter {
+  readonly milestone: string;
+  readonly done: Flag;
+  error: string | undefined;
+  loaderId: string | undefined;
+  readonly created: string[];
+  readonly reached: Set<string>;
+  constructor(milestone: string);
+  follow(loaderId: string): boolean;
+  followNewest(): boolean;
+  observe(name: unknown, loaderId: unknown): void;
+  fail(reason: string): void;
+}
+/** One page target. `Browser` is the session's first page plus the connection. */
+declare class Page extends Actions {
+  #private;
+  /** @internal */ _browser: Browser;
+  /** @internal */ _targetId: string;
+  /** @internal */ _sessionId: string;
+  /** @internal */ _frameId: string;
+  /** @internal */ _closed: boolean;
+  /** Answers this page's dialogs; the browser's handler when unset. */
+  onDialog: DialogHandler | null;
+  /** @internal the main frame's newest document */
+  _loaderId: string | undefined;
+  /** @internal the lifecycle events it reached */
+  _milestones: Set<string>;
+  /** @internal the isolated world's context */
+  _worldId: number | undefined;
+  /** @internal commands wait for the setup */
+  _ready: Flag;
+  /** @internal */ _setupError: unknown;
+  /** @internal */ _waiter: NavWaiter | undefined;
+  /** @internal */ _status: number | undefined;
+  /** @internal */ _storageReady: boolean;
+  /** @internal */ _captures: string[];
+  /** @internal */ _responses: CapturedResponse[];
+  /** @internal */ _inFlight: Map<string, Record<string, unknown>>;
+  constructor(browser: Browser | undefined, targetId: string, sessionId: string);
+  /** @internal fresh page state; the browser reuses it on connect */
+  _reset(targetId: string, sessionId: string): void;
+  get cdp(): CDPClient;
+  get targetId(): string;
+  get closed(): boolean;
+  get status(): number | undefined;
+  send(method: string, params?: Record<string, unknown>): Promise<any>;
+  /** @internal */
+  _requireOpen(): void;
+  /** @internal */
+  _send(method: string, params?: Record<string, unknown>): Promise<any>;
+  /** @internal */
+  _waitReady(): Promise<void>;
+  /** @internal */
+  _setup(waiting: boolean): Promise<void>;
+  close(): Promise<void>;
+  bringToFront(): Promise<void>;
+  waitForLoadState(state?: WaitUntil, options?: WaitOptions): Promise<void>;
+  goto(url: string, options?: GotoOptions): Promise<void>;
+  reload(options?: GotoOptions): Promise<void>;
+  goBack(options?: WaitOptions): Promise<string | null>;
+  goForward(options?: WaitOptions): Promise<string | null>;
+  get responses(): CapturedResponse[];
+  /** Record responses whose URL contains a fragment. Call before navigating. */
+  captureResponses(...fragments: string[]): Promise<void>;
+  stopCapturing(): Promise<void>;
+  waitForResponse(fragment: string, options?: WaitOptions): Promise<CapturedResponse>;
+  /** @internal */
+  _onResponse(event: Record<string, any>): void;
+  /** @internal */
+  _onBodyReady(event: Record<string, any>): void;
+  localStorage(): Promise<Record<string, string>>;
+  setLocalStorage(values: Record<string, string>): Promise<void>;
+  sessionStorage(): Promise<Record<string, string>>;
+  setSessionStorage(values: Record<string, string>): Promise<void>;
+  clearCookies(): Promise<void>;
+  /**
+   * Run script in the page. A function (or a string that looks like one) is called
+   * with `args` as JSON; anything else is an expression. It runs in an isolated world:
+   * the page's DOM, but not its globals, so the page's own script cannot see the call
+   * or hook it. Page variables (`window.__data`) need `isolated: false`, the main
+   * world, where a site that hooks the natives can notice.
+   */
+  evaluate(expression: string | ((...args: any[]) => unknown), options?: EvaluateOptions): Promise<any>;
+  /** Poll until the expression is truthy. Returns the value. */
+  waitForFunction(expression: string | ((...args: any[]) => unknown), options?: EvaluateOptions & WaitOptions): Promise<any>;
+  innerText(selector: string): Promise<string | null>;
+  allInnerTexts(selector: string): Promise<string[]>;
+  getAttribute(selector: string, name: string): Promise<string | null>;
+  count(selector: string): Promise<number>;
+  selectOption(selector: string, option: string | {
+    value?: string;
+    label?: string;
+  }): Promise<string>;
+  waitForSelector(selector: string, options?: {
+    visible?: boolean;
+  } & WaitOptions): Promise<void>;
+  /** Wait until the URL contains the fragment. Returns the URL. */
+  waitForUrl(fragment: string, options?: WaitOptions): Promise<string>;
+  /** The first match has a bounding box. */
+  isVisible(selector: string): Promise<boolean>;
+  outerHtml(selector: string): Promise<string | null>;
+  setCookies(cookies: (Cookie | Record<string, unknown>)[]): Promise<void>;
+  content(): Promise<string>;
+  title(): Promise<string>;
+  url(): Promise<string>;
+  cookies(): Promise<Cookie[]>;
+  screenshot(options?: ScreenshotOptions): Promise<Uint8Array>;
+  /** @internal */
+  _onLifecycle(event: Record<string, any>): void;
+  /** @internal */
+  _onDialog(event: Record<string, any>): void;
+  /** @internal */
+  _onRequestPaused(event: Record<string, any>): void;
+  /** @internal */
+  _spawn(task: Promise<unknown>): void;
+}
+//#endregion
+//#region src/browser/browser.d.ts
+declare const RESOURCE_TYPES: Readonly<Record<string, string>>;
+interface BrowserOptions {
+  blockResources?: Iterable<string> | null;
+  blockUrls?: readonly string[] | null;
+  connectTimeout?: number;
+  commandTimeout?: number | null;
+  createWebSocket?: CreateWebSocket;
+  logger?: Partial<Logger> | null;
+  onClose?: () => Promise<void> | void;
+}
+/** A connected cloud browser, and the page its session started with. */
+declare class Browser extends Page implements AsyncDisposable {
+  #private;
+  readonly session: Session;
+  readonly data: Record<string, unknown>;
+  readonly blockedResources: ReadonlySet<string>;
+  readonly blockedUrls: readonly string[];
+  readonly connectTimeout: number;
+  readonly commandTimeout: number | null;
+  readonly logger: Logger;
+  /** @internal */ _pages: Map<string, Page>;
+  /** @internal aborts on close: background sleeps end early */
+  _signal: AbortSignal;
+  constructor(session: Session, options?: BrowserOptions);
+  get internalUuid(): string;
+  get cdp(): CDPClient;
+  get connected(): boolean;
+  get shouldRecycle(): boolean;
+  /**
+   * Leases so far, the current one included. Rotate the browser from your own loop:
+   *
+   *     if (browser.useCount >= 20) browser.retire();
+   */
+  get useCount(): number;
+  /** @internal */
+  _lease(): void;
+  get pages(): Page[];
+  /** @internal what a page's Fetch.enable intercepts */
+  get _fetchPatterns(): Record<string, unknown>[];
+  /** Replace this browser with a fresh one after the lease. */
+  retire(): void;
+  newPage(): Promise<Page>;
+  /**
+   * Run `action`, the click that opens a window, and return the page it opened:
+   *
+   *     const popup = await browser.waitForPage(browser.click("a[target=_blank]"));
+   *
+   * A site can open the window after an async step, so `pages` right after the
+   * click may not have it yet.
+   */
+  waitForPage(action: Promise<unknown> | (() => Promise<unknown>), options?: WaitOptions): Promise<Page>;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+  /** @internal a lease ends: other pages closed, captures dropped, dialogs reset; `data` stays */
+  _endLease(): Promise<void>;
+  /** @internal */
+  _pageReady(targetId: string, deadline: Deadline): Promise<Page>;
+  /** @internal */
+  _onAttached(event: Record<string, any>): void;
+  /** @internal */
+  _onDetached(event: Record<string, any>): void;
+  /** @internal */
+  _drop(page: Page): void;
+  /** @internal */
+  _onDisconnect(): void;
+  /** @internal track a background task; its failure is logged at debug level */
+  _spawn(task: Promise<unknown>): void;
+}
+//#endregion
+//#region src/resources/account.d.ts
+declare class Account {
+  #private;
+  readonly client: Surfsky;
+  constructor(client: Surfsky);
+  sessionLimits(): Promise<SessionLimits>;
+  browserLimits(): Promise<BrowserLimits>;
+  /** The plan's parallel-browser cap; `SURFSKY_MAX_BROWSERS` overrides it. */
+  maxBrowsers(): Promise<number>;
+}
+//#endregion
+//#region src/resources/extensions.d.ts
+type ExtensionFile = string | Uint8Array | Blob;
+declare class Extensions {
+  readonly client: Surfsky;
+  constructor(client: Surfsky);
+  /** Upload a zip (max 100 MB) given as a path, bytes or a Blob. */
+  upload(file: ExtensionFile, name: string): Promise<Extension>;
+  listAll(): Promise<Extension[]>;
+  get(uuid: string): Promise<Extension>;
+  update(uuid: string, options: {
+    name: string;
+  }): Promise<Extension>;
+  delete(uuid: string): Promise<void>;
+}
+//#endregion
+//#region src/resources/fingerprints.d.ts
+interface DeviceModelsOptions {
+  os?: OS;
+  os_arch?: Arch;
+  os_version?: string;
+  device_type?: DeviceType;
+}
+declare class Fingerprints {
+  readonly client: Surfsky;
+  constructor(client: Surfsky);
+  renderers(os: OS, osArch: Arch): Promise<Renderer[]>;
+  screens(os: OS, osArch: Arch): Promise<Screen[]>;
+  deviceModels(options?: DeviceModelsOptions): Promise<DeviceModel[]>;
+}
+//#endregion
+//#region src/proxy.d.ts
+interface ProxySource {
+  pick(): ProxyLike | null | Promise<ProxyLike | null>;
+}
+type ProxyFactory = () => ProxyLike | null | Promise<ProxyLike | null>;
+type ProxyInput = ProxyLike | ProxySource | ProxyFactory;
+/** Round-robin over a list. */
+declare class ProxyCycle implements ProxySource {
+  #private;
+  readonly proxies: ProxyLike[];
+  constructor(proxies: Iterable<ProxyLike>);
+  pick(): ProxyLike;
+}
+declare class ProxyRandom implements ProxySource {
+  readonly proxies: ProxyLike[];
+  constructor(proxies: Iterable<ProxyLike>);
+  pick(): ProxyLike;
+}
+/**
+ * A proxy URL from a template: `{session}` is a fresh hex id, `{n}` a counter.
+ * Covers the sticky-session syntax providers put in the username:
+ *
+ *     new ProxyTemplate("http://user-cc-us-sessid-{session}:pw@gate.example.com:7000")
+ *
+ * Literal braces are `{{` and `}}`.
+ */
+declare class ProxyTemplate implements ProxySource {
+  #private;
+  readonly template: string;
+  constructor(template: string);
+  pick(): string;
+}
+//#endregion
+//#region src/resources/profiles.d.ts
+type WithProxyInput<T> = Omit<T, "proxy"> & {
+  proxy?: ProxyInput | null;
+};
+type SessionOptions = WithProxyInput<OneTimeStartRequest>;
+type ProfileUpdate = WithProxyInput<ProfileUpdateRequest>;
+type ProfileCreate = WithProxyInput<ProfileCreateRequest>;
+type ScrapeOptions = Omit<ScrapeRequest, "url">;
+type ListPageOptions = ListPageRequest;
+declare class Profiles {
+  readonly client: Surfsky;
+  constructor(client: Surfsky);
+  /** Start a session on a fresh browser that is gone once stopped. */
+  startOneTime(options?: SessionOptions): Promise<Session>;
+  /** Start a session on a saved profile. */
+  start(uuid: string, options?: SessionOptions): Promise<Session>;
+  stop(session: Session | string): Promise<ProfileRef | null>;
+  stopAll(): Promise<StopAllResult>;
+  listActive(): Promise<ActiveProfile[]>;
+  create(options: ProfileCreate): Promise<ProfileRef>;
+  get(uuid: string): Promise<Profile>;
+  update(uuid: string, fields: ProfileUpdate): Promise<Profile>;
+  delete(uuid: string): Promise<ProfileRef>;
+  deleteMany(uuids: string[]): Promise<BatchDeleteResult>;
+  listPage(options?: ListPageOptions): Promise<ProfileSummary[]>;
+  /** Every profile, page by page. */
+  iterAll(options?: Omit<ListPageOptions, "page">): AsyncGenerator<ProfileSummary, void, undefined>;
+  exportCookies(uuid: string, options?: {
+    export_format?: "json";
+  }): Promise<Cookie[]>;
+  exportCookies(uuid: string, options: {
+    export_format: "netscape";
+  }): Promise<string>;
+  importCookies(uuid: string, cookies: string | Cookie[]): Promise<void>;
+  scrape(session: Session | string, url: string, options?: ScrapeOptions): Promise<ScrapeResult>;
+}
+//#endregion
+//#region src/resources/proxies.d.ts
+declare class Proxies {
+  readonly client: Surfsky;
+  constructor(client: Surfsky);
+  countries(): Promise<ProxyCountry[]>;
+  regions(country: string): Promise<ProxyRegion[]>;
+  cities(country: string, region: string): Promise<ProxyCity[]>;
+  quota(): Promise<ProxyQuota>;
+  premiumStats(): Promise<TrafficStats>;
+  sharedCountries(): Promise<string[]>;
+  sharedQuota(): Promise<SharedProxyQuota>;
+  sharedStats(): Promise<TrafficStats>;
+}
+//#endregion
+//#region src/client.d.ts
+interface SurfskyOptions {
+  /** Falls back to `SURFSKY_API_TOKEN`. */
+  apiToken?: string;
+  /** Falls back to `SURFSKY_API_BASE_URL`. */
+  baseUrl?: string;
+  /** Per-request timeout in ms. Default 30_000. */
+  timeout?: number;
+  /** Default 3. */
+  maxRetries?: number;
+  /** Base retry delay in ms, doubled per attempt. Default 500. */
+  backoff?: number;
+  headers?: Record<string, string>;
+  /** Warnings and errors go to the console by default; `null` silences the SDK. */
+  logger?: Partial<Logger> | null;
+  /** Mostly for tests. */
+  fetch?: typeof fetch;
+}
+interface RequestOptions {
+  json?: unknown;
+  params?: Params;
+  body?: BodyInit;
+  headers?: Record<string, string>;
+  timeout?: number;
+}
+interface SessionStartOptions extends SessionOptions {
+  /** A saved profile to start; a one-time session when absent. */
+  profileUuid?: string;
+}
+interface BrowserStartOptions extends SessionStartOptions {
+  /** CDP resource types to drop: `["image", "font", "media"]` saves proxy traffic. */
+  blockResources?: Iterable<string> | null;
+  /** Fetch URL patterns to drop (`*` wildcards). */
+  blockUrls?: readonly string[] | null;
+  /** ms, default 30_000 */
+  connectTimeout?: number;
+  /** ms per CDP command, default 60_000; `null` for none */
+  commandTimeout?: number | null;
+  createWebSocket?: CreateWebSocket;
+}
+/** A started session that stops itself on `stop()` or `await using`. */
+type ManagedSession = Session & AsyncDisposable & {
+  stop(): Promise<void>;
+};
+declare class Surfsky implements AsyncDisposable {
+  #private;
+  readonly baseUrl: string;
+  readonly headers: Record<string, string>;
+  readonly timeout: number;
+  readonly maxRetries: number;
+  readonly backoff: number;
+  readonly logger: Logger;
+  readonly fetch: typeof fetch;
+  readonly profiles: Profiles;
+  readonly proxies: Proxies;
+  readonly fingerprints: Fingerprints;
+  readonly extensions: Extensions;
+  readonly account: Account;
+  constructor(options?: SurfskyOptions);
+  withOptions(options: {
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+  }): Surfsky;
+  call<T>(spec: Spec<T>): Promise<T>;
+  /** A raw call for endpoints the SDK does not cover. Never throws on status. */
+  request(method: string, path: string, options?: RequestOptions): Promise<Response>;
+  /** Start a session; `stop()` it (or `await using`) so it does not keep billing. */
+  session(options?: SessionStartOptions): Promise<ManagedSession>;
+  /** Start a session and connect a `Browser` to it. `close()` stops the session. */
+  browser(options?: BrowserStartOptions): Promise<Browser>;
+  /** An open `BrowserPool`. `close()` stops every browser in it. */
+  browsers(options?: PoolOptions): Promise<BrowserPool>;
+  /** `browsers()` and `pool.map()` in 1 call. */
+  map<I, R>(handler: PoolHandler<I, R>, items: Iterable<I>, options?: PoolOptions): Promise<PoolOutcome<I, R>[]>;
+  /** Nothing to release with fetch; here for `await using` symmetry. */
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+}
+//#endregion
+//#region src/browser/pool.d.ts
+type PoolHandler<I, R> = (browser: Browser, item: I) => Promise<R>;
+interface PoolOptions extends SessionOptions {
+  /** Live browsers at most; `"auto"` (default) is the plan's cap. */
+  concurrency?: number | "auto";
+  blockResources?: Iterable<string> | null;
+  blockUrls?: readonly string[] | null;
+  createWebSocket?: CreateWebSocket;
+}
+/** Throw from a `map` handler to end the run after this item. */
+declare class StopRun extends Error {
+  constructor(message?: string);
+}
+type PoolOutcome<I, R> = {
+  ok: true;
+  item: I;
+  index: number;
+  value: R;
+} | {
+  ok: false;
+  item: I;
+  index: number;
+  error: unknown;
+};
+declare class BrowserPool implements AsyncDisposable {
+  #private;
+  readonly sessionOptions: SessionOptions;
+  readonly blockedResources: ReadonlySet<string>;
+  readonly blockedUrls: readonly string[];
+  constructor(client: Surfsky, options?: PoolOptions);
+  /** Max live browsers. */
+  get capacity(): number;
+  open(): Promise<this>;
+  /** Stop every idle browser. A browser still on lease is stopped when its lease ends. */
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+  /** Run `fn` on a live browser, then hand the browser back. Waits while all are busy. */
+  lease<R>(fn: (browser: Browser) => Promise<R>): Promise<R>;
+  /** Run every item through `handler` on a leased browser, `capacity` at a time. */
+  map<I, R>(handler: PoolHandler<I, R>, items: Iterable<I>): Promise<PoolOutcome<I, R>[]>;
+}
+//#endregion
+//#region src/version.d.ts
+declare const VERSION: string;
+//#endregion
+export { APIConnectionError, APIError, APIErrorOptions, APITimeoutError, Account, Actions, type ActiveProfile, type Arch, AuthenticationError, BadRequestError, type BatchDeleteResult, Browser, type BrowserLimits, type BrowserOptions, BrowserPool, type BrowserSettings, type BrowserStartOptions, BrowserTimeoutError, CDPClient, type CDPClientOptions, CDPError, CapturedResponse, type ClickOptions, ConfigurationError, ConflictError, type Cookie, type CookieInput, type CreateWebSocket, type DblclickOptions, type DeviceModel, type DeviceModelsOptions, type DeviceType, type DialogHandler, type DomainRoute, type DragOptions, type EvaluateOptions, type EventHandler, type ExportFormat, type Extension, type ExtensionFile, Extensions, type Fingerprint, Fingerprints, ForbiddenError, type Geolocation, type GotoOptions, type HoverOptions, type Inspector, type InspectorPage, type KeyModifier, Keyboard, type ListPageOptions, type ListPageRequest, type Logger, type Loose, type ManagedSession, type MediaDevices, MonthlySessionLimitError, Mouse, type MouseButton, type MouseClickOptions, type Noise, NotFoundError, type OS, type OneTimeStartRequest, Page, PageClosedError, PaymentRequiredError, type PoolHandler, type PoolOptions, type PoolOutcome, type PremiumProxy, PremiumTrafficLimitError, type PressOptions, type Profile, type ProfileCreate, type ProfileCreateRequest, type ProfileOrdering, type ProfileRef, type ProfileStartRequest, type ProfileSummary, type ProfileUpdate, type ProfileUpdateRequest, Profiles, Proxies, type ProxyCity, type ProxyCountry, ProxyCycle, type ProxyFactory, type ProxyInput, type ProxyLike, type ProxyQuota, ProxyRandom, type ProxyRegion, type ProxySource, ProxyTemplate, type ProxyType, RESOURCE_TYPES, RateLimitError, type RegionalPool, type Renderer, type RequestOptions, type ScrapeOptions, type ScrapeRequest, type ScrapeResult, type Screen, type ScreenshotOptions, type ScrollBehavior, type ScrollOptions, type ScrollToOptions, ServerError, type Session, type SessionLimits, type SessionOptions, type SessionStartOptions, type SharedProxy, type SharedProxyQuota, SharedTrafficLimitError, type Spec, type StopAllResult, StopRun, type StorageOptions, Surfsky, SurfskyError, type SurfskyOptions, type TrafficStats, type TrafficVolume, VERSION, ValidationError, type WaitOptions, type WaitUntil, type WebSocketLike, type isRecord, type parseListPageRequest, type parseOneTimeStartRequest, type parseProfileCreateRequest, type parseProfileStartRequest, type parseProfileUpdateRequest, type parseProxyLike, type parseScrapeRequest };