@1upvision/sdk 0.1.2 → 0.1.3

package/dist/hooks/useQuery.d.ts

@@ -6,9 +6,11 @@ export interface UseQueryResult<T = unknown> {
 }
 /**
  * Call a server query function by name and reactively return the result.
+ * Automatically opens a WebSocket subscription for live updates when the
+ * host supports it.
  *
  * ```tsx
- * const { data: players, isLoading, refetch } = useQuery("getPlayers");
+ * const { data: players, isLoading } = useQuery("getPlayers");
  * const { data: player } = useQuery("getPlayer", { userId: "alice" });
  * ```
  */

package/dist/hooks/useQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuery.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,cAAc,CAAC,CAAC,CAAC,CAiEnB"}
+{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuery.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,cAAc,CAAC,CAAC,CAAC,CAwFnB"}

package/dist/hooks/useQuery.js

@@ -1,9 +1,27 @@
 import { useState, useEffect, useCallback, useRef } from "react";
+let subscriptionCounter = 0;
+const subscriptionListeners = new Map();
+let bridgeListenersInstalled = false;
+function ensureBridgeListeners(bridge) {
+    if (bridgeListenersInstalled)
+        return;
+    bridgeListenersInstalled = true;
+    bridge.onNotification("server.subscription.update", (params) => {
+        const { subscriptionId, data } = params;
+        subscriptionListeners.get(subscriptionId)?.onUpdate(data);
+    });
+    bridge.onNotification("server.subscription.error", (params) => {
+        const { subscriptionId, error, message } = params;
+        subscriptionListeners.get(subscriptionId)?.onError(error, message);
+    });
+}
 /**
  * Call a server query function by name and reactively return the result.
+ * Automatically opens a WebSocket subscription for live updates when the
+ * host supports it.
  *
  * ```tsx
- * const { data: players, isLoading, refetch } = useQuery("getPlayers");
+ * const { data: players, isLoading } = useQuery("getPlayers");
  * const { data: player } = useQuery("getPlayer", { userId: "alice" });
  * ```
  */
@@ -35,6 +53,7 @@ export function useQuery(name, args) {
             }
         });
     }, [bridge, name, argsJson]);
+    // Initial fetch
     useEffect(() => {
         mountedRef.current = true;
         fetchData();
@@ -42,21 +61,43 @@ export function useQuery(name, args) {
             mountedRef.current = false;
         };
     }, [fetchData]);
-    // Listen for server-side invalidation pushed by the host after mutations
+    // Open a live WebSocket subscription for real-time updates
     useEffect(() => {
-        const handler = (detail) => {
-            const payload = detail;
-            if (!payload?.queryNames || payload.queryNames.includes(name)) {
-                fetchData();
-            }
-        };
-        globalThis.__visionQueryInvalidate = handler;
+        if (!bridge)
+            return;
+        ensureBridgeListeners(bridge);
+        const subId = `sub_${++subscriptionCounter}`;
+        const parsedArgs = argsJson ? JSON.parse(argsJson) : undefined;
+        // Register listener for this subscription's updates
+        subscriptionListeners.set(subId, {
+            onUpdate: (newData) => {
+                if (mountedRef.current) {
+                    setData(newData);
+                    setIsLoading(false);
+                }
+            },
+            onError: (_error, message) => {
+                if (mountedRef.current) {
+                    setError(new Error(message));
+                }
+            },
+        });
+        // Request the subscription (the host will push updates via notifications)
+        bridge
+            .request("server.subscribe", {
+            subscriptionId: subId,
+            name,
+            args: parsedArgs,
+        })
+            .catch(() => {
+            // Subscription not supported or failed — rely on initial fetch only
+        });
         return () => {
-            if (globalThis.__visionQueryInvalidate ===
-                handler) {
-                delete globalThis.__visionQueryInvalidate;
-            }
+            subscriptionListeners.delete(subId);
+            bridge
+                .request("server.unsubscribe", { subscriptionId: subId })
+                .catch(() => { });
         };
-    }, [fetchData, name]);
+    }, [bridge, name, argsJson]);
     return { data, isLoading, error, refetch: fetchData };
 }

package/dist/worker-runtime.js

@@ -9233,6 +9233,21 @@
 
   // src/hooks/useQuery.ts
   var import_react14 = __toESM(require_react(), 1);
+  var subscriptionCounter = 0;
+  var subscriptionListeners = /* @__PURE__ */ new Map();
+  var bridgeListenersInstalled = false;
+  function ensureBridgeListeners(bridge2) {
+    if (bridgeListenersInstalled) return;
+    bridgeListenersInstalled = true;
+    bridge2.onNotification("server.subscription.update", (params) => {
+      const { subscriptionId, data } = params;
+      subscriptionListeners.get(subscriptionId)?.onUpdate(data);
+    });
+    bridge2.onNotification("server.subscription.error", (params) => {
+      const { subscriptionId, error, message } = params;
+      subscriptionListeners.get(subscriptionId)?.onError(error, message);
+    });
+  }
   function useQuery(name, args) {
     const [data, setData] = (0, import_react14.useState)(void 0);
     const [isLoading, setIsLoading] = (0, import_react14.useState)(true);
@@ -9265,19 +9280,35 @@
       };
     }, [fetchData]);
     (0, import_react14.useEffect)(() => {
-      const handler = (detail) => {
-        const payload = detail;
-        if (!payload?.queryNames || payload.queryNames.includes(name)) {
-          fetchData();
+      if (!bridge2) return;
+      ensureBridgeListeners(bridge2);
+      const subId = `sub_${++subscriptionCounter}`;
+      const parsedArgs = argsJson ? JSON.parse(argsJson) : void 0;
+      subscriptionListeners.set(subId, {
+        onUpdate: (newData) => {
+          if (mountedRef.current) {
+            setData(newData);
+            setIsLoading(false);
+          }
+        },
+        onError: (_error, message) => {
+          if (mountedRef.current) {
+            setError(new Error(message));
+          }
         }
-      };
-      globalThis.__visionQueryInvalidate = handler;
+      });
+      bridge2.request("server.subscribe", {
+        subscriptionId: subId,
+        name,
+        args: parsedArgs
+      }).catch(() => {
+      });
       return () => {
-        if (globalThis.__visionQueryInvalidate === handler) {
-          delete globalThis.__visionQueryInvalidate;
-        }
+        subscriptionListeners.delete(subId);
+        bridge2.request("server.unsubscribe", { subscriptionId: subId }).catch(() => {
+        });
       };
-    }, [fetchData, name]);
+    }, [bridge2, name, argsJson]);
     return { data, isLoading, error, refetch: fetchData };
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1upvision/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Vision SDK for building extensions on the 1up.vision platform",
   "type": "module",
   "exports": {
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "react-reconciler": "^0.32.0",
-    "@1upvision/protocol": "0.1.1"
+    "@1upvision/protocol": "0.1.2"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"