@maestro_io/maestro-web-sdk 2.2.3 → 2.2.4

package/dist/modules/stats/view-model/StatsViewModel.d.ts

@@ -115,12 +115,13 @@ export declare class StatsViewModel extends ViewModel {
     currentGameState: Observable<string>;
     statsService: StatsService;
     analyticsService: AnalyticsService;
-    private pollingInterval;
     private useMockData;
-    private pollingTask;
     private lastResponseHash;
+    private currentPlayerTimeCode;
+    private timecodePollingTask;
+    private smartPollingTimeout;
+    private timecodePollingState;
     constructor(eventId: string, delegate: IMaestroEventDelegate, options?: {
-        pollingInterval?: number;
         useMockData?: boolean;
     });
     /**
@@ -133,27 +134,66 @@ export declare class StatsViewModel extends ViewModel {
      */
     cleanup(): void;
     /**
-     * Fetch new stats data immediately (one-time)
+     * Handle player timecode updates with enhanced logging and validation
+     *
+     * @param playerTimeCode - The timecode in milliseconds, or null for live
      */
-    fetchNewData(): Promise<void>;
+    onUpdatePlayerTimeCode(playerTimeCode: number | null): void;
     /**
-     * Fetch mock data for testing
+     * Implement smart polling strategy: immediate API call + delayed polling resumption
+     *
+     * @param syncUrl - The sync URL to use for the API call
      */
-    private fetchMockData;
+    private performSmartPolling;
+    /**
+     * Enhanced error handling for timecode-related operations
+     *
+     * @param context - Description of where the error occurred
+     * @param error - The error that occurred
+     */
+    private handleTimecodeError;
+    /**
+     * Clear any pending smart polling timeout
+     */
+    private clearSmartPollingTimeout;
+    /**
+     * Reset timecode polling state
+     */
+    private resetTimecodePollingState;
     /**
-     * Refresh polling for bet data
+     * Build sync URL for timecode-based stats fetching with enhanced logging
+     * Enhanced with comprehensive validation and fallback strategies
+     *
+     * @param timeCode - The timecode in milliseconds, or null for 'latest'
+     * @returns Complete sync URL for the fauxcast stats endpoint
+     * @throws Error if page config is not available or required fields are missing
      */
-    refreshPolling(): void;
+    private buildSyncUrl;
     /**
-     * Poll with the correct method based on authentication status
+     * Format timecode for API consumption
+     * @param timeCode - Timecode in milliseconds or null
+     * @returns ISO date string, "pre.json" for pre-game, or "latest" for post-game
      */
-    private pollWithInterval;
+    private formatTimeCodeForAPI;
     /**
-     * Handle errors that occur during polling
+     * Start timecode-based polling with enhanced logging
+     *
+     * @param syncUrl - The sync URL to poll
      */
-    private handlePollingError;
+    private startTimecodePolling;
     /**
-     * Process data received from polling
+     * Stop timecode-based polling with enhanced logging
+     */
+    private stopTimecodePolling;
+    /**
+     * Fetch mock data for testing
+     */
+    private fetchMockData;
+    /**
+     * Process polled data with hash comparison to avoid unnecessary re-renders
+     * Enhanced with comprehensive logging to show data changes
+     *
+     * @param data - The stats data received from the API
      */
     private processPolledData;
     private processData;
@@ -171,10 +211,6 @@ export declare class StatsViewModel extends ViewModel {
      * Simulate a use case using mock StatsApiResponse data
      */
     simulateUseCase<T = any>(_useCase: TestUseCase, testData?: T): void;
-    /**
-     * Stop polling for bet data
-     */
-    stopPolling(): void;
 }
 declare global {
     interface String {

package/dist/services/StatsService.d.ts

@@ -8,29 +8,30 @@ declare class StatsService {
     networkManager: IStatsNetworkManager;
     constructor(delegate: IMaestroEventDelegate);
     /**
-     * Get stats for an event
+     * Get stats using a full sync URL (for timecode support)
      *
-     * @param eventID - The ID of the event
-     * @param gameState - Optional game state filter (e.g., 'pre', 'in', 'post')
+     * @param syncUrl - Complete sync URL (e.g., https://client.espn.com/fauxcast/stats/...)
      * @returns Promise with the stats data
      */
-    getStats(eventID: string, gameState?: string): Promise<StatsApiResponse>;
+    getStatsByUrl(syncUrl: string): Promise<StatsApiResponse>;
     /**
-     * Start polling for stats
+     * Start polling using a full sync URL (for timecode support)
      *
-     * @param eventID - The ID of the event
-     * @param gameState - Optional game state filter (e.g., 'pre', 'in', 'post')
+     * @param syncUrl - Complete sync URL (e.g., https://client.espn.com/fauxcast/stats/...)
      * @param interval - The polling interval in milliseconds
      * @param onData - Callback for successful data fetch
      * @param onError - Callback for errors
      * @returns Object with a stop function to stop polling
      */
-    pollStats(eventID: string, gameState: string | undefined, interval: number, onData: (data: StatsApiResponse) => void, onError?: (error: Error) => void): {
+    pollStatsByUrl(syncUrl: string, interval: number, onData: (data: StatsApiResponse) => void, onError?: (error: Error) => void): {
         stop: () => void;
     };
     /**
-     * Get the endpoint for stats
+     * Parse a sync URL into base URL and endpoint
+     *
+     * @param syncUrl - Complete sync URL
+     * @returns Object with baseUrl and endpoint
      */
-    statsEndpoint(eventID: string): string;
+    private parseSyncUrl;
 }
 export default StatsService;

package/dist/view-models/MaestroEventViewModel.d.ts

@@ -9,6 +9,7 @@ import StatsViewModel from '../modules/stats/view-model/StatsViewModel';
 import IMaestroKeyPlaysResponse from '../modules/key-plays/interfaces/IKeyPlaysResponse';
 import { MaestroPanelType } from '@/models/IPanel';
 import { IUserSettings } from '../interfaces/IUserSettings';
+import { PanelManagerViewModel } from './PanelManagerViewModel';
 export declare class MaestroEventViewModel extends ViewModel implements IMaestroEvent {
     private _eventId;
     private _title;
@@ -19,8 +20,10 @@ export declare class MaestroEventViewModel extends ViewModel implements IMaestro
     keyPlaysViewModel: KeyPlaysViewModel;
     betsViewModel: BetsViewModel;
     statsViewModel: StatsViewModel;
+    panelManagerViewModel: PanelManagerViewModel;
     navigation: SpatialNavigation;
     constructor(eventId: string | undefined, delegate: IMaestroEventDelegate);
+    setActivePanel(panelType: MaestroPanelType): void;
     updatePlayerTimeCode(timestamp: number): void;
     getPlayerTimeCode(): number | null;
     deinit(): void;

package/dist/view-models/PanelManagerViewModel.d.ts

@@ -7,7 +7,6 @@ export type PanelInfo = {
 export declare class PanelManagerViewModel {
     private _panels;
     private _currentPanel;
-    private _newlyFocusedPanel;
     private settingsManager;
     private settingsUnsubscribe;
     private readonly ALL_PANELS;
@@ -39,8 +38,7 @@ export declare class PanelManagerViewModel {
     get currentPanel(): MaestroPanelType | null;
     set currentPanel(value: MaestroPanelType | null);
     get currentPanelObservable(): Observable<MaestroPanelType | null>;
-    get newlyFocusedPanel(): MaestroPanelType | null;
-    set newlyFocusedPanel(value: MaestroPanelType | null);
+    setActivePanel(panelType: MaestroPanelType): void;
     getIndex(forPanelType: MaestroPanelType): number | null;
     getPanelType(atIndex: number): MaestroPanelType | null;
     get panelTypeToLeft(): MaestroPanelType | null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maestro_io/maestro-web-sdk",
   "private": false,
-  "version": "2.2.3",
+  "version": "2.2.4",
   "type": "commonjs",
   "license": "MIT",
   "main": "dist/maestro-web-sdk.umd.js",

package/dist/view-models/index.d.ts

@@ -1,23 +0,0 @@
-import { MaestroEventViewModel } from './MaestroEventViewModel';
-import { PanelManagerViewModel } from './PanelManagerViewModel';
-import { OverlayViewModel } from './OverlayViewModel';
-import IMaestroEventDelegate from '../interfaces/IMaestroEventDelegate';
-import KeyPlaysViewModel from '../modules/key-plays/view-model/KeyPlaysViewModel';
-/**
- * Aggregates all View Models
- */
-export declare class MaestroViewModels {
-    readonly eventViewModel: MaestroEventViewModel;
-    readonly panelManagerViewModel: PanelManagerViewModel;
-    readonly keyPlaysViewModel: KeyPlaysViewModel;
-    readonly overlayViewModel: OverlayViewModel;
-    constructor(eventViewModel: MaestroEventViewModel);
-    /**
-     * Cleanup all view models
-     */
-    cleanup(): void;
-    /**
-     * Creates view models from an event ID
-     */
-    static fromEventId(eventId: string, delegate: IMaestroEventDelegate): Promise<MaestroViewModels | null>;
-}