sprntrl 0.1.0

package/dist/resources/api-keys.js

@@ -0,0 +1,28 @@
+import { APIResource } from "../core/resource.js";
+export class APIKeys extends APIResource {
+    async list() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/apikeys",
+        });
+        return r.api_keys ?? [];
+    }
+    /**
+     * Create an API key. The full `key` field is returned ONLY on creation —
+     * store it immediately; the server cannot show it again.
+     */
+    create(name) {
+        return this._client.request({
+            method: "POST",
+            path: "/api/v1/apikeys",
+            body: { name },
+        });
+    }
+    async revoke(keyId) {
+        await this._client.request({
+            method: "DELETE",
+            path: `/api/v1/apikeys/${encodeURIComponent(keyId)}`,
+        });
+    }
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/resources/api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.js","sourceRoot":"","sources":["../../src/resources/api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAyB;YAC3D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAgB;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,KAAK,CAAC,EAAE;SACrD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/ip-whitelist.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../core/resource.js";
+import type { IPWhitelistEntry } from "../types.js";
+export declare class IPWhitelist extends APIResource {
+    list(): Promise<IPWhitelistEntry[]>;
+    /** Pass ip='current' to register the caller's public IP (as Cloudflare sees it). */
+    add(ip?: string, opts?: {
+        label?: string;
+    }): Promise<IPWhitelistEntry>;
+    remove(entryId: string): Promise<void>;
+}

package/dist/resources/ip-whitelist.js

@@ -0,0 +1,28 @@
+import { APIResource } from "../core/resource.js";
+export class IPWhitelist extends APIResource {
+    async list() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/settings/ip-whitelist",
+        });
+        return r.entries ?? [];
+    }
+    /** Pass ip='current' to register the caller's public IP (as Cloudflare sees it). */
+    add(ip = "current", opts = {}) {
+        const body = { ip };
+        if (opts.label !== undefined)
+            body.label = opts.label;
+        return this._client.request({
+            method: "POST",
+            path: "/api/v1/settings/ip-whitelist",
+            body,
+        });
+    }
+    async remove(entryId) {
+        await this._client.request({
+            method: "DELETE",
+            path: `/api/v1/settings/ip-whitelist/${encodeURIComponent(entryId)}`,
+        });
+    }
+}
+//# sourceMappingURL=ip-whitelist.js.map

package/dist/resources/ip-whitelist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-whitelist.js","sourceRoot":"","sources":["../../src/resources/ip-whitelist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAkC;YACpE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,+BAA+B;SACtC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,oFAAoF;IACpF,GAAG,CAAC,KAAa,SAAS,EAAE,OAA2B,EAAE;QACvD,MAAM,IAAI,GAA4B,EAAE,EAAE,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAmB;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,+BAA+B;YACrC,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,iCAAiC,kBAAkB,CAAC,OAAO,CAAC,EAAE;SACrE,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/profiles.d.ts

@@ -0,0 +1,19 @@
+import { APIResource } from "../core/resource.js";
+import type { Profile } from "../types.js";
+export interface ProfileCreateParams {
+    name: string;
+    template_id?: string;
+    config?: unknown;
+    description?: string;
+    os?: string;
+    location?: string;
+    persona?: string;
+}
+export declare class Profiles extends APIResource {
+    create(params: ProfileCreateParams): Promise<Profile>;
+    list(): Promise<Profile[]>;
+    get(profileId: string): Promise<Profile>;
+    update(profileId: string, fields: Partial<ProfileCreateParams>): Promise<Profile>;
+    duplicate(profileId: string): Promise<Profile>;
+    delete(profileId: string): Promise<void>;
+}

package/dist/resources/profiles.js

@@ -0,0 +1,51 @@
+import { APIResource } from "../core/resource.js";
+export class Profiles extends APIResource {
+    create(params) {
+        const { config, ...rest } = params;
+        const body = { ...rest };
+        if (config !== undefined)
+            body.config_json = config;
+        return this._client.request({
+            method: "POST",
+            path: "/api/v1/profiles",
+            body,
+        });
+    }
+    async list() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/profiles",
+        });
+        return r.profiles ?? [];
+    }
+    get(profileId) {
+        return this._client.request({
+            method: "GET",
+            path: `/api/v1/profiles/${encodeURIComponent(profileId)}`,
+        });
+    }
+    update(profileId, fields) {
+        const { config, ...rest } = fields;
+        const body = { ...rest };
+        if (config !== undefined)
+            body.config_json = config;
+        return this._client.request({
+            method: "PUT",
+            path: `/api/v1/profiles/${encodeURIComponent(profileId)}`,
+            body,
+        });
+    }
+    duplicate(profileId) {
+        return this._client.request({
+            method: "POST",
+            path: `/api/v1/profiles/${encodeURIComponent(profileId)}/duplicate`,
+        });
+    }
+    async delete(profileId) {
+        await this._client.request({
+            method: "DELETE",
+            path: `/api/v1/profiles/${encodeURIComponent(profileId)}`,
+        });
+    }
+}
+//# sourceMappingURL=profiles.js.map

package/dist/resources/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/resources/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAalD,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC,MAAM,CAAC,MAA2B;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,MAAM,IAAI,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU;YACnC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAA0B;YAC5D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,EAAE;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,MAAoC;QAC5D,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,MAAM,IAAI,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,EAAE;YACzD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU;YACnC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,YAAY;SACpE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,EAAE;SAC1D,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/session-files.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../core/resource.js";
+import type { FileInfo } from "../types.js";
+export type FileContent = Uint8Array | ArrayBuffer | Blob | string;
+export declare class SessionFiles extends APIResource {
+    list(sessionId: string): Promise<FileInfo[]>;
+    download(sessionId: string, filename: string): Promise<ArrayBuffer>;
+    upload(sessionId: string, filename: string, content: FileContent, opts?: {
+        contentType?: string;
+    }): Promise<void>;
+}

package/dist/resources/session-files.js

@@ -0,0 +1,36 @@
+import { APIResource } from "../core/resource.js";
+export class SessionFiles extends APIResource {
+    async list(sessionId) {
+        const r = await this._client.request({
+            method: "GET",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}/files`,
+        });
+        if (Array.isArray(r))
+            return r;
+        return r.files ?? [];
+    }
+    async download(sessionId, filename) {
+        const response = await this._client.request({
+            method: "GET",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}/files/${encodeURIComponent(filename)}`,
+            stream: true,
+        });
+        return response.arrayBuffer();
+    }
+    async upload(sessionId, filename, content, opts = {}) {
+        const form = new FormData();
+        const blob = content instanceof Blob
+            ? content
+            : new Blob([content], {
+                type: opts.contentType ?? "application/octet-stream",
+            });
+        form.append("file", blob, filename);
+        await this._client.request({
+            method: "POST",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}/files`,
+            body: form,
+            rawBody: true,
+        });
+    }
+}
+//# sourceMappingURL=session-files.js.map

package/dist/resources/session-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-files.js","sourceRoot":"","sources":["../../src/resources/session-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKlD,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAqC;YACvE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,QAAQ;SAChE,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,QAAgB;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAW;YACpD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,QAAQ,CAAC,EAAE;YAC/F,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,QAAgB,EAChB,OAAoB,EACpB,OAAiC,EAAE;QAEnC,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GACR,OAAO,YAAY,IAAI;YACrB,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAmB,CAAC,EAAE;gBAC9B,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,0BAA0B;aACrD,CAAC,CAAC;QACT,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,QAAQ;YAC/D,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/sessions.d.ts

@@ -0,0 +1,72 @@
+import { APIResource } from "../core/resource.js";
+import { SessionFiles } from "./session-files.js";
+import type { OS, PaginatedSessions, ProxyConfig, Session } from "../types.js";
+import type { Sprntrl } from "../client.js";
+export interface SessionCreateParams {
+    os: OS;
+    location: string;
+    persistent?: boolean;
+    captcha_solver?: boolean;
+    session_name?: string;
+    proxy?: string | ProxyConfig;
+}
+export interface ConnectOptions {
+    /** Currently 'playwright' or 'puppeteer'. */
+    framework?: "playwright" | "puppeteer";
+    /** Add the caller's current IP to the account whitelist before connecting. */
+    autoWhitelist?: boolean;
+    /** Wait for session status 'running' before connecting (default true). */
+    wait?: boolean;
+    /** Timeout in ms for wait_until_ready (default 60000). */
+    waitTimeout?: number;
+}
+export declare class Sessions extends APIResource {
+    files: SessionFiles;
+    constructor(client: Sprntrl);
+    create(params: SessionCreateParams): Promise<Session>;
+    list(): Promise<Session[]>;
+    listActive(): Promise<Session[]>;
+    listHistory(params?: {
+        page?: number;
+        perPage?: number;
+    }): Promise<PaginatedSessions>;
+    listResumable(params?: {
+        limit?: number;
+    }): Promise<Session[]>;
+    /** Persistent sessions (those created with `persistent: true`), whether
+     * currently running or stopped-but-resumable. */
+    listPersistent(): Promise<Session[]>;
+    listLocations(): Promise<string[]>;
+    get(sessionId: string): Promise<Session>;
+    stop(sessionId: string): Promise<void>;
+    resume(sessionId: string): Promise<Session>;
+    deletePersistent(sessionId: string): Promise<void>;
+    waitUntilReady(sessionId: string, opts?: {
+        timeout?: number;
+        pollInterval?: number;
+    }): Promise<Session>;
+    connect(sessionId: string, opts?: ConnectOptions): Promise<unknown>;
+    /**
+     * Build the CDP WebSocket URL for a session. Useful for handing off to any
+     * CDP client (chrome-remote-interface, raw ws, etc.) — Playwright and
+     * Puppeteer users should use `connect()` or `browserSession()` instead.
+     */
+    cdpUrl(sessionId: string): string;
+    /**
+     * Connect a browser, hand back a disposable handle. Exit cleanup closes the
+     * browser (does not stop the session — caller owns that).
+     *
+     *   await using handle = await client.sessions.browserSession(id, { autoWhitelist: true });
+     *   const page = await handle.browser.newPage();
+     *
+     * Without `await using` (Node <20.11 or TS <5.2):
+     *   const handle = await client.sessions.browserSession(id);
+     *   try { ... } finally { await handle.close(); }
+     */
+    browserSession(sessionId: string, opts?: ConnectOptions): Promise<BrowserHandle>;
+}
+export interface BrowserHandle {
+    readonly browser: unknown;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}

package/dist/resources/sessions.js

@@ -0,0 +1,195 @@
+import { APIResource } from "../core/resource.js";
+import { SprntrlError } from "../core/error.js";
+import { SessionFiles } from "./session-files.js";
+function normalizeProxy(proxy) {
+    if (!proxy)
+        return {};
+    if (typeof proxy === "string") {
+        const url = new URL(proxy);
+        const out = {
+            proxy_protocol: url.protocol.replace(":", "").toUpperCase(),
+            proxy_host: url.hostname,
+        };
+        if (url.port)
+            out.proxy_port = Number(url.port);
+        if (url.username)
+            out.proxy_username = decodeURIComponent(url.username);
+        if (url.password)
+            out.proxy_password = decodeURIComponent(url.password);
+        return out;
+    }
+    const out = {};
+    if (proxy.protocol)
+        out.proxy_protocol = proxy.protocol.toUpperCase();
+    if (proxy.host)
+        out.proxy_host = proxy.host;
+    if (proxy.port !== undefined)
+        out.proxy_port = proxy.port;
+    if (proxy.username !== undefined)
+        out.proxy_username = proxy.username;
+    if (proxy.password !== undefined)
+        out.proxy_password = proxy.password;
+    return out;
+}
+export class Sessions extends APIResource {
+    files;
+    constructor(client) {
+        super(client);
+        this.files = new SessionFiles(client);
+    }
+    create(params) {
+        const { os, location, persistent = false, captcha_solver, session_name, proxy } = params;
+        const body = { os, location, persistent };
+        if (captcha_solver)
+            body.captcha_solver = true;
+        if (session_name !== undefined)
+            body.session_name = session_name;
+        Object.assign(body, normalizeProxy(proxy));
+        return this._client.request({
+            method: "POST",
+            path: "/api/v1/sessions",
+            body,
+        });
+    }
+    async list() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/sessions",
+        });
+        return r.sessions ?? [];
+    }
+    async listActive() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/sessions/active",
+        });
+        return r.sessions ?? [];
+    }
+    listHistory(params = {}) {
+        return this._client.request({
+            method: "GET",
+            path: "/api/v1/sessions/history",
+            query: { page: params.page ?? 1, per_page: params.perPage ?? 25 },
+        });
+    }
+    async listResumable(params = {}) {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/sessions/resumable",
+            query: { limit: params.limit ?? 10 },
+        });
+        return r.sessions ?? [];
+    }
+    /** Persistent sessions (those created with `persistent: true`), whether
+     * currently running or stopped-but-resumable. */
+    async listPersistent() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/sessions/persistent",
+        });
+        return r.sessions ?? [];
+    }
+    async listLocations() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/sessions/locations",
+        });
+        return r.locations ?? [];
+    }
+    get(sessionId) {
+        return this._client.request({
+            method: "GET",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}`,
+        });
+    }
+    async stop(sessionId) {
+        await this._client.request({
+            method: "DELETE",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}`,
+        });
+    }
+    resume(sessionId) {
+        return this._client.request({
+            method: "POST",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}/resume`,
+        });
+    }
+    async deletePersistent(sessionId) {
+        await this._client.request({
+            method: "DELETE",
+            path: `/api/v1/sessions/${encodeURIComponent(sessionId)}/persist`,
+        });
+    }
+    async waitUntilReady(sessionId, opts = {}) {
+        const timeout = opts.timeout ?? 60_000;
+        const pollInterval = opts.pollInterval ?? 500;
+        const deadline = Date.now() + timeout;
+        while (true) {
+            const session = await this.get(sessionId);
+            if (session.status === "running")
+                return session;
+            if (session.status === "failed" ||
+                session.status === "stopped" ||
+                session.status === "stopping") {
+                throw new SprntrlError(`Session ${sessionId} entered status '${session.status}' while waiting`);
+            }
+            if (Date.now() >= deadline) {
+                throw new SprntrlError(`Session ${sessionId} not ready after ${timeout}ms (status='${session.status}')`);
+            }
+            await new Promise((r) => setTimeout(r, pollInterval));
+        }
+    }
+    async connect(sessionId, opts = {}) {
+        const { connect } = await import("../lib/browser.js");
+        const session = opts.wait !== false
+            ? await this.waitUntilReady(sessionId, { timeout: opts.waitTimeout })
+            : await this.get(sessionId);
+        return connect(this._client, session, {
+            framework: opts.framework ?? "playwright",
+            autoWhitelist: opts.autoWhitelist ?? false,
+        });
+    }
+    /**
+     * Build the CDP WebSocket URL for a session. Useful for handing off to any
+     * CDP client (chrome-remote-interface, raw ws, etc.) — Playwright and
+     * Puppeteer users should use `connect()` or `browserSession()` instead.
+     */
+    cdpUrl(sessionId) {
+        const base = new URL(this._client.baseURL);
+        const scheme = base.protocol === "https:" ? "wss:" : "ws:";
+        return `${scheme}//${base.host}/api/v1/sessions/${encodeURIComponent(sessionId)}/cdp`;
+    }
+    /**
+     * Connect a browser, hand back a disposable handle. Exit cleanup closes the
+     * browser (does not stop the session — caller owns that).
+     *
+     *   await using handle = await client.sessions.browserSession(id, { autoWhitelist: true });
+     *   const page = await handle.browser.newPage();
+     *
+     * Without `await using` (Node <20.11 or TS <5.2):
+     *   const handle = await client.sessions.browserSession(id);
+     *   try { ... } finally { await handle.close(); }
+     */
+    async browserSession(sessionId, opts = {}) {
+        const browser = (await this.connect(sessionId, opts));
+        let closed = false;
+        const close = async () => {
+            if (closed)
+                return;
+            closed = true;
+            try {
+                await browser.close();
+            }
+            catch {
+                // best-effort
+            }
+        };
+        const handle = {
+            browser,
+            close,
+            [Symbol.asyncDispose]: close,
+        };
+        return handle;
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/resources/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}

package/dist/resources/templates.d.ts

@@ -0,0 +1,5 @@
+import { APIResource } from "../core/resource.js";
+import type { Template } from "../types.js";
+export declare class Templates extends APIResource {
+    list(): Promise<Template[]>;
+}

package/dist/resources/templates.js

@@ -0,0 +1,11 @@
+import { APIResource } from "../core/resource.js";
+export class Templates extends APIResource {
+    async list() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/templates",
+        });
+        return r.templates ?? [];
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/resources/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/resources/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAA4B;YAC9D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,mBAAmB;SAC1B,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/resources/usage.d.ts

@@ -0,0 +1,6 @@
+import { APIResource } from "../core/resource.js";
+import type { Usage as UsageModel, UsageMonth } from "../types.js";
+export declare class Usage extends APIResource {
+    current(): Promise<UsageModel>;
+    history(): Promise<UsageMonth[]>;
+}

package/dist/resources/usage.js

@@ -0,0 +1,17 @@
+import { APIResource } from "../core/resource.js";
+export class Usage extends APIResource {
+    current() {
+        return this._client.request({
+            method: "GET",
+            path: "/api/v1/usage",
+        });
+    }
+    async history() {
+        const r = await this._client.request({
+            method: "GET",
+            path: "/api/v1/usage/history",
+        });
+        return r.months ?? [];
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/resources/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAa;YACtC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAA2B;YAC7D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,uBAAuB;SAC9B,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/resources/user.d.ts

@@ -0,0 +1,26 @@
+import { APIResource } from "../core/resource.js";
+import type { User as UserModel } from "../types.js";
+export interface UserSettings {
+    /** Allow accruing hours-overage charges past the plan allowance. */
+    allow_hours_overage?: boolean;
+    /** Restrict the account to BYO proxies only (no pool proxy). */
+    byo_proxy_only?: boolean;
+}
+export interface ChangePasswordResult {
+    message: string;
+    /** Fresh tokens — issued so a programmatic client can swap credentials
+     * without a re-login. Absent for cookie/session-only flows. */
+    access_token?: string;
+    refresh_token?: string;
+    token_type?: string;
+}
+export declare class User extends APIResource {
+    me(): Promise<UserModel>;
+    update(fields: {
+        name?: string;
+    }): Promise<UserModel>;
+    /** Read the account settings (same shape as `me()`). */
+    getSettings(): Promise<UserModel>;
+    updateSettings(fields: UserSettings): Promise<UserModel>;
+    changePassword(currentPassword: string, newPassword: string): Promise<ChangePasswordResult>;
+}

package/dist/resources/user.js

@@ -0,0 +1,38 @@
+import { APIResource } from "../core/resource.js";
+export class User extends APIResource {
+    me() {
+        return this._client.request({
+            method: "GET",
+            path: "/api/v1/user/me",
+        });
+    }
+    update(fields) {
+        return this._client.request({
+            method: "PUT",
+            path: "/api/v1/user/me",
+            body: fields,
+        });
+    }
+    /** Read the account settings (same shape as `me()`). */
+    getSettings() {
+        return this._client.request({
+            method: "GET",
+            path: "/api/v1/user/me/settings",
+        });
+    }
+    updateSettings(fields) {
+        return this._client.request({
+            method: "PUT",
+            path: "/api/v1/user/me/settings",
+            body: fields,
+        });
+    }
+    changePassword(currentPassword, newPassword) {
+        return this._client.request({
+            method: "PUT",
+            path: "/api/v1/user/change-password",
+            body: { current_password: currentPassword, new_password: newPassword },
+        });
+    }
+}
+//# sourceMappingURL=user.js.map

package/dist/resources/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/resources/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAmBlD,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC,EAAE;QACA,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAY;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,MAAyB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAY;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAY;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,0BAA0B;SACjC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,MAAoB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAY;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CACZ,eAAuB,EACvB,WAAmB;QAEnB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAuB;YAChD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;CACF"}