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

package/dist/mysql/storage-factory.js

@@ -0,0 +1,477 @@
+/*
+ * 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 { createPool } from "mysql2/promise";
+import { toBinary } from "@bufbuild/protobuf";
+import { StringifierRegistry } from "@spine-event-engine/core";
+import { StorageFactory, } from "@spine-event-engine/storage";
+import { TenantBoundary } from "@spine-event-engine/storage/provider";
+import { EntityCommitStorageFactories, } from "@spine-event-engine/storage/provider";
+import { DeliveryCleanupStorageFactories } from "@spine-event-engine/storage/provider";
+import { eventStoreRecordSpec } from "@spine-event-engine/storage/provider";
+import { EntityRecordSchema, } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { MysqlRecordStorage } from "./record-storage.js";
+import { MysqlTableResolver } from "./table-resolver.js";
+import { MysqlEntityStorage } from "./entity-history.js";
+import { mysqlEntityLockKey, MysqlEntityCommitCoordinator } from "./entity-commit.js";
+import { MysqlDeliveryCleanupStorage } from "./delivery-cleanup.js";
+import { resolvedMysqlTableSpec } from "./table-spec.js";
+import { MysqlStorageOperationError, mysqlError } from "./errors.js";
+/**
+ * Reports invalid MySQL storage configuration.
+ */
+export class MysqlStorageConfigurationError extends Error {
+}
+/**
+ * Reports MySQL connection failures.
+ */
+export class MysqlStorageConnectionError extends Error {
+}
+/**
+ * Reports incompatible MySQL record-family schemas.
+ */
+export { MysqlStorageSchemaError } from "./errors.js";
+/**
+ * Reports invalid MySQL storage data.
+ */
+export { MysqlStorageDataError } from "./errors.js";
+/**
+ * Reports sanitized MySQL storage operation failures.
+ */
+export { MysqlStorageOperationError } from "./errors.js";
+/**
+ * Provides MySQL record-family storage.
+ */
+export class MysqlStorageFactory extends StorageFactory {
+    createOperation;
+    stringifiers;
+    #handles = new Set();
+    #resolver;
+    #databases;
+    #catalog;
+    #closed;
+    constructor(databases, resolver = new MysqlTableResolver(), createOperation, stringifiers = new StringifierRegistry()) {
+        super();
+        this.createOperation = createOperation;
+        this.stringifiers = stringifiers;
+        this.#resolver = resolver;
+        this.#databases = new Map(databases.map((database) => [database.boundary.key, database]));
+        this.#catalog = Object.freeze({
+            all: () => Promise.resolve(databases.map(({ boundary }) => boundary)),
+            close: () => Promise.resolve(),
+            keep: (boundary) => {
+                if (!this.#databases.has(boundary.key)) {
+                    return Promise.reject(new MysqlStorageConfigurationError("MySQL storage has no configured tenant."));
+                }
+                return Promise.resolve();
+            },
+        });
+        EntityCommitStorageFactories.register(this, {
+            createEntityCommitStorage: (input) => this.createEntityCommitStorage(input),
+        });
+        DeliveryCleanupStorageFactories.register(this, {
+            createDeliveryCleanupStorage: () => new MysqlDeliveryCleanupStorage((context, spec) => this.createMysqlRecordStorage(context, spec), (context, tables, key, work) => {
+                const database = this.database(context);
+                return new MysqlEntityCommitCoordinator(this.connections(database)).commit(tables, key, (connection) => work(connection), { requireTransaction: true });
+            }, () => "spine-delivery-cleanup"),
+        });
+    }
+    /**
+     * Creates a MySQL storage factory builder.
+     *
+     * @returns Returns a new builder.
+     */
+    static newBuilder() {
+        return new Builder((entries, resolver, operation, stringifiers) => MysqlStorageFactory.connect(entries, resolver, operation, stringifiers));
+    }
+    /**
+     * Returns the provider-owned configured tenant catalog.
+     * @returns The factory-owned tenant catalog.
+     */
+    tenantCatalog() {
+        return this.#catalog;
+    }
+    /**
+     * Closes all storage handles and the connection pool.
+     */
+    close() {
+        this.#closed ??= (async () => {
+            super.close();
+            for (const handle of this.#handles)
+                handle.close();
+            await Promise.all([...this.#databases.values()].map(({ pool }) => pool.end()));
+        })();
+        void this.#closed;
+    }
+    /**
+     * Creates storage for one resolved record family.
+     *
+     * @param context Provides the storage context.
+     * @param spec Describes the record family.
+     * @param group Identifies an optional storage group.
+     * @returns Returns the record-family storage handle.
+     */
+    onCreateRecordStorage(context, spec, group) {
+        return this.createMysqlRecordStorage(context, spec, group);
+    }
+    createMysqlRecordStorage(context, spec, group, database = this.database(context)) {
+        const table = this.#resolver.resolve(spec.sourceType.typeName, group?.name, undefined, spec.recordType.typeName);
+        const tableSpec = resolvedMysqlTableSpec({
+            tableName: table.tableName,
+            sourceType: spec.sourceType,
+            recordType: spec.recordType,
+            idType: spec.idType,
+            ...(group === undefined ? {} : { groupName: group.name }),
+            declaredColumns: spec.columns,
+        });
+        const operation = this.createOperation;
+        const create = operation === undefined ? undefined : () => operation(tableSpec).sql;
+        const handle = new MysqlRecordStorage(context, spec, table, this.connections(database), () => this.#handles.delete(handle), create, tableSpec, this.stringifiers);
+        this.#handles.add(handle);
+        return handle;
+    }
+    /**
+     * Creates MySQL storage for one Entity family.
+     *
+     * @param input Configures the Entity storage families.
+     * @returns Returns the MySQL Entity storage handle.
+     */
+    createEntityStorage(input) {
+        const database = this.database(input.context);
+        const registration = {};
+        const handle = new MysqlEntityStorage(input, (spec, group) => this.createMysqlRecordStorage(input.context, spec, group, database), () => this.#handles.delete(registration.handle));
+        registration.handle = handle;
+        this.#handles.add(handle);
+        return handle;
+    }
+    /**
+     * Creates MySQL storage for atomic Entity commits.
+     *
+     * @param input Configures the Entity storage families.
+     * @returns Returns the Entity commit storage handle.
+     */
+    createEntityCommitStorage(input) {
+        const database = this.database(input.context);
+        const registration = {};
+        const handle = new MysqlEntityCommitStorage(input, () => this.createEntityStorage(input), () => this.createMysqlRecordStorage(input.context, eventStoreRecordSpec, undefined, database), new MysqlEntityCommitCoordinator(this.connections(database)), database.databaseName, () => this.#handles.delete(registration.handle));
+        registration.handle = handle;
+        this.#handles.add(handle);
+        return handle;
+    }
+    connections(database) {
+        return {
+            databaseName: database.databaseName,
+            acquire: () => database.pool.getConnection(),
+            release: (connection) => {
+                connection.release();
+            },
+        };
+    }
+    database(context) {
+        const boundary = TenantBoundary.of(context);
+        const database = this.#databases.get(boundary.key);
+        if (database !== undefined)
+            return database;
+        throw new MysqlStorageConfigurationError(boundary.single
+            ? "MySQL storage is configured for multiple tenants."
+            : "MySQL storage has no configured database for the requested tenant.");
+    }
+    /**
+     * Connects to MySQL and creates an initialized storage factory.
+     *
+     * @param options Specifies the MySQL connection options.
+     * @param resolver Resolves configured record-family table names.
+     * @param createOperation Creates optional table-creation SQL.
+     * @param stringifiers Converts message-valued IDs and columns.
+     * @internal
+     * @returns Resolves to the initialized factory.
+     */
+    static async connect(entries, resolver = new MysqlTableResolver(), createOperation, stringifiers = new StringifierRegistry()) {
+        const connected = [];
+        try {
+            for (const entry of entries) {
+                const pool = createPool(entry.poolOptions);
+                try {
+                    const connection = await pool.getConnection();
+                    try {
+                        await assertNoRetiredLayout(connection);
+                    }
+                    finally {
+                        connection.release();
+                    }
+                    connected.push({
+                        boundary: entry.boundary,
+                        databaseName: entry.databaseName,
+                        pool,
+                    });
+                }
+                catch (error) {
+                    await pool.end().catch(() => undefined);
+                    if (error instanceof MysqlStorageConfigurationError)
+                        throw error;
+                    throw new MysqlStorageConnectionError("Unable to connect to MySQL.");
+                }
+            }
+            return new MysqlStorageFactory(connected, resolver, createOperation, stringifiers);
+        }
+        catch (error) {
+            await Promise.all(connected.map(({ pool }) => pool.end().catch(() => undefined)));
+            if (error instanceof MysqlStorageConfigurationError)
+                throw error;
+            throw new MysqlStorageConnectionError("Unable to connect to MySQL.");
+        }
+    }
+}
+class Builder {
+    connect;
+    #options;
+    #tenantOptions;
+    #resolver = new MysqlTableResolver();
+    #operation;
+    #stringifiers = new StringifierRegistry();
+    constructor(connect) {
+        this.connect = connect;
+    }
+    // prettier-ignore
+    /**
+     * Sets the MySQL connection options.
+     *
+     * @param options Specifies the MySQL connection options.
+     * @returns Returns this builder.
+     */
+    setOptions(options) {
+        this.#options = options;
+        return this;
+    }
+    /**
+     * Sets the complete multitenant database registry.
+     * @param entries Assign generated tenants to distinct physical databases.
+     * @returns Returns this builder.
+     */
+    setTenantOptions(entries) {
+        this.#tenantOptions = [...entries];
+        return this;
+    }
+    /**
+     * Sets custom reversible message stringifiers used by IDs and columns.
+     *
+     * @param registry The schema-bound stringifier registry.
+     * @returns Returns this builder.
+     */
+    setStringifierRegistry(registry) {
+        this.#stringifiers = new StringifierRegistry(registry);
+        return this;
+    }
+    /**
+     * Sets a configured table name.
+     *
+     * @param args Provides the record-only or grouped registration arguments.
+     * @returns Returns this builder.
+     */
+    setTableName(...args) {
+        if (args.length === 2) {
+            const [source, name] = args;
+            this.#resolver.setRecordName(source.typeName, name);
+        }
+        else {
+            const [source, record, name] = args;
+            this.#resolver.setGroupName(source.typeName, record.typeName, name);
+        }
+        return this;
+    }
+    /**
+     * Sets the create-table operation factory.
+     *
+     * @param factory Creates SQL for resolved record-family tables.
+     * @returns Returns this builder.
+     */
+    useOperationFactory(factory) {
+        this.#operation = factory;
+        return this;
+    }
+    /**
+     * Builds an initialized MySQL storage factory.
+     *
+     * @returns Resolves to the initialized factory.
+     */
+    async build() {
+        if (this.#options !== undefined && this.#tenantOptions !== undefined) {
+            throw new MysqlStorageConfigurationError("Configure either single-tenant or multitenant MySQL storage, not both.");
+        }
+        if (this.#options === undefined && this.#tenantOptions === undefined)
+            throw new MysqlStorageConfigurationError("MySQL storage options are required.");
+        const entries = this.#options === undefined
+            ? MysqlConfigurations.multitenant(this.#tenantOptions ?? [])
+            : [MysqlConfigurations.single(this.#options)];
+        return this.connect(entries, this.#resolver, this.#operation, this.#stringifiers);
+    }
+}
+async function assertNoRetiredLayout(connection) {
+    const [columns] = await connection.query("SELECT table_name AS table_name, column_name AS column_name " +
+        "FROM information_schema.columns WHERE table_schema=DATABASE() " +
+        "AND LOWER(column_name) IN ('_scope', '_revision')");
+    const [primary] = await connection.query("SELECT table_name AS table_name, column_name AS column_name, seq_in_index AS seq_in_index " +
+        "FROM information_schema.statistics WHERE table_schema=DATABASE() " +
+        "AND index_name='PRIMARY' ORDER BY table_name, seq_in_index");
+    if (columns.length > 0 ||
+        primary.some((column) => column.column_name.toLowerCase() === "_scope")) {
+        throw new MysqlStorageConfigurationError("The configured database contains the retired MySQL storage layout.");
+    }
+}
+const MysqlConfigurations = Object.freeze({
+    single(options) {
+        return MysqlConfigurations.parse(TenantBoundary.single, options);
+    },
+    multitenant(entries) {
+        if (entries.length === 0) {
+            throw new MysqlStorageConfigurationError("Multitenant MySQL storage requires tenants.");
+        }
+        const configured = entries.map(({ tenantId, options }) => MysqlConfigurations.parse(TenantBoundary.from(tenantId), options));
+        const tenants = new Set();
+        const targets = new Set();
+        for (const entry of configured) {
+            if (tenants.has(entry.boundary.key)) {
+                throw new MysqlStorageConfigurationError("MySQL storage has a duplicate tenant.");
+            }
+            if (targets.has(entry.target)) {
+                throw new MysqlStorageConfigurationError("MySQL tenants must use distinct physical databases.");
+            }
+            tenants.add(entry.boundary.key);
+            targets.add(entry.target);
+        }
+        return configured;
+    },
+    parse(boundary, options) {
+        let url;
+        try {
+            url = new URL(options.url);
+        }
+        catch {
+            throw new MysqlStorageConfigurationError("MySQL storage requires a valid URL.");
+        }
+        if (url.protocol !== "mysql:" || url.pathname.length <= 1) {
+            throw new MysqlStorageConfigurationError("MySQL storage URL requires a database.");
+        }
+        const databaseName = decodeURIComponent(url.pathname.slice(1));
+        const port = url.port === "" ? 3306 : Number(url.port);
+        return {
+            boundary,
+            databaseName,
+            target: `${url.hostname.toLowerCase()}:${String(port)}/${databaseName.toLowerCase()}`,
+            poolOptions: {
+                host: url.hostname,
+                ...(url.port === "" ? {} : { port }),
+                database: databaseName,
+                supportBigNumbers: true,
+                bigNumberStrings: true,
+                ...(url.username === "" ? {} : { user: decodeURIComponent(url.username) }),
+                ...(url.password === "" ? {} : { password: decodeURIComponent(url.password) }),
+                ...(options.connectionLimit === undefined
+                    ? {}
+                    : { connectionLimit: options.connectionLimit }),
+                ...(options.connectTimeoutMs === undefined
+                    ? {}
+                    : { connectTimeout: options.connectTimeoutMs }),
+                ...(options.tls === undefined ? {} : { ssl: options.tls }),
+            },
+        };
+    },
+});
+class MysqlEntityCommitStorage {
+    entity;
+    openStorage;
+    openEvents;
+    coordinator;
+    databaseName;
+    onClose;
+    #open = true;
+    constructor(entity, openStorage, openEvents, coordinator, databaseName, onClose) {
+        this.entity = entity;
+        this.openStorage = openStorage;
+        this.openEvents = openEvents;
+        this.coordinator = coordinator;
+        this.databaseName = databaseName;
+        this.onClose = onClose;
+    }
+    async commit(input) {
+        if (!this.#open)
+            throw new MysqlStorageOperationError("Entity commit storage is closed.");
+        if (input.entity.sourceType.typeName !== this.entity.sourceType.typeName)
+            throw new MysqlStorageOperationError("Entity commit source type is incompatible.");
+        if (!this.accepts(input))
+            throw new MysqlStorageOperationError("Entity commit context is incompatible.");
+        if (!this.entity.stateHistory && (input.states?.length ?? 0) > 0)
+            throw new MysqlStorageOperationError("Entity state history is disabled.");
+        if (!this.entity.eventHistory && (input.diagnostics?.length ?? 0) > 0)
+            throw new MysqlStorageOperationError("Entity event history is disabled.");
+        if ((input.events ?? []).some((event) => event.id === undefined))
+            throw new MysqlStorageOperationError("Entity commit requires delivery-event IDs.");
+        const storage = this.openStorage();
+        const events = this.openEvents();
+        try {
+            const families = storage.commitCapability();
+            await families.prepare();
+            await events.prepare();
+            const lockKey = mysqlEntityLockKey({
+                databaseName: this.databaseName,
+                entityKey: input.entity.id.key(input.entityId),
+                sourceTypeName: this.entity.sourceType.typeName,
+            });
+            return await this.coordinator.commit([...families.tableNames(), events.tableName], lockKey, (connection, transactional) => families.withConnection(connection, () => events.withConnection(connection, async () => {
+                const current = await families.readCurrentLocked(input.entityId);
+                if (!sameEntity(current, input.expected) && !sameEntity(current, input.next))
+                    return "conflict";
+                if (!transactional) {
+                    await families.preflightImmutable(input.states ?? [], input.diagnostics ?? []);
+                    for (const event of input.events ?? [])
+                        await events.assertImmutable(event);
+                }
+                for (const state of input.states ?? [])
+                    await families.appendStateImmutable(state);
+                for (const diagnostic of input.diagnostics ?? [])
+                    await families.appendDiagnosticImmutable(diagnostic);
+                for (const event of input.events ?? []) {
+                    if (event.id === undefined)
+                        throw new MysqlStorageOperationError("Entity commit requires delivery-event IDs.");
+                    await events.writeImmutable(event);
+                }
+                if (!sameEntity(current, input.next))
+                    await storage.current.write(input.next);
+                return "committed";
+            })));
+        }
+        catch (error) {
+            throw mysqlError(MysqlStorageOperationError, "MySQL Entity commit failed.", error);
+        }
+        finally {
+            events.close();
+            storage.close();
+        }
+    }
+    close() {
+        if (!this.#open)
+            return;
+        this.#open = false;
+        this.onClose();
+    }
+    accepts(input) {
+        return (input.context.multitenant === this.entity.context.multitenant &&
+            TenantBoundary.of(input.context).key === TenantBoundary.of(this.entity.context).key);
+    }
+}
+function sameEntity(left, right) {
+    return left === undefined || right === undefined
+        ? left === right
+        : Buffer.compare(toBinary(EntityRecordSchema, left), toBinary(EntityRecordSchema, right)) === 0;
+}
+//# sourceMappingURL=storage-factory.js.map

package/dist/mysql/storage-factory.js.map

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

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

@@ -0,0 +1,34 @@
+import type { MysqlResolvedTable } from "./table-spec.js";
+/**
+ * Resolves stable MySQL-safe table names for record families.
+ */
+export declare class MysqlTableResolver {
+    #private;
+    /**
+     * Sets the ungrouped table name for a record type.
+     *
+     * @param recordType Names the record type.
+     * @param name Specifies the physical table name.
+     */
+    setRecordName(recordType: string, name: string): void;
+    /**
+     * Sets the grouped table name for a source and record type.
+     *
+     * @param sourceType Names the source type.
+     * @param recordType Names the record type.
+     * @param name Specifies the physical table name.
+     */
+    setGroupName(sourceType: string, recordType: string, name: string): void;
+    /**
+     * Resolves the table layout for a record family.
+     *
+     * @param sourceType Names the source type.
+     * @param group Names the optional storage group.
+     * @param name Supplies an explicit table name.
+     * @param recordType Names the grouped record type.
+     * @returns Returns the resolved table layout.
+     */
+    resolve(sourceType: string, group: string | undefined, name?: string, recordType?: string): MysqlResolvedTable;
+    private set;
+}
+//# sourceMappingURL=table-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table-resolver.d.ts","sourceRoot":"","sources":["../../src/mysql/table-resolver.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;GAEG;AACH,qBAAa,kBAAkB;;IAI7B;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrD;;;;;;OAMG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxE;;;;;;;;OAQG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB;IAmCrB,OAAO,CAAC,GAAG;CAQZ"}

package/dist/mysql/table-resolver.js

@@ -0,0 +1,87 @@
+/*
+ * 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.
+ */
+/**
+ * Resolves stable MySQL-safe table names for record families.
+ */
+export class MysqlTableResolver {
+    #names = new Map();
+    #resolved = new Map();
+    /**
+     * Sets the ungrouped table name for a record type.
+     *
+     * @param recordType Names the record type.
+     * @param name Specifies the physical table name.
+     */
+    setRecordName(recordType, name) {
+        this.set(`record:${recordType}`, name);
+    }
+    /**
+     * Sets the grouped table name for a source and record type.
+     *
+     * @param sourceType Names the source type.
+     * @param recordType Names the record type.
+     * @param name Specifies the physical table name.
+     */
+    setGroupName(sourceType, recordType, name) {
+        this.set(`group:${sourceType}:${recordType}`, name);
+    }
+    /**
+     * Resolves the table layout for a record family.
+     *
+     * @param sourceType Names the source type.
+     * @param group Names the optional storage group.
+     * @param name Supplies an explicit table name.
+     * @param recordType Names the grouped record type.
+     * @returns Returns the resolved table layout.
+     */
+    resolve(sourceType, group, name, recordType) {
+        const registered = group === undefined
+            ? this.#names.get(`record:${sourceType}`)
+            : (this.#names.get(`group:${sourceType}:${recordType ?? ""}`) ??
+                this.#names.get(`record:${recordType ?? ""}`));
+        const readable = name ??
+            registered ??
+            (group === undefined
+                ? sourceType.replaceAll(".", "_")
+                : `${group.replaceAll(".", "_")}_${(recordType ?? sourceType).slice((recordType ?? sourceType).lastIndexOf(".") + 1)}`);
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(readable) || Buffer.byteLength(readable) > 64) {
+            throw new Error(`MySQL table name is invalid: ${readable}`);
+        }
+        const identity = group === undefined && this.#names.get(`record:${sourceType}`) !== undefined
+            ? `record:${sourceType}`
+            : group !== undefined &&
+                this.#names.get(`group:${sourceType}:${recordType ?? ""}`) === undefined &&
+                this.#names.get(`record:${recordType ?? ""}`) !== undefined
+                ? `record:${recordType ?? sourceType}`
+                : group === undefined
+                    ? sourceType
+                    : `${sourceType}\u0000${recordType ?? sourceType}\u0000${group}`;
+        const previous = this.#resolved.get(readable);
+        if (previous !== undefined && previous !== identity)
+            throw new Error(`MySQL table name collides: ${readable}`);
+        this.#resolved.set(readable, identity);
+        return Object.freeze({
+            tableName: readable,
+        });
+    }
+    set(identity, name) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name) || Buffer.byteLength(name) > 64)
+            throw new Error(`MySQL table name is invalid: ${name}`);
+        for (const [registered, value] of this.#names)
+            if (registered !== identity && value === name)
+                throw new Error(`MySQL table name collides: ${name}`);
+        this.#names.set(identity, name);
+    }
+}
+//# sourceMappingURL=table-resolver.js.map

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

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