@rivmux/protocol 0.3.0 → 0.5.0

package/README.md

@@ -1,3 +1,3 @@
-# Rivmux Shared
+# Rivmux Protocol
 
-Shared TypeScript contracts used by Rivmux browser packages.
+Protocol TypeScript contracts used by Rivmux browser packages.

package/dist/diagnostics.d.ts

@@ -0,0 +1,40 @@
+/** Runtime diagnostics emitted by the `stats` event. */
+export type PlayerStats = {
+    bytesReceived?: number;
+    currentNetworkSpeed?: number;
+    networkIdleMs?: number;
+    outputBytes?: number;
+    appendQueueLength?: number;
+    appendQueueBytes?: number;
+    appendQueueMaxLength?: number;
+    appendQueueMaxBytes?: number;
+    loaderPaused?: boolean;
+    sourceBufferUpdating?: boolean;
+    sourceBufferCount?: number;
+    bufferedStart?: number;
+    bufferedEnd?: number;
+    bufferedDuration?: number;
+    bufferedRangeCount?: number;
+    currentTime?: number;
+    liveLatency?: number;
+    playbackRate?: number;
+    readyState?: number;
+    droppedFrames?: number;
+};
+/** High-level category for a player error. */
+export type PlayerErrorKind = 'network' | 'unsupported' | 'demux' | 'codec' | 'mux' | 'mse' | 'runtime';
+/** Structured error emitted by the player and runtime. */
+export type PlayerError = {
+    kind: PlayerErrorKind;
+    code: string;
+    message: string;
+    terminal: boolean;
+    cause?: unknown;
+};
+/** Structured recoverable warning emitted by the player and runtime. */
+export type PlayerWarning = {
+    code: string;
+    message: string;
+    cause?: unknown;
+};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;AAEvG,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA"}

package/dist/events.d.ts

@@ -0,0 +1,17 @@
+import type { MediaInfo } from './media';
+import type { PlayerError, PlayerStats, PlayerWarning } from './diagnostics';
+/** Payload map for player events. */
+export type PlayerEventMap = {
+    ready: undefined;
+    mediaInfo: MediaInfo;
+    stats: PlayerStats;
+    warning: PlayerWarning;
+    error: PlayerError;
+    stopped: undefined;
+    destroyed: undefined;
+};
+/** Player event name. */
+export type PlayerEventType = keyof PlayerEventMap;
+/** Typed player event listener. */
+export type PlayerEventListener<T extends PlayerEventType> = (payload: PlayerEventMap[T]) => void;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE5E,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,aAAa,CAAA;IACtB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,SAAS,EAAE,SAAS,CAAA;CACrB,CAAA;AAED,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAA;AAElD,mCAAmC;AACnC,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA"}

package/dist/index.d.ts

@@ -1,270 +1,6 @@
-/** Playback behavior applied to the attached video element. */
-export type PlaybackOptions = {
-    /** Request playback automatically after the startup buffer is ready. */
-    autoPlay?: boolean;
-    /** Sets `HTMLVideoElement.muted` before playback starts. */
-    muted?: boolean;
-};
-/** Low-latency live playback policy, expressed in seconds. */
-export type LatencyOptions = {
-    /** Minimum buffered duration required before automatic playback starts. */
-    startupBuffer?: number;
-    /** Desired live latency behind the live edge. */
-    target?: number;
-    /** Maximum live latency before the runtime seeks closer to the live edge. */
-    max?: number;
-    /** Forward buffer threshold where the stream loader may pause. */
-    maxForwardBuffer?: number;
-    /** Buffered duration to keep behind the current playhead during cleanup. */
-    backwardBuffer?: number;
-};
-/** HTTP request settings for stream loading. */
-export type NetworkOptions = {
-    /** Additional request headers sent with stream fetch requests. */
-    headers?: Record<string, string>;
-    /** Fetch credentials mode used for stream requests. */
-    credentials?: RequestCredentials;
-    /** Retry policy for recoverable stream request failures. */
-    retry?: {
-        /** Maximum number of attempts for a stream request. */
-        maxAttempts?: number;
-        /** Base retry delay in milliseconds. */
-        backoffMs?: number;
-    };
-};
-/** Runtime asset and worker selection options. */
-export type RuntimeOptions = {
-    /** Must remain true while M1 supports only worker-backed Media Source Extensions. */
-    preferWorkerMse?: boolean;
-    /** Overrides the worker script URL used by the default runtime. */
-    workerUrl?: string;
-    /**
-     * Overrides the WASM asset URL. The matching wasm-bindgen JS glue file must
-     * be available at the same path with `.js` instead of `.wasm`.
-     */
-    wasmUrl?: string;
-};
-/** Diagnostics and debug reporting options. */
-export type DiagnosticsOptions = {
-    /** Requested runtime stats interval in milliseconds. */
-    statsIntervalMs?: number;
-    /** Enables debug-oriented behavior where supported by the runtime. */
-    debug?: boolean;
-};
-/** Top-level options accepted by `new RivmuxPlayer(url, options)`. */
-export type RivmuxPlayerOptions = {
-    playback?: PlaybackOptions;
-    latency?: LatencyOptions;
-    network?: NetworkOptions;
-    runtime?: RuntimeOptions;
-    diagnostics?: DiagnosticsOptions;
-};
-export type NormalizedPlaybackOptions = Required<PlaybackOptions>;
-export type NormalizedLatencyOptions = Required<LatencyOptions>;
-export type NormalizedNetworkOptions = {
-    headers: Record<string, string>;
-    credentials: RequestCredentials;
-    retry: {
-        maxAttempts: number;
-        backoffMs: number;
-    };
-};
-export type NormalizedRuntimeOptions = {
-    preferWorkerMse: boolean;
-    workerUrl?: string;
-    wasmUrl?: string;
-};
-export type NormalizedDiagnosticsOptions = Required<DiagnosticsOptions>;
-/** Fully populated player options after defaults are applied. */
-export type NormalizedRivmuxPlayerOptions = {
-    playback: NormalizedPlaybackOptions;
-    latency: NormalizedLatencyOptions;
-    network: NormalizedNetworkOptions;
-    runtime: NormalizedRuntimeOptions;
-    diagnostics: NormalizedDiagnosticsOptions;
-};
-/** Container, codec, and track metadata detected from the stream. */
-export type MediaInfo = {
-    /** Detected media container, such as `flv` or `fmp4`. */
-    container: string;
-    /** Video codec string when the stream contains video. */
-    videoCodec?: string;
-    /** Audio codec string when the stream contains audio. */
-    audioCodec?: string;
-    /** Video width in pixels. */
-    width?: number;
-    /** Video height in pixels. */
-    height?: number;
-    /** Audio sample rate in Hz. */
-    audioSampleRate?: number;
-    /** Number of audio channels. */
-    audioChannelCount?: number;
-};
-/** Runtime diagnostics emitted by the `stats` event. */
-export type PlayerStats = {
-    /** Number of source bytes received from the stream loader. */
-    bytesReceived?: number;
-    /** Current estimated network speed in bytes per second. */
-    currentNetworkSpeed?: number;
-    /** Duration since the last network chunk, in milliseconds. */
-    networkIdleMs?: number;
-    /** Number of transmuxed bytes emitted to MSE. */
-    outputBytes?: number;
-    /** Number of media segments waiting to be appended. */
-    appendQueueLength?: number;
-    /** Total bytes waiting in the append queue. */
-    appendQueueBytes?: number;
-    /** Maximum append queue length observed in the current session. */
-    appendQueueMaxLength?: number;
-    /** Maximum append queue bytes observed in the current session. */
-    appendQueueMaxBytes?: number;
-    /** Whether the loader is paused by latency/buffer policy. */
-    loaderPaused?: boolean;
-    /** Whether any SourceBuffer is currently updating. */
-    sourceBufferUpdating?: boolean;
-    /** Number of active SourceBuffer instances. */
-    sourceBufferCount?: number;
-    /** Start time of the buffered range used for latency calculations. */
-    bufferedStart?: number;
-    /** End time of the buffered range used for latency calculations. */
-    bufferedEnd?: number;
-    /** Buffered duration ahead of the current playhead. */
-    bufferedDuration?: number;
-    /** Number of buffered ranges on the attached video element. */
-    bufferedRangeCount?: number;
-    /** Current video playhead time. */
-    currentTime?: number;
-    /** Estimated live latency in seconds. */
-    liveLatency?: number;
-    /** Current video playback rate. */
-    playbackRate?: number;
-    /** Current `HTMLMediaElement.readyState`. */
-    readyState?: number;
-    /** Dropped video frame count when the browser exposes it. */
-    droppedFrames?: number;
-};
-/** Snapshot of the attached video element sent from the player to the worker. */
-export type VideoElementState = {
-    currentTime: number;
-    readyState: number;
-    playbackRate: number;
-    paused: boolean;
-    droppedFrames?: number;
-};
-/** Playback operation requested by the worker-side latency controller. */
-export type PlaybackControlAction = {
-    type: 'play';
-    reason: 'startup-buffer-ready';
-} | {
-    type: 'set-playback-rate';
-    playbackRate: number;
-    reason: 'latency-above-target' | 'latency-near-target';
-} | {
-    type: 'seek';
-    targetTime: number;
-    reason: 'latency-max-exceeded';
-};
-/** Result of applying a worker-requested playback operation. */
-export type PlaybackControlResult = {
-    type: PlaybackControlAction['type'];
-    accepted: boolean;
-    message?: string;
-};
-/** High-level category for a player error. */
-export type PlayerErrorKind = 'network' | 'unsupported' | 'demux' | 'codec' | 'mux' | 'mse' | 'runtime';
-/** Structured error emitted by the player and runtime. */
-export type PlayerError = {
-    /** Broad error category. */
-    kind: PlayerErrorKind;
-    /** Stable machine-readable error code. */
-    code: string;
-    /** Human-readable error message. */
-    message: string;
-    /** Whether playback should be treated as unrecoverable. */
-    terminal: boolean;
-    /** Optional underlying error or diagnostic payload. */
-    cause?: unknown;
-};
-/** Structured recoverable warning emitted by the player and runtime. */
-export type PlayerWarning = {
-    /** Stable machine-readable warning code. */
-    code: string;
-    /** Human-readable warning message. */
-    message: string;
-    /** Optional underlying warning payload. */
-    cause?: unknown;
-};
-/** Payload map for player events. */
-export type PlayerEventMap = {
-    /** Worker/runtime initialization completed. */
-    ready: undefined;
-    /** Stream metadata was detected. */
-    mediaInfo: MediaInfo;
-    /** Runtime diagnostics were sampled. */
-    stats: PlayerStats;
-    /** A recoverable runtime warning occurred. */
-    warning: PlayerWarning;
-    /** A structured runtime error occurred. */
-    error: PlayerError;
-    /** The stream stopped and the media source was detached. */
-    stopped: undefined;
-    /** The worker/runtime was destroyed. */
-    destroyed: undefined;
-};
-/** Player event name. */
-export type PlayerEventType = keyof PlayerEventMap;
-/** Typed player event listener. */
-export type PlayerEventListener<T extends PlayerEventType> = (payload: PlayerEventMap[T]) => void;
-/** Command sent from the player facade to the runtime worker. */
-export type WorkerCommand = {
-    type: 'init';
-    id: string;
-    url: string;
-    options: NormalizedRivmuxPlayerOptions;
-} | {
-    type: 'attach-media-source';
-} | {
-    type: 'start';
-} | {
-    type: 'stop';
-} | {
-    type: 'update-options';
-    options: Partial<NormalizedRivmuxPlayerOptions>;
-} | {
-    type: 'video-state';
-    state: VideoElementState;
-} | {
-    type: 'playback-control-result';
-    result: PlaybackControlResult;
-} | {
-    type: 'destroy';
-};
-/** Message sent from the runtime worker to the player facade. */
-export type WorkerMessage = {
-    type: 'worker-ready';
-} | {
-    type: 'ready';
-} | {
-    type: 'media-source-handle';
-    handle: MediaSourceHandle;
-} | {
-    type: 'media-info';
-    mediaInfo: MediaInfo;
-} | {
-    type: 'stats';
-    stats: PlayerStats;
-} | {
-    type: 'warning';
-    warning: PlayerWarning;
-} | {
-    type: 'error';
-    error: PlayerError;
-} | {
-    type: 'playback-control';
-    action: PlaybackControlAction;
-} | {
-    type: 'stopped';
-} | {
-    type: 'destroyed';
-};
+export type * from './diagnostics';
+export type * from './events';
+export type * from './media';
+export type * from './options';
+export type * from './worker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,SAAS,CAAA;AAC5B,mBAAmB,WAAW,CAAA;AAC9B,mBAAmB,UAAU,CAAA"}

package/dist/media.d.ts

@@ -0,0 +1,45 @@
+/** Container, codec, and track metadata detected from the stream. */
+export type MediaInfo = {
+    /** Detected media container, such as `flv` or `fmp4`. */
+    container: string;
+    /** Video codec string when the stream contains video. */
+    videoCodec?: string;
+    /** Audio codec string when the stream contains audio. */
+    audioCodec?: string;
+    /** Video width in pixels. */
+    width?: number;
+    /** Video height in pixels. */
+    height?: number;
+    /** Audio sample rate in Hz. */
+    audioSampleRate?: number;
+    /** Number of audio channels. */
+    audioChannelCount?: number;
+};
+/** Snapshot of the attached video element sent from the player to the worker. */
+export type VideoElementState = {
+    currentTime: number;
+    readyState: number;
+    playbackRate: number;
+    paused: boolean;
+    droppedFrames?: number;
+};
+/** Playback operation requested by the worker-side latency controller. */
+export type PlaybackControlAction = {
+    type: 'play';
+    reason: 'startup-buffer-ready';
+} | {
+    type: 'set-playback-rate';
+    playbackRate: number;
+    reason: 'latency-above-target' | 'latency-near-target';
+} | {
+    type: 'seek';
+    targetTime: number;
+    reason: 'latency-max-exceeded';
+};
+/** Result of applying a worker-requested playback operation. */
+export type PlaybackControlResult = {
+    type: PlaybackControlAction['type'];
+    accepted: boolean;
+    message?: string;
+};
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG;IACtB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,sBAAsB,GAAG,qBAAqB,CAAA;CAAE,GAC3G;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,CAAA;AAExE,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA"}

package/dist/options.d.ts

@@ -0,0 +1,83 @@
+/** Playback behavior applied to the attached video element. */
+export type PlaybackOptions = {
+    /** Request playback automatically after the startup buffer is ready. */
+    autoPlay?: boolean;
+    /** Sets `HTMLVideoElement.muted` before playback starts. */
+    muted?: boolean;
+};
+/** Low-latency live playback policy, expressed in seconds. */
+export type LatencyOptions = {
+    /** Minimum buffered duration required before automatic playback starts. */
+    startupBuffer?: number;
+    /** Desired live latency behind the live edge. */
+    target?: number;
+    /** Maximum live latency before the runtime seeks closer to the live edge. */
+    max?: number;
+    /** Forward buffer threshold where the stream loader may pause. */
+    maxForwardBuffer?: number;
+    /** Buffered duration to keep behind the current playhead during cleanup. */
+    backwardBuffer?: number;
+};
+/** HTTP request settings for stream loading. */
+export type NetworkOptions = {
+    /** Additional request headers sent with stream fetch requests. */
+    headers?: Record<string, string>;
+    /** Fetch credentials mode used for stream requests. */
+    credentials?: RequestCredentials;
+    /** Retry policy for recoverable stream request failures. */
+    retry?: {
+        /** Maximum number of attempts for a stream request. */
+        maxAttempts?: number;
+        /** Base retry delay in milliseconds. */
+        backoffMs?: number;
+    };
+};
+/** Advanced runtime asset deployment options. */
+export type RuntimeOptions = {
+    /** Must remain true while M1 supports only worker-backed Media Source Extensions. */
+    preferWorkerMse?: boolean;
+    /** Overrides the packaged Dedicated Worker script URL. */
+    workerUrl?: string;
+    /** Overrides the WASM binary URL used by the packaged wasm-bindgen runtime. */
+    wasmUrl?: string;
+};
+/** Diagnostics and debug reporting options. */
+export type DiagnosticsOptions = {
+    /** Requested runtime stats interval in milliseconds. */
+    statsIntervalMs?: number;
+    /** Enables debug-oriented behavior where supported by the runtime. */
+    debug?: boolean;
+};
+/** Top-level options accepted by `new RivmuxPlayer(url, options)`. */
+export type RivmuxPlayerOptions = {
+    playback?: PlaybackOptions;
+    latency?: LatencyOptions;
+    network?: NetworkOptions;
+    runtime?: RuntimeOptions;
+    diagnostics?: DiagnosticsOptions;
+};
+export type NormalizedPlaybackOptions = Required<PlaybackOptions>;
+export type NormalizedLatencyOptions = Required<LatencyOptions>;
+export type NormalizedNetworkOptions = {
+    headers: Record<string, string>;
+    credentials: RequestCredentials;
+    retry: {
+        maxAttempts: number;
+        backoffMs: number;
+    };
+};
+export type NormalizedRuntimeOptions = {
+    preferWorkerMse: boolean;
+    workerUrl?: string;
+    wasmUrl?: string;
+};
+export type NormalizedDiagnosticsOptions = Required<DiagnosticsOptions>;
+/** Fully populated player options after defaults are applied. */
+export type NormalizedRivmuxPlayerOptions = {
+    playback: NormalizedPlaybackOptions;
+    latency: NormalizedLatencyOptions;
+    network: NormalizedNetworkOptions;
+    runtime: NormalizedRuntimeOptions;
+    diagnostics: NormalizedDiagnosticsOptions;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG;IAC3B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG;IAC3B,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,uDAAuD;IACvD,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,4DAA4D;IAC5D,KAAK,CAAC,EAAE;QACN,uDAAuD;QACvD,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,wCAAwC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG;IAC3B,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAA;AACjE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAA;AAE/D,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAA;AAEvE,iEAAiE;AACjE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,yBAAyB,CAAA;IACnC,OAAO,EAAE,wBAAwB,CAAA;IACjC,OAAO,EAAE,wBAAwB,CAAA;IACjC,OAAO,EAAE,wBAAwB,CAAA;IACjC,WAAW,EAAE,4BAA4B,CAAA;CAC1C,CAAA"}

package/dist/worker.d.ts

@@ -0,0 +1,56 @@
+import type { PlayerError, PlayerStats, PlayerWarning } from './diagnostics';
+import type { MediaInfo, PlaybackControlAction, PlaybackControlResult, VideoElementState } from './media';
+import type { NormalizedRivmuxPlayerOptions } from './options';
+/** Command sent from the player facade to the runtime worker. */
+export type WorkerCommand = {
+    type: 'init';
+    id: string;
+    url: string;
+    options: NormalizedRivmuxPlayerOptions;
+} | {
+    type: 'attach-media-source';
+} | {
+    type: 'start';
+} | {
+    type: 'stop';
+} | {
+    type: 'update-options';
+    options: Partial<NormalizedRivmuxPlayerOptions>;
+} | {
+    type: 'video-state';
+    state: VideoElementState;
+} | {
+    type: 'playback-control-result';
+    result: PlaybackControlResult;
+} | {
+    type: 'destroy';
+};
+/** Message sent from the runtime worker to the player facade. */
+export type WorkerMessage = {
+    type: 'worker-ready';
+} | {
+    type: 'ready';
+} | {
+    type: 'media-source-handle';
+    handle: MediaSourceHandle;
+} | {
+    type: 'media-info';
+    mediaInfo: MediaInfo;
+} | {
+    type: 'stats';
+    stats: PlayerStats;
+} | {
+    type: 'warning';
+    warning: PlayerWarning;
+} | {
+    type: 'error';
+    error: PlayerError;
+} | {
+    type: 'playback-control';
+    action: PlaybackControlAction;
+} | {
+    type: 'stopped';
+} | {
+    type: 'destroyed';
+};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACzG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAA;AAE9D,iEAAiE;AACjE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,6BAA6B,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,iEAAiE;AACjE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivmux/protocol",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Protocol TypeScript contracts for Rivmux packages.",
   "homepage": "https://www.npmjs.com/package/@rivmux/protocol",
   "bugs": {
@@ -28,7 +28,7 @@
   "types": "./dist/index.d.ts",
   "devDependencies": {
     "typescript": "~6.0.3",
-    "vitest": "^4.1.9"
+    "vitest": "^4.1.10"
   },
   "engines": {
     "node": "^22.18.0 || >=24.11.0",