@event-driven-io/emmett-postgresql 0.43.0-beta.1 → 0.43.0-beta.11

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { SQLExecutor, SQL, SQLMigration, RunSQLMigrationsResult, MigrationStyle, Dumbo, QueryResultRow, DatabaseTransaction, AnyConnection } from '@event-driven-io/dumbo';
+import { SQLExecutor, Dumbo, QueryResultRow, SQL, RunSQLMigrationsResult, SQLMigration, DatabaseTransaction, AnyConnection, MigrationStyle } from '@event-driven-io/dumbo';
 import * as _event_driven_io_emmett from '@event-driven-io/emmett';
-import { EmmettError, Message, BatchRecordedMessageHandlerWithoutContext, ReadEventMetadataWithGlobalPosition, ProcessorCheckpoint, ProjectionHandlingType, AnyReadEventMetadata, DefaultRecord, ProjectionRegistration, ProjectionDefinition, RecordedMessage, AppendToStreamOptions, RecordedMessageMetadata, RecordedMessageMetadataWithGlobalPosition, Event, ReadStreamOptions, ReadStreamResult, StreamExistsResult, EventStore, EventStoreSessionFactory, AppendToStreamResultWithGlobalPosition, ReadEvent, CanHandle, TruncateProjection, EventStoreReadSchemaOptions, ThenThrows, ProjectionHandler, ProjectionInitOptions, AnyMessage, ReactorOptions, MessageProcessor, AnyEvent, ProjectorOptions, SingleRecordedMessageHandlerWithContext, BatchRecordedMessageHandlerWithContext, Checkpointer, MessageConsumerOptions, MessageConsumer } from '@event-driven-io/emmett';
-import { PgTransaction, PgPool, PgDriverType, PgPoolClientConnection, PgClientConnection, PgPoolOptions, PgClient } from '@event-driven-io/dumbo/pg';
+import { ProcessorCheckpoint, Message, BatchRecordedMessageHandlerWithoutContext, ReadEventMetadataWithGlobalPosition, EmmettError, ProjectionHandlingType, ProjectionRegistration, ProjectionDefinition, AnyReadEventMetadata, DefaultRecord, Event, ReadEvent, CanHandle, EventStoreReadSchemaOptions, JSONSerializationOptions, TruncateProjection, ThenThrows, RecordedMessage, AppendToStreamOptions, RecordedMessageMetadata, RecordedMessageMetadataWithGlobalPosition, ReadStreamOptions, ReadStreamResult, StreamExistsResult, ProjectionHandler, ProjectionInitOptions, EventStore, EventStoreSessionFactory, AppendToStreamResultWithGlobalPosition, AnyMessage, Checkpointer, ReactorOptions, MessageProcessor, AnyEvent, AnyCommand, AnyRecordedMessageMetadata, WorkflowProcessorContext, WorkflowProcessorOptions, ProjectorOptions, BatchRecordedMessageHandlerWithContext, SingleRecordedMessageHandlerWithContext, MessageConsumerOptions, MessageConsumer } from '@event-driven-io/emmett';
+import { PgPoolOptions, PgTransaction, PgPool, PgClient, PgDriverType, PgPoolClientConnection, PgClientConnection } from '@event-driven-io/dumbo/pg';
 import pg from 'pg';
-import { PongoClient, PongoDocument, PongoDBCollectionOptions, WithId, PongoFilter } from '@event-driven-io/pongo';
+import { PongoDocument, PongoDBCollectionOptions, PongoClient, WithId, PongoFilter } from '@event-driven-io/pongo';
 
 declare const DefaultPostgreSQLEventStoreProcessorBatchSize = 100;
 declare const DefaultPostgreSQLEventStoreProcessorPullingFrequencyInMs = 50;
@@ -148,6 +148,123 @@ declare const readProjectionInfo: (execute: SQLExecutor, { name, partition, vers
     version: number;
 }) => Promise<ReadProjectionInfoResult | null>;
 
+type PongoProjectionHandlerContext = PostgreSQLProjectionHandlerContext & {
+    pongo: PongoClient;
+};
+type PongoWithNotNullDocumentEvolve<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = ((document: Document, event: ReadEvent<EventType, EventMetaDataType>) => Document | null) | ((document: Document, event: ReadEvent<EventType>) => Promise<Document | null>);
+type PongoWithNullableDocumentEvolve<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = ((document: Document | null, event: ReadEvent<EventType, EventMetaDataType>) => Document | null) | ((document: Document | null, event: ReadEvent<EventType>) => Promise<Document | null>);
+type PongoDocumentEvolve<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = PongoWithNotNullDocumentEvolve<Document, EventType, EventMetaDataType> | PongoWithNullableDocumentEvolve<Document, EventType, EventMetaDataType>;
+type PongoProjectionOptions<EventType extends Event, EventPayloadType extends Event = EventType> = {
+    name: string;
+    kind?: string;
+    version?: number;
+    handle: (events: ReadEvent<EventType, PostgresReadEventMetadata>[], context: PongoProjectionHandlerContext) => Promise<void>;
+    canHandle: CanHandle<EventType>;
+    truncate?: TruncateProjection<PongoProjectionHandlerContext>;
+    init?: (context: PongoProjectionHandlerContext) => void | Promise<void>;
+    eventsOptions?: {
+        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
+    };
+} & JSONSerializationOptions;
+declare const pongoProjection: <EventType extends Event, EventPayloadType extends Event = EventType>({ name, kind, version, truncate, handle, canHandle, eventsOptions, }: PongoProjectionOptions<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
+type PongoMultiStreamProjectionOptions<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType, DocumentPayload extends PongoDocument = Document> = {
+    kind?: string;
+    canHandle: CanHandle<EventType>;
+    version?: number;
+    collectionName: string;
+    collectionOptions?: PongoDBCollectionOptions<Document, DocumentPayload>;
+    eventsOptions?: {
+        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
+    };
+    getDocumentId: (event: ReadEvent<EventType>) => string;
+} & ({
+    evolve: PongoWithNullableDocumentEvolve<Document, EventType, EventMetaDataType>;
+} | {
+    evolve: PongoWithNotNullDocumentEvolve<Document, EventType, EventMetaDataType>;
+    initialState: () => Document;
+}) & JSONSerializationOptions;
+declare const pongoMultiStreamProjection: <Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType>(options: PongoMultiStreamProjectionOptions<Document, EventType, EventMetaDataType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
+type PongoSingleStreamProjectionOptions<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType, DocumentPayload extends PongoDocument = Document> = {
+    canHandle: CanHandle<EventType>;
+    getDocumentId?: (event: ReadEvent<EventType>) => string;
+    version?: number;
+    collectionName: string;
+    collectionOptions?: PongoDBCollectionOptions<Document, DocumentPayload>;
+    eventsOptions?: {
+        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
+    };
+} & ({
+    evolve: PongoWithNullableDocumentEvolve<Document, EventType, EventMetaDataType>;
+} | {
+    evolve: PongoWithNotNullDocumentEvolve<Document, EventType, EventMetaDataType>;
+    initialState: () => Document;
+}) & JSONSerializationOptions;
+declare const pongoSingleStreamProjection: <Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType>(options: PongoSingleStreamProjectionOptions<Document, EventType, EventMetaDataType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
+
+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>;
+};
+type PostgreSQLProjectionSpecWhenOptions = {
+    numberOfTimes: number;
+};
+type PostgreSQLProjectionAssert = (options: {
+    pool: Dumbo;
+    connectionString: string;
+}) => Promise<void | boolean>;
+type PostgreSQLProjectionSpecOptions<EventType extends Event> = {
+    projection: PostgreSQLProjectionDefinition<EventType>;
+} & PgPoolOptions;
+type PostgreSQLProjectionSpec<EventType extends Event> = (givenEvents: PostgreSQLProjectionSpecEvent<EventType>[]) => {
+    when: (events: PostgreSQLProjectionSpecEvent<EventType>[], options?: PostgreSQLProjectionSpecWhenOptions) => {
+        then: (assert: PostgreSQLProjectionAssert, message?: string) => Promise<void>;
+        thenThrows: <ErrorType extends Error = Error>(...args: Parameters<ThenThrows<ErrorType>>) => Promise<void>;
+    };
+};
+declare const PostgreSQLProjectionSpec: {
+    for: <EventType extends Event>(options: PostgreSQLProjectionSpecOptions<EventType>) => PostgreSQLProjectionSpec<EventType>;
+};
+declare const eventInStream: <EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata>(streamName: string, event: PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>) => PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>;
+declare const eventsInStream: <EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata>(streamName: string, events: PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[]) => PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[];
+declare const newEventsInStream: <EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = _event_driven_io_emmett.RecordedMessageMetadataWithGlobalPosition>(streamName: string, events: PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[]) => PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[];
+declare const assertSQLQueryResultMatches: <T extends QueryResultRow>(sql: SQL, rows: T[]) => PostgreSQLProjectionAssert;
+declare const expectSQL: {
+    query: (sql: SQL) => {
+        resultRows: {
+            toBeTheSame: <T extends QueryResultRow>(rows: T[]) => PostgreSQLProjectionAssert;
+        };
+    };
+};
+
 declare const emmettPrefix = "emt";
 declare const globalTag = "global";
 declare const defaultTag = "emt:default";
@@ -372,12 +489,56 @@ type CreateEventStoreSchemaOptions = {
     dryRun?: boolean | undefined;
     ignoreMigrationHashMismatch?: boolean | undefined;
     migrationTimeoutMs?: number | undefined;
-};
+} & JSONSerializationOptions;
 type EventStoreSchemaMigrationOptions = {
     migrationOptions?: CreateEventStoreSchemaOptions;
 };
 declare const createEventStoreSchema: (connectionString: string, pool: PgPool, hooks?: PostgresEventStoreOptions["hooks"], options?: CreateEventStoreSchemaOptions) => Promise<RunSQLMigrationsResult>;
 
+type PostgreSQLProjectionHandlerContext = {
+    execute: SQLExecutor;
+    connection: {
+        connectionString: string;
+        client: PgClient;
+        transaction: PgTransaction;
+        pool: Dumbo;
+    };
+} & EventStoreSchemaMigrationOptions;
+declare const transactionToPostgreSQLProjectionHandlerContext: (connectionString: string, pool: Dumbo, transaction: PgTransaction | DatabaseTransaction<AnyConnection>) => Promise<PostgreSQLProjectionHandlerContext>;
+type PostgreSQLProjectionHandler<EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = ProjectionHandler<EventType, EventMetaDataType, PostgreSQLProjectionHandlerContext>;
+type PostgreSQLProjectionDefinition<EventType extends Event = Event, EventPayloadType extends Event = EventType> = ProjectionDefinition<EventType, PostgresReadEventMetadata, PostgreSQLProjectionHandlerContext, EventPayloadType>;
+type PostgreSQLProjectionHandlerOptions<EventType extends Event = Event> = {
+    events: ReadEvent<EventType, PostgresReadEventMetadata>[];
+    projections: PostgreSQLProjectionDefinition<EventType>[];
+    partition?: string;
+} & PostgreSQLProjectionHandlerContext;
+declare const handleProjections: <EventType extends Event = Event>(options: PostgreSQLProjectionHandlerOptions<EventType>) => Promise<void>;
+declare const postgreSQLProjection: <EventType extends Event, EventPayloadType extends Event = EventType>(definition: PostgreSQLProjectionDefinition<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
+type PostgreSQLRawBatchSQLProjection<EventType extends Event, EventPayloadType extends Event = EventType> = {
+    name: string;
+    kind?: string;
+    version?: number;
+    evolve: (events: EventType[], context: PostgreSQLProjectionHandlerContext) => Promise<SQL[]> | SQL[];
+    canHandle: CanHandle<EventType>;
+    init?: (context: ProjectionInitOptions<PostgreSQLProjectionHandlerContext>) => void | Promise<void> | SQL | Promise<SQL> | Promise<SQL[]> | SQL[];
+    eventsOptions?: {
+        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
+    };
+} & JSONSerializationOptions;
+declare const postgreSQLRawBatchSQLProjection: <EventType extends Event, EventPayloadType extends Event = EventType>(options: PostgreSQLRawBatchSQLProjection<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
+type PostgreSQLRawSQLProjection<EventType extends Event, EventPayloadType extends Event = EventType> = {
+    name: string;
+    kind?: string;
+    version?: number;
+    evolve: (events: EventType, context: PostgreSQLProjectionHandlerContext) => Promise<SQL[]> | SQL[] | Promise<SQL> | SQL;
+    canHandle: CanHandle<EventType>;
+    init?: (context: ProjectionInitOptions<PostgreSQLProjectionHandlerContext>) => void | Promise<void> | SQL | Promise<SQL> | Promise<SQL[]> | SQL[];
+    eventsOptions?: {
+        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
+    };
+} & JSONSerializationOptions;
+declare const postgreSQLRawSQLProjection: <EventType extends Event, EventPayloadType extends Event = EventType>(options: PostgreSQLRawSQLProjection<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
+
 interface PostgresEventStore extends EventStore<PostgresReadEventMetadata>, EventStoreSessionFactory<PostgresEventStore> {
     appendToStream<EventType extends Event, EventPayloadType extends Event = EventType>(streamName: string, events: EventType[], options?: AppendToStreamOptions<EventType, EventPayloadType>): Promise<AppendToStreamResultWithGlobalPosition>;
     consumer<ConsumerEventType extends Event = Event>(options?: PostgreSQLEventStoreConsumerConfig<ConsumerEventType>): PostgreSQLEventStoreConsumer<ConsumerEventType>;
@@ -464,172 +625,11 @@ type PostgresEventStoreOptions = {
          */
         onAfterSchemaCreated?: (context: PostgreSQLProjectionHandlerContext) => Promise<void> | void;
     };
-};
+} & JSONSerializationOptions;
 declare const defaultPostgreSQLOptions: PostgresEventStoreOptions;
 declare const PostgreSQLEventStoreDefaultStreamVersion = 0n;
 declare const getPostgreSQLEventStore: (connectionString: string, options?: PostgresEventStoreOptions) => PostgresEventStore;
 
-type PongoProjectionHandlerContext = PostgreSQLProjectionHandlerContext & {
-    pongo: PongoClient;
-};
-type PongoWithNotNullDocumentEvolve<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = ((document: Document, event: ReadEvent<EventType, EventMetaDataType>) => Document | null) | ((document: Document, event: ReadEvent<EventType>) => Promise<Document | null>);
-type PongoWithNullableDocumentEvolve<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = ((document: Document | null, event: ReadEvent<EventType, EventMetaDataType>) => Document | null) | ((document: Document | null, event: ReadEvent<EventType>) => Promise<Document | null>);
-type PongoDocumentEvolve<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = PongoWithNotNullDocumentEvolve<Document, EventType, EventMetaDataType> | PongoWithNullableDocumentEvolve<Document, EventType, EventMetaDataType>;
-type PongoProjectionOptions<EventType extends Event, EventPayloadType extends Event = EventType> = {
-    name: string;
-    kind?: string;
-    version?: number;
-    handle: (events: ReadEvent<EventType, PostgresReadEventMetadata>[], context: PongoProjectionHandlerContext) => Promise<void>;
-    canHandle: CanHandle<EventType>;
-    truncate?: TruncateProjection<PongoProjectionHandlerContext>;
-    init?: (context: PongoProjectionHandlerContext) => void | Promise<void>;
-    eventsOptions?: {
-        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
-    };
-};
-declare const pongoProjection: <EventType extends Event, EventPayloadType extends Event = EventType>({ name, kind, version, truncate, handle, canHandle, eventsOptions, }: PongoProjectionOptions<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
-type PongoMultiStreamProjectionOptions<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType, DocumentPayload extends PongoDocument = Document> = {
-    kind?: string;
-    canHandle: CanHandle<EventType>;
-    version?: number;
-    collectionName: string;
-    collectionOptions?: PongoDBCollectionOptions<Document, DocumentPayload>;
-    eventsOptions?: {
-        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
-    };
-    getDocumentId: (event: ReadEvent<EventType>) => string;
-} & ({
-    evolve: PongoWithNullableDocumentEvolve<Document, EventType, EventMetaDataType>;
-} | {
-    evolve: PongoWithNotNullDocumentEvolve<Document, EventType, EventMetaDataType>;
-    initialState: () => Document;
-});
-declare const pongoMultiStreamProjection: <Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType>(options: PongoMultiStreamProjectionOptions<Document, EventType, EventMetaDataType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
-type PongoSingleStreamProjectionOptions<Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType, DocumentPayload extends PongoDocument = Document> = {
-    canHandle: CanHandle<EventType>;
-    getDocumentId?: (event: ReadEvent<EventType>) => string;
-    version?: number;
-    collectionName: string;
-    collectionOptions?: PongoDBCollectionOptions<Document, DocumentPayload>;
-    eventsOptions?: {
-        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
-    };
-} & ({
-    evolve: PongoWithNullableDocumentEvolve<Document, EventType, EventMetaDataType>;
-} | {
-    evolve: PongoWithNotNullDocumentEvolve<Document, EventType, EventMetaDataType>;
-    initialState: () => Document;
-});
-declare const pongoSingleStreamProjection: <Document extends PongoDocument, EventType extends Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata, EventPayloadType extends Event = EventType>(options: PongoSingleStreamProjectionOptions<Document, EventType, EventMetaDataType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
-
-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>;
-};
-type PostgreSQLProjectionSpecWhenOptions = {
-    numberOfTimes: number;
-};
-type PostgreSQLProjectionAssert = (options: {
-    pool: Dumbo;
-    connectionString: string;
-}) => Promise<void | boolean>;
-type PostgreSQLProjectionSpecOptions<EventType extends Event> = {
-    projection: PostgreSQLProjectionDefinition<EventType>;
-} & PgPoolOptions;
-type PostgreSQLProjectionSpec<EventType extends Event> = (givenEvents: PostgreSQLProjectionSpecEvent<EventType>[]) => {
-    when: (events: PostgreSQLProjectionSpecEvent<EventType>[], options?: PostgreSQLProjectionSpecWhenOptions) => {
-        then: (assert: PostgreSQLProjectionAssert, message?: string) => Promise<void>;
-        thenThrows: <ErrorType extends Error = Error>(...args: Parameters<ThenThrows<ErrorType>>) => Promise<void>;
-    };
-};
-declare const PostgreSQLProjectionSpec: {
-    for: <EventType extends Event>(options: PostgreSQLProjectionSpecOptions<EventType>) => PostgreSQLProjectionSpec<EventType>;
-};
-declare const eventInStream: <EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata>(streamName: string, event: PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>) => PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>;
-declare const eventsInStream: <EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata>(streamName: string, events: PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[]) => PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[];
-declare const newEventsInStream: <EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = _event_driven_io_emmett.RecordedMessageMetadataWithGlobalPosition>(streamName: string, events: PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[]) => PostgreSQLProjectionSpecEvent<EventType, EventMetaDataType>[];
-declare const assertSQLQueryResultMatches: <T extends QueryResultRow>(sql: SQL, rows: T[]) => PostgreSQLProjectionAssert;
-declare const expectSQL: {
-    query: (sql: SQL) => {
-        resultRows: {
-            toBeTheSame: <T extends QueryResultRow>(rows: T[]) => PostgreSQLProjectionAssert;
-        };
-    };
-};
-
-type PostgreSQLProjectionHandlerContext = {
-    execute: SQLExecutor;
-    connection: {
-        connectionString: string;
-        client: PgClient;
-        transaction: PgTransaction;
-        pool: Dumbo;
-    };
-} & EventStoreSchemaMigrationOptions;
-declare const transactionToPostgreSQLProjectionHandlerContext: (connectionString: string, pool: Dumbo, transaction: PgTransaction | DatabaseTransaction<AnyConnection>) => Promise<PostgreSQLProjectionHandlerContext>;
-type PostgreSQLProjectionHandler<EventType extends Event = Event, EventMetaDataType extends PostgresReadEventMetadata = PostgresReadEventMetadata> = ProjectionHandler<EventType, EventMetaDataType, PostgreSQLProjectionHandlerContext>;
-type PostgreSQLProjectionDefinition<EventType extends Event = Event, EventPayloadType extends Event = EventType> = ProjectionDefinition<EventType, PostgresReadEventMetadata, PostgreSQLProjectionHandlerContext, EventPayloadType>;
-type PostgreSQLProjectionHandlerOptions<EventType extends Event = Event> = {
-    events: ReadEvent<EventType, PostgresReadEventMetadata>[];
-    projections: PostgreSQLProjectionDefinition<EventType>[];
-    partition?: string;
-} & PostgreSQLProjectionHandlerContext;
-declare const handleProjections: <EventType extends Event = Event>(options: PostgreSQLProjectionHandlerOptions<EventType>) => Promise<void>;
-declare const postgreSQLProjection: <EventType extends Event, EventPayloadType extends Event = EventType>(definition: PostgreSQLProjectionDefinition<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
-type PostgreSQLRawBatchSQLProjection<EventType extends Event, EventPayloadType extends Event = EventType> = {
-    name: string;
-    kind?: string;
-    version?: number;
-    evolve: (events: EventType[], context: PostgreSQLProjectionHandlerContext) => Promise<SQL[]> | SQL[];
-    canHandle: CanHandle<EventType>;
-    init?: (context: ProjectionInitOptions<PostgreSQLProjectionHandlerContext>) => void | Promise<void> | SQL | Promise<SQL> | Promise<SQL[]> | SQL[];
-    eventsOptions?: {
-        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
-    };
-};
-declare const postgreSQLRawBatchSQLProjection: <EventType extends Event, EventPayloadType extends Event = EventType>(options: PostgreSQLRawBatchSQLProjection<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
-type PostgreSQLRawSQLProjection<EventType extends Event, EventPayloadType extends Event = EventType> = {
-    name: string;
-    kind?: string;
-    version?: number;
-    evolve: (events: EventType, context: PostgreSQLProjectionHandlerContext) => Promise<SQL[]> | SQL[] | Promise<SQL> | SQL;
-    canHandle: CanHandle<EventType>;
-    init?: (context: ProjectionInitOptions<PostgreSQLProjectionHandlerContext>) => void | Promise<void> | SQL | Promise<SQL> | Promise<SQL[]> | SQL[];
-    eventsOptions?: {
-        schema?: EventStoreReadSchemaOptions<EventType, EventPayloadType>;
-    };
-};
-declare const postgreSQLRawSQLProjection: <EventType extends Event, EventPayloadType extends Event = EventType>(options: PostgreSQLRawSQLProjection<EventType, EventPayloadType>) => PostgreSQLProjectionDefinition<EventType, EventPayloadType>;
-
 type PostgreSQLProcessorHandlerContext = {
     partition: string;
     execute: SQLExecutor;
@@ -638,6 +638,7 @@ type PostgreSQLProcessorHandlerContext = {
         client: PgClient;
         transaction: PgTransaction;
         pool: Dumbo;
+        messageStore: PostgresEventStore;
     };
 } & EventStoreSchemaMigrationOptions;
 type PostgreSQLProcessor<MessageType extends Message = AnyMessage> = MessageProcessor<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext>;
@@ -692,7 +693,7 @@ type PostgreSQLCheckpointer<MessageType extends AnyMessage = AnyMessage> = Check
 declare const postgreSQLCheckpointer: <MessageType extends Message = Message>() => PostgreSQLCheckpointer<MessageType>;
 type PostgreSQLConnectionOptions = {
     connectionOptions?: PostgreSQLProcessorConnectionOptions;
-};
+} & JSONSerializationOptions;
 type PostgreSQLProcessorOptionsBase = PostgreSQLConnectionOptions & {
     lock?: {
         acquisitionPolicy?: LockAcquisitionPolicy;
@@ -702,8 +703,9 @@ type PostgreSQLProcessorOptionsBase = PostgreSQLConnectionOptions & {
 };
 type PostgreSQLReactorOptions<MessageType extends Message = Message, MessagePayloadType extends AnyMessage = MessageType> = ReactorOptions<MessageType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext, MessagePayloadType> & PostgreSQLProcessorOptionsBase;
 type PostgreSQLProjectorOptions<EventType extends AnyEvent = AnyEvent, EventPayloadType extends Event = EventType> = ProjectorOptions<EventType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext, EventPayloadType> & PostgreSQLProcessorOptionsBase & EventStoreSchemaMigrationOptions;
-type PostgreSQLProcessorOptions<MessageType extends AnyMessage = AnyMessage, MessagePayloadType extends AnyMessage = MessageType> = PostgreSQLReactorOptions<MessageType, MessagePayloadType> | PostgreSQLProjectorOptions<MessageType & AnyEvent, MessagePayloadType & AnyEvent>;
+type PostgreSQLWorkflowProcessorOptions<Input extends AnyEvent | AnyCommand, State, Output extends AnyEvent | AnyCommand, MetaDataType extends AnyRecordedMessageMetadata = AnyRecordedMessageMetadata, HandlerContext extends WorkflowProcessorContext = WorkflowProcessorContext, StoredMessage extends AnyEvent | AnyCommand = Output> = WorkflowProcessorOptions<Input, State, Output, MetaDataType, HandlerContext, StoredMessage> & PostgreSQLProcessorOptionsBase;
 declare const postgreSQLProjector: <EventType extends Event = Event, EventPayloadType extends Event = EventType>(options: PostgreSQLProjectorOptions<EventType, EventPayloadType>) => PostgreSQLProcessor<EventType>;
+declare const postgreSQLWorkflowProcessor: <Input extends AnyEvent | AnyCommand, State, Output extends AnyEvent | AnyCommand, MetaDataType extends AnyRecordedMessageMetadata = AnyRecordedMessageMetadata, HandlerContext extends PostgreSQLProcessorHandlerContext & WorkflowProcessorContext = PostgreSQLProcessorHandlerContext & WorkflowProcessorContext, StoredMessage extends AnyEvent | AnyCommand = Output>(options: PostgreSQLWorkflowProcessorOptions<Input, State, Output, MetaDataType, HandlerContext, StoredMessage>) => PostgreSQLProcessor<Input | Output>;
 declare const postgreSQLReactor: <MessageType extends Message = Message, MessagePayloadType extends AnyMessage = MessageType>(options: PostgreSQLReactorOptions<MessageType, MessagePayloadType>) => PostgreSQLProcessor<MessageType>;
 
 type PostgreSQLEventStoreConsumerConfig<ConsumerMessageType extends Message = any> = MessageConsumerOptions<ConsumerMessageType> & {
@@ -714,13 +716,14 @@ type PostgreSQLEventStoreConsumerConfig<ConsumerMessageType extends Message = an
         batchSize?: number;
         pullingFrequencyInMs?: number;
     };
-};
+} & JSONSerializationOptions;
 type PostgreSQLEventStoreConsumerOptions<ConsumerMessageType extends Message = Message> = PostgreSQLEventStoreConsumerConfig<ConsumerMessageType> & {
     connectionString: string;
     pool?: Dumbo;
 };
 type PostgreSQLEventStoreConsumer<ConsumerMessageType extends AnyMessage = any> = MessageConsumer<ConsumerMessageType> & Readonly<{
     reactor: <MessageType extends AnyMessage = ConsumerMessageType>(options: PostgreSQLReactorOptions<MessageType>) => PostgreSQLProcessor<MessageType>;
+    workflowProcessor: <Input extends AnyEvent | AnyCommand, State, Output extends AnyEvent | AnyCommand, MetaDataType extends AnyRecordedMessageMetadata = AnyRecordedMessageMetadata, HandlerContext extends PostgreSQLProcessorHandlerContext & WorkflowProcessorContext = PostgreSQLProcessorHandlerContext & WorkflowProcessorContext, StoredMessage extends AnyEvent | AnyCommand = Output>(options: PostgreSQLWorkflowProcessorOptions<Input, State, Output, MetaDataType, HandlerContext, StoredMessage>) => PostgreSQLProcessor<Input | Output>;
 }> & (AnyEvent extends ConsumerMessageType ? Readonly<{
     projector: <EventType extends AnyEvent = ConsumerMessageType & AnyEvent>(options: PostgreSQLProjectorOptions<EventType>) => PostgreSQLProcessor<EventType>;
 }> : object);
@@ -728,7 +731,6 @@ declare const postgreSQLEventStoreConsumer: <ConsumerMessageType extends Message
 
 declare const rebuildPostgreSQLProjections: <EventType extends AnyEvent = AnyEvent>(options: Omit<PostgreSQLEventStoreConsumerOptions<EventType>, "stopWhen" | "processors"> & {
     lock?: {
-        lockAcquisitionPolicy?: LockAcquisitionPolicy;
         acquisitionPolicy?: LockAcquisitionPolicy;
         timeoutSeconds?: number;
     };
@@ -736,4 +738,4 @@ declare const rebuildPostgreSQLProjections: <EventType extends AnyEvent = AnyEve
     projections: (ProjectorOptions<EventType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext> | PostgreSQLProjectionDefinition<EventType>)[];
 } | ProjectorOptions<EventType, ReadEventMetadataWithGlobalPosition, PostgreSQLProcessorHandlerContext>)) => PostgreSQLEventStoreConsumer<EventType>;
 
-export { type AppendToStreamBeforeCommitHook, type CreateEventStoreSchemaOptions, DefaultPostgreSQLEventStoreProcessorBatchSize, DefaultPostgreSQLEventStoreProcessorPullingFrequencyInMs, DefaultPostgreSQLProcessorLockPolicy, type EventStoreSchemaMigrationOptions, type LockAcquisitionPolicy, type PongoAssertOptions, type PongoDocumentEvolve, type PongoMultiStreamProjectionOptions, type PongoProjectionHandlerContext, type PongoProjectionOptions, type PongoSingleStreamProjectionOptions, type PongoWithNotNullDocumentEvolve, type PongoWithNullableDocumentEvolve, type PostgreSQLCheckpointer, 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 PostgreSQLProcessorLock, type PostgreSQLProcessorLockContext, type PostgreSQLProcessorLockOptions, type PostgreSQLProcessorOptions, type PostgreSQLProcessorStartFrom, type PostgreSQLProjectionAssert, type PostgreSQLProjectionDefinition, type PostgreSQLProjectionHandler, type PostgreSQLProjectionHandlerContext, type PostgreSQLProjectionHandlerOptions, type PostgreSQLProjectionLock, type PostgreSQLProjectionLockContext, type PostgreSQLProjectionLockOptions, PostgreSQLProjectionSpec, type PostgreSQLProjectionSpecEvent, type PostgreSQLProjectionSpecOptions, type PostgreSQLProjectionSpecWhenOptions, type PostgreSQLProjectorOptions, type PostgreSQLRawBatchSQLProjection, type PostgreSQLRawSQLProjection, type PostgreSQLReactorOptions, type PostgresEventStore, type PostgresEventStoreConnectionOptions, type PostgresEventStoreOptions, type PostgresReadEvent, type PostgresReadEventMetadata, type PostgresStreamExistsOptions, type ReadLastMessageGlobalPositionResult, type ReadMessagesBatchOptions, type ReadMessagesBatchResult, type ReadProcessorCheckpointResult, type ReadProjectionInfoResult, type StoreProcessorCheckpointResult, activateProjection, activateProjectionSQL, addDefaultPartitionSQL, addModuleForAllTenantsSQL, addModuleSQL, addPartitionSQL, addTablePartitions, addTenantForAllModulesSQL, addTenantSQL, appendToStream, appendToStreamSQL, assertSQLQueryResultMatches, callActivateProjection, callAppendToStream, callDeactivateProjection, callRegisterProjection, callReleaseProcessorLock, callStoreProcessorCheckpoint, callTryAcquireProcessorLock, callTryAcquireProjectionLock, cleanupLegacySubscriptionTables, createEventStoreSchema, deactivateProjection, deactivateProjectionSQL, defaultPostgreSQLOptions, defaultTag, documentDoesNotExist, documentExists, documentMatchingExists, documentsAreTheSame, documentsMatchingHaveCount, emmettPrefix, eventInStream, eventStoreSchemaMigrations, eventsInStream, expectPongoDocuments, expectSQL, getPostgreSQLEventStore, globalNames, globalTag, handleProjections, messagesTable, messagesTableSQL, newEventsInStream, pongoMultiStreamProjection, pongoProjection, pongoSingleStreamProjection, postgreSQLCheckpointer, postgreSQLEventStoreConsumer, postgreSQLEventStoreMessageBatchPuller, postgreSQLProcessorLock, postgreSQLProjection, postgreSQLProjectionLock, postgreSQLProjector, postgreSQLRawBatchSQLProjection, postgreSQLRawSQLProjection, postgreSQLReactor, processorsTable, processorsTableSQL, projectionsTable, projectionsTableSQL, readLastMessageGlobalPosition, readMessagesBatch, readProcessorCheckpoint, readProjectionInfo, readStream, rebuildPostgreSQLProjections, registerProjection, registerProjectionSQL, releaseProcessorLockSQL, sanitizeNameSQL, schemaMigration, schemaSQL, storeProcessorCheckpoint, storeSubscriptionCheckpointSQL, streamExists, streamsTable, streamsTableSQL, toProcessorLockKey, toProjectionLockKey, transactionToPostgreSQLProjectionHandlerContext, tryAcquireProcessorLockSQL, tryAcquireProjectionLockSQL, unknownTag, zipPostgreSQLEventStoreMessageBatchPullerStartFrom };
+export { type AppendToStreamBeforeCommitHook, type CreateEventStoreSchemaOptions, DefaultPostgreSQLEventStoreProcessorBatchSize, DefaultPostgreSQLEventStoreProcessorPullingFrequencyInMs, DefaultPostgreSQLProcessorLockPolicy, type EventStoreSchemaMigrationOptions, type LockAcquisitionPolicy, type PongoAssertOptions, type PongoDocumentEvolve, type PongoMultiStreamProjectionOptions, type PongoProjectionHandlerContext, type PongoProjectionOptions, type PongoSingleStreamProjectionOptions, type PongoWithNotNullDocumentEvolve, type PongoWithNullableDocumentEvolve, type PostgreSQLCheckpointer, 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 PostgreSQLProcessorLock, type PostgreSQLProcessorLockContext, type PostgreSQLProcessorLockOptions, type PostgreSQLProcessorStartFrom, type PostgreSQLProjectionAssert, type PostgreSQLProjectionDefinition, type PostgreSQLProjectionHandler, type PostgreSQLProjectionHandlerContext, type PostgreSQLProjectionHandlerOptions, type PostgreSQLProjectionLock, type PostgreSQLProjectionLockContext, type PostgreSQLProjectionLockOptions, PostgreSQLProjectionSpec, type PostgreSQLProjectionSpecEvent, type PostgreSQLProjectionSpecOptions, type PostgreSQLProjectionSpecWhenOptions, type PostgreSQLProjectorOptions, type PostgreSQLRawBatchSQLProjection, type PostgreSQLRawSQLProjection, type PostgreSQLReactorOptions, type PostgreSQLWorkflowProcessorOptions, type PostgresEventStore, type PostgresEventStoreConnectionOptions, type PostgresEventStoreOptions, type PostgresReadEvent, type PostgresReadEventMetadata, type PostgresStreamExistsOptions, type ReadLastMessageGlobalPositionResult, type ReadMessagesBatchOptions, type ReadMessagesBatchResult, type ReadProcessorCheckpointResult, type ReadProjectionInfoResult, type StoreProcessorCheckpointResult, activateProjection, activateProjectionSQL, addDefaultPartitionSQL, addModuleForAllTenantsSQL, addModuleSQL, addPartitionSQL, addTablePartitions, addTenantForAllModulesSQL, addTenantSQL, appendToStream, appendToStreamSQL, assertSQLQueryResultMatches, callActivateProjection, callAppendToStream, callDeactivateProjection, callRegisterProjection, callReleaseProcessorLock, callStoreProcessorCheckpoint, callTryAcquireProcessorLock, callTryAcquireProjectionLock, cleanupLegacySubscriptionTables, createEventStoreSchema, deactivateProjection, deactivateProjectionSQL, defaultPostgreSQLOptions, defaultTag, documentDoesNotExist, documentExists, documentMatchingExists, documentsAreTheSame, documentsMatchingHaveCount, emmettPrefix, eventInStream, eventStoreSchemaMigrations, eventsInStream, expectPongoDocuments, expectSQL, getPostgreSQLEventStore, globalNames, globalTag, handleProjections, messagesTable, messagesTableSQL, newEventsInStream, pongoMultiStreamProjection, pongoProjection, pongoSingleStreamProjection, postgreSQLCheckpointer, postgreSQLEventStoreConsumer, postgreSQLEventStoreMessageBatchPuller, postgreSQLProcessorLock, postgreSQLProjection, postgreSQLProjectionLock, postgreSQLProjector, postgreSQLRawBatchSQLProjection, postgreSQLRawSQLProjection, postgreSQLReactor, postgreSQLWorkflowProcessor, processorsTable, processorsTableSQL, projectionsTable, projectionsTableSQL, readLastMessageGlobalPosition, readMessagesBatch, readProcessorCheckpoint, readProjectionInfo, readStream, rebuildPostgreSQLProjections, registerProjection, registerProjectionSQL, releaseProcessorLockSQL, sanitizeNameSQL, schemaMigration, schemaSQL, storeProcessorCheckpoint, storeSubscriptionCheckpointSQL, streamExists, streamsTable, streamsTableSQL, toProcessorLockKey, toProjectionLockKey, transactionToPostgreSQLProjectionHandlerContext, tryAcquireProcessorLockSQL, tryAcquireProjectionLockSQL, unknownTag, zipPostgreSQLEventStoreMessageBatchPullerStartFrom };