@voltagent/internal 0.0.7 → 0.0.9

package/dist/main/index.d.mts

@@ -32,107 +32,11 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
 /**
- * Shared logger types for VoltAgent
- * These types define the minimal logger interface that both core and logger packages use
- */
-/**
- * Valid log levels
- */
-type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "silent";
-/**
- * Log function signatures
- */
-type LogFn = (msg: string, context?: object) => void;
-/**
- * Minimal logger interface for VoltAgent
- * This interface is implemented by @voltagent/logger and can be implemented by other logging solutions
- */
-interface Logger {
-    /**
-     * Log at trace level - most detailed level
-     */
-    trace: LogFn;
-    /**
-     * Log at debug level - detailed information for debugging
-     */
-    debug: LogFn;
-    /**
-     * Log at info level - general informational messages
-     */
-    info: LogFn;
-    /**
-     * Log at warn level - warning messages
-     */
-    warn: LogFn;
-    /**
-     * Log at error level - error messages
-     */
-    error: LogFn;
-    /**
-     * Log at fatal level - fatal error messages
-     */
-    fatal: LogFn;
-    /**
-     * Create a child logger with additional context
-     * @param bindings - Additional context to bind to the child logger
-     */
-    child(bindings: Record<string, any>): Logger;
-}
-/**
- * Logger options for configuration
- */
-interface LoggerOptions {
-    /**
-     * Log level
-     */
-    level?: string;
-    /**
-     * Logger name
-     */
-    name?: string;
-    /**
-     * Additional options specific to the logger implementation
-     */
-    [key: string]: any;
-}
-/**
- * Log entry structure
- */
-interface LogEntry {
-    timestamp: string;
-    level: LogLevel;
-    msg: string;
-    component?: string;
-    agentId?: string;
-    conversationId?: string;
-    workflowId?: string;
-    executionId?: string;
-    userId?: string;
-    [key: string]: any;
-}
-/**
- * Log filter for querying logs
- */
-interface LogFilter {
-    level?: LogLevel;
-    agentId?: string;
-    conversationId?: string;
-    workflowId?: string;
-    executionId?: string;
-    since?: Date;
-    until?: Date;
-    limit?: number;
-}
-/**
- * Log buffer interface for storing logs in memory
+ * 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.
  */
-interface LogBuffer {
-    add(entry: LogEntry): void;
-    query(filter?: LogFilter): LogEntry[];
-    clear(): void;
-    size(): number;
-}
-
+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.
@@ -156,13 +60,12 @@ type AnySyncFunction = (...args: unknown[]) => unknown;
 type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 
 /**
- * Deep clone an object using JSON serialization with fallback to shallow clone
+ * Deep clone an object
  *
  * @param obj - The object to clone
- * @param logger - Optional logger for warnings
- * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ * @returns A deep copy of the object (fallback to shallow clone for failures)
  */
-declare function deepClone<T>(obj: T, logger?: Logger): T;
+declare function deepClone<T>(obj: T): T;
 /**
  * Check if an object has a key
  *
@@ -238,4 +141,120 @@ type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;
  */
 declare function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T>;
 
-export { type AsyncIterableStream, type LogBuffer, type LogEntry, type LogFilter, type LogFn, type LogLevel, type Logger, type LoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };
+type SafeStringifyOptions = {
+    /**
+     * The indentation to use for the output.
+     */
+    indentation?: string | number;
+};
+/**
+ * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.
+ * @param input - The object to stringify.
+ * @param options.indentation - The indentation to use for the output.
+ * @returns The stringified object.
+ */
+declare function safeStringify(input: DangerouslyAllowAny, { indentation }?: SafeStringifyOptions): string;
+
+/**
+ * Shared logger types for VoltAgent
+ * These types define the minimal logger interface that both core and logger packages use
+ */
+/**
+ * Valid log levels
+ */
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "silent";
+/**
+ * Log function signatures
+ */
+type LogFn = (msg: string, context?: object) => void;
+/**
+ * Minimal logger interface for VoltAgent
+ * This interface is implemented by @voltagent/logger and can be implemented by other logging solutions
+ */
+interface Logger {
+    /**
+     * Log at trace level - most detailed level
+     */
+    trace: LogFn;
+    /**
+     * Log at debug level - detailed information for debugging
+     */
+    debug: LogFn;
+    /**
+     * Log at info level - general informational messages
+     */
+    info: LogFn;
+    /**
+     * Log at warn level - warning messages
+     */
+    warn: LogFn;
+    /**
+     * Log at error level - error messages
+     */
+    error: LogFn;
+    /**
+     * Log at fatal level - fatal error messages
+     */
+    fatal: LogFn;
+    /**
+     * Create a child logger with additional context
+     * @param bindings - Additional context to bind to the child logger
+     */
+    child(bindings: Record<string, any>): Logger;
+}
+/**
+ * Logger options for configuration
+ */
+interface LoggerOptions {
+    /**
+     * Log level
+     */
+    level?: string;
+    /**
+     * Logger name
+     */
+    name?: string;
+    /**
+     * Additional options specific to the logger implementation
+     */
+    [key: string]: any;
+}
+/**
+ * Log entry structure
+ */
+interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    msg: string;
+    component?: string;
+    agentId?: string;
+    conversationId?: string;
+    workflowId?: string;
+    executionId?: string;
+    userId?: string;
+    [key: string]: any;
+}
+/**
+ * Log filter for querying logs
+ */
+interface LogFilter {
+    level?: LogLevel;
+    agentId?: string;
+    conversationId?: string;
+    workflowId?: string;
+    executionId?: string;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+}
+/**
+ * Log buffer interface for storing logs in memory
+ */
+interface LogBuffer {
+    add(entry: LogEntry): void;
+    query(filter?: LogFilter): LogEntry[];
+    clear(): void;
+    size(): number;
+}
+
+export { type AsyncIterableStream, type LogBuffer, type LogEntry, type LogFilter, type LogFn, type LogLevel, type Logger, type LoggerOptions, type SafeStringifyOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject, safeStringify };

package/dist/main/index.d.ts

@@ -32,107 +32,11 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
 /**
- * Shared logger types for VoltAgent
- * These types define the minimal logger interface that both core and logger packages use
- */
-/**
- * Valid log levels
- */
-type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "silent";
-/**
- * Log function signatures
- */
-type LogFn = (msg: string, context?: object) => void;
-/**
- * Minimal logger interface for VoltAgent
- * This interface is implemented by @voltagent/logger and can be implemented by other logging solutions
- */
-interface Logger {
-    /**
-     * Log at trace level - most detailed level
-     */
-    trace: LogFn;
-    /**
-     * Log at debug level - detailed information for debugging
-     */
-    debug: LogFn;
-    /**
-     * Log at info level - general informational messages
-     */
-    info: LogFn;
-    /**
-     * Log at warn level - warning messages
-     */
-    warn: LogFn;
-    /**
-     * Log at error level - error messages
-     */
-    error: LogFn;
-    /**
-     * Log at fatal level - fatal error messages
-     */
-    fatal: LogFn;
-    /**
-     * Create a child logger with additional context
-     * @param bindings - Additional context to bind to the child logger
-     */
-    child(bindings: Record<string, any>): Logger;
-}
-/**
- * Logger options for configuration
- */
-interface LoggerOptions {
-    /**
-     * Log level
-     */
-    level?: string;
-    /**
-     * Logger name
-     */
-    name?: string;
-    /**
-     * Additional options specific to the logger implementation
-     */
-    [key: string]: any;
-}
-/**
- * Log entry structure
- */
-interface LogEntry {
-    timestamp: string;
-    level: LogLevel;
-    msg: string;
-    component?: string;
-    agentId?: string;
-    conversationId?: string;
-    workflowId?: string;
-    executionId?: string;
-    userId?: string;
-    [key: string]: any;
-}
-/**
- * Log filter for querying logs
- */
-interface LogFilter {
-    level?: LogLevel;
-    agentId?: string;
-    conversationId?: string;
-    workflowId?: string;
-    executionId?: string;
-    since?: Date;
-    until?: Date;
-    limit?: number;
-}
-/**
- * Log buffer interface for storing logs in memory
+ * 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.
  */
-interface LogBuffer {
-    add(entry: LogEntry): void;
-    query(filter?: LogFilter): LogEntry[];
-    clear(): void;
-    size(): number;
-}
-
+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.
@@ -156,13 +60,12 @@ type AnySyncFunction = (...args: unknown[]) => unknown;
 type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 
 /**
- * Deep clone an object using JSON serialization with fallback to shallow clone
+ * Deep clone an object
  *
  * @param obj - The object to clone
- * @param logger - Optional logger for warnings
- * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ * @returns A deep copy of the object (fallback to shallow clone for failures)
  */
-declare function deepClone<T>(obj: T, logger?: Logger): T;
+declare function deepClone<T>(obj: T): T;
 /**
  * Check if an object has a key
  *
@@ -238,4 +141,120 @@ type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;
  */
 declare function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T>;
 
-export { type AsyncIterableStream, type LogBuffer, type LogEntry, type LogFilter, type LogFn, type LogLevel, type Logger, type LoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };
+type SafeStringifyOptions = {
+    /**
+     * The indentation to use for the output.
+     */
+    indentation?: string | number;
+};
+/**
+ * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.
+ * @param input - The object to stringify.
+ * @param options.indentation - The indentation to use for the output.
+ * @returns The stringified object.
+ */
+declare function safeStringify(input: DangerouslyAllowAny, { indentation }?: SafeStringifyOptions): string;
+
+/**
+ * Shared logger types for VoltAgent
+ * These types define the minimal logger interface that both core and logger packages use
+ */
+/**
+ * Valid log levels
+ */
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "silent";
+/**
+ * Log function signatures
+ */
+type LogFn = (msg: string, context?: object) => void;
+/**
+ * Minimal logger interface for VoltAgent
+ * This interface is implemented by @voltagent/logger and can be implemented by other logging solutions
+ */
+interface Logger {
+    /**
+     * Log at trace level - most detailed level
+     */
+    trace: LogFn;
+    /**
+     * Log at debug level - detailed information for debugging
+     */
+    debug: LogFn;
+    /**
+     * Log at info level - general informational messages
+     */
+    info: LogFn;
+    /**
+     * Log at warn level - warning messages
+     */
+    warn: LogFn;
+    /**
+     * Log at error level - error messages
+     */
+    error: LogFn;
+    /**
+     * Log at fatal level - fatal error messages
+     */
+    fatal: LogFn;
+    /**
+     * Create a child logger with additional context
+     * @param bindings - Additional context to bind to the child logger
+     */
+    child(bindings: Record<string, any>): Logger;
+}
+/**
+ * Logger options for configuration
+ */
+interface LoggerOptions {
+    /**
+     * Log level
+     */
+    level?: string;
+    /**
+     * Logger name
+     */
+    name?: string;
+    /**
+     * Additional options specific to the logger implementation
+     */
+    [key: string]: any;
+}
+/**
+ * Log entry structure
+ */
+interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    msg: string;
+    component?: string;
+    agentId?: string;
+    conversationId?: string;
+    workflowId?: string;
+    executionId?: string;
+    userId?: string;
+    [key: string]: any;
+}
+/**
+ * Log filter for querying logs
+ */
+interface LogFilter {
+    level?: LogLevel;
+    agentId?: string;
+    conversationId?: string;
+    workflowId?: string;
+    executionId?: string;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+}
+/**
+ * Log buffer interface for storing logs in memory
+ */
+interface LogBuffer {
+    add(entry: LogEntry): void;
+    query(filter?: LogFilter): LogEntry[];
+    clear(): void;
+    size(): number;
+}
+
+export { type AsyncIterableStream, type LogBuffer, type LogEntry, type LogFilter, type LogFn, type LogLevel, type Logger, type LoggerOptions, type SafeStringifyOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject, safeStringify };

package/dist/main/index.js

@@ -33,7 +33,8 @@ __export(index_exports, {
   isFunction: () => isFunction,
   isNil: () => isNil,
   isObject: () => isObject,
-  isPlainObject: () => isPlainObject
+  isPlainObject: () => isPlainObject,
+  safeStringify: () => safeStringify
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -119,13 +120,13 @@ function isEmptyObject(obj) {
 __name(isEmptyObject, "isEmptyObject");
 
 // src/utils/objects.ts
-function deepClone(obj, logger) {
+function deepClone(obj) {
   try {
-    return JSON.parse(JSON.stringify(obj));
-  } catch (error) {
-    if (logger) {
-      logger.warn("Failed to deep clone object, using shallow clone", { error });
+    if (typeof structuredClone === "function") {
+      return structuredClone(obj);
     }
+    throw new Error("structuredClone is not available");
+  } catch (_error) {
     if (obj === null || typeof obj !== "object") {
       return obj;
     }
@@ -153,6 +154,39 @@ function createAsyncIterableStream(source) {
   return stream;
 }
 __name(createAsyncIterableStream, "createAsyncIterableStream");
+
+// src/utils/safe-stringify.ts
+function safeStringify(input, { indentation } = {}) {
+  try {
+    const seen = /* @__PURE__ */ new WeakSet();
+    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);
+  } catch (error) {
+    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : "Unknown error"}`;
+  }
+}
+__name(safeStringify, "safeStringify");
+function safeStringifyReplacer(seen) {
+  const replacer = /* @__PURE__ */ __name((_key, value) => {
+    if (typeof value?.toJSON === "function") {
+      value = value.toJSON();
+    }
+    if (!(value !== null && typeof value === "object")) {
+      return value;
+    }
+    if (seen.has(value)) {
+      return "[Circular]";
+    }
+    seen.add(value);
+    const newValue = Array.isArray(value) ? [] : {};
+    for (const [key2, value2] of Object.entries(value)) {
+      newValue[key2] = replacer(key2, value2);
+    }
+    seen.delete(value);
+    return newValue;
+  }, "replacer");
+  return replacer;
+}
+__name(safeStringifyReplacer, "safeStringifyReplacer");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   convertArrayToAsyncIterable,
@@ -167,6 +201,7 @@ __name(createAsyncIterableStream, "createAsyncIterableStream");
   isFunction,
   isNil,
   isObject,
-  isPlainObject
+  isPlainObject,
+  safeStringify
 });
 //# sourceMappingURL=index.js.map

package/dist/main/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts"],"sourcesContent":["export * from \"./test\";\nexport * from \"./utils\";\nexport * from \"./logger/types\";\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 type { Logger } from \"../logger/types\";\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 * @param logger - Optional logger for warnings\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T, logger?: Logger): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    if (logger) {\n      logger.warn(\"Failed to deep clone object, using shallow clone\", { error });\n    }\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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/index.ts","../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts","../../src/utils/safe-stringify.ts"],"sourcesContent":["export * from \"./test\";\nexport * from \"./utils\";\nexport type * from \"./logger/types\";\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 type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object (fallback to shallow clone for failures)\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    // Use structuredClone if available (Node.js 17+, modern browsers)\n    if (typeof structuredClone === \"function\") {\n      return structuredClone(obj);\n    }\n\n    throw new Error(\"structuredClone is not available\");\n  } catch (_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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n","import type { DangerouslyAllowAny } from \"../types\";\n\nexport type SafeStringifyOptions = {\n  /**\n   * The indentation to use for the output.\n   */\n  indentation?: string | number;\n};\n\n/**\n * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.\n * @param input - The object to stringify.\n * @param options.indentation - The indentation to use for the output.\n * @returns The stringified object.\n */\nexport function safeStringify(\n  input: DangerouslyAllowAny,\n  { indentation }: SafeStringifyOptions = {},\n) {\n  try {\n    const seen = new WeakSet();\n    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);\n  } catch (error) {\n    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : \"Unknown error\"}`;\n  }\n}\n\nfunction safeStringifyReplacer(seen: WeakSet<DangerouslyAllowAny>) {\n  const replacer = (_key: string, value: DangerouslyAllowAny) => {\n    // Handle objects with a custom `.toJSON()` method.\n    if (typeof value?.toJSON === \"function\") {\n      // biome-ignore lint/style/noParameterAssign: needed to handle circular references\n      value = value.toJSON();\n    }\n\n    if (!(value !== null && typeof value === \"object\")) {\n      return value;\n    }\n\n    if (seen.has(value)) {\n      return \"[Circular]\";\n    }\n\n    seen.add(value);\n\n    const newValue = Array.isArray(value) ? [] : {};\n\n    for (const [key2, value2] of Object.entries(value)) {\n      // @ts-expect-error - ignore as this is needed to handle circular references\n      newValue[key2] = replacer(key2, value2);\n    }\n\n    seen.delete(value);\n\n    return newValue;\n  };\n\n  return replacer;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,eAAsB,6BAAgC,QAAyC;AAC7F,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,SAAc,CAAC;AAErB,SAAO,MAAM;AACX,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,QAAI,KAAM;AACV,WAAO,KAAK,KAAK;AAAA,EACnB;AAEA,SAAO;AACT;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,QAAQ,OAAO,aAAa,IAAI;AAC9B,iBAAW,SAAS,QAAQ;AAC1B,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AARgB;AAehB,eAAsB,4BAA+B,UAA0C;AAC7F,QAAM,SAAc,CAAC;AACrB,mBAAiB,QAAQ,UAAU;AACjC,WAAO,KAAK,IAAI;AAAA,EAClB;AACA,SAAO;AACT;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,eAAsB,6BAA6B,UAAuC;AAExF,SAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AACzF;AAHsB;;;AC7Df,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;;;AC5CT,SAAS,UAAa,KAAW;AACtC,MAAI;AAEF,QAAI,OAAO,oBAAoB,YAAY;AACzC,aAAO,gBAAgB,GAAG;AAAA,IAC5B;AAEA,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACpD,SAAS,QAAQ;AAEf,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,EAAE,GAAG,IAAI;AAAA,EAClB;AACF;AAfgB;AAwBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;;;ACHT,SAAS,0BAA6B,QAAmD;AAC9F,QAAM,SAAS,OAAO,YAAY,IAAI,gBAAsB,CAAC;AAE7D,EAAC,OAAkC,OAAO,aAAa,IAAI,MAAM;AAC/D,UAAM,SAAS,OAAO,UAAU;AAChC,WAAO;AAAA,MACL,MAAM,OAAmC;AACvC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,eAAO,OAAO,EAAE,MAAM,MAAM,OAAO,OAAU,IAAI,EAAE,MAAM,OAAO,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAdgB;;;AChBT,SAAS,cACd,OACA,EAAE,YAAY,IAA0B,CAAC,GACzC;AACA,MAAI;AACF,UAAM,OAAO,oBAAI,QAAQ;AACzB,WAAO,KAAK,UAAU,OAAO,sBAAsB,IAAI,GAAG,WAAW;AAAA,EACvE,SAAS,OAAO;AACd,WAAO,oDAAoD,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,EACrH;AACF;AAVgB;AAYhB,SAAS,sBAAsB,MAAoC;AACjE,QAAM,WAAW,wBAAC,MAAc,UAA+B;AAE7D,QAAI,OAAO,OAAO,WAAW,YAAY;AAEvC,cAAQ,MAAM,OAAO;AAAA,IACvB;AAEA,QAAI,EAAE,UAAU,QAAQ,OAAO,UAAU,WAAW;AAClD,aAAO;AAAA,IACT;AAEA,QAAI,KAAK,IAAI,KAAK,GAAG;AACnB,aAAO;AAAA,IACT;AAEA,SAAK,IAAI,KAAK;AAEd,UAAM,WAAW,MAAM,QAAQ,KAAK,IAAI,CAAC,IAAI,CAAC;AAE9C,eAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,KAAK,GAAG;AAElD,eAAS,IAAI,IAAI,SAAS,MAAM,MAAM;AAAA,IACxC;AAEA,SAAK,OAAO,KAAK;AAEjB,WAAO;AAAA,EACT,GA3BiB;AA6BjB,SAAO;AACT;AA/BS;","names":[]}

package/dist/main/index.mjs

@@ -83,13 +83,13 @@ function isEmptyObject(obj) {
 __name(isEmptyObject, "isEmptyObject");
 
 // src/utils/objects.ts
-function deepClone(obj, logger) {
+function deepClone(obj) {
   try {
-    return JSON.parse(JSON.stringify(obj));
-  } catch (error) {
-    if (logger) {
-      logger.warn("Failed to deep clone object, using shallow clone", { error });
+    if (typeof structuredClone === "function") {
+      return structuredClone(obj);
     }
+    throw new Error("structuredClone is not available");
+  } catch (_error) {
     if (obj === null || typeof obj !== "object") {
       return obj;
     }
@@ -117,6 +117,39 @@ function createAsyncIterableStream(source) {
   return stream;
 }
 __name(createAsyncIterableStream, "createAsyncIterableStream");
+
+// src/utils/safe-stringify.ts
+function safeStringify(input, { indentation } = {}) {
+  try {
+    const seen = /* @__PURE__ */ new WeakSet();
+    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);
+  } catch (error) {
+    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : "Unknown error"}`;
+  }
+}
+__name(safeStringify, "safeStringify");
+function safeStringifyReplacer(seen) {
+  const replacer = /* @__PURE__ */ __name((_key, value) => {
+    if (typeof value?.toJSON === "function") {
+      value = value.toJSON();
+    }
+    if (!(value !== null && typeof value === "object")) {
+      return value;
+    }
+    if (seen.has(value)) {
+      return "[Circular]";
+    }
+    seen.add(value);
+    const newValue = Array.isArray(value) ? [] : {};
+    for (const [key2, value2] of Object.entries(value)) {
+      newValue[key2] = replacer(key2, value2);
+    }
+    seen.delete(value);
+    return newValue;
+  }, "replacer");
+  return replacer;
+}
+__name(safeStringifyReplacer, "safeStringifyReplacer");
 export {
   convertArrayToAsyncIterable,
   convertArrayToReadableStream,
@@ -130,6 +163,7 @@ export {
   isFunction,
   isNil,
   isObject,
-  isPlainObject
+  isPlainObject,
+  safeStringify
 };
 //# sourceMappingURL=index.mjs.map

package/dist/main/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts"],"sourcesContent":["/**\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 type { Logger } from \"../logger/types\";\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 * @param logger - Optional logger for warnings\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T, logger?: Logger): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    if (logger) {\n      logger.warn(\"Failed to deep clone object, using shallow clone\", { error });\n    }\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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n"],"mappings":";;;;AAKA,eAAsB,6BAAgC,QAAyC;AAC7F,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,SAAc,CAAC;AAErB,SAAO,MAAM;AACX,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,QAAI,KAAM;AACV,WAAO,KAAK,KAAK;AAAA,EACnB;AAEA,SAAO;AACT;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,QAAQ,OAAO,aAAa,IAAI;AAC9B,iBAAW,SAAS,QAAQ;AAC1B,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AARgB;AAehB,eAAsB,4BAA+B,UAA0C;AAC7F,QAAM,SAAc,CAAC;AACrB,mBAAiB,QAAQ,UAAU;AACjC,WAAO,KAAK,IAAI;AAAA,EAClB;AACA,SAAO;AACT;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,eAAsB,6BAA6B,UAAuC;AAExF,SAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AACzF;AAHsB;;;AC7Df,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;;;AC1CT,SAAS,UAAa,KAAQ,QAAoB;AACvD,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,QAAI,QAAQ;AACV,aAAO,KAAK,oDAAoD,EAAE,MAAM,CAAC;AAAA,IAC3E;AAEA,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,EAAE,GAAG,IAAI;AAAA,EAClB;AACF;AAbgB;AAsBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;;;ACHT,SAAS,0BAA6B,QAAmD;AAC9F,QAAM,SAAS,OAAO,YAAY,IAAI,gBAAsB,CAAC;AAE7D,EAAC,OAAkC,OAAO,aAAa,IAAI,MAAM;AAC/D,UAAM,SAAS,OAAO,UAAU;AAChC,WAAO;AAAA,MACL,MAAM,OAAmC;AACvC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,eAAO,OAAO,EAAE,MAAM,MAAM,OAAO,OAAU,IAAI,EAAE,MAAM,OAAO,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAdgB;","names":[]}
+{"version":3,"sources":["../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts","../../src/utils/safe-stringify.ts"],"sourcesContent":["/**\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 type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object (fallback to shallow clone for failures)\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    // Use structuredClone if available (Node.js 17+, modern browsers)\n    if (typeof structuredClone === \"function\") {\n      return structuredClone(obj);\n    }\n\n    throw new Error(\"structuredClone is not available\");\n  } catch (_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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n","import type { DangerouslyAllowAny } from \"../types\";\n\nexport type SafeStringifyOptions = {\n  /**\n   * The indentation to use for the output.\n   */\n  indentation?: string | number;\n};\n\n/**\n * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.\n * @param input - The object to stringify.\n * @param options.indentation - The indentation to use for the output.\n * @returns The stringified object.\n */\nexport function safeStringify(\n  input: DangerouslyAllowAny,\n  { indentation }: SafeStringifyOptions = {},\n) {\n  try {\n    const seen = new WeakSet();\n    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);\n  } catch (error) {\n    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : \"Unknown error\"}`;\n  }\n}\n\nfunction safeStringifyReplacer(seen: WeakSet<DangerouslyAllowAny>) {\n  const replacer = (_key: string, value: DangerouslyAllowAny) => {\n    // Handle objects with a custom `.toJSON()` method.\n    if (typeof value?.toJSON === \"function\") {\n      // biome-ignore lint/style/noParameterAssign: needed to handle circular references\n      value = value.toJSON();\n    }\n\n    if (!(value !== null && typeof value === \"object\")) {\n      return value;\n    }\n\n    if (seen.has(value)) {\n      return \"[Circular]\";\n    }\n\n    seen.add(value);\n\n    const newValue = Array.isArray(value) ? [] : {};\n\n    for (const [key2, value2] of Object.entries(value)) {\n      // @ts-expect-error - ignore as this is needed to handle circular references\n      newValue[key2] = replacer(key2, value2);\n    }\n\n    seen.delete(value);\n\n    return newValue;\n  };\n\n  return replacer;\n}\n"],"mappings":"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","names":[]}

package/dist/utils/index.d.mts

@@ -1,45 +1,11 @@
 import { SetRequired, EmptyObject, Merge } from 'type-fest';
 
 /**
- * Log function signatures
+ * 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 LogFn = (msg: string, context?: object) => void;
-/**
- * Minimal logger interface for VoltAgent
- * This interface is implemented by @voltagent/logger and can be implemented by other logging solutions
- */
-interface Logger {
-    /**
-     * Log at trace level - most detailed level
-     */
-    trace: LogFn;
-    /**
-     * Log at debug level - detailed information for debugging
-     */
-    debug: LogFn;
-    /**
-     * Log at info level - general informational messages
-     */
-    info: LogFn;
-    /**
-     * Log at warn level - warning messages
-     */
-    warn: LogFn;
-    /**
-     * Log at error level - error messages
-     */
-    error: LogFn;
-    /**
-     * Log at fatal level - fatal error messages
-     */
-    fatal: LogFn;
-    /**
-     * Create a child logger with additional context
-     * @param bindings - Additional context to bind to the child logger
-     */
-    child(bindings: Record<string, any>): Logger;
-}
-
+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.
@@ -63,13 +29,12 @@ type AnySyncFunction = (...args: unknown[]) => unknown;
 type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 
 /**
- * Deep clone an object using JSON serialization with fallback to shallow clone
+ * Deep clone an object
  *
  * @param obj - The object to clone
- * @param logger - Optional logger for warnings
- * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ * @returns A deep copy of the object (fallback to shallow clone for failures)
  */
-declare function deepClone<T>(obj: T, logger?: Logger): T;
+declare function deepClone<T>(obj: T): T;
 /**
  * Check if an object has a key
  *
@@ -145,4 +110,18 @@ type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;
  */
 declare function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T>;
 
-export { type AsyncIterableStream, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };
+type SafeStringifyOptions = {
+    /**
+     * The indentation to use for the output.
+     */
+    indentation?: string | number;
+};
+/**
+ * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.
+ * @param input - The object to stringify.
+ * @param options.indentation - The indentation to use for the output.
+ * @returns The stringified object.
+ */
+declare function safeStringify(input: DangerouslyAllowAny, { indentation }?: SafeStringifyOptions): string;
+
+export { type AsyncIterableStream, type SafeStringifyOptions, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject, safeStringify };

package/dist/utils/index.d.ts

@@ -1,45 +1,11 @@
 import { SetRequired, EmptyObject, Merge } from 'type-fest';
 
 /**
- * Log function signatures
+ * 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 LogFn = (msg: string, context?: object) => void;
-/**
- * Minimal logger interface for VoltAgent
- * This interface is implemented by @voltagent/logger and can be implemented by other logging solutions
- */
-interface Logger {
-    /**
-     * Log at trace level - most detailed level
-     */
-    trace: LogFn;
-    /**
-     * Log at debug level - detailed information for debugging
-     */
-    debug: LogFn;
-    /**
-     * Log at info level - general informational messages
-     */
-    info: LogFn;
-    /**
-     * Log at warn level - warning messages
-     */
-    warn: LogFn;
-    /**
-     * Log at error level - error messages
-     */
-    error: LogFn;
-    /**
-     * Log at fatal level - fatal error messages
-     */
-    fatal: LogFn;
-    /**
-     * Create a child logger with additional context
-     * @param bindings - Additional context to bind to the child logger
-     */
-    child(bindings: Record<string, any>): Logger;
-}
-
+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.
@@ -63,13 +29,12 @@ type AnySyncFunction = (...args: unknown[]) => unknown;
 type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 
 /**
- * Deep clone an object using JSON serialization with fallback to shallow clone
+ * Deep clone an object
  *
  * @param obj - The object to clone
- * @param logger - Optional logger for warnings
- * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ * @returns A deep copy of the object (fallback to shallow clone for failures)
  */
-declare function deepClone<T>(obj: T, logger?: Logger): T;
+declare function deepClone<T>(obj: T): T;
 /**
  * Check if an object has a key
  *
@@ -145,4 +110,18 @@ type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;
  */
 declare function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T>;
 
-export { type AsyncIterableStream, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };
+type SafeStringifyOptions = {
+    /**
+     * The indentation to use for the output.
+     */
+    indentation?: string | number;
+};
+/**
+ * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.
+ * @param input - The object to stringify.
+ * @param options.indentation - The indentation to use for the output.
+ * @returns The stringified object.
+ */
+declare function safeStringify(input: DangerouslyAllowAny, { indentation }?: SafeStringifyOptions): string;
+
+export { type AsyncIterableStream, type SafeStringifyOptions, createAsyncIterableStream, deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject, safeStringify };

package/dist/utils/index.js

@@ -28,7 +28,8 @@ __export(index_exports, {
   isFunction: () => isFunction,
   isNil: () => isNil,
   isObject: () => isObject,
-  isPlainObject: () => isPlainObject
+  isPlainObject: () => isPlainObject,
+  safeStringify: () => safeStringify
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -65,13 +66,13 @@ function isEmptyObject(obj) {
 __name(isEmptyObject, "isEmptyObject");
 
 // src/utils/objects.ts
-function deepClone(obj, logger) {
+function deepClone(obj) {
   try {
-    return JSON.parse(JSON.stringify(obj));
-  } catch (error) {
-    if (logger) {
-      logger.warn("Failed to deep clone object, using shallow clone", { error });
+    if (typeof structuredClone === "function") {
+      return structuredClone(obj);
     }
+    throw new Error("structuredClone is not available");
+  } catch (_error) {
     if (obj === null || typeof obj !== "object") {
       return obj;
     }
@@ -99,6 +100,39 @@ function createAsyncIterableStream(source) {
   return stream;
 }
 __name(createAsyncIterableStream, "createAsyncIterableStream");
+
+// src/utils/safe-stringify.ts
+function safeStringify(input, { indentation } = {}) {
+  try {
+    const seen = /* @__PURE__ */ new WeakSet();
+    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);
+  } catch (error) {
+    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : "Unknown error"}`;
+  }
+}
+__name(safeStringify, "safeStringify");
+function safeStringifyReplacer(seen) {
+  const replacer = /* @__PURE__ */ __name((_key, value) => {
+    if (typeof value?.toJSON === "function") {
+      value = value.toJSON();
+    }
+    if (!(value !== null && typeof value === "object")) {
+      return value;
+    }
+    if (seen.has(value)) {
+      return "[Circular]";
+    }
+    seen.add(value);
+    const newValue = Array.isArray(value) ? [] : {};
+    for (const [key2, value2] of Object.entries(value)) {
+      newValue[key2] = replacer(key2, value2);
+    }
+    seen.delete(value);
+    return newValue;
+  }, "replacer");
+  return replacer;
+}
+__name(safeStringifyReplacer, "safeStringifyReplacer");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createAsyncIterableStream,
@@ -108,6 +142,7 @@ __name(createAsyncIterableStream, "createAsyncIterableStream");
   isFunction,
   isNil,
   isObject,
-  isPlainObject
+  isPlainObject,
+  safeStringify
 });
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts"],"sourcesContent":["export { deepClone, hasKey } from \"./objects\";\nexport { isNil, isObject, isEmptyObject, isFunction, isPlainObject } from \"./lang\";\nexport type { AsyncIterableStream } from \"./async-iterable-stream\";\nexport { createAsyncIterableStream } from \"./async-iterable-stream\";\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 type { Logger } from \"../logger/types\";\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 * @param logger - Optional logger for warnings\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T, logger?: Logger): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    if (logger) {\n      logger.warn(\"Failed to deep clone object, using shallow clone\", { error });\n    }\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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSO,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;;;AC1CT,SAAS,UAAa,KAAQ,QAAoB;AACvD,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,QAAI,QAAQ;AACV,aAAO,KAAK,oDAAoD,EAAE,MAAM,CAAC;AAAA,IAC3E;AAEA,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,EAAE,GAAG,IAAI;AAAA,EAClB;AACF;AAbgB;AAsBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;;;ACHT,SAAS,0BAA6B,QAAmD;AAC9F,QAAM,SAAS,OAAO,YAAY,IAAI,gBAAsB,CAAC;AAE7D,EAAC,OAAkC,OAAO,aAAa,IAAI,MAAM;AAC/D,UAAM,SAAS,OAAO,UAAU;AAChC,WAAO;AAAA,MACL,MAAM,OAAmC;AACvC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,eAAO,OAAO,EAAE,MAAM,MAAM,OAAO,OAAU,IAAI,EAAE,MAAM,OAAO,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAdgB;","names":[]}
+{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts","../../src/utils/safe-stringify.ts"],"sourcesContent":["export { deepClone, hasKey } from \"./objects\";\nexport { isNil, isObject, isEmptyObject, isFunction, isPlainObject } from \"./lang\";\nexport type { AsyncIterableStream } from \"./async-iterable-stream\";\nexport { createAsyncIterableStream } from \"./async-iterable-stream\";\nexport { safeStringify, type SafeStringifyOptions } from \"./safe-stringify\";\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 type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object (fallback to shallow clone for failures)\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    // Use structuredClone if available (Node.js 17+, modern browsers)\n    if (typeof structuredClone === \"function\") {\n      return structuredClone(obj);\n    }\n\n    throw new Error(\"structuredClone is not available\");\n  } catch (_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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n","import type { DangerouslyAllowAny } from \"../types\";\n\nexport type SafeStringifyOptions = {\n  /**\n   * The indentation to use for the output.\n   */\n  indentation?: string | number;\n};\n\n/**\n * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.\n * @param input - The object to stringify.\n * @param options.indentation - The indentation to use for the output.\n * @returns The stringified object.\n */\nexport function safeStringify(\n  input: DangerouslyAllowAny,\n  { indentation }: SafeStringifyOptions = {},\n) {\n  try {\n    const seen = new WeakSet();\n    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);\n  } catch (error) {\n    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : \"Unknown error\"}`;\n  }\n}\n\nfunction safeStringifyReplacer(seen: WeakSet<DangerouslyAllowAny>) {\n  const replacer = (_key: string, value: DangerouslyAllowAny) => {\n    // Handle objects with a custom `.toJSON()` method.\n    if (typeof value?.toJSON === \"function\") {\n      // biome-ignore lint/style/noParameterAssign: needed to handle circular references\n      value = value.toJSON();\n    }\n\n    if (!(value !== null && typeof value === \"object\")) {\n      return value;\n    }\n\n    if (seen.has(value)) {\n      return \"[Circular]\";\n    }\n\n    seen.add(value);\n\n    const newValue = Array.isArray(value) ? [] : {};\n\n    for (const [key2, value2] of Object.entries(value)) {\n      // @ts-expect-error - ignore as this is needed to handle circular references\n      newValue[key2] = replacer(key2, value2);\n    }\n\n    seen.delete(value);\n\n    return newValue;\n  };\n\n  return replacer;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSO,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;;;AC5CT,SAAS,UAAa,KAAW;AACtC,MAAI;AAEF,QAAI,OAAO,oBAAoB,YAAY;AACzC,aAAO,gBAAgB,GAAG;AAAA,IAC5B;AAEA,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACpD,SAAS,QAAQ;AAEf,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,EAAE,GAAG,IAAI;AAAA,EAClB;AACF;AAfgB;AAwBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;;;ACHT,SAAS,0BAA6B,QAAmD;AAC9F,QAAM,SAAS,OAAO,YAAY,IAAI,gBAAsB,CAAC;AAE7D,EAAC,OAAkC,OAAO,aAAa,IAAI,MAAM;AAC/D,UAAM,SAAS,OAAO,UAAU;AAChC,WAAO;AAAA,MACL,MAAM,OAAmC;AACvC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,eAAO,OAAO,EAAE,MAAM,MAAM,OAAO,OAAU,IAAI,EAAE,MAAM,OAAO,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAdgB;;;AChBT,SAAS,cACd,OACA,EAAE,YAAY,IAA0B,CAAC,GACzC;AACA,MAAI;AACF,UAAM,OAAO,oBAAI,QAAQ;AACzB,WAAO,KAAK,UAAU,OAAO,sBAAsB,IAAI,GAAG,WAAW;AAAA,EACvE,SAAS,OAAO;AACd,WAAO,oDAAoD,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,EACrH;AACF;AAVgB;AAYhB,SAAS,sBAAsB,MAAoC;AACjE,QAAM,WAAW,wBAAC,MAAc,UAA+B;AAE7D,QAAI,OAAO,OAAO,WAAW,YAAY;AAEvC,cAAQ,MAAM,OAAO;AAAA,IACvB;AAEA,QAAI,EAAE,UAAU,QAAQ,OAAO,UAAU,WAAW;AAClD,aAAO;AAAA,IACT;AAEA,QAAI,KAAK,IAAI,KAAK,GAAG;AACnB,aAAO;AAAA,IACT;AAEA,SAAK,IAAI,KAAK;AAEd,UAAM,WAAW,MAAM,QAAQ,KAAK,IAAI,CAAC,IAAI,CAAC;AAE9C,eAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,KAAK,GAAG;AAElD,eAAS,IAAI,IAAI,SAAS,MAAM,MAAM;AAAA,IACxC;AAEA,SAAK,OAAO,KAAK;AAEjB,WAAO;AAAA,EACT,GA3BiB;AA6BjB,SAAO;AACT;AA/BS;","names":[]}

package/dist/utils/index.mjs

@@ -34,13 +34,13 @@ function isEmptyObject(obj) {
 __name(isEmptyObject, "isEmptyObject");
 
 // src/utils/objects.ts
-function deepClone(obj, logger) {
+function deepClone(obj) {
   try {
-    return JSON.parse(JSON.stringify(obj));
-  } catch (error) {
-    if (logger) {
-      logger.warn("Failed to deep clone object, using shallow clone", { error });
+    if (typeof structuredClone === "function") {
+      return structuredClone(obj);
     }
+    throw new Error("structuredClone is not available");
+  } catch (_error) {
     if (obj === null || typeof obj !== "object") {
       return obj;
     }
@@ -68,6 +68,39 @@ function createAsyncIterableStream(source) {
   return stream;
 }
 __name(createAsyncIterableStream, "createAsyncIterableStream");
+
+// src/utils/safe-stringify.ts
+function safeStringify(input, { indentation } = {}) {
+  try {
+    const seen = /* @__PURE__ */ new WeakSet();
+    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);
+  } catch (error) {
+    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : "Unknown error"}`;
+  }
+}
+__name(safeStringify, "safeStringify");
+function safeStringifyReplacer(seen) {
+  const replacer = /* @__PURE__ */ __name((_key, value) => {
+    if (typeof value?.toJSON === "function") {
+      value = value.toJSON();
+    }
+    if (!(value !== null && typeof value === "object")) {
+      return value;
+    }
+    if (seen.has(value)) {
+      return "[Circular]";
+    }
+    seen.add(value);
+    const newValue = Array.isArray(value) ? [] : {};
+    for (const [key2, value2] of Object.entries(value)) {
+      newValue[key2] = replacer(key2, value2);
+    }
+    seen.delete(value);
+    return newValue;
+  }, "replacer");
+  return replacer;
+}
+__name(safeStringifyReplacer, "safeStringifyReplacer");
 export {
   createAsyncIterableStream,
   deepClone,
@@ -76,6 +109,7 @@ export {
   isFunction,
   isNil,
   isObject,
-  isPlainObject
+  isPlainObject,
+  safeStringify
 };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts"],"sourcesContent":["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 type { Logger } from \"../logger/types\";\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 * @param logger - Optional logger for warnings\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T, logger?: Logger): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    if (logger) {\n      logger.warn(\"Failed to deep clone object, using shallow clone\", { error });\n    }\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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n"],"mappings":";;;;AASO,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;;;AC1CT,SAAS,UAAa,KAAQ,QAAoB;AACvD,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,QAAI,QAAQ;AACV,aAAO,KAAK,oDAAoD,EAAE,MAAM,CAAC;AAAA,IAC3E;AAEA,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,EAAE,GAAG,IAAI;AAAA,EAClB;AACF;AAbgB;AAsBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;;;ACHT,SAAS,0BAA6B,QAAmD;AAC9F,QAAM,SAAS,OAAO,YAAY,IAAI,gBAAsB,CAAC;AAE7D,EAAC,OAAkC,OAAO,aAAa,IAAI,MAAM;AAC/D,UAAM,SAAS,OAAO,UAAU;AAChC,WAAO;AAAA,MACL,MAAM,OAAmC;AACvC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,eAAO,OAAO,EAAE,MAAM,MAAM,OAAO,OAAU,IAAI,EAAE,MAAM,OAAO,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAdgB;","names":[]}
+{"version":3,"sources":["../../src/utils/lang.ts","../../src/utils/objects.ts","../../src/utils/async-iterable-stream.ts","../../src/utils/safe-stringify.ts"],"sourcesContent":["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 type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/**\n * Deep clone an object\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object (fallback to shallow clone for failures)\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    // Use structuredClone if available (Node.js 17+, modern browsers)\n    if (typeof structuredClone === \"function\") {\n      return structuredClone(obj);\n    }\n\n    throw new Error(\"structuredClone is not available\");\n  } catch (_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","import type { Merge } from \"type-fest\";\n\n/**\n * An async iterable stream that can be read from.\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = getStream();\n * for await (const chunk of stream) {\n *   console.log(chunk);\n * }\n * ```\n */\nexport type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;\n\n/**\n * Create an async iterable stream from a readable stream.\n *\n * This is useful for creating an async iterable stream from a readable stream.\n *\n * @example\n * ```typescript\n * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({\n *   start(controller) {\n *     controller.enqueue(\"Hello\");\n *     controller.close();\n *   },\n * }));\n * ```\n * @param source The readable stream to create an async iterable stream from.\n * @returns The async iterable stream.\n */\nexport function createAsyncIterableStream<T>(source: ReadableStream<T>): AsyncIterableStream<T> {\n  const stream = source.pipeThrough(new TransformStream<T, T>());\n\n  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = () => {\n    const reader = stream.getReader();\n    return {\n      async next(): Promise<IteratorResult<T>> {\n        const { done, value } = await reader.read();\n        return done ? { done: true, value: undefined } : { done: false, value };\n      },\n    };\n  };\n\n  return stream as AsyncIterableStream<T>;\n}\n","import type { DangerouslyAllowAny } from \"../types\";\n\nexport type SafeStringifyOptions = {\n  /**\n   * The indentation to use for the output.\n   */\n  indentation?: string | number;\n};\n\n/**\n * Stringifies an object, handling circular references and ensuring the output is safe to use in a JSON string.\n * @param input - The object to stringify.\n * @param options.indentation - The indentation to use for the output.\n * @returns The stringified object.\n */\nexport function safeStringify(\n  input: DangerouslyAllowAny,\n  { indentation }: SafeStringifyOptions = {},\n) {\n  try {\n    const seen = new WeakSet();\n    return JSON.stringify(input, safeStringifyReplacer(seen), indentation);\n  } catch (error) {\n    return `SAFE_STRINGIFY_ERROR: Error stringifying object: ${error instanceof Error ? error.message : \"Unknown error\"}`;\n  }\n}\n\nfunction safeStringifyReplacer(seen: WeakSet<DangerouslyAllowAny>) {\n  const replacer = (_key: string, value: DangerouslyAllowAny) => {\n    // Handle objects with a custom `.toJSON()` method.\n    if (typeof value?.toJSON === \"function\") {\n      // biome-ignore lint/style/noParameterAssign: needed to handle circular references\n      value = value.toJSON();\n    }\n\n    if (!(value !== null && typeof value === \"object\")) {\n      return value;\n    }\n\n    if (seen.has(value)) {\n      return \"[Circular]\";\n    }\n\n    seen.add(value);\n\n    const newValue = Array.isArray(value) ? [] : {};\n\n    for (const [key2, value2] of Object.entries(value)) {\n      // @ts-expect-error - ignore as this is needed to handle circular references\n      newValue[key2] = replacer(key2, value2);\n    }\n\n    seen.delete(value);\n\n    return newValue;\n  };\n\n  return replacer;\n}\n"],"mappings":";;;;AASO,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;;;AC5CT,SAAS,UAAa,KAAW;AACtC,MAAI;AAEF,QAAI,OAAO,oBAAoB,YAAY;AACzC,aAAO,gBAAgB,GAAG;AAAA,IAC5B;AAEA,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACpD,SAAS,QAAQ;AAEf,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,EAAE,GAAG,IAAI;AAAA,EAClB;AACF;AAfgB;AAwBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;;;ACHT,SAAS,0BAA6B,QAAmD;AAC9F,QAAM,SAAS,OAAO,YAAY,IAAI,gBAAsB,CAAC;AAE7D,EAAC,OAAkC,OAAO,aAAa,IAAI,MAAM;AAC/D,UAAM,SAAS,OAAO,UAAU;AAChC,WAAO;AAAA,MACL,MAAM,OAAmC;AACvC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,eAAO,OAAO,EAAE,MAAM,MAAM,OAAO,OAAU,IAAI,EAAE,MAAM,OAAO,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAdgB;;;AChBT,SAAS,cACd,OACA,EAAE,YAAY,IAA0B,CAAC,GACzC;AACA,MAAI;AACF,UAAM,OAAO,oBAAI,QAAQ;AACzB,WAAO,KAAK,UAAU,OAAO,sBAAsB,IAAI,GAAG,WAAW;AAAA,EACvE,SAAS,OAAO;AACd,WAAO,oDAAoD,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,EACrH;AACF;AAVgB;AAYhB,SAAS,sBAAsB,MAAoC;AACjE,QAAM,WAAW,wBAAC,MAAc,UAA+B;AAE7D,QAAI,OAAO,OAAO,WAAW,YAAY;AAEvC,cAAQ,MAAM,OAAO;AAAA,IACvB;AAEA,QAAI,EAAE,UAAU,QAAQ,OAAO,UAAU,WAAW;AAClD,aAAO;AAAA,IACT;AAEA,QAAI,KAAK,IAAI,KAAK,GAAG;AACnB,aAAO;AAAA,IACT;AAEA,SAAK,IAAI,KAAK;AAEd,UAAM,WAAW,MAAM,QAAQ,KAAK,IAAI,CAAC,IAAI,CAAC;AAE9C,eAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,KAAK,GAAG;AAElD,eAAS,IAAI,IAAI,SAAS,MAAM,MAAM;AAAA,IACxC;AAEA,SAAK,OAAO,KAAK;AAEjB,WAAO;AAAA,EACT,GA3BiB;AA6BjB,SAAO;AACT;AA/BS;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@voltagent/internal",
   "description": "VoltAgent internal - an internal set of tools for the VoltAgent packages",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "devDependencies": {
     "@types/node": "^24.0.3",
     "@vitest/coverage-v8": "^3.2.4",