slybrowser 0.1.0

package/README.md

@@ -0,0 +1,146 @@
+# SlyBrowser for JavaScript
+
+`launch()` starts the project-built W3C WebDriver shipped beside SlyBrowser. It never
+uses Selenium Manager, downloads a driver, or searches for a system Chrome.
+
+```ts
+import { launch } from "slybrowser";
+
+await using browser = await launch(browserExecutable, shortLivedLease, {
+  humanize: true,
+});
+await browser.get("https://example.test");
+console.log(await browser.title());
+```
+
+Set `driverExecutable` or `SLYBROWSER_WEBDRIVER_PATH` only when the driver is not
+beside the browser during development. Production packages require the exact
+hash-matched browser and driver as sibling files. Browser and driver major versions
+must match, and each process consumes a separate temporary copy of the short-lived
+signed lease. Humanize for this default path executes natively in Sly WebDriver;
+Playwright and Puppeteer remain optional through their explicitly named launch adapters.
+
+## Playwright and Puppeteer adapters
+
+Both adapters force the supplied SlyBrowser executable and validate the installed
+framework binding line. They never use a framework-downloaded browser or a system
+Chrome fallback.
+
+```ts
+import { chromium } from "playwright-core";
+import puppeteer from "puppeteer-core";
+import { launchPlaywright, launchPuppeteer } from "slybrowser";
+
+const browser = await launchPlaywright(
+  { chromium }, browserExecutable, shortLivedLease,
+  { frameworkVersion: "1.62.1" },
+);
+
+const puppeteerBrowser = await launchPuppeteer(
+  puppeteer, browserExecutable, shortLivedLease,
+  { frameworkVersion: "25.8.0" },
+);
+```
+
+Use `launchPlaywrightPersistent` or `launchPuppeteerPersistent` for persistent
+profiles. When `humanize: true` is set, the SDK writes a short-lived
+`--sly-humanize-config` native control file for the browser process. The SDK does not
+install a Playwright/Puppeteer-side movement substitute; unsupported browser builds
+must fail closed at the native capability gate.
+
+## Install and launch the latest authorized release
+
+Current release archives use 7z. Install `7z` (or `7zz` on Unix-like systems), or set `SLYBROWSER_7Z_PATH` to the executable before using the automatic installer.
+
+The license service returns a signed short lease and the signed newest compatible
+Stable manifest. The SDK then downloads the protected ZIP, verifies the archive plus
+the exact browser/WebDriver hashes, safely caches it and enforces the plan's one-session-
+per-browser-process limit.
+
+```ts
+import { chromium } from "playwright-core";
+import puppeteer from "puppeteer-core";
+import { launchLatest, launchLatestPlaywright, launchLatestPuppeteer } from "slybrowser";
+
+await using browser = await launchLatest("account.authorization.json", {
+  trust: {
+    licenseTrustedKeys: { "license-prod-v1": licensePublicKey },
+    releaseTrustedKeys: { "release-prod-v1": releasePublicKey },
+  },
+  humanize: true,
+});
+
+console.log(browser.licenseRuntime); // plan, limit, version and session ID
+await browser.get("https://example.test");
+
+const playwrightBrowser = await launchLatestPlaywright(
+  { chromium }, "account.authorization.json", {
+    trust: {
+      licenseTrustedKeys: { "license-prod-v1": licensePublicKey },
+      releaseTrustedKeys: { "release-prod-v1": releasePublicKey },
+    },
+    frameworkVersion: "1.62.1",
+  },
+);
+
+const puppeteerBrowser = await launchLatestPuppeteer(
+  puppeteer, "account.authorization.json", {
+    trust: {
+      licenseTrustedKeys: { "license-prod-v1": licensePublicKey },
+      releaseTrustedKeys: { "release-prod-v1": releasePublicKey },
+    },
+    frameworkVersion: "25.8.0",
+  },
+);
+```
+
+The authorized framework launchers reserve and release the same concurrency slot as
+`launchLatest(...)`, expose `licenseRuntime.versionAudit`, and fail closed if the
+framework reports a launched browser version that does not exactly match the signed
+selected release. Persistent profile variants are available as
+`launchLatestPlaywrightPersistent` and `launchLatestPuppeteerPersistent`.
+
+The public keys are raw 32-byte Ed25519 keys. The CLI accepts them as base64url JSON in
+`SLYBROWSER_LICENSE_PUBLIC_KEYS_JSON` and `SLYBROWSER_RELEASE_PUBLIC_KEYS_JSON`:
+
+```text
+slybrowser install --authorization account.authorization.json [--cache DIR] [--kernel-major 150|latest] [--update-kernel]
+```
+
+## Import a paid license file on Windows
+
+After checkout, the billing email delivers an encrypted v2 license file. Import it
+once on the Windows machine that will run SlyBrowser:
+
+```text
+set SLYBROWSER_LICENSE_FILE_PUBLIC_KEYS_JSON={"license-file-prod-v1":"BASE64URL_RAW_ED25519_PUBLIC_KEY"}
+slybrowser license import --input account.slybrowser-license.json --output account.slybrowser-sealed-license.json --passphrase YOUR_PASSPHRASE
+```
+
+The sealed output uses Windows DPAPI current-user protection. It can be passed to
+the same `--authorization` option and to `launchLatest(...)`/Playwright/Puppeteer
+authorized launchers without providing the license-file passphrase again. The sealed
+file still grants access on that Windows account, so do not commit, log, or share it.
+
+## Redacted license diagnostics
+
+Use `license info` when a customer needs support without exposing their credential:
+
+```text
+slybrowser license info --authorization account.slybrowser-sealed-license.json [--kernel-major 150|latest] [--update-kernel]
+```
+
+The command contacts the authorization service through `Authorization: License ...`
+and prints only redacted diagnostics: plan, effective plan, paid-through time,
+feature set, active/available browser-process concurrency, selected release state,
+update availability and `stableErrorCode`. It does not print the license key,
+session tokens, download tickets, email, PayNow identifiers, profile paths or service
+access URL.
+
+Without `--update-kernel`, the CLI keeps updates closed: it reuses the current
+authorized local candidate when one exists and asks the service for an exact grant.
+Use `--update-kernel` to actively move to the newest authorized Stable release in
+the selected major range.
+
+Do not commit or log the authorization file. See
+`docs/authorized-release-service.md` for the server and release workflow.

package/dist/automation.d.ts

@@ -0,0 +1,15 @@
+export type AutomationBackend = "project-webdriver" | "playwright" | "puppeteer";
+export type FrameworkBackend = Exclude<AutomationBackend, "project-webdriver">;
+export interface AutomationCapability {
+    backend: AutomationBackend;
+    language: "node";
+    frameworkVersion?: string;
+    nativeHumanize: boolean;
+    persistentContext: boolean;
+}
+export declare function validateFrameworkVersion(backend: FrameworkBackend, version: string): string;
+export declare function installedFrameworkVersion(backend: FrameworkBackend): string;
+export declare function resolveFrameworkVersion(backend: FrameworkBackend, explicit?: string): string;
+export declare function automationCapability(backend?: AutomationBackend, frameworkVersion?: string): AutomationCapability;
+export declare function requireFrameworkHumanizeSupport(backend: FrameworkBackend, requested: boolean | undefined): void;
+//# sourceMappingURL=automation.d.ts.map

package/dist/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../src/automation.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,YAAY,GAAG,WAAW,CAAC;AACjF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAkBD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS3F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAe3E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5F;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,iBAAuC,EAChD,gBAAgB,CAAC,EAAE,MAAM,GACxB,oBAAoB,CAmBtB;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAG/G"}

package/dist/automation.js

@@ -0,0 +1,69 @@
+import { createRequire } from "node:module";
+import { ConfigurationError } from "./errors.js";
+const SUPPORTED_LINES = Object.freeze({
+    playwright: Object.freeze(["1.62"]),
+    puppeteer: Object.freeze(["25"]),
+});
+const PACKAGE_CANDIDATES = Object.freeze({
+    playwright: Object.freeze(["playwright-core", "playwright"]),
+    puppeteer: Object.freeze(["puppeteer-core", "puppeteer"]),
+});
+function versionLine(version) {
+    const match = version.match(/^(\d+)\.(\d+)(?:\.\d+)?(?:[-+][0-9A-Za-z.-]+)?$/);
+    if (!match)
+        throw new ConfigurationError(`Invalid framework version: ${version}`, "framework_version_invalid");
+    return match[1] === "1" ? `${match[1]}.${match[2]}` : match[1];
+}
+export function validateFrameworkVersion(backend, version) {
+    const line = versionLine(version);
+    if (!SUPPORTED_LINES[backend].includes(line)) {
+        throw new ConfigurationError(`Unsupported ${backend} version ${version}; supported lines: ${SUPPORTED_LINES[backend].join(", ")}`, "framework_version_unsupported");
+    }
+    return version;
+}
+export function installedFrameworkVersion(backend) {
+    const require = createRequire(import.meta.url);
+    for (const packageName of PACKAGE_CANDIDATES[backend]) {
+        try {
+            const metadata = require(`${packageName}/package.json`);
+            if (typeof metadata.version === "string")
+                return validateFrameworkVersion(backend, metadata.version);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "MODULE_NOT_FOUND" && code !== "ERR_PACKAGE_PATH_NOT_EXPORTED")
+                throw error;
+        }
+    }
+    throw new ConfigurationError(`Unable to determine the installed ${backend} package version; pass frameworkVersion explicitly`, "framework_version_missing");
+}
+export function resolveFrameworkVersion(backend, explicit) {
+    return explicit === undefined
+        ? installedFrameworkVersion(backend)
+        : validateFrameworkVersion(backend, explicit);
+}
+export function automationCapability(backend = "project-webdriver", frameworkVersion) {
+    if (backend === "project-webdriver") {
+        if (frameworkVersion !== undefined) {
+            throw new ConfigurationError("Project WebDriver does not accept frameworkVersion", "framework_version_forbidden");
+        }
+        return {
+            backend,
+            language: "node",
+            nativeHumanize: true,
+            persistentContext: true,
+        };
+    }
+    return {
+        backend,
+        language: "node",
+        frameworkVersion: resolveFrameworkVersion(backend, frameworkVersion),
+        nativeHumanize: true,
+        persistentContext: true,
+    };
+}
+export function requireFrameworkHumanizeSupport(backend, requested) {
+    void backend;
+    void requested;
+}
+//# sourceMappingURL=automation.js.map

package/dist/automation.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,31 @@
+import { type HumanConfig, type HumanPreset } from "./humanize.js";
+export interface ChromiumLauncherLike<TBrowser = unknown, TContext = unknown> {
+    launch(options: Record<string, unknown>): Promise<TBrowser>;
+    launchPersistentContext(userDataDir: string, options: Record<string, unknown>): Promise<TContext>;
+}
+export interface PlaywrightLike<TBrowser = unknown, TContext = unknown> {
+    chromium: ChromiumLauncherLike<TBrowser, TContext>;
+}
+export interface PuppeteerLike<TBrowser = unknown> {
+    launch(options: Record<string, unknown>): Promise<TBrowser>;
+}
+export interface FrameworkLaunchSettings {
+    profile?: Record<string, unknown>;
+    launchOptions?: Record<string, unknown>;
+    tempRoot?: string;
+    nativeReady?: boolean;
+    nativeReadyTimeout?: number;
+    humanize?: boolean;
+    humanPreset?: HumanPreset;
+    humanConfig?: Partial<HumanConfig>;
+    humanSeed?: number;
+    frameworkVersion?: string;
+    runtimeHandoff?: Record<string, unknown>;
+    allowRuntimeActivationTicket?: boolean;
+    releaseRoot?: string;
+}
+export declare function launchPlaywright<TBrowser>(playwright: PlaywrightLike<TBrowser>, executable: string, lease: string | Buffer | Record<string, unknown>, settings?: FrameworkLaunchSettings): Promise<TBrowser>;
+export declare function launchPlaywrightPersistent<TContext>(playwright: PlaywrightLike<unknown, TContext>, userDataDir: string, executable: string, lease: string | Buffer | Record<string, unknown>, settings?: FrameworkLaunchSettings): Promise<TContext>;
+export declare function launchPuppeteer<TBrowser>(puppeteer: PuppeteerLike<TBrowser>, executable: string, lease: string | Buffer | Record<string, unknown>, settings?: FrameworkLaunchSettings): Promise<TBrowser>;
+export declare function launchPuppeteerPersistent<TBrowser>(puppeteer: PuppeteerLike<TBrowser>, userDataDir: string, executable: string, lease: string | Buffer | Record<string, unknown>, settings?: FrameworkLaunchSettings): Promise<TBrowser>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AASA,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,WAAW,oBAAoB,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5D,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnG;AAED,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IACpE,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO;IAC/C,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0HD,wBAAsB,gBAAgB,CAAC,QAAQ,EAC7C,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC,EACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,QAAQ,GAAE,uBAA4B,GACrC,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED,wBAAsB,0BAA0B,CAAC,QAAQ,EACvD,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC7C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,QAAQ,GAAE,uBAA4B,GACrC,OAAO,CAAC,QAAQ,CAAC,CA0BnB;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAC5C,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,QAAQ,GAAE,uBAA4B,GACrC,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED,wBAAsB,yBAAyB,CAAC,QAAQ,EACtD,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,EAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,QAAQ,GAAE,uBAA4B,GACrC,OAAO,CAAC,QAAQ,CAAC,CAcnB"}

package/dist/browser.js

@@ -0,0 +1,203 @@
+import { dirname, resolve } from "node:path";
+import { requireFrameworkHumanizeSupport, resolveFrameworkVersion, } from "./automation.js";
+import { ConfigurationError } from "./errors.js";
+import { prepareLaunch } from "./launcher.js";
+import { resolveHumanConfig } from "./humanize.js";
+function jsonObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function parseSignedLeaseClaims(lease) {
+    try {
+        const envelope = typeof lease === "string"
+            ? JSON.parse(lease)
+            : Buffer.isBuffer(lease)
+                ? JSON.parse(lease.toString("utf8"))
+                : lease;
+        const payload = jsonObject(envelope)?.payload;
+        if (typeof payload !== "string" || payload.length === 0)
+            return undefined;
+        return jsonObject(JSON.parse(Buffer.from(payload, "base64url").toString("utf8")));
+    }
+    catch (error) {
+        return undefined;
+    }
+}
+function deriveReleaseRoot(browserExecutable, artifactBrowserExecutable) {
+    if (typeof artifactBrowserExecutable !== "string" || !artifactBrowserExecutable.trim())
+        return undefined;
+    const expectedParts = artifactBrowserExecutable.replaceAll("\\", "/").split("/").filter(Boolean);
+    if (expectedParts.length === 0)
+        return undefined;
+    const actualPath = resolve(browserExecutable);
+    const actualParts = actualPath.replaceAll("\\", "/").split("/").filter(Boolean);
+    if (actualParts.length < expectedParts.length)
+        return undefined;
+    const actualSuffix = actualParts.slice(-expectedParts.length);
+    const matches = expectedParts.every((part, index) => {
+        const actualPart = actualSuffix[index];
+        return typeof actualPart === "string" && part.toLowerCase() === actualPart.toLowerCase();
+    });
+    if (!matches)
+        return undefined;
+    let releaseRoot = actualPath;
+    for (let index = 0; index < expectedParts.length; ++index) {
+        releaseRoot = dirname(releaseRoot);
+    }
+    return releaseRoot;
+}
+function releaseRootFromLease(browserExecutable, lease) {
+    const claims = parseSignedLeaseClaims(lease);
+    const artifact = jsonObject(claims?.artifact);
+    return deriveReleaseRoot(browserExecutable, artifact?.browserExecutable);
+}
+function validateFrameworkSettings(backend, settings) {
+    resolveFrameworkVersion(backend, settings.frameworkVersion);
+    requireFrameworkHumanizeSupport(backend, settings.humanize);
+    if (settings.nativeReady === true &&
+        settings.nativeReadyTimeout !== undefined &&
+        (!Number.isFinite(settings.nativeReadyTimeout) || settings.nativeReadyTimeout < 1)) {
+        throw new ConfigurationError("nativeReadyTimeout must be a positive number of milliseconds", "config_invalid");
+    }
+}
+function nativeHumanizeControl(backend, settings) {
+    if (settings.humanize !== true)
+        return undefined;
+    if (settings.humanSeed !== undefined &&
+        (!Number.isInteger(settings.humanSeed) || settings.humanSeed < 0)) {
+        throw new ConfigurationError("Native Humanize seed must be a non-negative integer", "humanize_seed_invalid");
+    }
+    const preset = settings.humanPreset ?? "default";
+    return {
+        schemaVersion: 1,
+        kind: "slybrowser.native-humanize-control",
+        backend,
+        humanize: {
+            enabled: true,
+            version: 1,
+            preset,
+            config: resolveHumanConfig({
+                preset,
+                ...(settings.humanConfig === undefined ? {} : { config: settings.humanConfig }),
+            }),
+            ...(settings.humanSeed === undefined ? {} : { seed: settings.humanSeed }),
+        },
+    };
+}
+function mergeLaunchOptions(launchOptions, executable, handoffArguments) {
+    const result = { ...(launchOptions ?? {}) };
+    if ("executablePath" in result || "executable_path" in result) {
+        throw new ConfigurationError("The browser executable must be passed to the SlyBrowser adapter", "executable_option_conflict");
+    }
+    const existingArguments = result.args ?? [];
+    if (!Array.isArray(existingArguments) || existingArguments.some((argument) => typeof argument !== "string")) {
+        throw new ConfigurationError("Framework args must be a string array", "config_invalid");
+    }
+    return {
+        ...result,
+        executablePath: executable,
+        args: [...handoffArguments, ...existingArguments],
+    };
+}
+function nativeReadyTimeout(settings) {
+    return settings.nativeReady === true ? settings.nativeReadyTimeout ?? 15_000 : undefined;
+}
+async function closeFrameworkRuntime(runtime) {
+    const candidate = runtime;
+    if (typeof candidate?.close !== "function")
+        return;
+    await Promise.resolve(candidate.close.call(runtime)).catch(() => undefined);
+}
+export async function launchPlaywright(playwright, executable, lease, settings = {}) {
+    validateFrameworkSettings("playwright", settings);
+    const readyTimeout = nativeReadyTimeout(settings);
+    const plan = await prepareLaunch(executable, settings.profile ?? {}, lease, {
+        tempRoot: settings.tempRoot,
+        runtimeHandoff: settings.runtimeHandoff,
+        allowRuntimeActivationTicket: settings.allowRuntimeActivationTicket === true,
+        humanizeControl: nativeHumanizeControl("playwright", settings),
+        nativeReady: readyTimeout !== undefined,
+        releaseRoot: settings.releaseRoot === undefined ? releaseRootFromLease(executable, lease) : settings.releaseRoot,
+    });
+    try {
+        const browser = await playwright.chromium.launch(mergeLaunchOptions(settings.launchOptions, plan.executable, plan.arguments));
+        try {
+            if (readyTimeout !== undefined)
+                await plan.waitForNativeReady(readyTimeout);
+            return browser;
+        }
+        catch (error) {
+            await closeFrameworkRuntime(browser);
+            throw error;
+        }
+    }
+    finally {
+        await plan.cleanup();
+    }
+}
+export async function launchPlaywrightPersistent(playwright, userDataDir, executable, lease, settings = {}) {
+    validateFrameworkSettings("playwright", settings);
+    const readyTimeout = nativeReadyTimeout(settings);
+    const plan = await prepareLaunch(executable, settings.profile ?? {}, lease, {
+        tempRoot: settings.tempRoot,
+        runtimeHandoff: settings.runtimeHandoff,
+        allowRuntimeActivationTicket: settings.allowRuntimeActivationTicket === true,
+        humanizeControl: nativeHumanizeControl("playwright", settings),
+        nativeReady: readyTimeout !== undefined,
+        releaseRoot: settings.releaseRoot === undefined ? releaseRootFromLease(executable, lease) : settings.releaseRoot,
+    });
+    try {
+        const context = await playwright.chromium.launchPersistentContext(resolve(userDataDir), mergeLaunchOptions(settings.launchOptions, plan.executable, plan.arguments));
+        try {
+            if (readyTimeout !== undefined)
+                await plan.waitForNativeReady(readyTimeout);
+            return context;
+        }
+        catch (error) {
+            await closeFrameworkRuntime(context);
+            throw error;
+        }
+    }
+    finally {
+        await plan.cleanup();
+    }
+}
+export async function launchPuppeteer(puppeteer, executable, lease, settings = {}) {
+    validateFrameworkSettings("puppeteer", settings);
+    const readyTimeout = nativeReadyTimeout(settings);
+    const plan = await prepareLaunch(executable, settings.profile ?? {}, lease, {
+        tempRoot: settings.tempRoot,
+        runtimeHandoff: settings.runtimeHandoff,
+        allowRuntimeActivationTicket: settings.allowRuntimeActivationTicket === true,
+        humanizeControl: nativeHumanizeControl("puppeteer", settings),
+        nativeReady: readyTimeout !== undefined,
+        releaseRoot: settings.releaseRoot === undefined ? releaseRootFromLease(executable, lease) : settings.releaseRoot,
+    });
+    try {
+        const browser = await puppeteer.launch(mergeLaunchOptions(settings.launchOptions, plan.executable, plan.arguments));
+        try {
+            if (readyTimeout !== undefined)
+                await plan.waitForNativeReady(readyTimeout);
+            return browser;
+        }
+        catch (error) {
+            await closeFrameworkRuntime(browser);
+            throw error;
+        }
+    }
+    finally {
+        await plan.cleanup();
+    }
+}
+export async function launchPuppeteerPersistent(puppeteer, userDataDir, executable, lease, settings = {}) {
+    if (settings.launchOptions && "userDataDir" in settings.launchOptions) {
+        throw new ConfigurationError("The persistent profile directory must be passed to the SlyBrowser adapter", "profile_option_conflict");
+    }
+    return launchPuppeteer(puppeteer, executable, lease, {
+        ...settings,
+        launchOptions: {
+            ...(settings.launchOptions ?? {}),
+            userDataDir: resolve(userDataDir),
+        },
+    });
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,GAExB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAsC,MAAM,eAAe,CAAC;AAiCvF,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;AACvG,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAgD;IAC9E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ;YACxC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY;YAC9B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACtB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY;gBAC/C,CAAC,CAAC,KAAK,CAAC;QACZ,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC9C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1E,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY,CAAC,CAAC;IAC/F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,iBAAyB,EAAE,yBAAkC;IACtF,IAAI,OAAO,yBAAyB,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACzG,MAAM,aAAa,GAAG,yBAAyB,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjG,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3F,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,WAAW,GAAG,UAAU,CAAC;IAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC;QAC1D,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,oBAAoB,CAC3B,iBAAyB,EACzB,KAAgD;IAEhD,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAyB,EAAE,QAAiC;IAC7F,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC5D,+BAA+B,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI;QAC7B,QAAQ,CAAC,kBAAkB,KAAK,SAAS;QACzC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAC,kBAAkB,GAAG,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,kBAAkB,CAAC,8DAA8D,EAAE,gBAAgB,CAAC,CAAC;IACjH,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,QAAiC;IAEjC,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;QAChC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,kBAAkB,CAAC,qDAAqD,EAAE,uBAAuB,CAAC,CAAC;IAC/G,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,IAAI,SAAS,CAAC;IACjD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,oCAAoC;QAC1C,OAAO;QACP,QAAQ,EAAE;YACR,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC;YACV,MAAM;YACN,MAAM,EAAE,kBAAkB,CAAC;gBACzB,MAAM;gBACN,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;aAChF,CAAC;YACF,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;SAC1E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,aAAkD,EAClD,UAAkB,EAClB,gBAAmC;IAEnC,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5C,IAAI,gBAAgB,IAAI,MAAM,IAAI,iBAAiB,IAAI,MAAM,EAAE,CAAC;QAC9D,MAAM,IAAI,kBAAkB,CAC1B,iEAAiE,EACjE,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5G,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,EAAE,gBAAgB,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO;QACL,GAAG,MAAM;QACT,cAAc,EAAE,UAAU;QAC1B,IAAI,EAAE,CAAC,GAAG,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAiC;IAC3D,OAAO,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IACnD,MAAM,SAAS,GAAG,OAAkE,CAAC;IACrF,IAAI,OAAO,SAAS,EAAE,KAAK,KAAK,UAAU;QAAE,OAAO;IACnD,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAoC,EACpC,UAAkB,EAClB,KAAgD,EAChD,WAAoC,EAAE;IAEtC,yBAAyB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE;QAC1E,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,KAAK,IAAI;QAC5E,eAAe,EAAE,qBAAqB,CAAC,YAAY,EAAE,QAAQ,CAAC;QAC9D,WAAW,EAAE,YAAY,KAAK,SAAS;QACvC,WAAW,EAAE,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;KACjH,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAC9C,kBAAkB,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAC5E,CAAC;QACF,IAAI,CAAC;YACH,IAAI,YAAY,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;YAC5E,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAA6C,EAC7C,WAAmB,EACnB,UAAkB,EAClB,KAAgD,EAChD,WAAoC,EAAE;IAEtC,yBAAyB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE;QAC1E,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,KAAK,IAAI;QAC5E,eAAe,EAAE,qBAAqB,CAAC,YAAY,EAAE,QAAQ,CAAC;QAC9D,WAAW,EAAE,YAAY,KAAK,SAAS;QACvC,WAAW,EAAE,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;KACjH,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAC/D,OAAO,CAAC,WAAW,CAAC,EACpB,kBAAkB,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAC5E,CAAC;QACF,IAAI,CAAC;YACH,IAAI,YAAY,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;YAC5E,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAkC,EAClC,UAAkB,EAClB,KAAgD,EAChD,WAAoC,EAAE;IAEtC,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE;QAC1E,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,KAAK,IAAI;QAC5E,eAAe,EAAE,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC;QAC7D,WAAW,EAAE,YAAY,KAAK,SAAS;QACvC,WAAW,EAAE,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;KACjH,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,CACpC,kBAAkB,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAC5E,CAAC;QACF,IAAI,CAAC;YACH,IAAI,YAAY,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;YAC5E,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,SAAkC,EAClC,WAAmB,EACnB,UAAkB,EAClB,KAAgD,EAChD,WAAoC,EAAE;IAEtC,IAAI,QAAQ,CAAC,aAAa,IAAI,aAAa,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QACtE,MAAM,IAAI,kBAAkB,CAC1B,2EAA2E,EAC3E,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE;QACnD,GAAG,QAAQ;QACX,aAAa,EAAE;YACb,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC;YACjC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC;SAClC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/canonical.d.ts

@@ -0,0 +1,4 @@
+export declare function canonicalJson(value: unknown): Buffer;
+export declare function encodeBase64Url(value: Uint8Array): string;
+export declare function decodeBase64Url(value: unknown, maxBytes: number): Buffer;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAmBA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYxE"}

package/dist/canonical.js

@@ -0,0 +1,42 @@
+function normalize(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError("JSON numbers must be finite");
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(normalize);
+    if (typeof value === "object") {
+        const result = {};
+        for (const key of Object.keys(value).sort()) {
+            const member = value[key];
+            if (member === undefined)
+                throw new TypeError("undefined is not valid canonical JSON");
+            result[key] = normalize(member);
+        }
+        return result;
+    }
+    throw new TypeError(`Unsupported canonical JSON value: ${typeof value}`);
+}
+export function canonicalJson(value) {
+    return Buffer.from(JSON.stringify(normalize(value)), "utf8");
+}
+export function encodeBase64Url(value) {
+    return Buffer.from(value).toString("base64url");
+}
+export function decodeBase64Url(value, maxBytes) {
+    if (typeof value !== "string" || !value || !/^[A-Za-z0-9_-]+$/.test(value)) {
+        throw new TypeError("value is not unpadded base64url");
+    }
+    if (value.length > Math.ceil(maxBytes / 3) * 4) {
+        throw new RangeError("decoded value exceeds size limit");
+    }
+    const decoded = Buffer.from(value, "base64url");
+    if (decoded.length > maxBytes || decoded.toString("base64url") !== value) {
+        throw new TypeError("invalid base64url value");
+    }
+    return decoded;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAChF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;YACvD,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;YACvF,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,qCAAqC,OAAO,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,QAAgB;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,KAAK,EAAE,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,yBAAyB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cdp.d.ts

@@ -0,0 +1,21 @@
+type JsonObject = Record<string, unknown>;
+export interface CdpDiscovery {
+    Browser?: string;
+    "Protocol-Version"?: string;
+    webSocketDebuggerUrl?: string;
+    [name: string]: unknown;
+}
+export declare function cdpDebuggerAddress(capabilities: JsonObject): string;
+export declare function fetchCdpDiscovery(capabilities: JsonObject, fetchImplementation?: typeof fetch): Promise<CdpDiscovery>;
+export interface AuthenticatedCdpAdapter {
+    endpoint: string;
+    close(): Promise<void>;
+}
+export declare function createAuthenticatedCdpAdapter(capabilities: JsonObject, options: {
+    token: string;
+    host?: string;
+    port?: number;
+    fetch?: typeof fetch;
+}): Promise<AuthenticatedCdpAdapter>;
+export {};
+//# sourceMappingURL=cdp.d.ts.map

package/dist/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../src/cdp.ts"],"names":[],"mappings":"AAMA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAMD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,UAAU,GAAG,MAAM,CAgBnE;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,UAAU,EACxB,mBAAmB,GAAE,OAAO,KAAa,GACxC,OAAO,CAAC,YAAY,CAAC,CASvB;AAiCD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAC7E,OAAO,CAAC,uBAAuB,CAAC,CAmElC"}