@maestro_io/maestro-web-sdk 4.0.0-beta.5 → 4.0.1

package/dist/src/services/BetsService.js

@@ -0,0 +1,122 @@
+import { HttpMethod } from './NetworkManager/NetworkManager';
+import NetworkManagerFactory from './NetworkManager/NetworkManagerFactory';
+/**
+ * Service for handling bets-related API calls
+ */
+class BetsService {
+    constructor(delegate) {
+        Object.defineProperty(this, "networkManager", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.networkManager = NetworkManagerFactory.createBetsNetworkManager(delegate.getBettingAPIBaseURL());
+    }
+    /**
+     * Get non-personalized bets for an event
+     *
+     * @deprecated Use getPersonalizedBets instead. This method is kept for backward compatibility.
+     * @param eventID - The ID of the event
+     * @returns Promise with the bets data
+     */
+    async getNonPersonalizedBets(eventID) {
+        return this.networkManager.externalApiRequest({
+            endpoint: this.nonPersonalizedBetsEndpoint(eventID),
+            method: HttpMethod.GET,
+            params: {},
+            headers: {},
+        });
+    }
+    /**
+     * Get personalized bets for an event
+     *
+     * @param eventID - The ID of the event
+     * @param swid - The ESPN SWID parameter (format provided by client app delegate)
+     * @param jwt - The authorization JWT (empty string for anonymous users)
+     * @returns Promise with the personalized bets data
+     */
+    async getPersonalizedBets(eventID, swid, jwt) {
+        return this.networkManager.externalApiRequest({
+            endpoint: this.personalizedBetsEndpoint(eventID),
+            method: HttpMethod.GET,
+            params: { swid },
+            headers: { 'x-p13n-auth': jwt },
+        });
+    }
+    /**
+     * Get personalized bets for an event with headers
+     *
+     * @param eventID - The ID of the event
+     * @param swid - The ESPN SWID parameter (format provided by client app delegate)
+     * @param jwt - The authorization JWT (empty string for anonymous users)
+     * @returns Promise with the personalized bets data and headers
+     */
+    async getPersonalizedBetsWithHeaders(eventID, swid, jwt) {
+        return this.networkManager.externalApiRequestWithHeaders({
+            endpoint: this.personalizedBetsEndpoint(eventID),
+            method: HttpMethod.GET,
+            params: { swid },
+            headers: { 'x-p13n-auth': jwt },
+        });
+    }
+    /**
+     * Start polling for personalized bets
+     *
+     * @param eventID - The ID of the event
+     * @param swid - The ESPN SWID parameter
+     * @param jwt - The authorization JWT
+     * @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
+     */
+    pollPersonalizedBets(eventID, swid, jwt, interval, onData, onError) {
+        return this.networkManager.pollExternalApiRequest({
+            endpoint: this.personalizedBetsEndpoint(eventID),
+            interval,
+            method: HttpMethod.GET,
+            params: { swid },
+            headers: { 'x-p13n-auth': jwt },
+            onData,
+            onError,
+        });
+    }
+    /**
+     * Start polling for personalized bets and return both data and headers
+     *
+     * @param eventID - The ID of the event
+     * @param swid - The ESPN SWID parameter
+     * @param jwt - The authorization JWT
+     * @param interval - The polling interval in milliseconds
+     * @param onData - Callback for successful data fetch with headers
+     * @param onError - Callback for errors
+     * @returns Object with a stop function to stop polling
+     */
+    pollPersonalizedBetsWithHeaders(eventID, swid, jwt, interval, onData, onError) {
+        return this.networkManager.pollExternalApiRequestWithHeaders({
+            endpoint: this.personalizedBetsEndpoint(eventID),
+            interval,
+            method: HttpMethod.GET,
+            params: { swid },
+            headers: { 'x-p13n-auth': jwt },
+            onData,
+            onError,
+        });
+    }
+    /**
+     * Get the endpoint for non-personalized bets
+     *
+     * @deprecated This endpoint is no longer used.
+     */
+    nonPersonalizedBetsEndpoint(eventID) {
+        return `/site/v2/events/${eventID}/odds`;
+    }
+    /**
+     * Get the endpoint for personalized bets
+     */
+    personalizedBetsEndpoint(eventID) {
+        return `/personalized/site/v2/events/${eventID}/odds`;
+    }
+}
+export default BetsService;

package/dist/src/services/FantasyService.d.ts

@@ -0,0 +1,53 @@
+import { IFantasyResponse, ILeagueManagerResponse, IPromoResponse } from '@/modules/fantasy/types';
+export type LeagueManagerPollingParams = {
+    /**
+     * NBA, NFL, etc.
+     */
+    game: string;
+    /**
+     * 2025
+     */
+    seasonId: number;
+    /**
+     * The league ID
+     */
+    leagueId: number;
+    token: string;
+    proGameId: string;
+    teamId: number;
+};
+export type FantasyPollingParams = {
+    swid: string;
+    jwt: string;
+    eventId: string;
+};
+/**
+ * Service for handling fantasy API calls
+ */
+declare class FantasyService {
+    private fantasyClient;
+    private leagueManagerClient;
+    private promoClient;
+    constructor();
+    /**
+     * Polls the fantasy API at regular intervals
+     * @param swid - The SWID of the user
+     * @param interval - Polling interval in milliseconds
+     * @param onData - Callback invoked with the data on each successful poll
+     * @param onError - Optional callback invoked on error
+     */
+    pollFantasy({ eventId, jwt, swid }: FantasyPollingParams, interval: number, onData: (data: {
+        data: IFantasyResponse;
+        headers: Record<string, string>;
+    }) => void, onError?: (error: Error) => void): {
+        stop: () => void;
+    };
+    pollLeagueManager({ game, leagueId, seasonId, token, proGameId, teamId, }: LeagueManagerPollingParams, interval: number, onData: (data: {
+        data: ILeagueManagerResponse;
+        headers: Record<string, string>;
+    }) => void, onError?: (error: Error) => void): {
+        stop: () => void;
+    };
+    getPromo(): Promise<IPromoResponse>;
+}
+export default FantasyService;

package/dist/src/services/FantasyService.js

@@ -0,0 +1,92 @@
+import NetworkManagerFactory from './NetworkManager/NetworkManagerFactory';
+/**
+ * Service for handling fantasy API calls
+ */
+class FantasyService {
+    constructor() {
+        Object.defineProperty(this, "fantasyClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "leagueManagerClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "promoClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.fantasyClient = NetworkManagerFactory.createForService({
+            externalBaseURL: 'https://fan.api.espn.com/apis/v2/fans',
+            serviceType: 'fantasy',
+        });
+        this.leagueManagerClient = NetworkManagerFactory.createForService({
+            externalBaseURL: 'https://lm-api-reads.fantasy.espn.com/apis/v3/games',
+            serviceType: 'fantasy',
+        });
+        this.promoClient = NetworkManagerFactory.createForService({
+            externalBaseURL: 'https://client.espncdn.com/ictv/promo.json',
+            serviceType: 'fantasy',
+        });
+    }
+    /**
+     * Polls the fantasy API at regular intervals
+     * @param swid - The SWID of the user
+     * @param interval - Polling interval in milliseconds
+     * @param onData - Callback invoked with the data on each successful poll
+     * @param onError - Optional callback invoked on error
+     */
+    pollFantasy({ eventId, jwt, swid }, interval, onData, onError) {
+        return this.fantasyClient.pollExternalApiRequestWithHeaders({
+            endpoint: swid,
+            interval,
+            headers: {
+                'x-p13n-auth': jwt,
+            },
+            onData,
+            onError,
+            params: {
+                displayHiddenPrefs: true,
+                prefType: 'fantasy',
+                context: 'fantasy',
+                useCookieAuth: true,
+                source: 'fantasyictv-bbd',
+                featureFlags: 'challengeEntries',
+                filterType: 'FANTASY_CTV',
+                platform: 'fantasyictv_bbd',
+                swid,
+                eventId,
+            },
+        });
+    }
+    pollLeagueManager({ game, leagueId, seasonId, token, proGameId, teamId, }, interval, onData, onError) {
+        return this.leagueManagerClient.pollExternalApiRequestWithHeaders({
+            endpoint: `/${game}/seasons/${seasonId}/segments/0/leagues/${leagueId}/scoreboard`,
+            interval,
+            onData,
+            onError,
+            headers: {
+                'x-p13n-auth': token,
+            },
+            params: {
+                view: 'ictv_scoreboard',
+                platform: 'fantasyictv_bbd',
+                proGameId,
+                teamId,
+            },
+        });
+    }
+    getPromo() {
+        return this.promoClient.externalApiRequest({
+            endpoint: '',
+            useCache: true,
+        });
+    }
+}
+export default FantasyService;

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

@@ -0,0 +1,279 @@
+import { ICacheManager } from '@/external/ports/cacheManager';
+import InsightsService from './InsightsService';
+import { PageConfig } from '../StaticService/types';
+type EventData = {
+    metadata?: Record<string, unknown>;
+    ontology: {
+        kingdom: string;
+        phylum: string;
+        class?: string;
+        order?: string;
+        family?: string;
+        genus?: string;
+        species?: string;
+    };
+};
+export default class InsightsPayloadBuilder {
+    currentTime: number;
+    serverOffsetTime: number;
+    insightsService: InsightsService;
+    cacheManager: ICacheManager;
+    pageConfig: PageConfig | null;
+    constructor();
+    getPayload(event: EventData): Promise<{
+        /**
+         * @description Event Domain. NAMESPACE env var.
+         * @example maestro
+         */
+        e_d: string;
+        /**
+         * @description Event stringified metadata. defaults to null.
+         * @example "{\"key\":\"value\"}"
+         */
+        e_m: string | null;
+        /**
+         * @description Event time accounting for offset.
+         */
+        e_t: number;
+        /**
+         * @description Event URL. defaults to undefined.
+         */
+        e_u: string;
+        /**
+         * @description Event ontology kingdom. This is the highest level of the ontology and can be used to identify the event type.
+         * @example 'panel', 'engage', 'espn_key_plays'
+         */
+        e0: string;
+        /**
+         * @description Event phylum.
+         * @example 'view', 'click', 'play clip'
+         */
+        e1: string;
+        /**
+         * @description Event class.
+         * @example 'panel_type'
+         */
+        e2: string | undefined;
+        /**
+         * @description Event order.
+         * @example 'panel_id'
+         */
+        e3: string | undefined;
+        /**
+         * @description Event family.
+         * @example 'panel_name'
+         */
+        e4: string | undefined;
+        /**
+         * @description Event genus. This is a more specific level of the ontology and can be used to identify the event type.
+         */
+        e5: string | undefined;
+        /**
+         * @description Event species. This is the most specific level of the ontology and can be used to identify the event type.
+         */
+        e6: string | undefined;
+        /**
+         * @description Current timestamp.
+         */
+        t: number;
+        /**
+         * @description User avatar URL. Stored in user profile. defaults to null
+         * @example GET 'https://api.maestro.io/userprofile/v1'
+         */
+        u_a: null;
+        /**
+         * @description User account created date in milliseconds since epoch. defaults to null
+         * @example account.created
+         */
+        u_c: null;
+        /**
+         * @description Logged User email. defaults to null
+         * @example account.email
+         */
+        u_e: null;
+        /**
+         * @description Logged User ID. defaults to null
+         * @example account._id
+         */
+        u_id: null;
+        /**
+         * @description Logged User is logged in or not. defaults to false
+         */
+        u_li: boolean;
+        /**
+         * @description Logged User name. defaults to null
+         * @example account.name
+         */
+        u_n: null;
+        /**
+         * @description Logged User new user or not. Usually we compare server time and account.created. If it was created less than 1 day ago it's a new user. defaults to false
+         * @example Math.abs((serverTime || Date.now()) - account.created) < msIn.day
+         */
+        u_nu: boolean;
+        /**
+         * @description Logged User service. defaults to null
+         * @example account.service
+         */
+        u_s: null;
+        /**
+         * @description Logged User UID. defaults to null
+         * @example account.uid
+         */
+        u_u: null;
+        /**
+         * @description Logged User name. defaults to null
+         * @example account.name
+         */
+        u_un: null;
+        /**
+         * @description Site domain.
+         * @example site.settings.domain.url. 'maestro.tv/site_slug'
+         */
+        si_d: string | undefined;
+        /**
+         * @description Site ID.
+         * @example site._id
+         */
+        si_id: string | undefined;
+        /**
+         * @description Site package ID.
+         * @example `${site.package.id}-sapphire`
+         */
+        si_pid: string;
+        /**
+         * @description Site package version.
+         * @example `${site.package.version}-sapphire`
+         */
+        si_pv: string;
+        /**
+         * @description Site slug.
+         * @example site.slug
+         */
+        si_s: string;
+        /**
+         * @description Session ID, which can be used to track the session across requests. You might wanna keep this fixed for the session you're in using a local storage or something related.
+         */
+        se_id: string;
+        /**
+         * @description Session created timestamp. Usually set when the first event is fired
+         * @example new Date().getTime()
+         */
+        se_s: number;
+        /**
+         * @description Referrer domain, which can be used to track the domain from which the user came. Defaults to "$direct"
+         * @example 'example.com'.
+         */
+        r_d: string;
+        /**
+         * @description Referrer source, which can be used to track the source from which the user came (queryParam.r). Defaults to null
+         * @example const urlParams = new URLSearchParams(window.location.search);
+         *              urlParams.get('r') || null
+         */
+        r_s: null;
+        /**
+         * @description Referrer URL, which can be used to track the full URL from which the user came. Defaults to "$direct"
+         * @example document.referrer
+         */
+        r_u: string;
+        /**
+         * @description Metadata version, used to track changes in the metadata structure.
+         * @example '1.00.0'
+         */
+        m_iv: string;
+        /**
+         * @description Unique identifier for the insights ID. Stored in site's document.
+         * @example site.settings.services.insights_id
+         */
+        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()
+         */
+        d_ct: number;
+        /**
+         * @description New device or not. If you want to keep track of new devices, you can use a local storage or something related
+         * @example localStorage.getItem('isNewDevice') === 'true'
+         */
+        d_nd: boolean;
+        /**
+         * @description Navigator Platform (more Web API specific).
+         * @example 'MacIntel', 'Win32', 'Linux x86_64'
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/platform
+         */
+        d_np: string;
+        /**
+         * @description A unique identifier for the device, which can be used to track the device across sessions. You might wanna save this into a local storage or something related.
+         * @example localStorage.getItem('devicePermanentId') || generateUniqueId()
+         */
+        d_pid: string;
+        /**
+         * @description Device screen height in pixels.
+         * @example window.screen.height
+         */
+        d_sh: number;
+        /**
+         * @description Device screen width in pixels.
+         * @example window.screen.width
+         */
+        d_sw: number;
+        /**
+         * @description Device tab ID, which can be used to track the device across tabs.
+         */
+        d_tid: string;
+        /**
+         * @description Device time in milliseconds since epoch.
+         */
+        d_tim: number;
+        /**
+         * @description Device time offset in milliseconds. You might wanna keep this fixed for the device you're in using a local storage or something related.
+         */
+        d_tof: number;
+        /**
+         * @description Device user agent string.
+         * @example navigator.userAgent ('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3')
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+         */
+        d_ua: string;
+        /**
+         * @description MongoDB page collection name (e.g. 'pages')
+         * @example object.collection
+         */
+        p_c: string;
+        /**
+         * @description MongoDB page document ID (e.g. 'pageId')
+         * @example object._id
+         */
+        p_id: string | undefined;
+        /**
+         * @description MongoDB page name (e.g. 'Home', 'Product Page')
+         * @example object.data.name || object.seo.title
+         */
+        p_n: string | undefined;
+        /**
+         * @description MongoDB page slug (e.g. 'home', 'product-page')
+         * @example object.slug
+         */
+        p_s: string | undefined;
+        /**
+         * @description MongoDB page type (e.g. 'landing', 'channel')
+         * @example object.type
+         */
+        p_t: string | undefined;
+    }>;
+    private getEventInsights;
+    private getPageInsights;
+    getDevicePermanentID(): string;
+    private getDeviceCreated;
+    private getTabID;
+    private getDeviceInsights;
+    private randomId;
+    private getDeviceOffset;
+    private getInsightsInsights;
+    private getMetadataInsights;
+    private getReferrerInsights;
+    private getSessionID;
+    private getSessionInsights;
+    private getSiteInsights;
+    private getUserInsights;
+}
+export {};