@event-driven-io/emmett-postgresql 0.35.0-alpha.2 → 0.36.0

package/dist/index.d.cts

@@ -1,28 +1,28 @@
 import * as _event_driven_io_dumbo from '@event-driven-io/dumbo';
-import { SQLExecutor, Dumbo, DumboOptions, QueryResultRow, SQL, NodePostgresClient, NodePostgresTransaction, NodePostgresConnector, NodePostgresPoolClientConnection, NodePostgresClientConnection, NodePostgresPool, MigrationStyle } from '@event-driven-io/dumbo';
-import { Event, ReadEvent, ReadEventMetadataWithGlobalPosition, EmmettError, CanHandle, ThenThrows, ProjectionDefinition, ProjectionHandler, EventStore, EventStoreSessionFactory, AppendToStreamOptions, AppendToStreamResultWithGlobalPosition, ProjectionRegistration, RecordedMessage, Message, ReadEventMetadata, ReadStreamOptions, ReadStreamResult } from '@event-driven-io/emmett';
+import { SQLExecutor, NodePostgresClient, NodePostgresTransaction, Dumbo, NodePostgresConnector, NodePostgresPoolClientConnection, NodePostgresClientConnection, NodePostgresPool, DumboOptions, QueryResultRow, SQL, MigrationStyle } from '@event-driven-io/dumbo';
+import { EmmettError, Message, BatchRecordedMessageHandlerWithoutContext, ReadEventMetadataWithGlobalPosition, ReactorOptions, Event, ProjectorOptions, AnyMessage, MessageProcessor, SingleRecordedMessageHandlerWithContext, BatchRecordedMessageHandlerWithContext, Checkpointer, MessageConsumerOptions, MessageConsumer, DefaultRecord, ReadEvent, CanHandle, TruncateProjection, ThenThrows, ProjectionDefinition, ProjectionHandler, EventStore, EventStoreSessionFactory, AppendToStreamOptions, AppendToStreamResultWithGlobalPosition, ProjectionRegistration, RecordedMessage, RecordedMessageMetadata, RecordedMessageMetadataWithGlobalPosition, ReadStreamOptions, ReadStreamResult } from '@event-driven-io/emmett';
 import pg from 'pg';
-import { PongoDocument, WithId, PongoFilter, PongoClient } from '@event-driven-io/pongo';
+import { PongoClient, PongoDocument, WithId, PongoFilter } from '@event-driven-io/pongo';
+import { AnyEvent, ProjectorOptions as ProjectorOptions$1, ReadEventMetadataWithGlobalPosition as ReadEventMetadataWithGlobalPosition$1 } from '@event-driven-io/emmett/src';
 
 declare const DefaultPostgreSQLEventStoreProcessorBatchSize = 100;
 declare const DefaultPostgreSQLEventStoreProcessorPullingFrequencyInMs = 50;
-type PostgreSQLEventStoreMessagesBatch<EventType extends Event = Event> = {
-    messages: ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>[];
-};
 type PostgreSQLEventStoreMessagesBatchHandlerResult = void | {
     type: 'STOP';
     reason?: string;
     error?: EmmettError;
 };
-type PostgreSQLEventStoreMessagesBatchHandler<EventType extends Event = Event> = (messagesBatch: PostgreSQLEventStoreMessagesBatch<EventType>) => Promise<PostgreSQLEventStoreMessagesBatchHandlerResult> | PostgreSQLEventStoreMessagesBatchHandlerResult;
-type PostgreSQLEventStoreMessageBatchPullerOptions<EventType extends Event = Event> = {
+type PostgreSQLEventStoreMessageBatchPullerOptions<MessageType extends Message = Message> = {
     executor: SQLExecutor;
     pullingFrequencyInMs: number;
     batchSize: number;
-    eachBatch: PostgreSQLEventStoreMessagesBatchHandler<EventType>;
+    eachBatch: BatchRecordedMessageHandlerWithoutContext<MessageType, ReadEventMetadataWithGlobalPosition>;
+    stopWhen?: {
+        noMessagesLeft?: boolean;
+    };
 };
 type PostgreSQLEventStoreMessageBatchPullerStartFrom = {
-    globalPosition: bigint;
+    lastCheckpoint: bigint;
 } | 'BEGINNING' | 'END';
 type PostgreSQLEventStoreMessageBatchPullerStartOptions = {
     startFrom: PostgreSQLEventStoreMessageBatchPullerStartFrom;
@@ -32,38 +32,103 @@ type PostgreSQLEventStoreMessageBatchPuller = {
     start(options: PostgreSQLEventStoreMessageBatchPullerStartOptions): Promise<void>;
     stop(): Promise<void>;
 };
-declare const postgreSQLEventStoreMessageBatchPuller: <EventType extends Event = Event>({ executor, batchSize, eachBatch, pullingFrequencyInMs, }: PostgreSQLEventStoreMessageBatchPullerOptions<EventType>) => PostgreSQLEventStoreMessageBatchPuller;
+declare const postgreSQLEventStoreMessageBatchPuller: <MessageType extends Message = Message>({ executor, batchSize, eachBatch, pullingFrequencyInMs, stopWhen, }: PostgreSQLEventStoreMessageBatchPullerOptions<MessageType>) => PostgreSQLEventStoreMessageBatchPuller;
 declare const zipPostgreSQLEventStoreMessageBatchPullerStartFrom: (options: (PostgreSQLEventStoreMessageBatchPullerStartFrom | undefined)[]) => PostgreSQLEventStoreMessageBatchPullerStartFrom;
 
-type PongoAssertOptions = {
-    inCollection: string;
-    inDatabase?: string;
+type PostgreSQLProcessorHandlerContext = {
+    execute: SQLExecutor;
+    connection: {
+        connectionString: string;
+        client: NodePostgresClient;
+        transaction: NodePostgresTransaction;
+        pool: Dumbo;
+    };
 };
-type FilterOrId<Doc extends PongoDocument | WithId<PongoDocument>> = {
-    withId: string;
+type PostgreSQLProcessor<MessageType extends Message = AnyMessage> = MessageProcessor<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext>;
+type PostgreSQLProcessorEachMessageHandler<MessageType extends Message = Message> = SingleRecordedMessageHandlerWithContext<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext>;
+type PostgreSQLProcessorEachBatchHandler<MessageType extends Message = Message> = BatchRecordedMessageHandlerWithContext<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext>;
+type PostgreSQLProcessorStartFrom = PostgreSQLEventStoreMessageBatchPullerStartFrom | 'CURRENT';
+type PostgreSQLProcessorPooledOptions = {
+    connector?: NodePostgresConnector;
+    database?: string;
+    pooled: true;
+    pool: pg.Pool;
 } | {
-    matchingFilter: PongoFilter<Doc>;
+    connector?: NodePostgresConnector;
+    database?: string;
+    pool: pg.Pool;
+} | {
+    connector?: NodePostgresConnector;
+    database?: string;
+    pooled: true;
+} | {
+    connector?: NodePostgresConnector;
+    database?: string;
 };
-declare const documentExists: <Doc extends PongoDocument | WithId<PongoDocument>>(document: Doc, options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
-declare const documentsAreTheSame: <Doc extends PongoDocument | WithId<PongoDocument>>(documents: Doc[], options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
-declare const documentsMatchingHaveCount: <Doc extends PongoDocument | WithId<PongoDocument>>(expectedCount: number, options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
-declare const documentMatchingExists: <Doc extends PongoDocument | WithId<PongoDocument>>(options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
-declare const documentDoesNotExist: <Doc extends PongoDocument | WithId<PongoDocument>>(options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
-declare const expectPongoDocuments: {
-    fromCollection: <Doc extends PongoDocument | WithId<PongoDocument>>(collectionName: string) => {
-        withId: (id: string) => {
-            toBeEqual: (document: Doc) => PostgreSQLProjectionAssert;
-            toExist: () => PostgreSQLProjectionAssert;
-            notToExist: () => PostgreSQLProjectionAssert;
-        };
-        matching: <Doc_1 extends PongoDocument | WithId<PongoDocument>>(filter: PongoFilter<Doc_1>) => {
-            toBeTheSame: (documents: Doc_1[]) => PostgreSQLProjectionAssert;
-            toHaveCount: (expectedCount: number) => PostgreSQLProjectionAssert;
-            toExist: () => PostgreSQLProjectionAssert;
-            notToExist: () => PostgreSQLProjectionAssert;
-        };
+type PostgreSQLProcessorNotPooledOptions = {
+    connector?: NodePostgresConnector;
+    database?: string;
+    pooled: false;
+    client: pg.Client;
+} | {
+    connector?: NodePostgresConnector;
+    database?: string;
+    client: pg.Client;
+} | {
+    connector?: NodePostgresConnector;
+    database?: string;
+    pooled: false;
+} | {
+    connector?: NodePostgresConnector;
+    database?: string;
+    connection: NodePostgresPoolClientConnection | NodePostgresClientConnection;
+    pooled?: false;
+} | {
+    connector?: NodePostgresConnector;
+    database?: string;
+    dumbo: NodePostgresPool;
+    pooled?: false;
+};
+type PostgreSQLProcessorConnectionOptions = {
+    connectionString: string;
+} & (PostgreSQLProcessorPooledOptions | PostgreSQLProcessorNotPooledOptions);
+type PostgreSQLCheckpointer<MessageType extends AnyMessage = AnyMessage> = Checkpointer<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext>;
+declare const postgreSQLCheckpointer: <MessageType extends Message = Message>() => PostgreSQLCheckpointer<MessageType>;
+type PostgreSQLConnectionOptions = {
+    connectionOptions?: PostgreSQLProcessorConnectionOptions;
+};
+type PostgreSQLReactorOptions<MessageType extends Message = Message> = ReactorOptions<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext> & PostgreSQLConnectionOptions;
+type PostgreSQLProjectorOptions<EventType extends Event = Event> = ProjectorOptions<EventType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext> & PostgreSQLConnectionOptions;
+type PostgreSQLProcessorOptions<MessageType extends Message = Message> = PostgreSQLReactorOptions<MessageType> | PostgreSQLProjectorOptions<MessageType>;
+declare const postgreSQLProjector: <EventType extends Event = Event>(options: PostgreSQLProjectorOptions<EventType>) => PostgreSQLProcessor<EventType>;
+declare const postgreSQLReactor: <MessageType extends Message = Message>(options: PostgreSQLReactorOptions<MessageType>) => PostgreSQLProcessor<MessageType>;
+declare const postgreSQLMessageProcessor: <MessageType extends Message = Message>(options: PostgreSQLProcessorOptions<MessageType>) => PostgreSQLProcessor<MessageType>;
+
+type PostgreSQLConsumerContext = {
+    execute: SQLExecutor;
+    connection: {
+        connectionString: string;
+        pool: Dumbo;
+    };
+};
+type ExtendableContext = Partial<PostgreSQLConsumerContext> & DefaultRecord;
+type PostgreSQLEventStoreConsumerConfig<ConsumerMessageType extends Message = any> = MessageConsumerOptions<ConsumerMessageType> & {
+    stopWhen?: {
+        noMessagesLeft?: boolean;
     };
+    pulling?: {
+        batchSize?: number;
+        pullingFrequencyInMs?: number;
+    };
+};
+type PostgreSQLEventStoreConsumerOptions<ConsumerMessageType extends Message = Message> = PostgreSQLEventStoreConsumerConfig<ConsumerMessageType> & {
+    connectionString: string;
+    pool?: Dumbo;
 };
+type PostgreSQLEventStoreConsumer<ConsumerMessageType extends Message = any> = MessageConsumer<ConsumerMessageType> & Readonly<{
+    processor: <MessageType extends Message = ConsumerMessageType>(options: PostgreSQLProcessorOptions<MessageType>) => PostgreSQLProcessor<MessageType>;
+}>;
+declare const postgreSQLEventStoreConsumer: <ConsumerMessageType extends Message = AnyMessage>(options: PostgreSQLEventStoreConsumerOptions<ConsumerMessageType>) => PostgreSQLEventStoreConsumer<ConsumerMessageType>;
 
 type PongoProjectionHandlerContext = PostgreSQLProjectionHandlerContext & {
     pongo: PongoClient;
@@ -74,8 +139,9 @@ type PongoDocumentEvolve<Document extends PongoDocument, EventType extends Event
 type PongoProjectionOptions<EventType extends Event> = {
     handle: (events: ReadEvent<EventType, PostgresReadEventMetadata>[], context: PongoProjectionHandlerContext) => Promise<void>;
     canHandle: CanHandle<EventType>;
+    truncate?: TruncateProjection<PongoProjectionHandlerContext>;
 };
-declare const pongoProjection: <EventType extends Event>({ handle, canHandle, }: PongoProjectionOptions<EventType>) => PostgreSQLProjectionDefinition<EventType>;
+declare const pongoProjection: <EventType extends Event>({ truncate, handle, canHandle, }: PongoProjectionOptions<EventType>) => PostgreSQLProjectionDefinition<EventType>;
 type PongoMultiStreamProjectionOptions<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = {
     canHandle: CanHandle<EventType>;
     collectionName: string;
@@ -99,6 +165,36 @@ type PongoSingleStreamProjectionOptions<Document extends PongoDocument, EventTyp
 });
 declare const pongoSingleStreamProjection: <Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata>(options: PongoSingleStreamProjectionOptions<Document, EventType, EventMetaDataType>) => PostgreSQLProjectionDefinition<EventType>;
 
+type PongoAssertOptions = {
+    inCollection: string;
+    inDatabase?: string;
+};
+type FilterOrId<Doc extends PongoDocument | WithId<PongoDocument>> = {
+    withId: string;
+} | {
+    matchingFilter: PongoFilter<Doc>;
+};
+declare const documentExists: <Doc extends PongoDocument | WithId<PongoDocument>>(document: Doc, options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
+declare const documentsAreTheSame: <Doc extends PongoDocument | WithId<PongoDocument>>(documents: Doc[], options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
+declare const documentsMatchingHaveCount: <Doc extends PongoDocument | WithId<PongoDocument>>(expectedCount: number, options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
+declare const documentMatchingExists: <Doc extends PongoDocument | WithId<PongoDocument>>(options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
+declare const documentDoesNotExist: <Doc extends PongoDocument | WithId<PongoDocument>>(options: PongoAssertOptions & FilterOrId<Doc>) => PostgreSQLProjectionAssert;
+declare const expectPongoDocuments: {
+    fromCollection: <Doc extends PongoDocument | WithId<PongoDocument>>(collectionName: string) => {
+        withId: (id: string) => {
+            toBeEqual: (document: Doc) => PostgreSQLProjectionAssert;
+            toExist: () => PostgreSQLProjectionAssert;
+            notToExist: () => PostgreSQLProjectionAssert;
+        };
+        matching: <Doc_1 extends PongoDocument | WithId<PongoDocument>>(filter: PongoFilter<Doc_1>) => {
+            toBeTheSame: (documents: Doc_1[]) => PostgreSQLProjectionAssert;
+            toHaveCount: (expectedCount: number) => PostgreSQLProjectionAssert;
+            toExist: () => PostgreSQLProjectionAssert;
+            notToExist: () => PostgreSQLProjectionAssert;
+        };
+    };
+};
+
 type PostgreSQLProjectionSpecEvent<EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = EventType & {
     metadata?: Partial<EventMetaDataType>;
 };
@@ -158,135 +254,9 @@ declare const postgreSQLProjection: <EventType extends Event>(definition: Postgr
 declare const postgreSQLRawBatchSQLProjection: <EventType extends Event>(handle: (events: EventType[], context: PostgreSQLProjectionHandlerContext) => Promise<SQL[]> | SQL[], ...canHandle: CanHandle<EventType>) => PostgreSQLProjectionDefinition<EventType>;
 declare const postgreSQLRawSQLProjection: <EventType extends Event>(handle: (event: EventType, context: PostgreSQLProjectionHandlerContext) => Promise<SQL> | SQL, ...canHandle: CanHandle<EventType>) => PostgreSQLProjectionDefinition<EventType>;
 
-type PostgreSQLProcessorEventsBatch<EventType extends Event = Event> = {
-    messages: ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>[];
-};
-type PostgreSQLProcessorHandlerContext = {
-    execute: SQLExecutor;
-    connection: {
-        connectionString: string;
-        client: NodePostgresClient;
-        transaction: NodePostgresTransaction;
-        pool: Dumbo;
-    };
-};
-type PostgreSQLProcessor<EventType extends Event = Event> = {
-    id: string;
-    start: (execute: SQLExecutor) => Promise<PostgreSQLEventStoreMessageBatchPullerStartFrom | undefined>;
-    isActive: boolean;
-    handle: (messagesBatch: PostgreSQLProcessorEventsBatch<EventType>, context: {
-        pool?: Dumbo;
-        connectionString?: string;
-    }) => Promise<PostgreSQLProcessorMessageHandlerResult>;
-};
-declare const PostgreSQLProcessor: {
-    result: {
-        skip: (options?: {
-            reason?: string;
-        }) => PostgreSQLProcessorMessageHandlerResult;
-        stop: (options?: {
-            reason?: string;
-            error?: EmmettError;
-        }) => PostgreSQLProcessorMessageHandlerResult;
-    };
-};
-type PostgreSQLProcessorMessageHandlerResult = void | {
-    type: 'SKIP';
-    reason?: string;
-} | {
-    type: 'STOP';
-    reason?: string;
-    error?: EmmettError;
-};
-type PostgreSQLProcessorEachMessageHandler<EventType extends Event = Event> = (event: ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>, context: PostgreSQLProcessorHandlerContext) => Promise<PostgreSQLProcessorMessageHandlerResult> | PostgreSQLProcessorMessageHandlerResult;
-type PostgreSQLProcessorEachBatchHandler<EventType extends Event = Event> = (event: ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>[], context: PostgreSQLProcessorHandlerContext) => Promise<PostgreSQLProcessorMessageHandlerResult> | PostgreSQLProcessorMessageHandlerResult;
-type PostgreSQLProcessorStartFrom = PostgreSQLEventStoreMessageBatchPullerStartFrom | 'CURRENT';
-type PostgreSQLProcessorPooledOptions = {
-    connector?: NodePostgresConnector;
-    database?: string;
-    pooled: true;
-    pool: pg.Pool;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-    pool: pg.Pool;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-    pooled: true;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-};
-type PostgreSQLProcessorNotPooledOptions = {
-    connector?: NodePostgresConnector;
-    database?: string;
-    pooled: false;
-    client: pg.Client;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-    client: pg.Client;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-    pooled: false;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-    connection: NodePostgresPoolClientConnection | NodePostgresClientConnection;
-    pooled?: false;
-} | {
-    connector?: NodePostgresConnector;
-    database?: string;
-    dumbo: NodePostgresPool;
-    pooled?: false;
-};
-type PostgreSQLProcessorConnectionOptions = {
-    connectionString: string;
-} & (PostgreSQLProcessorPooledOptions | PostgreSQLProcessorNotPooledOptions);
-type GenericPostgreSQLProcessorOptions<EventType extends Event = Event> = {
-    processorId: string;
-    version?: number;
-    partition?: string;
-    startFrom?: PostgreSQLProcessorStartFrom;
-    stopAfter?: (message: ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>) => boolean;
-    eachMessage: PostgreSQLProcessorEachMessageHandler<EventType>;
-    connectionOptions?: PostgreSQLProcessorConnectionOptions;
-};
-type PostgreSQLProjectionProcessorOptions<EventType extends Event = Event> = {
-    processorId?: string;
-    version?: number;
-    projection: PostgreSQLProjectionDefinition<EventType>;
-    partition?: string;
-    startFrom?: PostgreSQLProcessorStartFrom;
-    stopAfter?: (message: ReadEvent<EventType, ReadEventMetadataWithGlobalPosition>) => boolean;
-    connectionOptions?: PostgreSQLProcessorConnectionOptions;
-};
-type PostgreSQLProcessorOptions<EventType extends Event = Event> = GenericPostgreSQLProcessorOptions<EventType> | PostgreSQLProjectionProcessorOptions<EventType>;
-declare const postgreSQLProjectionProcessor: <EventType extends Event = Event>(options: PostgreSQLProjectionProcessorOptions<EventType>) => PostgreSQLProcessor;
-declare const postgreSQLProcessor: <EventType extends Event = Event>(options: PostgreSQLProcessorOptions<EventType>) => PostgreSQLProcessor;
-
-type PostgreSQLEventStoreConsumerConfig<ConsumerEventType extends Event = Event> = {
-    processors?: PostgreSQLProcessor<ConsumerEventType>[];
-    pulling?: {
-        batchSize?: number;
-        pullingFrequencyInMs?: number;
-    };
-};
-type PostgreSQLEventStoreConsumerOptions<ConsumerEventType extends Event = Event> = PostgreSQLEventStoreConsumerConfig<ConsumerEventType> & {
-    connectionString: string;
-    pool?: Dumbo;
-};
-type PostgreSQLEventStoreConsumer<ConsumerEventType extends Event = Event> = Readonly<{
-    isRunning: boolean;
-    processors: PostgreSQLProcessor<ConsumerEventType>[];
-    processor: <EventType extends ConsumerEventType = ConsumerEventType>(options: PostgreSQLProcessorOptions<EventType>) => PostgreSQLProcessor<EventType>;
-    start: () => Promise<void>;
-    stop: () => Promise<void>;
-    close: () => Promise<void>;
-}>;
-declare const postgreSQLEventStoreConsumer: <ConsumerEventType extends Event = Event>(options: PostgreSQLEventStoreConsumerOptions<ConsumerEventType>) => PostgreSQLEventStoreConsumer<ConsumerEventType>;
+declare const rebuildPostgreSQLProjections: <EventType extends AnyEvent = AnyEvent>(options: Omit<PostgreSQLEventStoreConsumerOptions<EventType>, "stopWhen" | "processors"> & ({
+    projections: (ProjectorOptions$1<EventType, ReadEventMetadataWithGlobalPosition$1, PostgreSQLProcessorHandlerContext> | PostgreSQLProjectionDefinition<EventType>)[];
+} | ProjectorOptions$1<EventType, ReadEventMetadataWithGlobalPosition$1, PostgreSQLProcessorHandlerContext>)) => PostgreSQLEventStoreConsumer<EventType>;
 
 interface PostgresEventStore extends EventStore<PostgresReadEventMetadata>, EventStoreSessionFactory<PostgresEventStore> {
     appendToStream<EventType extends Event>(streamName: string, events: EventType[], options?: AppendToStreamOptions): Promise<AppendToStreamResultWithGlobalPosition>;
@@ -399,14 +369,14 @@ type ReadMessagesBatchOptions = {
     from: bigint;
     to: bigint;
 };
-type ReadMessagesBatchResult<EventType extends Event, ReadEventMetadataType extends ReadEventMetadata = ReadEventMetadata> = {
+type ReadMessagesBatchResult<MessageType extends Message, MessageMetadataType extends RecordedMessageMetadata = RecordedMessageMetadata> = {
     currentGlobalPosition: bigint;
-    messages: ReadEvent<EventType, ReadEventMetadataType>[];
-    areEventsLeft: boolean;
+    messages: RecordedMessage<MessageType, MessageMetadataType>[];
+    areMessagesLeft: boolean;
 };
-declare const readMessagesBatch: <MessageType extends Event, ReadEventMetadataType extends ReadEventMetadataWithGlobalPosition = ReadEventMetadataWithGlobalPosition>(execute: SQLExecutor, options: ReadMessagesBatchOptions & {
+declare const readMessagesBatch: <MessageType extends Message, RecordedMessageMetadataType extends RecordedMessageMetadataWithGlobalPosition = RecordedMessageMetadataWithGlobalPosition>(execute: SQLExecutor, options: ReadMessagesBatchOptions & {
     partition?: string;
-}) => Promise<ReadMessagesBatchResult<MessageType, ReadEventMetadataType>>;
+}) => Promise<ReadMessagesBatchResult<MessageType, RecordedMessageMetadataType>>;
 
 type ReadProcessorCheckpointResult = {
     lastProcessedPosition: bigint | null;
@@ -428,20 +398,13 @@ type StoreLastProcessedProcessorPositionResult<Position extends bigint | null =
     success: false;
     reason: 'IGNORED' | 'MISMATCH';
 };
-declare function storeProcessorCheckpoint(execute: SQLExecutor, options: {
-    processorId: string;
-    version: number | undefined;
-    newPosition: bigint | null;
-    lastProcessedPosition: bigint | null;
-    partition?: string;
-}): Promise<StoreLastProcessedProcessorPositionResult<bigint | null>>;
-declare function storeProcessorCheckpoint(execute: SQLExecutor, options: {
+declare const storeProcessorCheckpoint: <Position extends bigint | null>(execute: SQLExecutor, options: {
     processorId: string;
     version: number | undefined;
-    newPosition: bigint;
+    newPosition: null extends Position ? bigint | null : bigint;
     lastProcessedPosition: bigint | null;
     partition?: string;
-}): Promise<StoreLastProcessedProcessorPositionResult<bigint>>;
+}) => Promise<StoreLastProcessedProcessorPositionResult<null extends Position ? bigint | null : bigint>>;
 
 declare const streamsTableSQL: _event_driven_io_dumbo.SQL;
 declare const messagesTableSQL: _event_driven_io_dumbo.SQL;
@@ -492,4 +455,4 @@ declare const subscriptionsTable: {
 declare const schemaSQL: SQL[];
 declare const createEventStoreSchema: (pool: NodePostgresPool) => Promise<void>;
 
-export { type AppendToStreamBeforeCommitHook, DefaultPostgreSQLEventStoreProcessorBatchSize, DefaultPostgreSQLEventStoreProcessorPullingFrequencyInMs, type GenericPostgreSQLProcessorOptions, type PongoAssertOptions, type PongoDocumentEvolve, type PongoMultiStreamProjectionOptions, type PongoProjectionHandlerContext, type PongoProjectionOptions, type PongoSingleStreamProjectionOptions, type PongoWithNotNullDocumentEvolve, type PongoWithNullableDocumentEvolve, type PostgreSQLEventStoreConsumer, type PostgreSQLEventStoreConsumerConfig, type PostgreSQLEventStoreConsumerOptions, PostgreSQLEventStoreDefaultStreamVersion, type PostgreSQLEventStoreMessageBatchPuller, type PostgreSQLEventStoreMessageBatchPullerOptions, type PostgreSQLEventStoreMessageBatchPullerStartFrom, type PostgreSQLEventStoreMessageBatchPullerStartOptions, type PostgreSQLEventStoreMessagesBatch, type PostgreSQLEventStoreMessagesBatchHandler, type PostgreSQLEventStoreMessagesBatchHandlerResult, PostgreSQLProcessor, type PostgreSQLProcessorConnectionOptions, type PostgreSQLProcessorEachBatchHandler, type PostgreSQLProcessorEachMessageHandler, type PostgreSQLProcessorEventsBatch, type PostgreSQLProcessorHandlerContext, type PostgreSQLProcessorMessageHandlerResult, type PostgreSQLProcessorOptions, type PostgreSQLProcessorStartFrom, type PostgreSQLProjectionAssert, type PostgreSQLProjectionDefinition, type PostgreSQLProjectionHandler, type PostgreSQLProjectionHandlerContext, type PostgreSQLProjectionHandlerOptions, type PostgreSQLProjectionProcessorOptions, PostgreSQLProjectionSpec, type PostgreSQLProjectionSpecEvent, type PostgreSQLProjectionSpecOptions, type PostgreSQLProjectionSpecWhenOptions, type PostgresEventStore, type PostgresEventStoreConnectionOptions, type PostgresEventStoreOptions, type PostgresReadEvent, type PostgresReadEventMetadata, type ReadLastMessageGlobalPositionResult, type ReadMessagesBatchOptions, type ReadMessagesBatchResult, type ReadProcessorCheckpointResult, type StoreLastProcessedProcessorPositionResult, addDefaultPartitionSQL, addModuleForAllTenantsSQL, addModuleSQL, addPartitionSQL, addTablePartitions, addTenantForAllModulesSQL, addTenantSQL, appendToStream, appendToStreamSQL, assertSQLQueryResultMatches, createEventStoreSchema, defaultPostgreSQLOptions, defaultTag, documentDoesNotExist, documentExists, documentMatchingExists, documentsAreTheSame, documentsMatchingHaveCount, emmettPrefix, eventInStream, eventsInStream, expectPongoDocuments, expectSQL, getPostgreSQLEventStore, globalNames, globalTag, handleProjections, messagesTable, messagesTableSQL, migrationFromEventsToMessagesSQL, newEventsInStream, pongoMultiStreamProjection, pongoProjection, pongoSingleStreamProjection, postgreSQLEventStoreConsumer, postgreSQLEventStoreMessageBatchPuller, postgreSQLProcessor, postgreSQLProjection, postgreSQLProjectionProcessor, postgreSQLRawBatchSQLProjection, postgreSQLRawSQLProjection, readLastMessageGlobalPosition, readMessagesBatch, readProcessorCheckpoint, readStream, sanitizeNameSQL, schemaSQL, storeProcessorCheckpoint, storeSubscriptionCheckpointSQL, streamsTable, streamsTableSQL, subscriptionsTable, subscriptionsTableSQL, zipPostgreSQLEventStoreMessageBatchPullerStartFrom };
+export { type AppendToStreamBeforeCommitHook, DefaultPostgreSQLEventStoreProcessorBatchSize, DefaultPostgreSQLEventStoreProcessorPullingFrequencyInMs, type ExtendableContext, type PongoAssertOptions, type PongoDocumentEvolve, type PongoMultiStreamProjectionOptions, type PongoProjectionHandlerContext, type PongoProjectionOptions, type PongoSingleStreamProjectionOptions, type PongoWithNotNullDocumentEvolve, type PongoWithNullableDocumentEvolve, type PostgreSQLCheckpointer, type PostgreSQLConsumerContext, type PostgreSQLEventStoreConsumer, type PostgreSQLEventStoreConsumerConfig, type PostgreSQLEventStoreConsumerOptions, PostgreSQLEventStoreDefaultStreamVersion, type PostgreSQLEventStoreMessageBatchPuller, type PostgreSQLEventStoreMessageBatchPullerOptions, type PostgreSQLEventStoreMessageBatchPullerStartFrom, type PostgreSQLEventStoreMessageBatchPullerStartOptions, type PostgreSQLEventStoreMessagesBatchHandlerResult, type PostgreSQLProcessor, type PostgreSQLProcessorConnectionOptions, type PostgreSQLProcessorEachBatchHandler, type PostgreSQLProcessorEachMessageHandler, type PostgreSQLProcessorHandlerContext, type PostgreSQLProcessorOptions, type PostgreSQLProcessorStartFrom, type PostgreSQLProjectionAssert, type PostgreSQLProjectionDefinition, type PostgreSQLProjectionHandler, type PostgreSQLProjectionHandlerContext, type PostgreSQLProjectionHandlerOptions, PostgreSQLProjectionSpec, type PostgreSQLProjectionSpecEvent, type PostgreSQLProjectionSpecOptions, type PostgreSQLProjectionSpecWhenOptions, type PostgreSQLProjectorOptions, type PostgresEventStore, type PostgresEventStoreConnectionOptions, type PostgresEventStoreOptions, type PostgresReadEvent, type PostgresReadEventMetadata, type ReadLastMessageGlobalPositionResult, type ReadMessagesBatchOptions, type ReadMessagesBatchResult, type ReadProcessorCheckpointResult, type StoreLastProcessedProcessorPositionResult, addDefaultPartitionSQL, addModuleForAllTenantsSQL, addModuleSQL, addPartitionSQL, addTablePartitions, addTenantForAllModulesSQL, addTenantSQL, appendToStream, appendToStreamSQL, assertSQLQueryResultMatches, createEventStoreSchema, defaultPostgreSQLOptions, defaultTag, documentDoesNotExist, documentExists, documentMatchingExists, documentsAreTheSame, documentsMatchingHaveCount, emmettPrefix, eventInStream, eventsInStream, expectPongoDocuments, expectSQL, getPostgreSQLEventStore, globalNames, globalTag, handleProjections, messagesTable, messagesTableSQL, migrationFromEventsToMessagesSQL, newEventsInStream, pongoMultiStreamProjection, pongoProjection, pongoSingleStreamProjection, postgreSQLCheckpointer, postgreSQLEventStoreConsumer, postgreSQLEventStoreMessageBatchPuller, postgreSQLMessageProcessor, postgreSQLProjection, postgreSQLProjector, postgreSQLRawBatchSQLProjection, postgreSQLRawSQLProjection, postgreSQLReactor, readLastMessageGlobalPosition, readMessagesBatch, readProcessorCheckpoint, readStream, rebuildPostgreSQLProjections, sanitizeNameSQL, schemaSQL, storeProcessorCheckpoint, storeSubscriptionCheckpointSQL, streamsTable, streamsTableSQL, subscriptionsTable, subscriptionsTableSQL, zipPostgreSQLEventStoreMessageBatchPullerStartFrom };