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

package/dist/entity/history-conformance.js

@@ -11,8 +11,9 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
-import { create, fromBinary, ScalarType, toBinary } from "@bufbuild/protobuf";
-import { AnySchema, StringValueSchema, TimestampSchema, } from "@bufbuild/protobuf/wkt";
+import { create, ScalarType } from "@bufbuild/protobuf";
+import { AnyPacker } from "@spine-event-engine/core";
+import { StringValueSchema, TimestampSchema } from "@bufbuild/protobuf/wkt";
 import { EntityRecordSchema, } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
 import { EventIdSchema, EventSchema, VersionSchema } from "@spine-event-engine/proto";
 import { RecordColumn } from "../record/record-column.js";
@@ -25,30 +26,30 @@ export const EntityHistoryConformance = Object.freeze({
     // prettier-ignore
     /**
      * Checks the shared current-record behavior.
-     *
+     * @typeParam S Generated Entity state type.
      * @param adapter Supplies the provider under test.
      * @returns Completes when the behavior is verified.
      */
     async checkCurrentQueries(adapter) {
-        const storage = adapter.create(EntityHistoryFixture.input());
+        const storage = adapter.create(EntityHistoryFixture.input(adapter));
         try {
-            await storage.current.write(EntityHistoryFixture.record("task", "task", 3));
-            await storage.current.write(EntityHistoryFixture.record("later", "later", 4));
+            await storage.current.write(EntityHistoryFixture.record(adapter, "task", "task", 3));
+            await storage.current.write(EntityHistoryFixture.record(adapter, "later", "later", 4));
             const queried = await storage.current.query({
-                predicate: { kind: "comparison", column: "value", operator: "equal", value: "later" },
-                order: [{ column: "value", direction: "asc" }],
+                predicate: { kind: "comparison", column: "title", operator: "equal", value: "task" },
+                order: [{ column: "title", direction: "asc" }],
                 limit: 1,
                 candidateLimit: 2,
             });
             const current = await storage.current.read("task");
             EntityHistoryFixture.assert(current !== undefined, "current state must round-trip");
-            EntityHistoryFixture.assert(EntityHistoryFixture.state(current).value === "task", "current state must round-trip");
-            EntityHistoryFixture.assert(queried.length === 1 && queried[0]?.id === "later", "current queries must filter, order, and limit generated records");
+            EntityHistoryFixture.assert(adapter.value(EntityHistoryFixture.state(adapter, current)) === "task", "current state must round-trip");
+            EntityHistoryFixture.assert(queried.length === 1 && queried[0]?.id === "task", "current queries must filter, order, and limit generated records");
         }
         finally {
             storage.close?.();
         }
-        const reopened = adapter.reopen(EntityHistoryFixture.input());
+        const reopened = adapter.reopen(EntityHistoryFixture.input(adapter));
         try {
             EntityHistoryFixture.assert((await reopened.current.read("task")) !== undefined, "current record must survive reopen");
         }
@@ -58,31 +59,27 @@ export const EntityHistoryConformance = Object.freeze({
     },
     /**
      * Checks the generated state-history behavior.
-     *
+     * @typeParam S Generated Entity state type.
      * @param adapter Supplies the provider under test.
      * @returns Completes when the behavior is verified.
      */
     async check(adapter) {
         await EntityHistoryConformance.checkCurrentQueries(adapter);
-        const input = EntityHistoryFixture.input();
+        const input = EntityHistoryFixture.input(adapter);
         const storage = adapter.create(input);
         try {
-            await storage.states.append(EntityHistoryFixture.record("task", "first", 1));
-            await storage.states.append(EntityHistoryFixture.record("task", "second", 2));
+            await storage.states.append(EntityHistoryFixture.record(adapter, "task", "first", 1));
+            await storage.states.append(EntityHistoryFixture.record(adapter, "task", "second", 2));
             const backward = await storage.states.backward("task", 2);
             const newest = backward[0];
             const older = backward[1];
             EntityHistoryFixture.assert(newest !== undefined &&
                 older !== undefined &&
-                EntityHistoryFixture.state(newest).value === "second" &&
-                EntityHistoryFixture.state(older).value === "first", "state history must return newest records first");
-            EntityHistoryFixture.assert((await storage.states.stateAt("task", create(TimestampSchema, { seconds: 1n })))?.value ===
-                "first", "state history must return the state at an inclusive timestamp");
-            const event = EntityHistoryFixture.event("event", "task", 2);
-            await storage.events.append(event);
-            EntityHistoryFixture.assert((await storage.events.backward("task", 1))[0]?.id?.value === "event", "event history must retain generated events");
-            await storage.events.truncate(create(TimestampSchema, { seconds: 3n }));
-            EntityHistoryFixture.assert((await storage.events.backward("task", 1)).length === 0, "event history truncation must remove older generated events");
+                adapter.value(EntityHistoryFixture.state(adapter, newest)) === "second" &&
+                adapter.value(EntityHistoryFixture.state(adapter, older)) === "first", "state history must return newest records first");
+            const stateAt = await storage.states.stateAt("task", create(TimestampSchema, { seconds: 1n }));
+            EntityHistoryFixture.assert(stateAt !== undefined && adapter.value(stateAt) === "first", "state history must return the state at an inclusive timestamp");
+            await EntityHistoryFixture.checkEvents(storage.events);
         }
         finally {
             storage.close?.();
@@ -90,73 +87,121 @@ export const EntityHistoryConformance = Object.freeze({
     },
 });
 const EntityHistoryFixture = Object.freeze({
-    input() {
-        const unpack = (id) => id.typeUrl.endsWith(`/${StringValueSchema.typeName}`)
-            ? fromBinary(StringValueSchema, id.value).value
-            : undefined;
+    /**
+     * Builds provider input using the caller's generated Entity state schema.
+     * @typeParam S Generated Entity state type.
+     * @param adapter Generated state fixture and provider port factory.
+     * @returns Entity storage input for conformance checks.
+     */
+    input(adapter) {
+        const unpack = (id) => AnyPacker.tryUnpack(id, StringValueSchema)?.value;
         const columns = [
-            new RecordColumn("value", ColumnTypes.scalar(ScalarType.STRING), (record) => EntityHistoryFixture.state(record).value),
+            new RecordColumn("title", ColumnTypes.scalar(ScalarType.STRING), (record) => adapter.value(EntityHistoryFixture.state(adapter, record))),
         ];
         return {
             context: { name: "EntityHistoryConformance", multitenant: false },
             id: {
                 clone: (id) => id,
                 key: (id) => id,
-                pack: (id) => EntityHistoryFixture.pack(create(StringValueSchema, { value: id })),
+                pack: (id) => AnyPacker.pack(StringValueSchema, create(StringValueSchema, { value: id })),
                 unpack,
             },
             columns,
-            recordSpec: new RecordSpec({
-                sourceType: StringValueSchema,
-                recordType: EntityRecordSchema,
-                idKind: "string",
-                extractId: (record) => {
-                    if (record.entityId === undefined)
-                        throw new Error("EntityRecord requires entityId.");
-                    const id = unpack(record.entityId);
-                    if (id === undefined)
-                        throw new Error("EntityRecord has an incompatible ID.");
-                    return id;
-                },
-                columns,
-            }),
-            sourceType: StringValueSchema,
-            stateSchema: StringValueSchema,
+            recordSpec: EntityHistoryFixture.spec(adapter, unpack, columns),
+            sourceType: adapter.stateSchema,
+            stateSchema: adapter.stateSchema,
             stateHistory: true,
             eventHistory: true,
         };
     },
-    record(id, state, version) {
+    /**
+     * Creates a generated Entity record for one state version.
+     * @typeParam S Generated Entity state type.
+     * @param adapter Generated state fixture and provider port factory.
+     * @param id Entity identifier.
+     * @param value State title.
+     * @param version Entity version.
+     * @returns Generated Entity record.
+     */
+    record(adapter, id, value, version) {
         return create(EntityRecordSchema, {
-            entityId: EntityHistoryFixture.pack(create(StringValueSchema, { value: id })),
-            state: EntityHistoryFixture.pack(create(StringValueSchema, { value: state })),
+            entityId: AnyPacker.pack(StringValueSchema, create(StringValueSchema, { value: id })),
+            state: AnyPacker.pack(adapter.stateSchema, adapter.state(id, value)),
             version: {
                 number: version,
                 timestamp: create(TimestampSchema, { seconds: BigInt(version) }),
             },
         });
     },
-    pack(value) {
-        return create(AnySchema, {
-            typeUrl: `type.spine.io/${StringValueSchema.typeName}`,
-            value: toBinary(StringValueSchema, value),
-        });
-    },
-    state(record) {
+    /**
+     * Decodes the caller's Entity state from a generated record.
+     * @typeParam S Generated Entity state type.
+     * @param adapter Generated state fixture and provider port factory.
+     * @param record Generated Entity record.
+     * @returns Decoded generated Entity state.
+     */
+    state(adapter, record) {
         if (record.state === undefined)
             throw new Error("Entity record has no state.");
-        return fromBinary(StringValueSchema, record.state.value);
+        return AnyPacker.unpack(record.state, adapter.stateSchema);
     },
+    /**
+     * Builds the current-record specification for the generated state.
+     * @typeParam S Generated Entity state type.
+     * @param adapter Generated state fixture.
+     * @param unpack Decodes scalar Entity identifiers.
+     * @param columns Declared query columns.
+     * @returns Record specification.
+     */
+    spec(adapter, unpack, columns) {
+        return new RecordSpec({
+            sourceType: adapter.stateSchema,
+            recordType: EntityRecordSchema,
+            idKind: "string",
+            extractId: (record) => {
+                if (record.entityId === undefined)
+                    throw new Error("EntityRecord requires entityId.");
+                const id = unpack(record.entityId);
+                if (id === undefined)
+                    throw new Error("EntityRecord has an incompatible ID.");
+                return id;
+            },
+            columns,
+        });
+    },
+    /**
+     * Checks generated Event retention and truncation.
+     * @param events Event-history port.
+     * @returns Completion after Event assertions.
+     */
+    async checkEvents(events) {
+        await events.append(EntityHistoryFixture.event("event", "task", 2));
+        EntityHistoryFixture.assert((await events.backward("task", 1))[0]?.id?.value === "event", "event history must retain generated events");
+        await events.truncate(create(TimestampSchema, { seconds: 3n }));
+        EntityHistoryFixture.assert((await events.backward("task", 1)).length === 0, "event history truncation must remove older generated events");
+    },
+    /**
+     * Creates a generated diagnostic Event.
+     * @param id Event identifier.
+     * @param producer Producer Entity identifier.
+     * @param version Event version.
+     * @returns Generated Event.
+     */
     event(id, producer, version) {
         return create(EventSchema, {
             id: create(EventIdSchema, { value: id }),
             context: {
-                producerId: EntityHistoryFixture.pack(create(StringValueSchema, { value: producer })),
+                producerId: AnyPacker.pack(StringValueSchema, create(StringValueSchema, { value: producer })),
                 timestamp: create(TimestampSchema, { seconds: BigInt(version) }),
                 version: create(VersionSchema, { number: version }),
             },
         });
     },
+    /**
+     * Checks one conformance condition.
+     * @param condition Expected condition.
+     * @param message Failure explanation.
+     */
     assert(condition, message) {
         if (!condition)
             throw new Error(`Entity storage conformance failed: ${message}`);

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

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

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

@@ -1,8 +1,15 @@
 import type { Event, EventId, TenantId } from "@spine-event-engine/proto";
 import type { RecordQuery } from "../record/record-query.js";
 import { RecordSpec } from "../record/record-spec.js";
-import type { StorageGroup } from "../record/storage-group.js";
+import { StorageGroup } from "../record/storage-group.js";
 import type { StorageFactory } from "../storage/storage-factory.js";
+/**
+ * Stable physical Event record family for one logical context and store role.
+ */
+export declare const EventStoreGroups: Readonly<{
+    forContext(contextName: string, role?: "domain" | "system"): StorageGroup;
+    identity(group: StorageGroup): string | undefined;
+}>;
 /**
  * Framework event store backed by record storage.
  *
@@ -28,9 +35,22 @@ export declare class EventStore {
      */
     isOpen(): boolean;
     /**
-     * Closes this Event Store. Operation-selected storage handles close after use.
+     * Rejects new work, drains admitted storage groups, and closes retained handles.
+     * Repeated calls return the same close result.
+     *
+     * @returns Completion after all admitted work and storage cleanup settle.
+     */
+    close(): Promise<void>;
+    /**
+     * Waits for admitted physical work and then closes every retained handle.
+     *
+     * @returns Completion after admitted work and cleanup settle.
      */
-    close(): void;
+    private drainAndClose;
+    /**
+     * Closes every retained handle and reports all cleanup failures.
+     */
+    private closeStorages;
     /**
      * Validates strict new admission without storing an Event. An identical
      * existing Event still rejects; this precheck does not reserve its ID.
@@ -96,11 +116,39 @@ export declare class EventStore {
      * @returns Completion when no ID is stored.
      */
     private checkUnique;
+    /**
+     * Executes one complete physical storage operation through settlement.
+     *
+     * @typeParam T Operation result type.
+     * @param context Captured tenant scope.
+     * @param onStorage Work admitted against the retained handle.
+     * @returns The operation result or its original failure.
+     */
+    private runStorage;
+    /**
+     * Returns retained record storage for the captured tenant boundary.
+     *
+     * @param context Complete tenant-scoped storage context.
+     * @returns The retained record storage.
+     */
+    private storageFor;
     /**
      * Rejects operations after this Event Store closes.
      */
     private requireOpen;
 }
+/**
+ * Gives server assembly access to synchronous idle cleanup through the provider entrypoint.
+ * @internal
+ */
+export declare const eventStoreAccess: {
+    /**
+     * Closes an idle Event Store during synchronous assembly rollback.
+     *
+     * @param store Framework Event Store to close.
+     */
+    closeIdle(store: EventStore): void;
+};
 /**
  * Selects Event Store tenancy before an event envelope supplies a tenant.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/event/event-store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE;;;;;;;GAOG;AACH,qBAAa,UAAU;;IAqBrB;;;;;;OAMG;gBACS,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,YAAY;IAMrF;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;;;;OAQG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAUjF;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD;;;;;OAKG;IACG,IAAI,CAAC,KAAK,GAAE,WAAW,CAAC,OAAO,CAAM,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;IAcvE;;;;;;OAMG;YACW,YAAY;IAa1B;;;;;;OAMG;YACW,eAAe;IAW7B;;;;;;OAMG;YACW,WAAW;IAYzB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;CAC7B,GACD;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAmNrE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAgB1D,CAAC"}
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/event/event-store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AASpE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IACtC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;CACnD,CAoBC,CAAC;AAEH;;;;;;;GAOG;AACH,qBAAa,UAAU;;IAyCrB;;;;;;OAMG;gBACS,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,YAAY;IASrF;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCtB;;;;OAIG;YACW,aAAa;IAW3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;;;;OAQG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAUjF;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;;;;OAKG;IACG,IAAI,CAAC,KAAK,GAAE,WAAW,CAAC,OAAO,CAAM,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;IAOvE;;;;;;OAMG;YACW,YAAY;IAQ1B;;;;;;OAMG;YACW,eAAe;IAM7B;;;;;;OAMG;YACW,WAAW;IAOzB;;;;;;;OAOG;YACW,UAAU;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;;OAIG;qBACc,UAAU,GAAG,IAAI;CAKnC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;CAC7B,GACD;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAmNrE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAgB1D,CAAC"}

package/dist/event/event-store.js

@@ -17,7 +17,33 @@ import { EventIdSchema, EventSchema, TenantIdSchema } from "@spine-event-engine/
 import { RecordColumn } from "../record/record-column.js";
 import { ColumnTypes } from "../record/column-type.js";
 import { RecordSpec } from "../record/record-spec.js";
+import { StorageGroup } from "../record/storage-group.js";
 import { TenantBoundary } from "../internal/tenancy.js";
+const idleClosers = new WeakMap();
+const eventStoreSelections = new WeakMap();
+/**
+ * Stable physical Event record family for one logical context and store role.
+ */
+export const EventStoreGroups = Object.freeze({
+    /**
+     * Selects the readable Bounded Context name and retains the Event Store role.
+     *
+     * @param contextName Framework-validated logical context name.
+     * @param role Domain or paired System Event store.
+     * @returns Stable physical Event family selector.
+     */
+    forContext(contextName, role = "domain") {
+        const group = new StorageGroup(contextName);
+        eventStoreSelections.set(group, { name: contextName, role });
+        return group;
+    },
+    identity(group) {
+        const selection = eventStoreSelections.get(group);
+        return selection === undefined
+            ? undefined
+            : JSON.stringify(["EventStore", selection.role, selection.name]);
+    },
+});
 /**
  * Framework event store backed by record storage.
  *
@@ -36,9 +62,25 @@ export class EventStore {
      */
     #factory;
     /**
-     * Optional record family selector independent of the diagnostic context name.
+     * Record family selected by the logical context and store role.
      */
     #group;
+    /**
+     * Retains one record storage per complete tenant boundary.
+     */
+    #storages = new Map();
+    /**
+     * Tracks admitted physical storage groups until their complete operation settles.
+     */
+    #active = new Set();
+    /**
+     * Reuses one asynchronous close result across repeated calls.
+     */
+    #closing;
+    /**
+     * Retains the terminal result of synchronous assembly cleanup.
+     */
+    #idleOutcome;
     /**
      * Whether this Event Store accepts operations.
      */
@@ -53,7 +95,10 @@ export class EventStore {
     constructor(context, factory, group) {
         this.#context = EventContexts.base(context);
         this.#factory = factory;
-        this.#group = group;
+        this.#group = group ?? EventStoreGroups.forContext(this.#context.name);
+        idleClosers.set(this, () => {
+            this.#closeIdle();
+        });
     }
     /**
      * Returns whether this Event Store still accepts operations.
@@ -64,10 +109,80 @@ export class EventStore {
         return this.#open;
     }
     /**
-     * Closes this Event Store. Operation-selected storage handles close after use.
+     * Rejects new work, drains admitted storage groups, and closes retained handles.
+     * Repeated calls return the same close result.
+     *
+     * @returns Completion after all admitted work and storage cleanup settle.
      */
     close() {
+        if (this.#closing !== undefined)
+            return this.#closing;
+        if (this.#idleOutcome !== undefined) {
+            const error = this.#idleOutcome.error;
+            return error === undefined ? Promise.resolve() : Promise.reject(error);
+        }
         this.#open = false;
+        this.#closing = this.drainAndClose();
+        return this.#closing;
+    }
+    /**
+     * Closes an idle store during synchronous assembly cleanup.
+     * Active storage work is a misuse and leaves all handles open.
+     *
+     */
+    #closeIdle() {
+        if (this.#active.size > 0 || (this.#closing !== undefined && this.#idleOutcome === undefined))
+            throw new Error("EventStore closeIdle requires no active storage work.");
+        if (this.#idleOutcome !== undefined) {
+            if (this.#idleOutcome.error !== undefined)
+                throw this.#idleOutcome.error;
+            return;
+        }
+        this.#open = false;
+        try {
+            this.closeStorages();
+            this.#idleOutcome = {};
+        }
+        catch (error) {
+            this.#idleOutcome = { error: error };
+            throw error;
+        }
+    }
+    /**
+     * Waits for admitted physical work and then closes every retained handle.
+     *
+     * @returns Completion after admitted work and cleanup settle.
+     */
+    async drainAndClose() {
+        await Promise.allSettled([...this.#active]);
+        try {
+            this.closeStorages();
+            this.#idleOutcome = {};
+        }
+        catch (error) {
+            this.#idleOutcome = { error: error };
+            throw error;
+        }
+    }
+    /**
+     * Closes every retained handle and reports all cleanup failures.
+     */
+    closeStorages() {
+        const storages = [...this.#storages.values()];
+        this.#storages.clear();
+        const errors = [];
+        for (const storage of storages) {
+            try {
+                storage.close();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        if (errors.length === 1)
+            throw errors[0];
+        if (errors.length > 1)
+            throw new AggregateError(errors, "EventStore close failed.");
     }
     /**
      * Validates strict new admission without storing an Event. An identical
@@ -117,6 +232,7 @@ export class EventStore {
      * @returns Completes when the events are appended.
      */
     async appendAll(events) {
+        this.requireOpen();
         const records = [...events].map((event) => clone(EventSchema, event));
         if (records.length > 0) {
             await this.appendImmutable(records, EventContexts.batch(this.#context, records));
@@ -130,13 +246,7 @@ export class EventStore {
      */
     async read(query = {}) {
         this.requireOpen();
-        const storage = this.#factory.createRecordStorage(EventContexts.snapshot(this.#context), eventStoreRecordSpec, this.#group);
-        try {
-            return await storage.query(query);
-        }
-        finally {
-            storage.close();
-        }
+        return this.runStorage(EventContexts.snapshot(this.#context), (storage) => storage.query(query));
     }
     /**
      * Writes strictly new Events after caller acceptance.
@@ -149,13 +259,7 @@ export class EventStore {
         this.requireOpen();
         const ids = records.map((record) => EventIds.require(record));
         EventIds.rejectDuplicates(ids);
-        const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec, this.#group);
-        try {
-            await EventIds.insertUnique(storage, records);
-        }
-        finally {
-            storage.close();
-        }
+        await this.runStorage(context, (storage) => EventIds.insertUnique(storage, records));
     }
     /**
      * Writes captured immutable Events, accepting identical stored retries.
@@ -167,13 +271,7 @@ export class EventStore {
     async appendImmutable(records, context) {
         this.requireOpen();
         EventIds.rejectDuplicates(records.map((record) => EventIds.require(record)));
-        const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec, this.#group);
-        try {
-            await EventIds.insertImmutable(storage, records);
-        }
-        finally {
-            storage.close();
-        }
+        await this.runStorage(context, (storage) => EventIds.insertImmutable(storage, records));
     }
     /**
      * Checks strict admission without writing an Event.
@@ -185,14 +283,43 @@ export class EventStore {
     async checkUnique(ids, context) {
         this.requireOpen();
         EventIds.rejectDuplicates(ids);
-        const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec, this.#group);
+        await this.runStorage(context, (storage) => EventIds.rejectStored(storage, ids));
+    }
+    /**
+     * Executes one complete physical storage operation through settlement.
+     *
+     * @typeParam T Operation result type.
+     * @param context Captured tenant scope.
+     * @param onStorage Work admitted against the retained handle.
+     * @returns The operation result or its original failure.
+     */
+    async runStorage(context, onStorage) {
+        const storage = this.storageFor(context);
+        const work = Promise.resolve().then(() => onStorage(storage));
+        this.#active.add(work);
         try {
-            await EventIds.rejectStored(storage, ids);
+            return await work;
         }
         finally {
-            storage.close();
+            this.#active.delete(work);
         }
     }
+    /**
+     * Returns retained record storage for the captured tenant boundary.
+     *
+     * @param context Complete tenant-scoped storage context.
+     * @returns The retained record storage.
+     */
+    storageFor(context) {
+        this.requireOpen();
+        const key = TenantBoundary.of(context).key;
+        const existing = this.#storages.get(key);
+        if (existing !== undefined)
+            return existing;
+        const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec, this.#group);
+        this.#storages.set(key, storage);
+        return storage;
+    }
     /**
      * Rejects operations after this Event Store closes.
      */
@@ -201,6 +328,23 @@ export class EventStore {
             throw new Error("EventStore is closed.");
     }
 }
+/**
+ * Gives server assembly access to synchronous idle cleanup through the provider entrypoint.
+ * @internal
+ */
+export const eventStoreAccess = {
+    /**
+     * Closes an idle Event Store during synchronous assembly rollback.
+     *
+     * @param store Framework Event Store to close.
+     */
+    closeIdle(store) {
+        const close = idleClosers.get(store);
+        if (close === undefined)
+            throw new TypeError("EventStore idle cleanup requires an EventStore.");
+        close();
+    },
+};
 /**
  * Validates event IDs before record-store operations.
  */