beeai-framework 0.1.2

package/dist/internals/env.d.ts

@@ -0,0 +1,27 @@
+import { ZodSchema, z } from 'zod';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function getEnv(key: string, fallback?: never): string | undefined;
+declare function getEnv(key: string, fallback: string): string;
+declare function parseEnv<T extends ZodSchema>(key: string, schema: T, defaultValue?: string): z.output<T>;
+declare namespace parseEnv {
+    var asBoolean: (key: string, fallback?: boolean) => boolean;
+}
+declare function hasEnv(key: string): boolean;
+
+export { getEnv, hasEnv, parseEnv };

package/dist/internals/env.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { FrameworkError } from '../errors.js';
+import { getProp } from './helpers/object.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function getEnv(key, fallback) {
+  return getProp(process.env, [
+    key
+  ], fallback);
+}
+__name(getEnv, "getEnv");
+function parseEnv(key, schema, defaultValue) {
+  const value = getEnv(key) ?? defaultValue;
+  const result = schema.safeParse(value);
+  if (!result.success) {
+    if (value === void 0) {
+      throw new FrameworkError(`Required variable '${key}' is not set!`);
+    }
+    throw new FrameworkError(`Failed to parse ENV variable (${key})!`, [
+      result.error
+    ]);
+  }
+  return result.data;
+}
+__name(parseEnv, "parseEnv");
+parseEnv.asBoolean = (key, fallback = false) => {
+  return parseEnv(key, z.string(), String(fallback)).trim().toLowerCase() === "true";
+};
+function hasEnv(key) {
+  return getProp(process.env, [
+    key
+  ]) !== void 0;
+}
+__name(hasEnv, "hasEnv");
+
+export { getEnv, hasEnv, parseEnv };
+//# sourceMappingURL=env.js.map
+//# sourceMappingURL=env.js.map

package/dist/internals/env.js.map

@@ -0,0 +1 @@
+{"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":";;;;;;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,KAAW,CAAA,EAAA;AACvB,MAAA,MAAM,IAAIC,cAAAA,CAAe,CAAsBb,mBAAAA,EAAAA,GAAAA,CAAkB,aAAA,CAAA,CAAA;AACnE;AAEA,IAAA,MAAM,IAAIa,cAAAA,CAAe,CAAiCb,8BAAAA,EAAAA,GAAAA,CAAS,EAAA,CAAA,EAAA;MAACS,MAAOK,CAAAA;AAAM,KAAA,CAAA;AACnF;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,KAAAA,CAAAA;AACzC;AAFgBU,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA","file":"env.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { 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(`Required variable '${key}' is not set!`);\n    }\n\n    throw new FrameworkError(`Failed to parse ENV 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

@@ -0,0 +1,189 @@
+'use strict';
+
+var errors_cjs = require('../errors.cjs');
+var serializable_cjs = require('./serializable.cjs');
+var nodeFetchEventSource = require('@ai-zen/node-fetch-event-source');
+var promise_cjs = require('./helpers/promise.cjs');
+var remeda = require('remeda');
+var emitter_cjs = require('../emitter/emitter.cjs');
+var utils_cjs = require('../serializer/utils.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class RestfulClientError extends errors_cjs.FrameworkError {
+  static {
+    __name(this, "RestfulClientError");
+  }
+}
+function createURLParams(data) {
+  const urlTokenParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(data)) {
+    if (value === void 0) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((v) => {
+        if (v !== void 0) {
+          urlTokenParams.append(key, String(v));
+        }
+      });
+    } else if (remeda.isPlainObject(value)) {
+      urlTokenParams.set(key, createURLParams(value).toString());
+    } else {
+      urlTokenParams.set(key, String(value));
+    }
+  }
+  return urlTokenParams;
+}
+__name(createURLParams, "createURLParams");
+class RestfulClient extends serializable_cjs.Serializable {
+  static {
+    __name(this, "RestfulClient");
+  }
+  input;
+  emitter;
+  constructor(input) {
+    super(), this.input = input, this.emitter = emitter_cjs.Emitter.root.child({
+      namespace: [
+        "internals",
+        "restfulClient"
+      ],
+      creator: this
+    });
+  }
+  async *stream(path, init) {
+    const { paths, baseUrl, headers } = this.input;
+    const emitter = this.emitter.child({
+      groupId: "stream"
+    });
+    const input = {
+      url: new URL(paths[path] ?? path, baseUrl).toString(),
+      options: {
+        ...init,
+        method: "POST",
+        headers: await headers().then((raw) => Object.assign(Object.fromEntries(raw.entries()), init?.headers))
+      }
+    };
+    await emitter.emit("streamStart", {
+      input
+    });
+    return yield* promise_cjs.emitterToGenerator(async ({ emit }) => nodeFetchEventSource.fetchEventSource(input.url, {
+      ...input.options,
+      async onopen(response) {
+        if (response.ok && response.headers.get("content-type") === nodeFetchEventSource.EventStreamContentType) {
+          await emitter.emit("streamOpen", {
+            input
+          });
+          return;
+        }
+        throw new RestfulClientError("Failed to stream!", [], {
+          context: {
+            url: response.url,
+            err: await response.text(),
+            response
+          },
+          isRetryable: response.status >= 400 && response.status < 500 && response.status !== 429
+        });
+      },
+      async onmessage(msg) {
+        if (msg?.event === "error") {
+          throw new RestfulClientError(`Error during streaming has occurred.`, [], {
+            context: msg
+          });
+        }
+        await emitter.emit("streamMessage", {
+          input,
+          data: msg
+        });
+        emit(msg);
+      },
+      onclose() {
+      },
+      onerror(err) {
+        throw new RestfulClientError(`Error during streaming has occurred.`, [
+          err
+        ]);
+      }
+    }).then(() => emitter.emit("streamSuccess", {
+      input
+    })).catch(async (error) => {
+      await emitter.emit("streamError", {
+        input,
+        error
+      }).catch(remeda.doNothing());
+      throw error;
+    }).finally(() => emitter.emit("streamDone", {
+      input
+    })));
+  }
+  async fetch(path, init) {
+    const emitter = this.emitter.child({
+      groupId: "fetch"
+    });
+    const { paths, baseUrl, headers: getHeaders } = this.input;
+    const target = new URL(paths[path] ?? path, baseUrl);
+    if (init?.searchParams) {
+      for (const [key, value] of init.searchParams) {
+        target.searchParams.set(key, value);
+      }
+    }
+    const input = {
+      url: target.toString(),
+      options: {
+        ...init,
+        headers: await getHeaders().then((raw) => Object.assign(Object.fromEntries(raw.entries()), init?.headers))
+      }
+    };
+    await emitter.emit("fetchStart", {
+      input
+    });
+    try {
+      const response = await fetch(input.url, input.options);
+      if (!response.ok) {
+        throw new RestfulClientError("Fetch has failed", [], {
+          context: {
+            url: response.url,
+            error: await response.text(),
+            response
+          },
+          isRetryable: [
+            408,
+            503
+          ].includes(response.status ?? 500)
+        });
+      }
+      const data = await response.json();
+      await emitter.emit("fetchSuccess", {
+        response,
+        data,
+        input
+      });
+      return data;
+    } catch (error) {
+      await emitter.emit("fetchError", {
+        error,
+        input
+      });
+      throw error;
+    } finally {
+      await emitter.emit("fetchDone", {
+        input
+      });
+    }
+  }
+  createSnapshot() {
+    return {
+      input: utils_cjs.shallowCopy(this.input),
+      emitter: this.emitter
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+exports.RestfulClient = RestfulClient;
+exports.RestfulClientError = RestfulClientError;
+exports.createURLParams = createURLParams;
+//# sourceMappingURL=fetcher.cjs.map
+//# sourceMappingURL=fetcher.cjs.map

package/dist/internals/fetcher.cjs.map

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

package/dist/internals/fetcher.d.cts

@@ -0,0 +1,101 @@
+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-BWtGHYn0.cjs';
+import './types.cjs';
+import './helpers/guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class RestfulClientError extends FrameworkError {
+}
+type URLParamType = string | number | boolean | null | undefined;
+declare function createURLParams(data: Record<string, URLParamType | URLParamType[] | Record<string, any>>): URLSearchParams;
+interface FetchInput {
+    url: string;
+    options: RequestInit;
+}
+interface StreamInput {
+    url: string;
+    options: FetchEventSourceInit;
+}
+interface RestfulClientEvents {
+    fetchStart: Callback<{
+        input: FetchInput;
+    }>;
+    fetchError: Callback<{
+        error: Error;
+        input: FetchInput;
+    }>;
+    fetchSuccess: Callback<{
+        response: Response;
+        data: any;
+        input: FetchInput;
+    }>;
+    fetchDone: Callback<{
+        input: FetchInput;
+    }>;
+    streamStart: Callback<{
+        input: StreamInput;
+    }>;
+    streamOpen: Callback<{
+        input: StreamInput;
+    }>;
+    streamSuccess: Callback<{
+        input: StreamInput;
+    }>;
+    streamMessage: Callback<{
+        data: EventSourceMessage;
+        input: StreamInput;
+    }>;
+    streamError: Callback<{
+        error: Error;
+        input: StreamInput;
+    }>;
+    streamDone: Callback<{
+        input: StreamInput;
+    }>;
+}
+declare class RestfulClient<K extends Record<string, string>> extends Serializable {
+    protected input: {
+        baseUrl: string;
+        headers: () => Promise<Headers>;
+        paths: K;
+    };
+    readonly emitter: Emitter<RestfulClientEvents>;
+    constructor(input: {
+        baseUrl: string;
+        headers: () => Promise<Headers>;
+        paths: K;
+    });
+    stream(path: keyof K, init: FetchEventSourceInit): AsyncGenerator<EventSourceMessage, void, void>;
+    fetch(path: keyof K, init?: RequestInit & {
+        searchParams?: URLSearchParams;
+    }): Promise<any>;
+    createSnapshot(): {
+        input: {
+            baseUrl: string;
+            headers: () => Promise<Headers>;
+            paths: K;
+        };
+        emitter: Emitter<RestfulClientEvents>;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { RestfulClient, RestfulClientError, type RestfulClientEvents, type StreamInput, createURLParams };

package/dist/internals/fetcher.d.ts

@@ -0,0 +1,101 @@
+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-l0W9gC1A.js';
+import './types.js';
+import './helpers/guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class RestfulClientError extends FrameworkError {
+}
+type URLParamType = string | number | boolean | null | undefined;
+declare function createURLParams(data: Record<string, URLParamType | URLParamType[] | Record<string, any>>): URLSearchParams;
+interface FetchInput {
+    url: string;
+    options: RequestInit;
+}
+interface StreamInput {
+    url: string;
+    options: FetchEventSourceInit;
+}
+interface RestfulClientEvents {
+    fetchStart: Callback<{
+        input: FetchInput;
+    }>;
+    fetchError: Callback<{
+        error: Error;
+        input: FetchInput;
+    }>;
+    fetchSuccess: Callback<{
+        response: Response;
+        data: any;
+        input: FetchInput;
+    }>;
+    fetchDone: Callback<{
+        input: FetchInput;
+    }>;
+    streamStart: Callback<{
+        input: StreamInput;
+    }>;
+    streamOpen: Callback<{
+        input: StreamInput;
+    }>;
+    streamSuccess: Callback<{
+        input: StreamInput;
+    }>;
+    streamMessage: Callback<{
+        data: EventSourceMessage;
+        input: StreamInput;
+    }>;
+    streamError: Callback<{
+        error: Error;
+        input: StreamInput;
+    }>;
+    streamDone: Callback<{
+        input: StreamInput;
+    }>;
+}
+declare class RestfulClient<K extends Record<string, string>> extends Serializable {
+    protected input: {
+        baseUrl: string;
+        headers: () => Promise<Headers>;
+        paths: K;
+    };
+    readonly emitter: Emitter<RestfulClientEvents>;
+    constructor(input: {
+        baseUrl: string;
+        headers: () => Promise<Headers>;
+        paths: K;
+    });
+    stream(path: keyof K, init: FetchEventSourceInit): AsyncGenerator<EventSourceMessage, void, void>;
+    fetch(path: keyof K, init?: RequestInit & {
+        searchParams?: URLSearchParams;
+    }): Promise<any>;
+    createSnapshot(): {
+        input: {
+            baseUrl: string;
+            headers: () => Promise<Headers>;
+            paths: K;
+        };
+        emitter: Emitter<RestfulClientEvents>;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { RestfulClient, RestfulClientError, type RestfulClientEvents, type StreamInput, createURLParams };

package/dist/internals/fetcher.js

@@ -0,0 +1,185 @@
+import { FrameworkError } from '../errors.js';
+import { Serializable } from './serializable.js';
+import { fetchEventSource, EventStreamContentType } from '@ai-zen/node-fetch-event-source';
+import { emitterToGenerator } from './helpers/promise.js';
+import { doNothing, isPlainObject } from 'remeda';
+import { Emitter } from '../emitter/emitter.js';
+import { shallowCopy } from '../serializer/utils.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class RestfulClientError extends FrameworkError {
+  static {
+    __name(this, "RestfulClientError");
+  }
+}
+function createURLParams(data) {
+  const urlTokenParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(data)) {
+    if (value === void 0) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((v) => {
+        if (v !== void 0) {
+          urlTokenParams.append(key, String(v));
+        }
+      });
+    } else if (isPlainObject(value)) {
+      urlTokenParams.set(key, createURLParams(value).toString());
+    } else {
+      urlTokenParams.set(key, String(value));
+    }
+  }
+  return urlTokenParams;
+}
+__name(createURLParams, "createURLParams");
+class RestfulClient extends Serializable {
+  static {
+    __name(this, "RestfulClient");
+  }
+  input;
+  emitter;
+  constructor(input) {
+    super(), this.input = input, this.emitter = Emitter.root.child({
+      namespace: [
+        "internals",
+        "restfulClient"
+      ],
+      creator: this
+    });
+  }
+  async *stream(path, init) {
+    const { paths, baseUrl, headers } = this.input;
+    const emitter = this.emitter.child({
+      groupId: "stream"
+    });
+    const input = {
+      url: new URL(paths[path] ?? path, baseUrl).toString(),
+      options: {
+        ...init,
+        method: "POST",
+        headers: await headers().then((raw) => Object.assign(Object.fromEntries(raw.entries()), init?.headers))
+      }
+    };
+    await emitter.emit("streamStart", {
+      input
+    });
+    return yield* emitterToGenerator(async ({ emit }) => fetchEventSource(input.url, {
+      ...input.options,
+      async onopen(response) {
+        if (response.ok && response.headers.get("content-type") === EventStreamContentType) {
+          await emitter.emit("streamOpen", {
+            input
+          });
+          return;
+        }
+        throw new RestfulClientError("Failed to stream!", [], {
+          context: {
+            url: response.url,
+            err: await response.text(),
+            response
+          },
+          isRetryable: response.status >= 400 && response.status < 500 && response.status !== 429
+        });
+      },
+      async onmessage(msg) {
+        if (msg?.event === "error") {
+          throw new RestfulClientError(`Error during streaming has occurred.`, [], {
+            context: msg
+          });
+        }
+        await emitter.emit("streamMessage", {
+          input,
+          data: msg
+        });
+        emit(msg);
+      },
+      onclose() {
+      },
+      onerror(err) {
+        throw new RestfulClientError(`Error during streaming has occurred.`, [
+          err
+        ]);
+      }
+    }).then(() => emitter.emit("streamSuccess", {
+      input
+    })).catch(async (error) => {
+      await emitter.emit("streamError", {
+        input,
+        error
+      }).catch(doNothing());
+      throw error;
+    }).finally(() => emitter.emit("streamDone", {
+      input
+    })));
+  }
+  async fetch(path, init) {
+    const emitter = this.emitter.child({
+      groupId: "fetch"
+    });
+    const { paths, baseUrl, headers: getHeaders } = this.input;
+    const target = new URL(paths[path] ?? path, baseUrl);
+    if (init?.searchParams) {
+      for (const [key, value] of init.searchParams) {
+        target.searchParams.set(key, value);
+      }
+    }
+    const input = {
+      url: target.toString(),
+      options: {
+        ...init,
+        headers: await getHeaders().then((raw) => Object.assign(Object.fromEntries(raw.entries()), init?.headers))
+      }
+    };
+    await emitter.emit("fetchStart", {
+      input
+    });
+    try {
+      const response = await fetch(input.url, input.options);
+      if (!response.ok) {
+        throw new RestfulClientError("Fetch has failed", [], {
+          context: {
+            url: response.url,
+            error: await response.text(),
+            response
+          },
+          isRetryable: [
+            408,
+            503
+          ].includes(response.status ?? 500)
+        });
+      }
+      const data = await response.json();
+      await emitter.emit("fetchSuccess", {
+        response,
+        data,
+        input
+      });
+      return data;
+    } catch (error) {
+      await emitter.emit("fetchError", {
+        error,
+        input
+      });
+      throw error;
+    } finally {
+      await emitter.emit("fetchDone", {
+        input
+      });
+    }
+  }
+  createSnapshot() {
+    return {
+      input: shallowCopy(this.input),
+      emitter: this.emitter
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+export { RestfulClient, RestfulClientError, createURLParams };
+//# sourceMappingURL=fetcher.js.map
+//# sourceMappingURL=fetcher.js.map