@scalebun-release/web 2.2.2

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

@@ -0,0 +1,186 @@
+/**
+ * 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 { serializeNode, resolveSnapshotOpts } from './snapshot.js';
+import { MutationRecorder } from './mutations.js';
+import { bridgeCrossOriginFrame, nodeIdBaseFor } from './crossOrigin.js';
+export class IframeManager {
+    constructor(reg, onMutations, opts = {}, hooks = {}) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        // Per-iframe-element state: one recorder per element. On navigation the element's contentDocument
+        // changes — we disconnect the prior recorder before observing the new doc (no leak; A2).
+        this.attached = new Map();
+        this.loadListeners = [];
+        // F-IFR P2 — one postMessage bridge per cross-origin iframe (when frameOrigins is configured).
+        this.bridges = new Map();
+        this.started = false;
+        this.o = resolveSnapshotOpts(opts);
+        this.onFrame = hooks.onFrame;
+        this.onUnframe = hooks.onUnframe;
+        this.maxDepth = hooks.maxDepth ?? 3;
+        this.frameOrigins = hooks.frameOrigins ?? [];
+    }
+    start() {
+        if (this.started || typeof document === 'undefined')
+            return;
+        this.started = true;
+        this.installLoad(document, 0);
+        this.scan(document, 0);
+    }
+    scan(root, depth) {
+        if (depth > this.maxDepth)
+            return;
+        this.sweep();
+        try {
+            root.querySelectorAll('iframe').forEach((f) => this.attach(f, depth));
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /**
+     * 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.
+     */
+    sweep() {
+        if (this.attached.size) {
+            for (const [iframe, { doc, rec }] of this.attached) {
+                if (iframe.isConnected)
+                    continue;
+                rec.disconnect();
+                this.onUnframe?.(doc);
+                this.attached.delete(iframe);
+            }
+        }
+        if (this.bridges.size) {
+            for (const [iframe, stop] of this.bridges) {
+                if (iframe.isConnected)
+                    continue;
+                stop();
+                this.bridges.delete(iframe);
+            }
+        }
+    }
+    // Capture phase catches iframe `load` (doesn't bubble) — covers dynamic + navigation. One per doc.
+    installLoad(doc, depth) {
+        const fn = (e) => {
+            const t = e.target;
+            if (t && t.tagName === 'IFRAME')
+                this.attach(t, depth);
+        };
+        try {
+            doc.addEventListener('load', fn, true);
+            this.loadListeners.push({ doc, fn });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /** Serialize a same-origin iframe's document + observe it; recurse into nested frames. */
+    attach(iframe, depth) {
+        if (depth > this.maxDepth)
+            return;
+        let idoc = null;
+        try {
+            idoc = iframe.contentDocument; // cross-origin / sandboxed → throws or null
+        }
+        catch {
+            this.bridgeCrossOrigin(iframe); // F-IFR P2 — opaque frame: try the postMessage bridge
+            return;
+        }
+        if (!idoc || !idoc.documentElement) {
+            this.bridgeCrossOrigin(iframe); // null contentDocument (cross-origin) → bridge
+            return;
+        }
+        const prev = this.attached.get(iframe);
+        if (prev) {
+            if (prev.doc === idoc)
+                return; // already observing this exact document (load + scan dedup)
+            // Navigation: tear down the previous document's recorder + interaction listeners before the new.
+            prev.rec.disconnect();
+            this.onUnframe?.(prev.doc);
+            this.attached.delete(iframe);
+        }
+        const id = this.reg.getId(iframe);
+        if (id == null)
+            return; // the iframe element isn't in the captured tree
+        const doc = serializeNode(idoc, this.reg, this.o); // registers nested nodes in the shared registry
+        if (doc)
+            this.onMutations([{ op: 'iframe', id, doc }]);
+        const rec = new MutationRecorder(this.reg, this.onMutations, this.o);
+        rec.observe(idoc.documentElement);
+        this.attached.set(iframe, { doc: idoc, rec });
+        // Interactions inside the frame, offset into the top document's coordinate space (computed live).
+        this.onFrame?.(idoc, () => {
+            try {
+                const r = iframe.getBoundingClientRect();
+                return { x: r.left, y: r.top };
+            }
+            catch {
+                return { x: 0, y: 0 };
+            }
+        });
+        // Nested iframes (bounded).
+        if (depth < this.maxDepth) {
+            this.installLoad(idoc, depth + 1);
+            this.scan(idoc, depth + 1);
+        }
+    }
+    /** 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. */
+    bridgeCrossOrigin(iframe) {
+        if (!this.frameOrigins.length || this.bridges.has(iframe))
+            return;
+        const id = this.reg.getId(iframe);
+        if (id == null)
+            return; // iframe element not in the captured tree yet
+        const stop = bridgeCrossOriginFrame(iframe, id, {
+            nodeIdBase: nodeIdBaseFor(id),
+            allowedChildOrigins: this.frameOrigins,
+            emit: this.onMutations,
+        });
+        this.bridges.set(iframe, stop);
+    }
+    /** 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() {
+        this.sweep();
+        return [...this.attached.values()].map((a) => a.doc);
+    }
+    disconnect() {
+        for (const { rec } of this.attached.values())
+            rec.disconnect();
+        this.attached.clear();
+        for (const stop of this.bridges.values())
+            stop();
+        this.bridges.clear();
+        for (const { doc, fn } of this.loadListeners) {
+            try {
+                doc.removeEventListener('load', fn, true);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.loadListeners = [];
+        this.started = false;
+    }
+}
+//# sourceMappingURL=iframe.js.map

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

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

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

@@ -0,0 +1,172 @@
+/**
+ * InteractionRecorder — the user layer on top of DOM mutations: cursor moves, clicks (with target +
+ * rage + dead-click detection), scroll, masked input, viewport. This is what turns "DOM playback"
+ * into a real session replay (the parallel to the mobile SDK's native touch layer).
+ *
+ * - move:      throttled cursor positions (clientX/clientY)
+ * - click:     every click + target node id; `rage` when ≥N clicks cluster in time+space
+ * - deadclick: a click with NO DOM activity and NO navigation within `deadMs` → friction signal
+ * - scroll:    throttled scroll offset of the scrolled element
+ * - input:     masked value (password → empty)
+ * - viewport:  on resize
+ *
+ * Events are batched and flushed by semantic lane — click/deadclick immediately, scroll/input/viewport
+ * on the `flushMs` tick, pure cursor moves pooled to `moveFlushMs` (see `queue`) — and on demand via
+ * flush(). Dead-click detection uses `notifyDomActivity()`, called on every mutation/navigation.
+ */
+import { NodeRegistry } from './nodeRegistry.js';
+export interface ClickTarget {
+    tag: string;
+    interactive: boolean;
+    role?: string;
+    label?: string;
+}
+/**
+ * `sx`/`sy` — the ROOT scroll offset at the instant the pointer event fired.
+ *
+ * `x`/`y` are viewport coords (`clientX/clientY`), so on their own they are only interpretable against
+ * the scroll position that was in force when they were captured. Playback used to recover that from the
+ * separate `scroll` stream, which made click accuracy depend on a stream that is throttled to 100ms and
+ * was, until recently, sheddable under load — reported live as clicks landing "a lil diff space".
+ *
+ * Carrying the offset ON the event makes it self-describing: document position is `(x + sx, y + sy)`, and
+ * the player subtracts whatever scroll it actually applied. Optional because every session captured
+ * before this shipped has no offset; the reader falls back to raw `x`/`y` (see DomReplayer.overlayAt).
+ */
+export type Interaction = {
+    k: 'move';
+    x: number;
+    y: number;
+    sx?: number;
+    sy?: number;
+    t: number;
+} | {
+    k: 'click';
+    x: number;
+    y: number;
+    sx?: number;
+    sy?: number;
+    id?: number;
+    t: number;
+    rage?: boolean;
+    el?: ClickTarget;
+} | {
+    k: 'deadclick';
+    x: number;
+    y: number;
+    sx?: number;
+    sy?: number;
+    id?: number;
+    t: number;
+    el?: ClickTarget;
+} | {
+    k: 'scroll';
+    id: number;
+    x: number;
+    y: number;
+    t: number;
+}
+/** `checked` rides along for checkbox/radio only: a toggle changes a PROPERTY, which
+ *  MutationObserver cannot see, and `value` on a checkbox is the static markup value. */
+ | {
+    k: 'input';
+    id: number;
+    value: string;
+    checked?: boolean;
+    t: number;
+} | {
+    k: 'viewport';
+    w: number;
+    h: number;
+    t: number;
+};
+export interface InteractionOptions {
+    moveThrottleMs?: number;
+    scrollThrottleMs?: number;
+    flushMs?: number;
+    /**
+     * How long a MOVE-ONLY batch may accumulate before it ships. Cursor positions are the highest-volume,
+     * lowest-signal stream: flushing them on the generic `flushMs` cadence produced a frame every 100ms
+     * for the entire time the mouse was moving (~10/sec of near-empty envelopes). Moves now pool until
+     * this window elapses — or instantly when a semantic event (click/deadclick) joins the batch, so the
+     * cursor trail leading INTO a click still ships with full fidelity, in the same frame.
+     */
+    moveFlushMs?: number;
+    deadMs?: number;
+    rageWindowMs?: number;
+    rageRadius?: number;
+    rageMin?: number;
+    maskInputs?: boolean;
+    maskText?: boolean;
+    /**
+     * Called right before an IMMEDIATE flush (click/deadclick). The recorder wires this to the DOM
+     * DeltaBatcher's flush so a click on a just-added node never ships before the mutation that adds it —
+     * the batching windows must not be allowed to reorder cause and effect.
+     */
+    beforeImmediateFlush?: () => void;
+}
+export declare class InteractionRecorder {
+    private readonly reg;
+    private readonly onEvents;
+    private pending;
+    private listeners;
+    private timer;
+    private deadTimers;
+    private deadObservers;
+    private lastMoveT;
+    private lastScrollT;
+    private lastActivityT;
+    private clickHistory;
+    private startHref;
+    private frameOffsets;
+    private pendingSince;
+    private readonly o;
+    constructor(reg: NodeRegistry, onEvents: (events: Interaction[]) => void, opts?: InteractionOptions);
+    /** Fed by the ReplayFeature on every mutation/navigation — powers dead-click detection. */
+    notifyDomActivity(t?: number): void;
+    observe(): void;
+    /**
+     * Flush policy — events have different semantic weight, so they flush on different lanes:
+     *  - immediate (click/deadclick): flush NOW, after draining the DOM batcher (see beforeImmediateFlush).
+     *  - fast (scroll/input/viewport): next `flushMs` tick (≤100ms) — latest-state streams where a small
+     *    delay is imperceptible but per-event frames would explode (a keystroke or resize-drag burst).
+     *  - move: pool until `moveFlushMs` — pure cursor trail, the lowest-signal stream.
+     * A mixed batch flushes at the fastest lane present, in arrival order, as ONE frame.
+     */
+    private queue;
+    private onTick;
+    /** Also capture interactions inside a same-origin iframe document; `getOffset` maps its viewport
+     *  coords into the top document's space (computed live — the iframe can move/scroll). */
+    observeFrame(doc: Document, getOffset: () => {
+        x: number;
+        y: number;
+    }): void;
+    /** Stop capturing in a sub-document (iframe navigated away / removed) — removes its 4 listeners +
+     *  offset entry, so a frequently-reloading frame doesn't accumulate stale docs/listeners (A3). */
+    unobserveFrame(doc: Document): void;
+    /**
+     * Root scroll of the document the event fired in.
+     *
+     * `defaultView.scrollX/scrollY` first: it is correct whether the page scrolls `documentElement` or
+     * `body` (quirks mode, and some frameworks), which the element properties are not. Falls back through
+     * both elements, then 0 — a missing offset must degrade to "no correction", never to a wrong one.
+     */
+    private rootScroll;
+    private offsetFor;
+    flush(): void;
+    disconnect(): void;
+    private add;
+    private onMove;
+    private onClick;
+    /**
+     * Arm a per-click "did anything respond?" check. A click is dead when, within `deadMs`, NONE of these
+     * happen: (1) navigation; (2) a mutation inside the click TARGET's subtree (in-place response);
+     * (3) a structural change anywhere — an element added OR removed under the document (modal/toast/route
+     * swap/removal). Attribute-only / characterData-only churn (animation noise) is ignored on purpose.
+     */
+    private armDeadCheck;
+    private onScroll;
+    private onInput;
+    private onResize;
+}
+//# sourceMappingURL=interactions.d.ts.map

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

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