@blockcast/mmt-container 0.1.0-main.0399efef1f07

package/dist/index.js

@@ -0,0 +1,380 @@
+// src/index.ts
+import {
+  MFUReassembler,
+  isMfuReassemblyError,
+  MfuReassemblyError,
+  createFragment,
+  processMMTPWithReassembly
+} from "./mfu-reassembler.js";
+import {
+  SampleCombiner,
+  SampleCombineError
+} from "./sample-combiner.js";
+import { isCompleteFmp4DataUnit } from "./fmp4-completion.js";
+import {
+  extractAvcCFromInitSegment,
+  extractAacAscFromInitSegment,
+  normalizeMmtpInitSegment,
+  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,
+  MAX_TAKEOVER_DEADLINE_MS,
+  JOIN_DEFER_WARN_MS,
+  computeFecDeliveryWindowMs,
+  computeFecDeliveryWindowMediaUnits,
+  computeFecLossWindowMs
+} from "./track-session.js";
+import {
+  FecStarvationDetector
+} from "./fec-starvation-detector.js";
+import {
+  CmcdProducer
+} from "./cmcd-producer.js";
+import {
+  catalogFecInterleaveMs,
+  resolveCatalogTrackFec,
+  catalogGroupDurationMs,
+  resolveCatalogTrackGroupDurationMs,
+  joinedRepairSymbolCount,
+  resolveRepairLayers,
+  assembleRepairLayers,
+  assertRepairTrackReachable,
+  repairReachability,
+  dependsTarget,
+  describeRepairTrack,
+  rejectRepairFieldsOnMediaTrack,
+  rejectRepairTrackGeometry,
+  REPAIR_TRACK_GEOMETRY_KEYS,
+  REPAIR_TRACK_ONLY_KEYS,
+  validateRepairTrackFields,
+  RepairContractError,
+  DEFAULT_REPAIR_PRIORITY,
+  MAX_ENCODING_SYMBOL_ID,
+  MAX_RAPTORQ_SOURCE_SYMBOLS,
+  MAX_REPAIR_SYMBOLS,
+  REPAIR_PRIORITY_MAX,
+  REPAIR_PRIORITY_MIN
+} 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,
+  DEFAULT_REPAIR_PRIORITY,
+  FECManager,
+  FEC_ESI_MAX,
+  FEC_SBN_MAX,
+  FecSourceInfo,
+  FecStarvationDetector,
+  JOIN_DEFER_WARN_MS,
+  KEYFRAME_LOST_TIMEOUT_SLACK,
+  LOCHeaderExtensionId,
+  MAX_ENCODING_SYMBOL_ID,
+  MAX_RAPTORQ_SOURCE_SYMBOLS,
+  MAX_REPAIR_SYMBOLS,
+  MAX_TAKEOVER_DEADLINE_MS,
+  MFUReassembler,
+  MediaRouter,
+  MfuReassemblyError,
+  MmtpContainerParser,
+  MmtpDecodePipeline,
+  MmtpRouter,
+  MmtpToCmaf,
+  MulticastContainerContractError,
+  MulticastInputError,
+  MulticastManager,
+  MulticastTransport,
+  NoneCodec,
+  REPAIR_LIFECYCLE_EVENT_TYPE,
+  REPAIR_LIFECYCLE_LOG_PREFIX,
+  REPAIR_PRIORITY_MAX,
+  REPAIR_PRIORITY_MIN,
+  REPAIR_TRACK_GEOMETRY_KEYS,
+  REPAIR_TRACK_ONLY_KEYS,
+  ReedSolomonCodec,
+  RepairContractError,
+  SampleCombineError,
+  SampleCombiner,
+  SessionManager,
+  TrackPipeline,
+  TrackSession,
+  TrackSourceConflictError,
+  TransportPool,
+  WasmMfuReassembler,
+  annexBToAvcc,
+  asSeconds,
+  assembleRepairLayers,
+  assertRepairTrackReachable,
+  avccToAnnexB,
+  buildAudioInitSegment,
+  buildVideoInitSegment,
+  catalogAmtNetworkSource,
+  catalogFecInterleaveMs,
+  catalogGroupDurationMs,
+  classifyH264Keyframe,
+  classifyPacket,
+  codecStringFromAvcC,
+  computeFecDeliveryWindowMediaUnits,
+  computeFecDeliveryWindowMs,
+  computeFecLossWindowMs,
+  createFecCodec,
+  createFragment,
+  createWasmMmtpContainerParser,
+  datagramMfuReassembly,
+  decodeFecSourceInfo,
+  decodeLocHeader,
+  decodeLocTimestamp,
+  decodeTimestamp,
+  dependsTarget,
+  describeRepairTrack,
+  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,
+  isMfuReassemblyError,
+  isMulticastCatalogConfig,
+  isMulticastEndpoint,
+  isMulticastTrackObject,
+  isRepairLifecycleEvent,
+  isSignalingPacket,
+  isSourcePacket,
+  isTrackTimingConfig,
+  joinedRepairSymbolCount,
+  mergeOverrideIntoCmsfTracks,
+  mergeOverrideIntoHangRenditions,
+  mfuReassemblyTimeoutMs,
+  mmtpFrameReorderWindowFrames,
+  mmtpTimestampToMicros,
+  multicastFromConfig,
+  multicastFromEnv,
+  normalizeH264SampleToAvcc,
+  normalizeMmtpInitSegment,
+  parseAacFrameSamples,
+  parseAacSampleRate,
+  parseOpusFrameSamples,
+  processMMTPWithReassembly,
+  rejectRepairFieldsOnMediaTrack,
+  rejectRepairTrackGeometry,
+  reliableMoqMfuReassembly,
+  removeEmulationPrevention,
+  repairReachability,
+  resolveCatalogTrackFec,
+  resolveCatalogTrackGroupDurationMs,
+  resolveGlobalMmtWasmBindings,
+  resolveGroupDurationMs,
+  resolveGroupDurationTicks,
+  resolveRepairLayers,
+  secondsFromTicks,
+  setupFecWorkerForTrack,
+  setupTrackPipeline,
+  splitAnnexBNalUnits,
+  splitAvccNalUnits,
+  splitH264SampleNalUnits,
+  unwrapMulticastPacket,
+  validateCmsfMmtpCatalog,
+  validateMulticastContainerContract,
+  validateRepairTrackFields,
+  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  isMfuReassemblyError,\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  normalizeMmtpInitSegment,\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 FecDecoderUnavailableEvent,\n  type FecDecoderUnavailableReason,\n  type FecFallbackDecoder,\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 MmtpParserFeedStats,\n  type MmtpFeedDropReason,\n  type MmtpFeedOutcomeKey,\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  type RepairStreamIdentity,\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} 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  type MmtpFeedStats,\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  MAX_TAKEOVER_DEADLINE_MS,\n  JOIN_DEFER_WARN_MS,\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\tcatalogGroupDurationMs,\n\ttype GroupDurationRendition,\n\tresolveCatalogTrackGroupDurationMs,\n\tjoinedRepairSymbolCount,\n\tresolveRepairLayers,\n\tassembleRepairLayers,\n\tassertRepairTrackReachable,\n\trepairReachability,\n\ttype AssembleRepairLayersOptions,\n\ttype RepairReachability,\n\tdependsTarget,\n\tdescribeRepairTrack,\n\trejectRepairFieldsOnMediaTrack,\n\trejectRepairTrackGeometry,\n\tREPAIR_TRACK_GEOMETRY_KEYS,\n\tREPAIR_TRACK_ONLY_KEYS,\n\tvalidateRepairTrackFields,\n\tRepairContractError,\n\tDEFAULT_REPAIR_PRIORITY,\n\tMAX_ENCODING_SYMBOL_ID,\n\tMAX_RAPTORQ_SOURCE_SYMBOLS,\n\tMAX_REPAIR_SYMBOLS,\n\tREPAIR_PRIORITY_MAX,\n\tREPAIR_PRIORITY_MIN,\n\ttype RepairContractCode,\n\ttype RepairContractFail,\n\ttype RepairLayerCatalog,\n\ttype RepairLayerParams,\n\ttype RepairLayersResolution,\n\ttype RepairOverlayParams,\n\ttype RepairRenditionCatalog,\n\ttype RepairSourceGeometry,\n\ttype RepairTrackDescriptor,\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": "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",
+  "names": []
+}

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

@@ -0,0 +1,78 @@
+/**
+ * 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 type IsoBmffMovieFragmentRejection = 'invalid' | 'budget';
+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;
+    /**
+     * Slots reclaimed by window displacement rather than by delivery or
+     * abandonment. Deliberately separate from the combiner's own release count:
+     * "nobody ever saw this sample" and "the combiner gave up on it" are
+     * different failures with different owners, and one number cannot say which.
+     */
+    get evictedSampleCount(): number;
+    /** Typed reason for the most recent rejected movie fragment. */
+    get lastMovieFragmentRejection(): IsoBmffMovieFragmentRejection | null;
+    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;
+    /**
+     * Free the budget slot of a sample that will never be delivered.
+     *
+     * `consumeSample` is the delivery path and is the only decrement on a
+     * healthy stream. A sample whose data units never complete is never
+     * delivered; window displacement in `addMovieFragment` eventually reclaims
+     * it, but only after it has aged out of the whole window. This path frees
+     * the slot as soon as the combiner knows the sample is gone, so the budget
+     * tracks what is actually in flight rather than what has merely aged.
+     *
+     * The caller is whoever abandoned the sample, so the release is driven by
+     * the abandonment itself rather than by a timer, an LRU, or an age bound --
+     * the slot is freed exactly when its sample provably cannot arrive, which
+     * is a protocol event the combiner already detects and counts.
+     *
+     * Deliberately takes no `expected` timing: the caller is discarding, not
+     * matching, and requiring it would make the release fail exactly when the
+     * timing entry is the thing being reclaimed. Returns false when the slot
+     * was already freed, so a double release cannot drive the count negative.
+     */
+    releaseSample(mpuSequenceNumber: number, movieFragmentSequenceNumber: number, sampleNumber: number): 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;AAED,MAAM,MAAM,6BAA6B,GAAG,SAAS,GAAG,QAAQ,CAAA;AAmNhE,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;;IAOpB,QAAQ,CAAC,iBAAiB,EAAE,MAAM;gBAAzB,iBAAiB,EAAE,MAAM;IAM9C,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;;;OAKG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,gEAAgE;IAChE,IAAI,0BAA0B,IAAI,6BAA6B,GAAG,IAAI,CAErE;IAED,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAQ5C,gBAAgB,CACd,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,UAAU,EAChB,qBAAqB,SAAyB,GAC7C,OAAO;IAiEV,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;IASV;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CACX,iBAAiB,EAAE,MAAM,EACzB,2BAA2B,EAAE,MAAM,EACnC,YAAY,EAAE,MAAM,GACnB,OAAO;IA2CV,KAAK,IAAI,IAAI;CAKd;AAUD,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWxF"}