@eventualize/types 1.0.0 → 2.0.0

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@eventualize/types",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/outsidenote/eventualize-js",
+    "directory": "packages/types"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -9,7 +14,13 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
-    "./*": "./dist/*.js"
+    "./*": {
+      "import": "./dist/*.js",
+      "types": "./dist/*.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "scripts": {
     "build": "tsc --build",
@@ -23,5 +34,8 @@
     "@prisma/client": "^7.1.0",
     "dotenv": "^17.2.3",
     "prisma": "^7.1.0"
-  }
+  },
+  "files": [
+    "dist"
+  ]
 }

package/src/DelayStrategy.ts

@@ -1,23 +0,0 @@
-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

@@ -1,22 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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,
-    ) { }
-}

package/src/EvDbMessage.ts

@@ -1,105 +0,0 @@
-import EvDbEvent from "./EvDbEvent.js";
-import EvDbStreamCursor from "./EvDbStreamCursor.js";
-import IEvDbEventPayload, { IEvDbPayloadData } from "./IEvDbEventPayload.js";
-
-export default class EvDbMessage {
-
-
-    public static readonly Empty: EvDbMessage = EvDbMessage.createWithId(
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        new Date(0),
-        '',
-        {} as EvDbStreamCursor,
-        undefined
-    );
-
-    private constructor(
-        public readonly id: string,
-        public readonly eventType: string,
-        public readonly channel: string,
-        public readonly shardName: string,
-        public readonly messageType: string,
-        public readonly serializeType: string,
-        public readonly capturedAt: Date,
-        public readonly capturedBy: string,
-        public readonly streamCursor: EvDbStreamCursor,
-        public readonly payload: IEvDbPayloadData,
-        public readonly storedAt?: Date
-    ) { }
-
-    public static createWithId(
-        id: string,
-        eventType: string,
-        channel: string,
-        shardName: string,
-        messageType: string,
-        serializeType: string,
-        capturedAt: Date,
-        capturedBy: string,
-        streamCursor: EvDbStreamCursor,
-        payload: any
-    ): EvDbMessage {
-        return new EvDbMessage(
-            id,
-            eventType,
-            channel,
-            shardName,
-            messageType,
-            serializeType,
-            capturedAt,
-            capturedBy,
-            streamCursor,
-            payload
-        );
-    }
-
-    public static create(
-        eventType: string,
-        channel: string,
-        shardName: string,
-        messageType: string,
-        serializeType: string,
-        capturedAt: Date,
-        capturedBy: string,
-        streamCursor: EvDbStreamCursor,
-        payload: any
-    ): EvDbMessage {
-        return new EvDbMessage(
-            crypto.randomUUID(),
-            eventType,
-            channel,
-            shardName,
-            messageType,
-            serializeType,
-            capturedAt,
-            capturedBy,
-            streamCursor,
-            payload
-        );
-    }
-
-    public static createFromEvent(
-        event: EvDbEvent,
-        payload: IEvDbEventPayload,
-        channel: string = 'default',
-        serializeType: string = 'json'
-    ): EvDbMessage {
-        return new EvDbMessage(
-            crypto.randomUUID(),
-            event.eventType,
-            channel,
-            'default',
-            payload.payloadType,
-            serializeType,
-            event.capturedAt,
-            event.capturedBy,
-            event.streamCursor,
-            payload
-        );
-    }
-}

package/src/EvDbMessageFilter.ts

@@ -1,86 +0,0 @@
-import { EvDbChannelName, EvDbMessageTypeName } from "../../types/src/primitiveTypes.js";
-
-export default class EvDbMessageFilter {
-  public readonly since: Date;
-  public readonly channels: ReadonlyArray<EvDbChannelName>;
-  public readonly messageTypes: ReadonlyArray<EvDbMessageTypeName>;
-
-  constructor(
-    since: Date = new Date(0),
-    channels: ReadonlyArray<EvDbChannelName> = [],
-    messageTypes: ReadonlyArray<EvDbMessageTypeName> = []
-  ) {
-    this.since = since;
-    this.channels = channels;
-    this.messageTypes = messageTypes;
-  }
-
-  /**
-   * Creates a filter with the specified since date
-   */
-  public static create(since: Date): EvDbMessageFilter {
-    return new EvDbMessageFilter(since);
-  }
-
-  /**
-   * Creates a filter from a Date
-   */
-  public static fromDate(date: Date): EvDbMessageFilter {
-    return new EvDbMessageFilter(date);
-  }
-
-  /**
-   * Creates a filter from a channel name
-   */
-  public static fromChannel(channel: EvDbChannelName): EvDbMessageFilter {
-    return new EvDbMessageFilter(new Date(0), [channel]);
-  }
-
-  /**
-   * Creates a filter from a message type name
-   */
-  public static fromMessageType(messageType: EvDbMessageTypeName): EvDbMessageFilter {
-    return new EvDbMessageFilter(new Date(0), [], [messageType]);
-  }
-
-  /**
-   * Adds a channel to the filter
-   * Restrict the messages to those that match the specified channels.
-   * Ignore this property if you want to get all messages.
-   */
-  public addChannel(channel: EvDbChannelName): EvDbMessageFilter {
-    return new EvDbMessageFilter(
-      this.since,
-      [...this.channels, channel],
-      this.messageTypes
-    );
-  }
-
-  /**
-   * Adds a message type to the filter
-   * Restrict the messages to those that match the specified message-types.
-   * Ignore this property if you want to get all messages.
-   */
-  public addMessageType(messageType: EvDbMessageTypeName): EvDbMessageFilter {
-    return new EvDbMessageFilter(
-      this.since,
-      this.channels,
-      [...this.messageTypes, messageType]
-    );
-  }
-
-  /**
-   * Creates a new filter with updated properties (similar to C# 'with' expression)
-   */
-  public with(updates: {
-    since?: Date;
-    channels?: ReadonlyArray<EvDbChannelName>;
-    messageTypes?: ReadonlyArray<EvDbMessageTypeName>;
-  }): EvDbMessageFilter {
-    return new EvDbMessageFilter(
-      updates.since ?? this.since,
-      updates.channels ?? this.channels,
-      updates.messageTypes ?? this.messageTypes
-    );
-  }
-}

package/src/EvDbMessagesProducer.ts

@@ -1,5 +0,0 @@
-import EvDbEvent from "./EvDbEvent.js";
-import EvDbMessage from "./EvDbMessage.js";
-
-type EVDbMessagesProducer = (event: EvDbEvent, viewStates: Readonly<Record<string, unknown>>) => EvDbMessage[];
-export default EVDbMessagesProducer;

package/src/EvDbSnapshotCursor.ts

@@ -1,91 +0,0 @@
-import EvDbStreamAddress from "./EvDbStreamAddress.js";
-import EvDbViewAddress from "@eventualize/types/EvDbViewAddress";
-
-
-export default class EvDbSnapshotCursor {
-    readonly streamType: string;
-    readonly streamId: string;
-    readonly viewName: string;
-    readonly offset: number;
-
-    constructor(
-        streamType: string,
-        streamId: string,
-        viewName: string,
-        offset: number = 0
-    ) {
-        this.streamType = streamType;
-        this.streamId = streamId;
-        this.viewName = viewName;
-        this.offset = offset;
-
-        Object.freeze(this); // mimic C# record struct immutability
-    }
-
-    // Equivalent to: public static readonly EvDbSnapshotCursor Empty
-    static readonly Empty = new EvDbSnapshotCursor("N/A", "N/A", "N/A", 0);
-
-    // Alternative constructor: (EvDbStreamAddress, viewName, offset)
-    static fromStreamAddress(
-        address: EvDbStreamAddress,
-        viewName: string,
-        offset: number = 0
-    ): EvDbSnapshotCursor {
-        return new EvDbSnapshotCursor(address.streamType, address.streamId, viewName, offset);
-    }
-
-    // --------------------------
-    // Equality helpers
-    // --------------------------
-
-    private equalsViewAddress(address: EvDbViewAddress): boolean {
-        return (
-            this.streamType === address.streamType &&
-            this.streamId === address.streamId &&
-            this.viewName === address.viewName
-        );
-    }
-
-    private equalsStreamAddress(address: EvDbStreamAddress): boolean {
-        return (
-            this.streamType === address.streamType &&
-            this.streamId === address.streamId
-        );
-    }
-
-    // C# operator == equivalents
-    equalsAddress(address: any): boolean {
-        if ("viewName" in address) return this.equalsViewAddress(address);
-        return this.equalsStreamAddress(address);
-    }
-
-    // --------------------------
-    // "Implicit cast" equivalents
-    // --------------------------
-
-    toStreamAddress(): { streamType: string; streamId: string } {
-        return new EvDbStreamAddress(this.streamType, this.streamId);
-    }
-
-    toViewAddress(): { streamType: string; streamId: string; viewName: string } {
-        return new EvDbViewAddress(
-            new EvDbStreamAddress(this.streamType, this.streamId),
-            this.viewName
-        );
-    }
-
-    // --------------------------
-    // toString & filter string
-    // --------------------------
-
-    toString(): string {
-        // Format: Type:Id:View:000_000_000_000
-        const formattedOffset = this.offset.toString().padStart(12, "0");
-        return `${this.streamType}:${this.streamId}:${this.viewName}:${formattedOffset}`;
-    }
-
-    toFilterString(): string {
-        // Format without offset: Type:Id:View:
-        return `${this.streamType}:${this.streamId}:${this.viewName}:`;
-    }
-}

package/src/EvDbStoredSnapshotData.ts

@@ -1,106 +0,0 @@
-import EvDbStreamAddress from "./EvDbStreamAddress.js";
-import { EvDbStoredSnapshotResultRaw } from "./EvDbStoredSnapshotResult";
-import EvDbViewAddress from "./EvDbViewAddress";
-
-
-
-// Base class equivalent
-export abstract class EvDbStoredSnapshotDataBase {
-    constructor(
-        public readonly id: string,
-        public readonly streamType: string,
-        public readonly streamId: string,
-        public readonly viewName: string,
-        public readonly offset: number,
-        public readonly storeOffset: number,
-        public readonly storedAt: Date = new Date()
-    ) { }
-
-    toStreamAddress(): EvDbStreamAddress {
-        return new EvDbStreamAddress(this.streamType, this.streamId);
-    }
-}
-
-export class EvDbStoredSnapshotData extends EvDbStoredSnapshotDataBase {
-    readonly state: any;
-
-    // Primary constructor equivalent
-    constructor(
-        id: string,
-        streamType: string,
-        streamId: string,
-        viewName: string,
-        offset: number,
-        storeOffset: number,
-        state: any
-    ) {
-        super(id, streamType, streamId, viewName, offset, storeOffset);
-        this.state = state;
-    }
-
-    // Secondary constructor (overload)
-    static fromAddress(
-        address: EvDbViewAddress,
-        offset: number,
-        storeOffset: number,
-        state: any
-    ): EvDbStoredSnapshotData {
-        return new EvDbStoredSnapshotData(
-            crypto.randomUUID(),
-            address.streamType,
-            address.streamId,
-            address.viewName,
-            offset,
-            storeOffset,
-            state
-        );
-    }
-
-    // ------------------------------------------------------------------------------------
-    // Equality helpers (TypeScript cannot overload ==, so explicit methods are used)
-    // ------------------------------------------------------------------------------------
-
-    private isEquals(obj: EvDbStoredSnapshotResultRaw): boolean {
-        if (this.offset !== obj.offset) return false;
-
-        // Compare any references (same as C# byte[] reference equality)
-        if (this.state !== obj.state) return false;
-
-        return true;
-    }
-
-    equalsSnapshotResult(result: EvDbStoredSnapshotResultRaw): boolean {
-        return this.isEquals(result);
-    }
-
-    // TODO: is this needed?
-    // equalsSnapshotCursor(cursor: EvDbSnapshotCursor): boolean {
-    //     return this.isEquals(cursor);
-    // }
-
-    equalsStreamAddress(address: EvDbStreamAddress): boolean {
-        return (
-            this.streamType === address.streamType &&
-            this.streamId === address.streamId
-        );
-    }
-
-    equalsViewAddress(address: EvDbViewAddress): boolean {
-        return (
-            this.streamType === address.streamType &&
-            this.streamId === address.streamId &&
-            this.viewName === address.viewName
-        );
-    }
-
-    // ------------------------------------------------------------------------------------
-    // Casting Overload (implicit operator in C# → explicit method in TS)
-    // ------------------------------------------------------------------------------------
-    toSnapshotResult(): EvDbStoredSnapshotResultRaw {
-        return {
-            offset: this.offset,
-            storedAt: this.storedAt,
-            state: this.state
-        };
-    }
-}

package/src/EvDbStoredSnapshotResult.ts

@@ -1,44 +0,0 @@
-import EvDbStoredSnapshotResultBase from "./EvDbStoredSnapshotResultBase.js"
-
-export class EvDbStoredSnapshotResultRaw extends EvDbStoredSnapshotResultBase {
-    public readonly state: any;
-
-    constructor(
-        offset: number,
-        storedAt: Date | undefined,
-        state: any
-    ) {
-        super(offset, storedAt);
-        this.state = state;
-    }
-
-    static readonly Empty = new EvDbStoredSnapshotResultRaw(
-        0,
-        undefined,
-        undefined
-    );
-}
-
-
-export class EvDbStoredSnapshotResult<TState>
-    extends EvDbStoredSnapshotResultBase
-{
-    public readonly state: TState;
-
-    constructor(
-        offset: number,
-        storedAt: Date | undefined,
-        state: TState
-    ) {
-        super(offset, storedAt);
-        this.state = state;
-    }
-
-    static getEmptyState<TState>(): EvDbStoredSnapshotResult<TState> {
-        return new EvDbStoredSnapshotResult<TState>(
-            0,
-            undefined,
-            undefined as unknown as TState
-        );
-    }
-}

package/src/EvDbStoredSnapshotResultBase.ts

@@ -1,11 +0,0 @@
-export default class EvDbStoredSnapshotResultBase {
-    public readonly offset: number;
-    public readonly storedAt: Date | undefined;
-
-    protected constructor(offset: number, storedAt: Date | undefined) {
-        this.offset = offset;
-        this.storedAt = storedAt;
-    }
-
-    static readonly None = new EvDbStoredSnapshotResultBase(0, undefined);
-}

package/src/EvDbStreamAddress.ts

@@ -1,10 +0,0 @@
-import EvDbStreamCursor from "./EvDbStreamCursor.js";
-
-export default class EvDbStreamAddress {
-    constructor(public readonly streamType: string, public readonly streamId: string) { }
-
-    equals(other: EvDbStreamCursor): boolean {
-        return this.streamType === other.streamType &&
-            this.streamId === other.streamId;
-    }
-}

package/src/EvDbStreamCursor.ts

@@ -1,52 +0,0 @@
-import EvDbStreamAddress from "./EvDbStreamAddress.js";
-
-export default class EvDbStreamCursor extends EvDbStreamAddress {
-    public readonly offset: number;
-
-    constructor(streamType: string, streamId: string, offset: number);
-    constructor(streamAddress: EvDbStreamAddress, offset: number);
-
-    constructor(streamTypeOrAddress: string | EvDbStreamAddress, streamIdOrOffset: string | number, offset?: number) {
-        if (typeof streamTypeOrAddress === 'string' && typeof streamIdOrOffset === 'string' && (!offset || typeof offset === 'number')) {
-            const streamType = streamTypeOrAddress;
-            const streamId = streamIdOrOffset;
-            super(streamType, streamId);
-            this.offset = offset ?? 0;
-        } else if (streamTypeOrAddress instanceof EvDbStreamAddress && (!streamIdOrOffset || typeof streamIdOrOffset === 'number')) {
-            const streamType = streamTypeOrAddress.streamType;
-            const streamId = streamTypeOrAddress.streamId;
-            super(streamType, streamId);
-            this.offset = streamIdOrOffset as number ?? 0;
-        } else {
-            throw new Error('Invalid constructor arguments for EvDbStreamCursor');
-        }
-    }
-
-    /**
-     * Checks if cursor matches the given stream type
-     */
-    equals(other: EvDbStreamCursor): boolean {
-        return this.streamType === other.streamType &&
-            this.streamId === other.streamId &&
-            this.offset === other.offset;
-    }
-
-    public isEqualsStreamType(streamType: string): boolean {
-        return this.streamType === streamType;
-    }
-
-    /**
-     * Checks if cursor matches the given stream address
-     */
-    public isEqualsAddress(address: EvDbStreamAddress): boolean {
-        return this.streamType === address.streamType &&
-            this.streamId === address.streamId;
-    }
-
-    /**
-     * Converts cursor to stream address
-     */
-    public toStreamAddress(): EvDbStreamAddress {
-        return new EvDbStreamAddress(this.streamType, this.streamId);
-    }
-}

package/src/EvDbViewAddress.ts

@@ -1,26 +0,0 @@
-import EvDbStreamAddress from "@eventualize/types/EvDbStreamAddress";
-
-export default class EvDbViewAddress extends EvDbStreamAddress {
-    public readonly viewName: string;
-    constructor(streamAddressOrType: EvDbStreamAddress | string, viewNameOrStreamId: string, viewName?: string) {
-        if (streamAddressOrType instanceof EvDbStreamAddress &&
-            typeof viewNameOrStreamId === "string" &&
-            !viewName
-        ) {
-            const streamAddress = streamAddressOrType as EvDbStreamAddress;
-            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')
-
-    }
-}

package/src/IEvDbChangeStream.ts

@@ -1,92 +0,0 @@
-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/src/IEvDbEventMetadata.ts

@@ -1,32 +0,0 @@
-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;
-
-  /**
-   * Json format of the Trace (Open Telemetry) propagated context at the persistent time.
-   * The value will be null if the Trace is null when persisting the record or before persistent.
-   */
-  // TODO: implement telemetry context
-//   readonly telemetryContext: EvDbTelemetryContextName;
-}

package/src/IEvDbEventPayload.ts

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

package/src/IEvDbEventsSet.ts

@@ -1,10 +0,0 @@
-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/src/IEvDbStorageAdmin.ts

@@ -1,35 +0,0 @@
-/**
- * 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/src/IEvDbStorageSnapshotAdapter.ts

@@ -1,29 +0,0 @@
-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/src/IEvDbStorageStreamAdapter.ts

@@ -1,43 +0,0 @@
-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/src/IEvDbStreamStore.ts

@@ -1,22 +0,0 @@
-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/src/IEvDbStreamStoreData.ts

@@ -1,27 +0,0 @@
-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>; // JsonSerializerOptions equivalent in TS
-
-    /** Views (unspecialized) */
-    getViews: () => ImmutableIEvDbViewMap;
-
-    getView(viewName: string): ImmutableIEvDbView | undefined;
-
-    /** Unspecialized events */
-    getEvents: () => ReadonlyArray<EvDbEvent>;
-
-    /** Unspecialized notifications */
-    getMessages: () => ReadonlyArray<EvDbMessage>;
-
-    /** Stream address (uniqueness) */
-    streamAddress: EvDbStreamAddress;
-}

package/src/IEvDbView.ts

@@ -1,18 +0,0 @@
-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/src/IEvDbViewAppliesSet.ts

@@ -1,8 +0,0 @@
-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/src/IEvDbViewStore.ts

@@ -1,38 +0,0 @@
-import IEvDbView from "./IEvDbView.js";
-import EvDbEvent from "./EvDbEvent.js";
-import { EvDbStoredSnapshotData } from "./EvDbStoredSnapshotData.js";
-
-
-/// View store contract.
-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 // TimeSpan → milliseconds
-    ): 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/src/OCCException.ts

@@ -1,34 +0,0 @@
-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);
-    constructor(arg1?: string | EvDbSnapshotCursor, arg2?: Error) {
-        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 as any).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";
-    }
-
-    /** Optional inner exception for chaining */
-    public innerException?: Error;
-}

package/src/StreamStoreAffected.ts

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

package/src/primitiveTypes.ts

@@ -1,7 +0,0 @@
-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/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "moduleResolution": "node",
-    "module": "es2020",
-    "target": "es2020",
-    "strict": true,
-    "esModuleInterop": true,
-  },
-  "include": [
-    "src/**/*.ts"
-  ]
-}