@tivio/sdk-react 3.6.3 → 4.0.1

package/dist/sdk-react.d.ts

@@ -37,6 +37,27 @@ export declare interface AdExternal {
     skip: () => void;
 }
 
+/**
+ * @public
+ */
+export declare type AdMetadata = {
+    type: 'ad';
+    subType: 'inserted' | 'original';
+    secondsToEnd: number;
+    /**
+     * null when ad is not skippable
+     */
+    secondsToSkippable: number | null;
+    canTriggerSkip: boolean;
+    isSkippable: boolean;
+    order: number | null;
+    totalCount: number | null;
+    skip: () => void;
+} | null;
+
+/**
+ * @public
+ */
 declare type AdSegment = {
     id: string;
     /**
@@ -95,6 +116,13 @@ export declare type AdSource = {
     secondsToSkippable: number | null;
 };
 
+/**
+ * @public
+ */
+declare type AdSource_2 = SourceBase & {
+    type: 'ad';
+};
+
 /**
  * @public
  */
@@ -106,6 +134,14 @@ export declare enum ALGOLIA_INDEX_NAME {
     USERS = "users"
 }
 
+/**
+ * @public
+ */
+export declare type ArrisDeviceInfo = {
+    type: 'arris';
+    model?: 'VIP1003' | 'VIP1113' | 'VIP5305';
+};
+
 /**
  * @public
  */
@@ -185,11 +221,7 @@ export declare type BannerProps = {
     hoverable: boolean;
     broadcastInfo: string;
     height: number;
-    coverPadding: CoverPadding;
     cover: string;
-    fullWidth: boolean;
-    coverContainerPaddingTop: string;
-    width: number;
     overlay: boolean;
     price: string;
     hasRoundCorners: boolean;
@@ -202,39 +234,6 @@ export declare type BannerProps = {
  */
 export declare type BannerPropsPartial = Partial<BannerProps>;
 
-/**
- * @public
- */
-export declare type BasicTivioBundle = {
-    components: TivioComponents;
-    getters: TivioGetters;
-    auth: TivioAuth;
-    hooks: TivioHooks;
-    sources: TivioSources;
-    subscriptions: TivioSubscriptions;
-    purchaseVideoWithQerko: (videoId: string, monetizationId: string, voucher?: {
-        expirationDate: Date;
-    }) => Promise<QerkoPaymentInfo>;
-    purchaseSubscriptionWithQerko: (monetizationId: string, voucher?: {
-        expirationDate: Date;
-    }) => Promise<QerkoPaymentInfo>;
-    cancelSubscriptionWithQerko: (subscriptionId: string) => Promise<QerkoCancellationInfo>;
-    /**
-     * Set tivio language.
-     * @param language
-     */
-    setLanguage: (language: LangCode) => void;
-    setUser: (userId: string | null, userPayload?: UserPayload) => Promise<void>;
-    showConsentPreferences: () => void;
-    /**
-     * Contains hooks and providers for internal usages.
-     * They used in our apps, e.g. web, or in sdk-react (e.g. some sdk hooks are just wrappers for core-react-dom hooks)
-     * TODO should not be the part of public API
-     */
-    internal: TivioInternalBundle;
-    destroy: () => Promise<void>;
-};
-
 /**
  * @public
  */
@@ -268,7 +267,7 @@ export declare type ButtonOptions = {
 /**
  * @public
  */
-export declare type Callback = () => void;
+export declare type Callback<T = any> = (arg?: T) => void;
 
 /**
  * @public
@@ -281,14 +280,6 @@ export declare interface Channel {
     recentVideos: Video[];
 }
 
-/**
- * @public
- */
-export declare const ChannelsContext: React_2.Context<DataState<Channel>>;
-
-/**
- * @public
- */
 export declare type ChannelSource = {
     new (uri: string, originalOptions: Record<string, any>, channelName: string, programName: string, programDescription: string, from: Date, to: Date): ChannelSource;
     description: string;
@@ -323,6 +314,11 @@ export declare interface ChannelSourcePojo {
  */
 export declare type Chapter = any;
 
+/**
+ * @public
+ */
+export declare type CmpConfig = 'default' | 'debug' | 'none';
+
 /**
  * TODO it's the same as Customizations, not?
  * @internal
@@ -341,16 +337,10 @@ export declare type Components = {
 };
 
 /**
+ * Just another alias. Reexported for backward compatibility.
  * @public
  */
-export declare type Config = Pick<InternalConfig, 'bundleUrlOverride' | 'currency' | 'disableUnmounting' | 'capabilitiesOptions' | 'enable' | 'enableSentry' | 'ErrorComponent' | 'language' | 'LoaderComponent' | 'logger' | 'secret' | 'verbose' | 'forceCloudFnResolver'> & {
-    deviceCapabilities: PlayerCapability[] | 'auto';
-    /**
-     * @private
-     * Run HTML, CSS and JS feature support check
-     */
-    runFeatureSupportCheck?: boolean;
-};
+export declare type Config = SdkReactConfig;
 
 /**
  * @public
@@ -455,7 +445,7 @@ export declare type Customizations = {
  * @internal
  */
 export declare interface CustomTheme {
-    customizations?: Customizations;
+    customizations?: Partial<Customizations>;
     components: Components;
     size: (size: number) => number;
 }
@@ -464,18 +454,11 @@ export declare interface CustomTheme {
  * @internal
  */
 export declare interface CustomThemeOptions {
-    customizations?: Customizations;
+    customizations?: Partial<Customizations>;
     components: Components;
     size: (size: number) => number;
 }
 
-declare interface DataState<T> {
-    data: {
-        [key: string]: HookData<T>;
-    };
-    setData: (key: string, data: HookData<T>) => void;
-}
-
 /**
  * @public
  */
@@ -498,6 +481,11 @@ export declare type DetailedPrice = {
     frequency?: MONETIZATION_FREQUENCY;
 };
 
+/**
+ * @public
+ */
+export declare type DeviceInfo = ArrisDeviceInfo | ReactNativeDeviceInfo;
+
 /**
  * @public
  */
@@ -529,6 +517,11 @@ export declare type DocumentOptions = Partial<{
  */
 export declare type Empty = void | Promise<void> | undefined | Promise<undefined>;
 
+/**
+ * @public
+ */
+declare type Empty_2 = void | Promise<void> | undefined | Promise<undefined>;
+
 /**
  * @public
  */
@@ -571,12 +564,6 @@ export declare interface GenericOnCallError {
  */
 export declare const getPubSub: () => PubSub;
 
-declare interface HookData<T> {
-    data: PaginationData<T> | null;
-    error: Error | null;
-    isLoading: boolean;
-}
-
 /**
  * @public
  */
@@ -651,46 +638,23 @@ export declare type InputSource = AdSource | ChannelSource | VodTivioSource | Vo
 /**
  * @public
  */
-export declare type InternalConfig = {
-    /**
-     * @private URL of remote code bundle to be fetched directly (without using resolver)
-     */
-    bundleUrlOverride?: string;
-    /**
-     * Tells Tivio which technologies/protocols etc. is the device capable to play.
-     * If not provided, Tivio will try to guess it (based on the browser).
-     */
-    deviceCapabilities: PlayerCapability[];
-    /**
-     * Additional options for deviceCapabilities
-     */
-    capabilitiesOptions?: {
-        /**
-         * Should the player prefer HTTP sources instead HTTPs if they are available.
-         * This can be used on platforms that support mixed content but do not support
-         * specific HTTPS certificates. (e.g. certificates from Letsencrypt not supported on LG TVs)
-         */
-        preferHttp?: boolean;
-    };
-    secret: string | null;
-    language?: LangCode;
-    verbose?: boolean;
-    currency: Currency;
-    disableUnmounting?: boolean;
-    enable?: boolean;
-    enableSentry?: boolean;
-    ErrorComponent?: ComponentType<{
-        error: string | null;
-    }>;
+export declare type InternalConfig = SdkReactConfig & {
     fetchPackage: FetchPackage;
-    LoaderComponent?: ComponentType;
-    logger?: Logger | null;
     pubSub: PubSub;
     /**
-     * @private URL of resolver. Resolver is a script used to fetch remove code bundle
+     * @private URL of resolver. Resolver is a script used to fetch remote code bundle
      */
     resolverUrl: string;
     sdkVersion: string;
+    /**
+     * @private URL of remote code bundle to be fetched directly (without using resolver)
+     */
+    bundleUrlOverride?: string;
+    /**
+     * @private
+     * Run HTML, CSS and JS feature support check
+     */
+    runFeatureSupportCheck?: boolean;
     /**
      * @private
      */
@@ -715,6 +679,24 @@ declare interface IntroMarker {
  */
 export declare type ItemsInRow = Tag | Video | TvChannel;
 
+/**
+ * @public
+ */
+export declare interface JojExternals {
+    tvProfiProgramId?: string;
+    tvProfiContentId?: string;
+    tvProfiSerialId?: string;
+    contentId?: string;
+    provysId?: string;
+    tvProfiProvysId?: string;
+    tvProfiHouseId?: string;
+    tvProfiTitleOriginal?: string;
+    tvProfiTitleSk?: string;
+    tvProfiType?: string;
+    tvProfiSeriesName?: string;
+    tvProfiDistributor?: string;
+}
+
 /**
  * Enum of all supported languages codes as in ISO 639-1
  * @public
@@ -749,6 +731,34 @@ export declare type LinkedVideo = {
     type: 'CUT' | 'TRAILER' | 'BONUS' | 'CHILD';
 };
 
+/**
+ * @public
+ */
+export declare type Listener = ListenerAdMetadata | ListenerMarkers;
+
+/**
+ * @public
+ */
+export declare type ListenerAdMetadata = (metadata: AdMetadata) => void;
+
+/**
+ * @public
+ */
+export declare type ListenerMarkers = (marker: Marker[] | null) => void;
+
+/**
+ * Not supported yet, now it does pass-through only.
+ *
+ * @public
+ */
+export declare type LiveTvChannelSource = SourceBase & {
+    type: 'live_tv_channel';
+    /**
+     * Tivio needs channel name in order to load markers.
+     */
+    channelName: string;
+};
+
 declare interface Logger {
     /** important messages */
     warn(...data: LoggerArgs): void;
@@ -771,15 +781,24 @@ declare type LoggerArgs = any[];
 /**
  * @public
  */
-export declare type Marker = {
+export declare interface MallTvExternals {
+    mallTvEntityId: string;
+}
+
+/**
+ * @public
+ */
+export declare interface Marker {
     id: string;
-    type: string;
     from: Date;
     to: Date;
     count?: number;
     fromMs?: number;
     toMs?: number;
-};
+    relativeFromMs: number;
+    relativeToMs: number;
+    type: 'AD' | 'AD_SEGMENT' | 'START' | 'END' | 'INTRO';
+}
 
 /**
  * @public
@@ -835,6 +854,16 @@ export declare type Nullable<T> = {
  */
 export declare type ObjectType = Record<string, any>;
 
+/**
+ * @public
+ */
+export declare interface OktagonExternals {
+    /**
+     * DRM content Key ID - shouldn't be more connected with buyDRM or streamOnline? It is not general thing
+     */
+    keyId?: string;
+}
+
 /**
  * @public
  */
@@ -851,10 +880,14 @@ declare type OrderByDirection = 'desc' | 'asc';
 export declare interface Organization {
 }
 
-declare type PaginationData<T> = {
-    items: T[];
-    hasNextPage: boolean;
-    fetchMore: Function;
+/**
+ * If Tivio PlayerWrapper is an interception layer, it should allow the pass-through
+ * of not just Tivio source types but any other source types that the 3rd party app may be using.
+ *
+ * @public
+ */
+export declare type OtherSource = SourceBase & StartAndContinuePosition & {
+    type: 'other';
 };
 
 /**
@@ -884,6 +917,30 @@ export declare enum PLATFORM {
     TV = "TV"
 }
 
+/**
+ * @public
+ */
+export declare type Player = {
+    ad: any;
+    currentTime: any;
+    adSegment: any;
+    event: any;
+    events: any;
+    source: any;
+    state: any;
+    onPlaybackEnded: any;
+    onSourceChanged: any;
+    onStateChanged: any;
+    onTimeChanged: any;
+    pause: any;
+    play: any;
+    togglePlayPause: any;
+    register: any;
+    seekTo: any;
+    setVolume: any;
+    triggerEvent: any;
+};
+
 /**
  * @public
  */
@@ -893,6 +950,65 @@ export declare interface PlayerCapability {
     protocol: 'dash' | 'hls' | 'mp4';
 }
 
+/**
+ * @public
+ */
+export declare type PlayerConfig = {
+    /**
+     * Some devices do not seek exactly
+     *
+     * e.g. on Arris if we request seek to position P, in reality it will seek to P -+5s
+     * e.g. on Arris if we request play from position P, in reality it will play from P -+5s
+     * (on Arris the error margin varies according to video format)
+     */
+    acceptablePositionAnomalyMs?: number;
+    /**
+     * Stream delay config
+     *
+     * IP TV apps have TV program / TV channel streams delayed relative to the original
+     * video source. Therefore stream markers taken from the original video source
+     * are delayed relative to the TV stream seen by end users of the IP TV app.
+     *
+     * This delay must be corrected.
+     */
+    streamDelayConfig?: {
+        /**
+         * ID of the delay config
+         */
+        id: string;
+    };
+    ui?: {
+        /**
+         * ID of a DOM element inside which Tivio should display its player-related UI
+         * such as ad buttons. This DOM element is an anchor point for Tivio UI. Preferably
+         * it should be a <div/> element styled to cover the whole area of the video player
+         * and it should be positioned to be on top the existing player UI (e.g. via z-index).
+         */
+        domAnchorId: string | null;
+    };
+    protocols?: {
+        mp4?: {
+            /**
+             * Set to false if player does not support MP4 files that require full file download
+             * (i.e. they do not support progressive MP4 download and therefore the whole file
+             * must be downloaded before playback can start)
+             */
+            fullFileDownloadSupport?: boolean;
+        };
+    };
+    /**
+     * Ad service settings
+     */
+    adService?: {
+        /**
+         * Tivio - can be used in websites and TV apps. Does not support VPAID
+         * IMA - can be used only in websites. Supports VAST 2, partially VAST 3, VAST 4, SIMID 1.0, OM SDK 1.3,
+         *   VPAID 2 (HTML5) https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/compatibility
+         */
+        name: 'IMA SDK' | 'Tivio';
+    };
+};
+
 /**
  * @public
  */
@@ -925,6 +1041,18 @@ export declare interface PlayerInterface {
     unmute?: () => void;
 }
 
+/**
+ * @public
+ */
+export declare interface PlayerInterfaceForPlayerWrapper {
+    /**
+     * @param {number} ms - milliseconds relative to start of video (relative to 0 ms)
+     *  or in case of TV programs relative to start of the program (relative to source.from ms)
+     */
+    seekTo: (ms: number) => void;
+    setSource: (source: Source | null) => void;
+}
+
 /**
  * @public
  */
@@ -982,8 +1110,8 @@ export declare type PlayerWrapper = {
     source: InputSource | null;
     events: {
         isSupported: (even: string) => boolean;
-        addListener: <T = any>(event: string, cb: (value: T) => Empty) => void;
-        removeListener: <T = any>(event: string, cb: (value: T) => Empty) => void;
+        addListener: <T = any>(event: string, cb: (value: T) => Empty_2) => void;
+        removeListener: <T = any>(event: string, cb: (value: T) => Empty_2) => void;
         removeAllListeners: () => void;
     };
     /**
@@ -1021,6 +1149,19 @@ export declare type PlayerWrapper = {
     toggleMuted: () => void;
 };
 
+/**
+ * @public
+ */
+export declare enum PlayerWrapperEventType {
+    adMetadata = "adMetadata",
+    markers = "markers"
+}
+
+/**
+ * @public
+ */
+export declare type PlayerWrapperEventTypeType = `${PlayerWrapperEventType}`;
+
 /**
  * @public
  */
@@ -1033,18 +1174,30 @@ export declare interface PubSub {
  * @public
  */
 export declare type Purchase = {
+    /**
+     * Timestamp of the purchase creation in milliseconds.
+     */
+    created: number | null;
+    expirationDate: Date | null;
     id: string;
+    isExpired: boolean;
+    /**
+     * @deprecated isPurchased is ambiguous name. Now it means that purchase.status is "PAID".
+     * So use purchase.status === PurchaseStatus.PAID instead.
+     */
     isPurchased: boolean;
-    monetizationRef: any | null;
     monetization: PurchaseMonetization | null;
     monetizationId: string | null;
-    type: MonetizationType | null;
-    videoId: string | null;
+    monetizationRef: any | null;
     status: PurchaseStatus | null;
+    type: PurchaseType | null;
+    /**
+     * Timestamp of the last purchase status update in milliseconds.
+     */
+    updated: number | null;
     video: Video | null;
+    videoId: string | null;
     videoRef: any | null;
-    expirationDate: Date | null;
-    isExpired: boolean;
     voucherId?: string;
 };
 
@@ -1055,7 +1208,10 @@ export declare type PurchaseMonetization = {
     currency?: Currency;
     period?: number;
     price?: number;
-    type: MonetizationType;
+    /**
+     * Here are only transaction and subscription, because purchasing of advertisement monetization doesn't make sense.
+     */
+    type: 'transaction' | 'subscription';
     title?: string;
     frequency?: MONETIZATION_FREQUENCY | null;
     /**
@@ -1076,9 +1232,16 @@ export declare enum PurchaseStatus {
     /**
      * Used when purchase is terminated due to terms and conditions violation (e.g. restreaming).
      */
-    KILL = "KILL"
+    BLOCKED = "BLOCKED"
 }
 
+/**
+ * Purchase is a purchase of one video (transaction type), purchase of subscription or voucher.
+ *
+ * @public
+ */
+export declare type PurchaseType = 'transaction' | 'subscription' | 'voucher';
+
 /**
  * @public
  */
@@ -1092,7 +1255,7 @@ export declare interface QerkoCancellationInfo {
  */
 export declare interface QerkoData {
     monetization: Monetization;
-    video?: Video;
+    item?: Video | TvChannel;
     onPurchase?: () => void;
     onClose?: () => void;
 }
@@ -1148,10 +1311,22 @@ export declare interface QerkoTransaction {
 /**
  * @public
  */
-export declare type RemoteBundleState = {
+export declare type ReactNativeDeviceInfo = {
+    type: 'react-native';
+    /**
+     * Type values defined according to {@link OperatingSystem} from `detect-browser` package for convenience.
+     */
+    os?: 'iOS' | 'Android OS';
+    osVersion: string;
+    platform: PLATFORM;
+};
+
+/**
+ * @public
+ */
+export declare type RemoteBundleState = {
     config: InternalConfig;
     error: string | null;
-    settings: Settings;
     state: 'loading' | 'error' | 'ready';
 } & Nullable<TivioBundle>;
 
@@ -1160,7 +1335,7 @@ export declare type RemoteBundleState = {
  */
 export declare type RemoteProviderProps = {
     disableUnmounting?: boolean;
-    language?: string;
+    language?: LangCode;
     children: any;
 };
 
@@ -1234,6 +1409,7 @@ export declare interface RowItemAssets {
     portrait?: string | null;
     circled?: string | null;
     banner?: string | null;
+    bannerMobile?: string | null;
 }
 
 /**
@@ -1315,6 +1491,27 @@ export declare type ScreenRowType = 'filter' | 'custom' | 'continueToWatch' | 'f
  */
 export declare type ScreenSubscription = (screenId: string, cb: (error: Error | null, data: Screen_2 | null) => void) => Disposer_2;
 
+/**
+ * Config of sdk-react. Contains all properties that can be passed via TivioProvider.
+ * Consists of TivioConfig's properties + "sdk only" properties, that are used only in sdk, not in bundle.
+ *
+ * @public
+ */
+export declare type SdkReactConfig = Omit<TivioConfig, 'language'> & {
+    disableUnmounting?: boolean;
+    enable?: boolean;
+    enableSentry?: boolean;
+    ErrorComponent?: ComponentType<{
+        error: string | null;
+    }>;
+    LoaderComponent?: ComponentType;
+    logger?: Logger | null;
+    /**
+     * language is required for bundle init (TivioConfig), but it can be set to default EN on SDK side, so here it's optional.
+     */
+    language?: LangCode;
+};
+
 /**
  * @public
  */
@@ -1325,21 +1522,6 @@ export declare interface Section {
     videos: Video[];
 }
 
-/**
- * @public
- */
-export declare const SectionsContext: React_2.Context<DataState<Section>>;
-
-/**
- * @public
- */
-export declare type Settings = {
-    /**
-     * @deprecated TIV-994 in favour of setUser from libs/sdk-react/src/services/login.ts
-     */
-    setUser: (userId: string, userPayload: unknown) => Promise<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.
@@ -1365,6 +1547,63 @@ export declare const setUser: (userId: string | null, payload?: UserPayload | un
  */
 export declare const showGdprConsentPreferences: () => Promise<void>;
 
+/**
+ * @public
+ */
+export declare type Source = TvProgramSource | TivioVodSource | AdSource_2 | OtherSource | LiveTvChannelSource;
+
+/**
+ * @public
+ */
+export declare type SourceBase = {
+    /**
+     * Tivio SDK users may use pretty complicated source objects in their existing code and if Tivio player
+     * is an interception layer, it should allow them to pass through any type of object.
+     */
+    additionalPayload?: Record<string, any>;
+    /**
+     * Source type.
+     */
+    type: 'ad' | 'live_tv_channel' | 'other' | 'tivio_vod' | 'tv_program';
+    /**
+     * URI to play.
+     */
+    uri: string;
+};
+
+/**
+ * @public
+ */
+export declare type StartAndContinuePosition = {
+    /**
+     * Relative from stream start, in ms.
+     *
+     * On input to Tivio either `startFromPosition` or `continueFromPosition` must always be provided.
+     *
+     * On output from Tivio it is always defined. Tivio can change this value.
+     * (e.g. in order to fix start position of a TV program)
+     */
+    startFromPosition?: number;
+    /**
+     * Relative from stream start, in ms.
+     *
+     * On input to Tivio either `startFromPosition` or `continueFromPosition` must always be provided.
+     *
+     * If provided, tivio will not correct it and will send this value back in startFromPosition.
+     * If provided, startFromPosition is ignored.
+     */
+    continueFromPosition?: number;
+};
+
+/**
+ * @public
+ */
+declare interface StorageManager_2 {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+}
+export { StorageManager_2 as StorageManager }
+
 /**
  * @public
  */
@@ -1476,6 +1715,9 @@ export declare type TileOptions = {
         opacity: string | number;
         fontWeight: string;
     };
+    sizes: {
+        [variant in TileSizeVariant]: TileSizesMap;
+    };
 };
 
 /**
@@ -1483,7 +1725,6 @@ export declare type TileOptions = {
  */
 export declare type TileProps = {
     cover: string;
-    isLoading: boolean;
     bottomLabel: string;
     bottomLabelAreaHeight: number;
     innerLabel: string;
@@ -1492,7 +1733,6 @@ export declare type TileProps = {
     focused: boolean;
     onClick?: () => void;
     hoverable: boolean;
-    overlay: boolean;
     coverPadding: CoverPadding;
     variant: RowItemComponent;
     coverWidth: number;
@@ -1512,14 +1752,38 @@ export declare type TileProps = {
  */
 export declare type TilePropsPartial = Partial<TileProps>;
 
+/**
+ * @internal
+ */
+export declare type TileSizes = {
+    coverPaddingTop: number;
+    coverPaddingBottom: number;
+    coverWidth: number;
+    coverHeight: number;
+    cellPaddingRight: number;
+    labelHeight: number;
+};
+
+/**
+ * Tile sizes by Tile variant (row item component)
+ *
+ * @internal
+ */
+export declare type TileSizesMap = {
+    [item in RowItemComponent]: TileSizes;
+};
+
+/**
+ * Default (desktop) or mobile variants are used for WEB.
+ *
+ * @internal
+ */
+export declare type TileSizeVariant = 'default' | 'mobile';
+
 /**
  * @public
  */
 export declare interface TivioAuth {
-    changePassword: (newPassword: string) => Promise<void>;
-    changeUserPhoto(file: any): Promise<void>;
-    removeUserPhoto(): Promise<void>;
-    getPurchasedVodsWithInitializedVideos: () => Promise<Purchase[]>;
     /**
      * @param email
      * @param password
@@ -1531,21 +1795,17 @@ export declare interface TivioAuth {
      * @param password
      */
     signInWithEmailAndPassword: (email: string, password: string) => Promise<string | null>;
-    initializeUser: () => Promise<void>;
     signOut: () => Promise<void>;
     /**
      * Used for reset forgotten password by user
      */
     resetPassword: (email: string) => Promise<void>;
-    createFreePurchase: (monetizationId: string) => Promise<void>;
 }
 
 /**
  * @public
  */
-export declare type TivioBundle = BasicTivioBundle & {
-    init: (config: Config) => void | Promise<void>;
-};
+export declare type TivioBundle = TivioReactBundle;
 
 /**
  * @public
@@ -1561,10 +1821,6 @@ export declare type TivioComponents = {
     Markers: React_2.ReactNode;
     PlayerDataContext: React_2.ReactNode;
     Provider: React_2.ComponentType<RemoteProviderProps>;
-    /**
-     * @deprecated will be removed in in @tivio/sdk-react@4
-     */
-    VideoAdBanner: React_2.ReactNode;
     WebPlayer: React_2.ComponentType<WebPlayerProps>;
     Widget: React_2.ComponentType<TivioWidgetProps>;
     PlayerDataContextProvider: React_2.ComponentType<{
@@ -1593,12 +1849,46 @@ export declare type TivioComponents = {
     WebTile: React_2.ComponentType<{
         item?: ItemsInRow;
     } & TilePropsPartial>;
-    AdIndicationButtonWeb: React_2.ReactNode;
-    Recommendation: React_2.ReactNode;
-    SkipButtonWeb: React_2.ReactNode;
-    TvPlayer: React_2.ComponentType<WebPlayerProps>;
 };
 
+/**
+ * @public
+ */
+export declare interface TivioConfig {
+    /**
+     * Tells Tivio which technologies/protocols etc. is the device capable to play.
+     * If not provided, Tivio will try to guess it (based on the browser).
+     */
+    deviceCapabilities?: PlayerCapability[];
+    /**
+     * Additional options for deviceCapabilities
+     */
+    capabilitiesOptions?: {
+        /**
+         * Should the player prefer HTTP sources instead HTTPs if they are available.
+         * This can be used on platforms that support mixed content but do not support
+         * specific HTTPS certificates. (e.g. certificates from Letsencrypt not supported on LG TVs)
+         */
+        preferHttp?: boolean;
+    };
+    secret: string;
+    language: LangCode;
+    debug?: boolean;
+    verbose?: boolean;
+    firebaseApp?: any;
+    currency: Currency;
+    /**
+     * Configuration for GDPR consent collection (CMP)
+     */
+    cmp?: CmpConfig;
+    /**
+     * Device information - model, os, version, etc. This is useful for devices
+     * where this information cannot be reliably auto-detected.
+     */
+    deviceInfo?: DeviceInfo;
+    player?: PlayerConfig;
+}
+
 /**
  * @public
  */
@@ -1610,18 +1900,6 @@ export declare const TivioContext: React_2.Context<RemoteBundleState | null>;
 export declare type TivioGetters = {
     isTivioLoaded: (cb: (isLoaded: boolean) => void) => void;
     isSignedIn: () => boolean;
-    /**
-     * @deprecated is here only for backward compatibility
-     */
-    getExportedConfig: () => Promise<{
-        showMarkers: true;
-    }>;
-    /**
-     * Get channel by its id.
-     * @param channelId - channel id
-     * @returns {Promise<Channel | null>} channel or null if channel does not exists
-     */
-    getChannelById: (channelId: string) => Promise<Channel | null>;
     /**
      * Get (or create) player wrapper instance
      * @param opt - player getter options
@@ -1629,26 +1907,14 @@ export declare type TivioGetters = {
      */
     getPlayerWrapper: (opt: {
         playerWrapperId?: string;
-    }) => any;
+    }) => PlayerWrapper;
     getOrganizationSubscriptions: () => Promise<Monetization[] | undefined>;
-    /**
-     * Get section by its id.
-     * @param sectionId - section id
-     * @returns {Promise<{section: Section, channel: Channel} | null>} section and channel or null if channel or section does not exists
-     */
-    getSectionById: (sectionId: string) => Promise<Section | 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 widget by its id.
-     * @param widgetId - widget id
-     * @returns {Promise<Widget | null>} widget or null if widget does not exists
-     */
-    getWidgetById: (widgetId: string) => Promise<Widget | null>;
     /**
      * Get player capabilities based on user's browser and OS as resolved by Tivio.
      * @returns PlayerCapability[]
@@ -1660,7 +1926,7 @@ export declare type TivioGetters = {
  * @public
  */
 export declare type TivioHooks = {
-    useAd: () => [(AdSource | null)];
+    useAd: () => [(AdExternal | null)];
     useAdSegment: () => AdSegment | null;
     useCancelSubscription: UseCancelSubscription;
     useItemsInRow: (rowId: string, options: PaginationOptions) => {
@@ -1689,10 +1955,6 @@ export declare type TivioHooks = {
         error: string | null;
     };
     useVoucher: (voucherId: string) => any;
-    /**
-     * @deprecated will be removed in version
-     */
-    useLastVideoByWidgetId: (widgetId: string) => Video | null;
     useWatchWithoutAdsOffer: () => {
         canPurchaseWatchWithoutAds: boolean;
         showPurchaseDialog: () => void;
@@ -1775,6 +2037,59 @@ export declare type TivioInternalProviders = {
     RouterOverridesContextProvider: React_2.ComponentType<RouterOverridesContextState>;
 };
 
+/**
+ * @internal
+ */
+export declare type TivioJsBundle = TivioJsBundleExposedApi & {
+    init: (config: TivioConfig) => void | Promise<void>;
+    tivio: any;
+};
+
+/**
+ * @public
+ */
+export declare type TivioJsBundleExposedApi = {
+    AdSource: any;
+    ChannelSource: any;
+    VodTivioSource: any;
+    /**
+     * Get (or create) player wrapper instance
+     * @param id - player wrapper id
+     * @returns {Player} player wrapper instance
+     */
+    getPlayer: (id: string) => Player;
+    /**
+     * Get tv channel by its id.
+     * @param tvChannelId - tv channel id
+     * @returns {Promise<TvChannel | null>} channel or null if tv channel does not exists
+     */
+    getTvChannelById: (tvChannelId: string) => Promise<TvChannel | null>;
+    /**
+     * Get tag by its id.
+     * @param tagId - tag id
+     * @returns {Promise<Tag | null>} widget or null if tag does not exists
+     */
+    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'>;
+
+/**
+ * @public
+ */
+export declare interface TivioPlayerWrapper {
+    addEventListener: (eventType: PlayerWrapperEventTypeType, listener: Listener) => void;
+    reportError: (error: Error) => void;
+    reportPlaybackEnded: () => void;
+    reportTimeProgress: (ms: number) => void;
+    seekTo: (ms: number) => void;
+    /**
+     * @param {Source} source - source to set
+     * @param {string} calibrationId - id of calibration profile
+     */
+    setSource: (source: Source | null, calibrationId?: string) => void;
+}
+
 /**
  * @public
  */
@@ -1787,10 +2102,52 @@ export declare type TivioProviderProps = {
     /**
      * This prop must be set only once and not change value afterwards
      */
-    conf: Config | undefined | null;
+    conf: SdkReactConfig | undefined | null;
     children: React_2.ReactNode;
 };
 
+/**
+ * @public
+ */
+export declare type TivioReactBundle = {
+    init: (config: TivioConfig) => void | Promise<void>;
+    components: TivioComponents;
+    getters: TivioGetters;
+    auth: TivioAuth;
+    hooks: TivioHooks;
+    sources: TivioSources;
+    subscriptions: TivioSubscriptions;
+    purchaseVideoWithQerko: (videoId: string, monetizationId: string, voucher?: {
+        expirationDate: Date;
+    }) => Promise<QerkoPaymentInfo>;
+    purchaseSubscriptionWithQerko: (monetizationId: string, voucher?: {
+        expirationDate: Date;
+    }) => Promise<QerkoPaymentInfo>;
+    cancelSubscriptionWithQerko: (subscriptionId: string) => Promise<QerkoCancellationInfo>;
+    showConsentPreferences: () => void;
+    /**
+     * Contains hooks and providers for internal usages.
+     * They used in our apps, e.g. web, or in sdk-react (e.g. some sdk hooks are just wrappers for core-react-dom hooks)
+     * TODO should not be the part of public API
+     */
+    internal: TivioInternalBundle;
+    destroy: () => Promise<void>;
+} & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
+
+/**
+ * @public
+ */
+export declare type TivioSetters = {
+    setBundleVersion: (bundleVersion: string | null) => void;
+    /**
+     * Set tivio language.
+     * @param language
+     */
+    setLanguage: (language: LangCode) => void;
+    setStorageManager: (storageManager: StorageManager_2) => void;
+    setUser: (userId: string | null, userPayload?: UserPayload) => Promise<void>;
+};
+
 /**
  * @public
  */
@@ -1806,61 +2163,12 @@ export declare type TivioSources = {
  */
 export declare type TivioSubscriptions = {
     subscribeToUser: (cb: (error: string | null, user: User | null) => void) => void;
-    /**
-     * Listen to widget changes.
-     * @param widgetId - widget id
-     * @param cb - callback on widget updates or on error
-     */
-    subscribeToWidget: (widgetId: string, cb: (error: Error | null, data: Widget | null, disposer?: Disposer_2) => void) => void;
-    /**
-     * Listen to channel changes.
-     * @param channelId - channel id
-     * @param cb - callback on channel updates or on error
-     */
-    subscribeToChannel: (channelId: string, cb: (error: Error | null, data: Channel | null) => void) => void;
-    /**
-     * Listen to section changes.
-     * @param sectionId - section id
-     * @param cb - callback on section updates or on error
-     */
-    subscribeToSection: (sectionId: string, cb: (error: Error | null, data: Section | null) => void) => void;
     /**
      * Listen to video changes.
      * @param videoId - video id
      * @param cb - callback on video updates or on error
      */
     subscribeToVideo: (videoId: string, cb: (error: Error | null, data: Video | null, disposer?: Disposer_2) => void) => void;
-    /**
-     * Listen to videos in section changes.
-     * @param sectionId - section id
-     * @param cb - callback on videos change or error
-     * @param limit - videos count
-     */
-    subscribeToVideosInSection: (sectionId: string, cb: (error: null | Error, data: null | {
-        videos: Video[];
-        hasNextPage: boolean;
-    }, fetchMore: null | ((count?: number) => void), isLoading: boolean) => void, limit?: number) => void;
-    /**
-     * Listen to section in channel changes
-     * @param channelId - channel id
-     * @param cb - callback on sections change or error
-     * @param limit - sections count
-     */
-    subscribeToSectionsInChannel: (channelId: string, cb: (error: null | Error, data: null | {
-        sections: Section[];
-        hasNextPage: boolean;
-    }, fetchMore: null | ((count?: number) => void), isLoading: boolean) => void, limit?: number) => void;
-    /**
-     * Listen to channels in widget changes
-     * @param widgetId - widget id
-     * @param cb - callback on channels change or error
-     * @param limit - channels count
-     */
-    subscribeToChannelsInWidget: (widgetId: string, cb: (error: null | Error, data: null | {
-        channels: Channel[];
-        hasNextPage: boolean;
-    }, fetchMore: null | ((count?: number) => void), isLoading: boolean) => void, limit?: number) => void;
-    subscribeToScreen: SubscribeToScreen;
     subscribeToItemsInRow: SubscribeToItemsInRow;
     subscribeToRowsInScreen: SubscribeToRowsInScreen;
     subscribeToTaggedVideos: SubscribeToTaggedVideos;
@@ -1870,6 +2178,17 @@ export declare type TivioSubscriptions = {
     }) => void;
 };
 
+/**
+ * @public
+ */
+export declare type TivioVodSource = SourceBase & StartAndContinuePosition & {
+    type: 'tivio_vod';
+    /**
+     * Allows Tivio to load monetization config an apply ads.
+     */
+    videoPath: string;
+};
+
 /**
  * @public
  */
@@ -1959,6 +2278,35 @@ export declare interface TvChannel extends RowItem {
     price: number;
 }
 
+/**
+ * @public
+ */
+export declare type TvProgramSource = SourceBase & StartAndContinuePosition & {
+    type: 'tv_program';
+    /**
+     * If epgTo is wrong, Tivio cannot correctly guess if the video it startover or timeshift . For such cases
+     * Tivio needs explicit tv mode.
+     * null if source begins in the future.
+     */
+    tvMode: 'startover' | 'timeshift' | null;
+    /**
+     * Tivio needs channel name in order to load markers.
+     */
+    channelName: string;
+    /**
+     * Tivio needs EPG from in order to load markers.
+     */
+    epgFrom: Date;
+    /**
+     * Tivio needs EPG to in order to load markers.
+     */
+    epgTo: Date;
+    /**
+     * When the stream (provided in uri) really starts - typically few minutes before epgFrom.
+     */
+    streamStart: Date;
+};
+
 /**
  * @public
  */
@@ -1967,7 +2315,7 @@ export declare const TvTivioProvider: React_2.FC<TivioProviderProps>;
 /**
  * @public
  */
-export declare const useAd: () => AdSource | null;
+export declare const useAd: () => AdExternal | null;
 
 /**
  * @public
@@ -2021,28 +2369,6 @@ export declare type UseCancelSubscription = (subscriptionId: string) => {
  */
 export declare const useCancelSubscription: UseCancelSubscription;
 
-/**
- * Use channel
- * @param channelId - channel id
- * @public
- */
-export declare const useChannel: (channelId: string) => {
-    error: string | null;
-    data: Channel | null;
-};
-
-/**
- * Use channels in widget
- * @param widgetId - widget id
- * @param [limit] - channels count, defaults to 10
- * @public
- */
-export declare const useChannelsInWidget: (widgetId: string, limit?: number) => {
-    error: Error | null;
-    data: PaginationData<Channel> | null;
-    isLoading: boolean;
-};
-
 /**
  * @public
  */
@@ -2056,13 +2382,6 @@ export declare type UseChannelSource = (tvChannelId: string) => {
  */
 export declare const useCurrentMarker: () => Marker | null;
 
-/**
- * @public
- */
-export declare const useFreePurchase: () => {
-    purchase: (monetizationId: string) => Promise<void>;
-};
-
 /**
  * @public
  */
@@ -2093,12 +2412,6 @@ export declare const useItemsInRow: (rowId: string, options?: SubscribeToItemsIn
     error: Error | null;
 };
 
-/**
- * @deprecated will be removed in v4
- * @public
- */
-export declare function useLastVideoByWidgetId(widgetId: string): Video | null;
-
 /**
  * @public
  */
@@ -2154,9 +2467,23 @@ export declare const usePurchasesWithVideos: () => {
  * @public
  */
 export declare type User = {
+    /**
+     * Returns "active" (non-expired) purchases, so they give access to some content.
+     * Does not return voucher purchases, because they give access to videos/subscriptions only for user who activates voucher,
+     * not for user who purchases it.
+     */
     purchases: Purchase[];
+    /**
+     * Returns all PAID or CANCELLED user purchases (expired and non-expired)
+     */
     allPurchases: Purchase[];
+    /**
+     * Returns "active" (not CANCELLED) VoD purchases ("transaction" type)
+     */
     purchasedVods: Purchase[];
+    /**
+     * Returns "active" (non-expired) subscription purchases
+     */
     purchasedSubscriptions: Purchase[];
     isPurchasesInitialized: boolean;
     isSignedIn: boolean;
@@ -2190,16 +2517,6 @@ export declare enum UserType {
     TIVIO_USER = "TIVIO_USER"
 }
 
-/**
- * @deprecated
- *
- * Use app screen
- * @param screenId - screen ID
- * @param options - subscribe to screen options
- * @public
- */
-export declare const useScreen: (screenId: string, options?: ScreenOptions | undefined) => never;
-
 /**
  * @public
  */
@@ -2231,28 +2548,6 @@ export declare type UseSearchOptions = PaginationOptions & Partial<{
  */
 export declare type UseSearchResult<T extends ALGOLIA_INDEX_NAME> = T extends ALGOLIA_INDEX_NAME.VIDEOS ? Video : T extends ALGOLIA_INDEX_NAME.TAGS ? Tag : T extends ALGOLIA_INDEX_NAME.TV_CHANNELS ? TvChannel : unknown;
 
-/**
- * Use section
- * @param sectionId - section id
- * @public
- */
-export declare const useSection: (sectionId: string) => {
-    error: string | null;
-    data: Section | null;
-};
-
-/**
- * Use section in channel
- * @param channelId - channel id
- * @param [limit] - sections count, defaults to 10
- * @public
- */
-export declare const useSectionsInChannel: (channelId: string, limit?: number) => {
-    error: Error | null;
-    data: PaginationData<Section> | null;
-    isLoading: boolean;
-};
-
 /**
  * @public
  */
@@ -2312,18 +2607,6 @@ export declare const useVideo: (videoId?: string | undefined) => {
     error: string | null;
 };
 
-/**
- * Use videos in section
- * @param sectionId - section id
- * @param [limit] - videos count, defaults to 10
- * @public
- */
-export declare const useVideosInSection: (sectionId?: string | undefined, limit?: number) => {
-    error: Error | null;
-    data: PaginationData<Video> | null;
-    isLoading: boolean;
-};
-
 /**
  * @public
  */
@@ -2349,16 +2632,6 @@ export declare const useWatchWithoutAdsOffer: () => {
     showPurchaseDialog: () => void;
 };
 
-/**
- * Use widget
- * @param widgetId - widget id
- * @public
- */
-export declare const useWidget: (widgetId: string) => {
-    error: string;
-    widget: Widget | null;
-};
-
 /**
  * @public
  */
@@ -2387,7 +2660,8 @@ export declare enum VastProvider {
     MALL_TV = "malltv",
     MALL_TV_PREBID = "malltv-prebid",
     PRIMA = "prima",
-    TEST = "test"
+    TEST = "test",
+    TEST_VPAID = "test-vpaid"
 }
 
 /**
@@ -2469,26 +2743,10 @@ export declare enum VideoContentType {
 /**
  * @public
  */
-export declare interface VideoExternals {
-    tvProfiProgramId?: string;
-    tvProfiContentId?: string;
-    tvProfiSerialId?: string;
-    contentId?: string;
-    provysId?: string;
-    mallTvEntityId?: string;
-    /**
-     * DRM content Key ID - should't be more connected with buyDRM or streamOnline? It is not general thing
-     */
-    keyId?: string;
-}
+export declare type VideoExternals = JojExternals | MallTvExternals | OktagonExternals;
 
 declare type VideoPath = string;
 
-/**
- * @public
- */
-export declare const VideosContext: React_2.Context<DataState<Video>>;
-
 /**
  * Video type.
  * @public
@@ -2502,7 +2760,11 @@ export declare enum VideoType {
      * Video is a standard single video.
      */
     VIDEO = "VIDEO",
-    TV_PROGRAM = "TV_PROGRAM"
+    TV_PROGRAM = "TV_PROGRAM",
+    /**
+     * Video object represents whole series, e.g. tv show.
+     */
+    SERIES = "SERIES"
 }
 
 /**