@skippr/live-agent-sdk 0.121.0 → 0.123.0

package/dist/esm/lib-exports.js

@@ -586,6 +586,7 @@ var PENDING_START_KIND = {
 var PLAN_ATTR = "skippr.action-plan";
 var LINK_CARD_ATTR = "skippr.link-card";
 var NAME_MAX_CHARS = 80;
+var TIP_DEEPLINK_PARAM = "skippr";
 
 // src/components/ConsentNotice.tsx
 import { jsx } from "react/jsx-runtime";
@@ -4911,31 +4912,40 @@ function useAdoptionGoals({
   authedFetch
 }) {
   const [candidates, setCandidates] = useState11([]);
+  const [deepLinkedGoal, setDeepLinkedGoal] = useState11(null);
   const [hasResolved, setHasResolved] = useState11(false);
   const [hash, setHash] = useState11(window.location.hash);
+  const [tipSlug] = useState11(() => new URLSearchParams(window.location.search).get(TIP_DEEPLINK_PARAM) || null);
   const match = useCallback11(async () => {
     try {
       const resp = await authedFetch(`${API_URL}/v1/adoption/goals/match`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ url: window.location.origin + window.location.pathname })
+        body: JSON.stringify({
+          url: window.location.origin + window.location.pathname,
+          ...tipSlug ? { tipSlug } : {}
+        })
       });
       if (!resp.ok) {
         setCandidates([]);
+        setDeepLinkedGoal(null);
         return;
       }
       const data = await resp.json();
       setCandidates(Array.isArray(data?.goals) ? data.goals : []);
+      setDeepLinkedGoal(data?.deepLinkedGoal ?? null);
     } catch (e) {
       console.warn("[Skippr] adoption match failed", e);
       setCandidates([]);
+      setDeepLinkedGoal(null);
     } finally {
       setHasResolved(true);
     }
-  }, [authedFetch]);
+  }, [authedFetch, tipSlug]);
   useEffect13(() => {
     if (!enabled || !bearerToken) {
       setCandidates([]);
+      setDeepLinkedGoal(null);
       setHasResolved(false);
       return;
     }
@@ -4976,7 +4986,7 @@ function useAdoptionGoals({
   const attendGoal = useCallback11((goalId) => {
     postStatus(goalId, "attended" /* Attended */);
   }, [postStatus]);
-  return { goals, hasResolved, attendGoal };
+  return { goals, deepLinkedGoal, hasTipSlug: tipSlug !== null, hasResolved, attendGoal };
 }
 
 // src/hooks/useAuth.ts
@@ -5224,22 +5234,35 @@ async function isMicGranted() {
 }
 function useAutoStart({
   availableModules,
+  deepLinkedGoal,
+  hasTipSlug,
+  adoptionResolved,
   suppressed,
+  moduleSuppressed,
+  modulesResolved,
   bearerToken,
-  selectModule
+  selectModule,
+  startAdoptionSession
 }) {
   const hasAutoStartedRef = useRef12(false);
+  const hasGesturedRef = useRef12(false);
   const autoStartModule = useMemo3(() => availableModules.find((m) => {
     if (!m.uiPreferences?.autoStart)
       return false;
     const state = getModuleSessionState(m.currentSession, m.mode);
     return state !== "completed" && state !== "expired";
   }) ?? null, [availableModules]);
+  const awaitingDeepLink = hasTipSlug && !adoptionResolved;
+  const moduleTarget = moduleSuppressed || awaitingDeepLink ? null : autoStartModule;
   useEffect15(() => {
-    if (!autoStartModule || hasAutoStartedRef.current)
+    if (hasAutoStartedRef.current)
       return;
     if (suppressed || !bearerToken)
       return;
+    if (!modulesResolved)
+      return;
+    if (!deepLinkedGoal && !moduleTarget && !awaitingDeepLink)
+      return;
     let cancelled = false;
     const stopWaitingForGesture = () => {
       document.removeEventListener("pointerdown", onFirstGesture, true);
@@ -5248,13 +5271,22 @@ function useAutoStart({
     const startOnce = () => {
       if (cancelled || hasAutoStartedRef.current)
         return;
+      if (!deepLinkedGoal && !moduleTarget) {
+        hasGesturedRef.current = true;
+        return;
+      }
       hasAutoStartedRef.current = true;
       stopWaitingForGesture();
-      selectModule(autoStartModule.id, { autoStarted: true });
+      if (deepLinkedGoal)
+        startAdoptionSession(deepLinkedGoal);
+      else if (moduleTarget)
+        selectModule(moduleTarget.id, { autoStarted: true });
     };
     const onFirstGesture = () => startOnce();
     document.addEventListener("pointerdown", onFirstGesture, true);
     document.addEventListener("keydown", onFirstGesture, true);
+    if (hasGesturedRef.current)
+      startOnce();
     isMicGranted().then((granted) => {
       if (granted)
         startOnce();
@@ -5263,7 +5295,16 @@ function useAutoStart({
       cancelled = true;
       stopWaitingForGesture();
     };
-  }, [autoStartModule, suppressed, bearerToken, selectModule]);
+  }, [
+    moduleTarget,
+    deepLinkedGoal,
+    awaitingDeepLink,
+    suppressed,
+    modulesResolved,
+    bearerToken,
+    selectModule,
+    startAdoptionSession
+  ]);
 }
 
 // src/hooks/useAvailableModules.ts
@@ -5467,7 +5508,7 @@ function usePlanUpdates() {
 // src/hooks/useSession.ts
 import { useCallback as useCallback15, useEffect as useEffect20, useRef as useRef15, useState as useState17 } from "react";
 var API_URL4 = "https://app.skippr.ai/api";
-var SDK_VERSION = "0.121.0";
+var SDK_VERSION = "0.123.0";
 async function fetchSessionMessages(sessionId, authedFetch) {
   try {
     const resp = await authedFetch(`${API_URL4}/v1/sessions/${sessionId}/messages`);
@@ -12129,7 +12170,11 @@ function SplashAlwaysOn({
             onClick: start,
             className: `${FOCUS_RING3} skippr:flex skippr:w-full skippr:cursor-pointer skippr:items-center skippr:justify-center skippr:gap-2 skippr:rounded-full skippr:bg-primary skippr:px-5 skippr:py-[13px] skippr:text-[16px] skippr:font-semibold skippr:text-primary-foreground skippr:transition-all skippr:hover:bg-primary/90`,
             children: [
-              /* @__PURE__ */ jsx44(Sparkles, {
+              headerIconUrl ? /* @__PURE__ */ jsx44("img", {
+                src: headerIconUrl,
+                alt: "",
+                className: "skippr:size-4 skippr:object-contain"
+              }) : /* @__PURE__ */ jsx44(Sparkles, {
                 className: "skippr:size-4",
                 strokeWidth: ROW_ICON_STROKE,
                 "aria-hidden": true
@@ -12392,7 +12437,11 @@ function SplashPrimary({
             onClick: start,
             className: `${FOCUS_RING3} skippr:flex skippr:w-full skippr:cursor-pointer skippr:items-center skippr:justify-center skippr:gap-2 skippr:rounded-full skippr:bg-primary skippr:px-5 skippr:py-[13px] skippr:text-[16px] skippr:font-semibold skippr:text-primary-foreground skippr:transition-all skippr:hover:bg-primary/90`,
             children: [
-              /* @__PURE__ */ jsx45(Sparkles, {
+              headerIconUrl ? /* @__PURE__ */ jsx45("img", {
+                src: headerIconUrl,
+                alt: "",
+                className: "skippr:size-4 skippr:object-contain"
+              }) : /* @__PURE__ */ jsx45(Sparkles, {
                 className: "skippr:size-4",
                 strokeWidth: ROW_ICON_STROKE,
                 "aria-hidden": true
@@ -14762,6 +14811,8 @@ function LiveAgent(props) {
   const isLauncherRevealed = useOnceTrue(!isAwaitingModules);
   const {
     goals: adoptionGoals,
+    deepLinkedGoal,
+    hasTipSlug,
     hasResolved: hasResolvedAdoptionGoals,
     attendGoal
   } = useAdoptionGoals({
@@ -15012,9 +15063,15 @@ function LiveAgent(props) {
   }, [pendingStart, startAdoptionSession, selectModule, startDefaultSession]);
   useAutoStart({
     availableModules,
-    suppressed: isSessionLive || buddyActive,
+    deepLinkedGoal,
+    hasTipSlug,
+    adoptionResolved: hasResolvedAdoptionGoals,
+    suppressed: isSessionLive,
+    moduleSuppressed: buddyActive,
+    modulesResolved: hasResolvedModules,
     bearerToken,
-    selectModule
+    selectModule,
+    startAdoptionSession
   });
   useEffect51(() => {
     if (!autoStartAfterLogin)