@jmartins-tillster/analytics-react-native 2.21.3

package/packages/plugins/plugin-braze/src/methods/__tests__/track.test.ts

@@ -0,0 +1,321 @@
+import type { TrackEventType } from '../../../../../core/src/types';
+import { BrazePlugin } from '../../BrazePlugin';
+import {
+  logCustomEvent,
+  logPurchase,
+  setAttributionData,
+} from '../__mocks__/@braze/react-native-sdk';
+import { UpdateType } from '../../../../../core/src/types';
+
+describe('#track', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('logs a custom event', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'ACTION',
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logCustomEvent).toHaveBeenCalledWith('ACTION', undefined);
+  });
+
+  it('logs a custom event with properties', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'ACTION',
+      properties: {
+        foo: 'bar',
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logCustomEvent).toHaveBeenCalledWith('ACTION', { foo: 'bar' });
+  });
+
+  it('logs tracks an install event', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Install Attributed',
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logCustomEvent).toHaveBeenCalledWith(
+      'Install Attributed',
+      undefined
+    );
+  });
+
+  it('logs tracks an install event with attribution', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Install Attributed',
+      properties: {
+        campaign: {
+          source: 'source',
+          name: 'name',
+          ad_group: 'ad_group',
+          ad_creative: 'ad_creative',
+        },
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(setAttributionData).toHaveBeenCalledWith(
+      'source',
+      'name',
+      'ad_group',
+      'ad_creative'
+    );
+    expect(logCustomEvent).toHaveBeenCalledWith('Install Attributed', {
+      campaign: {
+        source: 'source',
+        name: 'name',
+        ad_group: 'ad_group',
+        ad_creative: 'ad_creative',
+      },
+    });
+  });
+
+  it('tracks an Application Installed event when a value is null', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Install Attributed',
+      properties: {
+        campaign: {
+          source: 'source',
+          name: 'name',
+          ad_group: null,
+          ad_creative: 'ad_creative',
+        },
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(setAttributionData).toHaveBeenCalledWith(
+      'source',
+      'name',
+      '',
+      'ad_creative'
+    );
+    expect(logCustomEvent).toHaveBeenCalledWith('Install Attributed', {
+      campaign: {
+        source: 'source',
+        name: 'name',
+        ad_group: null,
+        ad_creative: 'ad_creative',
+      },
+    });
+  });
+
+  it('tracks an Application Installed event when a value is undefined/missing', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Install Attributed',
+      properties: {
+        campaign: {
+          source: 'source',
+          name: 'name',
+          //missing value
+          // ad_group: null,
+          ad_creative: 'ad_creative',
+        },
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(setAttributionData).toHaveBeenCalledWith(
+      'source',
+      'name',
+      '',
+      'ad_creative'
+    );
+    expect(logCustomEvent).toHaveBeenCalledWith('Install Attributed', {
+      campaign: {
+        source: 'source',
+        name: 'name',
+        ad_creative: 'ad_creative',
+      },
+    });
+  });
+
+  it('logs an order completed event', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Order Completed',
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith('Order Completed', '0', 'USD', 1);
+  });
+
+  it('logs an order completed event in the correct currency', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Order Completed',
+      properties: {
+        currency: 'JPY',
+        foo: 'bar',
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith('Order Completed', '0', 'JPY', 1, {
+      foo: 'bar',
+    });
+  });
+
+  it('logs an order completed event with revenue', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Order Completed',
+      properties: {
+        revenue: 399.99,
+        foo: 'bar',
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith(
+      'Order Completed',
+      '399.99',
+      'USD',
+      1,
+      {
+        foo: 'bar',
+      }
+    );
+  });
+
+  it('logs an order completed event with revenue as string', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Order Completed',
+      properties: {
+        revenue: '399.99',
+        foo: 'bar',
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith(
+      'Order Completed',
+      '399.99',
+      'USD',
+      1,
+      {
+        foo: 'bar',
+      }
+    );
+  });
+
+  it('logs an order completed event with revenue as 0', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Order Completed',
+      properties: {
+        revenue: {},
+        foo: 'bar',
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith('Order Completed', '0', 'USD', 1, {
+      foo: 'bar',
+    });
+  });
+
+  it('logs an order completed event with products', () => {
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'Order Completed',
+      properties: {
+        revenue: '399.99',
+        products: [
+          {
+            product_id: '123',
+            price: '399.99',
+            quantity: 4,
+          },
+        ],
+        foo: 'bar',
+      },
+    };
+
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith('123', '399.99', 'USD', 4, {
+      foo: 'bar',
+    });
+  });
+
+  it('logs a revenue event if `revenueEnabled` setting is true', () => {
+    const settings = {
+      integrations: { Appboy: { logPurchaseWhenRevenuePresent: true } },
+    };
+    const updateType: UpdateType = UpdateType.initial;
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'RevenueTest',
+      properties: {
+        revenue: 34,
+        foo: 'bar',
+      },
+    };
+    plugin.update(settings, updateType);
+    plugin.track(payload as TrackEventType);
+
+    expect(logPurchase).toHaveBeenCalledWith('RevenueTest', '34', 'USD', 1, {
+      foo: 'bar',
+    });
+  });
+
+  it('logs a custom event when revenue is 0', () => {
+    const settings = {
+      integrations: { Appboy: { logPurchaseWhenRevenuePresent: true } },
+    };
+    const updateType: UpdateType = UpdateType.initial;
+    const plugin = new BrazePlugin();
+    const payload = {
+      type: 'track',
+      event: 'RevenueTest',
+      properties: {
+        revenue: 0,
+        foo: 'bar',
+      },
+    };
+    plugin.update(settings, updateType);
+    plugin.track(payload as TrackEventType);
+
+    expect(logCustomEvent).toBeCalledWith('RevenueTest', {
+      revenue: 0,
+      foo: 'bar',
+    });
+  });
+});

package/packages/plugins/plugin-braze/src/methods/flush.ts

@@ -0,0 +1,5 @@
+import Braze from '@braze/react-native-sdk';
+
+export default () => {
+  Braze.requestImmediateDataFlush();
+};

package/packages/plugins/plugin-braze/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "lib/typescript",
+    "rootDir": ".",
+    "baseUrl": "."
+  },
+  "include": ["src/**/*", "types.d.ts"],
+  "references": [{ "path": "../../core" }]
+}

package/packages/plugins/plugin-braze-middleware/CHANGELOG.md

@@ -0,0 +1,32 @@
+### Dependencies
+
+* **@segment/analytics-react-native:** upgraded to 2.18.0
+* **@segment/sovran-react-native:** upgraded to 1.1.0
+
+## @segment/analytics-react-native-plugin-braze-middleware [1.1.0](https://github.com/segmentio/analytics-react-native/compare/@segment/analytics-react-native-plugin-braze-middleware-v1.0.1...@segment/analytics-react-native-plugin-braze-middleware-v1.1.0) (2023-12-15)
+
+
+### Features
+
+* RN 0.72 Upgrade ([03f13a1](https://github.com/segmentio/analytics-react-native/commit/03f13a19c79d8aaad726639de5f0327c748fed1f))
+
+
+
+### Dependencies
+
+* **@segment/analytics-react-native:** upgraded to 2.18.0
+* **@segment/sovran-react-native:** upgraded to 1.1.0
+
+## [@segment/analytics-react-native-plugin-braze-middleware-v1.0.1](https://github.com/segmentio/analytics-react-native/compare/@segment/analytics-react-native-plugin-braze-middleware-v1.0.0...@segment/analytics-react-native-plugin-braze-middleware-v1.0.1) (2023-04-18)
+
+
+### Bug Fixes
+
+* stricter linting, improved handling of plugin errrors ([#795](https://github.com/segmentio/analytics-react-native/issues/795)) ([1ddb4d5](https://github.com/segmentio/analytics-react-native/commit/1ddb4d571df794bc7eaa5c5302ed27b90faf9a73)), closes [#799](https://github.com/segmentio/analytics-react-native/issues/799) [#803](https://github.com/segmentio/analytics-react-native/issues/803) [#802](https://github.com/segmentio/analytics-react-native/issues/802)
+
+## @segment/analytics-react-native-plugin-braze-middleware-v1.0.0 (2023-03-14)
+
+
+### Bug Fixes
+
+* async-storage as optional peer dependency ([#779](https://github.com/segmentio/analytics-react-native/issues/779)) ([f3d5bc0](https://github.com/segmentio/analytics-react-native/commit/f3d5bc024fe3ae988386aac8b9f6f3fc6d84677a))

package/packages/plugins/plugin-braze-middleware/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.

package/packages/plugins/plugin-braze-middleware/README.md

@@ -0,0 +1,67 @@
+# @segment/analytics-react-native-plugin-braze-middleware
+
+`BeforePlugin`  to debounce `identify` events for [Braze](https://www.braze.com). This Plugin should be used with a [Cloud Mode](https://segment.com/docs/connections/destinations/#connection-modes) connection to Braze. To connect to Braze with a Device Mode connection use the [Braze Destination Plugin]((https://www.npmjs.com/package/@segment/analytics-react-native-plugin-braze))instead. It is not possible to use both plugins in one `Analytics React Native` instance. 
+
+## Installation
+
+You need to install the `@segment/analytics-react-native-plugin-braze-middleware`.
+
+Using NPM:
+```bash
+npm install --save @segment/analytics-react-native-plugin-braze-middleware 
+```
+
+Using Yarn:
+```bash
+yarn add @segment/analytics-react-native-plugin-braze-middleware
+```
+## Usage
+
+Follow the [instructions for adding plugins](https://github.com/segmentio/analytics-react-native#adding-plugins) on the main Analytics client:
+
+In your code where you initialize the analytics client call the `.add(plugin)` method with an `BrazeMiddlewarePlugin` instance:
+
+```ts
+import { createClient } from '@segment/analytics-react-native';
+
+import { BrazePlugin } from '@segment/analytics-react-native-plugin-braze-middleware';
+
+const segmentClient = createClient({
+  writeKey: 'SEGMENT_KEY'
+});
+
+segmentClient.add({ plugin: new BrazeMiddlewarePlugin() });
+```
+
+## 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.
+```

package/packages/plugins/plugin-braze-middleware/babel.config.js

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

package/packages/plugins/plugin-braze-middleware/jest.config.js

@@ -0,0 +1,5 @@
+const baseConfig = require('@segment/analytics-rn-shared/jest.config.base');
+
+module.exports = {
+  ...baseConfig,
+};

package/packages/plugins/plugin-braze-middleware/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@segment/analytics-react-native-plugin-braze-middleware",
+  "version": "1.1.0",
+  "description": "The hassle-free way to add Segment analytics to your React-Native app.",
+  "main": "lib/commonjs/index",
+  "scripts": {
+    "build": "bob build",
+    "test": "jest",
+    "typescript": "tsc --noEmit",
+    "clean": "rimraf lib node_modules"
+  },
+  "keywords": [
+    "segment",
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "module": "lib/module/index",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "segment-analytics-react-native.podspec",
+    "package.json",
+    "!src/**/*.e2e.mock.js",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!android/.gradle",
+    "!android/.idea"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/segmentio/analytics-react-native.git",
+    "directory": "packages/core"
+  },
+  "author": "Segment <hello@segment.com> (https://segment.com/)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/segmentio/analytics-react-native/issues"
+  },
+  "homepage": "https://github.com/segmentio/analytics-react-native/tree/master/packages/plugins/plugin-braze-middleware#readme",
+  "peerDependencies": {
+    "@segment/analytics-react-native": "^2.18.0"
+  },
+  "devDependencies": {
+    "@segment/analytics-react-native": "^2.18.0",
+    "@segment/analytics-rn-shared": "workspace:^",
+    "@segment/sovran-react-native": "^1.1.0",
+    "jest": "^29.7.0",
+    "react-native-builder-bob": "^0.23.1",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.2.2"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      "typescript"
+    ]
+  },
+  "engines": {
+    "node": ">=12"
+  }
+}

package/packages/plugins/plugin-braze-middleware/release.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['../../../release.config.js'],
+};

package/packages/plugins/plugin-braze-middleware/src/BrazeMiddlewarePlugin.tsx

@@ -0,0 +1,38 @@
+import {
+  Plugin,
+  PluginType,
+  UserInfoState,
+  SegmentEvent,
+  EventType,
+} from '@segment/analytics-react-native';
+
+export class BrazeMiddlewarePlugin extends Plugin {
+  type = PluginType.before;
+  key = 'Appboy';
+  private lastSeenTraits: UserInfoState | undefined = undefined;
+
+  execute(event: SegmentEvent): SegmentEvent | undefined {
+    //check to see if anything has changed
+    //if it hasn't changed disable integration
+    if (event.type === EventType.IdentifyEvent) {
+      if (
+        this.lastSeenTraits?.userId === event.userId &&
+        this.lastSeenTraits?.anonymousId === event.anonymousId &&
+        this.lastSeenTraits?.traits === event.traits
+      ) {
+        const integrations = event.integrations;
+
+        if (integrations !== undefined) {
+          integrations[this.key] = false;
+        }
+      } else {
+        this.lastSeenTraits = {
+          anonymousId: event.anonymousId ?? '',
+          userId: event.userId,
+          traits: event.traits,
+        };
+      }
+    }
+    return event;
+  }
+}

package/packages/plugins/plugin-braze-middleware/src/index.ts

@@ -0,0 +1 @@
+export * from './BrazeMiddlewarePlugin';

package/packages/plugins/plugin-braze-middleware/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "lib/typescript",
+    "rootDir": ".",
+    "baseUrl": "."
+  },
+  "include": ["src/**/*", "types.d.ts"],
+  "references": [{ "path": "../../core" }]
+}

package/packages/plugins/plugin-clevertap/CHANGELOG.md

@@ -0,0 +1,32 @@
+### Dependencies
+
+* **@segment/analytics-react-native:** upgraded to 2.18.0
+* **@segment/sovran-react-native:** upgraded to 1.1.0
+
+## [@segment/analytics-react-native-plugin-clevertap-v1.0.3](https://github.com/segmentio/analytics-react-native/compare/@segment/analytics-react-native-plugin-clevertap-v1.0.2...@segment/analytics-react-native-plugin-clevertap-v1.0.3) (2023-08-21)
+
+
+### Bug Fixes
+
+* package dependency fixes ([#869](https://github.com/segmentio/analytics-react-native/issues/869)) ([08d415e](https://github.com/segmentio/analytics-react-native/commit/08d415e3b1cfd8499f5f6984f2859a30a851da12))
+
+## [@segment/analytics-react-native-plugin-clevertap-v1.0.2](https://github.com/segmentio/analytics-react-native/compare/@segment/analytics-react-native-plugin-clevertap-v1.0.1...@segment/analytics-react-native-plugin-clevertap-v1.0.2) (2023-06-02)
+
+
+### Bug Fixes
+
+* fix flush policies reference copy, add BackgroundPolicy ([#838](https://github.com/segmentio/analytics-react-native/issues/838)) ([e4b558a](https://github.com/segmentio/analytics-react-native/commit/e4b558a95e250b1b21d677e08ffeb02a4015bda6))
+
+## [@segment/analytics-react-native-plugin-clevertap-v1.0.1](https://github.com/segmentio/analytics-react-native/compare/@segment/analytics-react-native-plugin-clevertap-v1.0.0...@segment/analytics-react-native-plugin-clevertap-v1.0.1) (2023-04-18)
+
+
+### Bug Fixes
+
+* stricter linting, improved handling of plugin errrors ([#795](https://github.com/segmentio/analytics-react-native/issues/795)) ([1ddb4d5](https://github.com/segmentio/analytics-react-native/commit/1ddb4d571df794bc7eaa5c5302ed27b90faf9a73)), closes [#799](https://github.com/segmentio/analytics-react-native/issues/799) [#803](https://github.com/segmentio/analytics-react-native/issues/803) [#802](https://github.com/segmentio/analytics-react-native/issues/802)
+
+## @segment/analytics-react-native-plugin-clevertap-v1.0.0 (2023-02-10)
+
+
+### Features
+
+* add clevertap plugin ([#759](https://github.com/segmentio/analytics-react-native/issues/759)) ([fcf3933](https://github.com/segmentio/analytics-react-native/commit/fcf393321145995ab9a2c46b15ee05cf4e066dfd))

package/packages/plugins/plugin-clevertap/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.