@tivio/sdk-react 9.3.1 → 9.5.0

package/dist/sdk-react.d.ts

@@ -1,3 +1,4 @@
+import { AD_SERVICE_PROXY_NAME } from '@tivio/common';
 import type { ComponentType } from 'react';
 import type dayjs from 'dayjs';
 import { DocumentReference } from '@firebase/firestore-types';
@@ -34,6 +35,8 @@ declare interface actualPriceDetails {
     currency?: primaSupportedCurrency;
 }
 
+export { AD_SERVICE_PROXY_NAME }
+
 export declare type AdBannerScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.AD_BANNER>;
 
 export declare type AddEditCommentResponse = {
@@ -100,6 +103,7 @@ export declare type AdMetadata = {
     isSkippable: boolean;
     order: number | null;
     totalCount: number | null;
+    customAdMetadata?: Record<string, unknown>;
     skip: () => void;
 } | null;
 
@@ -217,6 +221,10 @@ export declare interface AdSourceInterface extends CommonSourceInterface<SourceT
     skipAll(): void;
     onRemainingTimeChanged(ms: number): void;
     click(): void;
+    /**
+     * Rich IMA ad metadata including customAdMetadata (only available for IMA ads)
+     */
+    imaAdMetadata?: any;
 }
 
 /**
@@ -675,6 +683,8 @@ export declare interface ButtonOptions {
  */
 export declare interface ButtonVariantOptions {
     border?: string;
+    disabledBackgroundColor?: string;
+    disabledColor?: string;
 }
 
 /**
@@ -1249,7 +1259,8 @@ export declare enum CustomerId {
     KAROL_A_KVIDO = "KAROL_A_KVIDO",
     UZ_BUDU = "UZ_BUDU",
     PRIMA = "PRIMA",
-    NORA_FRIDRICHOVA = "NORA_FRIDRICHOVA"
+    NORA_FRIDRICHOVA = "NORA_FRIDRICHOVA",
+    LONGEVITY = "LONGEVITY"
 }
 
 /**
@@ -1447,6 +1458,15 @@ export declare interface Customizations {
         color?: string;
         backgroundColorActive?: string;
         formBackgroundColor?: string;
+        captionColor?: string;
+        textInputBorder?: string;
+    };
+    MobilePayment?: {
+        backgroundColor?: string;
+        color?: string;
+        backgroundColorActive?: string;
+        formBackgroundColor?: string;
+        captionColor?: string;
     };
     QerkoOverlay?: {
         backgroundColor?: string;
@@ -2313,6 +2333,8 @@ export declare interface InputOptions {
     color?: string;
 }
 
+export declare type InputSourceParams = SourceParams | VodExternalMultiSourceParams;
+
 export declare type IntegrationType = 'discord' | 'patreon';
 
 export declare interface InteractiveWidget<T extends InteractiveWidgetScene = InteractiveWidgetScene> {
@@ -3347,6 +3369,20 @@ export declare interface PartialRegistrationOverlayContextState {
     voucher?: string;
 }
 
+/**
+ * @public
+ * Generic interface for sources that can be identified by a path (video or TV channel)
+ */
+export declare type PathSourceParams = PathSourceParamsTvChannel | PathSourceParamsVideo;
+
+declare interface PathSourceParamsTvChannel extends Partial<ChannelSourceParams> {
+    path: `tvChannels/${string}`;
+}
+
+declare interface PathSourceParamsVideo extends Partial<Omit<VodTivioSourceParams, 'videoPath'>> {
+    path: `videos/${string}`;
+}
+
 export declare type PatreonCreatorData = {
     campaign: string;
     tiers: Tier[];
@@ -3793,6 +3829,7 @@ export declare interface PlayerSourceInterface<T extends NonAdSourceType = NonAd
     start?: Date;
     from?: Date;
     sourceHistory?: string[];
+    staticAdsConfig?: StaticAdsBreak[];
 }
 
 /**
@@ -3811,6 +3848,7 @@ export declare interface PlayerSourceParams<T extends NonAdSourceType = NonAdSou
     seekingMatrix?: SeekingMatrixTemplate;
     sessionType?: VideoSourceField['sessionType'];
     sessionId?: string;
+    staticAdsConfig?: StaticAdsBreak[];
 }
 
 export declare type PlayersScene = InteractiveWidgetSceneBase<InteractiveWidgetSceneTemplateType.PLAYERS>;
@@ -3971,7 +4009,15 @@ export declare enum PlayerWrapperEvents {
     /**
      * Un-pause was triggered
      */
-    'unpause_triggered' = "unpause_triggered"
+    'unpause_triggered' = "unpause_triggered",
+    /**
+     * Triggered when an ad starts playing
+     */
+    'ad_started' = "ad_started",
+    /**
+     * Triggered when an ad finishes playing
+     */
+    'ad_ended' = "ad_ended"
 }
 
 /**
@@ -4231,6 +4277,11 @@ export declare type Purchase = {
     voucherId: string | null;
     isVoucherActivation?: boolean;
     rebalancingVideoRef?: any;
+    /**
+     * Returns all purchases that are connected via originalPurchaseRef.
+     * For example, if user has subscription purchase, this method will return all purchases that are RENEWED + PAID/CANCELLED latest one.
+     */
+    getRelatedPurchases: () => Promise<Purchase[]>;
 };
 
 /**
@@ -5662,6 +5713,21 @@ export declare interface SimplifiedVideoController {
         muted: boolean;
         volume: number;
     }) => void): void;
+    /**
+     * Add an event listener for ad started events
+     * @param event - Must be 'ad_started'
+     * @param callback - Function called when an ad starts playing
+     */
+    addEventListener(event: 'ad_started', callback: (adMetadata: AdMetadata & {
+        customAdMetadata?: Record<string, unknown> | null;
+        ctaElement: HTMLElement | null;
+    }) => void): void;
+    /**
+     * Add an event listener for ad ended events
+     * @param event - Must be 'ad_ended'
+     * @param callback - Function called when an ad finishes playing
+     */
+    addEventListener(event: 'ad_ended', callback: () => void): void;
     /**
      * Remove an event listener
      * @param event - The event name to stop listening for
@@ -5673,6 +5739,7 @@ export declare interface SimplifiedVideoController {
      * @param source - The new source to load (can be a video path, channel path, or source parameters)
      */
     setSource(source: WebPlayerProps['source']): void;
+    setAdsConfig(adsConfig: StaticAdsBreak[]): void;
     /**
      * Destroy the player and clean up all resources
      */
@@ -5792,6 +5859,19 @@ export declare interface StartLiveStreamResponse {
     error?: string;
 }
 
+export declare type StaticAdsBreak = StaticAdsBreakPostrollPreroll | StaticAdsBreakMidroll;
+
+export declare interface StaticAdsBreakMidroll {
+    type: 'midroll';
+    from: number;
+    url: string;
+}
+
+declare interface StaticAdsBreakPostrollPreroll {
+    type: 'preroll' | 'postroll';
+    url: string;
+}
+
 /**
  * @public
  */
@@ -6355,6 +6435,12 @@ export declare interface TivioConfig {
      * (otherwise organizations would share login token).
      */
     customerId?: CustomerId;
+    /**
+     * An optional variable that enables Single Sign-On (SSO) for all subdomains under the same parent domain.
+     * @example
+     * customTokenCookiesDomain: 'example.com'
+     */
+    customTokenCookiesDomain?: string;
 }
 
 /**
@@ -7586,6 +7672,7 @@ export declare enum VastProvider {
     TEST = "test",
     TEST_VPAID = "test-vpaid",
     TIVIO_ADS = "tivio-ads",
+    STATIC_ADS_PROVIDER = "static-ads-provider",
     JOJ_TEST_AD_FORM_PROGRAMMATIC = "joj-test-ad-form-programmatic",
     JOJ_TEST_TESTER_VASTERIX = "joj-test-tester-vasterix",
     JOJ_TEST_TESTER_ADFORM_30 = "joj-test-tester-adform-30"
@@ -7727,6 +7814,9 @@ export declare interface VideoController {
         muted: boolean;
         volume: number;
     }) => void): void;
+    addEventListener(event: 'ad_started', callback: (value: AdMetadata & {
+        adCtaElement: HTMLElement | null;
+    }) => void): void;
     /**
      * Remove an event listener
      * @param event - The event name to stop listening for
@@ -7852,6 +7942,7 @@ export declare interface VideoController {
      * @param mutations - Array of DOM mutation records
      */
     onWatermarkElementChange(mutations: MutationRecord[]): void;
+    setAdCtaElement: (element: HTMLElement | null) => void;
 }
 
 declare type VideoDetailResponsiveField = OrganizationResponsiveSetting<{
@@ -8096,6 +8187,14 @@ export declare interface VirtualChannelSourceParams extends ChannelSourceParams
     drm?: Drm;
 }
 
+/**
+ * Interface representing the parameters for a VOD (Video On Demand) external multi-source configuration.
+ * Multi-source means an array of string URLs representing the external sources for the video content.
+ */
+export declare interface VodExternalMultiSourceParams extends Omit<VodExternalSourceParams, 'url'> {
+    urls: string[];
+}
+
 /**
  * @public
  */
@@ -8448,7 +8547,7 @@ export declare interface WebGridScreenProps {
  */
 export declare interface WebPlayerProps {
     id: string;
-    source?: SourceParams | VideoPath | ChannelPath | null;
+    source?: InputSourceParams | PathSourceParams | VideoPath | ChannelPath | null;
     onEnded?: () => any;
     /**
      * If true, the player will inherit the width and height of its parent element.
@@ -8534,6 +8633,7 @@ export declare interface WebPlayerProps {
     setPaymentOverlayVisible?: React_2.Dispatch<React_2.SetStateAction<boolean>>;
     hideOverlay?: boolean;
     sourcePlayMode?: SourcePlayMode;
+    adsConfig?: StaticAdsBreak[];
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tivio/sdk-react",
-    "version": "9.3.1",
+    "version": "9.5.0",
     "main": "dist/index.js",
     "typings": "dist/index.d.ts",
     "source": "src/index.ts",
@@ -38,7 +38,7 @@
         "@material-ui/core": "^4.11.2",
         "@material-ui/icons": "^4.11.2",
         "@sentry/browser": "^6.1.0",
-        "@tivio/common": "1.1.133",
+        "@tivio/common": "1.1.135",
         "dayjs": "^1.11.0",
         "es7-object-polyfill": "^1.0.1",
         "firebase": "8.10.1",