@eventualize/core 1.0.0

package/dist/EvDbEventStore.d.ts

@@ -0,0 +1,123 @@
+import EvDbStream from './EvDbStream.js';
+import IEvDbStorageSnapshotAdapter from '@eventualize/types/IEvDbStorageSnapshotAdapter';
+import IEvDbStorageStreamAdapter from '@eventualize/types/IEvDbStorageStreamAdapter';
+import IEvDbEventPayload from "@eventualize/types/IEvDbEventPayload";
+import { EvDbStreamFactory } from './EvDbStreamFactory.js';
+/**
+ * Combined storage adapter interface
+ */
+export interface IEvDbStorageAdapter extends IEvDbStorageStreamAdapter, IEvDbStorageSnapshotAdapter {
+}
+/**
+ * Storage configuration - either separate adapters or combined
+ */
+interface StorageConfig {
+    streamAdapter: IEvDbStorageStreamAdapter;
+    snapshotAdapter: IEvDbStorageSnapshotAdapter;
+}
+/**
+ * Registry of stream factories by stream type
+ */
+interface StreamFactoryRegistry {
+    [streamType: string]: EvDbStreamFactory<any, any>;
+}
+/**
+ * Store class - manages stream creation with configured adapters and factories
+ */
+declare class BaseStore {
+    private readonly storage;
+    private readonly streamFactories;
+    constructor(storage: StorageConfig, streamFactories: StreamFactoryRegistry);
+    /**
+     * Create a stream instance by stream type and ID
+     */
+    createStream(streamType: string, streamId: string): EvDbStream;
+    /**
+     * Get a stream instance from the event store by stream type and ID
+     */
+    getStream(streamType: string, streamId: string): Promise<EvDbStream>;
+    /**
+     * Check if a stream type is registered
+     */
+    hasStreamType(streamType: string): boolean;
+    /**
+     * Get all registered stream types
+     */
+    getStreamTypes(): string[];
+    /**
+     * Create a builder for configuring the store
+     */
+    static builder(): BaseStoreBuilder;
+    close(): Promise<void>;
+}
+/**
+ * Builder for creating Store instances
+ */
+declare class BaseStoreBuilder {
+    private streamAdapter?;
+    private snapshotAdapter?;
+    private streamFactories;
+    /**
+     * Configure with separate stream and snapshot adapters
+     */
+    withAdapters(streamAdapter: IEvDbStorageStreamAdapter, snapshotAdapter: IEvDbStorageSnapshotAdapter): this;
+    /**
+     * Configure with a combined adapter that implements both interfaces
+     */
+    withAdapter(adapter: IEvDbStorageAdapter): this;
+    /**
+     * Register a stream factory
+     */
+    withStreamFactory<TEvents extends IEvDbEventPayload, TStreamType extends string>(factory: EvDbStreamFactory<TEvents, TStreamType>): this;
+    /**
+     * Register multiple stream factories at once
+     */
+    withStreamFactories(factories: ReadonlyArray<EvDbStreamFactory<any, string>>): this;
+    /**
+     * Build the store instance
+     */
+    build(): BaseStore;
+}
+/**
+ * Helper type to create method signatures for each stream factory
+ */
+export type StreamCreatorMethods<TStreamTypes extends Record<string, EvDbStreamFactory<any, any>>> = {
+    [K in keyof TStreamTypes as `create${K & string}`]: (streamId: string) => EvDbStream;
+};
+export type StreamMap = Record<string, any>;
+/**
+ * Type-safe store that knows about specific stream types
+ */
+export declare class EvDbEventStore<TStreamTypes extends Record<string, EvDbStreamFactory<any, any>>> {
+    private readonly store;
+    constructor(store: BaseStore);
+    /**
+     * Create a stream with type-safe stream type parameter (fallback method)
+     */
+    createStream<K extends keyof TStreamTypes & string>(streamType: K, streamId: string): EvDbStream;
+    /**
+     * Fetch a stream from the event store with type-safe stream type parameter (fallback method)
+     */
+    getStream<K extends keyof TStreamTypes & string>(streamType: K, streamId: string): Promise<EvDbStream>;
+    /**
+     * Create dynamic methods for each registered stream factory
+     */
+    private createDynamicMethods;
+    /**
+     * Get the underlying store
+     */
+    getStore(): BaseStore;
+}
+export type TypedStoreType<TStreamTypes extends Record<string, EvDbStreamFactory<any, any>>> = StreamCreatorMethods<TStreamTypes>;
+/**
+ * Type-safe store builder
+ */
+export declare class EvDbEventStoreBuilder<TStreamTypes extends Record<string, EvDbStreamFactory<any, string>> = {}> {
+    private builder;
+    withAdapters(streamAdapter: IEvDbStorageStreamAdapter, snapshotAdapter: IEvDbStorageSnapshotAdapter): this;
+    withAdapter(adapter: IEvDbStorageAdapter): this;
+    withStreamFactory<F extends EvDbStreamFactory<any, string>, K extends F extends EvDbStreamFactory<any, infer ST> ? ST : never>(factory: F): EvDbEventStoreBuilder<TStreamTypes & Record<K, F>>;
+    build(): EvDbEventStore<TStreamTypes> & StreamCreatorMethods<TStreamTypes>;
+}
+export type EvDbEventStoreType<TStreams extends StreamMap = StreamMap> = EvDbEventStore<TStreams> & StreamCreatorMethods<TStreams>;
+export {};

package/dist/EvDbEventStore.js

@@ -0,0 +1,182 @@
+/**
+ * Store class - manages stream creation with configured adapters and factories
+ */
+class BaseStore {
+    constructor(storage, streamFactories) {
+        this.streamFactories = {};
+        this.storage = storage;
+        this.streamFactories = streamFactories;
+    }
+    /**
+     * Create a stream instance by stream type and ID
+     */
+    createStream(streamType, streamId) {
+        const factory = this.streamFactories[streamType];
+        if (!factory) {
+            throw new Error(`No stream factory registered for stream type: ${streamType}. ` +
+                `Available types: ${Object.keys(this.streamFactories).join(', ')}`);
+        }
+        const stream = factory.create(streamId, this.storage.streamAdapter, this.storage.snapshotAdapter);
+        return stream;
+    }
+    /**
+     * Get a stream instance from the event store by stream type and ID
+     */
+    async getStream(streamType, streamId) {
+        const factory = this.streamFactories[streamType];
+        if (!factory) {
+            throw new Error(`No stream factory registered for stream type: ${streamType}. ` +
+                `Available types: ${Object.keys(this.streamFactories).join(', ')}`);
+        }
+        return factory.get(streamId, this.storage.streamAdapter, this.storage.snapshotAdapter);
+    }
+    /**
+     * Check if a stream type is registered
+     */
+    hasStreamType(streamType) {
+        return streamType in this.streamFactories;
+    }
+    /**
+     * Get all registered stream types
+     */
+    getStreamTypes() {
+        return Object.keys(this.streamFactories);
+    }
+    /**
+     * Create a builder for configuring the store
+     */
+    static builder() {
+        return new BaseStoreBuilder();
+    }
+    async close() {
+        await Promise.all([this.storage.snapshotAdapter.close(), this.storage.streamAdapter.close()]);
+        return;
+    }
+}
+/**
+ * Builder for creating Store instances
+ */
+class BaseStoreBuilder {
+    constructor() {
+        this.streamFactories = {};
+    }
+    /**
+     * Configure with separate stream and snapshot adapters
+     */
+    withAdapters(streamAdapter, snapshotAdapter) {
+        this.streamAdapter = streamAdapter;
+        this.snapshotAdapter = snapshotAdapter;
+        return this;
+    }
+    /**
+     * Configure with a combined adapter that implements both interfaces
+     */
+    withAdapter(adapter) {
+        this.streamAdapter = adapter;
+        this.snapshotAdapter = adapter;
+        return this;
+    }
+    /**
+     * Register a stream factory
+     */
+    withStreamFactory(factory) {
+        const streamType = factory.getStreamType();
+        if (this.streamFactories[streamType]) {
+            throw new Error(`Stream factory for type '${streamType}' is already registered`);
+        }
+        this.streamFactories[streamType] = factory;
+        return this;
+    }
+    /**
+     * Register multiple stream factories at once
+     */
+    withStreamFactories(factories) {
+        factories.forEach(factory => {
+            this.withStreamFactory(factory);
+        });
+        return this;
+    }
+    /**
+     * Build the store instance
+     */
+    build() {
+        if (!this.streamAdapter || !this.snapshotAdapter) {
+            throw new Error('Storage adapters must be configured. Use withAdapter() or withAdapters()');
+        }
+        if (Object.keys(this.streamFactories).length === 0) {
+            console.warn('Store created with no stream factories registered');
+        }
+        return new BaseStore({
+            streamAdapter: this.streamAdapter,
+            snapshotAdapter: this.snapshotAdapter
+        }, this.streamFactories);
+    }
+}
+/**
+ * Type-safe store that knows about specific stream types
+ */
+export class EvDbEventStore {
+    constructor(store) {
+        this.store = store;
+        // Create dynamic methods for each stream type
+        this.createDynamicMethods();
+    }
+    /**
+     * Create a stream with type-safe stream type parameter (fallback method)
+     */
+    createStream(streamType, streamId) {
+        return this.store.createStream(streamType, streamId);
+    }
+    /**
+     * Fetch a stream from the event store with type-safe stream type parameter (fallback method)
+     */
+    getStream(streamType, streamId) {
+        return this.store.getStream(streamType, streamId);
+    }
+    /**
+     * Create dynamic methods for each registered stream factory
+     */
+    createDynamicMethods() {
+        const streamTypes = this.store.getStreamTypes();
+        for (const streamType of streamTypes) {
+            const methodName = `create${streamType}`;
+            // Create the dynamic method
+            this[methodName] = (streamId) => {
+                return this.store.createStream(streamType, streamId);
+            };
+        }
+    }
+    /**
+     * Get the underlying store
+     */
+    getStore() {
+        return this.store;
+    }
+}
+/**
+ * Type-safe store builder
+ */
+export class EvDbEventStoreBuilder {
+    constructor() {
+        this.builder = BaseStore.builder();
+    }
+    withAdapters(streamAdapter, snapshotAdapter) {
+        this.builder.withAdapters(streamAdapter, snapshotAdapter);
+        return this;
+    }
+    withAdapter(adapter) {
+        this.builder.withAdapter(adapter);
+        return this;
+    }
+    // Track stream type in generics
+    withStreamFactory(factory) {
+        this.builder.withStreamFactory(factory);
+        // return as the new type that tracks K
+        return this;
+    }
+    build() {
+        const store = new EvDbEventStore(this.builder.build());
+        return store;
+    }
+}
+//# sourceMappingURL=EvDbEventStore.js.map

package/dist/EvDbEventStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvDbEventStore.js","sourceRoot":"","sources":["../src/EvDbEventStore.ts"],"names":[],"mappings":"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"}

package/dist/EvDbStream.d.ts

@@ -0,0 +1,49 @@
+import EvDbEvent from "@eventualize/types/EvDbEvent";
+import EvDbMessage from "@eventualize/types/EvDbMessage";
+import IEvDbStorageStreamAdapter from "@eventualize/types/IEvDbStorageStreamAdapter";
+import IEvDbView from "@eventualize/types/IEvDbView";
+import EvDbStreamAddress from "@eventualize/types/EvDbStreamAddress";
+import IEvDbStreamStore from "@eventualize/types/IEvDbStreamStore";
+import IEvDbStreamStoreData from "@eventualize/types/IEvDbStreamStoreData";
+import IEvDbEventPayload from "@eventualize/types/IEvDbEventPayload";
+import StreamStoreAffected from "@eventualize/types/StreamStoreAffected";
+import IEvDbEventMetadata from "@eventualize/types/IEvDbEventMetadata";
+import { EvDbStreamType } from "@eventualize/types/primitiveTypes";
+import EVDbMessagesProducer from "@eventualize/types/EvDbMessagesProducer";
+import { EvDbView } from "./EvDbView.js";
+type ImmutableIEvDbView = Readonly<EvDbView<unknown>>;
+export type ImmutableIEvDbViewMap = Readonly<Record<string, ImmutableIEvDbView>>;
+export default class EvDbStream implements IEvDbStreamStore, IEvDbStreamStoreData {
+    protected messagesProducer: EVDbMessagesProducer;
+    protected _pendingEvents: ReadonlyArray<EvDbEvent>;
+    protected _pendingMessages: ReadonlyArray<EvDbMessage>;
+    private static readonly ASSEMBLY_NAME;
+    private static readonly DEFAULT_CAPTURE_BY;
+    private readonly _storageAdapter;
+    protected readonly _views: ImmutableIEvDbViewMap;
+    getViews(): ImmutableIEvDbViewMap;
+    getView(viewName: string): Readonly<IEvDbView> | undefined;
+    /**
+     * Unspecialized events
+     */
+    getEvents(): ReadonlyArray<EvDbEvent>;
+    streamAddress: EvDbStreamAddress;
+    storedOffset: number;
+    constructor(streamType: EvDbStreamType, views: ImmutableIEvDbView[], storageAdapter: IEvDbStorageStreamAdapter, streamId: string, lastStoredOffset: number, messagesProducer: EVDbMessagesProducer);
+    protected appendEvent(payload: IEvDbEventPayload, capturedBy?: string | null): IEvDbEventMetadata;
+    private getNextCursor;
+    /**
+     * Put a row into the publication (out-box pattern).
+     */
+    appendToOutbox(e: EvDbMessage): void;
+    store(): Promise<StreamStoreAffected>;
+    /**
+     * number of events that were not stored yet.
+     */
+    get countOfPendingEvents(): number;
+    /**
+     * Unspecialized messages
+     */
+    getMessages(): ReadonlyArray<EvDbMessage>;
+}
+export {};

package/dist/EvDbStream.js

@@ -0,0 +1,115 @@
+import EvDbEvent from "@eventualize/types/EvDbEvent";
+import EvDbStreamAddress from "@eventualize/types/EvDbStreamAddress";
+import StreamStoreAffected from "@eventualize/types/StreamStoreAffected";
+import EvDbStreamCursor from "@eventualize/types/EvDbStreamCursor";
+import OCCException from "@eventualize/types/OCCException";
+class EvDbStream {
+    getViews() {
+        return this._views;
+    }
+    getView(viewName) {
+        return this._views[viewName];
+    }
+    // Events
+    /**
+     * Unspecialized events
+     */
+    getEvents() {
+        return this._pendingEvents;
+    }
+    // Constructor
+    constructor(streamType, views, storageAdapter, streamId, lastStoredOffset, messagesProducer) {
+        this.messagesProducer = messagesProducer;
+        this._pendingEvents = [];
+        this._pendingMessages = [];
+        this._views = views.reduce((acc, view) => {
+            const viewName = view.address.viewName;
+            acc[viewName] = view;
+            return acc;
+        }, {});
+        this._storageAdapter = storageAdapter;
+        this.streamAddress = new EvDbStreamAddress(streamType, streamId);
+        this.storedOffset = lastStoredOffset;
+    }
+    appendEvent(payload, capturedBy) {
+        capturedBy = capturedBy ?? EvDbStream.DEFAULT_CAPTURE_BY;
+        // const json = JSON.stringify(payload); // Or use custom serializer
+        const cursor = this.getNextCursor(this._pendingEvents);
+        const e = new EvDbEvent(payload.payloadType, cursor, payload, new Date(), capturedBy);
+        this._pendingEvents = [...this._pendingEvents, e];
+        // Apply to views
+        for (const view of Object.values(this._views)) {
+            view.applyEvent(e);
+        }
+        // Outbox producer
+        const viewsStates = Object.fromEntries(Object.entries(this._views)
+            .map(([k, v]) => {
+            return [k, v.state];
+        }));
+        const producedMessages = this.messagesProducer(e, viewsStates);
+        this._pendingMessages = [...this._pendingMessages, ...producedMessages];
+        return e;
+    }
+    getNextCursor(events) {
+        if (events.length === 0) {
+            return new EvDbStreamCursor(this.streamAddress, this.storedOffset + 1);
+        }
+        const lastEvent = events[events.length - 1];
+        const offset = lastEvent.streamCursor.offset;
+        return new EvDbStreamCursor(this.streamAddress, offset + 1);
+    }
+    // AppendToOutbox
+    /**
+     * Put a row into the publication (out-box pattern).
+     */
+    appendToOutbox(e) {
+        this._pendingMessages = [...this._pendingMessages, e];
+    }
+    // StoreAsync
+    async store() {
+        // Telemetry
+        // const tags = this.streamAddress.toOtelTags();
+        // const duration = EvDbStream._sysMeters.measureStoreEventsDuration(tags);
+        // const activity = EvDbStream._trace.startActivity(tags, 'EvDb.Store');
+        try {
+            if (this._pendingEvents.length === 0) {
+                return StreamStoreAffected.Empty;
+            }
+            const affected = await this._storageAdapter.storeStreamAsync(this._pendingEvents, this._pendingMessages);
+            const lastEvent = this._pendingEvents[this._pendingEvents.length - 1];
+            this.storedOffset = lastEvent.streamCursor.offset;
+            this._pendingEvents = [];
+            this._pendingMessages = [];
+            const viewSaveTasks = Object.values(this._views).map(v => v.store());
+            await Promise.all(viewSaveTasks);
+            return affected;
+        }
+        catch (error) {
+            if (error instanceof OCCException) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+    // CountOfPendingEvents
+    /**
+     * number of events that were not stored yet.
+     */
+    get countOfPendingEvents() {
+        return this._pendingEvents.length;
+    }
+    // Notifications
+    /**
+     * Unspecialized messages
+     */
+    getMessages() {
+        return this._pendingMessages;
+    }
+}
+EvDbStream.ASSEMBLY_NAME = {
+    name: 'evdb-core',
+    version: '1.0.0'
+};
+EvDbStream.DEFAULT_CAPTURE_BY = `${EvDbStream.ASSEMBLY_NAME.name}-${EvDbStream.ASSEMBLY_NAME.version}`;
+export default EvDbStream;
+//# sourceMappingURL=EvDbStream.js.map

package/dist/EvDbStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvDbStream.js","sourceRoot":"","sources":["../src/EvDbStream.ts"],"names":[],"mappings":"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"}

package/dist/EvDbStreamFactory.d.ts

@@ -0,0 +1,97 @@
+import IEvDbStorageSnapshotAdapter from '@eventualize/types/IEvDbStorageSnapshotAdapter';
+import IEvDbStorageStreamAdapter from '@eventualize/types/IEvDbStorageStreamAdapter';
+import IEvDbEventPayload from "@eventualize/types/IEvDbEventPayload";
+import EVDbMessagesProducer from '@eventualize/types/EvDbMessagesProducer';
+import EvDbStream from './EvDbStream.js';
+import { EvDbView } from './EvDbView.js';
+import { ViewFactory, EvDbStreamEventHandlersMap } from './EvDbViewFactory.js';
+/**
+ * Configuration for creating a stream factory
+ */
+export interface EvDbStreamFactoryConfig<TEvents extends IEvDbEventPayload, TStreamType extends string> {
+    streamType: TStreamType;
+    viewFactories: ViewFactory<any, TEvents>[];
+    eventTypes: EventTypeConfig<TEvents>[];
+    viewNames: string[];
+}
+/**
+ * Configuration for each event type
+ */
+export interface EventTypeConfig<TEvent extends IEvDbEventPayload> {
+    eventClass: new (...args: any[]) => TEvent;
+    eventName: string;
+    eventMessagesProducer?: EVDbMessagesProducer;
+}
+/**
+ * Type helper to extract event methods
+ */
+type EventMethods<TEvents extends IEvDbEventPayload> = {
+    [K in TEvents as `appendEvent${K['payloadType']}`]: (event: K) => Promise<void>;
+};
+/**
+ * Type helper to create view accessors map
+ */
+type ViewAccessors<TViews extends Record<string, EvDbView<any>>> = {
+    readonly views: TViews;
+};
+/**
+ * Combined stream type with event methods and view accessors
+ */
+export type StreamWithEventMethods<TEvents extends IEvDbEventPayload, TViews extends Record<string, EvDbView<any>> = {}> = EvDbStream & EventMethods<TEvents> & ViewAccessors<TViews>;
+/**
+ * Stream Factory - creates stream instances with configured views and dynamic event methods
+ */
+export declare class EvDbStreamFactory<TEvents extends IEvDbEventPayload, TStreamType extends string, TViews extends Record<string, EvDbView<any>> = {}> {
+    private readonly config;
+    private DynamicStreamClass;
+    constructor(config: EvDbStreamFactoryConfig<TEvents, TStreamType>);
+    /**
+     * Creates a dynamic stream class with event-specific methods and view accessors
+     */
+    private createDynamicStreamClass;
+    /**
+     * Creates a stream instance with all configured views and dynamic event methods
+     */
+    create(streamId: string, streamStorageAdapter: IEvDbStorageStreamAdapter, snapshotStorageAdapter: IEvDbStorageSnapshotAdapter, lastStreamOffset?: number): StreamWithEventMethods<TEvents, TViews>;
+    private createViews;
+    private getViews;
+    /**
+     * Fetches from storage a stream instance with all configured views and dynamic event methods
+     */
+    get(streamId: string, streamStorageAdapter: IEvDbStorageStreamAdapter, snapshotStorageAdapter: IEvDbStorageSnapshotAdapter): Promise<StreamWithEventMethods<TEvents, TViews>>;
+    getStreamType(): TStreamType;
+}
+/**
+ * Factory function to create a StreamFactory
+ */
+export declare function createEvDbStreamFactory<TEvents extends IEvDbEventPayload, TStreamType extends string, TViews extends Record<string, EvDbView<any>> = {}>(config: EvDbStreamFactoryConfig<TEvents, TStreamType>): EvDbStreamFactory<TEvents, TStreamType, TViews>;
+/**
+ * Fluent builder for creating stream factories with inferred event types
+ */
+export declare class StreamFactoryBuilder<TStreamType extends string, TEvents extends IEvDbEventPayload = never, TViews extends Record<string, EvDbView<any>> = {}> {
+    private streamType;
+    private viewFactories;
+    private eventTypes;
+    private viewNames;
+    constructor(streamType: TStreamType);
+    /**
+     * Register event type for dynamic method generation - infers the event name from class name
+     */
+    withEventType<TEvent extends IEvDbEventPayload>(eventClass: new (...args: any[]) => TEvent, eventMessagesProducer?: EVDbMessagesProducer): StreamFactoryBuilder<TStreamType, TEvents | TEvent, TViews>;
+    /**
+     * Add a view with inline handler definition
+     * This can only be called AFTER withEventType calls to ensure type safety
+     */
+    withView<TViewName extends string, TState>(viewName: TViewName, stateClass: new (...args: any[]) => TState, handlers: EvDbStreamEventHandlersMap<TState, TEvents>): StreamFactoryBuilder<TStreamType, TEvents, TViews & Record<TViewName, EvDbView<TState>>>;
+    /**
+     * Add a pre-created view factory (legacy support)
+     */
+    withViewFactory<TViewName extends string, TState>(viewName: TViewName, viewFactory: ViewFactory<TState, TEvents>): StreamFactoryBuilder<TStreamType, TEvents, TViews & Record<TViewName, EvDbView<TState>>>;
+    /**
+     * Build the stream factory
+     */
+    build(): EvDbStreamFactory<TEvents, TStreamType, TViews> & {
+        StreamType: StreamWithEventMethods<TEvents, TViews>;
+    };
+}
+export {};