@selligent-marketing-cloud/selligent-react-native 2.2.0 → 2.6.0

package/RNSelligent.podspec

@@ -18,11 +18,11 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m}"
   s.requires_arc = true
 
-  s.vendored_libraries = "ios/libSelligentMobile2.5.a"
-  s.libraries = "SelligentMobile2.5"
+  s.vendored_libraries = "ios/libSelligentMobile2.7.a"
+  s.libraries = "SelligentMobile2.7"
 
   s.dependency "React"
-  s.dependency 'PlotPlugin', '3.3.2'
+  s.dependency 'PlotPlugin'
 end
 
-  
+  

package/android/build.gradle

@@ -1,4 +1,3 @@
-
 buildscript {
     repositories {
         jcenter()
@@ -6,7 +5,7 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.5.3'
+        classpath 'com.android.tools.build:gradle:4.2.2'
     }
 }
 
@@ -23,11 +22,25 @@ android {
         versionCode 1
         versionName "1.0"
     }
+
     lintOptions {
         abortOnError false
     }
 }
 
+androidComponents {
+    onVariants(selector(), { variant ->
+        def selligentSettings = loadSelligentSettings(variant)
+        if (selligentSettings != null) {
+            try {
+                variant.addBuildConfigField("SELLIGENT_SETTINGS", "\"" + selligentSettings + "\"", "Selligent settings")
+            } catch (MissingMethodException ignored) {
+                throw new Exception("Selligent requires Android Gradle plugin version 4.2.0 or higher.")
+            }
+        }
+    })
+}
+
 repositories {
     maven {
         url "$projectDir/../node_modules/react-native/android"
@@ -36,13 +49,12 @@ repositories {
 }
 
 dependencies {
-    implementation(name:'sdk-release', ext:'aar')
+    implementation(name: 'sdk-release', ext: 'aar')
 
     implementation 'com.facebook.react:react-native:+'
     implementation 'com.android.support:cardview-v7:27.1.1'
-    implementation 'com.plotprojects:plot-android:3.12.1'
+    implementation 'com.plotprojects:plot-android:3.13.1'
     implementation 'com.google.code.gson:gson:2.8.5'
-    implementation 'com.firebase:firebase-jobdispatcher:0.8.5'
     implementation 'com.google.firebase:firebase-messaging:21.0.0'
     implementation 'androidx.work:work-runtime:2.4.0'
     implementation 'androidx.concurrent:concurrent-futures:1.1.0'
@@ -112,16 +124,26 @@ afterEvaluate { project ->
     }
 }
 
-def loadSelligentSettings() {
-    def selligentFileName = "selligent.json"
-    println("Reading Selligent settings from: $selligentFileName")
+def loadSelligentSettings(variant) {
+    println(variant.flavorName)
+
+    def defaultSelligentFileName = "selligent.json"
+    File defaultFile = new File("$project.rootDir/../$defaultSelligentFileName")
 
-    File f = new File("$project.rootDir/../$selligentFileName");
+    def variantSelligentFileName = "selligent.${variant.getName()}.json"
+    File variantFile = new File("$project.rootDir/../$variantSelligentFileName");
 
     def resultingSettings = null
-    if (f.exists()) {
+    if (variantFile.exists()) {
+        println("Reading Selligent properties for variant ${variant.getName()} using $variantSelligentFileName")
         resultingSettings = ""
-        f.eachLine { String line ->
+        variantFile.eachLine { String line ->
+            resultingSettings += line.replace("\"", "\\\"").replaceAll("\\s", "")
+        }
+    } else if (defaultFile.exists()) {
+        println("Reading Selligent properties from default $defaultSelligentFileName (no variant specific $variantSelligentFileName was found)")
+        resultingSettings = ""
+        defaultFile.eachLine { String line ->
             resultingSettings += line.replace("\"", "\\\"").replaceAll("\\s", "")
         }
     } else {
@@ -129,18 +151,4 @@ def loadSelligentSettings() {
     }
 
     return resultingSettings
-}
-
-tasks.whenTaskAdded { task ->
-    task.doFirst() {
-        android.libraryVariants.all { variant ->
-            if (task.name.toLowerCase() == "pre${variant.name}build") {
-                def selligentSettings = loadSelligentSettings()
-                if (selligentSettings != null) {
-                    variant.buildConfigField "String", "SELLIGENT_SETTINGS", "\"$selligentSettings\""
-                }
-            }
-
-        }
-    }
-}
+}

package/android/src/main/java/com/selligent/RNSelligent.java

@@ -7,6 +7,8 @@ import android.content.Intent;
 import android.content.IntentFilter;
 import android.content.res.Resources;
 import androidx.localbroadcastmanager.content.LocalBroadcastManager;
+
+import android.graphics.Color;
 import android.util.Log;
 
 import com.facebook.react.bridge.ActivityEventListener;
@@ -72,7 +74,7 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
             final SMSettings smSettings = SMSettingsFactory.getSMSettings(settings);
             final String notificationActivityName = settings.getActivityName();
 
-            SMManager.NOTIFICATION_ACTIVITY = Class.forName(notificationActivityName);
+            SMManager.NOTIFICATION_ACTIVITY = (Class<? extends Activity>) Class.forName(notificationActivityName);
 
             final SMManager smManager = SMManager.getInstance();
             smManager.start(smSettings, application);
@@ -93,6 +95,15 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
                 }
             }
 
+            if (settings.getNotificationIconColor() != null && !settings.getNotificationIconColor().isEmpty()) {
+                try {
+                    final int color = Color.parseColor(settings.getNotificationIconColor());
+                    smManager.setNotificationIconColor(color);
+                } catch (IllegalArgumentException e) {
+                    Log.e("RNSelligent", "notificationIconColor must be a color hex string.");
+                }
+            }
+
         } catch (ClassNotFoundException e) {
             Log.e("RNSelligent", "SMManager start failed: an error occurred while setting the NotificationActivity", e);
         }
@@ -163,20 +174,26 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
                     messageMap.putDouble("expirationDate", message.getExpirationDate());
                     messageMap.putDouble("receptionDate", message.getReceptionDate());
                     messageMap.putBoolean("hasBeenSeen", message.hasBeenSeen());
+                    messageMap.putDouble("type", message.getType().getValue());
 
                     WritableArray buttonsArray = new WritableNativeArray();
 
-                    for(SMNotificationButton button : message.getButtons()) {
-                        WritableMap buttonMap = new WritableNativeMap();
+                    SMNotificationButton buttons[] = message.getButtons();
+
+                    if(buttons != null) {
+                        for(SMNotificationButton button : buttons) {
+                            WritableMap buttonMap = new WritableNativeMap();
 
-                        buttonMap.putString("id", button.id);
-                        buttonMap.putString("value", button.value);
-                        buttonMap.putString("label", button.label);
-                        buttonMap.putInt("action", button.action);
-                        buttonMap.putInt("type", button.type);
+                            buttonMap.putString("id", button.id);
+                            buttonMap.putString("value", button.value);
+                            buttonMap.putString("label", button.label);
+                            buttonMap.putInt("action", button.action);
+                            buttonMap.putInt("type", button.type);
 
-                        buttonsArray.pushMap(buttonMap);
+                            buttonsArray.pushMap(buttonMap);
+                        }
                     }
+
                     messageMap.putArray("buttons", buttonsArray);
 
                     resultingMessagesArray.pushMap(messageMap);
@@ -265,6 +282,12 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
         smManager.sendSMEvent(smEvent);
     }
 
+    @ReactMethod
+    public void getDeviceId(Callback successCallback) {
+        final String deviceId = smManager.getDeviceId();
+        successCallback.invoke(deviceId);
+    }
+
     @ReactMethod
     public void enableNotifications(Boolean enable) {
         if (enable) {
@@ -323,6 +346,27 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
         return resourceId;
     }
 
+    @ReactMethod
+    public void setNotificationIconColor(final String colorString, final Callback successCallback, final Callback errorCallback) {
+        try {
+            final int color = Color.parseColor(colorString);
+            smManager.setNotificationIconColor(color);
+            successCallback.invoke();
+        } catch (IllegalArgumentException e) {
+            errorCallback.invoke("color must be a color hex string.");
+        }
+    }
+
+    @ReactMethod
+    public void setNotificationActivity(final String activityName, final Callback successCallback, final Callback errorCallback) {
+        try {
+            SMManager.NOTIFICATION_ACTIVITY = (Class<? extends Activity>) Class.forName(activityName);
+            successCallback.invoke();
+        } catch (ClassNotFoundException e) {
+            errorCallback.invoke(String.format("Activity %s not found.", activityName));
+        }
+    }
+
     @ReactMethod
     public void getGCMToken(Callback callback) {
         final String gcmToken = smManager.getGCMToken();
@@ -390,8 +434,6 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
             }
             currentActivity.registerReceiver(receiver, receiver.getIntentFilter());
 
-            smManager.registerDevice(currentActivity);
-
             smManager.checkAndDisplayMessage(currentActivity.getIntent(), currentActivity);
         }
     }
@@ -413,6 +455,7 @@ public class RNSelligent extends ReactContextBaseJavaModule implements Lifecycle
         final Activity currentActivity = getCurrentActivity();
 
         if (currentActivity != null) {
+            currentActivity.setIntent(intent);
             smManager.checkAndDisplayMessage(intent, currentActivity);
         }
     }

package/android/src/main/java/com/selligent/SMSettingsFactory.java

@@ -11,6 +11,7 @@ class SMSettingsFactory {
         smSettings.PrivateKey = settings.getPrivateKey();
         smSettings.GoogleApplicationId = settings.getGoogleApplicationId();
         smSettings.ConfigureGeolocation = settings.getConfigureLocationServices();
+        smSettings.AddInAppMessageFromPushToInAppMessageList = settings.getAddInAppMessageFromPushToInAppMessageList();
         smSettings.DoNotFetchTheToken = settings.getDoNotFetchTheToken();
         smSettings.DoNotListenToThePush = settings.getDoNotListenToThePush();
         smSettings.LoadCacheAsynchronously = settings.getLoadCacheAsynchronously();

package/android/src/main/java/com/selligent/Settings.java

@@ -12,6 +12,8 @@ class Settings {
     private String activityName;
     private String notificationSmallIcon;
     private String notificationLargeIcon;
+    private String notificationIconColor;
+    private boolean addInAppMessageFromPushToInAppMessageList = false;
     private Boolean doNotFetchTheToken = false;
     private Boolean doNotListenToThePush = false;
     private Boolean loadCacheAsynchronously = false;
@@ -50,12 +52,18 @@ class Settings {
         return notificationLargeIcon;
     }
 
+    public String getNotificationIconColor() {
+        return notificationIconColor;
+    }
+
     public Boolean getConfigureLocationServices() {
         return configureLocationServices;
     }
 
     public Boolean getDoNotListenToThePush() { return doNotListenToThePush; }
 
+    public Boolean getAddInAppMessageFromPushToInAppMessageList() { return addInAppMessageFromPushToInAppMessageList; }
+
     public Boolean getDoNotFetchTheToken() { return doNotFetchTheToken; }
 
     public Boolean getLoadCacheAsynchronously() { return loadCacheAsynchronously; }
@@ -95,6 +103,14 @@ class Settings {
             settings.notificationLargeIcon = (String) settingsHashMap.get("notificationLargeIcon");
         }
 
+        if(settingsHashMap.containsKey("notificationIconColor")) {
+            settings.notificationIconColor = (String) settingsHashMap.get("notificationIconColor");
+        }
+
+        if (settingsHashMap.containsKey("addInAppMessageFromPushToInAppMessageList")) {
+            settings.addInAppMessageFromPushToInAppMessageList = (Boolean) settingsHashMap.get("addInAppMessageFromPushToInAppMessageList");
+        }
+
         if (settingsHashMap.containsKey("doNotFetchTheToken")) {
             settings.doNotFetchTheToken = (Boolean) settingsHashMap.get("doNotFetchTheToken");
         }

package/constants.d.ts

@@ -0,0 +1,103 @@
+export namespace ClearCacheIntervalValue {
+  const AUTO = 1;
+  const NONE = 2;
+  const DAY = 3;
+  const WEEK = 4;
+  const MONTH = 5;
+  const QUARTER = 6;
+}
+
+export namespace InAppMessageRefreshType {
+  const NONE = 10;
+  const MINUTE = 11;
+  const HOUR = 12;
+  const DAY = 13;
+}
+
+export namespace InAppMessageType {
+  const UNKNOWN: -2;
+  const HIDDEN: -1;
+  const ALERT: 0;
+  const HTML: 1;
+  const URL: 2;
+  const IMAGE: 3;
+  const MAP: 4;
+  const PASSBOOK: 5;
+}
+
+export namespace RemoteMessagesDisplayType {
+  const AUTOMATIC = 20;
+  const NONE = 21;
+  const NOTIFICATION = 22;
+}
+
+export namespace AndroidRemoteMessagesDisplayType {
+  const AUTOMATIC = 20;
+  const NONE = 21;
+  const NOTIFICATION = 22;
+}
+
+export namespace iOSLogLevel {
+  const NONE = 50;
+  const INFO = 51;
+  const WARNING = 52;
+  const ERROR = 53;
+  const HTTP_CALL = 54;
+  const LOCATION = 55;
+  const ALL = 56;
+}
+
+export namespace iOSBackgroundFetchResult {
+  const NEW_DATA = 60;
+  const NO_DATA = 61;
+  const FAILED = 62;
+}
+
+export namespace iOSLocationAuthorisationStatus {
+  const UNKNOWN = 70;
+  const REFUSED = 71;
+  const GRANTED_IN_USE = 72;
+  const GRANTED_ALWAYS = 73;
+}
+
+export namespace iOSLocationAuthorisationType {
+  const IN_USE = 80;
+  const ALWAYS = 81;
+}
+
+export namespace EventType {
+  const USER_REGISTER = 90;
+  const USER_UNREGISTER = 91;
+  const USER_LOGIN = 92;
+  const USER_LOGOUT = 93;
+  const CUSTOM = 94;
+}
+
+export namespace iOSNotificationButtonType {
+  const UNKNOWN = 100;
+  const SIMPLE_OPEN_PHONE_CALL = 101;
+  const OPEN_SMS = 102;
+  const OPEN_MAIL = 103;
+  const OPEN_BROWSER = 104;
+  const OPEN_APPLICATION = 105;
+  const RATE_APPLICATION = 106;
+  const CUSTOM_ACTION_BROADCAST_EVENT = 107;
+  const RETURN_TEXT = 108;
+  const RETURN_PHOTO = 109;
+  const RETURN_TEXT_AND_PHOTO = 110;
+  const PASSBOOK = 111;
+}
+
+export namespace BroadcastEventType {
+  const BUTTON_CLICKED = "ButtonClicked";
+  const RECEIVED_IN_APP_MESSAGE = "ReceivedInAppMessage";
+  const WILL_DISPLAY_NOTIFICATION = "WillDisplayNotification";
+  const WILL_DISMISS_NOTIFICATION = "WillDismissNotification";
+  const RECEIVED_GCM_TOKEN = "ReceivedGCMToken";
+  const RECEIVED_DEVICE_ID = "ReceivedDeviceId";
+  const RECEIVED_REMOTE_NOTIFICATION = "ReceivedRemoteNotification";
+}
+
+export namespace RemoteNotification {
+  const FETCHED_REMOTE_NOTIFICATION = "FetchedRemoteNotification";
+}

package/constants.js

@@ -1,4 +1,4 @@
-import {Platform} from 'react-native'
+import { Platform } from 'react-native'
 
 /**
  * @module SelligentConstants
@@ -32,6 +32,32 @@ var SelligentConstants = {
 		/** Refresh in-app messages daily */
 		DAY: 13,
 	},
+	/**
+	 * @description
+	 * Defines the in-app messages type.
+	 */
+	InAppMessageType: {
+		UNKNOWN: -2,
+		HIDDEN: -1,
+		ALERT: 0,
+		HTML: 1,
+		URL: 2,
+		IMAGE: 3,
+		MAP: 4,
+		PASSBOOK: 5,
+	},
+	/**
+	 * @description
+	 * Defines if and how remote messages can be displayed.
+	 */
+	RemoteMessagesDisplayType: {
+		/** Display remote messages automatically */
+		AUTOMATIC: 20,
+		/** Don't display remote messages */
+		NONE: 21,
+		/** Display remote messages as notification */
+		NOTIFICATION: 22
+	},
 	/**
 	 * @description
 	 * Defines if and how remote messages can be displayed on Android.
@@ -159,6 +185,8 @@ var SelligentConstants = {
 		WILL_DISPLAY_NOTIFICATION: "WillDisplayNotification",
 		/** A notification will be dismissed */
 		WILL_DISMISS_NOTIFICATION: "WillDismissNotification",
+		/** A device id has been received */
+		RECEIVED_DEVICE_ID: "ReceivedDeviceId"
 	},
 	/**
 	 * @description

package/index.android.js

@@ -10,6 +10,16 @@ export default {
 	// Basic SMManager
 
 	// InAppMessage
+
+	/**
+	 * Enable/disable in-app messages on Android.
+	 *
+	 * Android specific: if args is a boolean set to "true", the in-app messages will be enabled with a default refresh type "DAY".
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {(boolean|InAppMessageRefreshType)} options Boolean to enable/disable in-app messages or an enum InAppMessageRefreshType to enable and set which in-app messages should be enabled.
+	 */
 	enableInAppMessages: function (successCallback, errorCallback, enabled) {
 		if (!SelligentHelpers.typeMatches(enabled, 'number') && !SelligentHelpers.typeMatches(enabled, 'boolean')) {
 			errorCallback(SelligentHelpers.wrongArgumentError('Expected a boolean or a number.'))
@@ -20,9 +30,23 @@ export default {
 		RNSelligent.enableInAppMessages({ enabled })
 		return
 	},
+
+	/**
+	 * To check if in app messages are enabled on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 */
 	areInAppMessagesEnabled: function (successCallback) {
 		return RNSelligent.areInAppMessagesEnabled(successCallback)
 	},
+
+	/**
+	 * Display message on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {string} messageId Id of the message.
+	 */
 	displayMessage: function (successCallback, errorCallback, messageId) {
 		if (!SelligentHelpers.typeMatches(messageId, 'string')) {
 			errorCallback(SelligentHelpers.wrongArgumentError('Expected a string.'))
@@ -35,6 +59,13 @@ export default {
 	},
 
 	// Log
+	/**
+	 * Enable logging messages on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {boolean} shouldEnableLoggingMessages Boolean to enable/disable logging messages on Android.
+	 */
 	enableAndroidLogging: function (successCallback, errorCallback, enabled) {
 		if (!SelligentHelpers.typeMatches(enabled, 'boolean')) {
 			errorCallback(SelligentHelpers.wrongArgumentError('Expected a boolean.'))
@@ -46,10 +77,24 @@ export default {
 		return
 	},
 	// Remote Notification
+
+	/**
+	 * Check if notifications are enabled or disabled.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 */
 	areNotificationsEnabled: function (successCallback) {
 		RNSelligent.areNotificationsEnabled(successCallback)
 		return
 	},
+
+	/**
+	 * Set the resource for the small icon for notifications on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {string} iconName Name of the icon.
+	 */
 	setNotificationSmallIcon: function (successCallback, errorCallback, iconName) {
 		if (!SelligentHelpers.typeMatches(iconName, 'string') || iconName.length === 0) {
 			errorCallback(SelligentHelpers.wrongArgumentError('Expected a string (not empty).'))
@@ -60,6 +105,14 @@ export default {
 		RNSelligent.setNotificationSmallIcon(iconName)
 		return
 	},
+
+	/**
+	 * Set the resource for the large icon for notifications on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {string} iconName Name of the icon.
+	 */
 	setNotificationLargeIcon: function (successCallback, errorCallback, iconName) {
 		if (!SelligentHelpers.typeMatches(iconName, 'string') || iconName.length === 0) {
 			errorCallback(SelligentHelpers.wrongArgumentError('Expected a string (not empty).'))
@@ -70,15 +123,79 @@ export default {
 		RNSelligent.setNotificationLargeIcon(iconName)
 		return
 	},
+
+	/**
+	 * Set the color for the icon for notifications on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {string} color The color for the notification.
+	 */
+	setNotificationIconColor: function (successCallback, errorCallback, color) {
+		if (!SelligentHelpers.typeMatches(color, 'string') || color.length === 0) {
+			errorCallback(SelligentHelpers.wrongArgumentError('Expected a string (not empty).'))
+			return
+		}
+
+		const _successCallback = () => {
+			successCallback(SelligentHelpers.SUCCESS)
+		}
+
+		RNSelligent.setNotificationIconColor(color, _successCallback, errorCallback)
+		return
+	},
+
+	/**
+	 * Set the notification activity on Android.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {string} activityName The name of the activity.
+	 */
+	 setNotificationActivity: function (successCallback, errorCallback, activityName) {
+		if (!SelligentHelpers.typeMatches(activityName, 'string') || activityName.length === 0) {
+			errorCallback(SelligentHelpers.wrongArgumentError('Expected a string (not empty).'))
+			return
+		}
+
+		const _successCallback = () => {
+			successCallback(SelligentHelpers.SUCCESS)
+		}
+
+		RNSelligent.setNotificationActivity(activityName, _successCallback, errorCallback)
+		return
+	},
+
+	/**
+	 * Get GCM Token
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 */
 	getGCMToken: function (successCallback) {
 		RNSelligent.getGCMToken(successCallback)
 		return
 	},
+
+	/**
+	 * Get remote messages display type.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 */
 	getRemoteMessagesDisplayType: function (successCallback) {
 		RNSelligent.getRemoteMessagesDisplayType(successCallback)
 		return
 	},
 	// Broadcasts Events
+
+	/**
+	 * Subscribe to events.
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {function} eventCallback Callback function on event.
+	 * @param {array} customEvents Array of custom events to subscribe to.
+	 */
 	subscribeToEvents: function (successCallback, errorCallback, eventCallback, customEvents = []) {
 
 		if (customEvents !== undefined) {
@@ -107,10 +224,25 @@ export default {
 		RNSelligent.subscribeToEvents(customEvents)
 		return
 	},
+
+	/**
+	 * Subscribe to event.
+	 *
+	 * @param {function} eventCallback Callback function on event.
+	 * @param {string} eventName Name of the event to subscribe to.
+	 */
 	subscribeToEvent: function (eventCallback, eventName) {
 		RNSEventEmitter.addListener(eventName, eventCallback);
 		return
 	},
+
+	/**
+	 * Set the firebase (GCM) token
+	 *
+	 * @param {function} successCallback Callback function on success.
+	 * @param {function} errorCallback Callback function on error.
+	 * @param {string} token the firebase token.
+	 */
 	setFirebaseToken: function (successCallback, errorCallback, token) {
 		if (!SelligentHelpers.typeMatches(token, 'string') || token.length === 0) {
 			errorCallback(SelligentHelpers.wrongArgumentError('Expected a string (not empty).'))