@rolandsall24/nest-mediator 1.0.0 → 1.2.0-beta.1

package/README.md

@@ -13,8 +13,18 @@ A lightweight CQRS mediator for NestJS — start simple, add event persistence w
 - **Flexible Event Store** — PostgreSQL-backed, bring your own pool or repository
 - **Optimistic Concurrency** — Sequence-based version control with `ConcurrencyError`
 - **Correlation & Causation IDs** — Automatic distributed tracing via `AsyncLocalStorage`
+- **MediatorFlow Dashboard** — Real-time visual monitoring, topology graphs, execution tracing
 - **Zero config** — Decorator-based auto-discovery, built on NestJS DI
 
+### Topology View
+![Topology View](images/topology-view.png)
+
+### Execution Trace — Flow
+![Execution Trace Flow](images/execution-trace-flow.png)
+
+### Execution Trace — Sequence
+![Execution Trace Sequence](images/execution-trace-sequence.png)
+
 ## Installation
 
 ```bash
@@ -807,11 +817,185 @@ NestMediatorModule.forRoot({
     mode?: 'audit' | 'source',             // default: 'audit'
     tableName?: string,                     // default: 'domain_events'
   },
+  mediatorFlow?: {
+    enabled: boolean,                       // enable telemetry export
+    collectorUrl: string,                   // MediatorFlow server URL
+    serviceName?: string,                   // default: 'unknown'
+    batchSize?: number,                     // default: 50
+    flushIntervalMs?: number,               // default: 2000
+    includePayloads?: boolean,              // default: false
+    httpTimeoutMs?: number,                 // default: 3000
+  },
 })
 ```
 
 ---
 
+## MediatorFlow — Visual Monitoring Dashboard
+
+MediatorFlow is a real-time monitoring dashboard that visualizes every command, query, event, and consumer execution in your application. It ships as a standalone server (`mediator-flow-server`) with an embedded React dashboard.
+
+```
+NestJS App (@rolandsall24/nest-mediator)
+    |
+    +---> POST /collect/topology     (on boot — sends full architecture map)
+    +---> POST /collect/steps        (batched — execution telemetry)
+    |
+    v
+MediatorFlow Server (NestJS + PostgreSQL)
+    |
+    v
+React Dashboard (topology graph, trace list, execution flow, stats)
+```
+
+### What You Get
+
+- **Real-time stats dashboard** — Throughput, error rate, top slow handlers, top errors at a glance
+- **Interactive topology graph** — Visual map of your entire CQRS architecture: commands, handlers, events, consumers, behaviors, and their connections. Click any node for details.
+- **Paginated trace list** — Every command/query execution as a trace with status, duration, step count. Search and filter by entry name, status, or service.
+- **Execution flow visualization** — Click a trace to see a full DAG (directed acyclic graph) showing the causation chain: which handler published which event, which consumers ran, where errors occurred.
+- **Sequence diagram view** — Step-by-step chronological view with compact mode for dense traces
+- **Compensation chain display** — When saga compensation fires, see the full rollback flow
+- **Category filtering** — Toggle visibility of commands, events, consumers, behaviors in any graph view
+- **Resizable graph nodes** — Drag to resize any node in topology or execution flow views
+
+### Quick Start — Docker (Recommended)
+
+**Option A: Pull from DockerHub** (fastest)
+
+```bash
+docker run -d -p 4800:4800 --name mediatorflow rolandsall24/mediatorflow:latest
+```
+
+**Option B: Build locally**
+
+```bash
+cd mediator-flow-server
+npm run docker:up       # builds and starts on port 4800
+```
+
+Open [http://localhost:4800](http://localhost:4800) to see the dashboard.
+
+To stop:
+```bash
+npm run docker:down
+# or if using Option A:
+docker rm -f mediatorflow
+```
+
+### Quick Start — Local Development
+
+```bash
+cd mediator-flow-server
+
+# 1. Start PostgreSQL (port 5433)
+npm run dev:db
+
+# 2. Start API + UI with hot reload
+npm run dev:start
+
+# To stop everything:
+npm run dev:stop
+```
+
+The API runs on `http://localhost:4000` and the UI dev server on `http://localhost:5173`.
+
+### Enable Telemetry in Your App
+
+Add the `mediatorFlow` option to your module configuration. That's it — the library handles batching, flushing, and topology export automatically.
+
+```typescript
+import { Module } from '@nestjs/common';
+import { NestMediatorModule } from '@rolandsall24/nest-mediator';
+
+@Module({
+  imports: [
+    NestMediatorModule.forRoot({
+      enableLogging: true,
+      mediatorFlow: {
+        enabled: true,
+        collectorUrl: 'http://localhost:4800',  // MediatorFlow server URL
+        serviceName: 'order-service',           // identifies your service in the dashboard
+      },
+    }),
+  ],
+  providers: [/* your handlers, consumers, etc. */],
+})
+export class AppModule {}
+```
+
+### Configuration Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `enabled` | — | Enable/disable telemetry export |
+| `collectorUrl` | — | MediatorFlow server URL (e.g., `http://localhost:4800`) |
+| `serviceName` | `'unknown'` | Service name shown in the dashboard |
+| `batchSize` | `50` | Number of steps to buffer before flushing |
+| `flushIntervalMs` | `2000` | Maximum time between flushes (ms) |
+| `includePayloads` | `false` | Include command/event payloads in telemetry (may contain sensitive data) |
+| `httpTimeoutMs` | `3000` | Timeout for HTTP flush calls to the collector |
+
+### How It Works
+
+**On application boot**, the library sends your full architecture topology to the MediatorFlow server — every registered command, handler, event, consumer (with criticality and compensation info), behavior (with priority and scope), and aggregate. This builds the topology graph.
+
+**During runtime**, every execution step is captured as a lightweight telemetry event:
+
+| Step Type | When |
+|-----------|------|
+| `COMMAND_DISPATCHED` | Command enters the mediator |
+| `COMMAND_HANDLER_STARTED/COMPLETED/FAILED` | Handler lifecycle |
+| `QUERY_DISPATCHED` | Query enters the mediator |
+| `QUERY_HANDLER_STARTED/COMPLETED/FAILED` | Handler lifecycle |
+| `BEHAVIOR_ENTERED/COMPLETED/FAILED` | Pipeline behavior execution |
+| `EVENT_PUBLISHED` | Event dispatched to consumers |
+| `CRITICAL_CONSUMER_STARTED/COMPLETED/FAILED` | Critical consumer lifecycle |
+| `NONCRITICAL_CONSUMER_DISPATCHED/COMPLETED/FAILED` | Non-critical consumer lifecycle |
+| `COMPENSATION_STARTED/COMPLETED/FAILED` | Compensation chain execution |
+| `COMPENSATING_EVENT_PUBLISHED` | Compensating event emitted |
+
+Steps are buffered in memory and flushed to the server in batches — either when the buffer reaches `batchSize` or every `flushIntervalMs`, whichever comes first. Flushing is fire-and-forget: if the server is down, steps are dropped and the application continues normally.
+
+Each step carries the `correlationId` and `causationId` from `AsyncLocalStorage`, so the dashboard can reconstruct the full execution tree for any trace.
+
+### External Database
+
+By default, Docker mode runs PostgreSQL inside the container. To use an external database (e.g., AWS RDS):
+
+```bash
+docker run -d -p 4800:4800 \
+  -e DATABASE_URL=postgres://user:pass@your-rds.amazonaws.com:5432/mediatorflow \
+  rolandsall24/mediatorflow:latest
+```
+
+Or with docker compose:
+
+```bash
+DATABASE_URL=postgres://user:pass@your-rds.amazonaws.com:5432/mediatorflow \
+  docker compose up -d
+```
+
+The embedded PostgreSQL is automatically skipped when `DATABASE_URL` points to a non-localhost host. Schema migrations run against the external database.
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DATABASE_URL` | External PostgreSQL connection string (skips embedded DB) | — |
+| `PORT` | API port | `4800` |
+| `POSTGRES_USER` | Embedded DB username | `mediatorflow` |
+| `POSTGRES_PASSWORD` | Embedded DB password | `mediatorflow` |
+| `POSTGRES_DB` | Embedded DB name | `mediatorflow` |
+
+For full documentation, see the [DockerHub page](https://hub.docker.com/r/rolandsall24/mediatorflow).
+
+### Zero Overhead When Disabled
+
+When `mediatorFlow.enabled` is `false` (or not set), the `StepEmitter` is still registered as a NestJS provider but its `emit()` method returns immediately on line 1 — zero allocation, zero network calls. The `wrapAsync()` method skips telemetry entirely and just executes your function directly. There is no performance impact when telemetry is off.
+
+---
+
 ## API Reference
 
 ### Interfaces

package/dist/index.d.ts

@@ -6,5 +6,6 @@ export * from './lib/exceptions/index.js';
 export * from './lib/context/index.js';
 export * from './lib/aggregate/index.js';
 export * from './lib/event-store/index.js';
+export type { MediatorFlowExporterConfig } from './lib/mediator-flow/protocol.js';
 export * from './lib/nest-mediator.module.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAG1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAG1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAE3C,YAAY,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAGlF,cAAc,+BAA+B,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,4DAA0C;AAE1C,aAAa;AACb,4DAA0C;AAE1C,WAAW;AACX,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,aAAa;AACb,4DAA0C;AAE1C,UAAU;AACV,yDAAuC;AAEvC,6BAA6B;AAC7B,2DAAyC;AAEzC,cAAc;AACd,6DAA2C;AAE3C,SAAS;AACT,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,4DAA0C;AAE1C,aAAa;AACb,4DAA0C;AAE1C,WAAW;AACX,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,aAAa;AACb,4DAA0C;AAE1C,UAAU;AACV,yDAAuC;AAEvC,6BAA6B;AAC7B,2DAAyC;AAEzC,cAAc;AACd,6DAA2C;AAI3C,SAAS;AACT,gEAA8C"}

package/dist/lib/context/mediator-context.d.ts

@@ -18,6 +18,12 @@ export interface MediatorContextData {
      * and by child events as their causation_id (parent→child link).
      */
     currentEventId?: string;
+    /**
+     * The name of the handler currently executing.
+     * Set before a command/event handler runs so that child events
+     * can record which handler published them (publishedBy metadata).
+     */
+    currentHandlerName?: string;
 }
 /**
  * Manages context propagation through async operations using AsyncLocalStorage.

package/dist/lib/context/mediator-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediator-context.d.ts","sourceRoot":"","sources":["../../../src/lib/context/mediator-context.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,cAAM,sBAAsB;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IAExE;;;;;;OAMG;IACH,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ5D;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAU5E;;;;;OAKG;IACH,UAAU,IAAI,mBAAmB;IAYjC;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;OAIG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;CAGrC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,wBAA+B,CAAC"}
+{"version":3,"file":"mediator-context.d.ts","sourceRoot":"","sources":["../../../src/lib/context/mediator-context.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,cAAM,sBAAsB;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IAExE;;;;;;OAMG;IACH,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ5D;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAU5E;;;;;OAKG;IACH,UAAU,IAAI,mBAAmB;IAYjC;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;OAIG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;CAGrC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,wBAA+B,CAAC"}

package/dist/lib/context/mediator-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"mediator-context.js","sourceRoot":"","sources":["../../../src/lib/context/mediator-context.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAChD,+BAAoC;AA0BpC;;;GAGG;AACH,MAAM,sBAAsB;IAA5B;QACmB,YAAO,GAAG,IAAI,+BAAiB,EAAuB,CAAC;IAgF1E,CAAC;IA9EC;;;;;;OAMG;IACH,iBAAiB,CAAI,QAA0B;QAC7C,MAAM,OAAO,GAAwB;YACnC,aAAa,EAAE,IAAA,SAAM,GAAE;YACvB,WAAW,EAAE,SAAS;SACvB,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAI,OAAe,EAAE,QAA0B;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,YAAY,GAAwB;YACxC,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,IAAA,SAAM,GAAE;YACjD,WAAW,EAAE,OAAO,EAAE,cAAc;YACpC,cAAc,EAAE,OAAO;SACxB,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QACD,yCAAyC;QACzC,OAAO;YACL,aAAa,EAAE,IAAA,SAAM,GAAE;YACvB,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC;IACvC,CAAC;CACF;AAED;;;GAGG;AACU,QAAA,eAAe,GAAG,IAAI,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"mediator-context.js","sourceRoot":"","sources":["../../../src/lib/context/mediator-context.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAChD,+BAAoC;AAiCpC;;;GAGG;AACH,MAAM,sBAAsB;IAA5B;QACmB,YAAO,GAAG,IAAI,+BAAiB,EAAuB,CAAC;IAgF1E,CAAC;IA9EC;;;;;;OAMG;IACH,iBAAiB,CAAI,QAA0B;QAC7C,MAAM,OAAO,GAAwB;YACnC,aAAa,EAAE,IAAA,SAAM,GAAE;YACvB,WAAW,EAAE,SAAS;SACvB,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAI,OAAe,EAAE,QAA0B;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,YAAY,GAAwB;YACxC,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,IAAA,SAAM,GAAE;YACjD,WAAW,EAAE,OAAO,EAAE,cAAc;YACpC,cAAc,EAAE,OAAO;SACxB,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QACD,yCAAyC;QACzC,OAAO;YACL,aAAa,EAAE,IAAA,SAAM,GAAE;YACvB,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC;IACvC,CAAC;CACF;AAED;;;GAGG;AACU,QAAA,eAAe,GAAG,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/lib/event-store/strategies/index.d.ts

@@ -2,12 +2,6 @@ import { Provider } from '@nestjs/common';
 import { EventStoreConfig } from '../../interfaces/index.js';
 export { IEventStoreStrategy } from './event-store-strategy.interface.js';
 export { ISchemaManager } from './schema-manager.interface.js';
-export { PostgresSchemaManager } from './postgres-schema-manager.js';
-export { AbstractPostgresConnectionStrategy } from './abstract-postgres-connection.strategy.js';
-export { ExistingPoolStrategy } from './existing-pool.strategy.js';
-export { UrlConnectionStrategy } from './url-connection.strategy.js';
-export { CustomRepositoryStrategy } from './custom-repository.strategy.js';
-export { PersistenceConsumerStrategy } from './persistence-consumer.strategy.js';
 /**
  * Configure event store by:
  * 1. Running ONE matching repository strategy

package/dist/lib/event-store/strategies/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAQ7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAiBjF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAUN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAQ7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAe/D;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAYN"}

package/dist/lib/event-store/strategies/index.js

@@ -1,24 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PersistenceConsumerStrategy = exports.CustomRepositoryStrategy = exports.UrlConnectionStrategy = exports.ExistingPoolStrategy = exports.AbstractPostgresConnectionStrategy = exports.PostgresSchemaManager = void 0;
 exports.configureEventStore = configureEventStore;
 const existing_pool_strategy_js_1 = require("./existing-pool.strategy.js");
 const url_connection_strategy_js_1 = require("./url-connection.strategy.js");
 const custom_repository_strategy_js_1 = require("./custom-repository.strategy.js");
 const persistence_consumer_strategy_js_1 = require("./persistence-consumer.strategy.js");
-// Implementations
-var postgres_schema_manager_js_1 = require("./postgres-schema-manager.js");
-Object.defineProperty(exports, "PostgresSchemaManager", { enumerable: true, get: function () { return postgres_schema_manager_js_1.PostgresSchemaManager; } });
-var abstract_postgres_connection_strategy_js_1 = require("./abstract-postgres-connection.strategy.js");
-Object.defineProperty(exports, "AbstractPostgresConnectionStrategy", { enumerable: true, get: function () { return abstract_postgres_connection_strategy_js_1.AbstractPostgresConnectionStrategy; } });
-var existing_pool_strategy_js_2 = require("./existing-pool.strategy.js");
-Object.defineProperty(exports, "ExistingPoolStrategy", { enumerable: true, get: function () { return existing_pool_strategy_js_2.ExistingPoolStrategy; } });
-var url_connection_strategy_js_2 = require("./url-connection.strategy.js");
-Object.defineProperty(exports, "UrlConnectionStrategy", { enumerable: true, get: function () { return url_connection_strategy_js_2.UrlConnectionStrategy; } });
-var custom_repository_strategy_js_2 = require("./custom-repository.strategy.js");
-Object.defineProperty(exports, "CustomRepositoryStrategy", { enumerable: true, get: function () { return custom_repository_strategy_js_2.CustomRepositoryStrategy; } });
-var persistence_consumer_strategy_js_2 = require("./persistence-consumer.strategy.js");
-Object.defineProperty(exports, "PersistenceConsumerStrategy", { enumerable: true, get: function () { return persistence_consumer_strategy_js_2.PersistenceConsumerStrategy; } });
+// Note: Concrete strategy implementations (ExistingPoolStrategy, UrlConnectionStrategy, etc.)
+// are intentionally kept internal. Users configure the event store via NestMediatorModule.forRoot().
 /**
  * Repository strategies - only ONE should match based on config.
  * Order matters: more specific checks first.
@@ -28,10 +16,6 @@ const repositoryStrategies = [
     new existing_pool_strategy_js_1.ExistingPoolStrategy(), // Option 2: useExistingPool
     new url_connection_strategy_js_1.UrlConnectionStrategy(), // Option 1: url
 ];
-/**
- * Persistence consumer - always runs after repository is configured.
- */
-const persistenceConsumerStrategy = new persistence_consumer_strategy_js_1.PersistenceConsumerStrategy();
 /**
  * Configure event store by:
  * 1. Running ONE matching repository strategy
@@ -45,6 +29,8 @@ function configureEventStore(providers, config) {
             break;
         }
     }
-    providers.push(...persistenceConsumerStrategy.invoke(config));
+    // 2. Always register the persistence consumer
+    const registrar = new persistence_consumer_strategy_js_1.PersistenceConsumerRegistrar();
+    providers.push(registrar.createProvider(config));
 }
 //# sourceMappingURL=index.js.map

package/dist/lib/event-store/strategies/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/index.ts"],"names":[],"mappings":";;;AAwCA,kDAaC;AAlDD,2EAAmE;AACnE,6EAAqE;AACrE,mFAA2E;AAC3E,yFAAiF;AAMjF,kBAAkB;AAClB,2EAAqE;AAA5D,mIAAA,qBAAqB,OAAA;AAC9B,uGAAgG;AAAvF,8JAAA,kCAAkC,OAAA;AAC3C,yEAAmE;AAA1D,iIAAA,oBAAoB,OAAA;AAC7B,2EAAqE;AAA5D,mIAAA,qBAAqB,OAAA;AAC9B,iFAA2E;AAAlE,yIAAA,wBAAwB,OAAA;AACjC,uFAAiF;AAAxE,+IAAA,2BAA2B,OAAA;AAEpC;;;GAGG;AACH,MAAM,oBAAoB,GAA0B;IAClD,IAAI,wDAAwB,EAAE,EAAG,kCAAkC;IACnE,IAAI,gDAAoB,EAAE,EAAO,4BAA4B;IAC7D,IAAI,kDAAqB,EAAE,EAAM,gBAAgB;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,2BAA2B,GAAG,IAAI,8DAA2B,EAAE,CAAC;AAEtE;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,SAAqB,EACrB,MAAwB;IAExB,8DAA8D;IAC9D,KAAK,MAAM,QAAQ,IAAI,oBAAoB,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3C,MAAM;QACR,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/index.ts"],"names":[],"mappings":";;AA8BA,kDAeC;AA1CD,2EAAmE;AACnE,6EAAqE;AACrE,mFAA2E;AAC3E,yFAAkF;AAMlF,8FAA8F;AAC9F,qGAAqG;AAErG;;;GAGG;AACH,MAAM,oBAAoB,GAA0B;IAClD,IAAI,wDAAwB,EAAE,EAAG,kCAAkC;IACnE,IAAI,gDAAoB,EAAE,EAAO,4BAA4B;IAC7D,IAAI,kDAAqB,EAAE,EAAM,gBAAgB;CAClD,CAAC;AAEF;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,SAAqB,EACrB,MAAwB;IAExB,8DAA8D;IAC9D,KAAK,MAAM,QAAQ,IAAI,oBAAoB,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3C,MAAM;QACR,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,MAAM,SAAS,GAAG,IAAI,+DAA4B,EAAE,CAAC;IACrD,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/event-store/strategies/persistence-consumer.strategy.d.ts

@@ -1,11 +1,10 @@
 import { Provider } from '@nestjs/common';
 import { EventStoreConfig } from '../../interfaces/index.js';
-import { IEventStoreStrategy } from './event-store-strategy.interface.js';
 /**
- * Strategy for registering the persistence consumer.
+ * Registers the persistence consumer on the event bus.
+ * This always runs when an event store is configured — it is not a strategy.
  */
-export declare class PersistenceConsumerStrategy implements IEventStoreStrategy {
-    canHandle(_config: EventStoreConfig): boolean;
-    invoke(config: EventStoreConfig): Provider[];
+export declare class PersistenceConsumerRegistrar {
+    createProvider(config: EventStoreConfig): Provider;
 }
 //# sourceMappingURL=persistence-consumer.strategy.d.ts.map

package/dist/lib/event-store/strategies/persistence-consumer.strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence-consumer.strategy.d.ts","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/persistence-consumer.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAiD,MAAM,2BAA2B,CAAC;AAG5G,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAI1E;;GAEG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAI7C,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,EAAE;CAc7C"}
+{"version":3,"file":"persistence-consumer.strategy.d.ts","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/persistence-consumer.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAiD,MAAM,2BAA2B,CAAC;AAM5G;;;GAGG;AACH,qBAAa,4BAA4B;IACvC,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ;CAYnD"}

package/dist/lib/event-store/strategies/persistence-consumer.strategy.js

@@ -1,32 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PersistenceConsumerStrategy = void 0;
+exports.PersistenceConsumerRegistrar = void 0;
 const common_1 = require("@nestjs/common");
 const index_js_1 = require("../../interfaces/index.js");
 const event_store_persistence_consumer_js_1 = require("../event-store-persistence.consumer.js");
 const event_bus_js_1 = require("../../services/event.bus.js");
 const logger = new common_1.Logger('EventStore');
 /**
- * Strategy for registering the persistence consumer.
+ * Registers the persistence consumer on the event bus.
+ * This always runs when an event store is configured — it is not a strategy.
  */
-class PersistenceConsumerStrategy {
-    canHandle(_config) {
-        return true;
-    }
-    invoke(config) {
-        return [
-            {
-                provide: 'EVENT_STORE_PERSISTENCE_CONSUMER',
-                useFactory: (repo, eventBus) => {
-                    const consumer = new event_store_persistence_consumer_js_1.EventStorePersistenceConsumer(repo, config);
-                    eventBus.registerSystemConsumer(consumer, 'EventStorePersistenceConsumer');
-                    logger.log(`Event store persistence consumer registered (mode: ${config.mode || 'audit'})`);
-                    return consumer;
-                },
-                inject: [index_js_1.EVENT_STORE_REPOSITORY, event_bus_js_1.EventBus],
+class PersistenceConsumerRegistrar {
+    createProvider(config) {
+        return {
+            provide: 'EVENT_STORE_PERSISTENCE_CONSUMER',
+            useFactory: (repo, eventBus) => {
+                const consumer = new event_store_persistence_consumer_js_1.EventStorePersistenceConsumer(repo, config);
+                eventBus.registerSystemConsumer(consumer, 'EventStorePersistenceConsumer');
+                logger.log(`Event store persistence consumer registered (mode: ${config.mode || 'audit'})`);
+                return consumer;
             },
-        ];
+            inject: [index_js_1.EVENT_STORE_REPOSITORY, event_bus_js_1.EventBus],
+        };
     }
 }
-exports.PersistenceConsumerStrategy = PersistenceConsumerStrategy;
+exports.PersistenceConsumerRegistrar = PersistenceConsumerRegistrar;
 //# sourceMappingURL=persistence-consumer.strategy.js.map

package/dist/lib/event-store/strategies/persistence-consumer.strategy.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistence-consumer.strategy.js","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/persistence-consumer.strategy.ts"],"names":[],"mappings":";;;AAAA,2CAAkD;AAClD,wDAA4G;AAC5G,gGAAuF;AACvF,8DAAuD;AAGvD,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,YAAY,CAAC,CAAC;AAExC;;GAEG;AACH,MAAa,2BAA2B;IACtC,SAAS,CAAC,OAAyB;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,MAAwB;QAC7B,OAAO;YACL;gBACE,OAAO,EAAE,kCAAkC;gBAC3C,UAAU,EAAE,CAAC,IAA2B,EAAE,QAAkB,EAAE,EAAE;oBAC9D,MAAM,QAAQ,GAAG,IAAI,mEAA6B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBACjE,QAAQ,CAAC,sBAAsB,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAAC;oBAC3E,MAAM,CAAC,GAAG,CAAC,sDAAsD,MAAM,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC;oBAC5F,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,MAAM,EAAE,CAAC,iCAAsB,EAAE,uBAAQ,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;CACF;AAnBD,kEAmBC"}
+{"version":3,"file":"persistence-consumer.strategy.js","sourceRoot":"","sources":["../../../../src/lib/event-store/strategies/persistence-consumer.strategy.ts"],"names":[],"mappings":";;;AAAA,2CAAkD;AAClD,wDAA4G;AAC5G,gGAAuF;AACvF,8DAAuD;AAEvD,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,YAAY,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAa,4BAA4B;IACvC,cAAc,CAAC,MAAwB;QACrC,OAAO;YACL,OAAO,EAAE,kCAAkC;YAC3C,UAAU,EAAE,CAAC,IAA2B,EAAE,QAAkB,EAAE,EAAE;gBAC9D,MAAM,QAAQ,GAAG,IAAI,mEAA6B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACjE,QAAQ,CAAC,sBAAsB,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAAC;gBAC3E,MAAM,CAAC,GAAG,CAAC,sDAAsD,MAAM,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC;gBAC5F,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,EAAE,CAAC,iCAAsB,EAAE,uBAAQ,CAAC;SAC3C,CAAC;IACJ,CAAC;CACF;AAbD,oEAaC"}

package/dist/lib/mediator-flow/index.d.ts

@@ -0,0 +1,4 @@
+export * from './protocol.js';
+export * from './step-emitter.js';
+export * from './topology-collector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/mediator-flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/mediator-flow/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/dist/lib/mediator-flow/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./protocol.js"), exports);
+__exportStar(require("./step-emitter.js"), exports);
+__exportStar(require("./topology-collector.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/mediator-flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/mediator-flow/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,oDAAkC;AAClC,0DAAwC"}

package/dist/lib/mediator-flow/protocol.d.ts

@@ -0,0 +1,104 @@
+/**
+ * MediatorFlow Protocol Types
+ *
+ * Shared TypeScript interfaces used by both the exporter (nest-mediator library)
+ * and the collector server (mediator-flow-server).
+ */
+export interface CommandRegistration {
+    commandName: string;
+    handlerName: string;
+}
+export interface QueryRegistration {
+    queryName: string;
+    handlerName: string;
+}
+export interface ConsumerRegistration {
+    consumerName: string;
+    criticality: string;
+    order: number;
+    hasCompensation: boolean;
+}
+export interface EventRegistration {
+    eventName: string;
+    aggregateType?: string;
+    consumers: ConsumerRegistration[];
+}
+export interface BehaviorRegistration {
+    behaviorName: string;
+    priority: number;
+    scope: string;
+    requestTypeName?: string;
+}
+export interface AggregateRegistration {
+    aggregateType: string;
+    repositoryName: string;
+    eventTypes: string[];
+}
+export interface TopologyExport {
+    serviceName: string;
+    instanceId: string;
+    bootedAt: string;
+    libraryVersion: string;
+    commands: CommandRegistration[];
+    queries: QueryRegistration[];
+    events: EventRegistration[];
+    behaviors: BehaviorRegistration[];
+    aggregates: AggregateRegistration[];
+}
+export declare enum StepType {
+    COMMAND_DISPATCHED = "COMMAND_DISPATCHED",
+    COMMAND_HANDLER_STARTED = "COMMAND_HANDLER_STARTED",
+    COMMAND_HANDLER_COMPLETED = "COMMAND_HANDLER_COMPLETED",
+    COMMAND_HANDLER_FAILED = "COMMAND_HANDLER_FAILED",
+    QUERY_DISPATCHED = "QUERY_DISPATCHED",
+    QUERY_HANDLER_STARTED = "QUERY_HANDLER_STARTED",
+    QUERY_HANDLER_COMPLETED = "QUERY_HANDLER_COMPLETED",
+    QUERY_HANDLER_FAILED = "QUERY_HANDLER_FAILED",
+    EVENT_PUBLISHED = "EVENT_PUBLISHED",
+    SYSTEM_CONSUMER_STARTED = "SYSTEM_CONSUMER_STARTED",
+    SYSTEM_CONSUMER_COMPLETED = "SYSTEM_CONSUMER_COMPLETED",
+    SYSTEM_CONSUMER_FAILED = "SYSTEM_CONSUMER_FAILED",
+    CRITICAL_CONSUMER_STARTED = "CRITICAL_CONSUMER_STARTED",
+    CRITICAL_CONSUMER_COMPLETED = "CRITICAL_CONSUMER_COMPLETED",
+    CRITICAL_CONSUMER_FAILED = "CRITICAL_CONSUMER_FAILED",
+    NONCRITICAL_CONSUMER_DISPATCHED = "NONCRITICAL_CONSUMER_DISPATCHED",
+    NONCRITICAL_CONSUMER_COMPLETED = "NONCRITICAL_CONSUMER_COMPLETED",
+    NONCRITICAL_CONSUMER_FAILED = "NONCRITICAL_CONSUMER_FAILED",
+    BEHAVIOR_ENTERED = "BEHAVIOR_ENTERED",
+    BEHAVIOR_COMPLETED = "BEHAVIOR_COMPLETED",
+    BEHAVIOR_FAILED = "BEHAVIOR_FAILED",
+    COMPENSATION_STARTED = "COMPENSATION_STARTED",
+    COMPENSATION_COMPLETED = "COMPENSATION_COMPLETED",
+    COMPENSATION_FAILED = "COMPENSATION_FAILED",
+    COMPENSATING_EVENT_PUBLISHED = "COMPENSATING_EVENT_PUBLISHED",
+    RETRY_ATTEMPTED = "RETRY_ATTEMPTED"
+}
+export interface ExecutionStep {
+    stepId: string;
+    instanceId: string;
+    type: StepType;
+    timestamp: string;
+    correlationId: string;
+    causationId?: string;
+    eventId?: string;
+    durationMs?: number;
+    name: string;
+    error?: string;
+    payload?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface StepBatch {
+    instanceId: string;
+    serviceName: string;
+    steps: ExecutionStep[];
+}
+export interface MediatorFlowExporterConfig {
+    enabled: boolean;
+    collectorUrl: string;
+    serviceName?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    includePayloads?: boolean;
+    httpTimeoutMs?: number;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/lib/mediator-flow/protocol.d.ts.map

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

package/dist/lib/mediator-flow/protocol.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * MediatorFlow Protocol Types
+ *
+ * Shared TypeScript interfaces used by both the exporter (nest-mediator library)
+ * and the collector server (mediator-flow-server).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepType = void 0;
+// ─── Execution Step Types ───────────────────────────────────────────────────
+var StepType;
+(function (StepType) {
+    // Command lifecycle
+    StepType["COMMAND_DISPATCHED"] = "COMMAND_DISPATCHED";
+    StepType["COMMAND_HANDLER_STARTED"] = "COMMAND_HANDLER_STARTED";
+    StepType["COMMAND_HANDLER_COMPLETED"] = "COMMAND_HANDLER_COMPLETED";
+    StepType["COMMAND_HANDLER_FAILED"] = "COMMAND_HANDLER_FAILED";
+    // Query lifecycle
+    StepType["QUERY_DISPATCHED"] = "QUERY_DISPATCHED";
+    StepType["QUERY_HANDLER_STARTED"] = "QUERY_HANDLER_STARTED";
+    StepType["QUERY_HANDLER_COMPLETED"] = "QUERY_HANDLER_COMPLETED";
+    StepType["QUERY_HANDLER_FAILED"] = "QUERY_HANDLER_FAILED";
+    // Event lifecycle
+    StepType["EVENT_PUBLISHED"] = "EVENT_PUBLISHED";
+    // System consumer lifecycle
+    StepType["SYSTEM_CONSUMER_STARTED"] = "SYSTEM_CONSUMER_STARTED";
+    StepType["SYSTEM_CONSUMER_COMPLETED"] = "SYSTEM_CONSUMER_COMPLETED";
+    StepType["SYSTEM_CONSUMER_FAILED"] = "SYSTEM_CONSUMER_FAILED";
+    // Critical consumer lifecycle
+    StepType["CRITICAL_CONSUMER_STARTED"] = "CRITICAL_CONSUMER_STARTED";
+    StepType["CRITICAL_CONSUMER_COMPLETED"] = "CRITICAL_CONSUMER_COMPLETED";
+    StepType["CRITICAL_CONSUMER_FAILED"] = "CRITICAL_CONSUMER_FAILED";
+    // Non-critical consumer lifecycle
+    StepType["NONCRITICAL_CONSUMER_DISPATCHED"] = "NONCRITICAL_CONSUMER_DISPATCHED";
+    StepType["NONCRITICAL_CONSUMER_COMPLETED"] = "NONCRITICAL_CONSUMER_COMPLETED";
+    StepType["NONCRITICAL_CONSUMER_FAILED"] = "NONCRITICAL_CONSUMER_FAILED";
+    // Behavior lifecycle
+    StepType["BEHAVIOR_ENTERED"] = "BEHAVIOR_ENTERED";
+    StepType["BEHAVIOR_COMPLETED"] = "BEHAVIOR_COMPLETED";
+    StepType["BEHAVIOR_FAILED"] = "BEHAVIOR_FAILED";
+    // Compensation lifecycle
+    StepType["COMPENSATION_STARTED"] = "COMPENSATION_STARTED";
+    StepType["COMPENSATION_COMPLETED"] = "COMPENSATION_COMPLETED";
+    StepType["COMPENSATION_FAILED"] = "COMPENSATION_FAILED";
+    StepType["COMPENSATING_EVENT_PUBLISHED"] = "COMPENSATING_EVENT_PUBLISHED";
+    // Retry lifecycle
+    StepType["RETRY_ATTEMPTED"] = "RETRY_ATTEMPTED";
+})(StepType || (exports.StepType = StepType = {}));
+//# sourceMappingURL=protocol.js.map

package/dist/lib/mediator-flow/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/lib/mediator-flow/protocol.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAoDH,+EAA+E;AAE/E,IAAY,QA4CX;AA5CD,WAAY,QAAQ;IAClB,oBAAoB;IACpB,qDAAyC,CAAA;IACzC,+DAAmD,CAAA;IACnD,mEAAuD,CAAA;IACvD,6DAAiD,CAAA;IAEjD,kBAAkB;IAClB,iDAAqC,CAAA;IACrC,2DAA+C,CAAA;IAC/C,+DAAmD,CAAA;IACnD,yDAA6C,CAAA;IAE7C,kBAAkB;IAClB,+CAAmC,CAAA;IAEnC,4BAA4B;IAC5B,+DAAmD,CAAA;IACnD,mEAAuD,CAAA;IACvD,6DAAiD,CAAA;IAEjD,8BAA8B;IAC9B,mEAAuD,CAAA;IACvD,uEAA2D,CAAA;IAC3D,iEAAqD,CAAA;IAErD,kCAAkC;IAClC,+EAAmE,CAAA;IACnE,6EAAiE,CAAA;IACjE,uEAA2D,CAAA;IAE3D,qBAAqB;IACrB,iDAAqC,CAAA;IACrC,qDAAyC,CAAA;IACzC,+CAAmC,CAAA;IAEnC,yBAAyB;IACzB,yDAA6C,CAAA;IAC7C,6DAAiD,CAAA;IACjD,uDAA2C,CAAA;IAC3C,yEAA6D,CAAA;IAE7D,kBAAkB;IAClB,+CAAmC,CAAA;AACrC,CAAC,EA5CW,QAAQ,wBAAR,QAAQ,QA4CnB"}

package/dist/lib/mediator-flow/step-emitter.d.ts

@@ -0,0 +1,24 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { ExecutionStep, StepType, MediatorFlowExporterConfig } from './protocol.js';
+export declare class StepEmitter implements OnModuleDestroy {
+    private readonly logger;
+    enabled: boolean;
+    private collectorUrl;
+    private serviceName;
+    private instanceId;
+    private batchSize;
+    private flushIntervalMs;
+    private includePayloads;
+    private httpTimeoutMs;
+    private buffer;
+    private flushTimer;
+    emit(type: StepType, name: string, extra?: Partial<Pick<ExecutionStep, 'eventId' | 'durationMs' | 'error' | 'payload' | 'metadata'>>): void;
+    wrapAsync<T>(startType: StepType, completedType: StepType, failedType: StepType, name: string, fn: () => Promise<T>, extra?: Partial<Pick<ExecutionStep, 'eventId' | 'payload' | 'metadata'>>): Promise<T>;
+    configure(config: MediatorFlowExporterConfig): void;
+    getInstanceId(): string;
+    getServiceName(): string;
+    getCollectorUrl(): string;
+    onModuleDestroy(): Promise<void>;
+    private flush;
+}
+//# sourceMappingURL=step-emitter.d.ts.map