@sanity/sdk-react 0.0.0-alpha.18 → 0.0.0-alpha.2

package/README.md

@@ -5,150 +5,93 @@
   <h1 align="center">Sanity SDK - React</h1>
 </p>
 
-React hooks for creating Sanity applications.
+React components and hooks for creating Sanity applications.
 
-## 💻 Installation
+## Installation
 
 ```bash
-npm i @sanity/sdk-react @sanity/sdk
+npm i @sanity/sdk-react @sanity/sdk styled-components
 ```
 
-> 💡 Looking to build a Sanity application? Check out the [Quick Start](#quick-start) section.
-
-## 📚 SDK Documentation
+## SDK Documentation
 
 See the [SDK Documentation](https://sdk-docs.sanity.dev) for more information.
 
-## 🚀 Quick Start
+## Quick Start
 
 Here's how to implement your Sanity application:
 
-1. Create a new React TypeScript project using the Sanity template
-
-```bash
-pnpx sanity@latest init --template core-app
-cd my-content-os-app
-```
-
-2. Install dependencies
-
-```bash
-npm i
-```
-
-3. Run the app
-
-```bash
-npm run dev
-```
-
-4. Open the App in Sanity Dashboard with your organization ID
-
-```
-https://core.sanity.io/<your-organization-id>?dev=localhost:5173
-```
-
-5. Overwrite the `src/App.tsx` file with the following code:
-
 ```tsx
-// src/App.tsx
-import {SanityConfig} from '@sanity/sdk'
-import {SanityApp} from '@sanity/sdk-react/components'
+import {createSanityInstance} from '@sanity/sdk'
+import {AuthBoundary, SanityProvider} from '@sanity/sdk-react/components'
 import {useCurrentUser, useLogOut} from '@sanity/sdk-react/hooks'
-
-import './App.css'
-
-const sanityConfig: SanityConfigs = [
-  {
-    projectId: '<your-project-id>',
-    dataset: '<your-dataset>',
-  },
-]
+import {Button, Flex, Spinner, Text, ThemeProvider} from '@sanity/ui'
+import {buildTheme} from '@sanity/ui/theme'
+import {Suspense} from 'react'
+
+const theme = buildTheme({})
+const sanityInstance = createSanityInstance({
+  projectId: '<your-project-id>',
+  dataset: '<your-dataset>',
+  // optional auth config set projectId and dataset to '' and authScope to 'org' for a global token
+  // auth: {
+  //   authScope: 'org',
+  //   ...
+  // },
+})
 
 export function App(): JSX.Element {
   return (
-    <SanityApp sanityConfigs={sanityConfigs}>
-      <MyApp />
-    </SanityApp>
+    <ThemeProvider theme={theme}>
+      <Suspense fallback={<Spinner />}>
+        <SanityProvider sanityInstance={sanityInstance}>
+          <AuthBoundary header={<Text>My Sanity App</Text>}>
+            <Authenticated />
+          </AuthBoundary>
+        </SanityProvider>
+      </Suspense>
+    </ThemeProvider>
   )
 }
 
-function MyApp() {
+function Authenticated() {
   const currentUser = useCurrentUser()
   const logout = useLogOut()
 
   return (
-    <div>
-      <h1>Hello, {currentUser?.name}!</h1>
-      <button onClick={logout}>Logout</button>
-    </div>
+    <Flex direction="column" gap={2}>
+      <Text>Hello, {currentUser?.name}!</Text>
+      <Button text="Logout" onClick={logout} mode="ghost" />
+    </Flex>
   )
 }
-
-export default App
 ```
 
-6. Overwrite the `src/App.css` file with the following code:
-
-```css
-/* src/App.css */
-#root {
-  margin: auto;
-}
-
-.sc-login-layout {
-  min-height: 100vh;
-  display: flex;
-  background: #f3f3f3;
-}
-
-.sc-login-layout__container {
-  margin: auto;
-  padding: 2rem;
-}
-
-.sc-login-layout__card {
-  background: white;
-  padding: 2rem;
-}
+## Customizing your application
 
-.sc-login__title,
-.sc-login-callback {
-  text-align: center;
-  margin-bottom: 2rem;
-  color: #333;
-}
+If you would like to implement a custom look and feel, you can use the hooks in your own components.
 
-.sc-login-providers {
-  display: flex;
-  flex-direction: column;
-  gap: 1rem;
-}
+## Available Hooks
 
-.sc-login-providers a {
-  padding: 0.8rem;
-  border: 1px solid #ddd;
-  text-decoration: none;
-  color: #333;
-  text-align: center;
-}
+- `useAuthState` - Get current authentication state
+- `useCurrentUser` - Access the currently authenticated user
+- `useAuthToken` - Access the authentication token
+- `useLoginUrls` - Get OAuth login URLs
+- `useLogOut` - Handle user logout
+- `useSanityInstance` - Access the Sanity client instance
+- and more...
 
-.sc-login-footer {
-  margin-top: 2rem;
-  text-align: center;
-}
+## TypeScript Support
 
-.sc-login-footer__links {
-  list-style: none;
-  padding: 0;
-  display: flex;
-  justify-content: center;
-  gap: 1.5rem;
-}
+This package includes TypeScript definitions. You can import types like:
 
-.sc-login-footer__link a {
-  font-size: 0.9rem;
-}
+```tsx
+import type {
+  SanityProviderProps,
+  AuthBoundaryProps,
+  LoginLayoutProps,
+  LoginErrorProps,
+} from '@sanity/react'
 ```
 
 ## License

package/dist/_chunks-es/useLogOut.js

@@ -1,68 +1,39 @@
-import { getAuthState, handleCallback, getLoginUrlsState, fetchLoginUrls, logout } from "@sanity/sdk";
-import { c } from "react/compiler-runtime";
-import { useContext, useSyncExternalStore, useMemo } from "react";
-import { SanityInstanceContext } from "./SanityInstanceContext.js";
-const useSanityInstance = (resourceId) => {
-  const $ = c(5), sanityInstance = useContext(SanityInstanceContext);
+import { getAuthState, getLoginUrlsState, fetchLoginUrls, handleCallback, logout } from "@sanity/sdk";
+import { createContext, useContext, useMemo, useSyncExternalStore, useCallback } from "react";
+import { jsx } from "react/jsx-runtime";
+const SanityInstanceContext = createContext(null), SanityProvider = ({ children, sanityInstance }) => /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: sanityInstance, children }), useSanityInstance = () => {
+  const sanityInstance = useContext(SanityInstanceContext);
   if (!sanityInstance)
     throw new Error("useSanityInstance must be called from within the SanityProvider");
-  if (sanityInstance.length === 0)
-    throw new Error("No Sanity instances found");
-  if (sanityInstance.length === 1 || !resourceId)
-    return sanityInstance[0];
-  if (!resourceId)
-    throw new Error("resourceId is required when there are multiple Sanity instances");
-  let t0;
-  if ($[0] !== resourceId || $[1] !== sanityInstance) {
-    let t1;
-    $[3] !== resourceId ? (t1 = (inst) => inst.identity.resourceId === resourceId, $[3] = resourceId, $[4] = t1) : t1 = $[4], t0 = sanityInstance.find(t1), $[0] = resourceId, $[1] = sanityInstance, $[2] = t0;
-  } else
-    t0 = $[2];
-  const instance = t0;
-  if (!instance)
-    throw new Error(`Sanity instance with resourceId ${resourceId} not found`);
-  return instance;
+  return sanityInstance;
 };
-function createStateSourceHook(options) {
-  const getState = typeof options == "function" ? options : options.getState, getResourceId = "getResourceId" in options ? options.getResourceId : void 0, suspense = "shouldSuspend" in options && "suspender" in options ? options : void 0;
-  function useHook(...t0) {
-    const $ = c(5), params = t0;
-    let resourceId;
-    if (getResourceId) {
-      let t12;
-      $[0] !== params ? (t12 = getResourceId(...params), $[0] = params, $[1] = t12) : t12 = $[1], resourceId = t12;
-    }
-    const instance = useSanityInstance(resourceId);
-    if (suspense?.suspender && suspense?.shouldSuspend?.(instance, ...params))
-      throw suspense.suspender(instance, ...params);
-    let t1;
-    $[2] !== instance || $[3] !== params ? (t1 = getState(instance, ...params), $[2] = instance, $[3] = params, $[4] = t1) : t1 = $[4];
-    const state = t1;
-    return useSyncExternalStore(state.subscribe, state.getCurrent);
+function createStateSourceHook(stateSourceFactory) {
+  function useHook(...params) {
+    const instance = useSanityInstance(), { subscribe, getCurrent } = useMemo(
+      () => stateSourceFactory(instance, ...params),
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+      [instance, ...params]
+    );
+    return useSyncExternalStore(subscribe, getCurrent);
   }
   return useHook;
 }
 const useAuthState = createStateSourceHook(getAuthState);
-function createCallbackHook(callback, resourceId) {
-  function useHook() {
-    const $ = c(2), instance = useSanityInstance(resourceId);
-    let t0;
-    return $[0] !== instance ? (t0 = (...t1) => callback(instance, ...t1), $[0] = instance, $[1] = t0) : t0 = $[1], t0;
-  }
-  return useHook;
-}
-const useHandleCallback = createCallbackHook(handleCallback);
 function useLoginUrls() {
-  const instance = useSanityInstance(), {
-    subscribe,
-    getCurrent
-  } = useMemo(() => getLoginUrlsState(instance), [instance]);
+  const instance = useSanityInstance(), { subscribe, getCurrent } = useMemo(() => getLoginUrlsState(instance), [instance]);
   if (!getCurrent()) throw fetchLoginUrls(instance);
   return useSyncExternalStore(subscribe, getCurrent);
 }
-const useLogOut = createCallbackHook(logout);
+function createCallbackHook(callback) {
+  function useHook() {
+    const instance = useSanityInstance();
+    return useCallback((...params) => callback(instance, ...params), [instance]);
+  }
+  return useHook;
+}
+const useHandleCallback = createCallbackHook(handleCallback), useLogOut = createCallbackHook(logout);
 export {
-  createCallbackHook,
+  SanityProvider,
   createStateSourceHook,
   useAuthState,
   useHandleCallback,

package/dist/_chunks-es/useLogOut.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLogOut.js","sources":["../../src/hooks/context/useSanityInstance.ts","../../src/hooks/helpers/createStateSourceHook.tsx","../../src/hooks/auth/useAuthState.tsx","../../src/hooks/helpers/createCallbackHook.tsx","../../src/hooks/auth/useHandleCallback.tsx","../../src/hooks/auth/useLoginUrls.tsx","../../src/hooks/auth/useLogOut.tsx"],"sourcesContent":["import {type SanityInstance} from '@sanity/sdk'\nimport {useContext} from 'react'\n\nimport {SanityInstanceContext} from '../../context/SanityInstanceContext'\n\n/**\n * `useSanityInstance` returns the current Sanity instance from the application context.\n * This must be called from within a `SanityProvider` component.\n * @internal\n *\n * @param resourceId - The resourceId of the Sanity instance to return (optional)\n * @returns The current Sanity instance\n * @example\n * ```tsx\n * const instance = useSanityInstance('abc123.production')\n * ```\n */\nexport const useSanityInstance = (resourceId?: string): SanityInstance => {\n  const sanityInstance = useContext(SanityInstanceContext)\n  if (!sanityInstance) {\n    throw new Error('useSanityInstance must be called from within the SanityProvider')\n  }\n  if (sanityInstance.length === 0) {\n    throw new Error('No Sanity instances found')\n  }\n  if (sanityInstance.length === 1 || !resourceId) {\n    return sanityInstance[0]\n  }\n\n  if (!resourceId) {\n    throw new Error('resourceId is required when there are multiple Sanity instances')\n  }\n\n  const instance = sanityInstance.find((inst) => inst.identity.resourceId === resourceId)\n  if (!instance) {\n    throw new Error(`Sanity instance with resourceId ${resourceId} not found`)\n  }\n  return instance\n}\n","import {type ResourceId, type SanityInstance, type StateSource} from '@sanity/sdk'\nimport {useSyncExternalStore} from 'react'\n\nimport {useSanityInstance} from '../context/useSanityInstance'\n\ntype StateSourceFactory<TParams extends unknown[], TState> = (\n  instance: SanityInstance,\n  ...params: TParams\n) => StateSource<TState>\n\ninterface CreateStateSourceHookOptions<TParams extends unknown[], TState> {\n  getState: StateSourceFactory<TParams, TState>\n  shouldSuspend?: (instance: SanityInstance, ...params: TParams) => boolean\n  suspender?: (instance: SanityInstance, ...params: TParams) => Promise<unknown>\n  getResourceId?: (...params: TParams) => ResourceId | undefined\n}\n\nexport function createStateSourceHook<TParams extends unknown[], TState>(\n  options: StateSourceFactory<TParams, TState> | CreateStateSourceHookOptions<TParams, TState>,\n): (...params: TParams) => TState {\n  const getState = typeof options === 'function' ? options : options.getState\n  const getResourceId = 'getResourceId' in options ? options.getResourceId : undefined\n  const suspense = 'shouldSuspend' in options && 'suspender' in options ? options : undefined\n\n  function useHook(...params: TParams) {\n    let resourceId: ResourceId | undefined\n    if (getResourceId) {\n      resourceId = getResourceId(...params)\n    }\n    const instance = useSanityInstance(resourceId)\n    if (suspense?.suspender && suspense?.shouldSuspend?.(instance, ...params)) {\n      throw suspense.suspender(instance, ...params)\n    }\n\n    const state = getState(instance, ...params)\n    return useSyncExternalStore(state.subscribe, state.getCurrent)\n  }\n\n  return useHook\n}\n","import {type AuthState, getAuthState} from '@sanity/sdk'\n\nimport {createStateSourceHook} from '../helpers/createStateSourceHook'\n\n/**\n * @internal\n * A React hook that subscribes to authentication state changes.\n *\n * This hook provides access to the current authentication state type from the Sanity auth store.\n * It automatically re-renders when the authentication state changes.\n *\n * @remarks\n * The hook uses `useSyncExternalStore` to safely subscribe to auth state changes\n * and ensure consistency between server and client rendering.\n *\n * @returns The current authentication state type\n *\n * @example\n * ```tsx\n * function AuthStatus() {\n *   const authState = useAuthState()\n *   return <div>Current auth state: {authState}</div>\n * }\n * ```\n */\nexport const useAuthState: () => AuthState = createStateSourceHook(getAuthState)\n","import {type ResourceId, type SanityInstance} from '@sanity/sdk'\nimport {useCallback} from 'react'\n\nimport {useSanityInstance} from '../context/useSanityInstance'\n\nexport function createCallbackHook<TParams extends unknown[], TReturn>(\n  callback: (instance: SanityInstance, ...params: TParams) => TReturn,\n  resourceId?: ResourceId,\n): () => (...params: TParams) => TReturn {\n  function useHook() {\n    const instance = useSanityInstance(resourceId)\n    return useCallback((...params: TParams) => callback(instance, ...params), [instance])\n  }\n\n  return useHook\n}\n","import {handleCallback} from '@sanity/sdk'\n\nimport {createCallbackHook} from '../helpers/createCallbackHook'\n\n/**\n * @internal\n * A React hook that returns a function for handling authentication callbacks.\n *\n * @remarks\n * This hook provides access to the authentication store's callback handler,\n * which processes auth redirects by extracting the session ID and fetching the\n * authentication token. If fetching the long-lived token is successful,\n * `handleCallback` will return a Promise that resolves a new location that\n * removes the short-lived token from the URL. Use this in combination with\n * `history.replaceState` or your own router's `replace` function to update the\n * current location without triggering a reload.\n *\n * @example\n * ```tsx\n * function AuthCallback() {\n *   const handleCallback = useHandleCallback()\n *   const router = useRouter() // Example router\n *\n *   useEffect(() => {\n *     async function processCallback() {\n *       // Handle the callback and get the cleaned URL\n *       const newUrl = await handleCallback(window.location.href)\n *\n *       if (newUrl) {\n *         // Replace URL without triggering navigation\n *         router.replace(newUrl, {shallow: true})\n *       }\n *     }\n *\n *     processCallback().catch(console.error)\n *   }, [handleCallback, router])\n *\n *   return <div>Completing login...</div>\n * }\n * ```\n *\n * @returns A callback handler function that processes OAuth redirects\n * @public\n */\nexport const useHandleCallback = createCallbackHook(handleCallback)\n","import {type AuthProvider, fetchLoginUrls, getLoginUrlsState} from '@sanity/sdk'\nimport {useMemo, useSyncExternalStore} from 'react'\n\nimport {useSanityInstance} from '../context/useSanityInstance'\n\n/**\n * @internal\n * A React hook that retrieves the available authentication provider URLs for login.\n *\n * @remarks\n * This hook fetches the login URLs from the Sanity auth store when the component mounts.\n * Each provider object contains information about an authentication method, including its URL.\n * The hook will suspend if the login URLs have not yet loaded.\n *\n * @example\n * ```tsx\n * // LoginProviders component that uses the hook\n * function LoginProviders() {\n *   const providers = useLoginUrls()\n *\n *   return (\n *     <div>\n *       {providers.map((provider) => (\n *         <a key={provider.name} href={provider.url}>\n *           Login with {provider.title}\n *         </a>\n *       ))}\n *     </div>\n *   )\n * }\n *\n * // Parent component with Suspense boundary\n * function LoginPage() {\n *   return (\n *     <Suspense fallback={<div>Loading authentication providers...</div>}>\n *       <LoginProviders />\n *     </Suspense>\n *   )\n * }\n * ```\n *\n * @returns An array of {@link AuthProvider} objects containing login URLs and provider information\n * @public\n */\nexport function useLoginUrls(): AuthProvider[] {\n  const instance = useSanityInstance()\n  const {subscribe, getCurrent} = useMemo(() => getLoginUrlsState(instance), [instance])\n\n  if (!getCurrent()) throw fetchLoginUrls(instance)\n\n  return useSyncExternalStore(subscribe, getCurrent as () => AuthProvider[])\n}\n","import {logout} from '@sanity/sdk'\n\nimport {createCallbackHook} from '../helpers/createCallbackHook'\n\n/**\n * Hook to log out of the current session\n * @internal\n * @returns A function to log out of the current session\n */\nexport const useLogOut = createCallbackHook(logout)\n"],"names":["useSanityInstance","resourceId","$","_c","sanityInstance","useContext","SanityInstanceContext","Error","length","t0","t1","inst","identity","find","instance","createStateSourceHook","options","getState","getResourceId","undefined","suspense","useHook","params","suspender","shouldSuspend","state","useSyncExternalStore","subscribe","getCurrent","useAuthState","getAuthState","createCallbackHook","callback","useHandleCallback","handleCallback","useLoginUrls","useMemo","getLoginUrlsState","fetchLoginUrls","useLogOut","logout"],"mappings":";;;;AAiBO,MAAMA,oBAAoBC,CAAA,eAAA;AAAA,QAAAC,IAAAC,EAAA,CAAA,GAC/BC,iBAAuBC,WAAAC,qBAAgC;AAAC,MAAA,CACnDF;AAAcG,UAAAA,IAAAA,MACD,iEAAiE;AAAA,MAE/EH,eAAcI,WAAa;AAAAD,UAAAA,IAAAA,MACb,2BAA2B;AAEzCH,MAAAA,eAAcI,WAAA,MAAkBP;AAAU,WACrCG,eAAc,CAAA;AAAA,MAAA,CAGlBH;AAAUM,UAAAA,IAAAA,MACG,iEAAiE;AAAAE,MAAAA;AAAA,MAAAP,EAAAD,CAAAA,MAAAA,cAAAC,SAAAE,gBAAA;AAAAM,QAAAA;AAAAR,aAAAD,cAG9CS,KAAAC,UAAUA,KAAIC,SAAAX,eAAyBA,YAAUC,OAAAD,YAAAC,OAAAQ,MAAAA,KAAAR,EAAA,CAAA,GAArEO,KAAAL,eAAcS,KAAMH,EAAiD,GAACR,OAAAD,YAAAC,OAAAE,gBAAAF,OAAAO;AAAAA,EAAA;AAAAA,SAAAP,EAAA,CAAA;AAAvF,QAAAY,WAAiBL;AAAsE,MAAA,CAClFK;AAAQ,UAAA,IAAAP,MACK,mCAAmCN,UAAU,YAAY;AAEpEa,SAAAA;AAAQ;ACpBV,SAASC,sBACdC,SACgC;AAChC,QAAMC,WAAW,OAAOD,WAAY,aAAaA,UAAUA,QAAQC,UAC7DC,gBAAgB,mBAAmBF,UAAUA,QAAQE,gBAAgBC,QACrEC,WAAW,mBAAmBJ,WAAW,eAAeA,UAAUA,UAAUG;AAElF,WAAAE,WAAAZ,IAAA;AAAA,UAAAP,IAAAC,EAAA,CAAA,GAAiBmB,SAAAb;AACXR,QAAAA;AAAkC,QAAAiB,eAAA;AAAAR,UAAAA;AAAAR,eAAAoB,UAEvBZ,MAAAQ,cAAiBI,GAAAA,MAAM,GAACpB,OAAAoB,QAAApB,OAAAQ,OAAAA,MAAAR,EAAA,CAAA,GAArCD,aAAaA;AAAAA,IAAAA;AAEfa,UAAAA,WAAiBd,kBAAkBC,UAAU;AAAC,QAC1CmB,UAAAG,aAAAH,UAAAI,gBAAiDV,UAAaQ,GAAAA,MAAM;AAAC,YACjEF,SAAAG,UAAmBT,UAAQ,GAAKQ,MAAM;AAACZ,QAAAA;AAAAR,MAAAY,CAAAA,MAAAA,YAAAZ,SAAAoB,UAGjCZ,KAAAO,SAASH,UAAQ,GAAKQ,MAAM,GAACpB,OAAAY,UAAAZ,OAAAoB,QAAApB,OAAAQ,MAAAA,KAAAR,EAAA,CAAA;AAA3C,UAAAuB,QAAcf;AAA6B,WACpCgB,qBAAqBD,MAAKE,WAAYF,MAAKG,UAAW;AAAA,EAAA;AAGxDP,SAAAA;AACT;ACdaQ,MAAAA,eAAgCd,sBAAsBe,YAAY;ACpB/DC,SAAAA,mBACdC,UACA/B,YACuC;AACvC,WAAAoB,UAAA;AAAA,UAAAnB,IAAAC,EAAA,CAAA,GACEW,WAAiBd,kBAAAC,UAA4B;AAACQ,QAAAA;AAAAP,WAAAA,SAAAY,YAC3BL,KAAAA,IAAAC,OAAwBsB,SAASlB,UAAQ,GAAxCJ,EAAmD,GAACR,OAAAY,UAAAZ,OAAAO,MAAAA,KAAAP,EAAA,CAAA,GAAjEO;AAAAA,EAAAA;AAGFY,SAAAA;AACT;AC6BaY,MAAAA,oBAAoBF,mBAAmBG,cAAc;ACA3D,SAASC,eAA+B;AACvCrB,QAAAA,WAAWd,qBACX;AAAA,IAAC2B;AAAAA,IAAWC;AAAAA,EAAAA,IAAcQ,QAAQ,MAAMC,kBAAkBvB,QAAQ,GAAG,CAACA,QAAQ,CAAC;AAErF,MAAI,CAACc,WAAAA,EAAc,OAAMU,eAAexB,QAAQ;AAEzCY,SAAAA,qBAAqBC,WAAWC,UAAkC;AAC3E;AC1CaW,MAAAA,YAAYR,mBAAmBS,MAAM;"}
+{"version":3,"file":"useLogOut.js","sources":["../../src/components/context/SanityProvider.tsx","../../src/hooks/context/useSanityInstance.ts","../../src/hooks/helpers/createStateSourceHook.tsx","../../src/hooks/auth/useAuthState.tsx","../../src/hooks/auth/useLoginUrls.tsx","../../src/hooks/helpers/createCallbackHook.tsx","../../src/hooks/auth/useHandleCallback.tsx","../../src/hooks/auth/useLogOut.tsx"],"sourcesContent":["import {type SanityInstance} from '@sanity/sdk'\nimport {createContext, type ReactElement} from 'react'\n\n/**\n * @public\n */\nexport interface SanityProviderProps {\n  children: React.ReactNode\n  sanityInstance: SanityInstance\n}\n\nexport const SanityInstanceContext = createContext<SanityInstance | null>(null)\n\n/**\n * Top-level context provider that provides a Sanity configuration instance.\n * This must wrap any Sanity SDK React component.\n * @public\n * @param props - Sanity project and dataset configuration\n * @returns Rendered component\n * @example\n * ```tsx\n * import {createSanityInstance} from '@sanity/sdk'\n * import {ExampleComponent, SanityProvider} from '@sanity/sdk-react'\n *\n * const sanityInstance = createSanityInstance({projectId: 'your-project-id', dataset: 'production'})\n *\n * export default function MyApp() {\n *   return (\n *     <SanityProvider sanityInstance={sanityInstance}>\n *      <ExampleComponent />\n *     </SanityProvider>\n *   )\n * }\n * ```\n */\nexport const SanityProvider = ({children, sanityInstance}: SanityProviderProps): ReactElement => {\n  return (\n    <SanityInstanceContext.Provider value={sanityInstance}>\n      {children}\n    </SanityInstanceContext.Provider>\n  )\n}\n","import type {SanityInstance} from '@sanity/sdk'\nimport {useContext} from 'react'\n\nimport {SanityInstanceContext} from '../../components/context/SanityProvider'\n\n/**\n * Hook that provides the current Sanity instance from the context.\n * This must be called from within a `SanityProvider` component.\n * @public\n * @returns the current Sanity instance\n * @example\n * ```tsx\n * const instance = useSanityInstance()\n * ```\n */\nexport const useSanityInstance = (): SanityInstance => {\n  const sanityInstance = useContext(SanityInstanceContext)\n  if (!sanityInstance) {\n    throw new Error('useSanityInstance must be called from within the SanityProvider')\n  }\n\n  return sanityInstance\n}\n","import type {SanityInstance, StateSource} from '@sanity/sdk'\nimport {useMemo, useSyncExternalStore} from 'react'\n\nimport {useSanityInstance} from '../context/useSanityInstance'\n\nexport function createStateSourceHook<TParams extends unknown[], TState>(\n  stateSourceFactory: (instance: SanityInstance, ...params: TParams) => StateSource<TState>,\n): (...params: TParams) => TState {\n  function useHook(...params: TParams) {\n    const instance = useSanityInstance()\n    const {subscribe, getCurrent} = useMemo(\n      () => stateSourceFactory(instance, ...params),\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n      [instance, ...params],\n    )\n\n    return useSyncExternalStore(subscribe, getCurrent)\n  }\n\n  return useHook\n}\n","import {getAuthState} from '@sanity/sdk'\n\nimport {createStateSourceHook} from '../helpers/createStateSourceHook'\n\n/**\n * A React hook that subscribes to authentication state changes.\n *\n * This hook provides access to the current authentication state type from the Sanity auth store.\n * It automatically re-renders the component when the authentication state changes.\n *\n * @remarks\n * The hook uses `useSyncExternalStore` to safely subscribe to auth state changes\n * and ensure consistency between server and client rendering.\n *\n * @returns The current authentication state type\n *\n * @example\n * ```tsx\n * function AuthStatus() {\n *   const authState = useAuthState()\n *   return <div>Current auth state: {authState}</div>\n * }\n * ```\n *\n * @public\n */\nexport const useAuthState = createStateSourceHook(getAuthState)\n","import {type AuthProvider, fetchLoginUrls, getLoginUrlsState} from '@sanity/sdk'\nimport {useMemo, useSyncExternalStore} from 'react'\n\nimport {useSanityInstance} from '../context/useSanityInstance'\n\n/**\n * A React hook that retrieves the available authentication provider URLs for login.\n *\n * @remarks\n * This hook fetches the login URLs from the Sanity auth store when the component mounts.\n * Each provider object contains information about an authentication method, including its URL.\n * The hook will suspend if the login URLs have not yet loaded.\n *\n * @example\n * ```tsx\n * // LoginProviders component that uses the hook\n * function LoginProviders() {\n *   const providers = useLoginUrls()\n *\n *   return (\n *     <div>\n *       {providers.map((provider) => (\n *         <a key={provider.name} href={provider.url}>\n *           Login with {provider.title}\n *         </a>\n *       ))}\n *     </div>\n *   )\n * }\n *\n * // Parent component with Suspense boundary\n * function LoginPage() {\n *   return (\n *     <Suspense fallback={<div>Loading authentication providers...</div>}>\n *       <LoginProviders />\n *     </Suspense>\n *   )\n * }\n * ```\n *\n * @returns An array of {@link AuthProvider} objects containing login URLs and provider information\n * @public\n */\nexport function useLoginUrls(): AuthProvider[] {\n  const instance = useSanityInstance()\n  const {subscribe, getCurrent} = useMemo(() => getLoginUrlsState(instance), [instance])\n\n  if (!getCurrent()) throw fetchLoginUrls(instance)\n\n  return useSyncExternalStore(subscribe, getCurrent as () => AuthProvider[])\n}\n","import type {SanityInstance} from '@sanity/sdk'\nimport {useCallback} from 'react'\n\nimport {useSanityInstance} from '../context/useSanityInstance'\n\nexport function createCallbackHook<TParams extends unknown[], TReturn>(\n  callback: (instance: SanityInstance, ...params: TParams) => TReturn,\n): () => (...params: TParams) => TReturn {\n  function useHook() {\n    const instance = useSanityInstance()\n    return useCallback((...params: TParams) => callback(instance, ...params), [instance])\n  }\n\n  return useHook\n}\n","import {handleCallback} from '@sanity/sdk'\n\nimport {createCallbackHook} from '../helpers/createCallbackHook'\n\n/**\n * A React hook that returns a function for handling authentication callbacks.\n *\n * @remarks\n * This hook provides access to the authentication store's callback handler,\n * which processes auth redirects by extracting the session ID and fetching the\n * authentication token. If fetching the long-lived token is successful,\n * `handleCallback` will return a Promise that resolves a new location that\n * removes the short-lived token from the URL. Use this in combination with\n * `history.replaceState` or your own router's `replace` function to update the\n * current location without triggering a reload.\n *\n * @example\n * ```tsx\n * function AuthCallback() {\n *   const handleCallback = useHandleCallback()\n *   const router = useRouter() // Example router\n *\n *   useEffect(() => {\n *     async function processCallback() {\n *       // Handle the callback and get the cleaned URL\n *       const newUrl = await handleCallback(window.location.href)\n *\n *       if (newUrl) {\n *         // Replace URL without triggering navigation\n *         router.replace(newUrl, {shallow: true})\n *       }\n *     }\n *\n *     processCallback().catch(console.error)\n *   }, [handleCallback, router])\n *\n *   return <div>Completing login...</div>\n * }\n * ```\n *\n * @returns A callback handler function that processes OAuth redirects\n * @public\n */\nexport const useHandleCallback = createCallbackHook(handleCallback)\n","import {logout} from '@sanity/sdk'\n\nimport {createCallbackHook} from '../helpers/createCallbackHook'\n\n/**\n * Hook to log out of the current session\n * @public\n * @returns A function to log out of the current session\n */\nexport const useLogOut = createCallbackHook(logout)\n"],"names":[],"mappings":";;;AAWO,MAAM,wBAAwB,cAAqC,IAAI,GAwBjE,iBAAiB,CAAC,EAAC,UAAU,eAAc,0BAEnD,sBAAsB,UAAtB,EAA+B,OAAO,gBACpC,SACH,CAAA,GCxBS,oBAAoB,MAAsB;AAC/C,QAAA,iBAAiB,WAAW,qBAAqB;AACvD,MAAI,CAAC;AACG,UAAA,IAAI,MAAM,iEAAiE;AAG5E,SAAA;AACT;ACjBO,SAAS,sBACd,oBACgC;AAChC,WAAS,WAAW,QAAiB;AACnC,UAAM,WAAW,kBAAkB,GAC7B,EAAC,WAAW,WAAc,IAAA;AAAA,MAC9B,MAAM,mBAAmB,UAAU,GAAG,MAAM;AAAA;AAAA,MAE5C,CAAC,UAAU,GAAG,MAAM;AAAA,IACtB;AAEO,WAAA,qBAAqB,WAAW,UAAU;AAAA,EAAA;AAG5C,SAAA;AACT;ACMa,MAAA,eAAe,sBAAsB,YAAY;ACiBvD,SAAS,eAA+B;AAC7C,QAAM,WAAW,qBACX,EAAC,WAAW,WAAU,IAAI,QAAQ,MAAM,kBAAkB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAErF,MAAI,CAAC,WAAA,EAAc,OAAM,eAAe,QAAQ;AAEzC,SAAA,qBAAqB,WAAW,UAAkC;AAC3E;AC7CO,SAAS,mBACd,UACuC;AACvC,WAAS,UAAU;AACjB,UAAM,WAAW,kBAAkB;AAC5B,WAAA,YAAY,IAAI,WAAoB,SAAS,UAAU,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC;AAAA,EAAA;AAG/E,SAAA;AACT;AC6Ba,MAAA,oBAAoB,mBAAmB,cAAc,GClCrD,YAAY,mBAAmB,MAAM;"}

package/dist/assets/bundle-CcAyERuZ.css

@@ -0,0 +1,11 @@
+@import './paramour.css';
+
+body {
+  color-scheme: light dark;
+  color: light-dark(var(--gray-1), var(--gray-10));
+  background-color: light-dark(var(--gray-11), var(--gray-1));
+}
+
+.container-inline {
+  container-type: inline-size;
+}

package/dist/components.d.ts

@@ -1,7 +1,9 @@
 import {FallbackProps} from 'react-error-boundary'
+import {ForwardRefExoticComponent} from 'react'
+import type {PropsWithChildren} from 'react'
 import {ReactElement} from 'react'
-import {ReactNode} from 'react'
-import {SanityConfig} from '@sanity/sdk'
+import {RefAttributes} from 'react'
+import {SanityInstance} from '@sanity/sdk'
 
 /**
  * A component that handles authentication flow and error boundaries for a
@@ -22,7 +24,7 @@ import {SanityConfig} from '@sanity/sdk'
  * }
  * ```
  *
- * @internal
+ * @alpha
  */
 export declare function AuthBoundary({
   LoginErrorComponent,
@@ -30,9 +32,9 @@ export declare function AuthBoundary({
 }: AuthBoundaryProps): React.ReactNode
 
 /**
- * @internal
+ * @alpha
  */
-declare interface AuthBoundaryProps extends LoginLayoutProps {
+export declare interface AuthBoundaryProps extends LoginLayoutProps {
   /**
    * Custom component to render the login screen.
    * Receives all login layout props. Defaults to {@link Login}.
@@ -52,14 +54,142 @@ declare interface AuthBoundaryProps extends LoginLayoutProps {
 }
 
 /**
+ * Error class for authentication-related errors. Wraps errors thrown during the
+ * authentication flow.
+ *
+ * @remarks
+ * This class provides a consistent error type for authentication failures while
+ * preserving the original error as the cause. If the original error has a
+ * message property, it will be used as the error message.
+ *
+ * @alpha
+ */
+export declare class AuthError extends Error {
+  constructor(error: unknown)
+}
+
+/**
+ * @public
+ */
+export declare const DocumentGridLayout: {
+  (props: PropsWithChildren): ReactElement
+  displayName: string
+}
+
+/**
+ * @public
+ */
+export declare const DocumentListLayout: {
+  (props: PropsWithChildren): ReactElement
+  displayName: string
+}
+
+/**
+ * This is a component that renders a document preview.
+ *
+ * @public
+ *
+ * @param props - The props for the DocumentPreviewLayout component.
+ * @returns - The DocumentPreviewLayout component.
+ */
+export declare const DocumentPreviewLayout: ForwardRefExoticComponent<
+  DocumentPreviewLayoutProps & RefAttributes<HTMLElement>
+>
+
+/**
+ * @public
+ */
+export declare interface DocumentPreviewLayoutProps {
+  docType?: string
+  media?:
+    | {
+        type: string
+        url: string
+      }
+    | null
+    | undefined
+  onClick?: () => void
+  selected?: boolean
+  status?: string
+  subtitle?: string
+  title: string
+}
+
+/**
+ * Login component that displays available authentication providers.
+ * Renders a list of login options with a loading fallback while providers load.
+ *
+ * @alpha
+ */
+export declare function Login({header, footer}: LoginLayoutProps): JSX.Element
+
+/**
+ * Component shown during auth callback processing that handles login completion.
+ * Automatically processes the auth callback when mounted and updates the URL
+ * to remove callback parameters without triggering a page reload.
+ *
+ * @alpha
+ */
+export declare function LoginCallback({header, footer}: LoginLayoutProps): React.ReactNode
+
+/**
+ * Displays authentication error details and provides retry functionality.
+ * Only handles {@link AuthError} instances - rethrows other error types.
+ *
+ * @alpha
+ */
+export declare function LoginError({
+  error,
+  resetErrorBoundary,
+  header,
+  footer,
+}: LoginErrorProps): React.ReactNode
+
+/**
+ * @alpha
+ */
+export declare type LoginErrorProps = FallbackProps & LoginLayoutProps
+
+/**
+ * Layout component for login-related screens providing consistent styling and structure.
+ * Renders content in a centered card with optional header and footer sections.
+ *
+ * Can be used to build custom login screens for the AuthBoundary component, including:
+ * - Login provider selection (LoginComponent)
+ * - OAuth callback handling (CallbackComponent)
+ * - Error states (LoginErrorComponent)
+ *
+ * @example
+ * ```tsx
+ * // Custom login screen using the layout
+ * function CustomLogin({header, footer}: LoginLayoutProps) {
+ *   return (
+ *     <LoginLayout
+ *       header={header}
+ *       footer={footer}
+ *     >
+ *       <CustomLoginContent />
+ *     </LoginLayout>
+ *   )
+ * }
+ *
+ * // Use with AuthBoundary
+ * <AuthBoundary
+ *   LoginComponent={CustomLogin}
+ *   header={<Logo />}
+ * >
+ *   <ProtectedContent />
+ * </AuthBoundary>
+ * ```
+ *
  * @alpha
  */
-declare type LoginErrorProps = FallbackProps & LoginLayoutProps
+export declare function LoginLayout({children, footer, header}: LoginLayoutProps): React.ReactNode
 
 /**
  * @alpha
  */
-declare interface LoginLayoutProps {
+export declare interface LoginLayoutProps {
   /** Optional header content rendered at top of card */
   header?: React.ReactNode
   /** Optional footer content rendered below card. Defaults to an internal login footer */
@@ -69,86 +199,59 @@ declare interface LoginLayoutProps {
 }
 
 /**
+ * Component that handles Sanity authentication flow and renders login provider options
+ *
  * @public
  *
- * The SanityApp component provides your Sanity application with access to your Sanity configuration,
- * as well as application context and state which is used by the Sanity React hooks. Your application
- * must be wrapped with the SanityApp component to function properly.
+ * @returns Rendered component
  *
- * @param props - Your Sanity configuration and the React children to render
- * @returns Your Sanity application, integrated with your Sanity configuration and application context
+ * @remarks
+ * The component handles three states:
+ * 1. Loading state during token exchange
+ * 2. Success state after successful authentication
+ * 3. Provider selection UI when not authenticated
  *
  * @example
  * ```tsx
- * import { SanityApp } from '@sanity/sdk-react'
- *
- * import MyAppRoot from './Root'
- *
- * // Single project configuration
- * const mySanityConfigs = [
- *   {
- *     projectId: 'my-project-id',
- *     dataset: 'production',
- *   },
- * ]
- *
- * // Or multiple project configurations
- * const multipleConfigs = [
- *   // Configuration for your main project. This will be used as the default project for all hooks if no resource ID override is provided.
- *   {
- *     projectId: 'marketing-website-project',
- *     dataset: 'production',
- *   },
- *   // Configuration for a separate blog project
- *   {
- *     projectId: 'blog-project',
- *     dataset: 'production',
- *   },
- *   // Configuration for a separate ecommerce project
- *   {
- *     projectId: 'ecommerce-project',
- *     dataset: 'production',
- *   }
- * ]
+ * const config = { projectId: 'your-project-id', dataset: 'production' }
+ * return <LoginLinks sanityInstance={config} />
+ * ```
+ */
+export declare const LoginLinks: () => ReactElement
+
+/**
+ * Top-level context provider that provides a Sanity configuration instance.
+ * This must wrap any Sanity SDK React component.
+ * @public
+ * @param props - Sanity project and dataset configuration
+ * @returns Rendered component
+ * @example
+ * ```tsx
+ * import {createSanityInstance} from '@sanity/sdk'
+ * import {ExampleComponent, SanityProvider} from '@sanity/sdk-react'
+ *
+ * const sanityInstance = createSanityInstance({projectId: 'your-project-id', dataset: 'production'})
  *
  * export default function MyApp() {
  *   return (
- *     <SanityApp sanityConfigs={mySanityConfigs}>
- *       <MyAppRoot />
- *     </SanityApp>
+ *     <SanityProvider sanityInstance={sanityInstance}>
+ *      <ExampleComponent />
+ *     </SanityProvider>
  *   )
  * }
  * ```
  */
-export declare function SanityApp({sanityConfigs, children, fallback}: SanityAppProps): ReactElement
+export declare const SanityProvider: ({
+  children,
+  sanityInstance,
+}: SanityProviderProps) => ReactElement
 
 /**
  * @public
  */
-export declare interface SanityAppProps {
-  sanityConfigs: SanityConfig[]
+export declare interface SanityProviderProps {
   children: React.ReactNode
-  fallback: React.ReactNode
-}
-
-/**
- * @internal
- *
- * Top-level context provider that provides access to the Sanity SDK.
- */
-export declare function SDKProvider({
-  children,
-  sanityConfigs,
-  fallback,
-}: SDKProviderProps): ReactElement
-
-/**
- * @internal
- */
-export declare interface SDKProviderProps {
-  children: ReactNode
-  sanityConfigs: SanityConfig[]
-  fallback: ReactNode
+  sanityInstance: SanityInstance
 }
 
 export {}