@bluebillywig/react-native-bb-player 8.42.0

package/plugin/build/index.d.ts

@@ -0,0 +1,20 @@
+import { ConfigPlugin } from "expo/config-plugins";
+export interface BBPlayerPluginProps {
+    /**
+     * iOS: Enables background audio playback capability.
+     * Adds UIBackgroundModes with 'audio' to Info.plist.
+     * @default false
+     */
+    enableBackgroundAudio?: boolean;
+    /**
+     * Android: Custom Maven repository URL for BB SDK.
+     * Only needed if using a private/custom repository.
+     * @default 'https://maven.bluebillywig.com/releases'
+     */
+    androidMavenUrl?: string;
+}
+declare const _default: ConfigPlugin<void | BBPlayerPluginProps>;
+export default _default;
+export { withAndroidBBPlayer } from "./withAndroid";
+export { withIosBBPlayer } from "./withIos";
+//# sourceMappingURL=index.d.ts.map

package/plugin/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,qBAAqB,CAAC;AAQxE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;;AAyCD,wBAAwE;AAGxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/plugin/build/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withIosBBPlayer = exports.withAndroidBBPlayer = void 0;
+const config_plugins_1 = require("expo/config-plugins");
+const withAndroid_1 = require("./withAndroid");
+const withIos_1 = require("./withIos");
+// Import package.json for version info
+const pkg = require("../../package.json");
+/**
+ * Config plugin for @bluebillywig/react-native-bb-player
+ *
+ * This plugin configures the native projects for the Blue Billywig Player SDK:
+ *
+ * **iOS:**
+ * - Adds BB SDK CocoaPods repository
+ * - Optionally enables background audio capability
+ *
+ * **Android:**
+ * - Adds BB SDK Maven repository to build.gradle
+ *
+ * @example
+ * // app.json / app.config.js
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       ["@bluebillywig/react-native-bb-player", {
+ *         "enableBackgroundAudio": true
+ *       }]
+ *     ]
+ *   }
+ * }
+ */
+const withBBPlayer = (config, props = {}) => {
+    const pluginProps = props || {};
+    // Apply Android configuration
+    config = (0, withAndroid_1.withAndroidBBPlayer)(config, pluginProps);
+    // Apply iOS configuration
+    config = (0, withIos_1.withIosBBPlayer)(config, pluginProps);
+    return config;
+};
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withBBPlayer, pkg.name, pkg.version);
+// Export individual platform plugins for advanced use cases
+var withAndroid_2 = require("./withAndroid");
+Object.defineProperty(exports, "withAndroidBBPlayer", { enumerable: true, get: function () { return withAndroid_2.withAndroidBBPlayer; } });
+var withIos_2 = require("./withIos");
+Object.defineProperty(exports, "withIosBBPlayer", { enumerable: true, get: function () { return withIos_2.withIosBBPlayer; } });

package/plugin/build/withAndroid.d.ts

@@ -0,0 +1,7 @@
+import { ConfigPlugin } from "expo/config-plugins";
+import type { BBPlayerPluginProps } from "./index";
+/**
+ * Adds the Blue Billywig Maven repository to the Android project's build.gradle
+ */
+export declare const withAndroidBBPlayer: ConfigPlugin<BBPlayerPluginProps>;
+//# sourceMappingURL=withAndroid.d.ts.map

package/plugin/build/withAndroid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAndroid.d.ts","sourceRoot":"","sources":["../src/withAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0B,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAKnD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,mBAAmB,CAcjE,CAAC"}

package/plugin/build/withAndroid.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAndroidBBPlayer = void 0;
+const config_plugins_1 = require("expo/config-plugins");
+const BB_MAVEN_REPO = "https://maven.bluebillywig.com/releases";
+const BB_MAVEN_COMMENT = "// Blue Billywig SDK Maven Repository";
+/**
+ * Adds the Blue Billywig Maven repository to the Android project's build.gradle
+ */
+const withAndroidBBPlayer = (config, props) => {
+    return (0, config_plugins_1.withProjectBuildGradle)(config, (config) => {
+        const mavenUrl = props.androidMavenUrl || BB_MAVEN_REPO;
+        config.modResults.contents = addBBMavenRepository(config.modResults.contents, mavenUrl);
+        return config;
+    });
+};
+exports.withAndroidBBPlayer = withAndroidBBPlayer;
+/**
+ * Adds the BB Maven repository to build.gradle if not already present
+ */
+function addBBMavenRepository(buildGradle, mavenUrl) {
+    // Check if already added
+    if (buildGradle.includes("maven.bluebillywig.com") || buildGradle.includes(mavenUrl)) {
+        return buildGradle;
+    }
+    const mavenBlock = `
+        ${BB_MAVEN_COMMENT}
+        maven {
+            url "${mavenUrl}"
+        }`;
+    // Find allprojects { repositories { ... } } block and add maven repo
+    // Pattern: allprojects { ... repositories { ... } }
+    const allProjectsRepoPattern = /allprojects\s*\{[^}]*repositories\s*\{/;
+    if (allProjectsRepoPattern.test(buildGradle)) {
+        // Add after the opening of repositories block in allprojects
+        return buildGradle.replace(allProjectsRepoPattern, (match) => `${match}${mavenBlock}`);
+    }
+    // For newer Gradle/React Native versions, repositories might be in settings.gradle
+    // or managed differently. Try to find any repositories block.
+    const repoPattern = /repositories\s*\{/;
+    if (repoPattern.test(buildGradle)) {
+        // Find the last repositories block (usually the one in allprojects or dependencyResolutionManagement)
+        const matches = buildGradle.match(/repositories\s*\{/g);
+        if (matches && matches.length > 0) {
+            // Replace the last occurrence
+            const lastIndex = buildGradle.lastIndexOf("repositories {");
+            if (lastIndex !== -1) {
+                return (buildGradle.slice(0, lastIndex + "repositories {".length) +
+                    mavenBlock +
+                    buildGradle.slice(lastIndex + "repositories {".length));
+            }
+        }
+    }
+    // If no repositories block found, warn and return unchanged
+    console.warn("[@bluebillywig/react-native-bb-player] Could not find repositories block in build.gradle. " +
+        "You may need to manually add the Blue Billywig Maven repository.");
+    return buildGradle;
+}

package/plugin/build/withIos.d.ts

@@ -0,0 +1,7 @@
+import { ConfigPlugin } from "expo/config-plugins";
+import type { BBPlayerPluginProps } from "./index";
+/**
+ * Configures iOS for the Blue Billywig Player SDK
+ */
+export declare const withIosBBPlayer: ConfigPlugin<BBPlayerPluginProps>;
+//# sourceMappingURL=withIos.d.ts.map

package/plugin/build/withIos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withIos.d.ts","sourceRoot":"","sources":["../src/withIos.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAIb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAKnD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,mBAAmB,CAa7D,CAAC"}

package/plugin/build/withIos.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withIosBBPlayer = void 0;
+const config_plugins_1 = require("expo/config-plugins");
+const BB_POD_SOURCE = "https://github.com/nickkraakman/test-specs.git";
+const BB_POD_COMMENT = "# Blue Billywig SDK Pod Source";
+/**
+ * Configures iOS for the Blue Billywig Player SDK
+ */
+const withIosBBPlayer = (config, props) => {
+    // Add BB pod source to Podfile
+    config = withBBPodSource(config);
+    // Optionally add background audio capability
+    if (props.enableBackgroundAudio) {
+        config = withBackgroundAudio(config);
+    }
+    return config;
+};
+exports.withIosBBPlayer = withIosBBPlayer;
+/**
+ * Adds the Blue Billywig CocoaPods source to the Podfile
+ */
+const withBBPodSource = (config) => {
+    return (0, config_plugins_1.withPodfile)(config, (config) => {
+        const podfile = config.modResults.contents;
+        // Check if already added
+        if (podfile.includes(BB_POD_SOURCE)) {
+            return config;
+        }
+        // Add source at the top of the Podfile (after any existing sources)
+        const sourceBlock = `${BB_POD_COMMENT}\nsource '${BB_POD_SOURCE}'\n`;
+        // Check if there's already a source line
+        if (podfile.includes("source '")) {
+            // Add after existing sources
+            const lastSourceIndex = podfile.lastIndexOf("source '");
+            const endOfLine = podfile.indexOf("\n", lastSourceIndex);
+            config.modResults.contents =
+                podfile.slice(0, endOfLine + 1) +
+                    sourceBlock +
+                    podfile.slice(endOfLine + 1);
+        }
+        else {
+            // Add at the beginning
+            config.modResults.contents = sourceBlock + "\n" + podfile;
+        }
+        return config;
+    });
+};
+/**
+ * Adds UIBackgroundModes with 'audio' to Info.plist for background audio playback
+ */
+const withBackgroundAudio = (config) => {
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        const infoPlist = config.modResults;
+        // Get existing background modes or create new array
+        const existingModes = infoPlist.UIBackgroundModes || [];
+        // Add 'audio' if not already present
+        if (!existingModes.includes("audio")) {
+            infoPlist.UIBackgroundModes = [...existingModes, "audio"];
+        }
+        return config;
+    });
+};

package/react-native-bb-player.podspec

@@ -0,0 +1,29 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'react-native-bb-player'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = 'React Native Module for Blue Billywig Native Player SDK'
+  s.license        = package['license']
+  s.author         = 'Blue Billywig'
+  s.homepage       = 'https://github.com/bluebillywig/react-native-bb-player'
+  s.platforms      = { :ios => '13.4', :tvos => '13.4' }
+  s.swift_version  = '5.4'
+  s.source         = { :git => 'https://github.com/bluebillywig/react-native-bb-player.git', :tag => "v#{s.version}" }
+  s.static_framework = true
+
+  s.dependency 'React-Core'
+  s.dependency 'BlueBillywigNativePlayerKit-iOS', '~> 8.40.0'
+  s.dependency 'BlueBillywigNativePlayerKit-iOS/GoogleCastSDK', '~> 8.40.0'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    'SWIFT_COMPILATION_MODE' => 'wholemodule'
+  }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,hpp,cpp}"
+end

package/react-native.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {},
+      ios: {},
+    },
+  },
+};

package/src/BBOutstreamView.tsx

@@ -0,0 +1,333 @@
+import React, {
+  forwardRef,
+  useRef,
+  useImperativeHandle,
+  useState,
+  useCallback,
+  useEffect,
+} from 'react';
+import { Animated, LayoutAnimation, Platform, UIManager } from 'react-native';
+import BBPlayerView from './BBPlayerView';
+import type { BBPlayerViewProps, BBPlayerViewMethods } from './BBPlayer.types';
+
+// Enable LayoutAnimation on Android
+if (Platform.OS === 'android' && UIManager.setLayoutAnimationEnabledExperimental) {
+  UIManager.setLayoutAnimationEnabledExperimental(true);
+}
+
+/**
+ * Animation type for collapse/expand transitions
+ */
+export type OutstreamAnimationType = 'timing' | 'spring' | 'layout' | 'none';
+
+/**
+ * Configuration for Outstream animations
+ */
+export interface OutstreamAnimationConfig {
+  /**
+   * Type of animation to use
+   * - 'timing': Smooth linear animation (default)
+   * - 'spring': Bouncy spring animation
+   * - 'layout': Uses LayoutAnimation (simpler, may be smoother on some devices)
+   * - 'none': Instant collapse/expand with no animation
+   * @default 'timing'
+   */
+  type?: OutstreamAnimationType;
+
+  /**
+   * Duration in milliseconds (for 'timing' and 'layout' types)
+   * @default 300
+   */
+  duration?: number;
+
+  /**
+   * Spring damping (for 'spring' type only)
+   * @default 15
+   */
+  damping?: number;
+
+  /**
+   * Spring stiffness (for 'spring' type only)
+   * @default 100
+   */
+  stiffness?: number;
+}
+
+/**
+ * Props for BBOutstreamView
+ */
+export interface BBOutstreamViewProps extends Omit<BBPlayerViewProps, 'options'> {
+  /**
+   * Initial/expanded height of the player in pixels
+   * @default 200
+   */
+  expandedHeight?: number;
+
+  /**
+   * Height when collapsed in pixels
+   * @default 0
+   */
+  collapsedHeight?: number;
+
+  /**
+   * Animation configuration for collapse/expand
+   */
+  animation?: OutstreamAnimationConfig;
+
+  /**
+   * Player options. `allowCollapseExpand` is automatically set to true.
+   */
+  options?: Record<string, unknown>;
+
+  /**
+   * Called when the player requests to collapse (after animation completes)
+   */
+  onCollapsed?: () => void;
+
+  /**
+   * Called when the player requests to expand (after animation completes)
+   */
+  onExpanded?: () => void;
+
+  /**
+   * Called when collapse/expand animation starts
+   */
+  onAnimationStart?: (isCollapsing: boolean) => void;
+}
+
+/**
+ * Methods available on BBOutstreamView ref
+ */
+export interface BBOutstreamViewMethods extends BBPlayerViewMethods {
+  /**
+   * Returns whether the player is currently collapsed
+   */
+  isCollapsed: () => boolean;
+
+  /**
+   * Programmatically collapse the player with animation
+   */
+  animateCollapse: () => void;
+
+  /**
+   * Programmatically expand the player with animation
+   */
+  animateExpand: () => void;
+}
+
+/**
+ * BBOutstreamView - Convenience wrapper for Outstream advertising
+ *
+ * This component wraps BBPlayerView with automatic collapse/expand animation
+ * handling. It's designed for Outstream ad placements embedded in scrollable
+ * content like articles or feeds.
+ *
+ * @example
+ * ```tsx
+ * <ScrollView>
+ *   <Text>Article content...</Text>
+ *
+ *   <BBOutstreamView
+ *     ref={outstreamRef}
+ *     jsonUrl="https://demo.bbvms.com/a/native_sdk_outstream.json"
+ *     expandedHeight={250}
+ *     animation={{ type: 'spring', damping: 20 }}
+ *     onCollapsed={() => console.log('Player collapsed')}
+ *     onExpanded={() => console.log('Player expanded')}
+ *   />
+ *
+ *   <Text>More content...</Text>
+ * </ScrollView>
+ * ```
+ */
+const BBOutstreamView = forwardRef<BBOutstreamViewMethods, BBOutstreamViewProps>(
+  (
+    {
+      expandedHeight = 200,
+      collapsedHeight = 0,
+      animation = {},
+      options = {},
+      onCollapsed,
+      onExpanded,
+      onAnimationStart,
+      onDidRequestCollapse,
+      onDidRequestExpand,
+      style,
+      ...playerProps
+    },
+    ref
+  ) => {
+    const playerRef = useRef<BBPlayerViewMethods>(null);
+    const heightAnim = useRef(new Animated.Value(expandedHeight)).current;
+    const [isCollapsed, setIsCollapsed] = useState(false);
+
+    // Default animation config
+    const animConfig: Required<OutstreamAnimationConfig> = {
+      type: animation.type ?? 'timing',
+      duration: animation.duration ?? 300,
+      damping: animation.damping ?? 15,
+      stiffness: animation.stiffness ?? 100,
+    };
+
+    // Update animated value when expandedHeight changes
+    useEffect(() => {
+      if (!isCollapsed) {
+        heightAnim.setValue(expandedHeight);
+      }
+    }, [expandedHeight, isCollapsed, heightAnim]);
+
+    const animateToHeight = useCallback(
+      (toHeight: number, onComplete?: () => void) => {
+        const isCollapsing = toHeight === collapsedHeight;
+        onAnimationStart?.(isCollapsing);
+
+        if (animConfig.type === 'none') {
+          heightAnim.setValue(toHeight);
+          onComplete?.();
+          return;
+        }
+
+        if (animConfig.type === 'layout') {
+          LayoutAnimation.configureNext(
+            LayoutAnimation.create(
+              animConfig.duration,
+              LayoutAnimation.Types.easeInEaseOut,
+              LayoutAnimation.Properties.scaleY
+            ),
+            onComplete
+          );
+          heightAnim.setValue(toHeight);
+          return;
+        }
+
+        const animationFn =
+          animConfig.type === 'spring'
+            ? Animated.spring(heightAnim, {
+                toValue: toHeight,
+                damping: animConfig.damping,
+                stiffness: animConfig.stiffness,
+                useNativeDriver: false,
+              })
+            : Animated.timing(heightAnim, {
+                toValue: toHeight,
+                duration: animConfig.duration,
+                useNativeDriver: false,
+              });
+
+        animationFn.start(({ finished }) => {
+          if (finished) {
+            onComplete?.();
+          }
+        });
+      },
+      [heightAnim, collapsedHeight, animConfig, onAnimationStart]
+    );
+
+    const handleRequestCollapse = useCallback(() => {
+      setIsCollapsed(true);
+      animateToHeight(collapsedHeight, onCollapsed);
+      onDidRequestCollapse?.();
+    }, [animateToHeight, collapsedHeight, onCollapsed, onDidRequestCollapse]);
+
+    const handleRequestExpand = useCallback(() => {
+      setIsCollapsed(false);
+      animateToHeight(expandedHeight, onExpanded);
+      onDidRequestExpand?.();
+    }, [animateToHeight, expandedHeight, onExpanded, onDidRequestExpand]);
+
+    // Programmatic collapse/expand
+    const animateCollapse = useCallback(() => {
+      if (!isCollapsed) {
+        setIsCollapsed(true);
+        animateToHeight(collapsedHeight, onCollapsed);
+        playerRef.current?.collapse();
+      }
+    }, [isCollapsed, animateToHeight, collapsedHeight, onCollapsed]);
+
+    const animateExpand = useCallback(() => {
+      if (isCollapsed) {
+        setIsCollapsed(false);
+        animateToHeight(expandedHeight, onExpanded);
+        playerRef.current?.expand();
+      }
+    }, [isCollapsed, animateToHeight, expandedHeight, onExpanded]);
+
+    // Expose methods via ref
+    useImperativeHandle(
+      ref,
+      () => ({
+        // Pass through all BBPlayerViewMethods
+        play: () => playerRef.current?.play(),
+        pause: () => playerRef.current?.pause(),
+        seek: (position: number) => playerRef.current?.seek(position),
+        seekRelative: (offset: number) => playerRef.current?.seekRelative(offset),
+        setVolume: (volume: number) => playerRef.current?.setVolume(volume),
+        setMuted: (muted: boolean) => playerRef.current?.setMuted(muted),
+        collapse: () => playerRef.current?.collapse(),
+        expand: () => playerRef.current?.expand(),
+        enterFullscreen: () => playerRef.current?.enterFullscreen(),
+        enterFullscreenLandscape: () => playerRef.current?.enterFullscreenLandscape(),
+        exitFullscreen: () => playerRef.current?.exitFullscreen(),
+        showCastPicker: () => playerRef.current?.showCastPicker(),
+        destroy: () => playerRef.current?.destroy(),
+        autoPlayNextCancel: () => playerRef.current?.autoPlayNextCancel(),
+        loadClip: (clipId: string, opts?: Parameters<BBPlayerViewMethods['loadClip']>[1]) =>
+          playerRef.current?.loadClip(clipId, opts),
+        loadWithClipId: (...args: Parameters<BBPlayerViewMethods['loadWithClipId']>) =>
+          playerRef.current?.loadWithClipId(...args),
+        loadWithClipListId: (...args: Parameters<BBPlayerViewMethods['loadWithClipListId']>) =>
+          playerRef.current?.loadWithClipListId(...args),
+        loadWithProjectId: (...args: Parameters<BBPlayerViewMethods['loadWithProjectId']>) =>
+          playerRef.current?.loadWithProjectId(...args),
+        loadWithClipJson: (...args: Parameters<BBPlayerViewMethods['loadWithClipJson']>) =>
+          playerRef.current?.loadWithClipJson(...args),
+        loadWithClipListJson: (...args: Parameters<BBPlayerViewMethods['loadWithClipListJson']>) =>
+          playerRef.current?.loadWithClipListJson(...args),
+        loadWithProjectJson: (...args: Parameters<BBPlayerViewMethods['loadWithProjectJson']>) =>
+          playerRef.current?.loadWithProjectJson(...args),
+        loadWithJsonUrl: (...args: Parameters<BBPlayerViewMethods['loadWithJsonUrl']>) =>
+          playerRef.current?.loadWithJsonUrl(...args),
+        getDuration: () => playerRef.current?.getDuration() ?? Promise.resolve(null),
+        getCurrentTime: () => playerRef.current?.getCurrentTime() ?? Promise.resolve(null),
+        getMuted: () => playerRef.current?.getMuted() ?? Promise.resolve(null),
+        getVolume: () => playerRef.current?.getVolume() ?? Promise.resolve(null),
+        getPhase: () => playerRef.current?.getPhase() ?? Promise.resolve(null),
+        getState: () => playerRef.current?.getState() ?? Promise.resolve(null),
+        getMode: () => playerRef.current?.getMode() ?? Promise.resolve(null),
+        getClipData: () => playerRef.current?.getClipData() ?? Promise.resolve(null),
+        getProjectData: () => playerRef.current?.getProjectData() ?? Promise.resolve(null),
+        getPlayoutData: () => playerRef.current?.getPlayoutData() ?? Promise.resolve(null),
+        getPlayerState: () => playerRef.current?.getPlayerState() ?? Promise.resolve(null),
+
+        // Outstream-specific methods
+        isCollapsed: () => isCollapsed,
+        animateCollapse,
+        animateExpand,
+      }),
+      [isCollapsed, animateCollapse, animateExpand]
+    );
+
+    // Merge options with allowCollapseExpand: true
+    const outstreamOptions = {
+      ...options,
+      allowCollapseExpand: true,
+    };
+
+    return (
+      <Animated.View style={[{ height: heightAnim, overflow: 'hidden' }, style]}>
+        <BBPlayerView
+          ref={playerRef}
+          options={outstreamOptions}
+          onDidRequestCollapse={handleRequestCollapse}
+          onDidRequestExpand={handleRequestExpand}
+          style={{ flex: 1 }}
+          {...playerProps}
+        />
+      </Animated.View>
+    );
+  }
+);
+
+BBOutstreamView.displayName = 'BBOutstreamView';
+
+export default BBOutstreamView;