@the-forge-flow/camoufox-pi 0.1.1 → 0.1.2

package/README.md

@@ -111,6 +111,79 @@ Defaults baked into `DEFAULT_CONFIG`:
 | `maxBytes` | `2097152` | 2 MiB response cap for `fetch_url`, overridable via `max_bytes` |
 | `defaultEngine` | `"duckduckgo"` | Only valid value in v0.1.0 |
 
+## Programmatic API (library mode)
+
+`@the-forge-flow/camoufox-pi` can be imported directly from non-PI code (TFF daemon, scripts, CI harnesses). This is an off-label integration path — PI itself does not officially document cross-extension imports — but the client is PI-agnostic by design and has no PI runtime dependency.
+
+```typescript
+import { createClient } from "@the-forge-flow/camoufox-pi";
+
+const client = createClient();
+// Optional: wait for ready up-front (factory is lazy; first op would block otherwise).
+await client.ensureReady();
+
+const { html, status } = await client.fetchUrl("https://example.com", {
+  signal: AbortSignal.timeout(30_000),
+});
+
+const { results } = await client.search("claude code", {
+  signal: AbortSignal.timeout(30_000),
+  maxResults: 10,
+});
+
+await client.close();
+```
+
+### `createClient(opts?)`
+
+- `opts.config?: Partial<CamoufoxConfig>` — shallow-merged over `DEFAULT_CONFIG`.
+- `opts.launcher?: Launcher` — swap in a custom launcher (tests inject a fake).
+
+Returns a `CamoufoxClient` synchronously. `ensureReady()` is fired in the background; the first op awaits the in-flight promise.
+
+### `client.checkHealth({ probe? })`
+
+Lightweight snapshot (default):
+
+```typescript
+{
+  status: "launching" | "ready" | "failed" | "closed",
+  browserConnected: boolean,
+  browserVersion: string | null,
+  launchedAt: number | null,
+  uptimeMs: number | null,
+  lastError: CamoufoxError | null,
+}
+```
+
+Active probe (`{ probe: true }`) adds `probe: { ok, roundTripMs, error }` by opening and closing an `about:blank` page with a fixed 2 s timeout. Probe failure does NOT mutate client state.
+
+### Events
+
+`client.events` is a typed `EventEmitter` with five events:
+
+| Event | Payload | Emitted when |
+|---|---|---|
+| `browser_launch` | `{ spanId, browserVersion, durationMs }` | Launch completes successfully |
+| `binary_download_progress` | `{ bytesDownloaded, bytesTotal }` | camoufox-js downloads the binary (first launch only) |
+| `fetch_url` | `{ spanId, url, finalUrl, status, bytes, truncated, isolate, durationMs }` | `fetchUrl()` resolves |
+| `search` | `{ spanId, engine, query, maxResults, resultCount, atLimit, durationMs }` | `search()` resolves |
+| `error` | `{ spanId, op, error: CamoufoxError }` | Any op throws — fired BEFORE `throw` |
+
+`spanId` is an 8-char hex string minted per op. The `error` event always fires before the `CamoufoxErrorBox` reaches the caller's `catch`. A listener that throws is caught (`console.error`) and does NOT mask the original error, and other listeners on the same event still run. Async listener rejections are swallowed-and-logged too.
+
+## Event reference (inside PI)
+
+When the extension is loaded by PI, `CamoufoxService.attach(pi)` bridges every client event to `pi.events` under the `camoufox:` prefix. Other PI extensions subscribe idiomatically:
+
+```typescript
+pi.events.on("camoufox:fetch_url", (e) => {
+  console.log(`fetch_url ${e.url} → ${e.status} (${e.durationMs} ms)`);
+});
+```
+
+Binary-download progress additionally drives `pi.ui.setStatus("camoufox:binary", …)` for a footer status line during the ~500 MB first-use download.
+
 ## Architecture
 
 ```

package/dist/client/camoufox-client.d.ts

@@ -2,7 +2,21 @@ import type { Browser, BrowserContext, Page } from "playwright-core";
 import type { RawResult } from "../search/types.js";
 import { type LookupFn } from "../security/ssrf.js";
 import type { CamoufoxConfig } from "../types.js";
+import { type CamoufoxEventEmitter } from "./events.js";
 import type { Launcher } from "./launcher.js";
+export interface HealthStatus {
+    status: "launching" | "ready" | "failed" | "closed";
+    browserConnected: boolean;
+    browserVersion: string | null;
+    launchedAt: number | null;
+    uptimeMs: number | null;
+    lastError: import("../errors.js").CamoufoxError | null;
+    probe?: {
+        ok: boolean;
+        roundTripMs: number;
+        error: import("../errors.js").CamoufoxError | null;
+    };
+}
 export interface CamoufoxClientOptions {
     readonly launcher: Launcher;
     readonly config?: CamoufoxConfig;
@@ -10,12 +24,18 @@ export interface CamoufoxClientOptions {
     readonly ssrfLookup?: LookupFn;
 }
 export declare class CamoufoxClient {
+    readonly events: CamoufoxEventEmitter;
     private readonly launcher;
-    private readonly config;
+    readonly config: CamoufoxConfig;
     private readonly ssrfLookup;
     private state;
     constructor(opts: CamoufoxClientOptions);
     isAlive(): boolean;
+    checkHealth(opts?: {
+        probe?: boolean;
+        signal?: AbortSignal;
+    }): Promise<HealthStatus>;
+    private emitError;
     ensureReady(signal?: AbortSignal): Promise<void>;
     fetchUrl(url: string, opts: {
         signal: AbortSignal;

package/dist/client/camoufox-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camoufox-client.d.ts","sourceRoot":"","sources":["../../src/client/camoufox-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAIrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAY9C,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;CAC/B;AAED,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,KAAK,CAAkC;gBAEnC,IAAI,EAAE,qBAAqB;IAMvC,OAAO,IAAI,OAAO;IAIZ,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAehD,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QACL,MAAM,EAAE,WAAW,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,GACC,OAAO,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;KACnB,CAAC;IAqEI,MAAM,CACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QACL,MAAM,EAAE,WAAW,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,GACC,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;cAiDzD,QAAQ,CACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QACL,MAAM,EAAE,WAAW,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;QACvD,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,GACC,OAAO,CAAC;QACV,IAAI,EAAE,IAAI,CAAC;QACX,QAAQ,EAAE;YAAE,MAAM,IAAI,MAAM,CAAC;YAAC,GAAG,IAAI,MAAM,CAAA;SAAE,CAAC;QAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;IAuDI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,SAAS,CAAC,SAAS,IAAI,cAAc;IAIrC,SAAS,CAAC,UAAU,IAAI,cAAc;IAUtC,SAAS,CAAC,UAAU,IAAI,OAAO;YAUjB,QAAQ;YAsBR,eAAe;CAqB7B"}
+{"version":3,"file":"camoufox-client.d.ts","sourceRoot":"","sources":["../../src/client/camoufox-client.ts"],"names":[],"mappings":"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"}

package/dist/client/camoufox-client.js

@@ -2,8 +2,10 @@ import { CamoufoxErrorBox, mapPlaywrightError } from "../errors.js";
 import { duckduckgoAdapter } from "../search/adapters/duckduckgo.js";
 import { assertSafeTarget } from "../security/ssrf.js";
 import { DEFAULT_CONFIG } from "../types.js";
+import { createEventEmitter, newSpanId, } from "./events.js";
 import { combineSignals } from "./signal.js";
 export class CamoufoxClient {
+    events = createEventEmitter();
     launcher;
     config;
     ssrfLookup;
@@ -16,6 +18,63 @@ export class CamoufoxClient {
     isAlive() {
         return this.state.status === "ready" && this.state.browser?.isConnected() === true;
     }
+    async checkHealth(opts = {}) {
+        const status = this.state.status === "idle" ? "launching" : this.state.status;
+        const snapshot = {
+            status,
+            browserConnected: this.state.status === "ready" ? this.state.browser?.isConnected() === true : false,
+            browserVersion: this.state.version ?? null,
+            launchedAt: this.state.launchedAt ?? null,
+            uptimeMs: this.state.status === "ready" && this.state.launchedAt
+                ? Date.now() - this.state.launchedAt
+                : null,
+            lastError: this.state.status === "failed" && this.state.error ? this.state.error.err : null,
+        };
+        if (opts.probe) {
+            if (this.state.status !== "ready" || !this.state.context || !this.state.browser) {
+                snapshot.probe = {
+                    ok: false,
+                    roundTripMs: 0,
+                    error: { type: "playwright_disconnected" },
+                };
+                return snapshot;
+            }
+            const probeStarted = Date.now();
+            try {
+                const page = await this.state.context.newPage();
+                try {
+                    await page.goto("about:blank", { timeout: 2_000, waitUntil: "load" });
+                    snapshot.probe = {
+                        ok: true,
+                        roundTripMs: Date.now() - probeStarted,
+                        error: null,
+                    };
+                }
+                finally {
+                    await page.close().catch(() => undefined);
+                }
+            }
+            catch (err) {
+                const mapped = mapPlaywrightError(err, {
+                    url: "about:blank",
+                    phase: "nav",
+                    elapsedMs: Date.now() - probeStarted,
+                    ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+                });
+                snapshot.probe = {
+                    ok: false,
+                    roundTripMs: Date.now() - probeStarted,
+                    error: mapped,
+                };
+            }
+        }
+        return snapshot;
+    }
+    emitError(spanId, op, err) {
+        if (err instanceof CamoufoxErrorBox) {
+            this.events.emit("error", { spanId, op, error: err.err });
+        }
+    }
     async ensureReady(signal) {
         if (this.state.status === "ready")
             return;
@@ -28,117 +87,170 @@ export class CamoufoxClient {
             await this.awaitWithSignal(this.state.launchPromise, signal);
             return;
         }
-        const launchPromise = this.doLaunch();
+        const spanId = newSpanId();
+        const launchPromise = this.doLaunch(spanId);
         this.state = { status: "launching", launchPromise };
         await this.awaitWithSignal(launchPromise, signal);
     }
     async fetchUrl(url, opts) {
-        await this.ensureReady(opts.signal);
-        if (opts.timeoutMs !== undefined &&
-            (!Number.isInteger(opts.timeoutMs) || opts.timeoutMs < 1_000 || opts.timeoutMs > 120_000)) {
-            throw new CamoufoxErrorBox({
-                type: "config_invalid",
-                field: "timeoutMs",
-                reason: `must be integer in [1000, 120000], got ${opts.timeoutMs}`,
-            });
-        }
-        if (opts.maxBytes !== undefined &&
-            (!Number.isInteger(opts.maxBytes) || opts.maxBytes < 1_024 || opts.maxBytes > 52_428_800)) {
-            throw new CamoufoxErrorBox({
-                type: "config_invalid",
-                field: "maxBytes",
-                reason: `must be integer in [1024, 52428800], got ${opts.maxBytes}`,
-            });
-        }
-        try {
-            await assertSafeTarget(url, this.ssrfLookup ? { lookup: this.ssrfLookup } : {});
-        }
-        catch (err) {
-            throw new CamoufoxErrorBox({
-                type: "config_invalid",
-                field: "url",
-                reason: err instanceof Error ? err.message : String(err),
-            });
-        }
-        const navOpts = {
-            signal: opts.signal,
-            timeoutMs: opts.timeoutMs ?? this.config.timeoutMs,
-            waitUntil: "load",
-        };
-        if (opts.isolate !== undefined)
-            navOpts.isolate = opts.isolate;
-        const { page, response, cleanup } = await this.navigate(url, navOpts);
+        const spanId = newSpanId();
+        const started = Date.now();
         try {
-            const rawHtml = await page.content();
-            const maxBytes = opts.maxBytes ?? this.config.maxBytes;
-            const rawBytes = Buffer.byteLength(rawHtml, "utf8");
-            let html = rawHtml;
-            let bytes = rawBytes;
-            let truncated = false;
-            if (rawBytes > maxBytes) {
-                const buf = Buffer.from(rawHtml, "utf8");
-                html = buf.subarray(0, maxBytes).toString("utf8");
-                bytes = Buffer.byteLength(html, "utf8");
-                truncated = true;
+            await this.ensureReady(opts.signal);
+            if (opts.timeoutMs !== undefined &&
+                (!Number.isInteger(opts.timeoutMs) || opts.timeoutMs < 1_000 || opts.timeoutMs > 120_000)) {
+                throw new CamoufoxErrorBox({
+                    type: "config_invalid",
+                    field: "timeoutMs",
+                    reason: `must be integer in [1000, 120000], got ${opts.timeoutMs}`,
+                });
             }
-            return { html, status: response.status(), finalUrl: response.url(), bytes, truncated };
-        }
-        catch (err) {
-            if (opts.signal.aborted) {
-                throw new CamoufoxErrorBox({ type: "aborted" });
+            if (opts.maxBytes !== undefined &&
+                (!Number.isInteger(opts.maxBytes) || opts.maxBytes < 1_024 || opts.maxBytes > 52_428_800)) {
+                throw new CamoufoxErrorBox({
+                    type: "config_invalid",
+                    field: "maxBytes",
+                    reason: `must be integer in [1024, 52428800], got ${opts.maxBytes}`,
+                });
             }
-            if (err instanceof CamoufoxErrorBox)
+            try {
+                await assertSafeTarget(url, this.ssrfLookup ? { lookup: this.ssrfLookup } : {});
+            }
+            catch (err) {
+                throw new CamoufoxErrorBox({
+                    type: "config_invalid",
+                    field: "url",
+                    reason: err instanceof Error ? err.message : String(err),
+                });
+            }
+            const navOpts = {
+                signal: opts.signal,
+                timeoutMs: opts.timeoutMs ?? this.config.timeoutMs,
+                waitUntil: "load",
+            };
+            if (opts.isolate !== undefined)
+                navOpts.isolate = opts.isolate;
+            const { page, response, cleanup } = await this.navigate(url, navOpts);
+            try {
+                const rawHtml = await page.content();
+                const maxBytes = opts.maxBytes ?? this.config.maxBytes;
+                const rawBytes = Buffer.byteLength(rawHtml, "utf8");
+                let html = rawHtml;
+                let bytes = rawBytes;
+                let truncated = false;
+                if (rawBytes > maxBytes) {
+                    const buf = Buffer.from(rawHtml, "utf8");
+                    html = buf.subarray(0, maxBytes).toString("utf8");
+                    bytes = Buffer.byteLength(html, "utf8");
+                    truncated = true;
+                }
+                const result = {
+                    html,
+                    status: response.status(),
+                    finalUrl: response.url(),
+                    bytes,
+                    truncated,
+                };
+                this.events.emit("fetch_url", {
+                    spanId,
+                    url,
+                    finalUrl: result.finalUrl,
+                    status: result.status,
+                    bytes: result.bytes,
+                    truncated: result.truncated,
+                    isolate: opts.isolate ?? false,
+                    durationMs: Date.now() - started,
+                });
+                return result;
+            }
+            catch (err) {
+                if (opts.signal.aborted) {
+                    throw new CamoufoxErrorBox({ type: "aborted" });
+                }
+                if (err instanceof CamoufoxErrorBox)
+                    throw err;
                 throw err;
-            throw err;
+            }
+            finally {
+                cleanup();
+                await page.close().catch(() => undefined);
+            }
         }
-        finally {
-            cleanup();
-            await page.close().catch(() => undefined);
+        catch (err) {
+            this.emitError(spanId, "fetchUrl", err);
+            throw err;
         }
     }
     async search(query, opts) {
-        await this.ensureReady(opts.signal);
-        const maxResults = opts.maxResults ?? 10;
-        if (!Number.isInteger(maxResults) || maxResults < 1 || maxResults > 50) {
-            throw new CamoufoxErrorBox({
-                type: "config_invalid",
-                field: "maxResults",
-                reason: `must be integer in [1, 50], got ${maxResults}`,
-            });
-        }
-        if (opts.timeoutMs !== undefined &&
-            (!Number.isInteger(opts.timeoutMs) || opts.timeoutMs < 1_000 || opts.timeoutMs > 120_000)) {
-            throw new CamoufoxErrorBox({
-                type: "config_invalid",
-                field: "timeoutMs",
-                reason: `must be integer in [1000, 120000], got ${opts.timeoutMs}`,
-            });
-        }
-        const adapter = duckduckgoAdapter;
-        const url = adapter.buildUrl(query);
-        const navOpts = {
-            signal: opts.signal,
-            timeoutMs: opts.timeoutMs ?? this.config.timeoutMs,
-            waitUntil: adapter.waitStrategy.readyState,
-        };
-        if (opts.isolate !== undefined)
-            navOpts.isolate = opts.isolate;
-        const { page, cleanup } = await this.navigate(url, navOpts);
+        const spanId = newSpanId();
+        const started = Date.now();
         try {
-            const results = await adapter.parseResults(page, maxResults);
-            return { results, engine: "duckduckgo", query };
-        }
-        catch (err) {
-            if (opts.signal.aborted) {
-                throw new CamoufoxErrorBox({ type: "aborted" });
+            await this.ensureReady(opts.signal);
+            const maxResults = opts.maxResults ?? 10;
+            if (!Number.isInteger(maxResults) || maxResults < 1 || maxResults > 50) {
+                throw new CamoufoxErrorBox({
+                    type: "config_invalid",
+                    field: "maxResults",
+                    reason: `must be integer in [1, 50], got ${maxResults}`,
+                });
             }
-            if (err instanceof CamoufoxErrorBox)
+            if (opts.timeoutMs !== undefined &&
+                (!Number.isInteger(opts.timeoutMs) || opts.timeoutMs < 1_000 || opts.timeoutMs > 120_000)) {
+                throw new CamoufoxErrorBox({
+                    type: "config_invalid",
+                    field: "timeoutMs",
+                    reason: `must be integer in [1000, 120000], got ${opts.timeoutMs}`,
+                });
+            }
+            const adapter = duckduckgoAdapter;
+            const url = adapter.buildUrl(query);
+            try {
+                await assertSafeTarget(url, this.ssrfLookup ? { lookup: this.ssrfLookup } : {});
+            }
+            catch (err) {
+                throw new CamoufoxErrorBox({
+                    type: "config_invalid",
+                    field: "url",
+                    reason: err instanceof Error ? err.message : String(err),
+                });
+            }
+            const navOpts = {
+                signal: opts.signal,
+                timeoutMs: opts.timeoutMs ?? this.config.timeoutMs,
+                waitUntil: adapter.waitStrategy.readyState,
+            };
+            if (opts.isolate !== undefined)
+                navOpts.isolate = opts.isolate;
+            const { page, cleanup } = await this.navigate(url, navOpts);
+            try {
+                const results = await adapter.parseResults(page, maxResults);
+                this.events.emit("search", {
+                    spanId,
+                    engine: "duckduckgo",
+                    query,
+                    maxResults,
+                    durationMs: Date.now() - started,
+                    resultCount: results.length,
+                    atLimit: results.length === maxResults,
+                });
+                return { results, engine: "duckduckgo", query };
+            }
+            catch (err) {
+                if (opts.signal.aborted) {
+                    throw new CamoufoxErrorBox({ type: "aborted" });
+                }
+                if (err instanceof CamoufoxErrorBox)
+                    throw err;
                 throw err;
-            throw err;
+            }
+            finally {
+                cleanup();
+                await page.close().catch(() => undefined);
+            }
         }
-        finally {
-            cleanup();
-            await page.close().catch(() => undefined);
+        catch (err) {
+            this.emitError(spanId, "search", err);
+            throw err;
         }
     }
     async navigate(url, opts) {
@@ -231,25 +343,43 @@ export class CamoufoxClient {
         }
         return this.state.browser;
     }
-    async doLaunch() {
+    async doLaunch(spanId) {
+        const started = Date.now();
         try {
-            const { browser, context, version } = await this.launcher.launch();
+            const { browser, context, version } = await this.launcher.launch({
+                onProgress: (e) => this.events.emit("binary_download_progress", e),
+            });
             // If close() was called while we were launching, tear down the fresh
             // browser instead of resurrecting into ready. Leaves state as "closed".
             if (this.state.status !== "launching") {
                 await browser.close().catch(() => undefined);
                 return;
             }
-            this.state = { status: "ready", browser, context, version };
+            this.state = {
+                status: "ready",
+                browser,
+                context,
+                version,
+                launchedAt: Date.now(),
+            };
+            const payload = {
+                spanId,
+                browserVersion: version,
+                durationMs: Date.now() - started,
+            };
+            this.events.emit("browser_launch", payload);
         }
         catch (err) {
             const stderr = err instanceof Error ? err.message : String(err);
-            const boxed = new CamoufoxErrorBox({ type: "browser_launch_failed", stderr });
-            // If close() was called during the failed launch, keep the closed state
-            // (don't overwrite it with failed — closed is terminal).
+            const camErr = { type: "browser_launch_failed", stderr };
+            const boxed = new CamoufoxErrorBox(camErr);
+            // If close() was called during the failed launch, keep the closed
+            // state (don't overwrite it with failed — closed is terminal).
             if (this.state.status === "launching") {
                 this.state = { status: "failed", error: boxed };
             }
+            const errPayload = { spanId, op: "ensureReady", error: camErr };
+            this.events.emit("error", errPayload);
             throw boxed;
         }
     }

package/dist/client/camoufox-client.js.map

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

package/dist/client/create-client.d.ts

@@ -0,0 +1,21 @@
+import type { LookupFn } from "../security/ssrf.js";
+import type { CamoufoxConfig } from "../types.js";
+import { CamoufoxClient } from "./camoufox-client.js";
+import { type Launcher } from "./launcher.js";
+export interface CreateClientOptions {
+    readonly config?: Partial<CamoufoxConfig>;
+    readonly launcher?: Launcher;
+    /** Optional DNS lookup override; forwarded to CamoufoxClient for test injection. */
+    readonly ssrfLookup?: LookupFn;
+}
+/**
+ * Factory for library-mode consumers. Constructs a CamoufoxClient with
+ * either an injected launcher or a RealLauncher, shallow-merges config
+ * over DEFAULT_CONFIG, and fires ensureReady() in the background. First op
+ * awaits the in-flight launch promise via ensureReady.
+ *
+ * Returns synchronously. Factory caller that wants eager behavior writes
+ * `const c = createClient(); await c.ensureReady();` — one explicit line.
+ */
+export declare function createClient(opts?: CreateClientOptions): CamoufoxClient;
+//# sourceMappingURL=create-client.d.ts.map

package/dist/client/create-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/client/create-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,cAAc,CAW3E"}

package/dist/client/create-client.js

@@ -0,0 +1,25 @@
+import { DEFAULT_CONFIG } from "../types.js";
+import { CamoufoxClient } from "./camoufox-client.js";
+import { RealLauncher } from "./launcher.js";
+/**
+ * Factory for library-mode consumers. Constructs a CamoufoxClient with
+ * either an injected launcher or a RealLauncher, shallow-merges config
+ * over DEFAULT_CONFIG, and fires ensureReady() in the background. First op
+ * awaits the in-flight launch promise via ensureReady.
+ *
+ * Returns synchronously. Factory caller that wants eager behavior writes
+ * `const c = createClient(); await c.ensureReady();` — one explicit line.
+ */
+export function createClient(opts = {}) {
+    const launcher = opts.launcher ?? new RealLauncher();
+    const config = { ...DEFAULT_CONFIG, ...opts.config };
+    const client = new CamoufoxClient({
+        launcher,
+        config,
+        ...(opts.ssrfLookup !== undefined ? { ssrfLookup: opts.ssrfLookup } : {}),
+    });
+    // Fire-and-forget: first op awaits the in-flight promise via ensureReady.
+    client.ensureReady().catch(() => undefined);
+    return client;
+}
+//# sourceMappingURL=create-client.js.map

package/dist/client/create-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../../src/client/create-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAiB,YAAY,EAAE,MAAM,eAAe,CAAC;AAS5D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,YAAY,EAAE,CAAC;IACrD,MAAM,MAAM,GAAmB,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QACjC,QAAQ;QACR,MAAM;QACN,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,0EAA0E;IAC1E,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AACf,CAAC"}