@compforge/harness-toolbox 0.3.5 → 0.3.8

package/dist/chunk-136egyff.js

@@ -0,0 +1,11 @@
+// src/mysql/connection.ts
+function destroyMysqlConnection(connection) {
+  const native = connection.connection;
+  try {
+    connection.destroy();
+  } finally {
+    native.stream.destroy();
+  }
+}
+
+export { destroyMysqlConnection };

package/dist/{chunk-qhpqse1y.js → chunk-2171tajs.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-6fnhzhdb.js";
 import {
   PortForwardScope
-} from "./chunk-xh3zwhjh.js";
+} from "./chunk-631vce5z.js";
 
 // src/kubernetes/service-port-forward.ts
 class ServicePortForwarder {

package/dist/{chunk-xh3zwhjh.js → chunk-631vce5z.js}

@@ -2,7 +2,6 @@ import {
   buildKubectlArgs
 } from "./chunk-hmah9t8e.js";
 import {
-  sleep,
   spawnProcess
 } from "./chunk-mn6dwsvh.js";
 
@@ -34,11 +33,16 @@ async function startPortForward(opts) {
     const remain = deadline - Date.now();
     if (remain <= 0)
       break;
+    let timer;
     const chunk = await Promise.race([
       reader.read(),
-      sleep(remain).then(() => "timeout"),
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve("timeout"), remain);
+      }),
       proc.exited.then(() => "exited").catch((error) => ({ error }))
-    ]);
+    ]).finally(() => {
+      clearTimeout(timer);
+    });
     if (chunk === "timeout")
       break;
     if (typeof chunk === "object" && "error" in chunk) {

package/dist/{chunk-kbewz29a.js → chunk-age65q4n.js}

@@ -1,3 +1,7 @@
+import {
+  destroyMysqlConnection
+} from "./chunk-136egyff.js";
+
 // src/mysql/readonly.ts
 function validateQueryLimits(limits) {
   for (const name of ["timeoutMs", "maxRows", "maxBytes"]) {
@@ -23,7 +27,7 @@ async function queryReadonlySession(connection, sql, values, limits, signal) {
       })(),
       new Promise((_resolve, reject) => {
         const fail = (reason) => {
-          connection.destroy();
+          destroyMysqlConnection(connection);
           reject(reason);
         };
         abort = () => fail(signal?.reason ?? new Error("MySQL query cancelled"));
@@ -38,7 +42,7 @@ async function queryReadonlySession(connection, sql, values, limits, signal) {
       clearTimeout(timer);
     if (abort)
       signal?.removeEventListener("abort", abort);
-    connection.destroy();
+    destroyMysqlConnection(connection);
   }
 }
 function collectRows(connection, sql, values, limits) {
@@ -64,21 +68,21 @@ function collectRows(connection, sql, values, limits) {
         return;
       if (result.rows.length >= limits.maxRows) {
         finish("rows");
-        connection.destroy();
+        destroyMysqlConnection(connection);
         return;
       }
       try {
         const bytes = Buffer.byteLength(JSON.stringify(row));
         if (result.bytes + bytes > limits.maxBytes) {
           finish("bytes");
-          connection.destroy();
+          destroyMysqlConnection(connection);
           return;
         }
         result.rows.push(row);
         result.bytes += bytes;
       } catch (error) {
         settled = true;
-        connection.destroy();
+        destroyMysqlConnection(connection);
         reject(error);
       }
     });

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-56t4qyp7.js → chunk-qqntng20.js}

@@ -1,11 +1,14 @@
+import {
+  queryReadonlySession,
+  validateQueryLimits
+} from "./chunk-age65q4n.js";
+import {
+  destroyMysqlConnection
+} from "./chunk-136egyff.js";
 import {
   queryMysqlViaPod,
   queryMysqlViaPodBatch
 } from "./chunk-m91t44jh.js";
-import {
-  queryReadonlySession,
-  validateQueryLimits
-} from "./chunk-kbewz29a.js";
 import {
   ConcurrencyPool
 } from "./chunk-v3hxvnrc.js";
@@ -54,7 +57,7 @@ class MysqlDatabase {
       try {
         return await queryReadonlySession(session.connection, sql, values, limits, this.options.signal);
       } finally {
-        session.connection.destroy();
+        destroyMysqlConnection(session.connection);
       }
     }, this.options.signal);
   }
@@ -90,7 +93,7 @@ class MysqlDatabase {
       if (this.#connections.get(key) === pending)
         this.#connections.delete(key);
       if (session?.kind === "tcp")
-        session.connection.destroy();
+        destroyMysqlConnection(session.connection);
       throw error;
     }
   }
@@ -143,7 +146,7 @@ class MysqlDatabase {
       this.#connections.clear();
       for (const result of await Promise.allSettled(pending)) {
         if (result.status === "fulfilled" && result.value.kind === "tcp")
-          result.value.connection.destroy();
+          destroyMysqlConnection(result.value.connection);
       }
     });
   }

package/dist/{chunk-5fgbhx2r.js → chunk-wv4jwhvj.js}

@@ -1,6 +1,6 @@
 import {
   startPortForward
-} from "./chunk-xh3zwhjh.js";
+} from "./chunk-631vce5z.js";
 import {
   KubectlExecutor
 } from "./chunk-hmah9t8e.js";

package/dist/{chunk-bg1syayb.js → chunk-y94xq8b4.js}

@@ -1,15 +1,15 @@
 import {
   ServicePortForwarder
-} from "./chunk-qhpqse1y.js";
+} 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,14 +1,14 @@
 import {
   KubernetesClient
-} from "../chunk-bg1syayb.js";
-import"../chunk-qhpqse1y.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-xh3zwhjh.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 export {

package/dist/kubernetes/environment.js

@@ -1,17 +1,17 @@
 import {
   KubernetesClient
-} from "../chunk-bg1syayb.js";
-import"../chunk-qhpqse1y.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-xh3zwhjh.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.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/port-forward.js

@@ -1,7 +1,7 @@
 import {
   PortForwardScope,
   startPortForward
-} from "../chunk-xh3zwhjh.js";
+} from "../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 export {

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/service-port-forward.js

@@ -1,9 +1,9 @@
 import {
   ServicePortForwarder
-} from "../chunk-qhpqse1y.js";
+} from "../chunk-2171tajs.js";
 import"../chunk-j46x7j7c.js";
 import"../chunk-6fnhzhdb.js";
-import"../chunk-xh3zwhjh.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 export {

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.js

@@ -2,13 +2,14 @@ import {
   MysqlClient,
   MysqlDatabase,
   openMysql
-} from "../chunk-56t4qyp7.js";
+} from "../chunk-qqntng20.js";
+import"../chunk-age65q4n.js";
+import"../chunk-136egyff.js";
 import"../chunk-m91t44jh.js";
-import"../chunk-kbewz29a.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-5fgbhx2r.js";
-import"../chunk-xh3zwhjh.js";
+import"../chunk-wv4jwhvj.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 import"../chunk-ssj93brx.js";

package/dist/mysql/connection.d.ts

@@ -0,0 +1,3 @@
+import type { Connection } from "mysql2/promise";
+/** @why Disposal must release the socket even when the peer never finishes its TCP half-close. */
+export declare function destroyMysqlConnection(connection: Connection): void;

package/dist/mysql/connection.js

@@ -0,0 +1,6 @@
+import {
+  destroyMysqlConnection
+} from "../chunk-136egyff.js";
+export {
+  destroyMysqlConnection
+};

package/dist/mysql/index.js

@@ -14,13 +14,14 @@ import {
   MysqlClient,
   MysqlDatabase,
   openMysql
-} from "../chunk-56t4qyp7.js";
+} from "../chunk-qqntng20.js";
+import"../chunk-age65q4n.js";
+import"../chunk-136egyff.js";
 import"../chunk-m91t44jh.js";
-import"../chunk-kbewz29a.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-5fgbhx2r.js";
-import"../chunk-xh3zwhjh.js";
+import"../chunk-wv4jwhvj.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 import"../chunk-ssj93brx.js";

package/dist/mysql/readonly.js

@@ -1,7 +1,8 @@
 import {
   queryReadonlySession,
   validateQueryLimits
-} from "../chunk-kbewz29a.js";
+} from "../chunk-age65q4n.js";
+import"../chunk-136egyff.js";
 export {
   validateQueryLimits,
   queryReadonlySession

package/dist/s3/datasource.js

@@ -2,13 +2,13 @@ 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";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-5fgbhx2r.js";
-import"../chunk-xh3zwhjh.js";
+import"../chunk-wv4jwhvj.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 import"../chunk-ssj93brx.js";

package/dist/s3/index.js

@@ -2,15 +2,15 @@ import {
   S3DataSource
 } from "../chunk-35cjec9z.js";
 import"../chunk-z5pm2emz.js";
-import"../chunk-ntfm5e85.js";
+import"../chunk-zhkrydeg.js";
 import {
   S3Client
 } from "../chunk-zp1s833x.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-x4ntb898.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-5fgbhx2r.js";
-import"../chunk-xh3zwhjh.js";
+import"../chunk-wv4jwhvj.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 import"../chunk-ssj93brx.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/dist/transport/index.js

@@ -6,8 +6,8 @@ import {
 } from "../chunk-h8fwx0k7.js";
 import {
   PodRelayTransport
-} from "../chunk-5fgbhx2r.js";
-import"../chunk-xh3zwhjh.js";
+} from "../chunk-wv4jwhvj.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 import"../chunk-ssj93brx.js";

package/dist/transport/pod-relay.js

@@ -1,7 +1,7 @@
 import {
   PodRelayTransport
-} from "../chunk-5fgbhx2r.js";
-import"../chunk-xh3zwhjh.js";
+} from "../chunk-wv4jwhvj.js";
+import"../chunk-631vce5z.js";
 import"../chunk-hmah9t8e.js";
 import"../chunk-mn6dwsvh.js";
 import"../chunk-ssj93brx.js";

package/package.json

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

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 };