@kronos-ts/messaging 0.1.0

package/dist/subscribing-event-processor.js

@@ -0,0 +1,100 @@
+import { emptyMetadata, qualifiedNameToString } from "@kronos-ts/common";
+import { runInNewUoW } from "./unit-of-work.js";
+import { loggingErrorHandler } from "./tracking-event-processor.js";
+import { setResource } from "./processing-state.js";
+import { STATE_MANAGER_KEY } from "@kronos-ts/eventsourcing";
+import { COMMAND_BUS_KEY } from "./send.js";
+import { QUERY_BUS_KEY } from "./emit-update.js";
+/**
+ * Creates a subscribing event processor.
+ *
+ * The processor subscribes to the event source and processes events
+ * within a UnitOfWork as they arrive. Events are delivered on the
+ * publisher's call stack (synchronous with append).
+ */
+export function createSubscribingEventProcessor(options) {
+    const { name, eventSource, eventHandlers, stateManager, commandBus, queryBus, onEventDelivery, unitOfWorkRunner = runInNewUoW, errorHandler = loggingErrorHandler(name), handlerEnhancer, } = options;
+    // Build handler lookup: eventName → handler[]
+    // Plan 09-01: when a handlerEnhancer is supplied, wrap each handler at
+    // registration time symmetric to TrackingEventProcessor. Plan 11-02:
+    // handlerGroup is now the processor name (no separate group identity).
+    const handlerMap = new Map();
+    for (const reg of eventHandlers) {
+        const eventName = qualifiedNameToString(reg.descriptor.name);
+        const enhanced = handlerEnhancer
+            ? {
+                ...reg,
+                handler: handlerEnhancer.wrapHandler(reg.handler, {
+                    messageType: "event",
+                    messageName: eventName,
+                    handlerGroup: name,
+                }),
+            }
+            : reg;
+        const existing = handlerMap.get(eventName);
+        if (existing) {
+            existing.push(enhanced);
+        }
+        else {
+            handlerMap.set(eventName, [enhanced]);
+        }
+    }
+    let isRunning = false;
+    let unsubscribe = null;
+    async function handleEvents(events) {
+        if (!isRunning || events.length === 0)
+            return;
+        await unitOfWorkRunner(emptyMetadata(), async () => {
+            for (const event of events) {
+                await deliverEvent(event);
+            }
+        });
+    }
+    async function deliverEvent(event) {
+        const eventName = qualifiedNameToString(event.name);
+        const handlers = handlerMap.get(eventName);
+        if (!handlers || handlers.length === 0)
+            return;
+        // D-44 wiring: write framework components into ALS at per-event invocation entry.
+        if (stateManager !== undefined)
+            setResource(STATE_MANAGER_KEY, stateManager);
+        if (commandBus !== undefined)
+            setResource(COMMAND_BUS_KEY, commandBus);
+        if (queryBus !== undefined)
+            setResource(QUERY_BUS_KEY, queryBus);
+        // Optional per-event callback (e.g. monitoring hooks registered inside the UoW).
+        if (onEventDelivery)
+            onEventDelivery();
+        for (const reg of handlers) {
+            try {
+                await reg.handler(event.payload, event.metadata);
+            }
+            catch (err) {
+                // SubscribingEventProcessor doesn't have position tracking,
+                // so pass -1n as position indicator
+                await errorHandler.handleError(err, eventName, -1n);
+            }
+        }
+    }
+    return {
+        get name() { return name; },
+        get running() { return isRunning; },
+        start() {
+            if (isRunning)
+                return;
+            isRunning = true;
+            unsubscribe = eventSource.subscribe(handleEvents);
+        },
+        stop() {
+            isRunning = false;
+            if (unsubscribe) {
+                unsubscribe();
+                unsubscribe = null;
+            }
+        },
+        supportsReset() {
+            return false;
+        },
+    };
+}
+//# sourceMappingURL=subscribing-event-processor.js.map

package/dist/subscribing-event-processor.js.map

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

package/dist/subscription-query.d.ts

@@ -0,0 +1,63 @@
+import type { QueryMessage } from "./message.js";
+/**
+ * The result of a subscription query — initial result plus a stream
+ * of incremental updates.
+ *
+ * ```typescript
+ * const result = queryGateway.subscriptionQuery(GetCourseView, { courseId: "cs-101" })
+ * const initial = await result.initialResult
+ * console.log("Initial:", initial)
+ *
+ * for await (const update of result.updates) {
+ *   console.log("Update:", update)
+ * }
+ * ```
+ */
+export interface SubscriptionQueryResult {
+    /** The initial query result (same as a regular query dispatch). */
+    readonly initialResult: Promise<unknown>;
+    /** Stream of incremental updates. Completes when the subscription is closed or completed by the emitter. */
+    readonly updates: AsyncIterable<unknown>;
+    /** Close the subscription and release resources. */
+    close(): void;
+}
+/**
+ * Internal update handler — receives updates from emitUpdate() calls
+ * and buffers them for the AsyncIterable consumer.
+ */
+export interface UpdateHandler {
+    /** The original subscription query message (for filter matching). */
+    readonly query: QueryMessage;
+    /** Offer an update to the buffer. Returns false if buffer is full. */
+    offer(update: unknown): boolean;
+    /** Mark the subscription as complete (no more updates). */
+    complete(): void;
+    /** Mark the subscription as failed. */
+    completeExceptionally(error: Error): void;
+    /** Whether this handler is still active. */
+    readonly active: boolean;
+}
+/**
+ * Defers a task to AFTER_COMMIT if a UnitOfWork is active, otherwise runs
+ * it immediately.
+ *
+ * Ensures subscription query updates are only emitted after the
+ * transaction commits successfully.
+ *
+ * UoW presence is decided by ALS state
+ * (`processingStateStorage.getStore() !== undefined`) — same precedent as
+ * `correlationDataDispatchInterceptor` (Plan 02-03) and `getActiveTransaction`
+ * (Plan 02-04). CTX-01 / Plan 03-03: vestigial `_context` parameter removed.
+ */
+export declare function runAfterCommitOrImmediately(task: () => void): void;
+/**
+ * Creates a bounded async buffer that implements both UpdateHandler
+ * (for the producer side) and provides an AsyncIterable (for the consumer).
+ *
+ * @param query The subscription query message
+ * @param bufferSize Maximum number of buffered updates (default: 256)
+ */
+export declare function createUpdateHandler(query: QueryMessage, bufferSize?: number): UpdateHandler & {
+    iterable: AsyncIterable<unknown>;
+};
+//# sourceMappingURL=subscription-query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-query.d.ts","sourceRoot":"","sources":["../src/subscription-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAOhD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACxC,4GAA4G;IAC5G,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACxC,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,sEAAsE;IACtE,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAA;IAC/B,2DAA2D;IAC3D,QAAQ,IAAI,IAAI,CAAA;IAChB,uCAAuC;IACvC,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAalE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,UAAU,GAAE,MAAY,GACvB,aAAa,GAAG;IAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAAE,CAoFtD"}

package/dist/subscription-query.js

@@ -0,0 +1,119 @@
+import { resourceKey } from "@kronos-ts/common";
+import { processingStateStorage, computeIfAbsent, onAfterCommit, } from "./processing-state.js";
+/** Resource key for deferred update tasks in ProcessingContext. */
+const UPDATE_TASKS_KEY = resourceKey("subscriptionQueryUpdateTasks");
+/**
+ * Defers a task to AFTER_COMMIT if a UnitOfWork is active, otherwise runs
+ * it immediately.
+ *
+ * Ensures subscription query updates are only emitted after the
+ * transaction commits successfully.
+ *
+ * UoW presence is decided by ALS state
+ * (`processingStateStorage.getStore() !== undefined`) — same precedent as
+ * `correlationDataDispatchInterceptor` (Plan 02-03) and `getActiveTransaction`
+ * (Plan 02-04). CTX-01 / Plan 03-03: vestigial `_context` parameter removed.
+ */
+export function runAfterCommitOrImmediately(task) {
+    if (processingStateStorage.getStore() !== undefined) {
+        const tasks = computeIfAbsent(UPDATE_TASKS_KEY, () => {
+            const list = [];
+            onAfterCommit(() => {
+                for (const t of list)
+                    t();
+            });
+            return list;
+        });
+        tasks.push(task);
+    }
+    else {
+        task();
+    }
+}
+/**
+ * Creates a bounded async buffer that implements both UpdateHandler
+ * (for the producer side) and provides an AsyncIterable (for the consumer).
+ *
+ * @param query The subscription query message
+ * @param bufferSize Maximum number of buffered updates (default: 256)
+ */
+export function createUpdateHandler(query, bufferSize = 256) {
+    const buffer = [];
+    let completed = false;
+    let error;
+    let waiting = null;
+    function wake() {
+        if (waiting && (buffer.length > 0 || completed)) {
+            const w = waiting;
+            waiting = null;
+            if (buffer.length > 0) {
+                w.resolve({ value: buffer.shift(), done: false });
+            }
+            else {
+                w.resolve({ value: undefined, done: true });
+            }
+        }
+    }
+    const handler = {
+        query,
+        offer(update) {
+            if (completed)
+                return false;
+            if (buffer.length >= bufferSize)
+                return false;
+            buffer.push(update);
+            wake();
+            return true;
+        },
+        complete() {
+            completed = true;
+            wake();
+        },
+        completeExceptionally(err) {
+            error = err;
+            completed = true;
+            wake();
+        },
+        get active() {
+            return !completed;
+        },
+        iterable: {
+            [Symbol.asyncIterator]() {
+                return {
+                    next() {
+                        // If there's buffered data, return immediately
+                        if (buffer.length > 0) {
+                            return Promise.resolve({ value: buffer.shift(), done: false });
+                        }
+                        // If completed, signal done
+                        if (completed) {
+                            if (error)
+                                return Promise.reject(error);
+                            return Promise.resolve({ value: undefined, done: true });
+                        }
+                        // Wait for data or completion
+                        return new Promise((resolve, reject) => {
+                            waiting = {
+                                resolve(result) {
+                                    if (error && result.done) {
+                                        reject(error);
+                                    }
+                                    else {
+                                        resolve(result);
+                                    }
+                                },
+                            };
+                        });
+                    },
+                    return() {
+                        completed = true;
+                        buffer.length = 0;
+                        return Promise.resolve({ value: undefined, done: true });
+                    },
+                };
+            },
+        },
+    };
+    return handler;
+}
+//# sourceMappingURL=subscription-query.js.map

package/dist/subscription-query.js.map

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

package/dist/token-store.d.ts

@@ -0,0 +1,83 @@
+import type { TrackingToken } from "./tracking-token.js";
+/**
+ * Stores tracking tokens for event processors and manages segment claims.
+ *
+ * Each processor has a name and one or more segments. The token
+ * represents the processor's position in the event stream.
+ *
+ * Claim management enables distributed processing: multiple instances
+ * of the same processor each claim different segments, preventing
+ * double-processing.
+ *
+ * Implementations should participate in the active transaction when
+ * available (via `getActiveTransaction()`) so that token updates
+ * and projection updates are atomic.
+ */
+export interface TokenStore {
+    /**
+     * Store the token for a processor segment.
+     * Called during PREPARE_COMMIT phase (same transaction as handler work).
+     * The caller must own the claim for this segment.
+     */
+    store(processorName: string, segment: number, token: TrackingToken): Promise<void>;
+    /**
+     * Get the current token for a processor segment.
+     * Returns undefined if no token has been stored (start from beginning).
+     */
+    get(processorName: string, segment: number): Promise<TrackingToken | undefined>;
+    /**
+     * Initialize token segments for a processor if they don't exist yet.
+     * Called once during processor startup.
+     *
+     * @param processorName The processor name
+     * @param segmentCount Number of segments to initialize
+     */
+    initializeSegments(processorName: string, segmentCount: number): Promise<void>;
+    /**
+     * Claim a segment for processing. Returns the current token for
+     * that segment. Throws `UnableToClaimTokenError` if the segment
+     * is already claimed by another instance.
+     *
+     * @param processorName The processor name
+     * @param segment The segment ID to claim
+     * @param ownerId Unique identifier of this instance
+     */
+    claimToken(processorName: string, segment: number, ownerId: string): Promise<TrackingToken | undefined>;
+    /**
+     * Extend the claim lease for a segment without processing.
+     * Called periodically to prevent claim expiry during long batches.
+     */
+    extendClaim(processorName: string, segment: number, ownerId: string): Promise<void>;
+    /**
+     * Release a segment claim, allowing other instances to pick it up.
+     */
+    releaseClaim(processorName: string, segment: number, ownerId: string): Promise<void>;
+    /**
+     * Fetch all segment IDs that have tokens for a processor.
+     * Used during startup to discover available segments.
+     */
+    fetchSegments(processorName: string): Promise<number[]>;
+    /**
+     * Fetch segment IDs that are not currently claimed by any instance.
+     * Used to discover segments available for claiming.
+     */
+    fetchAvailableSegments(processorName: string): Promise<number[]>;
+    /**
+     * Delete the token for a segment (e.g., after merging).
+     */
+    deleteToken(processorName: string, segment: number): Promise<void>;
+}
+/**
+ * Thrown when a segment claim cannot be acquired (already owned by another instance).
+ */
+export declare class UnableToClaimTokenError extends Error {
+    constructor(processorName: string, segment: number);
+}
+/**
+ * In-memory token store with claim management.
+ * Tokens and claims are lost on restart.
+ *
+ * @param claimTimeoutMs How long a claim lasts before it can be stolen (default: 10000ms)
+ */
+export declare function createInMemoryTokenStore(claimTimeoutMs?: number): TokenStore;
+//# sourceMappingURL=token-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../src/token-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElF;;;OAGG;IACH,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IAE/E;;;;;;OAMG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9E;;;;;;;;OAQG;IACH,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IAEvG;;;OAGG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnF;;OAEG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpF;;;OAGG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAEvD;;;OAGG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAEhE;;OAEG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnE;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAInD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,GAAE,MAAc,GAAG,UAAU,CAmHnF"}

package/dist/token-store.js

@@ -0,0 +1,112 @@
+/**
+ * Thrown when a segment claim cannot be acquired (already owned by another instance).
+ */
+export class UnableToClaimTokenError extends Error {
+    constructor(processorName, segment) {
+        super(`Unable to claim token for processor "${processorName}" segment ${segment}: already claimed`);
+        this.name = "UnableToClaimTokenError";
+    }
+}
+/**
+ * In-memory token store with claim management.
+ * Tokens and claims are lost on restart.
+ *
+ * @param claimTimeoutMs How long a claim lasts before it can be stolen (default: 10000ms)
+ */
+export function createInMemoryTokenStore(claimTimeoutMs = 10000) {
+    const entries = new Map();
+    function key(processorName, segment) {
+        return `${processorName}:${segment}`;
+    }
+    function getEntry(processorName, segment) {
+        return entries.get(key(processorName, segment));
+    }
+    function isClaimExpired(entry) {
+        if (!entry.ownerId)
+            return true;
+        return Date.now() - entry.claimedAt > claimTimeoutMs;
+    }
+    return {
+        async store(processorName, segment, token) {
+            const k = key(processorName, segment);
+            const entry = entries.get(k);
+            if (entry) {
+                entry.token = token;
+                entry.claimedAt = Date.now(); // Refresh claim on store
+            }
+            else {
+                entries.set(k, { token, ownerId: null, claimedAt: Date.now() });
+            }
+        },
+        async get(processorName, segment) {
+            return getEntry(processorName, segment)?.token;
+        },
+        async initializeSegments(processorName, segmentCount) {
+            for (let i = 0; i < segmentCount; i++) {
+                const k = key(processorName, i);
+                if (!entries.has(k)) {
+                    entries.set(k, { token: undefined, ownerId: null, claimedAt: 0 });
+                }
+            }
+        },
+        async claimToken(processorName, segment, ownerId) {
+            const k = key(processorName, segment);
+            const entry = entries.get(k);
+            if (!entry) {
+                // Segment doesn't exist yet — create and claim
+                const newEntry = { token: undefined, ownerId, claimedAt: Date.now() };
+                entries.set(k, newEntry);
+                return undefined;
+            }
+            if (entry.ownerId === ownerId) {
+                // Already owned by this instance — refresh claim
+                entry.claimedAt = Date.now();
+                return entry.token;
+            }
+            if (isClaimExpired(entry)) {
+                // Claim expired — steal it
+                entry.ownerId = ownerId;
+                entry.claimedAt = Date.now();
+                return entry.token;
+            }
+            throw new UnableToClaimTokenError(processorName, segment);
+        },
+        async extendClaim(processorName, segment, ownerId) {
+            const entry = getEntry(processorName, segment);
+            if (entry && entry.ownerId === ownerId) {
+                entry.claimedAt = Date.now();
+            }
+        },
+        async releaseClaim(processorName, segment, ownerId) {
+            const entry = getEntry(processorName, segment);
+            if (entry && entry.ownerId === ownerId) {
+                entry.ownerId = null;
+                entry.claimedAt = 0;
+            }
+        },
+        async fetchSegments(processorName) {
+            const segments = [];
+            const prefix = `${processorName}:`;
+            for (const k of entries.keys()) {
+                if (k.startsWith(prefix)) {
+                    segments.push(parseInt(k.slice(prefix.length), 10));
+                }
+            }
+            return segments.sort((a, b) => a - b);
+        },
+        async fetchAvailableSegments(processorName) {
+            const segments = [];
+            const prefix = `${processorName}:`;
+            for (const [k, entry] of entries) {
+                if (k.startsWith(prefix) && (!entry.ownerId || isClaimExpired(entry))) {
+                    segments.push(parseInt(k.slice(prefix.length), 10));
+                }
+            }
+            return segments.sort((a, b) => a - b);
+        },
+        async deleteToken(processorName, segment) {
+            entries.delete(key(processorName, segment));
+        },
+    };
+}
+//# sourceMappingURL=token-store.js.map

package/dist/token-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.js","sourceRoot":"","sources":["../src/token-store.ts"],"names":[],"mappings":"AA+EA;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,aAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,wCAAwC,aAAa,aAAa,OAAO,mBAAmB,CAAC,CAAA;QACnG,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,iBAAyB,KAAK;IAOrE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAA;IAE7C,SAAS,GAAG,CAAC,aAAqB,EAAE,OAAe;QACjD,OAAO,GAAG,aAAa,IAAI,OAAO,EAAE,CAAA;IACtC,CAAC;IAED,SAAS,QAAQ,CAAC,aAAqB,EAAE,OAAe;QACtD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,SAAS,cAAc,CAAC,KAAiB;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,cAAc,CAAA;IACtD,CAAC;IAED,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK;YACvC,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC5B,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;gBACnB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA,CAAC,yBAAyB;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO;YAC9B,OAAO,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,KAAK,CAAA;QAChD,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,aAAa,EAAE,YAAY;YAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAA;gBAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAA;gBACnE,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO;YAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAE5B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,+CAA+C;gBAC/C,MAAM,QAAQ,GAAe,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;gBACjF,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACxB,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC9B,iDAAiD;gBACjD,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,OAAO,KAAK,CAAC,KAAK,CAAA;YACpB,CAAC;YAED,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,2BAA2B;gBAC3B,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;gBACvB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,OAAO,KAAK,CAAC,KAAK,CAAA;YACpB,CAAC;YAED,MAAM,IAAI,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QAC3D,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO;YAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;YAC9C,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACvC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO;YAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;YAC9C,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACvC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;gBACpB,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,aAAa;YAC/B,MAAM,QAAQ,GAAa,EAAE,CAAA;YAC7B,MAAM,MAAM,GAAG,GAAG,aAAa,GAAG,CAAA;YAClC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/B,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;gBACrD,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,sBAAsB,CAAC,aAAa;YACxC,MAAM,QAAQ,GAAa,EAAE,CAAA;YAC7B,MAAM,MAAM,GAAG,GAAG,aAAa,GAAG,CAAA;YAClC,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;oBACtE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;gBACrD,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO;YACtC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;QAC7C,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { CommandBus } from "./command-bus.js";
+import type { SpanFactory } from "./span-factory.js";
+/**
+ * A {@link CommandBus} decorator that wraps dispatch and handler invocations
+ * with tracing spans.
+ *
+ * Dispatch creates a "dispatch" span and propagates trace context into the
+ * message metadata. Subscribe wraps each handler with a "handle" span.
+ *
+ *
+ * @param delegate  The underlying command bus to decorate.
+ * @param spanFactory  The span factory for creating tracing spans.
+ * @returns A decorated command bus with tracing instrumentation.
+ */
+export declare function createTracingCommandBus(delegate: CommandBus, spanFactory: SpanFactory): CommandBus;
+//# sourceMappingURL=tracing-command-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-command-bus.d.ts","sourceRoot":"","sources":["../src/tracing-command-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,UAAU,EACpB,WAAW,EAAE,WAAW,GACvB,UAAU,CAgCZ"}

package/dist/tracing-command-bus.js

@@ -0,0 +1,44 @@
+/**
+ * A {@link CommandBus} decorator that wraps dispatch and handler invocations
+ * with tracing spans.
+ *
+ * Dispatch creates a "dispatch" span and propagates trace context into the
+ * message metadata. Subscribe wraps each handler with a "handle" span.
+ *
+ *
+ * @param delegate  The underlying command bus to decorate.
+ * @param spanFactory  The span factory for creating tracing spans.
+ * @returns A decorated command bus with tracing instrumentation.
+ */
+export function createTracingCommandBus(delegate, spanFactory) {
+    return {
+        async dispatch(message) {
+            const span = spanFactory.createDispatchSpan(`dispatch(${String(message.name)})`, message).start();
+            try {
+                const propagated = spanFactory.propagateContext(message);
+                const result = await delegate.dispatch(propagated);
+                span.end();
+                return result;
+            }
+            catch (err) {
+                span.recordException(err instanceof Error ? err : new Error(String(err)));
+                throw err;
+            }
+        },
+        subscribe(commandName, handler) {
+            delegate.subscribe(commandName, async (msg) => {
+                const span = spanFactory.createHandlerSpan(`handle(${commandName})`, msg).start();
+                try {
+                    const result = await handler(msg);
+                    span.end();
+                    return result;
+                }
+                catch (err) {
+                    span.recordException(err instanceof Error ? err : new Error(String(err)));
+                    throw err;
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=tracing-command-bus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-command-bus.js","sourceRoot":"","sources":["../src/tracing-command-bus.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAoB,EACpB,WAAwB;IAExB,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,OAAuB;YACpC,MAAM,IAAI,GAAG,WAAW,CAAC,kBAAkB,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,CAAA;YACjG,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBACxD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;gBAClD,IAAI,CAAC,GAAG,EAAE,CAAA;gBACV,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBACzE,MAAM,GAAG,CAAA;YACX,CAAC;QACH,CAAC;QAED,SAAS,CACP,WAAmB,EACnB,OAAsD;YAEtD,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;gBAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,iBAAiB,CAAC,UAAU,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAA;gBACjF,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;oBACjC,IAAI,CAAC,GAAG,EAAE,CAAA;oBACV,OAAO,MAAM,CAAA;gBACf,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;oBACzE,MAAM,GAAG,CAAA;gBACX,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { HandlerEnhancerDefinition } from "./handler-enhancer.js";
+import type { SpanFactory } from "./span-factory.js";
+/**
+ * Handler enhancer that wraps message handler invocations with tracing spans.
+ *
+ * Creates an internal span per handler invocation, recording the handler
+ * name and message type as context. Errors are recorded on the span.
+ *
+ */
+export declare function tracingHandlerEnhancerDefinition(spanFactory: SpanFactory): HandlerEnhancerDefinition;
+//# sourceMappingURL=tracing-handler-enhancer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-handler-enhancer.d.ts","sourceRoot":"","sources":["../src/tracing-handler-enhancer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAmB,MAAM,uBAAuB,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,WAAW,GACvB,yBAAyB,CAqB3B"}

package/dist/tracing-handler-enhancer.js

@@ -0,0 +1,27 @@
+/**
+ * Handler enhancer that wraps message handler invocations with tracing spans.
+ *
+ * Creates an internal span per handler invocation, recording the handler
+ * name and message type as context. Errors are recorded on the span.
+ *
+ */
+export function tracingHandlerEnhancerDefinition(spanFactory) {
+    return {
+        wrapHandler(handler, metadata) {
+            const spanName = `${metadata.handlerGroup}.${metadata.messageName}`;
+            return (async (...args) => {
+                const span = spanFactory.createInternalSpan(spanName).start();
+                try {
+                    const result = await handler(...args);
+                    span.end();
+                    return result;
+                }
+                catch (error) {
+                    span.recordException(error instanceof Error ? error : new Error(String(error)));
+                    throw error;
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=tracing-handler-enhancer.js.map

package/dist/tracing-handler-enhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-handler-enhancer.js","sourceRoot":"","sources":["../src/tracing-handler-enhancer.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,WAAwB;IAExB,OAAO;QACL,WAAW,CACT,OAAU,EACV,QAAyB;YAEzB,MAAM,QAAQ,GAAG,GAAG,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAA;YAEnE,OAAO,CAAC,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;gBAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAA;gBAC7D,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;oBACrC,IAAI,CAAC,GAAG,EAAE,CAAA;oBACV,OAAO,MAAM,CAAA;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,eAAe,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;oBAC/E,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CAAiB,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC"}