node-av 3.1.2 → 4.0.0

package/dist/api/utilities/async-queue.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AsyncQueue provides a promise-based blocking queue similar to FFmpeg's ThreadQueue.
+ *
+ * Unlike FFmpeg's pthread-based blocking, this uses Promises to achieve
+ * non-blocking async behavior while maintaining queue semantics.
+ *
+ * @example
+ * ```typescript
+ * const queue = new AsyncQueue<Frame>(8);
+ *
+ * // Producer
+ * await queue.send(frame);  // Blocks if queue full
+ *
+ * // Consumer
+ * const frame = await queue.receive();  // Blocks if queue empty
+ *
+ * // Cleanup
+ * queue.close();
+ * ```
+ */
+export declare class AsyncQueue<T> {
+    private queue;
+    private sendWaiters;
+    private receiveWaiters;
+    private maxSize;
+    private closed;
+    /**
+     * Creates a new AsyncQueue.
+     *
+     * @param maxSize Maximum number of items in queue before send() blocks
+     */
+    constructor(maxSize: number);
+    /**
+     * Current number of items in the queue.
+     */
+    get size(): number;
+    /**
+     * Whether the queue is closed.
+     */
+    get isClosed(): boolean;
+    /**
+     * Maximum queue size (from constructor).
+     */
+    get capacity(): number;
+    /**
+     * Number of producers waiting to send (backpressure indicator).
+     */
+    get waitingSenders(): number;
+    /**
+     * Number of consumers waiting to receive.
+     */
+    get waitingReceivers(): number;
+    /**
+     * Sends an item to the queue.
+     *
+     * If the queue is full, this method blocks (awaits) until space is available.
+     *
+     * @param item Item to send
+     *
+     * @returns Promise that resolves when item is sent
+     *
+     * @example
+     * ```typescript
+     * await queue.send(item);
+     * ```
+     */
+    send(item: T): Promise<void>;
+    /**
+     * Receives an item from the queue.
+     *
+     * If the queue is empty and not closed, this method blocks (awaits) until an item is available.
+     * If the queue is closed and empty, returns null.
+     *
+     * @returns Next item from queue, or null if closed and empty
+     *
+     * @example
+     * ```typescript
+     * const item = await queue.receive();
+     * ```
+     */
+    receive(): Promise<T | null>;
+    /**
+     * Closes the queue, rejecting any pending sends and resolving pending receives with null.
+     *
+     * @example
+     * ```typescript
+     * queue.close();
+     * ```
+     */
+    close(): void;
+}

package/dist/api/utilities/async-queue.js

@@ -0,0 +1,162 @@
+/**
+ * AsyncQueue provides a promise-based blocking queue similar to FFmpeg's ThreadQueue.
+ *
+ * Unlike FFmpeg's pthread-based blocking, this uses Promises to achieve
+ * non-blocking async behavior while maintaining queue semantics.
+ *
+ * @example
+ * ```typescript
+ * const queue = new AsyncQueue<Frame>(8);
+ *
+ * // Producer
+ * await queue.send(frame);  // Blocks if queue full
+ *
+ * // Consumer
+ * const frame = await queue.receive();  // Blocks if queue empty
+ *
+ * // Cleanup
+ * queue.close();
+ * ```
+ */
+export class AsyncQueue {
+    queue = [];
+    sendWaiters = [];
+    receiveWaiters = [];
+    maxSize;
+    closed = false;
+    /**
+     * Creates a new AsyncQueue.
+     *
+     * @param maxSize Maximum number of items in queue before send() blocks
+     */
+    constructor(maxSize) {
+        if (maxSize <= 0) {
+            maxSize = 1;
+        }
+        this.maxSize = maxSize;
+    }
+    /**
+     * Current number of items in the queue.
+     */
+    get size() {
+        return this.queue.length;
+    }
+    /**
+     * Whether the queue is closed.
+     */
+    get isClosed() {
+        return this.closed;
+    }
+    /**
+     * Maximum queue size (from constructor).
+     */
+    get capacity() {
+        return this.maxSize;
+    }
+    /**
+     * Number of producers waiting to send (backpressure indicator).
+     */
+    get waitingSenders() {
+        return this.sendWaiters.length;
+    }
+    /**
+     * Number of consumers waiting to receive.
+     */
+    get waitingReceivers() {
+        return this.receiveWaiters.length;
+    }
+    /**
+     * Sends an item to the queue.
+     *
+     * If the queue is full, this method blocks (awaits) until space is available.
+     *
+     * @param item Item to send
+     *
+     * @returns Promise that resolves when item is sent
+     *
+     * @example
+     * ```typescript
+     * await queue.send(item);
+     * ```
+     */
+    async send(item) {
+        if (this.closed) {
+            return;
+        }
+        // Block if queue full
+        while (this.queue.length >= this.maxSize && !this.closed) {
+            await new Promise((resolve) => this.sendWaiters.push(resolve));
+        }
+        if (this.closed) {
+            return;
+        }
+        this.queue.push(item);
+        // Wake up one receiver if waiting (just signal, don't remove item)
+        const receiver = this.receiveWaiters.shift();
+        if (receiver) {
+            receiver(); // Signal that item is available
+        }
+    }
+    /**
+     * Receives an item from the queue.
+     *
+     * If the queue is empty and not closed, this method blocks (awaits) until an item is available.
+     * If the queue is closed and empty, returns null.
+     *
+     * @returns Next item from queue, or null if closed and empty
+     *
+     * @example
+     * ```typescript
+     * const item = await queue.receive();
+     * ```
+     */
+    async receive() {
+        // Loop until we get an item or queue is closed
+        while (true) {
+            // If queue has items, return immediately
+            if (this.queue.length > 0) {
+                const item = this.queue.shift();
+                // Wake up one sender if waiting
+                const sender = this.sendWaiters.shift();
+                if (sender) {
+                    sender();
+                }
+                return item;
+            }
+            // If closed and empty, return null
+            if (this.closed) {
+                return null;
+            }
+            // Block until signaled
+            await new Promise((resolve) => {
+                this.receiveWaiters.push(resolve);
+            });
+            // After waking up, loop back to check queue again
+        }
+    }
+    /**
+     * Closes the queue, rejecting any pending sends and resolving pending receives with null.
+     *
+     * @example
+     * ```typescript
+     * queue.close();
+     * ```
+     */
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        // Wake up all waiting senders
+        const senders = this.sendWaiters.splice(0);
+        for (const sender of senders) {
+            sender();
+        }
+        // Wake up all waiting receivers (they will get null from empty queue check)
+        const receivers = this.receiveWaiters.splice(0);
+        for (const receiver of receivers) {
+            receiver();
+        }
+    }
+}
+//# sourceMappingURL=async-queue.js.map

package/dist/api/utilities/async-queue.js.map

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

package/dist/api/utilities/audio-sample.d.ts

@@ -1,4 +1,4 @@
-import type { AVSampleFormat } from '../../constants/constants.js';
+import type { AVSampleFormat } from '../../constants/index.js';
 /**
  * Audio sample allocation result.
  */

package/dist/api/utilities/image.d.ts

@@ -1,4 +1,4 @@
-import type { AVPixelFormat } from '../../constants/constants.js';
+import type { AVPixelFormat } from '../../constants/index.js';
 /**
  * Image buffer allocation result.
  */

package/dist/api/utilities/index.d.ts

@@ -6,3 +6,5 @@ export { PixelFormatUtils } from './pixel-format.js';
 export { SampleFormatUtils } from './sample-format.js';
 export { TimestampUtils } from './timestamp.js';
 export { StreamingUtils } from './streaming.js';
+export { AsyncQueue } from './async-queue.js';
+export { Scheduler } from './scheduler.js';

package/dist/api/utilities/index.js

@@ -14,4 +14,8 @@ export { SampleFormatUtils } from './sample-format.js';
 export { TimestampUtils } from './timestamp.js';
 // Streaming
 export { StreamingUtils } from './streaming.js';
+// AsyncQueue
+export { AsyncQueue } from './async-queue.js';
+// Scheduler
+export { Scheduler } from './scheduler.js';
 //# sourceMappingURL=index.js.map

package/dist/api/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/utilities/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAA0D,MAAM,mBAAmB,CAAC;AAE7G,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAE9D,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/utilities/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAA0D,MAAM,mBAAmB,CAAC;AAE7G,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAE9D,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/api/utilities/media-type.d.ts

@@ -1,4 +1,4 @@
-import type { AVMediaType } from '../../constants/constants.js';
+import type { AVMediaType } from '../../constants/index.js';
 /**
  * Media type utilities.
  *

package/dist/api/utilities/pixel-format.d.ts

@@ -1,4 +1,4 @@
-import type { AVPixelFormat } from '../../constants/constants.js';
+import type { AVPixelFormat } from '../../constants/index.js';
 /**
  * Video pixel format utilities.
  *

package/dist/api/utilities/sample-format.d.ts

@@ -1,4 +1,4 @@
-import type { AVSampleFormat } from '../../constants/constants.js';
+import type { AVSampleFormat } from '../../constants/index.js';
 /**
  * Audio sample format utilities.
  *

package/dist/api/utilities/scheduler.d.ts

@@ -0,0 +1,169 @@
+import { Muxer } from '../muxer.js';
+import type { Frame, Packet } from '../../lib/index.js';
+import type { BitStreamFilterAPI } from '../bitstream-filter.js';
+import type { Encoder } from '../encoder.js';
+import type { FilterAPI } from '../filter.js';
+export interface SchedulableComponent<TItem = Packet | Frame> {
+    sendToQueue(item: TItem): Promise<void>;
+    flushPipeline(): Promise<void>;
+    pipeTo(target: FilterAPI | Encoder | BitStreamFilterAPI | Muxer, streamIndex?: number): any;
+}
+/**
+ * Pipeline scheduler for chaining components.
+ *
+ * Allows piping between components (Decoder → Filter → Encoder → Output).
+ */
+export declare class Scheduler<TSend = Packet | Frame> implements AsyncDisposable {
+    private firstComponent;
+    /** @internal */
+    lastComponent: SchedulableComponent<any>;
+    /**
+     * @param firstComponent - First component in the pipeline
+     *
+     * @param lastComponent - Last component in the pipeline (defaults to firstComponent)
+     *
+     * @internal
+     */
+    constructor(firstComponent: SchedulableComponent<TSend>, lastComponent?: SchedulableComponent<any>);
+    /**
+     * Pipe output to a filter component.
+     *
+     * @param target - Filter to receive frames
+     *
+     * @returns Scheduler for continued chaining
+     *
+     * @example
+     * ```typescript
+     * decoder.pipeTo(filter1).pipeTo(filter2)
+     * ```
+     */
+    pipeTo(target: FilterAPI): Scheduler<TSend>;
+    /**
+     * Pipe output to an encoder component.
+     *
+     * @param target - Encoder to receive frames
+     *
+     * @returns Scheduler for continued chaining
+     *
+     * @example
+     * ```typescript
+     * decoder.pipeTo(filter).pipeTo(encoder)
+     * ```
+     */
+    pipeTo(target: Encoder): Scheduler<TSend>;
+    /**
+     * Pipe output to a bitstream filter component.
+     *
+     * @param target - BitStreamFilter to receive packets
+     *
+     * @returns Scheduler for continued chaining
+     *
+     * @example
+     * ```typescript
+     * decoder.pipeTo(encoder).pipeTo(bsf).pipeTo(output, 0)
+     * ```
+     */
+    pipeTo(target: BitStreamFilterAPI): Scheduler<TSend>;
+    /**
+     * Pipe output to a muxer (final stage).
+     *
+     * @param output - Muxer to write to
+     *
+     * @param streamIndex - Stream index in output
+     *
+     * @returns Control interface without pipeTo
+     *
+     * @example
+     * ```typescript
+     * const control = decoder
+     *   .pipeTo(encoder)
+     *   .pipeTo(output, 0);
+     *
+     * await control.send(packet);
+     * ```
+     */
+    pipeTo(output: Muxer, streamIndex: number): SchedulerControl<TSend>;
+    /**
+     * Send an item into the pipeline.
+     *
+     * @param item - Packet or Frame to process
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await scheduler.send(packet);
+     * } catch (error) {
+     *   console.error('Pipeline error:', error);
+     * }
+     * ```
+     */
+    send(item: TSend): Promise<void>;
+    /**
+     * Flush the pipeline.
+     *
+     * @example
+     * ```typescript
+     * await scheduler.flush();
+     * ```
+     */
+    flush(): Promise<void>;
+    /**
+     * Cleanup resources.
+     *
+     * @example
+     * ```typescript
+     * await using scheduler;
+     * ```
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Control interface for completed pipelines.
+ *
+ * Provides control methods without pipeTo() - this is the final
+ * stage after piping to Muxer.
+ *
+ * @template TSend - The input type flowing through the pipeline
+ */
+export declare class SchedulerControl<TSend = Packet | Frame> implements AsyncDisposable {
+    private firstComponent;
+    /**
+     * @param firstComponent - First component in the pipeline
+     *
+     * @internal
+     */
+    constructor(firstComponent: SchedulableComponent<TSend>);
+    /**
+     * Send an item into the pipeline.
+     *
+     * @param item - Packet or Frame to process
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await control.send(packet);
+     * } catch (error) {
+     *   console.error('Pipeline error:', error);
+     * }
+     * ```
+     */
+    send(item: TSend): Promise<void>;
+    /**
+     * Flush the pipeline.
+     *
+     * @example
+     * ```typescript
+     * await control.flush();
+     * ```
+     */
+    flush(): Promise<void>;
+    /**
+     * Cleanup resources.
+     *
+     * @example
+     * ```typescript
+     * await using control;
+     * ```
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}

package/dist/api/utilities/scheduler.js

@@ -0,0 +1,136 @@
+import { Muxer } from '../muxer.js';
+/**
+ * Pipeline scheduler for chaining components.
+ *
+ * Allows piping between components (Decoder → Filter → Encoder → Output).
+ */
+export class Scheduler {
+    firstComponent;
+    /** @internal */
+    lastComponent;
+    /**
+     * @param firstComponent - First component in the pipeline
+     *
+     * @param lastComponent - Last component in the pipeline (defaults to firstComponent)
+     *
+     * @internal
+     */
+    constructor(firstComponent, lastComponent) {
+        this.firstComponent = firstComponent;
+        this.lastComponent = lastComponent ?? firstComponent;
+    }
+    pipeTo(target, streamIndex) {
+        if (typeof this.lastComponent.pipeTo === 'function') {
+            if (target instanceof Muxer) {
+                // Start the pipe task (encoder -> output)
+                this.lastComponent.pipeTo(target, streamIndex);
+                // Return control with correct firstComponent (not lastComponent!)
+                return new SchedulerControl(this.firstComponent);
+            }
+            else {
+                const resultScheduler = this.lastComponent.pipeTo(target);
+                // Keep the original firstComponent, update to new lastComponent
+                return new Scheduler(this.firstComponent, resultScheduler.lastComponent);
+            }
+        }
+        throw new Error('Last component does not support pipeTo');
+    }
+    /**
+     * Send an item into the pipeline.
+     *
+     * @param item - Packet or Frame to process
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await scheduler.send(packet);
+     * } catch (error) {
+     *   console.error('Pipeline error:', error);
+     * }
+     * ```
+     */
+    async send(item) {
+        await this.firstComponent.sendToQueue(item);
+    }
+    /**
+     * Flush the pipeline.
+     *
+     * @example
+     * ```typescript
+     * await scheduler.flush();
+     * ```
+     */
+    async flush() {
+        await this.firstComponent.flushPipeline();
+    }
+    /**
+     * Cleanup resources.
+     *
+     * @example
+     * ```typescript
+     * await using scheduler;
+     * ```
+     */
+    async [Symbol.asyncDispose]() {
+        await this.flush();
+    }
+}
+/**
+ * Control interface for completed pipelines.
+ *
+ * Provides control methods without pipeTo() - this is the final
+ * stage after piping to Muxer.
+ *
+ * @template TSend - The input type flowing through the pipeline
+ */
+export class SchedulerControl {
+    firstComponent;
+    /**
+     * @param firstComponent - First component in the pipeline
+     *
+     * @internal
+     */
+    constructor(firstComponent) {
+        this.firstComponent = firstComponent;
+    }
+    /**
+     * Send an item into the pipeline.
+     *
+     * @param item - Packet or Frame to process
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await control.send(packet);
+     * } catch (error) {
+     *   console.error('Pipeline error:', error);
+     * }
+     * ```
+     */
+    async send(item) {
+        await this.firstComponent.sendToQueue(item);
+    }
+    /**
+     * Flush the pipeline.
+     *
+     * @example
+     * ```typescript
+     * await control.flush();
+     * ```
+     */
+    async flush() {
+        await this.firstComponent.flushPipeline();
+    }
+    /**
+     * Cleanup resources.
+     *
+     * @example
+     * ```typescript
+     * await using control;
+     * ```
+     */
+    async [Symbol.asyncDispose]() {
+        await this.flush();
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/api/utilities/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../src/api/utilities/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAapC;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACZ,cAAc,CAA8B;IAEpD,gBAAgB;IAChB,aAAa,CAA4B;IAEzC;;;;;;OAMG;IACH,YAAY,cAA2C,EAAE,aAAyC;QAChG,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,cAAc,CAAC;IACvD,CAAC;IAgED,MAAM,CAAC,MAAwD,EAAE,WAAoB;QACnF,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACpD,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;gBAC5B,0CAA0C;gBAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAC/C,kEAAkE;gBAClE,OAAO,IAAI,gBAAgB,CAAQ,IAAI,CAAC,cAAc,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1D,gEAAgE;gBAChE,OAAO,IAAI,SAAS,CAAQ,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CAAC,IAAW;QACpB,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACzB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IACnB,cAAc,CAA8B;IAEpD;;;;OAIG;IACH,YAAY,cAA2C;QACrD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CAAC,IAAW;QACpB,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACzB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}