@blockcast/mmt-container 0.1.0-main.149f78a4adae

package/dist/multicast-input.js

@@ -0,0 +1,256 @@
+// src/multicast-input.ts
+var MulticastInputError = class extends Error {
+  constructor(kind, endpointIndex, message) {
+    super(message);
+    this.kind = kind;
+    this.endpointIndex = endpointIndex;
+    this.name = "MulticastInputError";
+  }
+};
+function multicastFromConfig(input) {
+  if (input.endpoints.length === 0) {
+    throw new MulticastInputError(
+      "empty_endpoints",
+      null,
+      "endpoints[] must be non-empty \u2014 a multicast field with zero endpoints declares nothing"
+    );
+  }
+  if (input.version !== void 0 && (!Number.isInteger(input.version) || input.version < 0)) {
+    throw new MulticastInputError("invalid_version", null, `version must be a non-negative integer; got ${input.version}`);
+  }
+  if (input.validUntil !== void 0) {
+    if (!Number.isFinite(input.validUntil) || input.validUntil <= 0) {
+      throw new MulticastInputError(
+        "invalid_valid_until",
+        null,
+        `validUntil must be a positive unix-ms timestamp; got ${input.validUntil}`
+      );
+    }
+  }
+  const seenTuples = /* @__PURE__ */ new Set();
+  const endpoints = input.endpoints.map((ep, idx) => validateEndpoint(ep, idx, seenTuples));
+  const out = { endpoints };
+  if (input.enabled !== void 0) out.enabled = input.enabled;
+  if (input.amtFallback !== void 0) out.amtFallback = { ...input.amtFallback };
+  if (input.version !== void 0) out.version = input.version;
+  if (input.validUntil !== void 0) out.validUntil = input.validUntil;
+  return out;
+}
+function validateEndpoint(ep, idx, seenTuples) {
+  if (ep.protocol === "ssm" && (!ep.sourceAddress || ep.sourceAddress.length === 0)) {
+    throw new MulticastInputError(
+      "ssm_requires_source",
+      idx,
+      `endpoint[${idx}] protocol=ssm requires sourceAddress`
+    );
+  }
+  if (ep.protocol === "amt" && (!ep.relayAddress || ep.relayAddress.length === 0)) {
+    throw new MulticastInputError(
+      "amt_requires_relay",
+      idx,
+      `endpoint[${idx}] protocol=amt requires relayAddress`
+    );
+  }
+  if (!isMulticastGroupAddress(ep.groupAddress)) {
+    throw new MulticastInputError(
+      "invalid_group_address",
+      idx,
+      `endpoint[${idx}] groupAddress "${ep.groupAddress}" is not a valid multicast address`
+    );
+  }
+  if (ep.protocol === "ssm" && !isSsmGroupAddress(ep.groupAddress)) {
+    throw new MulticastInputError(
+      "ssm_group_out_of_range",
+      idx,
+      `endpoint[${idx}] protocol=ssm requires groupAddress in 232.0.0.0/8 (IPv4) or ff3x::/32 (IPv6); got "${ep.groupAddress}"`
+    );
+  }
+  if (!Number.isInteger(ep.port) || ep.port < 1 || ep.port > 65535) {
+    throw new MulticastInputError("invalid_port", idx, `endpoint[${idx}] port must be 1..65535; got ${ep.port}`);
+  }
+  if (ep.tracks.length === 0) {
+    throw new MulticastInputError("empty_tracks", idx, `endpoint[${idx}] tracks must be non-empty`);
+  }
+  const seenPids = /* @__PURE__ */ new Set();
+  for (const t of ep.tracks) {
+    if (typeof t.name !== "string" || t.name.length === 0) {
+      throw new MulticastInputError(
+        "invalid_track_name",
+        idx,
+        `endpoint[${idx}] track name must be a non-empty string`
+      );
+    }
+    if (!Number.isInteger(t.packetId) || t.packetId < 0 || t.packetId > 65535) {
+      throw new MulticastInputError(
+        "invalid_packet_id",
+        idx,
+        `endpoint[${idx}] track "${t.name}" packetId must be 0..65535; got ${t.packetId}`
+      );
+    }
+    if (seenPids.has(t.packetId)) {
+      throw new MulticastInputError(
+        "duplicate_packet_id",
+        idx,
+        `endpoint[${idx}] duplicate packetId ${t.packetId}`
+      );
+    }
+    seenPids.add(t.packetId);
+  }
+  if (ep.bandwidth !== void 0 && (!Number.isFinite(ep.bandwidth) || ep.bandwidth <= 0)) {
+    throw new MulticastInputError(
+      "invalid_bandwidth",
+      idx,
+      `endpoint[${idx}] bandwidth must be positive; got ${ep.bandwidth}`
+    );
+  }
+  const tupleKey = `${ep.sourceAddress ?? ""}|${ep.groupAddress}|${ep.port}`;
+  if (seenTuples.has(tupleKey)) {
+    throw new MulticastInputError(
+      "duplicate_endpoint_tuple",
+      idx,
+      `endpoint[${idx}] duplicates (sourceAddress, groupAddress, port) tuple "${tupleKey}"`
+    );
+  }
+  seenTuples.add(tupleKey);
+  const out = {
+    protocol: ep.protocol,
+    groupAddress: ep.groupAddress,
+    port: ep.port,
+    tracks: ep.tracks.map((t) => ({ name: t.name, packetId: t.packetId }))
+  };
+  if (ep.sourceAddress !== void 0) out.sourceAddress = ep.sourceAddress;
+  if (ep.relayAddress !== void 0) out.relayAddress = ep.relayAddress;
+  if (ep.bandwidth !== void 0) out.bandwidth = ep.bandwidth;
+  return out;
+}
+function isMulticastGroupAddress(addr) {
+  if (addr.includes(":")) {
+    return /^ff[0-9a-f]{2}:/i.test(addr);
+  }
+  const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(addr);
+  if (!m) return false;
+  for (let i = 1; i <= 4; i++) {
+    const v = Number(m[i]);
+    if (!Number.isInteger(v) || v < 0 || v > 255) return false;
+  }
+  const first = Number(m[1]);
+  return first >= 224 && first <= 239;
+}
+function isSsmGroupAddress(addr) {
+  if (addr.includes(":")) {
+    return /^ff3[0-9a-f]:0{0,4}:/i.test(addr);
+  }
+  const m = /^(\d{1,3})\./.exec(addr);
+  return m !== null && Number(m[1]) === 232;
+}
+function multicastFromEnv(env = globalThis.process?.env ?? {}) {
+  const indices = collectMulticastIndices(env);
+  if (indices.length === 0) {
+    const strayCatalog = env["MOQCAST_MULTICAST_AMT_DISCOVERY"] !== void 0 || env["MOQCAST_MULTICAST_AMT_RELAY_DNS"] !== void 0;
+    if (strayCatalog) {
+      throw new MulticastInputError(
+        "invalid_env_shape",
+        null,
+        "MOQCAST_MULTICAST_AMT_* env keys are set but no per-endpoint keys (MOQCAST_MULTICAST_GROUP / _PROTOCOL / _PORT / _TRACKS) were found. AMT discovery is a catalog-level fallback for endpoints; declaring it with zero endpoints is a misconfiguration."
+      );
+    }
+    return void 0;
+  }
+  const endpoints = indices.map((idx) => readEndpointAt(env, idx));
+  const input = {
+    endpoints,
+    ...env["MOQCAST_MULTICAST_AMT_DISCOVERY"] ? {
+      amtFallback: {
+        discovery: env["MOQCAST_MULTICAST_AMT_DISCOVERY"],
+        ...env["MOQCAST_MULTICAST_AMT_RELAY_DNS"] ? { relayDns: env["MOQCAST_MULTICAST_AMT_RELAY_DNS"] } : {}
+      }
+    } : {}
+  };
+  return multicastFromConfig(input);
+}
+var ENV_PER_FIELD = ["PROTOCOL", "GROUP", "PORT", "SOURCE", "RELAY", "TRACKS", "BANDWIDTH"];
+var ENV_CATALOG_LEVEL = /* @__PURE__ */ new Set(["AMT_DISCOVERY", "AMT_RELAY_DNS"]);
+function collectMulticastIndices(env) {
+  const indices = /* @__PURE__ */ new Set();
+  let hasUnindexed = false;
+  let hasZeroIndexed = false;
+  for (const [key, val] of Object.entries(env)) {
+    if (val === void 0) continue;
+    if (!key.startsWith("MOQCAST_MULTICAST_")) continue;
+    const suffix = key.slice("MOQCAST_MULTICAST_".length);
+    if (ENV_CATALOG_LEVEL.has(suffix)) continue;
+    const m = /^(\d+)_(.+)$/.exec(suffix);
+    if (m) {
+      const idx = Number(m[1]);
+      const field = m[2];
+      if (!ENV_PER_FIELD.includes(field)) continue;
+      if (idx === 0) hasZeroIndexed = true;
+      indices.add(idx);
+    } else if (ENV_PER_FIELD.includes(suffix)) {
+      hasUnindexed = true;
+      indices.add(0);
+    }
+  }
+  if (hasUnindexed && hasZeroIndexed) {
+    throw new MulticastInputError(
+      "invalid_env_shape",
+      null,
+      "MOQCAST_MULTICAST_* env contract: cannot mix unindexed keys (MOQCAST_MULTICAST_GROUP) with explicitly-indexed keys at index 0 (MOQCAST_MULTICAST_0_GROUP) \u2014 they refer to the same endpoint. Use one form consistently."
+    );
+  }
+  return [...indices].sort((a, b) => a - b);
+}
+function readEndpointAt(env, idx) {
+  const lookup = (field) => {
+    if (idx === 0) {
+      return env[`MOQCAST_MULTICAST_${field}`] ?? env[`MOQCAST_MULTICAST_0_${field}`];
+    }
+    return env[`MOQCAST_MULTICAST_${idx}_${field}`];
+  };
+  const portStr = lookup("PORT");
+  const port = portStr !== void 0 ? Number(portStr) : NaN;
+  const tracks = parseTracksEnv(lookup("TRACKS"), idx);
+  const bandwidthStr = lookup("BANDWIDTH");
+  const bandwidth = bandwidthStr !== void 0 ? Number(bandwidthStr) : void 0;
+  const source = lookup("SOURCE");
+  const relay = lookup("RELAY");
+  return {
+    protocol: lookup("PROTOCOL"),
+    groupAddress: lookup("GROUP") ?? "",
+    port,
+    tracks,
+    ...source ? { sourceAddress: source } : {},
+    ...relay ? { relayAddress: relay } : {},
+    ...bandwidth !== void 0 ? { bandwidth } : {}
+  };
+}
+function parseTracksEnv(raw, endpointIdx) {
+  if (!raw || raw.length === 0) return [];
+  return raw.split(",").map((entry, i) => {
+    const colon = entry.lastIndexOf(":");
+    if (colon < 0) {
+      throw new MulticastInputError(
+        "invalid_track_name",
+        endpointIdx,
+        `endpoint[${endpointIdx}] TRACKS[${i}] missing ":" \u2014 expected "name:packetId", got ${JSON.stringify(entry)}`
+      );
+    }
+    const name = entry.slice(0, colon).trim();
+    const idStr = entry.slice(colon + 1).trim();
+    const packetId = Number(idStr);
+    if (!name || idStr.length === 0 || !Number.isFinite(packetId) || !Number.isInteger(packetId)) {
+      throw new MulticastInputError(
+        "invalid_packet_id",
+        endpointIdx,
+        `endpoint[${endpointIdx}] TRACKS[${i}] entry malformed (need "name:integer"): ${JSON.stringify(entry)}`
+      );
+    }
+    return { name, packetId };
+  });
+}
+export {
+  MulticastInputError,
+  multicastFromConfig,
+  multicastFromEnv
+};
+//# sourceMappingURL=multicast-input.js.map

package/dist/multicast-input.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/multicast-input.ts"],
+  "sourcesContent": ["// Module-local ambient: `multicastFromEnv` reads `process.env` when present\n// (Node, FFI host) and falls back to `{}` in browser contexts. The package\n// targets both, so we don't pull in `@types/node` org-wide \u2014 declaring the\n// minimal surface we touch keeps the dependency graph tight and the\n// published .d.ts free of node-isms.\ndeclare const process: { env: Record<string, string | undefined> } | undefined;\n\n/**\n * Multicast catalog input contract \u2014 validator + builder.\n *\n * Per draft-ramadan-moq-multicast-00 \u00A73 + \u00A74.1, the publisher (FFmpeg,\n * cast bridge, GStreamer, OBS-bridge) populates `multicast.endpoints[]`\n * in the catalog when its output includes a UDP multicast destination.\n *\n * This module is the TypeScript-side validator over a versioned input\n * shape. Sister-language validators (FFmpeg C, cast Rust) target the\n * same invariants \u2014 eventually via a shared JSON Schema + fixtures\n * (BLO-3341 follow-up); today parity is enforced by code review against\n * 1:1 ports. Each publisher's integration MUST also assert that the\n * declared `(sourceAddress, groupAddress, port)` matches what it\n * actually emits \u2014 that's a separate runtime check the helper cannot\n * perform.\n *\n * Validation invariants (per codex review of BLO-3323 v2):\n *   - protocol === 'ssm' \u2192 sourceAddress REQUIRED\n *   - protocol === 'amt' \u2192 relayAddress REQUIRED\n *   - groupAddress is a valid IPv4 multicast group (224.0.0.0/4)\n *     or IPv6 multicast group (ff00::/8)\n *   - SSM groupAddress MUST be in 232.0.0.0/8 (IPv4) or ff3x::/32 (IPv6),\n *     where the IPv6 form requires P=1 + T=1 (the `3` nibble) AND the\n *     16-bit reserved-zero second hextet per RFC 3306 \u00A74 / RFC 4607.\n *   - port in 1..65535\n *   - tracks non-empty; per-track packetId in 0..65535\n *   - packetIds unique within an endpoint\n *   - (sourceAddress, groupAddress, port) tuple unique across endpoints\n *   - bandwidth (if present) > 0\n *   - validUntil (if present) is a positive unix-ms timestamp\n *\n * @see draft-ramadan-moq-multicast-00 \u00A74.1\n * @see .planning/drafts/blo-3323-multicast-catalog-source-of-truth.md\n */\n\nimport {\n\ttype AmtDiscovery,\n\ttype MulticastCatalogConfig,\n\ttype MulticastEndpoint,\n\ttype MulticastProtocol,\n\ttype MulticastTrackObject,\n} from \"./carp-catalog.js\";\n\n/**\n * Strict typed input for one multicast endpoint. The publisher provides\n * this shape (env vars / CLI / config record), the helper validates and\n * lifts it into a `MulticastEndpoint` ready to embed in the catalog.\n */\nexport interface MulticastEndpointInput {\n\treadonly protocol: MulticastProtocol;\n\treadonly sourceAddress?: string;\n\treadonly groupAddress: string;\n\treadonly port: number;\n\t/** New emitters MUST use the object form (name + packetId). */\n\treadonly tracks: ReadonlyArray<MulticastTrackObject>;\n\treadonly relayAddress?: string;\n\t/** Aggregate bandwidth in bits per second. RECOMMENDED per draft \u00A74.1. */\n\treadonly bandwidth?: number;\n}\n\n/**\n * Strict typed input for the catalog-level multicast extension.\n *\n * `version` (monotonic) + `validUntil` (unix ms) support the catalog\n * freshness model: subscribers refetch before expiry, and publishers\n * MUST republish (with bumped `version`) on any endpoint mutation.\n */\nexport interface MulticastInput {\n\treadonly enabled?: boolean;\n\treadonly endpoints: ReadonlyArray<MulticastEndpointInput>;\n\treadonly amtFallback?: { readonly discovery: AmtDiscovery; readonly relayDns?: string };\n\treadonly version?: number;\n\treadonly validUntil?: number;\n}\n\nexport type MulticastInputErrorKind =\n\t| \"empty_endpoints\"\n\t| \"ssm_requires_source\"\n\t| \"amt_requires_relay\"\n\t| \"invalid_group_address\"\n\t| \"ssm_group_out_of_range\"\n\t| \"invalid_port\"\n\t| \"empty_tracks\"\n\t| \"invalid_track_name\"\n\t| \"invalid_packet_id\"\n\t| \"duplicate_packet_id\"\n\t| \"duplicate_endpoint_tuple\"\n\t| \"invalid_bandwidth\"\n\t| \"invalid_valid_until\"\n\t| \"invalid_version\"\n\t| \"invalid_env_shape\";\n\nexport class MulticastInputError extends Error {\n\tconstructor(\n\t\tpublic readonly kind: MulticastInputErrorKind,\n\t\tpublic readonly endpointIndex: number | null,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"MulticastInputError\";\n\t}\n}\n\n/**\n * Validate a typed publisher input and lift it into a\n * `MulticastCatalogConfig` ready for `catalog.multicast = \u2026`.\n *\n * Throws `MulticastInputError` on any invariant violation. Fail-fast\n * at config-load time, never at runtime \u2014 silent fallbacks hide bugs\n * upstream (per the project's \"no anti-patterns\" directive).\n */\nexport function multicastFromConfig(input: MulticastInput): MulticastCatalogConfig {\n\tif (input.endpoints.length === 0) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"empty_endpoints\",\n\t\t\tnull,\n\t\t\t\"endpoints[] must be non-empty \u2014 a multicast field with zero endpoints declares nothing\",\n\t\t);\n\t}\n\tif (input.version !== undefined && (!Number.isInteger(input.version) || input.version < 0)) {\n\t\tthrow new MulticastInputError(\"invalid_version\", null, `version must be a non-negative integer; got ${input.version}`);\n\t}\n\tif (input.validUntil !== undefined) {\n\t\tif (!Number.isFinite(input.validUntil) || input.validUntil <= 0) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"invalid_valid_until\",\n\t\t\t\tnull,\n\t\t\t\t`validUntil must be a positive unix-ms timestamp; got ${input.validUntil}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tconst seenTuples = new Set<string>();\n\tconst endpoints: MulticastEndpoint[] = input.endpoints.map((ep, idx) => validateEndpoint(ep, idx, seenTuples));\n\n\tconst out: MulticastCatalogConfig = { endpoints };\n\tif (input.enabled !== undefined) out.enabled = input.enabled;\n\tif (input.amtFallback !== undefined) out.amtFallback = { ...input.amtFallback };\n\tif (input.version !== undefined) out.version = input.version;\n\tif (input.validUntil !== undefined) out.validUntil = input.validUntil;\n\treturn out;\n}\n\nfunction validateEndpoint(\n\tep: MulticastEndpointInput,\n\tidx: number,\n\tseenTuples: Set<string>,\n): MulticastEndpoint {\n\tif (ep.protocol === \"ssm\" && (!ep.sourceAddress || ep.sourceAddress.length === 0)) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"ssm_requires_source\",\n\t\t\tidx,\n\t\t\t`endpoint[${idx}] protocol=ssm requires sourceAddress`,\n\t\t);\n\t}\n\tif (ep.protocol === \"amt\" && (!ep.relayAddress || ep.relayAddress.length === 0)) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"amt_requires_relay\",\n\t\t\tidx,\n\t\t\t`endpoint[${idx}] protocol=amt requires relayAddress`,\n\t\t);\n\t}\n\n\tif (!isMulticastGroupAddress(ep.groupAddress)) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"invalid_group_address\",\n\t\t\tidx,\n\t\t\t`endpoint[${idx}] groupAddress \"${ep.groupAddress}\" is not a valid multicast address`,\n\t\t);\n\t}\n\tif (ep.protocol === \"ssm\" && !isSsmGroupAddress(ep.groupAddress)) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"ssm_group_out_of_range\",\n\t\t\tidx,\n\t\t\t`endpoint[${idx}] protocol=ssm requires groupAddress in 232.0.0.0/8 (IPv4) or ff3x::/32 (IPv6); got \"${ep.groupAddress}\"`,\n\t\t);\n\t}\n\n\tif (!Number.isInteger(ep.port) || ep.port < 1 || ep.port > 65535) {\n\t\tthrow new MulticastInputError(\"invalid_port\", idx, `endpoint[${idx}] port must be 1..65535; got ${ep.port}`);\n\t}\n\n\tif (ep.tracks.length === 0) {\n\t\tthrow new MulticastInputError(\"empty_tracks\", idx, `endpoint[${idx}] tracks must be non-empty`);\n\t}\n\n\tconst seenPids = new Set<number>();\n\tfor (const t of ep.tracks) {\n\t\tif (typeof t.name !== \"string\" || t.name.length === 0) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"invalid_track_name\",\n\t\t\t\tidx,\n\t\t\t\t`endpoint[${idx}] track name must be a non-empty string`,\n\t\t\t);\n\t\t}\n\t\tif (!Number.isInteger(t.packetId) || t.packetId < 0 || t.packetId > 65535) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"invalid_packet_id\",\n\t\t\t\tidx,\n\t\t\t\t`endpoint[${idx}] track \"${t.name}\" packetId must be 0..65535; got ${t.packetId}`,\n\t\t\t);\n\t\t}\n\t\tif (seenPids.has(t.packetId)) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"duplicate_packet_id\",\n\t\t\t\tidx,\n\t\t\t\t`endpoint[${idx}] duplicate packetId ${t.packetId}`,\n\t\t\t);\n\t\t}\n\t\tseenPids.add(t.packetId);\n\t}\n\n\tif (ep.bandwidth !== undefined && (!Number.isFinite(ep.bandwidth) || ep.bandwidth <= 0)) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"invalid_bandwidth\",\n\t\t\tidx,\n\t\t\t`endpoint[${idx}] bandwidth must be positive; got ${ep.bandwidth}`,\n\t\t);\n\t}\n\n\tconst tupleKey = `${ep.sourceAddress ?? \"\"}|${ep.groupAddress}|${ep.port}`;\n\tif (seenTuples.has(tupleKey)) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"duplicate_endpoint_tuple\",\n\t\t\tidx,\n\t\t\t`endpoint[${idx}] duplicates (sourceAddress, groupAddress, port) tuple \"${tupleKey}\"`,\n\t\t);\n\t}\n\tseenTuples.add(tupleKey);\n\n\tconst out: MulticastEndpoint = {\n\t\tprotocol: ep.protocol,\n\t\tgroupAddress: ep.groupAddress,\n\t\tport: ep.port,\n\t\ttracks: ep.tracks.map((t) => ({ name: t.name, packetId: t.packetId })),\n\t};\n\tif (ep.sourceAddress !== undefined) out.sourceAddress = ep.sourceAddress;\n\tif (ep.relayAddress !== undefined) out.relayAddress = ep.relayAddress;\n\tif (ep.bandwidth !== undefined) out.bandwidth = ep.bandwidth;\n\treturn out;\n}\n\nfunction isMulticastGroupAddress(addr: string): boolean {\n\tif (addr.includes(\":\")) {\n\t\t// IPv6: ff00::/8. Prefix-only check; full IPv6 syntax validation\n\t\t// is delegated to the OS bind() call downstream.\n\t\treturn /^ff[0-9a-f]{2}:/i.test(addr);\n\t}\n\tconst m = /^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/.exec(addr);\n\tif (!m) return false;\n\tfor (let i = 1; i <= 4; i++) {\n\t\tconst v = Number(m[i]);\n\t\tif (!Number.isInteger(v) || v < 0 || v > 255) return false;\n\t}\n\tconst first = Number(m[1]);\n\treturn first >= 224 && first <= 239;\n}\n\nfunction isSsmGroupAddress(addr: string): boolean {\n\tif (addr.includes(\":\")) {\n\t\t// SSM IPv6: ff3x::/32 per RFC 3306 \u00A74. Requires P=1 + T=1 (the `3`\n\t\t// nibble) AND the second 16-bit hextet to be all-zero (RFC 3306's\n\t\t// \"prefix length = 0\" \u2192 next 32 bits are 0). The regex matches\n\t\t// `ff3?:0000:` collapsed forms (`ff3e::`, `ff3e:0::`, `ff3e:0:`,\n\t\t// `ff3e:0000:`) and rejects `ff3e:beef::1` etc.\n\t\treturn /^ff3[0-9a-f]:0{0,4}:/i.test(addr);\n\t}\n\tconst m = /^(\\d{1,3})\\./.exec(addr);\n\treturn m !== null && Number(m[1]) === 232;\n}\n\n// Env-var helper (BLO-3337): read MOQCAST_MULTICAST_* keys and route\n// through multicastFromConfig so all per-endpoint invariants apply.\n\n/**\n * Read `MOQCAST_MULTICAST_*` env vars and return a\n * `MulticastCatalogConfig`. Returns `undefined` when no per-endpoint\n * key is set.\n *\n * Env contract \u2014 per-endpoint keys take an optional non-negative index:\n *\n *   MOQCAST_MULTICAST[_<idx>]_PROTOCOL=ssm\n *   MOQCAST_MULTICAST[_<idx>]_GROUP=232.1.1.1\n *   MOQCAST_MULTICAST[_<idx>]_PORT=5004\n *   MOQCAST_MULTICAST[_<idx>]_SOURCE=10.0.0.20      (required for ssm)\n *   MOQCAST_MULTICAST[_<idx>]_RELAY=amt.example.com (required for amt)\n *   MOQCAST_MULTICAST[_<idx>]_TRACKS=video:1,audio:3\n *   MOQCAST_MULTICAST[_<idx>]_BANDWIDTH=8000000     (optional, bps)\n *\n *   MOQCAST_MULTICAST_AMT_DISCOVERY=driad           (catalog-level)\n *   MOQCAST_MULTICAST_AMT_RELAY_DNS=relay.example.com (catalog-level)\n *\n * The unindexed form (`MOQCAST_MULTICAST_GROUP`) is exactly index 0;\n * mixing it with explicit `_0_` keys is rejected as ambiguous. Indices\n * need not be contiguous; observed indices are sorted ascending.\n */\nexport function multicastFromEnv(\n\tenv: Record<string, string | undefined> = ((globalThis as { process?: { env?: Record<string, string | undefined> } })\n\t\t.process?.env ?? {}) as Record<string, string | undefined>,\n): MulticastCatalogConfig | undefined {\n\tconst indices = collectMulticastIndices(env);\n\tif (indices.length === 0) {\n\t\t// Catalog-level AMT keys without per-endpoint keys is a\n\t\t// misconfiguration, not a no-op: `MOQCAST_MULTICAST_AMT_DISCOVERY`\n\t\t// only makes sense alongside endpoints to fall back FOR. Throw\n\t\t// loudly instead of silently dropping the request \u2014 a publisher\n\t\t// that meant to declare AMT fallback shouldn't have its config\n\t\t// disappear without any signal.\n\t\tconst strayCatalog = env[\"MOQCAST_MULTICAST_AMT_DISCOVERY\"] !== undefined\n\t\t\t|| env[\"MOQCAST_MULTICAST_AMT_RELAY_DNS\"] !== undefined;\n\t\tif (strayCatalog) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"invalid_env_shape\",\n\t\t\t\tnull,\n\t\t\t\t\"MOQCAST_MULTICAST_AMT_* env keys are set but no per-endpoint keys \" +\n\t\t\t\t\t\"(MOQCAST_MULTICAST_GROUP / _PROTOCOL / _PORT / _TRACKS) were found. \" +\n\t\t\t\t\t\"AMT discovery is a catalog-level fallback for endpoints; declaring it \" +\n\t\t\t\t\t\"with zero endpoints is a misconfiguration.\",\n\t\t\t);\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tconst endpoints: MulticastEndpointInput[] = indices.map((idx) => readEndpointAt(env, idx));\n\n\tconst input: MulticastInput = {\n\t\tendpoints,\n\t\t...(env[\"MOQCAST_MULTICAST_AMT_DISCOVERY\"]\n\t\t\t? {\n\t\t\t\t\tamtFallback: {\n\t\t\t\t\t\tdiscovery: env[\"MOQCAST_MULTICAST_AMT_DISCOVERY\"] as AmtDiscovery,\n\t\t\t\t\t\t...(env[\"MOQCAST_MULTICAST_AMT_RELAY_DNS\"]\n\t\t\t\t\t\t\t? { relayDns: env[\"MOQCAST_MULTICAST_AMT_RELAY_DNS\"] }\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t: {}),\n\t};\n\treturn multicastFromConfig(input);\n}\n\nconst ENV_PER_FIELD = [\"PROTOCOL\", \"GROUP\", \"PORT\", \"SOURCE\", \"RELAY\", \"TRACKS\", \"BANDWIDTH\"];\nconst ENV_CATALOG_LEVEL = new Set([\"AMT_DISCOVERY\", \"AMT_RELAY_DNS\"]);\n\nfunction collectMulticastIndices(env: Record<string, string | undefined>): number[] {\n\tconst indices = new Set<number>();\n\tlet hasUnindexed = false;\n\tlet hasZeroIndexed = false;\n\n\tfor (const [key, val] of Object.entries(env)) {\n\t\tif (val === undefined) continue;\n\t\tif (!key.startsWith(\"MOQCAST_MULTICAST_\")) continue;\n\t\tconst suffix = key.slice(\"MOQCAST_MULTICAST_\".length);\n\t\tif (ENV_CATALOG_LEVEL.has(suffix)) continue;\n\n\t\tconst m = /^(\\d+)_(.+)$/.exec(suffix);\n\t\tif (m) {\n\t\t\tconst idx = Number(m[1]);\n\t\t\tconst field = m[2];\n\t\t\tif (!ENV_PER_FIELD.includes(field)) continue;\n\t\t\tif (idx === 0) hasZeroIndexed = true;\n\t\t\tindices.add(idx);\n\t\t} else if (ENV_PER_FIELD.includes(suffix)) {\n\t\t\thasUnindexed = true;\n\t\t\tindices.add(0);\n\t\t}\n\t}\n\n\tif (hasUnindexed && hasZeroIndexed) {\n\t\tthrow new MulticastInputError(\n\t\t\t\"invalid_env_shape\",\n\t\t\tnull,\n\t\t\t\"MOQCAST_MULTICAST_* env contract: cannot mix unindexed keys (MOQCAST_MULTICAST_GROUP) \" +\n\t\t\t\t\"with explicitly-indexed keys at index 0 (MOQCAST_MULTICAST_0_GROUP) \u2014 they refer to \" +\n\t\t\t\t\"the same endpoint. Use one form consistently.\",\n\t\t);\n\t}\n\n\treturn [...indices].sort((a, b) => a - b);\n}\n\nfunction readEndpointAt(env: Record<string, string | undefined>, idx: number): MulticastEndpointInput {\n\tconst lookup = (field: string): string | undefined => {\n\t\tif (idx === 0) {\n\t\t\treturn env[`MOQCAST_MULTICAST_${field}`] ?? env[`MOQCAST_MULTICAST_0_${field}`];\n\t\t}\n\t\treturn env[`MOQCAST_MULTICAST_${idx}_${field}`];\n\t};\n\n\tconst portStr = lookup(\"PORT\");\n\tconst port = portStr !== undefined ? Number(portStr) : NaN;\n\tconst tracks = parseTracksEnv(lookup(\"TRACKS\"), idx);\n\tconst bandwidthStr = lookup(\"BANDWIDTH\");\n\tconst bandwidth = bandwidthStr !== undefined ? Number(bandwidthStr) : undefined;\n\tconst source = lookup(\"SOURCE\");\n\tconst relay = lookup(\"RELAY\");\n\n\treturn {\n\t\tprotocol: lookup(\"PROTOCOL\") as MulticastProtocol,\n\t\tgroupAddress: lookup(\"GROUP\") ?? \"\",\n\t\tport,\n\t\ttracks,\n\t\t...(source ? { sourceAddress: source } : {}),\n\t\t...(relay ? { relayAddress: relay } : {}),\n\t\t...(bandwidth !== undefined ? { bandwidth } : {}),\n\t};\n}\n\nfunction parseTracksEnv(raw: string | undefined, endpointIdx: number): MulticastTrackObject[] {\n\tif (!raw || raw.length === 0) return [];\n\treturn raw.split(\",\").map((entry, i) => {\n\t\tconst colon = entry.lastIndexOf(\":\");\n\t\tif (colon < 0) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"invalid_track_name\",\n\t\t\t\tendpointIdx,\n\t\t\t\t`endpoint[${endpointIdx}] TRACKS[${i}] missing \":\" \u2014 expected \"name:packetId\", got ${JSON.stringify(entry)}`,\n\t\t\t);\n\t\t}\n\t\tconst name = entry.slice(0, colon).trim();\n\t\tconst idStr = entry.slice(colon + 1).trim();\n\t\tconst packetId = Number(idStr);\n\t\tif (!name || idStr.length === 0 || !Number.isFinite(packetId) || !Number.isInteger(packetId)) {\n\t\t\tthrow new MulticastInputError(\n\t\t\t\t\"invalid_packet_id\",\n\t\t\t\tendpointIdx,\n\t\t\t\t`endpoint[${endpointIdx}] TRACKS[${i}] entry malformed (need \"name:integer\"): ${JSON.stringify(entry)}`,\n\t\t\t);\n\t\t}\n\t\treturn { name, packetId };\n\t});\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/multicast-manager.d.ts

@@ -0,0 +1,330 @@
+/**
+ * Facade composing FECManager + MmtpRouter + MulticastTransport.
+ *
+ * Public methods delegate to the decomposed components. Applications that
+ * need individual layers can use them directly:
+ * - FECManager  — codec-agnostic FEC decode
+ * - MmtpRouter  — MMTP packet parsing + frame routing
+ * - MulticastTransport — SSM join/socket/watchdog
+ */
+import { FECManager, type FECManagerConfig, type WasmFecDecoder } from "./fec-manager.js";
+import { MmtpRouter, type FrameCallback, type ManifestIdentityResolver, type MmtpIngressContext, type TrackPacketCallback } from "./mmtp-router.js";
+import { MulticastTransport } from "./multicast-transport.js";
+import type { FecWorkerClient, FecTrackStats } from "@blockcast/fec-worker";
+import type { MfuReassemblerBackend } from "./mfu-reassembler.js";
+import type { MfuReassemblyPolicy } from "./mfu-reassembly-policy.js";
+import type { ManifestObjectIdentity, ManifestVerifier } from "@blockcast/mmt-manifest-verify";
+import type { BlockAssemblerConfig, CmafBlockSample } from "./cmaf-block-assembler.js";
+export interface MulticastEndpointConfig {
+    sourceAddress: string;
+    groupAddress: string;
+    port: number;
+    /** Explicit gateway transport policy. Omitted means gateway-selected auto mode. */
+    mode?: 'auto' | 'native' | 'tunnel';
+    /** AMT relay hostname/IP from catalog endpoint. */
+    relayAddress?: string;
+    /** AMT relay port from catalog endpoint. */
+    relayPort?: number;
+    /** AMT relay hostname/IP from player/UI overrides. */
+    amtRelay?: string;
+    amtRelayPort?: number;
+    /** MMTP packet IDs to forward before data enters the page transport queue. */
+    packetIds?: number[];
+    /** Exact catalog tracks carried by this physical multicast endpoint. */
+    tracks?: MmtpIngressContext["tracks"];
+    fecK?: number;
+    /** Number of repair symbols per FEC block (P). Used to size recovery reorder latency. */
+    fecRepairSymbols?: number;
+    /** Symbol size in bytes (T). NOT repair count. */
+    fecSymbolSize?: number;
+    /** Catalog fec.reorderToleranceMs — signaled jitter/reorder allowance, ADDED
+     *  to the derived delivery window. Never a multiplier on the span, so one
+     *  network yields the same slack on a wide video span and a narrow audio one.
+     *
+     *  Absence widens the window by zero rather than throwing, unlike the datagram
+     *  MFU deadline in hang-mmt-fec. The distinction is which way absence fails:
+     *  there the tolerance IS the deadline's slack term and guessing one invents
+     *  a reorder budget, so it must fail loud; here the window is already fully
+     *  derived from other catalog values and the tolerance only widens it, so
+     *  adding nothing is the identity and errs toward earlier failback. Do not
+     *  "harmonize" this into a throw, and do not turn the zero into a default. */
+    fecReorderToleranceMs?: number;
+    fecInterleaveDepthMs?: number;
+    /** Aggregate endpoint bandwidth in bits per second from the multicast catalog. */
+    bandwidth?: number;
+    fps?: number;
+    /** Catalog-derived lower bound for packet-silence failback (for example, keyframe repair cadence). */
+    minimumFailbackWindowMs?: number;
+}
+export interface MulticastManagerOptions {
+    /**
+     * MFU reassembly timeout (ms). Threaded to the inner MmtpRouter (and its
+     * MmtpContainerParser). Caller derives from catalog `fec.interleaveDepthMs`,
+     * which is already in milliseconds — `moqenc_mmt.c` converts
+     * `depth_ms = fec_depth * (1000/fps)` before populating the catalog.
+     * Defaults to 1000ms (with parser warning) when omitted.
+     */
+    mfuTimeoutMs?: number;
+    reassemblyPolicy?: MfuReassemblyPolicy;
+    reassembler?: MfuReassemblerBackend;
+    maxBufferedMfus?: number;
+    manifestVerifier?: ManifestVerifier;
+    manifestVerifierOwnership?: "caller" | "router";
+    resolveManifestIdentity?: (packetId: number, sbn: number, esi: number, catalogTrackName?: string) => ManifestObjectIdentity | null;
+    resolveManifestIdentityForRoute?: ManifestIdentityResolver;
+}
+export interface RepairBlockIdentity {
+    readonly packetId: number;
+    /** Non-empty catalog identity, or null when the producer has no track name. */
+    readonly catalogTrackName: string | null;
+    readonly sbn: number;
+}
+export type RepairLifecycleEvent = {
+    readonly version: 1;
+    readonly type: "requested";
+    readonly block: RepairBlockIdentity;
+} | {
+    readonly version: 1;
+    readonly type: "recovered" | "failed";
+    readonly block: RepairBlockIdentity;
+    readonly symbols: {
+        readonly multicast: number;
+        readonly moq: number;
+    };
+};
+export type RepairLifecycleObserver = (event: RepairLifecycleEvent) => void;
+export interface RepairLifecycleSource {
+    addRepairLifecycleObserver(observer: RepairLifecycleObserver): () => void;
+}
+/** Minimal event shape accepted by application-owned event targets. */
+export interface RepairLifecycleApplicationEvent {
+    readonly type: string;
+    readonly detail: RepairLifecycleEvent;
+}
+/** DOM EventTarget event shape, including the Node 18 Event fallback. */
+export interface RepairLifecycleDomEvent extends Event {
+    readonly detail: RepairLifecycleEvent;
+}
+/** Structural target contract shared by DOM and Closure-style event targets. */
+export interface RepairLifecycleEventTarget<TEvent extends RepairLifecycleApplicationEvent> {
+    dispatchEvent(event: TEvent): unknown;
+}
+export interface RepairLifecycleEventOptions<TEvent extends RepairLifecycleApplicationEvent = RepairLifecycleDomEvent> {
+    bubbles?: boolean;
+    composed?: boolean;
+    createEvent?: RepairLifecycleEventFactory<TEvent>;
+}
+export type RepairLifecycleEventFactory<TEvent extends RepairLifecycleApplicationEvent = RepairLifecycleDomEvent> = (type: typeof REPAIR_LIFECYCLE_EVENT_TYPE, detail: RepairLifecycleEvent, options: Readonly<{
+    bubbles: boolean;
+    composed: boolean;
+}>) => TEvent;
+/** Public EventTarget event carrying an immutable RepairLifecycleEvent detail. */
+export declare const REPAIR_LIFECYCLE_EVENT_TYPE = "repairlifecycle";
+/** Diagnostic JSON-lines prefix. Never consume logs as a lifecycle API. */
+export declare const REPAIR_LIFECYCLE_LOG_PREFIX = "[MulticastManager] repair-lifecycle ";
+/** Runtime guard for observer, DOM-event, and cross-realm consumers. */
+export declare function isRepairLifecycleEvent(value: unknown): value is RepairLifecycleEvent;
+/**
+ * Forward typed repair lifecycle observations through an application-owned
+ * EventTarget. The adapter retains no history; the returned function detaches
+ * the observer.
+ */
+export declare function forwardRepairLifecycleEvents<TEvent extends RepairLifecycleApplicationEvent>(source: RepairLifecycleSource, target: RepairLifecycleEventTarget<TEvent>, options: RepairLifecycleEventOptions<TEvent> & {
+    createEvent: RepairLifecycleEventFactory<TEvent>;
+}): () => void;
+export declare function forwardRepairLifecycleEvents(source: RepairLifecycleSource, target: EventTarget, options?: RepairLifecycleEventOptions): () => void;
+/** Catalog track descriptor for configureMultiTrack(). */
+export interface MultiTrackCatalogTrack {
+    name: string;
+    altGroup?: number;
+    framerate?: number;
+    fec?: unknown;
+    /** PacketId for testability — in production, learned at subscribe time (Plan 03). */
+    packetId?: number;
+}
+/** Multi-track catalog shape accepted by configureMultiTrack(). */
+export interface MultiTrackCatalog {
+    tracks: MultiTrackCatalogTrack[];
+}
+/** Creates one stateful synchronous FEC decoder per physical catalog stream. */
+export type WasmFecDecoderFactory = (track: Readonly<MultiTrackCatalogTrack>) => WasmFecDecoder;
+export declare class MulticastManager {
+    #private;
+    constructor(options?: MulticastManagerOptions);
+    get fecManager(): FECManager;
+    get router(): MmtpRouter;
+    get transport(): MulticastTransport;
+    get reassembler(): MfuReassemblerBackend;
+    get diagnostics(): {
+        _fec: {
+            timeoutMs: number;
+            activeBlocks: number;
+            completedBlocks: number;
+            pendingCounts: {
+                [k: string]: number;
+            };
+            fpsDetected: boolean;
+            interleaveDepthMs: number;
+            startupAlignedPackets: number[];
+            startupPartialBlocks: number;
+            startupRepairReadyPackets: number[];
+            startupRepairFailOpenPackets: number[];
+            pendingWorkerCleanups: number;
+            repairTrackedBlocks: number;
+            lifecycleTrace: {
+                atMs: number;
+                event: "repair-requested" | "repair-arrived" | "timeout-queued" | "cleanup-ack" | "recovered" | "failed";
+                packetId: number;
+                sbn: number;
+                catalogTrackName?: string;
+                sourceCount: number;
+                sourceEsis: number[];
+                repairRsIds: number[];
+                decoderPath: "worker" | "sync" | "none";
+                deadlineRemainingMs?: number;
+                pendingCleanup: boolean;
+                rsId?: number;
+            }[];
+        };
+    };
+    get stats(): import("./multicast-transport.js").MulticastTransportStats;
+    get fecStats(): import("./fec-manager.js").FecStats;
+    /** The raw WASM decoder for stats access */
+    get wasmDecoder(): WasmFecDecoder | null;
+    setFecDecoder(packetId: number, client: WasmFecDecoder, k: number, trackType?: "video" | "audio", config?: FECManagerConfig, catalogTrackName?: string): void;
+    /**
+     * Register a Worker-backed FEC decoder for a specific packetId (track).
+     * Worker-backed tracks decode asynchronously — recovered frames arrive via
+     * FECManager.onBlockRecovered callback instead of feedSourceSymbol return value.
+     */
+    setFecWorker(packetId: number, client: FecWorkerClient, trackType: "video" | "audio", config: FECManagerConfig, catalogTrackName?: string): void;
+    /** Register callback for Worker-level FecTrackStats updates. */
+    setOnFecStatsUpdate(cb: (packetId: number, stats: FecTrackStats) => void): void;
+    setFramerate(fps: number): void;
+    /**
+     * Configure one track's FEC geometry, block mapper, and block-inactivity
+     * deadline from that track's own catalog values, then re-reduce the
+     * stream-global deadlines across every registered track.
+     *
+     * This is the packet-specific replacement for the global `configureFec`
+     * side effects: per-track concerns stay per-track, and the genuinely
+     * stream-global ones (transport failback, router MFU timeout, router reorder
+     * window) become an explicit max reduction instead of a last-caller-wins race
+     * in which whichever track configured last silently set the whole stream's
+     * timing.
+     */
+    configureTrackFec(packetId: number, config: Pick<MulticastEndpointConfig, "fecK" | "fecRepairSymbols" | "fecSymbolSize" | "fecInterleaveDepthMs" | "fecReorderToleranceMs" | "fps" | "bandwidth" | "minimumFailbackWindowMs">): void;
+    configureFec(config: Pick<MulticastEndpointConfig, "fecK" | "fecRepairSymbols" | "fecSymbolSize" | "fecInterleaveDepthMs" | "fecReorderToleranceMs" | "fps" | "bandwidth" | "minimumFailbackWindowMs">): void;
+    /** Register callback for track type discovery (from init data / inline signaling). */
+    onTrackTypeDiscovered(cb: (packetId: number, trackType: "video" | "audio") => void): void;
+    setPacketIdType(packetId: number, trackType: "video" | "audio"): void;
+    /**
+     * Set the keyframe loss timeout on the inner MmtpRouter.
+     * Must be called BEFORE setPacketIdType('video').
+     * Derive from explicit keyframe/group duration:
+     * Math.ceil(groupDurationMs * KEYFRAME_LOST_TIMEOUT_SLACK).
+     */
+    setKeyframeLostTimeoutMs(ms: number): void;
+    setMfuTimeoutMs(ms: number): void;
+    setTrackCodec(packetId: number, codec: string): void;
+    onVideoFrame(cb: FrameCallback): void;
+    onAudioFrame(cb: FrameCallback): void;
+    onTrackFrame(packetId: number, cb: FrameCallback): void;
+    onTrackPacket(packetId: number, cb: TrackPacketCallback): void;
+    onInitSegment(cb: (data: Uint8Array) => void): void;
+    onTrackInit(packetId: number, cb: (data: Uint8Array) => void): void;
+    onFecBlockStarted(cb: (sbn: number, packetId: number) => void): void;
+    /** Unrecoverable-FEC-block signal. Players drive decoder recovery from this
+     *  (a starved decoder cannot resync on its own once the block is abandoned). */
+    onFecBlockFailed(cb: (sbn: number, packetId: number, catalogTrackName?: string) => void): void;
+    enableMseAssembler(packetId: number, config: Omit<BlockAssemblerConfig, "k">, catalogTrackName?: string): import("./cmaf-block-assembler.js").CmafBlockAssembler;
+    onMseSegment(packetId: number, cb: (segment: Uint8Array) => void, catalogTrackName?: string): void;
+    onMseSample(packetId: number, cb: (sample: CmafBlockSample) => void, catalogTrackName?: string): void;
+    onMseInitSegment(packetId: number, cb: (init: Uint8Array) => void, catalogTrackName?: string): void;
+    emitMseInit(packetId: number, catalogTrackName?: string): void;
+    markExternalVideoSync(packetId?: number, catalogTrackName?: string): void;
+    onTakeover(cb: () => void): void;
+    onFailback(cb: () => void): void;
+    confirmVideo(): void;
+    confirmAudio(): void;
+    static isAvailable(): boolean;
+    join(config: MulticastEndpointConfig): Promise<boolean>;
+    /** Feed a raw packet from an external source (AMT tunnel, ASM subscription).
+     *
+     *  For MoQ-unicast-fallback mode (no SSM bridge), call
+     *  `manager.router.feedPacket(packet, "moq")` directly to bypass
+     *  MulticastTransport's takeover/watchdog/failback gates while preserving
+     *  transport attribution in FEC path counters.
+     *  The `router` accessor above is already public.
+     */
+    feedPacket(data: ArrayBuffer | Uint8Array, ingress?: MmtpIngressContext): void;
+    /** Process a repair packet from MoQ (reliable QUIC). */
+    processRepairFromMoQ(packet: Uint8Array, ownerPacketId?: number, catalogTrackName?: string): void;
+    /** Route a Worker-recovered FEC block through the MMTP parser + dedup pipeline. */
+    routeRecoveredBlock(blockId: number, data: Uint8Array, packetId: number, catalogTrackName?: string): void;
+    /** Route one Worker-recovered source symbol through the MMTP parser + dedup pipeline. */
+    routeRecoveredSymbol(blockId: number, data: Uint8Array, packetId: number, esi?: number, catalogTrackName?: string): void;
+    /**
+     * Configure the manager for a multi-track (base/delta/repair) CMAF switching set.
+     *
+     * D-04: Validates completeness via validateSwitchingSet — throws if incomplete.
+     * D-07: Applies per-track FEC configs (base+delta get decoders; repair does not).
+     * D-17: Builds altGroup → track-name index for getSwitchingSet().
+     * D-26: Registers packetId → TrackRole on MmtpRouter for block-complete fanout.
+     *
+     * @param catalog - Multi-track catalog (tracks array with name, altGroup, fec, packetId).
+     * @param wasmDecoderSource - One WASM FEC decoder for a single FEC stream, or
+     *                            a factory returning a distinct decoder per stream.
+     */
+    configureMultiTrack(catalog: MultiTrackCatalog, wasmDecoderSource?: WasmFecDecoder | WasmFecDecoderFactory): void;
+    /**
+     * Return the track names belonging to the given altGroup switching set.
+     * D-17: altGroup groups base+delta+repair into one switching set.
+     *
+     * @param altGroup - The altGroup number to look up.
+     * @returns Array of track names in that switching set (empty if none).
+     */
+    getSwitchingSet(altGroup: number): string[];
+    /**
+     * Register callback fired when a repair fetch should be issued for an FEC block.
+     *
+     * D-28: At most one outstanding repair fetch per (packetId, sbn) block.
+     * clearRepairForBlock fires automatically when the block resolves (via
+     * FECManager.onRepairResolved); call it manually only on fetch failure
+     * paths the FEC layer cannot observe (fetch error, range not retained,
+     * transport timeout) so a stuck fetch cannot wedge the block's slot.
+     *
+     * Registering also arms the FEC repair deadline: each block gets a one-shot
+     * timer for the derived K-symbol source-production horizon; a block still
+     * short of K when it fires requests repair here. Failure accounting timing
+     * is unchanged.
+     */
+    onRepairSubscribe(cb: (sbn: number, packetId: number, catalogTrackName?: string) => void): void;
+    /**
+     * Observe causal repair lifecycle events without retaining snapshots in the
+     * transport. Returns an unsubscribe function.
+     */
+    addRepairLifecycleObserver(observer: RepairLifecycleObserver): () => void;
+    /** Observe per-stream epoch resets (used by repair transports to abort I/O). */
+    addTrackResetObserver(observer: (packetId: number, catalogTrackName: string) => void): () => void;
+    /** Begin a fresh retained-replay epoch for one physical media stream. */
+    resetTrack(packetId: number, catalogTrackName: string): void;
+    /**
+     * Request a repair-track fetch for the given FEC block.
+     *
+     * D-28: duplicate requests for the same (packetId, sbn) are suppressed
+     * until clearRepairForBlock is called.
+     *
+     * @param sbn - Source Block Number identifying the FEC block needing repair.
+     * @param packetId - MMTP packet_id owning the block (video/audio tracks have
+     *   independent SBN spaces, so the in-flight key must be composite).
+     */
+    requestRepairForBlock(sbn: number, packetId: number, catalogTrackName?: string): void;
+    /**
+     * Clear in-flight repair state for the given block.
+     * Fired automatically when the block resolves; safe to call redundantly.
+     */
+    clearRepairForBlock(sbn: number, packetId: number, catalogTrackName?: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=multicast-manager.d.ts.map

package/dist/multicast-manager.d.ts.map

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