beeai-framework 0.1.15 → 0.1.17

package/dist/internals/fetcher.js

@@ -39,15 +39,15 @@ class RestfulClient extends Serializable {
     __name(this, "RestfulClient");
   }
   input;
-  emitter;
+  emitter = Emitter.root.child({
+    namespace: [
+      "internals",
+      "restfulClient"
+    ],
+    creator: this
+  });
   constructor(input) {
-    super(), this.input = input, this.emitter = Emitter.root.child({
-      namespace: [
-        "internals",
-        "restfulClient"
-      ],
-      creator: this
-    });
+    super(), this.input = input;
   }
   async *stream(path, init) {
     const emitter = this.emitter.child({

package/dist/internals/fetcher.js.map

@@ -1 +1 @@
-{"version":3,"sources":["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","groupId","url","getUrl","options","method","headers","getHeaders","emit","emitterToGenerator","fetchEventSource","onopen","response","contentType","get","ok","includes","EventStreamContentType","context","err","text","isRetryable","status","onmessage","msg","event","onclose","onerror","then","catch","error","doNothing","finally","fetch","target","searchParams","json","extra","final","override","filter","isTruthy","Headers","assign","fromEntries","URL","baseUrl","extraPath","paths","pathname","endsWith","replace","createSnapshot","shallowCopy","loadSnapshot","snapshot"],"mappings":"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","file":"fetcher.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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, isArray, isPlainObject, isTruthy } 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<HeadersInit>;\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 emitter = this.emitter.child({\n      groupId: \"stream\",\n    });\n\n    const input: StreamInput = {\n      url: this.getUrl(path).toString(),\n      options: {\n        method: \"POST\",\n        ...init,\n        headers: await this.getHeaders(init?.headers),\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          const contentType = response.headers.get(\"content-type\") || \"\";\n          if (response.ok && contentType.includes(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 target = this.getUrl(path);\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 this.getHeaders(init?.headers),\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  protected async getHeaders(extra?: HeadersInit): Promise<Record<string, string>> {\n    const final = {};\n    for (const override of [await this.input.headers?.(), extra].filter(isTruthy)) {\n      if (isArray(override) || override instanceof Headers) {\n        Object.assign(final, Object.fromEntries(override.entries()));\n      } else {\n        Object.assign(final, override);\n      }\n    }\n    return final;\n  }\n\n  protected getUrl(path: keyof K): URL {\n    const url = new URL(this.input.baseUrl);\n    const extraPath = this.input.paths[path] ?? path;\n    if (url.pathname.endsWith(\"/\")) {\n      url.pathname += extraPath.replace(/^\\//, \"\");\n    } else {\n      url.pathname += extraPath;\n    }\n    return url;\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"]}
+{"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","Emitter","root","child","namespace","creator","input","stream","path","init","groupId","url","getUrl","options","method","headers","getHeaders","emit","emitterToGenerator","fetchEventSource","onopen","response","contentType","get","ok","includes","EventStreamContentType","context","err","text","isRetryable","status","onmessage","msg","event","onclose","onerror","then","catch","error","doNothing","finally","fetch","target","searchParams","json","extra","final","override","filter","isTruthy","Headers","assign","fromEntries","URL","baseUrl","extraPath","paths","pathname","endsWith","replace","createSnapshot","shallowCopy","loadSnapshot","snapshot"],"mappings":";;;;;;;;;;AAkBO,MAAMA,2BAA2BC,cAAAA,CAAAA;EAlBxC;;;AAkBwD;AAGjD,SAASC,gBACdC,IAAAA,EAAyE;AAEzE,EAAA,MAAMC,cAAAA,GAAiB,IAAIC,eAAAA,EAAAA;AAC3B,EAAA,KAAA,MAAW,CAACC,GAAAA,EAAKC,KAAAA,KAAUC,MAAAA,CAAOC,OAAAA,CAAQN,IAAAA,CAAAA,EAAO;AAC/C,IAAA,IAAII,UAAUG,MAAAA,EAAW;AACvB,MAAA;AACF;AAEA,IAAA,IAAIC,KAAAA,CAAMC,OAAAA,CAAQL,KAAAA,CAAAA,EAAQ;AACxBA,MAAAA,KAAAA,CAAMM,OAAAA,CAAQ,CAACC,CAAAA,KAAAA;AACb,QAAA,IAAIA,MAAMJ,MAAAA,EAAW;AACnBN,UAAAA,cAAAA,CAAeW,MAAAA,CAAOT,GAAAA,EAAKU,MAAAA,CAAOF,CAAAA,CAAAA,CAAAA;AACpC;OACF,CAAA;KACF,MAAA,IAAWG,aAAAA,CAAcV,KAAAA,CAAAA,EAAQ;AAC/BH,MAAAA,cAAAA,CAAec,IAAIZ,GAAAA,EAAKJ,eAAAA,CAAgBK,KAAAA,CAAAA,CAAOY,UAAQ,CAAA;KACzD,MAAO;AACLf,MAAAA,cAAAA,CAAec,GAAAA,CAAIZ,GAAAA,EAAKU,MAAAA,CAAOT,KAAAA,CAAAA,CAAAA;AACjC;AACF;AACA,EAAA,OAAOH,cAAAA;AACT;AAtBgBF,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAgDT,MAAMkB,sBAAwDC,YAAAA,CAAAA;EArErE;;;;EAsEkBC,OAAAA,GAAUC,OAAAA,CAAQC,KAAKC,KAAAA,CAA2B;IAChEC,SAAAA,EAAW;AAAC,MAAA,WAAA;AAAa,MAAA;;IACzBC,OAAAA,EAAS;GACX,CAAA;AAEA,EAAA,WAAA,CACYC,KAAAA,EAKV;AACA,IAAA,KAAA,EAAK,EAAA,KANKA,KAAAA,GAAAA,KAAAA;AAOZ;EAEA,OAAOC,MAAAA,CACLC,MACAC,IAAAA,EACgD;AAChD,IAAA,MAAMT,OAAAA,GAAU,IAAA,CAAKA,OAAAA,CAAQG,KAAAA,CAAM;MACjCO,OAAAA,EAAS;KACX,CAAA;AAEA,IAAA,MAAMJ,KAAAA,GAAqB;AACzBK,MAAAA,GAAAA,EAAK,IAAA,CAAKC,MAAAA,CAAOJ,IAAAA,CAAAA,CAAMX,QAAAA,EAAQ;MAC/BgB,OAAAA,EAAS;QACPC,MAAAA,EAAQ,MAAA;QACR,GAAGL,IAAAA;AACHM,QAAAA,OAAAA,EAAS,MAAM,IAAA,CAAKC,UAAAA,CAAWP,IAAAA,EAAMM,OAAAA;AACvC;AACF,KAAA;AACA,IAAA,MAAMf,OAAAA,CAAQiB,KAAK,aAAA,EAAe;AAAEX,MAAAA;KAAM,CAAA;AAE1C,IAAA,OAAO,OAAOY,mBAAmB,OAAO,EAAED,MAAI,KAC5CE,gBAAAA,CAAiBb,MAAMK,GAAAA,EAAK;AAC1B,MAAA,GAAGL,KAAAA,CAAMO,OAAAA;AACT,MAAA,MAAMO,OAAOC,QAAAA,EAAQ;AACnB,QAAA,MAAMC,WAAAA,GAAcD,QAAAA,CAASN,OAAAA,CAAQQ,GAAAA,CAAI,cAAA,CAAA,IAAmB,EAAA;AAC5D,QAAA,IAAIF,QAAAA,CAASG,EAAAA,IAAMF,WAAAA,CAAYG,QAAAA,CAASC,sBAAAA,CAAAA,EAAyB;AAC/D,UAAA,MAAM1B,OAAAA,CAAQiB,KAAK,YAAA,EAAc;AAAEX,YAAAA;WAAM,CAAA;AACzC,UAAA;AACF;AACA,QAAA,MAAM,IAAI5B,kBAAAA,CAAmB,mBAAA,EAAqB,EAAA,EAAI;UACpDiD,OAAAA,EAAS;AACPhB,YAAAA,GAAAA,EAAKU,QAAAA,CAASV,GAAAA;YACdiB,GAAAA,EAAK,MAAMP,SAASQ,IAAAA,EAAI;AACxBR,YAAAA;AACF,WAAA;AACAS,UAAAA,WAAAA,EAAaT,SAASU,MAAAA,IAAU,GAAA,IAAOV,SAASU,MAAAA,GAAS,GAAA,IAAOV,SAASU,MAAAA,KAAW;SACtF,CAAA;AACF,OAAA;AACA,MAAA,MAAMC,UAAUC,GAAAA,EAAG;AACjB,QAAA,IAAIA,GAAAA,EAAKC,UAAU,OAAA,EAAS;AAC1B,UAAA,MAAM,IAAIxD,kBAAAA,CAAmB,CAAA,oCAAA,CAAA,EAAwC,EAAA,EAAI;YACvEiD,OAAAA,EAASM;WACX,CAAA;AACF;AACA,QAAA,MAAMjC,OAAAA,CAAQiB,KAAK,eAAA,EAAiB;AAAEX,UAAAA,KAAAA;UAAOzB,IAAAA,EAAMoD;SAAI,CAAA;AACvDhB,QAAAA,IAAAA,CAAKgB,GAAAA,CAAAA;AACP,OAAA;MACAE,OAAAA,GAAAA;AAAW,OAAA;AACXC,MAAAA,OAAAA,CAAQR,GAAAA,EAAG;AACT,QAAA,MAAM,IAAIlD,mBAAmB,CAAA,oCAAA,CAAA,EAAwC;AAACkD,UAAAA;AAAI,SAAA,CAAA;AAC5E;AACF,KAAA,CAAA,CACGS,IAAAA,CAAK,MAAMrC,OAAAA,CAAQiB,KAAK,eAAA,EAAiB;AAAEX,MAAAA;AAAM,KAAA,CAAA,CAAA,CACjDgC,KAAAA,CAAM,OAAOC,KAAAA,KAAAA;AACZ,MAAA,MAAMvC,OAAAA,CAAQiB,KAAK,aAAA,EAAe;AAAEX,QAAAA,KAAAA;AAAOiC,QAAAA;OAAM,CAAA,CAAGD,KAAAA,CAAME,SAAAA,EAAAA,CAAAA;AAC1D,MAAA,MAAMD,KAAAA;AACR,KAAA,CAAA,CACCE,OAAAA,CAAQ,MAAMzC,OAAAA,CAAQiB,KAAK,YAAA,EAAc;AAAEX,MAAAA;AAAM,KAAA,CAAA,CAAA,CAAA;AAExD;EAEA,MAAMoC,KAAAA,CAAMlC,MAAeC,IAAAA,EAAyD;AAClF,IAAA,MAAMT,OAAAA,GAAU,IAAA,CAAKA,OAAAA,CAAQG,KAAAA,CAAM;MACjCO,OAAAA,EAAS;KACX,CAAA;AAEA,IAAA,MAAMiC,MAAAA,GAAS,IAAA,CAAK/B,MAAAA,CAAOJ,IAAAA,CAAAA;AAC3B,IAAA,IAAIC,MAAMmC,YAAAA,EAAc;AACtB,MAAA,KAAA,MAAW,CAAC5D,GAAAA,EAAKC,KAAAA,CAAAA,IAAUwB,KAAKmC,YAAAA,EAAc;AAC5CD,QAAAA,MAAAA,CAAOC,YAAAA,CAAahD,GAAAA,CAAIZ,GAAAA,EAAKC,KAAAA,CAAAA;AAC/B;AACF;AAEA,IAAA,MAAMqB,KAAAA,GAAoB;AACxBK,MAAAA,GAAAA,EAAKgC,OAAO9C,QAAAA,EAAQ;MACpBgB,OAAAA,EAAS;QACP,GAAGJ,IAAAA;AACHM,QAAAA,OAAAA,EAAS,MAAM,IAAA,CAAKC,UAAAA,CAAWP,IAAAA,EAAMM,OAAAA;AACvC;AACF,KAAA;AAEA,IAAA,MAAMf,OAAAA,CAAQiB,KAAK,YAAA,EAAc;AAAEX,MAAAA;KAAM,CAAA;AACzC,IAAA,IAAI;AACF,MAAA,MAAMe,WAAW,MAAMqB,KAAAA,CAAMpC,KAAAA,CAAMK,GAAAA,EAAKL,MAAMO,OAAO,CAAA;AAErD,MAAA,IAAI,CAACQ,SAASG,EAAAA,EAAI;AAChB,QAAA,MAAM,IAAI9C,kBAAAA,CAAmB,kBAAA,EAAoB,EAAA,EAAI;UACnDiD,OAAAA,EAAS;AACPhB,YAAAA,GAAAA,EAAKU,QAAAA,CAASV,GAAAA;YACd4B,KAAAA,EAAO,MAAMlB,SAASQ,IAAAA,EAAI;AAC1BR,YAAAA;AACF,WAAA;UACAS,WAAAA,EAAa;AAAC,YAAA,GAAA;AAAK,YAAA;YAAKL,QAAAA,CAASJ,QAAAA,CAASU,UAAU,GAAA;SACtD,CAAA;AACF;AAEA,MAAA,MAAMlD,IAAAA,GAAO,MAAMwC,QAAAA,CAASwB,IAAAA,EAAI;AAChC,MAAA,MAAM7C,OAAAA,CAAQiB,KAAK,cAAA,EAAgB;AAAEI,QAAAA,QAAAA;AAAUxC,QAAAA,IAAAA;AAAMyB,QAAAA;OAAM,CAAA;AAC3D,MAAA,OAAOzB,IAAAA;AACT,KAAA,CAAA,OAAS0D,KAAAA,EAAO;AACd,MAAA,MAAMvC,OAAAA,CAAQiB,KAAK,YAAA,EAAc;AAAEsB,QAAAA,KAAAA;AAAOjC,QAAAA;OAAa,CAAA;AACvD,MAAA,MAAMiC,KAAAA;KACR,SAAA;AACE,MAAA,MAAMvC,OAAAA,CAAQiB,KAAK,WAAA,EAAa;AAAEX,QAAAA;OAAa,CAAA;AACjD;AACF;AAEA,EAAA,MAAgBU,WAAW8B,KAAAA,EAAsD;AAC/E,IAAA,MAAMC,QAAQ,EAAC;AACf,IAAA,KAAA,MAAWC,QAAAA,IAAY;MAAC,MAAM,IAAA,CAAK1C,MAAMS,OAAAA,IAAO;AAAM+B,MAAAA;AAAOG,KAAAA,CAAAA,MAAAA,CAAOC,QAAAA,CAAAA,EAAW;AAC7E,MAAA,IAAI5D,OAAAA,CAAQ0D,QAAAA,CAAAA,IAAaA,QAAAA,YAAoBG,OAAAA,EAAS;AACpDjE,QAAAA,MAAAA,CAAOkE,OAAOL,KAAAA,EAAO7D,MAAAA,CAAOmE,YAAYL,QAAAA,CAAS7D,OAAAA,EAAO,CAAA,CAAA;OAC1D,MAAO;AACLD,QAAAA,MAAAA,CAAOkE,MAAAA,CAAOL,OAAOC,QAAAA,CAAAA;AACvB;AACF;AACA,IAAA,OAAOD,KAAAA;AACT;AAEUnC,EAAAA,MAAAA,CAAOJ,IAAAA,EAAoB;AACnC,IAAA,MAAMG,GAAAA,GAAM,IAAI2C,GAAAA,CAAI,IAAA,CAAKhD,MAAMiD,OAAO,CAAA;AACtC,IAAA,MAAMC,SAAAA,GAAY,IAAA,CAAKlD,KAAAA,CAAMmD,KAAAA,CAAMjD,IAAAA,CAAAA,IAASA,IAAAA;AAC5C,IAAA,IAAIG,GAAAA,CAAI+C,QAAAA,CAASC,QAAAA,CAAS,GAAA,CAAA,EAAM;AAC9BhD,MAAAA,GAAAA,CAAI+C,QAAAA,IAAYF,SAAAA,CAAUI,OAAAA,CAAQ,KAAA,EAAO,EAAA,CAAA;KAC3C,MAAO;AACLjD,MAAAA,GAAAA,CAAI+C,QAAAA,IAAYF,SAAAA;AAClB;AACA,IAAA,OAAO7C,GAAAA;AACT;EAEAkD,cAAAA,GAAiB;AACf,IAAA,OAAO;MACLvD,KAAAA,EAAOwD,WAAAA,CAAY,KAAKxD,KAAK,CAAA;AAC7BN,MAAAA,OAAAA,EAAS,IAAA,CAAKA;AAChB,KAAA;AACF;AAEA+D,EAAAA,YAAAA,CAAaC,QAAAA,EAAwD;AACnE9E,IAAAA,MAAAA,CAAOkE,MAAAA,CAAO,MAAMY,QAAAA,CAAAA;AACtB;AACF","file":"fetcher.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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, isArray, isPlainObject, isTruthy } 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<HeadersInit>;\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 emitter = this.emitter.child({\n      groupId: \"stream\",\n    });\n\n    const input: StreamInput = {\n      url: this.getUrl(path).toString(),\n      options: {\n        method: \"POST\",\n        ...init,\n        headers: await this.getHeaders(init?.headers),\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          const contentType = response.headers.get(\"content-type\") || \"\";\n          if (response.ok && contentType.includes(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 target = this.getUrl(path);\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 this.getHeaders(init?.headers),\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  protected async getHeaders(extra?: HeadersInit): Promise<Record<string, string>> {\n    const final = {};\n    for (const override of [await this.input.headers?.(), extra].filter(isTruthy)) {\n      if (isArray(override) || override instanceof Headers) {\n        Object.assign(final, Object.fromEntries(override.entries()));\n      } else {\n        Object.assign(final, override);\n      }\n    }\n    return final;\n  }\n\n  protected getUrl(path: keyof K): URL {\n    const url = new URL(this.input.baseUrl);\n    const extraPath = this.input.paths[path] ?? path;\n    if (url.pathname.endsWith(\"/\")) {\n      url.pathname += extraPath.replace(/^\\//, \"\");\n    } else {\n      url.pathname += extraPath;\n    }\n    return url;\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.map

@@ -1 +1 @@
-{"version":3,"sources":["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,EAAI,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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/array.ts"],"names":["removeFromArray","arr","target","index","findIndex","value","splice","castArray","result","Array","isArray","hasMinLength","n","length"],"mappings":";;;;AAKO,SAASA,eAAAA,CAAmBC,KAAUC,MAAAA,EAAS;AACpD,EAAA,MAAMC,QAAQF,GAAAA,CAAIG,SAAAA,CAAU,CAACC,KAAAA,KAAUA,UAAUH,MAAAA,CAAAA;AACjD,EAAA,IAAIC,UAAU,EAAA,EAAI;AAChB,IAAA,OAAO,KAAA;AACT;AAEAF,EAAAA,GAAAA,CAAIK,MAAAA,CAAOH,OAAO,CAAA,CAAA;AAClB,EAAA,OAAO,IAAA;AACT;AARgBH,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAUT,SAASO,UAAaN,GAAAA,EAAM;AACjC,EAAA,MAAMO,MAAAA,GAASC,KAAAA,CAAMC,OAAAA,CAAQT,GAAAA,IAAOA,GAAAA,GAAM;AAACA,IAAAA;;AAC3C,EAAA,OAAOO,MAAAA;AACT;AAHgBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAST,SAASI,YAAAA,CAAkCV,KAAUW,CAAAA,EAAI;AAC9D,EAAA,OAAOX,IAAIY,MAAAA,IAAUD,CAAAA;AACvB;AAFgBD,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA","file":"array.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function removeFromArray<T>(arr: T[], target: T): boolean;
 declare function castArray<T>(arr: T): T extends unknown[] ? T : [T];

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function removeFromArray<T>(arr: T[], target: T): boolean;
 declare function castArray<T>(arr: T): T extends unknown[] ? T : [T];

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

@@ -1 +1 @@
-{"version":3,"sources":["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,EAAI,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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/array.ts"],"names":["removeFromArray","arr","target","index","findIndex","value","splice","castArray","result","Array","isArray","hasMinLength","n","length"],"mappings":";;AAKO,SAASA,eAAAA,CAAmBC,KAAUC,MAAAA,EAAS;AACpD,EAAA,MAAMC,QAAQF,GAAAA,CAAIG,SAAAA,CAAU,CAACC,KAAAA,KAAUA,UAAUH,MAAAA,CAAAA;AACjD,EAAA,IAAIC,UAAU,EAAA,EAAI;AAChB,IAAA,OAAO,KAAA;AACT;AAEAF,EAAAA,GAAAA,CAAIK,MAAAA,CAAOH,OAAO,CAAA,CAAA;AAClB,EAAA,OAAO,IAAA;AACT;AARgBH,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAUT,SAASO,UAAaN,GAAAA,EAAM;AACjC,EAAA,MAAMO,MAAAA,GAASC,KAAAA,CAAMC,OAAAA,CAAQT,GAAAA,IAAOA,GAAAA,GAAM;AAACA,IAAAA;;AAC3C,EAAA,OAAOO,MAAAA;AACT;AAHgBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAST,SAASI,YAAAA,CAAkCV,KAAUW,CAAAA,EAAI;AAC9D,EAAA,OAAOX,IAAIY,MAAAA,IAAUD,CAAAA;AACvB;AAFgBD,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA","file":"array.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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.map

@@ -1 +1 @@
-{"version":3,"sources":["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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/cancellation.ts"],"names":["createAbortController","signals","controller","AbortController","registerSignals","forEach","signal","aborted","abort","reason","addEventListener","once"],"mappings":";;;;AAKO,SAASA,yBAAyBC,OAAAA,EAAoC;AAC3E,EAAA,MAAMC,UAAAA,GAAa,IAAIC,eAAAA,EAAAA;AACvBC,EAAAA,eAAAA,CAAgBF,YAAYD,OAAAA,CAAAA;AAC5B,EAAA,OAAOC,UAAAA;AACT;AAJgBF,MAAAA,CAAAA,qBAAAA,EAAAA,uBAAAA,CAAAA;AAMT,SAASI,eAAAA,CAAgBF,YAA6BD,OAAAA,EAAoC;AAC/FA,EAAAA,OAAAA,CAAQI,OAAAA,CAAQ,CAACC,MAAAA,KAAAA;AACf,IAAA,IAAIA,QAAQC,OAAAA,EAAS;AACnBL,MAAAA,UAAAA,CAAWM,KAAAA,CAAMF,OAAOG,MAAM,CAAA;AAChC;AAEAH,IAAAA,MAAAA,EAAQI,gBAAAA,GACN,SACA,MAAA;AACER,MAAAA,UAAAA,CAAWM,KAAAA,CAAMF,QAAQG,MAAAA,CAAAA;KAC3B,EACA;MACEE,IAAAA,EAAM,IAAA;AACNL,MAAAA,MAAAA,EAAQJ,UAAAA,CAAWI;KACrB,CAAA;GAEJ,CAAA;AACF;AAjBgBF,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA","file":"cancellation.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function createAbortController(...signals: (AbortSignal | undefined)[]): AbortController;
 declare function registerSignals(controller: AbortController, signals: (AbortSignal | undefined)[]): void;

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function createAbortController(...signals: (AbortSignal | undefined)[]): AbortController;
 declare function registerSignals(controller: AbortController, signals: (AbortSignal | undefined)[]): void;

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

@@ -1 +1 @@
-{"version":3,"sources":["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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/cancellation.ts"],"names":["createAbortController","signals","controller","AbortController","registerSignals","forEach","signal","aborted","abort","reason","addEventListener","once"],"mappings":";;AAKO,SAASA,yBAAyBC,OAAAA,EAAoC;AAC3E,EAAA,MAAMC,UAAAA,GAAa,IAAIC,eAAAA,EAAAA;AACvBC,EAAAA,eAAAA,CAAgBF,YAAYD,OAAAA,CAAAA;AAC5B,EAAA,OAAOC,UAAAA;AACT;AAJgBF,MAAAA,CAAAA,qBAAAA,EAAAA,uBAAAA,CAAAA;AAMT,SAASI,eAAAA,CAAgBF,YAA6BD,OAAAA,EAAoC;AAC/FA,EAAAA,OAAAA,CAAQI,OAAAA,CAAQ,CAACC,MAAAA,KAAAA;AACf,IAAA,IAAIA,QAAQC,OAAAA,EAAS;AACnBL,MAAAA,UAAAA,CAAWM,KAAAA,CAAMF,OAAOG,MAAM,CAAA;AAChC;AAEAH,IAAAA,MAAAA,EAAQI,gBAAAA,GACN,SACA,MAAA;AACER,MAAAA,UAAAA,CAAWM,KAAAA,CAAMF,QAAQG,MAAAA,CAAAA;KAC3B,EACA;MACEE,IAAAA,EAAM,IAAA;AACNL,MAAAA,MAAAA,EAAQJ,UAAAA,CAAWI;KACrB,CAAA;GAEJ,CAAA;AACF;AAjBgBF,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA","file":"cancellation.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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.map

@@ -1 +1 @@
-{"version":3,"sources":["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,MACpC,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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/counter.ts"],"names":["RetryCounter","Serializable","remaining","maxRetries","lastError","finalError","ErrorClass","use","error","undefined","isFatal","isRetryable","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;AAQO,MAAMA,qBAAqBC,6BAAAA,CAAAA;EARlC;;;;AASSC,EAAAA,SAAAA;AACYC,EAAAA,UAAAA;AACTC,EAAAA,SAAAA;AACAC,EAAAA,UAAAA;EAEV,WAAA,CACEF,UAAAA,GAAa,GACHG,UAAAA,EACV;AACA,IAAA,KAAA,EAAK,EAAA,KAFKA,UAAAA,GAAAA,UAAAA;AAGV,IAAA,IAAA,CAAKH,UAAAA,GAAaA,UAAAA;AAClB,IAAA,IAAA,CAAKD,SAAAA,GAAYC,UAAAA;AACnB;AAEAI,EAAAA,GAAAA,CAAIC,KAAAA,EAAe;AACjB,IAAA,IAAI,KAAKH,UAAAA,EAAY;AACnB,MAAA,MAAM,IAAA,CAAKA,UAAAA;AACb;AAEA,IAAA,IAAA,CAAKD,SAAAA,GAAYI,SAAS,IAAA,CAAKJ,SAAAA;AAC/B,IAAA,IAAA,CAAKF,SAAAA,EAAAA;AACL,IAAA,IAAI,IAAA,CAAKA,YAAY,CAAA,EAAG;AACtB,MAAA,IAAA,CAAKG,UAAAA,GAAa,IAAI,IAAA,CAAKC,UAAAA,CACzB,qCAAqC,IAAA,CAAKH,UAAU,CAAA,mBAAA,CAAA,EACpD,IAAA,CAAKC,SAAAA,GAAY;QAAC,IAAA,CAAKA;UAAaK,MAAAA,EACpC;QAAEC,OAAAA,EAAS,IAAA;QAAMC,WAAAA,EAAa;OAAM,CAAA;AAEtC,MAAA,MAAM,IAAA,CAAKN,UAAAA;AACb;AACF;EAEAO,cAAAA,GAAiB;AACf,IAAA,OAAO;AACLV,MAAAA,SAAAA,EAAW,IAAA,CAAKA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAA,CAAKA,UAAAA;AACjBC,MAAAA,SAAAA,EAAW,IAAA,CAAKA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAA,CAAKA,UAAAA;AACjBC,MAAAA,UAAAA,EAAY,IAAA,CAAKA;AACnB,KAAA;AACF;AAEAO,EAAAA,YAAAA,CAAaC,QAAAA,EAAkD;AAC7DC,IAAAA,MAAAA,CAAOC,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"counter.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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

@@ -5,18 +5,7 @@ import './guards.cjs';
 
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 
 declare class RetryCounter extends Serializable {

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

@@ -5,18 +5,7 @@ import './guards.js';
 
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 
 declare class RetryCounter extends Serializable {

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

@@ -1 +1 @@
-{"version":3,"sources":["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,MACpC,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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/counter.ts"],"names":["RetryCounter","Serializable","remaining","maxRetries","lastError","finalError","ErrorClass","use","error","undefined","isFatal","isRetryable","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;AAQO,MAAMA,qBAAqBC,YAAAA,CAAAA;EARlC;;;;AASSC,EAAAA,SAAAA;AACYC,EAAAA,UAAAA;AACTC,EAAAA,SAAAA;AACAC,EAAAA,UAAAA;EAEV,WAAA,CACEF,UAAAA,GAAa,GACHG,UAAAA,EACV;AACA,IAAA,KAAA,EAAK,EAAA,KAFKA,UAAAA,GAAAA,UAAAA;AAGV,IAAA,IAAA,CAAKH,UAAAA,GAAaA,UAAAA;AAClB,IAAA,IAAA,CAAKD,SAAAA,GAAYC,UAAAA;AACnB;AAEAI,EAAAA,GAAAA,CAAIC,KAAAA,EAAe;AACjB,IAAA,IAAI,KAAKH,UAAAA,EAAY;AACnB,MAAA,MAAM,IAAA,CAAKA,UAAAA;AACb;AAEA,IAAA,IAAA,CAAKD,SAAAA,GAAYI,SAAS,IAAA,CAAKJ,SAAAA;AAC/B,IAAA,IAAA,CAAKF,SAAAA,EAAAA;AACL,IAAA,IAAI,IAAA,CAAKA,YAAY,CAAA,EAAG;AACtB,MAAA,IAAA,CAAKG,UAAAA,GAAa,IAAI,IAAA,CAAKC,UAAAA,CACzB,qCAAqC,IAAA,CAAKH,UAAU,CAAA,mBAAA,CAAA,EACpD,IAAA,CAAKC,SAAAA,GAAY;QAAC,IAAA,CAAKA;UAAaK,MAAAA,EACpC;QAAEC,OAAAA,EAAS,IAAA;QAAMC,WAAAA,EAAa;OAAM,CAAA;AAEtC,MAAA,MAAM,IAAA,CAAKN,UAAAA;AACb;AACF;EAEAO,cAAAA,GAAiB;AACf,IAAA,OAAO;AACLV,MAAAA,SAAAA,EAAW,IAAA,CAAKA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAA,CAAKA,UAAAA;AACjBC,MAAAA,SAAAA,EAAW,IAAA,CAAKA,SAAAA;AAChBC,MAAAA,UAAAA,EAAY,IAAA,CAAKA,UAAAA;AACjBC,MAAAA,UAAAA,EAAY,IAAA,CAAKA;AACnB,KAAA;AACF;AAEAO,EAAAA,YAAAA,CAAaC,QAAAA,EAAkD;AAC7DC,IAAAA,MAAAA,CAAOC,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"counter.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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.map

@@ -1 +1 @@
-{"version":3,"sources":["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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/general.ts"],"names":["sleep","ms","signal","start","Date","now","ctx","iteration","elapsed","setTimeout","validate","value","schema","parse"],"mappings":";;;;;;AAQA,gBAAuBA,KAAAA,CAAMC,IAAYC,MAAAA,EAAoB;AAC3D,EAAA,MAAMC,KAAAA,GAAQC,KAAKC,GAAAA,EAAG;AACtB,EAAA,MAAMC,GAAAA,GAAM;IAAEC,SAAAA,EAAW,CAAA;IAAGC,OAAAA,EAAS;AAAE,GAAA;AACvC,EAAA,OAAO,IAAA,EAAM;AACX,IAAA,MAAMC,oBAAWR,EAAAA,EAAI;AACnBC,MAAAA;KACF,CAAA;AACAI,IAAAA,GAAAA,CAAIE,OAAAA,GAAUJ,IAAAA,CAAKC,GAAAA,EAAG,GAAKF,KAAAA;AAC3BG,IAAAA,GAAAA,CAAIC,SAAAA,EAAAA;AACJ,IAAA,MAAMD,GAAAA;AACR;AACF;AAXuBN,MAAAA,CAAAA,KAAAA,EAAAA,OAAAA,CAAAA;AAahB,SAASU,QAAAA,CAAYC,OAAgBC,MAAAA,EAAkB;AAC5DA,EAAAA,MAAAA,CAAOC,MAAMF,KAAAA,CAAAA;AACf;AAFgBD,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA","file":"general.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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

@@ -2,18 +2,7 @@ import { ZodType } from 'zod';
 
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 
 declare function sleep(ms: number, signal?: AbortSignal): AsyncGenerator<{

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

@@ -2,18 +2,7 @@ import { ZodType } from 'zod';
 
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 
 declare function sleep(ms: number, signal?: AbortSignal): AsyncGenerator<{

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

@@ -1 +1 @@
-{"version":3,"sources":["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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/general.ts"],"names":["sleep","ms","signal","start","Date","now","ctx","iteration","elapsed","setTimeout","validate","value","schema","parse"],"mappings":";;;;AAQA,gBAAuBA,KAAAA,CAAMC,IAAYC,MAAAA,EAAoB;AAC3D,EAAA,MAAMC,KAAAA,GAAQC,KAAKC,GAAAA,EAAG;AACtB,EAAA,MAAMC,GAAAA,GAAM;IAAEC,SAAAA,EAAW,CAAA;IAAGC,OAAAA,EAAS;AAAE,GAAA;AACvC,EAAA,OAAO,IAAA,EAAM;AACX,IAAA,MAAMC,WAAWR,EAAAA,EAAI;AACnBC,MAAAA;KACF,CAAA;AACAI,IAAAA,GAAAA,CAAIE,OAAAA,GAAUJ,IAAAA,CAAKC,GAAAA,EAAG,GAAKF,KAAAA;AAC3BG,IAAAA,GAAAA,CAAIC,SAAAA,EAAAA;AACJ,IAAA,MAAMD,GAAAA;AACR;AACF;AAXuBN,MAAAA,CAAAA,KAAAA,EAAAA,OAAAA,CAAAA;AAahB,SAASU,QAAAA,CAAYC,OAAgBC,MAAAA,EAAkB;AAC5DA,EAAAA,MAAAA,CAAOC,MAAMF,KAAAA,CAAAA;AACf;AAFgBD,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA","file":"general.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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.map

@@ -1 +1 @@
-{"version":3,"sources":["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 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/guards.ts"],"names":["isPrimitive","value","R","isString","isNumber","isBoolean","isNullish","isSymbol"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAQO,SAASA,YAAYC,KAAAA,EAAc;AACxC,EAAA,OACEC,aAAEC,QAAAA,CAASF,KAAAA,KACXC,YAAAA,CAAEE,QAAAA,CAASH,KAAAA,CAAAA,IACXC,YAAAA,CAAEG,SAAAA,CAAUJ,KAAAA,KACZC,YAAAA,CAAEI,SAAAA,CAAUL,KAAAA,CAAAA,IACZC,YAAAA,CAAEK,SAASN,KAAAA,CAAAA;AAEf;AARgBD,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"guards.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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"]}

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 type Primitive = string | number | symbol | bigint | boolean | null | undefined;
 declare function isPrimitive(value: unknown): value is Primitive;

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 type Primitive = string | number | symbol | bigint | boolean | null | undefined;
 declare function isPrimitive(value: unknown): value is Primitive;

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

@@ -1 +1 @@
-{"version":3,"sources":["guards.ts"],"names":["isPrimitive","value","R","isString","isNumber","isBoolean","isNullish","isSymbol"],"mappings":";;;;AAmBO,SAASA,YAAYC,KAAc,EAAA;AACxC,EAAA,OACEC,EAAEC,QAASF,CAAAA,KAAAA,KACXC,CAAEE,CAAAA,QAAAA,CAASH,KAAAA,CACXC,IAAAA,CAAAA,CAAEG,SAAUJ,CAAAA,KAAAA,KACZC,CAAEI,CAAAA,SAAAA,CAAUL,KAAAA,CACZC,IAAAA,CAAAA,CAAEK,SAASN,KAAAA,CAAAA;AAEf;AARgBD,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"guards.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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"]}
+{"version":3,"sources":["../../../src/internals/helpers/guards.ts"],"names":["isPrimitive","value","R","isString","isNumber","isBoolean","isNullish","isSymbol"],"mappings":";;;;AAQO,SAASA,YAAYC,KAAAA,EAAc;AACxC,EAAA,OACEC,EAAEC,QAAAA,CAASF,KAAAA,KACXC,CAAAA,CAAEE,QAAAA,CAASH,KAAAA,CAAAA,IACXC,CAAAA,CAAEG,SAAAA,CAAUJ,KAAAA,KACZC,CAAAA,CAAEI,SAAAA,CAAUL,KAAAA,CAAAA,IACZC,CAAAA,CAAEK,SAASN,KAAAA,CAAAA;AAEf;AARgBD,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"guards.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\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"]}

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

@@ -1 +1 @@
-{"version":3,"sources":["hash.ts"],"names":["createHash","input","length","NotImplementedError","_createHash","update","digest","slice","createRandomHash","randomBytes","toString"],"mappings":";;;;;;;AAmBO,SAASA,UAAAA,CAAWC,KAAeC,EAAAA,MAAAA,GAAS,CAAC,EAAA;AAClD,EAAA,IAAIA,SAAS,EAAI,EAAA;AACf,IAAM,MAAA,IAAIC,+BAAoB,iCAAA,CAAA;AAChC;AAEA,EAAA,OAAOC,sBAAY,CAAA,QAAA,CAChBC,CAAAA,MAAAA,CAAOJ,KAAAA,CAAAA,CACPK,MAAO,CAAA,KAAA,CACPC,CAAAA,KAAAA,CAAM,CAAGL,EAAAA,MAAAA,GAAS,CAAA,CAAA;AACvB;AATgBF,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAWT,SAASQ,gBAAAA,CAAiBN,SAAS,CAAC,EAAA;AACzC,EAAA,OAAOF,WAAWS,uBAAY,CAAA,EAAA,EAAIC,QAAS,CAAA,QAAA,GAAWR,MAAAA,CAAAA;AACxD;AAFgBM,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA","file":"hash.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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 { createHash as _createHash, randomBytes } from \"node:crypto\";\nimport { NotImplementedError } from \"@/errors.js\";\n\nexport function createHash(input: string, length = 4) {\n  if (length > 32) {\n    throw new NotImplementedError(\"Max supported hash length is 32\");\n  }\n\n  return _createHash(\"sha256\")\n    .update(input)\n    .digest(\"hex\")\n    .slice(0, length * 2);\n}\n\nexport function createRandomHash(length = 4) {\n  return createHash(randomBytes(20).toString(\"base64\"), length);\n}\n"]}
+{"version":3,"sources":["../../../src/internals/helpers/hash.ts"],"names":["createHash","input","length","NotImplementedError","_createHash","update","digest","slice","createRandomHash","randomBytes","toString"],"mappings":";;;;;;;AAQO,SAASA,UAAAA,CAAWC,KAAAA,EAAeC,MAAAA,GAAS,CAAA,EAAC;AAClD,EAAA,IAAIA,SAAS,EAAA,EAAI;AACf,IAAA,MAAM,IAAIC,+BAAoB,iCAAA,CAAA;AAChC;AAEA,EAAA,OAAOC,sBAAAA,CAAY,QAAA,CAAA,CAChBC,MAAAA,CAAOJ,KAAAA,CAAAA,CACPK,MAAAA,CAAO,KAAA,CAAA,CACPC,KAAAA,CAAM,CAAA,EAAGL,MAAAA,GAAS,CAAA,CAAA;AACvB;AATgBF,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAWT,SAASQ,gBAAAA,CAAiBN,SAAS,CAAA,EAAC;AACzC,EAAA,OAAOF,WAAWS,uBAAAA,CAAY,EAAA,EAAIC,QAAAA,CAAS,QAAA,GAAWR,MAAAA,CAAAA;AACxD;AAFgBM,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA","file":"hash.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { createHash as _createHash, randomBytes } from \"node:crypto\";\nimport { NotImplementedError } from \"@/errors.js\";\n\nexport function createHash(input: string, length = 4) {\n  if (length > 32) {\n    throw new NotImplementedError(\"Max supported hash length is 32\");\n  }\n\n  return _createHash(\"sha256\")\n    .update(input)\n    .digest(\"hex\")\n    .slice(0, length * 2);\n}\n\nexport function createRandomHash(length = 4) {\n  return createHash(randomBytes(20).toString(\"base64\"), length);\n}\n"]}

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function createHash(input: string, length?: number): string;
 declare function createRandomHash(length?: number): string;

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function createHash(input: string, length?: number): string;
 declare function createRandomHash(length?: number): string;

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

@@ -1 +1 @@
-{"version":3,"sources":["hash.ts"],"names":["createHash","input","length","NotImplementedError","_createHash","update","digest","slice","createRandomHash","randomBytes","toString"],"mappings":";;;;;AAmBO,SAASA,UAAAA,CAAWC,KAAeC,EAAAA,MAAAA,GAAS,CAAC,EAAA;AAClD,EAAA,IAAIA,SAAS,EAAI,EAAA;AACf,IAAM,MAAA,IAAIC,oBAAoB,iCAAA,CAAA;AAChC;AAEA,EAAA,OAAOC,YAAY,CAAA,QAAA,CAChBC,CAAAA,MAAAA,CAAOJ,KAAAA,CAAAA,CACPK,MAAO,CAAA,KAAA,CACPC,CAAAA,KAAAA,CAAM,CAAGL,EAAAA,MAAAA,GAAS,CAAA,CAAA;AACvB;AATgBF,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAWT,SAASQ,gBAAAA,CAAiBN,SAAS,CAAC,EAAA;AACzC,EAAA,OAAOF,WAAWS,WAAY,CAAA,EAAA,EAAIC,QAAS,CAAA,QAAA,GAAWR,MAAAA,CAAAA;AACxD;AAFgBM,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA","file":"hash.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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 { createHash as _createHash, randomBytes } from \"node:crypto\";\nimport { NotImplementedError } from \"@/errors.js\";\n\nexport function createHash(input: string, length = 4) {\n  if (length > 32) {\n    throw new NotImplementedError(\"Max supported hash length is 32\");\n  }\n\n  return _createHash(\"sha256\")\n    .update(input)\n    .digest(\"hex\")\n    .slice(0, length * 2);\n}\n\nexport function createRandomHash(length = 4) {\n  return createHash(randomBytes(20).toString(\"base64\"), length);\n}\n"]}
+{"version":3,"sources":["../../../src/internals/helpers/hash.ts"],"names":["createHash","input","length","NotImplementedError","_createHash","update","digest","slice","createRandomHash","randomBytes","toString"],"mappings":";;;;;AAQO,SAASA,UAAAA,CAAWC,KAAAA,EAAeC,MAAAA,GAAS,CAAA,EAAC;AAClD,EAAA,IAAIA,SAAS,EAAA,EAAI;AACf,IAAA,MAAM,IAAIC,oBAAoB,iCAAA,CAAA;AAChC;AAEA,EAAA,OAAOC,YAAAA,CAAY,QAAA,CAAA,CAChBC,MAAAA,CAAOJ,KAAAA,CAAAA,CACPK,MAAAA,CAAO,KAAA,CAAA,CACPC,KAAAA,CAAM,CAAA,EAAGL,MAAAA,GAAS,CAAA,CAAA;AACvB;AATgBF,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAWT,SAASQ,gBAAAA,CAAiBN,SAAS,CAAA,EAAC;AACzC,EAAA,OAAOF,WAAWS,WAAAA,CAAY,EAAA,EAAIC,QAAAA,CAAS,QAAA,GAAWR,MAAAA,CAAAA;AACxD;AAFgBM,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA","file":"hash.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { createHash as _createHash, randomBytes } from \"node:crypto\";\nimport { NotImplementedError } from \"@/errors.js\";\n\nexport function createHash(input: string, length = 4) {\n  if (length > 32) {\n    throw new NotImplementedError(\"Max supported hash length is 32\");\n  }\n\n  return _createHash(\"sha256\")\n    .update(input)\n    .digest(\"hex\")\n    .slice(0, length * 2);\n}\n\nexport function createRandomHash(length = 4) {\n  return createHash(randomBytes(20).toString(\"base64\"), length);\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"sources":["map.ts"],"names":["findUniqueKey","baseKey","map","key","i","has","concat","String"],"mappings":";;;;AAgBO,SAASA,aAAAA,CAAcC,SAAiBC,GAAyB,EAAA;AACtE,EAAA,IAAIC,GAAMF,GAAAA,OAAAA;AACV,EAAA,KAAA,IAASG,IAAI,CAAGF,EAAAA,GAAAA,CAAIG,GAAIF,CAAAA,GAAAA,GAAMC,CAAK,EAAA,EAAA;AACjCD,IAAAA,GAAAA,GAAMF,OAAQK,CAAAA,MAAAA,CAAOC,MAAOH,CAAAA,CAAAA,CAAAA,CAAAA;AAC9B;AACA,EAAOD,OAAAA,GAAAA;AACT;AANgBH,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA","file":"map.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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 findUniqueKey(baseKey: string, map: Map<string, unknown>) {\n  let key = baseKey;\n  for (let i = 1; map.has(key); i++) {\n    key = baseKey.concat(String(i));\n  }\n  return key;\n}\n"]}
+{"version":3,"sources":["../../../src/internals/helpers/map.ts"],"names":["findUniqueKey","baseKey","map","key","i","has","concat","String"],"mappings":";;;;AAKO,SAASA,aAAAA,CAAcC,SAAiBC,GAAAA,EAAyB;AACtE,EAAA,IAAIC,GAAAA,GAAMF,OAAAA;AACV,EAAA,KAAA,IAASG,IAAI,CAAA,EAAGF,GAAAA,CAAIG,GAAAA,CAAIF,GAAAA,GAAMC,CAAAA,EAAAA,EAAK;AACjCD,IAAAA,GAAAA,GAAMF,OAAAA,CAAQK,MAAAA,CAAOC,MAAAA,CAAOH,CAAAA,CAAAA,CAAAA;AAC9B;AACA,EAAA,OAAOD,GAAAA;AACT;AANgBH,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA","file":"map.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport function findUniqueKey(baseKey: string, map: Map<string, unknown>) {\n  let key = baseKey;\n  for (let i = 1; map.has(key); i++) {\n    key = baseKey.concat(String(i));\n  }\n  return key;\n}\n"]}

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function findUniqueKey(baseKey: string, map: Map<string, unknown>): string;
 

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

@@ -1,17 +1,6 @@
 /**
  * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- *
- * 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.
+ * SPDX-License-Identifier: Apache-2.0
  */
 declare function findUniqueKey(baseKey: string, map: Map<string, unknown>): string;
 

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

@@ -1 +1 @@
-{"version":3,"sources":["map.ts"],"names":["findUniqueKey","baseKey","map","key","i","has","concat","String"],"mappings":";;AAgBO,SAASA,aAAAA,CAAcC,SAAiBC,GAAyB,EAAA;AACtE,EAAA,IAAIC,GAAMF,GAAAA,OAAAA;AACV,EAAA,KAAA,IAASG,IAAI,CAAGF,EAAAA,GAAAA,CAAIG,GAAIF,CAAAA,GAAAA,GAAMC,CAAK,EAAA,EAAA;AACjCD,IAAAA,GAAAA,GAAMF,OAAQK,CAAAA,MAAAA,CAAOC,MAAOH,CAAAA,CAAAA,CAAAA,CAAAA;AAC9B;AACA,EAAOD,OAAAA,GAAAA;AACT;AANgBH,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA","file":"map.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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 findUniqueKey(baseKey: string, map: Map<string, unknown>) {\n  let key = baseKey;\n  for (let i = 1; map.has(key); i++) {\n    key = baseKey.concat(String(i));\n  }\n  return key;\n}\n"]}
+{"version":3,"sources":["../../../src/internals/helpers/map.ts"],"names":["findUniqueKey","baseKey","map","key","i","has","concat","String"],"mappings":";;AAKO,SAASA,aAAAA,CAAcC,SAAiBC,GAAAA,EAAyB;AACtE,EAAA,IAAIC,GAAAA,GAAMF,OAAAA;AACV,EAAA,KAAA,IAASG,IAAI,CAAA,EAAGF,GAAAA,CAAIG,GAAAA,CAAIF,GAAAA,GAAMC,CAAAA,EAAAA,EAAK;AACjCD,IAAAA,GAAAA,GAAMF,OAAAA,CAAQK,MAAAA,CAAOC,MAAAA,CAAOH,CAAAA,CAAAA,CAAAA;AAC9B;AACA,EAAA,OAAOD,GAAAA;AACT;AANgBH,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA","file":"map.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport function findUniqueKey(baseKey: string, map: Map<string, unknown>) {\n  let key = baseKey;\n  for (let i = 1; map.has(key); i++) {\n    key = baseKey.concat(String(i));\n  }\n  return key;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"sources":["math.ts"],"names":["cosineSimilarity","vecA","vecB","length","ValueError","dot","reduce","sum","value","index","magA","Math","sqrt","magB","cosineSimilarityMatrix","matrixA","matrixB","map","rowA","rowB"],"mappings":";;;;;;AAkBO,SAASA,gBAAAA,CAAiBC,MAAgBC,IAAc,EAAA;AAC7D,EAAID,IAAAA,IAAAA,CAAKE,MAAWD,KAAAA,IAAAA,CAAKC,MAAQ,EAAA;AAC/B,IAAM,MAAA,IAAIC,sBAAW,gCAAA,CAAA;AACvB;AAEA,EAAA,MAAMC,GAAMJ,GAAAA,IAAAA,CAAKK,MAAO,CAAA,CAACC,GAAKC,EAAAA,KAAAA,EAAOC,KAAUF,KAAAA,GAAAA,GAAMC,KAAQN,GAAAA,IAAAA,CAAKO,KAAAA,CAAAA,EAAQ,CAAA,CAAA;AAC1E,EAAA,MAAMC,IAAOC,GAAAA,IAAAA,CAAKC,IAAKX,CAAAA,IAAAA,CAAKK,MAAO,CAAA,CAACC,GAAKC,EAAAA,KAAAA,KAAUD,GAAMC,GAAAA,KAAAA,IAAS,CAAG,EAAA,CAAA,CAAA,CAAA;AACrE,EAAA,MAAMK,IAAOF,GAAAA,IAAAA,CAAKC,IAAKV,CAAAA,IAAAA,CAAKI,MAAO,CAAA,CAACC,GAAKC,EAAAA,KAAAA,KAAUD,GAAMC,GAAAA,KAAAA,IAAS,CAAG,EAAA,CAAA,CAAA,CAAA;AAErE,EAAIE,IAAAA,IAAAA,KAAS,CAAKG,IAAAA,IAAAA,KAAS,CAAG,EAAA;AAC5B,IAAM,MAAA,IAAIT,sBAAW,wCAAA,CAAA;AACvB;AACA,EAAA,OAAOC,OAAOK,IAAOG,GAAAA,IAAAA,CAAAA;AACvB;AAbgBb,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA;AAeT,SAASc,sBAAAA,CAAuBC,SAAqBC,OAAmB,EAAA;AAC7E,EAAKD,IAAAA,CAAAA,OAAAA,CAAQ,CAAA,CAAIZ,EAAAA,MAAAA,IAAU,QAAQY,OAAQ,CAAA,CAAA,CAAIZ,EAAAA,MAAAA,IAAU,CAAI,CAAA,EAAA;AAC3D,IAAM,MAAA,IAAIC,sBAAW,gDAAA,CAAA;AACvB;AAEA,EAAA,OAAOW,OAAQE,CAAAA,GAAAA,CAAI,CAACC,IAAAA,KAASF,OAAQC,CAAAA,GAAAA,CAAI,CAACE,IAAAA,KAASnB,gBAAiBkB,CAAAA,IAAAA,EAAMC,IAAAA,CAAAA,CAAAA,CAAAA;AAC5E;AANgBL,MAAAA,CAAAA,sBAAAA,EAAAA,wBAAAA,CAAAA","file":"math.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\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 { ValueError } from \"@/errors.js\";\n\nexport function cosineSimilarity(vecA: number[], vecB: number[]): number {\n  if (vecA.length !== vecB.length) {\n    throw new ValueError(\"Vectors must have equal length\");\n  }\n  // (cos θ) = (A · B) / (|A| * |B|)\n  const dot = vecA.reduce((sum, value, index) => sum + value * vecB[index], 0);\n  const magA = Math.sqrt(vecA.reduce((sum, value) => sum + value ** 2, 0));\n  const magB = Math.sqrt(vecB.reduce((sum, value) => sum + value ** 2, 0));\n\n  if (magA === 0 || magB === 0) {\n    throw new ValueError(\"Vectors cannot not have zero magnitude\");\n  }\n  return dot / (magA * magB);\n}\n\nexport function cosineSimilarityMatrix(matrixA: number[][], matrixB: number[][]): number[][] {\n  if ((matrixA[0]?.length ?? 0) !== (matrixA[0]?.length ?? 0)) {\n    throw new ValueError(\"Matrices must have the same number of columns.\");\n  }\n\n  return matrixA.map((rowA) => matrixB.map((rowB) => cosineSimilarity(rowA, rowB)));\n}\n"]}
+{"version":3,"sources":["../../../src/internals/helpers/math.ts"],"names":["cosineSimilarity","vecA","vecB","length","ValueError","dot","reduce","sum","value","index","magA","Math","sqrt","magB","cosineSimilarityMatrix","matrixA","matrixB","map","rowA","rowB"],"mappings":";;;;;;AAOO,SAASA,gBAAAA,CAAiBC,MAAgBC,IAAAA,EAAc;AAC7D,EAAA,IAAID,IAAAA,CAAKE,MAAAA,KAAWD,IAAAA,CAAKC,MAAAA,EAAQ;AAC/B,IAAA,MAAM,IAAIC,sBAAW,gCAAA,CAAA;AACvB;AAEA,EAAA,MAAMC,GAAAA,GAAMJ,IAAAA,CAAKK,MAAAA,CAAO,CAACC,GAAAA,EAAKC,KAAAA,EAAOC,KAAAA,KAAUF,GAAAA,GAAMC,KAAAA,GAAQN,IAAAA,CAAKO,KAAAA,CAAAA,EAAQ,CAAA,CAAA;AAC1E,EAAA,MAAMC,IAAAA,GAAOC,IAAAA,CAAKC,IAAAA,CAAKX,IAAAA,CAAKK,MAAAA,CAAO,CAACC,GAAAA,EAAKC,KAAAA,KAAUD,GAAAA,GAAMC,KAAAA,IAAS,CAAA,EAAG,CAAA,CAAA,CAAA;AACrE,EAAA,MAAMK,IAAAA,GAAOF,IAAAA,CAAKC,IAAAA,CAAKV,IAAAA,CAAKI,MAAAA,CAAO,CAACC,GAAAA,EAAKC,KAAAA,KAAUD,GAAAA,GAAMC,KAAAA,IAAS,CAAA,EAAG,CAAA,CAAA,CAAA;AAErE,EAAA,IAAIE,IAAAA,KAAS,CAAA,IAAKG,IAAAA,KAAS,CAAA,EAAG;AAC5B,IAAA,MAAM,IAAIT,sBAAW,wCAAA,CAAA;AACvB;AACA,EAAA,OAAOC,OAAOK,IAAAA,GAAOG,IAAAA,CAAAA;AACvB;AAbgBb,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA;AAeT,SAASc,sBAAAA,CAAuBC,SAAqBC,OAAAA,EAAmB;AAC7E,EAAA,IAAA,CAAKD,OAAAA,CAAQ,CAAA,CAAA,EAAIZ,MAAAA,IAAU,QAAQY,OAAAA,CAAQ,CAAA,CAAA,EAAIZ,MAAAA,IAAU,CAAA,CAAA,EAAI;AAC3D,IAAA,MAAM,IAAIC,sBAAW,gDAAA,CAAA;AACvB;AAEA,EAAA,OAAOW,OAAAA,CAAQE,GAAAA,CAAI,CAACC,IAAAA,KAASF,OAAAA,CAAQC,GAAAA,CAAI,CAACE,IAAAA,KAASnB,gBAAAA,CAAiBkB,IAAAA,EAAMC,IAAAA,CAAAA,CAAAA,CAAAA;AAC5E;AANgBL,MAAAA,CAAAA,sBAAAA,EAAAA,wBAAAA,CAAAA","file":"math.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { ValueError } from \"@/errors.js\";\n\nexport function cosineSimilarity(vecA: number[], vecB: number[]): number {\n  if (vecA.length !== vecB.length) {\n    throw new ValueError(\"Vectors must have equal length\");\n  }\n  // (cos θ) = (A · B) / (|A| * |B|)\n  const dot = vecA.reduce((sum, value, index) => sum + value * vecB[index], 0);\n  const magA = Math.sqrt(vecA.reduce((sum, value) => sum + value ** 2, 0));\n  const magB = Math.sqrt(vecB.reduce((sum, value) => sum + value ** 2, 0));\n\n  if (magA === 0 || magB === 0) {\n    throw new ValueError(\"Vectors cannot not have zero magnitude\");\n  }\n  return dot / (magA * magB);\n}\n\nexport function cosineSimilarityMatrix(matrixA: number[][], matrixB: number[][]): number[][] {\n  if ((matrixA[0]?.length ?? 0) !== (matrixA[0]?.length ?? 0)) {\n    throw new ValueError(\"Matrices must have the same number of columns.\");\n  }\n\n  return matrixA.map((rowA) => matrixB.map((rowB) => cosineSimilarity(rowA, rowB)));\n}\n"]}