cordova-plugin-reteno 2.0.3 → 2.0.4

package/README.md

@@ -18,7 +18,7 @@ npm install cordova-plugin-reteno
 - [Cordova iOS SDK Setup](https://docs.reteno.com/reference/cordova-ios-sdk-setup)
 - [Cordova Android SDK Setup](https://docs.reteno.com/reference/cordova-android-sdk-setup)
 - [Ionic iOS SDK Setup](https://docs.reteno.com/reference/ionic-ios-sdk-setup)
-- [Ionic Android SDK Setup](https://docs.reteno.com/reference/ionic-android-sdk-setup)
+- [Ionic Android SDK Setup](https://docs.reteno.com/reference/ionic-ios-sdk-android)
 
 ### Additional
 

package/docs/android.md

@@ -60,6 +60,24 @@ RetenoPlugin
   });
 ```
 
+For Android SDK `2.9.4+`, you can also configure session duration and split session lifecycle flags during init:
+
+```js
+RetenoPlugin.init({
+  // Optional: session reset duration
+  sessionDurationSeconds: 30 * 60,
+  lifecycleTrackingOptions: {
+    appLifecycleEnabled: true,
+    // ApplicationForgrounded/ApplicationBackgrounded events (disabled by default in 2.9.4)
+    foregroundLifecycleEnabled: false,
+    pushSubscriptionEnabled: true,
+    // SessionStart/SessionEnd can now be managed separately
+    sessionStartEventsEnabled: true,
+    sessionEndEventsEnabled: false,
+  },
+});
+```
+
 If you need advanced Reteno configuration (custom `RetenoConfig`, custom device id provider, etc), you can initialize Reteno in your custom `Application` as described here:
 [link](https://docs.reteno.com/reference/android-sdk-setup#step-4-initialize-the-reteno-sdk).
 
@@ -68,7 +86,7 @@ If you need advanced Reteno configuration (custom `RetenoConfig`, custom device
 
 ## Push notification listeners
 
-The plugin uses the listener-based API (`EventListener` / `Procedure`) for all push events.
+The plugin uses the listener-based API (`EventListener` / `Procedure`, Android SDK `2.9.4`) for all push events.
 
 - `setOnRetenoPushDismissedListener(listener)` — called when a push notification is dismissed (swiped away).
 - `setOnRetenoCustomPushReceivedListener(listener)` — called when a custom push notification is received.

package/docs/api.md

@@ -12,7 +12,7 @@ Notes:
 
 | Method | Supported platform | Description |
 | --- | --- | --- |
-| [init](../www/cordova-plugin-reteno.js) | iOS, Android | Initializes Reteno SDK. Accepts optional `RetenoInitializeOptions` with `accessKey`, `pauseInAppMessages`, `pausePushInAppMessages`, `inAppMessagesPauseBehaviour` (iOS), `lifecycleTrackingOptions`, `isAutomaticScreenReportingEnabled` (iOS; see note below) and `isDebugMode`. [Types](../types/index.ts) |
+| [init](../www/cordova-plugin-reteno.js) | iOS, Android | Initializes Reteno SDK. Accepts optional `RetenoInitializeOptions` with `accessKey`, `pauseInAppMessages`, `pausePushInAppMessages`, `inAppMessagesPauseBehaviour` (iOS), `lifecycleTrackingOptions`, `sessionDurationSeconds` (Android 2.9.4+, iOS 2.7.0+), `isAutomaticScreenReportingEnabled` (iOS; see note below) and `isDebugMode`. [Types](../types/index.ts) |
 | [requestNotificationPermission](../www/cordova-plugin-reteno.js) | iOS, Android | Requests push permission (iOS) or `POST_NOTIFICATIONS` (Android 13+). Returns `0` or `1` on Android (`RequestNotificationPermissionResult`) in [types](../types/index.ts). |
 | [setLifecycleTrackingOptions](../www/cordova-plugin-reteno.js) | iOS, Android | Configures automatic tracking for app lifecycle, push subscription, and session events. Android: applies immediately. iOS: supported only before initialization (stored and applied during `init(...)`). [Types](../types/index.ts) |
 
@@ -99,6 +99,7 @@ RetenoPlugin.init()
 // pausePushInAppMessages: pauses in-app messages triggered by push notifications.
 // inAppMessagesPauseBehaviour: (iOS) defines handling while paused: 'SKIP_IN_APPS' or 'POSTPONE_IN_APPS'.
 // lifecycleTrackingOptions: configures app lifecycle, push subscription, and session event tracking ('ALL', 'NONE', or an object).
+// sessionDurationSeconds (Android 2.9.4+, iOS 2.7.0+): optional session reset duration.
 // isAutomaticScreenReportingEnabled: enables automatic native screen view tracking on iOS.
 //   Keep this false in Cordova/Ionic WebView apps (including Android demos).
 //   Defaults to false. Note: in Cordova/Ionic apps the UI runs inside a single WebView,
@@ -115,10 +116,13 @@ RetenoPlugin.init({
   inAppMessagesPauseBehaviour: 'SKIP_IN_APPS', // iOS
   isAutomaticScreenReportingEnabled: false, // keep false for hybrid/WebView apps
   isDebugMode: true, // enables debug mode
+  sessionDurationSeconds: 30 * 60, // Android 2.9.4+, iOS 2.7.0+: 30 minutes
   lifecycleTrackingOptions: {
     appLifecycleEnabled: true,
+    foregroundLifecycleEnabled: false,
     pushSubscriptionEnabled: true,
-    sessionEventsEnabled: false,
+    sessionStartEventsEnabled: true,
+    sessionEndEventsEnabled: false, // Android 2.9.4 default
   },
 })
   .then(() => console.log('init: OK'))
@@ -129,6 +133,8 @@ RetenoPlugin.init({
 // Shorthand lifecycle tracking values:
 RetenoPlugin.init({ lifecycleTrackingOptions: 'ALL' });
 RetenoPlugin.init({ lifecycleTrackingOptions: 'NONE' });
+// Legacy alias (deprecated): sessionEventsEnabled controls both start/end at once.
+RetenoPlugin.init({ lifecycleTrackingOptions: { sessionEventsEnabled: false } });
 ```
 
 ### setUserAttributes payload example
@@ -236,9 +242,11 @@ RetenoPlugin.setMultiAccountUserAttributes(
 // Unspecified fields default to true.
 // Android: applies immediately.
 // iOS: this works only BEFORE SDK initialization (before calling init()).
+// Deprecated: sessionEventsEnabled (if used) toggles both sessionStart and sessionEnd.
 RetenoPlugin.setLifecycleTrackingOptions(
   {
-    sessionEventsEnabled: true,
+    sessionStartEventsEnabled: true,
+    sessionEndEventsEnabled: true,
   }
 )
   .then(() => console.log('setLifecycleTrackingOptions: OK'))
@@ -485,7 +493,7 @@ Subscribe to push received events while the app is running.
 
 Notes:
 
-- On Android this is based on the SDK 2.9.2 `EventListener` / `Procedure` API (`RetenoNotifications.getReceived()`).
+- On Android this is based on the SDK 2.9.4 `EventListener` / `Procedure` API (`RetenoNotifications.getReceived()`).
 - This listener is not a replacement for `getInitialNotification()` (cold start): if the app was launched by tapping a notification, use `getInitialNotification()`.
 
 ```js

package/docs/ios.md

@@ -68,12 +68,12 @@ target 'App' do
 
   target 'NotificationServiceExtension' do
     inherit! :search_paths
-    pod 'Reteno', '2.6.2'
+    pod 'Reteno', '2.7.0'
   end
 
   target 'NotificationContentExtension' do
     inherit! :search_paths
-    pod 'Reteno', '2.6.2'
+    pod 'Reteno', '2.7.0'
   end
 end
 ```
@@ -187,12 +187,12 @@ target 'App' do
 
   target 'NotificationServiceExtension' do
     inherit! :search_paths
-    pod 'Reteno', '2.6.2'
+    pod 'Reteno', '2.7.0'
   end
 
   target 'NotificationContentExtension' do
     inherit! :search_paths
-    pod 'Reteno', '2.6.2'
+    pod 'Reteno', '2.7.0'
   end
 end
 ```
@@ -458,12 +458,17 @@ Lifecycle tracking note for iOS:
 - iOS lifecycle tracking is configured during SDK initialization (`RetenoPlugin.init({ lifecycleTrackingOptions: ... })`).
 - Calling `setLifecycleTrackingOptions(...)` after initialization is not supported on iOS.
 - `lifecycleTrackingOptions` accepts:
-  - `'ALL'` -> enables app lifecycle, push subscription, and session event tracking.
-  - `'NONE'` -> disables app lifecycle, push subscription, and session event tracking.
+  - `'ALL'` -> enables app lifecycle, foreground lifecycle (`ApplicationOpened`/`ApplicationBackgrounded`), push subscription, and session start/end tracking.
+  - `'NONE'` -> disables these automatic events.
   - object:
     - `appLifecycleEnabled`
+    - `foregroundLifecycleEnabled`
     - `pushSubscriptionEnabled`
-    - `sessionEventsEnabled`
+    - `sessionStartEventsEnabled`
+    - `sessionEndEventsEnabled`
+    - `sessionEventsEnabled` (legacy alias; deprecated)
+- Session duration can be configured during `init(...)` via:
+  - `sessionDurationSeconds`
 
 ## App Lifecycle Events (iOS)
 
@@ -479,7 +484,8 @@ When automatic tracking is enabled, the native iOS SDK can report these events:
 Related automatic events controlled by the same init options:
 
 - Push subscription status events (`pushSubscriptionEnabled`)
-- Session events (`sessionEventsEnabled`)
+- Session events (`sessionStartEventsEnabled` / `sessionEndEventsEnabled`)
+- Foreground lifecycle events (`foregroundLifecycleEnabled`)
 
 Screen view tracking:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-reteno",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "The Reteno Cordova Plugin for Mobile Customer Engagement and Analytics solutions",
   "types": "./types/index.ts",
   "files": [

package/plugin.xml

@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='utf-8'?>
-<plugin id="cordova-plugin-reteno" version="2.0.3" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">
+<plugin id="cordova-plugin-reteno" version="2.0.4" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">
     <name>cordova-plugin-reteno</name>
     <engines>
         <engine name="cordova-android" version=">=12.0.0" />
@@ -58,7 +58,7 @@
 
   <podspec>
     <pods>
-      <pod name="Reteno" spec="2.6.2" />
+      <pod name="Reteno" spec="2.7.0" />
       <pod name="FirebaseMessaging" />
     </pods>
   </podspec>

package/src/android/app/build.gradle

@@ -1,6 +1,6 @@
 apply plugin: 'com.android.application'
 
-def retenoFcmVersion = '2.9.2'
+def retenoFcmVersion = '2.9.4'
 
 android {
     namespace 'com.reteno.plugin'
@@ -40,4 +40,4 @@ dependencies {
     testImplementation 'junit:junit:4.13.2'
     androidTestImplementation 'androidx.test.ext:junit:1.1.3'
     androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
-}
+}

package/src/android/app/src/main/java/com/reteno/plugin/RetenoPlugin.java

@@ -572,6 +572,13 @@ public class RetenoPlugin extends CordovaPlugin {
         }
       }
 
+      if (options != null && options.has("sessionDurationSeconds")) {
+        long sessionDurationSeconds = options.optLong("sessionDurationSeconds", -1L);
+        if (sessionDurationSeconds > 0L) {
+          builder.sessionDuration(sessionDurationSeconds * 1000L);
+        }
+      }
+
       // Ensure AndroidX Startup initializer has created the Reteno instance.
       // We intentionally do not short-circuit initialization just because getInstance() is non-null;
       // the SDK still needs to receive config (access key/debug/etc.).
@@ -601,7 +608,7 @@ public class RetenoPlugin extends CordovaPlugin {
   }
 
   /**
-   * Register notification event listeners using the SDK 2.9.2 EventListener API.
+   * Register notification event listeners using the SDK 2.9.4 EventListener API.
    * Each listener is a direct {@link Procedure} implementation — no reflection needed.
    */
   private void registerNotificationListeners() {
@@ -1145,10 +1152,10 @@ public class RetenoPlugin extends CordovaPlugin {
     if (value instanceof String) {
       String str = ((String) value).trim();
       if ("ALL".equalsIgnoreCase(str)) {
-        return new LifecycleTrackingOptions(true, true, true);
+        return new LifecycleTrackingOptions(true, true, true, true, true);
       }
       if ("NONE".equalsIgnoreCase(str)) {
-        return new LifecycleTrackingOptions(false, false, false);
+        return new LifecycleTrackingOptions(false, false, false, false, false);
       }
       return null;
     }
@@ -1158,13 +1165,34 @@ public class RetenoPlugin extends CordovaPlugin {
       boolean appLifecycleEnabled = payload.has("appLifecycleEnabled")
         ? payload.optBoolean("appLifecycleEnabled", true)
         : true;
+      boolean foregroundLifecycleEnabled = payload.has("foregroundLifecycleEnabled")
+        ? payload.optBoolean("foregroundLifecycleEnabled", false)
+        : false;
       boolean pushSubscriptionEnabled = payload.has("pushSubscriptionEnabled")
         ? payload.optBoolean("pushSubscriptionEnabled", true)
         : true;
-      boolean sessionEventsEnabled = payload.has("sessionEventsEnabled")
+
+      // Back-compat flag from <=2.9.2 plugin API.
+      boolean legacySessionEventsEnabled = payload.has("sessionEventsEnabled")
         ? payload.optBoolean("sessionEventsEnabled", true)
         : true;
-      return new LifecycleTrackingOptions(appLifecycleEnabled, pushSubscriptionEnabled, sessionEventsEnabled);
+
+      boolean sessionStartEventsEnabled = payload.has("sessionStartEventsEnabled")
+        ? payload.optBoolean("sessionStartEventsEnabled", legacySessionEventsEnabled)
+        : legacySessionEventsEnabled;
+
+      // SDK 2.9.4 default for session end is disabled unless explicitly enabled.
+      boolean sessionEndEventsEnabled = payload.has("sessionEndEventsEnabled")
+        ? payload.optBoolean("sessionEndEventsEnabled", false)
+        : (payload.has("sessionEventsEnabled") ? legacySessionEventsEnabled : false);
+
+      return new LifecycleTrackingOptions(
+        appLifecycleEnabled,
+        foregroundLifecycleEnabled,
+        pushSubscriptionEnabled,
+        sessionStartEventsEnabled,
+        sessionEndEventsEnabled
+      );
     }
 
     return null;

package/src/android/reteno.gradle

@@ -5,7 +5,7 @@ allprojects {
     }
 }
 
-def retenoFcmVersion = '2.9.2'
+def retenoFcmVersion = '2.9.4'
 
 def firebaseMessagingVersion = '23.1.0'
 

package/src/ios/RetenoPlugin.swift

@@ -69,13 +69,15 @@ class RetenoPlugin: CDVPlugin {
     let lifecycleOptionsInput = options["lifecycleTrackingOptions"]
     let lifecycleOptions: (
       appLifecycleEnabled: Bool,
+      foregroundLifecycleEnabled: Bool,
       pushSubscriptionEnabled: Bool,
-      sessionEventsEnabled: Bool
+      sessionStartEventsEnabled: Bool,
+      sessionEndEventsEnabled: Bool
     )?
     if let lifecycleOptionsInput, !(lifecycleOptionsInput is NSNull) {
       guard let parsedOptions = parseLifecycleTrackingOptions(lifecycleOptionsInput) else {
         sendError(
-          "Invalid argument: lifecycleTrackingOptions. Expected 'ALL', 'NONE', or { appLifecycleEnabled, pushSubscriptionEnabled, sessionEventsEnabled }.",
+          "Invalid argument: lifecycleTrackingOptions. Expected 'ALL', 'NONE', or { appLifecycleEnabled, foregroundLifecycleEnabled, pushSubscriptionEnabled, sessionStartEventsEnabled, sessionEndEventsEnabled }.",
           to: command
         )
         return
@@ -85,8 +87,21 @@ class RetenoPlugin: CDVPlugin {
       lifecycleOptions = nil
     }
     let lifecycleAppEnabled = lifecycleOptions?.appLifecycleEnabled ?? true
+    let lifecycleForegroundEnabled = lifecycleOptions?.foregroundLifecycleEnabled ?? false
     let lifecyclePushEnabled = lifecycleOptions?.pushSubscriptionEnabled ?? true
-    let lifecycleSessionEnabled = lifecycleOptions?.sessionEventsEnabled ?? true
+    let lifecycleSessionStartEnabled = lifecycleOptions?.sessionStartEventsEnabled ?? true
+    let lifecycleSessionEndEnabled = lifecycleOptions?.sessionEndEventsEnabled ?? false
+
+    let sessionDurationSeconds: TimeInterval = {
+      if let seconds = options["sessionDurationSeconds"] as? Double, seconds > 0 {
+        return seconds
+      }
+      if let seconds = options["sessionDurationSeconds"] as? Int, seconds > 0 {
+        return Double(seconds)
+      }
+      return RetenoSessionConfiguration.default.sessionDuration
+    }()
+
     let screenReportingEnabled = (options["isAutomaticScreenReportingEnabled"] as? Bool) ?? false
     let isDebugMode = (options["isDebugMode"] as? Bool) ?? false
 
@@ -101,8 +116,13 @@ class RetenoPlugin: CDVPlugin {
     let configuration = RetenoConfiguration(
       isAutomaticScreenReportingEnabled: screenReportingEnabled,
       isAutomaticAppLifecycleReportingEnabled: lifecycleAppEnabled,
+      isApplicationForegroundLifecycleReportingEnabled: lifecycleForegroundEnabled,
       isAutomaticPushSubsriptionReportingEnabled: lifecyclePushEnabled,
-      isAutomaticSessionReportingEnabled: lifecycleSessionEnabled,
+      sessionConfiguration: RetenoSessionConfiguration(
+        sessionDuration: sessionDurationSeconds,
+        isSessionStartReportingEnabled: lifecycleSessionStartEnabled,
+        isSessionEndReportingEnabled: lifecycleSessionEndEnabled
+      ),
       isPausedInAppMessages: pauseInAppMessages,
       inAppMessagesPauseBehaviour: inAppMessagesPauseBehaviour,
       isDebugMode: isDebugMode,
@@ -1359,24 +1379,30 @@ class RetenoPlugin: CDVPlugin {
 
   private func parseLifecycleTrackingOptions(_ value: Any?) -> (
     appLifecycleEnabled: Bool,
+    foregroundLifecycleEnabled: Bool,
     pushSubscriptionEnabled: Bool,
-    sessionEventsEnabled: Bool
+    sessionStartEventsEnabled: Bool,
+    sessionEndEventsEnabled: Bool
   )? {
     if let raw = stringValue(value) {
       if raw.caseInsensitiveCompare("ALL") == .orderedSame {
-        return (true, true, true)
+        return (true, true, true, true, true)
       }
       if raw.caseInsensitiveCompare("NONE") == .orderedSame {
-        return (false, false, false)
+        return (false, false, false, false, false)
       }
       return nil
     }
 
     guard let payload = dictionaryValue(value) else { return nil }
+    let legacySessionEventsEnabled = (payload["sessionEventsEnabled"] as? Bool) ?? true
     return (
       appLifecycleEnabled: (payload["appLifecycleEnabled"] as? Bool) ?? true,
+      foregroundLifecycleEnabled: (payload["foregroundLifecycleEnabled"] as? Bool) ?? false,
       pushSubscriptionEnabled: (payload["pushSubscriptionEnabled"] as? Bool) ?? true,
-      sessionEventsEnabled: (payload["sessionEventsEnabled"] as? Bool) ?? true
+      sessionStartEventsEnabled: (payload["sessionStartEventsEnabled"] as? Bool) ?? legacySessionEventsEnabled,
+      sessionEndEventsEnabled: (payload["sessionEndEventsEnabled"] as? Bool) ??
+        (payload.keys.contains("sessionEventsEnabled") ? legacySessionEventsEnabled : false)
     )
   }
 

package/types/index.ts

@@ -77,8 +77,13 @@ export type NotificationResponseHandlerOptions = {
 export type LifecycleTrackingOptions =
   | {
       appLifecycleEnabled?: boolean | null;
+      foregroundLifecycleEnabled?: boolean | null;
       pushSubscriptionEnabled?: boolean | null;
+      /** @deprecated Use sessionStartEventsEnabled/sessionEndEventsEnabled instead. */
+      /** Backward-compatible alias for setting both sessionStart/sessionEnd */
       sessionEventsEnabled?: boolean | null;
+      sessionStartEventsEnabled?: boolean | null;
+      sessionEndEventsEnabled?: boolean | null;
     }
   | 'ALL'
   | 'NONE'
@@ -92,6 +97,8 @@ export type RetenoInitializeOptions = {
   inAppMessagesPauseBehaviour?: InAppPauseBehaviour;
   isAutomaticScreenReportingEnabled?: boolean;
   lifecycleTrackingOptions?: LifecycleTrackingOptions;
+  /** Session reset duration in seconds (Android 2.9.4+, iOS 2.7.0+). */
+  sessionDurationSeconds?: number;
   /** Enables Reteno debug mode for near real-time event monitoring. Use only with test devices. */
   isDebugMode?: boolean;
 };

package/www/cordova-plugin-reteno.js

@@ -143,7 +143,15 @@ const RetenoPluginFunctions = {
           inAppMessagesPauseBehaviour?: 'SKIP_IN_APPS' | 'POSTPONE_IN_APPS',
           isAutomaticScreenReportingEnabled?: boolean,
           isDebugMode?: boolean,
-          lifecycleTrackingOptions?: { appLifecycleEnabled?: boolean, pushSubscriptionEnabled?: boolean, sessionEventsEnabled?: boolean }
+          sessionDurationSeconds?: number, // Android 2.9.4+, iOS 2.7.0+
+          lifecycleTrackingOptions?: {
+            appLifecycleEnabled?: boolean,
+            foregroundLifecycleEnabled?: boolean,
+            pushSubscriptionEnabled?: boolean,
+            sessionEventsEnabled?: boolean, // backward-compatible alias
+            sessionStartEventsEnabled?: boolean,
+            sessionEndEventsEnabled?: boolean
+          }
         }
     */
     init: function (arg0, success, error) {