@editframe/assets 0.37.2-beta → 0.38.0

package/dist/generateFragmentIndex.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateFragmentIndex.js","names":["box: MP4BoxHeader","chunks: Buffer[]","probe: PacketProbe","trackIndexes: Record<number, TrackFragmentIndex>","fragmentTimingData: FragmentTimingData[]","segments: TrackSegment[]","trackStartTimeOffsetMs: number | undefined"],"sources":["../src/generateFragmentIndex.ts"],"sourcesContent":["import { Readable, Transform, Writable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport debug from \"debug\";\nimport type { TrackFragmentIndex, TrackSegment } from \"./Probe.js\";\nimport { PacketProbe } from \"./Probe.js\";\n\nconst log = debug(\"ef:generateFragmentIndex\");\n\n// Minimum segment duration in milliseconds\nconst MIN_SEGMENT_DURATION_MS = 2000; // 2 seconds\nconst MS_PER_SECOND = 1000;\n\n// ============================================================================\n// Core Domain Types (Type Safety as Invariant Enforcement)\n// ============================================================================\n\n/** Raw packet from ffprobe - the fundamental unit of media data */\ninterface ProbePacket {\n  stream_index: number;\n  pts: number;\n  dts: number;\n  pts_time: number;\n  dts_time: number;\n  duration?: number;\n  pos?: number;\n  flags?: string;\n}\n\n/** Video packet with keyframe status - invariant: isKeyframe is always defined */\ninterface VideoPacket {\n  pts: number;\n  dts: number;\n  duration?: number;\n  isKeyframe: boolean;\n}\n\n/** Audio packet - simpler than video, no keyframe concept */\ninterface AudioPacket {\n  pts: number;\n  dts: number;\n  duration?: number;\n}\n\n/** Fragment timing data - packets organized by fragment */\ninterface FragmentTimingData {\n  fragmentIndex: number;\n  videoPackets: VideoPacket[];\n  audioPackets: AudioPacket[];\n}\n\n/** Timebase for timestamp conversion */\ninterface Timebase {\n  num: number;\n  den: number;\n}\n\n// Helper function to construct H.264 codec string from profile and level\nfunction constructH264CodecString(\n  codecTagString: string,\n  profile?: string,\n  level?: number,\n): string {\n  if (codecTagString !== \"avc1\" || !profile || level === undefined) {\n    return codecTagString;\n  }\n\n  // Map H.264 profile names to profile_idc values\n  const profileMap: Record<string, number> = {\n    Baseline: 0x42,\n    Main: 0x4d,\n    High: 0x64,\n    \"High 10\": 0x6e,\n    \"High 422\": 0x7a,\n    \"High 444\": 0xf4,\n  };\n\n  const profileIdc = profileMap[profile];\n  if (!profileIdc) {\n    return codecTagString;\n  }\n\n  // Format: avc1.PPCCLL where PP=profile_idc, CC=constraint_flags, LL=level_idc\n  const profileHex = profileIdc.toString(16).padStart(2, \"0\");\n  const constraintFlags = \"00\"; // Most common case\n  const levelHex = level.toString(16).padStart(2, \"0\");\n\n  return `${codecTagString}.${profileHex}${constraintFlags}${levelHex}`;\n}\n\ninterface MP4BoxHeader {\n  type: string;\n  offset: number;\n  size: number;\n  headerSize: number;\n}\n\ninterface Fragment {\n  type: \"init\" | \"media\";\n  offset: number;\n  size: number;\n  moofOffset?: number;\n  mdatOffset?: number;\n}\n\n/**\n * Streaming MP4 box parser that detects box boundaries without loading entire file into memory\n */\nclass StreamingBoxParser extends Transform {\n  private buffer = Buffer.alloc(0);\n  private globalOffset = 0;\n  private fragments: Fragment[] = [];\n  private currentMoof: MP4BoxHeader | null = null;\n  private initSegmentEnd = 0;\n  private foundBoxes: MP4BoxHeader[] = [];\n\n  constructor() {\n    super({ objectMode: false });\n  }\n\n  _transform(chunk: Buffer, _encoding: BufferEncoding, callback: () => void) {\n    // Append new data to our sliding buffer\n    this.buffer = Buffer.concat([this.buffer, chunk]);\n\n    // Parse all complete boxes in the current buffer\n    this.parseBoxes();\n\n    // Pass through the original chunk unchanged\n    this.push(chunk);\n    callback();\n  }\n\n  private parseBoxes() {\n    let bufferOffset = 0;\n\n    while (this.buffer.length - bufferOffset >= 8) {\n      const size = this.buffer.readUInt32BE(bufferOffset);\n      const type = this.buffer\n        .subarray(bufferOffset + 4, bufferOffset + 8)\n        .toString(\"ascii\");\n\n      // Invalid or incomplete box\n      if (size === 0 || size < 8 || this.buffer.length < bufferOffset + size) {\n        break;\n      }\n\n      const box: MP4BoxHeader = {\n        type,\n        offset: this.globalOffset + bufferOffset,\n        size,\n        headerSize: 8,\n      };\n\n      log(`Found box: ${box.type} at offset ${box.offset}, size ${box.size}`);\n      this.foundBoxes.push(box);\n      this.handleBox(box);\n\n      bufferOffset += size;\n    }\n\n    // Update global offset and trim processed data from buffer\n    this.globalOffset += bufferOffset;\n    this.buffer = this.buffer.subarray(bufferOffset);\n  }\n\n  private handleBox(box: MP4BoxHeader) {\n    switch (box.type) {\n      case \"ftyp\":\n      case \"moov\":\n        // Part of init segment\n        this.initSegmentEnd = Math.max(\n          this.initSegmentEnd,\n          box.offset + box.size,\n        );\n        break;\n\n      case \"moof\":\n        this.currentMoof = box;\n        break;\n\n      case \"mdat\":\n        if (this.currentMoof) {\n          // Found a complete fragment (moof + mdat pair) - fragmented MP4\n          this.fragments.push({\n            type: \"media\",\n            offset: this.currentMoof.offset,\n            size: box.offset + box.size - this.currentMoof.offset,\n            moofOffset: this.currentMoof.offset,\n            mdatOffset: box.offset,\n          });\n          this.currentMoof = null;\n        } else {\n          // mdat without moof - this is non-fragmented content, not a fragment\n          // Common in mixed MP4 files where initial content is non-fragmented\n          // followed by fragmented content. Ignore for fragment indexing.\n          log(\n            `Found non-fragmented mdat at offset ${box.offset}, skipping for fragment index`,\n          );\n        }\n        break;\n    }\n  }\n\n  _flush(callback: () => void) {\n    this.parseBoxes(); // Process any remaining buffered data\n\n    // Probe always outputs fragmented MP4\n    // Init segment is ftyp + moov boxes before the first moof\n    if (this.initSegmentEnd > 0) {\n      this.fragments.unshift({\n        type: \"init\",\n        offset: 0,\n        size: this.initSegmentEnd,\n      });\n    }\n\n    callback();\n  }\n\n  getFragments(): Fragment[] {\n    return this.fragments;\n  }\n}\n\n// Helper function to create a readable stream from fragment data\nfunction createFragmentStream(fragmentData: Uint8Array): Readable {\n  let offset = 0;\n  return new Readable({\n    read() {\n      if (offset >= fragmentData.length) {\n        this.push(null);\n        return;\n      }\n\n      const chunkSize = Math.min(64 * 1024, fragmentData.length - offset); // 64KB chunks\n      const chunk = fragmentData.slice(offset, offset + chunkSize);\n      offset += chunkSize;\n      this.push(Buffer.from(chunk));\n    },\n  });\n}\n\n// Helper to convert timestamp from ffprobe timebase to track timescale\nfunction convertTimestamp(\n  pts: number,\n  timebase: Timebase,\n  timescale: number,\n): number {\n  return Math.round((pts * timescale) / timebase.den);\n}\n\n// Helper to calculate duration in milliseconds from timescale units\nfunction durationMsFromTimescale(\n  durationTimescale: number,\n  timescale: number,\n): number {\n  return (durationTimescale / timescale) * MS_PER_SECOND;\n}\n\n// Helper to calculate segment byte range from accumulated fragments\nfunction calculateSegmentByteRange(\n  accumulatedFragments: Array<{ fragment: Fragment }>,\n): { offset: number; size: number } {\n  const firstFrag = accumulatedFragments[0]!;\n  const lastFrag = accumulatedFragments[accumulatedFragments.length - 1]!;\n  return {\n    offset: firstFrag.fragment.offset,\n    size: lastFrag.fragment.offset + lastFrag.fragment.size - firstFrag.fragment.offset,\n  };\n}\n\n// Explicit enumeration of segment accumulation state (Enumerate the Core Concept)\ntype SegmentAccumulationState =\n  | { type: \"idle\" }\n  | {\n      type: \"accumulating\";\n      startPts: number;\n      startDts: number;\n      fragments: Array<{ fragment: Fragment; fragmentData: FragmentTimingData }>;\n    };\n\n// Invariant: Segment must start on keyframe (for video) and have minimum duration\ninterface SegmentEvaluation {\n  cts: number;\n  dts: number;\n  duration: number;\n  offset: number;\n  size: number;\n}\n\n// Track processing context - single source of truth for track processing\ninterface TrackProcessingContext {\n  timebase: Timebase;\n  timescale: number;\n  fragmentTimingData: FragmentTimingData[];\n  mediaFragments: Fragment[];\n  // Cached filtered packets for this stream (Performance Through Caching)\n  streamPackets: ProbePacket[];\n  streamType: \"video\" | \"audio\";\n  streamIndex: number;\n}\n\n// Segment accumulator that encapsulates accumulation logic\nclass SegmentAccumulator {\n  private state: SegmentAccumulationState = { type: \"idle\" };\n  private readonly context: TrackProcessingContext;\n  private readonly minDurationMs: number;\n\n  constructor(context: TrackProcessingContext, minDurationMs: number) {\n    this.context = context;\n    this.minDurationMs = minDurationMs;\n  }\n\n  // Evaluation: Determine if we should finalize (semantics)\n  shouldFinalize(nextKeyframe: { pts: number; dts: number } | null): boolean {\n    if (this.state.type !== \"accumulating\") {\n      return false;\n    }\n\n    const durationMs = this.calculateAccumulatedDurationMs();\n    const hasMinimumDuration = durationMs >= this.minDurationMs;\n\n    // For video: finalize on keyframe + minimum duration\n    // For audio: finalize on minimum duration (no keyframe requirement)\n    if (this.context.streamType === \"video\") {\n      return hasMinimumDuration && nextKeyframe !== null;\n    } else {\n      return hasMinimumDuration;\n    }\n  }\n\n  // Evaluation: Calculate what the segment would be (semantics)\n  evaluateSegment(\n    nextBoundary: { pts: number } | null,\n  ): SegmentEvaluation | null {\n    if (this.state.type !== \"accumulating\") {\n      return null;\n    }\n\n    const segmentCts = convertTimestamp(\n      this.state.startPts,\n      this.context.timebase,\n      this.context.timescale,\n    );\n    const segmentDts = convertTimestamp(\n      this.state.startDts,\n      this.context.timebase,\n      this.context.timescale,\n    );\n    const segmentDuration = this.calculateSegmentDuration(\n      segmentCts,\n      nextBoundary,\n    );\n    const { offset, size } = calculateSegmentByteRange(this.state.fragments);\n\n    return {\n      cts: segmentCts,\n      dts: segmentDts,\n      duration: segmentDuration,\n      offset,\n      size,\n    };\n  }\n\n  // Application: Add fragment to accumulation (mechanism)\n  addFragment(fragment: Fragment, fragmentData: FragmentTimingData): void {\n    if (this.state.type === \"idle\") {\n      // Start accumulation - invariant: video segments must start on keyframe\n      const startPts = this.getStartPts(fragmentData);\n      const startDts = this.getStartDts(fragmentData);\n      this.state = {\n        type: \"accumulating\",\n        startPts,\n        startDts,\n        fragments: [{ fragment, fragmentData }],\n      };\n    } else {\n      // Continue accumulation\n      this.state.fragments.push({ fragment, fragmentData });\n    }\n  }\n\n  // Application: Reset accumulation (mechanism)\n  reset(): void {\n    this.state = { type: \"idle\" };\n  }\n\n  // Application: Start new segment with keyframe (mechanism)\n  startNewSegment(keyframe: { pts: number; dts: number }): void {\n    this.state = {\n      type: \"accumulating\",\n      startPts: keyframe.pts,\n      startDts: keyframe.dts,\n      fragments: [],\n    };\n  }\n\n  // Query: Get current state\n  getState(): SegmentAccumulationState {\n    return this.state;\n  }\n\n  // Query: Check if accumulating\n  isAccumulating(): boolean {\n    return this.state.type === \"accumulating\";\n  }\n\n  // Private helpers\n  private calculateAccumulatedDurationMs(): number {\n    if (this.state.type !== \"accumulating\") {\n      return 0;\n    }\n\n    const lastFrag = this.state.fragments[this.state.fragments.length - 1]!;\n    const lastPacket = this.getLastPacket(lastFrag.fragmentData);\n    const endCts = convertTimestamp(\n      lastPacket.pts + (lastPacket.duration || 0),\n      this.context.timebase,\n      this.context.timescale,\n    );\n    const startCts = convertTimestamp(\n      this.state.startPts,\n      this.context.timebase,\n      this.context.timescale,\n    );\n    return durationMsFromTimescale(endCts - startCts, this.context.timescale);\n  }\n\n  private calculateSegmentDuration(\n    segmentCts: number,\n    nextBoundary: { pts: number } | null,\n  ): number {\n    if (nextBoundary) {\n      const nextSegmentCts = convertTimestamp(\n        nextBoundary.pts,\n        this.context.timebase,\n        this.context.timescale,\n      );\n      return nextSegmentCts - segmentCts;\n    }\n\n    // Last segment: duration to end of all packets\n    // Use pre-cached streamPackets (Performance Through Caching)\n    const sortedPackets = [...this.context.streamPackets].sort(\n      (a, b) => a.pts - b.pts,\n    );\n    const lastPacket = sortedPackets[sortedPackets.length - 1]!;\n    const streamEnd = convertTimestamp(\n      lastPacket.pts + (lastPacket.duration || 0),\n      this.context.timebase,\n      this.context.timescale,\n    );\n    return streamEnd - segmentCts;\n  }\n\n  private getStartPts(fragmentData: FragmentTimingData): number {\n    if (this.context.streamType === \"video\") {\n      const keyframe = fragmentData.videoPackets.find((p) => p.isKeyframe);\n      return keyframe?.pts ?? fragmentData.videoPackets[0]?.pts ?? 0;\n    } else {\n      return fragmentData.audioPackets[0]?.pts ?? 0;\n    }\n  }\n\n  private getStartDts(fragmentData: FragmentTimingData): number {\n    if (this.context.streamType === \"video\") {\n      const keyframe = fragmentData.videoPackets.find((p) => p.isKeyframe);\n      return keyframe?.dts ?? fragmentData.videoPackets[0]?.dts ?? 0;\n    } else {\n      return fragmentData.audioPackets[0]?.dts ?? 0;\n    }\n  }\n\n  private getLastPacket(\n    fragmentData: FragmentTimingData,\n  ): { pts: number; duration?: number } {\n    if (this.context.streamType === \"video\") {\n      const packets = fragmentData.videoPackets;\n      return packets[packets.length - 1]!;\n    } else {\n      const packets = fragmentData.audioPackets;\n      return packets[packets.length - 1]!;\n    }\n  }\n}\n\n// Helper function to extract fragment data (init + media fragment)\n\nexport const generateFragmentIndex = async (\n  inputStream: Readable,\n  startTimeOffsetMs?: number,\n  trackIdMapping?: Record<number, number>, // Map from source track ID to desired track ID\n): Promise<Record<number, TrackFragmentIndex>> => {\n  // Step 1: Create a streaming parser that detects fragment boundaries\n  const parser = new StreamingBoxParser();\n\n  // Step 2: Create a passthrough stream that doesn't buffer everything\n  const chunks: Buffer[] = [];\n  let totalSize = 0;\n\n  const dest = new Writable({\n    write(chunk, _encoding, callback) {\n      chunks.push(chunk);\n      totalSize += chunk.length;\n      callback();\n    },\n  });\n\n  // Process the stream through both parser and collection\n  await pipeline(inputStream, parser, dest);\n  const fragments = parser.getFragments();\n\n  // If no data was collected, return empty result\n  if (totalSize === 0) {\n    return {};\n  }\n\n  // Step 3: Use ffprobe to analyze the complete stream for track metadata\n  const completeData = Buffer.concat(chunks as readonly Uint8Array[]);\n  const completeStream = createFragmentStream(\n    new Uint8Array(\n      completeData.buffer,\n      completeData.byteOffset,\n      completeData.byteLength,\n    ),\n  );\n\n  let probe: PacketProbe;\n  try {\n    probe = await PacketProbe.probeStream(completeStream);\n  } catch (error) {\n    console.warn(\"Failed to probe stream with ffprobe:\", error);\n    return {};\n  }\n\n  const videoStreams = probe.videoStreams;\n  const audioStreams = probe.audioStreams;\n\n  const trackIndexes: Record<number, TrackFragmentIndex> = {};\n  const initFragment = fragments.find((f) => f.type === \"init\");\n  const mediaFragments = fragments.filter((f) => f.type === \"media\");\n\n  // Map packets to fragments using byte position for moof+mdat boundaries\n  // But create contiguous segments based on keyframes\n  const fragmentTimingData: FragmentTimingData[] = [];\n\n  for (\n    let fragmentIndex = 0;\n    fragmentIndex < mediaFragments.length;\n    fragmentIndex++\n  ) {\n    const fragment = mediaFragments[fragmentIndex]!;\n\n    // Find packets that belong to this fragment based on byte position (moof+mdat boundaries)\n    const fragmentStart = fragment.offset;\n    const fragmentEnd = fragment.offset + fragment.size;\n\n    const videoPackets = probe.packets\n      .filter((packet) => {\n        const stream = videoStreams.find(\n          (s) => s.index === packet.stream_index,\n        );\n        return (\n          stream?.codec_type === \"video\" &&\n          packet.pos !== undefined &&\n          packet.pos >= fragmentStart &&\n          packet.pos < fragmentEnd\n        );\n      })\n      .map((packet) => ({\n        pts: packet.pts,\n        dts: packet.dts,\n        duration: packet.duration,\n        isKeyframe: packet.flags?.includes(\"K\") ?? false,\n      }));\n\n    const audioPackets = probe.packets\n      .filter((packet) => {\n        const stream = audioStreams.find(\n          (s) => s.index === packet.stream_index,\n        );\n        return (\n          stream?.codec_type === \"audio\" &&\n          packet.pos !== undefined &&\n          packet.pos >= fragmentStart &&\n          packet.pos < fragmentEnd\n        );\n      })\n      .map((packet) => ({\n        pts: packet.pts,\n        dts: packet.dts,\n        duration: packet.duration,\n      }));\n\n    fragmentTimingData.push({\n      fragmentIndex,\n      videoPackets,\n      audioPackets,\n    });\n  }\n\n  // Unified track processing function (One Direction of Truth)\n  const processTrack = (\n    streamIndex: number,\n    streamType: \"video\" | \"audio\",\n    timebase: Timebase,\n    allPackets: ProbePacket[],\n  ): TrackSegment[] => {\n    const segments: TrackSegment[] = [];\n    const timescale = Math.round(timebase.den / timebase.num);\n\n    // Cache filtered packets once (Performance Through Caching)\n    const streamPackets = allPackets.filter(\n      (p) => p.stream_index === streamIndex,\n    );\n\n    const context: TrackProcessingContext = {\n      timebase,\n      timescale,\n      fragmentTimingData,\n      mediaFragments,\n      streamPackets,\n      streamType,\n      streamIndex,\n    };\n\n    const accumulator = new SegmentAccumulator(context, MIN_SEGMENT_DURATION_MS);\n\n    for (let i = 0; i < fragmentTimingData.length; i++) {\n      const fragmentData = fragmentTimingData[i]!;\n      const fragment = mediaFragments[fragmentData.fragmentIndex]!;\n      const packets =\n        streamType === \"video\"\n          ? fragmentData.videoPackets\n          : fragmentData.audioPackets;\n\n      log(\n        `Fragment ${fragmentData.fragmentIndex}: ${packets.length} ${streamType} packets`,\n      );\n\n      if (packets.length === 0) {\n        log(\n          `Skipping fragment ${fragmentData.fragmentIndex} - no ${streamType} packets`,\n        );\n        continue;\n      }\n\n      if (streamType === \"video\") {\n        // Video: segments must start on keyframes\n        const keyframe = fragmentData.videoPackets.find(\n          (p) => p.isKeyframe,\n        );\n        const hasKeyframe = keyframe !== undefined;\n\n        // Start new segment on keyframe if none exists\n        if (!accumulator.isAccumulating() && hasKeyframe) {\n          accumulator.startNewSegment({\n            pts: keyframe.pts,\n            dts: keyframe.dts,\n          });\n          accumulator.addFragment(fragment, fragmentData);\n          continue;\n        }\n\n        // Skip fragments without keyframes if no segment started\n        if (!accumulator.isAccumulating()) {\n          continue;\n        }\n\n        // Check if we should finalize when encountering a new keyframe\n        if (hasKeyframe) {\n          if (accumulator.shouldFinalize({ pts: keyframe.pts, dts: keyframe.dts })) {\n            // Duration should be to the start of this keyframe (start of next segment)\n            const nextBoundary = { pts: keyframe.pts };\n            const evaluation = accumulator.evaluateSegment(nextBoundary);\n            if (evaluation) {\n              segments.push(evaluation);\n            }\n            accumulator.reset();\n            accumulator.startNewSegment({\n              pts: keyframe.pts,\n              dts: keyframe.dts,\n            });\n          }\n        }\n      } else {\n        // Audio: no keyframe requirement, just duration-based\n        if (!accumulator.isAccumulating()) {\n          accumulator.addFragment(fragment, fragmentData);\n          continue;\n        }\n\n        // Check if we should finalize based on accumulated duration\n        if (accumulator.shouldFinalize(null)) {\n          // Duration should be to the start of this fragment (start of next segment)\n          const nextBoundary = { pts: fragmentData.audioPackets[0]!.pts };\n          const evaluation = accumulator.evaluateSegment(nextBoundary);\n          if (evaluation) {\n            segments.push(evaluation);\n          }\n          accumulator.reset();\n        }\n      }\n\n      // Add fragment to current segment\n      accumulator.addFragment(fragment, fragmentData);\n    }\n\n    // Finalize any remaining accumulated fragments\n    if (accumulator.isAccumulating()) {\n      const evaluation = accumulator.evaluateSegment(null);\n      if (evaluation) {\n        segments.push(evaluation);\n      }\n    }\n\n    return segments;\n  };\n\n  // Step 4: Process video tracks using ffprobe data\n  for (const videoStream of videoStreams) {\n    // Get timebase for this stream to convert timestamps\n    const timebase = probe.videoTimebase;\n    if (!timebase) {\n      console.warn(\"No timebase found for video stream\");\n      continue;\n    }\n\n    const timescale = Math.round(timebase.den / timebase.num);\n\n    // Cache filtered packets once (Performance Through Caching)\n    const streamPackets = (probe.packets as ProbePacket[]).filter(\n      (p) => p.stream_index === videoStream.index,\n    );\n    const keyframePackets = streamPackets.filter((p) =>\n      p.flags?.includes(\"K\"),\n    );\n    const totalSampleCount = keyframePackets.length;\n\n    log(\n      `Complete stream has ${streamPackets.length} video packets, ${keyframePackets.length} keyframes for stream ${videoStream.index}`,\n    );\n\n    // Calculate per-track timing offset from first packet for timeline mapping\n    let trackStartTimeOffsetMs: number | undefined;\n    if (streamPackets.length > 0) {\n      log(\n        `First video packet dts_time: ${streamPackets[0]!.dts_time}, pts_time: ${streamPackets[0]!.pts_time}`,\n      );\n      const presentationTime = streamPackets[0]!.pts_time;\n      if (Math.abs(presentationTime) > 0.01) {\n        trackStartTimeOffsetMs = presentationTime * MS_PER_SECOND;\n      }\n    }\n    if (startTimeOffsetMs !== undefined) {\n      trackStartTimeOffsetMs = startTimeOffsetMs;\n    }\n\n    // Process fragments to create segments with minimum duration\n    const segments = processTrack(\n      videoStream.index,\n      \"video\",\n      timebase,\n      probe.packets as ProbePacket[],\n    );\n\n    // Calculate total duration from cached stream packets\n    let totalDuration = 0;\n    if (streamPackets.length > 0) {\n      const firstPacket = streamPackets[0]!;\n      const lastPacket = streamPackets[streamPackets.length - 1]!;\n      const firstPts = convertTimestamp(firstPacket.pts, timebase, timescale);\n      const lastPts = convertTimestamp(lastPacket.pts, timebase, timescale);\n      totalDuration = lastPts - firstPts;\n    }\n\n    const finalTrackId =\n      trackIdMapping?.[videoStream.index] ?? videoStream.index + 1;\n    trackIndexes[finalTrackId] = {\n      track: finalTrackId,\n      type: \"video\",\n      width: videoStream.coded_width || videoStream.width,\n      height: videoStream.coded_height || videoStream.height,\n      timescale: timescale,\n      sample_count: totalSampleCount,\n      codec: constructH264CodecString(\n        videoStream.codec_tag_string,\n        videoStream.profile,\n        videoStream.level,\n      ),\n      duration: totalDuration,\n      startTimeOffsetMs: trackStartTimeOffsetMs,\n      initSegment: {\n        offset: 0,\n        size: initFragment?.size || 0,\n      },\n      segments,\n    };\n  }\n\n  // Step 5: Process audio tracks using ffprobe data\n  for (const audioStream of audioStreams) {\n    // Get timebase for this stream to convert timestamps\n    const timebase = probe.audioTimebase;\n    if (!timebase) {\n      console.warn(\"No timebase found for audio stream\");\n      continue;\n    }\n\n    const timescale = Math.round(timebase.den / timebase.num);\n\n    // Cache filtered packets once (Performance Through Caching)\n    const streamPackets = (probe.packets as ProbePacket[]).filter(\n      (p) => p.stream_index === audioStream.index,\n    );\n    const totalSampleCount = streamPackets.length;\n\n    // Calculate per-track timing offset from first packet for timeline mapping\n    let trackStartTimeOffsetMs: number | undefined;\n    if (streamPackets.length > 0) {\n      const presentationTime = streamPackets[0]!.pts_time;\n      if (Math.abs(presentationTime) > 0.01) {\n        trackStartTimeOffsetMs = presentationTime * MS_PER_SECOND;\n      }\n    }\n    if (startTimeOffsetMs !== undefined) {\n      trackStartTimeOffsetMs = startTimeOffsetMs;\n    }\n\n    // Process fragments to create segments with minimum duration\n    const segments = processTrack(\n      audioStream.index,\n      \"audio\",\n      timebase,\n      probe.packets as ProbePacket[],\n    );\n\n    // Calculate total duration\n    const totalDuration = segments.reduce((sum, seg) => sum + seg.duration, 0);\n\n    const finalTrackId =\n      trackIdMapping?.[audioStream.index] ?? audioStream.index + 1;\n    trackIndexes[finalTrackId] = {\n      track: finalTrackId,\n      type: \"audio\",\n      channel_count: audioStream.channels,\n      sample_rate: Number(audioStream.sample_rate),\n      sample_size: audioStream.bits_per_sample,\n      sample_count: totalSampleCount,\n      timescale: timescale,\n      codec: audioStream.codec_tag_string || audioStream.codec_name || \"\",\n      duration: totalDuration,\n      startTimeOffsetMs: trackStartTimeOffsetMs,\n      initSegment: {\n        offset: 0,\n        size: initFragment?.size || 0,\n      },\n      segments,\n    };\n  }\n\n  return trackIndexes;\n};\n"],"mappings":"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"}
+{"version":3,"file":"generateFragmentIndex.js","names":["box: MP4BoxHeader","chunks: Buffer[]","probe: PacketProbe","trackIndexes: Record<number, TrackFragmentIndex>","fragmentTimingData: FragmentTimingData[]","segments: TrackSegment[]","trackStartTimeOffsetMs: number | undefined"],"sources":["../src/generateFragmentIndex.ts"],"sourcesContent":["import { Readable, Transform, Writable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport debug from \"debug\";\nimport type { TrackFragmentIndex, TrackSegment } from \"./Probe.js\";\nimport { PacketProbe } from \"./Probe.js\";\n\nconst log = debug(\"ef:generateFragmentIndex\");\n\n// Minimum segment duration in milliseconds\nconst MIN_SEGMENT_DURATION_MS = 2000; // 2 seconds\nconst MS_PER_SECOND = 1000;\n\n// ============================================================================\n// Core Domain Types (Type Safety as Invariant Enforcement)\n// ============================================================================\n\n/** Raw packet from ffprobe - the fundamental unit of media data */\ninterface ProbePacket {\n  stream_index: number;\n  pts: number;\n  dts: number;\n  pts_time: number;\n  dts_time: number;\n  duration?: number;\n  pos?: number;\n  flags?: string;\n}\n\n/** Video packet with keyframe status - invariant: isKeyframe is always defined */\ninterface VideoPacket {\n  pts: number;\n  dts: number;\n  duration?: number;\n  isKeyframe: boolean;\n}\n\n/** Audio packet - simpler than video, no keyframe concept */\ninterface AudioPacket {\n  pts: number;\n  dts: number;\n  duration?: number;\n}\n\n/** Fragment timing data - packets organized by fragment */\ninterface FragmentTimingData {\n  fragmentIndex: number;\n  videoPackets: VideoPacket[];\n  audioPackets: AudioPacket[];\n}\n\n/** Timebase for timestamp conversion */\ninterface Timebase {\n  num: number;\n  den: number;\n}\n\n// Helper function to construct H.264 codec string from profile and level\nfunction constructH264CodecString(\n  codecTagString: string,\n  profile?: string,\n  level?: number,\n): string {\n  if (codecTagString !== \"avc1\" || !profile || level === undefined) {\n    return codecTagString;\n  }\n\n  // Map H.264 profile names to profile_idc values\n  const profileMap: Record<string, number> = {\n    Baseline: 0x42,\n    Main: 0x4d,\n    High: 0x64,\n    \"High 10\": 0x6e,\n    \"High 422\": 0x7a,\n    \"High 444\": 0xf4,\n  };\n\n  const profileIdc = profileMap[profile];\n  if (!profileIdc) {\n    return codecTagString;\n  }\n\n  // Format: avc1.PPCCLL where PP=profile_idc, CC=constraint_flags, LL=level_idc\n  const profileHex = profileIdc.toString(16).padStart(2, \"0\");\n  const constraintFlags = \"00\"; // Most common case\n  const levelHex = level.toString(16).padStart(2, \"0\");\n\n  return `${codecTagString}.${profileHex}${constraintFlags}${levelHex}`;\n}\n\ninterface MP4BoxHeader {\n  type: string;\n  offset: number;\n  size: number;\n  headerSize: number;\n}\n\ninterface Fragment {\n  type: \"init\" | \"media\";\n  offset: number;\n  size: number;\n  moofOffset?: number;\n  mdatOffset?: number;\n}\n\n/**\n * Streaming MP4 box parser that detects box boundaries without loading entire file into memory\n */\nclass StreamingBoxParser extends Transform {\n  private buffer = Buffer.alloc(0);\n  private globalOffset = 0;\n  private fragments: Fragment[] = [];\n  private currentMoof: MP4BoxHeader | null = null;\n  private initSegmentEnd = 0;\n  private foundBoxes: MP4BoxHeader[] = [];\n\n  constructor() {\n    super({ objectMode: false });\n  }\n\n  _transform(chunk: Buffer, _encoding: BufferEncoding, callback: () => void) {\n    // Append new data to our sliding buffer\n    this.buffer = Buffer.concat([this.buffer, chunk]);\n\n    // Parse all complete boxes in the current buffer\n    this.parseBoxes();\n\n    // Pass through the original chunk unchanged\n    this.push(chunk);\n    callback();\n  }\n\n  private parseBoxes() {\n    let bufferOffset = 0;\n\n    while (this.buffer.length - bufferOffset >= 8) {\n      const size = this.buffer.readUInt32BE(bufferOffset);\n      const type = this.buffer\n        .subarray(bufferOffset + 4, bufferOffset + 8)\n        .toString(\"ascii\");\n\n      // Invalid or incomplete box\n      if (size === 0 || size < 8 || this.buffer.length < bufferOffset + size) {\n        break;\n      }\n\n      const box: MP4BoxHeader = {\n        type,\n        offset: this.globalOffset + bufferOffset,\n        size,\n        headerSize: 8,\n      };\n\n      log(`Found box: ${box.type} at offset ${box.offset}, size ${box.size}`);\n      this.foundBoxes.push(box);\n      this.handleBox(box);\n\n      bufferOffset += size;\n    }\n\n    // Update global offset and trim processed data from buffer\n    this.globalOffset += bufferOffset;\n    this.buffer = this.buffer.subarray(bufferOffset);\n  }\n\n  private handleBox(box: MP4BoxHeader) {\n    switch (box.type) {\n      case \"ftyp\":\n      case \"moov\":\n        // Part of init segment\n        this.initSegmentEnd = Math.max(\n          this.initSegmentEnd,\n          box.offset + box.size,\n        );\n        break;\n\n      case \"moof\":\n        this.currentMoof = box;\n        break;\n\n      case \"mdat\":\n        if (this.currentMoof) {\n          // Found a complete fragment (moof + mdat pair) - fragmented MP4\n          this.fragments.push({\n            type: \"media\",\n            offset: this.currentMoof.offset,\n            size: box.offset + box.size - this.currentMoof.offset,\n            moofOffset: this.currentMoof.offset,\n            mdatOffset: box.offset,\n          });\n          this.currentMoof = null;\n        } else {\n          // mdat without moof - this is non-fragmented content, not a fragment\n          // Common in mixed MP4 files where initial content is non-fragmented\n          // followed by fragmented content. Ignore for fragment indexing.\n          log(\n            `Found non-fragmented mdat at offset ${box.offset}, skipping for fragment index`,\n          );\n        }\n        break;\n    }\n  }\n\n  _flush(callback: () => void) {\n    this.parseBoxes(); // Process any remaining buffered data\n\n    // Probe always outputs fragmented MP4\n    // Init segment is ftyp + moov boxes before the first moof\n    if (this.initSegmentEnd > 0) {\n      this.fragments.unshift({\n        type: \"init\",\n        offset: 0,\n        size: this.initSegmentEnd,\n      });\n    }\n\n    callback();\n  }\n\n  getFragments(): Fragment[] {\n    return this.fragments;\n  }\n}\n\n// Helper function to create a readable stream from fragment data\nfunction createFragmentStream(fragmentData: Uint8Array): Readable {\n  let offset = 0;\n  return new Readable({\n    read() {\n      if (offset >= fragmentData.length) {\n        this.push(null);\n        return;\n      }\n\n      const chunkSize = Math.min(64 * 1024, fragmentData.length - offset); // 64KB chunks\n      const chunk = fragmentData.slice(offset, offset + chunkSize);\n      offset += chunkSize;\n      this.push(Buffer.from(chunk));\n    },\n  });\n}\n\n// Helper to convert timestamp from ffprobe timebase to track timescale\nfunction convertTimestamp(\n  pts: number,\n  timebase: Timebase,\n  timescale: number,\n): number {\n  return Math.round((pts * timescale) / timebase.den);\n}\n\n// Helper to calculate duration in milliseconds from timescale units\nfunction durationMsFromTimescale(\n  durationTimescale: number,\n  timescale: number,\n): number {\n  return (durationTimescale / timescale) * MS_PER_SECOND;\n}\n\n// Helper to calculate segment byte range from accumulated fragments\nfunction calculateSegmentByteRange(\n  accumulatedFragments: Array<{ fragment: Fragment }>,\n): { offset: number; size: number } {\n  const firstFrag = accumulatedFragments[0]!;\n  const lastFrag = accumulatedFragments[accumulatedFragments.length - 1]!;\n  return {\n    offset: firstFrag.fragment.offset,\n    size:\n      lastFrag.fragment.offset +\n      lastFrag.fragment.size -\n      firstFrag.fragment.offset,\n  };\n}\n\n// Explicit enumeration of segment accumulation state (Enumerate the Core Concept)\ntype SegmentAccumulationState =\n  | { type: \"idle\" }\n  | {\n      type: \"accumulating\";\n      startPts: number;\n      startDts: number;\n      fragments: Array<{\n        fragment: Fragment;\n        fragmentData: FragmentTimingData;\n      }>;\n    };\n\n// Invariant: Segment must start on keyframe (for video) and have minimum duration\ninterface SegmentEvaluation {\n  cts: number;\n  dts: number;\n  duration: number;\n  offset: number;\n  size: number;\n}\n\n// Track processing context - single source of truth for track processing\ninterface TrackProcessingContext {\n  timebase: Timebase;\n  timescale: number;\n  fragmentTimingData: FragmentTimingData[];\n  mediaFragments: Fragment[];\n  // Cached filtered packets for this stream (Performance Through Caching)\n  streamPackets: ProbePacket[];\n  streamType: \"video\" | \"audio\";\n  streamIndex: number;\n}\n\n// Segment accumulator that encapsulates accumulation logic\nclass SegmentAccumulator {\n  private state: SegmentAccumulationState = { type: \"idle\" };\n  private readonly context: TrackProcessingContext;\n  private readonly minDurationMs: number;\n\n  constructor(context: TrackProcessingContext, minDurationMs: number) {\n    this.context = context;\n    this.minDurationMs = minDurationMs;\n  }\n\n  // Evaluation: Determine if we should finalize (semantics)\n  shouldFinalize(nextKeyframe: { pts: number; dts: number } | null): boolean {\n    if (this.state.type !== \"accumulating\") {\n      return false;\n    }\n\n    const durationMs = this.calculateAccumulatedDurationMs();\n    const hasMinimumDuration = durationMs >= this.minDurationMs;\n\n    // For video: finalize on keyframe + minimum duration\n    // For audio: finalize on minimum duration (no keyframe requirement)\n    if (this.context.streamType === \"video\") {\n      return hasMinimumDuration && nextKeyframe !== null;\n    } else {\n      return hasMinimumDuration;\n    }\n  }\n\n  // Evaluation: Calculate what the segment would be (semantics)\n  evaluateSegment(\n    nextBoundary: { pts: number } | null,\n  ): SegmentEvaluation | null {\n    if (this.state.type !== \"accumulating\") {\n      return null;\n    }\n\n    const segmentCts = convertTimestamp(\n      this.state.startPts,\n      this.context.timebase,\n      this.context.timescale,\n    );\n    const segmentDts = convertTimestamp(\n      this.state.startDts,\n      this.context.timebase,\n      this.context.timescale,\n    );\n    const segmentDuration = this.calculateSegmentDuration(\n      segmentCts,\n      nextBoundary,\n    );\n    const { offset, size } = calculateSegmentByteRange(this.state.fragments);\n\n    return {\n      cts: segmentCts,\n      dts: segmentDts,\n      duration: segmentDuration,\n      offset,\n      size,\n    };\n  }\n\n  // Application: Add fragment to accumulation (mechanism)\n  addFragment(fragment: Fragment, fragmentData: FragmentTimingData): void {\n    if (this.state.type === \"idle\") {\n      // Start accumulation - invariant: video segments must start on keyframe\n      const startPts = this.getStartPts(fragmentData);\n      const startDts = this.getStartDts(fragmentData);\n      this.state = {\n        type: \"accumulating\",\n        startPts,\n        startDts,\n        fragments: [{ fragment, fragmentData }],\n      };\n    } else {\n      // Continue accumulation\n      this.state.fragments.push({ fragment, fragmentData });\n    }\n  }\n\n  // Application: Reset accumulation (mechanism)\n  reset(): void {\n    this.state = { type: \"idle\" };\n  }\n\n  // Application: Start new segment with keyframe (mechanism)\n  startNewSegment(keyframe: { pts: number; dts: number }): void {\n    this.state = {\n      type: \"accumulating\",\n      startPts: keyframe.pts,\n      startDts: keyframe.dts,\n      fragments: [],\n    };\n  }\n\n  // Query: Get current state\n  getState(): SegmentAccumulationState {\n    return this.state;\n  }\n\n  // Query: Check if accumulating\n  isAccumulating(): boolean {\n    return this.state.type === \"accumulating\";\n  }\n\n  // Private helpers\n  private calculateAccumulatedDurationMs(): number {\n    if (this.state.type !== \"accumulating\") {\n      return 0;\n    }\n\n    const lastFrag = this.state.fragments[this.state.fragments.length - 1]!;\n    const lastPacket = this.getLastPacket(lastFrag.fragmentData);\n    const endCts = convertTimestamp(\n      lastPacket.pts + (lastPacket.duration || 0),\n      this.context.timebase,\n      this.context.timescale,\n    );\n    const startCts = convertTimestamp(\n      this.state.startPts,\n      this.context.timebase,\n      this.context.timescale,\n    );\n    return durationMsFromTimescale(endCts - startCts, this.context.timescale);\n  }\n\n  private calculateSegmentDuration(\n    segmentCts: number,\n    nextBoundary: { pts: number } | null,\n  ): number {\n    if (nextBoundary) {\n      const nextSegmentCts = convertTimestamp(\n        nextBoundary.pts,\n        this.context.timebase,\n        this.context.timescale,\n      );\n      return nextSegmentCts - segmentCts;\n    }\n\n    // Last segment: duration to end of all packets\n    // Use pre-cached streamPackets (Performance Through Caching)\n    const sortedPackets = [...this.context.streamPackets].sort(\n      (a, b) => a.pts - b.pts,\n    );\n    const lastPacket = sortedPackets[sortedPackets.length - 1]!;\n    const streamEnd = convertTimestamp(\n      lastPacket.pts + (lastPacket.duration || 0),\n      this.context.timebase,\n      this.context.timescale,\n    );\n    return streamEnd - segmentCts;\n  }\n\n  private getStartPts(fragmentData: FragmentTimingData): number {\n    if (this.context.streamType === \"video\") {\n      const keyframe = fragmentData.videoPackets.find((p) => p.isKeyframe);\n      return keyframe?.pts ?? fragmentData.videoPackets[0]?.pts ?? 0;\n    } else {\n      return fragmentData.audioPackets[0]?.pts ?? 0;\n    }\n  }\n\n  private getStartDts(fragmentData: FragmentTimingData): number {\n    if (this.context.streamType === \"video\") {\n      const keyframe = fragmentData.videoPackets.find((p) => p.isKeyframe);\n      return keyframe?.dts ?? fragmentData.videoPackets[0]?.dts ?? 0;\n    } else {\n      return fragmentData.audioPackets[0]?.dts ?? 0;\n    }\n  }\n\n  private getLastPacket(fragmentData: FragmentTimingData): {\n    pts: number;\n    duration?: number;\n  } {\n    if (this.context.streamType === \"video\") {\n      const packets = fragmentData.videoPackets;\n      return packets[packets.length - 1]!;\n    } else {\n      const packets = fragmentData.audioPackets;\n      return packets[packets.length - 1]!;\n    }\n  }\n}\n\n// Helper function to extract fragment data (init + media fragment)\n\nexport const generateFragmentIndex = async (\n  inputStream: Readable,\n  startTimeOffsetMs?: number,\n  trackIdMapping?: Record<number, number>, // Map from source track ID to desired track ID\n): Promise<Record<number, TrackFragmentIndex>> => {\n  // Step 1: Create a streaming parser that detects fragment boundaries\n  const parser = new StreamingBoxParser();\n\n  // Step 2: Create a passthrough stream that doesn't buffer everything\n  const chunks: Buffer[] = [];\n  let totalSize = 0;\n\n  const dest = new Writable({\n    write(chunk, _encoding, callback) {\n      chunks.push(chunk);\n      totalSize += chunk.length;\n      callback();\n    },\n  });\n\n  // Process the stream through both parser and collection\n  await pipeline(inputStream, parser, dest);\n  const fragments = parser.getFragments();\n\n  // If no data was collected, return empty result\n  if (totalSize === 0) {\n    return {};\n  }\n\n  // Step 3: Use ffprobe to analyze the complete stream for track metadata\n  const completeData = Buffer.concat(chunks as readonly Uint8Array[]);\n  const completeStream = createFragmentStream(\n    new Uint8Array(\n      completeData.buffer,\n      completeData.byteOffset,\n      completeData.byteLength,\n    ),\n  );\n\n  let probe: PacketProbe;\n  try {\n    probe = await PacketProbe.probeStream(completeStream);\n  } catch (error) {\n    console.warn(\"Failed to probe stream with ffprobe:\", error);\n    return {};\n  }\n\n  const videoStreams = probe.videoStreams;\n  const audioStreams = probe.audioStreams;\n\n  const trackIndexes: Record<number, TrackFragmentIndex> = {};\n  const initFragment = fragments.find((f) => f.type === \"init\");\n  const mediaFragments = fragments.filter((f) => f.type === \"media\");\n\n  // Map packets to fragments using byte position for moof+mdat boundaries\n  // But create contiguous segments based on keyframes\n  const fragmentTimingData: FragmentTimingData[] = [];\n\n  for (\n    let fragmentIndex = 0;\n    fragmentIndex < mediaFragments.length;\n    fragmentIndex++\n  ) {\n    const fragment = mediaFragments[fragmentIndex]!;\n\n    // Find packets that belong to this fragment based on byte position (moof+mdat boundaries)\n    const fragmentStart = fragment.offset;\n    const fragmentEnd = fragment.offset + fragment.size;\n\n    const videoPackets = probe.packets\n      .filter((packet) => {\n        const stream = videoStreams.find(\n          (s) => s.index === packet.stream_index,\n        );\n        return (\n          stream?.codec_type === \"video\" &&\n          packet.pos !== undefined &&\n          packet.pos >= fragmentStart &&\n          packet.pos < fragmentEnd\n        );\n      })\n      .map((packet) => ({\n        pts: packet.pts,\n        dts: packet.dts,\n        duration: packet.duration,\n        isKeyframe: packet.flags?.includes(\"K\") ?? false,\n      }));\n\n    const audioPackets = probe.packets\n      .filter((packet) => {\n        const stream = audioStreams.find(\n          (s) => s.index === packet.stream_index,\n        );\n        return (\n          stream?.codec_type === \"audio\" &&\n          packet.pos !== undefined &&\n          packet.pos >= fragmentStart &&\n          packet.pos < fragmentEnd\n        );\n      })\n      .map((packet) => ({\n        pts: packet.pts,\n        dts: packet.dts,\n        duration: packet.duration,\n      }));\n\n    fragmentTimingData.push({\n      fragmentIndex,\n      videoPackets,\n      audioPackets,\n    });\n  }\n\n  // Unified track processing function (One Direction of Truth)\n  const processTrack = (\n    streamIndex: number,\n    streamType: \"video\" | \"audio\",\n    timebase: Timebase,\n    allPackets: ProbePacket[],\n  ): TrackSegment[] => {\n    const segments: TrackSegment[] = [];\n    const timescale = Math.round(timebase.den / timebase.num);\n\n    // Cache filtered packets once (Performance Through Caching)\n    const streamPackets = allPackets.filter(\n      (p) => p.stream_index === streamIndex,\n    );\n\n    const context: TrackProcessingContext = {\n      timebase,\n      timescale,\n      fragmentTimingData,\n      mediaFragments,\n      streamPackets,\n      streamType,\n      streamIndex,\n    };\n\n    const accumulator = new SegmentAccumulator(\n      context,\n      MIN_SEGMENT_DURATION_MS,\n    );\n\n    for (let i = 0; i < fragmentTimingData.length; i++) {\n      const fragmentData = fragmentTimingData[i]!;\n      const fragment = mediaFragments[fragmentData.fragmentIndex]!;\n      const packets =\n        streamType === \"video\"\n          ? fragmentData.videoPackets\n          : fragmentData.audioPackets;\n\n      log(\n        `Fragment ${fragmentData.fragmentIndex}: ${packets.length} ${streamType} packets`,\n      );\n\n      if (packets.length === 0) {\n        log(\n          `Skipping fragment ${fragmentData.fragmentIndex} - no ${streamType} packets`,\n        );\n        continue;\n      }\n\n      if (streamType === \"video\") {\n        // Video: segments must start on keyframes\n        const keyframe = fragmentData.videoPackets.find((p) => p.isKeyframe);\n        const hasKeyframe = keyframe !== undefined;\n\n        // Start new segment on keyframe if none exists\n        if (!accumulator.isAccumulating() && hasKeyframe) {\n          accumulator.startNewSegment({\n            pts: keyframe.pts,\n            dts: keyframe.dts,\n          });\n          accumulator.addFragment(fragment, fragmentData);\n          continue;\n        }\n\n        // Skip fragments without keyframes if no segment started\n        if (!accumulator.isAccumulating()) {\n          continue;\n        }\n\n        // Check if we should finalize when encountering a new keyframe\n        if (hasKeyframe) {\n          if (\n            accumulator.shouldFinalize({ pts: keyframe.pts, dts: keyframe.dts })\n          ) {\n            // Duration should be to the start of this keyframe (start of next segment)\n            const nextBoundary = { pts: keyframe.pts };\n            const evaluation = accumulator.evaluateSegment(nextBoundary);\n            if (evaluation) {\n              segments.push(evaluation);\n            }\n            accumulator.reset();\n            accumulator.startNewSegment({\n              pts: keyframe.pts,\n              dts: keyframe.dts,\n            });\n          }\n        }\n      } else {\n        // Audio: no keyframe requirement, just duration-based\n        if (!accumulator.isAccumulating()) {\n          accumulator.addFragment(fragment, fragmentData);\n          continue;\n        }\n\n        // Check if we should finalize based on accumulated duration\n        if (accumulator.shouldFinalize(null)) {\n          // Duration should be to the start of this fragment (start of next segment)\n          const nextBoundary = { pts: fragmentData.audioPackets[0]!.pts };\n          const evaluation = accumulator.evaluateSegment(nextBoundary);\n          if (evaluation) {\n            segments.push(evaluation);\n          }\n          accumulator.reset();\n        }\n      }\n\n      // Add fragment to current segment\n      accumulator.addFragment(fragment, fragmentData);\n    }\n\n    // Finalize any remaining accumulated fragments\n    if (accumulator.isAccumulating()) {\n      const evaluation = accumulator.evaluateSegment(null);\n      if (evaluation) {\n        segments.push(evaluation);\n      }\n    }\n\n    return segments;\n  };\n\n  // Step 4: Process video tracks using ffprobe data\n  for (const videoStream of videoStreams) {\n    // Get timebase for this stream to convert timestamps\n    const timebase = probe.videoTimebase;\n    if (!timebase) {\n      console.warn(\"No timebase found for video stream\");\n      continue;\n    }\n\n    const timescale = Math.round(timebase.den / timebase.num);\n\n    // Cache filtered packets once (Performance Through Caching)\n    const streamPackets = (probe.packets as ProbePacket[]).filter(\n      (p) => p.stream_index === videoStream.index,\n    );\n    const keyframePackets = streamPackets.filter((p) => p.flags?.includes(\"K\"));\n    const totalSampleCount = keyframePackets.length;\n\n    log(\n      `Complete stream has ${streamPackets.length} video packets, ${keyframePackets.length} keyframes for stream ${videoStream.index}`,\n    );\n\n    // Calculate per-track timing offset from first packet for timeline mapping\n    let trackStartTimeOffsetMs: number | undefined;\n    if (streamPackets.length > 0) {\n      log(\n        `First video packet dts_time: ${streamPackets[0]!.dts_time}, pts_time: ${streamPackets[0]!.pts_time}`,\n      );\n      const presentationTime = streamPackets[0]!.pts_time;\n      if (Math.abs(presentationTime) > 0.01) {\n        trackStartTimeOffsetMs = presentationTime * MS_PER_SECOND;\n      }\n    }\n    if (startTimeOffsetMs !== undefined) {\n      trackStartTimeOffsetMs = startTimeOffsetMs;\n    }\n\n    // Process fragments to create segments with minimum duration\n    const segments = processTrack(\n      videoStream.index,\n      \"video\",\n      timebase,\n      probe.packets as ProbePacket[],\n    );\n\n    // Calculate total duration from cached stream packets\n    let totalDuration = 0;\n    if (streamPackets.length > 0) {\n      const firstPacket = streamPackets[0]!;\n      const lastPacket = streamPackets[streamPackets.length - 1]!;\n      const firstPts = convertTimestamp(firstPacket.pts, timebase, timescale);\n      const lastPts = convertTimestamp(lastPacket.pts, timebase, timescale);\n      totalDuration = lastPts - firstPts;\n    }\n\n    const finalTrackId =\n      trackIdMapping?.[videoStream.index] ?? videoStream.index + 1;\n    trackIndexes[finalTrackId] = {\n      track: finalTrackId,\n      type: \"video\",\n      width: videoStream.coded_width || videoStream.width,\n      height: videoStream.coded_height || videoStream.height,\n      timescale: timescale,\n      sample_count: totalSampleCount,\n      codec: constructH264CodecString(\n        videoStream.codec_tag_string,\n        videoStream.profile,\n        videoStream.level,\n      ),\n      duration: totalDuration,\n      startTimeOffsetMs: trackStartTimeOffsetMs,\n      initSegment: {\n        offset: 0,\n        size: initFragment?.size || 0,\n      },\n      segments,\n    };\n  }\n\n  // Step 5: Process audio tracks using ffprobe data\n  for (const audioStream of audioStreams) {\n    // Get timebase for this stream to convert timestamps\n    const timebase = probe.audioTimebase;\n    if (!timebase) {\n      console.warn(\"No timebase found for audio stream\");\n      continue;\n    }\n\n    const timescale = Math.round(timebase.den / timebase.num);\n\n    // Cache filtered packets once (Performance Through Caching)\n    const streamPackets = (probe.packets as ProbePacket[]).filter(\n      (p) => p.stream_index === audioStream.index,\n    );\n    const totalSampleCount = streamPackets.length;\n\n    // Calculate per-track timing offset from first packet for timeline mapping\n    let trackStartTimeOffsetMs: number | undefined;\n    if (streamPackets.length > 0) {\n      const presentationTime = streamPackets[0]!.pts_time;\n      if (Math.abs(presentationTime) > 0.01) {\n        trackStartTimeOffsetMs = presentationTime * MS_PER_SECOND;\n      }\n    }\n    if (startTimeOffsetMs !== undefined) {\n      trackStartTimeOffsetMs = startTimeOffsetMs;\n    }\n\n    // Process fragments to create segments with minimum duration\n    const segments = processTrack(\n      audioStream.index,\n      \"audio\",\n      timebase,\n      probe.packets as ProbePacket[],\n    );\n\n    // Calculate total duration\n    const totalDuration = segments.reduce((sum, seg) => sum + seg.duration, 0);\n\n    const finalTrackId =\n      trackIdMapping?.[audioStream.index] ?? audioStream.index + 1;\n    trackIndexes[finalTrackId] = {\n      track: finalTrackId,\n      type: \"audio\",\n      channel_count: audioStream.channels,\n      sample_rate: Number(audioStream.sample_rate),\n      sample_size: audioStream.bits_per_sample,\n      sample_count: totalSampleCount,\n      timescale: timescale,\n      codec: audioStream.codec_tag_string || audioStream.codec_name || \"\",\n      duration: totalDuration,\n      startTimeOffsetMs: trackStartTimeOffsetMs,\n      initSegment: {\n        offset: 0,\n        size: initFragment?.size || 0,\n      },\n      segments,\n    };\n  }\n\n  return trackIndexes;\n};\n"],"mappings":"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"}

package/dist/generateSingleTrack.cjs

@@ -0,0 +1,82 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_Probe = require('./Probe.cjs');
+const require_generateFragmentIndex = require('./generateFragmentIndex.cjs');
+const require_idempotentTask = require('./idempotentTask.cjs');
+let debug = require("debug");
+debug = require_rolldown_runtime.__toESM(debug);
+let node_stream = require("node:stream");
+node_stream = require_rolldown_runtime.__toESM(node_stream);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path);
+
+//#region src/generateSingleTrack.ts
+const log = (0, debug.default)("ef:generateSingleTrack");
+const generateSingleTrackFromPath = async (absolutePath, trackId) => {
+	log(`Generating track ${trackId} for ${absolutePath}`);
+	const probe = await require_Probe.Probe.probePath(absolutePath);
+	const streamIndex = trackId - 1;
+	if (streamIndex < 0 || streamIndex >= probe.streams.length) throw new Error(`Track ${trackId} not found (valid tracks: 1-${probe.streams.length})`);
+	const trackStream = probe.createTrackReadstream(streamIndex);
+	const outputStream = new node_stream.PassThrough();
+	const indexStream = new node_stream.PassThrough();
+	trackStream.pipe(outputStream, { end: false });
+	trackStream.pipe(indexStream);
+	let sourceStreamEnded = false;
+	trackStream.on("end", () => {
+		sourceStreamEnded = true;
+	});
+	trackStream.on("error", (error) => {
+		outputStream.destroy(error);
+		indexStream.destroy(error);
+	});
+	const fragmentIndexPromise = require_generateFragmentIndex.generateFragmentIndex(indexStream, void 0, { 1: trackId });
+	fragmentIndexPromise.then(() => {
+		if (sourceStreamEnded) outputStream.end();
+		else trackStream.once("end", () => {
+			outputStream.end();
+		});
+	}).catch((error) => {
+		outputStream.destroy(error);
+	});
+	return {
+		stream: outputStream,
+		fragmentIndex: fragmentIndexPromise
+	};
+};
+const generateSingleTrackTask = require_idempotentTask.idempotentTask({
+	label: "track-single",
+	filename: (absolutePath, trackId) => `${(0, node_path.basename)(absolutePath)}.track-${trackId}.mp4`,
+	runner: async (absolutePath, trackId) => {
+		const result = await generateSingleTrackFromPath(absolutePath, trackId);
+		const finalStream = new node_stream.PassThrough();
+		const fragmentIndexPromise = result.fragmentIndex.catch((error) => {
+			console.warn(`Fragment index generation failed for track ${trackId}:`, error);
+		});
+		let progressTimeout = null;
+		const resetProgressTimeout = () => {
+			if (progressTimeout) clearTimeout(progressTimeout);
+			progressTimeout = setTimeout(() => {
+				if (!finalStream.destroyed) {
+					console.warn(`Progress timeout triggered for track ${trackId} - no activity for 10 seconds`);
+					finalStream.end();
+				}
+			}, 1e4);
+		};
+		resetProgressTimeout();
+		result.stream.on("data", () => {
+			resetProgressTimeout();
+		});
+		result.stream.on("end", () => {
+			resetProgressTimeout();
+		});
+		result.stream.pipe(finalStream, { end: false });
+		await fragmentIndexPromise;
+		finalStream.end();
+		if (progressTimeout) clearTimeout(progressTimeout);
+		return finalStream;
+	}
+});
+
+//#endregion
+exports.generateSingleTrackFromPath = generateSingleTrackFromPath;
+//# sourceMappingURL=generateSingleTrack.cjs.map

package/dist/generateSingleTrack.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSingleTrack.cjs","names":["Probe","PassThrough","generateFragmentIndex","idempotentTask","progressTimeout: NodeJS.Timeout | null"],"sources":["../src/generateSingleTrack.ts"],"sourcesContent":["import { idempotentTask } from \"./idempotentTask.js\";\nimport debug from \"debug\";\nimport { PassThrough } from \"node:stream\";\nimport { basename } from \"node:path\";\nimport { Probe } from \"./Probe.js\";\nimport { generateFragmentIndex } from \"./generateFragmentIndex.js\";\n\nconst log = debug(\"ef:generateSingleTrack\");\n\nexport const generateSingleTrackFromPath = async (\n  absolutePath: string,\n  trackId: number,\n) => {\n  log(`Generating track ${trackId} for ${absolutePath}`);\n\n  const probe = await Probe.probePath(absolutePath);\n\n  // Map track ID (1-based) to stream index (0-based) - tracks use 1-based IDs, streams use 0-based indices\n  const streamIndex = trackId - 1;\n\n  if (streamIndex < 0 || streamIndex >= probe.streams.length) {\n    throw new Error(\n      `Track ${trackId} not found (valid tracks: 1-${probe.streams.length})`,\n    );\n  }\n\n  // Get the track stream from FFmpeg (single track, fragmented MP4)\n  const trackStream = probe.createTrackReadstream(streamIndex);\n\n  // Create a PassThrough to tee the stream\n  const outputStream = new PassThrough();\n  const indexStream = new PassThrough();\n\n  // Pipe data but DON'T end outputStream automatically - we'll control this\n  trackStream.pipe(outputStream, { end: false });\n  trackStream.pipe(indexStream);\n\n  // Track when the source stream ends (but don't end output yet)\n  let sourceStreamEnded = false;\n  trackStream.on(\"end\", () => {\n    sourceStreamEnded = true;\n  });\n\n  trackStream.on(\"error\", (error) => {\n    outputStream.destroy(error);\n    indexStream.destroy(error);\n  });\n\n  // Generate fragment index from the single-track stream\n  // This will be a single-track index since we're processing isolated track\n  // Map the single-track file's track ID 1 to the original multi-track ID\n  const trackIdMapping = { 1: trackId }; // Single track 1 -> original trackId\n  const fragmentIndexPromise = generateFragmentIndex(\n    indexStream,\n    undefined,\n    trackIdMapping,\n  );\n\n  // End outputStream only after BOTH source ends AND fragment index completes\n  fragmentIndexPromise\n    .then(() => {\n      if (sourceStreamEnded) {\n        outputStream.end();\n      } else {\n        // If fragment index completes first, wait for stream to end\n        trackStream.once(\"end\", () => {\n          outputStream.end();\n        });\n      }\n    })\n    .catch((error) => {\n      outputStream.destroy(error);\n    });\n\n  // Return both the stream and the index\n  return {\n    stream: outputStream,\n    fragmentIndex: fragmentIndexPromise,\n  };\n};\n\nexport const generateSingleTrackTask = idempotentTask({\n  label: \"track-single\",\n  filename: (absolutePath: string, trackId: number) =>\n    `${basename(absolutePath)}.track-${trackId}.mp4`,\n  runner: async (absolutePath: string, trackId: number) => {\n    const result = await generateSingleTrackFromPath(absolutePath, trackId);\n\n    // Create a PassThrough stream that processes fragment index in parallel\n    const finalStream = new PassThrough();\n\n    // Start fragment index processing immediately (don't wait for stream to end)\n    const fragmentIndexPromise = result.fragmentIndex.catch((error) => {\n      console.warn(\n        `Fragment index generation failed for track ${trackId}:`,\n        error,\n      );\n      // Don't fail the stream if fragment index fails\n    });\n\n    // Monitor progress and extend timeout based on actual work\n    let progressTimeout: NodeJS.Timeout | null = null;\n\n    const resetProgressTimeout = () => {\n      if (progressTimeout) {\n        clearTimeout(progressTimeout);\n      }\n\n      progressTimeout = setTimeout(() => {\n        if (!finalStream.destroyed) {\n          console.warn(\n            `Progress timeout triggered for track ${trackId} - no activity for 10 seconds`,\n          );\n          finalStream.end();\n        }\n      }, 10000); // 10 second sliding timeout\n    };\n\n    // Start the initial timeout\n    resetProgressTimeout();\n\n    // Monitor data flow to detect active work\n    result.stream.on(\"data\", () => {\n      resetProgressTimeout(); // Reset timeout when we see data\n    });\n\n    result.stream.on(\"end\", () => {\n      resetProgressTimeout(); // Reset timeout when stream ends\n    });\n\n    // Pipe data through but don't end until fragment index is ready\n    result.stream.pipe(finalStream, { end: false });\n\n    // Wait for fragment index to complete, then end the stream\n    await fragmentIndexPromise;\n    finalStream.end();\n\n    // Clean up timeout\n    if (progressTimeout) {\n      clearTimeout(progressTimeout);\n    }\n\n    return finalStream;\n  },\n});\n\nexport const generateSingleTrack = async (\n  cacheRoot: string,\n  absolutePath: string,\n  url: string,\n) => {\n  try {\n    const trackId = new URL(`http://localhost${url}`).searchParams.get(\n      \"trackId\",\n    );\n    if (trackId === null) {\n      throw new Error(\n        \"No trackId provided. It must be specified in the query string: ?trackId=0\",\n      );\n    }\n    return await generateSingleTrackTask(\n      cacheRoot,\n      absolutePath,\n      Number(trackId),\n    );\n  } catch (error) {\n    console.error(error);\n    console.trace(\"Error generating track\", error);\n    throw error;\n  }\n};\n\n// Helper function to get both stream and fragment index\nexport const generateSingleTrackWithIndex = async (\n  absolutePath: string,\n  trackId: number,\n) => {\n  log(`Generating track ${trackId} with index for ${absolutePath}`);\n\n  const probe = await Probe.probePath(absolutePath);\n\n  // Map track ID (1-based) to stream index (0-based) for compatibility\n  const streamIndex = trackId - 1;\n\n  if (streamIndex < 0 || streamIndex >= probe.streams.length) {\n    throw new Error(\n      `Track ${trackId} not found (valid tracks: 1-${probe.streams.length})`,\n    );\n  }\n\n  const trackStream = probe.createTrackReadstream(streamIndex);\n\n  // Collect all data for fragment index generation\n  const chunks: Buffer[] = [];\n  const outputStream = new PassThrough();\n\n  // Tee the stream: collect for index AND pass through for output\n  trackStream.on(\"data\", (chunk: Buffer) => {\n    chunks.push(chunk);\n    outputStream.write(chunk);\n  });\n\n  trackStream.on(\"end\", () => {\n    // Don't end the output stream immediately - wait for async processing\n    (async () => {\n      try {\n        // Create a readable from collected chunks for fragment index\n        const { Readable } = await import(\"node:stream\");\n        const indexInputStream = Readable.from(Buffer.concat(chunks as any));\n\n        // Generate fragment index with track ID mapping\n        const trackIdMapping = { 1: trackId }; // Single track 1 -> original trackId\n        const fragmentIndex = await generateFragmentIndex(\n          indexInputStream,\n          undefined,\n          trackIdMapping,\n        );\n\n        // Emit the fragment index as metadata\n        outputStream.emit(\"fragmentIndex\", fragmentIndex);\n\n        // Now it's safe to end the stream\n        outputStream.end();\n      } catch (error) {\n        outputStream.destroy(error as Error);\n      }\n    })();\n  });\n\n  trackStream.on(\"error\", (error) => {\n    outputStream.destroy(error);\n  });\n\n  return outputStream;\n};\n"],"mappings":";;;;;;;;;;;;AAOA,MAAM,yBAAY,yBAAyB;AAE3C,MAAa,8BAA8B,OACzC,cACA,YACG;AACH,KAAI,oBAAoB,QAAQ,OAAO,eAAe;CAEtD,MAAM,QAAQ,MAAMA,oBAAM,UAAU,aAAa;CAGjD,MAAM,cAAc,UAAU;AAE9B,KAAI,cAAc,KAAK,eAAe,MAAM,QAAQ,OAClD,OAAM,IAAI,MACR,SAAS,QAAQ,8BAA8B,MAAM,QAAQ,OAAO,GACrE;CAIH,MAAM,cAAc,MAAM,sBAAsB,YAAY;CAG5D,MAAM,eAAe,IAAIC,yBAAa;CACtC,MAAM,cAAc,IAAIA,yBAAa;AAGrC,aAAY,KAAK,cAAc,EAAE,KAAK,OAAO,CAAC;AAC9C,aAAY,KAAK,YAAY;CAG7B,IAAI,oBAAoB;AACxB,aAAY,GAAG,aAAa;AAC1B,sBAAoB;GACpB;AAEF,aAAY,GAAG,UAAU,UAAU;AACjC,eAAa,QAAQ,MAAM;AAC3B,cAAY,QAAQ,MAAM;GAC1B;CAMF,MAAM,uBAAuBC,oDAC3B,aACA,QAHqB,EAAE,GAAG,SAAS,CAKpC;AAGD,sBACG,WAAW;AACV,MAAI,kBACF,cAAa,KAAK;MAGlB,aAAY,KAAK,aAAa;AAC5B,gBAAa,KAAK;IAClB;GAEJ,CACD,OAAO,UAAU;AAChB,eAAa,QAAQ,MAAM;GAC3B;AAGJ,QAAO;EACL,QAAQ;EACR,eAAe;EAChB;;AAGH,MAAa,0BAA0BC,sCAAe;CACpD,OAAO;CACP,WAAW,cAAsB,YAC/B,2BAAY,aAAa,CAAC,SAAS,QAAQ;CAC7C,QAAQ,OAAO,cAAsB,YAAoB;EACvD,MAAM,SAAS,MAAM,4BAA4B,cAAc,QAAQ;EAGvE,MAAM,cAAc,IAAIF,yBAAa;EAGrC,MAAM,uBAAuB,OAAO,cAAc,OAAO,UAAU;AACjE,WAAQ,KACN,8CAA8C,QAAQ,IACtD,MACD;IAED;EAGF,IAAIG,kBAAyC;EAE7C,MAAM,6BAA6B;AACjC,OAAI,gBACF,cAAa,gBAAgB;AAG/B,qBAAkB,iBAAiB;AACjC,QAAI,CAAC,YAAY,WAAW;AAC1B,aAAQ,KACN,wCAAwC,QAAQ,+BACjD;AACD,iBAAY,KAAK;;MAElB,IAAM;;AAIX,wBAAsB;AAGtB,SAAO,OAAO,GAAG,cAAc;AAC7B,yBAAsB;IACtB;AAEF,SAAO,OAAO,GAAG,aAAa;AAC5B,yBAAsB;IACtB;AAGF,SAAO,OAAO,KAAK,aAAa,EAAE,KAAK,OAAO,CAAC;AAG/C,QAAM;AACN,cAAY,KAAK;AAGjB,MAAI,gBACF,cAAa,gBAAgB;AAG/B,SAAO;;CAEV,CAAC"}

package/dist/idempotentTask.cjs

@@ -0,0 +1,152 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_md5 = require('./md5.cjs');
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs);
+let debug = require("debug");
+debug = require_rolldown_runtime.__toESM(debug);
+let node_stream = require("node:stream");
+node_stream = require_rolldown_runtime.__toESM(node_stream);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_rolldown_runtime.__toESM(node_fs_promises);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path);
+
+//#region src/idempotentTask.ts
+const idempotentTask = ({ label, filename, runner }) => {
+	const tasks = {};
+	const downloadTasks = {};
+	const isValidCacheFile = async (filePath, allowEmpty = false) => {
+		try {
+			const stats = await (0, node_fs_promises.stat)(filePath);
+			return allowEmpty || stats.size > 0;
+		} catch {
+			return false;
+		}
+	};
+	return async (rootDir, absolutePath, ...args) => {
+		const log = (0, debug.default)(`ef:${label}`);
+		const cacheDirRoot = node_path.default.join(rootDir, ".cache");
+		await (0, node_fs_promises.mkdir)(cacheDirRoot, { recursive: true });
+		log(`Running ef:${label} task for ${absolutePath} in ${rootDir}`);
+		if (absolutePath.includes("http")) {
+			const safePath = absolutePath.replace(/[^a-zA-Z0-9]/g, "_");
+			const downloadCachePath = node_path.default.join(rootDir, ".cache", `${safePath}.file`);
+			if ((0, node_fs.existsSync)(downloadCachePath) && await isValidCacheFile(downloadCachePath, true)) {
+				log(`Already cached ${absolutePath}`);
+				absolutePath = downloadCachePath;
+			} else {
+				const downloadKey = absolutePath;
+				if (!downloadTasks[downloadKey]) {
+					log(`Starting download for ${absolutePath}`);
+					downloadTasks[downloadKey] = (async () => {
+						try {
+							const response = await fetch(absolutePath);
+							if (!response.ok) throw new Error(`Failed to fetch file from URL ${absolutePath}: ${response.status} ${response.statusText}`);
+							const stream = response.body;
+							if (!stream) throw new Error(`No response body for URL ${absolutePath}`);
+							const tempPath = `${downloadCachePath}.tmp`;
+							const writeStream = (0, node_fs.createWriteStream)(tempPath);
+							const readable = node_stream.Readable.fromWeb(stream);
+							readable.pipe(writeStream);
+							await new Promise((resolve, reject) => {
+								readable.on("error", reject);
+								writeStream.on("error", reject);
+								writeStream.on("finish", () => resolve());
+							});
+							const { rename } = await import("node:fs/promises");
+							await rename(tempPath, downloadCachePath);
+							log(`Download completed for ${absolutePath}`);
+							return downloadCachePath;
+						} catch (error) {
+							log(`Download failed for ${absolutePath}: ${error}`);
+							delete downloadTasks[downloadKey];
+							throw error;
+						}
+					})();
+				}
+				absolutePath = await downloadTasks[downloadKey];
+				delete downloadTasks[downloadKey];
+			}
+		}
+		const expectedFilename = filename(absolutePath, ...args);
+		let cachePath = null;
+		let md5 = null;
+		const scanStartTime = Date.now();
+		try {
+			const cacheDirs = await (0, node_fs_promises.readdir)(cacheDirRoot, { withFileTypes: true });
+			log(`Scanning ${cacheDirs.length} cache directories for ${expectedFilename}`);
+			for (const dir of cacheDirs) if (dir.isDirectory()) {
+				const candidatePath = node_path.default.join(cacheDirRoot, dir.name, expectedFilename);
+				if ((0, node_fs.existsSync)(candidatePath) && await isValidCacheFile(candidatePath)) {
+					cachePath = candidatePath;
+					md5 = dir.name;
+					log(`Found existing cache in ${Date.now() - scanStartTime}ms: ${candidatePath} (skipped MD5)`);
+					break;
+				}
+			}
+			if (!cachePath) log(`Cache scan completed in ${Date.now() - scanStartTime}ms, no cache found - will compute MD5`);
+		} catch (error) {
+			log(`Cache scan failed after ${Date.now() - scanStartTime}ms, will compute MD5: ${error}`);
+		}
+		if (!md5) {
+			const md5StartTime = Date.now();
+			log(`Computing MD5 for ${absolutePath}...`);
+			md5 = await require_md5.md5FilePath(absolutePath);
+			log(`MD5 computed in ${Date.now() - md5StartTime}ms: ${md5}`);
+		}
+		const cacheDir = node_path.default.join(cacheDirRoot, md5);
+		log(`Cache dir: ${cacheDir}`);
+		await (0, node_fs_promises.mkdir)(cacheDir, { recursive: true });
+		if (!cachePath) cachePath = node_path.default.join(cacheDir, expectedFilename);
+		const key = cachePath;
+		if ((0, node_fs.existsSync)(cachePath) && await isValidCacheFile(cachePath)) {
+			log(`Returning cached ef:${label} task for ${key}`);
+			return {
+				cachePath,
+				md5Sum: md5
+			};
+		}
+		const maybeTask = tasks[key];
+		if (maybeTask) {
+			log(`Returning existing ef:${label} task for ${key}`);
+			return await maybeTask;
+		}
+		log(`Creating new ef:${label} task for ${key}`);
+		const fullTask = (async () => {
+			try {
+				log(`Awaiting task for ${key}`);
+				const result = await runner(absolutePath, ...args);
+				if (result instanceof node_stream.Readable) {
+					log(`Piping task for ${key} to cache`);
+					const tempPath = `${cachePath}.tmp`;
+					const writeStream = (0, node_fs.createWriteStream)(tempPath);
+					result.pipe(writeStream);
+					await new Promise((resolve, reject) => {
+						result.on("error", reject);
+						writeStream.on("error", reject);
+						writeStream.on("finish", () => resolve());
+					});
+					const { rename } = await import("node:fs/promises");
+					await rename(tempPath, cachePath);
+				} else {
+					log(`Writing to ${cachePath}`);
+					await (0, node_fs_promises.writeFile)(cachePath, result);
+				}
+				delete tasks[key];
+				return {
+					md5Sum: md5,
+					cachePath
+				};
+			} catch (error) {
+				delete tasks[key];
+				throw error;
+			}
+		})();
+		tasks[key] = fullTask;
+		return await fullTask;
+	};
+};
+
+//#endregion
+exports.idempotentTask = idempotentTask;
+//# sourceMappingURL=idempotentTask.cjs.map

package/dist/idempotentTask.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotentTask.cjs","names":["tasks: Record<string, Promise<TaskResult>>","downloadTasks: Record<string, Promise<string>>","path","Readable","cachePath: string | null","md5: string | null","md5FilePath"],"sources":["../src/idempotentTask.ts"],"sourcesContent":["import { createWriteStream, existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { md5FilePath } from \"./md5.js\";\nimport debug from \"debug\";\nimport { mkdir, writeFile, stat, readdir } from \"node:fs/promises\";\nimport { Readable } from \"node:stream\";\n\ninterface TaskOptions<T extends unknown[]> {\n  label: string;\n  filename: (absolutePath: string, ...args: T) => string;\n  runner: (absolutePath: string, ...args: T) => Promise<string | Readable>;\n}\n\nexport interface TaskResult {\n  md5Sum: string;\n  cachePath: string;\n}\n\nexport const idempotentTask = <T extends unknown[]>({\n  label,\n  filename,\n  runner,\n}: TaskOptions<T>) => {\n  const tasks: Record<string, Promise<TaskResult>> = {};\n  const downloadTasks: Record<string, Promise<string>> = {};\n\n  // Helper function to validate cache file completeness\n  const isValidCacheFile = async (\n    filePath: string,\n    allowEmpty = false,\n  ): Promise<boolean> => {\n    try {\n      const stats = await stat(filePath);\n      // File must exist and either have content or be explicitly allowed to be empty\n      return allowEmpty || stats.size > 0;\n    } catch {\n      return false;\n    }\n  };\n\n  return async (\n    rootDir: string,\n    absolutePath: string,\n    ...args: T\n  ): Promise<TaskResult> => {\n    const log = debug(`ef:${label}`);\n    const cacheDirRoot = path.join(rootDir, \".cache\");\n    await mkdir(cacheDirRoot, { recursive: true });\n\n    log(`Running ef:${label} task for ${absolutePath} in ${rootDir}`);\n\n    // Handle HTTP downloads with proper race condition protection\n    if (absolutePath.includes(\"http\")) {\n      const safePath = absolutePath.replace(/[^a-zA-Z0-9]/g, \"_\");\n      const downloadCachePath = path.join(\n        rootDir,\n        \".cache\",\n        `${safePath}.file`,\n      );\n\n      // Check if already downloaded and valid (allow empty downloads)\n      if (\n        existsSync(downloadCachePath) &&\n        (await isValidCacheFile(downloadCachePath, true))\n      ) {\n        log(`Already cached ${absolutePath}`);\n        absolutePath = downloadCachePath;\n      } else {\n        // Use download task deduplication to prevent concurrent downloads\n        const downloadKey = absolutePath;\n        if (!downloadTasks[downloadKey]) {\n          log(`Starting download for ${absolutePath}`);\n          downloadTasks[downloadKey] = (async () => {\n            try {\n              const response = await fetch(absolutePath);\n              if (!response.ok) {\n                throw new Error(\n                  `Failed to fetch file from URL ${absolutePath}: ${response.status} ${response.statusText}`,\n                );\n              }\n\n              const stream = response.body;\n              if (!stream) {\n                throw new Error(`No response body for URL ${absolutePath}`);\n              }\n\n              // Use temporary file to prevent reading incomplete downloads\n              const tempPath = `${downloadCachePath}.tmp`;\n              const writeStream = createWriteStream(tempPath);\n\n              // @ts-ignore node web stream support in typescript is incorrect about this.\n              const readable = Readable.fromWeb(stream);\n              readable.pipe(writeStream);\n\n              await new Promise<void>((resolve, reject) => {\n                readable.on(\"error\", reject);\n                writeStream.on(\"error\", reject);\n                writeStream.on(\"finish\", () => resolve());\n              });\n\n              // Atomically move completed file to final location\n              const { rename } = await import(\"node:fs/promises\");\n              await rename(tempPath, downloadCachePath);\n\n              log(`Download completed for ${absolutePath}`);\n              return downloadCachePath;\n            } catch (error) {\n              log(`Download failed for ${absolutePath}: ${error}`);\n              // Clean up task reference on failure\n              delete downloadTasks[downloadKey];\n              throw error;\n            }\n          })();\n        }\n\n        absolutePath = await downloadTasks[downloadKey];\n        // Clean up completed task\n        delete downloadTasks[downloadKey];\n      }\n    }\n\n    // First, try to find existing cache by scanning cache directories\n    // This avoids expensive MD5 computation when cache already exists\n    const expectedFilename = filename(absolutePath, ...args);\n    let cachePath: string | null = null;\n    let md5: string | null = null;\n\n    // Scan cache directories to find existing cache file\n    const scanStartTime = Date.now();\n    try {\n      const cacheDirs = await readdir(cacheDirRoot, { withFileTypes: true });\n      log(\n        `Scanning ${cacheDirs.length} cache directories for ${expectedFilename}`,\n      );\n      for (const dir of cacheDirs) {\n        if (dir.isDirectory()) {\n          const candidatePath = path.join(\n            cacheDirRoot,\n            dir.name,\n            expectedFilename,\n          );\n          if (\n            existsSync(candidatePath) &&\n            (await isValidCacheFile(candidatePath))\n          ) {\n            cachePath = candidatePath;\n            md5 = dir.name; // Directory name is the MD5\n            const scanElapsed = Date.now() - scanStartTime;\n            log(\n              `Found existing cache in ${scanElapsed}ms: ${candidatePath} (skipped MD5)`,\n            );\n            break;\n          }\n        }\n      }\n      if (!cachePath) {\n        const scanElapsed = Date.now() - scanStartTime;\n        log(\n          `Cache scan completed in ${scanElapsed}ms, no cache found - will compute MD5`,\n        );\n      }\n    } catch (error) {\n      // If cache directory doesn't exist or can't be read, continue to MD5 computation\n      const scanElapsed = Date.now() - scanStartTime;\n      log(\n        `Cache scan failed after ${scanElapsed}ms, will compute MD5: ${error}`,\n      );\n    }\n\n    // Only compute MD5 if we didn't find an existing cache\n    if (!md5) {\n      const md5StartTime = Date.now();\n      log(`Computing MD5 for ${absolutePath}...`);\n      md5 = await md5FilePath(absolutePath);\n      const md5Elapsed = Date.now() - md5StartTime;\n      log(`MD5 computed in ${md5Elapsed}ms: ${md5}`);\n    }\n\n    const cacheDir = path.join(cacheDirRoot, md5);\n    log(`Cache dir: ${cacheDir}`);\n    await mkdir(cacheDir, { recursive: true });\n\n    if (!cachePath) {\n      cachePath = path.join(cacheDir, expectedFilename);\n    }\n    const key = cachePath;\n\n    // Check if cache exists and is valid (not zero-byte)\n    if (existsSync(cachePath) && (await isValidCacheFile(cachePath))) {\n      log(`Returning cached ef:${label} task for ${key}`);\n      return { cachePath, md5Sum: md5 };\n    }\n\n    const maybeTask = tasks[key];\n    if (maybeTask) {\n      log(`Returning existing ef:${label} task for ${key}`);\n      return await maybeTask;\n    }\n\n    log(`Creating new ef:${label} task for ${key}`);\n    const fullTask = (async (): Promise<TaskResult> => {\n      try {\n        log(`Awaiting task for ${key}`);\n        const result = await runner(absolutePath, ...args);\n\n        if (result instanceof Readable) {\n          log(`Piping task for ${key} to cache`);\n          // Use temporary file to prevent reading incomplete results\n          const tempPath = `${cachePath}.tmp`;\n          const writeStream = createWriteStream(tempPath);\n          result.pipe(writeStream);\n\n          await new Promise<void>((resolve, reject) => {\n            result.on(\"error\", reject);\n            writeStream.on(\"error\", reject);\n            writeStream.on(\"finish\", () => resolve());\n          });\n\n          // Atomically move completed file to final location\n          const { rename } = await import(\"node:fs/promises\");\n          await rename(tempPath, cachePath);\n        } else {\n          log(`Writing to ${cachePath}`);\n          await writeFile(cachePath, result);\n        }\n\n        // Clean up task reference after successful completion\n        delete tasks[key];\n\n        return {\n          md5Sum: md5,\n          cachePath,\n        };\n      } catch (error) {\n        // Clean up task reference on failure\n        delete tasks[key];\n        throw error;\n      }\n    })();\n\n    tasks[key] = fullTask;\n    return await fullTask;\n  };\n};\n"],"mappings":"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"}

package/dist/idempotentTask.d.cts

@@ -0,0 +1,11 @@
+import { Readable } from "node:stream";
+
+//#region src/idempotentTask.d.ts
+
+interface TaskResult {
+  md5Sum: string;
+  cachePath: string;
+}
+//#endregion
+export { TaskResult };
+//# sourceMappingURL=idempotentTask.d.cts.map

package/dist/idempotentTask.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotentTask.js","names":["tasks: Record<string, Promise<TaskResult>>","downloadTasks: Record<string, Promise<string>>","cachePath: string | null","md5: string | null"],"sources":["../src/idempotentTask.ts"],"sourcesContent":["import { createWriteStream, existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { md5FilePath } from \"./md5.js\";\nimport debug from \"debug\";\nimport { mkdir, writeFile, stat, readdir } from \"node:fs/promises\";\nimport { Readable } from \"node:stream\";\n\ninterface TaskOptions<T extends unknown[]> {\n  label: string;\n  filename: (absolutePath: string, ...args: T) => string;\n  runner: (absolutePath: string, ...args: T) => Promise<string | Readable>;\n}\n\nexport interface TaskResult {\n  md5Sum: string;\n  cachePath: string;\n}\n\nexport const idempotentTask = <T extends unknown[]>({\n  label,\n  filename,\n  runner,\n}: TaskOptions<T>) => {\n  const tasks: Record<string, Promise<TaskResult>> = {};\n  const downloadTasks: Record<string, Promise<string>> = {};\n\n  // Helper function to validate cache file completeness\n  const isValidCacheFile = async (\n    filePath: string,\n    allowEmpty = false,\n  ): Promise<boolean> => {\n    try {\n      const stats = await stat(filePath);\n      // File must exist and either have content or be explicitly allowed to be empty\n      return allowEmpty || stats.size > 0;\n    } catch {\n      return false;\n    }\n  };\n\n  return async (\n    rootDir: string,\n    absolutePath: string,\n    ...args: T\n  ): Promise<TaskResult> => {\n    const log = debug(`ef:${label}`);\n    const cacheDirRoot = path.join(rootDir, \".cache\");\n    await mkdir(cacheDirRoot, { recursive: true });\n\n    log(`Running ef:${label} task for ${absolutePath} in ${rootDir}`);\n\n    // Handle HTTP downloads with proper race condition protection\n    if (absolutePath.includes(\"http\")) {\n      const safePath = absolutePath.replace(/[^a-zA-Z0-9]/g, \"_\");\n      const downloadCachePath = path.join(\n        rootDir,\n        \".cache\",\n        `${safePath}.file`,\n      );\n\n      // Check if already downloaded and valid (allow empty downloads)\n      if (\n        existsSync(downloadCachePath) &&\n        (await isValidCacheFile(downloadCachePath, true))\n      ) {\n        log(`Already cached ${absolutePath}`);\n        absolutePath = downloadCachePath;\n      } else {\n        // Use download task deduplication to prevent concurrent downloads\n        const downloadKey = absolutePath;\n        if (!downloadTasks[downloadKey]) {\n          log(`Starting download for ${absolutePath}`);\n          downloadTasks[downloadKey] = (async () => {\n            try {\n              const response = await fetch(absolutePath);\n              if (!response.ok) {\n                throw new Error(\n                  `Failed to fetch file from URL ${absolutePath}: ${response.status} ${response.statusText}`,\n                );\n              }\n\n              const stream = response.body;\n              if (!stream) {\n                throw new Error(`No response body for URL ${absolutePath}`);\n              }\n\n              // Use temporary file to prevent reading incomplete downloads\n              const tempPath = `${downloadCachePath}.tmp`;\n              const writeStream = createWriteStream(tempPath);\n\n              // @ts-ignore node web stream support in typescript is incorrect about this.\n              const readable = Readable.fromWeb(stream);\n              readable.pipe(writeStream);\n\n              await new Promise<void>((resolve, reject) => {\n                readable.on(\"error\", reject);\n                writeStream.on(\"error\", reject);\n                writeStream.on(\"finish\", () => resolve());\n              });\n\n              // Atomically move completed file to final location\n              const { rename } = await import(\"node:fs/promises\");\n              await rename(tempPath, downloadCachePath);\n\n              log(`Download completed for ${absolutePath}`);\n              return downloadCachePath;\n            } catch (error) {\n              log(`Download failed for ${absolutePath}: ${error}`);\n              // Clean up task reference on failure\n              delete downloadTasks[downloadKey];\n              throw error;\n            }\n          })();\n        }\n\n        absolutePath = await downloadTasks[downloadKey];\n        // Clean up completed task\n        delete downloadTasks[downloadKey];\n      }\n    }\n\n    // First, try to find existing cache by scanning cache directories\n    // This avoids expensive MD5 computation when cache already exists\n    const expectedFilename = filename(absolutePath, ...args);\n    let cachePath: string | null = null;\n    let md5: string | null = null;\n    \n    // Scan cache directories to find existing cache file\n    const scanStartTime = Date.now();\n    try {\n      const cacheDirs = await readdir(cacheDirRoot, { withFileTypes: true });\n      log(`Scanning ${cacheDirs.length} cache directories for ${expectedFilename}`);\n      for (const dir of cacheDirs) {\n        if (dir.isDirectory()) {\n          const candidatePath = path.join(cacheDirRoot, dir.name, expectedFilename);\n          if (existsSync(candidatePath) && (await isValidCacheFile(candidatePath))) {\n            cachePath = candidatePath;\n            md5 = dir.name; // Directory name is the MD5\n            const scanElapsed = Date.now() - scanStartTime;\n            log(`Found existing cache in ${scanElapsed}ms: ${candidatePath} (skipped MD5)`);\n            break;\n          }\n        }\n      }\n      if (!cachePath) {\n        const scanElapsed = Date.now() - scanStartTime;\n        log(`Cache scan completed in ${scanElapsed}ms, no cache found - will compute MD5`);\n      }\n    } catch (error) {\n      // If cache directory doesn't exist or can't be read, continue to MD5 computation\n      const scanElapsed = Date.now() - scanStartTime;\n      log(`Cache scan failed after ${scanElapsed}ms, will compute MD5: ${error}`);\n    }\n\n    // Only compute MD5 if we didn't find an existing cache\n    if (!md5) {\n      const md5StartTime = Date.now();\n      log(`Computing MD5 for ${absolutePath}...`);\n      md5 = await md5FilePath(absolutePath);\n      const md5Elapsed = Date.now() - md5StartTime;\n      log(`MD5 computed in ${md5Elapsed}ms: ${md5}`);\n    }\n    \n    const cacheDir = path.join(cacheDirRoot, md5);\n    log(`Cache dir: ${cacheDir}`);\n    await mkdir(cacheDir, { recursive: true });\n\n    if (!cachePath) {\n      cachePath = path.join(cacheDir, expectedFilename);\n    }\n    const key = cachePath;\n\n    // Check if cache exists and is valid (not zero-byte)\n    if (existsSync(cachePath) && (await isValidCacheFile(cachePath))) {\n      log(`Returning cached ef:${label} task for ${key}`);\n      return { cachePath, md5Sum: md5 };\n    }\n\n    const maybeTask = tasks[key];\n    if (maybeTask) {\n      log(`Returning existing ef:${label} task for ${key}`);\n      return await maybeTask;\n    }\n\n    log(`Creating new ef:${label} task for ${key}`);\n    const fullTask = (async (): Promise<TaskResult> => {\n      try {\n        log(`Awaiting task for ${key}`);\n        const result = await runner(absolutePath, ...args);\n\n        if (result instanceof Readable) {\n          log(`Piping task for ${key} to cache`);\n          // Use temporary file to prevent reading incomplete results\n          const tempPath = `${cachePath}.tmp`;\n          const writeStream = createWriteStream(tempPath);\n          result.pipe(writeStream);\n\n          await new Promise<void>((resolve, reject) => {\n            result.on(\"error\", reject);\n            writeStream.on(\"error\", reject);\n            writeStream.on(\"finish\", () => resolve());\n          });\n\n          // Atomically move completed file to final location\n          const { rename } = await import(\"node:fs/promises\");\n          await rename(tempPath, cachePath);\n        } else {\n          log(`Writing to ${cachePath}`);\n          await writeFile(cachePath, result);\n        }\n\n        // Clean up task reference after successful completion\n        delete tasks[key];\n\n        return {\n          md5Sum: md5,\n          cachePath,\n        };\n      } catch (error) {\n        // Clean up task reference on failure\n        delete tasks[key];\n        throw error;\n      }\n    })();\n\n    tasks[key] = fullTask;\n    return await fullTask;\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"idempotentTask.js","names":["tasks: Record<string, Promise<TaskResult>>","downloadTasks: Record<string, Promise<string>>","cachePath: string | null","md5: string | null"],"sources":["../src/idempotentTask.ts"],"sourcesContent":["import { createWriteStream, existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { md5FilePath } from \"./md5.js\";\nimport debug from \"debug\";\nimport { mkdir, writeFile, stat, readdir } from \"node:fs/promises\";\nimport { Readable } from \"node:stream\";\n\ninterface TaskOptions<T extends unknown[]> {\n  label: string;\n  filename: (absolutePath: string, ...args: T) => string;\n  runner: (absolutePath: string, ...args: T) => Promise<string | Readable>;\n}\n\nexport interface TaskResult {\n  md5Sum: string;\n  cachePath: string;\n}\n\nexport const idempotentTask = <T extends unknown[]>({\n  label,\n  filename,\n  runner,\n}: TaskOptions<T>) => {\n  const tasks: Record<string, Promise<TaskResult>> = {};\n  const downloadTasks: Record<string, Promise<string>> = {};\n\n  // Helper function to validate cache file completeness\n  const isValidCacheFile = async (\n    filePath: string,\n    allowEmpty = false,\n  ): Promise<boolean> => {\n    try {\n      const stats = await stat(filePath);\n      // File must exist and either have content or be explicitly allowed to be empty\n      return allowEmpty || stats.size > 0;\n    } catch {\n      return false;\n    }\n  };\n\n  return async (\n    rootDir: string,\n    absolutePath: string,\n    ...args: T\n  ): Promise<TaskResult> => {\n    const log = debug(`ef:${label}`);\n    const cacheDirRoot = path.join(rootDir, \".cache\");\n    await mkdir(cacheDirRoot, { recursive: true });\n\n    log(`Running ef:${label} task for ${absolutePath} in ${rootDir}`);\n\n    // Handle HTTP downloads with proper race condition protection\n    if (absolutePath.includes(\"http\")) {\n      const safePath = absolutePath.replace(/[^a-zA-Z0-9]/g, \"_\");\n      const downloadCachePath = path.join(\n        rootDir,\n        \".cache\",\n        `${safePath}.file`,\n      );\n\n      // Check if already downloaded and valid (allow empty downloads)\n      if (\n        existsSync(downloadCachePath) &&\n        (await isValidCacheFile(downloadCachePath, true))\n      ) {\n        log(`Already cached ${absolutePath}`);\n        absolutePath = downloadCachePath;\n      } else {\n        // Use download task deduplication to prevent concurrent downloads\n        const downloadKey = absolutePath;\n        if (!downloadTasks[downloadKey]) {\n          log(`Starting download for ${absolutePath}`);\n          downloadTasks[downloadKey] = (async () => {\n            try {\n              const response = await fetch(absolutePath);\n              if (!response.ok) {\n                throw new Error(\n                  `Failed to fetch file from URL ${absolutePath}: ${response.status} ${response.statusText}`,\n                );\n              }\n\n              const stream = response.body;\n              if (!stream) {\n                throw new Error(`No response body for URL ${absolutePath}`);\n              }\n\n              // Use temporary file to prevent reading incomplete downloads\n              const tempPath = `${downloadCachePath}.tmp`;\n              const writeStream = createWriteStream(tempPath);\n\n              // @ts-ignore node web stream support in typescript is incorrect about this.\n              const readable = Readable.fromWeb(stream);\n              readable.pipe(writeStream);\n\n              await new Promise<void>((resolve, reject) => {\n                readable.on(\"error\", reject);\n                writeStream.on(\"error\", reject);\n                writeStream.on(\"finish\", () => resolve());\n              });\n\n              // Atomically move completed file to final location\n              const { rename } = await import(\"node:fs/promises\");\n              await rename(tempPath, downloadCachePath);\n\n              log(`Download completed for ${absolutePath}`);\n              return downloadCachePath;\n            } catch (error) {\n              log(`Download failed for ${absolutePath}: ${error}`);\n              // Clean up task reference on failure\n              delete downloadTasks[downloadKey];\n              throw error;\n            }\n          })();\n        }\n\n        absolutePath = await downloadTasks[downloadKey];\n        // Clean up completed task\n        delete downloadTasks[downloadKey];\n      }\n    }\n\n    // First, try to find existing cache by scanning cache directories\n    // This avoids expensive MD5 computation when cache already exists\n    const expectedFilename = filename(absolutePath, ...args);\n    let cachePath: string | null = null;\n    let md5: string | null = null;\n\n    // Scan cache directories to find existing cache file\n    const scanStartTime = Date.now();\n    try {\n      const cacheDirs = await readdir(cacheDirRoot, { withFileTypes: true });\n      log(\n        `Scanning ${cacheDirs.length} cache directories for ${expectedFilename}`,\n      );\n      for (const dir of cacheDirs) {\n        if (dir.isDirectory()) {\n          const candidatePath = path.join(\n            cacheDirRoot,\n            dir.name,\n            expectedFilename,\n          );\n          if (\n            existsSync(candidatePath) &&\n            (await isValidCacheFile(candidatePath))\n          ) {\n            cachePath = candidatePath;\n            md5 = dir.name; // Directory name is the MD5\n            const scanElapsed = Date.now() - scanStartTime;\n            log(\n              `Found existing cache in ${scanElapsed}ms: ${candidatePath} (skipped MD5)`,\n            );\n            break;\n          }\n        }\n      }\n      if (!cachePath) {\n        const scanElapsed = Date.now() - scanStartTime;\n        log(\n          `Cache scan completed in ${scanElapsed}ms, no cache found - will compute MD5`,\n        );\n      }\n    } catch (error) {\n      // If cache directory doesn't exist or can't be read, continue to MD5 computation\n      const scanElapsed = Date.now() - scanStartTime;\n      log(\n        `Cache scan failed after ${scanElapsed}ms, will compute MD5: ${error}`,\n      );\n    }\n\n    // Only compute MD5 if we didn't find an existing cache\n    if (!md5) {\n      const md5StartTime = Date.now();\n      log(`Computing MD5 for ${absolutePath}...`);\n      md5 = await md5FilePath(absolutePath);\n      const md5Elapsed = Date.now() - md5StartTime;\n      log(`MD5 computed in ${md5Elapsed}ms: ${md5}`);\n    }\n\n    const cacheDir = path.join(cacheDirRoot, md5);\n    log(`Cache dir: ${cacheDir}`);\n    await mkdir(cacheDir, { recursive: true });\n\n    if (!cachePath) {\n      cachePath = path.join(cacheDir, expectedFilename);\n    }\n    const key = cachePath;\n\n    // Check if cache exists and is valid (not zero-byte)\n    if (existsSync(cachePath) && (await isValidCacheFile(cachePath))) {\n      log(`Returning cached ef:${label} task for ${key}`);\n      return { cachePath, md5Sum: md5 };\n    }\n\n    const maybeTask = tasks[key];\n    if (maybeTask) {\n      log(`Returning existing ef:${label} task for ${key}`);\n      return await maybeTask;\n    }\n\n    log(`Creating new ef:${label} task for ${key}`);\n    const fullTask = (async (): Promise<TaskResult> => {\n      try {\n        log(`Awaiting task for ${key}`);\n        const result = await runner(absolutePath, ...args);\n\n        if (result instanceof Readable) {\n          log(`Piping task for ${key} to cache`);\n          // Use temporary file to prevent reading incomplete results\n          const tempPath = `${cachePath}.tmp`;\n          const writeStream = createWriteStream(tempPath);\n          result.pipe(writeStream);\n\n          await new Promise<void>((resolve, reject) => {\n            result.on(\"error\", reject);\n            writeStream.on(\"error\", reject);\n            writeStream.on(\"finish\", () => resolve());\n          });\n\n          // Atomically move completed file to final location\n          const { rename } = await import(\"node:fs/promises\");\n          await rename(tempPath, cachePath);\n        } else {\n          log(`Writing to ${cachePath}`);\n          await writeFile(cachePath, result);\n        }\n\n        // Clean up task reference after successful completion\n        delete tasks[key];\n\n        return {\n          md5Sum: md5,\n          cachePath,\n        };\n      } catch (error) {\n        // Clean up task reference on failure\n        delete tasks[key];\n        throw error;\n      }\n    })();\n\n    tasks[key] = fullTask;\n    return await fullTask;\n  };\n};\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,27 @@
+const require_Probe = require('./Probe.cjs');
+const require_generateFragmentIndex = require('./generateFragmentIndex.cjs');
+const require_md5 = require('./md5.cjs');
+const require_generateTrackFragmentIndex = require('./tasks/generateTrackFragmentIndex.cjs');
+const require_generateTrack = require('./tasks/generateTrack.cjs');
+const require_generateScrubTrack = require('./tasks/generateScrubTrack.cjs');
+const require_findOrCreateCaptions = require('./tasks/findOrCreateCaptions.cjs');
+const require_cacheImage = require('./tasks/cacheImage.cjs');
+const require_VideoRenderOptions = require('./VideoRenderOptions.cjs');
+
+exports.PacketProbe = require_Probe.PacketProbe;
+exports.Probe = require_Probe.Probe;
+exports.VideoRenderOptions = require_VideoRenderOptions.VideoRenderOptions;
+exports.cacheImage = require_cacheImage.cacheImage;
+exports.findOrCreateCaptions = require_findOrCreateCaptions.findOrCreateCaptions;
+exports.generateCaptionDataFromPath = require_findOrCreateCaptions.generateCaptionDataFromPath;
+exports.generateFragmentIndex = require_generateFragmentIndex.generateFragmentIndex;
+exports.generateScrubTrack = require_generateScrubTrack.generateScrubTrack;
+exports.generateScrubTrackFromPath = require_generateScrubTrack.generateScrubTrackFromPath;
+exports.generateTrack = require_generateTrack.generateTrack;
+exports.generateTrackFragmentIndex = require_generateTrackFragmentIndex.generateTrackFragmentIndex;
+exports.generateTrackFragmentIndexFromPath = require_generateTrackFragmentIndex.generateTrackFragmentIndexFromPath;
+exports.generateTrackFromPath = require_generateTrack.generateTrackFromPath;
+exports.md5Buffer = require_md5.md5Buffer;
+exports.md5Directory = require_md5.md5Directory;
+exports.md5FilePath = require_md5.md5FilePath;
+exports.md5ReadStream = require_md5.md5ReadStream;

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { AudioStreamSchema, AudioTrackFragmentIndex, PacketProbe, PacketProbeSchema, Probe, ProbeSchema, StreamSchema, TrackFragmentIndex, TrackSegment, VideoStreamSchema, VideoTrackFragmentIndex } from "./Probe.cjs";
+import { generateFragmentIndex } from "./generateFragmentIndex.cjs";
+import { md5Buffer, md5Directory, md5FilePath, md5ReadStream } from "./md5.cjs";
+import { TaskResult } from "./idempotentTask.cjs";
+import { generateTrackFragmentIndex, generateTrackFragmentIndexFromPath } from "./tasks/generateTrackFragmentIndex.cjs";
+import { generateTrack, generateTrackFromPath } from "./tasks/generateTrack.cjs";
+import { generateScrubTrack, generateScrubTrackFromPath } from "./tasks/generateScrubTrack.cjs";
+import { findOrCreateCaptions, generateCaptionDataFromPath } from "./tasks/findOrCreateCaptions.cjs";
+import { cacheImage } from "./tasks/cacheImage.cjs";
+import { VideoRenderOptions } from "./VideoRenderOptions.cjs";
+export { type AudioStreamSchema, type AudioTrackFragmentIndex, PacketProbe, type PacketProbeSchema, Probe, type ProbeSchema, type StreamSchema, type TaskResult, type TrackFragmentIndex, type TrackSegment, VideoRenderOptions, type VideoStreamSchema, type VideoTrackFragmentIndex, cacheImage, findOrCreateCaptions, generateCaptionDataFromPath, generateFragmentIndex, generateScrubTrack, generateScrubTrackFromPath, generateTrack, generateTrackFragmentIndex, generateTrackFragmentIndexFromPath, generateTrackFromPath, md5Buffer, md5Directory, md5FilePath, md5ReadStream };