@maestro_io/maestro-web-sdk 2.2.2 → 2.2.4

package/dist/modules/bets/types/BetsAnalyticsTypes.d.ts

@@ -1,4 +1,3 @@
-import { BaseMetadata } from '../../../services/AnalyticsService/types';
 /**
  * Valid bet types as specified in the analytics spec
  */
@@ -7,19 +6,3 @@ export type BetType = 'straight' | 'parlay' | 'parlay_plus' | 'teaser' | 'boost'
  * Valid card types for bets module
  */
 export type BetCardType = '6-pack' | 'my bets > live' | 'my bets > settled' | 'my bets > upcoming' | 'hot-props' | 'promo' | 'disclaimer';
-/**
- * Metadata for bet panel view events
- */
-export interface BetPanelViewMetadata extends BaseMetadata {
-    in_game_bets: number;
-    total_bets: number;
-}
-/**
- * Metadata for bet card click events
- */
-export interface BetCardClickMetadata extends BaseMetadata {
-    card: BetCardType;
-    in_game_bets: number;
-    total_bets: number;
-    bet_type: BetType | null;
-}

package/dist/modules/bets/view-model/BetsViewModel.d.ts

@@ -138,10 +138,6 @@ export declare class BetsViewModel extends ViewModel {
      * Track card click event
      */
     trackCardClick(cardType: BetCardType, betType?: BetType | null): Promise<void>;
-    /**
-     * Get base metadata for analytics events
-     */
-    private getBaseMetadata;
     /**
      * Get user bet counts for analytics
      */

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

@@ -4,6 +4,7 @@ import { DrivePlay, Team } from '../interfaces/IStats';
 import { AthletesStatisticsItem } from '../view/components/AthletesStatistics/AthletesStatistics';
 import StatsService from '@/services/StatsService';
 import IMaestroEventDelegate from '@/interfaces/IMaestroEventDelegate';
+import { TestUseCase } from '@/interfaces/IMaestroEvent';
 import AnalyticsService from '@/services/AnalyticsService/AnalyticsService';
 declare const STATS_ERROR_STATE: {
     readonly NONE: "none";
@@ -114,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;
     });
     /**
@@ -132,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;
+    /**
+     * 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
+     */
+    private buildSyncUrl;
     /**
-     * Refresh polling for bet data
+     * 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
      */
-    refreshPolling(): void;
+    private formatTimeCodeForAPI;
     /**
-     * Poll with the correct method based on authentication status
+     * Start timecode-based polling with enhanced logging
+     *
+     * @param syncUrl - The sync URL to poll
      */
-    private pollWithInterval;
+    private startTimecodePolling;
     /**
-     * Handle errors that occur during polling
+     * Stop timecode-based polling with enhanced logging
      */
-    private handlePollingError;
+    private stopTimecodePolling;
+    /**
+     * Fetch mock data for testing
+     */
+    private fetchMockData;
     /**
-     * Process data received from polling
+     * 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;
@@ -167,9 +208,9 @@ export declare class StatsViewModel extends ViewModel {
     private parseActiveAthletes;
     private getActiveAthletesTeamInfo;
     /**
-     * Stop polling for bet data
+     * Simulate a use case using mock StatsApiResponse data
      */
-    stopPolling(): void;
+    simulateUseCase<T = any>(_useCase: TestUseCase, testData?: T): void;
 }
 declare global {
     interface String {

package/dist/services/AnalyticsService/AnalyticsService.d.ts

@@ -1,31 +1,20 @@
 import InsightsPayloadBuilder from '../InsightsService/InsightsPayloadBuilder';
 import InsightsService from '../InsightsService/InsightsService';
-import { Metadata } from './types';
+import { PageConfig } from '../PageService/types';
+import { BaseMetadata } from './types';
 type KeyPlaysClickedAction = {
-    panel_id: string;
-    panel_name: string;
-    panel_type: string;
+    type: 'espnKeyPlays';
     name: 'key_play_clicked';
     metadata: {
-        league: string;
-        event: string;
-        airing: string;
-        sport: string;
         action: string;
         clip: string;
         key_play: string;
     };
 };
 type BetsItemClickedAction = {
-    panel_id: string;
-    panel_name: string;
-    panel_type: string;
+    type: 'espnBet';
     name: 'bets_item_clicked';
     metadata: {
-        league: string;
-        event: string;
-        airing: string;
-        sport: string;
         card: string;
         bet_type: string | null;
         in_game_bets: number;
@@ -33,25 +22,18 @@ type BetsItemClickedAction = {
     };
 };
 type StatsItemClickedAction = {
-    panel_id: string;
-    panel_name: string;
-    panel_type: string;
+    type: 'espnStats';
     name: 'stats_item_clicked';
     metadata: {
-        league: string;
-        event: string;
-        airing: string;
-        sport: string;
         card: string[];
         game_state: string[];
     };
 };
 type PanelClickPayload = KeyPlaysClickedAction | BetsItemClickedAction | StatsItemClickedAction;
-type PanelViewPayload = {
+type PanelData = {
     panel_type: string;
     panel_id: string;
     panel_name: string;
-    metadata: Metadata;
 };
 declare class AnalyticsService {
     insightsService: InsightsService;
@@ -59,7 +41,9 @@ declare class AnalyticsService {
     constructor();
     private trackAction;
     private trackImpression;
-    panelView({ panel_type, panel_id, panel_name, metadata, }: PanelViewPayload): Promise<void>;
-    panelClick({ panel_type, panel_id, panel_name, metadata, name, }: PanelClickPayload): Promise<void>;
+    panelView(panelType: 'espnStats' | 'espnKeyPlays' | 'espnBet', metadata?: Record<string, any>): Promise<void>;
+    panelClick({ type, metadata, name }: PanelClickPayload): Promise<void>;
+    getBaseMetadataFromPageConfig(pageConfig: PageConfig | null): BaseMetadata;
+    getPanelDataFromPageConfig(type: 'espnBet' | 'espnStats' | 'espnKeyPlays', pageConfig: PageConfig | null): PanelData;
 }
 export default AnalyticsService;

package/dist/services/InsightsService/InsightsPayloadBuilder.d.ts

@@ -1,5 +1,6 @@
 import { ICacheManager } from '@/external/ports/cacheManager';
 import InsightsService from './InsightsService';
+import { PageConfig } from '../PageService/types';
 type EventData = {
     url?: string;
     metadata?: Record<string, unknown>;
@@ -18,6 +19,7 @@ export default class InsightsPayloadBuilder {
     serverOffsetTime: number;
     insightsService: InsightsService;
     cacheManager: ICacheManager;
+    pageConfig: PageConfig | null;
     constructor();
     getPayload(event: EventData): Promise<{
         /**
@@ -128,12 +130,12 @@ export default class InsightsPayloadBuilder {
          * @description Site domain.
          * @example site.settings.domain.url. 'maestro.tv/site_slug'
          */
-        si_d: string;
+        si_d: string | undefined;
         /**
          * @description Site ID.
          * @example site._id
          */
-        si_id: string;
+        si_id: string | undefined;
         /**
          * @description Site package ID.
          * @example `${site.package.id}-sapphire`
@@ -183,7 +185,7 @@ export default class InsightsPayloadBuilder {
          * @description Unique identifier for the insights ID. Stored in site's document.
          * @example site.settings.services.insights_id
          */
-        i_id: string;
+        i_id: string | null | undefined;
         /**
          * @description Device created timestamp. You might wanna keep this fixed for the device you're in using a local storage or something related
          * @example new Date().getTime()
@@ -242,22 +244,22 @@ export default class InsightsPayloadBuilder {
          * @description MongoDB page document ID (e.g. 'pageId')
          * @example object._id
          */
-        p_id: string;
+        p_id: string | undefined;
         /**
          * @description MongoDB page name (e.g. 'Home', 'Product Page')
          * @example object.data.name || object.seo.title
          */
-        p_n: string;
+        p_n: string | undefined;
         /**
          * @description MongoDB page slug (e.g. 'home', 'product-page')
          * @example object.slug
          */
-        p_s: string;
+        p_s: string | undefined;
         /**
          * @description MongoDB page type (e.g. 'landing', 'channel')
          * @example object.type
          */
-        p_t: string;
+        p_t: string | undefined;
     }>;
     private getEventInsights;
     private getPageInsights;

package/dist/services/PageService/PageService.d.ts

@@ -0,0 +1,8 @@
+import { Observable } from '../../helpers/Observable';
+import { PageConfig } from './types';
+export default class PageService {
+    configObservable: Observable<PageConfig | null>;
+    private client;
+    constructor();
+    fetchPageConfig(siteId: string, eventId: string): Promise<PageConfig | null>;
+}

package/dist/services/PageService/index.d.ts

@@ -0,0 +1,2 @@
+import PageService from './PageService';
+export default PageService;

package/dist/services/PageService/mocks.d.ts

@@ -0,0 +1,2 @@
+import { PageConfig } from './types';
+export declare const MOCK_PAGE_CONFIG: PageConfig;

package/dist/services/PageService/types.d.ts

@@ -0,0 +1,53 @@
+import ITheme from '@/models/ITheme';
+interface PageConfigPanel {
+    _id: string;
+    slug: string;
+    panel_name?: string;
+    panel_type?: string;
+    icon_name?: string;
+}
+export type PageMetadata = {
+    /**
+     * Event ID or Airing ID
+     */
+    external_field_1?: string;
+    /**
+     * Sport guid
+     */
+    external_field_2?: string;
+    /**
+     * League guid
+     */
+    external_field_3?: string;
+    /**
+     * External field 1 identifier. Can be either 'airing' or 'event'.
+     */
+    external_field_4?: 'airing' | 'event';
+    /**
+     * A stringified JSON object containing additional metadata.
+     */
+    external_field_5?: string;
+};
+export interface PageConfig {
+    panels: PageConfigPanel[];
+    page: {
+        _id: string;
+        slug: string;
+        type: string;
+        name?: string;
+        metadata?: PageMetadata;
+    };
+    insights: {
+        _id: string | null;
+    };
+    site: {
+        _id: string;
+        domainUrl: string;
+        package: {
+            version: string;
+            id: string;
+        };
+    };
+    theme?: ITheme | null;
+}
+export {};

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

@@ -1,12 +1,16 @@
 import { Observable } from '../helpers/Observable';
 import { MaestroPanelType } from '../models/IPanel';
+export type PanelInfo = {
+    type: MaestroPanelType;
+    title: string;
+};
 export declare class PanelManagerViewModel {
     private _panels;
     private _currentPanel;
-    private _newlyFocusedPanel;
     private settingsManager;
     private settingsUnsubscribe;
     private readonly ALL_PANELS;
+    private getAvailablePanelsFromConfig;
     constructor();
     /**
      * Initialize panels based on current settings
@@ -17,9 +21,10 @@ export declare class PanelManagerViewModel {
      */
     private subscribeToSettingsChanges;
     /**
-     * Filter panels based on user settings
+     * Filter panels based on user settings and page config
      */
-    private filterPanelsBasedOnSettings;
+    private filterPanels;
+    private updateActivePanel;
     /**
      * Update panels when settings change
      */
@@ -28,13 +33,12 @@ export declare class PanelManagerViewModel {
      * Cleanup subscriptions
      */
     cleanup(): void;
-    get panels(): MaestroPanelType[];
-    get panelsObservable(): Observable<MaestroPanelType[]>;
-    get currentPanel(): MaestroPanelType;
-    set currentPanel(value: MaestroPanelType);
-    get currentPanelObservable(): Observable<MaestroPanelType>;
-    get newlyFocusedPanel(): MaestroPanelType | null;
-    set newlyFocusedPanel(value: MaestroPanelType | null);
+    get panels(): PanelInfo[];
+    get panelsObservable(): Observable<PanelInfo[]>;
+    get currentPanel(): MaestroPanelType | null;
+    set currentPanel(value: MaestroPanelType | null);
+    get currentPanelObservable(): Observable<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.2",
+  "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>;
-}