@voltagent/internal 0.0.1

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VoltAgent Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# `@voltagent/internal`
+
+An internal set of tools for the VoltAgent packages.
+
+## 🚀 Quick Start
+
+```bash
+pnpm add @voltagent/internal
+```
+
+```typescript
+import { devLogger } from "@voltagent/internal";
+
+// will only log if process.env.NODE_ENV is "development"
+devLogger.info("Hello, world!");
+```
+
+## 📦 Imports
+
+You can also import specific subsets of the package:
+
+```typescript
+import { devLogger } from "@voltagent/internal/dev";
+import { convertArrayToAsyncIterable } from "@voltagent/internal/test";
+```
+
+Allowing you to only import the tools you need.
+
+## 📄 License
+
+MIT License - see LICENSE file for details.

package/dist/dev/index.d.mts

@@ -0,0 +1,101 @@
+interface DevLoggerOptions {
+    dev: boolean | (() => boolean);
+}
+/**
+ * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not "development").
+ *
+ * @example
+ * ```typescript
+ * devLogger.info("Hello, world!");
+ * ```
+ */
+declare function createDevLogger(options?: DevLoggerOptions): {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: (message?: any, ...args: any[]) => void;
+};
+declare const _default: {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: (message?: any, ...args: any[]) => void;
+};
+
+export { type DevLoggerOptions, createDevLogger, _default as devLogger };

package/dist/dev/index.d.ts

@@ -0,0 +1,101 @@
+interface DevLoggerOptions {
+    dev: boolean | (() => boolean);
+}
+/**
+ * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not "development").
+ *
+ * @example
+ * ```typescript
+ * devLogger.info("Hello, world!");
+ * ```
+ */
+declare function createDevLogger(options?: DevLoggerOptions): {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: (message?: any, ...args: any[]) => void;
+};
+declare const _default: {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: (message?: any, ...args: any[]) => void;
+};
+
+export { type DevLoggerOptions, createDevLogger, _default as devLogger };

package/dist/dev/index.js

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/dev/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createDevLogger: () => createDevLogger,
+  devLogger: () => logger_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/dev/logger.ts
+function createDevLogger(options) {
+  const isDev = typeof (options == null ? void 0 : options.dev) === "function" ? options.dev : () => {
+    var _a;
+    return (_a = options == null ? void 0 : options.dev) != null ? _a : isDevNodeEnv();
+  };
+  return {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.info(formatLogPrefix("INFO"), message, ...args);
+      }
+    }, "info"),
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.warn(formatLogPrefix("WARN"), message, ...args);
+      }
+    }, "warn"),
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.error(formatLogPrefix("ERROR"), message, ...args);
+      }
+    }, "error")
+  };
+}
+__name(createDevLogger, "createDevLogger");
+var logger_default = createDevLogger();
+function isDevNodeEnv() {
+  return process.env.NODE_ENV === "development";
+}
+__name(isDevNodeEnv, "isDevNodeEnv");
+function formatLogPrefix(level) {
+  return `[VoltAgent] [${timestamp()}] ${level}: `;
+}
+__name(formatLogPrefix, "formatLogPrefix");
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, -1);
+}
+__name(timestamp, "timestamp");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDevLogger,
+  devLogger
+});
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/index.ts","../../src/dev/logger.ts"],"sourcesContent":["export { createDevLogger, default as devLogger } from \"./logger\";\nexport type { DevLoggerOptions } from \"./logger\";\n","export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,EAKT;AACF;AA5DgB;AA8DhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAFS;AAIT,SAAS,gBAAgB,OAA0C;AACjE,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;","names":[]}

package/dist/dev/index.mjs

@@ -0,0 +1,85 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/dev/logger.ts
+function createDevLogger(options) {
+  const isDev = typeof (options == null ? void 0 : options.dev) === "function" ? options.dev : () => {
+    var _a;
+    return (_a = options == null ? void 0 : options.dev) != null ? _a : isDevNodeEnv();
+  };
+  return {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.info(formatLogPrefix("INFO"), message, ...args);
+      }
+    }, "info"),
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.warn(formatLogPrefix("WARN"), message, ...args);
+      }
+    }, "warn"),
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.error(formatLogPrefix("ERROR"), message, ...args);
+      }
+    }, "error")
+  };
+}
+__name(createDevLogger, "createDevLogger");
+var logger_default = createDevLogger();
+function isDevNodeEnv() {
+  return process.env.NODE_ENV === "development";
+}
+__name(isDevNodeEnv, "isDevNodeEnv");
+function formatLogPrefix(level) {
+  return `[VoltAgent] [${timestamp()}] ${level}: `;
+}
+__name(formatLogPrefix, "formatLogPrefix");
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, -1);
+}
+__name(timestamp, "timestamp");
+export {
+  createDevLogger,
+  logger_default as devLogger
+};
+//# sourceMappingURL=index.mjs.map

package/dist/dev/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/logger.ts"],"sourcesContent":["export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n"],"mappings":";;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,EAKT;AACF;AA5DgB;AA8DhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAFS;AAIT,SAAS,gBAAgB,OAA0C;AACjE,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;","names":[]}

package/dist/main/index.d.mts

@@ -0,0 +1,132 @@
+interface DevLoggerOptions {
+    dev: boolean | (() => boolean);
+}
+/**
+ * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not "development").
+ *
+ * @example
+ * ```typescript
+ * devLogger.info("Hello, world!");
+ * ```
+ */
+declare function createDevLogger(options?: DevLoggerOptions): {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: (message?: any, ...args: any[]) => void;
+};
+declare const _default: {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: (message?: any, ...args: any[]) => void;
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: (message?: any, ...args: any[]) => void;
+};
+
+/**
+ * Convert a readable stream to an array
+ * @param stream - The readable stream to convert
+ * @returns The array of values
+ */
+declare function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]>;
+/**
+ * Convert an array to an async iterable
+ * @param values - The array to convert
+ * @returns The async iterable
+ */
+declare function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T>;
+/**
+ * Convert an async iterable to an array
+ * @param iterable - The async iterable to convert
+ * @returns The array of values
+ */
+declare function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]>;
+/**
+ * Convert an array to a readable stream
+ * @param values - The array to convert
+ * @returns The readable stream
+ */
+declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>;
+/**
+ * Convert a response stream to an array
+ * @param response - The response to convert
+ * @returns The array of values
+ */
+declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
+
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, _default as devLogger };