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

package/dist/mfu-reassembly-policy.d.ts

@@ -0,0 +1,24 @@
+export type MfuReassemblyPolicy = ReliableMoqReassemblyPolicy | {
+    transport: 'datagram';
+    deadlineMs: number;
+};
+export interface ReliableMoqReassemblyPolicy {
+    transport: 'reliable-moq';
+    startsAtRandomAccessGroup?: true;
+}
+export type MmtpTrackType = 'video' | 'audio' | null;
+export interface ReliableMoqReassemblyOptions {
+    /**
+     * The transport starts at a complete independently decodable media group.
+     * The parser still requires an observed RAP before decoder startup.
+     */
+    startsAtRandomAccessGroup?: boolean;
+}
+export declare function reliableMoqMfuReassembly(options?: ReliableMoqReassemblyOptions): ReliableMoqReassemblyPolicy;
+export declare function datagramMfuReassembly(deadlineMs: number): MfuReassemblyPolicy;
+/** Validate the complete runtime shape even when a caller bypasses the policy factories. */
+export declare function assertValidMfuReassemblyPolicy(policy: MfuReassemblyPolicy): void;
+export declare function mfuReassemblyTimeoutMs(policy: MfuReassemblyPolicy): number | null;
+/** Resolve the parser reorder window without inferring reliable-stream completion. */
+export declare function mmtpFrameReorderWindowFrames(policy: MfuReassemblyPolicy, configuredWindow?: number): number;
+//# sourceMappingURL=mfu-reassembly-policy.d.ts.map

package/dist/mfu-reassembly-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mfu-reassembly-policy.d.ts","sourceRoot":"","sources":["../src/mfu-reassembly-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,2BAA2B,GAC3B;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,cAAc,CAAA;IACzB,yBAAyB,CAAC,EAAE,IAAI,CAAA;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;AAEpD,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC;AAyBD,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,4BAAiC,GACzC,2BAA2B,CAkB7B;AAQD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAG7E;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA8BhF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAGjF;AAED,sFAAsF;AACtF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,gBAAgB,SAAI,GACnB,MAAM,CAgBR"}

package/dist/mfu-reassembly-policy.js

@@ -0,0 +1,99 @@
+// src/mfu-reassembly-policy.ts
+function validateReliableMoqOptionShape(value) {
+  const unsupported = Object.keys(value).filter(
+    (key) => key !== "transport" && key !== "startsAtRandomAccessGroup"
+  );
+  if (unsupported.length > 0) {
+    if (unsupported.includes("maxRacingGroups")) {
+      throw new Error(
+        "[MFU reassembly] maxRacingGroups was removed; reliable MoQ completion is transport-owned"
+      );
+    }
+    throw new Error(
+      `[MFU reassembly] unsupported reliable MoQ option(s): ${unsupported.join(", ")}`
+    );
+  }
+  const startsAtRandomAccessGroup = value["startsAtRandomAccessGroup"];
+  if (typeof startsAtRandomAccessGroup !== "boolean" && startsAtRandomAccessGroup !== void 0) {
+    throw new Error("[MFU reassembly] startsAtRandomAccessGroup must be boolean");
+  }
+}
+function reliableMoqMfuReassembly(options = {}) {
+  if (arguments.length > 1 || typeof options !== "object" || options === null || Array.isArray(options)) {
+    throw new Error(
+      "[MFU reassembly] the positional maxRacingGroups API was removed; pass a reliable MoQ options object"
+    );
+  }
+  validateReliableMoqOptionShape(options);
+  return options.startsAtRandomAccessGroup ? {
+    transport: "reliable-moq",
+    startsAtRandomAccessGroup: true
+  } : { transport: "reliable-moq" };
+}
+function assertValidDatagramDeadline(deadlineMs) {
+  if (typeof deadlineMs !== "number" || !Number.isFinite(deadlineMs) || deadlineMs <= 0) {
+    throw new Error("[MFU reassembly] datagram deadlineMs must be a finite number > 0");
+  }
+}
+function datagramMfuReassembly(deadlineMs) {
+  assertValidDatagramDeadline(deadlineMs);
+  return { transport: "datagram", deadlineMs };
+}
+function assertValidMfuReassemblyPolicy(policy) {
+  if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
+    throw new Error("[MFU reassembly] policy must be an object");
+  }
+  const value = policy;
+  if (value["transport"] === "reliable-moq") {
+    validateReliableMoqOptionShape(value);
+    if (value["startsAtRandomAccessGroup"] === false) {
+      throw new Error(
+        "[MFU reassembly] startsAtRandomAccessGroup must be true when present in a policy"
+      );
+    }
+    return;
+  }
+  if (value["transport"] === "datagram") {
+    const unsupported = Object.keys(value).filter(
+      (key) => key !== "transport" && key !== "deadlineMs"
+    );
+    if (unsupported.length > 0) {
+      throw new Error(
+        `[MFU reassembly] unsupported datagram option(s): ${unsupported.join(", ")}`
+      );
+    }
+    assertValidDatagramDeadline(value["deadlineMs"]);
+    return;
+  }
+  throw new Error(
+    `[MFU reassembly] unsupported transport: ${String(value["transport"])}`
+  );
+}
+function mfuReassemblyTimeoutMs(policy) {
+  assertValidMfuReassemblyPolicy(policy);
+  return policy.transport === "reliable-moq" ? null : policy.deadlineMs;
+}
+function mmtpFrameReorderWindowFrames(policy, configuredWindow = 0) {
+  assertValidMfuReassemblyPolicy(policy);
+  if (!Number.isFinite(configuredWindow) || configuredWindow < 0) {
+    throw new Error("[MFU reassembly] configuredWindow must be a finite number >= 0");
+  }
+  const requested = Math.ceil(configuredWindow);
+  if (policy.transport === "reliable-moq") {
+    if (requested > 0) {
+      throw new Error(
+        "[MFU reassembly] reliable MoQ paths do not accept a frame reorder window in the parser"
+      );
+    }
+    return 0;
+  }
+  return requested;
+}
+export {
+  assertValidMfuReassemblyPolicy,
+  datagramMfuReassembly,
+  mfuReassemblyTimeoutMs,
+  mmtpFrameReorderWindowFrames,
+  reliableMoqMfuReassembly
+};
+//# sourceMappingURL=mfu-reassembly-policy.js.map

package/dist/mfu-reassembly-policy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/mfu-reassembly-policy.ts"],
+  "sourcesContent": ["export type MfuReassemblyPolicy =\n  | ReliableMoqReassemblyPolicy\n  | { transport: 'datagram'; deadlineMs: number }\n\nexport interface ReliableMoqReassemblyPolicy {\n  transport: 'reliable-moq'\n  startsAtRandomAccessGroup?: true\n}\n\nexport type MmtpTrackType = 'video' | 'audio' | null\n\nexport interface ReliableMoqReassemblyOptions {\n  /**\n   * The transport starts at a complete independently decodable media group.\n   * The parser still requires an observed RAP before decoder startup.\n   */\n  startsAtRandomAccessGroup?: boolean\n}\n\nfunction validateReliableMoqOptionShape(value: Record<string, unknown>): void {\n  const unsupported = Object.keys(value).filter(\n    key => key !== 'transport' && key !== 'startsAtRandomAccessGroup',\n  )\n  if (unsupported.length > 0) {\n    if (unsupported.includes('maxRacingGroups')) {\n      throw new Error(\n        '[MFU reassembly] maxRacingGroups was removed; reliable MoQ completion is transport-owned',\n      )\n    }\n    throw new Error(\n      `[MFU reassembly] unsupported reliable MoQ option(s): ${unsupported.join(', ')}`,\n    )\n  }\n  const startsAtRandomAccessGroup = value['startsAtRandomAccessGroup']\n  if (\n    typeof startsAtRandomAccessGroup !== 'boolean' &&\n    startsAtRandomAccessGroup !== undefined\n  ) {\n    throw new Error('[MFU reassembly] startsAtRandomAccessGroup must be boolean')\n  }\n}\n\nexport function reliableMoqMfuReassembly(\n  options: ReliableMoqReassemblyOptions = {},\n): ReliableMoqReassemblyPolicy {\n  if (\n    arguments.length > 1 ||\n    typeof options !== 'object' ||\n    options === null ||\n    Array.isArray(options)\n  ) {\n    throw new Error(\n      '[MFU reassembly] the positional maxRacingGroups API was removed; pass a reliable MoQ options object',\n    )\n  }\n  validateReliableMoqOptionShape(options as Record<string, unknown>)\n  return options.startsAtRandomAccessGroup\n    ? {\n        transport: 'reliable-moq',\n        startsAtRandomAccessGroup: true,\n      }\n    : { transport: 'reliable-moq' }\n}\n\nfunction assertValidDatagramDeadline(deadlineMs: unknown): asserts deadlineMs is number {\n  if (typeof deadlineMs !== 'number' || !Number.isFinite(deadlineMs) || deadlineMs <= 0) {\n    throw new Error('[MFU reassembly] datagram deadlineMs must be a finite number > 0')\n  }\n}\n\nexport function datagramMfuReassembly(deadlineMs: number): MfuReassemblyPolicy {\n  assertValidDatagramDeadline(deadlineMs)\n  return { transport: 'datagram', deadlineMs }\n}\n\n/** Validate the complete runtime shape even when a caller bypasses the policy factories. */\nexport function assertValidMfuReassemblyPolicy(policy: MfuReassemblyPolicy): void {\n  if (typeof policy !== 'object' || policy === null || Array.isArray(policy)) {\n    throw new Error('[MFU reassembly] policy must be an object')\n  }\n\n  const value = policy as unknown as Record<string, unknown>\n  if (value['transport'] === 'reliable-moq') {\n    validateReliableMoqOptionShape(value)\n    if (value['startsAtRandomAccessGroup'] === false) {\n      throw new Error(\n        '[MFU reassembly] startsAtRandomAccessGroup must be true when present in a policy',\n      )\n    }\n    return\n  }\n  if (value['transport'] === 'datagram') {\n    const unsupported = Object.keys(value).filter(\n      key => key !== 'transport' && key !== 'deadlineMs',\n    )\n    if (unsupported.length > 0) {\n      throw new Error(\n        `[MFU reassembly] unsupported datagram option(s): ${unsupported.join(', ')}`,\n      )\n    }\n    assertValidDatagramDeadline(value['deadlineMs'])\n    return\n  }\n  throw new Error(\n    `[MFU reassembly] unsupported transport: ${String(value['transport'])}`,\n  )\n}\n\nexport function mfuReassemblyTimeoutMs(policy: MfuReassemblyPolicy): number | null {\n  assertValidMfuReassemblyPolicy(policy)\n  return policy.transport === 'reliable-moq' ? null : policy.deadlineMs\n}\n\n/** Resolve the parser reorder window without inferring reliable-stream completion. */\nexport function mmtpFrameReorderWindowFrames(\n  policy: MfuReassemblyPolicy,\n  configuredWindow = 0,\n): number {\n  assertValidMfuReassemblyPolicy(policy)\n  if (!Number.isFinite(configuredWindow) || configuredWindow < 0) {\n    throw new Error('[MFU reassembly] configuredWindow must be a finite number >= 0')\n  }\n\n  const requested = Math.ceil(configuredWindow)\n  if (policy.transport === 'reliable-moq') {\n    if (requested > 0) {\n      throw new Error(\n        '[MFU reassembly] reliable MoQ paths do not accept a frame reorder window in the parser',\n      )\n    }\n    return 0\n  }\n  return requested\n}\n"],
+  "mappings": ";AAmBA,SAAS,+BAA+B,OAAsC;AAC5E,QAAM,cAAc,OAAO,KAAK,KAAK,EAAE;AAAA,IACrC,SAAO,QAAQ,eAAe,QAAQ;AAAA,EACxC;AACA,MAAI,YAAY,SAAS,GAAG;AAC1B,QAAI,YAAY,SAAS,iBAAiB,GAAG;AAC3C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,UAAM,IAAI;AAAA,MACR,wDAAwD,YAAY,KAAK,IAAI,CAAC;AAAA,IAChF;AAAA,EACF;AACA,QAAM,4BAA4B,MAAM,2BAA2B;AACnE,MACE,OAAO,8BAA8B,aACrC,8BAA8B,QAC9B;AACA,UAAM,IAAI,MAAM,4DAA4D;AAAA,EAC9E;AACF;AAEO,SAAS,yBACd,UAAwC,CAAC,GACZ;AAC7B,MACE,UAAU,SAAS,KACnB,OAAO,YAAY,YACnB,YAAY,QACZ,MAAM,QAAQ,OAAO,GACrB;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,iCAA+B,OAAkC;AACjE,SAAO,QAAQ,4BACX;AAAA,IACE,WAAW;AAAA,IACX,2BAA2B;AAAA,EAC7B,IACA,EAAE,WAAW,eAAe;AAClC;AAEA,SAAS,4BAA4B,YAAmD;AACtF,MAAI,OAAO,eAAe,YAAY,CAAC,OAAO,SAAS,UAAU,KAAK,cAAc,GAAG;AACrF,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACF;AAEO,SAAS,sBAAsB,YAAyC;AAC7E,8BAA4B,UAAU;AACtC,SAAO,EAAE,WAAW,YAAY,WAAW;AAC7C;AAGO,SAAS,+BAA+B,QAAmC;AAChF,MAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,MAAM,GAAG;AAC1E,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AAEA,QAAM,QAAQ;AACd,MAAI,MAAM,WAAW,MAAM,gBAAgB;AACzC,mCAA+B,KAAK;AACpC,QAAI,MAAM,2BAA2B,MAAM,OAAO;AAChD,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA;AAAA,EACF;AACA,MAAI,MAAM,WAAW,MAAM,YAAY;AACrC,UAAM,cAAc,OAAO,KAAK,KAAK,EAAE;AAAA,MACrC,SAAO,QAAQ,eAAe,QAAQ;AAAA,IACxC;AACA,QAAI,YAAY,SAAS,GAAG;AAC1B,YAAM,IAAI;AAAA,QACR,oDAAoD,YAAY,KAAK,IAAI,CAAC;AAAA,MAC5E;AAAA,IACF;AACA,gCAA4B,MAAM,YAAY,CAAC;AAC/C;AAAA,EACF;AACA,QAAM,IAAI;AAAA,IACR,2CAA2C,OAAO,MAAM,WAAW,CAAC,CAAC;AAAA,EACvE;AACF;AAEO,SAAS,uBAAuB,QAA4C;AACjF,iCAA+B,MAAM;AACrC,SAAO,OAAO,cAAc,iBAAiB,OAAO,OAAO;AAC7D;AAGO,SAAS,6BACd,QACA,mBAAmB,GACX;AACR,iCAA+B,MAAM;AACrC,MAAI,CAAC,OAAO,SAAS,gBAAgB,KAAK,mBAAmB,GAAG;AAC9D,UAAM,IAAI,MAAM,gEAAgE;AAAA,EAClF;AAEA,QAAM,YAAY,KAAK,KAAK,gBAAgB;AAC5C,MAAI,OAAO,cAAc,gBAAgB;AACvC,QAAI,YAAY,GAAG;AACjB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;",
+  "names": []
+}