@blockcast/mmt-container 0.1.0 → 0.3.0-main.0bde85f7082f

package/dist/iso-bmff-timing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/iso-bmff-timing.ts"],
+  "sourcesContent": ["/**\n * Strict ISO-BMFF timing extraction for the timed-MFU browser path.\n *\n * This intentionally implements only the current single-track MMT profile:\n * one media track in FT=0, and one matching traf/trun in each FT=1.  It does\n * not infer timing from packet arrival, MMTP send timestamps, or cadence.\n */\n\nconst U64_MAX = 0xffff_ffff_ffff_ffffn\nconst I64_MIN = -0x8000_0000_0000_0000n\nconst I64_MAX = 0x7fff_ffff_ffff_ffffn\nconst MICROSECONDS_PER_SECOND = 1_000_000n\n\nconst TFHD_BASE_DATA_OFFSET_PRESENT = 0x000001\nconst TFHD_SAMPLE_DESCRIPTION_INDEX_PRESENT = 0x000002\nconst TFHD_DEFAULT_SAMPLE_DURATION_PRESENT = 0x000008\nconst TFHD_DEFAULT_SAMPLE_SIZE_PRESENT = 0x000010\nconst TFHD_DEFAULT_SAMPLE_FLAGS_PRESENT = 0x000020\nconst TFHD_DURATION_IS_EMPTY = 0x010000\nconst TFHD_DEFAULT_BASE_IS_MOOF = 0x020000\nconst TFHD_KNOWN_FLAGS =\n  TFHD_BASE_DATA_OFFSET_PRESENT |\n  TFHD_SAMPLE_DESCRIPTION_INDEX_PRESENT |\n  TFHD_DEFAULT_SAMPLE_DURATION_PRESENT |\n  TFHD_DEFAULT_SAMPLE_SIZE_PRESENT |\n  TFHD_DEFAULT_SAMPLE_FLAGS_PRESENT |\n  TFHD_DURATION_IS_EMPTY |\n  TFHD_DEFAULT_BASE_IS_MOOF\n\nconst TRUN_DATA_OFFSET_PRESENT = 0x000001\nconst TRUN_FIRST_SAMPLE_FLAGS_PRESENT = 0x000004\nconst TRUN_SAMPLE_DURATION_PRESENT = 0x000100\nconst TRUN_SAMPLE_SIZE_PRESENT = 0x000200\nconst TRUN_SAMPLE_FLAGS_PRESENT = 0x000400\nconst TRUN_SAMPLE_CTS_OFFSET_PRESENT = 0x000800\nconst TRUN_KNOWN_FLAGS =\n  TRUN_DATA_OFFSET_PRESENT |\n  TRUN_FIRST_SAMPLE_FLAGS_PRESENT |\n  TRUN_SAMPLE_DURATION_PRESENT |\n  TRUN_SAMPLE_SIZE_PRESENT |\n  TRUN_SAMPLE_FLAGS_PRESENT |\n  TRUN_SAMPLE_CTS_OFFSET_PRESENT\n\nexport interface IsoBmffTrackTiming {\n  trackId: number\n  timescale: number\n  defaultSampleDuration?: number\n  defaultSampleSize?: number\n}\n\nexport interface IsoBmffSampleTiming {\n  /** Exact decode time in mdhd timescale units. */\n  decodeTime: bigint\n  /** Exact presentation time in mdhd timescale units, including signed CTS. */\n  presentationTime: bigint\n  /** Exact authored duration in mdhd timescale units. */\n  duration: number\n  timescale: number\n  /** Exact elementary-stream sample size declared by trun/tfhd/trex. */\n  size: number\n  /** Byte position of the sample relative to the beginning of the moof. */\n  bytePosition: bigint\n}\n\nexport interface IsoBmffMovieFragmentTiming {\n  movieFragmentSequenceNumber: number\n  samples: readonly IsoBmffSampleTiming[]\n}\n\nexport type IsoBmffMovieFragmentRejection = 'invalid' | 'budget'\n\ninterface IsoBox {\n  type: string\n  start: number\n  bodyStart: number\n  end: number\n}\n\ninterface FullBox {\n  version: number\n  flags: number\n  bodyStart: number\n}\n\ninterface ParsedTrack {\n  trackId: number\n  handlerType: string\n  timescale: number\n  hasEdits: boolean\n}\n\ninterface ParsedTfhd {\n  trackId: number\n  defaultSampleDuration?: number\n  defaultSampleSize?: number\n}\n\ninterface MdatLayout {\n  dataStart: bigint\n  declaredEnd: bigint\n}\n\nfunction view(data: Uint8Array): DataView {\n  return new DataView(data.buffer, data.byteOffset, data.byteLength)\n}\n\nfunction boxType(data: Uint8Array, offset: number): string {\n  return String.fromCharCode(\n    data[offset]!,\n    data[offset + 1]!,\n    data[offset + 2]!,\n    data[offset + 3]!,\n  )\n}\n\nfunction readU64(data: Uint8Array, offset: number): bigint | null {\n  if (offset < 0 || offset + 8 > data.length) return null\n  const dataView = view(data)\n  return (BigInt(dataView.getUint32(offset, false)) << 32n) |\n    BigInt(dataView.getUint32(offset + 4, false))\n}\n\nfunction parseBox(data: Uint8Array, start: number, limit: number): IsoBox | null {\n  if (start < 0 || limit > data.length || start + 8 > limit) return null\n  const dataView = view(data)\n  const shortSize = dataView.getUint32(start, false)\n  let headerSize = 8\n  let size: number\n  if (shortSize === 0) {\n    size = limit - start\n  } else if (shortSize === 1) {\n    if (start + 16 > limit) return null\n    const extendedSize = readU64(data, start + 8)\n    if (extendedSize === null || extendedSize > BigInt(Number.MAX_SAFE_INTEGER)) return null\n    headerSize = 16\n    size = Number(extendedSize)\n  } else {\n    size = shortSize\n  }\n  if (size < headerSize || start + size > limit) return null\n  return {\n    type: boxType(data, start + 4),\n    start,\n    bodyStart: start + headerSize,\n    end: start + size,\n  }\n}\n\nfunction parseBoxes(data: Uint8Array, start: number, end: number): IsoBox[] | null {\n  if (start < 0 || end < start || end > data.length) return null\n  const boxes: IsoBox[] = []\n  let offset = start\n  while (offset < end) {\n    const box = parseBox(data, offset, end)\n    if (!box || box.end <= offset) return null\n    boxes.push(box)\n    offset = box.end\n  }\n  return offset === end ? boxes : null\n}\n\nfunction children(data: Uint8Array, parent: IsoBox): IsoBox[] | null {\n  return parseBoxes(data, parent.bodyStart, parent.end)\n}\n\nfunction exactlyOne(boxes: readonly IsoBox[], type: string): IsoBox | null {\n  const matches = boxes.filter(box => box.type === type)\n  return matches.length === 1 ? matches[0]! : null\n}\n\nfunction parseFullBox(data: Uint8Array, box: IsoBox): FullBox | null {\n  if (box.bodyStart + 4 > box.end) return null\n  const versionAndFlags = view(data).getUint32(box.bodyStart, false)\n  return {\n    version: versionAndFlags >>> 24,\n    flags: versionAndFlags & 0x00ff_ffff,\n    bodyStart: box.bodyStart + 4,\n  }\n}\n\nfunction parseTkhdTrackId(data: Uint8Array, box: IsoBox): number | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.flags & ~0x00000f) return null\n  const bodyLength = box.end - full.bodyStart\n  const trackIdOffset = full.version === 0\n    ? full.bodyStart + 8\n    : full.version === 1\n      ? full.bodyStart + 16\n      : -1\n  const expectedBodyLength = full.version === 0 ? 80 : full.version === 1 ? 92 : -1\n  if (trackIdOffset < 0 || bodyLength !== expectedBodyLength) return null\n  return view(data).getUint32(trackIdOffset, false)\n}\n\nfunction parseMdhdTimescale(data: Uint8Array, box: IsoBox): number | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.flags !== 0) return null\n  const bodyLength = box.end - full.bodyStart\n  const timescaleOffset = full.version === 0\n    ? full.bodyStart + 8\n    : full.version === 1\n      ? full.bodyStart + 16\n      : -1\n  const expectedBodyLength = full.version === 0 ? 20 : full.version === 1 ? 32 : -1\n  if (timescaleOffset < 0 || bodyLength !== expectedBodyLength) return null\n  return view(data).getUint32(timescaleOffset, false)\n}\n\nfunction parseHandlerType(data: Uint8Array, box: IsoBox): string | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.version !== 0 || full.flags !== 0 || full.bodyStart + 20 > box.end) {\n    return null\n  }\n  return boxType(data, full.bodyStart + 4)\n}\n\nfunction editListHasEntries(data: Uint8Array, box: IsoBox): boolean | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.flags !== 0 || (full.version !== 0 && full.version !== 1)) return null\n  if (full.bodyStart + 4 > box.end) return null\n  const entryCount = view(data).getUint32(full.bodyStart, false)\n  const entrySize = full.version === 0 ? 12 : 20\n  const expectedEnd = full.bodyStart + 4 + entryCount * entrySize\n  if (!Number.isSafeInteger(expectedEnd) || expectedEnd !== box.end) return null\n  return entryCount !== 0\n}\n\nfunction parseTrack(data: Uint8Array, trak: IsoBox): ParsedTrack | null {\n  const trakChildren = children(data, trak)\n  if (!trakChildren) return null\n  const tkhd = exactlyOne(trakChildren, 'tkhd')\n  const mdia = exactlyOne(trakChildren, 'mdia')\n  if (!tkhd || !mdia) return null\n  const trackId = parseTkhdTrackId(data, tkhd)\n  if (trackId === null || trackId === 0) return null\n\n  const mdiaChildren = children(data, mdia)\n  if (!mdiaChildren) return null\n  const mdhd = exactlyOne(mdiaChildren, 'mdhd')\n  const hdlr = exactlyOne(mdiaChildren, 'hdlr')\n  if (!mdhd || !hdlr) return null\n  const timescale = parseMdhdTimescale(data, mdhd)\n  const handlerType = parseHandlerType(data, hdlr)\n  if (timescale === null || timescale === 0 || handlerType === null) return null\n\n  const edtsBoxes = trakChildren.filter(box => box.type === 'edts')\n  if (edtsBoxes.length > 1) return null\n  let hasEdits = false\n  if (edtsBoxes.length === 1) {\n    const edtsChildren = children(data, edtsBoxes[0]!)\n    if (!edtsChildren) return null\n    const editLists = edtsChildren.filter(box => box.type === 'elst')\n    if (editLists.length > 1) return null\n    if (editLists.length === 1) {\n      const result = editListHasEntries(data, editLists[0]!)\n      if (result === null) return null\n      hasEdits = result\n    }\n  }\n\n  return { trackId, handlerType, timescale, hasEdits }\n}\n\nfunction parseTrex(data: Uint8Array, box: IsoBox): IsoBmffTrackTiming | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.version !== 0 || full.flags !== 0 || box.end - full.bodyStart !== 20) {\n    return null\n  }\n  const dataView = view(data)\n  const trackId = dataView.getUint32(full.bodyStart, false)\n  const defaultSampleDuration = dataView.getUint32(full.bodyStart + 8, false)\n  const defaultSampleSize = dataView.getUint32(full.bodyStart + 12, false)\n  return {\n    trackId,\n    timescale: 0,\n    ...(defaultSampleDuration === 0 ? {} : { defaultSampleDuration }),\n    ...(defaultSampleSize === 0 ? {} : { defaultSampleSize }),\n  }\n}\n\nexport function parseIsoBmffInitializationTiming(\n  data: Uint8Array,\n): IsoBmffTrackTiming | null {\n  const topLevel = parseBoxes(data, 0, data.length)\n  if (!topLevel) return null\n  const ftyp = exactlyOne(topLevel, 'ftyp')\n  const moov = exactlyOne(topLevel, 'moov')\n  if (!ftyp || !moov || ftyp.start > moov.start) return null\n  if (topLevel.some(box => box.type === 'moof' || box.type === 'mdat')) return null\n\n  const moovChildren = children(data, moov)\n  if (!moovChildren) return null\n  const parsedTracks: ParsedTrack[] = []\n  for (const trak of moovChildren.filter(box => box.type === 'trak')) {\n    const parsed = parseTrack(data, trak)\n    if (!parsed) return null\n    parsedTracks.push(parsed)\n  }\n  const mediaTracks = parsedTracks.filter(\n    track => track.handlerType === 'vide' || track.handlerType === 'soun',\n  )\n  if (mediaTracks.length !== 1) return null\n  const mediaTrack = mediaTracks[0]!\n  if (mediaTrack.hasEdits) return null\n\n  const mvex = exactlyOne(moovChildren, 'mvex')\n  if (!mvex) return null\n  const mvexChildren = children(data, mvex)\n  if (!mvexChildren) return null\n  const trexEntries: IsoBmffTrackTiming[] = []\n  for (const trexBox of mvexChildren.filter(box => box.type === 'trex')) {\n    const trex = parseTrex(data, trexBox)\n    if (!trex) return null\n    trexEntries.push(trex)\n  }\n  const matchingTrex = trexEntries.filter(trex => trex.trackId === mediaTrack.trackId)\n  if (matchingTrex.length !== 1) return null\n  const trex = matchingTrex[0]!\n  return {\n    trackId: mediaTrack.trackId,\n    timescale: mediaTrack.timescale,\n    ...(trex.defaultSampleDuration === undefined\n      ? {}\n      : { defaultSampleDuration: trex.defaultSampleDuration }),\n    ...(trex.defaultSampleSize === undefined\n      ? {}\n      : { defaultSampleSize: trex.defaultSampleSize }),\n  }\n}\n\nfunction parseMfhdSequence(data: Uint8Array, box: IsoBox): number | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.version !== 0 || full.flags !== 0 || box.end - full.bodyStart !== 4) {\n    return null\n  }\n  return view(data).getUint32(full.bodyStart, false)\n}\n\nfunction parseTfhd(data: Uint8Array, box: IsoBox): ParsedTfhd | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.version !== 0 || (full.flags & ~TFHD_KNOWN_FLAGS) !== 0) return null\n  if ((full.flags & TFHD_BASE_DATA_OFFSET_PRESENT) !== 0 ||\n      (full.flags & TFHD_DEFAULT_BASE_IS_MOOF) === 0 ||\n      (full.flags & TFHD_DURATION_IS_EMPTY) !== 0) {\n    return null\n  }\n  const dataView = view(data)\n  let offset = full.bodyStart\n  if (offset + 4 > box.end) return null\n  const trackId = dataView.getUint32(offset, false)\n  offset += 4\n  if ((full.flags & TFHD_SAMPLE_DESCRIPTION_INDEX_PRESENT) !== 0) {\n    if (offset + 4 > box.end) return null\n    offset += 4\n  }\n  let defaultSampleDuration: number | undefined\n  if ((full.flags & TFHD_DEFAULT_SAMPLE_DURATION_PRESENT) !== 0) {\n    if (offset + 4 > box.end) return null\n    defaultSampleDuration = dataView.getUint32(offset, false)\n    offset += 4\n  }\n  let defaultSampleSize: number | undefined\n  if ((full.flags & TFHD_DEFAULT_SAMPLE_SIZE_PRESENT) !== 0) {\n    if (offset + 4 > box.end) return null\n    defaultSampleSize = dataView.getUint32(offset, false)\n    offset += 4\n  }\n  if ((full.flags & TFHD_DEFAULT_SAMPLE_FLAGS_PRESENT) !== 0) {\n    if (offset + 4 > box.end) return null\n    offset += 4\n  }\n  if (offset !== box.end) return null\n  return {\n    trackId,\n    ...(defaultSampleDuration === undefined ? {} : { defaultSampleDuration }),\n    ...(defaultSampleSize === undefined ? {} : { defaultSampleSize }),\n  }\n}\n\nfunction parseTfdt(data: Uint8Array, box: IsoBox): bigint | null {\n  const full = parseFullBox(data, box)\n  if (!full || full.flags !== 0) return null\n  if (full.version === 0 && box.end - full.bodyStart === 4) {\n    return BigInt(view(data).getUint32(full.bodyStart, false))\n  }\n  if (full.version === 1 && box.end - full.bodyStart === 8) {\n    return readU64(data, full.bodyStart)\n  }\n  return null\n}\n\nfunction parseMdatLayout(data: Uint8Array, offset: number): MdatLayout | null {\n  if (offset < 0 || offset + 8 > data.length || boxType(data, offset + 4) !== 'mdat') return null\n  const dataView = view(data)\n  const shortSize = dataView.getUint32(offset, false)\n  let headerSize = 8\n  let declaredSize: bigint\n  if (shortSize === 0) {\n    return null\n  } else if (shortSize === 1) {\n    const extended = readU64(data, offset + 8)\n    if (extended === null) return null\n    headerSize = 16\n    declaredSize = extended\n  } else {\n    declaredSize = BigInt(shortSize)\n  }\n  if (declaredSize < BigInt(headerSize) || declaredSize < BigInt(data.length - offset)) {\n    return null\n  }\n  const declaredEnd = BigInt(offset) + declaredSize\n  if (declaredEnd > U64_MAX) return null\n  return { dataStart: BigInt(offset + headerSize), declaredEnd }\n}\n\nfunction resolvedDefault(\n  entryValue: number | undefined,\n  tfhdValue: number | undefined,\n  trexValue: number | undefined,\n): number | null {\n  const value = entryValue ?? tfhdValue ?? trexValue\n  return value === undefined || value === 0 ? null : value\n}\n\nfunction parseTrunSamples(\n  data: Uint8Array,\n  box: IsoBox,\n  moofStart: number,\n  baseDecodeTime: bigint,\n  tfhd: ParsedTfhd,\n  track: IsoBmffTrackTiming,\n  mdat: MdatLayout,\n  maxSamples: number,\n): IsoBmffSampleTiming[] | null {\n  const full = parseFullBox(data, box)\n  if (!full || (full.version !== 0 && full.version !== 1) ||\n      (full.flags & ~TRUN_KNOWN_FLAGS) !== 0 ||\n      (full.flags & TRUN_DATA_OFFSET_PRESENT) === 0 ||\n      ((full.flags & TRUN_FIRST_SAMPLE_FLAGS_PRESENT) !== 0 &&\n        (full.flags & TRUN_SAMPLE_FLAGS_PRESENT) !== 0)) {\n    return null\n  }\n  const dataView = view(data)\n  let offset = full.bodyStart\n  if (offset + 8 > box.end) return null\n  const sampleCount = dataView.getUint32(offset, false)\n  offset += 4\n  if (sampleCount === 0 || sampleCount > maxSamples) return null\n  const relativeDataOffset = dataView.getInt32(offset, false)\n  offset += 4\n  if (relativeDataOffset < 0) return null\n  const dataOffset = BigInt(relativeDataOffset)\n  const absoluteDataOffset = BigInt(moofStart) + dataOffset\n  if (absoluteDataOffset > BigInt(data.length) || absoluteDataOffset < mdat.dataStart) return null\n  if ((full.flags & TRUN_FIRST_SAMPLE_FLAGS_PRESENT) !== 0) {\n    if (offset + 4 > box.end) return null\n    offset += 4\n  }\n\n  let decodeTime = baseDecodeTime\n  let bytePosition = dataOffset\n  const samples: IsoBmffSampleTiming[] = []\n  for (let index = 0; index < sampleCount; index++) {\n    let entryDuration: number | undefined\n    if ((full.flags & TRUN_SAMPLE_DURATION_PRESENT) !== 0) {\n      if (offset + 4 > box.end) return null\n      entryDuration = dataView.getUint32(offset, false)\n      offset += 4\n    }\n    let entrySize: number | undefined\n    if ((full.flags & TRUN_SAMPLE_SIZE_PRESENT) !== 0) {\n      if (offset + 4 > box.end) return null\n      entrySize = dataView.getUint32(offset, false)\n      offset += 4\n    }\n    if ((full.flags & TRUN_SAMPLE_FLAGS_PRESENT) !== 0) {\n      if (offset + 4 > box.end) return null\n      offset += 4\n    }\n    let compositionOffset = 0\n    if ((full.flags & TRUN_SAMPLE_CTS_OFFSET_PRESENT) !== 0) {\n      if (offset + 4 > box.end) return null\n      compositionOffset = full.version === 1\n        ? dataView.getInt32(offset, false)\n        : dataView.getUint32(offset, false)\n      offset += 4\n    }\n    if (offset > box.end) return null\n\n    const duration = resolvedDefault(\n      entryDuration,\n      tfhd.defaultSampleDuration,\n      track.defaultSampleDuration,\n    )\n    const size = resolvedDefault(entrySize, tfhd.defaultSampleSize, track.defaultSampleSize)\n    if (duration === null || size === null) return null\n    const sampleEnd = bytePosition + BigInt(size)\n    const absoluteSampleEnd = BigInt(moofStart) + sampleEnd\n    if (absoluteSampleEnd > mdat.declaredEnd || absoluteSampleEnd > U64_MAX) return null\n    const presentationTime = decodeTime + BigInt(compositionOffset)\n    if (presentationTime < I64_MIN || presentationTime > I64_MAX) return null\n    samples.push({\n      decodeTime,\n      presentationTime,\n      duration,\n      timescale: track.timescale,\n      size,\n      bytePosition,\n    })\n    decodeTime += BigInt(duration)\n    if (decodeTime > U64_MAX) return null\n    bytePosition = sampleEnd\n  }\n  return offset === box.end ? samples : null\n}\n\nexport function parseIsoBmffMovieFragmentTiming(\n  data: Uint8Array,\n  track: IsoBmffTrackTiming,\n  maxSamples: number,\n): IsoBmffMovieFragmentTiming | null {\n  if (!Number.isInteger(maxSamples) || maxSamples <= 0) return null\n  const first = parseBox(data, 0, data.length)\n  if (!first) return null\n  const moof = first.type === 'styp'\n    ? parseBox(data, first.end, data.length)\n    : first\n  if (!moof || moof.type !== 'moof' || moof.end >= data.length) return null\n  const moofChildren = children(data, moof)\n  if (!moofChildren) return null\n  const mfhd = exactlyOne(moofChildren, 'mfhd')\n  const traf = exactlyOne(moofChildren, 'traf')\n  if (!mfhd || !traf) return null\n  const movieFragmentSequenceNumber = parseMfhdSequence(data, mfhd)\n  if (movieFragmentSequenceNumber === null || movieFragmentSequenceNumber === 0) return null\n\n  const trafChildren = children(data, traf)\n  if (!trafChildren) return null\n  const tfhdBox = exactlyOne(trafChildren, 'tfhd')\n  const tfdtBox = exactlyOne(trafChildren, 'tfdt')\n  const trunBox = exactlyOne(trafChildren, 'trun')\n  if (!tfhdBox || !tfdtBox || !trunBox) return null\n  const tfhd = parseTfhd(data, tfhdBox)\n  const baseDecodeTime = parseTfdt(data, tfdtBox)\n  if (!tfhd || tfhd.trackId !== track.trackId || baseDecodeTime === null) return null\n  const mdat = parseMdatLayout(data, moof.end)\n  if (!mdat) return null\n  const samples = parseTrunSamples(\n    data,\n    trunBox,\n    moof.start,\n    baseDecodeTime,\n    tfhd,\n    track,\n    mdat,\n    maxSamples,\n  )\n  if (!samples) return null\n  return { movieFragmentSequenceNumber, samples }\n}\n\nfunction sameTrack(a: IsoBmffTrackTiming, b: IsoBmffTrackTiming): boolean {\n  return a.trackId === b.trackId &&\n    a.timescale === b.timescale &&\n    a.defaultSampleDuration === b.defaultSampleDuration &&\n    a.defaultSampleSize === b.defaultSampleSize\n}\n\nfunction sameSample(a: IsoBmffSampleTiming, b: IsoBmffSampleTiming): boolean {\n  return a.decodeTime === b.decodeTime &&\n    a.presentationTime === b.presentationTime &&\n    a.duration === b.duration &&\n    a.timescale === b.timescale &&\n    a.size === b.size &&\n    a.bytePosition === b.bytePosition\n}\n\ntype PendingMovieFragment = Array<IsoBmffSampleTiming | null>\n\n/** Bounded per-track FT=0/FT=1 timing state. */\nexport class IsoBmffTimingResolver {\n  #track: IsoBmffTrackTiming | null = null\n  #fragments = new Map<string, PendingMovieFragment>()\n  #pendingSamples = 0\n  #evictedSamples = 0\n  #lastMovieFragmentRejection: IsoBmffMovieFragmentRejection | null = null\n\n  constructor(readonly maxPendingSamples: number) {\n    if (!Number.isInteger(maxPendingSamples) || maxPendingSamples <= 0) {\n      throw new Error('[IsoBmffTimingResolver] maxPendingSamples must be a positive integer')\n    }\n  }\n\n  get pendingSampleCount(): number {\n    return this.#pendingSamples\n  }\n\n  /**\n   * Slots reclaimed by window displacement rather than by delivery or\n   * abandonment. Deliberately separate from the combiner's own release count:\n   * \"nobody ever saw this sample\" and \"the combiner gave up on it\" are\n   * different failures with different owners, and one number cannot say which.\n   */\n  get evictedSampleCount(): number {\n    return this.#evictedSamples\n  }\n\n  /** Typed reason for the most recent rejected movie fragment. */\n  get lastMovieFragmentRejection(): IsoBmffMovieFragmentRejection | null {\n    return this.#lastMovieFragmentRejection\n  }\n\n  addInitialization(data: Uint8Array): boolean {\n    const timing = parseIsoBmffInitializationTiming(data)\n    if (!timing) return false\n    if (this.#track) return sameTrack(this.#track, timing)\n    this.#track = timing\n    return true\n  }\n\n  addMovieFragment(\n    mpuSequenceNumber: number,\n    data: Uint8Array,\n    additionalSampleLimit = this.maxPendingSamples,\n  ): boolean {\n    this.#lastMovieFragmentRejection = null\n    if (!Number.isInteger(additionalSampleLimit) || additionalSampleLimit < 0) {\n      this.#lastMovieFragmentRejection = 'invalid'\n      return false\n    }\n    if (!this.#track || !isU32(mpuSequenceNumber)) {\n      this.#lastMovieFragmentRejection = 'invalid'\n      return false\n    }\n    const parsed = parseIsoBmffMovieFragmentTiming(\n      data,\n      this.#track,\n      this.maxPendingSamples,\n    )\n    if (!parsed) {\n      this.#lastMovieFragmentRejection = 'invalid'\n      return false\n    }\n    const key = fragmentKey(mpuSequenceNumber, parsed.movieFragmentSequenceNumber)\n    const existing = this.#fragments.get(key)\n    if (existing) {\n      return existing.length === parsed.samples.length && existing.every(\n        (sample, index) => sample !== null && sameSample(sample, parsed.samples[index]!),\n      )\n    }\n    // Sliding window, not a one-way ratchet. `consumeSample` and\n    // `releaseSample` between them cover every sample some component observed\n    // -- but a sample whose data units never arrive at all is observed by\n    // nobody, so neither path ever runs and its slot is held until `reset()`.\n    // Under sustained loss those orphans accumulate until the budget is full\n    // of samples that can never arrive, at which point every later moof is\n    // refused and media stops permanently with no error.\n    //\n    // Displacement is the signal no component can raise: once the budget is\n    // full and a newer fragment is in hand, the oldest pending fragment's\n    // samples are older than the whole window and cannot still be in flight.\n    // Reclaiming them keeps the timing that is arriving now and discards the\n    // timing that is not; refusing the new fragment does exactly the reverse,\n    // which is what wedged the stream. Evicted timing is not silent loss --\n    // a late data unit then finds no entry and is dropped against a named\n    // reason, which is attributable, bounded, and recoverable.\n    let freed = 0\n    while (\n      this.#fragments.size > 0 &&\n      (this.#pendingSamples + parsed.samples.length > this.maxPendingSamples ||\n        parsed.samples.length - freed > additionalSampleLimit)\n    ) {\n      freed += this.#evictOldestFragment()\n    }\n    // Net new charge against the caller's pool is what it must afford: `freed`\n    // slots were already counted there and are handed back by this call.\n    if (parsed.samples.length - freed > additionalSampleLimit) {\n      this.#lastMovieFragmentRejection = 'budget'\n      return false\n    }\n    if (this.#pendingSamples + parsed.samples.length > this.maxPendingSamples) {\n      this.#lastMovieFragmentRejection = 'budget'\n      return false\n    }\n    this.#fragments.set(key, [...parsed.samples])\n    this.#pendingSamples += parsed.samples.length\n    return true\n  }\n\n  sampleTiming(\n    mpuSequenceNumber: number,\n    movieFragmentSequenceNumber: number,\n    sampleNumber: number,\n  ): IsoBmffSampleTiming | null {\n    if (!isU32(mpuSequenceNumber) || !isU32(movieFragmentSequenceNumber) ||\n        movieFragmentSequenceNumber === 0 || !isU32(sampleNumber) || sampleNumber === 0) {\n      return null\n    }\n    const samples = this.#fragments.get(\n      fragmentKey(mpuSequenceNumber, movieFragmentSequenceNumber),\n    )\n    return samples?.[sampleNumber - 1] ?? null\n  }\n\n  consumeSample(\n    mpuSequenceNumber: number,\n    movieFragmentSequenceNumber: number,\n    sampleNumber: number,\n    expected: IsoBmffSampleTiming,\n  ): boolean {\n    const samples = this.#fragments.get(\n      fragmentKey(mpuSequenceNumber, movieFragmentSequenceNumber),\n    )\n    const sample = samples?.[sampleNumber - 1]\n    if (!sample || !sameSample(sample, expected)) return false\n    return this.#clearSlot(mpuSequenceNumber, movieFragmentSequenceNumber, sampleNumber)\n  }\n\n  /**\n   * Free the budget slot of a sample that will never be delivered.\n   *\n   * `consumeSample` is the delivery path and is the only decrement on a\n   * healthy stream. A sample whose data units never complete is never\n   * delivered; window displacement in `addMovieFragment` eventually reclaims\n   * it, but only after it has aged out of the whole window. This path frees\n   * the slot as soon as the combiner knows the sample is gone, so the budget\n   * tracks what is actually in flight rather than what has merely aged.\n   *\n   * The caller is whoever abandoned the sample, so the release is driven by\n   * the abandonment itself rather than by a timer, an LRU, or an age bound --\n   * the slot is freed exactly when its sample provably cannot arrive, which\n   * is a protocol event the combiner already detects and counts.\n   *\n   * Deliberately takes no `expected` timing: the caller is discarding, not\n   * matching, and requiring it would make the release fail exactly when the\n   * timing entry is the thing being reclaimed. Returns false when the slot\n   * was already freed, so a double release cannot drive the count negative.\n   */\n  releaseSample(\n    mpuSequenceNumber: number,\n    movieFragmentSequenceNumber: number,\n    sampleNumber: number,\n  ): boolean {\n    return this.#clearSlot(mpuSequenceNumber, movieFragmentSequenceNumber, sampleNumber)\n  }\n\n  /**\n   * Drop the oldest pending fragment whole and return the slots it held.\n   *\n   * Oldest is insertion order, which for a moof stream is arrival order, so\n   * this is the least-recently-declared timing -- the entries least likely to\n   * still have data units in flight.\n   */\n  #evictOldestFragment(): number {\n    const oldest = this.#fragments.keys().next().value\n    if (oldest === undefined) return 0\n    const samples = this.#fragments.get(oldest)!\n    let live = 0\n    for (const sample of samples) if (sample !== null) live++\n    this.#fragments.delete(oldest)\n    this.#pendingSamples -= live\n    this.#evictedSamples += live\n    return live\n  }\n\n  /** Null one slot, decrement the budget, and drop the fragment when empty. */\n  #clearSlot(\n    mpuSequenceNumber: number,\n    movieFragmentSequenceNumber: number,\n    sampleNumber: number,\n  ): boolean {\n    if (!isU32(mpuSequenceNumber) || !isU32(movieFragmentSequenceNumber) ||\n        movieFragmentSequenceNumber === 0 || !isU32(sampleNumber) || sampleNumber === 0) {\n      return false\n    }\n    const key = fragmentKey(mpuSequenceNumber, movieFragmentSequenceNumber)\n    const samples = this.#fragments.get(key)\n    const index = sampleNumber - 1\n    if (!samples || !samples[index]) return false\n    samples[index] = null\n    this.#pendingSamples--\n    if (samples.every(value => value === null)) this.#fragments.delete(key)\n    return true\n  }\n\n  reset(): void {\n    this.#track = null\n    this.#fragments.clear()\n    this.#pendingSamples = 0\n  }\n}\n\nfunction fragmentKey(mpuSequenceNumber: number, movieFragmentSequenceNumber: number): string {\n  return `${mpuSequenceNumber}:${movieFragmentSequenceNumber}`\n}\n\nfunction isU32(value: number): boolean {\n  return Number.isInteger(value) && value >= 0 && value <= 0xffff_ffff\n}\n\n/** Convert exact media ticks to microseconds without first narrowing the ticks. */\nexport function mediaTicksToMicroseconds(ticks: bigint, timescale: number): number | null {\n  if (!Number.isInteger(timescale) || timescale <= 0) return null\n  const numerator = ticks * MICROSECONDS_PER_SECOND\n  const scale = BigInt(timescale)\n  const whole = numerator / scale\n  const remainder = numerator % scale\n  if (whole < BigInt(Number.MIN_SAFE_INTEGER) || whole > BigInt(Number.MAX_SAFE_INTEGER)) {\n    return null\n  }\n  const result = Number(whole) + Number(remainder) / timescale\n  return Number.isFinite(result) ? result : null\n}\n"],
+  "mappings": "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",
+  "names": ["trex"]
+}

package/dist/loc.d.ts

@@ -1,100 +1,95 @@
 /**
  * @mmt/container - LOC FEC Extensions
  *
- * FEC Payload ID helpers for LOC (Low Overhead Container) format
- * Per draft-ramadan-moq-mmt Section 7.3
+ * FEC Source Info travels as a MoQT object extension header.
  *
- * The FEC Payload ID encodes Source Block Number (SBN) and
- * Encoding Symbol ID (ESI) as a 48-bit value: (SBN << 24) | ESI
+ * MoQT's key-value parity rule makes an **even** type varint-valued and an
+ * **odd** type length-prefixed-byte-valued. FEC Source Info is byte-valued, so
+ * its type MUST be odd. It used to be `0x10`, which is even: moqtail-ts had to
+ * special-case it ahead of the parity rule and upstream `js/net` reads every
+ * even type as a single varint, so a conformant parser or a re-encoding relay
+ * desynced on the first FEC-tagged object. The codepoint is now `0x11` and
+ * `0x10` is not accepted — there is no compatibility shim (BLO-40702).
+ *
+ * Value layout, exactly 4 bytes:
+ *
+ *     SS_ID (32 bits, big endian)
+ *
+ * SS_ID is the source symbol's sequence number — the same value and the same
+ * definition the Source FEC Payload ID trailer carries on the MMTP path, so one
+ * identifier covers both paths. It is a fixed 32-bit field, never a varint: MoQT
+ * permits non-minimal varint encodings, so a varint here would vary the
+ * extension's own length without varying its meaning, and the varint encoding is
+ * a property of the session, which MoQT redefined at draft-17 (#1016). Any value
+ * length other than 4 is an error.
+ *
+ * The value carries no block coordinate. A receiver places the symbol in a block
+ * by SS_ID and learns the block's extent from a repair object's
+ * (SS_Start, SSB_length) — it must not infer one from this extension. An earlier
+ * revision carried SBN + ESI + an optional Original Object Length; all three are
+ * gone (BLO-40702). SBN/ESI contradicted the draft's own block model (Z=1, so
+ * SBN is always 0, and blocks are delimited only by repair objects), and the
+ * object length travelled inside the object it described, so it was absent in
+ * the recovery case it existed for — the recoverable length is the `Length`
+ * field inside the FEC-protected source symbol.
  *
  * @packageDocumentation
  */
 /**
- * LOC Header Extension IDs
+ * LOC Header Extension IDs.
+ *
+ * NOTE: `AuthTag` is byte-valued on an even type, the same parity violation
+ * `FecSourceInfo` just left. It has no encoder, no wire path and no draft text
+ * here, so it is not renumbered as part of this change — see BLO-40702.
  */
 export declare enum LOCHeaderExtensionId {
     CaptureTimestamp = 2,
     VideoFrameMarking = 4,
     AudioLevel = 6,
     VideoConfig = 13,
-    /** FEC Payload ID extension (draft-ramadan-moq-mmt Section 7.3) */
-    FecPayloadId = 16
+    /** FEC Source Info: SS_ID(32) */
+    FecSourceInfo = 17,
+    /** Content authentication tag */
+    AuthTag = 14
 }
-/** Maximum value for SBN and ESI (24 bits each) */
-export declare const FEC_PAYLOAD_ID_MAX = 16777215;
+/** Maximum value for SS_ID (32 bits) */
+export declare const FEC_SS_ID_MAX = 4294967295;
+/** FEC Source Info value length — fixed. */
+export declare const FEC_SOURCE_INFO_LEN = 4;
 /**
- * Pack Source Block Number (SBN) and Encoding Symbol ID (ESI) into a 48-bit value.
- *
- * Per draft-ramadan-moq-mmt Section 7.3, the FEC Payload ID is encoded as:
- * `(SBN << 24) | ESI` where both SBN and ESI are 24 bits.
- *
- * @param sbn - Source Block Number (24 bits, 0-16777215)
- * @param esi - Encoding Symbol ID (24 bits, 0-16777215)
- * @returns Packed 48-bit value as bigint
- *
- * @example
- * ```ts
- * import { fecPack } from '@mmt/container/loc'
- * const packed = fecPack(100, 5) // 419430405n
- * ```
+ * Encode FEC Source Info value bytes: SS_ID(4B BE).
+ * Returns 4-byte Uint8Array. Throws if SS_ID is out of range.
  */
-export declare function fecPack(sbn: number, esi: number): bigint;
+export declare function encodeFecSourceInfo(ssId: number): Uint8Array;
 /**
- * Unpack a 48-bit FEC Payload ID into Source Block Number and Encoding Symbol ID.
- *
- * Per draft-ramadan-moq-mmt Section 7.3, extracts:
- * - SBN from upper 24 bits
- * - ESI from lower 24 bits
+ * Decode FEC Source Info value bytes: reads SS_ID(4B BE).
  *
- * @param packed - Packed 48-bit FEC Payload ID value
- * @returns Tuple of [sbn, esi] both as numbers
- *
- * @example
- * ```ts
- * import { fecPack, fecUnpack } from '@mmt/container/loc'
- * const packed = fecPack(100, 5)
- * const [sbn, esi] = fecUnpack(packed) // [100, 5]
- * ```
+ * Bounds are checked against `buf`'s own length, not its backing buffer: on a
+ * subarray of a larger ArrayBuffer a short value would otherwise read past the
+ * logical end of `buf` and return a well-formed SS_ID built from foreign bytes.
  */
-export declare function fecUnpack(packed: bigint): [sbn: number, esi: number];
+export declare function decodeFecSourceInfo(buf: Uint8Array, offset?: number): number;
 /**
- * FEC Payload ID for LOC extension headers
- *
- * Encodes Source Block Number (SBN) and Encoding Symbol ID (ESI)
- * for FEC recovery with LOC container format.
- *
- * @example
- * ```ts
- * import { FecPayloadId } from '@mmt/container/loc'
- *
- * // Create from SBN/ESI
- * const fecId = new FecPayloadId(100, 5)
- *
- * // Get packed value for extension header
- * const packed = fecId.packed // 419430405n
- *
- * // Create from packed value
- * const fecId2 = FecPayloadId.fromPacked(packed)
- * ```
+ * FEC Source Info for LOC/CMAF extension headers: SS_ID(32).
  */
-export declare class FecPayloadId {
-    /** Source Block Number (24 bits, 0-16777215) */
-    readonly sbn: number;
-    /** Encoding Symbol ID (24 bits, 0-16777215) */
-    readonly esi: number;
-    static readonly TYPE = LOCHeaderExtensionId.FecPayloadId;
+export declare class FecSourceInfo {
+    /** Source symbol sequence number (32 bits) */
+    readonly ssId: number;
+    static readonly TYPE = LOCHeaderExtensionId.FecSourceInfo;
     constructor(
-    /** Source Block Number (24 bits, 0-16777215) */
-    sbn: number, 
-    /** Encoding Symbol ID (24 bits, 0-16777215) */
-    esi: number);
-    /** Get packed 48-bit value */
-    get packed(): bigint;
-    /** Create from packed 48-bit value */
-    static fromPacked(packed: bigint): FecPayloadId;
-    /** Check if value is within valid 24-bit range */
-    static isValidSbn(sbn: number): boolean;
-    /** Check if value is within valid 24-bit range */
-    static isValidEsi(esi: number): boolean;
+    /** Source symbol sequence number (32 bits) */
+    ssId: number);
+    /** Encode as extension value bytes */
+    encode(): Uint8Array;
+    /** Decode from extension value bytes. Fails closed on any other length. */
+    static decode(buf: Uint8Array): FecSourceInfo;
+}
+/**
+ * AuthTag for end-to-end content authentication.
+ */
+export declare class AuthTag {
+    readonly tag: Uint8Array;
+    static readonly TYPE = LOCHeaderExtensionId.AuthTag;
+    constructor(tag: Uint8Array);
 }
 //# sourceMappingURL=loc.d.ts.map

package/dist/loc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loc.d.ts","sourceRoot":"","sources":["../src/loc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,gBAAgB,IAAI;IACpB,iBAAiB,IAAI;IACrB,UAAU,IAAI;IACd,WAAW,KAAK;IAChB,mEAAmE;IACnE,YAAY,KAAO;CACpB;AAED,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAIpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IAIrB,gDAAgD;aAChC,GAAG,EAAE,MAAM;IAC3B,+CAA+C;aAC/B,GAAG,EAAE,MAAM;IAN7B,MAAM,CAAC,QAAQ,CAAC,IAAI,qCAAoC;;IAGtD,gDAAgD;IAChC,GAAG,EAAE,MAAM;IAC3B,+CAA+C;IAC/B,GAAG,EAAE,MAAM;IAU7B,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sCAAsC;IACtC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAK/C,kDAAkD;IAClD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,kDAAkD;IAClD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGxC"}
+{"version":3,"file":"loc.d.ts","sourceRoot":"","sources":["../src/loc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;GAMG;AACH,oBAAY,oBAAoB;IAC9B,gBAAgB,IAAI;IACpB,iBAAiB,IAAI;IACrB,UAAU,IAAI;IACd,WAAW,KAAK;IAChB,iCAAiC;IACjC,aAAa,KAAO;IACpB,iCAAiC;IACjC,OAAO,KAAK;CACb;AAED,wCAAwC;AACxC,eAAO,MAAM,aAAa,aAAa,CAAA;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAUpC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,SAAI,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,qBAAa,aAAa;IAItB,8CAA8C;aAC9B,IAAI,EAAE,MAAM;IAJ9B,MAAM,CAAC,QAAQ,CAAC,IAAI,sCAAqC;;IAGvD,8CAA8C;IAC9B,IAAI,EAAE,MAAM;IAG9B,sCAAsC;IACtC,MAAM,IAAI,UAAU;IAIpB,2EAA2E;IAC3E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa;CAM9C;AAED;;GAEG;AACH,qBAAa,OAAO;aAGU,GAAG,EAAE,UAAU;IAF3C,MAAM,CAAC,QAAQ,CAAC,IAAI,gCAA+B;gBAEvB,GAAG,EAAE,UAAU;CAG5C"}

package/dist/loc.js

@@ -1,198 +1,112 @@
-/**
- * @mmt/container - LOC FEC Extensions
- *
- * FEC Payload ID helpers for LOC (Low Overhead Container) format
- * Per draft-ramadan-moq-mmt Section 7.3
- *
- * The FEC Payload ID encodes Source Block Number (SBN) and
- * Encoding Symbol ID (ESI) as a 48-bit value: (SBN << 24) | ESI
- *
- * @packageDocumentation
- */
-/**
- * LOC Header Extension IDs
- */
-export var LOCHeaderExtensionId;
-(function (LOCHeaderExtensionId) {
-    LOCHeaderExtensionId[LOCHeaderExtensionId["CaptureTimestamp"] = 2] = "CaptureTimestamp";
-    LOCHeaderExtensionId[LOCHeaderExtensionId["VideoFrameMarking"] = 4] = "VideoFrameMarking";
-    LOCHeaderExtensionId[LOCHeaderExtensionId["AudioLevel"] = 6] = "AudioLevel";
-    LOCHeaderExtensionId[LOCHeaderExtensionId["VideoConfig"] = 13] = "VideoConfig";
-    /** FEC Payload ID extension (draft-ramadan-moq-mmt Section 7.3) */
-    LOCHeaderExtensionId[LOCHeaderExtensionId["FecPayloadId"] = 16] = "FecPayloadId";
-})(LOCHeaderExtensionId || (LOCHeaderExtensionId = {}));
-/** Maximum value for SBN and ESI (24 bits each) */
-export const FEC_PAYLOAD_ID_MAX = 0xffffff;
-/**
- * Pack Source Block Number (SBN) and Encoding Symbol ID (ESI) into a 48-bit value.
- *
- * Per draft-ramadan-moq-mmt Section 7.3, the FEC Payload ID is encoded as:
- * `(SBN << 24) | ESI` where both SBN and ESI are 24 bits.
- *
- * @param sbn - Source Block Number (24 bits, 0-16777215)
- * @param esi - Encoding Symbol ID (24 bits, 0-16777215)
- * @returns Packed 48-bit value as bigint
- *
- * @example
- * ```ts
- * import { fecPack } from '@mmt/container/loc'
- * const packed = fecPack(100, 5) // 419430405n
- * ```
- */
-export function fecPack(sbn, esi) {
-    return (BigInt(sbn & 0xffffff) << 24n) | BigInt(esi & 0xffffff);
+// src/loc.ts
+var LOCHeaderExtensionId = /* @__PURE__ */ ((LOCHeaderExtensionId2) => {
+  LOCHeaderExtensionId2[LOCHeaderExtensionId2["CaptureTimestamp"] = 2] = "CaptureTimestamp";
+  LOCHeaderExtensionId2[LOCHeaderExtensionId2["VideoFrameMarking"] = 4] = "VideoFrameMarking";
+  LOCHeaderExtensionId2[LOCHeaderExtensionId2["AudioLevel"] = 6] = "AudioLevel";
+  LOCHeaderExtensionId2[LOCHeaderExtensionId2["VideoConfig"] = 13] = "VideoConfig";
+  LOCHeaderExtensionId2[LOCHeaderExtensionId2["FecSourceInfo"] = 17] = "FecSourceInfo";
+  LOCHeaderExtensionId2[LOCHeaderExtensionId2["AuthTag"] = 14] = "AuthTag";
+  return LOCHeaderExtensionId2;
+})(LOCHeaderExtensionId || {});
+var FEC_SS_ID_MAX = 4294967295;
+var FEC_SOURCE_INFO_LEN = 4;
+function checkField(field, value, max) {
+  if (!Number.isInteger(value) || value < 0 || value > max) {
+    throw new Error(`FecSourceInfo ${field} out of range: ${value}`);
+  }
+  return value;
 }
-/**
- * Unpack a 48-bit FEC Payload ID into Source Block Number and Encoding Symbol ID.
- *
- * Per draft-ramadan-moq-mmt Section 7.3, extracts:
- * - SBN from upper 24 bits
- * - ESI from lower 24 bits
- *
- * @param packed - Packed 48-bit FEC Payload ID value
- * @returns Tuple of [sbn, esi] both as numbers
- *
- * @example
- * ```ts
- * import { fecPack, fecUnpack } from '@mmt/container/loc'
- * const packed = fecPack(100, 5)
- * const [sbn, esi] = fecUnpack(packed) // [100, 5]
- * ```
- */
-export function fecUnpack(packed) {
-    const sbn = Number((packed >> 24n) & 0xffffffn);
-    const esi = Number(packed & 0xffffffn);
-    return [sbn, esi];
+function encodeFecSourceInfo(ssId) {
+  const buf = new Uint8Array(FEC_SOURCE_INFO_LEN);
+  new DataView(buf.buffer).setUint32(0, checkField("ssId", ssId, FEC_SS_ID_MAX), false);
+  return buf;
 }
-/**
- * FEC Payload ID for LOC extension headers
- *
- * Encodes Source Block Number (SBN) and Encoding Symbol ID (ESI)
- * for FEC recovery with LOC container format.
- *
- * @example
- * ```ts
- * import { FecPayloadId } from '@mmt/container/loc'
- *
- * // Create from SBN/ESI
- * const fecId = new FecPayloadId(100, 5)
- *
- * // Get packed value for extension header
- * const packed = fecId.packed // 419430405n
- *
- * // Create from packed value
- * const fecId2 = FecPayloadId.fromPacked(packed)
- * ```
- */
-export class FecPayloadId {
-    constructor(
-    /** Source Block Number (24 bits, 0-16777215) */
-    sbn, 
-    /** Encoding Symbol ID (24 bits, 0-16777215) */
-    esi) {
-        this.sbn = sbn;
-        this.esi = esi;
-        if (sbn < 0 || sbn > 0xffffff) {
-            throw new Error('SBN must be 0-16777215 (24 bits)');
-        }
-        if (esi < 0 || esi > 0xffffff) {
-            throw new Error('ESI must be 0-16777215 (24 bits)');
-        }
-    }
-    /** Get packed 48-bit value */
-    get packed() {
-        return fecPack(this.sbn, this.esi);
-    }
-    /** Create from packed 48-bit value */
-    static fromPacked(packed) {
-        const [sbn, esi] = fecUnpack(packed);
-        return new FecPayloadId(sbn, esi);
-    }
-    /** Check if value is within valid 24-bit range */
-    static isValidSbn(sbn) {
-        return sbn >= 0 && sbn <= 0xffffff;
-    }
-    /** Check if value is within valid 24-bit range */
-    static isValidEsi(esi) {
-        return esi >= 0 && esi <= 0xffffff;
-    }
+function decodeFecSourceInfo(buf, offset = 0) {
+  if (offset < 0 || offset + FEC_SOURCE_INFO_LEN > buf.length) {
+    throw new Error(`FEC Source Info must be ${FEC_SOURCE_INFO_LEN} bytes, got ${buf.length - offset}`);
+  }
+  return new DataView(buf.buffer, buf.byteOffset + offset, FEC_SOURCE_INFO_LEN).getUint32(0, false);
 }
-FecPayloadId.TYPE = LOCHeaderExtensionId.FecPayloadId;
-// =============================================================================
-// Inline Tests (vitest)
-// =============================================================================
-if (import.meta.vitest) {
-    const { describe, test, expect } = import.meta.vitest;
-    describe('FEC Helpers', () => {
-        test('fecPack/fecUnpack roundtrip', () => {
-            const sbn = 12345;
-            const esi = 67890;
-            const packed = fecPack(sbn, esi);
-            const [unpackedSbn, unpackedEsi] = fecUnpack(packed);
-            expect(unpackedSbn).toBe(sbn);
-            expect(unpackedEsi).toBe(esi);
-        });
-        test('fecPack/fecUnpack max values', () => {
-            const sbn = FEC_PAYLOAD_ID_MAX;
-            const esi = FEC_PAYLOAD_ID_MAX;
-            const packed = fecPack(sbn, esi);
-            const [unpackedSbn, unpackedEsi] = fecUnpack(packed);
-            expect(unpackedSbn).toBe(sbn);
-            expect(unpackedEsi).toBe(esi);
-        });
-        test('fecPack/fecUnpack zero', () => {
-            const packed = fecPack(0, 0);
-            expect(packed).toBe(0n);
-            const [sbn, esi] = fecUnpack(0n);
-            expect(sbn).toBe(0);
-            expect(esi).toBe(0);
-        });
-        test('fecPack truncates overflow', () => {
-            const sbn = 0x1ffffff; // 25 bits
-            const esi = 0x1ffffff; // 25 bits
-            const packed = fecPack(sbn, esi);
-            const [unpackedSbn, unpackedEsi] = fecUnpack(packed);
-            expect(unpackedSbn).toBe(FEC_PAYLOAD_ID_MAX);
-            expect(unpackedEsi).toBe(FEC_PAYLOAD_ID_MAX);
-        });
+var FecSourceInfo = class _FecSourceInfo {
+  constructor(ssId) {
+    this.ssId = ssId;
+  }
+  static {
+    this.TYPE = 17 /* FecSourceInfo */;
+  }
+  /** Encode as extension value bytes */
+  encode() {
+    return encodeFecSourceInfo(this.ssId);
+  }
+  /** Decode from extension value bytes. Fails closed on any other length. */
+  static decode(buf) {
+    if (buf.length !== FEC_SOURCE_INFO_LEN) {
+      throw new Error(`FEC Source Info must be ${FEC_SOURCE_INFO_LEN} bytes, got ${buf.length}`);
+    }
+    return new _FecSourceInfo(decodeFecSourceInfo(buf));
+  }
+};
+var AuthTag = class {
+  constructor(tag) {
+    this.tag = tag;
+    if (tag.length === 0) throw new Error("AuthTag must not be empty");
+  }
+  static {
+    this.TYPE = 14 /* AuthTag */;
+  }
+};
+if (void 0) {
+  const { describe, test, expect } = void 0;
+  describe("FEC Source Info (SS_ID(32))", () => {
+    test("the codepoint is odd, so MoQT parity makes it length-prefixed bytes", () => {
+      expect(FecSourceInfo.TYPE % 2).toBe(1);
+      expect(FecSourceInfo.TYPE).toBe(17);
+      expect(FecSourceInfo.TYPE).not.toBe(16);
+    });
+    test("encode/decode roundtrip", () => {
+      const encoded = encodeFecSourceInfo(1234);
+      expect(encoded.length).toBe(4);
+      expect(decodeFecSourceInfo(encoded)).toBe(1234);
+    });
+    test("max 32-bit value", () => {
+      expect(decodeFecSourceInfo(encodeFecSourceInfo(4294967295))).toBe(4294967295);
+    });
+    test("FecSourceInfo is a fixed 4 bytes", () => {
+      const encoded = new FecSourceInfo(100).encode();
+      expect(encoded.length).toBe(4);
+      expect(FecSourceInfo.decode(encoded).ssId).toBe(100);
+    });
+    test("SS_ID is fixed width, not a varint: small values still take 4 bytes", () => {
+      expect(new FecSourceInfo(1).encode().length).toBe(4);
+      expect(new FecSourceInfo(4294967295).encode().length).toBe(4);
+      expect(FecSourceInfo.decode(new FecSourceInfo(4294967295).encode()).ssId).toBe(4294967295);
+      expect(FecSourceInfo.decode(new FecSourceInfo(0).encode()).ssId).toBe(0);
+    });
+    test("decode fails closed on any other value length", () => {
+      for (const len of [0, 3, 5, 7, 8, 12, 16]) {
+        expect(() => FecSourceInfo.decode(new Uint8Array(len))).toThrow(/must be 4 bytes/);
+      }
+    });
+    test("decodeFecSourceInfo does not read past the end of a subarray", () => {
+      const backing = new Uint8Array([0, 0, 0, 1, 222, 173, 190, 239]);
+      expect(() => decodeFecSourceInfo(backing.subarray(0, 3))).toThrow(/must be 4 bytes/);
+      expect(() => decodeFecSourceInfo(backing, 5)).toThrow(/must be 4 bytes/);
+      expect(decodeFecSourceInfo(backing.subarray(0, 4))).toBe(1);
     });
-    describe('FecPayloadId', () => {
-        test('should create and roundtrip', () => {
-            const sbn = 12345;
-            const esi = 67890;
-            const fecId = new FecPayloadId(sbn, esi);
-            expect(fecId.sbn).toBe(sbn);
-            expect(fecId.esi).toBe(esi);
-            const fecId2 = FecPayloadId.fromPacked(fecId.packed);
-            expect(fecId2.sbn).toBe(sbn);
-            expect(fecId2.esi).toBe(esi);
-        });
-        test('should handle max 24-bit values', () => {
-            const sbn = 0xffffff;
-            const esi = 0xffffff;
-            const fecId = new FecPayloadId(sbn, esi);
-            const fecId2 = FecPayloadId.fromPacked(fecId.packed);
-            expect(fecId2.sbn).toBe(sbn);
-            expect(fecId2.esi).toBe(esi);
-        });
-        test('should reject invalid SBN', () => {
-            expect(() => new FecPayloadId(-1, 0)).toThrow();
-            expect(() => new FecPayloadId(0x1000000, 0)).toThrow();
-        });
-        test('should reject invalid ESI', () => {
-            expect(() => new FecPayloadId(0, -1)).toThrow();
-            expect(() => new FecPayloadId(0, 0x1000000)).toThrow();
-        });
-        test('isValidSbn/isValidEsi', () => {
-            expect(FecPayloadId.isValidSbn(0)).toBe(true);
-            expect(FecPayloadId.isValidSbn(0xffffff)).toBe(true);
-            expect(FecPayloadId.isValidSbn(-1)).toBe(false);
-            expect(FecPayloadId.isValidSbn(0x1000000)).toBe(false);
-            expect(FecPayloadId.isValidEsi(0)).toBe(true);
-            expect(FecPayloadId.isValidEsi(0xffffff)).toBe(true);
-            expect(FecPayloadId.isValidEsi(-1)).toBe(false);
-            expect(FecPayloadId.isValidEsi(0x1000000)).toBe(false);
-        });
+    test("encode rejects an out-of-range ss_id", () => {
+      expect(() => new FecSourceInfo(4294967296).encode()).toThrow(/ssId out of range/);
+      expect(() => new FecSourceInfo(-1).encode()).toThrow(/ssId out of range/);
+      expect(() => encodeFecSourceInfo(1.5)).toThrow(/ssId out of range/);
     });
+  });
 }
-//# sourceMappingURL=loc.js.map
+export {
+  AuthTag,
+  FEC_SOURCE_INFO_LEN,
+  FEC_SS_ID_MAX,
+  FecSourceInfo,
+  LOCHeaderExtensionId,
+  decodeFecSourceInfo,
+  encodeFecSourceInfo
+};
+//# sourceMappingURL=loc.js.map