@modelnex/sdk 0.5.21 → 0.5.23

package/dist/index.js

@@ -2460,6 +2460,7 @@ var import_react13 = require("react");
 
 // src/utils/draftPreview.ts
 var ACTIVE_DRAFT_PREVIEW_STORAGE_KEY = "modelnex:active-draft-preview";
+var PREVIEW_SESSION_SUPPRESSION_STORAGE_KEY = "modelnex:preview-session-suppressed";
 function getPreviewQueryParamName(experienceType) {
   return experienceType === "onboarding" ? "modelnex_test_workflow" : "modelnex_test_tour";
 }
@@ -2509,6 +2510,21 @@ function clearActiveDraftPreview(experienceType) {
   } catch {
   }
 }
+function persistPreviewSessionSuppression() {
+  if (typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(PREVIEW_SESSION_SUPPRESSION_STORAGE_KEY, "true");
+  } catch {
+  }
+}
+function readPreviewSessionSuppression() {
+  if (typeof window === "undefined") return false;
+  try {
+    return window.sessionStorage.getItem(PREVIEW_SESSION_SUPPRESSION_STORAGE_KEY) === "true";
+  } catch {
+    return false;
+  }
+}
 
 // src/utils/tourDiscovery.ts
 async function fetchTours(serverUrl, toursApiBase, websiteId, userType, userId, experienceType = "tour") {
@@ -4457,6 +4473,18 @@ function shouldDiscoverDraftPreview({
 }) {
   return !disabled && !hasPendingPrompt && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience;
 }
+function shouldDiscoverEligibleTours({
+  disabled,
+  hasPendingPrompt,
+  hasPreviewSession,
+  isPlaybackActive,
+  isPreviewDiscoveryInFlight,
+  isStartingExperience,
+  hasUserProfile,
+  hasWebsiteId
+}) {
+  return !disabled && !hasPendingPrompt && !hasPreviewSession && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience && hasUserProfile && hasWebsiteId;
+}
 function useExperiencePlaybackController({
   serverUrl,
   commandUrl,
@@ -4480,6 +4508,7 @@ function useExperiencePlaybackController({
   const queuedStartRef = (0, import_react13.useRef)(null);
   const bufferedVoiceInputsRef = (0, import_react13.useRef)([]);
   const previewDiscoveryInFlightRef = (0, import_react13.useRef)(false);
+  const previewSessionRef = (0, import_react13.useRef)(readPreviewSessionSuppression());
   pendingPromptRef.current = pendingPrompt;
   const playback = useTourPlayback({
     serverUrl,
@@ -4502,6 +4531,10 @@ function useExperiencePlaybackController({
     setPendingPrompt(null);
     pendingPromptRef.current = null;
     setStartingExperienceType(experienceType);
+    if (options?.reviewMode) {
+      previewSessionRef.current = true;
+      persistPreviewSessionSuppression();
+    }
     if (activeExperienceType !== experienceType) {
       queuedStartRef.current = { tour, experienceType, options };
       setActiveExperienceType(experienceType);
@@ -4606,6 +4639,8 @@ function useExperiencePlaybackController({
     if (!request) return;
     let cancelled = false;
     previewDiscoveryInFlightRef.current = true;
+    previewSessionRef.current = true;
+    persistPreviewSessionSuppression();
     (async () => {
       try {
         persistActiveDraftPreview({ id: request.tourId, experienceType: request.experienceType });
@@ -4641,9 +4676,16 @@ function useExperiencePlaybackController({
     };
   }, [disabled, playback.isActive, queueExperienceStart, serverUrl, startingExperienceType, toursApiBase, websiteId]);
   (0, import_react13.useEffect)(() => {
-    if (disabled) return;
-    if (!websiteId || !userProfile) return;
-    if (playback.isActive || pendingPromptRef.current || previewDiscoveryInFlightRef.current) return;
+    if (!shouldDiscoverEligibleTours({
+      disabled,
+      hasPendingPrompt: Boolean(pendingPromptRef.current),
+      hasPreviewSession: previewSessionRef.current,
+      isPlaybackActive: playback.isActive,
+      isPreviewDiscoveryInFlight: previewDiscoveryInFlightRef.current,
+      isStartingExperience: startingExperienceType !== null,
+      hasUserProfile: Boolean(userProfile),
+      hasWebsiteId: Boolean(websiteId)
+    })) return;
     let cancelled = false;
     const checkTours = async () => {
       const toursByExperience = await Promise.all(
@@ -4683,7 +4725,7 @@ function useExperiencePlaybackController({
       cancelled = true;
       clearTimeout(timer);
     };
-  }, [disabled, playback.isActive, queueExperienceStart, serverUrl, toursApiBase, userProfile, websiteId]);
+  }, [disabled, playback.isActive, queueExperienceStart, serverUrl, startingExperienceType, toursApiBase, userProfile, websiteId]);
   return {
     activeExperienceType,
     startingExperienceType,

package/dist/index.mjs

@@ -2250,6 +2250,7 @@ import { useCallback as useCallback8, useEffect as useEffect12, useRef as useRef
 
 // src/utils/draftPreview.ts
 var ACTIVE_DRAFT_PREVIEW_STORAGE_KEY = "modelnex:active-draft-preview";
+var PREVIEW_SESSION_SUPPRESSION_STORAGE_KEY = "modelnex:preview-session-suppressed";
 function getPreviewQueryParamName(experienceType) {
   return experienceType === "onboarding" ? "modelnex_test_workflow" : "modelnex_test_tour";
 }
@@ -2299,6 +2300,21 @@ function clearActiveDraftPreview(experienceType) {
   } catch {
   }
 }
+function persistPreviewSessionSuppression() {
+  if (typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(PREVIEW_SESSION_SUPPRESSION_STORAGE_KEY, "true");
+  } catch {
+  }
+}
+function readPreviewSessionSuppression() {
+  if (typeof window === "undefined") return false;
+  try {
+    return window.sessionStorage.getItem(PREVIEW_SESSION_SUPPRESSION_STORAGE_KEY) === "true";
+  } catch {
+    return false;
+  }
+}
 
 // src/utils/tourDiscovery.ts
 async function fetchTours(serverUrl, toursApiBase, websiteId, userType, userId, experienceType = "tour") {
@@ -4247,6 +4263,18 @@ function shouldDiscoverDraftPreview({
 }) {
   return !disabled && !hasPendingPrompt && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience;
 }
+function shouldDiscoverEligibleTours({
+  disabled,
+  hasPendingPrompt,
+  hasPreviewSession,
+  isPlaybackActive,
+  isPreviewDiscoveryInFlight,
+  isStartingExperience,
+  hasUserProfile,
+  hasWebsiteId
+}) {
+  return !disabled && !hasPendingPrompt && !hasPreviewSession && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience && hasUserProfile && hasWebsiteId;
+}
 function useExperiencePlaybackController({
   serverUrl,
   commandUrl,
@@ -4270,6 +4298,7 @@ function useExperiencePlaybackController({
   const queuedStartRef = useRef9(null);
   const bufferedVoiceInputsRef = useRef9([]);
   const previewDiscoveryInFlightRef = useRef9(false);
+  const previewSessionRef = useRef9(readPreviewSessionSuppression());
   pendingPromptRef.current = pendingPrompt;
   const playback = useTourPlayback({
     serverUrl,
@@ -4292,6 +4321,10 @@ function useExperiencePlaybackController({
     setPendingPrompt(null);
     pendingPromptRef.current = null;
     setStartingExperienceType(experienceType);
+    if (options?.reviewMode) {
+      previewSessionRef.current = true;
+      persistPreviewSessionSuppression();
+    }
     if (activeExperienceType !== experienceType) {
       queuedStartRef.current = { tour, experienceType, options };
       setActiveExperienceType(experienceType);
@@ -4396,6 +4429,8 @@ function useExperiencePlaybackController({
     if (!request) return;
     let cancelled = false;
     previewDiscoveryInFlightRef.current = true;
+    previewSessionRef.current = true;
+    persistPreviewSessionSuppression();
     (async () => {
       try {
         persistActiveDraftPreview({ id: request.tourId, experienceType: request.experienceType });
@@ -4431,9 +4466,16 @@ function useExperiencePlaybackController({
     };
   }, [disabled, playback.isActive, queueExperienceStart, serverUrl, startingExperienceType, toursApiBase, websiteId]);
   useEffect12(() => {
-    if (disabled) return;
-    if (!websiteId || !userProfile) return;
-    if (playback.isActive || pendingPromptRef.current || previewDiscoveryInFlightRef.current) return;
+    if (!shouldDiscoverEligibleTours({
+      disabled,
+      hasPendingPrompt: Boolean(pendingPromptRef.current),
+      hasPreviewSession: previewSessionRef.current,
+      isPlaybackActive: playback.isActive,
+      isPreviewDiscoveryInFlight: previewDiscoveryInFlightRef.current,
+      isStartingExperience: startingExperienceType !== null,
+      hasUserProfile: Boolean(userProfile),
+      hasWebsiteId: Boolean(websiteId)
+    })) return;
     let cancelled = false;
     const checkTours = async () => {
       const toursByExperience = await Promise.all(
@@ -4473,7 +4515,7 @@ function useExperiencePlaybackController({
       cancelled = true;
       clearTimeout(timer);
     };
-  }, [disabled, playback.isActive, queueExperienceStart, serverUrl, toursApiBase, userProfile, websiteId]);
+  }, [disabled, playback.isActive, queueExperienceStart, serverUrl, startingExperienceType, toursApiBase, userProfile, websiteId]);
   return {
     activeExperienceType,
     startingExperienceType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelnex/sdk",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "description": "React SDK for natural language control of web apps via AI agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -20,6 +20,15 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "npm exec -- tsup src/index.ts --format cjs,esm --dts",
+    "dev": "npm exec -- tsup src/index.ts --format cjs,esm --watch --dts",
+    "lint": "eslint src/",
+    "test": "npm run build && node --test tests/*.test.js",
+    "test:ci": "npm run test && npm run test:unit",
+    "test:unit": "node --import tsx --test tests/*.test.ts"
+  },
   "peerDependencies": {
     "react": ">=17.0.0",
     "react-dom": ">=17.0.0",
@@ -58,13 +67,5 @@
   "bugs": {
     "url": "https://github.com/sharunaraksha/modelnex-sdk/issues"
   },
-  "homepage": "https://github.com/sharunaraksha/modelnex-sdk#readme",
-  "scripts": {
-    "build": "npm exec -- tsup src/index.ts --format cjs,esm --dts",
-    "dev": "npm exec -- tsup src/index.ts --format cjs,esm --watch --dts",
-    "lint": "eslint src/",
-    "test": "npm run build && node --test tests/*.test.js",
-    "test:ci": "npm run test && npm run test:unit",
-    "test:unit": "node --import tsx --test tests/*.test.ts"
-  }
-}
+  "homepage": "https://github.com/sharunaraksha/modelnex-sdk#readme"
+}