@firstlovecenter/ai-chat 0.9.0 → 0.9.2

package/dist/ui/index.d.cts

@@ -14,8 +14,15 @@ type AiChatProps$1 = {
      * conversation. `null` (or omitted) renders the empty new-chat state.
      */
     initialSessionId?: string | null;
+    /**
+     * URL prefix the chat is mounted at. Sidebar `<Link>`s and router
+     * pushes use this prefix so multiple chat surfaces (e.g. `/chat` and
+     * `/admin/ai`) can coexist without yanking users between shells.
+     * Defaults to `/chat`.
+     */
+    basePath?: string;
 };
-declare function AiChat({ userFirstName, scopeLabel, initialProvider, initialSessionId }: AiChatProps$1): react_jsx_runtime.JSX.Element;
+declare function AiChat({ userFirstName, scopeLabel, initialProvider, initialSessionId, basePath }: AiChatProps$1): react_jsx_runtime.JSX.Element;
 
 type AiChatSessionSummary = {
     id: string;
@@ -35,9 +42,18 @@ type AiChatProps = {
      * empty "new chat" state.
      */
     initialSessionId?: string | null;
+    /**
+     * URL prefix the chat surface is mounted at. Sidebar links resolve to
+     * `${basePath}/${sessionId}`, "+ New chat" goes to `${basePath}?new`,
+     * and the open-session push uses the same prefix. Defaults to `/chat`.
+     * Set to e.g. `/admin/ai` when embedding the chat inside another shell
+     * — the host then needs a matching `[id]` dynamic segment under that
+     * path so reload/bookmark URLs resolve.
+     */
+    basePath?: string;
 };
 
-declare function VercelChat({ userFirstName, scopeLabel, initialProvider, initialSessionId }: AiChatProps): react_jsx_runtime.JSX.Element;
+declare function VercelChat({ userFirstName, scopeLabel, initialProvider, initialSessionId, basePath }: AiChatProps): react_jsx_runtime.JSX.Element;
 
 type ChartSpec = {
     type: 'line' | 'bar' | 'stacked_bar' | 'pie';

package/dist/ui/index.d.ts

@@ -14,8 +14,15 @@ type AiChatProps$1 = {
      * conversation. `null` (or omitted) renders the empty new-chat state.
      */
     initialSessionId?: string | null;
+    /**
+     * URL prefix the chat is mounted at. Sidebar `<Link>`s and router
+     * pushes use this prefix so multiple chat surfaces (e.g. `/chat` and
+     * `/admin/ai`) can coexist without yanking users between shells.
+     * Defaults to `/chat`.
+     */
+    basePath?: string;
 };
-declare function AiChat({ userFirstName, scopeLabel, initialProvider, initialSessionId }: AiChatProps$1): react_jsx_runtime.JSX.Element;
+declare function AiChat({ userFirstName, scopeLabel, initialProvider, initialSessionId, basePath }: AiChatProps$1): react_jsx_runtime.JSX.Element;
 
 type AiChatSessionSummary = {
     id: string;
@@ -35,9 +42,18 @@ type AiChatProps = {
      * empty "new chat" state.
      */
     initialSessionId?: string | null;
+    /**
+     * URL prefix the chat surface is mounted at. Sidebar links resolve to
+     * `${basePath}/${sessionId}`, "+ New chat" goes to `${basePath}?new`,
+     * and the open-session push uses the same prefix. Defaults to `/chat`.
+     * Set to e.g. `/admin/ai` when embedding the chat inside another shell
+     * — the host then needs a matching `[id]` dynamic segment under that
+     * path so reload/bookmark URLs resolve.
+     */
+    basePath?: string;
 };
 
-declare function VercelChat({ userFirstName, scopeLabel, initialProvider, initialSessionId }: AiChatProps): react_jsx_runtime.JSX.Element;
+declare function VercelChat({ userFirstName, scopeLabel, initialProvider, initialSessionId, basePath }: AiChatProps): react_jsx_runtime.JSX.Element;
 
 type ChartSpec = {
     type: 'line' | 'bar' | 'stacked_bar' | 'pie';

package/dist/ui/index.js

@@ -654,7 +654,8 @@ function AiChat({
   userFirstName,
   scopeLabel,
   initialProvider,
-  initialSessionId = null
+  initialSessionId = null,
+  basePath = "/chat"
 }) {
   const router = useRouter();
   const [sessions, setSessions] = useState([]);
@@ -744,16 +745,16 @@ function AiChat({
   }, []);
   const syncUrl = useCallback(
     (id) => {
-      router.push(id == null ? "/chat" : `/chat/${id}`);
+      router.push(id == null ? basePath : `${basePath}/${id}`);
     },
-    [router]
+    [router, basePath]
   );
   const newChat = useCallback(() => {
     setActiveSessionId(null);
     setAnswers([]);
     setQuestion("");
-    router.push("/chat?new");
-  }, [router]);
+    router.push(`${basePath}?new`);
+  }, [router, basePath]);
   const changeProvider = useCallback(
     async (next) => {
       if (next === provider || providerSaving) return;
@@ -849,7 +850,9 @@ function AiChat({
             const data = await create.json();
             sessionId = data.session.id;
             setActiveSessionId(sessionId);
-            syncUrl(sessionId);
+            if (typeof window !== "undefined") {
+              window.history.replaceState(null, "", `${basePath}/${sessionId}`);
+            }
             setSessions((prev) => [
               { id: data.session.id, title: data.session.title, updatedAt: null },
               ...prev
@@ -911,6 +914,17 @@ function AiChat({
           const events = buffer.split("\n\n");
           buffer = events.pop() ?? "";
           for (const raw of events) {
+            const meta = parseMetaChatSessionId(raw);
+            if (meta != null) {
+              setActiveSessionId((prev) => prev ?? meta);
+              if (typeof window !== "undefined" && !window.location.pathname.endsWith(`/${meta}`)) {
+                window.history.replaceState(
+                  null,
+                  "",
+                  `${basePath}/${meta}`
+                );
+              }
+            }
             handleEvent(raw, setAnswers);
           }
         }
@@ -1006,7 +1020,7 @@ function AiChat({
               /* @__PURE__ */ jsx(
                 Link,
                 {
-                  href: `/chat/${s.id}`,
+                  href: `${basePath}/${s.id}`,
                   onClick: () => setSidebarOpen(false),
                   className: cn(
                     "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm",
@@ -1369,6 +1383,22 @@ function UserChip({ text }) {
     )
   ] });
 }
+function parseMetaChatSessionId(raw) {
+  const lines = raw.split("\n");
+  let event = "";
+  let dataStr = "";
+  for (const line of lines) {
+    if (line.startsWith("event: ")) event = line.slice(7).trim();
+    else if (line.startsWith("data: ")) dataStr += line.slice(6);
+  }
+  if (event !== "meta") return null;
+  try {
+    const parsed = JSON.parse(dataStr || "{}");
+    return typeof parsed.chatSessionId === "string" && parsed.chatSessionId.length > 0 ? parsed.chatSessionId : null;
+  } catch {
+    return null;
+  }
+}
 function handleEvent(raw, setAnswers) {
   const lines = raw.split("\n");
   let event = "";
@@ -1489,7 +1519,8 @@ function VercelChat({
   userFirstName,
   scopeLabel,
   initialProvider,
-  initialSessionId = null
+  initialSessionId = null,
+  basePath = "/chat"
 }) {
   const router = useRouter();
   const [sessions, setSessions] = useState([]);
@@ -1620,6 +1651,20 @@ function VercelChat({
       cancelled = true;
     };
   }, [initialSessionId, setMessages]);
+  useEffect(() => {
+    if (!Array.isArray(data)) return;
+    for (const raw of data) {
+      const part = asDataPart(raw);
+      if (!part || part.type !== "meta") continue;
+      const id = part.value.chatSessionId;
+      if (!id) continue;
+      setActiveSessionId((prev) => prev ?? id);
+      if (typeof window !== "undefined" && !window.location.pathname.endsWith(`/${id}`)) {
+        window.history.replaceState(null, "", `${basePath}/${id}`);
+      }
+      break;
+    }
+  }, [data, basePath]);
   const answers = useMemo(() => {
     const liveBlocks = [];
     const liveErrors = [];
@@ -1720,9 +1765,9 @@ function VercelChat({
   }, [answers.length]);
   const syncUrl = useCallback(
     (id) => {
-      router.push(id == null ? "/chat" : `/chat/${id}`);
+      router.push(id == null ? basePath : `${basePath}/${id}`);
     },
-    [router]
+    [router, basePath]
   );
   const newChat = useCallback(() => {
     setActiveSessionId(null);
@@ -1732,8 +1777,8 @@ function VercelChat({
     setHydratedErrors({});
     setStartedAt({});
     setInput("");
-    router.push("/chat?new");
-  }, [setMessages, setInput, router]);
+    router.push(`${basePath}?new`);
+  }, [setMessages, setInput, router, basePath]);
   const changeProvider = useCallback(
     async (next) => {
       if (next === provider || providerSaving) return;
@@ -1842,7 +1887,13 @@ function VercelChat({
             const json = await create.json();
             activeSessionIdRef.current = json.session.id;
             setActiveSessionId(json.session.id);
-            syncUrl(json.session.id);
+            if (typeof window !== "undefined") {
+              window.history.replaceState(
+                null,
+                "",
+                `${basePath}/${json.session.id}`
+              );
+            }
             setSessions((prev) => [
               { id: json.session.id, title: json.session.title, updatedAt: null },
               ...prev
@@ -1963,7 +2014,7 @@ function VercelChat({
               /* @__PURE__ */ jsx(
                 Link,
                 {
-                  href: `/chat/${s.id}`,
+                  href: `${basePath}/${s.id}`,
                   onClick: () => setSidebarOpen(false),
                   className: cn(
                     "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm",