@devix-technologies/react-gjirafa-vp-player 1.0.31-beta.17 → 1.0.31-beta.19

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import { RefAttributes } from 'react';
 import { RefObject } from 'react';
 import { StyledComponent } from '@emotion/styled';
 import { Theme } from '@emotion/react';
+import { VideoLockingConfig as VideoLockingConfig_2 } from '../../../../../../../src/interfaces';
 import { VPPlayerInstance as VPPlayerInstance_2 } from '../../../../../../../src/interfaces';
 import { VPPlayerProps as VPPlayerProps_2 } from '../../../../../../../src/interfaces';
 import { VPPlayerRef as VPPlayerRef_2 } from '../../../../../../../src/interfaces';
@@ -263,10 +264,11 @@ export declare interface EventCallbackRefs {
     onQuartile25?: () => void;
     onQuartile50?: () => void;
     onQuartile75?: () => void;
-    onNext?: () => void;
-    onPrevious?: () => void;
+    onNext?: (currentTime: number) => void;
+    onPrevious?: (currentTime: number) => void;
     onProgress10s?: (seconds: number) => void;
     onProgress20s?: (seconds: number) => void;
+    onPlaylistItem?: (data: CurrentVideoData_2) => void;
 }
 
 /**
@@ -726,13 +728,15 @@ export declare interface TimesliderSkin {
  * 1. **Auto-init mode** (default): Load managed script that auto-initializes with GTech admin config
  * 2. **Config override mode**: Fetch config, merge user overrides, and call setup()
  */
-export declare const useVPPlayerLogic: ({ scriptId, videoId, scriptUrl, projectId, config, playerId, isVertical, isReels, onReady, onPlay, onPause, onResume, onComplete, onError, onVideoStarted, onTimeUpdate, onQuartile25, onQuartile50, onQuartile75, onNext, onPrevious, onProgress10s, onProgress20s, }: VPPlayerProps_2) => {
+export declare const useVPPlayerLogic: ({ scriptId, videoId, scriptUrl, projectId, config, playerId, isVertical, isReels, onReady, onPlay, onPause, onResume, onComplete, onError, onVideoStarted, onTimeUpdate, onQuartile25, onQuartile50, onQuartile75, onNext, onPrevious, onProgress10s, onProgress20s, onPlaylistItem, }: VPPlayerProps_2) => {
     playerRef: RefObject<HTMLDivElement | null>;
     playerInstanceRef: RefObject<VPPlayerInstance_2 | null>;
     isScriptLoaded: boolean;
     isLoading: boolean;
     error: string | null;
     generatedPlayerId: string;
+    isInPlaylistTransitionRef: RefObject<boolean>;
+    pendingVideoLockingRef: RefObject<VideoLockingConfig_2 | null>;
 };
 
 /**
@@ -818,6 +822,12 @@ export declare interface VideoFlag {
     name: string;
 }
 
+export declare interface VideoLockingConfig {
+    isEnabled: boolean;
+    type: "seconds" | "percentage";
+    value: number;
+}
+
 /**
  * Volume skin configuration
  */
@@ -936,7 +946,7 @@ export declare interface VPPlayerConfig {
  * @interface VPPlayerInstance
  */
 export declare interface VPPlayerInstance {
-    setup: (config: unknown) => void;
+    setup: (config: unknown) => Promise<void> | void;
     destroy?: () => void;
     play?: () => void;
     pause?: () => void;
@@ -974,6 +984,7 @@ export declare interface VPPlayerInstance {
     setCurrentQuality?: (index: number) => void;
     setLevelToAuto?: () => void;
     setCuePoint?: (cue: number, callback: () => void) => void;
+    setVideoLocking?: (config: VideoLockingConfig) => void;
     on?: (event: string, callback: (data?: unknown) => void) => void;
     off?: (event: string, callback?: (data?: unknown) => void) => void;
     videoIndex?: number;
@@ -1132,13 +1143,15 @@ export declare interface VPPlayerProps {
      */
     onQuartile75?: () => void;
     /**
-     * Called when transitioning to the next video in playlist
+     * Called when user clicks the next button (not on auto-advance)
+     * @param currentTime - Current playback position when clicked
      */
-    onNext?: () => void;
+    onNext?: (currentTime: number) => void;
     /**
-     * Called when transitioning to the previous video in playlist
+     * Called when user clicks the previous button (vertical player only)
+     * @param currentTime - Current playback position when clicked
      */
-    onPrevious?: () => void;
+    onPrevious?: (currentTime: number) => void;
     /**
      * Called every 10 seconds during playback
      * @param seconds - Current playback position in seconds
@@ -1149,6 +1162,12 @@ export declare interface VPPlayerProps {
      * @param seconds - Current playback position (should be ~20)
      */
     onProgress20s?: (seconds: number) => void;
+    /**
+     * Called when the active playlist item changes (horizontal player only)
+     * Fires reliably for all playlist transitions, including auto-advance
+     * @param data - Video metadata for the new playlist item
+     */
+    onPlaylistItem?: (data: CurrentVideoData_2) => void;
 }
 
 /**
@@ -1187,6 +1206,11 @@ export declare interface VPPlayerRef {
     isPlaying: () => boolean;
     isPaused: () => boolean;
     isFullscreen: () => boolean;
+    /**
+     * Set video locking configuration dynamically.
+     * This is the correct way to enable/disable video locking after the player has started.
+     */
+    setVideoLocking: (config: VideoLockingConfig) => void;
 }
 
 /**