@spine-event-engine/storage 2.0.0-snapshot.23 → 2.0.0-snapshot.24

package/dist/event/event-store.d.ts

@@ -1,14 +1,15 @@
 import type { Event, EventId, TenantId } from "@spine-event-engine/proto";
 import type { RecordQuery } from "../record/record-query.js";
 import { RecordSpec } from "../record/record-spec.js";
-import type { StorageContext } from "../storage/storage.js";
+import type { StorageGroup } from "../record/storage-group.js";
 import type { StorageFactory } from "../storage/storage-factory.js";
 /**
  * Framework event store backed by record storage.
  *
- * Snapshots input events before queued work, rejects missing, blank, and
- * duplicate IDs in one batch, and rejects IDs already stored for the same
- * captured storage context.
+ * Snapshots input Events and rejects missing, blank, or repeated IDs within a
+ * batch. Immutable append accepts identical complete stored Events and leaves
+ * completed prefixes when a later insert fails. Admission methods reject every
+ * existing ID, including an identical Event.
  */
 export declare class EventStore {
     #private;
@@ -17,8 +18,9 @@ export declare class EventStore {
      *
      * @param context Specifies the storage context.
      * @param factory Creates the backing record storage.
+     * @param group Selects a separate Event record family when supplied.
      */
-    constructor(context: EventStoreContext, factory: StorageFactory);
+    constructor(context: EventStoreContext, factory: StorageFactory, group?: StorageGroup);
     /**
      * Returns whether this Event Store still accepts operations.
      *
@@ -30,15 +32,17 @@ export declare class EventStore {
      */
     close(): void;
     /**
-     * Validates that one generated Spine event can be appended without storing it.
+     * Validates strict new admission without storing an Event. An identical
+     * existing Event still rejects; this precheck does not reserve its ID.
      *
      * @param event Supplies the event to validate.
      * @returns Completes when the event is accepted.
      */
     accept(event: Event): Promise<void>;
     /**
-     * Accepts one event, runs caller acceptance, and appends using one captured
-     * storage context.
+     * Checks strict new admission, runs caller acceptance, then atomically inserts
+     * under one captured context. Competing callbacks may both run, but only one
+     * absent-slot insertion can succeed.
      *
      * @param event Supplies the event to accept.
      * @param onAccepted Runs after uniqueness validation and before append.
@@ -46,26 +50,21 @@ export declare class EventStore {
      */
     acceptThenAppend(event: Event, onAccepted: OnEventAccepted): Promise<Event>;
     /**
-     * Writes one generated Spine event, rejecting missing, blank, or duplicate IDs.
+     * Writes one complete Event, accepting an identical immutable retry without
+     * overwriting it. A conflicting Event at the same ID rejects.
      *
      * @param event Supplies the event to append.
      * @returns Completes when the event is appended.
      */
     append(event: Event): Promise<void>;
     /**
-     * Writes generated Spine events in order, rejecting missing, blank, or duplicate IDs.
+     * Writes generated Events in order, accepting identical immutable retries.
+     * A later failure retains the completed prefix for retry with the same IDs.
      *
      * @param events Supplies the events to append.
      * @returns Completes when the events are appended.
      */
     appendAll(events: Iterable<Event>): Promise<void>;
-    /**
-     * Writes generated Spine events and returns a one-shot rollback token.
-     *
-     * @param events Supplies the events to append.
-     * @returns Resolves to the rollback token for this append.
-     */
-    appendAllWithRollback(events: Iterable<Event>): Promise<EventRollback>;
     /**
      * Reads persisted events through the underlying record-storage query seam.
      *
@@ -74,31 +73,31 @@ export declare class EventStore {
      */
     read(query?: RecordQuery<EventId>): Promise<readonly Event[]>;
     /**
-     * Persists one batch only when every original Event ID is available.
+     * Writes strictly new Events after caller acceptance.
      *
-     * @param records Original Event envelopes.
-     * @param context Captured tenant and Bounded Context.
-     * @returns Completion after all unique Events are persisted.
+     * @param records Supplies validated Event snapshots.
+     * @param context Selects their storage boundary.
+     * @returns Completion after every strict insertion.
      */
     private appendUnique;
     /**
-     * Deletes the IDs inserted by a failed legacy batch operation.
+     * Writes captured immutable Events, accepting identical stored retries.
      *
-     * @param ids IDs inserted by the current batch.
-     * @param context Captured tenant and Bounded Context.
-     * @returns Completion after those IDs are removed.
+     * @param records Supplies ordered Event snapshots.
+     * @param context Selects their single storage boundary.
+     * @returns Completion after every immutable Event is confirmed.
      */
-    private deleteIds;
+    private appendImmutable;
     /**
-     * Checks that no ID in a batch is already stored for this Bounded Context and tenant.
+     * Checks strict admission without writing an Event.
      *
-     * @param ids Original Event IDs.
-     * @param context Captured tenant and Bounded Context.
-     * @returns Completion after duplicate validation.
+     * @param ids Supplies IDs that must be absent.
+     * @param context Selects the storage boundary.
+     * @returns Completion when no ID is stored.
      */
     private checkUnique;
     /**
-     * Rejects calls after this Event Store closes.
+     * Rejects operations after this Event Store closes.
      */
     private requireOpen;
 }
@@ -139,51 +138,10 @@ export type EventStoreContext = {
  * @returns Completes after caller acceptance finishes.
  */
 export type OnEventAccepted = (event: Event) => Promise<void> | void;
-/**
- * One-shot rollback token scoped to one successful event-store append.
- */
-export interface EventRollback {
-    /**
-     * Deletes the events appended by the operation that created this token.
-     *
-     * @returns Completes when the events are deleted.
-     */
-    rollback(): Promise<void>;
-}
-/**
- * Provider-only Event Store coordination bound to a captured Bounded Context and tenant.
- * @internal
- */
-interface EventStoreAccess {
-    /**
-     * Serializes work for one captured storage context.
-     *
-     * @param factory Storage provider used for the Event family.
-     * @param context Captured tenant and Bounded Context.
-     * @param work Operation run under the Bounded Context and tenant lock.
-     * @returns Result returned by the operation.
-     * @typeParam T Result of the serialized operation.
-     */
-    withLock<T>(factory: StorageFactory, context: StorageContext, work: () => Promise<T>): Promise<T>;
-    /**
-     * Accepts an original saved Event ID or verifies its exact stored envelope.
-     *
-     * @param store Event Store with a captured Bounded Context and tenant.
-     * @param event Original saved Event envelope.
-     * @returns Stored or newly appended original Event.
-     */
-    appendOrVerifyOriginal(store: EventStore, event: Event): Promise<Event>;
-}
-/**
- * Exposes captured Event Store coordination to provider and Agent delivery paths.
- * @internal
- */
-export declare const eventStoreAccess: EventStoreAccess;
 /**
  * Provides the canonical event-store record layout to provider-only internals.
  *
  * @internal
  */
 export declare const eventStoreRecordSpec: RecordSpec<EventId, Event>;
-export {};
 //# sourceMappingURL=event-store.d.ts.map

package/dist/event/event-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/event/event-store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAWpE;;;;;;GAMG;AACH,qBAAa,UAAU;;IAOrB;;;;;OAKG;gBACS,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc;IAM/D;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAUjF;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD;;;;;OAKG;IACG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB5E;;;;;OAKG;IACG,IAAI,CAAC,KAAK,GAAE,WAAW,CAAC,OAAO,CAAM,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;IAavE;;;;;;OAMG;YACW,YAAY;IAe1B;;;;;;OAMG;YACW,SAAS;IAevB;;;;;;OAMG;YACW,WAAW;IAczB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;CAC7B,GACD;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAG5B;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAsDD;;;GAGG;AACH,UAAU,gBAAgB;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAElG;;;;;;OAMG;IACH,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAyC7B,CAAC;AAiQH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAgB1D,CAAC"}
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/event/event-store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE;;;;;;;GAOG;AACH,qBAAa,UAAU;;IAqBrB;;;;;;OAMG;gBACS,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,YAAY;IAMrF;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;;;;OAQG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAUjF;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD;;;;;OAKG;IACG,IAAI,CAAC,KAAK,GAAE,WAAW,CAAC,OAAO,CAAM,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;IAcvE;;;;;;OAMG;YACW,YAAY;IAa1B;;;;;;OAMG;YACW,eAAe;IAW7B;;;;;;OAMG;YACW,WAAW;IAYzB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;CAC7B,GACD;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAmNrE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAgB1D,CAAC"}