@livepeer-frameworks/player-core 0.0.3

package/src/players/WebCodecsPlayer/worker/types.ts

@@ -0,0 +1,276 @@
+/**
+ * Worker-specific Types for WebCodecs Player
+ *
+ * These types define the message protocol between main thread and worker.
+ */
+
+import type { TrackInfo, FrameTimingStats, PipelineStats } from '../types';
+
+// ============================================================================
+// Main Thread -> Worker Messages
+// ============================================================================
+
+export interface CreateMessage {
+  type: 'create';
+  idx: number;
+  track: TrackInfo;
+  opts: {
+    optimizeForLatency: boolean;
+  };
+  uid: number;
+}
+
+export interface ConfigureMessage {
+  type: 'configure';
+  idx: number;
+  header: Uint8Array;
+  uid: number;
+}
+
+export interface ReceiveMessage {
+  type: 'receive';
+  idx: number;
+  chunk: {
+    type: 'key' | 'delta';
+    timestamp: number; // microseconds
+    data: Uint8Array;
+  };
+  uid: number;
+}
+
+export interface SetWritableMessage {
+  type: 'setwritable';
+  idx: number;
+  writable: WritableStream<VideoFrame | AudioData>;
+  uid: number;
+}
+
+export interface CreateGeneratorMessage {
+  type: 'creategenerator';
+  idx: number;
+  uid: number;
+}
+
+export interface CloseMessage {
+  type: 'close';
+  idx: number;
+  waitEmpty?: boolean;
+  uid: number;
+}
+
+export interface FrameTimingMessage {
+  type: 'frametiming';
+  action: 'setSpeed' | 'reset' | 'setPaused';
+  speed?: number;
+  tweak?: number;
+  paused?: boolean;
+  uid: number;
+}
+
+export interface SeekMessage {
+  type: 'seek';
+  seekTime: number; // milliseconds
+  uid: number;
+}
+
+export interface FrameStepMessage {
+  type: 'framestep';
+  direction: -1 | 1;
+  uid: number;
+}
+
+export interface DebuggingMessage {
+  type: 'debugging';
+  value: boolean | 'verbose';
+  uid: number;
+}
+
+export type MainToWorkerMessage =
+  | CreateMessage
+  | ConfigureMessage
+  | ReceiveMessage
+  | SetWritableMessage
+  | CreateGeneratorMessage
+  | CloseMessage
+  | FrameTimingMessage
+  | SeekMessage
+  | FrameStepMessage
+  | DebuggingMessage;
+
+// ============================================================================
+// Worker -> Main Thread Messages
+// ============================================================================
+
+export interface AddTrackMessage {
+  type: 'addtrack';
+  idx: number;
+  track?: MediaStreamTrack; // Only for Safari's MediaStreamTrackGenerator in Worker
+  uid: number;
+  status: 'ok';
+}
+
+export interface RemoveTrackMessage {
+  type: 'removetrack';
+  idx: number;
+  uid: number;
+}
+
+export interface SetPlaybackRateMessage {
+  type: 'setplaybackrate';
+  speed: number;
+  uid: number;
+}
+
+export interface ClosedMessage {
+  type: 'closed';
+  idx: number;
+  uid: number;
+  status: 'ok';
+}
+
+export interface LogMessage {
+  type: 'log';
+  msg: string;
+  level?: 'info' | 'warn' | 'error';
+  uid: number;
+}
+
+export interface SendEventMessage {
+  type: 'sendevent';
+  kind: string;
+  message?: string;
+  time?: number;
+  idx?: number;
+  uid: number;
+}
+
+export interface StatsUpdateMessage {
+  type: 'stats';
+  stats: {
+    frameTiming: FrameTimingStats;
+    pipelines: Record<number, PipelineStats>;
+  };
+  uid: number;
+}
+
+export interface AckMessage {
+  type: 'ack';
+  idx?: number;
+  uid: number;
+  status: 'ok' | 'error';
+  error?: string;
+}
+
+/** Safari audio: worker sends frames to main thread for writing */
+export interface WriteFrameMessage {
+  type: 'writeframe';
+  idx: number;
+  frame: AudioData;
+  uid: number;
+}
+
+export type WorkerToMainMessage =
+  | AddTrackMessage
+  | RemoveTrackMessage
+  | SetPlaybackRateMessage
+  | ClosedMessage
+  | LogMessage
+  | SendEventMessage
+  | StatsUpdateMessage
+  | AckMessage
+  | WriteFrameMessage;
+
+// ============================================================================
+// Internal Worker Types
+// ============================================================================
+
+export interface FrameTiming {
+  /** When frame entered decoder (microseconds, performance.now() * 1000) */
+  in: number;
+  /** When frame exited decoder (microseconds) */
+  decoded: number;
+  /** When frame was written to output (microseconds) */
+  out: number;
+  speed: {
+    main: number;
+    tweak: number;
+    combined: number;
+  };
+  seeking: boolean;
+  paused: boolean;
+  /** Server-sent current time */
+  serverTime: number;
+}
+
+export interface DecodedFrame {
+  frame: VideoFrame | AudioData;
+  timestamp: number; // microseconds
+  decodedAt: number; // performance.now() when decoded
+}
+
+export interface PipelineState {
+  idx: number;
+  track: TrackInfo;
+  configured: boolean;
+  closed: boolean;
+  decoder: VideoDecoder | AudioDecoder | null;
+  writable: WritableStream<VideoFrame | AudioData> | null;
+  writer: WritableStreamDefaultWriter<VideoFrame | AudioData> | null;
+  inputQueue: Array<{
+    type: 'key' | 'delta';
+    timestamp: number;
+    data: Uint8Array;
+  }>;
+  outputQueue: DecodedFrame[];
+  /** Recent video frames for backward/forward stepping (video only) */
+  frameHistory?: Array<{ frame: VideoFrame; timestamp: number }>;
+  /** Cursor into frameHistory for step navigation */
+  historyCursor?: number | null;
+  stats: {
+    framesIn: number;
+    framesDecoded: number;
+    framesOut: number;
+    framesDropped: number; // Phase 2B: Track dropped frames
+    lastInputTimestamp: number;
+    lastOutputTimestamp: number;
+    decoderQueueSize: number;
+    // Debug info for error diagnosis
+    lastChunkType: string;
+    lastChunkSize: number;
+    lastChunkBytes: string;
+  };
+  optimizeForLatency: boolean;
+}
+
+// ============================================================================
+// Frame Scheduling Types
+// ============================================================================
+
+export interface ScheduleResult {
+  /** Whether frame should be output now */
+  shouldOutput: boolean;
+  /** How early/late frame is (negative = late) in ms */
+  earliness: number;
+  /** Suggested delay before next check (ms) */
+  checkDelayMs: number;
+}
+
+// ============================================================================
+// Codec Configuration Types
+// ============================================================================
+
+export interface VideoDecoderInit {
+  codec: string;
+  codedWidth?: number;
+  codedHeight?: number;
+  description?: Uint8Array;
+  hardwareAcceleration?: 'no-preference' | 'prefer-hardware' | 'prefer-software';
+  optimizeForLatency?: boolean;
+}
+
+export interface AudioDecoderInit {
+  codec: string;
+  sampleRate: number;
+  numberOfChannels: number;
+  description?: Uint8Array;
+}

package/src/players/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Player Implementations
+ *
+ * Framework-agnostic player implementations that extend BasePlayer.
+ * These are used by PlayerRegistry for dynamic player selection.
+ */
+
+// Direct playback players
+export { NativePlayerImpl, DirectPlaybackPlayerImpl } from './NativePlayer';
+
+// Adaptive streaming players
+export { HlsJsPlayerImpl } from './HlsJsPlayer';
+export { DashJsPlayerImpl } from './DashJsPlayer';
+export { VideoJsPlayerImpl } from './VideoJsPlayer';
+
+// MistServer-specific players
+export { MistPlayerImpl } from './MistPlayer';
+export { MewsWsPlayerImpl } from './MewsWsPlayer';
+export { MistWebRTCPlayerImpl } from './MistWebRTCPlayer';
+
+// Low-latency WebCodecs player (WebSocket + WebCodecs API)
+export { WebCodecsPlayerImpl } from './WebCodecsPlayer';

package/src/styles/animations.css

@@ -0,0 +1,21 @@
+@keyframes float {
+  0%, 100% {
+    transform: translateY(0px) scale(1);
+  }
+  50% {
+    transform: translateY(-12px) scale(0.95);
+  }
+}
+
+@keyframes spin-slow {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.animate-spin-slow {
+  animation: spin-slow 18s linear infinite;
+}

package/src/styles/index.ts

@@ -0,0 +1,52 @@
+let stylesInjected = false;
+const STYLE_URL = "player.css";
+
+/**
+ * Ensures the compiled player stylesheet is imported once. When bundling with
+ * tools that respect package `style` fields, simply importing the module is enough.
+ * For host environments that do not, calling this helper will inject a link tag.
+ */
+export function ensurePlayerStyles(): void {
+  if (typeof document === "undefined") return;
+  if (stylesInjected) return;
+  const existing = document.querySelector<HTMLLinkElement>('link[data-fw-player-style="true"]');
+  if (existing) {
+    stylesInjected = true;
+    return;
+  }
+
+  const link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = getStylesheetUrl();
+  link.setAttribute("data-fw-player-style", "true");
+  document.head.appendChild(link);
+  stylesInjected = true;
+}
+
+/**
+ * For SSR-first apps, inject the CSS manually and mark it as applied.
+ */
+export function injectPlayerStyles(href?: string): void {
+  if (typeof document === "undefined") return;
+  stylesInjected = true;
+  const link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = href ?? getStylesheetUrl();
+  link.setAttribute("data-fw-player-style", "true");
+  document.head.appendChild(link);
+}
+
+function getStylesheetUrl(): string {
+  const current = typeof document !== "undefined" ? document.currentScript : null;
+  const src = current && "src" in current ? (current as HTMLScriptElement).src : undefined;
+  if (!src) return STYLE_URL;
+  try {
+    const url = new URL(src);
+    url.pathname = url.pathname.replace(/\/[^/]*$/, `/${STYLE_URL}`);
+    return url.toString();
+  } catch {
+    return STYLE_URL;
+  }
+}
+
+export default ensurePlayerStyles;