@kronos-ts/messaging 0.1.0

package/dist/gateway.js

@@ -0,0 +1,62 @@
+import { generateIdentifier, emptyMetadata, } from "@kronos-ts/common";
+import { runInNewUoW } from "./unit-of-work.js";
+/**
+ * Creates a command gateway backed by a command bus.
+ *
+ * Plan 03-04 (CTX-04 / D-34): the optional `unitOfWorkRunner` lets the
+ * configurer inject a transactional wrapper (`transactionalUnitOfWorkFactory`)
+ * around the dispatch boundary. Defaults to `runInNewUoW` — preserves the
+ * Plan 03-01 contract that every gateway call starts a fresh UoW.
+ */
+export function createCommandGateway(bus, unitOfWorkRunner = runInNewUoW) {
+    return {
+        async send(descriptor, payload, metadata) {
+            const resolvedMetadata = metadata ?? emptyMetadata();
+            // Plan 03-01 (D-32) / Plan 03-03 (CTX-01): gateways always start a new
+            // UoW. The bus.dispatch call below will detect the ALS state we just
+            // established (via runInUoW in simple-command-bus) and reuse it — so
+            // this is the single UoW boundary for the dispatch chain. No
+            // ProcessingContext parameter is threaded.
+            return unitOfWorkRunner(resolvedMetadata, () => bus.dispatch({
+                identifier: generateIdentifier(),
+                name: descriptor.name,
+                payload,
+                metadata: resolvedMetadata,
+                timestamp: Date.now(),
+            }));
+        },
+    };
+}
+/**
+ * Creates a query gateway backed by a query bus.
+ *
+ * See `createCommandGateway` for the `unitOfWorkRunner` injection contract.
+ */
+export function createQueryGateway(bus, unitOfWorkRunner = runInNewUoW) {
+    return {
+        async query(descriptor, payload, metadata) {
+            const resolvedMetadata = metadata ?? emptyMetadata();
+            // Plan 03-01 (D-32) / Plan 03-03 (CTX-01): gateway always starts a new
+            // UoW; bus.query auto-nests via runInUoW in simple-query-bus.
+            // subscriptionQuery below stays as-is — its initialResult goes through
+            // bus.query, which handles its own UoW.
+            return unitOfWorkRunner(resolvedMetadata, () => bus.query({
+                identifier: generateIdentifier(),
+                name: descriptor.name,
+                payload,
+                metadata: resolvedMetadata,
+                timestamp: Date.now(),
+            }));
+        },
+        subscriptionQuery(descriptor, payload, metadata) {
+            return bus.subscriptionQuery({
+                identifier: generateIdentifier(),
+                name: descriptor.name,
+                payload,
+                metadata: metadata ?? emptyMetadata(),
+                timestamp: Date.now(),
+            });
+        },
+    };
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,aAAa,GAEd,MAAM,mBAAmB,CAAA;AAK1B,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAA;AAgE/D;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAe,EACf,mBAA8B,WAAW;IAEzC,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ;YACtC,MAAM,gBAAgB,GAAG,QAAQ,IAAI,aAAa,EAAE,CAAA;YACpD,uEAAuE;YACvE,qEAAqE;YACrE,qEAAqE;YACrE,6DAA6D;YAC7D,2CAA2C;YAC3C,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAC7C,GAAG,CAAC,QAAQ,CAAC;gBACX,UAAU,EAAE,kBAAkB,EAAE;gBAChC,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO;gBACP,QAAQ,EAAE,gBAAgB;gBAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAiB,CACZ,CAAA;QACV,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAa,EACb,mBAA8B,WAAW;IAEzC,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ;YACvC,MAAM,gBAAgB,GAAG,QAAQ,IAAI,aAAa,EAAE,CAAA;YACpD,uEAAuE;YACvE,8DAA8D;YAC9D,uEAAuE;YACvE,wCAAwC;YACxC,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAC7C,GAAG,CAAC,KAAK,CAAC;gBACR,UAAU,EAAE,kBAAkB,EAAE;gBAChC,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO;gBACP,QAAQ,EAAE,gBAAgB;gBAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAiB,CACZ,CAAA;QACV,CAAC;QAED,iBAAiB,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ;YAC7C,OAAO,GAAG,CAAC,iBAAiB,CAAC;gBAC3B,UAAU,EAAE,kBAAkB,EAAE;gBAChC,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO;gBACP,QAAQ,EAAE,QAAQ,IAAI,aAAa,EAAE;gBACrC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/handler-enhancer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Metadata about a handler being enhanced. Allows enhancers to
+ * selectively wrap based on handler type, message name, etc.
+ */
+export interface HandlerMetadata {
+    /** The type of message this handler processes. */
+    readonly messageType: "command" | "event" | "query";
+    /** The qualified name of the message (e.g., "university.courses.CreateCourse"). */
+    readonly messageName: string;
+    /** The name of the handler group or module (e.g., "course-commands"). */
+    readonly handlerGroup: string;
+}
+/**
+ * Wraps message handler functions at registration time to add cross-cutting
+ * concerns. Different from interceptors — interceptors wrap dispatch,
+ * enhancers wrap the handler itself.
+ *
+ * Applied once at handler discovery/registration time, not per-invocation.
+ * This makes enhancers ideal for:
+ * - Tracing spans per-handler
+ * - Security checks
+ * - Timeout enforcement
+ * - Caching
+ *
+ * @example
+ * ```ts
+ * const timingEnhancer: HandlerEnhancerDefinition = {
+ *   wrapHandler(handler, metadata) {
+ *     return async (...args) => {
+ *       const start = performance.now()
+ *       try {
+ *         return await handler(...args)
+ *       } finally {
+ *         console.log(`${metadata.messageName} took ${performance.now() - start}ms`)
+ *       }
+ *     }
+ *   },
+ * }
+ * ```
+ */
+export interface HandlerEnhancerDefinition {
+    /**
+     * Wrap a handler function. Return the original handler to skip enhancement.
+     * The returned function must have the same signature as the input.
+     */
+    wrapHandler<T extends (...args: any[]) => any>(handler: T, metadata: HandlerMetadata): T;
+}
+/**
+ * Combines multiple handler enhancer definitions into a single one.
+ * Enhancers are applied in order — the first enhancer wraps outermost.
+ */
+export declare function multiHandlerEnhancerDefinition(enhancers: ReadonlyArray<HandlerEnhancerDefinition>): HandlerEnhancerDefinition;
+//# sourceMappingURL=handler-enhancer.d.ts.map

package/dist/handler-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-enhancer.d.ts","sourceRoot":"","sources":["../src/handler-enhancer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACnD,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3C,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,eAAe,GACxB,CAAC,CAAA;CACL;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,aAAa,CAAC,yBAAyB,CAAC,GAClD,yBAAyB,CAW3B"}

package/dist/handler-enhancer.js

@@ -0,0 +1,17 @@
+/**
+ * Combines multiple handler enhancer definitions into a single one.
+ * Enhancers are applied in order — the first enhancer wraps outermost.
+ */
+export function multiHandlerEnhancerDefinition(enhancers) {
+    return {
+        wrapHandler(handler, metadata) {
+            let wrapped = handler;
+            // Apply in reverse order so first enhancer is outermost
+            for (let i = enhancers.length - 1; i >= 0; i--) {
+                wrapped = enhancers[i].wrapHandler(wrapped, metadata);
+            }
+            return wrapped;
+        },
+    };
+}
+//# sourceMappingURL=handler-enhancer.js.map

package/dist/handler-enhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-enhancer.js","sourceRoot":"","sources":["../src/handler-enhancer.ts"],"names":[],"mappings":"AAoDA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,SAAmD;IAEnD,OAAO;QACL,WAAW,CAAoC,OAAU,EAAE,QAAyB;YAClF,IAAI,OAAO,GAAG,OAAO,CAAA;YACrB,wDAAwD;YACxD,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,OAAO,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YACxD,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/handler.d.ts

@@ -0,0 +1,51 @@
+import type { z } from "zod";
+import type { Metadata } from "@kronos-ts/common";
+import type { EventDescriptor, QueryDescriptor } from "./descriptor.js";
+/** A paired event descriptor + handler function, used in handler arrays. */
+export interface EventHandlerRegistration<P extends z.ZodType = z.ZodType> {
+    readonly kind: "event-handler";
+    readonly descriptor: EventDescriptor<P>;
+    readonly handler: (event: z.infer<P>, metadata: Metadata) => Promise<void> | void;
+}
+/**
+ * A paired event descriptor + evolver function, used in entity evolve arrays.
+ *
+ * Evolvers can be sync or async. Async evolvers don't block the event loop
+ * during state reconstruction.
+ */
+export interface EvolverRegistration<S = unknown, P extends z.ZodType = z.ZodType> {
+    readonly kind: "evolver";
+    readonly descriptor: EventDescriptor<P>;
+    readonly evolve: (state: S, event: z.infer<P>, id: unknown) => S | Promise<S>;
+}
+/** A paired query descriptor + handler function, with result type on the handler. */
+export interface QueryHandlerRegistration<Q extends z.ZodType = z.ZodType, R = unknown> {
+    readonly kind: "query-handler";
+    readonly descriptor: QueryDescriptor<Q>;
+    readonly handler: (query: z.infer<Q>, metadata: Metadata) => Promise<R> | R;
+}
+/**
+ * Universal registration function.
+ * Pairs a descriptor with its handler for use in handler/evolve arrays.
+ *
+ * Usage:
+ * - Event handlers:  `on(CourseCreated, async (event, ctx) => { ... })`
+ * - Query handlers:  `on(GetCourse, async (query, ctx) => { return { ... } })`
+ * - Evolvers:        `on(CourseCreated, (state, event) => ({ ...state, name: event.name }))`
+ *
+ * The overload is resolved by the descriptor kind and how many arguments
+ * the callback declares. Evolvers receive `(state, event)` or `(state, event, id)`,
+ * while event handlers receive `(event, context)`.
+ *
+ * In practice the distinction is enforced by the array type:
+ * - `evolve: [on(...)]` expects `EvolverRegistration`
+ * - `handlers: [on(...)]` expects `EventHandlerRegistration`
+ */
+export declare function on<S, P extends z.ZodType>(descriptor: EventDescriptor<P>, evolve: (state: S, event: z.infer<P>, id: unknown) => S | Promise<S>): EvolverRegistration<S, P>;
+export declare function on<P extends z.ZodType>(descriptor: EventDescriptor<P>, handler: (event: z.infer<P>, metadata: Metadata) => Promise<void> | void): EventHandlerRegistration<P>;
+export declare function on<Q extends z.ZodType, R>(descriptor: QueryDescriptor<Q>, handler: (query: z.infer<Q>, metadata: Metadata) => Promise<R> | R): QueryHandlerRegistration<Q, R>;
+/**
+ * @deprecated Use `on()` instead. `onEvent` is kept for backward compatibility.
+ */
+export declare function onEvent<S, P extends z.ZodType>(descriptor: EventDescriptor<P>, evolve: (state: S, event: z.infer<P>, id: unknown) => S | Promise<S>): EvolverRegistration<S, P>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAEV,eAAe,EACf,eAAe,EAChB,MAAM,iBAAiB,CAAA;AAcxB,4EAA4E;AAC5E,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACvE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAClC,CAAC,GAAG,OAAO,EACX,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAE/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9E;AAED,qFAAqF;AACrF,MAAM,WAAW,wBAAwB,CACvC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAC/B,CAAC,GAAG,OAAO;IAEX,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;CACpB;AAMD;;;;;;;;;;;;;;;;GAgBG;AAGH,wBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EACvC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACnE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAG5B,wBAAgB,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACpC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACvE,wBAAwB,CAAC,CAAC,CAAC,CAAA;AAG9B,wBAAgB,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EACvC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAClB,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAyBjC;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5C,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACnE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAE3B"}

package/dist/handler.js

@@ -0,0 +1,26 @@
+export function on(descriptor, handler) {
+    if (descriptor.kind === "event") {
+        // For event descriptors, the same `on()` call is used for both event handlers
+        // and evolvers. We return an object that satisfies both interfaces — the
+        // consumer's array type (evolve: EvolverRegistration[] vs handlers: EventHandlerRegistration[])
+        // enforces correct usage at compile time.
+        return {
+            kind: "event-handler",
+            descriptor: descriptor,
+            handler,
+            evolve: handler,
+        };
+    }
+    return {
+        kind: "query-handler",
+        descriptor: descriptor,
+        handler,
+    };
+}
+/**
+ * @deprecated Use `on()` instead. `onEvent` is kept for backward compatibility.
+ */
+export function onEvent(descriptor, evolve) {
+    return { kind: "evolver", descriptor, evolve };
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAqGA,MAAM,UAAU,EAAE,CAChB,UAA6C,EAC7C,OAAgC;IAEhC,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,8EAA8E;QAC9E,yEAAyE;QACzE,gGAAgG;QAChG,0CAA0C;QAC1C,OAAO;YACL,IAAI,EAAE,eAAsB;YAC5B,UAAU,EAAE,UAA6B;YACzC,OAAO;YACP,MAAM,EAAE,OAAO;SAChB,CAAA;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,UAA6B;QACzC,OAAO;KACR,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,UAA8B,EAC9B,MAAoE;IAEpE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+export { type Message, type CommandMessage, type CommandResultMessage, type EventMessage, type QueryMessage, } from "./message.js";
+export { type CommandDescriptor, type EventDescriptor, type QueryDescriptor, type MessageDescriptor, command, event, query, } from "./descriptor.js";
+export { type TagCriteria, type TypeRestrictedCriteria, type EitherCriteria, type AnyTagCriteria, type RestrictableEventCriteria, EventCriteria, tags, anyTag, either, } from "./event-criteria.js";
+export { Phase, type PhaseValue, on as onPhase, onPrepareCommit, onCommit, onAfterCommit, onError, whenComplete, NoActiveUnitOfWork, WrongUoWPhase, } from "./processing-state.js";
+export { type UoWRunner, runInUoW, runInNewUoW, } from "./unit-of-work.js";
+export { type EventHandlerRegistration, type EvolverRegistration, type QueryHandlerRegistration, on, onEvent, } from "./handler.js";
+export { type CommandHandlerDefinition, commandHandler, } from "./command-handler.js";
+export { type EventHandlerDefinition, eventHandler, } from "./event-handler.js";
+export { type QueryHandlerDefinition, queryHandler, } from "./query-handler.js";
+export { type DispatchInterceptor, type HandlerInterceptor, } from "./interceptor.js";
+export { type RoutingStrategy, metadataRoutingStrategy, payloadFieldRoutingStrategy, } from "./routing-strategy.js";
+export { type HandlerEnhancerDefinition, type HandlerMetadata, multiHandlerEnhancerDefinition, } from "./handler-enhancer.js";
+export { type CorrelationDataProvider, CORRELATION_DATA_KEY, getActiveCorrelationData, messageOriginProvider, simpleCorrelationDataProvider, correlationDataHandlerInterceptor, correlationDataDispatchInterceptor, } from "./correlation-data.js";
+export { type CommandBus } from "./command-bus.js";
+export { type QueryBus } from "./query-bus.js";
+export { createSimpleCommandBus } from "./simple-command-bus.js";
+export { createSimpleQueryBus } from "./simple-query-bus.js";
+export { createInterceptingCommandBus } from "./intercepting-command-bus.js";
+export { createInterceptingQueryBus } from "./intercepting-query-bus.js";
+export { createTracingCommandBus } from "./tracing-command-bus.js";
+export { type CommandGateway, type QueryGateway, createCommandGateway, createQueryGateway, } from "./gateway.js";
+export { type SubscriptionQueryResult, type UpdateHandler, createUpdateHandler, runAfterCommitOrImmediately, } from "./subscription-query.js";
+export { type EventSink } from "./event-sink.js";
+export { type SubscribableEventSource, type EventBus, createSimpleEventBus, } from "./event-bus.js";
+export { createInterceptingEventBus } from "./intercepting-event-bus.js";
+export { type EventGateway, createEventGateway, } from "./event-gateway.js";
+export { type EventProcessor } from "./event-processor.js";
+export { type SequencedEvent, type StreamableEventSource, type StreamingCondition, type MessageStream, createMessageStream, emptyMessageStream, failedMessageStream, } from "./event-source.js";
+export { type TrackingEventProcessor, type TrackingEventProcessorOptions, type EventProcessingErrorHandler, loggingErrorHandler, propagatingErrorHandler, createTrackingEventProcessor, } from "./tracking-event-processor.js";
+export { type Segment, ROOT_SEGMENT, segment, segmentMatches, splitSegment, mergeSegments, isMergeable, segmentCount, hashOf, createSegments, } from "./segment.js";
+export { type TokenStore, UnableToClaimTokenError, createInMemoryTokenStore, } from "./token-store.js";
+export { type TrackingToken, type GlobalSequenceToken, type ReplayToken, globalSequenceToken, FIRST_TOKEN, LATEST_TOKEN, replayToken, isReplayToken, isGlobalSequenceToken, advanceToken, isReplaying, unwrapToken, wasProcessedBeforeReset, } from "./tracking-token.js";
+export { isReplay, REPLAY_STATE_KEY, } from "./replay-token.js";
+export { type TransactionManager, noTransactionManager, getActiveTransaction, transactionalUnitOfWorkFactory, TRANSACTION_KEY, } from "./transaction.js";
+export { type RetryPolicy, exponentialBackoffRetryPolicy, createRetryingCommandBus, } from "./retrying-command-bus.js";
+export { send, COMMAND_BUS_KEY } from "./send.js";
+export { emitUpdate, QUERY_BUS_KEY } from "./emit-update.js";
+export { registerCommandHandlersNatively, createCommandInvocation, type MinimalConfiguration, } from "./command-handling-module.js";
+export { registerQueryHandlersNatively } from "./query-handling-module.js";
+export { type SubscribingEventProcessor, type SubscribingEventProcessorOptions, createSubscribingEventProcessor, } from "./subscribing-event-processor.js";
+export { type StreamingEventProcessor, type StreamingEventProcessorOptions, type EventProcessorStatus, createStreamingEventProcessor, } from "./streaming-event-processor.js";
+export { type DeadLetter, type EnqueueDecision, type EnqueuePolicy, type SequencedDeadLetterQueue, alwaysEnqueuePolicy, createDeadLetter, createInMemoryDeadLetterQueue, DeadLetterQueueOverflowError, } from "./dead-letter-queue.js";
+export { type DeadLetteringOptions, createDeadLetteringDelivery, } from "./dead-lettering-handler.js";
+export { type IntermediateEventRepresentation, type EventUpcaster, singleEventUpcaster, upcasterChain, upcastingSerializer, } from "./upcaster.js";
+export { type SchemaRegistry, jsonSerializer, zodValidatingSerializer, createEventSchemaRegistry, createCommandSchemaRegistry, createQuerySchemaRegistry, } from "./serializer.js";
+export { type MessageMonitor, type MonitorCallback, noOpMessageMonitor, multiMessageMonitor, } from "./message-monitor.js";
+export { type MessageMonitorRegistry, createMessageMonitorRegistry, } from "./message-monitor-registry.js";
+export { type Span, type SpanFactory, type SpanAttributesProvider, noOpSpanFactory, } from "./span-factory.js";
+export { tracingHandlerEnhancerDefinition, } from "./tracing-handler-enhancer.js";
+export { type ProcessorConfiguration } from "./processor-configuration.js";
+export { type EventProcessorModule, type TrackingProcessorModule, type SubscribingProcessorModule, TrackingProcessorBuilder, SubscribingProcessorBuilder, trackingProcessor, subscribingProcessor, } from "./event-processor-builder.js";
+export { withNamespace } from "./with-namespace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,103 @@
+// Messages
+export {} from "./message.js";
+// Descriptors
+export { command, event, query, } from "./descriptor.js";
+// Event criteria
+export { EventCriteria, tags, anyTag, either, } from "./event-criteria.js";
+// Lifecycle phases (Plan 03-04: relocated from processing-context.ts)
+export { Phase, 
+// Module-level lifecycle accessors (CTX-03 / D-30)
+on as onPhase, onPrepareCommit, onCommit, onAfterCommit, onError, whenComplete, NoActiveUnitOfWork, WrongUoWPhase, } from "./processing-state.js";
+// Unit of Work runners (Plan 03-04: replaces UnitOfWorkFactory shape)
+export { runInUoW, runInNewUoW, } from "./unit-of-work.js";
+// Handler registration
+// Note: Handler context wrapper types deleted (Plan 04-02 / D-41).
+// Helper function types deleted.
+// Consumers import load/append from @kronos-ts/eventsourcing and send/dispatch/emitUpdate from here directly.
+export { on, onEvent, } from "./handler.js";
+// Command handlers
+export { commandHandler, } from "./command-handler.js";
+// Event handlers
+export { eventHandler, } from "./event-handler.js";
+// Query handlers
+export { queryHandler, } from "./query-handler.js";
+// Interceptors
+export {} from "./interceptor.js";
+// Routing strategies
+export { metadataRoutingStrategy, payloadFieldRoutingStrategy, } from "./routing-strategy.js";
+// Handler enhancers
+export { multiHandlerEnhancerDefinition, } from "./handler-enhancer.js";
+// Correlation data
+export { CORRELATION_DATA_KEY, getActiveCorrelationData, messageOriginProvider, simpleCorrelationDataProvider, correlationDataHandlerInterceptor, correlationDataDispatchInterceptor, } from "./correlation-data.js";
+// Bus interfaces
+export {} from "./command-bus.js";
+export {} from "./query-bus.js";
+// Bus implementations
+export { createSimpleCommandBus } from "./simple-command-bus.js";
+export { createSimpleQueryBus } from "./simple-query-bus.js";
+// Intercepting bus decorators
+export { createInterceptingCommandBus } from "./intercepting-command-bus.js";
+export { createInterceptingQueryBus } from "./intercepting-query-bus.js";
+// Tracing bus decorators
+export { createTracingCommandBus } from "./tracing-command-bus.js";
+// Gateways
+export { createCommandGateway, createQueryGateway, } from "./gateway.js";
+// Subscription queries
+export { createUpdateHandler, runAfterCommitOrImmediately, } from "./subscription-query.js";
+// Event sink (publish-only)
+export {} from "./event-sink.js";
+// Event bus (publish + subscribe)
+export { createSimpleEventBus, } from "./event-bus.js";
+// Intercepting event bus decorator
+export { createInterceptingEventBus } from "./intercepting-event-bus.js";
+// Event gateway
+export { createEventGateway, } from "./event-gateway.js";
+// Event processor common interface
+export {} from "./event-processor.js";
+// Event source (for processors)
+export { createMessageStream, emptyMessageStream, failedMessageStream, } from "./event-source.js";
+// Event processor
+export { loggingErrorHandler, propagatingErrorHandler, createTrackingEventProcessor, } from "./tracking-event-processor.js";
+// Segments
+export { ROOT_SEGMENT, segment, segmentMatches, splitSegment, mergeSegments, isMergeable, segmentCount, hashOf, createSegments, } from "./segment.js";
+// Token store
+export { UnableToClaimTokenError, createInMemoryTokenStore, } from "./token-store.js";
+// Tracking tokens
+export { globalSequenceToken, FIRST_TOKEN, LATEST_TOKEN, replayToken, isReplayToken, isGlobalSequenceToken, advanceToken, isReplaying, unwrapToken, wasProcessedBeforeReset, } from "./tracking-token.js";
+// Replay detection (ProcessingContext helper)
+export { isReplay, REPLAY_STATE_KEY, } from "./replay-token.js";
+// Transaction management
+export { noTransactionManager, getActiveTransaction, transactionalUnitOfWorkFactory, TRANSACTION_KEY, } from "./transaction.js";
+// Retrying command bus
+export { exponentialBackoffRetryPolicy, createRetryingCommandBus, } from "./retrying-command-bus.js";
+// Module-level handler helpers (Plan 04-01 / HDL-02 / D-42)
+export { send, COMMAND_BUS_KEY } from "./send.js";
+export { emitUpdate, QUERY_BUS_KEY } from "./emit-update.js";
+// Modules — Plan 08-03a (D-82): function-style helpers replace Module-shape factories
+export { registerCommandHandlersNatively, createCommandInvocation, } from "./command-handling-module.js";
+export { registerQueryHandlersNatively } from "./query-handling-module.js";
+// Subscribing event processor
+export { createSubscribingEventProcessor, } from "./subscribing-event-processor.js";
+// Streaming event processor
+export { createStreamingEventProcessor, } from "./streaming-event-processor.js";
+// Dead letter queue
+export { alwaysEnqueuePolicy, createDeadLetter, createInMemoryDeadLetterQueue, DeadLetterQueueOverflowError, } from "./dead-letter-queue.js";
+// Dead-lettering event delivery
+export { createDeadLetteringDelivery, } from "./dead-lettering-handler.js";
+// Upcasting
+export { singleEventUpcaster, upcasterChain, upcastingSerializer, } from "./upcaster.js";
+// Serialization
+export { jsonSerializer, zodValidatingSerializer, createEventSchemaRegistry, createCommandSchemaRegistry, createQuerySchemaRegistry, } from "./serializer.js";
+// Message monitors
+export { noOpMessageMonitor, multiMessageMonitor, } from "./message-monitor.js";
+export { createMessageMonitorRegistry, } from "./message-monitor-registry.js";
+// Tracing (core abstractions)
+export { noOpSpanFactory, } from "./span-factory.js";
+export { tracingHandlerEnhancerDefinition, } from "./tracing-handler-enhancer.js";
+// Processor configuration (legacy)
+export {} from "./processor-configuration.js";
+// Event processor builders
+export { TrackingProcessorBuilder, SubscribingProcessorBuilder, trackingProcessor, subscribingProcessor, } from "./event-processor-builder.js";
+// Namespace factory
+export { withNamespace } from "./with-namespace.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/intercepting-command-bus.d.ts

@@ -0,0 +1,17 @@
+import type { CommandBus } from "./command-bus.js";
+import type { CommandMessage } from "./message.js";
+import type { DispatchInterceptor, HandlerInterceptor } from "./interceptor.js";
+/**
+ * A command bus decorator that adds dispatch and handler interceptor chains
+ * to any {@link CommandBus} implementation.
+ *
+ * {@link createSimpleCommandBus} handles dispatch + subscribe only;
+ * this decorator layers interceptor support on top.
+ */
+export declare function createInterceptingCommandBus(delegate: CommandBus): CommandBus & {
+    /** Register a dispatch interceptor. Returns an unsubscribe function. */
+    registerDispatchInterceptor(interceptor: DispatchInterceptor<CommandMessage>): () => void;
+    /** Register a handler interceptor. Returns an unsubscribe function. */
+    registerHandlerInterceptor(interceptor: HandlerInterceptor): () => void;
+};
+//# sourceMappingURL=intercepting-command-bus.d.ts.map

package/dist/intercepting-command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercepting-command-bus.d.ts","sourceRoot":"","sources":["../src/intercepting-command-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE/E;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,UAAU,GACnB,UAAU,GAAG;IACd,wEAAwE;IACxE,2BAA2B,CAAC,WAAW,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,MAAM,IAAI,CAAA;IACzF,uEAAuE;IACvE,0BAA0B,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAA;CACxE,CAsDA"}

package/dist/intercepting-command-bus.js

@@ -0,0 +1,54 @@
+/**
+ * A command bus decorator that adds dispatch and handler interceptor chains
+ * to any {@link CommandBus} implementation.
+ *
+ * {@link createSimpleCommandBus} handles dispatch + subscribe only;
+ * this decorator layers interceptor support on top.
+ */
+export function createInterceptingCommandBus(delegate) {
+    const dispatchInterceptors = [];
+    const handlerInterceptors = [];
+    return {
+        async dispatch(message) {
+            // Run dispatch interceptors (can transform or reject)
+            let interceptedMessage = message;
+            for (const interceptor of dispatchInterceptors) {
+                interceptedMessage = await interceptor(interceptedMessage);
+            }
+            return delegate.dispatch(interceptedMessage);
+        },
+        subscribe(commandName, handler) {
+            // Wrap the handler with handler interceptors
+            const wrappedHandler = (message) => {
+                if (handlerInterceptors.length === 0) {
+                    return handler(message);
+                }
+                let chain = () => handler(message);
+                for (let i = handlerInterceptors.length - 1; i >= 0; i--) {
+                    const interceptor = handlerInterceptors[i];
+                    const next = chain;
+                    chain = () => interceptor(message, next);
+                }
+                return chain();
+            };
+            delegate.subscribe(commandName, wrappedHandler);
+        },
+        registerDispatchInterceptor(interceptor) {
+            dispatchInterceptors.push(interceptor);
+            return () => {
+                const idx = dispatchInterceptors.indexOf(interceptor);
+                if (idx >= 0)
+                    dispatchInterceptors.splice(idx, 1);
+            };
+        },
+        registerHandlerInterceptor(interceptor) {
+            handlerInterceptors.push(interceptor);
+            return () => {
+                const idx = handlerInterceptors.indexOf(interceptor);
+                if (idx >= 0)
+                    handlerInterceptors.splice(idx, 1);
+            };
+        },
+    };
+}
+//# sourceMappingURL=intercepting-command-bus.js.map

package/dist/intercepting-command-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercepting-command-bus.js","sourceRoot":"","sources":["../src/intercepting-command-bus.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAoB;IAOpB,MAAM,oBAAoB,GAA+C,EAAE,CAAA;IAC3E,MAAM,mBAAmB,GAA8B,EAAE,CAAA;IAEzD,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,OAAuB;YACpC,sDAAsD;YACtD,IAAI,kBAAkB,GAAG,OAAO,CAAA;YAChC,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;gBAC/C,kBAAkB,GAAG,MAAM,WAAW,CAAC,kBAAkB,CAAC,CAAA;YAC5D,CAAC;YAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;QAC9C,CAAC;QAED,SAAS,CACP,WAAmB,EACnB,OAAsD;YAEtD,6CAA6C;YAC7C,MAAM,cAAc,GAAG,CAAC,OAAuB,EAAE,EAAE;gBACjD,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACrC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;gBACzB,CAAC;gBAED,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBAClC,KAAK,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBACzD,MAAM,WAAW,GAAG,mBAAmB,CAAC,CAAC,CAAE,CAAA;oBAC3C,MAAM,IAAI,GAAG,KAAK,CAAA;oBAClB,KAAK,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;gBAC1C,CAAC;gBAED,OAAO,KAAK,EAAE,CAAA;YAChB,CAAC,CAAA;YAED,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;QACjD,CAAC;QAED,2BAA2B,CAAC,WAAW;YACrC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACtC,OAAO,GAAG,EAAE;gBACV,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;gBACrD,IAAI,GAAG,IAAI,CAAC;oBAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACnD,CAAC,CAAA;QACH,CAAC;QAED,0BAA0B,CAAC,WAAW;YACpC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACrC,OAAO,GAAG,EAAE;gBACV,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;gBACpD,IAAI,GAAG,IAAI,CAAC;oBAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YAClD,CAAC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/intercepting-event-bus.d.ts

@@ -0,0 +1,8 @@
+import type { EventBus } from "./event-bus.js";
+import type { EventMessage } from "./message.js";
+import type { DispatchInterceptor } from "./interceptor.js";
+/**
+ * Wraps an EventBus with dispatch interceptors for event publishing.
+ */
+export declare function createInterceptingEventBus(delegate: EventBus, dispatchInterceptors: ReadonlyArray<DispatchInterceptor<EventMessage>>): EventBus;
+//# sourceMappingURL=intercepting-event-bus.d.ts.map

package/dist/intercepting-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercepting-event-bus.d.ts","sourceRoot":"","sources":["../src/intercepting-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,oBAAoB,EAAE,aAAa,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,GACrE,QAAQ,CAkBV"}

package/dist/intercepting-event-bus.js

@@ -0,0 +1,22 @@
+/**
+ * Wraps an EventBus with dispatch interceptors for event publishing.
+ */
+export function createInterceptingEventBus(delegate, dispatchInterceptors) {
+    return {
+        async publish(events) {
+            const intercepted = [];
+            for (const event of events) {
+                let msg = event;
+                for (const interceptor of dispatchInterceptors) {
+                    msg = await interceptor(msg);
+                }
+                intercepted.push(msg);
+            }
+            await delegate.publish(intercepted);
+        },
+        subscribe(handler) {
+            return delegate.subscribe(handler);
+        },
+    };
+}
+//# sourceMappingURL=intercepting-event-bus.js.map

package/dist/intercepting-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercepting-event-bus.js","sourceRoot":"","sources":["../src/intercepting-event-bus.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAkB,EAClB,oBAAsE;IAEtE,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,MAAM;YAClB,MAAM,WAAW,GAAmB,EAAE,CAAA;YACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,GAAG,GAAG,KAAK,CAAA;gBACf,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;oBAC/C,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,CAAiB,CAAA;gBAC9C,CAAC;gBACD,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;YACD,MAAM,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACrC,CAAC;QAED,SAAS,CAAC,OAAO;YACf,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QACpC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/intercepting-query-bus.d.ts

@@ -0,0 +1,17 @@
+import type { QueryBus } from "./query-bus.js";
+import type { QueryMessage } from "./message.js";
+import type { DispatchInterceptor, HandlerInterceptor } from "./interceptor.js";
+/**
+ * A query bus decorator that adds dispatch and handler interceptor chains
+ * to any {@link QueryBus} implementation.
+ *
+ * {@link createSimpleQueryBus} handles dispatch + subscribe only;
+ * this decorator layers interceptor support on top.
+ */
+export declare function createInterceptingQueryBus(delegate: QueryBus): QueryBus & {
+    /** Register a dispatch interceptor. Returns an unsubscribe function. */
+    registerDispatchInterceptor(interceptor: DispatchInterceptor<QueryMessage>): () => void;
+    /** Register a handler interceptor. Returns an unsubscribe function. */
+    registerHandlerInterceptor(interceptor: HandlerInterceptor): () => void;
+};
+//# sourceMappingURL=intercepting-query-bus.d.ts.map

package/dist/intercepting-query-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercepting-query-bus.d.ts","sourceRoot":"","sources":["../src/intercepting-query-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE/E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,GACjB,QAAQ,GAAG;IACZ,wEAAwE;IACxE,2BAA2B,CAAC,WAAW,EAAE,mBAAmB,CAAC,YAAY,CAAC,GAAG,MAAM,IAAI,CAAA;IACvF,uEAAuE;IACvE,0BAA0B,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAA;CACxE,CAoFA"}