CMP SDK is a React Native library that facilitates the management of user consent for data processing and storage. It is designed to help developers comply with various data protection regulations.

npm install cmp-sdk

If you are using React Native 0.59 or below, you need to link the native modules manually:

react-native link cmp-sdk

Import the Consentmanager from the cmp-sdk package in your code:

import { Consentmanager } from 'cmp-sdk';

You can initialize the CMP SDK using either the direct configuration or a config object:

• Direct Initialization:

  Consentmanager.createInstance('yourID', 'yourDomain', 'yourAppName', 'yourLanguage');

• Initialization using Config Object:

  Consentmanager.createInstanceByConfig(yourConfigObject);

import { CmpConfig, CmpScreenConfig, CmpIosPresentationStyle } from 'cmp-sdk/types';

const config = new CmpConfig({ id: 'yourID', domain: 'yourDomain', appName: 'yourAppName', language: 'yourLanguage', screenConfig: CmpScreenConfig.FullScreen, iosPresentationStyle: CmpIosPresentationStyle.FullScreen, });

Consentmanager.createInstanceByConfig(config);

### Managing Consent Layer

To manage the consent layer:

- **Open Consent Layer:**
```jsx
Consentmanager.openConsentlayer();

Add event listeners to handle various consent-related events:

const removeListeners = Consentmanager.addEventListeners({
  onOpen: () => console.log('Consent layer opened'),
  onClose: () => console.log('Consent layer closed'),
  onNotOpened: () => console.log('Consent layer not opened'),
  onError: (type, message) => console.log(`Error: ${type}, Message: ${message}`),
  onButtonClicked: (buttonType) => console.log(`Button clicked: ${buttonType}`),
  onGoogleConsentUpdated: (consentMap) => console.log(`Google consent updated: ${JSON.stringify(consentMap)}`),
});

Remember to remove the event listeners when they are no longer needed:

removeListeners();

You can check for vendor and purpose consents:

• Check Vendor Consent:

  Consentmanager.hasVendor('vendorID').then((hasConsent) => {
    console.log('Has vendor consent: ', hasConsent);
  });

• Check Purpose Consent:

  Consentmanager.hasPurpose('purposeID').then((hasConsent) => {
    console.log('Has purpose consent: ', hasConsent);
  });

To reset the current consent settings:

Consentmanager.reset();

Export the current consent string:

Consentmanager.exportCmpString().then((cmpString) => {
  console.log('CMP String: ', cmpString);
});

The CMP SDK provides various methods to retrieve or manage consent data, such as:

• getAllVendors()
• getAllPurposes()
• getEnabledVendors()
• getEnabledPurposes()
• getDisabledVendors()
• getDisabledPurposes()
• getUSPrivacyString()
• getGoogleACString()

Refer to the SDK documentation for detailed information on these methods.

Remember to replace placeholders like 'yourID', 'yourDomain', etc., with actual values relevant to the users of your SDK. You can also expand each section with more detailed examples if needed.

When running jest, you can pass our mock

jest.mock('cmp-sdk', () =>
  require('cmp-sdk/jest/mock'),
);

See the contributing guide to learn how to contribute to the repository and the development workflow.

MIT

Made with create-react-native-library