@bigcrunch/react-native-ads 0.4.0 → 0.6.0

package/ios/BigCrunchAds/Sources/Models/AppConfig.swift

@@ -0,0 +1,97 @@
+import Foundation
+
+/**
+ * Top-level application configuration returned from the BigCrunch backend
+ *
+ * This config contains all placement definitions and is fetched once at SDK initialization
+ * and cached for subsequent sessions.
+ */
+public struct AppConfig: Codable {
+    public let propertyId: String
+    public let appName: String
+    public let gamNetworkCode: String
+    public let s2s: S2SConfig
+    public let bidders: [String: BidderEntry]?
+    public let amazonAps: GlobalAmazonConfig?
+    public let useTestAds: Bool
+    public let refresh: RefreshConfig?
+    public let placements: [PlacementConfig]
+
+    public init(
+        propertyId: String,
+        appName: String,
+        gamNetworkCode: String,
+        s2s: S2SConfig,
+        bidders: [String: BidderEntry]? = nil,
+        amazonAps: GlobalAmazonConfig?,
+        useTestAds: Bool = false,
+        refresh: RefreshConfig? = nil,
+        placements: [PlacementConfig]
+    ) {
+        self.propertyId = propertyId
+        self.appName = appName
+        self.gamNetworkCode = gamNetworkCode
+        self.s2s = s2s
+        self.bidders = bidders
+        self.amazonAps = amazonAps
+        self.useTestAds = useTestAds
+        self.refresh = refresh
+        self.placements = placements
+    }
+
+}
+
+/**
+ * S2S (server-to-server) auction configuration
+ *
+ * Controls the connection to the BigCrunch S2S endpoint for bid requests.
+ */
+public struct S2SConfig: Codable {
+    public let enabled: Bool
+    public let serverUrl: String
+    public let timeoutMs: Int
+
+    public init(enabled: Bool = true, serverUrl: String, timeoutMs: Int) {
+        self.enabled = enabled
+        self.serverUrl = serverUrl
+        self.timeoutMs = timeoutMs
+    }
+
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        enabled = try container.decodeIfPresent(Bool.self, forKey: .enabled) ?? true
+        serverUrl = try container.decode(String.self, forKey: .serverUrl)
+        timeoutMs = try container.decode(Int.self, forKey: .timeoutMs)
+    }
+}
+
+/**
+ * Top-level bidder entry with shared params and per-placement params
+ *
+ * Each bidder has optional shared params (applied to all impressions) and
+ * a placements map (placementId → imp-level params for that bidder).
+ */
+public struct BidderEntry: Codable {
+    public let params: [String: AnyCodable]?
+    public let placements: [String: [String: AnyCodable]]?
+
+    public init(params: [String: AnyCodable]?, placements: [String: [String: AnyCodable]]?) {
+        self.params = params
+        self.placements = placements
+    }
+}
+
+/**
+ * Global Amazon APS configuration
+ */
+public struct GlobalAmazonConfig: Codable {
+    public let enabled: Bool
+    public let pubId: String
+    public let timeout: Int
+
+    public init(enabled: Bool, pubId: String, timeout: Int) {
+        self.enabled = enabled
+        self.pubId = pubId
+        self.timeout = timeout
+    }
+}

package/ios/BigCrunchAds/Sources/Models/DeviceData.swift

@@ -0,0 +1,68 @@
+import Foundation
+
+/**
+ * Device information for analytics and ad targeting
+ *
+ * Contains device hardware and software information used for analytics
+ * and can be exposed to React Native.
+ */
+public struct DeviceData {
+    /// Persistent device identifier (same as userId from SessionManager)
+    public let deviceId: String
+
+    /// Device model identifier (e.g., "iPhone14,2")
+    public let deviceModel: String
+
+    /// Operating system version (e.g., "17.0")
+    public let osVersion: String
+
+    /// App version string (e.g., "1.2.3")
+    public let appVersion: String
+
+    /// Screen width in points
+    public let screenWidth: Int
+
+    /// Screen height in points
+    public let screenHeight: Int
+
+    /// User's language code (e.g., "en")
+    public let language: String
+
+    /// User's country code (e.g., "US")
+    public let country: String
+
+    /// Whether the device is a tablet
+    public let isTablet: Bool
+
+    /// Mobile carrier name (if available)
+    public let carrier: String?
+
+    /// Network connection type (e.g., "wifi", "cellular")
+    public let networkType: String?
+
+    public init(
+        deviceId: String,
+        deviceModel: String,
+        osVersion: String,
+        appVersion: String,
+        screenWidth: Int,
+        screenHeight: Int,
+        language: String,
+        country: String,
+        isTablet: Bool,
+        carrier: String? = nil,
+        networkType: String? = nil
+    ) {
+        self.deviceId = deviceId
+        self.deviceModel = deviceModel
+        self.osVersion = osVersion
+        self.appVersion = appVersion
+        self.screenWidth = screenWidth
+        self.screenHeight = screenHeight
+        self.language = language
+        self.country = country
+        self.isTablet = isTablet
+        self.carrier = carrier
+        self.networkType = networkType
+    }
+}

package/ios/BigCrunchAds/Sources/Models/PlacementConfig.swift

@@ -0,0 +1,137 @@
+import Foundation
+
+/**
+ * Configuration for a single ad placement
+ *
+ * Contains all information needed to request and display an ad at a specific
+ * location in the app. Bidder configuration is no longer stored here — it lives
+ * in the top-level `AppConfig.bidders` dictionary.
+ */
+public struct PlacementConfig: Codable {
+    public let placementId: String
+    public let format: String // "banner", "interstitial", "rewarded"
+    public let gamAdUnit: String
+    public let sizes: [AdSize]?
+    public let refresh: RefreshConfig?
+
+    public init(
+        placementId: String,
+        format: String,
+        gamAdUnit: String,
+        sizes: [AdSize]?,
+        refresh: RefreshConfig? = nil
+    ) {
+        self.placementId = placementId
+        self.format = format
+        self.gamAdUnit = gamAdUnit
+        self.sizes = sizes
+        self.refresh = refresh
+    }
+}
+
+/**
+ * Type-erased Codable wrapper for arbitrary JSON values
+ *
+ * Supports String, Int, Double, Bool, nested objects, and arrays.
+ */
+public struct AnyCodable: Codable, Equatable {
+    public let value: Any
+
+    public init(_ value: Any) {
+        self.value = value
+    }
+
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        if let intVal = try? container.decode(Int.self) {
+            value = intVal
+        } else if let doubleVal = try? container.decode(Double.self) {
+            value = doubleVal
+        } else if let boolVal = try? container.decode(Bool.self) {
+            value = boolVal
+        } else if let stringVal = try? container.decode(String.self) {
+            value = stringVal
+        } else if let arrayVal = try? container.decode([AnyCodable].self) {
+            value = arrayVal.map { $0.value }
+        } else if let dictVal = try? container.decode([String: AnyCodable].self) {
+            value = dictVal.mapValues { $0.value }
+        } else {
+            throw DecodingError.dataCorruptedError(in: container, debugDescription: "Unsupported JSON value")
+        }
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.singleValueContainer()
+        switch value {
+        case let intVal as Int:
+            try container.encode(intVal)
+        case let doubleVal as Double:
+            try container.encode(doubleVal)
+        case let boolVal as Bool:
+            try container.encode(boolVal)
+        case let stringVal as String:
+            try container.encode(stringVal)
+        case let arrayVal as [Any]:
+            try container.encode(arrayVal.map { AnyCodable($0) })
+        case let dictVal as [String: Any]:
+            try container.encode(dictVal.mapValues { AnyCodable($0) })
+        default:
+            throw EncodingError.invalidValue(value, EncodingError.Context(codingPath: encoder.codingPath, debugDescription: "Unsupported value type"))
+        }
+    }
+
+    public static func == (lhs: AnyCodable, rhs: AnyCodable) -> Bool {
+        switch (lhs.value, rhs.value) {
+        case let (l as Int, r as Int): return l == r
+        case let (l as Double, r as Double): return l == r
+        case let (l as Bool, r as Bool): return l == r
+        case let (l as String, r as String): return l == r
+        default: return false
+        }
+    }
+}
+
+/**
+ * Ad size dimensions
+ *
+ * When `type` is "adaptive" or "smart", the SDK will use Google's adaptive
+ * banner API to calculate the optimal height for the given `width`.
+ * A `width` of 0 means "use screen width".
+ */
+/// Typealias for disambiguation when module name collides with BigCrunchAds class name
+public typealias BCAdSize = AdSize
+
+public struct AdSize: Codable, Equatable {
+    public let width: Int
+    public let height: Int
+    public let type: String?
+
+    public var isAdaptive: Bool {
+        type == "adaptive" || type == "smart"
+    }
+
+    public init(width: Int, height: Int, type: String? = nil) {
+        self.width = width
+        self.height = height
+        self.type = type
+    }
+
+    public static func adaptive(width: Int = 0) -> AdSize {
+        AdSize(width: width, height: 0, type: "adaptive")
+    }
+}
+
+/**
+ * Refresh configuration for banner ads
+ */
+public struct RefreshConfig: Codable {
+    public let enabled: Bool
+    public let intervalMs: Int
+    public let maxRefreshes: Int
+
+    public init(enabled: Bool, intervalMs: Int, maxRefreshes: Int) {
+        self.enabled = enabled
+        self.intervalMs = intervalMs
+        self.maxRefreshes = maxRefreshes
+    }
+}

package/ios/BigCrunchAds/Sources/Models/SessionInfo.swift

@@ -0,0 +1,48 @@
+import Foundation
+
+/**
+ * Session information for analytics tracking
+ *
+ * Provides current session state including identifiers and tracking counts.
+ * This data is used for analytics and can be exposed to React Native.
+ */
+public struct SessionInfo {
+    /// Unique identifier for the current session (changes each app launch)
+    public let sessionId: String
+
+    /// Persistent user identifier (stable across app launches)
+    public let userId: String
+
+    /// ISO 8601 timestamp when the session started
+    public let startTime: String
+
+    /// Number of screen views in this session
+    public let screenViewCount: Int
+
+    /// Number of ad requests made in this session
+    public let adRequestCount: Int
+
+    /// Number of ad impressions recorded in this session
+    public let adImpressionCount: Int
+
+    /// Total revenue in micros (1/1,000,000 of currency unit) for this session
+    public let totalRevenueMicros: Int64
+
+    public init(
+        sessionId: String,
+        userId: String,
+        startTime: String,
+        screenViewCount: Int,
+        adRequestCount: Int,
+        adImpressionCount: Int,
+        totalRevenueMicros: Int64
+    ) {
+        self.sessionId = sessionId
+        self.userId = userId
+        self.startTime = startTime
+        self.screenViewCount = screenViewCount
+        self.adRequestCount = adRequestCount
+        self.adImpressionCount = adImpressionCount
+        self.totalRevenueMicros = totalRevenueMicros
+    }
+}

package/ios/BigCrunchAdsModule.swift

@@ -1,5 +1,4 @@
 import Foundation
-import BigCrunchAds
 #if canImport(React)
 import React
 #endif
@@ -121,6 +120,26 @@ class RewardedDelegate: NSObject, BigCrunchRewardedDelegate {
     }
 }
 
+// MARK: - Initialization Callback Bridge
+
+class InitCallbackBridge: NSObject, BigCrunchInitializationCallback {
+    private let onSuccess: () -> Void
+    private let onFailure: (String) -> Void
+
+    init(onSuccess: @escaping () -> Void, onFailure: @escaping (String) -> Void) {
+        self.onSuccess = onSuccess
+        self.onFailure = onFailure
+    }
+
+    func onInitialized() {
+        onSuccess()
+    }
+
+    func onInitializationFailed(error: String) {
+        onFailure(error)
+    }
+}
+
 @objc(BigCrunchAdsModule)
 class BigCrunchAdsModule: RCTEventEmitter {
 
@@ -130,6 +149,7 @@ class BigCrunchAdsModule: RCTEventEmitter {
     var rewardedCache: [String: Any] = [:]
     private var interstitialDelegates: [String: InterstitialDelegate] = [:]
     var rewardedDelegates: [String: RewardedDelegate] = [:]
+    private var initCallbackBridge: InitCallbackBridge?
 
     override static func moduleName() -> String! {
         return "BigCrunchAdsModule"
@@ -209,17 +229,26 @@ class BigCrunchAdsModule: RCTEventEmitter {
             // Map environment strings to SDK enum - "sandbox" maps to .staging
             let env: BigCrunchEnv = environment == "sandbox" ? .staging : .prod
 
+            // Use callback to wait for config to load before resolving the promise
+            // This ensures placements are available when the app starts loading ads
+            let callbackBridge = InitCallbackBridge(
+                onSuccess: {
+                    BigCrunchAdsModule.isSDKInitialized = true
+                    resolver(nil)
+                },
+                onFailure: { error in
+                    rejecter("INIT_ERROR", "Failed to load configuration: \(error)", nil)
+                }
+            )
+            // Store strong reference so it isn't deallocated before callback fires
+            self.initCallbackBridge = callbackBridge
+
             BigCrunchAds.initialize(
                 propertyId: propertyId,
                 env: env,
-                useMockConfig: useMockConfig
+                useMockConfig: useMockConfig,
+                callback: callbackBridge
             )
-
-            // Track that we've initialized
-            BigCrunchAdsModule.isSDKInitialized = true
-
-            // Note: debug mode is handled by SDK based on env (.staging enables verbose logging)
-            resolver(nil)
         }
     }
 
@@ -255,7 +284,6 @@ class BigCrunchAdsModule: RCTEventEmitter {
             let configDict: [String: Any] = [
                 "propertyId": config.propertyId,
                 "appName": config.appName,
-                "environment": config.environment,
                 "gamNetworkCode": config.gamNetworkCode,
                 "s2s": [
                     "enabled": config.s2s.enabled,

package/ios/BigCrunchBannerViewManager.swift

@@ -1,7 +1,6 @@
 import Foundation
 import React
 import UIKit
-import BigCrunchAds
 import GoogleMobileAds
 
 @objc(BigCrunchBannerViewManager)

package/lib/index.d.ts

@@ -13,7 +13,7 @@ import BigCrunchRewarded from './BigCrunchRewarded';
 export * from './types';
 export type { InitializationOptions, Environment, AdFormat, BannerSize, CustomSize, BigCrunchBannerViewProps, InterstitialAd, RewardedAd, AdEvent, AdEventListener, EventSubscription, AdError, AdRevenue, AppConfig, PlacementConfig, SessionInfo, DeviceContext, } from './types';
 export { AdErrorCode } from './types';
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION: string;
 /**
  * Default export for convenience
  */

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG7F,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAGpD,cAAc,SAAS,CAAC;AAGxB,YAAY,EAEV,qBAAqB,EACrB,WAAW,EAGX,QAAQ,EACR,UAAU,EACV,UAAU,EAGV,wBAAwB,EACxB,cAAc,EACd,UAAU,EAGV,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,SAAS,EAGT,SAAS,EACT,eAAe,EAGf,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;GAEG;;;;;;;;AACH,wBAME"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG7F,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAGpD,cAAc,SAAS,CAAC;AAGxB,YAAY,EAEV,qBAAqB,EACrB,WAAW,EAGX,QAAQ,EACR,UAAU,EACV,UAAU,EAGV,wBAAwB,EACxB,cAAc,EACd,UAAU,EAGV,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,SAAS,EAGT,SAAS,EACT,eAAe,EAGf,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC,eAAO,MAAM,WAAW,EAAE,MAA2C,CAAC;AAEtE;;GAEG;;;;;;;;AACH,wBAME"}

package/lib/index.js

@@ -18,8 +18,9 @@ import BigCrunchRewarded from './BigCrunchRewarded';
 export * from './types';
 // Export error codes enum
 export { AdErrorCode } from './types';
-// Version
-export const SDK_VERSION = '0.1.0';
+// Version - read from package.json
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+export const SDK_VERSION = require('../package.json').version;
 /**
  * Default export for convenience
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigcrunch/react-native-ads",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with S2S demand and Google Ad Manager",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -24,6 +24,9 @@
     "ios/*.swift",
     "ios/*.m",
     "ios/*.h",
+    "ios/BigCrunchAds/**/*.swift",
+    "android/bigcrunch-ads/**/*.kt",
+    "scripts/inject-version.js",
     "react-native-bigcrunch-ads.podspec",
     "!**/__tests__",
     "!**/__fixtures__",
@@ -33,6 +36,9 @@
     "typescript": "tsc --noEmit",
     "build": "tsc",
     "prepare": "npm run build || echo 'Build skipped during install'",
+    "prepack": "mkdir -p ios/BigCrunchAds && cp -r ../ios/BigCrunchAds/Sources/ ios/BigCrunchAds/Sources/ && mkdir -p android/bigcrunch-ads && cp -r ../android/bigcrunch-ads/src/main/java/ android/bigcrunch-ads/ && node scripts/inject-version.js --prepack",
+    "postpack": "rm -rf ios/BigCrunchAds/Sources android/bigcrunch-ads/java",
+    "sync-version": "node scripts/inject-version.js --sync",
     "release": "release-it",
     "example": "yarn --cwd example",
     "clean": "del-cli lib"

package/react-native-bigcrunch-ads.podspec

@@ -19,7 +19,6 @@ Pod::Spec.new do |s|
   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.swift_version = "5.9"

package/scripts/inject-version.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+/**
+ * Injects the package.json version into native SDK DeviceContext files.
+ *
+ * Usage:
+ *   node scripts/inject-version.js --prepack   # Operates on copied files inside the package
+ *   node scripts/inject-version.js --sync      # Operates on canonical source files in the monorepo
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const version = require('../package.json').version;
+const mode = process.argv[2];
+
+const TARGETS = {
+  '--prepack': [
+    'ios/BigCrunchAds/Sources/Core/DeviceContext.swift',
+    'android/bigcrunch-ads/com/bigcrunch/ads/core/DeviceContext.kt',
+  ],
+  '--sync': [
+    '../ios/BigCrunchAds/Sources/Core/DeviceContext.swift',
+    '../android/bigcrunch-ads/src/main/java/com/bigcrunch/ads/core/DeviceContext.kt',
+  ],
+};
+
+const files = TARGETS[mode];
+if (!files) {
+  console.error('Usage: inject-version.js --prepack | --sync');
+  process.exit(1);
+}
+
+const SDK_VERSION_RE = /(SDK_VERSION\s*=\s*)(["']).*?\2/;
+
+files.forEach((rel) => {
+  const filePath = path.resolve(__dirname, '..', rel);
+  if (!fs.existsSync(filePath)) {
+    console.warn(`Skipping (not found): ${rel}`);
+    return;
+  }
+  const content = fs.readFileSync(filePath, 'utf8');
+  const match = content.match(SDK_VERSION_RE);
+  if (!match) {
+    console.warn(`No SDK_VERSION match in: ${rel}`);
+    return;
+  }
+  const updated = content.replace(SDK_VERSION_RE, `$1"${version}"`);
+  if (content === updated) {
+    console.log(`Already v${version} in ${rel}`);
+  } else {
+    fs.writeFileSync(filePath, updated);
+    console.log(`Injected v${version} into ${rel}`);
+  }
+});

package/src/index.ts

@@ -56,8 +56,9 @@ export type {
 // Export error codes enum
 export { AdErrorCode } from './types';
 
-// Version
-export const SDK_VERSION = '0.1.0';
+// Version - read from package.json
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+export const SDK_VERSION: string = require('../package.json').version;
 
 /**
  * Default export for convenience