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

package/dist/event/event-store.js

@@ -0,0 +1,407 @@
+/*
+ * 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, create, ScalarType } from "@bufbuild/protobuf";
+import { TimestampSchema } from "@bufbuild/protobuf/wkt";
+import { EventIdSchema, EventSchema, TenantIdSchema } from "@spine-event-engine/proto";
+import { RecordColumn } from "../record/record-column.js";
+import { ColumnTypes } from "../record/column-type.js";
+import { RecordSpec } from "../record/record-spec.js";
+import { TenantBoundary } from "../internal/tenancy.js";
+/**
+ * Framework event store backed by record storage.
+ *
+ * Snapshots input events before queued work, rejects missing, blank, and
+ * duplicate IDs in one batch, and rejects IDs already stored for the same
+ * captured storage context.
+ */
+export class EventStore {
+    #context;
+    #factory;
+    #open = true;
+    /**
+     * Creates an event store for one storage context.
+     *
+     * @param context Specifies the storage context.
+     * @param factory Creates the backing record storage.
+     */
+    constructor(context, factory) {
+        this.#context = EventContexts.base(context);
+        this.#factory = factory;
+    }
+    /**
+     * Returns whether this Event Store still accepts operations.
+     *
+     * @returns Returns true until this Event Store is closed.
+     */
+    isOpen() {
+        return this.#open;
+    }
+    /**
+     * Closes this Event Store. Operation-selected storage handles close after use.
+     */
+    close() {
+        this.#open = false;
+    }
+    /**
+     * Validates that one generated Spine event can be appended without storing it.
+     *
+     * @param event Supplies the event to validate.
+     * @returns Completes when the event is accepted.
+     */
+    async accept(event) {
+        const record = clone(EventSchema, event);
+        const context = EventContexts.snapshotForEvent(this.#context, record);
+        await this.checkUnique([EventIds.require(record)], context);
+    }
+    /**
+     * Accepts one event, runs caller acceptance, and appends using one captured
+     * storage context.
+     *
+     * @param event Supplies the event to accept.
+     * @param onAccepted Runs after uniqueness validation and before append.
+     * @returns Resolves to the appended event snapshot.
+     */
+    async acceptThenAppend(event, onAccepted) {
+        const record = clone(EventSchema, event);
+        const context = EventContexts.snapshotForEvent(this.#context, record);
+        await this.checkUnique([EventIds.require(record)], context);
+        await onAccepted(clone(EventSchema, record));
+        await this.appendUnique([record], context);
+        return clone(EventSchema, record);
+    }
+    /**
+     * Writes one generated Spine event, rejecting missing, blank, or duplicate IDs.
+     *
+     * @param event Supplies the event to append.
+     * @returns Completes when the event is appended.
+     */
+    async append(event) {
+        const record = clone(EventSchema, event);
+        await this.appendUnique([record], EventContexts.snapshotForEvent(this.#context, record));
+    }
+    /**
+     * Writes generated Spine events in order, rejecting missing, blank, or duplicate IDs.
+     *
+     * @param events Supplies the events to append.
+     * @returns Completes when the events are appended.
+     */
+    async appendAll(events) {
+        const records = [...events].map((event) => clone(EventSchema, event));
+        if (records.length > 0) {
+            await this.appendUnique(records, EventContexts.batch(this.#context, records));
+        }
+    }
+    /**
+     * Writes generated Spine events and returns a one-shot rollback token.
+     *
+     * @param events Supplies the events to append.
+     * @returns Resolves to the rollback token for this append.
+     */
+    async appendAllWithRollback(events) {
+        const records = [...events].map((event) => clone(EventSchema, event));
+        const ids = records.map((record) => EventIds.require(record));
+        const context = records.length === 0 ? undefined : EventContexts.batch(this.#context, records);
+        if (context !== undefined) {
+            await this.appendUnique(records, context);
+        }
+        let used = false;
+        return Object.freeze({
+            rollback: async () => {
+                if (used) {
+                    throw new Error("Event rollback token has already been used.");
+                }
+                used = true;
+                if (context !== undefined)
+                    await this.deleteIds(ids, context);
+            },
+        });
+    }
+    /**
+     * Reads persisted events through the underlying record-storage query seam.
+     *
+     * @param query Specifies the record query.
+     * @returns Resolves to matching events.
+     */
+    async read(query = {}) {
+        this.requireOpen();
+        const storage = this.#factory.createRecordStorage(EventContexts.snapshot(this.#context), eventStoreRecordSpec);
+        try {
+            return await storage.query(query);
+        }
+        finally {
+            storage.close();
+        }
+    }
+    async appendUnique(records, context) {
+        this.requireOpen();
+        const ids = records.map((record) => EventIds.require(record));
+        EventIds.rejectDuplicates(ids);
+        await eventStoreAccess.withLock(this.#factory, context, async () => {
+            const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec);
+            try {
+                await EventIds.insertUnique(storage, records);
+            }
+            finally {
+                storage.close();
+            }
+        });
+    }
+    async deleteIds(ids, context) {
+        this.requireOpen();
+        await eventStoreAccess.withLock(this.#factory, context, async () => {
+            const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec);
+            try {
+                for (const id of ids) {
+                    await storage.delete(id);
+                }
+            }
+            finally {
+                storage.close();
+            }
+        });
+    }
+    async checkUnique(ids, context) {
+        this.requireOpen();
+        EventIds.rejectDuplicates(ids);
+        await eventStoreAccess.withLock(this.#factory, context, async () => {
+            const storage = this.#factory.createRecordStorage(context, eventStoreRecordSpec);
+            try {
+                await EventIds.rejectStored(storage, ids);
+            }
+            finally {
+                storage.close();
+            }
+        });
+    }
+    requireOpen() {
+        if (!this.#open)
+            throw new Error("EventStore is closed.");
+    }
+}
+const EventStoreLocks = Object.freeze({
+    queues: new WeakMap(),
+    async withLock(factory, context, work) {
+        const queues = this.queueMap(factory);
+        const key = EventContexts.key(context);
+        const previous = queues.get(key) ?? Promise.resolve();
+        const next = previous.then(work, work);
+        const stored = next.then(() => undefined, () => undefined);
+        queues.set(key, stored);
+        try {
+            return await next;
+        }
+        finally {
+            if (queues.get(key) === stored) {
+                queues.delete(key);
+            }
+        }
+    },
+    queueMap(factory) {
+        let queues = this.queues.get(factory);
+        if (queues === undefined) {
+            queues = new Map();
+            this.queues.set(factory, queues);
+        }
+        return queues;
+    },
+});
+/**
+ * Provider-only coordination access for the Event Store context lock.
+ * @internal
+ */
+export const eventStoreAccess = Object.freeze({
+    // prettier-ignore
+    /**
+     * Runs work under the same factory/context lock used by direct Event Store appends.
+     *
+     * @param factory The factory that owns the Event Store records.
+     * @param context The Event Store context to serialize.
+     * @param work The operation to run while holding the lock.
+     * @returns The operation result.
+     */
+    withLock(factory, context, work) {
+        return EventStoreLocks.withLock(factory, context, work);
+    },
+});
+/**
+ * Validates event IDs before record-store operations.
+ */
+const EventIds = {
+    // prettier-ignore
+    /**
+     * Requires an event to have a non-blank ID.
+     */
+    require(event) {
+        if (event.id === undefined)
+            throw new Error("EventStore requires event.id.");
+        if (event.id.value.trim().length === 0) {
+            throw new Error("EventStore requires a non-empty event.id.value.");
+        }
+        return event.id;
+    },
+    /**
+     * Rejects IDs that already exist in storage.
+     */
+    async rejectStored(storage, ids) {
+        if ((await storage.index({ ids })).length > 0) {
+            throw new Error("EventStore requires unique event IDs.");
+        }
+    },
+    /**
+     * Atomically inserts each event ID and rolls back this batch on collision.
+     */
+    async insertUnique(storage, records) {
+        if (!storage.atomicCompareAndSet) {
+            throw new Error("EventStore requires atomic record compare-and-set.");
+        }
+        const inserted = [];
+        try {
+            for (const record of records) {
+                const id = EventIds.require(record);
+                if (!(await storage.compareAndSet(id, undefined, record))) {
+                    throw new Error("EventStore requires unique event IDs.");
+                }
+                inserted.push({ id, record });
+            }
+        }
+        catch (error) {
+            const failures = [];
+            for (const { id, record } of inserted.reverse()) {
+                try {
+                    if (!(await storage.compareAndSet(id, record, undefined))) {
+                        failures.push(new Error("EventStore append rollback lost its stored event."));
+                    }
+                }
+                catch (rollbackError) {
+                    failures.push(rollbackError);
+                }
+            }
+            if (failures.length > 0) {
+                throw new AggregateError([error, ...failures], "EventStore append rollback failed.");
+            }
+            throw error;
+        }
+    },
+    /**
+     * Rejects repeated IDs within one append operation.
+     */
+    rejectDuplicates(ids) {
+        const seen = new Set();
+        for (const id of ids) {
+            if (seen.has(id.value))
+                throw new Error("EventStore requires unique event IDs.");
+            seen.add(id.value);
+        }
+    },
+};
+/**
+ * Captures tenant-aware event-store contexts and their lock keys.
+ */
+const EventContexts = {
+    // prettier-ignore
+    /**
+     * Captures one storage context.
+     */
+    base(context) {
+        return context.multitenant
+            ? Object.freeze({
+                name: context.name,
+                multitenant: true,
+                ...(context.tenantId === undefined
+                    ? {}
+                    : { tenantId: clone(TenantIdSchema, context.tenantId) }),
+            })
+            : Object.freeze({ name: context.name, multitenant: false });
+    },
+    snapshot(context) {
+        if (!context.multitenant)
+            return Object.freeze({ name: context.name, multitenant: false });
+        if (context.tenantId === undefined)
+            throw new Error("Multitenant EventStore reads require a complete tenant ID.");
+        const boundary = TenantBoundary.from(context.tenantId);
+        const tenantId = boundary.tenantId;
+        return Object.freeze({
+            name: context.name,
+            multitenant: true,
+            tenantId,
+        });
+    },
+    /**
+     * Captures one context using an event envelope tenant when present.
+     */
+    snapshotForEvent(context, event) {
+        if (!context.multitenant)
+            return EventContexts.snapshot(context);
+        const tenantId = EventContexts.readEventTenant(event) ?? context.tenantId;
+        if (tenantId === undefined)
+            throw new Error("Multitenant EventStore append requires an event tenant ID.");
+        return EventContexts.snapshot({
+            name: context.name,
+            multitenant: true,
+            tenantId,
+        });
+    },
+    batch(context, events) {
+        const first = events[0];
+        if (first === undefined)
+            throw new Error("EventStore batch requires at least one event.");
+        const selected = EventContexts.snapshotForEvent(context, first);
+        const key = TenantBoundary.of(selected).key;
+        for (const event of events.slice(1)) {
+            if (TenantBoundary.of(EventContexts.snapshotForEvent(context, event)).key !== key)
+                throw new Error("One EventStore batch cannot contain events from different tenants.");
+        }
+        return selected;
+    },
+    /**
+     * Reads an explicit tenant from an event envelope.
+     */
+    readEventTenant(event) {
+        switch (event.context?.origin.case) {
+            case "importContext":
+                return EventContexts.tenantValue(event.context.origin.value.tenantId);
+            case "pastMessage":
+                return EventContexts.tenantValue(event.context.origin.value.actorContext?.tenantId);
+            default:
+                return undefined;
+        }
+    },
+    /**
+     * Converts a typed tenant ID to its storage-scope value.
+     */
+    tenantValue(tenantId) {
+        return tenantId === undefined ? undefined : clone(TenantIdSchema, tenantId);
+    },
+    /**
+     * Creates a deterministic key for a context-scoped append lock.
+     */
+    key(context) {
+        return TenantBoundary.of(context).key;
+    },
+};
+/**
+ * Provides the canonical event-store record layout to provider-only internals.
+ *
+ * @internal
+ */
+export const eventStoreRecordSpec = new RecordSpec({
+    recordType: EventSchema,
+    idSchema: EventIdSchema,
+    extractId: (event) => EventIds.require(event),
+    columns: [
+        new RecordColumn("created", ColumnTypes.message(TimestampSchema), (event) => event.context?.timestamp ?? create(TimestampSchema)),
+        new RecordColumn("type", ColumnTypes.scalar(ScalarType.STRING), (event) => event.message?.typeUrl),
+    ],
+});
+//# sourceMappingURL=event-store.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { EventStore, type EventRollback, type EventStoreContext, type OnEventAccepted, } from "./event/event-store.js";
+export type { EntityEventStorage, EntityStateHistoryStorage, } from "./entity/entity-history-storage.js";
+export { InMemoryRecordStorage } from "./memory/in-memory-record-storage.js";
+export { InMemoryStorageBackend } from "./memory/in-memory-storage-backend.js";
+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 { 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 { RecordQuery } from "./record/record-query.js";
+export { RecordSpec, type RecordSpecOptions } from "./record/record-spec.js";
+export { RecordStorage } from "./record/record-storage.js";
+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

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

package/dist/index.js

@@ -0,0 +1,30 @@
+/*
+ * 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 { EventStore, } from "./event/event-store.js";
+export { InMemoryRecordStorage } from "./memory/in-memory-record-storage.js";
+export { InMemoryStorageBackend } from "./memory/in-memory-storage-backend.js";
+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 { 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

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

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

@@ -0,0 +1,99 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { RecordSpec } from "../record/record-spec.js";
+import type { StorageContext } from "../storage/storage.js";
+import type { StorageFactory } from "../storage/storage-factory.js";
+/**
+ * Describes cooperative operation state at a provider safe boundary.
+ */
+export interface CleanupOperation {
+    /**
+     * Indicates whether cancellation has been requested.
+     */
+    readonly signal?: {
+        readonly aborted: boolean;
+    };
+    /**
+     * Carries the admitted non-negative timeout budget.
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Determines whether the admission-relative deadline remains active.
+     *
+     * @returns Whether provider work remains within its admitted deadline.
+     */
+    readonly isActive?: () => boolean;
+}
+/**
+ * Determines whether a cleanup operation may proceed at a provider safe boundary.
+ *
+ * @param operation Supplies cooperative cancellation and deadline state.
+ * @returns Whether provider work may continue.
+ */
+export declare function cleanupOperationActive(operation: CleanupOperation | undefined): boolean;
+/**
+ * Describes provider input for one fenced exact delivered-row removal.
+ */
+export interface DeliveryCleanupInput<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message> {
+    /**
+     * Selects the tenant and storage group containing both records.
+     */
+    readonly context: StorageContext;
+    /**
+     * Carries cooperative cancellation and an internal admission-relative activity predicate.
+     */
+    readonly operation?: CleanupOperation;
+    /**
+     * Describes the exact delivered Inbox record expected for deletion.
+     */
+    readonly inbox: {
+        readonly spec: RecordSpec<InboxId, InboxRecord>;
+        readonly id: InboxId;
+        readonly expected: InboxRecord;
+    };
+    /**
+     * Describes the current shard-session record that fences deletion.
+     */
+    readonly session: {
+        readonly spec: RecordSpec<SessionId, SessionRecord>;
+        readonly id: SessionId;
+        readonly expected: SessionRecord;
+        readonly isCurrent: (record: SessionRecord) => boolean;
+    };
+}
+/**
+ * Defines a provider-owned handle for atomically deleting a fenced Inbox record.
+ */
+export interface DeliveryCleanupStorage {
+    /**
+     * Removes an exact Inbox record after validating the current session.
+     *
+     * @param input Describes the records and ownership predicate for deletion.
+     * @returns Whether the provider deleted the exact Inbox record.
+     */
+    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;
+}
+/**
+ * Defines a provider factory capability narrower than a general transaction API.
+ */
+export interface DeliveryCleanupStorageFactory {
+    /**
+     * Creates a provider-owned cleanup handle.
+     *
+     * @returns The cleanup handle bound to this provider.
+     */
+    createDeliveryCleanupStorage(): DeliveryCleanupStorage;
+}
+interface DeliveryCleanupFactoryAccess {
+    register(factory: StorageFactory, creator: DeliveryCleanupStorageFactory): void;
+    create(factory: StorageFactory): DeliveryCleanupStorage;
+}
+/**
+ * Registers and resolves provider cleanup handles for direct delivery.
+ */
+export declare const DeliveryCleanupStorageFactories: DeliveryCleanupFactoryAccess;
+export {};
+//# sourceMappingURL=delivery-cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-cleanup.d.ts","sourceRoot":"","sources":["../../src/internal/delivery-cleanup.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAG/B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAIvF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CACnC,OAAO,EACP,WAAW,SAAS,OAAO,EAC3B,SAAS,EACT,aAAa,SAAS,OAAO;IAI7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAChD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;KAChC,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACpD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;QACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC;KACxD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IAGrC;;;;;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,CAAC;IAGpB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAG5C;;;;OAIG;IACH,4BAA4B,IAAI,sBAAsB,CAAC;CACxD;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAChF,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAAC;CACzD;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,4BAU5C,CAAC"}

package/dist/internal/delivery-cleanup.js

@@ -0,0 +1,38 @@
+/*
+ * 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.
+ */
+/**
+ * Determines whether a cleanup operation may proceed at a provider safe boundary.
+ *
+ * @param operation Supplies cooperative cancellation and deadline state.
+ * @returns Whether provider work may continue.
+ */
+export function cleanupOperationActive(operation) {
+    return (!operation?.signal?.aborted && operation?.timeoutMs !== 0 && operation?.isActive?.() !== false);
+}
+/**
+ * Registers and resolves provider cleanup handles for direct delivery.
+ */
+export const DeliveryCleanupStorageFactories = Object.freeze({
+    register(factory, creator) {
+        creators.set(factory, creator);
+    },
+    create(factory) {
+        const creator = creators.get(factory);
+        if (creator === undefined)
+            throw new Error("StorageFactory does not provide atomic delivery cleanup storage.");
+        return creator.createDeliveryCleanupStorage();
+    },
+});
+const creators = new WeakMap();
+//# sourceMappingURL=delivery-cleanup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-cleanup.js","sourceRoot":"","sources":["../../src/internal/delivery-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAuC;IAC5E,OAAO,CACL,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,IAAI,SAAS,EAAE,SAAS,KAAK,CAAC,IAAI,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,KAAK,CAC/F,CAAC;AACJ,CAAC;AAqFD;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAiC,MAAM,CAAC,MAAM,CAAC;IACzF,QAAQ,CAAC,OAAuB,EAAE,OAAsC;QACtE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,CAAC,OAAuB;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAChD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAiD,CAAC"}