@modelnex/sdk 0.5.14 → 0.5.15

package/dist/index.d.mts

@@ -228,7 +228,7 @@ interface RecordingStep {
 }
 
 /** Default ModelNex server when `serverUrl` is omitted or React context is unavailable. */
-declare const DEFAULT_MODELNEX_SERVER_URL = "https://modelnex-server-production.up.railway.app";
+declare const DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
 
 /**
  * Automatic DOM element extraction with stable fingerprinting.
@@ -822,7 +822,7 @@ declare function clearActiveDraftPreview(experienceType?: ExperienceType): void;
 interface ModelNexProviderProps {
     children?: unknown;
     /**
-     * ModelNex Server URL (e.g. https://xxx.up.railway.app).
+     * ModelNex Server URL (e.g. https://api.modelnex.com).
      * When omitted, {@link DEFAULT_MODELNEX_SERVER_URL} is used.
      */
     serverUrl?: string;

package/dist/index.d.ts

@@ -228,7 +228,7 @@ interface RecordingStep {
 }
 
 /** Default ModelNex server when `serverUrl` is omitted or React context is unavailable. */
-declare const DEFAULT_MODELNEX_SERVER_URL = "https://modelnex-server-production.up.railway.app";
+declare const DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
 
 /**
  * Automatic DOM element extraction with stable fingerprinting.
@@ -822,7 +822,7 @@ declare function clearActiveDraftPreview(experienceType?: ExperienceType): void;
 interface ModelNexProviderProps {
     children?: unknown;
     /**
-     * ModelNex Server URL (e.g. https://xxx.up.railway.app).
+     * ModelNex Server URL (e.g. https://api.modelnex.com).
      * When omitted, {@link DEFAULT_MODELNEX_SERVER_URL} is used.
      */
     serverUrl?: string;

package/dist/index.js

@@ -2324,7 +2324,7 @@ function useBuiltinActions(registerAction, unregisterAction, tagStore, serverUrl
 }
 
 // src/constants.ts
-var DEFAULT_MODELNEX_SERVER_URL = "https://modelnex-server-production.up.railway.app";
+var DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
 
 // src/hooks/useRunCommand.ts
 var import_react9 = require("react");
@@ -3154,6 +3154,12 @@ function useTourPlayback({
   const [serverState, setServerState] = (0, import_react12.useState)(null);
   const ctx = (0, import_react12.useContext)(ModelNexContext);
   const devMode = ctx?.devMode;
+  const devModeRef = (0, import_react12.useRef)(devMode);
+  devModeRef.current = devMode;
+  const userProfileRef = (0, import_react12.useRef)(userProfile);
+  userProfileRef.current = userProfile;
+  const experienceTypeRef = (0, import_react12.useRef)(experienceType);
+  experienceTypeRef.current = experienceType;
   const tourRef = (0, import_react12.useRef)(null);
   const stepIndexRef = (0, import_react12.useRef)(0);
   const skipRequestedRef = (0, import_react12.useRef)(false);
@@ -3193,18 +3199,27 @@ function useTourPlayback({
   (0, import_react12.useEffect)(() => {
     if (disabled) return;
     if (typeof window === "undefined") return;
+    let cancelled = false;
+    let createdSocket = null;
     import("socket.io-client").then((ioModule) => {
+      if (cancelled) return;
       const io2 = ioModule.default || ioModule;
       const socket = io2(serverUrl, {
         path: "/socket.io",
         // standard
         transports: resolveSocketIoTransports(serverUrl, "polling-first")
       });
+      if (cancelled) {
+        socket.disconnect();
+        return;
+      }
+      createdSocket = socket;
       socketRef.current = socket;
       socket.on("connect", () => {
         console.log("[TourClient] Connected to tour agent server:", socket.id);
-        if (websiteId && userProfile) {
-          socket.emit("tour:init", { websiteId, userId: userProfile.userId, userType: userProfile.type });
+        const profile = userProfileRef.current;
+        if (websiteId && profile?.userId) {
+          socket.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
         }
       });
       socket.on("tour:server_state", (payload) => {
@@ -3229,6 +3244,11 @@ function useTourPlayback({
         }
       });
       socket.on("tour:command", async (payload) => {
+        const emitIfOpen = (ev, data) => {
+          if (socketRef.current !== socket) return;
+          if (!socket.connected) return;
+          socket.emit(ev, data);
+        };
         console.log("[TourClient] Received command batch:", payload.stepIndex, payload.commands);
         runCleanup(pendingManualWaitCleanupRef.current);
         pendingManualWaitCleanupRef.current = null;
@@ -3287,7 +3307,7 @@ function useTourPlayback({
         if (!payload.commands || !Array.isArray(payload.commands)) {
           console.warn("[TourClient] Payload commands is not an array:", payload);
           commandInFlightRef.current = false;
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "invalid_commands",
             commandBatchId,
@@ -3566,7 +3586,7 @@ function useTourPlayback({
                 currentStepOrder: stepIndexRef.current
               });
             }
-            socket.emit("tour:action_result", {
+            emitIfOpen("tour:action_result", {
               success: true,
               interrupted: true,
               results,
@@ -3591,7 +3611,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "execution_error",
             error: String(err),
@@ -3660,7 +3680,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: true,
             waitingForInput: true,
             results,
@@ -3693,7 +3713,7 @@ function useTourPlayback({
             const { waitForDomSettle: waitForDomSettle2 } = await Promise.resolve().then(() => (init_dom_sync(), dom_sync_exports));
             await waitForDomSettle2({ timeoutMs: 1500, debounceMs: 200 });
             await syncAOM();
-            socket.emit("tour:user_input", {
+            emitIfOpen("tour:user_input", {
               transcript,
               runId: runIdRef.current,
               turnId: turnIdRef.current
@@ -3712,7 +3732,7 @@ function useTourPlayback({
             currentStepOrder: stepIndexRef.current
           });
         }
-        socket.emit("tour:action_result", {
+        emitIfOpen("tour:action_result", {
           success: true,
           results,
           commandBatchId,
@@ -3725,8 +3745,9 @@ function useTourPlayback({
         if (isActiveRef.current) return;
         runIdRef.current = typeof tourData.runId === "number" ? tourData.runId : runIdRef.current;
         const tour = tourData.tourContext ?? tourRef.current;
-        if (tour?.type && tour.type !== experienceType) {
-          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${experienceType})`);
+        const expType = experienceTypeRef.current;
+        if (tour?.type && tour.type !== expType) {
+          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${expType})`);
           return;
         }
         skipRequestedRef.current = false;
@@ -3753,11 +3774,13 @@ function useTourPlayback({
         try {
           const { generateMinifiedAOM: generateMinifiedAOM2 } = await Promise.resolve().then(() => (init_aom(), aom_exports));
           const aom = generateMinifiedAOM2();
-          socket.emit("tour:sync_dom", {
-            url: window.location.pathname + window.location.search + window.location.hash,
-            aom: aom.nodes,
-            domSummary: captureDomSummary()
-          });
+          if (socketRef.current === socket && socket.connected) {
+            socket.emit("tour:sync_dom", {
+              url: window.location.pathname + window.location.search + window.location.hash,
+              aom: aom.nodes,
+              domSummary: captureDomSummary()
+            });
+          }
         } catch (e) {
           console.warn("[TourClient] Initial DOM sync failed:", e);
         }
@@ -3785,7 +3808,7 @@ function useTourPlayback({
         handleTourEnd();
       });
       socket.on("tour:debug_log", (entry) => {
-        const isDev = devMode || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
+        const isDev = devModeRef.current || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
         if (isDev) {
           console.log(`%c[ModelNex Tour] ${entry.type}`, "color: #3b82f6; font-weight: bold", entry);
           if (typeof window !== "undefined") {
@@ -3795,18 +3818,28 @@ function useTourPlayback({
           }
         }
       });
-      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devMode || process.env.NODE_ENV === "development");
+      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devModeRef.current || process.env.NODE_ENV === "development");
     });
     return () => {
-      if (socketRef.current) {
-        socketRef.current.disconnect();
-        socketRef.current = null;
+      cancelled = true;
+      const toClose = createdSocket ?? socketRef.current;
+      if (toClose) {
+        toClose.disconnect();
       }
+      createdSocket = null;
+      socketRef.current = null;
       setServerState(null);
       runIdRef.current = null;
       turnIdRef.current = null;
     };
-  }, [serverUrl, websiteId, userProfile, disabled, devMode, experienceType]);
+  }, [serverUrl, websiteId, disabled]);
+  (0, import_react12.useEffect)(() => {
+    if (disabled) return;
+    const s = socketRef.current;
+    const profile = userProfile;
+    if (!s?.connected || !websiteId || !profile?.userId) return;
+    s.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
+  }, [disabled, websiteId, userProfile?.userId, userProfile?.type]);
   (0, import_react12.useEffect)(() => {
     if (!showCaptions || !isReviewMode) {
       removeCaption();

package/dist/index.mjs

@@ -2114,7 +2114,7 @@ function useBuiltinActions(registerAction, unregisterAction, tagStore, serverUrl
 }
 
 // src/constants.ts
-var DEFAULT_MODELNEX_SERVER_URL = "https://modelnex-server-production.up.railway.app";
+var DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
 
 // src/hooks/useRunCommand.ts
 import { useCallback as useCallback5, useContext as useContext2 } from "react";
@@ -2944,6 +2944,12 @@ function useTourPlayback({
   const [serverState, setServerState] = useState7(null);
   const ctx = useContext4(ModelNexContext);
   const devMode = ctx?.devMode;
+  const devModeRef = useRef8(devMode);
+  devModeRef.current = devMode;
+  const userProfileRef = useRef8(userProfile);
+  userProfileRef.current = userProfile;
+  const experienceTypeRef = useRef8(experienceType);
+  experienceTypeRef.current = experienceType;
   const tourRef = useRef8(null);
   const stepIndexRef = useRef8(0);
   const skipRequestedRef = useRef8(false);
@@ -2983,18 +2989,27 @@ function useTourPlayback({
   useEffect11(() => {
     if (disabled) return;
     if (typeof window === "undefined") return;
+    let cancelled = false;
+    let createdSocket = null;
     import("socket.io-client").then((ioModule) => {
+      if (cancelled) return;
       const io2 = ioModule.default || ioModule;
       const socket = io2(serverUrl, {
         path: "/socket.io",
         // standard
         transports: resolveSocketIoTransports(serverUrl, "polling-first")
       });
+      if (cancelled) {
+        socket.disconnect();
+        return;
+      }
+      createdSocket = socket;
       socketRef.current = socket;
       socket.on("connect", () => {
         console.log("[TourClient] Connected to tour agent server:", socket.id);
-        if (websiteId && userProfile) {
-          socket.emit("tour:init", { websiteId, userId: userProfile.userId, userType: userProfile.type });
+        const profile = userProfileRef.current;
+        if (websiteId && profile?.userId) {
+          socket.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
         }
       });
       socket.on("tour:server_state", (payload) => {
@@ -3019,6 +3034,11 @@ function useTourPlayback({
         }
       });
       socket.on("tour:command", async (payload) => {
+        const emitIfOpen = (ev, data) => {
+          if (socketRef.current !== socket) return;
+          if (!socket.connected) return;
+          socket.emit(ev, data);
+        };
         console.log("[TourClient] Received command batch:", payload.stepIndex, payload.commands);
         runCleanup(pendingManualWaitCleanupRef.current);
         pendingManualWaitCleanupRef.current = null;
@@ -3077,7 +3097,7 @@ function useTourPlayback({
         if (!payload.commands || !Array.isArray(payload.commands)) {
           console.warn("[TourClient] Payload commands is not an array:", payload);
           commandInFlightRef.current = false;
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "invalid_commands",
             commandBatchId,
@@ -3356,7 +3376,7 @@ function useTourPlayback({
                 currentStepOrder: stepIndexRef.current
               });
             }
-            socket.emit("tour:action_result", {
+            emitIfOpen("tour:action_result", {
               success: true,
               interrupted: true,
               results,
@@ -3381,7 +3401,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "execution_error",
             error: String(err),
@@ -3450,7 +3470,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: true,
             waitingForInput: true,
             results,
@@ -3483,7 +3503,7 @@ function useTourPlayback({
             const { waitForDomSettle } = await import("./dom-sync-L5KIP45X.mjs");
             await waitForDomSettle({ timeoutMs: 1500, debounceMs: 200 });
             await syncAOM();
-            socket.emit("tour:user_input", {
+            emitIfOpen("tour:user_input", {
               transcript,
               runId: runIdRef.current,
               turnId: turnIdRef.current
@@ -3502,7 +3522,7 @@ function useTourPlayback({
             currentStepOrder: stepIndexRef.current
           });
         }
-        socket.emit("tour:action_result", {
+        emitIfOpen("tour:action_result", {
           success: true,
           results,
           commandBatchId,
@@ -3515,8 +3535,9 @@ function useTourPlayback({
         if (isActiveRef.current) return;
         runIdRef.current = typeof tourData.runId === "number" ? tourData.runId : runIdRef.current;
         const tour = tourData.tourContext ?? tourRef.current;
-        if (tour?.type && tour.type !== experienceType) {
-          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${experienceType})`);
+        const expType = experienceTypeRef.current;
+        if (tour?.type && tour.type !== expType) {
+          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${expType})`);
           return;
         }
         skipRequestedRef.current = false;
@@ -3543,11 +3564,13 @@ function useTourPlayback({
         try {
           const { generateMinifiedAOM: generateMinifiedAOM2 } = await import("./aom-HDYNCIOY.mjs");
           const aom = generateMinifiedAOM2();
-          socket.emit("tour:sync_dom", {
-            url: window.location.pathname + window.location.search + window.location.hash,
-            aom: aom.nodes,
-            domSummary: captureDomSummary()
-          });
+          if (socketRef.current === socket && socket.connected) {
+            socket.emit("tour:sync_dom", {
+              url: window.location.pathname + window.location.search + window.location.hash,
+              aom: aom.nodes,
+              domSummary: captureDomSummary()
+            });
+          }
         } catch (e) {
           console.warn("[TourClient] Initial DOM sync failed:", e);
         }
@@ -3575,7 +3598,7 @@ function useTourPlayback({
         handleTourEnd();
       });
       socket.on("tour:debug_log", (entry) => {
-        const isDev = devMode || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
+        const isDev = devModeRef.current || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
         if (isDev) {
           console.log(`%c[ModelNex Tour] ${entry.type}`, "color: #3b82f6; font-weight: bold", entry);
           if (typeof window !== "undefined") {
@@ -3585,18 +3608,28 @@ function useTourPlayback({
           }
         }
       });
-      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devMode || process.env.NODE_ENV === "development");
+      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devModeRef.current || process.env.NODE_ENV === "development");
     });
     return () => {
-      if (socketRef.current) {
-        socketRef.current.disconnect();
-        socketRef.current = null;
+      cancelled = true;
+      const toClose = createdSocket ?? socketRef.current;
+      if (toClose) {
+        toClose.disconnect();
       }
+      createdSocket = null;
+      socketRef.current = null;
       setServerState(null);
       runIdRef.current = null;
       turnIdRef.current = null;
     };
-  }, [serverUrl, websiteId, userProfile, disabled, devMode, experienceType]);
+  }, [serverUrl, websiteId, disabled]);
+  useEffect11(() => {
+    if (disabled) return;
+    const s = socketRef.current;
+    const profile = userProfile;
+    if (!s?.connected || !websiteId || !profile?.userId) return;
+    s.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
+  }, [disabled, websiteId, userProfile?.userId, userProfile?.type]);
   useEffect11(() => {
     if (!showCaptions || !isReviewMode) {
       removeCaption();

package/package.json

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