@beignet/provider-db-drizzle 0.0.9

package/dist/mysql/index.d.ts

@@ -0,0 +1,254 @@
+/**
+ * @beignet/provider-db-drizzle/mysql
+ *
+ * Drizzle ORM MySQL provider, backed by mysql2, that creates a typed
+ * database port. Works with self-hosted MySQL 8.0+ and hosted MySQL services.
+ *
+ * Configuration:
+ * - MYSQL_DB_URL: MySQL connection URL (required), e.g.
+ *   "mysql://user:password@localhost:3306/app"
+ *
+ * @example
+ * ```ts
+ * import * as schema from "@/db/schema";
+ * import { createDrizzleMysqlProvider } from "@beignet/provider-db-drizzle/mysql";
+ *
+ * export const drizzleMysqlProvider = createDrizzleMysqlProvider({ schema });
+ *
+ * // In createNextServer:
+ * const server = await createNextServer({
+ *   ports: basePorts,
+ *   providers: [drizzleMysqlProvider],
+ *   // ...
+ * });
+ *
+ * // In infra:
+ * const todos = createDrizzleTodoRepository(ctx.ports.db.db);
+ * ```
+ */
+import type { IdempotencyPort } from "@beignet/core/idempotency";
+import type { OutboxPort } from "@beignet/core/outbox";
+import { type BufferedDomainEventRecorder, type EventBusPort, type UnitOfWorkPort } from "@beignet/core/ports";
+import { type ExtractTablesWithRelations } from "drizzle-orm";
+import type { MySqlDatabase, MySqlQueryResultHKT, MySqlTransaction, MySqlTransactionConfig, PreparedQueryHKTBase } from "drizzle-orm/mysql-core";
+import { type MySql2Database } from "drizzle-orm/mysql2";
+import type { Pool, PoolOptions } from "mysql2/promise";
+import { z } from "zod";
+/**
+ * Typed database port interface.
+ * Exposes a typed Drizzle database instance for your schema.
+ *
+ * @template TSchema - The Drizzle schema type (e.g., `typeof schema`)
+ */
+export interface DbPort<TSchema extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * The typed Drizzle database instance.
+     * Use this to query your database with full type safety.
+     */
+    db: MySql2Database<TSchema>;
+    /**
+     * The underlying mysql2 connection pool.
+     * Use this for advanced operations not covered by Drizzle ORM.
+     */
+    pool: Pool;
+}
+/**
+ * Drizzle database or transaction client accepted by repository factories.
+ *
+ * `MySqlTransaction` extends `MySqlDatabase`, so both the root database and
+ * transaction clients satisfy this seam.
+ */
+export type DrizzleMysqlDatabase<TSchema extends Record<string, unknown> = Record<string, unknown>> = MySqlDatabase<MySqlQueryResultHKT, PreparedQueryHKTBase, TSchema>;
+/**
+ * Drizzle transaction client passed to Unit of Work repository factories.
+ */
+export type DrizzleMysqlTransaction<TSchema extends Record<string, unknown> = Record<string, unknown>> = MySqlTransaction<MySqlQueryResultHKT, PreparedQueryHKTBase, TSchema, ExtractTablesWithRelations<TSchema>>;
+/**
+ * Options for creating a Drizzle MySQL-backed Unit of Work port.
+ */
+export interface DrizzleMysqlUnitOfWorkOptions<TSchema extends Record<string, unknown>, TxPorts> {
+    /**
+     * The root Drizzle database instance from `ctx.ports.db.db`.
+     */
+    db: DrizzleMysqlDatabase<TSchema>;
+    /**
+     * Create transaction-scoped ports from the Drizzle transaction client.
+     *
+     * The event recorder is transaction-local. Record domain events inside the
+     * callback and pass `eventBus` to publish them after the database commit.
+     */
+    createTransactionPorts: (db: DrizzleMysqlTransaction<TSchema>, events: BufferedDomainEventRecorder) => TxPorts;
+    /**
+     * Optional event bus used to flush recorded domain events after commit.
+     */
+    eventBus?: EventBusPort;
+    /**
+     * Optional Drizzle transaction configuration.
+     */
+    transactionConfig?: MySqlTransactionConfig;
+}
+/**
+ * Create a Unit of Work port backed by Drizzle's MySQL transaction API.
+ *
+ * Beignet does not own your repository interfaces. This helper only
+ * provides the transaction boundary and post-commit event flushing; your app
+ * decides which transaction-scoped ports to create.
+ */
+export declare function createDrizzleMysqlUnitOfWork<TSchema extends Record<string, unknown>, TxPorts>(options: DrizzleMysqlUnitOfWorkOptions<TSchema, TxPorts>): UnitOfWorkPort<TxPorts>;
+/**
+ * Options for a Drizzle MySQL-backed outbox port.
+ */
+export interface DrizzleMysqlOutboxOptions {
+    /**
+     * Table that stores outbox messages.
+     *
+     * Default: "outbox_messages".
+     */
+    tableName?: string;
+    /**
+     * Clock used by tests and deterministic environments.
+     */
+    now?: () => Date;
+}
+/**
+ * Create idempotent SQL statements for the Drizzle MySQL outbox table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleMysqlOutboxPort(...)`.
+ *
+ * Indexes are declared inline because MySQL has no
+ * `CREATE INDEX IF NOT EXISTS`; the whole shape stays idempotent under
+ * `CREATE TABLE IF NOT EXISTS`. The binary no-pad collation
+ * `utf8mb4_0900_bin` (MySQL 8.0+) keeps string comparisons case-sensitive
+ * and free of PAD SPACE semantics, which claim tokens and fingerprints
+ * require.
+ */
+export declare function createDrizzleMysqlOutboxSetupStatements(options?: DrizzleMysqlOutboxOptions): readonly string[];
+/**
+ * Create a Beignet outbox port backed by a Drizzle MySQL database.
+ *
+ * Claiming uses a claim-token lease so concurrent workers can safely compete
+ * for eligible messages, combined with `for update skip locked` row locking.
+ */
+export declare function createDrizzleMysqlOutboxPort<TSchema extends Record<string, unknown>>(db: DrizzleMysqlDatabase<TSchema>, adapterOptions?: DrizzleMysqlOutboxOptions): OutboxPort;
+/**
+ * Options for a Drizzle MySQL-backed idempotency port.
+ */
+export interface DrizzleMysqlIdempotencyOptions {
+    /**
+     * Table that stores idempotency records.
+     *
+     * Default: "idempotency_records".
+     */
+    tableName?: string;
+    /**
+     * Clock used by tests and deterministic environments.
+     */
+    now?: () => Date;
+}
+/**
+ * Error thrown when `complete(...)` or `fail(...)` does not match an
+ * in-progress idempotency reservation with the provided fingerprint.
+ *
+ * This usually signals a workflow bug: the reservation was never made, was
+ * already completed or released, expired and was cleaned up, or the caller
+ * passed a different fingerprint than the one used to reserve.
+ */
+export declare class DrizzleMysqlIdempotencyMutationError extends Error {
+    readonly action: "complete" | "fail";
+    readonly namespace: string;
+    readonly key: string;
+    readonly scopeKey: string;
+    constructor(args: {
+        action: "complete" | "fail";
+        namespace: string;
+        key: string;
+        scopeKey: string;
+    });
+}
+/**
+ * Create idempotent SQL statements for the Drizzle MySQL idempotency table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleMysqlIdempotencyPort(...)`.
+ *
+ * Indexes are declared inline because MySQL has no
+ * `CREATE INDEX IF NOT EXISTS`; the whole shape stays idempotent under
+ * `CREATE TABLE IF NOT EXISTS`. The binary no-pad collation
+ * `utf8mb4_0900_bin` (MySQL 8.0+) keeps fingerprint comparisons
+ * case-sensitive — "ABC" and "abc" must classify as conflict, never replay.
+ */
+export declare function createDrizzleMysqlIdempotencySetupStatements(options?: DrizzleMysqlIdempotencyOptions): readonly string[];
+/**
+ * Create a Beignet idempotency port backed by a Drizzle MySQL database.
+ *
+ * The port accepts both the root Drizzle database and transaction clients, so
+ * applications can expose root idempotency for ordinary retry-safe commands and
+ * transaction-scoped idempotency from Unit of Work.
+ */
+export declare function createDrizzleMysqlIdempotencyPort<TSchema extends Record<string, unknown>>(db: DrizzleMysqlDatabase<TSchema>, adapterOptions?: DrizzleMysqlIdempotencyOptions): IdempotencyPort;
+/**
+ * Configuration schema for the Drizzle MySQL provider.
+ * Validates environment variables with MYSQL_ prefix.
+ */
+export declare const MysqlConfigSchema: z.ZodObject<{
+    DB_URL: z.ZodString;
+}, z.core.$strip>;
+/**
+ * MySQL provider config loaded from `MYSQL_*` env vars.
+ */
+export type MysqlConfig = z.infer<typeof MysqlConfigSchema>;
+/**
+ * Options for creating a Drizzle MySQL provider.
+ *
+ * @template TSchema - The Drizzle schema type
+ */
+export interface DrizzleMysqlProviderOptions<TSchema extends Record<string, unknown>, PortName extends string = "db"> {
+    /**
+     * The Drizzle schema object (e.g. `import * as schema from '@/db/schema'`).
+     * This schema is used to create a typed Drizzle database instance.
+     */
+    schema: TSchema;
+    /**
+     * Optional port name. Defaults to "db".
+     * Renames the contributed port. The provider always reads its connection
+     * from `MYSQL_DB_URL`; for a second database, wire an app-owned provider
+     * with its own env prefix instead.
+     */
+    portName?: PortName;
+    /**
+     * Optional mysql2 pool options merged into the pool created from
+     * `MYSQL_DB_URL` (e.g. `connectionLimit`, `timezone`, TLS settings).
+     */
+    pool?: Omit<PoolOptions, "uri">;
+    /**
+     * Drizzle relational-query mode. Use "planetscale" when connecting to
+     * PlanetScale; defaults to "default".
+     */
+    mode?: "default" | "planetscale";
+}
+/**
+ * Create a Drizzle MySQL provider factory.
+ *
+ * This factory creates a service provider that:
+ * - Uses a mysql2/promise connection pool
+ * - Uses Drizzle ORM via drizzle-orm/mysql2
+ * - Exposes a typed DbPort<TSchema> on ports
+ * - Uses MYSQL_-prefixed env vars for connection config
+ *
+ * @template TSchema - The Drizzle schema type (inferred from the schema parameter)
+ * @param options - Configuration options including the schema
+ * @returns A service provider that can be used with createNextServer
+ *
+ * @example
+ * ```ts
+ * import * as schema from "@/db/schema";
+ * import { createDrizzleMysqlProvider } from "@beignet/provider-db-drizzle/mysql";
+ *
+ * export const drizzleMysqlProvider = createDrizzleMysqlProvider({ schema });
+ * ```
+ */
+export declare function createDrizzleMysqlProvider<TSchema extends Record<string, unknown>, PortName extends string = "db">(options: DrizzleMysqlProviderOptions<TSchema, PortName>): import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
+    DB_URL: z.ZodString;
+}, z.core.$strip>, Record<PortName, DbPort<TSchema>>, unknown, void>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/mysql/index.js

@@ -0,0 +1,348 @@
+/**
+ * @beignet/provider-db-drizzle/mysql
+ *
+ * Drizzle ORM MySQL provider, backed by mysql2, that creates a typed
+ * database port. Works with self-hosted MySQL 8.0+ and hosted MySQL services.
+ *
+ * Configuration:
+ * - MYSQL_DB_URL: MySQL connection URL (required), e.g.
+ *   "mysql://user:password@localhost:3306/app"
+ *
+ * @example
+ * ```ts
+ * import * as schema from "@/db/schema";
+ * import { createDrizzleMysqlProvider } from "@beignet/provider-db-drizzle/mysql";
+ *
+ * export const drizzleMysqlProvider = createDrizzleMysqlProvider({ schema });
+ *
+ * // In createNextServer:
+ * const server = await createNextServer({
+ *   ports: basePorts,
+ *   providers: [drizzleMysqlProvider],
+ *   // ...
+ * });
+ *
+ * // In infra:
+ * const todos = createDrizzleTodoRepository(ctx.ports.db.db);
+ * ```
+ */
+import { createDomainEventRecorder, } from "@beignet/core/ports";
+import { createProvider, createProviderInstrumentation, } from "@beignet/core/providers";
+import { sql } from "drizzle-orm";
+import { drizzle } from "drizzle-orm/mysql2";
+import * as mysql from "mysql2/promise";
+import { z } from "zod";
+import { createIdempotencyPortCore, formatIdempotencyMutationErrorMessage, } from "../shared/idempotency-core.js";
+import { quoteIdentifier } from "../shared/identifiers.js";
+import { createDbQueryLogger } from "../shared/instrumentation.js";
+import { createOutboxPortCore, } from "../shared/outbox-core.js";
+/**
+ * Create a Unit of Work port backed by Drizzle's MySQL transaction API.
+ *
+ * Beignet does not own your repository interfaces. This helper only
+ * provides the transaction boundary and post-commit event flushing; your app
+ * decides which transaction-scoped ports to create.
+ */
+export function createDrizzleMysqlUnitOfWork(options) {
+    return {
+        async transaction(work) {
+            const events = createDomainEventRecorder();
+            const result = await options.db.transaction(async (tx) => {
+                const txPorts = options.createTransactionPorts(tx, events);
+                return work(txPorts);
+            }, options.transactionConfig);
+            if (options.eventBus) {
+                await events.flush(options.eventBus);
+            }
+            return result;
+        },
+    };
+}
+/**
+ * Read the first element of a drizzle mysql2 `db.execute(...)` result tuple.
+ *
+ * drizzle-orm/mysql2 returns `[rows | ResultSetHeader, fields]`: for selects
+ * element 0 is the row array; for mutations element 0 is a ResultSetHeader.
+ */
+function readResultHead(result) {
+    return Array.isArray(result) ? result[0] : undefined;
+}
+function readResultRows(result) {
+    const head = readResultHead(result);
+    return Array.isArray(head) ? head : [];
+}
+function readAffectedRows(result) {
+    const head = readResultHead(result);
+    if (head === null || typeof head !== "object" || Array.isArray(head)) {
+        return undefined;
+    }
+    const affectedRows = head.affectedRows;
+    return typeof affectedRows === "number" ? affectedRows : undefined;
+}
+/**
+ * Detect a MySQL duplicate-key violation (ER_DUP_ENTRY, errno 1062) anywhere
+ * in an error's cause chain — drizzle wraps driver errors in
+ * DrizzleQueryError with the mysql2 error as `cause`.
+ */
+function isDuplicateKeyError(error) {
+    for (let current = error; current !== null && typeof current === "object"; current = current.cause) {
+        const candidate = current;
+        if (candidate.errno === 1062 || candidate.code === "ER_DUP_ENTRY") {
+            return true;
+        }
+    }
+    return false;
+}
+function createMysqlExecutor(db, table) {
+    return {
+        table,
+        // MySQL 8.0+ row-locking clause so concurrent claimers skip locked rows.
+        claimLockSuffix: sql.raw(" for update skip locked"),
+        // Duplicate keys surface as ER_DUP_ENTRY caught in run() below — a plain
+        // insert keeps the conflict signal independent of connection flags.
+        // mysql2 enables CLIENT_FOUND_ROWS by default, which makes
+        // `on duplicate key update x = x` report affectedRows 1 instead of 0,
+        // so counting-based duplicate detection silently misreads duplicates as
+        // inserts. Do NOT switch to INSERT IGNORE either: strict mode downgrades
+        // truncation errors to warnings, silently corrupting stored values.
+        insertPrefix: sql.raw("insert into"),
+        insertConflictSuffix: sql.raw(""),
+        async rows(query) {
+            return readResultRows(await db.execute(query));
+        },
+        async row(query) {
+            return readResultRows(await db.execute(query))[0];
+        },
+        async run(query) {
+            // With mysql2's default CLIENT_FOUND_ROWS flag, affectedRows for
+            // UPDATE counts MATCHED rows (without it, CHANGED rows). Every guarded
+            // update issued by the shared cores deterministically changes at least
+            // one column (fresh claim token or status transition), so the count is
+            // identical either way. Keep it that way: a no-op update would make
+            // the two flag modes disagree.
+            //
+            // A duplicate-key violation reports 0 instead of throwing: the only
+            // unique-key inserts the shared cores issue are the idempotency
+            // reserve (where "0 rows" is exactly the conflict fall-through signal)
+            // and outbox enqueues keyed by fresh UUIDs. MySQL does not abort the
+            // surrounding transaction on a statement error, so the reserve's
+            // read-and-classify step still runs inside the same transaction.
+            try {
+                return readAffectedRows(await db.execute(query));
+            }
+            catch (error) {
+                if (isDuplicateKeyError(error)) {
+                    return 0;
+                }
+                throw error;
+            }
+        },
+        withTransaction(fn) {
+            if ("transaction" in db && typeof db.transaction === "function") {
+                return db.transaction((tx) => fn(createMysqlExecutor(tx, table)));
+            }
+            return undefined;
+        },
+    };
+}
+/**
+ * Create idempotent SQL statements for the Drizzle MySQL outbox table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleMysqlOutboxPort(...)`.
+ *
+ * Indexes are declared inline because MySQL has no
+ * `CREATE INDEX IF NOT EXISTS`; the whole shape stays idempotent under
+ * `CREATE TABLE IF NOT EXISTS`. The binary no-pad collation
+ * `utf8mb4_0900_bin` (MySQL 8.0+) keeps string comparisons case-sensitive
+ * and free of PAD SPACE semantics, which claim tokens and fingerprints
+ * require.
+ */
+export function createDrizzleMysqlOutboxSetupStatements(options = {}) {
+    const tableName = options.tableName ?? "outbox_messages";
+    const table = quoteIdentifier(tableName, "`");
+    const indexPrefix = tableName.replaceAll(/[^A-Za-z0-9_]/g, "_");
+    return [
+        `CREATE TABLE IF NOT EXISTS ${table} (
+      id varchar(255) NOT NULL PRIMARY KEY,
+      kind varchar(32) NOT NULL,
+      name varchar(255) NOT NULL,
+      payload_json longtext NOT NULL,
+      status varchar(32) NOT NULL,
+      attempts int NOT NULL DEFAULT 0,
+      max_attempts int NOT NULL DEFAULT 3,
+      available_at varchar(32) NOT NULL,
+      claimed_at varchar(32),
+      locked_until varchar(32),
+      claim_token varchar(64),
+      delivered_at varchar(32),
+      last_error_json longtext,
+      created_at varchar(32) NOT NULL,
+      updated_at varchar(32) NOT NULL,
+      INDEX ${quoteIdentifier(`${indexPrefix}_available_idx`, "`")} (status, available_at),
+      INDEX ${quoteIdentifier(`${indexPrefix}_locked_idx`, "`")} (status, locked_until)
+    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_bin`,
+    ];
+}
+/**
+ * Create a Beignet outbox port backed by a Drizzle MySQL database.
+ *
+ * Claiming uses a claim-token lease so concurrent workers can safely compete
+ * for eligible messages, combined with `for update skip locked` row locking.
+ */
+export function createDrizzleMysqlOutboxPort(db, adapterOptions = {}) {
+    const table = sql.raw(quoteIdentifier(adapterOptions.tableName ?? "outbox_messages", "`"));
+    const executor = createMysqlExecutor(db, table);
+    return createOutboxPortCore(executor, { now: adapterOptions.now });
+}
+/**
+ * Error thrown when `complete(...)` or `fail(...)` does not match an
+ * in-progress idempotency reservation with the provided fingerprint.
+ *
+ * This usually signals a workflow bug: the reservation was never made, was
+ * already completed or released, expired and was cleaned up, or the caller
+ * passed a different fingerprint than the one used to reserve.
+ */
+export class DrizzleMysqlIdempotencyMutationError extends Error {
+    action;
+    namespace;
+    key;
+    scopeKey;
+    constructor(args) {
+        super(formatIdempotencyMutationErrorMessage(args));
+        this.name = "DrizzleMysqlIdempotencyMutationError";
+        this.action = args.action;
+        this.namespace = args.namespace;
+        this.key = args.key;
+        this.scopeKey = args.scopeKey;
+    }
+}
+/**
+ * Create idempotent SQL statements for the Drizzle MySQL idempotency table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleMysqlIdempotencyPort(...)`.
+ *
+ * Indexes are declared inline because MySQL has no
+ * `CREATE INDEX IF NOT EXISTS`; the whole shape stays idempotent under
+ * `CREATE TABLE IF NOT EXISTS`. The binary no-pad collation
+ * `utf8mb4_0900_bin` (MySQL 8.0+) keeps fingerprint comparisons
+ * case-sensitive — "ABC" and "abc" must classify as conflict, never replay.
+ */
+export function createDrizzleMysqlIdempotencySetupStatements(options = {}) {
+    const tableName = options.tableName ?? "idempotency_records";
+    const table = quoteIdentifier(tableName, "`");
+    const indexPrefix = tableName.replaceAll(/[^A-Za-z0-9_]/g, "_");
+    return [
+        `CREATE TABLE IF NOT EXISTS ${table} (
+      storage_key varchar(512) NOT NULL PRIMARY KEY,
+      namespace varchar(255) NOT NULL,
+      idempotency_key varchar(255) NOT NULL,
+      scope_key varchar(255) NOT NULL,
+      fingerprint varchar(255) NOT NULL,
+      status varchar(16) NOT NULL,
+      result_json longtext,
+      reserved_at varchar(32) NOT NULL,
+      completed_at varchar(32),
+      expires_at varchar(32),
+      updated_at varchar(32) NOT NULL,
+      INDEX ${quoteIdentifier(`${indexPrefix}_lookup_idx`, "`")} (namespace, scope_key, idempotency_key),
+      INDEX ${quoteIdentifier(`${indexPrefix}_expires_idx`, "`")} (expires_at)
+    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_bin`,
+    ];
+}
+/**
+ * Create a Beignet idempotency port backed by a Drizzle MySQL database.
+ *
+ * The port accepts both the root Drizzle database and transaction clients, so
+ * applications can expose root idempotency for ordinary retry-safe commands and
+ * transaction-scoped idempotency from Unit of Work.
+ */
+export function createDrizzleMysqlIdempotencyPort(db, adapterOptions = {}) {
+    const table = sql.raw(quoteIdentifier(adapterOptions.tableName ?? "idempotency_records", "`"));
+    const executor = createMysqlExecutor(db, table);
+    return createIdempotencyPortCore(executor, { now: adapterOptions.now }, DrizzleMysqlIdempotencyMutationError);
+}
+/**
+ * Configuration schema for the Drizzle MySQL provider.
+ * Validates environment variables with MYSQL_ prefix.
+ */
+export const MysqlConfigSchema = z.object({
+    /**
+     * MySQL connection URL.
+     * Example: "mysql://user:password@localhost:3306/app"
+     */
+    DB_URL: z
+        .string()
+        .min(1)
+        .refine((val) => val.startsWith("mysql://"), {
+        message: 'DB_URL must start with "mysql://" (e.g., "mysql://user:password@localhost:3306/app")',
+    }),
+});
+/**
+ * Create a Drizzle MySQL provider factory.
+ *
+ * This factory creates a service provider that:
+ * - Uses a mysql2/promise connection pool
+ * - Uses Drizzle ORM via drizzle-orm/mysql2
+ * - Exposes a typed DbPort<TSchema> on ports
+ * - Uses MYSQL_-prefixed env vars for connection config
+ *
+ * @template TSchema - The Drizzle schema type (inferred from the schema parameter)
+ * @param options - Configuration options including the schema
+ * @returns A service provider that can be used with createNextServer
+ *
+ * @example
+ * ```ts
+ * import * as schema from "@/db/schema";
+ * import { createDrizzleMysqlProvider } from "@beignet/provider-db-drizzle/mysql";
+ *
+ * export const drizzleMysqlProvider = createDrizzleMysqlProvider({ schema });
+ * ```
+ */
+export function createDrizzleMysqlProvider(options) {
+    const { schema, portName = "db", mode = "default" } = options;
+    return createProvider({
+        name: "drizzle-mysql",
+        config: {
+            schema: MysqlConfigSchema,
+            envPrefix: "MYSQL_",
+        },
+        async setup({ ports, config }) {
+            if (!config) {
+                throw new Error("[drizzleMysqlProvider] Missing config. Set MYSQL_DB_URL.");
+            }
+            // 1. Create mysql2 connection pool
+            const pool = mysql.createPool({
+                uri: config.DB_URL,
+                ...options.pool,
+            });
+            const instrumentation = createProviderInstrumentation(ports, {
+                providerName: "drizzle-mysql",
+                watcher: "db",
+            });
+            const logger = createDbQueryLogger(instrumentation, portName);
+            // 2. Create typed Drizzle instance (mode is required when a schema is
+            //    provided to drizzle-orm/mysql2)
+            const db = logger
+                ? drizzle(pool, { schema, logger, mode })
+                : drizzle(pool, { schema, mode });
+            // 3. Build a typed DbPort
+            const dbPort = { db, pool };
+            return {
+                ports: { [portName]: dbPort },
+                async stop() {
+                    // Gracefully close the database connection pool
+                    try {
+                        await dbPort.pool.end();
+                    }
+                    catch (error) {
+                        // Log error but don't throw - we're shutting down anyway
+                        console.error("[drizzleMysqlProvider] Error closing database connection:", error);
+                    }
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/mysql/index.js.map

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