@bluebillywig/react-native-bb-player 8.45.23 → 8.46.1

package/src/BBCastMiniControls.tsx

@@ -0,0 +1,27 @@
+import React from 'react';
+import { requireNativeComponent, type ViewProps } from 'react-native';
+
+export interface BBCastMiniControlsProps extends ViewProps {}
+
+const NativeBBCastMiniControls =
+  requireNativeComponent<BBCastMiniControlsProps>('BBCastMiniControlsView');
+
+/**
+ * BBCastMiniControls - Native ChromeCast mini controller that shows during casting.
+ *
+ * This component renders the native Google Cast SDK mini controller
+ * (GCKUIMiniMediaControlsViewController on iOS, MiniControllerFragment on Android).
+ * It automatically shows playback controls when content is being cast.
+ *
+ * @example
+ * ```tsx
+ * <BBCastMiniControls style={{ height: 64 }} />
+ * ```
+ */
+const BBCastMiniControls: React.FC<BBCastMiniControlsProps> = (props) => {
+  return <NativeBBCastMiniControls {...props} />;
+};
+
+BBCastMiniControls.displayName = 'BBCastMiniControls';
+
+export default BBCastMiniControls;

package/src/BBModalPlayer.ts

@@ -33,6 +33,21 @@ export interface ModalPlayerOptions {
   [key: string]: unknown;
 }
 
+/**
+ * Context for playlist/collection navigation in modal player.
+ * Uses the same field names as the native SDK (contextEntityId, contextCollectionId).
+ */
+export interface ModalPlayerContext {
+  /** Entity type (e.g. 'MediaClipList') */
+  contextEntityType?: string;
+  /** Entity ID (clip ID when playing within a collection) */
+  contextEntityId?: string;
+  /** Collection type (e.g. 'MediaClipList') */
+  contextCollectionType?: string;
+  /** Collection ID (playlist/cliplist ID) */
+  contextCollectionId?: string;
+}
+
 export const BBModalPlayer = {
   /**
    * Whether the native modal player module is available.
@@ -42,7 +57,7 @@ export const BBModalPlayer = {
     return BBPlayerModule != null;
   },
 
-  present(jsonUrl: string, options?: ModalPlayerOptions, context?: Record<string, string>): boolean {
+  present(jsonUrl: string, options?: ModalPlayerOptions, context?: ModalPlayerContext): boolean {
     if (!BBPlayerModule) {
       console.warn('[BBModalPlayer] present() called but native module is null — cannot open modal');
       return false;

package/src/BBOutstreamView.tsx

@@ -263,6 +263,7 @@ const BBOutstreamView = forwardRef<BBOutstreamViewMethods, BBOutstreamViewProps>
         seekRelative: (offset: number) => playerRef.current?.seekRelative(offset),
         setVolume: (volume: number) => playerRef.current?.setVolume(volume),
         setMuted: (muted: boolean) => playerRef.current?.setMuted(muted),
+        setInView: (inView: boolean) => playerRef.current?.setInView(inView),
         collapse: () => playerRef.current?.collapse(),
         expand: () => playerRef.current?.expand(),
         enterFullscreen: () => playerRef.current?.enterFullscreen(),
@@ -298,6 +299,9 @@ const BBOutstreamView = forwardRef<BBOutstreamViewMethods, BBOutstreamViewProps>
         getClipData: () => playerRef.current?.getClipData() ?? Promise.resolve(null),
         getProjectData: () => playerRef.current?.getProjectData() ?? Promise.resolve(null),
         getPlayoutData: () => playerRef.current?.getPlayoutData() ?? Promise.resolve(null),
+        getInView: () => playerRef.current?.getInView() ?? Promise.resolve(null),
+        getAdMediaWidth: () => playerRef.current?.getAdMediaWidth() ?? Promise.resolve(null),
+        getAdMediaHeight: () => playerRef.current?.getAdMediaHeight() ?? Promise.resolve(null),
         getPlayerState: () => playerRef.current?.getPlayerState() ?? Promise.resolve(null),
 
         // Outstream-specific methods
@@ -329,6 +333,6 @@ const BBOutstreamView = forwardRef<BBOutstreamViewMethods, BBOutstreamViewProps>
   }
 );
 
-BBOutstreamView.displayName = 'BBOutstreamView';
+BBOutstreamView.displayName = 'BBOutstreamPlayerView';
 
 export default BBOutstreamView;

package/src/BBPlayer.types.ts

@@ -59,6 +59,8 @@ export type BBPlayerViewMethods = {
   seekRelative: (offsetSeconds: number) => void;
   setMuted: (muted: boolean) => void;
   setVolume: (volume: number) => void;
+  /** Override the scroll-based viewability state */
+  setInView: (inView: boolean) => void;
   enterFullscreen: () => void;
   enterFullscreenLandscape: () => void;
   exitFullscreen: () => void;
@@ -155,6 +157,12 @@ export type BBPlayerViewMethods = {
   getPlayoutData: () => Promise<{
     name?: string;
   } | null>;
+  /** Get current viewability override state */
+  getInView: () => Promise<boolean | null>;
+  /** Get the ad creative width in pixels */
+  getAdMediaWidth: () => Promise<number | null>;
+  /** Get the ad creative height in pixels */
+  getAdMediaHeight: () => Promise<number | null>;
 
   /**
    * Get the complete player state as a structured object.
@@ -179,7 +187,7 @@ export type BBPlayerViewProps = {
    */
   playerId?: string;
   /**
-   * JWT token for authenticated playback of protected content.
+   * JWT token for authenticated access to protected content.
    * Will be merged into options.jwt automatically.
    */
   jwt?: string;

package/src/NativeCommands.ts

@@ -261,6 +261,12 @@ export function createCommands(viewRef: React.RefObject<any>) {
 
     // Note: For Shorts playback, use the BBShortsView component instead of BBPlayerView.
 
+    // Viewability control
+    setInView: (inView: boolean) => {
+      const tag = getViewTag(viewRef);
+      if (tag != null) BBPlayerModule?.setInView(tag, inView);
+    },
+
     // Getter methods (async)
     getDuration: async (): Promise<number | null> => {
       const tag = getViewTag(viewRef);
@@ -335,6 +341,27 @@ export function createCommands(viewRef: React.RefObject<any>) {
       }
       return null;
     },
+    getInView: async (): Promise<boolean | null> => {
+      const tag = getViewTag(viewRef);
+      if (tag != null && BBPlayerModule?.getInView) {
+        return BBPlayerModule.getInView(tag);
+      }
+      return null;
+    },
+    getAdMediaWidth: async (): Promise<number | null> => {
+      const tag = getViewTag(viewRef);
+      if (tag != null && BBPlayerModule?.getAdMediaWidth) {
+        return BBPlayerModule.getAdMediaWidth(tag);
+      }
+      return null;
+    },
+    getAdMediaHeight: async (): Promise<number | null> => {
+      const tag = getViewTag(viewRef);
+      if (tag != null && BBPlayerModule?.getAdMediaHeight) {
+        return BBPlayerModule.getAdMediaHeight(tag);
+      }
+      return null;
+    },
 
     /**
      * Get the complete player state as a structured object.

package/src/index.ts

@@ -1,16 +1,23 @@
 // Main exports
 export { default as BBPlayerView } from "./BBPlayerView";
 export { default as BBShortsView } from "./BBShortsView";
-export { default as BBOutstreamView } from "./BBOutstreamView";
+export { default as BBOutstreamPlayerView } from "./BBOutstreamView";
+export { default as BBCastButton } from "./BBCastButton";
+export { default as BBCastMiniControls } from "./BBCastMiniControls";
 export { BBModalPlayer } from "./BBModalPlayer";
-export type { ModalPlayerOptions } from "./BBModalPlayer";
+export type { ModalPlayerOptions, ModalPlayerContext } from "./BBModalPlayer";
 export * from "./BBPlayer.types";
 export * from "./BBShortsView"; // Export BBShortsView types
 export * from "./BBOutstreamView"; // Export BBOutstreamView types
+export * from "./BBCastButton"; // Export BBCastButton types
+export * from "./BBCastMiniControls"; // Export BBCastMiniControls types
 export * from "./types";
 export * from "./utils";
 
-// For backwards compatibility with Expo module naming
+// Deprecated aliases — kept for backwards compatibility
+/** @deprecated Use `BBOutstreamPlayerView` instead. */
+export { default as BBOutstreamView } from "./BBOutstreamView";
+/** @deprecated Use `BBOutstreamPlayerView` instead. */
 export { default as ExpoBBPlayerView } from "./BBPlayerView";
 export {
   type BBPlayerViewProps as ExpoBBPlayerViewProps,

package/src/specs/NativeBBPlayerModule.ts

@@ -77,6 +77,9 @@ export interface Spec extends TurboModule {
   ): void;
   loadWithJsonUrl(viewTag: number, jsonUrl: string, autoPlay: boolean, contextJson: string | null): void;
 
+  // Void methods - viewability
+  setInView(viewTag: number, inView: boolean): void;
+
   // Promise getters
   getDuration(viewTag: number): Promise<number | null>;
   getMuted(viewTag: number): Promise<boolean | null>;
@@ -87,6 +90,9 @@ export interface Spec extends TurboModule {
   getClipData(viewTag: number): Promise<Object | null>;
   getProjectData(viewTag: number): Promise<Object | null>;
   getPlayoutData(viewTag: number): Promise<Object | null>;
+  getInView(viewTag: number): Promise<boolean | null>;
+  getAdMediaWidth(viewTag: number): Promise<number | null>;
+  getAdMediaHeight(viewTag: number): Promise<number | null>;
 
   // Modal player (module-level, no React view needed)
   presentModalPlayer(jsonUrl: string, optionsJson: string | null, contextJson: string | null): void;

package/src/types.ts

@@ -69,7 +69,7 @@ export type MediaClipList = {
   allowDatasource_boolean?: boolean;
   score?: number;
   count?: number;
-  items?: MediaClip[];
+  items?: (MediaClip | MediaClipList | Project)[];
 };
 
 export type MediaClip = {