@compforge/harness-toolbox 0.3.8 → 0.3.9

package/dist/{chunk-qqntng20.js → chunk-ahc00qs5.js}

@@ -9,6 +9,9 @@ import {
   queryMysqlViaPod,
   queryMysqlViaPodBatch
 } from "./chunk-m91t44jh.js";
+import {
+  ToolboxError
+} from "./chunk-zhkrydeg.js";
 import {
   ConcurrencyPool
 } from "./chunk-v3hxvnrc.js";
@@ -18,6 +21,16 @@ import {
 
 // src/mysql/client.ts
 import { createConnection } from "mysql2/promise";
+function mysqlOperationError(error, phase) {
+  if (!error || typeof error !== "object" || !("code" in error) || error.code !== "PROTOCOL_CONNECTION_LOST")
+    return error;
+  return new ToolboxError(`MySQL ${phase} failed: connection lost (PROTOCOL_CONNECTION_LOST)`, {
+    kind: "connection_lost",
+    code: error.code,
+    cause: error
+  });
+}
+
 class MysqlDatabase {
   transports;
   options;
@@ -56,6 +69,8 @@ class MysqlDatabase {
         throw new Error("Bounded readonly MySQL queries require a native TCP transport");
       try {
         return await queryReadonlySession(session.connection, sql, values, limits, this.options.signal);
+      } catch (error) {
+        throw mysqlOperationError(error, "query");
       } finally {
         destroyMysqlConnection(session.connection);
       }
@@ -94,7 +109,7 @@ class MysqlDatabase {
         this.#connections.delete(key);
       if (session?.kind === "tcp")
         destroyMysqlConnection(session.connection);
-      throw error;
+      throw session ? mysqlOperationError(error, "query") : error;
     }
   }
   async#query(target, sql, values) {
@@ -130,9 +145,11 @@ class MysqlDatabase {
         this.options.onRoute?.({ transport: endpoint.host === target.host && endpoint.port === target.port ? "direct" : transport.name, reason });
         return { kind: "tcp", connection };
       } catch (error) {
-        if (!isConnectionNetworkError(error) || i === this.transports.length - 1)
-          throw error;
-        reason = String(error.code);
+        const failure = mysqlOperationError(error, "connect");
+        const connectionLost = failure instanceof ToolboxError && failure.kind === "connection_lost";
+        if (!isConnectionNetworkError(failure) && !connectionLost || i === this.transports.length - 1)
+          throw failure;
+        reason = String(failure.code);
       }
     }
     throw new Error("MySQL DataSource has no transport");

package/dist/mysql/client.d.ts

@@ -8,7 +8,11 @@ export interface MysqlDatabaseOptions extends ClientLifecycle {
     queryTimeoutMs: number;
 }
 type ConnectionFactory = (options: ConnectionOptions) => Promise<Connection>;
-/** SQL is executed once; only native connection establishment may advance to another transport. */
+/**
+ * @spec SQL is executed once; only native connection establishment may advance to another transport.
+ * @why mysql2 reports a socket closed during handshake as PROTOCOL_CONNECTION_LOST, before any SQL is sent.
+ * @case id=mysql_handshake_closed,desc=`Peer closes during handshake`,expect=`Try the next transport`,forbid=`Replay an interrupted query`
+ */
 export declare class MysqlDatabase implements Database {
     #private;
     private readonly transports;

package/dist/mysql/client.js

@@ -2,10 +2,11 @@ import {
   MysqlClient,
   MysqlDatabase,
   openMysql
-} from "../chunk-qqntng20.js";
+} from "../chunk-ahc00qs5.js";
 import"../chunk-age65q4n.js";
 import"../chunk-136egyff.js";
 import"../chunk-m91t44jh.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
 import"../chunk-wv4jwhvj.js";

package/dist/mysql/index.js

@@ -14,10 +14,11 @@ import {
   MysqlClient,
   MysqlDatabase,
   openMysql
-} from "../chunk-qqntng20.js";
+} from "../chunk-ahc00qs5.js";
 import"../chunk-age65q4n.js";
 import"../chunk-136egyff.js";
 import"../chunk-m91t44jh.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
 import"../chunk-wv4jwhvj.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-toolbox",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Shared infrastructure clients, transports and bounded data capture",
   "type": "module",
   "scripts": {