despia-native 1.0.1 → 1.0.3

package/README.md

@@ -17,7 +17,7 @@ Despia provides native device capabilities to web applications through a simple
 ## Installation
 
 ```bash
-npm install despia
+npm install despia-native
 ```
 
 ## Usage
@@ -25,7 +25,7 @@ npm install despia
 ### Basic Despia Command Execution
 
 ```javascript
-import despia from 'despia';
+import despia from 'despia-native';
 
 // Execute a Despia protocol command (no response needed)
 despia('lighthaptic://');
@@ -403,7 +403,7 @@ Your app can access these native features:
 Full TypeScript definitions are included:
 
 ```typescript
-import despia from 'despia';
+import despia from 'despia-native';
 
 // Type-safe usage with Despia commands
 const result: { versionNumber: string; bundleNumber: string } = await despia(
@@ -419,11 +419,24 @@ const deviceInfo: any = despia.deviceInfo;
 
 This SDK is designed to work with [Despia's native integration system](https://docs.despia.com/docs/native-integrations/getting-started). The SDK provides:
 
-- **Command Queuing** - Sequential execution of Despia commands
+- **Command Queuing** - Sequential execution of Despia commands via `window.despia` setter
 - **Variable Watching** - Async monitoring of response variables
-- **Timeout Handling** - Configurable timeouts for long-running operations
+- **iOS Web View Compatible** - Works with Despia's iOS web view wrapper
 - **Direct Access** - Proxy-based access to window variables
 
+### How It Works
+
+The SDK uses the setter pattern to execute commands:
+```javascript
+// When you call:
+despia('lighthaptic://');
+
+// It internally executes:
+window.despia = 'lighthaptic://';
+```
+
+This triggers the iOS web view wrapper's setter function to handle the native command.
+
 ## License
 
 MIT

package/index.d.ts

@@ -103,7 +103,7 @@ interface DespiaFunction {
  * 
  * @example
  * ```typescript
- * import despia from 'despia';
+ * import despia from 'despia-native';
  * 
  * // Execute Despia protocol commands
  * await despia('applinks://open?url=https://maps.apple.com');

package/index.js

@@ -19,11 +19,14 @@
       if (processing || commandQueue.length === 0) return;
       
       processing = true;
-      const { command, native } = commandQueue.shift();
+      const { command } = commandQueue.shift();
       
       try {
-        native({ command });
-      } catch (e) {}
+        // Use the setter pattern: window.despia = command
+        window.despia = command;
+      } catch (e) {
+        console.error('Despia command failed:', e);
+      }
       
       setTimeout(() => {
         processing = false;
@@ -33,12 +36,8 @@
   
     // Add command to queue
     function queueCommand(command) {
-      const native = typeof window !== 'undefined' 
-        ? window.despia 
-        : (typeof global !== 'undefined' ? global.despia : null);
-      
-      if (native) {
-        commandQueue.push({ command, native });
+      if (typeof window !== 'undefined') {
+        commandQueue.push({ command });
         processQueue();
       }
     }

package/package.json

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