node-av 3.1.3 → 5.0.0

package/dist/lib/stream.js

@@ -1,4 +1,5 @@
 import { CodecParameters } from './codec-parameters.js';
+import { CodecParser } from './codec-parser.js';
 import { Dictionary } from './dictionary.js';
 import { Rational } from './rational.js';
 /**
@@ -44,7 +45,9 @@ import { Rational } from './rational.js';
  */
 export class Stream {
     native;
+    _metadata; // Cache for metadata wrapper
     _codecpar; // Cache the wrapped codecpar
+    _parser; // Cache the wrapped parser
     /**
      * @param native - The native stream instance
      *
@@ -242,6 +245,20 @@ export class Stream {
     set rFrameRate(value) {
         this.native.rFrameRate = { num: value.num, den: value.den };
     }
+    /**
+     * Number of bits for PTS wrap-around detection.
+     *
+     * Used for timestamp wrap-around correction in formats with limited timestamp bits.
+     * Common values: 33 (MPEG-TS), 31 (DVB), 64 (no wrapping).
+     *
+     * Direct mapping to AVStream->pts_wrap_bits.
+     */
+    get ptsWrapBits() {
+        return this.native.ptsWrapBits;
+    }
+    set ptsWrapBits(value) {
+        this.native.ptsWrapBits = value;
+    }
     /**
      * Stream metadata.
      *
@@ -251,14 +268,25 @@ export class Stream {
      * Direct mapping to AVStream->metadata.
      */
     get metadata() {
-        const nativeDict = this.native.metadata;
-        if (!nativeDict) {
+        const native = this.native.metadata;
+        if (!native) {
+            // Clear cache if native is null
+            this._metadata = undefined;
             return null;
         }
-        return Dictionary.fromNative(nativeDict);
+        // Return cached wrapper if available and still valid
+        if (this._metadata && this._metadata.native === native) {
+            return this._metadata;
+        }
+        // Create and cache new wrapper
+        const device = Object.create(Dictionary.prototype);
+        device.native = native;
+        this._metadata = device;
+        return device;
     }
     set metadata(value) {
         this.native.metadata = value?.getNative() ?? null;
+        this._metadata = undefined;
     }
     /**
      * Attached picture.
@@ -285,6 +313,45 @@ export class Stream {
     set eventFlags(value) {
         this.native.eventFlags = value;
     }
+    /**
+     * Get the codec parser attached to this stream.
+     *
+     * Returns the parser context if the stream has an active parser, null otherwise.
+     * Parsers are automatically created by FFmpeg for certain formats and codecs.
+     * Useful for accessing parser state like repeat_pict for interlaced video.
+     *
+     * Direct mapping to av_stream_get_parser().
+     *
+     * @returns Parser context or null if no parser attached
+     *
+     * @example
+     * ```typescript
+     * const parser = stream.parser;
+     * if (parser) {
+     *   const fields = 1 + parser.repeatPict;
+     *   console.log(`Frame uses ${fields} fields`);
+     * }
+     * ```
+     *
+     * @see {@link CodecParser} For parser details
+     */
+    get parser() {
+        const native = this.native.parser;
+        if (!native) {
+            // Clear cache if native is null
+            this._parser = undefined;
+            return null;
+        }
+        // Return cached wrapper if available and still valid
+        if (this._parser && this._parser.native === native) {
+            return this._parser;
+        }
+        // Create and cache new wrapper
+        const parser = Object.create(CodecParser.prototype);
+        parser.native = native;
+        this._parser = parser;
+        return parser;
+    }
     /**
      * Set stream event flags.
      *
@@ -302,10 +369,13 @@ export class Stream {
      * ```
      *
      * @see {@link clearEventFlags} To unset event flags
+     * @see {@link hasEventFlags} To check event flags
      * @see {@link eventFlags} For direct event flag access
      */
     setEventFlags(...flags) {
-        this.native.setEventFlags(...flags);
+        for (const flag of flags) {
+            this.native.eventFlags = (this.native.eventFlags | flag);
+        }
     }
     /**
      * Clear stream event flags.
@@ -324,10 +394,123 @@ export class Stream {
      * ```
      *
      * @see {@link setEventFlags} To set event flags
+     * @see {@link hasEventFlags} To check event flags
      * @see {@link eventFlags} For direct event flag access
      */
     clearEventFlags(...flags) {
-        this.native.clearEventFlags(...flags);
+        for (const flag of flags) {
+            this.native.eventFlags = (this.native.eventFlags & ~flag);
+        }
+    }
+    /**
+     * Check if stream has specific event flags.
+     *
+     * Tests whether all specified event flags are set using bitwise AND.
+     *
+     * @param flags - One or more event flag values to check
+     *
+     * @returns true if all specified event flags are set, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AVSTREAM_EVENT_FLAG_METADATA_UPDATED } from 'node-av/constants';
+     *
+     * if (stream.hasEventFlags(AVSTREAM_EVENT_FLAG_METADATA_UPDATED)) {
+     *   console.log('Stream metadata was updated');
+     * }
+     * ```
+     *
+     * @see {@link setEventFlags} To set event flags
+     * @see {@link clearEventFlags} To unset event flags
+     * @see {@link eventFlags} For direct event flag access
+     */
+    hasEventFlags(...flags) {
+        for (const flag of flags) {
+            if ((this.native.eventFlags & flag) !== flag) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Set stream disposition flags.
+     *
+     * Sets one or more disposition flags using bitwise OR. Allows setting multiple flags
+     * without manually performing bitwise operations.
+     *
+     * @param flags - One or more disposition flag values to set
+     *
+     * @example
+     * ```typescript
+     * import { AV_DISPOSITION_DEFAULT, AV_DISPOSITION_FORCED } from 'node-av/constants';
+     *
+     * // Set multiple disposition flags at once
+     * stream.setDisposition(AV_DISPOSITION_DEFAULT, AV_DISPOSITION_FORCED);
+     * ```
+     *
+     * @see {@link clearDisposition} To unset disposition flags
+     * @see {@link hasDisposition} To check disposition flags
+     * @see {@link disposition} For direct disposition flag access
+     */
+    setDisposition(...flags) {
+        for (const flag of flags) {
+            this.native.disposition = (this.native.disposition | flag);
+        }
+    }
+    /**
+     * Clear stream disposition flags.
+     *
+     * Clears one or more disposition flags using bitwise AND NOT. Allows clearing multiple
+     * flags without manually performing bitwise operations.
+     *
+     * @param flags - One or more disposition flag values to clear
+     *
+     * @example
+     * ```typescript
+     * import { AV_DISPOSITION_FORCED } from 'node-av/constants';
+     *
+     * // Clear specific disposition flag
+     * stream.clearDisposition(AV_DISPOSITION_FORCED);
+     * ```
+     *
+     * @see {@link setDisposition} To set disposition flags
+     * @see {@link hasDisposition} To check disposition flags
+     * @see {@link disposition} For direct disposition flag access
+     */
+    clearDisposition(...flags) {
+        for (const flag of flags) {
+            this.native.disposition = (this.native.disposition & ~flag);
+        }
+    }
+    /**
+     * Check if stream has specific disposition flags.
+     *
+     * Tests whether all specified disposition flags are set using bitwise AND.
+     *
+     * @param flags - One or more disposition flag values to check
+     *
+     * @returns true if all specified disposition flags are set, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AV_DISPOSITION_DEFAULT } from 'node-av/constants';
+     *
+     * if (stream.hasDisposition(AV_DISPOSITION_DEFAULT)) {
+     *   console.log('Stream is marked as default');
+     * }
+     * ```
+     *
+     * @see {@link setDisposition} To set disposition flags
+     * @see {@link clearDisposition} To unset disposition flags
+     * @see {@link disposition} For direct disposition flag access
+     */
+    hasDisposition(...flags) {
+        for (const flag of flags) {
+            if ((this.native.disposition & flag) !== flag) {
+                return false;
+            }
+        }
+        return true;
     }
     /**
      * Get the underlying native Stream object.

package/dist/lib/stream.js.map

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

package/dist/lib/sync-queue.d.ts

@@ -0,0 +1,179 @@
+import type { NativeSyncQueue, NativeWrapper } from './native-types.js';
+import type { Packet } from './packet.js';
+/**
+ * Sync Queue Type
+ *
+ * Determines the sync queue behavior for different media types.
+ */
+export declare enum SyncQueueType {
+    /**
+     * Buffer packets based on their duration in time base units.
+     * Used for audio and video streams.
+     */
+    PACKETS = 0,
+    /**
+     * Buffer frames based on their sample count.
+     * Used for audio frames where synchronization is sample-based.
+     */
+    FRAMES = 1
+}
+/**
+ * Sync Queue for packet synchronization
+ *
+ * FFmpeg's native sync_queue from fftools that synchronizes packets from multiple
+ * streams before muxing. Prevents streams from getting ahead of each other and
+ * ensures proper interleaving for containers with strict timing requirements.
+ *
+ * This is the same synchronization mechanism used by FFmpeg CLI (fftools).
+ *
+ * Direct mapping to FFmpeg's SyncQueue from fftools/sync_queue.h.
+ *
+ * @example
+ * ```typescript
+ * import { SyncQueue, SyncQueueType } from 'node-av';
+ *
+ * // Create sync queue with 1 second buffer
+ * const sq = SyncQueue.create(SyncQueueType.PACKETS, 1000000);
+ *
+ * // Add streams
+ * const videoIdx = sq.addStream(1);  // 1 = limiting stream
+ * const audioIdx = sq.addStream(1);
+ *
+ * // Send packets to queue
+ * sq.send(videoIdx, videoPacket);
+ * sq.send(audioIdx, audioPacket);
+ *
+ * // Receive synchronized packets
+ * const result = sq.receive(-1);  // -1 = any stream
+ * if (result.error === 0) {
+ *   console.log(`Stream ${result.streamIdx}: ${result.packet}`);
+ *   // Write packet to muxer...
+ * }
+ *
+ * // Cleanup
+ * sq.free();
+ * ```
+ *
+ * @see [sync_queue.h](https://github.com/FFmpeg/FFmpeg/blob/master/fftools/sync_queue.h) - FFmpeg source
+ */
+export declare class SyncQueue implements Disposable, NativeWrapper<NativeSyncQueue> {
+    /** @internal */
+    native: NativeSyncQueue;
+    private constructor();
+    /**
+     * Create a new sync queue.
+     *
+     * @param type - Queue type (PACKETS or FRAMES)
+     *
+     * @param bufferSizeUs - Buffer size in microseconds (default: 100ms)
+     *
+     * @returns New SyncQueue instance
+     *
+     * @example
+     * ```typescript
+     * // 500ms buffer for RTSP streams
+     * const sq = SyncQueue.create(SyncQueueType.PACKETS, 500000);
+     * ```
+     */
+    static create(type?: SyncQueueType, bufferSizeUs?: number): SyncQueue;
+    /**
+     * Add a stream to the sync queue.
+     *
+     * @param limiting - Whether this stream should limit other streams (1 = yes, 0 = no).
+     *                   Limiting streams control the head position - other streams cannot get ahead.
+     *
+     * @returns Stream index in the sync queue
+     *
+     * @example
+     * ```typescript
+     * const videoIdx = sq.addStream(1);  // Video limits timing
+     * const audioIdx = sq.addStream(1);  // Audio limits timing
+     * const subtitleIdx = sq.addStream(0);  // Subtitles don't limit
+     * ```
+     */
+    addStream(limiting?: number): number;
+    /**
+     * Send a packet to the sync queue.
+     *
+     * The packet is cloned internally, so the original can be reused/freed.
+     *
+     * To signal EOF for a stream, pass null as the packet.
+     * This tells the sync queue that no more packets will be sent for this stream.
+     *
+     * @param streamIdx - Stream index returned from addStream()
+     *
+     * @param packet - Packet to send, or null to signal EOF
+     *
+     * @returns 0 on success, AVERROR_EOF if EOF, negative on error
+     *
+     * @example
+     * ```typescript
+     * // Send normal packet
+     * const ret = sq.send(videoIdx, packet);
+     * if (ret === AVERROR_EOF) {
+     *   console.log('Stream finished');
+     * }
+     *
+     * // Signal EOF for stream
+     * sq.send(videoIdx, null);
+     * ```
+     */
+    send(streamIdx: number, packet: Packet | null): number;
+    /**
+     * Receive a packet from the sync queue.
+     *
+     * This will receive the next packet that should be written to maintain
+     * proper synchronization between streams. The packet parameter is filled
+     * with the received data.
+     *
+     * @param streamIdx - Stream index to receive from, or -1 for any stream
+     *
+     * @param packet - Packet to fill with received data (output parameter)
+     *
+     * @returns Stream index (>= 0) on success, or negative error code:
+     *          - >= 0: Stream index that the packet belongs to
+     *          - AVERROR(EAGAIN): No packets ready yet, more frames needed
+     *          - AVERROR_EOF: All streams finished
+     *
+     * @example
+     * ```typescript
+     * import { AVERROR } from 'node-av';
+     *
+     * // Receive from any stream (FFmpeg mux pattern)
+     * const packet = new Packet();
+     * while (true) {
+     *   const ret = sq.receive(-1, packet);
+     *   if (ret === AVERROR('EAGAIN')) {
+     *     break;  // No packets ready
+     *   }
+     *   if (ret === AVERROR_EOF) {
+     *     break;  // All streams finished
+     *   }
+     *   if (ret >= 0) {
+     *     // ret is the stream index
+     *     await muxer.interleavedWriteFrame(packet);
+     *   }
+     * }
+     * ```
+     */
+    receive(streamIdx: number, packet: Packet): number;
+    /**
+     * Free the sync queue and all buffered packets.
+     * After calling this, the queue cannot be used anymore.
+     *
+     * @example
+     * ```typescript
+     * sq.free();
+     * ```
+     */
+    free(): void;
+    /**
+     * Get the underlying native SyncQueue object.
+     *
+     * @returns The native SyncQueue binding object
+     *
+     * @internal
+     */
+    getNative(): NativeSyncQueue;
+    [Symbol.dispose](): void;
+}

package/dist/lib/sync-queue.js

@@ -0,0 +1,197 @@
+import { bindings } from './binding.js';
+/**
+ * Sync Queue Type
+ *
+ * Determines the sync queue behavior for different media types.
+ */
+export var SyncQueueType;
+(function (SyncQueueType) {
+    /**
+     * Buffer packets based on their duration in time base units.
+     * Used for audio and video streams.
+     */
+    SyncQueueType[SyncQueueType["PACKETS"] = 0] = "PACKETS";
+    /**
+     * Buffer frames based on their sample count.
+     * Used for audio frames where synchronization is sample-based.
+     */
+    SyncQueueType[SyncQueueType["FRAMES"] = 1] = "FRAMES";
+})(SyncQueueType || (SyncQueueType = {}));
+/**
+ * Sync Queue for packet synchronization
+ *
+ * FFmpeg's native sync_queue from fftools that synchronizes packets from multiple
+ * streams before muxing. Prevents streams from getting ahead of each other and
+ * ensures proper interleaving for containers with strict timing requirements.
+ *
+ * This is the same synchronization mechanism used by FFmpeg CLI (fftools).
+ *
+ * Direct mapping to FFmpeg's SyncQueue from fftools/sync_queue.h.
+ *
+ * @example
+ * ```typescript
+ * import { SyncQueue, SyncQueueType } from 'node-av';
+ *
+ * // Create sync queue with 1 second buffer
+ * const sq = SyncQueue.create(SyncQueueType.PACKETS, 1000000);
+ *
+ * // Add streams
+ * const videoIdx = sq.addStream(1);  // 1 = limiting stream
+ * const audioIdx = sq.addStream(1);
+ *
+ * // Send packets to queue
+ * sq.send(videoIdx, videoPacket);
+ * sq.send(audioIdx, audioPacket);
+ *
+ * // Receive synchronized packets
+ * const result = sq.receive(-1);  // -1 = any stream
+ * if (result.error === 0) {
+ *   console.log(`Stream ${result.streamIdx}: ${result.packet}`);
+ *   // Write packet to muxer...
+ * }
+ *
+ * // Cleanup
+ * sq.free();
+ * ```
+ *
+ * @see [sync_queue.h](https://github.com/FFmpeg/FFmpeg/blob/master/fftools/sync_queue.h) - FFmpeg source
+ */
+export class SyncQueue {
+    /** @internal */
+    native;
+    constructor(native) {
+        this.native = native;
+    }
+    /**
+     * Create a new sync queue.
+     *
+     * @param type - Queue type (PACKETS or FRAMES)
+     *
+     * @param bufferSizeUs - Buffer size in microseconds (default: 100ms)
+     *
+     * @returns New SyncQueue instance
+     *
+     * @example
+     * ```typescript
+     * // 500ms buffer for RTSP streams
+     * const sq = SyncQueue.create(SyncQueueType.PACKETS, 500000);
+     * ```
+     */
+    static create(type = SyncQueueType.PACKETS, bufferSizeUs = 100000) {
+        const native = bindings.SyncQueue.create(type, bufferSizeUs);
+        return new SyncQueue(native);
+    }
+    /**
+     * Add a stream to the sync queue.
+     *
+     * @param limiting - Whether this stream should limit other streams (1 = yes, 0 = no).
+     *                   Limiting streams control the head position - other streams cannot get ahead.
+     *
+     * @returns Stream index in the sync queue
+     *
+     * @example
+     * ```typescript
+     * const videoIdx = sq.addStream(1);  // Video limits timing
+     * const audioIdx = sq.addStream(1);  // Audio limits timing
+     * const subtitleIdx = sq.addStream(0);  // Subtitles don't limit
+     * ```
+     */
+    addStream(limiting = 1) {
+        return this.native.addStream(limiting);
+    }
+    /**
+     * Send a packet to the sync queue.
+     *
+     * The packet is cloned internally, so the original can be reused/freed.
+     *
+     * To signal EOF for a stream, pass null as the packet.
+     * This tells the sync queue that no more packets will be sent for this stream.
+     *
+     * @param streamIdx - Stream index returned from addStream()
+     *
+     * @param packet - Packet to send, or null to signal EOF
+     *
+     * @returns 0 on success, AVERROR_EOF if EOF, negative on error
+     *
+     * @example
+     * ```typescript
+     * // Send normal packet
+     * const ret = sq.send(videoIdx, packet);
+     * if (ret === AVERROR_EOF) {
+     *   console.log('Stream finished');
+     * }
+     *
+     * // Signal EOF for stream
+     * sq.send(videoIdx, null);
+     * ```
+     */
+    send(streamIdx, packet) {
+        return this.native.send(streamIdx, packet?.getNative() ?? null);
+    }
+    /**
+     * Receive a packet from the sync queue.
+     *
+     * This will receive the next packet that should be written to maintain
+     * proper synchronization between streams. The packet parameter is filled
+     * with the received data.
+     *
+     * @param streamIdx - Stream index to receive from, or -1 for any stream
+     *
+     * @param packet - Packet to fill with received data (output parameter)
+     *
+     * @returns Stream index (>= 0) on success, or negative error code:
+     *          - >= 0: Stream index that the packet belongs to
+     *          - AVERROR(EAGAIN): No packets ready yet, more frames needed
+     *          - AVERROR_EOF: All streams finished
+     *
+     * @example
+     * ```typescript
+     * import { AVERROR } from 'node-av';
+     *
+     * // Receive from any stream (FFmpeg mux pattern)
+     * const packet = new Packet();
+     * while (true) {
+     *   const ret = sq.receive(-1, packet);
+     *   if (ret === AVERROR('EAGAIN')) {
+     *     break;  // No packets ready
+     *   }
+     *   if (ret === AVERROR_EOF) {
+     *     break;  // All streams finished
+     *   }
+     *   if (ret >= 0) {
+     *     // ret is the stream index
+     *     await muxer.interleavedWriteFrame(packet);
+     *   }
+     * }
+     * ```
+     */
+    receive(streamIdx, packet) {
+        return this.native.receive(streamIdx, packet.getNative());
+    }
+    /**
+     * Free the sync queue and all buffered packets.
+     * After calling this, the queue cannot be used anymore.
+     *
+     * @example
+     * ```typescript
+     * sq.free();
+     * ```
+     */
+    free() {
+        this.native.free();
+    }
+    /**
+     * Get the underlying native SyncQueue object.
+     *
+     * @returns The native SyncQueue binding object
+     *
+     * @internal
+     */
+    getNative() {
+        return this.native;
+    }
+    [Symbol.dispose]() {
+        this.free();
+    }
+}
+//# sourceMappingURL=sync-queue.js.map

package/dist/lib/sync-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-queue.js","sourceRoot":"","sources":["../../src/lib/sync-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;GAIG;AACH,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB;;;OAGG;IACH,uDAAW,CAAA;IAEX;;;OAGG;IACH,qDAAU,CAAA;AACZ,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAO,SAAS;IACpB,gBAAgB;IACT,MAAM,CAAkB;IAE/B,YAAoB,MAAuB;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAAM,CAAC,OAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC7D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,GAAG,CAAC;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,SAAiB,EAAE,MAAqB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,OAAO,CAAC,SAAiB,EAAE,MAAc;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;CACF"}