@spine-event-engine/storage 2.0.0-snapshot.2 → 2.0.0-snapshot.21

package/README.md

@@ -5,6 +5,37 @@ includes an in-memory implementation for local development and tests. Use it
 when an application needs a small record store, or when an adapter needs to
 implement the same storage contract for a durable provider.
 
+This is an experimental snapshot package. Use Node 24 or newer and generated
+Protobuf record schemas before configuring storage.
+
+## Install and write one record
+
+Install the storage contract and Protobuf-ES in the application or adapter that
+owns persistence:
+
+```sh
+pnpm add @spine-event-engine/storage@snapshot @bufbuild/protobuf
+```
+
+The following in-memory record flow is suitable for a local test:
+
+```ts
+import { create } from "@bufbuild/protobuf";
+import { StringValueSchema } from "@bufbuild/protobuf/wkt";
+import { InMemoryStorageFactory, RecordSpec } from "@spine-event-engine/storage";
+
+const records = new InMemoryStorageFactory().createRecordStorage(
+  { name: "Users", multitenant: false },
+  new RecordSpec({
+    recordType: StringValueSchema,
+    idKind: "string",
+    extractId: (user) => user.value,
+  }),
+);
+await records.write(create(StringValueSchema, { value: "ava" }));
+console.log((await records.read("ava"))?.value);
+```
+
 For detailed query, lifecycle, and adapter notes, see
 [REFERENCE documentation for agents](REFERENCE.md).
 
@@ -22,9 +53,8 @@ pnpm typecheck:build
 ```
 
 Run this workspace-wide TypeScript build from the repository root. For an
-experimental npm consumer, install
-`@spine-event-engine/storage@2.0.0-snapshot.2` or the explicit
-`@spine-event-engine/storage@snapshot` tag.
+experimental npm consumer, install `@spine-event-engine/storage@snapshot`.
+The snapshot tag can change before a stable release.
 
 ## 🧪 Start with the Proto fields people may query
 
@@ -95,8 +125,8 @@ The storage API clones data at its boundaries. For the base factory and the
 in-memory implementation, closing a factory prevents new record handles while
 existing handles remain usable. Closing a record handle invalidates that
 handle's later operations. Other adapters can close live handles; see their
-[Datastore reference](../storage-datastore/REFERENCE.md) and
-[MySQL reference](../storage-rdbms/REFERENCE.md) before choosing shutdown
+[Datastore reference](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-datastore/REFERENCE.md) and
+[MySQL reference](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-mysql/REFERENCE.md) before choosing shutdown
 behavior.
 
 ## 🧩 Keep compatible record families separate
@@ -135,15 +165,17 @@ ordinary Event Store is intentionally ungrouped.
 ## 🗄️ Choose a durable adapter
 
 `@spine-event-engine/storage-datastore` provides Google Cloud Datastore
-storage. `@spine-event-engine/storage-rdbms` provides MySQL storage. Configure
+storage. `@spine-event-engine/storage-mysql` provides MySQL storage and
+`@spine-event-engine/storage-postgres` provides PostgreSQL storage. Configure
 those packages in application code and pass the resulting factory to the Spine
 server; this package does not choose a database.
 
-| Need                        | Adapter                                                                   |
-| --------------------------- | ------------------------------------------------------------------------- |
-| Local development and tests | `InMemoryStorageFactory` in this package                                  |
-| Google Cloud Datastore      | [`@spine-event-engine/storage-datastore`](../storage-datastore/README.md) |
-| MySQL                       | [`@spine-event-engine/storage-rdbms`](../storage-rdbms/README.md)         |
+| Need                        | Adapter                                                                                                                                  |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| Local development and tests | `InMemoryStorageFactory` in this package                                                                                                 |
+| Google Cloud Datastore      | [`@spine-event-engine/storage-datastore`](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-datastore/README.md) |
+| MySQL                       | [`@spine-event-engine/storage-mysql`](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-mysql/README.md)         |
+| PostgreSQL                  | [`@spine-event-engine/storage-postgres`](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-postgres/README.md)   |
 
 ## ⚠️ Lifecycle differences
 
@@ -154,7 +186,8 @@ shutdown and queries.
 
 ## 🔗 Learn more
 
-- [Datastore adapter](../storage-datastore/README.md)
-- [MySQL adapter](../storage-rdbms/README.md)
-- [Server](../server/README.md)
+- [Datastore adapter](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-datastore/README.md)
+- [MySQL adapter](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-mysql/README.md)
+- [PostgreSQL adapter](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/storage-postgres/README.md)
+- [Server](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/server/README.md)
 - [Reference for coding agents](REFERENCE.md)

package/REFERENCE.md

@@ -6,16 +6,18 @@ This reference is for agents working with the Spine TS storage contract.
 
 Import public types from `@spine-event-engine/storage`. The entry point exports
 `StorageFactory`, `RecordStorage`, `RecordSpec`, `RecordSpecOptions`, `RecordColumn`, `RecordQuery`,
-`RecordMask`, `StorageGroup`, `ColumnTypes`, `ColumnMappings`, the exported
-column-mapping contracts, `TenantBoundary`, `TenantCatalog`,
-`TenantCatalogProvider`, `InMemoryStorageFactory`,
+`StorageGroup`, `ColumnTypes`, `ColumnMappings`, the exported
+column-mapping contracts, `InMemoryStorageFactory`,
 `InMemoryStorageBackend`, event-store types, normalized query policy/evaluator
 types, and entity history interfaces.
-The `./internal/entity-history` subpath supplies Entity records, source-type
-inputs, and current/state/event-history ports. The separate
-`./internal/entity-commit` subpath supplies atomic commit input/result types,
-`EntityCommitStorage`, and `EntityCommitStorageFactories`; both are
-framework/provider seams, not application-facing remote APIs.
+
+## Provider SPI
+
+Storage-adapter implementers import the complete provider-only contract set from
+`@spine-event-engine/storage/provider`: Event Store record access, Entity
+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.
 
 ## Record storage
 
@@ -76,9 +78,9 @@ name validation from the common query shape.
 
 The normalized-plan matrix is intentionally provider-specific. MySQL admits
 IDs; equality and the five comparisons on mapped orderable columns; nested
-`all` and `either`; declared-column ordering; positive limits; and masks.
+`all` and `either`; declared-column ordering; and positive limits.
 Datastore admits only IDs, equality, one provider-legal inequality column, flat
-`all`, compatible ordering, limits, and masks. Both reject unsupported shapes
+`all`, compatible ordering, and limits. Both reject unsupported shapes
 before provider access. Normalized plans never include offset: the existing
 `RecordQuery.offset` path is separate. MySQL executes every admitted predicate,
 order, and finite bound in contained parameterized SQL; Datastore executes only
@@ -92,14 +94,14 @@ until each handle closes. `RecordStorage.close()` rejects that handle's later
 operations. Datastore follows the base factory behavior. Adapters can define a
 stronger shutdown lifecycle: the MySQL factory closes live handles while it
 drains its pool. Read the [Datastore reference](../storage-datastore/REFERENCE.md)
-and [MySQL reference](../storage-rdbms/REFERENCE.md) before relying on shutdown
+and [MySQL reference](../storage-mysql/REFERENCE.md) or [PostgreSQL reference](../storage-postgres/REFERENCE.md) before relying on shutdown
 behavior. The in-memory backend is ephemeral and process-local. Passing one
 `InMemoryStorageBackend` to multiple in-memory factories deliberately shares
 its scoped rows.
 
 ## Entity storage
 
-The `./internal/entity-history` seam supplies the framework's Entity storage
+The provider SPI supplies the framework's Entity storage
 ports. Current Entity state is a generated `spine.server.entity.EntityRecord`.
 Retained state history stores generated `EntityStateKey`/`EntityRecord` rows in
 a `StorageGroup` named after the Entity state type. Retained diagnostic event
@@ -112,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 separate `./internal/entity-commit` port 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/index.d.ts

@@ -6,12 +6,11 @@ export { InMemoryStorageFactory } from "./memory/in-memory-storage-factory.js";
 export { StorageQueryPolicy } from "./query/query-policy.js";
 export { defaultQueryCandidateLimit, QueryCandidateLimitError, StorageQueryEvaluator, } from "./query/query-execution.js";
 export type { NormalizedQueryEntry } from "./query/query-execution.js";
-export type { NormalizedComparisonOperator, NormalizedQueryMask, NormalizedQueryOrder, NormalizedQueryPlan, NormalizedQueryPredicate, StorageQueryCapabilities, StorageQueryFeature, } from "./query/query-policy.js";
+export type { NormalizedComparisonOperator, NormalizedQueryOrder, NormalizedQueryPlan, NormalizedQueryPredicate, StorageQueryCapabilities, StorageQueryFeature, } from "./query/query-policy.js";
 export { RecordColumn } from "./record/record-column.js";
 export { ColumnTypes, type RecordColumnType } from "./record/column-type.js";
 export { ColumnMappings, type ColumnMapping, type ColumnTypeMapping, } from "./record/column-mapping.js";
-export { RecordMask } from "./record/record-mask.js";
-export type { RecordContinuation, RecordContinuationValue, RecordFilter, RecordOrder, RecordReadOptions, } from "./record/record-query.js";
+export type { RecordContinuation, RecordContinuationValue, RecordFilter, RecordOrder, } from "./record/record-query.js";
 export { RecordQuery } from "./record/record-query.js";
 export { RecordSpec, type RecordSpecOptions } from "./record/record-spec.js";
 export { RecordStorage } from "./record/record-storage.js";
@@ -19,5 +18,4 @@ export { StorageGroup } from "./record/storage-group.js";
 export type { RecordEntry } from "./record/record-storage.js";
 export type { Storage, StorageContext, StorageMode } from "./storage/storage.js";
 export { StorageFactory } from "./storage/storage-factory.js";
-export { TenantBoundary, type TenantCatalog, type TenantCatalogProvider, } from "./internal/tenancy.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -20,11 +20,9 @@ export { defaultQueryCandidateLimit, QueryCandidateLimitError, StorageQueryEvalu
 export { RecordColumn } from "./record/record-column.js";
 export { ColumnTypes } from "./record/column-type.js";
 export { ColumnMappings, } from "./record/column-mapping.js";
-export { RecordMask } from "./record/record-mask.js";
 export { RecordQuery } from "./record/record-query.js";
 export { RecordSpec } from "./record/record-spec.js";
 export { RecordStorage } from "./record/record-storage.js";
 export { StorageGroup } from "./record/storage-group.js";
 export { StorageFactory } from "./storage/storage-factory.js";
-export { TenantBoundary, } from "./internal/tenancy.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,UAAU,GAIX,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAWpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAyB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,GAGf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAQrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAA0B,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACL,cAAc,GAGf,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,UAAU,GAIX,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAyB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,GAGf,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAA0B,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

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"}