@fusengine/browser-mcp 0.1.0

package/dist/extraction/prices.js

@@ -0,0 +1,74 @@
+const AMOUNT = "([0-9][0-9'’.,]*)";
+/** [currency code, regex prefix alternative]. Order matters: generic $ goes last. */
+const CURRENCY_PREFIXES = [
+    ["CHF", "CHF|Fr\\.?|SFr\\.?"],
+    ["CAD", "CAD|CA\\$|C\\$"],
+    ["AUD", "AUD|A\\$"],
+    ["NZD", "NZD|NZ\\$"],
+    ["SGD", "SGD|S\\$"],
+    ["HKD", "HKD|HK\\$"],
+    ["BRL", "BRL|R\\$"],
+    ["MXN", "MXN|Mex\\$"],
+    ["GBP", "GBP|£"],
+    ["EUR", "EUR|€"],
+    ["JPY", "JPY|¥"],
+    ["CNY", "CNY|CN¥|RMB|元"],
+    ["KRW", "KRW|₩"],
+    ["INR", "INR|₹"],
+    ["AED", "AED|د\\.إ"],
+    ["SAR", "SAR|ر\\.س"],
+    ["NOK", "NOK|kr"],
+    ["SEK", "SEK|kr"],
+    ["DKK", "DKK|kr"],
+    ["PLN", "PLN|zł"],
+    ["CZK", "CZK|Kč"],
+    ["ILS", "ILS|₪"],
+    ["ZAR", "ZAR|(?<![A-Za-z])R"],
+    ["USD", "USD|US\\$|\\$"],
+];
+const PATTERNS = CURRENCY_PREFIXES.map(([currency, prefix]) => [
+    currency,
+    new RegExp(`(?:${prefix})\\s*${AMOUNT}`, "gi"),
+]);
+const SKIP_WORDS = ["restaurant", "parking", "breakfast", "déjeuner"];
+/** Normalize a raw amount: float when it has decimals, otherwise integer (separators stripped). */
+export function normaliseAmount(raw) {
+    const cleaned = raw.replace(/['’]/g, "");
+    if (/[.,]\d{2}$/.test(cleaned))
+        return Number(cleaned.replace(/,/g, ""));
+    return Number(cleaned.replace(/,/g, "").replace(/\./g, ""));
+}
+/**
+ * Extract visible prices, skipping ranges (e.g. "20–30") and irrelevant lines
+ * (restaurant, parking…). Deduplicates by currency+amount.
+ */
+export function extractPrices(text) {
+    const prices = [];
+    const seen = new Set();
+    const lines = text.split("\n");
+    lines.forEach((line, lineNo) => {
+        if ((line.includes("–") || line.includes("-")) && /\d\s*[-–]\s*\d/.test(line))
+            return;
+        const lowered = line.toLowerCase();
+        if (SKIP_WORDS.some((w) => lowered.includes(w)))
+            return;
+        for (const [currency, pattern] of PATTERNS) {
+            for (const match of line.matchAll(pattern)) {
+                const amount = normaliseAmount(match[1]);
+                const key = `${currency}:${amount}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                prices.push({ currency, amount, line: line.trim(), lineNo });
+            }
+        }
+    });
+    return prices;
+}
+/** First price of a line, or null. */
+export function parseSinglePrice(line) {
+    const prices = extractPrices(line);
+    const first = prices[0];
+    return first ? { currency: first.currency, amount: first.amount } : null;
+}
+//# sourceMappingURL=prices.js.map

package/dist/extraction/prices.js.map

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

package/dist/extraction/snapshot-diff.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Diff two interactive snapshots to report what changed after an action,
+ * so an agent sees the *effect* of its action without a full re-snapshot.
+ * Pure and testable (no browser).
+ * @module extraction/snapshot-diff
+ */
+import type { InteractiveElement } from "../interfaces/extraction.js";
+/** A ref whose visible text changed between two snapshots. */
+export interface TextChange {
+    index: number;
+    before: string;
+    after: string;
+}
+/** Summary of what changed between a before/after snapshot pair. */
+export interface SnapshotDiff {
+    added: InteractiveElement[];
+    removed: InteractiveElement[];
+    textChanged: TextChange[];
+    urlChanged: boolean;
+    changed: boolean;
+}
+/**
+ * Compute the diff between `before` and `after` snapshots. Add/remove AND text
+ * changes are matched by the structural key (not the positional index), so the
+ * result stays correct when the DOM reorders.
+ */
+export declare function diffSnapshots(before: InteractiveElement[], after: InteractiveElement[], urlChanged?: boolean): SnapshotDiff;
+//# sourceMappingURL=snapshot-diff.d.ts.map

package/dist/extraction/snapshot-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-diff.d.ts","sourceRoot":"","sources":["../../src/extraction/snapshot-diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAAE,EAC5B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,UAAU,UAAQ,GACjB,YAAY,CAiBd"}

package/dist/extraction/snapshot-diff.js

@@ -0,0 +1,30 @@
+/**
+ * Structural identity key, excluding `text` and the volatile positional
+ * `index`. A pure text change keeps the same key, so it surfaces via
+ * `textChanged` (matched on this key too) rather than as a false add+remove,
+ * and reordered elements no longer produce spurious text diffs.
+ */
+function keyOf(el) {
+    return `${el.tag}#${el.id ?? ""}|${el.name ?? ""}|${el.href ?? ""}|${el.type ?? ""}`;
+}
+/**
+ * Compute the diff between `before` and `after` snapshots. Add/remove AND text
+ * changes are matched by the structural key (not the positional index), so the
+ * result stays correct when the DOM reorders.
+ */
+export function diffSnapshots(before, after, urlChanged = false) {
+    const beforeByKey = new Map(before.map((el) => [keyOf(el), el]));
+    const afterByKey = new Map(after.map((el) => [keyOf(el), el]));
+    const added = after.filter((el) => !beforeByKey.has(keyOf(el)));
+    const removed = before.filter((el) => !afterByKey.has(keyOf(el)));
+    const textChanged = [];
+    for (const [key, el] of afterByKey) {
+        const prev = beforeByKey.get(key);
+        if (prev && prev.text !== el.text) {
+            textChanged.push({ index: el.index, before: prev.text, after: el.text });
+        }
+    }
+    const changed = urlChanged || added.length > 0 || removed.length > 0 || textChanged.length > 0;
+    return { added, removed, textChanged, urlChanged, changed };
+}
+//# sourceMappingURL=snapshot-diff.js.map

package/dist/extraction/snapshot-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-diff.js","sourceRoot":"","sources":["../../src/extraction/snapshot-diff.ts"],"names":[],"mappings":"AAwBA;;;;;GAKG;AACH,SAAS,KAAK,CAAC,EAAsB;IACnC,OAAO,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA4B,EAC5B,KAA2B,EAC3B,UAAU,GAAG,KAAK;IAElB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAElE,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;YAClC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GACX,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/dist/extraction/snapshot.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Accessibility-style snapshot: tag each interactive element with a stable
+ * `data-fuse-ref` and return an indexed list the LLM can reason about.
+ * The ref survives until the page re-renders, enabling deterministic
+ * `browser_act` targeting via `[data-fuse-ref="N"]`.
+ * @module extraction/snapshot
+ */
+import type { Page } from "playwright";
+import type { InteractiveElement } from "../interfaces/extraction.js";
+/** Attribute injected on each interactive element to anchor a stable ref. */
+export declare const REF_ATTRIBUTE = "data-fuse-ref";
+/** Capture the indexed interactive snapshot, tagging each element with a ref. */
+export declare function captureSnapshot(page: Page): Promise<InteractiveElement[]>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/extraction/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/extraction/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,6EAA6E;AAC7E,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAqB7C,iFAAiF;AACjF,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/E"}

package/dist/extraction/snapshot.js

@@ -0,0 +1,26 @@
+import { evalScript } from "../lib/evaluate.js";
+/** Attribute injected on each interactive element to anchor a stable ref. */
+export const REF_ATTRIBUTE = "data-fuse-ref";
+const SNAPSHOT_SCRIPT = `() => [...document.querySelectorAll('button,a,input,select,textarea,[role=button]')]
+  .slice(0, 120)
+  .map((el, index) => {
+    el.setAttribute('${REF_ATTRIBUTE}', String(index));
+    const rect = el.getBoundingClientRect();
+    return {
+      index,
+      tag: el.tagName.toLowerCase(),
+      text: (el.innerText || el.value || el.getAttribute('aria-label') || el.getAttribute('placeholder') || '').trim().slice(0, 120),
+      role: el.getAttribute('role'),
+      id: el.id || null,
+      name: el.getAttribute('name'),
+      type: el.getAttribute('type'),
+      href: el.getAttribute('href'),
+      visible: rect.width > 0 && rect.height > 0,
+      box: {x: Math.round(rect.x), y: Math.round(rect.y), width: Math.round(rect.width), height: Math.round(rect.height)}
+    };
+  })`;
+/** Capture the indexed interactive snapshot, tagging each element with a ref. */
+export async function captureSnapshot(page) {
+    return evalScript(page, SNAPSHOT_SCRIPT);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/extraction/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/extraction/snapshot.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C,MAAM,eAAe,GAAG;;;uBAGD,aAAa;;;;;;;;;;;;;;KAc/B,CAAC;AAEN,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,OAAO,UAAU,CAAuB,IAAI,EAAE,eAAe,CAAC,CAAC;AACjE,CAAC"}

package/dist/extraction/structured.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Schema-based structured extraction: the caller provides a field map
+ * (field -> { selector, attr?, all?, abs? }) and gets typed data pulled from
+ * the live DOM. Deterministic, no LLM. Works on Next.js/SPA pages because it
+ * reads the rendered DOM after hydration, not the HTML source.
+ * @module extraction/structured
+ */
+import type { Page } from "playwright";
+/** How to extract one field from the page. */
+export interface FieldSpec {
+    /** CSS selector to locate the element(s). */
+    selector: string;
+    /** Attribute to read; omit to read trimmed innerText. */
+    attr?: string;
+    /** When true, return an array from querySelectorAll instead of the first match. */
+    all?: boolean;
+    /** When true, read the IDL property (e.g. el.href) for absolute URLs. */
+    abs?: boolean;
+}
+/** A field map: result key -> extraction spec. */
+export type ExtractionSchema = Record<string, FieldSpec>;
+/** Extracted value: string, null, or an array thereof. */
+export type ExtractedValue = string | null | Array<string | null>;
+/** Read `schema` fields from the page's live DOM into a typed record. */
+export declare function extractStructured(page: Page, schema: ExtractionSchema): Promise<Record<string, ExtractedValue>>;
+//# sourceMappingURL=structured.d.ts.map

package/dist/extraction/structured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.d.ts","sourceRoot":"","sources":["../../src/extraction/structured.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yEAAyE;IACzE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAyBlE,yEAAyE;AACzE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAEzC"}

package/dist/extraction/structured.js

@@ -0,0 +1,28 @@
+import { evalScriptArg } from "../lib/evaluate.js";
+// Browser-side reader. `selector` is passed as data (no string interpolation),
+// so it cannot inject code; an invalid selector throws and is caught per field.
+const READ_SCRIPT = `(fields) => {
+  const read = (el, f) => {
+    if (!el) return null;
+    if (f.abs && f.attr) return el[f.attr] ?? null;
+    if (f.attr) return el.getAttribute(f.attr);
+    return (el.innerText || '').trim() || null;
+  };
+  const out = {};
+  for (const key in fields) {
+    const f = fields[key];
+    try {
+      out[key] = f.all
+        ? [...document.querySelectorAll(f.selector)].map((el) => read(el, f))
+        : read(document.querySelector(f.selector), f);
+    } catch {
+      out[key] = null;
+    }
+  }
+  return out;
+}`;
+/** Read `schema` fields from the page's live DOM into a typed record. */
+export async function extractStructured(page, schema) {
+    return evalScriptArg(page, READ_SCRIPT, schema);
+}
+//# sourceMappingURL=structured.js.map

package/dist/extraction/structured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../src/extraction/structured.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAoBnD,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;EAmBlB,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAU,EACV,MAAwB;IAExB,OAAO,aAAa,CAAmD,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACpG,CAAC"}

package/dist/extraction/visual.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Visual observation: interactive elements with positions + viewport.
+ * @module extraction/visual
+ */
+import type { Page } from "playwright";
+import type { Visual } from "../interfaces/extraction.js";
+/** Capture the list of visible interactive elements and their boxes. */
+export declare function visualObservation(page: Page, screenshotPath: string): Promise<Visual>;
+//# sourceMappingURL=visual.d.ts.map

package/dist/extraction/visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../../src/extraction/visual.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EAAsB,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAqB9E,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO3F"}

package/dist/extraction/visual.js

@@ -0,0 +1,29 @@
+import { VIEWPORT } from "../engine/context.js";
+import { evalScript } from "../lib/evaluate.js";
+const INTERACTIVE_SCRIPT = `() => [...document.querySelectorAll('button,a,input,select,textarea,[role=button]')]
+  .slice(0, 80)
+  .map((el, index) => {
+    const rect = el.getBoundingClientRect();
+    return {
+      index,
+      tag: el.tagName.toLowerCase(),
+      text: (el.innerText || el.value || el.getAttribute('aria-label') || '').trim(),
+      role: el.getAttribute('role'),
+      id: el.id || null,
+      name: el.getAttribute('name'),
+      type: el.getAttribute('type'),
+      href: el.getAttribute('href'),
+      visible: rect.width > 0 && rect.height > 0,
+      box: {x: Math.round(rect.x), y: Math.round(rect.y), width: Math.round(rect.width), height: Math.round(rect.height)}
+    };
+  })`;
+/** Capture the list of visible interactive elements and their boxes. */
+export async function visualObservation(page, screenshotPath) {
+    const interactiveElements = await evalScript(page, INTERACTIVE_SCRIPT);
+    return {
+        screenshotPath,
+        viewport: { ...VIEWPORT },
+        interactiveElements,
+    };
+}
+//# sourceMappingURL=visual.js.map

package/dist/extraction/visual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.js","sourceRoot":"","sources":["../../src/extraction/visual.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;KAgBtB,CAAC;AAEN,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,cAAsB;IACxE,MAAM,mBAAmB,GAAG,MAAM,UAAU,CAAuB,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC7F,OAAO;QACL,cAAc;QACd,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE;QACzB,mBAAmB;KACpB,CAAC;AACJ,CAAC"}

package/dist/guardrails/preflight.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Guardrails: block irreversible actions without human approval.
+ * @module guardrails/preflight
+ */
+/** Words that trigger a human-approval requirement (payment/booking). */
+export declare const SENSITIVE_WORDS: RegExp;
+/** Result of the actions preflight. */
+export interface PreflightResult {
+    allowed: boolean;
+    reason: string;
+    blockedActions: string[];
+}
+/** Minimal shape of an action evaluated by the preflight. */
+type ActionLike = {
+    type?: string;
+    target?: string;
+    text?: string;
+} & Record<string, unknown>;
+/**
+ * Check the actions: if one targets a sensitive operation and no human approval
+ * is provided, deny execution.
+ */
+export declare function preflight(actions: ActionLike[], humanApproved: boolean): PreflightResult;
+export {};
+//# sourceMappingURL=preflight.d.ts.map

package/dist/guardrails/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/guardrails/preflight.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AACzE,eAAO,MAAM,eAAe,QAC2G,CAAC;AAExI,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,6DAA6D;AAC7D,KAAK,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAM9F;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,OAAO,GAAG,eAAe,CAWxF"}

package/dist/guardrails/preflight.js

@@ -0,0 +1,27 @@
+/**
+ * Guardrails: block irreversible actions without human approval.
+ * @module guardrails/preflight
+ */
+/** Words that trigger a human-approval requirement (payment/booking). */
+export const SENSITIVE_WORDS = /\b(pay|payment|checkout|card|book|booking|reserve|reservation|confirm|ticket|purchase|acheter|payer|réserver|reserver|confirmer)\b/i;
+function targetOf(action) {
+    return String(action.target ?? action.text ?? JSON.stringify(action));
+}
+/**
+ * Check the actions: if one targets a sensitive operation and no human approval
+ * is provided, deny execution.
+ */
+export function preflight(actions, humanApproved) {
+    const blocked = [];
+    for (const action of actions) {
+        const target = targetOf(action);
+        const haystack = `${action.type ?? ""} ${target}`;
+        if (SENSITIVE_WORDS.test(haystack))
+            blocked.push(target);
+    }
+    if (blocked.length > 0 && !humanApproved) {
+        return { allowed: false, reason: "human_approval_required", blockedActions: blocked };
+    }
+    return { allowed: true, reason: "ok", blockedActions: [] };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/guardrails/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/guardrails/preflight.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAC1B,qIAAqI,CAAC;AAYxI,SAAS,QAAQ,CAAC,MAAkB;IAClC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAqB,EAAE,aAAsB;IACrE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAClD,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC"}

package/dist/identity/country-profiles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Profils d'identité par pays : locale, devise, fuseau, géoloc, Accept-Language.
+ * @module identity/country-profiles
+ */
+import type { CountryProfile } from "../interfaces/types.js";
+/** User-agent desktop réaliste (Chrome stable). */
+export declare const REALISTIC_DESKTOP_UA: string;
+/** Profils indexés par code pays (majuscules). */
+export declare const COUNTRY_PROFILES: Record<string, CountryProfile>;
+/** Inverse locale -> code pays (pour inférer le pays depuis une locale). */
+export declare const LOCALE_COUNTRY_HINTS: Record<string, string>;
+//# sourceMappingURL=country-profiles.d.ts.map

package/dist/identity/country-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"country-profiles.d.ts","sourceRoot":"","sources":["../../src/identity/country-profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,QAGC,CAAC;AAwDnC,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAE3D,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEvD,CAAC"}

package/dist/identity/country-profiles.js

@@ -0,0 +1,58 @@
+/** User-agent desktop réaliste (Chrome stable). */
+export const REALISTIC_DESKTOP_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " +
+    "AppleWebKit/537.36 (KHTML, like Gecko) " +
+    "Chrome/125.0.0.0 Safari/537.36";
+const ROWS = [
+    ["CH", "fr-CH", "CHF", "Europe/Zurich", 46.5197, 6.6323],
+    ["US", "en-US", "USD", "America/New_York", 40.7128, -74.006, "en-US,en;q=0.9"],
+    ["GB", "en-GB", "GBP", "Europe/London", 51.5074, -0.1278, "en-GB,en;q=0.9"],
+    ["UK", "en-GB", "GBP", "Europe/London", 51.5074, -0.1278, "en-GB,en;q=0.9"],
+    ["FR", "fr-FR", "EUR", "Europe/Paris", 48.8566, 2.3522],
+    ["DE", "de-DE", "EUR", "Europe/Berlin", 52.52, 13.405],
+    ["IT", "it-IT", "EUR", "Europe/Rome", 41.9028, 12.4964],
+    ["ES", "es-ES", "EUR", "Europe/Madrid", 40.4168, -3.7038],
+    ["PT", "pt-PT", "EUR", "Europe/Lisbon", 38.7223, -9.1393],
+    ["NL", "nl-NL", "EUR", "Europe/Amsterdam", 52.3676, 4.9041],
+    ["BE", "fr-BE", "EUR", "Europe/Brussels", 50.8503, 4.3517],
+    ["AT", "de-AT", "EUR", "Europe/Vienna", 48.2082, 16.3738],
+    ["IE", "en-IE", "EUR", "Europe/Dublin", 53.3498, -6.2603],
+    ["LU", "fr-LU", "EUR", "Europe/Luxembourg", 49.6116, 6.1319],
+    ["NO", "nb-NO", "NOK", "Europe/Oslo", 59.9139, 10.7522],
+    ["SE", "sv-SE", "SEK", "Europe/Stockholm", 59.3293, 18.0686],
+    ["DK", "da-DK", "DKK", "Europe/Copenhagen", 55.6761, 12.5683],
+    ["PL", "pl-PL", "PLN", "Europe/Warsaw", 52.2297, 21.0122],
+    ["CZ", "cs-CZ", "CZK", "Europe/Prague", 50.0755, 14.4378],
+    ["CA", "en-CA", "CAD", "America/Toronto", 43.6532, -79.3832, "en-CA,en;q=0.9,fr;q=0.8"],
+    ["MX", "es-MX", "MXN", "America/Mexico_City", 19.4326, -99.1332],
+    ["BR", "pt-BR", "BRL", "America/Sao_Paulo", -23.5505, -46.6333],
+    ["AR", "es-AR", "ARS", "America/Argentina/Buenos_Aires", -34.6037, -58.3816],
+    ["CL", "es-CL", "CLP", "America/Santiago", -33.4489, -70.6693],
+    ["CO", "es-CO", "COP", "America/Bogota", 4.711, -74.0721],
+    ["AU", "en-AU", "AUD", "Australia/Sydney", -33.8688, 151.2093, "en-AU,en;q=0.9"],
+    ["NZ", "en-NZ", "NZD", "Pacific/Auckland", -36.8509, 174.7645, "en-NZ,en;q=0.9"],
+    ["JP", "ja-JP", "JPY", "Asia/Tokyo", 35.6762, 139.6503],
+    ["KR", "ko-KR", "KRW", "Asia/Seoul", 37.5665, 126.978],
+    ["CN", "zh-CN", "CNY", "Asia/Shanghai", 31.2304, 121.4737],
+    ["HK", "zh-HK", "HKD", "Asia/Hong_Kong", 22.3193, 114.1694, "zh-HK,zh;q=0.9,en;q=0.8"],
+    ["SG", "en-SG", "SGD", "Asia/Singapore", 1.3521, 103.8198, "en-SG,en;q=0.9,zh;q=0.8"],
+    ["IN", "en-IN", "INR", "Asia/Kolkata", 28.6139, 77.209, "en-IN,en;q=0.9,hi;q=0.8"],
+    ["AE", "en-AE", "AED", "Asia/Dubai", 25.2048, 55.2708, "en-AE,en;q=0.9,ar;q=0.8"],
+    ["SA", "ar-SA", "SAR", "Asia/Riyadh", 24.7136, 46.6753],
+    ["IL", "he-IL", "ILS", "Asia/Jerusalem", 31.7683, 35.2137, "he-IL,he;q=0.9,en;q=0.8"],
+    ["ZA", "en-ZA", "ZAR", "Africa/Johannesburg", -26.2041, 28.0473, "en-ZA,en;q=0.9"],
+];
+function toProfile([, locale, currency, timezoneId, lat, lon, accept]) {
+    const primary = locale.split("-", 1)[0];
+    return {
+        locale,
+        currency,
+        timezoneId,
+        geolocation: { latitude: lat, longitude: lon },
+        acceptLanguage: accept ?? `${locale},${primary};q=0.9,en;q=0.8`,
+    };
+}
+/** Profils indexés par code pays (majuscules). */
+export const COUNTRY_PROFILES = Object.fromEntries(ROWS.map((row) => [row[0], toProfile(row)]));
+/** Inverse locale -> code pays (pour inférer le pays depuis une locale). */
+export const LOCALE_COUNTRY_HINTS = Object.fromEntries(Object.entries(COUNTRY_PROFILES).map(([code, p]) => [p.locale, code]));
+//# sourceMappingURL=country-profiles.js.map

package/dist/identity/country-profiles.js.map

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

package/dist/identity/identity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Construction du rapport d'identité + masquage des credentials proxy.
+ * @module identity/identity
+ */
+import type { Identity } from "../interfaces/report.js";
+import type { ResolvedIdentity } from "./resolve.js";
+/** Masque user:password dans une URL de proxy pour les rapports. */
+export declare function redactProxyUrl(proxyUrl: string | null | undefined): string | null;
+/** Entrée pour construire le rapport d'identité. */
+export interface IdentityInput {
+    identity: ResolvedIdentity;
+    realisticProfile: boolean;
+    userDataDir: string | null;
+    proxyUrl: string | null;
+    proxySource: string | null;
+}
+/** Assemble le rapport d'identité exposé dans les probes. */
+export declare function buildIdentity(input: IdentityInput): Identity;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/identity/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOjF;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAkB5D"}

package/dist/identity/identity.js

@@ -0,0 +1,31 @@
+/** Masque user:password dans une URL de proxy pour les rapports. */
+export function redactProxyUrl(proxyUrl) {
+    if (!proxyUrl || !proxyUrl.includes("@"))
+        return proxyUrl ?? null;
+    const [scheme, rest] = proxyUrl.includes("://")
+        ? proxyUrl.split("://", 2)
+        : ["", proxyUrl];
+    const host = rest.split("@").pop() ?? rest;
+    return scheme ? `${scheme}://***:***@${host}` : `***:***@${host}`;
+}
+/** Assemble le rapport d'identité exposé dans les probes. */
+export function buildIdentity(input) {
+    const { identity, proxyUrl, proxySource } = input;
+    return {
+        countryCode: identity.countryCode,
+        locale: identity.locale,
+        timezoneId: identity.timezoneId,
+        currency: identity.currency,
+        geolocation: identity.geolocation,
+        acceptLanguage: identity.acceptLanguage,
+        realisticProfile: input.realisticProfile,
+        persistentProfile: Boolean(input.userDataDir),
+        userDataDir: input.userDataDir,
+        proxyEnabled: Boolean(proxyUrl),
+        proxyUrl: redactProxyUrl(proxyUrl),
+        proxySource,
+        proxyCountryCode: proxySource === "country_map" ? identity.countryCode : null,
+        proxyRequiredForIpAlignment: proxyUrl === null,
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity/identity.ts"],"names":[],"mappings":"AAOA,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,IAAI,IAAI,CAAC;IAClE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC7C,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAsB;QAChD,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IAC3C,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;AACpE,CAAC;AAWD,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAClD,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;QAC7C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC/B,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;QAClC,WAAW;QACX,gBAAgB,EAAE,WAAW,KAAK,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;QAC7E,2BAA2B,EAAE,QAAQ,KAAK,IAAI;KAC/C,CAAC;AACJ,CAAC"}

package/dist/identity/resolve.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Résolution de l'identité navigateur depuis les options.
+ * @module identity/resolve
+ */
+import type { CountryProfile } from "../interfaces/types.js";
+/** Identité effective dérivée du pays + surcharges explicites. */
+export interface ResolvedIdentity {
+    countryCode: string;
+    locale: string;
+    timezoneId: string;
+    currency: string;
+    geolocation: CountryProfile["geolocation"];
+    acceptLanguage: string;
+}
+/**
+ * Dérive locale/devise/fuseau/géoloc à partir du pays (ou de la locale),
+ * en laissant les valeurs explicites surcharger le profil pays.
+ */
+export declare function resolveIdentity(opts: {
+    countryCode?: string;
+    locale?: string;
+    timezoneId?: string;
+    currency?: string;
+}): ResolvedIdentity;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/identity/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/identity/resolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;CACxB;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,gBAAgB,CAenB"}

package/dist/identity/resolve.js

@@ -0,0 +1,21 @@
+import { COUNTRY_PROFILES, LOCALE_COUNTRY_HINTS } from "./country-profiles.js";
+const DEFAULT = COUNTRY_PROFILES.CH;
+/**
+ * Dérive locale/devise/fuseau/géoloc à partir du pays (ou de la locale),
+ * en laissant les valeurs explicites surcharger le profil pays.
+ */
+export function resolveIdentity(opts) {
+    const inferred = (opts.countryCode ||
+        LOCALE_COUNTRY_HINTS[opts.locale ?? ""] ||
+        "CH").toUpperCase();
+    const profile = COUNTRY_PROFILES[inferred] ?? DEFAULT;
+    return {
+        countryCode: inferred,
+        locale: opts.locale || profile.locale,
+        timezoneId: opts.timezoneId || profile.timezoneId,
+        currency: (opts.currency || profile.currency).toUpperCase(),
+        geolocation: { ...profile.geolocation },
+        acceptLanguage: profile.acceptLanguage,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/identity/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/identity/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAY/E,MAAM,OAAO,GAAmB,gBAAgB,CAAC,EAAoB,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,MAAM,QAAQ,GAAG,CACf,IAAI,CAAC,WAAW;QAChB,oBAAoB,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACvC,IAAI,CACL,CAAC,WAAW,EAAE,CAAC;IAChB,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC;IACtD,OAAO;QACL,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;QACrC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU;QACjD,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;QAC3D,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE;QACvC,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public API of the fuse-browser package.
+ * @module index
+ */
+export { BrowserAgent } from "./agent/browser-agent.js";
+export { compactReport } from "./agent/compact.js";
+export { resolveConfig, type ResolvedConfig } from "./agent/config.js";
+export { createServer, type BuiltServer } from "./server/server.js";
+export { SessionManager } from "./session/manager.js";
+export type { ProbeReport } from "./interfaces/report.js";
+export type { AgentOptions, BrowserAction, ProbeOptions } from "./interfaces/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Public API of the fuse-browser package.
+ * @module index
+ */
+export { BrowserAgent } from "./agent/browser-agent.js";
+export { compactReport } from "./agent/compact.js";
+export { resolveConfig } from "./agent/config.js";
+export { createServer } from "./server/server.js";
+export { SessionManager } from "./session/manager.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}