@eventualize/types 1.0.0

package/dist/EvDbViewAddress.js

@@ -0,0 +1,22 @@
+import EvDbStreamAddress from "@eventualize/types/EvDbStreamAddress";
+export default class EvDbViewAddress extends EvDbStreamAddress {
+    constructor(streamAddressOrType, viewNameOrStreamId, viewName) {
+        if (streamAddressOrType instanceof EvDbStreamAddress &&
+            typeof viewNameOrStreamId === "string" &&
+            !viewName) {
+            const streamAddress = streamAddressOrType;
+            super(streamAddress.streamType, streamAddress.streamId);
+            this.viewName = viewNameOrStreamId;
+            return;
+        }
+        if (typeof streamAddressOrType === 'string' &&
+            typeof viewNameOrStreamId === 'string' &&
+            typeof viewName === 'string') {
+            super(streamAddressOrType, viewNameOrStreamId);
+            this.viewName = viewName;
+            return;
+        }
+        throw new Error('Unsupported set or arguments');
+    }
+}
+//# sourceMappingURL=EvDbViewAddress.js.map

package/dist/EvDbViewAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvDbViewAddress.js","sourceRoot":"","sources":["../src/EvDbViewAddress.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sCAAsC,CAAC;AAErE,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,iBAAiB;IAE1D,YAAY,mBAA+C,EAAE,kBAA0B,EAAE,QAAiB;QACtG,IAAI,mBAAmB,YAAY,iBAAiB;YAChD,OAAO,kBAAkB,KAAK,QAAQ;YACtC,CAAC,QAAQ,EACX,CAAC;YACC,MAAM,aAAa,GAAG,mBAAwC,CAAC;YAC/D,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,GAAG,kBAAkB,CAAC;YACnC,OAAO;QACX,CAAC;QACD,IAAI,OAAO,mBAAmB,KAAK,QAAQ;YACvC,OAAO,kBAAkB,KAAK,QAAQ;YACtC,OAAO,QAAQ,KAAK,QAAQ,EAC9B,CAAC;YACC,KAAK,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACzB,OAAO;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IAEnD,CAAC;CACJ"}

package/dist/IEvDbChangeStream.d.ts

@@ -0,0 +1,58 @@
+import { EvDbShardName } from "./primitiveTypes.js";
+import EvDbMessageFilter from "./EvDbMessageFilter.js";
+import EvDbContinuousFetchOptions from "./EvDbContinuousFetchOptions.js";
+import EvDbMessage from "./EvDbMessage.js";
+export default interface IEvDbChangeStream {
+    /**
+     * Gets stream of stored messages.
+     * @param filter - filtering options use `EvDbMessageFilter.Builder` for the filter creation.
+     * @param options - Options for the continuous fetch.
+     * @returns Stream of messages
+     */
+    getFromOutbox(filter: EvDbMessageFilter, options?: EvDbContinuousFetchOptions | null): Promise<AsyncIterable<EvDbMessage>>;
+    /**
+     * Gets stream of stored messages.
+     * @param shard - The shard (table/collection) of the messages
+     * @param filter - filtering options use `EvDbMessageFilter.Builder` for the filter creation.
+     * @param options - Options for the continuous fetch.
+     * @param cancellation - The cancellation.
+     * @returns Stream of messages
+     */
+    getFromOutboxAsync(shard: EvDbShardName, filter: EvDbMessageFilter, options?: EvDbContinuousFetchOptions | null, cancellation?: AbortSignal): AsyncIterable<EvDbMessage>;
+    /**
+     * Gets stored messages.
+     * @param filter - filtering options use `EvDbMessageFilter.Builder` for the filter creation.
+     * @param options - Options for the continuous fetch.
+     * @param cancellation - The cancellation.
+     * @returns Stream of messages
+     */
+    getRecordsFromOutboxAsync(filter: EvDbMessageFilter, options?: EvDbContinuousFetchOptions | null, cancellation?: AbortSignal): AsyncIterable<EvDbMessage>;
+    /**
+     * Gets stream of stored messages.
+     * @param shard - The shard (table/collection) of the messages
+     * @param filter - filtering options use `EvDbMessageFilter.Builder` for the filter creation.
+     * @param options - Options for the continuous fetch.
+     * @param cancellation - The cancellation.
+     * @returns Stream of messages
+     */
+    getRecordsFromOutboxAsync(shard: EvDbShardName, filter: EvDbMessageFilter, options?: EvDbContinuousFetchOptions | null, cancellation?: AbortSignal): AsyncIterable<EvDbMessage>;
+    /**
+     * Subscribe to a stream of stored messages into via Dataflow Block.
+     * You can control the concurrency and back pressure of the Dataflow Block to control how many messages will be processed in parallel and BoundedCapacity.
+     * Complete the Dataflow Block when the stream is completed or cancelled.
+     * @param handler - The subscription handler
+     * @param filter - filtering options use `EvDbMessageFilter.Builder` for the filter creation.
+     * @param options - Options for the continuous fetch.
+     */
+    subscribeToMessageAsync(handler: (message: EvDbMessage) => Promise<void>, filter: EvDbMessageFilter, options?: EvDbContinuousFetchOptions | null): Promise<void>;
+    /**
+     * Subscribe to a stream of stored messages into via Dataflow Block.
+     * You can control the concurrency and back pressure of the Dataflow Block to control how many messages will be processed in parallel and BoundedCapacity.
+     * Complete the Dataflow Block when the stream is completed or cancelled.
+     * @param handler - The subscription handler
+     * @param shard - The shard (table/collection) of the messages
+     * @param filter - filtering options use `EvDbMessageFilter.Builder` for the filter creation.
+     * @param options - Options for the continuous fetch.
+     */
+    subscribeToMessageAsync(handler: (message: EvDbMessage) => Promise<void>, shard: EvDbShardName, filter: EvDbMessageFilter, options?: EvDbContinuousFetchOptions | null): Promise<void>;
+}

package/dist/IEvDbChangeStream.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbChangeStream.js.map

package/dist/IEvDbChangeStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbChangeStream.js","sourceRoot":"","sources":["../src/IEvDbChangeStream.ts"],"names":[],"mappings":""}

package/dist/IEvDbEventMetadata.d.ts

@@ -0,0 +1,20 @@
+import EvDbStreamCursor from "./EvDbStreamCursor.js";
+export default interface IEvDbEventMetadata {
+    /**
+     * The full address of the stream including the offset
+     */
+    readonly streamCursor: EvDbStreamCursor;
+    /**
+     * The type of the event
+     */
+    readonly eventType: string;
+    /**
+     * The time of capturing the event (client side time)
+     */
+    readonly capturedAt: Date;
+    readonly storedAt?: Date | null;
+    /**
+     * The user that captured the event
+     */
+    readonly capturedBy: string;
+}

package/dist/IEvDbEventMetadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbEventMetadata.js.map

package/dist/IEvDbEventMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbEventMetadata.js","sourceRoot":"","sources":["../src/IEvDbEventMetadata.ts"],"names":[],"mappings":""}

package/dist/IEvDbEventPayload.d.ts

@@ -0,0 +1,6 @@
+export interface IEvDbPayloadData {
+    [key: string]: any;
+}
+export default interface IEvDbEventPayload extends IEvDbPayloadData {
+    readonly payloadType: string;
+}

package/dist/IEvDbEventPayload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbEventPayload.js.map

package/dist/IEvDbEventPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbEventPayload.js","sourceRoot":"","sources":["../src/IEvDbEventPayload.ts"],"names":[],"mappings":""}

package/dist/IEvDbEventsSet.d.ts

@@ -0,0 +1,7 @@
+import IEvDbEventPayload from "./IEvDbEventPayload.js";
+import IEvDbEventMetadata from "./IEvDbEventMetadata.js";
+type EvDbStreamEventHandler = (event: IEvDbEventPayload, capturedBy?: string) => Promise<IEvDbEventMetadata>;
+type EvDbStreamEventHandlersMap<TEvents extends IEvDbEventPayload> = Partial<{
+    [E in TEvents as `apply${E['payloadType']}`]: EvDbStreamEventHandler;
+}>;
+export default EvDbStreamEventHandlersMap;

package/dist/IEvDbEventsSet.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbEventsSet.js.map

package/dist/IEvDbEventsSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbEventsSet.js","sourceRoot":"","sources":["../src/IEvDbEventsSet.ts"],"names":[],"mappings":""}

package/dist/IEvDbStorageAdmin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Interface for EvDb storage administration
+ * Handles environment setup and teardown operations
+ */
+export default interface IEvDbStorageAdmin {
+    /**
+     * Create the database environment (tables, indexes, etc.)
+     */
+    createEnvironmentAsync(): Promise<void>;
+    /**
+     * Destroy the database environment (drop tables, schema, etc.)
+     */
+    destroyEnvironmentAsync(): Promise<void>;
+    /**
+     * Clear environment data (delete from tables, etc.)
+     */
+    clearEnvironmentAsync(): Promise<void>;
+    /**
+     * Dispose of resources synchronously (if applicable)
+     */
+    dispose?(): void;
+    /**
+     * Dispose of resources asynchronously
+     */
+    disposeAsync(): Promise<void>;
+    /**
+     * Close the connection to the store
+     */
+    close(): Promise<void>;
+}

package/dist/IEvDbStorageAdmin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbStorageAdmin.js.map

package/dist/IEvDbStorageAdmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbStorageAdmin.js","sourceRoot":"","sources":["../src/IEvDbStorageAdmin.ts"],"names":[],"mappings":""}

package/dist/IEvDbStorageSnapshotAdapter.d.ts

@@ -0,0 +1,26 @@
+import { EvDbStoredSnapshotResultRaw } from "./EvDbStoredSnapshotResult.js";
+import { EvDbStoredSnapshotData } from "./EvDbStoredSnapshotData.js";
+import EvDbViewAddress from "./EvDbViewAddress.js";
+/**
+ * Adapter for storing and retrieving view snapshots
+ */
+export default interface IEvDbStorageSnapshotAdapter {
+    /**
+     * Gets the latest stored view snapshot or an empty snapshot if none exists.
+     * @param viewAddress The view address
+     * @param signal Optional AbortSignal for cancellation
+     * @returns The stored snapshot result
+     */
+    getSnapshotAsync(viewAddress: EvDbViewAddress): Promise<EvDbStoredSnapshotResultRaw>;
+    /**
+     * Stores the view's state as a snapshot.
+     * @param snapshotData Snapshot data and metadata
+     * @param signal Optional AbortSignal for cancellation
+     */
+    storeSnapshotAsync(snapshotData: EvDbStoredSnapshotData): Promise<void>;
+    /**
+     * Close the storage adapter connection
+     * @returns Promise of void
+     */
+    close(): Promise<void>;
+}

package/dist/IEvDbStorageSnapshotAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbStorageSnapshotAdapter.js.map

package/dist/IEvDbStorageSnapshotAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbStorageSnapshotAdapter.js","sourceRoot":"","sources":["../src/IEvDbStorageSnapshotAdapter.ts"],"names":[],"mappings":""}

package/dist/IEvDbStorageStreamAdapter.d.ts

@@ -0,0 +1,34 @@
+import EvDbStreamCursor from "./EvDbStreamCursor.js";
+import EvDbEvent from "./EvDbEvent.js";
+import EvDbMessage from "./EvDbMessage.js";
+import EvDbStreamAddress from "./EvDbStreamAddress";
+import StreamStoreAffected from "./StreamStoreAffected.js";
+import IEvDbChangeStream from "./IEvDbChangeStream.js";
+export default interface IEvDbStorageStreamAdapter extends IEvDbChangeStream {
+    /**
+     * Gets stored events.
+     * @param streamCursor - The streamCursor.
+     * @returns Async iterable of EvDbEvent
+     */
+    getEventsAsync(streamCursor: EvDbStreamCursor): AsyncGenerator<EvDbEvent, void, undefined>;
+    /**
+     * Gets last stored event's offset.
+     * Used when getting a stream that has no views.
+     * In this case the last offset fetched from the events rather than views.
+     * @param address - The stream address
+     * @returns Promise resolving to the last offset
+     */
+    getLastOffsetAsync(address: EvDbStreamAddress): Promise<number>;
+    /**
+     * Saves the pending events to the stream
+     * @param events - The events to save
+     * @param messages - The messages to save.
+     * @returns Promise resolving to count of added events
+     */
+    storeStreamAsync(events: ReadonlyArray<EvDbEvent>, messages: ReadonlyArray<EvDbMessage>): Promise<StreamStoreAffected>;
+    /**
+     * Close the storage adapter connection
+     * @returns Promise of void
+     */
+    close(): Promise<void>;
+}

package/dist/IEvDbStorageStreamAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbStorageStreamAdapter.js.map

package/dist/IEvDbStorageStreamAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbStorageStreamAdapter.js","sourceRoot":"","sources":["../src/IEvDbStorageStreamAdapter.ts"],"names":[],"mappings":""}

package/dist/IEvDbStreamStore.d.ts

@@ -0,0 +1,16 @@
+import EvDbStreamAddress from "./EvDbStreamAddress.js";
+import StreamStoreAffected from "./StreamStoreAffected.js";
+export default interface IEvDbStreamStore {
+    /** The offset of the last event that was stored */
+    readonly storedOffset: number;
+    /** The stream's address */
+    readonly streamAddress: EvDbStreamAddress;
+    /** Number of events that were not stored yet */
+    readonly countOfPendingEvents: number;
+    /**
+     * Saves pending events into the injected storage.
+     * @param signal Optional AbortSignal to cancel the operation
+     * @returns Count of added events
+     */
+    store(signal?: AbortSignal): Promise<StreamStoreAffected>;
+}

package/dist/IEvDbStreamStore.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbStreamStore.js.map

package/dist/IEvDbStreamStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbStreamStore.js","sourceRoot":"","sources":["../src/IEvDbStreamStore.ts"],"names":[],"mappings":""}

package/dist/IEvDbStreamStoreData.d.ts

@@ -0,0 +1,20 @@
+import EvDbStreamAddress from "./EvDbStreamAddress.js";
+import IEvDbView from "./IEvDbView.js";
+import EvDbEvent from "./EvDbEvent.js";
+import EvDbMessage from "./EvDbMessage.js";
+type ImmutableIEvDbView = Readonly<IEvDbView>;
+export type ImmutableIEvDbViewMap = Readonly<Record<string, ImmutableIEvDbView>>;
+export default interface IEvDbStreamStoreData {
+    /** Serialization options (optional) */
+    options?: Record<string, any>;
+    /** Views (unspecialized) */
+    getViews: () => ImmutableIEvDbViewMap;
+    getView(viewName: string): ImmutableIEvDbView | undefined;
+    /** Unspecialized events */
+    getEvents: () => ReadonlyArray<EvDbEvent>;
+    /** Unspecialized notifications */
+    getMessages: () => ReadonlyArray<EvDbMessage>;
+    /** Stream address (uniqueness) */
+    streamAddress: EvDbStreamAddress;
+}
+export {};

package/dist/IEvDbStreamStoreData.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbStreamStoreData.js.map

package/dist/IEvDbStreamStoreData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbStreamStoreData.js","sourceRoot":"","sources":["../src/IEvDbStreamStoreData.ts"],"names":[],"mappings":""}

package/dist/IEvDbView.d.ts

@@ -0,0 +1,15 @@
+import EvDbViewAddress from "./EvDbViewAddress.js";
+export default interface IEvDbView {
+    /**
+     * Gets the offset of the last folded event (in-memory).
+     */
+    readonly memoryOffset: number;
+    /**
+     * Gets the name of the view.
+     */
+    readonly address: EvDbViewAddress;
+    /**
+     * The offset of the last snapshot that was stored.
+     */
+    readonly storeOffset: number;
+}

package/dist/IEvDbView.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbView.js.map

package/dist/IEvDbView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbView.js","sourceRoot":"","sources":["../src/IEvDbView.ts"],"names":[],"mappings":""}

package/dist/IEvDbViewAppliesSet.d.ts

@@ -0,0 +1,6 @@
+import IEvDbEventPayload from "./IEvDbEventPayload.js";
+import IEvDbEventMetadata from "./IEvDbEventMetadata.js";
+type IEvDbViewAppliesSet<Tstate, TEvents extends IEvDbEventPayload> = {
+    [E in TEvents as `apply${E['payloadType']}`]: (oldState: Tstate, newEvent: E, eventMetadata: IEvDbEventMetadata) => Tstate;
+};
+export default IEvDbViewAppliesSet;

package/dist/IEvDbViewAppliesSet.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbViewAppliesSet.js.map

package/dist/IEvDbViewAppliesSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbViewAppliesSet.js","sourceRoot":"","sources":["../src/IEvDbViewAppliesSet.ts"],"names":[],"mappings":""}

package/dist/IEvDbViewStore.d.ts

@@ -0,0 +1,28 @@
+import IEvDbView from "./IEvDbView.js";
+import EvDbEvent from "./EvDbEvent.js";
+import { EvDbStoredSnapshotData } from "./EvDbStoredSnapshotData.js";
+export default interface IEvDbViewStore extends IEvDbView {
+    /**
+     * Indication whether the snapshot should be saved.
+     * Useful for offset gaps, time since last save, or reacting to specific events.
+     */
+    shouldStoreSnapshot(offsetGapFromLastSave: number, durationSinceLastSaveMs: number): boolean;
+    /**
+     * Apply event to the aggregate/view.
+     */
+    applyEvent(e: EvDbEvent): void;
+    /**
+     * Get the snapshot data.
+     */
+    getSnapshotData(): EvDbStoredSnapshotData;
+    /**
+     * Save snapshot data.
+     */
+    store(): Promise<void>;
+}
+export interface IEvDbViewStoreGeneric<TState> extends IEvDbViewStore {
+    /**
+     * Get the current state of the view.
+     */
+    state: TState;
+}

package/dist/IEvDbViewStore.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEvDbViewStore.js.map

package/dist/IEvDbViewStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEvDbViewStore.js","sourceRoot":"","sources":["../src/IEvDbViewStore.ts"],"names":[],"mappings":""}

package/dist/OCCException.d.ts

@@ -0,0 +1,13 @@
+import EvDbSnapshotCursor from "@eventualize/types/EvDbSnapshotCursor";
+/**
+ * Optimistic Concurrency Collisions Exception
+ */
+export default class OCCException extends Error {
+    constructor();
+    /** @deprecated Shouldn't be used directly; used by the serialization */
+    constructor(message: string);
+    constructor(cursor: EvDbSnapshotCursor);
+    constructor(cursor: EvDbSnapshotCursor, innerException: Error);
+    /** Optional inner exception for chaining */
+    innerException?: Error;
+}

package/dist/OCCException.js

@@ -0,0 +1,26 @@
+import EvDbSnapshotCursor from "@eventualize/types/EvDbSnapshotCursor";
+/**
+ * Optimistic Concurrency Collisions Exception
+ */
+export default class OCCException extends Error {
+    constructor(arg1, arg2) {
+        if (typeof arg1 === "string") {
+            // Obsolete constructor
+            super(arg1);
+        }
+        else if (arg1 instanceof EvDbSnapshotCursor) {
+            super(arg1.toString());
+            if (arg2) {
+                // Attach inner exception as a property (TypeScript does not have built-in inner exceptions)
+                this.innerException = arg2;
+            }
+        }
+        else {
+            super(); // parameterless constructor
+        }
+        // Set the prototype explicitly (needed for extending built-in Error in TypeScript)
+        Object.setPrototypeOf(this, OCCException.prototype);
+        this.name = "OCCException";
+    }
+}
+//# sourceMappingURL=OCCException.js.map

package/dist/OCCException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OCCException.js","sourceRoot":"","sources":["../src/OCCException.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,uCAAuC,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,KAAK;IAM3C,YAAY,IAAkC,EAAE,IAAY;QACxD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,uBAAuB;YACvB,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,IAAI,YAAY,kBAAkB,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACvB,IAAI,IAAI,EAAE,CAAC;gBACP,4FAA4F;gBAC3F,IAAY,CAAC,cAAc,GAAG,IAAI,CAAC;YACxC,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,KAAK,EAAE,CAAC,CAAC,4BAA4B;QACzC,CAAC;QAED,mFAAmF;QACnF,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/B,CAAC;CAIJ"}

package/dist/StreamStoreAffected.d.ts

@@ -0,0 +1,11 @@
+/**
+* Indicate how many events and messages were affected.
+*/
+type EvDbOutboxShardName = string;
+export default class StreamStoreAffected {
+    readonly numEvents: number;
+    readonly numMessages: ReadonlyMap<EvDbOutboxShardName, number> | undefined;
+    static readonly Empty: StreamStoreAffected;
+    constructor(numEvents: number, numMessages: ReadonlyMap<EvDbOutboxShardName, number> | undefined);
+}
+export {};

package/dist/StreamStoreAffected.js

@@ -0,0 +1,12 @@
+/**
+* Indicate how many events and messages were affected.
+*/
+class StreamStoreAffected {
+    constructor(numEvents, numMessages) {
+        this.numEvents = numEvents;
+        this.numMessages = numMessages;
+    }
+}
+StreamStoreAffected.Empty = new StreamStoreAffected(0, new Map());
+export default StreamStoreAffected;
+//# sourceMappingURL=StreamStoreAffected.js.map

package/dist/StreamStoreAffected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamStoreAffected.js","sourceRoot":"","sources":["../src/StreamStoreAffected.ts"],"names":[],"mappings":"AAAA;;EAEE;AAIF,MAAqB,mBAAmB;IAMtC,YACE,SAAiB,EACjB,WAAiE;QAEjE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;;AARsB,yBAAK,GAAG,IAAI,mBAAmB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;eAJlD,mBAAmB"}

package/dist/primitiveTypes.d.ts

@@ -0,0 +1,7 @@
+export type EvDbShardName = string;
+export type EvDbChannelName = string;
+export type EvDbMessageTypeName = string;
+export type EvDbEventTypeName = string;
+export type EvDbStreamTypeName = string;
+export type EvDbStreamId = string;
+export type EvDbStreamType = string;

package/dist/primitiveTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=primitiveTypes.js.map

package/dist/primitiveTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitiveTypes.js","sourceRoot":"","sources":["../src/primitiveTypes.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@eventualize/types",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./*": "./dist/*.js"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf dist",
+    "rebuild": "npm run clean && npm run build",
+    "test": "echo not tests implemented yet."
+  },
+  "license": "ISC",
+  "type": "module",
+  "devDependencies": {
+    "@prisma/client": "^7.1.0",
+    "dotenv": "^17.2.3",
+    "prisma": "^7.1.0"
+  }
+}

package/src/DelayStrategy.ts

@@ -0,0 +1,23 @@
+export default class DelayStrategy {
+    startDuration: number; // milliseconds
+    incrementalLogic: (lastDelay: number, attempt: number) => number;
+
+    constructor(init?: Partial<DelayStrategy>) {
+        this.startDuration = init?.startDuration ?? 200; // 200 ms default
+        this.incrementalLogic = init?.incrementalLogic ?? this.defaultNextDelay.bind(this);
+    }
+
+    private defaultNextDelay(lastDelay: number, attempt: number): number {
+        if (attempt <= 5) {
+            return this.startDuration;
+        }
+
+        // When lastDelay == 0 → return 50ms
+        if (lastDelay === 0) {
+            return 50;
+        }
+
+        // Exponential growth: double the last delay
+        return lastDelay * 2;
+    }
+}

package/src/EvDbContinuousFetchOptions.ts

@@ -0,0 +1,22 @@
+import DelayStrategy from "./DelayStrategy.js";
+
+export default class EvDbContinuousFetchOptions {
+    private static readonly MAX_DELAY_SEC = 3;
+
+    static readonly CompleteIfEmpty = new EvDbContinuousFetchOptions({
+        completeWhenEmpty: true
+    });
+
+    static readonly ContinueWhenEmpty = new EvDbContinuousFetchOptions();
+
+    completeWhenEmpty: boolean;
+    delayWhenEmpty: DelayStrategy;
+    maxDelayWhenEmpty: number; // milliseconds
+
+    constructor(init?: Partial<EvDbContinuousFetchOptions>) {
+        this.completeWhenEmpty = init?.completeWhenEmpty ?? false;
+        this.delayWhenEmpty = init?.delayWhenEmpty ?? new DelayStrategy();
+        this.maxDelayWhenEmpty = init?.maxDelayWhenEmpty
+            ?? EvDbContinuousFetchOptions.MAX_DELAY_SEC * 1000;
+    }
+}

package/src/EvDbEvent.ts

@@ -0,0 +1,15 @@
+import EvDbStreamCursor from "./EvDbStreamCursor.js";
+import IEvDbEventMetadata from "./IEvDbEventMetadata.js";
+import IEvDbEventPayload from "./IEvDbEventPayload.js";
+
+export default class EvDbEvent implements IEvDbEventMetadata {
+
+    constructor(
+        public readonly eventType: string,
+        public readonly streamCursor: EvDbStreamCursor,
+        public readonly payload: IEvDbEventPayload,
+        public readonly capturedAt: Date = new Date(Date.now()),
+        public readonly capturedBy: string = 'N/A',
+        public readonly storedAt?: Date,
+    ) { }
+}