senza-sdk 4.4.4-86e7d7a.0 → 4.4.5

package/src/interface/lifecycle.js

@@ -13,6 +13,23 @@ import {
  * });
  */
 
+/**
+ * @event Lifecycle#beforestatechange
+ * @description Fired before transitioning to a new state. This event is cancelable.<br>
+ * Currently only fired when transitioning to BACKGROUND state (e.g., from autoBackground feature).<br>
+ * The actual state transition will occur after all event listeners have completed processing.
+ * Can be used to prevent automatic transitions to background state when using autoBackground feature.
+ * @property {UiState} state - Indicates the target state the lifecycle is trying to transition to.
+ * @property {boolean} cancelable - true, indicating the event can be cancelled using preventDefault()
+ * @example
+ * lifecycle.addEventListener("beforestatechange", (e) => {
+ *     if (e.state === lifecycle.UiState.BACKGROUND && userIsInteracting) {
+ *         // Prevent transition to background
+ *         e.preventDefault();
+ *     }
+ * });
+ */
+
 /**
  * @event Lifecycle#userinactivity
  * @description Fired after the ui has been inactive (i.e. no key presses) for a configurable number of seconds.<br>
@@ -265,7 +282,7 @@ class Lifecycle extends EventTarget {
     /**
      * Add event listener for lifecycle events
      * @param {string} type - The event type to listen for
-     * @param {Function} listener - The callback function. Listeners for 'userdisconnected' events should return a promise to ensure the event is processed before the application exits.
+     * @param {Function} listener - The callback function. Listeners for 'userdisconnected' and 'beforestatechange' events should return a promise to ensure the event is processed before the application exits.
      * @param {Object} options - Event listener options
      */
     addEventListener(type, listener, options) {

package/src/interface/version.js

@@ -1 +1 @@
-export const version = "4.4.4-86e7d7a.0";
+export const version = "4.4.5";