node-av 4.0.0 → 5.0.0

package/dist/api/types.d.ts

@@ -1,8 +1,9 @@
 import type { RtpPacket } from 'werift';
-import type { AVPixelFormat, AVSampleFormat, AVSeekWhence } from '../constants/index.js';
-import type { IRational } from '../lib/index.js';
+import type { AVMediaType, AVPixelFormat, AVSampleFormat, AVSeekWhence } from '../constants/index.js';
+import type { IRational } from '../lib/types.js';
 import type { Decoder } from './decoder.js';
 import type { Demuxer } from './demuxer.js';
+import type { FilterComplexAPI } from './filter-complex.js';
 import type { FilterAPI } from './filter.js';
 import type { HardwareContext } from './hardware.js';
 /**
@@ -96,7 +97,7 @@ export type RawData = VideoRawData | AudioRawData;
  * Configures how media files are opened and packets are read.
  * Supports format detection, buffering, and FFmpeg options.
  */
-export interface MediaInputOptions {
+export interface DemuxerOptions {
     /**
      * Buffer size for reading/writing operations.
      *
@@ -179,7 +180,7 @@ export interface MediaInputOptions {
  *
  * Configures output container format and buffering.
  */
-export interface MediaOutputOptions {
+export interface MuxerOptions {
     /**
      * Input media for automatic metadata and property copying.
      *
@@ -191,7 +192,7 @@ export interface MediaOutputOptions {
      *
      * This matches FFmpeg CLI behavior which copies metadata by default.
      */
-    input?: Demuxer | RTPMediaInput;
+    input?: Demuxer | RTPDemuxer;
     /**
      * Preferred output format.
      *
@@ -473,7 +474,7 @@ export interface EncoderOptions {
      * Used to extract filter output parameters.
      * Ensures encoder matches filter output characteristics.
      */
-    filter?: FilterAPI;
+    filter?: FilterAPI | FilterComplexAPI;
     /**
      * Additional codec-specific options.
      *
@@ -569,6 +570,58 @@ export interface FilterOptions {
      */
     allowReinit?: boolean;
 }
+/**
+ * Input configuration for FilterComplexAPI.
+ */
+export interface FilterComplexInput {
+    /**
+     * Input label identifier.
+     *
+     * Matches labels in filter_complex description (e.g., '0:v', '1:v', '0:a').
+     * Used to identify which buffersrc filter to send frames to via process() method.
+     */
+    label: string;
+}
+/**
+ * Output configuration for FilterComplexAPI.
+ */
+export interface FilterComplexOutput {
+    /**
+     * Output label identifier.
+     *
+     * Matches labels in filter_complex description (e.g., 'out', 'thumb', 'main').
+     * Used to identify which buffersink to read from via output() method.
+     */
+    label: string;
+    /**
+     * Media type for this output.
+     *
+     * If not specified, defaults to the media type of the first input.
+     * Set to 'AVMEDIA_TYPE_VIDEO' or 'AVMEDIA_TYPE_AUDIO' explicitly if needed (e.g., for audio extraction filters).
+     *
+     * @default Inferred from first input
+     */
+    mediaType?: AVMediaType;
+}
+/**
+ * Options for creating a complex filter graph.
+ */
+export interface FilterComplexOptions extends FilterOptions {
+    /**
+     * Input sources for the filter graph.
+     *
+     * Array of labeled frame sources that feed into the filter graph.
+     * Labels must match those referenced in the description string.
+     */
+    inputs: FilterComplexInput[];
+    /**
+     * Output labels from the filter graph.
+     *
+     * Array of output identifiers that can be consumed via output() method.
+     * Labels must match those defined in the description string.
+     */
+    outputs: FilterComplexOutput[];
+}
 /**
  * Hardware acceleration configuration options.
  *
@@ -648,7 +701,10 @@ export interface IOOutputCallbacks {
      */
     read?: (size: number) => Buffer | null | number;
 }
-export interface RTPMediaInput {
+/**
+ * RTP Demuxer interface.
+ */
+export interface RTPDemuxer {
     /**
      * Demuxer configured for RTP/SRTP reception.
      *

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

@@ -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

@@ -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,5 +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,6 +14,8 @@ 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

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;AAEhD,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,YAAY;AACZ,OAAO,EAAE,SAAS,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

@@ -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

@@ -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

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

@@ -1 +1 @@
-{"version":3,"file":"pixel-format.js","sourceRoot":"","sources":["../../../src/api/utilities/pixel-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,OAAO,CAAC,MAAqB;QAClC,OAAO,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,UAAU,CAAC,MAAqB;QACrC,OAAO,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;CACF"}
+{"version":3,"file":"pixel-format.js","sourceRoot":"","sources":["../../../src/api/utilities/pixel-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,OAAO,CAAC,MAAqB;QAClC,OAAO,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,UAAU,CAAC,MAAqB;QACrC,OAAO,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;CACF"}

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

@@ -30,6 +30,7 @@ export declare class SampleFormatUtils {
      * Direct mapping to av_get_bytes_per_sample()
      *
      * @param format - Audio sample format
+     *
      * @returns Number of bytes per sample, or 0 for invalid format
      *
      * @example
@@ -49,6 +50,7 @@ export declare class SampleFormatUtils {
      * Direct mapping to av_get_sample_fmt_name()
      *
      * @param format - Audio sample format
+     *
      * @returns Format name string, or null for invalid format
      *
      * @example
@@ -69,6 +71,7 @@ export declare class SampleFormatUtils {
      * Direct mapping to av_get_packed_sample_fmt()
      *
      * @param format - Audio sample format
+     *
      * @returns Packed sample format
      *
      * @example
@@ -89,6 +92,7 @@ export declare class SampleFormatUtils {
      * Direct mapping to av_get_planar_sample_fmt()
      *
      * @param format - Audio sample format
+     *
      * @returns Planar sample format
      *
      * @example
@@ -109,6 +113,7 @@ export declare class SampleFormatUtils {
      * Direct mapping to av_sample_fmt_is_planar()
      *
      * @param format - Audio sample format
+     *
      * @returns True if format is planar, false if packed/interleaved
      *
      * @example

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

@@ -31,6 +31,7 @@ export class SampleFormatUtils {
      * Direct mapping to av_get_bytes_per_sample()
      *
      * @param format - Audio sample format
+     *
      * @returns Number of bytes per sample, or 0 for invalid format
      *
      * @example
@@ -52,6 +53,7 @@ export class SampleFormatUtils {
      * Direct mapping to av_get_sample_fmt_name()
      *
      * @param format - Audio sample format
+     *
      * @returns Format name string, or null for invalid format
      *
      * @example
@@ -74,6 +76,7 @@ export class SampleFormatUtils {
      * Direct mapping to av_get_packed_sample_fmt()
      *
      * @param format - Audio sample format
+     *
      * @returns Packed sample format
      *
      * @example
@@ -96,6 +99,7 @@ export class SampleFormatUtils {
      * Direct mapping to av_get_planar_sample_fmt()
      *
      * @param format - Audio sample format
+     *
      * @returns Planar sample format
      *
      * @example
@@ -118,6 +122,7 @@ export class SampleFormatUtils {
      * Direct mapping to av_sample_fmt_is_planar()
      *
      * @param format - Audio sample format
+     *
      * @returns True if format is planar, false if packed/interleaved
      *
      * @example

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

@@ -1 +1 @@
-{"version":3,"file":"sample-format.js","sourceRoot":"","sources":["../../../src/api/utilities/sample-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,iBAAiB;IAC5B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAsB;QAC7C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,OAAO,CAAC,MAAsB;QACnC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,eAAe,CAAC,MAAsB;QAC3C,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,eAAe,CAAC,MAAsB;QAC3C,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAsB;QACpC,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;CACF"}
+{"version":3,"file":"sample-format.js","sourceRoot":"","sources":["../../../src/api/utilities/sample-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,iBAAiB;IAC5B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAsB;QAC7C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,OAAO,CAAC,MAAsB;QACnC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,eAAe,CAAC,MAAsB;QAC3C,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,eAAe,CAAC,MAAsB;QAC3C,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAsB;QACpC,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;CACF"}