@scalebun/web 1.0.0

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

@@ -0,0 +1,371 @@
+/**
+ * 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 on an interval (and on demand via flush() for tests). Dead-click
+ * detection uses `notifyDomActivity()`, which the ReplayFeature calls on every mutation/navigation.
+ */
+import { maskText, maskSecret, isPasswordField } from './snapshot';
+const DEFAULTS = {
+    moveThrottleMs: 50,
+    scrollThrottleMs: 100,
+    flushMs: 100,
+    deadMs: 700,
+    rageWindowMs: 800,
+    rageRadius: 30,
+    rageMin: 3,
+    maskInputs: true,
+    maskText: true,
+};
+export class InteractionRecorder {
+    constructor(reg, onEvents, opts = {}) {
+        this.reg = reg;
+        this.onEvents = onEvents;
+        this.pending = [];
+        this.listeners = [];
+        this.timer = null;
+        this.deadTimers = new Set();
+        this.deadObservers = new Set(); // one short-lived observer per in-flight dead check
+        this.lastMoveT = 0;
+        this.lastScrollT = 0;
+        this.lastActivityT = 0;
+        this.clickHistory = [];
+        this.startHref = '';
+        // F-IFR: per-document coordinate offset so clicks/moves inside a same-origin iframe land in the
+        // TOP document's space (the overlay lives there). Top document has no entry → offset {0,0}.
+        this.frameOffsets = new Map();
+        this.onMove = (e) => {
+            const me = e;
+            const t = Date.now();
+            if (t - this.lastMoveT < this.o.moveThrottleMs)
+                return;
+            this.lastMoveT = t;
+            const off = this.offsetFor(e.target);
+            const s = this.rootScroll(e.target);
+            this.pending.push({ k: 'move', x: me.clientX + off.x, y: me.clientY + off.y, sx: s.sx, sy: s.sy, t });
+        };
+        this.onClick = (e) => {
+            const me = e;
+            const t = Date.now();
+            const id = this.reg.getId(e.target);
+            const off = this.offsetFor(e.target);
+            const s = this.rootScroll(e.target);
+            const x = me.clientX + off.x;
+            const y = me.clientY + off.y;
+            // Rage: ≥rageMin clicks clustered in time + space.
+            this.clickHistory = this.clickHistory.filter((c) => t - c.t < this.o.rageWindowMs);
+            const near = this.clickHistory.filter((c) => Math.hypot(c.x - x, c.y - y) <= this.o.rageRadius);
+            this.clickHistory.push({ x, y, t });
+            const rage = near.length + 1 >= this.o.rageMin;
+            // Resolve the true target through shadow DOM (composedPath()[0] beats e.target, which is the host),
+            // then classify what was clicked: a control (button/link/input) vs empty/non-interactive space.
+            const path = e.composedPath?.();
+            const rawTarget = (path && path.length ? path[0] : e.target);
+            const el = describeTarget(rawTarget, this.o.maskText);
+            this.pending.push({ k: 'click', x, y, sx: s.sx, sy: s.sy, id, t, ...(rage ? { rage: true } : {}), ...(el ? { el } : {}) });
+            // Dead-click: no RELEVANT response within deadMs. Target-scoped so background churn (animations,
+            // spinners, polling) doesn't mask real dead clicks — the flaw that made almost every click read blue.
+            this.armDeadCheck(rawTarget, { x, y, sx: s.sx, sy: s.sy, id, at: t, el });
+        };
+        this.onScroll = (e) => {
+            const t = Date.now();
+            if (t - this.lastScrollT < this.o.scrollThrottleMs)
+                return;
+            this.lastScrollT = t;
+            const target = e.target;
+            const el = (target.documentElement ?? target);
+            const id = this.reg.getId(el) ?? 0;
+            this.pending.push({ k: 'scroll', id, x: el.scrollLeft ?? 0, y: el.scrollTop ?? 0, t });
+        };
+        this.onInput = (e) => {
+            const el = e.target;
+            const id = this.reg.getId(el);
+            if (id == null)
+                return;
+            let value = el.value ?? '';
+            // Password → same-length asterisks, never the characters. Blanking it made a typed password
+            // replay as an untouched field (the page's placeholder shows through an empty value).
+            if (isPasswordField(el))
+                value = maskSecret(value);
+            else if (this.o.maskInputs)
+                value = maskText(value);
+            this.pending.push({ k: 'input', id, value, t: Date.now() });
+        };
+        this.onResize = () => {
+            this.pending.push({ k: 'viewport', w: window.innerWidth, h: window.innerHeight, t: Date.now() });
+        };
+        this.o = { ...DEFAULTS, ...opts };
+    }
+    /** Fed by the ReplayFeature on every mutation/navigation — powers dead-click detection. */
+    notifyDomActivity(t = Date.now()) {
+        this.lastActivityT = t;
+    }
+    observe() {
+        if (typeof document === 'undefined')
+            return;
+        this.startHref = safeHref();
+        this.add(document, 'mousemove', this.onMove, true);
+        this.add(document, 'click', this.onClick, true);
+        this.add(document, 'scroll', this.onScroll, true);
+        this.add(document, 'input', this.onInput, true);
+        if (typeof window !== 'undefined')
+            this.add(window, 'resize', this.onResize, true);
+        this.timer = setInterval(() => this.flush(), this.o.flushMs);
+    }
+    /** 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, getOffset) {
+        if (this.frameOffsets.has(doc))
+            return; // already observing this sub-document
+        this.frameOffsets.set(doc, getOffset);
+        this.add(doc, 'mousemove', this.onMove, true);
+        this.add(doc, 'click', this.onClick, true);
+        this.add(doc, 'scroll', this.onScroll, true);
+        this.add(doc, 'input', this.onInput, true);
+    }
+    /** 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) {
+        if (!this.frameOffsets.delete(doc))
+            return;
+        this.listeners = this.listeners.filter((l) => {
+            if (l.target === doc) {
+                try {
+                    l.target.removeEventListener(l.type, l.fn, l.capture);
+                }
+                catch {
+                    /* ignore */
+                }
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * 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.
+     */
+    rootScroll(node) {
+        try {
+            const d = ((node && node.ownerDocument) ||
+                (typeof document !== 'undefined' ? document : null));
+            if (!d)
+                return { sx: 0, sy: 0 };
+            const w = d.defaultView;
+            const sx = w?.scrollX ?? d.documentElement?.scrollLeft ?? d.body?.scrollLeft ?? 0;
+            const sy = w?.scrollY ?? d.documentElement?.scrollTop ?? d.body?.scrollTop ?? 0;
+            return { sx: Math.round(sx), sy: Math.round(sy) };
+        }
+        catch {
+            return { sx: 0, sy: 0 };
+        }
+    }
+    offsetFor(node) {
+        const d = (node && node.ownerDocument) || null;
+        const g = d ? this.frameOffsets.get(d) : undefined;
+        if (!g)
+            return { x: 0, y: 0 };
+        try {
+            return g();
+        }
+        catch {
+            return { x: 0, y: 0 };
+        }
+    }
+    flush() {
+        if (!this.pending.length)
+            return;
+        const batch = this.pending;
+        this.pending = [];
+        this.onEvents(batch);
+    }
+    disconnect() {
+        for (const l of this.listeners)
+            l.target.removeEventListener(l.type, l.fn, l.capture);
+        this.listeners = [];
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        for (const t of this.deadTimers)
+            clearTimeout(t);
+        this.deadTimers.clear();
+        for (const o of this.deadObservers) {
+            try {
+                o.disconnect();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.deadObservers.clear();
+        this.frameOffsets.clear();
+        this.pending = [];
+    }
+    add(target, type, fn, capture) {
+        target.addEventListener(type, fn, capture);
+        this.listeners.push({ target, type, fn, capture });
+    }
+    /**
+     * 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.
+     */
+    armDeadCheck(target, 
+    /**
+     * The CLICK's coordinates, passed as one object rather than six positional args.
+     *
+     * `sx`/`sy` are the scroll offset at CLICK time, not at fire time. The deadclick lands `deadMs`
+     * later, by which point the visitor may well have scrolled — recomputing it here would place the
+     * marker at a position the click never happened at.
+     */
+    c) {
+        const { x, y, id, at, el } = c;
+        const root = target && target.nodeType === 1 && target.isConnected ? target : null;
+        let responded = false;
+        let obs = null;
+        const finish = () => {
+            if (obs) {
+                try {
+                    obs.disconnect();
+                }
+                catch {
+                    /* ignore */
+                }
+                this.deadObservers.delete(obs);
+                obs = null;
+            }
+        };
+        if (typeof MutationObserver !== 'undefined' && typeof document !== 'undefined') {
+            try {
+                obs = new MutationObserver((records) => {
+                    for (const r of records) {
+                        const inTarget = root ? nodeWithin(r.target, root) : false;
+                        const structural = r.type === 'childList' && (hasElement(r.addedNodes) || hasElement(r.removedNodes));
+                        if (inTarget || structural) {
+                            responded = true;
+                            break;
+                        }
+                    }
+                    if (responded)
+                        finish();
+                });
+                obs.observe(document, { subtree: true, childList: true }); // structural changes anywhere
+                if (root)
+                    obs.observe(root, { subtree: true, childList: true, attributes: true, characterData: true });
+                this.deadObservers.add(obs);
+            }
+            catch {
+                responded = true; // observer unavailable → treat as responsive (never a false dead)
+            }
+        }
+        else {
+            responded = true; // no MutationObserver → don't fabricate dead clicks
+        }
+        const timer = setTimeout(() => {
+            this.deadTimers.delete(timer);
+            finish();
+            if (!responded && safeHref() === this.startHref) {
+                this.pending.push({ k: 'deadclick', x, y, sx: c.sx, sy: c.sy, id, t: at, ...(el ? { el } : {}) });
+            }
+        }, this.o.deadMs);
+        this.deadTimers.add(timer);
+    }
+}
+function safeHref() {
+    try {
+        return typeof location !== 'undefined' ? location.href : '';
+    }
+    catch {
+        return '';
+    }
+}
+// Elements that ARE a control (or expose a control role / are keyboard-focusable). A click resolves to
+// the nearest such ancestor via closest() — so clicking the text inside a button is "a button click".
+const INTERACTIVE_SEL = 'a[href],button,input,select,textarea,label,summary,[role=button],[role=link],[role=menuitem],' +
+    '[role=tab],[role=checkbox],[role=radio],[role=switch],[contenteditable=""],[contenteditable=true],' +
+    '[tabindex]:not([tabindex="-1"])';
+function roleFor(el) {
+    const explicit = el.getAttribute?.('role');
+    if (explicit)
+        return explicit;
+    const tag = el.tagName.toLowerCase();
+    if (tag === 'a')
+        return 'link';
+    if (tag === 'button' || tag === 'summary')
+        return 'button';
+    if (tag === 'input' || tag === 'select' || tag === 'textarea' || tag === 'label')
+        return 'input';
+    return undefined;
+}
+/** A short (≤40), whitespace-collapsed label. Human text ONLY when not masked; structural id otherwise. */
+function labelFor(el, maskText) {
+    const pick = (s) => (s && s.trim() ? s.trim() : '');
+    let s = pick(el.getAttribute?.('aria-label')) ||
+        pick(el.getAttribute?.('title')) ||
+        pick(el.getAttribute?.('alt')) ||
+        pick(el.getAttribute?.('name')) ||
+        pick(el.getAttribute?.('placeholder'));
+    if (!s && !maskText)
+        s = pick(el.innerText || el.textContent); // page text: unmasked only
+    if (!s) {
+        const id = pick(el.getAttribute?.('id'));
+        const cls = pick((el.getAttribute?.('class') || '').split(/\s+/)[0]);
+        s = id ? `#${id}` : cls ? `.${cls}` : '';
+    }
+    s = s.replace(/\s+/g, ' ').trim();
+    return s ? s.slice(0, 40) : undefined;
+}
+/** Classify what a click landed on: nearest interactive control vs empty/non-interactive space. */
+function describeTarget(node, maskText) {
+    try {
+        let n = node;
+        if (n && n.nodeType !== 1)
+            n = n.parentElement; // text/#text → its element
+        if (!n || n.nodeType !== 1)
+            return undefined;
+        const direct = n;
+        const control = direct.closest?.(INTERACTIVE_SEL) ?? null;
+        const chosen = control ?? direct;
+        return {
+            tag: chosen.tagName.toLowerCase(),
+            interactive: !!control,
+            role: control ? roleFor(chosen) : undefined,
+            label: labelFor(chosen, maskText),
+        };
+    }
+    catch {
+        return undefined; // never break capture
+    }
+}
+/** True when the NodeList contains at least one Element (nodeType 1) — ignores text/comment churn. */
+function hasElement(list) {
+    for (let i = 0; i < list.length; i++)
+        if (list[i].nodeType === 1)
+            return true;
+    return false;
+}
+/** True when `n` is `root` or a descendant of it, crossing shadow boundaries via getRootNode().host. */
+function nodeWithin(n, root) {
+    let cur = n;
+    let hops = 0;
+    while (cur && hops++ < 500) {
+        if (cur === root)
+            return true;
+        const parent = cur.parentNode ?? cur.getRootNode?.();
+        cur = parent && parent !== cur ? parent.host ?? parent : null;
+    }
+    return false;
+}
+//# sourceMappingURL=interactions.js.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * 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 type { Mutation, SnapshotOptions } from './types';
+import { NodeRegistry } from './nodeRegistry';
+import { type ResolvedSnapshotOpts } from './snapshot';
+export declare class MutationRecorder {
+    private readonly reg;
+    private readonly onMutations;
+    private observer;
+    private readonly o;
+    private queued;
+    private scheduled;
+    private rafId;
+    private readonly shadowObservers;
+    private shadowHandler;
+    private observedDoc;
+    constructor(reg: NodeRegistry, onMutations: (m: Mutation[]) => void, opts?: SnapshotOptions);
+    observe(root: Node): void;
+    /** Observe one open shadow root (+ any nested roots already inside it); idempotent. */
+    private observeShadowRoot;
+    private enqueue;
+    private drain;
+    /** Synchronously drain queued + pending records (on-demand flush + deterministic in tests). */
+    flush(): void;
+    disconnect(): void;
+    /** Pull pending records out of every shadow-root observer into the shared queue (coalesced build). */
+    private takeShadowRecords;
+    private process;
+    /**
+     * 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.
+     */
+    private releaseRemovedShadowRoots;
+}
+export declare function buildMutations(records: MutationRecord[], reg: NodeRegistry, o: ResolvedSnapshotOpts): Mutation[];
+//# sourceMappingURL=mutations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/mutations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAWL,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAqDpB,qBAAa,gBAAgB;IAezB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAf9B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAuB;IAIzC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAuB;IAEpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAyB;gBAGzB,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,EACrD,IAAI,GAAE,eAAoB;IAK5B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAoBzB,uFAAuF;IACvF,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,KAAK;IAUb,+FAA+F;IAC/F,KAAK,IAAI,IAAI;IAWb,UAAU,IAAI,IAAI;IAgBlB,sGAAsG;IACtG,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,OAAO;IAOf;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;CAgBlC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EAAE,EACzB,GAAG,EAAE,YAAY,EACjB,CAAC,EAAE,oBAAoB,GACtB,QAAQ,EAAE,CAwDZ"}