@firstlovecenter/ai-chat 0.8.1 → 0.9.1

package/dist/{types-BnwUkqKb.d.cts → types-BOgBJ7CD.d.cts}

@@ -114,8 +114,14 @@ type SystemBlock = {
  * regardless of the chosen ORM.
  */
 
+/**
+ * Chat session and message identifiers are short URL-safe UIDs (12 chars,
+ * ~72 bits of entropy, alphabet matches nanoid's URL-safe set). The
+ * package generates them in `createSession`/`appendMessage` so adapters
+ * never need to know about auto-increment vs UID.
+ */
 type ChatSession = {
-    id: number;
+    id: string;
     userId: number;
     title: string;
     createdAt: Date;
@@ -129,8 +135,8 @@ type ChatMessageRole = 'user' | 'assistant';
  * narrator. `errorJson` is set when an assistant turn failed mid-stream.
  */
 type ChatMessage = {
-    id: number;
-    sessionId: number;
+    id: string;
+    sessionId: string;
     role: ChatMessageRole;
     question: string | null;
     blocks: unknown | null;
@@ -244,7 +250,7 @@ type CreateSessionInput = {
     title: string;
 };
 type AppendMessageInput = {
-    sessionId: number;
+    sessionId: string;
     role: ChatMessageRole;
     question?: string | null;
     blocks?: unknown | null;
@@ -277,15 +283,15 @@ type AiSettingsPatch = {
 type PersistencePort = {
     createSession(input: CreateSessionInput): Promise<ChatSession>;
     /** Returns null when the session doesn't exist OR doesn't belong to this user. */
-    getSession(id: number, userId: number): Promise<ChatSession | null>;
+    getSession(id: string, userId: number): Promise<ChatSession | null>;
     listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;
     /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */
-    updateSession(id: number, userId: number, patch: {
+    updateSession(id: string, userId: number, patch: {
         title?: string;
     }): Promise<void>;
-    deleteSession(id: number, userId: number): Promise<void>;
+    deleteSession(id: string, userId: number): Promise<void>;
     appendMessage(input: AppendMessageInput): Promise<ChatMessage>;
-    listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;
+    listMessagesForSession(sessionId: string, userId: number): Promise<ChatMessage[]>;
     /** Returns the singleton row, applying defaults if it's never been written. */
     getAiSettings(): Promise<AiSettings>;
     /**

package/dist/{types-BnwUkqKb.d.ts → types-BOgBJ7CD.d.ts}

@@ -114,8 +114,14 @@ type SystemBlock = {
  * regardless of the chosen ORM.
  */
 
+/**
+ * Chat session and message identifiers are short URL-safe UIDs (12 chars,
+ * ~72 bits of entropy, alphabet matches nanoid's URL-safe set). The
+ * package generates them in `createSession`/`appendMessage` so adapters
+ * never need to know about auto-increment vs UID.
+ */
 type ChatSession = {
-    id: number;
+    id: string;
     userId: number;
     title: string;
     createdAt: Date;
@@ -129,8 +135,8 @@ type ChatMessageRole = 'user' | 'assistant';
  * narrator. `errorJson` is set when an assistant turn failed mid-stream.
  */
 type ChatMessage = {
-    id: number;
-    sessionId: number;
+    id: string;
+    sessionId: string;
     role: ChatMessageRole;
     question: string | null;
     blocks: unknown | null;
@@ -244,7 +250,7 @@ type CreateSessionInput = {
     title: string;
 };
 type AppendMessageInput = {
-    sessionId: number;
+    sessionId: string;
     role: ChatMessageRole;
     question?: string | null;
     blocks?: unknown | null;
@@ -277,15 +283,15 @@ type AiSettingsPatch = {
 type PersistencePort = {
     createSession(input: CreateSessionInput): Promise<ChatSession>;
     /** Returns null when the session doesn't exist OR doesn't belong to this user. */
-    getSession(id: number, userId: number): Promise<ChatSession | null>;
+    getSession(id: string, userId: number): Promise<ChatSession | null>;
     listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;
     /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */
-    updateSession(id: number, userId: number, patch: {
+    updateSession(id: string, userId: number, patch: {
         title?: string;
     }): Promise<void>;
-    deleteSession(id: number, userId: number): Promise<void>;
+    deleteSession(id: string, userId: number): Promise<void>;
     appendMessage(input: AppendMessageInput): Promise<ChatMessage>;
-    listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;
+    listMessagesForSession(sessionId: string, userId: number): Promise<ChatMessage[]>;
     /** Returns the singleton row, applying defaults if it's never been written. */
     getAiSettings(): Promise<AiSettings>;
     /**

package/dist/ui/index.cjs

@@ -678,7 +678,8 @@ function AiChat({
   userFirstName,
   scopeLabel,
   initialProvider,
-  initialSessionId = null
+  initialSessionId = null,
+  basePath = "/chat"
 }) {
   const router = navigation.useRouter();
   const [sessions, setSessions] = React.useState([]);
@@ -768,16 +769,16 @@ function AiChat({
   }, []);
   const syncUrl = React.useCallback(
     (id) => {
-      router.push(id == null ? "/chat" : `/chat/${id}`);
+      router.push(id == null ? basePath : `${basePath}/${id}`);
     },
-    [router]
+    [router, basePath]
   );
   const newChat = React.useCallback(() => {
     setActiveSessionId(null);
     setAnswers([]);
     setQuestion("");
-    router.push("/chat?new");
-  }, [router]);
+    router.push(`${basePath}?new`);
+  }, [router, basePath]);
   const changeProvider = React.useCallback(
     async (next) => {
       if (next === provider || providerSaving) return;
@@ -1030,7 +1031,7 @@ function AiChat({
               /* @__PURE__ */ jsxRuntime.jsx(
                 Link__default.default,
                 {
-                  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",
@@ -1513,7 +1514,8 @@ function VercelChat({
   userFirstName,
   scopeLabel,
   initialProvider,
-  initialSessionId = null
+  initialSessionId = null,
+  basePath = "/chat"
 }) {
   const router = navigation.useRouter();
   const [sessions, setSessions] = React.useState([]);
@@ -1744,9 +1746,9 @@ function VercelChat({
   }, [answers.length]);
   const syncUrl = React.useCallback(
     (id) => {
-      router.push(id == null ? "/chat" : `/chat/${id}`);
+      router.push(id == null ? basePath : `${basePath}/${id}`);
     },
-    [router]
+    [router, basePath]
   );
   const newChat = React.useCallback(() => {
     setActiveSessionId(null);
@@ -1756,8 +1758,8 @@ function VercelChat({
     setHydratedErrors({});
     setStartedAt({});
     setInput("");
-    router.push("/chat?new");
-  }, [setMessages, setInput, router]);
+    router.push(`${basePath}?new`);
+  }, [setMessages, setInput, router, basePath]);
   const changeProvider = React.useCallback(
     async (next) => {
       if (next === provider || providerSaving) return;
@@ -1987,7 +1989,7 @@ function VercelChat({
               /* @__PURE__ */ jsxRuntime.jsx(
                 Link__default.default,
                 {
-                  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",