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

package/dist/datastore/entity-history.js

@@ -0,0 +1,541 @@
+/*
+ * 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, fromBinary, toBinary } from "@bufbuild/protobuf";
+import {} from "@bufbuild/protobuf/wkt";
+import { EventSchema } from "@spine-event-engine/proto";
+import { EntityRecordSchema, } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { eventStoreRecordSpec } from "@spine-event-engine/storage/provider";
+import { disabledEventHistoryPort, disabledStateHistoryPort, eventHistorySpec, stateHistorySpec, } from "@spine-event-engine/storage/provider";
+import { RecordSpec } from "@spine-event-engine/storage";
+import { TenantBoundary } from "@spine-event-engine/storage/provider";
+import { Datastore } from "@google-cloud/datastore";
+import { DatastoreRecordStorage } from "./record-storage.js";
+/**
+ * Groups Entity current and optional history record families.
+ */
+export class DatastoreEntityStorage {
+    // prettier-ignore
+    /**
+     * Provides access to current Entity records.
+     */
+    current;
+    /**
+     * Provides access to retained Entity event history.
+     */
+    events;
+    /**
+     * Provides access to retained Entity state history.
+     */
+    states;
+    #records;
+    #open = true;
+    /**
+     * 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, openRecords) {
+        const current = openRecords(input.recordSpec);
+        const states = input.stateHistory
+            ? openRecords(stateHistorySpec(input.stateSchema).spec, stateHistorySpec(input.stateSchema).group)
+            : undefined;
+        const events = input.eventHistory
+            ? openRecords(eventHistorySpec(input.stateSchema).spec, eventHistorySpec(input.stateSchema).group)
+            : undefined;
+        this.current = new CurrentStorage(input, current);
+        this.states =
+            states === undefined ? disabledStateHistoryPort() : new StateHistory(input, states);
+        this.events =
+            events === undefined ? disabledEventHistoryPort() : new EventHistory(input, events);
+        this.#records = [current, states, events].filter((value) => value !== undefined);
+    }
+    /**
+     * Closes all record-storage handles owned by this Entity storage.
+     */
+    close() {
+        if (this.#open) {
+            this.#open = false;
+            for (const record of this.#records)
+                record.close();
+        }
+    }
+    /**
+     * Returns whether this Entity storage remains open.
+     *
+     * @returns `true` when this storage accepts operations.
+     */
+    isOpen() {
+        return this.#open;
+    }
+}
+/**
+ * Coordinates an Entity mutation through one Datastore transaction.
+ */
+export class DatastoreEntityCommitStorage {
+    input;
+    openRecords;
+    #open = true;
+    /**
+     * 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, openRecords) {
+        this.input = input;
+        this.openRecords = openRecords;
+    }
+    /**
+     * Commits one Entity state transition and its generated history records.
+     *
+     * @param input The Entity mutation to commit.
+     * @returns The committed or conflicting outcome.
+     */
+    async commit(input) {
+        this.validate(input);
+        const current = this.openRecords(input.entity.recordSpec);
+        const stateLayout = stateHistorySpec(input.entity.stateSchema);
+        const diagnosticLayout = eventHistorySpec(input.entity.stateSchema);
+        const states = input.entity.stateHistory
+            ? this.openRecords(stateLayout.spec, stateLayout.group)
+            : undefined;
+        const diagnostics = input.entity.eventHistory
+            ? this.openRecords(diagnosticLayout.spec, diagnosticLayout.group)
+            : undefined;
+        const events = this.openRecords(eventStoreRecordSpec);
+        try {
+            return await this.run(input, current, states, diagnostics, events);
+        }
+        finally {
+            this.closeRecords(current, states, diagnostics, events);
+        }
+    }
+    async run(input, current, states, diagnostics, events) {
+        const prepared = this.prepare(input, current, states, diagnostics, events);
+        validateCommitSize(prepared.map((row) => row.entity));
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            try {
+                return await this.tryCommit(input, current, prepared);
+            }
+            catch (error) {
+                if (isAborted(error) && attempt < 2) {
+                    await abortBackoff(attempt);
+                    continue;
+                }
+                throw entityTransactionError(error);
+            }
+        }
+        throw new Error("Datastore transaction did not complete.");
+    }
+    prepare(input, current, states, diagnostics, events) {
+        return coalesceImmutableRows([
+            ...preparedRows(current, [input.next], false),
+            ...preparedRows(states, input.states ?? [], true),
+            ...preparedRows(diagnostics, input.diagnostics ?? [], true),
+            ...preparedRows(events, input.events ?? [], true),
+        ]);
+    }
+    async tryCommit(input, current, prepared) {
+        const transaction = current.transaction();
+        try {
+            await transaction.run();
+            const values = await this.load(transaction, prepared);
+            if (await this.conflict(transaction, input, current, values))
+                return "conflict";
+            this.validateImmutable(prepared, values);
+            this.apply(transaction, prepared, values);
+            await transaction.commit();
+            return "committed";
+        }
+        catch (error) {
+            await rollback(transaction);
+            throw error;
+        }
+    }
+    async load(transaction, prepared) {
+        const keys = [...uniqueKeys(prepared.map((row) => row.entity.key))].sort((left, right) => keyId(left).localeCompare(keyId(right)));
+        const values = [];
+        for (const key of keys)
+            values.push([
+                keyId(key),
+                first(await transaction.get(key)),
+            ]);
+        return new Map(values);
+    }
+    async conflict(transaction, input, current, values) {
+        const live = values.get(keyId(current.transactionEntity(input.next).key));
+        const expected = input.expected === undefined ? undefined : current.transactionEntity(input.expected).data;
+        if (sameData(live, expected) || sameData(live, current.transactionEntity(input.next).data))
+            return false;
+        await transaction.rollback();
+        return true;
+    }
+    validateImmutable(prepared, values) {
+        for (const row of prepared.filter((item) => item.immutable)) {
+            const previous = values.get(keyId(row.entity.key));
+            if (previous !== undefined && !sameData(previous, row.entity.data))
+                throw new Error("Immutable history record has divergent content.");
+        }
+    }
+    apply(transaction, prepared, values) {
+        for (const row of prepared) {
+            const previous = values.get(keyId(row.entity.key));
+            if (previous === undefined || (!row.immutable && !sameData(previous, row.entity.data)))
+                transaction.save(row.entity);
+        }
+    }
+    closeRecords(current, states, diagnostics, events) {
+        current.close();
+        states?.close();
+        diagnostics?.close();
+        events.close();
+    }
+    /**
+     * Closes this commit storage to further commits.
+     */
+    close() {
+        this.#open = false;
+    }
+    validate(input) {
+        if (!this.#open)
+            throw new Error("Entity commit storage is closed.");
+        if (input.entity.sourceType.typeName !== this.input.sourceType.typeName ||
+            TenantBoundary.of(input.context).key !== TenantBoundary.of(this.input.context).key)
+            throw new Error("Entity commit handle cannot commit another Entity source or tenant.");
+        validateCommitEntityId(input);
+        if ((input.states?.length ?? 0) > 0 && !input.entity.stateHistory)
+            throw new Error("Entity commit cannot append state history when it is disabled.");
+        if ((input.diagnostics?.length ?? 0) > 0 && !input.entity.eventHistory)
+            throw new Error("Entity commit cannot append event history when it is disabled.");
+        validateEvents(input.events ?? []);
+    }
+}
+class CurrentStorage {
+    input;
+    records;
+    constructor(input, records) {
+        this.input = input;
+        this.records = records;
+    }
+    read(id) {
+        return this.records.read(id);
+    }
+    async write(record) {
+        const id = record.entityId === undefined ? undefined : this.input.id.unpack(record.entityId);
+        if (id === undefined)
+            throw new Error("Entity current record ID does not match its Entity ID schema.");
+        await this.records.write(record);
+    }
+    async query(plan) {
+        return (await this.records.queryPlanEntries(plan)).map((entry) => ({
+            ...entry,
+            columns: new Map(this.input.columns.map((column) => [column.name, column.valueIn(entry.record)])),
+        }));
+    }
+}
+class StateHistory {
+    input;
+    records;
+    constructor(input, records) {
+        this.input = input;
+        this.records = records;
+    }
+    append(record) {
+        this.requireOpen();
+        return immutable(this.records, record);
+    }
+    async backward(id, depth, from) {
+        this.requireOpen();
+        requireDepth(depth);
+        return this.pages([
+            entityFilter(this.input, id),
+            ...(from === undefined ? [] : [numberFilter("version", "<=", from)]),
+        ], [
+            { property: "version", direction: "desc" },
+            { property: "created", direction: "desc" },
+        ], depth);
+    }
+    async stateAt(id, time) {
+        this.requireOpen();
+        const page = await this.provider().queryProviderPage({
+            filters: [entityFilter(this.input, id), timestampFilter("created", "<=", time)],
+            order: [
+                { property: "created", direction: "desc" },
+                { property: "version", direction: "desc" },
+            ],
+            limit: 1,
+        });
+        const found = page.entries[0]?.record;
+        return found?.state === undefined
+            ? undefined
+            : fromBinary(this.input.stateSchema, found.state.value);
+    }
+    async trim(id, keep) {
+        this.requireOpen();
+        requireKeep(keep);
+        for (;;) {
+            const page = await this.provider().queryProviderPage({
+                filters: [entityFilter(this.input, id)],
+                order: [
+                    { property: "version", direction: "desc" },
+                    { property: "created", direction: "desc" },
+                ],
+                limit: 128,
+            });
+            const removable = page.entries.slice(keep);
+            await this.provider().deleteProviderEntries(removable);
+            if (!page.hasMore)
+                break;
+        }
+    }
+    async truncate(time) {
+        this.requireOpen();
+        for (;;) {
+            const page = await this.provider().queryProviderPage({
+                filters: [timestampFilter("created", "<", time)],
+                order: [
+                    { property: "created", direction: "asc" },
+                    { property: "version", direction: "asc" },
+                ],
+                limit: 128,
+            });
+            await this.provider().deleteProviderEntries(page.entries);
+            if (!page.hasMore)
+                break;
+        }
+    }
+    close() {
+        this.records.close();
+    }
+    provider() {
+        return this.records;
+    }
+    requireOpen() {
+        if (!this.records.isOpen())
+            throw new Error("Entity history storage is closed.");
+    }
+    async pages(filters, order, depth) {
+        const result = [];
+        let cursor;
+        for (;;) {
+            const page = await this.provider().queryProviderPage({
+                filters,
+                order,
+                ...(cursor === undefined ? {} : { cursor }),
+                limit: Math.min(128, depth - result.length),
+            });
+            result.push(...page.entries.map((entry) => clone(EntityRecordSchema, entry.record)));
+            cursor = page.cursor;
+            if (!page.hasMore || result.length === depth)
+                break;
+        }
+        return result;
+    }
+}
+class EventHistory {
+    input;
+    records;
+    constructor(input, records) {
+        this.input = input;
+        this.records = records;
+    }
+    append(event) {
+        this.requireOpen();
+        return immutable(this.records, event);
+    }
+    async backward(id, depth, from) {
+        this.requireOpen();
+        requireDepth(depth);
+        const result = [];
+        let cursor;
+        for (;;) {
+            const page = await this.provider().queryProviderPage({
+                filters: [
+                    entityFilter(this.input, id),
+                    ...(from === undefined ? [] : [numberFilter("version", "<=", from)]),
+                ],
+                order: [
+                    { property: "version", direction: "desc" },
+                    { property: "created", direction: "desc" },
+                ],
+                ...(cursor === undefined ? {} : { cursor }),
+                limit: Math.min(128, depth - result.length),
+            });
+            result.push(...page.entries.map((entry) => clone(EventSchema, entry.record)));
+            cursor = page.cursor;
+            if (!page.hasMore || result.length === depth)
+                break;
+        }
+        return result;
+    }
+    async truncate(time) {
+        this.requireOpen();
+        for (;;) {
+            const page = await this.provider().queryProviderPage({
+                filters: [timestampFilter("created", "<", time)],
+                order: [
+                    { property: "created", direction: "asc" },
+                    { property: "version", direction: "asc" },
+                ],
+                limit: 128,
+            });
+            await this.provider().deleteProviderEntries(page.entries);
+            if (!page.hasMore)
+                break;
+        }
+    }
+    close() {
+        this.records.close();
+    }
+    provider() {
+        return this.records;
+    }
+    requireOpen() {
+        if (!this.records.isOpen())
+            throw new Error("Entity history storage is closed.");
+    }
+}
+async function immutable(records, record) {
+    const id = records.recordSpec.idValueIn(record);
+    if (await records.compareAndSet(id, undefined, record))
+        return;
+    const existing = await records.read(id);
+    if (existing === undefined)
+        throw new Error("Immutable history record was not retained.");
+    if (!same(toBinary(records.recordSpec.recordType, existing), toBinary(records.recordSpec.recordType, record)))
+        throw new Error("Immutable history record has divergent content.");
+}
+function preparedRows(storage, records, immutable) {
+    if (storage === undefined) {
+        if (records.length > 0)
+            throw new Error("Entity commit history is disabled.");
+        return [];
+    }
+    return records.map((record) => ({
+        storage,
+        record,
+        immutable,
+        entity: storage.transactionEntity(record),
+    }));
+}
+function coalesceImmutableRows(rows) {
+    const seen = new Map();
+    return rows.filter((row) => {
+        if (!row.immutable)
+            return true;
+        const previous = seen.get(keyId(row.entity.key));
+        if (previous === undefined) {
+            seen.set(keyId(row.entity.key), row);
+            return true;
+        }
+        if (!sameData(previous.entity.data, row.entity.data))
+            throw new Error("Immutable history record has divergent content.");
+        return false;
+    });
+}
+function same(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function requireDepth(value) {
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new Error("History depth must be a positive safe integer.");
+}
+function requireKeep(value) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error("History retention must be a non-negative safe integer.");
+}
+function entityFilter(input, id) {
+    return { property: "entity_id", operator: "=", value: input.id.pack(id) };
+}
+function numberFilter(property, operator, value) {
+    return { property, operator, value };
+}
+function timestampFilter(property, operator, value) {
+    return { property, operator, value };
+}
+function first(value) {
+    return Array.isArray(value) ? value[0] : undefined;
+}
+function keyId(key) {
+    return JSON.stringify(key);
+}
+function uniqueKeys(keys) {
+    return [...new Map(keys.map((key) => [keyId(key), key])).values()];
+}
+function sameData(left, right) {
+    if (left === undefined || right === undefined)
+        return left === right;
+    const bytes = left.bytes;
+    return (bytes instanceof Uint8Array && right.bytes instanceof Uint8Array && same(bytes, right.bytes));
+}
+function isAborted(error) {
+    return typeof error === "object" && error !== null && Reflect.get(error, "code") === 10;
+}
+function entityTransactionError(error) {
+    if (error instanceof Error && error.message.startsWith("Immutable history record"))
+        return error;
+    return new Error("Datastore Entity transaction failed.");
+}
+function abortBackoff(attempt) {
+    const delayMs = 20 * (attempt + 1) + Math.floor(Math.random() * 40);
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+async function rollback(transaction) {
+    try {
+        await transaction.rollback();
+    }
+    catch {
+        /* original provider error remains authoritative */
+    }
+}
+function validateCommitSize(rows) {
+    if (rows.length > 500)
+        throw new Error("Entity commit exceeds the 500-mutation limit.");
+    if (uniqueKeys(rows.map((row) => row.key)).length > 25)
+        throw new Error("Entity commit exceeds the 25 entity-group limit.");
+    const bytes = rows.reduce((total, row) => total +
+        Buffer.byteLength(JSON.stringify(row.data, (_key, value) => value instanceof Uint8Array
+            ? Buffer.from(value).toString("base64")
+            : typeof value === "bigint"
+                ? value.toString()
+                : value), "utf8"), 0);
+    if (bytes > 9 * 1024 * 1024)
+        throw new Error("Entity commit exceeds the transaction payload limit.");
+}
+function validateEvents(events) {
+    const ids = events.map((event) => event.id?.value);
+    if (ids.some((id) => id === undefined || id.trim().length === 0) ||
+        new Set(ids).size !== ids.length)
+        throw new Error("Entity commit requires non-blank unique delivery-event IDs.");
+}
+function validateCommitEntityId(input) {
+    const nextId = input.next.entityId === undefined ? undefined : input.entity.id.unpack(input.next.entityId);
+    if (nextId === undefined || input.entity.id.key(nextId) !== input.entity.id.key(input.entityId))
+        throw new Error("Entity commit current record ID does not match the committed Entity ID.");
+    for (const record of input.states ?? []) {
+        const stateId = record.entityId === undefined ? undefined : input.entity.id.unpack(record.entityId);
+        if (stateId === undefined ||
+            input.entity.id.key(stateId) !== input.entity.id.key(input.entityId))
+            throw new Error("Entity commit state-history record ID does not match the committed Entity ID.");
+    }
+    for (const event of input.diagnostics ?? []) {
+        const producer = event.context?.producerId;
+        const eventId = producer === undefined ? undefined : input.entity.id.unpack(producer);
+        if (eventId === undefined ||
+            input.entity.id.key(eventId) !== input.entity.id.key(input.entityId))
+            throw new Error("Entity commit diagnostic event ID does not match the committed Entity ID.");
+    }
+}
+//# sourceMappingURL=entity-history.js.map

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

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

package/dist/datastore/id-column.d.ts

@@ -0,0 +1,34 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { StringifierRegistry } from "@spine-event-engine/core";
+type DatastoreIdType<I> = I extends Message ? GenMessage<I> : string;
+/**
+ * Converts a declared record ID to and from a Spine JVM Datastore key name.
+ */
+export declare class DatastoreIdColumn<I> {
+    #private;
+    private readonly type;
+    /**
+     * Creates the ID conversion.
+     *
+     * @param type The generated message schema or supported primitive ID kind.
+     * @param stringifiers The schema-bound message stringifiers.
+     */
+    constructor(type: DatastoreIdType<I>, stringifiers?: StringifierRegistry);
+    /**
+     * Converts a logical ID to a Datastore key name.
+     *
+     * @param id The logical record identifier.
+     * @returns The JVM-compatible key name.
+     */
+    value(id: I): string;
+    /**
+     * Restores a logical ID from a Datastore key name.
+     *
+     * @param value The Datastore key name.
+     * @returns The restored record identifier.
+     */
+    read(value: string): I;
+}
+export {};
+//# sourceMappingURL=id-column.d.ts.map

package/dist/datastore/id-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-column.d.ts","sourceRoot":"","sources":["../../src/datastore/id-column.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,qBAAa,iBAAiB,CAAC,CAAC;;IAU5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB;;;;;OAKG;gBAEgB,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EACzC,YAAY,GAAE,mBAA+C;IAM/D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM;IAQpB;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC;CAqBvB"}