@holo-js/db-mysql 0.3.28 → 0.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Holo-JS 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/.holo-build-fingerprint

@@ -0,0 +1 @@
+de31065d1e429a5a696c9248de1565c4929497bd2c459886080a858ebc43c67e

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { DriverAdapter, DriverExecutionResult, DriverQueryResult } from '@holo-j
 
 interface MySQLQueryableLike {
     query(sql: string, bindings?: readonly unknown[]): Promise<readonly [unknown, unknown]>;
+    execute?(sql: string, bindings?: readonly unknown[]): Promise<readonly [unknown, unknown]>;
 }
 interface MySQLClientLike extends MySQLQueryableLike {
     release?(): void;
@@ -50,4 +51,5 @@ declare class MySQLAdapter<TConfig extends PoolOptions = PoolOptions> implements
 declare function createMySQLAdapter<TConfig extends PoolOptions = PoolOptions>(options?: MySQLAdapterOptions<TConfig>): MySQLAdapter<TConfig>;
 declare const mysqlDatabaseDriverFactory: DatabaseDriverFactory;
 
-export { MySQLAdapter, type MySQLAdapterOptions, type MySQLClientLike, type MySQLPoolLike, type MySQLQueryableLike, createMySQLAdapter, mysqlDatabaseDriverFactory };
+export { MySQLAdapter, createMySQLAdapter, mysqlDatabaseDriverFactory };
+export type { MySQLAdapterOptions, MySQLClientLike, MySQLPoolLike, MySQLQueryableLike };

package/dist/index.mjs

@@ -1,10 +1,45 @@
 // src/index.ts
 import { holoRuntimeInternals } from "@holo-js/db";
 import mysql from "mysql2/promise";
+var { formatWallClock, parseCalendarDate, parseWallClockTimestamp } = holoRuntimeInternals;
 var TransactionError = class extends Error {
 };
-function toMutableBindings(bindings = []) {
-  return [...bindings];
+var ZERO_DATE_PART = /-00(?:-|\s|$)/;
+function toDriverBinding(value, timeZone) {
+  if (!(value instanceof Date)) return value;
+  return Number.isNaN(value.getTime()) ? null : formatWallClock(value, timeZone);
+}
+function toDriverBindings(bindings) {
+  const timeZone = holoRuntimeInternals.getApplicationTimezone();
+  return bindings.map((value) => toDriverBinding(value, timeZone));
+}
+var DATE_TYPE_NAMES = ["date", "datetime", "timestamp"];
+var rawTypeCast = (field) => field.buffer();
+function dateStringTypes(config) {
+  const uriOption = typeof config.uri === "string" ? new URL(config.uri).searchParams.get("dateStrings") : null;
+  const option = config.dateStrings ?? (uriOption === "true" ? true : uriOption === "false" || uriOption === null ? void 0 : uriOption);
+  if (option === true || config.typeCast === false) return new Set(DATE_TYPE_NAMES);
+  if (typeof option === "string") return /* @__PURE__ */ new Set([option.toLowerCase()]);
+  if (Array.isArray(option)) return new Set(option.map((type) => String(type).toLowerCase()));
+  return /* @__PURE__ */ new Set();
+}
+function applicationTypeCast(config) {
+  const fallback = typeof config.typeCast === "function" ? config.typeCast : config.typeCast === false ? rawTypeCast : void 0;
+  const stringTypes = dateStringTypes(config);
+  return (field, next) => {
+    if (field.type !== "DATE" && field.type !== "DATETIME" && field.type !== "TIMESTAMP") {
+      return fallback ? fallback(field, next) : next();
+    }
+    const value = field.string();
+    if (value === null) return null;
+    if (stringTypes.has(field.type.toLowerCase()) || ZERO_DATE_PART.test(value)) return value;
+    const timeZone = holoRuntimeInternals.getApplicationTimezone();
+    if (field.type === "DATE") return parseCalendarDate(value, timeZone) ?? value;
+    return parseWallClockTimestamp(value, timeZone, "earlier") ?? value;
+  };
+}
+function sessionTimeZone(timeZone) {
+  return timeZone === "UTC" ? "+00:00" : timeZone;
 }
 function quoteDatabaseIdentifier(database) {
   return `\`${database.replaceAll("`", "``")}\``;
@@ -41,11 +76,23 @@ function resolveBootstrapTarget(config) {
   }
   return void 0;
 }
+async function runStatement(queryable, sql, bindings) {
+  if (bindings.length === 0) {
+    return queryable.query(sql);
+  }
+  if (!queryable.execute) {
+    throw new Error("The MySQL driver must support prepared statements (execute) to run statements with bindings.");
+  }
+  return queryable.execute(sql, bindings.map((value) => value === void 0 ? null : value));
+}
 function wrapMySQLClient(client) {
   const rawClient = client;
   return {
     async query(sql, bindings = []) {
-      return rawClient.query(sql, toMutableBindings(bindings));
+      return bindings.length === 0 ? rawClient.query(sql) : rawClient.query(sql, toDriverBindings(bindings));
+    },
+    async execute(sql, bindings = []) {
+      return rawClient.execute(sql, toDriverBindings(bindings));
     },
     release: rawClient.release?.bind(rawClient),
     end: rawClient.end?.bind(rawClient)
@@ -55,7 +102,10 @@ function wrapMySQLPool(pool) {
   const rawPool = pool;
   return {
     async query(sql, bindings = []) {
-      return rawPool.query(sql, toMutableBindings(bindings));
+      return bindings.length === 0 ? rawPool.query(sql) : rawPool.query(sql, toDriverBindings(bindings));
+    },
+    async execute(sql, bindings = []) {
+      return rawPool.execute(sql, toDriverBindings(bindings));
     },
     async getConnection() {
       return wrapMySQLClient(await rawPool.getConnection());
@@ -63,13 +113,21 @@ function wrapMySQLPool(pool) {
     end: rawPool.end.bind(rawPool)
   };
 }
+var DEFAULT_MAX_PREPARED_STATEMENTS = 256;
 function createNativeMySQLPool(config) {
-  const pool = mysql.createPool({ ...config, timezone: config.timezone ?? "Z" });
-  if (!config.timezone || config.timezone === "Z") {
-    pool.pool.on("connection", (connection) => {
-      connection.query("SET time_zone = '+00:00'");
+  const pool = mysql.createPool({
+    maxPreparedStatements: DEFAULT_MAX_PREPARED_STATEMENTS,
+    ...config,
+    timezone: config.timezone ?? "Z",
+    typeCast: applicationTypeCast(config)
+  });
+  pool.pool.on("connection", (connection) => {
+    connection.query("SET time_zone = ?", [sessionTimeZone(holoRuntimeInternals.getApplicationTimezone())], (error) => {
+      if (!error) return;
+      holoRuntimeInternals.reportError(error, { capability: "db", operation: "mysql.sessionTimeZone" });
+      connection.destroy();
     });
-  }
+  });
   return wrapMySQLPool(pool);
 }
 function isMySQLDatabaseMissing(error) {
@@ -85,7 +143,7 @@ var MySQLAdapter = class {
   transactionClients;
   constructor(options = {}) {
     this.supportsConcurrentTransactionScopes = !options.client;
-    this.directClient = options.client ? wrapMySQLClient(options.client) : void 0;
+    this.directClient = options.client;
     this.pool = options.pool;
     this.createPoolInstance = options.createPool ?? (options.client || options.pool ? void 0 : createNativeMySQLPool);
     this.config = options.config ?? (options.uri ? { uri: options.uri } : {});
@@ -138,7 +196,7 @@ var MySQLAdapter = class {
   }
   async query(sql, bindings = []) {
     const queryable = await this.getQueryable();
-    const [rows] = await queryable.query(sql, bindings);
+    const [rows] = await runStatement(queryable, sql, bindings);
     const normalized = rows;
     return {
       rows: Array.isArray(normalized) ? [...normalized] : [],
@@ -150,7 +208,7 @@ var MySQLAdapter = class {
   }
   async execute(sql, bindings = []) {
     const queryable = await this.getQueryable();
-    const [result] = await queryable.query(sql, bindings);
+    const [result] = await runStatement(queryable, sql, bindings);
     const execution = result;
     return {
       affectedRows: typeof execution.affectedRows === "number" ? execution.affectedRows : 0,
@@ -204,10 +262,7 @@ var MySQLAdapter = class {
     }
     const bootstrapPool = this.createPoolInstance(target.config);
     try {
-      const [existing] = await bootstrapPool.query(
-        "SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?",
-        [target.database]
-      );
+      const [existing] = await runStatement(bootstrapPool, "SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?", [target.database]);
       if (Array.isArray(existing) && existing.length === 0) {
         await bootstrapPool.query(`CREATE DATABASE ${quoteDatabaseIdentifier(target.database)}`, []);
       }
@@ -235,13 +290,16 @@ var mysqlDatabaseDriverFactory = Object.freeze({
   driver: "mysql",
   supportsConcurrentTransactionScopes: true,
   create(connection) {
-    return connection.url ? createMySQLAdapter({ uri: connection.url }) : createMySQLAdapter({ config: {
+    const ssl = connection.ssl === true ? {} : connection.ssl || void 0;
+    const urlSetsSsl = connection.url ? new URL(connection.url).searchParams.has("ssl") : false;
+    const sslOptions = ssl && !urlSetsSsl ? { ssl } : {};
+    return connection.url ? createMySQLAdapter({ config: { uri: connection.url, ...sslOptions } }) : createMySQLAdapter({ config: {
       host: connection.host,
       port: connection.port,
       user: connection.username,
       password: connection.password,
       database: connection.database,
-      ssl: connection.ssl === true ? {} : connection.ssl || void 0
+      ...sslOptions
     } });
   }
 });

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@holo-js/db-mysql",
-  "version": "0.3.28",
+  "version": "0.4.1",
   "description": "Holo-JS Framework - MySQL database adapter",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cobraprojects/holo-js.git",
+    "directory": "packages/db-mysql"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -14,7 +19,8 @@
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsup",
@@ -24,18 +30,18 @@
     "test:integration": "HOLO_MYSQL_INTEGRATION=1 vitest --run tests/mysql.test.ts"
   },
   "peerDependencies": {
-    "@holo-js/db": "^0.3.28"
+    "@holo-js/db": "^0.4.1"
   },
   "dependencies": {
-    "mysql2": "^3.17.1"
+    "mysql2": "^3.24.6"
   },
   "devDependencies": {
-    "@holo-js/db": "^0.3.28",
-    "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
-    "vitest": "^4.1.5"
+    "@holo-js/db": "^0.4.1",
+    "tsup": "^9.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.5"
   },
   "engines": {
-    "node": "^22.12.0 || ^24.0.0 || ^26.0.0"
+    "node": "^22.18.0 || ^24.0.0 || ^26.0.0"
   }
 }