@wild-framework/database-mysql 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/ddl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate `CREATE TABLE IF NOT EXISTS` statements from a Drizzle schema
+ * object for MySQL.
+ *
+ * Auto-incrementing ids use `AUTO_INCREMENT` (from Drizzle's
+ * `.autoincrement()`); identifiers are backtick-quoted.
+ */
+export declare function generateMysqlDdl(schema: Record<string, unknown>): string[];
+//# sourceMappingURL=ddl.d.ts.map

package/dist/ddl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../src/ddl.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAwB1E"}

package/dist/ddl.js

@@ -0,0 +1,61 @@
+import { getTableConfig } from "drizzle-orm/mysql-core";
+/**
+ * Generate `CREATE TABLE IF NOT EXISTS` statements from a Drizzle schema
+ * object for MySQL.
+ *
+ * Auto-incrementing ids use `AUTO_INCREMENT` (from Drizzle's
+ * `.autoincrement()`); identifiers are backtick-quoted.
+ */
+export function generateMysqlDdl(schema) {
+    const statements = [];
+    for (const table of Object.values(schema)) {
+        if (!table || typeof table !== "object")
+            continue;
+        let config;
+        try {
+            config = getTableConfig(table);
+        }
+        catch {
+            continue; // not a table (view, relation, …)
+        }
+        const columns = config.columns;
+        if (columns.length === 0)
+            continue;
+        const lines = columns.map((column) => `  ${columnSql(column)}`);
+        statements.push(`CREATE TABLE IF NOT EXISTS \`${config.name}\` (\n${lines.join(",\n")}\n);`);
+    }
+    return statements;
+}
+/** Render a single column definition for MySQL. */
+function columnSql(column) {
+    const parts = [`\`${column.name}\``, column.getSQLType?.() ?? "text"];
+    if (column.autoIncrement)
+        parts.push("AUTO_INCREMENT");
+    if (column.primary)
+        parts.push("PRIMARY KEY");
+    if (column.notNull)
+        parts.push("NOT NULL");
+    if (column.isUnique)
+        parts.push("UNIQUE");
+    const def = literalDefault(column);
+    if (def !== undefined)
+        parts.push(`DEFAULT ${def}`);
+    return parts.join(" ");
+}
+/** Render a literal default; function/SQL-expression defaults are left out. */
+function literalDefault(column) {
+    if (!column.hasDefault)
+        return undefined;
+    const value = column.default;
+    if (value === null)
+        return "NULL";
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "boolean")
+        return value ? "1" : "0";
+    if (typeof value === "string")
+        return `'${value.replace(/'/g, "''")}'`;
+    // Non-literal (SQL expression, function, …) — leave to migrations.
+    return undefined;
+}
+//# sourceMappingURL=ddl.js.map

package/dist/ddl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.js","sourceRoot":"","sources":["../src/ddl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmBxD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC5D,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAElD,IAAI,MAA+C,CAAC;QACpD,IAAI,CAAC;YACD,MAAM,GAAG,cAAc,CAAC,KAA6C,CAGpE,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,SAAS,CAAC,kCAAkC;QAChD,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChE,UAAU,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,IAAI,SAAS,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjG,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,mDAAmD;AACnD,SAAS,SAAS,CAAC,MAAkB;IACjC,MAAM,KAAK,GAAa,CAAC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,MAAM,CAAC,CAAC;IAEhF,IAAI,MAAM,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IAEpD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,SAAS,cAAc,CAAC,MAAkB;IACtC,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAEvE,mEAAmE;IACnE,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/driver.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseDriver, SqlExecutor, Row } from "@wild-framework/database";
+import { type MySql2Database } from "drizzle-orm/mysql2";
+import mysql from "mysql2/promise";
+/**
+ * Configuration for the MySQL driver.
+ */
+export interface MysqlConfig<TSchema extends Record<string, unknown>> {
+    /** MySQL connection URI (e.g. `mysql://user:pass@host:3306/db`). */
+    uri?: string;
+    /** A pre-built pool — for advanced use or tests. */
+    pool?: mysql.Pool;
+    /** Optional Drizzle schema object (tables). */
+    schema?: TSchema;
+    /**
+     * Create tables from the schema at connect time (dev-friendly).
+     * Set false to rely on migrations.
+     * Defaults to true.
+     */
+    autoCreate?: boolean;
+}
+/**
+ * MySQL driver implementing `DatabaseDriver` and `SqlExecutor`.
+ *
+ * Backed by `mysql2` + Drizzle (`drizzle-orm/mysql2`). The `db` getter
+ * returns the typed Drizzle instance for ORM queries; `exec`/`all` expose
+ * raw SQL for migrations.
+ */
+export declare class MysqlDriver<TSchema extends Record<string, unknown>> implements DatabaseDriver, SqlExecutor {
+    private config;
+    private pool;
+    private drizzleDb;
+    private connected;
+    constructor(config: MysqlConfig<TSchema>);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    /** Run one or more `;`-separated SQL statements. */
+    exec(sql: string): Promise<void>;
+    /** Run a query and return its rows. */
+    all<T = Row>(sql: string): Promise<T[]>;
+    private requirePool;
+    /**
+     * The typed Drizzle instance for queries.
+     *
+     * Throws if the driver is not connected.
+     */
+    get db(): MySql2Database<TSchema>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAGnC;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC5D,YAAW,cAAc,EAAE,WAAW;IAM1B,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,SAAS,CAAS;gBAEN,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;IAE1C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,WAAW,IAAI,OAAO;IAQtB,oDAAoD;IAC9C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,uCAAuC;IACjC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAK7C,OAAO,CAAC,WAAW;IAOnB;;;;OAIG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC,OAAO,CAAC,CAKhC;CACJ"}

package/dist/driver.js

@@ -0,0 +1,78 @@
+import { splitSqlStatements } from "@wild-framework/database";
+import { drizzle } from "drizzle-orm/mysql2";
+import mysql from "mysql2/promise";
+import { generateMysqlDdl } from "./ddl.js";
+/**
+ * MySQL driver implementing `DatabaseDriver` and `SqlExecutor`.
+ *
+ * Backed by `mysql2` + Drizzle (`drizzle-orm/mysql2`). The `db` getter
+ * returns the typed Drizzle instance for ORM queries; `exec`/`all` expose
+ * raw SQL for migrations.
+ */
+export class MysqlDriver {
+    config;
+    pool = null;
+    drizzleDb = null;
+    connected = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        if (!this.config.pool && !this.config.uri) {
+            throw new Error("MysqlDriver: provide a `uri` (or an injected `pool`) to connect.");
+        }
+        this.pool = this.config.pool ?? mysql.createPool(this.config.uri);
+        this.drizzleDb = drizzle(this.pool, { schema: this.config.schema, mode: "default" });
+        if (this.config.autoCreate !== false && this.config.schema) {
+            for (const statement of generateMysqlDdl(this.config.schema)) {
+                await this.exec(statement);
+            }
+        }
+        this.connected = true;
+    }
+    async close() {
+        // Only end pools we created — an injected pool is the caller's.
+        if (this.pool && !this.config.pool) {
+            await this.pool.end();
+        }
+        this.pool = null;
+        this.drizzleDb = null;
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    // -------------------------------------------------------------------
+    // SqlExecutor — raw SQL for migrations and ad-hoc statements
+    // -------------------------------------------------------------------
+    /** Run one or more `;`-separated SQL statements. */
+    async exec(sql) {
+        const pool = this.requirePool();
+        for (const statement of splitSqlStatements(sql)) {
+            await pool.query(statement);
+        }
+    }
+    /** Run a query and return its rows. */
+    async all(sql) {
+        const [rows] = await this.requirePool().query(sql);
+        return rows;
+    }
+    requirePool() {
+        if (!this.pool) {
+            throw new Error("Database is not connected. Call connect() first.");
+        }
+        return this.pool;
+    }
+    /**
+     * The typed Drizzle instance for queries.
+     *
+     * Throws if the driver is not connected.
+     */
+    get db() {
+        if (!this.drizzleDb) {
+            throw new Error("Database is not connected. Call connect() first.");
+        }
+        return this.drizzleDb;
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { MysqlDriver } from "./driver.js";
+export type { MysqlConfig } from "./driver.js";
+export { MysqlProvider } from "./provider.js";
+export { generateMysqlDdl } from "./ddl.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { MysqlDriver } from "./driver.js";
+export { MysqlProvider } from "./provider.js";
+export { generateMysqlDdl } from "./ddl.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,30 @@
+import type { Provider, Application } from "@wild-framework/core";
+import { type Migration } from "@wild-framework/database";
+/**
+ * Registers a MySQL-backed database with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * MysqlProvider.uri = process.env.DATABASE_URL!;
+ * MysqlProvider.schema = { users };
+ * MysqlProvider.migrations = loadMigrations("./migrations");
+ * ```
+ *
+ * Connects on boot, creates tables from the schema, applies pending
+ * migrations, and closes on shutdown.
+ */
+export declare class MysqlProvider implements Provider {
+    /** MySQL connection URI. */
+    static uri: string | undefined;
+    /** Drizzle schema object (tables). */
+    static schema: Record<string, unknown> | undefined;
+    /** Create tables from the schema at boot. Defaults to true. */
+    static autoCreate: boolean;
+    /** Migrations to apply (in order) after connecting. */
+    static migrations: Migration[];
+    register(app: Application): void;
+    boot(app: Application): Promise<void>;
+    shutdown(app: Application): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrF;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,sCAAsC;IACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,+DAA+D;IAC/D,MAAM,CAAC,UAAU,UAAQ;IACzB,uDAAuD;IACvD,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,CAAM;IAEpC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAa1B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAarC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD"}

package/dist/provider.js

@@ -0,0 +1,53 @@
+import { Container } from "@wild-framework/container";
+import { Database, MigrationRunner } from "@wild-framework/database";
+import { MysqlDriver } from "./driver.js";
+/**
+ * Registers a MySQL-backed database with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * MysqlProvider.uri = process.env.DATABASE_URL!;
+ * MysqlProvider.schema = { users };
+ * MysqlProvider.migrations = loadMigrations("./migrations");
+ * ```
+ *
+ * Connects on boot, creates tables from the schema, applies pending
+ * migrations, and closes on shutdown.
+ */
+export class MysqlProvider {
+    /** MySQL connection URI. */
+    static uri;
+    /** Drizzle schema object (tables). */
+    static schema;
+    /** Create tables from the schema at boot. Defaults to true. */
+    static autoCreate = true;
+    /** Migrations to apply (in order) after connecting. */
+    static migrations = [];
+    register(app) {
+        const container = app.resolve(Container);
+        const driver = new MysqlDriver({
+            uri: MysqlProvider.uri,
+            schema: MysqlProvider.schema,
+            autoCreate: MysqlProvider.autoCreate,
+        });
+        const database = new Database(driver);
+        container.singleton(Database, () => database);
+    }
+    async boot(app) {
+        const database = app.resolve(Database);
+        await database.connect();
+        if (MysqlProvider.migrations.length > 0) {
+            const driver = database.driver;
+            const applied = await new MigrationRunner(driver).migrate(MysqlProvider.migrations);
+            if (applied.length > 0) {
+                console.log(`[mysql] applied ${applied.length} migration(s): ${applied.join(", ")}`);
+            }
+        }
+    }
+    async shutdown(app) {
+        const database = app.resolve(Database);
+        await database.close();
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAkB,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IACtB,4BAA4B;IAC5B,MAAM,CAAC,GAAG,CAAqB;IAC/B,sCAAsC;IACtC,MAAM,CAAC,MAAM,CAAsC;IACnD,+DAA+D;IAC/D,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,MAAM,CAAC,UAAU,GAAgB,EAAE,CAAC;IAEpC,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;YAC3B,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,UAAU,EAAE,aAAa,CAAC,UAAU;SACvC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEtC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAgB;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAW,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEzB,IAAI,aAAa,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAA8C,CAAC;YACvE,MAAM,OAAO,GAAG,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACpF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,MAAM,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzF,CAAC;QACL,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAgB;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAW,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@wild-framework/database-mysql",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "MySQL driver for Wild Framework's database package (Drizzle + mysql2).",
+  "keywords": [
+    "wild",
+    "framework",
+    "drizzle",
+    "mysql",
+    "mysql2"
+  ],
+  "dependencies": {
+    "drizzle-orm": "^0.38.0",
+    "mysql2": "^3.11.0",
+    "@wild-framework/core": "0.2.0",
+    "@wild-framework/container": "0.2.0",
+    "@wild-framework/database": "0.2.0"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.