@scalebrowser/sdk 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -10,6 +10,12 @@ that had been kept all along.
 The daemon and the SDK version independently. An SDK release names the daemon
 version it was tested against wherever that matters.
 
+## 0.8.1 (2026-09-16)
+
+The published `package.json` no longer lists a `smoke` script. It pointed at a
+file outside the package, so it could not run from an installed copy, and
+nothing called it. The library itself is unchanged.
+
 ## 0.8.0 (2026-09-11)
 
 Breaking: `host_mode` is gone, and with it the `HostMode` type and the

package/dist/index.cjs

@@ -1738,7 +1738,7 @@ var PROXY_KINDS = ["http", "socks5", "gateway"];
 var ROTATIONS = ["sticky", "rotating"];
 
 // src/index.ts
-var VERSION = "0.8.0";
+var VERSION = "0.9.0";
 
 exports.ApiError = ApiError;
 exports.CdpError = CdpError;

package/dist/index.d.cts

@@ -771,6 +771,18 @@ interface Proxy {
      * address stays reserved for a profile.
      */
     last_asn: string | null;
+    /**
+     * The IANA timezone the geo probe reported for the exit, for example
+     * `"America/Chicago"`, or `null` when it reported none.
+     *
+     * Written by the same check that writes `last_asn`, and cleared with it when
+     * the endpoint changes. It is not decoration: a profile on
+     * `geo_mode: "follow_exit"` adopts THIS zone at every start when the country's
+     * cohort knows it, instead of the country's canonical one, so a US proxy
+     * exiting in Tulsa leaves the profile on `America/Chicago` rather than
+     * `America/New_York`.
+     */
+    last_timezone: string | null;
     last_check_at: number | null;
     healthy: boolean | null;
     /** Round-trip latency of the last health check, in ms. */
@@ -954,8 +966,15 @@ interface ExitStatus {
     enabled: boolean;
     /** Derived from the newest claim, not from configuration. */
     scope: ExitScope;
-    /** The address in use, when one is claimed. */
+    /** The IPv4 address in use, when one is claimed. Carries its `v4:` prefix. */
     current: string | null;
+    /**
+     * The IPv6 `/64` in use, when the daemon measures v6 (`[exit] probe_url_v6`)
+     * and the exit answered over it. `null` is the ordinary case and says nothing
+     * about the exit: without that setting the guard never asks.
+     */
+    current_v6: string | null;
+    /** How many addresses this profile owns. Both families count. */
     owned: number;
     claims: ExitClaim[];
     /** Set when the profile has no proxy and is therefore exempt. */
@@ -1693,7 +1712,34 @@ interface ProxyCheckResult {
     healthy: boolean;
     exit_ip: string | null;
     country: string | null;
-    /** Carrier/mobile-exit hint from the exit lookup (a mobile exit is the best case). */
+    /**
+     * The operator string the geo probe answered with, e.g.
+     * `"AS21928 T-Mobile USA, Inc."`; `null` when it reported none. Same value the
+     * check persists as `Proxy.last_asn`.
+     */
+    asn?: string | null;
+    /**
+     * The IANA timezone of the exit, e.g. `"America/Chicago"`; `null` when the
+     * probe reported none. Same value the check persists as `Proxy.last_timezone`,
+     * and the one a `follow_exit` profile adopts at its next start.
+     */
+    timezone?: string | null;
+    /**
+     * What kind of network the exit sits on, derived from `asn` against the
+     * daemon's own dataset. `"unknown"` means unproven, never safe: it is what you
+     * get with no dataset installed and with an ASN the dataset does not know.
+     * A datacenter exit is the single biggest real-world tell.
+     */
+    exit_class?: "datacenter" | "residential" | "mobile" | "unknown";
+    /**
+     * Whether the exit is a mobile/carrier network, the best case for anti-detect.
+     *
+     * SINCE 2026-09-18 this is derived from `exit_class` and answers three states:
+     * `true`, `false`, and `null` for "could not be classified". Before that it
+     * mirrored a flag of the geo lookup that the configured endpoint never sets, so
+     * it was structurally `false` on every answer, including genuinely mobile
+     * exits. Treat a `null` as unknown, not as "no".
+     */
     is_mobile?: boolean | null;
     ja4?: string | null;
     ja4t?: string | null;
@@ -2859,6 +2905,6 @@ declare function errorMessage(err: unknown): string;
  * ```
  */
 
-declare const VERSION = "0.8.0";
+declare const VERSION = "0.9.0";
 
 export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AudioStatus, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type BlockedExport, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type Chapter, type ClickOptions, type CodecsStatus, type Connection, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, type CreateTasksBody, type CreateTasksResult, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type ExitClaim, type ExitRuleStatus, type ExitScope, type ExitStatus, type ExportPresetName, type ExtraOutput, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, type HealthStatus, type Inbox, type InboxBinding, type InboxBindings, type InboxChannel, type InputClient, type InterruptionChoice, type InterruptionLock, type InterruptionLockRow, type InterruptionLockView, type InterruptionRuleRow, type LaunchHandle, type ListRunsParams, type ListStepsParams, type ListTasksParams, type ListVideosParams, type MediaAsset, type MediaKind, type MusicBed, type NarrationLine, type NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PatchTaskBody, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type PreviewHidden, type PreviewMoment, type Profile, type ProfileActivity, type ProfileMemory, type ProfileTask, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, type ProxyRow, type ProxyUsage, ROTATIONS, RUNTIME_STATES, type ReadyStatus, type Recording, type RecordingKind, type RecordingState, type RemoteStatus, type RenderProgress, type RenderRequestBody, type RenderStage, type RevealCookiesBody, type RevealCookiesResult, type RevealedCookie, type Rotation, type RunActor, type RunOutcome, type RunStep, type RuntimeState, ScalebrowserClient, type ScalebrowserClientOptions, ScalebrowserError, type ScrollOptions, type SecretBindingMode, type SecretDeleteResult, type SecretKind, type SecretListResult, type SecretOrigin, type SecretPatchBody, type SecretRow, type SecretRunBody, type SecretRunMention, type SecretRunResult, type SecretScrubResult, type SecretState, type SessionExportBody, type SessionExportResult, type SessionImportBody, type SessionKind, type SetInterruptionLockBody, type SetInterruptionRuleBody, type ShareLinkLocal, type ShareStatus, type ShotFocus, type ShotIntent, type StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TaskState, type TimestampState, type TranscriptWord, type TrustedInputBody, type TtsProviderView, type TtsVerifyResult, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, type Video, type VideoAccessGrant, type VideoAssetName, type VideoAssets, type VideoBackground, type VideoCard, type VideoDestination, type VideoFlags, type VideoPreset, type VideoPresetClip, type VideoPresetClipBody, type VideoPresetClipProgress, type VideoPresetClipStarted, type VideoPresetConfig, type VideoPresetPreview, type VideoPresetPreviewBody, type VideoState, type VideosPage, type VideosStorage, type WriteMemoryBody, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/dist/index.d.ts

@@ -771,6 +771,18 @@ interface Proxy {
      * address stays reserved for a profile.
      */
     last_asn: string | null;
+    /**
+     * The IANA timezone the geo probe reported for the exit, for example
+     * `"America/Chicago"`, or `null` when it reported none.
+     *
+     * Written by the same check that writes `last_asn`, and cleared with it when
+     * the endpoint changes. It is not decoration: a profile on
+     * `geo_mode: "follow_exit"` adopts THIS zone at every start when the country's
+     * cohort knows it, instead of the country's canonical one, so a US proxy
+     * exiting in Tulsa leaves the profile on `America/Chicago` rather than
+     * `America/New_York`.
+     */
+    last_timezone: string | null;
     last_check_at: number | null;
     healthy: boolean | null;
     /** Round-trip latency of the last health check, in ms. */
@@ -954,8 +966,15 @@ interface ExitStatus {
     enabled: boolean;
     /** Derived from the newest claim, not from configuration. */
     scope: ExitScope;
-    /** The address in use, when one is claimed. */
+    /** The IPv4 address in use, when one is claimed. Carries its `v4:` prefix. */
     current: string | null;
+    /**
+     * The IPv6 `/64` in use, when the daemon measures v6 (`[exit] probe_url_v6`)
+     * and the exit answered over it. `null` is the ordinary case and says nothing
+     * about the exit: without that setting the guard never asks.
+     */
+    current_v6: string | null;
+    /** How many addresses this profile owns. Both families count. */
     owned: number;
     claims: ExitClaim[];
     /** Set when the profile has no proxy and is therefore exempt. */
@@ -1693,7 +1712,34 @@ interface ProxyCheckResult {
     healthy: boolean;
     exit_ip: string | null;
     country: string | null;
-    /** Carrier/mobile-exit hint from the exit lookup (a mobile exit is the best case). */
+    /**
+     * The operator string the geo probe answered with, e.g.
+     * `"AS21928 T-Mobile USA, Inc."`; `null` when it reported none. Same value the
+     * check persists as `Proxy.last_asn`.
+     */
+    asn?: string | null;
+    /**
+     * The IANA timezone of the exit, e.g. `"America/Chicago"`; `null` when the
+     * probe reported none. Same value the check persists as `Proxy.last_timezone`,
+     * and the one a `follow_exit` profile adopts at its next start.
+     */
+    timezone?: string | null;
+    /**
+     * What kind of network the exit sits on, derived from `asn` against the
+     * daemon's own dataset. `"unknown"` means unproven, never safe: it is what you
+     * get with no dataset installed and with an ASN the dataset does not know.
+     * A datacenter exit is the single biggest real-world tell.
+     */
+    exit_class?: "datacenter" | "residential" | "mobile" | "unknown";
+    /**
+     * Whether the exit is a mobile/carrier network, the best case for anti-detect.
+     *
+     * SINCE 2026-09-18 this is derived from `exit_class` and answers three states:
+     * `true`, `false`, and `null` for "could not be classified". Before that it
+     * mirrored a flag of the geo lookup that the configured endpoint never sets, so
+     * it was structurally `false` on every answer, including genuinely mobile
+     * exits. Treat a `null` as unknown, not as "no".
+     */
     is_mobile?: boolean | null;
     ja4?: string | null;
     ja4t?: string | null;
@@ -2859,6 +2905,6 @@ declare function errorMessage(err: unknown): string;
  * ```
  */
 
-declare const VERSION = "0.8.0";
+declare const VERSION = "0.9.0";
 
 export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AudioStatus, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type BlockedExport, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type Chapter, type ClickOptions, type CodecsStatus, type Connection, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, type CreateTasksBody, type CreateTasksResult, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type ExitClaim, type ExitRuleStatus, type ExitScope, type ExitStatus, type ExportPresetName, type ExtraOutput, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, type HealthStatus, type Inbox, type InboxBinding, type InboxBindings, type InboxChannel, type InputClient, type InterruptionChoice, type InterruptionLock, type InterruptionLockRow, type InterruptionLockView, type InterruptionRuleRow, type LaunchHandle, type ListRunsParams, type ListStepsParams, type ListTasksParams, type ListVideosParams, type MediaAsset, type MediaKind, type MusicBed, type NarrationLine, type NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PatchTaskBody, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type PreviewHidden, type PreviewMoment, type Profile, type ProfileActivity, type ProfileMemory, type ProfileTask, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, type ProxyRow, type ProxyUsage, ROTATIONS, RUNTIME_STATES, type ReadyStatus, type Recording, type RecordingKind, type RecordingState, type RemoteStatus, type RenderProgress, type RenderRequestBody, type RenderStage, type RevealCookiesBody, type RevealCookiesResult, type RevealedCookie, type Rotation, type RunActor, type RunOutcome, type RunStep, type RuntimeState, ScalebrowserClient, type ScalebrowserClientOptions, ScalebrowserError, type ScrollOptions, type SecretBindingMode, type SecretDeleteResult, type SecretKind, type SecretListResult, type SecretOrigin, type SecretPatchBody, type SecretRow, type SecretRunBody, type SecretRunMention, type SecretRunResult, type SecretScrubResult, type SecretState, type SessionExportBody, type SessionExportResult, type SessionImportBody, type SessionKind, type SetInterruptionLockBody, type SetInterruptionRuleBody, type ShareLinkLocal, type ShareStatus, type ShotFocus, type ShotIntent, type StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TaskState, type TimestampState, type TranscriptWord, type TrustedInputBody, type TtsProviderView, type TtsVerifyResult, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, type Video, type VideoAccessGrant, type VideoAssetName, type VideoAssets, type VideoBackground, type VideoCard, type VideoDestination, type VideoFlags, type VideoPreset, type VideoPresetClip, type VideoPresetClipBody, type VideoPresetClipProgress, type VideoPresetClipStarted, type VideoPresetConfig, type VideoPresetPreview, type VideoPresetPreviewBody, type VideoState, type VideosPage, type VideosStorage, type WriteMemoryBody, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/dist/index.js

@@ -1732,6 +1732,6 @@ var PROXY_KINDS = ["http", "socks5", "gateway"];
 var ROTATIONS = ["sticky", "rotating"];
 
 // src/index.ts
-var VERSION = "0.8.0";
+var VERSION = "0.9.0";
 
 export { ApiError, CdpError, CdpSession, DEFAULT_CAPACITY, ErrorCode, GEO_MODES, NetworkError, PROXY_KINDS, ROTATIONS, RUNTIME_STATES, ScalebrowserClient, ScalebrowserError, VERSION, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalebrowser/sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Official Node/TypeScript SDK for the Scalebrowser daemon: typed REST client plus a direct-CDP driver plane (nodriver-style, not Playwright).",
   "type": "module",
   "license": "MIT",
@@ -46,7 +46,6 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "prepare": "npm run build",
-    "smoke": "node ../scripts/smoke-node.mjs",
     "lint": "eslint src test examples",
     "test:coverage": "vitest run --coverage"
   },