node-av 1.1.0 → 1.2.0

package/dist/lib/io-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"io-context.js","sourceRoot":"","sources":["../../src/lib/io-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"io-context.js","sourceRoot":"","sources":["../../src/lib/io-context.ts"],"names":[],"mappings":"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"}

package/dist/lib/log.d.ts

@@ -1,201 +1,167 @@
 import type { AVLogLevel } from '../constants/constants.js';
 import type { LogOptions } from './types.js';
 /**
- * FFmpeg logging system control.
+ * FFmpeg logging control and configuration.
  *
- * Controls FFmpeg's global logging behavior including log levels and message capture.
- * Provides direct access to FFmpeg's logging system with options for performance optimization.
- * FFmpeg can generate thousands of log messages per second, so filtering is important.
+ * Provides control over FFmpeg's internal logging system.
+ * Allows setting log levels, custom callbacks, and formatting options.
+ * Essential for debugging, monitoring, and error tracking in FFmpeg operations.
  *
- * Direct mapping to FFmpeg's logging API (av_log_*).
+ * Direct mapping to FFmpeg's logging API.
  *
  * @example
  * ```typescript
- * import { Log, AV_LOG_WARNING, AV_LOG_ERROR, AV_LOG_QUIET } from 'node-av';
+ * import { Log } from 'node-av';
+ * import { AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO, AV_LOG_DEBUG } from 'node-av/constants';
  *
- * // Set log level (simple, no performance impact)
- * Log.setLevel(AV_LOG_WARNING);
+ * // Set log level
+ * Log.setLevel(AV_LOG_WARNING); // Only show warnings and errors
  *
- * // Capture errors only (minimal performance impact)
- * Log.setCallback((level, message) => {
- *   console.error(`FFmpeg Error: ${message}`);
- * }, { maxLevel: AV_LOG_ERROR });
+ * // Get current log level
+ * const level = Log.getLevel();
+ * console.log(`Current log level: ${level}`);
  *
- * // Non-blocking callback with no performance impact
+ * // Custom log callback
  * Log.setCallback((level, message) => {
- *   myLogger.log(level, message);
+ *   if (level <= AV_LOG_ERROR) {
+ *     console.error(`FFmpeg Error: ${message}`);
+ *   } else if (level <= AV_LOG_WARNING) {
+ *     console.warn(`FFmpeg Warning: ${message}`);
+ *   } else {
+ *     console.log(`FFmpeg: ${message}`);
+ *   }
+ * }, {
+ *   printPrefix: true,
+ *   skipRepeated: true
  * });
  *
- * // Reset to default logging
+ * // Log a custom message
+ * Log.log(AV_LOG_INFO, 'Custom log message');
+ *
+ * // Reset to default callback
  * Log.resetCallback();
  * ```
  *
- * Warning: Setting a callback can significantly impact performance!
- * FFmpeg can generate thousands of log messages per second.
- * Use maxLevel to filter messages and buffered mode for better performance.
+ * @see [av_log](https://ffmpeg.org/doxygen/trunk/group__lavu__log.html) - FFmpeg Doxygen
  */
 export declare class Log {
-    private constructor();
     /**
-     * Set FFmpeg's global log level.
+     * Set global log level.
      *
-     * Lower levels mean fewer log messages and better performance.
-     * Messages above this level are not generated at all by FFmpeg.
+     * Sets the minimum log level for FFmpeg messages.
+     * Messages below this level will be suppressed.
      *
-     * Direct mapping to av_log_set_level()
+     * Direct mapping to av_log_set_level().
      *
-     * @param level - Log level (AV_LOG_* constant):
-     *   - AV_LOG_QUIET: Disable all logging
-     *   - AV_LOG_PANIC: Only extremely fatal issues
-     *   - AV_LOG_FATAL: Fatal errors only
-     *   - AV_LOG_ERROR: Errors that can't be recovered
-     *   - AV_LOG_WARNING: Warnings about potential issues
-     *   - AV_LOG_INFO: Informational messages
-     *   - AV_LOG_VERBOSE: Detailed information
-     *   - AV_LOG_DEBUG: Debug information
-     *   - AV_LOG_TRACE: Very detailed trace information
+     * @param level - Minimum log level to display
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_ERROR, AV_LOG_TRACE, AV_LOG_QUIET } from 'node-av';
-     *
-     * // Only show errors and fatal messages
-     * Log.setLevel(AV_LOG_ERROR);
+     * import { AV_LOG_QUIET, AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
      *
-     * // Show everything (warning: very verbose!)
-     * Log.setLevel(AV_LOG_TRACE);
-     *
-     * // Disable all logging for maximum performance
-     * Log.setLevel(AV_LOG_QUIET);
+     * Log.setLevel(AV_LOG_QUIET);   // Disable all logging
+     * Log.setLevel(AV_LOG_ERROR);   // Only errors
+     * Log.setLevel(AV_LOG_WARNING); // Errors and warnings
+     * Log.setLevel(AV_LOG_INFO);    // Errors, warnings, and info
      * ```
-     *
-     * @see {@link getLevel} To retrieve current level
      */
     static setLevel(level: AVLogLevel): void;
     /**
-     * Get the current global log level.
+     * Get current log level.
      *
-     * Returns the current FFmpeg log level setting.
+     * Returns the current minimum log level setting.
      *
-     * Direct mapping to av_log_get_level()
+     * Direct mapping to av_log_get_level().
      *
-     * @returns Current log level (AV_LOG_* constant)
+     * @returns Current log level
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_INFO } from 'node-av';
-     *
-     * const currentLevel = Log.getLevel();
-     * console.log(`Current log level: ${currentLevel}`);
-     *
-     * // Temporarily change log level
-     * const savedLevel = Log.getLevel();
-     * Log.setLevel(AV_LOG_INFO);
-     * // ... do something ...
-     * Log.setLevel(savedLevel); // Restore
+     * const level = Log.getLevel();
+     * if (level <= AV_LOG_WARNING) {
+     *   console.log('Logging warnings and above');
+     * }
      * ```
      *
-     * @see {@link setLevel} To change the level
+     * @see {@link setLevel} To change log level
      */
     static getLevel(): AVLogLevel;
     /**
-     * Log a message through FFmpeg's logging system.
+     * Log a message.
      *
-     * Sends a message through FFmpeg's internal logging system.
-     * The message will be processed according to the current log level and callback.
+     * Sends a log message through FFmpeg's logging system.
+     * The message will be processed according to current settings.
      *
-     * Direct mapping to av_log()
+     * Direct mapping to av_log().
      *
-     * @param level - Log level (AV_LOG_* constant)
+     * @param level - Log level for this message
      * @param message - Message to log
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_INFO, AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av';
-     *
-     * Log.log(AV_LOG_INFO, 'Starting processing...');
-     * Log.log(AV_LOG_WARNING, 'Frame rate might be inaccurate');
-     * Log.log(AV_LOG_ERROR, 'Failed to open codec');
+     * import { AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
      *
-     * // With formatting
-     * const frameNum = 42;
-     * Log.log(AV_LOG_INFO, `Processing frame ${frameNum}`);
+     * Log.log(AV_LOG_ERROR, 'Critical error occurred');
+     * Log.log(AV_LOG_WARNING, 'Non-fatal warning');
+     * Log.log(AV_LOG_INFO, 'Processing started');
      * ```
      */
     static log(level: AVLogLevel, message: string): void;
     /**
-     * Set a callback to capture FFmpeg log messages.
+     * Set custom log callback.
      *
-     * Installs a custom callback to intercept FFmpeg's log messages.
-     * This implementation uses ThreadSafeFunction for zero-blocking operation.
-     * Messages are processed asynchronously without impacting FFmpeg performance.
-     * Use options.maxLevel to filter messages at the C level for best performance.
+     * Installs a custom callback to handle FFmpeg log messages.
+     * Allows redirecting logs to custom handlers or loggers.
      *
-     * Direct mapping to av_log_set_callback()
+     * Direct mapping to av_log_set_callback().
      *
-     * @param callback - Function to receive log messages, or null to reset
-     * @param options - Options to control performance impact:
-     *   - maxLevel: Only capture messages at or below this level (filtered in C++)
-     *   - buffered: Buffer messages for batch processing
+     * @param callback - Function to handle log messages, or null to remove
+     * @param options - Additional logging options
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av';
-     *
-     * // Simple callback (warning: can be slow!)
-     * Log.setCallback((level, message) => {
-     *   console.log(`[${level}] ${message}`);
-     * });
+     * import { AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av/constants';
      *
-     * // Performance-optimized callback (filters at C level)
+     * // Set custom callback with options
      * Log.setCallback((level, message) => {
-     *   errorReporter.log(message);
+     *   const timestamp = new Date().toISOString();
+     *
+     *   if (level <= AV_LOG_ERROR) {
+     *     console.error(`[${timestamp}] ERROR: ${message}`);
+     *   } else if (level <= AV_LOG_WARNING) {
+     *     console.warn(`[${timestamp}] WARN: ${message}`);
+     *   } else {
+     *     console.log(`[${timestamp}] INFO: ${message}`);
+     *   }
      * }, {
-     *   maxLevel: AV_LOG_ERROR  // Only capture errors (filtered in C++)
+     *   printPrefix: true,    // Include context prefix
+     *   skipRepeated: true,   // Skip repeated messages
+     *   level: AV_LOG_WARNING // Filter level
      * });
      *
-     * // Structured logging
-     * Log.setCallback((level, message) => {
-     *   myLogger.log({
-     *     level: level,
-     *     message: message,
-     *     timestamp: Date.now(),
-     *     source: 'ffmpeg'
-     *   });
-     * }, {
-     *   maxLevel: AV_LOG_WARNING
-     * });
-     *
-     * // Reset to default (output to stderr)
+     * // Remove custom callback
      * Log.setCallback(null);
      * ```
      *
-     * Note: Messages are processed asynchronously and non-blocking.
-     *
-     * @see {@link resetCallback} To remove callback
+     * @see {@link resetCallback} To restore default
      */
     static setCallback(callback: ((level: AVLogLevel, message: string) => void) | null, options?: LogOptions): void;
     /**
-     * Reset logging to default behavior.
+     * Reset to default log callback.
      *
-     * Removes any custom callback and restores FFmpeg's default logging to stderr.
-     * Also clears any buffered messages from previous callbacks.
+     * Restores the default FFmpeg logging behavior.
+     * Removes any custom callback previously set.
      *
-     * Direct mapping to av_log_set_callback(av_log_default_callback)
+     * Direct mapping to av_log_set_callback() with default handler.
      *
      * @example
      * ```typescript
-     * import { Log } from 'node-av';
-     *
-     * // Remove custom callback
+     * // After using custom callback
      * Log.resetCallback();
-     * // Now logs go to stderr again
-     *
-     * // Equivalent to:
-     * Log.setCallback(null);
+     * // Now using default FFmpeg logging
      * ```
      *
-     * @see {@link setCallback} To install custom callback
+     * @see {@link setCallback} To set custom callback
      */
     static resetCallback(): void;
 }

package/dist/lib/log.js

@@ -1,186 +1,154 @@
 import { bindings } from './binding.js';
 /**
- * FFmpeg logging system control.
+ * FFmpeg logging control and configuration.
  *
- * Controls FFmpeg's global logging behavior including log levels and message capture.
- * Provides direct access to FFmpeg's logging system with options for performance optimization.
- * FFmpeg can generate thousands of log messages per second, so filtering is important.
+ * Provides control over FFmpeg's internal logging system.
+ * Allows setting log levels, custom callbacks, and formatting options.
+ * Essential for debugging, monitoring, and error tracking in FFmpeg operations.
  *
- * Direct mapping to FFmpeg's logging API (av_log_*).
+ * Direct mapping to FFmpeg's logging API.
  *
  * @example
  * ```typescript
- * import { Log, AV_LOG_WARNING, AV_LOG_ERROR, AV_LOG_QUIET } from 'node-av';
+ * import { Log } from 'node-av';
+ * import { AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO, AV_LOG_DEBUG } from 'node-av/constants';
  *
- * // Set log level (simple, no performance impact)
- * Log.setLevel(AV_LOG_WARNING);
+ * // Set log level
+ * Log.setLevel(AV_LOG_WARNING); // Only show warnings and errors
  *
- * // Capture errors only (minimal performance impact)
- * Log.setCallback((level, message) => {
- *   console.error(`FFmpeg Error: ${message}`);
- * }, { maxLevel: AV_LOG_ERROR });
+ * // Get current log level
+ * const level = Log.getLevel();
+ * console.log(`Current log level: ${level}`);
  *
- * // Non-blocking callback with no performance impact
+ * // Custom log callback
  * Log.setCallback((level, message) => {
- *   myLogger.log(level, message);
+ *   if (level <= AV_LOG_ERROR) {
+ *     console.error(`FFmpeg Error: ${message}`);
+ *   } else if (level <= AV_LOG_WARNING) {
+ *     console.warn(`FFmpeg Warning: ${message}`);
+ *   } else {
+ *     console.log(`FFmpeg: ${message}`);
+ *   }
+ * }, {
+ *   printPrefix: true,
+ *   skipRepeated: true
  * });
  *
- * // Reset to default logging
+ * // Log a custom message
+ * Log.log(AV_LOG_INFO, 'Custom log message');
+ *
+ * // Reset to default callback
  * Log.resetCallback();
  * ```
  *
- * Warning: Setting a callback can significantly impact performance!
- * FFmpeg can generate thousands of log messages per second.
- * Use maxLevel to filter messages and buffered mode for better performance.
+ * @see [av_log](https://ffmpeg.org/doxygen/trunk/group__lavu__log.html) - FFmpeg Doxygen
  */
 export class Log {
-    // Private constructor - this is a static-only class
-    constructor() {
-        throw new Error('Log class cannot be instantiated');
-    }
     /**
-     * Set FFmpeg's global log level.
+     * Set global log level.
      *
-     * Lower levels mean fewer log messages and better performance.
-     * Messages above this level are not generated at all by FFmpeg.
+     * Sets the minimum log level for FFmpeg messages.
+     * Messages below this level will be suppressed.
      *
-     * Direct mapping to av_log_set_level()
+     * Direct mapping to av_log_set_level().
      *
-     * @param level - Log level (AV_LOG_* constant):
-     *   - AV_LOG_QUIET: Disable all logging
-     *   - AV_LOG_PANIC: Only extremely fatal issues
-     *   - AV_LOG_FATAL: Fatal errors only
-     *   - AV_LOG_ERROR: Errors that can't be recovered
-     *   - AV_LOG_WARNING: Warnings about potential issues
-     *   - AV_LOG_INFO: Informational messages
-     *   - AV_LOG_VERBOSE: Detailed information
-     *   - AV_LOG_DEBUG: Debug information
-     *   - AV_LOG_TRACE: Very detailed trace information
+     * @param level - Minimum log level to display
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_ERROR, AV_LOG_TRACE, AV_LOG_QUIET } from 'node-av';
+     * import { AV_LOG_QUIET, AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
      *
-     * // Only show errors and fatal messages
-     * Log.setLevel(AV_LOG_ERROR);
-     *
-     * // Show everything (warning: very verbose!)
-     * Log.setLevel(AV_LOG_TRACE);
-     *
-     * // Disable all logging for maximum performance
-     * Log.setLevel(AV_LOG_QUIET);
+     * Log.setLevel(AV_LOG_QUIET);   // Disable all logging
+     * Log.setLevel(AV_LOG_ERROR);   // Only errors
+     * Log.setLevel(AV_LOG_WARNING); // Errors and warnings
+     * Log.setLevel(AV_LOG_INFO);    // Errors, warnings, and info
      * ```
-     *
-     * @see {@link getLevel} To retrieve current level
      */
     static setLevel(level) {
         bindings.Log.setLevel(level);
     }
     /**
-     * Get the current global log level.
+     * Get current log level.
      *
-     * Returns the current FFmpeg log level setting.
+     * Returns the current minimum log level setting.
      *
-     * Direct mapping to av_log_get_level()
+     * Direct mapping to av_log_get_level().
      *
-     * @returns Current log level (AV_LOG_* constant)
+     * @returns Current log level
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_INFO } from 'node-av';
-     *
-     * const currentLevel = Log.getLevel();
-     * console.log(`Current log level: ${currentLevel}`);
-     *
-     * // Temporarily change log level
-     * const savedLevel = Log.getLevel();
-     * Log.setLevel(AV_LOG_INFO);
-     * // ... do something ...
-     * Log.setLevel(savedLevel); // Restore
+     * const level = Log.getLevel();
+     * if (level <= AV_LOG_WARNING) {
+     *   console.log('Logging warnings and above');
+     * }
      * ```
      *
-     * @see {@link setLevel} To change the level
+     * @see {@link setLevel} To change log level
      */
     static getLevel() {
         return bindings.Log.getLevel();
     }
     /**
-     * Log a message through FFmpeg's logging system.
+     * Log a message.
      *
-     * Sends a message through FFmpeg's internal logging system.
-     * The message will be processed according to the current log level and callback.
+     * Sends a log message through FFmpeg's logging system.
+     * The message will be processed according to current settings.
      *
-     * Direct mapping to av_log()
+     * Direct mapping to av_log().
      *
-     * @param level - Log level (AV_LOG_* constant)
+     * @param level - Log level for this message
      * @param message - Message to log
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_INFO, AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av';
-     *
-     * Log.log(AV_LOG_INFO, 'Starting processing...');
-     * Log.log(AV_LOG_WARNING, 'Frame rate might be inaccurate');
-     * Log.log(AV_LOG_ERROR, 'Failed to open codec');
+     * import { AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
      *
-     * // With formatting
-     * const frameNum = 42;
-     * Log.log(AV_LOG_INFO, `Processing frame ${frameNum}`);
+     * Log.log(AV_LOG_ERROR, 'Critical error occurred');
+     * Log.log(AV_LOG_WARNING, 'Non-fatal warning');
+     * Log.log(AV_LOG_INFO, 'Processing started');
      * ```
      */
     static log(level, message) {
         bindings.Log.log(level, message);
     }
     /**
-     * Set a callback to capture FFmpeg log messages.
+     * Set custom log callback.
      *
-     * Installs a custom callback to intercept FFmpeg's log messages.
-     * This implementation uses ThreadSafeFunction for zero-blocking operation.
-     * Messages are processed asynchronously without impacting FFmpeg performance.
-     * Use options.maxLevel to filter messages at the C level for best performance.
+     * Installs a custom callback to handle FFmpeg log messages.
+     * Allows redirecting logs to custom handlers or loggers.
      *
-     * Direct mapping to av_log_set_callback()
+     * Direct mapping to av_log_set_callback().
      *
-     * @param callback - Function to receive log messages, or null to reset
-     * @param options - Options to control performance impact:
-     *   - maxLevel: Only capture messages at or below this level (filtered in C++)
-     *   - buffered: Buffer messages for batch processing
+     * @param callback - Function to handle log messages, or null to remove
+     * @param options - Additional logging options
      *
      * @example
      * ```typescript
-     * import { Log, AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av';
-     *
-     * // Simple callback (warning: can be slow!)
-     * Log.setCallback((level, message) => {
-     *   console.log(`[${level}] ${message}`);
-     * });
-     *
-     * // Performance-optimized callback (filters at C level)
-     * Log.setCallback((level, message) => {
-     *   errorReporter.log(message);
-     * }, {
-     *   maxLevel: AV_LOG_ERROR  // Only capture errors (filtered in C++)
-     * });
+     * import { AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av/constants';
      *
-     * // Structured logging
+     * // Set custom callback with options
      * Log.setCallback((level, message) => {
-     *   myLogger.log({
-     *     level: level,
-     *     message: message,
-     *     timestamp: Date.now(),
-     *     source: 'ffmpeg'
-     *   });
+     *   const timestamp = new Date().toISOString();
+     *
+     *   if (level <= AV_LOG_ERROR) {
+     *     console.error(`[${timestamp}] ERROR: ${message}`);
+     *   } else if (level <= AV_LOG_WARNING) {
+     *     console.warn(`[${timestamp}] WARN: ${message}`);
+     *   } else {
+     *     console.log(`[${timestamp}] INFO: ${message}`);
+     *   }
      * }, {
-     *   maxLevel: AV_LOG_WARNING
+     *   printPrefix: true,    // Include context prefix
+     *   skipRepeated: true,   // Skip repeated messages
+     *   level: AV_LOG_WARNING // Filter level
      * });
      *
-     * // Reset to default (output to stderr)
+     * // Remove custom callback
      * Log.setCallback(null);
      * ```
      *
-     * Note: Messages are processed asynchronously and non-blocking.
-     *
-     * @see {@link resetCallback} To remove callback
+     * @see {@link resetCallback} To restore default
      */
     static setCallback(callback, options) {
         if (callback === null) {
@@ -191,26 +159,21 @@ export class Log {
         }
     }
     /**
-     * Reset logging to default behavior.
+     * Reset to default log callback.
      *
-     * Removes any custom callback and restores FFmpeg's default logging to stderr.
-     * Also clears any buffered messages from previous callbacks.
+     * Restores the default FFmpeg logging behavior.
+     * Removes any custom callback previously set.
      *
-     * Direct mapping to av_log_set_callback(av_log_default_callback)
+     * Direct mapping to av_log_set_callback() with default handler.
      *
      * @example
      * ```typescript
-     * import { Log } from 'node-av';
-     *
-     * // Remove custom callback
+     * // After using custom callback
      * Log.resetCallback();
-     * // Now logs go to stderr again
-     *
-     * // Equivalent to:
-     * Log.setCallback(null);
+     * // Now using default FFmpeg logging
      * ```
      *
-     * @see {@link setCallback} To install custom callback
+     * @see {@link setCallback} To set custom callback
      */
     static resetCallback() {
         bindings.Log.resetCallback();

package/dist/lib/log.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,GAAG;IACd,oDAAoD;IACpD;QACE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAiB;QAC/B,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,GAAG,CAAC,KAAiB,EAAE,OAAe;QAC3C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACH,MAAM,CAAC,WAAW,CAAC,QAA+D,EAAE,OAAoB;QACtG,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,aAAa;QAClB,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,OAAO,GAAG;IACd;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAiB;QAC/B,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,GAAG,CAAC,KAAiB,EAAE,OAAe;QAC3C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,MAAM,CAAC,WAAW,CAAC,QAA+D,EAAE,OAAoB;QACtG,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,aAAa;QAClB,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC;CACF"}