@maestro_io/maestro-web-sdk 2.2.0 → 2.2.1

package/dist/components/core/PanelManager/PanelManager.d.ts

@@ -3,9 +3,12 @@ import './PanelManager.styles.css';
 import { MaestroPanelType } from '@/models/IPanel';
 interface PanelManagerState {
     activePanel: MaestroPanelType;
+    visiblePanels: MaestroPanelType[];
 }
 declare class PanelManager extends React.Component<{}, PanelManagerState> {
     private unsubscribe;
+    private panelsUnsubscribe;
+    private viewModel;
     constructor(props: {});
     componentDidMount(): void;
     componentWillUnmount(): void;

package/dist/helpers/url.d.ts

@@ -0,0 +1 @@
+export declare const setImageDimensions: (url: string, width: number, height: number) => string;

package/dist/index.d.ts

@@ -3,10 +3,12 @@ import IMaestroManager, { SDKConfigParams } from './interfaces/IMaestroManager';
 import IMaestroEvent from './interfaces/IMaestroEvent';
 import { MaestroEventViewModel } from './view-models/MaestroEventViewModel';
 import IMaestroKeyPlaysResponse from './modules/key-plays/interfaces/IKeyPlaysResponse';
+import { IUserSettings } from './interfaces/IUserSettings';
 export { default as Overlay } from './components/molecules/Overlay/Overlay';
 export { OverlayType, IMaestroOverlayEvent, IOverlaySize, IOverlayPosition, IFantasyPayload, IOverlayAnalyticsEvent, } from './types/OverlayTypes';
 export { IWinningBet } from './models/IWinningBet';
 export { IMaestroEventDelegate, IMaestroEvent, IMaestroKeyPlaysResponse };
+export { IUserSettings, DEFAULT_USER_SETTINGS, } from './interfaces/IUserSettings';
 export type Environment = 'development' | 'staging' | 'production';
 /**
  * Main SDK class that serves as the entry point for the Maestro TV SDK
@@ -27,7 +29,7 @@ declare class MaestroWebSDK implements IMaestroManager {
      * @returns {MaestroWebSDK} - The MaestroWebSDK instance
      */
     static getInstance(): MaestroWebSDK;
-    userDidStartWatchingEvent(eventID: string, delegate: IMaestroEventDelegate): Promise<IMaestroEvent>;
+    userDidStartWatchingEvent(eventID: string, delegate: IMaestroEventDelegate, userSettings?: IUserSettings): Promise<IMaestroEvent>;
     userDidStopWatchingEvent(_: string): void;
     configure(configParams: SDKConfigParams): void;
     /**

package/dist/interfaces/IMaestroEvent.d.ts

@@ -1,5 +1,6 @@
 import { MaestroPanelType } from '@/models/IPanel';
 import IMaestroKeyPlaysResponse from '../modules/key-plays/interfaces/IKeyPlaysResponse';
+import { IUserSettings } from './IUserSettings';
 /**
  * This is the public API that the app can use to make calls to the SDK related to the currently-loaded event.
  */
@@ -74,6 +75,18 @@ export default interface IMaestroEvent {
      * https://developers.maestro.io/sdk/web/maestro-event-interface/state/updateKeyPlaysData
      */
     updateKeyPlaysData(data: IMaestroKeyPlaysResponse | null): Promise<void>;
+    updateUserSettings(settings: IUserSettings): Promise<void>;
+    /**
+     * @description Updates the SDK with the current time code of the player.
+     * This is used to synchronize the SDK with the player's current time code.
+     * https://developers.maestro.io/sdk/web/maestro-event-interface/state/updatePlayerTimeCode
+     */
+    updatePlayerTimeCode(timestamp: number): void;
+    /**
+     * @description Retrieves the current player time code stored in the SDK.
+     * https://developers.maestro.io/sdk/web/maestro-event-interface/state/getPlayerTimeCode
+     */
+    getPlayerTimeCode(): number | null;
     simulateUseCase<T = any>(useCase: TestUseCase, panelType: MaestroPanelType, testData?: T): void;
 }
 declare const TEST_USE_CASES: {

package/dist/interfaces/IMaestroManager.d.ts

@@ -1,5 +1,6 @@
 import IMaestroEventDelegate from './IMaestroEventDelegate';
 import IMaestroEvent from './IMaestroEvent';
+import { IUserSettings } from './IUserSettings';
 export type SDKConfigParams = {
     /**
      * The type of environment to use. Defaults to `development`. The available options are `development`, `staging`, and `production`.
@@ -33,6 +34,10 @@ export type SDKConfigParams = {
      * The client app SWID for authentication.
      */
     clientAppSwid?: string;
+    /**
+     * User settings for customizing SDK behavior (panel visibility, feature toggles, etc.)
+     */
+    userSettings?: IUserSettings;
 };
 /**
  This is the MaestroKit top-level API for initializing and configuring the framework.  It encompasses all functionality that is not specific to an event.
@@ -47,6 +52,7 @@ export default interface IMaestroManager {
      * @param {SDKConfigParams['siteID']} configParams.siteID - The site ID to use for the SDK.
      * @param {SDKConfigParams['jwt']} configParams.jwt - The JWT token to use for authentication.
      * @param {SDKConfigParams['userID']} configParams.userID - The user ID of the logged account.
+     * @param {SDKConfigParams['userSettings']} configParams.userSettings - User settings for customizing SDK behavior.
      */
     configure(configParams: SDKConfigParams): void;
     /**
@@ -54,9 +60,10 @@ export default interface IMaestroManager {
        Arguments:
        - eventID: The Event ID for the event opened in the player.
        - delegate: an instance of the app's implementation of IMaestroEventDelegate
+       - userSettings: Optional user settings to override the configured settings for this event
        The function returns an instance of MaestroEventViewModel, which includes an implementation of IMaestroEvent.  IMaestroEvent represents the app-facing portion of the MaestroKit API related to the currently-loaded event.  So after `userDidStartWatchingEvent` is called, the SDK has access to the API detailed in `MaestroEventDelegate` for making calls to the app, and the app has access to the API detailed in `IMaestroEvent` for making calls to the SDK.
       */
-    userDidStartWatchingEvent(eventID: string, delegate: IMaestroEventDelegate): Promise<IMaestroEvent>;
+    userDidStartWatchingEvent(eventID: string, delegate: IMaestroEventDelegate, userSettings?: IUserSettings): Promise<IMaestroEvent>;
     /**
      * @description Tells the SDK the user has closed an event that was open in the app's player.
      * @param eventID

package/dist/interfaces/IUserSettings.d.ts

@@ -0,0 +1,36 @@
+/**
+ * User settings interface for customizing Maestro Web SDK behavior
+ * Supports panel-level and feature-level customizations
+ */
+export interface IUserSettings {
+    panels?: {
+        bets?: {
+            /** Hide the entire bets panel from panel selection */
+            hidePanel?: boolean;
+            /** Hide wager values (dollar amounts) in betting cards */
+            hideWagers?: boolean;
+        };
+        stats?: {
+            /** Hide the entire stats panel from panel selection */
+            hidePanel?: boolean;
+        };
+        keyPlays?: {
+            /** Hide the entire key plays panel from panel selection */
+            hidePanel?: boolean;
+        };
+    };
+}
+/**
+ * Default user settings - all features enabled by default
+ */
+export declare const DEFAULT_USER_SETTINGS: IUserSettings;
+/**
+ * Panel-specific settings type helpers
+ */
+export type BetsSettings = NonNullable<IUserSettings['panels']>['bets'];
+export type StatsSettings = NonNullable<IUserSettings['panels']>['stats'];
+export type KeyPlaysSettings = NonNullable<IUserSettings['panels']>['keyPlays'];
+/**
+ * Utility type for getting panel settings by panel type
+ */
+export type PanelSettings<T extends keyof NonNullable<IUserSettings['panels']>> = NonNullable<IUserSettings['panels']>[T];