@voltagent/internal 0.0.2 → 0.0.3

package/dist/main/index.d.mts

@@ -1,3 +1,5 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+
 interface DevLoggerOptions {
     dev: boolean | (() => boolean);
 }
@@ -130,8 +132,27 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
 /**
- * Object manipulation utility functions
+ * 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
  *
@@ -139,5 +160,49 @@ declare function convertResponseStreamToArray(response: Response): Promise<strin
  * @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 };
+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);
 }
@@ -130,8 +132,27 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
 /**
- * Object manipulation utility functions
+ * 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
  *
@@ -139,5 +160,49 @@ declare function convertResponseStreamToArray(response: Response): Promise<strin
  * @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 };
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/main/index.js

@@ -79,7 +79,13 @@ __export(index_exports, {
   convertResponseStreamToArray: () => convertResponseStreamToArray,
   createDevLogger: () => createDevLogger,
   deepClone: () => deepClone,
-  devLogger: () => logger_default
+  devLogger: () => logger_default,
+  hasKey: () => hasKey,
+  isEmptyObject: () => isEmptyObject,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isObject: () => isObject,
+  isPlainObject: () => isPlainObject
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -230,7 +236,39 @@ function convertResponseStreamToArray(response) {
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
 
-// src/utils/object-utils.ts
+// 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));
@@ -243,6 +281,10 @@ function deepClone(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,
@@ -252,6 +294,12 @@ __name(deepClone, "deepClone");
   convertResponseStreamToArray,
   createDevLogger,
   deepClone,
-  devLogger
+  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","../../src/utils/object-utils.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","/**\n * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\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"],"mappings":"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","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

@@ -200,7 +200,39 @@ function convertResponseStreamToArray(response) {
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
 
-// src/utils/object-utils.ts
+// 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));
@@ -213,6 +245,10 @@ function deepClone(obj) {
   }
 }
 __name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 export {
   convertArrayToAsyncIterable,
   convertArrayToReadableStream,
@@ -221,6 +257,12 @@ export {
   convertResponseStreamToArray,
   createDevLogger,
   deepClone,
-  logger_default as devLogger
+  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","../../src/utils/object-utils.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","/**\n * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\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"],"mappings":"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","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

@@ -1,6 +1,27 @@
+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>;
 /**
- * Object manipulation utility functions
+ * 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
  *
@@ -8,5 +29,49 @@
  * @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 };
+export { deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/utils/index.d.ts

@@ -1,6 +1,27 @@
+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>;
 /**
- * Object manipulation utility functions
+ * 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
  *
@@ -8,5 +29,49 @@
  * @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 };
+export { deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/utils/index.js

@@ -35,7 +35,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/utils/index.ts
 var index_exports = {};
 __export(index_exports, {
-  deepClone: () => deepClone
+  deepClone: () => deepClone,
+  hasKey: () => hasKey,
+  isEmptyObject: () => isEmptyObject,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isObject: () => isObject,
+  isPlainObject: () => isPlainObject
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -117,7 +123,39 @@ function timestamp() {
 }
 __name(timestamp, "timestamp");
 
-// src/utils/object-utils.ts
+// 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));
@@ -130,8 +168,18 @@ function deepClone(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
+  deepClone,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 });
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/index.ts","../../src/dev/logger.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export { deepClone } from \"./object-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 * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;ACxEF,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;","names":[]}
+{"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

@@ -94,7 +94,39 @@ function timestamp() {
 }
 __name(timestamp, "timestamp");
 
-// src/utils/object-utils.ts
+// 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));
@@ -107,7 +139,17 @@ function deepClone(obj) {
   }
 }
 __name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 export {
-  deepClone
+  deepClone,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/logger.ts","../../src/utils/object-utils.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 * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\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"],"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;;;ACxEF,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;","names":[]}
+{"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.2",
+  "version": "0.0.3",
   "description": "VoltAgent internal - an internal set of tools for the VoltAgent packages",
   "license": "MIT",
   "exports": {
@@ -23,6 +23,9 @@
       "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",
@@ -33,12 +36,11 @@
     "dev/dist/**/*",
     "test/dist/**/*"
   ],
-  "dependencies": {
-    "@voltagent/core": "^0.1.44"
-  },
   "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"
   },