@spine-event-engine/storage-postgres 2.0.0-snapshot.13

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

@@ -0,0 +1,76 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type DeliveryCleanupInput, type DeliveryCleanupStorage } from "@spine-event-engine/storage/provider";
+import type { RecordSpec, StorageContext } from "@spine-event-engine/storage";
+import { PostgresRecordStorage, type PostgresRecordLifecycle } from "./record-storage.js";
+/**
+ * Opens one tenant-bound PostgreSQL record family.
+ *
+ * @typeParam I Record identifier type.
+ * @typeParam R Stored Protobuf record type.
+ */
+type OpenRecords = <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>) => PostgresRecordStorage<I, R>;
+/**
+ * Deletes one delivered Inbox row only while its expected session record remains current.
+ */
+export declare class PostgresDeliveryCleanupStorage implements DeliveryCleanupStorage {
+    #private;
+    private readonly open;
+    private readonly lifecycle;
+    private readonly onClose;
+    /**
+     * Creates a PostgreSQL cleanup handle.
+     *
+     * @param open Opens tenant-bound Inbox and session record families.
+     * @param lifecycle Resolves the exact tenant-bound transaction lifecycle.
+     * @param onClose Removes this handle from the factory's live-handle set.
+     */
+    constructor(open: OpenRecords, lifecycle: (context: StorageContext) => PostgresRecordLifecycle, onClose: () => void);
+    /**
+     * Removes an exact Inbox row while its session snapshot remains current.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param input Describes the expected Inbox and session records.
+     * @returns Whether the exact Inbox row was deleted.
+     */
+    remove<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message>(input: DeliveryCleanupInput<InboxId, InboxRecord, SessionId, SessionRecord>): Promise<boolean>;
+    /**
+     * Closes this handle to new cleanup operations.
+     */
+    close(): void;
+    /**
+     * Executes one cleanup transaction with one retry for a serialization conflict.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param input Describes the expected Inbox and session records.
+     * @param inbox Provides the delivered Inbox record family.
+     * @param sessions Provides the session record family.
+     * @returns Whether the transaction deleted the Inbox row.
+     */
+    private coordinate;
+    /**
+     * Checks the expected records and deletes the Inbox row on one transaction client.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param client PostgreSQL transaction client.
+     * @param input Describes the expected Inbox and session records.
+     * @param inbox Provides the delivered Inbox record family.
+     * @param sessions Provides the session record family.
+     * @returns Whether the exact Inbox row was deleted.
+     */
+    private removeOn;
+    /**
+     * Rejects cleanup after this handle has closed.
+     */
+    private requireOpen;
+}
+export {};
+//# sourceMappingURL=delivery-cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-cleanup.d.ts","sourceRoot":"","sources":["../../src/postgres/delivery-cleanup.ts"],"names":[],"mappings":"AAcA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAQ9E,OAAO,EAAE,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE1F;;;;;GAKG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACtC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjC;;GAEG;AACH,qBAAa,8BAA+B,YAAW,sBAAsB;;IAWzE,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B;;;;;;OAMG;gBAEgB,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,uBAAuB,EAC/D,OAAO,EAAE,MAAM,IAAI;IAGtC;;;;;;;;;OASG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,SAAS,OAAO,EAAE,SAAS,EAAE,aAAa,SAAS,OAAO,EACzF,KAAK,EAAE,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,GAC1E,OAAO,CAAC,OAAO,CAAC;IAmBnB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;OAWG;YACW,UAAU;IAkCxB;;;;;;;;;;;;OAYG;YACW,QAAQ;IA4BtB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/postgres/delivery-cleanup.js

@@ -0,0 +1,224 @@
+/*
+ * 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 { toBinary } from "@bufbuild/protobuf";
+import { cleanupOperationActive, } from "@spine-event-engine/storage/provider";
+import { PostgresRollbackErrors, PostgresStorageOperationError, PostgresTransactionErrors, } from "./errors.js";
+import { PostgresRecordStorage } from "./record-storage.js";
+/**
+ * Deletes one delivered Inbox row only while its expected session record remains current.
+ */
+export class PostgresDeliveryCleanupStorage {
+    open;
+    lifecycle;
+    onClose;
+    #open = true;
+    /**
+     * Creates a PostgreSQL cleanup handle.
+     *
+     * @param open Opens tenant-bound Inbox and session record families.
+     * @param lifecycle Resolves the exact tenant-bound transaction lifecycle.
+     * @param onClose Removes this handle from the factory's live-handle set.
+     */
+    constructor(open, lifecycle, onClose) {
+        this.open = open;
+        this.lifecycle = lifecycle;
+        this.onClose = onClose;
+    }
+    /**
+     * Removes an exact Inbox row while its session snapshot remains current.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param input Describes the expected Inbox and session records.
+     * @returns Whether the exact Inbox row was deleted.
+     */
+    async remove(input) {
+        this.requireOpen();
+        if (!PostgresCleanupValues.active(input))
+            return false;
+        const inbox = this.open(input.context, input.inbox.spec);
+        const sessions = this.open(input.context, input.session.spec);
+        try {
+            await inbox.prepare();
+            await sessions.prepare();
+            if (!PostgresCleanupValues.active(input))
+                return false;
+            return await this.coordinate(input, inbox, sessions);
+        }
+        catch (error) {
+            if (error instanceof CleanupExpired)
+                return false;
+            throw error;
+        }
+        finally {
+            inbox.close();
+            sessions.close();
+        }
+    }
+    /**
+     * Closes this handle to new cleanup operations.
+     */
+    close() {
+        if (!this.#open)
+            return;
+        this.#open = false;
+        this.onClose();
+    }
+    /**
+     * Executes one cleanup transaction with one retry for a serialization conflict.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param input Describes the expected Inbox and session records.
+     * @param inbox Provides the delivered Inbox record family.
+     * @param sessions Provides the session record family.
+     * @returns Whether the transaction deleted the Inbox row.
+     */
+    async coordinate(input, inbox, sessions) {
+        for (let attempt = 0; attempt < 2; attempt += 1) {
+            const client = await this.lifecycle(input.context).acquire();
+            let discard;
+            try {
+                await client.query("BEGIN");
+                const result = await this.removeOn(client, input, inbox, sessions);
+                await client.query("COMMIT");
+                return result;
+            }
+            catch (error) {
+                try {
+                    await client.query("ROLLBACK");
+                }
+                catch {
+                    discard = PostgresRollbackErrors.discard(error);
+                }
+                if (error instanceof CleanupExpired)
+                    throw error;
+                if (attempt === 0 && PostgresTransactionErrors.retryable(error))
+                    continue;
+                throw PostgresCleanupErrors.operation(error);
+            }
+            finally {
+                client.release(discard);
+            }
+        }
+        throw new Error("Unreachable PostgreSQL cleanup retry.");
+    }
+    /**
+     * Checks the expected records and deletes the Inbox row on one transaction client.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param client PostgreSQL transaction client.
+     * @param input Describes the expected Inbox and session records.
+     * @param inbox Provides the delivered Inbox record family.
+     * @param sessions Provides the session record family.
+     * @returns Whether the exact Inbox row was deleted.
+     */
+    async removeOn(client, input, inbox, sessions) {
+        if (!PostgresCleanupValues.active(input))
+            return false;
+        const session = sessions.historyExecutor();
+        const delivered = inbox.historyExecutor();
+        await client.query("SELECT pg_advisory_xact_lock($1)", [session.lockRecord(input.session.id)]);
+        if (!PostgresCleanupValues.active(input))
+            return false;
+        const currentSession = await session.read(client, input.session.id, "for-update");
+        if (!PostgresCleanupValues.active(input))
+            return false;
+        if (!PostgresCleanupValues.current(input, currentSession))
+            return false;
+        const currentInbox = await delivered.read(client, input.inbox.id, "for-update");
+        if (!PostgresCleanupValues.same(input.inbox.spec, currentInbox, input.inbox.expected))
+            return false;
+        if (!PostgresCleanupValues.active(input))
+            return false;
+        const removed = await delivered.delete(client, input.inbox.id);
+        if (!PostgresCleanupValues.active(input))
+            throw new CleanupExpired();
+        return removed;
+    }
+    /**
+     * Rejects cleanup after this handle has closed.
+     */
+    requireOpen() {
+        if (!this.#open)
+            throw new PostgresStorageOperationError("Delivery cleanup storage is closed.");
+    }
+}
+const PostgresCleanupValues = Object.freeze({
+    /**
+     * Checks whether the caller still permits the cleanup operation.
+     *
+     * @param input Carries the optional operation lifetime.
+     * @returns Whether cleanup may continue.
+     */
+    active(input) {
+        return cleanupOperationActive(input.operation);
+    },
+    /**
+     * Compares the current session with the expected cleanup session.
+     *
+     * @typeParam InboxId Inbox record identifier type.
+     * @typeParam InboxRecord Inbox record message type.
+     * @typeParam SessionId Session record identifier type.
+     * @typeParam SessionRecord Session record message type.
+     * @param input Describes the expected cleanup records.
+     * @param actual Session record read inside the transaction.
+     * @returns Whether the session is still current and unchanged.
+     */
+    current(input, actual) {
+        return (actual !== undefined &&
+            input.session.isCurrent(actual) &&
+            this.same(input.session.spec, actual, input.session.expected));
+    },
+    /**
+     * Compares two records through their Protobuf wire representation.
+     *
+     * @typeParam I Record identifier type.
+     * @typeParam R Stored Protobuf record type.
+     * @param spec Describes the stored record schema.
+     * @param left Record read from PostgreSQL.
+     * @param right Expected record value.
+     * @returns Whether both records have identical wire bytes.
+     */
+    same(spec, left, right) {
+        return (left !== undefined &&
+            Buffer.compare(toBinary(spec.recordType, left), toBinary(spec.recordType, right)) === 0);
+    },
+});
+const PostgresCleanupErrors = Object.freeze({
+    /**
+     * Converts an internal cleanup failure to the stable provider error.
+     *
+     * @param error Failure raised inside the cleanup transaction.
+     * @returns Stable public cleanup error.
+     */
+    operation(error) {
+        return error instanceof PostgresStorageOperationError
+            ? error
+            : new PostgresStorageOperationError("PostgreSQL delivery cleanup failed.");
+    },
+});
+/**
+ * Signals that the cleanup lifetime ended after deletion but before commit.
+ */
+class CleanupExpired extends Error {
+}
+//# sourceMappingURL=delivery-cleanup.js.map

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

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

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

@@ -0,0 +1,114 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type RecordSpec, type StorageGroup } from "@spine-event-engine/storage";
+import { type EntityCommitInput, type EntityCommitResult, type EntityCommitStorage, type EntityStorageInput } from "@spine-event-engine/storage/provider";
+import { PostgresRecordStorage, type PostgresRecordLifecycle } from "./record-storage.js";
+/**
+ * Opens one PostgreSQL record family used by an Entity commit.
+ *
+ * @typeParam I Record identifier type.
+ * @typeParam R Stored Protobuf record type.
+ */
+type OpenRecords = <I, R extends Message>(spec: RecordSpec<I, R>, group?: StorageGroup) => PostgresRecordStorage<I, R>;
+/**
+ * Represents a factory-tracked PostgreSQL Entity commit handle.
+ *
+ * @typeParam I Entity identifier type captured by this handle.
+ * @typeParam S Entity state message type captured by this handle.
+ */
+export declare class PostgresEntityCommitStorage<I, S extends Message> implements EntityCommitStorage {
+    #private;
+    private readonly entity;
+    private readonly open;
+    private readonly onClose;
+    /**
+     * Creates a PostgreSQL Entity commit handle for one Entity storage boundary.
+     *
+     * @param entity Defines the captured Entity source, state, and tenant scope.
+     * @param open Opens temporary current and history record-family handles.
+     * @param lifecycle Acquires transaction clients for the captured database.
+     * @param onClose Removes this handle from the factory's live-handle set.
+     */
+    constructor(entity: EntityStorageInput<I, S>, open: OpenRecords, lifecycle: PostgresRecordLifecycle, onClose: () => void);
+    /**
+     * Commits one current Entity record and its optional immutable records.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param input Defines the expected and next current records plus histories.
+     * @returns Whether PostgreSQL committed the mutation or found a conflict.
+     */
+    commit<Id, State extends Message>(input: EntityCommitInput<Id, State>): Promise<EntityCommitResult>;
+    /**
+     * Closes this handle to new commits while allowing started work to settle.
+     */
+    close(): void;
+    /**
+     * Applies one validated Entity commit on an active transaction.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param client PostgreSQL transaction client.
+     * @param input Defines the Entity records to commit.
+     * @param records Provides the prepared record families.
+     * @returns Whether records were committed or conflicted.
+     */
+    private apply;
+    /**
+     * Acquires locks for each mutable or append-only family in the commit.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param client PostgreSQL transaction client.
+     * @param input Defines the Entity records to commit.
+     * @param records Provides the prepared record families.
+     * @returns Completion after all transaction locks are acquired.
+     */
+    private locks;
+    /**
+     * Verifies that every immutable record can be appended.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param client PostgreSQL transaction client.
+     * @param input Defines the immutable records to verify.
+     * @param records Provides the prepared record families.
+     * @returns Completion after all immutable checks pass.
+     */
+    private preflight;
+    /**
+     * Stores every immutable history and event-store record.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param client PostgreSQL transaction client.
+     * @param input Defines the immutable records to append.
+     * @param records Provides the prepared record families.
+     * @returns Completion after all records are appended.
+     */
+    private append;
+    /**
+     * Validates the commit against the Entity boundary captured by this handle.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param input Defines the Entity records to validate.
+     */
+    private validate;
+    /**
+     * Validates record identifiers inside one Entity commit.
+     *
+     * @typeParam Id Entity identifier type supplied by the commit.
+     * @typeParam State Entity state message type supplied by the commit.
+     * @param input Defines current and historical records to validate.
+     */
+    private validateRows;
+    /**
+     * Validates event identifiers for one immutable event family.
+     *
+     * @param events Events to validate when the family is enabled.
+     * @param family Names the event family in validation errors.
+     */
+    private validateEventIds;
+}
+export {};
+//# sourceMappingURL=entity-commit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-commit.d.ts","sourceRoot":"","sources":["../../src/postgres/entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO5D,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,sCAAsC,CAAC;AAQ9C,OAAO,EACL,qBAAqB,EAErB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AA6C7B;;;;;GAKG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACtC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,YAAY,KACjB,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AA4GjC;;;;;GAKG;AACH,qBAAa,2BAA2B,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,CAAE,YAAW,mBAAmB;;IAczF,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B;;;;;;;OAOG;gBAEgB,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAChC,IAAI,EAAE,WAAW,EAClC,SAAS,EAAE,uBAAuB,EACjB,OAAO,EAAE,MAAM,IAAI;IAKtC;;;;;;;OAOG;IACG,MAAM,CAAC,EAAE,EAAE,KAAK,SAAS,OAAO,EACpC,KAAK,EAAE,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,GAClC,OAAO,CAAC,kBAAkB,CAAC;IAW9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;;;;;;;OASG;YACW,KAAK;IAmBnB;;;;;;;;;OASG;YACW,KAAK;IAsBnB;;;;;;;;;OASG;YACW,SAAS;IAWvB;;;;;;;;;OASG;YACW,MAAM;IAWpB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAgBpB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAWzB"}