@bimetal/devtools 0.15.10 → 0.16.7

package/dist/replay-engine.d.ts

@@ -0,0 +1,128 @@
+/**
+ * `createReplayEngine` — pure synchrone Fold-Function über einen Stream.
+ *
+ * Architektur-Verträge aus `design/calendar/16-replay-target-architecture.md`:
+ * - **Passive Beobachtung**: Engine ruft NIEMALS `eventStore.append`,
+ *   `store.dispatch` oder `broker.publish`. Architecture-Test verriegelt.
+ * - **subscribe-first + buffer + read + drain**: kein Race-Window zwischen
+ *   Catch-up und Live-Tail (v0.15.7-Lehre).
+ * - **Sticky Error**: bei `apply`-Wurf wird `status = 'error'` und KEIN
+ *   weiteres Event mehr gefolded — sonst entstände Fold auf staleren
+ *   Zustand und der User sähe vorgegaukelten Aggregat-Stand.
+ * - **Recovery nur via `dispose()` + neuer `createReplayEngine`-Call.**
+ *   Engine kennt keine `clearError`-Operation.
+ *
+ * Implementations-Notes:
+ * - `handleEvent` ist **synchron** (Architektur-Vertrag).
+ * - Initial-Read ist async (das ist OK — `read()` ist der einzige
+ *   await; danach läuft alles synchron).
+ * - `snapshot`-Getter ist reference-stable bis zur nächsten Mutation
+ *   (analog Devtools-Registry, useSyncExternalStore-Vertrag).
+ */
+import type { DomainEvent, Unsubscribe } from '@bimetal/event-sourcing';
+import type { EventStoreLike } from './types.js';
+/**
+ * Domain-agnostisches Aggregate-Interface. Bewusst KEIN `handle(state, command)`
+ * — Command-Semantik gehört nicht in den Devtools-Vertrag.
+ */
+export interface AggregateLike<S> {
+    readonly initialState: S;
+    apply(state: S, event: DomainEvent): S;
+}
+export interface ProjectionLike<R> {
+    readonly initialState: R;
+    apply(readModel: R, event: DomainEvent): R;
+    readonly version: number;
+}
+/**
+ * Strukturelles SnapshotStore-Interface. Optional — Engine liest nur,
+ * schreibt NIE rein. Aktuell für Konsistenz-Checks reserviert (in v0.16.0
+ * noch nicht genutzt, kommt mit späterer Slice).
+ */
+export interface SnapshotStoreLike {
+    load(streamId: string): Promise<SnapshotLike | null>;
+}
+export interface SnapshotLike {
+    readonly state: unknown;
+    readonly projectionVersion: number;
+    readonly version: number;
+    readonly timestamp: number;
+}
+export interface ReplayTargetHandle<S = unknown, R = unknown> {
+    readonly id: string;
+    readonly name: string;
+    readonly eventStore: EventStoreLike;
+    readonly streamId: string;
+    readonly aggregate: AggregateLike<S>;
+    readonly projection: ProjectionLike<R>;
+    readonly snapshotStore?: SnapshotStoreLike;
+}
+export interface ReplayEngineSnapshot<S, R> {
+    readonly state: S;
+    readonly readModel: R;
+    /** `envelope.version` des zuletzt erfolgreich applied Events; `0` bei initialState. */
+    readonly lastAppliedVersion: number;
+    readonly status: 'replaying' | 'live' | 'error';
+    /**
+     * Bei `status='error'`: gesetzt, mit `event` als der Event, der den
+     * Fehler auslöste — oder als der zuletzt blockierte Event (nach
+     * status='error' aktualisiert sich `event` mit jedem eingehenden,
+     * nicht-applied Event, damit der User „letzter blockierter Event war v9"
+     * sehen kann). `event=null` zeigt: Fehler kam aus `read()`, nicht aus `apply()`.
+     */
+    readonly lastError?: {
+        readonly event: DomainEvent | null;
+        readonly error: Error;
+    };
+    readonly lastAppliedEventId?: string;
+    /**
+     * `metadata.schemaVersion` des zuletzt erfolgreich applied Events.
+     * Konsumenten-UI vergleicht das mit der `projection.version` aus dem
+     * Handle, um Schema-Drift sichtbar zu machen (v0.16-Architektur-Doc
+     * Leitplanke 6).
+     */
+    readonly lastAppliedSchemaVersion?: number;
+    /** Events nach `status='error'` eingegangen, aber NICHT applied. */
+    readonly blockedEventCount: number;
+}
+export interface ReplayEngine<S, R> {
+    /** Reference-stable bis zur nächsten Mutation. */
+    readonly snapshot: ReplayEngineSnapshot<S, R>;
+    subscribe(listener: () => void): Unsubscribe;
+    /** Cleanup: stoppt Live-Subscriber, befreit Listener. */
+    dispose(): void;
+}
+/**
+ * Initialer Snapshot für eine fresh angesetzte Replay-Sequenz. `status`
+ * beginnt bei `'replaying'`; der Konsument (Engine ODER TimeTravelController)
+ * entscheidet selbst, wann er auf `'live'`/`'ready'` umschaltet.
+ */
+export declare function createInitialSnapshot<S, R>(aggregate: AggregateLike<S>, projection: ProjectionLike<R>): ReplayEngineSnapshot<S, R>;
+/**
+ * Pure synchroner Fold von genau einem Event auf einen Snapshot.
+ *
+ * **Atomarer Commit:** beide `apply`-Aufrufe (aggregate + projection)
+ * laufen ZUERST in lokale `next*`-Variablen. Erst wenn BEIDE
+ * erfolgreich sind, wird das neue Snapshot-Objekt mit allen Tracking-
+ * Feldern (`lastAppliedVersion`, `lastAppliedEventId`,
+ * `lastAppliedSchemaVersion`) zurückgegeben. Wirft `projection.apply`,
+ * ist `nextState` lokal verloren, der Input-`snap` bleibt unverändert —
+ * Half-Update unmöglich.
+ *
+ * **Sticky-Error:** Bei Input-`snap.status === 'error'` wird der Event
+ * NICHT applied. Output trägt `blockedEventCount + 1` und ein
+ * aktualisiertes `lastError.event` (auf den jeweils zuletzt blockierten
+ * Event), damit der User „letzter blockierter Event war v9" sehen kann.
+ *
+ * **Nichts read/subscribe-bezogenes.** Reine Funktion: Snapshot rein,
+ * Event rein, Snapshot raus. Live-Engine UND TimeTravelController
+ * konsumieren dieselbe Funktion.
+ */
+export declare function applyEventToSnapshot<S, R>(snap: ReplayEngineSnapshot<S, R>, event: DomainEvent, aggregate: AggregateLike<S>, projection: ProjectionLike<R>): ReplayEngineSnapshot<S, R>;
+/**
+ * Convenience: Reduce über ein Array von Events — equivalent zu
+ * sequenziellem `applyEventToSnapshot`. Pure Funktion, keine Side-Effects.
+ */
+export declare function foldEvents<S, R>(events: readonly DomainEvent[], aggregate: AggregateLike<S>, projection: ProjectionLike<R>, initial: ReplayEngineSnapshot<S, R>): ReplayEngineSnapshot<S, R>;
+export declare function createReplayEngine<S, R>(handle: ReplayTargetHandle<S, R>): ReplayEngine<S, R>;
+//# sourceMappingURL=replay-engine.d.ts.map

package/dist/replay-engine.d.ts.map

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

package/dist/replay-engine.js

@@ -0,0 +1,199 @@
+/**
+ * `createReplayEngine` — pure synchrone Fold-Function über einen Stream.
+ *
+ * Architektur-Verträge aus `design/calendar/16-replay-target-architecture.md`:
+ * - **Passive Beobachtung**: Engine ruft NIEMALS `eventStore.append`,
+ *   `store.dispatch` oder `broker.publish`. Architecture-Test verriegelt.
+ * - **subscribe-first + buffer + read + drain**: kein Race-Window zwischen
+ *   Catch-up und Live-Tail (v0.15.7-Lehre).
+ * - **Sticky Error**: bei `apply`-Wurf wird `status = 'error'` und KEIN
+ *   weiteres Event mehr gefolded — sonst entstände Fold auf staleren
+ *   Zustand und der User sähe vorgegaukelten Aggregat-Stand.
+ * - **Recovery nur via `dispose()` + neuer `createReplayEngine`-Call.**
+ *   Engine kennt keine `clearError`-Operation.
+ *
+ * Implementations-Notes:
+ * - `handleEvent` ist **synchron** (Architektur-Vertrag).
+ * - Initial-Read ist async (das ist OK — `read()` ist der einzige
+ *   await; danach läuft alles synchron).
+ * - `snapshot`-Getter ist reference-stable bis zur nächsten Mutation
+ *   (analog Devtools-Registry, useSyncExternalStore-Vertrag).
+ */
+// ── Pure Fold-Core (v0.16.2 Sub 1) ────────────────────────────────
+/**
+ * Initialer Snapshot für eine fresh angesetzte Replay-Sequenz. `status`
+ * beginnt bei `'replaying'`; der Konsument (Engine ODER TimeTravelController)
+ * entscheidet selbst, wann er auf `'live'`/`'ready'` umschaltet.
+ */
+export function createInitialSnapshot(aggregate, projection) {
+    return {
+        state: aggregate.initialState,
+        readModel: projection.initialState,
+        lastAppliedVersion: 0,
+        status: 'replaying',
+        blockedEventCount: 0,
+    };
+}
+/**
+ * Pure synchroner Fold von genau einem Event auf einen Snapshot.
+ *
+ * **Atomarer Commit:** beide `apply`-Aufrufe (aggregate + projection)
+ * laufen ZUERST in lokale `next*`-Variablen. Erst wenn BEIDE
+ * erfolgreich sind, wird das neue Snapshot-Objekt mit allen Tracking-
+ * Feldern (`lastAppliedVersion`, `lastAppliedEventId`,
+ * `lastAppliedSchemaVersion`) zurückgegeben. Wirft `projection.apply`,
+ * ist `nextState` lokal verloren, der Input-`snap` bleibt unverändert —
+ * Half-Update unmöglich.
+ *
+ * **Sticky-Error:** Bei Input-`snap.status === 'error'` wird der Event
+ * NICHT applied. Output trägt `blockedEventCount + 1` und ein
+ * aktualisiertes `lastError.event` (auf den jeweils zuletzt blockierten
+ * Event), damit der User „letzter blockierter Event war v9" sehen kann.
+ *
+ * **Nichts read/subscribe-bezogenes.** Reine Funktion: Snapshot rein,
+ * Event rein, Snapshot raus. Live-Engine UND TimeTravelController
+ * konsumieren dieselbe Funktion.
+ */
+export function applyEventToSnapshot(snap, event, aggregate, projection) {
+    if (snap.status === 'error') {
+        return {
+            ...snap,
+            blockedEventCount: snap.blockedEventCount + 1,
+            lastError: snap.lastError
+                ? { event, error: snap.lastError.error }
+                : snap.lastError,
+        };
+    }
+    try {
+        const nextState = aggregate.apply(snap.state, event);
+        const nextReadModel = projection.apply(snap.readModel, event);
+        return {
+            ...snap,
+            state: nextState,
+            readModel: nextReadModel,
+            lastAppliedVersion: event.envelope.version,
+            lastAppliedEventId: event.envelope.id,
+            lastAppliedSchemaVersion: event.metadata.schemaVersion,
+        };
+    }
+    catch (error) {
+        return {
+            ...snap,
+            status: 'error',
+            lastError: { event, error: error instanceof Error ? error : new Error(String(error)) },
+        };
+    }
+}
+/**
+ * Convenience: Reduce über ein Array von Events — equivalent zu
+ * sequenziellem `applyEventToSnapshot`. Pure Funktion, keine Side-Effects.
+ */
+export function foldEvents(events, aggregate, projection, initial) {
+    let current = initial;
+    for (const event of events) {
+        current = applyEventToSnapshot(current, event, aggregate, projection);
+    }
+    return current;
+}
+// ── Factory ───────────────────────────────────────────────────────
+export function createReplayEngine(handle) {
+    let current = createInitialSnapshot(handle.aggregate, handle.projection);
+    const listeners = new Set();
+    function invalidate() {
+        for (const l of listeners) {
+            try {
+                l();
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console
+                console.error('[@bimetal/devtools] ReplayEngine listener threw:', err);
+            }
+        }
+    }
+    function applyEvent(event) {
+        current = applyEventToSnapshot(current, event, handle.aggregate, handle.projection);
+        invalidate();
+    }
+    // ── Lifecycle: subscribe-first + buffer + read + drain ──────────
+    const pendingBuffer = [];
+    let drained = false;
+    let disposed = false;
+    // 1. ZUERST subscribe — Events ab jetzt landen im Buffer (bis drained=true).
+    const off = handle.eventStore.subscribe((event) => {
+        if (disposed)
+            return;
+        if (!drained) {
+            pendingBuffer.push(event);
+            return;
+        }
+        applyEvent(event);
+    }, handle.streamId);
+    // 2. Dann read() für historische Events. Async — danach drain mit
+    //    envelope.version-basierter Dedup gegen den pendingBuffer.
+    void (async () => {
+        try {
+            const initial = await handle.eventStore.read(handle.streamId);
+            if (disposed)
+                return;
+            // 3. Fold initial
+            for (const event of initial) {
+                applyEvent(event);
+            }
+            // 4. Drain pendingBuffer mit Versions-Dedup gegen initial. Garantie:
+            //    jedes Event aus dem Stream wird genau einmal applied.
+            const lastInitialVersion = initial.length > 0
+                ? initial[initial.length - 1].envelope.version
+                : 0;
+            for (const event of pendingBuffer) {
+                if (event.envelope.version > lastInitialVersion) {
+                    applyEvent(event);
+                }
+            }
+            pendingBuffer.length = 0;
+            drained = true;
+            // 5. Status-Übergang: 'replaying' → 'live' nur wenn kein apply-Fehler
+            //    während des initial-Folds ausgelöst wurde.
+            if (current.status === 'replaying') {
+                current = { ...current, status: 'live' };
+                invalidate();
+            }
+        }
+        catch (error) {
+            // read() wirft → Error-State, off() bleibt aktiv damit Engine
+            // sichtbar bleibt; dispose() vom Konsumenten räumt auf.
+            current = {
+                ...current,
+                status: 'error',
+                lastError: { event: null, error: error instanceof Error ? error : new Error(String(error)) },
+            };
+            drained = true; // verhindere Buffer-Akkumulation bei Folge-Events
+            pendingBuffer.length = 0;
+            invalidate();
+        }
+    })();
+    return {
+        /**
+         * Reference-stable: `current` ist das Snapshot-Objekt; jede Mutation
+         * ersetzt es vollständig durch ein neues. Konsument vergleicht per
+         * Identität (=`===`), keine Deep-Eq nötig.
+         */
+        get snapshot() {
+            return current;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            off();
+            listeners.clear();
+            pendingBuffer.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=replay-engine.js.map

package/dist/replay-engine.js.map

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

package/dist/snapshot-export.d.ts

@@ -0,0 +1,73 @@
+/**
+ * v0.16.6 — DevtoolsSnapshot Export/Import.
+ *
+ * Captured Stream + State exportierbar als versioniertes JSON-Dokument;
+ * Loader-API für späteren Sandbox-Replay. Sandbox-UI ist NICHT v0.16.6
+ * (eigene Slice).
+ *
+ * **Verträge (Pilot-Verriegelungen 2026-06-09):**
+ * - `exportSnapshot(state, { exportedAt })` — Konsument liefert die
+ *   Zeit. Helper ist pure: keine Zeit-/Zufalls-/Konsolen-APIs. Die
+ *   konkreten verbotenen Identifier sind im Architecture-Test
+ *   verriegelt; diese Quelle vermeidet sie auch in Kommentaren, damit
+ *   der Source-Scan einfach bleibt. Der State wird beim Erzeugen via
+ *   `toInspectableJson` normalisiert + detached — Mutationen am Live-
+ *   State treffen den Snapshot nicht (Sub-1-Pilot-Schärfung).
+ * - `serializeSnapshot(snap)` — reines `JSON.stringify`. Snapshot ist
+ *   bereits JSON-normalisiert beim Erzeugen, daher kein Pipeline-Schritt
+ *   mehr. Lossy-Charakter (Map/Set/BigInt → JSON-Form, zyklische
+ *   Strukturen → marker) gehört zum Snapshot-Format selbst, nicht zu
+ *   Serialize: Sandbox-Replay ist Diagnose, kein Round-Trip-Beweis.
+ * - `parseSnapshot(json)` — strukturelle Validierung. Wirft bei
+ *   JSON-Parse-Fehler, Nicht-Objekt-Top-Level, falscher `version`,
+ *   nicht-finite `exportedAt`, fehlendem `state` oder fehlenden/
+ *   falsch-typisierten Pflicht-State-Feldern. Tiefe Domain-Schema-
+ *   Validierung NICHT in v0.16.6.
+ */
+import type { DevtoolsState } from './types.js';
+/**
+ * Format-Version als zentrale Konstante. Pilot-Verriegelung 2026-06-09
+ * (Sub-1-Schärfung): Architecture-Test prüft den Wert dieser Konstante
+ * direkt, statt freie `version:`-Literale im Source zu scannen. Eine
+ * spätere Slice, die das Format ändert, MUSS die Konstante hier ändern
+ * — und nichts anderes funktioniert ohne diese Stelle anzufassen.
+ */
+export declare const SNAPSHOT_VERSION: "1.0.0";
+export interface DevtoolsSnapshot {
+    readonly version: typeof SNAPSHOT_VERSION;
+    readonly exportedAt: number;
+    /**
+     * JSON-normalisierte Form von `DevtoolsState`. Lossy: Map→Object,
+     * Date→ISO, BigInt→string, Function→null, Cycle→marker. Strukturell
+     * äquivalent zum übergebenen State, aber NICHT typ-identisch und
+     * **detached** — Mutationen am ursprünglichen State treffen den
+     * Snapshot nicht.
+     */
+    readonly state: DevtoolsState;
+}
+export interface ExportSnapshotOptions {
+    readonly exportedAt: number;
+}
+/**
+ * Versioniertes Snapshot-Dokument bauen. Pilot-Schärfung Sub 1
+ * (HIGH-Finding): der State wird beim Erzeugen via `toInspectableJson`
+ * normalisiert + detached. Damit ist `serializeSnapshot()` nur noch
+ * `JSON.stringify`, und ein Konsument, der nach `exportSnapshot()` die
+ * Registry weiter-mutiert, beeinflusst den Snapshot nicht.
+ *
+ * Pure: deterministisch über das `state`-Argument, `exportedAt` vom
+ * Konsumenten (kein Date-/Random-/Konsolen-API).
+ */
+export declare function exportSnapshot(state: DevtoolsState, options: ExportSnapshotOptions): DevtoolsSnapshot;
+/**
+ * JSON-String erzeugen. Snapshot ist bereits JSON-normalisiert (siehe
+ * `exportSnapshot`), daher reicht `JSON.stringify`.
+ */
+export declare function serializeSnapshot(snap: DevtoolsSnapshot): string;
+/**
+ * Strukturelle Validierung: Top-Level-Form, `version`, `exportedAt`,
+ * `state` und die sieben benannten Array-Felder. Wirft mit konkreter
+ * Message pro Verletzung.
+ */
+export declare function parseSnapshot(json: string): DevtoolsSnapshot;
+//# sourceMappingURL=snapshot-export.d.ts.map

package/dist/snapshot-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-export.d.ts","sourceRoot":"","sources":["../src/snapshot-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,qBAAqB,GAC7B,gBAAgB,CAMlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAEhE;AAiBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAqC5D"}

package/dist/snapshot-export.js

@@ -0,0 +1,119 @@
+/**
+ * v0.16.6 — DevtoolsSnapshot Export/Import.
+ *
+ * Captured Stream + State exportierbar als versioniertes JSON-Dokument;
+ * Loader-API für späteren Sandbox-Replay. Sandbox-UI ist NICHT v0.16.6
+ * (eigene Slice).
+ *
+ * **Verträge (Pilot-Verriegelungen 2026-06-09):**
+ * - `exportSnapshot(state, { exportedAt })` — Konsument liefert die
+ *   Zeit. Helper ist pure: keine Zeit-/Zufalls-/Konsolen-APIs. Die
+ *   konkreten verbotenen Identifier sind im Architecture-Test
+ *   verriegelt; diese Quelle vermeidet sie auch in Kommentaren, damit
+ *   der Source-Scan einfach bleibt. Der State wird beim Erzeugen via
+ *   `toInspectableJson` normalisiert + detached — Mutationen am Live-
+ *   State treffen den Snapshot nicht (Sub-1-Pilot-Schärfung).
+ * - `serializeSnapshot(snap)` — reines `JSON.stringify`. Snapshot ist
+ *   bereits JSON-normalisiert beim Erzeugen, daher kein Pipeline-Schritt
+ *   mehr. Lossy-Charakter (Map/Set/BigInt → JSON-Form, zyklische
+ *   Strukturen → marker) gehört zum Snapshot-Format selbst, nicht zu
+ *   Serialize: Sandbox-Replay ist Diagnose, kein Round-Trip-Beweis.
+ * - `parseSnapshot(json)` — strukturelle Validierung. Wirft bei
+ *   JSON-Parse-Fehler, Nicht-Objekt-Top-Level, falscher `version`,
+ *   nicht-finite `exportedAt`, fehlendem `state` oder fehlenden/
+ *   falsch-typisierten Pflicht-State-Feldern. Tiefe Domain-Schema-
+ *   Validierung NICHT in v0.16.6.
+ */
+import { toInspectableJson } from './inspectable-json.js';
+/**
+ * Format-Version als zentrale Konstante. Pilot-Verriegelung 2026-06-09
+ * (Sub-1-Schärfung): Architecture-Test prüft den Wert dieser Konstante
+ * direkt, statt freie `version:`-Literale im Source zu scannen. Eine
+ * spätere Slice, die das Format ändert, MUSS die Konstante hier ändern
+ * — und nichts anderes funktioniert ohne diese Stelle anzufassen.
+ */
+export const SNAPSHOT_VERSION = '1.0.0';
+/**
+ * Versioniertes Snapshot-Dokument bauen. Pilot-Schärfung Sub 1
+ * (HIGH-Finding): der State wird beim Erzeugen via `toInspectableJson`
+ * normalisiert + detached. Damit ist `serializeSnapshot()` nur noch
+ * `JSON.stringify`, und ein Konsument, der nach `exportSnapshot()` die
+ * Registry weiter-mutiert, beeinflusst den Snapshot nicht.
+ *
+ * Pure: deterministisch über das `state`-Argument, `exportedAt` vom
+ * Konsumenten (kein Date-/Random-/Konsolen-API).
+ */
+export function exportSnapshot(state, options) {
+    return {
+        version: SNAPSHOT_VERSION,
+        exportedAt: options.exportedAt,
+        state: toInspectableJson(state),
+    };
+}
+/**
+ * JSON-String erzeugen. Snapshot ist bereits JSON-normalisiert (siehe
+ * `exportSnapshot`), daher reicht `JSON.stringify`.
+ */
+export function serializeSnapshot(snap) {
+    return JSON.stringify(snap, null, 2);
+}
+/**
+ * Liste der State-Felder, die `parseSnapshot` namentlich prüft. Pilot-
+ * Verriegelung: NICHT „irgendeine sieben Arrays" — exakt diese Namen.
+ * Reihenfolge ist die Reihenfolge der Throw-Tests.
+ */
+const REQUIRED_STATE_ARRAY_FIELDS = [
+    'events',
+    'syncRecords',
+    'bridgeRecords',
+    'eventStores',
+    'syncTransports',
+    'replayTargets',
+    'bridges',
+];
+/**
+ * Strukturelle Validierung: Top-Level-Form, `version`, `exportedAt`,
+ * `state` und die sieben benannten Array-Felder. Wirft mit konkreter
+ * Message pro Verletzung.
+ */
+export function parseSnapshot(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        throw new Error(`parseSnapshot: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('parseSnapshot: top-level must be a plain object');
+    }
+    const obj = parsed;
+    if (obj.version !== SNAPSHOT_VERSION) {
+        throw new Error(`parseSnapshot: unsupported version "${String(obj.version)}" — expected '${SNAPSHOT_VERSION}'`);
+    }
+    if (typeof obj.exportedAt !== 'number' || !Number.isFinite(obj.exportedAt)) {
+        throw new Error('parseSnapshot: exportedAt must be a finite number');
+    }
+    const state = obj.state;
+    if (state === null || typeof state !== 'object' || Array.isArray(state)) {
+        throw new Error('parseSnapshot: state must be a plain object');
+    }
+    const stateObj = state;
+    for (const fieldName of REQUIRED_STATE_ARRAY_FIELDS) {
+        if (!(fieldName in stateObj)) {
+            throw new Error(`parseSnapshot: state.${fieldName} is missing`);
+        }
+        if (!Array.isArray(stateObj[fieldName])) {
+            throw new Error(`parseSnapshot: state.${fieldName} must be an array (got ${typeOfDetailed(stateObj[fieldName])})`);
+        }
+    }
+    return parsed;
+}
+function typeOfDetailed(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+//# sourceMappingURL=snapshot-export.js.map

package/dist/snapshot-export.js.map

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

package/dist/time-travel.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `createTimeTravelController` — ephemerer Controller, baut View-State zu
+ * einer beliebigen Stream-Version (v0.16.2 Sub 3).
+ *
+ * Architektur-Verträge aus `design/calendar/16-replay-target-architecture.md`:
+ * - **Eigene Subscribe-Seite**, NICHT im `DevtoolsState`-Snapshot — Slider-
+ *   Bewegungen churchen nicht die Always-On-Listener im Inspector.
+ * - **Pure Fold-Kern wiederverwendet**: nutzt `foldEvents` aus
+ *   `replay-engine.ts`, KEINE eigene Engine. Live-Engine + Controller
+ *   produzieren bit-identische Snapshots (Sub 1 verriegelt).
+ * - **Stale-Cancel via running-counter**: schnelle Slider-Drags droppen
+ *   ältere `goTo`-Resolves silently.
+ * - **Kein Range-Read**: `eventStore.read(streamId)` komplett, filter
+ *   via `event.envelope.version <= targetVersion`. Optimierung erst mit
+ *   Snapshot-Reuse-Slice.
+ * - **dispose-safe**: alle Methoden silent no-op nach dispose.
+ * - **`view.status` ist eigenständig** ('idle' | 'loading' | 'ready' | 'error')
+ *   — getrennt von `view.snapshot.status` (das ist der Fold-Status:
+ *   'replaying' / 'live' / 'error'). UI nimmt `view.status` für den
+ *   Controller-Zustand, nicht den geschachtelten Snapshot-Status.
+ */
+import type { Unsubscribe } from '@bimetal/event-sourcing';
+import { type ReplayEngineSnapshot, type ReplayTargetHandle } from './replay-engine.js';
+import { type JsonDiffEntry } from './inspectable-json.js';
+export type TimeTravelStatus = 'idle' | 'loading' | 'ready' | 'error';
+export interface TimeTravelView<S = unknown, R = unknown> {
+    readonly status: TimeTravelStatus;
+    /** Aktuelle Ziel-Version. Beim ersten `goTo(v)` wird das `v`. */
+    readonly cursor: number;
+    /** Snapshot zur `cursor`-Version. `state`/`readModel` ableitbar. */
+    readonly snapshot: ReplayEngineSnapshot<S, R>;
+    /** Höchste im Stream gesehene Version beim letzten erfolgreichen `goTo`. */
+    readonly maxVersion: number;
+    readonly lastError?: Error;
+}
+export interface TimeTravelController<S = unknown, R = unknown> {
+    /** Reference-stable bis zur nächsten Mutation. */
+    readonly view: TimeTravelView<S, R>;
+    subscribe(listener: () => void): Unsubscribe;
+    /**
+     * Setzt den Cursor und re-faltet den Stream bis zu dieser Version.
+     * Stale-Cancel: ein neuer `goTo`-Aufruf invalidiert ältere laufende
+     * Reads — wenn die ältere `read`-Promise später resolved, wird ihr
+     * Resultat verworfen.
+     */
+    goTo(version: number): Promise<void>;
+    /**
+     * Diff zwischen `view.snapshot.state` und einem Vergleichs-State.
+     * - Ohne Argument: gegen Live (= alle Events gefoldet).
+     * - Mit `compareToVersion`: gegen genau diese Version.
+     *
+     * Diff operiert auf `state` (nicht `readModel`) — der Aggregate-Stand
+     * ist der semantische Anker. UI kann zusätzlich `readModel`-Diff
+     * anzeigen, indem sie `jsonDiff(currentView.snapshot.readModel, ...)`
+     * direkt ruft; das ist Konsumenten-Konzern.
+     */
+    diff(compareToVersion?: number): Promise<readonly JsonDiffEntry[]>;
+    /** Cleanup. Idempotent. Nach `dispose()` no-op'en alle Methoden. */
+    dispose(): void;
+}
+export declare function createTimeTravelController<S, R>(handle: ReplayTargetHandle<S, R>): TimeTravelController<S, R>;
+//# sourceMappingURL=time-travel.d.ts.map

package/dist/time-travel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-travel.d.ts","sourceRoot":"","sources":["../src/time-travel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAC5D,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IAC7C;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC;;;;;;;;;OASG;IACH,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACnE,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAC7C,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC/B,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CA8H5B"}