@rivmux/protocol 0.4.0 → 1.0.0-rc.1

package/README.md

@@ -1,3 +1,14 @@
 # Rivmux Protocol
 
-Protocol TypeScript contracts used by Rivmux browser packages.
+`@rivmux/protocol` 提供 Rivmux 浏览器包共享的 TypeScript 类型与 Worker 消息契约。
+
+该包面向内部包边界维护，不是普通用户的播放器入口。`rivmux` 会重新导出用户需要的选项、事件、错误、媒体信息和能力矩阵类型；应用代码应优先依赖 `rivmux`。
+
+关键导出包括：
+
+- `RivmuxPlayerOptions` 及各分组配置类型。
+- `PlayerEventMap`、`PlayerError`、`PlayerWarning` 和重连信息类型；播放器初始化事件为 `initialized`。
+- `RivmuxCapabilities`、`RuntimeCapabilities`、`DecodingCapabilities` 与 `SupportStatus`。
+- 主线程与 Dedicated Worker 之间使用的生命周期、媒体和诊断消息契约。Worker 选项在 `init` 命令中一次性传入；当前不提供动态选项更新命令。
+
+协议变更必须同步更新播放器、Worker 和对应测试；公开类型当前采用手动维护方式。

package/dist/capabilities.d.ts

@@ -0,0 +1,29 @@
+export type SupportStatus = 'supported' | 'unsupported' | 'unknown';
+export interface RuntimeCapabilities {
+    dedicatedWorker: boolean;
+    workerMse: boolean;
+    fetchStreaming: boolean;
+    readableStream: boolean;
+    webAssembly: boolean;
+}
+export interface DecodingCapabilities {
+    video: {
+        avc: SupportStatus;
+        hevc: SupportStatus;
+        av1: SupportStatus;
+    };
+    audio: {
+        aac: SupportStatus;
+        opus: SupportStatus;
+    };
+    stableProfiles: {
+        avcAac: SupportStatus;
+        hevcAac: SupportStatus;
+    };
+}
+export interface RivmuxCapabilities {
+    supported: boolean;
+    runtime: RuntimeCapabilities;
+    decoding: DecodingCapabilities;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAA;AAEnE,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,OAAO,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QACL,GAAG,EAAE,aAAa,CAAA;QAClB,IAAI,EAAE,aAAa,CAAA;QACnB,GAAG,EAAE,aAAa,CAAA;KACnB,CAAA;IACD,KAAK,EAAE;QACL,GAAG,EAAE,aAAa,CAAA;QAClB,IAAI,EAAE,aAAa,CAAA;KACpB,CAAA;IACD,cAAc,EAAE;QACd,MAAM,EAAE,aAAa,CAAA;QACrB,OAAO,EAAE,aAAa,CAAA;KACvB,CAAA;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,QAAQ,EAAE,oBAAoB,CAAA;CAC/B"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,45 @@
+/** 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';
+/** Serializable error details carried across the Worker boundary. */
+export type PlayerErrorCause = {
+    name: string;
+    message: string;
+};
+/** Structured error emitted by the player and runtime. */
+export type PlayerError = {
+    kind: PlayerErrorKind;
+    code: string;
+    message: string;
+    terminal: boolean;
+    cause?: PlayerErrorCause;
+};
+/** Structured recoverable warning emitted by the player and runtime. */
+export type PlayerWarning = {
+    code: string;
+    message: string;
+    cause?: PlayerErrorCause;
+};
+//# 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,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,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,gBAAgB,CAAA;CACzB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB,CAAA"}

package/dist/events.d.ts

@@ -0,0 +1,39 @@
+import type { MediaInfo } from './media';
+import type { PlayerError, PlayerStats, PlayerWarning } from './diagnostics';
+/** Network failure category that caused a live stream reconnect. */
+export type ReconnectReason = 'http-status' | 'network-error' | 'read-error' | 'read-timeout' | 'unexpected-eof';
+/** Details emitted after the runtime schedules another connection attempt. */
+export type ReconnectInfo = {
+    /** One-based connection attempt number within the current recovery cycle. */
+    attempt: number;
+    /** Maximum connection attempts in the current recovery cycle, including the failed connection. */
+    maxAttempts: number;
+    /** Delay before the next connection attempt starts. */
+    delayMs: number;
+    /** Failure category that caused this recovery cycle. */
+    reason: ReconnectReason;
+};
+/** Details emitted after a reconnected session appends its first media segment. */
+export type RecoveryInfo = {
+    /** Connection attempt that successfully recovered playback. */
+    attempt: number;
+    /** Elapsed time between the recoverable failure and recovery. */
+    downtimeMs: number;
+};
+/** Payload map for player events. */
+export type PlayerEventMap = {
+    initialized: undefined;
+    mediaInfo: MediaInfo;
+    stats: PlayerStats;
+    warning: PlayerWarning;
+    error: PlayerError;
+    reconnecting: ReconnectInfo;
+    recovered: RecoveryInfo;
+    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,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAA;AAEhH,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,MAAM,EAAE,eAAe,CAAA;CACxB,CAAA;AAED,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG;IACzB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,SAAS,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,aAAa,CAAA;IACtB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,aAAa,CAAA;IAC3B,SAAS,EAAE,YAAY,CAAA;IACvB,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,267 +1,7 @@
-/** 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;
-};
-/** 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 './capabilities';
+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,gBAAgB,CAAA;AACnC,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,53 @@
+/** 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';
+};
+/** Structured, clone-safe failure returned for a playback operation. */
+export type PlaybackControlError = {
+    name: string;
+    message: string;
+};
+/** Result of applying a worker-requested playback operation. */
+export type PlaybackControlResult = {
+    type: PlaybackControlAction['type'];
+    accepted: true;
+} | {
+    type: PlaybackControlAction['type'];
+    accepted: false;
+    error: PlaybackControlError;
+};
+//# 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,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,IAAI,CAAA;CACf,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,KAAK,CAAA;IACf,KAAK,EAAE,oBAAoB,CAAA;CAC5B,CAAA"}

package/dist/options.d.ts

@@ -0,0 +1,89 @@
+/** 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;
+    /** Maximum time without a stream chunk while reads are active, in milliseconds. */
+    readIdleTimeoutMs?: number;
+    /** Retry policy for recoverable stream request failures. */
+    retry?: {
+        /** Maximum connection attempts per recovery cycle, including the current connection. */
+        maxAttempts?: number;
+        /** Base exponential retry delay in milliseconds. */
+        backoffMs?: number;
+        /** Maximum retry delay after jitter is applied, in milliseconds. */
+        maxBackoffMs?: number;
+        /** Symmetric jitter ratio in the inclusive range from 0 to 1. */
+        jitterRatio?: number;
+    };
+};
+/** Advanced runtime asset deployment options. */
+export type RuntimeOptions = {
+    /** Overrides the packaged Dedicated Worker script URL. */
+    workerUrl?: string;
+    /** Overrides the WASM binary URL used by the packaged wasm-bindgen runtime. */
+    wasmUrl?: string;
+};
+/** Runtime diagnostics reporting options. */
+export type DiagnosticsOptions = {
+    /** Requested runtime stats interval in milliseconds. */
+    statsIntervalMs?: number;
+};
+/** 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;
+    readIdleTimeoutMs: number;
+    retry: {
+        maxAttempts: number;
+        backoffMs: number;
+        maxBackoffMs: number;
+        jitterRatio: number;
+    };
+};
+export type NormalizedRuntimeOptions = {
+    workerUrl?: string;
+    wasmUrl?: string;
+};
+export type NormalizedDiagnosticsOptions = {
+    statsIntervalMs: number;
+};
+/** 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":"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"}

package/dist/worker.d.ts

@@ -0,0 +1,62 @@
+import type { PlayerError, PlayerStats, PlayerWarning } from './diagnostics';
+import type { ReconnectInfo, RecoveryInfo } from './events';
+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: '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: 'started';
+} | {
+    type: 'media-info';
+    mediaInfo: MediaInfo;
+} | {
+    type: 'stats';
+    stats: PlayerStats;
+} | {
+    type: 'warning';
+    warning: PlayerWarning;
+} | {
+    type: 'error';
+    error: PlayerError;
+} | {
+    type: 'reconnecting';
+    info: ReconnectInfo;
+} | {
+    type: 'recovered';
+    info: RecoveryInfo;
+} | {
+    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,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC3D,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,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,SAAS,CAAA;CAAE,GACnB;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,cAAc,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACzC;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.4.0",
+  "version": "1.0.0-rc.1",
   "description": "Protocol TypeScript contracts for Rivmux packages.",
   "homepage": "https://www.npmjs.com/package/@rivmux/protocol",
   "bugs": {
@@ -28,11 +28,7 @@
   "types": "./dist/index.d.ts",
   "devDependencies": {
     "typescript": "~6.0.3",
-    "vitest": "^4.1.10"
-  },
-  "engines": {
-    "node": "^22.18.0 || >=24.11.0",
-    "pnpm": ">=10.0.0"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "tsc -b",