@voltagent/internal 0.0.4 → 0.0.6

package/README.md

@@ -9,10 +9,12 @@ pnpm add @voltagent/internal
 ```
 
 ```typescript
-import { devLogger } from "@voltagent/internal";
+import { isObject, isString } from "@voltagent/internal";
 
-// will only log if process.env.NODE_ENV is "development"
-devLogger.info("Hello, world!");
+// Use utility functions
+if (isObject(data)) {
+  console.log("Data is an object");
+}
 ```
 
 ## 📦 Imports
@@ -20,8 +22,8 @@ devLogger.info("Hello, world!");
 You can also import specific subsets of the package:
 
 ```typescript
-import { devLogger } from "@voltagent/internal/dev";
 import { convertArrayToAsyncIterable } from "@voltagent/internal/test";
+import { deepClone, hasKey } from "@voltagent/internal/utils";
 ```
 
 Allowing you to only import the tools you need.

package/dist/main/index.d.mts

@@ -1,106 +1,4 @@
-import { SetRequired, EmptyObject } from 'type-fest';
-
-interface DevLoggerOptions {
-    dev: boolean | (() => boolean);
-}
-/**
- * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not "development").
- *
- * @example
- * ```typescript
- * devLogger.info("Hello, world!");
- * ```
- */
-declare function createDevLogger(options?: DevLoggerOptions): {
-    /**
-     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.info("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    info: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.warn("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    warn: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development.
-     *
-     * @example
-     * ```typescript
-     * devLogger.error("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    error: (message?: any, ...args: any[]) => void;
-    debug: (_message?: any, ..._args: any[]) => void;
-};
-declare const _default: {
-    /**
-     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.info("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    info: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.warn("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    warn: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development.
-     *
-     * @example
-     * ```typescript
-     * devLogger.error("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    error: (message?: any, ...args: any[]) => void;
-    debug: (_message?: any, ..._args: any[]) => void;
-};
+import { SetRequired, EmptyObject, Merge } from 'type-fest';
 
 /**
  * Convert a readable stream to an array
@@ -155,13 +53,118 @@ type AnySyncFunction = (...args: unknown[]) => unknown;
  */
 type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 
+/**
+ * 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
+ */
+interface 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;
+}
+
 /**
  * Deep clone an object using JSON serialization with fallback to shallow clone
  *
  * @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
  */
-declare function deepClone<T>(obj: T): T;
+declare function deepClone<T>(obj: T, logger?: Logger): T;
 /**
  * Check if an object has a key
  *
@@ -207,4 +210,34 @@ declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
  */
 declare function isEmptyObject(obj: unknown): obj is EmptyObject;
 
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };
+/**
+ * An async iterable stream that can be read from.
+ * @example
+ * ```typescript
+ * const stream: AsyncIterableStream<string> = getStream();
+ * for await (const chunk of stream) {
+ *   console.log(chunk);
+ * }
+ * ```
+ */
+type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;
+/**
+ * Create an async iterable stream from a readable stream.
+ *
+ * This is useful for creating an async iterable stream from a readable stream.
+ *
+ * @example
+ * ```typescript
+ * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({
+ *   start(controller) {
+ *     controller.enqueue("Hello");
+ *     controller.close();
+ *   },
+ * }));
+ * ```
+ * @param source The readable stream to create an async iterable stream from.
+ * @returns The async iterable stream.
+ */
+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 };

package/dist/main/index.d.ts

@@ -1,106 +1,4 @@
-import { SetRequired, EmptyObject } from 'type-fest';
-
-interface DevLoggerOptions {
-    dev: boolean | (() => boolean);
-}
-/**
- * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not "development").
- *
- * @example
- * ```typescript
- * devLogger.info("Hello, world!");
- * ```
- */
-declare function createDevLogger(options?: DevLoggerOptions): {
-    /**
-     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.info("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    info: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.warn("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    warn: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development.
-     *
-     * @example
-     * ```typescript
-     * devLogger.error("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    error: (message?: any, ...args: any[]) => void;
-    debug: (_message?: any, ..._args: any[]) => void;
-};
-declare const _default: {
-    /**
-     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.info("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    info: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.warn("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    warn: (message?: any, ...args: any[]) => void;
-    /**
-     * Log a warning message to the console if the environment is development.
-     *
-     * @example
-     * ```typescript
-     * devLogger.error("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    error: (message?: any, ...args: any[]) => void;
-    debug: (_message?: any, ..._args: any[]) => void;
-};
+import { SetRequired, EmptyObject, Merge } from 'type-fest';
 
 /**
  * Convert a readable stream to an array
@@ -155,13 +53,118 @@ type AnySyncFunction = (...args: unknown[]) => unknown;
  */
 type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 
+/**
+ * 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
+ */
+interface 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;
+}
+
 /**
  * Deep clone an object using JSON serialization with fallback to shallow clone
  *
  * @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
  */
-declare function deepClone<T>(obj: T): T;
+declare function deepClone<T>(obj: T, logger?: Logger): T;
 /**
  * Check if an object has a key
  *
@@ -207,4 +210,34 @@ declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
  */
 declare function isEmptyObject(obj: unknown): obj is EmptyObject;
 
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };
+/**
+ * An async iterable stream that can be read from.
+ * @example
+ * ```typescript
+ * const stream: AsyncIterableStream<string> = getStream();
+ * for await (const chunk of stream) {
+ *   console.log(chunk);
+ * }
+ * ```
+ */
+type AsyncIterableStream<T> = Merge<AsyncIterable<T>, ReadableStream<T>>;
+/**
+ * Create an async iterable stream from a readable stream.
+ *
+ * This is useful for creating an async iterable stream from a readable stream.
+ *
+ * @example
+ * ```typescript
+ * const stream: AsyncIterableStream<string> = createAsyncIterableStream(new ReadableStream({
+ *   start(controller) {
+ *     controller.enqueue("Hello");
+ *     controller.close();
+ *   },
+ * }));
+ * ```
+ * @param source The readable stream to create an async iterable stream from.
+ * @returns The async iterable stream.
+ */
+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 };

package/dist/main/index.js

@@ -77,9 +77,8 @@ __export(index_exports, {
   convertAsyncIterableToArray: () => convertAsyncIterableToArray,
   convertReadableStreamToArray: () => convertReadableStreamToArray,
   convertResponseStreamToArray: () => convertResponseStreamToArray,
-  createDevLogger: () => createDevLogger,
+  createAsyncIterableStream: () => createAsyncIterableStream,
   deepClone: () => deepClone,
-  devLogger: () => logger_default,
   hasKey: () => hasKey,
   isEmptyObject: () => isEmptyObject,
   isFunction: () => isFunction,
@@ -89,88 +88,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/dev/logger.ts
-function createDevLogger(options) {
-  const isDev = typeof (options == null ? void 0 : options.dev) === "function" ? options.dev : () => {
-    var _a;
-    return (_a = options == null ? void 0 : options.dev) != null ? _a : isDevNodeEnv();
-  };
-  return {
-    /**
-     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.info("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    info: /* @__PURE__ */ __name((message, ...args) => {
-      if (isDev()) {
-        console.info(formatLogPrefix("INFO"), message, ...args);
-      }
-    }, "info"),
-    /**
-     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
-     *
-     * @example
-     * ```typescript
-     * devLogger.warn("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    warn: /* @__PURE__ */ __name((message, ...args) => {
-      if (isDev()) {
-        console.warn(formatLogPrefix("WARN"), message, ...args);
-      }
-    }, "warn"),
-    /**
-     * Log a warning message to the console if the environment is development.
-     *
-     * @example
-     * ```typescript
-     * devLogger.error("Hello, world!");
-     *
-     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
-     * ```
-     *
-     * @param message - The message to log.
-     * @param args - The arguments to log.
-     */
-    error: /* @__PURE__ */ __name((message, ...args) => {
-      if (isDev()) {
-        console.error(formatLogPrefix("ERROR"), message, ...args);
-      }
-    }, "error"),
-    debug: /* @__PURE__ */ __name((_message, ..._args) => {
-      return;
-    }, "debug")
-  };
-}
-__name(createDevLogger, "createDevLogger");
-var logger_default = createDevLogger();
-function isDevNodeEnv() {
-  const nodeEnv = process.env.NODE_ENV;
-  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
-}
-__name(isDevNodeEnv, "isDevNodeEnv");
-function formatLogPrefix(level) {
-  return `[VoltAgent] [${timestamp()}] ${level}: `;
-}
-__name(formatLogPrefix, "formatLogPrefix");
-function timestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, -1);
-}
-__name(timestamp, "timestamp");
-
 // src/test/conversions.ts
 function convertReadableStreamToArray(stream) {
   return __async(this, null, function* () {
@@ -273,11 +190,13 @@ function isEmptyObject(obj) {
 __name(isEmptyObject, "isEmptyObject");
 
 // src/utils/objects.ts
-function deepClone(obj) {
+function deepClone(obj, logger) {
   try {
     return JSON.parse(JSON.stringify(obj));
   } catch (error) {
-    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (logger) {
+      logger.warn("Failed to deep clone object, using shallow clone", { error });
+    }
     if (obj === null || typeof obj !== "object") {
       return obj;
     }
@@ -289,6 +208,24 @@ function hasKey(obj, key) {
   return isObject(obj) && key in obj;
 }
 __name(hasKey, "hasKey");
+
+// src/utils/async-iterable-stream.ts
+function createAsyncIterableStream(source) {
+  const stream = source.pipeThrough(new TransformStream());
+  stream[Symbol.asyncIterator] = () => {
+    const reader = stream.getReader();
+    return {
+      next() {
+        return __async(this, null, function* () {
+          const { done, value } = yield reader.read();
+          return done ? { done: true, value: void 0 } : { done: false, value };
+        });
+      }
+    };
+  };
+  return stream;
+}
+__name(createAsyncIterableStream, "createAsyncIterableStream");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   convertArrayToAsyncIterable,
@@ -296,9 +233,8 @@ __name(hasKey, "hasKey");
   convertAsyncIterableToArray,
   convertReadableStreamToArray,
   convertResponseStreamToArray,
-  createDevLogger,
+  createAsyncIterableStream,
   deepClone,
-  devLogger,
   hasKey,
   isEmptyObject,
   isFunction,