@livepeer-frameworks/player-core 0.0.4 → 0.1.1

package/src/players/WebCodecsPlayer/JitterBuffer.ts

@@ -15,7 +15,7 @@
  * 5. Limit lowering rate to prevent oscillation
  */
 
-import type { JitterState } from './types';
+import type { JitterState } from "./types";
 
 /** Default sliding window size for chunk tracking */
 const DEFAULT_CHUNK_WINDOW = 8;
@@ -156,8 +156,7 @@ export class JitterTracker {
     // Calculate new weighted average
     if (this.peaks.length > 0) {
       const maxPeak = Math.max(...this.peaks);
-      const avgPeak =
-        this.peaks.reduce((sum, p) => sum + p, 0) / this.peaks.length;
+      const avgPeak = this.peaks.reduce((sum, p) => sum + p, 0) / this.peaks.length;
 
       // Weighted: emphasize max peak for safety
       let weighted = (avgPeak + maxPeak * 2) / 3 + MIN_JITTER;
@@ -193,8 +192,8 @@ export class JitterTracker {
   /**
    * Set playback speed for jitter calculation
    */
-  setSpeed(speed: number | 'auto'): void {
-    const newSpeed = speed === 'auto' ? 1 : speed;
+  setSpeed(speed: number | "auto"): void {
+    const newSpeed = speed === "auto" ? 1 : speed;
     if (newSpeed !== this.speed) {
       this.speed = newSpeed;
       this.reset();
@@ -267,8 +266,8 @@ export class MultiTrackJitterTracker {
   /**
    * Set playback speed for all trackers
    */
-  setSpeed(speed: number | 'auto'): void {
-    this.globalSpeed = speed === 'auto' ? 1 : speed;
+  setSpeed(speed: number | "auto"): void {
+    this.globalSpeed = speed === "auto" ? 1 : speed;
     for (const tracker of this.trackers.values()) {
       tracker.setSpeed(speed);
     }

package/src/players/WebCodecsPlayer/LatencyProfiles.ts

@@ -10,7 +10,7 @@
  *   - If buffer < desired * speedDownThreshold → slow down to minSpeedDown
  */
 
-import type { LatencyProfile, LatencyProfileName } from './types';
+import type { LatencyProfile, LatencyProfileName } from "./types";
 
 /**
  * Ultra-low latency profile
@@ -19,15 +19,15 @@ import type { LatencyProfile, LatencyProfileName } from './types';
  * Trade-offs: May stutter on poor networks
  */
 export const ULTRA_LOW_PROFILE: LatencyProfile = {
-  name: 'Ultra Low Latency',
-  keepAway: 50,              // 50ms base buffer
-  jitterMultiplier: 1.0,     // Full jitter protection (no extra margin)
-  speedUpThreshold: 1.5,     // Speed up when buffer > 150% of desired
-  speedDownThreshold: 0.5,   // Slow down when buffer < 50% of desired
-  maxSpeedUp: 1.08,          // 8% speed up max
-  minSpeedDown: 0.95,        // 5% slow down max
-  audioBufferMs: 100,        // 100ms audio ring buffer
-  optimizeForLatency: true,  // Tell decoders to optimize for latency
+  name: "Ultra Low Latency",
+  keepAway: 50, // 50ms base buffer
+  jitterMultiplier: 1.0, // Full jitter protection (no extra margin)
+  speedUpThreshold: 1.5, // Speed up when buffer > 150% of desired
+  speedDownThreshold: 0.5, // Slow down when buffer < 50% of desired
+  maxSpeedUp: 1.08, // 8% speed up max
+  minSpeedDown: 0.95, // 5% slow down max
+  audioBufferMs: 100, // 100ms audio ring buffer
+  optimizeForLatency: true, // Tell decoders to optimize for latency
 };
 
 /**
@@ -37,14 +37,14 @@ export const ULTRA_LOW_PROFILE: LatencyProfile = {
  * Trade-offs: Balanced latency/stability
  */
 export const LOW_PROFILE: LatencyProfile = {
-  name: 'Low Latency',
-  keepAway: 100,             // 100ms base buffer
-  jitterMultiplier: 1.2,     // 20% extra jitter protection
-  speedUpThreshold: 2.0,     // Speed up when buffer > 200% of desired
-  speedDownThreshold: 0.6,   // Slow down when buffer < 60% of desired
-  maxSpeedUp: 1.05,          // 5% speed up max (legacy default)
-  minSpeedDown: 0.98,        // 2% slow down max (legacy default)
-  audioBufferMs: 150,        // 150ms audio ring buffer
+  name: "Low Latency",
+  keepAway: 100, // 100ms base buffer
+  jitterMultiplier: 1.2, // 20% extra jitter protection
+  speedUpThreshold: 2.0, // Speed up when buffer > 200% of desired
+  speedDownThreshold: 0.6, // Slow down when buffer < 60% of desired
+  maxSpeedUp: 1.05, // 5% speed up max (legacy default)
+  minSpeedDown: 0.98, // 2% slow down max (legacy default)
+  audioBufferMs: 150, // 150ms audio ring buffer
   optimizeForLatency: true,
 };
 
@@ -55,14 +55,14 @@ export const LOW_PROFILE: LatencyProfile = {
  * Trade-offs: Prioritizes stability over latency
  */
 export const BALANCED_PROFILE: LatencyProfile = {
-  name: 'Balanced',
-  keepAway: 200,             // 200ms base buffer
-  jitterMultiplier: 1.5,     // 50% extra jitter protection
-  speedUpThreshold: 2.5,     // Speed up when buffer > 250% of desired
-  speedDownThreshold: 0.5,   // Slow down when buffer < 50% of desired
-  maxSpeedUp: 1.03,          // 3% speed up max
-  minSpeedDown: 0.97,        // 3% slow down max
-  audioBufferMs: 200,        // 200ms audio ring buffer
+  name: "Balanced",
+  keepAway: 200, // 200ms base buffer
+  jitterMultiplier: 1.5, // 50% extra jitter protection
+  speedUpThreshold: 2.5, // Speed up when buffer > 250% of desired
+  speedDownThreshold: 0.5, // Slow down when buffer < 50% of desired
+  maxSpeedUp: 1.03, // 3% speed up max
+  minSpeedDown: 0.97, // 3% slow down max
+  audioBufferMs: 200, // 200ms audio ring buffer
   optimizeForLatency: false, // Let decoders optimize for quality
 };
 
@@ -73,14 +73,14 @@ export const BALANCED_PROFILE: LatencyProfile = {
  * Trade-offs: Maximum stability, higher latency
  */
 export const QUALITY_PROFILE: LatencyProfile = {
-  name: 'Quality Priority',
-  keepAway: 500,             // 500ms base buffer (legacy VOD default)
-  jitterMultiplier: 2.0,     // Double jitter protection
-  speedUpThreshold: 3.0,     // Speed up when buffer > 300% of desired
-  speedDownThreshold: 0.4,   // Slow down when buffer < 40% of desired
-  maxSpeedUp: 1.02,          // 2% speed up max
-  minSpeedDown: 0.98,        // 2% slow down max
-  audioBufferMs: 300,        // 300ms audio ring buffer
+  name: "Quality Priority",
+  keepAway: 500, // 500ms base buffer (legacy VOD default)
+  jitterMultiplier: 2.0, // Double jitter protection
+  speedUpThreshold: 3.0, // Speed up when buffer > 300% of desired
+  speedDownThreshold: 0.4, // Slow down when buffer < 40% of desired
+  maxSpeedUp: 1.02, // 2% speed up max
+  minSpeedDown: 0.98, // 2% slow down max
+  audioBufferMs: 300, // 300ms audio ring buffer
   optimizeForLatency: false,
 };
 
@@ -88,10 +88,10 @@ export const QUALITY_PROFILE: LatencyProfile = {
  * All available latency profiles
  */
 export const LATENCY_PROFILES: Record<LatencyProfileName, LatencyProfile> = {
-  'ultra-low': ULTRA_LOW_PROFILE,
-  'low': LOW_PROFILE,
-  'balanced': BALANCED_PROFILE,
-  'quality': QUALITY_PROFILE,
+  "ultra-low": ULTRA_LOW_PROFILE,
+  low: LOW_PROFILE,
+  balanced: BALANCED_PROFILE,
+  quality: QUALITY_PROFILE,
 };
 
 /**
@@ -103,7 +103,7 @@ export function getLatencyProfile(name?: LatencyProfileName): LatencyProfile {
   if (name && name in LATENCY_PROFILES) {
     return LATENCY_PROFILES[name];
   }
-  return LATENCY_PROFILES['low'];
+  return LATENCY_PROFILES["low"];
 }
 
 /**
@@ -116,7 +116,7 @@ export function mergeLatencyProfile(
   base: LatencyProfileName | LatencyProfile,
   custom?: Partial<LatencyProfile>
 ): LatencyProfile {
-  const baseProfile = typeof base === 'string' ? getLatencyProfile(base) : base;
+  const baseProfile = typeof base === "string" ? getLatencyProfile(base) : base;
 
   if (!custom) {
     return baseProfile;
@@ -140,12 +140,12 @@ export function selectDefaultProfile(
   preferLowLatency = false
 ): LatencyProfileName {
   if (!isLive) {
-    return 'quality';
+    return "quality";
   }
 
   if (preferLowLatency) {
-    return 'low';
+    return "low";
   }
 
-  return 'balanced';
+  return "balanced";
 }

package/src/players/WebCodecsPlayer/RawChunkParser.ts

@@ -13,7 +13,7 @@
  * Combined presentation time = timestamp + offset
  */
 
-import type { RawChunk, ChunkType } from './types';
+import type { RawChunk, ChunkType } from "./types";
 
 const HEADER_LENGTH = 12;
 
@@ -23,11 +23,11 @@ const HEADER_LENGTH = 12;
 function parseChunkType(typeByte: number): ChunkType {
   switch (typeByte) {
     case 1:
-      return 'key';
+      return "key";
     case 2:
-      return 'init';
+      return "init";
     default:
-      return 'delta';
+      return "delta";
   }
 }
 
@@ -92,14 +92,14 @@ export function getPresentationTimestamp(chunk: RawChunk): number {
  * Check if this chunk is a keyframe
  */
 export function isKeyframe(chunk: RawChunk): boolean {
-  return chunk.type === 'key';
+  return chunk.type === "key";
 }
 
 /**
  * Check if this chunk contains codec initialization data
  */
 export function isInitData(chunk: RawChunk): boolean {
-  return chunk.type === 'init';
+  return chunk.type === "init";
 }
 
 /**
@@ -132,12 +132,12 @@ export class RawChunkParser {
       const chunk = parseRawChunk(data);
 
       if (this.debug) {
-        console.log('▶️', formatChunkForLog(chunk));
+        console.log("▶️", formatChunkForLog(chunk));
       }
 
       return chunk;
     } catch (err) {
-      console.error('▶️ Failed to parse chunk:', err);
+      console.error("▶️ Failed to parse chunk:", err);
       return null;
     }
   }
@@ -145,7 +145,7 @@ export class RawChunkParser {
   /**
    * Set debug mode
    */
-  setDebug(enabled: boolean | 'verbose'): void {
-    this.debug = enabled === 'verbose' || enabled === true;
+  setDebug(enabled: boolean | "verbose"): void {
+    this.debug = enabled === "verbose" || enabled === true;
   }
 }

package/src/players/WebCodecsPlayer/SyncController.ts

@@ -14,18 +14,13 @@
  * - TypeScript types
  */
 
-import type {
-  LatencyProfile,
-  BufferState,
-  SyncState,
-  TrackInfo,
-} from './types';
-import { MultiTrackJitterTracker } from './JitterBuffer';
-import { getLatencyProfile } from './LatencyProfiles';
+import type { LatencyProfile, SyncState, TrackInfo } from "./types";
+import { MultiTrackJitterTracker } from "./JitterBuffer";
+import { getLatencyProfile } from "./LatencyProfiles";
 
 /** Events emitted by SyncController */
 export interface SyncControllerEvents {
-  speedchange: { speed: number; reason: 'catchup' | 'slowdown' | 'normal' };
+  speedchange: { speed: number; reason: "catchup" | "slowdown" | "normal" };
   bufferlow: { current: number; desired: number };
   bufferhigh: { current: number; desired: number };
   underrun: void;
@@ -34,9 +29,7 @@ export interface SyncControllerEvents {
   seekcomplete: { seekId: number };
 }
 
-type EventListener<K extends keyof SyncControllerEvents> = (
-  data: SyncControllerEvents[K]
-) => void;
+type EventListener<K extends keyof SyncControllerEvents> = (data: SyncControllerEvents[K]) => void;
 
 /** Seek state tracking */
 interface SeekState {
@@ -92,13 +85,15 @@ export class SyncController {
   private onSpeedChange?: (main: number, tweak: number) => void;
   private onFastForwardRequest?: (ms: number) => void;
 
-  constructor(options: {
-    profile?: LatencyProfile;
-    isLive?: boolean;
-    onSpeedChange?: (main: number, tweak: number) => void;
-    onFastForwardRequest?: (ms: number) => void;
-  } = {}) {
-    this.profile = options.profile ?? getLatencyProfile('low');
+  constructor(
+    options: {
+      profile?: LatencyProfile;
+      isLive?: boolean;
+      onSpeedChange?: (main: number, tweak: number) => void;
+      onFastForwardRequest?: (ms: number) => void;
+    } = {}
+  ) {
+    this.profile = options.profile ?? getLatencyProfile("low");
     this.isLive = options.isLive ?? true;
     this.onSpeedChange = options.onSpeedChange;
     this.onFastForwardRequest = options.onFastForwardRequest;
@@ -169,8 +164,10 @@ export class SyncController {
    */
   getDesiredBuffer(): number {
     // Chrome needs larger base buffer (per mews.js:482)
-    const isChrome = typeof navigator !== 'undefined' &&
-      /Chrome/.test(navigator.userAgent) && !/Edge|Edg/.test(navigator.userAgent);
+    const isChrome =
+      typeof navigator !== "undefined" &&
+      /Chrome/.test(navigator.userAgent) &&
+      !/Edge|Edg/.test(navigator.userAgent);
     const baseBuffer = isChrome ? 1000 : 100;
 
     const serverDelay = this.getServerDelay();
@@ -210,35 +207,37 @@ export class SyncController {
     //   - Buffer is more than jitter + safety margin (not stalled)
     //   - Buffer is less than 1s above desired
     //   - Cooldown period has passed
-    if (this.isLive &&
-        currentBufferMs < this.liveCatchupThresholdMs &&
-        currentBufferMs > Math.max(jitterMs * 1.1, jitterMs + 250) &&
-        (currentBufferMs - desired) < 1000 &&
-        (now - this.lastLiveCatchup) > this.liveCatchupCooldown) {
+    if (
+      this.isLive &&
+      currentBufferMs < this.liveCatchupThresholdMs &&
+      currentBufferMs > Math.max(jitterMs * 1.1, jitterMs + 250) &&
+      currentBufferMs - desired < 1000 &&
+      now - this.lastLiveCatchup > this.liveCatchupCooldown
+    ) {
       this.lastLiveCatchup = now;
       this.requestFastForward(this.liveCatchupRequestMs);
-      this.emit('livecatchup', { fastForwardMs: this.liveCatchupRequestMs });
+      this.emit("livecatchup", { fastForwardMs: this.liveCatchupRequestMs });
     }
 
     // Determine if speed adjustment needed
     if (ratio > this.profile.speedUpThreshold && this.isLive) {
       // Buffer too high - speed up to catch up to live edge
-      this.setTweakSpeed(this.profile.maxSpeedUp, 'catchup');
+      this.setTweakSpeed(this.profile.maxSpeedUp, "catchup");
     } else if (ratio < this.profile.speedDownThreshold) {
       // Buffer too low - slow down to build buffer
-      this.setTweakSpeed(this.profile.minSpeedDown, 'slowdown');
+      this.setTweakSpeed(this.profile.minSpeedDown, "slowdown");
 
       // Request additional data if critically low
       if (ratio < 0.3 && this.isLive) {
         this.requestFastForward(desired - currentBufferMs);
-        this.emit('underrun', undefined);
+        this.emit("underrun", undefined);
       }
 
-      this.emit('bufferlow', { current: currentBufferMs, desired });
+      this.emit("bufferlow", { current: currentBufferMs, desired });
     } else {
       // Buffer in acceptable range - return to normal speed
       if (this.tweakSpeed !== 1) {
-        this.setTweakSpeed(1, 'normal');
+        this.setTweakSpeed(1, "normal");
       }
     }
 
@@ -258,13 +257,14 @@ export class SyncController {
         desired,
         ratio: desired > 0 ? buffer / desired : 1,
       },
-      jitter: this.jitterTracker.getMax() > 0
-        ? {
-            current: 0, // Would need per-frame tracking
-            peak: 0,
-            weighted: this.jitterTracker.getMax(),
-          }
-        : { current: 0, peak: 0, weighted: 0 },
+      jitter:
+        this.jitterTracker.getMax() > 0
+          ? {
+              current: 0, // Would need per-frame tracking
+              peak: 0,
+              weighted: this.jitterTracker.getMax(),
+            }
+          : { current: 0, peak: 0, weighted: 0 },
       playbackSpeed: this.getCombinedSpeed(),
       serverTime: this.serverTime,
       serverDelay: this.getServerDelay(),
@@ -291,14 +291,11 @@ export class SyncController {
   /**
    * Set tweak speed (automatic adjustment)
    */
-  private setTweakSpeed(
-    speed: number,
-    reason: 'catchup' | 'slowdown' | 'normal'
-  ): void {
+  private setTweakSpeed(speed: number, reason: "catchup" | "slowdown" | "normal"): void {
     if (this.tweakSpeed !== speed) {
       this.tweakSpeed = speed;
       this.notifySpeedChange();
-      this.emit('speedchange', { speed: this.getCombinedSpeed(), reason });
+      this.emit("speedchange", { speed: this.getCombinedSpeed(), reason });
     }
   }
 
@@ -338,7 +335,7 @@ export class SyncController {
     // Reset jitter tracking on seek
     this.jitterTracker.reset();
 
-    this.emit('seekstart', { seekId: this.seekState.id, time: targetTimeMs });
+    this.emit("seekstart", { seekId: this.seekState.id, time: targetTimeMs });
 
     return this.seekState.id;
   }
@@ -356,7 +353,7 @@ export class SyncController {
   completeSeek(seekId: number): void {
     if (this.seekState.id === seekId) {
       this.seekState.active = false;
-      this.emit('seekcomplete', { seekId });
+      this.emit("seekcomplete", { seekId });
     }
   }
 
@@ -383,7 +380,7 @@ export class SyncController {
   /**
    * Register a new track
    */
-  addTrack(trackIndex: number, track: TrackInfo): void {
+  addTrack(_trackIndex: number, _track: TrackInfo): void {
     // Jitter tracking will be initialized on first chunk
   }
 
@@ -421,20 +418,14 @@ export class SyncController {
   // Event Emitter
   // ============================================================================
 
-  on<K extends keyof SyncControllerEvents>(
-    event: K,
-    listener: EventListener<K>
-  ): void {
+  on<K extends keyof SyncControllerEvents>(event: K, listener: EventListener<K>): void {
     if (!this.listeners.has(event)) {
       this.listeners.set(event, new Set());
     }
     this.listeners.get(event)!.add(listener);
   }
 
-  off<K extends keyof SyncControllerEvents>(
-    event: K,
-    listener: EventListener<K>
-  ): void {
+  off<K extends keyof SyncControllerEvents>(event: K, listener: EventListener<K>): void {
     this.listeners.get(event)?.delete(listener);
   }