@cstar.help/react 0.10.2 → 0.10.3

package/README.md

@@ -117,6 +117,7 @@ Wrap in `<CStarLibraryProvider>` for public knowledge base access. No auth requi
 import { CStarLibraryProvider } from '@cstar.help/react';
 
 function App() {
+	// Seeded with a test key (cstar seed)? Add publishableKey="pk_test_..." to read test articles.
 	return (
 		<CStarLibraryProvider teamSlug="acme">
 			<HelpCenter />

package/dist/index.cjs

@@ -1,3 +1,4 @@
+'use client';
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -81,32 +82,51 @@ function useCommunityClient() {
 }
 
 // src/chat/CStarChatProvider.tsx
-var import_react2 = require("react");
+var import_react3 = require("react");
 var import_chat = require("@cstar.help/js/chat");
+
+// src/useDisconnectOnUnmount.ts
+var import_react2 = require("react");
+function useDisconnectOnUnmount(target, disconnect) {
+  const pending = (0, import_react2.useRef)(null);
+  const disconnectRef = (0, import_react2.useRef)(disconnect);
+  disconnectRef.current = disconnect;
+  (0, import_react2.useEffect)(() => {
+    if (target === null) return;
+    if (pending.current?.target === target) {
+      clearTimeout(pending.current.timer);
+      pending.current = null;
+    }
+    return () => {
+      const timer = setTimeout(() => {
+        if (pending.current?.target === target) pending.current = null;
+        disconnectRef.current(target);
+      }, 0);
+      pending.current = { target, timer };
+    };
+  }, [target]);
+}
+
+// src/chat/CStarChatProvider.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 function CStarChatProvider({ children, ...config }) {
-  const clientRef = (0, import_react2.useRef)(null);
+  const clientRef = (0, import_react3.useRef)(null);
   if (!clientRef.current) {
     clientRef.current = new import_chat.ChatClient(config);
   }
-  (0, import_react2.useEffect)(() => {
-    return () => {
-      clientRef.current?.disconnect();
-      clientRef.current = null;
-    };
-  }, []);
+  useDisconnectOnUnmount(clientRef.current, (client) => client.disconnect());
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CStarChatContext.Provider, { value: clientRef.current, children });
 }
 
 // src/chat/useChat.ts
-var import_react3 = require("react");
+var import_react4 = require("react");
 function useChat() {
   const client = useChatClient();
-  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 [isAuthenticated, setIsAuthenticated] = (0, import_react4.useState)(false);
+  const [authMode, setAuthMode] = (0, import_react4.useState)(() => client.getAuthMode());
+  const [isRealtimeReady, setIsRealtimeReady] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  (0, import_react4.useEffect)(() => {
     const subscribe = client.subscribe?.bind(client);
     if (!subscribe) return;
     return subscribe(() => {
@@ -115,11 +135,11 @@ function useChat() {
       setIsAuthenticated(mode !== null);
     });
   }, [client]);
-  const wireRealtime = (0, import_react3.useCallback)(() => {
+  const wireRealtime = (0, import_react4.useCallback)(() => {
     client.waitForRealtime().then(() => setIsRealtimeReady(true)).catch(() => {
     });
   }, [client]);
-  const identify = (0, import_react3.useCallback)(
+  const identify = (0, import_react4.useCallback)(
     async (customer, signature) => {
       setError(null);
       try {
@@ -136,7 +156,7 @@ function useChat() {
     },
     [client, wireRealtime]
   );
-  const loginWithCredentials = (0, import_react3.useCallback)(
+  const loginWithCredentials = (0, import_react4.useCallback)(
     async (params) => {
       setError(null);
       try {
@@ -153,7 +173,7 @@ function useChat() {
     },
     [client, wireRealtime]
   );
-  const loginWithSession = (0, import_react3.useCallback)(
+  const loginWithSession = (0, import_react4.useCallback)(
     async (params) => {
       setError(null);
       try {
@@ -169,7 +189,7 @@ function useChat() {
     },
     [client, wireRealtime]
   );
-  const disconnect = (0, import_react3.useCallback)(() => {
+  const disconnect = (0, import_react4.useCallback)(() => {
     client.disconnect();
     setIsAuthenticated(false);
     setAuthMode(null);
@@ -190,15 +210,15 @@ function useChat() {
 }
 
 // src/chat/useTickets.ts
-var import_react4 = require("react");
+var import_react5 = require("react");
 function useTickets() {
   const client = useChatClient();
-  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);
-  const mountedRef = (0, import_react4.useRef)(true);
-  const refresh = (0, import_react4.useCallback)(async () => {
+  const [tickets, setTickets] = (0, import_react5.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react5.useState)(true);
+  const [error, setError] = (0, import_react5.useState)(null);
+  const [hasMore, setHasMore] = (0, import_react5.useState)(false);
+  const mountedRef = (0, import_react5.useRef)(true);
+  const refresh = (0, import_react5.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -217,14 +237,14 @@ function useTickets() {
       }
     }
   }, [client]);
-  (0, import_react4.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     mountedRef.current = true;
     refresh();
     return () => {
       mountedRef.current = false;
     };
   }, [refresh]);
-  const create = (0, import_react4.useCallback)(
+  const create = (0, import_react5.useCallback)(
     async (params) => {
       const ticket = await client.tickets.create(params);
       if (mountedRef.current) {
@@ -238,18 +258,18 @@ function useTickets() {
 }
 
 // src/chat/useMessages.ts
-var import_react5 = require("react");
+var import_react6 = require("react");
 function useMessages(ticketId) {
   const client = useChatClient();
-  const [messages, setMessages] = (0, import_react5.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react5.useState)(true);
-  const [error, setError] = (0, import_react5.useState)(null);
-  const mountedRef = (0, import_react5.useRef)(true);
-  const seenIdsRef = (0, import_react5.useRef)(/* @__PURE__ */ new Set());
-  const requestRef = (0, import_react5.useRef)(0);
-  const scopeRef = (0, import_react5.useRef)(0);
-  const optimisticRef = (0, import_react5.useRef)(0);
-  const refresh = (0, import_react5.useCallback)(async () => {
+  const [messages, setMessages] = (0, import_react6.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react6.useState)(true);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const mountedRef = (0, import_react6.useRef)(true);
+  const seenIdsRef = (0, import_react6.useRef)(/* @__PURE__ */ new Set());
+  const requestRef = (0, import_react6.useRef)(0);
+  const scopeRef = (0, import_react6.useRef)(0);
+  const optimisticRef = (0, import_react6.useRef)(0);
+  const refresh = (0, import_react6.useCallback)(async () => {
     if (!ticketId) return;
     const request = ++requestRef.current;
     setIsLoading(true);
@@ -270,7 +290,7 @@ function useMessages(ticketId) {
       }
     }
   }, [client, ticketId]);
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     mountedRef.current = true;
     const scope = ++scopeRef.current;
     seenIdsRef.current = /* @__PURE__ */ new Set();
@@ -309,7 +329,7 @@ function useMessages(ticketId) {
       unsubscribe();
     };
   }, [client, ticketId, refresh]);
-  const send = (0, import_react5.useCallback)(
+  const send = (0, import_react6.useCallback)(
     async (content) => {
       if (!ticketId) throw new Error("No ticket selected");
       const scope = scopeRef.current;
@@ -342,14 +362,14 @@ function useMessages(ticketId) {
 }
 
 // src/chat/useTyping.ts
-var import_react6 = require("react");
+var import_react7 = require("react");
 var TYPING_TIMEOUT = 4e3;
 function useTyping(ticketId) {
   const client = useChatClient();
-  const [typingAgents, setTypingAgents] = (0, import_react6.useState)([]);
-  const timersRef = (0, import_react6.useRef)(/* @__PURE__ */ new Map());
-  const mountedRef = (0, import_react6.useRef)(true);
-  (0, import_react6.useEffect)(() => {
+  const [typingAgents, setTypingAgents] = (0, import_react7.useState)([]);
+  const timersRef = (0, import_react7.useRef)(/* @__PURE__ */ new Map());
+  const mountedRef = (0, import_react7.useRef)(true);
+  (0, import_react7.useEffect)(() => {
     mountedRef.current = true;
     if (!ticketId) {
       setTypingAgents([]);
@@ -386,7 +406,7 @@ function useTyping(ticketId) {
       timersRef.current.clear();
     };
   }, [client, ticketId]);
-  const sendTyping = (0, import_react6.useCallback)(
+  const sendTyping = (0, import_react7.useCallback)(
     async (isTyping) => {
       if (!ticketId) return;
       await client.sendTyping(ticketId, isTyping);
@@ -397,11 +417,11 @@ function useTyping(ticketId) {
 }
 
 // src/library/CStarLibraryProvider.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_library = require("@cstar.help/js/library");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 function CStarLibraryProvider({ children, ...config }) {
-  const clientRef = (0, import_react7.useRef)(null);
+  const clientRef = (0, import_react8.useRef)(null);
   if (!clientRef.current) {
     clientRef.current = new import_library.LibraryClient(config);
   }
@@ -409,14 +429,14 @@ function CStarLibraryProvider({ children, ...config }) {
 }
 
 // src/library/useCategories.ts
-var import_react8 = require("react");
+var import_react9 = require("react");
 function useCategories() {
   const client = useLibraryClient();
-  const [categories, setCategories] = (0, import_react8.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react8.useState)(true);
-  const [error, setError] = (0, import_react8.useState)(null);
-  const mountedRef = (0, import_react8.useRef)(true);
-  const refresh = (0, import_react8.useCallback)(async () => {
+  const [categories, setCategories] = (0, import_react9.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react9.useState)(true);
+  const [error, setError] = (0, import_react9.useState)(null);
+  const mountedRef = (0, import_react9.useRef)(true);
+  const refresh = (0, import_react9.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -434,7 +454,7 @@ function useCategories() {
       }
     }
   }, [client]);
-  (0, import_react8.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -445,17 +465,17 @@ function useCategories() {
 }
 
 // src/library/useArticles.ts
-var import_react9 = require("react");
+var import_react10 = require("react");
 function useArticles(params) {
   const client = useLibraryClient();
-  const [articles, setArticles] = (0, import_react9.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react9.useState)(true);
-  const [error, setError] = (0, import_react9.useState)(null);
-  const mountedRef = (0, import_react9.useRef)(true);
+  const [articles, setArticles] = (0, import_react10.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react10.useState)(true);
+  const [error, setError] = (0, import_react10.useState)(null);
+  const mountedRef = (0, import_react10.useRef)(true);
   const categorySlug = params?.categorySlug;
   const limit = params?.limit;
   const offset = params?.offset;
-  const refresh = (0, import_react9.useCallback)(async () => {
+  const refresh = (0, import_react10.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -473,7 +493,7 @@ function useArticles(params) {
       }
     }
   }, [client, categorySlug, limit, offset]);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -484,14 +504,14 @@ function useArticles(params) {
 }
 
 // src/library/useArticle.ts
-var import_react10 = require("react");
+var import_react11 = require("react");
 function useArticle(slug) {
   const client = useLibraryClient();
-  const [article, setArticle] = (0, import_react10.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react10.useState)(true);
-  const [error, setError] = (0, import_react10.useState)(null);
-  const mountedRef = (0, import_react10.useRef)(true);
-  const refresh = (0, import_react10.useCallback)(async () => {
+  const [article, setArticle] = (0, import_react11.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react11.useState)(true);
+  const [error, setError] = (0, import_react11.useState)(null);
+  const mountedRef = (0, import_react11.useRef)(true);
+  const refresh = (0, import_react11.useCallback)(async () => {
     if (!slug) return;
     setIsLoading(true);
     setError(null);
@@ -510,14 +530,14 @@ function useArticle(slug) {
       }
     }
   }, [client, slug]);
-  const recordView = (0, import_react10.useCallback)(async () => {
+  const recordView = (0, import_react11.useCallback)(async () => {
     if (!slug) return;
     try {
       await client.recordView(slug);
     } catch {
     }
   }, [client, slug]);
-  (0, import_react10.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     mountedRef.current = true;
     if (!slug) {
       setArticle(null);
@@ -533,16 +553,16 @@ function useArticle(slug) {
 }
 
 // src/library/useArticleSearch.ts
-var import_react11 = require("react");
+var import_react12 = require("react");
 var DEBOUNCE_MS = 300;
 function useArticleSearch(query) {
   const client = useLibraryClient();
-  const [results, setResults] = (0, import_react11.useState)([]);
-  const [totalCount, setTotalCount] = (0, import_react11.useState)(0);
-  const [isLoading, setIsLoading] = (0, import_react11.useState)(false);
-  const [error, setError] = (0, import_react11.useState)(null);
-  const mountedRef = (0, import_react11.useRef)(true);
-  (0, import_react11.useEffect)(() => {
+  const [results, setResults] = (0, import_react12.useState)([]);
+  const [totalCount, setTotalCount] = (0, import_react12.useState)(0);
+  const [isLoading, setIsLoading] = (0, import_react12.useState)(false);
+  const [error, setError] = (0, import_react12.useState)(null);
+  const mountedRef = (0, import_react12.useRef)(true);
+  (0, import_react12.useEffect)(() => {
     mountedRef.current = true;
     const trimmed = query.trim();
     if (!trimmed) {
@@ -580,11 +600,11 @@ function useArticleSearch(query) {
 }
 
 // src/community/CStarCommunityProvider.tsx
-var import_react12 = require("react");
+var import_react13 = require("react");
 var import_community = require("@cstar.help/js/community");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 function CStarCommunityProvider({ children, ...config }) {
-  const clientRef = (0, import_react12.useRef)(null);
+  const clientRef = (0, import_react13.useRef)(null);
   if (!clientRef.current) {
     clientRef.current = new import_community.CommunityClient(config);
   }
@@ -592,14 +612,14 @@ function CStarCommunityProvider({ children, ...config }) {
 }
 
 // src/community/useTopics.ts
-var import_react13 = require("react");
+var import_react14 = require("react");
 function useTopics() {
   const client = useCommunityClient();
-  const [topics, setTopics] = (0, import_react13.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react13.useState)(true);
-  const [error, setError] = (0, import_react13.useState)(null);
-  const mountedRef = (0, import_react13.useRef)(true);
-  const refresh = (0, import_react13.useCallback)(async () => {
+  const [topics, setTopics] = (0, import_react14.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react14.useState)(true);
+  const [error, setError] = (0, import_react14.useState)(null);
+  const mountedRef = (0, import_react14.useRef)(true);
+  const refresh = (0, import_react14.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -617,7 +637,7 @@ function useTopics() {
       }
     }
   }, [client]);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -628,20 +648,20 @@ function useTopics() {
 }
 
 // src/community/usePosts.ts
-var import_react14 = require("react");
+var import_react15 = require("react");
 function usePosts(params) {
   const client = useCommunityClient();
-  const [posts, setPosts] = (0, import_react14.useState)([]);
-  const [count, setCount] = (0, import_react14.useState)(0);
-  const [isLoading, setIsLoading] = (0, import_react14.useState)(true);
-  const [error, setError] = (0, import_react14.useState)(null);
-  const mountedRef = (0, import_react14.useRef)(true);
+  const [posts, setPosts] = (0, import_react15.useState)([]);
+  const [count, setCount] = (0, import_react15.useState)(0);
+  const [isLoading, setIsLoading] = (0, import_react15.useState)(true);
+  const [error, setError] = (0, import_react15.useState)(null);
+  const mountedRef = (0, import_react15.useRef)(true);
   const topicSlug = params?.topicSlug;
   const status = params?.status;
   const sort = params?.sort;
   const limit = params?.limit;
   const offset = params?.offset;
-  const refresh = (0, import_react14.useCallback)(async () => {
+  const refresh = (0, import_react15.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -660,7 +680,7 @@ function usePosts(params) {
       }
     }
   }, [client, topicSlug, status, sort, limit, offset]);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -671,14 +691,14 @@ function usePosts(params) {
 }
 
 // src/community/usePost.ts
-var import_react15 = require("react");
+var import_react16 = require("react");
 function usePost(slug) {
   const client = useCommunityClient();
-  const [data, setData] = (0, import_react15.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react15.useState)(true);
-  const [error, setError] = (0, import_react15.useState)(null);
-  const mountedRef = (0, import_react15.useRef)(true);
-  const refresh = (0, import_react15.useCallback)(async () => {
+  const [data, setData] = (0, import_react16.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react16.useState)(true);
+  const [error, setError] = (0, import_react16.useState)(null);
+  const mountedRef = (0, import_react16.useRef)(true);
+  const refresh = (0, import_react16.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -696,7 +716,7 @@ function usePost(slug) {
       }
     }
   }, [client, slug]);
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     mountedRef.current = true;
     refresh();
     return () => {
@@ -707,20 +727,20 @@ function usePost(slug) {
 }
 
 // src/community/useCommunitySearch.ts
-var import_react16 = require("react");
+var import_react17 = require("react");
 function useCommunitySearch() {
   const client = useCommunityClient();
-  const [results, setResults] = (0, import_react16.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react16.useState)(false);
-  const [error, setError] = (0, import_react16.useState)(null);
-  const mountedRef = (0, import_react16.useRef)(true);
-  (0, import_react16.useEffect)(() => {
+  const [results, setResults] = (0, import_react17.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react17.useState)(false);
+  const [error, setError] = (0, import_react17.useState)(null);
+  const mountedRef = (0, import_react17.useRef)(true);
+  (0, import_react17.useEffect)(() => {
     mountedRef.current = true;
     return () => {
       mountedRef.current = false;
     };
   }, []);
-  const search = (0, import_react16.useCallback)(
+  const search = (0, import_react17.useCallback)(
     async (query) => {
       if (!query.trim()) {
         setResults(null);
@@ -749,10 +769,10 @@ function useCommunitySearch() {
 }
 
 // src/dashboard/CStarDashboardProvider.tsx
-var import_react17 = require("react");
+var import_react18 = require("react");
 var import_js = require("@cstar.help/js");
 var import_jsx_runtime4 = require("react/jsx-runtime");
-var CStarDashboardContext = (0, import_react17.createContext)(null);
+var CStarDashboardContext = (0, import_react18.createContext)(null);
 function CStarDashboardProvider({
   config,
   client: providedClient,
@@ -760,10 +780,10 @@ function CStarDashboardProvider({
 }) {
   if (!config && !providedClient) {
     throw new Error(
-      "CStarDashboardProvider requires either a `config` prop (`{ apiKey, teamId }`, recommended) or a `client` prop (a pre-built CStarClient instance, deprecated). See https://cstar.help/developers/sdk/react#dashboard"
+      "CStarDashboardProvider requires either a `config` prop (`{ apiKey, teamId }`, recommended) or a `client` prop (a pre-built CStarClient instance, deprecated). See https://www.cstar.help/developers/sdk/react#dashboard"
     );
   }
-  const client = (0, import_react17.useMemo)(() => {
+  const client = (0, import_react18.useMemo)(() => {
     if (providedClient) return providedClient;
     return new import_js.CStarClient(config);
   }, [
@@ -775,17 +795,12 @@ function CStarDashboardProvider({
     config?.maxRetries,
     config?.timeout
   ]);
-  const contextValue = (0, import_react17.useMemo)(() => ({ client }), [client]);
-  (0, import_react17.useEffect)(() => {
-    if (providedClient) return;
-    return () => {
-      client?.realtime?.disconnect?.();
-    };
-  }, [client, providedClient]);
+  const contextValue = (0, import_react18.useMemo)(() => ({ client }), [client]);
+  useDisconnectOnUnmount(providedClient ? null : client, (owned) => owned.realtime?.disconnect?.());
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(CStarDashboardContext.Provider, { value: contextValue, children });
 }
 function useDashboardClient() {
-  const ctx = (0, import_react17.useContext)(CStarDashboardContext);
+  const ctx = (0, import_react18.useContext)(CStarDashboardContext);
   if (!ctx) {
     throw new Error("useDashboardClient must be used within a <CStarDashboardProvider>");
   }
@@ -793,7 +808,7 @@ function useDashboardClient() {
 }
 
 // src/dashboard/useCStarQuery.ts
-var import_react18 = require("react");
+var import_react19 = require("react");
 var import_js2 = require("@cstar.help/js");
 function resolveResource(client, path) {
   const parts = path.split(".");
@@ -812,12 +827,12 @@ function useCStarQuery(resource, params) {
     );
   }
   const client = useDashboardClient();
-  const [data, setData] = (0, import_react18.useState)(null);
-  const [loading, setLoading] = (0, import_react18.useState)(true);
-  const [error, setError] = (0, import_react18.useState)(null);
-  const subscriptionRef = (0, import_react18.useRef)(null);
+  const [data, setData] = (0, import_react19.useState)(null);
+  const [loading, setLoading] = (0, import_react19.useState)(true);
+  const [error, setError] = (0, import_react19.useState)(null);
+  const subscriptionRef = (0, import_react19.useRef)(null);
   const paramsKey = params ? JSON.stringify(params) : "";
-  (0, import_react18.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     const resolved = resolveResource(client, resource);
     if (!resolved) {
       setError(new Error(`Invalid resource path: ${resource}. Expected format: 'tickets.list'`));
@@ -840,7 +855,7 @@ function useCStarQuery(resource, params) {
       subscriptionRef.current = null;
     };
   }, [client, resource, paramsKey]);
-  const refresh = (0, import_react18.useCallback)(async () => {
+  const refresh = (0, import_react19.useCallback)(async () => {
     if (subscriptionRef.current) {
       await subscriptionRef.current.refresh();
     }
@@ -849,7 +864,7 @@ function useCStarQuery(resource, params) {
 }
 
 // src/dashboard/useCStarMutation.ts
-var import_react19 = require("react");
+var import_react20 = require("react");
 function resolveMutation(client, path) {
   const parts = path.split(".");
   if (parts.length < 2) return null;
@@ -877,9 +892,9 @@ function resolveMutation(client, path) {
 }
 function useCStarMutation(resource) {
   const client = useDashboardClient();
-  const [loading, setLoading] = (0, import_react19.useState)(false);
-  const [error, setError] = (0, import_react19.useState)(null);
-  const mutate = (0, import_react19.useCallback)(
+  const [loading, setLoading] = (0, import_react20.useState)(false);
+  const [error, setError] = (0, import_react20.useState)(null);
+  const mutate = (0, import_react20.useCallback)(
     async (params) => {
       const fn = resolveMutation(client, resource);
       if (!fn) {
@@ -904,14 +919,14 @@ function useCStarMutation(resource) {
 }
 
 // src/dashboard/useCStarEvents.ts
-var import_react20 = require("react");
+var import_react21 = require("react");
 var MAX_EVENTS = 100;
 function useCStarEvents(types) {
   const client = useDashboardClient();
-  const [events, setEvents] = (0, import_react20.useState)([]);
-  const [connected, setConnected] = (0, import_react20.useState)(false);
+  const [events, setEvents] = (0, import_react21.useState)([]);
+  const [connected, setConnected] = (0, import_react21.useState)(false);
   const typesKey = types ? types.join(",") : "";
-  (0, import_react20.useEffect)(() => {
+  (0, import_react21.useEffect)(() => {
     const realtime = client.realtime;
     const handler = (event) => {
       if (types && types.length > 0) {
@@ -943,14 +958,14 @@ function useCStarEvents(types) {
 }
 
 // src/dashboard/useBossBattle.ts
-var import_react21 = require("react");
+var import_react22 = require("react");
 function useBossBattle() {
   const client = useDashboardClient();
-  const [boss, setBoss] = (0, import_react21.useState)(null);
-  const [loading, setLoading] = (0, import_react21.useState)(true);
-  const [error, setError] = (0, import_react21.useState)(null);
-  const subRef = (0, import_react21.useRef)(null);
-  (0, import_react21.useEffect)(() => {
+  const [boss, setBoss] = (0, import_react22.useState)(null);
+  const [loading, setLoading] = (0, import_react22.useState)(true);
+  const [error, setError] = (0, import_react22.useState)(null);
+  const subRef = (0, import_react22.useRef)(null);
+  (0, import_react22.useEffect)(() => {
     const sub = client.game.subscribeBoss(client.realtime);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -967,21 +982,21 @@ function useBossBattle() {
       subRef.current = null;
     };
   }, [client]);
-  const refresh = (0, import_react21.useCallback)(async () => {
+  const refresh = (0, import_react22.useCallback)(async () => {
     if (subRef.current) await subRef.current.refresh();
   }, []);
   return { boss, active: boss?.active ?? false, loading, error, refresh };
 }
 
 // src/dashboard/usePlayerStats.ts
-var import_react22 = require("react");
+var import_react23 = require("react");
 function usePlayerStats(memberId) {
   const client = useDashboardClient();
-  const [player, setPlayer] = (0, import_react22.useState)(null);
-  const [loading, setLoading] = (0, import_react22.useState)(true);
-  const [error, setError] = (0, import_react22.useState)(null);
-  const subRef = (0, import_react22.useRef)(null);
-  (0, import_react22.useEffect)(() => {
+  const [player, setPlayer] = (0, import_react23.useState)(null);
+  const [loading, setLoading] = (0, import_react23.useState)(true);
+  const [error, setError] = (0, import_react23.useState)(null);
+  const subRef = (0, import_react23.useRef)(null);
+  (0, import_react23.useEffect)(() => {
     const sub = client.game.subscribePlayer(client.realtime, memberId);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -998,21 +1013,21 @@ function usePlayerStats(memberId) {
       subRef.current = null;
     };
   }, [client, memberId]);
-  const refresh = (0, import_react22.useCallback)(async () => {
+  const refresh = (0, import_react23.useCallback)(async () => {
     if (subRef.current) await subRef.current.refresh();
   }, []);
   return { player, loading, error, refresh };
 }
 
 // src/dashboard/useLeaderboard.ts
-var import_react23 = require("react");
+var import_react24 = require("react");
 function useLeaderboard(period) {
   const client = useDashboardClient();
-  const [entries, setEntries] = (0, import_react23.useState)([]);
-  const [loading, setLoading] = (0, import_react23.useState)(true);
-  const [error, setError] = (0, import_react23.useState)(null);
-  const subRef = (0, import_react23.useRef)(null);
-  (0, import_react23.useEffect)(() => {
+  const [entries, setEntries] = (0, import_react24.useState)([]);
+  const [loading, setLoading] = (0, import_react24.useState)(true);
+  const [error, setError] = (0, import_react24.useState)(null);
+  const subRef = (0, import_react24.useRef)(null);
+  (0, import_react24.useEffect)(() => {
     const sub = client.game.subscribeLeaderboard(client.realtime, period ? { period } : void 0);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -1029,21 +1044,21 @@ function useLeaderboard(period) {
       subRef.current = null;
     };
   }, [client, period]);
-  const refresh = (0, import_react23.useCallback)(async () => {
+  const refresh = (0, import_react24.useCallback)(async () => {
     if (subRef.current) await subRef.current.refresh();
   }, []);
   return { entries, loading, error, refresh };
 }
 
 // src/dashboard/useGameActivity.ts
-var import_react24 = require("react");
+var import_react25 = require("react");
 function useGameActivity() {
   const client = useDashboardClient();
-  const [events, setEvents] = (0, import_react24.useState)([]);
-  const [loading, setLoading] = (0, import_react24.useState)(true);
-  const [error, setError] = (0, import_react24.useState)(null);
-  const subRef = (0, import_react24.useRef)(null);
-  (0, import_react24.useEffect)(() => {
+  const [events, setEvents] = (0, import_react25.useState)([]);
+  const [loading, setLoading] = (0, import_react25.useState)(true);
+  const [error, setError] = (0, import_react25.useState)(null);
+  const subRef = (0, import_react25.useRef)(null);
+  (0, import_react25.useEffect)(() => {
     const sub = client.game.subscribeActivity(client.realtime);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -1060,7 +1075,7 @@ function useGameActivity() {
       subRef.current = null;
     };
   }, [client]);
-  const refresh = (0, import_react24.useCallback)(async () => {
+  const refresh = (0, import_react25.useCallback)(async () => {
     if (subRef.current) await subRef.current.refresh();
   }, []);
   return { events, loading, error, refresh };

package/dist/index.d.cts

@@ -32,7 +32,9 @@ interface CStarChatProviderProps extends ChatConfig {
 }
 /**
  * Provides a ChatClient instance to all child components.
- * Creates the client on mount and disconnects on unmount.
+ * Creates the client once and disconnects it on a real unmount. The client
+ * survives StrictMode's simulated unmount, so an identified customer stays
+ * identified.
  *
  * ```tsx
  * <CStarChatProvider teamSlug="acme">
@@ -88,7 +90,7 @@ interface UseChatReturn {
  * const { identify, loginWithCredentials, isAuthenticated, authMode } = useChat();
  *
  * await identify(
- *   { externalId: 'usr_123', email: 'jane@co.com', timestamp: Date.now() / 1000 },
+ *   { externalId: 'user_123', email: 'jane@co.com', timestamp: Date.now() / 1000 },
  *   hmacSignature
  * );
  * // OR
@@ -498,7 +500,7 @@ interface UsePlayerStatsReturn {
  * Subscribe to player stats (XP, level, streaks).
  *
  * ```tsx
- * const { player, loading, error } = usePlayerStats('user_123');
+ * const { player, loading, error } = usePlayerStats('550e8400-e29b-41d4-a716-446655440001');
  * ```
  */
 declare function usePlayerStats(memberId?: string): UsePlayerStatsReturn;

package/dist/index.d.ts

@@ -32,7 +32,9 @@ interface CStarChatProviderProps extends ChatConfig {
 }
 /**
  * Provides a ChatClient instance to all child components.
- * Creates the client on mount and disconnects on unmount.
+ * Creates the client once and disconnects it on a real unmount. The client
+ * survives StrictMode's simulated unmount, so an identified customer stays
+ * identified.
  *
  * ```tsx
  * <CStarChatProvider teamSlug="acme">
@@ -88,7 +90,7 @@ interface UseChatReturn {
  * const { identify, loginWithCredentials, isAuthenticated, authMode } = useChat();
  *
  * await identify(
- *   { externalId: 'usr_123', email: 'jane@co.com', timestamp: Date.now() / 1000 },
+ *   { externalId: 'user_123', email: 'jane@co.com', timestamp: Date.now() / 1000 },
  *   hmacSignature
  * );
  * // OR
@@ -498,7 +500,7 @@ interface UsePlayerStatsReturn {
  * Subscribe to player stats (XP, level, streaks).
  *
  * ```tsx
- * const { player, loading, error } = usePlayerStats('user_123');
+ * const { player, loading, error } = usePlayerStats('550e8400-e29b-41d4-a716-446655440001');
  * ```
  */
 declare function usePlayerStats(memberId?: string): UsePlayerStatsReturn;

package/dist/index.js

@@ -1,3 +1,5 @@
+'use client';
+
 // src/context.tsx
 import { createContext, useContext } from "react";
 var CStarChatContext = createContext(null);
@@ -26,20 +28,39 @@ function useCommunityClient() {
 }
 
 // src/chat/CStarChatProvider.tsx
-import { useEffect, useRef } from "react";
+import { useRef as useRef2 } from "react";
 import { ChatClient } from "@cstar.help/js/chat";
+
+// src/useDisconnectOnUnmount.ts
+import { useEffect, useRef } from "react";
+function useDisconnectOnUnmount(target, disconnect) {
+  const pending = useRef(null);
+  const disconnectRef = useRef(disconnect);
+  disconnectRef.current = disconnect;
+  useEffect(() => {
+    if (target === null) return;
+    if (pending.current?.target === target) {
+      clearTimeout(pending.current.timer);
+      pending.current = null;
+    }
+    return () => {
+      const timer = setTimeout(() => {
+        if (pending.current?.target === target) pending.current = null;
+        disconnectRef.current(target);
+      }, 0);
+      pending.current = { target, timer };
+    };
+  }, [target]);
+}
+
+// src/chat/CStarChatProvider.tsx
 import { jsx } from "react/jsx-runtime";
 function CStarChatProvider({ children, ...config }) {
-  const clientRef = useRef(null);
+  const clientRef = useRef2(null);
   if (!clientRef.current) {
     clientRef.current = new ChatClient(config);
   }
-  useEffect(() => {
-    return () => {
-      clientRef.current?.disconnect();
-      clientRef.current = null;
-    };
-  }, []);
+  useDisconnectOnUnmount(clientRef.current, (client) => client.disconnect());
   return /* @__PURE__ */ jsx(CStarChatContext.Provider, { value: clientRef.current, children });
 }
 
@@ -135,14 +156,14 @@ function useChat() {
 }
 
 // src/chat/useTickets.ts
-import { useState as useState2, useEffect as useEffect3, useCallback as useCallback2, useRef as useRef2 } from "react";
+import { useState as useState2, useEffect as useEffect3, useCallback as useCallback2, useRef as useRef3 } from "react";
 function useTickets() {
   const client = useChatClient();
   const [tickets, setTickets] = useState2([]);
   const [isLoading, setIsLoading] = useState2(true);
   const [error, setError] = useState2(null);
   const [hasMore, setHasMore] = useState2(false);
-  const mountedRef = useRef2(true);
+  const mountedRef = useRef3(true);
   const refresh = useCallback2(async () => {
     setIsLoading(true);
     setError(null);
@@ -183,17 +204,17 @@ function useTickets() {
 }
 
 // src/chat/useMessages.ts
-import { useState as useState3, useEffect as useEffect4, useCallback as useCallback3, useRef as useRef3 } from "react";
+import { useState as useState3, useEffect as useEffect4, useCallback as useCallback3, useRef as useRef4 } from "react";
 function useMessages(ticketId) {
   const client = useChatClient();
   const [messages, setMessages] = useState3([]);
   const [isLoading, setIsLoading] = useState3(true);
   const [error, setError] = useState3(null);
-  const mountedRef = useRef3(true);
-  const seenIdsRef = useRef3(/* @__PURE__ */ new Set());
-  const requestRef = useRef3(0);
-  const scopeRef = useRef3(0);
-  const optimisticRef = useRef3(0);
+  const mountedRef = useRef4(true);
+  const seenIdsRef = useRef4(/* @__PURE__ */ new Set());
+  const requestRef = useRef4(0);
+  const scopeRef = useRef4(0);
+  const optimisticRef = useRef4(0);
   const refresh = useCallback3(async () => {
     if (!ticketId) return;
     const request = ++requestRef.current;
@@ -287,13 +308,13 @@ function useMessages(ticketId) {
 }
 
 // src/chat/useTyping.ts
-import { useState as useState4, useEffect as useEffect5, useCallback as useCallback4, useRef as useRef4 } from "react";
+import { useState as useState4, useEffect as useEffect5, useCallback as useCallback4, useRef as useRef5 } 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);
+  const timersRef = useRef5(/* @__PURE__ */ new Map());
+  const mountedRef = useRef5(true);
   useEffect5(() => {
     mountedRef.current = true;
     if (!ticketId) {
@@ -342,11 +363,11 @@ function useTyping(ticketId) {
 }
 
 // src/library/CStarLibraryProvider.tsx
-import { useRef as useRef5 } from "react";
+import { useRef as useRef6 } from "react";
 import { LibraryClient } from "@cstar.help/js/library";
 import { jsx as jsx2 } from "react/jsx-runtime";
 function CStarLibraryProvider({ children, ...config }) {
-  const clientRef = useRef5(null);
+  const clientRef = useRef6(null);
   if (!clientRef.current) {
     clientRef.current = new LibraryClient(config);
   }
@@ -354,13 +375,13 @@ function CStarLibraryProvider({ children, ...config }) {
 }
 
 // src/library/useCategories.ts
-import { useState as useState5, useEffect as useEffect6, useCallback as useCallback5, useRef as useRef6 } from "react";
+import { useState as useState5, useEffect as useEffect6, useCallback as useCallback5, useRef as useRef7 } from "react";
 function useCategories() {
   const client = useLibraryClient();
   const [categories, setCategories] = useState5([]);
   const [isLoading, setIsLoading] = useState5(true);
   const [error, setError] = useState5(null);
-  const mountedRef = useRef6(true);
+  const mountedRef = useRef7(true);
   const refresh = useCallback5(async () => {
     setIsLoading(true);
     setError(null);
@@ -390,13 +411,13 @@ function useCategories() {
 }
 
 // src/library/useArticles.ts
-import { useState as useState6, useEffect as useEffect7, useCallback as useCallback6, useRef as useRef7 } from "react";
+import { useState as useState6, useEffect as useEffect7, useCallback as useCallback6, useRef as useRef8 } from "react";
 function useArticles(params) {
   const client = useLibraryClient();
   const [articles, setArticles] = useState6([]);
   const [isLoading, setIsLoading] = useState6(true);
   const [error, setError] = useState6(null);
-  const mountedRef = useRef7(true);
+  const mountedRef = useRef8(true);
   const categorySlug = params?.categorySlug;
   const limit = params?.limit;
   const offset = params?.offset;
@@ -429,13 +450,13 @@ function useArticles(params) {
 }
 
 // src/library/useArticle.ts
-import { useState as useState7, useEffect as useEffect8, useCallback as useCallback7, useRef as useRef8 } from "react";
+import { useState as useState7, useEffect as useEffect8, useCallback as useCallback7, useRef as useRef9 } from "react";
 function useArticle(slug) {
   const client = useLibraryClient();
   const [article, setArticle] = useState7(null);
   const [isLoading, setIsLoading] = useState7(true);
   const [error, setError] = useState7(null);
-  const mountedRef = useRef8(true);
+  const mountedRef = useRef9(true);
   const refresh = useCallback7(async () => {
     if (!slug) return;
     setIsLoading(true);
@@ -478,7 +499,7 @@ function useArticle(slug) {
 }
 
 // src/library/useArticleSearch.ts
-import { useState as useState8, useEffect as useEffect9, useRef as useRef9 } from "react";
+import { useState as useState8, useEffect as useEffect9, useRef as useRef10 } from "react";
 var DEBOUNCE_MS = 300;
 function useArticleSearch(query) {
   const client = useLibraryClient();
@@ -486,7 +507,7 @@ function useArticleSearch(query) {
   const [totalCount, setTotalCount] = useState8(0);
   const [isLoading, setIsLoading] = useState8(false);
   const [error, setError] = useState8(null);
-  const mountedRef = useRef9(true);
+  const mountedRef = useRef10(true);
   useEffect9(() => {
     mountedRef.current = true;
     const trimmed = query.trim();
@@ -525,11 +546,11 @@ function useArticleSearch(query) {
 }
 
 // src/community/CStarCommunityProvider.tsx
-import { useRef as useRef10 } from "react";
+import { useRef as useRef11 } from "react";
 import { CommunityClient } from "@cstar.help/js/community";
 import { jsx as jsx3 } from "react/jsx-runtime";
 function CStarCommunityProvider({ children, ...config }) {
-  const clientRef = useRef10(null);
+  const clientRef = useRef11(null);
   if (!clientRef.current) {
     clientRef.current = new CommunityClient(config);
   }
@@ -537,13 +558,13 @@ function CStarCommunityProvider({ children, ...config }) {
 }
 
 // src/community/useTopics.ts
-import { useState as useState9, useEffect as useEffect10, useCallback as useCallback8, useRef as useRef11 } from "react";
+import { useState as useState9, useEffect as useEffect10, useCallback as useCallback8, useRef as useRef12 } from "react";
 function useTopics() {
   const client = useCommunityClient();
   const [topics, setTopics] = useState9([]);
   const [isLoading, setIsLoading] = useState9(true);
   const [error, setError] = useState9(null);
-  const mountedRef = useRef11(true);
+  const mountedRef = useRef12(true);
   const refresh = useCallback8(async () => {
     setIsLoading(true);
     setError(null);
@@ -573,14 +594,14 @@ function useTopics() {
 }
 
 // src/community/usePosts.ts
-import { useState as useState10, useEffect as useEffect11, useCallback as useCallback9, useRef as useRef12 } from "react";
+import { useState as useState10, useEffect as useEffect11, useCallback as useCallback9, useRef as useRef13 } from "react";
 function usePosts(params) {
   const client = useCommunityClient();
   const [posts, setPosts] = useState10([]);
   const [count, setCount] = useState10(0);
   const [isLoading, setIsLoading] = useState10(true);
   const [error, setError] = useState10(null);
-  const mountedRef = useRef12(true);
+  const mountedRef = useRef13(true);
   const topicSlug = params?.topicSlug;
   const status = params?.status;
   const sort = params?.sort;
@@ -616,13 +637,13 @@ function usePosts(params) {
 }
 
 // src/community/usePost.ts
-import { useState as useState11, useEffect as useEffect12, useCallback as useCallback10, useRef as useRef13 } from "react";
+import { useState as useState11, useEffect as useEffect12, useCallback as useCallback10, useRef as useRef14 } from "react";
 function usePost(slug) {
   const client = useCommunityClient();
   const [data, setData] = useState11(null);
   const [isLoading, setIsLoading] = useState11(true);
   const [error, setError] = useState11(null);
-  const mountedRef = useRef13(true);
+  const mountedRef = useRef14(true);
   const refresh = useCallback10(async () => {
     setIsLoading(true);
     setError(null);
@@ -652,13 +673,13 @@ function usePost(slug) {
 }
 
 // src/community/useCommunitySearch.ts
-import { useState as useState12, useEffect as useEffect13, useCallback as useCallback11, useRef as useRef14 } from "react";
+import { useState as useState12, useEffect as useEffect13, useCallback as useCallback11, useRef as useRef15 } 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);
+  const mountedRef = useRef15(true);
   useEffect13(() => {
     mountedRef.current = true;
     return () => {
@@ -694,7 +715,7 @@ function useCommunitySearch() {
 }
 
 // src/dashboard/CStarDashboardProvider.tsx
-import { createContext as createContext2, useContext as useContext2, useEffect as useEffect14, useMemo } from "react";
+import { createContext as createContext2, useContext as useContext2, useMemo } from "react";
 import { CStarClient } from "@cstar.help/js";
 import { jsx as jsx4 } from "react/jsx-runtime";
 var CStarDashboardContext = createContext2(null);
@@ -705,7 +726,7 @@ function CStarDashboardProvider({
 }) {
   if (!config && !providedClient) {
     throw new Error(
-      "CStarDashboardProvider requires either a `config` prop (`{ apiKey, teamId }`, recommended) or a `client` prop (a pre-built CStarClient instance, deprecated). See https://cstar.help/developers/sdk/react#dashboard"
+      "CStarDashboardProvider requires either a `config` prop (`{ apiKey, teamId }`, recommended) or a `client` prop (a pre-built CStarClient instance, deprecated). See https://www.cstar.help/developers/sdk/react#dashboard"
     );
   }
   const client = useMemo(() => {
@@ -721,12 +742,7 @@ function CStarDashboardProvider({
     config?.timeout
   ]);
   const contextValue = useMemo(() => ({ client }), [client]);
-  useEffect14(() => {
-    if (providedClient) return;
-    return () => {
-      client?.realtime?.disconnect?.();
-    };
-  }, [client, providedClient]);
+  useDisconnectOnUnmount(providedClient ? null : client, (owned) => owned.realtime?.disconnect?.());
   return /* @__PURE__ */ jsx4(CStarDashboardContext.Provider, { value: contextValue, children });
 }
 function useDashboardClient() {
@@ -738,7 +754,7 @@ function useDashboardClient() {
 }
 
 // src/dashboard/useCStarQuery.ts
-import { useState as useState13, useEffect as useEffect15, useRef as useRef15, useCallback as useCallback12 } from "react";
+import { useState as useState13, useEffect as useEffect14, useRef as useRef16, useCallback as useCallback12 } from "react";
 import { CStarValidationError } from "@cstar.help/js";
 function resolveResource(client, path) {
   const parts = path.split(".");
@@ -760,9 +776,9 @@ function useCStarQuery(resource, params) {
   const [data, setData] = useState13(null);
   const [loading, setLoading] = useState13(true);
   const [error, setError] = useState13(null);
-  const subscriptionRef = useRef15(null);
+  const subscriptionRef = useRef16(null);
   const paramsKey = params ? JSON.stringify(params) : "";
-  useEffect15(() => {
+  useEffect14(() => {
     const resolved = resolveResource(client, resource);
     if (!resolved) {
       setError(new Error(`Invalid resource path: ${resource}. Expected format: 'tickets.list'`));
@@ -849,14 +865,14 @@ function useCStarMutation(resource) {
 }
 
 // src/dashboard/useCStarEvents.ts
-import { useState as useState15, useEffect as useEffect16 } from "react";
+import { useState as useState15, useEffect as useEffect15 } 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(",") : "";
-  useEffect16(() => {
+  useEffect15(() => {
     const realtime = client.realtime;
     const handler = (event) => {
       if (types && types.length > 0) {
@@ -888,14 +904,14 @@ function useCStarEvents(types) {
 }
 
 // src/dashboard/useBossBattle.ts
-import { useState as useState16, useEffect as useEffect17, useRef as useRef16, useCallback as useCallback14 } from "react";
+import { useState as useState16, useEffect as useEffect16, 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 = useRef16(null);
-  useEffect17(() => {
+  const subRef = useRef17(null);
+  useEffect16(() => {
     const sub = client.game.subscribeBoss(client.realtime);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -919,14 +935,14 @@ function useBossBattle() {
 }
 
 // src/dashboard/usePlayerStats.ts
-import { useState as useState17, useEffect as useEffect18, useRef as useRef17, useCallback as useCallback15 } from "react";
+import { useState as useState17, useEffect as useEffect17, 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 = useRef17(null);
-  useEffect18(() => {
+  const subRef = useRef18(null);
+  useEffect17(() => {
     const sub = client.game.subscribePlayer(client.realtime, memberId);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -950,14 +966,14 @@ function usePlayerStats(memberId) {
 }
 
 // src/dashboard/useLeaderboard.ts
-import { useState as useState18, useEffect as useEffect19, useRef as useRef18, useCallback as useCallback16 } from "react";
+import { useState as useState18, useEffect as useEffect18, 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 = useRef18(null);
-  useEffect19(() => {
+  const subRef = useRef19(null);
+  useEffect18(() => {
     const sub = client.game.subscribeLeaderboard(client.realtime, period ? { period } : void 0);
     subRef.current = sub;
     sub.on("change", (data) => {
@@ -981,14 +997,14 @@ function useLeaderboard(period) {
 }
 
 // src/dashboard/useGameActivity.ts
-import { useState as useState19, useEffect as useEffect20, useRef as useRef19, useCallback as useCallback17 } from "react";
+import { useState as useState19, useEffect as useEffect19, 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 = useRef19(null);
-  useEffect20(() => {
+  const subRef = useRef20(null);
+  useEffect19(() => {
     const sub = client.game.subscribeActivity(client.realtime);
     subRef.current = sub;
     sub.on("change", (data) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cstar.help/react",
-	"version": "0.10.2",
+	"version": "0.10.3",
 	"description": "React hooks for the cStar customer support platform",
 	"type": "module",
 	"main": "./dist/index.cjs",