@maestro_io/maestro-web-sdk 3.3.1 → 4.0.0-beta.2

package/dist/src/external/spatial-navigation/utils.js

@@ -0,0 +1,6 @@
+export const DIRECTION_LEFT = 'left';
+export const DIRECTION_RIGHT = 'right';
+export const DIRECTION_UP = 'up';
+export const DIRECTION_DOWN = 'down';
+export const KEY_ENTER = 'enter';
+export const KEY_BACK = 'back';

package/dist/src/external/spatial-navigation/visualDebugger.js

@@ -0,0 +1,76 @@
+// We'll make VisualDebugger no-op for any environments lacking a DOM (e.g. SSR and React Native non-web platforms).
+const hasDOM = typeof window !== 'undefined' && window.document;
+const WIDTH = hasDOM ? window.innerWidth : 0;
+const HEIGHT = hasDOM ? window.innerHeight : 0;
+class VisualDebugger {
+    constructor() {
+        Object.defineProperty(this, "debugCtx", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "layoutsCtx", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (hasDOM) {
+            this.debugCtx = VisualDebugger.createCanvas('sn-debug', 1010);
+            this.layoutsCtx = VisualDebugger.createCanvas('sn-layouts', 1000);
+        }
+        else {
+            this.debugCtx = null;
+            this.layoutsCtx = null;
+        }
+    }
+    static createCanvas(id, zIndex) {
+        const canvas = (document.querySelector(`#${id}`) ||
+            document.createElement('canvas'));
+        canvas.setAttribute('id', id);
+        const ctx = canvas.getContext('2d');
+        if (!ctx) {
+            throw new Error('Could not get 2d context from canvas');
+        }
+        canvas.style.cssText = `position: fixed; top: 0; left: 0; z-index: ${zIndex}`;
+        document.body.appendChild(canvas);
+        canvas.width = WIDTH;
+        canvas.height = HEIGHT;
+        return ctx;
+    }
+    clear() {
+        if (!hasDOM || !this.debugCtx) {
+            return;
+        }
+        this.debugCtx.clearRect(0, 0, WIDTH, HEIGHT);
+    }
+    clearLayouts() {
+        if (!hasDOM || !this.layoutsCtx) {
+            return;
+        }
+        this.layoutsCtx.clearRect(0, 0, WIDTH, HEIGHT);
+    }
+    drawLayout(layout, focusKey, parentFocusKey) {
+        if (!hasDOM || !this.layoutsCtx) {
+            return;
+        }
+        this.layoutsCtx.strokeStyle = 'green';
+        this.layoutsCtx.strokeRect(layout.left, layout.top, layout.width, layout.height);
+        this.layoutsCtx.font = '8px monospace';
+        this.layoutsCtx.fillStyle = 'red';
+        this.layoutsCtx.fillText(focusKey, layout.left, layout.top + 10);
+        this.layoutsCtx.fillText(parentFocusKey, layout.left, layout.top + 25);
+        this.layoutsCtx.fillText(`left: ${layout.left}`, layout.left, layout.top + 40);
+        this.layoutsCtx.fillText(`top: ${layout.top}`, layout.left, layout.top + 55);
+    }
+    drawPoint(x, y, color = 'blue', size = 10) {
+        if (!hasDOM || !this.debugCtx) {
+            return;
+        }
+        this.debugCtx.strokeStyle = color;
+        this.debugCtx.lineWidth = 3;
+        this.debugCtx.strokeRect(x - size / 2, y - size / 2, size, size);
+    }
+}
+export default VisualDebugger;

package/dist/src/external/spatial-navigation/withFocusable.js

@@ -0,0 +1,245 @@
+/* eslint-disable react/no-find-dom-node */
+import { findDOMNode } from 'react-dom';
+import PropTypes from 'prop-types';
+import { Component, createElement } from 'react';
+import { ROOT_FOCUS_KEY } from './spatialNavigation';
+import SDK from '@/index';
+// Helper functions to replace lodash and recompose
+const uniqueId = (prefix) => `${prefix}${Math.random().toString(36).substr(2, 9)}`;
+const noop = () => { };
+const omit = (obj, keys) => {
+    const result = { ...obj };
+    keys.forEach((key) => delete result[key]);
+    return result;
+};
+const withFocusable = ({ forgetLastFocusedChild: configForgetLastFocusedChild = false, trackChildren: configTrackChildren = false, autoRestoreFocus: configAutoRestoreFocus, blockNavigationOut: configBlockNavigationOut = false, } = {}) => {
+    return (WrappedComponent) => {
+        var _a;
+        return _a = class WithFocusable extends Component {
+                constructor() {
+                    super(...arguments);
+                    Object.defineProperty(this, "state", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: {
+                            realFocusKey: this.props.focusKey || uniqueId('sn:focusable-item-'),
+                            focused: false,
+                            hasFocusedChild: false,
+                            parentFocusKey: this.props.parentFocusKey || ROOT_FOCUS_KEY,
+                        }
+                    });
+                    Object.defineProperty(this, "navigation", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: SDK.getMaestroEventViewModel().navigation
+                    });
+                    Object.defineProperty(this, "setFocus", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (focusKey) => {
+                            if (!this.navigation.isNativeMode()) {
+                                this.navigation.setFocus(focusKey);
+                            }
+                        }
+                    });
+                    Object.defineProperty(this, "navigateByDirection", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: this.navigation.navigateByDirection
+                    });
+                    Object.defineProperty(this, "stealFocus", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: () => {
+                            this.navigation.setFocus(this.state.realFocusKey, {
+                                focusKey: this.state.realFocusKey,
+                            });
+                        }
+                    });
+                    Object.defineProperty(this, "onUpdateFocus", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (focused) => {
+                            this.setState({ focused });
+                        }
+                    });
+                    Object.defineProperty(this, "onUpdateHasFocusedChild", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (hasFocusedChild) => {
+                            this.setState({ hasFocusedChild });
+                        }
+                    });
+                    Object.defineProperty(this, "onEnterPressHandler", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (details) => {
+                            const { onEnterPress = noop, ...rest } = this.props;
+                            onEnterPress(rest, details);
+                        }
+                    });
+                    Object.defineProperty(this, "onEnterReleaseHandler", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: () => {
+                            const { onEnterRelease = noop, ...rest } = this.props;
+                            onEnterRelease(rest);
+                        }
+                    });
+                    Object.defineProperty(this, "onBackPressHandler", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (details) => {
+                            const { onBackPress = noop, ...rest } = this.props;
+                            onBackPress(rest, details);
+                        }
+                    });
+                    Object.defineProperty(this, "onArrowPressHandler", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (direction, details) => {
+                            const { onArrowPress = noop, ...rest } = this.props;
+                            return onArrowPress(direction, rest, details);
+                        }
+                    });
+                    Object.defineProperty(this, "onBecameFocusedHandler", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (layout, details) => {
+                            const { onBecameFocused = noop, ...rest } = this.props;
+                            onBecameFocused(layout, rest, details);
+                        }
+                    });
+                    Object.defineProperty(this, "onBecameBlurredHandler", {
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                        value: (layout, details) => {
+                            const { onBecameBlurred = noop, ...rest } = this.props;
+                            onBecameBlurred(layout, rest, details);
+                        }
+                    });
+                }
+                getChildContext() {
+                    return {
+                        parentFocusKey: this.state.realFocusKey,
+                    };
+                }
+                componentDidMount() {
+                    const { realFocusKey: focusKey, parentFocusKey } = this.state;
+                    const { preferredChildFocusKey, forgetLastFocusedChild = false, trackChildren, focusable = true, autoRestoreFocus = true, blockNavigationOut = false, } = this.props;
+                    let node;
+                    if (this.navigation.isNativeMode()) {
+                        node = document.createElement('div');
+                    }
+                    else {
+                        const domNode = findDOMNode(this);
+                        if (!domNode) {
+                            throw new Error('Could not find DOM node');
+                        }
+                        node = domNode;
+                    }
+                    this.navigation.addFocusable({
+                        focusKey,
+                        node,
+                        parentFocusKey,
+                        preferredChildFocusKey,
+                        onEnterPressHandler: this.onEnterPressHandler,
+                        onEnterReleaseHandler: this.onEnterReleaseHandler,
+                        onBackPressHandler: this.onBackPressHandler,
+                        onArrowPressHandler: this.onArrowPressHandler,
+                        onBecameFocusedHandler: this.onBecameFocusedHandler,
+                        onBecameBlurredHandler: this.onBecameBlurredHandler,
+                        onUpdateFocus: this.onUpdateFocus,
+                        onUpdateHasFocusedChild: this.onUpdateHasFocusedChild,
+                        forgetLastFocusedChild: configForgetLastFocusedChild || forgetLastFocusedChild,
+                        trackChildren: configTrackChildren || trackChildren,
+                        blockNavigationOut: configBlockNavigationOut || blockNavigationOut,
+                        autoRestoreFocus: configAutoRestoreFocus !== undefined
+                            ? configAutoRestoreFocus
+                            : autoRestoreFocus,
+                        focusable,
+                    });
+                }
+                componentDidUpdate() {
+                    const { realFocusKey: focusKey } = this.state;
+                    const { preferredChildFocusKey, focusable = true, blockNavigationOut = false, } = this.props;
+                    let node;
+                    if (this.navigation.isNativeMode()) {
+                        node = document.createElement('div');
+                    }
+                    else {
+                        const domNode = findDOMNode(this);
+                        if (!domNode) {
+                            throw new Error('Could not find DOM node');
+                        }
+                        node = domNode;
+                    }
+                    this.navigation.updateFocusable(focusKey, {
+                        node,
+                        preferredChildFocusKey,
+                        focusable,
+                        blockNavigationOut: configBlockNavigationOut || blockNavigationOut,
+                    });
+                }
+                componentWillUnmount() {
+                    const { realFocusKey: focusKey } = this.state;
+                    this.navigation.removeFocusable({ focusKey });
+                }
+                render() {
+                    const props = {
+                        ...this.props,
+                        ...this.state,
+                        setFocus: this.setFocus,
+                        navigateByDirection: this.navigateByDirection,
+                        stealFocus: this.stealFocus,
+                        onUpdateFocus: this.onUpdateFocus,
+                        onUpdateHasFocusedChild: this.onUpdateHasFocusedChild,
+                    };
+                    const filteredProps = omit(props, [
+                        'onBecameFocusedHandler',
+                        'onBecameBlurredHandler',
+                        'onEnterPressHandler',
+                        'onEnterReleaseHandler',
+                        'onArrowPressHandler',
+                        'onUpdateFocus',
+                        'onUpdateHasFocusedChild',
+                        'forgetLastFocusedChild',
+                        'trackChildren',
+                        'autoRestoreFocus',
+                    ]);
+                    return createElement(WrappedComponent, filteredProps);
+                }
+            },
+            Object.defineProperty(_a, "contextTypes", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: {
+                    parentFocusKey: PropTypes.string,
+                }
+            }),
+            Object.defineProperty(_a, "childContextTypes", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: {
+                    parentFocusKey: PropTypes.string,
+                }
+            }),
+            _a;
+    };
+};
+export default withFocusable;

package/dist/src/helpers/Observable.js

@@ -0,0 +1,37 @@
+/**
+ * Basic observable implementation for view models
+ */
+export class Observable {
+    constructor(initialValue) {
+        Object.defineProperty(this, "listeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "_value", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this._value = initialValue;
+    }
+    get value() {
+        return this._value;
+    }
+    set value(newValue) {
+        this._value = newValue;
+        this.notify();
+    }
+    subscribe(listener) {
+        this.listeners.push(listener);
+        // Return unsubscribe function
+        return () => {
+            this.listeners = this.listeners.filter((l) => l !== listener);
+        };
+    }
+    notify() {
+        this.listeners.forEach((listener) => listener(this._value));
+    }
+}

package/dist/src/helpers/strings.js

@@ -0,0 +1,14 @@
+export const slugify = (str) => str
+    .toLowerCase()
+    .trim()
+    .replace(/[\s\W-]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+export function stringHashCode(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return hash;
+}

package/dist/src/helpers/url.js

@@ -0,0 +1,12 @@
+export const setImageDimensions = (url, width, height) => {
+    try {
+        const urlObj = new URL(url);
+        urlObj.searchParams.set('w', width.toString());
+        urlObj.searchParams.set('h', height.toString());
+        return urlObj.toString();
+    }
+    catch (err) {
+        console.warn('Malformed URL:', url, err);
+        return url; // Return the original URL if it cannot be parsed
+    }
+};

package/dist/src/index.d.ts

@@ -1,3 +1,4 @@
+import { UnmountFn } from './external/ports/renderer';
 import IMaestroEventDelegate, { PanelEvent } from './interfaces/IMaestroEventDelegate';
 import IMaestroManager, { SDKConfigParams } from './interfaces/IMaestroManager';
 import IMaestroEvent from './interfaces/IMaestroEvent';
@@ -23,6 +24,9 @@ declare class MaestroWebSDK implements IMaestroManager {
     private maestroEventViewModel;
     private pageConfig;
     private globalConfig;
+    private globalConfigPoller;
+    private analyticsService;
+    private staticService;
     private constructor();
     /**
      * @description Returns the MaestroWebSDK instance
@@ -32,10 +36,6 @@ declare class MaestroWebSDK implements IMaestroManager {
     userDidStartWatchingEvent(eventID: string, delegate: IMaestroEventDelegate, userSettings?: IUserSettings): Promise<IMaestroEvent>;
     userDidStopWatchingEvent(_: string): Promise<void>;
     configure(configParams: SDKConfigParams): void;
-    /**
-     * Checks if this is an authorized client based on siteID
-     */
-    get isAuthorizedClient(): boolean;
     /**
      * Sets the site ID for the SDK
      * @param siteID The site ID to set
@@ -47,7 +47,7 @@ declare class MaestroWebSDK implements IMaestroManager {
      * @returns The current event view model
      */
     getMaestroEventViewModel(): MaestroEventViewModel;
-    renderPanel(id: string): Promise<() => void>;
+    renderPanel(id: string): Promise<UnmountFn>;
     getPageConfig(): PageConfig | null;
     getGlobalConfig(): GlobalConfig | null;
 }

package/dist/src/index.js

@@ -0,0 +1,165 @@
+import ReactRenderer from './external/ReactRenderer';
+import { MaestroEventViewModel } from './view-models/MaestroEventViewModel';
+import { UserSettingsManager } from './services/UserSettingsManager';
+import StaticService from './services/StaticService';
+import { MaestroPanelType } from './models/IPanel';
+import initSentry from './sentry';
+import AnalyticsService from './services/AnalyticsService/AnalyticsService';
+// Export overlay components and types for client apps
+export { default as Overlay } from './components/molecules/Overlay/Overlay';
+export { OverlayType, } from './types/OverlayTypes';
+export { MaestroPanelType, };
+export { DEFAULT_USER_SETTINGS, } from './interfaces/IUserSettings';
+/**
+ * Main SDK class that serves as the entry point for the Maestro TV SDK
+ * Follows a singleton pattern similar to the Swift implementation
+ */
+class MaestroWebSDK {
+    constructor(renderer) {
+        Object.defineProperty(this, "renderer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "siteID", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ''
+        });
+        Object.defineProperty(this, "maestroEventViewModel", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "pageConfig", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "globalConfig", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "globalConfigPoller", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "analyticsService", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new AnalyticsService()
+        });
+        Object.defineProperty(this, "staticService", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new StaticService()
+        });
+        this.renderer = renderer;
+    }
+    /**
+     * @description Returns the MaestroWebSDK instance
+     * @returns {MaestroWebSDK} - The MaestroWebSDK instance
+     */
+    static getInstance() {
+        if (!MaestroWebSDK.instance) {
+            const renderer = new ReactRenderer();
+            MaestroWebSDK.instance = new MaestroWebSDK(renderer);
+        }
+        return MaestroWebSDK.instance;
+    }
+    async userDidStartWatchingEvent(eventID, delegate, userSettings) {
+        // Fetch page config before initializing view models
+        const siteId = this.getSiteID();
+        if (!siteId || siteId.trim() === '') {
+            throw new Error('siteID must be set before calling userDidStartWatchingEvent.');
+        }
+        if (!eventID || eventID.trim() === '') {
+            throw new Error('eventID must be provided to watch an event.');
+        }
+        this.pageConfig = await this.staticService.fetchPageConfig(siteId, eventID);
+        if (!this.pageConfig) {
+            throw new Error(`Could not determine page configuration for siteId: ${siteId} and eventID: ${eventID}.`);
+        }
+        this.globalConfigPoller = this.staticService.pollGlobalConfig((data) => {
+            this.globalConfig = data;
+        });
+        // Initialize user settings if provided
+        if (userSettings) {
+            UserSettingsManager.getInstance().updateSettings(userSettings);
+        }
+        initSentry();
+        await this.analyticsService.SDKSessionStart();
+        this.maestroEventViewModel = new MaestroEventViewModel(eventID, delegate);
+        await this.analyticsService.pageSessionStart();
+        return this.maestroEventViewModel;
+    }
+    async userDidStopWatchingEvent(_) {
+        await this.analyticsService.pageSessionEnd();
+        if (this.maestroEventViewModel) {
+            await this.maestroEventViewModel.deinit();
+            this.maestroEventViewModel = null;
+        }
+        await this.analyticsService.SDKSessionEnd();
+        if (this.globalConfigPoller) {
+            this.globalConfigPoller.stop();
+            this.globalConfigPoller = null;
+        }
+    }
+    configure(configParams) {
+        this.setSiteID(configParams.siteID);
+        // Configure user settings if provided
+        if (configParams.userSettings) {
+            UserSettingsManager.getInstance().updateSettings(configParams.userSettings);
+        }
+        console.info('MaestroWebSDK configured', configParams);
+    }
+    /**
+     * Sets the site ID for the SDK
+     * @param siteID The site ID to set
+     */
+    setSiteID(siteID) {
+        if (!siteID || siteID.trim() === '') {
+            throw new Error('Site ID must be provided');
+        }
+        this.siteID = siteID;
+    }
+    getSiteID() {
+        return this.siteID;
+    }
+    /**
+     * Gets the event view model
+     * @returns The current event view model
+     */
+    getMaestroEventViewModel() {
+        if (!this.maestroEventViewModel) {
+            throw new Error('No Maestro Event View Model set');
+        }
+        return this.maestroEventViewModel;
+    }
+    async renderPanel(id) {
+        await this.analyticsService.pinchBackSessionStart();
+        const panelUnmountFn = await this.renderer.renderPanel(id);
+        return async () => {
+            panelUnmountFn();
+            await this.analyticsService.pinchBackSessionEnd();
+        };
+    }
+    getPageConfig() {
+        return this.pageConfig;
+    }
+    getGlobalConfig() {
+        return this.globalConfig;
+    }
+}
+const SDK = MaestroWebSDK.getInstance();
+export default SDK;

package/dist/src/interfaces/IMaestroEvent.d.ts

@@ -87,6 +87,18 @@ export default interface IMaestroEvent {
      * https://developers.maestro.io/sdk/web/maestro-event-interface/state/getPlayerTimeCode
      */
     getPlayerTimeCode(): number | null;
+    /**
+     * @description Sets data on panel view models. Interface to pass any data to any panel.
+     * @param {Record<string, any>} panelData - Object with panel names as keys and their data as values
+     * @example
+     * setPanelData({
+     *   [panelType]: {
+     *    overrideUrl: 'https://...',
+     *    customProperty: 'value'
+     *   },
+     * })
+     */
+    setPanelData(panelData: Record<string, any>): void;
     simulateUseCase<T = any>(useCase: TestUseCase, panelType: MaestroPanelType, testData?: T): void;
     /**
      * @description Sets the active panel in the Maestro SDK, if the panel is available and not hidden.

package/dist/src/interfaces/IMaestroEvent.js

@@ -0,0 +1,18 @@
+const TEST_USE_CASES = {
+    betsTabLoadFailure: 'betsTabLoadFailure',
+    betsMockData: 'betsMockData',
+    betsLiveData: 'betsLiveData',
+    // Stats use cases
+    showBasketballPreGameStatsMockData: 'showBasketballPreGameStatsMockData',
+    showBasketballInGameStatsMockData: 'showBasketballInGameStatsMockData',
+    showFootballPreGameStatsMockData: 'showFootballPreGameStatsMockData',
+    showFootballInGameStatsMockData: 'showFootballInGameStatsMockData',
+    showHockeyPreGameStatsMockData: 'showHockeyPreGameStatsMockData',
+    showHockeyInGameStatsMockData: 'showHockeyInGameStatsMockData',
+    // Shop use cases
+    shopTabLoadFailure: 'shopTabLoadFailure',
+    shopEmptyState: 'shopEmptyState',
+    shopMockData: 'shopMockData',
+    shopLiveData: 'shopLiveData',
+};
+export {};

package/dist/src/interfaces/IMaestroEventDelegate.js

@@ -0,0 +1 @@
+export {};

package/dist/src/interfaces/IMaestroManager.js

@@ -0,0 +1 @@
+export {};

package/dist/src/interfaces/IUserSettings.js

@@ -0,0 +1,20 @@
+/**
+ * Default user settings - all features enabled by default
+ */
+export const DEFAULT_USER_SETTINGS = {
+    panels: {
+        bets: {
+            hidePanel: false,
+            hideWagers: false,
+        },
+        stats: {
+            hidePanel: false,
+        },
+        keyPlays: {
+            hidePanel: false,
+        },
+        fantasy: {
+            hidePanel: false,
+        },
+    },
+};

package/dist/src/models/IModel.js

@@ -0,0 +1 @@
+export {};