beeai-framework 0.1.16 → 0.1.18

package/dist/index.d.ts

@@ -2,9 +2,9 @@ export { Logger, LoggerBindings, LoggerError, LoggerInput, LoggerLevel, LoggerLe
 export { PromptTemplate, PromptTemplateError, PromptTemplateInput, PromptTemplateRenderFn, PromptTemplateRenderInput, ValidationPromptTemplateError } from './template.js';
 export { AbortError, FrameworkError, FrameworkErrorOptions, NotImplementedError, ValueError } from './errors.js';
 export { Version } from './version.js';
-export { S as SerializeFactory, a as Serializer } from './serializer-BswFRdT8.js';
-export { A as AgentError, a as BaseAgent, B as BaseAgentRunOptions } from './base-BOCDDBvG.js';
-export { k as ChatConfig, m as ChatModel, i as ChatModelCache, h as ChatModelEmitter, g as ChatModelEvents, e as ChatModelFinishReason, d as ChatModelInput, a as ChatModelObjectInput, b as ChatModelObjectOutput, n as ChatModelOutput, C as ChatModelParameters, c as ChatModelToolChoice, l as ChatModelToolChoiceSupport, f as ChatModelUsage, j as ConfigFn } from './chat-BdN8hGWn.js';
+export { S as SerializeFactory, a as Serializer } from './serializer-CQxucveV.js';
+export { A as AgentError, a as BaseAgent, B as BaseAgentRunOptions } from './base-BsY2baWy.js';
+export { k as ChatConfig, m as ChatModel, i as ChatModelCache, h as ChatModelEmitter, g as ChatModelEvents, e as ChatModelFinishReason, d as ChatModelInput, a as ChatModelObjectInput, b as ChatModelObjectOutput, n as ChatModelOutput, C as ChatModelParameters, c as ChatModelToolChoice, l as ChatModelToolChoiceSupport, f as ChatModelUsage, j as ConfigFn } from './chat-W9j8T6UU.js';
 export { EmbeddingModel, EmbeddingModelEmitter, EmbeddingModelEvents, EmbeddingModelInput, EmbeddingModelOutput } from './backend/embedding.js';
 export { AnyTool, BaseToolOptions, BaseToolRunOptions, DynamicTool, InferToolOutput, JSONToolOutput, RetryOptions, StringToolOutput, Tool, ToolEmitter, ToolError, ToolEvents, ToolInput, ToolInputRaw, ToolInputValidationError, ToolOutput, ToolSnapshot } from './tools/base.js';
 import 'pino';
@@ -14,7 +14,7 @@ import './internals/helpers/guards.js';
 import 'zod';
 import 'ajv';
 import './context.js';
-import './emitter-C3dO-s2P.js';
+import './emitter-C9nwGLt6.js';
 import './internals/helpers/promise.js';
 import './memory/base.js';
 import './backend/message.js';

package/dist/internals/env.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["env.ts"],"names":["getEnv","key","fallback","getProp","process","env","parseEnv","schema","defaultValue","value","result","safeParse","success","undefined","FrameworkError","error","data","asBoolean","z","string","String","trim","toLowerCase","hasEnv"],"mappings":";;;;;;;;AAsBO,SAASA,MAAAA,CAAOC,KAAaC,QAAiB,EAAA;AACnD,EAAOC,OAAAA,kBAAAA,CAAQC,QAAQC,GAAK,EAAA;AAACJ,IAAAA;KAAMC,QAAAA,CAAAA;AACrC;AAFgBF,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA;AAIT,SAASM,QAAAA,CACdL,GACAM,EAAAA,MAAAA,EACAC,YAAqB,EAAA;AAErB,EAAMC,MAAAA,KAAAA,GAAQT,MAAOC,CAAAA,GAAAA,CAAQO,IAAAA,YAAAA;AAC7B,EAAME,MAAAA,MAAAA,GAASH,MAAOI,CAAAA,SAAAA,CAAUF,KAAAA,CAAAA;AAChC,EAAI,IAAA,CAACC,OAAOE,OAAS,EAAA;AACnB,IAAA,IAAIH,UAAUI,MAAW,EAAA;AACvB,MAAA,MAAM,IAAIC,yBAAAA,CAAe,CAA0Bb,uBAAAA,EAAAA,GAAAA,CAAkB,aAAA,CAAA,CAAA;AACvE;AAEA,IAAA,MAAM,IAAIa,yBAAAA,CAAe,CAA6Cb,0CAAAA,EAAAA,GAAAA,CAAS,EAAA,CAAA,EAAA;MAACS,MAAOK,CAAAA;AAAM,KAAA,CAAA;AAC/F;AACA,EAAA,OAAOL,MAAOM,CAAAA,IAAAA;AAChB;AAfgBV,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAgBhBA,QAAAA,CAASW,SAAY,GAAA,CAAChB,GAAaC,EAAAA,QAAAA,GAAW,KAAK,KAAA;AACjD,EAAA,OAAOI,QAASL,CAAAA,GAAAA,EAAKiB,KAAEC,CAAAA,MAAAA,EAAUC,EAAAA,MAAAA,CAAOlB,QAAAA,CAAAA,CAAWmB,CAAAA,IAAAA,EAAOC,CAAAA,WAAAA,EAAkB,KAAA,MAAA;AAC9E,CAAA;AAEO,SAASC,OAAOtB,GAAW,EAAA;AAChC,EAAOE,OAAAA,kBAAAA,CAAQC,QAAQC,GAAK,EAAA;AAACJ,IAAAA;GAAI,CAAMY,KAAAA,MAAAA;AACzC;AAFgBU,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA","file":"env.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 { z, ZodSchema } from \"zod\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { getProp } from \"@/internals/helpers/object.js\";\n\nexport function getEnv(key: string, fallback?: never): string | undefined;\nexport function getEnv(key: string, fallback: string): string;\nexport function getEnv(key: string, fallback?: string) {\n  return getProp(process.env, [key], fallback);\n}\n\nexport function parseEnv<T extends ZodSchema>(\n  key: string,\n  schema: T,\n  defaultValue?: string,\n): z.output<T> {\n  const value = getEnv(key) ?? defaultValue;\n  const result = schema.safeParse(value);\n  if (!result.success) {\n    if (value === undefined) {\n      throw new FrameworkError(`The required variable '${key}' is not set!`);\n    }\n\n    throw new FrameworkError(`Failed to parse the environment variable (${key})!`, [result.error]);\n  }\n  return result.data;\n}\nparseEnv.asBoolean = (key: string, fallback = false) => {\n  return parseEnv(key, z.string(), String(fallback)).trim().toLowerCase() === \"true\";\n};\n\nexport function hasEnv(key: string) {\n  return getProp(process.env, [key]) !== undefined;\n}\n"]}
+{"version":3,"sources":["../../src/internals/env.ts"],"names":["getEnv","key","fallback","getProp","process","env","parseEnv","schema","defaultValue","value","result","safeParse","success","undefined","FrameworkError","error","data","asBoolean","z","string","String","trim","toLowerCase","hasEnv"],"mappings":";;;;;;;;AAWO,SAASA,MAAAA,CAAOC,KAAaC,QAAAA,EAAiB;AACnD,EAAA,OAAOC,kBAAAA,CAAQC,QAAQC,GAAAA,EAAK;AAACJ,IAAAA;KAAMC,QAAAA,CAAAA;AACrC;AAFgBF,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA;AAIT,SAASM,QAAAA,CACdL,GAAAA,EACAM,MAAAA,EACAC,YAAAA,EAAqB;AAErB,EAAA,MAAMC,KAAAA,GAAQT,MAAAA,CAAOC,GAAAA,CAAAA,IAAQO,YAAAA;AAC7B,EAAA,MAAME,MAAAA,GAASH,MAAAA,CAAOI,SAAAA,CAAUF,KAAAA,CAAAA;AAChC,EAAA,IAAI,CAACC,OAAOE,OAAAA,EAAS;AACnB,IAAA,IAAIH,UAAUI,MAAAA,EAAW;AACvB,MAAA,MAAM,IAAIC,yBAAAA,CAAe,CAAA,uBAAA,EAA0Bb,GAAAA,CAAAA,aAAAA,CAAkB,CAAA;AACvE;AAEA,IAAA,MAAM,IAAIa,yBAAAA,CAAe,CAAA,0CAAA,EAA6Cb,GAAAA,CAAAA,EAAAA,CAAAA,EAAS;MAACS,MAAAA,CAAOK;AAAM,KAAA,CAAA;AAC/F;AACA,EAAA,OAAOL,MAAAA,CAAOM,IAAAA;AAChB;AAfgBV,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAgBhBA,QAAAA,CAASW,SAAAA,GAAY,CAAChB,GAAAA,EAAaC,QAAAA,GAAW,KAAA,KAAK;AACjD,EAAA,OAAOI,QAAAA,CAASL,GAAAA,EAAKiB,KAAAA,CAAEC,MAAAA,EAAM,EAAIC,MAAAA,CAAOlB,QAAAA,CAAAA,CAAAA,CAAWmB,IAAAA,EAAI,CAAGC,WAAAA,EAAW,KAAO,MAAA;AAC9E,CAAA;AAEO,SAASC,OAAOtB,GAAAA,EAAW;AAChC,EAAA,OAAOE,kBAAAA,CAAQC,QAAQC,GAAAA,EAAK;AAACJ,IAAAA;GAAI,CAAA,KAAMY,MAAAA;AACzC;AAFgBU,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA","file":"env.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { z, ZodSchema } from \"zod\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { getProp } from \"@/internals/helpers/object.js\";\n\nexport function getEnv(key: string, fallback?: never): string | undefined;\nexport function getEnv(key: string, fallback: string): string;\nexport function getEnv(key: string, fallback?: string) {\n  return getProp(process.env, [key], fallback);\n}\n\nexport function parseEnv<T extends ZodSchema>(\n  key: string,\n  schema: T,\n  defaultValue?: string,\n): z.output<T> {\n  const value = getEnv(key) ?? defaultValue;\n  const result = schema.safeParse(value);\n  if (!result.success) {\n    if (value === undefined) {\n      throw new FrameworkError(`The required variable '${key}' is not set!`);\n    }\n\n    throw new FrameworkError(`Failed to parse the environment variable (${key})!`, [result.error]);\n  }\n  return result.data;\n}\nparseEnv.asBoolean = (key: string, fallback = false) => {\n  return parseEnv(key, z.string(), String(fallback)).trim().toLowerCase() === \"true\";\n};\n\nexport function hasEnv(key: string) {\n  return getProp(process.env, [key]) !== undefined;\n}\n"]}

package/dist/internals/env.d.cts

@@ -2,18 +2,7 @@ import { ZodSchema, z } 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 getEnv(key: string, fallback?: never): string | undefined;

package/dist/internals/env.d.ts

@@ -2,18 +2,7 @@ import { ZodSchema, z } 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 getEnv(key: string, fallback?: never): string | undefined;

package/dist/internals/env.js.map

@@ -1 +1 @@
-{"version":3,"sources":["env.ts"],"names":["getEnv","key","fallback","getProp","process","env","parseEnv","schema","defaultValue","value","result","safeParse","success","undefined","FrameworkError","error","data","asBoolean","z","string","String","trim","toLowerCase","hasEnv"],"mappings":";;;;;;AAsBO,SAASA,MAAAA,CAAOC,KAAaC,QAAiB,EAAA;AACnD,EAAOC,OAAAA,OAAAA,CAAQC,QAAQC,GAAK,EAAA;AAACJ,IAAAA;KAAMC,QAAAA,CAAAA;AACrC;AAFgBF,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA;AAIT,SAASM,QAAAA,CACdL,GACAM,EAAAA,MAAAA,EACAC,YAAqB,EAAA;AAErB,EAAMC,MAAAA,KAAAA,GAAQT,MAAOC,CAAAA,GAAAA,CAAQO,IAAAA,YAAAA;AAC7B,EAAME,MAAAA,MAAAA,GAASH,MAAOI,CAAAA,SAAAA,CAAUF,KAAAA,CAAAA;AAChC,EAAI,IAAA,CAACC,OAAOE,OAAS,EAAA;AACnB,IAAA,IAAIH,UAAUI,MAAW,EAAA;AACvB,MAAA,MAAM,IAAIC,cAAAA,CAAe,CAA0Bb,uBAAAA,EAAAA,GAAAA,CAAkB,aAAA,CAAA,CAAA;AACvE;AAEA,IAAA,MAAM,IAAIa,cAAAA,CAAe,CAA6Cb,0CAAAA,EAAAA,GAAAA,CAAS,EAAA,CAAA,EAAA;MAACS,MAAOK,CAAAA;AAAM,KAAA,CAAA;AAC/F;AACA,EAAA,OAAOL,MAAOM,CAAAA,IAAAA;AAChB;AAfgBV,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAgBhBA,QAAAA,CAASW,SAAY,GAAA,CAAChB,GAAaC,EAAAA,QAAAA,GAAW,KAAK,KAAA;AACjD,EAAA,OAAOI,QAASL,CAAAA,GAAAA,EAAKiB,CAAEC,CAAAA,MAAAA,EAAUC,EAAAA,MAAAA,CAAOlB,QAAAA,CAAAA,CAAWmB,CAAAA,IAAAA,EAAOC,CAAAA,WAAAA,EAAkB,KAAA,MAAA;AAC9E,CAAA;AAEO,SAASC,OAAOtB,GAAW,EAAA;AAChC,EAAOE,OAAAA,OAAAA,CAAQC,QAAQC,GAAK,EAAA;AAACJ,IAAAA;GAAI,CAAMY,KAAAA,MAAAA;AACzC;AAFgBU,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA","file":"env.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 { z, ZodSchema } from \"zod\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { getProp } from \"@/internals/helpers/object.js\";\n\nexport function getEnv(key: string, fallback?: never): string | undefined;\nexport function getEnv(key: string, fallback: string): string;\nexport function getEnv(key: string, fallback?: string) {\n  return getProp(process.env, [key], fallback);\n}\n\nexport function parseEnv<T extends ZodSchema>(\n  key: string,\n  schema: T,\n  defaultValue?: string,\n): z.output<T> {\n  const value = getEnv(key) ?? defaultValue;\n  const result = schema.safeParse(value);\n  if (!result.success) {\n    if (value === undefined) {\n      throw new FrameworkError(`The required variable '${key}' is not set!`);\n    }\n\n    throw new FrameworkError(`Failed to parse the environment variable (${key})!`, [result.error]);\n  }\n  return result.data;\n}\nparseEnv.asBoolean = (key: string, fallback = false) => {\n  return parseEnv(key, z.string(), String(fallback)).trim().toLowerCase() === \"true\";\n};\n\nexport function hasEnv(key: string) {\n  return getProp(process.env, [key]) !== undefined;\n}\n"]}
+{"version":3,"sources":["../../src/internals/env.ts"],"names":["getEnv","key","fallback","getProp","process","env","parseEnv","schema","defaultValue","value","result","safeParse","success","undefined","FrameworkError","error","data","asBoolean","z","string","String","trim","toLowerCase","hasEnv"],"mappings":";;;;;;AAWO,SAASA,MAAAA,CAAOC,KAAaC,QAAAA,EAAiB;AACnD,EAAA,OAAOC,OAAAA,CAAQC,QAAQC,GAAAA,EAAK;AAACJ,IAAAA;KAAMC,QAAAA,CAAAA;AACrC;AAFgBF,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA;AAIT,SAASM,QAAAA,CACdL,GAAAA,EACAM,MAAAA,EACAC,YAAAA,EAAqB;AAErB,EAAA,MAAMC,KAAAA,GAAQT,MAAAA,CAAOC,GAAAA,CAAAA,IAAQO,YAAAA;AAC7B,EAAA,MAAME,MAAAA,GAASH,MAAAA,CAAOI,SAAAA,CAAUF,KAAAA,CAAAA;AAChC,EAAA,IAAI,CAACC,OAAOE,OAAAA,EAAS;AACnB,IAAA,IAAIH,UAAUI,MAAAA,EAAW;AACvB,MAAA,MAAM,IAAIC,cAAAA,CAAe,CAAA,uBAAA,EAA0Bb,GAAAA,CAAAA,aAAAA,CAAkB,CAAA;AACvE;AAEA,IAAA,MAAM,IAAIa,cAAAA,CAAe,CAAA,0CAAA,EAA6Cb,GAAAA,CAAAA,EAAAA,CAAAA,EAAS;MAACS,MAAAA,CAAOK;AAAM,KAAA,CAAA;AAC/F;AACA,EAAA,OAAOL,MAAAA,CAAOM,IAAAA;AAChB;AAfgBV,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAgBhBA,QAAAA,CAASW,SAAAA,GAAY,CAAChB,GAAAA,EAAaC,QAAAA,GAAW,KAAA,KAAK;AACjD,EAAA,OAAOI,QAAAA,CAASL,GAAAA,EAAKiB,CAAAA,CAAEC,MAAAA,EAAM,EAAIC,MAAAA,CAAOlB,QAAAA,CAAAA,CAAAA,CAAWmB,IAAAA,EAAI,CAAGC,WAAAA,EAAW,KAAO,MAAA;AAC9E,CAAA;AAEO,SAASC,OAAOtB,GAAAA,EAAW;AAChC,EAAA,OAAOE,OAAAA,CAAQC,QAAQC,GAAAA,EAAK;AAACJ,IAAAA;GAAI,CAAA,KAAMY,MAAAA;AACzC;AAFgBU,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA","file":"env.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { z, ZodSchema } from \"zod\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { getProp } from \"@/internals/helpers/object.js\";\n\nexport function getEnv(key: string, fallback?: never): string | undefined;\nexport function getEnv(key: string, fallback: string): string;\nexport function getEnv(key: string, fallback?: string) {\n  return getProp(process.env, [key], fallback);\n}\n\nexport function parseEnv<T extends ZodSchema>(\n  key: string,\n  schema: T,\n  defaultValue?: string,\n): z.output<T> {\n  const value = getEnv(key) ?? defaultValue;\n  const result = schema.safeParse(value);\n  if (!result.success) {\n    if (value === undefined) {\n      throw new FrameworkError(`The required variable '${key}' is not set!`);\n    }\n\n    throw new FrameworkError(`Failed to parse the environment variable (${key})!`, [result.error]);\n  }\n  return result.data;\n}\nparseEnv.asBoolean = (key: string, fallback = false) => {\n  return parseEnv(key, z.string(), String(fallback)).trim().toLowerCase() === \"true\";\n};\n\nexport function hasEnv(key: string) {\n  return getProp(process.env, [key]) !== undefined;\n}\n"]}

package/dist/internals/fetcher.cjs

@@ -41,15 +41,15 @@ class RestfulClient extends serializable_cjs.Serializable {
     __name(this, "RestfulClient");
   }
   input;
-  emitter;
+  emitter = emitter_cjs.Emitter.root.child({
+    namespace: [
+      "internals",
+      "restfulClient"
+    ],
+    creator: this
+  });
   constructor(input) {
-    super(), this.input = input, this.emitter = emitter_cjs.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.cjs.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":";;;;;;;;;;;;AA6BO,MAAMA,2BAA2BC,yBAAAA,CAAAA;EA7BxC;;;AA6BwD;AAGjD,SAASC,gBACdC,IAAyE,EAAA;AAEzE,EAAMC,MAAAA,cAAAA,GAAiB,IAAIC,eAAAA,EAAAA;AAC3B,EAAA,KAAA,MAAW,CAACC,GAAKC,EAAAA,KAAAA,KAAUC,MAAOC,CAAAA,OAAAA,CAAQN,IAAAA,CAAO,EAAA;AAC/C,IAAA,IAAII,UAAUG,MAAW,EAAA;AACvB,MAAA;AACF;AAEA,IAAIC,IAAAA,KAAAA,CAAMC,OAAQL,CAAAA,KAAAA,CAAQ,EAAA;AACxBA,MAAMM,KAAAA,CAAAA,OAAAA,CAAQ,CAACC,CAAAA,KAAAA;AACb,QAAA,IAAIA,MAAMJ,MAAW,EAAA;AACnBN,UAAAA,cAAAA,CAAeW,MAAOT,CAAAA,GAAAA,EAAKU,MAAOF,CAAAA,CAAAA,CAAAA,CAAAA;AACpC;OACF,CAAA;KACSG,MAAAA,IAAAA,oBAAAA,CAAcV,KAAAA,CAAQ,EAAA;AAC/BH,MAAAA,cAAAA,CAAec,IAAIZ,GAAKJ,EAAAA,eAAAA,CAAgBK,KAAAA,CAAAA,CAAOY,UAAQ,CAAA;KAClD,MAAA;AACLf,MAAAA,cAAAA,CAAec,GAAIZ,CAAAA,GAAAA,EAAKU,MAAOT,CAAAA,KAAAA,CAAAA,CAAAA;AACjC;AACF;AACA,EAAOH,OAAAA,cAAAA;AACT;AAtBgBF,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAgDT,MAAMkB,sBAAwDC,6BAAAA,CAAAA;EAhFrE;;;;AAiFkBC,EAAAA,OAAAA;AAKhBC,EAAAA,WAAAA,CACYC,KAKV,EAAA;AACA,IAAK,KAAA,EAAA,EAAA,KANKA,KAAAA,GAAAA,KAAAA,EAAAA,KANIF,OAAUG,GAAAA,mBAAAA,CAAQC,KAAKC,KAA2B,CAAA;MAChEC,SAAW,EAAA;AAAC,QAAA,WAAA;AAAa,QAAA;;MACzBC,OAAS,EAAA;KACX,CAAA;AAUA;EAEA,OAAOC,MAAAA,CACLC,MACAC,IACgD,EAAA;AAChD,IAAMV,MAAAA,OAAAA,GAAU,IAAKA,CAAAA,OAAAA,CAAQK,KAAM,CAAA;MACjCM,OAAS,EAAA;KACX,CAAA;AAEA,IAAA,MAAMT,KAAqB,GAAA;AACzBU,MAAAA,GAAAA,EAAK,IAAKC,CAAAA,MAAAA,CAAOJ,IAAAA,CAAAA,CAAMZ,QAAQ,EAAA;MAC/BiB,OAAS,EAAA;QACPC,MAAQ,EAAA,MAAA;QACR,GAAGL,IAAAA;AACHM,QAAAA,OAAAA,EAAS,MAAM,IAAA,CAAKC,UAAWP,CAAAA,IAAAA,EAAMM,OAAAA;AACvC;AACF,KAAA;AACA,IAAMhB,MAAAA,OAAAA,CAAQkB,KAAK,aAAe,EAAA;AAAEhB,MAAAA;KAAM,CAAA;AAE1C,IAAO,OAAA,OAAOiB,+BAAmB,OAAO,EAAED,MACxCE,KAAAA,qCAAAA,CAAiBlB,MAAMU,GAAK,EAAA;AAC1B,MAAA,GAAGV,KAAMY,CAAAA,OAAAA;AACT,MAAA,MAAMO,OAAOC,QAAQ,EAAA;AACnB,QAAA,MAAMC,WAAcD,GAAAA,QAAAA,CAASN,OAAQQ,CAAAA,GAAAA,CAAI,cAAA,CAAmB,IAAA,EAAA;AAC5D,QAAA,IAAIF,QAASG,CAAAA,EAAAA,IAAMF,WAAYG,CAAAA,QAAAA,CAASC,2CAAAA,CAAyB,EAAA;AAC/D,UAAM3B,MAAAA,OAAAA,CAAQkB,KAAK,YAAc,EAAA;AAAEhB,YAAAA;WAAM,CAAA;AACzC,UAAA;AACF;AACA,QAAA,MAAM,IAAIxB,kBAAAA,CAAmB,mBAAqB,EAAA,EAAI,EAAA;UACpDkD,OAAS,EAAA;AACPhB,YAAAA,GAAAA,EAAKU,QAASV,CAAAA,GAAAA;YACdiB,GAAK,EAAA,MAAMP,SAASQ,IAAI,EAAA;AACxBR,YAAAA;AACF,WAAA;AACAS,UAAAA,WAAAA,EAAaT,SAASU,MAAU,IAAA,GAAA,IAAOV,SAASU,MAAS,GAAA,GAAA,IAAOV,SAASU,MAAW,KAAA;SACtF,CAAA;AACF,OAAA;AACA,MAAA,MAAMC,UAAUC,GAAG,EAAA;AACjB,QAAIA,IAAAA,GAAAA,EAAKC,UAAU,OAAS,EAAA;AAC1B,UAAA,MAAM,IAAIzD,kBAAAA,CAAmB,CAAwC,oCAAA,CAAA,EAAA,EAAI,EAAA;YACvEkD,OAASM,EAAAA;WACX,CAAA;AACF;AACA,QAAMlC,MAAAA,OAAAA,CAAQkB,KAAK,eAAiB,EAAA;AAAEhB,UAAAA,KAAAA;UAAOrB,IAAMqD,EAAAA;SAAI,CAAA;AACvDhB,QAAAA,IAAAA,CAAKgB,GAAAA,CAAAA;AACP,OAAA;MACAE,OAAAA,GAAAA;AAAW,OAAA;AACXC,MAAAA,OAAAA,CAAQR,GAAG,EAAA;AACT,QAAM,MAAA,IAAInD,mBAAmB,CAAwC,oCAAA,CAAA,EAAA;AAACmD,UAAAA;AAAI,SAAA,CAAA;AAC5E;AACF,KAAA,CACGS,CAAAA,IAAAA,CAAK,MAAMtC,OAAAA,CAAQkB,KAAK,eAAiB,EAAA;AAAEhB,MAAAA;AAAM,KAAA,CAAA,CAAA,CACjDqC,KAAM,CAAA,OAAOC,KAAAA,KAAAA;AACZ,MAAMxC,MAAAA,OAAAA,CAAQkB,KAAK,aAAe,EAAA;AAAEhB,QAAAA,KAAAA;AAAOsC,QAAAA;OAAM,CAAA,CAAGD,KAAME,CAAAA,gBAAAA,EAAAA,CAAAA;AAC1D,MAAMD,MAAAA,KAAAA;AACR,KAAA,CACCE,CAAAA,OAAAA,CAAQ,MAAM1C,OAAAA,CAAQkB,KAAK,YAAc,EAAA;AAAEhB,MAAAA;AAAM,KAAA,CAAA,CAAA,CAAA;AAExD;EAEA,MAAMyC,KAAAA,CAAMlC,MAAeC,IAAyD,EAAA;AAClF,IAAMV,MAAAA,OAAAA,GAAU,IAAKA,CAAAA,OAAAA,CAAQK,KAAM,CAAA;MACjCM,OAAS,EAAA;KACX,CAAA;AAEA,IAAMiC,MAAAA,MAAAA,GAAS,IAAK/B,CAAAA,MAAAA,CAAOJ,IAAAA,CAAAA;AAC3B,IAAA,IAAIC,MAAMmC,YAAc,EAAA;AACtB,MAAA,KAAA,MAAW,CAAC7D,GAAAA,EAAKC,KAAAA,CAAAA,IAAUyB,KAAKmC,YAAc,EAAA;AAC5CD,QAAOC,MAAAA,CAAAA,YAAAA,CAAajD,GAAIZ,CAAAA,GAAAA,EAAKC,KAAAA,CAAAA;AAC/B;AACF;AAEA,IAAA,MAAMiB,KAAoB,GAAA;AACxBU,MAAAA,GAAAA,EAAKgC,OAAO/C,QAAQ,EAAA;MACpBiB,OAAS,EAAA;QACP,GAAGJ,IAAAA;AACHM,QAAAA,OAAAA,EAAS,MAAM,IAAA,CAAKC,UAAWP,CAAAA,IAAAA,EAAMM,OAAAA;AACvC;AACF,KAAA;AAEA,IAAMhB,MAAAA,OAAAA,CAAQkB,KAAK,YAAc,EAAA;AAAEhB,MAAAA;KAAM,CAAA;AACzC,IAAI,IAAA;AACF,MAAA,MAAMoB,WAAW,MAAMqB,KAAAA,CAAMzC,KAAMU,CAAAA,GAAAA,EAAKV,MAAMY,OAAO,CAAA;AAErD,MAAI,IAAA,CAACQ,SAASG,EAAI,EAAA;AAChB,QAAA,MAAM,IAAI/C,kBAAAA,CAAmB,kBAAoB,EAAA,EAAI,EAAA;UACnDkD,OAAS,EAAA;AACPhB,YAAAA,GAAAA,EAAKU,QAASV,CAAAA,GAAAA;YACd4B,KAAO,EAAA,MAAMlB,SAASQ,IAAI,EAAA;AAC1BR,YAAAA;AACF,WAAA;UACAS,WAAa,EAAA;AAAC,YAAA,GAAA;AAAK,YAAA;YAAKL,QAASJ,CAAAA,QAAAA,CAASU,UAAU,GAAA;SACtD,CAAA;AACF;AAEA,MAAMnD,MAAAA,IAAAA,GAAO,MAAMyC,QAAAA,CAASwB,IAAI,EAAA;AAChC,MAAM9C,MAAAA,OAAAA,CAAQkB,KAAK,cAAgB,EAAA;AAAEI,QAAAA,QAAAA;AAAUzC,QAAAA,IAAAA;AAAMqB,QAAAA;OAAM,CAAA;AAC3D,MAAOrB,OAAAA,IAAAA;AACT,KAAA,CAAA,OAAS2D,KAAO,EAAA;AACd,MAAMxC,MAAAA,OAAAA,CAAQkB,KAAK,YAAc,EAAA;AAAEsB,QAAAA,KAAAA;AAAOtC,QAAAA;OAAa,CAAA;AACvD,MAAMsC,MAAAA,KAAAA;KACR,SAAA;AACE,MAAMxC,MAAAA,OAAAA,CAAQkB,KAAK,WAAa,EAAA;AAAEhB,QAAAA;OAAa,CAAA;AACjD;AACF;AAEA,EAAA,MAAgBe,WAAW8B,KAAsD,EAAA;AAC/E,IAAA,MAAMC,QAAQ,EAAC;AACf,IAAA,KAAA,MAAWC,QAAY,IAAA;MAAC,MAAM,IAAA,CAAK/C,MAAMc,OAAO,IAAA;AAAM+B,MAAAA;AAAOG,KAAAA,CAAAA,MAAAA,CAAOC,eAAAA,CAAW,EAAA;AAC7E,MAAA,IAAI7D,cAAQ2D,CAAAA,QAAAA,CAAaA,IAAAA,QAAAA,YAAoBG,OAAS,EAAA;AACpDlE,QAAAA,MAAAA,CAAOmE,OAAOL,KAAO9D,EAAAA,MAAAA,CAAOoE,YAAYL,QAAS9D,CAAAA,OAAAA,EAAO,CAAA,CAAA;OACnD,MAAA;AACLD,QAAOmE,MAAAA,CAAAA,MAAAA,CAAOL,OAAOC,QAAAA,CAAAA;AACvB;AACF;AACA,IAAOD,OAAAA,KAAAA;AACT;AAEUnC,EAAAA,MAAAA,CAAOJ,IAAoB,EAAA;AACnC,IAAA,MAAMG,GAAM,GAAA,IAAI2C,GAAI,CAAA,IAAA,CAAKrD,MAAMsD,OAAO,CAAA;AACtC,IAAA,MAAMC,SAAY,GAAA,IAAA,CAAKvD,KAAMwD,CAAAA,KAAAA,CAAMjD,IAAAA,CAASA,IAAAA,IAAAA;AAC5C,IAAA,IAAIG,GAAI+C,CAAAA,QAAAA,CAASC,QAAS,CAAA,GAAA,CAAM,EAAA;AAC9BhD,MAAAA,GAAAA,CAAI+C,QAAYF,IAAAA,SAAAA,CAAUI,OAAQ,CAAA,KAAA,EAAO,EAAA,CAAA;KACpC,MAAA;AACLjD,MAAAA,GAAAA,CAAI+C,QAAYF,IAAAA,SAAAA;AAClB;AACA,IAAO7C,OAAAA,GAAAA;AACT;EAEAkD,cAAiB,GAAA;AACf,IAAO,OAAA;MACL5D,KAAO6D,EAAAA,qBAAAA,CAAY,KAAK7D,KAAK,CAAA;AAC7BF,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAChB,KAAA;AACF;AAEAgE,EAAAA,YAAAA,CAAaC,QAAwD,EAAA;AACnE/E,IAAOmE,MAAAA,CAAAA,MAAAA,CAAO,MAAMY,QAAAA,CAAAA;AACtB;AACF","file":"fetcher.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\";\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,yBAAAA,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,oBAAAA,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,6BAAAA,CAAAA;EArErE;;;;EAsEkBC,OAAAA,GAAUC,mBAAAA,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,+BAAmB,OAAO,EAAED,MAAI,KAC5CE,qCAAAA,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,2CAAAA,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,gBAAAA,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,eAAAA,CAAAA,EAAW;AAC7E,MAAA,IAAI5D,cAAAA,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,qBAAAA,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.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\";\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/fetcher.d.cts

@@ -2,24 +2,13 @@ import { FrameworkError } from '../errors.cjs';
 import { Serializable } from './serializable.cjs';
 import { EventSourceMessage } from '@ai-zen/node-fetch-event-source';
 import { FetchEventSourceInit } from '@ai-zen/node-fetch-event-source/lib/cjs/fetch.js';
-import { C as Callback, E as Emitter } from '../emitter-D5Mu0EEH.cjs';
+import { C as Callback, E as Emitter } from '../emitter-DWEsd-ud.cjs';
 import './types.cjs';
 import './helpers/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 RestfulClientError extends FrameworkError {

package/dist/internals/fetcher.d.ts

@@ -2,24 +2,13 @@ import { FrameworkError } from '../errors.js';
 import { Serializable } from './serializable.js';
 import { EventSourceMessage } from '@ai-zen/node-fetch-event-source';
 import { FetchEventSourceInit } from '@ai-zen/node-fetch-event-source/lib/cjs/fetch.js';
-import { C as Callback, E as Emitter } from '../emitter-C3dO-s2P.js';
+import { C as Callback, E as Emitter } from '../emitter-C9nwGLt6.js';
 import './types.js';
 import './helpers/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 RestfulClientError extends FrameworkError {

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":"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","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"]}