@sanity/sdk 3.0.0-rc.0 → 3.0.0-rc.1

package/package.json

@@ -1,96 +1,97 @@
 {
   "name": "@sanity/sdk",
-  "version": "3.0.0-rc.0",
+  "version": "3.0.0-rc.1",
   "private": false,
   "description": "Sanity SDK",
   "keywords": [
-    "sanity",
-    "sdk",
-    "content operating system",
     "cms",
+    "content",
+    "content operating system",
     "headless",
     "realtime",
-    "content"
+    "sanity",
+    "sdk"
   ],
   "homepage": "https://github.com/sanity-io/sdk/tree/main/packages/core/README.md",
   "bugs": {
     "url": "https://github.com/sanity-io/sdk/issues"
   },
+  "license": "MIT",
+  "author": "Sanity <developers@sanity.io>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sanity-io/sdk.git",
     "directory": "packages/core"
   },
-  "license": "MIT",
-  "author": "Sanity <developers@sanity.io>",
-  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
   "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "source": "./src/_exports/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./_internal": {
+      "source": "./src/_exports/_internal.ts",
+      "import": "./dist/_exports/_internal.js",
+      "default": "./dist/_exports/_internal.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist",
-    "src"
-  ],
-  "browserslist": "extends @sanity/browserslist-config",
-  "prettier": "@sanity/prettier-config",
   "dependencies": {
-    "@sanity/bifur-client": "^0.4.1",
-    "@sanity/client": "^7.14.1",
-    "@sanity/comlink": "^3.0.4",
+    "@sanity/bifur-client": "^1.0.0",
+    "@sanity/client": "^7.23.2",
+    "@sanity/comlink": "^4.0.1",
     "@sanity/diff-match-patch": "^3.2.0",
     "@sanity/diff-patch": "^6.0.0",
     "@sanity/id-utils": "^1.0.0",
-    "@sanity/image-url": "^2.0.3",
+    "@sanity/image-url": "^2.1.1",
     "@sanity/json-match": "^1.0.5",
-    "@sanity/message-protocol": "^0.18.0",
-    "@sanity/mutate": "^0.12.4",
-    "@sanity/types": "^5.2.0",
-    "groq-js": "^1.19.0",
-    "lodash-es": "^4.17.21",
+    "@sanity/message-protocol": "^0.23.0",
+    "@sanity/mutate": "^0.18.1",
+    "@sanity/telemetry": "^1.1.0",
+    "@sanity/types": "^6.5.0",
+    "groq": "3.88.1-typegen-experimental.0",
+    "groq-js": "^2.0.0",
     "reselect": "^5.1.1",
     "rxjs": "^7.8.2",
-    "zustand": "^5.0.4"
+    "zustand": "^5.0.13"
   },
   "devDependencies": {
     "@sanity/browserslist-config": "^1.0.5",
-    "@sanity/pkg-utils": "^8.1.29",
-    "@sanity/prettier-config": "^1.0.6",
-    "@types/lodash-es": "^4.17.12",
-    "@vitest/coverage-v8": "3.2.4",
-    "eslint": "^9.22.0",
-    "prettier": "^3.7.3",
-    "rollup-plugin-visualizer": "^5.14.0",
-    "typescript": "^5.8.3",
-    "vite": "^6.3.4",
-    "vitest": "^3.2.4",
+    "@sanity/pkg-utils": "^10.9.2",
+    "@types/node": "^24.13.3",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^10.6.0",
+    "oxfmt": "^0.58.0",
+    "rollup-plugin-visualizer": "^7.0.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.5",
+    "vitest": "^4.1.10",
     "@repo/config-eslint": "0.0.0",
     "@repo/config-test": "0.0.1",
-    "@repo/package.bundle": "3.82.0",
+    "@repo/package.config": "0.0.1",
     "@repo/tsconfig": "0.0.1",
-    "@repo/package.config": "0.0.1"
-  },
-  "engines": {
-    "node": ">=20.19"
-  },
-  "publishConfig": {
-    "access": "public"
+    "@repo/package.bundle": "3.82.0"
   },
+  "browserslist": "extends @sanity/browserslist-config",
   "scripts": {
     "build": "pkg build --strict --clean --check",
     "build:bundle": "vite build --configLoader runner --config package.bundle.ts",
     "clean": "rimraf dist",
     "dev": "pkg watch",
     "docs": "typedoc --json docs/typedoc.json --tsconfig ./tsconfig.dist.json",
-    "format": "prettier --write --cache --ignore-unknown .",
+    "format": "oxfmt",
     "lint": "eslint .",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",

package/src/_exports/_internal.ts

@@ -0,0 +1,26 @@
+export {isStudioConfig} from '../auth/authMode'
+export {
+  type ApiErrorBody,
+  getClientErrorApiBody,
+  getClientErrorApiDescription,
+  getClientErrorApiType,
+  isProjectUserNotFoundClientError,
+} from '../auth/utils'
+export {PREVIEW_PROJECTION} from '../preview/previewConstants'
+export {transformProjectionToPreview} from '../preview/previewProjectionUtils'
+export {getQueryKey, parseQueryKey} from '../query/queryStore' // only used for memoizing in React, not needed for actual functionality
+export {
+  type CacheTag,
+  type CacheWriter,
+  defineFetcher,
+  defineMutation,
+  type Fetcher,
+  type FetcherDefinition,
+  type FetcherSnapshot,
+  type MutationDefinition,
+  type MutationResult,
+} from '../store/fetcherStore'
+export {getTelemetryManager, initTelemetry, trackHookMounted} from '../telemetry/initTelemetry'
+export {getUsersKey, parseUsersKey} from '../users/reducers' // only used for memoizing in React, not needed for actual functionality
+export {createGroqSearchFilter} from '../utils/createGroqSearchFilter'
+export {isDeepEqual, pickProperties} from '../utils/object'

package/src/_exports/index.ts

@@ -5,6 +5,8 @@ import {type SanityProject as _SanityProject} from '@sanity/client'
  */
 export type SanityProject = _SanityProject
 
+export {checkPermissions} from '../access/checkPermissions'
+export {type AccessResourceType} from '../access/checkPermissions'
 export type {
   AgentGenerateOptions,
   AgentGenerateResult,
@@ -12,7 +14,6 @@ export type {
   AgentPatchResult,
   AgentPromptOptions,
   AgentPromptResult,
-  AgentResourceOptions,
   AgentTransformOptions,
   AgentTransformResult,
   AgentTranslateOptions,
@@ -25,6 +26,44 @@ export {
   agentTransform,
   agentTranslate,
 } from '../agent/agentActions'
+export {
+  application,
+  applications,
+  deleteApplication,
+  updateApplication,
+} from '../applications/applications'
+export {
+  type Application,
+  type ApplicationAccess,
+  type ApplicationBase,
+  type ApplicationDeployment,
+  type ApplicationInclude,
+  type ApplicationInterface,
+  type ApplicationsOptions,
+  type ApplicationsResponse,
+  type ApplicationStudioConfig,
+  type ApplicationVisibility,
+  type ApplicationWorkspace,
+  type DeleteApplicationInput,
+  type DeletedResult,
+  type UpdateApplicationInput,
+} from '../applications/applications'
+export {
+  createUserApplication,
+  deleteUserApplication,
+  updateUserApplication,
+  userApplication,
+  userApplications,
+} from '../applications/userApplications'
+export {
+  type CreateUserApplicationInput,
+  type DeleteUserApplicationInput,
+  type UpdateUserApplicationInput,
+  type UserApplication,
+  type UserApplicationDeployment,
+  type UserApplicationsOptions,
+  type UserApplicationWriteFields,
+} from '../applications/userApplications'
 export {isStudioConfig} from '../auth/authMode'
 export {AuthStateType} from '../auth/authStateType'
 export {
@@ -72,9 +111,10 @@ export {
 } from '../comlink/types'
 export {type AuthConfig, type AuthProvider} from '../config/authConfig'
 export {
+  createDatasetHandle,
   createDocumentHandle,
   createDocumentTypeHandle,
-  createResourceHandle,
+  createProjectHandle,
 } from '../config/handles'
 export {
   configureLogging,
@@ -87,37 +127,64 @@ export {
 } from '../config/loggingConfig'
 export {
   type CanvasResource,
+  type CanvasSource,
+  type DatasetHandle,
   type DatasetResource,
-  DEFAULT_RESOURCE_NAME,
+  type DatasetSource,
   type DocumentHandle,
   type DocumentResource,
+  type DocumentSource,
   type DocumentTypeHandle,
   isCanvasResource,
+  isCanvasSource,
   isDatasetResource,
+  isDatasetSource,
   isMediaLibraryResource,
+  isMediaLibrarySource,
   type MediaLibraryResource,
+  type MediaLibrarySource,
   type PerspectiveHandle,
+  type ProjectHandle,
+  type ReleaseHandle,
   type ReleasePerspective,
-  type ResourceHandle,
   type SanityConfig,
   type StudioConfig,
   type TokenSource,
 } from '../config/sanityConfig'
 export {getDatasetsState, resolveDatasets} from '../datasets/datasets'
 export {
+  type Action,
+  archiveRelease,
+  type ArchiveReleaseAction,
   createDocument,
   type CreateDocumentAction,
+  createRelease,
+  type CreateReleaseAction,
   deleteDocument,
   type DeleteDocumentAction,
+  deleteRelease,
+  type DeleteReleaseAction,
   discardDocument,
   type DiscardDocumentAction,
   type DocumentAction,
   editDocument,
   type EditDocumentAction,
+  type EditDocumentOptions,
+  editRelease,
+  type EditReleaseAction,
   publishDocument,
   type PublishDocumentAction,
+  publishRelease,
+  type PublishReleaseAction,
+  type ReleaseAction,
+  scheduleRelease,
+  type ScheduleReleaseAction,
+  unarchiveRelease,
+  type UnarchiveReleaseAction,
   unpublishDocument,
   type UnpublishDocumentAction,
+  unscheduleRelease,
+  type UnscheduleReleaseAction,
 } from '../document/actions'
 export {
   type ActionsResult,
@@ -141,13 +208,37 @@ export {
   type DocumentEditedEvent,
   type DocumentEvent,
   type DocumentPublishedEvent,
+  type DocumentRemotePatchesEvent,
+  type DocumentTransactionSubmissionResult,
   type DocumentUnpublishedEvent,
   type TransactionAcceptedEvent,
   type TransactionRevertedEvent,
 } from '../document/events'
+export {type JsonMatch} from '../document/patchOperations'
 export {type DocumentPermissionsResult, type PermissionDeniedReason} from '../document/permissions'
+export {getReleaseDocumentId} from '../document/processActions/releaseUtil'
 export type {FavoriteStatusResponse} from '../favorites/favorites'
 export {getFavoritesState, resolveFavoritesState} from '../favorites/favorites'
+export {installation, installations} from '../installations/installations'
+export {
+  type Installation,
+  type InstallationAccess,
+  type InstallationActiveConfig,
+  type InstallationBase,
+  type InstallationInclude,
+  type InstallationInterface,
+  type InstallationsOptions,
+  type InstallationsResponse,
+} from '../installations/installations'
+export {organization} from '../organization/organization'
+export {
+  type Organization,
+  type OrganizationBase,
+  type OrganizationMember,
+  type OrganizationOptions,
+} from '../organization/organization'
+export {organizations} from '../organizations/organizations'
+export {type Organizations, type OrganizationsOptions} from '../organizations/organizations'
 export {getPresence} from '../presence/presenceStore'
 export type {
   DisconnectEvent,
@@ -157,15 +248,32 @@ export type {
   TransportEvent,
   UserPresence,
 } from '../presence/types'
+export {getPreviewState, type GetPreviewStateOptions} from '../preview/getPreviewState'
 export {PREVIEW_PROJECTION} from '../preview/previewConstants'
 export {transformProjectionToPreview} from '../preview/previewProjectionUtils'
-export type {PreviewMedia, PreviewQueryResult, PreviewValue, ValuePending} from '../preview/types'
+export {resolvePreview, type ResolvePreviewOptions} from '../preview/resolvePreview'
+export type {
+  PreviewMedia,
+  PreviewQueryResult,
+  PreviewStoreState,
+  PreviewValue,
+  ValuePending,
+} from '../preview/types'
 export {type OrgVerificationResult} from '../project/organizationVerification'
-export {getProjectState, type ProjectHandle, resolveProject} from '../project/project'
+export {project} from '../project/project'
+export {
+  type Project,
+  type ProjectBase,
+  type ProjectMember,
+  type ProjectMemberRole,
+  type ProjectMetadata,
+  type ProjectOptions,
+} from '../project/project'
 export {getProjectionState} from '../projection/getProjectionState'
 export {resolveProjection} from '../projection/resolveProjection'
-export {type ProjectionValuePending} from '../projection/types'
-export {getProjectsState, resolveProjects} from '../projects/projects'
+export {type ProjectionValuePending, type ValidProjection} from '../projection/types'
+export {projects} from '../projects/projects'
+export {type ProjectsOptions} from '../projects/projects'
 export {
   getQueryKey,
   getQueryState,
@@ -174,8 +282,8 @@ export {
   resolveQuery,
 } from '../query/queryStore'
 export {getPerspectiveState} from '../releases/getPerspectiveState'
-export type {ReleaseDocument} from '../releases/releasesStore'
-export {getActiveReleasesState} from '../releases/releasesStore'
+export type {ReleaseState} from '../releases/releasesStore'
+export {getActiveReleasesState, getAllReleasesState} from '../releases/releasesStore'
 export {createSanityInstance, type SanityInstance} from '../store/createSanityInstance'
 export {type Selector, type StateSource} from '../store/createStateSourceAction'
 export {getUsersKey, parseUsersKey} from '../users/reducers'
@@ -200,9 +308,10 @@ export {
 } from '../users/usersStore'
 export {type FetcherStore, type FetcherStoreState} from '../utils/createFetcherStore'
 export {createGroqSearchFilter} from '../utils/createGroqSearchFilter'
-export {defineIntent, type Intent, type IntentFilter} from '../utils/defineIntent'
 export {getCorsErrorProjectId} from '../utils/getCorsErrorProjectId'
+export {isImportError} from '../utils/isImportError'
 export {CORE_SDK_VERSION} from '../version'
+export type {ReleaseDocument} from '@sanity/client'
 export {
   getIndexForKey,
   getPathDepth,

package/src/access/checkPermissions.test.ts

@@ -0,0 +1,55 @@
+import {type SanityClient} from '@sanity/client'
+import {of} from 'rxjs'
+import {afterEach, beforeEach, describe, expect, it, vi} from 'vitest'
+
+import {getClientState} from '../client/clientStore'
+import {createSanityInstance, type SanityInstance} from '../store/createSanityInstance'
+import {type StateSource} from '../store/createStateSourceAction'
+import {checkPermissions} from './checkPermissions'
+
+vi.mock('../client/clientStore')
+
+describe('checkPermissions', () => {
+  let instance: SanityInstance
+  const request = vi.fn()
+
+  beforeEach(() => {
+    instance = createSanityInstance({projectId: 'p', dataset: 'd'})
+    request.mockReset()
+    vi.mocked(getClientState).mockReturnValue({
+      observable: of({observable: {request}} as unknown as SanityClient),
+    } as StateSource<SanityClient>)
+  })
+
+  afterEach(() => {
+    instance.dispose()
+  })
+
+  it('checks permissions on the global client and unwraps the data envelope', async () => {
+    request.mockReturnValue(of({data: {'sanity.project.read': true}}))
+
+    const result = await checkPermissions.resolveState(instance, 'project', 'p1', [
+      'sanity.project.read',
+    ])
+
+    expect(result).toEqual({'sanity.project.read': true})
+    expect(getClientState).toHaveBeenCalledWith(instance, {
+      apiVersion: 'v2025-07-11',
+      scope: 'global',
+    })
+    expect(request).toHaveBeenCalledWith({
+      uri: '/access/project/p1/user-permissions/me/check',
+      query: {permissions: ['sanity.project.read']},
+      tag: 'access.check',
+    })
+  })
+
+  it('does not create distinct cache entries for different permission orderings', async () => {
+    request.mockReturnValue(of({data: {a: true, b: false}}))
+
+    await checkPermissions.resolveState(instance, 'organization', 'org1', ['b', 'a'])
+    await checkPermissions.resolveState(instance, 'organization', 'org1', ['a', 'b'])
+
+    expect(request).toHaveBeenCalledTimes(1)
+  })
+})

package/src/access/checkPermissions.ts

@@ -0,0 +1,54 @@
+import {map, switchMap} from 'rxjs'
+
+import {getClientState} from '../client/clientStore'
+import {defineFetcher} from '../store/fetcherStore'
+
+const API_VERSION = 'v2025-07-11'
+
+/**
+ * The resource types the Access API can scope a permission check to.
+ *
+ * @see https://www.sanity.io/docs/http-reference/access-api
+ * @public
+ */
+export type AccessResourceType =
+  | 'organization'
+  | 'project'
+  | 'media-library'
+  | 'canvas'
+  | 'dashboard'
+  | 'view'
+
+/**
+ * Fetcher checking whether the current user holds the given permissions on a
+ * resource (`GET /access/:resourceType/:resourceId/user-permissions/me/check`),
+ * on the shared fetcher cache. Resolves to a map of each requested permission
+ * to whether the user has it. The key sorts the permission list, so permission
+ * order doesn't create distinct cache entries.
+ *
+ * @see https://www.sanity.io/docs/http-reference/access-api
+ * @internal
+ */
+export const checkPermissions = defineFetcher<
+  [resourceType: AccessResourceType, resourceId: string, permissions: string[]],
+  Record<string, boolean>
+>({
+  name: 'checkPermissions',
+  getKey: (_instance, resourceType, resourceId, permissions) =>
+    `${resourceType}:${resourceId}:${[...permissions].sort().join(',')}`,
+  fetch: (instance) => (resourceType, resourceId, permissions) =>
+    getClientState(instance, {apiVersion: API_VERSION, scope: 'global'}).observable.pipe(
+      switchMap((client) =>
+        client.observable
+          .request<{data: Record<string, boolean>}>({
+            uri: `/access/${resourceType}/${resourceId}/user-permissions/me/check`,
+            query: {permissions},
+            tag: 'access.check',
+          })
+          .pipe(map((response) => response.data)),
+      ),
+    ),
+  tags: (_data, resourceType, resourceId) => [
+    {type: 'access', id: `${resourceType}:${resourceId}`},
+  ],
+})

package/src/agent/agentActions.test.ts

@@ -11,16 +11,13 @@ import {
 } from './agentActions'
 
 let mockClient: any
-const mockGetClientState = vi.fn()
 
 vi.mock('../client/clientStore', () => {
   return {
-    getClientState: (...args: unknown[]) => mockGetClientState(...args),
+    getClientState: () => ({observable: of(mockClient)}),
   }
 })
 
-const testResource = {projectId: 'p', dataset: 'd'}
-
 describe('agent actions', () => {
   beforeEach(() => {
     mockClient = {
@@ -40,86 +37,45 @@ describe('agent actions', () => {
         },
       },
     }
-    mockGetClientState.mockReturnValue({observable: of(mockClient)})
   })
 
-  it('agentGenerate passes resource to getClientState and strips it from agent options', async () => {
+  it('agentGenerate returns observable from client', async () => {
     mockClient.observable.agent.action.generate.mockReturnValue(of('gen'))
-    const instance = {config: {}} as any
-    const value = await firstValueFrom(
-      agentGenerate(instance, {foo: 'bar', resource: testResource} as any),
-    )
+    const instance = {config: {projectId: 'p', dataset: 'd'}} as any
+    const value = await firstValueFrom(agentGenerate(instance, {foo: 'bar'} as any))
     expect(value).toBe('gen')
-    expect(mockGetClientState).toHaveBeenCalledWith(instance, {
-      apiVersion: 'vX',
-      resource: testResource,
-    })
     expect(mockClient.observable.agent.action.generate).toHaveBeenCalledWith({foo: 'bar'})
   })
 
-  it('agentTransform passes resource to getClientState and strips it from agent options', async () => {
+  it('agentTransform returns observable from client', async () => {
     mockClient.observable.agent.action.transform.mockReturnValue(of('xform'))
-    const instance = {config: {}} as any
-    const value = await firstValueFrom(
-      agentTransform(instance, {a: 1, resource: testResource} as any),
-    )
+    const instance = {config: {projectId: 'p', dataset: 'd'}} as any
+    const value = await firstValueFrom(agentTransform(instance, {a: 1} as any))
     expect(value).toBe('xform')
-    expect(mockGetClientState).toHaveBeenCalledWith(instance, {
-      apiVersion: 'vX',
-      resource: testResource,
-    })
     expect(mockClient.observable.agent.action.transform).toHaveBeenCalledWith({a: 1})
   })
 
-  it('agentTranslate passes resource to getClientState and strips it from agent options', async () => {
+  it('agentTranslate returns observable from client', async () => {
     mockClient.observable.agent.action.translate.mockReturnValue(of('xlate'))
-    const instance = {config: {}} as any
-    const value = await firstValueFrom(
-      agentTranslate(instance, {b: 2, resource: testResource} as any),
-    )
+    const instance = {config: {projectId: 'p', dataset: 'd'}} as any
+    const value = await firstValueFrom(agentTranslate(instance, {b: 2} as any))
     expect(value).toBe('xlate')
-    expect(mockGetClientState).toHaveBeenCalledWith(instance, {
-      apiVersion: 'vX',
-      resource: testResource,
-    })
     expect(mockClient.observable.agent.action.translate).toHaveBeenCalledWith({b: 2})
   })
 
-  it('agentPrompt passes resource to getClientState and strips it from agent options', async () => {
+  it('agentPrompt wraps promise into observable', async () => {
     mockClient.agent.action.prompt.mockResolvedValue('prompted')
-    const instance = {config: {}} as any
-    const value = await firstValueFrom(
-      agentPrompt(instance, {p: true, resource: testResource} as any),
-    )
+    const instance = {config: {projectId: 'p', dataset: 'd'}} as any
+    const value = await firstValueFrom(agentPrompt(instance, {p: true} as any))
     expect(value).toBe('prompted')
-    expect(mockGetClientState).toHaveBeenCalledWith(instance, {
-      apiVersion: 'vX',
-      resource: testResource,
-    })
     expect(mockClient.agent.action.prompt).toHaveBeenCalledWith({p: true})
   })
 
-  it('agentPatch passes resource to getClientState and strips it from agent options', async () => {
+  it('agentPatch wraps promise into observable', async () => {
     mockClient.agent.action.patch.mockResolvedValue('patched')
-    const instance = {config: {}} as any
-    const value = await firstValueFrom(
-      agentPatch(instance, {q: false, resource: testResource} as any),
-    )
+    const instance = {config: {projectId: 'p', dataset: 'd'}} as any
+    const value = await firstValueFrom(agentPatch(instance, {q: false} as any))
     expect(value).toBe('patched')
-    expect(mockGetClientState).toHaveBeenCalledWith(instance, {
-      apiVersion: 'vX',
-      resource: testResource,
-    })
     expect(mockClient.agent.action.patch).toHaveBeenCalledWith({q: false})
   })
-
-  it('works without an explicit resource (falls back via getClientState)', async () => {
-    mockClient.observable.agent.action.generate.mockReturnValue(of('gen'))
-    const instance = {config: {}} as any
-    await firstValueFrom(agentGenerate(instance, {foo: 'bar'} as any))
-    expect(mockGetClientState).toHaveBeenCalledWith(instance, {
-      apiVersion: 'vX',
-      resource: undefined,
-    })
-  })
 })