@maestro_io/maestro-web-sdk 5.0.0 → 5.1.0

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

@@ -0,0 +1,322 @@
+import { Observable } from '../../../../helpers/Observable';
+import { ViewModel } from '../../../../view-models/ViewModel';
+import { Athlete, CareerMatchupStatistic, DrivePlay, Team } from '../interfaces/IStats';
+import { AthletesStatisticsItem } from '../view/components/AthletesStatistics/AthletesStatistics';
+import StatsService from '../services/StatsService';
+import IMaestroEventDelegate from '@/interfaces/IMaestroEventDelegate';
+import AnalyticsService from '@/services/AnalyticsService/AnalyticsService';
+declare const STATS_ERROR_STATE: {
+    readonly NONE: "none";
+    readonly TAB_LOAD_FAILURE: "tabLoadFailure";
+};
+export type StatsErrorState = typeof STATS_ERROR_STATE[keyof typeof STATS_ERROR_STATE];
+export type HeaderTeamStatItem = {
+    type: 'headerTeam';
+    isLive: boolean;
+    linescoresHeader: string[];
+    linescoresRowHeader?: 'teamLogo' | 'teamName';
+    statistics?: {
+        displayName: string;
+        homeTeamValue: number;
+        awayTeamValue: number;
+        awayTeamDisplayValue: string;
+        homeTeamDisplayValue: string;
+    }[];
+    homeTeam: Pick<Team, 'color' | 'id' | 'logo' | 'name' | 'abbreviation' | 'record'> & {
+        linescores: string[];
+        details?: string[];
+    };
+    awayTeam: Pick<Team, 'color' | 'id' | 'logo' | 'name' | 'abbreviation' | 'record'> & {
+        linescores: string[];
+        details?: string[];
+    };
+};
+type RecentGamesPreviousGame = {
+    score: string;
+    gameResult: string;
+    teamLogo?: string;
+    homeAway: string;
+};
+type RecentGamesTeam = {
+    logo?: string;
+    name?: string;
+    events: RecentGamesPreviousGame[];
+};
+export type RecentGamesStatsItem = {
+    type: 'recentGames';
+    awayTeam: RecentGamesTeam;
+    homeTeam: RecentGamesTeam;
+};
+export type WinProbabilityStatsItem = {
+    type: 'winProbability';
+    chartImageUrl: string;
+    awayTeam: Pick<Team, 'id' | 'abbreviation' | 'logo'> & {
+        winPercentage: string;
+    };
+    homeTeam: Pick<Team, 'id' | 'abbreviation' | 'logo'> & {
+        winPercentage: string;
+    };
+};
+export type GameLeadersStatsItem = {
+    type: 'gameLeaders';
+    displayText: string;
+    items: AthletesStatisticsItem[];
+};
+export type ActiveAthletesItem = {
+    type: 'activeAthletes';
+    displayText: string;
+    awayTeam: Pick<Team, 'id' | 'logo' | 'name'>;
+    homeTeam: Pick<Team, 'id' | 'logo' | 'name'>;
+    athletes: AthletesStatisticsItem[];
+};
+export type StatsPromotionItem = {
+    type: 'promotion';
+    title: string;
+    description: string;
+    logo: string;
+    qrCode: string;
+    backgroundImage: string;
+};
+export type StatsMatchPredictorItem = {
+    type: 'matchPredictor';
+    header: string;
+    imageUrl: string;
+    awayTeam: Pick<Team, 'abbreviation' | 'logo' | 'displayName'> & {
+        percentage: number;
+    };
+    homeTeam: Pick<Team, 'abbreviation' | 'logo' | 'displayName'> & {
+        percentage: number;
+    };
+};
+export type TeamStatsStatistics = {
+    displayName: string;
+    awayTeamDisplayValue: string;
+    homeTeamDisplayValue: string;
+    awayTeamValue: number;
+    homeTeamValue: number;
+};
+export type TeamStatsItem = {
+    type: 'teamStats';
+    awayTeam: Pick<Team, 'logo' | 'displayName' | 'color' | 'abbreviation'>;
+    homeTeam: Pick<Team, 'logo' | 'displayName' | 'color' | 'abbreviation'>;
+    statistics?: TeamStatsStatistics[];
+    tabbedStatistics?: Record<string, {
+        title: string;
+        entries: TeamStatsStatistics[];
+    }>;
+    title: string;
+};
+export type DriveSummaryItem = {
+    type: 'driveSummary';
+    id: string;
+    team: Pick<Team, 'logo' | 'displayName'>;
+    playsQuantity: string;
+    yards: string;
+    time: string;
+    lastPlayMarquee: string;
+    plays: DrivePlay[];
+};
+export type IScoreItem = {
+    teamLogo?: string;
+    teamName?: string;
+    athletePosition?: string;
+    athleteNumber?: string;
+    athleteName?: string;
+    athleteAssists?: string;
+    athleteThumbnail?: string;
+    description: string;
+    clock: string;
+};
+export type IScoreSection = {
+    title: string;
+    scores: IScoreItem[];
+};
+export type ScoringSummarySectionTeam = {
+    teamLogo: string;
+    teamName: string;
+    header: Array<{
+        featured: boolean;
+        title: string;
+    }>;
+    text: string;
+    shortText: Array<{
+        featured: boolean;
+        title: string;
+    }>;
+    headshot?: string;
+    athleteShortName?: string;
+    athletePosition?: string;
+    athleteJersey?: string;
+};
+export type ScoringSummarySection = {
+    title: string;
+    items: ScoringSummarySectionTeam[];
+};
+export type ScoringSummaryItem = {
+    type: 'scoringSummary';
+    tag: string;
+    title: string;
+    sections: ScoringSummarySection[];
+};
+export type PenaltiesItem = {
+    type: 'penalties';
+    tag: string;
+    title: string;
+    sections: ScoringSummarySection[];
+};
+export type PlayerSeasonStatsPlayerItem = {
+    title: string;
+    headshot: string;
+    position: string;
+    jersey: string;
+    featuredStat: {
+        displayValue: string;
+        label: string;
+    } | null;
+    statistics: Array<{
+        displayValue: string;
+        label: string;
+    }>;
+    playerStatus: {
+        displayName: string;
+        type: string;
+    } | null;
+};
+export type PlayerSeasonStatsSection = {
+    title: string;
+    items: PlayerSeasonStatsPlayerItem[];
+};
+export type PlayerSeasonStatsTeam = {
+    teamKey: string;
+    shortDisplayName: string;
+    color: string;
+    sections: PlayerSeasonStatsSection[];
+};
+export type PlayerSeasonStatsItem = {
+    type: 'playerSeasonStats';
+    teams: PlayerSeasonStatsTeam[];
+};
+export interface CareerMatchupViewItem {
+    status?: string;
+    isHighlighted?: boolean;
+    type: string;
+    displayName: string;
+    athlete?: Athlete;
+}
+export interface CareerMatchupViewSection {
+    items: CareerMatchupViewItem[];
+    statistics: CareerMatchupStatistic[];
+}
+export type CareerMatchupStatsItem = {
+    type: 'careerMatchup';
+    title: string;
+    sections: CareerMatchupViewSection[];
+};
+export type StatsItem = HeaderTeamStatItem | RecentGamesStatsItem | WinProbabilityStatsItem | GameLeadersStatsItem | ActiveAthletesItem | StatsPromotionItem | StatsMatchPredictorItem | TeamStatsItem | DriveSummaryItem | ScoringSummaryItem | PenaltiesItem | PlayerSeasonStatsItem | CareerMatchupStatsItem;
+export declare class StatsViewModel extends ViewModel {
+    isDataLoading: Observable<boolean>;
+    hasEverSuccessfullyLoaded: Observable<boolean>;
+    eventId: string;
+    statsItems: Observable<StatsItem[]>;
+    errorState: Observable<StatsErrorState>;
+    currentGameState: Observable<string>;
+    statsService: StatsService;
+    analyticsService: AnalyticsService;
+    private useMockData;
+    private lastResponseHash;
+    private currentPlayerTimeCode;
+    private timecodePollingTask;
+    private smartPollingTimeout;
+    private timecodePollingState;
+    constructor(eventId: string, delegate: IMaestroEventDelegate, analyticsService: AnalyticsService, options?: {
+        useMockData?: boolean;
+    });
+    /**
+     * Sets panel-specific data configuration
+     * @param panelData - Object containing panel configuration
+     */
+    setDataToPanel(panelData: Record<string, any>): void;
+    /**
+     * Initialize the ViewModel and start data fetching
+     */
+    init(): Promise<void>;
+    /**
+     * Get the current timecode from the MaestroEventViewModel
+     * This prevents the stats panel from always defaulting to real-time data
+     */
+    private getCurrentTimeCode;
+    onEngage: (type: StatsItem['type']) => void;
+    /**
+     * Clean up resources when the ViewModel is no longer needed
+     */
+    cleanup(): void;
+    /**
+     * Handle player timecode updates with enhanced logging and validation
+     *
+     * @param playerTimeCode - The timecode in milliseconds, or null for live
+     */
+    onUpdatePlayerTimeCode(playerTimeCode: number | null): void;
+    clearTabLoadFailure(): void;
+    /**
+     * Implement smart polling strategy: immediate API call + delayed polling resumption
+     *
+     * @param playerTimeCode - The timecode in milliseconds, or null
+     */
+    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;
+    /**
+     * Start timecode-based polling with enhanced logging
+     *
+     * @param playerTimeCode - The timecode in milliseconds, or null
+     */
+    private startTimecodePolling;
+    /**
+     * 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;
+    private parseDriveSummary;
+    private parseTeamsStatistics;
+    private parseTeamSeasonStatistics;
+    private parseMatchPredictor;
+    private parsePromotion;
+    private parseCareerMatchup;
+    private parseHeaderTeams;
+    private parseHeaderTeamsFromHeader;
+    private parseHeaderTeamsFromTeamHeader;
+    private buildHeaderTeamsItem;
+    private parseRecentGames;
+    private parseWinProbability;
+    private parseGameLeaders;
+    private parseActiveAthletes;
+    private getActiveAthletesTeamInfo;
+    private parseScoringSummary;
+    private parsePenalties;
+    private parsePlayerSeasonStats;
+}
+export default StatsViewModel;