Add consent management and support for onetrust cmp

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v2
         with:
-          node-version: '16'
+          node-version: '18'
           cache: 'yarn'
       - name: Install
         run: yarn install --frozen-lockfile
@@ -39,7 +39,7 @@ jobs:
 
       - uses: actions/setup-node@v2
         with:
-          node-version: '16'
+          node-version: '18'
           cache: 'yarn'
 
       - uses: maxim-lobanov/setup-xcode@v1
@@ -116,7 +116,7 @@ jobs:
 
       - uses: actions/setup-node@v2
         with:
-          node-version: '16'
+          node-version: '18'
           cache: 'yarn'
 
       - name: Bootstrap

packages/core/package.json

@@ -83,7 +83,7 @@
     "conventional-changelog-conventionalcommits": "^5.0.0",
     "eslint": "^8.2.0",
     "jest": "^27.5.1",
-    "metro-react-native-babel-preset": "^0.66.2",
+    "metro-react-native-babel-preset": "^0.77.0",
     "react": "^17.0.2",
     "react-native": "^0.67.2",
     "react-native-builder-bob": "^0.18.2",

packages/core/src/index.ts

@@ -14,5 +14,9 @@ export {
 } from './util';
 export { SegmentClient } from './analytics';
 export { SegmentDestination } from './plugins/SegmentDestination';
+export {
+  CategoryConsentStatusProvider,
+  ConsentPlugin,
+} from './plugins/ConsentPlugin';
 export * from './flushPolicies';
 export * from './errors';

packages/core/src/plugins/ConsentPlugin.ts

@@ -0,0 +1,119 @@
+import {
+  Plugin,
+  type SegmentClient,
+  type DestinationPlugin,
+  IntegrationSettings,
+  PluginType,
+  SegmentAPIIntegration,
+  SegmentEvent,
+} from '..';
+
+const SEGMENT_PREF_UPDATE_EVENT = 'Segment Consent Preference';
+
+export interface CategoryConsentStatusProvider {
+  setApplicableCategories(categories: string[]): void;
+  getConsentStatus(): Promise<Record<string, boolean>>;
+  onConsentChange(cb: (updConsent: Record<string, boolean>) => void): void;
+  shutdown?(): void;
+}
+
+/**
+ * This plugin interfaces with the consent provider and it:
+ *
+ * - stamps all events with the consent metadata.
+ * - augments all destinations with a consent filter plugin that prevents events from reaching them if
+ * they are not compliant current consent setup
+ * - listens for consent change from the provider and notifies Segment
+ */
+export class ConsentPlugin extends Plugin {
+  type = PluginType.before;
+
+  constructor(
+    private consentCategoryProvider: CategoryConsentStatusProvider,
+    private categories: string[]
+  ) {
+    super();
+  }
+
+  configure(analytics: SegmentClient): void {
+    super.configure(analytics);
+    analytics.getPlugins().forEach(this.injectConsentFilterIfApplicable);
+    analytics.onPluginLoaded(this.injectConsentFilterIfApplicable);
+    this.consentCategoryProvider.setApplicableCategories(this.categories);
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    this.consentCategoryProvider.onConsentChange(this.handleConsentChange);
+  }
+
+  async execute(event: SegmentEvent): Promise<SegmentEvent> {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    if ((event as any).event === 'Segment Consent Preference') {
+      return event;
+    }
+
+    (event.context ??= {}).consent = {
+      categoryPreferences:
+        await this.consentCategoryProvider.getConsentStatus(),
+    };
+
+    return event;
+  }
+
+  shutdown(): void {
+    this.consentCategoryProvider.shutdown?.();
+  }
+
+  private injectConsentFilterIfApplicable = (plugin: Plugin) => {
+    if (this.isDestinationPlugin(plugin)) {
+      const settings = this.analytics?.settings.get()?.[plugin.key];
+
+      // FIXME: What stance should we take when this `if` block is false?
+      if (this.containsConsentSettings(settings)) {
+        plugin.add(
+          new ConsentFilterPlugin(settings.consentSettings.categories)
+        );
+      }
+    }
+  };
+
+  private handleConsentChange = async (updConsent: Record<string, boolean>) => {
+    await this.analytics?.track(SEGMENT_PREF_UPDATE_EVENT, {
+      consent: {
+        categoryPreferences: updConsent,
+      },
+    });
+  };
+
+  private isDestinationPlugin(plugin: Plugin): plugin is DestinationPlugin {
+    return plugin.type === PluginType.destination;
+  }
+
+  private containsConsentSettings = (
+    settings: IntegrationSettings | undefined
+  ): settings is Required<Pick<SegmentAPIIntegration, 'consentSettings'>> => {
+    return (
+      typeof (settings as SegmentAPIIntegration)?.consentSettings
+        ?.categories === 'object'
+    );
+  };
+}
+
+/**
+ * This plugin reads the consent metadata set on the context object and then drops the events
+ * if they are going into a destination which violates's set consent preferences
+ */
+class ConsentFilterPlugin extends Plugin {
+  type = PluginType.before;
+
+  constructor(private categories: string[]) {
+    super();
+  }
+
+  execute(event: SegmentEvent): SegmentEvent | undefined {
+    const preferences = event.context?.consent?.categoryPreferences;
+
+    // all categories this destination is tagged with must be present, and allowed in consent preferences
+    return this.categories.every((category) => preferences?.[category])
+      ? event
+      : undefined;
+  }
+}

packages/core/src/types.ts

@@ -213,6 +213,9 @@ export type Context = {
   timezone: string;
   traits: UserTraits;
   instanceId: string;
+  consent?: {
+    categoryPreferences: Record<string, boolean>;
+  };
 };
 
 /**
@@ -248,10 +251,13 @@ export type NativeContextInfo = {
   advertisingId?: string; // ios only
 };
 
-export type SegmentAPIIntegration = {
+export type SegmentAPIIntegration<T = object> = {
   apiKey: string;
   apiHost: string;
-};
+  consentSettings?: {
+    categories: string[];
+  };
+} & T;
 
 type SegmentAmplitudeIntegration = {
   session_id: number;
@@ -273,9 +279,8 @@ export type SegmentBrazeSettings = {
 
 export type IntegrationSettings =
   // Strongly typed known integration settings
-  | SegmentAPIIntegration
-  | SegmentAmplitudeIntegration
-  | SegmentAdjustSettings
+  | SegmentAPIIntegration<SegmentAmplitudeIntegration>
+  | SegmentAPIIntegration<SegmentAdjustSettings>
   // Support any kind of configuration in the future
   | Record<string, unknown>
   // enable/disable the integration at cloud level

packages/plugins/plugin-onetrust/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Segment
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/plugins/plugin-onetrust/README.md

@@ -0,0 +1,76 @@
+# @segment/analytics-react-native-plugin-onetrust
+
+Plugin for adding support for [OneTrust](https://onetrust.com/) CMP to your React Native application.
+
+## Installation
+
+You will need to install the `@segment/analytics-react-native-plugin-onetrust` package as a dependency in your project:
+
+Using NPM:
+
+```bash
+npm install --save @segment/analytics-react-native-plugin-onetrust react-native-onetrust-cmp
+```
+
+Using Yarn:
+
+```bash
+yarn add @segment/analytics-react-native-plugin-onetrust react-native-onetrust-cmp
+```
+
+## Usage
+
+Follow the [instructions for adding plugins](https://github.com/segmentio/analytics-react-native#adding-plugins) on the main Analytics client:
+
+After you create your segment client add `OneTrustPlugin` as a plugin, order doesn't matter, this plugin will apply to all device mode destinations you add before and after this plugin is added:
+
+```ts
+import { createClient } from '@segment/analytics-react-native';
+import { OneTrustPlugin } from '@segment/analytics-react-native-plugin-onetrust';
+import OTPublishersNativeSDK from 'react-native-onetrust-cmp';
+
+const segment = createClient({
+  writeKey: 'SEGMENT_KEY',
+});
+
+segment.add({
+  plugin: new OneTrust(OTPublishersNativeSDK, ['C001', 'C002', '...']),
+});
+
+// device mode destinations
+segment.add({ plugin: new BrazePlugin() });
+```
+
+## Support
+
+Please use Github issues, Pull Requests, or feel free to reach out to our [support team](https://segment.com/help/).
+
+## Integrating with Segment
+
+Interested in integrating your service with us? Check out our [Partners page](https://segment.com/partners/) for more details.
+
+## License
+
+```
+MIT License
+
+Copyright (c) 2021 Segment
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

packages/plugins/plugin-onetrust/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: ['module:metro-react-native-babel-preset'],
+};

packages/plugins/plugin-onetrust/jest.config.js

@@ -0,0 +1,16 @@
+const { pathsToModuleNameMapper } = require('ts-jest');
+const { compilerOptions } = require('./tsconfig');
+
+module.exports = {
+  preset: 'react-native',
+  roots: ['<rootDir>'],
+  setupFiles: ['../../core/src/__tests__/__helpers__/setup.ts'],
+  testPathIgnorePatterns: ['.../../core/src/__tests__/__helpers__/'],
+  modulePathIgnorePatterns: ['/lib/'],
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  modulePaths: [compilerOptions.baseUrl],
+  moduleNameMapper: pathsToModuleNameMapper(compilerOptions.paths),
+};