@tivio/sdk-react 9.6.0 → 9.7.0

package/README.md

@@ -1013,6 +1013,22 @@ videoController.addEventListener('ad-started', (adMetadata: AdMetadata | null) =
 videoController.addEventListener('ad-ended', () => {
     console.log('Ad finished playing')
 })
+
+// Companion ads event - fires when companion ads are available for the current ad
+videoController.addEventListener('companion-ads', (companionAds) => {
+    console.log('Companion ads available:', companionAds)
+    
+    // Access companion ad properties using IMA methods
+    companionAds.forEach((companionAd, index) => {
+        console.log(`Companion Ad ${index + 1}:`, {
+            width: companionAd.getWidth(),
+            height: companionAd.getHeight(),
+            contentType: companionAd.getContentType(),
+            // HTML content as string
+            content: companionAd.getContent()
+        })
+    })
+})
 ```
 
 > ℹ️ **_Note:_** The CTA overlay element is visible in the WebPlayer only while an ad is playing and is automatically cleaned up on source changes.

package/README.md.bak

@@ -1013,6 +1013,22 @@ videoController.addEventListener('ad-started', (adMetadata: AdMetadata | null) =
 videoController.addEventListener('ad-ended', () => {
     console.log('Ad finished playing')
 })
+
+// Companion ads event - fires when companion ads are available for the current ad
+videoController.addEventListener('companion-ads', (companionAds) => {
+    console.log('Companion ads available:', companionAds)
+    
+    // Access companion ad properties using IMA methods
+    companionAds.forEach((companionAd, index) => {
+        console.log(`Companion Ad ${index + 1}:`, {
+            width: companionAd.getWidth(),
+            height: companionAd.getHeight(),
+            contentType: companionAd.getContentType(),
+            // HTML content as string
+            content: companionAd.getContent()
+        })
+    })
+})
 ```
 
 > ℹ️ **_Note:_** The CTA overlay element is visible in the WebPlayer only while an ad is playing and is automatically cleaned up on source changes.

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import type { default as firebase_2 } from '@firebase/app-types';
 import type { default as firebase_3 } from 'firebase';
 import { FunctionComponentElement } from 'react';
 import type { GeoPoint } from '@firebase/firestore-types';
+import type { google } from '@alugha/ima';
 import { OperatingSystem } from 'detect-browser';
 import type { PaletteType } from '@material-ui/core';
 import { default as React_2 } from 'react';
@@ -429,6 +430,8 @@ export declare interface Article extends RowItem, MonetizableItem, ReactableCont
     detailBanner?: string;
     episodeNumber?: number;
     seasonNumber?: number;
+    urlNames?: string[];
+    urlName?: string;
 }
 
 /**
@@ -440,10 +443,13 @@ export declare interface ArticleBlock {
     type: ArticleBlockType;
     htmlContent?: string;
     imageUrl?: string;
+    imageUrlOriginal?: string;
+    imageUrlContain?: string;
     textContent?: string;
     videoId?: string;
     isOverflowImage?: boolean;
     imageDescription?: string;
+    use16By9Container?: boolean;
 }
 
 export declare interface ArticleBlockField extends Omit<ArticleBlock, 'textContent' | 'htmlContent'> {
@@ -462,6 +468,7 @@ export declare type ArticleBlockType = 'PARAGRAPH' | 'IMAGE' | 'VIDEO' | 'HEADIN
  */
 declare interface ArticleDocumentSerialized {
     type: 'ARTICLE';
+    id: string;
     name: Translation;
     description?: Translation;
     metadata?: ArticleMetadata;
@@ -503,6 +510,7 @@ export declare interface ArticleTileSpecificData {
     description?: Translation;
     monetizations?: TileMonetizationData[];
     externalUrl?: string;
+    urlName?: UrlNamesType;
 }
 
 /**
@@ -811,6 +819,12 @@ export declare interface CommonSourceParams<T extends SourceType = SourceType> {
     videoPath?: string;
 }
 
+/**
+ * @public
+ * Re-export of Google IMA CompanionAd type for use throughout the SDK
+ */
+export declare type CompanionAd = google.ima.CompanionAd;
+
 /**
  * Just another alias. Reexported for backward compatibility.
  * @public
@@ -1071,6 +1085,9 @@ export declare const CountryToLangCodeMap: {
     CZ: LangCode;
     PL: LangCode;
     SK: LangCode;
+    DE: LangCode;
+    AT: LangCode;
+    CH: LangCode;
 };
 
 /**
@@ -1210,6 +1227,7 @@ export declare enum CustomerId {
     MIRA_BOSAK = "MIRA_BOSAK",
     KOVACIC_360 = "KOVACIC_360",
     SIFRA_TV = "SIFRA_TV",
+    TBL = "TBL",
     BLESK = "BLESK",
     NERUDA_TV = "NERUDA_TV",
     DAVID_FRANK_TV = "DAVID_FRANK_TV",
@@ -1226,6 +1244,7 @@ export declare interface CustomScript {
     src: string;
     event?: EventName;
     isAsync?: boolean;
+    defer?: boolean;
 }
 
 /**
@@ -1510,6 +1529,7 @@ export declare interface EmitterInterface {
     isSupported: (even: string) => boolean;
     addListener: <T = unknown>(event: string, cb: (value: T) => Empty_2) => void;
     removeListener: <T = unknown>(event: string, cb: (value: T) => Empty_2) => void;
+    emitEvent: (event: string, value?: unknown) => void;
 }
 
 /**
@@ -1576,6 +1596,15 @@ export declare const fetchBundle: (secret: string, conf: InternalConfig, checkBu
  */
 declare type FetchPackage = (url: string) => Promise<string>;
 
+export declare interface FinishSignUpRequest {
+    token: string;
+    fName: string;
+    lName: string;
+    email: string;
+    password: string;
+    langCode?: LangCode;
+}
+
 /**
  * @public
  */
@@ -1666,9 +1695,13 @@ export declare type GeoBlocking = {
     blacklist: Array<any>;
 };
 
-export declare interface GetArticleRequest {
+export declare type GetArticleRequest = {
     id: string;
-}
+} | {
+    idOrUrlName: string;
+    organizationId: string;
+    language: LangCode;
+};
 
 export declare interface GetArticleResponse {
     article: ArticleDocumentSerialized;
@@ -2281,12 +2314,16 @@ export declare enum LangCode {
     HU = "hu"
 }
 
+export declare const LangCodeToTitle: Partial<Record<LangCode, string>>;
+
 /**
  * All supported languages codes as in ISO 639-1
  * @public
  */
 export declare const languages: LangCode[];
 
+export declare type LanguageSelector = 'application' | 'content';
+
 /**
  * Possible language key of all supported language mutations.
  * @public
@@ -2335,7 +2372,13 @@ export declare interface LeaderboardsRequest {
  */
 export declare interface LinkedVideo {
     video: Video;
-    type: 'CUT' | 'TRAILER' | 'BONUS' | 'CHILD' | 'TEASER' | 'TASTING' | 'VIRTUAL_PROGRAM' | 'LANGUAGE'
+    type: 'CUT' | 'TRAILER' | 'BONUS' | 'CHILD'
+    /**
+    * Recommendation for the video that appears ahead of
+    * algorithmic recommendations on the detail page. Works one-way: if A
+    * links to B, B is recommended for A only (unless B links back).
+    */
+    | 'RECOMMENDED' | 'TEASER' | 'TASTING' | 'VIRTUAL_PROGRAM' | 'LANGUAGE'
     /**
     * Will render separate mini-player on top of the main one, playing given video.
     */
@@ -2875,11 +2918,6 @@ export declare type Nullable<T> = {
     [P in keyof T]: T[P] | null;
 };
 
-/**
- * @public
- */
-export declare type ObjectType = Record<string, any>;
-
 /**
  * @public
  */
@@ -3625,6 +3663,7 @@ export declare interface PlayerWrapper {
     isPaused: boolean;
     isPlaying: boolean;
     isIdle: boolean;
+    isFullscreen: boolean;
     language: LangCode | null;
     nextRecommendedVideo: Video | null;
     prerollCheck: PrerollCheck;
@@ -3714,7 +3753,11 @@ export declare enum PlayerWrapperEvents {
     /**
      * Triggered when an ad finishes playing
      */
-    'ad-ended' = "ad-ended"
+    'ad-ended' = "ad-ended",
+    /**
+     * Triggered when companion ads are available for the current ad
+     */
+    'companion-ads' = "companion-ads"
 }
 
 /**
@@ -5424,6 +5467,12 @@ export declare interface SimplifiedVideoController {
      * @param callback - Function called when an ad finishes playing
      */
     addEventListener(event: 'ad-ended', callback: () => void): void;
+    /**
+     * Add an event listener for companion ads events
+     * @param event - Must be 'companion-ads'
+     * @param callback - Function called when companion ads are available
+     */
+    addEventListener(event: 'companion-ads', callback: (companionAds: CompanionAd[]) => void): void;
     /**
      * Remove an event listener
      * @param event - The event name to stop listening for
@@ -6012,7 +6061,7 @@ export declare interface TivioConfig {
     };
     secret: string;
     /**
-     * Language used when isLanguageSelectionEnabled is false | undefined or when not possible to load language from local storage or localization worker
+     * Language used when no languageSelector is set or when not possible to load language from local storage or localization worker
      */
     language: LangCode;
     debug?: boolean;
@@ -6020,15 +6069,16 @@ export declare interface TivioConfig {
     firebaseApp?: any | null;
     firebaseFactory?: (config: object, appName?: string) => firebase_2.FirebaseApp;
     authDomainOverride?: string;
+    /**
+     * @deprecated this field is no longer in use and has no impact when set.
+     */
     firestore?: any | null;
     currency: Currency;
     /**
-     * A flag that indicates whether the language selection feature is enabled.
-     * Language is then stored to local storage 'tivio-user-language'.
-     * If nothing is stored in local storage, then language is set according to location
-     * When set to `true`, users are allowed to choose their preferred language
+     * Represents an optional array of LanguageSelector objects.
+     * Used to define and manage a list of supported languages for different language-usages (user, content,...).
      */
-    isLanguageSelectionEnabled?: boolean;
+    languageSelectors?: Partial<Record<LanguageSelector, LangCode[]>>;
     applicationId?: string;
     isTivioProApp?: boolean;
     lockApplicationHandle?: string;
@@ -6055,6 +6105,7 @@ export declare interface TivioConfig {
      * customTokenCookiesDomain: 'example.com'
      */
     customTokenCookiesDomain?: string;
+    enableGtmPlayerEvents?: boolean;
 }
 
 /**
@@ -6300,12 +6351,18 @@ export declare type TivioJsBundleExposedApi = {
     /**
      * Get tag by its id.
      * @param tagId - tag id
-     * @returns {Promise<Tag | null>} widget or null if tag does not exists
+     * @returns {Promise<Tag | null>} tag or null if tag does not exists
      */
     getTagById: (tagId: string) => Promise<Tag | null>;
+    /**
+     * Get tags by their ids.
+     * @param tagIds - tag ids
+     * @returns {Promise<Tag[]} list of tags for given ids
+     */
+    getTagsByIds: (tagIds: string[]) => Promise<Tag[]>;
     createPlayerWrapper: (playerImplementation: PlayerInterfaceForPlayerWrapper) => TivioPlayerWrapper;
     destroy: () => Promise<void>;
-} & Pick<TivioGetters, 'getVideoById' | 'getScreenById' | 'organization' | 'getUser'> & Pick<TivioSubscriptions, 'subscribeToVideo' | 'subscribeToItemsInRow' | 'subscribeToRowsInScreen'> & Pick<TivioAuth, 'createUserWithEmailAndPassword' | 'signInWithEmailAndPassword' | 'resetPassword' | 'signOut'> & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setStorageManager'>;
+} & Pick<TivioGetters, 'getVideoById' | 'getScreenById' | 'organization' | 'getUser'> & Pick<TivioSubscriptions, 'subscribeToVideo' | 'subscribeToItemsInRow' | 'subscribeToRowsInScreen'> & Pick<TivioAuth, 'createUserWithEmailAndPassword' | 'signInWithEmailAndPassword' | 'resetPassword' | 'signOut'> & Pick<TivioSetters, 'setBundleVersion' | 'setUser' | 'setLanguage' | 'setContentLanguage' | 'setStorageManager'>;
 
 /**
  * @public
@@ -6377,6 +6434,7 @@ export declare type TivioSetters = {
      * @param language
      */
     setLanguage: (language: LangCode) => void;
+    setContentLanguage: (language: LangCode) => void;
     setStorageManager: (storageManager: StorageManager_2) => void;
     setUser: (userId: string | null, userPayload?: UserPayload) => Promise<void>;
 };
@@ -6405,10 +6463,6 @@ export declare type TivioSubscriptions = {
     subscribeToItemsInRow: SubscribeToItemsInRow;
     subscribeToRowsInScreen: SubscribeToRowsInScreen;
     subscribeToTaggedVideos: SubscribeToTaggedVideos;
-    registerOverlayCallbacks: (callbacks: {
-        onShow: () => void;
-        onHide: () => void;
-    }) => void;
 };
 
 /**
@@ -6624,6 +6678,10 @@ export declare type UpdateNotificationSettingsResponse = Promise<boolean>;
 
 export declare type UpsertCommentResponse = AddEditCommentResponse | DeleteCommentResponse;
 
+export declare type UrlNamesType = {
+    [key in LangCode]?: string[];
+};
+
 /**
  * @public
  */
@@ -7253,23 +7311,18 @@ export declare type VastApiFramework = string | 'VPAID' | null;
  * @public
  */
 export declare enum VastProvider {
-    CNC_PREBID = "cnc-prebid",
     CNC_STARGAZE_PREROLL_1 = "cnc-stargaze-preroll-1",
     CNC_STARGAZE_PREROLL_2 = "cnc-stargaze-preroll-2",
     CNC_STARGAZE_MIDROLL = "cnc-stargaze-midroll",
-    ETARGET_PREBID = "etarget-prebid",
     FALLBACK_HLS = "fallback-hls",
     FALLBACK_MP4 = "fallback",
     GARAZ_TV = "garaz.tv",
     GARAZ_TV_DEV = "garaz.tv.dev",
-    IMPRESSION_MEDIA_PREBID = "impressionMedia-prebid",
     JOJ_ADFORM = "joj",
     JOJ_SMART = "joj-smart",
     JOJ_AD_MANAGER_VOD_PREROLL = "joj-ad-manager-vod-preroll",
     JOJ_AD_MANAGER_VOD_MIDROLL = "joj-ad-manager-vod-midroll",
     JOJ_AD_MANAGER_LIVE_PREROLL = "joj-ad-manager-live-preroll",
-    MALL_TV = "malltv",
-    MALL_TV_PREBID = "malltv-prebid",
     PRIMA = "prima",
     TEST = "test",
     TEST_VPAID = "test-vpaid",
@@ -7381,6 +7434,7 @@ export declare interface Video extends RowItem, MonetizableItem, ReactableConten
     forcedCapabilities: PlayerCapability[] | null;
     mainLinkedVideoId?: string;
     getLinkedVideoIdByLanguage: (lang: LangCode) => string | undefined;
+    externals?: VideoExternals;
 }
 
 /**
@@ -7419,6 +7473,7 @@ export declare interface VideoController {
     addEventListener(event: 'ad-started', callback: (value: AdMetadata & {
         adCtaElement: HTMLElement | null;
     }) => void): void;
+    addEventListener(event: 'companion-ads', callback: (value: CompanionAd[]) => void): void;
     /**
      * Remove an event listener
      * @param event - The event name to stop listening for
@@ -7674,7 +7729,7 @@ export declare interface VideoTileSpecificData {
     assets?: AssetsField;
     episodeNumber?: number;
     seasonNumber?: number;
-    urlName?: VideoUrlNames;
+    urlName?: UrlNamesType;
     monetizations?: VideoTileMonetizationData[];
     description?: Translation;
 }
@@ -7743,13 +7798,6 @@ export declare enum VideoType {
     CHILD = "CHILD"
 }
 
-/**
- * @public
- */
-export declare type VideoUrlNames = {
-    [key in LangCode]?: string[];
-};
-
 export declare interface ViewCountItem {
     /**
      * Unix timestamp
@@ -8196,6 +8244,10 @@ export declare interface WebConfig {
      * Map for all handlers
      */
     handlers?: PurchaseEventHandlers;
+    homeScreen?: {
+        useFullHeight?: boolean;
+    };
+    disableModalSwitcher?: boolean;
 }
 
 /**