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

package/dist/index.js

@@ -0,0 +1,330 @@
+// src/index.ts
+import {
+  MFUReassembler,
+  MfuReassemblyError,
+  createFragment,
+  processMMTPWithReassembly
+} from "./mfu-reassembler.js";
+import {
+  SampleCombiner,
+  SampleCombineError
+} from "./sample-combiner.js";
+import { isCompleteFmp4DataUnit } from "./fmp4-completion.js";
+import {
+  extractAvcCFromInitSegment,
+  extractAacAscFromInitSegment,
+  generateFallbackAvcC,
+  extractSpsPpsFromAvcC,
+  avccToAnnexB,
+  extractCodecDescriptionFromAnnexB,
+  codecStringFromAvcC,
+  isAnnexB,
+  isCompleteAvccSample,
+  findAnnexBStartCode,
+  splitAnnexBNalUnits,
+  annexBToAvcc,
+  normalizeH264SampleToAvcc,
+  splitH264SampleNalUnits,
+  classifyH264Keyframe,
+  detectH264Keyframe,
+  mmtpTimestampToMicros,
+  isFmp4InitSegment,
+  wrapAdtsFrame,
+  isHevcCodec,
+  removeEmulationPrevention,
+  splitAvccNalUnits,
+  extractHevcParameterSets,
+  generateHvcCFromParameterSets,
+  extractHevcCodecDescription,
+  hevcVclOnly
+} from "./codec-utils.js";
+import {
+  LOCHeaderExtensionId,
+  FEC_SBN_MAX,
+  FEC_ESI_MAX,
+  encodeFecSourceInfo,
+  decodeFecSourceInfo,
+  FecSourceInfo,
+  AuthTag
+} from "./loc.js";
+import {
+  isFecCatalogConfig,
+  isMulticastTrackObject,
+  isMulticastEndpoint,
+  isMulticastCatalogConfig,
+  isTrackTimingConfig,
+  resolveGroupDurationTicks,
+  resolveGroupDurationMs,
+  validateSwitchingSetTiming,
+  CmsfCatalogValidationError,
+  validateCmsfMmtpCatalog
+} from "./carp-catalog.js";
+import {
+  MulticastInputError,
+  multicastFromConfig,
+  multicastFromEnv
+} from "./multicast-input.js";
+import {
+  getPhase14CatalogOverride,
+  mergeOverrideIntoHangRenditions,
+  mergeOverrideIntoCmsfTracks
+} from "./phase14-catalog-override.js";
+import {
+  MulticastContainerContractError,
+  validateMulticastContainerContract,
+  unwrapMulticastPacket
+} from "./multicast-unwrap.js";
+import {
+  encodeTimestamp,
+  decodeTimestamp,
+  getTimestampSize,
+  decodeLocHeader,
+  decodeLocTimestamp,
+  encodeLocTimestamp
+} from "./timestamp-codec.js";
+import {
+  MmtpToCmaf,
+  encodeDataSegment,
+  encodeMultiSampleSegment,
+  buildVideoInitSegment,
+  buildAudioInitSegment,
+  generateGreenFillNAL,
+  generateSilenceFrame
+} from "./mmtp-to-cmaf.js";
+import {
+  getPacketType,
+  isSignalingPacket,
+  isSourcePacket,
+  classifyPacket
+} from "./signaling.js";
+import {
+  CmafBlockAssembler
+} from "./cmaf-block-assembler.js";
+import {
+  CmafGroupBatcher
+} from "./cmaf-group-batcher.js";
+import {
+  FECManager
+} from "./fec-manager.js";
+import {
+  MmtpRouter,
+  KEYFRAME_LOST_TIMEOUT_SLACK
+} from "./mmtp-router.js";
+import {
+  MmtpContainerParser
+} from "./mmtp-container-parser.js";
+import {
+  datagramMfuReassembly,
+  reliableMoqMfuReassembly,
+  mmtpFrameReorderWindowFrames,
+  mfuReassemblyTimeoutMs
+} from "./mfu-reassembly-policy.js";
+import {
+  WasmMfuReassembler,
+  resolveGlobalMmtWasmBindings
+} from "./wasm-mfu-reassembler.js";
+import {
+  createWasmMmtpContainerParser
+} from "./wasm-mmtp-container-parser.js";
+import {
+  NoneCodec,
+  ReedSolomonCodec,
+  createFecCodec
+} from "./fec-codec.js";
+import {
+  MulticastTransport
+} from "./multicast-transport.js";
+import {
+  MulticastManager,
+  forwardRepairLifecycleEvents,
+  isRepairLifecycleEvent,
+  REPAIR_LIFECYCLE_EVENT_TYPE,
+  REPAIR_LIFECYCLE_LOG_PREFIX
+} from "./multicast-manager.js";
+import {
+  setupFecWorkerForTrack
+} from "./fec-worker-setup.js";
+import {
+  MediaRouter,
+  TrackSourceConflictError
+} from "./media-router.js";
+import {
+  groupIdForTicks,
+  groupIdFor,
+  secondsFromTicks,
+  asSeconds,
+  driftCheck
+} from "./align.js";
+import {
+  AudioRingBuffer
+} from "./audio-ring-buffer.js";
+import {
+  MmtpDecodePipeline
+} from "./mmtp-decode-pipeline.js";
+import {
+  TrackPipeline
+} from "./track-pipeline.js";
+import {
+  setupTrackPipeline
+} from "./track-pipeline-setup.js";
+import {
+  parseAacFrameSamples,
+  parseAacSampleRate,
+  parseOpusFrameSamples,
+  frameSamplesFromInit
+} from "./audio-init-parser.js";
+import {
+  TransportPool
+} from "./transport-pool.js";
+import {
+  TrackSession,
+  SessionManager,
+  computeFecDeliveryWindowMs,
+  computeFecDeliveryWindowMediaUnits,
+  computeFecLossWindowMs
+} from "./track-session.js";
+import {
+  FecStarvationDetector
+} from "./fec-starvation-detector.js";
+import {
+  CmcdProducer
+} from "./cmcd-producer.js";
+import {
+  catalogFecInterleaveMs,
+  resolveCatalogTrackFec
+} from "./catalog-fec-params.js";
+import {
+  catalogAmtNetworkSource
+} from "./catalog-network-source.js";
+import {
+  wireRepairFetch
+} from "./repair-fetch.js";
+export {
+  AudioRingBuffer,
+  AuthTag,
+  CmafBlockAssembler,
+  CmafGroupBatcher,
+  CmcdProducer,
+  CmsfCatalogValidationError,
+  FECManager,
+  FEC_ESI_MAX,
+  FEC_SBN_MAX,
+  FecSourceInfo,
+  FecStarvationDetector,
+  KEYFRAME_LOST_TIMEOUT_SLACK,
+  LOCHeaderExtensionId,
+  MFUReassembler,
+  MediaRouter,
+  MfuReassemblyError,
+  MmtpContainerParser,
+  MmtpDecodePipeline,
+  MmtpRouter,
+  MmtpToCmaf,
+  MulticastContainerContractError,
+  MulticastInputError,
+  MulticastManager,
+  MulticastTransport,
+  NoneCodec,
+  REPAIR_LIFECYCLE_EVENT_TYPE,
+  REPAIR_LIFECYCLE_LOG_PREFIX,
+  ReedSolomonCodec,
+  SampleCombineError,
+  SampleCombiner,
+  SessionManager,
+  TrackPipeline,
+  TrackSession,
+  TrackSourceConflictError,
+  TransportPool,
+  WasmMfuReassembler,
+  annexBToAvcc,
+  asSeconds,
+  avccToAnnexB,
+  buildAudioInitSegment,
+  buildVideoInitSegment,
+  catalogAmtNetworkSource,
+  catalogFecInterleaveMs,
+  classifyH264Keyframe,
+  classifyPacket,
+  codecStringFromAvcC,
+  computeFecDeliveryWindowMediaUnits,
+  computeFecDeliveryWindowMs,
+  computeFecLossWindowMs,
+  createFecCodec,
+  createFragment,
+  createWasmMmtpContainerParser,
+  datagramMfuReassembly,
+  decodeFecSourceInfo,
+  decodeLocHeader,
+  decodeLocTimestamp,
+  decodeTimestamp,
+  detectH264Keyframe,
+  driftCheck,
+  encodeDataSegment,
+  encodeFecSourceInfo,
+  encodeLocTimestamp,
+  encodeMultiSampleSegment,
+  encodeTimestamp,
+  extractAacAscFromInitSegment,
+  extractAvcCFromInitSegment,
+  extractCodecDescriptionFromAnnexB,
+  extractHevcCodecDescription,
+  extractHevcParameterSets,
+  extractSpsPpsFromAvcC,
+  findAnnexBStartCode,
+  forwardRepairLifecycleEvents,
+  frameSamplesFromInit,
+  generateFallbackAvcC,
+  generateGreenFillNAL,
+  generateHvcCFromParameterSets,
+  generateSilenceFrame,
+  getPacketType,
+  getPhase14CatalogOverride,
+  getTimestampSize,
+  groupIdFor,
+  groupIdForTicks,
+  hevcVclOnly,
+  isAnnexB,
+  isCompleteAvccSample,
+  isCompleteFmp4DataUnit,
+  isFecCatalogConfig,
+  isFmp4InitSegment,
+  isHevcCodec,
+  isMulticastCatalogConfig,
+  isMulticastEndpoint,
+  isMulticastTrackObject,
+  isRepairLifecycleEvent,
+  isSignalingPacket,
+  isSourcePacket,
+  isTrackTimingConfig,
+  mergeOverrideIntoCmsfTracks,
+  mergeOverrideIntoHangRenditions,
+  mfuReassemblyTimeoutMs,
+  mmtpFrameReorderWindowFrames,
+  mmtpTimestampToMicros,
+  multicastFromConfig,
+  multicastFromEnv,
+  normalizeH264SampleToAvcc,
+  parseAacFrameSamples,
+  parseAacSampleRate,
+  parseOpusFrameSamples,
+  processMMTPWithReassembly,
+  reliableMoqMfuReassembly,
+  removeEmulationPrevention,
+  resolveCatalogTrackFec,
+  resolveGlobalMmtWasmBindings,
+  resolveGroupDurationMs,
+  resolveGroupDurationTicks,
+  secondsFromTicks,
+  setupFecWorkerForTrack,
+  setupTrackPipeline,
+  splitAnnexBNalUnits,
+  splitAvccNalUnits,
+  splitH264SampleNalUnits,
+  unwrapMulticastPacket,
+  validateCmsfMmtpCatalog,
+  validateMulticastContainerContract,
+  validateSwitchingSetTiming,
+  wireRepairFetch,
+  wrapAdtsFrame
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * @mmt/container - MMTP/LOC Container Parsing\n *\n * Shared container parsing library for MMT over MoQ and SSM.\n *\n * @packageDocumentation\n */\n\nexport type { AuthoredTiming } from './authored-timing.js'\n\n// MFU Reassembler\nexport {\n  type MFUFragment,\n  type ReassembledMFU,\n  type ReassemblerStats,\n  type MFUReassemblerOptions,\n  type MfuReassemblerBackend,\n  type MmtpSourcePath,\n  MFUReassembler,\n  MfuReassemblyError,\n  type MfuReassemblyErrorCode,\n  createFragment,\n  processMMTPWithReassembly,\n} from './mfu-reassembler.js'\n\n// Sample combiner: combines subsample data units (moqcast #37) of one\n// timed sample, each already reassembled by MFUReassembler, back into one\n// contiguous sample.\nexport {\n  type CombinedSample,\n  type SampleCombinerStats,\n  SampleCombiner,\n  SampleCombineError,\n  type SampleCombineErrorCode,\n} from './sample-combiner.js'\n\n// fMP4 data-unit completion policy (BLO-13291)\nexport { isCompleteFmp4DataUnit } from './fmp4-completion.js'\n\n\n// source-auth (authenticated-manifest / Merkle) is intentionally NOT re-exported\n// from the eager index barrel. It statically imports blake3 from @noble/hashes,\n// and re-exporting it here pulls that bare specifier into every browser consumer\n// of @blockcast/mmt-container (the moq-lib / shred / moqtail players load the\n// barrel as raw ESM via an import map, where @noble/hashes has no mapping \u2192\n// \"Failed to resolve module specifier\". No browser player uses source-auth.)\n// Consumers that need it import the dedicated subpath: '@blockcast/mmt-container/source-auth'.\n// The same rule covers the @blockcast/mmt-manifest-verify surface (ManifestVerifier et al.):\n// import it from that package (or the subpath above) directly, never from this barrel.\n\n// H.264/AVC + H.265/HEVC Codec Utilities\nexport {\n  type AvcCInfo,\n  type AacAscInfo,\n  type SpsPps,\n  type FallbackAvcCOptions,\n  type HevcParameterSets,\n  type H264KeyframeDetectionOptions,\n  type H264AvccSample,\n  type H264SampleFormat,\n  type H264NalUnitFormat,\n  type H264NalUnitSample,\n  extractAvcCFromInitSegment,\n  extractAacAscFromInitSegment,\n  generateFallbackAvcC,\n  extractSpsPpsFromAvcC,\n  avccToAnnexB,\n  extractCodecDescriptionFromAnnexB,\n  codecStringFromAvcC,\n  isAnnexB,\n  isCompleteAvccSample,\n  findAnnexBStartCode,\n  splitAnnexBNalUnits,\n  annexBToAvcc,\n  normalizeH264SampleToAvcc,\n  splitH264SampleNalUnits,\n  classifyH264Keyframe,\n  detectH264Keyframe,\n  mmtpTimestampToMicros,\n  isFmp4InitSegment,\n  wrapAdtsFrame,\n  // HEVC (BLO-7764): build the hvcC description WebCodecs requires for length-prefixed H.265.\n  isHevcCodec,\n  removeEmulationPrevention,\n  splitAvccNalUnits,\n  extractHevcParameterSets,\n  generateHvcCFromParameterSets,\n  extractHevcCodecDescription,\n  hevcVclOnly,\n} from './codec-utils.js'\n\n// LOC FEC Extensions (draft-ramadan-moq-fec \u00A77.1)\nexport {\n  LOCHeaderExtensionId,\n  FEC_SBN_MAX,\n  FEC_ESI_MAX,\n  encodeFecSourceInfo,\n  decodeFecSourceInfo,\n  FecSourceInfo,\n  AuthTag,\n} from './loc.js'\n\n// CARP Catalog Extensions (draft-law-ramadan-moq-carp-reliability \u00A73-4)\n// + Track Timing (draft-ramadan-moq-mmt-00 \u00A74.4.4)\nexport {\n  type FecAlgorithm,\n  type FecCatalogConfig,\n  isFecCatalogConfig,\n  type MulticastProtocol,\n  type MulticastTrack,\n  type MulticastTrackObject,\n  type MulticastEndpoint,\n  type AmtDiscovery,\n  type MulticastCatalogConfig,\n  isMulticastTrackObject,\n  isMulticastEndpoint,\n  isMulticastCatalogConfig,\n  type TrackTimingConfig,\n  isTrackTimingConfig,\n  resolveGroupDurationTicks,\n  resolveGroupDurationMs,\n  validateSwitchingSetTiming,\n  type CmsfCatalog,\n  type CmsfCatalogErrorCode,\n  CmsfCatalogValidationError,\n  validateCmsfMmtpCatalog,\n} from './carp-catalog.js'\n\n// Multicast input contract \u2014 validator + builder for publisher-emitted\n// catalogs (draft-ramadan-moq-multicast-00 \u00A74.1, BLO-3323 A.1).\n// `multicastFromEnv` is the env-var helper used by FFmpeg and the\n// cast bridge (BLO-3337).\nexport {\n  type MulticastInput,\n  type MulticastEndpointInput,\n  type MulticastInputErrorKind,\n  MulticastInputError,\n  multicastFromConfig,\n  multicastFromEnv,\n} from './multicast-input.js'\n\n// Phase 14 catalog override hook (test harness injects\n// globalThis.__PHASE14_CATALOG_OVERRIDE; see 7point-validation.test.mjs)\nexport {\n  type Phase14OverrideTrack,\n  type Phase14CatalogOverride,\n  getPhase14CatalogOverride,\n  mergeOverrideIntoHangRenditions,\n  mergeOverrideIntoCmsfTracks,\n} from './phase14-catalog-override.js'\n\n// Multicast Unwrap (container-aware MMTP dispatch)\nexport {\n  type MulticastContainerContract,\n  type MulticastContainerErrorCode,\n  type FecPayloadId as MulticastFecPayloadId,\n  type MulticastFrame,\n  MulticastContainerContractError,\n  validateMulticastContainerContract,\n  unwrapMulticastPacket,\n} from './multicast-unwrap.js'\n\n// Timestamp Codec \u2014 container-format-agnostic timestamp encoding/decoding\nexport {\n  type ContainerFormat,\n  type LocHeader,\n  encodeTimestamp,\n  decodeTimestamp,\n  getTimestampSize,\n  decodeLocHeader,\n  decodeLocTimestamp,\n  encodeLocTimestamp,\n} from './timestamp-codec.js'\n\n// MMTP \u2192 CMAF conversion (draft-ramadan-moq-mmt \u00A75.3)\nexport {\n  MmtpToCmaf,\n  encodeDataSegment,\n  encodeMultiSampleSegment,\n  buildVideoInitSegment,\n  buildAudioInitSegment,\n  generateGreenFillNAL,\n  generateSilenceFrame,\n} from './mmtp-to-cmaf.js'\n\n// MMTP Signaling \u2014 packet type detection and classification\nexport {\n  type PacketClass,\n  getPacketType,\n  isSignalingPacket,\n  isSourcePacket,\n  classifyPacket,\n} from './signaling.js'\n\n// FEC Block \u2192 CMAF Segment Assembler\nexport {\n  CmafBlockAssembler,\n  type CmafBlockSample,\n  type CmafSampleOrderPolicy,\n  type CmafSampleOrderStats,\n  type BlockAssemblerConfig,\n} from './cmaf-block-assembler.js'\n\n// MoQ Group \u2192 CMAF Segment Batcher\nexport {\n  CmafGroupBatcher,\n  type CmafGroupBatcherConfig,\n} from './cmaf-group-batcher.js'\n\n// FEC Manager (codec-agnostic FEC decode service)\nexport {\n  FECManager,\n  type FECManagerConfig,\n  type WasmFecDecoder,\n  type FecStats,\n} from './fec-manager.js'\n\n// MMTP Router (packet processing + frame routing)\nexport {\n  MmtpRouter,\n  KEYFRAME_LOST_TIMEOUT_SLACK,\n  type FrameCallback,\n  type FECManagerLike,\n  type MmtpIngressContext,\n  type RoutedPacketMeta,\n  type TrackPacketCallback,\n} from './mmtp-router.js'\n\n// MmtpContainerParser (unified, transport-agnostic)\nexport {\n  MmtpContainerParser,\n  type MmtpParserConfig,\n  type MmtpParserRecord,\n  type TrackInfo,\n  type MmtpReorderStats,\n  type MmtpReorderFrameDiagnostics,\n  type MmtpReorderStreamDiagnostics,\n  type FrameMeta as ParserFrameMeta,\n  type PacketInfo,\n} from './mmtp-container-parser.js'\n\nexport {\n  datagramMfuReassembly,\n  reliableMoqMfuReassembly,\n  mmtpFrameReorderWindowFrames,\n  mfuReassemblyTimeoutMs,\n  type MfuReassemblyPolicy,\n  type MmtpTrackType,\n  type ReliableMoqReassemblyOptions,\n} from './mfu-reassembly-policy.js'\n\nexport {\n  WasmMfuReassembler,\n  resolveGlobalMmtWasmBindings,\n  type MmtWasmBindings,\n  type WasmMfuReassemblerOptions,\n} from './wasm-mfu-reassembler.js'\n\nexport {\n  createWasmMmtpContainerParser,\n  type WasmMmtpParserConfig,\n} from './wasm-mmtp-container-parser.js'\n\n// FEC Codec (generic, algorithm-pluggable)\nexport {\n  type FecCodec,\n  NoneCodec,\n  ReedSolomonCodec,\n  createFecCodec,\n} from './fec-codec.js'\n\n// Multicast Transport (SSM join/socket/watchdog)\nexport {\n  MulticastTransport,\n  type MulticastTransportConfig,\n  type ResolvedMulticastTransport,\n} from './multicast-transport.js'\n\n// Multicast Manager (backwards-compat facade composing all three)\nexport {\n  MulticastManager,\n  forwardRepairLifecycleEvents,\n  isRepairLifecycleEvent,\n  REPAIR_LIFECYCLE_EVENT_TYPE,\n  REPAIR_LIFECYCLE_LOG_PREFIX,\n  type MulticastEndpointConfig,\n  type MultiTrackCatalog,\n  type MultiTrackCatalogTrack,\n  type WasmFecDecoderFactory,\n  type RepairBlockIdentity,\n  type RepairLifecycleApplicationEvent,\n  type RepairLifecycleEventOptions,\n  type RepairLifecycleEventFactory,\n  type RepairLifecycleEventTarget,\n  type RepairLifecycleSource,\n  type RepairLifecycleEvent,\n  type RepairLifecycleObserver,\n} from './multicast-manager.js'\n\n// FEC Worker Setup (shared fec-setup helper)\nexport {\n  setupFecWorkerForTrack,\n  type FecWorkerAssetUrls,\n  type FecWorkerSetupOptions,\n  type FecWorkerSetupResult,\n} from './fec-worker-setup.js'\n\n// Media Router (shared MoQ \u2194 multicast source arbitration)\nexport {\n  MediaRouter,\n  TrackSourceConflictError,\n  type MediaRouterOptions,\n  type TrackSource,\n  type SetTrackSourceOptions,\n  type MigrationPolicy,\n  type FrameMeta as RouterFrameMeta,\n  type FrameKind,\n  type SourceKind,\n  type GroupDriftEvent,\n  type GroupBoundaryTicks,\n} from './media-router.js'\n\n// Group-alignment primitive \u2014 shared with Go sender + Rust relay.\n// See align.ts docstring for cross-language contract. Authoritative form\n// is integer-ticks (groupIdForTicks); seconds-form is the legacy ramp.\nexport {\n  groupIdForTicks,\n  groupIdFor,\n  secondsFromTicks,\n  asSeconds,\n  driftCheck,\n  type Seconds,\n  type DriftCheckResult,\n} from './align.js'\n\n// Audio Ring Buffer \u2014 DEPRECATED: canonical location is @blockcast/mmt-render/audio.\n// Kept here for backwards compat with consumers not yet migrated to mmt-render.\n// The mmt-render version includes warmup-delayed clock recovery + adaptive target fill.\nexport {\n  AudioRingBuffer,\n  type AudioRingBufferConfig,\n} from './audio-ring-buffer.js'\n\n// MMTP Decode Pipeline (MoQ + multicast unified decode path)\nexport {\n  MmtpDecodePipeline,\n  type PipelineFecClient,\n  type PipelineConfig,\n} from './mmtp-decode-pipeline.js'\n\n// Track Pipeline (per-track transport promotion + ABR)\nexport {\n  TrackPipeline,\n  type TrackTransport,\n  type TrackTransportPreference,\n  type TransportCapabilityReport,\n  type TrackTransportResolution,\n  type TrackSourceFactory,\n} from './track-pipeline.js'\n\n// Track Pipeline Setup (shared wiring helper for both players)\nexport {\n  setupTrackPipeline,\n  type TrackDescriptor,\n  type SetupTrackPipelineOptions,\n  type SetupTrackPipelineResult,\n} from './track-pipeline-setup.js'\n\n// Audio Init Data Parser (spec-compliant frame samples from initData)\nexport {\n  parseAacFrameSamples,\n  parseAacSampleRate,\n  parseOpusFrameSamples,\n  frameSamplesFromInit,\n} from './audio-init-parser.js'\n\n// Transport Pool (ref-counted subscription lifecycle, PIM)\nexport {\n  TransportPool,\n  type SubscriptionMode,\n  type DirectSocketHealth,\n  type Subscription,\n  type SubscriptionStats,\n  type AcquireOptions,\n  type TransportPoolOptions,\n} from './transport-pool.js'\n\n// Track Session + Session Manager (per-track state machine, Patent Claim 9)\nexport {\n  TrackSession,\n  SessionManager,\n  computeFecDeliveryWindowMs,\n  computeFecDeliveryWindowMediaUnits,\n  computeFecLossWindowMs,\n  type FecDeliveryWindowConfig,\n  type TrackState,\n  type TrackSessionConfig,\n  type SessionManagerCallbacks,\n  type MmtpTrackEvent,\n  type MmtpSessionCallbacks,\n} from './track-session.js'\n\n// FEC starvation detector (post-cutover repair-only/no-progress detection,\n// drives TrackSession lossDetected/lossRecovered \u2014 BLO-9413/D4)\nexport {\n  FecStarvationDetector,\n  type FecStarvationSnapshot,\n  type FecStarvationDetectorConfig,\n} from './fec-starvation-detector.js'\n\n// CMCD Producer (x-bc-* vendor key telemetry, BLO-1044)\nexport {\n  CmcdProducer,\n  type CmcdParams,\n  type CmcdProducerOptions,\n  type SnapshotData,\n  type TransportSnapshot,\n  type TransportTransitionEvent,\n} from './cmcd-producer.js'\n\nexport {\n\tcatalogFecInterleaveMs,\n\tresolveCatalogTrackFec,\n\ttype CatalogTrackRef,\n\ttype FecInterleaveCatalog,\n\ttype GroupDurationCatalog,\n\ttype KeyframeCadenceCatalog,\n\ttype TrackFecParams,\n} from \"./catalog-fec-params.js\";\n\nexport {\n\tcatalogAmtNetworkSource,\n\ttype AmtNetworkSource,\n\ttype CatalogNetworkSource,\n} from \"./catalog-network-source.js\";\n\n// D-28 shared repair-fetch shell (per-SBN on-demand MoQ FEC repair backfill)\nexport {\n  wireRepairFetch,\n  type ResolveRepairTarget,\n  type RepairFetchTransport,\n  type WireRepairFetchOptions,\n} from './repair-fetch.js'\n"],
+  "mappings": ";AAWA;AAAA,EAOE;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AAKP;AAAA,EAGE;AAAA,EACA;AAAA,OAEK;AAGP,SAAS,8BAA8B;AAcvC;AAAA,EAWE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EAGE;AAAA,EAOA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,OACK;AAMP;AAAA,EAIE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EAKE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,OAKK;AAGP;AAAA,EACE;AAAA,OAEK;AAGP;AAAA,EACE;AAAA,OAIK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,OAMK;AAGP;AAAA,EACE;AAAA,OASK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,OAEK;AAGP;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,OAGK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAaK;AAGP;AAAA,EACE;AAAA,OAIK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,OAUK;AAKP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAKP;AAAA,EACE;AAAA,OAEK;AAGP;AAAA,EACE;AAAA,OAGK;AAGP;AAAA,EACE;AAAA,OAMK;AAGP;AAAA,EACE;AAAA,OAIK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,OAOK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AAIP;AAAA,EACE;AAAA,OAGK;AAGP;AAAA,EACE;AAAA,OAMK;AAEP;AAAA,EACC;AAAA,EACA;AAAA,OAMM;AAEP;AAAA,EACC;AAAA,OAGM;AAGP;AAAA,EACE;AAAA,OAIK;",
+  "names": []
+}

package/dist/iso-bmff-timing.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Strict ISO-BMFF timing extraction for the timed-MFU browser path.
+ *
+ * This intentionally implements only the current single-track MMT profile:
+ * one media track in FT=0, and one matching traf/trun in each FT=1.  It does
+ * not infer timing from packet arrival, MMTP send timestamps, or cadence.
+ */
+export interface IsoBmffTrackTiming {
+    trackId: number;
+    timescale: number;
+    defaultSampleDuration?: number;
+    defaultSampleSize?: number;
+}
+export interface IsoBmffSampleTiming {
+    /** Exact decode time in mdhd timescale units. */
+    decodeTime: bigint;
+    /** Exact presentation time in mdhd timescale units, including signed CTS. */
+    presentationTime: bigint;
+    /** Exact authored duration in mdhd timescale units. */
+    duration: number;
+    timescale: number;
+    /** Exact elementary-stream sample size declared by trun/tfhd/trex. */
+    size: number;
+    /** Byte position of the sample relative to the beginning of the moof. */
+    bytePosition: bigint;
+}
+export interface IsoBmffMovieFragmentTiming {
+    movieFragmentSequenceNumber: number;
+    samples: readonly IsoBmffSampleTiming[];
+}
+export declare function parseIsoBmffInitializationTiming(data: Uint8Array): IsoBmffTrackTiming | null;
+export declare function parseIsoBmffMovieFragmentTiming(data: Uint8Array, track: IsoBmffTrackTiming, maxSamples: number): IsoBmffMovieFragmentTiming | null;
+/** Bounded per-track FT=0/FT=1 timing state. */
+export declare class IsoBmffTimingResolver {
+    #private;
+    readonly maxPendingSamples: number;
+    constructor(maxPendingSamples: number);
+    get pendingSampleCount(): number;
+    addInitialization(data: Uint8Array): boolean;
+    addMovieFragment(mpuSequenceNumber: number, data: Uint8Array, additionalSampleLimit?: number): boolean;
+    sampleTiming(mpuSequenceNumber: number, movieFragmentSequenceNumber: number, sampleNumber: number): IsoBmffSampleTiming | null;
+    consumeSample(mpuSequenceNumber: number, movieFragmentSequenceNumber: number, sampleNumber: number, expected: IsoBmffSampleTiming): boolean;
+    reset(): void;
+}
+/** Convert exact media ticks to microseconds without first narrowing the ticks. */
+export declare function mediaTicksToMicroseconds(ticks: bigint, timescale: number): number | null;
+//# sourceMappingURL=iso-bmff-timing.d.ts.map

package/dist/iso-bmff-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-bmff-timing.d.ts","sourceRoot":"","sources":["../src/iso-bmff-timing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqCH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAA;IACxB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,2BAA2B,EAAE,MAAM,CAAA;IACnC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACxC;AAmND,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,UAAU,GACf,kBAAkB,GAAG,IAAI,CA8C3B;AA4LD,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,GACjB,0BAA0B,GAAG,IAAI,CAuCnC;AAoBD,gDAAgD;AAChD,qBAAa,qBAAqB;;IAKpB,QAAQ,CAAC,iBAAiB,EAAE,MAAM;gBAAzB,iBAAiB,EAAE,MAAM;IAM9C,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAQ5C,gBAAgB,CACd,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,UAAU,EAChB,qBAAqB,SAAyB,GAC7C,OAAO;IAuBV,YAAY,CACV,iBAAiB,EAAE,MAAM,EACzB,2BAA2B,EAAE,MAAM,EACnC,YAAY,EAAE,MAAM,GACnB,mBAAmB,GAAG,IAAI;IAW7B,aAAa,CACX,iBAAiB,EAAE,MAAM,EACzB,2BAA2B,EAAE,MAAM,EACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,mBAAmB,GAC5B,OAAO;IAYV,KAAK,IAAI,IAAI;CAKd;AAUD,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWxF"}