@voltagent/internal 0.0.1 → 0.0.3

package/dist/main/index.d.mts

@@ -1,3 +1,5 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+
 interface DevLoggerOptions {
     dev: boolean | (() => boolean);
 }
@@ -129,4 +131,78 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
  */
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, _default as devLogger };
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
+
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/main/index.d.ts

@@ -1,3 +1,5 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+
 interface DevLoggerOptions {
     dev: boolean | (() => boolean);
 }
@@ -129,4 +131,78 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
  */
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, _default as devLogger };
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
+
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/main/index.js

@@ -2,8 +2,22 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
@@ -64,7 +78,14 @@ __export(index_exports, {
   convertReadableStreamToArray: () => convertReadableStreamToArray,
   convertResponseStreamToArray: () => convertResponseStreamToArray,
   createDevLogger: () => createDevLogger,
-  devLogger: () => logger_default
+  deepClone: () => deepClone,
+  devLogger: () => logger_default,
+  hasKey: () => hasKey,
+  isEmptyObject: () => isEmptyObject,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isObject: () => isObject,
+  isPlainObject: () => isPlainObject
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -214,6 +235,56 @@ function convertResponseStreamToArray(response) {
   });
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
+
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+
+// src/utils/objects.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   convertArrayToAsyncIterable,
@@ -222,6 +293,13 @@ __name(convertResponseStreamToArray, "convertResponseStreamToArray");
   convertReadableStreamToArray,
   convertResponseStreamToArray,
   createDevLogger,
-  devLogger
+  deepClone,
+  devLogger,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 });
 //# sourceMappingURL=index.js.map

package/dist/main/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/dev/logger.ts","../../src/test/conversions.ts"],"sourcesContent":["export * from \"./dev\";\nexport * from \"./test\";\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","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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;;;AC/ET,SAAsB,6BAAgC,QAAyC;AAAA;AAC7F,UAAM,SAAS,OAAO,UAAU;AAChC,UAAM,SAAc,CAAC;AAErB,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,aAAO,KAAK,KAAK;AAAA,IACnB;AAEA,WAAO;AAAA,EACT;AAAA;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,CAAQ,OAAO,aAAa,IAAI;AAAA;AAC9B,mBAAW,SAAS,QAAQ;AAC1B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA;AAAA,EACF;AACF;AARgB;AAehB,SAAsB,4BAA+B,UAA0C;AAAA;AAC7F,UAAM,SAAc,CAAC;AACrB;AAAA,iCAAyB,WAAzB,0EAAmC;AAAxB,cAAM,OAAjB;AACE,eAAO,KAAK,IAAI;AAAA,MAClB;AAAA,aAFA,MAxCF;AAwCE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,WAAO;AAAA,EACT;AAAA;AANsB;AAaf,SAAS,6BAAgC,QAAgC;AAC9E,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,YAAY;AAChB,UAAI;AACF,mBAAW,SAAS,QAAQ;AAC1B,qBAAW,QAAQ,KAAK;AAAA,QAC1B;AAAA,MACF,UAAE;AACA,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAZgB;AAmBhB,SAAsB,6BAA6B,UAAuC;AAAA;AAExF,WAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AAAA,EACzF;AAAA;AAHsB;","names":[]}
+{"version":3,"sources":["../../src/index.ts","../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts"],"sourcesContent":["export * from \"./dev\";\nexport * from \"./test\";\nexport * from \"./utils\";\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","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/**\n * Check if a value is nil\n *\n * @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n */\nexport function isNil(obj: unknown): obj is Nil {\n  return obj === null || obj === undefined;\n}\n\n/**\n * Check if an object is a JS object\n *\n * @param obj - The object to check\n * @returns True if the object is a JS object}\n */\nexport function isObject<T extends object>(obj: unknown): obj is T {\n  return (typeof obj === \"object\" || typeof obj === \"function\") && !isNil(obj);\n}\n\n/**\n * Check if a value is a function\n *\n * @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n */\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n  return typeof obj === \"function\";\n}\n\n/**\n * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n *\n * @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n */\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(obj);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Check if an object is an empty object\n *\n * @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n */\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  // Check for own string and symbol properties (enumerable or not)\n  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {\n    return false;\n  }\n\n  return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n\n/**\n * Check if an object has a key\n *\n * @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n  obj: T,\n  key: K,\n): obj is T & SetRequired<T, K> {\n  return isObject(obj) && key in obj;\n}\n"],"mappings":"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","names":[]}

package/dist/main/index.mjs

@@ -1,5 +1,20 @@
 var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
@@ -184,6 +199,56 @@ function convertResponseStreamToArray(response) {
   });
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
+
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+
+// src/utils/objects.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 export {
   convertArrayToAsyncIterable,
   convertArrayToReadableStream,
@@ -191,6 +256,13 @@ export {
   convertReadableStreamToArray,
   convertResponseStreamToArray,
   createDevLogger,
-  logger_default as devLogger
+  deepClone,
+  logger_default as devLogger,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 };
 //# sourceMappingURL=index.mjs.map

package/dist/main/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/logger.ts","../../src/test/conversions.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","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\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;;;AC/ET,SAAsB,6BAAgC,QAAyC;AAAA;AAC7F,UAAM,SAAS,OAAO,UAAU;AAChC,UAAM,SAAc,CAAC;AAErB,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,aAAO,KAAK,KAAK;AAAA,IACnB;AAEA,WAAO;AAAA,EACT;AAAA;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,CAAQ,OAAO,aAAa,IAAI;AAAA;AAC9B,mBAAW,SAAS,QAAQ;AAC1B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA;AAAA,EACF;AACF;AARgB;AAehB,SAAsB,4BAA+B,UAA0C;AAAA;AAC7F,UAAM,SAAc,CAAC;AACrB;AAAA,iCAAyB,WAAzB,0EAAmC;AAAxB,cAAM,OAAjB;AACE,eAAO,KAAK,IAAI;AAAA,MAClB;AAAA,aAFA,MAxCF;AAwCE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,WAAO;AAAA,EACT;AAAA;AANsB;AAaf,SAAS,6BAAgC,QAAgC;AAC9E,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,YAAY;AAChB,UAAI;AACF,mBAAW,SAAS,QAAQ;AAC1B,qBAAW,QAAQ,KAAK;AAAA,QAC1B;AAAA,MACF,UAAE;AACA,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAZgB;AAmBhB,SAAsB,6BAA6B,UAAuC;AAAA;AAExF,WAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AAAA,EACzF;AAAA;AAHsB;","names":[]}
+{"version":3,"sources":["../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.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","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/**\n * Check if a value is nil\n *\n * @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n */\nexport function isNil(obj: unknown): obj is Nil {\n  return obj === null || obj === undefined;\n}\n\n/**\n * Check if an object is a JS object\n *\n * @param obj - The object to check\n * @returns True if the object is a JS object}\n */\nexport function isObject<T extends object>(obj: unknown): obj is T {\n  return (typeof obj === \"object\" || typeof obj === \"function\") && !isNil(obj);\n}\n\n/**\n * Check if a value is a function\n *\n * @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n */\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n  return typeof obj === \"function\";\n}\n\n/**\n * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n *\n * @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n */\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(obj);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Check if an object is an empty object\n *\n * @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n */\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  // Check for own string and symbol properties (enumerable or not)\n  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {\n    return false;\n  }\n\n  return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n\n/**\n * Check if an object has a key\n *\n * @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n  obj: T,\n  key: K,\n): obj is T & SetRequired<T, K> {\n  return isObject(obj) && key in obj;\n}\n"],"mappings":"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","names":[]}

package/dist/types/index.d.mts

@@ -0,0 +1,29 @@
+/**
+ * This type is used to allow any type and bypass restrictions used in
+ * typechecking and linting. Provides a CLEAR warning this is NOT the desired
+ * behavior and is a dangerous practice.
+ */
+type DangerouslyAllowAny = any;
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+
+export type { AnyAsyncFunction, AnyFunction, AnySyncFunction, DangerouslyAllowAny, Nil, PlainObject };

package/dist/types/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * This type is used to allow any type and bypass restrictions used in
+ * typechecking and linting. Provides a CLEAR warning this is NOT the desired
+ * behavior and is a dangerous practice.
+ */
+type DangerouslyAllowAny = any;
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+
+export type { AnyAsyncFunction, AnyFunction, AnySyncFunction, DangerouslyAllowAny, Nil, PlainObject };

package/dist/utils/index.d.mts

@@ -0,0 +1,77 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
+
+export { deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/utils/index.d.ts

@@ -0,0 +1,77 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
+
+export { deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/utils/index.js

@@ -0,0 +1,185 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+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/utils/index.ts
+var index_exports = {};
+__export(index_exports, {
+  deepClone: () => deepClone,
+  hasKey: () => hasKey,
+  isEmptyObject: () => isEmptyObject,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isObject: () => isObject,
+  isPlainObject: () => isPlainObject
+});
+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");
+
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+
+// src/utils/objects.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  deepClone,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/dev/logger.ts","../../src/utils/lang.ts","../../src/utils/objects.ts"],"sourcesContent":["export { deepClone, hasKey } from \"./objects\";\nexport { isNil, isObject, isEmptyObject, isFunction, isPlainObject } from \"./lang\";\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","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/**\n * Check if a value is nil\n *\n * @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n */\nexport function isNil(obj: unknown): obj is Nil {\n  return obj === null || obj === undefined;\n}\n\n/**\n * Check if an object is a JS object\n *\n * @param obj - The object to check\n * @returns True if the object is a JS object}\n */\nexport function isObject<T extends object>(obj: unknown): obj is T {\n  return (typeof obj === \"object\" || typeof obj === \"function\") && !isNil(obj);\n}\n\n/**\n * Check if a value is a function\n *\n * @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n */\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n  return typeof obj === \"function\";\n}\n\n/**\n * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n *\n * @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n */\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(obj);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Check if an object is an empty object\n *\n * @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n */\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  // Check for own string and symbol properties (enumerable or not)\n  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {\n    return false;\n  }\n\n  return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n\n/**\n * Check if an object has a key\n *\n * @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n  obj: T,\n  key: K,\n): obj is T & SetRequired<T, K> {\n  return isObject(obj) && key in obj;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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;;;AC3EF,SAAS,MAAM,KAA0B;AAC9C,SAAO,QAAQ,QAAQ,QAAQ;AACjC;AAFgB;AAUT,SAAS,SAA2B,KAAwB;AACjE,UAAQ,OAAO,QAAQ,YAAY,OAAO,QAAQ,eAAe,CAAC,MAAM,GAAG;AAC7E;AAFgB;AAUT,SAAS,WAAkC,KAAwB;AACxE,SAAO,OAAO,QAAQ;AACxB;AAFgB;AAUT,SAAS,cAAqC,KAAwB;AAC3E,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,eAAe,GAAG;AAC3C,SAAO,cAAc,OAAO,aAAa,cAAc;AACzD;AAPgB;AAeT,SAAS,cAAc,KAAkC;AAC9D,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,oBAAoB,GAAG,EAAE,SAAS,KAAK,OAAO,sBAAsB,GAAG,EAAE,SAAS,GAAG;AAC9F,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAXgB;;;AC3CT,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;AAoBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;","names":[]}

package/dist/utils/index.mjs

@@ -0,0 +1,155 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+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");
+
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+
+// src/utils/objects.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
+export {
+  deepClone,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
+};
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/logger.ts","../../src/utils/lang.ts","../../src/utils/objects.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","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/**\n * Check if a value is nil\n *\n * @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n */\nexport function isNil(obj: unknown): obj is Nil {\n  return obj === null || obj === undefined;\n}\n\n/**\n * Check if an object is a JS object\n *\n * @param obj - The object to check\n * @returns True if the object is a JS object}\n */\nexport function isObject<T extends object>(obj: unknown): obj is T {\n  return (typeof obj === \"object\" || typeof obj === \"function\") && !isNil(obj);\n}\n\n/**\n * Check if a value is a function\n *\n * @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n */\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n  return typeof obj === \"function\";\n}\n\n/**\n * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n *\n * @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n */\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(obj);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Check if an object is an empty object\n *\n * @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n */\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n  if (!isObject(obj)) {\n    return false;\n  }\n\n  // Check for own string and symbol properties (enumerable or not)\n  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {\n    return false;\n  }\n\n  return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n\n/**\n * Check if an object has a key\n *\n * @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n  obj: T,\n  key: K,\n): obj is T & SetRequired<T, K> {\n  return isObject(obj) && key in obj;\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;;;AC3EF,SAAS,MAAM,KAA0B;AAC9C,SAAO,QAAQ,QAAQ,QAAQ;AACjC;AAFgB;AAUT,SAAS,SAA2B,KAAwB;AACjE,UAAQ,OAAO,QAAQ,YAAY,OAAO,QAAQ,eAAe,CAAC,MAAM,GAAG;AAC7E;AAFgB;AAUT,SAAS,WAAkC,KAAwB;AACxE,SAAO,OAAO,QAAQ;AACxB;AAFgB;AAUT,SAAS,cAAqC,KAAwB;AAC3E,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,eAAe,GAAG;AAC3C,SAAO,cAAc,OAAO,aAAa,cAAc;AACzD;AAPgB;AAeT,SAAS,cAAc,KAAkC;AAC9D,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,oBAAoB,GAAG,EAAE,SAAS,KAAK,OAAO,sBAAsB,GAAG,EAAE,SAAS,GAAG;AAC9F,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAXgB;;;AC3CT,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;AAoBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltagent/internal",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "VoltAgent internal - an internal set of tools for the VoltAgent packages",
   "license": "MIT",
   "exports": {
@@ -18,6 +18,14 @@
       "types": "./dist/test/index.d.ts",
       "import": "./dist/test/index.mjs",
       "require": "./dist/test/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts"
     }
   },
   "main": "dist/main/index.js",
@@ -28,12 +36,11 @@
     "dev/dist/**/*",
     "test/dist/**/*"
   ],
-  "dependencies": {
-    "@voltagent/core": "^0.1.31"
-  },
   "devDependencies": {
     "@types/node": "^24.0.3",
+    "@vitest/coverage-v8": "^3.2.4",
     "tsup": "^8.5.0",
+    "type-fest": "^4.41.0",
     "typescript": "^5.0.4",
     "vitest": "^3.2.4"
   },