@bimetal/devtools 0.15.3 → 0.16.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACrF,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;;GAKG;AACH,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,16 +1,45 @@
 /**
  * @module @bimetal/devtools
  *
- * Event-Debugger primitives (v0.14). Framework-agnostic registry +
+ * Event-Debugger primitives. Framework-agnostic registry +
  * diagnostics-source for auditing event-sourced systems.
  *
- * **Architektur-Leitplanken** (siehe `design/calendar/14-event-debugger-architecture.md`):
- * - Strukturelle Anbindung an EventStore — kein `EventStore`-Runtime-Import.
- * - Kein hartes `@bimetal/broker`-/`@bimetal/calendar-data`-Dependency.
- * - Devtools mutieren nichts: kein `append`, kein `dispatch`, kein `publish`.
- * - Explizite Registry, keine globalen Singletons, keine Auto-Registrierung.
- * - Production-Build-Strip via `import.meta.env.DEV`-Branch im Konsumenten.
+ * **Architektur-Leitplanken** (verriegelt durch
+ * `__tests__/architecture.test.ts`):
+ *
+ * - **Beobachtungs-Core ist passiv.** Registry + Diagnostics-Source +
+ *   ReplayEngine + TimeTravelController + Causation-Forest mutieren
+ *   nichts, lesen nur. Sub-Komponenten verriegeln das mit Boundary-Tests.
+ *
+ * - **Zwei dokumentierte Convenience-Allowlists** ab v0.16.4/v0.16.5:
+ *   1. Der Bridge-Wrapper in `observed-bridge.ts` implementiert eine
+ *      eigene Forward-Semantik statt die rohe Utility zu umhüllen.
+ *      Read-only-Architecture-Test hat einen explizit dokumentierten
+ *      Allowlist-Eintrag mit Doc-Verweis
+ *      (`16-bridges-inspector-architecture.md` §Leitplanke 1).
+ *   2. `observed-helpers.ts` liefert Wrapper für die Erzeugung
+ *      beobachteter Stores (Default-Adapter aus `@bimetal/event-sourcing`).
+ *      Convenience-Wrapper für Konstruktor-APIs, kein Mutations-API auf
+ *      einem fremden Subject. Eigene Verriegelung durch dedizierte
+ *      Runtime-Tests in `observed-helpers.test.ts`.
+ *
+ * - **Kein hartes `@bimetal/broker`-/`@bimetal/calendar-data`-Dependency.**
+ *   Domain-Andock bleibt strukturell.
+ *
+ * - **Explizite Registry, keine globalen Singletons, keine
+ *   Auto-Registrierung.** Konsument erzeugt `createDevtoolsRegistry()`
+ *   und reicht die Instanz an Helper/UI durch. Memory-Pattern aus
+ *   v0.14.0 weitergeführt.
+ *
+ * - **Production-Build-Strip via `import.meta.env.DEV`-Branch im
+ *   Konsumenten.**
  */
 export { createDevtoolsRegistry } from './registry.js';
 export { createDiagnosticsSource } from './diagnostics-source.js';
+export { createReplayEngine, applyEventToSnapshot, foldEvents, createInitialSnapshot, } from './replay-engine.js';
+export { toInspectableJson, jsonDiff } from './inspectable-json.js';
+export { buildCausationForest } from './causation-forest.js';
+export { createObservedBridge, createBridgeDiagnostics } from './observed-bridge.js';
+export { createObservedEventStore, createObservedSyncTransport, createObservedReplayTarget, } from './observed-helpers.js';
+export { exportSnapshot, serializeSnapshot, parseSnapshot, SNAPSHOT_VERSION, } from './snapshot-export.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAMvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAMvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AA+BlE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQ7D,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,sBAAsB,CAAC"}

package/dist/inspectable-json.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `toInspectableJson` + `jsonDiff` — pure Normalisierung + Diff für die
+ * Devtools-Inspector-Sicht (v0.16.2 Sub 2).
+ *
+ * **Warum normalisieren.** Aggregate-State enthält oft `Map`, `Set`,
+ * `Date`, `BigInt` — die kein gültiges JSON sind. Render und Diff brauchen
+ * eine einheitliche, vergleichbare Form. Die Normalisierung läuft **einmal
+ * vor jedem Render oder Diff**, danach operiert alles auf reinen JS-Werten
+ * (`string | number | boolean | null | undefined | object | array`).
+ *
+ * **Renderer-agnostisch.** Die Funktion weiß nichts über React, kein
+ * Stil-Konzept, kein UI-Format. Sie returnt rein normalisierte Werte;
+ * der UI-Konsument formt sie zum Display.
+ *
+ * **Map-Awareness an genau einer Stelle.** Wenn Map → Object hier zentral
+ * passiert, müssen Diff-Engine und JSON-Renderer keine eigene Special-Case-
+ * Logik haben. Vermeidet Drift zwischen „was sieht der User" und
+ * „was wird diffed".
+ */
+/**
+ * Normalisiert beliebige Werte für JSON-Render und Diff.
+ *
+ * Verriegelt:
+ * - Primitives (`string`, `number`, `boolean`, `null`, `undefined`) durchgereicht
+ * - `bigint` → string (`"123n"`-Form vermieden — direkte Stringification)
+ * - `function`, `symbol` → `null` (nicht inspectable, Inspector zeigt sie nicht)
+ * - `Date` → ISO-String via `.toISOString()`
+ * - `Error` → `{ name, message }` (Stack bewusst weggelassen — Cycles + Noise)
+ * - `Map` → Object (string-Keys; Nicht-String-Keys via `String(key)`)
+ * - `Set` → Array (Werte rekursiv normalisiert)
+ * - `Array` → Array (Elemente rekursiv normalisiert)
+ * - Object → Object (Keys rekursiv normalisiert)
+ * - Zyklen → `'[circular]'`-Sentinel (über `WeakSet`-Tracking)
+ */
+export declare function toInspectableJson(value: unknown): unknown;
+export type JsonDiffKind = 'added' | 'removed' | 'changed';
+export interface JsonDiffEntry {
+    /** JSON-Pointer-ähnlicher Pfad: `''` für Wurzel, `a.b.c` für nested, `xs[0]` für Array-Index. */
+    readonly path: string;
+    /**
+     * Richtung der Änderung:
+     * - `'added'`: Property/Element/Wert war vorher nicht da, jetzt da.
+     * - `'removed'`: war vorher da, jetzt nicht mehr.
+     * - `'changed'`: war vorher da, ist jetzt da, mit anderem Wert.
+     *
+     * Macht den Unterschied zwischen Presence-Wechseln (gleicher
+     * `undefined`-Wert auf beiden Seiten) und Value-Wechseln explizit —
+     * UI kann die Richtung farblich oder als Label rendern.
+     */
+    readonly kind: JsonDiffKind;
+    readonly before: unknown;
+    readonly after: unknown;
+}
+/**
+ * Diff zwischen zwei beliebigen Werten. Beide werden ZUERST via
+ * `toInspectableJson` normalisiert; der eigentliche Vergleich operiert
+ * auf reinem JSON-Form (kein Map/Set/Date-Special-Case mehr).
+ *
+ * Output: flat array von `JsonDiffEntry`. Renderer-agnostisch — UI
+ * entscheidet, wie sie darstellt (Tree, Liste, Side-by-Side).
+ *
+ * **Was als Änderung zählt:**
+ * - Identische Werte (`===` oder deep-equal nach Normalisierung) → kein Eintrag.
+ * - Primitive Änderung → ein Eintrag mit Pfad.
+ * - Hinzugefügter Key → `before: undefined, after: value`.
+ * - Entfernter Key → `before: value, after: undefined`.
+ * - Container-Typ-Wechsel (Array → Object) → ein Eintrag auf Wurzel-Pfad, keine Detail-Rekursion.
+ * - Array-Länge ändert sich → Diff-Einträge pro betroffenem Index.
+ */
+export declare function jsonDiff(before: unknown, after: unknown): JsonDiffEntry[];
+//# sourceMappingURL=inspectable-json.d.ts.map

package/dist/inspectable-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectable-json.d.ts","sourceRoot":"","sources":["../src/inspectable-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AA0CD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAMzE"}

package/dist/inspectable-json.js

@@ -0,0 +1,225 @@
+/**
+ * `toInspectableJson` + `jsonDiff` — pure Normalisierung + Diff für die
+ * Devtools-Inspector-Sicht (v0.16.2 Sub 2).
+ *
+ * **Warum normalisieren.** Aggregate-State enthält oft `Map`, `Set`,
+ * `Date`, `BigInt` — die kein gültiges JSON sind. Render und Diff brauchen
+ * eine einheitliche, vergleichbare Form. Die Normalisierung läuft **einmal
+ * vor jedem Render oder Diff**, danach operiert alles auf reinen JS-Werten
+ * (`string | number | boolean | null | undefined | object | array`).
+ *
+ * **Renderer-agnostisch.** Die Funktion weiß nichts über React, kein
+ * Stil-Konzept, kein UI-Format. Sie returnt rein normalisierte Werte;
+ * der UI-Konsument formt sie zum Display.
+ *
+ * **Map-Awareness an genau einer Stelle.** Wenn Map → Object hier zentral
+ * passiert, müssen Diff-Engine und JSON-Renderer keine eigene Special-Case-
+ * Logik haben. Vermeidet Drift zwischen „was sieht der User" und
+ * „was wird diffed".
+ */
+// ── toInspectableJson ────────────────────────────────────────────
+/**
+ * Normalisiert beliebige Werte für JSON-Render und Diff.
+ *
+ * Verriegelt:
+ * - Primitives (`string`, `number`, `boolean`, `null`, `undefined`) durchgereicht
+ * - `bigint` → string (`"123n"`-Form vermieden — direkte Stringification)
+ * - `function`, `symbol` → `null` (nicht inspectable, Inspector zeigt sie nicht)
+ * - `Date` → ISO-String via `.toISOString()`
+ * - `Error` → `{ name, message }` (Stack bewusst weggelassen — Cycles + Noise)
+ * - `Map` → Object (string-Keys; Nicht-String-Keys via `String(key)`)
+ * - `Set` → Array (Werte rekursiv normalisiert)
+ * - `Array` → Array (Elemente rekursiv normalisiert)
+ * - Object → Object (Keys rekursiv normalisiert)
+ * - Zyklen → `'[circular]'`-Sentinel (über `WeakSet`-Tracking)
+ */
+export function toInspectableJson(value) {
+    return toInspectable(value, new WeakSet());
+}
+function toInspectable(value, seen) {
+    if (value === null || value === undefined)
+        return value;
+    const t = typeof value;
+    if (t === 'string' || t === 'number' || t === 'boolean')
+        return value;
+    if (t === 'bigint')
+        return value.toString();
+    if (t === 'function' || t === 'symbol')
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value instanceof Error) {
+        return { name: value.name, message: value.message };
+    }
+    if (t !== 'object')
+        return value;
+    // Ab hier sind alle Werte object-typed → Cycle-Tracking via WeakSet
+    if (seen.has(value))
+        return '[circular]';
+    seen.add(value);
+    if (value instanceof Map) {
+        const out = {};
+        for (const [k, v] of value) {
+            const key = typeof k === 'string' ? k : String(k);
+            out[key] = toInspectable(v, seen);
+        }
+        return out;
+    }
+    if (value instanceof Set) {
+        return Array.from(value, (v) => toInspectable(v, seen));
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => toInspectable(v, seen));
+    }
+    // Plain object: nur enumerable own-keys, keine Prototypen-Felder
+    const out = {};
+    for (const k of Object.keys(value)) {
+        out[k] = toInspectable(value[k], seen);
+    }
+    return out;
+}
+/**
+ * Diff zwischen zwei beliebigen Werten. Beide werden ZUERST via
+ * `toInspectableJson` normalisiert; der eigentliche Vergleich operiert
+ * auf reinem JSON-Form (kein Map/Set/Date-Special-Case mehr).
+ *
+ * Output: flat array von `JsonDiffEntry`. Renderer-agnostisch — UI
+ * entscheidet, wie sie darstellt (Tree, Liste, Side-by-Side).
+ *
+ * **Was als Änderung zählt:**
+ * - Identische Werte (`===` oder deep-equal nach Normalisierung) → kein Eintrag.
+ * - Primitive Änderung → ein Eintrag mit Pfad.
+ * - Hinzugefügter Key → `before: undefined, after: value`.
+ * - Entfernter Key → `before: value, after: undefined`.
+ * - Container-Typ-Wechsel (Array → Object) → ein Eintrag auf Wurzel-Pfad, keine Detail-Rekursion.
+ * - Array-Länge ändert sich → Diff-Einträge pro betroffenem Index.
+ */
+export function jsonDiff(before, after) {
+    const normBefore = toInspectableJson(before);
+    const normAfter = toInspectableJson(after);
+    const result = [];
+    diffRec(normBefore, normAfter, '', result);
+    return result;
+}
+/**
+ * Klassifiziert eine primitive-Änderung anhand der Werte. Wird nur im
+ * primitive-Branch (kein Object/Array-Container) gerufen. Object-Presence-
+ * und Array-out-of-bounds-Cases setzen ihren `kind` explizit.
+ */
+function classifyPrimitive(before, after) {
+    if (before === undefined)
+        return 'added';
+    if (after === undefined)
+        return 'removed';
+    return 'changed';
+}
+function diffRec(before, after, path, result) {
+    if (isSame(before, after))
+        return;
+    const beforeIsObj = before !== null && typeof before === 'object';
+    const afterIsObj = after !== null && typeof after === 'object';
+    // Ein Wert ist primitive / null → Wechsel als ein Eintrag
+    if (!beforeIsObj || !afterIsObj) {
+        result.push({ path, kind: classifyPrimitive(before, after), before, after });
+        return;
+    }
+    const beforeIsArray = Array.isArray(before);
+    const afterIsArray = Array.isArray(after);
+    // Container-Typ-Mismatch → ein Wurzel-Eintrag, keine Rekursion. Beide
+    // sind hier non-null objects, also kind='changed'.
+    if (beforeIsArray !== afterIsArray) {
+        result.push({ path, kind: 'changed', before, after });
+        return;
+    }
+    if (beforeIsArray) {
+        const a = before;
+        const b = after;
+        const max = Math.max(a.length, b.length);
+        for (let i = 0; i < max; i++) {
+            const childPath = `${path}[${i}]`;
+            if (i < a.length && i < b.length) {
+                // Beide Indexe vorhanden → primitive-Recurse, kind via classify
+                diffRec(a[i], b[i], childPath, result);
+            }
+            else if (i < a.length) {
+                // Array verkürzt — Element entfernt (auch wenn value undefined)
+                result.push({ path: childPath, kind: 'removed', before: a[i], after: undefined });
+            }
+            else {
+                // Array verlängert — Element hinzugefügt
+                result.push({ path: childPath, kind: 'added', before: undefined, after: b[i] });
+            }
+        }
+        return;
+    }
+    // Beide Objects — Property-Presence über hasOwnProperty getrennt vom
+    // Value-Vergleich, damit `{x: undefined}` vs `{}` sichtbar wird
+    // (Pilot-Finding: Calendar-DomainStore setzt modified-instance-Fields
+    // explizit auf `recurrence: undefined`, exceptions: undefined`).
+    const beforeObj = before;
+    const afterObj = after;
+    const keys = new Set([...Object.keys(beforeObj), ...Object.keys(afterObj)]);
+    const sortedKeys = [...keys].sort();
+    for (const k of sortedKeys) {
+        const childPath = path === '' ? k : `${path}.${k}`;
+        const beforeHas = Object.prototype.hasOwnProperty.call(beforeObj, k);
+        const afterHas = Object.prototype.hasOwnProperty.call(afterObj, k);
+        if (beforeHas && afterHas) {
+            diffRec(beforeObj[k], afterObj[k], childPath, result);
+            continue;
+        }
+        // Property präsenz-asymmetrisch — kind explizit, auch wenn der Wert
+        // undefined ist (sonst wäre der Presence-Wechsel unsichtbar).
+        if (beforeHas) {
+            result.push({ path: childPath, kind: 'removed', before: beforeObj[k], after: undefined });
+        }
+        else if (afterHas) {
+            result.push({ path: childPath, kind: 'added', before: undefined, after: afterObj[k] });
+        }
+    }
+}
+/**
+ * Deep-equal auf bereits via `toInspectableJson` normalisierten Werten.
+ * Reine JS-Werte — kein Map/Set/Date-Handling mehr nötig.
+ */
+function isSame(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (a === undefined || b === undefined)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return false;
+    const aIsArr = Array.isArray(a);
+    const bIsArr = Array.isArray(b);
+    if (aIsArr !== bIsArr)
+        return false;
+    if (aIsArr) {
+        const aa = a;
+        const bb = b;
+        if (aa.length !== bb.length)
+            return false;
+        for (let i = 0; i < aa.length; i++) {
+            if (!isSame(aa[i], bb[i]))
+                return false;
+        }
+        return true;
+    }
+    const aObj = a;
+    const bObj = b;
+    const aKeys = Object.keys(aObj);
+    const bKeys = Object.keys(bObj);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const k of aKeys) {
+        if (!Object.prototype.hasOwnProperty.call(bObj, k))
+            return false;
+        if (!isSame(aObj[k], bObj[k]))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=inspectable-json.js.map

package/dist/inspectable-json.js.map

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

package/dist/observed-bridge.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `createObservedBridge` — Devtools-Wrapper-Helper für die EventStore→
+ * Broker-Forward-Semantik (v0.16.4 Sub 1).
+ *
+ * Verriegelt aus `design/calendar/16-bridges-inspector-architecture.md`:
+ *
+ * **Ehrlichkeits-Vertrag — eigene Forward-Implementation:**
+ * Der Helper ruft die rohe EventStore→Broker-Bridge-Utility aus
+ * `@bimetal/event-sourcing` NICHT auf (die exakten Identifier sind im
+ * Architecture-Test verriegelt — diese Quelle vermeidet sie auch in
+ * Kommentaren, damit der Token-Scan über die ganze Datei einfach
+ * bleibt). Die rohe Bridge hat aktuell keinen beobachtbaren Hook —
+ * ein Wrapper, der sie nutzte, müsste entweder eine zweite Forward-
+ * Schiene erzeugen (jedes Event doppelt publiziert) oder die User-
+ * Subscribe-Reihenfolge raten. Stattdessen implementiert dieser Helper
+ * dieselbe Forward-Semantik (`subscribe` → `toTopic` → `publish` +
+ * Safe-Wrap-Error-Handler) selbst und hängt seinen Diagnostics-
+ * Subscriber direkt an die eigene Code-Stelle. Vertragsäquivalenz zur
+ * rohen Utility wird durch Tests verriegelt.
+ *
+ * **Keine neue Semantik:**
+ * - Kein Retry. `publish()`-Rejection wird via `onPublishError`-Hook
+ *   propagiert, nicht wiederholt.
+ * - Kein Dedup.
+ * - Keine Backpressure. `publish()` läuft fire-and-forget (`.catch()`).
+ * - Keine Fehlerunterdrückung. Werfender User-Handler wird im
+ *   Safe-Wrap gefangen (genau wie in der rohen Bridge), nicht
+ *   stillschweigend verschluckt.
+ *
+ * **publish-error-Reihenfolge:**
+ * Der Record landet IMMER im rolling-window — VOR dem User-Handler-
+ * Aufruf. Sonst sähe der Inspector nur Erfolgspfade, wenn der User
+ * den Fehler verschluckt.
+ */
+import type { BridgeDiagnosticsSink, BridgeDiagnosticsSource, DomainEvent, EventStoreLike, PublishTargetLike, Unsubscribe } from './types.js';
+import type { DevtoolsRegistry } from './registry.js';
+export interface ObservedBridgeOptions {
+    readonly id: string;
+    readonly name: string;
+    readonly eventStore: EventStoreLike;
+    readonly target: PublishTargetLike;
+    /**
+     * Optional Label für die Source-Seite. Fallback-Kette:
+     * `sourceLabel ?? sourceStoreId ?? 'event-store'`.
+     */
+    readonly sourceLabel?: string;
+    /** Pflicht — der Inspector zeigt source → target. */
+    readonly targetLabel: string;
+    /**
+     * Optional: wenn der EventStore in der Registry registriert ist,
+     * dessen `id`. Macht den Source-Endpoint im Inspector klickbar-
+     * verlinkbar (Future-Slice).
+     */
+    readonly sourceStoreId?: string;
+    /** Wenn gesetzt, nur Events dieses Streams forwarden. */
+    readonly streamId?: string;
+    /** Topic-Ableitung pro Event. Default: `event.type`. */
+    readonly toTopic?: (event: DomainEvent) => string;
+    /**
+     * Aufgerufen NACH dem `bridge-publish-error`-Record (Pilot-
+     * Verriegelung). Default: konsolen-Log analog rohe Bridge.
+     */
+    readonly onPublishError?: (error: unknown, event: DomainEvent, topic: string) => void;
+}
+export declare function createObservedBridge(registry: DevtoolsRegistry, options: ObservedBridgeOptions): Unsubscribe;
+/**
+ * Bridge-Diagnostics-Subject: Listener-Pool wie `createDiagnosticsSource`,
+ * aber typed auf `BridgeRecord`. Throw-Isolation pro Listener.
+ */
+export declare function createBridgeDiagnostics(): BridgeDiagnosticsSource & BridgeDiagnosticsSink;
+//# sourceMappingURL=observed-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observed-bridge.d.ts","sourceRoot":"","sources":["../src/observed-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EAIvB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,KACV,IAAI,CAAC;CACX;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,qBAAqB,GAC7B,WAAW,CAgGb;AA2BD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,GAAG,qBAAqB,CAoBzF"}

package/dist/observed-bridge.js

@@ -0,0 +1,165 @@
+/**
+ * `createObservedBridge` — Devtools-Wrapper-Helper für die EventStore→
+ * Broker-Forward-Semantik (v0.16.4 Sub 1).
+ *
+ * Verriegelt aus `design/calendar/16-bridges-inspector-architecture.md`:
+ *
+ * **Ehrlichkeits-Vertrag — eigene Forward-Implementation:**
+ * Der Helper ruft die rohe EventStore→Broker-Bridge-Utility aus
+ * `@bimetal/event-sourcing` NICHT auf (die exakten Identifier sind im
+ * Architecture-Test verriegelt — diese Quelle vermeidet sie auch in
+ * Kommentaren, damit der Token-Scan über die ganze Datei einfach
+ * bleibt). Die rohe Bridge hat aktuell keinen beobachtbaren Hook —
+ * ein Wrapper, der sie nutzte, müsste entweder eine zweite Forward-
+ * Schiene erzeugen (jedes Event doppelt publiziert) oder die User-
+ * Subscribe-Reihenfolge raten. Stattdessen implementiert dieser Helper
+ * dieselbe Forward-Semantik (`subscribe` → `toTopic` → `publish` +
+ * Safe-Wrap-Error-Handler) selbst und hängt seinen Diagnostics-
+ * Subscriber direkt an die eigene Code-Stelle. Vertragsäquivalenz zur
+ * rohen Utility wird durch Tests verriegelt.
+ *
+ * **Keine neue Semantik:**
+ * - Kein Retry. `publish()`-Rejection wird via `onPublishError`-Hook
+ *   propagiert, nicht wiederholt.
+ * - Kein Dedup.
+ * - Keine Backpressure. `publish()` läuft fire-and-forget (`.catch()`).
+ * - Keine Fehlerunterdrückung. Werfender User-Handler wird im
+ *   Safe-Wrap gefangen (genau wie in der rohen Bridge), nicht
+ *   stillschweigend verschluckt.
+ *
+ * **publish-error-Reihenfolge:**
+ * Der Record landet IMMER im rolling-window — VOR dem User-Handler-
+ * Aufruf. Sonst sähe der Inspector nur Erfolgspfade, wenn der User
+ * den Fehler verschluckt.
+ */
+export function createObservedBridge(registry, options) {
+    const toTopic = options.toTopic ?? defaultToTopic;
+    const userOnError = options.onPublishError ?? defaultPublishErrorHandler;
+    // Eigener Diagnostics-Subject pro Bridge — typisiert auf BridgeRecord.
+    const diagnostics = createBridgeDiagnostics();
+    // Source-Label-Fallback-Kette (Sub-1-Pilot-Schärfung):
+    //  1. explizites sourceLabel  (Konsument hat etwas Konkretes im Kopf)
+    //  2. sourceStoreId           (Identitäts-Label des registrierten Stores)
+    //  3. 'event-store'           (generische Konstante als letzter Ausweg)
+    const source = {
+        label: options.sourceLabel ?? options.sourceStoreId ?? 'event-store',
+        ...(options.sourceStoreId !== undefined ? { storeId: options.sourceStoreId } : {}),
+    };
+    const target = {
+        label: options.targetLabel,
+    };
+    const handle = {
+        id: options.id,
+        name: options.name,
+        kind: 'event-store-to-broker',
+        source,
+        target,
+        diagnostics,
+    };
+    // Registry-Registrierung VOR Subscribe — sonst landen die ersten
+    // Events in der Pipe, bevor der Inspector das Handle sieht.
+    const offRegister = registry.registerBridge(handle);
+    // EIGENE Forward-Implementation. KEIN Aufruf der rohen
+    // EventStore→Broker-Bridge-Utility aus event-sourcing — siehe
+    // Datei-Header zur Begründung (Token im Architecture-Test verriegelt).
+    //
+    // try/catch: wenn `subscribe()` synchron wirft, würde sonst die
+    // Bridge im Registry hängen bleiben (Handle registriert, kein
+    // Subscriber aktiv). Pilot-Finding Sub 1.
+    let offSubscribe;
+    try {
+        offSubscribe = options.eventStore.subscribe((event) => {
+            const topic = toTopic(event);
+            // 1. „forwarded"-Record emittieren VOR der publish-Call-Site —
+            //    fire-and-forget heißt: wir markieren als forwarded, sobald
+            //    wir den Wurf weggeschickt haben. Kein await, kein tookMs.
+            diagnostics.emit({
+                kind: 'bridge-event-forwarded',
+                topic,
+                event,
+            });
+            // 2. publish() fire-and-forget mit .catch() — wie in der rohen
+            //    Bridge. Plus try/catch um den Aufruf selbst: strukturell ist
+            //    publish() zwar Promise<void>, aber ein Adapter oder Test-
+            //    Double kann synchron werfen. Ohne try/catch würde der Wurf
+            //    aus dem EventStore-Subscriber rausfliegen und Record +
+            //    User-Handler überspringen. Pilot-Finding Sub 1.
+            try {
+                Promise.resolve(options.target.publish(topic, event)).catch((error) => {
+                    safeOnError(error, event, topic);
+                });
+            }
+            catch (syncError) {
+                safeOnError(syncError, event, topic);
+            }
+        }, options.streamId);
+    }
+    catch (subscribeError) {
+        offRegister();
+        throw subscribeError;
+    }
+    function safeOnError(error, event, topic) {
+        // Pilot-Verriegelung: Record ZUERST. Auch wenn der User-Handler
+        // wirft oder den Fehler verschluckt, ist er im Inspector sichtbar.
+        diagnostics.emit({
+            kind: 'bridge-publish-error',
+            topic,
+            event,
+            error: extractError(error),
+        });
+        // DANN User-Handler, in Safe-Wrap.
+        try {
+            userOnError(error, event, topic);
+        }
+        catch (innerError) {
+            // eslint-disable-next-line no-console
+            console.error('[@bimetal/devtools/observed-bridge] onPublishError handler itself threw — original error follows:', innerError, error);
+        }
+    }
+    return () => {
+        offSubscribe();
+        offRegister();
+    };
+}
+function defaultToTopic(event) {
+    return event.type;
+}
+function defaultPublishErrorHandler(error, event, topic) {
+    // eslint-disable-next-line no-console
+    console.error(`[@bimetal/devtools/observed-bridge] publish failed for topic "${topic}" event ${event.envelope.id}:`, error);
+}
+function extractError(error) {
+    if (error instanceof Error) {
+        return error.stack !== undefined
+            ? { message: error.message, stack: error.stack }
+            : { message: error.message };
+    }
+    return { message: String(error) };
+}
+/**
+ * Bridge-Diagnostics-Subject: Listener-Pool wie `createDiagnosticsSource`,
+ * aber typed auf `BridgeRecord`. Throw-Isolation pro Listener.
+ */
+export function createBridgeDiagnostics() {
+    const listeners = new Set();
+    return {
+        emit(record) {
+            for (const listener of listeners) {
+                try {
+                    listener(record);
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.error('[@bimetal/devtools/observed-bridge] listener threw:', err);
+                }
+            }
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+//# sourceMappingURL=observed-bridge.js.map

package/dist/observed-bridge.js.map

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