@usions/sdk 2.20.0 → 2.20.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usions/sdk",
-  "version": "2.20.0",
+  "version": "2.20.1",
   "description": "Usion Mini App SDK for iframe games and services",
   "type": "module",
   "main": "src/modules/index.js",

package/src/browser.js

@@ -69,7 +69,7 @@ var Usion = (function () {
    * Core Usion object with init, _post, _request
    */
   const core = {
-    version: '2.20.0', // injected from package.json at build
+    version: '2.20.1', // injected from package.json at build
     config: {},
     _initialized: false,
     _initCallback: null,
@@ -4851,6 +4851,24 @@ var Usion = (function () {
     applyGameMethods(game, Usion);
     applyGameNetcode(game, Usion);
 
+    // Foreground catch-up safety net (generic across every transport).
+    //
+    // When a page/iframe is backgrounded its JS is suspended: timers freeze and
+    // relayed actions can be missed (postMessage to a frozen WebView). A brief
+    // app-switch may also never trip a socket disconnect/reconnect, so the game's
+    // onReconnect handler never fires and it silently misses moves made while it
+    // was away — leaving turn state behind and the table deadlocked. On every
+    // return to visibility, if we're in a room, request a sync so the game
+    // deterministically catches up. Per the action reliability contract, onSync
+    // is deduped by sequence, so an unnecessary resync is a no-op.
+    if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
+      document.addEventListener('visibilitychange', function() {
+        if (document.visibilityState !== 'visible') return;
+        if (!game.roomId) return;
+        try { game.requestSync(); } catch (e) { /* non-fatal */ }
+      });
+    }
+
     return game;
   }
 

package/src/modules/game-core.js

@@ -242,5 +242,23 @@ export function createGameModule(Usion) {
   applyGameMethods(game, Usion);
   applyGameNetcode(game, Usion);
 
+  // Foreground catch-up safety net (generic across every transport).
+  //
+  // When a page/iframe is backgrounded its JS is suspended: timers freeze and
+  // relayed actions can be missed (postMessage to a frozen WebView). A brief
+  // app-switch may also never trip a socket disconnect/reconnect, so the game's
+  // onReconnect handler never fires and it silently misses moves made while it
+  // was away — leaving turn state behind and the table deadlocked. On every
+  // return to visibility, if we're in a room, request a sync so the game
+  // deterministically catches up. Per the action reliability contract, onSync
+  // is deduped by sequence, so an unnecessary resync is a no-op.
+  if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
+    document.addEventListener('visibilitychange', function() {
+      if (document.visibilityState !== 'visible') return;
+      if (!game.roomId) return;
+      try { game.requestSync(); } catch (e) { /* non-fatal */ }
+    });
+  }
+
   return game;
 }