@meframe/core 0.0.2 → 0.0.4

package/dist/stages/decode/BaseDecoder.js

@@ -1,130 +0,0 @@
-class BaseDecoder {
-  decoder;
-  config;
-  controller = null;
-  constructor(config) {
-    this.config = config;
-  }
-  async initialize() {
-    if (this.decoder?.state === "configured") {
-      return;
-    }
-    const isSupported = await this.isConfigSupported(this.config);
-    if (!isSupported.supported) {
-      throw new Error(
-        `Codec not supported: ${this.config.codecString || this.config.codec}`
-      );
-    }
-    this.decoder = this.createDecoder({
-      output: this.handleOutput.bind(this),
-      error: this.handleError.bind(this)
-    });
-    await this.configureDecoder(this.config);
-  }
-  async reconfigure(config) {
-    this.config = { ...this.config, ...config };
-    if (!this.decoder) {
-      await this.initialize();
-      return;
-    }
-    if (this.decoder.state === "configured") {
-      await this.decoder.flush();
-    }
-    const isSupported = await this.isConfigSupported(this.config);
-    if (!isSupported.supported) {
-      throw new Error(
-        `New configuration not supported: ${this.config.codecString || this.config.codec}`
-      );
-    }
-    await this.configureDecoder(this.config);
-  }
-  async flush() {
-    if (!this.decoder) return;
-    await this.decoder.flush();
-  }
-  async reset() {
-    if (!this.decoder) return;
-    this.decoder.reset();
-    this.onReset();
-  }
-  async close() {
-    if (!this.decoder) return;
-    if (this.decoder.state === "configured") {
-      await this.decoder.flush();
-    }
-    this.decoder.close();
-    this.decoder = void 0;
-  }
-  get isReady() {
-    return this.decoder?.state === "configured";
-  }
-  get queueSize() {
-    return this.decoder?.decodeQueueSize ?? 0;
-  }
-  handleOutput(data) {
-    if (!this.controller) {
-      this.closeIfPossible(data);
-      return;
-    }
-    try {
-      this.controller.enqueue(data);
-    } catch (error) {
-      if (error instanceof TypeError && /Cannot enqueue a chunk into a readable stream that is closed/.test(error.message)) {
-        this.closeIfPossible(data);
-        return;
-      }
-      throw error;
-    }
-  }
-  handleError(error) {
-    console.error(`${this.getDecoderType()} decoder error:`, error);
-    this.controller?.error(error);
-  }
-  closeIfPossible(data) {
-    data?.close?.();
-    data?.frame?.close?.();
-  }
-  onReset() {
-  }
-  createStream() {
-    return new TransformStream(
-      {
-        start: async (controller) => {
-          this.controller = controller;
-          if (!this.isReady) {
-            await this.initialize();
-          }
-        },
-        transform: async (input) => {
-          if (!this.decoder || this.decoder.state !== "configured") {
-            throw new Error("Decoder not configured");
-          }
-          if (this.decoder.decodeQueueSize >= this.decodeQueueThreshold) {
-            await new Promise((resolve) => {
-              const check = () => {
-                if (!this.decoder || this.decoder.decodeQueueSize < this.decodeQueueThreshold - 1) {
-                  resolve();
-                } else {
-                  setTimeout(check, 10);
-                }
-              };
-              check();
-            });
-          }
-          this.decode(input);
-        },
-        flush: async () => {
-          await this.flush();
-        }
-      },
-      {
-        highWaterMark: this.highWaterMark,
-        size: () => 1
-      }
-    );
-  }
-}
-export {
-  BaseDecoder
-};
-//# sourceMappingURL=BaseDecoder.js.map

package/dist/stages/decode/BaseDecoder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"BaseDecoder.js","sources":["../../../src/stages/decode/BaseDecoder.ts"],"sourcesContent":["/**\n * Base decoder class abstracting common WebCodecs decoder workflow.\n * Mirrors BaseEncoder but for decoding path.\n */\nimport { AudioDecoderConfig, DecodedVideoFrame, VideoDecoderConfig } from './types';\n\nexport abstract class BaseDecoder<\n  TDecoder extends VideoDecoder | AudioDecoder,\n  TConfig extends VideoDecoderConfig | AudioDecoderConfig,\n  TInput extends EncodedVideoChunk | EncodedAudioChunk,\n  TOutput extends VideoFrame | AudioData | DecodedVideoFrame,\n> {\n  protected decoder?: TDecoder;\n  protected config: TConfig;\n  protected controller: TransformStreamDefaultController<TOutput> | null = null;\n\n  constructor(config: TConfig) {\n    this.config = config;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.decoder?.state === 'configured') {\n      return;\n    }\n    const isSupported = await this.isConfigSupported(this.config);\n    if (!isSupported.supported) {\n      throw new Error(\n        `Codec not supported: ${(this.config as any).codecString || (this.config as any).codec}`\n      );\n    }\n\n    this.decoder = this.createDecoder({\n      output: this.handleOutput.bind(this),\n      error: this.handleError.bind(this),\n    });\n\n    await this.configureDecoder(this.config);\n  }\n\n  async reconfigure(config: Partial<TConfig>): Promise<void> {\n    this.config = { ...this.config, ...config } as TConfig;\n\n    if (!this.decoder) {\n      await this.initialize();\n      return;\n    }\n\n    // Flush before reconfiguring\n    if (this.decoder.state === 'configured') {\n      await this.decoder.flush();\n    }\n\n    const isSupported = await this.isConfigSupported(this.config);\n    if (!isSupported.supported) {\n      throw new Error(\n        `New configuration not supported: ${(this.config as any).codecString || (this.config as any).codec}`\n      );\n    }\n\n    await this.configureDecoder(this.config);\n  }\n\n  async flush(): Promise<void> {\n    if (!this.decoder) return;\n    await this.decoder.flush();\n  }\n\n  async reset(): Promise<void> {\n    if (!this.decoder) return;\n    this.decoder.reset();\n    this.onReset();\n  }\n\n  async close(): Promise<void> {\n    if (!this.decoder) return;\n\n    if (this.decoder.state === 'configured') {\n      await this.decoder.flush();\n    }\n\n    this.decoder.close();\n    this.decoder = undefined;\n  }\n\n  get isReady(): boolean {\n    return this.decoder?.state === 'configured';\n  }\n\n  get queueSize(): number {\n    return (this.decoder as any)?.decodeQueueSize ?? 0;\n  }\n\n  protected handleOutput(data: TOutput): void {\n    if (!this.controller) {\n      this.closeIfPossible(data);\n      return;\n    }\n\n    try {\n      this.controller.enqueue(data);\n    } catch (error) {\n      if (\n        error instanceof TypeError &&\n        /Cannot enqueue a chunk into a readable stream that is closed/.test(error.message)\n      ) {\n        this.closeIfPossible(data);\n        return;\n      }\n\n      throw error;\n    }\n  }\n\n  protected handleError(error: DOMException): void {\n    console.error(`${this.getDecoderType()} decoder error:`, error);\n    this.controller?.error(error);\n  }\n\n  private closeIfPossible(data: TOutput): void {\n    (data as any)?.close?.();\n    (data as DecodedVideoFrame)?.frame?.close?.();\n  }\n\n  // Abstracts\n  protected abstract isConfigSupported(config: TConfig): Promise<{ supported: boolean }>;\n  protected abstract createDecoder(init: DecoderInit): TDecoder;\n  protected abstract configureDecoder(config: TConfig): Promise<void>;\n  protected abstract getDecoderType(): string;\n  protected abstract decode(input: TInput): void;\n  protected onReset(): void {}\n\n  // Backpressure\n  protected abstract readonly highWaterMark: number;\n  protected abstract readonly decodeQueueThreshold: number;\n\n  createStream(): TransformStream<TInput, TOutput> {\n    return new TransformStream<TInput, TOutput>(\n      {\n        start: async (controller) => {\n          this.controller = controller;\n          if (!this.isReady) {\n            await this.initialize();\n          }\n        },\n        transform: async (input) => {\n          if (!this.decoder || this.decoder.state !== 'configured') {\n            throw new Error('Decoder not configured');\n          }\n          // backpressure\n          if ((this.decoder as any).decodeQueueSize >= this.decodeQueueThreshold) {\n            await new Promise<void>((resolve) => {\n              const check = () => {\n                if (\n                  !this.decoder ||\n                  (this.decoder as any).decodeQueueSize < this.decodeQueueThreshold - 1\n                ) {\n                  resolve();\n                } else {\n                  setTimeout(check, 10);\n                }\n              };\n              check();\n            });\n          }\n          this.decode(input);\n        },\n        flush: async () => {\n          await this.flush();\n        },\n      },\n      {\n        highWaterMark: this.highWaterMark,\n        size: () => 1,\n      }\n    );\n  }\n}\n\ninterface DecoderInit {\n  output: (data: any) => void;\n  error: (error: DOMException) => void;\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/decode/VideoChunkDecoder.js

@@ -1,199 +0,0 @@
-import { BaseDecoder } from "./BaseDecoder.js";
-class VideoChunkDecoder extends BaseDecoder {
-  static DEFAULT_HIGH_WATER_MARK = 4;
-  static DEFAULT_DECODE_QUEUE_THRESHOLD = 16;
-  trackId;
-  highWaterMark;
-  decodeQueueThreshold;
-  // GOP tracking (serial is derived from keyframe timestamp for idempotency)
-  currentGopSerial = -1;
-  isCurrentFrameKeyframe = false;
-  // Buffering support for delayed configuration
-  bufferedChunks = [];
-  isProcessingBuffer = false;
-  constructor(trackId, config) {
-    super(config || {});
-    this.trackId = trackId;
-    this.highWaterMark = config?.backpressure?.highWaterMark ?? VideoChunkDecoder.DEFAULT_HIGH_WATER_MARK;
-    this.decodeQueueThreshold = config?.backpressure?.decodeQueueThreshold ?? VideoChunkDecoder.DEFAULT_DECODE_QUEUE_THRESHOLD;
-  }
-  // Computed properties
-  get isConfigured() {
-    return this.isReady;
-  }
-  get state() {
-    return this.decoder?.state || "unconfigured";
-  }
-  /**
-   * Update configuration - can be called before or after initialization
-   */
-  async updateConfig(config) {
-    if (!this.isReady && config.codec) {
-      await this.configure(config);
-      await this.processBufferedChunks();
-    }
-  }
-  // Override createStream to handle GOP tracking and buffering
-  // Always create new stream for each clip (ReadableStreams can only be consumed once)
-  createStream() {
-    return new TransformStream(
-      {
-        start: async (controller) => {
-          this.controller = controller;
-          if (this.config?.codec && this.config?.description && !this.isReady) {
-            await this.initialize();
-          }
-        },
-        transform: async (chunk) => {
-          if (!this.isReady) {
-            this.bufferedChunks.push(chunk);
-            return;
-          }
-          if (this.isProcessingBuffer) {
-            this.bufferedChunks.push(chunk);
-            return;
-          }
-          await this.processChunk(chunk);
-        },
-        flush: async () => {
-          if (this.isReady) {
-            await this.flush();
-          }
-        }
-      },
-      {
-        highWaterMark: this.highWaterMark,
-        size: () => 1
-      }
-    );
-  }
-  /**
-   * Process a single chunk (extracted from transform for reuse)
-   */
-  async processChunk(chunk) {
-    if (!this.decoder) {
-      throw new Error("Decoder not initialized");
-    }
-    if (this.decoder.state !== "configured") {
-      console.error("[VideoChunkDecoder] Decoder in unexpected state:", this.decoder.state);
-      throw new Error(`Decoder not configured, state: ${this.decoder.state}`);
-    }
-    if (chunk.type === "key") {
-      this.handleKeyFrame(chunk.timestamp);
-    }
-    if (this.decoder.decodeQueueSize >= this.decodeQueueThreshold) {
-      await new Promise((resolve) => {
-        const check = () => {
-          if (!this.decoder || this.decoder.decodeQueueSize < this.decodeQueueThreshold - 1) {
-            resolve();
-          } else {
-            setTimeout(check, 20);
-          }
-        };
-        check();
-      });
-    }
-    try {
-      this.decode(chunk);
-    } catch (error) {
-      console.error(`[VideoChunkDecoder] decode error:`, error);
-      throw error;
-    }
-  }
-  // Override handleOutput to attach GOP metadata
-  handleOutput(frame) {
-    const wrappedFrame = {
-      frame,
-      gopSerial: this.currentGopSerial,
-      isKeyframe: this.isCurrentFrameKeyframe,
-      timestamp: frame.timestamp
-    };
-    this.isCurrentFrameKeyframe = false;
-    super.handleOutput(wrappedFrame);
-  }
-  // Implement abstract methods
-  async isConfigSupported(config) {
-    const result = await VideoDecoder.isConfigSupported({
-      codec: config.codec,
-      codedWidth: config.width,
-      codedHeight: config.height
-    });
-    return { supported: result.supported ?? false };
-  }
-  createDecoder(init) {
-    return new VideoDecoder(init);
-  }
-  getDecoderType() {
-    return "Video";
-  }
-  async configureDecoder(config) {
-    if (!this.decoder) return;
-    const decoderConfig = {
-      codec: config.codec,
-      codedWidth: config.width,
-      codedHeight: config.height,
-      hardwareAcceleration: config.hardwareAcceleration || "prefer-hardware",
-      optimizeForLatency: false,
-      ...config.description && { description: config.description },
-      ...config.displayAspectWidth && { displayAspectWidth: config.displayAspectWidth },
-      ...config.displayAspectHeight && { displayAspectHeight: config.displayAspectHeight }
-    };
-    this.decoder.configure(decoderConfig);
-  }
-  decode(chunk) {
-    this.decoder?.decode(chunk);
-  }
-  // Override reset to clear GOP data
-  onReset() {
-    this.currentGopSerial = -1;
-    this.isCurrentFrameKeyframe = false;
-  }
-  // GOP management methods
-  handleKeyFrame(timestamp) {
-    this.currentGopSerial = timestamp;
-    this.isCurrentFrameKeyframe = true;
-  }
-  /**
-   * Configure the decoder with codec info (can be called after creation)
-   */
-  async configure(config) {
-    if (this.isReady) {
-      await this.reconfigure(config);
-      return;
-    }
-    this.config = config;
-    await this.initialize();
-  }
-  /**
-   * Process any buffered chunks after configuration
-   */
-  async processBufferedChunks() {
-    if (!this.isReady || this.bufferedChunks.length === 0) {
-      return;
-    }
-    this.isProcessingBuffer = true;
-    const chunks = [...this.bufferedChunks];
-    this.bufferedChunks = [];
-    for (const chunk of chunks) {
-      try {
-        await this.processChunk(chunk);
-      } catch (error) {
-        console.error("[VideoChunkDecoder] Error processing buffered chunk:", error);
-      }
-    }
-    this.isProcessingBuffer = false;
-    if (this.bufferedChunks.length > 0) {
-      await this.processBufferedChunks();
-    }
-  }
-  // Override close to clean up GOP data
-  async close() {
-    this.bufferedChunks = [];
-    this.onReset();
-    await super.close();
-  }
-}
-export {
-  VideoChunkDecoder
-};
-//# sourceMappingURL=VideoChunkDecoder.js.map

package/dist/stages/decode/VideoChunkDecoder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VideoChunkDecoder.js","sources":["../../../src/stages/decode/VideoChunkDecoder.ts"],"sourcesContent":["import { VideoDecoderConfig } from './types';\nimport { BaseDecoder } from './BaseDecoder';\n\n/**\n * Video decoder with GOP tracking\n * Tracks keyframe boundaries and attaches GOP metadata to decoded frames\n */\nexport class VideoChunkDecoder extends BaseDecoder<\n  VideoDecoder,\n  VideoDecoderConfig,\n  EncodedVideoChunk,\n  VideoFrame\n> {\n  private static readonly DEFAULT_HIGH_WATER_MARK = 4;\n  private static readonly DEFAULT_DECODE_QUEUE_THRESHOLD = 16;\n\n  readonly trackId: string;\n\n  protected readonly highWaterMark: number;\n  protected readonly decodeQueueThreshold: number;\n\n  // GOP tracking (serial is derived from keyframe timestamp for idempotency)\n  private currentGopSerial = -1;\n  private isCurrentFrameKeyframe = false;\n\n  // Buffering support for delayed configuration\n  private bufferedChunks: EncodedVideoChunk[] = [];\n  private isProcessingBuffer: boolean = false;\n\n  constructor(trackId: string, config?: Partial<VideoDecoderConfig>) {\n    super((config || {}) as VideoDecoderConfig);\n\n    this.trackId = trackId;\n    this.highWaterMark =\n      config?.backpressure?.highWaterMark ?? VideoChunkDecoder.DEFAULT_HIGH_WATER_MARK;\n    this.decodeQueueThreshold =\n      config?.backpressure?.decodeQueueThreshold ??\n      VideoChunkDecoder.DEFAULT_DECODE_QUEUE_THRESHOLD;\n  }\n\n  // Computed properties\n  get isConfigured(): boolean {\n    return this.isReady;\n  }\n\n  get state(): string {\n    return this.decoder?.state || 'unconfigured';\n  }\n\n  /**\n   * Update configuration - can be called before or after initialization\n   */\n  async updateConfig(config: Partial<VideoDecoderConfig>): Promise<void> {\n    if (!this.isReady && config.codec) {\n      await this.configure(config as VideoDecoderConfig);\n      await this.processBufferedChunks();\n    }\n  }\n\n  // Override createStream to handle GOP tracking and buffering\n  // Always create new stream for each clip (ReadableStreams can only be consumed once)\n  override createStream(): TransformStream<EncodedVideoChunk, VideoFrame> {\n    return new TransformStream<EncodedVideoChunk, VideoFrame>(\n      {\n        start: async (controller) => {\n          this.controller = controller;\n          // Don't initialize if no codec config yet\n          if (this.config?.codec && this.config?.description && !this.isReady) {\n            await this.initialize();\n          }\n        },\n\n        transform: async (chunk) => {\n          // If not configured yet, buffer the chunk\n          if (!this.isReady) {\n            this.bufferedChunks.push(chunk);\n            return; // Don't process yet\n          }\n\n          // If we're processing buffered chunks, add to buffer to maintain order\n          if (this.isProcessingBuffer) {\n            this.bufferedChunks.push(chunk);\n            return;\n          }\n\n          // Normal processing\n          await this.processChunk(chunk);\n        },\n\n        flush: async () => {\n          if (this.isReady) {\n            await this.flush();\n          }\n        },\n      },\n      {\n        highWaterMark: this.highWaterMark,\n        size: () => 1,\n      }\n    );\n  }\n\n  /**\n   * Process a single chunk (extracted from transform for reuse)\n   */\n  private async processChunk(chunk: EncodedVideoChunk): Promise<void> {\n    if (!this.decoder) {\n      throw new Error('Decoder not initialized');\n    }\n\n    if (this.decoder.state !== 'configured') {\n      console.error('[VideoChunkDecoder] Decoder in unexpected state:', this.decoder.state);\n      throw new Error(`Decoder not configured, state: ${this.decoder.state}`);\n    }\n\n    // Track GOP boundaries\n    if (chunk.type === 'key') {\n      this.handleKeyFrame(chunk.timestamp);\n    }\n\n    // Check decoder queue pressure\n    if (this.decoder.decodeQueueSize >= this.decodeQueueThreshold) {\n      await new Promise<void>((resolve) => {\n        const check = () => {\n          if (!this.decoder || this.decoder.decodeQueueSize < this.decodeQueueThreshold - 1) {\n            resolve();\n          } else {\n            setTimeout(check, 20);\n          }\n        };\n        check();\n      });\n    }\n\n    // Decode the chunk\n    try {\n      this.decode(chunk);\n    } catch (error) {\n      console.error(`[VideoChunkDecoder] decode error:`, error);\n      throw error; // Re-throw to propagate\n    }\n  }\n\n  // Override handleOutput to attach GOP metadata\n  protected override handleOutput(frame: VideoFrame): void {\n    // Wrap frame with GOP metadata as a plain object\n    // The frame itself will be transferred, but metadata travels separately\n    const wrappedFrame = {\n      frame,\n      gopSerial: this.currentGopSerial,\n      isKeyframe: this.isCurrentFrameKeyframe,\n      timestamp: frame.timestamp,\n    };\n\n    // Reset keyframe flag for subsequent frames\n    this.isCurrentFrameKeyframe = false;\n\n    // Call parent to enqueue wrapped frame\n    super.handleOutput(wrappedFrame as any);\n  }\n\n  // Implement abstract methods\n  protected async isConfigSupported(config: VideoDecoderConfig): Promise<{ supported: boolean }> {\n    const result = await VideoDecoder.isConfigSupported({\n      codec: config.codec,\n      codedWidth: config.width,\n      codedHeight: config.height,\n    });\n    return { supported: result.supported ?? false };\n  }\n\n  protected createDecoder(init: {\n    output: (frame: VideoFrame) => void;\n    error: (error: DOMException) => void;\n  }): VideoDecoder {\n    return new VideoDecoder(init);\n  }\n\n  protected getDecoderType(): string {\n    return 'Video';\n  }\n\n  protected async configureDecoder(config: VideoDecoderConfig): Promise<void> {\n    if (!this.decoder) return;\n\n    const decoderConfig = {\n      codec: config.codec,\n      codedWidth: config.width,\n      codedHeight: config.height,\n      hardwareAcceleration: config.hardwareAcceleration || 'prefer-hardware',\n      optimizeForLatency: false,\n      ...(config.description && { description: config.description }),\n      ...(config.displayAspectWidth && { displayAspectWidth: config.displayAspectWidth }),\n      ...(config.displayAspectHeight && { displayAspectHeight: config.displayAspectHeight }),\n    };\n\n    this.decoder.configure(decoderConfig as any);\n    // console.log('[VideoChunkDecoder] Decoder configured, state:', this.decoder.state);\n  }\n\n  protected decode(chunk: EncodedVideoChunk): void {\n    this.decoder?.decode(chunk);\n  }\n\n  // Override reset to clear GOP data\n  protected override onReset(): void {\n    this.currentGopSerial = -1;\n    this.isCurrentFrameKeyframe = false;\n  }\n\n  // GOP management methods\n  private handleKeyFrame(timestamp: number): void {\n    // Use timestamp as gopSerial for idempotency (same keyframe = same serial)\n    this.currentGopSerial = timestamp;\n    this.isCurrentFrameKeyframe = true;\n  }\n\n  /**\n   * Configure the decoder with codec info (can be called after creation)\n   */\n  async configure(config: VideoDecoderConfig): Promise<void> {\n    // console.log('[VideoChunkDecoder] Configuring with:', config);\n\n    if (this.isReady) {\n      // If already configured, reconfigure\n      await this.reconfigure(config);\n      return;\n    }\n\n    this.config = config as any;\n\n    // Initialize decoder with new config\n    await this.initialize();\n  }\n\n  /**\n   * Process any buffered chunks after configuration\n   */\n  async processBufferedChunks(): Promise<void> {\n    if (!this.isReady || this.bufferedChunks.length === 0) {\n      return;\n    }\n\n    // console.log('[VideoChunkDecoder] Processing', this.bufferedChunks.length, 'buffered chunks');\n    this.isProcessingBuffer = true;\n\n    // Process buffered chunks in order\n    const chunks = [...this.bufferedChunks];\n    this.bufferedChunks = [];\n\n    for (const chunk of chunks) {\n      try {\n        await this.processChunk(chunk);\n      } catch (error) {\n        console.error('[VideoChunkDecoder] Error processing buffered chunk:', error);\n      }\n    }\n\n    this.isProcessingBuffer = false;\n\n    // Process any new chunks that arrived while processing buffer\n    if (this.bufferedChunks.length > 0) {\n      await this.processBufferedChunks();\n    }\n  }\n\n  // Override close to clean up GOP data\n  override async close(): Promise<void> {\n    // Clear buffered chunks\n    this.bufferedChunks = [];\n\n    // Clean up GOP data first\n    this.onReset();\n\n    // Call parent close\n    await super.close();\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/decode/decode.worker.d.ts

@@ -1,70 +0,0 @@
-/**
- * DecodeWorker - Third stage in the pipeline
- * Receives encoded chunks from DemuxWorkers and outputs decoded frames to ComposeWorker
- *
- * Pipeline: VideoDemuxWorker/AudioDemuxWorker → DecodeWorker → ComposeWorker
- *
- * Features:
- * - GOP-based caching for video (≤4 GOPs in memory)
- * - Stream-based processing with backpressure
- * - Direct streaming to ComposeWorker
- */
-export declare class DecodeWorker {
-    private channel;
-    private videoDecoders;
-    private audioDecoders;
-    private registeredAudioTracks;
-    private deliveredAudioTracks;
-    private audioTrackMetadata;
-    /** Maximum number of active decoder pairs allowed at the same time */
-    private static readonly MAX_ACTIVE_DECODERS;
-    private defaultVideoConfig;
-    private defaultAudioConfig;
-    private composePorts;
-    private audioDownstreamPort;
-    private demuxPorts;
-    constructor();
-    private setupHandlers;
-    /**
-     * Connect handler used by stream pipeline
-     */
-    private handleConnect;
-    /**
-     * Handle configuration message from orchestrator
-     * @param payload.initial - If true, initialize worker and recreate decoder instances; otherwise just update config
-     */
-    private handleConfigure;
-    private handleReceiveStream;
-    /**
-     * Flush decoders
-     */
-    private handleFlush;
-    /**
-     * Reset decoders
-     */
-    private handleReset;
-    /**
-     * Get decoder statistics
-     */
-    private handleGetStats;
-    /**
-     * Dispose worker and cleanup resources
-     */
-    private handleDispose;
-    /**
-     * Get existing decoder for clip or create a new one (with LRU eviction)
-     */
-    private getOrCreateDecoder;
-    /**
-     * Evict least-recently-used decoder if we exceed MAX_ACTIVE_DECODERS.
-     */
-    private evictIfNeeded;
-    private registerAudioTrack;
-    private extractTrackConfig;
-    private sendAudioTrackAdd;
-    private sendAudioTrackUpdate;
-    private ensureComposeChannel;
-}
-declare const _default: null;
-export default _default;
-//# sourceMappingURL=decode.worker.d.ts.map

package/dist/stages/decode/decode.worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decode.worker.d.ts","sourceRoot":"","sources":["../../../src/stages/decode/decode.worker.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAE/B,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,kBAAkB,CAAoC;IAE9D,sEAAsE;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAGhD,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,kBAAkB,CAAmC;IAG7D,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,UAAU,CAAkC;;IAYpD,OAAO,CAAC,aAAa;IAUrB;;OAEG;YACW,aAAa;IAoC3B;;;OAGG;YACW,eAAe;YAgFf,mBAAmB;IAqDjC;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,WAAW;IA2BzB;;OAEG;YACW,cAAc;IA2B5B;;OAEG;YACW,aAAa;IAqC3B;;OAEG;YACW,kBAAkB;IAuDhC;;OAEG;IACH,OAAO,CAAC,aAAa;YAUP,kBAAkB;IA+ChC,OAAO,CAAC,kBAAkB;YAYZ,iBAAiB;YAgBjB,oBAAoB;IAkBlC,OAAO,CAAC,oBAAoB;CAU7B;;AAUD,wBAAoB"}