@usions/sdk 2.14.0 → 2.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usions/sdk",
-  "version": "2.14.0",
+  "version": "2.16.0",
   "description": "Usion Mini App SDK for iframe games and services",
   "type": "module",
   "main": "src/modules/index.js",
@@ -60,4 +60,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/browser.js

@@ -69,7 +69,7 @@ var Usion = (function () {
    * Core Usion object with init, _post, _request
    */
   const core = {
-    version: '2.14.0', // injected from package.json at build
+    version: '2.16.0', // injected from package.json at build
     config: {},
     _initialized: false,
     _initCallback: null,
@@ -192,10 +192,56 @@ var Usion = (function () {
         }
       });
 
+      // Report the user's first real interaction to the host (see below).
+      this._setupInteractionBeacon();
+
       // Signal ready to parent
       this._post({ type: 'READY' });
     },
 
+    /**
+     * Tell the host the moment the user FIRST genuinely interacts with the
+     * mini-app — a tap, click, key press, or touch — and only once.
+     *
+     * The host uses this as the SOLE signal to surface the mini-app in the user's
+     * chat list — only after real engagement (opening alone, and automatic
+     * load-time SDK calls, never count). It works for a fully self-contained
+     * app/game that never calls any other SDK method: no `Usion.*` call is
+     * required for the host to know the user is engaged.
+     *
+     * Standalone (non-embedded) apps are unaffected — `_post` no-ops when there
+     * is no host. Note: input that produces no DOM gesture (pure device-motion,
+     * gamepad) won't trigger this until the first tap/click/key.
+     * @private
+     */
+    _setupInteractionBeacon: function() {
+      const self = this;
+      if (self._interactionBeaconSetup) return;
+      self._interactionBeaconSetup = true;
+      if (typeof window === 'undefined' || !window.addEventListener) return;
+
+      const events = ['pointerdown', 'mousedown', 'touchstart', 'keydown'];
+      function fire(event) {
+        // Only count real user gestures, never programmatically dispatched ones.
+        if (event && event.isTrusted === false) return;
+        if (self._interactionReported) return;
+        self._interactionReported = true;
+        for (let i = 0; i < events.length; i++) {
+          try { window.removeEventListener(events[i], fire, true); } catch (e) { /* noop */ }
+        }
+        self._post({ type: 'USER_INTERACTION' });
+      }
+      for (let i = 0; i < events.length; i++) {
+        // Capture phase + passive so we observe the gesture without interfering
+        // with the app's own handlers or scroll performance.
+        try {
+          window.addEventListener(events[i], fire, { capture: true, passive: true });
+        } catch (e) {
+          try { window.addEventListener(events[i], fire, true); } catch (e2) { /* noop */ }
+        }
+      }
+    },
+
     /**
      * Get the current theme ('light' or 'dark')
      * @returns {string}

package/src/modules/core.js

@@ -189,10 +189,56 @@ export const core = {
       }
     });
 
+    // Report the user's first real interaction to the host (see below).
+    this._setupInteractionBeacon();
+
     // Signal ready to parent
     this._post({ type: 'READY' });
   },
 
+  /**
+   * Tell the host the moment the user FIRST genuinely interacts with the
+   * mini-app — a tap, click, key press, or touch — and only once.
+   *
+   * The host uses this as the SOLE signal to surface the mini-app in the user's
+   * chat list — only after real engagement (opening alone, and automatic
+   * load-time SDK calls, never count). It works for a fully self-contained
+   * app/game that never calls any other SDK method: no `Usion.*` call is
+   * required for the host to know the user is engaged.
+   *
+   * Standalone (non-embedded) apps are unaffected — `_post` no-ops when there
+   * is no host. Note: input that produces no DOM gesture (pure device-motion,
+   * gamepad) won't trigger this until the first tap/click/key.
+   * @private
+   */
+  _setupInteractionBeacon: function() {
+    const self = this;
+    if (self._interactionBeaconSetup) return;
+    self._interactionBeaconSetup = true;
+    if (typeof window === 'undefined' || !window.addEventListener) return;
+
+    const events = ['pointerdown', 'mousedown', 'touchstart', 'keydown'];
+    function fire(event) {
+      // Only count real user gestures, never programmatically dispatched ones.
+      if (event && event.isTrusted === false) return;
+      if (self._interactionReported) return;
+      self._interactionReported = true;
+      for (let i = 0; i < events.length; i++) {
+        try { window.removeEventListener(events[i], fire, true); } catch (e) { /* noop */ }
+      }
+      self._post({ type: 'USER_INTERACTION' });
+    }
+    for (let i = 0; i < events.length; i++) {
+      // Capture phase + passive so we observe the gesture without interfering
+      // with the app's own handlers or scroll performance.
+      try {
+        window.addEventListener(events[i], fire, { capture: true, passive: true });
+      } catch (e) {
+        try { window.addEventListener(events[i], fire, true); } catch (e2) { /* noop */ }
+      }
+    }
+  },
+
   /**
    * Get the current theme ('light' or 'dark')
    * @returns {string}