@stinkycomputing/web-live-player 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export * from './sources/stream-source';
 export { BasePlayer } from './player/base-player';
 export type { BasePlayerConfig } from './player/base-player';
 export { LiveVideoPlayer, createPlayer } from './player/live-player';
-export type { PlayerConfig, PlayerStats, PlayerState } from './player/live-player';
+export type { PlayerConfig, PlayerStats, PlayerState, BandwidthStats } from './player/live-player';
 export { FileVideoPlayer, createFilePlayer } from './player/file-player';
 export type { FilePlayerConfig, FilePlayerState, FilePlayerStats, FilePlayMode } from './player/file-player';
 export { createStandaloneMoQSource, StandaloneMoQSource } from './sources/standalone-moq-source';
@@ -30,6 +30,6 @@ export { FileAudioPlayer } from './audio/file-audio-player';
 export { LiveAudioPlayer } from './audio/live-audio-player';
 export type { LiveAudioConfig } from './audio/live-audio-player';
 export { FrameScheduler } from './scheduling/frame-scheduler';
-export type { FrameTiming, LatencyStats, SchedulerStatus, SchedulerConfig } from './scheduling/frame-scheduler';
+export type { FrameTiming, LatencyStats, SchedulerStatus, SchedulerConfig, PacketTimingEntry } from './scheduling/frame-scheduler';
 export { SesameBinaryProtocol } from './protocol/sesame-binary-protocol';
 export type { ParsedData, HeaderData, HeaderCodecData } from './protocol/sesame-binary-protocol';

package/dist/player/live-player.d.ts

@@ -21,6 +21,14 @@ export interface PlayerConfig {
  * Player state
  */
 export type PlayerState = 'idle' | 'playing' | 'paused' | 'error';
+/**
+ * Bandwidth statistics
+ */
+export interface BandwidthStats {
+    videoBytesPerSecond: number;
+    audioBytesPerSecond: number;
+    totalBytesPerSecond: number;
+}
 /**
  * Player statistics
  */
@@ -36,6 +44,7 @@ export interface PlayerStats {
     streamHeight: number;
     frameRate: number;
     latency: LatencyStats | null;
+    bandwidth: BandwidthStats | null;
 }
 /**
  * Player event types
@@ -84,6 +93,13 @@ export declare class LiveVideoPlayer extends BasePlayer<PlayerState> {
     private ownsAudioContext;
     private audioCodecData;
     private arrivalTimes;
+    private keyframeStatus;
+    private videoBytesReceived;
+    private audioBytesReceived;
+    private lastBandwidthUpdateTime;
+    private lastVideoBytesReceived;
+    private lastAudioBytesReceived;
+    private currentBandwidth;
     constructor(config?: PlayerConfig);
     /**
      * Enable or disable debug logging at runtime
@@ -164,6 +180,14 @@ export declare class LiveVideoPlayer extends BasePlayer<PlayerState> {
      * Get player statistics
      */
     getStats(): PlayerStats;
+    /**
+     * Update bandwidth statistics
+     */
+    private updateBandwidthStats;
+    /**
+     * Get packet timing history for visualization/debugging
+     */
+    getPacketTimingHistory(): import('..').PacketTimingEntry[];
     /**
      * Subscribe to player events (typed overload)
      */

package/dist/scheduling/frame-scheduler.d.ts

@@ -42,6 +42,23 @@ export interface SchedulerStatus {
     driftCorrections: number;
     latency: LatencyStats | null;
 }
+/**
+ * Packet timing entry for visualization
+ */
+export interface PacketTimingEntry {
+    /** Time packet arrived (performance.now()) */
+    arrivalTime: number;
+    /** Time since previous packet (ms) */
+    intervalMs: number;
+    /** Stream timestamp (us) */
+    streamTimestampUs: number;
+    /** Whether this was a keyframe */
+    isKeyframe: boolean;
+    /** Decode latency (ms) */
+    decodeLatencyMs: number;
+    /** Whether frame was dropped */
+    wasDropped: boolean;
+}
 export interface SchedulerConfig<T> {
     /** Target buffer delay in milliseconds (0 = bypass mode, always return latest) */
     bufferDelayMs?: number;
@@ -81,6 +98,9 @@ export declare class FrameScheduler<T> {
     private dequeueCount;
     private latencyHistory;
     private latencyHistorySize;
+    private packetTimingHistory;
+    private packetTimingHistorySize;
+    private lastPacketArrivalTime;
     private stats;
     private logger;
     private onFrameDropped?;
@@ -90,7 +110,7 @@ export declare class FrameScheduler<T> {
     /** Effective drift threshold - scales with buffer target for low-latency mode */
     private get effectiveDriftThresholdMs();
     /** Enqueue a decoded frame with timing information */
-    enqueue(frame: T, timestampUs: number, timing: FrameTiming): void;
+    enqueue(frame: T, timestampUs: number, timing: FrameTiming, isKeyframe?: boolean): void;
     /** Dequeue frame for rendering at given real time (milliseconds) */
     dequeue(realTimeMs: number): T | null;
     /** Bypass mode: return latest frame, drop rest */
@@ -119,4 +139,6 @@ export declare class FrameScheduler<T> {
     logStatus(): void;
     /** Reset statistics */
     resetStats(): void;
+    /** Get packet timing history for visualization */
+    getPacketTimingHistory(): PacketTimingEntry[];
 }

package/dist/sources/mp4-file-source.d.ts

@@ -18,6 +18,7 @@ export interface MP4FileInfo {
     bitrate?: number;
     audioChannels?: number;
     audioSampleRate?: number;
+    isMoovAtStart?: boolean;
 }
 /**
  * Sample ready for decoding