securiti-consent-sdk 1.132.1 → 1.132.2

package/README.md

@@ -1,4 +1,4 @@
-# Description
+# React Native Consent SDK Documentation
 
 A React Native Library for managing user consent preferences and compliance with privacy regulations. Integrates with Securiti's Consent Management Platform.
 
@@ -7,39 +7,1408 @@ A React Native Library for managing user consent preferences and compliance with
 - Android API 24+
 - React Native 0.73.0+
 
-## Structure
-- [`android/`](android): All your `android`-specific implementations.
-  - [`build.gradle`](android/build.gradle): The gradle build file. This contains four important pieces:
-    1. Standard react-native library boilerplate code
-    2. Configures Kotlin (`apply plugin: 'org.jetbrains.kotlin.android'`)
-    3. Adds all Nitrogen files (`apply from: '.../NitroSecuritiConsentSdk+autolinking.gradle'`)
-    4. Triggers the native C++ build (via CMake/`externalNativeBuild`)
-    5. Make sure you add this repositories block above the 'dependencies' block in your application's [`build.gradle`](android/build.gradle) file:
+
+## Table of Contents
+
+1. [Important](#important)
+2. [Step 1: Installation Steps](#step-1-installation-steps)
+3. [Step 2: Android Installation Steps](#step-2-android-installation-steps)
+4. [iOS Installation Steps](#ios-installation-steps)
+5. [Methods](#methods)
+    - [initialize(options)](#initializeoptions)
+    - [getConsentByPurposeId(purposeId)](#getconsentbypurposeidpurposeid)
+    - [getConsentByPermissionId(permissionId)](#getconsentbypermissionidpermissionid)
+    - [getPermissions()](#getpermissions)
+    - [getPurposes()](#getpurposes)
+    - [getSdksInPurpose(purposeId)](#getsdksinpurposepurposeid)
+    - [setPurposeConsent(purpose, consent)](#setpurposeconsentpurpose-consent)
+    - [setPermissionConsent(appPermission, consent)](#setpermissionconsentapppermission-consent)
+    - [resetConsents()](#resetconsents)
+    - [isReady(callback)](#isreadycallback)
+    - [getBannerConfig()](#getbannerconfig)
+    - [options()](#options)
+    - [getSettingsPrompt()](#getsettingsprompt)
+    - [uploadConsents(request)](#uploadconsentsrequest)
+    - [presentConsentBanner()](#presentconsentbanner)
+    - [presentPreferenceCenter()](#presentpreferencecenter)
+6. [Types and Properties](#types-and-properties)
+7. [Using Methods](#using-methods)
+
+---
+
+## Important
+
+This document contains information related to the React Native Consent SDK by Securiti, including installation, configuration, and usage of all available methods. The SDK name and API are subject to change.
+
+---
+
+## Step 1: Installation Steps
+
+1. Add the SDK to your `package.json`:
+    ```sh
+    npm i react-native-nitro-modules
+    npm i securiti-consent-sdk@latest
+    ```
+2. Run:
+    ```sh
+    npm install
+    ```
+3. Ensure `node_modules/securiti-consent-sdk` exists.
+
+---
+
+## Step 2: Android Installation Steps
+
+1. In your app's `android/app/build.gradle`, add the following above the `dependencies` block:
     ```gradle
     repositories {
-      mavenCentral()
-      google()
-      maven {
-        url = uri("https://cdn-qa.securiti.xyz/consent/maven")
-      }
+        google()
+        mavenCentral()
+        maven {
+            url 'https://cdn-prod.securiti.ai/consent/maven'
+        }
     }
     ```
 
-  - [`CMakeLists.txt`](android/CMakeLists.txt): The CMake build file to build C++ code. This contains four important pieces:
-    1. Creates a library called `NitroSecuritiConsentSdk` (same as in `nitro.json`)
-    2. Adds all Nitrogen files (`include(.../NitroSecuritiConsentSdk+autolinking.cmake)`)
-    3. Adds all custom C++ files (only `HybridTestObjectCpp.cpp`)
-    4. Adds a `cpp-adapter.cpp` file, which autolinks all C++ HybridObjects (only `HybridTestObjectCpp`)
-  - [`src/main/java/com/margelo/nitro/securiticonsentsdk/`](android/src/main/java/com/margelo/nitro/securiticonsentsdk/): All Kotlin implementations.
-    - [`NitroSecuritiConsentSdkPackage.java`](android/src/main/java/com/margelo/nitro/securiticonsentsdk/NitroSecuritiConsentSdkPackage.java): The react-native package. You need this because the react-native CLI only adds libraries if they have a `*Package.java` file. In here, you can autolink all Kotlin HybridObjects.
-- [`cpp/`](cpp): All your cross-platform implementations. (only `HybridTestObjectCpp.cpp`)
-- [`ios/`](ios): All your iOS-specific implementations.
-- [`nitrogen/`](nitrogen): All files generated by nitrogen. You should commit this folder to git.
-- [`src/`](src): The TypeScript codebase. This defines all HybridObjects and loads them at runtime.
-  - [`specs/`](src/specs): All HybridObject types. Nitrogen will run on all `*.nitro.ts` files.
-- [`nitro.json`](nitro.json): The configuration file for nitrogen. This will define all native namespaces, as well as the library name.
-- [`NitroSecuritiConsentSdk.podspec`](NitroSecuritiConsentSdk.podspec): The iOS podspec build file to build the iOS code. This contains three important pieces:
-  1. Specifies the Pod's name. This must be identical to the name specified in `nitro.json`.
-  2. Adds all of your `.swift` or `.cpp` files (implementations).
-  3. Adds all Nitrogen files (`add_nitrogen_files(s)`)
-- [`package.json`](package.json): The npm package.json file. `react-native-nitro-modules` should be a `peerDependency`.
+---
+
+## iOS Installation Steps
+
+1. In your iOS folder "ios", run the command:
+    ```sh
+    pod install
+    ```
+
+---
+
+## Methods
+
+### initialize(options)
+
+**Description:**  
+Initializes the Consent SDK with configuration options. Must be called before using any other SDK methods.
+
+**Parameters:**
+
+| Parameter | Type            | Required | Description                                 |
+|-----------|-----------------|----------|---------------------------------------------|
+| options   | CmpSDKOptions   | Yes      | Configuration options for the SDK           |
+
+**CmpSDKOptions:**
+
+| Option                | Type    | Required | Description                                 |
+|-----------------------|---------|----------|---------------------------------------------|
+| appURL                | string  | Yes      | Base URL for the Securiti application       |
+| cdnURL                | string  | Yes      | URL for the Securiti CDN resources          |
+| tenantID              | string  | Yes      | Your tenant identifier from Securiti        |
+| appID                 | string  | Yes      | Your application identifier from Securiti   |
+| testingMode           | boolean | Yes      | Enable testing mode                         |
+| loggerLevel           | string  | Yes      | Log level: "DEBUG", "INFO", "WARNING", "ERROR" |
+| consentsCheckInterval | number  | Yes      | Time in seconds between consent checks      |
+| subjectId             | string  | No       | User identifier for consent tracking        |
+| languageCode          | string  | No       | Language code for UI elements (e.g., "en")  |
+| locationCode          | string  | No       | Location code for regional compliance (e.g., "US") |
+| mode                  | string  | No       | Mode: "draft" or "live"                     |
+
+**Return Value:**  
+`void`
+
+**Example:**
+```js
+import { initialize, LoggerLevel, ModeValues } from 'securiti-consent-sdk';
+
+const options = {
+  appURL: 'your APP Url',
+  cdnURL: 'Your CDN Url',
+  tenantID: 'your-tenant-id',
+  appID: 'your-app-id',
+  testingMode: false,
+  loggerLevel: LoggerLevel.DEBUG,
+  consentsCheckInterval: 60,
+  subjectId: 'user-123',
+  languageCode: 'en',
+  locationCode: 'US',
+  mode: ModeValues.LIVE
+};
+
+initialize(options);
+```
+
+---
+
+### getConsentByPurposeId(purposeId)
+
+**Description:**  
+Retrieves the consent status for a specific purpose by its ID.
+
+**Parameters:**
+
+| Parameter | Type   | Description                        |
+|-----------|--------|------------------------------------|
+| purposeId | number | The unique identifier of the purpose|
+
+**Return Value:**  
+`Promise<ConsentStatus>`
+
+**ConsentStatus Values:**
+- `granted`
+- `declined`
+- `not_determined`
+- `withdrawn`
+
+**Example:**
+```js
+import { getConsentByPurposeId, ConsentStatusValues } from 'securiti-consent-sdk';
+
+getConsentByPurposeId(12345)
+  .then((status) => {
+    if (status === ConsentStatusValues.GRANTED) {
+      // Consent is granted
+    }
+  });
+```
+
+---
+
+### getConsentByPermissionId(permissionId)
+
+**Description:**  
+Retrieves the consent status for a specific app permission by its ID.
+
+**Parameters:**
+
+| Parameter    | Type   | Description                                 |
+|--------------|--------|---------------------------------------------|
+| permissionId | string | The unique identifier of the permission     |
+
+**Return Value:**  
+`Promise<ConsentStatus>`
+
+**ConsentStatus Values:**  
+Same as above.
+
+**Example:**
+```js
+import { getConsentByPermissionId, ConsentStatusValues } from 'securiti-consent-sdk';
+
+getConsentByPermissionId('location')
+  .then((status) => {
+    if (status === ConsentStatusValues.GRANTED) {
+      // Permission consent is granted
+    }
+  });
+```
+
+---
+
+### getPermissions()
+
+**Description:**  
+Retrieves all available app permissions defined in the consent configuration.
+
+**Return Value:**  
+`Promise<AppPermission[]>`
+
+**AppPermission Properties:**
+
+| Property                | Type    | Description                                 |
+|-------------------------|---------|---------------------------------------------|
+| id                      | number  | The numeric identifier                      |
+| name                    | string  | The permission name                         |
+| permissionId            | string  | The permission identifier string            |
+| description             | string  | Localized permission descriptions           |
+| group                   | string  | The permission group name                   |
+| groupId                 | number  | The permission group identifier             |
+| consentStatus           | string  | The current consent status                  |
+| nameMap                 | string  | Localized permission names                  |
+| isSettingsPromptEnabled | boolean | Whether settings prompt is enabled          |
+
+**Example:**
+```js
+import { getPermissions, ConsentStatusValues } from 'securiti-consent-sdk';
+
+getPermissions()
+  .then((permissions) => {
+    const grantedPermissions = permissions.filter(
+      permission => permission.consentStatus === ConsentStatusValues.GRANTED
+    );
+  });
+```
+
+---
+
+### getPurposes()
+
+**Description:**  
+Retrieves all available purposes defined in the consent configuration.
+
+**Return Value:**  
+`Promise<Purpose[]>`
+
+**Purpose Properties:**
+
+| Property         | Type    | Description                                 |
+|------------------|---------|---------------------------------------------|
+| purposeId        | number  | The unique identifier for the purpose       |
+| purposeName      | string  | Localized purpose names                     |
+| purposeDescription| string | Localized purpose descriptions              |
+| sdks             | SDK[]   | SDKs associated with this purpose           |
+| consentStatus    | string  | The current consent status                  |
+| disableOptOut    | boolean | Whether opt-out is disabled                 |
+| optOutText       | string  | Localized opt-out text                      |
+| hideDetails      | boolean | Whether details should be hidden in the UI  |
+| isGADMapped      | boolean | Whether mapped to Google Ads                |
+| gadDescription   | string  | Localized Google Ads description            |
+
+**Example:**
+```js
+import { getPurposes, ConsentStatusValues } from 'securiti-consent-sdk';
+
+getPurposes()
+  .then((purposes) => {
+    const grantedPurposes = purposes.filter(
+      purpose => purpose.consentStatus === ConsentStatusValues.GRANTED
+    );
+  });
+```
+
+---
+
+### getSdksInPurpose(purposeId)
+
+**Description:**  
+Retrieves all SDKs associated with a specific purpose.
+
+**Parameters:**
+
+| Parameter | Type   | Description                        |
+|-----------|--------|------------------------------------|
+| purposeId | number | The unique identifier of the purpose|
+
+**Return Value:**  
+`Promise<SDK[]>`
+
+**SDK Properties:**
+
+| Property      | Type    | Description                                 |
+|---------------|---------|---------------------------------------------|
+| sdkId         | number  | The unique identifier for the SDK           |
+| namespaceId   | string  | The namespace identifier string             |
+| sdkName       | string  | Localized SDK names                         |
+| sdkDescription| string  | Localized SDK descriptions                  |
+| vendor        | string  | The vendor or provider of the SDK           |
+| logoBase64    | string  | Base64-encoded logo image                   |
+| website       | string  | The SDK vendor's website URL                |
+| matchedBy     | string[]| How the SDK was matched in the application  |
+| collectingData| boolean | Whether the SDK is collecting data          |
+
+**Example:**
+```js
+import { getSdksInPurpose } from 'securiti-consent-sdk';
+
+getSdksInPurpose(12345)
+  .then((sdks) => {
+    // Use SDKs
+  });
+```
+
+---
+
+### setPurposeConsent(purpose, consent)
+
+**Description:**  
+Sets the consent status for a specific purpose.
+
+**Parameters:**
+
+| Parameter | Type    | Description                                 |
+|-----------|---------|---------------------------------------------|
+| purpose   | Purpose | The purpose object to set consent for       |
+| consent   | string  | The consent status to set                   |
+
+**ConsentStatus Values:**  
+- `granted`
+- `declined`
+- `not_determined`
+- `withdrawn`
+
+**Return Value:**  
+`boolean`
+
+**Example:**
+```js
+import { setPurposeConsent, getPurposes, ConsentStatusValues } from 'securiti-consent-sdk';
+
+getPurposes()
+  .then((purposes) => {
+    const analyticsPurpose = purposes.find(p => p.purposeId === 12345);
+    if (analyticsPurpose) {
+      const success = setPurposeConsent(analyticsPurpose, ConsentStatusValues.GRANTED);
+    }
+  });
+```
+
+---
+
+### setPermissionConsent(appPermission, consent)
+
+**Description:**  
+Sets the consent status for a specific app permission.
+
+**Parameters:**
+
+| Parameter     | Type         | Description                                 |
+|---------------|--------------|---------------------------------------------|
+| appPermission | AppPermission| The permission object to set consent for    |
+| consent       | string       | The consent status to set                   |
+
+**ConsentStatus Values:**  
+Same as above.
+
+**Return Value:**  
+`boolean`
+
+**Example:**
+```js
+import { setPermissionConsent, getPermissions, ConsentStatusValues } from 'securiti-consent-sdk';
+
+getPermissions()
+  .then((permissions) => {
+    const locationPermission = permissions.find(p => p.permissionId === 'location');
+    if (locationPermission) {
+      const success = setPermissionConsent(locationPermission, ConsentStatusValues.GRANTED);
+    }
+  });
+```
+
+---
+
+### resetConsents()
+
+**Description:**  
+Resets all consents to their default state.
+
+**Parameters:**  
+None
+
+**Return Value:**  
+`void`
+
+**Example:**
+```js
+import { resetConsents } from 'securiti-consent-sdk';
+
+resetConsents();
+```
+
+---
+
+### isReady(callback)
+
+**Description:**  
+Checks if the React Native SDK is ready to use (asynchronous version).
+
+**Parameters:**
+
+| Parameter | Type                       | Description                                 |
+|-----------|----------------------------|---------------------------------------------|
+| callback  | (status: boolean) => void  | Callback function that receives the ready status |
+
+**Return Value:**  
+`void`
+
+**Example:**
+```js
+import { isReady, presentConsentBanner } from 'securiti-consent-sdk';
+
+isReady((isReady) => {
+  if (isReady) {
+    presentConsentBanner();
+  }
+});
+```
+
+---
+
+### getBannerConfig()
+
+**Description:**  
+Retrieves the banner configuration.
+
+**Return Value:**  
+`Promise<BannerConfig | null>`
+
+**BannerConfig Properties:**  
+(See [Types and Properties](#types-and-properties) section)
+
+**Example:**
+```js
+import { getBannerConfig } from 'securiti-consent-sdk';
+
+getBannerConfig()
+  .then((config) => {
+    if (config) {
+      // Use config
+    }
+  });
+```
+
+---
+
+### options()
+
+**Description:**  
+Retrieves the current SDK configuration options.
+
+**Return Value:**  
+`CmpSDKOptions | null`
+
+**Example:**
+```js
+import { options } from 'securiti-consent-sdk';
+
+const currentOptions = options();
+```
+
+---
+
+### getSettingsPrompt()
+
+**Description:**  
+Retrieves the settings prompt configuration.
+
+**Return Value:**  
+`Promise<SettingsPrompt | null>`
+
+**SettingsPrompt Properties:**  
+(See [Types and Properties](#types-and-properties) section)
+
+**Example:**
+```js
+import { getSettingsPrompt } from 'securiti-consent-sdk';
+
+getSettingsPrompt()
+  .then((prompt) => {
+    if (prompt) {
+      // Use prompt
+    }
+  });
+```
+
+---
+
+### uploadConsents(request)
+
+**Description:**  
+Uploads consents to the server.
+
+**Parameters:**
+
+| Parameter | Type                | Description                                 |
+|-----------|---------------------|---------------------------------------------|
+| request   | PostConsentsRequest | The consent data to upload                  |
+
+**Return Value:**  
+`Promise<boolean>`
+
+**Example:**
+```js
+import { uploadConsents, ConsentStatusValues } from 'securiti-consent-sdk';
+
+const timestamp = Date.now();
+const consentRequest = {
+  uuid: 'user-123',
+  appUUID: 'app-456',
+  device: 'iPhone 12',
+  implicitConsent: false,
+  version: 1,
+  purposeConsents: [
+    {
+      purposeID: 12345,
+      consentStatus: ConsentStatusValues.GRANTED,
+      timestamp: timestamp,
+      isEssential: false
+    }
+  ],
+  permissions: [
+    {
+      permission: 'location',
+      consentStatus: ConsentStatusValues.GRANTED,
+      timestamp: timestamp
+    }
+  ],
+  isTestMode: false,
+  adId: 'advertising-id-789',
+  bannerInfo: 'Banner version 2.0',
+  sdkVersion: '1.132.0',
+  platform: 'iOS'
+};
+
+uploadConsents(consentRequest)
+  .then((success) => {
+    if (success) {
+      // Success
+    }
+  });
+```
+
+---
+
+### presentConsentBanner()
+
+**Description:**  
+Displays the consent banner UI to the user.
+
+**Parameters:**  
+None
+
+**Return Value:**  
+`void`
+
+**Example:**
+```js
+import { presentConsentBanner } from 'securiti-consent-sdk';
+
+presentConsentBanner();
+```
+
+---
+
+### presentPreferenceCenter()
+
+**Description:**  
+Displays the preference center UI to the user.
+
+**Parameters:**  
+None
+
+**Return Value:**  
+`void`
+
+**Example:**
+```js
+import { presentPreferenceCenter } from 'securiti-consent-sdk';
+
+presentPreferenceCenter();
+```
+
+---
+
+## Types and Properties
+
+### ConsentStatus Values
+
+- `granted`
+- `declined`
+- `not_determined`
+- `withdrawn`
+
+### CmpSDKOptions
+
+See [initialize(options)](#initializeoptions).
+
+### AppPermission
+
+See [getPermissions()](#getpermissions).
+
+### Purpose
+
+See [getPurposes()](#getpurposes).
+
+### SDK
+
+See [getSdksInPurpose(purposeId)](#getsdksinpurposepurposeid).
+
+### BannerConfig
+
+| Property                        | Type    | Description                                 |
+|----------------------------------|---------|---------------------------------------------|
+| hideCloseButton                  | boolean | Whether to hide the close button            |
+| hideAcceptButton                 | boolean | Whether to hide the accept button           |
+| embedDSRPortalLink               | boolean | Whether to embed DSR portal link            |
+| recordConsentUponAppStart        | boolean | Whether to record consent on app start      |
+| hideToggleForEssentialCategories | boolean | Hide toggles for essential categories       |
+| name                             | string  | The banner name                            |
+| dsrPortalLink                    | string  | Link to the DSR portal                      |
+| complianceType                   | string  | "notice-only", "opt-in", or "opt-out"       |
+| bannerReappearanceTime           | string  | When the banner should reappear             |
+| privacyNoticeLink                | string  | Link to privacy notice                      |
+| accept                           | string  | Localized accept button text                |
+| reject                           | string  | Localized reject button text                |
+| bannerText                       | string  | Localized banner text                       |
+| bannerHeading                    | string  | Localized banner heading                    |
+| sdkTabHeading                    | string  | Localized SDK tab heading                   |
+| privacyNoticeText                | string  | Localized privacy notice text               |
+| preferenceCenterLink             | string  | Localized preference center link text       |
+| bannerPosition                   | string  | "bottom" or "center"                        |
+| buttonShape                      | string  | "rounded", "square", "pill", "outlined"     |
+| customPaletteTheme               | object  | Custom color theme for banner               |
+
+### SettingsPrompt
+
+| Property           | Type      | Description                                 |
+|--------------------|-----------|---------------------------------------------|
+| promptHeading      | string    | Localized prompt heading text               |
+| promptMessage      | string    | Localized prompt message text               |
+| settingsButtonText | string    | Localized settings button text              |
+| notNowButtonText   | string    | Localized "not now" button text             |
+| permissions        | string[]  | Permissions with settings prompt enabled     |
+
+### PostConsentsRequest
+
+| Property         | Type              | Required | Description                                 |
+|------------------|-------------------|----------|---------------------------------------------|
+| uuid             | string            | Yes      | Unique user identifier                      |
+| appUUID          | string            | Yes      | Application UUID                            |
+| device           | string            | Yes      | Device information                          |
+| implicitConsent  | boolean           | Yes      | Whether consent was implicit                |
+| version          | number            | Yes      | Version of consent data                     |
+| purposeConsents  | PurposeConsent[]  | Yes      | Array of purpose consent data               |
+| permissions      | PermissionConsent[]| Yes     | Array of permission consent data            |
+| isTestMode       | boolean           | Yes      | Whether in test mode                        |
+| adId             | string            | Yes      | Advertising identifier                      |
+| bannerInfo       | string            | Yes      | Banner information                          |
+| sdkVersion       | string            | No       | SDK version                                 |
+| platform         | string            | No       | Platform information                        |
+
+---
+
+## Using Methods
+
+Example usage in a React Native app:
+
+```jsx
+import React, { useEffect, useState } from 'react';
+import {
+  View,
+  StyleSheet,
+  Text,
+  ScrollView,
+  ActivityIndicator,
+  SafeAreaView,
+  TouchableOpacity,
+  Platform,
+  Alert,
+} from 'react-native';
+
+// Import the functions from the library
+import {
+  initialize,
+  presentConsentBanner,
+  presentPreferenceCenter,
+  isSdkReady,
+  isReady,
+  resetConsents,
+  getConsentByPurposeId,
+  getConsentByPermissionId,
+  getPermissions,
+  getPurposes,
+  getSdksInPurpose,
+  setPurposeConsent,
+  setPermissionConsent,
+  getBannerConfig,
+  getSettingsPrompt,
+  options,
+  LoggerLevel,
+  ConsentStatusValues,
+} from 'securiti-consent-sdk';
+
+// For types
+import type {
+  Purpose,
+  AppPermission,
+  SDK,
+  BannerConfig,
+  SettingsPrompt,
+  CmpSDKOptions
+} from 'securiti-consent-sdk';
+
+// We'll use the isReady callback instead of native events
+
+export default function App() {
+  const [sdkReady, setSdkReady] = useState(false);
+  const [isLoading, setIsLoading] = useState(false);
+  const [response, setResponse] = useState<null | any>(null);
+  const [purposes, setPurposes] = useState<Purpose[]>([]);
+  const [permissions, setPermissions] = useState<AppPermission[]>([]);
+
+  useEffect(() => {
+    // Initialize SDK with appropriate options based on platform
+   const initOptions: CmpSDKOptions = Platform.OS === 'android'
+      ? {
+          appURL: 'Your Android App URL',
+          cdnURL: 'Your Android CDN URL',
+          tenantID: 'Your Tenant ID',
+          appID: 'Your Android App ID',
+          testingMode: true,
+          loggerLevel: LoggerLevel.DEBUG,
+          consentsCheckInterval: 3600,
+          subjectId: 'reactNativeAndroidSubject',
+          languageCode: 'Your Language Code',
+          locationCode: 'Your Location Code',
+        }
+      : {
+          appURL: 'Your iOS App URL',
+          cdnURL: 'Your iOS CDN URL',
+          tenantID: 'Your Tenant ID',
+          appID: 'Your iOS App ID',
+          testingMode: true,
+          loggerLevel: LoggerLevel.DEBUG,
+          consentsCheckInterval: 3600,
+          subjectId: 'reactNativeiOSSubject',
+          languageCode: 'Your Language Code',
+          locationCode: 'Your Location Code',
+        };
+
+    initialize(initOptions);
+
+    // Use the isReady callback instead of events
+    isReady((status) => {
+      console.log('SDK ready callback received:', status);
+      setSdkReady(status);
+      if (status) {
+        loadInitialData();
+      }
+    });
+
+    // Also check using the synchronous method
+    checkSdkReadiness();
+
+    // No event listeners to clean up
+    return () => {};
+  }, []);
+
+  const checkSdkReadiness = () => {
+    // Synchronous check
+    try {
+      const ready = isSdkReady();
+      setSdkReady(ready);
+      console.log('SDK ready (sync check):', ready);
+
+      if (ready) {
+        handleShowBanner();
+        loadInitialData();
+      } else {
+        // Also try the callback-based method
+        isReady((ready) => {
+          console.log('SDK ready (callback):', ready);
+          setSdkReady(ready);
+          if (ready) {
+            handleShowBanner();
+            loadInitialData();
+          }
+        });
+      }
+    } catch (error) {
+      console.error('Error checking SDK readiness:', error);
+    }
+  };
+
+  const loadInitialData = async () => {
+    try {
+      setIsLoading(true);
+      console.log('Loading initial data...');
+
+      // Load purposes and permissions in parallel
+      const [purposesResult, permissionsResult] = await Promise.all([
+        getPurposes(),
+        getPermissions()
+      ]);
+
+      console.log('Purposes loaded:', purposesResult?.length || 0);
+      console.log('Permissions loaded:', permissionsResult?.length || 0);
+
+      setPurposes(purposesResult || []);
+      setPermissions(permissionsResult || []);
+    } catch (error) {
+      console.error('Failed to load initial data:', error);
+      Alert.alert('Error', 'Failed to load initial data');
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleShowBanner = () => {
+    try {
+      presentConsentBanner();
+      console.log('Consent banner presented');
+    } catch (error) {
+      console.error('Error presenting consent banner:', error);
+      Alert.alert('Error', 'Failed to show consent banner');
+    }
+  };
+
+  const handleShowPreferenceCenter = () => {
+    try {
+      presentPreferenceCenter();
+      console.log('Preference center presented');
+    } catch (error) {
+      console.error('Error presenting preference center:', error);
+      Alert.alert('Error', 'Failed to show preference center');
+    }
+  };
+
+  const handleResetConsents = () => {
+    setResponse(null);
+    try {
+      resetConsents();
+      setResponse({
+        message: 'Consents have been reset',
+        timestamp: new Date().toISOString()
+      });
+      loadInitialData(); // Refresh data
+    } catch (error) {
+      console.error('Error resetting consents:', error);
+      setResponse({ error: 'Failed to reset consents: ' + error });
+    }
+  };
+
+  const handleGetPurposes = async () => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getPurposes();
+      setResponse({
+        purposes: result,
+        timestamp: new Date().toISOString()
+      });
+      setPurposes(result || []);
+    } catch (error) {
+      console.error('Error getting purposes:', error);
+      setResponse({ error: 'Failed to get purposes: ' + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleGetPermissions = async () => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getPermissions();
+      setResponse({
+        permissions: result,
+        timestamp: new Date().toISOString()
+      });
+      setPermissions(result || []);
+    } catch (error) {
+      console.error('Error getting permissions:', error);
+      setResponse({ error: 'Failed to get permissions: ' + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleGetSdksInPurpose = async (purposeId: number) => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getSdksInPurpose(purposeId);
+      setResponse({
+        purposeId,
+        sdks: result,
+        timestamp: new Date().toISOString()
+      });
+    } catch (error) {
+      console.error('Error getting SDKs:', error);
+      setResponse({ error: `Failed to get SDKs for purpose ${purposeId}: ` + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleGetBannerConfig = async () => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getBannerConfig(null);
+      setResponse({
+        bannerConfig: result,
+        timestamp: new Date().toISOString()
+      });
+    } catch (error) {
+      console.error('Error getting banner config:', error);
+      setResponse({ error: 'Failed to get banner config: ' + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleGetSettingsPrompt = async () => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getSettingsPrompt();
+      setResponse({
+        settingsPrompt: result,
+        timestamp: new Date().toISOString()
+      });
+    } catch (error) {
+      console.error('Error getting settings prompt:', error);
+      setResponse({ error: 'Failed to get settings prompt: ' + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleGetOptions = () => {
+    setResponse(null);
+    try {
+      const sdkOptions = options();
+      setResponse({
+        options: sdkOptions,
+        timestamp: new Date().toISOString()
+      });
+    } catch (error) {
+      console.error('Error getting options:', error);
+      setResponse({ error: 'Failed to get options: ' + error });
+    }
+  };
+
+  const handleGetConsentForPurpose = async (purposeId: number) => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getConsentByPurposeId(purposeId);
+      setResponse({
+        purposeId,
+        consentStatus: result,
+        timestamp: new Date().toISOString()
+      });
+    } catch (error) {
+      console.error('Error getting purpose consent:', error);
+      setResponse({ error: `Failed to get consent for purpose ${purposeId}: ` + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleGetConsentForPermission = async (permissionId: string) => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const result = await getConsentByPermissionId(permissionId);
+      setResponse({
+        permissionId,
+        consentStatus: result,
+        timestamp: new Date().toISOString()
+      });
+    } catch (error) {
+      console.error('Error getting permission consent:', error);
+      setResponse({ error: `Failed to get consent for permission ${permissionId}: ` + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleSetConsentForPurpose = async (purpose: Purpose, consent: string) => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const success = setPurposeConsent(purpose, consent);
+      console.log(`Set purpose consent result: ${success}`);
+
+      // Give time for consent to apply
+      await new Promise(resolve => setTimeout(resolve, 500));
+
+      // Get updated status
+      const newStatus = await getConsentByPurposeId(purpose.purposeId || 0);
+
+      setResponse({
+        message: `Set consent for purpose ${purpose.purposeId} to ${consent}`,
+        success,
+        newStatus,
+        timestamp: new Date().toISOString()
+      });
+
+      // Refresh purposes list
+      const updatedPurposes = await getPurposes();
+      setPurposes(updatedPurposes || []);
+    } catch (error) {
+      console.error('Error setting purpose consent:', error);
+      setResponse({ error: `Failed to set consent for purpose ${purpose.purposeId}: ` + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleSetConsentForPermission = async (permission: AppPermission, consent: string) => {
+    setResponse(null);
+    setIsLoading(true);
+    try {
+      const success = setPermissionConsent(permission, consent);
+      console.log(`Set permission consent result: ${success}`);
+
+      // Give time for consent to apply
+      await new Promise(resolve => setTimeout(resolve, 500));
+
+      // Get updated status
+      const newStatus = await getConsentByPermissionId(permission.permissionId || '');
+
+      setResponse({
+        message: `Set consent for permission ${permission.permissionId} to ${consent}`,
+        success,
+        newStatus,
+        timestamp: new Date().toISOString()
+      });
+
+      // Refresh permissions list
+      const updatedPermissions = await getPermissions();
+      setPermissions(updatedPermissions || []);
+    } catch (error) {
+      console.error('Error setting permission consent:', error);
+      setResponse({ error: `Failed to set consent for permission ${permission.permissionId}: ` + error });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+
+  const renderPurposeItem = (purpose: Purpose) => {
+    const purposeName = purpose.purposeName?.['en'] || `Purpose ${purpose.purposeId}`;
+
+    return (
+      <View style={styles.itemContainer} key={purpose.purposeId}>
+        <Text style={styles.itemTitle}>{purposeName}</Text>
+        <Text style={styles.itemSubtitle}>ID: {purpose.purposeId}</Text>
+        <Text style={styles.itemSubtitle}>Status: {purpose.consentStatus || 'unknown'}</Text>
+
+        <View style={styles.buttonRow}>
+          <TouchableOpacity
+            style={[styles.smallButton, styles.detailButton]}
+            onPress={() => handleGetConsentForPurpose(purpose.purposeId || 0)}
+          >
+            <Text style={styles.smallButtonText}>Get Status</Text>
+          </TouchableOpacity>
+
+          <TouchableOpacity
+            style={[styles.smallButton, styles.detailButton]}
+            onPress={() => handleGetSdksInPurpose(purpose.purposeId || 0)}
+          >
+            <Text style={styles.smallButtonText}>Get SDKs</Text>
+          </TouchableOpacity>
+
+          <TouchableOpacity
+            style={[styles.smallButton, styles.grantButton]}
+            onPress={() => handleSetConsentForPurpose(purpose, ConsentStatusValues.GRANTED)}
+          >
+            <Text style={styles.smallButtonText}>Grant</Text>
+          </TouchableOpacity>
+
+          <TouchableOpacity
+            style={[styles.smallButton, styles.declineButton]}
+            onPress={() => handleSetConsentForPurpose(purpose, ConsentStatusValues.DECLINED)}
+          >
+            <Text style={styles.smallButtonText}>Decline</Text>
+          </TouchableOpacity>
+        </View>
+      </View>
+    );
+  };
+
+  const renderPermissionItem = (permission: AppPermission) => {
+    const permissionName = permission.name || permission.permissionId || 'Unknown Permission';
+
+    return (
+      <View style={styles.itemContainer} key={permission.permissionId}>
+        <Text style={styles.itemTitle}>{permissionName}</Text>
+        <Text style={styles.itemSubtitle}>ID: {permission.permissionId}</Text>
+        <Text style={styles.itemSubtitle}>Status: {permission.consentStatus || 'unknown'}</Text>
+
+        <View style={styles.buttonRow}>
+          <TouchableOpacity
+            style={[styles.smallButton, styles.detailButton]}
+            onPress={() => handleGetConsentForPermission(permission.permissionId || '')}
+          >
+            <Text style={styles.smallButtonText}>Get Status</Text>
+          </TouchableOpacity>
+
+          <TouchableOpacity
+            style={[styles.smallButton, styles.grantButton]}
+            onPress={() => handleSetConsentForPermission(permission, ConsentStatusValues.GRANTED)}
+          >
+            <Text style={styles.smallButtonText}>Grant</Text>
+          </TouchableOpacity>
+
+          <TouchableOpacity
+            style={[styles.smallButton, styles.declineButton]}
+            onPress={() => handleSetConsentForPermission(permission, ConsentStatusValues.DECLINED)}
+          >
+            <Text style={styles.smallButtonText}>Decline</Text>
+          </TouchableOpacity>
+        </View>
+      </View>
+    );
+  };
+
+  return (
+    <SafeAreaView style={styles.container}>
+      <ScrollView
+        contentContainerStyle={styles.scrollContent}
+        nestedScrollEnabled={true}>
+        <View style={styles.header}>
+          <Text style={styles.title}>Securiti Consent SDK Demo</Text>
+          <Text style={styles.subtitle}>
+            SDK Status: {sdkReady ? 'Ready' : 'Initializing...'}
+          </Text>
+        </View>
+
+        <View style={styles.section}>
+          <Text style={styles.sectionTitle}>Banner Controls</Text>
+          <View style={styles.buttonRow}>
+            <TouchableOpacity
+              style={[styles.button, styles.primaryButton]}
+              onPress={handleShowPreferenceCenter}
+            >
+              <Text style={styles.buttonText}>Preference Center</Text>
+            </TouchableOpacity>
+          </View>
+        </View>
+
+        <View style={styles.section}>
+          <Text style={styles.sectionTitle}>Get Configuration</Text>
+          <View style={styles.buttonRow}>
+            <TouchableOpacity
+              style={[styles.button, styles.secondaryButton]}
+              onPress={handleGetBannerConfig}
+            >
+              <Text style={styles.buttonText}>Banner Config</Text>
+            </TouchableOpacity>
+
+            <TouchableOpacity
+              style={[styles.button, styles.secondaryButton]}
+              onPress={handleGetSettingsPrompt}
+            >
+              <Text style={styles.buttonText}>Settings Prompt</Text>
+            </TouchableOpacity>
+
+            <TouchableOpacity
+              style={[styles.button, styles.secondaryButton]}
+              onPress={handleGetOptions}
+            >
+              <Text style={styles.buttonText}>SDK Options</Text>
+            </TouchableOpacity>
+          </View>
+        </View>
+
+        <View style={styles.section}>
+          <Text style={styles.sectionTitle}>Manage Data</Text>
+          <View style={styles.buttonRow}>
+            <TouchableOpacity
+              style={[styles.button, styles.secondaryButton]}
+              onPress={handleGetPurposes}
+            >
+              <Text style={styles.buttonText}>Get Purposes</Text>
+            </TouchableOpacity>
+
+            <TouchableOpacity
+              style={[styles.button, styles.secondaryButton]}
+              onPress={handleGetPermissions}
+            >
+              <Text style={styles.buttonText}>Get Permissions</Text>
+            </TouchableOpacity>
+
+
+            <TouchableOpacity
+              style={[styles.button, styles.warningButton]}
+              onPress={handleResetConsents}
+            >
+              <Text style={styles.buttonText}>Reset Consents</Text>
+            </TouchableOpacity>
+          </View>
+        </View>
+
+        {isLoading && (
+          <View style={styles.loaderContainer}>
+            <ActivityIndicator size="large" color="#0000ff" />
+          </View>
+        )}
+
+        {response && (
+          <View style={styles.responseContainer}>
+            <Text style={styles.sectionTitle}>Response:</Text>
+            <ScrollView
+              style={styles.responseScrollView}
+              contentContainerStyle={styles.responseScrollContent}
+              nestedScrollEnabled={true}
+            >
+              <Text selectable={true} style={styles.responseText}>
+                {JSON.stringify(response, null, 2)}
+              </Text>
+            </ScrollView>
+          </View>
+        )}
+
+        {/* Purposes Section */}
+        <View style={styles.section}>
+          <Text style={styles.sectionTitle}>Purposes</Text>
+          {purposes.length === 0 ? (
+            <Text style={styles.emptyText}>No purposes available</Text>
+          ) : (
+            purposes.map(renderPurposeItem)
+          )}
+        </View>
+
+        {/* Permissions Section */}
+        <View style={styles.section}>
+          <Text style={styles.sectionTitle}>Permissions</Text>
+          {permissions.length === 0 ? (
+            <Text style={styles.emptyText}>No permissions available</Text>
+          ) : (
+            permissions.map(renderPermissionItem)
+          )}
+        </View>
+      </ScrollView>
+    </SafeAreaView>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#f5f5f5',
+  },
+  scrollContent: {
+    padding: 16,
+  },
+  header: {
+    marginBottom: 20,
+    alignItems: 'center',
+  },
+  title: {
+    fontSize: 24,
+    fontWeight: 'bold',
+    marginBottom: 8,
+  },
+  subtitle: {
+    fontSize: 16,
+    color: '#666',
+    marginBottom: 8,
+  },
+  section: {
+    marginBottom: 24,
+    backgroundColor: '#fff',
+    borderRadius: 8,
+    padding: 16,
+    shadowColor: '#000',
+    shadowOffset: { width: 0, height: 2 },
+    shadowOpacity: 0.1,
+    shadowRadius: 4,
+    elevation: 2,
+  },
+  sectionTitle: {
+    fontSize: 18,
+    fontWeight: 'bold',
+    marginBottom: 12,
+  },
+  buttonRow: {
+    flexDirection: 'row',
+    flexWrap: 'wrap',
+    justifyContent: 'space-between',
+    marginHorizontal: -4,
+  },
+  button: {
+    margin: 4,
+    padding: 12,
+    borderRadius: 6,
+    minWidth: 100,
+    alignItems: 'center',
+  },
+  buttonText: {
+    color: '#fff',
+    fontWeight: 'bold',
+  },
+  primaryButton: {
+    backgroundColor: '#2196F3',
+  },
+  secondaryButton: {
+    backgroundColor: '#4CAF50',
+  },
+  actionButton: {
+    backgroundColor: '#9C27B0',
+  },
+  warningButton: {
+    backgroundColor: '#FF5722',
+  },
+  smallButton: {
+    margin: 2,
+    padding: 6,
+    borderRadius: 4,
+    minWidth: 60,
+    alignItems: 'center',
+  },
+  smallButtonText: {
+    fontSize: 12,
+    color: '#fff',
+    fontWeight: 'bold',
+  },
+  detailButton: {
+    backgroundColor: '#607D8B',
+  },
+  grantButton: {
+    backgroundColor: '#4CAF50',
+  },
+  declineButton: {
+    backgroundColor: '#F44336',
+  },
+  loaderContainer: {
+    padding: 20,
+    alignItems: 'center',
+  },
+  responseContainer: {
+    backgroundColor: '#fff',
+    borderRadius: 8,
+    padding: 16,
+    marginBottom: 24,
+    height: 300,
+  },
+  responseScrollView: {
+    flex: 1,
+    marginTop: 8,
+    backgroundColor: '#f5f5f5',
+    borderRadius: 4,
+    borderWidth: 1,
+    borderColor: '#e0e0e0',
+  },
+  responseScrollContent: {
+    padding: 8,
+  },
+  responseText: {
+    fontFamily: 'monospace',
+    fontSize: 12,
+    color: '#333',
+  },
+  itemContainer: {
+    padding: 12,
+    borderWidth: 1,
+    borderColor: '#e0e0e0',
+    borderRadius: 6,
+    marginBottom: 8,
+  },
+  itemTitle: {
+    fontSize: 16,
+    fontWeight: 'bold',
+    marginBottom: 4,
+  },
+  itemSubtitle: {
+    fontSize: 14,
+    color: '#666',
+    marginBottom: 4,
+  },
+  emptyText: {
+    padding: 16,
+    textAlign: 'center',
+    color: '#666',
+  },
+});
+```
+
+Go to the terminal and run:
+```
+npx react-native run-android
+```
+or
+```
+npx react-native run-ios
+```
+to see the consent banner on app start, and the preference center on click of the "Open Preference Center" button.