@rivmux/runtime-worker 0.5.0 → 1.0.0-rc.1

package/README.md

@@ -1,3 +1,9 @@
 # Rivmux Runtime Worker
 
-Dedicated Worker runtime package for Rivmux media loading and playback orchestration.
+`@rivmux/runtime-worker` 是 Rivmux 主包使用的 Dedicated Worker 运行时，负责 HTTP-FLV 加载、WASM 转封装核心、MSE SourceBuffer、播放延迟控制、重连和生命周期清理。
+
+该包提供 Worker 脚本、WASM 资产和内部生命周期客户端，普通用户不应直接依赖。用户接入请使用 `rivmux`，以获得稳定的播放器 API、类型和错误语义。
+
+当前运行时固定为 Worker MSE；配置在初始化命令中确定，运行期间不支持动态选项更新。播放器公共初始化事件由 facade 暴露为 `initialized`，Worker 内部消息名称不属于公共 API。
+
+维护时需保证 Worker/WASM 资产来自同一次构建，并保持与 `@rivmux/protocol` 的消息契约一致。应用部署必须验证资产 URL、CSP/CORS 和缓存策略，并确保 Worker 与 WASM 资产来自同一版本。

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { NormalizedRivmuxPlayerOptions, PlayerError, WorkerCommand, WorkerMessage } from "@rivmux/protocol";
 //#region src/index.d.ts
-type WorkerLike = Pick<Worker, 'addEventListener' | 'postMessage' | 'removeEventListener' | 'terminate'>;
-type RuntimeWorkerFactory = (options: NormalizedRivmuxPlayerOptions) => WorkerLike;
-type WorkerClientHooks = {
+export type WorkerLike = Pick<Worker, 'addEventListener' | 'postMessage' | 'removeEventListener' | 'terminate'>;
+export type RuntimeWorkerFactory = (options: NormalizedRivmuxPlayerOptions) => WorkerLike;
+export type WorkerClientHooks = {
   onMessage(message: WorkerMessage): void;
   onError(error: PlayerError): void;
 };
@@ -12,42 +12,48 @@ type WorkerClientHooks = {
  * Vite rewrites this static URL during the client build and emits the matching
  * binary next to the application assets.
  */
-declare function getBundledWasmUrl(): string;
-declare class WorkerClient {
+export declare function getBundledWasmUrl(): string;
+export declare class WorkerClient {
   private readonly worker;
   private readonly hooks;
   private readonly handleMessage;
   private readonly handleError;
   private pendingAttach?;
+  private pendingStart?;
   private pendingStop?;
   private pendingDestroy?;
   private workerReady;
   private queuedCommands;
   private attachTimer?;
+  private startedTimer?;
   private stoppedTimer?;
   private destroyedTimer?;
   constructor(worker: WorkerLike, hooks: WorkerClientHooks);
   post(command: WorkerCommand): void;
   waitForMediaSourceHandle(command: WorkerCommand): Promise<void>;
   waitForStopped(command: WorkerCommand): Promise<void>;
+  waitForStarted(command: WorkerCommand): Promise<void>;
   waitForDestroyed(command: WorkerCommand): Promise<void>;
   dispose(): void;
   private handleWorkerMessage;
   private rejectPendingForWorkerError;
   private resolveAttach;
   private resolveStop;
+  private resolveStart;
   private resolveDestroy;
   private rejectAttach;
   private rejectStop;
+  private rejectStart;
   private rejectAll;
   private flushQueuedCommands;
   private startTimeout;
   private failClient;
+  private notifyMessage;
   private clearAttachTimer;
   private clearStoppedTimer;
+  private clearStartedTimer;
   private clearDestroyedTimer;
 }
-declare function createRuntimeWorker(options: NormalizedRivmuxPlayerOptions): WorkerLike;
+export declare function createRuntimeWorker(options: NormalizedRivmuxPlayerOptions): WorkerLike;
 //#endregion
-export { RuntimeWorkerFactory, WorkerClient, WorkerClientHooks, WorkerLike, createRuntimeWorker, getBundledWasmUrl };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;KAIY,aAAa,KAAK;KAElB,wBAAwB,SAAS,kCAAkC;KAOnE;EACV,UAAU,SAAS;EACnB,QAAQ,OAAO;;;;;;;;iBASD;cAMH;mBACM;mBACA;mBACA;mBAGA;UAIT;UACA;UACA;UACA;UACA;UACA;UACA;UACA;cAEI,QAAQ,YAAY,OAAO;EAOvC,KAAK,SAAS;EASd,yBAAyB,SAAS,gBAAgB;EAYlD,eAAe,SAAS,gBAAgB;EAYxC,iBAAiB,SAAS,gBAAgB;EAY1C;UAOQ;UA+BA;UAQA;UAMA;UAMA;UAMA;UAMA;UAMA;UAaA;UAaA;UAQA;UAKA;UAOA;UAOA;;iBAQM,oBAAoB,SAAS,gCAAgC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;YAIY,aAAa,KAAK;YAElB,wBAAwB,SAAS,kCAAkC;YAOnE;EACV,UAAU,SAAS;EACnB,QAAQ,OAAO;;;;;;;;wBASD;qBAMH;mBACM;mBACA;mBACA;mBAGA;UAIT;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;EAEI,YAAA,QAAQ,YAAY,OAAO;EAOvC,KAAK,SAAS;EASd,yBAAyB,SAAS,gBAAgB;EAYlD,eAAe,SAAS,gBAAgB;EAYxC,eAAe,SAAS,gBAAgB;EAYxC,iBAAiB,SAAS,gBAAgB;EAY1C;UAOQ;UA4CA;UAQA;UAMA;UAMA;UAMA;UAMA;UAMA;UAMA;UAMA;UAgBA;UAaA;UAQA;UASA;UAQA;UAOA;UAOA;UAOA;;wBA0BM,oBAAoB,SAAS,gCAAgC"}

package/dist/index.js

@@ -21,11 +21,13 @@ var WorkerClient = class {
 		this.failClient(error);
 	};
 	pendingAttach;
+	pendingStart;
 	pendingStop;
 	pendingDestroy;
 	workerReady = false;
 	queuedCommands = [];
 	attachTimer;
+	startedTimer;
 	stoppedTimer;
 	destroyedTimer;
 	constructor(worker, hooks) {
@@ -63,6 +65,17 @@ var WorkerClient = class {
 			this.post(command);
 		});
 	}
+	waitForStarted(command) {
+		if (this.pendingStart !== void 0) return Promise.reject(createRuntimeWorkerError("RIVMUX_START_IN_PROGRESS", "A start request is already pending.", false));
+		return new Promise((resolve, reject) => {
+			this.pendingStart = {
+				resolve,
+				reject
+			};
+			this.startedTimer = this.startTimeout("RIVMUX_START_TIMEOUT", "Timed out waiting for worker start.", reject);
+			this.post(command);
+		});
+	}
 	waitForDestroyed(command) {
 		if (this.pendingDestroy !== void 0) return Promise.reject(createRuntimeWorkerError("RIVMUX_DESTROY_IN_PROGRESS", "A destroy request is already pending.", false));
 		return new Promise((resolve, reject) => {
@@ -85,23 +98,37 @@ var WorkerClient = class {
 			this.flushQueuedCommands();
 			return;
 		}
-		this.hooks.onMessage(message);
 		if (message.type === "media-source-handle") {
 			this.resolveAttach();
+			this.notifyMessage(message);
+			return;
+		}
+		if (message.type === "started") {
+			this.resolveStart();
+			this.notifyMessage(message);
 			return;
 		}
 		if (message.type === "stopped") {
 			this.rejectAttach(createRuntimeWorkerError("RIVMUX_ATTACH_CANCELLED", "Media source attachment was cancelled by stop.", false));
+			this.rejectStart(createRuntimeWorkerError("RIVMUX_START_CANCELLED", "Start was cancelled by stop.", false));
 			this.resolveStop();
+			this.notifyMessage(message);
 			return;
 		}
 		if (message.type === "destroyed") {
 			this.resolveDestroy();
 			this.rejectAttach(createRuntimeWorkerError("RIVMUX_ATTACH_CANCELLED", "Media source attachment was cancelled by destroy.", false));
+			this.rejectStart(createRuntimeWorkerError("RIVMUX_START_CANCELLED", "Start was cancelled by destroy.", false));
 			this.rejectStop(createRuntimeWorkerError("RIVMUX_STOP_CANCELLED", "Stop was superseded by destroy.", false));
+			this.notifyMessage(message);
+			return;
+		}
+		if (message.type === "error") {
+			this.rejectPendingForWorkerError(message.error);
+			this.notifyMessage(message);
 			return;
 		}
-		if (message.type === "error") this.rejectPendingForWorkerError(message.error);
+		this.notifyMessage(message);
 	}
 	rejectPendingForWorkerError(error) {
 		if (!error.terminal) return;
@@ -117,6 +144,11 @@ var WorkerClient = class {
 		this.pendingStop?.resolve();
 		this.pendingStop = void 0;
 	}
+	resolveStart() {
+		this.clearStartedTimer();
+		this.pendingStart?.resolve();
+		this.pendingStart = void 0;
+	}
 	resolveDestroy() {
 		this.clearDestroyedTimer();
 		this.pendingDestroy?.resolve();
@@ -132,15 +164,23 @@ var WorkerClient = class {
 		this.pendingStop?.reject(error);
 		this.pendingStop = void 0;
 	}
+	rejectStart(error) {
+		this.clearStartedTimer();
+		this.pendingStart?.reject(error);
+		this.pendingStart = void 0;
+	}
 	rejectAll(error) {
 		this.queuedCommands = [];
 		this.clearAttachTimer();
+		this.clearStartedTimer();
 		this.clearStoppedTimer();
 		this.clearDestroyedTimer();
 		this.pendingAttach?.reject(error);
+		this.pendingStart?.reject(error);
 		this.pendingStop?.reject(error);
 		this.pendingDestroy?.reject(error);
 		this.pendingAttach = void 0;
+		this.pendingStart = void 0;
 		this.pendingStop = void 0;
 		this.pendingDestroy = void 0;
 	}
@@ -160,7 +200,18 @@ var WorkerClient = class {
 	}
 	failClient(error) {
 		this.rejectAll(error);
-		this.hooks.onError(error);
+		try {
+			this.hooks.onError(error);
+		} catch (hookError) {
+			reportHookError(hookError);
+		}
+	}
+	notifyMessage(message) {
+		try {
+			this.hooks.onMessage(message);
+		} catch (error) {
+			reportHookError(error);
+		}
 	}
 	clearAttachTimer() {
 		if (this.attachTimer !== void 0) {
@@ -174,6 +225,12 @@ var WorkerClient = class {
 			this.stoppedTimer = void 0;
 		}
 	}
+	clearStartedTimer() {
+		if (this.startedTimer !== void 0) {
+			clearTimeout(this.startedTimer);
+			this.startedTimer = void 0;
+		}
+	}
 	clearDestroyedTimer() {
 		if (this.destroyedTimer !== void 0) {
 			clearTimeout(this.destroyedTimer);
@@ -181,6 +238,18 @@ var WorkerClient = class {
 		}
 	}
 };
+function reportHookError(error) {
+	try {
+		const reportError = globalThis.reportError;
+		if (typeof reportError === "function") {
+			reportError(error);
+			return;
+		}
+	} catch {}
+	try {
+		globalThis.console?.error(error);
+	} catch {}
+}
 function createRuntimeWorker(options) {
 	const url = options.runtime.workerUrl === void 0 ? new URL("./rivmux-runtime-worker.js", import.meta.url) : options.runtime.workerUrl;
 	return new Worker(url, {
@@ -189,17 +258,35 @@ function createRuntimeWorker(options) {
 	});
 }
 function createRuntimeWorkerError(code, message, terminal, cause) {
-	return cause === void 0 ? {
+	if (cause === void 0) return {
 		kind: "runtime",
 		code,
 		message,
 		terminal
-	} : {
+	};
+	return {
 		kind: "runtime",
 		code,
 		message,
 		terminal,
-		cause
+		cause: serializeCause(cause)
+	};
+}
+function serializeCause(cause) {
+	if (cause instanceof Error) return {
+		name: cause.name,
+		message: cause.message
+	};
+	if (typeof cause === "object" && cause !== null) {
+		const value = cause;
+		return {
+			name: typeof value.name === "string" ? value.name : "Error",
+			message: typeof value.message === "string" ? value.message : String(cause)
+		};
+	}
+	return {
+		name: "Error",
+		message: String(cause)
 	};
 }
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { NormalizedRivmuxPlayerOptions, PlayerError, WorkerCommand, WorkerMessage } from '@rivmux/protocol'\n\nconst bundledWasmUrl = new URL('./rivmux-transmux-core.wasm', import.meta.url)\n\nexport type WorkerLike = Pick<Worker, 'addEventListener' | 'postMessage' | 'removeEventListener' | 'terminate'>\n\nexport type RuntimeWorkerFactory = (options: NormalizedRivmuxPlayerOptions) => WorkerLike\n\ntype PendingRequest = {\n  resolve: () => void\n  reject: (error: PlayerError) => void\n}\n\nexport type WorkerClientHooks = {\n  onMessage(message: WorkerMessage): void\n  onError(error: PlayerError): void\n}\n\n/**\n * Returns the packaged WASM asset URL for the application bundler to track.\n *\n * Vite rewrites this static URL during the client build and emits the matching\n * binary next to the application assets.\n */\nexport function getBundledWasmUrl(): string {\n  return bundledWasmUrl.href\n}\n\nconst REQUEST_TIMEOUT_MS = 5000\n\nexport class WorkerClient {\n  private readonly worker: WorkerLike\n  private readonly hooks: WorkerClientHooks\n  private readonly handleMessage = (event: MessageEvent<WorkerMessage>): void => {\n    this.handleWorkerMessage(event.data)\n  }\n  private readonly handleError = (event: ErrorEvent): void => {\n    const error = createRuntimeWorkerError('RIVMUX_WORKER_ERROR', event.message || 'Worker runtime failed.', true, event.error)\n    this.failClient(error)\n  }\n  private pendingAttach?: PendingRequest\n  private pendingStop?: PendingRequest\n  private pendingDestroy?: PendingRequest\n  private workerReady = false\n  private queuedCommands: WorkerCommand[] = []\n  private attachTimer?: ReturnType<typeof setTimeout>\n  private stoppedTimer?: ReturnType<typeof setTimeout>\n  private destroyedTimer?: ReturnType<typeof setTimeout>\n\n  constructor(worker: WorkerLike, hooks: WorkerClientHooks) {\n    this.worker = worker\n    this.hooks = hooks\n    this.worker.addEventListener('message', this.handleMessage as EventListener)\n    this.worker.addEventListener('error', this.handleError as EventListener)\n  }\n\n  post(command: WorkerCommand): void {\n    if (!this.workerReady) {\n      this.queuedCommands.push(command)\n      return\n    }\n\n    this.worker.postMessage(command)\n  }\n\n  waitForMediaSourceHandle(command: WorkerCommand): Promise<void> {\n    if (this.pendingAttach !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_ATTACH_IN_PROGRESS', 'A media source attach request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingAttach = { resolve, reject }\n      this.attachTimer = this.startTimeout('RIVMUX_ATTACH_TIMEOUT', 'Timed out waiting for worker MediaSourceHandle.', reject)\n      this.post(command)\n    })\n  }\n\n  waitForStopped(command: WorkerCommand): Promise<void> {\n    if (this.pendingStop !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_STOP_IN_PROGRESS', 'A stop request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingStop = { resolve, reject }\n      this.stoppedTimer = this.startTimeout('RIVMUX_STOP_TIMEOUT', 'Timed out waiting for worker stop.', reject)\n      this.post(command)\n    })\n  }\n\n  waitForDestroyed(command: WorkerCommand): Promise<void> {\n    if (this.pendingDestroy !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_DESTROY_IN_PROGRESS', 'A destroy request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingDestroy = { resolve, reject }\n      this.destroyedTimer = this.startTimeout('RIVMUX_DESTROY_TIMEOUT', 'Timed out waiting for worker destroy.', reject)\n      this.post(command)\n    })\n  }\n\n  dispose(): void {\n    this.rejectAll(createRuntimeWorkerError('RIVMUX_WORKER_DISPOSED', 'Worker client was disposed.', true))\n    this.worker.removeEventListener('message', this.handleMessage as EventListener)\n    this.worker.removeEventListener('error', this.handleError as EventListener)\n    this.worker.terminate()\n  }\n\n  private handleWorkerMessage(message: WorkerMessage): void {\n    if (message.type === 'worker-ready') {\n      this.flushQueuedCommands()\n      return\n    }\n\n    this.hooks.onMessage(message)\n\n    if (message.type === 'media-source-handle') {\n      this.resolveAttach()\n      return\n    }\n\n    if (message.type === 'stopped') {\n      this.rejectAttach(createRuntimeWorkerError('RIVMUX_ATTACH_CANCELLED', 'Media source attachment was cancelled by stop.', false))\n      this.resolveStop()\n      return\n    }\n\n    if (message.type === 'destroyed') {\n      this.resolveDestroy()\n      this.rejectAttach(createRuntimeWorkerError('RIVMUX_ATTACH_CANCELLED', 'Media source attachment was cancelled by destroy.', false))\n      this.rejectStop(createRuntimeWorkerError('RIVMUX_STOP_CANCELLED', 'Stop was superseded by destroy.', false))\n      return\n    }\n\n    if (message.type === 'error') {\n      this.rejectPendingForWorkerError(message.error)\n    }\n  }\n\n  private rejectPendingForWorkerError(error: PlayerError): void {\n    if (!error.terminal) {\n      return\n    }\n\n    this.rejectAll(error)\n  }\n\n  private resolveAttach(): void {\n    this.clearAttachTimer()\n    this.pendingAttach?.resolve()\n    this.pendingAttach = undefined\n  }\n\n  private resolveStop(): void {\n    this.clearStoppedTimer()\n    this.pendingStop?.resolve()\n    this.pendingStop = undefined\n  }\n\n  private resolveDestroy(): void {\n    this.clearDestroyedTimer()\n    this.pendingDestroy?.resolve()\n    this.pendingDestroy = undefined\n  }\n\n  private rejectAttach(error: PlayerError): void {\n    this.clearAttachTimer()\n    this.pendingAttach?.reject(error)\n    this.pendingAttach = undefined\n  }\n\n  private rejectStop(error: PlayerError): void {\n    this.clearStoppedTimer()\n    this.pendingStop?.reject(error)\n    this.pendingStop = undefined\n  }\n\n  private rejectAll(error: PlayerError): void {\n    this.queuedCommands = []\n    this.clearAttachTimer()\n    this.clearStoppedTimer()\n    this.clearDestroyedTimer()\n    this.pendingAttach?.reject(error)\n    this.pendingStop?.reject(error)\n    this.pendingDestroy?.reject(error)\n    this.pendingAttach = undefined\n    this.pendingStop = undefined\n    this.pendingDestroy = undefined\n  }\n\n  private flushQueuedCommands(): void {\n    if (this.workerReady) {\n      return\n    }\n\n    this.workerReady = true\n    const commands = this.queuedCommands\n    this.queuedCommands = []\n    for (const command of commands) {\n      this.worker.postMessage(command)\n    }\n  }\n\n  private startTimeout(code: string, message: string, reject: (error: PlayerError) => void): ReturnType<typeof setTimeout> {\n    return setTimeout(() => {\n      const error = createRuntimeWorkerError(code, message, true)\n      reject(error)\n      this.failClient(error)\n    }, REQUEST_TIMEOUT_MS)\n  }\n\n  private failClient(error: PlayerError): void {\n    this.rejectAll(error)\n    this.hooks.onError(error)\n  }\n\n  private clearAttachTimer(): void {\n    if (this.attachTimer !== undefined) {\n      clearTimeout(this.attachTimer)\n      this.attachTimer = undefined\n    }\n  }\n\n  private clearStoppedTimer(): void {\n    if (this.stoppedTimer !== undefined) {\n      clearTimeout(this.stoppedTimer)\n      this.stoppedTimer = undefined\n    }\n  }\n\n  private clearDestroyedTimer(): void {\n    if (this.destroyedTimer !== undefined) {\n      clearTimeout(this.destroyedTimer)\n      this.destroyedTimer = undefined\n    }\n  }\n}\n\nexport function createRuntimeWorker(options: NormalizedRivmuxPlayerOptions): WorkerLike {\n  const url = options.runtime.workerUrl === undefined ? new URL('./rivmux-runtime-worker.js', import.meta.url) : options.runtime.workerUrl\n\n  return new Worker(url, {\n    name: 'rivmux-runtime-worker',\n    type: 'module',\n  })\n}\n\nfunction createRuntimeWorkerError(code: string, message: string, terminal: boolean, cause?: unknown): PlayerError {\n  return cause === undefined ? { kind: 'runtime', code, message, terminal } : { kind: 'runtime', code, message, terminal, cause }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { NormalizedRivmuxPlayerOptions, PlayerError, WorkerCommand, WorkerMessage } from '@rivmux/protocol'\n\nconst bundledWasmUrl = new URL('./rivmux-transmux-core.wasm', import.meta.url)\n\nexport type WorkerLike = Pick<Worker, 'addEventListener' | 'postMessage' | 'removeEventListener' | 'terminate'>\n\nexport type RuntimeWorkerFactory = (options: NormalizedRivmuxPlayerOptions) => WorkerLike\n\ntype PendingRequest = {\n  resolve: () => void\n  reject: (error: PlayerError) => void\n}\n\nexport type WorkerClientHooks = {\n  onMessage(message: WorkerMessage): void\n  onError(error: PlayerError): void\n}\n\n/**\n * Returns the packaged WASM asset URL for the application bundler to track.\n *\n * Vite rewrites this static URL during the client build and emits the matching\n * binary next to the application assets.\n */\nexport function getBundledWasmUrl(): string {\n  return bundledWasmUrl.href\n}\n\nconst REQUEST_TIMEOUT_MS = 5000\n\nexport class WorkerClient {\n  private readonly worker: WorkerLike\n  private readonly hooks: WorkerClientHooks\n  private readonly handleMessage = (event: MessageEvent<WorkerMessage>): void => {\n    this.handleWorkerMessage(event.data)\n  }\n  private readonly handleError = (event: ErrorEvent): void => {\n    const error = createRuntimeWorkerError('RIVMUX_WORKER_ERROR', event.message || 'Worker runtime failed.', true, event.error)\n    this.failClient(error)\n  }\n  private pendingAttach?: PendingRequest\n  private pendingStart?: PendingRequest\n  private pendingStop?: PendingRequest\n  private pendingDestroy?: PendingRequest\n  private workerReady = false\n  private queuedCommands: WorkerCommand[] = []\n  private attachTimer?: ReturnType<typeof setTimeout>\n  private startedTimer?: ReturnType<typeof setTimeout>\n  private stoppedTimer?: ReturnType<typeof setTimeout>\n  private destroyedTimer?: ReturnType<typeof setTimeout>\n\n  constructor(worker: WorkerLike, hooks: WorkerClientHooks) {\n    this.worker = worker\n    this.hooks = hooks\n    this.worker.addEventListener('message', this.handleMessage as EventListener)\n    this.worker.addEventListener('error', this.handleError as EventListener)\n  }\n\n  post(command: WorkerCommand): void {\n    if (!this.workerReady) {\n      this.queuedCommands.push(command)\n      return\n    }\n\n    this.worker.postMessage(command)\n  }\n\n  waitForMediaSourceHandle(command: WorkerCommand): Promise<void> {\n    if (this.pendingAttach !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_ATTACH_IN_PROGRESS', 'A media source attach request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingAttach = { resolve, reject }\n      this.attachTimer = this.startTimeout('RIVMUX_ATTACH_TIMEOUT', 'Timed out waiting for worker MediaSourceHandle.', reject)\n      this.post(command)\n    })\n  }\n\n  waitForStopped(command: WorkerCommand): Promise<void> {\n    if (this.pendingStop !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_STOP_IN_PROGRESS', 'A stop request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingStop = { resolve, reject }\n      this.stoppedTimer = this.startTimeout('RIVMUX_STOP_TIMEOUT', 'Timed out waiting for worker stop.', reject)\n      this.post(command)\n    })\n  }\n\n  waitForStarted(command: WorkerCommand): Promise<void> {\n    if (this.pendingStart !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_START_IN_PROGRESS', 'A start request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingStart = { resolve, reject }\n      this.startedTimer = this.startTimeout('RIVMUX_START_TIMEOUT', 'Timed out waiting for worker start.', reject)\n      this.post(command)\n    })\n  }\n\n  waitForDestroyed(command: WorkerCommand): Promise<void> {\n    if (this.pendingDestroy !== undefined) {\n      return Promise.reject(createRuntimeWorkerError('RIVMUX_DESTROY_IN_PROGRESS', 'A destroy request is already pending.', false))\n    }\n\n    return new Promise((resolve, reject) => {\n      this.pendingDestroy = { resolve, reject }\n      this.destroyedTimer = this.startTimeout('RIVMUX_DESTROY_TIMEOUT', 'Timed out waiting for worker destroy.', reject)\n      this.post(command)\n    })\n  }\n\n  dispose(): void {\n    this.rejectAll(createRuntimeWorkerError('RIVMUX_WORKER_DISPOSED', 'Worker client was disposed.', true))\n    this.worker.removeEventListener('message', this.handleMessage as EventListener)\n    this.worker.removeEventListener('error', this.handleError as EventListener)\n    this.worker.terminate()\n  }\n\n  private handleWorkerMessage(message: WorkerMessage): void {\n    if (message.type === 'worker-ready') {\n      this.flushQueuedCommands()\n      return\n    }\n\n    if (message.type === 'media-source-handle') {\n      this.resolveAttach()\n      this.notifyMessage(message)\n      return\n    }\n\n    if (message.type === 'started') {\n      this.resolveStart()\n      this.notifyMessage(message)\n      return\n    }\n\n    if (message.type === 'stopped') {\n      this.rejectAttach(createRuntimeWorkerError('RIVMUX_ATTACH_CANCELLED', 'Media source attachment was cancelled by stop.', false))\n      this.rejectStart(createRuntimeWorkerError('RIVMUX_START_CANCELLED', 'Start was cancelled by stop.', false))\n      this.resolveStop()\n      this.notifyMessage(message)\n      return\n    }\n\n    if (message.type === 'destroyed') {\n      this.resolveDestroy()\n      this.rejectAttach(createRuntimeWorkerError('RIVMUX_ATTACH_CANCELLED', 'Media source attachment was cancelled by destroy.', false))\n      this.rejectStart(createRuntimeWorkerError('RIVMUX_START_CANCELLED', 'Start was cancelled by destroy.', false))\n      this.rejectStop(createRuntimeWorkerError('RIVMUX_STOP_CANCELLED', 'Stop was superseded by destroy.', false))\n      this.notifyMessage(message)\n      return\n    }\n\n    if (message.type === 'error') {\n      this.rejectPendingForWorkerError(message.error)\n      this.notifyMessage(message)\n      return\n    }\n\n    this.notifyMessage(message)\n  }\n\n  private rejectPendingForWorkerError(error: PlayerError): void {\n    if (!error.terminal) {\n      return\n    }\n\n    this.rejectAll(error)\n  }\n\n  private resolveAttach(): void {\n    this.clearAttachTimer()\n    this.pendingAttach?.resolve()\n    this.pendingAttach = undefined\n  }\n\n  private resolveStop(): void {\n    this.clearStoppedTimer()\n    this.pendingStop?.resolve()\n    this.pendingStop = undefined\n  }\n\n  private resolveStart(): void {\n    this.clearStartedTimer()\n    this.pendingStart?.resolve()\n    this.pendingStart = undefined\n  }\n\n  private resolveDestroy(): void {\n    this.clearDestroyedTimer()\n    this.pendingDestroy?.resolve()\n    this.pendingDestroy = undefined\n  }\n\n  private rejectAttach(error: PlayerError): void {\n    this.clearAttachTimer()\n    this.pendingAttach?.reject(error)\n    this.pendingAttach = undefined\n  }\n\n  private rejectStop(error: PlayerError): void {\n    this.clearStoppedTimer()\n    this.pendingStop?.reject(error)\n    this.pendingStop = undefined\n  }\n\n  private rejectStart(error: PlayerError): void {\n    this.clearStartedTimer()\n    this.pendingStart?.reject(error)\n    this.pendingStart = undefined\n  }\n\n  private rejectAll(error: PlayerError): void {\n    this.queuedCommands = []\n    this.clearAttachTimer()\n    this.clearStartedTimer()\n    this.clearStoppedTimer()\n    this.clearDestroyedTimer()\n    this.pendingAttach?.reject(error)\n    this.pendingStart?.reject(error)\n    this.pendingStop?.reject(error)\n    this.pendingDestroy?.reject(error)\n    this.pendingAttach = undefined\n    this.pendingStart = undefined\n    this.pendingStop = undefined\n    this.pendingDestroy = undefined\n  }\n\n  private flushQueuedCommands(): void {\n    if (this.workerReady) {\n      return\n    }\n\n    this.workerReady = true\n    const commands = this.queuedCommands\n    this.queuedCommands = []\n    for (const command of commands) {\n      this.worker.postMessage(command)\n    }\n  }\n\n  private startTimeout(code: string, message: string, reject: (error: PlayerError) => void): ReturnType<typeof setTimeout> {\n    return setTimeout(() => {\n      const error = createRuntimeWorkerError(code, message, true)\n      reject(error)\n      this.failClient(error)\n    }, REQUEST_TIMEOUT_MS)\n  }\n\n  private failClient(error: PlayerError): void {\n    this.rejectAll(error)\n    try {\n      this.hooks.onError(error)\n    } catch (hookError) {\n      reportHookError(hookError)\n    }\n  }\n\n  private notifyMessage(message: WorkerMessage): void {\n    try {\n      this.hooks.onMessage(message)\n    } catch (error) {\n      reportHookError(error)\n    }\n  }\n\n  private clearAttachTimer(): void {\n    if (this.attachTimer !== undefined) {\n      clearTimeout(this.attachTimer)\n      this.attachTimer = undefined\n    }\n  }\n\n  private clearStoppedTimer(): void {\n    if (this.stoppedTimer !== undefined) {\n      clearTimeout(this.stoppedTimer)\n      this.stoppedTimer = undefined\n    }\n  }\n\n  private clearStartedTimer(): void {\n    if (this.startedTimer !== undefined) {\n      clearTimeout(this.startedTimer)\n      this.startedTimer = undefined\n    }\n  }\n\n  private clearDestroyedTimer(): void {\n    if (this.destroyedTimer !== undefined) {\n      clearTimeout(this.destroyedTimer)\n      this.destroyedTimer = undefined\n    }\n  }\n}\n\nfunction reportHookError(error: unknown): void {\n  try {\n    const reportError = (globalThis as typeof globalThis & { reportError?: (error: unknown) => void }).reportError\n    if (typeof reportError === 'function') {\n      reportError(error)\n      return\n    }\n  } catch {\n    // Fall through to the non-throwing console fallback.\n  }\n\n  try {\n    globalThis.console?.error(error)\n  } catch {\n    // Hook error reporting must never affect worker lifecycle state.\n  }\n}\n\nexport function createRuntimeWorker(options: NormalizedRivmuxPlayerOptions): WorkerLike {\n  const url = options.runtime.workerUrl === undefined ? new URL('./rivmux-runtime-worker.js', import.meta.url) : options.runtime.workerUrl\n\n  return new Worker(url, {\n    name: 'rivmux-runtime-worker',\n    type: 'module',\n  })\n}\n\nfunction createRuntimeWorkerError(code: string, message: string, terminal: boolean, cause?: unknown): PlayerError {\n  if (cause === undefined) {\n    return { kind: 'runtime', code, message, terminal }\n  }\n\n  return {\n    kind: 'runtime',\n    code,\n    message,\n    terminal,\n    cause: serializeCause(cause),\n  }\n}\n\nfunction serializeCause(cause: unknown): { name: string; message: string } {\n  if (cause instanceof Error) {\n    return { name: cause.name, message: cause.message }\n  }\n\n  if (typeof cause === 'object' && cause !== null) {\n    const value = cause as { name?: unknown; message?: unknown }\n    return {\n      name: typeof value.name === 'string' ? value.name : 'Error',\n      message: typeof value.message === 'string' ? value.message : String(cause),\n    }\n  }\n\n  return { name: 'Error', message: String(cause) }\n}\n"],"mappings":"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"}

package/dist/rivmux-runtime-worker.d.ts

@@ -1,4 +1,4 @@
-import { NormalizedNetworkOptions, NormalizedRivmuxPlayerOptions, PlayerError, WorkerCommand, WorkerMessage } from "@rivmux/protocol";
+import { NormalizedNetworkOptions, NormalizedRivmuxPlayerOptions, PlayerError, ReconnectReason, WorkerCommand, WorkerMessage } from "@rivmux/protocol";
 //#region src/latency/buffer-ranges.d.ts
 type BufferedRange = {
   start: number;
@@ -22,7 +22,8 @@ type StreamLoaderConfig = {
   network: NormalizedNetworkOptions;
   fetch?: typeof fetch;
   now?: () => number;
-  sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+  setTimeout?: (callback: () => void, ms: number) => ReturnType<typeof setTimeout>;
+  clearTimeout?: (timer: ReturnType<typeof setTimeout>) => void;
 };
 type StreamLoader = {
   readonly closed: boolean;
@@ -118,7 +119,7 @@ type TransmuxCoreWasmConstructor = new () => {
   reset(): void;
   destroy(): void;
 };
-declare class WasmTransmuxCoreHost implements TransmuxCoreHost {
+export declare class WasmTransmuxCoreHost implements TransmuxCoreHost {
   private readonly core;
   constructor(Core: TransmuxCoreWasmConstructor);
   pushChunk(chunk: Uint8Array): CoreEvent[];
@@ -126,7 +127,7 @@ declare class WasmTransmuxCoreHost implements TransmuxCoreHost {
   reset(): void;
   destroy(): void;
 }
-declare function normalizeCoreEvents(value: unknown): CoreEvent[];
+export declare function normalizeCoreEvents(value: unknown): CoreEvent[];
 //#endregion
 //#region src/runtime/types.d.ts
 type RuntimeMseCleanupOptions = {
@@ -162,13 +163,17 @@ type RuntimeWorkerDependencies = {
   createTransmuxCore?: (options: NormalizedRivmuxPlayerOptions) => TransmuxCoreHost | undefined | Promise<TransmuxCoreHost | undefined>;
   detectRuntime?: () => PlayerError | undefined;
   now?: () => number;
+  sleep?: (delayMs: number, signal: AbortSignal) => Promise<void>;
+  random?: () => number;
 };
 //#endregion
 //#region src/runtime/index.d.ts
-declare class RuntimeWorker {
+export declare class RuntimeWorker {
   private readonly port;
   private readonly detectRuntime;
   private readonly now;
+  private readonly sleep;
+  private readonly random;
   private state;
   private url?;
   private options?;
@@ -184,6 +189,10 @@ declare class RuntimeWorker {
   private lifecycleGeneration;
   private lifecycleAbortController;
   private fatalCleanupPromise;
+  private recoveryPromise?;
+  private connectionAttempt;
+  private recoveryStartedAt?;
+  private pendingRecovery?;
   constructor(port: RuntimeWorkerPort, dependencies?: RuntimeWorkerDependencies);
   handleCommand(command: WorkerCommand): Promise<void>;
   private executeCommand;
@@ -193,6 +202,11 @@ declare class RuntimeWorker {
   private destroy;
   private startLoader;
   private closeLoader;
+  private scheduleRecovery;
+  private recover;
+  private markRecovered;
+  private waitForRecovery;
+  private resetRecoveryCycle;
   private postStats;
   private collectMseStats;
   private quotaCleanupCutoff;
@@ -210,24 +224,37 @@ declare class RuntimeWorker {
 }
 //#endregion
 //#region src/loader/http-flv-loader.d.ts
-declare class HttpFlvLoaderError extends Error {
+type HttpFlvLoaderErrorPhase = 'open' | 'read';
+type HttpFlvLoaderErrorOptions = {
+  phase: HttpFlvLoaderErrorPhase;
+  reason?: ReconnectReason;
+  status?: number;
+  cause?: unknown;
+};
+/** Structured failure raised by one HTTP-FLV connection. */
+export declare class HttpFlvLoaderError extends Error {
   readonly code: string;
+  readonly phase: HttpFlvLoaderErrorPhase;
+  readonly reason?: ReconnectReason;
   readonly status?: number;
-  constructor(code: string, message: string, status?: number);
+  readonly cause?: unknown;
+  constructor(code: string, message: string, options?: HttpFlvLoaderErrorOptions | number);
 }
-declare class HttpFlvLoader implements StreamLoader {
+export declare class HttpFlvLoader implements StreamLoader {
   private readonly url;
   private readonly headers;
   private readonly credentials;
-  private readonly retry;
+  private readonly readIdleTimeoutMs;
   private readonly fetchImpl;
   private readonly now;
-  private readonly sleep;
+  private readonly setTimer;
+  private readonly clearTimer;
   private abortController?;
   private reader?;
   private state;
   private pausedState;
   private resumeWaiters;
+  private activeReadTimeout?;
   private readonly mutableStats;
   constructor(config: StreamLoaderConfig);
   get closed(): boolean;
@@ -238,13 +265,12 @@ declare class HttpFlvLoader implements StreamLoader {
   pause(): void;
   resume(): void;
   close(): Promise<void>;
-  private openAttempt;
   private waitUntilResumed;
   private resolveResumeWaiters;
 }
 //#endregion
 //#region src/mse/mse-controller.d.ts
-declare class MseController {
+export declare class MseController {
   private mediaSource?;
   private readonly sourceBuffers;
   private readonly queues;
@@ -273,7 +299,7 @@ type MseCleanupOptions = {
 };
 //#endregion
 //#region src/mse/source-buffer-queue.d.ts
-declare class SourceBufferQueue {
+export declare class SourceBufferQueue {
   private readonly sourceBuffer;
   private readonly queue;
   private pendingDrain?;
@@ -297,10 +323,10 @@ declare class SourceBufferQueue {
 }
 //#endregion
 //#region src/mse/mime.d.ts
-declare function isMseSupported(mimeType: string): boolean;
+export declare function isMseSupported(mimeType: string): boolean;
 //#endregion
 //#region src/wasm/wasm-loader.d.ts
-declare function createWasmTransmuxCoreHost(Core: TransmuxCoreWasmConstructor | undefined): TransmuxCoreHost;
+export declare function createWasmTransmuxCoreHost(Core: TransmuxCoreWasmConstructor | undefined): TransmuxCoreHost;
 //#endregion
 //#region src/worker-entry.d.ts
 type DedicatedWorkerScopeLike = {
@@ -308,7 +334,7 @@ type DedicatedWorkerScopeLike = {
   postMessage(message: WorkerMessage, transfer?: Transferable[]): void;
   close(): void;
 };
-declare function startRuntimeWorker(scope: DedicatedWorkerScopeLike): RuntimeWorker;
+export declare function startRuntimeWorker(scope: DedicatedWorkerScopeLike): RuntimeWorker;
 //#endregion
-export { type CoreEvent, HttpFlvLoader, HttpFlvLoaderError, MseController, RuntimeWorker, SourceBufferQueue, type StreamChunk, type StreamLoader, type StreamLoaderConfig, type StreamLoaderStats, type TransmuxCoreHost, type TransmuxCoreWasmConstructor, WasmTransmuxCoreHost, createWasmTransmuxCoreHost, isMseSupported, normalizeCoreEvents, startRuntimeWorker };
+export type { CoreEvent, StreamChunk, StreamLoader, StreamLoaderConfig, StreamLoaderStats, TransmuxCoreHost, TransmuxCoreWasmConstructor };
 //# sourceMappingURL=rivmux-runtime-worker.d.ts.map

package/dist/rivmux-runtime-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rivmux-runtime-worker.d.ts","names":[],"sources":["../src/latency/buffer-ranges.ts","../src/loader/loader.ts","../src/wasm/rivmux-transmux-wasm.ts","../src/runtime/types.ts","../src/runtime/index.ts","../src/loader/http-flv-loader.ts","../src/mse/mse-controller.ts","../src/mse/source-buffer-queue.ts","../src/mse/mime.ts","../src/wasm/wasm-loader.ts","../src/worker-entry.ts"],"mappings":"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"}
+{"version":3,"file":"rivmux-runtime-worker.d.ts","names":[],"sources":["../src/latency/buffer-ranges.ts","../src/loader/loader.ts","../src/wasm/rivmux-transmux-wasm.ts","../src/runtime/types.ts","../src/runtime/index.ts","../src/loader/http-flv-loader.ts","../src/mse/mse-controller.ts","../src/mse/source-buffer-queue.ts","../src/mse/mime.ts","../src/wasm/wasm-loader.ts","../src/worker-entry.ts"],"mappings":"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"}