saltfish 0.1.0

package/dist/components/buttons/PlayPauseButton.d.ts

@@ -0,0 +1,13 @@
+import type { PlayerState } from '../../types/index';
+import type { VideoManager } from '../../managers/VideoManager';
+export declare class PlayPauseButton {
+    private playButton;
+    private container;
+    private videoManager;
+    constructor(container: HTMLElement, videoManager?: VideoManager);
+    private createButton;
+    private handlePlayClick;
+    updateState(state: PlayerState): void;
+    destroy(): void;
+}
+//# sourceMappingURL=PlayPauseButton.d.ts.map

package/dist/components/buttons/PlayPauseButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlayPauseButton.d.ts","sourceRoot":"","sources":["../../../src/components/buttons/PlayPauseButton.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAA6B;gBAErC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,YAAY;IAM/D,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,eAAe;IAuDhB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAmBrC,OAAO,IAAI,IAAI;CAIvB"}

package/dist/core/SaltfishPlayer.d.ts

@@ -0,0 +1,154 @@
+import { VideoManager } from '../managers/VideoManager';
+import { SaltfishEventName, EventHandler } from '../managers/EventManager';
+import type { SaltfishConfig, PlaylistOptions } from '../types';
+/**
+ * Main class for the Saltfish playlist Player
+ */
+export declare class SaltfishPlayer {
+    private static instance;
+    private shadowDOMManager;
+    videoManager: VideoManager;
+    private cursorManager;
+    private interactionManager;
+    private analyticsManager;
+    private sessionRecordingManager;
+    private sessionManager;
+    private buttonManager;
+    private transitionManager;
+    private eventManager;
+    private playlistManager;
+    private stepTimeoutManager;
+    private stateSubject;
+    private uiObserver;
+    private eventObserver;
+    private playerRoot;
+    private playerElement;
+    private minimizeButton;
+    private exitButton;
+    private playPauseButton;
+    private isInitialized;
+    private isDragging;
+    private dragOffset;
+    private justFinishedDragging;
+    private dragStartPosition;
+    private hasMoved;
+    private resizeListener;
+    private static prevState;
+    private static destroyTimeoutId;
+    private lastConfig;
+    private lastUserIdentification;
+    /**
+     * Creates a new Saltfish playlist Player instance
+     * @private Constructor is private to enforce singleton pattern
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance of the Saltfish playlist Player
+     */
+    static getInstance(): SaltfishPlayer;
+    /**
+     * Gets the current sessionId (persistent across 30 minutes)
+     * @returns The current sessionId
+     */
+    getSessionId(): string;
+    /**
+     * Gets the current runId (unique per playlist execution)
+     * @returns The current runId or null if no playlist is running
+     */
+    getRunId(): string | null;
+    /**
+     * Initializes the Saltfish playlist Player
+     * @param config - Configuration options
+     */
+    initialize(config: SaltfishConfig): Promise<void>;
+    /**
+     * Creates the player element
+     * This is now private and will be called by startPlaylist
+     */
+    private createPlayerUI;
+    /**
+     * Identifies the current user
+     * @param userId - User ID
+     * @param userData - Additional user data
+     */
+    identifyUser(userId: string, userData?: any): void;
+    /**
+     * Fetches user data from the backend
+     * @param userId - User ID
+     * @param userData - Additional user data
+     */
+    private fetchUserData;
+    /**
+     * Starts a new playlist
+     * @param playlistId - ID of the playlist to start
+     * @param options - Optional playback options including position, drag behavior, and starting step
+     * @param options.position - Position of the player on screen
+     * @param options.allowDrag - Whether the player can be dragged
+     * @param options.startNodeId - Optional step ID to start from instead of the manifest's default startStep
+     *
+     * If the player has been destroyed, it will automatically reinitialize using the last configuration
+     * before starting the playlist.
+     */
+    startPlaylist(playlistId: string, options?: PlaylistOptions): Promise<void>;
+    /**
+     * Registers action handlers with the state machine
+     */
+    private registerStateMachineActions;
+    /**
+     * Finds the URL of the next video in the playlist
+     * @param currentStep - The current step being played
+     * @returns The URL of the next video or null if no next video exists
+     */
+    private findNextVideoUrl;
+    /**
+     * Handles store state changes
+     */
+    private handleStoreChanges;
+    /**
+     * Updates the position of the player element based on store state
+     */
+    private updatePosition;
+    /**
+     * Handles minimize button click
+     */
+    private handleMinimizeClick;
+    /**
+     * Sets up drag handlers for the player
+     */
+    private setupDragHandlers;
+    /**
+     * Destroys the Saltfish playlist Player instance
+     */
+    destroy(): void;
+    /**
+     * Updates the visibility of player controls based on the current state
+     * @param state - The current player state
+     */
+    private updateControlsVisibility;
+    /**
+     * Handles completed state
+     */
+    private handleCompletedState;
+    /**
+     * Registers an event listener to be called when the given eventName is triggered
+     * @param eventName - Name of event to listen for
+     * @param listener - Function to call when the event is triggered
+     */
+    on<T extends SaltfishEventName>(eventName: T, listener: EventHandler<T>): void;
+    /**
+     * Removes an event listener for the given eventName
+     * @param eventName - Name of event to stop listening for
+     * @param listener - Function to remove
+     * @returns true if the listener was removed, false if it wasn't found
+     */
+    off<T extends SaltfishEventName>(eventName: T, listener: EventHandler<T>): boolean;
+    /**
+     * Resets the current playlist to its initial state
+     */
+    resetPlaylist(): void;
+    /**
+     * Cleans up the current playlist state
+     */
+    private cleanupCurrentPlaylist;
+}
+//# sourceMappingURL=SaltfishPlayer.d.ts.map

package/dist/core/SaltfishPlayer.d.ts.map

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

package/dist/core/stateMachine.d.ts

@@ -0,0 +1,119 @@
+import type { PlayerState, Step } from '../types';
+export type PlayerEvent = {
+    type: 'INITIALIZE';
+} | {
+    type: 'LOAD_MANIFEST';
+} | {
+    type: 'MANIFEST_LOADED';
+    step: Step;
+} | {
+    type: 'PLAY';
+} | {
+    type: 'PAUSE';
+} | {
+    type: 'MINIMIZE';
+} | {
+    type: 'MAXIMIZE';
+} | {
+    type: 'VIDEO_ENDED';
+    step: Step;
+} | {
+    type: 'TRANSITION_TO_STEP';
+    step: Step;
+} | {
+    type: 'WAIT_FOR_INTERACTION';
+} | {
+    type: 'INTERACTION_COMPLETED';
+} | {
+    type: 'ERROR';
+    error: Error;
+} | {
+    type: 'AUTOPLAY_FALLBACK';
+} | {
+    type: 'COMPLETE_PLAYLIST';
+};
+export interface PlayerContext {
+    currentStep: Step | null;
+    error: Error | null;
+}
+export type ActionFunction = (context: PlayerContext, event?: PlayerEvent) => void;
+export type Action = string | ActionFunction;
+export type StateTransition = {
+    target: PlayerState;
+    actions?: Action[];
+};
+export type StateConfig = {
+    on: {
+        [key in PlayerEvent['type']]?: StateTransition;
+    };
+    entry?: Action[];
+    exit?: Action[];
+};
+export type StateMachineConfig = {
+    states: {
+        [key in PlayerState]: StateConfig;
+    };
+    initial: PlayerState;
+};
+export interface ActionHandlers {
+    [actionName: string]: ActionFunction;
+}
+export declare class PlayerStateMachine {
+    private currentState;
+    private config;
+    private context;
+    private actionHandlers;
+    constructor(config: StateMachineConfig, initialContext: PlayerContext);
+    /**
+     * Set up default action handlers for common operations
+     */
+    private setupDefaultActions;
+    /**
+     * Register custom action handlers
+     * @param actions - Object mapping action names to handler functions
+     */
+    registerActions(actions: ActionHandlers): void;
+    /**
+     * Execute an action (either named or inline function)
+     * @param action - The action to execute
+     * @param event - Optional event that triggered the action
+     */
+    private executeAction;
+    /**
+     * Send an event to the state machine to trigger a transition
+     * @param event - The event to send
+     * @returns The new state after the transition
+     */
+    send(event: PlayerEvent): PlayerState;
+    /**
+     * Update context based on the event
+     * @param event - The event to process
+     */
+    private updateContextFromEvent;
+    /**
+     * Get the current state of the state machine
+     * @returns The current state
+     */
+    getState(): PlayerState;
+    /**
+     * Get the current context of the state machine
+     * @returns The current context
+     */
+    getContext(): PlayerContext;
+    /**
+     * Update the context directly (use with caution)
+     * @param updater Function that takes the current context and returns an updated one
+     */
+    updateContext(updater: (context: PlayerContext) => Partial<PlayerContext>): void;
+    /**
+     * Run entry actions for a state
+     * @param state - The state to run entry actions for
+     */
+    private runEntryActions;
+    /**
+     * Run exit actions for a state
+     * @param state - The state to run exit actions for
+     */
+    private runExitActions;
+}
+//# sourceMappingURL=stateMachine.d.ts.map

package/dist/core/stateMachine.d.ts.map

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

package/dist/core/stateMachineConfig.d.ts

@@ -0,0 +1,7 @@
+import { StateMachineConfig } from './stateMachine';
+/**
+ * Pure configuration for the player state machine
+ * All side effects are handled through named actions
+ */
+export declare const playerStateMachineConfig: StateMachineConfig;
+//# sourceMappingURL=stateMachineConfig.d.ts.map

package/dist/core/stateMachineConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateMachineConfig.d.ts","sourceRoot":"","sources":["../../src/core/stateMachineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,kBAoGtC,CAAC"}

package/dist/core/store.d.ts

@@ -0,0 +1,27 @@
+import type { SaltfishStore, Step } from '../types';
+/**
+ * Creates the Saltfish playlist Player store with Zustand and Immer
+ * Using vanilla store to avoid React hooks
+ */
+export declare const saltfishStore: Omit<import("zustand/vanilla").StoreApi<SaltfishStore>, "setState"> & {
+    setState(nextStateOrUpdater: SaltfishStore | Partial<SaltfishStore> | ((state: import("immer").WritableDraft<SaltfishStore>) => void), shouldReplace?: boolean | undefined): void;
+};
+type StoreAdapter = {
+    getState: () => SaltfishStore;
+    setState: typeof saltfishStore.setState;
+    subscribe: typeof saltfishStore.subscribe;
+    destroy: typeof saltfishStore.destroy;
+};
+export declare const useSaltfishStore: StoreAdapter;
+/**
+ * Returns the current step from the store
+ * This is a React hook and should only be used in React components
+ */
+export declare const useCurrentStep: () => Step | null;
+/**
+ * Gets the current step directly from the store state
+ * This is a regular function that can be used in non-React environments
+ */
+export declare const getCurrentStep: () => Step | null;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAIb,IAAI,EAKL,MAAM,UAAU,CAAC;AAgBlB;;;GAGG;AACH,eAAO,MAAM,aAAa;;CA2azB,CAAC;AAIF,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,MAAM,aAAa,CAAC;IAC9B,QAAQ,EAAE,OAAO,aAAa,CAAC,QAAQ,CAAC;IACxC,SAAS,EAAE,OAAO,aAAa,CAAC,SAAS,CAAC;IAC1C,OAAO,EAAE,OAAO,aAAa,CAAC,OAAO,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YAK9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,IAAI,GAAG,IAKxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,IAAI,GAAG,IAKxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+import type { SaltfishConfig, PlaylistOptions, playlistManifest } from './types';
+import { SaltfishEventName, EventHandler } from './managers/EventManager';
+import type { DeviceInfo } from './utils/deviceDetection';
+/**
+ * Global Saltfish playlist Player API
+ */
+export interface SaltfishAPI {
+    /**
+     * Initializes the Saltfish playlist Player
+     * @param token - Saltfish API token or configuration object
+     * @returns Promise that resolves when initialization is complete
+     * @note You don't need to use await with this method - it can be called synchronously.
+     *       You can also listen for the 'initialized' event instead of awaiting the promise.
+     * @example
+     * // Using with just a token:
+     * saltfish.init('YOUR_API_TOKEN');
+     * saltfish.startPlaylist('your_playlist_id');
+     *
+     * // Using with configuration object:
+     * saltfish.init({
+     *   token: 'YOUR_API_TOKEN',
+     *   enableAnalytics: false // Disable analytics for development
+     * });
+     *
+     * // Using with events:
+     * saltfish.on('initialized', () => {
+     *   saltfish.startPlaylist('your_playlist_id');
+     * });
+     * saltfish.init('YOUR_API_TOKEN');
+     */
+    init: (token: string | SaltfishConfig) => Promise<void>;
+    /**
+     * Identifies the current user
+     * @param userId - User ID
+     * @param userData - Additional user data
+     */
+    identify: (userId: string, userData?: Record<string, any>) => void;
+    /**
+     * Starts a playlist
+     * @param playlistId - playlist ID to start
+     * @param options - Optional configuration for position, drag behavior, and starting step
+     * @param options.position - Position of the player on screen
+     * @param options.allowDrag - Whether the player can be dragged
+     * @param options.startNodeId - Optional step ID to start from instead of the manifest's default startStep
+     * @returns Promise that resolves when playlist is started
+     * @note You don't need to use await with this method - it can be called synchronously.
+     *       You can also listen for the 'playlistStarted' event instead of awaiting the promise.
+     * @note If a list of playlists was provided by the backend during initialization, the `playlistId` parameter
+     *       may be ignored, and the player will attempt to load the first playlist from that list.
+     * @note If a playlist is already running, this will automatically reset the store state and start the new playlist with a clean state.
+     * @example
+     * // Using without await:
+     * saltfish.startPlaylist('your_playlist_id');
+     *
+     * // Starting from a specific step:
+     * saltfish.startPlaylist('your_playlist_id', { startNodeId: 'step2' });
+     *
+     * // Starting a new playlist while another is running:
+     * saltfish.startPlaylist('new_playlist_id'); // Automatically resets state
+     *
+     * // Using with events:
+     * saltfish.on('playlistStarted', (event) => {
+     *   console.log('Playlist started:', event.playlist.id);
+     * });
+     * saltfish.startPlaylist('your_playlist_id');
+     */
+    startPlaylist: (playlistId: string, options?: PlaylistOptions) => Promise<void>;
+    /**
+     * Gets the current session ID
+     * @returns The unique session ID generated during initialization
+     */
+    getSessionId: () => string;
+    /**
+     * Gets the current run ID
+     * @returns The unique run ID for the current playlist execution, or null if no playlist is running
+     */
+    getRunId: () => string | null;
+    /**
+     * Registers an event listener to be called when the given eventName is triggered
+     * @param eventName - Name of event to listen for. See list of supported events.
+     * @param listener - Function to call when the event is triggered
+     */
+    on: <T extends SaltfishEventName>(eventName: T, listener: EventHandler<T>) => void;
+    /**
+     * Removes an event listener for the given eventName
+     * @param eventName - Name of event to stop listening for
+     * @param listener - Function to remove
+     * @returns true if the listener was removed, false if it wasn't found
+     */
+    off: <T extends SaltfishEventName>(eventName: T, listener: EventHandler<T>) => boolean;
+    /**
+     * Resets the current playlist
+     */
+    resetPlaylist: () => void;
+    /**
+     * Destroys the Saltfish playlist Player
+     */
+    destroy: () => void;
+    /**
+     * Testing utilities for development mode only
+     * These will be removed in production builds
+     */
+    __dev__?: {
+        /**
+         * Sets a custom mock manifest for testing
+         * @param manifest - The manifest to use for testing
+         */
+        setMockManifest: (manifest: playlistManifest) => void;
+        /**
+         * Creates a custom mock manifest based on provided overrides
+         * @param overrides - Partial playlistManifest to override default values
+         */
+        createMockManifest: (overrides: Partial<playlistManifest>) => playlistManifest;
+        /**
+         * The default mock manifest
+         */
+        defaultMockManifest: playlistManifest;
+        /**
+         * Gets current device detection information
+         * @returns DeviceInfo object with all device details
+         */
+        getDeviceInfo: () => DeviceInfo;
+    };
+}
+declare const saltfish: SaltfishAPI;
+export default saltfish;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;OAIG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF;;;OAGG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,EAAE,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAEnF;;;;;OAKG;IACH,GAAG,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IAEvF;;OAEG;IACH,aAAa,EAAE,MAAM,IAAI,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR;;;WAGG;QACH,eAAe,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;QAEtD;;;WAGG;QACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,gBAAgB,CAAC;QAE/E;;WAEG;QACH,mBAAmB,EAAE,gBAAgB,CAAC;QAEtC;;;WAGG;QACH,aAAa,EAAE,MAAM,UAAU,CAAC;KACjC,CAAA;CACF;AAyMD,QAAA,MAAM,QAAQ,aAAc,CAAC;AAO7B,eAAe,QAAQ,CAAC"}

package/dist/managers/AnalyticsManager.d.ts

@@ -0,0 +1,107 @@
+import type { SaltfishConfig, UserData } from '../types';
+import { EventManager } from './EventManager';
+/**
+ * Manager class for tracking and reporting analytics events
+ *
+ * This class handles tracking of various events in the player, including:
+ * - Standard events: playlistStart, playlistComplete, stepStarted, stepComplete
+ * - Player state events: playerPaused, playerResumed, playerMinimized, playerMaximized
+ * - Error events
+ *
+ * Events are queued and sent in batches to the backend analytics API.
+ */
+export declare class AnalyticsManager {
+    private config;
+    private user;
+    private eventQueue;
+    private isSending;
+    private flushInterval;
+    private eventManager;
+    private sessionId;
+    private analyticsEnabled;
+    /**
+     * Creates a new AnalyticsManager
+     * @param eventManager - Optional event manager to subscribe to events
+     */
+    constructor(eventManager?: EventManager);
+    /**
+     * Sets the event manager and subscribes to relevant events
+     * @param eventManager - Event manager instance
+     */
+    setEventManager(eventManager: EventManager): void;
+    /**
+     * Subscribe to relevant player events for analytics tracking
+     */
+    private subscribeToEvents;
+    /**
+     * Helper to get the store state when needed
+     */
+    private getStore;
+    /**
+     * Initializes the analytics manager
+     * @param config - Saltfish configuration
+     * @param sessionId - Unique session identifier
+     */
+    initialize(config: SaltfishConfig, sessionId?: string): void;
+    /**
+     * Sets the current user
+     * @param user - User data
+     */
+    setUser(user: UserData): void;
+    /**
+     * Tracks a playlist start event
+     * @param playlistId - playlist ID
+     */
+    trackPlaylistStart(playlistId: string): void;
+    /**
+     * Tracks a playlist completion event
+     * @param playlistId - playlist ID
+     */
+    trackPlaylistComplete(playlistId: string): void;
+    /**
+     * Tracks a step started event
+     * @param playlistId - playlist ID
+     * @param stepId - Step ID
+     */
+    trackStepStarted(playlistId: string, stepId: string): void;
+    /**
+     * Tracks a step completion event
+     * @param playlistId - playlist ID
+     * @param stepId - Step ID
+     */
+    trackStepComplete(playlistId: string, stepId: string): void;
+    /**
+     * Tracks an interaction event
+     * @param playlistId - playlist ID
+     * @param stepId - Step ID
+     * @param interactionData - Interaction data
+     */
+    trackInteraction(playlistId: string, stepId: string, interactionData: Record<string, any>): void;
+    /**
+     * Tracks an error event
+     * @param playlistId - playlist ID
+     * @param error - Error object
+     * @param stepId - Optional step ID
+     * @param errorType - Optional error type/category (e.g., 'playlist', 'video', 'network', 'initialization')
+     */
+    trackError(playlistId: string, error: Error, stepId?: string, errorType?: string): void;
+    /**
+     * Tracks a generic event
+     * @param event - Event data
+     */
+    private trackEvent;
+    /**
+     * Sends queued events to the backend
+     */
+    private flushEvents;
+    /**
+     * Cleans up resources used by the analytics manager
+     */
+    destroy(): void;
+    /**
+     * Gets the current runId from the player
+     * @returns The current runId or null if not available
+     */
+    private getRunId;
+}
+//# sourceMappingURL=AnalyticsManager.d.ts.map

package/dist/managers/AnalyticsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsManager.d.ts","sourceRoot":"","sources":["../../src/managers/AnalyticsManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,gBAAgB,CAAiB;IAEzC;;;OAGG;gBACS,YAAY,CAAC,EAAE,YAAY;IAMvC;;;OAGG;IACI,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAKxD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgGzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBnE;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAIpC;;;OAGG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAkBnD;;;OAGG;IACI,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAkBtD;;;;OAIG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBjE;;;;OAIG;IACI,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBlE;;;;;OAKG;IACI,gBAAgB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnC,IAAI;IAmBP;;;;;;OAMG;IACI,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAuB9F;;;OAGG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;YACW,WAAW;IAoDzB;;OAEG;IACI,OAAO,IAAI,IAAI;IA2BtB;;;OAGG;IACH,OAAO,CAAC,QAAQ;CASjB"}

package/dist/managers/ButtonManager.d.ts

@@ -0,0 +1,40 @@
+import type { PlayerState } from '../types';
+import type { VideoManager } from './VideoManager';
+/**
+ * ButtonManager is responsible for managing the display of
+ * playback buttons, DOM click buttons, and other UI controls in the player.
+ */
+export declare class ButtonManager {
+    private playbackButtonsVisible;
+    private rootElement;
+    private playButton;
+    private centerPlayButton;
+    private videoManager;
+    constructor();
+    /**
+     * Initializes the ButtonManager with the root element and video manager
+     * Should be called after the player UI is created
+     * @param element - The root element containing the player controls
+     * @param videoManager - The video manager for handling interactions
+     */
+    initialize(element: HTMLElement, videoManager: VideoManager): void;
+    /**
+     * Displays or hides the DOM click button based on the given visibility state
+     * @param visible - Whether the button should be visible
+     */
+    /**
+     * Displays or hides the playback buttons based on the given visibility state
+     * @param visible - Whether the buttons should be visible
+     */
+    displayPlaybackButtons(visible: boolean): void;
+    /**
+     * Updates the play/pause button state based on the video state
+     * @param state - The current video state ('playing' or 'paused')
+     */
+    updatePlayPauseButton(state: PlayerState): void;
+    /**
+     * Cleans up any resources used by the button manager
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=ButtonManager.d.ts.map

package/dist/managers/ButtonManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonManager.d.ts","sourceRoot":"","sources":["../../src/managers/ButtonManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,YAAY,CAA6B;;IAMjD;;;;;OAKG;IACI,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;IAmFzE;;;OAGG;IAEH;;;OAGG;IACI,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAYrD;;;OAGG;IACI,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA4FtD;;OAEG;IACI,OAAO,IAAI,IAAI;CAQvB"}