@modelnex/sdk 0.5.7 → 0.5.9

package/dist/index.d.mts

@@ -315,7 +315,8 @@ interface TagData {
 interface TagStore {
     tags: Map<string, TagData>;
     getTag: (fingerprint: string) => TagData | undefined;
-    setTag: (fingerprint: string, description: string, category?: TagData['category'], metadata?: Record<string, unknown>, selector?: string, patternId?: string, behavior?: string, sourcePage?: string, displayContext?: string) => void;
+    setTag: (fingerprint: string, description: string, category?: TagData['category'], metadata?: Record<string, unknown>, selector?: string, patternId?: string, behavior?: string, sourcePage?: string, displayContext?: string, skipRemoteSync?: boolean) => void;
+    setTagsBatch: (tags: TagData[], skipRemoteSync?: boolean) => void;
     deleteTag: (fingerprint: string) => void;
     getAllTags: () => TagData[];
     /** Export all tags as a JSON string (for debugging / backup) */

package/dist/index.d.ts

@@ -315,7 +315,8 @@ interface TagData {
 interface TagStore {
     tags: Map<string, TagData>;
     getTag: (fingerprint: string) => TagData | undefined;
-    setTag: (fingerprint: string, description: string, category?: TagData['category'], metadata?: Record<string, unknown>, selector?: string, patternId?: string, behavior?: string, sourcePage?: string, displayContext?: string) => void;
+    setTag: (fingerprint: string, description: string, category?: TagData['category'], metadata?: Record<string, unknown>, selector?: string, patternId?: string, behavior?: string, sourcePage?: string, displayContext?: string, skipRemoteSync?: boolean) => void;
+    setTagsBatch: (tags: TagData[], skipRemoteSync?: boolean) => void;
     deleteTag: (fingerprint: string) => void;
     getAllTags: () => TagData[];
     /** Export all tags as a JSON string (for debugging / backup) */

package/dist/index.js

@@ -222,6 +222,18 @@ var ModelNexContext = (0, import_react.createContext)(null);
 var import_react3 = require("react");
 var import_socket = require("socket.io-client");
 
+// src/utils/socket-io-transports.ts
+function resolveSocketIoTransports(serverUrl, order) {
+  try {
+    const host = new URL(serverUrl).hostname.toLowerCase();
+    if (host.endsWith("awsapprunner.com")) {
+      return ["polling"];
+    }
+  } catch {
+  }
+  return order === "websocket-first" ? ["websocket", "polling"] : ["polling", "websocket"];
+}
+
 // src/auto-extract.ts
 var import_react2 = require("react");
 function simpleHash(str) {
@@ -839,7 +851,10 @@ function useModelNexSocket({
       onSocketId?.(null);
       return;
     }
-    const socket = (0, import_socket.io)(serverUrl);
+    const socket = (0, import_socket.io)(serverUrl, {
+      path: "/socket.io",
+      transports: resolveSocketIoTransports(serverUrl, "polling-first")
+    });
     socketRef.current = socket;
     const buildSyncPayload = () => ({
       actions: serializeActions(actionsRef.current),
@@ -1272,7 +1287,7 @@ function useTagStore(options) {
   const getTag = (0, import_react6.useCallback)((fingerprint) => {
     return tags.get(fingerprint);
   }, [tags]);
-  const setTag = (0, import_react6.useCallback)((fingerprint, description, category, metadata, selector, patternId, behavior, sourcePage, displayContext) => {
+  const setTag = (0, import_react6.useCallback)((fingerprint, description, category, metadata, selector, patternId, behavior, sourcePage, displayContext, skipRemoteSync) => {
     setTags((prev) => {
       const next = new Map(prev);
       const key = selector ? `selector:${selector}` : fingerprint;
@@ -1292,7 +1307,7 @@ function useTagStore(options) {
         updatedAt: now
       };
       next.set(key, tagObj);
-      if (apiUrl) {
+      if (apiUrl && !skipRemoteSync) {
         const payload = { tags: [tagObj] };
         if (websiteId) payload.websiteId = websiteId;
         fetch(apiUrl, {
@@ -1304,6 +1319,34 @@ function useTagStore(options) {
       return next;
     });
   }, [apiUrl, websiteId]);
+  const setTagsBatch = (0, import_react6.useCallback)((newTags, skipRemoteSync) => {
+    setTags((prev) => {
+      const next = new Map(prev);
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const updatedTags = [];
+      for (const t of newTags) {
+        const key = t.selector ? `selector:${t.selector}` : t.fingerprint;
+        const existing = prev.get(key);
+        const tagObj = {
+          ...t,
+          createdAt: existing?.createdAt ?? t.createdAt ?? now,
+          updatedAt: now
+        };
+        next.set(key, tagObj);
+        updatedTags.push(tagObj);
+      }
+      if (apiUrl && !skipRemoteSync && updatedTags.length > 0) {
+        const payload = { tags: updatedTags };
+        if (websiteId) payload.websiteId = websiteId;
+        fetch(apiUrl, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload)
+        }).catch((err) => console.warn("[ModelNex] Failed to save remote tags batch:", err));
+      }
+      return next;
+    });
+  }, [apiUrl, websiteId]);
   const deleteTag = (0, import_react6.useCallback)((fingerprint) => {
     setTags((prev) => {
       const next = new Map(prev);
@@ -1333,7 +1376,7 @@ function useTagStore(options) {
       console.warn("[ModelNex] Failed to import tags:", err);
     }
   }, []);
-  return { tags, getTag, setTag, deleteTag, getAllTags, exportTags, importTags };
+  return { tags, getTag, setTag, setTagsBatch, deleteTag, getAllTags, exportTags, importTags };
 }
 
 // src/studio-mode.tsx
@@ -3152,7 +3195,7 @@ function useTourPlayback({
       const socket = io2(serverUrl, {
         path: "/socket.io",
         // standard
-        transports: ["websocket", "polling"]
+        transports: resolveSocketIoTransports(serverUrl, "websocket-first")
       });
       socketRef.current = socket;
       socket.on("connect", () => {
@@ -5407,7 +5450,7 @@ function useVoice(serverUrl) {
           mediaRecorderRef.current = recorder;
           const socket = io2(serverUrl, {
             path: "/socket.io",
-            transports: ["websocket", "polling"]
+            transports: resolveSocketIoTransports(serverUrl, "websocket-first")
           });
           sttSocketRef.current = socket;
           recorder.ondataavailable = (e) => {
@@ -8480,21 +8523,7 @@ function ModelNexChatBubble({
       });
       const data = await resp.json();
       if (data.success && Array.isArray(data.tags)) {
-        for (const tag of data.tags) {
-          if (tag.patternId && tag.description && tag.selector) {
-            tagStore.setTag(
-              "",
-              tag.description,
-              tag.category || "other",
-              { matchedFingerprints: tag.matchedFingerprints },
-              tag.selector,
-              tag.patternId,
-              tag.behavior || void 0,
-              tag.sourcePage || void 0,
-              tag.displayContext || void 0
-            );
-          }
-        }
+        tagStore.setTagsBatch(data.tags, true);
         lastAutoTaggedUrlRef.current = currentUrl;
         localStorage.setItem(storageKey, "true");
         console.log(`[ModelNex] Auto-tagged ${data.tags.length} elements for ${currentUrl}`);

package/dist/index.mjs

@@ -13,6 +13,18 @@ var ModelNexContext = createContext(null);
 import { useEffect as useEffect3, useRef as useRef3 } from "react";
 import { io } from "socket.io-client";
 
+// src/utils/socket-io-transports.ts
+function resolveSocketIoTransports(serverUrl, order) {
+  try {
+    const host = new URL(serverUrl).hostname.toLowerCase();
+    if (host.endsWith("awsapprunner.com")) {
+      return ["polling"];
+    }
+  } catch {
+  }
+  return order === "websocket-first" ? ["websocket", "polling"] : ["polling", "websocket"];
+}
+
 // src/auto-extract.ts
 import { useState, useEffect as useEffect2, useRef as useRef2, useCallback as useCallback2 } from "react";
 function simpleHash(str) {
@@ -630,7 +642,10 @@ function useModelNexSocket({
       onSocketId?.(null);
       return;
     }
-    const socket = io(serverUrl);
+    const socket = io(serverUrl, {
+      path: "/socket.io",
+      transports: resolveSocketIoTransports(serverUrl, "polling-first")
+    });
     socketRef.current = socket;
     const buildSyncPayload = () => ({
       actions: serializeActions(actionsRef.current),
@@ -1063,7 +1078,7 @@ function useTagStore(options) {
   const getTag = useCallback3((fingerprint) => {
     return tags.get(fingerprint);
   }, [tags]);
-  const setTag = useCallback3((fingerprint, description, category, metadata, selector, patternId, behavior, sourcePage, displayContext) => {
+  const setTag = useCallback3((fingerprint, description, category, metadata, selector, patternId, behavior, sourcePage, displayContext, skipRemoteSync) => {
     setTags((prev) => {
       const next = new Map(prev);
       const key = selector ? `selector:${selector}` : fingerprint;
@@ -1083,7 +1098,7 @@ function useTagStore(options) {
         updatedAt: now
       };
       next.set(key, tagObj);
-      if (apiUrl) {
+      if (apiUrl && !skipRemoteSync) {
         const payload = { tags: [tagObj] };
         if (websiteId) payload.websiteId = websiteId;
         fetch(apiUrl, {
@@ -1095,6 +1110,34 @@ function useTagStore(options) {
       return next;
     });
   }, [apiUrl, websiteId]);
+  const setTagsBatch = useCallback3((newTags, skipRemoteSync) => {
+    setTags((prev) => {
+      const next = new Map(prev);
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const updatedTags = [];
+      for (const t of newTags) {
+        const key = t.selector ? `selector:${t.selector}` : t.fingerprint;
+        const existing = prev.get(key);
+        const tagObj = {
+          ...t,
+          createdAt: existing?.createdAt ?? t.createdAt ?? now,
+          updatedAt: now
+        };
+        next.set(key, tagObj);
+        updatedTags.push(tagObj);
+      }
+      if (apiUrl && !skipRemoteSync && updatedTags.length > 0) {
+        const payload = { tags: updatedTags };
+        if (websiteId) payload.websiteId = websiteId;
+        fetch(apiUrl, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload)
+        }).catch((err) => console.warn("[ModelNex] Failed to save remote tags batch:", err));
+      }
+      return next;
+    });
+  }, [apiUrl, websiteId]);
   const deleteTag = useCallback3((fingerprint) => {
     setTags((prev) => {
       const next = new Map(prev);
@@ -1124,7 +1167,7 @@ function useTagStore(options) {
       console.warn("[ModelNex] Failed to import tags:", err);
     }
   }, []);
-  return { tags, getTag, setTag, deleteTag, getAllTags, exportTags, importTags };
+  return { tags, getTag, setTag, setTagsBatch, deleteTag, getAllTags, exportTags, importTags };
 }
 
 // src/studio-mode.tsx
@@ -2943,7 +2986,7 @@ function useTourPlayback({
       const socket = io2(serverUrl, {
         path: "/socket.io",
         // standard
-        transports: ["websocket", "polling"]
+        transports: resolveSocketIoTransports(serverUrl, "websocket-first")
       });
       socketRef.current = socket;
       socket.on("connect", () => {
@@ -5198,7 +5241,7 @@ function useVoice(serverUrl) {
           mediaRecorderRef.current = recorder;
           const socket = io2(serverUrl, {
             path: "/socket.io",
-            transports: ["websocket", "polling"]
+            transports: resolveSocketIoTransports(serverUrl, "websocket-first")
           });
           sttSocketRef.current = socket;
           recorder.ondataavailable = (e) => {
@@ -8270,21 +8313,7 @@ function ModelNexChatBubble({
       });
       const data = await resp.json();
       if (data.success && Array.isArray(data.tags)) {
-        for (const tag of data.tags) {
-          if (tag.patternId && tag.description && tag.selector) {
-            tagStore.setTag(
-              "",
-              tag.description,
-              tag.category || "other",
-              { matchedFingerprints: tag.matchedFingerprints },
-              tag.selector,
-              tag.patternId,
-              tag.behavior || void 0,
-              tag.sourcePage || void 0,
-              tag.displayContext || void 0
-            );
-          }
-        }
+        tagStore.setTagsBatch(data.tags, true);
         lastAutoTaggedUrlRef.current = currentUrl;
         localStorage.setItem(storageKey, "true");
         console.log(`[ModelNex] Auto-tagged ${data.tags.length} elements for ${currentUrl}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelnex/sdk",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "React SDK for natural language control of web apps via AI agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",