@blockcast/mmt-container 0.3.0 → 0.4.0-main.1cd3cdea89da

package/dist/cmcd-producer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmcd-producer.d.ts","sourceRoot":"","sources":["../src/cmcd-producer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAM/E,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAA;IACnC,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yBAAyB;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,0DAA0D;AAC1D,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAA;AAI5D,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAElE,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC3C,qGAAqG;IACrG,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAkFD,qBAAa,YAAY;;gBAWX,OAAO,EAAE,mBAAmB;IAKxC,wEAAwE;IACxE,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIlD;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IASpC;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASvC;;;OAGG;IACH,uBAAuB,IAAI,IAAI;IAI/B,0BAA0B,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;IAIlE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAkBtC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAqCpC;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI;IAoB1D;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;CAsBpD"}
+{"version":3,"file":"cmcd-producer.d.ts","sourceRoot":"","sources":["../src/cmcd-producer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAM/E,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAA;IACnC,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yBAAyB;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,0DAA0D;AAC1D,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAA;AAI5D,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAElE,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC3C,qGAAqG;IACrG,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AA4ED,qBAAa,YAAY;;gBAWX,OAAO,EAAE,mBAAmB;IAKxC,wEAAwE;IACxE,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIlD;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IASpC;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASvC;;;OAGG;IACH,uBAAuB,IAAI,IAAI;IAI/B,0BAA0B,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;IAIlE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAkBtC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAqCpC;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI;IAoB1D;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;CAsBpD"}

package/dist/cmcd-producer.js

@@ -10,10 +10,6 @@ function buildFecParams(stats) {
   params["x-bc-fec-k"] = cfg.k;
   params["x-bc-fec-p"] = cfg.repairCount;
   params["x-bc-fec-recovery"] = parseFloat((stats.recoveryRate / 100).toFixed(4));
-  if (cfg.altaEnabled) {
-    params["x-bc-alta-verified"] = stats.altaVerified > 0;
-    params["x-bc-alta-failures"] = stats.altaFailed;
-  }
   return params;
 }
 function buildTransportParams(snap) {

package/dist/cmcd-producer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/cmcd-producer.ts"],
-  "sourcesContent": ["/**\n * CmcdProducer \u2014 transport-agnostic CMCD telemetry producer.\n *\n * Maps FecTrackStats snapshots and TransportSnapshot state to x-bc-*\n * CMCD vendor keys (proto tags 70-99). Fires callbacks for two delivery\n * channels: MoQ SUBSCRIBE params and multicast HTTP POST.\n *\n * Does NOT call fetch() or write to QUIC directly \u2014 the player wiring\n * layer is responsible for attaching params to SUBSCRIBE or POSTing\n * the payload to the CDN CMCD endpoint.\n *\n * @see docs/superpowers/specs/2026-04-15-iwa-multicast-stack-design.md \u00A73.3\n * @see CDN+ Track D BLO-1044\n */\n\nimport type { FecTrackStats } from '@blockcast/fec-worker'\nimport type { ManifestVerificationStats } from '@blockcast/mmt-manifest-verify'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Transport state snapshot, built by the player wiring layer from SocketPool. */\nexport interface TransportSnapshot {\n  transport: 'native' | 'amt' | 'moq'\n  /** IPv4/IPv6 multicast group address */\n  multicastGroup?: string\n  /** SSM source address */\n  multicastSource?: string\n  /** AMT relay address (omit when undefined) */\n  amtRelay?: string\n}\n\n/** Transport transition event identifiers for x-bc-ct. */\nexport type TransportTransitionEvent = 'mc-start' | 'mc-to-uc' | 'amt-start'\n\n/**\n * Phase 14 play-mode state (D-12, x-bc-play-mode):\n * - `full`         \u2014 base + delta both active\n * - `base-only`    \u2014 delta fell back; base carries playback\n * - `single-track` \u2014 stream is not a multi-track switching set (legacy)\n */\nexport type PlayMode = 'full' | 'base-only' | 'single-track'\n\nconst PLAY_MODES: readonly PlayMode[] = ['full', 'base-only', 'single-track']\n\n/** CMCD vendor key map. Values are string, number, or boolean. */\nexport type CmcdParams = Record<string, string | number | boolean>\n\n/** Options for CmcdProducer construction. */\nexport interface CmcdProducerOptions {\n  /** Fired on each snapshot and on transport transitions. Params for MoQ SUBSCRIBE. */\n  onCmcdParams?: (params: CmcdParams) => void\n  /** Fired on each snapshot and on transport transitions. RFC 9559 query-string for HTTP POST body. */\n  onCmcdPost?: (payload: string) => void\n}\n\n/** Snapshot data passed to onSnapshot(). */\nexport interface SnapshotData {\n  tracks: FecTrackStats[]\n  timestampMs: number\n}\n\n/** Transport-only telemetry for receivers that do not own FEC track stats. */\nexport interface TransportOnlySnapshotData {\n  transport: TransportSnapshot\n  timestampMs: number\n  playMode?: PlayMode\n  switchMiscount?: number\n}\n\n// ---------------------------------------------------------------------------\n// Value sanitization (T-06-01: header injection mitigation)\n// ---------------------------------------------------------------------------\n\n/** Strip commas, newlines, and carriage returns from string values. */\nfunction sanitize(value: string): string {\n  return value.replace(/[,\\r\\n]/g, '')\n}\n\n// ---------------------------------------------------------------------------\n// Key building (pure functions, no side effects)\n// ---------------------------------------------------------------------------\n\n/** Build FEC vendor keys from a FecTrackStats snapshot. */\nfunction buildFecParams(stats: FecTrackStats): CmcdParams {\n  const params: CmcdParams = {}\n  const cfg = stats.config\n\n  params['x-bc-fec-algo'] = cfg.algorithm\n  params['x-bc-fec-k'] = cfg.k\n  // P as this receiver JOINED it: the worker is configured from\n  // TrackSessionConfig.joinedRepairCount, the sum of repairSymbols over the\n  // joined base layers. Not the catalog total, which a receiver on a clean path\n  // does not receive, and never including a keyframe overlay (separate FEC\n  // instance with its own RSB_length).\n  params['x-bc-fec-p'] = cfg.repairCount\n  params['x-bc-fec-recovery'] = parseFloat((stats.recoveryRate / 100).toFixed(4))\n\n  // ALTA keys: omit entirely when altaEnabled is false (D-09)\n  if (cfg.altaEnabled) {\n    params['x-bc-alta-verified'] = stats.altaVerified > 0\n    params['x-bc-alta-failures'] = stats.altaFailed\n  }\n\n  return params\n}\n\n/** Build transport vendor keys from a TransportSnapshot. */\nfunction buildTransportParams(snap: TransportSnapshot | undefined): CmcdParams {\n  if (!snap) return {}\n\n  const params: CmcdParams = {}\n  params['x-bc-transport'] = snap.transport\n\n  if (snap.multicastGroup != null) {\n    params['x-bc-multicast-group'] = snap.multicastGroup\n  }\n  if (snap.multicastSource != null) {\n    params['x-bc-multicast-source'] = snap.multicastSource\n  }\n  if (snap.amtRelay != null) {\n    params['x-bc-amt-relay'] = snap.amtRelay\n  }\n\n  return params\n}\n\n// ---------------------------------------------------------------------------\n// Query-string serialization (RFC 9559 \u00A72)\n// ---------------------------------------------------------------------------\n\n/**\n * Serialize CmcdParams to RFC 9559 query-string format.\n * Keys sorted for deterministic output. String values sanitized.\n */\nfunction formatQueryString(params: CmcdParams): string {\n  return Object.keys(params)\n    .sort()\n    .map(key => {\n      const v = params[key]\n      if (typeof v === 'string') return `${key}=${sanitize(v)}`\n      return `${key}=${v}`\n    })\n    .join(',')\n}\n\n// ---------------------------------------------------------------------------\n// CmcdProducer\n// ---------------------------------------------------------------------------\n\nexport class CmcdProducer {\n  #onCmcdParams: ((params: CmcdParams) => void) | undefined\n  #onCmcdPost: ((payload: string) => void) | undefined\n  #transport: TransportSnapshot | undefined\n  #lastStats: FecTrackStats | undefined\n  // Phase 14 state \u2014 Plan 03 Task 2 (D-12, D-15).\n  #playMode: PlayMode | null = null\n  #deltaFailRate: number | null = null\n  #switchMiscount = 0\n  #manifestStats: ManifestVerificationStats | null = null\n\n  constructor(options: CmcdProducerOptions) {\n    this.#onCmcdParams = options.onCmcdParams\n    this.#onCmcdPost = options.onCmcdPost\n  }\n\n  /** Update the stored transport state. Called by player wiring layer. */\n  updateTransport(snapshot: TransportSnapshot): void {\n    this.#transport = snapshot\n  }\n\n  /**\n   * Set the current play-mode. Emitted as `x-bc-play-mode` on subsequent\n   * snapshots. Throws on any value outside {'full','base-only','single-track'}\n   * (CLAUDE.md: error on bad init).\n   */\n  updatePlayMode(mode: PlayMode): void {\n    if (typeof mode !== 'string' || !PLAY_MODES.includes(mode as PlayMode)) {\n      throw new Error(\n        `[CmcdProducer] invalid play-mode \"${String(mode)}\"; expected one of: ${PLAY_MODES.join(', ')}`,\n      )\n    }\n    this.#playMode = mode\n  }\n\n  /**\n   * Set the delta-track FEC block-failure rate (0..1 inclusive). Emitted as\n   * `x-bc-delta-fail-rate` on snapshots when play-mode is 'full' or 'base-only'.\n   * Omitted on single-track streams.\n   */\n  updateDeltaFailRate(rate: number): void {\n    if (typeof rate !== 'number' || !Number.isFinite(rate) || rate < 0 || rate > 1) {\n      throw new Error(\n        `[CmcdProducer] invalid delta-fail-rate \"${String(rate)}\"; expected a finite number in [0, 1]`,\n      )\n    }\n    this.#deltaFailRate = rate\n  }\n\n  /**\n   * Bump the cumulative switching-set misalignment counter. Emitted as\n   * `x-bc-switch-miscount` on snapshots when the counter is > 0.\n   */\n  incrementSwitchMiscount(): void {\n    this.#switchMiscount += 1\n  }\n\n  updateManifestVerification(stats: ManifestVerificationStats): void {\n    this.#manifestStats = stats\n  }\n\n  /**\n   * One-shot emit of `x-bc-switch-drift-us` for a single misalignment event.\n   * Does NOT mutate snapshot state \u2014 subsequent onSnapshot() calls will not\n   * include the drift key until the next emitSwitchDrift(). Mirrors the\n   * existing onTransition() pattern.\n   */\n  emitSwitchDrift(driftUs: number): void {\n    if (\n      typeof driftUs !== 'number' ||\n      !Number.isFinite(driftUs) ||\n      driftUs < 0\n    ) {\n      throw new Error(\n        `[CmcdProducer] invalid drift-us \"${String(driftUs)}\"; expected a non-negative finite number`,\n      )\n    }\n    const params: CmcdParams = {}\n    if (this.#lastStats) Object.assign(params, buildFecParams(this.#lastStats))\n    Object.assign(params, buildTransportParams(this.#transport))\n    if (this.#switchMiscount > 0) params['x-bc-switch-miscount'] = this.#switchMiscount\n    params['x-bc-switch-drift-us'] = driftUs\n    this.#emit(params)\n  }\n\n  /**\n   * Process a FecTrackStats snapshot. Finds the video track, builds\n   * x-bc-* vendor keys, and fires both delivery callbacks.\n   */\n  onSnapshot(data: SnapshotData): void {\n    // Find first video track; skip if none\n    const videoTrack = data.tracks.find(t => t.config.trackType === 'video')\n    if (!videoTrack) return\n\n    this.#lastStats = videoTrack\n\n    const params: CmcdParams = {\n      ...buildFecParams(videoTrack),\n      ...buildTransportParams(this.#transport),\n    }\n\n    if (this.#playMode !== null) {\n      params['x-bc-play-mode'] = this.#playMode\n    }\n\n    // Delta-fail-rate is only meaningful when a delta track exists.\n    if (\n      this.#playMode !== null &&\n      this.#playMode !== 'single-track' &&\n      this.#deltaFailRate !== null\n    ) {\n      params['x-bc-delta-fail-rate'] = parseFloat(this.#deltaFailRate.toFixed(4))\n    }\n\n    if (this.#switchMiscount > 0) {\n      params['x-bc-switch-miscount'] = this.#switchMiscount\n    }\n    if (this.#manifestStats) {\n      params['x-bc-manifest-verified'] = this.#manifestStats.verified > 0\n      params['x-bc-manifest-failures'] = Object.values(this.#manifestStats.failures)\n        .reduce((total, count) => total + count, 0)\n    }\n\n    this.#emit(params)\n  }\n\n  /**\n   * Emit transport state without inventing FEC metrics. Cadence is owned by\n   * the caller because only the transport integration knows when state changed.\n   */\n  onTransportSnapshot(data: TransportOnlySnapshotData): void {\n    if (!Number.isFinite(data.timestampMs) || data.timestampMs < 0) {\n      throw new Error('[CmcdProducer] transport snapshot timestamp must be a non-negative finite number')\n    }\n    if (data.playMode !== undefined) this.updatePlayMode(data.playMode)\n    if (\n      data.switchMiscount !== undefined &&\n      (!Number.isSafeInteger(data.switchMiscount) || data.switchMiscount < 0)\n    ) {\n      throw new Error('[CmcdProducer] transport snapshot switch-miscount must be a non-negative safe integer')\n    }\n\n    this.#transport = data.transport\n    const params = buildTransportParams(data.transport)\n    if (this.#playMode !== null) params['x-bc-play-mode'] = this.#playMode\n    const switchMiscount = data.switchMiscount ?? this.#switchMiscount\n    if (switchMiscount > 0) params['x-bc-switch-miscount'] = switchMiscount\n    this.#emit(params)\n  }\n\n  /**\n   * Signal a transport transition event. Fires an immediate out-of-band\n   * emit with x-bc-ct set. The subsequent onSnapshot() will NOT include\n   * x-bc-ct (one-shot).\n   */\n  onTransition(event: TransportTransitionEvent): void {\n    const params: CmcdParams = {}\n\n    // Include last known FEC stats if available\n    if (this.#lastStats) {\n      Object.assign(params, buildFecParams(this.#lastStats))\n    }\n\n    // Include transport state if available\n    Object.assign(params, buildTransportParams(this.#transport))\n\n    // Add the transition event key (one-shot)\n    params['x-bc-ct'] = event\n\n    this.#emit(params)\n  }\n\n  /** Fire both delivery callbacks with the given params. */\n  #emit(params: CmcdParams): void {\n    this.#onCmcdParams?.(params)\n    this.#onCmcdPost?.(formatQueryString(params))\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * CmcdProducer \u2014 transport-agnostic CMCD telemetry producer.\n *\n * Maps FecTrackStats snapshots and TransportSnapshot state to x-bc-*\n * CMCD vendor keys (proto tags 70-99). Fires callbacks for two delivery\n * channels: MoQ SUBSCRIBE params and multicast HTTP POST.\n *\n * Does NOT call fetch() or write to QUIC directly \u2014 the player wiring\n * layer is responsible for attaching params to SUBSCRIBE or POSTing\n * the payload to the CDN CMCD endpoint.\n *\n * @see docs/superpowers/specs/2026-04-15-iwa-multicast-stack-design.md \u00A73.3\n * @see CDN+ Track D BLO-1044\n */\n\nimport type { FecTrackStats } from '@blockcast/fec-worker'\nimport type { ManifestVerificationStats } from '@blockcast/mmt-manifest-verify'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Transport state snapshot, built by the player wiring layer from SocketPool. */\nexport interface TransportSnapshot {\n  transport: 'native' | 'amt' | 'moq'\n  /** IPv4/IPv6 multicast group address */\n  multicastGroup?: string\n  /** SSM source address */\n  multicastSource?: string\n  /** AMT relay address (omit when undefined) */\n  amtRelay?: string\n}\n\n/** Transport transition event identifiers for x-bc-ct. */\nexport type TransportTransitionEvent = 'mc-start' | 'mc-to-uc' | 'amt-start'\n\n/**\n * Phase 14 play-mode state (D-12, x-bc-play-mode):\n * - `full`         \u2014 base + delta both active\n * - `base-only`    \u2014 delta fell back; base carries playback\n * - `single-track` \u2014 stream is not a multi-track switching set (legacy)\n */\nexport type PlayMode = 'full' | 'base-only' | 'single-track'\n\nconst PLAY_MODES: readonly PlayMode[] = ['full', 'base-only', 'single-track']\n\n/** CMCD vendor key map. Values are string, number, or boolean. */\nexport type CmcdParams = Record<string, string | number | boolean>\n\n/** Options for CmcdProducer construction. */\nexport interface CmcdProducerOptions {\n  /** Fired on each snapshot and on transport transitions. Params for MoQ SUBSCRIBE. */\n  onCmcdParams?: (params: CmcdParams) => void\n  /** Fired on each snapshot and on transport transitions. RFC 9559 query-string for HTTP POST body. */\n  onCmcdPost?: (payload: string) => void\n}\n\n/** Snapshot data passed to onSnapshot(). */\nexport interface SnapshotData {\n  tracks: FecTrackStats[]\n  timestampMs: number\n}\n\n/** Transport-only telemetry for receivers that do not own FEC track stats. */\nexport interface TransportOnlySnapshotData {\n  transport: TransportSnapshot\n  timestampMs: number\n  playMode?: PlayMode\n  switchMiscount?: number\n}\n\n// ---------------------------------------------------------------------------\n// Value sanitization (T-06-01: header injection mitigation)\n// ---------------------------------------------------------------------------\n\n/** Strip commas, newlines, and carriage returns from string values. */\nfunction sanitize(value: string): string {\n  return value.replace(/[,\\r\\n]/g, '')\n}\n\n// ---------------------------------------------------------------------------\n// Key building (pure functions, no side effects)\n// ---------------------------------------------------------------------------\n\n/** Build FEC vendor keys from a FecTrackStats snapshot. */\nfunction buildFecParams(stats: FecTrackStats): CmcdParams {\n  const params: CmcdParams = {}\n  const cfg = stats.config\n\n  params['x-bc-fec-algo'] = cfg.algorithm\n  params['x-bc-fec-k'] = cfg.k\n  // P as this receiver JOINED it: the worker is configured from\n  // TrackSessionConfig.joinedRepairCount, the sum of repairSymbols over the\n  // joined base layers. Not the catalog total, which a receiver on a clean path\n  // does not receive, and never including a keyframe overlay (separate FEC\n  // instance with its own RSB_length).\n  params['x-bc-fec-p'] = cfg.repairCount\n  params['x-bc-fec-recovery'] = parseFloat((stats.recoveryRate / 100).toFixed(4))\n\n  return params\n}\n\n/** Build transport vendor keys from a TransportSnapshot. */\nfunction buildTransportParams(snap: TransportSnapshot | undefined): CmcdParams {\n  if (!snap) return {}\n\n  const params: CmcdParams = {}\n  params['x-bc-transport'] = snap.transport\n\n  if (snap.multicastGroup != null) {\n    params['x-bc-multicast-group'] = snap.multicastGroup\n  }\n  if (snap.multicastSource != null) {\n    params['x-bc-multicast-source'] = snap.multicastSource\n  }\n  if (snap.amtRelay != null) {\n    params['x-bc-amt-relay'] = snap.amtRelay\n  }\n\n  return params\n}\n\n// ---------------------------------------------------------------------------\n// Query-string serialization (RFC 9559 \u00A72)\n// ---------------------------------------------------------------------------\n\n/**\n * Serialize CmcdParams to RFC 9559 query-string format.\n * Keys sorted for deterministic output. String values sanitized.\n */\nfunction formatQueryString(params: CmcdParams): string {\n  return Object.keys(params)\n    .sort()\n    .map(key => {\n      const v = params[key]\n      if (typeof v === 'string') return `${key}=${sanitize(v)}`\n      return `${key}=${v}`\n    })\n    .join(',')\n}\n\n// ---------------------------------------------------------------------------\n// CmcdProducer\n// ---------------------------------------------------------------------------\n\nexport class CmcdProducer {\n  #onCmcdParams: ((params: CmcdParams) => void) | undefined\n  #onCmcdPost: ((payload: string) => void) | undefined\n  #transport: TransportSnapshot | undefined\n  #lastStats: FecTrackStats | undefined\n  // Phase 14 state \u2014 Plan 03 Task 2 (D-12, D-15).\n  #playMode: PlayMode | null = null\n  #deltaFailRate: number | null = null\n  #switchMiscount = 0\n  #manifestStats: ManifestVerificationStats | null = null\n\n  constructor(options: CmcdProducerOptions) {\n    this.#onCmcdParams = options.onCmcdParams\n    this.#onCmcdPost = options.onCmcdPost\n  }\n\n  /** Update the stored transport state. Called by player wiring layer. */\n  updateTransport(snapshot: TransportSnapshot): void {\n    this.#transport = snapshot\n  }\n\n  /**\n   * Set the current play-mode. Emitted as `x-bc-play-mode` on subsequent\n   * snapshots. Throws on any value outside {'full','base-only','single-track'}\n   * (CLAUDE.md: error on bad init).\n   */\n  updatePlayMode(mode: PlayMode): void {\n    if (typeof mode !== 'string' || !PLAY_MODES.includes(mode as PlayMode)) {\n      throw new Error(\n        `[CmcdProducer] invalid play-mode \"${String(mode)}\"; expected one of: ${PLAY_MODES.join(', ')}`,\n      )\n    }\n    this.#playMode = mode\n  }\n\n  /**\n   * Set the delta-track FEC block-failure rate (0..1 inclusive). Emitted as\n   * `x-bc-delta-fail-rate` on snapshots when play-mode is 'full' or 'base-only'.\n   * Omitted on single-track streams.\n   */\n  updateDeltaFailRate(rate: number): void {\n    if (typeof rate !== 'number' || !Number.isFinite(rate) || rate < 0 || rate > 1) {\n      throw new Error(\n        `[CmcdProducer] invalid delta-fail-rate \"${String(rate)}\"; expected a finite number in [0, 1]`,\n      )\n    }\n    this.#deltaFailRate = rate\n  }\n\n  /**\n   * Bump the cumulative switching-set misalignment counter. Emitted as\n   * `x-bc-switch-miscount` on snapshots when the counter is > 0.\n   */\n  incrementSwitchMiscount(): void {\n    this.#switchMiscount += 1\n  }\n\n  updateManifestVerification(stats: ManifestVerificationStats): void {\n    this.#manifestStats = stats\n  }\n\n  /**\n   * One-shot emit of `x-bc-switch-drift-us` for a single misalignment event.\n   * Does NOT mutate snapshot state \u2014 subsequent onSnapshot() calls will not\n   * include the drift key until the next emitSwitchDrift(). Mirrors the\n   * existing onTransition() pattern.\n   */\n  emitSwitchDrift(driftUs: number): void {\n    if (\n      typeof driftUs !== 'number' ||\n      !Number.isFinite(driftUs) ||\n      driftUs < 0\n    ) {\n      throw new Error(\n        `[CmcdProducer] invalid drift-us \"${String(driftUs)}\"; expected a non-negative finite number`,\n      )\n    }\n    const params: CmcdParams = {}\n    if (this.#lastStats) Object.assign(params, buildFecParams(this.#lastStats))\n    Object.assign(params, buildTransportParams(this.#transport))\n    if (this.#switchMiscount > 0) params['x-bc-switch-miscount'] = this.#switchMiscount\n    params['x-bc-switch-drift-us'] = driftUs\n    this.#emit(params)\n  }\n\n  /**\n   * Process a FecTrackStats snapshot. Finds the video track, builds\n   * x-bc-* vendor keys, and fires both delivery callbacks.\n   */\n  onSnapshot(data: SnapshotData): void {\n    // Find first video track; skip if none\n    const videoTrack = data.tracks.find(t => t.config.trackType === 'video')\n    if (!videoTrack) return\n\n    this.#lastStats = videoTrack\n\n    const params: CmcdParams = {\n      ...buildFecParams(videoTrack),\n      ...buildTransportParams(this.#transport),\n    }\n\n    if (this.#playMode !== null) {\n      params['x-bc-play-mode'] = this.#playMode\n    }\n\n    // Delta-fail-rate is only meaningful when a delta track exists.\n    if (\n      this.#playMode !== null &&\n      this.#playMode !== 'single-track' &&\n      this.#deltaFailRate !== null\n    ) {\n      params['x-bc-delta-fail-rate'] = parseFloat(this.#deltaFailRate.toFixed(4))\n    }\n\n    if (this.#switchMiscount > 0) {\n      params['x-bc-switch-miscount'] = this.#switchMiscount\n    }\n    if (this.#manifestStats) {\n      params['x-bc-manifest-verified'] = this.#manifestStats.verified > 0\n      params['x-bc-manifest-failures'] = Object.values(this.#manifestStats.failures)\n        .reduce((total, count) => total + count, 0)\n    }\n\n    this.#emit(params)\n  }\n\n  /**\n   * Emit transport state without inventing FEC metrics. Cadence is owned by\n   * the caller because only the transport integration knows when state changed.\n   */\n  onTransportSnapshot(data: TransportOnlySnapshotData): void {\n    if (!Number.isFinite(data.timestampMs) || data.timestampMs < 0) {\n      throw new Error('[CmcdProducer] transport snapshot timestamp must be a non-negative finite number')\n    }\n    if (data.playMode !== undefined) this.updatePlayMode(data.playMode)\n    if (\n      data.switchMiscount !== undefined &&\n      (!Number.isSafeInteger(data.switchMiscount) || data.switchMiscount < 0)\n    ) {\n      throw new Error('[CmcdProducer] transport snapshot switch-miscount must be a non-negative safe integer')\n    }\n\n    this.#transport = data.transport\n    const params = buildTransportParams(data.transport)\n    if (this.#playMode !== null) params['x-bc-play-mode'] = this.#playMode\n    const switchMiscount = data.switchMiscount ?? this.#switchMiscount\n    if (switchMiscount > 0) params['x-bc-switch-miscount'] = switchMiscount\n    this.#emit(params)\n  }\n\n  /**\n   * Signal a transport transition event. Fires an immediate out-of-band\n   * emit with x-bc-ct set. The subsequent onSnapshot() will NOT include\n   * x-bc-ct (one-shot).\n   */\n  onTransition(event: TransportTransitionEvent): void {\n    const params: CmcdParams = {}\n\n    // Include last known FEC stats if available\n    if (this.#lastStats) {\n      Object.assign(params, buildFecParams(this.#lastStats))\n    }\n\n    // Include transport state if available\n    Object.assign(params, buildTransportParams(this.#transport))\n\n    // Add the transition event key (one-shot)\n    params['x-bc-ct'] = event\n\n    this.#emit(params)\n  }\n\n  /** Fire both delivery callbacks with the given params. */\n  #emit(params: CmcdParams): void {\n    this.#onCmcdParams?.(params)\n    this.#onCmcdPost?.(formatQueryString(params))\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/delivery-catalog.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Strict v2 multicast delivery catalog: the DASH/HLS/MMTP routes a receiver
+ * joins, their SSM endpoints, FEC geometry and MMTP packet-ID bindings.
+ *
+ * Moved from moqtail-private `libs/moqtail-ts/src/model/catalog/delivery.ts`
+ * (BLO-47003) so every player reads one contract. Two rules are stricter than
+ * the copy it replaces, both libmmt invariants rather than local choices:
+ * `fec.blockProfile` is required and must be `iso-ssbg1-v1` (BLO-35597), and a
+ * DASH route's `mmtp.packetId` is refused when it is the signaling flow 0
+ * (`isMulticastTrackPacketId`).
+ */
+import { type FecBlockProfile } from '@blockcast/mmt-base';
+export type DeliveryPackaging = 'mmtp' | 'dash' | 'hls';
+export type DeliveryContentType = 'video' | 'audio' | 'text';
+export interface DeliveryEndpoint {
+    source: string;
+    group: string;
+    port: number;
+}
+export interface DeliveryPolicy {
+    bufferWindowSegments: number;
+    requestTimeoutMs: number;
+    missPolicy: 'fail';
+}
+export interface DeliveryObjectMapping {
+    namespace: string;
+    initObject: string;
+    mediaObjectTemplate: string;
+}
+export interface DeliveryFec {
+    K: number;
+    /** Repair symbols per source block. Zero means source-only delivery. */
+    P: number;
+    T: number;
+    /** Full FEC block span in milliseconds (draft-ramadan-moq-fec §5.1). */
+    interleaveDepthMs: number;
+    /**
+     * The catalog `fec.blockProfile` (BLO-35597). Required and never
+     * defaulted; `parseFecBlockProfile` refuses anything but `iso-ssbg1-v1`,
+     * including the retired `k-padded-v1`.
+     */
+    blockProfile: FecBlockProfile;
+}
+export interface DeliveryRouteBase {
+    id: string;
+    contentType: DeliveryContentType;
+    endpointRef: string;
+    initUri: string;
+    mediaUriTemplate: string;
+    objects: DeliveryObjectMapping;
+    fec: DeliveryFec;
+}
+export interface DashDeliveryRoute extends DeliveryRouteBase {
+    representationId: string;
+    /**
+     * Authoritative MMTP binding used to assemble the DASH objects carried by
+     * this route. The current source accepts MFU-mode MMTP only; the init MPU is
+     * the representation init segment. MMTP-backed DASH URI and object templates
+     * contain exactly one $Number$ and may also contain $RepresentationID$;
+     * $Time$ is rejected because the catalog has no publisher-authored first-time
+     * anchor. Publishers explicitly anchor MMTP MPU sequence numbers to DASH
+     * $Number$ values so receivers never infer object boundaries from cadence.
+     */
+    mmtp: {
+        trackName: string;
+        packetId: number;
+        mode: 'mfu';
+        codec: string;
+        /** fMP4 media timescale used by Shaka's MMTP transmuxer. */
+        timescale: number;
+        /** Exact duration of one MFU in that timescale, from publisher timing. */
+        mediaUnitDurationTicks: number;
+        /** Exact MFU count carried by each numbered DASH media object. */
+        mediaUnitsPerObject: number;
+        /** First publisher MMTP MPU sequence represented by this route. */
+        firstMpuSequenceNumber: number;
+        /** DASH $Number$ containing firstMpuSequenceNumber. */
+        firstObjectNumber: number;
+        /** Consecutive MMTP MPU sequence numbers carried by each DASH object. */
+        mpuSequencesPerObject: number;
+        /** Optional reliable repair-track name under objects.namespace. */
+        repairTrack?: string;
+    };
+}
+export interface HlsDeliveryRoute extends DeliveryRouteBase {
+    variantId: string;
+    trackId: string;
+}
+export interface MmtpDeliveryRoute extends DeliveryRouteBase {
+    trackName: string;
+}
+export interface DashDeliveryConfig {
+    manifestUrl: string;
+    routes: DashDeliveryRoute[];
+}
+export interface HlsDeliveryConfig {
+    manifestUrl: string;
+    routes: HlsDeliveryRoute[];
+}
+export interface MmtpDeliveryConfig {
+    routes: MmtpDeliveryRoute[];
+}
+export interface DeliveryMulticastBase {
+    endpoints: Record<string, DeliveryEndpoint>;
+    deliveryPolicy: DeliveryPolicy;
+}
+export type DeliveryMulticastV2 = DeliveryMulticastBase & ({
+    packaging: 'dash';
+    dash: DashDeliveryConfig;
+} | {
+    packaging: 'hls';
+    hls: HlsDeliveryConfig;
+} | {
+    packaging: 'mmtp';
+    mmtp: MmtpDeliveryConfig;
+});
+export interface DeliveryCatalogV2 {
+    schemaVersion: 2;
+    channelId: string;
+    multicast: DeliveryMulticastV2;
+}
+/** Parse and normalize the strict v2 delivery-catalog contract. */
+export declare function normalizeDeliveryCatalog(value: unknown): DeliveryCatalogV2;
+//# sourceMappingURL=delivery-catalog.d.ts.map

package/dist/delivery-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-catalog.d.ts","sourceRoot":"","sources":["../src/delivery-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGhF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AACvD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,wEAAwE;IACxE,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,YAAY,EAAE,eAAe,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,mBAAmB,CAAA;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,GAAG,EAAE,WAAW,CAAA;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;;;;OAQG;IACH,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,KAAK,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,4DAA4D;QAC5D,SAAS,EAAE,MAAM,CAAA;QACjB,0EAA0E;QAC1E,sBAAsB,EAAE,MAAM,CAAA;QAC9B,kEAAkE;QAClE,mBAAmB,EAAE,MAAM,CAAA;QAC3B,mEAAmE;QACnE,sBAAsB,EAAE,MAAM,CAAA;QAC9B,uDAAuD;QACvD,iBAAiB,EAAE,MAAM,CAAA;QACzB,yEAAyE;QACzE,qBAAqB,EAAE,MAAM,CAAA;QAC7B,mEAAmE;QACnE,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC3C,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GACrD,CACI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC/C;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,iBAAiB,CAAA;CAAE,GAC5C;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAClD,CAAA;AAEH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAuWD,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAK1E"}