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

package/dist/mysql/table-spec.d.ts

@@ -0,0 +1,88 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { RecordColumn, RecordColumnType } from "@spine-event-engine/storage";
+/**
+ * Describes the private physical identity for one record family.
+ */
+export interface MysqlResolvedTable {
+    /**
+     * Names the physical table.
+     */
+    readonly tableName: string;
+}
+/**
+ * Maps a declared storage column value type to its native MySQL type.
+ *
+ * @param type Retains the generated Protobuf value type.
+ * @returns Returns the native MySQL type.
+ */
+export declare function mysqlColumnType(type: RecordColumnType): string;
+/**
+ * Describes one public MySQL column in a resolved record-family table.
+ */
+export interface MysqlColumnSpec {
+    /**
+     * Names the physical column.
+     */
+    readonly name: string;
+    /**
+     * Specifies the canonical native MySQL type.
+     */
+    readonly mysqlType: string;
+    /**
+     * Controls whether the column accepts null values.
+     */
+    readonly nullable: boolean;
+    /**
+     * Supplies an optional canonical SQL default expression.
+     */
+    readonly defaultSql?: string;
+}
+/**
+ * Describes the public resolved MySQL layout for one record family.
+ */
+export interface MysqlTableSpec<I, R extends Message> {
+    /**
+     * Names the physical table.
+     */
+    readonly tableName: string;
+    /**
+     * Identifies the record source Protobuf type.
+     */
+    readonly sourceType: GenMessage<Message>;
+    /**
+     * Identifies the stored record Protobuf type.
+     */
+    readonly recordType: GenMessage<R>;
+    /**
+     * Identifies the storage ID type.
+     */
+    readonly idType: I extends Message ? GenMessage<I> : string;
+    /**
+     * Names the optional storage group.
+     */
+    readonly groupName?: string;
+    /**
+     * Lists canonical table columns.
+     */
+    readonly columns: readonly MysqlColumnSpec[];
+    /**
+     * Lists primary-key column names in order.
+     */
+    readonly primaryKey: readonly string[];
+}
+/**
+ * Builds the canonical public layout for one resolved record family.
+ *
+ * @param input Identifies the resolved family and its declared columns.
+ * @returns Returns the canonical table layout.
+ */
+export declare function resolvedMysqlTableSpec<I, R extends Message>(input: {
+    readonly tableName: string;
+    readonly sourceType: GenMessage<Message>;
+    readonly recordType: GenMessage<R>;
+    readonly idType: I extends Message ? GenMessage<I> : string;
+    readonly groupName?: string;
+    readonly declaredColumns: readonly RecordColumn<R>[];
+}): MysqlTableSpec<I, R>;
+//# sourceMappingURL=table-spec.d.ts.map

package/dist/mysql/table-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-spec.d.ts","sourceRoot":"","sources":["../../src/mysql/table-spec.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIlF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAGjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAiC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAGlD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;CACtD,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAgBvB"}

package/dist/mysql/table-spec.js

@@ -0,0 +1,105 @@
+/*
+ * 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 { MysqlIdColumn } from "./id-column.js";
+/**
+ * Maps a declared storage column value type to its native MySQL type.
+ *
+ * @param type Retains the generated Protobuf value type.
+ * @returns Returns the native MySQL type.
+ */
+export function mysqlColumnType(type) {
+    switch (type.kind) {
+        case "enum":
+            return "INT";
+        case "message":
+            if (type.message.typeName === "google.protobuf.Timestamp")
+                return "BIGINT";
+            if (type.message.typeName === "spine.core.Version")
+                return "INT";
+            return "TEXT";
+        case "scalar":
+            switch (type.scalar) {
+                case ScalarType.STRING:
+                    return "TEXT";
+                case ScalarType.INT32:
+                case ScalarType.SINT32:
+                case ScalarType.SFIXED32:
+                case ScalarType.UINT32:
+                case ScalarType.FIXED32:
+                    return "INT";
+                case ScalarType.INT64:
+                case ScalarType.SINT64:
+                case ScalarType.SFIXED64:
+                case ScalarType.UINT64:
+                case ScalarType.FIXED64:
+                    return "BIGINT";
+                case ScalarType.BOOL:
+                    return "BOOLEAN";
+                case ScalarType.BYTES:
+                    return "BLOB";
+                case ScalarType.FLOAT:
+                case ScalarType.DOUBLE:
+                    throw new Error("Spine JVM JDBC does not support floating-point record columns.");
+            }
+    }
+}
+/**
+ * Builds the canonical public layout for one resolved record family.
+ *
+ * @param input Identifies the resolved family and its declared columns.
+ * @returns Returns the canonical table layout.
+ */
+export function resolvedMysqlTableSpec(input) {
+    return {
+        tableName: input.tableName,
+        sourceType: input.sourceType,
+        recordType: input.recordType,
+        idType: input.idType,
+        ...(input.groupName === undefined ? {} : { groupName: input.groupName }),
+        columns: [
+            { name: "ID", mysqlType: new MysqlIdColumn(input.idType).mysqlType, nullable: false },
+            { name: "bytes", mysqlType: "BLOB", nullable: false },
+            ...input.declaredColumns.map((column) => mysqlColumnSpec(input.recordType, input.groupName, column)),
+        ],
+        primaryKey: ["ID"],
+    };
+}
+function mysqlColumnSpec(recordType, groupName, column) {
+    const entityDefault = entityAttributeDefault(recordType, groupName, column);
+    return {
+        name: column.name,
+        mysqlType: mysqlColumnType(column.type),
+        nullable: entityDefault === undefined,
+        ...(entityDefault === undefined ? {} : { defaultSql: entityDefault }),
+    };
+}
+function entityAttributeDefault(recordType, groupName, column) {
+    if (recordType.typeName !== "spine.server.entity.EntityRecord" || groupName !== undefined)
+        return undefined;
+    switch (column.name) {
+        case "archived":
+        case "deleted":
+            return column.type.kind === "scalar" && column.type.scalar === ScalarType.BOOL
+                ? "false"
+                : undefined;
+        case "version":
+            return column.type.kind === "message" && column.type.message.typeName === "spine.core.Version"
+                ? "0"
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=table-spec.js.map

package/dist/mysql/table-spec.js.map

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

package/dist/mysql/testing.d.ts

@@ -0,0 +1,47 @@
+import { type Message } from "@bufbuild/protobuf";
+import { StringifierRegistry } from "@spine-event-engine/core";
+import { type EntityStorageInput } from "@spine-event-engine/storage/provider";
+import type { RecordSpec, StorageGroup } from "@spine-event-engine/storage";
+import type { Pool } from "mysql2/promise";
+/**
+ * Resolves the default table name for a record-family integration test.
+ *
+ * @internal
+ * @param spec Describes the record family.
+ * @param group Identifies an optional storage group.
+ * @returns The default physical table name.
+ */
+export declare function mysqlRecordTableName<I, R extends Message>(spec: RecordSpec<I, R>, group?: StorageGroup): string;
+/**
+ * Resolves the default tables used by an Entity-family integration test.
+ *
+ * @internal
+ * @param input Describes the Entity family and enabled histories.
+ * @returns The current and enabled history table names.
+ */
+export declare function mysqlEntityTables<I, S extends Message>(input: EntityStorageInput<I, S>): readonly string[];
+/**
+ * Reads the current Entity record for a provider integration test.
+ *
+ * @internal
+ * @param pool Queries the test database.
+ * @param input Identifies the Entity family.
+ * @param id Identifies the current Entity row.
+ * @param stringifiers Converts message-valued identifiers using the factory's mapping.
+ * @returns Resolves to the current record, or `undefined` when it is absent.
+ */
+export declare function mysqlCurrentRecord<I, S extends Message>(pool: Pool, input: EntityStorageInput<I, S>, id: I, stringifiers?: StringifierRegistry): Promise<import("@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js").EntityRecord | undefined>;
+/**
+ * Returns retained state and diagnostic record counts for one Entity in a provider test.
+ *
+ * @internal
+ * @param pool Queries the test database.
+ * @param input Identifies the Entity family.
+ * @param id Identifies the Entity whose histories are counted.
+ * @returns Resolves to the matching state and diagnostic counts.
+ */
+export declare function mysqlHistoryCounts<I, S extends Message>(pool: Pool, input: EntityStorageInput<I, S>, id: I): Promise<{
+    readonly states: number;
+    readonly events: number;
+}>;
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/mysql/testing.ts"],"names":[],"mappings":"AAcA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,gBAAgB,CAAC;AAK1D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACvD,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,YAAY,GACnB,MAAM,CAOR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACpD,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,SAAS,MAAM,EAAE,CAkBnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC3D,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,EAAE,EAAE,CAAC,EACL,YAAY,GAAE,mBAA+C,GAC5D,OAAO,CACN,OAAO,sEAAsE,EAAE,YAAY,GAC3F,SAAS,CACZ,CAQA;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC3D,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,EAAE,EAAE,CAAC,GACJ,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB/D"}

package/dist/mysql/testing.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 { fromBinary, toBinary } from "@bufbuild/protobuf";
+import { AnySchema } from "@bufbuild/protobuf/wkt";
+import { EventSchema } from "@spine-event-engine/proto";
+import { StringifierRegistry } from "@spine-event-engine/core";
+import { EntityRecordSchema } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { eventHistorySpec, stateHistorySpec, } from "@spine-event-engine/storage/provider";
+import { MysqlTableResolver } from "./table-resolver.js";
+import { MysqlIdColumn } from "./id-column.js";
+/**
+ * Resolves the default table name for a record-family integration test.
+ *
+ * @internal
+ * @param spec Describes the record family.
+ * @param group Identifies an optional storage group.
+ * @returns The default physical table name.
+ */
+export function mysqlRecordTableName(spec, group) {
+    return new MysqlTableResolver().resolve(spec.sourceType.typeName, group?.name, undefined, spec.recordType.typeName).tableName;
+}
+/**
+ * Resolves the default tables used by an Entity-family integration test.
+ *
+ * @internal
+ * @param input Describes the Entity family and enabled histories.
+ * @returns The current and enabled history table names.
+ */
+export function mysqlEntityTables(input) {
+    const tables = [
+        new MysqlTableResolver().resolve(input.sourceType.typeName, undefined, undefined, EntityRecordSchema.typeName).tableName,
+    ];
+    if (input.stateHistory) {
+        const state = stateHistorySpec(input.stateSchema);
+        tables.push(mysqlRecordTableName(state.spec, state.group));
+    }
+    if (input.eventHistory) {
+        const event = eventHistorySpec(input.stateSchema);
+        tables.push(mysqlRecordTableName(event.spec, event.group));
+    }
+    return tables;
+}
+/**
+ * Reads the current Entity record for a provider integration test.
+ *
+ * @internal
+ * @param pool Queries the test database.
+ * @param input Identifies the Entity family.
+ * @param id Identifies the current Entity row.
+ * @param stringifiers Converts message-valued identifiers using the factory's mapping.
+ * @returns Resolves to the current record, or `undefined` when it is absent.
+ */
+export async function mysqlCurrentRecord(pool, input, id, stringifiers = new StringifierRegistry()) {
+    const table = mysqlEntityTables(input)[0];
+    if (table === undefined)
+        throw new Error("Current Entity table is missing.");
+    const [rows] = await pool.query(`SELECT bytes FROM \`${table}\` WHERE ID=?`, [new MysqlIdColumn(input.recordSpec.idType, stringifiers).value(id)]);
+    return rows[0] === undefined ? undefined : fromBinary(EntityRecordSchema, rows[0].bytes);
+}
+/**
+ * Returns retained state and diagnostic record counts for one Entity in a provider test.
+ *
+ * @internal
+ * @param pool Queries the test database.
+ * @param input Identifies the Entity family.
+ * @param id Identifies the Entity whose histories are counted.
+ * @returns Resolves to the matching state and diagnostic counts.
+ */
+export async function mysqlHistoryCounts(pool, input, id) {
+    const packedId = input.id.pack(id);
+    let states = 0;
+    if (input.stateHistory) {
+        const state = stateHistorySpec(input.stateSchema);
+        const rows = await recordBytes(pool, input, state.spec, state.group);
+        states = rows.filter((bytes) => {
+            const record = fromBinary(EntityRecordSchema, bytes);
+            return sameAny(record.entityId, packedId);
+        }).length;
+    }
+    let events = 0;
+    if (input.eventHistory) {
+        const event = eventHistorySpec(input.stateSchema);
+        const rows = await recordBytes(pool, input, event.spec, event.group);
+        events = rows.filter((bytes) => {
+            const record = fromBinary(EventSchema, bytes);
+            return sameAny(record.context?.producerId, packedId);
+        }).length;
+    }
+    return { states, events };
+}
+async function recordBytes(pool, input, spec, group) {
+    const table = mysqlRecordTableName(spec, group);
+    const [rows] = await pool.query(`SELECT bytes FROM \`${table}\``);
+    return rows.map((row) => row.bytes);
+}
+function sameAny(left, right) {
+    return (left !== undefined &&
+        Buffer.compare(toBinary(AnySchema, left), toBinary(AnySchema, right)) === 0);
+}
+//# sourceMappingURL=testing.js.map

package/dist/mysql/testing.js.map

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