@react-native-firebase/analytics 23.8.8 → 24.1.0

package/dist/typescript/lib/types/internal.d.ts

@@ -0,0 +1,39 @@
+import type { Analytics } from './analytics';
+/**
+ * Native Analytics module interface (RNFBAnalyticsModule).
+ * Matches the methods exposed by the native iOS/Android bridge.
+ * logTransaction and initiateOnDeviceConversionMeasurement* are iOS-only.
+ */
+export interface RNFBAnalyticsModule {
+    logEvent(name: string, params?: Record<string, unknown>): Promise<void>;
+    setUserId(userId: string | null): Promise<void>;
+    setUserProperty(key: string, value: string | null): Promise<void>;
+    setUserProperties(properties: Record<string, string | number | boolean | null>): Promise<void>;
+    setDefaultEventParameters(params?: Record<string, unknown> | null): Promise<void>;
+    setConsent(consent: Record<string, unknown>): Promise<void>;
+    setAnalyticsCollectionEnabled(enabled: boolean): Promise<void>;
+    resetAnalyticsData(): Promise<void>;
+    setSessionTimeoutDuration(milliseconds?: number): Promise<void>;
+    getAppInstanceId(): Promise<string | null>;
+    getSessionId(): Promise<number | null>;
+    /** iOS only (StoreKit 2). Not present on Android native. */
+    logTransaction(transactionId: string): Promise<void>;
+    /** iOS only. */
+    initiateOnDeviceConversionMeasurementWithEmailAddress?(emailAddress: string): Promise<void>;
+    /** iOS only. */
+    initiateOnDeviceConversionMeasurementWithHashedEmailAddress?(hashedEmailAddress: string): Promise<void>;
+    /** iOS only. */
+    initiateOnDeviceConversionMeasurementWithPhoneNumber?(phoneNumber: string): Promise<void>;
+    /** iOS only. */
+    initiateOnDeviceConversionMeasurementWithHashedPhoneNumber?(hashedPhoneNumber: string): Promise<void>;
+}
+declare module '@react-native-firebase/app/dist/module/internal/NativeModules' {
+    interface ReactNativeFirebaseNativeModules {
+        RNFBAnalyticsModule: RNFBAnalyticsModule;
+    }
+}
+/** Analytics instance with native module typed for modular API (e.g. logTransaction). */
+export interface AnalyticsInternal extends Analytics {
+    readonly native: RNFBAnalyticsModule;
+}
+//# sourceMappingURL=internal.d.ts.map

package/dist/typescript/lib/types/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../../lib/types/internal.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,yBAAyB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,4DAA4D;IAC5D,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,gBAAgB;IAChB,qDAAqD,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,gBAAgB;IAChB,2DAA2D,CAAC,CAC1D,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,gBAAgB;IAChB,oDAAoD,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,gBAAgB;IAChB,0DAA0D,CAAC,CACzD,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,OAAO,QAAQ,+DAA+D,CAAC;IAC7E,UAAU,gCAAgC;QACxC,mBAAmB,EAAE,mBAAmB,CAAC;KAC1C;CACF;AAED,yFAAyF;AACzF,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC"}

package/dist/typescript/lib/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "23.8.8";
+export declare const version = "24.1.0";
 //# sourceMappingURL=version.d.ts.map

package/ios/RNFBAnalytics/RNFBAnalyticsLogTransaction.swift

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+import Foundation
+import FirebaseAnalytics
+import StoreKit
+
+/// Swift wrapper for logging a verified StoreKit 2 transaction to Firebase Analytics.
+/// Accessible from Objective-C; necessary because StoreKit 2 and Analytics.logTransaction use Swift async APIs.
+/// Call from ObjC only when @available(iOS 15.0, *) (see RNFBFunctionsStreamHandler pattern).
+@available(iOS 15.0, macOS 12.0, *)
+@objcMembers public class RNFBAnalyticsLogTransaction: NSObject {
+
+  private static let kCode = "firebase_analytics"
+  private var logTask: Task<Void, Never>?
+
+  /// Resolve/reject types matching RCTPromiseResolveBlock / RCTPromiseRejectBlock for React Native bridge.
+  @objc public func logTransaction(
+    transactionId: String,
+    resolve: @escaping (Any?) -> Void,
+    reject: @escaping (String, String, NSError?) -> Void
+  ) {
+    logTask = Task {
+      await performLogTransaction(transactionId: transactionId, resolve: resolve, reject: reject)
+      logTask = nil
+    }
+  }
+
+  private func performLogTransaction(
+    transactionId: String,
+    resolve: @escaping (Any?) -> Void,
+    reject: @escaping (String, String, NSError?) -> Void
+  ) async {
+    guard let id = UInt64(transactionId) else {
+      await MainActor.run { reject(Self.kCode, "Invalid transactionId", nil) }
+      return
+    }
+
+    var foundTransaction: StoreKit.Transaction?
+    for await result in StoreKit.Transaction.all {
+      switch result {
+      case let .verified(transaction):
+        if transaction.id == id {
+          foundTransaction = transaction
+          break
+        }
+      case .unverified:
+        continue
+      }
+    }
+
+    guard let transaction = foundTransaction else {
+      await MainActor.run { reject(Self.kCode, "Transaction not found", nil) }
+      return
+    }
+
+    Analytics.logTransaction(transaction)
+    await MainActor.run { resolve(NSNull()) }
+  }
+}

package/ios/RNFBAnalytics/RNFBAnalyticsModule.m

@@ -18,9 +18,38 @@
 #import <Firebase/Firebase.h>
 #import <React/RCTUtils.h>
 
+#if __has_include(<RNFBAnalytics/RNFBAnalytics-Swift.h>)
+// This import will work in situations where `use_frameworks!` is in use
+#import <RNFBAnalytics/RNFBAnalytics-Swift.h>
+#elif __has_include("RNFBAnalytics-Swift.h")
+// If `use_frameworks!` is not in use (for example, while using pre-built
+// react-native core) then header imports based on frameworks assumptions fail.
+// So, if frameworks are not available, fall back to importing the header directly, it
+// should be findable from a header search path pointing to the build
+// directory. See firebase-ios-sdk#12611 for more context.
+#import "RNFBAnalytics-Swift.h"
+#endif
 #import <RNFBApp/RNFBSharedUtils.h>
 #import "RNFBAnalyticsModule.h"
 
+/** GA4 parameters that must be sent as integer NSNumber values (not doubles from JS). */
+static NSArray<NSString *> *RNFBAnalyticsLongNumericParameterKeys(void) {
+  static NSArray<NSString *> *keys;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    keys = @[
+      kFIRParameterQuantity,
+      kFIRParameterIndex,
+      kFIRParameterLevel,
+      kFIRParameterNumberOfNights,
+      kFIRParameterNumberOfPassengers,
+      kFIRParameterNumberOfRooms,
+      kFIRParameterScore,
+    ];
+  });
+  return keys;
+}
+
 @implementation RNFBAnalyticsModule
 #pragma mark -
 #pragma mark Module Setup
@@ -212,6 +241,18 @@ RCT_EXPORT_METHOD(initiateOnDeviceConversionMeasurementWithHashedPhoneNumber
   return resolve([NSNull null]);
 }
 
+RCT_EXPORT_METHOD(logTransaction
+                  : (NSString *)transactionId resolver
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  if (@available(iOS 15.0, macOS 12.0, *)) {
+    RNFBAnalyticsLogTransaction *handler = [[RNFBAnalyticsLogTransaction alloc] init];
+    [handler logTransactionWithTransactionId:transactionId resolve:resolve reject:reject];
+  } else {
+    reject(@"firebase_analytics", @"logTransaction() is only supported on iOS 15.0 or newer", nil);
+  }
+}
+
 RCT_EXPORT_METHOD(setConsent
                   : (NSDictionary *)consentSettings resolver
                   : (RCTPromiseResolveBlock)resolve rejecter
@@ -245,13 +286,13 @@ RCT_EXPORT_METHOD(setConsent
     [(NSArray *)newParams[kFIRParameterItems]
         enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) {
           NSMutableDictionary *item = [obj mutableCopy];
-          if (item[kFIRParameterQuantity]) {
-            item[kFIRParameterQuantity] = @([item[kFIRParameterQuantity] integerValue]);
-          }
+          [self rnfb_coerceLongNumericParametersInMutableDictionary:item];
           [newItems addObject:[item copy]];
         }];
     newParams[kFIRParameterItems] = [newItems copy];
   }
+  [self rnfb_coerceLongNumericParametersInMutableDictionary:newParams];
+  [self rnfb_coerceSuccessParameterInMutableDictionary:newParams];
   NSNumber *extendSession = [newParams valueForKey:kFIRParameterExtendSession];
   if ([extendSession isEqualToNumber:@1]) {
     newParams[kFIRParameterExtendSession] = @YES;
@@ -259,6 +300,33 @@ RCT_EXPORT_METHOD(setConsent
   return [newParams copy];
 }
 
+- (void)rnfb_coerceLongNumericParametersInMutableDictionary:(NSMutableDictionary *)dict {
+  for (NSString *key in RNFBAnalyticsLongNumericParameterKeys()) {
+    id value = dict[key];
+    if (value != nil && value != [NSNull null]) {
+      dict[key] = @([value integerValue]);
+    }
+  }
+}
+
+- (void)rnfb_coerceSuccessParameterInMutableDictionary:(NSMutableDictionary *)dict {
+  id value = dict[kFIRParameterSuccess];
+  if (value == nil || value == [NSNull null]) {
+    return;
+  }
+  int success = 0;
+  if ([value isKindOfClass:[NSString class]]) {
+    NSString *lower = [(NSString *)value lowercaseString];
+    if ([lower isEqualToString:@"true"] || [lower isEqualToString:@"yes"] ||
+        [lower isEqualToString:@"1"]) {
+      success = 1;
+    }
+  } else {
+    success = [value boolValue] ? 1 : 0;
+  }
+  dict[kFIRParameterSuccess] = @(success);
+}
+
 /// Converts null values received over the bridge from NSNull to nil
 /// @param value Nullable string value
 - (NSString *)convertNSNullToNil:(NSString *)value {

package/ios/RNFBAnalytics.xcodeproj/project.pbxproj

@@ -8,6 +8,7 @@
 
 /* Begin PBXBuildFile section */
 		2744B98621F45429004F8E3F /* RNFBAnalyticsModule.m in Sources */ = {isa = PBXBuildFile; fileRef = 2744B98521F45429004F8E3F /* RNFBAnalyticsModule.m */; };
+		2744B99021F45429004F8E3F /* RNFBAnalyticsLogTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2744B98F21F45429004F8E3F /* RNFBAnalyticsLogTransaction.swift */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXCopyFilesBuildPhase section */
@@ -26,6 +27,7 @@
 		2744B98221F45429004F8E3F /* libRNFBAnalytics.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libRNFBAnalytics.a; sourceTree = BUILT_PRODUCTS_DIR; };
 		2744B98421F45429004F8E3F /* RNFBAnalyticsModule.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = RNFBAnalyticsModule.h; path = RNFBAnalytics/RNFBAnalyticsModule.h; sourceTree = SOURCE_ROOT; };
 		2744B98521F45429004F8E3F /* RNFBAnalyticsModule.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = RNFBAnalyticsModule.m; path = RNFBAnalytics/RNFBAnalyticsModule.m; sourceTree = SOURCE_ROOT; };
+		2744B98F21F45429004F8E3F /* RNFBAnalyticsLogTransaction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBAnalyticsLogTransaction.swift; path = RNFBAnalytics/RNFBAnalyticsLogTransaction.swift; sourceTree = SOURCE_ROOT; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -54,6 +56,7 @@
 				2744B98C21F45C64004F8E3F /* common */,
 				2744B98421F45429004F8E3F /* RNFBAnalyticsModule.h */,
 				2744B98521F45429004F8E3F /* RNFBAnalyticsModule.m */,
+				2744B98F21F45429004F8E3F /* RNFBAnalyticsLogTransaction.swift */,
 			);
 			path = RNFBAnalytics;
 			sourceTree = "<group>";
@@ -125,6 +128,7 @@
 			buildActionMask = 2147483647;
 			files = (
 				2744B98621F45429004F8E3F /* RNFBAnalyticsModule.m in Sources */,
+				2744B99021F45429004F8E3F /* RNFBAnalyticsLogTransaction.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -166,6 +170,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.0;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Debug;
@@ -200,6 +205,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.0;
 				TARGETED_DEVICE_FAMILY = "1,2";
 				VALIDATE_PRODUCT = YES;
 			};

package/lib/modular.ts

@@ -1,6 +1,7 @@
 import { MODULAR_DEPRECATION_ARG } from '@react-native-firebase/app/dist/module/common';
 import { getApp } from '@react-native-firebase/app';
 import type { Analytics } from './types/analytics';
+import type { AnalyticsInternal } from './types/internal';
 import { Platform } from 'react-native';
 import type { ReactNativeFirebase } from '@react-native-firebase/app';
 import type {
@@ -416,6 +417,18 @@ export function logEvent(
   return analytics.logEvent.call(analytics, name, params, options, MODULAR_DEPRECATION_ARG);
 }
 
+/** Logs verified in-app purchase events in Google Analytics for Firebase
+ * after a purchase is successful.
+ * Modular API only; iOS only (StoreKit 2). Throws on Android and web before reaching native.
+ */
+export function logTransaction(analytics: Analytics, transaction_id: string): Promise<void> {
+  if (Platform.OS !== 'ios') {
+    return Promise.reject(new Error('logTransaction is only available on iOS'));
+  }
+
+  return (analytics as AnalyticsInternal).native.logTransaction(transaction_id);
+}
+
 /**
  * If true, allows the device to collect analytical data and send it to Firebase. Useful for GDPR.
  */
@@ -935,10 +948,10 @@ export function initiateOnDeviceConversionMeasurementWithEmailAddress(
  * start privacy-sensitive on-device conversion management.
  * This is iOS-only.
  * This is a no-op if you do not include '$RNFirebaseAnalyticsGoogleAppMeasurementOnDeviceConversion = true' in your Podfile
+ * {@link https://firebase.google.com/docs/tutorials/ads-ios-on-device-measurement/step-3#use-hashed-credentials}
  *
  * @param analytics Analytics instance.
  * @param hashedEmailAddress sha256-hashed of normalized email address, properly formatted complete with domain name e.g, 'user@example.com'
- * @link https://firebase.google.com/docs/tutorials/ads-ios-on-device-measurement/step-3#use-hashed-credentials
  */
 export function initiateOnDeviceConversionMeasurementWithHashedEmailAddress(
   analytics: Analytics,
@@ -975,10 +988,10 @@ export function initiateOnDeviceConversionMeasurementWithPhoneNumber(
  * start privacy-sensitive on-device conversion management.
  * This is iOS-only.
  * This is a no-op if you do not include '$RNFirebaseAnalyticsGoogleAppMeasurementOnDeviceConversion = true' in your Podfile
+ * {@link https://firebase.google.com/docs/tutorials/ads-ios-on-device-measurement/step-3#use-hashed-credentials}
  *
  * @param analytics Analytics instance.
  * @param hashedPhoneNumber sha256-hashed of normalized phone number in E.164 format - that is a leading + sign, then up to 15 digits, no dashes or spaces.
- * @link https://firebase.google.com/docs/tutorials/ads-ios-on-device-measurement/step-3#use-hashed-credentials
  */
 export function initiateOnDeviceConversionMeasurementWithHashedPhoneNumber(
   analytics: Analytics,
@@ -1018,9 +1031,10 @@ export function setConsent(analytics: Analytics, consentSettings: ConsentSetting
 /**
  * Configures Firebase Analytics to use custom gtag or dataLayer names.
  * Intended to be used if gtag.js script has been installed on this page independently of Firebase Analytics, and is using non-default names for either the gtag function or for dataLayer. Must be called before calling `getAnalytics()` or it won't have any effect. Web only.
- * @param {SettingsOptions} options - See SettingsOptions.
+ * @param {SettingsOptions} _options - See SettingsOptions - currently unused.
  * @returns {void}
  */
+
 export function settings(_options: SettingsOptions): void {
   // Returns nothing until Web implemented.
 }

package/lib/namespaced.ts

@@ -34,6 +34,8 @@ import {
   getFirebaseRoot,
 } from '@react-native-firebase/app/dist/module/internal';
 
+import './types/internal';
+
 // Internal types are now available through module declarations in app package
 import { setReactNativeModule } from '@react-native-firebase/app/dist/module/internal/nativeModule';
 import { isBoolean } from '@react-native-firebase/app/dist/module/common';
@@ -122,7 +124,7 @@ const namespace = 'analytics';
 
 const nativeModuleName = 'RNFBAnalyticsModule';
 
-class FirebaseAnalyticsModule extends FirebaseModule {
+class FirebaseAnalyticsModule extends FirebaseModule<typeof nativeModuleName> {
   logEvent(
     name: string,
     params: { [key: string]: any } = {},
@@ -800,7 +802,10 @@ class FirebaseAnalyticsModule extends FirebaseModule {
       return Promise.resolve();
     }
 
-    return this.native.initiateOnDeviceConversionMeasurementWithEmailAddress(emailAddress);
+    return (
+      this.native.initiateOnDeviceConversionMeasurementWithEmailAddress?.(emailAddress) ??
+      Promise.resolve()
+    );
   }
 
   initiateOnDeviceConversionMeasurementWithHashedEmailAddress(
@@ -816,8 +821,10 @@ class FirebaseAnalyticsModule extends FirebaseModule {
       return Promise.resolve();
     }
 
-    return this.native.initiateOnDeviceConversionMeasurementWithHashedEmailAddress(
-      hashedEmailAddress,
+    return (
+      this.native.initiateOnDeviceConversionMeasurementWithHashedEmailAddress?.(
+        hashedEmailAddress,
+      ) ?? Promise.resolve()
     );
   }
 
@@ -832,7 +839,10 @@ class FirebaseAnalyticsModule extends FirebaseModule {
       return Promise.resolve();
     }
 
-    return this.native.initiateOnDeviceConversionMeasurementWithPhoneNumber(phoneNumber);
+    return (
+      this.native.initiateOnDeviceConversionMeasurementWithPhoneNumber?.(phoneNumber) ??
+      Promise.resolve()
+    );
   }
 
   initiateOnDeviceConversionMeasurementWithHashedPhoneNumber(
@@ -854,8 +864,9 @@ class FirebaseAnalyticsModule extends FirebaseModule {
       return Promise.resolve();
     }
 
-    return this.native.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber(
-      hashedPhoneNumber,
+    return (
+      this.native.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber?.(hashedPhoneNumber) ??
+      Promise.resolve()
     );
   }
 }

package/lib/structs.ts

@@ -14,7 +14,7 @@
  *  limitations under the License.
  */
 
-import { object, string, number, array, optional, define, type } from 'superstruct';
+import { object, string, number, boolean, array, optional, define, type } from 'superstruct';
 
 const ShortDate = define(
   'ShortDate',
@@ -36,6 +36,7 @@ const Item = type({
   item_variant: optional(string()),
   quantity: optional(number()),
   price: optional(number()),
+  index: optional(number()),
 });
 
 export const ScreenView = type({
@@ -104,7 +105,7 @@ export const JoinGroup = object({
 
 export const LevelEnd = object({
   level: number(),
-  success: optional(string()),
+  success: optional(boolean()),
 });
 
 export const LevelStart = object({

package/lib/types/analytics.ts

@@ -282,7 +282,7 @@ export interface LevelEndEventParameters {
   /**
    * The result of an operation.
    */
-  success?: string;
+  success?: boolean;
 }
 
 export interface LevelStartEventParameters {
@@ -939,6 +939,7 @@ export interface Analytics extends ReactNativeFirebase.FirebaseModule {
   logShare(object: ShareEventParameters): Promise<void>;
   logSignUp(object: SignUpEventParameters): Promise<void>;
   logSpendVirtualCurrency(object: SpendVirtualCurrencyEventParameters): Promise<void>;
+  logTransaction(transaction_id: string): Promise<void>;
   logTutorialBegin(): Promise<void>;
   logTutorialComplete(): Promise<void>;
   logUnlockAchievement(object: UnlockAchievementEventParameters): Promise<void>;

package/lib/types/internal.ts

@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+import type { Analytics } from './analytics';
+
+/**
+ * Native Analytics module interface (RNFBAnalyticsModule).
+ * Matches the methods exposed by the native iOS/Android bridge.
+ * logTransaction and initiateOnDeviceConversionMeasurement* are iOS-only.
+ */
+export interface RNFBAnalyticsModule {
+  logEvent(name: string, params?: Record<string, unknown>): Promise<void>;
+  setUserId(userId: string | null): Promise<void>;
+  setUserProperty(key: string, value: string | null): Promise<void>;
+  setUserProperties(properties: Record<string, string | number | boolean | null>): Promise<void>;
+  setDefaultEventParameters(params?: Record<string, unknown> | null): Promise<void>;
+  setConsent(consent: Record<string, unknown>): Promise<void>;
+  setAnalyticsCollectionEnabled(enabled: boolean): Promise<void>;
+  resetAnalyticsData(): Promise<void>;
+  setSessionTimeoutDuration(milliseconds?: number): Promise<void>;
+  getAppInstanceId(): Promise<string | null>;
+  getSessionId(): Promise<number | null>;
+  /** iOS only (StoreKit 2). Not present on Android native. */
+  logTransaction(transactionId: string): Promise<void>;
+  /** iOS only. */
+  initiateOnDeviceConversionMeasurementWithEmailAddress?(emailAddress: string): Promise<void>;
+  /** iOS only. */
+  initiateOnDeviceConversionMeasurementWithHashedEmailAddress?(
+    hashedEmailAddress: string,
+  ): Promise<void>;
+  /** iOS only. */
+  initiateOnDeviceConversionMeasurementWithPhoneNumber?(phoneNumber: string): Promise<void>;
+  /** iOS only. */
+  initiateOnDeviceConversionMeasurementWithHashedPhoneNumber?(
+    hashedPhoneNumber: string,
+  ): Promise<void>;
+}
+
+declare module '@react-native-firebase/app/dist/module/internal/NativeModules' {
+  interface ReactNativeFirebaseNativeModules {
+    RNFBAnalyticsModule: RNFBAnalyticsModule;
+  }
+}
+
+/** Analytics instance with native module typed for modular API (e.g. logTransaction). */
+export interface AnalyticsInternal extends Analytics {
+  readonly native: RNFBAnalyticsModule;
+}

package/lib/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '23.8.8';
+export const version = '24.1.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/analytics",
-  "version": "23.8.8",
+  "version": "24.1.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Firebase - The analytics module provides out of the box support with Google Analytics for Firebase. Integration with the Android & iOS allows for in-depth analytical insight reporting, such as device information, location, user actions and more.",
   "main": "./dist/module/index.js",
@@ -8,8 +8,10 @@
   "scripts": {
     "build": "genversion --esm --semi lib/version.ts",
     "build:clean": "rimraf android/build && rimraf ios/build",
+    "build:plugin": "rimraf plugin/build && tsc --build plugin",
+    "lint:plugin": "eslint \"plugin/src/**/*.{ts,js}\"",
     "compile": "bob build",
-    "prepare": "yarn run build && yarn compile"
+    "prepare": "yarn run build && yarn run build:plugin && yarn compile"
   },
   "repository": {
     "type": "git",
@@ -23,7 +25,8 @@
     "analytics"
   ],
   "peerDependencies": {
-    "@react-native-firebase/app": "23.8.8"
+    "@react-native-firebase/app": "24.1.0",
+    "expo": ">=47.0.0"
   },
   "publishConfig": {
     "access": "public",
@@ -33,7 +36,14 @@
     "superstruct": "^2.0.2"
   },
   "devDependencies": {
-    "react-native-builder-bob": "^0.40.17"
+    "expo": "^55.0.5",
+    "react-native-builder-bob": "^0.40.17",
+    "typescript": "^5.9.3"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
   },
   "exports": {
     ".": {
@@ -41,6 +51,7 @@
       "types": "./dist/typescript/lib/index.d.ts",
       "default": "./dist/module/index.js"
     },
+    "./app.plugin.js": "./app.plugin.js",
     "./package.json": "./package.json"
   },
   "react-native-builder-bob": {
@@ -65,5 +76,5 @@
     "node_modules/",
     "dist/"
   ],
-  "gitHead": "d17b898bee0be82259fc1b88f46106a927bf81aa"
+  "gitHead": "804a51fd265453f2385adb0ac96a6abf992c0316"
 }

package/plugin/build/index.d.ts

@@ -0,0 +1,4 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import { PluginConfigType } from './pluginConfig';
+declare const _default: ConfigPlugin<PluginConfigType>;
+export default _default;

package/plugin/build/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+const ios_1 = require("./ios");
+/**
+ * A config plugin for configuring `@react-native-firebase/analytics`
+ */
+const withRnFirebaseAnalytics = (config, props) => {
+    return (0, config_plugins_1.withPlugins)(config, [
+        // iOS
+        [ios_1.withIosWithoutAdIdSupport, props],
+        [ios_1.withIosGoogleAppMeasurementOnDeviceConversion, props],
+    ]);
+};
+const pak = require('../../package.json');
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withRnFirebaseAnalytics, pak.name, pak.version);

package/plugin/build/ios/index.d.ts

@@ -0,0 +1,2 @@
+import { withIosWithoutAdIdSupport, withIosGoogleAppMeasurementOnDeviceConversion } from './podfile';
+export { withIosWithoutAdIdSupport, withIosGoogleAppMeasurementOnDeviceConversion };

package/plugin/build/ios/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withIosGoogleAppMeasurementOnDeviceConversion = exports.withIosWithoutAdIdSupport = void 0;
+const podfile_1 = require("./podfile");
+Object.defineProperty(exports, "withIosWithoutAdIdSupport", { enumerable: true, get: function () { return podfile_1.withIosWithoutAdIdSupport; } });
+Object.defineProperty(exports, "withIosGoogleAppMeasurementOnDeviceConversion", { enumerable: true, get: function () { return podfile_1.withIosGoogleAppMeasurementOnDeviceConversion; } });

package/plugin/build/ios/podfile.d.ts

@@ -0,0 +1,6 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import { PluginConfigType } from '../pluginConfig';
+export declare function setAnalyticsPodfileWithoutAdIdSupport(src: string, enabled?: boolean): string;
+export declare function setAnalyticsPodfileGoogleAppMeasurementOnDeviceConversion(src: string, enabled?: boolean): string;
+export declare const withIosGoogleAppMeasurementOnDeviceConversion: ConfigPlugin<PluginConfigType>;
+export declare const withIosWithoutAdIdSupport: ConfigPlugin<PluginConfigType>;