node-av 1.3.0 → 2.1.0

package/dist/lib/hardware-frames-context.js.map

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

package/dist/lib/input-format.d.ts

@@ -44,6 +44,7 @@ export declare class InputFormat implements NativeWrapper<NativeInputFormat> {
     private native;
     /**
      * @param native - The native input format instance
+     *
      * @internal
      */
     constructor(native: NativeInputFormat);
@@ -55,6 +56,7 @@ export declare class InputFormat implements NativeWrapper<NativeInputFormat> {
      * Direct mapping to av_find_input_format().
      *
      * @param shortName - Format short name (e.g., 'mp4', 'mkv', 'avi')
+     *
      * @returns Input format if found, null otherwise
      *
      * @example
@@ -82,7 +84,9 @@ export declare class InputFormat implements NativeWrapper<NativeInputFormat> {
      * Direct mapping to av_probe_input_format2().
      *
      * @param buffer - Buffer containing file header/start
+     *
      * @param filename - Optional filename for format hints
+     *
      * @returns Detected format, or null if not recognized
      *
      * @example
@@ -113,8 +117,11 @@ export declare class InputFormat implements NativeWrapper<NativeInputFormat> {
      * Direct mapping to av_probe_input_buffer2().
      *
      * @param ioContext - IO context to read from
+     *
      * @param ioContext.getNative - Method to get native IO context
+     *
      * @param maxProbeSize - Maximum bytes to read for probing
+     *
      * @returns Detected format, or null if not recognized
      *
      * @example
@@ -134,9 +141,42 @@ export declare class InputFormat implements NativeWrapper<NativeInputFormat> {
      *
      * @see {@link probe} For buffer probing
      */
-    static probeBuffer(ioContext: {
-        getNative(): NativeIOContext;
-    }, maxProbeSize?: number): Promise<InputFormat | null>;
+    static probeBuffer(ioContext: NativeWrapper<NativeIOContext>, maxProbeSize?: number): Promise<InputFormat | null>;
+    /**
+     * Probe format from IO context synchronously.
+     * Synchronous version of probeBuffer.
+     *
+     * Reads data from an IO context to determine format.
+     * Useful for custom IO scenarios and network streams.
+     *
+     * Direct mapping to av_probe_input_buffer2().
+     *
+     * @param ioContext - IO context to read from
+     *
+     * @param ioContext.getNative - Method to get native IO context
+     *
+     * @param maxProbeSize - Maximum bytes to read for probing
+     *
+     * @returns Detected format, or null if not recognized
+     *
+     * @example
+     * ```typescript
+     * import { IOContext } from 'node-av';
+     *
+     * // Create IO context
+     * const ioContext = new IOContext();
+     * // ... configure IO context ...
+     *
+     * // Probe format
+     * const format = InputFormat.probeBufferSync(ioContext, 32768);
+     * if (format) {
+     *   console.log(`Format: ${format.name}`);
+     * }
+     * ```
+     *
+     * @see {@link probeBuffer} For async version
+     */
+    static probeBufferSync(ioContext: NativeWrapper<NativeIOContext>, maxProbeSize?: number): InputFormat | null;
     /**
      * Format short name.
      *

package/dist/lib/input-format.js

@@ -43,6 +43,7 @@ export class InputFormat {
     native;
     /**
      * @param native - The native input format instance
+     *
      * @internal
      */
     constructor(native) {
@@ -56,6 +57,7 @@ export class InputFormat {
      * Direct mapping to av_find_input_format().
      *
      * @param shortName - Format short name (e.g., 'mp4', 'mkv', 'avi')
+     *
      * @returns Input format if found, null otherwise
      *
      * @example
@@ -89,7 +91,9 @@ export class InputFormat {
      * Direct mapping to av_probe_input_format2().
      *
      * @param buffer - Buffer containing file header/start
+     *
      * @param filename - Optional filename for format hints
+     *
      * @returns Detected format, or null if not recognized
      *
      * @example
@@ -126,8 +130,11 @@ export class InputFormat {
      * Direct mapping to av_probe_input_buffer2().
      *
      * @param ioContext - IO context to read from
+     *
      * @param ioContext.getNative - Method to get native IO context
+     *
      * @param maxProbeSize - Maximum bytes to read for probing
+     *
      * @returns Detected format, or null if not recognized
      *
      * @example
@@ -154,6 +161,47 @@ export class InputFormat {
         }
         return new InputFormat(native);
     }
+    /**
+     * Probe format from IO context synchronously.
+     * Synchronous version of probeBuffer.
+     *
+     * Reads data from an IO context to determine format.
+     * Useful for custom IO scenarios and network streams.
+     *
+     * Direct mapping to av_probe_input_buffer2().
+     *
+     * @param ioContext - IO context to read from
+     *
+     * @param ioContext.getNative - Method to get native IO context
+     *
+     * @param maxProbeSize - Maximum bytes to read for probing
+     *
+     * @returns Detected format, or null if not recognized
+     *
+     * @example
+     * ```typescript
+     * import { IOContext } from 'node-av';
+     *
+     * // Create IO context
+     * const ioContext = new IOContext();
+     * // ... configure IO context ...
+     *
+     * // Probe format
+     * const format = InputFormat.probeBufferSync(ioContext, 32768);
+     * if (format) {
+     *   console.log(`Format: ${format.name}`);
+     * }
+     * ```
+     *
+     * @see {@link probeBuffer} For async version
+     */
+    static probeBufferSync(ioContext, maxProbeSize) {
+        const native = bindings.InputFormat.probeBufferSync(ioContext.getNative(), maxProbeSize);
+        if (!native) {
+            return null;
+        }
+        return new InputFormat(native);
+    }
     /**
      * Format short name.
      *

package/dist/lib/input-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-format.js","sourceRoot":"","sources":["../../src/lib/input-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAElC;;;OAGG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,eAAe,CAAC,SAAiB;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,KAAK,CAAC,MAAc,EAAE,QAAiB;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAA2C,EAAE,YAAqB;QACzF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"input-format.js","sourceRoot":"","sources":["../../src/lib/input-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAElC;;;;OAIG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,eAAe,CAAC,SAAiB;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,MAAM,CAAC,KAAK,CAAC,MAAc,EAAE,QAAiB;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAyC,EAAE,YAAqB;QACvF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,CAAC,eAAe,CAAC,SAAyC,EAAE,YAAqB;QACrF,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC;QACzF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/lib/io-context.d.ts

@@ -76,6 +76,7 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Used internally for wrapping native I/O contexts.
      *
      * @param native - Native IOContext binding object
+     *
      * @returns Wrapped IOContext instance
      *
      * @internal
@@ -158,6 +159,7 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Direct mapping to avio_alloc_context() without callbacks.
      *
      * @param bufferSize - Size of internal buffer
+     *
      * @param writeFlag - 1 for write, 0 for read
      *
      * @example
@@ -178,9 +180,13 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Direct mapping to avio_alloc_context() with callbacks.
      *
      * @param bufferSize - Size of internal buffer
+     *
      * @param writeFlag - 1 for write mode, 0 for read mode
+     *
      * @param readCallback - Function to read data (null for write-only)
+     *
      * @param writeCallback - Function to write data (null for read-only)
+     *
      * @param seekCallback - Function to seek in stream (optional)
      *
      * @example
@@ -239,7 +245,9 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Direct mapping to avio_open2().
      *
      * @param url - URL or file path to open
+     *
      * @param flags - Open flags (AVIO_FLAG_READ, AVIO_FLAG_WRITE, etc.)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOENT: File not found
      *   - AVERROR_EACCES: Permission denied
@@ -262,6 +270,41 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link closep} To close after use
      */
     open2(url: string, flags?: AVIOFlag): Promise<number>;
+    /**
+     * Open resource for I/O synchronously.
+     * Synchronous version of open2.
+     *
+     * Opens a URL or file for reading or writing.
+     * Automatically selects the appropriate protocol handler.
+     *
+     * Direct mapping to avio_open2().
+     *
+     * @param url - URL or file path to open
+     *
+     * @param flags - Open flags (AVIO_FLAG_READ, AVIO_FLAG_WRITE, etc.)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_ENOENT: File not found
+     *   - AVERROR_EACCES: Permission denied
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVIO_FLAG_READ, AVIO_FLAG_WRITE } from 'node-av/constants';
+     *
+     * // Open for reading
+     * const ret = io.open2Sync('input.mp4', AVIO_FLAG_READ);
+     * FFmpegError.throwIfError(ret, 'open2');
+     *
+     * // Open for writing
+     * const ret2 = io.open2Sync('output.mp4', AVIO_FLAG_WRITE);
+     * FFmpegError.throwIfError(ret2, 'open2');
+     * ```
+     *
+     * @see {@link open2} For async version
+     */
+    open2Sync(url: string, flags?: AVIOFlag): number;
     /**
      * Close I/O context.
      *
@@ -283,6 +326,28 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link open2} To open resources
      */
     closep(): Promise<number>;
+    /**
+     * Close I/O context synchronously.
+     * Synchronous version of closep.
+     *
+     * Closes the I/O context and frees resources.
+     * Sets internal pointer to NULL.
+     *
+     * Direct mapping to avio_closep().
+     *
+     * @returns 0 on success, negative AVERROR on error
+     *
+     * @example
+     * ```typescript
+     * const ret = io.closepSync();
+     * if (ret < 0) {
+     *   console.error(`Failed to close: ${ret}`);
+     * }
+     * ```
+     *
+     * @see {@link closep} For async version
+     */
+    closepSync(): number;
     /**
      * Read data from I/O context.
      *
@@ -291,6 +356,7 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Direct mapping to avio_read().
      *
      * @param size - Maximum number of bytes to read
+     *
      * @returns Buffer with data, or error code if negative:
      *   - AVERROR_EOF: End of file reached
      *   - AVERROR_EIO: I/O error
@@ -308,6 +374,31 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link write} For writing data
      */
     read(size: number): Promise<Buffer | number>;
+    /**
+     * Read data from I/O context synchronously.
+     * Synchronous version of read.
+     *
+     * Reads up to the specified number of bytes from the stream.
+     *
+     * Direct mapping to avio_read().
+     *
+     * @param size - Number of bytes to read
+     *
+     * @returns Buffer with data, or negative AVERROR on error
+     *
+     * @example
+     * ```typescript
+     * const result = io.readSync(4096);
+     * if (Buffer.isBuffer(result)) {
+     *   console.log(`Read ${result.length} bytes`);
+     * } else {
+     *   console.log(`Read error: ${result}`);
+     * }
+     * ```
+     *
+     * @see {@link read} For async version
+     */
+    readSync(size: number): Buffer | number;
     /**
      * Write data to I/O context.
      *
@@ -327,6 +418,25 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link flush} To flush buffers
      */
     write(buffer: Buffer): Promise<void>;
+    /**
+     * Write data to I/O context synchronously.
+     * Synchronous version of write.
+     *
+     * Writes buffer data to the stream.
+     *
+     * Direct mapping to avio_write().
+     *
+     * @param buffer - Data to write
+     *
+     * @example
+     * ```typescript
+     * const data = Buffer.from('Hello, World!');
+     * io.writeSync(data);
+     * ```
+     *
+     * @see {@link write} For async version
+     */
+    writeSync(buffer: Buffer): void;
     /**
      * Seek to position in stream.
      *
@@ -336,7 +446,9 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Direct mapping to avio_seek().
      *
      * @param offset - Byte offset to seek to
+     *
      * @param whence - Seek origin (AVSEEK_SET, AVSEEK_CUR, AVSEEK_END)
+     *
      * @returns New position, or negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid arguments
      *   - AVERROR_ENOSYS: Seeking not supported
@@ -359,6 +471,40 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link skip} For relative seeking
      */
     seek(offset: bigint, whence: AVSeekWhence): Promise<bigint>;
+    /**
+     * Seek to position in stream synchronously.
+     * Synchronous version of seek.
+     *
+     * Changes the current position in the stream.
+     * Not all streams support seeking.
+     *
+     * Direct mapping to avio_seek().
+     *
+     * @param offset - Byte offset to seek to
+     *
+     * @param whence - Seek origin (AVSEEK_SET, AVSEEK_CUR, AVSEEK_END)
+     *
+     * @returns New position, or negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid arguments
+     *   - AVERROR_ENOSYS: Seeking not supported
+     *
+     * @example
+     * ```typescript
+     * import { AVSEEK_SET, AVSEEK_CUR, AVSEEK_END } from 'node-av/constants';
+     *
+     * // Seek to absolute position
+     * const pos1 = io.seekSync(1024n, AVSEEK_SET);
+     *
+     * // Seek relative to current position
+     * const pos2 = io.seekSync(512n, AVSEEK_CUR);
+     *
+     * // Seek relative to end
+     * const pos3 = io.seekSync(-1024n, AVSEEK_END);
+     * ```
+     *
+     * @see {@link seek} For async version
+     */
+    seekSync(offset: bigint, whence: AVSeekWhence): bigint;
     /**
      * Get stream size.
      *
@@ -381,6 +527,31 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * ```
      */
     size(): Promise<bigint>;
+    /**
+     * Get stream size synchronously.
+     * Synchronous version of size.
+     *
+     * Returns the total size of the stream in bytes.
+     * Not all streams have a known size.
+     *
+     * Direct mapping to avio_size().
+     *
+     * @returns Size in bytes, or negative AVERROR if unknown:
+     *   - AVERROR_ENOSYS: Size not available
+     *
+     * @example
+     * ```typescript
+     * const size = io.sizeSync();
+     * if (size >= 0n) {
+     *   console.log(`Stream size: ${size} bytes`);
+     * } else {
+     *   console.log('Stream size unknown');
+     * }
+     * ```
+     *
+     * @see {@link size} For async version
+     */
+    sizeSync(): bigint;
     /**
      * Flush buffered data.
      *
@@ -397,6 +568,23 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link write} For writing data
      */
     flush(): Promise<void>;
+    /**
+     * Flush buffered data synchronously.
+     * Synchronous version of flush.
+     *
+     * Forces any buffered data to be written to the underlying resource.
+     *
+     * Direct mapping to avio_flush().
+     *
+     * @example
+     * ```typescript
+     * io.writeSync(data);
+     * io.flushSync(); // Ensure data is written
+     * ```
+     *
+     * @see {@link flush} For async version
+     */
+    flushSync(): void;
     /**
      * Skip bytes in stream.
      *
@@ -406,6 +594,7 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * Direct mapping to avio_skip().
      *
      * @param offset - Number of bytes to skip
+     *
      * @returns New position after skipping
      *
      * @example
@@ -418,6 +607,29 @@ export declare class IOContext extends OptionMember<NativeIOContext> implements
      * @see {@link seek} For absolute positioning
      */
     skip(offset: bigint): Promise<bigint>;
+    /**
+     * Skip bytes in stream synchronously.
+     * Synchronous version of skip.
+     *
+     * Advances the position by the specified offset.
+     * More efficient than reading and discarding data.
+     *
+     * Direct mapping to avio_skip().
+     *
+     * @param offset - Number of bytes to skip
+     *
+     * @returns New position after skipping
+     *
+     * @example
+     * ```typescript
+     * // Skip 1024 bytes forward
+     * const newPos = io.skipSync(1024n);
+     * console.log(`New position: ${newPos}`);
+     * ```
+     *
+     * @see {@link skip} For async version
+     */
+    skipSync(offset: bigint): bigint;
     /**
      * Get current position.
      *