@rixl/media-core 1.0.1 → 1.1.0

package/dist/lib/video-stats.js

@@ -1,44 +0,0 @@
-// src/lib/video-stats.ts
-function getDroppedFrames(video) {
-	if (!("getVideoPlaybackQuality" in video)) return 0;
-	return video.getVideoPlaybackQuality().droppedVideoFrames;
-}
-function getBufferHealth(video) {
-	if (video.buffered.length === 0) return 0;
-	const currentTime = video.currentTime;
-	for (let i = 0; i < video.buffered.length; i++) if (video.buffered.start(i) <= currentTime && video.buffered.end(i) >= currentTime) return Math.max(0, video.buffered.end(i) - currentTime);
-	return 0;
-}
-function getOptimalRes(input) {
-	const levelIndex = input.hlsAutoLevelEnabled ? input.hlsAutoLevelCapping : input.hlsCurrentLevel;
-	if (levelIndex < 0 || levelIndex >= input.hlsLevels.length) return null;
-	const level = input.hlsLevels[levelIndex];
-	return level ? {
-		width: level.width,
-		height: level.height
-	} : null;
-}
-function collectVideoStats(input) {
-	const { video } = input;
-	if (!video) return {
-		droppedFrames: 0,
-		volume: 0,
-		networkSpeed: 0,
-		bufferHealth: 0,
-		currentRes: null,
-		optimalRes: null
-	};
-	return {
-		droppedFrames: getDroppedFrames(video),
-		volume: Math.round(video.volume * 100),
-		networkSpeed: input.hlsBandwidthEstimate ?? 0,
-		bufferHealth: getBufferHealth(video),
-		currentRes: video.videoWidth > 0 ? {
-			width: video.videoWidth,
-			height: video.videoHeight
-		} : null,
-		optimalRes: getOptimalRes(input)
-	};
-}
-
-export { collectVideoStats, getBufferHealth, getDroppedFrames };

package/dist/lib/volume-utils.d.ts

@@ -1,59 +0,0 @@
-/**
- * Volume and mute utility functions
- * Pure functions for volume calculations and mute state logic
- */
-/**
- * Calculate the volume to set, ensuring it's never 0 when unmuting
- * @param currentVolume - The current volume from settings (0-1)
- * @param defaultVolume - The default volume to use if current is 0 (default: 1.0)
- * @returns The volume to set (0-1)
- */
-export declare function calculateVolumeToSet(currentVolume: number, defaultVolume?: number): number;
-/**
- * Determine if video should be muted based on player state and interaction state
- * @param playerMuted - Whether the current player is muted
- * @param isFeed - Whether this is a feed video
- * @param feedInteracted - Whether user has interacted with the feed
- * @param playerInteracted - Whether user has interacted with the player
- * @returns Whether the video should be muted
- */
-interface MuteCheckParams {
-  playerMuted: boolean;
-  playerInteracted: boolean;
-}
-export declare function shouldBeMuted({ playerMuted, playerInteracted }: MuteCheckParams): boolean;
-/**
- * Get the volume to restore when unmuting, with a minimum threshold
- * @param currentVolume - The current volume (0-1)
- * @param previousVolume - The previously saved volume before muting (0-1)
- * @param minVolume - The minimum volume to restore to (default: 0.1)
- * @returns The volume to restore (0-1)
- */
-export declare function getRestoredVolume(currentVolume: number, previousVolume: number, minVolume?: number): number;
-/**
- * Clamp volume to valid range (0-1)
- * @param volume - The volume to clamp
- * @returns Volume clamped to 0-1 range
- */
-export declare function clampVolume(volume: number): number;
-/**
- * Check if volume is effectively muted (0 or very close to 0)
- * @param volume - The volume to check
- * @param threshold - The threshold below which volume is considered muted (default: 0.01)
- * @returns Whether volume is effectively muted
- */
-export declare function isEffectivelyMuted(volume: number, threshold?: number): boolean;
-interface MousePointerLike {
-  clientX: number;
-}
-interface TouchPointerLike {
-  touches: ArrayLike<MousePointerLike>;
-}
-/** clientX of a mouse or touch event (first touch) — shared by the volume sliders. */
-export declare function getPointerClientX(event: MousePointerLike | TouchPointerLike): number;
-/** Map a pointer position over a slider rect to a clamped 0-1 volume. */
-export declare function getVolumeFromPointer(rect: {
-  left: number;
-  width: number;
-}, clientX: number): number;
-export {};

package/dist/lib/volume-utils.js

@@ -1,55 +0,0 @@
-// src/lib/volume-utils.ts
-/**
-* Volume and mute utility functions
-* Pure functions for volume calculations and mute state logic
-*/
-/**
-* Calculate the volume to set, ensuring it's never 0 when unmuting
-* @param currentVolume - The current volume from settings (0-1)
-* @param defaultVolume - The default volume to use if current is 0 (default: 1.0)
-* @returns The volume to set (0-1)
-*/
-function calculateVolumeToSet(currentVolume, defaultVolume = 1) {
-	return currentVolume > 0 ? currentVolume : defaultVolume;
-}
-function shouldBeMuted({ playerMuted, playerInteracted }) {
-	return playerMuted || !playerInteracted;
-}
-/**
-* Get the volume to restore when unmuting, with a minimum threshold
-* @param currentVolume - The current volume (0-1)
-* @param previousVolume - The previously saved volume before muting (0-1)
-* @param minVolume - The minimum volume to restore to (default: 0.1)
-* @returns The volume to restore (0-1)
-*/
-function getRestoredVolume(currentVolume, previousVolume, minVolume = .1) {
-	if (currentVolume === 0) return Math.max(minVolume, previousVolume);
-	return currentVolume;
-}
-/**
-* Clamp volume to valid range (0-1)
-* @param volume - The volume to clamp
-* @returns Volume clamped to 0-1 range
-*/
-function clampVolume(volume) {
-	return Math.max(0, Math.min(1, volume));
-}
-/**
-* Check if volume is effectively muted (0 or very close to 0)
-* @param volume - The volume to check
-* @param threshold - The threshold below which volume is considered muted (default: 0.01)
-* @returns Whether volume is effectively muted
-*/
-function isEffectivelyMuted(volume, threshold = .01) {
-	return volume < threshold;
-}
-/** clientX of a mouse or touch event (first touch) — shared by the volume sliders. */
-function getPointerClientX(event) {
-	return "touches" in event ? event.touches[0].clientX : event.clientX;
-}
-/** Map a pointer position over a slider rect to a clamped 0-1 volume. */
-function getVolumeFromPointer(rect, clientX) {
-	return clampVolume((clientX - rect.left) / rect.width);
-}
-
-export { calculateVolumeToSet, clampVolume, getPointerClientX, getRestoredVolume, getVolumeFromPointer, isEffectivelyMuted, shouldBeMuted };

package/dist/progressbar.d.ts

@@ -1,10 +0,0 @@
-export interface ProgressBarProps {
-  video: HTMLVideoElement;
-  onDraggingChange?: (isDragging: boolean) => void;
-  onProgressChange?: (progress: number) => void;
-}
-export interface ProgressBarControls {
-  handleDragStart: (event: MouseEvent | TouchEvent) => void;
-  destroy: () => void;
-}
-export declare const initProgressBar: ({ video, onDraggingChange, onProgressChange }: ProgressBarProps) => ProgressBarControls;

package/dist/progressbar.js

@@ -1,123 +0,0 @@
-// src/progressbar.ts
-const SWIPE_DISTANCE_THRESHOLD = 15;
-const SWIPE_TIME_THRESHOLD = 200;
-const manageListeners = (action, events, handler) => events.forEach((e) => window[`${action}EventListener`](e, handler));
-const clamp01 = (value) => Math.min(Math.max(value, 0), 1);
-const getClientX = (event) => {
-	if ("touches" in event) return event.touches[0]?.clientX ?? event.changedTouches?.[0]?.clientX ?? 0;
-	return event.clientX;
-};
-const createProgressBarState = (video) => ({
-	isDragging: false,
-	progress: video.currentTime / (video.duration || 1),
-	initialRect: null,
-	initialClientX: null,
-	initialProgress: 0,
-	startTime: 0,
-	hasMoved: false
-});
-const setProgress = (state, value, onProgressChange) => {
-	state.progress = Number(value.toFixed(6));
-	onProgressChange?.(state.progress);
-};
-const setDragging = (state, value, onDraggingChange) => {
-	state.isDragging = value;
-	onDraggingChange?.(value);
-};
-const shouldStartDragging = (state, clientX) => {
-	if (state.initialClientX === null) return false;
-	const distanceMoved = Math.abs(clientX - state.initialClientX);
-	const timeElapsed = Date.now() - state.startTime;
-	return distanceMoved >= SWIPE_DISTANCE_THRESHOLD || timeElapsed >= SWIPE_TIME_THRESHOLD;
-};
-const startDragging = (state, clientX, onDraggingChange) => {
-	state.hasMoved = true;
-	setDragging(state, true, onDraggingChange);
-	state.initialClientX = clientX;
-	state.initialProgress = state.progress;
-};
-const getDragProgress = (state, clientX) => {
-	if (!state.initialRect) return null;
-	const offset = (clientX - (state.initialClientX ?? state.initialRect.left)) / state.initialRect.width;
-	const baseProgress = state.initialClientX ? state.initialProgress : 0;
-	return clamp01(offset + baseProgress);
-};
-const getClickProgress = (state) => {
-	if (!state.initialRect || state.initialClientX === null) return null;
-	return clamp01((state.initialClientX - state.initialRect.left) / state.initialRect.width);
-};
-const resetDragState = (state, onDraggingChange) => {
-	setDragging(state, false, onDraggingChange);
-	state.hasMoved = false;
-	state.initialRect = null;
-	state.initialClientX = null;
-};
-const createTimeUpdateHandler = (state, video, onProgressChange) => () => {
-	if (state.isDragging) return;
-	setProgress(state, video.currentTime / (video.duration || 1), onProgressChange);
-};
-const createMoveHandler = (state, onDraggingChange, onProgressChange) => (event) => {
-	const clientX = getClientX(event);
-	if (!state.isDragging) {
-		if (!shouldStartDragging(state, clientX)) return;
-		startDragging(state, clientX, onDraggingChange);
-	}
-	const newProgress = getDragProgress(state, clientX);
-	if (newProgress === null) return;
-	setProgress(state, newProgress, onProgressChange);
-};
-const createEndHandler = ({ state, video, onDraggingChange, onProgressChange, removeListeners }) => () => {
-	const clickProgress = !state.hasMoved ? getClickProgress(state) : null;
-	if (clickProgress !== null) {
-		setProgress(state, clickProgress, onProgressChange);
-		video.currentTime = clickProgress * video.duration;
-	} else if (state.isDragging && video.duration) video.currentTime = state.progress * video.duration;
-	resetDragState(state, onDraggingChange);
-	removeListeners();
-};
-const createDragStartHandler = (state, handleMove, handleEnd) => (event) => {
-	state.initialRect = event.currentTarget.getBoundingClientRect();
-	state.startTime = Date.now();
-	state.hasMoved = false;
-	state.initialClientX = getClientX(event);
-	manageListeners("add", ["mousemove", "touchmove"], handleMove);
-	manageListeners("add", [
-		"mouseup",
-		"touchend",
-		"blur"
-	], handleEnd);
-};
-const initProgressBar = ({ video, onDraggingChange, onProgressChange }) => {
-	const state = createProgressBarState(video);
-	onDraggingChange?.(false);
-	onProgressChange?.(state.progress);
-	const handleTimeUpdate = createTimeUpdateHandler(state, video, onProgressChange);
-	const handleMove = createMoveHandler(state, onDraggingChange, onProgressChange);
-	let handleEnd;
-	const removeListeners = () => {
-		manageListeners("remove", ["mousemove", "touchmove"], handleMove);
-		manageListeners("remove", [
-			"mouseup",
-			"touchend",
-			"blur"
-		], handleEnd);
-	};
-	handleEnd = createEndHandler({
-		state,
-		video,
-		onDraggingChange,
-		onProgressChange,
-		removeListeners
-	});
-	const handleDragStart = createDragStartHandler(state, handleMove, handleEnd);
-	video.addEventListener("timeupdate", handleTimeUpdate);
-	return {
-		handleDragStart,
-		destroy: () => {
-			handleEnd();
-			video.removeEventListener("timeupdate", handleTimeUpdate);
-		}
-	};
-};
-
-export { initProgressBar };

package/dist/store/analytics-context-store.d.ts

@@ -1,4 +0,0 @@
-import { AnalyticsContext } from "../types/analytics.js";
-import { WritableAtom } from "nanostores";
-export declare const analyticsContextStore: WritableAtom<AnalyticsContext>;
-export declare function setAnalyticsContext(context: Partial<AnalyticsContext>): void;

package/dist/store/analytics-context-store.js

@@ -1,13 +0,0 @@
-import { atom } from "nanostores";
-
-// src/store/analytics-context-store.ts
-const initialContext = {};
-const analyticsContextStore = atom(initialContext);
-function setAnalyticsContext(context) {
-	analyticsContextStore.set({
-		...analyticsContextStore.get(),
-		...context
-	});
-}
-
-export { analyticsContextStore, setAnalyticsContext };

package/dist/store/analytics-device-store.d.ts

@@ -1,8 +0,0 @@
-import { WritableAtom } from "nanostores";
-interface DeviceState {
-  deviceId: string | undefined;
-}
-export declare const analyticsDeviceStore: WritableAtom<DeviceState>;
-export declare function getOrCreateDeviceId(): string;
-export declare function setDeviceId(deviceId: string): void;
-export {};

package/dist/store/analytics-device-store.js

@@ -1,44 +0,0 @@
-import { atom } from "nanostores";
-
-// src/store/analytics-device-store.ts
-const STORAGE_KEY = "rixl_analytics_device_id";
-const initialState = { deviceId: void 0 };
-const analyticsDeviceStore = atom(initialState);
-function generateDeviceId() {
-	const cryptoApi = globalThis.crypto;
-	if (cryptoApi?.randomUUID) return cryptoApi.randomUUID();
-	return `${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
-}
-function getStoredDeviceId() {
-	if (typeof localStorage === "undefined" || !localStorage) return;
-	try {
-		return localStorage.getItem(STORAGE_KEY) ?? void 0;
-	} catch {
-		return;
-	}
-}
-function setStoredDeviceId(deviceId) {
-	if (typeof localStorage === "undefined" || !localStorage) return;
-	try {
-		localStorage.setItem(STORAGE_KEY, deviceId);
-	} catch {}
-}
-function getOrCreateDeviceId() {
-	const state = analyticsDeviceStore.get();
-	if (state.deviceId) return state.deviceId;
-	const stored = getStoredDeviceId();
-	if (stored) {
-		analyticsDeviceStore.set({ deviceId: stored });
-		return stored;
-	}
-	const generated = generateDeviceId();
-	setStoredDeviceId(generated);
-	analyticsDeviceStore.set({ deviceId: generated });
-	return generated;
-}
-function setDeviceId(deviceId) {
-	setStoredDeviceId(deviceId);
-	analyticsDeviceStore.set({ deviceId });
-}
-
-export { analyticsDeviceStore, getOrCreateDeviceId, setDeviceId };

package/dist/store/analytics-session-store.d.ts

@@ -1,8 +0,0 @@
-import { WritableAtom } from "nanostores";
-interface SessionState {
-  sessionId: string | undefined;
-  started: boolean;
-}
-export declare const analyticsSessionStore: WritableAtom<SessionState>;
-export declare function getOrCreateSessionId(): string;
-export {};

package/dist/store/analytics-session-store.js

@@ -1,40 +0,0 @@
-import { atom } from "nanostores";
-
-// src/store/analytics-session-store.ts
-const initialState = {
-	sessionId: void 0,
-	started: false
-};
-const analyticsSessionStore = atom(initialState);
-function generateSessionId() {
-	const cryptoApi = globalThis.crypto;
-	if (cryptoApi?.randomUUID) return cryptoApi.randomUUID();
-	return `s-${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
-}
-function getOrCreateSessionId() {
-	const state = analyticsSessionStore.get();
-	if (state.sessionId) return state.sessionId;
-	const sessionId = generateSessionId();
-	analyticsSessionStore.set({
-		...state,
-		sessionId
-	});
-	return sessionId;
-}
-function hasSessionStarted() {
-	return analyticsSessionStore.get().started;
-}
-function markSessionStarted() {
-	analyticsSessionStore.set({
-		...analyticsSessionStore.get(),
-		started: true
-	});
-}
-function resetSession() {
-	analyticsSessionStore.set({
-		sessionId: void 0,
-		started: false
-	});
-}
-
-export { analyticsSessionStore, getOrCreateSessionId, hasSessionStarted, markSessionStarted, resetSession };

package/dist/store/analytics-store.d.ts

@@ -1,30 +0,0 @@
-import { Segment } from "../types/analytics.js";
-import { WritableAtom } from "nanostores";
-interface CurrentSegment {
-  start_ms: number;
-  speed: number;
-}
-interface AnalyticsState {
-  segments: Map<string, Segment[]>;
-  currentSegment: Map<string, CurrentSegment | null>;
-}
-export declare const analyticsStore: WritableAtom<AnalyticsState>;
-export declare const analyticsStoreActions: {
-  /**
-   * Start tracking a new segment
-   */
-  startSegment(playerId: string, positionMs: number, speed: number): void;
-  /**
-   * End the current segment being tracked
-   */
-  endSegment(playerId: string, positionMs: number): void;
-  /**
-   * Get segments including the current in-progress segment
-   */
-  getSegmentsWithCurrent(playerId: string, currentPositionMs: number): Segment[];
-  /**
-   * Clear all segments for a player
-   */
-  clearSegments(playerId: string): void;
-};
-export {};

package/dist/store/analytics-store.js

@@ -1,88 +0,0 @@
-import { atom } from "nanostores";
-
-// src/store/analytics-store.ts
-const analyticsStore = atom({
-	segments: /* @__PURE__ */ new Map(),
-	currentSegment: /* @__PURE__ */ new Map()
-});
-const analyticsStoreActions = {
-	/**
-	* Start tracking a new segment
-	*/
-	startSegment(playerId, positionMs, speed) {
-		if (analyticsStore.get().currentSegment.get(playerId)) this.endSegment(playerId, positionMs);
-		const updatedState = analyticsStore.get();
-		const newCurrentSegment = new Map(updatedState.currentSegment);
-		newCurrentSegment.set(playerId, {
-			start_ms: positionMs,
-			speed
-		});
-		analyticsStore.set({
-			...updatedState,
-			currentSegment: newCurrentSegment
-		});
-	},
-	/**
-	* End the current segment being tracked
-	*/
-	endSegment(playerId, positionMs) {
-		const state = analyticsStore.get();
-		const currentSegment = state.currentSegment.get(playerId);
-		if (!currentSegment) return;
-		if (positionMs - currentSegment.start_ms > 100) {
-			const segment = {
-				start_ms: Math.round(currentSegment.start_ms),
-				end_ms: Math.round(positionMs),
-				speed: currentSegment.speed
-			};
-			const newSegments = new Map(state.segments);
-			const playerSegments = newSegments.get(playerId) || [];
-			newSegments.set(playerId, [...playerSegments, segment]);
-			const newCurrentSegment = new Map(state.currentSegment);
-			newCurrentSegment.set(playerId, null);
-			analyticsStore.set({
-				...state,
-				segments: newSegments,
-				currentSegment: newCurrentSegment
-			});
-		} else {
-			const newCurrentSegment = new Map(state.currentSegment);
-			newCurrentSegment.set(playerId, null);
-			analyticsStore.set({
-				...state,
-				currentSegment: newCurrentSegment
-			});
-		}
-	},
-	/**
-	* Get segments including the current in-progress segment
-	*/
-	getSegmentsWithCurrent(playerId, currentPositionMs) {
-		const state = analyticsStore.get();
-		const segments = [...state.segments.get(playerId) || []];
-		const currentSegment = state.currentSegment.get(playerId);
-		if (currentSegment && currentPositionMs - currentSegment.start_ms > 100) segments.push({
-			start_ms: Math.round(currentSegment.start_ms),
-			end_ms: Math.round(currentPositionMs),
-			speed: currentSegment.speed
-		});
-		return segments;
-	},
-	/**
-	* Clear all segments for a player
-	*/
-	clearSegments(playerId) {
-		const state = analyticsStore.get();
-		const newSegments = new Map(state.segments);
-		newSegments.delete(playerId);
-		const newCurrentSegment = new Map(state.currentSegment);
-		newCurrentSegment.delete(playerId);
-		analyticsStore.set({
-			...state,
-			segments: newSegments,
-			currentSegment: newCurrentSegment
-		});
-	}
-};
-
-export { analyticsStore, analyticsStoreActions };

package/dist/store/controls-store.d.ts

@@ -1,16 +0,0 @@
-import { UUID } from "../types/uuid.js";
-import { MapStore } from "nanostores";
-export interface ControlsState {
-  visible: boolean;
-  hideTimeout: ReturnType<typeof setTimeout> | null;
-}
-interface ControlsStore {
-  state: Map<UUID, MapStore<ControlsState>>;
-  get: (id: UUID) => MapStore<ControlsState>;
-  deleteControls: (id: UUID) => void;
-  setVisible: (id: UUID, visible: boolean) => void;
-  showControls: (id: UUID, autoHideMs?: number) => void;
-  hideControls: (id: UUID) => void;
-}
-export declare const controlsStore: ControlsStore;
-export {};

package/dist/store/controls-store.js

@@ -1,53 +0,0 @@
-import { map } from "nanostores";
-
-// src/store/controls-store.ts
-const initialControls = {
-	visible: false,
-	hideTimeout: null
-};
-const controlsStore = {
-	state: /* @__PURE__ */ new Map(),
-	get: (id) => {
-		let controls = controlsStore.state.get(id);
-		if (!controls) {
-			controls = map({ ...initialControls });
-			controlsStore.state.set(id, controls);
-		}
-		return controls;
-	},
-	deleteControls: (id) => {
-		const controls = controlsStore.state.get(id);
-		if (controls) {
-			const state = controls.get();
-			if (state.hideTimeout) clearTimeout(state.hideTimeout);
-		}
-		controlsStore.state.delete(id);
-	},
-	setVisible: (id, visible) => {
-		const controls = controlsStore.get(id);
-		const currentState = controls.get();
-		if (currentState.hideTimeout) clearTimeout(currentState.hideTimeout);
-		controls.setKey("visible", visible);
-		controls.setKey("hideTimeout", null);
-	},
-	showControls: (id, autoHideMs) => {
-		const controls = controlsStore.get(id);
-		const currentState = controls.get();
-		if (currentState.hideTimeout) clearTimeout(currentState.hideTimeout);
-		let hideTimeout = null;
-		if (autoHideMs !== void 0 && autoHideMs > 0) hideTimeout = setTimeout(() => {
-			controlsStore.setVisible(id, false);
-		}, autoHideMs);
-		controls.setKey("visible", true);
-		controls.setKey("hideTimeout", hideTimeout);
-	},
-	hideControls: (id) => {
-		const controls = controlsStore.get(id);
-		const currentState = controls.get();
-		if (currentState.hideTimeout) clearTimeout(currentState.hideTimeout);
-		controls.setKey("visible", false);
-		controls.setKey("hideTimeout", null);
-	}
-};
-
-export { controlsStore };

package/dist/store/feed-cache-store.d.ts

@@ -1,24 +0,0 @@
-import { FeedPost } from "../types/feed.js";
-import { WritableAtom } from "nanostores";
-interface FeedCacheState {
-  cachedPosts: FeedPost[];
-  isLoadingFromCache: boolean;
-}
-export declare const feedCacheAtom: WritableAtom<FeedCacheState>;
-interface FeedCacheStore {
-  currentFeedId: string | undefined;
-  loadCache: (feedId?: string) => FeedPost[];
-  /**
-   * Append posts to the cache. Pass the feed the posts came from and the batch
-   * is refused if the cache has since moved to another feed.
-   */
-  saveNewPosts: (newPosts: FeedPost[], feedId?: string) => void;
-  removePost: (postId: string) => void;
-  clearCache: () => void;
-  getCacheStats: () => {
-    size: number;
-    timestamp: number | null;
-  };
-}
-export declare const feedCacheStore: FeedCacheStore;
-export {};