stream-chat-react 14.11.1 → 15.0.0-rc.1

package/dist/es/components/AudioPlayback/AudioPlayer.mjs

@@ -0,0 +1,472 @@
+import { StateStore } from "@stream-io/state-store";
+import throttle from "lodash.throttle";
+//#region src/components/AudioPlayback/AudioPlayer.ts
+var DEFAULT_PLAYBACK_RATES = [
+	1,
+	1.5,
+	2
+];
+var isSeekable = (audioElement) => !(audioElement.duration === Infinity || isNaN(audioElement.duration));
+var defaultRegisterAudioPlayerError = ({ error } = {}) => {
+	if (!error) return;
+	console.error("[AUDIO PLAYER]", error);
+};
+var elementIsPlaying = (audioElement) => audioElement && !(audioElement.paused || audioElement.ended);
+var AudioPlayer = class {
+	state;
+	/** The audio MIME type that is checked before the audio is played. If the type is not supported the controller registers error in playbackError. */
+	_data;
+	_plugins = /* @__PURE__ */ new Map();
+	playTimeout = void 0;
+	unsubscribeEventListeners = null;
+	_pool;
+	_disposed = false;
+	_pendingLoadedMeta;
+	_elementIsReadyPromise;
+	_metadataProbe = null;
+	_metadataProbePromise;
+	_restoringPosition = false;
+	_removalTimeout = void 0;
+	constructor({ durationSeconds, fileSize, id, mimeType, playbackRates: customPlaybackRates, plugins, pool, src, title, waveformData }) {
+		this._data = {
+			durationSeconds,
+			fileSize,
+			id,
+			mimeType,
+			src,
+			title,
+			waveformData
+		};
+		this._pool = pool;
+		this.setPlugins(() => plugins ?? []);
+		const playbackRates = customPlaybackRates?.length ? customPlaybackRates : DEFAULT_PLAYBACK_RATES;
+		const canPlayRecord = mimeType ? !!new Audio().canPlayType(mimeType) : true;
+		this.state = new StateStore({
+			canPlayRecord,
+			currentPlaybackRate: playbackRates[0],
+			durationSeconds,
+			elementRef: null,
+			isPlaying: false,
+			playbackError: null,
+			playbackRates,
+			progressPercent: 0,
+			secondsElapsed: 0
+		});
+		this.plugins.forEach((p) => p.onInit?.({ player: this }));
+		this.preloadMetadata();
+	}
+	get plugins() {
+		return Array.from(this._plugins.values());
+	}
+	get canPlayRecord() {
+		return this.state.getLatestValue().canPlayRecord;
+	}
+	get elementRef() {
+		return this.state.getLatestValue().elementRef;
+	}
+	get isPlaying() {
+		return this.state.getLatestValue().isPlaying;
+	}
+	get currentPlaybackRate() {
+		return this.state.getLatestValue().currentPlaybackRate;
+	}
+	get playbackRates() {
+		return this.state.getLatestValue().playbackRates;
+	}
+	get durationSeconds() {
+		return this.state.getLatestValue().durationSeconds;
+	}
+	get fileSize() {
+		return this._data.fileSize;
+	}
+	get id() {
+		return this._data.id;
+	}
+	get src() {
+		return this._data.src;
+	}
+	get mimeType() {
+		return this._data.mimeType;
+	}
+	get title() {
+		return this._data.title;
+	}
+	get waveformData() {
+		return this._data.waveformData;
+	}
+	get secondsElapsed() {
+		return this.state.getLatestValue().secondsElapsed;
+	}
+	get progressPercent() {
+		return this.state.getLatestValue().progressPercent;
+	}
+	get disposed() {
+		return this._disposed;
+	}
+	setDurationSeconds = (durationSeconds) => {
+		this._data.durationSeconds = durationSeconds;
+		this.state.partialNext({ durationSeconds });
+	};
+	ensureElementRef() {
+		if (this._disposed) throw new Error("AudioPlayer is disposed");
+		if (!this.elementRef) {
+			const el = this._pool.acquireElement({
+				owner: this,
+				src: this.src
+			});
+			this.setRef(el);
+		}
+		return this.elementRef;
+	}
+	setPlaybackStartSafetyTimeout = () => {
+		clearTimeout(this.playTimeout);
+		this.playTimeout = setTimeout(() => {
+			if (!this.elementRef) return;
+			try {
+				this.elementRef.pause();
+				this.state.partialNext({ isPlaying: false });
+			} catch (e) {
+				this.registerError({ errCode: "failed-to-start" });
+			}
+		}, 2e3);
+	};
+	updateDurationFromElement = (element) => {
+		const duration = element.duration;
+		if (typeof duration !== "number" || isNaN(duration) || !isFinite(duration) || duration <= 0) return;
+		this.setDurationSeconds(duration);
+	};
+	clearMetadataProbe = () => {
+		const probe = this._metadataProbe;
+		this._metadataProbe = null;
+		this._metadataProbePromise = void 0;
+		if (!probe) return;
+		try {
+			probe.pause();
+		} catch {}
+		probe.removeAttribute("src");
+		try {
+			probe.load();
+		} catch {}
+	};
+	preloadMetadata = () => {
+		if (this._disposed || this.durationSeconds != null || !this.src || this._metadataProbePromise || typeof document === "undefined") return;
+		const probe = document.createElement("audio");
+		probe.preload = "metadata";
+		this._metadataProbe = probe;
+		this._metadataProbePromise = new Promise((resolve) => {
+			const cleanup = () => {
+				probe.removeEventListener("loadedmetadata", handleLoadedMetadata);
+				probe.removeEventListener("error", handleError);
+				if (this._metadataProbe === probe) this.clearMetadataProbe();
+				else this._metadataProbePromise = void 0;
+				resolve();
+			};
+			const handleLoadedMetadata = () => {
+				this.updateDurationFromElement(probe);
+				cleanup();
+			};
+			const handleError = () => {
+				cleanup();
+			};
+			probe.addEventListener("loadedmetadata", handleLoadedMetadata, { once: true });
+			probe.addEventListener("error", handleError, { once: true });
+			probe.src = this.src;
+			try {
+				probe.load();
+			} catch {
+				cleanup();
+			}
+		});
+	};
+	clearPlaybackStartSafetyTimeout = () => {
+		if (!this.elementRef) return;
+		clearTimeout(this.playTimeout);
+		this.playTimeout = void 0;
+	};
+	clearPendingLoadedMeta = () => {
+		const pending = this._pendingLoadedMeta;
+		if (pending?.element && pending.onLoaded) pending.element.removeEventListener("loadedmetadata", pending.onLoaded);
+		this._pendingLoadedMeta = void 0;
+	};
+	restoreSavedPosition = (elementRef) => {
+		const saved = this.secondsElapsed;
+		if (!saved || saved <= 0) return;
+		const apply = () => {
+			const duration = elementRef.duration;
+			const clamped = typeof duration === "number" && !isNaN(duration) && isFinite(duration) ? Math.min(saved, duration) : saved;
+			try {
+				if (elementRef.currentTime === clamped) return;
+				elementRef.currentTime = clamped;
+				this.setSecondsElapsed(clamped);
+			} catch {}
+		};
+		if (elementRef.readyState < 1) {
+			this.clearPendingLoadedMeta();
+			this._restoringPosition = true;
+			const onLoaded = () => {
+				if (this._pendingLoadedMeta?.onLoaded !== onLoaded) return;
+				this._pendingLoadedMeta = void 0;
+				if (this.elementRef !== elementRef) {
+					this._restoringPosition = false;
+					return;
+				}
+				apply();
+				this._restoringPosition = false;
+			};
+			elementRef.addEventListener("loadedmetadata", onLoaded, { once: true });
+			this._pendingLoadedMeta = {
+				element: elementRef,
+				onLoaded
+			};
+		} else {
+			this._restoringPosition = true;
+			apply();
+			this._restoringPosition = false;
+		}
+	};
+	setDescriptor(descriptor) {
+		const previousSrc = this.src;
+		this._data = {
+			...this._data,
+			...descriptor
+		};
+		if (descriptor.src !== previousSrc && this.elementRef) this.elementRef.src = descriptor.src;
+		if (descriptor.src && descriptor.src !== previousSrc) {
+			this.clearMetadataProbe();
+			if (descriptor.durationSeconds == null) {
+				this.setDurationSeconds(void 0);
+				this.preloadMetadata();
+			} else this.setDurationSeconds(descriptor.durationSeconds);
+			return;
+		}
+		if (descriptor.durationSeconds != null) this.setDurationSeconds(descriptor.durationSeconds);
+	}
+	releaseElement({ resetState }) {
+		this.clearPendingLoadedMeta();
+		this.clearMetadataProbe();
+		this._restoringPosition = false;
+		if (resetState) this.stop();
+		else {
+			this.state.partialNext({ isPlaying: false });
+			if (this.elementRef) try {
+				this.elementRef.pause();
+			} catch {}
+		}
+		if (this.elementRef) {
+			this._pool.releaseElement(this);
+			this.setRef(null);
+		}
+	}
+	elementIsReady = () => {
+		if (this._elementIsReadyPromise) return this._elementIsReadyPromise;
+		this._elementIsReadyPromise = new Promise((resolve) => {
+			if (!this.elementRef) return resolve(false);
+			const element = this.elementRef;
+			const handleLoaded = () => {
+				element.removeEventListener("loadedmetadata", handleLoaded);
+				resolve(element.readyState > 0);
+			};
+			element.addEventListener("loadedmetadata", handleLoaded);
+		});
+		return this._elementIsReadyPromise;
+	};
+	setRef = (elementRef) => {
+		if (elementIsPlaying(this.elementRef)) this.releaseElement({ resetState: false });
+		this.clearPendingLoadedMeta();
+		this.clearMetadataProbe();
+		this._restoringPosition = false;
+		this._elementIsReadyPromise = void 0;
+		this.state.partialNext({ elementRef });
+		if (elementRef) this.registerSubscriptions();
+	};
+	setSecondsElapsed = (secondsElapsed) => {
+		const duration = this.elementRef?.duration ?? this.durationSeconds;
+		this.state.partialNext({
+			progressPercent: duration && secondsElapsed ? secondsElapsed / duration * 100 : 0,
+			secondsElapsed
+		});
+	};
+	setPlugins(setter) {
+		this._plugins = setter(this.plugins).reduce((acc, plugin) => {
+			if (plugin.id) acc.set(plugin.id, plugin);
+			return acc;
+		}, /* @__PURE__ */ new Map());
+	}
+	canPlayMimeType = (mimeType) => {
+		if (!mimeType) return false;
+		if (this.elementRef) return !!this.elementRef.canPlayType(mimeType);
+		return !!new Audio().canPlayType(mimeType);
+	};
+	play = async (params) => {
+		if (this._disposed) return;
+		const elementRef = this.ensureElementRef();
+		if (elementIsPlaying(this.elementRef)) {
+			if (this.isPlaying) return;
+			this.state.partialNext({ isPlaying: true });
+			return;
+		}
+		const { currentPlaybackRate, playbackRates } = {
+			currentPlaybackRate: this.currentPlaybackRate,
+			playbackRates: this.playbackRates,
+			...params
+		};
+		if (!this.canPlayRecord) {
+			this.registerError({ errCode: "not-playable" });
+			return;
+		}
+		this.restoreSavedPosition(elementRef);
+		elementRef.playbackRate = currentPlaybackRate ?? this.currentPlaybackRate;
+		this.setPlaybackStartSafetyTimeout();
+		try {
+			await elementRef.play();
+			this.state.partialNext({
+				currentPlaybackRate,
+				isPlaying: true,
+				playbackRates
+			});
+			this._pool.setActiveAudioPlayer(this);
+		} catch (e) {
+			this.registerError({ error: e });
+			this.state.partialNext({ isPlaying: false });
+		} finally {
+			this.clearPlaybackStartSafetyTimeout();
+		}
+	};
+	pause = () => {
+		if (!elementIsPlaying(this.elementRef)) return;
+		this.clearPlaybackStartSafetyTimeout();
+		this.elementRef.pause();
+		this.state.partialNext({ isPlaying: false });
+	};
+	stop = () => {
+		this.pause();
+		this.state.partialNext({ isPlaying: false });
+		this.setSecondsElapsed(0);
+		if (this.elementRef) this.elementRef.currentTime = 0;
+	};
+	togglePlay = async () => this.isPlaying ? this.pause() : await this.play();
+	increasePlaybackRate = () => {
+		let currentPlaybackRateIndex = this.state.getLatestValue().playbackRates.findIndex((rate) => rate === this.currentPlaybackRate);
+		if (currentPlaybackRateIndex === -1) currentPlaybackRateIndex = 0;
+		const nextIndex = currentPlaybackRateIndex === this.playbackRates.length - 1 ? 0 : currentPlaybackRateIndex + 1;
+		const currentPlaybackRate = this.playbackRates[nextIndex];
+		this.state.partialNext({ currentPlaybackRate });
+		if (this.elementRef) this.elementRef.playbackRate = currentPlaybackRate;
+	};
+	seek = throttle(async ({ clientX, currentTarget }) => {
+		let element = this.elementRef;
+		if (!this.elementRef) {
+			element = this.ensureElementRef();
+			if (!await this.elementIsReady()) return;
+		}
+		if (!currentTarget || !element) return;
+		if (!isSeekable(element)) {
+			this.registerError({ errCode: "seek-not-supported" });
+			return;
+		}
+		const { width, x } = currentTarget.getBoundingClientRect();
+		const ratio = (clientX - x) / width;
+		if (ratio > 1 || ratio < 0) return;
+		const currentTime = ratio * element.duration;
+		this.setSecondsElapsed(currentTime);
+		element.currentTime = currentTime;
+	}, 16);
+	registerError = (params) => {
+		defaultRegisterAudioPlayerError(params);
+		this.plugins.forEach(({ onError }) => onError?.({
+			player: this,
+			...params
+		}));
+	};
+	/**
+	* Removes the audio element reference, event listeners and audio player from the player pool.
+	* Helpful when only a single AudioPlayer instance is to be removed from the AudioPlayerPool.
+	*/
+	requestRemoval = () => {
+		this._disposed = true;
+		this.cancelScheduledRemoval();
+		this.clearPendingLoadedMeta();
+		this.clearMetadataProbe();
+		this._restoringPosition = false;
+		this.releaseElement({ resetState: true });
+		this.unsubscribeEventListeners?.();
+		this.unsubscribeEventListeners = null;
+		this.plugins.forEach(({ onRemove }) => onRemove?.({ player: this }));
+		this._pool.deregister(this.id);
+	};
+	cancelScheduledRemoval = () => {
+		clearTimeout(this._removalTimeout);
+		this._removalTimeout = void 0;
+	};
+	scheduleRemoval = (ms = 0) => {
+		this.cancelScheduledRemoval();
+		this._removalTimeout = setTimeout(() => {
+			if (this.disposed) return;
+			this.requestRemoval();
+		}, ms);
+	};
+	/**
+	* Releases only the underlying element back to the pool without disposing the player instance.
+	* Used by the pool to hand off the shared element in single-playback mode.
+	*/
+	releaseElementForHandoff = () => {
+		if (!this.elementRef) return;
+		this.releaseElement({ resetState: false });
+		this.unsubscribeEventListeners?.();
+		this.unsubscribeEventListeners = null;
+	};
+	registerSubscriptions = () => {
+		this.unsubscribeEventListeners?.();
+		const audioElement = this.elementRef;
+		if (!audioElement) return;
+		const handleEnded = () => {
+			if (audioElement) this.updateDurationFromElement(audioElement);
+			this.stop();
+		};
+		const handleError = (e) => {
+			const audio = e.currentTarget;
+			const state = { isPlaying: false };
+			if (!audio?.error?.code) {
+				this.state.partialNext(state);
+				return;
+			}
+			if (audio.error.code === 4) {
+				state.canPlayRecord = false;
+				this.state.partialNext(state);
+			}
+			const errorMsg = [
+				void 0,
+				"MEDIA_ERR_ABORTED: fetch aborted by user",
+				"MEDIA_ERR_NETWORK: network failed while fetching",
+				"MEDIA_ERR_DECODE: audio fetched but couldn’t decode",
+				"MEDIA_ERR_SRC_NOT_SUPPORTED: source not supported"
+			][audio?.error?.code];
+			if (!errorMsg) return;
+			defaultRegisterAudioPlayerError({ error: /* @__PURE__ */ new Error(errorMsg + ` (${audio.src})`) });
+		};
+		const handleTimeupdate = () => {
+			const t = audioElement?.currentTime ?? 0;
+			if (this._restoringPosition && t === 0) return;
+			if (!this.isPlaying && t === 0 && this.secondsElapsed > 0) return;
+			this.setSecondsElapsed(t);
+		};
+		const handleLoadedMetadata = () => {
+			if (audioElement) this.updateDurationFromElement(audioElement);
+		};
+		audioElement.addEventListener("ended", handleEnded);
+		audioElement.addEventListener("error", handleError);
+		audioElement.addEventListener("loadedmetadata", handleLoadedMetadata);
+		audioElement.addEventListener("timeupdate", handleTimeupdate);
+		this.unsubscribeEventListeners = () => {
+			audioElement.pause();
+			audioElement.removeEventListener("ended", handleEnded);
+			audioElement.removeEventListener("error", handleError);
+			audioElement.removeEventListener("loadedmetadata", handleLoadedMetadata);
+			audioElement.removeEventListener("timeupdate", handleTimeupdate);
+		};
+	};
+};
+//#endregion
+export { AudioPlayer, defaultRegisterAudioPlayerError, elementIsPlaying };
+
+//# sourceMappingURL=AudioPlayer.mjs.map

package/dist/es/components/AudioPlayback/AudioPlayer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPlayer.mjs","names":[],"sources":["../../../../src/components/AudioPlayback/AudioPlayer.ts"],"sourcesContent":["import { StateStore } from '@stream-io/state-store';\nimport throttle from 'lodash.throttle';\nimport type { AudioPlayerPlugin } from './plugins';\nimport type { AudioPlayerPool } from './AudioPlayerPool';\n\nexport type AudioPlayerErrorCode =\n  | 'failed-to-start'\n  | 'not-playable'\n  | 'seek-not-supported'\n  | (string & {});\n\nexport type RegisterAudioPlayerErrorParams = {\n  error?: Error;\n  errCode?: AudioPlayerErrorCode;\n};\n\nexport type AudioPlayerDescriptor = {\n  id: string;\n  src: string;\n  /** Audio duration in seconds. */\n  durationSeconds?: number;\n  fileSize?: number | string;\n  mimeType?: string;\n  title?: string;\n  waveformData?: number[];\n};\n\nexport type AudioPlayerPlayAudioParams = {\n  currentPlaybackRate?: number;\n  playbackRates?: number[];\n};\n\nexport type AudioPlayerState = {\n  /** Signals whether the browser can play the record. */\n  canPlayRecord: boolean;\n  /** Current playback speed. Initiated with the first item of the playbackRates array. */\n  currentPlaybackRate: number;\n  /** Audio duration in seconds, from descriptor or loaded metadata. */\n  durationSeconds?: number;\n  /** The audio element ref */\n  elementRef: HTMLAudioElement | null;\n  /** Signals whether the playback is in progress. */\n  isPlaying: boolean;\n  /** Keeps the latest playback error reference. */\n  playbackError: Error | null;\n  /** An array of fractional numeric values of playback speed to override the defaults (1.0, 1.5, 2.0) */\n  playbackRates: number[];\n  /** Playback progress expressed in percent. */\n  progressPercent: number;\n  /** Playback progress expressed in seconds. */\n  secondsElapsed: number;\n};\n\nexport type AudioPlayerOptions = AudioPlayerDescriptor & {\n  /** An array of fractional numeric values of playback speed to override the defaults (1.0, 1.5, 2.0) */\n  playbackRates?: number[];\n  plugins?: AudioPlayerPlugin[];\n  pool: AudioPlayerPool;\n};\n\nconst DEFAULT_PLAYBACK_RATES = [1.0, 1.5, 2.0];\n\nconst isSeekable = (audioElement: HTMLAudioElement) =>\n  !(audioElement.duration === Infinity || isNaN(audioElement.duration));\n\nexport const defaultRegisterAudioPlayerError = ({\n  error,\n}: RegisterAudioPlayerErrorParams = {}) => {\n  if (!error) return;\n  console.error('[AUDIO PLAYER]', error);\n};\n\nexport const elementIsPlaying = (audioElement: HTMLAudioElement | null) =>\n  audioElement && !(audioElement.paused || audioElement.ended);\n\nexport type SeekFn = (params: {\n  clientX: number;\n  currentTarget: HTMLDivElement;\n}) => Promise<void>;\n\nexport class AudioPlayer {\n  state: StateStore<AudioPlayerState>;\n  /** The audio MIME type that is checked before the audio is played. If the type is not supported the controller registers error in playbackError. */\n  private _data: AudioPlayerDescriptor;\n  private _plugins = new Map<string, AudioPlayerPlugin>();\n  private playTimeout: ReturnType<typeof setTimeout> | undefined = undefined;\n  private unsubscribeEventListeners: (() => void) | null = null;\n  private _pool: AudioPlayerPool;\n  private _disposed = false;\n  private _pendingLoadedMeta?: { element: HTMLAudioElement; onLoaded: () => void };\n  private _elementIsReadyPromise?: Promise<boolean>;\n  private _metadataProbe: HTMLAudioElement | null = null;\n  private _metadataProbePromise?: Promise<void>;\n  private _restoringPosition = false;\n  private _removalTimeout: ReturnType<typeof setTimeout> | undefined = undefined;\n\n  constructor({\n    durationSeconds,\n    fileSize,\n    id,\n    mimeType,\n    playbackRates: customPlaybackRates,\n    plugins,\n    pool,\n    src,\n    title,\n    waveformData,\n  }: AudioPlayerOptions) {\n    this._data = {\n      durationSeconds,\n      fileSize,\n      id,\n      mimeType,\n      src,\n      title,\n      waveformData,\n    };\n    this._pool = pool;\n    this.setPlugins(() => plugins ?? []);\n\n    const playbackRates = customPlaybackRates?.length\n      ? customPlaybackRates\n      : DEFAULT_PLAYBACK_RATES;\n\n    // do not create element here; only evaluate canPlayRecord cheaply\n    const canPlayRecord = mimeType ? !!new Audio().canPlayType(mimeType) : true;\n\n    this.state = new StateStore<AudioPlayerState>({\n      canPlayRecord,\n      currentPlaybackRate: playbackRates[0],\n      durationSeconds,\n      elementRef: null,\n      isPlaying: false,\n      playbackError: null,\n      playbackRates,\n      progressPercent: 0,\n      secondsElapsed: 0,\n    });\n\n    this.plugins.forEach((p) => p.onInit?.({ player: this }));\n    this.preloadMetadata();\n  }\n\n  private get plugins(): AudioPlayerPlugin[] {\n    return Array.from(this._plugins.values());\n  }\n\n  get canPlayRecord() {\n    return this.state.getLatestValue().canPlayRecord;\n  }\n\n  get elementRef() {\n    return this.state.getLatestValue().elementRef;\n  }\n\n  get isPlaying(): boolean {\n    return this.state.getLatestValue().isPlaying;\n  }\n\n  get currentPlaybackRate() {\n    return this.state.getLatestValue().currentPlaybackRate;\n  }\n\n  get playbackRates() {\n    return this.state.getLatestValue().playbackRates;\n  }\n\n  get durationSeconds() {\n    return this.state.getLatestValue().durationSeconds;\n  }\n\n  get fileSize() {\n    return this._data.fileSize;\n  }\n\n  get id() {\n    return this._data.id;\n  }\n\n  get src() {\n    return this._data.src;\n  }\n\n  get mimeType() {\n    return this._data.mimeType;\n  }\n\n  get title() {\n    return this._data.title;\n  }\n\n  get waveformData() {\n    return this._data.waveformData;\n  }\n\n  get secondsElapsed() {\n    return this.state.getLatestValue().secondsElapsed;\n  }\n\n  get progressPercent() {\n    return this.state.getLatestValue().progressPercent;\n  }\n\n  get disposed() {\n    return this._disposed;\n  }\n\n  private setDurationSeconds = (durationSeconds?: number) => {\n    this._data.durationSeconds = durationSeconds;\n    this.state.partialNext({ durationSeconds });\n  };\n\n  private ensureElementRef(): HTMLAudioElement {\n    if (this._disposed) {\n      throw new Error('AudioPlayer is disposed');\n    }\n    if (!this.elementRef) {\n      const el = this._pool.acquireElement({\n        owner: this,\n        src: this.src,\n      });\n      this.setRef(el);\n    }\n    return this.elementRef as HTMLAudioElement;\n  }\n  private setPlaybackStartSafetyTimeout = () => {\n    clearTimeout(this.playTimeout);\n    this.playTimeout = setTimeout(() => {\n      if (!this.elementRef) return;\n      try {\n        this.elementRef.pause();\n        this.state.partialNext({ isPlaying: false });\n      } catch (e) {\n        this.registerError({ errCode: 'failed-to-start' });\n      }\n    }, 2000);\n  };\n\n  private updateDurationFromElement = (element: HTMLAudioElement) => {\n    const duration = element.duration;\n    if (\n      typeof duration !== 'number' ||\n      isNaN(duration) ||\n      !isFinite(duration) ||\n      duration <= 0\n    ) {\n      return;\n    }\n    this.setDurationSeconds(duration);\n  };\n\n  private clearMetadataProbe = () => {\n    const probe = this._metadataProbe;\n    this._metadataProbe = null;\n    this._metadataProbePromise = undefined;\n\n    if (!probe) return;\n\n    try {\n      probe.pause();\n    } catch {\n      // ignore\n    }\n\n    probe.removeAttribute('src');\n    try {\n      probe.load();\n    } catch {\n      // ignore\n    }\n  };\n\n  private preloadMetadata = () => {\n    if (\n      this._disposed ||\n      this.durationSeconds != null ||\n      !this.src ||\n      this._metadataProbePromise ||\n      typeof document === 'undefined'\n    ) {\n      return;\n    }\n\n    const probe = document.createElement('audio');\n    probe.preload = 'metadata';\n    this._metadataProbe = probe;\n    this._metadataProbePromise = new Promise((resolve) => {\n      const cleanup = () => {\n        probe.removeEventListener('loadedmetadata', handleLoadedMetadata);\n        probe.removeEventListener('error', handleError);\n        if (this._metadataProbe === probe) {\n          this.clearMetadataProbe();\n        } else {\n          this._metadataProbePromise = undefined;\n        }\n        resolve();\n      };\n\n      const handleLoadedMetadata = () => {\n        this.updateDurationFromElement(probe);\n        cleanup();\n      };\n\n      const handleError = () => {\n        cleanup();\n      };\n\n      probe.addEventListener('loadedmetadata', handleLoadedMetadata, { once: true });\n      probe.addEventListener('error', handleError, { once: true });\n      probe.src = this.src;\n      try {\n        probe.load();\n      } catch {\n        cleanup();\n      }\n    });\n  };\n\n  private clearPlaybackStartSafetyTimeout = () => {\n    if (!this.elementRef) return;\n    clearTimeout(this.playTimeout);\n    this.playTimeout = undefined;\n  };\n\n  private clearPendingLoadedMeta = () => {\n    const pending = this._pendingLoadedMeta;\n    if (pending?.element && pending.onLoaded) {\n      pending.element.removeEventListener('loadedmetadata', pending.onLoaded);\n    }\n    this._pendingLoadedMeta = undefined;\n  };\n\n  private restoreSavedPosition = (elementRef: HTMLAudioElement) => {\n    const saved = this.secondsElapsed;\n    if (!saved || saved <= 0) return;\n    const apply = () => {\n      const duration = elementRef.duration;\n      const clamped =\n        typeof duration === 'number' && !isNaN(duration) && isFinite(duration)\n          ? Math.min(saved, duration)\n          : saved;\n      try {\n        if (elementRef.currentTime === clamped) return;\n        elementRef.currentTime = clamped;\n        // Preempt UI with restored position to avoid flicker\n        this.setSecondsElapsed(clamped);\n      } catch {\n        // ignore\n      }\n    };\n    // No information is available about the media resource.\n    if (elementRef.readyState < 1) {\n      this.clearPendingLoadedMeta();\n      this._restoringPosition = true;\n      const onLoaded = () => {\n        // Ensure this callback still belongs to the same pending registration and same element\n        if (this._pendingLoadedMeta?.onLoaded !== onLoaded) return;\n        this._pendingLoadedMeta = undefined;\n        if (this.elementRef !== elementRef) {\n          this._restoringPosition = false;\n          return;\n        }\n        apply();\n        this._restoringPosition = false;\n      };\n      elementRef.addEventListener('loadedmetadata', onLoaded, { once: true });\n      this._pendingLoadedMeta = { element: elementRef, onLoaded };\n    } else {\n      this._restoringPosition = true;\n      apply();\n      this._restoringPosition = false;\n    }\n  };\n\n  setDescriptor(descriptor: AudioPlayerDescriptor) {\n    const previousSrc = this.src;\n    this._data = { ...this._data, ...descriptor };\n    if (descriptor.src !== previousSrc && this.elementRef) {\n      this.elementRef.src = descriptor.src;\n    }\n    if (descriptor.src && descriptor.src !== previousSrc) {\n      this.clearMetadataProbe();\n      if (descriptor.durationSeconds == null) {\n        this.setDurationSeconds(undefined);\n        this.preloadMetadata();\n      } else {\n        this.setDurationSeconds(descriptor.durationSeconds);\n      }\n      return;\n    }\n    if (descriptor.durationSeconds != null) {\n      this.setDurationSeconds(descriptor.durationSeconds);\n    }\n  }\n\n  private releaseElement({ resetState }: { resetState: boolean }) {\n    this.clearPendingLoadedMeta();\n    this.clearMetadataProbe();\n    this._restoringPosition = false;\n    if (resetState) {\n      this.stop();\n    } else {\n      // Ensure isPlaying reflects reality, but keep progress/seconds\n      this.state.partialNext({ isPlaying: false });\n      if (this.elementRef) {\n        try {\n          this.elementRef.pause();\n        } catch {\n          // ignore\n        }\n      }\n    }\n    if (this.elementRef) {\n      this._pool.releaseElement(this);\n      this.setRef(null);\n    }\n  }\n\n  private elementIsReady = (): Promise<boolean> => {\n    if (this._elementIsReadyPromise) return this._elementIsReadyPromise;\n\n    this._elementIsReadyPromise = new Promise((resolve) => {\n      if (!this.elementRef) return resolve(false);\n      const element = this.elementRef;\n      const handleLoaded = () => {\n        element.removeEventListener('loadedmetadata', handleLoaded);\n        resolve(element.readyState > 0);\n      };\n      element.addEventListener('loadedmetadata', handleLoaded);\n    });\n\n    return this._elementIsReadyPromise;\n  };\n\n  private setRef = (elementRef: HTMLAudioElement | null) => {\n    if (elementIsPlaying(this.elementRef)) {\n      // preserve state during swap\n      this.releaseElement({ resetState: false });\n    }\n    this.clearPendingLoadedMeta();\n    this.clearMetadataProbe();\n    this._restoringPosition = false;\n    this._elementIsReadyPromise = undefined;\n    this.state.partialNext({ elementRef });\n    // When a new element is attached, make sure listeners are wired to it\n    if (elementRef) {\n      this.registerSubscriptions();\n    }\n  };\n\n  setSecondsElapsed = (secondsElapsed: number) => {\n    const duration = this.elementRef?.duration ?? this.durationSeconds;\n    this.state.partialNext({\n      progressPercent: duration && secondsElapsed ? (secondsElapsed / duration) * 100 : 0,\n      secondsElapsed,\n    });\n  };\n\n  setPlugins(setter: (currentPlugins: AudioPlayerPlugin[]) => AudioPlayerPlugin[]) {\n    this._plugins = setter(this.plugins).reduce((acc, plugin) => {\n      if (plugin.id) {\n        acc.set(plugin.id, plugin);\n      }\n      return acc;\n    }, new Map<string, AudioPlayerPlugin>());\n  }\n\n  canPlayMimeType = (mimeType: string) => {\n    if (!mimeType) return false;\n    if (this.elementRef) return !!this.elementRef.canPlayType(mimeType);\n    return !!new Audio().canPlayType(mimeType);\n  };\n\n  play = async (params?: AudioPlayerPlayAudioParams) => {\n    if (this._disposed) return;\n    const elementRef = this.ensureElementRef();\n    if (elementIsPlaying(this.elementRef)) {\n      if (this.isPlaying) return;\n      this.state.partialNext({ isPlaying: true });\n      return;\n    }\n\n    const { currentPlaybackRate, playbackRates } = {\n      currentPlaybackRate: this.currentPlaybackRate,\n      playbackRates: this.playbackRates,\n      ...params,\n    };\n\n    if (!this.canPlayRecord) {\n      this.registerError({ errCode: 'not-playable' });\n      return;\n    }\n\n    // Restore last known position for this player before attempting to play\n    this.restoreSavedPosition(elementRef);\n\n    elementRef.playbackRate = currentPlaybackRate ?? this.currentPlaybackRate;\n\n    this.setPlaybackStartSafetyTimeout();\n\n    try {\n      await elementRef.play();\n      this.state.partialNext({\n        currentPlaybackRate,\n        isPlaying: true,\n        playbackRates,\n      });\n      this._pool.setActiveAudioPlayer(this);\n    } catch (e) {\n      this.registerError({ error: e as Error });\n      this.state.partialNext({ isPlaying: false });\n    } finally {\n      this.clearPlaybackStartSafetyTimeout();\n    }\n  };\n\n  pause = () => {\n    if (!elementIsPlaying(this.elementRef)) return;\n    this.clearPlaybackStartSafetyTimeout();\n\n    // existence of the element already checked by elementIsPlaying\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    this.elementRef!.pause();\n    this.state.partialNext({ isPlaying: false });\n  };\n\n  stop = () => {\n    this.pause();\n    this.state.partialNext({ isPlaying: false });\n    this.setSecondsElapsed(0);\n    if (this.elementRef) this.elementRef.currentTime = 0;\n  };\n\n  togglePlay = async () => (this.isPlaying ? this.pause() : await this.play());\n\n  increasePlaybackRate = () => {\n    let currentPlaybackRateIndex = this.state\n      .getLatestValue()\n      .playbackRates.findIndex((rate) => rate === this.currentPlaybackRate);\n    if (currentPlaybackRateIndex === -1) {\n      currentPlaybackRateIndex = 0;\n    }\n    const nextIndex =\n      currentPlaybackRateIndex === this.playbackRates.length - 1\n        ? 0\n        : currentPlaybackRateIndex + 1;\n    const currentPlaybackRate = this.playbackRates[nextIndex];\n    this.state.partialNext({ currentPlaybackRate });\n    if (this.elementRef) {\n      this.elementRef.playbackRate = currentPlaybackRate;\n    }\n  };\n\n  seek = throttle<SeekFn>(async ({ clientX, currentTarget }) => {\n    let element = this.elementRef;\n    if (!this.elementRef) {\n      element = this.ensureElementRef();\n      const isReady = await this.elementIsReady();\n      if (!isReady) return;\n    }\n    if (!currentTarget || !element) return;\n    if (!isSeekable(element)) {\n      this.registerError({ errCode: 'seek-not-supported' });\n      return;\n    }\n\n    const { width, x } = currentTarget.getBoundingClientRect();\n\n    const ratio = (clientX - x) / width;\n    if (ratio > 1 || ratio < 0) return;\n    const currentTime = ratio * element.duration;\n    this.setSecondsElapsed(currentTime);\n    element.currentTime = currentTime;\n  }, 16);\n\n  registerError = (params: RegisterAudioPlayerErrorParams) => {\n    defaultRegisterAudioPlayerError(params);\n    this.plugins.forEach(({ onError }) => onError?.({ player: this, ...params }));\n  };\n\n  /**\n   * Removes the audio element reference, event listeners and audio player from the player pool.\n   * Helpful when only a single AudioPlayer instance is to be removed from the AudioPlayerPool.\n   */\n  requestRemoval = () => {\n    this._disposed = true;\n    this.cancelScheduledRemoval();\n    this.clearPendingLoadedMeta();\n    this.clearMetadataProbe();\n    this._restoringPosition = false;\n    this.releaseElement({ resetState: true });\n    this.unsubscribeEventListeners?.();\n    this.unsubscribeEventListeners = null;\n    this.plugins.forEach(({ onRemove }) => onRemove?.({ player: this }));\n    this._pool.deregister(this.id);\n  };\n\n  cancelScheduledRemoval = () => {\n    clearTimeout(this._removalTimeout);\n    this._removalTimeout = undefined;\n  };\n\n  scheduleRemoval = (ms: number = 0) => {\n    this.cancelScheduledRemoval();\n    this._removalTimeout = setTimeout(() => {\n      if (this.disposed) return;\n      this.requestRemoval();\n    }, ms);\n  };\n\n  /**\n   * Releases only the underlying element back to the pool without disposing the player instance.\n   * Used by the pool to hand off the shared element in single-playback mode.\n   */\n  releaseElementForHandoff = () => {\n    if (!this.elementRef) return;\n    this.releaseElement({ resetState: false });\n    this.unsubscribeEventListeners?.();\n    this.unsubscribeEventListeners = null;\n  };\n\n  registerSubscriptions = () => {\n    this.unsubscribeEventListeners?.();\n\n    const audioElement = this.elementRef;\n    if (!audioElement) return;\n\n    const handleEnded = () => {\n      if (audioElement) {\n        this.updateDurationFromElement(audioElement);\n      }\n      this.stop();\n    };\n\n    const handleError = (e: HTMLMediaElementEventMap['error']) => {\n      // if fired probably is one of these (e.srcElement.error.code)\n      // 1 = MEDIA_ERR_ABORTED         (fetch aborted by user/JS)\n      // 2 = MEDIA_ERR_NETWORK         (network failed while fetching)\n      // 3 = MEDIA_ERR_DECODE          (data fetched but couldn’t decode)\n      // 4 = MEDIA_ERR_SRC_NOT_SUPPORTED (no resource supported / bad type)\n      // reported during the mount so only logging to the console\n      const audio = e.currentTarget as HTMLAudioElement | null;\n      const state: Partial<AudioPlayerState> = { isPlaying: false };\n\n      if (!audio?.error?.code) {\n        this.state.partialNext(state);\n        return;\n      }\n\n      if (audio.error.code === 4) {\n        state.canPlayRecord = false;\n        this.state.partialNext(state);\n      }\n\n      const errorMsg = [\n        undefined,\n        'MEDIA_ERR_ABORTED: fetch aborted by user',\n        'MEDIA_ERR_NETWORK: network failed while fetching',\n        'MEDIA_ERR_DECODE: audio fetched but couldn’t decode',\n        'MEDIA_ERR_SRC_NOT_SUPPORTED: source not supported',\n      ][audio?.error?.code];\n      if (!errorMsg) return;\n\n      defaultRegisterAudioPlayerError({ error: new Error(errorMsg + ` (${audio.src})`) });\n    };\n\n    const handleTimeupdate = () => {\n      const t = audioElement?.currentTime ?? 0;\n      // Ignore spurious zero during restore/handoff to avoid UI flicker\n      if (this._restoringPosition && t === 0) return;\n      // Also avoid regressing UI to zero if we already have non-zero progress and we're not playing\n      if (!this.isPlaying && t === 0 && this.secondsElapsed > 0) return;\n      this.setSecondsElapsed(t);\n    };\n\n    const handleLoadedMetadata = () => {\n      if (audioElement) {\n        this.updateDurationFromElement(audioElement);\n      }\n    };\n\n    audioElement.addEventListener('ended', handleEnded);\n    audioElement.addEventListener('error', handleError);\n    audioElement.addEventListener('loadedmetadata', handleLoadedMetadata);\n    audioElement.addEventListener('timeupdate', handleTimeupdate);\n\n    this.unsubscribeEventListeners = () => {\n      audioElement.pause();\n      audioElement.removeEventListener('ended', handleEnded);\n      audioElement.removeEventListener('error', handleError);\n      audioElement.removeEventListener('loadedmetadata', handleLoadedMetadata);\n      audioElement.removeEventListener('timeupdate', handleTimeupdate);\n    };\n  };\n}\n"],"mappings":"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"}

package/dist/es/components/AudioPlayback/AudioPlayerPool.mjs

@@ -0,0 +1,73 @@
+import { AudioPlayer } from "./AudioPlayer.mjs";
+import { AudioPlaybackArbiter } from "./AudioPlaybackArbiter.mjs";
+//#region src/components/AudioPlayback/AudioPlayerPool.ts
+var AudioPlayerPool = class {
+	pool = /* @__PURE__ */ new Map();
+	arbiter;
+	constructor({ arbiter } = {}) {
+		this.arbiter = arbiter ?? new AudioPlaybackArbiter();
+	}
+	/** Playback state is the arbiter's, so every pool sharing one reports the same active player. */
+	get state() {
+		return this.arbiter.state;
+	}
+	get players() {
+		return Array.from(this.pool.values());
+	}
+	get activeAudioPlayer() {
+		return this.arbiter.activeAudioPlayer;
+	}
+	getOrAdd = (params) => {
+		const { playbackRates, plugins, ...descriptor } = params;
+		let player = this.pool.get(params.id);
+		if (player) {
+			if (!player.disposed) {
+				player.setDescriptor(descriptor);
+				return player;
+			}
+			this.deregister(params.id);
+		}
+		player = new AudioPlayer({
+			playbackRates,
+			plugins,
+			...descriptor,
+			pool: this
+		});
+		this.pool.set(params.id, player);
+		return player;
+	};
+	/** @see {@link AudioPlaybackArbiter.acquire} */
+	acquireElement = ({ owner, src }) => this.arbiter.acquire({
+		owner,
+		src
+	});
+	/** @see {@link AudioPlaybackArbiter.release} */
+	releaseElement = (owner) => this.arbiter.release(owner);
+	setActiveAudioPlayer = (activeAudioPlayer) => this.arbiter.setActivePlayer(activeAudioPlayer);
+	/** Removes the AudioPlayer instance from the pool of players */
+	deregister(id) {
+		if (this.pool.has(id)) this.pool.delete(id);
+		if (this.activeAudioPlayer?.id === id) this.setActiveAudioPlayer(null);
+	}
+	/** Performs all the necessary cleanup actions and removes the player from the pool */
+	remove = (id) => {
+		const player = this.pool.get(id);
+		if (!player) return;
+		player.requestRemoval();
+	};
+	/** Removes and cleans up all the players from the pool */
+	clear = () => {
+		this.players.forEach((player) => {
+			this.remove(player.id);
+		});
+	};
+	registerSubscriptions = () => {
+		this.players.forEach((p) => {
+			if (p.elementRef) p.registerSubscriptions();
+		});
+	};
+};
+//#endregion
+export { AudioPlayerPool };
+
+//# sourceMappingURL=AudioPlayerPool.mjs.map

package/dist/es/components/AudioPlayback/AudioPlayerPool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPlayerPool.mjs","names":[],"sources":["../../../../src/components/AudioPlayback/AudioPlayerPool.ts"],"sourcesContent":["import { AudioPlayer, type AudioPlayerOptions } from './AudioPlayer';\nimport { AudioPlaybackArbiter } from './AudioPlaybackArbiter';\nimport type { AudioPlaybackArbiterState } from './AudioPlaybackArbiter';\n\nexport type AudioPlayerPoolState = AudioPlaybackArbiterState;\n\nexport type AudioPlayerPoolOptions = {\n  /**\n   * Decides which player may play, and owns the element they share. Pools given the same arbiter\n   * cannot play over each other -- which is how `Channel` and `Thread`, each with their own pool,\n   * stay exclusive. Left out, the pool arbitrates alone.\n   */\n  arbiter?: AudioPlaybackArbiter;\n};\n\nexport class AudioPlayerPool {\n  private pool = new Map<string, AudioPlayer>();\n  private readonly arbiter: AudioPlaybackArbiter;\n\n  constructor({ arbiter }: AudioPlayerPoolOptions = {}) {\n    this.arbiter = arbiter ?? new AudioPlaybackArbiter();\n  }\n\n  /** Playback state is the arbiter's, so every pool sharing one reports the same active player. */\n  get state() {\n    return this.arbiter.state;\n  }\n\n  get players() {\n    return Array.from(this.pool.values());\n  }\n\n  get activeAudioPlayer() {\n    return this.arbiter.activeAudioPlayer;\n  }\n\n  getOrAdd = (params: Omit<AudioPlayerOptions, 'pool'>) => {\n    const { playbackRates, plugins, ...descriptor } = params;\n    let player = this.pool.get(params.id);\n    if (player) {\n      if (!player.disposed) {\n        player.setDescriptor(descriptor);\n        return player;\n      }\n      this.deregister(params.id);\n    }\n    player = new AudioPlayer({\n      playbackRates,\n      plugins,\n      ...descriptor,\n      pool: this,\n    });\n    this.pool.set(params.id, player);\n    return player;\n  };\n\n  /** @see {@link AudioPlaybackArbiter.acquire} */\n  acquireElement = ({ owner, src }: { owner: AudioPlayer; src: string }) =>\n    this.arbiter.acquire({ owner, src });\n\n  /** @see {@link AudioPlaybackArbiter.release} */\n  releaseElement = (owner: AudioPlayer) => this.arbiter.release(owner);\n\n  setActiveAudioPlayer = (activeAudioPlayer: AudioPlayer | null) =>\n    this.arbiter.setActivePlayer(activeAudioPlayer);\n\n  /** Removes the AudioPlayer instance from the pool of players */\n  deregister(id: string) {\n    if (this.pool.has(id)) {\n      this.pool.delete(id);\n    }\n    if (this.activeAudioPlayer?.id === id) {\n      this.setActiveAudioPlayer(null);\n    }\n  }\n\n  /** Performs all the necessary cleanup actions and removes the player from the pool */\n  remove = (id: string) => {\n    const player = this.pool.get(id);\n    if (!player) return;\n    player.requestRemoval();\n  };\n\n  /** Removes and cleans up all the players from the pool */\n  clear = () => {\n    this.players.forEach((player) => {\n      this.remove(player.id);\n    });\n  };\n\n  registerSubscriptions = () => {\n    // Only register subscriptions for players that have an attached element -- every other player\n    // would otherwise cross-wire listeners onto the shared element it does not currently own.\n    this.players.forEach((p) => {\n      if (p.elementRef) {\n        p.registerSubscriptions();\n      }\n    });\n  };\n}\n"],"mappings":";;;AAeA,IAAa,kBAAb,MAA6B;CAC3B,uBAAe,IAAI,IAAyB;CAC5C;CAEA,YAAY,EAAE,YAAoC,CAAC,GAAG;EACpD,KAAK,UAAU,WAAW,IAAI,qBAAqB;CACrD;;CAGA,IAAI,QAAQ;EACV,OAAO,KAAK,QAAQ;CACtB;CAEA,IAAI,UAAU;EACZ,OAAO,MAAM,KAAK,KAAK,KAAK,OAAO,CAAC;CACtC;CAEA,IAAI,oBAAoB;EACtB,OAAO,KAAK,QAAQ;CACtB;CAEA,YAAY,WAA6C;EACvD,MAAM,EAAE,eAAe,SAAS,GAAG,eAAe;EAClD,IAAI,SAAS,KAAK,KAAK,IAAI,OAAO,EAAE;EACpC,IAAI,QAAQ;GACV,IAAI,CAAC,OAAO,UAAU;IACpB,OAAO,cAAc,UAAU;IAC/B,OAAO;GACT;GACA,KAAK,WAAW,OAAO,EAAE;EAC3B;EACA,SAAS,IAAI,YAAY;GACvB;GACA;GACA,GAAG;GACH,MAAM;EACR,CAAC;EACD,KAAK,KAAK,IAAI,OAAO,IAAI,MAAM;EAC/B,OAAO;CACT;;CAGA,kBAAkB,EAAE,OAAO,UACzB,KAAK,QAAQ,QAAQ;EAAE;EAAO;CAAI,CAAC;;CAGrC,kBAAkB,UAAuB,KAAK,QAAQ,QAAQ,KAAK;CAEnE,wBAAwB,sBACtB,KAAK,QAAQ,gBAAgB,iBAAiB;;CAGhD,WAAW,IAAY;EACrB,IAAI,KAAK,KAAK,IAAI,EAAE,GAClB,KAAK,KAAK,OAAO,EAAE;EAErB,IAAI,KAAK,mBAAmB,OAAO,IACjC,KAAK,qBAAqB,IAAI;CAElC;;CAGA,UAAU,OAAe;EACvB,MAAM,SAAS,KAAK,KAAK,IAAI,EAAE;EAC/B,IAAI,CAAC,QAAQ;EACb,OAAO,eAAe;CACxB;;CAGA,cAAc;EACZ,KAAK,QAAQ,SAAS,WAAW;GAC/B,KAAK,OAAO,OAAO,EAAE;EACvB,CAAC;CACH;CAEA,8BAA8B;EAG5B,KAAK,QAAQ,SAAS,MAAM;GAC1B,IAAI,EAAE,YACJ,EAAE,sBAAsB;EAE5B,CAAC;CACH;AACF"}