beeai-framework 0.1.2

package/dist/internals/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/fetcher.ts"],"names":["RestfulClientError","FrameworkError","createURLParams","data","urlTokenParams","URLSearchParams","key","value","Object","entries","undefined","Array","isArray","forEach","v","append","String","isPlainObject","set","toString","RestfulClient","Serializable","emitter","constructor","input","Emitter","root","child","namespace","creator","stream","path","init","paths","baseUrl","headers","groupId","url","URL","options","method","then","raw","assign","fromEntries","emit","emitterToGenerator","fetchEventSource","onopen","response","ok","get","EventStreamContentType","context","err","text","isRetryable","status","onmessage","msg","event","onclose","onerror","catch","error","doNothing","finally","fetch","getHeaders","target","searchParams","includes","json","createSnapshot","shallowCopy","loadSnapshot","snapshot"],"mappings":"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","file":"fetcher.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\nimport {\n  EventSourceMessage,\n  EventStreamContentType,\n  fetchEventSource,\n} from \"@ai-zen/node-fetch-event-source\";\nimport { FetchEventSourceInit } from \"@ai-zen/node-fetch-event-source/lib/cjs/fetch.js\";\nimport { emitterToGenerator } from \"@/internals/helpers/promise.js\";\nimport { doNothing, isPlainObject } from \"remeda\";\nimport { Callback, Emitter } from \"@/emitter/emitter.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\n\nexport class RestfulClientError extends FrameworkError {}\n\ntype URLParamType = string | number | boolean | null | undefined;\nexport function createURLParams(\n  data: Record<string, URLParamType | URLParamType[] | Record<string, any>>,\n) {\n  const urlTokenParams = new URLSearchParams();\n  for (const [key, value] of Object.entries(data)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      value.forEach((v) => {\n        if (v !== undefined) {\n          urlTokenParams.append(key, String(v));\n        }\n      });\n    } else if (isPlainObject(value)) {\n      urlTokenParams.set(key, createURLParams(value).toString());\n    } else {\n      urlTokenParams.set(key, String(value));\n    }\n  }\n  return urlTokenParams;\n}\n\ninterface FetchInput {\n  url: string;\n  options: RequestInit;\n}\n\nexport interface StreamInput {\n  url: string;\n  options: FetchEventSourceInit;\n}\n\nexport interface RestfulClientEvents {\n  fetchStart: Callback<{ input: FetchInput }>;\n  fetchError: Callback<{ error: Error; input: FetchInput }>;\n  fetchSuccess: Callback<{ response: Response; data: any; input: FetchInput }>;\n  fetchDone: Callback<{ input: FetchInput }>;\n\n  streamStart: Callback<{ input: StreamInput }>;\n  streamOpen: Callback<{ input: StreamInput }>;\n  streamSuccess: Callback<{ input: StreamInput }>;\n  streamMessage: Callback<{ data: EventSourceMessage; input: StreamInput }>;\n  streamError: Callback<{ error: Error; input: StreamInput }>;\n  streamDone: Callback<{ input: StreamInput }>;\n}\n\nexport class RestfulClient<K extends Record<string, string>> extends Serializable {\n  public readonly emitter = Emitter.root.child<RestfulClientEvents>({\n    namespace: [\"internals\", \"restfulClient\"],\n    creator: this,\n  });\n\n  constructor(\n    protected input: {\n      baseUrl: string;\n      headers: () => Promise<Headers>;\n      paths: K;\n    },\n  ) {\n    super();\n  }\n\n  async *stream(\n    path: keyof K,\n    init: FetchEventSourceInit,\n  ): AsyncGenerator<EventSourceMessage, void, void> {\n    const { paths, baseUrl, headers } = this.input;\n    const emitter = this.emitter.child({\n      groupId: \"stream\",\n    });\n\n    const input: StreamInput = {\n      url: new URL(paths[path] ?? path, baseUrl).toString(),\n      options: {\n        ...init,\n        method: \"POST\",\n        headers: await headers().then((raw) =>\n          Object.assign(Object.fromEntries(raw.entries()), init?.headers),\n        ),\n      },\n    };\n    await emitter.emit(\"streamStart\", { input });\n\n    return yield* emitterToGenerator(async ({ emit }) =>\n      fetchEventSource(input.url, {\n        ...input.options,\n        async onopen(response) {\n          if (response.ok && response.headers.get(\"content-type\") === EventStreamContentType) {\n            await emitter.emit(\"streamOpen\", { input });\n            return;\n          }\n          throw new RestfulClientError(\"Failed to stream!\", [], {\n            context: {\n              url: response.url,\n              err: await response.text(),\n              response,\n            },\n            isRetryable: response.status >= 400 && response.status < 500 && response.status !== 429,\n          });\n        },\n        async onmessage(msg) {\n          if (msg?.event === \"error\") {\n            throw new RestfulClientError(`Error during streaming has occurred.`, [], {\n              context: msg,\n            });\n          }\n          await emitter.emit(\"streamMessage\", { input, data: msg });\n          emit(msg);\n        },\n        onclose() {},\n        onerror(err) {\n          throw new RestfulClientError(`Error during streaming has occurred.`, [err]);\n        },\n      })\n        .then(() => emitter.emit(\"streamSuccess\", { input }))\n        .catch(async (error) => {\n          await emitter.emit(\"streamError\", { input, error }).catch(doNothing());\n          throw error;\n        })\n        .finally(() => emitter.emit(\"streamDone\", { input })),\n    );\n  }\n\n  async fetch(path: keyof K, init?: RequestInit & { searchParams?: URLSearchParams }) {\n    const emitter = this.emitter.child({\n      groupId: \"fetch\",\n    });\n\n    const { paths, baseUrl, headers: getHeaders } = this.input;\n\n    const target = new URL(paths[path] ?? path, baseUrl);\n    if (init?.searchParams) {\n      for (const [key, value] of init.searchParams) {\n        target.searchParams.set(key, value);\n      }\n    }\n\n    const input: FetchInput = {\n      url: target.toString(),\n      options: {\n        ...init,\n        headers: await getHeaders().then((raw) =>\n          Object.assign(Object.fromEntries(raw.entries()), init?.headers),\n        ),\n      },\n    };\n\n    await emitter.emit(\"fetchStart\", { input });\n    try {\n      const response = await fetch(input.url, input.options);\n\n      if (!response.ok) {\n        throw new RestfulClientError(\"Fetch has failed\", [], {\n          context: {\n            url: response.url,\n            error: await response.text(),\n            response,\n          },\n          isRetryable: [408, 503].includes(response.status ?? 500),\n        });\n      }\n\n      const data = await response.json();\n      await emitter.emit(\"fetchSuccess\", { response, data, input });\n      return data;\n    } catch (error) {\n      await emitter.emit(\"fetchError\", { error, input: input });\n      throw error;\n    } finally {\n      await emitter.emit(\"fetchDone\", { input: input });\n    }\n  }\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      emitter: this.emitter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/internals/helpers/array.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function removeFromArray(arr, target) {
+  const index = arr.findIndex((value) => value === target);
+  if (index === -1) {
+    return false;
+  }
+  arr.splice(index, 1);
+  return true;
+}
+__name(removeFromArray, "removeFromArray");
+function castArray(arr) {
+  const result = Array.isArray(arr) ? arr : [
+    arr
+  ];
+  return result;
+}
+__name(castArray, "castArray");
+function hasMinLength(arr, n) {
+  return arr.length >= n;
+}
+__name(hasMinLength, "hasMinLength");
+
+exports.castArray = castArray;
+exports.hasMinLength = hasMinLength;
+exports.removeFromArray = removeFromArray;
+//# sourceMappingURL=array.cjs.map
+//# sourceMappingURL=array.cjs.map

package/dist/internals/helpers/array.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/array.ts"],"names":["removeFromArray","arr","target","index","findIndex","value","splice","castArray","result","Array","isArray","hasMinLength","n","length"],"mappings":";;;;AAgBO,SAASA,eAAAA,CAAmBC,KAAUC,MAAS,EAAA;AACpD,EAAA,MAAMC,QAAQF,GAAIG,CAAAA,SAAAA,CAAU,CAACC,KAAAA,KAAUA,UAAUH,MAAAA,CAAAA;AACjD,EAAA,IAAIC,UAAU,CAAI,CAAA,EAAA;AAChB,IAAO,OAAA,KAAA;AACT;AAEAF,EAAIK,GAAAA,CAAAA,MAAAA,CAAOH,OAAO,CAAA,CAAA;AAClB,EAAO,OAAA,IAAA;AACT;AARgBH,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAUT,SAASO,UAAaN,GAAM,EAAA;AACjC,EAAA,MAAMO,MAASC,GAAAA,KAAAA,CAAMC,OAAQT,CAAAA,GAAAA,IAAOA,GAAM,GAAA;AAACA,IAAAA;;AAC3C,EAAOO,OAAAA,MAAAA;AACT;AAHgBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAST,SAASI,YAAAA,CAAkCV,KAAUW,CAAI,EAAA;AAC9D,EAAA,OAAOX,IAAIY,MAAUD,IAAAA,CAAAA;AACvB;AAFgBD,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA","file":"array.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function removeFromArray<T>(arr: T[], target: T): boolean {\n  const index = arr.findIndex((value) => value === target);\n  if (index === -1) {\n    return false;\n  }\n\n  arr.splice(index, 1);\n  return true;\n}\n\nexport function castArray<T>(arr: T) {\n  const result = Array.isArray(arr) ? arr : [arr];\n  return result as T extends unknown[] ? T : [T];\n}\n\ntype HasMinLength<T, N extends number, T2 extends any[] = []> = T2[\"length\"] extends N\n  ? [...T2, ...T[]]\n  : HasMinLength<T, N, [any, ...T2]>;\n\nexport function hasMinLength<T, N extends number>(arr: T[], n: N): arr is HasMinLength<T, N> {\n  return arr.length >= n;\n}\n"]}

package/dist/internals/helpers/array.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function removeFromArray<T>(arr: T[], target: T): boolean;
+declare function castArray<T>(arr: T): T extends unknown[] ? T : [T];
+type HasMinLength<T, N extends number, T2 extends any[] = []> = T2["length"] extends N ? [...T2, ...T[]] : HasMinLength<T, N, [any, ...T2]>;
+declare function hasMinLength<T, N extends number>(arr: T[], n: N): arr is HasMinLength<T, N>;
+
+export { castArray, hasMinLength, removeFromArray };

package/dist/internals/helpers/array.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function removeFromArray<T>(arr: T[], target: T): boolean;
+declare function castArray<T>(arr: T): T extends unknown[] ? T : [T];
+type HasMinLength<T, N extends number, T2 extends any[] = []> = T2["length"] extends N ? [...T2, ...T[]] : HasMinLength<T, N, [any, ...T2]>;
+declare function hasMinLength<T, N extends number>(arr: T[], n: N): arr is HasMinLength<T, N>;
+
+export { castArray, hasMinLength, removeFromArray };

package/dist/internals/helpers/array.js

@@ -0,0 +1,26 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function removeFromArray(arr, target) {
+  const index = arr.findIndex((value) => value === target);
+  if (index === -1) {
+    return false;
+  }
+  arr.splice(index, 1);
+  return true;
+}
+__name(removeFromArray, "removeFromArray");
+function castArray(arr) {
+  const result = Array.isArray(arr) ? arr : [
+    arr
+  ];
+  return result;
+}
+__name(castArray, "castArray");
+function hasMinLength(arr, n) {
+  return arr.length >= n;
+}
+__name(hasMinLength, "hasMinLength");
+
+export { castArray, hasMinLength, removeFromArray };
+//# sourceMappingURL=array.js.map
+//# sourceMappingURL=array.js.map

package/dist/internals/helpers/array.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/array.ts"],"names":["removeFromArray","arr","target","index","findIndex","value","splice","castArray","result","Array","isArray","hasMinLength","n","length"],"mappings":";;AAgBO,SAASA,eAAAA,CAAmBC,KAAUC,MAAS,EAAA;AACpD,EAAA,MAAMC,QAAQF,GAAIG,CAAAA,SAAAA,CAAU,CAACC,KAAAA,KAAUA,UAAUH,MAAAA,CAAAA;AACjD,EAAA,IAAIC,UAAU,CAAI,CAAA,EAAA;AAChB,IAAO,OAAA,KAAA;AACT;AAEAF,EAAIK,GAAAA,CAAAA,MAAAA,CAAOH,OAAO,CAAA,CAAA;AAClB,EAAO,OAAA,IAAA;AACT;AARgBH,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAUT,SAASO,UAAaN,GAAM,EAAA;AACjC,EAAA,MAAMO,MAASC,GAAAA,KAAAA,CAAMC,OAAQT,CAAAA,GAAAA,IAAOA,GAAM,GAAA;AAACA,IAAAA;;AAC3C,EAAOO,OAAAA,MAAAA;AACT;AAHgBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAST,SAASI,YAAAA,CAAkCV,KAAUW,CAAI,EAAA;AAC9D,EAAA,OAAOX,IAAIY,MAAUD,IAAAA,CAAAA;AACvB;AAFgBD,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA","file":"array.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function removeFromArray<T>(arr: T[], target: T): boolean {\n  const index = arr.findIndex((value) => value === target);\n  if (index === -1) {\n    return false;\n  }\n\n  arr.splice(index, 1);\n  return true;\n}\n\nexport function castArray<T>(arr: T) {\n  const result = Array.isArray(arr) ? arr : [arr];\n  return result as T extends unknown[] ? T : [T];\n}\n\ntype HasMinLength<T, N extends number, T2 extends any[] = []> = T2[\"length\"] extends N\n  ? [...T2, ...T[]]\n  : HasMinLength<T, N, [any, ...T2]>;\n\nexport function hasMinLength<T, N extends number>(arr: T[], n: N): arr is HasMinLength<T, N> {\n  return arr.length >= n;\n}\n"]}

package/dist/internals/helpers/cancellation.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function createAbortController(...signals) {
+  const controller = new AbortController();
+  registerSignals(controller, signals);
+  return controller;
+}
+__name(createAbortController, "createAbortController");
+function registerSignals(controller, signals) {
+  signals.forEach((signal) => {
+    if (signal?.aborted) {
+      controller.abort(signal.reason);
+    }
+    signal?.addEventListener?.("abort", () => {
+      controller.abort(signal?.reason);
+    }, {
+      once: true,
+      signal: controller.signal
+    });
+  });
+}
+__name(registerSignals, "registerSignals");
+
+exports.createAbortController = createAbortController;
+exports.registerSignals = registerSignals;
+//# sourceMappingURL=cancellation.cjs.map
+//# sourceMappingURL=cancellation.cjs.map

package/dist/internals/helpers/cancellation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/cancellation.ts"],"names":["createAbortController","signals","controller","AbortController","registerSignals","forEach","signal","aborted","abort","reason","addEventListener","once"],"mappings":";;;;AAgBO,SAASA,yBAAyBC,OAAoC,EAAA;AAC3E,EAAMC,MAAAA,UAAAA,GAAa,IAAIC,eAAAA,EAAAA;AACvBC,EAAAA,eAAAA,CAAgBF,YAAYD,OAAAA,CAAAA;AAC5B,EAAOC,OAAAA,UAAAA;AACT;AAJgBF,MAAAA,CAAAA,qBAAAA,EAAAA,uBAAAA,CAAAA;AAMT,SAASI,eAAAA,CAAgBF,YAA6BD,OAAoC,EAAA;AAC/FA,EAAQI,OAAAA,CAAAA,OAAAA,CAAQ,CAACC,MAAAA,KAAAA;AACf,IAAA,IAAIA,QAAQC,OAAS,EAAA;AACnBL,MAAWM,UAAAA,CAAAA,KAAAA,CAAMF,OAAOG,MAAM,CAAA;AAChC;AAEAH,IAAQI,MAAAA,EAAAA,gBAAAA,GACN,SACA,MAAA;AACER,MAAWM,UAAAA,CAAAA,KAAAA,CAAMF,QAAQG,MAAAA,CAAAA;KAE3B,EAAA;MACEE,IAAM,EAAA,IAAA;AACNL,MAAAA,MAAAA,EAAQJ,UAAWI,CAAAA;KACrB,CAAA;GAEJ,CAAA;AACF;AAjBgBF,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA","file":"cancellation.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function createAbortController(...signals: (AbortSignal | undefined)[]) {\n  const controller = new AbortController();\n  registerSignals(controller, signals);\n  return controller;\n}\n\nexport function registerSignals(controller: AbortController, signals: (AbortSignal | undefined)[]) {\n  signals.forEach((signal) => {\n    if (signal?.aborted) {\n      controller.abort(signal.reason);\n    }\n\n    signal?.addEventListener?.(\n      \"abort\",\n      () => {\n        controller.abort(signal?.reason);\n      },\n      {\n        once: true,\n        signal: controller.signal,\n      },\n    );\n  });\n}\n"]}

package/dist/internals/helpers/cancellation.d.cts

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function createAbortController(...signals: (AbortSignal | undefined)[]): AbortController;
+declare function registerSignals(controller: AbortController, signals: (AbortSignal | undefined)[]): void;
+
+export { createAbortController, registerSignals };

package/dist/internals/helpers/cancellation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function createAbortController(...signals: (AbortSignal | undefined)[]): AbortController;
+declare function registerSignals(controller: AbortController, signals: (AbortSignal | undefined)[]): void;
+
+export { createAbortController, registerSignals };

package/dist/internals/helpers/cancellation.js

@@ -0,0 +1,26 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function createAbortController(...signals) {
+  const controller = new AbortController();
+  registerSignals(controller, signals);
+  return controller;
+}
+__name(createAbortController, "createAbortController");
+function registerSignals(controller, signals) {
+  signals.forEach((signal) => {
+    if (signal?.aborted) {
+      controller.abort(signal.reason);
+    }
+    signal?.addEventListener?.("abort", () => {
+      controller.abort(signal?.reason);
+    }, {
+      once: true,
+      signal: controller.signal
+    });
+  });
+}
+__name(registerSignals, "registerSignals");
+
+export { createAbortController, registerSignals };
+//# sourceMappingURL=cancellation.js.map
+//# sourceMappingURL=cancellation.js.map

package/dist/internals/helpers/cancellation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/cancellation.ts"],"names":["createAbortController","signals","controller","AbortController","registerSignals","forEach","signal","aborted","abort","reason","addEventListener","once"],"mappings":";;AAgBO,SAASA,yBAAyBC,OAAoC,EAAA;AAC3E,EAAMC,MAAAA,UAAAA,GAAa,IAAIC,eAAAA,EAAAA;AACvBC,EAAAA,eAAAA,CAAgBF,YAAYD,OAAAA,CAAAA;AAC5B,EAAOC,OAAAA,UAAAA;AACT;AAJgBF,MAAAA,CAAAA,qBAAAA,EAAAA,uBAAAA,CAAAA;AAMT,SAASI,eAAAA,CAAgBF,YAA6BD,OAAoC,EAAA;AAC/FA,EAAQI,OAAAA,CAAAA,OAAAA,CAAQ,CAACC,MAAAA,KAAAA;AACf,IAAA,IAAIA,QAAQC,OAAS,EAAA;AACnBL,MAAWM,UAAAA,CAAAA,KAAAA,CAAMF,OAAOG,MAAM,CAAA;AAChC;AAEAH,IAAQI,MAAAA,EAAAA,gBAAAA,GACN,SACA,MAAA;AACER,MAAWM,UAAAA,CAAAA,KAAAA,CAAMF,QAAQG,MAAAA,CAAAA;KAE3B,EAAA;MACEE,IAAM,EAAA,IAAA;AACNL,MAAAA,MAAAA,EAAQJ,UAAWI,CAAAA;KACrB,CAAA;GAEJ,CAAA;AACF;AAjBgBF,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA","file":"cancellation.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function createAbortController(...signals: (AbortSignal | undefined)[]) {\n  const controller = new AbortController();\n  registerSignals(controller, signals);\n  return controller;\n}\n\nexport function registerSignals(controller: AbortController, signals: (AbortSignal | undefined)[]) {\n  signals.forEach((signal) => {\n    if (signal?.aborted) {\n      controller.abort(signal.reason);\n    }\n\n    signal?.addEventListener?.(\n      \"abort\",\n      () => {\n        controller.abort(signal?.reason);\n      },\n      {\n        once: true,\n        signal: controller.signal,\n      },\n    );\n  });\n}\n"]}

package/dist/internals/helpers/counter.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var serializable_cjs = require('../serializable.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class RetryCounter extends serializable_cjs.Serializable {
+  static {
+    __name(this, "RetryCounter");
+  }
+  ErrorClass;
+  remaining;
+  maxRetries;
+  lastError;
+  finalError;
+  constructor(maxRetries = 0, ErrorClass) {
+    super(), this.ErrorClass = ErrorClass;
+    this.maxRetries = maxRetries;
+    this.remaining = maxRetries;
+  }
+  use(error) {
+    if (this.finalError) {
+      throw this.finalError;
+    }
+    this.lastError = error ?? this.lastError;
+    this.remaining--;
+    if (this.remaining < 0) {
+      this.finalError = new this.ErrorClass(`Maximal amount of global retries (${this.maxRetries}) has been reached.`, this.lastError ? [
+        this.lastError
+      ] : void 0, {
+        isFatal: true,
+        isRetryable: false
+      });
+      throw this.finalError;
+    }
+  }
+  createSnapshot() {
+    return {
+      remaining: this.remaining,
+      maxRetries: this.maxRetries,
+      lastError: this.lastError,
+      finalError: this.finalError,
+      ErrorClass: this.ErrorClass
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+exports.RetryCounter = RetryCounter;
+//# sourceMappingURL=counter.cjs.map
+//# sourceMappingURL=counter.cjs.map

package/dist/internals/helpers/counter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/counter.ts"],"names":["RetryCounter","Serializable","remaining","maxRetries","lastError","finalError","constructor","ErrorClass","use","error","undefined","isFatal","isRetryable","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;AAmBO,MAAMA,qBAAqBC,6BAAAA,CAAAA;EAnBlC;;;;AAoBSC,EAAAA,SAAAA;AACYC,EAAAA,UAAAA;AACTC,EAAAA,SAAAA;AACAC,EAAAA,UAAAA;EAEVC,WACEH,CAAAA,UAAAA,GAAa,GACHI,UACV,EAAA;AACA,IAAK,KAAA,EAAA,EAAA,KAFKA,UAAAA,GAAAA,UAAAA;AAGV,IAAA,IAAA,CAAKJ,UAAaA,GAAAA,UAAAA;AAClB,IAAA,IAAA,CAAKD,SAAYC,GAAAA,UAAAA;AACnB;AAEAK,EAAAA,GAAAA,CAAIC,KAAe,EAAA;AACjB,IAAA,IAAI,KAAKJ,UAAY,EAAA;AACnB,MAAA,MAAM,IAAKA,CAAAA,UAAAA;AACb;AAEA,IAAKD,IAAAA,CAAAA,SAAAA,GAAYK,SAAS,IAAKL,CAAAA,SAAAA;AAC/B,IAAKF,IAAAA,CAAAA,SAAAA,EAAAA;AACL,IAAI,IAAA,IAAA,CAAKA,YAAY,CAAG,EAAA;AACtB,MAAKG,IAAAA,CAAAA,UAAAA,GAAa,IAAI,IAAKE,CAAAA,UAAAA,CACzB,qCAAqC,IAAKJ,CAAAA,UAAU,CACpD,mBAAA,CAAA,EAAA,IAAA,CAAKC,SAAY,GAAA;QAAC,IAAKA,CAAAA;UAAaM,KACpC,CAAA,EAAA;QAAEC,OAAS,EAAA,IAAA;QAAMC,WAAa,EAAA;OAAM,CAAA;AAEtC,MAAA,MAAM,IAAKP,CAAAA,UAAAA;AACb;AACF;EAEAQ,cAAiB,GAAA;AACf,IAAO,OAAA;AACLX,MAAAA,SAAAA,EAAW,IAAKA,CAAAA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAKA,CAAAA,UAAAA;AACjBC,MAAAA,SAAAA,EAAW,IAAKA,CAAAA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAKA,CAAAA,UAAAA;AACjBE,MAAAA,UAAAA,EAAY,IAAKA,CAAAA;AACnB,KAAA;AACF;AAEAO,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"counter.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\n\nexport class RetryCounter extends Serializable {\n  public remaining: number;\n  protected readonly maxRetries: number;\n  protected lastError?: Error;\n  protected finalError?: Error;\n\n  constructor(\n    maxRetries = 0,\n    protected ErrorClass: typeof FrameworkError,\n  ) {\n    super();\n    this.maxRetries = maxRetries;\n    this.remaining = maxRetries;\n  }\n\n  use(error?: Error) {\n    if (this.finalError) {\n      throw this.finalError;\n    }\n\n    this.lastError = error ?? this.lastError;\n    this.remaining--;\n    if (this.remaining < 0) {\n      this.finalError = new this.ErrorClass(\n        `Maximal amount of global retries (${this.maxRetries}) has been reached.`,\n        this.lastError ? [this.lastError] : undefined,\n        { isFatal: true, isRetryable: false },\n      );\n      throw this.finalError;\n    }\n  }\n\n  createSnapshot() {\n    return {\n      remaining: this.remaining,\n      maxRetries: this.maxRetries,\n      lastError: this.lastError,\n      finalError: this.finalError,\n      ErrorClass: this.ErrorClass,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/internals/helpers/counter.d.cts

@@ -0,0 +1,40 @@
+import { FrameworkError } from '../../errors.cjs';
+import { Serializable } from '../serializable.cjs';
+import '../types.cjs';
+import './guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class RetryCounter extends Serializable {
+    protected ErrorClass: typeof FrameworkError;
+    remaining: number;
+    protected readonly maxRetries: number;
+    protected lastError?: Error;
+    protected finalError?: Error;
+    constructor(maxRetries: number | undefined, ErrorClass: typeof FrameworkError);
+    use(error?: Error): void;
+    createSnapshot(): {
+        remaining: number;
+        maxRetries: number;
+        lastError: Error | undefined;
+        finalError: Error | undefined;
+        ErrorClass: typeof FrameworkError;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { RetryCounter };

package/dist/internals/helpers/counter.d.ts

@@ -0,0 +1,40 @@
+import { FrameworkError } from '../../errors.js';
+import { Serializable } from '../serializable.js';
+import '../types.js';
+import './guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class RetryCounter extends Serializable {
+    protected ErrorClass: typeof FrameworkError;
+    remaining: number;
+    protected readonly maxRetries: number;
+    protected lastError?: Error;
+    protected finalError?: Error;
+    constructor(maxRetries: number | undefined, ErrorClass: typeof FrameworkError);
+    use(error?: Error): void;
+    createSnapshot(): {
+        remaining: number;
+        maxRetries: number;
+        lastError: Error | undefined;
+        finalError: Error | undefined;
+        ErrorClass: typeof FrameworkError;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { RetryCounter };

package/dist/internals/helpers/counter.js

@@ -0,0 +1,51 @@
+import { Serializable } from '../serializable.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class RetryCounter extends Serializable {
+  static {
+    __name(this, "RetryCounter");
+  }
+  ErrorClass;
+  remaining;
+  maxRetries;
+  lastError;
+  finalError;
+  constructor(maxRetries = 0, ErrorClass) {
+    super(), this.ErrorClass = ErrorClass;
+    this.maxRetries = maxRetries;
+    this.remaining = maxRetries;
+  }
+  use(error) {
+    if (this.finalError) {
+      throw this.finalError;
+    }
+    this.lastError = error ?? this.lastError;
+    this.remaining--;
+    if (this.remaining < 0) {
+      this.finalError = new this.ErrorClass(`Maximal amount of global retries (${this.maxRetries}) has been reached.`, this.lastError ? [
+        this.lastError
+      ] : void 0, {
+        isFatal: true,
+        isRetryable: false
+      });
+      throw this.finalError;
+    }
+  }
+  createSnapshot() {
+    return {
+      remaining: this.remaining,
+      maxRetries: this.maxRetries,
+      lastError: this.lastError,
+      finalError: this.finalError,
+      ErrorClass: this.ErrorClass
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+export { RetryCounter };
+//# sourceMappingURL=counter.js.map
+//# sourceMappingURL=counter.js.map

package/dist/internals/helpers/counter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/counter.ts"],"names":["RetryCounter","Serializable","remaining","maxRetries","lastError","finalError","constructor","ErrorClass","use","error","undefined","isFatal","isRetryable","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;AAmBO,MAAMA,qBAAqBC,YAAAA,CAAAA;EAnBlC;;;;AAoBSC,EAAAA,SAAAA;AACYC,EAAAA,UAAAA;AACTC,EAAAA,SAAAA;AACAC,EAAAA,UAAAA;EAEVC,WACEH,CAAAA,UAAAA,GAAa,GACHI,UACV,EAAA;AACA,IAAK,KAAA,EAAA,EAAA,KAFKA,UAAAA,GAAAA,UAAAA;AAGV,IAAA,IAAA,CAAKJ,UAAaA,GAAAA,UAAAA;AAClB,IAAA,IAAA,CAAKD,SAAYC,GAAAA,UAAAA;AACnB;AAEAK,EAAAA,GAAAA,CAAIC,KAAe,EAAA;AACjB,IAAA,IAAI,KAAKJ,UAAY,EAAA;AACnB,MAAA,MAAM,IAAKA,CAAAA,UAAAA;AACb;AAEA,IAAKD,IAAAA,CAAAA,SAAAA,GAAYK,SAAS,IAAKL,CAAAA,SAAAA;AAC/B,IAAKF,IAAAA,CAAAA,SAAAA,EAAAA;AACL,IAAI,IAAA,IAAA,CAAKA,YAAY,CAAG,EAAA;AACtB,MAAKG,IAAAA,CAAAA,UAAAA,GAAa,IAAI,IAAKE,CAAAA,UAAAA,CACzB,qCAAqC,IAAKJ,CAAAA,UAAU,CACpD,mBAAA,CAAA,EAAA,IAAA,CAAKC,SAAY,GAAA;QAAC,IAAKA,CAAAA;UAAaM,KACpC,CAAA,EAAA;QAAEC,OAAS,EAAA,IAAA;QAAMC,WAAa,EAAA;OAAM,CAAA;AAEtC,MAAA,MAAM,IAAKP,CAAAA,UAAAA;AACb;AACF;EAEAQ,cAAiB,GAAA;AACf,IAAO,OAAA;AACLX,MAAAA,SAAAA,EAAW,IAAKA,CAAAA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAKA,CAAAA,UAAAA;AACjBC,MAAAA,SAAAA,EAAW,IAAKA,CAAAA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAKA,CAAAA,UAAAA;AACjBE,MAAAA,UAAAA,EAAY,IAAKA,CAAAA;AACnB,KAAA;AACF;AAEAO,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"counter.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\n\nexport class RetryCounter extends Serializable {\n  public remaining: number;\n  protected readonly maxRetries: number;\n  protected lastError?: Error;\n  protected finalError?: Error;\n\n  constructor(\n    maxRetries = 0,\n    protected ErrorClass: typeof FrameworkError,\n  ) {\n    super();\n    this.maxRetries = maxRetries;\n    this.remaining = maxRetries;\n  }\n\n  use(error?: Error) {\n    if (this.finalError) {\n      throw this.finalError;\n    }\n\n    this.lastError = error ?? this.lastError;\n    this.remaining--;\n    if (this.remaining < 0) {\n      this.finalError = new this.ErrorClass(\n        `Maximal amount of global retries (${this.maxRetries}) has been reached.`,\n        this.lastError ? [this.lastError] : undefined,\n        { isFatal: true, isRetryable: false },\n      );\n      throw this.finalError;\n    }\n  }\n\n  createSnapshot() {\n    return {\n      remaining: this.remaining,\n      maxRetries: this.maxRetries,\n      lastError: this.lastError,\n      finalError: this.finalError,\n      ErrorClass: this.ErrorClass,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/internals/helpers/general.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var promises = require('node:timers/promises');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+async function* sleep(ms, signal) {
+  const start = Date.now();
+  const ctx = {
+    iteration: 0,
+    elapsed: 0
+  };
+  while (true) {
+    await promises.setTimeout(ms, {
+      signal
+    });
+    ctx.elapsed = Date.now() - start;
+    ctx.iteration++;
+    yield ctx;
+  }
+}
+__name(sleep, "sleep");
+function validate(value, schema) {
+  schema.parse(value);
+}
+__name(validate, "validate");
+
+exports.sleep = sleep;
+exports.validate = validate;
+//# sourceMappingURL=general.cjs.map
+//# sourceMappingURL=general.cjs.map

package/dist/internals/helpers/general.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/general.ts"],"names":["sleep","ms","signal","start","Date","now","ctx","iteration","elapsed","setTimeout","validate","value","schema","parse"],"mappings":";;;;;;AAmBA,gBAAuBA,KAAAA,CAAMC,IAAYC,MAAoB,EAAA;AAC3D,EAAMC,MAAAA,KAAAA,GAAQC,KAAKC,GAAG,EAAA;AACtB,EAAA,MAAMC,GAAM,GAAA;IAAEC,SAAW,EAAA,CAAA;IAAGC,OAAS,EAAA;AAAE,GAAA;AACvC,EAAA,OAAO,IAAM,EAAA;AACX,IAAA,MAAMC,oBAAWR,EAAI,EAAA;AACnBC,MAAAA;KACF,CAAA;AACAI,IAAIE,GAAAA,CAAAA,OAAAA,GAAUJ,IAAKC,CAAAA,GAAAA,EAAQF,GAAAA,KAAAA;AAC3BG,IAAIC,GAAAA,CAAAA,SAAAA,EAAAA;AACJ,IAAMD,MAAAA,GAAAA;AACR;AACF;AAXuBN,MAAAA,CAAAA,KAAAA,EAAAA,OAAAA,CAAAA;AAahB,SAASU,QAAAA,CAAYC,OAAgBC,MAAkB,EAAA;AAC5DA,EAAAA,MAAAA,CAAOC,MAAMF,KAAAA,CAAAA;AACf;AAFgBD,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA","file":"general.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { setTimeout } from \"node:timers/promises\";\nimport { ZodType } from \"zod\";\n\nexport async function* sleep(ms: number, signal?: AbortSignal) {\n  const start = Date.now();\n  const ctx = { iteration: 0, elapsed: 0 };\n  while (true) {\n    await setTimeout(ms, {\n      signal,\n    });\n    ctx.elapsed = Date.now() - start;\n    ctx.iteration++;\n    yield ctx;\n  }\n}\n\nexport function validate<T>(value: unknown, schema: ZodType<T>): asserts value is T {\n  schema.parse(value);\n}\n"]}

package/dist/internals/helpers/general.d.cts

@@ -0,0 +1,25 @@
+import { ZodType } from 'zod';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function sleep(ms: number, signal?: AbortSignal): AsyncGenerator<{
+    iteration: number;
+    elapsed: number;
+}, void, unknown>;
+declare function validate<T>(value: unknown, schema: ZodType<T>): asserts value is T;
+
+export { sleep, validate };

package/dist/internals/helpers/general.d.ts

@@ -0,0 +1,25 @@
+import { ZodType } from 'zod';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function sleep(ms: number, signal?: AbortSignal): AsyncGenerator<{
+    iteration: number;
+    elapsed: number;
+}, void, unknown>;
+declare function validate<T>(value: unknown, schema: ZodType<T>): asserts value is T;
+
+export { sleep, validate };

package/dist/internals/helpers/general.js

@@ -0,0 +1,28 @@
+import { setTimeout } from 'node:timers/promises';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+async function* sleep(ms, signal) {
+  const start = Date.now();
+  const ctx = {
+    iteration: 0,
+    elapsed: 0
+  };
+  while (true) {
+    await setTimeout(ms, {
+      signal
+    });
+    ctx.elapsed = Date.now() - start;
+    ctx.iteration++;
+    yield ctx;
+  }
+}
+__name(sleep, "sleep");
+function validate(value, schema) {
+  schema.parse(value);
+}
+__name(validate, "validate");
+
+export { sleep, validate };
+//# sourceMappingURL=general.js.map
+//# sourceMappingURL=general.js.map

package/dist/internals/helpers/general.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/general.ts"],"names":["sleep","ms","signal","start","Date","now","ctx","iteration","elapsed","setTimeout","validate","value","schema","parse"],"mappings":";;;;AAmBA,gBAAuBA,KAAAA,CAAMC,IAAYC,MAAoB,EAAA;AAC3D,EAAMC,MAAAA,KAAAA,GAAQC,KAAKC,GAAG,EAAA;AACtB,EAAA,MAAMC,GAAM,GAAA;IAAEC,SAAW,EAAA,CAAA;IAAGC,OAAS,EAAA;AAAE,GAAA;AACvC,EAAA,OAAO,IAAM,EAAA;AACX,IAAA,MAAMC,WAAWR,EAAI,EAAA;AACnBC,MAAAA;KACF,CAAA;AACAI,IAAIE,GAAAA,CAAAA,OAAAA,GAAUJ,IAAKC,CAAAA,GAAAA,EAAQF,GAAAA,KAAAA;AAC3BG,IAAIC,GAAAA,CAAAA,SAAAA,EAAAA;AACJ,IAAMD,MAAAA,GAAAA;AACR;AACF;AAXuBN,MAAAA,CAAAA,KAAAA,EAAAA,OAAAA,CAAAA;AAahB,SAASU,QAAAA,CAAYC,OAAgBC,MAAkB,EAAA;AAC5DA,EAAAA,MAAAA,CAAOC,MAAMF,KAAAA,CAAAA;AACf;AAFgBD,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA","file":"general.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { setTimeout } from \"node:timers/promises\";\nimport { ZodType } from \"zod\";\n\nexport async function* sleep(ms: number, signal?: AbortSignal) {\n  const start = Date.now();\n  const ctx = { iteration: 0, elapsed: 0 };\n  while (true) {\n    await setTimeout(ms, {\n      signal,\n    });\n    ctx.elapsed = Date.now() - start;\n    ctx.iteration++;\n    yield ctx;\n  }\n}\n\nexport function validate<T>(value: unknown, schema: ZodType<T>): asserts value is T {\n  schema.parse(value);\n}\n"]}

package/dist/internals/helpers/guards.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var R = require('remeda');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var R__namespace = /*#__PURE__*/_interopNamespace(R);
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function isPrimitive(value) {
+  return R__namespace.isString(value) || R__namespace.isNumber(value) || R__namespace.isBoolean(value) || R__namespace.isNullish(value) || R__namespace.isSymbol(value);
+}
+__name(isPrimitive, "isPrimitive");
+
+exports.isPrimitive = isPrimitive;
+//# sourceMappingURL=guards.cjs.map
+//# sourceMappingURL=guards.cjs.map

package/dist/internals/helpers/guards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/guards.ts"],"names":["isPrimitive","value","R","isString","isNumber","isBoolean","isNullish","isSymbol"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAmBO,SAASA,YAAYC,KAAc,EAAA;AACxC,EAAA,OACEC,aAAEC,QAASF,CAAAA,KAAAA,KACXC,YAAEE,CAAAA,QAAAA,CAASH,KAAAA,CACXC,IAAAA,YAAAA,CAAEG,SAAUJ,CAAAA,KAAAA,KACZC,YAAEI,CAAAA,SAAAA,CAAUL,KAAAA,CACZC,IAAAA,YAAAA,CAAEK,SAASN,KAAAA,CAAAA;AAEf;AARgBD,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"guards.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as R from \"remeda\";\n\nexport type Primitive = string | number | symbol | bigint | boolean | null | undefined;\nexport function isPrimitive(value: unknown): value is Primitive {\n  return (\n    R.isString(value) ||\n    R.isNumber(value) ||\n    R.isBoolean(value) ||\n    R.isNullish(value) ||\n    R.isSymbol(value)\n  );\n}\n"]}