@zintrust/db-mysql 0.1.27 → 0.1.41

package/dist/build-manifest.json

@@ -1,14 +1,14 @@
 {
   "name": "@zintrust/db-mysql",
-  "version": "0.1.15",
-  "buildDate": "2026-01-28T12:17:02.322Z",
+  "version": "0.1.27",
+  "buildDate": "2026-02-15T07:16:38.180Z",
   "buildEnvironment": {
     "node": "v20.20.0",
     "platform": "linux",
     "arch": "x64"
   },
   "git": {
-    "commit": "a274786",
+    "commit": "33b681d",
     "branch": "master"
   },
   "package": {
@@ -23,21 +23,29 @@
     ]
   },
   "files": {
+    "common.d.ts": {
+      "size": 615,
+      "sha256": "fafe13a87e5239d41b537dcdf23d7fc84c25d7b34207d272f149cbadfebfb417"
+    },
+    "common.js": {
+      "size": 580,
+      "sha256": "71e659214b8f208ec303756a4ed796f9904a5c2d5f6ba71ae03603be3773851c"
+    },
     "index.d.ts": {
-      "size": 1380,
-      "sha256": "0e9961f469b7a5a2ab8a2f33eaaa6220b8a9b382e6c552e2a7320399ed9de9f4"
+      "size": 1460,
+      "sha256": "e3fee6b22d26a931b8a8254267ad5621b1fcf26c606b7749190ee4ccfed24cd3"
     },
     "index.js": {
-      "size": 7548,
-      "sha256": "0e0c05629b71fe8bf6e271deaa58371da6b31948dc072b796903ab07ce09c416"
+      "size": 9907,
+      "sha256": "105cdfccd907351f427ee0539384ca640ba51015f46668be4edf6a1838eb5891"
     },
     "register.d.ts": {
       "size": 180,
       "sha256": "1ac7cca6cfbda8e5a65153917d4bbb4dd4fbe309dcabf9d9bdfb1eea6e97e52e"
     },
     "register.js": {
-      "size": 1063,
-      "sha256": "11fa6c4311766321ac9bd080ea6234756dd2fffcd767e5e69cea44bd9e8ea8fd"
+      "size": 1066,
+      "sha256": "776afb1a7728d8448454a5aee172ce123d81ccf0619cf0228578d55e10697b62"
     }
   }
 }

package/dist/common.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Common constants and utilities for MySQL adapters
+ */
+export declare const CREATE_MIGRATIONS_TABLE_SQL = "\nCREATE TABLE IF NOT EXISTS migrations (\n    id BIGINT PRIMARY KEY AUTO_INCREMENT,\n    name VARCHAR(255) NOT NULL,\n    scope VARCHAR(255) NOT NULL DEFAULT 'global',\n    service VARCHAR(255) NOT NULL DEFAULT '',\n    batch INTEGER NOT NULL,\n    status VARCHAR(255) NOT NULL,\n    applied_at DATETIME NULL,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    UNIQUE(name, scope, service)\n  )";
+export declare const MYSQL_PLACEHOLDER = "?";
+export declare const MYSQL_TYPE = "mysql";

package/dist/common.js

@@ -0,0 +1,17 @@
+/**
+ * Common constants and utilities for MySQL adapters
+ */
+export const CREATE_MIGRATIONS_TABLE_SQL = `
+CREATE TABLE IF NOT EXISTS migrations (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    name VARCHAR(255) NOT NULL,
+    scope VARCHAR(255) NOT NULL DEFAULT 'global',
+    service VARCHAR(255) NOT NULL DEFAULT '',
+    batch INTEGER NOT NULL,
+    status VARCHAR(255) NOT NULL,
+    applied_at DATETIME NULL,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(name, scope, service)
+  )`;
+export const MYSQL_PLACEHOLDER = '?';
+export const MYSQL_TYPE = 'mysql';

package/dist/index.d.ts

@@ -1,12 +1,15 @@
 export type DatabaseConfig = {
     driver: 'sqlite' | 'postgresql' | 'mysql' | 'sqlserver' | 'd1';
     database?: string;
+    connectionString?: string;
     host?: string;
     port?: number;
     username?: string;
     password?: string;
     synchronize?: boolean;
     logging?: boolean;
+    ssl?: boolean;
+    socketTimeoutMs?: number;
     readHosts?: string[];
 };
 export type QueryResult = {

package/dist/index.js

@@ -1,4 +1,9 @@
-import { ErrorFactory, FeatureFlags, Logger, QueryBuilder } from '@zintrust/core';
+import { Cloudflare, ErrorFactory, FeatureFlags, Logger, QueryBuilder } from '@zintrust/core';
+import { CREATE_MIGRATIONS_TABLE_SQL, MYSQL_PLACEHOLDER, MYSQL_TYPE } from './common.js';
+const getInjectedMysqlModule = () => {
+    const globalAny = globalThis;
+    return globalAny.__zintrustMysqlModule;
+};
 function isMissingEsmPackage(error, packageName) {
     if (error === null || typeof error !== 'object')
         return false;
@@ -13,9 +18,37 @@ function isMissingEsmPackage(error, packageName) {
     return false;
 }
 async function loadMysql() {
+    const injected = getInjectedMysqlModule();
+    if (injected)
+        return injected;
     return (await import('mysql2/promise'));
 }
+async function loadCloudflareSocketFactory() {
+    try {
+        const { CloudflareSocket } = await import('@zintrust/core');
+        return ({ host, port, tls, timeoutMs }) => CloudflareSocket.create(host, port, { tls, timeoutMs });
+    }
+    catch (error) {
+        throw ErrorFactory.createConfigError('Cloudflare Workers socket support requires cloudflare:sockets compatibility (set compatibility_date >= 2024-01-15).', error);
+    }
+}
 function getConnectionParams(config) {
+    if (config.connectionString !== undefined && config.connectionString.trim() !== '') {
+        try {
+            const url = new URL(config.connectionString);
+            const database = url.pathname.replace(/^\//, '') || 'mysql';
+            return {
+                host: url.hostname || 'localhost',
+                port: url.port ? Number.parseInt(url.port, 10) : 3306,
+                database,
+                user: decodeURIComponent(url.username || 'root'),
+                password: decodeURIComponent(url.password || ''),
+            };
+        }
+        catch (error) {
+            throw ErrorFactory.createConfigError('Invalid MySQL connection string', error);
+        }
+    }
     return {
         host: config.host ?? 'localhost',
         port: config.port ?? 3306,
@@ -62,20 +95,49 @@ async function connect(state, config) {
     try {
         const mysql = await loadMysql();
         const { host, port, database, user, password } = getConnectionParams(config);
-        state.pool = mysql.createPool({
-            host,
-            port,
-            database,
-            user,
-            password,
-            waitForConnections: true,
-            connectionLimit: 10,
-            namedPlaceholders: false,
-        });
+        const isWorkersRuntime = Cloudflare.getWorkersEnv() !== null;
+        const tlsEnabled = Boolean(config.ssl);
+        let timeoutMs;
+        if (typeof config.socketTimeoutMs === 'number' && config.socketTimeoutMs > 0) {
+            timeoutMs = config.socketTimeoutMs;
+        }
+        else {
+            timeoutMs = 30000; // default 30s
+        }
+        if (isWorkersRuntime) {
+            if (!Cloudflare.isCloudflareSocketsEnabled()) {
+                throw ErrorFactory.createConfigError('Cloudflare sockets are disabled. Set ENABLE_CLOUDFLARE_SOCKETS=true to use MySQL sockets on Workers.');
+            }
+            const createSocket = await loadCloudflareSocketFactory();
+            state.pool = mysql.createPool({
+                host,
+                port,
+                database,
+                user,
+                password,
+                waitForConnections: true,
+                connectionLimit: 10,
+                namedPlaceholders: false,
+                disableEval: true,
+                stream: () => createSocket({ host, port, tls: tlsEnabled, timeoutMs }),
+            });
+        }
+        else {
+            state.pool = mysql.createPool({
+                host,
+                port,
+                database,
+                user,
+                password,
+                waitForConnections: true,
+                connectionLimit: 10,
+                namedPlaceholders: false,
+            });
+        }
         // Probe.
         await state.pool.execute('SELECT 1');
         state.connected = true;
-        Logger.info(`✓ MySQL connected (${host}:${port})`);
+        Logger.info(`✓ Cloudflare sockets MySQL connected (${host}:${port})`);
     }
     catch (error) {
         if (isMissingEsmPackage(error, 'mysql2')) {
@@ -114,6 +176,28 @@ async function rawQuery(state, sql, parameters) {
         throw ErrorFactory.createTryCatchError(`Raw SQL query failed: ${sql}`, error);
     }
 }
+const createTransactionAdapter = (baseAdapter, conn) => {
+    return {
+        ...baseAdapter,
+        query: async (sql, parameters) => {
+            try {
+                const connection = conn;
+                const [rows] = await connection.execute(sql, parameters);
+                return normalizeQueryResult(rows);
+            }
+            catch (error) {
+                throw ErrorFactory.createTryCatchError(`MySQL query failed: ${sql}`, error);
+            }
+        },
+        queryOne: async (sql, parameters) => {
+            const res = await baseAdapter.query(sql, parameters);
+            return res.rows[0] ?? null;
+        },
+    };
+};
+const createMigrationsTable = async (adapter) => {
+    await adapter.query(CREATE_MIGRATIONS_TABLE_SQL, []);
+};
 function createMySqlAdapter(config) {
     const state = { connected: false };
     const adapter = {
@@ -139,22 +223,7 @@ function createMySqlAdapter(config) {
         transaction: async (callback) => {
             const pool = ensurePool(state);
             const conn = await pool.getConnection();
-            const txAdapter = {
-                ...adapter,
-                query: async (sql, parameters) => {
-                    try {
-                        const [rows] = await conn.execute(sql, parameters);
-                        return normalizeQueryResult(rows);
-                    }
-                    catch (error) {
-                        throw ErrorFactory.createTryCatchError(`MySQL query failed: ${sql}`, error);
-                    }
-                },
-                queryOne: async (sql, parameters) => {
-                    const res = await txAdapter.query(sql, parameters);
-                    return res.rows[0] ?? null;
-                },
-            };
+            const txAdapter = createTransactionAdapter(adapter, conn);
             try {
                 await conn.beginTransaction();
                 const result = await callback(txAdapter);
@@ -175,22 +244,12 @@ function createMySqlAdapter(config) {
             }
         },
         ensureMigrationsTable: async () => {
-            await adapter.query(`CREATE TABLE IF NOT EXISTS migrations (
-            id BIGINT PRIMARY KEY AUTO_INCREMENT,
-            name VARCHAR(255) NOT NULL,
-            scope VARCHAR(255) NOT NULL DEFAULT 'global',
-            service VARCHAR(255) NOT NULL DEFAULT '',
-            batch INTEGER NOT NULL,
-            status VARCHAR(255) NOT NULL,
-            applied_at DATETIME NULL,
-            created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-            UNIQUE(name, scope, service)
-          )`, []);
+            await createMigrationsTable(adapter);
         },
-        getType: () => 'mysql',
+        getType: () => MYSQL_TYPE,
         isConnected: () => state.connected,
         rawQuery: async (sql, parameters) => rawQuery(state, sql, parameters),
-        getPlaceholder: (_index) => '?',
+        getPlaceholder: (_index) => MYSQL_PLACEHOLDER,
     };
     return adapter;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/db-mysql",
-  "version": "0.1.27",
+  "version": "0.1.41",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.1.27"
+    "@zintrust/core": "^0.1.41"
   },
   "publishConfig": {
     "access": "public"