@perspective-ai/sdk-react 1.3.0 → 1.4.0-pr-25-20260306102715

package/dist/index.js

@@ -1,5 +1,5 @@
 import { useRef, useLayoutEffect, useEffect, useCallback, useState } from 'react';
-import { openPopup, openSlider, createFloatBubble, markShown, shouldShow, setupTrigger, createWidget, createFullpage } from '@perspective-ai/sdk';
+import { openPopup, openSlider, createFloatBubble, markShown, shouldShow, preloadIframe, getHost, destroyPreloadedByType, setupTrigger, createWidget, createFullpage } from '@perspective-ai/sdk';
 import { jsx } from 'react/jsx-runtime';
 
 var useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
@@ -14,6 +14,28 @@ function useStableCallback(callback) {
   );
   return callback ? stable : callback;
 }
+function sortObjectKeys(value) {
+  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+    return Object.keys(value).sort().reduce((result, key) => {
+      result[key] = value[key];
+      return result;
+    }, {});
+  }
+  return value;
+}
+function useStableValue(value) {
+  const ref = useRef(value);
+  const serialized = JSON.stringify(
+    value,
+    (_key, currentValue) => sortObjectKeys(currentValue)
+  );
+  const prevSerialized = useRef(serialized);
+  if (prevSerialized.current !== serialized) {
+    prevSerialized.current = serialized;
+    ref.current = value;
+  }
+  return ref.current;
+}
 
 // src/hooks/usePopup.ts
 function usePopup(options) {
@@ -36,6 +58,9 @@ function usePopup(options) {
   const handleRef = useRef(null);
   const isControlled = controlledOpen !== void 0;
   const isOpen = isControlled ? controlledOpen : internalOpen;
+  const initialHiddenRef = useRef(!isOpen);
+  const stableParams = useStableValue(params);
+  const stableBrand = useStableValue(brand);
   const stableOnReady = useStableCallback(onReady);
   const stableOnSubmit = useStableCallback(onSubmit);
   const stableOnNavigate = useStableCallback(onNavigate);
@@ -50,65 +75,98 @@ function usePopup(options) {
     },
     [isControlled, onOpenChange]
   );
+  const destroyPopup = useCallback(
+    (targetHandle = handleRef.current) => {
+      if (!targetHandle) return;
+      targetHandle.update({ onClose: void 0 });
+      targetHandle.destroy();
+      if (handleRef.current === targetHandle) {
+        handleRef.current = null;
+        setHandle(null);
+      }
+    },
+    []
+  );
   const handleClose = useCallback(() => {
-    handleRef.current = null;
-    setHandle(null);
     setOpen(false);
     onClose?.();
   }, [setOpen, onClose]);
   const stableOnClose = useStableCallback(handleClose);
-  const createPopup = useCallback(() => {
-    if (handleRef.current) return handleRef.current;
-    const newHandle = openPopup({
+  const createPopupHandle = useCallback(
+    (startHidden) => openPopup({
       researchId,
-      params,
-      brand,
+      params: stableParams,
+      brand: stableBrand,
       theme,
       host,
       onReady: stableOnReady,
       onSubmit: stableOnSubmit,
       onNavigate: stableOnNavigate,
       onClose: stableOnClose,
-      onError: stableOnError
-    });
-    handleRef.current = newHandle;
-    setHandle(newHandle);
-    return newHandle;
-  }, [
-    researchId,
-    params,
-    brand,
-    theme,
-    host,
-    stableOnReady,
-    stableOnSubmit,
-    stableOnNavigate,
-    stableOnClose,
-    stableOnError
-  ]);
-  const destroyPopup = useCallback(() => {
-    if (handleRef.current) {
-      handleRef.current.destroy();
-      handleRef.current = null;
-      setHandle(null);
+      onError: stableOnError,
+      _startHidden: startHidden
+    }),
+    [
+      researchId,
+      stableParams,
+      stableBrand,
+      theme,
+      host,
+      stableOnReady,
+      stableOnSubmit,
+      stableOnNavigate,
+      stableOnClose,
+      stableOnError
+    ]
+  );
+  const setPopupHandle = useCallback(
+    (startHidden) => {
+      const newHandle = createPopupHandle(startHidden);
+      handleRef.current = newHandle;
+      setHandle(newHandle);
+      return newHandle;
+    },
+    [createPopupHandle]
+  );
+  useEffect(() => {
+    const currentHandle = handleRef.current;
+    if (!currentHandle) return;
+    if (isOpen) {
+      currentHandle.show();
+    } else {
+      currentHandle.hide();
     }
-  }, []);
+  }, [isOpen]);
+  useEffect(() => {
+    const nextHandle = setPopupHandle(
+      handleRef.current ? !handleRef.current.isOpen : initialHiddenRef.current
+    );
+    return () => {
+      if (handleRef.current === nextHandle) {
+        destroyPopup(nextHandle);
+      }
+    };
+  }, [destroyPopup, setPopupHandle]);
+  const ensurePopup = useCallback(() => {
+    if (handleRef.current) return handleRef.current;
+    return setPopupHandle(false);
+  }, [setPopupHandle]);
   const openFn = useCallback(() => {
     if (isControlled) {
       onOpenChange?.(true);
     } else {
-      createPopup();
+      ensurePopup().show();
       setInternalOpen(true);
     }
-  }, [isControlled, onOpenChange, createPopup]);
+  }, [ensurePopup, isControlled, onOpenChange]);
   const closeFn = useCallback(() => {
     if (isControlled) {
       onOpenChange?.(false);
     } else {
-      destroyPopup();
+      handleRef.current?.hide();
       setInternalOpen(false);
     }
-  }, [isControlled, onOpenChange, destroyPopup]);
+  }, [isControlled, onOpenChange]);
   const toggleFn = useCallback(() => {
     if (isOpen) {
       closeFn();
@@ -116,22 +174,6 @@ function usePopup(options) {
       openFn();
     }
   }, [isOpen, openFn, closeFn]);
-  useEffect(() => {
-    if (!isControlled) return;
-    if (controlledOpen && !handleRef.current) {
-      createPopup();
-    } else if (!controlledOpen && handleRef.current) {
-      destroyPopup();
-    }
-  }, [controlledOpen, isControlled, createPopup, destroyPopup]);
-  useEffect(() => {
-    return () => {
-      if (handleRef.current) {
-        handleRef.current.destroy();
-        handleRef.current = null;
-      }
-    };
-  }, []);
   return {
     open: openFn,
     close: closeFn,
@@ -160,6 +202,9 @@ function useSlider(options) {
   const handleRef = useRef(null);
   const isControlled = controlledOpen !== void 0;
   const isOpen = isControlled ? controlledOpen : internalOpen;
+  const initialHiddenRef = useRef(!isOpen);
+  const stableParams = useStableValue(params);
+  const stableBrand = useStableValue(brand);
   const stableOnReady = useStableCallback(onReady);
   const stableOnSubmit = useStableCallback(onSubmit);
   const stableOnNavigate = useStableCallback(onNavigate);
@@ -174,65 +219,98 @@ function useSlider(options) {
     },
     [isControlled, onOpenChange]
   );
+  const destroySlider = useCallback(
+    (targetHandle = handleRef.current) => {
+      if (!targetHandle) return;
+      targetHandle.update({ onClose: void 0 });
+      targetHandle.destroy();
+      if (handleRef.current === targetHandle) {
+        handleRef.current = null;
+        setHandle(null);
+      }
+    },
+    []
+  );
   const handleClose = useCallback(() => {
-    handleRef.current = null;
-    setHandle(null);
     setOpen(false);
     onClose?.();
   }, [setOpen, onClose]);
   const stableOnClose = useStableCallback(handleClose);
-  const createSlider = useCallback(() => {
-    if (handleRef.current) return handleRef.current;
-    const newHandle = openSlider({
+  const createSliderHandle = useCallback(
+    (startHidden) => openSlider({
       researchId,
-      params,
-      brand,
+      params: stableParams,
+      brand: stableBrand,
       theme,
       host,
       onReady: stableOnReady,
       onSubmit: stableOnSubmit,
       onNavigate: stableOnNavigate,
       onClose: stableOnClose,
-      onError: stableOnError
-    });
-    handleRef.current = newHandle;
-    setHandle(newHandle);
-    return newHandle;
-  }, [
-    researchId,
-    params,
-    brand,
-    theme,
-    host,
-    stableOnReady,
-    stableOnSubmit,
-    stableOnNavigate,
-    stableOnClose,
-    stableOnError
-  ]);
-  const destroySlider = useCallback(() => {
-    if (handleRef.current) {
-      handleRef.current.destroy();
-      handleRef.current = null;
-      setHandle(null);
+      onError: stableOnError,
+      _startHidden: startHidden
+    }),
+    [
+      researchId,
+      stableParams,
+      stableBrand,
+      theme,
+      host,
+      stableOnReady,
+      stableOnSubmit,
+      stableOnNavigate,
+      stableOnClose,
+      stableOnError
+    ]
+  );
+  const setSliderHandle = useCallback(
+    (startHidden) => {
+      const newHandle = createSliderHandle(startHidden);
+      handleRef.current = newHandle;
+      setHandle(newHandle);
+      return newHandle;
+    },
+    [createSliderHandle]
+  );
+  useEffect(() => {
+    const currentHandle = handleRef.current;
+    if (!currentHandle) return;
+    if (isOpen) {
+      currentHandle.show();
+    } else {
+      currentHandle.hide();
     }
-  }, []);
+  }, [isOpen]);
+  useEffect(() => {
+    const nextHandle = setSliderHandle(
+      handleRef.current ? !handleRef.current.isOpen : initialHiddenRef.current
+    );
+    return () => {
+      if (handleRef.current === nextHandle) {
+        destroySlider(nextHandle);
+      }
+    };
+  }, [destroySlider, setSliderHandle]);
+  const ensureSlider = useCallback(() => {
+    if (handleRef.current) return handleRef.current;
+    return setSliderHandle(false);
+  }, [setSliderHandle]);
   const openFn = useCallback(() => {
     if (isControlled) {
       onOpenChange?.(true);
     } else {
-      createSlider();
+      ensureSlider().show();
       setInternalOpen(true);
     }
-  }, [isControlled, onOpenChange, createSlider]);
+  }, [ensureSlider, isControlled, onOpenChange]);
   const closeFn = useCallback(() => {
     if (isControlled) {
       onOpenChange?.(false);
     } else {
-      destroySlider();
+      handleRef.current?.hide();
       setInternalOpen(false);
     }
-  }, [isControlled, onOpenChange, destroySlider]);
+  }, [isControlled, onOpenChange]);
   const toggleFn = useCallback(() => {
     if (isOpen) {
       closeFn();
@@ -240,22 +318,6 @@ function useSlider(options) {
       openFn();
     }
   }, [isOpen, openFn, closeFn]);
-  useEffect(() => {
-    if (!isControlled) return;
-    if (controlledOpen && !handleRef.current) {
-      createSlider();
-    } else if (!controlledOpen && handleRef.current) {
-      destroySlider();
-    }
-  }, [controlledOpen, isControlled, createSlider, destroySlider]);
-  useEffect(() => {
-    return () => {
-      if (handleRef.current) {
-        handleRef.current.destroy();
-        handleRef.current = null;
-      }
-    };
-  }, []);
   return {
     open: openFn,
     close: closeFn,
@@ -283,6 +345,8 @@ function useFloatBubble(options) {
   const [internalOpen, setInternalOpen] = useState(false);
   const handleRef = useRef(null);
   const isControlled = controlledOpen !== void 0;
+  const stableParams = useStableValue(params);
+  const stableBrand = useStableValue(brand);
   const stableOnReady = useStableCallback(onReady);
   const stableOnSubmit = useStableCallback(onSubmit);
   const stableOnNavigate = useStableCallback(onNavigate);
@@ -298,8 +362,8 @@ function useFloatBubble(options) {
   useEffect(() => {
     const newHandle = createFloatBubble({
       researchId,
-      params,
-      brand,
+      params: stableParams,
+      brand: stableBrand,
       theme,
       host,
       onReady: stableOnReady,
@@ -319,8 +383,8 @@ function useFloatBubble(options) {
     };
   }, [
     researchId,
-    params,
-    brand,
+    stableParams,
+    stableBrand,
     theme,
     host,
     stableOnReady,
@@ -378,14 +442,66 @@ function useFloatBubble(options) {
   };
 }
 function useAutoOpen(options) {
-  const { trigger, showOnce = "session", researchId, ...embedConfig } = options;
+  const {
+    trigger,
+    showOnce = "session",
+    researchId,
+    params,
+    brand,
+    theme,
+    host,
+    onReady,
+    onSubmit,
+    onNavigate,
+    onClose,
+    onError,
+    onAuth,
+    channel,
+    welcomeMessage
+  } = options;
   const cleanupRef = useRef(null);
   const [triggered, setTriggered] = useState(false);
   const triggerDelay = trigger.type === "timeout" ? trigger.delay : void 0;
+  const stableParams = useStableValue(params);
+  const stableBrand = useStableValue(brand);
+  const stableOnReady = useStableCallback(onReady);
+  const stableOnSubmit = useStableCallback(onSubmit);
+  const stableOnNavigate = useStableCallback(onNavigate);
+  const stableOnClose = useStableCallback(onClose);
+  const stableOnError = useStableCallback(onError);
+  const stableOnAuth = useStableCallback(onAuth);
   const stableOnTrigger = useStableCallback(() => {
     markShown(researchId, showOnce);
-    openPopup({ researchId, ...embedConfig });
+    openPopup({
+      researchId,
+      params: stableParams,
+      brand: stableBrand,
+      theme,
+      host,
+      onReady: stableOnReady,
+      onSubmit: stableOnSubmit,
+      onNavigate: stableOnNavigate,
+      onClose: stableOnClose,
+      onError: stableOnError,
+      onAuth: stableOnAuth,
+      channel,
+      welcomeMessage
+    });
   });
+  useEffect(() => {
+    if (triggered || !shouldShow(researchId, showOnce)) return;
+    preloadIframe(
+      researchId,
+      "popup",
+      getHost(host),
+      stableParams,
+      stableBrand,
+      theme
+    );
+    return () => {
+      destroyPreloadedByType(researchId, "popup");
+    };
+  }, [researchId, showOnce, host, stableParams, stableBrand, theme, triggered]);
   useEffect(() => {
     if (!shouldShow(researchId, showOnce)) return;
     cleanupRef.current = setupTrigger(trigger, () => {
@@ -403,7 +519,8 @@ function useAutoOpen(options) {
   const cancel = useCallback(() => {
     cleanupRef.current?.();
     cleanupRef.current = null;
-  }, []);
+    destroyPreloadedByType(researchId, "popup");
+  }, [researchId]);
   return { cancel, triggered };
 }
 function useThemeSync(theme = "system") {