node-av 2.0.0 → 2.4.0

package/dist/lib/bitstream-filter-context.js

@@ -154,6 +154,7 @@ export class BitStreamFilterContext extends OptionMember {
      * Direct mapping to av_bsf_alloc().
      *
      * @param filter - The bitstream filter to use
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: Memory allocation failure
      *   - AVERROR_EINVAL: Invalid filter
@@ -259,6 +260,7 @@ export class BitStreamFilterContext extends OptionMember {
      * Direct mapping to av_bsf_send_packet().
      *
      * @param packet - Packet to filter, or null to signal EOF
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Filter needs output to be consumed first
      *   - AVERROR_EOF: Filter has been flushed
@@ -288,6 +290,47 @@ export class BitStreamFilterContext extends OptionMember {
     async sendPacket(packet) {
         return await this.native.sendPacket(packet ? packet.getNative() : null);
     }
+    /**
+     * Send a packet to the bitstream filter synchronously.
+     * Synchronous version of sendPacket.
+     *
+     * Submits a packet for filtering. The filter may buffer packets
+     * internally and produce output with different timing.
+     *
+     * Direct mapping to av_bsf_send_packet().
+     *
+     * @param packet - Packet to filter (null to drain)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need to receive packets first
+     *   - AVERROR_EOF: Filter has been flushed
+     *   - AVERROR_EINVAL: Invalid state
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av/constants';
+     *
+     * // Send packet to filter
+     * const ret = ctx.sendPacketSync(inputPacket);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive output first
+     *   const outputPacket = new Packet();
+     *   ctx.receivePacketSync(outputPacket);
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'sendPacketSync');
+     * }
+     *
+     * // Drain filter
+     * ctx.sendPacketSync(null);
+     * ```
+     *
+     * @see {@link sendPacket} For async version
+     */
+    sendPacketSync(packet) {
+        return this.native.sendPacketSync(packet ? packet.getNative() : null);
+    }
     /**
      * Receive a filtered packet from the bitstream filter.
      *
@@ -297,6 +340,7 @@ export class BitStreamFilterContext extends OptionMember {
      * Direct mapping to av_bsf_receive_packet().
      *
      * @param packet - Packet to receive filtered data into
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Need more input
      *   - AVERROR_EOF: No more packets available
@@ -325,6 +369,45 @@ export class BitStreamFilterContext extends OptionMember {
     async receivePacket(packet) {
         return await this.native.receivePacket(packet.getNative());
     }
+    /**
+     * Receive a filtered packet from the bitstream filter synchronously.
+     * Synchronous version of receivePacket.
+     *
+     * Retrieves a packet that has been processed by the filter.
+     * May need to be called multiple times after each sendPacketSync().
+     *
+     * Direct mapping to av_bsf_receive_packet().
+     *
+     * @param packet - Packet to receive filtered data into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: No more packets available
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av/constants';
+     *
+     * // Receive filtered packets
+     * const outputPacket = new Packet();
+     * let ret;
+     * while ((ret = ctx.receivePacketSync(outputPacket)) >= 0) {
+     *   // Process filtered packet
+     *   console.log(`Filtered packet size: ${outputPacket.size}`);
+     *   outputPacket.unref();
+     * }
+     *
+     * if (ret !== AVERROR_EAGAIN && ret !== AVERROR_EOF) {
+     *   FFmpegError.throwIfError(ret, 'receivePacketSync');
+     * }
+     * ```
+     *
+     * @see {@link receivePacket} For async version
+     */
+    receivePacketSync(packet) {
+        return this.native.receivePacketSync(packet.getNative());
+    }
     /**
      * Get the underlying native BitStreamFilterContext object.
      *

package/dist/lib/bitstream-filter-context.js.map

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

package/dist/lib/bitstream-filter.d.ts

@@ -34,6 +34,7 @@ export declare class BitStreamFilter implements NativeWrapper<NativeBitStreamFil
     private native;
     /**
      * @param native The native bitstream filter instance
+     *
      * @internal
      */
     constructor(native: NativeBitStreamFilter);
@@ -47,6 +48,7 @@ export declare class BitStreamFilter implements NativeWrapper<NativeBitStreamFil
      * Direct mapping to av_bsf_get_by_name().
      *
      * @param name - Name of the bitstream filter
+     *
      * @returns BitStreamFilter instance if found, null otherwise
      *
      * @example

package/dist/lib/bitstream-filter.js

@@ -33,6 +33,7 @@ export class BitStreamFilter {
     native;
     /**
      * @param native The native bitstream filter instance
+     *
      * @internal
      */
     constructor(native) {
@@ -48,6 +49,7 @@ export class BitStreamFilter {
      * Direct mapping to av_bsf_get_by_name().
      *
      * @param name - Name of the bitstream filter
+     *
      * @returns BitStreamFilter instance if found, null otherwise
      *
      * @example

package/dist/lib/bitstream-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"bitstream-filter.js","sourceRoot":"","sources":["../../src/lib/bitstream-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,eAAe;IAClB,MAAM,CAAwB;IAEtC;;;OAGG;IACH,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,OAAO;QACZ,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAA6B,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAA8B,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"bitstream-filter.js","sourceRoot":"","sources":["../../src/lib/bitstream-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,eAAe;IAClB,MAAM,CAAwB;IAEtC;;;;OAIG;IACH,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,OAAO;QACZ,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAA6B,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAA8B,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/lib/codec-context.d.ts

@@ -450,7 +450,9 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_open2().
      *
      * @param codec - Codec to open with (null to use already set)
+     *
      * @param options - Codec-specific options
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -468,6 +470,35 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * @see {@link isOpen} To check if open
      */
     open2(codec?: Codec | null, options?: Dictionary | null): Promise<number>;
+    /**
+     * Open the codec synchronously.
+     * Synchronous version of open2.
+     *
+     * Initializes the codec for encoding/decoding.
+     * Must be called before processing frames/packets.
+     *
+     * Direct mapping to avcodec_open2().
+     *
+     * @param codec - Codec to open with (null to use already set)
+     *
+     * @param options - Codec-specific options
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * const ret = ctx.open2Sync(codec);
+     * FFmpegError.throwIfError(ret, 'open2Sync');
+     * // Codec is now open and ready
+     * ```
+     *
+     * @see {@link open2} For async version
+     */
+    open2Sync(codec?: Codec | null, options?: Dictionary | null): number;
     /**
      * Fill codec context from parameters.
      *
@@ -477,6 +508,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_parameters_to_context().
      *
      * @param params - Source codec parameters
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -500,6 +532,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_parameters_from_context().
      *
      * @param params - Destination codec parameters
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -539,6 +572,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_send_packet().
      *
      * @param packet - Packet to decode (null to flush)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Must receive frames first
      *   - AVERROR_EOF: Decoder has been flushed
@@ -561,6 +595,38 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * @see {@link receiveFrame} To get decoded frames
      */
     sendPacket(packet: Packet | null): Promise<number>;
+    /**
+     * Send packet to decoder synchronously.
+     * Synchronous version of sendPacket.
+     *
+     * Submits compressed data for decoding.
+     * Call receiveFrameSync() to get decoded frames.
+     *
+     * Direct mapping to avcodec_send_packet().
+     *
+     * @param packet - Packet to decode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive frames first
+     *   - AVERROR_EOF: Decoder has been flushed
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = ctx.sendPacketSync(packet);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive frames first
+     *   ctx.receiveFrameSync(frame);
+     * }
+     * ```
+     *
+     * @see {@link sendPacket} For async version
+     */
+    sendPacketSync(packet: Packet | null): number;
     /**
      * Receive decoded frame.
      *
@@ -570,6 +636,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_receive_frame().
      *
      * @param frame - Frame to receive into
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Need more input
      *   - AVERROR_EOF: All frames have been output
@@ -592,6 +659,39 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * @see {@link sendPacket} To send packets for decoding
      */
     receiveFrame(frame: Frame): Promise<number>;
+    /**
+     * Receive decoded frame synchronously.
+     * Synchronous version of receiveFrame.
+     *
+     * Gets a decoded frame from the decoder.
+     * Call after sendPacketSync().
+     *
+     * Direct mapping to avcodec_receive_frame().
+     *
+     * @param frame - Frame to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All frames have been output
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = ctx.receiveFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No frame available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receiveFrameSync');
+     *   // Process frame
+     * }
+     * ```
+     *
+     * @see {@link receiveFrame} For async version
+     */
+    receiveFrameSync(frame: Frame): number;
     /**
      * Send frame to encoder.
      *
@@ -601,6 +701,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_send_frame().
      *
      * @param frame - Frame to encode (null to flush)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Must receive packets first
      *   - AVERROR_EOF: Encoder has been flushed
@@ -623,6 +724,38 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * @see {@link receivePacket} To get encoded packets
      */
     sendFrame(frame: Frame | null): Promise<number>;
+    /**
+     * Send frame to encoder synchronously.
+     * Synchronous version of sendFrame.
+     *
+     * Submits raw frame for encoding.
+     * Call receivePacketSync() to get encoded packets.
+     *
+     * Direct mapping to avcodec_send_frame().
+     *
+     * @param frame - Frame to encode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive packets first
+     *   - AVERROR_EOF: Encoder has been flushed
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = ctx.sendFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive packets first
+     *   ctx.receivePacketSync(packet);
+     * }
+     * ```
+     *
+     * @see {@link sendFrame} For async version
+     */
+    sendFrameSync(frame: Frame | null): number;
     /**
      * Receive encoded packet.
      *
@@ -632,6 +765,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Direct mapping to avcodec_receive_packet().
      *
      * @param packet - Packet to receive into
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Need more input
      *   - AVERROR_EOF: All packets have been output
@@ -654,6 +788,39 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * @see {@link sendFrame} To send frames for encoding
      */
     receivePacket(packet: Packet): Promise<number>;
+    /**
+     * Receive encoded packet synchronously.
+     * Synchronous version of receivePacket.
+     *
+     * Gets an encoded packet from the encoder.
+     * Call after sendFrameSync().
+     *
+     * Direct mapping to avcodec_receive_packet().
+     *
+     * @param packet - Packet to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All packets have been output
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = ctx.receivePacketSync(packet);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No packet available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receivePacketSync');
+     *   // Process packet
+     * }
+     * ```
+     *
+     * @see {@link receivePacket} For async version
+     */
+    receivePacketSync(packet: Packet): number;
     /**
      * Set hardware pixel format.
      *
@@ -661,6 +828,7 @@ export declare class CodecContext extends OptionMember<NativeCodecContext> imple
      * Used in get_format callback for hardware decoding.
      *
      * @param hwFormat - Hardware pixel format
+     *
      * @param swFormat - Software pixel format (optional)
      *
      * @example

package/dist/lib/codec-context.js

@@ -637,7 +637,9 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_open2().
      *
      * @param codec - Codec to open with (null to use already set)
+     *
      * @param options - Codec-specific options
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -657,6 +659,37 @@ export class CodecContext extends OptionMember {
     async open2(codec = null, options = null) {
         return await this.native.open2(codec?.getNative() ?? null, options?.getNative() ?? null);
     }
+    /**
+     * Open the codec synchronously.
+     * Synchronous version of open2.
+     *
+     * Initializes the codec for encoding/decoding.
+     * Must be called before processing frames/packets.
+     *
+     * Direct mapping to avcodec_open2().
+     *
+     * @param codec - Codec to open with (null to use already set)
+     *
+     * @param options - Codec-specific options
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * const ret = ctx.open2Sync(codec);
+     * FFmpegError.throwIfError(ret, 'open2Sync');
+     * // Codec is now open and ready
+     * ```
+     *
+     * @see {@link open2} For async version
+     */
+    open2Sync(codec = null, options = null) {
+        return this.native.open2Sync(codec?.getNative() ?? null, options?.getNative() ?? null);
+    }
     /**
      * Fill codec context from parameters.
      *
@@ -666,6 +699,7 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_parameters_to_context().
      *
      * @param params - Source codec parameters
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -691,6 +725,7 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_parameters_from_context().
      *
      * @param params - Destination codec parameters
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -734,6 +769,7 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_send_packet().
      *
      * @param packet - Packet to decode (null to flush)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Must receive frames first
      *   - AVERROR_EOF: Decoder has been flushed
@@ -758,6 +794,40 @@ export class CodecContext extends OptionMember {
     async sendPacket(packet) {
         return await this.native.sendPacket(packet?.getNative() ?? null);
     }
+    /**
+     * Send packet to decoder synchronously.
+     * Synchronous version of sendPacket.
+     *
+     * Submits compressed data for decoding.
+     * Call receiveFrameSync() to get decoded frames.
+     *
+     * Direct mapping to avcodec_send_packet().
+     *
+     * @param packet - Packet to decode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive frames first
+     *   - AVERROR_EOF: Decoder has been flushed
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = ctx.sendPacketSync(packet);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive frames first
+     *   ctx.receiveFrameSync(frame);
+     * }
+     * ```
+     *
+     * @see {@link sendPacket} For async version
+     */
+    sendPacketSync(packet) {
+        return this.native.sendPacketSync(packet?.getNative() ?? null);
+    }
     /**
      * Receive decoded frame.
      *
@@ -767,6 +837,7 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_receive_frame().
      *
      * @param frame - Frame to receive into
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Need more input
      *   - AVERROR_EOF: All frames have been output
@@ -791,6 +862,41 @@ export class CodecContext extends OptionMember {
     async receiveFrame(frame) {
         return await this.native.receiveFrame(frame.getNative());
     }
+    /**
+     * Receive decoded frame synchronously.
+     * Synchronous version of receiveFrame.
+     *
+     * Gets a decoded frame from the decoder.
+     * Call after sendPacketSync().
+     *
+     * Direct mapping to avcodec_receive_frame().
+     *
+     * @param frame - Frame to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All frames have been output
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = ctx.receiveFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No frame available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receiveFrameSync');
+     *   // Process frame
+     * }
+     * ```
+     *
+     * @see {@link receiveFrame} For async version
+     */
+    receiveFrameSync(frame) {
+        return this.native.receiveFrameSync(frame.getNative());
+    }
     /**
      * Send frame to encoder.
      *
@@ -800,6 +906,7 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_send_frame().
      *
      * @param frame - Frame to encode (null to flush)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Must receive packets first
      *   - AVERROR_EOF: Encoder has been flushed
@@ -824,6 +931,40 @@ export class CodecContext extends OptionMember {
     async sendFrame(frame) {
         return await this.native.sendFrame(frame?.getNative() ?? null);
     }
+    /**
+     * Send frame to encoder synchronously.
+     * Synchronous version of sendFrame.
+     *
+     * Submits raw frame for encoding.
+     * Call receivePacketSync() to get encoded packets.
+     *
+     * Direct mapping to avcodec_send_frame().
+     *
+     * @param frame - Frame to encode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive packets first
+     *   - AVERROR_EOF: Encoder has been flushed
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = ctx.sendFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive packets first
+     *   ctx.receivePacketSync(packet);
+     * }
+     * ```
+     *
+     * @see {@link sendFrame} For async version
+     */
+    sendFrameSync(frame) {
+        return this.native.sendFrameSync(frame?.getNative() ?? null);
+    }
     /**
      * Receive encoded packet.
      *
@@ -833,6 +974,7 @@ export class CodecContext extends OptionMember {
      * Direct mapping to avcodec_receive_packet().
      *
      * @param packet - Packet to receive into
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Need more input
      *   - AVERROR_EOF: All packets have been output
@@ -857,6 +999,41 @@ export class CodecContext extends OptionMember {
     async receivePacket(packet) {
         return await this.native.receivePacket(packet.getNative());
     }
+    /**
+     * Receive encoded packet synchronously.
+     * Synchronous version of receivePacket.
+     *
+     * Gets an encoded packet from the encoder.
+     * Call after sendFrameSync().
+     *
+     * Direct mapping to avcodec_receive_packet().
+     *
+     * @param packet - Packet to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All packets have been output
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = ctx.receivePacketSync(packet);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No packet available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receivePacketSync');
+     *   // Process packet
+     * }
+     * ```
+     *
+     * @see {@link receivePacket} For async version
+     */
+    receivePacketSync(packet) {
+        return this.native.receivePacketSync(packet.getNative());
+    }
     /**
      * Set hardware pixel format.
      *
@@ -864,6 +1041,7 @@ export class CodecContext extends OptionMember {
      * Used in get_format callback for hardware decoding.
      *
      * @param hwFormat - Hardware pixel format
+     *
      * @param swFormat - Software pixel format (optional)
      *
      * @example