@bigcrunch/react-native-ads 0.4.0 → 0.5.0

package/android/bigcrunch-ads/com/bigcrunch/ads/internal/Storage.kt

@@ -0,0 +1,88 @@
+package com.bigcrunch.ads.internal
+
+import android.content.Context
+import android.content.SharedPreferences
+
+/**
+ * Key-value storage interface for persisting SDK data
+ */
+internal interface KeyValueStore {
+    /**
+     * Get a string value by key
+     *
+     * @param key Storage key
+     * @param default Default value if key doesn't exist
+     * @return Stored value or default
+     */
+    fun getString(key: String, default: String? = null): String?
+
+    /**
+     * Store a string value
+     *
+     * @param key Storage key
+     * @param value Value to store
+     */
+    fun putString(key: String, value: String)
+
+    /**
+     * Remove a key from storage
+     *
+     * @param key Storage key to remove
+     */
+    fun remove(key: String)
+
+    /**
+     * Clear all stored data
+     */
+    fun clear()
+}
+
+/**
+ * SharedPreferences-based implementation of KeyValueStore
+ *
+ * Thread-safe implementation using Android's SharedPreferences.
+ * All data is stored in a private preferences file.
+ */
+internal class SharedPreferencesStore(context: Context) : KeyValueStore {
+
+    private val prefs: SharedPreferences = context.getSharedPreferences(
+        "bigcrunch_ads_storage",
+        Context.MODE_PRIVATE
+    )
+
+    override fun getString(key: String, default: String?): String? {
+        return try {
+            prefs.getString(key, default)
+        } catch (e: Exception) {
+            BCLogger.e("Storage", "Failed to get string for key: $key", e)
+            default
+        }
+    }
+
+    override fun putString(key: String, value: String) {
+        try {
+            prefs.edit().putString(key, value).apply()
+            BCLogger.v("Storage", "Stored value for key: $key")
+        } catch (e: Exception) {
+            BCLogger.e("Storage", "Failed to store value for key: $key", e)
+        }
+    }
+
+    override fun remove(key: String) {
+        try {
+            prefs.edit().remove(key).apply()
+            BCLogger.v("Storage", "Removed key: $key")
+        } catch (e: Exception) {
+            BCLogger.e("Storage", "Failed to remove key: $key", e)
+        }
+    }
+
+    override fun clear() {
+        try {
+            prefs.edit().clear().apply()
+            BCLogger.d("Storage", "Cleared all stored data")
+        } catch (e: Exception) {
+            BCLogger.e("Storage", "Failed to clear storage", e)
+        }
+    }
+}

package/android/bigcrunch-ads/com/bigcrunch/ads/listeners/BannerAdListener.kt

@@ -0,0 +1,55 @@
+package com.bigcrunch.ads.listeners
+
+/**
+ * Listener interface for banner ad events.
+ * Implement this interface to receive callbacks for banner ad lifecycle events.
+ */
+interface BannerAdListener {
+    /**
+     * Called when a banner ad has been successfully loaded.
+     */
+    fun onAdLoaded()
+
+    /**
+     * Called when a banner ad request fails.
+     *
+     * @param errorCode The error code indicating the type of failure
+     * @param errorMessage A human-readable description of the error
+     */
+    fun onAdFailedToLoad(errorCode: String, errorMessage: String)
+
+    /**
+     * Called when an impression has been recorded for the banner ad.
+     */
+    fun onAdImpression()
+
+    /**
+     * Called when the user clicks on the banner ad.
+     */
+    fun onAdClicked()
+
+    /**
+     * Called when the banner ad opens an overlay that covers the screen.
+     */
+    fun onAdOpened()
+
+    /**
+     * Called when the banner ad closes the overlay.
+     */
+    fun onAdClosed()
+
+    /**
+     * Called when revenue information is available for the banner ad.
+     *
+     * @param valueMicros The monetary value of the ad in micros (1 micro = 0.000001 of currency)
+     * @param currencyCode The ISO 4217 currency code (e.g., "USD")
+     * @param adUnitId The ad unit ID that generated the revenue
+     * @param precision The precision type of the revenue value (e.g., "ESTIMATED", "PUBLISHER_PROVIDED")
+     */
+    fun onAdRevenue(
+        valueMicros: Long,
+        currencyCode: String,
+        adUnitId: String?,
+        precision: String?
+    )
+}

package/android/bigcrunch-ads/com/bigcrunch/ads/listeners/InterstitialAdListener.kt

@@ -0,0 +1,55 @@
+package com.bigcrunch.ads.listeners
+
+/**
+ * Listener interface for interstitial ad events.
+ * Implement this interface to receive callbacks for interstitial ad lifecycle events.
+ */
+interface InterstitialAdListener {
+    /**
+     * Called when an interstitial ad has been successfully loaded.
+     */
+    fun onAdLoaded()
+
+    /**
+     * Called when an interstitial ad request fails.
+     *
+     * @param errorCode The error code indicating the type of failure
+     * @param errorMessage A human-readable description of the error
+     */
+    fun onAdFailedToLoad(errorCode: String, errorMessage: String)
+
+    /**
+     * Called when the interstitial ad is displayed.
+     */
+    fun onAdShowed()
+
+    /**
+     * Called when the interstitial ad is dismissed.
+     */
+    fun onAdDismissed()
+
+    /**
+     * Called when the user clicks on the interstitial ad.
+     */
+    fun onAdClicked()
+
+    /**
+     * Called when an impression has been recorded for the interstitial ad.
+     */
+    fun onAdImpression()
+
+    /**
+     * Called when revenue information is available for the interstitial ad.
+     *
+     * @param valueMicros The monetary value of the ad in micros (1 micro = 0.000001 of currency)
+     * @param currencyCode The ISO 4217 currency code (e.g., "USD")
+     * @param adUnitId The ad unit ID that generated the revenue
+     * @param precision The precision type of the revenue value (e.g., "ESTIMATED", "PUBLISHER_PROVIDED")
+     */
+    fun onAdRevenue(
+        valueMicros: Long,
+        currencyCode: String,
+        adUnitId: String?,
+        precision: String?
+    )
+}

package/android/bigcrunch-ads/com/bigcrunch/ads/listeners/RewardedAdListener.kt

@@ -0,0 +1,58 @@
+package com.bigcrunch.ads.listeners
+
+/**
+ * Listener interface for rewarded ad events.
+ * Implement this interface to receive callbacks for rewarded ad lifecycle events.
+ */
+interface RewardedAdListener {
+    /**
+     * Called when a rewarded ad has been successfully loaded.
+     */
+    fun onAdLoaded()
+
+    /**
+     * Called when a rewarded ad request fails.
+     *
+     * @param errorCode The error code indicating the type of failure
+     * @param errorMessage A human-readable description of the error
+     */
+    fun onAdFailedToLoad(errorCode: String, errorMessage: String)
+
+    /**
+     * Called when the rewarded ad is displayed.
+     */
+    fun onAdShowed()
+
+    /**
+     * Called when the rewarded ad is dismissed.
+     */
+    fun onAdDismissed()
+
+    /**
+     * Called when the user clicks on the rewarded ad.
+     */
+    fun onAdClicked()
+
+    /**
+     * Called when the user has earned a reward by watching the rewarded ad.
+     *
+     * @param type The type of reward (e.g., "coins", "points")
+     * @param amount The amount of reward earned
+     */
+    fun onUserEarnedReward(type: String, amount: Int)
+
+    /**
+     * Called when revenue information is available for the rewarded ad.
+     *
+     * @param valueMicros The monetary value of the ad in micros (1 micro = 0.000001 of currency)
+     * @param currencyCode The ISO 4217 currency code (e.g., "USD")
+     * @param adUnitId The ad unit ID that generated the revenue
+     * @param precision The precision type of the revenue value (e.g., "ESTIMATED", "PUBLISHER_PROVIDED")
+     */
+    fun onAdRevenue(
+        valueMicros: Long,
+        currencyCode: String,
+        adUnitId: String?,
+        precision: String?
+    )
+}