@bluebillywig/react-native-bb-player 8.42.15 → 8.45.0

package/src/BBPlayer.types.ts

@@ -8,6 +8,21 @@ import type {
   State,
 } from "./types";
 
+/**
+ * Context for playlist/collection navigation.
+ * Enables "next up" list and proper playlist navigation in the player.
+ */
+export type LoadContext = {
+  /** Context entity type (always 'MediaClipList' for playlists) */
+  contextEntityType?: 'MediaClipList';
+  /** Playlist ID for "next up" list */
+  contextEntityId?: string;
+  /** Context collection type (always 'MediaClipList' for collections) */
+  contextCollectionType?: 'MediaClipList';
+  /** Collection ID if playing within a collection */
+  contextCollectionId?: string;
+};
+
 /**
  * Options for loading a clip via loadClip()
  */
@@ -20,6 +35,8 @@ export type LoadClipOptions = {
   seekTo?: number;
   /** Initiator identifier for analytics */
   initiator?: string;
+  /** Playlist/collection context for navigation */
+  context?: LoadContext;
 };
 
 /**
@@ -74,43 +91,48 @@ export type BBPlayerViewMethods = {
     clipId: string,
     initiator?: string,
     autoPlay?: boolean,
-    seekTo?: number
+    seekTo?: number,
+    context?: LoadContext
   ) => void;
   loadWithClipListId: (
     clipListId: string,
     initiator?: string,
     autoPlay?: boolean,
-    seekTo?: number
+    seekTo?: number,
+    context?: LoadContext
   ) => void;
   loadWithProjectId: (
     projectId: string,
     initiator?: string,
     autoPlay?: boolean,
-    seekTo?: number
+    seekTo?: number,
+    context?: LoadContext
   ) => void;
   loadWithClipJson: (
     clipJson: string,
     initiator?: string,
     autoPlay?: boolean,
-    seekTo?: number
+    seekTo?: number,
+    context?: LoadContext
   ) => void;
   loadWithClipListJson: (
     clipListJson: string,
     initiator?: string,
     autoPlay?: boolean,
-    seekTo?: number
+    seekTo?: number,
+    context?: LoadContext
   ) => void;
   loadWithProjectJson: (
     projectJson: string,
     initiator?: string,
     autoPlay?: boolean,
-    seekTo?: number
+    seekTo?: number,
+    context?: LoadContext
   ) => void;
-  loadWithJsonUrl: (jsonUrl: string, autoPlay?: boolean) => void;
+  loadWithJsonUrl: (jsonUrl: string, autoPlay?: boolean, context?: LoadContext) => void;
 
   // Getter methods (async)
   getDuration: () => Promise<number | null>;
-  getCurrentTime: () => Promise<number | null>;
   getMuted: () => Promise<boolean | null>;
   getVolume: () => Promise<number | null>;
   getPhase: () => Promise<string | null>;
@@ -140,7 +162,7 @@ export type BBPlayerViewMethods = {
    * const state = await playerRef.current?.getPlayerState();
    * if (state) {
    *   console.log(`Playing: ${state.state === 'PLAYING'}`);
-   *   console.log(`Progress: ${state.currentTime}/${state.duration}`);
+   *   console.log(`Duration: ${state.duration}`);
    * }
    */
   getPlayerState: () => Promise<BBPlayerState | null>;
@@ -165,10 +187,6 @@ export type BBPlayerViewProps = {
    * JSON URL to load player configuration from.
    */
   jsonUrl?: string;
-  /**
-   * Enable periodic time update events (onDidTriggerTimeUpdate).
-   */
-  enableTimeUpdates?: boolean;
   onDidFailWithError?: (error: string) => void;
   onDidRequestCollapse?: () => void;
   onDidRequestExpand?: () => void;
@@ -205,7 +223,6 @@ export type BBPlayerViewProps = {
   onDidTriggerSeeking?: () => void;
   onDidTriggerStall?: () => void;
   onDidTriggerStateChange?: (state: State) => void;
-  onDidTriggerTimeUpdate?: (currentTime: number, duration: number) => void;
   onDidTriggerViewFinished?: () => void;
   onDidTriggerViewStarted?: () => void;
   onDidTriggerVolumeChange?: (volume: number) => void;
@@ -226,8 +243,6 @@ export type BBPlayerState = {
   phase: Phase;
   /** Current playback mode */
   mode: string | null;
-  /** Current playback position in seconds */
-  currentTime: number;
   /** Total duration in seconds */
   duration: number;
   /** Whether audio is muted */
@@ -264,7 +279,6 @@ export type BBPlayerEventPayloads = {
   stateChange: { state: State };
   phaseChange: { phase: Phase };
   modeChange: { mode: string };
-  timeUpdate: { currentTime: number; duration: number };
   durationChange: { duration: number };
   volumeChange: { volume: number; muted: boolean };
   seeked: { position: number };

package/src/BBPlayerView.tsx

@@ -82,9 +82,6 @@ type NativeBBPlayerViewProps = Override<
     onDidTriggerStateChange?: (
       event: NativeSyntheticEvent<{ state: State }>
     ) => void;
-    onDidTriggerTimeUpdate?: (
-      event: NativeSyntheticEvent<{ currentTime: number; duration: number }>
-    ) => void;
     onDidTriggerViewFinished?: (event: NativeSyntheticEvent<{}>) => void;
     onDidTriggerViewStarted?: (event: NativeSyntheticEvent<{}>) => void;
     onDidTriggerVolumeChange?: (
@@ -310,15 +307,6 @@ const BBPlayerView = forwardRef<BBPlayerViewMethods, BBPlayerViewProps>(
                 props.onDidTriggerStateChange?.(event.nativeEvent.state)
             : undefined
         }
-        onDidTriggerTimeUpdate={
-          props.onDidTriggerTimeUpdate
-            ? (event) =>
-                props.onDidTriggerTimeUpdate?.(
-                  event.nativeEvent.currentTime,
-                  event.nativeEvent.duration
-                )
-            : undefined
-        }
         onDidTriggerViewFinished={
           props.onDidTriggerViewFinished
             ? () => props.onDidTriggerViewFinished?.()

package/src/NativeCommands.ts

@@ -1,6 +1,6 @@
 import { NativeModules, findNodeHandle } from "react-native";
 
-import type { LoadClipOptions, BBPlayerState } from "./BBPlayer.types";
+import type { LoadClipOptions, LoadContext, BBPlayerState } from "./BBPlayer.types";
 import type { State, Phase } from "./types";
 
 // Try TurboModule first, fallback to legacy NativeModules
@@ -110,12 +110,14 @@ export function createCommands(viewRef: React.RefObject<any>) {
       const tag = getViewTag(viewRef);
       if (tag != null) {
         // Use loadWithClipId under the hood, passing playout as initiator if provided
+        const contextJson = options?.context ? JSON.stringify(options.context) : null;
         BBPlayerModule?.loadWithClipId(
           tag,
           clipId,
           options?.initiator ?? options?.playout ?? null,
           options?.autoPlay ?? false,
-          options?.seekTo ?? 0
+          options?.seekTo ?? 0,
+          contextJson
         );
       }
     },
@@ -125,16 +127,19 @@ export function createCommands(viewRef: React.RefObject<any>) {
       clipId: string,
       initiator?: string,
       autoPlay?: boolean,
-      seekTo?: number
+      seekTo?: number,
+      context?: LoadContext
     ) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
+        const contextJson = context ? JSON.stringify(context) : null;
         BBPlayerModule?.loadWithClipId(
           tag,
           clipId,
           initiator ?? null,
           autoPlay ?? false,
-          seekTo ?? 0
+          seekTo ?? 0,
+          contextJson
         );
       }
     },
@@ -142,16 +147,19 @@ export function createCommands(viewRef: React.RefObject<any>) {
       clipListId: string,
       initiator?: string,
       autoPlay?: boolean,
-      seekTo?: number
+      seekTo?: number,
+      context?: LoadContext
     ) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
+        const contextJson = context ? JSON.stringify(context) : null;
         BBPlayerModule?.loadWithClipListId(
           tag,
           clipListId,
           initiator ?? null,
           autoPlay ?? false,
-          seekTo ?? 0
+          seekTo ?? 0,
+          contextJson
         );
       }
     },
@@ -159,16 +167,19 @@ export function createCommands(viewRef: React.RefObject<any>) {
       projectId: string,
       initiator?: string,
       autoPlay?: boolean,
-      seekTo?: number
+      seekTo?: number,
+      context?: LoadContext
     ) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
+        const contextJson = context ? JSON.stringify(context) : null;
         BBPlayerModule?.loadWithProjectId(
           tag,
           projectId,
           initiator ?? null,
           autoPlay ?? false,
-          seekTo ?? 0
+          seekTo ?? 0,
+          contextJson
         );
       }
     },
@@ -176,16 +187,19 @@ export function createCommands(viewRef: React.RefObject<any>) {
       clipJson: string,
       initiator?: string,
       autoPlay?: boolean,
-      seekTo?: number
+      seekTo?: number,
+      context?: LoadContext
     ) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
+        const contextJson = context ? JSON.stringify(context) : null;
         BBPlayerModule?.loadWithClipJson(
           tag,
           clipJson,
           initiator ?? null,
           autoPlay ?? false,
-          seekTo ?? 0
+          seekTo ?? 0,
+          contextJson
         );
       }
     },
@@ -193,16 +207,19 @@ export function createCommands(viewRef: React.RefObject<any>) {
       clipListJson: string,
       initiator?: string,
       autoPlay?: boolean,
-      seekTo?: number
+      seekTo?: number,
+      context?: LoadContext
     ) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
+        const contextJson = context ? JSON.stringify(context) : null;
         BBPlayerModule?.loadWithClipListJson(
           tag,
           clipListJson,
           initiator ?? null,
           autoPlay ?? false,
-          seekTo ?? 0
+          seekTo ?? 0,
+          contextJson
         );
       }
     },
@@ -210,23 +227,27 @@ export function createCommands(viewRef: React.RefObject<any>) {
       projectJson: string,
       initiator?: string,
       autoPlay?: boolean,
-      seekTo?: number
+      seekTo?: number,
+      context?: LoadContext
     ) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
+        const contextJson = context ? JSON.stringify(context) : null;
         BBPlayerModule?.loadWithProjectJson(
           tag,
           projectJson,
           initiator ?? null,
           autoPlay ?? false,
-          seekTo ?? 0
+          seekTo ?? 0,
+          contextJson
         );
       }
     },
-    loadWithJsonUrl: (jsonUrl: string, autoPlay?: boolean) => {
+    loadWithJsonUrl: (jsonUrl: string, autoPlay?: boolean, context?: LoadContext) => {
       const tag = getViewTag(viewRef);
       if (tag != null) {
-        BBPlayerModule?.loadWithJsonUrl(tag, jsonUrl, autoPlay ?? true);
+        const contextJson = context ? JSON.stringify(context) : null;
+        BBPlayerModule?.loadWithJsonUrl(tag, jsonUrl, autoPlay ?? true, contextJson);
       }
     },
 
@@ -240,13 +261,6 @@ export function createCommands(viewRef: React.RefObject<any>) {
       }
       return null;
     },
-    getCurrentTime: async (): Promise<number | null> => {
-      const tag = getViewTag(viewRef);
-      if (tag != null && BBPlayerModule?.getCurrentTime) {
-        return BBPlayerModule.getCurrentTime(tag);
-      }
-      return null;
-    },
     getMuted: async (): Promise<boolean | null> => {
       const tag = getViewTag(viewRef);
       if (tag != null && BBPlayerModule?.getMuted) {
@@ -330,7 +344,6 @@ export function createCommands(viewRef: React.RefObject<any>) {
           state,
           phase,
           mode,
-          currentTime,
           duration,
           muted,
           volume,
@@ -341,7 +354,6 @@ export function createCommands(viewRef: React.RefObject<any>) {
           BBPlayerModule.getState?.(tag) ?? null,
           BBPlayerModule.getPhase?.(tag) ?? null,
           BBPlayerModule.getMode?.(tag) ?? null,
-          BBPlayerModule.getCurrentTime?.(tag) ?? 0,
           BBPlayerModule.getDuration?.(tag) ?? 0,
           BBPlayerModule.getMuted?.(tag) ?? false,
           BBPlayerModule.getVolume?.(tag) ?? 1,
@@ -354,7 +366,6 @@ export function createCommands(viewRef: React.RefObject<any>) {
           state: (state as State) ?? "IDLE",
           phase: (phase as Phase) ?? "INIT",
           mode: mode ?? null,
-          currentTime: currentTime ?? 0,
           duration: duration ?? 0,
           muted: muted ?? false,
           volume: volume ?? 1,

package/src/index.ts

@@ -2,6 +2,8 @@
 export { default as BBPlayerView } from "./BBPlayerView";
 export { default as BBShortsView } from "./BBShortsView";
 export { default as BBOutstreamView } from "./BBOutstreamView";
+export { BBModalPlayer } from "./BBModalPlayer";
+export type { ModalPlayerOptions } from "./BBModalPlayer";
 export * from "./BBPlayer.types";
 export * from "./BBShortsView"; // Export BBShortsView types
 export * from "./BBOutstreamView"; // Export BBOutstreamView types

package/src/specs/NativeBBPlayerModule.ts

@@ -19,6 +19,10 @@ export interface Spec extends TurboModule {
   collapse(viewTag: number): void;
   expand(viewTag: number): void;
 
+  // Void methods - modal control (per-view)
+  presentModal(viewTag: number): void;
+  closeModal(viewTag: number): void;
+
   // Void methods - other commands
   autoPlayNextCancel(viewTag: number): void;
   destroy(viewTag: number): void;
@@ -30,48 +34,53 @@ export interface Spec extends TurboModule {
     clipId: string,
     initiator: string | null,
     autoPlay: boolean,
-    seekTo: number
+    seekTo: number,
+    contextJson: string | null
   ): void;
   loadWithClipListId(
     viewTag: number,
     clipListId: string,
     initiator: string | null,
     autoPlay: boolean,
-    seekTo: number
+    seekTo: number,
+    contextJson: string | null
   ): void;
   loadWithProjectId(
     viewTag: number,
     projectId: string,
     initiator: string | null,
     autoPlay: boolean,
-    seekTo: number
+    seekTo: number,
+    contextJson: string | null
   ): void;
   loadWithClipJson(
     viewTag: number,
     clipJson: string,
     initiator: string | null,
     autoPlay: boolean,
-    seekTo: number
+    seekTo: number,
+    contextJson: string | null
   ): void;
   loadWithClipListJson(
     viewTag: number,
     clipListJson: string,
     initiator: string | null,
     autoPlay: boolean,
-    seekTo: number
+    seekTo: number,
+    contextJson: string | null
   ): void;
   loadWithProjectJson(
     viewTag: number,
     projectJson: string,
     initiator: string | null,
     autoPlay: boolean,
-    seekTo: number
+    seekTo: number,
+    contextJson: string | null
   ): void;
-  loadWithJsonUrl(viewTag: number, jsonUrl: string, autoPlay: boolean): void;
+  loadWithJsonUrl(viewTag: number, jsonUrl: string, autoPlay: boolean, contextJson: string | null): void;
 
   // Promise getters
   getDuration(viewTag: number): Promise<number | null>;
-  getCurrentTime(viewTag: number): Promise<number | null>;
   getMuted(viewTag: number): Promise<boolean | null>;
   getVolume(viewTag: number): Promise<number | null>;
   getPhase(viewTag: number): Promise<string | null>;
@@ -80,6 +89,14 @@ export interface Spec extends TurboModule {
   getClipData(viewTag: number): Promise<Object | null>;
   getProjectData(viewTag: number): Promise<Object | null>;
   getPlayoutData(viewTag: number): Promise<Object | null>;
+
+  // Modal player (module-level, no React view needed)
+  presentModalPlayer(jsonUrl: string, optionsJson: string | null): void;
+  dismissModalPlayer(): void;
+
+  // Event emitter support (required for NativeEventEmitter)
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
 }
 
 // Use get() instead of getEnforcing() to avoid crash when module not registered

package/android/proguard-rules.pro

@@ -1,59 +0,0 @@
-# Expo BB Player ProGuard Rules
-# Optimizations for release builds
-
-# Keep Blue Billywig Native Player SDK classes
--keep class com.bluebillywig.** { *; }
--keep interface com.bluebillywig.** { *; }
--keepclassmembers class com.bluebillywig.** { *; }
-
-# Keep Blue Billywig Native Shared classes
--keep class com.bluebillywig.bbnativeshared.** { *; }
--keep interface com.bluebillywig.bbnativeshared.** { *; }
-
-# Keep Expo BB Player module classes
--keep class expo.modules.bbplayer.** { *; }
--keep interface expo.modules.bbplayer.** { *; }
-
-# Keep Expo Modules API classes that are accessed via reflection
--keep class expo.modules.kotlin.** { *; }
--keepclassmembers class expo.modules.kotlin.** { *; }
-
-# Keep delegate interfaces and their implementations
--keep class * implements com.bluebillywig.bbnativeplayersdk.BBNativePlayerViewDelegate { *; }
-
-# Keep enum classes used by the SDK
--keepclassmembers enum com.bluebillywig.bbnativeshared.enums.** { *; }
-
-# Keep model classes that are serialized/deserialized
--keepclassmembers class com.bluebillywig.bbnativeshared.model.** { *; }
-
-# Remove debug logging in release builds (already guarded by BuildConfig.DEBUG)
--assumenosideeffects class android.util.Log {
-    public static *** d(...);
-    public static *** v(...);
-    public static *** i(...);
-}
-
-# Optimize - but not aggressively to avoid breaking functionality
--optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
--optimizationpasses 5
--allowaccessmodification
-
-# Keep line numbers for better crash reports
--keepattributes SourceFile,LineNumberTable
-
-# Keep annotations
--keepattributes *Annotation*
-
-# Keep native methods
--keepclasseswithmembernames class * {
-    native <methods>;
-}
-
-# Keep custom view constructors (required for Android layout inflation)
--keepclasseswithmembers class * {
-    public <init>(android.content.Context, android.util.AttributeSet);
-}
--keepclasseswithmembers class * {
-    public <init>(android.content.Context, android.util.AttributeSet, int);
-}