@sanity/sdk-react 3.10.0-next.20261027125037 → 3.10.0

package/README.md

@@ -48,6 +48,10 @@ export function App() {
 
 **Auth is automatic** — Dashboard injects an auth token via iframe. No custom login flow is needed for your application.
 
+### 3. Generate types (beta)
+
+Configure TypeGen before writing components so hooks return typed data. Add `typegen.resources` to `sanity.cli.ts` and run `npx sanity typegen generate --watch`. See [TypeScript & TypeGen](#typescript--typegen) for the steps.
+
 ---
 
 ## Guide
@@ -536,18 +540,93 @@ If you need to pass an explicit config, replace `studioMode` with `studio`:
 
 ### TypeScript & TypeGen
 
+Set up TypeGen when you create an app. Hooks then infer document, field, and query result types from the handle, so you don't write or pass result types yourself.
+
+This workflow is in beta. It requires `@sanity/sdk-react` 3.9.0 or later and `@sanity/cli` 8.16.0 or later. See the [TypeScript guide](https://www.sanity.io/docs/app-sdk/sdk-typegen) for every option and for troubleshooting.
+
+**1. Extract each dataset's schema.** Run this in the Studio that defines the schema, then copy the file into your app:
+
+```bash
+npx sanity schema extract --path schema.production.json
+```
+
+**2. Declare your datasets in a module that the app and the CLI both import.** `as const` keeps the project ID and dataset as literal types, which inference needs. The CLI loads this file in Node, so it must not use browser globals.
+
+```ts
+// src/resources.ts
+import type {DocumentResource} from '@sanity/sdk-react'
+
+export const resources = {
+  production: {projectId: 'abc123', dataset: 'production'},
+} as const satisfies Record<string, DocumentResource>
+```
+
+**3. Add `typegen.resources` to `sanity.cli.ts`.** Each entry writes one types file for one dataset:
+
+```ts
+// sanity.cli.ts
+import {defineCliConfig} from 'sanity/cli'
+
+import {resources} from './src/resources'
+
+export default defineCliConfig({
+  app: {organizationId: 'your-org-id', entry: './src/App.tsx'},
+  typegen: {
+    resources: [
+      {
+        ...resources.production,
+        schema: './schema.production.json',
+        generates: './src/sanity.types.production.ts',
+      },
+    ],
+  },
+})
+```
+
+**4. Generate types.** Run it again after changing a schema or query, or add `--watch` (`@sanity/cli` 8.22.0 or later) to regenerate on every change. `sanity dev` does not generate types for `typegen.resources`, so run the watcher alongside it.
+
 ```bash
-# Generate types from your schema
 npx sanity typegen generate
+npx sanity typegen generate --watch
 ```
 
+**5. Use hooks without type parameters.** Build handles and options from your declared resources:
+
 ```tsx
-import type {Article} from './sanity.types'
+import {createDocumentHandle, useDocument, useQuery} from '@sanity/sdk-react'
+import {defineQuery} from 'groq'
+
+import {resources} from './resources'
+
+const book = createDocumentHandle({
+  ...resources.production,
+  documentId: 'book-1',
+  documentType: 'book',
+})
+
+const bookTitlesQuery = defineQuery('*[_type == "book"]{_id, title}')
 
-const {data} = useDocument<Article>(handle)
-// data is typed as Article
+export function BookTitle() {
+  // `Book` from sanity.types.production.ts, or null
+  const {data: doc} = useDocument(book)
+  return <h1>{doc?.title}</h1>
+}
+
+export function BookTitles() {
+  // the generated result type for bookTitlesQuery
+  const {data} = useQuery({...resources.production, query: bookTitlesQuery})
+  return (
+    <ul>
+      {data.map((b) => (
+        <li key={b._id}>{b.title}</li>
+      ))}
+    </ul>
+  )
+}
 ```
 
+`defineQuery` comes from the `groq` package (6.12.0 or later). Apps created from the `app-quickstart` template don't include it, so run `npm install groq` first. Assign each query to a variable so TypeGen can find it.
+
 ---
 
 ### Deployment

package/dist/index.js

@@ -4371,7 +4371,7 @@ function useUsers(options) {
 		loadMore
 	}, $[20] = data, $[21] = hasMore, $[22] = isPending, $[23] = loadMore, $[24] = totalCount, $[25] = t8) : t8 = $[25], t8;
 }
-var version = "3.10.0-next.20261027125037";
+var version = "3.10.0";
 function getEnv(key) {
 	if (import.meta.env) return import.meta.env[key];
 	if (typeof process < "u" && process.env) return process.env[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/sdk-react",
-  "version": "3.10.0-next.20261027125037",
+  "version": "3.10.0",
   "private": false,
   "description": "Sanity SDK React toolkit for Content OS",
   "keywords": [
@@ -45,7 +45,7 @@
     "@module-federation/runtime": "^2.9.2",
     "@sanity/client": "^8.11.0",
     "@sanity/message-protocol": "^0.24.0",
-    "@sanity/sdk": "3.10.0-next.20261027125037",
+    "@sanity/sdk": "3.10.0",
     "@sanity/types": "^6.20.0",
     "react-compiler-runtime": "^1.0.0",
     "react-error-boundary": "^6.1.6",