@scalebun-release/web 2.2.2

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

@@ -0,0 +1,304 @@
+/**
+ * MutationRecorder — observes a subtree and emits compact delta ops (add/remove/attr/text) that
+ * reference registry ids. Masking is applied here too (text/attrs), so raw PII never escapes.
+ *
+ * Moves are encoded as remove(old) + add(new) — correct and simple; an optimized move op can come
+ * later. The observer callback only collects + resolves ids; heavier work (and later, the worker
+ * handoff) lives in `buildMutations`.
+ */
+import { serializeNode, serializeShadow, maskText, maskSecret, NO_MASK_TEXT_PARENTS, SENSITIVE_ATTRS, resolveSnapshotOpts, absolutizeAttrValue, isMaskedSubtree, isPasswordField, } from './snapshot.js';
+import { unregisterSubtree, markSubtree, collectShadowRoots } from './traverse.js';
+const shadowHandlers = new Set();
+let origAttachShadow = null;
+function addShadowHandler(h) {
+    shadowHandlers.add(h);
+    if (origAttachShadow || typeof Element === 'undefined' || typeof Element.prototype.attachShadow !== 'function')
+        return;
+    origAttachShadow = Element.prototype.attachShadow;
+    Element.prototype.attachShadow = function (init) {
+        const root = origAttachShadow.call(this, init);
+        if (init && init.mode === 'open') {
+            for (const handler of shadowHandlers) {
+                try {
+                    handler(this, root);
+                }
+                catch {
+                    /* a handler must never break the host's attachShadow */
+                }
+            }
+        }
+        return root;
+    };
+}
+function removeShadowHandler(h) {
+    shadowHandlers.delete(h);
+    if (shadowHandlers.size === 0 && origAttachShadow) {
+        Element.prototype.attachShadow = origAttachShadow;
+        origAttachShadow = null;
+    }
+}
+/** Visit every OPEN shadow root under `root` (recursing into shadow trees for nested roots). */
+function forEachOpenShadowRoot(root, fn) {
+    root.childNodes.forEach((child) => {
+        if (child.nodeType !== 1)
+            return;
+        const el = child;
+        const sr = el.shadowRoot;
+        if (sr) {
+            fn(el, sr);
+            forEachOpenShadowRoot(sr, fn);
+        }
+        forEachOpenShadowRoot(el, fn);
+    });
+}
+export class MutationRecorder {
+    constructor(reg, onMutations, opts = {}) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        this.observer = null;
+        // Coalesce: a busy app fires many MutationObserver callbacks per frame. We batch their records and
+        // build ONE delta per animation frame instead of one per callback — far less main-thread work and
+        // fewer frames to ship (buildMutations already dedups within a batch).
+        this.queued = [];
+        this.scheduled = false;
+        this.rafId = null;
+        // One observer per open shadow root (MO doesn't cross shadow boundaries); all feed `enqueue`.
+        this.shadowObservers = new Map();
+        this.shadowHandler = null;
+        this.observedDoc = null;
+        this.o = resolveSnapshotOpts(opts);
+    }
+    observe(root) {
+        if (typeof MutationObserver === 'undefined')
+            return;
+        this.observer = new MutationObserver((records) => this.enqueue(records));
+        this.observer.observe(root, { subtree: true, childList: true, attributes: true, characterData: true });
+        // Shadow DOM: observe every existing open root, and catch roots created later (this doc only).
+        this.observedDoc = root.ownerDocument ?? root;
+        forEachOpenShadowRoot(root, (_host, sr) => this.observeShadowRoot(sr));
+        this.shadowHandler = (host, sr) => {
+            if (host.ownerDocument !== this.observedDoc)
+                return; // belongs to another recorder's document
+            const isNew = !this.shadowObservers.has(sr);
+            this.observeShadowRoot(sr);
+            // Host already captured + a fresh root → emit a `shadow` op so the player attaches it.
+            const hostId = this.reg.getId(host);
+            if (isNew && hostId != null) {
+                this.onMutations([{ op: 'shadow', host: hostId, shadow: serializeShadow(sr, this.reg, this.o) }]);
+            }
+        };
+        addShadowHandler(this.shadowHandler);
+    }
+    /** Observe one open shadow root (+ any nested roots already inside it); idempotent. */
+    observeShadowRoot(sr) {
+        if (this.shadowObservers.has(sr) || typeof MutationObserver === 'undefined')
+            return;
+        const obs = new MutationObserver((records) => this.enqueue(records));
+        obs.observe(sr, { subtree: true, childList: true, attributes: true, characterData: true });
+        this.shadowObservers.set(sr, obs);
+        forEachOpenShadowRoot(sr, (_h, nested) => this.observeShadowRoot(nested));
+    }
+    enqueue(records) {
+        this.queued.push(...records);
+        if (this.scheduled)
+            return;
+        this.scheduled = true;
+        if (typeof requestAnimationFrame === 'function') {
+            this.rafId = requestAnimationFrame(() => this.drain());
+        }
+        else {
+            queueMicrotask(() => this.drain());
+        }
+    }
+    drain() {
+        this.scheduled = false;
+        this.rafId = null;
+        if (this.observer)
+            this.queued.push(...this.observer.takeRecords());
+        this.takeShadowRecords();
+        const records = this.queued;
+        this.queued = [];
+        this.process(records);
+    }
+    /** Synchronously drain queued + pending records (on-demand flush + deterministic in tests). */
+    flush() {
+        if (this.rafId != null && typeof cancelAnimationFrame === 'function')
+            cancelAnimationFrame(this.rafId);
+        this.scheduled = false;
+        this.rafId = null;
+        if (this.observer)
+            this.queued.push(...this.observer.takeRecords());
+        this.takeShadowRecords();
+        const records = this.queued;
+        this.queued = [];
+        this.process(records);
+    }
+    disconnect() {
+        if (this.rafId != null && typeof cancelAnimationFrame === 'function')
+            cancelAnimationFrame(this.rafId);
+        this.observer?.disconnect();
+        this.observer = null;
+        for (const o of this.shadowObservers.values())
+            o.disconnect();
+        this.shadowObservers.clear();
+        if (this.shadowHandler) {
+            removeShadowHandler(this.shadowHandler);
+            this.shadowHandler = null;
+        }
+        this.observedDoc = null;
+        this.queued = [];
+        this.scheduled = false;
+        this.rafId = null;
+    }
+    /** Pull pending records out of every shadow-root observer into the shared queue (coalesced build). */
+    takeShadowRecords() {
+        for (const o of this.shadowObservers.values())
+            this.queued.push(...o.takeRecords());
+    }
+    process(records) {
+        if (!records.length)
+            return;
+        this.releaseRemovedShadowRoots(records);
+        const muts = buildMutations(records, this.reg, this.o);
+        if (muts.length)
+            this.onMutations(muts);
+    }
+    /**
+     * Drop observers for shadow roots whose host was removed.
+     *
+     * `shadowObservers` keys ShadowRoots STRONGLY and was only cleared on `disconnect()`, so every
+     * unmounted web component left a live MutationObserver running against a detached tree — and the map
+     * entry retained that whole tree for the session. A long SPA session mounting/unmounting components
+     * leaked both observers and DOM.
+     *
+     * Only genuinely-detached hosts are released: a node removed and re-added in the same batch is a
+     * MOVE (still `isConnected`), and releasing it would silently stop observing it.
+     */
+    releaseRemovedShadowRoots(records) {
+        if (this.shadowObservers.size === 0)
+            return;
+        for (const r of records) {
+            if (r.type !== 'childList')
+                continue;
+            r.removedNodes.forEach((n) => {
+                if (n.isConnected)
+                    return; // moved, not removed
+                for (const sr of collectShadowRoots(n)) {
+                    const obs = this.shadowObservers.get(sr);
+                    if (obs) {
+                        obs.disconnect();
+                        this.shadowObservers.delete(sr);
+                    }
+                }
+            });
+        }
+    }
+}
+/**
+ * ID RESOLUTION IS DEFERRED TO THE END OF THE BATCH, DELIBERATELY.
+ *
+ * One MutationObserver callback can contain a node being removed and re-added — which is what a
+ * React list reorder emits for every element that moved. Resolving ids while scanning meant an
+ * attribute or text change recorded BEFORE that pair carried the node's OLD id, which
+ * `unregisterSubtree` then deleted; the op shipped referring to a node the player would never
+ * create, missed on lookup, and counted as reconstruction drift. Keying by NODE and resolving once
+ * the batch is fully processed gives each op the id the node actually ends up with, and drops the
+ * ops whose node genuinely left the document — where setting an attribute would be meaningless
+ * anyway.
+ *
+ * Values are still read at RECORD time, not at the end: last-write-wins per node and attribute is
+ * the existing contract, and reading the final state instead would quietly change what a mid-batch
+ * revert replays as.
+ */
+export function buildMutations(records, reg, o) {
+    // node → attribute → value, and node → text. Keyed by NODE so an id that changes during the batch
+    // cannot strand the op. Last write wins, exactly as before.
+    const attrOps = new Map();
+    const textOps = new Map();
+    const removed = [];
+    const pendingAdds = [];
+    for (const r of records) {
+        if (r.type === 'attributes') {
+            if (!r.attributeName)
+                continue;
+            let value = r.target.getAttribute(r.attributeName);
+            if (value != null && o.maskAllInputs && SENSITIVE_ATTRS.has(r.attributeName))
+                value = maskText(value);
+            // A password field's value is length-masked on EVERY lane, masking on or off — the keyframe and
+            // input-event lanes already handled it unconditionally and this one did not. Must come after the
+            // mask above so it wins rather than passing through a maskText copy that keeps whitespace.
+            if (value != null && r.attributeName === 'value' && isPasswordField(r.target))
+                value = maskSecret(value);
+            if (value != null) {
+                const el = r.target;
+                value = absolutizeAttrValue(r.attributeName, value, el.tagName?.toLowerCase() ?? '', el.ownerDocument?.baseURI ?? '');
+            }
+            let byKey = attrOps.get(r.target);
+            if (!byKey)
+                attrOps.set(r.target, (byKey = new Map()));
+            byKey.set(r.attributeName, value);
+        }
+        else if (r.type === 'characterData') {
+            const parentTag = r.target.parentNode?.nodeName ?? '';
+            const data = r.target.data;
+            const mask = o.maskAllText || isMaskedSubtree(r.target.parentElement, o.maskSel);
+            textOps.set(r.target, mask && !NO_MASK_TEXT_PARENTS.has(parentTag) ? maskText(data) : data);
+        }
+        else if (r.type === 'childList') {
+            r.removedNodes.forEach((n) => removed.push({ node: n, parent: r.target }));
+            r.addedNodes.forEach((n) => pendingAdds.push({ node: n, parent: r.target, next: r.nextSibling }));
+        }
+    }
+    /**
+     * Removals resolve FIRST, because their ids are about to be retired. Unregistering here (rather
+     * than inside the scan) is what lets an attribute recorded earlier in the same batch still find
+     * its node — and a node that is removed and re-added, i.e. moved, still re-registers fresh on the
+     * add below, which is the behaviour the original inline call existed to provide.
+     */
+    const removes = [];
+    for (const { node, parent } of removed) {
+        const id = reg.getId(node);
+        if (id == null)
+            continue;
+        removes.push({ op: 'remove', parent: reg.getId(parent) ?? 0, id });
+        unregisterSubtree(node, reg);
+    }
+    const considered = new Set();
+    const adds = [];
+    for (const { node, parent, next } of pendingAdds) {
+        if (considered.has(node))
+            continue;
+        if (!node.isConnected)
+            continue; // added then removed in the same batch — transient
+        const parentId = reg.getId(parent);
+        if (parentId == null)
+            continue; // inside an untracked added subtree → captured via its ancestor
+        const snode = serializeNode(node, reg, o);
+        if (!snode)
+            continue;
+        markSubtree(node, considered);
+        adds.push({ op: 'add', parent: parentId, next: next ? reg.getId(next) ?? null : null, node: snode });
+    }
+    /**
+     * Ids are resolved HERE, once every add has registered its nodes. An op whose node is no longer
+     * known left the document for good, so there is nothing to apply it to and it is dropped rather
+     * than shipped as a reference the player cannot resolve.
+     */
+    const attrs = [];
+    for (const [node, byKey] of attrOps) {
+        const id = reg.getId(node);
+        if (id == null)
+            continue;
+        for (const [key, value] of byKey)
+            attrs.push({ op: 'attr', id, key, value });
+    }
+    const texts = [];
+    for (const [node, value] of textOps) {
+        const id = reg.getId(node);
+        if (id != null)
+            texts.push({ op: 'text', id, value });
+    }
+    // Order: removes → adds → attrs → texts (a move = remove old position then add new).
+    return [...removes, ...adds, ...attrs, ...texts];
+}
+//# sourceMappingURL=mutations.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Bidirectional Node↔id map — the heart of the engine. Every serialized node and every mutation op
+ * references an `id`, which keeps deltas tiny and replay deterministic. A WeakMap on the Node side
+ * means detached nodes are GC'd (no leak); the id→Node map is pruned on `remove`.
+ */
+export declare class NodeRegistry {
+    private idToNode;
+    private nodeToId;
+    private counter;
+    /** `startId` namespaces a cross-origin child frame's ids into a disjoint range (F-IFR P2) so the
+     *  child's nodes never collide with the parent's when stitched into one session. Default 1. */
+    constructor(startId?: number);
+    /** Assign (or return existing) id for a node. Idempotent. */
+    add(node: Node): number;
+    /** Map a SPECIFIC id (from the recorder's id space) to a node — used by the player on rebuild. */
+    set(id: number, node: Node): void;
+    getId(node: Node): number | undefined;
+    getNode(id: number): Node | undefined;
+    has(node: Node): boolean;
+    remove(node: Node): void;
+    get size(): number;
+}
+//# sourceMappingURL=nodeRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRegistry.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/nodeRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,OAAO,CAAS;IAExB;mGAC+F;gBACnF,OAAO,SAAI;IAIvB,6DAA6D;IAC7D,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IASvB,kGAAkG;IAClG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAMjC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAIrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAIxB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQxB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

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

@@ -0,0 +1,51 @@
+/**
+ * Bidirectional Node↔id map — the heart of the engine. Every serialized node and every mutation op
+ * references an `id`, which keeps deltas tiny and replay deterministic. A WeakMap on the Node side
+ * means detached nodes are GC'd (no leak); the id→Node map is pruned on `remove`.
+ */
+export class NodeRegistry {
+    /** `startId` namespaces a cross-origin child frame's ids into a disjoint range (F-IFR P2) so the
+     *  child's nodes never collide with the parent's when stitched into one session. Default 1. */
+    constructor(startId = 1) {
+        this.idToNode = new Map();
+        this.nodeToId = new WeakMap();
+        this.counter = startId;
+    }
+    /** Assign (or return existing) id for a node. Idempotent. */
+    add(node) {
+        const existing = this.nodeToId.get(node);
+        if (existing != null)
+            return existing;
+        const id = this.counter++;
+        this.nodeToId.set(node, id);
+        this.idToNode.set(id, node);
+        return id;
+    }
+    /** Map a SPECIFIC id (from the recorder's id space) to a node — used by the player on rebuild. */
+    set(id, node) {
+        this.nodeToId.set(node, id);
+        this.idToNode.set(id, node);
+        if (id >= this.counter)
+            this.counter = id + 1;
+    }
+    getId(node) {
+        return this.nodeToId.get(node);
+    }
+    getNode(id) {
+        return this.idToNode.get(id);
+    }
+    has(node) {
+        return this.nodeToId.has(node);
+    }
+    remove(node) {
+        const id = this.nodeToId.get(node);
+        if (id != null) {
+            this.nodeToId.delete(node);
+            this.idToNode.delete(id);
+        }
+    }
+    get size() {
+        return this.idToNode.size;
+    }
+}
+//# sourceMappingURL=nodeRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRegistry.js","sourceRoot":"","sources":["../../../../src/features/replay/engine/nodeRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAKvB;mGAC+F;IAC/F,YAAY,OAAO,GAAG,CAAC;QANf,aAAQ,GAAG,IAAI,GAAG,EAAgB,CAAC;QACnC,aAAQ,GAAG,IAAI,OAAO,EAAgB,CAAC;QAM7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,6DAA6D;IAC7D,GAAG,CAAC,IAAU;QACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO,QAAQ,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kGAAkG;IAClG,GAAG,CAAC,EAAU,EAAE,IAAU;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAU;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,IAAU;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * Player side — rebuild a keyframe into DOM (registering ids) and apply mutation deltas. Runs in
+ * the dashboard inside a sandboxed, script-free iframe; also used directly in tests so the recorder
+ * and player are verified as one unit. `rebuildWithRegistry` maps each SNode id → its DOM node, so
+ * subsequent deltas resolve.
+ */
+import type { SNode, Mutation } from './types.js';
+import { NodeRegistry } from './nodeRegistry.js';
+export declare function rebuildWithRegistry(s: SNode, reg: NodeRegistry, doc: Document): Node | null;
+export declare function applyMutations(muts: Mutation[], reg: NodeRegistry, doc: Document): void;
+//# sourceMappingURL=player.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/player.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAuE3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAsCvF"}