@revizly/node-av 5.2.2-beta.1

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,174 @@
+import type { AVLogLevel } from '../constants/constants.js';
+/**
+ * Log callback options for performance tuning.
+ */
+export interface LogOptions {
+    maxLevel?: AVLogLevel;
+}
+/**
+ * FFmpeg logging control and configuration.
+ *
+ * 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.
+ *
+ * @example
+ * ```typescript
+ * 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
+ * Log.setLevel(AV_LOG_WARNING); // Only show warnings and errors
+ *
+ * // Get current log level
+ * const level = Log.getLevel();
+ * console.log(`Current log level: ${level}`);
+ *
+ * // Custom log callback
+ * Log.setCallback((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
+ * });
+ *
+ * // Log a custom message
+ * Log.log(AV_LOG_INFO, 'Custom log message');
+ *
+ * // Reset to default callback
+ * Log.resetCallback();
+ * ```
+ *
+ * @see [av_log](https://ffmpeg.org/doxygen/trunk/group__lavu__log.html) - FFmpeg Doxygen
+ */
+export declare class Log {
+    /**
+     * Set global log level.
+     *
+     * Sets the minimum log level for FFmpeg messages.
+     * Messages below this level will be suppressed.
+     *
+     * Direct mapping to av_log_set_level().
+     *
+     * @param level - Minimum log level to display
+     *
+     * @example
+     * ```typescript
+     * import { AV_LOG_QUIET, AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
+     *
+     * 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
+     * ```
+     */
+    static setLevel(level: AVLogLevel): void;
+    /**
+     * Get current log level.
+     *
+     * Returns the current minimum log level setting.
+     *
+     * Direct mapping to av_log_get_level().
+     *
+     * @returns Current log level
+     *
+     * @example
+     * ```typescript
+     * const level = Log.getLevel();
+     * if (level <= AV_LOG_WARNING) {
+     *   console.log('Logging warnings and above');
+     * }
+     * ```
+     *
+     * @see {@link setLevel} To change log level
+     */
+    static getLevel(): AVLogLevel;
+    /**
+     * Log a message.
+     *
+     * Sends a log message through FFmpeg's logging system.
+     * The message will be processed according to current settings.
+     *
+     * Direct mapping to av_log().
+     *
+     * @param level - Log level for this message
+     *
+     * @param message - Message to log
+     *
+     * @example
+     * ```typescript
+     * import { AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
+     *
+     * 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 custom log callback.
+     *
+     * Installs a custom callback to handle FFmpeg log messages.
+     * Allows redirecting logs to custom handlers or loggers.
+     *
+     * Direct mapping to av_log_set_callback().
+     *
+     * @param callback - Function to handle log messages, or null to remove
+     *
+     * @param options - Additional logging options
+     *
+     * @example
+     * ```typescript
+     * import { AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av/constants';
+     *
+     * // Set custom callback with options
+     * Log.setCallback((level, 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}`);
+     *   }
+     * }, {
+     *   printPrefix: true,    // Include context prefix
+     *   skipRepeated: true,   // Skip repeated messages
+     *   level: AV_LOG_WARNING // Filter level
+     * });
+     *
+     * // Remove custom callback
+     * Log.setCallback(null);
+     * ```
+     *
+     * @see {@link resetCallback} To restore default
+     */
+    static setCallback(callback: ((level: AVLogLevel, message: string) => void) | null, options?: LogOptions): void;
+    /**
+     * Reset to default log callback.
+     *
+     * Restores the default FFmpeg logging behavior.
+     * Removes any custom callback previously set.
+     *
+     * Direct mapping to av_log_set_callback() with default handler.
+     *
+     * @example
+     * ```typescript
+     * // After using custom callback
+     * Log.resetCallback();
+     * // Now using default FFmpeg logging
+     * ```
+     *
+     * @see {@link setCallback} To set custom callback
+     */
+    static resetCallback(): void;
+}

package/dist/lib/log.js

@@ -0,0 +1,184 @@
+import { bindings } from './binding.js';
+/**
+ * FFmpeg logging control and configuration.
+ *
+ * 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.
+ *
+ * @example
+ * ```typescript
+ * 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
+ * Log.setLevel(AV_LOG_WARNING); // Only show warnings and errors
+ *
+ * // Get current log level
+ * const level = Log.getLevel();
+ * console.log(`Current log level: ${level}`);
+ *
+ * // Custom log callback
+ * Log.setCallback((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
+ * });
+ *
+ * // Log a custom message
+ * Log.log(AV_LOG_INFO, 'Custom log message');
+ *
+ * // Reset to default callback
+ * Log.resetCallback();
+ * ```
+ *
+ * @see [av_log](https://ffmpeg.org/doxygen/trunk/group__lavu__log.html) - FFmpeg Doxygen
+ */
+export class Log {
+    /**
+     * Set global log level.
+     *
+     * Sets the minimum log level for FFmpeg messages.
+     * Messages below this level will be suppressed.
+     *
+     * Direct mapping to av_log_set_level().
+     *
+     * @param level - Minimum log level to display
+     *
+     * @example
+     * ```typescript
+     * import { AV_LOG_QUIET, AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
+     *
+     * 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
+     * ```
+     */
+    static setLevel(level) {
+        bindings.Log.setLevel(level);
+    }
+    /**
+     * Get current log level.
+     *
+     * Returns the current minimum log level setting.
+     *
+     * Direct mapping to av_log_get_level().
+     *
+     * @returns Current log level
+     *
+     * @example
+     * ```typescript
+     * const level = Log.getLevel();
+     * if (level <= AV_LOG_WARNING) {
+     *   console.log('Logging warnings and above');
+     * }
+     * ```
+     *
+     * @see {@link setLevel} To change log level
+     */
+    static getLevel() {
+        return bindings.Log.getLevel();
+    }
+    /**
+     * Log a message.
+     *
+     * Sends a log message through FFmpeg's logging system.
+     * The message will be processed according to current settings.
+     *
+     * Direct mapping to av_log().
+     *
+     * @param level - Log level for this message
+     *
+     * @param message - Message to log
+     *
+     * @example
+     * ```typescript
+     * import { AV_LOG_ERROR, AV_LOG_WARNING, AV_LOG_INFO } from 'node-av/constants';
+     *
+     * 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 custom log callback.
+     *
+     * Installs a custom callback to handle FFmpeg log messages.
+     * Allows redirecting logs to custom handlers or loggers.
+     *
+     * Direct mapping to av_log_set_callback().
+     *
+     * @param callback - Function to handle log messages, or null to remove
+     *
+     * @param options - Additional logging options
+     *
+     * @example
+     * ```typescript
+     * import { AV_LOG_ERROR, AV_LOG_WARNING } from 'node-av/constants';
+     *
+     * // Set custom callback with options
+     * Log.setCallback((level, 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}`);
+     *   }
+     * }, {
+     *   printPrefix: true,    // Include context prefix
+     *   skipRepeated: true,   // Skip repeated messages
+     *   level: AV_LOG_WARNING // Filter level
+     * });
+     *
+     * // Remove custom callback
+     * Log.setCallback(null);
+     * ```
+     *
+     * @see {@link resetCallback} To restore default
+     */
+    static setCallback(callback, options) {
+        if (callback === null) {
+            bindings.Log.setCallback(null);
+        }
+        else {
+            bindings.Log.setCallback(callback, options);
+        }
+    }
+    /**
+     * Reset to default log callback.
+     *
+     * Restores the default FFmpeg logging behavior.
+     * Removes any custom callback previously set.
+     *
+     * Direct mapping to av_log_set_callback() with default handler.
+     *
+     * @example
+     * ```typescript
+     * // After using custom callback
+     * Log.resetCallback();
+     * // Now using default FFmpeg logging
+     * ```
+     *
+     * @see {@link setCallback} To set custom callback
+     */
+    static resetCallback() {
+        bindings.Log.resetCallback();
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/lib/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAWxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,GAAG,CAAC,KAAiB,EAAE,OAAe;QAC3C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;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"}