@bigcrunch/react-native-ads 0.1.0

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@bigcrunch/react-native-ads",
+  "version": "0.1.0",
+  "description": "BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with Prebid and Google Ad Manager",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js",
+      "react-native": "./src/index.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "lib",
+    "android/src",
+    "android/build.gradle",
+    "android/settings.gradle",
+    "ios/*.swift",
+    "ios/*.m",
+    "ios/*.h",
+    "react-native-bigcrunch-ads.podspec",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "typescript": "tsc --noEmit",
+    "build": "tsc",
+    "prepare": "npm run build || echo 'Build skipped during install'",
+    "release": "release-it",
+    "example": "yarn --cwd example",
+    "clean": "del-cli lib"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "ads",
+    "advertising",
+    "monetization",
+    "prebid",
+    "google-ad-manager",
+    "gam",
+    "banner",
+    "interstitial",
+    "rewarded",
+    "bigcrunch"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bigcrunch/mobile-ads-sdk.git"
+  },
+  "author": "BigCrunch <support@bigcrunch.com> (https://www.bigcrunch.com)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/bigcrunch/mobile-ads-sdk/issues"
+  },
+  "homepage": "https://github.com/bigcrunch/mobile-ads-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.0",
+    "del-cli": "^5.0.0",
+    "release-it": "^15.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    },
+    "react-native": {
+      "optional": false
+    }
+  }
+}

package/react-native-bigcrunch-ads.podspec

@@ -0,0 +1,27 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-bigcrunch-ads"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.description  = <<-DESC
+                  BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with Prebid and Google Ad Manager
+                   DESC
+  s.homepage     = "https://github.com/bigcrunch/mobile-ads-sdk"
+  s.license      = "MIT"
+  s.authors      = { "BigCrunch" => "support@bigcrunch.com" }
+  s.platforms    = { :ios => "13.0" }
+  s.source       = { :git => "https://github.com/bigcrunch/mobile-ads-sdk.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,c,cc,cpp,m,mm,swift}"
+  s.requires_arc = true
+
+  s.dependency "React"
+  s.dependency "BigCrunchAds", "~> 0.1.0"  # Reference to main iOS SDK
+  s.dependency "Google-Mobile-Ads-SDK", ">= 10.14.0"
+  s.dependency "PrebidMobile", "~> 2.1.6"
+
+  s.swift_version = "5.9"
+end

package/src/BigCrunchAds.ts

@@ -0,0 +1,298 @@
+/**
+ * BigCrunch Mobile Ads SDK for React Native
+ * Main API class
+ */
+
+import {
+  NativeBigCrunchAds,
+  BigCrunchAdsEventEmitter,
+  NativeEventNames,
+} from './NativeBigCrunchAds';
+import type {
+  InitializationOptions,
+  Environment,
+  SessionInfo,
+  DeviceContext,
+  AppConfig,
+  EventSubscription,
+} from './types';
+
+/**
+ * Main entry point for BigCrunch Mobile Ads SDK
+ */
+export class BigCrunchAds {
+  private static isInitializedFlag = false;
+  private static initializationPromise: Promise<void> | null = null;
+
+  /**
+   * Initialize the BigCrunch Ads SDK
+   * Must be called before using any other SDK features
+   *
+   * @param propertyId - Your BigCrunch property ID
+   * @param apiKey - Your API key for authentication
+   * @param environment - Environment to use (default: 'production')
+   * @param options - Additional initialization options
+   *
+   * @example
+   * ```typescript
+   * await BigCrunchAds.initialize(
+   *   'your-property-id',
+   *   'your-api-key',
+   *   'production'
+   * );
+   * ```
+   */
+  static async initialize(
+    propertyId: string,
+    apiKey: string,
+    environment: Environment = 'production',
+    options?: Partial<InitializationOptions>
+  ): Promise<void> {
+    if (this.isInitializedFlag) {
+      console.warn('BigCrunchAds: SDK is already initialized');
+      return this.initializationPromise!;
+    }
+
+    const initOptions: InitializationOptions = {
+      propertyId,
+      apiKey,
+      environment,
+      ...options,
+    };
+
+    this.initializationPromise = NativeBigCrunchAds.initialize(initOptions)
+      .then(() => {
+        this.isInitializedFlag = true;
+        console.log('BigCrunchAds: SDK initialized successfully');
+      })
+      .catch((error) => {
+        this.isInitializedFlag = false;
+        this.initializationPromise = null;
+        throw error;
+      });
+
+    return this.initializationPromise;
+  }
+
+  /**
+   * Check if the SDK is initialized
+   */
+  static async isInitialized(): Promise<boolean> {
+    if (this.isInitializedFlag) {
+      return true;
+    }
+    return NativeBigCrunchAds.isInitialized();
+  }
+
+  /**
+   * Track a screen view for analytics
+   *
+   * @param screenName - Name of the screen being viewed
+   *
+   * @example
+   * ```typescript
+   * BigCrunchAds.trackScreenView('HomeScreen');
+   * ```
+   */
+  static async trackScreenView(screenName: string): Promise<void> {
+    this.ensureInitialized();
+    return NativeBigCrunchAds.trackScreenView(screenName);
+  }
+
+  /**
+   * Get the current app configuration
+   * Returns null if config hasn't been loaded yet
+   */
+  static async getAppConfig(): Promise<AppConfig | null> {
+    this.ensureInitialized();
+    return NativeBigCrunchAds.getAppConfig();
+  }
+
+  /**
+   * Force refresh the app configuration from backend
+   */
+  static async refreshConfig(): Promise<void> {
+    this.ensureInitialized();
+    return NativeBigCrunchAds.refreshConfig();
+  }
+
+  /**
+   * Get current session information
+   */
+  static async getSessionInfo(): Promise<SessionInfo> {
+    this.ensureInitialized();
+    return NativeBigCrunchAds.getSessionInfo();
+  }
+
+  /**
+   * Start a new session (usually handled automatically)
+   */
+  static async startNewSession(): Promise<void> {
+    this.ensureInitialized();
+    return NativeBigCrunchAds.startNewSession();
+  }
+
+  /**
+   * Get device context information
+   */
+  static async getDeviceContext(): Promise<DeviceContext> {
+    return NativeBigCrunchAds.getDeviceContext();
+  }
+
+  /**
+   * Set GDPR consent string
+   *
+   * @param consent - GDPR consent string
+   */
+  static async setGdprConsent(consent: string): Promise<void> {
+    return NativeBigCrunchAds.setGdprConsent(consent);
+  }
+
+  /**
+   * Set CCPA compliance string
+   *
+   * @param ccpaString - CCPA string (e.g., "1YNN")
+   */
+  static async setCcpaString(ccpaString: string): Promise<void> {
+    return NativeBigCrunchAds.setCcpaString(ccpaString);
+  }
+
+  /**
+   * Set COPPA compliance
+   *
+   * @param isCompliant - Whether the app is COPPA compliant
+   */
+  static async setCoppaCompliant(isCompliant: boolean): Promise<void> {
+    return NativeBigCrunchAds.setCoppaCompliant(isCompliant);
+  }
+
+  /**
+   * Enable or disable debug mode
+   *
+   * @param enabled - Whether to enable debug mode
+   */
+  static async setDebugMode(enabled: boolean): Promise<void> {
+    return NativeBigCrunchAds.setDebugMode(enabled);
+  }
+
+  /**
+   * Add a test device ID for testing ads
+   *
+   * @param deviceId - Device ID to add as test device
+   */
+  static async addTestDevice(deviceId: string): Promise<void> {
+    return NativeBigCrunchAds.addTestDevice(deviceId);
+  }
+
+  /**
+   * Remove a test device ID
+   *
+   * @param deviceId - Device ID to remove from test devices
+   */
+  static async removeTestDevice(deviceId: string): Promise<void> {
+    return NativeBigCrunchAds.removeTestDevice(deviceId);
+  }
+
+  /**
+   * Get list of test device IDs
+   */
+  static async getTestDevices(): Promise<string[]> {
+    return NativeBigCrunchAds.getTestDevices();
+  }
+
+  /**
+   * Set UTM parameters for attribution tracking
+   *
+   * These parameters are persisted and used for all analytics events.
+   * Typically set from deep link parameters.
+   *
+   * @param params - UTM parameters object
+   *
+   * @example
+   * ```typescript
+   * BigCrunchAds.setUTMParameters({
+   *   source: 'google',
+   *   medium: 'cpc',
+   *   campaign: 'summer_sale',
+   *   term: 'running shoes',
+   *   content: 'variant_a'
+   * });
+   * ```
+   */
+  static async setUTMParameters(params: {
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+  }): Promise<void> {
+    return NativeBigCrunchAds.setUTMParameters(params);
+  }
+
+  /**
+   * Clear UTM parameters
+   */
+  static async clearUTMParameters(): Promise<void> {
+    return NativeBigCrunchAds.clearUTMParameters();
+  }
+
+  /**
+   * Add a global event listener
+   *
+   * @param eventName - Native event name to listen to
+   * @param listener - Callback function
+   * @returns Subscription object with remove() method
+   */
+  static addEventListener(
+    eventName: string,
+    listener: (event: any) => void
+  ): EventSubscription {
+    const subscription = BigCrunchAdsEventEmitter.addListener(eventName, listener);
+    return {
+      remove: () => subscription.remove(),
+    };
+  }
+
+  /**
+   * Listen for configuration updates
+   */
+  static onConfigUpdated(listener: (config: AppConfig) => void): EventSubscription {
+    return this.addEventListener(NativeEventNames.CONFIG_UPDATED, listener);
+  }
+
+  /**
+   * Listen for configuration failures
+   */
+  static onConfigFailed(listener: (error: Error) => void): EventSubscription {
+    return this.addEventListener(NativeEventNames.CONFIG_FAILED, listener);
+  }
+
+  /**
+   * Listen for session start events
+   */
+  static onSessionStarted(listener: (session: SessionInfo) => void): EventSubscription {
+    return this.addEventListener(NativeEventNames.SESSION_STARTED, listener);
+  }
+
+  /**
+   * Listen for session end events
+   */
+  static onSessionEnded(listener: (session: SessionInfo) => void): EventSubscription {
+    return this.addEventListener(NativeEventNames.SESSION_ENDED, listener);
+  }
+
+  /**
+   * Ensure SDK is initialized before calling methods
+   * @private
+   */
+  private static ensureInitialized(): void {
+    if (!this.isInitializedFlag && !this.initializationPromise) {
+      throw new Error(
+        'BigCrunchAds: SDK is not initialized. Call BigCrunchAds.initialize() first.'
+      );
+    }
+  }
+}
+
+// Export as default for convenience
+export default BigCrunchAds;

package/src/BigCrunchBannerView.tsx

@@ -0,0 +1,262 @@
+/**
+ * BigCrunchBannerView - React Native component for displaying banner ads
+ */
+
+import React, { useEffect, useRef, useCallback, useMemo } from 'react';
+import {
+  requireNativeComponent,
+  ViewStyle,
+  StyleSheet,
+  findNodeHandle,
+  UIManager,
+} from 'react-native';
+import { BigCrunchAdsEventEmitter, NativeEventNames } from './NativeBigCrunchAds';
+import type {
+  BigCrunchBannerViewProps,
+  BannerSize,
+  AdError,
+  AdRevenue,
+  EventSubscription,
+} from './types';
+
+// Native component name
+const NATIVE_COMPONENT_NAME = 'BigCrunchBannerView';
+
+// Banner size dimensions
+const BANNER_SIZES = {
+  BANNER: { width: 320, height: 50 },
+  LARGE_BANNER: { width: 320, height: 100 },
+  MEDIUM_RECTANGLE: { width: 300, height: 250 },
+  FULL_BANNER: { width: 468, height: 60 },
+  LEADERBOARD: { width: 728, height: 90 },
+  ADAPTIVE: { width: -1, height: -1 }, // Calculated dynamically
+  SMART: { width: -1, height: -1 }, // Deprecated, use ADAPTIVE
+};
+
+// Native view component
+const NativeBannerView = requireNativeComponent<any>(NATIVE_COMPONENT_NAME);
+
+/**
+ * React component for displaying BigCrunch banner ads
+ *
+ * @example
+ * ```tsx
+ * <BigCrunchBannerView
+ *   placementId="banner-home"
+ *   size="BANNER"
+ *   onAdLoaded={() => console.log('Ad loaded')}
+ *   onAdFailedToLoad={(error) => console.error('Ad failed to load', error)}
+ * />
+ * ```
+ */
+export const BigCrunchBannerView: React.FC<BigCrunchBannerViewProps> = ({
+  placementId,
+  size = 'BANNER',
+  autoLoad = true,
+  refreshInterval = 0,
+  customTargeting,
+  style,
+  onAdLoaded,
+  onAdFailedToLoad,
+  onAdImpression,
+  onAdClicked,
+  onAdOpened,
+  onAdClosed,
+  onAdRevenue,
+}) => {
+  const viewRef = useRef<any>(null);
+  const subscriptionsRef = useRef<EventSubscription[]>([]);
+  const viewIdRef = useRef<string>(`banner_${placementId}_${Date.now()}`);
+
+  // Calculate banner size
+  const bannerSize = useMemo(() => {
+    if (typeof size === 'object' && 'width' in size && 'height' in size) {
+      // Custom size
+      return size;
+    } else if (typeof size === 'string' && size in BANNER_SIZES) {
+      // Predefined size
+      const dimensions = BANNER_SIZES[size as BannerSize];
+      if (dimensions.width === -1 || dimensions.height === -1) {
+        // Adaptive/Smart banner - will be calculated natively
+        return { width: 0, height: 0, adaptive: true };
+      }
+      return dimensions;
+    }
+    // Default to BANNER size
+    return BANNER_SIZES.BANNER;
+  }, [size]);
+
+  // Handle native events
+  const handleNativeEvent = useCallback((_eventName: string, handler?: Function) => {
+    return (event: any) => {
+      // Check if event is for this specific banner view
+      if (event.viewId === viewIdRef.current || event.placementId === placementId) {
+        handler?.(event);
+      }
+    };
+  }, [placementId]);
+
+  // Setup event listeners
+  useEffect(() => {
+    const subscriptions: EventSubscription[] = [];
+
+    if (onAdLoaded) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_LOADED,
+          handleNativeEvent(NativeEventNames.BANNER_AD_LOADED, onAdLoaded)
+        )
+      );
+    }
+
+    if (onAdFailedToLoad) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_FAILED_TO_LOAD,
+          handleNativeEvent(NativeEventNames.BANNER_AD_FAILED_TO_LOAD, (event: any) => {
+            const error: AdError = {
+              code: event.errorCode || 'UNKNOWN',
+              message: event.errorMessage || 'Ad failed to load',
+              underlyingError: event.underlyingError,
+            };
+            onAdFailedToLoad(error);
+          })
+        )
+      );
+    }
+
+    if (onAdImpression) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_IMPRESSION,
+          handleNativeEvent(NativeEventNames.BANNER_AD_IMPRESSION, onAdImpression)
+        )
+      );
+    }
+
+    if (onAdClicked) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_CLICKED,
+          handleNativeEvent(NativeEventNames.BANNER_AD_CLICKED, onAdClicked)
+        )
+      );
+    }
+
+    if (onAdOpened) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_OPENED,
+          handleNativeEvent(NativeEventNames.BANNER_AD_OPENED, onAdOpened)
+        )
+      );
+    }
+
+    if (onAdClosed) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_CLOSED,
+          handleNativeEvent(NativeEventNames.BANNER_AD_CLOSED, onAdClosed)
+        )
+      );
+    }
+
+    if (onAdRevenue) {
+      subscriptions.push(
+        BigCrunchAdsEventEmitter.addListener(
+          NativeEventNames.BANNER_AD_REVENUE,
+          handleNativeEvent(NativeEventNames.BANNER_AD_REVENUE, (event: any) => {
+            const revenue: AdRevenue = {
+              valueMicros: event.valueMicros,
+              currencyCode: event.currencyCode,
+              adUnitId: event.adUnitId,
+              precision: event.precision,
+            };
+            onAdRevenue(revenue);
+          })
+        )
+      );
+    }
+
+    subscriptionsRef.current = subscriptions;
+
+    // Cleanup on unmount
+    return () => {
+      subscriptions.forEach(sub => sub.remove());
+      subscriptionsRef.current = [];
+    };
+  }, [
+    placementId,
+    handleNativeEvent,
+    onAdLoaded,
+    onAdFailedToLoad,
+    onAdImpression,
+    onAdClicked,
+    onAdOpened,
+    onAdClosed,
+    onAdRevenue,
+  ]);
+
+  // Load ad programmatically
+  const loadAd = useCallback(() => {
+    if (viewRef.current) {
+      const handle = findNodeHandle(viewRef.current);
+      if (handle) {
+        const viewManagerConfig = UIManager.getViewManagerConfig(NATIVE_COMPONENT_NAME);
+        const command = viewManagerConfig?.Commands?.loadAd;
+        if (command !== undefined) {
+          UIManager.dispatchViewManagerCommand(handle, command, []);
+        }
+      }
+    }
+  }, []);
+
+  // Auto-load ad on mount if enabled
+  useEffect(() => {
+    if (autoLoad) {
+      // Delay to ensure native view is ready
+      const timer = setTimeout(loadAd, 100);
+      return () => clearTimeout(timer);
+    }
+    return undefined;
+  }, [autoLoad, loadAd]);
+
+  // Container styles
+  const containerStyle: ViewStyle = useMemo(() => {
+    const baseStyle: ViewStyle = {
+      width: bannerSize.width > 0 ? bannerSize.width : 320,
+      height: bannerSize.height > 0 ? bannerSize.height : 50,
+      // Remove overflow: 'hidden' to avoid clipping the ad content
+    };
+
+    if ((bannerSize as any).adaptive) {
+      // Adaptive banner - let it size itself
+      baseStyle.alignSelf = 'stretch';
+      baseStyle.width = '100%';
+    }
+
+    return StyleSheet.flatten([baseStyle, style]);
+  }, [bannerSize, style]);
+
+  // Native view props
+  // Always pass explicit dimensions to the native view
+  const nativeProps = {
+    ref: viewRef,
+    style: containerStyle,
+    placementId,
+    size: typeof size === 'string' ? size : 'CUSTOM',
+    // Always pass width and height, even for standard sizes
+    customWidth: bannerSize.width > 0 ? bannerSize.width : undefined,
+    customHeight: bannerSize.height > 0 ? bannerSize.height : undefined,
+    autoLoad,
+    refreshInterval,
+    customTargeting,
+    viewId: viewIdRef.current,
+  };
+
+  // Return the native view directly with the container style
+  return <NativeBannerView {...nativeProps} />;
+};
+
+// Export as default
+export default BigCrunchBannerView;