despia-native 1.0.13 → 1.0.15

package/README.md

@@ -1,5 +1,9 @@
 # Despia SDK
 
+JavaScript SDK for [Despia](https://despia.com) - Add real native device features to your React web app, Vue app, Angular app, or any web framework. Transform your web app into a native iOS & Android app without writing Swift or Kotlin. This npm package provides command queuing and variable watching for seamless integration with Despia's GPU-accelerated native runtime, enabling access to 25+ device APIs through simple JavaScript calls.
+
+---
+
 ## Quick Start
 
 **Install the SDK:**
@@ -22,8 +26,6 @@ const appInfo = await despia('getappversion://', ['versionNumber']);
 
 ---
 
-JavaScript SDK for [Despia](https://despia.com) - Add native device features to your React web app, Vue app, Angular app, or any web framework. Transform your web app into a native iOS & Android app without writing Swift or Kotlin. This npm package provides command queuing and variable watching for seamless integration with Despia's GPU-accelerated native runtime, enabling access to 25+ device APIs through simple JavaScript calls.
-
 **Note: This is for web apps (React, Vue, Angular, etc.) to add native features - NOT for React Native apps.**
 
 ## Web Apps vs React Native
@@ -638,9 +640,17 @@ These CSS variables are automatically provided by the Despia native runtime and
 - **watch** (string[], optional): Array of variable names to watch for in the response
 
 Returns a Promise that resolves when all watched variables are available:
-- **Single variable**: 5-second timeout with simple observation
+- **Single variable**: 30-second timeout with simple observation (Promise always resolves; on timeout it resolves with `undefined`)
 - **Multiple variables**: Uses VariableTracker with 5-minute auto-cleanup
 
+### Timeout behavior
+
+When you call `despia(command, ['someVariable'])`, the SDK waits up to 30 seconds for
+`window.someVariable` to be set by the native runtime. If it appears earlier, the
+Promise resolves with that value. If it is never set, the Promise still resolves
+after 30 seconds with `undefined` and a timeout is logged to the console. This
+prevents hanging Promises for long-running or failing native operations.
+
 ### Direct Property Access
 
 Access any window variable directly through the despia object:

package/index.js

@@ -42,20 +42,29 @@
       }
     }
   
-    // Simple variable observer with 5-second timeout
-    function observeDespiaVariable(variableName, callback, timeout = 5000) {
+    // Simple variable observer with longer timeout and guaranteed resolve
+    function observeDespiaVariable(variableName, callback, timeout = 30000) {
         const startTime = Date.now();
-        
+
         function checkVariable() {
-            if (window[variableName] !== undefined) {
-                callback(window[variableName]);
-            } else if (Date.now() - startTime < timeout) {
+            const val = window[variableName];
+
+            // Preserve existing semantics: any non-undefined value is "ready"
+            if (val !== undefined) {
+                callback(val);
+                return;
+            }
+
+            if (Date.now() - startTime < timeout) {
                 setTimeout(checkVariable, 100);
-            } else {
-                console.error(`Despia timeout: ${variableName} was not set within ${timeout} ms`);
+                return;
             }
+
+            console.error(`Despia timeout: ${variableName} was not set within ${timeout} ms`);
+            // Ensure promises watching this variable never hang forever
+            callback(undefined);
         }
-        
+
         checkVariable();
     }
 
@@ -125,11 +134,11 @@
         }
 
         if (variables.length === 1) {
-            // Simple single variable observation with 5-second timeout
+            // Simple single variable observation with 30-second timeout
             return new Promise((resolve) => {
                 observeDespiaVariable(variables[0], (value) => {
                     resolve({ [variables[0]]: value });
-                }, 5000);
+                }, 30000);
             });
         } else {
             // Multiple variables - use VariableTracker (no timeout, expires after 5 minutes)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "despia-native",
-    "version": "1.0.13",
+    "version": "1.0.15",
     "description": "JavaScript SDK for Despia native integrations with command queuing and variable watching",
     "main": "index.js",
     "module": "index.js",