@cstar.help/react 0.6.1 → 0.8.0

package/README.md

@@ -24,7 +24,7 @@ import { CStarChatProvider } from '@cstar.help/react';
 
 function App() {
 	return (
-		<CStarChatProvider teamSlug="acme" supabaseUrl="..." supabaseAnonKey="...">
+		<CStarChatProvider teamSlug="acme">
 			<ChatWidget />
 		</CStarChatProvider>
 	);
@@ -47,24 +47,24 @@ function ChatWidget() {
 	}, []);
 
 	if (!isIdentified) return <p>Connecting...</p>;
-	return <ConversationList />;
+	return <TicketList />;
 }
 ```
 
-### Conversations
+### Tickets
 
 ```tsx
-import { useConversations } from '@cstar.help/react';
+import { useTickets } from '@cstar.help/react';
 
-function ConversationList() {
-	const { conversations, isLoading, create, refresh, hasMore } = useConversations();
+function TicketList() {
+	const { tickets, isLoading, create, refresh, hasMore } = useTickets();
 
 	if (isLoading) return <Spinner />;
 
 	return (
 		<ul>
-			{conversations.map((c) => (
-				<li key={c.id}>{c.subject}</li>
+			{tickets.map((t) => (
+				<li key={t.id}>{t.subject}</li>
 			))}
 		</ul>
 	);
@@ -270,7 +270,7 @@ function CommunitySearch() {
 | Hook                    | Returns                                                          | Description                                          |
 | ----------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- |
 | `useChat()`             | `{ identify, disconnect, isIdentified, isRealtimeReady, error }` | Identity verification and connection state           |
-| `useConversations()`    | `{ conversations, isLoading, error, hasMore, refresh, create }`  | List and create conversations                        |
+| `useTickets()`          | `{ tickets, isLoading, error, hasMore, refresh, create }`        | List and create tickets                              |
 | `useMessages(ticketId)` | `{ messages, isLoading, error, send, refresh }`                  | Messages with real-time updates and optimistic send  |
 | `useTyping(ticketId)`   | `{ typingAgents, sendTyping }`                                   | Agent typing indicators with auto-clear (4s timeout) |
 

package/dist/index.cjs

@@ -39,7 +39,6 @@ __export(src_exports, {
   useChatClient: () => useChatClient,
   useCommunityClient: () => useCommunityClient,
   useCommunitySearch: () => useCommunitySearch,
-  useConversations: () => useConversations,
   useDashboardClient: () => useDashboardClient,
   useGameActivity: () => useGameActivity,
   useLeaderboard: () => useLeaderboard,
@@ -48,6 +47,7 @@ __export(src_exports, {
   usePlayerStats: () => usePlayerStats,
   usePost: () => usePost,
   usePosts: () => usePosts,
+  useTickets: () => useTickets,
   useTopics: () => useTopics,
   useTyping: () => useTyping
 });
@@ -102,19 +102,26 @@ function CStarChatProvider({ children, ...config }) {
 var import_react3 = require("react");
 function useChat() {
   const client = useChatClient();
-  const [isIdentified, setIsIdentified] = (0, import_react3.useState)(false);
+  const [isAuthenticated, setIsAuthenticated] = (0, import_react3.useState)(false);
+  const [authMode, setAuthMode] = (0, import_react3.useState)(() => client.getAuthMode());
   const [isRealtimeReady, setIsRealtimeReady] = (0, import_react3.useState)(false);
   const [error, setError] = (0, import_react3.useState)(null);
+  (0, import_react3.useEffect)(() => {
+    const current = client.getAuthMode();
+    if (current !== authMode) setAuthMode(current);
+  }, [client, authMode]);
+  const wireRealtime = (0, import_react3.useCallback)(() => {
+    client.waitForRealtime().then(() => setIsRealtimeReady(true)).catch(() => {
+    });
+  }, [client]);
   const identify = (0, import_react3.useCallback)(
     async (customer, signature) => {
       setError(null);
       try {
         const result = await client.identify(customer, signature);
-        setIsIdentified(true);
-        client.waitForRealtime().then(() => {
-          setIsRealtimeReady(true);
-        }).catch(() => {
-        });
+        setIsAuthenticated(true);
+        setAuthMode(client.getAuthMode());
+        wireRealtime();
         return result;
       } catch (err) {
         const e = err instanceof Error ? err : new Error(String(err));
@@ -122,22 +129,66 @@ function useChat() {
         throw e;
       }
     },
-    [client]
+    [client, wireRealtime]
+  );
+  const loginWithCredentials = (0, import_react3.useCallback)(
+    async (params) => {
+      setError(null);
+      try {
+        const result = await client.loginWithCredentials(params);
+        setIsAuthenticated(true);
+        setAuthMode(client.getAuthMode());
+        wireRealtime();
+        return result;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      }
+    },
+    [client, wireRealtime]
+  );
+  const loginWithSession = (0, import_react3.useCallback)(
+    async (params) => {
+      setError(null);
+      try {
+        await client.loginWithSession(params);
+        setIsAuthenticated(true);
+        setAuthMode(client.getAuthMode());
+        wireRealtime();
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      }
+    },
+    [client, wireRealtime]
   );
   const disconnect = (0, import_react3.useCallback)(() => {
     client.disconnect();
-    setIsIdentified(false);
+    setIsAuthenticated(false);
+    setAuthMode(null);
     setIsRealtimeReady(false);
     setError(null);
   }, [client]);
-  return { identify, disconnect, isIdentified, isRealtimeReady, error };
+  return {
+    identify,
+    loginWithCredentials,
+    loginWithSession,
+    disconnect,
+    isIdentified: isAuthenticated,
+    isAuthenticated,
+    authMode,
+    isRealtimeReady,
+    error
+  };
 }
 
-// src/chat/useConversations.ts
+// src/chat/useTickets.ts
 var import_react4 = require("react");
-function useConversations() {
+function useTickets() {
   const client = useChatClient();
-  const [conversations, setConversations] = (0, import_react4.useState)([]);
+  const [tickets, setTickets] = (0, import_react4.useState)([]);
   const [isLoading, setIsLoading] = (0, import_react4.useState)(true);
   const [error, setError] = (0, import_react4.useState)(null);
   const [hasMore, setHasMore] = (0, import_react4.useState)(false);
@@ -146,9 +197,9 @@ function useConversations() {
     setIsLoading(true);
     setError(null);
     try {
-      const result = await client.conversations.list();
+      const result = await client.tickets.list();
       if (mountedRef.current) {
-        setConversations(result.conversations);
+        setTickets(result.tickets);
         setHasMore(result.hasMore);
       }
     } catch (err) {
@@ -170,15 +221,15 @@ function useConversations() {
   }, [refresh]);
   const create = (0, import_react4.useCallback)(
     async (params) => {
-      const conversation = await client.conversations.create(params);
+      const ticket = await client.tickets.create(params);
       if (mountedRef.current) {
-        setConversations((prev) => [conversation, ...prev]);
+        setTickets((prev) => [ticket, ...prev]);
       }
-      return conversation;
+      return ticket;
     },
     [client]
   );
-  return { conversations, isLoading, error, hasMore, refresh, create };
+  return { tickets, isLoading, error, hasMore, refresh, create };
 }
 
 // src/chat/useMessages.ts
@@ -241,7 +292,7 @@ function useMessages(ticketId) {
   }, [client, ticketId, refresh]);
   const send = (0, import_react5.useCallback)(
     async (content) => {
-      if (!ticketId) throw new Error("No conversation selected");
+      if (!ticketId) throw new Error("No ticket selected");
       const optimistic = {
         id: `optimistic-${Date.now()}`,
         content,
@@ -679,10 +730,15 @@ var import_react17 = require("react");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var CStarDashboardContext = (0, import_react17.createContext)(null);
 function CStarDashboardProvider({ client, children }) {
+  if (!client) {
+    throw new Error(
+      "CStarDashboardProvider requires a `client` prop. Build it server-side with `new CStarClient({ apiKey: process.env.CSTAR_API_KEY, teamId })` and pass via SSR. See https://cstar.help/developers/sdk/react#dashboard"
+    );
+  }
   const contextValue = (0, import_react17.useRef)({ client }).current;
   (0, import_react17.useEffect)(() => {
     return () => {
-      client.realtime.disconnect();
+      client?.realtime?.disconnect?.();
     };
   }, [client]);
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(CStarDashboardContext.Provider, { value: contextValue, children });
@@ -754,7 +810,8 @@ function resolveMutation(client, path) {
   const methodName = parts[1];
   const resource = client[resourceName];
   if (!resource || typeof resource !== "object") return null;
-  const method = resource[methodName];
+  const lookupName = methodName === "delete" ? "del" : methodName;
+  const method = resource[lookupName];
   if (typeof method !== "function") return null;
   if (methodName === "update") {
     return (params) => {
@@ -982,7 +1039,6 @@ function useGameActivity() {
   useChatClient,
   useCommunityClient,
   useCommunitySearch,
-  useConversations,
   useDashboardClient,
   useGameActivity,
   useLeaderboard,
@@ -991,6 +1047,7 @@ function useGameActivity() {
   usePlayerStats,
   usePost,
   usePosts,
+  useTickets,
   useTopics,
   useTyping
 });

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
-import { ChatClient, ChatConfig, IdentifyParams, IdentifyResult, Conversation, ConversationCreateParams, WidgetMessage } from '@cstar.help/js/chat';
-export { ChatConfig, Conversation, ConversationCreateParams, ConversationListResponse, IdentifyParams, IdentifyResult, TypingPayload, WidgetMessage } from '@cstar.help/js/chat';
+import { ChatClient, ChatConfig, IdentifyParams, IdentifyResult, LoginWithCredentialsParams, LoginWithCredentialsResult, LoginWithSessionParams, ChatAuthMode, Ticket, TicketCreateParams, Message } from '@cstar.help/js/chat';
+export { ChatConfig, IdentifyParams, IdentifyResult, Message, Ticket, TicketCreateParams, TicketListResponse, TypingPayload } from '@cstar.help/js/chat';
 import { LibraryClient, LibraryConfig, Category, LibraryArticle, LibraryArticleListParams } from '@cstar.help/js/library';
 export { Category, LibraryArticle, LibraryArticleListParams, LibraryConfig, LibrarySearchParams, LibrarySearchResult } from '@cstar.help/js/library';
 import { CommunityClient, CommunityConfig, CommunityTopic, CommunityPost, CommunityPostListParams, CommunityPostDetail, CommunitySearchResult } from '@cstar.help/js/community';
@@ -36,7 +36,7 @@ interface CStarChatProviderProps extends ChatConfig {
  * Creates the client on mount and disconnects on unmount.
  *
  * ```tsx
- * <CStarChatProvider teamSlug="acme" supabaseUrl="..." supabaseAnonKey="...">
+ * <CStarChatProvider teamSlug="acme">
  *   <ChatWidget />
  * </CStarChatProvider>
  * ```
@@ -46,66 +46,99 @@ declare function CStarChatProvider({ children, ...config }: CStarChatProviderPro
 interface UseChatReturn {
     /** Identify a customer with HMAC signature. */
     identify: (customer: IdentifyParams, signature: string) => Promise<IdentifyResult>;
+    /**
+     * Log in with cStar's hosted password auth (no separate auth backend
+     * required). Updates `isAuthenticated` and `authMode` to `'session'`.
+     */
+    loginWithCredentials: (params: LoginWithCredentialsParams) => Promise<LoginWithCredentialsResult>;
+    /**
+     * Use an existing Supabase access token (e.g. forwarded from your own
+     * auth). Updates `isAuthenticated` and `authMode` to `'session'`.
+     */
+    loginWithSession: (params: LoginWithSessionParams) => Promise<void>;
     /** Disconnect the client and clean up all subscriptions. */
     disconnect: () => void;
-    /** Whether a customer has been successfully identified. */
+    /**
+     * `true` once the client has authenticated through any of the four modes
+     * (HMAC `identify`, credentials login, session login, or anonymous). Use
+     * this for "is the customer signed in?" branches.
+     *
+     * @deprecated since 0.8.0 — use `isAuthenticated`. Kept as an alias.
+     */
     isIdentified: boolean;
-    /** Whether the Supabase Realtime connection is ready. */
+    /** Same as `isIdentified` — kept under the more accurate name. */
+    isAuthenticated: boolean;
+    /**
+     * The auth mode the underlying ChatClient is using right now. `null`
+     * before any auth call has resolved (or after `disconnect()`).
+     */
+    authMode: ChatAuthMode | null;
+    /** Whether the real-time connection is ready. */
     isRealtimeReady: boolean;
-    /** The last error from identify, or null. */
+    /** The last error from any auth call, or null. */
     error: Error | null;
 }
 /**
- * Core chat hook — manages identity verification and realtime readiness.
+ * Core chat hook — manages identity verification (any of four auth modes)
+ * and realtime readiness. Closes F-041 / F-044: previously the hook only
+ * tracked HMAC `identify()` and ignored `loginWithCredentials` /
+ * `loginWithSession`, leaving consumer UI stuck on the unauthenticated
+ * branch even after a successful session login.
  *
  * ```tsx
- * const { identify, disconnect, isIdentified, isRealtimeReady, error } = useChat();
+ * const { identify, loginWithCredentials, isAuthenticated, authMode } = useChat();
  *
  * await identify(
  *   { externalId: 'usr_123', email: 'jane@co.com', timestamp: Date.now() / 1000 },
  *   hmacSignature
  * );
+ * // OR
+ * await loginWithCredentials({ email: 'jane@co.com', password: 'hunter2' });
+ *
+ * if (isAuthenticated && authMode === 'session') {
+ *   // show "Sign out" button
+ * }
  * ```
  */
 declare function useChat(): UseChatReturn;
 
-interface UseConversationsReturn {
-    /** List of conversations for the identified customer. */
-    conversations: Conversation[];
+interface UseTicketsReturn {
+    /** List of tickets for the identified customer. */
+    tickets: Ticket[];
     /** Whether the initial fetch is in progress. */
     isLoading: boolean;
     /** The last error, or null. */
     error: Error | null;
-    /** Whether there are more conversations to load. */
+    /** Whether there are more tickets to load. */
     hasMore: boolean;
-    /** Re-fetch the conversation list. */
+    /** Re-fetch the ticket list. */
     refresh: () => Promise<void>;
-    /** Create a new conversation. */
-    create: (params: ConversationCreateParams) => Promise<Conversation>;
+    /** Create a new ticket. */
+    create: (params: TicketCreateParams) => Promise<Ticket>;
 }
 /**
- * Manage the customer's conversation list.
+ * Manage the customer's ticket list.
  *
  * ```tsx
- * const { conversations, isLoading, create, refresh } = useConversations();
+ * const { tickets, isLoading, create, refresh } = useTickets();
  * ```
  */
-declare function useConversations(): UseConversationsReturn;
+declare function useTickets(): UseTicketsReturn;
 
 interface UseMessagesReturn {
-    /** Messages in the conversation, oldest first. */
-    messages: WidgetMessage[];
+    /** Messages on the ticket, oldest first. */
+    messages: Message[];
     /** Whether the initial fetch is in progress. */
     isLoading: boolean;
     /** The last error, or null. */
     error: Error | null;
     /** Send a message. Optimistically appended, replaced with server response. */
-    send: (content: string) => Promise<WidgetMessage>;
+    send: (content: string) => Promise<Message>;
     /** Re-fetch messages from the API. */
     refresh: () => Promise<void>;
 }
 /**
- * Manage messages for a single conversation with automatic real-time updates.
+ * Manage messages for a single ticket with automatic real-time updates.
  *
  * ```tsx
  * const { messages, isLoading, send } = useMessages(ticketId);
@@ -125,7 +158,7 @@ interface UseTypingReturn {
     sendTyping: (isTyping: boolean) => Promise<void>;
 }
 /**
- * Track agent typing indicators for a conversation.
+ * Track agent typing indicators for a ticket.
  *
  * ```tsx
  * const { typingAgents, sendTyping } = useTyping(ticketId);
@@ -477,4 +510,4 @@ interface UseGameActivityReturn {
  */
 declare function useGameActivity(): UseGameActivityReturn;
 
-export { CStarChatContext, CStarChatProvider, type CStarChatProviderProps, CStarCommunityContext, CStarCommunityProvider, type CStarCommunityProviderProps, CStarDashboardProvider, type CStarDashboardProviderProps, CStarLibraryContext, CStarLibraryProvider, type CStarLibraryProviderProps, type TypingAgent, type UseArticleReturn, type UseArticleSearchReturn, type UseArticlesReturn, type UseBossBattleReturn, type UseCStarEventsReturn, type UseCStarMutationReturn, type UseCStarQueryReturn, type UseCategoriesReturn, type UseChatReturn, type UseCommunitySearchReturn, type UseConversationsReturn, type UseGameActivityReturn, type UseLeaderboardReturn, type UseMessagesReturn, type UsePlayerStatsReturn, type UsePostReturn, type UsePostsReturn, type UseTopicsReturn, type UseTypingReturn, useArticle, useArticleSearch, useArticles, useBossBattle, useCStarEvents, useCStarMutation, useCStarQuery, useCategories, useChat, useChatClient, useCommunityClient, useCommunitySearch, useConversations, useDashboardClient, useGameActivity, useLeaderboard, useLibraryClient, useMessages, usePlayerStats, usePost, usePosts, useTopics, useTyping };
+export { CStarChatContext, CStarChatProvider, type CStarChatProviderProps, CStarCommunityContext, CStarCommunityProvider, type CStarCommunityProviderProps, CStarDashboardProvider, type CStarDashboardProviderProps, CStarLibraryContext, CStarLibraryProvider, type CStarLibraryProviderProps, type TypingAgent, type UseArticleReturn, type UseArticleSearchReturn, type UseArticlesReturn, type UseBossBattleReturn, type UseCStarEventsReturn, type UseCStarMutationReturn, type UseCStarQueryReturn, type UseCategoriesReturn, type UseChatReturn, type UseCommunitySearchReturn, type UseGameActivityReturn, type UseLeaderboardReturn, type UseMessagesReturn, type UsePlayerStatsReturn, type UsePostReturn, type UsePostsReturn, type UseTicketsReturn, type UseTopicsReturn, type UseTypingReturn, useArticle, useArticleSearch, useArticles, useBossBattle, useCStarEvents, useCStarMutation, useCStarQuery, useCategories, useChat, useChatClient, useCommunityClient, useCommunitySearch, useDashboardClient, useGameActivity, useLeaderboard, useLibraryClient, useMessages, usePlayerStats, usePost, usePosts, useTickets, useTopics, useTyping };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
-import { ChatClient, ChatConfig, IdentifyParams, IdentifyResult, Conversation, ConversationCreateParams, WidgetMessage } from '@cstar.help/js/chat';
-export { ChatConfig, Conversation, ConversationCreateParams, ConversationListResponse, IdentifyParams, IdentifyResult, TypingPayload, WidgetMessage } from '@cstar.help/js/chat';
+import { ChatClient, ChatConfig, IdentifyParams, IdentifyResult, LoginWithCredentialsParams, LoginWithCredentialsResult, LoginWithSessionParams, ChatAuthMode, Ticket, TicketCreateParams, Message } from '@cstar.help/js/chat';
+export { ChatConfig, IdentifyParams, IdentifyResult, Message, Ticket, TicketCreateParams, TicketListResponse, TypingPayload } from '@cstar.help/js/chat';
 import { LibraryClient, LibraryConfig, Category, LibraryArticle, LibraryArticleListParams } from '@cstar.help/js/library';
 export { Category, LibraryArticle, LibraryArticleListParams, LibraryConfig, LibrarySearchParams, LibrarySearchResult } from '@cstar.help/js/library';
 import { CommunityClient, CommunityConfig, CommunityTopic, CommunityPost, CommunityPostListParams, CommunityPostDetail, CommunitySearchResult } from '@cstar.help/js/community';
@@ -36,7 +36,7 @@ interface CStarChatProviderProps extends ChatConfig {
  * Creates the client on mount and disconnects on unmount.
  *
  * ```tsx
- * <CStarChatProvider teamSlug="acme" supabaseUrl="..." supabaseAnonKey="...">
+ * <CStarChatProvider teamSlug="acme">
  *   <ChatWidget />
  * </CStarChatProvider>
  * ```
@@ -46,66 +46,99 @@ declare function CStarChatProvider({ children, ...config }: CStarChatProviderPro
 interface UseChatReturn {
     /** Identify a customer with HMAC signature. */
     identify: (customer: IdentifyParams, signature: string) => Promise<IdentifyResult>;
+    /**
+     * Log in with cStar's hosted password auth (no separate auth backend
+     * required). Updates `isAuthenticated` and `authMode` to `'session'`.
+     */
+    loginWithCredentials: (params: LoginWithCredentialsParams) => Promise<LoginWithCredentialsResult>;
+    /**
+     * Use an existing Supabase access token (e.g. forwarded from your own
+     * auth). Updates `isAuthenticated` and `authMode` to `'session'`.
+     */
+    loginWithSession: (params: LoginWithSessionParams) => Promise<void>;
     /** Disconnect the client and clean up all subscriptions. */
     disconnect: () => void;
-    /** Whether a customer has been successfully identified. */
+    /**
+     * `true` once the client has authenticated through any of the four modes
+     * (HMAC `identify`, credentials login, session login, or anonymous). Use
+     * this for "is the customer signed in?" branches.
+     *
+     * @deprecated since 0.8.0 — use `isAuthenticated`. Kept as an alias.
+     */
     isIdentified: boolean;
-    /** Whether the Supabase Realtime connection is ready. */
+    /** Same as `isIdentified` — kept under the more accurate name. */
+    isAuthenticated: boolean;
+    /**
+     * The auth mode the underlying ChatClient is using right now. `null`
+     * before any auth call has resolved (or after `disconnect()`).
+     */
+    authMode: ChatAuthMode | null;
+    /** Whether the real-time connection is ready. */
     isRealtimeReady: boolean;
-    /** The last error from identify, or null. */
+    /** The last error from any auth call, or null. */
     error: Error | null;
 }
 /**
- * Core chat hook — manages identity verification and realtime readiness.
+ * Core chat hook — manages identity verification (any of four auth modes)
+ * and realtime readiness. Closes F-041 / F-044: previously the hook only
+ * tracked HMAC `identify()` and ignored `loginWithCredentials` /
+ * `loginWithSession`, leaving consumer UI stuck on the unauthenticated
+ * branch even after a successful session login.
  *
  * ```tsx
- * const { identify, disconnect, isIdentified, isRealtimeReady, error } = useChat();
+ * const { identify, loginWithCredentials, isAuthenticated, authMode } = useChat();
  *
  * await identify(
  *   { externalId: 'usr_123', email: 'jane@co.com', timestamp: Date.now() / 1000 },
  *   hmacSignature
  * );
+ * // OR
+ * await loginWithCredentials({ email: 'jane@co.com', password: 'hunter2' });
+ *
+ * if (isAuthenticated && authMode === 'session') {
+ *   // show "Sign out" button
+ * }
  * ```
  */
 declare function useChat(): UseChatReturn;
 
-interface UseConversationsReturn {
-    /** List of conversations for the identified customer. */
-    conversations: Conversation[];
+interface UseTicketsReturn {
+    /** List of tickets for the identified customer. */
+    tickets: Ticket[];
     /** Whether the initial fetch is in progress. */
     isLoading: boolean;
     /** The last error, or null. */
     error: Error | null;
-    /** Whether there are more conversations to load. */
+    /** Whether there are more tickets to load. */
     hasMore: boolean;
-    /** Re-fetch the conversation list. */
+    /** Re-fetch the ticket list. */
     refresh: () => Promise<void>;
-    /** Create a new conversation. */
-    create: (params: ConversationCreateParams) => Promise<Conversation>;
+    /** Create a new ticket. */
+    create: (params: TicketCreateParams) => Promise<Ticket>;
 }
 /**
- * Manage the customer's conversation list.
+ * Manage the customer's ticket list.
  *
  * ```tsx
- * const { conversations, isLoading, create, refresh } = useConversations();
+ * const { tickets, isLoading, create, refresh } = useTickets();
  * ```
  */
-declare function useConversations(): UseConversationsReturn;
+declare function useTickets(): UseTicketsReturn;
 
 interface UseMessagesReturn {
-    /** Messages in the conversation, oldest first. */
-    messages: WidgetMessage[];
+    /** Messages on the ticket, oldest first. */
+    messages: Message[];
     /** Whether the initial fetch is in progress. */
     isLoading: boolean;
     /** The last error, or null. */
     error: Error | null;
     /** Send a message. Optimistically appended, replaced with server response. */
-    send: (content: string) => Promise<WidgetMessage>;
+    send: (content: string) => Promise<Message>;
     /** Re-fetch messages from the API. */
     refresh: () => Promise<void>;
 }
 /**
- * Manage messages for a single conversation with automatic real-time updates.
+ * Manage messages for a single ticket with automatic real-time updates.
  *
  * ```tsx
  * const { messages, isLoading, send } = useMessages(ticketId);
@@ -125,7 +158,7 @@ interface UseTypingReturn {
     sendTyping: (isTyping: boolean) => Promise<void>;
 }
 /**
- * Track agent typing indicators for a conversation.
+ * Track agent typing indicators for a ticket.
  *
  * ```tsx
  * const { typingAgents, sendTyping } = useTyping(ticketId);
@@ -477,4 +510,4 @@ interface UseGameActivityReturn {
  */
 declare function useGameActivity(): UseGameActivityReturn;
 
-export { CStarChatContext, CStarChatProvider, type CStarChatProviderProps, CStarCommunityContext, CStarCommunityProvider, type CStarCommunityProviderProps, CStarDashboardProvider, type CStarDashboardProviderProps, CStarLibraryContext, CStarLibraryProvider, type CStarLibraryProviderProps, type TypingAgent, type UseArticleReturn, type UseArticleSearchReturn, type UseArticlesReturn, type UseBossBattleReturn, type UseCStarEventsReturn, type UseCStarMutationReturn, type UseCStarQueryReturn, type UseCategoriesReturn, type UseChatReturn, type UseCommunitySearchReturn, type UseConversationsReturn, type UseGameActivityReturn, type UseLeaderboardReturn, type UseMessagesReturn, type UsePlayerStatsReturn, type UsePostReturn, type UsePostsReturn, type UseTopicsReturn, type UseTypingReturn, useArticle, useArticleSearch, useArticles, useBossBattle, useCStarEvents, useCStarMutation, useCStarQuery, useCategories, useChat, useChatClient, useCommunityClient, useCommunitySearch, useConversations, useDashboardClient, useGameActivity, useLeaderboard, useLibraryClient, useMessages, usePlayerStats, usePost, usePosts, useTopics, useTyping };
+export { CStarChatContext, CStarChatProvider, type CStarChatProviderProps, CStarCommunityContext, CStarCommunityProvider, type CStarCommunityProviderProps, CStarDashboardProvider, type CStarDashboardProviderProps, CStarLibraryContext, CStarLibraryProvider, type CStarLibraryProviderProps, type TypingAgent, type UseArticleReturn, type UseArticleSearchReturn, type UseArticlesReturn, type UseBossBattleReturn, type UseCStarEventsReturn, type UseCStarMutationReturn, type UseCStarQueryReturn, type UseCategoriesReturn, type UseChatReturn, type UseCommunitySearchReturn, type UseGameActivityReturn, type UseLeaderboardReturn, type UseMessagesReturn, type UsePlayerStatsReturn, type UsePostReturn, type UsePostsReturn, type UseTicketsReturn, type UseTopicsReturn, type UseTypingReturn, useArticle, useArticleSearch, useArticles, useBossBattle, useCStarEvents, useCStarMutation, useCStarQuery, useCategories, useChat, useChatClient, useCommunityClient, useCommunitySearch, useDashboardClient, useGameActivity, useLeaderboard, useLibraryClient, useMessages, usePlayerStats, usePost, usePosts, useTickets, useTopics, useTyping };

package/dist/index.js

@@ -44,22 +44,29 @@ function CStarChatProvider({ children, ...config }) {
 }
 
 // src/chat/useChat.ts
-import { useState, useCallback } from "react";
+import { useState, useCallback, useEffect as useEffect2 } from "react";
 function useChat() {
   const client = useChatClient();
-  const [isIdentified, setIsIdentified] = useState(false);
+  const [isAuthenticated, setIsAuthenticated] = useState(false);
+  const [authMode, setAuthMode] = useState(() => client.getAuthMode());
   const [isRealtimeReady, setIsRealtimeReady] = useState(false);
   const [error, setError] = useState(null);
+  useEffect2(() => {
+    const current = client.getAuthMode();
+    if (current !== authMode) setAuthMode(current);
+  }, [client, authMode]);
+  const wireRealtime = useCallback(() => {
+    client.waitForRealtime().then(() => setIsRealtimeReady(true)).catch(() => {
+    });
+  }, [client]);
   const identify = useCallback(
     async (customer, signature) => {
       setError(null);
       try {
         const result = await client.identify(customer, signature);
-        setIsIdentified(true);
-        client.waitForRealtime().then(() => {
-          setIsRealtimeReady(true);
-        }).catch(() => {
-        });
+        setIsAuthenticated(true);
+        setAuthMode(client.getAuthMode());
+        wireRealtime();
         return result;
       } catch (err) {
         const e = err instanceof Error ? err : new Error(String(err));
@@ -67,22 +74,66 @@ function useChat() {
         throw e;
       }
     },
-    [client]
+    [client, wireRealtime]
+  );
+  const loginWithCredentials = useCallback(
+    async (params) => {
+      setError(null);
+      try {
+        const result = await client.loginWithCredentials(params);
+        setIsAuthenticated(true);
+        setAuthMode(client.getAuthMode());
+        wireRealtime();
+        return result;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      }
+    },
+    [client, wireRealtime]
+  );
+  const loginWithSession = useCallback(
+    async (params) => {
+      setError(null);
+      try {
+        await client.loginWithSession(params);
+        setIsAuthenticated(true);
+        setAuthMode(client.getAuthMode());
+        wireRealtime();
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      }
+    },
+    [client, wireRealtime]
   );
   const disconnect = useCallback(() => {
     client.disconnect();
-    setIsIdentified(false);
+    setIsAuthenticated(false);
+    setAuthMode(null);
     setIsRealtimeReady(false);
     setError(null);
   }, [client]);
-  return { identify, disconnect, isIdentified, isRealtimeReady, error };
+  return {
+    identify,
+    loginWithCredentials,
+    loginWithSession,
+    disconnect,
+    isIdentified: isAuthenticated,
+    isAuthenticated,
+    authMode,
+    isRealtimeReady,
+    error
+  };
 }
 
-// src/chat/useConversations.ts
-import { useState as useState2, useEffect as useEffect2, useCallback as useCallback2, useRef as useRef2 } from "react";
-function useConversations() {
+// src/chat/useTickets.ts
+import { useState as useState2, useEffect as useEffect3, useCallback as useCallback2, useRef as useRef2 } from "react";
+function useTickets() {
   const client = useChatClient();
-  const [conversations, setConversations] = useState2([]);
+  const [tickets, setTickets] = useState2([]);
   const [isLoading, setIsLoading] = useState2(true);
   const [error, setError] = useState2(null);
   const [hasMore, setHasMore] = useState2(false);
@@ -91,9 +142,9 @@ function useConversations() {
     setIsLoading(true);
     setError(null);
     try {
-      const result = await client.conversations.list();
+      const result = await client.tickets.list();
       if (mountedRef.current) {
-        setConversations(result.conversations);
+        setTickets(result.tickets);
         setHasMore(result.hasMore);
       }
     } catch (err) {
@@ -106,7 +157,7 @@ function useConversations() {
       }
     }
   }, [client]);
-  useEffect2(() => {
+  useEffect3(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -115,19 +166,19 @@ function useConversations() {
   }, [refresh]);
   const create = useCallback2(
     async (params) => {
-      const conversation = await client.conversations.create(params);
+      const ticket = await client.tickets.create(params);
       if (mountedRef.current) {
-        setConversations((prev) => [conversation, ...prev]);
+        setTickets((prev) => [ticket, ...prev]);
       }
-      return conversation;
+      return ticket;
     },
     [client]
   );
-  return { conversations, isLoading, error, hasMore, refresh, create };
+  return { tickets, isLoading, error, hasMore, refresh, create };
 }
 
 // src/chat/useMessages.ts
-import { useState as useState3, useEffect as useEffect3, useCallback as useCallback3, useRef as useRef3 } from "react";
+import { useState as useState3, useEffect as useEffect4, useCallback as useCallback3, useRef as useRef3 } from "react";
 function useMessages(ticketId) {
   const client = useChatClient();
   const [messages, setMessages] = useState3([]);
@@ -155,7 +206,7 @@ function useMessages(ticketId) {
       }
     }
   }, [client, ticketId]);
-  useEffect3(() => {
+  useEffect4(() => {
     mountedRef.current = true;
     if (!ticketId) {
       setMessages([]);
@@ -186,7 +237,7 @@ function useMessages(ticketId) {
   }, [client, ticketId, refresh]);
   const send = useCallback3(
     async (content) => {
-      if (!ticketId) throw new Error("No conversation selected");
+      if (!ticketId) throw new Error("No ticket selected");
       const optimistic = {
         id: `optimistic-${Date.now()}`,
         content,
@@ -213,14 +264,14 @@ function useMessages(ticketId) {
 }
 
 // src/chat/useTyping.ts
-import { useState as useState4, useEffect as useEffect4, useCallback as useCallback4, useRef as useRef4 } from "react";
+import { useState as useState4, useEffect as useEffect5, useCallback as useCallback4, useRef as useRef4 } from "react";
 var TYPING_TIMEOUT = 4e3;
 function useTyping(ticketId) {
   const client = useChatClient();
   const [typingAgents, setTypingAgents] = useState4([]);
   const timersRef = useRef4(/* @__PURE__ */ new Map());
   const mountedRef = useRef4(true);
-  useEffect4(() => {
+  useEffect5(() => {
     mountedRef.current = true;
     if (!ticketId) {
       setTypingAgents([]);
@@ -280,7 +331,7 @@ function CStarLibraryProvider({ children, ...config }) {
 }
 
 // src/library/useCategories.ts
-import { useState as useState5, useEffect as useEffect5, useCallback as useCallback5, useRef as useRef6 } from "react";
+import { useState as useState5, useEffect as useEffect6, useCallback as useCallback5, useRef as useRef6 } from "react";
 function useCategories() {
   const client = useLibraryClient();
   const [categories, setCategories] = useState5([]);
@@ -305,7 +356,7 @@ function useCategories() {
       }
     }
   }, [client]);
-  useEffect5(() => {
+  useEffect6(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -316,7 +367,7 @@ function useCategories() {
 }
 
 // src/library/useArticles.ts
-import { useState as useState6, useEffect as useEffect6, useCallback as useCallback6, useRef as useRef7 } from "react";
+import { useState as useState6, useEffect as useEffect7, useCallback as useCallback6, useRef as useRef7 } from "react";
 function useArticles(params) {
   const client = useLibraryClient();
   const [articles, setArticles] = useState6([]);
@@ -344,7 +395,7 @@ function useArticles(params) {
       }
     }
   }, [client, categorySlug, limit, offset]);
-  useEffect6(() => {
+  useEffect7(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -355,7 +406,7 @@ function useArticles(params) {
 }
 
 // src/library/useArticle.ts
-import { useState as useState7, useEffect as useEffect7, useCallback as useCallback7, useRef as useRef8 } from "react";
+import { useState as useState7, useEffect as useEffect8, useCallback as useCallback7, useRef as useRef8 } from "react";
 function useArticle(slug) {
   const client = useLibraryClient();
   const [article, setArticle] = useState7(null);
@@ -388,7 +439,7 @@ function useArticle(slug) {
     } catch {
     }
   }, [client, slug]);
-  useEffect7(() => {
+  useEffect8(() => {
     mountedRef.current = true;
     if (!slug) {
       setArticle(null);
@@ -404,7 +455,7 @@ function useArticle(slug) {
 }
 
 // src/library/useArticleSearch.ts
-import { useState as useState8, useEffect as useEffect8, useRef as useRef9 } from "react";
+import { useState as useState8, useEffect as useEffect9, useRef as useRef9 } from "react";
 var DEBOUNCE_MS = 300;
 function useArticleSearch(query) {
   const client = useLibraryClient();
@@ -413,7 +464,7 @@ function useArticleSearch(query) {
   const [isLoading, setIsLoading] = useState8(false);
   const [error, setError] = useState8(null);
   const mountedRef = useRef9(true);
-  useEffect8(() => {
+  useEffect9(() => {
     mountedRef.current = true;
     const trimmed = query.trim();
     if (!trimmed) {
@@ -463,7 +514,7 @@ function CStarCommunityProvider({ children, ...config }) {
 }
 
 // src/community/useTopics.ts
-import { useState as useState9, useEffect as useEffect9, useCallback as useCallback8, useRef as useRef11 } from "react";
+import { useState as useState9, useEffect as useEffect10, useCallback as useCallback8, useRef as useRef11 } from "react";
 function useTopics() {
   const client = useCommunityClient();
   const [topics, setTopics] = useState9([]);
@@ -488,7 +539,7 @@ function useTopics() {
       }
     }
   }, [client]);
-  useEffect9(() => {
+  useEffect10(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -499,7 +550,7 @@ function useTopics() {
 }
 
 // src/community/usePosts.ts
-import { useState as useState10, useEffect as useEffect10, useCallback as useCallback9, useRef as useRef12 } from "react";
+import { useState as useState10, useEffect as useEffect11, useCallback as useCallback9, useRef as useRef12 } from "react";
 function usePosts(params) {
   const client = useCommunityClient();
   const [posts, setPosts] = useState10([]);
@@ -531,7 +582,7 @@ function usePosts(params) {
       }
     }
   }, [client, topicSlug, status, sort, limit, offset]);
-  useEffect10(() => {
+  useEffect11(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -542,7 +593,7 @@ function usePosts(params) {
 }
 
 // src/community/usePost.ts
-import { useState as useState11, useEffect as useEffect11, useCallback as useCallback10, useRef as useRef13 } from "react";
+import { useState as useState11, useEffect as useEffect12, useCallback as useCallback10, useRef as useRef13 } from "react";
 function usePost(slug) {
   const client = useCommunityClient();
   const [data, setData] = useState11(null);
@@ -567,7 +618,7 @@ function usePost(slug) {
       }
     }
   }, [client, slug]);
-  useEffect11(() => {
+  useEffect12(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -578,14 +629,14 @@ function usePost(slug) {
 }
 
 // src/community/useCommunitySearch.ts
-import { useState as useState12, useEffect as useEffect12, useCallback as useCallback11, useRef as useRef14 } from "react";
+import { useState as useState12, useEffect as useEffect13, useCallback as useCallback11, useRef as useRef14 } from "react";
 function useCommunitySearch() {
   const client = useCommunityClient();
   const [results, setResults] = useState12(null);
   const [isLoading, setIsLoading] = useState12(false);
   const [error, setError] = useState12(null);
   const mountedRef = useRef14(true);
-  useEffect12(() => {
+  useEffect13(() => {
     mountedRef.current = true;
     return () => {
       mountedRef.current = false;
@@ -620,14 +671,19 @@ function useCommunitySearch() {
 }
 
 // src/dashboard/CStarDashboardProvider.tsx
-import { createContext as createContext2, useContext as useContext2, useEffect as useEffect13, useRef as useRef15 } from "react";
+import { createContext as createContext2, useContext as useContext2, useEffect as useEffect14, useRef as useRef15 } from "react";
 import { jsx as jsx4 } from "react/jsx-runtime";
 var CStarDashboardContext = createContext2(null);
 function CStarDashboardProvider({ client, children }) {
+  if (!client) {
+    throw new Error(
+      "CStarDashboardProvider requires a `client` prop. Build it server-side with `new CStarClient({ apiKey: process.env.CSTAR_API_KEY, teamId })` and pass via SSR. See https://cstar.help/developers/sdk/react#dashboard"
+    );
+  }
   const contextValue = useRef15({ client }).current;
-  useEffect13(() => {
+  useEffect14(() => {
     return () => {
-      client.realtime.disconnect();
+      client?.realtime?.disconnect?.();
     };
   }, [client]);
   return /* @__PURE__ */ jsx4(CStarDashboardContext.Provider, { value: contextValue, children });
@@ -641,7 +697,7 @@ function useDashboardClient() {
 }
 
 // src/dashboard/useCStarQuery.ts
-import { useState as useState13, useEffect as useEffect14, useRef as useRef16, useCallback as useCallback12 } from "react";
+import { useState as useState13, useEffect as useEffect15, useRef as useRef16, useCallback as useCallback12 } from "react";
 function resolveResource(client, path) {
   const parts = path.split(".");
   if (parts.length < 2 || parts[1] !== "list") return null;
@@ -659,7 +715,7 @@ function useCStarQuery(resource, params) {
   const [error, setError] = useState13(null);
   const subscriptionRef = useRef16(null);
   const paramsKey = params ? JSON.stringify(params) : "";
-  useEffect14(() => {
+  useEffect15(() => {
     const resolved = resolveResource(client, resource);
     if (!resolved) {
       setError(new Error(`Invalid resource path: ${resource}. Expected format: 'tickets.list'`));
@@ -699,7 +755,8 @@ function resolveMutation(client, path) {
   const methodName = parts[1];
   const resource = client[resourceName];
   if (!resource || typeof resource !== "object") return null;
-  const method = resource[methodName];
+  const lookupName = methodName === "delete" ? "del" : methodName;
+  const method = resource[lookupName];
   if (typeof method !== "function") return null;
   if (methodName === "update") {
     return (params) => {
@@ -745,14 +802,14 @@ function useCStarMutation(resource) {
 }
 
 // src/dashboard/useCStarEvents.ts
-import { useState as useState15, useEffect as useEffect15 } from "react";
+import { useState as useState15, useEffect as useEffect16 } from "react";
 var MAX_EVENTS = 100;
 function useCStarEvents(types) {
   const client = useDashboardClient();
   const [events, setEvents] = useState15([]);
   const [connected, setConnected] = useState15(false);
   const typesKey = types ? types.join(",") : "";
-  useEffect15(() => {
+  useEffect16(() => {
     const realtime = client.realtime;
     const handler = (event) => {
       if (types && types.length > 0) {
@@ -784,14 +841,14 @@ function useCStarEvents(types) {
 }
 
 // src/dashboard/useBossBattle.ts
-import { useState as useState16, useEffect as useEffect16, useRef as useRef17, useCallback as useCallback14 } from "react";
+import { useState as useState16, useEffect as useEffect17, useRef as useRef17, useCallback as useCallback14 } from "react";
 function useBossBattle() {
   const client = useDashboardClient();
   const [boss, setBoss] = useState16(null);
   const [loading, setLoading] = useState16(true);
   const [error, setError] = useState16(null);
   const subRef = useRef17(null);
-  useEffect16(() => {
+  useEffect17(() => {
     const sub = client.game.subscribeBoss(client.realtime);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -815,14 +872,14 @@ function useBossBattle() {
 }
 
 // src/dashboard/usePlayerStats.ts
-import { useState as useState17, useEffect as useEffect17, useRef as useRef18, useCallback as useCallback15 } from "react";
+import { useState as useState17, useEffect as useEffect18, useRef as useRef18, useCallback as useCallback15 } from "react";
 function usePlayerStats(memberId) {
   const client = useDashboardClient();
   const [player, setPlayer] = useState17(null);
   const [loading, setLoading] = useState17(true);
   const [error, setError] = useState17(null);
   const subRef = useRef18(null);
-  useEffect17(() => {
+  useEffect18(() => {
     const sub = client.game.subscribePlayer(client.realtime, memberId);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -846,14 +903,14 @@ function usePlayerStats(memberId) {
 }
 
 // src/dashboard/useLeaderboard.ts
-import { useState as useState18, useEffect as useEffect18, useRef as useRef19, useCallback as useCallback16 } from "react";
+import { useState as useState18, useEffect as useEffect19, useRef as useRef19, useCallback as useCallback16 } from "react";
 function useLeaderboard(period) {
   const client = useDashboardClient();
   const [entries, setEntries] = useState18([]);
   const [loading, setLoading] = useState18(true);
   const [error, setError] = useState18(null);
   const subRef = useRef19(null);
-  useEffect18(() => {
+  useEffect19(() => {
     const sub = client.game.subscribeLeaderboard(client.realtime, period ? { period } : void 0);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -877,14 +934,14 @@ function useLeaderboard(period) {
 }
 
 // src/dashboard/useGameActivity.ts
-import { useState as useState19, useEffect as useEffect19, useRef as useRef20, useCallback as useCallback17 } from "react";
+import { useState as useState19, useEffect as useEffect20, useRef as useRef20, useCallback as useCallback17 } from "react";
 function useGameActivity() {
   const client = useDashboardClient();
   const [events, setEvents] = useState19([]);
   const [loading, setLoading] = useState19(true);
   const [error, setError] = useState19(null);
   const subRef = useRef20(null);
-  useEffect19(() => {
+  useEffect20(() => {
     const sub = client.game.subscribeActivity(client.realtime);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -926,7 +983,6 @@ export {
   useChatClient,
   useCommunityClient,
   useCommunitySearch,
-  useConversations,
   useDashboardClient,
   useGameActivity,
   useLeaderboard,
@@ -935,6 +991,7 @@ export {
   usePlayerStats,
   usePost,
   usePosts,
+  useTickets,
   useTopics,
   useTyping
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cstar.help/react",
-	"version": "0.6.1",
+	"version": "0.8.0",
 	"description": "React hooks for the cStar customer support platform",
 	"type": "module",
 	"main": "./dist/index.cjs",
@@ -30,7 +30,7 @@
 	},
 	"peerDependencies": {
 		"react": ">=18.0.0",
-		"@cstar.help/js": ">=0.2.0"
+		"@cstar.help/js": ">=0.11.0"
 	},
 	"devDependencies": {
 		"react": "^18.3.1",