node-av 0.0.1

package/dist/lib/stream.js

@@ -0,0 +1,408 @@
+import { CodecParameters } from './codec-parameters.js';
+import { Dictionary } from './dictionary.js';
+import { Rational } from './rational.js';
+/**
+ * Stream information within a media container.
+ *
+ * Represents a single stream (video, audio, subtitle, etc.) within a media file.
+ * Streams are created and managed by FormatContext and contain all the metadata
+ * and parameters needed to decode or encode the stream. Each stream has its own
+ * timebase, codec parameters, and metadata.
+ *
+ * Direct mapping to FFmpeg's AVStream.
+ *
+ * @example
+ * ```typescript
+ * import { FormatContext, FFmpegError } from 'node-av';
+ * import { AVMEDIA_TYPE_VIDEO, AVMEDIA_TYPE_AUDIO } from 'node-av/constants';
+ *
+ * // Streams are obtained from FormatContext
+ * const formatContext = new FormatContext();
+ * const ret = await formatContext.openInput('video.mp4', null, null);
+ * FFmpegError.throwIfError(ret, 'openInput');
+ *
+ * const infoRet = await formatContext.findStreamInfo(null);
+ * FFmpegError.throwIfError(infoRet, 'findStreamInfo');
+ *
+ * // Access streams
+ * const streams = formatContext.streams;
+ * for (const stream of streams) {
+ *   console.log(`Stream ${stream.index}: ${stream.codecpar.codecType}`);
+ *   console.log(`Time base: ${stream.timeBase.num}/${stream.timeBase.den}`);
+ *
+ *   // Direct access to codec parameters
+ *   const codecpar = stream.codecpar;
+ *   if (codecpar.codecType === AVMEDIA_TYPE_VIDEO) {
+ *     console.log(`Video: ${codecpar.width}x${codecpar.height}`);
+ *   } else if (codecpar.codecType === AVMEDIA_TYPE_AUDIO) {
+ *     console.log(`Audio: ${codecpar.sampleRate}Hz ${codecpar.channels} channels`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link FormatContext} For creating and managing streams
+ * @see {@link CodecParameters} For codec-specific stream parameters
+ */
+export class Stream {
+    native;
+    _codecpar; // Cache the wrapped codecpar
+    /**
+     * Constructor is internal - use FormatContext to create streams.
+     *
+     * Streams are created and managed by FormatContext.
+     * For demuxing, streams are created automatically when opening input.
+     * For muxing, use formatContext.newStream() to create streams.
+     *
+     * @internal
+     *
+     * @param native - Native AVStream to wrap
+     *
+     * @example
+     * ```typescript
+     * // Don't create streams directly
+     * // const stream = new Stream(); // Wrong
+     *
+     * // For demuxing: streams are created automatically
+     * const streams = formatContext.streams; // Correct
+     *
+     * // For muxing: use newStream
+     * const stream = formatContext.newStream(null); // Correct
+     * ```
+     */
+    constructor(native) {
+        this.native = native;
+    }
+    /**
+     * Stream index in the format context.
+     *
+     * Zero-based index of this stream in the format context's stream array.
+     * This is the index used to identify the stream in packets.
+     *
+     * Direct mapping to AVStream->index
+     *
+     * @readonly
+     *
+     * @example
+     * ```typescript
+     * // Find video stream index
+     * const videoStreamIndex = streams.findIndex(
+     *   s => s.codecpar.codecType === AVMEDIA_TYPE_VIDEO
+     * );
+     *
+     * // Check packet's stream
+     * if (packet.streamIndex === videoStreamIndex) {
+     *   // This packet belongs to the video stream
+     * }
+     * ```
+     */
+    get index() {
+        return this.native.index;
+    }
+    /**
+     * Format-specific stream ID.
+     *
+     * Stream ID as defined by the container format.
+     * Different from index - this is format-specific.
+     *
+     * Direct mapping to AVStream->id
+     *
+     * - decoding: Set by libavformat
+     * - encoding: Set by the user, replaced by libavformat if left unset
+     */
+    get id() {
+        return this.native.id;
+    }
+    set id(value) {
+        this.native.id = value;
+    }
+    /**
+     * Codec parameters associated with this stream.
+     *
+     * Contains all the parameters needed to set up a codec for this stream,
+     * including codec ID, dimensions for video, sample rate for audio, etc.
+     *
+     * Direct mapping to AVStream->codecpar
+     *
+     * - demuxing: Filled by libavformat on stream creation or in findStreamInfo()
+     * - muxing: Must be filled by the caller before writeHeader()
+     *
+     * @example
+     * ```typescript
+     * // For video stream
+     * stream.codecpar.codecType = AVMEDIA_TYPE_VIDEO;
+     * stream.codecpar.codecId = AV_CODEC_ID_H264;
+     * stream.codecpar.width = 1920;
+     * stream.codecpar.height = 1080;
+     *
+     * // For audio stream
+     * stream.codecpar.codecType = AVMEDIA_TYPE_AUDIO;
+     * stream.codecpar.codecId = AV_CODEC_ID_AAC;
+     * stream.codecpar.sampleRate = 48000;
+     * stream.codecpar.channels = 2;
+     * ```
+     *
+     * @see {@link CodecParameters} For detailed parameter documentation
+     */
+    get codecpar() {
+        // Return cached wrapper if we already have one
+        if (this._codecpar) {
+            return this._codecpar;
+        }
+        // Create and cache the wrapper
+        const params = Object.create(CodecParameters.prototype);
+        params.native = this.native.codecpar;
+        this._codecpar = params;
+        return params;
+    }
+    set codecpar(value) {
+        // Copy codec parameters to the stream
+        // The native binding handles the copying
+        this.native.codecpar = value.getNative();
+        // Clear the cache as the underlying parameters have changed
+        this._codecpar = undefined;
+    }
+    /**
+     * Time base for this stream.
+     *
+     * The fundamental unit of time (in seconds) in terms of which frame
+     * timestamps are represented. For example, a time base of 1/25 means
+     * each time unit is 1/25 of a second (40ms).
+     *
+     * Direct mapping to AVStream->time_base
+     *
+     * - decoding: Set by libavformat
+     * - encoding: May be set before writeHeader() as a hint to the muxer.
+     *             The muxer will overwrite with the actual timebase used.
+     *
+     * @example
+     * ```typescript
+     * import { Rational } from 'node-av';
+     *
+     * // Common time bases
+     * stream.timeBase = new Rational(1, 90000); // 90kHz (MPEG-TS)
+     * stream.timeBase = new Rational(1, 1000); // milliseconds
+     * stream.timeBase = new Rational(1, 25); // 25 fps video
+     *
+     * // Convert PTS to seconds
+     * const pts = 45000n;
+     * const seconds = Number(pts) * stream.timeBase.toDouble();
+     * ```
+     *
+     * @see {@link Rational} For time base representation
+     */
+    get timeBase() {
+        const tb = this.native.timeBase;
+        return new Rational(tb.num, tb.den);
+    }
+    set timeBase(value) {
+        this.native.timeBase = { num: value.num, den: value.den };
+    }
+    /**
+     * Decoding: pts of the first frame of the stream in presentation order, in stream time base.
+     *
+     * Direct mapping to AVStream->start_time
+     *
+     * Only set this if you are absolutely 100% sure that the value you set
+     * it to really is the pts of the first frame.
+     * This may be undefined (AV_NOPTS_VALUE).
+     *
+     * @note The ASF header does NOT contain a correct start_time the ASF
+     * demuxer must NOT set this.
+     */
+    get startTime() {
+        return this.native.startTime;
+    }
+    set startTime(value) {
+        this.native.startTime = value;
+    }
+    /**
+     * Decoding: duration of the stream, in stream time base.
+     *
+     * Direct mapping to AVStream->duration
+     *
+     * If a source file does not specify a duration, but does specify
+     * a bitrate, this value will be estimated from bitrate and file size.
+     *
+     * Encoding: May be set by the caller before avformat_write_header() to
+     * provide a hint to the muxer about the estimated duration.
+     */
+    get duration() {
+        return this.native.duration;
+    }
+    set duration(value) {
+        this.native.duration = value;
+    }
+    /**
+     * Number of frames in this stream if known or 0.
+     *
+     * Direct mapping to AVStream->nb_frames
+     */
+    get nbFrames() {
+        return this.native.nbFrames;
+    }
+    set nbFrames(value) {
+        this.native.nbFrames = value;
+    }
+    /**
+     * Stream disposition - a combination of AV_DISPOSITION_* flags.
+     *
+     * Direct mapping to AVStream->disposition
+     *
+     * - demuxing: set by libavformat when creating the stream or in
+     *             avformat_find_stream_info().
+     * - muxing: may be set by the caller before avformat_write_header().
+     *
+     * Common flags:
+     * - AV_DISPOSITION_DEFAULT: default track
+     * - AV_DISPOSITION_ATTACHED_PIC: stream is an attached picture (album art)
+     * - AV_DISPOSITION_CAPTIONS: stream contains captions
+     * - AV_DISPOSITION_DESCRIPTIONS: stream contains descriptions
+     * - AV_DISPOSITION_METADATA: stream contains metadata
+     */
+    get disposition() {
+        return this.native.disposition;
+    }
+    set disposition(value) {
+        this.native.disposition = value;
+    }
+    /**
+     * Selects which packets can be discarded at will and do not need to be demuxed.
+     *
+     * Direct mapping to AVStream->discard
+     *
+     * - AVDISCARD_NONE: discard nothing
+     * - AVDISCARD_DEFAULT: discard useless packets like 0 size packets in avi
+     * - AVDISCARD_NONREF: discard all non reference
+     * - AVDISCARD_BIDIR: discard all bidirectional frames
+     * - AVDISCARD_NONINTRA: discard all non intra frames
+     * - AVDISCARD_NONKEY: discard all frames except keyframes
+     * - AVDISCARD_ALL: discard all
+     */
+    get discard() {
+        return this.native.discard;
+    }
+    set discard(value) {
+        this.native.discard = value;
+    }
+    /**
+     * Sample aspect ratio (0 if unknown).
+     *
+     * Direct mapping to AVStream->sample_aspect_ratio
+     *
+     * This is the width of a pixel divided by the height of the pixel.
+     * - encoding: Set by user.
+     * - decoding: Set by libavformat.
+     */
+    get sampleAspectRatio() {
+        const sar = this.native.sampleAspectRatio;
+        return new Rational(sar.num || 0, sar.den || 1);
+    }
+    set sampleAspectRatio(value) {
+        this.native.sampleAspectRatio = { num: value.num, den: value.den };
+    }
+    /**
+     * Average framerate.
+     *
+     * Direct mapping to AVStream->avg_frame_rate
+     *
+     * - demuxing: May be set by libavformat when creating the stream or in
+     *             avformat_find_stream_info().
+     * - muxing: May be set by the caller before avformat_write_header().
+     */
+    get avgFrameRate() {
+        const fr = this.native.avgFrameRate;
+        // Handle 0/0 case (unknown frame rate in FFmpeg)
+        if (fr.den === 0) {
+            return new Rational(0, 1);
+        }
+        return new Rational(fr.num, fr.den);
+    }
+    set avgFrameRate(value) {
+        this.native.avgFrameRate = { num: value.num, den: value.den };
+    }
+    /**
+     * Real base framerate of the stream.
+     *
+     * Direct mapping to AVStream->r_frame_rate
+     *
+     * This is the lowest framerate with which all timestamps can be
+     * represented accurately (it is the least common multiple of all
+     * framerates in the stream). Note, this value is just a guess!
+     * For example, if the time base is 1/90000 and all frames have either
+     * approximately 3600 or 1800 timer ticks, then r_frame_rate will be 50/1.
+     */
+    get rFrameRate() {
+        const fr = this.native.rFrameRate;
+        // Handle 0/0 case (unknown frame rate in FFmpeg)
+        if (fr.den === 0) {
+            return new Rational(0, 1);
+        }
+        return new Rational(fr.num, fr.den);
+    }
+    set rFrameRate(value) {
+        this.native.rFrameRate = { num: value.num, den: value.den };
+    }
+    /**
+     * Metadata dictionary for this stream.
+     *
+     * Direct mapping to AVStream->metadata
+     *
+     * Contains key-value pairs of metadata.
+     */
+    get metadata() {
+        const nativeDict = this.native.metadata;
+        if (!nativeDict) {
+            return null;
+        }
+        return Dictionary.fromNative(nativeDict);
+    }
+    set metadata(value) {
+        this.native.metadata = value?.getNative() ?? null;
+    }
+    /**
+     * For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet
+     * will contain the attached picture (e.g., album art).
+     *
+     * Direct mapping to AVStream->attached_pic
+     *
+     * - decoding: set by libavformat, must not be modified by the caller.
+     * - encoding: unused
+     * @readonly
+     */
+    get attachedPic() {
+        return this.native.attachedPic;
+    }
+    /**
+     * Flags indicating events happening on the stream, a combination of
+     * AVSTREAM_EVENT_FLAG_*.
+     *
+     * Direct mapping to AVStream->event_flags
+     *
+     * - demuxing: may be set by the demuxer in avformat_open_input(),
+     *   avformat_find_stream_info() and av_read_frame(). Flags must be cleared
+     *   by the user once the event has been handled.
+     * - muxing: may be set by the user after avformat_write_header() to
+     *   indicate a user-triggered event. The muxer will clear the flags for
+     *   events it has handled in av_[interleaved]_write_frame().
+     *
+     * Flags:
+     * - AVSTREAM_EVENT_FLAG_METADATA_UPDATED: metadata was updated
+     * - AVSTREAM_EVENT_FLAG_NEW_PACKETS: new packets were read for this stream
+     */
+    get eventFlags() {
+        return this.native.eventFlags;
+    }
+    set eventFlags(value) {
+        this.native.eventFlags = value;
+    }
+    /**
+     * Get the native FFmpeg AVStream pointer.
+     *
+     * @internal For use by other wrapper classes
+     * @returns The underlying native stream object
+     */
+    getNative() {
+        return this.native;
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/lib/stream.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Common TypeScript type definitions
+ *
+ * Types that are used across multiple modules but are not
+ * directly from FFmpeg constants.
+ */
+import type { AVLogLevel, AVMediaType } from './constants.ts';
+/**
+ * Rational number (fraction) interface
+ * Maps to AVRational in FFmpeg
+ * Used for time bases, aspect ratios, frame rates
+ */
+export interface IRational {
+    /** Numerator */
+    num: number;
+    /** Denominator */
+    den: number;
+}
+/**
+ * Audio channel layout description
+ * Maps to AVChannelLayout in FFmpeg
+ */
+export interface ChannelLayout {
+    /** Number of channels */
+    nbChannels: number;
+    /** Channel order (AVChannelOrder) */
+    order: number;
+    /** Channel mask for native layouts */
+    mask: bigint;
+}
+/**
+ * Filter pad information
+ */
+export interface FilterPad {
+    /** Name of the pad (e.g., "in", "out") */
+    name: string | null;
+    /** Media type of the pad (e.g., "video", "audio") */
+    type: AVMediaType;
+}
+/**
+ * Codec profile definition
+ */
+export interface CodecProfile {
+    /** Profile ID (FF_PROFILE_*) */
+    profile: number;
+    /** Human-readable profile name */
+    name?: string;
+}
+/**
+ * Log callback options for performance tuning.
+ */
+export interface LogOptions {
+    /**
+     * Maximum log level to capture.
+     * Messages above this level are ignored at the C level for maximum performance.
+     * Default: AV_LOG_INFO
+     */
+    maxLevel?: AVLogLevel;
+}

package/dist/lib/types.js

@@ -0,0 +1,8 @@
+/**
+ * Common TypeScript type definitions
+ *
+ * Types that are used across multiple modules but are not
+ * directly from FFmpeg constants.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}