expo-ads 0.1.0 → 0.1.2

package/.prettierrc

@@ -1,8 +1,8 @@
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "singleQuote": true,
-  "bracketSameLine": true,
-  "trailingComma": "es5",
-  "jsxSingleQuote": false,
-}
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "bracketSameLine": true,
+  "trailingComma": "es5",
+  "jsxSingleQuote": false,
+}

package/CHANGELOG.md

@@ -1,11 +1,11 @@
-# Changelog
-
-## Unpublished
-
-### 🛠 Breaking changes
-
-### 🎉 New features
-
-### 🐛 Bug fixes
-
-### 💡 Others
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others

package/LICENSE

@@ -1,21 +1,21 @@
-The MIT License (MIT)
-
-Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,44 +1,44 @@
-# Expo Ads
-
-> 🚧 **This package is currently under construction.**
-
-**Expo Ads** is a React Native / Expo native module for integrating mobile advertising networks into Expo applications.
-
-## Status
-
-**⚠️ Work in Progress**
-
-This package is currently under active development. APIs, features, configuration, and implementation details may change without notice.
-
-**Not recommended for production use yet.**
-
-## Planned Ad Networks
-
-- Google Mobile Ads
-- Meta Audience Network
-
-<!-- ## Planned Features
-
-- Google Mobile Ads initialization
-- Meta Audience Network initialization
-- Banner Ads
-- Interstitial Ads
-- Rewarded Ads
-- Native Ads
-- Expo config plugin support
-- Android support
-- iOS support
-- TypeScript API
-- Expo/EAS Build compatibility
-
-## Installation
-
-Installation instructions will be provided once the package reaches a stable release.
-
-## Development
-
-This package is currently being developed and tested locally with Expo and React Native. -->
-
-## License
-
-MIT
+# Expo Ads
+
+> 🚧 **This package is currently under construction.**
+
+**Expo Ads** is a React Native / Expo native module for integrating mobile advertising networks into Expo applications.
+
+## Status
+
+**⚠️ Work in Progress**
+
+This package is currently under active development. APIs, features, configuration, and implementation details may change without notice.
+
+**Not recommended for production use yet.**
+
+## Planned Ad Networks
+
+- Google Mobile Ads
+- Meta Audience Network
+
+<!-- ## Planned Features
+
+- Google Mobile Ads initialization
+- Meta Audience Network initialization
+- Banner Ads
+- Interstitial Ads
+- Rewarded Ads
+- Native Ads
+- Expo config plugin support
+- Android support
+- iOS support
+- TypeScript API
+- Expo/EAS Build compatibility
+
+## Installation
+
+Installation instructions will be provided once the package reaches a stable release.
+
+## Development
+
+This package is currently being developed and tested locally with Expo and React Native. -->
+
+## License
+
+MIT

package/android/build.gradle

@@ -1,34 +1,34 @@
-import groovy.json.JsonSlurper
-
-plugins {
-  id 'com.android.library'
-  id 'expo-module-gradle-plugin'
-}
-
-group = 'expo.modules.ads'
-version = '0.1.0'
-
-def packageJson = new JsonSlurper().parseText(file("${projectDir}/../package.json").text)
-
-def metaAudienceNetworkVersion = packageJson.sdkVersions.android.metaAudienceNetwork
-def playServicesAdsIdentifierVersion = packageJson.sdkVersions.android.playServicesAdsIdentifier
-def playServicesBasementVersion = packageJson.sdkVersions.android.playServicesBasement
-
-android {
-  namespace "expo.modules.ads"
-  defaultConfig {
-    versionCode 1
-    versionName "0.1.0"
-  }
-  lintOptions {
-    abortOnError false
-  }
-}
-
-
-
-dependencies {
-  implementation("com.facebook.android:audience-network-sdk:${metaAudienceNetworkVersion}")
-  implementation("com.google.android.gms:play-services-ads-identifier:${playServicesAdsIdentifierVersion}")
-  implementation("com.google.android.gms:play-services-basement:${playServicesBasementVersion}")
+import groovy.json.JsonSlurper
+
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'expo.modules.ads'
+version = '0.1.1'
+
+def packageJson = new JsonSlurper().parseText(file("${projectDir}/../package.json").text)
+
+def metaAudienceNetworkVersion = packageJson.sdkVersions.android.metaAudienceNetwork
+def playServicesAdsIdentifierVersion = packageJson.sdkVersions.android.playServicesAdsIdentifier
+def playServicesBasementVersion = packageJson.sdkVersions.android.playServicesBasement
+
+android {
+  namespace "expo.modules.ads"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.1"
+  }
+  lintOptions {
+    abortOnError false
+  }
+}
+
+
+
+dependencies {
+  implementation("com.facebook.android:audience-network-sdk:${metaAudienceNetworkVersion}")
+  implementation("com.google.android.gms:play-services-ads-identifier:${playServicesAdsIdentifierVersion}")
+  implementation("com.google.android.gms:play-services-basement:${playServicesBasementVersion}")
 }

package/android/src/main/AndroidManifest.xml

@@ -1,23 +1,2 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="expo.modules.meta">
-
-    <uses-permission android:name="android.permission.INTERNET" />
-    <uses-permission android:name="android.permission.WAKE_LOCK" />
-    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
-
-    <application>
-      <meta-data
-        android:name="com.google.android.gms.ads.APPLICATION_ID"
-        android:value="${appJSONGoogleMobileAdsAppID}"/>
-      <meta-data
-        android:name="com.google.android.gms.ads.DELAY_APP_MEASUREMENT_INIT"
-        android:value="${appJSONGoogleMobileAdsDelayAppMeasurementInit}"/>
-      <meta-data
-        android:name="com.google.android.gms.ads.flag.OPTIMIZE_INITIALIZATION"
-        android:value="${appJSONGoogleMobileAdsOptimizeInitialization}"/>
-      <meta-data
-        android:name="com.google.android.gms.ads.flag.OPTIMIZE_AD_LOADING"
-        android:value="${appJSONGoogleMobileAdsOptimizeAdLoading}"/>
-    </application>
+<manifest>
 </manifest>

package/android/src/main/java/expo/modules/ads/google/GoogleAdsModule.kt

@@ -1,17 +1,17 @@
-package expo.modules.ads.google
-
-import expo.modules.kotlin.modules.Module
-import expo.modules.kotlin.modules.ModuleDefinition
-
-/**
- * Placeholder module for Google Mobile Ads support.
- * Will be filled in once the Meta implementation is complete.
- */
-class GoogleAdsModule : Module() {
-  override fun definition() = ModuleDefinition {
-    Name("ExpoAdsGoogle")   // the name JS uses to find this module (import from "expo-ads/google")
-
-    // TODO: implement Google Mobile Ads initialization + functions here,
-    // mirroring the structure of MetaAdsModule / MetaAdsInitializer.
-  }
-}
+package expo.modules.ads.google
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+/**
+ * Placeholder module for Google Mobile Ads support.
+ * Will be filled in once the Meta implementation is complete.
+ */
+class GoogleAdsModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("ExpoAdsGoogle")   // the name JS uses to find this module (import from "expo-ads/google")
+
+    // TODO: implement Google Mobile Ads initialization + functions here,
+    // mirroring the structure of MetaAdsModule / MetaAdsInitializer.
+  }
+}

package/android/src/main/java/expo/modules/ads/meta/MetaAdsInitializer.kt

@@ -1,108 +1,108 @@
-package expo.modules.ads.meta
-
-import android.content.Context
-import android.content.pm.ApplicationInfo
-import android.os.Handler
-import android.os.Looper
-import android.util.Log
-import com.facebook.ads.AdSettings
-import com.facebook.ads.AudienceNetworkAds
-
-object MetaAdsInitializer : AudienceNetworkAds.InitListener {
-
-  const val TAG = "ExpoAdsMeta"
-
-  private enum class State { IDLE, INITIALIZING, READY, FAILED }
-
-  private val lock = Any()
-  private var state = State.IDLE
-  private var lastMessage = ""
-  private val pending = mutableListOf<(Boolean, String) -> Unit>()
-
-  fun isReady(): Boolean = synchronized(lock) { state == State.READY }
-
-  fun whenReady(context: Context, callback: (success: Boolean, message: String) -> Unit) {
-    val appContext = context.applicationContext
-    var startInit = false
-    var immediate: Pair<Boolean, String>? = null
-
-    synchronized(lock) {
-      when (state) {
-        State.READY -> {
-          Log.d(TAG, "[Init] Already initialized, running callback immediately")
-          immediate = true to lastMessage
-        }
-        State.INITIALIZING -> {
-          pending.add(callback)
-          Log.d(TAG, "[Init] Initialization in progress, callback queued (${pending.size} waiting)")
-        }
-        State.IDLE -> {
-          Log.i(TAG, "[Init] First-time initialization requested")
-          state = State.INITIALIZING
-          pending.add(callback)
-          startInit = true
-        }
-        State.FAILED -> {
-          Log.w(TAG, "[Init] Previous initialization failed ($lastMessage), retrying")
-          state = State.INITIALIZING
-          pending.add(callback)
-          startInit = true
-        }
-      }
-    }
-
-    immediate?.let { callback(it.first, it.second); return }
-
-    if (startInit) {
-      Handler(Looper.getMainLooper()).post { doInitialize(appContext) }
-    }
-  }
-
-  private fun doInitialize(context: Context) {
-    try {
-      if (AudienceNetworkAds.isInitialized(context)) {
-        Log.i(TAG, "[Init] SDK reports it is already initialized (skipping initialize())")
-        finish(true, "Already initialized")
-        return
-      }
-
-      val isDebuggable = (context.applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE) != 0
-      if (isDebuggable) {
-        AdSettings.turnOnSDKDebugger(context)
-        Log.d(TAG, "[Debug] SDK debugger ENABLED (debuggable build)")
-      } else {
-        Log.d(TAG, "[Debug] SDK debugger NOT set (release build)")
-      }
-
-      Log.i(TAG, "[Init] Calling AudienceNetworkAds.initialize()")
-      AudienceNetworkAds
-        .buildInitSettings(context)
-        .withInitListener(this)
-        .initialize()
-    } catch (e: Exception) {
-      Log.e(TAG, "[Init] initialize() threw an exception: ${e.message}", e)
-      finish(false, e.message ?: "Unknown exception during initialize")
-    }
-  }
-
-  override fun onInitialized(result: AudienceNetworkAds.InitResult) {
-    if (result.isSuccess) {
-      Log.i(TAG, "[Init] SUCCESS: ${result.message}")
-    } else {
-      Log.e(TAG, "[Init] FAILED: ${result.message}")
-    }
-    finish(result.isSuccess, result.message)
-  }
-
-  private fun finish(success: Boolean, message: String) {
-    val callbacks: List<(Boolean, String) -> Unit>
-    synchronized(lock) {
-      state = if (success) State.READY else State.FAILED
-      lastMessage = message
-      callbacks = pending.toList()
-      pending.clear()
-    }
-    Log.d(TAG, "[Init] Notifying ${callbacks.size} waiting callback(s), success=$success")
-    callbacks.forEach { it(success, message) }
-  }
+package expo.modules.ads.meta
+
+import android.content.Context
+import android.content.pm.ApplicationInfo
+import android.os.Handler
+import android.os.Looper
+import android.util.Log
+import com.facebook.ads.AdSettings
+import com.facebook.ads.AudienceNetworkAds
+
+object MetaAdsInitializer : AudienceNetworkAds.InitListener {
+
+  const val TAG = "ExpoAdsMeta"
+
+  private enum class State { IDLE, INITIALIZING, READY, FAILED }
+
+  private val lock = Any()
+  private var state = State.IDLE
+  private var lastMessage = ""
+  private val pending = mutableListOf<(Boolean, String) -> Unit>()
+
+  fun isReady(): Boolean = synchronized(lock) { state == State.READY }
+
+  fun whenReady(context: Context, callback: (success: Boolean, message: String) -> Unit) {
+    val appContext = context.applicationContext
+    var startInit = false
+    var immediate: Pair<Boolean, String>? = null
+
+    synchronized(lock) {
+      when (state) {
+        State.READY -> {
+          Log.d(TAG, "[Init] Already initialized, running callback immediately")
+          immediate = true to lastMessage
+        }
+        State.INITIALIZING -> {
+          pending.add(callback)
+          Log.d(TAG, "[Init] Initialization in progress, callback queued (${pending.size} waiting)")
+        }
+        State.IDLE -> {
+          Log.i(TAG, "[Init] First-time initialization requested")
+          state = State.INITIALIZING
+          pending.add(callback)
+          startInit = true
+        }
+        State.FAILED -> {
+          Log.w(TAG, "[Init] Previous initialization failed ($lastMessage), retrying")
+          state = State.INITIALIZING
+          pending.add(callback)
+          startInit = true
+        }
+      }
+    }
+
+    immediate?.let { callback(it.first, it.second); return }
+
+    if (startInit) {
+      Handler(Looper.getMainLooper()).post { doInitialize(appContext) }
+    }
+  }
+
+  private fun doInitialize(context: Context) {
+    try {
+      if (AudienceNetworkAds.isInitialized(context)) {
+        Log.i(TAG, "[Init] SDK reports it is already initialized (skipping initialize())")
+        finish(true, "Already initialized")
+        return
+      }
+
+      val isDebuggable = (context.applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE) != 0
+      if (isDebuggable) {
+        AdSettings.turnOnSDKDebugger(context)
+        Log.d(TAG, "[Debug] SDK debugger ENABLED (debuggable build)")
+      } else {
+        Log.d(TAG, "[Debug] SDK debugger NOT set (release build)")
+      }
+
+      Log.i(TAG, "[Init] Calling AudienceNetworkAds.initialize()")
+      AudienceNetworkAds
+        .buildInitSettings(context)
+        .withInitListener(this)
+        .initialize()
+    } catch (e: Exception) {
+      Log.e(TAG, "[Init] initialize() threw an exception: ${e.message}", e)
+      finish(false, e.message ?: "Unknown exception during initialize")
+    }
+  }
+
+  override fun onInitialized(result: AudienceNetworkAds.InitResult) {
+    if (result.isSuccess) {
+      Log.i(TAG, "[Init] SUCCESS: ${result.message}")
+    } else {
+      Log.e(TAG, "[Init] FAILED: ${result.message}")
+    }
+    finish(result.isSuccess, result.message)
+  }
+
+  private fun finish(success: Boolean, message: String) {
+    val callbacks: List<(Boolean, String) -> Unit>
+    synchronized(lock) {
+      state = if (success) State.READY else State.FAILED
+      lastMessage = message
+      callbacks = pending.toList()
+      pending.clear()
+    }
+    Log.d(TAG, "[Init] Notifying ${callbacks.size} waiting callback(s), success=$success")
+    callbacks.forEach { it(success, message) }
+  }
 }

package/android/src/main/java/expo/modules/ads/meta/MetaAdsModule.kt

@@ -1,40 +1,93 @@
-package expo.modules.ads.meta
-
-import android.util.Log
-import expo.modules.kotlin.Promise
-import expo.modules.kotlin.modules.Module
-import expo.modules.kotlin.modules.ModuleDefinition
-
-class MetaAdsModule : Module() {
-  override fun definition() = ModuleDefinition {
-    Name("ExpoAdsMeta")   // the name JS uses to find this module (import from "expo-ads/meta")
-
-    // Runs automatically when the module loads (warm-up)
-    OnCreate {
-      val ctx = appContext.reactContext
-      if (ctx == null) {
-        Log.w(MetaAdsInitializer.TAG, "[Module] OnCreate: React context is null, skipping warm-up")
-      } else {
-        Log.d(MetaAdsInitializer.TAG, "[Module] OnCreate: starting SDK warm-up")
-        MetaAdsInitializer.whenReady(ctx) { _, _ -> }
-      }
-    }
-
-    // Lets JS call: await ExpoAdsMeta.initialize()
-    AsyncFunction("initialize") { promise: Promise ->
-      val ctx = appContext.reactContext
-      if (ctx == null) {
-        Log.e(MetaAdsInitializer.TAG, "[Module] initialize() called from JS but React context is null")
-        promise.reject("ERR_NO_CONTEXT", "React context not available", null)
-        return@AsyncFunction
-      }
-      Log.d(MetaAdsInitializer.TAG, "[Module] initialize() called from JS")
-      MetaAdsInitializer.whenReady(ctx) { ok, msg ->
-        if (ok) promise.resolve(msg) else promise.reject("ERR_META_INIT", msg, null)
-      }
-    }
-
-    // If you have a banner view, register it here too:
-    // View(MetaBannerView::class) { ... }
-  }
-}
+package expo.modules.ads.meta
+
+import android.util.Log
+import com.facebook.ads.AdSettings
+import expo.modules.kotlin.Promise
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class MetaAdsModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("ExpoAdsMeta")   // the name JS uses to find this module (import from "expo-ads/meta")
+
+    // Runs automatically when the module loads (warm-up)
+    OnCreate {
+      val ctx = appContext.reactContext
+      if (ctx == null) {
+        Log.w(MetaAdsInitializer.TAG, "[Module] OnCreate: React context is null, skipping warm-up")
+      } else {
+        Log.d(MetaAdsInitializer.TAG, "[Module] OnCreate: starting SDK warm-up")
+        MetaAdsInitializer.whenReady(ctx) { _, _ -> }
+      }
+    }
+
+    // Lets JS call: await ExpoAdsMeta.initialize()
+    AsyncFunction("initialize") { promise: Promise ->
+      val ctx = appContext.reactContext
+      if (ctx == null) {
+        Log.e(MetaAdsInitializer.TAG, "[Module] initialize() called from JS but React context is null")
+        promise.reject("ERR_NO_CONTEXT", "React context not available", null)
+        return@AsyncFunction
+      }
+      Log.d(MetaAdsInitializer.TAG, "[Module] initialize() called from JS")
+      MetaAdsInitializer.whenReady(ctx) { ok, msg ->
+        if (ok) promise.resolve(msg) else promise.reject("ERR_META_INIT", msg, null)
+      }
+    }
+
+    // Lets JS call: await ExpoAdsMeta.setTestMode(true)
+    //
+    // This is a plain static AdSettings toggle with no I/O, so it's a synchronous Function
+    // rather than an AsyncFunction — but it's still safe (and expected) to `await` it from
+    // JS, since every native function on this module returns a Promise from the JS side
+    // regardless of whether it's sync or async natively.
+    //
+    // Deliberately NOT gated on MetaAdsInitializer.isReady(): Meta's own docs call this
+    // (and addTestDevices) *before* the SDK finishes async initialization — test mode and
+    // test devices must be registered before the first loadAd() call, not after init.
+    Function("setTestMode") { enabled: Boolean ->
+      Log.d(MetaAdsInitializer.TAG, "[Module] setTestMode($enabled)")
+      AdSettings.setTestMode(enabled)
+    }
+
+    // Lets JS call: await ExpoAdsMeta.addTestDevices(["HASHED_ID_1", "HASHED_ID_2"])
+    //
+    // Accepts a list so a single call can register every test device hash at once; each
+    // hash is normally copied from Logcat the first time a real ad request is made on that
+    // device (see MetaAdsInitializer's warm-up call in OnCreate above, or any loadAd()).
+    Function("addTestDevices") { deviceHashes: List<String> ->
+      Log.d(MetaAdsInitializer.TAG, "[Module] addTestDevices(${deviceHashes.size} device(s))")
+      AdSettings.addTestDevices(deviceHashes)
+    }
+
+    // Lets JS call: await ExpoAdsMeta.clearTestDevices()
+    //
+    // Mirrors Meta's documented "before shipping" cleanup step
+    // (AdSettings.setTestMode(false); AdSettings.clearTestDevices();). Exposed separately
+    // from setTestMode(false) so callers can clear registered device hashes independently.
+    Function("clearTestDevices") {
+      Log.d(MetaAdsInitializer.TAG, "[Module] clearTestDevices()")
+      AdSettings.clearTestDevices()
+    }
+
+    // Banner ad native view, exposed to JS as <ExpoAdsMetaBannerView>.
+    View(MetaBannerAdView::class) {
+      Events("onAdLoaded", "onAdFailedToLoad", "onAdClicked", "onLoggingImpression")
+
+      Prop("unitId") { view: MetaBannerAdView, value: String? ->
+        view.setUnitId(value)
+      }
+
+      Prop("size") { view: MetaBannerAdView, value: MetaBannerAdSize ->
+        view.setSize(value)
+      }
+
+      // Fires after unitId/size are applied for this commit, mirroring the
+      // onAfterUpdateTransaction "props changed -> (re)request" pattern used by the reference
+      // Google Mobile Ads ViewManager, but expressed as an Expo Modules view lifecycle hook.
+      OnViewDidUpdateProps { view: MetaBannerAdView ->
+        view.requestAd()
+      }
+    }
+  }
+}