@tivio/sdk-react 9.2.0-alpha.4 → 9.3.0

package/dist/sdk-react.d.ts

@@ -11,6 +11,7 @@ import type { PaletteType } from '@material-ui/core';
 import { default as React_2 } from 'react';
 import { RecommendationsQuery } from '@algolia/recommend';
 import type { TagManagerArgs } from 'react-gtm-module';
+import type { Timestamp } from '@firebase/firestore-types';
 
 export declare interface ActivatedPromotion {
     id: string;
@@ -607,6 +608,10 @@ export declare interface BannerProps {
  */
 export declare type BannerPropsPartial = Partial<BannerProps>;
 
+declare interface BaseWidgetControlPayload {
+    widgetPath: string;
+}
+
 /**
  * @public
  */
@@ -683,6 +688,35 @@ export declare interface CancellingMonetizationsSummaryItem {
     cancellingUsers: number;
 }
 
+declare interface ChangeStateResponse {
+    success: boolean;
+}
+
+declare interface ChangeWidgetStatePayload extends BaseWidgetControlPayload {
+    prevState: InteractiveWidgetState;
+    targetState: InteractiveWidgetState;
+}
+
+export declare interface ChangeWidgetStateRequest {
+    /** Path to the widget instance document */
+    widgetPath: string;
+    /** The state the client believes the widget is currently in */
+    prevState: InteractiveWidgetState;
+    /** The desired target state to transition to */
+    targetState: InteractiveWidgetState;
+    /** Active scene id */
+    activeSceneId?: string;
+    /** Audience delay in seconds */
+    audienceDelay?: number;
+    /** Time in seconds for the audience to answer the question */
+    answerTime?: number;
+}
+
+declare interface ChangeWidgetStateRequest_2 {
+    action: 'changeState';
+    payload: ChangeWidgetStatePayload;
+}
+
 /**
  * @public
  * @deprecated this channel structure is not used anymore (don't confuse with tv channels, which are used).
@@ -736,6 +770,11 @@ export declare interface ChurnedMonetizationsSummaryItem {
     expiredUsers: number;
 }
 
+export declare enum CloudflareStreamingPurchaseStatus {
+    PAID = "paid",
+    FREE = "free"
+}
+
 /**
  * @public
  */
@@ -1053,6 +1092,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
@@ -1073,11 +1124,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;
@@ -1153,7 +1204,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",
@@ -1198,7 +1248,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"
 }
 
 /**
@@ -1299,6 +1350,8 @@ export declare interface Customizations {
         color?: string;
         backgroundGradient?: string;
         iconColor?: string;
+        roundedMenuColor?: string;
+        roundedMenuHoverColor?: string;
     };
     CenteredMenu?: {
         backgroundColor: string;
@@ -1562,6 +1615,8 @@ export declare enum DrmProvider {
      * Original oktagon stream provider.
      *
      * https://streamonline.pl
+     *
+     * @deprecated oktagon no longer uses this drm provider.
      */
     STREAMONLINE = "streamonline"
 }
@@ -1610,6 +1665,18 @@ export declare interface EditMessageOptions extends Omit<AddMessageOptions, 'par
     videoTime?: number;
 }
 
+export declare interface EmailNotification {
+    id: string;
+    name: string;
+    targeting: NotificationTargeting | null;
+    templateId: string;
+    thumbnailUrl?: string;
+    triggerType: NotificationTriggerType;
+    scheduleTime?: Date;
+    status?: NotificationStatus;
+    substitutions: NotificationSubstitution[];
+}
+
 /**
  * Represents a SendGrid transactional template.
  */
@@ -1705,8 +1772,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;
 }
 
 /**
@@ -1731,6 +1798,11 @@ export declare type Events = {
     'on-error': Error;
 };
 
+export declare interface ExtensionMetadata {
+    purchaseStatus: CloudflareStreamingPurchaseStatus;
+    activeVideoId?: string;
+}
+
 /**
  * @public
  */
@@ -1739,6 +1811,23 @@ export declare type ExternalTvConfig = {
     splashScreenBackgroundColor?: string;
 };
 
+export declare interface FavoriteTagWithData {
+    content: Tag;
+    type: 'tag';
+}
+
+export declare interface FavoriteVideoWithData {
+    content: Video;
+    type: 'video';
+}
+
+/**
+ * @public
+ */
+export declare type FavoriteWithData = FavoriteVideoWithData | (FavoriteTagWithData & {
+    profileId?: string;
+});
+
 /**
  * @throws if fetch fails
  * @public
@@ -1800,6 +1889,24 @@ export declare type FrequencyInfo = {
     value: number;
 };
 
+export declare interface GenerateSourceRequest {
+    profileId: string;
+    videoId: string;
+    protocol: VideoSourceProtocol;
+    sessionType: SessionType;
+    extensionMetadata: ExtensionMetadata;
+}
+
+export declare interface GenerateWidgetJoinCodeRequest {
+    action: 'generateWidgetJoinCode';
+    payload: BaseWidgetControlPayload;
+}
+
+declare interface GenerateWidgetJoinCodeResponse {
+    code: string;
+    qrCodeUri: string;
+}
+
 /**
  * On call error interface for front-end.
  * Do not use it / throw it from @tivio/api.
@@ -1996,6 +2103,14 @@ export declare interface GetSourceUrlResponse {
 
 export declare type GetTilesInRowResponse<U extends NextPageParamType = NextPageParamType> = PaginatedResponse<TileData, U>;
 
+export declare interface GetUserProfileDataOptions {
+    /**
+     * If true, the data will be returned for all user profiles.
+     * If false, the data will be returned only for the active user profile.
+     */
+    ignoreActiveUserProfile?: boolean;
+}
+
 export declare interface GetUserRssUrlRequest {
     organizationId: string;
 }
@@ -2228,6 +2343,7 @@ export declare interface InteractiveWidget<T extends InteractiveWidgetScene = In
     readonly isWaitingForStart: boolean;
     answerQuestion(answerId: string): void;
     submitAnswer(request: Pick<SubmitAnswerRequest, 'answerOptionId' | 'answerText'>): Promise<void>;
+    verifyJoinCode(joinCode: string, shouldJoinPlayer?: boolean): Promise<boolean>;
     destroy(): void;
 }
 
@@ -2253,6 +2369,7 @@ export declare interface InteractiveWidgetSceneBase<TType extends InteractiveWid
     type: TType;
     name: Translation;
     metadata: SceneMetadata<TType>;
+    state: InteractiveWidgetState;
 }
 
 export declare enum InteractiveWidgetSceneTemplateType {
@@ -2478,6 +2595,12 @@ export declare interface LeaderboardPlayer {
 
 export declare type LeaderboardScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.LEADERBOARD>;
 
+export declare interface LeaderboardsRequest {
+    widgetPath: string;
+    lastQuestionIndex: number;
+    allPlayers?: boolean;
+}
+
 /**
  * @public
  */
@@ -2621,6 +2744,21 @@ export declare interface MallTvExternals {
     mallTvEntityId: string;
 }
 
+/**
+ * Response for {@link ManagementGenerateSourceRequest}
+ * @private
+ * @example ```json
+ * {
+ *   "sessionId": "f6439376-bc57-4891-ac64-4dde4254a423",
+ *   "url": "https://live.streaming.tivio.studio/live/ol24ae7lQ4ES1PN6UYSk/tRRu9BMn3eTTX22iTyLz/f6439376-bc57-4891-ac64-4dde4254a423/index.m3u8"
+ * }
+ * ```
+ */
+export declare interface ManagementGenerateSourceResponse {
+    sessionId: string;
+    url: string;
+}
+
 /**
  * @public
  */
@@ -2921,17 +3059,11 @@ export declare type NoGraphicsScene = InteractiveWidgetSceneBase<InteractiveWidg
  */
 export declare type NonAdSourceType = Exclude<SourceType, SourceType.ADVERTISEMENT>;
 
-declare interface Notification_2 {
-    id: string;
-    name: string;
-    targeting: NotificationTargeting | null;
-    templateId: string;
-    thumbnailUrl?: string;
-    triggerType: NotificationTriggerType;
-    scheduleTime?: Date;
-    status?: NotificationStatus;
-    substitutions: NotificationSubstitution[];
-}
+declare type Notification_2 = {
+    type: NotificationType.PUSH;
+} & SchedulePushNotificationPayload | {
+    type?: NotificationType.EMAIL;
+} & EmailNotification;
 export { Notification_2 as Notification }
 
 export declare interface NotificationDuration {
@@ -3002,6 +3134,11 @@ export declare interface NotificationTargeting {
 
 export declare type NotificationTriggerType = 'scheduled' | 'manual' | 'purchaseStatusChange' | 'duration' | 'userRegistration';
 
+export declare enum NotificationType {
+    PUSH = "PUSH",
+    EMAIL = "EMAIL"
+}
+
 /**
  * @public
  */
@@ -3116,6 +3253,7 @@ export declare interface OrganizationSettingsField extends OrganizationResponsiv
     };
     rss?: {
         title?: string;
+        enabled?: boolean;
     };
     /**
      * Setting for EPG screen on web
@@ -3145,6 +3283,9 @@ export declare interface OrganizationSettingsField extends OrganizationResponsiv
         };
     };
     voucher?: VoucherPageConfiguration;
+    pushNotifications?: {
+        enabled?: boolean;
+    };
 }
 
 /**
@@ -3408,9 +3549,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
@@ -3494,7 +3634,7 @@ export declare interface PlayerEngineInterface {
 /**
  * @public
  */
-export declare type PlayerEngineListener<T> = (value: T) => any;
+export declare type PlayerEngineListener<T> = (value: T) => void;
 
 /**
  * @public
@@ -4261,6 +4401,14 @@ export declare type PurchaseEndpointPayload = {
     };
 };
 
+/**
+ * @public
+ */
+export declare type PurchaseEventHandlers = {
+    onPurchaseIntention?: (purchase: PurchasableMonetization) => void;
+    onPurchaseFinished?: (purchase: Purchase) => void;
+};
+
 /**
  * @public
  */
@@ -4323,6 +4471,20 @@ export declare enum PurchaseStatus {
  */
 export declare type PurchaseType = 'transaction' | 'subscription' | 'voucher';
 
+export declare type PushNotificationSchedulerRequest = {
+    operation: SchedulerOperation.SCHEDULE;
+    status: NotificationStatus;
+    payload: SchedulePushNotificationPayload;
+} | {
+    operation: SchedulerOperation.UNSCHEDULE;
+    organizationId: string;
+    contentId: string;
+} | {
+    operation: SchedulerOperation.GET_STATUS;
+    organizationId: string;
+    contentId: string;
+};
+
 /**
  * TODO more generic name, since we support stargaze payment gateway as well
  * @public
@@ -4489,6 +4651,8 @@ export declare interface QuizGameGroupStats {
 
 export declare enum QuizGameGroupType {
     HIGHLIGHTED_PLAYERS = "HIGHLIGHTED_PLAYERS",
+    /** Participants playing in Offline mode */
+    LOCAL_PLAYERS = "LOCAL_PLAYERS",
     ALL = "ALL",
     PARTY = "PARTY"
 }
@@ -4496,7 +4660,8 @@ export declare enum QuizGameGroupType {
 export declare enum QuizGameRole {
     OBS = "OBS",
     HOST = "HOST",
-    PLAYER = "PLAYER"
+    PLAYER = "PLAYER",
+    LOCAL_PLAYER = "LOCAL_PLAYER"
 }
 
 export declare enum QuizGameStatus {
@@ -4695,7 +4860,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.
@@ -4750,6 +4915,7 @@ export declare interface RouterOverrides {
         urlHandle?: string;
         replace?: boolean;
         params?: string;
+        callbackUrl?: string;
     }) => void;
     goToRegistrationPage: (options?: {
         origin?: RegistrationRedirect;
@@ -5063,6 +5229,38 @@ export declare interface ScheduleNotificationRequest {
     notificationPath: string;
 }
 
+export declare interface SchedulePushNotificationPayload {
+    /**
+     * To which content document will this notification relate to.
+     */
+    contentId: string;
+    /**
+     * Content document type.
+     */
+    contentType: 'video' | 'article';
+    /**
+     * To users of which organization should notifications be sent.
+     */
+    organizationId: string;
+    /**
+     * Contents of notification message that will be shown to users.
+     */
+    notification: {
+        title: string;
+        body?: string;
+        imageUrl?: string;
+        data?: {
+            [key: string]: string;
+        };
+    };
+}
+
+export declare enum SchedulerOperation {
+    SCHEDULE = "SCHEDULE",
+    UNSCHEDULE = "UNSCHEDULE",
+    GET_STATUS = "GET_STATUS"
+}
+
 /**
  * @public
  */
@@ -5088,6 +5286,7 @@ declare interface Screen_2 {
     fetchMoreRows: () => Promise<void>;
     hasNextPage: boolean;
     refetchIfNeeded: () => Promise<void>;
+    allowOrganizationBanner?: boolean;
 }
 export { Screen_2 as Screen }
 
@@ -5246,6 +5445,27 @@ export declare interface SendMessageResponse {
     messageId?: string;
 }
 
+export declare interface SendPushNotificationsResponse {
+    /**
+     * Potential user count to send notifications to.
+     * Will include organization users that have at least 1 device registered to receive notifications.
+     */
+    potentialUserCount: number;
+    /**
+     * Potential device count from users to send notifications to.
+     * Resulting number is equals to {@link successNotificationCount} + {@link failureNotificationCount}
+     */
+    potentialDeviceCount: number;
+    /**
+     * Number of successfully sent notifications.
+     */
+    successNotificationCount: number;
+    /**
+     * Number of notifications that failed to send.
+     */
+    failureNotificationCount: number;
+}
+
 export declare interface SendTivioTemplateEmailRequest {
     notificationId: string;
     organizationId: string;
@@ -5281,6 +5501,24 @@ export declare interface SeriesTileSpecificData {
     availableSeasons: AvailableSeason[];
 }
 
+/**
+ * @public
+ */
+export declare enum SessionType {
+    /**
+     * Umbrella streaming - viewer will be able to switch between different sources linked to the main source.
+     */
+    INTERACTIVE = "interactive",
+    /**
+     * Classic streaming - viewer will be able to watch a single LIVE source.
+     */
+    LIVE = "live",
+    /**
+     * On-demand streaming - viewer will be able to watch a single VOD source.
+     */
+    ON_DEMAND = "ondemand"
+}
+
 export declare interface SetCustomClaimsRequest {
     organizationId: string;
 }
@@ -5337,6 +5575,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,
@@ -5437,6 +5779,19 @@ export declare type StartAndContinuePosition = {
     continueFromPosition?: number;
 };
 
+export declare type StartLiveStreamPayload = BaseWidgetControlPayload;
+
+declare interface StartLiveStreamRequest {
+    action: 'startLiveStream';
+    payload: StartLiveStreamPayload;
+}
+
+export declare interface StartLiveStreamResponse {
+    liveStreamProcessPath: string;
+    streamingStudioProcessPath: string;
+    error?: string;
+}
+
 /**
  * @public
  */
@@ -5559,8 +5914,8 @@ export declare interface Tag extends RowItem {
     detailBanner?: string;
     availableSeasons?: AvailableSeason[];
     isFavorite: boolean;
-    addToFavorites: () => void;
-    removeFromFavorites: () => void;
+    addToFavorites: () => Promise<void>;
+    removeFromFavorites: () => Promise<void>;
     cover: string;
     getApplicationName: () => string | undefined;
     seriesRef?: DocumentReference<any>;
@@ -5908,7 +6263,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;
     }>;
@@ -5937,9 +6291,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>;
 }
@@ -5965,14 +6317,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;
@@ -6198,6 +6560,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;
     }>;
@@ -6363,55 +6728,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;
@@ -6599,6 +6915,25 @@ export declare enum TvStreamType {
  */
 export declare const TvTivioProvider: React_2.FC<TivioProviderProps>;
 
+export declare type UpdateNotificationSettingsRequest = {
+    tokenToAdd: string;
+    platform: string;
+    tokenToDelete?: string;
+    validateToken?: never;
+} | {
+    tokenToDelete: string;
+    tokenToAdd?: never;
+    platform?: never;
+    validateToken?: never;
+} | {
+    validateToken: string;
+    tokenToAdd?: never;
+    platform?: never;
+    tokenToDelete?: never;
+};
+
+export declare type UpdateNotificationSettingsResponse = Promise<boolean>;
+
 export declare type UpsertCommentResponse = AddEditCommentResponse | DeleteCommentResponse;
 
 /**
@@ -6693,7 +7028,7 @@ export declare const useChannelSource: (tvChannelId: string) => {
  * but for live video with comments, we want to subscribe to conversation
  */
 export declare type UseComments = (options: UseMessagesOptions) => {
-    pagination: PaginationInterface<Comment>;
+    pagination: PaginationInterface<unknown>;
     addComment: (options: AddMessageOptions) => Promise<UseMessagesAddEditMessageResponse>;
     editComment: (options: EditMessageOptions) => Promise<UseMessagesAddEditMessageResponse>;
     deleteComment: (commentId: string) => Promise<UseMessagesDeleteMessageResponse>;
@@ -6956,6 +7291,9 @@ export declare type User = {
     getAllExtendableSubscriptions: () => Promise<Purchase[]>;
     getRssValidToken: () => Promise<TokenInterface | undefined>;
     getRssUrl: () => Promise<GetUserRssUrlResponse>;
+    getFavorites: (options?: GetUserProfileDataOptions) => Promise<FavoriteWithData[]>;
+    getWatchPositions: (options?: GetUserProfileDataOptions) => Promise<WatchPositionWithData[]>;
+    getWatchHistory: (options?: GetUserProfileDataOptions) => Promise<WatchPositionWithData[]>;
     invalidateAllTokens: (type: TokenType) => Promise<void>;
     isPartiallyRegistered: boolean;
     conversationStore: ConversationStore;
@@ -6987,6 +7325,16 @@ export declare enum UserGroup {
     PREMIUM = "premium"
 }
 
+export declare interface UserNotificationRegistrationToken {
+    token: string;
+    platform?: string;
+    created: Timestamp;
+}
+
+export declare interface UserNotificationSettings {
+    registrationTokens?: UserNotificationRegistrationToken[];
+}
+
 /**
  * @public
  */
@@ -7255,6 +7603,16 @@ export declare interface verifyCustomTokenProps {
     organizationPath: string;
 }
 
+declare interface VerifyJoinCodePayload extends BaseWidgetControlPayload {
+    joinCode: string;
+    shouldJoinPlayer?: boolean;
+}
+
+export declare interface VerifyJoinCodeRequest {
+    action: 'verifyJoinCode';
+    payload: VerifyJoinCodePayload;
+}
+
 /**
  * @public
  */
@@ -7311,8 +7669,8 @@ export declare interface Video extends RowItem, MonetizableItem, ReactableConten
     tasting: Video | null;
     watchPosition: number | null;
     isFavorite: boolean;
-    addToFavorites: () => void;
-    removeFromFavorites: () => void;
+    addToFavorites: () => Promise<void>;
+    removeFromFavorites: () => Promise<void>;
     availability: ContentAvailability | null;
     sourceLanguages: LangCode[];
     urlByLanguage: (lang: LangCode) => string | undefined;
@@ -7348,6 +7706,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;
@@ -7688,6 +8194,21 @@ export declare interface WarningConfirmationOverlayPayload extends ConfirmationO
     subscriptionExpirationText?: string;
 }
 
+/**
+ * @public
+ */
+export declare interface WatchPositionWithData extends Omit<UserWatchPositionField, 'videoRef' | 'tagRef'> {
+    /**
+     * Video that given watch position is related to.
+     */
+    video: Video;
+    /**
+     * If user watches episode of series, we have to save series ref as well.
+     * Same for {@link episodeNumber} and {@link seasonNumber}.
+     */
+    tag?: Tag;
+}
+
 /**
  * @public
  */
@@ -7905,6 +8426,10 @@ export declare interface WebConfig {
             [key: string]: string;
         };
     };
+    /**
+     * Map for all handlers
+     */
+    handlers?: PurchaseEventHandlers;
 }
 
 /**
@@ -7970,10 +8495,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.
      */
@@ -8096,6 +8618,16 @@ export declare type Widget = {
     lastVideo: Video | null;
 };
 
+export declare type WidgetControlRequest = StartLiveStreamRequest | ChangeWidgetStateRequest_2 | GenerateWidgetJoinCodeRequest | VerifyJoinCodeRequest;
+
+export declare type WidgetControlResponse<T extends WidgetControlRequest['action']> = T extends 'startLiveStream' ? StartLiveStreamResponse : T extends 'changeState' ? ChangeStateResponse : T extends 'generateWidgetJoinCode' ? GenerateWidgetJoinCodeResponse : T extends 'verifyJoinCode' ? boolean : never;
+
+export declare interface WidgetSecret {
+    code: string;
+    type: 'JWT' | 'alphanumeric';
+    expired?: Date;
+}
+
 /**
  * @public
  */