@event-driven-io/emmett 0.23.0-alpha.5 → 0.23.0-alpha.7

package/dist/index.d.cts

@@ -211,6 +211,79 @@ type AppendToStreamResultWithGlobalPosition<StreamVersion = BigIntStreamPosition
     lastEventGlobalPosition: GlobalPosition;
 };
 type AppendStreamResultOfEventStore<Store extends EventStore> = Store['appendToStream'] extends (...args: any[]) => Promise<infer R> ? R : never;
+type DefaultEventStoreOptions<Store extends EventStore, HandlerContext = never> = {
+    /**
+     * Pluggable set of hooks informing about the event store internal behaviour.
+     */
+    hooks?: {
+        /**
+         * This hook will be called **AFTER** events were stored in the event store.
+         * It's designed to handle scenarios where delivery and ordering guarantees do not matter much.
+         *
+         * **WARNINGS:**
+         *
+         *  1. It will be called **EXACTLY ONCE** if append succeded.
+         *  2. If the hook fails, its append **will still silently succeed**, and no error will be thrown.
+         *  3. Wen process crashes after events were committed, but before the hook was called, delivery won't be retried.
+         * That can lead to state inconsistencies.
+         *  4. In the case of high concurrent traffic, **race conditions may cause ordering issues**.
+         * For instance, where the second hook takes longer to process than the first one, ordering won't be guaranteed.
+         *
+         * @type {AfterEventStoreCommitHandler<Store, HandlerContext>}
+         */
+        onAfterCommit?: AfterEventStoreCommitHandler<Store, HandlerContext>;
+    };
+};
+
+type AfterEventStoreCommitHandlerWithoutContext<Store extends EventStore> = (messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[]) => Promise<void> | void;
+type AfterEventStoreCommitHandler<Store extends EventStore, HandlerContext = never> = [HandlerContext] extends [never] ? AfterEventStoreCommitHandlerWithoutContext<Store> : (messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[], context: HandlerContext) => Promise<void> | void;
+type TryPublishMessagesAfterCommitOptions<Store extends EventStore, HandlerContext = never> = {
+    onAfterCommit?: AfterEventStoreCommitHandler<Store, HandlerContext>;
+};
+declare function tryPublishMessagesAfterCommit<Store extends EventStore>(messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[], options: TryPublishMessagesAfterCommitOptions<Store, undefined> | undefined): Promise<boolean>;
+declare function tryPublishMessagesAfterCommit<Store extends EventStore, HandlerContext>(messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[], options: TryPublishMessagesAfterCommitOptions<Store, HandlerContext> | undefined, context: HandlerContext): Promise<boolean>;
+
+interface CommandSender {
+    send<CommandType extends Command = Command>(command: CommandType): Promise<void>;
+}
+interface EventsPublisher {
+    publish<EventType extends Event = Event>(event: EventType): Promise<void>;
+}
+type ScheduleOptions = {
+    afterInMs: number;
+} | {
+    at: Date;
+};
+interface MessageScheduler<CommandOrEvent extends Command | Event> {
+    schedule<MessageType extends CommandOrEvent>(message: MessageType, when?: ScheduleOptions): void;
+}
+interface CommandBus extends CommandSender, MessageScheduler<Command> {
+}
+interface EventBus extends EventsPublisher, MessageScheduler<Event> {
+}
+interface MessageBus extends CommandBus, EventBus {
+    schedule<MessageType extends Command | Event>(message: MessageType, when?: ScheduleOptions): void;
+}
+type CommandHandler$1<CommandType extends Command = Command> = (command: CommandType) => Promise<void> | void;
+interface CommandProcessor {
+    handle<CommandType extends Command>(commandHandler: CommandHandler$1<CommandType>, ...commandTypes: CommandTypeOf<CommandType>[]): void;
+}
+type EventHandler<EventType extends Event = Event> = (event: EventType) => Promise<void> | void;
+interface EventProcessor {
+    subscribe<EventType extends Event>(eventHandler: EventHandler<EventType>, ...eventTypes: EventTypeOf<EventType>[]): void;
+}
+type ScheduledMessage = {
+    message: Event | Command;
+    options?: ScheduleOptions;
+};
+interface ScheduledMessageProcessor {
+    dequeue(): ScheduledMessage[];
+}
+type MessageHandler = CommandHandler$1 | EventHandler;
+type MessageProcessor = EventProcessor | CommandProcessor;
+declare const getInMemoryMessageBus: () => MessageBus & EventProcessor & CommandProcessor & ScheduledMessageProcessor;
+
+declare const forwardToMessageBus: <Store extends EventStore, HandlerContext = never>(eventPublisher: EventsPublisher) => AfterEventStoreCommitHandler<Store, HandlerContext>;
 
 declare const GlobalStreamCaughtUpType = "__emt:GlobalStreamCaughtUp";
 type GlobalStreamCaughtUp = Event<'__emt:GlobalStreamCaughtUp', {
@@ -225,10 +298,11 @@ declare const isSubscriptionEvent: (event: Event) => event is GlobalSubscription
 declare const isNotInternalEvent: (event: Event) => boolean;
 type GlobalSubscriptionEvent = GlobalStreamCaughtUp;
 
-type EventHandler$1<E extends Event = Event> = (eventEnvelope: ReadEvent<E>) => void;
 declare const InMemoryEventStoreDefaultStreamVersion = 0n;
 type InMemoryEventStore = EventStore<ReadEventMetadataWithGlobalPosition>;
-declare const getInMemoryEventStore: () => InMemoryEventStore;
+type InMemoryEventStoreOptions = DefaultEventStoreOptions<InMemoryEventStore>;
+type InMemoryReadEvent<EventType extends Event = Event> = ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>;
+declare const getInMemoryEventStore: (eventStoreOptions?: InMemoryEventStoreOptions) => InMemoryEventStore;
 
 declare const streamTrackingGlobalPosition: (currentEvents: ReadEvent<Event, ReadEventMetadataWithGlobalPosition>[]) => CaughtUpTransformStream;
 declare class CaughtUpTransformStream extends TransformStream<ReadEvent<Event, ReadEventMetadataWithGlobalPosition>, ReadEvent<Event, ReadEventMetadataWithGlobalPosition> | GlobalSubscriptionEvent> {
@@ -243,6 +317,15 @@ declare const StreamingCoordinator: () => {
     stream: () => web_streams_polyfill.ReadableStream<GlobalStreamCaughtUp | ReadEvent<Event, ReadEventMetadataWithGlobalPosition>>;
 };
 
+type Closeable = {
+    /**
+     * Gracefully cleans up managed resources
+     *
+     * @memberof Closeable
+     */
+    close: () => Promise<void>;
+};
+
 declare const deepEquals: <T>(left: T, right: T) => boolean;
 type Equatable<T> = {
     equals: (right: T) => boolean;
@@ -251,6 +334,23 @@ declare const isEquatable: <T>(left: T) => left is Equatable<T>;
 
 declare const sum: (iterator: Iterator<number, number, number> | Iterator<number>) => number;
 
+type LockOptions = {
+    lockId: number;
+};
+type AcquireLockOptions = {
+    lockId: string;
+};
+type ReleaseLockOptions = {
+    lockId: string;
+};
+type Lock = {
+    acquire(options: AcquireLockOptions): Promise<void>;
+    tryAcquire(options: AcquireLockOptions): Promise<boolean>;
+    release(options: ReleaseLockOptions): Promise<boolean>;
+    withAcquire: <Result = unknown>(handle: () => Promise<Result>, options: AcquireLockOptions) => Promise<Result>;
+};
+declare const InProcessLock: () => Lock;
+
 declare const merge: <T>(array: T[], item: T, where: (current: T) => boolean, onExisting: (current: T) => T, onNotFound?: () => T | undefined) => T[];
 
 type AsyncRetryOptions = retry.Options & {
@@ -278,51 +378,11 @@ type HandleOptions<Store extends EventStore> = Parameters<Store['appendToStream'
 } | {
     retry?: CommandHandlerRetryOptions;
 });
-declare const CommandHandler$1: <State, StreamEvent extends Event>(options: CommandHandlerOptions<State, StreamEvent>) => <Store extends EventStore>(store: Store, id: string, handle: (state: State) => StreamEvent | StreamEvent[] | Promise<StreamEvent> | Promise<StreamEvent[]>, handleOptions?: HandleOptions<Store>) => Promise<CommandHandlerResult<State, StreamEvent, Store>>;
+declare const CommandHandler: <State, StreamEvent extends Event>(options: CommandHandlerOptions<State, StreamEvent>) => <Store extends EventStore>(store: Store, id: string, handle: (state: State) => StreamEvent | StreamEvent[] | Promise<StreamEvent> | Promise<StreamEvent[]>, handleOptions?: HandleOptions<Store>) => Promise<CommandHandlerResult<State, StreamEvent, Store>>;
 
 type DeciderCommandHandlerOptions<State, CommandType extends Command, StreamEvent extends Event> = CommandHandlerOptions<State, StreamEvent> & Decider<State, CommandType, StreamEvent>;
 declare const DeciderCommandHandler: <State, CommandType extends Command, StreamEvent extends Event>(options: DeciderCommandHandlerOptions<State, CommandType, StreamEvent>) => <Store extends EventStore>(eventStore: Store, id: string, command: CommandType, handleOptions?: HandleOptions<Store>) => Promise<CommandHandlerResult<State, StreamEvent, Store>>;
 
-interface CommandSender {
-    send<CommandType extends Command = Command>(command: CommandType): Promise<void>;
-}
-interface EventsPublisher {
-    publish<EventType extends Event = Event>(event: EventType): Promise<void>;
-}
-type ScheduleOptions = {
-    afterInMs: number;
-} | {
-    at: Date;
-};
-interface MessageScheduler<CommandOrEvent extends Command | Event> {
-    schedule<MessageType extends CommandOrEvent>(message: MessageType, when?: ScheduleOptions): void;
-}
-interface CommandBus extends CommandSender, MessageScheduler<Command> {
-}
-interface EventBus extends EventsPublisher, MessageScheduler<Event> {
-}
-interface MessageBus extends CommandBus, EventBus {
-    schedule<MessageType extends Command | Event>(message: MessageType, when?: ScheduleOptions): void;
-}
-type CommandHandler<CommandType extends Command = Command> = (command: CommandType) => Promise<void> | void;
-interface CommandProcessor {
-    handle<CommandType extends Command>(commandHandler: CommandHandler<CommandType>, ...commandTypes: CommandTypeOf<CommandType>[]): void;
-}
-type EventHandler<EventType extends Event = Event> = (event: EventType) => Promise<void> | void;
-interface EventProcessor {
-    subscribe<EventType extends Event>(eventHandler: EventHandler<EventType>, ...eventTypes: EventTypeOf<EventType>[]): void;
-}
-type ScheduledMessage = {
-    message: Event | Command;
-    options?: ScheduleOptions;
-};
-interface ScheduledMessageProcessor {
-    dequeue(): ScheduledMessage[];
-}
-type MessageHandler = CommandHandler | EventHandler;
-type MessageProcessor = EventProcessor | CommandProcessor;
-declare const getInMemoryMessageBus: () => MessageBus & EventProcessor & CommandProcessor & ScheduledMessageProcessor;
-
 type ProjectionHandlingType = 'inline' | 'async';
 type ProjectionHandler<EventType extends Event = Event, EventMetaDataType extends EventMetaDataOf<EventType> & ReadEventMetadata<any, any> = EventMetaDataOf<EventType> & ReadEventMetadata<any, any>, ProjectionHandlerContext extends DefaultRecord = DefaultRecord> = (events: ReadEvent<EventType, EventMetaDataType>[], context: ProjectionHandlerContext) => Promise<void> | void;
 interface ProjectionDefinition<ReadEventMetadataType extends ReadEventMetadata<any, any> = ReadEventMetadata<any, any>, ProjectionHandlerContext extends DefaultRecord = DefaultRecord> {
@@ -478,6 +538,40 @@ declare const streamTransformations: {
     waitAtMost: <Item>(waitTimeInMs: number) => web_streams_polyfill.TransformStream<Item, Item>;
 };
 
+type TaskQueue = TaskQueueItem[];
+type TaskQueueItem = {
+    task: () => Promise<void>;
+    options?: EnqueueTaskOptions;
+};
+type TaskProcessorOptions = {
+    maxActiveTasks: number;
+    maxQueueSize: number;
+    maxTaskIdleTime?: number;
+};
+type Task<T> = (context: TaskContext) => Promise<T>;
+type TaskContext = {
+    ack: () => void;
+};
+type EnqueueTaskOptions = {
+    taskGroupId?: string;
+};
+declare class TaskProcessor {
+    private options;
+    private queue;
+    private isProcessing;
+    private activeTasks;
+    private activeGroups;
+    constructor(options: TaskProcessorOptions);
+    enqueue<T>(task: Task<T>, options?: EnqueueTaskOptions): Promise<T>;
+    waitForEndOfProcessing(): Promise<void>;
+    private schedule;
+    private ensureProcessing;
+    private processQueue;
+    private executeItem;
+    private takeFirstAvailableItem;
+    private hasItemsToProcess;
+}
+
 declare class AssertionError extends Error {
     constructor(message: string);
 }
@@ -584,4 +678,4 @@ declare const assertNotEmptyString: (value: unknown) => string;
 declare const assertPositiveNumber: (value: unknown) => number;
 declare const assertUnsignedBigInt: (value: string) => bigint;
 
-export { type AggregateStreamOptions, type AggregateStreamResult, type AggregateStreamResultOfEventStore, type AggregateStreamResultWithGlobalPosition, type AppendStreamResultOfEventStore, type AppendToStreamOptions, type AppendToStreamResult, type AppendToStreamResultWithGlobalPosition, type ArgumentMatcher, AssertionError, type AsyncRetryOptions, type BigIntGlobalPosition, type BigIntStreamPosition, BinaryJsonDecoder, type Brand, type CanHandle, CaughtUpTransformStream, type Command, type CommandBus, type CommandDataOf, CommandHandler$1 as CommandHandler, type CommandHandlerOptions, type CommandHandlerResult, type CommandHandlerRetryOptions, CommandHandlerStreamVersionConflictRetryOptions, type CommandMetaDataOf, type CommandProcessor, type CommandSender, type CommandTypeOf, CompositeDecoder, ConcurrencyError, type CreateCommandType, type CreateEventType, type Decider, DeciderCommandHandler, type DeciderCommandHandlerOptions, type DeciderSpecfication, DeciderSpecification, type Decoder, type DeepReadonly, type DefaultCommandMetadata, DefaultDecoder, type DefaultRecord, type Equatable, ErrorConstructor, type Event, type EventBus, type EventDataOf, type EventHandler$1 as EventHandler, type EventMetaDataOf, type EventProcessor, type EventStore, type EventStoreReadEventMetadata, type EventStoreSession, type EventStoreSessionFactory, type EventStoreWrapper, type EventTypeOf, type EventsPublisher, type ExpectedStreamVersion, type ExpectedStreamVersionGeneral, type ExpectedStreamVersionWithValue, ExpectedVersionConflictError, type Flavour, type GlobalPositionTypeOfEventStore, type GlobalPositionTypeOfReadEventMetadata, type GlobalStreamCaughtUp, GlobalStreamCaughtUpType, type GlobalSubscriptionEvent, type HandleOptions, type InMemoryEventStore, InMemoryEventStoreDefaultStreamVersion, JSONParser, JsonDecoder, type Mapper, type MapperArgs, type MessageBus, type MessageHandler, type MessageProcessor, type MessageScheduler, type MockedFunction, type Mutable, NO_CONCURRENCY_CHECK, NoRetries, type NonNullable, ObjectDecoder, ParseError, type ParseOptions, type ProjectionDefinition, type ProjectionHandler, type ProjectionHandlingType, type ProjectionRegistration, type ReadEvent, type ReadEventMetadata, type ReadEventMetadataWithGlobalPosition, type ReadEventMetadataWithoutGlobalPosition, type ReadStreamOptions, type ReadStreamResult, STREAM_DOES_NOT_EXIST, STREAM_EXISTS, type ScheduleOptions, type ScheduledMessage, type ScheduledMessageProcessor, type StreamPositionTypeOfEventStore, type StreamPositionTypeOfReadEventMetadata, StreamingCoordinator, StringDecoder, type StringifyOptions, type TestEventStream, type ThenThrows, type TypedProjectionDefinition, ValidationErrors, type Workflow, type WorkflowCommand, type WorkflowEvent, type WorkflowOutput, WrapEventStore, accept, argMatches, argValue, assertDeepEqual, assertDoesNotThrow, assertEqual, assertExpectedVersionMatchesCurrent, assertFails, assertFalse, assertIsNotNull, assertIsNull, assertMatches, assertNotDeepEqual, assertNotEmptyString, assertNotEqual, assertOk, assertPositiveNumber, assertRejects, assertThat, assertThatArray, assertThrows, assertThrowsAsync, assertTrue, assertUnsignedBigInt, asyncProjections, asyncRetry, canCreateEventStoreSession, caughtUpEventFrom, collect, command, complete, concatUint8Arrays, deepEquals, error, event, formatDateToUtcYYYYMMDD, getInMemoryEventStore, getInMemoryMessageBus, globalStreamCaughtUp, ignore, inlineProjections, isEquatable, isExpectedVersionConflictError, isGlobalStreamCaughtUp, isNotInternalEvent, isNumber, isString, isSubscriptionEvent, isSubset, isValidYYYYMMDD, matchesExpectedVersion, merge, nulloSessionFactory, parseDateFromUtcYYYYMMDD, projection, projections, publish, reply, restream, schedule, send, streamGenerators, streamTrackingGlobalPosition, streamTransformations, sum, verifyThat };
+export { type AcquireLockOptions, type AfterEventStoreCommitHandler, type AggregateStreamOptions, type AggregateStreamResult, type AggregateStreamResultOfEventStore, type AggregateStreamResultWithGlobalPosition, type AppendStreamResultOfEventStore, type AppendToStreamOptions, type AppendToStreamResult, type AppendToStreamResultWithGlobalPosition, type ArgumentMatcher, AssertionError, type AsyncRetryOptions, type BigIntGlobalPosition, type BigIntStreamPosition, BinaryJsonDecoder, type Brand, type CanHandle, CaughtUpTransformStream, type Closeable, type Command, type CommandBus, type CommandDataOf, CommandHandler, type CommandHandlerOptions, type CommandHandlerResult, type CommandHandlerRetryOptions, CommandHandlerStreamVersionConflictRetryOptions, type CommandMetaDataOf, type CommandProcessor, type CommandSender, type CommandTypeOf, CompositeDecoder, ConcurrencyError, type CreateCommandType, type CreateEventType, type Decider, DeciderCommandHandler, type DeciderCommandHandlerOptions, type DeciderSpecfication, DeciderSpecification, type Decoder, type DeepReadonly, type DefaultCommandMetadata, DefaultDecoder, type DefaultEventStoreOptions, type DefaultRecord, type EnqueueTaskOptions, type Equatable, ErrorConstructor, type Event, type EventBus, type EventDataOf, type EventMetaDataOf, type EventProcessor, type EventStore, type EventStoreReadEventMetadata, type EventStoreSession, type EventStoreSessionFactory, type EventStoreWrapper, type EventTypeOf, type EventsPublisher, type ExpectedStreamVersion, type ExpectedStreamVersionGeneral, type ExpectedStreamVersionWithValue, ExpectedVersionConflictError, type Flavour, type GlobalPositionTypeOfEventStore, type GlobalPositionTypeOfReadEventMetadata, type GlobalStreamCaughtUp, GlobalStreamCaughtUpType, type GlobalSubscriptionEvent, type HandleOptions, type InMemoryEventStore, InMemoryEventStoreDefaultStreamVersion, type InMemoryEventStoreOptions, type InMemoryReadEvent, InProcessLock, JSONParser, JsonDecoder, type Lock, type LockOptions, type Mapper, type MapperArgs, type MessageBus, type MessageHandler, type MessageProcessor, type MessageScheduler, type MockedFunction, type Mutable, NO_CONCURRENCY_CHECK, NoRetries, type NonNullable, ObjectDecoder, ParseError, type ParseOptions, type ProjectionDefinition, type ProjectionHandler, type ProjectionHandlingType, type ProjectionRegistration, type ReadEvent, type ReadEventMetadata, type ReadEventMetadataWithGlobalPosition, type ReadEventMetadataWithoutGlobalPosition, type ReadStreamOptions, type ReadStreamResult, type ReleaseLockOptions, STREAM_DOES_NOT_EXIST, STREAM_EXISTS, type ScheduleOptions, type ScheduledMessage, type ScheduledMessageProcessor, type StreamPositionTypeOfEventStore, type StreamPositionTypeOfReadEventMetadata, StreamingCoordinator, StringDecoder, type StringifyOptions, type Task, type TaskContext, TaskProcessor, type TaskProcessorOptions, type TaskQueue, type TaskQueueItem, type TestEventStream, type ThenThrows, type TypedProjectionDefinition, ValidationErrors, type Workflow, type WorkflowCommand, type WorkflowEvent, type WorkflowOutput, WrapEventStore, accept, argMatches, argValue, assertDeepEqual, assertDoesNotThrow, assertEqual, assertExpectedVersionMatchesCurrent, assertFails, assertFalse, assertIsNotNull, assertIsNull, assertMatches, assertNotDeepEqual, assertNotEmptyString, assertNotEqual, assertOk, assertPositiveNumber, assertRejects, assertThat, assertThatArray, assertThrows, assertThrowsAsync, assertTrue, assertUnsignedBigInt, asyncProjections, asyncRetry, canCreateEventStoreSession, caughtUpEventFrom, collect, command, complete, concatUint8Arrays, deepEquals, error, event, formatDateToUtcYYYYMMDD, forwardToMessageBus, getInMemoryEventStore, getInMemoryMessageBus, globalStreamCaughtUp, ignore, inlineProjections, isEquatable, isExpectedVersionConflictError, isGlobalStreamCaughtUp, isNotInternalEvent, isNumber, isString, isSubscriptionEvent, isSubset, isValidYYYYMMDD, matchesExpectedVersion, merge, nulloSessionFactory, parseDateFromUtcYYYYMMDD, projection, projections, publish, reply, restream, schedule, send, streamGenerators, streamTrackingGlobalPosition, streamTransformations, sum, tryPublishMessagesAfterCommit, verifyThat };

package/dist/index.d.ts

@@ -211,6 +211,79 @@ type AppendToStreamResultWithGlobalPosition<StreamVersion = BigIntStreamPosition
     lastEventGlobalPosition: GlobalPosition;
 };
 type AppendStreamResultOfEventStore<Store extends EventStore> = Store['appendToStream'] extends (...args: any[]) => Promise<infer R> ? R : never;
+type DefaultEventStoreOptions<Store extends EventStore, HandlerContext = never> = {
+    /**
+     * Pluggable set of hooks informing about the event store internal behaviour.
+     */
+    hooks?: {
+        /**
+         * This hook will be called **AFTER** events were stored in the event store.
+         * It's designed to handle scenarios where delivery and ordering guarantees do not matter much.
+         *
+         * **WARNINGS:**
+         *
+         *  1. It will be called **EXACTLY ONCE** if append succeded.
+         *  2. If the hook fails, its append **will still silently succeed**, and no error will be thrown.
+         *  3. Wen process crashes after events were committed, but before the hook was called, delivery won't be retried.
+         * That can lead to state inconsistencies.
+         *  4. In the case of high concurrent traffic, **race conditions may cause ordering issues**.
+         * For instance, where the second hook takes longer to process than the first one, ordering won't be guaranteed.
+         *
+         * @type {AfterEventStoreCommitHandler<Store, HandlerContext>}
+         */
+        onAfterCommit?: AfterEventStoreCommitHandler<Store, HandlerContext>;
+    };
+};
+
+type AfterEventStoreCommitHandlerWithoutContext<Store extends EventStore> = (messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[]) => Promise<void> | void;
+type AfterEventStoreCommitHandler<Store extends EventStore, HandlerContext = never> = [HandlerContext] extends [never] ? AfterEventStoreCommitHandlerWithoutContext<Store> : (messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[], context: HandlerContext) => Promise<void> | void;
+type TryPublishMessagesAfterCommitOptions<Store extends EventStore, HandlerContext = never> = {
+    onAfterCommit?: AfterEventStoreCommitHandler<Store, HandlerContext>;
+};
+declare function tryPublishMessagesAfterCommit<Store extends EventStore>(messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[], options: TryPublishMessagesAfterCommitOptions<Store, undefined> | undefined): Promise<boolean>;
+declare function tryPublishMessagesAfterCommit<Store extends EventStore, HandlerContext>(messages: ReadEvent<Event, EventStoreReadEventMetadata<Store>>[], options: TryPublishMessagesAfterCommitOptions<Store, HandlerContext> | undefined, context: HandlerContext): Promise<boolean>;
+
+interface CommandSender {
+    send<CommandType extends Command = Command>(command: CommandType): Promise<void>;
+}
+interface EventsPublisher {
+    publish<EventType extends Event = Event>(event: EventType): Promise<void>;
+}
+type ScheduleOptions = {
+    afterInMs: number;
+} | {
+    at: Date;
+};
+interface MessageScheduler<CommandOrEvent extends Command | Event> {
+    schedule<MessageType extends CommandOrEvent>(message: MessageType, when?: ScheduleOptions): void;
+}
+interface CommandBus extends CommandSender, MessageScheduler<Command> {
+}
+interface EventBus extends EventsPublisher, MessageScheduler<Event> {
+}
+interface MessageBus extends CommandBus, EventBus {
+    schedule<MessageType extends Command | Event>(message: MessageType, when?: ScheduleOptions): void;
+}
+type CommandHandler$1<CommandType extends Command = Command> = (command: CommandType) => Promise<void> | void;
+interface CommandProcessor {
+    handle<CommandType extends Command>(commandHandler: CommandHandler$1<CommandType>, ...commandTypes: CommandTypeOf<CommandType>[]): void;
+}
+type EventHandler<EventType extends Event = Event> = (event: EventType) => Promise<void> | void;
+interface EventProcessor {
+    subscribe<EventType extends Event>(eventHandler: EventHandler<EventType>, ...eventTypes: EventTypeOf<EventType>[]): void;
+}
+type ScheduledMessage = {
+    message: Event | Command;
+    options?: ScheduleOptions;
+};
+interface ScheduledMessageProcessor {
+    dequeue(): ScheduledMessage[];
+}
+type MessageHandler = CommandHandler$1 | EventHandler;
+type MessageProcessor = EventProcessor | CommandProcessor;
+declare const getInMemoryMessageBus: () => MessageBus & EventProcessor & CommandProcessor & ScheduledMessageProcessor;
+
+declare const forwardToMessageBus: <Store extends EventStore, HandlerContext = never>(eventPublisher: EventsPublisher) => AfterEventStoreCommitHandler<Store, HandlerContext>;
 
 declare const GlobalStreamCaughtUpType = "__emt:GlobalStreamCaughtUp";
 type GlobalStreamCaughtUp = Event<'__emt:GlobalStreamCaughtUp', {
@@ -225,10 +298,11 @@ declare const isSubscriptionEvent: (event: Event) => event is GlobalSubscription
 declare const isNotInternalEvent: (event: Event) => boolean;
 type GlobalSubscriptionEvent = GlobalStreamCaughtUp;
 
-type EventHandler$1<E extends Event = Event> = (eventEnvelope: ReadEvent<E>) => void;
 declare const InMemoryEventStoreDefaultStreamVersion = 0n;
 type InMemoryEventStore = EventStore<ReadEventMetadataWithGlobalPosition>;
-declare const getInMemoryEventStore: () => InMemoryEventStore;
+type InMemoryEventStoreOptions = DefaultEventStoreOptions<InMemoryEventStore>;
+type InMemoryReadEvent<EventType extends Event = Event> = ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>;
+declare const getInMemoryEventStore: (eventStoreOptions?: InMemoryEventStoreOptions) => InMemoryEventStore;
 
 declare const streamTrackingGlobalPosition: (currentEvents: ReadEvent<Event, ReadEventMetadataWithGlobalPosition>[]) => CaughtUpTransformStream;
 declare class CaughtUpTransformStream extends TransformStream<ReadEvent<Event, ReadEventMetadataWithGlobalPosition>, ReadEvent<Event, ReadEventMetadataWithGlobalPosition> | GlobalSubscriptionEvent> {
@@ -243,6 +317,15 @@ declare const StreamingCoordinator: () => {
     stream: () => web_streams_polyfill.ReadableStream<GlobalStreamCaughtUp | ReadEvent<Event, ReadEventMetadataWithGlobalPosition>>;
 };
 
+type Closeable = {
+    /**
+     * Gracefully cleans up managed resources
+     *
+     * @memberof Closeable
+     */
+    close: () => Promise<void>;
+};
+
 declare const deepEquals: <T>(left: T, right: T) => boolean;
 type Equatable<T> = {
     equals: (right: T) => boolean;
@@ -251,6 +334,23 @@ declare const isEquatable: <T>(left: T) => left is Equatable<T>;
 
 declare const sum: (iterator: Iterator<number, number, number> | Iterator<number>) => number;
 
+type LockOptions = {
+    lockId: number;
+};
+type AcquireLockOptions = {
+    lockId: string;
+};
+type ReleaseLockOptions = {
+    lockId: string;
+};
+type Lock = {
+    acquire(options: AcquireLockOptions): Promise<void>;
+    tryAcquire(options: AcquireLockOptions): Promise<boolean>;
+    release(options: ReleaseLockOptions): Promise<boolean>;
+    withAcquire: <Result = unknown>(handle: () => Promise<Result>, options: AcquireLockOptions) => Promise<Result>;
+};
+declare const InProcessLock: () => Lock;
+
 declare const merge: <T>(array: T[], item: T, where: (current: T) => boolean, onExisting: (current: T) => T, onNotFound?: () => T | undefined) => T[];
 
 type AsyncRetryOptions = retry.Options & {
@@ -278,51 +378,11 @@ type HandleOptions<Store extends EventStore> = Parameters<Store['appendToStream'
 } | {
     retry?: CommandHandlerRetryOptions;
 });
-declare const CommandHandler$1: <State, StreamEvent extends Event>(options: CommandHandlerOptions<State, StreamEvent>) => <Store extends EventStore>(store: Store, id: string, handle: (state: State) => StreamEvent | StreamEvent[] | Promise<StreamEvent> | Promise<StreamEvent[]>, handleOptions?: HandleOptions<Store>) => Promise<CommandHandlerResult<State, StreamEvent, Store>>;
+declare const CommandHandler: <State, StreamEvent extends Event>(options: CommandHandlerOptions<State, StreamEvent>) => <Store extends EventStore>(store: Store, id: string, handle: (state: State) => StreamEvent | StreamEvent[] | Promise<StreamEvent> | Promise<StreamEvent[]>, handleOptions?: HandleOptions<Store>) => Promise<CommandHandlerResult<State, StreamEvent, Store>>;
 
 type DeciderCommandHandlerOptions<State, CommandType extends Command, StreamEvent extends Event> = CommandHandlerOptions<State, StreamEvent> & Decider<State, CommandType, StreamEvent>;
 declare const DeciderCommandHandler: <State, CommandType extends Command, StreamEvent extends Event>(options: DeciderCommandHandlerOptions<State, CommandType, StreamEvent>) => <Store extends EventStore>(eventStore: Store, id: string, command: CommandType, handleOptions?: HandleOptions<Store>) => Promise<CommandHandlerResult<State, StreamEvent, Store>>;
 
-interface CommandSender {
-    send<CommandType extends Command = Command>(command: CommandType): Promise<void>;
-}
-interface EventsPublisher {
-    publish<EventType extends Event = Event>(event: EventType): Promise<void>;
-}
-type ScheduleOptions = {
-    afterInMs: number;
-} | {
-    at: Date;
-};
-interface MessageScheduler<CommandOrEvent extends Command | Event> {
-    schedule<MessageType extends CommandOrEvent>(message: MessageType, when?: ScheduleOptions): void;
-}
-interface CommandBus extends CommandSender, MessageScheduler<Command> {
-}
-interface EventBus extends EventsPublisher, MessageScheduler<Event> {
-}
-interface MessageBus extends CommandBus, EventBus {
-    schedule<MessageType extends Command | Event>(message: MessageType, when?: ScheduleOptions): void;
-}
-type CommandHandler<CommandType extends Command = Command> = (command: CommandType) => Promise<void> | void;
-interface CommandProcessor {
-    handle<CommandType extends Command>(commandHandler: CommandHandler<CommandType>, ...commandTypes: CommandTypeOf<CommandType>[]): void;
-}
-type EventHandler<EventType extends Event = Event> = (event: EventType) => Promise<void> | void;
-interface EventProcessor {
-    subscribe<EventType extends Event>(eventHandler: EventHandler<EventType>, ...eventTypes: EventTypeOf<EventType>[]): void;
-}
-type ScheduledMessage = {
-    message: Event | Command;
-    options?: ScheduleOptions;
-};
-interface ScheduledMessageProcessor {
-    dequeue(): ScheduledMessage[];
-}
-type MessageHandler = CommandHandler | EventHandler;
-type MessageProcessor = EventProcessor | CommandProcessor;
-declare const getInMemoryMessageBus: () => MessageBus & EventProcessor & CommandProcessor & ScheduledMessageProcessor;
-
 type ProjectionHandlingType = 'inline' | 'async';
 type ProjectionHandler<EventType extends Event = Event, EventMetaDataType extends EventMetaDataOf<EventType> & ReadEventMetadata<any, any> = EventMetaDataOf<EventType> & ReadEventMetadata<any, any>, ProjectionHandlerContext extends DefaultRecord = DefaultRecord> = (events: ReadEvent<EventType, EventMetaDataType>[], context: ProjectionHandlerContext) => Promise<void> | void;
 interface ProjectionDefinition<ReadEventMetadataType extends ReadEventMetadata<any, any> = ReadEventMetadata<any, any>, ProjectionHandlerContext extends DefaultRecord = DefaultRecord> {
@@ -478,6 +538,40 @@ declare const streamTransformations: {
     waitAtMost: <Item>(waitTimeInMs: number) => web_streams_polyfill.TransformStream<Item, Item>;
 };
 
+type TaskQueue = TaskQueueItem[];
+type TaskQueueItem = {
+    task: () => Promise<void>;
+    options?: EnqueueTaskOptions;
+};
+type TaskProcessorOptions = {
+    maxActiveTasks: number;
+    maxQueueSize: number;
+    maxTaskIdleTime?: number;
+};
+type Task<T> = (context: TaskContext) => Promise<T>;
+type TaskContext = {
+    ack: () => void;
+};
+type EnqueueTaskOptions = {
+    taskGroupId?: string;
+};
+declare class TaskProcessor {
+    private options;
+    private queue;
+    private isProcessing;
+    private activeTasks;
+    private activeGroups;
+    constructor(options: TaskProcessorOptions);
+    enqueue<T>(task: Task<T>, options?: EnqueueTaskOptions): Promise<T>;
+    waitForEndOfProcessing(): Promise<void>;
+    private schedule;
+    private ensureProcessing;
+    private processQueue;
+    private executeItem;
+    private takeFirstAvailableItem;
+    private hasItemsToProcess;
+}
+
 declare class AssertionError extends Error {
     constructor(message: string);
 }
@@ -584,4 +678,4 @@ declare const assertNotEmptyString: (value: unknown) => string;
 declare const assertPositiveNumber: (value: unknown) => number;
 declare const assertUnsignedBigInt: (value: string) => bigint;
 
-export { type AggregateStreamOptions, type AggregateStreamResult, type AggregateStreamResultOfEventStore, type AggregateStreamResultWithGlobalPosition, type AppendStreamResultOfEventStore, type AppendToStreamOptions, type AppendToStreamResult, type AppendToStreamResultWithGlobalPosition, type ArgumentMatcher, AssertionError, type AsyncRetryOptions, type BigIntGlobalPosition, type BigIntStreamPosition, BinaryJsonDecoder, type Brand, type CanHandle, CaughtUpTransformStream, type Command, type CommandBus, type CommandDataOf, CommandHandler$1 as CommandHandler, type CommandHandlerOptions, type CommandHandlerResult, type CommandHandlerRetryOptions, CommandHandlerStreamVersionConflictRetryOptions, type CommandMetaDataOf, type CommandProcessor, type CommandSender, type CommandTypeOf, CompositeDecoder, ConcurrencyError, type CreateCommandType, type CreateEventType, type Decider, DeciderCommandHandler, type DeciderCommandHandlerOptions, type DeciderSpecfication, DeciderSpecification, type Decoder, type DeepReadonly, type DefaultCommandMetadata, DefaultDecoder, type DefaultRecord, type Equatable, ErrorConstructor, type Event, type EventBus, type EventDataOf, type EventHandler$1 as EventHandler, type EventMetaDataOf, type EventProcessor, type EventStore, type EventStoreReadEventMetadata, type EventStoreSession, type EventStoreSessionFactory, type EventStoreWrapper, type EventTypeOf, type EventsPublisher, type ExpectedStreamVersion, type ExpectedStreamVersionGeneral, type ExpectedStreamVersionWithValue, ExpectedVersionConflictError, type Flavour, type GlobalPositionTypeOfEventStore, type GlobalPositionTypeOfReadEventMetadata, type GlobalStreamCaughtUp, GlobalStreamCaughtUpType, type GlobalSubscriptionEvent, type HandleOptions, type InMemoryEventStore, InMemoryEventStoreDefaultStreamVersion, JSONParser, JsonDecoder, type Mapper, type MapperArgs, type MessageBus, type MessageHandler, type MessageProcessor, type MessageScheduler, type MockedFunction, type Mutable, NO_CONCURRENCY_CHECK, NoRetries, type NonNullable, ObjectDecoder, ParseError, type ParseOptions, type ProjectionDefinition, type ProjectionHandler, type ProjectionHandlingType, type ProjectionRegistration, type ReadEvent, type ReadEventMetadata, type ReadEventMetadataWithGlobalPosition, type ReadEventMetadataWithoutGlobalPosition, type ReadStreamOptions, type ReadStreamResult, STREAM_DOES_NOT_EXIST, STREAM_EXISTS, type ScheduleOptions, type ScheduledMessage, type ScheduledMessageProcessor, type StreamPositionTypeOfEventStore, type StreamPositionTypeOfReadEventMetadata, StreamingCoordinator, StringDecoder, type StringifyOptions, type TestEventStream, type ThenThrows, type TypedProjectionDefinition, ValidationErrors, type Workflow, type WorkflowCommand, type WorkflowEvent, type WorkflowOutput, WrapEventStore, accept, argMatches, argValue, assertDeepEqual, assertDoesNotThrow, assertEqual, assertExpectedVersionMatchesCurrent, assertFails, assertFalse, assertIsNotNull, assertIsNull, assertMatches, assertNotDeepEqual, assertNotEmptyString, assertNotEqual, assertOk, assertPositiveNumber, assertRejects, assertThat, assertThatArray, assertThrows, assertThrowsAsync, assertTrue, assertUnsignedBigInt, asyncProjections, asyncRetry, canCreateEventStoreSession, caughtUpEventFrom, collect, command, complete, concatUint8Arrays, deepEquals, error, event, formatDateToUtcYYYYMMDD, getInMemoryEventStore, getInMemoryMessageBus, globalStreamCaughtUp, ignore, inlineProjections, isEquatable, isExpectedVersionConflictError, isGlobalStreamCaughtUp, isNotInternalEvent, isNumber, isString, isSubscriptionEvent, isSubset, isValidYYYYMMDD, matchesExpectedVersion, merge, nulloSessionFactory, parseDateFromUtcYYYYMMDD, projection, projections, publish, reply, restream, schedule, send, streamGenerators, streamTrackingGlobalPosition, streamTransformations, sum, verifyThat };
+export { type AcquireLockOptions, type AfterEventStoreCommitHandler, type AggregateStreamOptions, type AggregateStreamResult, type AggregateStreamResultOfEventStore, type AggregateStreamResultWithGlobalPosition, type AppendStreamResultOfEventStore, type AppendToStreamOptions, type AppendToStreamResult, type AppendToStreamResultWithGlobalPosition, type ArgumentMatcher, AssertionError, type AsyncRetryOptions, type BigIntGlobalPosition, type BigIntStreamPosition, BinaryJsonDecoder, type Brand, type CanHandle, CaughtUpTransformStream, type Closeable, type Command, type CommandBus, type CommandDataOf, CommandHandler, type CommandHandlerOptions, type CommandHandlerResult, type CommandHandlerRetryOptions, CommandHandlerStreamVersionConflictRetryOptions, type CommandMetaDataOf, type CommandProcessor, type CommandSender, type CommandTypeOf, CompositeDecoder, ConcurrencyError, type CreateCommandType, type CreateEventType, type Decider, DeciderCommandHandler, type DeciderCommandHandlerOptions, type DeciderSpecfication, DeciderSpecification, type Decoder, type DeepReadonly, type DefaultCommandMetadata, DefaultDecoder, type DefaultEventStoreOptions, type DefaultRecord, type EnqueueTaskOptions, type Equatable, ErrorConstructor, type Event, type EventBus, type EventDataOf, type EventMetaDataOf, type EventProcessor, type EventStore, type EventStoreReadEventMetadata, type EventStoreSession, type EventStoreSessionFactory, type EventStoreWrapper, type EventTypeOf, type EventsPublisher, type ExpectedStreamVersion, type ExpectedStreamVersionGeneral, type ExpectedStreamVersionWithValue, ExpectedVersionConflictError, type Flavour, type GlobalPositionTypeOfEventStore, type GlobalPositionTypeOfReadEventMetadata, type GlobalStreamCaughtUp, GlobalStreamCaughtUpType, type GlobalSubscriptionEvent, type HandleOptions, type InMemoryEventStore, InMemoryEventStoreDefaultStreamVersion, type InMemoryEventStoreOptions, type InMemoryReadEvent, InProcessLock, JSONParser, JsonDecoder, type Lock, type LockOptions, type Mapper, type MapperArgs, type MessageBus, type MessageHandler, type MessageProcessor, type MessageScheduler, type MockedFunction, type Mutable, NO_CONCURRENCY_CHECK, NoRetries, type NonNullable, ObjectDecoder, ParseError, type ParseOptions, type ProjectionDefinition, type ProjectionHandler, type ProjectionHandlingType, type ProjectionRegistration, type ReadEvent, type ReadEventMetadata, type ReadEventMetadataWithGlobalPosition, type ReadEventMetadataWithoutGlobalPosition, type ReadStreamOptions, type ReadStreamResult, type ReleaseLockOptions, STREAM_DOES_NOT_EXIST, STREAM_EXISTS, type ScheduleOptions, type ScheduledMessage, type ScheduledMessageProcessor, type StreamPositionTypeOfEventStore, type StreamPositionTypeOfReadEventMetadata, StreamingCoordinator, StringDecoder, type StringifyOptions, type Task, type TaskContext, TaskProcessor, type TaskProcessorOptions, type TaskQueue, type TaskQueueItem, type TestEventStream, type ThenThrows, type TypedProjectionDefinition, ValidationErrors, type Workflow, type WorkflowCommand, type WorkflowEvent, type WorkflowOutput, WrapEventStore, accept, argMatches, argValue, assertDeepEqual, assertDoesNotThrow, assertEqual, assertExpectedVersionMatchesCurrent, assertFails, assertFalse, assertIsNotNull, assertIsNull, assertMatches, assertNotDeepEqual, assertNotEmptyString, assertNotEqual, assertOk, assertPositiveNumber, assertRejects, assertThat, assertThatArray, assertThrows, assertThrowsAsync, assertTrue, assertUnsignedBigInt, asyncProjections, asyncRetry, canCreateEventStoreSession, caughtUpEventFrom, collect, command, complete, concatUint8Arrays, deepEquals, error, event, formatDateToUtcYYYYMMDD, forwardToMessageBus, getInMemoryEventStore, getInMemoryMessageBus, globalStreamCaughtUp, ignore, inlineProjections, isEquatable, isExpectedVersionConflictError, isGlobalStreamCaughtUp, isNotInternalEvent, isNumber, isString, isSubscriptionEvent, isSubset, isValidYYYYMMDD, matchesExpectedVersion, merge, nulloSessionFactory, parseDateFromUtcYYYYMMDD, projection, projections, publish, reply, restream, schedule, send, streamGenerators, streamTrackingGlobalPosition, streamTransformations, sum, tryPublishMessagesAfterCommit, verifyThat };