@eliware/elera-lib 0.1.1 → 0.1.2

package/README.md

@@ -2,7 +2,7 @@
 
 The alternative SQL client for Eliware applications. It provides generic
 primary/balanced MySQL or MariaDB routing without embedding Elera, HAProxy,
-backup, or GitOps policy. It is a v0.1.1 alternative to `@eliware/mysql`; the
+backup, or GitOps policy. It is a v0.1.2 alternative to `@eliware/mysql`; the
 existing package is intentionally unchanged.
 
 `primary` is the preferred connection path. `balanced` is an optional alternate

package/RELEASE_NOTES.md

@@ -1,8 +1,27 @@
 # Release notes
 
+## 0.1.2 — Unix-socket connection correction
+
+This patch corrects the mysql2 option used for local MariaDB Unix-domain
+socket connections.
+
+### Fixed
+
+- Maps `MYSQL_SOCKET` to mysql2's `socketPath` option so local socket
+  connections reach the configured MariaDB socket instead of falling back to
+  TCP.
+- Removes the obsolete `socket` option from node-pool driver options.
+
+### Validation
+
+- Adds regression coverage for socket-path mapping and option cleanup.
+- Maintains 100% statements, branches, functions, and lines coverage with
+  zero lint warnings.
+- Contract and syntax checks pass.
+
 ## 0.1.1 — Runtime integration readiness
 
-This unreleased patch prepares the generic client for supervisor control-plane
+This patch prepares the generic client for supervisor control-plane
 connections and application-side routing changes. It does not add supervisor,
 CLI, Galera, backup, or GitOps policy to the library.
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@eliware/elera-lib",
-    "version": "0.1.1",
+    "version": "0.1.2",
     "description": "Generic MySQL and MariaDB client with primary, balanced, and resilient routing",
     "keywords": [
         "eliware",

package/src/client/environment.mjs

@@ -1,7 +1,7 @@
 import { createDb } from './create-db.mjs';
 
 export async function createDbFromEnvironment({ env = process.env, ...options } = {}) {
-  const primary = { host: env.MYSQL_PRIMARY_HOST ?? env.MYSQL_HOST ?? 'localhost', port: env.MYSQL_PRIMARY_PORT ?? env.MYSQL_PORT, user: env.MYSQL_USER, password: env.MYSQL_PASSWORD, database: env.MYSQL_DATABASE, options: { socket: env.MYSQL_SOCKET, connectTimeout: env.MYSQL_CONNECT_TIMEOUT, acquireTimeout: env.MYSQL_ACQUIRE_TIMEOUT, connectionLimit: env.MYSQL_CONNECTION_LIMIT, queueLimit: env.MYSQL_QUEUE_LIMIT, ssl: env.MYSQL_SSL } };
+  const primary = { host: env.MYSQL_PRIMARY_HOST ?? env.MYSQL_HOST ?? 'localhost', port: env.MYSQL_PRIMARY_PORT ?? env.MYSQL_PORT, user: env.MYSQL_USER, password: env.MYSQL_PASSWORD, database: env.MYSQL_DATABASE, options: { socketPath: env.MYSQL_SOCKET, connectTimeout: env.MYSQL_CONNECT_TIMEOUT, acquireTimeout: env.MYSQL_ACQUIRE_TIMEOUT, connectionLimit: env.MYSQL_CONNECTION_LIMIT, queueLimit: env.MYSQL_QUEUE_LIMIT, ssl: env.MYSQL_SSL } };
   const balanced = env.MYSQL_BALANCED_PORT ? { host: env.MYSQL_BALANCED_HOST ?? primary.host, port: env.MYSQL_BALANCED_PORT } : undefined;
   return createDb({ ...options, primary, balanced });
 }

package/src/pools/node-pool.mjs

@@ -2,7 +2,7 @@ import { asSqlError } from '../errors.mjs';
 const connectionFailure = (error) => asSqlError(error).retryable;
 export function createNodePool({ profile, mysqlLib, log, now = () => Date.now(), quarantineMs = 5000 }) {
   const { acquireTimeout: _acquireTimeout, ...driverOptions } = profile.options ?? {};
-  if (driverOptions.socket === undefined) delete driverOptions.socket;
+  if (driverOptions.socketPath === undefined) delete driverOptions.socketPath;
   const pool = mysqlLib.createPool({ host: profile.host, port: profile.port, user: profile.user, password: profile.password, database: profile.database, waitForConnections: true, ...driverOptions });
   const sessionStatements = profile.options?.sessionStatements ?? [];
   const withConnection = async (operation, sql, values) => { const connection = await pool.getConnection(); try { for (const statement of sessionStatements) await connection.query(statement); return operation(connection, sql, values); } finally { connection.release(); } };