@spine-event-engine/storage 2.0.0-snapshot.18 → 2.0.0-snapshot.20

package/REFERENCE.md

@@ -15,7 +15,7 @@ types, and entity history interfaces.
 
 Storage-adapter implementers import the complete provider-only contract set from
 `@spine-event-engine/storage/provider`: Event Store record access, Entity
-history and atomic commit contracts, query values, tenant boundaries/catalogs,
+history and Entity commit contracts, query values, tenant boundaries/catalogs,
 and delivery-cleanup handles. The storage root intentionally does not export
 these provider seams; application code uses its root storage contracts instead.
 
@@ -114,9 +114,15 @@ not open or allocate its grouped records. Current Entity loading always uses
 the current record, never retained history. Event history is diagnostic data,
 not a source for rebuilding current state.
 
-The provider SPI's Entity commit contract combines one current record with
-the nonempty enabled history families and delivery events. For the in-memory
-provider only, that operation stages and atomically publishes its touched
-families. Its outcomes are `"committed"` and `"conflict"`; it has no receipt or
-`"replayed"` outcome. Other providers define and document their atomicity
-guarantees.
+The provider SPI's Entity commit accepts the next current record and associated
+enabled history and delivery events, without an expected previous record.
+`commit()` returns `Promise<void>`: success resolves without a value and storage
+errors reject. There is no Entity conflict result. This changes the published
+`storage/provider` types for custom adapters; application APIs and persisted
+record layouts are unchanged.
+
+The in-memory provider prepares only the affected records before applying them
+together. Saving one Entity does not copy other Entities or whole history/Event
+Store collections. Automatic Entity versions, immutable-record checks and
+unrelated Inbox conditional updates remain. Other providers document their
+transaction and partial-write guarantees separately.

package/dist/internal/entity-commit.d.ts

@@ -5,15 +5,19 @@ import type { StorageContext } from "../storage/storage.js";
 import type { EntityStorageInput } from "./entity-history.js";
 import type { StorageFactory } from "../storage/storage-factory.js";
 /**
- * Describes one provider-owned atomic mutation for an Entity commit.
+ * Describes one coordinated provider mutation for an Entity commit.
  *
  * This provider-only contract combines current state, retained histories, and
- * framework delivery events. It is intentionally not an application-level
- * transaction API.
+ * framework delivery events. Memory and transactional database providers apply
+ * the changes atomically. MyISAM and Aria tables can retain partial writes.
+ * This contract is not an application-level transaction API.
+ *
+ * @typeParam I Entity identifier type.
+ * @typeParam S Entity state message type.
  */
 export interface EntityCommitInput<I, S extends Message> {
     /**
-     * Identifies the storage scope that owns this commit.
+     * Identifies the storage scope for this commit.
      */
     readonly context: StorageContext;
     /**
@@ -24,10 +28,6 @@ export interface EntityCommitInput<I, S extends Message> {
      * Identifies the Entity record being changed.
      */
     readonly entityId: I;
-    /**
-     * Requires this current record before applying the next record.
-     */
-    readonly expected?: EntityRecord;
     /**
      * Stores the next current record.
      */
@@ -46,22 +46,23 @@ export interface EntityCommitInput<I, S extends Message> {
     readonly events?: readonly Event[];
 }
 /**
- * Reports the durable outcome of one Entity commit attempt.
- */
-export type EntityCommitResult = "committed" | "conflict";
-/**
- * A provider handle for atomic changes to one bounded Entity scope.
+ * A provider handle for coordinated changes to one bounded Entity scope.
+ *
+ * Memory and transactional database providers apply each commit atomically.
+ * MyISAM and Aria tables can retain partial writes if a commit fails.
  */
 export interface EntityCommitStorage {
     /**
-     * Applies one complete Entity mutation.
+     * Applies one Entity mutation across its current, history, and delivery records.
      *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state message type.
      * @param input Defines the unit of Entity, history, and delivery-event work.
-     * @returns Resolves to the committed or conflict outcome.
+     * @returns Resolves when the Entity mutation completes.
      */
-    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<EntityCommitResult>;
+    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<void>;
     /**
-     * Closes this independently owned commit handle.
+     * Closes this independent commit handle.
      */
     close(): void;
 }
@@ -70,8 +71,10 @@ export interface EntityCommitStorage {
  */
 export interface EntityCommitStorageFactory {
     /**
-     * Creates a handle that atomically mutates Entity persistence for one provider.
+     * Creates a handle that coordinates Entity persistence changes for one provider.
      *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state message type.
      * @param input Identifies the Entity storage layout the handle may commit.
      * @returns The independently closeable provider commit handle.
      */
@@ -82,23 +85,25 @@ export interface EntityCommitStorageFactory {
  */
 interface EntityCommitFactoryAccess {
     /**
-     * Registers the atomic commit capability of one storage factory.
+     * Registers the Entity commit capability of one storage factory.
      *
      * @param factory Identifies the storage factory that provides the capability.
-     * @param creator Creates atomic commit handles for that provider.
+     * @param creator Creates coordinated commit handles for that provider.
      */
     register(factory: StorageFactory, creator: EntityCommitStorageFactory): void;
     /**
-     * Creates an atomic commit handle registered by a storage provider.
+     * Creates a commit handle registered by a storage provider.
      *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state message type.
      * @param factory Identifies the provider storage factory.
      * @param input Defines the Entity storage layout to commit.
-     * @returns The provider-owned atomic commit handle.
+     * @returns The provider commit handle.
      */
     create<I, S extends Message>(factory: StorageFactory, input: EntityStorageInput<I, S>): EntityCommitStorage;
 }
 /**
- * Provides the typed internal lookup for provider-owned atomic commit handles.
+ * Provides the typed internal lookup for provider-managed atomic commit handles.
  *
  * Provider adapters register their creator while constructing their factory;
  * the end-user storage root deliberately exposes no commit-construction method.

package/dist/internal/entity-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-commit.d.ts","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAGrD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;;;;OAKG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE1F;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAGzC;;;;;OAKG;IACH,yBAAyB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC5C,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,yBAAyB;IAGjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAE7E;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACzB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,yBAczC,CAAC"}
+{"version":3,"file":"entity-commit.d.ts","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAGrD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAGzC;;;;;;;OAOG;IACH,yBAAyB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC5C,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,yBAAyB;IAGjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAE7E;;;;;;;;OAQG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACzB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,yBAuBzC,CAAC"}

package/dist/internal/entity-commit.js

@@ -12,7 +12,7 @@
  * the License.
  */
 /**
- * Provides the typed internal lookup for provider-owned atomic commit handles.
+ * Provides the typed internal lookup for provider-managed atomic commit handles.
  *
  * Provider adapters register their creator while constructing their factory;
  * the end-user storage root deliberately exposes no commit-construction method.
@@ -21,6 +21,15 @@ export const EntityCommitStorageFactories = Object.freeze({
     register(factory, creator) {
         creators.set(factory, creator);
     },
+    /**
+     * Creates the registered provider's Entity commit handle.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state message type.
+     * @param factory Identifies the registered provider.
+     * @param input Defines the Entity scope.
+     * @returns The provider commit handle.
+     */
     create(factory, input) {
         const creator = creators.get(factory);
         if (creator === undefined)

package/dist/internal/entity-commit.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-commit.js","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA8B,MAAM,CAAC,MAAM,CAAC;IACnF,QAAQ,CAAC,OAAuB,EAAE,OAAmC;QACnE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CACJ,OAAuB,EACvB,KAA+B;QAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,OAAO,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8C,CAAC"}
+{"version":3,"file":"entity-commit.js","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA8B,MAAM,CAAC,MAAM,CAAC;IACnF,QAAQ,CAAC,OAAuB,EAAE,OAAmC;QACnE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,OAAuB,EACvB,KAA+B;QAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,OAAO,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8C,CAAC"}

package/dist/internal/entity-history.d.ts

@@ -8,5 +8,5 @@ export type { EntityRecord, EntityRecordStorage } from "../entity/entity-record.
 export { eventHistorySpec, stateHistorySpec } from "../entity/entity-history-record-spec.js";
 export { EntityHistoryConformance, type EntityHistoryConformanceAdapter, type EntityStorageConformance, } from "../entity/history-conformance.js";
 export type { EntityIdCodec, EntityStorageInput } from "../memory/in-memory-entity-history.js";
-export type { EntityCommitInput, EntityCommitResult, EntityCommitStorage, EntityCommitStorageFactory, } from "./entity-commit.js";
+export type { EntityCommitInput, EntityCommitStorage, EntityCommitStorageFactory, } from "./entity-commit.js";
 //# sourceMappingURL=entity-history.d.ts.map

package/dist/internal/entity-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC/F,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC/F,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/memory/canonical-utf8.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-utf8.d.ts","sourceRoot":"","sources":["../../src/memory/canonical-utf8.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,eAAO,MAAM,aAAa;IAGxB;;;;;;OAMG;kBACW,MAAM,SAAS,MAAM,GAAG,MAAM;IAW5C;;;;;OAKG;iBACU,MAAM,GAAG,UAAU;CAyBjC,CAAC"}
+{"version":3,"file":"canonical-utf8.d.ts","sourceRoot":"","sources":["../../src/memory/canonical-utf8.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,eAAO,MAAM,aAAa;IAGxB;;;;;;OAMG;kBACW,MAAM,SAAS,MAAM,GAAG,MAAM;IAgB5C;;;;;OAKG;iBACU,MAAM,GAAG,UAAU;CAyBjC,CAAC"}

package/dist/memory/canonical-utf8.js

@@ -24,15 +24,22 @@ export const CanonicalUtf8 = {
      * @returns A negative, zero, or positive comparison result.
      */
     compare(left, right) {
-        const leftBytes = CanonicalUtf8.bytes(left);
-        const rightBytes = CanonicalUtf8.bytes(right);
-        const length = Math.min(leftBytes.length, rightBytes.length);
-        for (let index = 0; index < length; index += 1) {
-            const difference = (leftBytes[index] ?? 0) - (rightBytes[index] ?? 0);
+        if (left === right)
+            return 0;
+        let leftIndex = 0;
+        let rightIndex = 0;
+        while (leftIndex < left.length && rightIndex < right.length) {
+            const first = left.codePointAt(leftIndex);
+            const second = right.codePointAt(rightIndex);
+            if (first === undefined || second === undefined)
+                break;
+            const difference = first - second;
             if (difference !== 0)
                 return difference;
+            leftIndex += first > 0xffff ? 2 : 1;
+            rightIndex += second > 0xffff ? 2 : 1;
         }
-        return leftBytes.length - rightBytes.length;
+        return (leftIndex < left.length ? 1 : 0) - (rightIndex < right.length ? 1 : 0);
     },
     /**
      * Encodes a string as canonical UTF-8 bytes.

package/dist/memory/canonical-utf8.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-utf8.js","sourceRoot":"","sources":["../../src/memory/canonical-utf8.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,kBAAkB;IAElB;;;;;;OAMG;IACH,OAAO,CAAC,IAAY,EAAE,KAAa;QACjC,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,IAAI,UAAU,KAAK,CAAC;gBAAE,OAAO,UAAU,CAAC;QAC1C,CAAC;QACD,OAAO,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAa;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,SAAS,KAAK,SAAS;gBAAE,SAAS;YACtC,IAAI,SAAS,GAAG,MAAM;gBAAE,KAAK,EAAE,CAAC;YAChC,IAAI,SAAS,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBACxC,IAAI,SAAS,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;iBACvF,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CACR,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EACxB,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAChC,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC1B,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CACR,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EACxB,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EACjC,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAChC,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC1B,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}
+{"version":3,"file":"canonical-utf8.js","sourceRoot":"","sources":["../../src/memory/canonical-utf8.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,kBAAkB;IAElB;;;;;;OAMG;IACH,OAAO,CAAC,IAAY,EAAE,KAAa;QACjC,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,OAAO,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM;YACvD,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;YAClC,IAAI,UAAU,KAAK,CAAC;gBAAE,OAAO,UAAU,CAAC;YACxC,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,UAAU,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAa;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,SAAS,KAAK,SAAS;gBAAE,SAAS;YACtC,IAAI,SAAS,GAAG,MAAM;gBAAE,KAAK,EAAE,CAAC;YAChC,IAAI,SAAS,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBACxC,IAAI,SAAS,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;iBACvF,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CACR,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EACxB,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAChC,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC1B,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CACR,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EACxB,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EACjC,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAChC,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC1B,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/memory/in-memory-entity-commit.d.ts

@@ -1,5 +1,5 @@
 import { type Message } from "@bufbuild/protobuf";
-import type { EntityCommitInput, EntityCommitResult, EntityCommitStorage } from "../internal/entity-commit.js";
+import type { EntityCommitInput, EntityCommitStorage } from "../internal/entity-commit.js";
 import type { RecordSpec } from "../record/record-spec.js";
 import type { StorageGroup } from "../record/storage-group.js";
 import type { StorageContext } from "../storage/storage.js";
@@ -7,7 +7,17 @@ import type { StorageFactory } from "../storage/storage-factory.js";
 import { MemoryEntityStorageFactory, type EntityStorageInput } from "./in-memory-entity-history.js";
 import { TenantRecords } from "./tenant-records.js";
 /**
- * Implements provider-owned Entity commits for one shared in-memory backend.
+ * Opens the in-memory tenant slice for a generated record family.
+ * @typeParam I Record identifier type.
+ * @typeParam R Record message type.
+ * @param context Supplies the storage and tenant context.
+ * @param spec Supplies the materialized record layout.
+ * @param group Selects a grouped history family when present.
+ * @returns The tenant record slice.
+ */
+type OpenRecords = <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>, group?: StorageGroup) => TenantRecords<I, R>;
+/**
+ * Implements provider Entity commits for one shared in-memory backend.
  */
 export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
     #private;
@@ -15,21 +25,43 @@ export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
      * Creates a commit handle bound to one Entity source type.
      *
      * @param entities Opens the matching current Entity storage.
-     * @param factory Owns the Event Store coordination lock.
+     * @param factory Provides the Event Store coordination lock.
      * @param openRecords Opens exact generic-record backing slices.
      * @param input Defines the Entity storage source type.
      */
-    constructor(entities: MemoryEntityStorageFactory, factory: StorageFactory, openRecords: <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>, group?: StorageGroup) => TenantRecords<I, R>, input: EntityStorageInput<unknown, Message>);
+    constructor(entities: MemoryEntityStorageFactory, factory: StorageFactory, openRecords: OpenRecords, input: EntityStorageInput<unknown, Message>);
     /**
      * Applies one fully preflighted in-memory Entity commit.
      *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
      * @param input Defines the current record, retained histories, and delivery events.
-     * @returns The durable in-memory commit outcome.
+     * @returns Completion after the in-memory commit.
      */
-    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<EntityCommitResult>;
+    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<void>;
     /**
      * Closes this commit handle without closing sibling handles.
      */
     close(): void;
+    /**
+     * Opens only record families used by one commit.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Supplies configured histories and delivery Events.
+     * @returns Live affected record families and their layouts.
+     */
+    private live;
+    /**
+     * Captures affected rows and creates isolated adapters for preparation.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Supplies the proposed record changes.
+     * @param backend Supplies the live current-record map.
+     * @returns The prepared affected-record workspace.
+     */
+    private stage;
 }
+export {};
 //# sourceMappingURL=in-memory-entity-commit.d.ts.map

package/dist/memory/in-memory-entity-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-entity-commit.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAOnE,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAGL,0BAA0B,EAG1B,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD;;GAEG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;;IAWnE;;;;;;;OAOG;gBAED,QAAQ,EAAE,0BAA0B,EACpC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAChC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,YAAY,KACjB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EACxB,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAQ7C;;;;;OAKG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWzF;;OAEG;IACH,KAAK,IAAI,IAAI;CAoId"}
+{"version":3,"file":"in-memory-entity-commit.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAGL,0BAA0B,EAG1B,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACtC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,YAAY,KACjB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzB;;GAEG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;;IAenE;;;;;;;OAOG;gBAED,QAAQ,EAAE,0BAA0B,EACpC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAU7C;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3E;;OAEG;IACH,KAAK,IAAI,IAAI;IAyBb;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI;IAsBZ;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK;CA6Nd"}