expo-facebook-analytics 1.0.6 → 1.1.0

package/README.md

@@ -2,45 +2,21 @@
 
 High-performance Facebook Analytics for React Native using [Nitro Modules](https://github.com/mrousavy/nitro).
 
-## Features
+📖 **[Documentation](https://jasperaelvoet.github.io/expo-facebook-analytics/)** · 🧪 **[Example app](./example)**
 
-- Direct native Facebook SDK integration via Nitro Modules (zero-copy bridge)
-- Full event logging, user identity management, and device identifier access
-- Expo config plugin for automatic native setup
-- TypeScript-first with predefined event and parameter constants
-- iOS 13+ and Android SDK 21+
+> **Minimal by design.** This library wraps only the Facebook **App Events /
+> Analytics** APIs — event logging, user identity, and device identifiers. It is
+> **not** a full Facebook SDK (no Login, Sharing, Graph API, or Gaming). If you
+> only need analytics and conversion tracking, that's the point: a tiny, fast
+> surface area built on a zero-overhead Nitro/JSI bridge to the native SDK.
 
 ## Installation
 
 ```sh
-bun add expo-facebook-analytics react-native-nitro-modules
+npx expo install expo-facebook-analytics react-native-nitro-modules
 ```
 
-or
-
-```sh
-npm install expo-facebook-analytics react-native-nitro-modules
-```
-
-### Peer Dependencies
-
-- `react-native` >= 0.71
-- `react-native-nitro-modules` >= 0.35.0
-- `expo` >= 55.0.0 _(optional, for config plugin)_
-
-### iOS
-
-```sh
-cd ios && pod install
-```
-
-### Android
-
-No additional steps required — Gradle handles the Facebook SDK dependency automatically.
-
-## Expo Setup
-
-Add the plugin to your `app.json` / `app.config.js`:
+Add the config plugin to your `app.json`:
 
 ```json
 {
@@ -50,8 +26,7 @@ Add the plugin to your `app.json` / `app.config.js`:
         "expo-facebook-analytics",
         {
           "appID": "YOUR_FACEBOOK_APP_ID",
-          "clientToken": "YOUR_FACEBOOK_CLIENT_TOKEN",
-          "displayName": "Your App Name"
+          "clientToken": "YOUR_FACEBOOK_CLIENT_TOKEN"
         }
       ]
     ]
@@ -59,183 +34,48 @@ Add the plugin to your `app.json` / `app.config.js`:
 }
 ```
 
-### Plugin Options
+The module ships native code, so it requires a [development build](https://docs.expo.dev/develop/development-builds/introduction/) — it can't run in Expo Go.
 
-| Option                          | Type                  | Default       | Description                                |
-| ------------------------------- | --------------------- | ------------- | ------------------------------------------ |
-| `appID`                         | `string`              | **required**  | Facebook App ID                            |
-| `clientToken`                   | `string`              | **required**  | Facebook Client Token                      |
-| `displayName`                   | `string`              | App name      | Display name for Facebook                  |
-| `scheme`                        | `string`              | `fb{appID}`   | URL scheme for deep linking                |
-| `isAutoInitEnabled`             | `boolean`             | `true`        | Auto-initialize Facebook SDK               |
-| `autoLogAppEventsEnabled`       | `boolean`             | `true`        | Automatically log app events               |
-| `advertiserIDCollectionEnabled` | `boolean`             | `true`        | Enable advertiser ID collection            |
-| `iosUserTrackingPermission`     | `string` \| `false`   | ATT prompt    | Custom tracking permission text or disable |
-
-### Manual Native Setup
-
-If you're not using Expo, refer to the [Facebook SDK documentation](https://developers.facebook.com/docs/app-events/getting-started-app-events-android/) for manual iOS and Android configuration.
-
-## Usage
-
-### Log Events
+## Quick start
 
 ```typescript
-import { logEvent, logPurchase, AppEvents, AppEventParams } from 'expo-facebook-analytics';
+import { logEvent, logPurchase, AppEvents } from 'expo-facebook-analytics';
 
-// Simple event
 logEvent(AppEvents.ViewedContent);
-
-// Event with a numeric value
-logEvent(AppEvents.Searched, 1);
-
-// Event with parameters
-logEvent(AppEvents.AddedToCart, {
-  [AppEventParams.ContentID]: 'product-123',
-  [AppEventParams.ContentType]: 'product',
-  [AppEventParams.Currency]: 'USD',
-});
-
-// Event with value and parameters
-logEvent(AppEvents.Purchased, 29.99, {
-  [AppEventParams.Currency]: 'USD',
-  [AppEventParams.NumItems]: 2,
-});
-
-// Log a purchase
-logPurchase(29.99, 'USD', {
-  [AppEventParams.ContentID]: 'product-123',
-});
-
-// Log push notification open
-logPushNotificationOpen({ campaign: 'summer-sale' });
-```
-
-### User Identity
-
-```typescript
-import { setUserID, getUserID, clearUserID, setUserData } from 'expo-facebook-analytics';
-
-// Set user ID for analytics
-setUserID('user-123');
-
-// Get current user ID
-const userId = getUserID();
-
-// Clear user ID
-clearUserID();
-
-// Set user data for advanced matching
-setUserData({
-  email: 'user@example.com',
-  firstName: 'John',
-  lastName: 'Doe',
-  gender: 'm',
-  city: 'San Francisco',
-  state: 'CA',
-  country: 'US',
-});
+logEvent(AppEvents.AddedToCart, { product: 'sku-123' });
+logPurchase(29.99, 'USD');
 ```
 
-### Device Identifiers
+For deferred (consent-gated) initialization, set `isAutoInitEnabled: false` in the
+plugin and call `initialize()` yourself. Enable the Facebook SDK's native logging
+with `setLoggingEnabled(true)`. See the [documentation](https://jasperaelvoet.github.io/expo-facebook-analytics/) for the full API.
 
-```typescript
-import { getAnonymousID, getAdvertiserID } from 'expo-facebook-analytics';
-
-const anonId = await getAnonymousID();
-const advertiserId = await getAdvertiserID(); // IDFA on iOS, AAID on Android
-```
+See the **[documentation](https://jasperaelvoet.github.io/expo-facebook-analytics/)** for the full API,
+config-plugin options, manual initialization, and predefined constants.
 
-### Configuration
-
-```typescript
-import { setFlushBehavior, flush, setPushNotificationsDeviceToken, setPushNotificationsRegistrationId } from 'expo-facebook-analytics';
-
-// Control event batching: 'auto' (default) or 'explicit_only'
-setFlushBehavior('explicit_only');
-
-// Manually flush queued events
-flush();
-
-// Push notification tokens
-setPushNotificationsDeviceToken(apnsToken);       // iOS
-setPushNotificationsRegistrationId(fcmToken);     // Android
-```
-
-## API Reference
-
-### Event Logging
-
-| Function                    | Description                          |
-| --------------------------- | ------------------------------------ |
-| `logEvent(name, ...args)`   | Log a custom or predefined event     |
-| `logPurchase(amount, currency, params?)` | Log a purchase event      |
-| `logPushNotificationOpen(payload?)` | Log a push notification open  |
-
-### User Identity
-
-| Function                | Description                        |
-| ----------------------- | ---------------------------------- |
-| `setUserID(id)`         | Set the user ID for analytics      |
-| `clearUserID()`         | Clear the current user ID          |
-| `getUserID()`           | Get the current user ID            |
-| `setUserData(data)`     | Set user data for advanced matching|
-
-### Device Identifiers
-
-| Function              | Description                                 |
-| --------------------- | ------------------------------------------- |
-| `getAnonymousID()`    | Get the anonymous device ID                 |
-| `getAdvertiserID()`   | Get IDFA (iOS) or AAID (Android)            |
-
-### Configuration
-
-| Function                              | Description                        |
-| ------------------------------------- | ---------------------------------- |
-| `setFlushBehavior(behavior)`          | Set event flush behavior           |
-| `flush()`                             | Flush queued events immediately    |
-| `setPushNotificationsDeviceToken(t)`  | Set APNs push token (iOS)         |
-| `setPushNotificationsRegistrationId(id)` | Set FCM registration ID (Android) |
-
-## Predefined Constants
-
-### AppEvents
-
-`AchievedLevel`, `AdClick`, `AdImpression`, `AddedPaymentInfo`, `AddedToCart`, `AddedToWishlist`, `CompletedRegistration`, `CompletedTutorial`, `Contact`, `CustomizeProduct`, `Donate`, `FindLocation`, `InitiatedCheckout`, `Purchased`, `Rated`, `Schedule`, `Searched`, `SpentCredits`, `StartTrial`, `SubmitApplication`, `Subscribe`, `UnlockedAchievement`, `ViewedContent`
+## Requirements
 
-### AppEventParams
+| Tool                         | Version |
+| ---------------------------- | ------- |
+| Expo SDK                     | 56+     |
+| React Native                 | 0.85+   |
+| `react-native-nitro-modules` | 0.35.9+ |
+| iOS deployment target        | 16.4+   |
+| Android `minSdkVersion`      | 24+     |
 
-`AddType`, `Content`, `ContentID`, `ContentType`, `Currency`, `Description`, `Level`, `MaxRatingValue`, `NumItems`, `OrderId`, `PaymentInfoAvailable`, `RegistrationMethod`, `SearchString`, `Success`, `ValueNo`, `ValueYes`
+Native SDKs: Facebook iOS/Android SDK 18. Requires the React Native New Architecture (default in SDK 56).
 
-## Types
+## Contributing
 
-```typescript
-type Params = { [key: string]: string | number };
-
-type UserData = Readonly<{
-  email?: string;
-  firstName?: string;
-  lastName?: string;
-  phone?: string;
-  dateOfBirth?: string;
-  gender?: 'm' | 'f';
-  city?: string;
-  state?: string;
-  zip?: string;
-  country?: string;
-}>;
-
-type AppEventsFlushBehavior = 'auto' | 'explicit_only';
+```sh
+bun install        # install dependencies
+bun run nitrogen   # regenerate native bindings
+bun run prepare    # build the library
+bun test           # run tests
+bun run check      # lint & format
 ```
 
-## Requirements
-
-| Platform | Minimum Version |
-| -------- | --------------- |
-| iOS      | 13.0            |
-| Android  | SDK 21          |
-
-Native SDKs: Facebook SDK ~17.0
+To run the example app, see [`example/`](./example).
 
 ## License
 

package/android/CMakeLists.txt

@@ -0,0 +1,16 @@
+project(NitroFBAnalytics)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# The shared library loaded by NitroFBAnalyticsOnLoad.initializeNative()
+# (System.loadLibrary("NitroFBAnalytics")). Its real sources are added by the
+# generated autolinking cmake below.
+add_library(NitroFBAnalytics SHARED
+  src/main/cpp/cpp-adapter.cpp
+)
+
+# Adds the Nitrogen-generated C++ sources, headers, and links (fbjni,
+# ReactAndroid, react-native-nitro-modules) to the NitroFBAnalytics target.
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroFBAnalytics+autolinking.cmake)

package/android/build.gradle

@@ -7,44 +7,61 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath("com.android.tools.build:gradle:8.2.0")
-        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.22")
+        classpath("com.android.tools.build:gradle:${safeExtGet('androidGradlePluginVersion', '8.9.2')}")
+        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:${safeExtGet('kotlinVersion', '2.1.20')}")
     }
 }
 
 apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 
-def nitrogenAutolinking = file("nitrogen/generated/android/NitroFBAnalytics-autolinking.gradle")
+def nitrogenAutolinking = file("../nitrogen/generated/android/NitroFBAnalytics+autolinking.gradle")
 if (nitrogenAutolinking.exists()) {
     apply from: nitrogenAutolinking
 }
 
 android {
     namespace 'com.nitrofbanalytics'
-    compileSdkVersion safeExtGet('compileSdkVersion', 34)
+    compileSdkVersion safeExtGet('compileSdkVersion', 36)
 
     defaultConfig {
-        minSdkVersion safeExtGet('minSdkVersion', 21)
-        targetSdkVersion safeExtGet('targetSdkVersion', 34)
+        minSdkVersion safeExtGet('minSdkVersion', 24)
+        targetSdkVersion safeExtGet('targetSdkVersion', 36)
+
+        externalNativeBuild {
+            cmake {
+                cppFlags "-O2", "-frtti", "-fexceptions", "-Wall", "-std=c++20"
+                arguments "-DANDROID_STL=c++_shared"
+            }
+        }
+    }
+
+    buildFeatures {
+        prefab true
+    }
+
+    externalNativeBuild {
+        cmake {
+            path "CMakeLists.txt"
+        }
     }
 
     sourceSets {
         main {
             java.srcDirs += [
                 'src/main/java',
-                'nitrogen/generated/android/kotlin'
+                '../nitrogen/generated/android/kotlin'
             ]
         }
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_1_8
-        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     kotlinOptions {
-        jvmTarget = '1.8'
+        jvmTarget = '17'
     }
 }
 
@@ -55,6 +72,14 @@ repositories {
 
 dependencies {
     implementation 'com.facebook.react:react-native:+'
-    implementation 'com.margelo.nitro:nitro-modules:+'
+    // react-native-nitro-modules does not publish `com.margelo.nitro:nitro-modules`
+    // to a Maven repo and autolinking doesn't substitute it, so depend on the
+    // autolinked Gradle project directly. Fall back to the coordinate for
+    // standalone builds where the project isn't part of the Gradle build.
+    if (findProject(':react-native-nitro-modules') != null) {
+        implementation project(':react-native-nitro-modules')
+    } else {
+        implementation 'com.margelo.nitro:nitro-modules:+'
+    }
     implementation 'com.facebook.android:facebook-android-sdk:18.0.3'
 }

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,14 @@
+#include <jni.h>
+#include <fbjni/fbjni.h>
+
+#include "NitroFBAnalyticsOnLoad.hpp"
+
+// Entry point of libNitroFBAnalytics.so. Loaded by
+// NitroFBAnalyticsOnLoad.initializeNative() (System.loadLibrary), this
+// registers the "FacebookAnalytics" HybridObject with the Nitro registry so
+// JS `createHybridObject("FacebookAnalytics")` can resolve it.
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return facebook::jni::initialize(vm, [] {
+    margelo::nitro::fbanalytics::registerAllNatives();
+  });
+}

package/android/src/main/java/com/nitrofbanalytics/FacebookAnalyticsPackage.kt

@@ -0,0 +1,30 @@
+package com.nitrofbanalytics
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+import com.margelo.nitro.com.nitrofbanalytics.NitroFBAnalyticsOnLoad
+
+/**
+ * React Native autolinking entry point for the Nitro module.
+ *
+ * Unlike iOS (where Nitro auto-registers via the podspec's autolinking files),
+ * Android has no auto-load mechanism for the C++ library. This package exists
+ * solely so React Native autolinking instantiates it and triggers
+ * [NitroFBAnalyticsOnLoad.initializeNative], which loads the native library and
+ * registers the "FacebookAnalytics" HybridObject in the Nitro registry.
+ */
+class FacebookAnalyticsPackage : ReactPackage {
+  init {
+    NitroFBAnalyticsOnLoad.initializeNative()
+  }
+
+  override fun createNativeModules(
+    reactContext: ReactApplicationContext,
+  ): List<NativeModule> = emptyList()
+
+  override fun createViewManagers(
+    reactContext: ReactApplicationContext,
+  ): List<ViewManager<*, *>> = emptyList()
+}

package/android/src/main/java/com/nitrofbanalytics/HybridFacebookAnalytics.kt

@@ -1,11 +1,14 @@
-package com.nitrofbanalytics
+package com.margelo.nitro.com.nitrofbanalytics
 
 import android.os.Bundle
 import com.facebook.FacebookSdk
+import com.facebook.LoggingBehavior
 import com.facebook.appevents.AppEventsConstants
 import com.facebook.appevents.AppEventsLogger
 import com.facebook.internal.AttributionIdentifiers
 import com.margelo.nitro.core.Promise
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
 import java.math.BigDecimal
 import java.util.Currency
 
@@ -15,6 +18,52 @@ class HybridFacebookAnalytics : HybridFacebookAnalyticsSpec() {
         AppEventsLogger.newLogger(FacebookSdk.getApplicationContext())
     }
 
+    // Background scope for blocking SDK calls (Play Services I/O) so they never
+    // run on the JS thread.
+    private val ioScope = CoroutineScope(Dispatchers.IO)
+
+    // region Initialization & Runtime Configuration
+
+    override fun initialize() {
+        FacebookSdk.setAutoInitEnabled(true)
+        FacebookSdk.fullyInitialize()
+    }
+
+    override fun setAutoLogAppEventsEnabled(enabled: Boolean) {
+        FacebookSdk.setAutoLogAppEventsEnabled(enabled)
+    }
+
+    override fun setAdvertiserIDCollectionEnabled(enabled: Boolean) {
+        FacebookSdk.setAdvertiserIDCollectionEnabled(enabled)
+    }
+
+    override fun setAppID(appID: String) {
+        FacebookSdk.setApplicationId(appID)
+    }
+
+    override fun setClientToken(clientToken: String) {
+        FacebookSdk.setClientToken(clientToken)
+    }
+
+    override fun setLoggingEnabled(enabled: Boolean) {
+        val behaviors = listOf(
+            LoggingBehavior.APP_EVENTS,
+            LoggingBehavior.REQUESTS,
+            LoggingBehavior.DEVELOPER_ERRORS,
+            LoggingBehavior.INCLUDE_ACCESS_TOKENS
+        )
+        FacebookSdk.setIsDebugEnabled(enabled)
+        for (behavior in behaviors) {
+            if (enabled) {
+                FacebookSdk.addLoggingBehavior(behavior)
+            } else {
+                FacebookSdk.removeLoggingBehavior(behavior)
+            }
+        }
+    }
+
+    // endregion
+
     // region Event Logging
 
     override fun logEvent(eventName: String, valueToSum: Double, params: Map<String, String>) {
@@ -83,16 +132,22 @@ class HybridFacebookAnalytics : HybridFacebookAnalyticsSpec() {
     // region Device Identifiers
 
     override fun getAnonymousID(): Promise<String?> {
-        return Promise.resolved(logger.anonymousAppDeviceGUID)
+        return Promise.resolved(
+            AppEventsLogger.getAnonymousAppDeviceGUID(FacebookSdk.getApplicationContext())
+        )
     }
 
     override fun getAdvertiserID(): Promise<String?> {
-        return try {
-            val context = FacebookSdk.getApplicationContext()
-            val identifiers = AttributionIdentifiers.getAttributionIdentifiers(context)
-            Promise.resolved(identifiers?.androidAdvertiserId)
-        } catch (e: Exception) {
-            Promise.resolved(null)
+        // AttributionIdentifiers performs blocking Play Services I/O, so run it
+        // off the JS thread on the IO dispatcher.
+        return Promise.async(ioScope) {
+            try {
+                val context = FacebookSdk.getApplicationContext()
+                val identifiers = AttributionIdentifiers.getAttributionIdentifiers(context)
+                identifiers?.androidAdvertiserId
+            } catch (e: Exception) {
+                null
+            }
         }
     }
 

package/expo-facebook-analytics.podspec

@@ -12,7 +12,7 @@ Pod::Spec.new do |s|
   s.license      = package['license']
   s.author       = 'expo-facebook-analytics contributors'
   s.source       = { :git => '.', :tag => s.version.to_s }
-  s.platforms    = { :ios => '13.0' }
+  s.platforms    = { :ios => '16.4' }
   s.module_name  = 'NitroFBAnalytics'
 
   s.source_files = [

package/ios/HybridFacebookAnalytics.swift

@@ -5,6 +5,43 @@ import AdSupport
 
 class HybridFacebookAnalytics: HybridFacebookAnalyticsSpec {
 
+    // MARK: - Initialization & Runtime Configuration
+
+    func initialize() throws {
+        // On iOS, auto-init is controlled by Info.plist (FacebookAutoInitEnabled).
+        // When disabled, this performs the deferred initialization.
+        ApplicationDelegate.shared.initializeSDK()
+    }
+
+    func setAutoLogAppEventsEnabled(enabled: Bool) throws {
+        Settings.shared.isAutoLogAppEventsEnabled = enabled
+    }
+
+    func setAdvertiserIDCollectionEnabled(enabled: Bool) throws {
+        Settings.shared.isAdvertiserIDCollectionEnabled = enabled
+    }
+
+    func setAppID(appID: String) throws {
+        Settings.shared.appID = appID
+    }
+
+    func setClientToken(clientToken: String) throws {
+        Settings.shared.clientToken = clientToken
+    }
+
+    func setLoggingEnabled(enabled: Bool) throws {
+        let behaviors: [LoggingBehavior] = [
+            .appEvents, .networkRequests, .developerErrors, .informational,
+        ]
+        for behavior in behaviors {
+            if enabled {
+                Settings.shared.enableLoggingBehavior(behavior)
+            } else {
+                Settings.shared.disableLoggingBehavior(behavior)
+            }
+        }
+    }
+
     // MARK: - Event Logging
 
     func logEvent(eventName: String, valueToSum: Double, params: [String: String]) throws {
@@ -115,16 +152,24 @@ class HybridFacebookAnalytics: HybridFacebookAnalyticsSpec {
     // MARK: - Push Notifications
 
     func setPushNotificationsDeviceToken(token: String) throws {
-        // Token comes as a hex string — convert back to raw Data
-        let hex = token.replacingOccurrences(of: " ", with: "")
-        var data = Data()
-        var index = hex.startIndex
-        while index < hex.endIndex {
-            let nextIndex = hex.index(index, offsetBy: 2)
-            if let byte = UInt8(hex[index..<nextIndex], radix: 16) {
-                data.append(byte)
+        // Token comes as a hex string — convert back to raw Data.
+        // Iterate over UTF-8 bytes and pack each pair of hex digits into one byte.
+        var data = Data(capacity: token.utf8.count / 2)
+        var highNibble: UInt8? = nil
+        for ascii in token.utf8 {
+            let nibble: UInt8
+            switch ascii {
+            case 0x30...0x39: nibble = ascii - 0x30        // '0'-'9'
+            case 0x41...0x46: nibble = ascii - 0x41 + 10   // 'A'-'F'
+            case 0x61...0x66: nibble = ascii - 0x61 + 10   // 'a'-'f'
+            default: continue                              // skip spaces / non-hex
+            }
+            if let high = highNibble {
+                data.append((high << 4) | nibble)
+                highNibble = nil
+            } else {
+                highNibble = nibble
             }
-            index = nextIndex
         }
         AppEvents.shared.setPushNotificationsDeviceToken(data)
     }

package/lib/index.d.ts

@@ -1,6 +1,39 @@
 import type { AppEventsFlushBehavior, Params, UserData } from "./types";
 export type { AppEventsFlushBehavior, Params, UserData } from "./types";
 export { AppEventParams, AppEvents } from "./types";
+/**
+ * Manually initialize the Facebook SDK.
+ *
+ * Only required when `isAutoInitEnabled` is set to `false` in the config plugin.
+ * Call this once, early in your app's lifecycle (e.g. in your root layout),
+ * after optionally configuring the app ID / client token at runtime.
+ */
+export declare function initialize(): void;
+/**
+ * Enable or disable automatic logging of app events at runtime.
+ */
+export declare function setAutoLogAppEventsEnabled(enabled: boolean): void;
+/**
+ * Enable or disable advertiser ID (IDFA / AAID) collection at runtime.
+ */
+export declare function setAdvertiserIDCollectionEnabled(enabled: boolean): void;
+/**
+ * Set the Facebook App ID at runtime (alternative to the config plugin).
+ * Call before {@link initialize} when configuring the SDK manually.
+ */
+export declare function setAppID(appID: string): void;
+/**
+ * Set the Facebook Client Token at runtime (alternative to the config plugin).
+ * Call before {@link initialize} when configuring the SDK manually.
+ */
+export declare function setClientToken(clientToken: string): void;
+/**
+ * Enable verbose Facebook SDK logging (app events, network requests, developer
+ * errors). Output is printed to the native console — view it via the Xcode
+ * console / `xcrun simctl spawn booted log stream` (iOS) or `adb logcat` (Android).
+ * Intended for development only.
+ */
+export declare function setLoggingEnabled(enabled: boolean): void;
 /**
  * Log a custom or predefined app event.
  * @param eventName - Event name (use AppEvents constants for predefined events)