despia-native 1.0.14 → 1.0.15

package/README.md

@@ -640,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.14",
+    "version": "1.0.15",
     "description": "JavaScript SDK for Despia native integrations with command queuing and variable watching",
     "main": "index.js",
     "module": "index.js",