@kronos-ts/messaging 0.1.0

package/dist/simple-query-bus.js

@@ -0,0 +1,122 @@
+import { createUpdateHandler, runAfterCommitOrImmediately } from "./subscription-query.js";
+import { runInUoW } from "./unit-of-work.js";
+import { qualifiedNameToString } from "@kronos-ts/common";
+/**
+ * Simple in-process query bus with subscription query support.
+ *
+ * Direct queries are dispatched within a UnitOfWork via `runInUoW`.
+ * Subscription queries receive an initial result plus a stream of
+ * incremental updates emitted via `emitUpdate()`.
+ *
+ * Plan 03-04 (CTX-04 / D-34): the explicit `unitOfWorkFactory`
+ * parameter and branch are gone. `runInUoW` is the only codepath.
+ *
+ * Interceptor support is provided by wrapping with
+ * {@link createInterceptingQueryBus}.
+ */
+export function createSimpleQueryBus() {
+    const handlers = new Map();
+    // Active subscription query handlers, keyed by query identifier
+    const subscriptions = new Map();
+    const bus = {
+        async query(message) {
+            const key = qualifiedNameToString(message.name);
+            const handler = handlers.get(key);
+            if (!handler) {
+                throw new Error(`No handler registered for query "${key}"`);
+            }
+            // Plan 03-01 (D-32) / Plan 03-04 (CTX-04): mirrors
+            // simple-command-bus.dispatch. ALS-aware nesting; primary dispatch
+            // creates a new UoW.
+            return runInUoW(message.metadata, () => handler(message));
+        },
+        subscribe(queryName, handler) {
+            const existing = handlers.get(queryName);
+            if (existing && existing !== handler) {
+                throw new Error(`A different handler is already registered for query "${queryName}". ` +
+                    `Duplicate query handler subscriptions are not allowed.`);
+            }
+            handlers.set(queryName, handler);
+        },
+        subscriptionQuery(message, bufferSize) {
+            const queryId = message.identifier;
+            if (subscriptions.has(queryId)) {
+                throw new Error(`Subscription query already registered for identifier "${queryId}"`);
+            }
+            const updateHandler = createUpdateHandler(message, bufferSize);
+            subscriptions.set(queryId, updateHandler);
+            const initialResult = bus.query(message);
+            return {
+                initialResult,
+                updates: updateHandler.iterable,
+                close: () => {
+                    subscriptions.delete(queryId);
+                    updateHandler.complete();
+                },
+            };
+        },
+        subscribeToUpdates(message, bufferSize) {
+            const queryId = message.identifier;
+            if (subscriptions.has(queryId)) {
+                throw new Error(`Subscription query already registered for identifier "${queryId}"`);
+            }
+            const updateHandler = createUpdateHandler(message, bufferSize);
+            subscriptions.set(queryId, updateHandler);
+            return {
+                [Symbol.asyncIterator]: () => updateHandler.iterable[Symbol.asyncIterator](),
+                close: () => {
+                    subscriptions.delete(queryId);
+                    updateHandler.complete();
+                },
+            };
+        },
+        async emitUpdate(queryName, filter, update) {
+            runAfterCommitOrImmediately(() => {
+                for (const [id, handler] of subscriptions) {
+                    if (!handler.active) {
+                        subscriptions.delete(id);
+                        continue;
+                    }
+                    const handlerQueryName = qualifiedNameToString(handler.query.name);
+                    if (handlerQueryName !== queryName)
+                        continue;
+                    if (!filter(handler.query.payload))
+                        continue;
+                    const accepted = handler.offer(update);
+                    if (!accepted) {
+                        handler.completeExceptionally(new Error("Subscription query update buffer overflow"));
+                        subscriptions.delete(id);
+                    }
+                }
+            });
+        },
+        async completeSubscription(queryName, filter) {
+            runAfterCommitOrImmediately(() => {
+                for (const [id, handler] of subscriptions) {
+                    const handlerQueryName = qualifiedNameToString(handler.query.name);
+                    if (handlerQueryName !== queryName)
+                        continue;
+                    if (filter && !filter(handler.query.payload))
+                        continue;
+                    handler.complete();
+                    subscriptions.delete(id);
+                }
+            });
+        },
+        async completeSubscriptionExceptionally(queryName, error, filter) {
+            runAfterCommitOrImmediately(() => {
+                for (const [id, handler] of subscriptions) {
+                    const handlerQueryName = qualifiedNameToString(handler.query.name);
+                    if (handlerQueryName !== queryName)
+                        continue;
+                    if (filter && !filter(handler.query.payload))
+                        continue;
+                    handler.completeExceptionally(error);
+                    subscriptions.delete(id);
+                }
+            });
+        },
+    };
+    return bus;
+}
+//# sourceMappingURL=simple-query-bus.js.map

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

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

package/dist/span-factory.d.ts

@@ -0,0 +1,58 @@
+import type { Message } from "./message.js";
+/**
+ * A span representing a unit of tracing work.
+ * Start the span, do work, then end it.
+ *
+ */
+export interface Span {
+    /** Start the span. Returns the span for chaining. */
+    start(): Span;
+    /** End the span normally. */
+    end(): void;
+    /** Record an error on the span and end it. */
+    recordException(error: Error): void;
+}
+/**
+ * Provides custom attributes to add to spans.
+ *
+ */
+export interface SpanAttributesProvider {
+    provideAttributes(message: Message): Record<string, string>;
+}
+/**
+ * Factory for creating tracing spans around message processing.
+ *
+ * The SpanFactory is the core tracing abstraction. Implementations
+ * (e.g., OpenTelemetry) provide the actual span creation and context
+ * propagation. The framework calls these methods during dispatch and
+ * handling.
+ *
+ */
+export interface SpanFactory {
+    /** Create a root trace span (no parent). */
+    createRootTrace(operationName: string): Span;
+    /**
+     * Create a span for handling a message (consumer side).
+     * Extracts trace context from the parent message's metadata.
+     */
+    createHandlerSpan(operationName: string, parentMessage: Message): Span;
+    /**
+     * Create a span for dispatching a message (producer side).
+     * Links to the parent message's trace context.
+     */
+    createDispatchSpan(operationName: string, parentMessage: Message): Span;
+    /** Create a span for internal framework operations. */
+    createInternalSpan(operationName: string): Span;
+    /**
+     * Inject trace context into a message's metadata so it propagates
+     * across message boundaries.
+     */
+    propagateContext<M extends Message>(message: M): M;
+    /** Register a custom span attribute provider. */
+    registerSpanAttributeProvider(provider: SpanAttributesProvider): void;
+}
+/**
+ * A no-op span factory. Default when no tracing is configured.
+ */
+export declare function noOpSpanFactory(): SpanFactory;
+//# sourceMappingURL=span-factory.d.ts.map

package/dist/span-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-factory.d.ts","sourceRoot":"","sources":["../src/span-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAA;IACb,6BAA6B;IAC7B,GAAG,IAAI,IAAI,CAAA;IACX,8CAA8C;IAC9C,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5C;;;OAGG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAEtE;;;OAGG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAEvE,uDAAuD;IACvD,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAE/C;;;OAGG;IACH,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;IAElD,iDAAiD;IACjD,6BAA6B,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;CACtE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAe7C"}

package/dist/span-factory.js

@@ -0,0 +1,19 @@
+/**
+ * A no-op span factory. Default when no tracing is configured.
+ */
+export function noOpSpanFactory() {
+    const noOpSpan = {
+        start() { return this; },
+        end() { },
+        recordException() { },
+    };
+    return {
+        createRootTrace() { return noOpSpan; },
+        createHandlerSpan() { return noOpSpan; },
+        createDispatchSpan() { return noOpSpan; },
+        createInternalSpan() { return noOpSpan; },
+        propagateContext(message) { return message; },
+        registerSpanAttributeProvider() { },
+    };
+}
+//# sourceMappingURL=span-factory.js.map

package/dist/span-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-factory.js","sourceRoot":"","sources":["../src/span-factory.ts"],"names":[],"mappings":"AA8DA;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAS;QACrB,KAAK,KAAK,OAAO,IAAI,CAAA,CAAC,CAAC;QACvB,GAAG,KAAI,CAAC;QACR,eAAe,KAAI,CAAC;KACrB,CAAA;IAED,OAAO;QACL,eAAe,KAAK,OAAO,QAAQ,CAAA,CAAC,CAAC;QACrC,iBAAiB,KAAK,OAAO,QAAQ,CAAA,CAAC,CAAC;QACvC,kBAAkB,KAAK,OAAO,QAAQ,CAAA,CAAC,CAAC;QACxC,kBAAkB,KAAK,OAAO,QAAQ,CAAA,CAAC,CAAC;QACxC,gBAAgB,CAAoB,OAAU,IAAI,OAAO,OAAO,CAAA,CAAC,CAAC;QAClE,6BAA6B,KAAI,CAAC;KACnC,CAAA;AACH,CAAC"}

package/dist/streaming-event-processor.d.ts

@@ -0,0 +1,65 @@
+import type { EventHandlerDefinition } from "./event-handler.js";
+import type { StreamableEventSource } from "./event-source.js";
+import type { UoWRunner } from "./unit-of-work.js";
+import type { TokenStore } from "./token-store.js";
+import type { EventProcessingErrorHandler } from "./tracking-event-processor.js";
+import type { HandlerEnhancerDefinition } from "./handler-enhancer.js";
+import type { CommandBus } from "./command-bus.js";
+import type { QueryBus } from "./query-bus.js";
+/**
+ * A streaming event processor that uses push-based event delivery
+ * via {@link MessageStream}.
+ *
+ * Architecture:
+ * - Opens a MessageStream from the event source via {@link StreamableEventSource.open}
+ * - When events become available (via setCallback), pulls them
+ * - Processes batches within a UnitOfWork
+ * - Stores token at PREPARE_COMMIT (same transaction as handler work)
+ *
+ */
+export interface EventProcessorStatus {
+    readonly segmentId: number;
+    readonly position: bigint;
+    readonly replaying: boolean;
+    readonly caughtUp: boolean;
+    readonly error?: Error;
+}
+export interface StreamingEventProcessor {
+    readonly name: string;
+    readonly running: boolean;
+    readonly position: bigint;
+    readonly replaying: boolean;
+    /** Status per segment. */
+    processingStatus(): Map<number, EventProcessorStatus>;
+    /** Whether this processor supports reset (always true if not running). */
+    supportsReset(): boolean;
+    start(): Promise<void>;
+    stop(): void;
+    resetTokens(startPosition?: bigint, resetContext?: unknown): Promise<void>;
+    splitSegment(segmentId: number): Promise<boolean>;
+    mergeSegment(segmentId: number): Promise<boolean>;
+    releaseSegment(segmentId: number): Promise<void>;
+}
+export interface StreamingEventProcessorOptions {
+    name: string;
+    eventSource: StreamableEventSource;
+    eventHandlers: ReadonlyArray<EventHandlerDefinition>;
+    /** State manager injected into ALS at handler-invocation entry (D-44). */
+    stateManager?: unknown;
+    /** Command bus injected into ALS at handler-invocation entry (D-44). */
+    commandBus?: CommandBus;
+    /** Query bus injected into ALS at handler-invocation entry (D-44). */
+    queryBus?: QueryBus;
+    /** Optional per-event callback fired inside the UoW before handler invocation (e.g. monitoring). */
+    onEventDelivery?: () => void;
+    unitOfWorkRunner?: UoWRunner;
+    tokenStore?: TokenStore;
+    batchSize?: number;
+    errorHandler?: EventProcessingErrorHandler;
+    /** Optional handler enhancer applied to all event handlers at setup time. */
+    handlerEnhancer?: HandlerEnhancerDefinition;
+    /** Reset callback invoked from resetTokens(). */
+    onReset?: () => Promise<void> | void;
+}
+export declare function createStreamingEventProcessor(options: StreamingEventProcessorOptions): StreamingEventProcessor;
+//# sourceMappingURL=streaming-event-processor.d.ts.map

package/dist/streaming-event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-event-processor.d.ts","sourceRoot":"","sources":["../src/streaming-event-processor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAiC,MAAM,mBAAmB,CAAA;AAC7F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAEhF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAWtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAK9C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0BAA0B;IAC1B,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACrD,0EAA0E;IAC1E,aAAa,IAAI,OAAO,CAAA;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,IAAI,IAAI,CAAA;IACZ,WAAW,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,qBAAqB,CAAA;IAClC,aAAa,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;IACpD,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,2BAA2B,CAAA;IAC1C,6EAA6E;IAC7E,eAAe,CAAC,EAAE,yBAAyB,CAAA;IAC3C,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACrC;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAwQzB"}

package/dist/streaming-event-processor.js

@@ -0,0 +1,239 @@
+import { emptyMetadata, qualifiedNameToString } from "@kronos-ts/common";
+import { runInNewUoW } from "./unit-of-work.js";
+import { loggingErrorHandler } from "./tracking-event-processor.js";
+import { globalSequenceToken, replayToken, isReplayToken, isReplaying, advanceToken, } from "./tracking-token.js";
+import { REPLAY_STATE_KEY } from "./replay-token.js";
+import { setResource, onPrepareCommit } 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";
+export function createStreamingEventProcessor(options) {
+    const { name, eventSource, eventHandlers, stateManager, commandBus, queryBus, onEventDelivery, unitOfWorkRunner = runInNewUoW, tokenStore, batchSize = 100, errorHandler = loggingErrorHandler(name), handlerEnhancer, onReset, } = options;
+    const segment = 0;
+    const handlerMap = new Map();
+    for (const reg of eventHandlers) {
+        const eventName = qualifiedNameToString(reg.descriptor.name);
+        if (!handlerMap.has(eventName)) {
+            handlerMap.set(eventName, []);
+        }
+        const enhanced = handlerEnhancer
+            ? {
+                ...reg,
+                handler: handlerEnhancer.wrapHandler(reg.handler, {
+                    messageType: "event",
+                    messageName: eventName,
+                    handlerGroup: name,
+                }),
+            }
+            : reg;
+        handlerMap.get(eventName).push(enhanced);
+    }
+    let token = globalSequenceToken(0n);
+    let isRunning = false;
+    let stream = null;
+    let processTimer = null;
+    let processing = false;
+    let caughtUp = false;
+    let lastError;
+    async function initialize() {
+        if (tokenStore) {
+            await tokenStore.initializeSegments(name, 1);
+            const stored = await tokenStore.get(name, segment);
+            if (stored !== undefined) {
+                token = stored;
+            }
+        }
+    }
+    function openStream() {
+        stream = eventSource.open({ position: token.position() });
+        stream.setCallback(() => {
+            if (isRunning && !processing) {
+                scheduleImmediate();
+            }
+        });
+    }
+    async function processAvailable() {
+        if (!isRunning || processing)
+            return;
+        processing = true;
+        try {
+            await processFromStream();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            console.error(`Event processor "${name}" error:`, err);
+        }
+        finally {
+            processing = false;
+        }
+        if (isRunning && stream) {
+            if (stream.hasNextAvailable()) {
+                scheduleImmediate();
+            }
+        }
+    }
+    async function processFromStream() {
+        if (!stream)
+            return;
+        // Check for stream errors — reopen if needed
+        const streamError = stream.error();
+        if (streamError) {
+            console.error(`Event processor "${name}": stream error, reopening:`, streamError);
+            stream.close();
+            stream = null;
+            openStream();
+            return;
+        }
+        const batch = [];
+        let event = stream.next();
+        while (event && batch.length < batchSize) {
+            batch.push(event);
+            if (batch.length < batchSize && stream.hasNextAvailable()) {
+                event = stream.next();
+            }
+            else {
+                break;
+            }
+        }
+        if (batch.length > 0) {
+            caughtUp = false;
+            await processBatch(batch);
+            if (stream.hasNextAvailable()) {
+                scheduleImmediate();
+            }
+        }
+        else {
+            caughtUp = true;
+            if (isReplayToken(token)) {
+                token = globalSequenceToken(token.position());
+                if (tokenStore) {
+                    await tokenStore.store(name, segment, token);
+                }
+            }
+        }
+    }
+    async function processBatch(batch) {
+        let batchEndToken = token;
+        await unitOfWorkRunner(emptyMetadata(), async () => {
+            for (const sequencedEvent of batch) {
+                setResource(REPLAY_STATE_KEY, { replaying: isReplaying(batchEndToken) });
+                await deliverEvent(sequencedEvent);
+                batchEndToken = advanceToken(batchEndToken, sequencedEvent.sequence + 1n);
+            }
+            if (tokenStore) {
+                onPrepareCommit(async () => {
+                    await tokenStore.store(name, segment, batchEndToken);
+                    // Extend claim to prevent expiry during long batches
+                    await tokenStore.extendClaim(name, segment, name);
+                });
+            }
+        });
+        token = batchEndToken;
+    }
+    async function deliverEvent(sequencedEvent) {
+        const event = sequencedEvent.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) {
+                await errorHandler.handleError(err, eventName, sequencedEvent.sequence);
+            }
+        }
+    }
+    function scheduleImmediate() {
+        if (processTimer !== null) {
+            clearTimeout(processTimer);
+        }
+        processTimer = setTimeout(processAvailable, 0);
+    }
+    return {
+        get name() { return name; },
+        get running() { return isRunning; },
+        get position() { return token.position(); },
+        get replaying() { return isReplaying(token); },
+        processingStatus() {
+            const status = new Map();
+            status.set(segment, {
+                segmentId: segment,
+                position: token.position(),
+                replaying: isReplaying(token),
+                caughtUp,
+                error: lastError,
+            });
+            return status;
+        },
+        async start() {
+            if (isRunning)
+                return;
+            await initialize();
+            isRunning = true;
+            openStream();
+            scheduleImmediate();
+        },
+        stop() {
+            isRunning = false;
+            if (processTimer !== null) {
+                clearTimeout(processTimer);
+                processTimer = null;
+            }
+            if (stream) {
+                stream.close();
+                stream = null;
+            }
+        },
+        async resetTokens(startPosition = 0n, resetContext) {
+            if (isRunning) {
+                throw new Error(`Processor "${name}" must be stopped before resetting tokens`);
+            }
+            const headPosition = await eventSource.getHeadPosition();
+            if (headPosition <= startPosition) {
+                token = globalSequenceToken(startPosition);
+            }
+            else {
+                token = replayToken(globalSequenceToken(headPosition), globalSequenceToken(startPosition), resetContext);
+            }
+            if (tokenStore) {
+                await tokenStore.store(name, segment, token);
+            }
+            if (onReset) {
+                await onReset();
+            }
+        },
+        async splitSegment(_segmentId) {
+            if (!tokenStore)
+                return false;
+            console.warn(`Processor "${name}": segment splitting requires multi-segment support (not yet implemented)`);
+            return false;
+        },
+        async mergeSegment(_segmentId) {
+            if (!tokenStore)
+                return false;
+            console.warn(`Processor "${name}": segment merging requires multi-segment support (not yet implemented)`);
+            return false;
+        },
+        async releaseSegment(_segmentId) {
+            if (!tokenStore)
+                return;
+            await tokenStore.releaseClaim(name, segment, name);
+        },
+        supportsReset() {
+            return !isRunning;
+        },
+    };
+}
+//# sourceMappingURL=streaming-event-processor.js.map

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

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

package/dist/subscribing-event-processor.d.ts

@@ -0,0 +1,57 @@
+import type { EventHandlerDefinition } from "./event-handler.js";
+import type { UoWRunner } from "./unit-of-work.js";
+import type { EventProcessingErrorHandler } from "./tracking-event-processor.js";
+import type { SubscribableEventSource } from "./event-bus.js";
+import type { CommandBus } from "./command-bus.js";
+import type { QueryBus } from "./query-bus.js";
+import type { HandlerEnhancerDefinition } from "./handler-enhancer.js";
+export type { SubscribableEventSource } from "./event-bus.js";
+/**
+ * A push-based event processor that subscribes directly to an event source.
+ *
+ * Unlike tracking/streaming processors, the subscribing processor:
+ * - Does **not** use a token store (no position tracking)
+ * - Does **not** support replay or reset
+ * - Processes events synchronously with the publisher
+ * - Is suitable for in-memory projections that don't need persistence
+ *
+ */
+export interface SubscribingEventProcessor {
+    readonly name: string;
+    readonly running: boolean;
+    start(): void;
+    stop(): void;
+    /** Always returns false — subscribing processors don't support reset. */
+    supportsReset(): boolean;
+}
+export interface SubscribingEventProcessorOptions {
+    name: string;
+    eventSource: SubscribableEventSource;
+    eventHandlers: ReadonlyArray<EventHandlerDefinition>;
+    /** State manager injected into ALS at handler-invocation entry (D-44). */
+    stateManager?: unknown;
+    /** Command bus injected into ALS at handler-invocation entry (D-44). */
+    commandBus?: CommandBus;
+    /** Query bus injected into ALS at handler-invocation entry (D-44). */
+    queryBus?: QueryBus;
+    /** Optional per-event callback fired inside the UoW before handler invocation (e.g. monitoring). */
+    onEventDelivery?: () => void;
+    unitOfWorkRunner?: UoWRunner;
+    errorHandler?: EventProcessingErrorHandler;
+    /**
+     * Plan 09-01: optional handler enhancer applied to each event handler at
+     * registration time. Symmetric to TrackingEventProcessor.handlerEnhancer.
+     * When set, each registered handler is wrapped via wrapHandler with
+     * messageType "event" and the group name as handlerGroup.
+     */
+    handlerEnhancer?: HandlerEnhancerDefinition;
+}
+/**
+ * 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 declare function createSubscribingEventProcessor(options: SubscribingEventProcessorOptions): SubscribingEventProcessor;
+//# sourceMappingURL=subscribing-event-processor.d.ts.map

package/dist/subscribing-event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribing-event-processor.d.ts","sourceRoot":"","sources":["../src/subscribing-event-processor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAEhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAOtE,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAE7D;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,yEAAyE;IACzE,aAAa,IAAI,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,uBAAuB,CAAA;IACpC,aAAa,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;IACpD,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAC5B,YAAY,CAAC,EAAE,2BAA2B,CAAA;IAC1C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,yBAAyB,CAAA;CAC5C;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAiG3B"}