@rivmux/protocol 0.5.0 → 1.0.0

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

@@ -23,18 +23,23 @@ export type PlayerStats = {
 };
 /** 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?: unknown;
+    cause?: PlayerErrorCause;
 };
 /** Structured recoverable warning emitted by the player and runtime. */
 export type PlayerWarning = {
     code: string;
     message: string;
-    cause?: unknown;
+    cause?: PlayerErrorCause;
 };
 //# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -1 +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"}
+{"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

@@ -1,12 +1,34 @@
 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 = {
-    ready: undefined;
+    initialized: undefined;
     mediaInfo: MediaInfo;
     stats: PlayerStats;
     warning: PlayerWarning;
     error: PlayerError;
+    reconnecting: ReconnectInfo;
+    recovered: RecoveryInfo;
     stopped: undefined;
     destroyed: undefined;
 };

package/dist/events.d.ts.map

@@ -1 +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"}
+{"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,3 +1,4 @@
+export type * from './capabilities';
 export type * from './diagnostics';
 export type * from './events';
 export type * from './media';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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

@@ -36,10 +36,18 @@ export type PlaybackControlAction = {
     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: boolean;
-    message?: string;
+    accepted: true;
+} | {
+    type: PlaybackControlAction['type'];
+    accepted: false;
+    error: PlaybackControlError;
 };
 //# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -1 +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"}
+{"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

@@ -24,29 +24,31 @@ export type NetworkOptions = {
     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 number of attempts for a stream request. */
+        /** Maximum connection attempts per recovery cycle, including the current connection. */
         maxAttempts?: number;
-        /** Base retry delay in milliseconds. */
+        /** 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 = {
-    /** 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. */
+/** Runtime diagnostics 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 = {
@@ -61,17 +63,21 @@ 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 = {
-    preferWorkerMse: boolean;
     workerUrl?: string;
     wasmUrl?: string;
 };
-export type NormalizedDiagnosticsOptions = Required<DiagnosticsOptions>;
+export type NormalizedDiagnosticsOptions = {
+    statsIntervalMs: number;
+};
 /** Fully populated player options after defaults are applied. */
 export type NormalizedRivmuxPlayerOptions = {
     playback: NormalizedPlaybackOptions;

package/dist/options.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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"}

package/dist/worker.d.ts

@@ -1,4 +1,5 @@
 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. */
@@ -13,9 +14,6 @@ export type WorkerCommand = {
     type: 'start';
 } | {
     type: 'stop';
-} | {
-    type: 'update-options';
-    options: Partial<NormalizedRivmuxPlayerOptions>;
 } | {
     type: 'video-state';
     state: VideoElementState;
@@ -33,6 +31,8 @@ export type WorkerMessage = {
 } | {
     type: 'media-source-handle';
     handle: MediaSourceHandle;
+} | {
+    type: 'started';
 } | {
     type: 'media-info';
     mediaInfo: MediaInfo;
@@ -45,6 +45,12 @@ export type WorkerMessage = {
 } | {
     type: 'error';
     error: PlayerError;
+} | {
+    type: 'reconnecting';
+    info: ReconnectInfo;
+} | {
+    type: 'recovered';
+    info: RecoveryInfo;
 } | {
     type: 'playback-control';
     action: PlaybackControlAction;

package/dist/worker.d.ts.map

@@ -1 +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"}
+{"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.5.0",
+  "version": "1.0.0",
   "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",