@spine-event-engine/storage 2.0.0-snapshot.10

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

@@ -0,0 +1,108 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { Event } from "@spine-event-engine/proto";
+import type { EntityRecord } from "../entity/entity-record.js";
+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.
+ *
+ * This provider-only contract combines current state, retained histories, and
+ * framework delivery events. It is intentionally not an application-level
+ * transaction API.
+ */
+export interface EntityCommitInput<I, S extends Message> {
+    /**
+     * Identifies the storage scope that owns this commit.
+     */
+    readonly context: StorageContext;
+    /**
+     * Defines the Entity storage layout mutated by this commit.
+     */
+    readonly entity: EntityStorageInput<I, S>;
+    /**
+     * 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.
+     */
+    readonly next: EntityRecord;
+    /**
+     * Appends retained Entity state-history rows.
+     */
+    readonly states?: readonly EntityRecord[];
+    /**
+     * Appends retained diagnostic Entity-event rows.
+     */
+    readonly diagnostics?: readonly Event[];
+    /**
+     * Appends canonical framework delivery events.
+     */
+    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.
+ */
+export interface EntityCommitStorage {
+    /**
+     * Applies one complete Entity mutation.
+     *
+     * @param input Defines the unit of Entity, history, and delivery-event work.
+     * @returns Resolves to the committed or conflict outcome.
+     */
+    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<EntityCommitResult>;
+    /**
+     * Closes this independently owned commit handle.
+     */
+    close(): void;
+}
+/**
+ * Defines the provider-only storage-factory capability required by repositories.
+ */
+export interface EntityCommitStorageFactory {
+    /**
+     * Creates a handle that atomically mutates Entity persistence for one provider.
+     *
+     * @param input Identifies the Entity storage layout the handle may commit.
+     * @returns The independently closeable provider commit handle.
+     */
+    createEntityCommitStorage<I, S extends Message>(input: EntityStorageInput<I, S>): EntityCommitStorage;
+}
+/**
+ * The framework-only access point for provider commit factories.
+ */
+interface EntityCommitFactoryAccess {
+    /**
+     * Registers the atomic 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.
+     */
+    register(factory: StorageFactory, creator: EntityCommitStorageFactory): void;
+    /**
+     * Creates an atomic commit handle registered by a storage provider.
+     *
+     * @param factory Identifies the provider storage factory.
+     * @param input Defines the Entity storage layout to commit.
+     * @returns The provider-owned atomic 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.
+ *
+ * Provider adapters register their creator while constructing their factory;
+ * the end-user storage root deliberately exposes no commit-construction method.
+ */
+export declare const EntityCommitStorageFactories: EntityCommitFactoryAccess;
+export {};
+//# sourceMappingURL=entity-commit.d.ts.map

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

@@ -0,0 +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"}

package/dist/internal/entity-commit.js

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Provides the typed internal lookup for provider-owned atomic commit handles.
+ *
+ * Provider adapters register their creator while constructing their factory;
+ * the end-user storage root deliberately exposes no commit-construction method.
+ */
+export const EntityCommitStorageFactories = Object.freeze({
+    register(factory, creator) {
+        creators.set(factory, creator);
+    },
+    create(factory, input) {
+        const creator = creators.get(factory);
+        if (creator === undefined)
+            throw new Error("StorageFactory does not provide the required atomic Entity commit storage.");
+        return creator.createEntityCommitStorage(input);
+    },
+});
+const creators = new WeakMap();
+//# sourceMappingURL=entity-commit.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,12 @@
+/**
+ * Provider-only entity persistence SPI. This subpath is intentionally not part
+ * of the end-user storage root; storage adapters import it directly.
+ */
+export type { EntityEventHistoryPort, EntityStateHistoryPort, } from "../entity/entity-history-storage.js";
+export { disabledEventHistoryPort, disabledStateHistoryPort, } from "../entity/entity-history-storage.js";
+export type { EntityRecord, EntityRecordStorage } from "../entity/entity-record.js";
+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";
+//# sourceMappingURL=entity-history.d.ts.map

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

@@ -0,0 +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"}

package/dist/internal/entity-history.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+export { disabledEventHistoryPort, disabledStateHistoryPort, } from "../entity/entity-history-storage.js";
+export { eventHistorySpec, stateHistorySpec } from "../entity/entity-history-record-spec.js";
+export { EntityHistoryConformance, } from "../entity/history-conformance.js";
+//# sourceMappingURL=entity-history.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-history.js","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EACL,wBAAwB,GAGzB,MAAM,kCAAkC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Provider-only Event Store record layout.
+ *
+ * Storage adapters use this subpath to address the same durable records as the
+ * framework Event Store without adding the layout to the end-user package root.
+ */
+export { eventStoreAccess, eventStoreRecordSpec } from "../event/event-store.js";
+//# sourceMappingURL=event-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/internal/event-store.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/internal/event-store.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Provider-only Event Store record layout.
+ *
+ * Storage adapters use this subpath to address the same durable records as the
+ * framework Event Store without adding the layout to the end-user package root.
+ */
+export { eventStoreAccess, eventStoreRecordSpec } from "../event/event-store.js";
+//# sourceMappingURL=event-store.js.map

package/dist/internal/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../src/internal/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/internal/query-values.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Internal shared query-value semantics for storage adapters.
+ */
+export { StorageQueryValues } from "../query/query-execution.js";
+//# sourceMappingURL=query-values.d.ts.map

package/dist/internal/query-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-values.d.ts","sourceRoot":"","sources":["../../src/internal/query-values.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/internal/query-values.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Internal shared query-value semantics for storage adapters.
+ */
+export { StorageQueryValues } from "../query/query-execution.js";
+//# sourceMappingURL=query-values.js.map

package/dist/internal/query-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-values.js","sourceRoot":"","sources":["../../src/internal/query-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/internal/tenancy.d.ts

@@ -0,0 +1,89 @@
+import { type TenantId } from "@spine-event-engine/proto";
+import type { StorageContext } from "../storage/storage.js";
+/**
+ * Provider-selection identity for one complete generated tenant value.
+ *
+ * @internal
+ */
+export interface TenantBoundary {
+    /**
+     * Stable in-process map key. Single tenancy uses one private symbol.
+     */
+    readonly key: string | symbol;
+    /**
+     * Whether this is the one explicit single-tenant boundary.
+     */
+    readonly single: boolean;
+    /**
+     * Complete cloned tenant ID, absent only for single tenancy.
+     */
+    readonly tenantId: TenantId | undefined;
+}
+interface MultitenantTenantBoundary extends TenantBoundary {
+    readonly single: false;
+    readonly tenantId: TenantId;
+}
+interface TenantBoundaryFactory {
+    readonly single: TenantBoundary;
+    /**
+     * Creates a boundary for the supplied tenant.
+     *
+     * @param tenantId The complete generated tenant identifier.
+     * @returns The immutable tenant boundary.
+     */
+    from(tenantId: TenantId): MultitenantTenantBoundary;
+    /**
+     * Selects the boundary declared by a storage context.
+     *
+     * @param context The storage context.
+     * @returns The validated tenant boundary.
+     */
+    of(context: StorageContext): TenantBoundary;
+}
+/**
+ * Creates immutable provider tenant boundaries.
+ *
+ * @internal
+ */
+export declare const TenantBoundary: TenantBoundaryFactory;
+/**
+ * Provider-owned enumeration of storage tenant boundaries.
+ *
+ * @internal
+ */
+export interface TenantCatalog {
+    /**
+     * Lists the boundaries available for storage-backed startup work.
+     *
+     * @returns The available tenant boundaries.
+     */
+    all(): Promise<readonly TenantBoundary[]>;
+    /**
+     * Closes resources owned by this catalog.
+     *
+     * @returns Completion of resource release.
+     */
+    close(): Promise<void>;
+    /**
+     * Records an admitted tenant when the provider requires an early cache.
+     *
+     * @param boundary The admitted boundary.
+     * @returns Completion of the catalog update.
+     */
+    keep(boundary: TenantBoundary): Promise<void>;
+}
+/**
+ * Storage-factory capability that owns one tenant catalog.
+ *
+ * @internal
+ */
+export interface TenantCatalogProvider {
+    /**
+     * Returns the catalog owned by this storage factory.
+     *
+     * @returns The provider-owned tenant catalog.
+     */
+    tenantCatalog(): TenantCatalog;
+}
+export {};
+//# sourceMappingURL=tenancy.d.ts.map

package/dist/internal/tenancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../../src/internal/tenancy.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAG7B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;CACzC;AAED,UAAU,yBAA0B,SAAQ,cAAc;IACxD,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,yBAAyB,CAAC;IAEpD;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAAC;CAC7C;AAQD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,qBAuC5B,CAAC;AA0CF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAG5B;;;;OAIG;IACH,GAAG,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAE1C;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAGpC;;;;OAIG;IACH,aAAa,IAAI,aAAa,CAAC;CAChC"}

package/dist/internal/tenancy.js

@@ -0,0 +1,97 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { clone, toBinary } from "@bufbuild/protobuf";
+import { TenantIdSchema } from "@spine-event-engine/proto";
+const singleTenantKey = Symbol("single tenant");
+const singleTenantBoundary = Object.freeze({
+    key: singleTenantKey,
+    single: true,
+    tenantId: undefined,
+});
+/**
+ * Creates immutable provider tenant boundaries.
+ *
+ * @internal
+ */
+export const TenantBoundary = {
+    // prettier-ignore
+    /**
+     * The explicit singleton used by single-tenant providers.
+     */
+    single: singleTenantBoundary,
+    /**
+     * Creates a boundary from a complete generated tenant ID.
+     *
+     * @param tenantId The generated tenant ID.
+     * @returns An immutable tenant boundary.
+     */
+    from(tenantId) {
+        return new MultitenantBoundary(tenantId);
+    },
+    /**
+     * Returns the boundary declared by a storage context.
+     *
+     * @param context The diagnostic context and tenant selection.
+     * @returns The validated provider tenant boundary.
+     */
+    of(context) {
+        const tenantId = context.tenantId;
+        if (!context.multitenant) {
+            if (tenantId !== undefined) {
+                throw new Error(`Single-tenant storage "${context.name}" does not accept context.tenantId.`);
+            }
+            return singleTenantBoundary;
+        }
+        if (tenantId === undefined) {
+            throw new Error(`Multitenant storage "${context.name}" requires context.tenantId.`);
+        }
+        return new MultitenantBoundary(tenantId);
+    },
+};
+Object.freeze(TenantBoundary);
+class MultitenantBoundary {
+    #tenantId;
+    key;
+    single = false;
+    constructor(tenantId) {
+        TenantIds.require(tenantId);
+        this.#tenantId = clone(TenantIdSchema, tenantId);
+        this.key = TenantIds.key(this.#tenantId);
+        Object.freeze(this);
+    }
+    get tenantId() {
+        return clone(TenantIdSchema, this.#tenantId);
+    }
+}
+const TenantIds = Object.freeze({
+    require(tenantId) {
+        const kind = tenantId.kind;
+        const value = kind.case === "value"
+            ? kind.value
+            : kind.case === "domain" || kind.case === "email"
+                ? kind.value.value
+                : undefined;
+        if (value === undefined || value.trim().length === 0) {
+            throw new Error("Multitenant storage requires a non-empty TenantId.");
+        }
+    },
+    key(tenantId) {
+        const bytes = toBinary(TenantIdSchema, tenantId, { writeUnknownFields: false });
+        let encoded = "";
+        for (const byte of bytes)
+            encoded += byte.toString(16).padStart(2, "0");
+        return encoded;
+    },
+});
+//# sourceMappingURL=tenancy.js.map

package/dist/internal/tenancy.js.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * Internal canonical UTF-8 ordering shared by in-memory storage components.
+ */
+export declare const CanonicalUtf8: {
+    /**
+     * Compares strings by their canonical UTF-8 byte sequences.
+     *
+     * @param left The first string.
+     * @param right The second string.
+     * @returns A negative, zero, or positive comparison result.
+     */
+    compare(left: string, right: string): number;
+    /**
+     * Encodes a string as canonical UTF-8 bytes.
+     *
+     * @param value The string to encode.
+     * @returns Its canonical UTF-8 byte sequence.
+     */
+    bytes(value: string): Uint8Array;
+};
+//# sourceMappingURL=canonical-utf8.d.ts.map

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

@@ -0,0 +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"}

package/dist/memory/canonical-utf8.js

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Internal canonical UTF-8 ordering shared by in-memory storage components.
+ */
+export const CanonicalUtf8 = {
+    // prettier-ignore
+    /**
+     * Compares strings by their canonical UTF-8 byte sequences.
+     *
+     * @param left The first string.
+     * @param right The second string.
+     * @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 (difference !== 0)
+                return difference;
+        }
+        return leftBytes.length - rightBytes.length;
+    },
+    /**
+     * Encodes a string as canonical UTF-8 bytes.
+     *
+     * @param value The string to encode.
+     * @returns Its canonical UTF-8 byte sequence.
+     */
+    bytes(value) {
+        const bytes = [];
+        for (let index = 0; index < value.length; index += 1) {
+            const codePoint = value.codePointAt(index);
+            if (codePoint === undefined)
+                continue;
+            if (codePoint > 0xffff)
+                index++;
+            if (codePoint <= 0x7f)
+                bytes.push(codePoint);
+            else if (codePoint <= 0x7ff)
+                bytes.push(0xc0 | (codePoint >> 6), 0x80 | (codePoint & 0x3f));
+            else if (codePoint <= 0xffff) {
+                bytes.push(0xe0 | (codePoint >> 12), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+            }
+            else {
+                bytes.push(0xf0 | (codePoint >> 18), 0x80 | ((codePoint >> 12) & 0x3f), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+            }
+        }
+        return new Uint8Array(bytes);
+    },
+};
+//# sourceMappingURL=canonical-utf8.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,35 @@
+import { type Message } from "@bufbuild/protobuf";
+import type { EntityCommitInput, EntityCommitResult, 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";
+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.
+ */
+export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
+    #private;
+    /**
+     * 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 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>);
+    /**
+     * Applies one fully preflighted in-memory Entity commit.
+     *
+     * @param input Defines the current record, retained histories, and delivery events.
+     * @returns The durable in-memory commit outcome.
+     */
+    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<EntityCommitResult>;
+    /**
+     * Closes this commit handle without closing sibling handles.
+     */
+    close(): void;
+}
+//# sourceMappingURL=in-memory-entity-commit.d.ts.map

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

@@ -0,0 +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"}