node-av 1.2.0 → 2.0.0

package/README.md

@@ -34,46 +34,45 @@ await using input = await MediaInput.open('input.mp4');
 await using output = await MediaOutput.open('output.mp4');
 
 // Get video stream
-const videoStream = input.video();
+const videoStream = input.video()!;
 
-// Create decoder/encoder
-using decoder = await Decoder.create(videoStream!);
-using encoder = await Encoder.create(FF_ENCODER_LIBX264, decoder.getOutputStreamInfo(), {
-  bitrate: '2M',
-  gopSize: 60,
+// Create decoder
+using decoder = await Decoder.create(videoStream);
+
+// Create encoder
+using encoder = await Encoder.create(FF_ENCODER_LIBX264, {
+  timeBase: videoStream.timeBase,
+  frameRate: videoStream.avgFrameRate,
 });
 
 // Add stream to output
 const outputIndex = output.addStream(encoder);
-await output.writeHeader();
 
 // Process packets
-for await (const packet of input.packets()) {
-  if (packet.streamIndex === videoStream!.index) {
-    using frame = await decoder.decode(packet);
-    if (frame) {
-      using encoded = await encoder.encode(frame);
-      if (encoded) {
-        await output.writePacket(encoded, outputIndex);
-      }
+for await (using packet of input.packets(videoStream.index)) {
+  using frame = await decoder.decode(packet);
+  if (frame) {
+    using encoded = await encoder.encode(frame);
+    if (encoded) {
+      await output.writePacket(encoded, outputIndex);
     }
   }
 }
 
-// Flush decoder/encoder
-for await (const frame of decoder.flushFrames()) {
+// Flush decoder
+for await (using frame of decoder.flushFrames()) {
   using encoded = await encoder.encode(frame);
   if (encoded) {
     await output.writePacket(encoded, outputIndex);
   }
 }
 
-for await (const packet of encoder.flushPackets()) {
+// Flush encoder
+for await (using packet of encoder.flushPackets()) {
   await output.writePacket(packet, outputIndex);
 }
 
-// End
-await output.writeTrailer();
+// Done
 ```
 
 ### Pipeline API
@@ -85,36 +84,15 @@ import { pipeline, MediaInput, MediaOutput, Decoder, Encoder } from 'node-av/api
 const input = await MediaInput.open('input.mp4');
 const output = await MediaOutput.open('output.mp4');
 const decoder = await Decoder.create(input.video());
-const encoder = await Encoder.create(FF_ENCODER_LIBX264, decoder.getOutputStreamInfo(), {
-  bitrate: '2M',
-  gopSize: 60
+const encoder = await Encoder.create(FF_ENCODER_LIBX264, {
+  timeBase: videoStream.timeBase,
+  frameRate: videoStream.avgFrameRate,
 });
 
 const control = pipeline(input, decoder, encoder, output);
 await control.completion;
-
-// The pipeline automatically handles:
-// - Flow control between components
-// - Resource management and cleanup
-// - Error propagation
-// - Backpressure handling
 ```
 
-## More Examples
-
-The `examples/` directory contains comprehensive examples for all API levels:
-
-**High-Level API** (`api-*.ts`)
-- Hardware acceleration, muxing, streaming, custom I/O, and more
-
-**Low-Level API** (direct FFmpeg bindings)
-- Ported FFmpeg C examples showing fine-grained control
-
-**Pipeline API** (`api-pipeline-*.ts`)
-- Complex workflows with automatic flow control
-
-See the [Examples Table](#examples) for a complete list.
-
 ## Hardware Acceleration
 
 The library supports all hardware acceleration methods available in FFmpeg. The specific hardware types available depend on your FFmpeg build and system configuration.
@@ -123,23 +101,23 @@ The library supports all hardware acceleration methods available in FFmpeg. The
 
 ```typescript
 import { HardwareContext } from 'node-av/api';
-import { FF_ENCODER_H264_VIDEOTOOLBOX } from 'node-av/constants';
+import { FF_ENCODER_LIBX264 } from 'node-av/constants';
 
 // Automatically detect best available hardware
 const hw = HardwareContext.auto();
-if (hw) {
-  console.log(`Using hardware: ${hw.deviceTypeName}`);
-  
-  // Use with decoder
-  const decoder = await Decoder.create(stream, {
-    hardware: hw
-  });
-  
-  // Use with encoder (use hardware-specific codec)
-  const encoder = await Encoder.create(FF_ENCODER_H264_VIDEOTOOLBOX, decoder.getOutputStreamInfo(), {
-    hardware: hw
-  });
-}
+console.log(`Using hardware: ${hw.deviceTypeName}`);
+
+// Use with decoder
+const decoder = await Decoder.create(stream, {
+  hardware: hw
+});
+
+// Use with encoder (use hardware-specific codec)
+const encoderCodec = hw?.getEncoderCodec('h264') ?? FF_ENCODER_LIBX264;
+const encoder = await Encoder.create(encoderCodec, {
+  timeBase: videoStream.timeBase,
+  frameRate: videoStream.avgFrameRate,
+});
 ```
 
 ### Specific Hardware
@@ -309,7 +287,7 @@ This project is licensed under the MIT License. See the LICENSE file for details
 
 ## Contributing
 
-Contributions are welcome! Please read [CONTRIBUTION.md](https://github.com/seydx/av/tree/main/CONTRIBUTION.md) for development setup, code standards, and contribution guidelines before submitting pull requests.
+Contributions are welcome! Please read [CONTRIBUTING.md](https://github.com/seydx/av/tree/main/CONTRIBUTING.md) for development setup, code standards, and contribution guidelines before submitting pull requests.
 
 ## Support
 

package/dist/api/bitstream-filter.d.ts

@@ -63,6 +63,7 @@ export declare class BitStreamFilterAPI implements Disposable {
      * @returns Configured bitstream filter
      *
      * @throws {Error} If filter not found or initialization fails
+     *
      * @throws {FFmpegError} If allocation or initialization fails
      *
      * @example
@@ -133,6 +134,7 @@ export declare class BitStreamFilterAPI implements Disposable {
      * @returns Array of filtered packets
      *
      * @throws {Error} If filter is disposed
+     *
      * @throws {FFmpegError} If filtering fails
      *
      * @example
@@ -162,8 +164,9 @@ export declare class BitStreamFilterAPI implements Disposable {
      * Yields filtered packets ready for output.
      *
      * @param packets - Async iterable of packets
-     * @yields Filtered packets
+     * @yields {Packet} Filtered packets
      * @throws {Error} If filter is disposed
+     *
      * @throws {FFmpegError} If filtering fails
      *
      * @example
@@ -222,7 +225,7 @@ export declare class BitStreamFilterAPI implements Disposable {
      * Convenient async iteration over remaining packets.
      * Combines flush and iteration.
      *
-     * @yields Remaining packets
+     * @yields {Packet} Remaining packets
      * @throws {Error} If filter is disposed
      *
      * @example

package/dist/api/bitstream-filter.js

@@ -1,5 +1,5 @@
-import { AVERROR_EOF } from '../constants/constants.js';
-import { AVERROR_EAGAIN, BitStreamFilter, BitStreamFilterContext, FFmpegError, Packet } from '../lib/index.js';
+import { AVERROR_EAGAIN, AVERROR_EOF } from '../constants/constants.js';
+import { BitStreamFilter, BitStreamFilterContext, FFmpegError, Packet } from '../lib/index.js';
 /**
  * High-level bitstream filter for packet processing.
  *
@@ -67,6 +67,7 @@ export class BitStreamFilterAPI {
      * @returns Configured bitstream filter
      *
      * @throws {Error} If filter not found or initialization fails
+     *
      * @throws {FFmpegError} If allocation or initialization fails
      *
      * @example
@@ -174,6 +175,7 @@ export class BitStreamFilterAPI {
      * @returns Array of filtered packets
      *
      * @throws {Error} If filter is disposed
+     *
      * @throws {FFmpegError} If filtering fails
      *
      * @example
@@ -229,8 +231,9 @@ export class BitStreamFilterAPI {
      * Yields filtered packets ready for output.
      *
      * @param packets - Async iterable of packets
-     * @yields Filtered packets
+     * @yields {Packet} Filtered packets
      * @throws {Error} If filter is disposed
+     *
      * @throws {FFmpegError} If filtering fails
      *
      * @example
@@ -321,7 +324,7 @@ export class BitStreamFilterAPI {
      * Convenient async iteration over remaining packets.
      * Combines flush and iteration.
      *
-     * @yields Remaining packets
+     * @yields {Packet} Remaining packets
      * @throws {Error} If filter is disposed
      *
      * @example

package/dist/api/bitstream-filter.js.map

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

package/dist/api/decoder.d.ts

@@ -1,6 +1,6 @@
-import { CodecContext, Frame } from '../lib/index.js';
+import { Codec, CodecContext, Frame } from '../lib/index.js';
 import type { Packet, Stream } from '../lib/index.js';
-import type { DecoderOptions, StreamInfo } from './types.js';
+import type { DecoderOptions } from './types.js';
 /**
  * High-level decoder for audio and video streams.
  *
@@ -45,13 +45,15 @@ import type { DecoderOptions, StreamInfo } from './types.js';
  */
 export declare class Decoder implements Disposable {
     private codecContext;
+    private codec;
     private frame;
-    private streamIndex;
     private stream;
-    private isOpen;
+    private initialized;
+    private isClosed;
     private hardware?;
     /**
      * @param codecContext - Configured codec context
+     * @param codec - Codec being used
      * @param stream - Media stream being decoded
      * @param hardware - Optional hardware context
      * Use {@link create} factory method
@@ -71,6 +73,7 @@ export declare class Decoder implements Disposable {
      * @returns Configured decoder instance
      *
      * @throws {Error} If decoder not found for codec
+     *
      * @throws {FFmpegError} If codec initialization fails
      *
      * @example
@@ -119,36 +122,21 @@ export declare class Decoder implements Disposable {
      */
     get isDecoderOpen(): boolean;
     /**
-     * Get output stream information.
+     * Check if decoder has been initialized.
      *
-     * Returns format information about decoded frames.
-     * For hardware decoding, returns the hardware pixel format.
-     * Essential for configuring downstream components like encoders or filters.
+     * Returns true if decoder is initialized (true by default for decoders).
+     * Decoders are pre-initialized from stream parameters.
      *
-     * @returns Stream format information
+     * @returns true if decoder has been initialized
      *
      * @example
      * ```typescript
-     * const info = decoder.getOutputStreamInfo();
-     * if (info.type === 'video') {
-     *   console.log(`Video: ${info.width}x${info.height} @ ${info.pixelFormat}`);
-     *   console.log(`Frame rate: ${info.frameRate.num}/${info.frameRate.den}`);
+     * if (decoder.isDecoderInitialized) {
+     *   console.log('Decoder is ready to process frames');
      * }
      * ```
-     *
-     * @example
-     * ```typescript
-     * const info = decoder.getOutputStreamInfo();
-     * if (info.type === 'audio') {
-     *   console.log(`Audio: ${info.sampleRate}Hz ${info.sampleFormat}`);
-     *   console.log(`Channels: ${info.channelLayout}`);
-     * }
-     * ```
-     *
-     * @see {@link StreamInfo} For format details
-     * @see {@link Encoder.create} For matching encoder configuration
      */
-    getOutputStreamInfo(): StreamInfo;
+    get isDecoderInitialized(): boolean;
     /**
      * Check if decoder uses hardware acceleration.
      *
@@ -164,6 +152,19 @@ export declare class Decoder implements Disposable {
      * @see {@link HardwareContext} For hardware setup
      */
     isHardware(): boolean;
+    /**
+     * Check if decoder is ready for processing.
+     *
+     * @returns true if initialized and ready
+     *
+     * @example
+     * ```typescript
+     * if (decoder.isReady()) {
+     *   const frame = await decoder.decode(packet);
+     * }
+     * ```
+     */
+    isReady(): boolean;
     /**
      * Decode a packet to a frame.
      *
@@ -177,6 +178,7 @@ export declare class Decoder implements Disposable {
      * @returns Decoded frame or null if more data needed
      *
      * @throws {Error} If decoder is closed
+     *
      * @throws {FFmpegError} If decoding fails
      *
      * @example
@@ -191,7 +193,7 @@ export declare class Decoder implements Disposable {
      * @example
      * ```typescript
      * for await (const packet of input.packets()) {
-     *   if (packet.streamIndex === decoder.getStreamIndex()) {
+     *   if (packet.streamIndex === decoder.getStream().index) {
      *     const frame = await decoder.decode(packet);
      *     if (frame) {
      *       await processFrame(frame);
@@ -207,42 +209,94 @@ export declare class Decoder implements Disposable {
      */
     decode(packet: Packet): Promise<Frame | null>;
     /**
-     * Flush decoder and get buffered frame.
+     * Decode packet stream to frame stream.
      *
-     * Signals end-of-stream and retrieves remaining frames.
-     * Call repeatedly until null to get all buffered frames.
-     * Essential for ensuring all frames are decoded.
+     * High-level async generator for complete decoding pipeline.
+     * Automatically filters packets for this stream, manages memory,
+     * and flushes buffered frames at end.
+     * Primary interface for stream-based decoding.
      *
-     * Direct mapping to avcodec_send_packet(NULL).
+     * @param packets - Async iterable of packets
+     * @yields {Frame} Decoded frames
+     * @throws {Error} If decoder is closed
      *
-     * @returns Buffered frame or null if none remaining
+     * @throws {FFmpegError} If decoding fails
      *
-     * @throws {Error} If decoder is closed
+     * @example
+     * ```typescript
+     * await using input = await MediaInput.open('video.mp4');
+     * using decoder = await Decoder.create(input.video());
+     *
+     * for await (const frame of decoder.frames(input.packets())) {
+     *   console.log(`Frame: ${frame.width}x${frame.height}`);
+     *   frame.free();
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * for await (const frame of decoder.frames(input.packets())) {
+     *   // Process frame
+     *   await filter.process(frame);
+     *
+     *   // Frame automatically freed
+     *   frame.free();
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * import { pipeline } from 'node-av/api';
+     *
+     * const control = pipeline(
+     *   input,
+     *   decoder,
+     *   encoder,
+     *   output
+     * );
+     * await control.completion;
+     * ```
+     *
+     * @see {@link decode} For single packet decoding
+     * @see {@link MediaInput.packets} For packet source
+     */
+    frames(packets: AsyncIterable<Packet>): AsyncGenerator<Frame>;
+    /**
+     * Flush decoder and signal end-of-stream.
+     *
+     * Sends null packet to decoder to signal end-of-stream.
+     * Does nothing if decoder is closed.
+     * Must use receive() or flushFrames() to get remaining buffered frames.
+     *
+     * Direct mapping to avcodec_send_packet(NULL).
+     *
+     * @throws {FFmpegError} If flush fails
      *
      * @example
      * ```typescript
-     * // After all packets processed
+     * // Signal end of stream
+     * await decoder.flush();
+     *
+     * // Then get remaining frames
      * let frame;
-     * while ((frame = await decoder.flush()) !== null) {
+     * while ((frame = await decoder.receive()) !== null) {
      *   console.log('Got buffered frame');
-     *   await processFrame(frame);
      *   frame.free();
      * }
      * ```
      *
-     * @see {@link flushFrames} For async iteration
-     * @see {@link frames} For complete decoding pipeline
+     * @see {@link flushFrames} For convenient async iteration
+     * @see {@link receive} For getting buffered frames
      */
-    flush(): Promise<Frame | null>;
+    flush(): Promise<void>;
     /**
      * Flush all buffered frames as async generator.
      *
      * Convenient async iteration over remaining frames.
-     * Automatically handles repeated flush calls.
+     * Automatically sends flush signal and retrieves buffered frames.
      * Useful for end-of-stream processing.
      *
-     * @yields Buffered frames
-     * @throws {Error} If decoder is closed
+     * @yields {Frame} Buffered frames
      *
      * @example
      * ```typescript
@@ -254,62 +308,47 @@ export declare class Decoder implements Disposable {
      * }
      * ```
      *
-     * @see {@link flush} For single frame flush
+     * @see {@link flush} For signaling end-of-stream
      * @see {@link frames} For complete pipeline
      */
     flushFrames(): AsyncGenerator<Frame>;
     /**
-     * Decode packet stream to frame stream.
+     * Receive frame from decoder.
      *
-     * High-level async generator for complete decoding pipeline.
-     * Automatically filters packets for this stream, manages memory,
-     * and flushes buffered frames at end.
-     * Primary interface for stream-based decoding.
+     * Gets decoded frames from the codec's internal buffer.
+     * Handles frame cloning and error checking.
+     * Hardware frames include hw_frames_ctx reference.
+     * Call repeatedly until null to drain all buffered frames.
      *
-     * @param packets - Async iterable of packets
-     * @yields Decoded frames
-     * @throws {Error} If decoder is closed
-     * @throws {FFmpegError} If decoding fails
+     * Direct mapping to avcodec_receive_frame().
      *
-     * @example
-     * ```typescript
-     * await using input = await MediaInput.open('video.mp4');
-     * using decoder = await Decoder.create(input.video());
+     * @returns Cloned frame or null if no frames available
      *
-     * for await (const frame of decoder.frames(input.packets())) {
-     *   console.log(`Frame: ${frame.width}x${frame.height}`);
-     *   frame.free();
-     * }
-     * ```
+     * @throws {FFmpegError} If receive fails with error other than AVERROR_EAGAIN or AVERROR_EOF
      *
      * @example
      * ```typescript
-     * for await (const frame of decoder.frames(input.packets())) {
-     *   // Process frame
-     *   await filter.filterFrame(frame);
-     *
-     *   // Frame automatically freed
+     * const frame = await decoder.receive();
+     * if (frame) {
+     *   console.log('Got decoded frame');
      *   frame.free();
      * }
      * ```
      *
      * @example
      * ```typescript
-     * import { pipeline } from 'node-av/api';
-     *
-     * const control = pipeline(
-     *   input,
-     *   decoder,
-     *   encoder,
-     *   output
-     * );
-     * await control.completion;
+     * // Drain all buffered frames
+     * let frame;
+     * while ((frame = await decoder.receive()) !== null) {
+     *   console.log(`Frame PTS: ${frame.pts}`);
+     *   frame.free();
+     * }
      * ```
      *
-     * @see {@link decode} For single packet decoding
-     * @see {@link MediaInput.packets} For packet source
+     * @see {@link decode} For sending packets and receiving frames
+     * @see {@link flush} For signaling end-of-stream
      */
-    frames(packets: AsyncIterable<Packet>): AsyncGenerator<Frame>;
+    receive(): Promise<Frame | null>;
     /**
      * Close decoder and free resources.
      *
@@ -330,24 +369,6 @@ export declare class Decoder implements Disposable {
      * @see {@link Symbol.dispose} For automatic cleanup
      */
     close(): void;
-    /**
-     * Get stream index.
-     *
-     * Returns the index of the stream being decoded.
-     * Used for packet filtering in multi-stream files.
-     *
-     * @returns Stream index
-     *
-     * @example
-     * ```typescript
-     * if (packet.streamIndex === decoder.getStreamIndex()) {
-     *   const frame = await decoder.decode(packet);
-     * }
-     * ```
-     *
-     * @see {@link getStream} For full stream object
-     */
-    getStreamIndex(): number;
     /**
      * Get stream object.
      *
@@ -356,43 +377,38 @@ export declare class Decoder implements Disposable {
      *
      * @returns Stream object
      *
-     * @example
-     * ```typescript
-     * const stream = decoder.getStream();
-     * console.log(`Duration: ${stream.duration}`);
-     * console.log(`Time base: ${stream.timeBase.num}/${stream.timeBase.den}`);
-     * ```
+     * @internal
      *
-     * @see {@link Stream} For stream properties
-     * @see {@link getStreamIndex} For index only
+     * @see {@link Stream} For stream details
      */
     getStream(): Stream;
     /**
-     * Get underlying codec context.
+     * Get decoder codec.
      *
-     * Returns the internal codec context for advanced operations.
-     * Returns null if decoder is closed.
+     * Returns the codec used by this decoder.
+     * Useful for checking codec capabilities and properties.
      *
-     * @returns Codec context or null
+     * @returns Codec instance
      *
      * @internal
+     *
+     * @see {@link Codec} For codec details
      */
-    getCodecContext(): CodecContext | null;
+    getCodec(): Codec;
     /**
-     * Receive frame from decoder.
-     *
-     * Internal method to get decoded frames from codec.
-     * Handles frame cloning and error checking.
-     * Hardware frames include hw_frames_ctx reference.
+     * Get underlying codec context.
      *
-     * Direct mapping to avcodec_receive_frame().
+     * Returns the codec context for advanced operations.
+     * Useful for accessing low-level codec properties and settings.
+     * Returns null if decoder is closed.
      *
-     * @returns Cloned frame or null
+     * @returns Codec context or null if closed
      *
-     * @throws {FFmpegError} If receive fails with error other than AVERROR_EAGAIN or AVERROR_EOF
+     * @internal
      *
+     * @see {@link CodecContext} For context details
      */
-    private receiveFrameInternal;
+    getCodecContext(): CodecContext | null;
     /**
      * Dispose of decoder.
      *