@meframe/core 0.0.3 → 0.0.5

package/dist/stages/compose/GlobalAudioSession.js

@@ -1,5 +1,6 @@
 import { OfflineAudioMixer } from "./OfflineAudioMixer.js";
 import { MeframeEvent } from "../../event/events.js";
+import { AudioChunkEncoder } from "../encode/AudioChunkEncoder.js";
 class GlobalAudioSession {
   mixWindowUs = 3e6;
   mixer;
@@ -10,8 +11,8 @@ class GlobalAudioSession {
     this.mixer = new OfflineAudioMixer(deps.cacheManager, deps.getModel);
   }
   onAudioData(message) {
-    const { clipId, audioData, clipStartUs, clipDurationUs } = message;
-    this.deps.cacheManager.putClipAudioData(clipId, audioData, clipStartUs, clipDurationUs);
+    const { sessionId, audioData, clipStartUs, clipDurationUs } = message;
+    this.deps.cacheManager.putClipAudioData(sessionId, audioData, clipStartUs, clipDurationUs);
   }
   async ensureMixedPCM(startUs) {
     const model = this.deps.getModel();
@@ -33,6 +34,21 @@ class GlobalAudioSession {
       return null;
     }
   }
+  async prepareAudioForPlayback(startUs) {
+    const buffer = await this.ensureMixedPCM(startUs);
+    if (!buffer) {
+      return null;
+    }
+    const windowStartUs = this.alignToWindow(startUs);
+    const offsetUs = startUs - windowStartUs;
+    const offsetSeconds = offsetUs / 1e6;
+    const durationSeconds = buffer.duration - offsetSeconds;
+    return {
+      buffer,
+      offsetSeconds,
+      durationSeconds
+    };
+  }
   async activateAllAudioClips() {
     const model = this.deps.getModel();
     if (!model) {
@@ -46,7 +62,8 @@ class GlobalAudioSession {
           this.activeClips.add(clip.id);
           await this.deps.resourceLoader.fetch(clip.resourceId, {
             priority: "high",
-            clipId: clip.id
+            sessionId: clip.id,
+            trackId: track.id
           });
           this.deps.eventBus.emit(MeframeEvent.ClipActivated, { clipId: clip.id });
         }
@@ -54,7 +71,7 @@ class GlobalAudioSession {
     }
   }
   handleAudioStream(stream, metadata) {
-    const clipId = metadata.clipId || "unknown";
+    const sessionId = metadata.sessionId || "unknown";
     const clipStartUs = metadata.clipStartUs ?? 0;
     const clipDurationUs = metadata.clipDurationUs ?? 0;
     const reader = stream.getReader();
@@ -66,7 +83,7 @@ class GlobalAudioSession {
           return;
         }
         this.onAudioData({
-          clipId,
+          sessionId,
           audioData: value,
           clipStartUs,
           clipDurationUs
@@ -83,6 +100,133 @@ class GlobalAudioSession {
     this.deps.cacheManager.resetAudioCache();
     this.activeClips.clear();
   }
+  /**
+   * Create export encoded audio stream with metadata callback
+   * Mixes all audio clips and encodes to EncodedAudioChunk for export
+   * Extracts metadata from first chunk and invokes callback
+   */
+  async createExportEncodedStream(config, onFirstMetadata) {
+    const audioDataStream = await this.createExportAudioStream();
+    if (!audioDataStream) {
+      return null;
+    }
+    const encoder = new AudioChunkEncoder(config);
+    await encoder.initialize();
+    const encodingTransform = encoder.createStream();
+    const encodedStream = audioDataStream.pipeThrough(encodingTransform);
+    let firstMetadataExtracted = false;
+    return encodedStream.pipeThrough(
+      new TransformStream({
+        transform(encoderChunk, controller) {
+          if (!firstMetadataExtracted && onFirstMetadata) {
+            onFirstMetadata(encoderChunk.metadata);
+            firstMetadataExtracted = true;
+          }
+          controller.enqueue(encoderChunk.chunk);
+        }
+      })
+    );
+  }
+  /**
+   * Create export audio stream
+   * Mixes all audio clips for the entire composition and outputs AudioData stream
+   */
+  async createExportAudioStream() {
+    const model = this.deps.getModel();
+    if (!model) {
+      return null;
+    }
+    const totalDurationUs = model.durationUs;
+    await this.activateAllAudioClips();
+    await this.waitForAudioClipsReady();
+    return new ReadableStream({
+      start: async (controller) => {
+        const windowSize = 3e6;
+        let currentUs = 0;
+        while (currentUs < totalDurationUs) {
+          const windowEndUs = Math.min(currentUs + windowSize, totalDurationUs);
+          const mixedBuffer = await this.mixer.mix(currentUs, windowEndUs);
+          const audioData = this.audioBufferToAudioData(mixedBuffer, currentUs);
+          if (audioData) {
+            controller.enqueue(audioData);
+          }
+          currentUs = windowEndUs;
+        }
+        controller.close();
+      }
+    });
+  }
+  /**
+   * Wait for audio clips to be decoded and cached
+   */
+  async waitForAudioClipsReady() {
+    const model = this.deps.getModel();
+    if (!model) return;
+    const audioClips = model.tracks.filter((track) => track.kind === "audio").flatMap((track) => track.clips);
+    const waitPromises = audioClips.map(
+      (clip) => this.waitForClipPCM(clip.id, 1e3)
+      // Wait up to 1s per clip
+    );
+    await Promise.allSettled(waitPromises);
+  }
+  /**
+   * Wait for clip PCM data to be available
+   */
+  waitForClipPCM(clipId, timeoutMs) {
+    return new Promise((resolve) => {
+      const checkInterval = 50;
+      let elapsed = 0;
+      const check = () => {
+        if (this.deps.cacheManager.hasClipPCM(clipId)) {
+          resolve(true);
+          return;
+        }
+        elapsed += checkInterval;
+        if (elapsed >= timeoutMs) {
+          resolve(false);
+          return;
+        }
+        setTimeout(check, checkInterval);
+      };
+      check();
+    });
+  }
+  /**
+   * Convert AudioBuffer to AudioData for encoding
+   */
+  audioBufferToAudioData(buffer, timestampUs) {
+    const sampleRate = buffer.sampleRate;
+    const numberOfChannels = buffer.numberOfChannels;
+    const numberOfFrames = buffer.length;
+    const planes = [];
+    for (let channel = 0; channel < numberOfChannels; channel++) {
+      planes.push(buffer.getChannelData(channel));
+    }
+    return new AudioData({
+      format: "f32",
+      // interleaved format
+      sampleRate,
+      numberOfFrames,
+      numberOfChannels,
+      timestamp: timestampUs,
+      data: this.interleavePlanarData(planes)
+    });
+  }
+  /**
+   * Interleave planar audio data for AudioData constructor
+   */
+  interleavePlanarData(planes) {
+    const numberOfChannels = planes.length;
+    const numberOfFrames = planes[0]?.length ?? 0;
+    const totalSamples = numberOfChannels * numberOfFrames;
+    const interleaved = new Float32Array(totalSamples);
+    for (let frame = 0; frame < numberOfFrames; frame++) {
+      for (let channel = 0; channel < numberOfChannels; channel++) {
+        interleaved[frame * numberOfChannels + channel] = planes[channel][frame];
+      }
+    }
+    return interleaved.buffer;
+  }
   async setupAudioPipeline(clip) {
     const { id: clipId, resourceId, startUs, durationUs } = clip;
     const audioDemuxWorker = await this.deps.workers.get("audioDemux", clipId, { lazy: true });

package/dist/stages/compose/GlobalAudioSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalAudioSession.js","sources":["../../../src/stages/compose/GlobalAudioSession.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { OfflineAudioMixer } from './OfflineAudioMixer';\nimport type { CompositionModel, Clip } from '../../model';\nimport type { WorkerPool } from '../../worker/WorkerPool';\nimport type { ResourceLoader } from '../load/ResourceLoader';\nimport type { EventBus } from '../../event/EventBus';\nimport type { EventPayloadMap } from '../../event/events';\nimport { MeframeEvent } from '../../event/events';\nimport type { CacheManager } from '../../cache/CacheManager';\n\ninterface AudioDataMessage {\n  clipId: string;\n  audioData: AudioData;\n  clipStartUs: TimeUs;\n  clipDurationUs: TimeUs;\n}\n\ninterface AudioSessionDeps {\n  cacheManager: CacheManager;\n  workers: WorkerPool;\n  resourceLoader: ResourceLoader;\n  eventBus: EventBus<EventPayloadMap>;\n  getModel: () => CompositionModel | null;\n  buildWorkerConfigs: () => any;\n}\n\nexport class GlobalAudioSession {\n  private mixWindowUs = 3_000_000;\n  private mixer: OfflineAudioMixer;\n  private activeClips = new Set<string>();\n  private deps: AudioSessionDeps;\n\n  constructor(deps: AudioSessionDeps) {\n    this.deps = deps;\n    this.mixer = new OfflineAudioMixer(deps.cacheManager, deps.getModel);\n  }\n\n  onAudioData(message: AudioDataMessage): void {\n    const { clipId, audioData, clipStartUs, clipDurationUs } = message;\n    this.deps.cacheManager.putClipAudioData(clipId, audioData, clipStartUs, clipDurationUs);\n  }\n\n  async ensureMixedPCM(startUs: TimeUs): Promise<AudioBuffer | null> {\n    const model = this.deps.getModel();\n    if (!model) {\n      return null;\n    }\n\n    const windowStartUs = this.alignToWindow(startUs);\n    const windowEndUs = windowStartUs + this.mixWindowUs;\n\n    const cached = this.deps.cacheManager.getMixedAudio(windowStartUs, windowEndUs);\n    if (cached) {\n      return cached;\n    }\n\n    try {\n      const mixedBuffer = await this.mixer.mix(windowStartUs, windowEndUs);\n      this.deps.cacheManager.putMixedAudio(windowStartUs, windowEndUs, mixedBuffer);\n      return mixedBuffer;\n    } catch (error) {\n      console.error('[GlobalAudioSession] Mix failed:', error);\n      return null;\n    }\n  }\n\n  async activateAllAudioClips(): Promise<void> {\n    const model = this.deps.getModel();\n    if (!model) {\n      return;\n    }\n\n    const audioTracks = model.tracks.filter((track) => track.kind === 'audio');\n\n    for (const track of audioTracks) {\n      for (const clip of track.clips) {\n        if (!this.activeClips.has(clip.id)) {\n          await this.setupAudioPipeline(clip);\n          this.activeClips.add(clip.id);\n\n          await this.deps.resourceLoader.fetch(clip.resourceId, {\n            priority: 'high',\n            clipId: clip.id,\n          });\n\n          this.deps.eventBus.emit(MeframeEvent.ClipActivated, { clipId: clip.id });\n        }\n      }\n    }\n  }\n\n  handleAudioStream(stream: ReadableStream<AudioData>, metadata: Record<string, any>): void {\n    const clipId = metadata.clipId || 'unknown';\n    const clipStartUs = metadata.clipStartUs ?? 0;\n    const clipDurationUs = metadata.clipDurationUs ?? 0;\n\n    const reader = stream.getReader();\n    const pump = async (): Promise<void> => {\n      try {\n        const { done, value } = await reader.read();\n        if (done) {\n          reader.releaseLock();\n          return;\n        }\n\n        this.onAudioData({\n          clipId,\n          audioData: value,\n          clipStartUs,\n          clipDurationUs,\n        });\n\n        await pump();\n      } catch (error) {\n        console.error('[GlobalAudioSession] Audio stream error:', error);\n        reader.releaseLock();\n      }\n    };\n\n    pump();\n  }\n\n  reset(): void {\n    this.deps.cacheManager.resetAudioCache();\n    this.activeClips.clear();\n  }\n\n  private async setupAudioPipeline(clip: Clip): Promise<void> {\n    const { id: clipId, resourceId, startUs, durationUs } = clip;\n    const audioDemuxWorker = await this.deps.workers.get('audioDemux', clipId, { lazy: true });\n    const decodeWorker = await this.deps.workers.get('decode');\n\n    const demuxToDecodeChannel = new MessageChannel();\n    await audioDemuxWorker.send(\n      'connect',\n      { direction: 'downstream', port: demuxToDecodeChannel.port1, streamType: 'audio', clipId },\n      { transfer: [demuxToDecodeChannel.port1] }\n    );\n    await decodeWorker.send(\n      'connect',\n      {\n        direction: 'upstream',\n        port: demuxToDecodeChannel.port2,\n        streamType: 'audio',\n        clipId,\n        clipStartUs: startUs || 0,\n        clipDurationUs: durationUs || 0,\n      },\n      { transfer: [demuxToDecodeChannel.port2] }\n    );\n\n    const demuxConfig = this.deps.buildWorkerConfigs().audioDemux;\n    await audioDemuxWorker.send('configure', {\n      initial: true,\n      resourceId,\n      clipId,\n      config: demuxConfig,\n    });\n  }\n\n  private alignToWindow(timeUs: TimeUs): TimeUs {\n    return Math.floor(timeUs / this.mixWindowUs) * this.mixWindowUs;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"GlobalAudioSession.js","sources":["../../../src/stages/compose/GlobalAudioSession.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { OfflineAudioMixer } from './OfflineAudioMixer';\nimport type { CompositionModel, Clip } from '../../model';\nimport type { WorkerPool } from '../../worker/WorkerPool';\nimport type { ResourceLoader } from '../load/ResourceLoader';\nimport type { EventBus } from '../../event/EventBus';\nimport type { EventPayloadMap } from '../../event/events';\nimport { MeframeEvent } from '../../event/events';\nimport type { CacheManager } from '../../cache/CacheManager';\nimport { AudioChunkEncoder } from '../encode/AudioChunkEncoder';\n\ninterface AudioDataMessage {\n  sessionId: string;\n  audioData: AudioData;\n  clipStartUs: TimeUs;\n  clipDurationUs: TimeUs;\n}\n\nexport interface AudioPlaybackInfo {\n  buffer: AudioBuffer;\n  offsetSeconds: number;\n  durationSeconds: number;\n}\n\ninterface AudioSessionDeps {\n  cacheManager: CacheManager;\n  workers: WorkerPool;\n  resourceLoader: ResourceLoader;\n  eventBus: EventBus<EventPayloadMap>;\n  getModel: () => CompositionModel | null;\n  buildWorkerConfigs: () => any;\n}\n\nexport class GlobalAudioSession {\n  private mixWindowUs = 3_000_000;\n  private mixer: OfflineAudioMixer;\n  private activeClips = new Set<string>();\n  private deps: AudioSessionDeps;\n\n  constructor(deps: AudioSessionDeps) {\n    this.deps = deps;\n    this.mixer = new OfflineAudioMixer(deps.cacheManager, deps.getModel);\n  }\n\n  onAudioData(message: AudioDataMessage): void {\n    const { sessionId, audioData, clipStartUs, clipDurationUs } = message;\n    this.deps.cacheManager.putClipAudioData(sessionId, audioData, clipStartUs, clipDurationUs);\n  }\n\n  async ensureMixedPCM(startUs: TimeUs): Promise<AudioBuffer | null> {\n    const model = this.deps.getModel();\n    if (!model) {\n      return null;\n    }\n\n    const windowStartUs = this.alignToWindow(startUs);\n    const windowEndUs = windowStartUs + this.mixWindowUs;\n\n    const cached = this.deps.cacheManager.getMixedAudio(windowStartUs, windowEndUs);\n    if (cached) {\n      return cached;\n    }\n\n    try {\n      const mixedBuffer = await this.mixer.mix(windowStartUs, windowEndUs);\n      this.deps.cacheManager.putMixedAudio(windowStartUs, windowEndUs, mixedBuffer);\n      return mixedBuffer;\n    } catch (error) {\n      console.error('[GlobalAudioSession] Mix failed:', error);\n      return null;\n    }\n  }\n\n  async prepareAudioForPlayback(startUs: TimeUs): Promise<AudioPlaybackInfo | null> {\n    const buffer = await this.ensureMixedPCM(startUs);\n    if (!buffer) {\n      return null;\n    }\n\n    const windowStartUs = this.alignToWindow(startUs);\n    const offsetUs = startUs - windowStartUs;\n    const offsetSeconds = offsetUs / 1_000_000;\n    const durationSeconds = buffer.duration - offsetSeconds;\n\n    return {\n      buffer,\n      offsetSeconds,\n      durationSeconds,\n    };\n  }\n\n  async activateAllAudioClips(): Promise<void> {\n    const model = this.deps.getModel();\n    if (!model) {\n      return;\n    }\n\n    const audioTracks = model.tracks.filter((track) => track.kind === 'audio');\n\n    for (const track of audioTracks) {\n      for (const clip of track.clips) {\n        if (!this.activeClips.has(clip.id)) {\n          await this.setupAudioPipeline(clip);\n          this.activeClips.add(clip.id);\n\n          await this.deps.resourceLoader.fetch(clip.resourceId, {\n            priority: 'high',\n            sessionId: clip.id,\n            trackId: track.id,\n          });\n\n          this.deps.eventBus.emit(MeframeEvent.ClipActivated, { clipId: clip.id });\n        }\n      }\n    }\n  }\n\n  handleAudioStream(stream: ReadableStream<AudioData>, metadata: Record<string, any>): void {\n    const sessionId = metadata.sessionId || 'unknown';\n    const clipStartUs = metadata.clipStartUs ?? 0;\n    const clipDurationUs = metadata.clipDurationUs ?? 0;\n\n    const reader = stream.getReader();\n    const pump = async (): Promise<void> => {\n      try {\n        const { done, value } = await reader.read();\n        if (done) {\n          reader.releaseLock();\n          return;\n        }\n\n        this.onAudioData({\n          sessionId,\n          audioData: value,\n          clipStartUs,\n          clipDurationUs,\n        });\n\n        await pump();\n      } catch (error) {\n        console.error('[GlobalAudioSession] Audio stream error:', error);\n        reader.releaseLock();\n      }\n    };\n\n    pump();\n  }\n\n  reset(): void {\n    this.deps.cacheManager.resetAudioCache();\n    this.activeClips.clear();\n  }\n\n  /**\n   * Create export encoded audio stream with metadata callback\n   * Mixes all audio clips and encodes to EncodedAudioChunk for export\n   * Extracts metadata from first chunk and invokes callback\n   */\n  async createExportEncodedStream(\n    config?: Partial<AudioEncoderConfig>,\n    onFirstMetadata?: (metadata: EncodedAudioChunkMetadata) => void\n  ): Promise<ReadableStream<EncodedAudioChunk> | null> {\n    const audioDataStream = await this.createExportAudioStream();\n    if (!audioDataStream) {\n      return null;\n    }\n\n    const encoder = new AudioChunkEncoder(config);\n    await encoder.initialize();\n\n    const encodingTransform = encoder.createStream();\n    const encodedStream = audioDataStream.pipeThrough(encodingTransform);\n\n    let firstMetadataExtracted = false;\n\n    // Extract chunk from EncoderChunk and capture first metadata\n    return encodedStream.pipeThrough(\n      new TransformStream({\n        transform(encoderChunk, controller) {\n          // Extract metadata from first chunk\n          if (!firstMetadataExtracted && onFirstMetadata) {\n            onFirstMetadata(encoderChunk.metadata as EncodedAudioChunkMetadata);\n            firstMetadataExtracted = true;\n          }\n          controller.enqueue(encoderChunk.chunk as EncodedAudioChunk);\n        },\n      })\n    );\n  }\n\n  /**\n   * Create export audio stream\n   * Mixes all audio clips for the entire composition and outputs AudioData stream\n   */\n  async createExportAudioStream(): Promise<ReadableStream<AudioData> | null> {\n    const model = this.deps.getModel();\n    if (!model) {\n      return null;\n    }\n\n    const totalDurationUs = model.durationUs;\n\n    // Ensure all audio clips are active and cached\n    await this.activateAllAudioClips();\n\n    // Wait for PCM data to be available\n    await this.waitForAudioClipsReady();\n\n    return new ReadableStream<AudioData>({\n      start: async (controller) => {\n        const windowSize = 3_000_000; // 3 seconds per chunk\n        let currentUs = 0;\n\n        while (currentUs < totalDurationUs) {\n          const windowEndUs = Math.min(currentUs + windowSize, totalDurationUs);\n\n          // Mix this window\n          const mixedBuffer = await this.mixer.mix(currentUs, windowEndUs);\n\n          // Convert AudioBuffer to AudioData\n          const audioData = this.audioBufferToAudioData(mixedBuffer, currentUs);\n          if (audioData) {\n            controller.enqueue(audioData);\n          }\n\n          currentUs = windowEndUs;\n        }\n\n        controller.close();\n      },\n    });\n  }\n\n  /**\n   * Wait for audio clips to be decoded and cached\n   */\n  private async waitForAudioClipsReady(): Promise<void> {\n    const model = this.deps.getModel();\n    if (!model) return;\n\n    const audioClips = model.tracks\n      .filter((track) => track.kind === 'audio')\n      .flatMap((track) => track.clips);\n\n    // Wait for each clip to have PCM data\n    const waitPromises = audioClips.map(\n      (clip) => this.waitForClipPCM(clip.id, 1000) // Wait up to 1s per clip\n    );\n\n    await Promise.allSettled(waitPromises);\n  }\n\n  /**\n   * Wait for clip PCM data to be available\n   */\n  private waitForClipPCM(clipId: string, timeoutMs: number): Promise<boolean> {\n    return new Promise((resolve) => {\n      const checkInterval = 50;\n      let elapsed = 0;\n\n      const check = () => {\n        if (this.deps.cacheManager.hasClipPCM(clipId)) {\n          resolve(true);\n          return;\n        }\n\n        elapsed += checkInterval;\n        if (elapsed >= timeoutMs) {\n          resolve(false);\n          return;\n        }\n\n        setTimeout(check, checkInterval);\n      };\n\n      check();\n    });\n  }\n\n  /**\n   * Convert AudioBuffer to AudioData for encoding\n   */\n  private audioBufferToAudioData(buffer: AudioBuffer, timestampUs: TimeUs): AudioData | null {\n    const sampleRate = buffer.sampleRate;\n    const numberOfChannels = buffer.numberOfChannels;\n    const numberOfFrames = buffer.length;\n\n    // Interleave channels into planar format\n    const planes: Float32Array[] = [];\n    for (let channel = 0; channel < numberOfChannels; channel++) {\n      planes.push(buffer.getChannelData(channel));\n    }\n\n    return new AudioData({\n      format: 'f32', // interleaved format\n      sampleRate,\n      numberOfFrames,\n      numberOfChannels,\n      timestamp: timestampUs,\n      data: this.interleavePlanarData(planes),\n    });\n  }\n\n  /**\n   * Interleave planar audio data for AudioData constructor\n   */\n  private interleavePlanarData(planes: Float32Array[]): ArrayBuffer {\n    const numberOfChannels = planes.length;\n    const numberOfFrames = planes[0]?.length ?? 0;\n    const totalSamples = numberOfChannels * numberOfFrames;\n\n    const interleaved = new Float32Array(totalSamples);\n\n    for (let frame = 0; frame < numberOfFrames; frame++) {\n      for (let channel = 0; channel < numberOfChannels; channel++) {\n        interleaved[frame * numberOfChannels + channel] = planes[channel]![frame]!;\n      }\n    }\n\n    return interleaved.buffer;\n  }\n\n  private async setupAudioPipeline(clip: Clip): Promise<void> {\n    const { id: clipId, resourceId, startUs, durationUs } = clip;\n    const audioDemuxWorker = await this.deps.workers.get('audioDemux', clipId, { lazy: true });\n    const decodeWorker = await this.deps.workers.get('decode');\n\n    const demuxToDecodeChannel = new MessageChannel();\n    await audioDemuxWorker.send(\n      'connect',\n      { direction: 'downstream', port: demuxToDecodeChannel.port1, streamType: 'audio', clipId },\n      { transfer: [demuxToDecodeChannel.port1] }\n    );\n    await decodeWorker.send(\n      'connect',\n      {\n        direction: 'upstream',\n        port: demuxToDecodeChannel.port2,\n        streamType: 'audio',\n        clipId,\n        clipStartUs: startUs || 0,\n        clipDurationUs: durationUs || 0,\n      },\n      { transfer: [demuxToDecodeChannel.port2] }\n    );\n\n    const demuxConfig = this.deps.buildWorkerConfigs().audioDemux;\n    await audioDemuxWorker.send('configure', {\n      initial: true,\n      resourceId,\n      clipId,\n      config: demuxConfig,\n    });\n  }\n\n  private alignToWindow(timeUs: TimeUs): TimeUs {\n    return Math.floor(timeUs / this.mixWindowUs) * this.mixWindowUs;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/compose/VideoComposer.d.ts

@@ -4,6 +4,7 @@ import { ClipInstructionSet } from './instructions';
 interface ComposeStreams {
     composeStream: WritableStream<ComposeRequest>;
     cacheStream: ReadableStream<VideoFrame>;
+    encodeStream: ReadableStream<VideoFrame>;
 }
 /**
  * VideoComposer - Main visual composition orchestrator

package/dist/stages/compose/VideoComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoComposer.d.ts","sourceRoot":"","sources":["../../../src/stages/compose/VideoComposer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,UAAU,cAAc;IACtB,aAAa,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,WAAW,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,MAAM,EAAE,kBAAkB;IAyBtC,OAAO,CAAC,aAAa;IAuBrB,aAAa,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,cAAc;IAoC1D,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkE7D,iBAAiB,CACrB,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAWzB,OAAO,CAAC,WAAW;YAaL,iBAAiB;IAW/B,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAmBvD,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"VideoComposer.d.ts","sourceRoot":"","sources":["../../../src/stages/compose/VideoComposer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,UAAU,cAAc;IACtB,aAAa,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,WAAW,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACxC,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,MAAM,EAAE,kBAAkB;IAyBtC,OAAO,CAAC,aAAa;IAuBrB,aAAa,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,cAAc;IAqC1D,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkE7D,iBAAiB,CACrB,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAWzB,OAAO,CAAC,WAAW;YAaL,iBAAiB;IAW/B,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAmBvD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/stages/demux/MP4Demuxer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MP4Demuxer.d.ts","sourceRoot":"","sources":["../../../src/stages/demux/MP4Demuxer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAM;IACxB,MAAM,yBAAgC;IACtC,OAAO,UAAS;IAChB,OAAO,CAAC,eAAe,CAAC,CAAsD;IAC9E,OAAO,CAAC,eAAe,CAAC,CAAsD;IAC9E,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,MAAM,GAAE,WAAW,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAW/D,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIvC,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,cAAc;IAmDtB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,iBAAiB,IAAI,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAgCnE;;OAEG;IACH,iBAAiB,IAAI,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,GAAG,IAAI;IA6B1E,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOrC;;OAEG;IACH,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,CAE1C;IAED,OAAO,IAAI,IAAI;CAQhB"}
+{"version":3,"file":"MP4Demuxer.d.ts","sourceRoot":"","sources":["../../../src/stages/demux/MP4Demuxer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAM;IACxB,MAAM,yBAAgC;IACtC,OAAO,UAAS;IAChB,OAAO,CAAC,eAAe,CAAC,CAAsD;IAC9E,OAAO,CAAC,eAAe,CAAC,CAAsD;IAC9E,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,MAAM,GAAE,WAAW,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAW/D,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIvC,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,cAAc;IAmDtB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,iBAAiB,IAAI,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAgCnE;;OAEG;IACH,iBAAiB,IAAI,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,GAAG,IAAI;IA6B1E,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOrC;;OAEG;IACH,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,CAE1C;IAED,OAAO,IAAI,IAAI;CAQhB"}

package/dist/stages/encode/AudioChunkEncoder.d.ts

@@ -8,9 +8,10 @@ import { AudioEncoderConfig } from './types';
 export declare class AudioChunkEncoder extends BaseEncoder<AudioEncoder, AudioEncoderConfig, AudioData, EncodedAudioChunk, EncodedAudioChunkMetadata> {
     private static readonly DEFAULT_HIGH_WATER_MARK;
     private static readonly DEFAULT_ENCODE_QUEUE_THRESHOLD;
+    static readonly DEFAULT_CONFIG: AudioEncoderConfig;
     protected readonly highWaterMark: number;
     protected readonly encodeQueueThreshold: number;
-    constructor(config: AudioEncoderConfig);
+    constructor(config?: Partial<AudioEncoderConfig>);
     protected isConfigSupported(config: AudioEncoderConfig): Promise<{
         supported: boolean;
     }>;

package/dist/stages/encode/AudioChunkEncoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioChunkEncoder.d.ts","sourceRoot":"","sources":["../../../src/stages/encode/AudioChunkEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,WAAW,CAChD,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,yBAAyB,CAC1B;IACC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAK;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAM;IAE5D,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;gBAEpC,MAAM,EAAE,kBAAkB;cAUtB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAK9F,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY;IAI7D,SAAS,CAAC,cAAc,IAAI,MAAM;IAIlC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAiB9B"}
+{"version":3,"file":"AudioChunkEncoder.d.ts","sourceRoot":"","sources":["../../../src/stages/encode/AudioChunkEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,WAAW,CAChD,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,yBAAyB,CAC1B;IACC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAK;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAM;IAE5D,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAKhD;IAEF,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;gBAEpC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;cAYhC,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAK9F,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY;IAI7D,SAAS,CAAC,cAAc,IAAI,MAAM;IAIlC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAQ9B"}

package/dist/stages/encode/AudioChunkEncoder.js

@@ -0,0 +1,41 @@
+import { BaseEncoder } from "./BaseEncoder.js";
+class AudioChunkEncoder extends BaseEncoder {
+  static DEFAULT_HIGH_WATER_MARK = 4;
+  static DEFAULT_ENCODE_QUEUE_THRESHOLD = 16;
+  static DEFAULT_CONFIG = {
+    codec: "mp4a.40.2",
+    // AAC-LC
+    sampleRate: 48e3,
+    numberOfChannels: 2,
+    bitrate: 128e3
+  };
+  highWaterMark;
+  encodeQueueThreshold;
+  constructor(config) {
+    const fullConfig = { ...AudioChunkEncoder.DEFAULT_CONFIG, ...config };
+    super(fullConfig);
+    this.highWaterMark = fullConfig.backpressure?.highWaterMark ?? AudioChunkEncoder.DEFAULT_HIGH_WATER_MARK;
+    this.encodeQueueThreshold = fullConfig.backpressure?.encodeQueueThreshold ?? AudioChunkEncoder.DEFAULT_ENCODE_QUEUE_THRESHOLD;
+  }
+  async isConfigSupported(config) {
+    const result = await AudioEncoder.isConfigSupported(config);
+    return { supported: result.supported ?? false };
+  }
+  createEncoder(init) {
+    return new AudioEncoder(init);
+  }
+  getEncoderType() {
+    return "Audio";
+  }
+  encode(data) {
+    if (this.encoder?.state !== "configured") {
+      throw new Error("Audio encoder not configured");
+    }
+    this.encoder.encode(data);
+    data.close();
+  }
+}
+export {
+  AudioChunkEncoder
+};
+//# sourceMappingURL=AudioChunkEncoder.js.map

package/dist/stages/encode/AudioChunkEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioChunkEncoder.js","sources":["../../../src/stages/encode/AudioChunkEncoder.ts"],"sourcesContent":["import { BaseEncoder } from './BaseEncoder';\nimport type { AudioEncoderConfig } from './types';\n\n/**\n * AudioChunkEncoder - Encodes AudioData to EncodedAudioChunk\n * Stream-based encoder with backpressure handling\n */\nexport class AudioChunkEncoder extends BaseEncoder<\n  AudioEncoder,\n  AudioEncoderConfig,\n  AudioData,\n  EncodedAudioChunk,\n  EncodedAudioChunkMetadata\n> {\n  private static readonly DEFAULT_HIGH_WATER_MARK = 4;\n  private static readonly DEFAULT_ENCODE_QUEUE_THRESHOLD = 16;\n\n  static readonly DEFAULT_CONFIG: AudioEncoderConfig = {\n    codec: 'mp4a.40.2', // AAC-LC\n    sampleRate: 48000,\n    numberOfChannels: 2,\n    bitrate: 128000,\n  };\n\n  protected readonly highWaterMark: number;\n  protected readonly encodeQueueThreshold: number;\n\n  constructor(config?: Partial<AudioEncoderConfig>) {\n    const fullConfig = { ...AudioChunkEncoder.DEFAULT_CONFIG, ...config };\n    super(fullConfig);\n\n    // Initialize backpressure settings from config or use defaults\n    this.highWaterMark =\n      fullConfig.backpressure?.highWaterMark ?? AudioChunkEncoder.DEFAULT_HIGH_WATER_MARK;\n    this.encodeQueueThreshold =\n      fullConfig.backpressure?.encodeQueueThreshold ??\n      AudioChunkEncoder.DEFAULT_ENCODE_QUEUE_THRESHOLD;\n  }\n\n  protected async isConfigSupported(config: AudioEncoderConfig): Promise<{ supported: boolean }> {\n    const result = await AudioEncoder.isConfigSupported(config);\n    return { supported: result.supported ?? false };\n  }\n\n  protected createEncoder(init: AudioEncoderInit): AudioEncoder {\n    return new AudioEncoder(init);\n  }\n\n  protected getEncoderType(): string {\n    return 'Audio';\n  }\n\n  encode(data: AudioData): void {\n    if (this.encoder?.state !== 'configured') {\n      throw new Error('Audio encoder not configured');\n    }\n\n    this.encoder.encode(data);\n    data.close();\n  }\n}\n"],"names":[],"mappings":";AAOO,MAAM,0BAA0B,YAMrC;AAAA,EACA,OAAwB,0BAA0B;AAAA,EAClD,OAAwB,iCAAiC;AAAA,EAEzD,OAAgB,iBAAqC;AAAA,IACnD,OAAO;AAAA;AAAA,IACP,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,SAAS;AAAA,EAAA;AAAA,EAGQ;AAAA,EACA;AAAA,EAEnB,YAAY,QAAsC;AAChD,UAAM,aAAa,EAAE,GAAG,kBAAkB,gBAAgB,GAAG,OAAA;AAC7D,UAAM,UAAU;AAGhB,SAAK,gBACH,WAAW,cAAc,iBAAiB,kBAAkB;AAC9D,SAAK,uBACH,WAAW,cAAc,wBACzB,kBAAkB;AAAA,EACtB;AAAA,EAEA,MAAgB,kBAAkB,QAA6D;AAC7F,UAAM,SAAS,MAAM,aAAa,kBAAkB,MAAM;AAC1D,WAAO,EAAE,WAAW,OAAO,aAAa,MAAA;AAAA,EAC1C;AAAA,EAEU,cAAc,MAAsC;AAC5D,WAAO,IAAI,aAAa,IAAI;AAAA,EAC9B;AAAA,EAEU,iBAAyB;AACjC,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAuB;AAC5B,QAAI,KAAK,SAAS,UAAU,cAAc;AACxC,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAEA,SAAK,QAAQ,OAAO,IAAI;AACxB,SAAK,MAAA;AAAA,EACP;AACF;"}

package/dist/stages/encode/BaseEncoder.d.ts

@@ -2,10 +2,14 @@
  * Base encoder class for both video and audio encoding
  * Handles common WebCodecs encoder operations
  */
+export interface EncoderChunk {
+    chunk: EncodedVideoChunk;
+    metadata: EncodedVideoChunkMetadata;
+}
 export declare abstract class BaseEncoder<TEncoder extends VideoEncoder | AudioEncoder, TConfig extends VideoEncoderConfig | AudioEncoderConfig, TInput extends VideoFrame | AudioData, TChunk extends EncodedVideoChunk | EncodedAudioChunk, TMetadata extends EncodedVideoChunkMetadata | EncodedAudioChunkMetadata> {
     protected encoder?: TEncoder;
     protected config: TConfig;
-    protected controller: TransformStreamDefaultController<TChunk> | null;
+    protected controller: TransformStreamDefaultController<EncoderChunk> | null;
     constructor(config: TConfig);
     getConfig(): TConfig;
     protected get currentConfig(): TConfig;
@@ -19,7 +23,7 @@ export declare abstract class BaseEncoder<TEncoder extends VideoEncoder | AudioE
     close(): Promise<void>;
     get isReady(): boolean;
     get queueSize(): number;
-    protected handleOutput(chunk: TChunk, _metadata: TMetadata): void;
+    protected handleOutput(chunk: TChunk, metadata: TMetadata): void;
     protected handleError(error: DOMException): void;
     protected abstract isConfigSupported(config: TConfig): Promise<{
         supported: boolean;
@@ -33,7 +37,7 @@ export declare abstract class BaseEncoder<TEncoder extends VideoEncoder | AudioE
      * Create transform stream for encoding
      * Implements common stream logic with backpressure handling
      */
-    createStream(): TransformStream<TInput, TChunk>;
+    createStream(): TransformStream<TInput, EncoderChunk>;
     abstract encode(input: TInput): void;
 }
 interface EncoderInit {

package/dist/stages/encode/BaseEncoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseEncoder.d.ts","sourceRoot":"","sources":["../../../src/stages/encode/BaseEncoder.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,EACvD,MAAM,SAAS,UAAU,GAAG,SAAS,EACrC,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,EACpD,SAAS,SAAS,yBAAyB,GAAG,yBAAyB;IAEvE,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC7B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,UAAU,EAAE,gCAAgC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAQ;gBAEjE,MAAM,EAAE,OAAO;IAI3B,SAAS,IAAI,OAAO;IAIpB,SAAS,KAAK,aAAa,IAAI,OAAO,CAErC;IAED,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;IAW/D,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAiBlD,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAIjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAKjE,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMhD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACtF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ;IAC7D,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,MAAM;IAG3C,SAAS,CAAC,OAAO,IAAI,IAAI;IAKzB,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAClD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAEzD;;;OAGG;IACH,YAAY,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC;IAiD/C,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CACrC;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACtC"}
+{"version":3,"file":"BaseEncoder.d.ts","sourceRoot":"","sources":["../../../src/stages/encode/BaseEncoder.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,EACvD,MAAM,SAAS,UAAU,GAAG,SAAS,EACrC,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,EACpD,SAAS,SAAS,yBAAyB,GAAG,yBAAyB;IAEvE,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC7B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,UAAU,EAAE,gCAAgC,CAAC,YAAY,CAAC,GAAG,IAAI,CAAQ;gBAEvE,MAAM,EAAE,OAAO;IAI3B,SAAS,IAAI,OAAO;IAIpB,SAAS,KAAK,aAAa,IAAI,OAAO,CAErC;IAED,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;IAW/D,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAiBlD,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAIjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI;IAchE,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMhD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACtF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ;IAC7D,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,MAAM;IAG3C,SAAS,CAAC,OAAO,IAAI,IAAI;IAKzB,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAClD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAEzD;;;OAGG;IACH,YAAY,IAAI,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC;IAkDrD,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CACrC;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACtC"}

package/dist/stages/encode/BaseEncoder.js

@@ -0,0 +1,173 @@
+class BaseEncoder {
+  encoder;
+  config;
+  controller = null;
+  constructor(config) {
+    this.config = config;
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  get currentConfig() {
+    return this.config;
+  }
+  shouldReconfigure(partial) {
+    const next = { ...this.config, ...partial };
+    const keys = Object.keys(partial ?? {});
+    for (const key of keys) {
+      if (partial[key] !== void 0 && next[key] !== this.config[key]) {
+        return true;
+      }
+    }
+    return false;
+  }
+  hasConfigChanged(next) {
+    const currentEntries = Object.entries(this.config);
+    for (const [key, value] of currentEntries) {
+      if (next[key] !== value) {
+        return true;
+      }
+    }
+    for (const key of Object.keys(next)) {
+      if (this.config[key] !== next[key]) {
+        return true;
+      }
+    }
+    return false;
+  }
+  configsEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+  }
+  async initialize() {
+    if (this.encoder?.state === "configured") {
+      return;
+    }
+    const isSupported = await this.isConfigSupported(this.config);
+    if (!isSupported.supported) {
+      throw new Error(`Codec not supported: ${this.config.codec}`);
+    }
+    this.encoder = this.createEncoder({
+      output: this.handleOutput.bind(this),
+      error: this.handleError.bind(this)
+    });
+    this.encoder.configure(this.config);
+  }
+  async reconfigure(config) {
+    if (!config || Object.keys(config).length === 0) {
+      return;
+    }
+    const nextConfig = { ...this.config, ...config };
+    if (this.configsEqual(this.config, nextConfig)) {
+      return;
+    }
+    if (!this.encoder) {
+      this.config = nextConfig;
+      await this.initialize();
+      return;
+    }
+    if (this.encoder.state === "configured") {
+      await this.encoder.flush();
+    }
+    const isSupported = await this.isConfigSupported(nextConfig);
+    if (!isSupported.supported) {
+      throw new Error(`New configuration not supported: ${nextConfig.codec}`);
+    }
+    this.config = nextConfig;
+    this.encoder.configure(this.config);
+  }
+  async flush() {
+    if (!this.encoder) {
+      return;
+    }
+    await this.encoder.flush();
+  }
+  async reset() {
+    if (!this.encoder) {
+      return;
+    }
+    this.encoder.reset();
+    this.onReset();
+  }
+  async close() {
+    if (!this.encoder) {
+      return;
+    }
+    if (this.encoder.state === "configured") {
+      await this.encoder.flush();
+    }
+    this.encoder.close();
+    this.encoder = void 0;
+  }
+  get isReady() {
+    return this.encoder?.state === "configured";
+  }
+  get queueSize() {
+    return this.encoder?.encodeQueueSize ?? 0;
+  }
+  handleOutput(chunk, metadata) {
+    if (this.controller) {
+      try {
+        this.controller.enqueue({ chunk, metadata });
+      } catch (error) {
+        if (!(error instanceof TypeError && error.message.includes("closed"))) {
+          throw error;
+        }
+      }
+    }
+  }
+  handleError(error) {
+    console.error(`${this.getEncoderType()} encoder error:`, error);
+    this.controller?.error(error);
+  }
+  // Hook for subclasses to handle reset
+  onReset() {
+  }
+  /**
+   * Create transform stream for encoding
+   * Implements common stream logic with backpressure handling
+   */
+  createStream() {
+    return new TransformStream(
+      {
+        start: async (controller) => {
+          this.controller = controller;
+          if (!this.isReady) {
+            await this.initialize();
+          }
+        },
+        transform: async (input) => {
+          if (!this.encoder || this.encoder.state !== "configured") {
+            throw new Error("Encoder not configured");
+          }
+          if (this.encoder.encodeQueueSize >= this.encodeQueueThreshold) {
+            await new Promise((resolve) => {
+              const check = () => {
+                if (!this.encoder || this.encoder.encodeQueueSize < this.encodeQueueThreshold - 1) {
+                  resolve();
+                } else {
+                  setTimeout(check, 10);
+                }
+              };
+              check();
+            });
+          }
+          const frame = input.frame || input;
+          this.encode(frame);
+        },
+        flush: async () => {
+          await this.flush();
+        }
+      },
+      // Queuing strategy with backpressure configuration
+      {
+        highWaterMark: this.highWaterMark,
+        size: () => 1
+        // Count-based
+      }
+    );
+  }
+}
+export {
+  BaseEncoder
+};
+//# sourceMappingURL=BaseEncoder.js.map

package/dist/stages/encode/BaseEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseEncoder.js","sources":["../../../src/stages/encode/BaseEncoder.ts"],"sourcesContent":["// Base encoder implementation\n\n/**\n * Base encoder class for both video and audio encoding\n * Handles common WebCodecs encoder operations\n */\n\nexport interface EncoderChunk {\n  chunk: EncodedVideoChunk;\n  metadata: EncodedVideoChunkMetadata;\n}\n\nexport abstract class BaseEncoder<\n  TEncoder extends VideoEncoder | AudioEncoder,\n  TConfig extends VideoEncoderConfig | AudioEncoderConfig,\n  TInput extends VideoFrame | AudioData,\n  TChunk extends EncodedVideoChunk | EncodedAudioChunk,\n  TMetadata extends EncodedVideoChunkMetadata | EncodedAudioChunkMetadata,\n> {\n  protected encoder?: TEncoder;\n  protected config: TConfig;\n  protected controller: TransformStreamDefaultController<EncoderChunk> | null = null;\n\n  constructor(config: TConfig) {\n    this.config = config;\n  }\n\n  getConfig(): TConfig {\n    return { ...this.config };\n  }\n\n  protected get currentConfig(): TConfig {\n    return this.config;\n  }\n\n  protected shouldReconfigure(partial: Partial<TConfig>): boolean {\n    const next = { ...this.config, ...partial } as TConfig;\n    const keys = Object.keys(partial ?? {}) as Array<keyof TConfig>;\n    for (const key of keys) {\n      if (partial[key] !== undefined && next[key] !== this.config[key]) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  protected hasConfigChanged(next: TConfig): boolean {\n    const currentEntries = Object.entries(this.config) as Array<[keyof TConfig, any]>;\n    for (const [key, value] of currentEntries) {\n      if (next[key] !== value) {\n        return true;\n      }\n    }\n\n    for (const key of Object.keys(next) as Array<keyof TConfig>) {\n      if (this.config[key] !== next[key]) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  protected configsEqual(a: TConfig, b: TConfig): boolean {\n    return JSON.stringify(a) === JSON.stringify(b);\n  }\n\n  async initialize(): Promise<void> {\n    if (this.encoder?.state === 'configured') {\n      return;\n    }\n\n    const isSupported = await this.isConfigSupported(this.config);\n    if (!isSupported.supported) {\n      throw new Error(`Codec not supported: ${this.config.codec}`);\n    }\n\n    this.encoder = this.createEncoder({\n      output: this.handleOutput.bind(this),\n      error: this.handleError.bind(this),\n    });\n\n    (this.encoder as any).configure(this.config);\n  }\n\n  async reconfigure(config: Partial<TConfig>): Promise<void> {\n    if (!config || Object.keys(config).length === 0) {\n      return;\n    }\n\n    const nextConfig = { ...this.config, ...config } as TConfig;\n\n    if (this.configsEqual(this.config, nextConfig)) {\n      return;\n    }\n\n    if (!this.encoder) {\n      this.config = nextConfig;\n      await this.initialize();\n      return;\n    }\n\n    if (this.encoder.state === 'configured') {\n      await this.encoder.flush();\n    }\n\n    const isSupported = await this.isConfigSupported(nextConfig);\n    if (!isSupported.supported) {\n      throw new Error(`New configuration not supported: ${nextConfig.codec}`);\n    }\n\n    this.config = nextConfig;\n    (this.encoder as any).configure(this.config);\n  }\n\n  async flush(): Promise<void> {\n    if (!this.encoder) {\n      return;\n    }\n\n    await this.encoder.flush();\n  }\n\n  async reset(): Promise<void> {\n    if (!this.encoder) {\n      return;\n    }\n\n    this.encoder.reset();\n    this.onReset();\n  }\n\n  async close(): Promise<void> {\n    if (!this.encoder) {\n      return;\n    }\n\n    if (this.encoder.state === 'configured') {\n      await this.encoder.flush();\n    }\n\n    this.encoder.close();\n    this.encoder = undefined;\n  }\n\n  get isReady(): boolean {\n    return this.encoder?.state === 'configured';\n  }\n\n  get queueSize(): number {\n    return this.encoder?.encodeQueueSize ?? 0;\n  }\n\n  protected handleOutput(chunk: TChunk, metadata: TMetadata): void {\n    // Only enqueue if controller exists and stream is not closed\n    if (this.controller) {\n      try {\n        this.controller.enqueue({ chunk, metadata });\n      } catch (error) {\n        // Stream may be closed during flush, ignore enqueue errors\n        if (!(error instanceof TypeError && error.message.includes('closed'))) {\n          throw error;\n        }\n      }\n    }\n  }\n\n  protected handleError(error: DOMException): void {\n    console.error(`${this.getEncoderType()} encoder error:`, error);\n    this.controller?.error(error);\n  }\n\n  // Abstract methods to be implemented by subclasses\n  protected abstract isConfigSupported(config: TConfig): Promise<{ supported: boolean }>;\n  protected abstract createEncoder(init: EncoderInit): TEncoder;\n  protected abstract getEncoderType(): string;\n\n  // Hook for subclasses to handle reset\n  protected onReset(): void {\n    // Override in subclasses if needed\n  }\n\n  // Abstract properties for backpressure configuration\n  protected abstract readonly highWaterMark: number;\n  protected abstract readonly encodeQueueThreshold: number;\n\n  /**\n   * Create transform stream for encoding\n   * Implements common stream logic with backpressure handling\n   */\n  createStream(): TransformStream<TInput, EncoderChunk> {\n    return new TransformStream<TInput, EncoderChunk>(\n      {\n        start: async (controller) => {\n          this.controller = controller;\n\n          // Initialize encoder if not already initialized\n          if (!this.isReady) {\n            await this.initialize();\n          }\n        },\n\n        transform: async (input) => {\n          if (!this.encoder || this.encoder.state !== 'configured') {\n            throw new Error('Encoder not configured');\n          }\n\n          // Check encoder queue pressure\n          if (this.encoder.encodeQueueSize >= this.encodeQueueThreshold) {\n            // Wait for queue to drain\n            await new Promise<void>((resolve) => {\n              const check = () => {\n                if (!this.encoder || this.encoder.encodeQueueSize < this.encodeQueueThreshold - 1) {\n                  resolve();\n                } else {\n                  setTimeout(check, 10);\n                }\n              };\n              check();\n            });\n          }\n\n          // Encode the input\n          const frame = (input as any).frame || input;\n          this.encode(frame);\n        },\n\n        flush: async () => {\n          await this.flush();\n        },\n      },\n      // Queuing strategy with backpressure configuration\n      {\n        highWaterMark: this.highWaterMark,\n        size: () => 1, // Count-based\n      }\n    );\n  }\n\n  // Abstract method for encoding\n  abstract encode(input: TInput): void;\n}\n\ninterface EncoderInit {\n  output: (chunk: any, metadata: any) => void;\n  error: (error: DOMException) => void;\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/encode/ClipEncoderManager.d.ts

@@ -0,0 +1,64 @@
+import { VideoChunkEncoder } from './VideoChunkEncoder';
+import { AudioChunkEncoder } from './AudioChunkEncoder';
+import { VideoEncoderConfig, AudioEncoderConfig } from './types';
+
+/**
+ * ClipEncoderManager - Per-Clip Encoder Instance Manager
+ *
+ * Responsibilities:
+ * - Maintain separate encoder instances per clip (avoid frameCount pollution)
+ * - Limit concurrent encoder instances (maxEncoders = 6)
+ * - FIFO eviction strategy
+ *
+ * Note: This is NOT a traditional object pool, as it does not support
+ * cross-clip instance reuse. Each sessionId gets its own dedicated encoder
+ * that is destroyed (not recycled) when released.
+ */
+export declare class ClipEncoderManager {
+    private videoEncoders;
+    private audioEncoders;
+    private videoCreationOrder;
+    private audioCreationOrder;
+    private readonly maxEncoders;
+    constructor(maxEncoders?: number);
+    /**
+     * Acquire a video encoder for the given sessionId
+     * Creates new encoder if not exists; returns existing one if already created
+     */
+    acquireVideo(sessionId: string, config: VideoEncoderConfig): Promise<VideoChunkEncoder>;
+    /**
+     * Acquire an audio encoder for the given sessionId
+     */
+    acquireAudio(sessionId: string, config: AudioEncoderConfig): Promise<AudioChunkEncoder>;
+    /**
+     * Release video encoder for the given sessionId
+     */
+    releaseVideo(sessionId: string): Promise<void>;
+    /**
+     * Release audio encoder for the given sessionId
+     */
+    releaseAudio(sessionId: string): Promise<void>;
+    /**
+     * Release both video and audio encoders for the given sessionId
+     */
+    releaseClip(sessionId: string): Promise<void>;
+    /**
+     * Close all encoders and clear state
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Check if encoders exist for the given sessionId
+     */
+    has(sessionId: string): boolean;
+    /**
+     * Get statistics about current encoder state
+     */
+    getStats(): {
+        videoEncoders: number;
+        audioEncoders: number;
+        maxEncoders: number;
+        videoCreationOrder: string[];
+        audioCreationOrder: string[];
+    };
+}
+//# sourceMappingURL=ClipEncoderManager.d.ts.map