@computesdk/browserless 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @computesdk/browserless
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Browserless browser provider for ComputeSDK. Cloud browser sessions via [Browserless](https://www.browserless.io).
+
+```bash
+npm install @computesdk/browserless
+```
+
+```ts
+import { browserless } from '@computesdk/browserless';
+import { chromium } from 'playwright-core';
+
+const bl = browserless({ apiKey: process.env.BROWSERLESS_API_KEY });
+
+const session = await bl.session.create();
+const browser = await chromium.connectOverCDP(session.connectUrl);
+const page = browser.contexts()[0].pages()[0];
+await page.goto('https://example.com');
+
+await bl.session.destroy(session.sessionId);
+```
+
+## Config
+
+| option | env | default |
+|---|---|---|
+| `apiKey` | `BROWSERLESS_API_KEY` | — (required) |
+| `baseUrl` | `BROWSERLESS_URL` | `https://production-sfo.browserless.io` |
+
+Shared fleet regions: `production-sfo`, `production-lon`, `production-ams`.
+Private fleet: `chrome.browserless.io` or `chrome-<region>.browserless.io` — a
+private-fleet token against a shared-fleet host returns 401.
+
+## Session model
+
+Browserless has no create-session REST call on the shared fleet: a session
+materializes when the client opens the CDP websocket. `create()` mints a
+`trackingId` and returns its connect URL (`/chromium?token=…&trackingId=…`);
+the session ends on disconnect or via `destroy()` (`/kill/<trackingId>`).
+
+`list()`/`getById()` use `GET /sessions`, which is private/enterprise-fleet
+only — on the shared fleet those calls surface the HTTP error.
+
+SECURITY: `connectUrl` embeds the API token as a query param — treat it as a
+secret (don't log or persist).

package/dist/index.cjs

@@ -0,0 +1,157 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  browserless: () => browserless
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_crypto = require("crypto");
+var import_provider = require("@computesdk/provider");
+function resolveConfig(config) {
+  const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.BROWSERLESS_API_KEY || "";
+  if (!apiKey) {
+    throw new Error(
+      `Missing Browserless API key. Provide 'apiKey' in config or set BROWSERLESS_API_KEY environment variable. Get your API key from https://account.browserless.io`
+    );
+  }
+  const baseUrl = (config.baseUrl || typeof process !== "undefined" && process.env?.BROWSERLESS_URL || "https://production-sfo.browserless.io").replace(/\/+$/, "");
+  return { apiKey, baseUrl };
+}
+function wsBase(baseUrl) {
+  return baseUrl.replace(/^https/, "wss").replace(/^http/, "ws");
+}
+function enc(value) {
+  return encodeURIComponent(value);
+}
+var warnedUnsupported = /* @__PURE__ */ new Set();
+function warnOnce(field, reason) {
+  if (warnedUnsupported.has(field)) return;
+  warnedUnsupported.add(field);
+  console.warn(`[@computesdk/browserless] '${field}' is ignored: ${reason}`);
+}
+var sessionOptions = /* @__PURE__ */ new Map();
+function redact(body, apiKey) {
+  return body.split(apiKey).join("***");
+}
+function buildConnectUrl(baseUrl, apiKey, trackingId, options) {
+  const url = new URL(`${wsBase(baseUrl)}/chromium`);
+  url.searchParams.set("token", apiKey);
+  url.searchParams.set("trackingId", trackingId);
+  if (!options) return url.toString();
+  if (options.stealth) url.searchParams.set("stealth", "true");
+  if (options.viewport) {
+    url.searchParams.set("launch", JSON.stringify({
+      defaultViewport: { width: options.viewport.width, height: options.viewport.height }
+    }));
+  }
+  if (options.proxies === true) url.searchParams.set("proxy", "residential");
+  if (options.keepAlive === true) {
+    warnOnce("keepAlive", "Browserless sessions live until disconnect or /kill; no keep-alive flag.");
+  }
+  if (options.recording === false) {
+    warnOnce("recording", "Session recording is managed server-side; no per-session toggle on the connect URL.");
+  }
+  if (options.logging === false) {
+    warnOnce("logging", "Session logging is managed server-side; no per-session toggle on the connect URL.");
+  }
+  if (options.timeout !== void 0) {
+    warnOnce("timeout", "Session TTL is a fleet-level setting on Browserless; no per-session timeout param.");
+  }
+  if (options.profileId !== void 0) {
+    warnOnce("profileId", "Browserless has no persistent-profile concept on the connect URL.");
+  }
+  if (options.extensionIds && options.extensionIds.length > 0) {
+    warnOnce("extensionIds", "Extensions must be baked into the Browserless fleet image; no per-session IDs.");
+  }
+  if (options.region !== void 0) {
+    warnOnce("region", "Region is selected by the baseUrl host (e.g. production-sfo|lon|ams), not a connect param.");
+  }
+  if (options.saveDownloads === true) {
+    warnOnce("saveDownloads", "Browserless has no server-side download retrieval API.");
+  }
+  if (options.userMetadata && Object.keys(options.userMetadata).length > 0) {
+    warnOnce("userMetadata", "Browserless does not support arbitrary user metadata on sessions.");
+  }
+  if (Array.isArray(options.proxies) && options.proxies.length > 0) {
+    warnOnce("proxies", "Custom proxy servers are a Browserless enterprise feature; only proxies=true maps (residential).");
+  }
+  return url.toString();
+}
+async function listSessions(baseUrl, apiKey) {
+  const r = await fetch(`${baseUrl}/sessions?token=${enc(apiKey)}`);
+  if (!r.ok) throw new Error(`browserless /sessions ${r.status}: ${redact(await r.text(), apiKey)}`);
+  return await r.json();
+}
+function toEntry(s) {
+  return {
+    session: s,
+    sessionId: s.trackingId ?? s.browserId,
+    status: s.running ? "running" : "created"
+  };
+}
+var browserless = (0, import_provider.defineBrowserProvider)({
+  name: "browserless",
+  methods: {
+    session: {
+      create: async (config, options) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        const trackingId = (0, import_node_crypto.randomUUID)();
+        if (options) sessionOptions.set(trackingId, options);
+        return {
+          session: { browserId: trackingId, trackingId, running: false, startedOn: Date.now() },
+          sessionId: trackingId,
+          connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, options),
+          status: "created"
+        };
+      },
+      getById: async (config, sessionId) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        const found = (await listSessions(baseUrl, apiKey)).find(
+          (s) => s.trackingId === sessionId || s.browserId === sessionId
+        );
+        if (!found) return null;
+        const trackingId = found.trackingId ?? sessionId;
+        return { ...toEntry(found), connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, sessionOptions.get(trackingId)) };
+      },
+      list: async (config) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        return (await listSessions(baseUrl, apiKey)).map(toEntry);
+      },
+      destroy: async (config, sessionId) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        const r = await fetch(`${baseUrl}/kill/${enc(sessionId)}?token=${enc(apiKey)}`);
+        sessionOptions.delete(sessionId);
+        if (!r.ok && r.status !== 404) {
+          throw new Error(`browserless destroy ${r.status}: ${redact(await r.text(), apiKey)}`);
+        }
+      },
+      getConnectUrl: async (config, sessionId) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        return buildConnectUrl(baseUrl, apiKey, sessionId, sessionOptions.get(sessionId));
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  browserless
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Browserless Browser Provider - Factory-based Implementation\n *\n * Cloud browser sessions via Browserless (https://browserless.io). Browserless\n * has no create-session REST call on the shared fleet: a session materializes\n * when the client opens the CDP websocket. `session.create()` therefore mints\n * a `trackingId` and returns the connect URL for it; the session starts when\n * `chromium.connectOverCDP(connectUrl)` opens, and ends on disconnect or via\n * `session.destroy()` (`/kill/<trackingId>`).\n */\n\nimport { randomUUID } from 'node:crypto';\nimport { defineBrowserProvider } from '@computesdk/provider';\n\nimport type { CreateBrowserSessionOptions } from '@computesdk/provider';\n\n/**\n * Shape of a running session as returned by `GET /sessions`.\n * `/sessions` is available on private/enterprise fleets; on the shared fleet\n * it may return 401 — list/getById surface that error rather than masking it.\n */\nexport interface BrowserlessSession {\n  browserId: string;\n  trackingId: string | null;\n  running: boolean;\n  startedOn: number;\n  timeAliveMs?: number;\n  browser?: string;\n  type?: string;\n}\n\n/**\n * Browserless-specific configuration options.\n */\nexport interface BrowserlessConfig {\n  /** Browserless API token — falls back to BROWSERLESS_API_KEY env var */\n  apiKey?: string;\n  /**\n   * Fleet base URL — falls back to BROWSERLESS_URL env var, then the shared\n   * US West fleet. Shared fleet: production-sfo|lon|ams.browserless.io.\n   * Private fleet: chrome.browserless.io or chrome-<region>.browserless.io\n   * (a private-fleet token against a shared-fleet host returns 401).\n   */\n  baseUrl?: string;\n}\n\nfunction resolveConfig(config: BrowserlessConfig) {\n  const apiKey =\n    config.apiKey || (typeof process !== 'undefined' && process.env?.BROWSERLESS_API_KEY) || '';\n  if (!apiKey) {\n    throw new Error(\n      `Missing Browserless API key. Provide 'apiKey' in config or set BROWSERLESS_API_KEY environment variable. ` +\n        `Get your API key from https://account.browserless.io`,\n    );\n  }\n  const baseUrl = (\n    config.baseUrl ||\n    (typeof process !== 'undefined' && process.env?.BROWSERLESS_URL) ||\n    'https://production-sfo.browserless.io'\n  ).replace(/\\/+$/, '');\n  return { apiKey, baseUrl };\n}\n\n/** http(s) base URL → ws(s) equivalent for the websocket endpoint. */\nfunction wsBase(baseUrl: string): string {\n  return baseUrl.replace(/^https/, 'wss').replace(/^http/, 'ws');\n}\n\nfunction enc(value: string): string {\n  return encodeURIComponent(value);\n}\n\nconst warnedUnsupported = new Set<string>();\nfunction warnOnce(field: string, reason: string) {\n  if (warnedUnsupported.has(field)) return;\n  warnedUnsupported.add(field);\n  console.warn(`[@computesdk/browserless] '${field}' is ignored: ${reason}`);\n}\n\n/**\n * Create options by sessionId, so getConnectUrl/getById can rebuild the same\n * URL the session was created with. Same-process only — a URL rebuilt in a\n * fresh process carries no launch options. Entries are dropped on destroy.\n */\nconst sessionOptions = new Map<string, CreateBrowserSessionOptions>();\n\n/** Strip the API token from provider error bodies before throwing. */\nfunction redact(body: string, apiKey: string): string {\n  return body.split(apiKey).join('***');\n}\n\n/**\n * Build the CDP connect URL for a session. The token authenticates the\n * websocket; `trackingId` is the session handle used by list/destroy.\n * `launch` query params are only meaningful if they land before the client\n * connects — they live on the connect URL by Browserless design.\n *\n * SECURITY: the returned URL embeds the account API token as a query\n * parameter. Treat it as a secret — do not log or persist it.\n */\nfunction buildConnectUrl(baseUrl: string, apiKey: string, trackingId: string, options?: CreateBrowserSessionOptions): string {\n  const url = new URL(`${wsBase(baseUrl)}/chromium`);\n  url.searchParams.set('token', apiKey);\n  url.searchParams.set('trackingId', trackingId);\n  if (!options) return url.toString();\n\n  if (options.stealth) url.searchParams.set('stealth', 'true');\n  if (options.viewport) {\n    url.searchParams.set('launch', JSON.stringify({\n      defaultViewport: { width: options.viewport.width, height: options.viewport.height },\n    }));\n  }\n  if (options.proxies === true) url.searchParams.set('proxy', 'residential');\n\n  if (options.keepAlive === true) {\n    warnOnce('keepAlive', 'Browserless sessions live until disconnect or /kill; no keep-alive flag.');\n  }\n  if (options.recording === false) {\n    warnOnce('recording', 'Session recording is managed server-side; no per-session toggle on the connect URL.');\n  }\n  if (options.logging === false) {\n    warnOnce('logging', 'Session logging is managed server-side; no per-session toggle on the connect URL.');\n  }\n  if (options.timeout !== undefined) {\n    warnOnce('timeout', 'Session TTL is a fleet-level setting on Browserless; no per-session timeout param.');\n  }\n  if (options.profileId !== undefined) {\n    warnOnce('profileId', 'Browserless has no persistent-profile concept on the connect URL.');\n  }\n  if (options.extensionIds && options.extensionIds.length > 0) {\n    warnOnce('extensionIds', 'Extensions must be baked into the Browserless fleet image; no per-session IDs.');\n  }\n  if (options.region !== undefined) {\n    warnOnce('region', 'Region is selected by the baseUrl host (e.g. production-sfo|lon|ams), not a connect param.');\n  }\n  if (options.saveDownloads === true) {\n    warnOnce('saveDownloads', 'Browserless has no server-side download retrieval API.');\n  }\n  if (options.userMetadata && Object.keys(options.userMetadata).length > 0) {\n    warnOnce('userMetadata', 'Browserless does not support arbitrary user metadata on sessions.');\n  }\n  if (Array.isArray(options.proxies) && options.proxies.length > 0) {\n    warnOnce('proxies', 'Custom proxy servers are a Browserless enterprise feature; only proxies=true maps (residential).');\n  }\n\n  return url.toString();\n}\n\nasync function listSessions(baseUrl: string, apiKey: string): Promise<BrowserlessSession[]> {\n  const r = await fetch(`${baseUrl}/sessions?token=${enc(apiKey)}`);\n  if (!r.ok) throw new Error(`browserless /sessions ${r.status}: ${redact(await r.text(), apiKey)}`);\n  return (await r.json()) as BrowserlessSession[];\n}\n\nfunction toEntry(s: BrowserlessSession) {\n  return {\n    session: s,\n    sessionId: s.trackingId ?? s.browserId,\n    status: (s.running ? 'running' : 'created') as 'running' | 'created',\n  };\n}\n\n/**\n * Create a Browserless browser provider instance.\n *\n * @example\n * ```ts\n * import { browserless } from '@computesdk/browserless';\n * import { chromium } from 'playwright-core';\n *\n * const bl = browserless({ apiKey: process.env.BROWSERLESS_API_KEY });\n *\n * // Mints a trackingId; the session starts when the socket opens.\n * const session = await bl.session.create();\n *\n * const browser = await chromium.connectOverCDP(session.connectUrl);\n * const page = browser.contexts()[0].pages()[0];\n * await page.goto('https://example.com');\n *\n * await session.destroy(); // or just browser.close() — disconnect ends it\n * ```\n */\nexport const browserless = defineBrowserProvider<BrowserlessSession, BrowserlessConfig>({\n  name: 'browserless',\n  methods: {\n    session: {\n      create: async (config: BrowserlessConfig, options?: CreateBrowserSessionOptions) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        // No REST create call — the trackingId becomes the session identity\n        // and the browser allocates when the client connects to the URL.\n        const trackingId = randomUUID();\n        if (options) sessionOptions.set(trackingId, options);\n        // Nothing exists server-side yet — running stays false until the\n        // client opens the websocket and Browserless allocates the browser.\n        return {\n          session: { browserId: trackingId, trackingId, running: false, startedOn: Date.now() },\n          sessionId: trackingId,\n          connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, options),\n          status: 'created',\n        };\n      },\n\n      getById: async (config: BrowserlessConfig, sessionId: string) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        const found = (await listSessions(baseUrl, apiKey)).find(\n          (s) => s.trackingId === sessionId || s.browserId === sessionId,\n        );\n        if (!found) return null;\n        const trackingId = found.trackingId ?? sessionId;\n        return { ...toEntry(found), connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, sessionOptions.get(trackingId)) };\n      },\n\n      list: async (config: BrowserlessConfig) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        return (await listSessions(baseUrl, apiKey)).map(toEntry);\n      },\n\n      destroy: async (config: BrowserlessConfig, sessionId: string) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        // /kill accepts a browserId or trackingId; a missing session is a no-op.\n        const r = await fetch(`${baseUrl}/kill/${enc(sessionId)}?token=${enc(apiKey)}`);\n        sessionOptions.delete(sessionId);\n        if (!r.ok && r.status !== 404) {\n          throw new Error(`browserless destroy ${r.status}: ${redact(await r.text(), apiKey)}`);\n        }\n      },\n\n      getConnectUrl: async (config: BrowserlessConfig, sessionId: string) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        return buildConnectUrl(baseUrl, apiKey, sessionId, sessionOptions.get(sessionId));\n      },\n    },\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import * as _computesdk_provider from '@computesdk/provider';
+
+/**
+ * Browserless Browser Provider - Factory-based Implementation
+ *
+ * Cloud browser sessions via Browserless (https://browserless.io). Browserless
+ * has no create-session REST call on the shared fleet: a session materializes
+ * when the client opens the CDP websocket. `session.create()` therefore mints
+ * a `trackingId` and returns the connect URL for it; the session starts when
+ * `chromium.connectOverCDP(connectUrl)` opens, and ends on disconnect or via
+ * `session.destroy()` (`/kill/<trackingId>`).
+ */
+/**
+ * Shape of a running session as returned by `GET /sessions`.
+ * `/sessions` is available on private/enterprise fleets; on the shared fleet
+ * it may return 401 — list/getById surface that error rather than masking it.
+ */
+interface BrowserlessSession {
+    browserId: string;
+    trackingId: string | null;
+    running: boolean;
+    startedOn: number;
+    timeAliveMs?: number;
+    browser?: string;
+    type?: string;
+}
+/**
+ * Browserless-specific configuration options.
+ */
+interface BrowserlessConfig {
+    /** Browserless API token — falls back to BROWSERLESS_API_KEY env var */
+    apiKey?: string;
+    /**
+     * Fleet base URL — falls back to BROWSERLESS_URL env var, then the shared
+     * US West fleet. Shared fleet: production-sfo|lon|ams.browserless.io.
+     * Private fleet: chrome.browserless.io or chrome-<region>.browserless.io
+     * (a private-fleet token against a shared-fleet host returns 401).
+     */
+    baseUrl?: string;
+}
+/**
+ * Create a Browserless browser provider instance.
+ *
+ * @example
+ * ```ts
+ * import { browserless } from '@computesdk/browserless';
+ * import { chromium } from 'playwright-core';
+ *
+ * const bl = browserless({ apiKey: process.env.BROWSERLESS_API_KEY });
+ *
+ * // Mints a trackingId; the session starts when the socket opens.
+ * const session = await bl.session.create();
+ *
+ * const browser = await chromium.connectOverCDP(session.connectUrl);
+ * const page = browser.contexts()[0].pages()[0];
+ * await page.goto('https://example.com');
+ *
+ * await session.destroy(); // or just browser.close() — disconnect ends it
+ * ```
+ */
+declare const browserless: (config: BrowserlessConfig) => _computesdk_provider.BrowserProvider<BrowserlessSession>;
+
+export { type BrowserlessConfig, type BrowserlessSession, browserless };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import * as _computesdk_provider from '@computesdk/provider';
+
+/**
+ * Browserless Browser Provider - Factory-based Implementation
+ *
+ * Cloud browser sessions via Browserless (https://browserless.io). Browserless
+ * has no create-session REST call on the shared fleet: a session materializes
+ * when the client opens the CDP websocket. `session.create()` therefore mints
+ * a `trackingId` and returns the connect URL for it; the session starts when
+ * `chromium.connectOverCDP(connectUrl)` opens, and ends on disconnect or via
+ * `session.destroy()` (`/kill/<trackingId>`).
+ */
+/**
+ * Shape of a running session as returned by `GET /sessions`.
+ * `/sessions` is available on private/enterprise fleets; on the shared fleet
+ * it may return 401 — list/getById surface that error rather than masking it.
+ */
+interface BrowserlessSession {
+    browserId: string;
+    trackingId: string | null;
+    running: boolean;
+    startedOn: number;
+    timeAliveMs?: number;
+    browser?: string;
+    type?: string;
+}
+/**
+ * Browserless-specific configuration options.
+ */
+interface BrowserlessConfig {
+    /** Browserless API token — falls back to BROWSERLESS_API_KEY env var */
+    apiKey?: string;
+    /**
+     * Fleet base URL — falls back to BROWSERLESS_URL env var, then the shared
+     * US West fleet. Shared fleet: production-sfo|lon|ams.browserless.io.
+     * Private fleet: chrome.browserless.io or chrome-<region>.browserless.io
+     * (a private-fleet token against a shared-fleet host returns 401).
+     */
+    baseUrl?: string;
+}
+/**
+ * Create a Browserless browser provider instance.
+ *
+ * @example
+ * ```ts
+ * import { browserless } from '@computesdk/browserless';
+ * import { chromium } from 'playwright-core';
+ *
+ * const bl = browserless({ apiKey: process.env.BROWSERLESS_API_KEY });
+ *
+ * // Mints a trackingId; the session starts when the socket opens.
+ * const session = await bl.session.create();
+ *
+ * const browser = await chromium.connectOverCDP(session.connectUrl);
+ * const page = browser.contexts()[0].pages()[0];
+ * await page.goto('https://example.com');
+ *
+ * await session.destroy(); // or just browser.close() — disconnect ends it
+ * ```
+ */
+declare const browserless: (config: BrowserlessConfig) => _computesdk_provider.BrowserProvider<BrowserlessSession>;
+
+export { type BrowserlessConfig, type BrowserlessSession, browserless };

package/dist/index.js

@@ -0,0 +1,132 @@
+// src/index.ts
+import { randomUUID } from "crypto";
+import { defineBrowserProvider } from "@computesdk/provider";
+function resolveConfig(config) {
+  const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.BROWSERLESS_API_KEY || "";
+  if (!apiKey) {
+    throw new Error(
+      `Missing Browserless API key. Provide 'apiKey' in config or set BROWSERLESS_API_KEY environment variable. Get your API key from https://account.browserless.io`
+    );
+  }
+  const baseUrl = (config.baseUrl || typeof process !== "undefined" && process.env?.BROWSERLESS_URL || "https://production-sfo.browserless.io").replace(/\/+$/, "");
+  return { apiKey, baseUrl };
+}
+function wsBase(baseUrl) {
+  return baseUrl.replace(/^https/, "wss").replace(/^http/, "ws");
+}
+function enc(value) {
+  return encodeURIComponent(value);
+}
+var warnedUnsupported = /* @__PURE__ */ new Set();
+function warnOnce(field, reason) {
+  if (warnedUnsupported.has(field)) return;
+  warnedUnsupported.add(field);
+  console.warn(`[@computesdk/browserless] '${field}' is ignored: ${reason}`);
+}
+var sessionOptions = /* @__PURE__ */ new Map();
+function redact(body, apiKey) {
+  return body.split(apiKey).join("***");
+}
+function buildConnectUrl(baseUrl, apiKey, trackingId, options) {
+  const url = new URL(`${wsBase(baseUrl)}/chromium`);
+  url.searchParams.set("token", apiKey);
+  url.searchParams.set("trackingId", trackingId);
+  if (!options) return url.toString();
+  if (options.stealth) url.searchParams.set("stealth", "true");
+  if (options.viewport) {
+    url.searchParams.set("launch", JSON.stringify({
+      defaultViewport: { width: options.viewport.width, height: options.viewport.height }
+    }));
+  }
+  if (options.proxies === true) url.searchParams.set("proxy", "residential");
+  if (options.keepAlive === true) {
+    warnOnce("keepAlive", "Browserless sessions live until disconnect or /kill; no keep-alive flag.");
+  }
+  if (options.recording === false) {
+    warnOnce("recording", "Session recording is managed server-side; no per-session toggle on the connect URL.");
+  }
+  if (options.logging === false) {
+    warnOnce("logging", "Session logging is managed server-side; no per-session toggle on the connect URL.");
+  }
+  if (options.timeout !== void 0) {
+    warnOnce("timeout", "Session TTL is a fleet-level setting on Browserless; no per-session timeout param.");
+  }
+  if (options.profileId !== void 0) {
+    warnOnce("profileId", "Browserless has no persistent-profile concept on the connect URL.");
+  }
+  if (options.extensionIds && options.extensionIds.length > 0) {
+    warnOnce("extensionIds", "Extensions must be baked into the Browserless fleet image; no per-session IDs.");
+  }
+  if (options.region !== void 0) {
+    warnOnce("region", "Region is selected by the baseUrl host (e.g. production-sfo|lon|ams), not a connect param.");
+  }
+  if (options.saveDownloads === true) {
+    warnOnce("saveDownloads", "Browserless has no server-side download retrieval API.");
+  }
+  if (options.userMetadata && Object.keys(options.userMetadata).length > 0) {
+    warnOnce("userMetadata", "Browserless does not support arbitrary user metadata on sessions.");
+  }
+  if (Array.isArray(options.proxies) && options.proxies.length > 0) {
+    warnOnce("proxies", "Custom proxy servers are a Browserless enterprise feature; only proxies=true maps (residential).");
+  }
+  return url.toString();
+}
+async function listSessions(baseUrl, apiKey) {
+  const r = await fetch(`${baseUrl}/sessions?token=${enc(apiKey)}`);
+  if (!r.ok) throw new Error(`browserless /sessions ${r.status}: ${redact(await r.text(), apiKey)}`);
+  return await r.json();
+}
+function toEntry(s) {
+  return {
+    session: s,
+    sessionId: s.trackingId ?? s.browserId,
+    status: s.running ? "running" : "created"
+  };
+}
+var browserless = defineBrowserProvider({
+  name: "browserless",
+  methods: {
+    session: {
+      create: async (config, options) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        const trackingId = randomUUID();
+        if (options) sessionOptions.set(trackingId, options);
+        return {
+          session: { browserId: trackingId, trackingId, running: false, startedOn: Date.now() },
+          sessionId: trackingId,
+          connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, options),
+          status: "created"
+        };
+      },
+      getById: async (config, sessionId) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        const found = (await listSessions(baseUrl, apiKey)).find(
+          (s) => s.trackingId === sessionId || s.browserId === sessionId
+        );
+        if (!found) return null;
+        const trackingId = found.trackingId ?? sessionId;
+        return { ...toEntry(found), connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, sessionOptions.get(trackingId)) };
+      },
+      list: async (config) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        return (await listSessions(baseUrl, apiKey)).map(toEntry);
+      },
+      destroy: async (config, sessionId) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        const r = await fetch(`${baseUrl}/kill/${enc(sessionId)}?token=${enc(apiKey)}`);
+        sessionOptions.delete(sessionId);
+        if (!r.ok && r.status !== 404) {
+          throw new Error(`browserless destroy ${r.status}: ${redact(await r.text(), apiKey)}`);
+        }
+      },
+      getConnectUrl: async (config, sessionId) => {
+        const { apiKey, baseUrl } = resolveConfig(config);
+        return buildConnectUrl(baseUrl, apiKey, sessionId, sessionOptions.get(sessionId));
+      }
+    }
+  }
+});
+export {
+  browserless
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Browserless Browser Provider - Factory-based Implementation\n *\n * Cloud browser sessions via Browserless (https://browserless.io). Browserless\n * has no create-session REST call on the shared fleet: a session materializes\n * when the client opens the CDP websocket. `session.create()` therefore mints\n * a `trackingId` and returns the connect URL for it; the session starts when\n * `chromium.connectOverCDP(connectUrl)` opens, and ends on disconnect or via\n * `session.destroy()` (`/kill/<trackingId>`).\n */\n\nimport { randomUUID } from 'node:crypto';\nimport { defineBrowserProvider } from '@computesdk/provider';\n\nimport type { CreateBrowserSessionOptions } from '@computesdk/provider';\n\n/**\n * Shape of a running session as returned by `GET /sessions`.\n * `/sessions` is available on private/enterprise fleets; on the shared fleet\n * it may return 401 — list/getById surface that error rather than masking it.\n */\nexport interface BrowserlessSession {\n  browserId: string;\n  trackingId: string | null;\n  running: boolean;\n  startedOn: number;\n  timeAliveMs?: number;\n  browser?: string;\n  type?: string;\n}\n\n/**\n * Browserless-specific configuration options.\n */\nexport interface BrowserlessConfig {\n  /** Browserless API token — falls back to BROWSERLESS_API_KEY env var */\n  apiKey?: string;\n  /**\n   * Fleet base URL — falls back to BROWSERLESS_URL env var, then the shared\n   * US West fleet. Shared fleet: production-sfo|lon|ams.browserless.io.\n   * Private fleet: chrome.browserless.io or chrome-<region>.browserless.io\n   * (a private-fleet token against a shared-fleet host returns 401).\n   */\n  baseUrl?: string;\n}\n\nfunction resolveConfig(config: BrowserlessConfig) {\n  const apiKey =\n    config.apiKey || (typeof process !== 'undefined' && process.env?.BROWSERLESS_API_KEY) || '';\n  if (!apiKey) {\n    throw new Error(\n      `Missing Browserless API key. Provide 'apiKey' in config or set BROWSERLESS_API_KEY environment variable. ` +\n        `Get your API key from https://account.browserless.io`,\n    );\n  }\n  const baseUrl = (\n    config.baseUrl ||\n    (typeof process !== 'undefined' && process.env?.BROWSERLESS_URL) ||\n    'https://production-sfo.browserless.io'\n  ).replace(/\\/+$/, '');\n  return { apiKey, baseUrl };\n}\n\n/** http(s) base URL → ws(s) equivalent for the websocket endpoint. */\nfunction wsBase(baseUrl: string): string {\n  return baseUrl.replace(/^https/, 'wss').replace(/^http/, 'ws');\n}\n\nfunction enc(value: string): string {\n  return encodeURIComponent(value);\n}\n\nconst warnedUnsupported = new Set<string>();\nfunction warnOnce(field: string, reason: string) {\n  if (warnedUnsupported.has(field)) return;\n  warnedUnsupported.add(field);\n  console.warn(`[@computesdk/browserless] '${field}' is ignored: ${reason}`);\n}\n\n/**\n * Create options by sessionId, so getConnectUrl/getById can rebuild the same\n * URL the session was created with. Same-process only — a URL rebuilt in a\n * fresh process carries no launch options. Entries are dropped on destroy.\n */\nconst sessionOptions = new Map<string, CreateBrowserSessionOptions>();\n\n/** Strip the API token from provider error bodies before throwing. */\nfunction redact(body: string, apiKey: string): string {\n  return body.split(apiKey).join('***');\n}\n\n/**\n * Build the CDP connect URL for a session. The token authenticates the\n * websocket; `trackingId` is the session handle used by list/destroy.\n * `launch` query params are only meaningful if they land before the client\n * connects — they live on the connect URL by Browserless design.\n *\n * SECURITY: the returned URL embeds the account API token as a query\n * parameter. Treat it as a secret — do not log or persist it.\n */\nfunction buildConnectUrl(baseUrl: string, apiKey: string, trackingId: string, options?: CreateBrowserSessionOptions): string {\n  const url = new URL(`${wsBase(baseUrl)}/chromium`);\n  url.searchParams.set('token', apiKey);\n  url.searchParams.set('trackingId', trackingId);\n  if (!options) return url.toString();\n\n  if (options.stealth) url.searchParams.set('stealth', 'true');\n  if (options.viewport) {\n    url.searchParams.set('launch', JSON.stringify({\n      defaultViewport: { width: options.viewport.width, height: options.viewport.height },\n    }));\n  }\n  if (options.proxies === true) url.searchParams.set('proxy', 'residential');\n\n  if (options.keepAlive === true) {\n    warnOnce('keepAlive', 'Browserless sessions live until disconnect or /kill; no keep-alive flag.');\n  }\n  if (options.recording === false) {\n    warnOnce('recording', 'Session recording is managed server-side; no per-session toggle on the connect URL.');\n  }\n  if (options.logging === false) {\n    warnOnce('logging', 'Session logging is managed server-side; no per-session toggle on the connect URL.');\n  }\n  if (options.timeout !== undefined) {\n    warnOnce('timeout', 'Session TTL is a fleet-level setting on Browserless; no per-session timeout param.');\n  }\n  if (options.profileId !== undefined) {\n    warnOnce('profileId', 'Browserless has no persistent-profile concept on the connect URL.');\n  }\n  if (options.extensionIds && options.extensionIds.length > 0) {\n    warnOnce('extensionIds', 'Extensions must be baked into the Browserless fleet image; no per-session IDs.');\n  }\n  if (options.region !== undefined) {\n    warnOnce('region', 'Region is selected by the baseUrl host (e.g. production-sfo|lon|ams), not a connect param.');\n  }\n  if (options.saveDownloads === true) {\n    warnOnce('saveDownloads', 'Browserless has no server-side download retrieval API.');\n  }\n  if (options.userMetadata && Object.keys(options.userMetadata).length > 0) {\n    warnOnce('userMetadata', 'Browserless does not support arbitrary user metadata on sessions.');\n  }\n  if (Array.isArray(options.proxies) && options.proxies.length > 0) {\n    warnOnce('proxies', 'Custom proxy servers are a Browserless enterprise feature; only proxies=true maps (residential).');\n  }\n\n  return url.toString();\n}\n\nasync function listSessions(baseUrl: string, apiKey: string): Promise<BrowserlessSession[]> {\n  const r = await fetch(`${baseUrl}/sessions?token=${enc(apiKey)}`);\n  if (!r.ok) throw new Error(`browserless /sessions ${r.status}: ${redact(await r.text(), apiKey)}`);\n  return (await r.json()) as BrowserlessSession[];\n}\n\nfunction toEntry(s: BrowserlessSession) {\n  return {\n    session: s,\n    sessionId: s.trackingId ?? s.browserId,\n    status: (s.running ? 'running' : 'created') as 'running' | 'created',\n  };\n}\n\n/**\n * Create a Browserless browser provider instance.\n *\n * @example\n * ```ts\n * import { browserless } from '@computesdk/browserless';\n * import { chromium } from 'playwright-core';\n *\n * const bl = browserless({ apiKey: process.env.BROWSERLESS_API_KEY });\n *\n * // Mints a trackingId; the session starts when the socket opens.\n * const session = await bl.session.create();\n *\n * const browser = await chromium.connectOverCDP(session.connectUrl);\n * const page = browser.contexts()[0].pages()[0];\n * await page.goto('https://example.com');\n *\n * await session.destroy(); // or just browser.close() — disconnect ends it\n * ```\n */\nexport const browserless = defineBrowserProvider<BrowserlessSession, BrowserlessConfig>({\n  name: 'browserless',\n  methods: {\n    session: {\n      create: async (config: BrowserlessConfig, options?: CreateBrowserSessionOptions) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        // No REST create call — the trackingId becomes the session identity\n        // and the browser allocates when the client connects to the URL.\n        const trackingId = randomUUID();\n        if (options) sessionOptions.set(trackingId, options);\n        // Nothing exists server-side yet — running stays false until the\n        // client opens the websocket and Browserless allocates the browser.\n        return {\n          session: { browserId: trackingId, trackingId, running: false, startedOn: Date.now() },\n          sessionId: trackingId,\n          connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, options),\n          status: 'created',\n        };\n      },\n\n      getById: async (config: BrowserlessConfig, sessionId: string) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        const found = (await listSessions(baseUrl, apiKey)).find(\n          (s) => s.trackingId === sessionId || s.browserId === sessionId,\n        );\n        if (!found) return null;\n        const trackingId = found.trackingId ?? sessionId;\n        return { ...toEntry(found), connectUrl: buildConnectUrl(baseUrl, apiKey, trackingId, sessionOptions.get(trackingId)) };\n      },\n\n      list: async (config: BrowserlessConfig) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        return (await listSessions(baseUrl, apiKey)).map(toEntry);\n      },\n\n      destroy: async (config: BrowserlessConfig, sessionId: string) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        // /kill accepts a browserId or trackingId; a missing session is a no-op.\n        const r = await fetch(`${baseUrl}/kill/${enc(sessionId)}?token=${enc(apiKey)}`);\n        sessionOptions.delete(sessionId);\n        if (!r.ok && r.status !== 404) {\n          throw new Error(`browserless destroy ${r.status}: ${redact(await r.text(), apiKey)}`);\n        }\n      },\n\n      getConnectUrl: async (config: BrowserlessConfig, sessionId: string) => {\n        const { apiKey, baseUrl } = resolveConfig(config);\n        return buildConnectUrl(baseUrl, apiKey, sessionId, sessionOptions.get(sessionId));\n      },\n    },\n  },\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@computesdk/browserless",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.2",
+  "description": "Browserless browser provider for ComputeSDK - cloud browser sessions via Browserless",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@computesdk/provider": "2.1.20",
+    "computesdk": "4.1.14"
+  },
+  "keywords": [
+    "computesdk",
+    "browserless",
+    "browser",
+    "headless",
+    "playwright",
+    "puppeteer",
+    "provider"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/browserless"
+  },
+  "homepage": "https://www.browserless.io",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "dotenv": "^16.0.0",
+    "playwright-core": "^1.40.0",
+    "@computesdk/test-utils": "2.0.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage"
+  }
 }