@blockcast/mmt-base 0.1.0-main.85c1beb6aa0e → 0.1.0-main.8fd67100e40b

package/README.md

@@ -57,9 +57,23 @@ MPU `payload_length` is interpreted strictly as ISO's length-after-field value:
 | `extractFecPayloadId` | function | `{ ssId }` from a source packet's FEC payload id (or `null`) |
 | `extractRepairFecPayloadId` | function | Repair-flow FEC payload id (13-byte, `REPAIR_FEC_PID_SIZE`) |
 | `parseMoqRepairFrame` | function | Strictly parse a mode-0 MMTP Annex C repair frame → `MoqRepairFrame` |
-| `parseAlFecMessage` | function | Parse an AL-FEC signaling message → `AlFecConfig` |
-| `MoqRepairFrame`, `AlFecConfig` | type | Repair-frame / AL-FEC config shapes |
+| `MoqRepairFrame` | type | Repair-frame shape |
 | `ALFEC_MESSAGE_ID` (0x0203), `FEC_CODE_XOR` (1), `FEC_CODE_RAPTORQ` (2), `REPAIR_FEC_PID_SIZE` (13) | const | AL-FEC signaling + payload-id constants |
+| `MMTP_SIGNALING_PACKET_ID` (0), `MMTP_PACKET_ID_MAX` (0xffff) | const | Signaling-flow `packet_id` (never a track's) and the 16-bit `packet_id` ceiling; a track's `packet_id` is 1..65535 |
+
+### Signalling messages (`signalling.ts`, packet_id 0)
+
+Total parsers (malformed or unsupported input → `null`, never a throw), per
+ISO/IEC 23008-1:2023 9.3.4.2, 10.2-10.3, 10.6 and Annex C Table C.3 as
+replaced by Amd 1:2025.
+
+| Symbol | Kind | Purpose |
+|--------|------|---------|
+| `parseSignallingPayload` | function | Split a signalling packet into complete messages; reports the payload form: `iso-9.3.4.2` (Figure 15 header) or `legacy-bare-alfec` (message 0x0203 directly after the MMTP header, recognised by its exact `0x02 0x03` peek) |
+| `parseSignallingPacket` | function | Decode every message of a signalling packet → `al-fec` / `pa` / `mpt` / `other` |
+| `parseAlFecMessage`, `parseAlFecMessageBody` | function | Every FEC flow of an AL-FEC message: all asset packet_ids, one-stage / two-stage / LA-FEC repair flows, private fields → `AlFecMessage` |
+| `alFecRaptorQFlowConfig` | function | One flow's decoder geometry under the Blockcast one-stage RaptorQ profile (private field = OTI + interleave depth) → `AlFecRaptorQFlowConfig` |
+| `parsePaMessageBody`, `parseMptMessageBody`, `parseMpTable`, `mpAssetPacketIds` | function | PA / MPT messages and the MP table: asset → packet_id mapping |
 
 ### ALTA trailer (re-exported from `@blockcast/mmt-alta-parse`)
 

package/dist/index.d.ts

@@ -1,2 +1,6 @@
 export * from './mmtp.js';
+export * from './net-constants.js';
+export * from './ntp-short.js';
+export * from './signalling.js';
+export * from './serial-number.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA"}

package/dist/index.js

@@ -1,2 +1,6 @@
 export * from './mmtp.js';
+export * from './net-constants.js';
+export * from './ntp-short.js';
+export * from './signalling.js';
+export * from './serial-number.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA"}

package/dist/mmtp.d.ts

@@ -74,12 +74,32 @@ export declare const PACKET_TYPE_MPU = 0;
 export declare const PACKET_TYPE_SIGNALING = 2;
 export declare const PACKET_TYPE_REPAIR = 3;
 export declare const ALFEC_MESSAGE_ID = 515;
+/**
+ * MMTP `packet_id` of the signaling flow, which carries PACKET_TYPE_SIGNALING
+ * packets such as the AL-FEC message (ALFEC_MESSAGE_ID). The FFmpeg `moq_mmt`
+ * muxer sends that message on this packet_id into the same multicast group as
+ * the media, and moqcast-draft (PR #44) makes advertising it for a track a
+ * MUST NOT. A track's packet_id is therefore 1..MMTP_PACKET_ID_MAX.
+ */
+export declare const MMTP_SIGNALING_PACKET_ID = 0;
+/** Largest value of the 16-bit MMTP `packet_id` header field. */
+export declare const MMTP_PACKET_ID_MAX = 65535;
 export declare const FEC_CODE_XOR = 1;
 export declare const FEC_CODE_RAPTORQ = 2;
 /**
  * Parse MMTP header from buffer
  */
 export declare function parseMMTPHeader(buffer: Uint8Array): MMTPHeader;
+/**
+ * The MMTP `packet_id` of `buffer`, or null exactly when parseMMTPHeader would
+ * throw for it (short buffer, V != 0, truncated packet_counter or header
+ * extension).
+ *
+ * This is the per-packet filter a receiver runs before any other work, so it
+ * builds no header object, DataView or BigInt timestamp (BLO-36599). Use
+ * parseMMTPHeader when any other header field is needed.
+ */
+export declare function readMMTPPacketId(buffer: Uint8Array): number | null;
 /**
  * Unwrap MMTP packet to extract payload
  */
@@ -147,6 +167,16 @@ export declare function explainMFURejection(mmtpPacket: Uint8Array, options?: {
 export declare function extractMFUPayload(mmtpPacket: Uint8Array, options?: {
     skipFecId?: boolean;
 }): MFUExtraction | null;
+/**
+ * extractMFUPayload for a caller that already holds this packet's parsed MMTP
+ * header, so the header is not parsed a second time (BLO-36599).
+ *
+ * `header` must be `parseMMTPHeader(mmtpPacket)` of this same packet; the
+ * result is then identical to `extractMFUPayload(mmtpPacket, options)`.
+ */
+export declare function extractMFUPayloadWithHeader(mmtpPacket: Uint8Array, header: MMTPHeader, options?: {
+    skipFecId?: boolean;
+}): MFUExtraction | null;
 /**
  * Extract timestamp from MMTP packet
  */
@@ -161,9 +191,10 @@ export declare function isFecRepairPacket(mmtpPacket: Uint8Array): boolean;
  * source packet per ISO/IEC 23008-1:2023 Section C.5.2 Figure C.10.
  *
  * SS_ID is a flat 32-bit monotonic counter (incremented by 1 per packet
- * for ssbg_mode0 and ssbg_mode1).  Block membership and ESI are derived
- * at recovery time from repair packet SS_Start and SSB_length:
- *   SBN = floor(SS_ID / K),  ESI = SS_ID % K
+ * for ssbg_mode0 and ssbg_mode1). Block membership and ESI use the
+ * configured K; repair SS_Start identifies the first SS_ID of the block and
+ * SSB_length records the authored source-symbol count:
+ *   SBN = floor(SS_ID / K), ESI = SS_ID % K
  *   SS_Start = SBN * K  (first SS_ID of the block)
  *
  * This matches FFmpeg moqenc_mmt.c, the drafts (draft-ramadan-moq-fec §6.2),
@@ -177,6 +208,18 @@ export declare function extractFecPayloadId(mmtpPacket: Uint8Array): {
  * payload contains a four-byte Source FEC Payload ID.
  */
 export declare function hasSourceFecPayloadId(mmtpPacket: Uint8Array): boolean;
+/**
+ * The Source FEC Payload ID of a packet whose MMTP header the caller already
+ * parsed, or null when the packet carries none: present only when FEC_type=1
+ * and the exact suffix after the ISO-declared MPU payload holds the four-byte
+ * ID (ISO/IEC 23008-1 §C.5.2). Same answer as extractFecPayloadId, without a
+ * second header parse (BLO-36599).
+ *
+ * `header` must be `parseMMTPHeader(mmtpPacket)` of this same packet.
+ */
+export declare function sourceFecPayloadIdOf(mmtpPacket: Uint8Array, header: MMTPHeader): {
+    ssId: number;
+} | null;
 /**
  * MMTP header-extension ext_type assigned to the detached ALTA authenticator
  * trailer (Path 2 / 08-07). Carried in an `[ext_type][ext_length][auth]`
@@ -216,7 +259,7 @@ export interface MoqRepairFrame {
     rsbLength: number;
     /** RS_ID (24 bits): repair symbol index (0-based) */
     rsId: number;
-    /** SSB_length (24 bits): number of source symbols (K) */
+    /** SSB_length (24 bits): authored source-symbol count (1..=configured K) */
     ssbLength: number;
     /** Repair symbol data after the dynamic MMTP header and 13-byte FEC payload ID. */
     symbolData: Uint8Array;
@@ -229,7 +272,7 @@ export interface MoqRepairFrame {
  *   then SS_Start (4 bytes) → block identifier
  *   then RSB_length (3 bytes) → P
  *   then RS_ID (3 bytes) → ESI = K + RS_ID
- *   then SSB_length (3 bytes) → K
+ *   then SSB_length (3 bytes) → authored source-symbol count (1..=K)
  *   then Repair Symbol Data (T bytes)
  *
  * @param frame - Raw MoQ repair frame bytes
@@ -237,39 +280,13 @@ export interface MoqRepairFrame {
  */
 export declare function parseMoqRepairFrame(frame: Uint8Array): MoqRepairFrame | null;
 /**
- * AL-FEC signaling configuration parsed from ISO/IEC 23008-1:2023 Table C.3 message.
- */
-export interface AlFecConfig {
-    fecCodeId: number;
-    fecPayloadIdMode: 0;
-    repairSymbolSize: number;
-    maximumK: number;
-    maximumP: number;
-    interleaveDepth: number;
-    oti: Uint8Array;
-}
-/**
- * Parse AL-FEC signaling message from a full MMTP signaling packet.
- *
- * Wire format (ISO/IEC 23008-1:2023 Table C.3, Amendment 1:2025):
- *   [12-byte MMTP header (packet_type=0x02)]
- *   message_id(2)        = 0x0203
- *   version(1)
- *   message_length(2)    = length of remaining payload
- *   flags(1)             = fec_flag(1) | private_fec_flag(1) | reserved(6)
- *   fec_flow_descriptor:
- *     length(2)
- *     num_flows(1)
- *     per flow:
- *       fec_flow_id(1), source_flow_id(1), num_assets(1), packet_ids(2*N),
- *       coding_params(1), repair_symbol_size(2),
- *       [one-stage]: repair_flow_id(2), fec_code_id(1),
- *       [private_fec_flag]: private_header(1){flag(1)|len(7)},
- *         current RaptorQ profile OTI(12) + interleave_depth(1)
- *       max_k(3), max_p(3), protection_window_time(4), protection_window_size(4)
+ * parseMoqRepairFrame for a caller that already holds this frame's parsed MMTP
+ * header, so the header is not parsed a second time (BLO-36599). The router's
+ * multicast repair branch uses it: one repair packet in every K + P otherwise
+ * paid two header parses.
  *
- * @param mmtpPacket Full MMTP packet including 12-byte header
- * @returns Parsed config or null if not an AL-FEC signaling message
+ * `header` must be `parseMMTPHeader(frame)` of this same frame; the result is
+ * then identical to `parseMoqRepairFrame(frame)`.
  */
-export declare function parseAlFecMessage(mmtpPacket: Uint8Array): AlFecConfig | null;
+export declare function parseMoqRepairFrameWithHeader(frame: Uint8Array, header: MMTPHeader): MoqRepairFrame | null;
 //# sourceMappingURL=mmtp.d.ts.map

package/dist/mmtp.d.ts.map

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

package/dist/mmtp.js

@@ -12,6 +12,16 @@ export const PACKET_TYPE_SIGNALING = 0x02;
 export const PACKET_TYPE_REPAIR = 0x03;
 // AL-FEC Signaling Message ID (ISO/IEC 23008-1:2023 Amendment 1:2025)
 export const ALFEC_MESSAGE_ID = 0x0203;
+/**
+ * MMTP `packet_id` of the signaling flow, which carries PACKET_TYPE_SIGNALING
+ * packets such as the AL-FEC message (ALFEC_MESSAGE_ID). The FFmpeg `moq_mmt`
+ * muxer sends that message on this packet_id into the same multicast group as
+ * the media, and moqcast-draft (PR #44) makes advertising it for a track a
+ * MUST NOT. A track's packet_id is therefore 1..MMTP_PACKET_ID_MAX.
+ */
+export const MMTP_SIGNALING_PACKET_ID = 0;
+/** Largest value of the 16-bit MMTP `packet_id` header field. */
+export const MMTP_PACKET_ID_MAX = 0xffff;
 // FEC Code IDs
 export const FEC_CODE_XOR = 1;
 export const FEC_CODE_RAPTORQ = 2;
@@ -81,6 +91,36 @@ export function parseMMTPHeader(buffer) {
         rapFlag,
     };
 }
+/**
+ * The MMTP `packet_id` of `buffer`, or null exactly when parseMMTPHeader would
+ * throw for it (short buffer, V != 0, truncated packet_counter or header
+ * extension).
+ *
+ * This is the per-packet filter a receiver runs before any other work, so it
+ * builds no header object, DataView or BigInt timestamp (BLO-36599). Use
+ * parseMMTPHeader when any other header field is needed.
+ */
+export function readMMTPPacketId(buffer) {
+    if (buffer.length < MMTP_HEADER_SIZE)
+        return null;
+    const flags = buffer[0];
+    if (((flags >> 6) & 0x03) !== 0)
+        return null;
+    let offset = MMTP_HEADER_SIZE;
+    if ((flags & 0x20) !== 0) {
+        if (offset + 4 > buffer.length)
+            return null;
+        offset += 4;
+    }
+    if ((flags & 0x02) !== 0) {
+        if (offset + 4 > buffer.length)
+            return null;
+        const length = (buffer[offset + 2] << 8) | buffer[offset + 3];
+        if (offset + 4 + length > buffer.length)
+            return null;
+    }
+    return (buffer[2] << 8) | buffer[3];
+}
 /**
  * Unwrap MMTP packet to extract payload
  */
@@ -227,7 +267,7 @@ export function extractNALUnit(mmtpPacket) {
  * reason reported to operators can never drift from the decision the parser
  * actually made.
  */
-function planMfuExtraction(mmtpPacket, options) {
+function planMfuExtraction(mmtpPacket, options, parsedHeader) {
     if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE) {
         return {
             rejection: {
@@ -237,16 +277,21 @@ function planMfuExtraction(mmtpPacket, options) {
         };
     }
     let header;
-    try {
-        header = parseMMTPHeader(mmtpPacket);
+    if (parsedHeader) {
+        header = parsedHeader;
     }
-    catch (error) {
-        return {
-            rejection: {
-                gate: 'mmtp-header-unparseable',
-                detail: error instanceof Error ? error.message : String(error),
-            },
-        };
+    else {
+        try {
+            header = parseMMTPHeader(mmtpPacket);
+        }
+        catch (error) {
+            return {
+                rejection: {
+                    gate: 'mmtp-header-unparseable',
+                    detail: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
     }
     if (header.packetType !== PACKET_TYPE_MPU) {
         return {
@@ -320,7 +365,19 @@ export function explainMFURejection(mmtpPacket, options) {
     return 'rejection' in result ? result.rejection : null;
 }
 export function extractMFUPayload(mmtpPacket, options) {
-    const result = planMfuExtraction(mmtpPacket, options);
+    return extractPlannedMfu(mmtpPacket, planMfuExtraction(mmtpPacket, options));
+}
+/**
+ * extractMFUPayload for a caller that already holds this packet's parsed MMTP
+ * header, so the header is not parsed a second time (BLO-36599).
+ *
+ * `header` must be `parseMMTPHeader(mmtpPacket)` of this same packet; the
+ * result is then identical to `extractMFUPayload(mmtpPacket, options)`.
+ */
+export function extractMFUPayloadWithHeader(mmtpPacket, header, options) {
+    return extractPlannedMfu(mmtpPacket, planMfuExtraction(mmtpPacket, options, header));
+}
+function extractPlannedMfu(mmtpPacket, result) {
     if ('rejection' in result)
         return null;
     const { header, payload, mpu, fragmentType, layout, trailerLayout } = result.plan;
@@ -363,46 +420,69 @@ export function isFecRepairPacket(mmtpPacket) {
  * source packet per ISO/IEC 23008-1:2023 Section C.5.2 Figure C.10.
  *
  * SS_ID is a flat 32-bit monotonic counter (incremented by 1 per packet
- * for ssbg_mode0 and ssbg_mode1).  Block membership and ESI are derived
- * at recovery time from repair packet SS_Start and SSB_length:
- *   SBN = floor(SS_ID / K),  ESI = SS_ID % K
+ * for ssbg_mode0 and ssbg_mode1). Block membership and ESI use the
+ * configured K; repair SS_Start identifies the first SS_ID of the block and
+ * SSB_length records the authored source-symbol count:
+ *   SBN = floor(SS_ID / K), ESI = SS_ID % K
  *   SS_Start = SBN * K  (first SS_ID of the block)
  *
  * This matches FFmpeg moqenc_mmt.c, the drafts (draft-ramadan-moq-fec §6.2),
  * and ATSC A/331 §8.1.2.5 which defers to ISO 23008-1 Annex C.
  */
 export function extractFecPayloadId(mmtpPacket) {
-    if (!hasSourceFecPayloadId(mmtpPacket))
-        return null;
-    // Flat 4-byte SS_ID: encoder writes block_id * K + symbol_id
-    const off = mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE;
-    const view = new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + off, SOURCE_FEC_PAYLOAD_ID_SIZE);
-    return { ssId: view.getUint32(0, false) };
+    const header = parseHeaderForSourceFecId(mmtpPacket);
+    return header ? sourceFecPayloadIdOf(mmtpPacket, header) : null;
 }
 /**
  * Return true when FEC_type=1 and the exact suffix after the ISO-declared MPU
  * payload contains a four-byte Source FEC Payload ID.
  */
 export function hasSourceFecPayloadId(mmtpPacket) {
+    const header = parseHeaderForSourceFecId(mmtpPacket);
+    return header !== null && sourceFecPayloadIdOf(mmtpPacket, header) !== null;
+}
+function parseHeaderForSourceFecId(mmtpPacket) {
     if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE)
-        return false;
-    let header;
+        return null;
     try {
-        header = parseMMTPHeader(mmtpPacket);
+        return parseMMTPHeader(mmtpPacket);
     }
     catch {
-        return false;
+        return null;
     }
+}
+/**
+ * The Source FEC Payload ID of a packet whose MMTP header the caller already
+ * parsed, or null when the packet carries none: present only when FEC_type=1
+ * and the exact suffix after the ISO-declared MPU payload holds the four-byte
+ * ID (ISO/IEC 23008-1 §C.5.2). Same answer as extractFecPayloadId, without a
+ * second header parse (BLO-36599).
+ *
+ * `header` must be `parseMMTPHeader(mmtpPacket)` of this same packet.
+ */
+export function sourceFecPayloadIdOf(mmtpPacket, header) {
+    if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE)
+        return null;
     if (header.packetType !== PACKET_TYPE_MPU)
-        return false;
+        return null;
     const payload = mmtpPacket.subarray(header.headerLength);
     if (payload.length < MPU_HEADER_SIZE)
-        return false;
-    const mpu = parseMPUHeader(payload);
-    if (mpu.payloadLength < MPU_HEADER_REMAINDER_SIZE)
-        return false;
-    const declaredEnd = MPU_LENGTH_FIELD_SIZE + mpu.payloadLength;
-    return resolveDeclaredTrailers(payload, declaredEnd, header.fecType)?.hasFecId ?? false;
+        return null;
+    const payloadLength = (payload[0] << 8) | payload[1];
+    if (payloadLength < MPU_HEADER_REMAINDER_SIZE)
+        return null;
+    const declaredEnd = MPU_LENGTH_FIELD_SIZE + payloadLength;
+    if (!resolveDeclaredTrailers(payload, declaredEnd, header.fecType)?.hasFecId)
+        return null;
+    // Flat 4-byte SS_ID: encoder writes block_id * K + symbol_id
+    const off = mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE;
+    return {
+        ssId: ((mmtpPacket[off] << 24) |
+            (mmtpPacket[off + 1] << 16) |
+            (mmtpPacket[off + 2] << 8) |
+            mmtpPacket[off + 3]) >>>
+            0,
+    };
 }
 /**
  * MMTP header-extension ext_type assigned to the detached ALTA authenticator
@@ -420,22 +500,34 @@ export const MMTP_EXT_TRAILER_HEADER_SIZE = _LEAF_MMTP_EXT_TRAILER_HEADER_SIZE;
 export const extractAltaTrailer = _leafExtractAltaTrailer;
 /** Size of Repair FEC Payload ID per ISO/IEC 23008-1 Section C.5.3 */
 export const REPAIR_FEC_PID_SIZE = 13;
-/** Parse the 13-byte Repair FEC Payload ID after the complete dynamic MMTP header. */
-function readRepairFecPayloadIdFields(mmtpPacket) {
+/**
+ * Parse the 13-byte Repair FEC Payload ID after the complete dynamic MMTP header.
+ * `parsedHeader`, when given, must be `parseMMTPHeader(mmtpPacket)` of this
+ * same packet; it spares the second header parse (BLO-36599).
+ */
+function readRepairFecPayloadIdFields(mmtpPacket, parsedHeader) {
     let header;
-    try {
-        header = parseMMTPHeader(mmtpPacket);
+    if (parsedHeader) {
+        header = parsedHeader;
     }
-    catch {
-        return null;
+    else {
+        try {
+            header = parseMMTPHeader(mmtpPacket);
+        }
+        catch {
+            return null;
+        }
     }
     if (header.packetType !== PACKET_TYPE_REPAIR || header.fecType !== 2)
         return null;
     const off = header.headerLength;
     if (mmtpPacket.length < off + REPAIR_FEC_PID_SIZE)
         return null;
-    const view = new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + off, REPAIR_FEC_PID_SIZE);
-    const ssStart = view.getUint32(0, false); // 32 bits
+    const ssStart = ((mmtpPacket[off] << 24) |
+        (mmtpPacket[off + 1] << 16) |
+        (mmtpPacket[off + 2] << 8) |
+        mmtpPacket[off + 3]) >>>
+        0; // 32 bits
     const rsbLength = (mmtpPacket[off + 4] << 16) | (mmtpPacket[off + 5] << 8) | mmtpPacket[off + 6]; // 24 bits
     const rsId = (mmtpPacket[off + 7] << 16) | (mmtpPacket[off + 8] << 8) | mmtpPacket[off + 9]; // 24 bits
     const ssbLength = (mmtpPacket[off + 10] << 16) | (mmtpPacket[off + 11] << 8) | mmtpPacket[off + 12]; // 24 bits
@@ -476,14 +568,28 @@ export function extractRepairFecPayloadId(mmtpPacket) {
  *   then SS_Start (4 bytes) → block identifier
  *   then RSB_length (3 bytes) → P
  *   then RS_ID (3 bytes) → ESI = K + RS_ID
- *   then SSB_length (3 bytes) → K
+ *   then SSB_length (3 bytes) → authored source-symbol count (1..=K)
  *   then Repair Symbol Data (T bytes)
  *
  * @param frame - Raw MoQ repair frame bytes
  * @returns Parsed frame or null if invalid
  */
 export function parseMoqRepairFrame(frame) {
-    const repairId = readRepairFecPayloadIdFields(frame);
+    return moqRepairFrameFrom(frame, readRepairFecPayloadIdFields(frame));
+}
+/**
+ * parseMoqRepairFrame for a caller that already holds this frame's parsed MMTP
+ * header, so the header is not parsed a second time (BLO-36599). The router's
+ * multicast repair branch uses it: one repair packet in every K + P otherwise
+ * paid two header parses.
+ *
+ * `header` must be `parseMMTPHeader(frame)` of this same frame; the result is
+ * then identical to `parseMoqRepairFrame(frame)`.
+ */
+export function parseMoqRepairFrameWithHeader(frame, header) {
+    return moqRepairFrameFrom(frame, readRepairFecPayloadIdFields(frame, header));
+}
+function moqRepairFrameFrom(frame, repairId) {
     if (!repairId)
         return null;
     const symbolData = frame.subarray(repairId.dataOffset);
@@ -501,144 +607,6 @@ export function parseMoqRepairFrame(frame) {
         symbolData,
     };
 }
-function canonicalRaptorQOtiK(oti, repairSymbolSize) {
-    if (oti.length !== 12 || oti[5] !== 0)
-        return null;
-    const transferLength = (oti[0] * 0x1_0000_0000) +
-        (((oti[1] << 24) | (oti[2] << 16) | (oti[3] << 8) | oti[4]) >>> 0);
-    const symbolSize = (oti[6] << 8) | oti[7];
-    const sourceBlocks = oti[8];
-    const subBlocks = (oti[9] << 8) | oti[10];
-    const alignment = oti[11];
-    if (!Number.isSafeInteger(transferLength) || transferLength <= 0 ||
-        symbolSize !== repairSymbolSize || symbolSize === 0 || symbolSize % 8 !== 0 ||
-        sourceBlocks !== 1 || subBlocks !== 1 || alignment !== 8 ||
-        transferLength % symbolSize !== 0) {
-        return null;
-    }
-    const k = transferLength / symbolSize;
-    return Number.isInteger(k) && k >= 1 && k <= 56_403 ? k : null;
-}
-/**
- * Parse AL-FEC signaling message from a full MMTP signaling packet.
- *
- * Wire format (ISO/IEC 23008-1:2023 Table C.3, Amendment 1:2025):
- *   [12-byte MMTP header (packet_type=0x02)]
- *   message_id(2)        = 0x0203
- *   version(1)
- *   message_length(2)    = length of remaining payload
- *   flags(1)             = fec_flag(1) | private_fec_flag(1) | reserved(6)
- *   fec_flow_descriptor:
- *     length(2)
- *     num_flows(1)
- *     per flow:
- *       fec_flow_id(1), source_flow_id(1), num_assets(1), packet_ids(2*N),
- *       coding_params(1), repair_symbol_size(2),
- *       [one-stage]: repair_flow_id(2), fec_code_id(1),
- *       [private_fec_flag]: private_header(1){flag(1)|len(7)},
- *         current RaptorQ profile OTI(12) + interleave_depth(1)
- *       max_k(3), max_p(3), protection_window_time(4), protection_window_size(4)
- *
- * @param mmtpPacket Full MMTP packet including 12-byte header
- * @returns Parsed config or null if not an AL-FEC signaling message
- */
-export function parseAlFecMessage(mmtpPacket) {
-    if (mmtpPacket.length < MMTP_HEADER_SIZE + 9)
-        return null;
-    let header;
-    try {
-        header = parseMMTPHeader(mmtpPacket);
-    }
-    catch {
-        return null;
-    }
-    if (header.packetType !== PACKET_TYPE_SIGNALING || header.fecType !== 0)
-        return null;
-    const payload = mmtpPacket.subarray(header.headerLength);
-    if (payload.length < 9)
-        return null;
-    const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);
-    let off = 0;
-    const messageId = view.getUint16(off, false);
-    off += 2;
-    if (messageId !== ALFEC_MESSAGE_ID)
-        return null;
-    const version = payload[off];
-    off += 1;
-    const messageLength = view.getUint16(off, false);
-    off += 2;
-    if (version !== 1 || messageLength === 0 || messageLength !== payload.length - off)
-        return null;
-    const flags = payload[off];
-    off += 1;
-    const fecFlag = (flags >> 7) & 1;
-    const privateFecFlag = (flags >> 6) & 1;
-    if (fecFlag !== 1 || privateFecFlag !== 1 || (flags & 0x3f) !== 0x3f)
-        return null;
-    if (off + 2 > payload.length)
-        return null;
-    const descriptorLength = view.getUint16(off, false);
-    off += 2;
-    const descriptorEnd = off + descriptorLength;
-    if (descriptorLength === 0 || descriptorEnd !== payload.length)
-        return null;
-    const numFlows = payload[off];
-    off += 1;
-    if (numFlows !== 1 || off + 3 > descriptorEnd)
-        return null;
-    off += 2; // fec_flow_id, source_flow_id
-    const numAssets = payload[off];
-    off += 1;
-    if (numAssets === 0 || off + (numAssets * 2) > descriptorEnd)
-        return null;
-    off += numAssets * 2;
-    if (off + 3 > descriptorEnd)
-        return null;
-    const codingParams = payload[off];
-    off += 1;
-    const fecCodingStructure = (codingParams >> 4) & 0x0f;
-    const ssbgMode = (codingParams >> 2) & 0x03;
-    const ffsrptsFlag = (codingParams >> 1) & 0x01;
-    const fecPayloadIdMode = codingParams & 0x01;
-    if (fecCodingStructure !== 1 || ssbgMode !== 0 || ffsrptsFlag !== 0 || fecPayloadIdMode !== 0) {
-        return null;
-    }
-    const repairSymbolSize = view.getUint16(off, false);
-    off += 2;
-    if (repairSymbolSize === 0 || repairSymbolSize % 8 !== 0)
-        return null;
-    if (off + 4 > descriptorEnd)
-        return null;
-    off += 2; // Amendment 1:2025 replaces Table C.3 with a 16-bit repair_flow_id
-    const fecCodeId = payload[off];
-    off += 1;
-    if (fecCodeId !== FEC_CODE_RAPTORQ)
-        return null;
-    const privateHeader = payload[off];
-    off += 1;
-    const privateFlag = privateHeader >> 7;
-    const privateFieldLength = privateHeader & 0x7f;
-    if (privateFlag !== 1 || privateFieldLength !== 13 || off + 13 > descriptorEnd)
-        return null;
-    const oti = payload.slice(off, off + 12);
-    off += 12;
-    const interleaveDepth = payload[off];
-    off += 1;
-    const otiK = canonicalRaptorQOtiK(oti, repairSymbolSize);
-    if (otiK === null || interleaveDepth === 0)
-        return null;
-    if (off + 14 !== descriptorEnd)
-        return null;
-    const maximumK = (payload[off] << 16) | (payload[off + 1] << 8) | payload[off + 2];
-    off += 3;
-    const maximumP = (payload[off] << 16) | (payload[off + 1] << 8) | payload[off + 2];
-    off += 3;
-    if (maximumK !== otiK || maximumP === 0 || maximumK + maximumP - 1 > 0x00ff_ffff) {
-        return null;
-    }
-    off += 8; // protection_window_time, protection_window_size
-    if (off !== descriptorEnd)
-        return null;
-    return { fecCodeId, fecPayloadIdMode, repairSymbolSize, maximumK, maximumP, interleaveDepth, oti };
-}
+// The signalling-message parsers (9.3.4.2 payload header, AL-FEC message,
+// PA/MPT) live in ./signalling.ts.
 //# sourceMappingURL=mmtp.js.map