@reactra/replay 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akhil Shastri and the Reactra contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @reactra/replay
+
+> Reactra session replay — recording, streaming, re-drive, and diffing of Reactra app state.
+
+**Alpha** — published under the npm dist-tag `alpha`. APIs may change before 1.0.
+
+```bash
+npm install @reactra/replay@alpha
+```
+
+Part of [Reactra](https://github.com/akhilshastri/reactra) — a compiler-first,
+React-19-compatible framework. See the [documentation](https://reactra-docs.vercel.app) to get
+started.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,225 @@
+import type { ReplayEvent, SessionBundle } from "@reactra/behaviours/replayable";
+export type { ActionEvent, GapEvent, MountEvent, ReplayEvent, ResourceEvent, SessionBundle, StateSnapshotEvent, } from "@reactra/behaviours/replayable";
+/**
+ * Keys whose value changed between two folded states (shallow `!==` on
+ * JSON-stable values — the same comparison the recorder's deltas use).
+ * Keys present only in `cur` count as changed; keys only in `prev` don't
+ * (the panel highlights what the current stop introduced).
+ *
+ * Promoted here from `@reactra/replay-devtools/helpers` (diff plan §2) so
+ * `diffBundles` can use it without inverting the dependency graph.
+ * `@reactra/replay-devtools` re-exports this symbol to preserve all existing
+ * import paths (COND-2).
+ */
+export declare const diffKeys: (prev: Record<string, unknown> | undefined, cur: Record<string, unknown>) => string[];
+/** One key that differs between two aligned states. */
+export interface KeyDiff {
+    /** The state key. */
+    key: string;
+    /**
+     * The value in bundle A at this ordinal.
+     *
+     * `undefined` means the key was absent on that side — indistinguishable
+     * from a recorded literal `undefined` (moot under JSON, which drops
+     * `undefined` values). Known v1 limitation (diff plan §4 COND-5).
+     */
+    valueA: unknown;
+    /**
+     * The value in bundle B at this ordinal.
+     * See `valueA` note on `undefined` semantics.
+     */
+    valueB: unknown;
+}
+/**
+ * Symmetric key diff: keys changed between `a` and `b`, keys only in `a`,
+ * and keys only in `b`.
+ *
+ * Unlike `diffKeys`, which reports from `cur`'s perspective only, this
+ * variant is symmetric — suitable for cross-bundle comparison where neither
+ * side is the "authoritative" current state.
+ */
+export declare const diffKeysSymmetric: (a: Record<string, unknown> | undefined, b: Record<string, unknown> | undefined) => {
+    changed: KeyDiff[];
+    onlyA: string[];
+    onlyB: string[];
+};
+/**
+ * Headless navigator over a recorded `SessionBundle` (Replay spec §5). Pure data
+ * — no React state setters, no live re-drive (RLIM-07). For tests, devtools
+ * timeline panels, and bug-report inspection.
+ */
+export declare class ReplayPlayer {
+    /** The recorded bundle under navigation. (Declared explicitly, not as a constructor parameter property — Node strip-only mode rejects parameter properties, and package source must import under plain Node per CLAUDE.md §6 / Runtime §2.) */
+    private readonly bundle;
+    /** All snapshots, in recorded order — built once for O(log n) navigation (v1.6). */
+    private readonly snapshots;
+    /** Whether the bundle uses delta semantics ("2.1"); "2.0" reads as all-keyframes (§3). */
+    private readonly deltaAware;
+    constructor(bundle: SessionBundle);
+    /**
+     * SINGLE-INSTANCE fold (§5): the state of the instance owning the nearest
+     * snapshot ≤ `timestamp`. Correct as a whole-app answer only for
+     * single-component bundles — multi-component consumers use `statesAt`
+     * (v1.8 normative note). v1.6: binary-search the nearest snapshot ≤ t,
+     * walk back to that INSTANCE's nearest keyframe, and fold its deltas
+     * forward to t — O(log n + fold-depth), fold-depth bounded by
+     * `keyframeEvery`. A "2.0" bundle (every snapshot full) folds trivially.
+     */
+    stateAt(timestamp: number): Record<string, unknown>;
+    /**
+     * MULTI-INSTANCE fold (§5 v1.8): every recorded instance's state as of
+     * `timestamp`. Keys are FULL componentIds — instance suffix included
+     * (`"Board#1"`); callers feeding `applyReplayState` (which targets a
+     * component NAME) strip the suffix themselves. Per instance the fold
+     * starts at its latest keyframe ≤ t (§3 semantics); instances with no
+     * snapshot ≤ t are absent. One pass over the snapshot index — keyframes
+     * reset the fold, deltas merge into it, exactly the recorder's semantics.
+     */
+    statesAt(timestamp: number): Map<string, Record<string, unknown>>;
+    /**
+     * The navigable URL recorded as of `timestamp` (§5) — sugar over `statesAt`,
+     * which folds the synthetic `Route#1` snapshot exactly like any instance.
+     * `undefined` when the session carries no route snapshot ≤ t.
+     */
+    routeAt(timestamp: number): string | undefined;
+    /** Events within `[from, to]` (inclusive) — for stepping a timeline UI (§5). */
+    eventsBetween(from: number, to: number): ReplayEvent[];
+    /** All recorded events, in order. */
+    get events(): readonly ReplayEvent[];
+    /** Total session duration in ms. */
+    get duration(): number;
+    /**
+     * Fold all instance states up to and including the snapshot at position
+     * `endIndex` in the global snapshot array. Used by `diffBundles` to pair
+     * snapshots by ordinal rather than timestamp, so that same-timestamp
+     * clustered commits are each treated as a distinct ordinal (B1 fix).
+     *
+     * Not exposed in the public API — consumers use `statesAt(timestamp)`.
+     */
+    statesUpToIndex(endIndex: number): Map<string, Record<string, unknown>>;
+    /** Binary search: the index of the last snapshot with `timestamp ≤ t`, or -1. */
+    private lastSnapshotIndexAtOrBefore;
+}
+/**
+ * Filter options for `diffBundles`. v1 supports a single `componentName`
+ * filter (the component base name, without the `#N` instance suffix — e.g.
+ * `"PulseDashboard"` matches `"PulseDashboard#1"`, `"PulseDashboard#2"`, …).
+ * Omit to diff all instances present in either bundle.
+ */
+export interface BundleDiffOptions {
+    /**
+     * Restrict the diff to instances whose componentId starts with this name.
+     *
+     * - Pass a base name (`"Board"`) to include all instances: `Board#1`,
+     *   `Board#2`, etc. (`componentId.startsWith("Board#")`).
+     * - Pass a full componentId (`"Board#2"`) to target exactly one instance
+     *   (`componentId === "Board#2"`).
+     * - Omit to diff all instances present in either bundle.
+     */
+    componentName?: string;
+}
+/**
+ * The diff at one aligned ordinal for a component instance (diff plan §4).
+ * `changedKeys` is empty when both states agree at this stop.
+ */
+export interface AlignedStop {
+    /** 0-based pair index — A's k-th snapshot ↔ B's k-th. */
+    ordinal: number;
+    /** Offset from bundle A's `startTime` (ms). */
+    offsetA: number;
+    /** Offset from bundle B's `startTime` (ms). */
+    offsetB: number;
+    /**
+     * Global snapshot-array index in bundle A used for this ordinal.
+     * Pass to `ReplayPlayer.statesUpToIndex` to read the exact state
+     * the diff engine saw — avoids same-timestamp ambiguity.
+     */
+    globalIndexA: number;
+    /** Global snapshot-array index in bundle B for this ordinal. */
+    globalIndexB: number;
+    /**
+     * Per-key diffs at this ordinal (empty array = states agree).
+     * Keys absent in both sides are not listed.
+     */
+    changedKeys: KeyDiff[];
+}
+/**
+ * The full diff for one component instance across both bundles (diff plan §4).
+ *
+ * When `presence === "both"`, `stops` contains all aligned (paired) ordinals;
+ * `unpairedA`/`unpairedB` hold the leftover stop offsets on the longer side.
+ * When `presence !== "both"`, `stops` is empty.
+ */
+export interface InstanceDiff {
+    /** Full componentId including instance suffix (e.g. `"Board#1"`). */
+    componentId: string;
+    /** Whether this instance was observed in both bundles, or only one. */
+    presence: "both" | "onlyA" | "onlyB";
+    /** Aligned stop diffs; populated only when `presence === "both"`. */
+    stops: AlignedStop[];
+    /**
+     * When `presence === "both"`: offsets (relative to A's `startTime`, ms) for
+     * A's snapshots beyond the paired region (the tail past `min(countA, countB)`).
+     * When `presence === "onlyA"`: ALL of A's snapshot offsets (no paired region
+     * exists). Empty when `presence === "onlyB"`.
+     */
+    unpairedA: number[];
+    /**
+     * When `presence === "both"`: offsets (relative to B's `startTime`, ms) for
+     * B's snapshots beyond the paired region.
+     * When `presence === "onlyB"`: ALL of B's snapshot offsets.
+     * Empty when `presence === "onlyA"`.
+     */
+    unpairedB: number[];
+    /**
+     * Action names fired in A but not B (min-truncated ordinal comparison —
+     * no LCS; diff plan §3 deferred).
+     */
+    actionsOnlyA: string[];
+    /**
+     * Action names fired in B but not A.
+     */
+    actionsOnlyB: string[];
+    /**
+     * Resource names fetched in A but not B.
+     */
+    resourcesOnlyA: string[];
+    /**
+     * Resource names fetched in B but not A.
+     */
+    resourcesOnlyB: string[];
+}
+/** The top-level output of `diffBundles`. */
+export interface DiffResult {
+    /** One entry per distinct componentId present in either bundle. */
+    instances: InstanceDiff[];
+    /**
+     * Total count of aligned stop pairs where at least one key differs.
+     * 0 = the two sessions agree on all observed state.
+     */
+    divergentStopCount: number;
+}
+/**
+ * Compare two recorded `SessionBundle`s and return the structured diff
+ * (diff plan §4).
+ *
+ * Alignment: per-instance event ordinal — A's k-th snapshot ↔ B's k-th.
+ * Correct when both sessions ran the same component through a comparable
+ * commit sequence. Pairs truncate at `min(stopsA, stopsB)`; the unpaired
+ * tail is reported as `unpairedA`/`unpairedB`.
+ *
+ * Version-aware: reads state through `ReplayPlayer.statesAt` so 2.0
+ * (all-keyframe) and 2.1 (delta) bundles fold to equal states when the
+ * recorded logical state is the same (diff plan §6 scenario 6).
+ *
+ * Pure — no React, no DOM, no module singletons (COND-4). Safe to call in
+ * tests, workers, and server-side code.
+ *
+ * @remarks v1 aligns by per-instance snapshot ordinal only. The following are
+ * explicitly deferred (Replay §5): LCS/fuzzy action-sequence alignment,
+ * multi-instance fuzzy matching (e.g. `Board#2` ↔ `Board#3`), normalized-time
+ * or route-aware alignment, deep nested-value diff (beyond shallow JSON
+ * compare), three-way diff, and drive-in-compare.
+ */
+export declare const diffBundles: (a: SessionBundle, b: SessionBundle, opts?: BundleDiffOptions) => DiffResult;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,344 @@
+// @reactra/replay — headless session playback (Replay spec §5).
+//
+// Owner spec: reactra-replay-spec.md §5; package placement per Runtime v1 §2's
+// boundary rule — anything compiler-emitted code calls (the channel,
+// `configureReplay`, `finalizeReplay`, `useReplayCapture`, the live re-drive)
+// lives in `@reactra/behaviours/replayable`; this package only CONSUMES a
+// recorded `SessionBundle`: the headless `ReplayPlayer` (tests, devtools,
+// bug-report inspection — pure data, no React). Live re-drive is the
+// behaviours-side `applyReplayState` (Replay §5 v1.4); the recording-format
+// types are owned by the recorder module and re-exported here for convenience.
+/**
+ * Keys whose value changed between two folded states (shallow `!==` on
+ * JSON-stable values — the same comparison the recorder's deltas use).
+ * Keys present only in `cur` count as changed; keys only in `prev` don't
+ * (the panel highlights what the current stop introduced).
+ *
+ * Promoted here from `@reactra/replay-devtools/helpers` (diff plan §2) so
+ * `diffBundles` can use it without inverting the dependency graph.
+ * `@reactra/replay-devtools` re-exports this symbol to preserve all existing
+ * import paths (COND-2).
+ */
+export const diffKeys = (prev, cur) => {
+    if (!prev)
+        return Object.keys(cur);
+    return Object.keys(cur).filter((k) => !(k in prev) || JSON.stringify(prev[k]) !== JSON.stringify(cur[k]));
+};
+/**
+ * Symmetric key diff: keys changed between `a` and `b`, keys only in `a`,
+ * and keys only in `b`.
+ *
+ * Unlike `diffKeys`, which reports from `cur`'s perspective only, this
+ * variant is symmetric — suitable for cross-bundle comparison where neither
+ * side is the "authoritative" current state.
+ */
+export const diffKeysSymmetric = (a, b) => {
+    const aKeys = new Set(a ? Object.keys(a) : []);
+    const bKeys = new Set(b ? Object.keys(b) : []);
+    const changed = [];
+    const onlyA = [];
+    const onlyB = [];
+    for (const k of aKeys) {
+        if (!bKeys.has(k)) {
+            onlyA.push(k);
+        }
+        else if (JSON.stringify(a[k]) !== JSON.stringify(b[k])) {
+            changed.push({ key: k, valueA: a[k], valueB: b[k] });
+        }
+    }
+    for (const k of bKeys) {
+        if (!aKeys.has(k))
+            onlyB.push(k);
+    }
+    return { changed, onlyA, onlyB };
+};
+/**
+ * Headless navigator over a recorded `SessionBundle` (Replay spec §5). Pure data
+ * — no React state setters, no live re-drive (RLIM-07). For tests, devtools
+ * timeline panels, and bug-report inspection.
+ */
+export class ReplayPlayer {
+    /** The recorded bundle under navigation. (Declared explicitly, not as a constructor parameter property — Node strip-only mode rejects parameter properties, and package source must import under plain Node per CLAUDE.md §6 / Runtime §2.) */
+    bundle;
+    /** All snapshots, in recorded order — built once for O(log n) navigation (v1.6). */
+    snapshots;
+    /** Whether the bundle uses delta semantics ("2.1"); "2.0" reads as all-keyframes (§3). */
+    deltaAware;
+    constructor(bundle) {
+        this.bundle = bundle;
+        this.snapshots = bundle.events.filter((e) => e.type === "state_snapshot");
+        this.deltaAware = bundle.version === "2.1";
+    }
+    /**
+     * SINGLE-INSTANCE fold (§5): the state of the instance owning the nearest
+     * snapshot ≤ `timestamp`. Correct as a whole-app answer only for
+     * single-component bundles — multi-component consumers use `statesAt`
+     * (v1.8 normative note). v1.6: binary-search the nearest snapshot ≤ t,
+     * walk back to that INSTANCE's nearest keyframe, and fold its deltas
+     * forward to t — O(log n + fold-depth), fold-depth bounded by
+     * `keyframeEvery`. A "2.0" bundle (every snapshot full) folds trivially.
+     */
+    stateAt(timestamp) {
+        const idx = this.lastSnapshotIndexAtOrBefore(timestamp);
+        if (idx < 0)
+            return {};
+        const target = this.snapshots[idx];
+        if (!this.deltaAware)
+            return target.state;
+        // Walk back to the instance's keyframe (first-per-instance is guaranteed).
+        let start = idx;
+        while (start >= 0) {
+            const s = this.snapshots[start];
+            if (s.componentId === target.componentId && s.keyframe)
+                break;
+            start--;
+        }
+        if (start < 0)
+            return target.state; // defensive: no keyframe found — treat as full
+        const folded = { ...this.snapshots[start].state };
+        for (let i = start + 1; i <= idx; i++) {
+            const s = this.snapshots[i];
+            if (s.componentId !== target.componentId)
+                continue;
+            Object.assign(folded, s.state);
+        }
+        return folded;
+    }
+    /**
+     * MULTI-INSTANCE fold (§5 v1.8): every recorded instance's state as of
+     * `timestamp`. Keys are FULL componentIds — instance suffix included
+     * (`"Board#1"`); callers feeding `applyReplayState` (which targets a
+     * component NAME) strip the suffix themselves. Per instance the fold
+     * starts at its latest keyframe ≤ t (§3 semantics); instances with no
+     * snapshot ≤ t are absent. One pass over the snapshot index — keyframes
+     * reset the fold, deltas merge into it, exactly the recorder's semantics.
+     */
+    statesAt(timestamp) {
+        const out = new Map();
+        const end = this.lastSnapshotIndexAtOrBefore(timestamp);
+        for (let i = 0; i <= end; i++) {
+            const s = this.snapshots[i];
+            // A "2.0" bundle has no keyframe flags — every snapshot is full state.
+            if (!this.deltaAware || s.keyframe)
+                out.set(s.componentId, { ...s.state });
+            else
+                out.set(s.componentId, { ...(out.get(s.componentId) ?? {}), ...s.state });
+        }
+        return out;
+    }
+    /**
+     * The navigable URL recorded as of `timestamp` (§5) — sugar over `statesAt`,
+     * which folds the synthetic `Route#1` snapshot exactly like any instance.
+     * `undefined` when the session carries no route snapshot ≤ t.
+     */
+    routeAt(timestamp) {
+        const route = this.statesAt(timestamp).get("Route#1");
+        return route?.path;
+    }
+    /** Events within `[from, to]` (inclusive) — for stepping a timeline UI (§5). */
+    eventsBetween(from, to) {
+        return this.bundle.events.filter((e) => e.timestamp >= from && e.timestamp <= to);
+    }
+    /** All recorded events, in order. */
+    get events() {
+        return this.bundle.events;
+    }
+    /** Total session duration in ms. */
+    get duration() {
+        return this.bundle.duration;
+    }
+    /**
+     * Fold all instance states up to and including the snapshot at position
+     * `endIndex` in the global snapshot array. Used by `diffBundles` to pair
+     * snapshots by ordinal rather than timestamp, so that same-timestamp
+     * clustered commits are each treated as a distinct ordinal (B1 fix).
+     *
+     * Not exposed in the public API — consumers use `statesAt(timestamp)`.
+     */
+    statesUpToIndex(endIndex) {
+        const out = new Map();
+        for (let i = 0; i <= endIndex && i < this.snapshots.length; i++) {
+            const s = this.snapshots[i];
+            if (!this.deltaAware || s.keyframe)
+                out.set(s.componentId, { ...s.state });
+            else
+                out.set(s.componentId, { ...(out.get(s.componentId) ?? {}), ...s.state });
+        }
+        return out;
+    }
+    /** Binary search: the index of the last snapshot with `timestamp ≤ t`, or -1. */
+    lastSnapshotIndexAtOrBefore(t) {
+        let lo = 0;
+        let hi = this.snapshots.length - 1;
+        let ans = -1;
+        while (lo <= hi) {
+            const mid = (lo + hi) >> 1;
+            if (this.snapshots[mid].timestamp <= t) {
+                ans = mid;
+                lo = mid + 1;
+            }
+            else {
+                hi = mid - 1;
+            }
+        }
+        return ans;
+    }
+}
+/**
+ * Per-instance snapshot records in RECORDED ORDER: `{ globalIndex, timestamp }`.
+ * `globalIndex` is the position in the bundle's full snapshot array (all instances).
+ *
+ * Intentionally keeps duplicates: if two snapshots for the same instance land
+ * at the same millisecond (clustered commits), each is a distinct entry.
+ * Using a Set of unique timestamps would drop one, shifting all subsequent
+ * ordinals and pairing A's k-th snapshot against B's (k-1)-th → phantom
+ * divergences. The pairing contract is per snapshot-sequence position, not
+ * per unique timestamp.
+ */
+const instanceSnapshotEntries = (bundle, id) => {
+    const out = [];
+    let gi = 0;
+    for (const e of bundle.events) {
+        if (e.type === "state_snapshot") {
+            if (e.componentId === id)
+                out.push({ globalIndex: gi, timestamp: e.timestamp });
+            gi++;
+        }
+    }
+    return out;
+};
+/** All action names for one instance, in recorded order (with duplicates). */
+const instanceActionNames = (bundle, id) => bundle.events
+    .filter((e) => e.type === "action" && e.componentId === id)
+    .map((e) => e.name);
+/** All resource names for one instance, in recorded order (with duplicates). */
+const instanceResourceNames = (bundle, id) => bundle.events
+    .filter((e) => e.type === "resource" && e.componentId === id)
+    .map((e) => e.name);
+/** Items in `a` that are absent from `b` (min-truncated, positional). */
+const onlyIn = (a, b) => {
+    const count = new Map();
+    for (const x of b)
+        count.set(x, (count.get(x) ?? 0) + 1);
+    const result = [];
+    for (const x of a) {
+        const rem = count.get(x) ?? 0;
+        if (rem === 0)
+            result.push(x);
+        else
+            count.set(x, rem - 1);
+    }
+    return result;
+};
+/**
+ * Compare two recorded `SessionBundle`s and return the structured diff
+ * (diff plan §4).
+ *
+ * Alignment: per-instance event ordinal — A's k-th snapshot ↔ B's k-th.
+ * Correct when both sessions ran the same component through a comparable
+ * commit sequence. Pairs truncate at `min(stopsA, stopsB)`; the unpaired
+ * tail is reported as `unpairedA`/`unpairedB`.
+ *
+ * Version-aware: reads state through `ReplayPlayer.statesAt` so 2.0
+ * (all-keyframe) and 2.1 (delta) bundles fold to equal states when the
+ * recorded logical state is the same (diff plan §6 scenario 6).
+ *
+ * Pure — no React, no DOM, no module singletons (COND-4). Safe to call in
+ * tests, workers, and server-side code.
+ *
+ * @remarks v1 aligns by per-instance snapshot ordinal only. The following are
+ * explicitly deferred (Replay §5): LCS/fuzzy action-sequence alignment,
+ * multi-instance fuzzy matching (e.g. `Board#2` ↔ `Board#3`), normalized-time
+ * or route-aware alignment, deep nested-value diff (beyond shallow JSON
+ * compare), three-way diff, and drive-in-compare.
+ */
+export const diffBundles = (a, b, opts) => {
+    const playerA = new ReplayPlayer(a);
+    const playerB = new ReplayPlayer(b);
+    // Collect all componentIds in either bundle.
+    const allIds = new Set();
+    for (const e of a.events)
+        allIds.add(e.componentId);
+    for (const e of b.events)
+        allIds.add(e.componentId);
+    // Apply componentName filter if requested.
+    const ids = opts?.componentName
+        ? [...allIds].filter((id) => id === opts.componentName ||
+            id.startsWith(opts.componentName + "#"))
+        : [...allIds];
+    const instances = [];
+    let divergentStopCount = 0;
+    for (const id of ids) {
+        // B1 fix: align by per-instance SNAPSHOT SEQUENCE (globalIndex position),
+        // not by a Set of unique timestamps. Same-ms clustered commits each count
+        // as a distinct ordinal. Reading state via statesUpToIndex(globalIndex)
+        // folds exactly the snapshots recorded up to that position, so the state
+        // after the k-th snapshot is correct even when k and k+1 share a timestamp.
+        const entriesA = instanceSnapshotEntries(a, id);
+        const entriesB = instanceSnapshotEntries(b, id);
+        const inA = entriesA.length > 0;
+        const inB = entriesB.length > 0;
+        const presence = inA && inB ? "both" : inA ? "onlyA" : "onlyB";
+        const actionsA = instanceActionNames(a, id);
+        const actionsB = instanceActionNames(b, id);
+        const resourcesA = instanceResourceNames(a, id);
+        const resourcesB = instanceResourceNames(b, id);
+        if (presence !== "both") {
+            instances.push({
+                componentId: id,
+                presence,
+                stops: [],
+                unpairedA: presence === "onlyA"
+                    ? entriesA.map((e) => e.timestamp - a.startTime)
+                    : [],
+                unpairedB: presence === "onlyB"
+                    ? entriesB.map((e) => e.timestamp - b.startTime)
+                    : [],
+                actionsOnlyA: onlyIn(actionsA, actionsB),
+                actionsOnlyB: onlyIn(actionsB, actionsA),
+                resourcesOnlyA: onlyIn(resourcesA, resourcesB),
+                resourcesOnlyB: onlyIn(resourcesB, resourcesA),
+            });
+            continue;
+        }
+        const pairCount = Math.min(entriesA.length, entriesB.length);
+        const alignedStops = [];
+        for (let k = 0; k < pairCount; k++) {
+            const eA = entriesA[k];
+            const eB = entriesB[k];
+            const offsetA = eA.timestamp - a.startTime;
+            const offsetB = eB.timestamp - b.startTime;
+            // Read folded state up to this snapshot's global index (version-aware).
+            // Using statesUpToIndex rather than statesAt(timestamp) avoids the
+            // same-timestamp ambiguity: two snapshots at t=100 each have a distinct
+            // globalIndex, so statesUpToIndex folds exactly the right prefix.
+            const stateA = playerA.statesUpToIndex(eA.globalIndex).get(id);
+            const stateB = playerB.statesUpToIndex(eB.globalIndex).get(id);
+            const { changed, onlyA, onlyB } = diffKeysSymmetric(stateA, stateB);
+            const changedKeys = [
+                ...changed,
+                ...onlyA.map((key) => ({ key, valueA: stateA[key], valueB: undefined })),
+                ...onlyB.map((key) => ({ key, valueA: undefined, valueB: stateB[key] })),
+            ];
+            if (changedKeys.length > 0)
+                divergentStopCount++;
+            // Invariant: alignedStops[k].ordinal === k (the compare UI indexes stops
+            // by selectedOrdinal — inst.stops[selectedOrdinal] must be the right pair;
+            // maintained by always pushing in order with ordinal: k).
+            alignedStops.push({ ordinal: k, offsetA, offsetB, globalIndexA: eA.globalIndex, globalIndexB: eB.globalIndex, changedKeys });
+        }
+        instances.push({
+            componentId: id,
+            presence,
+            stops: alignedStops,
+            unpairedA: entriesA.slice(pairCount).map((e) => e.timestamp - a.startTime),
+            unpairedB: entriesB.slice(pairCount).map((e) => e.timestamp - b.startTime),
+            actionsOnlyA: onlyIn(actionsA, actionsB),
+            actionsOnlyB: onlyIn(actionsB, actionsA),
+            resourcesOnlyA: onlyIn(resourcesA, resourcesB),
+            resourcesOnlyB: onlyIn(resourcesB, resourcesA),
+        });
+    }
+    return { instances, divergentStopCount };
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@reactra/replay",
+  "version": "0.1.0-alpha.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@reactra/behaviours": "^0.1.0-alpha.0"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha",
+    "provenance": false
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/akhilshastri/reactra.git",
+    "directory": "packages/replay"
+  },
+  "homepage": "https://reactra-docs.vercel.app",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.18"
+  },
+  "sideEffects": false,
+  "description": "Reactra session replay — recording, streaming, re-drive, and diffing of Reactra app state."
+}