@tivio/sdk-react 10.0.0 → 10.2.0

package/dist/index.d.ts

@@ -1,8 +1,7 @@
 import type { ComponentType } from 'react';
 import { DocumentReference } from '@firebase/firestore-types';
 import type duration from 'dayjs/plugin/duration';
-import type { default as firebase_2 } from '@firebase/app-types';
-import type { default as firebase_3 } from 'firebase';
+import type firebase from '@firebase/app-types';
 import { FunctionComponentElement } from 'react';
 import type { GeoPoint } from '@firebase/firestore-types';
 import { OperatingSystem } from 'detect-browser';
@@ -26,7 +25,22 @@ export declare interface ActivatedPromotionsWithIdsResponse {
     activatedPromotionsIds: string[];
 }
 
-export declare type ActivateVoucherResponse = string | ActivatedPromotionsResponse | ActivatedPromotionsWithIdsResponse;
+/**
+ * Response returned when `activateVoucher` is called with `responseFormat: 'extended'`.
+ *
+ * It always carries `voucherInfo` (safe server-side metadata) and, depending on the
+ * voucher type, either a `purchaseId` (transaction / subscription) or the list of
+ * `activatedPromotions` (promotion voucher).
+ */
+export declare interface ActivateVoucherExtendedResponse {
+    voucherInfo: VoucherInfoPublic;
+    purchaseId?: string;
+    activatedPromotions?: ActivatedPromotion[];
+}
+
+export declare type ActivateVoucherResponse = string | ActivatedPromotionsResponse | ActivatedPromotionsWithIdsResponse | ActivateVoucherExtendedResponse;
+
+export declare type ActivateVoucherResponseFormat = 'legacy' | 'extended';
 
 declare interface actualPriceDetails {
     amountCents: number;
@@ -599,7 +613,7 @@ export declare interface AvatarProps {
  */
 export declare type BadRequestError = Error & {
     details?: {
-        reason?: 'DOES_NOT_EXIST' | 'EXPIRED' | 'ALREADY_USED' | 'ALREADY_USED_BY_CURRENT_USER';
+        reason?: 'DOES_NOT_EXIST' | 'EXPIRED' | 'ALREADY_USED' | 'ALREADY_USED_BY_CURRENT_USER' | 'LIMIT_REACHED' | 'FULFILLED' | 'INVALID_VOUCHER_TYPE';
     };
 };
 
@@ -649,6 +663,52 @@ export declare interface BannerProps {
  */
 export declare type BannerPropsPartial = Partial<BannerProps>;
 
+/**
+ * Fields and methods common to every interactive widget (quiz, poll, …).
+ * Parameterized over the concrete answer type, state type, and scene type so
+ * more specialized widget interfaces can narrow each axis independently.
+ */
+export declare interface BaseInteractiveWidget<TAnswer extends BaseQuestionAnswer = QuestionAnswer, TState extends InteractiveWidgetState = InteractiveWidgetState, TScene extends InteractiveWidgetScene = InteractiveWidgetScene> {
+    readonly id: string;
+    readonly name: string;
+    readonly path: string;
+    readonly type: InteractiveWidgetType;
+    readonly status: InteractiveWidgetStatus;
+    readonly questionsCount: number;
+    readonly currentAnswerId?: string;
+    readonly currentState: TState;
+    /**
+     * State delayed for end users, used to toggle scenes just like in OBS / host view.
+     */
+    readonly currentStateWithDelay: InteractiveWidgetCurrentStateWithDelay<TState>;
+    readonly currentQuestion: CurrentQuestion<TAnswer> | null;
+    readonly answers?: TAnswer[];
+    readonly questionIndex?: number;
+    readonly isSubmitted?: boolean;
+    readonly userRole: InteractiveWidgetRole;
+    readonly scenes: TScene[];
+    readonly activeScene: TScene | null;
+    readonly theme?: InteractiveWidgetTheme;
+    /**
+     * @remarks Always `false` for `PollWidget` — kept on the base to minimize
+     * disruption to existing consumers.
+     */
+    readonly isWaitingForStart: boolean;
+    answerQuestion(answerId: string): void;
+    submitAnswer(request: Pick<SubmitAnswerRequest, 'answerOptionId' | 'answerText'>): Promise<void>;
+    verifyJoinCode(joinCode: string, shouldJoinPlayer?: boolean): Promise<boolean>;
+    destroy(): void;
+}
+
+/**
+ * Fields shared by both quiz and poll answers.
+ */
+export declare interface BaseQuestionAnswer {
+    id: string;
+    answer: Translation;
+    status?: AnswerStatus;
+}
+
 /**
  * Base row interface with common fields
  * @public
@@ -1313,13 +1373,17 @@ export declare type CurrencyLowerCase = 'czk' | 'eur' | 'usd' | 'pln';
  */
 export declare const CurrencyToTitle: Record<Currency, string>;
 
-export declare interface CurrentQuestion {
+/**
+ * Generic "current question" shape, parameterized by answer type.
+ * Use `QuizQuestion` / `PollQuestion` for concrete forms.
+ */
+export declare interface CurrentQuestion<TAnswer extends BaseQuestionAnswer = QuestionAnswer> {
     id: string;
     question: Translation;
-    answers?: QuestionAnswer[];
+    answers?: TAnswer[];
     index?: number;
     endTimestampMs?: number;
-    status?: QuizGameStatus;
+    status?: InteractiveWidgetStatus;
 }
 
 export declare type CurrentQuestionScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.CURRENT_QUESTION>;
@@ -1406,7 +1470,9 @@ export declare enum CustomerId {
     THE_JOHNY = "THE_JOHNY",
     GOOD_MOVE = "GOOD_MOVE",
     JANA_HANZ = "JANA_HANZ",
-    MYSTICO = "MYSTICO"
+    MYSTICO = "MYSTICO",
+    MORAVEC = "MORAVEC",
+    JAN_TUNA = "JAN_TUNA"
 }
 
 export declare interface CustomScript {
@@ -2449,41 +2515,10 @@ export declare interface IndexedVideo extends IndexedObject {
 
 export declare type IntegrationType = 'discord' | 'patreon';
 
-export declare interface InteractiveWidget<T extends InteractiveWidgetScene = InteractiveWidgetScene> {
-    readonly id: string;
-    readonly name: 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>;
-    verifyJoinCode(joinCode: string, shouldJoinPlayer?: boolean): Promise<boolean>;
-    destroy(): void;
-}
+export declare type InteractiveWidget<TScene extends InteractiveWidgetScene = InteractiveWidgetScene> = QuizWidget<TScene> | PollWidget<TScene>;
 
-export declare interface InteractiveWidgetCurrentStateWithDelay {
-    state: InteractiveWidgetState;
+export declare interface InteractiveWidgetCurrentStateWithDelay<TState extends InteractiveWidgetState = InteractiveWidgetState> {
+    state: TState;
     enteredAt: Date;
 }
 
@@ -2497,6 +2532,27 @@ export declare enum InteractiveWidgetDisplayComponent {
     AD_VAST = "adVast"
 }
 
+export declare interface InteractiveWidgetGroupStats {
+    answerPercentages: Record<string, number>;
+    averageScore: number;
+    correctAnswersRatio: number;
+}
+
+export declare enum InteractiveWidgetGroupType {
+    HIGHLIGHTED_PLAYERS = "HIGHLIGHTED_PLAYERS",
+    /** Participants playing in Offline mode */
+    LOCAL_PLAYERS = "LOCAL_PLAYERS",
+    ALL = "ALL",
+    PARTY = "PARTY"
+}
+
+export declare enum InteractiveWidgetRole {
+    OBS = "OBS",
+    HOST = "HOST",
+    PLAYER = "PLAYER",
+    LOCAL_PLAYER = "LOCAL_PLAYER"
+}
+
 export declare type InteractiveWidgetScene = CurrentQuestionScene | LeaderboardScene | QRCodeScene | AdBannerScene | PlayersScene | NoGraphicsScene | CountdownScene;
 
 export declare interface InteractiveWidgetSceneBase<TType extends InteractiveWidgetSceneTemplateType> {
@@ -2554,6 +2610,16 @@ export declare enum InteractiveWidgetState {
     RESET_GAME = "ResetGame"
 }
 
+export declare enum InteractiveWidgetStatus {
+    /**
+     * Waiting to start the quiz / question
+     */
+    WAITING = "WAITING",
+    IN_PROGRESS = "IN_PROGRESS",
+    IN_BETWEEN_QUESTIONS = "IN_BETWEEN_QUESTIONS",
+    DONE = "DONE"
+}
+
 export declare interface InteractiveWidgetTheme {
     palette: Record<string, string>;
     components: {
@@ -2563,6 +2629,11 @@ export declare interface InteractiveWidgetTheme {
 
 declare type InteractiveWidgetThemeKey = InteractiveWidgetDisplayComponent | `${InteractiveWidgetDisplayComponent.CURRENT_QUESTION}${AnswerStatus}` | 'timeLeftBar';
 
+export declare enum InteractiveWidgetType {
+    POLL = "POLL",
+    QUIZ = "QUIZ"
+}
+
 /**
  * @public
  */
@@ -2589,6 +2660,15 @@ export declare type InternalConfig = SdkReactConfig & {
     forceCloudFnResolver?: boolean;
 };
 
+/**
+ * Subset of `BaseInteractiveWidget` methods that are intentionally **not**
+ * advertised on the SDK hook return types (`useInteractiveWidget`,
+ * `useQuizWidget`, `usePollWidget`). These methods still exist at runtime and
+ * are used by internal `core-react-dom` UI / server flows — they're just hidden
+ * from external SDK consumers, which should only call `submitAnswer`.
+ */
+export declare type InternalInteractiveWidgetMethods = 'answerQuestion' | 'verifyJoinCode' | 'changeState';
+
 /**
  * @public
  */
@@ -2743,7 +2823,7 @@ export declare interface LastMessage {
 export declare interface LeaderboardGroupItem {
     groupPath?: string;
     groupName?: string;
-    type: QuizGameGroupType;
+    type: InteractiveWidgetGroupType;
     /**
      * Consists of top 3 players of the group (global or private team)
      * the player's rank in the group
@@ -3163,6 +3243,16 @@ export declare interface MonetizationCardProps {
     focused?: boolean;
 }
 
+/**
+ * @public
+ */
+export declare type MonetizationCta = {
+    type: 'email';
+    payload: {
+        email: string;
+    };
+};
+
 export declare interface MonetizationsCountsSummaryItem {
     /**
      * Unix timestamp at which the data is aggregated
@@ -4370,6 +4460,22 @@ export declare enum PlayerWrapperEventType {
  */
 export declare type PlayerWrapperEventTypeType = `${PlayerWrapperEventType}`;
 
+export declare type PollQuestion = CurrentQuestion<PollQuestionAnswer>;
+
+export declare interface PollQuestionAnswer extends BaseQuestionAnswer {
+    votes?: number;
+}
+
+/**
+ * A poll-flavored interactive widget. No scoring / leaderboard / countdown — just
+ * "here's a question, here are the vote counts". Uses a narrower state machine.
+ */
+export declare interface PollWidget<TScene extends InteractiveWidgetScene = InteractiveWidgetScene> extends BaseInteractiveWidget<PollQuestionAnswer, PollWidgetState, TScene> {
+    readonly type: InteractiveWidgetType.POLL;
+}
+
+export declare type PollWidgetState = InteractiveWidgetState.IDLE | InteractiveWidgetState.CURRENT_QUESTION | InteractiveWidgetState.LEADERBOARD | InteractiveWidgetState.RESET_GAME | InteractiveWidgetState.NEXT_STATE;
+
 /**
  * @public
  */
@@ -4537,6 +4643,11 @@ export declare interface PubSub {
  * @public
  */
 export declare interface PurchasableMonetization extends Monetization {
+    /**
+     * If CTA is configured, the monetization should not be directly purchasable in clients.
+     * Client apps should render CTA action instead of purchase button.
+     */
+    cta?: MonetizationCta;
     /**
      * Price before any discounts (e.g. promotions).
      */
@@ -5035,13 +5146,7 @@ export declare interface QerkoTransaction {
 
 export declare type QRCodeScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.QR_CODE>;
 
-export declare interface QuestionAnswer {
-    id: string;
-    answer: Translation;
-    isCorrect?: boolean;
-    votes?: number;
-    status?: AnswerStatus;
-}
+export declare type QuestionAnswer = QuizQuestionAnswer | PollQuestionAnswer;
 
 export declare enum QuestionEvents {
     NEW_QUESTION = "new_question",
@@ -5059,7 +5164,7 @@ export declare interface QuestionRepository {
     readonly selectedAnswerId: string | undefined;
     isSubmitted: boolean;
     isSubmitting: boolean;
-    setCurrentQuestion: (question: CurrentQuestion | null, role: QuizGameRole, secondsToAnswer: number, shouldEnterAtTimestampMs?: number, shouldAdjustEndTimestampMs?: boolean) => void;
+    setCurrentQuestion: (question: CurrentQuestion | null, role: InteractiveWidgetRole, secondsToAnswer: number, shouldEnterAtTimestampMs?: number, shouldAdjustEndTimestampMs?: boolean) => void;
     selectAnswer: (answerId: string | undefined) => void;
     setShowCountdown: (showCountdown: boolean) => void;
     reset: () => void;
@@ -5073,41 +5178,28 @@ export declare type QuestionRepositoryEventMap = {
     [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",
-    /** Participants playing in Offline mode */
-    LOCAL_PLAYERS = "LOCAL_PLAYERS",
-    ALL = "ALL",
-    PARTY = "PARTY"
-}
+export declare type QuizQuestion = CurrentQuestion<QuizQuestionAnswer>;
 
-export declare enum QuizGameRole {
-    OBS = "OBS",
-    HOST = "HOST",
-    PLAYER = "PLAYER",
-    LOCAL_PLAYER = "LOCAL_PLAYER"
+export declare interface QuizQuestionAnswer extends BaseQuestionAnswer {
+    isCorrect?: boolean;
+    votes?: number;
 }
 
-export declare enum QuizGameStatus {
-    /**
-     * Waiting to start the quiz / question
-     */
-    WAITING = "WAITING",
-    IN_PROGRESS = "IN_PROGRESS",
-    IN_BETWEEN_QUESTIONS = "IN_BETWEEN_QUESTIONS",
-    DONE = "DONE"
+/**
+ * A quiz-flavored interactive widget. Adds scoring, leaderboard, and countdown
+ * concepts on top of the base, and narrows answers to `QuizQuestionAnswer`.
+ */
+export declare interface QuizWidget<TScene extends InteractiveWidgetScene = InteractiveWidgetScene> extends BaseInteractiveWidget<QuizQuestionAnswer, QuizWidgetState, TScene> {
+    readonly type: InteractiveWidgetType.QUIZ;
+    readonly leaderboard: LeaderboardGroupItem | null;
+    readonly lastQuestionTopScorers: LeaderboardPlayer[];
+    readonly highlightedUsersIds: string[];
+    readonly secondsToAnswer: number;
+    readonly showCountdown: boolean;
+    readonly questionRepository: QuestionRepository;
 }
 
-export declare enum QuizGameType {
-    POLL = "POLL",
-    QUIZ = "QUIZ"
-}
+export declare type QuizWidgetState = InteractiveWidgetState;
 
 /**
  * @public
@@ -5224,6 +5316,11 @@ export declare interface RemoteControlPairPayload {
     profileId: string;
 }
 
+export declare interface RemoteControlPairResponse {
+    sessionId: string;
+    videoId: string;
+}
+
 export declare interface RemoteControlPlaybackControlPayload {
     sessionId: string;
     videoId: string;
@@ -5605,7 +5702,7 @@ declare type SceneMetadata<TType extends InteractiveWidgetSceneTemplateType> = T
 } : TType extends InteractiveWidgetSceneTemplateType.LEADERBOARD ? {
     highlightedPlayers: LeaderboardPlayer[];
     topPlayers: LeaderboardPlayer[];
-    stats?: QuizGameGroupStats;
+    stats?: InteractiveWidgetGroupStats;
 } : 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 {
@@ -5758,6 +5855,13 @@ export declare type SdkReactConfig = Omit<TivioConfig, 'language'> & {
     language?: LangCode;
 };
 
+/**
+ * Narrows away `InternalInteractiveWidgetMethods` from any concrete widget
+ * type. Distributes over discriminated unions so `SDKWidget<InteractiveWidget>`
+ * stays a union of `SDKWidget<QuizWidget> | SDKWidget<PollWidget>`.
+ */
+export declare type SDKWidget<T> = T extends unknown ? Omit<T, InternalInteractiveWidgetMethods> : never;
+
 /**
  * @public
  * @deprecated sections are no longer used.
@@ -6521,14 +6625,6 @@ export declare type SubscribeToTaggedVideosOptions = Omit<SubscribeToItemsInRowO
     orderBy?: OrderBy<TaggedVideosOrderByField>[];
 };
 
-declare interface SubscriptionInfo {
-    id: string;
-    type: 'subscription';
-    name: string;
-    benefits: string[];
-    frequency: string;
-}
-
 /**
  * Extended language codes for subtitle tracks.
  * Includes all LangCode values plus additional languages only needed for subtitles.
@@ -6911,7 +7007,7 @@ export declare interface TivioConfig {
     debug?: boolean;
     verbose?: boolean;
     firebaseApp?: any | null;
-    firebaseFactory?: (config: object, appName?: string) => firebase_2.FirebaseApp;
+    firebaseFactory?: (config: object, appName?: string) => firebase.FirebaseApp;
     authDomainOverride?: string;
     /**
      * @deprecated this field is no longer in use and has no impact when set.
@@ -7040,7 +7136,7 @@ export declare type TivioHooks = {
         data: Video | null;
         error: string | null;
     };
-    useVoucher: (voucherId: string) => any;
+    useVoucher: (voucherId: string) => UseVoucherReturn;
     useApplyInviteCode: () => {
         applyInviteCodeResult?: boolean;
         loading: boolean;
@@ -7050,6 +7146,22 @@ export declare type TivioHooks = {
     };
     useChannelSource: UseChannelSource;
     useTvChannel: UseTvChannel;
+    useInteractiveWidget: (widgetPath: string | undefined, isObs?: boolean) => {
+        widget: SDKWidget<InteractiveWidget> | null;
+        isLoading: boolean;
+        error: Error | null;
+    };
+    useQuizWidget: (widgetPath: string | undefined, isObs?: boolean) => {
+        widget: SDKWidget<QuizWidget> | null;
+        isLoading: boolean;
+        error: Error | null;
+    };
+    usePollWidget: (widgetPath: string | undefined, isObs?: boolean) => {
+        widget: SDKWidget<PollWidget> | null;
+        isLoading: boolean;
+        error: Error | null;
+    };
+    useRemoteController: UseRemoteController;
 };
 
 /**
@@ -7267,7 +7379,7 @@ export declare type TivioReactBundle = {
     }, email?: string) => Promise<QerkoPaymentInfo>;
     purchaseSubscriptionWithQerko: (monetizationId: string, voucher?: {
         expirationDate: Date;
-    }) => Promise<QerkoPaymentInfo>;
+    }, email?: string, quantity?: number) => Promise<QerkoPaymentInfo>;
     cancelSubscriptionWithQerko: (subscriptionId: string) => Promise<QerkoCancellationInfo>;
     showConsentPreferences: () => void;
     /**
@@ -7376,17 +7488,6 @@ export declare interface Track {
     language: LangCode;
 }
 
-declare interface TransactionInfo {
-    id: string;
-    type: 'transaction';
-    name: string;
-    videoId: string;
-    cover: string;
-    description: string;
-    promotions?: firebase_3.firestore.DocumentReference<Promotion>[];
-    fullDiscount?: boolean;
-}
-
 /**
  * Represents one string in every supported language mutation.
  * @public
@@ -7690,6 +7791,18 @@ export declare type UseEpisodesResult = {
     hasMoreEpisodes: boolean;
 };
 
+/**
+ * Load the interactive widget at `widgetPath` via the remote Tivio bundle.
+ * Returns the union widget (`QuizWidget | PollWidget`); narrow
+ * on `widget.type` to access type-specific fields. Prefer `useQuizWidget` /
+ * `usePollWidget` when you know the type up-front.
+ */
+export declare const useInteractiveWidget: (widgetPath: string | undefined, isObs?: boolean) => {
+    widget: SDKWidget<InteractiveWidget> | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+
 /**
  * @public
  */
@@ -7782,6 +7895,12 @@ export declare const useOrganizationSubscriptions: (onlyPurchasableSubscriptions
     subscriptions: PurchasableMonetization[];
 };
 
+export declare const usePollWidget: (widgetPath: string | undefined, isObs?: boolean) => {
+    widget: Omit<PollWidget<InteractiveWidgetScene>, InternalInteractiveWidgetMethods> | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+
 /**
  * Is used to mark purchase in recovery state as PAID.
  *
@@ -7803,6 +7922,12 @@ export declare function usePurchaseRecovery(): {
  */
 export declare const usePurchaseSubscription: (monetizationId: string, voucher?: NewVoucher) => QerkoTransaction;
 
+export declare const useQuizWidget: (widgetPath: string | undefined, isObs?: boolean) => {
+    widget: Omit<QuizWidget<InteractiveWidgetScene>, InternalInteractiveWidgetMethods> | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+
 /**
  * @public
  */
@@ -7944,6 +8069,58 @@ export declare interface UseReactionsOptions {
     onError?: (error: Error) => void;
 }
 
+/**
+ * @public
+ */
+export declare type UseRemoteController = (options?: UseRemoteControllerOptions) => UseRemoteControllerResult;
+
+export declare const useRemoteController: UseRemoteController;
+
+/**
+ * @public
+ */
+export declare interface UseRemoteControllerOptions {
+    sessionId?: string;
+    videoId?: string;
+}
+
+/**
+ * @public
+ */
+export declare type UseRemoteControllerPlaybackControlPayload = Pick<RemoteControlPlaybackControlPayload, 'playback' | 'activeVideoId'> & Partial<Pick<RemoteControlPlaybackControlPayload, 'sessionId' | 'videoId'>>;
+
+/**
+ * @public
+ */
+export declare type UseRemoteControllerPlayHighlightPayload = Pick<RemoteControlPlayHighlightPayload, 'activeVideoId' | 'replay'> & Partial<Pick<RemoteControlPlayHighlightPayload, 'sessionId' | 'videoId'>>;
+
+/**
+ * @public
+ */
+export declare interface UseRemoteControllerResult {
+    session: UserStreamingSessionFieldInterface | null;
+    sessionId: string | null;
+    videoId: string | null;
+    activeContentId: string | null;
+    isInitialized: boolean;
+    isSignedIn: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+    pairDevice: (payload: RemoteControlPairPayload) => Promise<RemoteControlPairResponse>;
+    unpairDevice: (payload?: Partial<RemoteControlUnpairPayload>) => Promise<boolean | string>;
+    selectCamera: (payload: UseRemoteControllerSelectCameraPayload) => Promise<boolean | string>;
+    playHighlight: (payload: UseRemoteControllerPlayHighlightPayload) => Promise<boolean | string>;
+    playbackControl: (payload: UseRemoteControllerPlaybackControlPayload) => Promise<boolean | string>;
+    getSourceUrl: (payload: RemoteControlGetSourceUrlPayload) => Promise<RemoteControlGenerateSourceResponse>;
+    remoteControl: <TResponse = RemoteControlGenerateSourceResponse | boolean | string>(payload: RemoteControlRequest) => Promise<TResponse>;
+}
+
+/**
+ * @public
+ */
+export declare type UseRemoteControllerSelectCameraPayload = Pick<RemoteControlSelectCameraPayload, 'activeVideoId'> & Partial<Pick<RemoteControlSelectCameraPayload, 'sessionId' | 'videoId'>>;
+
 export declare enum UserGroup {
     ALL = "all",
     FREE = "free",
@@ -8159,19 +8336,28 @@ export declare const useVideo: (videoIdOrUrlName?: string) => {
 /**
  * @public
  */
-export declare const useVoucher: (voucherId: string) => {
-    activate: (() => Promise<void>) | null;
-    voucher: Voucher | null;
-    /**
-     * You can check error.details if you need to know error type when you want your own error messages
-     * (can be one of "DOES_NOT_EXIST", "EXPIRED", "ALREADY_USED_BY_CURRENT_USER" and "ALREADY_USED").
-     */
-    error: Error | BadRequestError | null;
-    /**
-     * True if voucher has been successfully activated in current session.
-     */
+export declare const useVoucher: (voucherId: string) => UseVoucherReturn;
+
+/**
+ * Return type of `useVoucher` hook (core-react / sdk-react).
+ *
+ * Activation is triggered via the top-level `activate`. After a successful activation
+ * `voucher` carries the server-provided metadata (`voucherInfo`, `videoId`,
+ * `subscriptionsToShow`) as flat attributes. While the voucher is still initializing,
+ * `voucher` is `null`.
+ */
+export declare interface UseVoucherReturn {
+    activate: () => Promise<void>;
+    voucher: {
+        organizationId: string | null;
+        isInitialized: boolean;
+        voucherInfo: VoucherInfoPublic | null;
+        videoId?: string;
+        subscriptionsToShow: PurchasableMonetization[];
+    } | null;
+    error: Error | null;
     activationSuccess: boolean;
-};
+}
 
 /**
  * @public
@@ -8805,15 +8991,30 @@ export declare interface VodTivioSourceParams extends PlayerSourceParams<SourceT
     sessionId?: string;
 }
 
-/**
- * TODO: Should be in core-js, we can't import types from it, though.
- */
-declare interface Voucher {
-    activate: () => void;
-    isUsed: boolean;
+export declare interface VoucherInfoBasePublic {
+    id: string;
     isExpired: boolean;
-    status: 'NEW' | 'USED';
-    voucherInfo: SubscriptionInfo | TransactionInfo;
+    status: VoucherInfoPublicStatus;
+    fullDiscount?: boolean;
+}
+
+export declare type VoucherInfoPublic = VoucherInfoSubscriptionPublic | VoucherInfoTransactionPublic;
+
+export declare type VoucherInfoPublicStatus = 'NEW' | 'USED' | 'FULFILLED';
+
+export declare interface VoucherInfoSubscriptionPublic extends VoucherInfoBasePublic {
+    type: 'subscription';
+    name: string;
+    benefits: string[];
+    frequency?: MONETIZATION_FREQUENCY;
+}
+
+export declare interface VoucherInfoTransactionPublic extends VoucherInfoBasePublic {
+    type: 'transaction';
+    name: string;
+    videoId: string;
+    cover: string;
+    description: string;
 }
 
 declare interface VoucherPageConfiguration {