@scalebun-release/web 2.2.2

package/dist/features/replay/engine/canvas.js

@@ -0,0 +1,122 @@
+/**
+ * CanvasRecorder — opt-in <canvas> pixel capture. The DOM serializer captures a <canvas> element but
+ * not its pixels (they live in a 2D/WebGL context), so canvases replay blank. This throttled loop
+ * snapshots each canvas to a compact image and emits an `op:'canvas'` delta keyed by the node id; the
+ * player draws it back. Off by default (pixels can't be masked) + a per-canvas blocklist.
+ *
+ * Handles BOTH 2D and WebGL/3D canvases: a WebGL canvas would normally read back blank from this async
+ * loop (`preserveDrawingBuffer:false` clears the buffer after compositing), so `webglPatch.ts` forces
+ * `preserveDrawingBuffer:true` at context creation — the same `drawImage`/`toDataURL` path then captures
+ * WebGL pixels unchanged. A tainted (cross-origin texture) canvas still throws → skipped.
+ *
+ * v1 encodes on the main thread (`toDataURL`), bounded by the fps throttle + downscale. Moving the
+ * encode into the RPL-WORKER (OffscreenCanvas.convertToBlob) is a follow-up.
+ */
+const BLOCK_ATTR = 'data-scalebun-block';
+export class CanvasRecorder {
+    constructor(reg, onMutations, log = () => { }, opts = {}) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        this.log = log;
+        this.timer = null;
+        this.last = new Map(); // id → last encoded (skip unchanged)
+        this.tainted = new Set(); // ids already logged as un-capturable
+        this.scratch = null;
+        this.intervalMs = Math.max(50, Math.round(1000 / (opts.fps ?? 3)));
+        this.maxDim = opts.maxDim ?? 1024;
+        this.quality = opts.quality ?? 0.6;
+        this.getDocs = opts.getDocs;
+    }
+    start() {
+        if (typeof document === 'undefined')
+            return;
+        this.capture(); // initial paint so frame 0 has content
+        this.timer = setInterval(() => this.capture(), this.intervalMs);
+    }
+    disconnect() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        this.last.clear();
+        this.tainted.clear(); // allow re-attempt on restart (a tainted canvas may have been replaced)
+        this.scratch = null; // release the downscale buffer
+    }
+    capture() {
+        const docs = this.getDocs
+            ? this.getDocs()
+            : typeof document !== 'undefined'
+                ? [document]
+                : [];
+        const muts = [];
+        const live = new Set(); // ids seen this tick — anything else no longer exists
+        for (const d of docs) {
+            let canvases;
+            try {
+                canvases = d.querySelectorAll('canvas');
+            }
+            catch {
+                continue; // sub-document became inaccessible — skip it, keep scanning the rest
+            }
+            canvases.forEach((c) => {
+                const id = this.reg.getId(c);
+                if (id == null)
+                    return; // not in the captured subtree
+                live.add(id); // exists, even if we skip capturing it below
+                if (c.hasAttribute(BLOCK_ATTR))
+                    return; // privacy blocklist
+                const w = c.width;
+                const h = c.height;
+                if (!w || !h)
+                    return;
+                let data;
+                try {
+                    data = this.encode(c, w, h);
+                }
+                catch {
+                    if (!this.tainted.has(id)) {
+                        this.tainted.add(id);
+                        this.log('[scalebun] canvas not capturable (tainted / cross-origin)');
+                    }
+                    return;
+                }
+                if (this.last.get(id) === data)
+                    return; // unchanged since last tick
+                this.last.set(id, data);
+                muts.push({ op: 'canvas', id, data, w, h });
+            });
+        }
+        // Prune state for canvases that no longer exist. `last` holds an encoded webp DATA URL per canvas
+        // and was only cleared on stop(), so it grew for every canvas the session ever saw — the largest
+        // retained-bytes leak in the engine. Pruning is free: this tick already enumerated the live set.
+        if (this.last.size > live.size) {
+            for (const id of this.last.keys())
+                if (!live.has(id))
+                    this.last.delete(id);
+        }
+        if (this.tainted.size) {
+            for (const id of this.tainted)
+                if (!live.has(id))
+                    this.tainted.delete(id);
+        }
+        if (muts.length)
+            this.onMutations(muts);
+    }
+    /** Encode to a (possibly downscaled) webp data URL. `w/h` stay the ORIGINAL dims so the player
+     *  redraws at full size. Throws (SecurityError) on a tainted canvas → caller skips. */
+    encode(c, w, h) {
+        const scale = Math.min(1, this.maxDim / Math.max(w, h));
+        if (scale < 1) {
+            const sc = (this.scratch ?? (this.scratch = document.createElement('canvas')));
+            sc.width = Math.max(1, Math.round(w * scale));
+            sc.height = Math.max(1, Math.round(h * scale));
+            const ctx = sc.getContext('2d');
+            if (!ctx)
+                throw new Error('no 2d context');
+            ctx.clearRect(0, 0, sc.width, sc.height);
+            ctx.drawImage(c, 0, 0, sc.width, sc.height); // taints sc if c is tainted → toDataURL throws
+            return sc.toDataURL('image/webp', this.quality);
+        }
+        return c.toDataURL('image/webp', this.quality);
+    }
+}
+//# sourceMappingURL=canvas.js.map

package/dist/features/replay/engine/canvas.js.map

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

package/dist/features/replay/engine/crossOrigin.d.ts

@@ -0,0 +1,23 @@
+import type { Mutation, SnapshotOptions } from './types.js';
+/**
+ * Run on the cross-origin CHILD page. Waits for a parent handshake from an allowed origin, then
+ * records this document (offset registry) and relays frames back. No-op when not framed. Returns a
+ * teardown. The child may still run its own SDK independently — this only adds the relay.
+ */
+export declare function installChildSatellite(allowedParentOrigins: string[], opts?: SnapshotOptions): () => void;
+export interface ParentBridgeDeps {
+    /** Disjoint node-id base for this child (e.g. iframeNodeId * 1_000_000). */
+    nodeIdBase: number;
+    /** Origins the child is allowed to be served from (validates inbound frames). */
+    allowedChildOrigins: string[];
+    /** Forward stitched ops onto the replay stream (same callback the same-origin path uses). */
+    emit: (mutations: Mutation[]) => void;
+}
+/**
+ * Bridge ONE cross-origin iframe: handshake the child, then forward its keyframe (as `op:'iframe'`
+ * referencing the iframe's node id) + its mutation deltas onto the replay stream. Returns teardown.
+ */
+export declare function bridgeCrossOriginFrame(iframe: HTMLIFrameElement, iframeNodeId: number, deps: ParentBridgeDeps): () => void;
+/** A disjoint id base for a child frame, keyed off the iframe's own node id. */
+export declare const nodeIdBaseFor: (iframeNodeId: number) => number;
+//# sourceMappingURL=crossOrigin.d.ts.map

package/dist/features/replay/engine/crossOrigin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossOrigin.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/crossOrigin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AASzD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,oBAAoB,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,MAAM,IAAI,CA8B5G;AAGD,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,6FAA6F;IAC7F,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,gBAAgB,GACrB,MAAM,IAAI,CAsCZ;AAED,gFAAgF;AAChF,eAAO,MAAM,aAAa,GAAI,cAAc,MAAM,KAAG,MAAkC,CAAC"}

package/dist/features/replay/engine/crossOrigin.js

@@ -0,0 +1,108 @@
+/**
+ * F-IFR Phase 2 — cross-origin iframe replay stitching. The parent can't read a cross-origin iframe's
+ * DOM, so the CHILD SDK (running on the other origin) volunteers its capture: it serializes its own
+ * document with an OFFSET node registry (disjoint id range → no collision with the parent) and relays
+ * frames to the parent via postMessage. The parent re-emits them through the SAME path as same-origin
+ * frames — `op:'iframe'` for the keyframe + the child's mutation ops as deltas — so the existing player
+ * stitches the sub-tree into the iframe placeholder with no new player code.
+ *
+ * Security: strict origin allowlists BOTH ways; the handshake carries no secrets (just a node-id base).
+ * Zero third-party deps. Mask-by-default still applies inside the child.
+ */
+import { NodeRegistry } from './nodeRegistry.js';
+import { serializeNode, resolveSnapshotOpts } from './snapshot.js';
+import { MutationRecorder } from './mutations.js';
+const INIT = 'scalebun:frame-init'; // parent → child
+const KEY = 'scalebun:frame-key'; // child → parent (serialized sub-document)
+const MUT = 'scalebun:frame-mut'; // child → parent (mutation ops)
+const originAllowed = (origin, allow) => allow.includes('*') || allow.includes(origin);
+// ── Child side ───────────────────────────────────────────────────────────────
+/**
+ * Run on the cross-origin CHILD page. Waits for a parent handshake from an allowed origin, then
+ * records this document (offset registry) and relays frames back. No-op when not framed. Returns a
+ * teardown. The child may still run its own SDK independently — this only adds the relay.
+ */
+export function installChildSatellite(allowedParentOrigins, opts = {}) {
+    if (typeof window === 'undefined' || window.parent === window)
+        return () => { };
+    const o = resolveSnapshotOpts(opts);
+    let rec;
+    let started = false;
+    const onMsg = (e) => {
+        const d = e.data;
+        if (!d || d.scalebun !== INIT || started)
+            return;
+        if (!originAllowed(e.origin, allowedParentOrigins))
+            return;
+        started = true;
+        const reg = new NodeRegistry(typeof d.nodeIdBase === 'number' ? d.nodeIdBase : 1);
+        const post = (msg) => {
+            try {
+                e.source?.postMessage(msg, e.origin);
+            }
+            catch {
+                /* parent gone */
+            }
+        };
+        const doc = serializeNode(document, reg, o);
+        if (doc)
+            post({ scalebun: KEY, doc });
+        rec = new MutationRecorder(reg, (mutations) => post({ scalebun: MUT, mutations }), opts);
+        rec.observe(document.documentElement);
+    };
+    window.addEventListener('message', onMsg);
+    return () => {
+        window.removeEventListener('message', onMsg);
+        rec?.disconnect();
+    };
+}
+/**
+ * Bridge ONE cross-origin iframe: handshake the child, then forward its keyframe (as `op:'iframe'`
+ * referencing the iframe's node id) + its mutation deltas onto the replay stream. Returns teardown.
+ */
+export function bridgeCrossOriginFrame(iframe, iframeNodeId, deps) {
+    const win = iframe.contentWindow;
+    if (!win)
+        return () => { };
+    const onMsg = (e) => {
+        if (e.source !== win)
+            return; // only this child's window
+        if (!originAllowed(e.origin, deps.allowedChildOrigins))
+            return;
+        const d = e.data;
+        if (!d)
+            return;
+        if (d.scalebun === KEY && d.doc) {
+            deps.emit([{ op: 'iframe', id: iframeNodeId, doc: d.doc }]);
+        }
+        else if (d.scalebun === MUT && Array.isArray(d.mutations)) {
+            deps.emit(d.mutations);
+        }
+    };
+    window.addEventListener('message', onMsg);
+    // Target the child's specific origin (no secrets, but don't broadcast). Retry on (re)load.
+    let targetOrigin = '*';
+    try {
+        targetOrigin = new URL(iframe.src, location.href).origin;
+    }
+    catch {
+        /* keep '*' */
+    }
+    const send = () => {
+        try {
+            win.postMessage({ scalebun: INIT, nodeIdBase: deps.nodeIdBase }, targetOrigin);
+        }
+        catch {
+            /* child not ready */
+        }
+    };
+    send();
+    iframe.addEventListener('load', send);
+    return () => {
+        window.removeEventListener('message', onMsg);
+        iframe.removeEventListener('load', send);
+    };
+}
+/** A disjoint id base for a child frame, keyed off the iframe's own node id. */
+export const nodeIdBaseFor = (iframeNodeId) => iframeNodeId * 1000000;
+//# sourceMappingURL=crossOrigin.js.map

package/dist/features/replay/engine/crossOrigin.js.map

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

package/dist/features/replay/engine/cssom.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CssomRecorder — captures live CSSOM changes that `MutationObserver` is blind to: `insertRule`,
+ * `deleteRule`, and (for constructable sheets) `replace`/`replaceSync`. Modern CSS-in-JS libs
+ * (styled-components, Emotion "speedy" mode, Lit) mutate stylesheets via these APIs without touching
+ * the DOM, so without this the keyframe captures the initial CSS but mid-session style changes are
+ * lost. We monkey-patch the prototype, emit compact `sheet` deltas, and restore the originals on
+ * teardown. Fail-isolated: a throwing patch never breaks the host app's CSS call.
+ */
+import type { Mutation } from './types.js';
+import { NodeRegistry } from './nodeRegistry.js';
+export declare function adoptedSheetId(sheet: CSSStyleSheet): number;
+export declare class CssomRecorder {
+    private readonly reg;
+    private readonly onMutations;
+    private installed;
+    private origInsert?;
+    private origDelete?;
+    private origReplaceSync?;
+    private origReplace?;
+    private pending;
+    private scheduled;
+    constructor(reg: NodeRegistry, onMutations: (m: Mutation[]) => void);
+    install(): void;
+    disconnect(): void;
+    /** Resolve the sheet → ref. Owned sheet → its node id; constructable → synthetic adopted id. */
+    private ref;
+    private record;
+    /** Synchronously emit any queued stylesheet deltas — used to drain before a checkpoint snapshot. */
+    flush(): void;
+}
+//# sourceMappingURL=cssom.d.ts.map

package/dist/features/replay/engine/cssom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssom.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/cssom.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAO3D;AAMD,qBAAa,aAAa;IAUtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAV9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAC,CAA4C;IAC/D,OAAO,CAAC,UAAU,CAAC,CAA4C;IAC/D,OAAO,CAAC,eAAe,CAAC,CAA+B;IACvD,OAAO,CAAC,WAAW,CAAC,CAA2B;IAC/C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAS;gBAGP,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI;IAGvD,OAAO,IAAI,IAAI;IA+Cf,UAAU,IAAI,IAAI;IAYlB,gGAAgG;IAChG,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,MAAM;IAQd,oGAAoG;IACpG,KAAK,IAAI,IAAI;CAOd"}

package/dist/features/replay/engine/cssom.js

@@ -0,0 +1,128 @@
+/**
+ * CssomRecorder — captures live CSSOM changes that `MutationObserver` is blind to: `insertRule`,
+ * `deleteRule`, and (for constructable sheets) `replace`/`replaceSync`. Modern CSS-in-JS libs
+ * (styled-components, Emotion "speedy" mode, Lit) mutate stylesheets via these APIs without touching
+ * the DOM, so without this the keyframe captures the initial CSS but mid-session style changes are
+ * lost. We monkey-patch the prototype, emit compact `sheet` deltas, and restore the originals on
+ * teardown. Fail-isolated: a throwing patch never breaks the host app's CSS call.
+ */
+// Stable id per constructable (adopted) sheet — shared with snapshot's serializeAdopted so a delta
+// and the keyframe agree on which adopted sheet they mean.
+const sheetIds = new WeakMap();
+let sheetCounter = 1;
+export function adoptedSheetId(sheet) {
+    let id = sheetIds.get(sheet);
+    if (id == null) {
+        id = sheetCounter++;
+        sheetIds.set(sheet, id);
+    }
+    return id;
+}
+const PATCH_FLAG = '__scalebun_cssom_patched__';
+export class CssomRecorder {
+    constructor(reg, onMutations) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        this.installed = false;
+        this.pending = [];
+        this.scheduled = false;
+    }
+    install() {
+        if (typeof CSSStyleSheet === 'undefined')
+            return;
+        const proto = CSSStyleSheet.prototype;
+        if (proto[PATCH_FLAG])
+            return; // already patched (another instance / library) — don't double-wrap
+        const self = this;
+        this.origInsert = proto.insertRule;
+        proto.insertRule = function (rule, index) {
+            const ret = self.origInsert.call(this, rule, index);
+            const ref = self.ref(this);
+            if (ref)
+                self.record({ op: 'sheet', sheet: ref, action: 'insert', rule, index: ret });
+            return ret;
+        };
+        this.origDelete = proto.deleteRule;
+        proto.deleteRule = function (index) {
+            self.origDelete.call(this, index);
+            const ref = self.ref(this);
+            if (ref)
+                self.record({ op: 'sheet', sheet: ref, action: 'delete', index });
+        };
+        if (typeof proto.replaceSync === 'function') {
+            this.origReplaceSync = proto.replaceSync;
+            proto.replaceSync = function (css) {
+                self.origReplaceSync.call(this, css);
+                const ref = self.ref(this);
+                if (ref)
+                    self.record({ op: 'sheet', sheet: ref, action: 'replace', rules: rulesOf(this) });
+            };
+        }
+        if (typeof proto.replace === 'function') {
+            this.origReplace = proto.replace;
+            proto.replace = function (css) {
+                const p = self.origReplace.call(this, css);
+                // replace() is async; emit once the rules have settled.
+                Promise.resolve(p).then(() => {
+                    const ref = self.ref(this);
+                    if (ref)
+                        self.record({ op: 'sheet', sheet: ref, action: 'replace', rules: rulesOf(this) });
+                });
+                return p;
+            };
+        }
+        proto[PATCH_FLAG] = true;
+        this.installed = true;
+    }
+    disconnect() {
+        if (!this.installed)
+            return;
+        const proto = CSSStyleSheet.prototype;
+        if (this.origInsert)
+            proto.insertRule = this.origInsert;
+        if (this.origDelete)
+            proto.deleteRule = this.origDelete;
+        if (this.origReplaceSync)
+            proto.replaceSync = this.origReplaceSync;
+        if (this.origReplace)
+            proto.replace = this.origReplace;
+        delete proto[PATCH_FLAG];
+        this.installed = false;
+        this.pending = [];
+    }
+    /** Resolve the sheet → ref. Owned sheet → its node id; constructable → synthetic adopted id. */
+    ref(sheet) {
+        const owner = sheet.ownerNode;
+        if (owner) {
+            const id = this.reg.getId(owner);
+            return id != null ? { node: id } : null; // owner not yet registered → skip (re-keyframe covers it)
+        }
+        return { adopted: adoptedSheetId(sheet) };
+    }
+    // Coalesce a burst (Emotion speedy mode fires thousands of insertRule) into one delta per microtask.
+    record(mut) {
+        this.pending.push(mut);
+        if (!this.scheduled) {
+            this.scheduled = true;
+            queueMicrotask(() => this.flush());
+        }
+    }
+    /** Synchronously emit any queued stylesheet deltas — used to drain before a checkpoint snapshot. */
+    flush() {
+        this.scheduled = false;
+        if (!this.pending.length)
+            return;
+        const batch = this.pending;
+        this.pending = [];
+        this.onMutations(batch);
+    }
+}
+function rulesOf(sheet) {
+    try {
+        return Array.from(sheet.cssRules).map((r) => r.cssText);
+    }
+    catch {
+        return []; // cross-origin
+    }
+}
+//# sourceMappingURL=cssom.js.map

package/dist/features/replay/engine/cssom.js.map

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

package/dist/features/replay/engine/iframe.d.ts

@@ -0,0 +1,65 @@
+/**
+ * IframeManager (F-IFR) — captures SAME-ORIGIN iframe content, which the serializer otherwise misses
+ * (an iframe's DOM lives in a separate Document; the parent observer can't see it and cross-origin
+ * frames are fully opaque). For each accessible iframe it serializes the sub-document (`op:'iframe'`)
+ * using the SHARED registry, observes that document's mutations (→ plain add/remove/attr/text ops),
+ * and (via the `onFrame` hook) lets the interaction recorder capture clicks/moves inside it. Handles
+ * dynamically-added frames + navigation via a capture-phase `load` listener per document, and recurses
+ * into nested iframes up to `maxDepth`. Cross-origin / sandboxed frames throw on access → skipped.
+ *
+ * Deferred: precise nested-offset for interactions beyond depth 1 (approximated by the immediate
+ * parent's box).
+ */
+import type { Mutation, SnapshotOptions } from './types.js';
+import { NodeRegistry } from './nodeRegistry.js';
+export interface IframeHooks {
+    /** Called for each accessible sub-document so interactions can be captured there (with an offset). */
+    onFrame?: (doc: Document, getOffset: () => {
+        x: number;
+        y: number;
+    }) => void;
+    /** Called with a sub-document the frame is navigating AWAY from, so interactions stop observing it. */
+    onUnframe?: (doc: Document) => void;
+    maxDepth?: number;
+    /** F-IFR P2 — origin allowlist for cross-origin frame bridging. Empty = cross-origin frames skipped. */
+    frameOrigins?: string[];
+}
+export declare class IframeManager {
+    private readonly reg;
+    private readonly onMutations;
+    private readonly o;
+    private readonly onFrame?;
+    private readonly onUnframe?;
+    private readonly maxDepth;
+    private readonly attached;
+    private loadListeners;
+    private readonly bridges;
+    private readonly frameOrigins;
+    private started;
+    constructor(reg: NodeRegistry, onMutations: (m: Mutation[]) => void, opts?: SnapshotOptions, hooks?: IframeHooks);
+    start(): void;
+    private scan;
+    /**
+     * Drop state for iframes no longer in the DOM.
+     *
+     * `attached` (element → { doc, recorder }) and `bridges` key iframe ELEMENTS strongly and were only
+     * cleared on stop(). An SPA that mounts/unmounts iframes therefore retained every removed one —
+     * its entire sub-Document plus a MutationObserver still running against it.
+     *
+     * Runs off the existing walk points (scan + getDocs) rather than a new timer, so it costs nothing
+     * when nothing changes.
+     */
+    private sweep;
+    private installLoad;
+    /** Serialize a same-origin iframe's document + observe it; recurse into nested frames. */
+    private attach;
+    /** F-IFR P2 — an opaque (cross-origin) frame: bridge it via postMessage when the origin allowlist is
+     *  set + the iframe element is in the captured tree. The child SDK volunteers its capture; we forward
+     *  it through onMutations (op:'iframe' + deltas), exactly like a same-origin frame. */
+    private bridgeCrossOrigin;
+    /** Currently-observed same-origin iframe sub-documents (for the canvas recorder to scan too — A7).
+     *  Sweeps detached iframes first, so a removed frame's document is never handed out for scanning. */
+    subDocuments(): Document[];
+    disconnect(): void;
+}
+//# sourceMappingURL=iframe.d.ts.map

package/dist/features/replay/engine/iframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/iframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,MAAM,WAAW,WAAW;IAC1B,sGAAsG;IACtG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7E,uGAAuG;IACvG,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,aAAa;IAetB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAf9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAGlC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0E;IACnG,OAAO,CAAC,aAAa,CAAmD;IAExE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,OAAO,CAAS;gBAGL,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,EACrD,IAAI,GAAE,eAAoB,EAC1B,KAAK,GAAE,WAAgB;IASzB,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,IAAI;IAUZ;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,WAAW;IAanB,0FAA0F;IAC1F,OAAO,CAAC,MAAM;IAgDd;;2FAEuF;IACvF,OAAO,CAAC,iBAAiB;IAYzB;yGACqG;IACrG,YAAY,IAAI,QAAQ,EAAE;IAK1B,UAAU,IAAI,IAAI;CAenB"}