@agentdance/node-webrtc-rtp 1.0.0

package/dist/rtcp/index.js

@@ -0,0 +1,145 @@
+/**
+ * RTCP compound packet dispatch — RFC 3550 Section 6.1
+ *
+ * Compound RTCP packets are multiple RTCP packets concatenated together
+ * in a single UDP datagram.
+ */
+import { RtcpPacketType } from '../types.js';
+import { encodeSr, decodeSr } from './sr.js';
+import { encodeRr, decodeRr } from './rr.js';
+import { encodeSdes, decodeSdes } from './sdes.js';
+import { encodeBye, decodeBye } from './bye.js';
+import { encodeNack, decodeNack, encodePli, decodePli, encodeFir, decodeFir, encodeRemb, decodeRemb, } from './fb.js';
+/**
+ * Returns true if the buffer looks like an RTCP packet:
+ *   - version == 2
+ *   - payload type in 200–207
+ *   - at least 4 bytes
+ */
+export function isRtcpPacket(buf) {
+    if (buf.length < 4)
+        return false;
+    const byte0 = buf[0];
+    if (byte0 === undefined)
+        return false;
+    const version = (byte0 >> 6) & 0x03;
+    if (version !== 2)
+        return false;
+    const byte1 = buf[1];
+    if (byte1 === undefined)
+        return false;
+    // RTCP PT is the full second byte value (200–207)
+    return byte1 >= 200 && byte1 <= 207;
+}
+/**
+ * Decode a (possibly compound) RTCP buffer into an array of RtcpPacket objects.
+ */
+export function decodeRtcp(buf) {
+    const packets = [];
+    let offset = 0;
+    while (offset < buf.length) {
+        if (offset + 4 > buf.length)
+            break;
+        const byte0 = buf[offset];
+        const byte1 = buf[offset + 1];
+        const lengthWords = buf.readUInt16BE(offset + 2);
+        const packetByteLen = (lengthWords + 1) * 4;
+        if (offset + packetByteLen > buf.length) {
+            // Truncated — take what we have
+            break;
+        }
+        const packetBuf = buf.subarray(offset, offset + packetByteLen);
+        offset += packetByteLen;
+        const pt = byte1; // RTCP PT occupies the full second byte (no marker bit)
+        const fmt = byte0 & 0x1f; // lower 5 bits (also RC / SC / FMT)
+        try {
+            if (pt === RtcpPacketType.SR) {
+                packets.push({ type: 'sr', packet: decodeSr(packetBuf) });
+            }
+            else if (pt === RtcpPacketType.RR) {
+                packets.push({ type: 'rr', packet: decodeRr(packetBuf) });
+            }
+            else if (pt === RtcpPacketType.SDES) {
+                packets.push({ type: 'sdes', packet: decodeSdes(packetBuf) });
+            }
+            else if (pt === RtcpPacketType.BYE) {
+                packets.push({ type: 'bye', packet: decodeBye(packetBuf) });
+            }
+            else if (pt === RtcpPacketType.TransportFeedback) {
+                // FMT=1: NACK
+                if (fmt === 1) {
+                    packets.push({ type: 'nack', packet: decodeNack(packetBuf) });
+                }
+                else {
+                    packets.push({ type: 'unknown', raw: Buffer.from(packetBuf) });
+                }
+            }
+            else if (pt === RtcpPacketType.PayloadFeedback) {
+                if (fmt === 1) {
+                    packets.push({ type: 'pli', packet: decodePli(packetBuf) });
+                }
+                else if (fmt === 4) {
+                    packets.push({ type: 'fir', packet: decodeFir(packetBuf) });
+                }
+                else if (fmt === 15) {
+                    // Could be REMB — check unique identifier
+                    if (packetBuf.length >= 16 && packetBuf.subarray(12, 16).toString('ascii') === 'REMB') {
+                        packets.push({ type: 'remb', packet: decodeRemb(packetBuf) });
+                    }
+                    else {
+                        packets.push({ type: 'unknown', raw: Buffer.from(packetBuf) });
+                    }
+                }
+                else {
+                    packets.push({ type: 'unknown', raw: Buffer.from(packetBuf) });
+                }
+            }
+            else {
+                packets.push({ type: 'unknown', raw: Buffer.from(packetBuf) });
+            }
+        }
+        catch {
+            packets.push({ type: 'unknown', raw: Buffer.from(packetBuf) });
+        }
+    }
+    return packets;
+}
+/**
+ * Encode an array of RtcpPacket objects into a compound RTCP buffer.
+ */
+export function encodeRtcp(packets) {
+    const parts = [];
+    for (const pkt of packets) {
+        switch (pkt.type) {
+            case 'sr':
+                parts.push(encodeSr(pkt.packet));
+                break;
+            case 'rr':
+                parts.push(encodeRr(pkt.packet));
+                break;
+            case 'sdes':
+                parts.push(encodeSdes(pkt.packet));
+                break;
+            case 'bye':
+                parts.push(encodeBye(pkt.packet));
+                break;
+            case 'nack':
+                parts.push(encodeNack(pkt.packet));
+                break;
+            case 'pli':
+                parts.push(encodePli(pkt.packet));
+                break;
+            case 'fir':
+                parts.push(encodeFir(pkt.packet));
+                break;
+            case 'remb':
+                parts.push(encodeRemb(pkt.packet));
+                break;
+            case 'unknown':
+                parts.push(pkt.raw);
+                break;
+        }
+    }
+    return Buffer.concat(parts);
+}
+//# sourceMappingURL=index.js.map

package/dist/rtcp/index.js.map

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

package/dist/rtcp/rr.d.ts

@@ -0,0 +1,12 @@
+/**
+ * RTCP Receiver Report (RR) — RFC 3550 Section 6.4.2
+ * Also provides shared ReportBlock encode/decode helpers.
+ */
+import type { RtcpReceiverReport, ReportBlock } from '../types.js';
+/** Each report block is exactly 24 bytes (6 x 32-bit words) */
+export declare const REPORT_BLOCK_SIZE = 24;
+export declare function encodeReportBlock(rb: ReportBlock, buf: Buffer, offset: number): void;
+export declare function decodeReportBlock(buf: Buffer, offset: number): ReportBlock;
+export declare function encodeRr(rr: RtcpReceiverReport): Buffer;
+export declare function decodeRr(buf: Buffer): RtcpReceiverReport;
+//# sourceMappingURL=rr.d.ts.map

package/dist/rtcp/rr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rr.d.ts","sourceRoot":"","sources":["../../src/rtcp/rr.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnE,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAKpC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAWpF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAiB1E;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,kBAAkB,GAAG,MAAM,CAiBvD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAiBxD"}

package/dist/rtcp/rr.js

@@ -0,0 +1,65 @@
+/**
+ * RTCP Receiver Report (RR) — RFC 3550 Section 6.4.2
+ * Also provides shared ReportBlock encode/decode helpers.
+ */
+/** Each report block is exactly 24 bytes (6 x 32-bit words) */
+export const REPORT_BLOCK_SIZE = 24;
+/** RR base size: 4 (common hdr) + 4 (SSRC) */
+const RR_BASE_SIZE = 8;
+export function encodeReportBlock(rb, buf, offset) {
+    buf.writeUInt32BE(rb.ssrc >>> 0, offset);
+    // fractionLost (8 bits) | cumulativeLost (24 bits, two's complement)
+    const cumLost = rb.cumulativeLost & 0xffffff;
+    buf.writeUInt32BE(((rb.fractionLost & 0xff) << 24) | cumLost, offset + 4);
+    buf.writeUInt32BE(rb.extendedHighestSeq >>> 0, offset + 8);
+    buf.writeUInt32BE(rb.jitter >>> 0, offset + 12);
+    buf.writeUInt32BE(rb.lastSR >>> 0, offset + 16);
+    buf.writeUInt32BE(rb.delaySinceLastSR >>> 0, offset + 20);
+}
+export function decodeReportBlock(buf, offset) {
+    const ssrc = buf.readUInt32BE(offset);
+    const word2 = buf.readUInt32BE(offset + 4);
+    const fractionLost = (word2 >>> 24) & 0xff;
+    // cumulativeLost is 24-bit signed
+    let cumulativeLost = word2 & 0xffffff;
+    if (cumulativeLost & 0x800000) {
+        cumulativeLost = cumulativeLost - 0x1000000; // sign extend
+    }
+    const extendedHighestSeq = buf.readUInt32BE(offset + 8);
+    const jitter = buf.readUInt32BE(offset + 12);
+    const lastSR = buf.readUInt32BE(offset + 16);
+    const delaySinceLastSR = buf.readUInt32BE(offset + 20);
+    return { ssrc, fractionLost, cumulativeLost, extendedHighestSeq, jitter, lastSR, delaySinceLastSR };
+}
+export function encodeRr(rr) {
+    const blockCount = rr.reportBlocks.length;
+    const totalBytes = RR_BASE_SIZE + blockCount * REPORT_BLOCK_SIZE;
+    const buf = Buffer.allocUnsafe(totalBytes);
+    buf[0] = (2 << 6) | (blockCount & 0x1f);
+    buf[1] = 201;
+    buf.writeUInt16BE(totalBytes / 4 - 1, 2);
+    buf.writeUInt32BE(rr.ssrc >>> 0, 4);
+    let offset = RR_BASE_SIZE;
+    for (const rb of rr.reportBlocks) {
+        encodeReportBlock(rb, buf, offset);
+        offset += REPORT_BLOCK_SIZE;
+    }
+    return buf;
+}
+export function decodeRr(buf) {
+    if (buf.length < RR_BASE_SIZE) {
+        throw new RangeError(`RR packet too short: ${buf.length}`);
+    }
+    const rc = (buf[0] & 0x1f);
+    const ssrc = buf.readUInt32BE(4);
+    const reportBlocks = [];
+    let offset = RR_BASE_SIZE;
+    for (let i = 0; i < rc; i++) {
+        if (offset + REPORT_BLOCK_SIZE > buf.length)
+            break;
+        reportBlocks.push(decodeReportBlock(buf, offset));
+        offset += REPORT_BLOCK_SIZE;
+    }
+    return { ssrc, reportBlocks };
+}
+//# sourceMappingURL=rr.js.map

package/dist/rtcp/rr.js.map

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

package/dist/rtcp/sdes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * RTCP SDES (Source Description) — RFC 3550 Section 6.5
+ */
+import type { RtcpSdes } from '../types.js';
+export declare function encodeSdes(sdes: RtcpSdes): Buffer;
+export declare function decodeSdes(buf: Buffer): RtcpSdes;
+//# sourceMappingURL=sdes.d.ts.map

package/dist/rtcp/sdes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdes.d.ts","sourceRoot":"","sources":["../../src/rtcp/sdes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAuB,MAAM,aAAa,CAAC;AAKjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAwCjD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CA0ChD"}

package/dist/rtcp/sdes.js

@@ -0,0 +1,76 @@
+/**
+ * RTCP SDES (Source Description) — RFC 3550 Section 6.5
+ */
+/** SDES base header: 4 bytes (common header) */
+const SDES_HEADER_SIZE = 4;
+export function encodeSdes(sdes) {
+    const chunkBuffers = [];
+    for (const chunk of sdes.chunks) {
+        const itemParts = [];
+        // SSRC (4 bytes)
+        const ssrcBuf = Buffer.allocUnsafe(4);
+        ssrcBuf.writeUInt32BE(chunk.ssrc >>> 0, 0);
+        itemParts.push(ssrcBuf);
+        for (const item of chunk.items) {
+            const textBuf = Buffer.from(item.text, 'utf8');
+            const itemBuf = Buffer.allocUnsafe(2 + textBuf.length);
+            itemBuf[0] = item.type & 0xff;
+            itemBuf[1] = textBuf.length & 0xff;
+            textBuf.copy(itemBuf, 2);
+            itemParts.push(itemBuf);
+        }
+        // END item (type=0)
+        itemParts.push(Buffer.from([0x00]));
+        // Concatenate and pad to 4-byte boundary
+        const chunkBody = Buffer.concat(itemParts);
+        const padLen = (4 - (chunkBody.length % 4)) % 4;
+        const padding = Buffer.alloc(padLen, 0x00);
+        chunkBuffers.push(Buffer.concat([chunkBody, padding]));
+    }
+    const body = Buffer.concat(chunkBuffers);
+    const totalBytes = SDES_HEADER_SIZE + body.length;
+    const header = Buffer.allocUnsafe(SDES_HEADER_SIZE);
+    const sc = sdes.chunks.length;
+    header[0] = (2 << 6) | (sc & 0x1f);
+    header[1] = 202;
+    header.writeUInt16BE(totalBytes / 4 - 1, 2);
+    return Buffer.concat([header, body]);
+}
+export function decodeSdes(buf) {
+    if (buf.length < SDES_HEADER_SIZE) {
+        throw new RangeError(`SDES packet too short: ${buf.length}`);
+    }
+    const sc = buf[0] & 0x1f;
+    // length word gives total 32-bit words - 1, so total bytes = (length+1)*4
+    const totalBytes = (buf.readUInt16BE(2) + 1) * 4;
+    const chunks = [];
+    let offset = SDES_HEADER_SIZE;
+    for (let c = 0; c < sc; c++) {
+        if (offset + 4 > buf.length)
+            break;
+        const ssrc = buf.readUInt32BE(offset);
+        offset += 4;
+        const items = [];
+        while (offset < totalBytes && offset < buf.length) {
+            const itemType = buf[offset];
+            if (itemType === undefined || itemType === 0x00) {
+                // END item — skip to 4-byte boundary
+                offset++;
+                const padTo = (offset + 3) & ~3;
+                offset = Math.min(padTo, buf.length);
+                break;
+            }
+            offset++;
+            const textLen = buf[offset];
+            if (textLen === undefined)
+                break;
+            offset++;
+            const text = buf.subarray(offset, offset + textLen).toString('utf8');
+            offset += textLen;
+            items.push({ type: itemType, text });
+        }
+        chunks.push({ ssrc, items });
+    }
+    return { chunks };
+}
+//# sourceMappingURL=sdes.js.map

package/dist/rtcp/sdes.js.map

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

package/dist/rtcp/sr.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RTCP Sender Report (SR) — RFC 3550 Section 6.4.1
+ */
+import type { RtcpSenderReport } from '../types.js';
+/** Full SR packet size without report blocks: 4 (common hdr) + 4 (SSRC) + 20 (sender info) */
+export declare const SR_BASE_SIZE = 28;
+export declare function encodeSr(sr: RtcpSenderReport): Buffer;
+export declare function decodeSr(buf: Buffer): RtcpSenderReport;
+//# sourceMappingURL=sr.d.ts.map

package/dist/rtcp/sr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sr.d.ts","sourceRoot":"","sources":["../../src/rtcp/sr.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,aAAa,CAAC;AAMjE,8FAA8F;AAC9F,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,wBAAgB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAoCrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAuBtD"}

package/dist/rtcp/sr.js

@@ -0,0 +1,59 @@
+/**
+ * RTCP Sender Report (SR) — RFC 3550 Section 6.4.1
+ */
+import { encodeReportBlock, decodeReportBlock, REPORT_BLOCK_SIZE } from './rr.js';
+/** Fixed size of SR sender info block (without report blocks) */
+const SR_SENDER_INFO_SIZE = 20; // 5 x 32-bit words
+/** Full SR packet size without report blocks: 4 (common hdr) + 4 (SSRC) + 20 (sender info) */
+export const SR_BASE_SIZE = 28;
+export function encodeSr(sr) {
+    const blockCount = sr.reportBlocks.length;
+    const totalBytes = SR_BASE_SIZE + blockCount * REPORT_BLOCK_SIZE;
+    const buf = Buffer.allocUnsafe(totalBytes);
+    // Common RTCP header
+    // V=2, P=0, RC=blockCount, PT=200
+    buf[0] = (2 << 6) | (blockCount & 0x1f);
+    buf[1] = 200;
+    // Length in 32-bit words minus 1
+    const lengthWords = totalBytes / 4 - 1;
+    buf.writeUInt16BE(lengthWords, 2);
+    // SSRC
+    buf.writeUInt32BE(sr.ssrc >>> 0, 4);
+    // NTP timestamp (64-bit)
+    buf.writeBigUInt64BE(sr.ntpTimestamp, 8);
+    // RTP timestamp
+    buf.writeUInt32BE(sr.rtpTimestamp >>> 0, 16);
+    // Packet count
+    buf.writeUInt32BE(sr.packetCount >>> 0, 20);
+    // Octet count
+    buf.writeUInt32BE(sr.octetCount >>> 0, 24);
+    // Report blocks
+    let offset = SR_BASE_SIZE;
+    for (const rb of sr.reportBlocks) {
+        encodeReportBlock(rb, buf, offset);
+        offset += REPORT_BLOCK_SIZE;
+    }
+    return buf;
+}
+export function decodeSr(buf) {
+    if (buf.length < SR_BASE_SIZE) {
+        throw new RangeError(`SR packet too short: ${buf.length}`);
+    }
+    // byte[0]: V(2)|P(1)|RC(5)  — RC = report count
+    const rc = (buf[0] & 0x1f);
+    const ssrc = buf.readUInt32BE(4);
+    const ntpTimestamp = buf.readBigUInt64BE(8);
+    const rtpTimestamp = buf.readUInt32BE(16);
+    const packetCount = buf.readUInt32BE(20);
+    const octetCount = buf.readUInt32BE(24);
+    const reportBlocks = [];
+    let offset = SR_BASE_SIZE;
+    for (let i = 0; i < rc; i++) {
+        if (offset + REPORT_BLOCK_SIZE > buf.length)
+            break;
+        reportBlocks.push(decodeReportBlock(buf, offset));
+        offset += REPORT_BLOCK_SIZE;
+    }
+    return { ssrc, ntpTimestamp, rtpTimestamp, packetCount, octetCount, reportBlocks };
+}
+//# sourceMappingURL=sr.js.map

package/dist/rtcp/sr.js.map

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

package/dist/rtp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * RTP packet encode/decode — RFC 3550 Section 5.1
+ */
+import type { RtpPacket } from './types.js';
+/**
+ * Returns true if the buffer looks like an RTP packet:
+ *   - version == 2
+ *   - payload type NOT in the RTCP range 200–204
+ *   - at least 12 bytes
+ */
+export declare function isRtpPacket(buf: Buffer): boolean;
+/**
+ * Decode an RTP packet from a Buffer.
+ * Throws if the buffer is malformed or too short.
+ */
+export declare function decodeRtp(buf: Buffer): RtpPacket;
+/**
+ * Encode an RTP packet into a Buffer.
+ */
+export declare function encodeRtp(packet: RtpPacket): Buffer;
+//# sourceMappingURL=rtp.d.ts.map

package/dist/rtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtp.d.ts","sourceRoot":"","sources":["../src/rtp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWhD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAiFhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAmDnD"}

package/dist/rtp.js

@@ -0,0 +1,149 @@
+/**
+ * RTP packet encode/decode — RFC 3550 Section 5.1
+ */
+import { parseExtensionValues, serializeExtension, } from './extension.js';
+/** Minimum RTP header size (no CSRC, no extension) */
+const RTP_MIN_HEADER = 12;
+/**
+ * Returns true if the buffer looks like an RTP packet:
+ *   - version == 2
+ *   - payload type NOT in the RTCP range 200–204
+ *   - at least 12 bytes
+ */
+export function isRtpPacket(buf) {
+    if (buf.length < RTP_MIN_HEADER)
+        return false;
+    const firstByte = buf[0];
+    if (firstByte === undefined)
+        return false;
+    const version = (firstByte >> 6) & 0x03;
+    if (version !== 2)
+        return false;
+    const secondByte = buf[1];
+    if (secondByte === undefined)
+        return false;
+    // RTCP PT occupies the full second byte (200–207); check raw value, not masked
+    if (secondByte >= 200 && secondByte <= 207)
+        return false;
+    return true;
+}
+/**
+ * Decode an RTP packet from a Buffer.
+ * Throws if the buffer is malformed or too short.
+ */
+export function decodeRtp(buf) {
+    if (buf.length < RTP_MIN_HEADER) {
+        throw new RangeError(`RTP buffer too short: ${buf.length}`);
+    }
+    const byte0 = buf[0];
+    const byte1 = buf[1];
+    const version = (byte0 >> 6) & 0x03;
+    if (version !== 2) {
+        throw new Error(`Invalid RTP version: ${version}`);
+    }
+    const padding = Boolean(byte0 & 0x20);
+    const hasExtension = Boolean(byte0 & 0x10);
+    const csrcCount = byte0 & 0x0f;
+    const marker = Boolean(byte1 & 0x80);
+    const payloadType = byte1 & 0x7f;
+    const sequenceNumber = buf.readUInt16BE(2);
+    const timestamp = buf.readUInt32BE(4);
+    const ssrc = buf.readUInt32BE(8);
+    let offset = RTP_MIN_HEADER;
+    // CSRC list
+    if (buf.length < offset + csrcCount * 4) {
+        throw new RangeError('RTP buffer too short for CSRC list');
+    }
+    const csrcs = [];
+    for (let i = 0; i < csrcCount; i++) {
+        csrcs.push(buf.readUInt32BE(offset));
+        offset += 4;
+    }
+    // Header extension
+    let headerExtension;
+    if (hasExtension) {
+        if (buf.length < offset + 4) {
+            throw new RangeError('RTP buffer too short for extension header');
+        }
+        const extProfile = buf.readUInt16BE(offset);
+        const extLengthWords = buf.readUInt16BE(offset + 2);
+        offset += 4;
+        const extBodyLen = extLengthWords * 4;
+        if (buf.length < offset + extBodyLen) {
+            throw new RangeError('RTP buffer too short for extension body');
+        }
+        const extBody = buf.subarray(offset, offset + extBodyLen);
+        offset += extBodyLen;
+        const values = parseExtensionValues(extProfile, extBody);
+        headerExtension = { id: extProfile, values };
+    }
+    // Payload
+    let payloadEnd = buf.length;
+    if (padding) {
+        const padLen = buf[buf.length - 1];
+        payloadEnd = buf.length - padLen;
+    }
+    const payload = Buffer.from(buf.subarray(offset, payloadEnd));
+    const result = {
+        version: 2,
+        padding,
+        extension: hasExtension,
+        csrcCount,
+        marker,
+        payloadType,
+        sequenceNumber,
+        timestamp,
+        ssrc,
+        csrcs,
+        payload,
+    };
+    if (headerExtension !== undefined) {
+        result.headerExtension = headerExtension;
+    }
+    return result;
+}
+/**
+ * Encode an RTP packet into a Buffer.
+ */
+export function encodeRtp(packet) {
+    const csrcCount = packet.csrcs.length;
+    // Build extension bytes if present
+    let extBuf = Buffer.alloc(0);
+    if (packet.headerExtension) {
+        extBuf = serializeExtension(packet.headerExtension);
+    }
+    // Build padding
+    let padBuf = Buffer.alloc(0);
+    if (packet.padding) {
+        // Add minimal 1-byte padding (caller controls actual padding amount via payload)
+        // The last byte of padding holds the count.
+        // We always emit padding as part of the payload in this implementation.
+        // If the caller set padding=true the payload should already include it.
+    }
+    const headerLen = RTP_MIN_HEADER + csrcCount * 4;
+    const totalLen = headerLen + extBuf.length + packet.payload.length + padBuf.length;
+    const buf = Buffer.allocUnsafe(totalLen);
+    const hasExt = packet.headerExtension !== undefined || packet.extension;
+    const byte0 = (2 << 6) |
+        (packet.padding ? 0x20 : 0) |
+        (hasExt ? 0x10 : 0) |
+        (csrcCount & 0x0f);
+    const byte1 = ((packet.marker ? 1 : 0) << 7) | (packet.payloadType & 0x7f);
+    buf[0] = byte0;
+    buf[1] = byte1;
+    buf.writeUInt16BE(packet.sequenceNumber, 2);
+    buf.writeUInt32BE(packet.timestamp >>> 0, 4);
+    buf.writeUInt32BE(packet.ssrc >>> 0, 8);
+    let offset = RTP_MIN_HEADER;
+    for (const csrc of packet.csrcs) {
+        buf.writeUInt32BE(csrc >>> 0, offset);
+        offset += 4;
+    }
+    if (extBuf.length > 0) {
+        extBuf.copy(buf, offset);
+        offset += extBuf.length;
+    }
+    packet.payload.copy(buf, offset);
+    return buf;
+}
+//# sourceMappingURL=rtp.js.map

package/dist/rtp.js.map

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

package/dist/sequence.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Wrap-around aware sequence number utilities for RTP (RFC 3550 Section A.1).
+ * Sequence numbers are 16-bit unsigned (0–65535).
+ */
+/**
+ * Returns a - b, wrap-around aware.
+ * Result is in range (-32768, 32768].
+ */
+export declare function seqDiff(a: number, b: number): number;
+/** Returns true if a < b (wrap-around aware) */
+export declare function seqLt(a: number, b: number): boolean;
+/** Returns true if a <= b (wrap-around aware) */
+export declare function seqLte(a: number, b: number): boolean;
+/** Returns true if a > b (wrap-around aware) */
+export declare function seqGt(a: number, b: number): boolean;
+/**
+ * Convert a 64-bit NTP timestamp to Unix milliseconds.
+ * NTP format: upper 32 bits = seconds since 1900-01-01,
+ *             lower 32 bits = fractional seconds.
+ */
+export declare function ntpToUnix(ntp: bigint): number;
+/**
+ * Convert Unix milliseconds to a 64-bit NTP timestamp.
+ */
+export declare function unixToNtp(ms: number): bigint;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,gDAAgD;AAChD,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,iDAAiD;AACjD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,gDAAgD;AAChD,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnD;AAKD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM5C"}