@kronos-ts/messaging 0.1.0

package/dist/processing-state.js

@@ -0,0 +1,205 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * 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 const Phase = {
+    /** Setup before handler invocation (e.g., transaction start). */
+    PRE_INVOCATION: -10000,
+    /** Actual handler execution. */
+    INVOCATION: 0,
+    /** Cleanup after handler, before commit. */
+    POST_INVOCATION: 10000,
+    /** Prepare for commit (e.g., event store flush, token store). */
+    PREPARE_COMMIT: 20000,
+    /** Actual commit (e.g., database transaction commit). */
+    COMMIT: 30000,
+    /** Post-commit notifications (e.g., subscription query updates). */
+    AFTER_COMMIT: 40000,
+};
+// D-04: Framework-wide ALS instance. Exported (deep-path only per D-05).
+export const processingStateStorage = new AsyncLocalStorage();
+// D-10: stable error name.
+export class NoActiveUnitOfWork extends Error {
+    constructor(message = "No active UnitOfWork: accessor called outside processingStateStorage.run()") {
+        super(message);
+        this.name = "NoActiveUnitOfWork";
+    }
+}
+/**
+ * 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 class WrongUoWPhase extends Error {
+    currentPhase;
+    constructor(currentPhase) {
+        super(`Mutating helper called during phase ${currentPhase} — must be called during INVOCATION (${Phase.INVOCATION}) only. ` +
+            `Do not call append/send/emitUpdate from lifecycle hooks (onPrepareCommit, onCommit, onAfterCommit, onError, whenComplete).`);
+        this.name = "WrongUoWPhase";
+        this.currentPhase = currentPhase;
+    }
+}
+function requireState() {
+    const state = processingStateStorage.getStore();
+    if (state === undefined)
+        throw new NoActiveUnitOfWork();
+    return state;
+}
+/**
+ * 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 function requireInvocationPhase() {
+    const state = processingStateStorage.getStore();
+    if (state === undefined)
+        throw new NoActiveUnitOfWork();
+    if (state.currentPhase !== Phase.INVOCATION)
+        throw new WrongUoWPhase(state.currentPhase);
+    return state;
+}
+// ── Resource accessors ──────────────────────────────────────────────────
+export function getResource(key) {
+    const state = requireState();
+    return state.resources.get(key.symbol);
+}
+export function setResource(key, value) {
+    const state = requireState();
+    const previous = state.resources.get(key.symbol);
+    state.resources.set(key.symbol, value);
+    return previous;
+}
+export function computeIfAbsent(key, supplier) {
+    const state = requireState();
+    const existing = state.resources.get(key.symbol);
+    if (existing !== undefined)
+        return existing;
+    const value = supplier();
+    state.resources.set(key.symbol, value);
+    return value;
+}
+export function removeResource(key) {
+    const state = requireState();
+    const previous = state.resources.get(key.symbol);
+    state.resources.delete(key.symbol);
+    return previous;
+}
+export function hasResource(key) {
+    const state = requireState();
+    return state.resources.has(key.symbol);
+}
+export function updateResource(key, updater) {
+    const state = requireState();
+    const current = state.resources.get(key.symbol);
+    const updated = updater(current);
+    state.resources.set(key.symbol, updated);
+    return updated;
+}
+// ── Lifecycle registration ──────────────────────────────────────────────
+export function registerPhaseAction(phase, action) {
+    const state = requireState();
+    let bucket = state.phaseActions.get(phase);
+    if (!bucket) {
+        bucket = [];
+        state.phaseActions.set(phase, bucket);
+    }
+    bucket.push(action);
+}
+export function registerErrorHandler(handler) {
+    const state = requireState();
+    state.errorHandlers.push(handler);
+}
+export function registerCompleteHandler(handler) {
+    const state = requireState();
+    state.completeHandlers.push(handler);
+}
+// ── Lifecycle accessors (CTX-03, D-30) ──────────────────────────────────
+//
+// Module-level equivalents of ctx.on / ctx.onError / ctx.whenComplete /
+// ctx.onPrepareCommit / ctx.onCommit / ctx.onAfterCommit. Thin wrappers
+// over the Phase 1 accessors (registerPhaseAction / registerErrorHandler /
+// registerCompleteHandler). Same fail-fast contract (D-31): throw
+// NoActiveUnitOfWork outside an active processingStateStorage.run.
+export function on(phase, action) {
+    registerPhaseAction(phase, action);
+}
+export function onPrepareCommit(action) {
+    registerPhaseAction(Phase.PREPARE_COMMIT, action);
+}
+export function onCommit(action) {
+    registerPhaseAction(Phase.COMMIT, action);
+}
+export function onAfterCommit(action) {
+    registerPhaseAction(Phase.AFTER_COMMIT, action);
+}
+export function onError(handler) {
+    registerErrorHandler(handler);
+}
+export function whenComplete(handler) {
+    registerCompleteHandler(handler);
+}
+// ── withOverride (D-07..D-09) ──────────────────────────────────────────
+/**
+ * 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 function withOverride(key, value, fn) {
+    const parent = requireState();
+    const forkedResources = new Map(parent.resources);
+    forkedResources.set(key.symbol, value);
+    const forkedState = {
+        resources: forkedResources,
+        // SHARED references to parent (D-08):
+        phaseActions: parent.phaseActions,
+        errorHandlers: parent.errorHandlers,
+        completeHandlers: parent.completeHandlers,
+        status: parent.status,
+        currentPhase: parent.currentPhase,
+        metadata: parent.metadata,
+    };
+    return processingStateStorage.run(forkedState, fn);
+}
+/**
+ * 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 function createInitialProcessingState(metadata) {
+    return {
+        resources: new Map(),
+        phaseActions: new Map(),
+        errorHandlers: [],
+        completeHandlers: [],
+        currentPhase: null,
+        status: "not_started",
+        metadata,
+    };
+}
+//# sourceMappingURL=processing-state.js.map

package/dist/processing-state.js.map

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

package/dist/processor-configuration.d.ts

@@ -0,0 +1,51 @@
+import type { TokenStore } from "./token-store.js";
+import type { UoWRunner } from "./unit-of-work.js";
+import type { EventProcessingErrorHandler } from "./tracking-event-processor.js";
+import type { SequencedDeadLetterQueue } from "./dead-letter-queue.js";
+/**
+ * Configuration for an individual event processor.
+ *
+ * All properties are optional — when not specified, the processor
+ * uses the global defaults from the messaging configurer.
+ *
+ * This enables per-processor tuning: different processors can have
+ * different batch sizes, token stores, error handlers, etc.
+ *
+ * ```typescript
+ * messagingConfigurer({
+ *   eventHandlers: [courseProjection],
+ *   processorConfiguration: {
+ *     "course-projection": {
+ *       batchSize: 50,
+ *       initialSegmentCount: 4,
+ *       errorHandler: propagatingErrorHandler(),
+ *     },
+ *   },
+ * })
+ * ```
+ */
+/**
+ * @deprecated Use `trackingProcessor()` / `subscribingProcessor()` builders
+ * with `registerEventProcessor()` instead.
+ */
+export interface ProcessorConfiguration {
+    /** Events per transaction. Default: 100 */
+    batchSize?: number;
+    /** Number of segments to create on first startup. Default: 1 */
+    initialSegmentCount?: number;
+    /** Polling interval in ms (for TrackingEventProcessor). Default: 500 */
+    pollingIntervalMs?: number;
+    /** Override the token store for this processor. */
+    tokenStore?: TokenStore;
+    /** Override the UnitOfWork runner for this processor. */
+    unitOfWorkRunner?: UoWRunner;
+    /** Override the error handler for this processor. */
+    errorHandler?: EventProcessingErrorHandler;
+    /** Dead letter queue for this processor. */
+    deadLetterQueue?: SequencedDeadLetterQueue;
+    /** How often to extend claims in ms. Default: 5000 */
+    claimExtensionThresholdMs?: number;
+    /** How often to attempt claiming new segments in ms. Default: 5000 */
+    tokenClaimIntervalMs?: number;
+}
+//# sourceMappingURL=processor-configuration.d.ts.map

package/dist/processor-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-configuration.d.ts","sourceRoot":"","sources":["../src/processor-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,mDAAmD;IACnD,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAE5B,qDAAqD;IACrD,YAAY,CAAC,EAAE,2BAA2B,CAAA;IAE1C,4CAA4C;IAC5C,eAAe,CAAC,EAAE,wBAAwB,CAAA;IAE1C,sDAAsD;IACtD,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAElC,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B"}

package/dist/processor-configuration.js

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

package/dist/processor-configuration.js.map

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

package/dist/query-bus.d.ts

@@ -0,0 +1,51 @@
+import type { QueryMessage } from "./message.js";
+import type { SubscriptionQueryResult } from "./subscription-query.js";
+/**
+ * The query bus — low-level infrastructure for dispatching query messages.
+ *
+ */
+export interface QueryBus {
+    /**
+     * Dispatch a query message to its handler(s).
+     *
+     * The bus auto-nests via ALS (CTX-02): when called outside a UnitOfWork,
+     * `runInUoW` creates one; when called inside an active UoW (handler-internal
+     * re-dispatch), the active UoW is reused.
+     */
+    query(message: QueryMessage): Promise<unknown>;
+    /**
+     * Subscribe a handler for the given query name.
+     *
+     * Plan 03-04 (CTX-04 / D-34): handler signature dropped its `ctx`
+     * parameter. The ProcessingContext type is gone.
+     */
+    subscribe(queryName: string, handler: (message: QueryMessage) => Promise<unknown>): void;
+    /**
+     * Start a subscription query — returns the initial result plus a stream
+     * of incremental updates.
+     */
+    subscriptionQuery(message: QueryMessage, bufferSize?: number): SubscriptionQueryResult;
+    /**
+     * Subscribe to updates only (no initial result).
+     * Returns an async iterable of update payloads.
+     *
+     */
+    subscribeToUpdates(message: QueryMessage, bufferSize?: number): AsyncIterable<unknown> & {
+        close(): void;
+    };
+    /**
+     * Emit an update to all active subscription queries matching the filter.
+     * When called within an active UnitOfWork (detected via ALS), the update is
+     * deferred to AFTER_COMMIT.
+     */
+    emitUpdate(queryName: string, filter: (queryPayload: unknown) => boolean, update: unknown): Promise<void>;
+    /**
+     * Complete all subscription queries matching the filter.
+     */
+    completeSubscription(queryName: string, filter?: (queryPayload: unknown) => boolean): Promise<void>;
+    /**
+     * Complete all subscription queries matching the filter with an error.
+     */
+    completeSubscriptionExceptionally(queryName: string, error: Error, filter?: (queryPayload: unknown) => boolean): Promise<void>;
+}
+//# sourceMappingURL=query-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-bus.d.ts","sourceRoot":"","sources":["../src/query-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEtE;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE9C;;;;;OAKG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GACnD,IAAI,CAAA;IAEP;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAAA;IAEtF;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAA;IAE1G;;;;OAIG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,EAC1C,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB;;OAEG;IACH,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB;;OAEG;IACH,iCAAiC,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB"}

package/dist/query-bus.js

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

package/dist/query-bus.js.map

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

package/dist/query-handler.d.ts

@@ -0,0 +1,35 @@
+import type { z } from "zod";
+import type { Metadata } from "@kronos-ts/common";
+import type { QueryDescriptor } from "./descriptor.js";
+/**
+ * A registered singular query handler — pairs a query descriptor with its handler
+ * function. Mirrors {@link import("./command-handler.js").CommandHandlerDefinition}
+ * structurally so all three handler shapes (command / event / query) share the same
+ * pattern.
+ *
+ * Note: queries do NOT carry a result schema on the descriptor (see `QueryDescriptor`
+ * in `./descriptor.ts` — no `result` field used here). The result type `R` is
+ * inferred from the handler's return type.
+ */
+export interface QueryHandlerDefinition<Q extends z.ZodType = z.ZodType, R = unknown> {
+    readonly kind: "query-handler";
+    readonly descriptor: QueryDescriptor<Q, z.ZodType | undefined>;
+    readonly handler: (query: z.infer<Q>, metadata: Metadata) => Promise<R> | R;
+}
+/**
+ * Defines a singular query handler.
+ *
+ * ```
+ * const getCourseView = queryHandler(GetCourseView, async (q, metadata) => {
+ *   const view = courseViews.get(q.courseId)
+ *   if (!view) throw new Error("not found")
+ *   return view
+ * })
+ * ```
+ *
+ * Use with `app.queries(getCourseView, getAllCourses)`. Symmetric to
+ * {@link import("./command-handler.js").commandHandler} and
+ * {@link import("./event-handler.js").eventHandler}.
+ */
+export declare function queryHandler<Q extends z.ZodType, R>(descriptor: QueryDescriptor<Q, z.ZodType | undefined>, handler: (query: z.infer<Q>, metadata: Metadata) => Promise<R> | R): QueryHandlerDefinition<Q, R>;
+//# sourceMappingURL=query-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.d.ts","sourceRoot":"","sources":["../src/query-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,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAOtD;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB,CACrC,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,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;CAC5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EACjD,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,EACrD,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACjE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9B"}

package/dist/query-handler.js

@@ -0,0 +1,19 @@
+/**
+ * Defines a singular query handler.
+ *
+ * ```
+ * const getCourseView = queryHandler(GetCourseView, async (q, metadata) => {
+ *   const view = courseViews.get(q.courseId)
+ *   if (!view) throw new Error("not found")
+ *   return view
+ * })
+ * ```
+ *
+ * Use with `app.queries(getCourseView, getAllCourses)`. Symmetric to
+ * {@link import("./command-handler.js").commandHandler} and
+ * {@link import("./event-handler.js").eventHandler}.
+ */
+export function queryHandler(descriptor, handler) {
+    return { kind: "query-handler", descriptor, handler };
+}
+//# sourceMappingURL=query-handler.js.map

package/dist/query-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.js","sourceRoot":"","sources":["../src/query-handler.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAqD,EACrD,OAAkE;IAElE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AACvD,CAAC"}

package/dist/query-handling-module.d.ts

@@ -0,0 +1,24 @@
+import type { QueryHandlerDefinition } from "./query-handler.js";
+import type { QueryBus } from "./query-bus.js";
+import type { HandlerEnhancerDefinition } from "./handler-enhancer.js";
+/**
+ * Function-style helper called by AppImpl.start() to subscribe query handlers
+ * natively, without the configurer's Module shape.
+ *
+ * Accepts a flat ReadonlyArray<QueryHandlerDefinition> (singular handler shape).
+ *
+ * Symmetric to registerCommandHandlersNatively — accepts an optional
+ * handlerEnhancer that wraps each query invocation so query handlers receive
+ * the same tracing / timing / cross-cutting treatment as command and event
+ * handlers. moduleName defaults to "queries" for HandlerMetadata.handlerGroup.
+ *
+ * Query handlers do NOT need a Configuration shim — queries don't append
+ * events, so no per-invocation ALS resource setup is required at query
+ * subscription level.
+ */
+export declare function registerQueryHandlersNatively(handlers: ReadonlyArray<QueryHandlerDefinition>, deps: {
+    queryBus: QueryBus;
+    handlerEnhancer?: HandlerEnhancerDefinition;
+    moduleName?: string;
+}): void;
+//# sourceMappingURL=query-handling-module.d.ts.map

package/dist/query-handling-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handling-module.d.ts","sourceRoot":"","sources":["../src/query-handling-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAEtE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,aAAa,CAAC,sBAAsB,CAAC,EAC/C,IAAI,EAAE;IACJ,QAAQ,EAAE,QAAQ,CAAA;IAClB,eAAe,CAAC,EAAE,yBAAyB,CAAA;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GACA,IAAI,CAeN"}

package/dist/query-handling-module.js

@@ -0,0 +1,32 @@
+import { qualifiedNameToString } from "@kronos-ts/common";
+/**
+ * Function-style helper called by AppImpl.start() to subscribe query handlers
+ * natively, without the configurer's Module shape.
+ *
+ * Accepts a flat ReadonlyArray<QueryHandlerDefinition> (singular handler shape).
+ *
+ * Symmetric to registerCommandHandlersNatively — accepts an optional
+ * handlerEnhancer that wraps each query invocation so query handlers receive
+ * the same tracing / timing / cross-cutting treatment as command and event
+ * handlers. moduleName defaults to "queries" for HandlerMetadata.handlerGroup.
+ *
+ * Query handlers do NOT need a Configuration shim — queries don't append
+ * events, so no per-invocation ALS resource setup is required at query
+ * subscription level.
+ */
+export function registerQueryHandlersNatively(handlers, deps) {
+    const moduleName = deps.moduleName ?? "queries";
+    for (const reg of handlers) {
+        const queryName = qualifiedNameToString(reg.descriptor.name);
+        let invocation = async (message) => reg.handler(message.payload, message.metadata);
+        if (deps.handlerEnhancer) {
+            invocation = deps.handlerEnhancer.wrapHandler(invocation, {
+                messageType: "query",
+                messageName: queryName,
+                handlerGroup: moduleName,
+            });
+        }
+        deps.queryBus.subscribe(queryName, invocation);
+    }
+}
+//# sourceMappingURL=query-handling-module.js.map

package/dist/query-handling-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handling-module.js","sourceRoot":"","sources":["../src/query-handling-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAMzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAA+C,EAC/C,IAIC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,CAAA;IAC/C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAC5D,IAAI,UAAU,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE,CAC/C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;QAChD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,UAAU,EAAE;gBACxD,WAAW,EAAE,OAAO;gBACpB,WAAW,EAAE,SAAS;gBACtB,YAAY,EAAE,UAAU;aACzB,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IAChD,CAAC;AACH,CAAC"}

package/dist/replay-token.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Re-exports from tracking-token.ts plus the isReplay() helper.
+ *
+ * Plan 03-04 (CTX-04 / D-29): `isReplay()` is a no-arg permissive ALS read.
+ * It returns `false` when called outside an active UnitOfWork (replay-state
+ * has only ever been set by the tracking processor; absence == not replaying).
+ */
+import { type ResourceKey } from "@kronos-ts/common";
+export { type TrackingToken, type GlobalSequenceToken, type ReplayToken, globalSequenceToken, replayToken, isReplayToken, isGlobalSequenceToken, advanceToken, isReplaying, unwrapToken, wasProcessedBeforeReset, } from "./tracking-token.js";
+/** Resource key for storing replay state in the active UnitOfWork. */
+export declare const REPLAY_STATE_KEY: ResourceKey<{
+    replaying: boolean;
+}>;
+/**
+ * Check if the current processing is a replay.
+ * Use this in event handlers to skip side effects during replay.
+ *
+ * Plan 03-04 (D-29): no-arg permissive ALS read. Returns `false` when called
+ * outside an active UnitOfWork.
+ *
+ * ```
+ * on(OrderPlaced, async (event) => {
+ *   await db.orders.insert(event)
+ *   if (!isReplay()) {
+ *     await sendConfirmationEmail(event.email)
+ *   }
+ * })
+ * ```
+ */
+export declare function isReplay(): boolean;
+//# sourceMappingURL=replay-token.d.ts.map

package/dist/replay-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-token.d.ts","sourceRoot":"","sources":["../src/replay-token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIjE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAE5B,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CACrC,CAAA;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAOlC"}

package/dist/replay-token.js

@@ -0,0 +1,37 @@
+/**
+ * Re-exports from tracking-token.ts plus the isReplay() helper.
+ *
+ * Plan 03-04 (CTX-04 / D-29): `isReplay()` is a no-arg permissive ALS read.
+ * It returns `false` when called outside an active UnitOfWork (replay-state
+ * has only ever been set by the tracking processor; absence == not replaying).
+ */
+import { resourceKey } from "@kronos-ts/common";
+import { processingStateStorage } from "./processing-state.js";
+// Re-export token types and operations
+export { globalSequenceToken, replayToken, isReplayToken, isGlobalSequenceToken, advanceToken, isReplaying, unwrapToken, wasProcessedBeforeReset, } from "./tracking-token.js";
+/** Resource key for storing replay state in the active UnitOfWork. */
+export const REPLAY_STATE_KEY = resourceKey("replayState");
+/**
+ * Check if the current processing is a replay.
+ * Use this in event handlers to skip side effects during replay.
+ *
+ * Plan 03-04 (D-29): no-arg permissive ALS read. Returns `false` when called
+ * outside an active UnitOfWork.
+ *
+ * ```
+ * on(OrderPlaced, async (event) => {
+ *   await db.orders.insert(event)
+ *   if (!isReplay()) {
+ *     await sendConfirmationEmail(event.email)
+ *   }
+ * })
+ * ```
+ */
+export function isReplay() {
+    const state = processingStateStorage.getStore();
+    if (!state)
+        return false;
+    const replayState = state.resources.get(REPLAY_STATE_KEY.symbol);
+    return replayState?.replaying === true;
+}
+//# sourceMappingURL=replay-token.js.map

package/dist/replay-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-token.js","sourceRoot":"","sources":["../src/replay-token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,uCAAuC;AACvC,OAAO,EAIL,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAE5B,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAC3B,WAAW,CAAC,aAAa,CAAC,CAAA;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAA;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAElD,CAAA;IACb,OAAO,WAAW,EAAE,SAAS,KAAK,IAAI,CAAA;AACxC,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { CommandBus } from "./command-bus.js";
+/**
+ * Determines whether a failed command dispatch should be retried.
+ */
+export interface RetryPolicy {
+    /**
+     * Returns the delay in ms before the next retry, or undefined to stop retrying.
+     * @param error The error from the previous attempt
+     * @param attempt The attempt number (0-based, so 0 = first failure)
+     */
+    shouldRetry(error: unknown, attempt: number): number | undefined;
+}
+/**
+ * Retries on transient errors (like AppendConditionError) with exponential backoff.
+ * Non-transient errors are rethrown immediately.
+ */
+export declare function exponentialBackoffRetryPolicy(options?: {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    isTransient?: (error: unknown) => boolean;
+}): RetryPolicy;
+/**
+ * A command bus decorator that retries failed dispatches based on a retry policy.
+ *
+ * When a command fails with a transient error (e.g., AppendConditionError from
+ * an optimistic concurrency conflict), the entire dispatch is retried. This means
+ * the handler re-sources state and re-makes its decision based on fresh data.
+ *
+ * Non-transient errors propagate immediately to the caller.
+ */
+export declare function createRetryingCommandBus(delegate: CommandBus, policy: RetryPolicy): CommandBus;
+//# sourceMappingURL=retrying-command-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retrying-command-bus.d.ts","sourceRoot":"","sources":["../src/retrying-command-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACjE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,CAAC,EAAE;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAC1C,GAAG,WAAW,CAYd;AASD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,WAAW,GAClB,UAAU,CAuBZ"}

package/dist/retrying-command-bus.js

@@ -0,0 +1,58 @@
+/**
+ * Retries on transient errors (like AppendConditionError) with exponential backoff.
+ * Non-transient errors are rethrown immediately.
+ */
+export function exponentialBackoffRetryPolicy(options) {
+    const maxRetries = options?.maxRetries ?? 5;
+    const initialDelayMs = options?.initialDelayMs ?? 10;
+    const isTransient = options?.isTransient ?? defaultIsTransient;
+    return {
+        shouldRetry(error, attempt) {
+            if (attempt >= maxRetries)
+                return undefined;
+            if (!isTransient(error))
+                return undefined;
+            return initialDelayMs * Math.pow(2, attempt);
+        },
+    };
+}
+function defaultIsTransient(error) {
+    if (error instanceof Error) {
+        return error.name === "AppendConditionError";
+    }
+    return false;
+}
+/**
+ * A command bus decorator that retries failed dispatches based on a retry policy.
+ *
+ * When a command fails with a transient error (e.g., AppendConditionError from
+ * an optimistic concurrency conflict), the entire dispatch is retried. This means
+ * the handler re-sources state and re-makes its decision based on fresh data.
+ *
+ * Non-transient errors propagate immediately to the caller.
+ */
+export function createRetryingCommandBus(delegate, policy) {
+    return {
+        async dispatch(message) {
+            let attempt = 0;
+            while (true) {
+                try {
+                    return await delegate.dispatch(message);
+                }
+                catch (error) {
+                    const delay = policy.shouldRetry(error, attempt);
+                    if (delay === undefined)
+                        throw error;
+                    attempt++;
+                    if (delay > 0) {
+                        await new Promise((resolve) => setTimeout(resolve, delay));
+                    }
+                }
+            }
+        },
+        subscribe(commandName, handler) {
+            delegate.subscribe(commandName, handler);
+        },
+    };
+}
+//# sourceMappingURL=retrying-command-bus.js.map