react-native-moengage 8.7.1 → 9.0.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# 18-03-2024
+
+## 9.0.0
+- Added Nudge Support
+- Bugfix
+  - Exception thrown `MoEInAppSelfHandledCampaign is an invalid object` while logging
+- iOS
+    - MoEngage-iOS-SDK version updated to `~>9.16.1`.
+- Android
+  - Support for MoEngage Core 13.00.00 and above
+  - Added support for AGP `8.2.2` and above
+
 # 12-02-2024
 
 ## 8.7.1

package/LICENSE.txt

@@ -0,0 +1,8 @@
+The Licensee desires to conduct a technical trial (hereafter referred to as the "Trial") or deployment of the source code or binaries contained within MoEngage SDK (“Software”) under a limited license from the Licensor.
+
+
+The Licensee may not modify: (i) permit any third party to use the Software; (ii) modify or translate the Software except as otherwise permitted; (iii) reverse engineer, decompile, or disassemble the Software; (iv) copy the Software, except as expressly provided above; or (vi) remove or obscure any proprietary rights notices or labels on the Software. 
+Licensee may not transfer the Software or any rights under this Agreement without the Licensor's prior written consent.
+MoEngage owns the Software and all intellectual property rights embodied therein, including copyrights and valuable trade secrets embodied in the Software.
+The Licensee shall not alter or remove this copyright notice. 
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF THE USER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,88 +1,9 @@
-# React Native MoEngage 
+# React Native MoEngage
 
-## SDK Installation
-Install MoEngage's React Native plugin using the npm package manager. And then link your native dependencies :
-```
-$ npm install react-native-moengage
-$ react-native link
-```
+This plugin is for using the MoEngage platform. Using this plugin you can use the following features of the MoEngage platform
 
-After installing the plugin lets move on to platform specific configuration.
+- Analytics/Data Tracking
+- Push Notification
+- InApp Notifications
 
-### Android
-Add `mavenCentral()` repository in the project-level `build.gradle` file.
-
-```groovy
-buildscript { 
-  repositories 
-  { 
-    mavenCentral() 
-  } 
-} 
-
-allprojects { 
-  repositories { 
-    mavenCentral() 
-  } 
-}
-```
-
-In android/settings.gradle add the following
-
-```groovy
-include ':react-native-moengage'
-project(':react-native-moengage').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-moengage/android')
-```
-
-In android/app/build.gradle add the following
-
-```groovy
- dependencies {
-    ...
-
-    implementation project(':react-native-moengage')
-    implementation("com.moengage:moe-android-sdk:11.6.02")
-    implementation("androidx.core:core:1.3.1")
-    implementation("androidx.appcompat:appcompat:1.2.0")
-    implementation("androidx.lifecycle:lifecycle-process:2.2.0")
-}
-```
-Add the MoEngage React Package in the Application class's getPackages() Also enable auto integration in the onCreate()
-
-```java
- public class MainApplication extends Application implements ReactApplication {
-
-  private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
-    @Override
-    protected boolean getUseDeveloperSupport() {
-      return BuildConfig.DEBUG;
-    }
-
-    @Override
-    protected List<ReactPackage> getPackages() {
-      return Arrays.<ReactPackage>asList(
-          new MainReactPackage(), new MoEReactPackage());
-    }
-  };
-
-  @Override public void onCreate() {
-    super.onCreate();
-    MoEHelper.getInstance(getApplicationContext()).autoIntegrate(this);
-  }
-
-  @Override
-  public ReactNativeHost getReactNativeHost() {
-      return mReactNativeHost;
-  }
-}
-```
-In case you are facing issues with the import add the below import statement in your java file.
-
-```java
- import com.moengage.react.MoEReactPackage;
-```
- 
-### iOS
-There are no additional steps required for installation.
-
-For more info on how to use react-native-moengage, refer to our developer docs: https://developers.moengage.com/hc/en-us/categories/4404199274900-React-Native-SDK
+Refer to our [integration documentation](https://developers.moengage.com/hc/en-us/categories/4404199274900-React-Native-SDK) to learn more on how to integrate and use the plugin.

package/ReactNativeMoEngage.podspec

@@ -15,8 +15,8 @@ Pod::Spec.new do |s|
   s.platforms = { :ios => "11.0", :tvos => "11.0" }
   s.source_files        = 'iOS/MoEReactBridge/**/*.{h,m}'
   s.dependency          'React'
-  s.dependency          'MoEngagePluginBase','>= 4.6.0','< 4.7.0'
-  s.ios.dependency  	'MoEngageRichNotification','>= 7.14.0','< 7.15.0'
+  s.dependency          'MoEngagePluginBase','>= 4.7.0','< 4.8.0'
+  s.ios.dependency  	'MoEngageRichNotification','>= 7.15.0','< 7.16.0'
 
   s.prepare_command = <<-CMD
     echo // Generated file, do not edit > iOS/MoEReactBridge/MoEngageReactPluginInfo.h

package/android/build.gradle

@@ -6,7 +6,7 @@ buildscript {
   }
 
   dependencies {
-    classpath 'com.android.tools.build:gradle:8.0.2'
+    classpath 'com.android.tools.build:gradle:8.2.2'
     classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
   }
 }
@@ -20,12 +20,11 @@ rootProject.allprojects {
 
 ext {
   //dependency version
-  moengageCoreVersion = "12.10.00"
-  moengageInAppVersion = "7.1.0"
-  basePluginVersion = "3.4.0"
+  moengageCoreVersion = "13.00.01"
+  moengageInAppVersion = "8.1.0"
+  basePluginVersion = "4.0.0"
   //build versions
   minimumVersion = 21
-  targetVersion = 33
   compileVersion = 33
 }
 
@@ -37,7 +36,6 @@ android {
   namespace "com.moengage.react"
   defaultConfig {
     minSdk minimumVersion
-    targetSdk targetVersion
     versionCode 1
     versionName "1.0"
 
@@ -58,6 +56,9 @@ android {
   kotlinOptions {
     freeCompilerArgs = ['-Xjvm-default=all']
   }
+  buildFeatures {
+    buildConfig true
+  }
 }
 
 dependencies {

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 #Thu Aug 18 13:23:11 IST 2022
 distributionBase=GRADLE_USER_HOME
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-all.zip
 distributionPath=wrapper/dists
 zipStorePath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME

package/android/gradle.properties

@@ -1,2 +1 @@
-android.useAndroidX=true
-android.defaults.buildfeatures.buildconfig=true
+android.useAndroidX=true

package/android/src/main/java/com/moengage/react/EventEmitterImpl.kt

@@ -67,7 +67,8 @@ class EventEmitterImpl(private val reactContext: ReactContext) : EventEmitter {
     private fun emitInAppSelfHandled(event: InAppSelfHandledEvent) {
         Logger.print { "$tag emitInAppSelfHandled() : $event" }
         val eventName = eventMapping[event.eventType] ?: return
-        val payload = PayloadGenerator().selfHandledDataToWriteableMap(event.data)
+        val payload =
+            PayloadGenerator().selfHandledDataToWriteableMap(event.accountMeta, event.data)
         emit(eventName, payload)
     }
 

package/android/src/main/java/com/moengage/react/MoEReactBridge.kt

@@ -189,9 +189,9 @@ class MoEReactBridge(private val reactContext: ReactApplicationContext) :
     @ReactMethod
     fun validateSdkVersion(promise: Promise) {
         Logger.print { "$tag validateSdkVersion() : Validating Version" }
-        if (moeSdkVersion > 130000) {
+        if (moeSdkVersion > 140000) {
             Logger.print(LogLevel.ERROR) { "$tag validateSdkVersion() : invalid version" }
-            promise.reject("error", "Use SDK version 12.x.xx")
+            promise.reject("error", "Use SDK version less than 14.xx.xx")
         } else {
             Logger.print { "$tag validateSdkVersion() : valid version" }
             promise.resolve("valid version");
@@ -294,4 +294,18 @@ class MoEReactBridge(private val reactContext: ReactApplicationContext) :
             promise.reject(t)
         }
     }
+
+    /**
+     * Try to show a non-intrusive In-App nudge
+     * @since Todo: Add Version
+     */
+    @ReactMethod
+    fun showNudge(payload: String) {
+        try {
+            Logger.print { "$tag showNudge() : Payload: $payload" }
+            pluginHelper.showNudge(context, payload)
+        } catch (t: Throwable) {
+            Logger.print(LogLevel.ERROR, t) { "$tag showNudge() :" }
+        }
+    }
 }

package/android/src/main/java/com/moengage/react/PayloadGenerator.kt

@@ -3,6 +3,7 @@ package com.moengage.react
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
 import com.moengage.core.internal.logger.Logger
+import com.moengage.core.model.AccountMeta
 import com.moengage.inapp.model.ClickData
 import com.moengage.inapp.model.InAppData
 import com.moengage.inapp.model.SelfHandledCampaignData
@@ -51,10 +52,13 @@ internal class PayloadGenerator {
         return map
     }
 
-    fun selfHandledDataToWriteableMap(data: SelfHandledCampaignData): WritableMap {
-        val map = Arguments.createMap()
-        val json = selfHandledDataToJson(data)
+    fun selfHandledDataToWriteableMap(
+        accountMeta: AccountMeta,
+        data: SelfHandledCampaignData?
+    ): WritableMap {
         Logger.print { "$tag selfHandledDataToWriteableMap() : $data" }
+        val map = Arguments.createMap()
+        val json = selfHandledDataToJson(accountMeta, data)
         map.putString(ARGUMENT_PAYLOAD, json.toString())
         return map
     }

package/iOS/MoEReactBridge/MoEReactBridge.m

@@ -140,6 +140,11 @@ RCT_EXPORT_METHOD(showInApp:(NSDictionary *)payload)
     [[MoEngagePluginBridge sharedInstance] showInApp:payload];
 }
 
+RCT_EXPORT_METHOD(showNudge:(NSDictionary *)payload)
+{
+    [[MoEngagePluginBridge sharedInstance] showNudge: payload];
+}
+
 #pragma mark Self handled In App
 
 RCT_EXPORT_METHOD(getSelfHandledInApp:(NSDictionary *)payload)

package/iOS/MoEReactBridge/MoEngageInitializer.m

@@ -109,7 +109,8 @@
         }
         
         if ([moeDict objectForKey:kEnableLogs] != nil && [moeDict objectForKey:kEnableLogs] != [NSNull null]) {
-            sdkConfig.enableLogs = [MoEngageReactUtils getBooleanForKey:kEnableLogs dict:moeDict];
+            BOOL isLogsEnabled = [MoEngageReactUtils getBooleanForKey:kEnableLogs dict:moeDict];
+            sdkConfig.consoleLogConfig = [[MoEngageConsoleLogConfig alloc] initWithIsLoggingEnabled:isLogsEnabled loglevel:MoEngageLoggerTypeVerbose];
         }
     }
     

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-moengage",
-  "version": "8.7.1",
+  "version": "9.0.0",
   "description": "MoEngage is a mobile marketing automation company. This react-native SDK helps you track events, trigger smart notifications and in-apps, provides a drop-in Inbox Controller for notifications.",
   "main": "src/index.ts",
   "files": [
@@ -26,11 +26,14 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "author": "MoEngage",
+  "author": {
+    "name": "MoEngage",
+    "email": "mobiledevs@moengage.com"
+  },
   "contributors": [
     "MoEngage <mobiledevs@moengage.com>"
   ],
-  "license": "ISC",
+  "license": "SEE LICENSE IN LICENSE.txt",
   "devDependencies": {
     "@types/react-native": "^0.69.3"
   }

package/src/index.ts

@@ -10,6 +10,7 @@ import {MoERNiOS} from "./platform/MoERNiOS";
 import MoEInAppCustomAction from "./models/MoEInAppCustomAction";
 import MoEInAppNavigation from "./models/MoEInAppNavigation";
 import {executeHandler} from "./utils/MoEEventHandlerHelper";
+
 import {
     getAdIdTrackingJson,
     getAliasJson,
@@ -27,7 +28,8 @@ import {
     getUserLocAttributeJson,
     getPushPermissionRequestCountJson,
     getDeviceIdTrackingJson,
-    getInitConfigJson
+    getInitConfigJson,
+    getNudgeDisplayJson
 } from "./utils/MoEJsonBuilder";
 import {
     USER_ATTRIBUTE_UNIQUE_ID,
@@ -50,6 +52,7 @@ import MoEngageGlobalCache from "./utils/MoEngageGlobalCache";
 import MoEngageLogger from "./logger/MoEngageLogger";
 import UserDeletionData from "./models/UserDeletionData";
 import MoEAccountMeta from "./models/MoEAccountMeta";
+import { MoEngageNudgePosition } from "./models/MoEngageNudgePosition";
 
 const MoEReactBridge = require("react-native").NativeModules.MoEReactBridge;
 const PLATFORM_ANDROID = "android";
@@ -465,6 +468,20 @@ var ReactMoE = {
     }
   },
 
+  /**
+   * Call This method to show the nudge
+   * @param position position at which nudge should be displayed.
+   */
+  showNudge: function(position: MoEngageNudgePosition = MoEngageNudgePosition.Any){
+    commonValidationCheck();
+    let jsonPayload =  getNudgeDisplayJson(position, moeAppId);
+    if (Platform.OS == PLATFORM_ANDROID) {
+      MoERNAndroid.showNudge(jsonPayload);
+    } else if (Platform.OS == PLATFORM_IOS) {
+      MoERNiOS.showNudge(jsonPayload);
+    }
+  },
+
   /**
    * Call this method when you show the self handled in-app so we can update impressions.
    * @param {MoESelfHandledCampaignData}campInfo : campaign information object
@@ -834,6 +851,7 @@ export {
   MoEPushConfig,
   MoEngageLogConfig,
   MoEngageLogLevel,
-  MoEngageLogger
+  MoEngageLogger,
+  MoEngageNudgePosition,
 };
 export default ReactMoE;

package/src/models/MoEPushService.ts

@@ -1,6 +1,5 @@
 export enum MoEPushService {
   APNS = "APNS",
   FCM = "FCM",
-  MI_PUSH = "MI_PUSH",
   PUSH_KIT = "PUSH_KIT",
 }

package/src/models/MoEngageNudgePosition.ts

@@ -0,0 +1,7 @@
+export enum MoEngageNudgePosition {
+  Top = "top",
+  Bottom = "bottom",
+  BottomLeft = "bottomLeft",
+  BottomRight = "bottomRight",
+  Any = "any"
+}

package/src/moeParser/MoEInAppParser.ts

@@ -111,7 +111,7 @@ export function getMoESelfHandledCampaignData(json: { [k: string]: any }, accoun
         var campaign = getMoESelfHandledCampaign(json);
         return new MoESelfHandledCampaignData(accountMeta, platform, campaign, campaignData);
     }
-    else return undefined
+    else return null
 }
 
 
@@ -160,13 +160,16 @@ export function isSelfHandledCampaignValid(obj: { [k: string]: any }) {
     try {
         if (obj[MOE_SELF_HANDLED] != undefined && isValidObject(obj[MOE_SELF_HANDLED])) {
             var selfHandled = obj[MOE_SELF_HANDLED];
-            if (selfHandled[MOE_PAYLOAD] != undefined && selfHandled[MOE_DISMISSINTERVAL] != undefined)
+            if (selfHandled[MOE_PAYLOAD] != undefined && selfHandled[MOE_DISMISSINTERVAL] != undefined) {
+                MoEngageLogger.info("SelfHandled campaign has data");
                 return true;
-            else throw new Error(MOE_SELF_HANDLED_OBJ_ERROR);
+            } else {
+                MoEngageLogger.info("SelfHandled campaign has no data");
+                return false;
+            }
 
-        }
-        else {
-            throw new Error(MOE_SELF_HANDLED_OBJ_ERROR);
+        } else {
+            return false;
         }
     }
     catch (error: any) {

package/src/platform/MoERNAndroid.ts

@@ -161,4 +161,12 @@ export class MoERNAndroid {
     const deleteUserPayload = await MoEReactBridge.deleteUser(JSON.stringify(payload));
     return getUserDeletionData(deleteUserPayload);
   }
+
+  /**
+   * Try to show a non-intrusive In-App nudge
+   * @since Todo: Add Version
+   */
+  static showNudge(payload: { [k: string]: any }) {
+    MoEReactBridge.showNudge(JSON.stringify(payload));
+  }
 }

package/src/platform/MoERNiOS.ts

@@ -31,6 +31,10 @@ export class MoERNiOS {
     MoEReactBridge.showInApp(payload);
   }
 
+  static showNudge(payload: { [k: string]: any }) {
+    MoEReactBridge.showNudge(payload);
+  }
+
   static getSelfHandledInApp(payload: { [k: string]: any }) {
     MoEReactBridge.getSelfHandledInApp(payload);
   }

package/src/utils/MoEJsonBuilder.ts

@@ -7,6 +7,7 @@ import { MoEPropertiesToJson} from "./MoEObjectToJson";
 import {MoEngagePermissionType} from "../models/MoEngagePermissionType";
 import MoEInitConfig from "../models/MoEInitConfig";
 import MoEngageLogger from "../logger/MoEngageLogger";
+import { MoEngageNudgePosition } from "../models/MoEngageNudgePosition";
 
 export function getInAppCampaignJson(moEInAppData: MoEInAppData, type: string, appId: String) {
   var json: { [k: string]: any } = {
@@ -267,4 +268,16 @@ export function getInitConfigJson(appId: String, initConfig: MoEInitConfig) {
     }
   }
   return json;
-}
+}
+
+export function getNudgeDisplayJson(nudgePosition: MoEngageNudgePosition, appId: String) {
+  var json: { [k: string]: any } = {
+    accountMeta: {
+      appId: appId
+    },
+    data: {
+      position: nudgePosition.toString()
+    }
+  }
+  return json;
+}