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

package/dist/mysql/entity-history.js

@@ -0,0 +1,347 @@
+/*
+ * 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 { create, fromBinary } from "@bufbuild/protobuf";
+import { EntityStateKeySchema, } from "@spine-event-engine/proto/generated/spine/server/entity/state_key_pb.js";
+import { RecordSpec } from "@spine-event-engine/storage";
+import { eventHistorySpec, stateHistorySpec, } from "@spine-event-engine/storage/provider";
+import { MysqlRecordStorage } from "./record-storage.js";
+/**
+ * Provides MySQL-backed Entity current and history storage.
+ */
+export class MysqlEntityStorage {
+    onClose;
+    // prettier-ignore
+    /**
+     * Exposes current Entity records.
+     */
+    current;
+    #current;
+    #states;
+    #events;
+    /**
+     * Exposes Entity state history records.
+     */
+    states;
+    /**
+     * Exposes Entity event history records.
+     */
+    events;
+    #open = true;
+    /**
+     * Creates MySQL-backed Entity storage handles.
+     *
+     * @param input Configures the Entity storage families.
+     * @param open Opens one record-family storage handle.
+     * @param onClose Removes this Entity handle from its factory.
+     */
+    constructor(input, open, onClose = () => undefined) {
+        this.onClose = onClose;
+        this.#current = new CurrentStorage(input, open(input.recordSpec));
+        this.current = this.#current;
+        const states = input.stateHistory ? stateHistorySpec(input.stateSchema) : undefined;
+        const events = input.eventHistory ? eventHistorySpec(input.stateSchema) : undefined;
+        this.#states =
+            states === undefined ? undefined : new States(input, open(states.spec, states.group));
+        this.#events =
+            events === undefined ? undefined : new Events(input, open(events.spec, events.group));
+        this.states = this.#states ?? disabledStates();
+        this.events = this.#events ?? disabledEvents();
+    }
+    /**
+     * Reads the current Entity record while the coordinator owns its row lock.
+     *
+     * @param id Identifies the Entity.
+     * @returns Resolves to the current record when present.
+     */
+    readCurrentLocked(id) {
+        return this.#current.readLocked(id);
+    }
+    /**
+     * Returns whether this Entity storage handle accepts operations.
+     *
+     * @returns Returns whether the handle is open.
+     */
+    isOpen() {
+        return this.#open;
+    }
+    /**
+     * Closes the history record-family handles.
+     */
+    close() {
+        if (!this.#open)
+            return;
+        this.#open = false;
+        this.#current.close();
+        this.states.close();
+        this.events.close();
+        this.onClose();
+    }
+    /**
+     * Binds all Entity handles to one connection for work.
+     *
+     * @param connection Provides the coordinator-owned connection.
+     * @param work Performs the bound storage work.
+     * @returns Returns the work result.
+     */
+    async withConnection(connection, work) {
+        return this.#current.withConnection(connection, () => this.#states === undefined
+            ? this.#events === undefined
+                ? work()
+                : this.#events.withConnection(connection, work)
+            : this.#states.withConnection(connection, () => this.#events === undefined ? work() : this.#events.withConnection(connection, work)));
+    }
+    /**
+     * Returns the physical tables used by the Entity families.
+     *
+     * @returns Returns the resolved table names.
+     */
+    tableNames() {
+        const result = [this.#current.tableName()];
+        if (this.#states !== undefined)
+            result.push(this.#states.tableName());
+        if (this.#events !== undefined)
+            result.push(this.#events.tableName());
+        return result;
+    }
+    /**
+     * Prepares every Entity record-family table.
+     *
+     * @returns Resolves after the tables are ready.
+     */
+    async prepare() {
+        await this.#current.prepare();
+        await this.#states?.prepare();
+        await this.#events?.prepare();
+    }
+    /**
+     * Checks immutable state and diagnostic records before a nontransactional write.
+     *
+     * @param states Lists state history records to check.
+     * @param diagnostics Lists diagnostic history records to check.
+     * @returns Resolves when every record is compatible.
+     */
+    async preflightImmutable(states, diagnostics) {
+        for (const state of states)
+            await this.#states?.assertImmutable(state);
+        for (const diagnostic of diagnostics)
+            await this.#events?.assertImmutable(diagnostic);
+    }
+    /**
+     * Exposes the private MySQL operations required by atomic Entity commit.
+     *
+     * @internal
+     * @returns Returns the private Entity-family commit capability.
+     */
+    commitCapability() {
+        return {
+            prepare: () => this.prepare(),
+            tableNames: () => this.tableNames(),
+            withConnection: (connection, work) => this.withConnection(connection, work),
+            readCurrentLocked: (id) => this.#current.readLocked(id),
+            preflightImmutable: (states, diagnostics) => this.preflightImmutable(states, diagnostics),
+            appendStateImmutable: (record) => this.#states?.appendImmutable(record) ?? Promise.resolve(),
+            appendDiagnosticImmutable: (record) => this.#events?.appendImmutable(record) ?? Promise.resolve(),
+        };
+    }
+}
+class CurrentStorage {
+    input;
+    records;
+    constructor(input, records) {
+        this.input = input;
+        this.records = records;
+    }
+    read(id) {
+        return this.records.read(id);
+    }
+    readLocked(id) {
+        return this.records.readLocked(id);
+    }
+    write(record) {
+        return this.records.write(record);
+    }
+    async query(plan) {
+        const entries = await this.records.queryPlanEntries(plan);
+        return entries.map((entry) => {
+            if (entry.record.entityId === undefined)
+                throw new Error("EntityRecord requires entityId.");
+            const id = this.input.id.unpack(entry.record.entityId);
+            if (id === undefined)
+                throw new Error("EntityRecord ID does not match storage.");
+            return {
+                id,
+                record: entry.record,
+                columns: new Map(this.input.columns.map((column) => [column.name, column.valueIn(entry.record)])),
+            };
+        });
+    }
+    withConnection(connection, work) {
+        return this.records.withConnection(connection, work);
+    }
+    tableName() {
+        return this.records.tableName;
+    }
+    prepare() {
+        return this.records.prepare();
+    }
+    close() {
+        this.records.close();
+    }
+}
+class States {
+    input;
+    records;
+    constructor(input, records) {
+        this.input = input;
+        this.records = records;
+    }
+    append(record) {
+        return this.records.write(record);
+    }
+    appendImmutable(record) {
+        return this.records.writeImmutable(record);
+    }
+    async backward(id, depth, startingFromVersion) {
+        const all = await this.records.query({ sort: [{ field: "version", direction: "desc" }] });
+        return all
+            .filter((record) => record.entityId !== undefined &&
+            sameEntityId(this.input, record.entityId, id) &&
+            (startingFromVersion === undefined ||
+                BigInt(record.version?.number ?? 0) <= startingFromVersion))
+            .slice(0, depth);
+    }
+    async stateAt(id, time) {
+        const records = await this.backward(id, Number.MAX_SAFE_INTEGER);
+        const found = records.find((record) => {
+            const timestamp = record.version?.timestamp;
+            return (timestamp !== undefined &&
+                (timestamp.seconds < time.seconds ||
+                    (timestamp.seconds === time.seconds && timestamp.nanos <= time.nanos)));
+        });
+        return found?.state === undefined
+            ? undefined
+            : fromBinary(this.input.stateSchema, found.state.value);
+    }
+    async trim(id, keep) {
+        const records = await this.backward(id, Number.MAX_SAFE_INTEGER);
+        for (const record of records.slice(keep)) {
+            if (record.entityId !== undefined)
+                await this.records.delete(create(EntityStateKeySchema, {
+                    entityId: record.entityId,
+                    version: record.version?.number ?? 0,
+                }));
+        }
+    }
+    async truncate(olderThan) {
+        const all = await this.records.query();
+        for (const record of all) {
+            const timestamp = record.version?.timestamp;
+            if (timestamp !== undefined &&
+                (timestamp.seconds < olderThan.seconds ||
+                    (timestamp.seconds === olderThan.seconds && timestamp.nanos < olderThan.nanos)) &&
+                record.entityId !== undefined)
+                await this.records.delete(create(EntityStateKeySchema, {
+                    entityId: record.entityId,
+                    version: record.version?.number ?? 0,
+                }));
+        }
+    }
+    close() {
+        this.records.close();
+    }
+    withConnection(connection, work) {
+        return this.records.withConnection(connection, work);
+    }
+    tableName() {
+        return this.records.tableName;
+    }
+    assertImmutable(record) {
+        return this.records.assertImmutable(record);
+    }
+    prepare() {
+        return this.records.prepare();
+    }
+}
+class Events {
+    input;
+    records;
+    constructor(input, records) {
+        this.input = input;
+        this.records = records;
+    }
+    append(record) {
+        return this.records.write(record);
+    }
+    appendImmutable(record) {
+        return this.records.writeImmutable(record);
+    }
+    async backward(id, depth, startingFromVersion) {
+        const all = await this.records.query({ sort: [{ field: "version", direction: "desc" }] });
+        return all
+            .filter((event) => event.context?.producerId !== undefined &&
+            sameEntityId(this.input, event.context.producerId, id) &&
+            (startingFromVersion === undefined ||
+                BigInt(event.context.version?.number ?? 0) <= startingFromVersion))
+            .slice(0, depth);
+    }
+    async truncate(olderThan) {
+        const all = await this.records.query();
+        for (const event of all) {
+            const timestamp = event.context?.timestamp;
+            if (event.id !== undefined &&
+                timestamp !== undefined &&
+                (timestamp.seconds < olderThan.seconds ||
+                    (timestamp.seconds === olderThan.seconds && timestamp.nanos < olderThan.nanos)))
+                await this.records.delete(event.id);
+        }
+    }
+    close() {
+        this.records.close();
+    }
+    withConnection(connection, work) {
+        return this.records.withConnection(connection, work);
+    }
+    tableName() {
+        return this.records.tableName;
+    }
+    assertImmutable(record) {
+        return this.records.assertImmutable(record);
+    }
+    prepare() {
+        return this.records.prepare();
+    }
+}
+function disabledStates() {
+    return {
+        append: () => Promise.reject(new Error("Entity state history is disabled.")),
+        backward: () => Promise.resolve([]),
+        stateAt: () => Promise.resolve(undefined),
+        trim: () => Promise.resolve(),
+        truncate: () => Promise.resolve(),
+        close: () => undefined,
+    };
+}
+function disabledEvents() {
+    return {
+        append: () => Promise.reject(new Error("Entity event history is disabled.")),
+        backward: () => Promise.resolve([]),
+        truncate: () => Promise.resolve(),
+        close: () => undefined,
+    };
+}
+function sameEntityId(input, packed, expected) {
+    const decoded = input.id.unpack(packed);
+    return decoded !== undefined && input.id.key(decoded) === input.id.key(expected);
+}
+//# sourceMappingURL=entity-history.js.map

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

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

package/dist/mysql/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reports an incompatible MySQL record-family schema without database details.
+ */
+export declare class MysqlStorageSchemaError extends Error {
+}
+/**
+ * Reports stored record data that cannot be decoded without database details.
+ */
+export declare class MysqlStorageDataError extends Error {
+}
+/**
+ * Reports a MySQL storage operation failure without database details.
+ */
+export declare class MysqlStorageOperationError extends Error {
+}
+/**
+ * Converts an unknown failure to one public provider error without exposing driver details.
+ *
+ * @param type Constructs the public error type.
+ * @param message Describes the failed provider operation.
+ * @param error Supplies the unknown underlying failure.
+ * @returns The existing public provider error or a newly constructed public error.
+ */
+export declare function mysqlError<E extends Error>(type: new (message: string) => E, message: string, error: unknown): E;
+//# sourceMappingURL=errors.d.ts.map

package/dist/mysql/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/mysql/errors.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;CAAG;AAErD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;CAAG;AAEnD;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAExD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,KAAK,EACxC,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC,EAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,CAAC,CAMH"}

package/dist/mysql/errors.js

@@ -0,0 +1,44 @@
+/*
+ * 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.
+ */
+/**
+ * Reports an incompatible MySQL record-family schema without database details.
+ */
+export class MysqlStorageSchemaError extends Error {
+}
+/**
+ * Reports stored record data that cannot be decoded without database details.
+ */
+export class MysqlStorageDataError extends Error {
+}
+/**
+ * Reports a MySQL storage operation failure without database details.
+ */
+export class MysqlStorageOperationError extends Error {
+}
+/**
+ * Converts an unknown failure to one public provider error without exposing driver details.
+ *
+ * @param type Constructs the public error type.
+ * @param message Describes the failed provider operation.
+ * @param error Supplies the unknown underlying failure.
+ * @returns The existing public provider error or a newly constructed public error.
+ */
+export function mysqlError(type, message, error) {
+    return error instanceof MysqlStorageSchemaError ||
+        error instanceof MysqlStorageDataError ||
+        error instanceof MysqlStorageOperationError
+        ? error
+        : new type(message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/mysql/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mysql/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;CAAG;AAErD;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;CAAG;AAEnD;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;CAAG;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAgC,EAChC,OAAe,EACf,KAAc;IAEd,OAAO,KAAK,YAAY,uBAAuB;QAC7C,KAAK,YAAY,qBAAqB;QACtC,KAAK,YAAY,0BAA0B;QAC3C,CAAC,CAAE,KAAW;QACd,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,36 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { StringifierRegistry } from "@spine-event-engine/core";
+type MysqlIdType<I> = I extends Message ? GenMessage<I> : string;
+/**
+ * Converts one declared record ID to and from Spine JVM JDBC values.
+ */
+export declare class MysqlIdColumn<I> {
+    #private;
+    private readonly type;
+    /**
+     * The canonical MySQL ID column type.
+     */
+    readonly mysqlType: string;
+    /**
+     * Creates an ID conversion from the declared record ID type.
+     *
+     * @param type The message schema or supported primitive kind.
+     * @param stringifiers The schema-bound message stringifiers.
+     */
+    constructor(type: MysqlIdType<I>, stringifiers?: StringifierRegistry);
+    /**
+     * Converts a logical ID to a MySQL parameter.
+     * @param id The logical record ID.
+     * @returns The JVM-compatible MySQL value.
+     */
+    value(id: I): unknown;
+    /**
+     * Converts a MySQL value back to the logical ID.
+     * @param value The selected MySQL value.
+     * @returns The logical record ID.
+     */
+    read(value: unknown): I;
+}
+export {};
+//# sourceMappingURL=id-column.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-column.d.ts","sourceRoot":"","sources":["../../src/mysql/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,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAEjE;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC;;IAgBxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;gBAEgB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACrC,YAAY,GAAE,mBAA+C;IAM/D;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAOrB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC;CAuBxB"}

package/dist/mysql/id-column.js

@@ -0,0 +1,113 @@
+/*
+ * 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 { StringifierRegistry } from "@spine-event-engine/core";
+/**
+ * Converts one declared record ID to and from Spine JVM JDBC values.
+ */
+export class MysqlIdColumn {
+    type;
+    #stringifiers;
+    // prettier-ignore
+    /**
+     * The canonical MySQL ID column type.
+     */
+    mysqlType;
+    /**
+     * Creates an ID conversion from the declared record ID type.
+     *
+     * @param type The message schema or supported primitive kind.
+     * @param stringifiers The schema-bound message stringifiers.
+     */
+    constructor(type, stringifiers = new StringifierRegistry()) {
+        this.type = type;
+        this.#stringifiers = new StringifierRegistry(stringifiers);
+        this.mysqlType = MysqlIdTypes.mysqlType(type);
+    }
+    /**
+     * Converts a logical ID to a MySQL parameter.
+     * @param id The logical record ID.
+     * @returns The JVM-compatible MySQL value.
+     */
+    value(id) {
+        if (typeof this.type !== "string")
+            return MysqlIdTypes.text(this.#stringifiers.forMessage(this.type).toString(id));
+        MysqlIdTypes.validate(this.type, id);
+        return this.type === "string" ? MysqlIdTypes.text(id) : id;
+    }
+    /**
+     * Converts a MySQL value back to the logical ID.
+     * @param value The selected MySQL value.
+     * @returns The logical record ID.
+     */
+    read(value) {
+        if (typeof this.type !== "string") {
+            if (typeof value !== "string")
+                throw new Error("MySQL message ID is not text.");
+            return this.#stringifiers.forMessage(this.type).fromString(value);
+        }
+        switch (this.type) {
+            case "string":
+                if (typeof value !== "string")
+                    throw new Error("MySQL string ID is invalid.");
+                return value;
+            case "int32": {
+                const number = typeof value === "number" ? value : Number(value);
+                MysqlIdTypes.validate("int32", number);
+                return number;
+            }
+            case "int64": {
+                const integer = typeof value === "bigint" ? value : BigInt(value);
+                MysqlIdTypes.validate("int64", integer);
+                return integer;
+            }
+            default:
+                throw new Error(`MySQL storage does not support primitive ID kind "${this.type}".`);
+        }
+    }
+}
+const MysqlIdTypes = Object.freeze({
+    text(value) {
+        if (value.length > 512)
+            throw new Error("MySQL storage identifier is too large.");
+        return value;
+    },
+    mysqlType(type) {
+        if (typeof type !== "string")
+            return "VARCHAR(512)";
+        switch (type) {
+            case "string":
+                return "VARCHAR(512)";
+            case "int32":
+                return "INT";
+            case "int64":
+                return "BIGINT";
+            default:
+                throw new Error(`MySQL storage does not support primitive ID kind "${type}".`);
+        }
+    },
+    validate(type, value) {
+        if (type === "string" && typeof value === "string")
+            return;
+        if (type === "int32" &&
+            typeof value === "number" &&
+            Number.isInteger(value) &&
+            value >= -(2 ** 31) &&
+            value < 2 ** 31)
+            return;
+        if (type === "int64" && typeof value === "bigint" && value >= -(1n << 63n) && value < 1n << 63n)
+            return;
+        throw new Error(`MySQL ${type} ID is invalid.`);
+    },
+});
+//# sourceMappingURL=id-column.js.map

package/dist/mysql/id-column.js.map

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