@compforge/harness-toolbox 0.3.6 → 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/{chunk-2m0mh09h.js → chunk-fhtbvj0s.js}

@@ -2,7 +2,7 @@ import {
   KubernetesError,
   ToolboxError,
   kubernetesHttpError
-} from "./chunk-ntfm5e85.js";
+} from "./chunk-zhkrydeg.js";
 import {
   ConcurrencyPool
 } from "./chunk-v3hxvnrc.js";

package/dist/{chunk-y3dx8jh6.js → chunk-p6k59m3q.js}

@@ -1,6 +1,6 @@
 import {
   KubernetesError
-} from "./chunk-ntfm5e85.js";
+} from "./chunk-zhkrydeg.js";
 
 // src/kubernetes/workload.ts
 function failure(message, kind) {

package/dist/{chunk-1e3arqz3.js → chunk-y94xq8b4.js}

@@ -3,13 +3,13 @@ import {
 } from "./chunk-2171tajs.js";
 import {
   resourceAccess
-} from "./chunk-2m0mh09h.js";
+} from "./chunk-fhtbvj0s.js";
 import {
   resolveWorkload
-} from "./chunk-y3dx8jh6.js";
+} from "./chunk-p6k59m3q.js";
 import {
   KubernetesError
-} from "./chunk-ntfm5e85.js";
+} from "./chunk-zhkrydeg.js";
 import {
   KubectlExecutor
 } from "./chunk-hmah9t8e.js";

package/dist/chunk-zhkrydeg.js

@@ -0,0 +1,41 @@
+// src/errors.ts
+class ToolboxError extends Error {
+  kind;
+  code;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.kind = options.kind;
+    this.code = options.code;
+  }
+}
+
+class KubernetesError extends ToolboxError {
+}
+function kubernetesHttpError(status) {
+  const kind = {
+    401: "authentication_failed",
+    403: "permission_denied",
+    404: "resource_not_found",
+    408: "timeout",
+    429: "limit_exceeded",
+    504: "timeout"
+  }[status] ?? "operation_failed";
+  return new KubernetesError("Kubernetes resource request failed", { kind, code: status });
+}
+function kubernetesCommandError(result) {
+  if (result.timedOut)
+    return new KubernetesError("Kubernetes resource request timed out", { kind: "timeout" });
+  const reason = /^Error from server \(([^)]+)\):/m.exec(result.stderr)?.[1];
+  const status = reason ? {
+    Unauthorized: 401,
+    Forbidden: 403,
+    NotFound: 404,
+    Timeout: 408,
+    TooManyRequests: 429,
+    ServerTimeout: 504
+  }[reason] : undefined;
+  return status ? kubernetesHttpError(status) : new KubernetesError("Kubernetes resource request failed", { kind: "operation_failed" });
+}
+
+export { ToolboxError, KubernetesError, kubernetesHttpError, kubernetesCommandError };

package/dist/datasource.js

@@ -6,7 +6,7 @@ import {
 import {
   KubernetesError,
   ToolboxError
-} from "./chunk-ntfm5e85.js";
+} from "./chunk-zhkrydeg.js";
 export {
   clientKey,
   ToolboxError,

package/dist/errors.d.ts

@@ -12,3 +12,13 @@ export declare class ToolboxError extends Error {
 export declare class KubernetesError extends ToolboxError {
 }
 export declare function kubernetesHttpError(status: number): KubernetesError;
+/**
+ * Normalize a failed kubectl resource request at the transport boundary.
+ * Only the server's Status reason is authoritative; arbitrary stderr containing
+ * "not found" (including a missing kubectl binary) does not prove resource absence.
+ * Do not apply this to a command executed inside a container.
+ */
+export declare function kubernetesCommandError(result: {
+    stderr: string;
+    timedOut: boolean;
+}): KubernetesError;

package/dist/errors.js

@@ -1,10 +1,12 @@
 import {
   KubernetesError,
   ToolboxError,
+  kubernetesCommandError,
   kubernetesHttpError
-} from "./chunk-ntfm5e85.js";
+} from "./chunk-zhkrydeg.js";
 export {
   kubernetesHttpError,
+  kubernetesCommandError,
   ToolboxError,
   KubernetesError
 };

package/dist/kubernetes/client.js

@@ -1,12 +1,12 @@
 import {
   KubernetesClient
-} from "../chunk-1e3arqz3.js";
+} from "../chunk-y94xq8b4.js";
 import"../chunk-2171tajs.js";
 import"../chunk-j46x7j7c.js";
 import"../chunk-6fnhzhdb.js";
-import"../chunk-2m0mh09h.js";
-import"../chunk-y3dx8jh6.js";
-import"../chunk-ntfm5e85.js";
+import"../chunk-fhtbvj0s.js";
+import"../chunk-p6k59m3q.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";

package/dist/kubernetes/environment.js

@@ -1,15 +1,15 @@
 import {
   KubernetesClient
-} from "../chunk-1e3arqz3.js";
+} from "../chunk-y94xq8b4.js";
 import"../chunk-2171tajs.js";
 import"../chunk-j46x7j7c.js";
 import"../chunk-6fnhzhdb.js";
-import"../chunk-2m0mh09h.js";
-import"../chunk-y3dx8jh6.js";
+import"../chunk-fhtbvj0s.js";
+import"../chunk-p6k59m3q.js";
 import {
   clientKey
 } from "../chunk-a9htb6cr.js";
-import"../chunk-ntfm5e85.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";

package/dist/kubernetes/pod-log-datasource.js

@@ -8,7 +8,7 @@ import"../chunk-a9htb6cr.js";
 import {
   clientKey
 } from "../chunk-z5pm2emz.js";
-import"../chunk-ntfm5e85.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-v3hxvnrc.js";
 
 // src/kubernetes/pod-log-datasource.ts

package/dist/kubernetes/resources.js

@@ -1,7 +1,7 @@
 import {
   resourceAccess
-} from "../chunk-2m0mh09h.js";
-import"../chunk-ntfm5e85.js";
+} from "../chunk-fhtbvj0s.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-v3hxvnrc.js";
 export {
   resourceAccess

package/dist/kubernetes/workload.js

@@ -1,7 +1,7 @@
 import {
   resolveWorkload
-} from "../chunk-y3dx8jh6.js";
-import"../chunk-ntfm5e85.js";
+} from "../chunk-p6k59m3q.js";
+import"../chunk-zhkrydeg.js";
 export {
   resolveWorkload
 };

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/dist/s3/datasource.js

@@ -2,7 +2,7 @@ import {
   S3DataSource
 } from "../chunk-35cjec9z.js";
 import"../chunk-z5pm2emz.js";
-import"../chunk-ntfm5e85.js";
+import"../chunk-zhkrydeg.js";
 import"../chunk-zp1s833x.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-x4ntb898.js";

package/dist/s3/index.js

@@ -2,7 +2,7 @@ import {
   S3DataSource
 } from "../chunk-35cjec9z.js";
 import"../chunk-z5pm2emz.js";
-import"../chunk-ntfm5e85.js";
+import"../chunk-zhkrydeg.js";
 import {
   S3Client
 } from "../chunk-zp1s833x.js";

package/dist/s3/types.d.ts

@@ -1,4 +1,10 @@
 export interface S3Target {
+    /**
+     * Complete endpoint URL, including the scheme, host and any non-default port.
+     * A Kubernetes Service host includes its namespace (for example, http://s3.storage:9000).
+     * The source resolves the full address; downstream clients and transports use it as-is,
+     * without appending host suffixes or inferring a namespace from the consuming Service.
+     */
     endpoint: string;
     region: string;
     credentials: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-toolbox",
-  "version": "0.3.6",
+  "version": "0.3.9",
   "description": "Shared infrastructure clients, transports and bounded data capture",
   "type": "module",
   "scripts": {
@@ -110,6 +110,9 @@
     "@types/node-fetch": "2.6.13",
     "@types/node": "^22"
   },
+  "overrides": {
+    "@compforge/harness-common": "file:../common"
+  },
   "publishConfig": {
     "access": "public"
   },

package/dist/chunk-ntfm5e85.js

@@ -1,27 +0,0 @@
-// src/errors.ts
-class ToolboxError extends Error {
-  kind;
-  code;
-  constructor(message, options) {
-    super(message, { cause: options.cause });
-    this.name = new.target.name;
-    this.kind = options.kind;
-    this.code = options.code;
-  }
-}
-
-class KubernetesError extends ToolboxError {
-}
-function kubernetesHttpError(status) {
-  const kind = {
-    401: "authentication_failed",
-    403: "permission_denied",
-    404: "resource_not_found",
-    408: "timeout",
-    429: "limit_exceeded",
-    504: "timeout"
-  }[status] ?? "operation_failed";
-  return new KubernetesError("Kubernetes resource request failed", { kind, code: status });
-}
-
-export { ToolboxError, KubernetesError, kubernetesHttpError };