@tivio/sdk-react 9.1.3-alpha3 → 9.1.3

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { ComponentType } from 'react';
+import type { ComponentType } from 'react';
 import type dayjs from 'dayjs';
 import { DocumentReference } from '@firebase/firestore-types';
 import type duration from 'dayjs/plugin/duration';
-import firebase from '@firebase/app-types';
+import type firebase from '@firebase/app-types';
 import { FunctionComponentElement } from 'react';
 import type { GeoPoint } from '@firebase/firestore-types';
 import { OperatingSystem } from 'detect-browser';
@@ -21,6 +21,8 @@ export declare type ActivateVoucherResponse = string | {
     activatedPromotions: ActivatedPromotionResponse[];
 };
 
+export declare type AdBannerScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.AD_BANNER>;
+
 export declare type AddEditCommentResponse = {
     id: string;
     error?: string;
@@ -515,7 +517,8 @@ export declare enum BannerItemComponent {
     BACKGROUND = "BACKGROUND",
     BACKGROUND_BLUR = "BACKGROUND_BLUR",
     ORGANIZATION_BANNER = "ORGANIZATION_BANNER",
-    CAROUSEL = "CAROUSEL"
+    CAROUSEL = "CAROUSEL",
+    RATIO = "RATIO"
 }
 
 /**
@@ -940,6 +943,8 @@ export declare interface ConversionsTargetItem {
     totalCount: number;
 }
 
+export declare type CountdownScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.COUNTDOWN>;
+
 /**
  * @public
  * @TODO move somewhere else
@@ -962,6 +967,10 @@ export declare const createPubSub: () => PubSub;
  */
 export declare const createRemotePackageLoader: () => (secret: string, conf: InternalConfig, checkBundleCharCount?: boolean) => Promise<TivioBundle>;
 
+export declare const createTivio: () => (conf: SdkReactConfig) => Promise<RemoteBundleState>;
+
+export declare const createUseRemoteBundle: () => (sdkReactConfig: SdkReactConfig, checkBundleCharCount?: boolean) => RemoteBundleState;
+
 export declare interface CreateUserPayload {
     displayName?: string;
     email?: string;
@@ -1002,6 +1011,17 @@ export declare type Currency = 'CZK' | 'EUR' | 'USD';
  */
 export declare type CurrencyLowerCase = 'czk' | 'eur' | 'usd';
 
+export declare interface CurrentQuestion {
+    id: string;
+    question: Translation;
+    answers?: QuestionAnswer[];
+    index?: number;
+    endTimestampMs?: number;
+    status?: QuizGameStatus;
+}
+
+export declare type CurrentQuestionScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.CURRENT_QUESTION>;
+
 /**
  * @public
  */
@@ -1057,7 +1077,8 @@ export declare enum CustomerId {
     NERUDA_TV = "NERUDA_TV",
     DAVID_FRANK_TV = "DAVID_FRANK_TV",
     LEPSI_UZ_TO_NEBUDE = "LEPSI_UZ_TO_NEBUDE",
-    BEAT_SEXISM = "BEAT_SEXISM"
+    BEAT_SEXISM = "BEAT_SEXISM",
+    KAROL_A_KVIDO = "KAROL_A_KVIDO"
 }
 
 export declare interface CustomScript {
@@ -1564,9 +1585,9 @@ export declare interface GetSourceUrlResponse {
      */
     audioOnly?: boolean;
     /**
-     * URL for source modification for user (e.g. add PIP window to livestream).
+     * Current session id for given user and source.
      */
-    managementUrl?: string;
+    sessionId?: string;
     /**
      * Template for generating image previews for user scrubbing in player.
      */
@@ -1644,6 +1665,8 @@ export declare interface GetViewAnalyticsResponse {
 
 export declare type GetViewsAnalyticsRequest = GetBaseAnalyticsRequest;
 
+export declare let globalSdkReactConfig: SdkReactConfig | undefined;
+
 /**
  * @public
  */
@@ -1758,6 +1781,117 @@ export declare interface IndexedVideo extends IndexedObject {
 
 export declare type IntegrationType = 'discord' | 'patreon';
 
+export declare interface InteractiveWidget<T extends InteractiveWidgetScene = InteractiveWidgetScene> {
+    readonly id: string;
+    readonly path: string;
+    readonly currentQuestion: CurrentQuestion | null;
+    readonly status: QuizGameStatus;
+    readonly questionsCount: number;
+    readonly currentAnswerId?: string;
+    readonly currentState: InteractiveWidgetState;
+    /**
+     * State delayed for end users, which is used to toggle scenes just like in OBS and host view
+     */
+    readonly currentStateWithDelay: InteractiveWidgetCurrentStateWithDelay;
+    readonly answers?: QuestionAnswer[];
+    readonly questionIndex?: number;
+    readonly isSubmitted?: boolean;
+    readonly leaderboard: LeaderboardGroupItem | null;
+    readonly highlightedUsersIds: string[];
+    readonly userRole: QuizGameRole;
+    readonly secondsToAnswer: number;
+    readonly scenes: T[];
+    readonly activeScene: T | null;
+    readonly theme?: InteractiveWidgetTheme;
+    readonly showCountdown: boolean;
+    readonly lastQuestionTopScorers: LeaderboardPlayer[];
+    readonly questionRepository: QuestionRepository;
+    readonly isWaitingForStart: boolean;
+    answerQuestion(answerId: string): void;
+    submitAnswer(request: Pick<SubmitAnswerRequest, 'answerOptionId' | 'answerText'>): Promise<void>;
+    destroy(): void;
+}
+
+export declare interface InteractiveWidgetCurrentStateWithDelay {
+    state: InteractiveWidgetState;
+    enteredAt: Date;
+}
+
+export declare enum InteractiveWidgetDisplayComponent {
+    LEADERBOARD_SUMMARY = "leaderboardSummary",
+    FULLSCREEN_LEADERBOARD = "fullscreenLeaderboard",
+    CURRENT_QUESTION = "currentQuestion",
+    PLAYERS = "players",
+    QR_CODE = "qrCode",
+    AD_BANNER = "adBanner",
+    AD_VAST = "adVast"
+}
+
+export declare type InteractiveWidgetScene = CurrentQuestionScene | LeaderboardScene | QRCodeScene | AdBannerScene | PlayersScene | NoGraphicsScene | CountdownScene;
+
+export declare interface InteractiveWidgetSceneBase<TType extends InteractiveWidgetSceneTemplateType> {
+    id: string;
+    type: TType;
+    name: Translation;
+    metadata: SceneMetadata<TType>;
+}
+
+export declare enum InteractiveWidgetSceneTemplateType {
+    COUNTDOWN = "countdown",
+    CURRENT_QUESTION = "currentQuestion",
+    LEADERBOARD = "leaderboard",
+    PLAYERS = "players",
+    AD_BANNER = "adBanner",
+    QR_CODE = "qrCode",
+    NO_GRAPHICS = "noGraphics"
+}
+
+export declare enum InteractiveWidgetState {
+    /**
+     * Transition to the next state
+     */
+    NEXT_STATE = "NextState",
+    /**
+     * Idle state
+     * activeSceneIds: noGraphics, adBanner, players
+     * Idle -> Countdown
+     */
+    IDLE = "Idle",
+    /**
+     * Countdown -> CurrentQuestion
+     */
+    COUNTDOWN = "Countdown",
+    /**
+     * Displays the current question
+     */
+    CURRENT_QUESTION = "CurrentQuestion",
+    /**
+     * CurrentQuestion -> GuestsAnsweredQuestions
+     */
+    GUESTS_ANSWERED_QUESTIONS = "GuestsAnsweredQuestions",
+    /**
+     * GuestsAnsweredQuestions -> ResolvedQuestion
+     */
+    RESOLVED_QUESTION = "ResolvedQuestion",
+    /**
+     * ResolvedQuestion -> ShowResults
+     */
+    LEADERBOARD = "Leaderboard",
+    /**
+     * Reset Game can be called only from Idle state
+     */
+    RESET_GAME = "ResetGame"
+}
+
+export declare interface InteractiveWidgetTheme {
+    palette: Record<string, string>;
+    components: {
+        [key in InteractiveWidgetThemeKey]?: Record<string, string>;
+    };
+}
+
+declare type InteractiveWidgetThemeKey = InteractiveWidgetDisplayComponent | `${InteractiveWidgetDisplayComponent.CURRENT_QUESTION}${AnswerStatus}` | 'timeLeftBar';
+
 /**
  * @public
  */
@@ -1835,7 +1969,7 @@ export declare function isVodTivioSource(source?: CommonSource | null): source i
 /**
  * @public
  */
-export declare type ItemComponent = RowItemComponent | BannerItemComponent;
+export declare type ItemComponent = RowItemComponent | BannerItemComponent | SurveyItemComponent;
 
 /**
  * @public
@@ -1900,6 +2034,31 @@ export declare interface LastMessage {
     createdAt: Date;
 }
 
+export declare interface LeaderboardGroupItem {
+    groupPath?: string;
+    groupName?: string;
+    type: QuizGameGroupType;
+    /**
+     * Consists of top 3 players of the group (global or private team)
+     * the player's rank in the group
+     * and adjacent players in the group leaderboard
+     */
+    players: LeaderboardPlayer[];
+}
+
+export declare interface LeaderboardPlayer {
+    id: string;
+    rank: number;
+    name?: string;
+    score: number;
+    /**
+     * We use this date to distinguish between players with the same name
+     */
+    userCreatedDate: Date;
+}
+
+export declare type LeaderboardScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.LEADERBOARD>;
+
 /**
  * @public
  */
@@ -2324,6 +2483,8 @@ export declare type NewVoucher = {
 
 declare type NextPageParamType = 'screenId' | 'rowId' | 'filter';
 
+export declare type NoGraphicsScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.NO_GRAPHICS>;
+
 /**
  * @public
  */
@@ -2534,6 +2695,11 @@ export declare interface OrganizationSettingsField extends OrganizationResponsiv
     cancelledSubscriptionDiscount?: {
         enabled: boolean;
     };
+    modalDetail?: {
+        tagModal?: {
+            hideTitle?: boolean;
+        };
+    };
 }
 
 /**
@@ -2887,6 +3053,18 @@ export declare interface PlayerError {
     message: string;
 }
 
+/**
+ * @public
+ */
+export declare type PlayerEvent = {
+    name: PlayerEventName;
+};
+
+/**
+ * @public
+ */
+export declare type PlayerEventName = `${PlayerWrapperEvents}`;
+
 /**
  * @public
  */
@@ -3029,6 +3207,8 @@ export declare interface PlayerSourceParams<T extends NonAdSourceType = NonAdSou
     sourcePlayMode: SourcePlayMode;
 }
 
+export declare type PlayersScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.PLAYERS>;
+
 /**
  * @public
  */
@@ -3070,11 +3250,19 @@ export declare interface PlayerWrapper {
      * Pause video
      */
     pause: () => void;
+    ad: AdSourceInterface | null;
+    adMetadata: AdMetadata | null;
+    adSegment: AdSegment | null;
+    availableLanguages: LangCode[] | null;
+    canReplay: boolean;
+    currentTime: number;
     /**
      * Currently playing source
      */
     source: PlayerSource | null;
+    seekInterceptor: SeekInterceptor;
     events: EmitterInterface;
+    event: PlayerEvent | null;
     /**
      * Register a low level player that implements player methods, like play video, change volume, etc.
      */
@@ -3082,12 +3270,29 @@ export declare interface PlayerWrapper {
     /**
      * duration of current source in ms (both setter and getter)
      */
-    durationMs: number | null;
+    durationMs: number;
+    intro: {
+        marker: any;
+        skip: () => void;
+    } | null;
+    isBuffering: boolean;
+    isCurrentTimeLive: boolean;
+    isLiveSeekingEnabled: boolean;
+    isMuted: boolean;
     isPlaybackStarted?: boolean;
     isPaused: boolean;
     isPlaying: boolean;
     isIdle: boolean;
+    language: LangCode | null;
+    nextRecommendedVideo: Video | null;
+    prerollCheck: PrerollCheck;
+    previousSource: PlayerSource | null;
+    progress: number | null;
+    progressMetadata: ProgressMetadata;
+    requestedSource: PlayerSource | null;
     error: PlayerError | null;
+    state: PlayerState;
+    volume: number;
     /**
      * Replay the video that finished playback
      */
@@ -3102,6 +3307,7 @@ export declare interface PlayerWrapper {
      * set volume to value between 0,1
      */
     setVolume: (volume: number) => void;
+    changeLanguage: (langCode: LangCode) => Promise<void>;
     /**
      * change volume by value between -1,1
      */
@@ -3109,6 +3315,48 @@ export declare interface PlayerWrapper {
     setMuted: (muted: boolean) => void;
     toggleMuted: () => void;
     getQualities: () => Track[];
+    playNativeImaAd: (url: string) => void;
+    playSourceAfterAdsRun: () => void;
+    putAd: (ad: AdSourceInterface) => void;
+    putAdMetadata: (ad: AdSourceInterface) => void;
+    reportLoadError: (error: Error) => void;
+    reportStateChanged: (state: PlayerState) => void;
+    reportTimeProgress: (ms: number) => void;
+    reportPlaybackCancelled: () => void;
+    reportPlaybackError: (error: Error) => void;
+    reportPlaybackEnded: () => void;
+    seekToPercent: (percentage: number) => void;
+    seekToInternal: (ms: number) => void;
+    seekToLive: () => void;
+    seekToLiveInternal: () => void;
+    setIsBuffering: (isBuffering: boolean) => void;
+    skipAd: () => void;
+    skipAllAds: () => void;
+}
+
+/**
+ * @public
+ */
+export declare enum PlayerWrapperEvents {
+    'playback_cancelled' = "playback_cancelled",
+    /**
+     * Triggered when content video or ad finished playing until the end
+     */
+    'playback_ended' = "playback_ended",
+    /**
+     * Triggered when both content video and all its associated ads finished playing until the end.
+     * Or in case of postroll, when content video finished playing unit the end and all postroll
+     * ads either finished / failed or were skipped.
+     */
+    'video_unit_ended' = "video_unit_ended",
+    /**
+     * Pause was triggered
+     */
+    'pause_triggered' = "pause_triggered",
+    /**
+     * Un-pause was triggered
+     */
+    'unpause_triggered' = "unpause_triggered"
 }
 
 /**
@@ -3124,6 +3372,18 @@ export declare enum PlayerWrapperEventType {
  */
 export declare type PlayerWrapperEventTypeType = `${PlayerWrapperEventType}`;
 
+/**
+ * @public
+ */
+/**
+ * A promise that ads will be loaded. Resolves to the first ad source,
+ * other ads are linked to it via `ad.next` attribute.
+ *
+ * In case preroll is not configured or no ad
+ * manages to load successfully, resolves to null.
+ */
+export declare type PrerollCheck = (source: PlayerSource) => Promise<AdSourceInterface | null>;
+
 /**
  * Values that user entered in survey for given profile.
  */
@@ -3132,6 +3392,18 @@ export declare type ProfileSurvey = {
     age?: AgeRange;
 };
 
+/**
+ * @public
+ */
+export declare interface ProgressMetadata {
+    currentTimeMs: number;
+    durationMs: number;
+    percent: number;
+    remainingMs: number;
+    type: 'original' | 'cutout';
+    cutout?: Cutout;
+}
+
 /**
  * @public
  */
@@ -3481,7 +3753,12 @@ export declare enum PurchaseStatus {
     /**
      * From PAID to EXPIRED when payment fails to renew subscription.
      */
-    EXPIRED = "EXPIRED"
+    EXPIRED = "EXPIRED",
+    /**
+     * From PAID to EXPIRING when a Stargaze purchase has passed its expire date but hasn't been fully expired yet.
+     * Stargaze will try to renew the purchase even after it has expired.
+     */
+    EXPIRING = "EXPIRING"
 }
 
 /**
@@ -3612,6 +3889,58 @@ export declare interface QerkoTransaction {
     voucherId?: string;
 }
 
+export declare type QRCodeScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.QR_CODE>;
+
+export declare interface QuestionAnswer {
+    id: string;
+    answer: Translation;
+    isCorrect?: boolean;
+    votes?: number;
+    status?: AnswerStatus;
+}
+
+export declare enum QuestionEvents {
+    NEW_QUESTION = "new_question",
+    ANSWER_SELECTED = "answer_selected",
+    COUNTDOWN_START = "countdown_start",
+    COUNTDOWN_END = "countdown_end",
+    QUESTION_TIMEOUT = "question_timeout"
+}
+
+export declare interface QuestionRepository {
+    on<K extends keyof QuestionRepositoryEventMap>(event: K, listener: QuestionRepositoryEventMap[K]): void;
+    off<K extends keyof QuestionRepositoryEventMap>(event: K, listener: QuestionRepositoryEventMap[K]): void;
+    readonly showCountdown: boolean;
+    readonly currentQuestion: CurrentQuestion | null;
+    readonly selectedAnswerId: string | undefined;
+    isSubmitted: boolean;
+    isSubmitting: boolean;
+    setCurrentQuestion: (question: CurrentQuestion | null, role: QuizGameRole, secondsToAnswer: number, shouldEnterAtTimestampMs?: number) => void;
+    selectAnswer: (answerId: string | undefined) => void;
+    setShowCountdown: (showCountdown: boolean) => void;
+    reset: () => void;
+}
+
+export declare type QuestionRepositoryEventMap = {
+    [QuestionEvents.NEW_QUESTION]: (question: CurrentQuestion | null) => void;
+    [QuestionEvents.ANSWER_SELECTED]: (answerId: string | undefined) => void;
+    [QuestionEvents.COUNTDOWN_START]: () => void;
+    [QuestionEvents.COUNTDOWN_END]: () => void;
+    [QuestionEvents.QUESTION_TIMEOUT]: (question: CurrentQuestion | null) => void;
+};
+
+export declare interface QuizGameGroupStats {
+    answerPercentages: Record<string, number>;
+    averageScore: number;
+    correctAnswersRatio: number;
+}
+
+export declare enum QuizGameGroupType {
+    HIGHLIGHTED_PLAYERS = "HIGHLIGHTED_PLAYERS",
+    ALL = "ALL",
+    PARTY = "PARTY"
+}
+
 export declare enum QuizGameRole {
     OBS = "OBS",
     HOST = "HOST",
@@ -3703,10 +4032,11 @@ declare type Relationship = {
  * @public
  */
 export declare type RemoteBundleState = {
-    config: InternalConfig;
-    error: string | null;
     state: 'loading' | 'error' | 'ready';
-} & Nullable<TivioBundle>;
+    error: string | null;
+    config: InternalConfig;
+    settings: Settings;
+} & Omit<Partial<TivioJsBundleExposedApi>, 'createPlayerWrapper'> & Nullable<TivioBundle>;
 
 /**
  * @public
@@ -3740,6 +4070,8 @@ export declare interface RenderConditionValue {
     subscriptionRefs?: any[];
 }
 
+export declare const renderWebPlayer: (container: HTMLElement, props: WebPlayerProps) => void;
+
 /**
  * Make all attributes in given type required, non-nullable and defined.
  * e.g. will make `{ attribute?: string | null }` to be `{ attribute: string }`
@@ -4065,6 +4397,26 @@ export declare type ScalableAsset = {
  */
 export declare type Scale = '@1' | '@2' | '@3';
 
+declare type SceneMetadata<TType extends InteractiveWidgetSceneTemplateType> = TType extends InteractiveWidgetSceneTemplateType.CURRENT_QUESTION ? {
+    highlightedUsersAnswers: Array<{
+        answerId: string;
+        userId: string;
+    }>;
+} : TType extends InteractiveWidgetSceneTemplateType.LEADERBOARD ? {
+    highlightedPlayers: LeaderboardPlayer[];
+    topPlayers: LeaderboardPlayer[];
+    stats?: QuizGameGroupStats;
+} : TType extends InteractiveWidgetSceneTemplateType.QR_CODE ? Record<Extract<SceneMetadataKeys[TType], string>, string> : TType extends InteractiveWidgetSceneTemplateType.AD_BANNER ? Record<Extract<SceneMetadataKeys[TType], string>, string> : TType extends InteractiveWidgetSceneTemplateType.PLAYERS ? Record<Extract<SceneMetadataKeys[TType], string>, string> : object;
+
+export declare interface SceneMetadataKeys {
+    [InteractiveWidgetSceneTemplateType.CURRENT_QUESTION]: 'highlightedUsersAnswers';
+    [InteractiveWidgetSceneTemplateType.LEADERBOARD]: 'highlightedPlayers';
+    [InteractiveWidgetSceneTemplateType.QR_CODE]: 'qrCodeUrl' | 'title' | 'subtitle';
+    [InteractiveWidgetSceneTemplateType.AD_BANNER]: 'bannerImage';
+    [InteractiveWidgetSceneTemplateType.PLAYERS]: 'centerHtml' | 'player1Name' | 'player2Name' | 'player1Image' | 'player2Image' | 'player1Id' | 'player2Id';
+    [InteractiveWidgetSceneTemplateType.NO_GRAPHICS]: never;
+}
+
 export declare interface ScheduleNotificationRequest {
     notificationPath: string;
 }
@@ -4202,6 +4554,26 @@ export declare interface SeekingMatrixTemplate {
     interval: number;
 }
 
+export declare interface SeekInterceptionResult {
+    position: number | null;
+    didChangePosition: boolean;
+    priority: number;
+}
+
+/**
+ * @public
+ */
+export declare interface SeekInterceptor {
+    addInterceptor(interceptor: SeekInterceptorFunction, callback?: SeekInterceptorCallback): void;
+    applyInterceptors(currentPosition: number, seekPosition: number): SeekInterceptionResult;
+    callCallbacksAfterInterception(): void;
+    removeInterceptor(interceptor: SeekInterceptorFunction): void;
+}
+
+export declare type SeekInterceptorCallback = (requestedSeekPosition: number) => void;
+
+export declare type SeekInterceptorFunction = (currentPosition: number, seekPosition: number) => SeekInterceptionResult;
+
 export declare enum SemanticDate {
     YESTERDAY = "Yesterday",
     TODAY = "Today",
@@ -4271,6 +4643,13 @@ export declare interface SetCustomClaimsRequest {
     organizationId: string;
 }
 
+export declare const setSdkReactConfig: (tivioConfig: SdkReactConfig) => void;
+
+declare type Settings = {
+    onSetUser: (handler: (userId: string, userPayload: UserPayload) => void) => void;
+    setUser: (userId: string, userPayload: UserPayload) => void;
+};
+
 /**
  * Used for entities, that can be global (e.g. asset presets, tag types).
  * Non-global is stored under organizations (in sub-collection), and shown for organization's users and super-admin.
@@ -4415,6 +4794,15 @@ export declare interface StoreBadgeConfig {
     appId: string;
 }
 
+export declare interface SubmitAnswerRequest {
+    answerOptionId?: string;
+    answerText?: string;
+    clientTimestamp: number;
+    questionEndTimestamp?: number;
+    widgetPath: string;
+    questionId: string;
+}
+
 export declare interface SubmitAnswerResponse {
     id: string;
     receivedTimestamp: number;
@@ -4481,6 +4869,10 @@ export declare interface SuccessConfirmationOverlayPayload extends ConfirmationO
     confirmButtonText?: string;
 }
 
+export declare enum SurveyItemComponent {
+    SURVEY = "SURVEY"
+}
+
 export declare type SynchronizeUserTypeFunction = (payload: CreateUserPayload, tenantId: string, tenantUserId: string, organizationId?: string) => Promise<string>;
 
 /**
@@ -4857,13 +5249,25 @@ export declare type TivioGetters = {
     getPlayerWrapper: (opt: {
         playerWrapperId?: string;
     }) => PlayerWrapper;
-    getOrganizationSubscriptions: () => Promise<Monetization[] | undefined>;
+    organization: {
+        /**
+         * Get organization subscriptions
+         * @returns {Promise<Monetization[] | undefined>} organization subscriptions or undefined if organization does not exists
+         */
+        getSubscriptions: () => Promise<Monetization[] | undefined>;
+    } | null;
     /**
      * Get video by its id.
      * @param videoId - video id
      * @returns {Promise<Video | null>} video or null if video does not exists
      */
     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
+     */
+    getScreenById: (screenId: string, cb?: (error: Error | null, data: Screen_2 | null, disposer?: Disposer_2) => void) => Promise<Screen_2 | null>;
     /**
      * Get player capabilities based on user's browser and OS as resolved by Tivio.
      * @returns PlayerCapability[]
@@ -5049,7 +5453,7 @@ export declare type TivioJsBundleExposedApi = {
      * @param id - player wrapper id
      * @returns {Player} player wrapper instance
      */
-    getPlayerWrapper: (id: string) => Player;
+    getPlayerWrapper: (id: string) => PlayerWrapper;
     /**
      * Get tv channel by its id.
      * @param tvChannelId - tv channel id
@@ -5064,7 +5468,7 @@ export declare type TivioJsBundleExposedApi = {
     getTagById: (tagId: string) => Promise<Tag | null>;
     createPlayerWrapper: (playerImplementation: PlayerInterfaceForPlayerWrapper) => TivioPlayerWrapper;
     destroy: () => Promise<void>;
-} & Pick<TivioGetters, 'getVideoById'> & Pick<TivioSubscriptions, 'subscribeToVideo' | 'subscribeToItemsInRow'> & Pick<TivioAuth, 'createUserWithEmailAndPassword' | 'signInWithEmailAndPassword'> & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
+} & Pick<TivioGetters, 'getVideoById' | 'getScreenById' | 'organization'> & Pick<TivioSubscriptions, 'subscribeToVideo' | 'subscribeToItemsInRow' | 'subscribeToRowsInScreen'> & Pick<TivioAuth, 'createUserWithEmailAndPassword' | 'signInWithEmailAndPassword'> & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
 
 /**
  * @public
@@ -5090,13 +5494,12 @@ export declare const TivioProvider: React_2.FC<TivioProviderProps>;
 /**
  * @public
  */
-export declare type TivioProviderProps = {
+export declare interface TivioProviderProps extends React_2.PropsWithChildren {
     /**
      * This prop must be set only once and not change value afterwards
      */
     conf: SdkReactConfig | undefined | null;
-    children: React_2.ReactNode;
-};
+}
 
 /**
  * @public
@@ -5125,7 +5528,7 @@ export declare type TivioReactBundle = {
     internal: TivioInternalBundle;
     analytics: TivioAnalytics;
     destroy: () => Promise<void>;
-} & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
+} & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'> & Omit<Partial<TivioJsBundleExposedApi>, 'createPlayerWrapper'>;
 
 /**
  * @public
@@ -5750,11 +6153,6 @@ export declare interface UseReactionsOptions {
     onError?: (error: Error) => void;
 }
 
-/**
- * @public
- */
-export declare const useRemoteBundle: (conf: InternalConfig, checkBundleCharCount?: boolean) => RemoteBundleState;
-
 export declare enum UserGroup {
     ALL = "all",
     FREE = "free",
@@ -6098,6 +6496,7 @@ export declare interface Video extends RowItem, MonetizableItem, ReactableConten
     pgRating?: string;
     contentDescriptors?: string[];
     publishedStatus?: PublishedStatus;
+    widgetPaths?: string[];
 }
 
 /**
@@ -6160,7 +6559,7 @@ export declare enum VideoSourceEncryption {
     PLAYREADY = "playready"
 }
 
-export declare interface VideoSourceField {
+export declare type VideoSourceField = {
     codec: VideoSourceCodec;
     /**
      * DRM provider for given encrypted source.
@@ -6176,24 +6575,40 @@ export declare interface VideoSourceField {
     priority: VideoSourcePriority;
     protocol: VideoSourceProtocol;
     provider?: VideoSourceProvider;
-    url: string;
     languages?: LangCode[];
-    /**
-     * URL for source modification for user (e.g. add PIP window to livestream).
-     */
-    managementUrl?: string;
     /**
      * Seeking matrix override for given source.
      */
     seekingMatrix?: Partial<SeekingMatrixTemplate>;
     /**
-     * Content id override to include generated jwt token.
+     * Determines session type generated for source. If no provided it will be considered 'ondemand' session type.
+     */
+    sessionType?: 'channel' | 'interactive' | 'live' | 'ondemand';
+    /**
+     * Content id override to include in authentication for api-streaming worker.
      * Used when you have several sources from different contents (videos).
-     * Without it {@link getSourceUrl} will use document's id, and jwt token validation might fail
-     * because content id in source url and in token will not match.
+     * Without it {@link getSourceUrl} will use document's id, and authentication might fail
+     * because content id in source url and authentication will not match.
      */
     contentId?: string;
-}
+} & ({
+    url: string;
+    provider?: Exclude<VideoSourceProvider, VideoSourceProvider.CLOUDFLARE>;
+} | {
+    url: string;
+    /**
+     * If both contentId and profileId provided, we don't need url, we have enough information to generate cloudflare source.
+     */
+    provider: VideoSourceProvider.CLOUDFLARE;
+    profileId: string;
+    /**
+     * Options to send to session source generation api. See {@link GenerateSessionSourceRequest} in @tivio/api.
+     * TODO type duplication, but have no way to import ^ here.
+     */
+    options?: {
+        delaySegmentCount?: number;
+    };
+});
 
 /**
  * Lower number = higher priority.
@@ -6737,6 +7152,7 @@ export declare interface WebPlayerProps {
     disablePlayNext?: boolean;
     setPaymentOverlayVisible?: React_2.Dispatch<React_2.SetStateAction<boolean>>;
     hideOverlay?: boolean;
+    sourcePlayMode?: SourcePlayMode;
 }
 
 /**