@kronos-ts/messaging 0.1.0

package/dist/intercepting-query-bus.js

@@ -0,0 +1,68 @@
+/**
+ * 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 function createInterceptingQueryBus(delegate) {
+    const dispatchInterceptors = [];
+    const handlerInterceptors = [];
+    return {
+        async query(message) {
+            let interceptedMessage = message;
+            for (const interceptor of dispatchInterceptors) {
+                interceptedMessage = await interceptor(interceptedMessage);
+            }
+            return delegate.query(interceptedMessage);
+        },
+        subscribe(queryName, 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(queryName, wrappedHandler);
+        },
+        subscriptionQuery(message, bufferSize) {
+            return delegate.subscriptionQuery(message, bufferSize);
+        },
+        subscribeToUpdates(message, bufferSize) {
+            return delegate.subscribeToUpdates(message, bufferSize);
+        },
+        emitUpdate(queryName, filter, update) {
+            return delegate.emitUpdate(queryName, filter, update);
+        },
+        completeSubscription(queryName, filter) {
+            return delegate.completeSubscription(queryName, filter);
+        },
+        completeSubscriptionExceptionally(queryName, error, filter) {
+            return delegate.completeSubscriptionExceptionally(queryName, error, filter);
+        },
+        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-query-bus.js.map

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

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

package/dist/interceptor.d.ts

@@ -0,0 +1,46 @@
+import type { Message } from "./message.js";
+/**
+ * Intercepts a message before it reaches any handler.
+ * Can transform, enrich, or reject messages.
+ *
+ * Dispatch interceptors run in order — each receives the (possibly transformed)
+ * message from the previous interceptor.
+ *
+ * To reject a message, throw an error.
+ * To transform, return a new message.
+ * To pass through, return the message unchanged.
+ *
+ * UoW-scoped state (correlation data, tracing context, etc.) is read directly
+ * from ALS via module-level accessors (`getResource` / `setResource`) — no
+ * `ProcessingContext` parameter is threaded.
+ *
+ * **Known limitation:** Dispatch interceptors use a simple transform-or-throw
+ * approach. They do not receive a `proceed()` function that can be skipped to
+ * return an alternative result.
+ * A dispatch interceptor cannot halt the chain and return an alternative result
+ * — it can only transform the message or throw to reject it. This covers ~95%
+ * of use cases. Full chain semantics (with `proceed()`) would require the
+ * dispatch interceptor to also control the result type, which is a much larger
+ * refactor. If you need to conditionally prevent dispatch, throw a typed error
+ * and handle it at the call site.
+ */
+export interface DispatchInterceptor<M extends Message = Message> {
+    (message: M): M | Promise<M>;
+}
+/**
+ * Intercepts a handler invocation. Wraps the actual handler call,
+ * enabling before/after logic (transactions, tracing, metrics, etc.)
+ *
+ * UoW-scoped state is read/written via module-level ALS
+ * accessors (`getResource` / `setResource`) — no `ProcessingContext`
+ * parameter is threaded.
+ *
+ * The `next` function calls the next interceptor in the chain, or the
+ * actual handler if this is the last interceptor.
+ *
+ * To skip handling entirely, don't call `next()` and return a result directly.
+ */
+export interface HandlerInterceptor<R = unknown> {
+    (message: Message, next: () => Promise<R>): Promise<R>;
+}
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC9D,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACvD"}

package/dist/interceptor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interceptor.js.map

package/dist/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":""}

package/dist/message-monitor-registry.d.ts

@@ -0,0 +1,28 @@
+import type { Message, CommandMessage, EventMessage, QueryMessage } from "./message.js";
+import type { MessageMonitor } from "./message-monitor.js";
+/**
+ * Registry for message monitors. Collects monitors per message type
+ * and provides combined monitors for each type.
+ *
+ */
+export interface MessageMonitorRegistry {
+    /** Register a monitor for all message types. */
+    registerMonitor(monitor: MessageMonitor<Message>): void;
+    /** Register a monitor for command messages. */
+    registerCommandMonitor(monitor: MessageMonitor<CommandMessage>): void;
+    /** Register a monitor for event messages. */
+    registerEventMonitor(monitor: MessageMonitor<EventMessage>): void;
+    /** Register a monitor for query messages. */
+    registerQueryMonitor(monitor: MessageMonitor<QueryMessage>): void;
+    /** Get the combined monitor for command messages. */
+    commandMonitor(): MessageMonitor<CommandMessage>;
+    /** Get the combined monitor for event messages. */
+    eventMonitor(): MessageMonitor<EventMessage>;
+    /** Get the combined monitor for query messages. */
+    queryMonitor(): MessageMonitor<QueryMessage>;
+}
+/**
+ * Creates a default message monitor registry.
+ */
+export declare function createMessageMonitorRegistry(): MessageMonitorRegistry;
+//# sourceMappingURL=message-monitor-registry.d.ts.map

package/dist/message-monitor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-monitor-registry.d.ts","sourceRoot":"","sources":["../src/message-monitor-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IACvD,+CAA+C;IAC/C,sBAAsB,CAAC,OAAO,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,IAAI,CAAA;IACrE,6CAA6C;IAC7C,oBAAoB,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,CAAA;IACjE,6CAA6C;IAC7C,oBAAoB,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,CAAA;IAEjE,qDAAqD;IACrD,cAAc,IAAI,cAAc,CAAC,cAAc,CAAC,CAAA;IAChD,mDAAmD;IACnD,YAAY,IAAI,cAAc,CAAC,YAAY,CAAC,CAAA;IAC5C,mDAAmD;IACnD,YAAY,IAAI,cAAc,CAAC,YAAY,CAAC,CAAA;CAC7C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,sBAAsB,CAiCrE"}

package/dist/message-monitor-registry.js

@@ -0,0 +1,37 @@
+import { multiMessageMonitor, noOpMessageMonitor } from "./message-monitor.js";
+/**
+ * Creates a default message monitor registry.
+ */
+export function createMessageMonitorRegistry() {
+    const genericMonitors = [];
+    const commandMonitors = [];
+    const eventMonitors = [];
+    const queryMonitors = [];
+    return {
+        registerMonitor(monitor) {
+            genericMonitors.push(monitor);
+        },
+        registerCommandMonitor(monitor) {
+            commandMonitors.push(monitor);
+        },
+        registerEventMonitor(monitor) {
+            eventMonitors.push(monitor);
+        },
+        registerQueryMonitor(monitor) {
+            queryMonitors.push(monitor);
+        },
+        commandMonitor() {
+            const all = [...genericMonitors, ...commandMonitors];
+            return all.length > 0 ? multiMessageMonitor(all) : noOpMessageMonitor();
+        },
+        eventMonitor() {
+            const all = [...genericMonitors, ...eventMonitors];
+            return all.length > 0 ? multiMessageMonitor(all) : noOpMessageMonitor();
+        },
+        queryMonitor() {
+            const all = [...genericMonitors, ...queryMonitors];
+            return all.length > 0 ? multiMessageMonitor(all) : noOpMessageMonitor();
+        },
+    };
+}
+//# sourceMappingURL=message-monitor-registry.js.map

package/dist/message-monitor-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-monitor-registry.js","sourceRoot":"","sources":["../src/message-monitor-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAyB9E;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,eAAe,GAA8B,EAAE,CAAA;IACrD,MAAM,eAAe,GAAqC,EAAE,CAAA;IAC5D,MAAM,aAAa,GAAmC,EAAE,CAAA;IACxD,MAAM,aAAa,GAAmC,EAAE,CAAA;IAExD,OAAO;QACL,eAAe,CAAC,OAAO;YACrB,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;QACD,sBAAsB,CAAC,OAAO;YAC5B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;QACD,oBAAoB,CAAC,OAAO;YAC1B,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;QACD,oBAAoB,CAAC,OAAO;YAC1B,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;QAED,cAAc;YACZ,MAAM,GAAG,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,eAAe,CAAqC,CAAA;YACxF,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAA;QACzE,CAAC;QACD,YAAY;YACV,MAAM,GAAG,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,aAAa,CAAmC,CAAA;YACpF,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAA;QACzE,CAAC;QACD,YAAY;YACV,MAAM,GAAG,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,aAAa,CAAmC,CAAA;YACpF,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAA;QACzE,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/message-monitor.d.ts

@@ -0,0 +1,36 @@
+import type { Message } from "./message.js";
+/**
+ * Callback returned by a MessageMonitor when a message is ingested.
+ * Call `reportSuccess()` or `reportFailure()` when processing completes.
+ */
+export interface MonitorCallback {
+    /** Report that the message was processed successfully. */
+    reportSuccess(): void;
+    /** Report that processing failed. */
+    reportFailure(error?: Error): void;
+}
+/**
+ * Monitors message processing — observes ingestion, success, and failure
+ * of messages flowing through the framework.
+ *
+ * Used by tracing, metrics, and custom observability extensions.
+ * Monitors are registered via the kronos() App messageMonitorRegistry slot
+ * (Phase 8 reshape — was previously the MessagingConfigurer surface).
+ *
+ */
+export interface MessageMonitor<M extends Message = Message> {
+    /**
+     * Called when a message enters processing.
+     * Returns a callback to report the outcome.
+     */
+    onMessageIngested(message: M): MonitorCallback;
+}
+/**
+ * A no-op monitor that does nothing. Default when no monitors are registered.
+ */
+export declare function noOpMessageMonitor<M extends Message = Message>(): MessageMonitor<M>;
+/**
+ * Combines multiple monitors into one. Each monitor is called for every message.
+ */
+export declare function multiMessageMonitor<M extends Message = Message>(monitors: ReadonlyArray<MessageMonitor<M>>): MessageMonitor<M>;
+//# sourceMappingURL=message-monitor.d.ts.map

package/dist/message-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-monitor.d.ts","sourceRoot":"","sources":["../src/message-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,aAAa,IAAI,IAAI,CAAA;IACrB,qCAAqC;IACrC,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IACzD;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,CAAC,GAAG,eAAe,CAAA;CAC/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,CAUnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAC7D,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACzC,cAAc,CAAC,CAAC,CAAC,CAiBnB"}

package/dist/message-monitor.js

@@ -0,0 +1,39 @@
+/**
+ * A no-op monitor that does nothing. Default when no monitors are registered.
+ */
+export function noOpMessageMonitor() {
+    const noOpCallback = {
+        reportSuccess() { },
+        reportFailure() { },
+    };
+    return {
+        onMessageIngested() {
+            return noOpCallback;
+        },
+    };
+}
+/**
+ * Combines multiple monitors into one. Each monitor is called for every message.
+ */
+export function multiMessageMonitor(monitors) {
+    if (monitors.length === 0)
+        return noOpMessageMonitor();
+    if (monitors.length === 1)
+        return monitors[0];
+    return {
+        onMessageIngested(message) {
+            const callbacks = monitors.map(m => m.onMessageIngested(message));
+            return {
+                reportSuccess() {
+                    for (const cb of callbacks)
+                        cb.reportSuccess();
+                },
+                reportFailure(error) {
+                    for (const cb of callbacks)
+                        cb.reportFailure(error);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=message-monitor.js.map

package/dist/message-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-monitor.js","sourceRoot":"","sources":["../src/message-monitor.ts"],"names":[],"mappings":"AA8BA;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,YAAY,GAAoB;QACpC,aAAa,KAAI,CAAC;QAClB,aAAa,KAAI,CAAC;KACnB,CAAA;IACD,OAAO;QACL,iBAAiB;YACf,OAAO,YAAY,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA0C;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,EAAE,CAAA;IACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAA;IAE9C,OAAO;QACL,iBAAiB,CAAC,OAAU;YAC1B,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;YACjE,OAAO;gBACL,aAAa;oBACX,KAAK,MAAM,EAAE,IAAI,SAAS;wBAAE,EAAE,CAAC,aAAa,EAAE,CAAA;gBAChD,CAAC;gBACD,aAAa,CAAC,KAAa;oBACzB,KAAK,MAAM,EAAE,IAAI,SAAS;wBAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;gBACrD,CAAC;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/message.d.ts

@@ -0,0 +1,42 @@
+import type { QualifiedName, Metadata } from "@kronos-ts/common";
+/**
+ * A message carrying a payload and metadata, identified by a unique ID
+ * and routed by its qualified name.
+ */
+export interface Message<P = unknown> {
+    readonly identifier: string;
+    readonly name: QualifiedName;
+    readonly payload: P;
+    readonly metadata: Metadata;
+    readonly timestamp: number;
+}
+/**
+ * A command message — dispatched to exactly one handler, may return a result.
+ */
+export interface CommandMessage<P = unknown> extends Message<P> {
+}
+/**
+ * A command result message — the response from handling a command.
+ */
+export interface CommandResultMessage<R = unknown> {
+    readonly identifier: string;
+    readonly payload: R | undefined;
+    readonly metadata: Metadata;
+    readonly error?: Error;
+}
+/**
+ * An event message — published to all interested handlers.
+ */
+export interface EventMessage<P = unknown> extends Message<P> {
+    readonly version: string;
+    readonly tags: ReadonlyArray<{
+        readonly key: string;
+        readonly value: string;
+    }>;
+}
+/**
+ * A query message — dispatched to handler(s) that can answer it.
+ */
+export interface QueryMessage<P = unknown> extends Message<P> {
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;CAAG;AAElE;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;CAAG"}

package/dist/message.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":""}

package/dist/processing-state.d.ts

@@ -0,0 +1,115 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { Metadata, ResourceKey } from "@kronos-ts/common";
+/**
+ * Lifecycle phases for message processing, ordered by execution priority.
+ *
+ * Phases execute in ascending order. Actions within the same phase
+ * execute in registration order. Actions registered during execution
+ * (e.g., onPrepareCommit from a handler) are picked up when their
+ * phase comes.
+ *
+ * Plan 03-04 (CTX-04 / D-34): Phase enum relocated here from the
+ * deleted processing-context.ts. The numeric values are stable —
+ * external code (handler enhancers, processors) compares phase numbers.
+ */
+export declare const Phase: {
+    /** Setup before handler invocation (e.g., transaction start). */
+    readonly PRE_INVOCATION: -10000;
+    /** Actual handler execution. */
+    readonly INVOCATION: 0;
+    /** Cleanup after handler, before commit. */
+    readonly POST_INVOCATION: 10000;
+    /** Prepare for commit (e.g., event store flush, token store). */
+    readonly PREPARE_COMMIT: 20000;
+    /** Actual commit (e.g., database transaction commit). */
+    readonly COMMIT: 30000;
+    /** Post-commit notifications (e.g., subscription query updates). */
+    readonly AFTER_COMMIT: 40000;
+};
+export type PhaseValue = (typeof Phase)[keyof typeof Phase];
+type PhaseAction = () => Promise<void> | void;
+type ErrorHandler = (error: unknown, phase?: PhaseValue) => Promise<void> | void;
+type CompleteHandler = () => void;
+type Status = "not_started" | "started" | "completed" | "error";
+type InternalProcessingState = {
+    resources: Map<symbol, unknown>;
+    phaseActions: Map<PhaseValue, PhaseAction[]>;
+    errorHandlers: ErrorHandler[];
+    completeHandlers: CompleteHandler[];
+    currentPhase: PhaseValue | null;
+    status: Status;
+    metadata: Metadata;
+};
+export declare const processingStateStorage: AsyncLocalStorage<InternalProcessingState>;
+export declare class NoActiveUnitOfWork extends Error {
+    constructor(message?: string);
+}
+/**
+ * Plan 04-01 (HDL-02 / D-43): thrown by mutating helpers (append, send, emitUpdate)
+ * when called outside the INVOCATION phase. Distinct class (not a NoActiveUnitOfWork
+ * subclass) — a UoW IS active, but it's in the wrong phase. Catches the real bug
+ * pattern of mutations from lifecycle hooks (onCommit, onPrepareCommit, etc.).
+ */
+export declare class WrongUoWPhase extends Error {
+    readonly currentPhase: PhaseValue | null;
+    constructor(currentPhase: PhaseValue | null);
+}
+/**
+ * Plan 04-01 (HDL-02 / D-43): mutator guard. Throws NoActiveUnitOfWork outside a UoW;
+ * throws WrongUoWPhase when active phase != INVOCATION; otherwise returns the state.
+ * Used by append (eventsourcing), send + emitUpdate (messaging).
+ * Internal — NOT exported from index.ts barrel. Consumed via deep-path import.
+ */
+export declare function requireInvocationPhase(): InternalProcessingState;
+export declare function getResource<T>(key: ResourceKey<T>): T | undefined;
+export declare function setResource<T>(key: ResourceKey<T>, value: T): T | undefined;
+export declare function computeIfAbsent<T>(key: ResourceKey<T>, supplier: () => T): T;
+export declare function removeResource<T>(key: ResourceKey<T>): T | undefined;
+export declare function hasResource<T>(key: ResourceKey<T>): boolean;
+export declare function updateResource<T>(key: ResourceKey<T>, updater: (current: T | undefined) => T): T;
+export declare function registerPhaseAction(phase: PhaseValue, action: PhaseAction): void;
+export declare function registerErrorHandler(handler: ErrorHandler): void;
+export declare function registerCompleteHandler(handler: CompleteHandler): void;
+export declare function on(phase: PhaseValue, action: PhaseAction): void;
+export declare function onPrepareCommit(action: PhaseAction): void;
+export declare function onCommit(action: PhaseAction): void;
+export declare function onAfterCommit(action: PhaseAction): void;
+export declare function onError(handler: ErrorHandler): void;
+export declare function whenComplete(handler: CompleteHandler): void;
+/**
+ * Run `fn` in a nested processingStateStorage context where `key` resolves to `value`.
+ *
+ * Only the `resources` Map is forked (D-08). All other fields — phaseActions,
+ * errorHandlers, completeHandlers, status, currentPhase, metadata — are SHARED
+ * references to the parent state. Registering a phase action or error handler
+ * inside `fn` targets the parent's lifecycle.
+ *
+ * After `fn` resolves, the parent's resources are unchanged (D-09) — nested
+ * `storage.run()` naturally pops the forked state.
+ *
+ * Throws NoActiveUnitOfWork if called outside an existing processingStateStorage.run().
+ */
+export declare function withOverride<T, R>(key: ResourceKey<T>, value: T, fn: () => Promise<R>): Promise<R>;
+/**
+ * INTERNAL — used by UnitOfWork to construct the initial state passed to
+ * processingStateStorage.run(). The InternalProcessingState type is intentionally
+ * non-exported (D-13); this factory is the sanctioned construction point.
+ * Deep-path import only; NOT re-exported from the package barrel (D-05).
+ *
+ * Return type is intentionally INFERRED (no `: InternalProcessingState` annotation).
+ * Annotating the return type with a non-exported name produces TS4023 under
+ * `declaration: true` / `isolatedDeclarations`, breaking the package build.
+ * Inference preserves D-13 (the type remains non-exported) while allowing `.d.ts`
+ * emission.
+ */
+export declare function createInitialProcessingState(metadata: Metadata): {
+    resources: Map<symbol, unknown>;
+    phaseActions: Map<PhaseValue, PhaseAction[]>;
+    errorHandlers: ErrorHandler[];
+    completeHandlers: CompleteHandler[];
+    currentPhase: PhaseValue | null;
+    status: Status;
+    metadata: Readonly<Record<string, unknown>>;
+};
+export {};
+//# sourceMappingURL=processing-state.d.ts.map

package/dist/processing-state.d.ts.map

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