@react-native-firebase/analytics 26.4.0 → 27.1.0

package/ios/RNFBAnalyticsUnitTests/HostStubs/Firebase/FIRAnalyticsHostStub.m

@@ -0,0 +1,304 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import <Firebase/Firebase.h>
+
+@implementation FIRAnalytics
+
+static NSString *sLastLogEventName;
+static NSDictionary *sLastLogEventParameters;
+static BOOL sAnalyticsCollectionEnabledValue;
+static NSString *sUserIDValue;
+static NSMutableDictionary *sUserProperties;
+static NSUInteger sResetAnalyticsDataCallCount;
+static NSTimeInterval sSessionTimeoutIntervalValue;
+static NSString *sAppInstanceIDValue;
+static int64_t sSessionIDCompletionValue;
+static NSError *sSessionIDCompletionError;
+static BOOL sSessionIDCompletionDeferred;
+static void (^sDeferredSessionIDCompletion)(int64_t, NSError *);
+static NSDictionary *sLastDefaultEventParameters;
+static NSString *sLastConversionEmail;
+static NSData *sLastHashedEmail;
+static NSString *sLastConversionPhone;
+static NSData *sLastHashedPhone;
+static NSDictionary *sLastConsent;
+static BOOL sShouldThrowOnNextCall;
+
++ (void)initialize {
+  if (self == [FIRAnalytics class]) {
+    sUserProperties = [NSMutableDictionary new];
+  }
+}
+
++ (NSString *)lastLogEventName {
+  return sLastLogEventName;
+}
+
++ (void)setLastLogEventName:(NSString *)lastLogEventName {
+  sLastLogEventName = [lastLogEventName copy];
+}
+
++ (NSDictionary *)lastLogEventParameters {
+  return sLastLogEventParameters;
+}
+
++ (void)setLastLogEventParameters:(NSDictionary *)lastLogEventParameters {
+  sLastLogEventParameters = [lastLogEventParameters copy];
+}
+
++ (BOOL)analyticsCollectionEnabledValue {
+  return sAnalyticsCollectionEnabledValue;
+}
+
++ (void)setAnalyticsCollectionEnabledValue:(BOOL)analyticsCollectionEnabledValue {
+  sAnalyticsCollectionEnabledValue = analyticsCollectionEnabledValue;
+}
+
++ (NSString *)userIDValue {
+  return sUserIDValue;
+}
+
++ (void)setUserIDValue:(NSString *)userIDValue {
+  sUserIDValue = [userIDValue copy];
+}
+
++ (NSMutableDictionary *)userProperties {
+  return sUserProperties;
+}
+
++ (void)setUserProperties:(NSMutableDictionary *)userProperties {
+  [sUserProperties removeAllObjects];
+  if (userProperties != nil) {
+    [sUserProperties addEntriesFromDictionary:userProperties];
+  }
+}
+
++ (NSUInteger)resetAnalyticsDataCallCount {
+  return sResetAnalyticsDataCallCount;
+}
+
++ (void)setResetAnalyticsDataCallCount:(NSUInteger)resetAnalyticsDataCallCount {
+  sResetAnalyticsDataCallCount = resetAnalyticsDataCallCount;
+}
+
++ (NSTimeInterval)sessionTimeoutIntervalValue {
+  return sSessionTimeoutIntervalValue;
+}
+
++ (void)setSessionTimeoutIntervalValue:(NSTimeInterval)sessionTimeoutIntervalValue {
+  sSessionTimeoutIntervalValue = sessionTimeoutIntervalValue;
+}
+
++ (NSString *)appInstanceIDValue {
+  return sAppInstanceIDValue;
+}
+
++ (void)setAppInstanceIDValue:(NSString *)appInstanceIDValue {
+  sAppInstanceIDValue = [appInstanceIDValue copy];
+}
+
++ (int64_t)sessionIDCompletionValue {
+  return sSessionIDCompletionValue;
+}
+
++ (void)setSessionIDCompletionValue:(int64_t)sessionIDCompletionValue {
+  sSessionIDCompletionValue = sessionIDCompletionValue;
+}
+
++ (NSError *)sessionIDCompletionError {
+  return sSessionIDCompletionError;
+}
+
++ (void)setSessionIDCompletionError:(NSError *)sessionIDCompletionError {
+  sSessionIDCompletionError = sessionIDCompletionError;
+}
+
++ (BOOL)sessionIDCompletionDeferred {
+  return sSessionIDCompletionDeferred;
+}
+
++ (void)setSessionIDCompletionDeferred:(BOOL)sessionIDCompletionDeferred {
+  sSessionIDCompletionDeferred = sessionIDCompletionDeferred;
+}
+
++ (NSDictionary *)lastDefaultEventParameters {
+  return sLastDefaultEventParameters;
+}
+
++ (void)setLastDefaultEventParameters:(NSDictionary *)lastDefaultEventParameters {
+  sLastDefaultEventParameters = [lastDefaultEventParameters copy];
+}
+
++ (NSString *)lastConversionEmail {
+  return sLastConversionEmail;
+}
+
++ (void)setLastConversionEmail:(NSString *)lastConversionEmail {
+  sLastConversionEmail = [lastConversionEmail copy];
+}
+
++ (NSData *)lastHashedEmail {
+  return sLastHashedEmail;
+}
+
++ (void)setLastHashedEmail:(NSData *)lastHashedEmail {
+  sLastHashedEmail = [lastHashedEmail copy];
+}
+
++ (NSString *)lastConversionPhone {
+  return sLastConversionPhone;
+}
+
++ (void)setLastConversionPhone:(NSString *)lastConversionPhone {
+  sLastConversionPhone = [lastConversionPhone copy];
+}
+
++ (NSData *)lastHashedPhone {
+  return sLastHashedPhone;
+}
+
++ (void)setLastHashedPhone:(NSData *)lastHashedPhone {
+  sLastHashedPhone = [lastHashedPhone copy];
+}
+
++ (NSDictionary *)lastConsent {
+  return sLastConsent;
+}
+
++ (void)setLastConsent:(NSDictionary *)lastConsent {
+  sLastConsent = [lastConsent copy];
+}
+
++ (BOOL)shouldThrowOnNextCall {
+  return sShouldThrowOnNextCall;
+}
+
++ (void)setShouldThrowOnNextCall:(BOOL)shouldThrowOnNextCall {
+  sShouldThrowOnNextCall = shouldThrowOnNextCall;
+}
+
++ (void)resetTestState {
+  sLastLogEventName = nil;
+  sLastLogEventParameters = nil;
+  sAnalyticsCollectionEnabledValue = NO;
+  sUserIDValue = nil;
+  [sUserProperties removeAllObjects];
+  sResetAnalyticsDataCallCount = 0;
+  sSessionTimeoutIntervalValue = 0;
+  sAppInstanceIDValue = nil;
+  sSessionIDCompletionValue = 0;
+  sSessionIDCompletionError = nil;
+  sSessionIDCompletionDeferred = NO;
+  sDeferredSessionIDCompletion = nil;
+  sLastDefaultEventParameters = nil;
+  sLastConversionEmail = nil;
+  sLastHashedEmail = nil;
+  sLastConversionPhone = nil;
+  sLastHashedPhone = nil;
+  sLastConsent = nil;
+  sShouldThrowOnNextCall = NO;
+}
+
++ (void)throwIfRequested {
+  if (sShouldThrowOnNextCall) {
+    sShouldThrowOnNextCall = NO;
+    @throw [NSException exceptionWithName:@"FIRAnalyticsTestException"
+                                   reason:@"stub throw"
+                                 userInfo:nil];
+  }
+}
+
++ (void)flushDeferredSessionIDCompletion {
+  if (sDeferredSessionIDCompletion != nil) {
+    void (^completion)(int64_t, NSError *) = sDeferredSessionIDCompletion;
+    sDeferredSessionIDCompletion = nil;
+    completion(sSessionIDCompletionValue, sSessionIDCompletionError);
+  }
+}
+
++ (void)logEventWithName:(NSString *)name parameters:(NSDictionary<NSString *, id> *)parameters {
+  [self throwIfRequested];
+  sLastLogEventName = [name copy];
+  sLastLogEventParameters = [parameters copy];
+}
+
++ (void)setAnalyticsCollectionEnabled:(BOOL)enabled {
+  [self throwIfRequested];
+  sAnalyticsCollectionEnabledValue = enabled;
+}
+
++ (void)setUserID:(NSString *)userID {
+  [self throwIfRequested];
+  sUserIDValue = [userID copy];
+}
+
++ (void)setUserPropertyString:(NSString *)value forName:(NSString *)name {
+  [self throwIfRequested];
+  if (name == nil) {
+    return;
+  }
+  if (value == nil) {
+    [sUserProperties removeObjectForKey:name];
+  } else {
+    sUserProperties[name] = value;
+  }
+}
+
++ (void)resetAnalyticsData {
+  [self throwIfRequested];
+  sResetAnalyticsDataCallCount += 1;
+}
+
++ (void)setSessionTimeoutInterval:(NSTimeInterval)sessionTimeoutInterval {
+  [self throwIfRequested];
+  sSessionTimeoutIntervalValue = sessionTimeoutInterval;
+}
+
++ (NSString *)appInstanceID {
+  [self throwIfRequested];
+  return sAppInstanceIDValue;
+}
+
++ (void)sessionIDWithCompletion:(void (^)(int64_t sessionID, NSError *_Nullable error))completion {
+  [self throwIfRequested];
+  if (sSessionIDCompletionDeferred) {
+    sDeferredSessionIDCompletion = [completion copy];
+    return;
+  }
+  if (completion != nil) {
+    completion(sSessionIDCompletionValue, sSessionIDCompletionError);
+  }
+}
+
++ (void)setDefaultEventParameters:(NSDictionary<NSString *, id> *)parameters {
+  [self throwIfRequested];
+  sLastDefaultEventParameters = [parameters copy];
+}
+
++ (void)initiateOnDeviceConversionMeasurementWithEmailAddress:(NSString *)emailAddress {
+  [self throwIfRequested];
+  sLastConversionEmail = [emailAddress copy];
+}
+
++ (void)initiateOnDeviceConversionMeasurementWithHashedEmailAddress:(NSData *)hashedEmailAddress {
+  [self throwIfRequested];
+  sLastHashedEmail = [hashedEmailAddress copy];
+}
+
++ (void)initiateOnDeviceConversionMeasurementWithPhoneNumber:(NSString *)phoneNumber {
+  [self throwIfRequested];
+  sLastConversionPhone = [phoneNumber copy];
+}
+
++ (void)initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:(NSData *)hashedPhoneNumber {
+  [self throwIfRequested];
+  sLastHashedPhone = [hashedPhoneNumber copy];
+}
+
++ (void)setConsent:(NSDictionary *)consentSettings {
+  [self throwIfRequested];
+  sLastConsent = [consentSettings copy];
+}
+
+@end

package/ios/RNFBAnalyticsUnitTests/HostStubs/Firebase/Firebase.h

@@ -0,0 +1,71 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ * Mirrors Firebase Analytics `kFIRParameter*` / `FIRConsentType*` /
+ * `FIRConsentStatus*` string values and enough of `FIRAnalytics` for
+ * compiling `RNFBAnalyticsHelper.m` without linking the real SDK.
+ */
+#import <Foundation/Foundation.h>
+
+static NSString *const kFIRParameterQuantity = @"quantity";
+static NSString *const kFIRParameterIndex = @"index";
+static NSString *const kFIRParameterLevel = @"level";
+static NSString *const kFIRParameterNumberOfNights = @"number_of_nights";
+static NSString *const kFIRParameterNumberOfPassengers = @"number_of_passengers";
+static NSString *const kFIRParameterNumberOfRooms = @"number_of_rooms";
+static NSString *const kFIRParameterScore = @"score";
+static NSString *const kFIRParameterItems = @"items";
+static NSString *const kFIRParameterSuccess = @"success";
+static NSString *const kFIRParameterExtendSession = @"extend_session";
+
+typedef NSString *FIRConsentType;
+typedef NSString *FIRConsentStatus;
+
+static FIRConsentType const FIRConsentTypeAdStorage = @"ad_storage";
+static FIRConsentType const FIRConsentTypeAnalyticsStorage = @"analytics_storage";
+static FIRConsentType const FIRConsentTypeAdUserData = @"ad_user_data";
+static FIRConsentType const FIRConsentTypeAdPersonalization = @"ad_personalization";
+static FIRConsentStatus const FIRConsentStatusDenied = @"denied";
+static FIRConsentStatus const FIRConsentStatusGranted = @"granted";
+
+@interface FIRAnalytics : NSObject
+
++ (void)logEventWithName:(NSString *)name
+              parameters:(nullable NSDictionary<NSString *, id> *)parameters;
++ (void)setAnalyticsCollectionEnabled:(BOOL)enabled;
++ (void)setUserID:(nullable NSString *)userID;
++ (void)setUserPropertyString:(nullable NSString *)value forName:(NSString *)name;
++ (void)resetAnalyticsData;
++ (void)setSessionTimeoutInterval:(NSTimeInterval)sessionTimeoutInterval;
++ (nullable NSString *)appInstanceID;
++ (void)sessionIDWithCompletion:(void (^)(int64_t sessionID, NSError *_Nullable error))completion;
++ (void)setDefaultEventParameters:(nullable NSDictionary<NSString *, id> *)parameters;
++ (void)initiateOnDeviceConversionMeasurementWithEmailAddress:(NSString *)emailAddress;
++ (void)initiateOnDeviceConversionMeasurementWithHashedEmailAddress:(NSData *)hashedEmailAddress;
++ (void)initiateOnDeviceConversionMeasurementWithPhoneNumber:(NSString *)phoneNumber;
++ (void)initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:(NSData *)hashedPhoneNumber;
++ (void)setConsent:(NSDictionary<FIRConsentType, FIRConsentStatus> *)consentSettings;
+
+/** Test seams */
+@property(class, nonatomic, copy, nullable) NSString *lastLogEventName;
+@property(class, nonatomic, copy, nullable) NSDictionary *lastLogEventParameters;
+@property(class, nonatomic, assign) BOOL analyticsCollectionEnabledValue;
+@property(class, nonatomic, copy, nullable) NSString *userIDValue;
+@property(class, nonatomic, copy, nullable) NSMutableDictionary *userProperties;
+@property(class, nonatomic, assign) NSUInteger resetAnalyticsDataCallCount;
+@property(class, nonatomic, assign) NSTimeInterval sessionTimeoutIntervalValue;
+@property(class, nonatomic, copy, nullable) NSString *appInstanceIDValue;
+@property(class, nonatomic, assign) int64_t sessionIDCompletionValue;
+@property(class, nonatomic, copy, nullable) NSError *sessionIDCompletionError;
+@property(class, nonatomic, assign) BOOL sessionIDCompletionDeferred;
+@property(class, nonatomic, copy, nullable) NSDictionary *lastDefaultEventParameters;
+@property(class, nonatomic, copy, nullable) NSString *lastConversionEmail;
+@property(class, nonatomic, copy, nullable) NSData *lastHashedEmail;
+@property(class, nonatomic, copy, nullable) NSString *lastConversionPhone;
+@property(class, nonatomic, copy, nullable) NSData *lastHashedPhone;
+@property(class, nonatomic, copy, nullable) NSDictionary *lastConsent;
+@property(class, nonatomic, assign) BOOL shouldThrowOnNextCall;
+
++ (void)resetTestState;
++ (void)flushDeferredSessionIDCompletion;
+
+@end

package/ios/RNFBAnalyticsUnitTests/HostStubs/RNFBAnalytics/RNFBAnalyticsLogTransactionHostStub.h

@@ -0,0 +1,20 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ * Declares the ObjC surface of `RNFBAnalyticsLogTransaction` so
+ * `RNFBAnalyticsHelper.m` compiles without StoreKit / FirebaseAnalytics.
+ */
+#import <Foundation/Foundation.h>
+#import <React/RCTBridgeModule.h>
+
+@interface RNFBAnalyticsLogTransaction : NSObject
+
+@property(class, nonatomic, copy, nullable) NSString *lastTransactionId;
+@property(class, nonatomic, assign) NSUInteger logCallCount;
+
++ (void)resetTestState;
+
+- (void)logTransactionWithTransactionId:(NSString *)transactionId
+                                resolve:(RCTPromiseResolveBlock)resolve
+                                 reject:(RCTPromiseRejectBlock)reject;
+
+@end

package/ios/RNFBAnalyticsUnitTests/HostStubs/RNFBAnalytics/RNFBAnalyticsLogTransactionHostStub.m

@@ -0,0 +1,43 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import "RNFBAnalytics/RNFBAnalyticsLogTransactionHostStub.h"
+
+@implementation RNFBAnalyticsLogTransaction
+
+static NSString *sLastTransactionId;
+static NSUInteger sLogCallCount;
+
++ (NSString *)lastTransactionId {
+  return sLastTransactionId;
+}
+
++ (void)setLastTransactionId:(NSString *)lastTransactionId {
+  sLastTransactionId = [lastTransactionId copy];
+}
+
++ (NSUInteger)logCallCount {
+  return sLogCallCount;
+}
+
++ (void)setLogCallCount:(NSUInteger)logCallCount {
+  sLogCallCount = logCallCount;
+}
+
++ (void)resetTestState {
+  sLastTransactionId = nil;
+  sLogCallCount = 0;
+}
+
+- (void)logTransactionWithTransactionId:(NSString *)transactionId
+                                resolve:(RCTPromiseResolveBlock)resolve
+                                 reject:(RCTPromiseRejectBlock)reject {
+  (void)reject;
+  sLastTransactionId = [transactionId copy];
+  sLogCallCount += 1;
+  if (resolve != nil) {
+    resolve([NSNull null]);
+  }
+}
+
+@end

package/ios/RNFBAnalyticsUnitTests/HostStubs/RNFBApp/RNFBSharedUtils.h

@@ -0,0 +1,21 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import <Foundation/Foundation.h>
+#import <React/RCTBridgeModule.h>
+
+#ifdef DEBUG
+#define DLog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
+#else
+#define DLog(...)
+#endif
+
+@interface RNFBSharedUtils : NSObject
+
++ (void)rejectPromiseWithExceptionDict:(RCTPromiseRejectBlock)reject
+                             exception:(NSException *)exception;
+
++ (void)rejectPromiseWithUserInfo:(RCTPromiseRejectBlock)reject
+                         userInfo:(NSMutableDictionary *)userInfo;
+
+@end

package/ios/RNFBAnalyticsUnitTests/HostStubs/RNFBApp/RNFBSharedUtilsHostStub.m

@@ -0,0 +1,26 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import "RNFBApp/RNFBSharedUtils.h"
+
+@implementation RNFBSharedUtils
+
++ (void)rejectPromiseWithExceptionDict:(RCTPromiseRejectBlock)reject
+                             exception:(NSException *)exception {
+  if (reject == nil) {
+    return;
+  }
+  reject(@"unknown", exception.reason ?: @"", nil);
+}
+
++ (void)rejectPromiseWithUserInfo:(RCTPromiseRejectBlock)reject
+                         userInfo:(NSMutableDictionary *)userInfo {
+  if (reject == nil) {
+    return;
+  }
+  NSString *code = userInfo[@"code"] ?: @"unknown";
+  NSString *message = userInfo[@"message"] ?: @"";
+  reject(code, message, nil);
+}
+
+@end

package/ios/RNFBAnalyticsUnitTests/HostStubs/React/RCTBridgeModule.h

@@ -0,0 +1,10 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import <Foundation/Foundation.h>
+
+typedef void (^RCTPromiseResolveBlock)(id result);
+typedef void (^RCTPromiseRejectBlock)(NSString *code, NSString *message, NSError *error);
+
+@protocol RCTBridgeModule <NSObject>
+@end

package/ios/RNFBAnalyticsUnitTests/RNFBAnalyticsConsentSettingsMapperHostStubTests.m

@@ -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 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 <XCTest/XCTest.h>
+
+#import <Firebase/Firebase.h>
+
+#if __has_include("RNFBAnalyticsJavascriptParamsCleaner-Swift.inc")
+#import "RNFBAnalyticsJavascriptParamsCleaner-Swift.inc"
+#elif __has_include("RNFBAnalyticsUnitTests-Swift.h")
+#import "RNFBAnalyticsUnitTests-Swift.h"
+#else
+#error "RNFBAnalyticsConsentSettingsMapper Swift interface not found"
+#endif
+
+@interface RNFBAnalyticsConsentSettingsMapperHostStubTests : XCTestCase
+@end
+
+@implementation RNFBAnalyticsConsentSettingsMapperHostStubTests
+
+- (void)testConsentConstants_matchHostStubFirebaseConstants {
+  XCTAssertEqualObjects(RNFBAnalyticsConsentSettingsMapper.consentTypeAnalyticsStorageValue,
+                        FIRConsentTypeAnalyticsStorage);
+  XCTAssertEqualObjects(RNFBAnalyticsConsentSettingsMapper.consentTypeAdStorageValue,
+                        FIRConsentTypeAdStorage);
+  XCTAssertEqualObjects(RNFBAnalyticsConsentSettingsMapper.consentTypeAdUserDataValue,
+                        FIRConsentTypeAdUserData);
+  XCTAssertEqualObjects(RNFBAnalyticsConsentSettingsMapper.consentTypeAdPersonalizationValue,
+                        FIRConsentTypeAdPersonalization);
+  XCTAssertEqualObjects(RNFBAnalyticsConsentSettingsMapper.consentStatusGrantedValue,
+                        FIRConsentStatusGranted);
+  XCTAssertEqualObjects(RNFBAnalyticsConsentSettingsMapper.consentStatusDeniedValue,
+                        FIRConsentStatusDenied);
+}
+
+- (void)testConsentDictionary_usesHostStubConsentTypeAndStatusKeys {
+  NSDictionary *consent = [RNFBAnalyticsConsentSettingsMapper consentDictionaryFromSettings:@{
+    @"analytics_storage" : @YES,
+    @"ad_storage" : @NO,
+    @"ad_user_data" : @YES,
+    @"ad_personalization" : @NO,
+  }];
+  XCTAssertEqualObjects(consent[FIRConsentTypeAnalyticsStorage], FIRConsentStatusGranted);
+  XCTAssertEqualObjects(consent[FIRConsentTypeAdStorage], FIRConsentStatusDenied);
+  XCTAssertEqualObjects(consent[FIRConsentTypeAdUserData], FIRConsentStatusGranted);
+  XCTAssertEqualObjects(consent[FIRConsentTypeAdPersonalization], FIRConsentStatusDenied);
+}
+
+@end

package/ios/RNFBAnalyticsUnitTests/RNFBAnalyticsConsentSettingsMapperTests.swift

@@ -0,0 +1,91 @@
+/**
+ * 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 XCTest
+
+final class RNFBAnalyticsConsentSettingsMapperTests: XCTestCase {
+  func testConsentTypeStatusConstants_matchFirebaseStrings() {
+    XCTAssertEqual(
+      RNFBAnalyticsConsentSettingsMapper.consentTypeAnalyticsStorageValue, "analytics_storage")
+    XCTAssertEqual(RNFBAnalyticsConsentSettingsMapper.consentTypeAdStorageValue, "ad_storage")
+    XCTAssertEqual(RNFBAnalyticsConsentSettingsMapper.consentTypeAdUserDataValue, "ad_user_data")
+    XCTAssertEqual(
+      RNFBAnalyticsConsentSettingsMapper.consentTypeAdPersonalizationValue, "ad_personalization")
+    XCTAssertEqual(RNFBAnalyticsConsentSettingsMapper.consentStatusGrantedValue, "granted")
+    XCTAssertEqual(RNFBAnalyticsConsentSettingsMapper.consentStatusDeniedValue, "denied")
+  }
+
+  func testConsentDictionary_nilSettings_returnsEmpty() {
+    let result = RNFBAnalyticsConsentSettingsMapper.consentDictionary(from: nil)
+    XCTAssertEqual(result.count, 0)
+  }
+
+  func testConsentDictionary_emptySettings_returnsEmpty() {
+    let result = RNFBAnalyticsConsentSettingsMapper.consentDictionary(from: [:])
+    XCTAssertEqual(result.count, 0)
+  }
+
+  func testConsentDictionary_omitsMissingKeys() {
+    let result = RNFBAnalyticsConsentSettingsMapper.consentDictionary(from: [
+      "analytics_storage": true
+    ] as NSDictionary)
+    XCTAssertEqual(result.count, 1)
+    XCTAssertEqual(result["analytics_storage"] as? String, "granted")
+    XCTAssertNil(result["ad_storage"])
+    XCTAssertNil(result["ad_user_data"])
+    XCTAssertNil(result["ad_personalization"])
+  }
+
+  func testConsentDictionary_trueBecomesGranted_falseBecomesDenied() {
+    let result = RNFBAnalyticsConsentSettingsMapper.consentDictionary(from: [
+      "analytics_storage": true,
+      "ad_storage": false,
+      "ad_user_data": NSNumber(value: true),
+      "ad_personalization": NSNumber(value: 0),
+    ] as NSDictionary)
+
+    XCTAssertEqual(result["analytics_storage"] as? String, "granted")
+    XCTAssertEqual(result["ad_storage"] as? String, "denied")
+    XCTAssertEqual(result["ad_user_data"] as? String, "granted")
+    XCTAssertEqual(result["ad_personalization"] as? String, "denied")
+  }
+
+  func testConsentDictionary_ignoresUnknownKeys() {
+    let result = RNFBAnalyticsConsentSettingsMapper.consentDictionary(from: [
+      "analytics_storage": true,
+      "security_storage": true,
+      "other": false,
+    ] as NSDictionary)
+    XCTAssertEqual(result.count, 1)
+    XCTAssertEqual(result["analytics_storage"] as? String, "granted")
+    XCTAssertNil(result["security_storage"])
+    XCTAssertNil(result["other"])
+  }
+
+  func testConsentDictionary_allFourKeys() {
+    let result = RNFBAnalyticsConsentSettingsMapper.consentDictionary(from: [
+      "analytics_storage": false,
+      "ad_storage": true,
+      "ad_user_data": false,
+      "ad_personalization": true,
+    ] as NSDictionary)
+    XCTAssertEqual(result.count, 4)
+    XCTAssertEqual(result["analytics_storage"] as? String, "denied")
+    XCTAssertEqual(result["ad_storage"] as? String, "granted")
+    XCTAssertEqual(result["ad_user_data"] as? String, "denied")
+    XCTAssertEqual(result["ad_personalization"] as? String, "granted")
+  }
+}