@billdog.io/react-native 1.0.0-beta.2

package/android/src/main/kotlin/io/billdog/reactnative/BillDogAnalyticsModule.kt

@@ -0,0 +1,389 @@
+package io.billdog.reactnative
+
+import android.net.Uri
+import android.util.Log
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableArray
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import io.billdog.core.BillDog
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
+import kotlinx.coroutines.launch
+
+/**
+ * BillDogAnalytics — React Native native module for Android
+ * (`NativeModules.BillDogAnalytics`).
+ *
+ * Thin bridge: every `@ReactMethod` here delegates to the concrete analytics
+ * manager (`io.billdog.analytics.BillDogAnalytics`) resolved per-call from the
+ * live module registry (`BillDog.getModules()` — billdog-core BillDog.kt:427),
+ * mirroring the Flutter plugin's BillDogAnalyticsChannelHandler.kt. The
+ * authoritative JS contract is `src/modules/Analytics.ts`; each
+ * `BillDogAnalytics.<method>(...)` call there maps to the identically-named
+ * method below. When the manager is not registered (SDK not configured /
+ * analytics absent) it resolves to `null` and every mutating call is a
+ * best-effort NO-OP that resolves — matching the JS contract.
+ *
+ * ⚠️ VERIFICATION: this file cannot be compiled in this environment — there is
+ * no Android/Gradle toolchain present. It needs a Gradle/Android build
+ * (`./gradlew :billdog_react-native:compileDebugKotlin` or the example app
+ * build) to type-check against the resolved io.billdog:billdog-core +
+ * billdog-analytics + kotlinx-coroutines artifacts declared in
+ * android/build.gradle. Every native symbol below is cited to file:line.
+ */
+class BillDogAnalyticsModule(private val reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    private val TAG = "BillDogAnalytics"
+
+    /** Suspend/async work is launched here; cancelled in invalidate(). */
+    private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Main)
+
+    override fun getName(): String = "BillDogAnalytics"
+
+    // ── Lifecycle ──────────────────────────────────────────────────────────
+
+    override fun invalidate() {
+        scope.cancel()
+        super.invalidate()
+    }
+
+    @Deprecated("Deprecated in RN; kept for older RN versions that call it instead of invalidate()")
+    override fun onCatalystInstanceDestroy() {
+        scope.cancel()
+        @Suppress("DEPRECATION")
+        super.onCatalystInstanceDestroy()
+    }
+
+    /**
+     * Resolve the concrete analytics manager from the live module registry.
+     * Looked up per-call so late module registration is picked up automatically.
+     * Returns null when analytics is not registered → callers NO-OP.
+     */
+    private fun analytics(): io.billdog.analytics.BillDogAnalytics? =
+        BillDog.getModules() // billdog-core BillDog.kt:427
+            .firstOrNull { it is io.billdog.analytics.BillDogAnalytics }
+            as? io.billdog.analytics.BillDogAnalytics
+
+    /** Run [block] on the main scope; map any throwable → promise.reject. */
+    private fun run(promise: Promise, block: () -> Any?) {
+        scope.launch {
+            try {
+                promise.resolve(block())
+            } catch (e: Throwable) {
+                promise.reject("BILLDOG_ERROR", e.message, e)
+            }
+        }
+    }
+
+    // ── Init ────────────────────────────────────────────────────────────────
+
+    /**
+     * BillDogAnalytics.initialize() — the native analytics manager is configured
+     * by the core `BillDog.configure(...)` (server-driven config), not per-module.
+     * No native per-module init exists; resolve null (documented no-op).
+     */
+    @ReactMethod
+    fun initialize(promise: Promise) {
+        // The analytics module is registered by BillDogModule.configure() via
+        // BillDog.use(...) — NOT by BillDog.configure(), which registers nothing.
+        // (An earlier version of this comment claimed otherwise, which masked the
+        // fact that nothing registered analytics at all and every event was
+        // silently dropped.) Nothing to do here; kept so the JS init handshake
+        // resolves. Warn when the registry is still empty so the failure is loud.
+        if (analytics() == null) {
+            Log.w(
+                TAG,
+                "initialize(): analytics module NOT registered — call BillDog configure() first; " +
+                    "track()/identify() will no-op and events will not be delivered"
+            )
+        }
+        promise.resolve(null)
+    }
+
+    // ── Tracking ──────────────────────────────────────────────────────────────
+
+    /**
+     * BillDogAnalytics.track(name, properties) → BillDog.trackEvent(name, props)
+     * — billdog-core BillDog.kt:924 (facade, routes to the registered analytics
+     * module internally). Mirrors the Flutter `analytics_track` branch.
+     */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun track(name: String, properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            val props = (properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()
+            BillDog.trackEvent(name, props) // BillDog.kt:924
+            null
+        }
+    }
+
+    /**
+     * BillDogAnalytics.trackRevenue(amount, currency, productId, properties) →
+     * mgr.trackRevenue(amount, currency, productId, properties) —
+     * BillDogAnalytics.kt:797 (quantity/revenueType defaulted).
+     */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun trackRevenue(
+        amount: Double,
+        currency: String?,
+        productId: String?,
+        properties: ReadableMap?,
+        promise: Promise
+    ) {
+        run(promise) {
+            analytics()?.trackRevenue(
+                amount = amount,
+                currency = currency ?: "USD",
+                productId = productId,
+                properties = (properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()
+            )
+            null
+        }
+    }
+
+    /** BillDogAnalytics.identify(userId, properties) → mgr.identify(userId, properties) — BillDogAnalytics.kt:768. */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun identify(userId: String, properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            analytics()?.identify(userId, (properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()) // :768
+            null
+        }
+    }
+
+    /** BillDogAnalytics.setSuperProperties(properties) → mgr.registerSuperProperties(properties) — BillDogAnalytics.kt:546. */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun setSuperProperties(properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            analytics()?.registerSuperProperties((properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()) // :546
+            null
+        }
+    }
+
+    /** BillDogAnalytics.registerSuperPropertiesOnce(properties) → mgr.registerSuperPropertiesOnce(properties) — BillDogAnalytics.kt:553. */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun registerSuperPropertiesOnce(properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            analytics()?.registerSuperPropertiesOnce((properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()) // :553
+            null
+        }
+    }
+
+    /** BillDogAnalytics.unregisterSuperProperty(key) → mgr.unregisterSuperProperty(key) — BillDogAnalytics.kt:564. */
+    @ReactMethod
+    fun unregisterSuperProperty(key: String, promise: Promise) {
+        run(promise) { analytics()?.unregisterSuperProperty(key); null } // :564
+    }
+
+    /** BillDogAnalytics.clearSuperProperties() → mgr.clearSuperProperties() — BillDogAnalytics.kt:569. */
+    @ReactMethod
+    fun clearSuperProperties(promise: Promise) {
+        run(promise) { analytics()?.clearSuperProperties(); null } // :569
+    }
+
+    /**
+     * BillDogAnalytics.updateUserProperties(operation, properties) — dispatches to
+     * the operation-specific manager method. Mirrors the Flutter
+     * `analytics_updateUserProperties` branch exactly:
+     *   $set → setUserProperties — BillDogAnalytics.kt:831
+     *   $set_once → setUserPropertyOnce(key,value) per key — :835
+     *   $add → incrementUserProperty(key,amount) per key — :839
+     *   $append → appendToUserProperty(key,value) per key — :843
+     *   $unset → unsetUserProperties(keys) — :851
+     *   $remove → best-effort no-op (no native remove-from-list API).
+     */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun updateUserProperties(operation: String, properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            val mgr = analytics()
+            if (mgr != null) {
+                val props = (properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()
+                when (operation) {
+                    "\$set" -> mgr.setUserProperties(props) // :831
+                    "\$set_once" -> props.forEach { (k, v) -> mgr.setUserPropertyOnce(k, v) } // :835
+                    "\$add" -> props.forEach { (k, v) ->
+                        mgr.incrementUserProperty(k, (v as? Number)?.toDouble() ?: 1.0) // :839
+                    }
+                    "\$append" -> props.forEach { (k, v) -> mgr.appendToUserProperty(k, v) } // :843
+                    "\$unset" -> mgr.unsetUserProperties(props.keys.toList()) // :851
+                    "\$remove" -> { /* no native remove-from-list API — no-op */ }
+                    else -> { /* unknown operation — no-op */ }
+                }
+            }
+            null
+        }
+    }
+
+    /**
+     * BillDogAnalytics.flush() → mgr.flush() — BillDogAnalytics.kt:859. Emits
+     * `onAnalyticsFlush` afterward. Native flush() returns no batch count, so
+     * `eventCount` is emitted as 0 (documented limitation — the JS `onFlush`
+     * listener is debugging-only).
+     */
+    @ReactMethod
+    fun flush(promise: Promise) {
+        run(promise) {
+            analytics()?.flush() // :859
+            emit("onAnalyticsFlush", toWritableMap(mapOf("eventCount" to 0)))
+            null
+        }
+    }
+
+    /** BillDogAnalytics.optOut() → mgr.optOut() — BillDogAnalytics.kt:519. */
+    @ReactMethod
+    fun optOut(promise: Promise) {
+        run(promise) { analytics()?.optOut(); null } // :519
+    }
+
+    /** BillDogAnalytics.optIn() → mgr.optIn() — BillDogAnalytics.kt:532. */
+    @ReactMethod
+    fun optIn(promise: Promise) {
+        run(promise) { analytics()?.optIn(); null } // :532
+    }
+
+    /** BillDogAnalytics.reset() → mgr.reset() — BillDogAnalytics.kt:1015. */
+    @ReactMethod
+    fun reset(promise: Promise) {
+        run(promise) { analytics()?.reset(); null } // :1015
+    }
+
+    /** BillDogAnalytics.alias(newId, originalId?) → mgr.alias(newId, previousId=originalId) — BillDogAnalytics.kt:1209. */
+    @ReactMethod
+    fun alias(newId: String, originalId: String?, promise: Promise) {
+        run(promise) { analytics()?.alias(newId, previousId = originalId); null } // :1209
+    }
+
+    /** BillDogAnalytics.timeEvent(eventName) → mgr.timeEvent(eventName) — BillDogAnalytics.kt:1200. */
+    @ReactMethod
+    fun timeEvent(eventName: String, promise: Promise) {
+        run(promise) { analytics()?.timeEvent(eventName); null } // :1200
+    }
+
+    /** BillDogAnalytics.setGroup(groupType, groupId) → mgr.setGroup(groupType, groupId) — BillDogAnalytics.kt:1170. */
+    @ReactMethod
+    fun setGroup(groupType: String, groupId: String, promise: Promise) {
+        run(promise) { analytics()?.setGroup(groupType, groupId); null } // :1170
+    }
+
+    /** BillDogAnalytics.setGroupProperties(groupType, groupId, properties) → mgr.setGroupProperties(...) — BillDogAnalytics.kt:1182. */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun setGroupProperties(groupType: String, groupId: String, properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            analytics()?.setGroupProperties(
+                groupType, groupId, (properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()
+            ) // :1182
+            null
+        }
+    }
+
+    /** BillDogAnalytics.trackScreen(screenName, properties) → mgr.trackScreen(screenName, properties) — BillDogAnalytics.kt:1100. */
+    @ReactMethod
+    @Suppress("UNCHECKED_CAST")
+    fun trackScreen(screenName: String, properties: ReadableMap?, promise: Promise) {
+        run(promise) {
+            analytics()?.trackScreen(screenName, (properties?.toHashMap() as? Map<String, Any>) ?: emptyMap()) // :1100
+            null
+        }
+    }
+
+    /** BillDogAnalytics.trackDeepLink(url) → mgr.trackDeepLink(Uri.parse(url)) — BillDogAnalytics.kt:1092 (Uri overload). */
+    @ReactMethod
+    fun trackDeepLink(url: String, promise: Promise) {
+        run(promise) { analytics()?.trackDeepLink(Uri.parse(url)); null } // :1092
+    }
+
+    /** BillDogAnalytics.getDeviceId() → mgr.getDeviceId() — BillDogAnalytics.kt:1136 (null when unconfigured). */
+    @ReactMethod
+    fun getDeviceId(promise: Promise) {
+        run(promise) { analytics()?.getDeviceId() } // :1136
+    }
+
+    /** BillDogAnalytics.getDistinctId() → mgr.getDistinctId() — BillDogAnalytics.kt:1160. */
+    @ReactMethod
+    fun getDistinctId(promise: Promise) {
+        run(promise) { analytics()?.getDistinctId() } // :1160
+    }
+
+    /** BillDogAnalytics.getSessionId() → mgr.getSessionId() — BillDogAnalytics.kt:1108. */
+    @ReactMethod
+    fun getSessionId(promise: Promise) {
+        run(promise) { analytics()?.getSessionId() } // :1108
+    }
+
+    // ── NativeEventEmitter plumbing (onAnalyticsFlush) ───────────────────────
+    // Required so RN's NativeEventEmitter attaches without warnings. No native
+    // subscription is needed — flush() emits directly.
+
+    @ReactMethod
+    fun addListener(eventName: String) { /* NativeEventEmitter bookkeeping — no-op */ }
+
+    @ReactMethod
+    fun removeListeners(count: Int) { /* NativeEventEmitter bookkeeping — no-op */ }
+
+    private fun emit(event: String, params: WritableMap?) {
+        reactContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+            .emit(event, params)
+    }
+
+    // ── Map<String, Any?> → WritableMap converter (private per-module copy) ───
+
+    private fun toWritableMap(map: Map<String, Any?>): WritableMap {
+        val out = Arguments.createMap()
+        for ((key, value) in map) {
+            when (value) {
+                null -> out.putNull(key)
+                is Boolean -> out.putBoolean(key, value)
+                is Int -> out.putInt(key, value)
+                is Long -> out.putDouble(key, value.toDouble())
+                is Float -> out.putDouble(key, value.toDouble())
+                is Double -> out.putDouble(key, value)
+                is String -> out.putString(key, value)
+                is WritableMap -> out.putMap(key, value)
+                is WritableArray -> out.putArray(key, value)
+                is Map<*, *> -> out.putMap(key, toWritableMap(coerceStringKeys(value)))
+                is List<*> -> out.putArray(key, toWritableArray(value))
+                else -> out.putString(key, value.toString())
+            }
+        }
+        return out
+    }
+
+    private fun toWritableArray(list: List<*>): WritableArray {
+        val out = Arguments.createArray()
+        for (value in list) {
+            when (value) {
+                null -> out.pushNull()
+                is Boolean -> out.pushBoolean(value)
+                is Int -> out.pushInt(value)
+                is Long -> out.pushDouble(value.toDouble())
+                is Float -> out.pushDouble(value.toDouble())
+                is Double -> out.pushDouble(value)
+                is String -> out.pushString(value)
+                is WritableMap -> out.pushMap(value)
+                is WritableArray -> out.pushArray(value)
+                is Map<*, *> -> out.pushMap(toWritableMap(coerceStringKeys(value)))
+                is List<*> -> out.pushArray(toWritableArray(value))
+                else -> out.pushString(value.toString())
+            }
+        }
+        return out
+    }
+
+    private fun coerceStringKeys(map: Map<*, *>): Map<String, Any?> =
+        map.entries.associate { (k, v) -> k.toString() to v }
+}