@schemeless/event-store-types 2.11.0 → 3.0.1

package/dist/Repo.types.d.ts

@@ -19,12 +19,44 @@ export interface StoreEventsOptions {
      */
     expectedSequence?: number;
 }
+export interface ISnapshotEntity<STATE = any> {
+    domain: string;
+    identifier: string;
+    state: STATE;
+    sequence: number;
+    created: Date;
+}
+export interface IEventStoreRepoCapabilities {
+    /**
+     * Supports aggregate reconstruction through eventStore.getAggregate().
+     * Requires getStreamEvents(domain, identifier, fromSequence).
+     */
+    aggregate?: boolean;
+}
 export interface IEventStoreRepo<PAYLOAD = any, META = any> {
     init: () => Promise<void>;
     getAllEvents: (pageSize: number, startFromId?: string) => Promise<AsyncIterableIterator<Array<IEventStoreEntity<PAYLOAD, META>>>>;
     createEventEntity: (event: CreatedEvent<any>) => IEventStoreEntity<PAYLOAD, META>;
     storeEvents: (events: CreatedEvent<any>[], options?: StoreEventsOptions) => Promise<void>;
     resetStore: () => Promise<void>;
+    /**
+     * Optional explicit capability declaration.
+     * If omitted, runtime infers support from implemented methods for backwards compatibility.
+     */
+    capabilities?: IEventStoreRepoCapabilities;
+    /**
+     * Get events for a specific stream (domain + identifier).
+     * MUST use efficient index-based query (e.g., DynamoDB Query, SQL WHERE).
+     * Required for getAggregate to work.
+     *
+     * @param domain - Event domain
+     * @param identifier - Stream identifier
+     * @param fromSequence - Start from this sequence (exclusive), 0 = from beginning
+     * @returns Events ordered by sequence ascending
+     */
+    getStreamEvents?: (domain: string, identifier: string, fromSequence?: number) => Promise<IEventStoreEntity<PAYLOAD, META>[]>;
+    getSnapshot?: <STATE>(domain: string, identifier: string) => Promise<ISnapshotEntity<STATE> | null>;
+    saveSnapshot?: <STATE>(snapshot: ISnapshotEntity<STATE>) => Promise<void>;
     /**
      * Get the current sequence number for a stream.
      * Returns 0 if no events exist for this stream.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schemeless/event-store-types",
-  "version": "2.11.0",
+  "version": "3.0.1",
   "typescript:main": "src/index.ts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -34,5 +34,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "299af18aa23f86c614fd38174e5c9ff54d1e3d69"
+  "gitHead": "705cba8aea97c2380dc986e20c170715f3bf430c"
 }