Improve and document onetrust patch

Author: 0x7f

examples/onetrust/patches/react-native-onetrust-cmp+202601.1.0.patch

@@ -2,10 +2,15 @@ diff --git a/node_modules/react-native-onetrust-cmp/android/src/main/java/com/on
 index 199531c..c3cfd17 100644
 --- a/node_modules/react-native-onetrust-cmp/android/src/main/java/com/onetrust/OneTrust.java
 +++ b/node_modules/react-native-onetrust-cmp/android/src/main/java/com/onetrust/OneTrust.java
-@@ -313,6 +313,34 @@ public class OneTrust extends ReactContextBaseJavaModule {
+@@ -313,6 +313,39 @@ public class OneTrust extends ReactContextBaseJavaModule {
          promise.resolve(googleConsentData.toString());
      }
 
++    @ReactMethod
++    public void fetchPreferencesCmpApiData(Promise promise){
++        promise.resolve(null);
++    }
++
 +    @ReactMethod
 +    public void getPreferenceCenterData(Promise promise){
 +        try {
@@ -38,13 +43,18 @@ index 199531c..c3cfd17 100644
      public void showConsentPurposesUI(){
          final Activity currentActivity = getCurrentActivity();
 diff --git a/node_modules/react-native-onetrust-cmp/iOS/OneTrust.m b/node_modules/react-native-onetrust-cmp/iOS/OneTrust.m
-index 2c1a676..630a711 100644
+index 2c1a676..c20f76a 100644
 --- a/node_modules/react-native-onetrust-cmp/iOS/OneTrust.m
 +++ b/node_modules/react-native-onetrust-cmp/iOS/OneTrust.m
-@@ -36,6 +36,16 @@ + (BOOL)requiresMainQueueSetup{
+@@ -36,6 +36,21 @@ + (BOOL)requiresMainQueueSetup{
                    rejecter:(RCTPromiseRejectBlock)reject
                    )
 
++RCT_EXTERN_METHOD(fetchPreferencesCmpApiData:
++                  (RCTPromiseResolveBlock)resolve
++                  rejecter:(RCTPromiseRejectBlock)reject
++                  )
++
 +RCT_EXTERN_METHOD(getPreferenceCenterData:
 +                  (RCTPromiseResolveBlock)resolve
 +                  rejecter:(RCTPromiseRejectBlock)reject
@@ -59,50 +69,88 @@ index 2c1a676..630a711 100644
                    (RCTPromiseResolveBlock)resolve
                    rejecter:(RCTPromiseRejectBlock)reject
 diff --git a/node_modules/react-native-onetrust-cmp/iOS/OneTrust.swift b/node_modules/react-native-onetrust-cmp/iOS/OneTrust.swift
-index 0030d64..dd789e7 100644
+index 0030d64..c9c97f0 100644
 --- a/node_modules/react-native-onetrust-cmp/iOS/OneTrust.swift
 +++ b/node_modules/react-native-onetrust-cmp/iOS/OneTrust.swift
-@@ -108,6 +108,32 @@ import AppTrackingTransparency
+@@ -108,6 +108,62 @@ import AppTrackingTransparency
 
      }
 
++    private func serializeToJSON(_ data: [String: Any]) -> String? {
++        guard JSONSerialization.isValidJSONObject(data),
++              let jsonData = try? JSONSerialization.data(withJSONObject: data),
++              let jsonString = String(data: jsonData, encoding: .utf8) else {
++            return nil
++        }
++        return jsonString
++    }
++
++    @objc(fetchPreferencesCmpApiData:rejecter:)
++    public func fetchPreferencesCmpApiData(_ resolve:@escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock){
++        OTPublishersHeadlessSDK.shared.fetchPreferencesCmpApiData { _ in
++            resolve(nil)
++        }
++    }
++
 +    @objc(getPreferenceCenterData:rejecter:)
 +    public func getPreferenceCenterData(_ resolve:@escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock){
-+        let data = OTPublishersHeadlessSDK.shared.getPreferenceCenterData()
-+        if let jsonData = try? JSONSerialization.data(withJSONObject: data),
-+           let jsonString = String(data: jsonData, encoding: .utf8) {
-+            resolve(jsonString)
-+        } else if let jsonString = data as? String {
-+            resolve(jsonString)
-+        } else {
-+            reject("Error parsing preference center data","OneTrust getPreferenceCenterData returned unsupported type.",nil)
++        if let data = OTPublishersHeadlessSDK.shared.getPreferenceCenterData() {
++            if let json = serializeToJSON(data) {
++                resolve(json)
++            } else {
++                reject("OT_GET_PREFERENCE_CENTER_DATA","OneTrust getPreferenceCenterData returned unsupported type.",nil)
++            }
++            return
++        }
++        OTPublishersHeadlessSDK.shared.fetchPreferencesCmpApiData { [weak self] _ in
++            guard let data = OTPublishersHeadlessSDK.shared.getPreferenceCenterData(),
++                  let json = self?.serializeToJSON(data) else {
++                resolve(nil)
++                return
++            }
++            resolve(json)
 +        }
 +    }
 +
 +    @objc(getBannerData:rejecter:)
 +    public func getBannerData(_ resolve:@escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock){
-+        let data = OTPublishersHeadlessSDK.shared.getBannerData()
-+        if let jsonData = try? JSONSerialization.data(withJSONObject: data),
-+           let jsonString = String(data: jsonData, encoding: .utf8) {
-+            resolve(jsonString)
-+        } else if let jsonString = data as? String {
-+            resolve(jsonString)
-+        } else {
-+            reject("Error parsing banner data","OneTrust getBannerData returned unsupported type.",nil)
++        if let data = OTPublishersHeadlessSDK.shared.getBannerData() {
++            if let json = serializeToJSON(data) {
++                resolve(json)
++            } else {
++                reject("OT_GET_BANNER_DATA","OneTrust getBannerData returned unsupported type.",nil)
++            }
++            return
++        }
++        OTPublishersHeadlessSDK.shared.fetchBannerCmpApiData { [weak self] _ in
++            guard let data = OTPublishersHeadlessSDK.shared.getBannerData(),
++                  let json = self?.serializeToJSON(data) else {
++                resolve(nil)
++                return
++            }
++            resolve(json)
 +        }
 +    }
 +    
      @objc(shouldShowBanner:rejecter:)
      public func shouldShowBanner(_ resolve:@escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) -> Void{
          let shouldShowBanner = OTPublishersHeadlessSDK.shared.shouldShowBanner()
 diff --git a/node_modules/react-native-onetrust-cmp/index.ts b/node_modules/react-native-onetrust-cmp/index.ts
-index f99e8c5..2facf15 100644
+index f99e8c5..33c48c8 100644
 --- a/node_modules/react-native-onetrust-cmp/index.ts
 +++ b/node_modules/react-native-onetrust-cmp/index.ts
-@@ -149,6 +149,28 @@ export default class OTPublishersNativeSDK{
+@@ -149,6 +149,36 @@ export default class OTPublishersNativeSDK{
        return JSON.parse(googleConsentModeData);
      }
 
++  /**
++   * Fetches preference center data from the OneTrust CMP API.
++   * Must be called before getPreferenceCenterData on SDK versions 202504.1.0+.
++   */
++  static async fetchPreferencesCmpApiData():Promise<void>{
++    await OneTrust.fetchPreferencesCmpApiData()
++  }
++
 +  /**
 +   * @returns Promise object is a dictionary of the preference center data
 +   */

packages/react-native-contentpass-cmp-onetrust/README.md

@@ -15,6 +15,38 @@ yarn add @contentpass/react-native-contentpass-cmp-onetrust
 - `@contentpass/react-native-contentpass`
 - `react-native-onetrust-cmp` — the OneTrust React Native SDK must be installed and configured in your project
 
+### Required patch for `react-native-onetrust-cmp`
+
+The upstream `react-native-onetrust-cmp` package does not expose `getPreferenceCenterData` and `getBannerData` as native methods, which this adapter requires. You need to apply a patch using [patch-package](https://github.com/ds300/patch-package).
+
+1. Install `patch-package`:
+   ```bash
+   npm install --save-dev patch-package postinstall-postinstall
+   ```
+2. Add a `postinstall` script to your `package.json`:
+   ```json
+   "scripts": {
+     "postinstall": "patch-package"
+   }
+   ```
+3. Copy the patch file from [`examples/onetrust/patches/`](../../examples/onetrust/patches/) into a `patches/` directory in your project root.
+4. Run `npm install` (or `yarn`) to apply the patch.
+
+### Expo config plugin
+
+This package ships an Expo config plugin that fixes a compatibility issue between `react-native-app-auth` and Expo SDK 55+. To use it, add both plugins to your `app.json`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      "react-native-app-auth",
+      "@contentpass/react-native-contentpass-cmp-onetrust"
+    ]
+  }
+}
+```
+
 ## Usage
 
 First, initialize the OneTrust SDK, then create the adapter using `createOnetrustCmpAdapter`:

packages/react-native-contentpass-cmp-onetrust/src/OnetrustCmpAdapter.ts

@@ -8,6 +8,8 @@ export async function createOnetrustCmpAdapter(
   sdk: OTPublishersNativeSDK
 ): Promise<OnetrustCmpAdapter> {
   try {
+    await sdk.fetchPreferencesCmpApiData();
+
     const bannerData = await sdk.getBannerData();
 
     const preferenceCenterData: PreferenceCenterData =

packages/react-native-contentpass-cmp-onetrust/src/react-native-onetrust-cmp.d.ts

@@ -15,6 +15,7 @@ declare module 'react-native-onetrust-cmp' {
   }
 
   export default interface OTPublishersNativeSDK {
+    fetchPreferencesCmpApiData(): Promise<void>;
     getBannerData(): Promise<any>;
     getPreferenceCenterData(): Promise<any>;
     saveConsent(interaction: OTConsentInteraction): Promise<void>;