@cstar.help/react 0.6.1 → 0.7.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
 });
@@ -133,11 +133,11 @@ function useChat() {
   return { identify, disconnect, isIdentified, 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 +146,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 +170,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 +241,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,
@@ -754,7 +754,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 +983,6 @@ function useGameActivity() {
   useChatClient,
   useCommunityClient,
   useCommunitySearch,
-  useConversations,
   useDashboardClient,
   useGameActivity,
   useLeaderboard,
@@ -991,6 +991,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, 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>
  * ```
@@ -50,7 +50,7 @@ interface UseChatReturn {
     disconnect: () => void;
     /** Whether a customer has been successfully identified. */
     isIdentified: boolean;
-    /** Whether the Supabase Realtime connection is ready. */
+    /** Whether the real-time connection is ready. */
     isRealtimeReady: boolean;
     /** The last error from identify, or null. */
     error: Error | null;
@@ -69,43 +69,43 @@ interface UseChatReturn {
  */
 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 +125,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 +477,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, 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>
  * ```
@@ -50,7 +50,7 @@ interface UseChatReturn {
     disconnect: () => void;
     /** Whether a customer has been successfully identified. */
     isIdentified: boolean;
-    /** Whether the Supabase Realtime connection is ready. */
+    /** Whether the real-time connection is ready. */
     isRealtimeReady: boolean;
     /** The last error from identify, or null. */
     error: Error | null;
@@ -69,43 +69,43 @@ interface UseChatReturn {
  */
 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 +125,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 +477,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

@@ -78,11 +78,11 @@ function useChat() {
   return { identify, disconnect, isIdentified, isRealtimeReady, error };
 }
 
-// src/chat/useConversations.ts
+// src/chat/useTickets.ts
 import { useState as useState2, useEffect as useEffect2, useCallback as useCallback2, useRef as useRef2 } from "react";
-function useConversations() {
+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 +91,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) {
@@ -115,15 +115,15 @@ 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
@@ -186,7 +186,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,
@@ -699,7 +699,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) => {
@@ -926,7 +927,6 @@ export {
   useChatClient,
   useCommunityClient,
   useCommunitySearch,
-  useConversations,
   useDashboardClient,
   useGameActivity,
   useLeaderboard,
@@ -935,6 +935,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.7.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",