node-av 3.1.3 → 5.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.
  */
@@ -52,10 +52,15 @@ export declare class AudioSampleUtils {
      * Direct mapping to av_samples_alloc()
      *
      * @param nbChannels - Number of audio channels
+     *
      * @param nbSamples - Number of samples per channel
+     *
      * @param sampleFmt - Audio sample format
+     *
      * @param align - Buffer alignment (0 for default)
+     *
      * @returns Allocation result with buffers and size information
+     *
      * @throws {FFmpegError} On allocation failure
      *
      * @example
@@ -81,10 +86,15 @@ export declare class AudioSampleUtils {
      * Direct mapping to av_samples_get_buffer_size()
      *
      * @param nbChannels - Number of audio channels
+     *
      * @param nbSamples - Number of samples per channel
+     *
      * @param sampleFmt - Audio sample format
+     *
      * @param align - Buffer alignment (0 for default)
+     *
      * @returns Buffer size and line size information
+     *
      * @throws {FFmpegError} On invalid parameters
      *
      * @example

package/dist/api/utilities/audio-sample.js

@@ -34,10 +34,15 @@ export class AudioSampleUtils {
      * Direct mapping to av_samples_alloc()
      *
      * @param nbChannels - Number of audio channels
+     *
      * @param nbSamples - Number of samples per channel
+     *
      * @param sampleFmt - Audio sample format
+     *
      * @param align - Buffer alignment (0 for default)
+     *
      * @returns Allocation result with buffers and size information
+     *
      * @throws {FFmpegError} On allocation failure
      *
      * @example
@@ -69,10 +74,15 @@ export class AudioSampleUtils {
      * Direct mapping to av_samples_get_buffer_size()
      *
      * @param nbChannels - Number of audio channels
+     *
      * @param nbSamples - Number of samples per channel
+     *
      * @param sampleFmt - Audio sample format
+     *
      * @param align - Buffer alignment (0 for default)
+     *
      * @returns Buffer size and line size information
+     *
      * @throws {FFmpegError} On invalid parameters
      *
      * @example

package/dist/api/utilities/audio-sample.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio-sample.js","sourceRoot":"","sources":["../../../src/api/utilities/audio-sample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0BjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,KAAK,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAyB,EAAE,KAAa;QAC1F,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAChF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAA+B,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,aAAa,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAyB,EAAE,KAAa;QAClG,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACxF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAA+B,CAAC;IACzC,CAAC;CACF"}
+{"version":3,"file":"audio-sample.js","sourceRoot":"","sources":["../../../src/api/utilities/audio-sample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0BjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,CAAC,KAAK,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAyB,EAAE,KAAa;QAC1F,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAChF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAA+B,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,MAAM,CAAC,aAAa,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAyB,EAAE,KAAa;QAClG,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACxF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAA+B,CAAC;IACzC,CAAC;CACF"}

package/dist/api/utilities/channel-layout.d.ts

@@ -40,6 +40,7 @@ export declare class ChannelLayoutUtils {
      * Direct mapping to av_channel_layout_describe()
      *
      * @param channelLayout - Channel layout to describe
+     *
      * @returns String description, or null on error
      *
      * @example

package/dist/api/utilities/channel-layout.js

@@ -41,6 +41,7 @@ export class ChannelLayoutUtils {
      * Direct mapping to av_channel_layout_describe()
      *
      * @param channelLayout - Channel layout to describe
+     *
      * @returns String description, or null on error
      *
      * @example

package/dist/api/utilities/channel-layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel-layout.js","sourceRoot":"","sources":["../../../src/api/utilities/channel-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,kBAAkB;IAC7B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,MAAM,CAAC,QAAQ,CAAC,aAAqC;QACnD,OAAO,QAAQ,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC;CACF"}
+{"version":3,"file":"channel-layout.js","sourceRoot":"","sources":["../../../src/api/utilities/channel-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,kBAAkB;IAC7B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,QAAQ,CAAC,aAAqC;QACnD,OAAO,QAAQ,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC;CACF"}

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.
  */
@@ -41,10 +41,15 @@ export declare class ImageUtils {
      * Direct mapping to av_image_alloc()
      *
      * @param width - Image width in pixels
+     *
      * @param height - Image height in pixels
+     *
      * @param pixFmt - Pixel format
+     *
      * @param align - Buffer alignment (typically 1, 16, or 32)
+     *
      * @returns Allocation result with buffer, size, and line sizes
+     *
      * @throws {FFmpegError} On allocation failure
      *
      * @example
@@ -68,11 +73,26 @@ export declare class ImageUtils {
      * This is an alias for compatibility.
      *
      * @param width - Image width in pixels
+     *
      * @param height - Image height in pixels
+     *
      * @param pixFmt - Pixel format
+     *
      * @param align - Buffer alignment
+     *
      * @returns Allocation result
+     *
      * @throws {FFmpegError} On allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Allocate image buffer using allocArrays
+     * const image = ImageUtils.allocArrays(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+     * console.log(`Allocated ${image.size} bytes`);
+     * ```
      */
     static allocArrays(width: number, height: number, pixFmt: AVPixelFormat, align: number): ImageAllocation;
     /**
@@ -82,11 +102,17 @@ export declare class ImageUtils {
      * Direct mapping to av_image_copy2()
      *
      * @param dstData - Destination data buffers (one per plane)
+     *
      * @param dstLinesizes - Destination line sizes
+     *
      * @param srcData - Source data buffers (one per plane)
+     *
      * @param srcLinesizes - Source line sizes
+     *
      * @param pixFmt - Pixel format
+     *
      * @param width - Image width
+     *
      * @param height - Image height
      *
      * @example
@@ -110,9 +136,13 @@ export declare class ImageUtils {
      * Direct mapping to av_image_get_buffer_size()
      *
      * @param pixFmt - Pixel format
+     *
      * @param width - Image width
+     *
      * @param height - Image height
+     *
      * @param align - Buffer alignment
+     *
      * @returns Required buffer size in bytes
      *
      * @example
@@ -137,13 +167,21 @@ export declare class ImageUtils {
      * Direct mapping to av_image_copy_to_buffer()
      *
      * @param dst - Destination buffer
+     *
      * @param dstSize - Destination buffer size
+     *
      * @param srcData - Source data buffers (one per plane), or null
+     *
      * @param srcLinesize - Source line sizes, or null
+     *
      * @param pixFmt - Pixel format
+     *
      * @param width - Image width
+     *
      * @param height - Image height
+     *
      * @param align - Buffer alignment
+     *
      * @returns Bytes written, or negative error code
      *
      * @example

package/dist/api/utilities/image.js

@@ -32,10 +32,15 @@ export class ImageUtils {
      * Direct mapping to av_image_alloc()
      *
      * @param width - Image width in pixels
+     *
      * @param height - Image height in pixels
+     *
      * @param pixFmt - Pixel format
+     *
      * @param align - Buffer alignment (typically 1, 16, or 32)
+     *
      * @returns Allocation result with buffer, size, and line sizes
+     *
      * @throws {FFmpegError} On allocation failure
      *
      * @example
@@ -65,11 +70,26 @@ export class ImageUtils {
      * This is an alias for compatibility.
      *
      * @param width - Image width in pixels
+     *
      * @param height - Image height in pixels
+     *
      * @param pixFmt - Pixel format
+     *
      * @param align - Buffer alignment
+     *
      * @returns Allocation result
+     *
      * @throws {FFmpegError} On allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Allocate image buffer using allocArrays
+     * const image = ImageUtils.allocArrays(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+     * console.log(`Allocated ${image.size} bytes`);
+     * ```
      */
     static allocArrays(width, height, pixFmt, align) {
         return ImageUtils.alloc(width, height, pixFmt, align);
@@ -81,11 +101,17 @@ export class ImageUtils {
      * Direct mapping to av_image_copy2()
      *
      * @param dstData - Destination data buffers (one per plane)
+     *
      * @param dstLinesizes - Destination line sizes
+     *
      * @param srcData - Source data buffers (one per plane)
+     *
      * @param srcLinesizes - Source line sizes
+     *
      * @param pixFmt - Pixel format
+     *
      * @param width - Image width
+     *
      * @param height - Image height
      *
      * @example
@@ -111,9 +137,13 @@ export class ImageUtils {
      * Direct mapping to av_image_get_buffer_size()
      *
      * @param pixFmt - Pixel format
+     *
      * @param width - Image width
+     *
      * @param height - Image height
+     *
      * @param align - Buffer alignment
+     *
      * @returns Required buffer size in bytes
      *
      * @example
@@ -140,13 +170,21 @@ export class ImageUtils {
      * Direct mapping to av_image_copy_to_buffer()
      *
      * @param dst - Destination buffer
+     *
      * @param dstSize - Destination buffer size
+     *
      * @param srcData - Source data buffers (one per plane), or null
+     *
      * @param srcLinesize - Source line sizes, or null
+     *
      * @param pixFmt - Pixel format
+     *
      * @param width - Image width
+     *
      * @param height - Image height
+     *
      * @param align - Buffer alignment
+     *
      * @returns Bytes written, or negative error code
      *
      * @example

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/api/utilities/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,UAAU;IACrB,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,MAAqB,EAAE,KAAa;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,MAAyB,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,MAAqB,EAAE,KAAa;QACpF,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,IAAI,CAAC,OAAiB,EAAE,YAAsB,EAAE,OAAiB,EAAE,YAAsB,EAAE,MAAqB,EAAE,KAAa,EAAE,MAAc;QACpJ,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,aAAa,CAAC,MAAqB,EAAE,KAAa,EAAE,MAAc,EAAE,KAAa;QACtF,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,YAAY,CACjB,GAAW,EACX,OAAe,EACf,OAAwB,EACxB,WAA4B,EAC5B,MAAqB,EACrB,KAAa,EACb,MAAc,EACd,KAAa;QAEb,OAAO,QAAQ,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxG,CAAC;CACF"}
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/api/utilities/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,UAAU;IACrB,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,MAAqB,EAAE,KAAa;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,MAAyB,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,MAAqB,EAAE,KAAa;QACpF,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,MAAM,CAAC,IAAI,CAAC,OAAiB,EAAE,YAAsB,EAAE,OAAiB,EAAE,YAAsB,EAAE,MAAqB,EAAE,KAAa,EAAE,MAAc;QACpJ,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,aAAa,CAAC,MAAqB,EAAE,KAAa,EAAE,MAAc,EAAE,KAAa;QACtF,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,MAAM,CAAC,YAAY,CACjB,GAAW,EACX,OAAe,EACf,OAAwB,EACxB,WAA4B,EAC5B,MAAqB,EACrB,KAAa,EACb,MAAc,EACd,KAAa;QAEb,OAAO,QAAQ,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxG,CAAC;CACF"}

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

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

package/dist/api/utilities/index.js

@@ -14,4 +14,10 @@ export { SampleFormatUtils } from './sample-format.js';
 export { TimestampUtils } from './timestamp.js';
 // Streaming
 export { StreamingUtils } from './streaming.js';
+// Whisper Model Downloader
+export { WhisperDownloader } from './whisper-model.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,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,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.
  *
@@ -24,6 +24,7 @@ export declare class MediaTypeUtils {
      * Direct mapping to av_get_media_type_string()
      *
      * @param type - Media type enum value
+     *
      * @returns String representation, or null for invalid type
      *
      * @example

package/dist/api/utilities/media-type.js

@@ -25,6 +25,7 @@ export class MediaTypeUtils {
      * Direct mapping to av_get_media_type_string()
      *
      * @param type - Media type enum value
+     *
      * @returns String representation, or null for invalid type
      *
      * @example

package/dist/api/utilities/media-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-type.js","sourceRoot":"","sources":["../../../src/api/utilities/media-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,cAAc;IACzB,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,SAAS,CAAC,IAAiB;QAChC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"media-type.js","sourceRoot":"","sources":["../../../src/api/utilities/media-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,cAAc;IACzB,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,SAAS,CAAC,IAAiB;QAChC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

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.
  *
@@ -28,6 +28,7 @@ export declare class PixelFormatUtils {
      * Direct mapping to av_get_pix_fmt_name()
      *
      * @param format - Video pixel format
+     *
      * @returns Format name string, or null for invalid format
      *
      * @example
@@ -47,6 +48,7 @@ export declare class PixelFormatUtils {
      * Direct mapping to av_get_pix_fmt()
      *
      * @param name - Pixel format name string
+     *
      * @returns Pixel format enum value, or AV_PIX_FMT_NONE for unknown formats
      *
      * @example
@@ -70,6 +72,7 @@ export declare class PixelFormatUtils {
      * Direct mapping to av_pix_fmt_desc_get() and checking for AV_PIX_FMT_FLAG_HWACCEL
      *
      * @param format - Video pixel format
+     *
      * @returns True if format is hardware accelerated
      *
      * @example

package/dist/api/utilities/pixel-format.js

@@ -29,6 +29,7 @@ export class PixelFormatUtils {
      * Direct mapping to av_get_pix_fmt_name()
      *
      * @param format - Video pixel format
+     *
      * @returns Format name string, or null for invalid format
      *
      * @example
@@ -50,6 +51,7 @@ export class PixelFormatUtils {
      * Direct mapping to av_get_pix_fmt()
      *
      * @param name - Pixel format name string
+     *
      * @returns Pixel format enum value, or AV_PIX_FMT_NONE for unknown formats
      *
      * @example
@@ -75,6 +77,7 @@ export class PixelFormatUtils {
      * Direct mapping to av_pix_fmt_desc_get() and checking for AV_PIX_FMT_FLAG_HWACCEL
      *
      * @param format - Video pixel format
+     *
      * @returns True if format is hardware accelerated
      *
      * @example