@sanity/sdk 3.0.0 → 3.2.0

package/src/dashboard/messageBus/topics.ts

@@ -0,0 +1,260 @@
+import {type CurrentUser} from '@sanity/types'
+
+import {type Application, type ApplicationInclude} from '../../applications/applications'
+import {type OrganizationBase} from '../../organization/organization'
+
+/**
+ * Identifies a module federation expose and the manifest that serves it.
+ * @public
+ */
+export interface RemoteModuleRef {
+  readonly entry: string
+  readonly moduleId: string
+  readonly version: string
+}
+
+/**
+ * Application types that can receive configuration modules.
+ *
+ * The dashboard supplies this value over the message bus, so any string is accepted; known
+ * types are listed for autocomplete. `& {}` keeps the literal from collapsing into `string`.
+ * @public
+ */
+export type ApplicationConfigAppType = 'media-library' | (string & {})
+
+/**
+ * Identifies a configuration module for an application or application type.
+ * @public
+ */
+export interface ApplicationConfig extends RemoteModuleRef {
+  readonly appId?: Application['id']
+  readonly appType: ApplicationConfigAppType
+}
+
+/**
+ * Declares a topic that stores and replays its current value.
+ * @public
+ */
+export type StateTopicDef<T> = {kind: 'state'; value: T}
+
+/**
+ * Declares a topic that delivers events and an optional reply.
+ * @public
+ */
+export type EventTopicDef<P, R = never> = {
+  kind: 'event'
+  payload: P
+  reply?: R
+}
+
+/**
+ * Represents a successful topic value or a failed topic operation.
+ * @public
+ */
+export type TopicResult<T> = {ok: true; value: T} | {ok: false}
+
+/**
+ * Identifies a dashboard application and a route within it.
+ * @public
+ */
+export type NavigationTarget = {
+  /** The application ID, or `null` for dashboard-level routes. */
+  appId: Application['id'] | null
+  /** The route path, including its query string and fragment. */
+  path: string
+}
+
+/**
+ * Describes the current dashboard location and an active navigation.
+ * @public
+ */
+export type NavigationLocation = NavigationTarget & {
+  /** The active navigation, or `null` when navigation is idle. */
+  transition: {
+    /** Whether the navigation pushes or replaces browser history. */
+    navigationType: 'push' | 'replace'
+    /** The requested destination. */
+    to: NavigationTarget
+  } | null
+}
+
+/**
+ * Declares the topics provided by the dashboard.
+ * @public
+ */
+export interface DashboardTopics {
+  /** The available application configuration modules. */
+  'applications.config': StateTopicDef<ApplicationConfig[] | null>
+  /** The foreground application ID, or `null` on dashboard-level routes. */
+  'applications.foreground': StateTopicDef<Application['id'] | null>
+  /** The dashboard applications available to the current user. */
+  'applications.list': StateTopicDef<TopicResult<Application<ApplicationInclude>[]> | null>
+  /**
+   * The session token for the reading connection, or `null` while signed out. The host
+   * writes it to each connection separately, so one application never sees another's token.
+   */
+  'auth.token': StateTopicDef<string | null>
+  /** Requests a dashboard session token. */
+  'auth.token.refresh': EventTopicDef<void, string>
+  /** The current dashboard location and active navigation. */
+  'navigation.location': StateTopicDef<NavigationLocation | null>
+  /**
+   * Requests navigation and replies when the location commits.
+   *
+   * `ok: false` reasons:
+   * - `not-navigable`: the URL cannot be handled by a dashboard application
+   * - `interrupted`: another navigation superseded the request
+   * - `failed`: the router rejected or did not commit the request
+   */
+  'navigation.location.update': EventTopicDef<
+    {
+      url: string
+      history?: 'push' | 'replace'
+    },
+    {ok: true} | {ok: false; reason: 'not-navigable' | 'interrupted' | 'failed'}
+  >
+  /** The current organization, or `null` without an active organization. */
+  'organizations.current': StateTopicDef<Pick<OrganizationBase, 'id' | 'name' | 'slug'> | null>
+  /** The open panel, its application, display mode, and optional width in pixels. */
+  'panels.mode': StateTopicDef<TopicResult<
+    | {appId: string; name: string; mode: 'aside'; size?: number}
+    | {appId: string; name: string; mode: 'full'}
+    | null
+  > | null>
+  /** Opens, updates, resizes, or closes an application's panel. */
+  'panels.mode.set': EventTopicDef<
+    {name: string; mode: 'aside' | 'full'} | {name: string; size: number} | null
+  >
+  /** The resolved dashboard color scheme. */
+  'preferences.color-scheme': StateTopicDef<'light' | 'dark'>
+  /** Whether the dashboard dock is pinned open. */
+  'preferences.dock-locked': StateTopicDef<boolean>
+  /** The signed-in user, or `null` while signed out. */
+  'users.current': StateTopicDef<Pick<CurrentUser, 'id' | 'name' | 'email' | 'profileImage'> | null>
+}
+
+/**
+ * Declares every topic available through the message bus.
+ * @public
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- Declaration merging extends the SDK manifest.
+export interface Topics extends DashboardTopics {}
+
+/**
+ * Every declared topic name.
+ * @public
+ */
+export type TopicName = keyof Topics
+
+type StateTopicsOf<T> = {
+  [K in keyof T]: T[K] extends {kind: 'state'} ? K : never
+}[keyof T]
+
+/**
+ * Names of all declared state topics.
+ * @public
+ */
+export type StateTopic = StateTopicsOf<Topics>
+
+type TopicOwnership = {readonly type: 'same_app'} | {readonly type: 'any_app'}
+
+// State is only ever written by the host, one connection at a time, so it carries no ownership.
+type TopicManifestEntry<T> = T extends {kind: 'state'; value: infer V}
+  ? {readonly kind: 'state'; readonly seed: V | undefined}
+  : {readonly kind: 'event'; readonly ownership: TopicOwnership}
+
+// The value a connection's copy of the topic starts with; `undefined` means unpublished.
+const stateTopic = <const V>(seed: V) => ({kind: 'state', seed}) as const
+
+// `same_app` restricts responding to the application that installed the bus.
+const dashboardEvent = {kind: 'event', ownership: {type: 'same_app'}} as const
+
+/**
+ * Defines the runtime kind, ownership, and initial value of dashboard topics.
+ * @internal
+ */
+export const DASHBOARD_TOPIC_MANIFEST: {
+  readonly [K in keyof DashboardTopics]: TopicManifestEntry<DashboardTopics[K]>
+} = {
+  'applications.config': stateTopic(undefined),
+  'applications.foreground': stateTopic(undefined),
+  'applications.list': stateTopic(undefined),
+  'auth.token': stateTopic(undefined),
+  'auth.token.refresh': dashboardEvent,
+  'navigation.location': stateTopic(undefined),
+  'navigation.location.update': dashboardEvent,
+  'organizations.current': stateTopic(undefined),
+  'panels.mode': stateTopic({ok: true, value: null}),
+  'panels.mode.set': dashboardEvent,
+  'preferences.color-scheme': stateTopic(undefined),
+  'preferences.dock-locked': stateTopic(undefined),
+  'users.current': stateTopic(undefined),
+}
+
+/**
+ * Defines the runtime manifest accepted from any message bus version.
+ * @internal
+ */
+export type TopicManifest = Readonly<
+  Record<
+    string,
+    | {readonly kind: 'state'; readonly seed: unknown}
+    | {readonly kind: 'event'; readonly ownership: TopicOwnership}
+  >
+>
+
+/**
+ * Names of all declared event topics.
+ * @public
+ */
+export type EventTopic = {
+  [K in TopicName]: Topics[K] extends {kind: 'event'} ? K : never
+}[TopicName]
+
+/**
+ * The value type of a state topic.
+ * @public
+ */
+export type ValueOf<K extends StateTopic> = Topics[K] extends StateTopicDef<infer T> ? T : never
+
+/**
+ * The payload type of an event topic.
+ * @public
+ */
+export type PayloadOf<K extends EventTopic> =
+  Topics[K] extends EventTopicDef<infer P, infer _R> ? P : never
+
+/**
+ * The reply type of an event topic (`never` if it declares none).
+ * @public
+ */
+export type ReplyOf<K extends EventTopic> =
+  Topics[K] extends EventTopicDef<infer _P, infer R> ? R : never
+
+/**
+ * Converts a topic value between 2 adjacent versions.
+ * @internal
+ */
+export interface TopicMigration {
+  /** The older version. */
+  readonly from: number
+  /** The newer version. */
+  readonly to: number
+  /** Converts an older state value or event payload to the newer version. */
+  up(older: unknown): unknown
+  /** Converts a newer state value or event payload to the older version. */
+  down(newer: unknown): unknown
+  /** Converts event replies between these versions. */
+  readonly reply?: {
+    /** Converts an older reply to the newer version. */
+    up(older: unknown): unknown
+    /** Converts a newer reply to the older version. */
+    down(newer: unknown): unknown
+  }
+}
+
+/**
+ * Defines the bundled migration chain for each topic.
+ * @internal
+ */
+export const topicMigrations: Partial<Record<TopicName, readonly TopicMigration[]>> = {}

package/src/document/actions.ts

@@ -2,13 +2,13 @@ import {type ReleaseDocument} from '@sanity/client'
 import {SanityEncoder} from '@sanity/mutate'
 import {type PatchMutation as SanityMutatePatchMutation} from '@sanity/mutate/_unstable_store'
 import {type PatchMutation, type PatchOperations} from '@sanity/types'
-import {type SanityDocument} from 'groq'
 
 import {
   type DocumentHandle,
   type DocumentTypeHandle,
   type ReleaseHandle,
 } from '../config/sanityConfig'
+import {type ResolveDocument} from '../typegen/resolve'
 import {getEffectiveDocumentId} from './util'
 
 const isSanityMutatePatch = (value: unknown): value is SanityMutatePatchMutation => {
@@ -37,7 +37,7 @@ export interface CreateDocumentAction<
    */
   initialValue?: Partial<
     Omit<
-      SanityDocument<TDocumentType, `${TProjectId}.${TDataset}`>,
+      ResolveDocument<TDocumentType, `${TProjectId}.${TDataset}`>,
       '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'
     >
   >
@@ -166,7 +166,7 @@ export function createDocument<
   doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>,
   initialValue?: Partial<
     Omit<
-      SanityDocument<TDocumentType, `${TProjectId}.${TDataset}`>,
+      ResolveDocument<TDocumentType, `${TProjectId}.${TDataset}`>,
       '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'
     >
   >,

package/src/document/applyDocumentActions.ts

@@ -1,10 +1,11 @@
-import {type SanityDocument} from 'groq'
 import {distinctUntilChanged, filter, first, firstValueFrom, map, race} from 'rxjs'
 
 import {type DocumentResource} from '../config/sanityConfig'
 import {bindActionByResource} from '../store/createActionBinder'
 import {type SanityInstance} from '../store/createSanityInstance'
 import {type StoreContext} from '../store/defineStore'
+import {type ResolveDocument} from '../typegen/resolve'
+import {randomUuid} from '../utils/ids'
 import {type Action} from './actions'
 import {documentStore, type DocumentStoreState} from './documentStore'
 import {type DocumentTransactionSubmissionResult} from './events'
@@ -13,7 +14,7 @@ import {type AppliedTransaction, type QueuedTransaction, queueTransaction} from
 import {normalizeActionsForResource} from './resourceRules'
 
 /** @beta */
-export interface ActionsResult<TDocument extends SanityDocument = SanityDocument> {
+export interface ActionsResult<TDocument extends ResolveDocument = ResolveDocument> {
   transactionId: string
   documents: DocumentSet<TDocument>
   previous: DocumentSet<TDocument>
@@ -55,7 +56,7 @@ export function applyDocumentActions<
 >(
   instance: SanityInstance,
   options: ApplyDocumentActionsOptions,
-): Promise<ActionsResult<SanityDocument<TDocumentType, `${TProjectId}.${TDataset}`>>>
+): Promise<ActionsResult<ResolveDocument<TDocumentType, `${TProjectId}.${TDataset}`>>>
 /** @beta */
 export function applyDocumentActions(
   instance: SanityInstance,
@@ -74,12 +75,7 @@ const boundApplyDocumentActions = bindActionByResource(documentStore, _applyDocu
 /** @internal */
 async function _applyDocumentActions(
   {state}: StoreContext<DocumentStoreState>,
-  {
-    actions,
-    resource,
-    transactionId = crypto.randomUUID(),
-    disableBatching,
-  }: ApplyDocumentActionsOptions,
+  {actions, resource, transactionId = randomUuid(), disableBatching}: ApplyDocumentActionsOptions,
 ): Promise<ActionsResult> {
   const {events} = state.get()
 

package/src/document/documentStore.concurrency.test.ts

@@ -44,6 +44,7 @@ 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 {randomUuid} from '../utils/ids'
 import {editDocument, publishDocument} from './actions'
 import {applyDocumentActions} from './applyDocumentActions'
 import {getDocumentState, getDocumentSyncStatus} from './documentStore'
@@ -273,7 +274,7 @@ function createMockClient(server: MockContentLake): SanityClient {
 
   const action = vi.fn(async (input: HttpAction | HttpAction[], options?: BaseActionOptions) => {
     const actions = Array.isArray(input) ? input : [input]
-    return server.submitActions(actions, options?.transactionId ?? crypto.randomUUID())
+    return server.submitActions(actions, options?.transactionId ?? randomUuid())
   })
 
   const request = vi.fn(async () => {

package/src/document/documentStore.test.ts

@@ -36,6 +36,7 @@ import {getClientState} from '../client/clientStore'
 import {createDocumentHandle} from '../config/handles'
 import {createSanityInstance, type SanityInstance} from '../store/createSanityInstance'
 import {type StateSource} from '../store/createStateSourceAction'
+import {randomUuid} from '../utils/ids'
 import {
   createDocument,
   deleteDocument,
@@ -369,7 +370,7 @@ it('labels an echo that arrives after the last subscriber left as its own', asyn
   // and out of band, which is the ordering the real API produces
   const clientActionMockImplementation = vi.mocked(client.action).getMockImplementation()!
   vi.mocked(client.action).mockImplementation(
-    async (_input, {transactionId = crypto.randomUUID()} = {}) => ({transactionId}),
+    async (_input, {transactionId = randomUuid()} = {}) => ({transactionId}),
   )
 
   const patchEvents: DocumentRemotePatchesEvent[] = []
@@ -671,7 +672,7 @@ it('fetches documents if there are no active subscriptions for the actions appli
 })
 
 it('batches edit transaction into one outgoing transaction', async () => {
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
 
   const unsubscribe = getDocumentState(instance, doc).subscribe()
 
@@ -747,7 +748,7 @@ it('submits liveEdit document edits through observable.mutate', async () => {
 })
 
 it('provides the consistency status via `getDocumentSyncStatus`', async () => {
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
 
   const syncStatus = getDocumentSyncStatus(instance, doc)
   expect(syncStatus.getCurrent()).toBeUndefined()
@@ -802,7 +803,7 @@ it('reverts failed outgoing transaction locally', async () => {
     })
   })
 
-  const documentId = DocumentId(crypto.randomUUID())
+  const documentId = DocumentId(randomUuid())
   const doc = createDocumentHandle({documentId, documentType: 'article'})
 
   const {getCurrent, subscribe} = getDocumentState(instance, doc)
@@ -870,7 +871,7 @@ it('removes a queued transaction if it fails to apply', async () => {
     })
   })
 
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   const state = getDocumentState(instance, doc)
   const unsubscribe = state.subscribe()
 
@@ -975,8 +976,8 @@ it('fetches dataset ACL and updates grants in the document store state', async (
   ]
   vi.mocked(client.request).mockResolvedValue(datasetAcl)
 
-  const book = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'book'})
-  const author = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'author'})
+  const book = createDocumentHandle({documentId: randomUuid(), documentType: 'book'})
+  const author = createDocumentHandle({documentId: randomUuid(), documentType: 'author'})
 
   expect(await resolvePermissions(instance, {actions: [createDocument(book)]})).toEqual({
     allowed: true,
@@ -988,12 +989,12 @@ it('fetches dataset ACL and updates grants in the document store state', async (
 })
 
 it('does not send credentials with the dataset ACL request', async () => {
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   await resolvePermissions(instance, {actions: [createDocument(doc)]})
 
   const aclCall = vi
     .mocked(client.request)
-    .mock.calls.find(([options]) => options.uri?.endsWith('/acl'))
+    .mock.calls.find(([options]) => options.url?.endsWith('/acl'))
   expect(aclCall).toBeDefined()
   expect(aclCall![0]).not.toHaveProperty('withCredentials')
 })
@@ -1011,7 +1012,7 @@ it('retries transient dataset ACL fetch failures instead of failing fatally', as
     }),
   )
 
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   const result = await resolvePermissions(instance, {actions: [createDocument(doc)]})
 
   expect(result).toEqual({allowed: true})
@@ -1037,7 +1038,7 @@ it('does not retry dataset ACL fetch failures caused by 4xx client errors', asyn
     }),
   )
 
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   const documentState = getDocumentState(instance, doc)
   const unsubscribe = documentState.subscribe()
 
@@ -1070,7 +1071,7 @@ it('retries dataset ACL fetch failures caused by 429 rate-limit errors', async (
     }),
   )
 
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   const result = await resolvePermissions(instance, {actions: [createDocument(doc)]})
 
   expect(result).toEqual({allowed: true})
@@ -1087,7 +1088,7 @@ it('fetches ACL for MediaLibraryResource', async () => {
   const datasetAcl = [{filter: 'true', permissions: ['read', 'update', 'create', 'history']}]
   vi.mocked(client.request).mockResolvedValue(datasetAcl)
 
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   const mediaLibraryResource = {mediaLibraryId: 'test-media-library'}
 
   const result = await resolvePermissions(mediaLibraryInstance, {
@@ -1105,7 +1106,7 @@ it('fetches ACL for CanvasResource', async () => {
   const datasetAcl = [{filter: 'true', permissions: ['read', 'update', 'create', 'history']}]
   vi.mocked(client.request).mockResolvedValue(datasetAcl)
 
-  const doc = createDocumentHandle({documentId: crypto.randomUUID(), documentType: 'article'})
+  const doc = createDocumentHandle({documentId: randomUuid(), documentType: 'article'})
   const canvasResource = {canvasId: 'test-canvas'}
 
   const result = await resolvePermissions(canvasInstance, {
@@ -1118,7 +1119,7 @@ it('fetches ACL for CanvasResource', async () => {
 })
 
 it('returns a promise that resolves when a document has been loaded in the store (useful for suspense)', async () => {
-  const documentId = DocumentId(crypto.randomUUID())
+  const documentId = DocumentId(randomUuid())
   const doc = createDocumentHandle({documentId, documentType: 'article'})
 
   expect(await resolveDocument(instance, doc)).toBe(null)
@@ -1143,7 +1144,7 @@ it('emits an event for each action after an outgoing transaction has been accept
   const handler = vi.fn()
   const unsubscribe = subscribeDocumentEvents(instance, {resource, eventHandler: handler})
 
-  const documentId = DocumentId(crypto.randomUUID())
+  const documentId = DocumentId(randomUuid())
   const doc = createDocumentHandle({documentId, documentType: 'article'})
   expect(handler).toHaveBeenCalledTimes(0)
 
@@ -1574,7 +1575,7 @@ beforeEach(() => {
       mutations: Mutation[],
       options: BaseMutationOptions = {},
     ): Promise<MultipleMutationResult> => {
-      const transactionId = options.transactionId ?? crypto.randomUUID()
+      const transactionId = options.transactionId ?? randomUuid()
       const timestamp = new Date().toISOString()
       const prior = {...documents}
       let next = {...documents}
@@ -1647,7 +1648,7 @@ beforeEach(() => {
   const action = vi.fn(
     async (
       input: HttpAction | HttpAction[],
-      {transactionId = crypto.randomUUID(), dryRun}: BaseActionOptions,
+      {transactionId = randomUuid(), dryRun}: BaseActionOptions,
     ): Promise<SingleActionResult | MultipleActionResult> => {
       const actions = Array.isArray(input) ? input : [input]
       let next: DocumentSet = {...documents}

package/src/document/documentStore.ts

@@ -1,7 +1,6 @@
 import {type Action, ClientError, CorsOriginError, type Mutation} from '@sanity/client'
 import {DocumentId, getDraftId, getPublishedId, getVersionId} from '@sanity/id-utils'
 import {jsonMatch} from '@sanity/json-match'
-import {type SanityDocument} from 'groq'
 import {type ExprNode} from 'groq-js'
 import {
   catchError,
@@ -46,6 +45,7 @@ import {
 import {type SanityInstance} from '../store/createSanityInstance'
 import {createStateSourceAction, type StateSource} from '../store/createStateSourceAction'
 import {defineStore, type StoreContext} from '../store/defineStore'
+import {type ResolveDocument} from '../typegen/resolve'
 import {type DocumentAction} from './actions'
 import {
   ACL_RETRY_BASE_DELAY,
@@ -98,7 +98,7 @@ export interface DocumentStoreState {
   identity?: string
   error?: unknown
   sharedListener: SharedListener
-  fetchDocument: (documentId: string) => Observable<SanityDocument | null>
+  fetchDocument: (documentId: string) => Observable<ResolveDocument | null>
   events: Subject<DocumentEvent>
 }
 
@@ -108,12 +108,12 @@ export interface DocumentState {
    * the "remote" local copy that matches the server. represents the last known
    * server state. this gets updated every time we confirm remote patches
    */
-  remote?: SanityDocument | null
+  remote?: ResolveDocument | null
   /**
    * the current ephemeral working copy that includes local optimistic changes
    * that have not yet been confirmed by the server
    */
-  local?: SanityDocument | null
+  local?: ResolveDocument | null
   /**
    * the revision that our remote document is at
    */
@@ -194,7 +194,7 @@ export function getDocumentState<
 >(
   instance: SanityInstance,
   options: DocumentOptions<undefined, TDocumentType, TDataset, TProjectId>,
-): StateSource<SanityDocument<TDocumentType, `${TProjectId}.${TDataset}`> | undefined | null>
+): StateSource<ResolveDocument<TDocumentType, `${TProjectId}.${TDataset}`> | undefined | null>
 
 /** @beta */
 export function getDocumentState<
@@ -206,7 +206,7 @@ export function getDocumentState<
   instance: SanityInstance,
   options: DocumentOptions<TPath, TDocumentType, TDataset, TProjectId>,
 ): StateSource<
-  JsonMatch<SanityDocument<TDocumentType, `${TProjectId}.${TDataset}`>, TPath> | undefined
+  JsonMatch<ResolveDocument<TDocumentType, `${TProjectId}.${TDataset}`>, TPath> | undefined
 >
 
 /** @beta */
@@ -229,12 +229,12 @@ const _getDocumentState = bindActionByResource(
       const {documentId: docId, path, liveEdit, perspective} = options
       const documentId = DocumentId(docId)
       if (error) throw error
-      let document: SanityDocument | null | undefined
+      let document: ResolveDocument | null | undefined
 
       if (liveEdit) {
         document = documentStates[documentId]?.local
       } else {
-        let version: SanityDocument | null | undefined
+        let version: ResolveDocument | null | undefined
         if (isReleasePerspective(perspective)) {
           const versionId = getVersionId(documentId, perspective.releaseName)
           version = documentStates[versionId]?.local
@@ -267,16 +267,16 @@ export function resolveDocument<
 >(
   instance: SanityInstance,
   docHandle: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): Promise<SanityDocument<TDocumentType, `${TProjectId}.${TDataset}`> | null>
+): Promise<ResolveDocument<TDocumentType, `${TProjectId}.${TDataset}`> | null>
 /** @beta */
-export function resolveDocument<TData extends SanityDocument>(
+export function resolveDocument<TData extends ResolveDocument>(
   instance: SanityInstance,
   docHandle: DocumentHandle<string, string, string>,
 ): Promise<TData | null>
 /** @beta */
 export function resolveDocument(
   ...args: Parameters<typeof _resolveDocument>
-): Promise<SanityDocument | null> {
+): Promise<ResolveDocument | null> {
   return _resolveDocument(...args)
 }
 const _resolveDocument = bindActionByResource(
@@ -287,7 +287,7 @@ const _resolveDocument = bindActionByResource(
         ...docHandle,
         path: undefined,
       }).observable.pipe(filter((i) => i !== undefined)),
-    ) as Promise<SanityDocument | null>
+    ) as Promise<ResolveDocument | null>
   },
 )
 
@@ -550,13 +550,13 @@ const subscribeToClientAndFetchDatasetAcl = ({
 }: StoreContext<DocumentStoreState, BoundResourceKey>) => {
   const clientOptions: ClientOptions = {apiVersion: API_VERSION, resource}
 
-  let uri: string
+  let url: string
   if (resource && isDatasetResource(resource)) {
-    uri = `/projects/${resource.projectId}/datasets/${resource.dataset}/acl`
+    url = `/projects/${resource.projectId}/datasets/${resource.dataset}/acl`
   } else if (resource && isMediaLibraryResource(resource)) {
-    uri = `/media-libraries/${resource.mediaLibraryId}/acl`
+    url = `/media-libraries/${resource.mediaLibraryId}/acl`
   } else if (resource && isCanvasResource(resource)) {
-    uri = `/canvases/${resource.canvasId}/acl`
+    url = `/canvases/${resource.canvasId}/acl`
   } else {
     throw new Error(`Received invalid resource: ${JSON.stringify(resource)}`)
   }
@@ -566,7 +566,7 @@ const subscribeToClientAndFetchDatasetAcl = ({
       switchMap((client) =>
         client.observable
           .request<DatasetAcl>({
-            uri,
+            url,
             tag: 'acl.get',
           })
           .pipe(

package/src/document/permissions.ts

@@ -5,6 +5,7 @@ import {createSelector} from 'reselect'
 
 import {isReleasePerspective} from '../releases/utils/isReleasePerspective'
 import {type SelectorContext} from '../store/createStateSourceAction'
+import {randomId} from '../utils/ids'
 import {MultiKeyWeakMap} from '../utils/MultiKeyWeakMap'
 import {type DocumentAction} from './actions'
 import {ActionError, PermissionActionError, processActions} from './processActions/processActions'
@@ -190,7 +191,7 @@ const _calculatePermissions = createSelector(
     try {
       processActions({
         actions,
-        transactionId: crypto.randomUUID(),
+        transactionId: randomId(16),
         working: documents,
         base: documents,
         timestamp,

package/src/document/processActions.test.ts

@@ -2,6 +2,7 @@ import {type CreateMutation, type Reference, type SanityDocument} from '@sanity/
 import {parse} from 'groq-js'
 import {describe, expect, it} from 'vitest'
 
+import {randomUuid} from '../utils/ids'
 import {type Action, type DocumentAction} from './actions'
 import {ActionError, processActions} from './processActions/processActions'
 import {type DocumentSet, processMutations} from './processMutations'
@@ -973,7 +974,7 @@ describe('processActions', () => {
     })
 
     it('should strengthen `_strengthenOnPublish` references', () => {
-      const _ref = crypto.randomUUID()
+      const _ref = randomUuid()
       const referenceToStrength: Reference = {
         _ref,
         _type: 'reference',