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

package/dist/memory/memory-delivery-cleanup.d.ts

@@ -0,0 +1,32 @@
+import type { Message } from "@bufbuild/protobuf";
+import { type DeliveryCleanupInput, type DeliveryCleanupStorage } from "../internal/delivery-cleanup.js";
+import type { RecordSpec } from "../record/record-spec.js";
+import type { StorageContext } from "../storage/storage.js";
+import type { StorageGroup } from "../record/storage-group.js";
+import { TenantRecords } from "./tenant-records.js";
+/**
+ * Provides an in-memory critical section for fenced delivery cleanup.
+ */
+export declare class MemoryDeliveryCleanupStorage implements DeliveryCleanupStorage {
+    #private;
+    private readonly records;
+    /**
+     * Creates an in-memory cleanup handle.
+     *
+     * @param records Resolves a tenant-scoped record family.
+     */
+    constructor(records: <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>, group?: StorageGroup) => TenantRecords<I, R>);
+    /**
+     * Removes an exact Inbox record while its session record remains current.
+     *
+     * @param input Describes the records and ownership predicate for deletion.
+     * @returns Whether the exact Inbox record was removed.
+     */
+    remove<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message>(input: DeliveryCleanupInput<InboxId, InboxRecord, SessionId, SessionRecord>): Promise<boolean>;
+    /**
+     * Closes this cleanup handle to further removal operations.
+     */
+    close(): void;
+    private static active;
+}
+//# sourceMappingURL=memory-delivery-cleanup.d.ts.map

package/dist/memory/memory-delivery-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-delivery-cleanup.d.ts","sourceRoot":"","sources":["../../src/memory/memory-delivery-cleanup.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,qBAAa,4BAA6B,YAAW,sBAAsB;;IASvE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B;;;;OAIG;gBAEgB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC7C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,YAAY,KACjB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAG1B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,SAAS,OAAO,EAAE,SAAS,EAAE,aAAa,SAAS,OAAO,EACnF,KAAK,EAAE,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,GAC1E,OAAO,CAAC,OAAO,CAAC;IAmBnB;;OAEG;IACH,KAAK,IAAI,IAAI;IAGb,OAAO,CAAC,MAAM,CAAC,MAAM;CAGtB"}

package/dist/memory/memory-delivery-cleanup.js

@@ -0,0 +1,61 @@
+/*
+ * 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 { cleanupOperationActive, } from "../internal/delivery-cleanup.js";
+import { TenantRecords } from "./tenant-records.js";
+/**
+ * Provides an in-memory critical section for fenced delivery cleanup.
+ */
+export class MemoryDeliveryCleanupStorage {
+    records;
+    #open = true;
+    /**
+     * Creates an in-memory cleanup handle.
+     *
+     * @param records Resolves a tenant-scoped record family.
+     */
+    constructor(records) {
+        this.records = records;
+    }
+    /**
+     * Removes an exact Inbox record while its session record remains current.
+     *
+     * @param input Describes the records and ownership predicate for deletion.
+     * @returns Whether the exact Inbox record was removed.
+     */
+    remove(input) {
+        if (!this.#open)
+            return Promise.reject(new Error("Delivery cleanup storage is closed."));
+        if (!MemoryDeliveryCleanupStorage.active(input))
+            return Promise.resolve(false);
+        const sessions = this.records(input.context, input.session.spec);
+        const current = sessions.read(input.session.id);
+        if (current === undefined || !input.session.isCurrent(current))
+            return Promise.resolve(false);
+        const expectedSession = input.session.spec.materialize(input.session.expected);
+        if (!sessions.compareAndSet(input.session.id, expectedSession, expectedSession))
+            return Promise.resolve(false);
+        const inbox = this.records(input.context, input.inbox.spec);
+        return Promise.resolve(inbox.compareAndSet(input.inbox.id, input.inbox.spec.materialize(input.inbox.expected), undefined));
+    }
+    /**
+     * Closes this cleanup handle to further removal operations.
+     */
+    close() {
+        this.#open = false;
+    }
+    static active(input) {
+        return cleanupOperationActive(input.operation);
+    }
+}
+//# sourceMappingURL=memory-delivery-cleanup.js.map

package/dist/memory/memory-delivery-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-delivery-cleanup.js","sourceRoot":"","sources":["../../src/memory/memory-delivery-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,sBAAsB,GAIvB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,OAAO,4BAA4B;IASpB;IARnB,KAAK,GAAG,IAAI,CAAC;IAEb;;;;OAIG;IACH,YACmB,OAIO;QAJP,YAAO,GAAP,OAAO,CAIA;IACvB,CAAC;IAEJ;;;;;OAKG;IACH,MAAM,CACJ,KAA2E;QAE3E,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9F,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/E,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,eAAe,CAAC;YAC7E,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC,OAAO,CACpB,KAAK,CAAC,aAAa,CACjB,KAAK,CAAC,KAAK,CAAC,EAAE,EACd,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAClD,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IACO,MAAM,CAAC,MAAM,CAAC,KAAgD;QACpE,OAAO,sBAAsB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/memory/tenant-records.d.ts

@@ -0,0 +1,66 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { RecordQuery } from "../record/record-query.js";
+import type { RecordSpec } from "../record/record-spec.js";
+import type { RecordEntry } from "../record/record-storage.js";
+/**
+ * Record slice owned by one tenant of an in-memory record storage.
+ */
+export declare class TenantRecords<I, R extends Message> {
+    #private;
+    /**
+     * Compares and replaces an expected materialized record in this tenant slice.
+     * @param id Identifies the storage slot to compare and replace.
+     * @param expected Specifies the materialized record required at the slot.
+     * @param next Specifies the replacement record, or removes the slot when absent.
+     * @returns Whether the expected record matched and the mutation was applied.
+     */
+    compareAndSet(id: I, expected: StoredRecord<I, R> | undefined, next: StoredRecord<I, R> | undefined): boolean;
+    /**
+     * Removes one storage slot from this tenant slice.
+     * @param id Identifies the storage slot to remove.
+     * @returns Whether a record occupied the slot.
+     */
+    delete(id: I): boolean;
+    /**
+     * Returns materialized records matching a tenant-scoped query.
+     * @param spec Supplies record identity cloning and materialized columns.
+     * @param query Specifies filters, ordering, continuation, and windowing.
+     * @returns The matching logical record entries in query order.
+     */
+    queryEntries(spec: RecordSpec<I, R>, query: RecordQuery<I>): readonly RecordEntry<I, R>[];
+    /**
+     * Reads one record from this tenant slice.
+     * @param id Identifies the storage slot to read.
+     * @returns The stored record, or undefined when the slot is empty.
+     */
+    read(id: I): R | undefined;
+    /**
+     * Stores one materialized record in this tenant slice.
+     * @param record Supplies the materialized record and storage identity.
+     */
+    write(record: StoredRecord<I, R>): void;
+    /**
+     * Stores all materialized records in this tenant slice.
+     * @param records Supplies the materialized records to store.
+     */
+    writeAll(records: readonly StoredRecord<I, R>[]): void;
+    /**
+     * Copies the materialized rows for a provider-owned staged commit.
+     *
+     * @returns An independent snapshot of the current rows.
+     */
+    snapshot(): Map<string, StoredEntry<I, R>>;
+    /**
+     * Replaces all rows from a fully validated staged snapshot.
+     *
+     * @param snapshot Supplies the staged materialized rows.
+     */
+    replace(snapshot: Map<string, StoredEntry<I, R>>): void;
+}
+type StoredRecord<I, R extends Message> = ReturnType<RecordSpec<I, R>["materialize"]>;
+interface StoredEntry<I, R extends Message> {
+    readonly slotId: I;
+    readonly stored: StoredRecord<I, R>;
+}
+export {};
+//# sourceMappingURL=tenant-records.d.ts.map

package/dist/memory/tenant-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-records.d.ts","sourceRoot":"","sources":["../../src/memory/tenant-records.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAIV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO/D;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;;IAG7C;;;;;;OAMG;IACH,aAAa,CACX,EAAE,EAAE,CAAC,EACL,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EACxC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,GACnC,OAAO;IAoBV;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAItB;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAIzF;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAOvC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;IAMtD;;;;OAIG;IACH,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI1C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;CAIxD;AAED,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;AAEtF,UAAU,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACrC"}