@compforge/harness-toolbox 0.3.4 → 0.3.5

package/README.md

@@ -9,6 +9,10 @@ clients to access Kubernetes, MySQL, Redis, OpenSearch and S3-compatible object
 command, plugin protocol, test model or verdict.
 
 The package supports Node.js 22+ and Bun. Install with `npm install @compforge/harness-toolbox`.
+Use `@compforge/harness-toolbox/duration` to parse a positive duration such as `30m` or `2d` into milliseconds.
+`searchAfterPages` from `@compforge/harness-toolbox/opensearch/search-after` yields raw OpenSearch
+hit pages with a caller supplied query and stable sort. It streams pages without owning the client or
+claiming snapshot consistency; callers supply cancellation and decide how to persist or verify results.
 Protocol adapters have separate entry points; importing lifecycle or transport contracts does
 not load database or Kubernetes drivers.
 

package/dist/chunk-99p0zt4f.js

@@ -0,0 +1,37 @@
+// src/opensearch/search-after.ts
+async function* searchAfterPages(search, index, options) {
+  if (!Number.isSafeInteger(options.pageSize) || options.pageSize <= 0 || !options.sort.length) {
+    throw new Error("search_after requires a positive pageSize and a non-empty sort");
+  }
+  let cursor;
+  for (;; ) {
+    options.signal?.throwIfAborted();
+    const body = {
+      query: options.query,
+      sort: options.sort,
+      size: options.pageSize,
+      track_total_hits: false,
+      ...cursor ? { search_after: cursor } : {}
+    };
+    const result = await search.search(index, body);
+    if (result.timed_out === true || Number(result._shards?.failed ?? 0) > 0) {
+      throw new Error(`OpenSearch search_after page failed for index '${index}'`);
+    }
+    const hits = result.hits?.hits;
+    if (!Array.isArray(hits))
+      throw new Error(`OpenSearch search_after response has no hits for index '${index}'`);
+    if (!hits.length)
+      return;
+    const page = hits;
+    const next = page.at(-1)?.sort;
+    if (!Array.isArray(next) || !next.length || cursor && JSON.stringify(next) === JSON.stringify(cursor)) {
+      throw new Error(`OpenSearch search_after cursor did not advance for index '${index}'`);
+    }
+    yield page;
+    cursor = next;
+    if (page.length < options.pageSize)
+      return;
+  }
+}
+
+export { searchAfterPages };

package/dist/chunk-pjcrhw3n.js

@@ -0,0 +1,22 @@
+// src/duration.ts
+function parseDuration(value) {
+  const units = { ns: 0.000001, us: 0.001, "µs": 0.001, ms: 1, s: 1000, m: 60000, h: 3600000, d: 86400000 };
+  const input = value.trim();
+  let total = 0;
+  let cursor = 0;
+  const segment = /(\d+(?:\.\d+)?)(ns|us|µs|ms|s|m|h|d)/gy;
+  while (cursor < input.length) {
+    segment.lastIndex = cursor;
+    const match = segment.exec(input);
+    if (!match)
+      throw new Error(`Invalid duration: '${value}'`);
+    total += Number(match[1]) * units[match[2]];
+    cursor = segment.lastIndex;
+  }
+  if (!Number.isFinite(total) || total <= 0 || total > Number.MAX_SAFE_INTEGER) {
+    throw new Error(`Invalid duration: '${value}'`);
+  }
+  return total;
+}
+
+export { parseDuration };

package/dist/duration.d.ts

@@ -0,0 +1,2 @@
+/** Parse a positive duration to milliseconds. All segments must be consumed. */
+export declare function parseDuration(value: string): number;

package/dist/duration.js

@@ -0,0 +1,6 @@
+import {
+  parseDuration
+} from "./chunk-pjcrhw3n.js";
+export {
+  parseDuration
+};

package/dist/kubernetes/client-node-pod-log.js

@@ -1,6 +1,9 @@
 import {
   logTimestampNanos
 } from "../chunk-mp88s7r7.js";
+import {
+  parseDuration
+} from "../chunk-pjcrhw3n.js";
 
 // src/kubernetes/client-node-pod-log.ts
 import { closeSync, openSync, writeSync } from "node:fs";
@@ -14,30 +17,11 @@ var DEFAULT_CLIENT_NODE_LOG_POLICY = {
 var RFC3339_LINE = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2}))(?:\s|$)/;
 var RECENT_LINE_LIMIT = 256;
 function parseSinceSeconds(value) {
-  const input = value.trim();
-  if (!input)
+  try {
+    return Math.max(1, Math.ceil(parseDuration(value) / 1000));
+  } catch {
     return;
-  const units = {
-    ns: 0.000000001,
-    us: 0.000001,
-    "µs": 0.000001,
-    ms: 0.001,
-    s: 1,
-    m: 60,
-    h: 3600
-  };
-  let seconds = 0;
-  let cursor = 0;
-  const segment = /(\d+(?:\.\d+)?)(ns|us|µs|ms|s|m|h)/gy;
-  while (cursor < input.length) {
-    segment.lastIndex = cursor;
-    const match = segment.exec(input);
-    if (!match)
-      return;
-    seconds += Number(match[1]) * units[match[2]];
-    cursor = segment.lastIndex;
   }
-  return Math.max(1, Math.ceil(seconds));
 }
 function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);

package/dist/kubernetes/client.js

@@ -1,11 +1,11 @@
 import {
   KubernetesClient
-} from "../chunk-td11zjfb.js";
-import"../chunk-y3dx8jh6.js";
+} from "../chunk-bg1syayb.js";
 import"../chunk-qhpqse1y.js";
 import"../chunk-j46x7j7c.js";
 import"../chunk-6fnhzhdb.js";
 import"../chunk-2m0mh09h.js";
+import"../chunk-y3dx8jh6.js";
 import"../chunk-ntfm5e85.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-xh3zwhjh.js";

package/dist/kubernetes/environment.js

@@ -1,11 +1,11 @@
 import {
   KubernetesClient
-} from "../chunk-td11zjfb.js";
-import"../chunk-y3dx8jh6.js";
+} from "../chunk-bg1syayb.js";
 import"../chunk-qhpqse1y.js";
 import"../chunk-j46x7j7c.js";
 import"../chunk-6fnhzhdb.js";
 import"../chunk-2m0mh09h.js";
+import"../chunk-y3dx8jh6.js";
 import {
   clientKey
 } from "../chunk-a9htb6cr.js";

package/dist/mysql/index.js

@@ -1,3 +1,11 @@
+import {
+  parseMysqlEnvTarget
+} from "../chunk-qq77x9ek.js";
+import {
+  limitedRows,
+  limitedStatement,
+  queryLimited
+} from "../chunk-1gyshqd9.js";
 import"../chunk-pfar9cm3.js";
 import {
   withReadScope
@@ -9,14 +17,6 @@ import {
 } from "../chunk-56t4qyp7.js";
 import"../chunk-m91t44jh.js";
 import"../chunk-kbewz29a.js";
-import {
-  parseMysqlEnvTarget
-} from "../chunk-qq77x9ek.js";
-import {
-  limitedRows,
-  limitedStatement,
-  queryLimited
-} from "../chunk-1gyshqd9.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
 import"../chunk-5fgbhx2r.js";

package/dist/opensearch/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./client";
 export * from "./endpoint";
 export * from "./types";
+export * from "./search-after";

package/dist/opensearch/index.js

@@ -1,14 +1,18 @@
-import {
-  parseOpenSearchEndpoint
-} from "../chunk-s1sjyem7.js";
-import"../chunk-djk4kmxb.js";
 import {
   OpenSearchClient,
   OpenSearchEngine,
   isOpenSearchReadApi,
   openOpenSearch
 } from "../chunk-w3a4p6jm.js";
+import {
+  searchAfterPages
+} from "../chunk-99p0zt4f.js";
+import {
+  parseOpenSearchEndpoint
+} from "../chunk-s1sjyem7.js";
+import"../chunk-djk4kmxb.js";
 export {
+  searchAfterPages,
   parseOpenSearchEndpoint,
   openOpenSearch,
   isOpenSearchReadApi,

package/dist/opensearch/search-after.d.ts

@@ -0,0 +1,12 @@
+import type { SearchEngine, SearchQuery } from "./types";
+export interface SearchAfterOptions {
+    query: SearchQuery;
+    /** The caller must include a stable tie breaker in this sort. */
+    sort: readonly Record<string, unknown>[];
+    pageSize: number;
+    signal?: AbortSignal;
+}
+/** Iterate raw hits with the last hit's sort tuple; caller owns the stable sort and any PIT.
+ * Without PIT, this is a live view and concurrent indexing can change later pages.
+ */
+export declare function searchAfterPages(search: SearchEngine, index: string, options: SearchAfterOptions): AsyncGenerator<Record<string, unknown>[]>;

package/dist/opensearch/search-after.js

@@ -0,0 +1,6 @@
+import {
+  searchAfterPages
+} from "../chunk-99p0zt4f.js";
+export {
+  searchAfterPages
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-toolbox",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Shared infrastructure clients, transports and bounded data capture",
   "type": "module",
   "scripts": {
@@ -9,6 +9,10 @@
     "build": "bun scripts/build.ts && tsc -p tsconfig.build.json"
   },
   "exports": {
+    "./duration": {
+      "types": "./dist/duration.d.ts",
+      "import": "./dist/duration.js"
+    },
     "./errors": {
       "types": "./dist/errors.d.ts",
       "import": "./dist/errors.js"
@@ -106,6 +110,9 @@
     "@types/node-fetch": "2.6.13",
     "@types/node": "^22"
   },
+  "overrides": {
+    "@compforge/harness-common": "file:../common"
+  },
   "publishConfig": {
     "access": "public"
   },

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

@@ -1,12 +1,12 @@
-import {
-  resolveWorkload
-} from "./chunk-y3dx8jh6.js";
 import {
   ServicePortForwarder
 } from "./chunk-qhpqse1y.js";
 import {
   resourceAccess
 } from "./chunk-2m0mh09h.js";
+import {
+  resolveWorkload
+} from "./chunk-y3dx8jh6.js";
 import {
   KubernetesError
 } from "./chunk-ntfm5e85.js";