Usercentrics · uc-christiansousa · Mar 20, 2026 · qodo-code-review · Mar 20, 2026 · pantoaibot
diff --git a/android/src/main/java/com/usercentrics/reactnative/RNUsercentricsModule.kt b/android/src/main/java/com/usercentrics/reactnative/RNUsercentricsModule.kt
@@ -85,6 +85,16 @@ internal class RNUsercentricsModule(
         promise.resolve(usercentricsProxy.instance.getABTestingVariant())
     }
 
+    @ReactMethod
+    override fun getDpsMetadata(templateId: String, promise: Promise) {
+        val metadata = usercentricsProxy.instance.getDpsMetadata(templateId)
+        if (metadata == null) {
+            promise.resolve(null)
+        } else {
+            promise.resolve(metadata.toWritableMap())
+        }
+    }
+
     @ReactMethod
     override fun getConsents(promise: Promise) {
         promise.resolve(usercentricsProxy.instance.getConsents().toWritableArray())

diff --git a/android/src/main/java/com/usercentrics/reactnative/RNUsercentricsModuleSpec.kt b/android/src/main/java/com/usercentrics/reactnative/RNUsercentricsModuleSpec.kt
@@ -60,6 +60,9 @@ abstract class RNUsercentricsModuleSpec internal constructor(context: ReactAppli
     @ReactMethod
     abstract fun getABTestingVariant(promise: Promise)
 
+    @ReactMethod
+    abstract fun getDpsMetadata(templateId: String, promise: Promise)
+
     @ReactMethod
     abstract fun setCMPId(id: Double)
 

diff --git a/example/ios/exampleTests/Fake/FakeUsercentricsManager.swift b/example/ios/exampleTests/Fake/FakeUsercentricsManager.swift
@@ -118,6 +118,13 @@ final class FakeUsercentricsManager: UsercentricsManager {
     callback(getTCFDataResponse!)
   }
 
+  var getDpsMetadataResponse: [String: Any]?
+  var getDpsMetadataTemplateId: String?
+  func getDpsMetadata(templateId: String) -> [String: Any]? {
+    getDpsMetadataTemplateId = templateId
+    return getDpsMetadataResponse
+  }
+
   var getAdditionalConsentModeDataResponse: AdditionalConsentModeData?
   func getAdditionalConsentModeData() -> AdditionalConsentModeData {
     return getAdditionalConsentModeDataResponse!

diff --git a/example/ios/exampleTests/RNUsercentricsModuleTests.swift b/example/ios/exampleTests/RNUsercentricsModuleTests.swift
@@ -563,6 +563,43 @@ class RNUsercentricsModuleTests: XCTestCase {
     }
   }
 
+  func testGetDpsMetadataWithValidData() {
+    fakeUsercentrics.getDpsMetadataResponse = ["partner": "appsflyer", "source": "campaign_1"]
+    module.getDpsMetadata("template123") { result in
+      guard let result = result as? NSDictionary else {
+        XCTFail()
+        return
+      }
+      XCTAssertEqual("appsflyer", result["partner"] as! String)
+      XCTAssertEqual("campaign_1", result["source"] as! String)
+    } reject: { _, _, _ in
+      XCTFail("Should not go here")
+    }
+    XCTAssertEqual("template123", fakeUsercentrics.getDpsMetadataTemplateId)
+  }
+
+  func testGetDpsMetadataWhenNull() {
+    fakeUsercentrics.getDpsMetadataResponse = nil
+    module.getDpsMetadata("nonExistent") { result in
+      XCTAssertNil(result)
+    } reject: { _, _, _ in
+      XCTFail("Should not go here")
+    }
+  }
+
+  func testGetDpsMetadataWithEmptyMap() {
+    fakeUsercentrics.getDpsMetadataResponse = [:]
+    module.getDpsMetadata("template123") { result in
+      guard let result = result as? NSDictionary else {
+        XCTFail()
+        return
+      }
+      XCTAssertEqual(0, result.count)
+    } reject: { _, _, _ in
+      XCTFail("Should not go here")
+    }
+  }
+
   func testGetAdditionalConsentModeData() {
     let expected = AdditionalConsentModeData(acString: "2~43.46.55~dv.",
                                              adTechProviders: [AdTechProvider(id: 43, name: "AdPredictive", privacyPolicyUrl: "https://adpredictive.com/privacy", consent: true)])

diff --git a/ios/Manager/UsercentricsManager.swift b/ios/Manager/UsercentricsManager.swift
@@ -24,6 +24,7 @@ public protocol UsercentricsManager {
     func setGPPConsent(sectionName: String, fieldName: String, value: Any)
     func getTCFData(callback: @escaping (TCFData) -> Void)
     func getABTestingVariant() -> String?
+    func getDpsMetadata(templateId: String) -> [String: Any]?
     func getAdditionalConsentModeData() -> AdditionalConsentModeData
     func onGppSectionChange(callback: @escaping (GppSectionChangePayload) -> Void) -> UsercentricsDisposableEvent<GppSectionChangePayload>
 
@@ -116,6 +117,10 @@ final class UsercentricsManagerImplementation: UsercentricsManager {
         UsercentricsCore.shared.getTCFData(callback: callback)
     }
 
+    func getDpsMetadata(templateId: String) -> [String: Any]? {
+        return UsercentricsCore.shared.getDpsMetadata(templateId: templateId)
+    }
+
     func getAdditionalConsentModeData() -> AdditionalConsentModeData {
         return UsercentricsCore.shared.getAdditionalConsentModeData()
     }

diff --git a/ios/RNUsercentricsModule.swift b/ios/RNUsercentricsModule.swift
@@ -159,6 +159,11 @@ class RNUsercentricsModule: RCTEventEmitter {
         resolve(usercentricsManager.getABTestingVariant())
     }
 
+    @objc func getDpsMetadata(_ templateId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        let metadata = usercentricsManager.getDpsMetadata(templateId: templateId)
+        resolve(metadata as NSDictionary?)
+    }
+
     @objc func getAdditionalConsentModeData(_ resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
         resolve(usercentricsManager.getAdditionalConsentModeData().toDictionary())
     }

diff --git a/ios/RNUsercentricsModuleSpec.h b/ios/RNUsercentricsModuleSpec.h
@@ -36,6 +36,10 @@ NS_ASSUME_NONNULL_BEGIN
 - (void)getCMPData:(RCTPromiseResolveBlock)resolve
             reject:(RCTPromiseRejectBlock)reject;
 
+- (void)getDpsMetadata:(NSString *)templateId
+               resolve:(RCTPromiseResolveBlock)resolve
+                reject:(RCTPromiseRejectBlock)reject;
+
 - (void)getAdditionalConsentModeData:(RCTPromiseResolveBlock)resolve
                               reject:(RCTPromiseRejectBlock)reject;
 

diff --git a/sample/ios/sampleTests/Fake/FakeUsercentricsManager.swift b/sample/ios/sampleTests/Fake/FakeUsercentricsManager.swift
@@ -119,6 +119,13 @@ final class FakeUsercentricsManager: UsercentricsManager {
     callback(getTCFDataResponse!)
   }
 
+  var getDpsMetadataResponse: [String: Any]?
+  var getDpsMetadataTemplateId: String?
+  func getDpsMetadata(templateId: String) -> [String: Any]? {
+    getDpsMetadataTemplateId = templateId
+    return getDpsMetadataResponse
+  }
+
   var getAdditionalConsentModeDataResponse: AdditionalConsentModeData?
   func getAdditionalConsentModeData() -> AdditionalConsentModeData {
     return getAdditionalConsentModeDataResponse!

diff --git a/sample/ios/sampleTests/RNUsercentricsModuleTests.swift b/sample/ios/sampleTests/RNUsercentricsModuleTests.swift
@@ -564,6 +564,43 @@ class RNUsercentricsModuleTests: XCTestCase {
     }
   }
 
+  func testGetDpsMetadataWithValidData() {
+    fakeUsercentrics.getDpsMetadataResponse = ["partner": "appsflyer", "source": "campaign_1"]
+    module.getDpsMetadata("template123") { result in
+      guard let result = result as? NSDictionary else {
+        XCTFail()
+        return
+      }
+      XCTAssertEqual("appsflyer", result["partner"] as! String)
+      XCTAssertEqual("campaign_1", result["source"] as! String)
+    } reject: { _, _, _ in
+      XCTFail("Should not go here")
+    }
+    XCTAssertEqual("template123", fakeUsercentrics.getDpsMetadataTemplateId)
+  }
+
+  func testGetDpsMetadataWhenNull() {
+    fakeUsercentrics.getDpsMetadataResponse = nil
+    module.getDpsMetadata("nonExistent") { result in
+      XCTAssertNil(result)
+    } reject: { _, _, _ in
+      XCTFail("Should not go here")
+    }
+  }
+
+  func testGetDpsMetadataWithEmptyMap() {
+    fakeUsercentrics.getDpsMetadataResponse = [:]
+    module.getDpsMetadata("template123") { result in
+      guard let result = result as? NSDictionary else {
+        XCTFail()
+        return
+      }
+      XCTAssertEqual(0, result.count)
+    } reject: { _, _, _ in
+      XCTFail("Should not go here")
+    }
+  }
+
   func testGetAdditionalConsentModeData() {
     let expected = AdditionalConsentModeData(acString: "2~43.46.55~dv.",
                                              adTechProviders: [AdTechProvider(id: 43, name: "AdPredictive", privacyPolicyUrl: "https://adpredictive.com/privacy", consent: true)])

diff --git a/src/NativeUsercentrics.ts b/src/NativeUsercentrics.ts
@@ -40,6 +40,7 @@ export interface Spec extends TurboModule {
   getGPPData(): Promise<GppData>;
   getGPPString(): Promise<string | null>;
   getABTestingVariant(): Promise<string>;
+  getDpsMetadata(templateId: string): Promise<Record<string, unknown> | null>;
 
   // Configuration Setters
   setCMPId(id: number): void;

diff --git a/src/Usercentrics.tsx b/src/Usercentrics.tsx
@@ -100,6 +100,11 @@ export const Usercentrics = {
         return RNUsercentricsModule.getAdditionalConsentModeData();
     },
 
+    getDpsMetadata: async (templateId: string): Promise<Record<string, unknown> | null> => {
+        await RNUsercentricsModule.isReady();
+        return RNUsercentricsModule.getDpsMetadata(templateId);
-        return RNUsercentricsModule.getDpsMetadata(templateId);
+        if (typeof RNUsercentricsModule.getDpsMetadata !== 'function') {
+            throw new Error('Usercentrics React Native SDK: getDpsMetadata is not available in this native build.');
+        }
-        return RNUsercentricsModule.getDpsMetadata(templateId);
+        if (typeof RNUsercentricsModule.getDpsMetadata !== 'function') {
+            throw new Error('Usercentrics React Native SDK: getDpsMetadata is not available in this native build.');
+        }
+    },
+
     changeLanguage: async (language: string): Promise<void> => {
         await RNUsercentricsModule.isReady();
         return RNUsercentricsModule.changeLanguage(language);

diff --git a/src/__tests__/index.test.ts b/src/__tests__/index.test.ts
@@ -61,6 +61,7 @@ jest.mock("react-native", () => {
         setGPPConsent: jest.fn(),
         track: jest.fn(),
         reset: jest.fn(),
+        getDpsMetadata: jest.fn(),
         clearUserSession: jest.fn(),
         addListener: jest.fn(),
         removeListeners: jest.fn()
@@ -455,6 +456,37 @@ describe('Test Usercentrics Module', () => {
         expect(data).toStrictEqual(response)
     })
 
+    test('testGetDpsMetadataWithValidData', async () => {
+        const metadata = { partner: "appsflyer", source: "campaign_1" };
+        RNUsercentricsModule.getDpsMetadata.mockImplementationOnce(
+            (): Promise<any> => Promise.resolve(metadata)
+        )
+
+        const data = await Usercentrics.getDpsMetadata("templateId123");
+        expect(data).toStrictEqual(metadata);
+
+        const call = RNUsercentricsModule.getDpsMetadata.mock.calls[0][0];
+        expect(call).toBe("templateId123");
+    })
+
+    test('testGetDpsMetadataWhenNull', async () => {
+        RNUsercentricsModule.getDpsMetadata.mockImplementationOnce(
+            (): Promise<any> => Promise.resolve(null)
+        )
+
+        const data = await Usercentrics.getDpsMetadata("nonExistentId");
+        expect(data).toBe(null);
+    })
+
+    test('testGetDpsMetadataWithEmptyObject', async () => {
+        RNUsercentricsModule.getDpsMetadata.mockImplementationOnce(
+            (): Promise<any> => Promise.resolve({})
+        )
+
+        const data = await Usercentrics.getDpsMetadata("templateId123");
+        expect(data).toStrictEqual({});
+    })
+
     test('testClearUserSession', async () => {
         const readyStatus = new UsercentricsReadyStatus(
           true,

diff --git a/src/fabric/NativeUsercentricsModule.ts b/src/fabric/NativeUsercentricsModule.ts
@@ -25,6 +25,7 @@ export interface Spec extends TurboModule {
   getGPPData(): Promise<Object>;
   getGPPString(): Promise<string | null>;
   getABTestingVariant(): Promise<string>;
+  getDpsMetadata(templateId: string): Promise<Object | null>;
 
   // Configuration Setters
   setCMPId(id: number): void;