@bimetal/devtools 0.15.3 → 0.16.1

package/dist/observed-helpers.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Observe-Helper für Konsumenten (v0.16.5 Sub 2).
+ *
+ * Bisher lebten diese Helper in `apps/demo/src/event-inspector/setup.ts`
+ * als Singleton-gebundene Funktionen. Mit der `@bimetal/devtools-react`-
+ * Extraktion ziehen sie hierher um — als reine TS-Wrapper, weil sie
+ * registry-agnostisch sind und keinen React-Bezug haben.
+ *
+ * **Vertrag:**
+ * - `registry` ist Pflicht-Argument (kein impliziter Singleton).
+ * - `id` ist Pflicht-Argument (kein versteckter Module-Level-Counter).
+ * - Pro Helper-Aufruf eine eigene `DiagnosticsSource` (sonst fan-outet
+ *   ein gemeinsamer Source jedes Event an N Registry-Listener).
+ * - Returnt `unregister`-Unsubscribe; Konsument MUSS aufrufen im
+ *   useEffect-Cleanup / Variant-Teardown.
+ *
+ * **Boundary:** Die Helper hängen an `@bimetal/event-sourcing`
+ * (`createInMemoryEventStore` als Default + `EventStore`-Type). Das ist
+ * konsistent mit der bestehenden devtools→event-sourcing-Abhängigkeit;
+ * Bridge-Wrapper aus v0.16.4 macht das genauso.
+ */
+import type { EventStore } from '@bimetal/event-sourcing';
+import type { DevtoolsRegistry } from './registry.js';
+import type { AggregateLike, ProjectionLike, ReplayTargetHandle } from './replay-engine.js';
+import type { DiagnosticsSource, Unsubscribe } from './types.js';
+export interface ObservedEventStoreOptions {
+    readonly id: string;
+    /** Default: gleicher Wert wie `id`. */
+    readonly name?: string;
+}
+export interface ObservedEventStoreHandle {
+    readonly eventStore: EventStore;
+    /**
+     * Demontiert den Store aus dem Registry. Konsument MUSS aufrufen,
+     * sonst akkumulieren stale Store-Handles im Inspector über
+     * Variant-/Component-Wechsel hinweg.
+     */
+    readonly unregister: Unsubscribe;
+}
+/**
+ * Drop-in-Wrapper für `createInMemoryEventStore()`, der den Store
+ * gleichzeitig im `DevtoolsRegistry` anmeldet.
+ *
+ * Pro Aufruf eine eigene `DiagnosticsSource`. Sub-Klasse-Effekt: Events
+ * landen 1:1 in `state.events`, keine N-fach-Duplikate.
+ */
+export declare function createObservedEventStore(registry: DevtoolsRegistry, options: ObservedEventStoreOptions): ObservedEventStoreHandle;
+export interface ObservedSyncTransportOptions {
+    readonly id: string;
+    /** Default: gleicher Wert wie `id`. */
+    readonly name?: string;
+}
+export interface ObservedSyncTransportHandle {
+    /**
+     * `DiagnosticsSink`, den der Konsument an `createInMemorySync*` /
+     * `createWebSocketSync` als `{ diagnostics }` weitergibt. Pro Aufruf
+     * eine eigene Source — keine Cross-Transport-Lecks.
+     */
+    readonly diagnostics: DiagnosticsSource;
+    /** Stabile transportId, die der Adapter via `{ transportId }` nutzt. */
+    readonly transportId: string;
+    readonly unregister: Unsubscribe;
+}
+/**
+ * Erzeugt eine `DiagnosticsSource` + meldet den Transport beim
+ * Registry an. Konsument bindet `diagnostics` + `transportId` an seinen
+ * Sync-Adapter; Records erscheinen dann im Sync-Tab des Inspectors.
+ */
+export declare function createObservedSyncTransport(registry: DevtoolsRegistry, options: ObservedSyncTransportOptions): ObservedSyncTransportHandle;
+export interface ObservedReplayTargetOptions<S, R> {
+    readonly id: string;
+    /** Default: gleicher Wert wie `id`. */
+    readonly name?: string;
+    readonly eventStore: ReplayTargetHandle<S, R>['eventStore'];
+    readonly streamId: string;
+    readonly aggregate: AggregateLike<S>;
+    readonly projection: ProjectionLike<R>;
+}
+export interface ObservedReplayTargetHandle {
+    readonly unregister: Unsubscribe;
+}
+/**
+ * Registriert ein passives ReplayTarget am Registry. Engine baut den
+ * Stream-State live durch; im Inspector erscheint das Target als
+ * Eintrag im State-Tab.
+ */
+export declare function createObservedReplayTarget<S, R>(registry: DevtoolsRegistry, options: ObservedReplayTargetOptions<S, R>): ObservedReplayTargetHandle;
+//# sourceMappingURL=observed-helpers.d.ts.map

package/dist/observed-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed-helpers.d.ts","sourceRoot":"","sources":["../src/observed-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAU1B;AAID,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAY7B;AAID,MAAM,WAAW,2BAA2B,CAAC,CAAC,EAAE,CAAC;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAC7C,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,GACzC,0BAA0B,CAU5B"}

package/dist/observed-helpers.js

@@ -0,0 +1,76 @@
+/**
+ * Observe-Helper für Konsumenten (v0.16.5 Sub 2).
+ *
+ * Bisher lebten diese Helper in `apps/demo/src/event-inspector/setup.ts`
+ * als Singleton-gebundene Funktionen. Mit der `@bimetal/devtools-react`-
+ * Extraktion ziehen sie hierher um — als reine TS-Wrapper, weil sie
+ * registry-agnostisch sind und keinen React-Bezug haben.
+ *
+ * **Vertrag:**
+ * - `registry` ist Pflicht-Argument (kein impliziter Singleton).
+ * - `id` ist Pflicht-Argument (kein versteckter Module-Level-Counter).
+ * - Pro Helper-Aufruf eine eigene `DiagnosticsSource` (sonst fan-outet
+ *   ein gemeinsamer Source jedes Event an N Registry-Listener).
+ * - Returnt `unregister`-Unsubscribe; Konsument MUSS aufrufen im
+ *   useEffect-Cleanup / Variant-Teardown.
+ *
+ * **Boundary:** Die Helper hängen an `@bimetal/event-sourcing`
+ * (`createInMemoryEventStore` als Default + `EventStore`-Type). Das ist
+ * konsistent mit der bestehenden devtools→event-sourcing-Abhängigkeit;
+ * Bridge-Wrapper aus v0.16.4 macht das genauso.
+ */
+import { createInMemoryEventStore } from '@bimetal/event-sourcing';
+import { createDiagnosticsSource } from './diagnostics-source.js';
+/**
+ * Drop-in-Wrapper für `createInMemoryEventStore()`, der den Store
+ * gleichzeitig im `DevtoolsRegistry` anmeldet.
+ *
+ * Pro Aufruf eine eigene `DiagnosticsSource`. Sub-Klasse-Effekt: Events
+ * landen 1:1 in `state.events`, keine N-fach-Duplikate.
+ */
+export function createObservedEventStore(registry, options) {
+    const source = createDiagnosticsSource();
+    const eventStore = createInMemoryEventStore({ diagnostics: source });
+    const unregister = registry.registerEventStore({
+        id: options.id,
+        name: options.name ?? options.id,
+        eventStore,
+        diagnostics: source,
+    });
+    return { eventStore, unregister };
+}
+/**
+ * Erzeugt eine `DiagnosticsSource` + meldet den Transport beim
+ * Registry an. Konsument bindet `diagnostics` + `transportId` an seinen
+ * Sync-Adapter; Records erscheinen dann im Sync-Tab des Inspectors.
+ */
+export function createObservedSyncTransport(registry, options) {
+    const diagnostics = createDiagnosticsSource();
+    const unregister = registry.registerSyncTransport({
+        id: options.id,
+        name: options.name ?? options.id,
+        diagnostics,
+    });
+    return {
+        diagnostics,
+        transportId: options.id,
+        unregister,
+    };
+}
+/**
+ * Registriert ein passives ReplayTarget am Registry. Engine baut den
+ * Stream-State live durch; im Inspector erscheint das Target als
+ * Eintrag im State-Tab.
+ */
+export function createObservedReplayTarget(registry, options) {
+    const unregister = registry.registerReplayTarget({
+        id: options.id,
+        name: options.name ?? options.id,
+        eventStore: options.eventStore,
+        streamId: options.streamId,
+        aggregate: options.aggregate,
+        projection: options.projection,
+    });
+    return { unregister };
+}
+//# sourceMappingURL=observed-helpers.js.map

package/dist/observed-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed-helpers.js","sourceRoot":"","sources":["../src/observed-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAuBlE;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA0B,EAC1B,OAAkC;IAElC,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,wBAAwB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,kBAAkB,CAAC;QAC7C,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE;QAChC,UAAU;QACV,WAAW,EAAE,MAAM;KACpB,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC;AAsBD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAA0B,EAC1B,OAAqC;IAErC,MAAM,WAAW,GAAG,uBAAuB,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,qBAAqB,CAAC;QAChD,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE;QAChC,WAAW;KACZ,CAAC,CAAC;IACH,OAAO;QACL,WAAW;QACX,WAAW,EAAE,OAAO,CAAC,EAAE;QACvB,UAAU;KACX,CAAC;AACJ,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAA0B,EAC1B,OAA0C;IAE1C,MAAM,UAAU,GAAG,QAAQ,CAAC,oBAAoB,CAAC;QAC/C,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/dist/registry.d.ts

@@ -17,16 +17,63 @@
  * **Identity-Modell:** Stores werden über ihre `id` geführt, `name` ist
  * Display-only. Duplikat-Check ist auf `id`.
  */
-import type { DevtoolsState, EventStoreHandle, Unsubscribe } from './types.js';
+import type { BridgeHandle, DevtoolsState, EventStoreHandle, SyncTransportHandle, Unsubscribe } from './types.js';
+import { type ReplayTargetHandle } from './replay-engine.js';
+import { type TimeTravelController } from './time-travel.js';
 export interface DevtoolsRegistryOptions {
     /**
      * Rolling-window size for captured events. Older events drop out.
      * Default 10 000.
      */
     readonly maxEvents?: number;
+    /**
+     * Rolling-window size for captured sync records (v0.15.5).
+     * Default 10 000.
+     */
+    readonly maxSyncRecords?: number;
+    /**
+     * Rolling-window size for captured bridge records (v0.16.4).
+     * Default 10 000.
+     */
+    readonly maxBridgeRecords?: number;
 }
 export interface DevtoolsRegistry {
     registerEventStore(handle: EventStoreHandle): Unsubscribe;
+    registerSyncTransport(handle: SyncTransportHandle): Unsubscribe;
+    /**
+     * Registriert ein ReplayTarget (v0.16.0). Engine wird intern erzeugt
+     * und folded den Stream live durch — der Konsument hat nichts zu
+     * subscribieren. Snapshot ist über `state.replayTargets` reichbar.
+     *
+     * Multiple Targets pro Stream sind erlaubt (verschiedene `handle.id`):
+     * z. B. ein Domain-Aggregate plus ein statistisches Side-Read-Model.
+     * Doppelte `handle.id` wirft.
+     */
+    registerReplayTarget(handle: ReplayTargetHandle): Unsubscribe;
+    /**
+     * Factory für einen ephemeren TimeTravelController über das mit
+     * `targetId` registrierte ReplayTarget (v0.16.2). Controller lebt
+     * außerhalb des `DevtoolsState`-Snapshots — Slider-Bewegungen churchen
+     * nicht die Always-On-Listener im Inspector.
+     *
+     * Wirft, wenn `targetId` nicht registriert ist. Mehrere Controller
+     * auf demselben Target sind erlaubt (z. B. zwei UI-Panels, die
+     * unabhängig durch die Historie scrollen).
+     */
+    createTimeTravelController(targetId: string): TimeTravelController;
+    /**
+     * Registriert eine Bridge (v0.16.4). Konsument liefert ein
+     * `BridgeHandle` mit eigener `BridgeDiagnosticsSource`; die Registry
+     * subscribet darauf und pumpt `BridgeRecord`s ins rolling-window.
+     *
+     * Doppelte `handle.id` wirft. Mehrere Bridges auf demselben Source/
+     * Target-Paar sind erlaubt (z. B. zwei verschiedene `toTopic`-Mappings).
+     *
+     * Üblicher Aufrufer ist `createObservedBridge`, der das Handle intern
+     * baut. Konsumenten mit eigener Bridge-Implementation können direkt
+     * registrieren.
+     */
+    registerBridge(handle: BridgeHandle): Unsubscribe;
     readonly state: DevtoolsState;
     subscribe(listener: (state: DevtoolsState) => void): Unsubscribe;
 }

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAEV,aAAa,EACb,gBAAgB,EAEhB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW,CAAC;CAClE;AAID,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAkFlB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,YAAY,EAIZ,aAAa,EACb,gBAAgB,EAKhB,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAyC,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEzF,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAC1D,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,CAAC;IAChE;;;;;;;;OAQG;IACH,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAAC;IAC9D;;;;;;;;;OASG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAAC;IACnE;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW,CAAC;CAClE;AAMD,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CA2NlB"}

package/dist/registry.js

@@ -17,20 +17,46 @@
  * **Identity-Modell:** Stores werden über ihre `id` geführt, `name` ist
  * Display-only. Duplikat-Check ist auf `id`.
  */
+import { createReplayEngine } from './replay-engine.js';
+import { createTimeTravelController } from './time-travel.js';
 const DEFAULT_MAX_EVENTS = 10_000;
+const DEFAULT_MAX_SYNC_RECORDS = 10_000;
+const DEFAULT_MAX_BRIDGE_RECORDS = 10_000;
 export function createDevtoolsRegistry(options = {}) {
     const maxEvents = options.maxEvents ?? DEFAULT_MAX_EVENTS;
+    const maxSyncRecords = options.maxSyncRecords ?? DEFAULT_MAX_SYNC_RECORDS;
+    const maxBridgeRecords = options.maxBridgeRecords ?? DEFAULT_MAX_BRIDGE_RECORDS;
     const eventStores = new Map();
     const events = [];
+    const syncTransports = new Map();
+    const syncRecords = [];
+    const replayTargets = new Map();
+    const bridges = new Map();
+    const bridgeRecords = [];
     const listeners = new Set();
     let nextSeq = 1;
     // Reference-stable snapshot. Invalidated on every mutation in notify().
     let cachedSnapshot = null;
     function getSnapshot() {
         if (cachedSnapshot === null) {
+            const targetsView = [];
+            for (const { handle, engine } of replayTargets.values()) {
+                targetsView.push({
+                    id: handle.id,
+                    name: handle.name,
+                    streamId: handle.streamId,
+                    projectionVersion: handle.projection.version,
+                    snapshot: engine.snapshot,
+                });
+            }
             cachedSnapshot = {
                 eventStores: Array.from(eventStores.values()),
                 events: events.slice(),
+                syncTransports: Array.from(syncTransports.values()),
+                syncRecords: syncRecords.slice(),
+                replayTargets: targetsView,
+                bridges: Array.from(bridges.values()),
+                bridgeRecords: bridgeRecords.slice(),
             };
         }
         return cachedSnapshot;
@@ -54,6 +80,18 @@ export function createDevtoolsRegistry(options = {}) {
             events.shift();
         }
     }
+    function pushSyncRecord(captured) {
+        syncRecords.push(captured);
+        while (syncRecords.length > maxSyncRecords) {
+            syncRecords.shift();
+        }
+    }
+    function pushBridgeRecord(captured) {
+        bridgeRecords.push(captured);
+        while (bridgeRecords.length > maxBridgeRecords) {
+            bridgeRecords.shift();
+        }
+    }
     return {
         registerEventStore(handle) {
             if (eventStores.has(handle.id)) {
@@ -80,6 +118,88 @@ export function createDevtoolsRegistry(options = {}) {
                 notify();
             };
         },
+        registerSyncTransport(handle) {
+            if (syncTransports.has(handle.id)) {
+                throw new Error(`@bimetal/devtools: SyncTransport with id "${handle.id}" already registered`);
+            }
+            syncTransports.set(handle.id, { id: handle.id, name: handle.name });
+            const offDiag = handle.diagnostics.subscribe((record) => {
+                if (typeof record.kind === 'string' && record.kind.startsWith('sync-')) {
+                    pushSyncRecord({
+                        seq: nextSeq++,
+                        transportId: handle.id,
+                        transportName: handle.name,
+                        capturedAt: Date.now(),
+                        record: record,
+                    });
+                    notify();
+                }
+            });
+            notify();
+            return () => {
+                offDiag();
+                syncTransports.delete(handle.id);
+                notify();
+            };
+        },
+        registerReplayTarget(handle) {
+            if (replayTargets.has(handle.id)) {
+                throw new Error(`@bimetal/devtools: ReplayTarget with id "${handle.id}" already registered`);
+            }
+            const engine = createReplayEngine(handle);
+            replayTargets.set(handle.id, { handle, engine });
+            // Engine-Mutationen invalidieren den Registry-Snapshot, sodass
+            // useSyncExternalStore-Konsumenten neu rendern.
+            const offEngine = engine.subscribe(() => notify());
+            notify();
+            return () => {
+                offEngine();
+                engine.dispose();
+                replayTargets.delete(handle.id);
+                notify();
+            };
+        },
+        createTimeTravelController(targetId) {
+            const entry = replayTargets.get(targetId);
+            if (!entry) {
+                throw new Error(`@bimetal/devtools: ReplayTarget with id "${targetId}" not registered — register first via registerReplayTarget()`);
+            }
+            return createTimeTravelController(entry.handle);
+        },
+        registerBridge(handle) {
+            if (bridges.has(handle.id)) {
+                throw new Error(`@bimetal/devtools: Bridge with id "${handle.id}" already registered`);
+            }
+            bridges.set(handle.id, {
+                id: handle.id,
+                name: handle.name,
+                kind: handle.kind,
+                source: handle.source,
+                target: handle.target,
+            });
+            const offDiag = handle.diagnostics.subscribe((record) => {
+                // structuredClone: das Forward-Pattern in createObservedBridge
+                // emittiert den Record VOR dem Publish-Call. Würde der Broker
+                // (oder ein Test-Stub) das Event-Objekt mutieren, würde sich der
+                // bereits captured Record nachträglich ändern. Pilot-Finding
+                // Sub 1. Clone hier zentral, damit jeder Captor (auch ein
+                // custom-Konsumenten-Handle) den Snapshot-Vertrag bekommt.
+                pushBridgeRecord({
+                    seq: nextSeq++,
+                    bridgeId: handle.id,
+                    bridgeName: handle.name,
+                    capturedAt: Date.now(),
+                    record: structuredClone(record),
+                });
+                notify();
+            });
+            notify();
+            return () => {
+                offDiag();
+                bridges.delete(handle.id);
+                notify();
+            };
+        },
         get state() {
             return getSnapshot();
         },

package/dist/registry.js.map

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

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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"}