@scalebrowser/sdk 0.4.0 → 0.4.1

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -1,76 +1,5 @@
 import WebSocket from 'ws';
 
-/**
- * Error model: stable numeric API error codes (SPEC §5,
- * `crates/core/src/error.rs`) and the typed exceptions the SDK throws.
- */
-/** Stable numeric API error codes (4001–4012, append-only: a retired code stays
- * reserved rather than being reused). */
-declare const ErrorCode: {
-    readonly NotFound: 4001;
-    readonly ProxyGeo: 4002;
-    readonly Capacity: 4003;
-    readonly EngineMissing: 4004;
-    readonly Preflight: 4005;
-    readonly AlreadyRunning: 4006;
-    /** Retired: the removed Methode-D (VM) tier produced this. Reserved (never reused)
-     * to match the server's append-only code contract; never returned now. */
-    readonly VmProvisionFailed: 4007;
-    /** The subscription's abo-wide concurrent-browser allowance is used up (DEC-012).
-     * Distinct from Capacity (4003 = this machine is full, wait): the caller's move
-     * is to stop a running browser anywhere or upgrade the plan. */
-    readonly ConcurrencyLimit: 4008;
-    readonly Unauthorized: 4010;
-    /** No account is connected to this machine, so nothing may run (DEC-014).
-     * Distinct from Unauthorized (4010 = the daemon's own bearer token is wrong, so
-     * re-read the token): 4011 means the machine needs to be signed in, and no token
-     * a client holds can substitute for that. Connect it in the desktop app. */
-    readonly NotSignedIn: 4011;
-    /** This ONE profile is open on another machine of the same account (DEC-015).
-     * Distinct from ConcurrencyLimit (4008 = the plan is full, buy more or free any
-     * browser): the caller's move here costs nothing. Close it on that machine, or
-     * take it over from the app running there. */
-    readonly ProfileInUse: 4012;
-};
-type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
-/** Error body shape: `{ code, message }` (docs/features/api.md). */
-interface ApiErrorBody {
-    code?: number;
-    message?: string;
-}
-/** Base class for every error this SDK throws, so callers can `catch` one type. */
-declare class ScalebrowserError extends Error {
-    constructor(message: string);
-}
-/**
- * A typed transport/contract error. Carries the HTTP `status` and the daemon's
- * numeric `code` so callers (and the auth layer) can react, e.g. 401 / code
- * 4010 → re-authenticate.
- */
-declare class ApiError extends ScalebrowserError {
-    readonly status: number;
-    readonly code?: number;
-    readonly body?: ApiErrorBody;
-    constructor(status: number, body?: ApiErrorBody, fallbackMessage?: string);
-    /** True for auth failures that must trigger re-authentication. */
-    get isAuthError(): boolean;
-    /** Short label for the error code, if any. */
-    get codeLabel(): string | undefined;
-}
-/** A network-level failure (daemon unreachable, socket error, fetch rejected). */
-declare class NetworkError extends ScalebrowserError {
-    readonly cause?: unknown;
-    constructor(message: string, cause?: unknown);
-}
-/** A CDP command that returned an `error` frame, or a closed CDP connection. */
-declare class CdpError extends ScalebrowserError {
-    readonly code: number;
-    readonly data?: unknown;
-    constructor(code: number, message: string, data?: unknown);
-}
-/** Narrow an unknown thrown value to a user-facing message. */
-declare function errorMessage(err: unknown): string;
-
 interface Screen {
     width: number;
     height: number;
@@ -1747,6 +1676,77 @@ declare class ScalebrowserClient extends ClientCore {
 interface ScalebrowserClient extends IdentityApi, RunsApi, ControlApi, ExtensionsApi {
 }
 
+/**
+ * Error model: stable numeric API error codes (SPEC §5,
+ * `crates/core/src/error.rs`) and the typed exceptions the SDK throws.
+ */
+/** Stable numeric API error codes (4001–4012, append-only: a retired code stays
+ * reserved rather than being reused). */
+declare const ErrorCode: {
+    readonly NotFound: 4001;
+    readonly ProxyGeo: 4002;
+    readonly Capacity: 4003;
+    readonly EngineMissing: 4004;
+    readonly Preflight: 4005;
+    readonly AlreadyRunning: 4006;
+    /** Retired: the removed Methode-D (VM) tier produced this. Reserved (never reused)
+     * to match the server's append-only code contract; never returned now. */
+    readonly VmProvisionFailed: 4007;
+    /** The subscription's abo-wide concurrent-browser allowance is used up (DEC-012).
+     * Distinct from Capacity (4003 = this machine is full, wait): the caller's move
+     * is to stop a running browser anywhere or upgrade the plan. */
+    readonly ConcurrencyLimit: 4008;
+    readonly Unauthorized: 4010;
+    /** No account is connected to this machine, so nothing may run (DEC-014).
+     * Distinct from Unauthorized (4010 = the daemon's own bearer token is wrong, so
+     * re-read the token): 4011 means the machine needs to be signed in, and no token
+     * a client holds can substitute for that. Connect it in the desktop app. */
+    readonly NotSignedIn: 4011;
+    /** This ONE profile is open on another machine of the same account (DEC-015).
+     * Distinct from ConcurrencyLimit (4008 = the plan is full, buy more or free any
+     * browser): the caller's move here costs nothing. Close it on that machine, or
+     * take it over from the app running there. */
+    readonly ProfileInUse: 4012;
+};
+type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+/** Error body shape: `{ code, message }` (docs/features/api.md). */
+interface ApiErrorBody {
+    code?: number;
+    message?: string;
+}
+/** Base class for every error this SDK throws, so callers can `catch` one type. */
+declare class ScalebrowserError extends Error {
+    constructor(message: string);
+}
+/**
+ * A typed transport/contract error. Carries the HTTP `status` and the daemon's
+ * numeric `code` so callers (and the auth layer) can react, e.g. 401 / code
+ * 4010 → re-authenticate.
+ */
+declare class ApiError extends ScalebrowserError {
+    readonly status: number;
+    readonly code?: number;
+    readonly body?: ApiErrorBody;
+    constructor(status: number, body?: ApiErrorBody, fallbackMessage?: string);
+    /** True for auth failures that must trigger re-authentication. */
+    get isAuthError(): boolean;
+    /** Short label for the error code, if any. */
+    get codeLabel(): string | undefined;
+}
+/** A network-level failure (daemon unreachable, socket error, fetch rejected). */
+declare class NetworkError extends ScalebrowserError {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/** A CDP command that returned an `error` frame, or a closed CDP connection. */
+declare class CdpError extends ScalebrowserError {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/** Narrow an unknown thrown value to a user-facing message. */
+declare function errorMessage(err: unknown): string;
+
 /**
  * `@scalebrowser/sdk`: the official Node/TypeScript SDK for the Scalebrowser
  * daemon. A typed REST client plus a direct-CDP driver plane (nodriver-style,
@@ -1764,6 +1764,6 @@ interface ScalebrowserClient extends IdentityApi, RunsApi, ControlApi, Extension
  * ```
  */
 
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.4.1";
 
 export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type ClickOptions, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, HOST_MODES, type HealthStatus, type HostMode, 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 NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type Profile, type ProfileActivity, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, ROTATIONS, RUNTIME_STATES, type ReadyStatus, 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 StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TrustedInputBody, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/dist/index.d.ts

@@ -1,76 +1,5 @@
 import WebSocket from 'ws';
 
-/**
- * Error model: stable numeric API error codes (SPEC §5,
- * `crates/core/src/error.rs`) and the typed exceptions the SDK throws.
- */
-/** Stable numeric API error codes (4001–4012, append-only: a retired code stays
- * reserved rather than being reused). */
-declare const ErrorCode: {
-    readonly NotFound: 4001;
-    readonly ProxyGeo: 4002;
-    readonly Capacity: 4003;
-    readonly EngineMissing: 4004;
-    readonly Preflight: 4005;
-    readonly AlreadyRunning: 4006;
-    /** Retired: the removed Methode-D (VM) tier produced this. Reserved (never reused)
-     * to match the server's append-only code contract; never returned now. */
-    readonly VmProvisionFailed: 4007;
-    /** The subscription's abo-wide concurrent-browser allowance is used up (DEC-012).
-     * Distinct from Capacity (4003 = this machine is full, wait): the caller's move
-     * is to stop a running browser anywhere or upgrade the plan. */
-    readonly ConcurrencyLimit: 4008;
-    readonly Unauthorized: 4010;
-    /** No account is connected to this machine, so nothing may run (DEC-014).
-     * Distinct from Unauthorized (4010 = the daemon's own bearer token is wrong, so
-     * re-read the token): 4011 means the machine needs to be signed in, and no token
-     * a client holds can substitute for that. Connect it in the desktop app. */
-    readonly NotSignedIn: 4011;
-    /** This ONE profile is open on another machine of the same account (DEC-015).
-     * Distinct from ConcurrencyLimit (4008 = the plan is full, buy more or free any
-     * browser): the caller's move here costs nothing. Close it on that machine, or
-     * take it over from the app running there. */
-    readonly ProfileInUse: 4012;
-};
-type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
-/** Error body shape: `{ code, message }` (docs/features/api.md). */
-interface ApiErrorBody {
-    code?: number;
-    message?: string;
-}
-/** Base class for every error this SDK throws, so callers can `catch` one type. */
-declare class ScalebrowserError extends Error {
-    constructor(message: string);
-}
-/**
- * A typed transport/contract error. Carries the HTTP `status` and the daemon's
- * numeric `code` so callers (and the auth layer) can react, e.g. 401 / code
- * 4010 → re-authenticate.
- */
-declare class ApiError extends ScalebrowserError {
-    readonly status: number;
-    readonly code?: number;
-    readonly body?: ApiErrorBody;
-    constructor(status: number, body?: ApiErrorBody, fallbackMessage?: string);
-    /** True for auth failures that must trigger re-authentication. */
-    get isAuthError(): boolean;
-    /** Short label for the error code, if any. */
-    get codeLabel(): string | undefined;
-}
-/** A network-level failure (daemon unreachable, socket error, fetch rejected). */
-declare class NetworkError extends ScalebrowserError {
-    readonly cause?: unknown;
-    constructor(message: string, cause?: unknown);
-}
-/** A CDP command that returned an `error` frame, or a closed CDP connection. */
-declare class CdpError extends ScalebrowserError {
-    readonly code: number;
-    readonly data?: unknown;
-    constructor(code: number, message: string, data?: unknown);
-}
-/** Narrow an unknown thrown value to a user-facing message. */
-declare function errorMessage(err: unknown): string;
-
 interface Screen {
     width: number;
     height: number;
@@ -1747,6 +1676,77 @@ declare class ScalebrowserClient extends ClientCore {
 interface ScalebrowserClient extends IdentityApi, RunsApi, ControlApi, ExtensionsApi {
 }
 
+/**
+ * Error model: stable numeric API error codes (SPEC §5,
+ * `crates/core/src/error.rs`) and the typed exceptions the SDK throws.
+ */
+/** Stable numeric API error codes (4001–4012, append-only: a retired code stays
+ * reserved rather than being reused). */
+declare const ErrorCode: {
+    readonly NotFound: 4001;
+    readonly ProxyGeo: 4002;
+    readonly Capacity: 4003;
+    readonly EngineMissing: 4004;
+    readonly Preflight: 4005;
+    readonly AlreadyRunning: 4006;
+    /** Retired: the removed Methode-D (VM) tier produced this. Reserved (never reused)
+     * to match the server's append-only code contract; never returned now. */
+    readonly VmProvisionFailed: 4007;
+    /** The subscription's abo-wide concurrent-browser allowance is used up (DEC-012).
+     * Distinct from Capacity (4003 = this machine is full, wait): the caller's move
+     * is to stop a running browser anywhere or upgrade the plan. */
+    readonly ConcurrencyLimit: 4008;
+    readonly Unauthorized: 4010;
+    /** No account is connected to this machine, so nothing may run (DEC-014).
+     * Distinct from Unauthorized (4010 = the daemon's own bearer token is wrong, so
+     * re-read the token): 4011 means the machine needs to be signed in, and no token
+     * a client holds can substitute for that. Connect it in the desktop app. */
+    readonly NotSignedIn: 4011;
+    /** This ONE profile is open on another machine of the same account (DEC-015).
+     * Distinct from ConcurrencyLimit (4008 = the plan is full, buy more or free any
+     * browser): the caller's move here costs nothing. Close it on that machine, or
+     * take it over from the app running there. */
+    readonly ProfileInUse: 4012;
+};
+type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+/** Error body shape: `{ code, message }` (docs/features/api.md). */
+interface ApiErrorBody {
+    code?: number;
+    message?: string;
+}
+/** Base class for every error this SDK throws, so callers can `catch` one type. */
+declare class ScalebrowserError extends Error {
+    constructor(message: string);
+}
+/**
+ * A typed transport/contract error. Carries the HTTP `status` and the daemon's
+ * numeric `code` so callers (and the auth layer) can react, e.g. 401 / code
+ * 4010 → re-authenticate.
+ */
+declare class ApiError extends ScalebrowserError {
+    readonly status: number;
+    readonly code?: number;
+    readonly body?: ApiErrorBody;
+    constructor(status: number, body?: ApiErrorBody, fallbackMessage?: string);
+    /** True for auth failures that must trigger re-authentication. */
+    get isAuthError(): boolean;
+    /** Short label for the error code, if any. */
+    get codeLabel(): string | undefined;
+}
+/** A network-level failure (daemon unreachable, socket error, fetch rejected). */
+declare class NetworkError extends ScalebrowserError {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/** A CDP command that returned an `error` frame, or a closed CDP connection. */
+declare class CdpError extends ScalebrowserError {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/** Narrow an unknown thrown value to a user-facing message. */
+declare function errorMessage(err: unknown): string;
+
 /**
  * `@scalebrowser/sdk`: the official Node/TypeScript SDK for the Scalebrowser
  * daemon. A typed REST client plus a direct-CDP driver plane (nodriver-style,
@@ -1764,6 +1764,6 @@ interface ScalebrowserClient extends IdentityApi, RunsApi, ControlApi, Extension
  * ```
  */
 
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.4.1";
 
 export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type ClickOptions, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, HOST_MODES, type HealthStatus, type HostMode, 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 NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type Profile, type ProfileActivity, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, ROTATIONS, RUNTIME_STATES, type ReadyStatus, 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 StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TrustedInputBody, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/dist/index.js

@@ -1321,6 +1321,6 @@ var PROXY_KINDS = ["http", "socks5", "gateway"];
 var ROTATIONS = ["sticky", "rotating"];
 
 // src/index.ts
-var VERSION = "0.3.0";
+var VERSION = "0.4.1";
 
 export { ApiError, CdpError, CdpSession, DEFAULT_CAPACITY, ErrorCode, GEO_MODES, HOST_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.4.0",
+  "version": "0.4.1",
   "description": "Official Node/TypeScript SDK for the Scalebrowser daemon — typed REST client + direct-CDP driver plane (nodriver-style, not Playwright).",
   "type": "module",
   "license": "MIT",