@useatlas/react 0.0.1

package/dist/hooks.cjs

@@ -0,0 +1,251 @@
+'use strict';
+
+var chunkUIRB6L36_cjs = require('./chunk-UIRB6L36.cjs');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+var react$1 = require('@ai-sdk/react');
+var ai = require('ai');
+
+var noopAuthClient = {
+  signIn: {
+    email: async () => {
+      console.warn("[Atlas] signIn called but no authClient was provided to AtlasProvider");
+      return { error: { message: "Auth client not configured" } };
+    }
+  },
+  signUp: {
+    email: async () => {
+      console.warn("[Atlas] signUp called but no authClient was provided to AtlasProvider");
+      return { error: { message: "Auth client not configured" } };
+    }
+  },
+  signOut: async () => {
+    console.warn("[Atlas] signOut called but no authClient was provided to AtlasProvider");
+  },
+  useSession: () => ({ data: null, isPending: false })
+};
+var AtlasContext = react.createContext(null);
+function useAtlasContext() {
+  const ctx = react.useContext(AtlasContext);
+  if (!ctx) throw new Error("useAtlasContext must be used within <AtlasProvider>");
+  return ctx;
+}
+function AtlasProvider({
+  apiUrl,
+  apiKey,
+  authClient = noopAuthClient,
+  children
+}) {
+  const isCrossOrigin = typeof window !== "undefined" && apiUrl !== "" && !apiUrl.startsWith(window.location.origin);
+  return /* @__PURE__ */ jsxRuntime.jsx(AtlasContext.Provider, { value: { apiUrl, apiKey, authClient, isCrossOrigin }, children });
+}
+function useAtlasChat(options = {}) {
+  const { apiUrl, apiKey, isCrossOrigin } = useAtlasContext();
+  const [conversationId, setConversationId] = react.useState(
+    options.initialConversationId ?? null
+  );
+  const conversationIdRef = react.useRef(conversationId);
+  conversationIdRef.current = conversationId;
+  const onChangeRef = react.useRef(options.onConversationIdChange);
+  onChangeRef.current = options.onConversationIdChange;
+  const transport = react.useMemo(() => {
+    const headers = {};
+    if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
+    return new ai.DefaultChatTransport({
+      api: `${apiUrl}/api/chat`,
+      headers,
+      credentials: isCrossOrigin ? "include" : void 0,
+      body: () => conversationIdRef.current ? { conversationId: conversationIdRef.current } : {},
+      fetch: (async (input2, init) => {
+        const response = await globalThis.fetch(input2, init);
+        const convId = response.headers.get("x-conversation-id");
+        if (convId && convId !== conversationIdRef.current) {
+          setConversationId(convId);
+          onChangeRef.current?.(convId);
+        }
+        return response;
+      })
+    });
+  }, [apiKey, apiUrl, isCrossOrigin]);
+  const { messages, setMessages, sendMessage: rawSend, status, error } = react$1.useChat({ transport });
+  const [input, setInput] = react.useState("");
+  const sendMessage = async (text) => {
+    const previousInput = input;
+    setInput("");
+    try {
+      await rawSend({ text });
+    } catch (err) {
+      setInput(previousInput);
+      throw err;
+    }
+  };
+  return {
+    messages,
+    setMessages,
+    sendMessage,
+    input,
+    setInput,
+    status,
+    isLoading: status === "streaming" || status === "submitted",
+    error: error ?? null,
+    conversationId,
+    setConversationId
+  };
+}
+function useAtlasAuth() {
+  const { apiUrl, apiKey, authClient, isCrossOrigin } = useAtlasContext();
+  const [authMode, setAuthMode] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const managedSession = authClient.useSession();
+  react.useEffect(() => {
+    let cancelled = false;
+    async function fetchHealth(attempt) {
+      try {
+        const res = await fetch(`${apiUrl}/api/health`, {
+          credentials: isCrossOrigin ? "include" : "same-origin"
+        });
+        if (!res.ok) {
+          console.warn(`[Atlas] Health check returned HTTP ${res.status} (attempt ${attempt})`);
+          if (attempt < 2 && !cancelled) {
+            await new Promise((r) => setTimeout(r, 2e3));
+            return fetchHealth(attempt + 1);
+          }
+          if (!cancelled) {
+            setError(new Error(`Health check failed with HTTP ${res.status}`));
+            setAuthMode("none");
+          }
+          return;
+        }
+        const data = await res.json();
+        const mode = data?.checks?.auth?.mode;
+        if (!cancelled) {
+          if (typeof mode === "string" && chunkUIRB6L36_cjs.AUTH_MODES.includes(mode)) {
+            setAuthMode(mode);
+          } else {
+            console.warn("[Atlas] Health check returned no valid auth mode:", data);
+            setAuthMode("none");
+          }
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(`[Atlas] Health check failed (attempt ${attempt}):`, message);
+        if (attempt < 2 && !cancelled) {
+          await new Promise((r) => setTimeout(r, 2e3));
+          return fetchHealth(attempt + 1);
+        }
+        if (!cancelled) {
+          setError(err instanceof Error ? err : new Error(message));
+          setAuthMode("none");
+        }
+      }
+    }
+    fetchHealth(1);
+    return () => {
+      cancelled = true;
+    };
+  }, [apiUrl, isCrossOrigin]);
+  const isAuthenticated = (() => {
+    if (authMode === null) return false;
+    if (authMode === "none") return true;
+    if (authMode === "simple-key" || authMode === "byot") return !!apiKey;
+    if (authMode === "managed") return !!managedSession.data?.user;
+    return false;
+  })();
+  const login = async (email, password) => {
+    try {
+      const result = await authClient.signIn.email({ email, password });
+      return { error: result.error?.message };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Login failed";
+      console.warn("[Atlas] login error:", message);
+      return { error: message };
+    }
+  };
+  const signup = async (email, password, name) => {
+    try {
+      const result = await authClient.signUp.email({ email, password, name });
+      return { error: result.error?.message };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Signup failed";
+      console.warn("[Atlas] signup error:", message);
+      return { error: message };
+    }
+  };
+  const logout = async () => {
+    try {
+      await authClient.signOut();
+      return {};
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Logout failed";
+      console.warn("[Atlas] logout error:", message);
+      return { error: message };
+    }
+  };
+  return {
+    authMode,
+    isAuthenticated,
+    session: managedSession.data ?? null,
+    isLoading: authMode === null || authMode === "managed" && !!managedSession.isPending,
+    error,
+    login,
+    signup,
+    logout
+  };
+}
+
+// src/hooks/use-atlas-theme.ts
+function useAtlasTheme() {
+  const theme = chunkUIRB6L36_cjs.useThemeMode();
+  const isDark = chunkUIRB6L36_cjs.useDarkMode();
+  return {
+    theme,
+    isDark,
+    setTheme: chunkUIRB6L36_cjs.setTheme,
+    applyBrandColor: chunkUIRB6L36_cjs.applyBrandColor
+  };
+}
+
+// src/hooks/use-atlas-conversations.ts
+function useAtlasConversations(options = {}) {
+  const { apiUrl, apiKey, isCrossOrigin } = useAtlasContext();
+  const { enabled = true } = options;
+  const inner = chunkUIRB6L36_cjs.useConversations({
+    apiUrl,
+    enabled,
+    getHeaders: () => {
+      const headers = {};
+      if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
+      return headers;
+    },
+    getCredentials: () => isCrossOrigin ? "include" : "same-origin"
+  });
+  return {
+    conversations: inner.conversations,
+    total: inner.total,
+    isLoading: inner.loading,
+    available: inner.available,
+    selectedId: inner.selectedId,
+    setSelectedId: inner.setSelectedId,
+    refresh: inner.refresh,
+    loadConversation: inner.loadConversation,
+    deleteConversation: inner.deleteConversation,
+    starConversation: inner.starConversation
+  };
+}
+
+Object.defineProperty(exports, "AUTH_MODES", {
+  enumerable: true,
+  get: function () { return chunkUIRB6L36_cjs.AUTH_MODES; }
+});
+Object.defineProperty(exports, "parseChatError", {
+  enumerable: true,
+  get: function () { return chunkUIRB6L36_cjs.parseChatError; }
+});
+exports.AtlasProvider = AtlasProvider;
+exports.useAtlasAuth = useAtlasAuth;
+exports.useAtlasChat = useAtlasChat;
+exports.useAtlasContext = useAtlasContext;
+exports.useAtlasConversations = useAtlasConversations;
+exports.useAtlasTheme = useAtlasTheme;
+//# sourceMappingURL=hooks.cjs.map
+//# sourceMappingURL=hooks.cjs.map

package/dist/hooks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/provider.tsx","../src/hooks/use-atlas-chat.ts","../src/hooks/use-atlas-auth.ts","../src/hooks/use-atlas-theme.ts","../src/hooks/use-atlas-conversations.ts"],"names":["createContext","useContext","jsx","useState","useRef","useMemo","DefaultChatTransport","input","useChat","useEffect","AUTH_MODES","useThemeMode","useDarkMode","setTheme","applyBrandColor","useConversations"],"mappings":";;;;;;;;AAyBA,IAAM,cAAA,GAAkC;AAAA,EACtC,MAAA,EAAQ;AAAA,IACN,OAAO,YAAY;AACjB,MAAA,OAAA,CAAQ,KAAK,uEAAuE,CAAA;AACpF,MAAA,OAAO,EAAE,KAAA,EAAO,EAAE,OAAA,EAAS,8BAA6B,EAAE;AAAA,IAC5D;AAAA,GACF;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,OAAO,YAAY;AACjB,MAAA,OAAA,CAAQ,KAAK,uEAAuE,CAAA;AACpF,MAAA,OAAO,EAAE,KAAA,EAAO,EAAE,OAAA,EAAS,8BAA6B,EAAE;AAAA,IAC5D;AAAA,GACF;AAAA,EACA,SAAS,YAAY;AACnB,IAAA,OAAA,CAAQ,KAAK,wEAAwE,CAAA;AAAA,EACvF,CAAA;AAAA,EACA,YAAY,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,WAAW,KAAA,EAAM;AACpD,CAAA;AAEA,IAAM,YAAA,GAAeA,oBAAwC,IAAI,CAAA;AAG1D,SAAS,eAAA,GAAqC;AACnD,EAAA,MAAM,GAAA,GAAMC,iBAAW,YAAY,CAAA;AACnC,EAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAC/E,EAAA,OAAO,GAAA;AACT;AASO,SAAS,aAAA,CAAc;AAAA,EAC5B,MAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA,GAAa,cAAA;AAAA,EACb;AACF,CAAA,EAAuB;AACrB,EAAA,MAAM,aAAA,GACJ,OAAO,MAAA,KAAW,WAAA,IAClB,MAAA,KAAW,EAAA,IACX,CAAC,MAAA,CAAO,UAAA,CAAW,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA;AAE3C,EAAA,uBACEC,cAAA,CAAC,YAAA,CAAa,QAAA,EAAb,EAAsB,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,UAAA,EAAY,aAAA,EAAc,EACvE,QAAA,EACH,CAAA;AAEJ;ACtCO,SAAS,YAAA,CAAa,OAAA,GAA+B,EAAC,EAAuB;AAClF,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,aAAA,KAAkB,eAAA,EAAgB;AAC1D,EAAA,MAAM,CAAC,cAAA,EAAgB,iBAAiB,CAAA,GAAIC,cAAA;AAAA,IAC1C,QAAQ,qBAAA,IAAyB;AAAA,GACnC;AACA,EAAA,MAAM,iBAAA,GAAoBC,aAAO,cAAc,CAAA;AAC/C,EAAA,iBAAA,CAAkB,OAAA,GAAU,cAAA;AAE5B,EAAA,MAAM,WAAA,GAAcA,YAAA,CAAO,OAAA,CAAQ,sBAAsB,CAAA;AACzD,EAAA,WAAA,CAAY,UAAU,OAAA,CAAQ,sBAAA;AAE9B,EAAA,MAAM,SAAA,GAAYC,cAAQ,MAAM;AAC9B,IAAA,MAAM,UAAkC,EAAC;AACzC,IAAA,IAAI,MAAA,EAAQ,OAAA,CAAQ,eAAe,CAAA,GAAI,UAAU,MAAM,CAAA,CAAA;AAEvD,IAAA,OAAO,IAAIC,uBAAA,CAAqB;AAAA,MAC9B,GAAA,EAAK,GAAG,MAAM,CAAA,SAAA,CAAA;AAAA,MACd,OAAA;AAAA,MACA,WAAA,EAAa,gBAAgB,SAAA,GAAY,MAAA;AAAA,MACzC,IAAA,EAAM,MACJ,iBAAA,CAAkB,OAAA,GACd,EAAE,cAAA,EAAgB,iBAAA,CAAkB,OAAA,EAAQ,GAC5C,EAAC;AAAA,MACP,KAAA,GAAQ,OAAOC,MAAAA,EAA0B,IAAA,KAAuB;AAC9D,QAAA,MAAM,QAAA,GAAW,MAAM,UAAA,CAAW,KAAA,CAAMA,QAAO,IAAI,CAAA;AACnD,QAAA,MAAM,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,mBAAmB,CAAA;AACvD,QAAA,IAAI,MAAA,IAAU,MAAA,KAAW,iBAAA,CAAkB,OAAA,EAAS;AAClD,UAAA,iBAAA,CAAkB,MAAM,CAAA;AACxB,UAAA,WAAA,CAAY,UAAU,MAAM,CAAA;AAAA,QAC9B;AACA,QAAA,OAAO,QAAA;AAAA,MACT,CAAA;AAAA,KACD,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,MAAA,EAAQ,MAAA,EAAQ,aAAa,CAAC,CAAA;AAElC,EAAA,MAAM,EAAE,QAAA,EAAU,WAAA,EAAa,WAAA,EAAa,OAAA,EAAS,MAAA,EAAQ,KAAA,EAAM,GACjEC,eAAA,CAAQ,EAAE,SAAA,EAAW,CAAA;AAEvB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIL,eAAS,EAAE,CAAA;AAErC,EAAA,MAAM,WAAA,GAAc,OAAO,IAAA,KAAiB;AAC1C,IAAA,MAAM,aAAA,GAAgB,KAAA;AACtB,IAAA,QAAA,CAAS,EAAE,CAAA;AACX,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,CAAQ,EAAE,IAAA,EAAM,CAAA;AAAA,IACxB,SAAS,GAAA,EAAK;AACZ,MAAA,QAAA,CAAS,aAAa,CAAA;AACtB,MAAA,MAAM,GAAA;AAAA,IACR;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,WAAA;AAAA,IACA,WAAA;AAAA,IACA,KAAA;AAAA,IACA,QAAA;AAAA,IACA,MAAA;AAAA,IACA,SAAA,EAAW,MAAA,KAAW,WAAA,IAAe,MAAA,KAAW,WAAA;AAAA,IAChD,OAAO,KAAA,IAAS,IAAA;AAAA,IAChB,cAAA;AAAA,IACA;AAAA,GACF;AACF;AC5EO,SAAS,YAAA,GAAmC;AACjD,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,UAAA,EAAY,aAAA,KAAkB,eAAA,EAAgB;AACtE,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIA,eAA0B,IAAI,CAAA;AAC9D,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAuB,IAAI,CAAA;AACrD,EAAA,MAAM,cAAA,GAAiB,WAAW,UAAA,EAAW;AAE7C,EAAAM,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,KAAA;AAEhB,IAAA,eAAe,YAAY,OAAA,EAAgC;AACzD,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,MAAM,CAAA,WAAA,CAAA,EAAe;AAAA,UAC9C,WAAA,EAAa,gBAAgB,SAAA,GAAY;AAAA,SAC1C,CAAA;AACD,QAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,UAAA,OAAA,CAAQ,KAAK,CAAA,mCAAA,EAAsC,GAAA,CAAI,MAAM,CAAA,UAAA,EAAa,OAAO,CAAA,CAAA,CAAG,CAAA;AACpF,UAAA,IAAI,OAAA,GAAU,CAAA,IAAK,CAAC,SAAA,EAAW;AAC7B,YAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,GAAI,CAAC,CAAA;AAC5C,YAAA,OAAO,WAAA,CAAY,UAAU,CAAC,CAAA;AAAA,UAChC;AACA,UAAA,IAAI,CAAC,SAAA,EAAW;AACd,YAAA,QAAA,CAAS,IAAI,KAAA,CAAM,CAAA,8BAAA,EAAiC,GAAA,CAAI,MAAM,EAAE,CAAC,CAAA;AACjE,YAAA,WAAA,CAAY,MAAM,CAAA;AAAA,UACpB;AACA,UAAA;AAAA,QACF;AACA,QAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,QAAA,MAAM,IAAA,GAAO,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,IAAA;AACjC,QAAA,IAAI,CAAC,SAAA,EAAW;AACd,UAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAYC,4BAAA,CAAW,QAAA,CAAS,IAAgB,CAAA,EAAG;AACrE,YAAA,WAAA,CAAY,IAAgB,CAAA;AAAA,UAC9B,CAAA,MAAO;AACL,YAAA,OAAA,CAAQ,IAAA,CAAK,qDAAqD,IAAI,CAAA;AACtE,YAAA,WAAA,CAAY,MAAM,CAAA;AAAA,UACpB;AAAA,QACF;AAAA,MACF,SAAS,GAAA,EAAK;AACZ,QAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,QAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,qCAAA,EAAwC,OAAO,CAAA,EAAA,CAAA,EAAM,OAAO,CAAA;AACzE,QAAA,IAAI,OAAA,GAAU,CAAA,IAAK,CAAC,SAAA,EAAW;AAC7B,UAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,GAAI,CAAC,CAAA;AAC5C,UAAA,OAAO,WAAA,CAAY,UAAU,CAAC,CAAA;AAAA,QAChC;AACA,QAAA,IAAI,CAAC,SAAA,EAAW;AACd,UAAA,QAAA,CAAS,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,OAAO,CAAC,CAAA;AACxD,UAAA,WAAA,CAAY,MAAM,CAAA;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,WAAA,CAAY,CAAC,CAAA;AACb,IAAA,OAAO,MAAM;AAAE,MAAA,SAAA,GAAY,IAAA;AAAA,IAAM,CAAA;AAAA,EACnC,CAAA,EAAG,CAAC,MAAA,EAAQ,aAAa,CAAC,CAAA;AAE1B,EAAA,MAAM,mBAAmB,MAAM;AAC7B,IAAA,IAAI,QAAA,KAAa,MAAM,OAAO,KAAA;AAC9B,IAAA,IAAI,QAAA,KAAa,QAAQ,OAAO,IAAA;AAChC,IAAA,IAAI,aAAa,YAAA,IAAgB,QAAA,KAAa,MAAA,EAAQ,OAAO,CAAC,CAAC,MAAA;AAC/D,IAAA,IAAI,aAAa,SAAA,EAAW,OAAO,CAAC,CAAC,eAAe,IAAA,EAAM,IAAA;AAC1D,IAAA,OAAO,KAAA;AAAA,EACT,CAAA,GAAG;AAEH,EAAA,MAAM,KAAA,GAAQ,OAAO,KAAA,EAAe,QAAA,KAAqB;AACvD,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW,MAAA,CAAO,MAAM,EAAE,KAAA,EAAO,UAAU,CAAA;AAChE,MAAA,OAAO,EAAE,KAAA,EAAO,MAAA,CAAO,KAAA,EAAO,OAAA,EAAQ;AAAA,IACxC,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,OAAA,GAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,cAAA;AACrD,MAAA,OAAA,CAAQ,IAAA,CAAK,wBAAwB,OAAO,CAAA;AAC5C,MAAA,OAAO,EAAE,OAAO,OAAA,EAAQ;AAAA,IAC1B;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,MAAA,GAAS,OAAO,KAAA,EAAe,QAAA,EAAkB,IAAA,KAAiB;AACtE,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW,MAAA,CAAO,MAAM,EAAE,KAAA,EAAO,QAAA,EAAU,IAAA,EAAM,CAAA;AACtE,MAAA,OAAO,EAAE,KAAA,EAAO,MAAA,CAAO,KAAA,EAAO,OAAA,EAAQ;AAAA,IACxC,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,OAAA,GAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,eAAA;AACrD,MAAA,OAAA,CAAQ,IAAA,CAAK,yBAAyB,OAAO,CAAA;AAC7C,MAAA,OAAO,EAAE,OAAO,OAAA,EAAQ;AAAA,IAC1B;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,SAAS,YAAY;AACzB,IAAA,IAAI;AACF,MAAA,MAAM,WAAW,OAAA,EAAQ;AACzB,MAAA,OAAO,EAAC;AAAA,IACV,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,OAAA,GAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,eAAA;AACrD,MAAA,OAAA,CAAQ,IAAA,CAAK,yBAAyB,OAAO,CAAA;AAC7C,MAAA,OAAO,EAAE,OAAO,OAAA,EAAQ;AAAA,IAC1B;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,eAAA;AAAA,IACA,OAAA,EAAS,eAAe,IAAA,IAAQ,IAAA;AAAA,IAChC,WAAW,QAAA,KAAa,IAAA,IAAS,aAAa,SAAA,IAAa,CAAC,CAAC,cAAA,CAAe,SAAA;AAAA,IAC5E,KAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA;AAAA,GACF;AACF;;;AC3GO,SAAS,aAAA,GAAqC;AACnD,EAAA,MAAM,QAAQC,8BAAA,EAAa;AAC3B,EAAA,MAAM,SAASC,6BAAA,EAAY;AAE3B,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,MAAA;AAAA,cACAC,0BAAA;AAAA,qBACAC;AAAA,GACF;AACF;;;ACFO,SAAS,qBAAA,CACd,OAAA,GAAwC,EAAC,EACZ;AAC7B,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,aAAA,KAAkB,eAAA,EAAgB;AAC1D,EAAA,MAAM,EAAE,OAAA,GAAU,IAAA,EAAK,GAAI,OAAA;AAE3B,EAAA,MAAM,QAAQC,kCAAA,CAAiB;AAAA,IAC7B,MAAA;AAAA,IACA,OAAA;AAAA,IACA,YAAY,MAAM;AAChB,MAAA,MAAM,UAAkC,EAAC;AACzC,MAAA,IAAI,MAAA,EAAQ,OAAA,CAAQ,eAAe,CAAA,GAAI,UAAU,MAAM,CAAA,CAAA;AACvD,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,cAAA,EAAgB,MAAO,aAAA,GAAgB,SAAA,GAAY;AAAA,GACpD,CAAA;AAED,EAAA,OAAO;AAAA,IACL,eAAe,KAAA,CAAM,aAAA;AAAA,IACrB,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,WAAW,KAAA,CAAM,OAAA;AAAA,IACjB,WAAW,KAAA,CAAM,SAAA;AAAA,IACjB,YAAY,KAAA,CAAM,UAAA;AAAA,IAClB,eAAe,KAAA,CAAM,aAAA;AAAA,IACrB,SAAS,KAAA,CAAM,OAAA;AAAA,IACf,kBAAkB,KAAA,CAAM,gBAAA;AAAA,IACxB,oBAAoB,KAAA,CAAM,kBAAA;AAAA,IAC1B,kBAAkB,KAAA,CAAM;AAAA,GAC1B;AACF","file":"hooks.cjs","sourcesContent":["\"use client\";\n\nimport { createContext, useContext, type ReactNode } from \"react\";\nimport type { AtlasAuthClient } from \"../context\";\n\nexport type { AtlasAuthClient };\n\nexport interface AtlasProviderProps {\n  /** Atlas API server URL (e.g. \"https://api.example.com\" or \"\" for same-origin). */\n  apiUrl: string;\n  /** API key for simple-key auth mode. Sent as Bearer token. Accessible in context by all hooks. */\n  apiKey?: string;\n  /** Custom auth client for managed auth mode (better-auth compatible). */\n  authClient?: AtlasAuthClient;\n  children: ReactNode;\n}\n\nexport interface AtlasContextValue {\n  apiUrl: string;\n  apiKey: string | undefined;\n  authClient: AtlasAuthClient;\n  isCrossOrigin: boolean;\n}\n\n/** No-op auth client for non-managed auth modes. Warns when auth operations are attempted. */\nconst noopAuthClient: AtlasAuthClient = {\n  signIn: {\n    email: async () => {\n      console.warn(\"[Atlas] signIn called but no authClient was provided to AtlasProvider\");\n      return { error: { message: \"Auth client not configured\" } };\n    },\n  },\n  signUp: {\n    email: async () => {\n      console.warn(\"[Atlas] signUp called but no authClient was provided to AtlasProvider\");\n      return { error: { message: \"Auth client not configured\" } };\n    },\n  },\n  signOut: async () => {\n    console.warn(\"[Atlas] signOut called but no authClient was provided to AtlasProvider\");\n  },\n  useSession: () => ({ data: null, isPending: false }),\n};\n\nconst AtlasContext = createContext<AtlasContextValue | null>(null);\n\n/** Access the AtlasProvider context. Throws if used outside <AtlasProvider>. */\nexport function useAtlasContext(): AtlasContextValue {\n  const ctx = useContext(AtlasContext);\n  if (!ctx) throw new Error(\"useAtlasContext must be used within <AtlasProvider>\");\n  return ctx;\n}\n\n/**\n * Lightweight provider for headless Atlas hooks.\n *\n * Wraps your app and supplies API URL, auth credentials, and an optional\n * better-auth client to all Atlas hooks. Derives isCrossOrigin from apiUrl\n * to configure credential handling for cross-origin requests.\n */\nexport function AtlasProvider({\n  apiUrl,\n  apiKey,\n  authClient = noopAuthClient,\n  children,\n}: AtlasProviderProps) {\n  const isCrossOrigin =\n    typeof window !== \"undefined\" &&\n    apiUrl !== \"\" &&\n    !apiUrl.startsWith(window.location.origin);\n\n  return (\n    <AtlasContext.Provider value={{ apiUrl, apiKey, authClient, isCrossOrigin }}>\n      {children}\n    </AtlasContext.Provider>\n  );\n}\n","\"use client\";\n\nimport { useState, useRef, useMemo } from \"react\";\nimport { useChat, type UIMessage } from \"@ai-sdk/react\";\nimport { DefaultChatTransport } from \"ai\";\nimport { useAtlasContext } from \"./provider\";\n\nexport type AtlasChatStatus = \"submitted\" | \"streaming\" | \"ready\" | \"error\";\n\nexport interface UseAtlasChatOptions {\n  /** Conversation ID to associate with this chat session. The server will append messages to this conversation. To load prior messages, use loadConversation() from useAtlasConversations and pass them via setMessages. */\n  initialConversationId?: string;\n  /** Called when the server assigns or changes the conversation ID. */\n  onConversationIdChange?: (id: string) => void;\n}\n\nexport interface UseAtlasChatReturn {\n  messages: UIMessage[];\n  /** Replace all messages, or update via callback `(prev) => next`. */\n  setMessages: (messages: UIMessage[] | ((prev: UIMessage[]) => UIMessage[])) => void;\n  /** Send a text message. Rejects on failure (also surfaces via `error`). */\n  sendMessage: (text: string) => Promise<void>;\n  /** Current input value (managed by the hook). */\n  input: string;\n  /** Update the input value. */\n  setInput: (input: string) => void;\n  /** Chat status from the AI SDK. */\n  status: AtlasChatStatus;\n  /** Whether the chat is currently loading (streaming or submitted). */\n  isLoading: boolean;\n  /** Last error, if any. */\n  error: Error | null;\n  /** Current conversation ID. Initially set from options, updated when the server returns an x-conversation-id header. */\n  conversationId: string | null;\n  /** Manually set the conversation ID. */\n  setConversationId: (id: string | null) => void;\n}\n\nexport function useAtlasChat(options: UseAtlasChatOptions = {}): UseAtlasChatReturn {\n  const { apiUrl, apiKey, isCrossOrigin } = useAtlasContext();\n  const [conversationId, setConversationId] = useState<string | null>(\n    options.initialConversationId ?? null,\n  );\n  const conversationIdRef = useRef(conversationId);\n  conversationIdRef.current = conversationId;\n\n  const onChangeRef = useRef(options.onConversationIdChange);\n  onChangeRef.current = options.onConversationIdChange;\n\n  const transport = useMemo(() => {\n    const headers: Record<string, string> = {};\n    if (apiKey) headers[\"Authorization\"] = `Bearer ${apiKey}`;\n\n    return new DefaultChatTransport({\n      api: `${apiUrl}/api/chat`,\n      headers,\n      credentials: isCrossOrigin ? \"include\" : undefined,\n      body: () =>\n        conversationIdRef.current\n          ? { conversationId: conversationIdRef.current }\n          : {},\n      fetch: (async (input: RequestInfo | URL, init?: RequestInit) => {\n        const response = await globalThis.fetch(input, init);\n        const convId = response.headers.get(\"x-conversation-id\");\n        if (convId && convId !== conversationIdRef.current) {\n          setConversationId(convId);\n          onChangeRef.current?.(convId);\n        }\n        return response;\n      }) as typeof fetch,\n    });\n  }, [apiKey, apiUrl, isCrossOrigin]);\n\n  const { messages, setMessages, sendMessage: rawSend, status, error } =\n    useChat({ transport });\n\n  const [input, setInput] = useState(\"\");\n\n  const sendMessage = async (text: string) => {\n    const previousInput = input;\n    setInput(\"\");\n    try {\n      await rawSend({ text });\n    } catch (err) {\n      setInput(previousInput);\n      throw err;\n    }\n  };\n\n  return {\n    messages,\n    setMessages,\n    sendMessage,\n    input,\n    setInput,\n    status: status as AtlasChatStatus,\n    isLoading: status === \"streaming\" || status === \"submitted\",\n    error: error ?? null,\n    conversationId,\n    setConversationId,\n  };\n}\n","\"use client\";\n\nimport { useState, useEffect } from \"react\";\nimport { useAtlasContext } from \"./provider\";\nimport { AUTH_MODES, type AuthMode } from \"../lib/types\";\n\nexport interface UseAtlasAuthReturn {\n  /** Auth mode detected from the server's /api/health endpoint. `null` while the initial health check is in flight. */\n  authMode: AuthMode | null;\n  /** Whether the user is authenticated (based on auth mode, API key, or session). */\n  isAuthenticated: boolean;\n  /** Session data for managed auth mode. */\n  session: { user?: { email?: string } } | null;\n  /** Whether auth state is still being resolved (health check or managed session loading). */\n  isLoading: boolean;\n  /** Error from health check or auth operations. `null` when healthy. */\n  error: Error | null;\n  /** Sign in with email/password (managed auth). */\n  login: (email: string, password: string) => Promise<{ error?: string }>;\n  /** Sign up with email/password/name (managed auth). */\n  signup: (email: string, password: string, name: string) => Promise<{ error?: string }>;\n  /** Sign out (managed auth). */\n  logout: () => Promise<{ error?: string }>;\n}\n\nexport function useAtlasAuth(): UseAtlasAuthReturn {\n  const { apiUrl, apiKey, authClient, isCrossOrigin } = useAtlasContext();\n  const [authMode, setAuthMode] = useState<AuthMode | null>(null);\n  const [error, setError] = useState<Error | null>(null);\n  const managedSession = authClient.useSession();\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function fetchHealth(attempt: number): Promise<void> {\n      try {\n        const res = await fetch(`${apiUrl}/api/health`, {\n          credentials: isCrossOrigin ? \"include\" : \"same-origin\",\n        });\n        if (!res.ok) {\n          console.warn(`[Atlas] Health check returned HTTP ${res.status} (attempt ${attempt})`);\n          if (attempt < 2 && !cancelled) {\n            await new Promise((r) => setTimeout(r, 2000));\n            return fetchHealth(attempt + 1);\n          }\n          if (!cancelled) {\n            setError(new Error(`Health check failed with HTTP ${res.status}`));\n            setAuthMode(\"none\");\n          }\n          return;\n        }\n        const data = await res.json();\n        const mode = data?.checks?.auth?.mode;\n        if (!cancelled) {\n          if (typeof mode === \"string\" && AUTH_MODES.includes(mode as AuthMode)) {\n            setAuthMode(mode as AuthMode);\n          } else {\n            console.warn(\"[Atlas] Health check returned no valid auth mode:\", data);\n            setAuthMode(\"none\");\n          }\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        console.warn(`[Atlas] Health check failed (attempt ${attempt}):`, message);\n        if (attempt < 2 && !cancelled) {\n          await new Promise((r) => setTimeout(r, 2000));\n          return fetchHealth(attempt + 1);\n        }\n        if (!cancelled) {\n          setError(err instanceof Error ? err : new Error(message));\n          setAuthMode(\"none\");\n        }\n      }\n    }\n\n    fetchHealth(1);\n    return () => { cancelled = true; };\n  }, [apiUrl, isCrossOrigin]);\n\n  const isAuthenticated = (() => {\n    if (authMode === null) return false;\n    if (authMode === \"none\") return true;\n    if (authMode === \"simple-key\" || authMode === \"byot\") return !!apiKey;\n    if (authMode === \"managed\") return !!managedSession.data?.user;\n    return false;\n  })();\n\n  const login = async (email: string, password: string) => {\n    try {\n      const result = await authClient.signIn.email({ email, password });\n      return { error: result.error?.message };\n    } catch (err) {\n      const message = err instanceof Error ? err.message : \"Login failed\";\n      console.warn(\"[Atlas] login error:\", message);\n      return { error: message };\n    }\n  };\n\n  const signup = async (email: string, password: string, name: string) => {\n    try {\n      const result = await authClient.signUp.email({ email, password, name });\n      return { error: result.error?.message };\n    } catch (err) {\n      const message = err instanceof Error ? err.message : \"Signup failed\";\n      console.warn(\"[Atlas] signup error:\", message);\n      return { error: message };\n    }\n  };\n\n  const logout = async () => {\n    try {\n      await authClient.signOut();\n      return {};\n    } catch (err) {\n      const message = err instanceof Error ? err.message : \"Logout failed\";\n      console.warn(\"[Atlas] logout error:\", message);\n      return { error: message };\n    }\n  };\n\n  return {\n    authMode,\n    isAuthenticated,\n    session: managedSession.data ?? null,\n    isLoading: authMode === null || (authMode === \"managed\" && !!managedSession.isPending),\n    error,\n    login,\n    signup,\n    logout,\n  };\n}\n","\"use client\";\n\nimport {\n  useDarkMode,\n  useThemeMode,\n  setTheme,\n  applyBrandColor,\n  type ThemeMode,\n} from \"./use-dark-mode\";\n\nexport type { ThemeMode };\n\nexport interface UseAtlasThemeReturn {\n  /** Current theme setting: \"light\", \"dark\", or \"system\". */\n  theme: ThemeMode;\n  /** Whether the effective (resolved) theme is dark. */\n  isDark: boolean;\n  /** Set the theme mode. Persists to localStorage. */\n  setTheme: (mode: ThemeMode) => void;\n  /** Apply a brand color (oklch format, e.g. \"oklch(0.759 0.148 167.71)\") via CSS custom property --atlas-brand. */\n  applyBrandColor: (color: string) => void;\n}\n\nexport function useAtlasTheme(): UseAtlasThemeReturn {\n  const theme = useThemeMode();\n  const isDark = useDarkMode();\n\n  return {\n    theme,\n    isDark,\n    setTheme,\n    applyBrandColor,\n  };\n}\n","\"use client\";\n\nimport type { UIMessage } from \"@ai-sdk/react\";\nimport { useAtlasContext } from \"./provider\";\nimport { useConversations } from \"./use-conversations\";\nimport type { Conversation } from \"../lib/types\";\n\nexport interface UseAtlasConversationsOptions {\n  /** When false, refresh() becomes a no-op. Defaults to true. */\n  enabled?: boolean;\n}\n\nexport interface UseAtlasConversationsReturn {\n  conversations: Conversation[];\n  total: number;\n  isLoading: boolean;\n  available: boolean;\n  selectedId: string | null;\n  setSelectedId: (id: string | null) => void;\n  refresh: () => Promise<void>;\n  loadConversation: (id: string) => Promise<UIMessage[] | null>;\n  deleteConversation: (id: string) => Promise<boolean>;\n  starConversation: (id: string, starred: boolean) => Promise<boolean>;\n}\n\n/**\n * Manage conversation history with auth automatically wired from AtlasProvider.\n *\n * Wraps the lower-level `useConversations` hook with context-derived\n * API URL and credentials.\n */\nexport function useAtlasConversations(\n  options: UseAtlasConversationsOptions = {},\n): UseAtlasConversationsReturn {\n  const { apiUrl, apiKey, isCrossOrigin } = useAtlasContext();\n  const { enabled = true } = options;\n\n  const inner = useConversations({\n    apiUrl,\n    enabled,\n    getHeaders: () => {\n      const headers: Record<string, string> = {};\n      if (apiKey) headers[\"Authorization\"] = `Bearer ${apiKey}`;\n      return headers;\n    },\n    getCredentials: () => (isCrossOrigin ? \"include\" : \"same-origin\"),\n  });\n\n  return {\n    conversations: inner.conversations,\n    total: inner.total,\n    isLoading: inner.loading,\n    available: inner.available,\n    selectedId: inner.selectedId,\n    setSelectedId: inner.setSelectedId,\n    refresh: inner.refresh,\n    loadConversation: inner.loadConversation,\n    deleteConversation: inner.deleteConversation,\n    starConversation: inner.starConversation,\n  };\n}\n"]}

package/dist/hooks.d.cts

@@ -0,0 +1,132 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { A as AtlasAuthClient, T as ThemeMode } from './use-dark-mode-rFxawUv1.cjs';
+export { E as ExploreToolResult, P as PythonToolResult, S as SQLToolResult, d as ToolRendererProps, a as ToolRenderers } from './use-dark-mode-rFxawUv1.cjs';
+import { UIMessage } from '@ai-sdk/react';
+import { AuthMode, Conversation } from '@useatlas/types';
+export { AUTH_MODES, AuthMode, ChatErrorCode, ChatErrorInfo, Conversation, ConversationWithMessages, Message } from '@useatlas/types';
+export { parseChatError } from '@useatlas/types/errors';
+
+interface AtlasProviderProps {
+    /** Atlas API server URL (e.g. "https://api.example.com" or "" for same-origin). */
+    apiUrl: string;
+    /** API key for simple-key auth mode. Sent as Bearer token. Accessible in context by all hooks. */
+    apiKey?: string;
+    /** Custom auth client for managed auth mode (better-auth compatible). */
+    authClient?: AtlasAuthClient;
+    children: ReactNode;
+}
+interface AtlasContextValue {
+    apiUrl: string;
+    apiKey: string | undefined;
+    authClient: AtlasAuthClient;
+    isCrossOrigin: boolean;
+}
+/** Access the AtlasProvider context. Throws if used outside <AtlasProvider>. */
+declare function useAtlasContext(): AtlasContextValue;
+/**
+ * Lightweight provider for headless Atlas hooks.
+ *
+ * Wraps your app and supplies API URL, auth credentials, and an optional
+ * better-auth client to all Atlas hooks. Derives isCrossOrigin from apiUrl
+ * to configure credential handling for cross-origin requests.
+ */
+declare function AtlasProvider({ apiUrl, apiKey, authClient, children, }: AtlasProviderProps): react_jsx_runtime.JSX.Element;
+
+type AtlasChatStatus = "submitted" | "streaming" | "ready" | "error";
+interface UseAtlasChatOptions {
+    /** Conversation ID to associate with this chat session. The server will append messages to this conversation. To load prior messages, use loadConversation() from useAtlasConversations and pass them via setMessages. */
+    initialConversationId?: string;
+    /** Called when the server assigns or changes the conversation ID. */
+    onConversationIdChange?: (id: string) => void;
+}
+interface UseAtlasChatReturn {
+    messages: UIMessage[];
+    /** Replace all messages, or update via callback `(prev) => next`. */
+    setMessages: (messages: UIMessage[] | ((prev: UIMessage[]) => UIMessage[])) => void;
+    /** Send a text message. Rejects on failure (also surfaces via `error`). */
+    sendMessage: (text: string) => Promise<void>;
+    /** Current input value (managed by the hook). */
+    input: string;
+    /** Update the input value. */
+    setInput: (input: string) => void;
+    /** Chat status from the AI SDK. */
+    status: AtlasChatStatus;
+    /** Whether the chat is currently loading (streaming or submitted). */
+    isLoading: boolean;
+    /** Last error, if any. */
+    error: Error | null;
+    /** Current conversation ID. Initially set from options, updated when the server returns an x-conversation-id header. */
+    conversationId: string | null;
+    /** Manually set the conversation ID. */
+    setConversationId: (id: string | null) => void;
+}
+declare function useAtlasChat(options?: UseAtlasChatOptions): UseAtlasChatReturn;
+
+interface UseAtlasAuthReturn {
+    /** Auth mode detected from the server's /api/health endpoint. `null` while the initial health check is in flight. */
+    authMode: AuthMode | null;
+    /** Whether the user is authenticated (based on auth mode, API key, or session). */
+    isAuthenticated: boolean;
+    /** Session data for managed auth mode. */
+    session: {
+        user?: {
+            email?: string;
+        };
+    } | null;
+    /** Whether auth state is still being resolved (health check or managed session loading). */
+    isLoading: boolean;
+    /** Error from health check or auth operations. `null` when healthy. */
+    error: Error | null;
+    /** Sign in with email/password (managed auth). */
+    login: (email: string, password: string) => Promise<{
+        error?: string;
+    }>;
+    /** Sign up with email/password/name (managed auth). */
+    signup: (email: string, password: string, name: string) => Promise<{
+        error?: string;
+    }>;
+    /** Sign out (managed auth). */
+    logout: () => Promise<{
+        error?: string;
+    }>;
+}
+declare function useAtlasAuth(): UseAtlasAuthReturn;
+
+interface UseAtlasThemeReturn {
+    /** Current theme setting: "light", "dark", or "system". */
+    theme: ThemeMode;
+    /** Whether the effective (resolved) theme is dark. */
+    isDark: boolean;
+    /** Set the theme mode. Persists to localStorage. */
+    setTheme: (mode: ThemeMode) => void;
+    /** Apply a brand color (oklch format, e.g. "oklch(0.759 0.148 167.71)") via CSS custom property --atlas-brand. */
+    applyBrandColor: (color: string) => void;
+}
+declare function useAtlasTheme(): UseAtlasThemeReturn;
+
+interface UseAtlasConversationsOptions {
+    /** When false, refresh() becomes a no-op. Defaults to true. */
+    enabled?: boolean;
+}
+interface UseAtlasConversationsReturn {
+    conversations: Conversation[];
+    total: number;
+    isLoading: boolean;
+    available: boolean;
+    selectedId: string | null;
+    setSelectedId: (id: string | null) => void;
+    refresh: () => Promise<void>;
+    loadConversation: (id: string) => Promise<UIMessage[] | null>;
+    deleteConversation: (id: string) => Promise<boolean>;
+    starConversation: (id: string, starred: boolean) => Promise<boolean>;
+}
+/**
+ * Manage conversation history with auth automatically wired from AtlasProvider.
+ *
+ * Wraps the lower-level `useConversations` hook with context-derived
+ * API URL and credentials.
+ */
+declare function useAtlasConversations(options?: UseAtlasConversationsOptions): UseAtlasConversationsReturn;
+
+export { AtlasAuthClient, type AtlasChatStatus, type AtlasContextValue, AtlasProvider, type AtlasProviderProps, ThemeMode, type UseAtlasAuthReturn, type UseAtlasChatOptions, type UseAtlasChatReturn, type UseAtlasConversationsOptions, type UseAtlasConversationsReturn, type UseAtlasThemeReturn, useAtlasAuth, useAtlasChat, useAtlasContext, useAtlasConversations, useAtlasTheme };

package/dist/hooks.d.ts

@@ -0,0 +1,132 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { A as AtlasAuthClient, T as ThemeMode } from './use-dark-mode-rFxawUv1.js';
+export { E as ExploreToolResult, P as PythonToolResult, S as SQLToolResult, d as ToolRendererProps, a as ToolRenderers } from './use-dark-mode-rFxawUv1.js';
+import { UIMessage } from '@ai-sdk/react';
+import { AuthMode, Conversation } from '@useatlas/types';
+export { AUTH_MODES, AuthMode, ChatErrorCode, ChatErrorInfo, Conversation, ConversationWithMessages, Message } from '@useatlas/types';
+export { parseChatError } from '@useatlas/types/errors';
+
+interface AtlasProviderProps {
+    /** Atlas API server URL (e.g. "https://api.example.com" or "" for same-origin). */
+    apiUrl: string;
+    /** API key for simple-key auth mode. Sent as Bearer token. Accessible in context by all hooks. */
+    apiKey?: string;
+    /** Custom auth client for managed auth mode (better-auth compatible). */
+    authClient?: AtlasAuthClient;
+    children: ReactNode;
+}
+interface AtlasContextValue {
+    apiUrl: string;
+    apiKey: string | undefined;
+    authClient: AtlasAuthClient;
+    isCrossOrigin: boolean;
+}
+/** Access the AtlasProvider context. Throws if used outside <AtlasProvider>. */
+declare function useAtlasContext(): AtlasContextValue;
+/**
+ * Lightweight provider for headless Atlas hooks.
+ *
+ * Wraps your app and supplies API URL, auth credentials, and an optional
+ * better-auth client to all Atlas hooks. Derives isCrossOrigin from apiUrl
+ * to configure credential handling for cross-origin requests.
+ */
+declare function AtlasProvider({ apiUrl, apiKey, authClient, children, }: AtlasProviderProps): react_jsx_runtime.JSX.Element;
+
+type AtlasChatStatus = "submitted" | "streaming" | "ready" | "error";
+interface UseAtlasChatOptions {
+    /** Conversation ID to associate with this chat session. The server will append messages to this conversation. To load prior messages, use loadConversation() from useAtlasConversations and pass them via setMessages. */
+    initialConversationId?: string;
+    /** Called when the server assigns or changes the conversation ID. */
+    onConversationIdChange?: (id: string) => void;
+}
+interface UseAtlasChatReturn {
+    messages: UIMessage[];
+    /** Replace all messages, or update via callback `(prev) => next`. */
+    setMessages: (messages: UIMessage[] | ((prev: UIMessage[]) => UIMessage[])) => void;
+    /** Send a text message. Rejects on failure (also surfaces via `error`). */
+    sendMessage: (text: string) => Promise<void>;
+    /** Current input value (managed by the hook). */
+    input: string;
+    /** Update the input value. */
+    setInput: (input: string) => void;
+    /** Chat status from the AI SDK. */
+    status: AtlasChatStatus;
+    /** Whether the chat is currently loading (streaming or submitted). */
+    isLoading: boolean;
+    /** Last error, if any. */
+    error: Error | null;
+    /** Current conversation ID. Initially set from options, updated when the server returns an x-conversation-id header. */
+    conversationId: string | null;
+    /** Manually set the conversation ID. */
+    setConversationId: (id: string | null) => void;
+}
+declare function useAtlasChat(options?: UseAtlasChatOptions): UseAtlasChatReturn;
+
+interface UseAtlasAuthReturn {
+    /** Auth mode detected from the server's /api/health endpoint. `null` while the initial health check is in flight. */
+    authMode: AuthMode | null;
+    /** Whether the user is authenticated (based on auth mode, API key, or session). */
+    isAuthenticated: boolean;
+    /** Session data for managed auth mode. */
+    session: {
+        user?: {
+            email?: string;
+        };
+    } | null;
+    /** Whether auth state is still being resolved (health check or managed session loading). */
+    isLoading: boolean;
+    /** Error from health check or auth operations. `null` when healthy. */
+    error: Error | null;
+    /** Sign in with email/password (managed auth). */
+    login: (email: string, password: string) => Promise<{
+        error?: string;
+    }>;
+    /** Sign up with email/password/name (managed auth). */
+    signup: (email: string, password: string, name: string) => Promise<{
+        error?: string;
+    }>;
+    /** Sign out (managed auth). */
+    logout: () => Promise<{
+        error?: string;
+    }>;
+}
+declare function useAtlasAuth(): UseAtlasAuthReturn;
+
+interface UseAtlasThemeReturn {
+    /** Current theme setting: "light", "dark", or "system". */
+    theme: ThemeMode;
+    /** Whether the effective (resolved) theme is dark. */
+    isDark: boolean;
+    /** Set the theme mode. Persists to localStorage. */
+    setTheme: (mode: ThemeMode) => void;
+    /** Apply a brand color (oklch format, e.g. "oklch(0.759 0.148 167.71)") via CSS custom property --atlas-brand. */
+    applyBrandColor: (color: string) => void;
+}
+declare function useAtlasTheme(): UseAtlasThemeReturn;
+
+interface UseAtlasConversationsOptions {
+    /** When false, refresh() becomes a no-op. Defaults to true. */
+    enabled?: boolean;
+}
+interface UseAtlasConversationsReturn {
+    conversations: Conversation[];
+    total: number;
+    isLoading: boolean;
+    available: boolean;
+    selectedId: string | null;
+    setSelectedId: (id: string | null) => void;
+    refresh: () => Promise<void>;
+    loadConversation: (id: string) => Promise<UIMessage[] | null>;
+    deleteConversation: (id: string) => Promise<boolean>;
+    starConversation: (id: string, starred: boolean) => Promise<boolean>;
+}
+/**
+ * Manage conversation history with auth automatically wired from AtlasProvider.
+ *
+ * Wraps the lower-level `useConversations` hook with context-derived
+ * API URL and credentials.
+ */
+declare function useAtlasConversations(options?: UseAtlasConversationsOptions): UseAtlasConversationsReturn;
+
+export { AtlasAuthClient, type AtlasChatStatus, type AtlasContextValue, AtlasProvider, type AtlasProviderProps, ThemeMode, type UseAtlasAuthReturn, type UseAtlasChatOptions, type UseAtlasChatReturn, type UseAtlasConversationsOptions, type UseAtlasConversationsReturn, type UseAtlasThemeReturn, useAtlasAuth, useAtlasChat, useAtlasContext, useAtlasConversations, useAtlasTheme };