@bimetal/devtools 0.15.3 → 0.16.1

package/dist/types.d.ts

@@ -63,17 +63,171 @@ export interface CapturedEvent {
     readonly event: DomainEvent;
     readonly tookMs: number;
 }
+/**
+ * Handle for `registerSyncTransport`. Identitäts-Vertrag analog
+ * `EventStoreHandle`: `id` ist immutable Identität, `name` Display.
+ */
+export interface SyncTransportHandle {
+    readonly id: string;
+    readonly name: string;
+    readonly diagnostics: DiagnosticsSource;
+}
+export interface RegisteredSyncTransport {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Sync-Records, gefiltert + mit Sequenz-ID + Aufnahmezeit angereichert.
+ * `record` ist exakt der vom Adapter emit'tete `DiagnosticsRecord`-
+ * Eintrag mit `kind: 'sync-*'`. Keine Felder umbenannt, kein Wrapping —
+ * der Inspector zeigt das, was wirklich kam.
+ */
+export interface CapturedSyncRecord {
+    /** Monotonic capture sequence — global across all transports + record kinds. */
+    readonly seq: number;
+    readonly transportId: string;
+    readonly transportName: string;
+    /** Wall-clock timestamp at capture time (ms epoch). */
+    readonly capturedAt: number;
+    readonly record: DiagnosticsRecord & {
+        kind: `sync-${string}`;
+    };
+}
+/**
+ * Strukturelles Interface für ein Publish-Target (Broker-API-Slice).
+ * Analog zu `PublishTarget` aus `@bimetal/event-sourcing/broker-bridge`,
+ * aber lokal in devtools deklariert — keine zirkulare Import-Beziehung.
+ */
+export interface PublishTargetLike<TMessage = DomainEvent> {
+    publish(topic: string, message: TMessage): Promise<void>;
+}
+/**
+ * v0.16.4 produziert nur 'event-store-to-broker'. Spätere Slices
+ * erweitern die Union explizit per eigener Slice.
+ * Pilot-Schärfung 2026-06-09: kein freies `string` als Public-Type.
+ */
+export type BridgeKind = 'event-store-to-broker';
+export interface BridgeEndpoint {
+    readonly label: string;
+    /** Optional: wenn der Endpoint ein registrierter EventStore ist, dessen id. */
+    readonly storeId?: string;
+}
+export type BridgeRecord = BridgeEventForwardedRecord | BridgePublishErrorRecord;
+export interface BridgeEventForwardedRecord {
+    readonly kind: 'bridge-event-forwarded';
+    readonly topic: string;
+    readonly event: DomainEvent;
+}
+export interface BridgePublishErrorRecord {
+    readonly kind: 'bridge-publish-error';
+    readonly topic: string;
+    readonly event: DomainEvent;
+    readonly error: {
+        readonly message: string;
+        readonly stack?: string;
+    };
+}
+/**
+ * Bridge-spezifische Diagnostics-Source in devtools — NICHT der
+ * generische `DiagnosticsSource` aus `@bimetal/event-sourcing`.
+ * Begründung: `DiagnosticsRecord` ist dort eine geschlossene Union,
+ * `bridge-*`-Kinds dort einzufügen würde event-sourcing mit Bridge-
+ * Konzepten verschmutzen (Boundary-Verletzung).
+ */
+export interface BridgeDiagnosticsSource {
+    subscribe(listener: (record: BridgeRecord) => void): Unsubscribe;
+}
+export interface BridgeDiagnosticsSink {
+    emit(record: BridgeRecord): void;
+}
+/**
+ * Handle für `registerBridge`. `diagnostics` ist Pflicht — die Bridge
+ * muss observable sein, sonst ist die Registrierung sinnlos.
+ */
+export interface BridgeHandle {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: BridgeKind;
+    readonly source: BridgeEndpoint;
+    readonly target: BridgeEndpoint;
+    readonly diagnostics: BridgeDiagnosticsSource;
+}
+export interface RegisteredBridge {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: BridgeKind;
+    readonly source: BridgeEndpoint;
+    readonly target: BridgeEndpoint;
+}
+export interface CapturedBridgeRecord {
+    /** Monotonic capture sequence — global across all bridges + record kinds. */
+    readonly seq: number;
+    readonly bridgeId: string;
+    readonly bridgeName: string;
+    /** Wall-clock timestamp at capture time (ms epoch). */
+    readonly capturedAt: number;
+    readonly record: BridgeRecord;
+}
+/**
+ * RegisteredReplayTarget — public Sicht eines registrierten Targets im
+ * `DevtoolsState`. Trägt den aktuellen `ReplayEngineSnapshot` mit, damit
+ * UI-Konsumenten ohne separate Engine-Subscription rendern können.
+ *
+ * `snapshot` ist `unknown` typisiert, weil der Registry-Vertrag
+ * heterogene Targets verwaltet (verschiedene Aggregate-State-Formen).
+ * Konkrete Konsumenten castten auf ihren bekannten Typ.
+ */
+export interface RegisteredReplayTarget {
+    readonly id: string;
+    readonly name: string;
+    readonly streamId: string;
+    /**
+     * `projection.version` aus dem Handle (v0.16.1). UI vergleicht das mit
+     * `snapshot.lastAppliedSchemaVersion` — Drift macht der Inspector
+     * sichtbar. Im Architektur-Doc §v0.16-Leitplanke 6 verriegelt.
+     */
+    readonly projectionVersion: number;
+    readonly snapshot: ReplayEngineSnapshotErased;
+}
+/**
+ * Type-erased Snapshot für die Registry-Sicht. Identisch zur generischen
+ * `ReplayEngineSnapshot<unknown, unknown>` aus `replay-engine.ts`, hier
+ * separat deklariert um zirkulare Type-Importe zu vermeiden (types.ts
+ * darf nicht von replay-engine.ts abhängen).
+ */
+export interface ReplayEngineSnapshotErased {
+    readonly state: unknown;
+    readonly readModel: unknown;
+    readonly lastAppliedVersion: number;
+    readonly status: 'replaying' | 'live' | 'error';
+    readonly lastError?: {
+        readonly event: DomainEvent | null;
+        readonly error: Error;
+    };
+    readonly lastAppliedEventId?: string;
+    readonly lastAppliedSchemaVersion?: number;
+    readonly blockedEventCount: number;
+}
 /**
  * Live, read-only snapshot of what the devtools sees right now.
- * Lists registered stores plus the rolling event buffer.
+ * Lists registered stores + transports, plus die rolling buffers für
+ * captured events und sync-records.
  *
  * **Reference stability:** the `state` getter caches the snapshot
  * between mutations — useSyncExternalStore-friendly. A fresh reference
  * is produced exactly when something changes (registration, event,
- * unregistration).
+ * unregistration, sync-record).
  */
 export interface DevtoolsState {
     readonly eventStores: readonly RegisteredEventStore[];
     readonly events: readonly CapturedEvent[];
+    readonly syncTransports: readonly RegisteredSyncTransport[];
+    readonly syncRecords: readonly CapturedSyncRecord[];
+    /** Registered ReplayTargets mit aktuellem Engine-Snapshot (v0.16.0). */
+    readonly replayTargets: readonly RegisteredReplayTarget[];
+    /** Registered Bridges (v0.16.4). */
+    readonly bridges: readonly RegisteredBridge[];
+    /** Rolling-window an Bridge-Records (v0.16.4). */
+    readonly bridgeRecords: readonly CapturedBridgeRecord[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,0CAA0C;AAC1C,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAClF;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,WAAW,CAAC;CACvE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bimetal/devtools",
-  "version": "0.15.3",
+  "version": "0.16.1",
   "description": "Event-Debugger primitives (v0.14). Framework-agnostic registry + diagnostics-source for auditing event-sourced systems. Zero hard dependencies on @bimetal/broker or any domain package — structural interfaces only.",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@bimetal/event-sourcing": "^0.15.3"
+    "@bimetal/event-sourcing": "^0.16.1"
   },
   "devDependencies": {
     "vitest": "^3.2.1"