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

package/dist/datastore/column-mapping.js

@@ -0,0 +1,141 @@
+/*
+ * 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 { ScalarType } from "@bufbuild/protobuf";
+import { Datastore } from "@google-cloud/datastore";
+import { StringifierRegistry } from "@spine-event-engine/core";
+const timestampType = "google.protobuf.Timestamp";
+const versionType = "spine.core.Version";
+/**
+ * Converts typed Protobuf column values to Spine JVM Datastore values.
+ */
+export class DatastoreColumnMapping {
+    #stringifiers;
+    /**
+     * Creates a JVM-compatible Datastore column mapping.
+     *
+     * @param stringifiers The schema-bound message stringifiers.
+     */
+    constructor(stringifiers = new StringifierRegistry()) {
+        this.#stringifiers = new StringifierRegistry(stringifiers);
+    }
+    /**
+     * Returns the conversion for one generated column type.
+     *
+     * @param type The generated Protobuf column type.
+     * @returns The JVM-compatible Datastore conversion.
+     */
+    of(type) {
+        switch (type.kind) {
+            case "scalar":
+                return DatastoreMappings.scalar(type.scalar);
+            case "enum":
+                return (value) => Datastore.int(String(value));
+            case "message":
+                if (type.message.typeName === timestampType)
+                    return (value) => DatastoreMappings.timestamp(value);
+                if (type.message.typeName === versionType)
+                    return (value) => Datastore.int(String(value.number));
+                return (value) => this.#stringifiers
+                    .forMessage(type.message)
+                    .toString(value);
+        }
+    }
+    /**
+     * Returns native Datastore null.
+     *
+     * @returns The null conversion.
+     */
+    ofNull() {
+        return (value) => value;
+    }
+}
+const DatastoreMappings = Object.freeze({
+    scalar(type) {
+        switch (type) {
+            case ScalarType.STRING:
+            case ScalarType.BOOL:
+                return (value) => value;
+            case ScalarType.INT32:
+            case ScalarType.SINT32:
+            case ScalarType.SFIXED32:
+                return (value) => Datastore.int(DatastoreMappings.signed(value, 32));
+            case ScalarType.UINT32:
+            case ScalarType.FIXED32:
+                return (value) => Datastore.int(DatastoreMappings.unsigned(value, 32));
+            case ScalarType.INT64:
+            case ScalarType.SINT64:
+            case ScalarType.SFIXED64:
+                return (value) => Datastore.int(DatastoreMappings.signed(value, 64));
+            case ScalarType.UINT64:
+            case ScalarType.FIXED64:
+                return (value) => Datastore.int(DatastoreMappings.unsigned(value, 64));
+            case ScalarType.FLOAT:
+            case ScalarType.DOUBLE:
+                return (value) => Datastore.double(value);
+            case ScalarType.BYTES:
+                return (value) => Buffer.from(value);
+        }
+    },
+    signed(value, bits) {
+        const integer = this.integer(value);
+        const limit = 1n << BigInt(bits - 1);
+        if (integer < -limit || integer >= limit)
+            throw new Error(`Datastore signed ${String(bits)}-bit column is outside its range.`);
+        return integer.toString();
+    },
+    unsigned(value, bits) {
+        const integer = this.integer(value);
+        if (integer < 0n || integer >= 1n << BigInt(bits))
+            throw new Error(`Datastore unsigned ${String(bits)}-bit column is outside its range.`);
+        if (integer > (1n << 63n) - 1n)
+            throw new Error("Datastore integer columns cannot exceed the signed 64-bit provider range.");
+        return integer.toString();
+    },
+    integer(value) {
+        if (typeof value === "bigint")
+            return value;
+        if (typeof value === "number" && Number.isSafeInteger(value))
+            return BigInt(value);
+        if (typeof value === "string" && /^-?(?:0|[1-9][0-9]*)$/u.test(value))
+            return BigInt(value);
+        throw new Error("Datastore integer column is invalid.");
+    },
+    timestamp(value) {
+        const timestamp = value;
+        if (typeof timestamp.seconds !== "bigint" ||
+            !Number.isInteger(timestamp.nanos) ||
+            timestamp.nanos < 0 ||
+            timestamp.nanos > 999_999_999)
+            throw new Error("Datastore timestamp column is invalid.");
+        return new DatastoreTimestamp(timestamp.seconds, timestamp.nanos);
+    },
+});
+class DatastoreTimestamp extends Date {
+    seconds;
+    nanos;
+    constructor(seconds, nanos) {
+        super(Number(seconds * 1000n));
+        this.seconds = seconds;
+        this.nanos = nanos;
+        if (!Number.isFinite(super.getTime()))
+            throw new Error("Datastore timestamp column is outside the supported range.");
+    }
+    getTime() {
+        return Number(this.seconds * 1000n);
+    }
+    getMilliseconds() {
+        return this.nanos / 1_000_000;
+    }
+}
+//# sourceMappingURL=column-mapping.js.map

package/dist/datastore/column-mapping.js.map

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

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

@@ -0,0 +1,31 @@
+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 { DatastoreRecordStorage } from "./record-storage.js";
+/**
+ * Coordinates one fenced delivered Inbox deletion in Datastore.
+ */
+export declare class DatastoreDeliveryCleanupStorage implements DeliveryCleanupStorage {
+    #private;
+    private readonly openStorage;
+    /**
+     * Creates a Datastore cleanup coordinator.
+     *
+     * @param openStorage Opens a record-storage handle for one record family.
+     */
+    constructor(openStorage: <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>) => DatastoreRecordStorage<I, R>);
+    /**
+     * Removes an exact Inbox entity after validating its session entity in one transaction.
+     *
+     * @param input Describes the records and ownership predicate for deletion.
+     * @returns Whether the transaction deleted the exact Inbox entity.
+     */
+    remove<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message>(input: DeliveryCleanupInput<InboxId, InboxRecord, SessionId, SessionRecord>): Promise<boolean>;
+    /**
+     * Closes this cleanup coordinator to further removal operations.
+     */
+    close(): void;
+    private static first;
+    private static active;
+}
+//# sourceMappingURL=delivery-cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-cleanup.d.ts","sourceRoot":"","sources":["../../src/datastore/delivery-cleanup.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,qBAAa,+BAAgC,YAAW,sBAAsB;;IAS1E,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN9B;;;;OAIG;gBAEgB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACjD,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;IAGnC;;;;;OAKG;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;IA8DnB;;OAEG;IACH,KAAK,IAAI,IAAI;IAGb,OAAO,CAAC,MAAM,CAAC,KAAK;IAQpB,OAAO,CAAC,MAAM,CAAC,MAAM;CAGtB"}

package/dist/datastore/delivery-cleanup.js

@@ -0,0 +1,111 @@
+/*
+ * 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 "@spine-event-engine/storage/provider";
+import { DatastoreRecordStorage } from "./record-storage.js";
+/**
+ * Coordinates one fenced delivered Inbox deletion in Datastore.
+ */
+export class DatastoreDeliveryCleanupStorage {
+    openStorage;
+    #open = true;
+    /**
+     * Creates a Datastore cleanup coordinator.
+     *
+     * @param openStorage Opens a record-storage handle for one record family.
+     */
+    constructor(openStorage) {
+        this.openStorage = openStorage;
+    }
+    /**
+     * Removes an exact Inbox entity after validating its session entity in one transaction.
+     *
+     * @param input Describes the records and ownership predicate for deletion.
+     * @returns Whether the transaction deleted the exact Inbox entity.
+     */
+    async remove(input) {
+        if (!this.#open)
+            throw new Error("Delivery cleanup storage is closed.");
+        if (!DatastoreDeliveryCleanupStorage.active(input))
+            return false;
+        const inbox = this.openStorage(input.context, input.inbox.spec);
+        const sessions = this.openStorage(input.context, input.session.spec);
+        const transaction = sessions.transaction();
+        try {
+            await transaction.run();
+            const sessionEntity = DatastoreDeliveryCleanupStorage.first(await transaction.get(sessions.transactionEntity(input.session.expected).key));
+            if (!DatastoreDeliveryCleanupStorage.active(input)) {
+                await transaction.rollback();
+                return false;
+            }
+            if (sessionEntity === undefined ||
+                !sessions.matchesTransactionEntity(sessionEntity, input.session.expected) ||
+                !input.session.isCurrent(sessions.decodeTransactionEntity(sessionEntity))) {
+                await transaction.rollback();
+                return false;
+            }
+            const expectedInbox = inbox.transactionEntity(input.inbox.expected);
+            const inboxEntity = DatastoreDeliveryCleanupStorage.first(await transaction.get(expectedInbox.key));
+            if (inboxEntity === undefined ||
+                !inbox.matchesTransactionEntity(inboxEntity, input.inbox.expected)) {
+                await transaction.rollback();
+                return false;
+            }
+            if (!input.session.isCurrent(sessions.decodeTransactionEntity(sessionEntity))) {
+                await transaction.rollback();
+                return false;
+            }
+            if (!DatastoreDeliveryCleanupStorage.active(input)) {
+                await transaction.rollback();
+                return false;
+            }
+            transaction.delete(expectedInbox.key);
+            if (!input.session.isCurrent(sessions.decodeTransactionEntity(sessionEntity))) {
+                await transaction.rollback();
+                return false;
+            }
+            if (!DatastoreDeliveryCleanupStorage.active(input)) {
+                await transaction.rollback();
+                return false;
+            }
+            await transaction.commit();
+            return true;
+        }
+        catch (error) {
+            await transaction.rollback().catch(() => undefined);
+            throw error;
+        }
+        finally {
+            inbox.close();
+            sessions.close();
+        }
+    }
+    /**
+     * Closes this cleanup coordinator to further removal operations.
+     */
+    close() {
+        this.#open = false;
+    }
+    static first(value) {
+        return Array.isArray(value) &&
+            value.length > 0 &&
+            typeof value[0] === "object" &&
+            value[0] !== null
+            ? value[0]
+            : undefined;
+    }
+    static active(input) {
+        return cleanupOperationActive(input.operation);
+    }
+}
+//# sourceMappingURL=delivery-cleanup.js.map

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

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

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

@@ -0,0 +1,82 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type EntityCommitInput, type EntityCommitResult, type EntityCommitStorage, type EntityEventHistoryPort, type EntityRecordStorage, type EntityStateHistoryPort, type EntityStorageInput } from "@spine-event-engine/storage/provider";
+import { RecordSpec, type RecordStorage } from "@spine-event-engine/storage";
+/**
+ * Opens one generated record family with its resolved Datastore layout.
+ *
+ * @param spec The generated record-family contract.
+ * @param group The optional generated storage group.
+ * @returns The opened record-storage handle.
+ */
+export type OpenEntityRecords = <I, R extends Message>(spec: RecordSpec<I, R>, group?: import("@spine-event-engine/storage").StorageGroup) => RecordStorage<I, R>;
+/**
+ * Groups Entity current and optional history record families.
+ */
+export declare class DatastoreEntityStorage<I, S extends Message> {
+    #private;
+    /**
+     * Provides access to current Entity records.
+     */
+    readonly current: EntityRecordStorage<I>;
+    /**
+     * Provides access to retained Entity event history.
+     */
+    readonly events: EntityEventHistoryPort<I>;
+    /**
+     * Provides access to retained Entity state history.
+     */
+    readonly states: EntityStateHistoryPort<I, S>;
+    /**
+     * Creates storage handles for one Entity persistence contract.
+     *
+     * @param input The Entity persistence contract.
+     * @param openRecords The function that opens each generated record family.
+     */
+    constructor(input: EntityStorageInput<I, S>, openRecords: OpenEntityRecords);
+    /**
+     * Closes all record-storage handles owned by this Entity storage.
+     */
+    close(): void;
+    /**
+     * Returns whether this Entity storage remains open.
+     *
+     * @returns `true` when this storage accepts operations.
+     */
+    isOpen(): boolean;
+}
+/**
+ * Coordinates an Entity mutation through one Datastore transaction.
+ */
+export declare class DatastoreEntityCommitStorage implements EntityCommitStorage {
+    #private;
+    private readonly input;
+    private readonly openRecords;
+    /**
+     * Creates transactional commit storage for one Entity persistence contract.
+     *
+     * @param input The Entity persistence contract served by this instance.
+     * @param openRecords The function that opens generated record families.
+     */
+    constructor(input: EntityStorageInput<unknown, Message>, openRecords: OpenEntityRecords);
+    /**
+     * Commits one Entity state transition and its generated history records.
+     *
+     * @param input The Entity mutation to commit.
+     * @returns The committed or conflicting outcome.
+     */
+    commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<EntityCommitResult>;
+    private run;
+    private prepare;
+    private tryCommit;
+    private load;
+    private conflict;
+    private validateImmutable;
+    private apply;
+    private closeRecords;
+    /**
+     * Closes this commit storage to further commits.
+     */
+    close(): void;
+    private validate;
+}
+//# sourceMappingURL=entity-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/datastore/entity-history.ts"],"names":[],"mappings":"AAcA,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ/E,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAe7E;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACnD,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,OAAO,6BAA6B,EAAE,YAAY,KACvD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzB;;GAEG;AACH,qBAAa,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;;IAGtD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI9C;;;;;OAKG;gBACS,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,iBAAiB;IAsB3E;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;;OAIG;IACH,MAAM,IAAI,OAAO;CAGlB;AAED;;GAEG;AACH,qBAAa,4BAA6B,YAAW,mBAAmB;;IAUpE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAR9B;;;;;OAKG;gBAEgB,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC3C,WAAW,EAAE,iBAAiB;IAGjD;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;YA4BjF,GAAG;IAuBjB,OAAO,CAAC,OAAO;YAeD,SAAS;YAoBT,IAAI;YAgBJ,QAAQ;IAetB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ;CAcjB"}