@bigcrunch/react-native-ads 0.1.0

package/ios/BigCrunchBannerViewManager.swift

@@ -0,0 +1,270 @@
+import Foundation
+import React
+import UIKit
+import BigCrunchAds
+import GoogleMobileAds
+
+@objc(BigCrunchBannerViewManager)
+class BigCrunchBannerViewManager: RCTViewManager {
+
+    override static func requiresMainQueueSetup() -> Bool {
+        return true
+    }
+
+    override func view() -> UIView! {
+        let wrapper = BigCrunchBannerViewWrapper()
+        wrapper.bridge = self.bridge
+        return wrapper
+    }
+
+    // Note: Property setters are handled automatically by RCT_EXPORT_VIEW_PROPERTY
+    // which sets @objc properties directly on the view
+
+    // MARK: - Command Methods
+
+    @objc func loadAd(_ node: NSNumber) {
+        DispatchQueue.main.async { [weak self] in
+            guard let view = self?.bridge?.uiManager?.view(forReactTag: node) as? BigCrunchBannerViewWrapper else { return }
+            view.loadAd()
+        }
+    }
+
+    @objc func pauseAd(_ node: NSNumber) {
+        // Pause functionality not implemented in current SDK version
+    }
+
+    @objc func resumeAd(_ node: NSNumber) {
+        // Resume functionality not implemented in current SDK version
+    }
+
+    @objc func destroy(_ node: NSNumber) {
+        DispatchQueue.main.async { [weak self] in
+            guard let view = self?.bridge?.uiManager?.view(forReactTag: node) as? BigCrunchBannerViewWrapper else { return }
+            view.destroy()
+        }
+    }
+}
+
+// MARK: - BigCrunchBannerViewWrapper
+
+class BigCrunchBannerViewWrapper: UIView {
+
+    var bannerView: BigCrunchBannerView?
+
+    @objc var placementId: String? {
+        didSet {
+            if placementId != oldValue {
+                setupBannerView()
+            }
+        }
+    }
+
+    // React Native sets "size" prop but we store as sizeString
+    @objc var size: String {
+        get { return sizeString }
+        set {
+            sizeString = newValue
+            updateAdSize()
+        }
+    }
+
+    var sizeString: String = "BANNER"
+    @objc var customWidth: NSNumber? {
+        didSet {
+            _customWidth = customWidth?.intValue
+            updateAdSize()
+        }
+    }
+    private var _customWidth: Int?
+
+    @objc var customHeight: NSNumber? {
+        didSet {
+            _customHeight = customHeight?.intValue
+            updateAdSize()
+        }
+    }
+    private var _customHeight: Int?
+
+    @objc var autoLoad: Bool = false {
+        didSet {
+            if autoLoad && placementId != nil {
+                DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
+                    self?.loadAd()
+                }
+            }
+        }
+    }
+
+    @objc var refreshInterval: NSNumber = 0
+
+    @objc var customTargeting: NSDictionary? {
+        didSet {
+            _customTargeting = customTargeting as? [String: String]
+        }
+    }
+    private var _customTargeting: [String: String]?
+
+    @objc var viewId: String?
+
+    weak var bridge: RCTBridge?
+
+    override init(frame: CGRect) {
+        super.init(frame: frame)
+        backgroundColor = .clear
+    }
+
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+
+    func setupBannerView() {
+        guard let placementId = placementId else { return }
+
+        // Remove existing banner view
+        bannerView?.removeFromSuperview()
+        bannerView = nil
+
+        // Create new banner view
+        let newBannerView = BigCrunchBannerView(frame: bounds)
+        newBannerView.configure(placementId: placementId)
+        newBannerView.delegate = self
+        newBannerView.translatesAutoresizingMaskIntoConstraints = false
+
+        addSubview(newBannerView)
+
+        // Add constraints
+        NSLayoutConstraint.activate([
+            newBannerView.leadingAnchor.constraint(equalTo: leadingAnchor),
+            newBannerView.trailingAnchor.constraint(equalTo: trailingAnchor),
+            newBannerView.topAnchor.constraint(equalTo: topAnchor),
+            newBannerView.bottomAnchor.constraint(equalTo: bottomAnchor)
+        ])
+
+        self.bannerView = newBannerView
+
+        updateAdSize()
+
+        if autoLoad {
+            loadAd()
+        }
+    }
+
+    func updateAdSize() {
+        guard let bannerView = bannerView else { return }
+
+        var adSize: GoogleMobileAds.AdSize
+        var sizeOverride: CGSize?
+
+        if let width = _customWidth, let height = _customHeight {
+            sizeOverride = CGSize(width: width, height: height)
+            adSize = GoogleMobileAds.adSizeFor(cgSize: sizeOverride!)
+        } else {
+            switch sizeString {
+            case "BANNER":
+                sizeOverride = CGSize(width: 320, height: 50)
+                adSize = GoogleMobileAds.AdSizeBanner
+            case "LARGE_BANNER":
+                sizeOverride = CGSize(width: 320, height: 100)
+                adSize = GoogleMobileAds.AdSizeLargeBanner
+            case "MEDIUM_RECTANGLE":
+                sizeOverride = CGSize(width: 300, height: 250)
+                adSize = GoogleMobileAds.AdSizeMediumRectangle
+            case "FULL_BANNER":
+                sizeOverride = CGSize(width: 468, height: 60)
+                adSize = GoogleMobileAds.AdSizeFullBanner
+            case "LEADERBOARD":
+                sizeOverride = CGSize(width: 728, height: 90)
+                adSize = GoogleMobileAds.AdSizeLeaderboard
+            case "ADAPTIVE":
+                let frame = self.frame.width > 0 ? self.frame : UIScreen.main.bounds
+                adSize = GoogleMobileAds.currentOrientationAnchoredAdaptiveBanner(width: frame.width)
+                sizeOverride = adSize.size
+            case "SMART":
+                // Smart banner is deprecated, use adaptive
+                let frame = self.frame.width > 0 ? self.frame : UIScreen.main.bounds
+                adSize = GoogleMobileAds.currentOrientationAnchoredAdaptiveBanner(width: frame.width)
+                sizeOverride = adSize.size
+            default:
+                sizeOverride = CGSize(width: 320, height: 50)
+                adSize = GoogleMobileAds.AdSizeBanner
+            }
+        }
+
+        // Set the size override on the native banner view
+        bannerView.adSizeOverride = sizeOverride
+
+        // Update frame constraints
+        if _customWidth == nil && _customHeight == nil {
+            self.frame.size = adSize.size
+        }
+    }
+
+    func loadAd() {
+        bannerView?.loadAd()
+    }
+
+    func destroy() {
+        bannerView?.destroy()
+        bannerView = nil
+    }
+
+    override func removeFromSuperview() {
+        destroy()
+        super.removeFromSuperview()
+    }
+
+    internal override func reactViewController() -> UIViewController? {
+        var responder: UIResponder? = self
+        while responder != nil {
+            if let viewController = responder as? UIViewController {
+                return viewController
+            }
+            responder = responder?.next
+        }
+        return nil
+    }
+
+    private func sendEvent(name: String, params: [String: Any]) {
+        var eventParams = params
+        eventParams["viewId"] = viewId
+        eventParams["placementId"] = placementId
+
+        // Send event through RCTEventEmitter via the bridge
+        guard let bridge = bridge,
+              let eventEmitter = bridge.module(for: BigCrunchAdsModule.self) as? RCTEventEmitter else {
+            return
+        }
+        eventEmitter.sendEvent(withName: name, body: eventParams)
+    }
+}
+
+// MARK: - BigCrunchBannerViewDelegate
+
+extension BigCrunchBannerViewWrapper: BigCrunchBannerViewDelegate {
+
+    func bannerViewDidLoadAd(_ bannerView: BigCrunchBannerView) {
+        sendEvent(name: "BigCrunchBannerAdLoaded", params: [:])
+    }
+
+    func bannerView(_ bannerView: BigCrunchBannerView, didFailToLoadWithError error: String) {
+        sendEvent(name: "BigCrunchBannerAdFailedToLoad", params: [
+            "errorCode": "LOAD_FAILED",
+            "errorMessage": error
+        ])
+    }
+
+    func bannerViewDidRecordImpression(_ bannerView: BigCrunchBannerView) {
+        sendEvent(name: "BigCrunchBannerAdImpression", params: [:])
+    }
+
+    func bannerViewDidRecordClick(_ bannerView: BigCrunchBannerView) {
+        sendEvent(name: "BigCrunchBannerAdClicked", params: [:])
+    }
+
+    // Note: The native SDK doesn't provide these events yet, but we can add them later
+    // when the SDK supports them:
+    // - BigCrunchBannerAdOpened
+    // - BigCrunchBannerAdClosed
+    // - BigCrunchBannerAdRevenue
+    // - BigCrunchBannerAdViewable
+}

package/ios/react-native-bigcrunch-ads-Bridging-Header.h

@@ -0,0 +1,8 @@
+//
+//  react-native-bigcrunch-ads-Bridging-Header.h
+//  BigCrunch Mobile Ads SDK - React Native Bridge
+//
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+#import <React/RCTViewManager.h>

package/lib/BigCrunchAds.d.ts

@@ -0,0 +1,168 @@
+/**
+ * BigCrunch Mobile Ads SDK for React Native
+ * Main API class
+ */
+import type { InitializationOptions, Environment, SessionInfo, DeviceContext, AppConfig, EventSubscription } from './types';
+/**
+ * Main entry point for BigCrunch Mobile Ads SDK
+ */
+export declare class BigCrunchAds {
+    private static isInitializedFlag;
+    private static initializationPromise;
+    /**
+     * 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 initialize(propertyId: string, apiKey: string, environment?: Environment, options?: Partial<InitializationOptions>): Promise<void>;
+    /**
+     * Check if the SDK is initialized
+     */
+    static isInitialized(): Promise<boolean>;
+    /**
+     * Track a screen view for analytics
+     *
+     * @param screenName - Name of the screen being viewed
+     *
+     * @example
+     * ```typescript
+     * BigCrunchAds.trackScreenView('HomeScreen');
+     * ```
+     */
+    static trackScreenView(screenName: string): Promise<void>;
+    /**
+     * Get the current app configuration
+     * Returns null if config hasn't been loaded yet
+     */
+    static getAppConfig(): Promise<AppConfig | null>;
+    /**
+     * Force refresh the app configuration from backend
+     */
+    static refreshConfig(): Promise<void>;
+    /**
+     * Get current session information
+     */
+    static getSessionInfo(): Promise<SessionInfo>;
+    /**
+     * Start a new session (usually handled automatically)
+     */
+    static startNewSession(): Promise<void>;
+    /**
+     * Get device context information
+     */
+    static getDeviceContext(): Promise<DeviceContext>;
+    /**
+     * Set GDPR consent string
+     *
+     * @param consent - GDPR consent string
+     */
+    static setGdprConsent(consent: string): Promise<void>;
+    /**
+     * Set CCPA compliance string
+     *
+     * @param ccpaString - CCPA string (e.g., "1YNN")
+     */
+    static setCcpaString(ccpaString: string): Promise<void>;
+    /**
+     * Set COPPA compliance
+     *
+     * @param isCompliant - Whether the app is COPPA compliant
+     */
+    static setCoppaCompliant(isCompliant: boolean): Promise<void>;
+    /**
+     * Enable or disable debug mode
+     *
+     * @param enabled - Whether to enable debug mode
+     */
+    static setDebugMode(enabled: boolean): Promise<void>;
+    /**
+     * Add a test device ID for testing ads
+     *
+     * @param deviceId - Device ID to add as test device
+     */
+    static addTestDevice(deviceId: string): Promise<void>;
+    /**
+     * Remove a test device ID
+     *
+     * @param deviceId - Device ID to remove from test devices
+     */
+    static removeTestDevice(deviceId: string): Promise<void>;
+    /**
+     * Get list of test device IDs
+     */
+    static getTestDevices(): Promise<string[]>;
+    /**
+     * 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 setUTMParameters(params: {
+        source?: string;
+        medium?: string;
+        campaign?: string;
+        term?: string;
+        content?: string;
+    }): Promise<void>;
+    /**
+     * Clear UTM parameters
+     */
+    static clearUTMParameters(): Promise<void>;
+    /**
+     * 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;
+    /**
+     * Listen for configuration updates
+     */
+    static onConfigUpdated(listener: (config: AppConfig) => void): EventSubscription;
+    /**
+     * Listen for configuration failures
+     */
+    static onConfigFailed(listener: (error: Error) => void): EventSubscription;
+    /**
+     * Listen for session start events
+     */
+    static onSessionStarted(listener: (session: SessionInfo) => void): EventSubscription;
+    /**
+     * Listen for session end events
+     */
+    static onSessionEnded(listener: (session: SessionInfo) => void): EventSubscription;
+    /**
+     * Ensure SDK is initialized before calling methods
+     * @private
+     */
+    private static ensureInitialized;
+}
+export default BigCrunchAds;
+//# sourceMappingURL=BigCrunchAds.d.ts.map

package/lib/BigCrunchAds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BigCrunchAds.d.ts","sourceRoot":"","sources":["../src/BigCrunchAds.ts"],"names":[],"mappings":"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"}

package/lib/BigCrunchAds.js

@@ -0,0 +1,241 @@
+/**
+ * BigCrunch Mobile Ads SDK for React Native
+ * Main API class
+ */
+import { NativeBigCrunchAds, BigCrunchAdsEventEmitter, NativeEventNames, } from './NativeBigCrunchAds';
+/**
+ * Main entry point for BigCrunch Mobile Ads SDK
+ */
+export class BigCrunchAds {
+    static isInitializedFlag = false;
+    static initializationPromise = 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, apiKey, environment = 'production', options) {
+        if (this.isInitializedFlag) {
+            console.warn('BigCrunchAds: SDK is already initialized');
+            return this.initializationPromise;
+        }
+        const initOptions = {
+            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() {
+        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) {
+        this.ensureInitialized();
+        return NativeBigCrunchAds.trackScreenView(screenName);
+    }
+    /**
+     * Get the current app configuration
+     * Returns null if config hasn't been loaded yet
+     */
+    static async getAppConfig() {
+        this.ensureInitialized();
+        return NativeBigCrunchAds.getAppConfig();
+    }
+    /**
+     * Force refresh the app configuration from backend
+     */
+    static async refreshConfig() {
+        this.ensureInitialized();
+        return NativeBigCrunchAds.refreshConfig();
+    }
+    /**
+     * Get current session information
+     */
+    static async getSessionInfo() {
+        this.ensureInitialized();
+        return NativeBigCrunchAds.getSessionInfo();
+    }
+    /**
+     * Start a new session (usually handled automatically)
+     */
+    static async startNewSession() {
+        this.ensureInitialized();
+        return NativeBigCrunchAds.startNewSession();
+    }
+    /**
+     * Get device context information
+     */
+    static async getDeviceContext() {
+        return NativeBigCrunchAds.getDeviceContext();
+    }
+    /**
+     * Set GDPR consent string
+     *
+     * @param consent - GDPR consent string
+     */
+    static async setGdprConsent(consent) {
+        return NativeBigCrunchAds.setGdprConsent(consent);
+    }
+    /**
+     * Set CCPA compliance string
+     *
+     * @param ccpaString - CCPA string (e.g., "1YNN")
+     */
+    static async setCcpaString(ccpaString) {
+        return NativeBigCrunchAds.setCcpaString(ccpaString);
+    }
+    /**
+     * Set COPPA compliance
+     *
+     * @param isCompliant - Whether the app is COPPA compliant
+     */
+    static async setCoppaCompliant(isCompliant) {
+        return NativeBigCrunchAds.setCoppaCompliant(isCompliant);
+    }
+    /**
+     * Enable or disable debug mode
+     *
+     * @param enabled - Whether to enable debug mode
+     */
+    static async setDebugMode(enabled) {
+        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) {
+        return NativeBigCrunchAds.addTestDevice(deviceId);
+    }
+    /**
+     * Remove a test device ID
+     *
+     * @param deviceId - Device ID to remove from test devices
+     */
+    static async removeTestDevice(deviceId) {
+        return NativeBigCrunchAds.removeTestDevice(deviceId);
+    }
+    /**
+     * Get list of test device IDs
+     */
+    static async getTestDevices() {
+        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) {
+        return NativeBigCrunchAds.setUTMParameters(params);
+    }
+    /**
+     * Clear UTM parameters
+     */
+    static async clearUTMParameters() {
+        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, listener) {
+        const subscription = BigCrunchAdsEventEmitter.addListener(eventName, listener);
+        return {
+            remove: () => subscription.remove(),
+        };
+    }
+    /**
+     * Listen for configuration updates
+     */
+    static onConfigUpdated(listener) {
+        return this.addEventListener(NativeEventNames.CONFIG_UPDATED, listener);
+    }
+    /**
+     * Listen for configuration failures
+     */
+    static onConfigFailed(listener) {
+        return this.addEventListener(NativeEventNames.CONFIG_FAILED, listener);
+    }
+    /**
+     * Listen for session start events
+     */
+    static onSessionStarted(listener) {
+        return this.addEventListener(NativeEventNames.SESSION_STARTED, listener);
+    }
+    /**
+     * Listen for session end events
+     */
+    static onSessionEnded(listener) {
+        return this.addEventListener(NativeEventNames.SESSION_ENDED, listener);
+    }
+    /**
+     * Ensure SDK is initialized before calling methods
+     * @private
+     */
+    static ensureInitialized() {
+        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;