@tivio/sdk-react 9.2.0-alpha.3 → 9.2.0

package/dist/sdk-react.d.ts

@@ -659,6 +659,17 @@ export declare interface ButtonOptions {
     color?: string;
     padding?: string;
     maxWidth?: string;
+    primary?: ButtonVariantOptions;
+    secondary?: ButtonVariantOptions;
+    transparent?: ButtonVariantOptions;
+    disabled?: ButtonVariantOptions;
+}
+
+/**
+ * @internal
+ */
+export declare interface ButtonVariantOptions {
+    border?: string;
 }
 
 /**
@@ -1042,6 +1053,18 @@ export declare interface ConversionsTargetItem {
 
 export declare type CountdownScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.COUNTDOWN>;
 
+/**
+ * Maps supported country codes (ISO 3166-1 alpha-2) to their primary language codes (ISO 639-1).
+ * Used to determine the default language settings for specific countries.
+ * @example
+ * CountryToLanguageMap['CZ'] // Returns LangCode.CS for Czech Republic
+ */
+export declare const CountryToLangCodeMap: {
+    CZ: LangCode;
+    PL: LangCode;
+    SK: LangCode;
+};
+
 /**
  * @public
  * @TODO move somewhere else
@@ -1062,11 +1085,11 @@ export declare const createPubSub: () => PubSub;
  * Fetch & load CommonJS remote module.
  * @public
  */
-export declare const createRemotePackageLoader: () => (secret: string, conf: InternalConfig, checkBundleCharCount?: boolean) => Promise<TivioBundle>;
+export declare const createRemotePackageLoader: () => (secret: string, conf: InternalConfig, checkBundleCharCount?: boolean, skipCache?: boolean) => Promise<TivioBundle>;
 
 export declare const createTivio: () => (conf: SdkReactConfig) => Promise<RemoteBundleState>;
 
-export declare const createUseRemoteBundle: () => (sdkReactConfig: SdkReactConfig, checkBundleCharCount?: boolean) => RemoteBundleState;
+export declare const createUseRemoteBundle: () => (sdkReactConfig: SdkReactConfig, checkBundleCharCount?: boolean, skipCache?: boolean) => RemoteBundleState;
 
 export declare interface CreateUserPayload {
     displayName?: string;
@@ -1080,10 +1103,12 @@ export declare interface CreateUserPayload {
     isAnonymous?: boolean;
 }
 
+export declare type CreateUserProfileRequest = Omit<UserProfile, 'id'>;
+
 /**
  * @public
  */
-export declare type CreateUserWithEmailAndPassword = (email: string, password: string, username?: string, phoneNumber?: string, referralToken?: string) => Promise<string | null>;
+export declare type CreateUserWithEmailAndPassword = (email: string, password: string, username: string, phoneNumber?: string, referralToken?: string) => Promise<string | null>;
 
 export declare interface CreatorsWithVoucherSubscriptions {
     id: string;
@@ -1140,7 +1165,6 @@ export declare enum CustomerId {
     GRAPE = "GRAPE",
     HODINA_DEJEPICHU = "HODINA_DEJEPICHU",
     INVESTICNI_PRUVODCE = "INVESTICNI_PRUVODCE",
-    INVESTOREES = "INVESTOREES",
     JOJ = "JOJ",
     KLUCI_Z_PRAHY = "KLUCI_Z_PRAHY",
     MALL = "MALL",
@@ -1185,7 +1209,8 @@ export declare enum CustomerId {
     BEAT_SEXISM = "BEAT_SEXISM",
     KAROL_A_KVIDO = "KAROL_A_KVIDO",
     UZ_BUDU = "UZ_BUDU",
-    PRIMA = "PRIMA"
+    PRIMA = "PRIMA",
+    NORA_FRIDRICHOVA = "NORA_FRIDRICHOVA"
 }
 
 /**
@@ -1249,6 +1274,7 @@ export declare interface Customizations {
         playVideoButton?: {
             backgroundColor?: string;
             color?: string;
+            border?: string;
         };
         logo?: {
             height: string;
@@ -1285,10 +1311,13 @@ export declare interface Customizations {
         color?: string;
         backgroundGradient?: string;
         iconColor?: string;
+        roundedMenuColor?: string;
+        roundedMenuHoverColor?: string;
     };
     CenteredMenu?: {
         backgroundColor: string;
         menuLinkColor: string;
+        border?: string;
     };
     Footer: {
         backgroundColor: string;
@@ -1392,6 +1421,12 @@ export declare interface Customizations {
         background: string;
         backgroundMobile: string;
     };
+    Feed?: {
+        backgroundColor?: string;
+        Description?: {
+            color?: string;
+        };
+    };
 }
 
 export declare interface CustomScript {
@@ -1541,6 +1576,8 @@ export declare enum DrmProvider {
      * Original oktagon stream provider.
      *
      * https://streamonline.pl
+     *
+     * @deprecated oktagon no longer uses this drm provider.
      */
     STREAMONLINE = "streamonline"
 }
@@ -1684,8 +1721,8 @@ export declare type EmbedScreenPostMessageFn = <T extends EmbedScreenPostMessage
  */
 export declare interface EmitterInterface {
     isSupported: (even: string) => boolean;
-    addListener: <T = any>(event: string, cb: (value: T) => Empty_2) => void;
-    removeListener: <T = any>(event: string, cb: (value: T) => Empty_2) => void;
+    addListener: <T = unknown>(event: string, cb: (value: T) => Empty_2) => void;
+    removeListener: <T = unknown>(event: string, cb: (value: T) => Empty_2) => void;
 }
 
 /**
@@ -1924,6 +1961,10 @@ export declare interface GetSourceUrlRequest {
      * Start time in ms, for live streams. Will return manifest with desired start.
      */
     startTimeMs?: number;
+    /**
+     * Parameters related to ads.
+     */
+    adParams?: Record<string, string | number | undefined>;
 }
 
 export declare interface GetSourceUrlResponse {
@@ -3383,9 +3424,8 @@ export declare interface PlayerEngineInterface {
     stop(): Promise<void>;
     addEventListener<T>(event: PlayerEngineEvent, callback: PlayerEngineListener<T>): void;
     addEventListener(event: 'statechange', callback: PlayerEngineListener<PlayerState>): void;
-    addEventListener(event: 'bufferingchange', callback: PlayerEngineListener<boolean>): void;
+    addEventListener(event: 'bufferingchange' | 'togglefullscreen', callback: PlayerEngineListener<boolean>): void;
     addEventListener(event: 'bufferedinfochange', callback: PlayerEngineListener<BufferPercentChunk[]>): void;
-    addEventListener(event: 'togglefullscreen', callback: PlayerEngineListener<boolean>): void;
     removeEventListener<T>(event: PlayerEngineEvent, listener: PlayerEngineListener<T>): void;
     /**
      * @returns currently playing audio track in ISO 639-1 format ('cs', 'en' etc.) or null if not available
@@ -3469,7 +3509,7 @@ export declare interface PlayerEngineInterface {
 /**
  * @public
  */
-export declare type PlayerEngineListener<T> = (value: T) => any;
+export declare type PlayerEngineListener<T> = (value: T) => void;
 
 /**
  * @public
@@ -4236,6 +4276,14 @@ export declare type PurchaseEndpointPayload = {
     };
 };
 
+/**
+ * @public
+ */
+export declare type PurchaseEventHandlers = {
+    onPurchaseIntention?: (purchase: PurchasableMonetization) => void;
+    onPurchaseFinished?: (purchase: Purchase) => void;
+};
+
 /**
  * @public
  */
@@ -4670,7 +4718,7 @@ export declare interface RenderConditionValue {
     subscriptionRefs?: any[];
 }
 
-export declare const renderWebPlayer: (container: HTMLElement, props: WebPlayerProps) => void;
+export declare const renderWebPlayer: (container: HTMLElement, props: Omit<WebPlayerProps, 'onPlayerControllerCreated'>) => Promise<SimplifiedVideoController>;
 
 /**
  * Make all attributes in given type required, non-nullable and defined.
@@ -5063,6 +5111,7 @@ declare interface Screen_2 {
     fetchMoreRows: () => Promise<void>;
     hasNextPage: boolean;
     refetchIfNeeded: () => Promise<void>;
+    allowOrganizationBanner?: boolean;
 }
 export { Screen_2 as Screen }
 
@@ -5312,6 +5361,110 @@ export declare const showGdprConsentPreferences: () => Promise<void>;
  */
 export declare type SignInProvider = 'google' | 'patreon' | 'apple';
 
+/**
+ * Simplified VideoController interface for external rendering
+ */
+export declare interface SimplifiedVideoController {
+    /**
+     * Resume playback from paused state
+     */
+    play(): void;
+    /**
+     * Pause the current playback
+     */
+    pause(): void;
+    /**
+     * Toggle between play and pause states
+     */
+    togglePause(): void;
+    /**
+     * Replay the current video from the beginning
+     */
+    replay(): Promise<void>;
+    /**
+     * Retry playback if it failed to start
+     */
+    retry(): void;
+    /**
+     * Seek to an absolute position in milliseconds
+     * @param ms - Position in milliseconds from the start of the video
+     */
+    seekToAbsolutePosition(ms: number): void;
+    /**
+     * Seek relative to current position
+     * @param ms - Number of milliseconds to seek (positive for forward, negative for backward)
+     */
+    seekBy(ms: number): void;
+    /**
+     * Seek to a percentage of the video duration
+     * @param percentage - Percentage value between 0 and 100
+     */
+    seekToPercent(percentage: number): void;
+    /**
+     * Seek to the live position for live streams
+     */
+    seekToLive(): void;
+    /**
+     * Set the volume level
+     * @param value - Volume level between 0 and 1
+     */
+    changeVolume(value: number): void;
+    /**
+     * Increase volume by 5%
+     */
+    volumeUp(): void;
+    /**
+     * Decrease volume by 5%
+     */
+    volumeDown(): void;
+    /**
+     * Mute the audio
+     */
+    mute(): void;
+    /**
+     * Unmute the audio
+     */
+    unmute(): void;
+    /**
+     * Toggle between muted and unmuted states
+     */
+    toggleMute(): void;
+    /**
+     * Currently playing source or null if no source is loaded
+     */
+    readonly currentSource: PlayerSource | null;
+    /**
+     * Add an event listener for player events
+     * @param event - The event name to listen for (e.g., 'ended', 'timeupdate', 'statechange')
+     * @param callback - Function to call when the event occurs
+     */
+    addEventListener<T>(event: string, callback: (value: T) => void): void;
+    /**
+     * Add an event listener for volume changes
+     * @param event - Must be 'volumechange'
+     * @param callback - Function called with volume state object
+     */
+    addEventListener(event: 'volumechange', callback: (value: {
+        muted: boolean;
+        volume: number;
+    }) => void): void;
+    /**
+     * Remove an event listener
+     * @param event - The event name to stop listening for
+     * @param callback - The callback function to remove
+     */
+    removeEventListener<T>(event: string, callback: (value: T) => void): void;
+    /**
+     * Change the current source to a new one
+     * @param source - The new source to load (can be a video path, channel path, or source parameters)
+     */
+    setSource(source: WebPlayerProps['source']): void;
+    /**
+     * Destroy the player and clean up all resources
+     */
+    destroy(): Promise<void>;
+}
+
 export declare enum SocialNetworks {
     FACEBOOK = 0,
     INSTAGRAM = 1,
@@ -5836,20 +5989,27 @@ export declare type TivioAnalytics = {
  */
 export declare interface TivioAuth {
     /**
+     * Create and sign up new user with given email and password.
      * @param email
      * @param password
+     * @returns {string} - uid of newly created and signed-up user
      */
     createUserWithEmailAndPassword: CreateUserWithEmailAndPassword;
     /**
-     * Sign in the user and starts listening on his purchases
+     * Sign in the user with given email and password and start listening on their purchases.
      * @param email
      * @param password
+     * @returns {string} - uid of signed-in user.
      */
     signInWithEmailAndPassword: (email: string, password: string) => Promise<string | null>;
     signInWithCustomToken: (token: string) => Promise<string | null>;
+    /**
+     * Signs out currently signed-in user.
+     */
     signOut: () => Promise<void>;
     /**
-     * Used for reset forgotten password by user
+     * Resets password for given user email.
+     * @param email
      */
     resetPassword: (email: string) => Promise<void>;
 }
@@ -5876,7 +6036,6 @@ export declare interface TivioComponents {
     }>;
     Provider: React_2.ComponentType<RemoteProviderProps>;
     WebPlayer: React_2.ComponentType<WebPlayerProps>;
-    Widget: React_2.ComponentType<TivioWidgetProps>;
     PlayerDataContextProvider: React_2.ComponentType<{
         id: string;
     }>;
@@ -5905,9 +6064,7 @@ export declare interface TivioComponents {
     WebTile: React_2.ComponentType<{
         item?: ItemInRow;
     } & TilePropsPartial>;
-    ChannelContext: React_2.Context<TvChannel | undefined>;
     ContentSortPicker: React_2.ComponentType<ContentSortPickerProps>;
-    WebProfileScreen: React_2.ComponentType<WebProfileScreenProps>;
     WebTivioProVideoScreen: React_2.ComponentType<WebTivioProVideoScreenProps>;
     RemoteController: React_2.ComponentType<RemoteControllerProps>;
 }
@@ -5933,14 +6090,24 @@ export declare interface TivioConfig {
         preferHttp?: boolean;
     };
     secret: string;
+    /**
+     * Language used when isLanguageSelectionEnabled is false | undefined or when not possible to load language from local storage or localization worker
+     */
     language: LangCode;
     debug?: boolean;
     verbose?: boolean;
     firebaseApp?: any | null;
-    firebaseFactory?: (config: Object, appName?: string) => firebase_2.FirebaseApp;
+    firebaseFactory?: (config: object, appName?: string) => firebase_2.FirebaseApp;
     authDomainOverride?: string;
     firestore?: any | null;
     currency: Currency;
+    /**
+     * A flag that indicates whether the language selection feature is enabled.
+     * Language is then stored to local storage 'tivio-user-language'.
+     * If nothing is stored in local storage, then language is set according to location
+     * When set to `true`, users are allowed to choose their preferred language
+     */
+    isLanguageSelectionEnabled?: boolean;
     applicationId?: string;
     isTivioProApp?: boolean;
     lockApplicationHandle?: string;
@@ -5992,13 +6159,13 @@ export declare type TivioGetters = {
     /**
      * Get video by its id.
      * @param videoId - video id
-     * @returns {Promise<Video | null>} video or null if video does not exists
+     * @returns {Promise<Video | null>} video or null if video does not exist
      */
     getVideoById: (videoId: string) => Promise<Video | null>;
     /**
      * Get screen by its id.
      * @param screenId - screen id
-     * @returns {Promise<Screen | null>} screen or null if screen does not exists
+     * @returns {Promise<Screen | null>} screen or null if screen does not exist
      */
     getScreenById: (screenId: string, cb?: (error: Error | null, data: Screen_2 | null, disposer?: Disposer_2) => void) => Promise<Screen_2 | null>;
     /**
@@ -6006,6 +6173,11 @@ export declare type TivioGetters = {
      * @returns PlayerCapability[]
      */
     getPlayerCapabilities: () => PlayerCapability[];
+    /**
+     * Get currently logged-in user. If no user is logged in, returns `null`.
+     * @returns User
+     */
+    getUser: () => User | null;
 };
 
 /**
@@ -6161,6 +6333,9 @@ export declare type TivioInternalProviders = {
     }>;
     MonetizationsSelectOverlayContextProvider: React_2.ComponentType;
     QerkoOverlayContextProvider: React_2.ComponentType;
+    /**
+     * @deprecated do not use, this provider will be removed in the future
+     */
     PurchasesWithVideosContextProvider: React_2.ComponentType<{
         children?: React_2.ReactNode;
     }>;
@@ -6209,7 +6384,7 @@ export declare type TivioJsBundleExposedApi = {
     getTagById: (tagId: string) => Promise<Tag | null>;
     createPlayerWrapper: (playerImplementation: PlayerInterfaceForPlayerWrapper) => TivioPlayerWrapper;
     destroy: () => Promise<void>;
-} & Pick<TivioGetters, 'getVideoById' | 'getScreenById' | 'organization'> & Pick<TivioSubscriptions, 'subscribeToVideo' | 'subscribeToItemsInRow' | 'subscribeToRowsInScreen'> & Pick<TivioAuth, 'createUserWithEmailAndPassword' | 'signInWithEmailAndPassword'> & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
+} & Pick<TivioGetters, 'getVideoById' | 'getScreenById' | 'organization' | 'getUser'> & Pick<TivioSubscriptions, 'subscribeToVideo' | 'subscribeToItemsInRow' | 'subscribeToRowsInScreen'> & Pick<TivioAuth, 'createUserWithEmailAndPassword' | 'signInWithEmailAndPassword' | 'resetPassword' | 'signOut'> & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
 
 /**
  * @public
@@ -6326,55 +6501,6 @@ export declare type TivioVodSource = SourceBase & StartAndContinuePosition & {
     videoPath: string;
 };
 
-/**
- * @public
- */
-export declare const TivioWidget: React_2.ForwardRefExoticComponent<Omit<TivioWidgetProps, "ref"> & React_2.RefAttributes<TivioWidgetRef>>;
-
-/**
- * @public
- */
-export declare const TivioWidgetError: React_2.FC<TivioWidgetErrorProps>;
-
-declare type TivioWidgetErrorProps = {
-    error: string | null;
-};
-
-/**
- * @public
- */
-export declare const TivioWidgetLoader: React_2.FC;
-
-/**
- * @public
- */
-export declare interface TivioWidgetProps {
-    id: string;
-    ref: React_2.MutableRefObject<TivioWidgetRef>;
-    onEnabled?: (enabled: boolean) => any;
-    onBlur?: (event: {
-        key: string;
-        width: number;
-        x: number;
-    }) => any;
-}
-
-/**
- * @public
- */
-export declare interface TivioWidgetRef {
-    focus: (args: {
-        x?: number;
-    }) => void;
-    handleKey: (key: string) => ({
-        handled: boolean;
-        x: number;
-    });
-    unfocus: () => ({
-        x: number;
-    });
-}
-
 export declare interface TokenInterface {
     token: string;
     expirationDate: Date;
@@ -6851,18 +6977,45 @@ export declare type User = {
     isPurchasesInitialized: boolean;
     isSignedIn: boolean;
     isReady: boolean;
+    /**
+     * Email of this user.
+     */
     email?: string;
     type?: UserType;
     photoURL: string | null;
+    /**
+     * Name of this user - typically first and last name combined, or any other nickname chosen by user.
+     */
     name?: string;
     /**
      * Authentication id differs from {@link id}.
      */
     authUserId?: string;
+    /**
+     * List of content (e.g. videos / series) that user marked as their favorite.
+     * Changes based on currently {@link activeUserProfileId}
+     */
     favorites: any[];
+    /**
+     * List of content (e.g. videos / series) that user watched recently with precise time position where they last left watching.
+     * Number of entries in the list is limited by constant number (i.e. older entries are deleted when limit is reached).
+     * In some cases entries are actively removed even if they are new, for example when user watched video to the end.
+     * Changes based on currently {@link activeUserProfileId}.
+     */
     watchedPositions: any[];
+    /**
+     * Similar to {@link watchedPositions}, but has higher limit for number of entries,
+     * and they never actively deleted (e.g. when user watched video to the end)
+     * Changes based on currently {@link activeUserProfileId}.
+     */
     watchHistory: any[];
-    profiles: any[];
+    /**
+     * List of profiles for this user.
+     */
+    profiles: UserProfile[];
+    /**
+     * Currently active user profile id.
+     */
     activeUserProfileId: string | null;
     patreon?: PatreonUserAuth;
     subscriptionIdsToShow: string[] | null;
@@ -6870,9 +7023,22 @@ export declare type User = {
     isAnonymous: boolean;
     isDiscordConnected: boolean;
     disconnectDiscord: () => Promise<void>;
-    createUserProfile: (request: any) => Promise<void>;
+    /**
+     * Create new profile for this user.
+     * @param request
+     */
+    createUserProfile: (request: CreateUserProfileRequest) => Promise<void>;
+    /**
+     * Delete given profile from this user.
+     * @param profileId
+     */
     deleteUserProfile: (profileId: string) => Promise<void>;
-    setActiveUserProfileId: (id: string) => void;
+    /**
+     * Activate given profile for this user.
+     * After activation {@link favorites}, {@link watchedPositions} and {@link watchHistory} of given profile will be used.
+     * @param profileId
+     */
+    setActiveUserProfileId: (profileId: string) => void;
     getFollowedOrganizations: () => Promise<Array<FollowedOrganizationData | undefined>>;
     sendFinalizeRegistrationEmail: (email: string) => Promise<void>;
     isUserAlreadyRegisteredByTenant: (email: string) => Promise<boolean>;
@@ -7271,6 +7437,154 @@ export declare enum VideoContentType {
     SERIES = "SERIES"
 }
 
+/**
+ * @public
+ * VideoController provides control over video playback, seeking, volume, and event handling.
+ */
+export declare interface VideoController {
+    /** Unique identifier for this player instance */
+    readonly playerId: string;
+    /** Internal control queue for managing player operations */
+    readonly controlQueue: unknown;
+    /** Currently playing source or null if no source is loaded */
+    readonly currentSource: PlayerSource | null;
+    /**
+     * Add an event listener for player events
+     * @param event - The event name to listen for (e.g., 'ended', 'timeupdate', 'statechange')
+     * @param callback - Function to call when the event occurs
+     */
+    addEventListener<T>(event: string, callback: (value: T) => void): void;
+    addEventListener(event: 'volumechange', callback: (value: {
+        muted: boolean;
+        volume: number;
+    }) => void): void;
+    /**
+     * Remove an event listener
+     * @param event - The event name to stop listening for
+     * @param callback - The callback function to remove
+     */
+    removeEventListener<T>(event: string, callback: (value: T) => void): void;
+    /**
+     * Change the current source to a new one
+     * @param sourceData - The new source parameters
+     * @param autoplay - Whether to start playing immediately (default: true)
+     * @returns Promise that resolves to the new source or null if failed
+     */
+    changeSource(sourceData: SourceParams, autoplay?: boolean): Promise<PlayerSource | null>;
+    /**
+     * Load a new source and optionally start playing
+     * @param sourceData - The source parameters to load
+     * @param autoplay - Whether to start playing immediately
+     */
+    load(sourceData: SourceParams, autoplay: boolean): Promise<void>;
+    /**
+     * Toggle between play and pause states
+     */
+    togglePause(): void;
+    /**
+     * Pause the current playback
+     */
+    pause(): void;
+    /**
+     * Resume playback from paused state
+     */
+    unpause(): void;
+    /**
+     * Replay the current video from the beginning
+     */
+    replay(): Promise<void>;
+    /**
+     * Retry playback if it failed to start
+     */
+    retry(): void;
+    /**
+     * Stop playback and reset player state
+     */
+    close(): void;
+    /**
+     * Destroy the player and clean up all resources
+     */
+    destroy(): Promise<void>;
+    /**
+     * Seek to an absolute position in milliseconds
+     * @param ms - Position in milliseconds from the start of the video
+     */
+    seekToAbsolutePosition(ms: number): void;
+    /**
+     * Seek relative to current position
+     * @param ms - Number of milliseconds to seek (positive for forward, negative for backward)
+     */
+    seekBy(ms: number): void;
+    /**
+     * Seek to a percentage of the video duration
+     * @param percentage - Percentage value between 0 and 100
+     */
+    seekToPercent(percentage: number): void;
+    /**
+     * @deprecated Use seekToPercent instead
+     * Seek to a relative position as percentage of video duration
+     * @param percentage - Percentage value between 0 and 100
+     */
+    seekToRelativePosition(percentage: number): void;
+    /**
+     * Seek to the live position for live streams
+     */
+    seekToLive(): void;
+    /**
+     * Internal method to seek to live position
+     */
+    seekToLiveInternal(): void;
+    /**
+     * Set the volume level
+     * @param value - Volume level between 0 and 1
+     */
+    changeVolume(value: number): void;
+    /**
+     * Increase volume by 5%
+     */
+    volumeUp(): void;
+    /**
+     * Decrease volume by 5%
+     */
+    volumeDown(): void;
+    /**
+     * Mute the audio
+     */
+    mute(): void;
+    /**
+     * Unmute the audio
+     */
+    unmute(): void;
+    /**
+     * Toggle between muted and unmuted states
+     */
+    toggleMute(): void;
+    /**
+     * Enter fullscreen mode
+     */
+    goFullScreen(): Promise<void>;
+    /**
+     * @deprecated Use durationchange event instead
+     * Set the duration of the current video in milliseconds
+     * @param ms - Duration in milliseconds
+     */
+    setDurationMs(ms: number): void;
+    /**
+     * Get the duration of the current video in milliseconds
+     * @returns Duration in milliseconds
+     */
+    getDurationMs(): number;
+    /** Whether live seeking is enabled for the current source */
+    readonly isLiveSeekingEnabled: boolean;
+    /** Whether the current playback position is live */
+    readonly isCurrentTimeLive: boolean;
+    /**
+     * Handle watermark element changes for security purposes
+     * @param mutations - Array of DOM mutation records
+     */
+    onWatermarkElementChange(mutations: MutationRecord[]): void;
+}
+
 declare type VideoDetailResponsiveField = OrganizationResponsiveSetting<{
     modalView?: boolean;
     showDateOfPublicationForRelatedVideos?: boolean;
@@ -7828,6 +8142,10 @@ export declare interface WebConfig {
             [key: string]: string;
         };
     };
+    /**
+     * Map for all handlers
+     */
+    handlers?: PurchaseEventHandlers;
 }
 
 /**
@@ -7893,10 +8211,7 @@ export declare interface WebPlayerProps {
      */
     enableKeyboardShortcuts?: boolean;
     onProgress?: (event: React_2.ChangeEvent<HTMLVideoElement>) => void;
-    /**
-     * @deprecated this callback is never called. Will be removed in @tivio/sdk-react version 4
-     */
-    onPlayerControllerCreated?: (playerController: any) => void;
+    onPlayerControllerCreated?: (playerController: VideoController) => void;
     /**
      * If true, saving of watch position won't be performed.
      */