@agentdance/node-webrtc-rtp 1.0.0

package/dist/sequence.js

@@ -0,0 +1,53 @@
+/**
+ * Wrap-around aware sequence number utilities for RTP (RFC 3550 Section A.1).
+ * Sequence numbers are 16-bit unsigned (0–65535).
+ */
+const MAX_SEQ = 0x10000; // 65536
+const HALF_MAX_SEQ = 0x8000; // 32768
+/**
+ * Returns a - b, wrap-around aware.
+ * Result is in range (-32768, 32768].
+ */
+export function seqDiff(a, b) {
+    const diff = ((a - b) & 0xffff) >>> 0;
+    if (diff === 0)
+        return 0;
+    // If diff >= half the range, it wrapped around in the negative direction
+    return diff < HALF_MAX_SEQ ? diff : diff - MAX_SEQ;
+}
+/** Returns true if a < b (wrap-around aware) */
+export function seqLt(a, b) {
+    return seqDiff(a, b) < 0;
+}
+/** Returns true if a <= b (wrap-around aware) */
+export function seqLte(a, b) {
+    return seqDiff(a, b) <= 0;
+}
+/** Returns true if a > b (wrap-around aware) */
+export function seqGt(a, b) {
+    return seqDiff(a, b) > 0;
+}
+// NTP epoch is Jan 1, 1900; Unix epoch is Jan 1, 1970 — difference in seconds
+const NTP_UNIX_OFFSET_S = BigInt(70 * 365 * 24 * 3600 + 17 * 24 * 3600); // 70 years + 17 leap days
+/**
+ * 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 function ntpToUnix(ntp) {
+    const seconds = (ntp >> 32n) - NTP_UNIX_OFFSET_S;
+    const fraction = ntp & 0xffffffffn;
+    const ms = (fraction * 1000n) >> 32n;
+    return Number(seconds) * 1000 + Number(ms);
+}
+/**
+ * Convert Unix milliseconds to a 64-bit NTP timestamp.
+ */
+export function unixToNtp(ms) {
+    const totalMs = BigInt(ms);
+    const seconds = totalMs / 1000n + NTP_UNIX_OFFSET_S;
+    const remainder = totalMs % 1000n;
+    const fraction = (remainder * (1n << 32n)) / 1000n;
+    return (seconds << 32n) | fraction;
+}
+//# sourceMappingURL=sequence.js.map

package/dist/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,QAAQ;AACjC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,QAAQ;AAErC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS,EAAE,CAAS;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,yEAAyE;IACzE,OAAO,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC;AACrD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,CAAS;IACxC,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS;IACzC,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,CAAS;IACxC,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,0BAA0B;AAEnG;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,iBAAiB,CAAC;IACjD,MAAM,QAAQ,GAAG,GAAG,GAAG,WAAW,CAAC;IACnC,MAAM,EAAE,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;IACrC,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,iBAAiB,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACnD,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;AACrC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+export interface RtpPacket {
+    version: 2;
+    padding: boolean;
+    extension: boolean;
+    csrcCount: number;
+    marker: boolean;
+    payloadType: number;
+    sequenceNumber: number;
+    timestamp: number;
+    ssrc: number;
+    csrcs: number[];
+    headerExtension?: RtpHeaderExtension;
+    payload: Buffer;
+}
+export interface RtpHeaderExtension {
+    id: number;
+    values: RtpExtensionValue[];
+}
+export interface RtpExtensionValue {
+    id: number;
+    data: Buffer;
+}
+export declare enum RtcpPacketType {
+    SR = 200,
+    RR = 201,
+    SDES = 202,
+    BYE = 203,
+    APP = 204,
+    TransportFeedback = 205,
+    PayloadFeedback = 206
+}
+export interface RtcpHeader {
+    version: 2;
+    padding: boolean;
+    count: number;
+    packetType: RtcpPacketType;
+    length: number;
+}
+export interface RtcpSenderReport {
+    ssrc: number;
+    ntpTimestamp: bigint;
+    rtpTimestamp: number;
+    packetCount: number;
+    octetCount: number;
+    reportBlocks: ReportBlock[];
+}
+export interface RtcpReceiverReport {
+    ssrc: number;
+    reportBlocks: ReportBlock[];
+}
+export interface ReportBlock {
+    ssrc: number;
+    fractionLost: number;
+    cumulativeLost: number;
+    extendedHighestSeq: number;
+    jitter: number;
+    lastSR: number;
+    delaySinceLastSR: number;
+}
+export interface RtcpSdes {
+    chunks: SdesChunk[];
+}
+export interface SdesChunk {
+    ssrc: number;
+    items: SdesItem[];
+}
+export interface SdesItem {
+    type: number;
+    text: string;
+}
+export interface RtcpBye {
+    ssrcs: number[];
+    reason?: string;
+}
+export interface RtcpNack {
+    senderSsrc: number;
+    mediaSsrc: number;
+    pid: number;
+    blp: number;
+}
+export interface RtcpPli {
+    senderSsrc: number;
+    mediaSsrc: number;
+}
+export interface RtcpFir {
+    senderSsrc: number;
+    entries: FirEntry[];
+}
+export interface FirEntry {
+    ssrc: number;
+    seqNumber: number;
+}
+export interface RtcpRemb {
+    senderSsrc: number;
+    mediaSsrc: number;
+    bitrate: number;
+    ssrcs: number[];
+}
+export type RtcpPacket = {
+    type: 'sr';
+    packet: RtcpSenderReport;
+} | {
+    type: 'rr';
+    packet: RtcpReceiverReport;
+} | {
+    type: 'sdes';
+    packet: RtcpSdes;
+} | {
+    type: 'bye';
+    packet: RtcpBye;
+} | {
+    type: 'nack';
+    packet: RtcpNack;
+} | {
+    type: 'pli';
+    packet: RtcpPli;
+} | {
+    type: 'fir';
+    packet: RtcpFir;
+} | {
+    type: 'remb';
+    packet: RtcpRemb;
+} | {
+    type: 'unknown';
+    raw: Buffer;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,12 @@
+// RFC 3550 RTP/RTCP types
+export var RtcpPacketType;
+(function (RtcpPacketType) {
+    RtcpPacketType[RtcpPacketType["SR"] = 200] = "SR";
+    RtcpPacketType[RtcpPacketType["RR"] = 201] = "RR";
+    RtcpPacketType[RtcpPacketType["SDES"] = 202] = "SDES";
+    RtcpPacketType[RtcpPacketType["BYE"] = 203] = "BYE";
+    RtcpPacketType[RtcpPacketType["APP"] = 204] = "APP";
+    RtcpPacketType[RtcpPacketType["TransportFeedback"] = 205] = "TransportFeedback";
+    RtcpPacketType[RtcpPacketType["PayloadFeedback"] = 206] = "PayloadFeedback";
+})(RtcpPacketType || (RtcpPacketType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0BAA0B;AA2B1B,MAAM,CAAN,IAAY,cAQX;AARD,WAAY,cAAc;IACxB,iDAAQ,CAAA;IACR,iDAAQ,CAAA;IACR,qDAAU,CAAA;IACV,mDAAS,CAAA;IACT,mDAAS,CAAA;IACT,+EAAuB,CAAA;IACvB,2EAAqB,CAAA;AACvB,CAAC,EARW,cAAc,KAAd,cAAc,QAQzB"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@agentdance/node-webrtc-rtp",
+  "version": "1.0.0",
+  "description": "RFC 3550 RTP/RTCP codec — header encode/decode, CSRC, header extensions, SR/RR/SDES/BYE/NACK/PLI/FIR/REMB. Part of the @agentdance/node-webrtc stack.",
+  "keywords": [
+    "webrtc",
+    "rtp",
+    "rtcp",
+    "rfc3550",
+    "nack",
+    "remb",
+    "typescript",
+    "node"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/agent-dance/node-webrtc#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-dance/node-webrtc.git",
+    "directory": "packages/rtp"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-dance/node-webrtc/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "typescript": "*",
+    "vitest": "*",
+    "@types/node": "*"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/extension.ts

@@ -0,0 +1,153 @@
+/**
+ * RTP header extension parsing and serialization.
+ * Supports one-byte header (RFC 5285, profile 0xBEDE) and
+ * two-byte header (RFC 5285, profile 0x1000).
+ */
+
+import type { RtpExtensionValue, RtpHeaderExtension } from './types.js';
+
+export const ONE_BYTE_PROFILE = 0xbede;
+export const TWO_BYTE_PROFILE = 0x1000;
+
+/**
+ * Parse the extension payload (after the 4-byte profile+length header).
+ * @param profile - The extension profile value (0xBEDE or 0x1000)
+ * @param data    - Raw bytes of the extension body (without the 4-byte profile/length header)
+ */
+export function parseExtensionValues(
+  profile: number,
+  data: Buffer,
+): RtpExtensionValue[] {
+  const values: RtpExtensionValue[] = [];
+
+  if (profile === ONE_BYTE_PROFILE) {
+    // One-byte header: | 0001 | id(4) | len-1(4) | data ... |
+    let i = 0;
+    while (i < data.length) {
+      const byte = data[i];
+      if (byte === undefined) break;
+      if (byte === 0x00) {
+        // Padding
+        i++;
+        continue;
+      }
+      if (byte === 0xff) {
+        // End marker
+        break;
+      }
+      const id = (byte >> 4) & 0x0f;
+      const len = (byte & 0x0f) + 1;
+      i++;
+      if (i + len > data.length) break;
+      values.push({ id, data: Buffer.from(data.subarray(i, i + len)) });
+      i += len;
+    }
+  } else if ((profile & 0xfff0) === TWO_BYTE_PROFILE) {
+    // Two-byte header: | id(8) | len(8) | data ... |
+    let i = 0;
+    while (i < data.length) {
+      const id = data[i];
+      if (id === undefined) break;
+      if (id === 0x00) {
+        // Padding
+        i++;
+        continue;
+      }
+      i++;
+      if (i >= data.length) break;
+      const len = data[i];
+      if (len === undefined) break;
+      i++;
+      if (len === 0) {
+        values.push({ id, data: Buffer.alloc(0) });
+        continue;
+      }
+      if (i + len > data.length) break;
+      values.push({ id, data: Buffer.from(data.subarray(i, i + len)) });
+      i += len;
+    }
+  }
+
+  return values;
+}
+
+/**
+ * Serialize extension values into a Buffer (without the 4-byte profile/length header).
+ * The result is padded to a 4-byte boundary.
+ */
+export function serializeExtensionValues(
+  profile: number,
+  values: RtpExtensionValue[],
+): Buffer {
+  const parts: Buffer[] = [];
+
+  if (profile === ONE_BYTE_PROFILE) {
+    for (const ext of values) {
+      const len = ext.data.length;
+      if (len < 1 || len > 16) {
+        throw new RangeError(
+          `One-byte extension id=${ext.id}: data length must be 1-16 bytes, got ${len}`,
+        );
+      }
+      if (ext.id < 1 || ext.id > 14) {
+        throw new RangeError(
+          `One-byte extension id must be 1-14, got ${ext.id}`,
+        );
+      }
+      const header = ((ext.id & 0x0f) << 4) | ((len - 1) & 0x0f);
+      parts.push(Buffer.from([header]));
+      parts.push(Buffer.from(ext.data));
+    }
+  } else if ((profile & 0xfff0) === TWO_BYTE_PROFILE) {
+    for (const ext of values) {
+      const len = ext.data.length;
+      if (ext.id < 1 || ext.id > 255) {
+        throw new RangeError(
+          `Two-byte extension id must be 1-255, got ${ext.id}`,
+        );
+      }
+      parts.push(Buffer.from([ext.id, len]));
+      if (len > 0) parts.push(Buffer.from(ext.data));
+    }
+  }
+
+  const body = Buffer.concat(parts);
+  // Pad to 4-byte boundary
+  const padLen = (4 - (body.length % 4)) % 4;
+  const padding = Buffer.alloc(padLen, 0x00);
+  return Buffer.concat([body, padding]);
+}
+
+/**
+ * Serialize a complete RtpHeaderExtension (profile/length word + body).
+ */
+export function serializeExtension(ext: RtpHeaderExtension): Buffer {
+  const body = serializeExtensionValues(ext.id, ext.values);
+  // Length field = number of 32-bit words in the body
+  const lengthWords = body.length / 4;
+  const header = Buffer.allocUnsafe(4);
+  header.writeUInt16BE(ext.id, 0);
+  header.writeUInt16BE(lengthWords, 2);
+  return Buffer.concat([header, body]);
+}
+
+/**
+ * Get the first extension value matching a given id, or undefined.
+ */
+export function getExtensionValue(
+  ext: RtpHeaderExtension,
+  id: number,
+): RtpExtensionValue | undefined {
+  return ext.values.find((v) => v.id === id);
+}
+
+/**
+ * Return a new RtpHeaderExtension with the given id set (inserted or replaced).
+ */
+export function setExtensionValue(
+  ext: RtpHeaderExtension,
+  value: RtpExtensionValue,
+): RtpHeaderExtension {
+  const filtered = ext.values.filter((v) => v.id !== value.id);
+  return { id: ext.id, values: [...filtered, value] };
+}

package/src/index.ts

@@ -0,0 +1,68 @@
+/**
+ * @agentdance/node-webrtc-rtp — RFC 3550 RTP/RTCP implementation
+ */
+
+export type {
+  RtpPacket,
+  RtpHeaderExtension,
+  RtpExtensionValue,
+  RtcpHeader,
+  RtcpSenderReport,
+  RtcpReceiverReport,
+  ReportBlock,
+  RtcpSdes,
+  SdesChunk,
+  SdesItem,
+  RtcpBye,
+  RtcpNack,
+  RtcpPli,
+  RtcpFir,
+  FirEntry,
+  RtcpRemb,
+  RtcpPacket,
+} from './types.js';
+
+export { RtcpPacketType } from './types.js';
+
+// RTP
+export { encodeRtp, decodeRtp, isRtpPacket } from './rtp.js';
+
+// RTCP compound
+export { encodeRtcp, decodeRtcp, isRtcpPacket } from './rtcp/index.js';
+
+// RTCP individual encoders/decoders
+export { encodeSr, decodeSr } from './rtcp/sr.js';
+export { encodeRr, decodeRr, encodeReportBlock, decodeReportBlock } from './rtcp/rr.js';
+export { encodeSdes, decodeSdes } from './rtcp/sdes.js';
+export { encodeBye, decodeBye } from './rtcp/bye.js';
+export {
+  encodeNack,
+  decodeNack,
+  encodePli,
+  decodePli,
+  encodeFir,
+  decodeFir,
+  encodeRemb,
+  decodeRemb,
+} from './rtcp/fb.js';
+
+// Header extensions
+export {
+  ONE_BYTE_PROFILE,
+  TWO_BYTE_PROFILE,
+  parseExtensionValues,
+  serializeExtensionValues,
+  serializeExtension,
+  getExtensionValue,
+  setExtensionValue,
+} from './extension.js';
+
+// Sequence utilities
+export {
+  seqDiff,
+  seqLt,
+  seqLte,
+  seqGt,
+  ntpToUnix,
+  unixToNtp,
+} from './sequence.js';

package/src/rtcp/bye.ts

@@ -0,0 +1,73 @@
+/**
+ * RTCP BYE — RFC 3550 Section 6.6
+ */
+
+import type { RtcpBye } from '../types.js';
+
+const BYE_HEADER_SIZE = 4;
+
+export function encodeBye(bye: RtcpBye): Buffer {
+  const sc = bye.ssrcs.length;
+
+  // Reason string (optional)
+  let reasonBuf: Buffer = Buffer.alloc(0);
+  if (bye.reason !== undefined) {
+    const text = Buffer.from(bye.reason, 'utf8');
+    const reasonLen = Math.min(text.length, 255);
+    // 1 byte length prefix + text + padding to 4-byte boundary
+    const raw = Buffer.allocUnsafe(1 + reasonLen);
+    raw[0] = reasonLen;
+    text.copy(raw, 1, 0, reasonLen);
+    const padded = reasonLen + 1;
+    const padLen = (4 - (padded % 4)) % 4;
+    reasonBuf = Buffer.concat([raw, Buffer.alloc(padLen, 0x00)]);
+  }
+
+  const totalBytes = BYE_HEADER_SIZE + sc * 4 + reasonBuf.length;
+  const buf = Buffer.allocUnsafe(totalBytes);
+
+  buf[0] = (2 << 6) | (sc & 0x1f);
+  buf[1] = 203;
+  buf.writeUInt16BE(totalBytes / 4 - 1, 2);
+
+  let offset = BYE_HEADER_SIZE;
+  for (const ssrc of bye.ssrcs) {
+    buf.writeUInt32BE(ssrc >>> 0, offset);
+    offset += 4;
+  }
+
+  if (reasonBuf.length > 0) {
+    reasonBuf.copy(buf, offset);
+  }
+
+  return buf;
+}
+
+export function decodeBye(buf: Buffer): RtcpBye {
+  if (buf.length < BYE_HEADER_SIZE) {
+    throw new RangeError(`BYE packet too short: ${buf.length}`);
+  }
+
+  const sc = buf[0]! & 0x1f;
+  const totalBytes = (buf.readUInt16BE(2) + 1) * 4;
+
+  const ssrcs: number[] = [];
+  let offset = BYE_HEADER_SIZE;
+
+  for (let i = 0; i < sc; i++) {
+    if (offset + 4 > buf.length) break;
+    ssrcs.push(buf.readUInt32BE(offset));
+    offset += 4;
+  }
+
+  let reason: string | undefined;
+  if (offset < totalBytes && offset < buf.length) {
+    const reasonLen = buf[offset];
+    if (reasonLen !== undefined && reasonLen > 0) {
+      offset++;
+      reason = buf.subarray(offset, offset + reasonLen).toString('utf8');
+    }
+  }
+
+  return { ssrcs, ...(reason !== undefined ? { reason } : {}) };
+}