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

package/dist/index.d.ts

@@ -1,328 +1,31 @@
-import * as _sanity_client12 from "@sanity/client";
-import { ClientConfig, ClientError, ClientPerspective, ListenEvent, ResponseQueryOptions, SanityClient, SanityDocument as SanityDocument$1, SanityProject as SanityProject$1, StackablePerspective } from "@sanity/client";
+import { $ as getIsInDashboardState, A as transformProjectionToPreview, At as isDatasetSource, B as getClientErrorApiBody, C as QueryOptions, Ct as ReleasePerspective, D as resolveQuery, Dt as isCanvasResource, E as parseQueryKey, Et as TokenSource, F as ValuePending, G as AuthStoreState, H as getClientErrorApiType, I as ProjectionValuePending, J as LoggedOutAuthState, K as ErrorAuthState, L as ValidProjection, M as PreviewQueryResult, Mt as isMediaLibrarySource, N as PreviewStoreState, Nt as AuthConfig, O as Selector, Ot as isCanvasSource, P as PreviewValue, Pt as AuthProvider, Q as getDashboardOrganizationId, R as PREVIEW_PROJECTION, St as ReleaseHandle, T as getQueryState, Tt as StudioConfig, U as isProjectUserNotFoundClientError, V as getClientErrorApiDescription, W as AuthState, X as getAuthState, Y as LoggingInAuthState, Z as getCurrentUserState, _t as DocumentTypeHandle, a as GetUsersOptions, at as StoreAction, b as MutationResult, bt as PerspectiveHandle, c as ResolveUsersOptions, ct as isStudioConfig, d as UserProfile, dt as DatasetHandle, et as getLoginUrlState, f as UsersGroupState, ft as DatasetResource, g as Fetcher, gt as DocumentSource, ht as DocumentResource, i as GetUserOptions, it as BoundStoreAction, j as PreviewMedia, jt as isMediaLibraryResource, k as StateSource, kt as isDatasetResource, l as SanityUser, lt as CanvasResource, mt as DocumentHandle, n as getUsersKey, nt as setAuthToken, o as Membership, ot as SanityInstance, p as UsersStoreState, pt as DatasetSource, q as LoggedInAuthState, r as parseUsersKey, rt as AuthStateType, s as ResolveUserOptions, st as createSanityInstance, t as createGroqSearchFilter, tt as getTokenState, u as SanityUserResponse, ut as CanvasSource, vt as MediaLibraryResource, w as getQueryKey, wt as SanityConfig, xt as ProjectHandle, yt as MediaLibrarySource, z as ApiErrorBody } from "./_chunks-dts/createGroqSearchFilter.js";
+import { ClientConfig, ListenEvent, MultipleMutationResult, ReleaseDocument, ReleaseDocument as ReleaseDocument$1, SanityClient, SanityDocument as SanityDocument$1, SanityProject as SanityProject$1 } from "@sanity/client";
+import { CurrentUser, Mutation, PatchOperations, Role, SanityDocument, SanityDocument as SanityDocument$2, SanityDocumentLike } from "@sanity/types";
 import { Observable, Subject } from "rxjs";
-import { CurrentUser, CurrentUser as CurrentUser$1, Mutation, PatchOperations, Role, SanityDocument, SanityDocument as SanityDocument$2, SanityDocumentLike } from "@sanity/types";
-import * as _sanity_comlink5 from "@sanity/comlink";
+import { SanityDocument as SanityDocument$3, SanityProjectionResult } from "groq";
 import { ChannelInput, ChannelInstance, Controller, Message, Node, NodeInput, Status } from "@sanity/comlink";
 import { PatchMutation } from "@sanity/mutate/_unstable_store";
 import { ExprNode } from "groq-js";
 import { CanvasResource as CanvasResource$1, MediaResource, StudioResource } from "@sanity/message-protocol";
 import { getIndexForKey, getPathDepth, joinPaths, jsonMatch, slicePath, stringifyPath } from "@sanity/json-match";
 /**
- * Configuration for an authentication provider
- * @public
- */
-interface AuthProvider {
-  /**
-   * Unique identifier for the auth provider (e.g., 'google', 'github')
-   */
-  name: string;
-  /**
-   * Display name for the auth provider in the UI
-   */
-  title: string;
-  /**
-   * Complete authentication URL including callback and token parameters
-   */
-  url: string;
-  /**
-   * Optional URL for direct sign-up flow
-   */
-  signUpUrl?: string;
-}
-/**
- * Configuration options for creating an auth store.
- *
- * @public
- */
-interface AuthConfig {
-  /**
-   * The initial location href to use when handling auth callbacks.
-   * Defaults to the current window location if available.
-   */
-  initialLocationHref?: string;
-  /**
-   * Factory function to create a SanityClient instance.
-   * Defaults to the standard Sanity client factory if not provided.
-   */
-  clientFactory?: (config: ClientConfig) => SanityClient;
-  /**
-   * Custom authentication providers to use instead of or in addition to the default ones.
-   * Can be an array of providers or a function that takes the default providers and returns
-   * a modified array or a Promise resolving to one.
-   */
-  providers?: AuthProvider[] | ((prev: AuthProvider[]) => AuthProvider[] | Promise<AuthProvider[]>);
-  /**
-   * The API hostname for requests. Usually leave this undefined, but it can be set
-   * if using a custom domain or CNAME for the API endpoint.
-   */
-  apiHost?: string;
-  /**
-   * Storage implementation to persist authentication state.
-   * Defaults to `localStorage` if available.
-   */
-  storageArea?: Storage;
-  /**
-   * A callback URL for your application.
-   * If none is provided, the auth API will redirect back to the current location (`location.href`).
-   * When handling callbacks, this URL's pathname is checked to ensure it matches the callback.
-   */
-  callbackUrl?: string;
-  /**
-   * A static authentication token to use instead of handling the OAuth flow.
-   * When provided, the auth store will remain in a logged-in state with this token,
-   * ignoring any storage or callback handling.
-   */
-  token?: string;
-}
-/**
- * A minimal Observable-compatible interface for subscribing to token changes.
- * Any object with a `subscribe` method that follows this contract will work,
- * including RxJS Observables. This avoids coupling the SDK to a specific
- * reactive library.
- *
- * @public
- */
-interface TokenSource {
-  /** Subscribe to token emissions. Emits `null` when logged out. */
-  subscribe(observer: {
-    next: (token: string | null) => void;
-  }): {
-    unsubscribe(): void;
-  };
-}
-/**
- * Studio-specific configuration for the SDK.
- * When present, the SDK operates in studio mode and derives auth from the
- * provided token source instead of discovering tokens independently.
- *
- * @public
- */
-interface StudioConfig {
-  /**
-   * Whether the Studio has already determined the user is authenticated.
-   * When `true` and the token source emits `null`, the SDK infers
-   * cookie-based auth is in use rather than transitioning to logged-out.
-   */
-  authenticated?: boolean;
-  /** Reactive auth token source from the Studio's auth store. */
-  auth?: {
-    /**
-     * A reactive token source. The SDK subscribes and stays in sync — the
-     * Studio is the single authority for auth and handles token refresh.
-     *
-     * Optional because older Studios may not expose it. When absent, the
-     * SDK falls back to localStorage/cookie discovery.
-     */
-    token?: TokenSource;
-  };
-  /**
-   * The project ID for this Studio workspace.
-   * Used to derive the localStorage key for studio auth token discovery
-   * (`__studio_auth_token_<projectId>`) and for project-specific API hostname requests.
-   */
-  projectId?: string;
-}
-/**
- * @public
- */
-type ReleasePerspective = {
-  releaseName: string;
-  excludedPerspectives?: StackablePerspective[];
-};
-/**
- * @public
- */
-interface PerspectiveHandle {
-  /**
-   * The perspective to use for this operation.
-   * Note that the SDK stacks perspectives for you when querying.
-   * The SDK automatically fetches all of your content releases, and orders them the way the Sanity Studio does: usually by scheduled date, with ASAP releases coming first.
-   * @public
-   */
-  perspective?: Exclude<ClientPerspective, readonly unknown[]> | ReleasePerspective;
-}
-/**
- * @public
- */
-interface ResourceHandle<TProjectId extends string = string, TDataset extends string = string> extends PerspectiveHandle {
-  /**
-   * Explicit resource object to use for this operation.
-   * @public
-   */
-  resource: DocumentResource<TProjectId, TDataset>;
-}
-/**
- * Identifies a specific document type within a Sanity dataset and project.
- * Includes `projectId`, `dataset`, and `documentType`.
- * Optionally includes a `documentId` and `liveEdit` flag.
- * @public
- */
-interface DocumentTypeHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends ResourceHandle<TDataset, TProjectId> {
-  documentId?: string;
-  documentType: TDocumentType;
-  /**
-   * Indicates whether this document uses liveEdit mode.
-   * When `true`, the document does not use the draft/published model and edits are applied directly to the document.
-   * @see https://www.sanity.io/docs/content-lake/drafts#ca0663a8f002
-   */
-  liveEdit?: boolean;
-}
-/**
- * Uniquely identifies a specific document within a Sanity dataset and project.
- * Includes `projectId`, `dataset`, `documentType`, and the required `documentId`.
- * Commonly used by document-related hooks and components to reference a document without fetching its full content initially.
- * @public
- */
-interface DocumentHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentTypeHandle<TDocumentType, TDataset, TProjectId> {
-  documentId: string;
-}
-/**
- * The key used to identify the default resource in a resources map.
- * When no `resource` or `resourceName` is specified, the SDK resolves
- * the resource registered under this name.
+ * The resource types the Access API can scope a permission check to.
  *
+ * @see https://www.sanity.io/docs/http-reference/access-api
  * @public
  */
-declare const DEFAULT_RESOURCE_NAME = "default";
+type AccessResourceType = 'organization' | 'project' | 'media-library' | 'canvas' | 'dashboard' | 'view';
 /**
- * Represents the complete configuration for a Sanity SDK instance.
+ * 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.
  *
- * Most apps configure resources via the `resources` prop on `SanityApp`:
- *
- * @example Typical React usage
- * ```tsx
- * <SanityApp
- *   resources={{ default: { projectId: 'abc123', dataset: 'production' } }}
- *   fallback={<Loading />}
- * >
- *   <App />
- * </SanityApp>
- * ```
- *
- * The `defaultResource` field is set automatically by the React layer from
- * `resources['default']`. It can also be set directly when using the core
- * SDK without React (e.g. in a Node.js script):
- *
- * @example Direct core usage (without React)
- * ```ts
- * const instance = createSanityInstance({
- *   defaultResource: { projectId: 'abc123', dataset: 'production' },
- * })
- * ```
- * @public
- */
-interface SanityConfig extends PerspectiveHandle {
-  /**
-   * Authentication configuration for the instance
-   */
-  auth?: AuthConfig;
-  /**
-   * Studio configuration provided by a Sanity Studio workspace.
-   * When present, the SDK operates in studio mode and derives auth from the
-   * workspace's reactive token source — no manual configuration needed.
-   *
-   * @remarks Typically set automatically by `SanityApp` when it detects an
-   * `SDKStudioContext` provider. Can also be set explicitly for programmatic use.
-   */
-  studio?: StudioConfig;
-  /**
-   * The default document resource for this instance. Used by bound actions
-   * when no explicit resource is provided.
-   *
-   * @public
-   */
-  defaultResource?: DocumentResource;
-}
-/**
- * A document resource identifies where data is stored and queried from.
- * Can be a dataset (project + dataset pair), a media library, or a canvas.
- *
- * @public
- */
-type DocumentResource<TProjectId extends string = string, TDataset extends string = string> = DatasetResource<TProjectId, TDataset> | MediaLibraryResource | CanvasResource;
-/**
- * A resource that targets a specific project and dataset.
- * @public
- */
-type DatasetResource<TProjectId extends string = string, TDataset extends string = string> = {
-  projectId: TProjectId;
-  dataset: TDataset;
-};
-/**
- * A resource that targets a media library.
- * @public
- */
-type MediaLibraryResource = {
-  mediaLibraryId: string;
-};
-/**
- * A resource that targets a canvas.
- * @public
- */
-type CanvasResource = {
-  canvasId: string;
-};
-/**
- * Type guard that checks whether a {@link DocumentResource} is a {@link DatasetResource}.
- * @public
- */
-declare function isDatasetResource(resource: DocumentResource): resource is DatasetResource;
-/**
- * Type guard that checks whether a {@link DocumentResource} is a {@link MediaLibraryResource}.
- * @public
- */
-declare function isMediaLibraryResource(resource: DocumentResource): resource is MediaLibraryResource;
-/**
- * Type guard that checks whether a {@link DocumentResource} is a {@link CanvasResource}.
- * @public
- */
-declare function isCanvasResource(resource: DocumentResource): resource is CanvasResource;
-/**
- * Represents a Sanity.io resource instance with its own configuration and lifecycle.
- *
- * @public
- */
-interface SanityInstance {
-  /**
-   * Unique identifier for this instance
-   * @remarks Generated using crypto.randomUUID()
-   */
-  readonly instanceId: string;
-  /** Resolved configuration for this instance */
-  readonly config: SanityConfig;
-  /**
-   * Checks if the instance has been disposed
-   * @returns true if dispose() has been called
-   */
-  isDisposed(): boolean;
-  /**
-   * Disposes the instance and cleans up associated resources
-   * @remarks Triggers all registered onDispose callbacks
-   */
-  dispose(): void;
-  /**
-   * Registers a callback to be invoked when the instance is disposed
-   * @param cb - Callback to execute on disposal
-   * @returns Function to unsubscribe the callback
-   */
-  onDispose(cb: () => void): () => void;
-}
-/**
- * Creates a new Sanity resource instance
- * @param config - Configuration for the instance (optional)
- * @returns A configured SanityInstance
- *
- * @public
- */
-declare function createSanityInstance(config?: SanityConfig): SanityInstance;
-/**
- * Options that all agent actions accept for targeting a specific resource.
- * @alpha
+ * @see https://www.sanity.io/docs/http-reference/access-api
+ * @internal
  */
-interface AgentResourceOptions {
-  resource: DocumentResource;
-}
+declare const checkPermissions: Fetcher<[resourceType: AccessResourceType, resourceId: string, permissions: string[]], Record<string, boolean>>;
 /** @alpha */
 type AgentGenerateOptions = Parameters<SanityClient['observable']['agent']['action']['generate']>[0];
 /** @alpha */
@@ -350,7 +53,7 @@ type AgentPatchResult = Awaited<ReturnType<SanityClient['agent']['action']['patc
  * @returns An Observable emitting the result of the agent generate action.
  * @alpha
  */
-declare function agentGenerate(instance: SanityInstance, options: AgentGenerateOptions & AgentResourceOptions): AgentGenerateResult;
+declare function agentGenerate(instance: SanityInstance, options: AgentGenerateOptions, resource?: DocumentResource): AgentGenerateResult;
 /**
  * Transforms a document using the agent.
  * @param instance - The Sanity instance.
@@ -358,7 +61,7 @@ declare function agentGenerate(instance: SanityInstance, options: AgentGenerateO
  * @returns An Observable emitting the result of the agent transform action.
  * @alpha
  */
-declare function agentTransform(instance: SanityInstance, options: AgentTransformOptions & AgentResourceOptions): AgentTransformResult;
+declare function agentTransform(instance: SanityInstance, options: AgentTransformOptions, resource?: DocumentResource): AgentTransformResult;
 /**
  * Translates a document using the agent.
  * @param instance - The Sanity instance.
@@ -366,7 +69,7 @@ declare function agentTransform(instance: SanityInstance, options: AgentTransfor
  * @returns An Observable emitting the result of the agent translate action.
  * @alpha
  */
-declare function agentTranslate(instance: SanityInstance, options: AgentTranslateOptions & AgentResourceOptions): AgentTranslateResult;
+declare function agentTranslate(instance: SanityInstance, options: AgentTranslateOptions, resource?: DocumentResource): AgentTranslateResult;
 /**
  * Prompts the agent using the same instruction template format as the other actions, but returns text or json instead of acting on a document.
  * @param instance - The Sanity instance.
@@ -374,7 +77,7 @@ declare function agentTranslate(instance: SanityInstance, options: AgentTranslat
  * @returns An Observable emitting the result of the agent prompt action.
  * @alpha
  */
-declare function agentPrompt(instance: SanityInstance, options: AgentPromptOptions & AgentResourceOptions): Observable<AgentPromptResult>;
+declare function agentPrompt(instance: SanityInstance, options: AgentPromptOptions, resource?: DocumentResource): Observable<AgentPromptResult>;
 /**
  * Patches a document using the agent.
  * @param instance - The Sanity instance.
@@ -382,192 +85,421 @@ declare function agentPrompt(instance: SanityInstance, options: AgentPromptOptio
  * @returns An Observable emitting the result of the agent patch action.
  * @alpha
  */
-declare function agentPatch(instance: SanityInstance, options: AgentPatchOptions & AgentResourceOptions): Observable<AgentPatchResult>;
+declare function agentPatch(instance: SanityInstance, options: AgentPatchOptions, resource?: DocumentResource): Observable<AgentPatchResult>;
 /**
- * Returns `true` when the config indicates the SDK is running inside a Studio.
+ * A response field that the API embeds only when its `include` token was
+ * requested. Given the full set of tokens `All`, the token `Key` this field
+ * maps to, and the tokens actually `Requested`, it resolves to:
+ *
+ * - `unknown` (field absent) when nothing — or nothing matching `Key` — was requested
+ * - `Field` (present, as declared) when a literal request list contains `Key`
+ * - `Partial<Field>` (optional) when `Requested` is the wide `All` union, i.e.
+ *   an `include` array whose members aren't known at the type level
+ *
+ * Absent arms return `unknown` so they vanish under intersection. Mirrors the
+ * `boolean extends Flag` trick the organization/project types use, but for an
+ * include-token union rather than a boolean flag.
  *
  * @internal
  */
-declare function isStudioConfig(config: SanityConfig): boolean;
+type Included<All extends string, Key extends All, Requested extends All, Field> = [All] extends [Requested] ? Partial<Field> : [Key] extends [Requested] ? Field : unknown;
 /**
- * Represents the various states the authentication type can be in.
+ * Whether the requested include tokens intersect a given set — used to decide
+ * whether a parent field (e.g. an application's `activeDeployment`) is present,
+ * when requesting any of several tokens forces it in.
  *
+ * @internal
+ */
+type IncludesAny<Requested extends string, Set extends string> = [Requested & Set] extends [never] ? false : true;
+/**
+ * Related data the Applications API can embed in a response. `interfaces`,
+ * `workspaces` and `access` are children of the active deployment and are
+ * embedded under {@link Application.activeDeployment}; `config.studio` and
+ * `config.mfManifest` are embedded under {@link Application.config}.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-declare enum AuthStateType {
-  LOGGED_IN = "logged-in",
-  LOGGING_IN = "logging-in",
-  ERROR = "error",
-  LOGGED_OUT = "logged-out",
-}
+type ApplicationInclude = 'interfaces' | 'workspaces' | 'access' | 'config.studio' | 'config.mfManifest' | 'activeDeployment';
 /**
- * Represents a reactive store state container with multiple access patterns
+ * An interface exposed by a deployment, embedded when `interfaces` is included.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @public
  */
-interface StoreState<TState> {
-  /**
-   * Gets the current state value
-   *
-   * @remarks
-   * This is a direct synchronous accessor that doesn't trigger subscriptions
-   */
-  get: () => TState;
-  /**
-   * Updates the store state
-   * @param name - Action name for devtools tracking
-   * @param updatedState - New state value or updater function
-   *
-   * @remarks
-   * When providing a partial object, previous top-level keys not included in
-   * the update will be preserved.
-   */
-  set: (name: string, updatedState: Partial<TState> | ((s: TState) => Partial<TState>)) => void;
-  /**
-   * Observable stream of state changes
-   * @remarks
-   * - Emits immediately with current state on subscription
-   * - Shares underlying subscription between observers
-   * - Only emits when state reference changes
-   * - Completes when store is disposed
-   */
-  observable: Observable<TState>;
+interface ApplicationInterface {
+  id: string;
+  type: 'app' | 'worker' | 'asset_source' | 'panel';
+  name: string;
+  title: string;
+  version: string;
+  /** Module federation module ID; resolved from the host mf-manifest at runtime */
+  moduleId: string;
+  metadata: {
+    group?: string;
+    priority?: number;
+  } | null;
 }
 /**
- * Context object provided to store initialization functions
+ * A studio workspace of a deployment, embedded when `workspaces` is included.
+ * Studio applications only.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @public
  */
-interface StoreContext<TState, TKey = unknown> {
-  /**
-   * Sanity instance associated with this store
-   *
-   * @remarks
-   * Provides access to the Sanity configuration and instance lifecycle methods
-   */
-  instance: SanityInstance;
-  /**
-   * Reactive store state management utilities
-   *
-   * @remarks
-   * Contains methods for getting/setting state and observing changes
-   */
-  state: StoreState<TState>;
-  /**
-   * The key used to instantiate the store.
-   */
-  key: TKey;
+interface ApplicationWorkspace {
+  id: string;
+  name: string;
+  title: string | null;
+  subtitle: string | null;
+  projectId: string;
+  dataset: string;
+  schemaDescriptorId: string | null;
+  basePath: string | null;
+  /** Sanitized SVG icon markup */
+  icon: string | null;
 }
 /**
- * Defines a store action that operates on a specific state type
+ * A resource an application accesses, embedded when `access` is included.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @public
  */
-type StoreAction<TState, TParams extends unknown[], TReturn, TKey = unknown> = (context: StoreContext<TState, TKey>, ...params: TParams) => TReturn;
+interface ApplicationAccess {
+  id: string;
+  resourceType: 'datasets' | 'canvases' | 'dashboards' | 'media-libraries';
+  resourceId: string;
+}
 /**
- * Represents a store action that has been bound to a specific store instance
+ * Studio configuration, embedded under `config` when `config.studio` is included.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @public
  */
-type BoundStoreAction<_TState, TParams extends unknown[], TReturn> = (instance: SanityInstance, ...params: TParams) => TReturn;
+interface ApplicationStudioConfig {
+  projectId: string;
+  /** Release channel (`next`, `stable`, `latest`) or a pinned semver; null if unset */
+  autoUpdatingVersion: string | null;
+}
 /**
- * Represents the various states the authentication can be in.
+ * The active deployment as embedded under {@link Application.activeDeployment}.
+ * Its `interfaces`, `workspaces` and `access` children are each present only
+ * when the matching {@link ApplicationInclude} token was requested. `workspaces`
+ * is omitted (not `null`) for non-studio applications even when requested.
  *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-type AuthState = LoggedInAuthState | LoggedOutAuthState | LoggingInAuthState | ErrorAuthState;
+type ApplicationDeployment<Include extends ApplicationInclude = never> = {
+  id: string;
+  applicationId: string;
+  size: number | null;
+  version: string | null;
+  isAutoUpdating: boolean | null;
+  isActiveDeployment: boolean;
+  deployedBy: string | null;
+  createdAt: string;
+  updatedAt: string;
+} & Included<ApplicationInclude, 'interfaces', Include, {
+  interfaces: ApplicationInterface[];
+}> & Included<ApplicationInclude, 'workspaces', Include, {
+  workspaces?: ApplicationWorkspace[];
+}> & Included<ApplicationInclude, 'access', Include, {
+  access: ApplicationAccess[];
+}>;
 /**
- * Logged-in state from the auth state.
+ * The always-present fields of an org-owned application returned by the
+ * Applications API (`/applications`), before any {@link ApplicationInclude}.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-type LoggedInAuthState = {
-  type: AuthStateType.LOGGED_IN;
-  token: string;
-  currentUser: CurrentUser$1 | null;
-  lastTokenRefresh?: number;
-};
+interface ApplicationBase {
+  id: string;
+  type: 'studio' | 'coreApp';
+  title: string;
+  icon: string | null;
+  isSingleton: boolean;
+  visibility: 'default' | 'unlisted' | 'disabled';
+  slug: string | null;
+  externalUrl: string | null;
+  organizationId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+type DeploymentToken = 'activeDeployment' | 'interfaces' | 'workspaces' | 'access';
+type ApplicationConfigShape<Include extends ApplicationInclude> = Included<ApplicationInclude, 'config.studio', Include, {
+  config: {
+    studio: ApplicationStudioConfig;
+  };
+}> & Included<ApplicationInclude, 'config.mfManifest', Include, {
+  config: {
+    mfManifest: unknown;
+  };
+}>;
+type ApplicationDeploymentShape<Include extends ApplicationInclude> = [ApplicationInclude] extends [Include] ? {
+  activeDeployment?: ApplicationDeployment<Include> | null;
+} : IncludesAny<Include, DeploymentToken> extends true ? {
+  activeDeployment: ApplicationDeployment<Include> | null;
+} : unknown;
 /**
- * Logged-out state from the auth state.
+ * An org-owned application as returned by the Applications API
+ * (`/applications`). `config` and `activeDeployment` (with its
+ * `interfaces`/`workspaces`/`access` children) are present only when the
+ * corresponding {@link ApplicationInclude} tokens were requested.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-type LoggedOutAuthState = {
-  type: AuthStateType.LOGGED_OUT;
-  isDestroyingSession: boolean;
-};
+type Application<Include extends ApplicationInclude = never> = ApplicationBase & ApplicationConfigShape<Include> & ApplicationDeploymentShape<Include>;
 /**
- * Logging-in state from the auth state.
+ * Options for listing an organization's applications.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-type LoggingInAuthState = {
-  type: AuthStateType.LOGGING_IN;
-  isExchangingToken: boolean;
-};
+interface ApplicationsOptions<Include extends ApplicationInclude = ApplicationInclude> {
+  organizationId: string;
+  /** Filter by application type */
+  type?: string;
+  include?: Include[];
+  /** Page size (1-100, default 50), or `'none'` to disable pagination */
+  limit?: number | 'none';
+  /** Cursor from a previous response's `nextCursor` */
+  cursor?: string;
+}
 /**
- * Error state from the auth state.
+ * The cursor-paginated envelope returned by `GET /applications`.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-type ErrorAuthState = {
-  type: AuthStateType.ERROR;
-  error: unknown;
-};
+interface ApplicationsResponse<Include extends ApplicationInclude = never> {
+  nextCursor: string | null;
+  data: Application<Include>[];
+}
 /**
- * Represents the various states the authentication can be in.
+ * Fetcher for an organization's applications (`GET /applications`), on the
+ * shared fetcher cache.
  *
- * @public
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+declare const applications: Fetcher<[options: ApplicationsOptions<ApplicationInclude>], ApplicationsResponse<ApplicationInclude>>;
+/**
+ * Fetcher for a single application (`GET /applications/:id`), on the shared
+ * fetcher cache. No pre-seeding from {@link applications}: its list keys
+ * include the organization, which this fetcher's params can't reconstruct.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
  */
-interface DashboardContext {
-  mode?: string;
-  env?: string;
-  orgId?: string;
+declare const application: Fetcher<[applicationId: string, options?: {
+  include?: ApplicationInclude[];
+} | undefined], Application<ApplicationInclude>>;
+/**
+ * Confirmation returned by the API's soft-delete endpoints.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+interface DeletedResult {
+  deleted: boolean;
 }
 /**
- * The method of authentication used.
+ * Dashboard visibility for an application. The same set of values backs a user
+ * application's `dashboardStatus`.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @internal
  */
-type AuthMethodOptions = 'localstorage' | 'cookie' | undefined;
+type ApplicationVisibility = ApplicationBase['visibility'];
 /**
- * @public
+ * Mutable properties of an application (`PATCH /applications/:id`) — the
+ * writable subset of {@link ApplicationBase}, each optional, keyed by id.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
  */
-interface AuthStoreState {
-  authState: AuthState;
-  providers?: AuthProvider[];
-  options: {
-    initialLocationHref: string;
-    clientFactory: (config: ClientConfig) => SanityClient;
-    customProviders: AuthConfig['providers'];
-    storageKey: string;
-    storageArea: Storage | undefined;
-    apiHost: string | undefined;
-    loginUrl: string;
-    callbackUrl: string | undefined;
-    providedToken: string | undefined;
-    authMethod: AuthMethodOptions;
-  };
-  dashboardContext?: DashboardContext;
+type UpdateApplicationInput = {
+  applicationId: string;
+} & Partial<Pick<ApplicationBase, 'title' | 'icon' | 'visibility'>>;
+/**
+ * Mutation to update an application (`PATCH /applications/:id`). Invalidates the
+ * updated application and the list so active entries reconverge on server truth.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+declare const updateApplication: (instance: import("../_exports").SanityInstance, input: UpdateApplicationInput) => Promise<MutationResult<ApplicationBase>>;
+/**
+ * Input for {@link deleteApplication}.
+ *
+ * @internal
+ */
+interface DeleteApplicationInput {
+  applicationId: string;
 }
 /**
- * @public
+ * Mutation to soft-delete an application (`DELETE /applications/:id`).
+ * Invalidates the deleted application and the list.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
  */
-declare const getCurrentUserState: BoundStoreAction<AuthStoreState, [], StateSource<CurrentUser$1 | null>>;
+declare const deleteApplication: (instance: import("../_exports").SanityInstance, input: DeleteApplicationInput) => Promise<MutationResult<DeletedResult>>;
 /**
+ * A deployment of a user application, embedded when `activeDeployment` is
+ * included on the User Applications API. Distinct from the org Applications
+ * API's {@link ApplicationDeployment} summary.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-declare const getTokenState: BoundStoreAction<AuthStoreState, [], StateSource<string | null>>;
+interface UserApplicationDeployment {
+  id: string;
+  version: string | null;
+  isActiveDeployment: boolean;
+  userApplicationId: string;
+  isAutoUpdating: boolean | null;
+  size: number | null;
+  deployedAt: string;
+  deployedBy: string | null;
+  createdAt: string;
+  updatedAt: string;
+  manifest: unknown;
+}
 /**
+ * A user application (deployed studio or custom app) as returned by
+ * `/user-applications`.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-declare const getLoginUrlState: BoundStoreAction<AuthStoreState, [], StateSource<string>>;
+interface UserApplication {
+  id: string;
+  projectId: string | null;
+  organizationId: string | null;
+  title: string | null;
+  type: string;
+  urlType: string;
+  appHost: string;
+  dashboardStatus: string;
+  createdAt: string;
+  updatedAt: string;
+  autoUpdatingVersion: string | null;
+  activeDeployment: UserApplicationDeployment | null;
+  manifestData: unknown;
+  config: Record<string, unknown> | null;
+  manifest: unknown;
+}
 /**
+ * Options for listing an organization's user applications.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-declare const getAuthState: BoundStoreAction<AuthStoreState, [], StateSource<AuthState>>;
+interface UserApplicationsOptions {
+  organizationId: string;
+}
 /**
- * @public
+ * Fetcher for an organization's user applications (`GET /user-applications`),
+ * on the shared fetcher cache.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
  */
-declare const getDashboardOrganizationId: BoundStoreAction<AuthStoreState, [], StateSource<string | undefined>>;
+declare const userApplications: Fetcher<[options: UserApplicationsOptions], UserApplication[]>;
 /**
- * Returns a state source indicating if the SDK is running within a dashboard context.
- * @public
+ * Fetcher for a single user application (`GET /user-applications/:id`), on the
+ * shared fetcher cache. No pre-seeding from {@link userApplications}: its list
+ * keys include the organization, which this fetcher's params can't
+ * reconstruct.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
  */
-declare const getIsInDashboardState: BoundStoreAction<AuthStoreState, [], StateSource<boolean>>;
+declare const userApplication: Fetcher<[userApplicationId: string], UserApplication>;
 /**
- * Action to explicitly set the authentication token.
- * Used internally by the Comlink token refresh.
+ * Fields you can set when creating or updating a user application.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+interface UserApplicationWriteFields {
+  /** Human-friendly display name; `null` clears it */
+  title?: string | null;
+  /** `internal` for Sanity-hosted studios, `external` for externally hosted */
+  urlType?: 'internal' | 'external';
+  /** Studio subdomain (internal) or full `https` URL (external) */
+  appHost?: string;
+  /** Internal apps only: make this the default app for the deployment */
+  isDefaultForDeployment?: boolean;
+  /** Dashboard visibility */
+  dashboardStatus?: ApplicationVisibility;
+  /** Auto-update channel or a pinned semver */
+  autoUpdatingVersion?: string | null;
+}
+/**
+ * Input for {@link createUserApplication}: the writable fields, with `urlType`
+ * and `appHost` required. `organizationId` and `appType` are sent as query
+ * parameters; the rest form the request body.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @internal
  */
-declare const setAuthToken: BoundStoreAction<AuthStoreState, [token: string | null], void>;
+interface CreateUserApplicationInput extends UserApplicationWriteFields {
+  /** Query param: owning organization */
+  organizationId?: string;
+  /** Query param: `studio` or `coreApp` */
+  appType?: 'studio' | 'coreApp';
+  urlType: 'internal' | 'external';
+  appHost: string;
+  /** Create does not accept a `null` title */
+  title?: string;
+}
+/**
+ * Mutation to create a user application (`POST /user-applications`). Invalidates
+ * the list so it reconverges to include the new entry.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+declare const createUserApplication: (instance: import("../_exports").SanityInstance, input: CreateUserApplicationInput) => Promise<MutationResult<UserApplication>>;
+/**
+ * Input for {@link updateUserApplication}: the writable fields (all optional),
+ * keyed by id.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+interface UpdateUserApplicationInput extends UserApplicationWriteFields {
+  userApplicationId: string;
+}
+/**
+ * Mutation to update a user application (`PATCH /user-applications/:id`).
+ * Invalidates the updated entry and the list.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+declare const updateUserApplication: (instance: import("../_exports").SanityInstance, input: UpdateUserApplicationInput) => Promise<MutationResult<UserApplication>>;
+/**
+ * Input for {@link deleteUserApplication}.
+ *
+ * @internal
+ */
+interface DeleteUserApplicationInput {
+  userApplicationId: string;
+}
+/**
+ * Mutation to delete a user application (`DELETE /user-applications/:id`).
+ * Invalidates the deleted entry and the list.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+declare const deleteUserApplication: (instance: import("../_exports").SanityInstance, input: DeleteUserApplicationInput) => Promise<MutationResult<DeletedResult>>;
 /**
  * Error message returned by the organization verification
  * @public
@@ -578,7 +510,7 @@ interface OrgVerificationResult {
 /**
  * Creates an observable that emits the organization verification state for a given instance.
  * It combines the dashboard organization ID (from auth context) with the
- * project's actual organization ID (fetched via getProjectState) and compares them.
+ * project's actual organization ID (fetched via the project fetcher) and compares them.
  * @public
  */
 declare function observeOrganizationVerificationState(instance: SanityInstance, projectIds: string[]): Observable<OrgVerificationResult>;
@@ -590,24 +522,6 @@ declare const handleAuthCallback: BoundStoreAction<AuthStoreState, [locationHref
  * @public
  */
 declare const logout: BoundStoreAction<AuthStoreState, [], Promise<void>>;
-/** @internal */
-type ApiErrorBody = {
-  error?: {
-    type?: string;
-    description?: string;
-  };
-  type?: string;
-  description?: string;
-  message?: string;
-};
-/** @internal Extracts the structured API error body from a ClientError, if present. */
-declare function getClientErrorApiBody(error: ClientError): ApiErrorBody | undefined;
-/** @internal Returns the error type string from an API error body, if available. */
-declare function getClientErrorApiType(error: ClientError): string | undefined;
-/** @internal Returns the error description string from an API error body, if available. */
-declare function getClientErrorApiDescription(error: ClientError): string | undefined;
-/** @internal True if the error represents a projectUserNotFoundError. */
-declare function isProjectUserNotFoundClientError(error: ClientError): boolean;
 type AllowedClientConfigKey = 'useCdn' | 'token' | 'perspective' | 'apiHost' | 'proxy' | 'withCredentials' | 'timeout' | 'maxRetries' | 'dataset' | 'projectId' | 'requestTagPrefix' | 'useProjectHostname';
 /**
  * States tracked by the client store
@@ -615,7 +529,7 @@ type AllowedClientConfigKey = 'useCdn' | 'token' | 'perspective' | 'apiHost' | '
  */
 interface ClientStoreState {
   token: string | null;
-  clients: { [TKey in string]?: SanityClient };
+  clients: { [TKey in string]?: SanityClient; };
   authMethod?: 'localstorage' | 'cookie';
 }
 /**
@@ -634,30 +548,22 @@ interface ClientStoreState {
  *
  * @public
  */
-interface ClientOptions extends Omit<Pick<ClientConfig, AllowedClientConfigKey>, 'resource'> {
-  /**
-   * Narrows the inherited `perspective` to exclude stackable perspectives,
-   * which are not supported by the SDK.
-   */
-  'perspective'?: Exclude<ClientPerspective, readonly unknown[]>;
+interface ClientOptions extends Pick<ClientConfig, AllowedClientConfigKey> {
   /**
    * An optional flag to choose between the default client (typically project-level)
    * and the global client ('global'). When set to `'global'`, the global client
    * is used.
    */
-  'scope'?: 'default' | 'global';
+  scope?: 'default' | 'global';
   /**
    * A required string indicating the API version for the client.
    */
-  'apiVersion': string;
-  /**
-   * @internal
-   */
-  '~experimental_resource'?: ClientConfig['~experimental_resource'];
+  apiVersion: string;
   /**
    * @internal
+   * The SDK resource to use for the client -- this will get transformed into a ClientConfig resource.
    */
-  'resource'?: DocumentResource;
+  resource?: DocumentResource;
 }
 /**
  * Retrieves a Sanity client instance configured with the provided options.
@@ -680,7 +586,7 @@ declare const getClient: BoundStoreAction<ClientStoreState, [options: ClientOpti
  *
  * @public
  */
-declare const getClientState: BoundStoreAction<ClientStoreState, [options: ClientOptions], StateSource<SanityClient>>;
+declare const getClientState: BoundStoreAction<ClientStoreState, [options: ClientOptions], import("../_exports").StateSource<SanityClient>>;
 /**
  * Message sent from a containing app to an iframe
  * @public
@@ -738,7 +644,7 @@ declare const destroyController: BoundStoreAction<ComlinkControllerState, [], vo
  * an application and the controller.
  * @public
  */
-declare const getOrCreateChannel: BoundStoreAction<ComlinkControllerState, [options: ChannelInput], ChannelInstance<_sanity_comlink5.Message, _sanity_comlink5.Message>>;
+declare const getOrCreateChannel: BoundStoreAction<ComlinkControllerState, [options: ChannelInput], ChannelInstance<import("@sanity/comlink").Message, import("@sanity/comlink").Message>>;
 /**
  * Initializes or fetches a controller to handle communication
  * between an application and iframes.
@@ -779,7 +685,7 @@ declare const releaseNode: BoundStoreAction<ComlinkNodeState, [name: string], vo
  * be created within a frame / window to communicate with the controller.
  * @public
  */
-declare const getOrCreateNode: BoundStoreAction<ComlinkNodeState, [options: NodeInput], Node<_sanity_comlink5.Message, _sanity_comlink5.Message>>;
+declare const getOrCreateNode: BoundStoreAction<ComlinkNodeState, [options: NodeInput], Node<import("@sanity/comlink").Message, import("@sanity/comlink").Message>>;
 /**
  * @public
  */
@@ -791,11 +697,10 @@ interface NodeState {
  * Provides a subscribable state source for a node by name
  * @param instance - The Sanity instance to get the node state for
  * @param nodeInput - The configuration for the node to get the state for
-
  * @returns A subscribable state source for the node
  * @public
  */
-declare const getNodeState: BoundStoreAction<ComlinkNodeState, [NodeInput], StateSource<NodeState | undefined>>;
+declare const getNodeState: BoundStoreAction<ComlinkNodeState, [NodeInput], import("../../_exports").StateSource<NodeState | undefined>>;
 /**
  * Creates or validates a `DocumentHandle` object.
  * Ensures the provided object conforms to the `DocumentHandle` interface.
@@ -813,13 +718,21 @@ declare function createDocumentHandle<TDocumentType extends string = string, TDa
  */
 declare function createDocumentTypeHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(handle: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>): DocumentTypeHandle<TDocumentType, TDataset, TProjectId>;
 /**
- * Creates or validates a `ResourceHandle` object.
- * Ensures the provided object conforms to the `ResourceHandle` interface.
- * @param handle - The object containing resource identification properties.
- * @returns The validated `ResourceHandle` object.
+ * Creates or validates a `ProjectHandle` object.
+ * Ensures the provided object conforms to the `ProjectHandle` interface.
+ * @param handle - The object containing project identification properties.
+ * @returns The validated `ProjectHandle` object.
+ * @public
+ */
+declare function createProjectHandle<TProjectId extends string = string>(handle: ProjectHandle<TProjectId>): ProjectHandle<TProjectId>;
+/**
+ * Creates or validates a `DatasetHandle` object.
+ * Ensures the provided object conforms to the `DatasetHandle` interface.
+ * @param handle - The object containing dataset identification properties.
+ * @returns The validated `DatasetHandle` object.
  * @public
  */
-declare function createResourceHandle<TDataset extends string = string, TProjectId extends string = string>(handle: ResourceHandle<TProjectId, TDataset>): ResourceHandle<TProjectId, TDataset>;
+declare function createDatasetHandle<TDataset extends string = string, TProjectId extends string = string>(handle: DatasetHandle<TDataset, TProjectId>): DatasetHandle<TDataset, TProjectId>;
 /**
  * Logging infrastructure for the Sanity SDK
  *
@@ -964,9 +877,9 @@ interface LogContext {
 interface InstanceContext {
   /** Unique instance ID */
   instanceId?: string;
-  /** Project ID (derived from default resource) */
+  /** Project ID */
   projectId?: string;
-  /** Dataset name (derived from default resource) */
+  /** Dataset name */
   dataset?: string;
 }
 /**
@@ -1092,17 +1005,9 @@ interface Logger {
  */
 declare function configureLogging(config: LoggerConfig): void;
 /** @public */
-declare const getDatasetsState: BoundStoreAction<FetcherStoreState<[options: {
-  projectId: string;
-}], _sanity_client12.DatasetsResponse>, [options: {
-  projectId: string;
-}], StateSource<_sanity_client12.DatasetsResponse | undefined>>;
+declare const getDatasetsState: BoundStoreAction<import("../_exports").FetcherStoreState<[options?: ProjectHandle<string> | undefined], import("@sanity/client").DatasetsResponse>, [options?: ProjectHandle<string> | undefined], import("../_exports").StateSource<import("@sanity/client").DatasetsResponse | undefined>>;
 /** @public */
-declare const resolveDatasets: BoundStoreAction<FetcherStoreState<[options: {
-  projectId: string;
-}], _sanity_client12.DatasetsResponse>, [options: {
-  projectId: string;
-}], Promise<_sanity_client12.DatasetsResponse>>;
+declare const resolveDatasets: BoundStoreAction<import("../_exports").FetcherStoreState<[options?: ProjectHandle<string> | undefined], import("@sanity/client").DatasetsResponse>, [options?: ProjectHandle<string> | undefined], Promise<import("@sanity/client").DatasetsResponse>>;
 /**
  * Represents an action to create a new document.
  * Specifies the document type and optionally a document ID (which will be treated as the published ID).
@@ -1115,7 +1020,7 @@ interface CreateDocumentAction<TDocumentType extends string = string, TDataset e
    * These values will be set when the document is created.
    * System fields (_id, _type, _rev, _createdAt, _updatedAt) are omitted as they are set automatically.
    */
-  initialValue?: Partial<Omit<SanityDocument$2, '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'>>;
+  initialValue?: Partial<Omit<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>, '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'>>;
 }
 /**
  * Represents an action to delete an existing document.
@@ -1133,6 +1038,21 @@ interface DeleteDocumentAction<TDocumentType extends string = string, TDataset e
 interface EditDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
   type: 'document.edit';
   patches?: PatchOperations[];
+  /**
+   * When `true`, the given `patches` are forwarded verbatim to the server and
+   * applied as-is locally, instead of being re-derived by diffing document
+   * snapshots. This preserves the operational intent of the patches (e.g.
+   * keyed array inserts/unsets), which lets concurrent edits from other
+   * clients interleave coherently instead of being overwritten by
+   * position-based patches computed from a stale snapshot.
+   *
+   * Use this when the patches were produced by an editor that tracks its own
+   * operations (e.g. a collaborative text editor). During a rebase onto a
+   * changed remote document, preserved patches are re-applied operationally;
+   * if a patch can no longer apply, the transaction is skipped and reported
+   * as a `rebase-error` document event.
+   */
+  preserveOperations?: boolean;
 }
 /**
  * Represents an action to publish the draft version of a document.
@@ -1163,6 +1083,12 @@ interface DiscardDocumentAction<TDocumentType extends string = string, TDataset
  * @beta
  */
 type DocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> = CreateDocumentAction<TDocumentType, TDataset, TProjectId> | DeleteDocumentAction<TDocumentType, TDataset, TProjectId> | EditDocumentAction<TDocumentType, TDataset, TProjectId> | PublishDocumentAction<TDocumentType, TDataset, TProjectId> | UnpublishDocumentAction<TDocumentType, TDataset, TProjectId> | DiscardDocumentAction<TDocumentType, TDataset, TProjectId>;
+/**
+ * Union of every action accepted by `applyDocumentActions` — both document-
+ * level actions and release-lifecycle actions.
+ * @beta
+ */
+type Action<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> = DocumentAction<TDocumentType, TDataset, TProjectId> | ReleaseAction;
 /**
  * Creates a `CreateDocumentAction` object.
  * @param doc - A handle identifying the document type, dataset, and project. An optional `documentId` can be provided.
@@ -1170,33 +1096,46 @@ type DocumentAction<TDocumentType extends string = string, TDataset extends stri
  * @returns A `CreateDocumentAction` object ready for dispatch.
  * @beta
  */
-declare function createDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>, initialValue?: Partial<Omit<SanityDocument$2, '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'>>): CreateDocumentAction<TDocumentType, TDataset, TProjectId>;
+declare function createDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>, initialValue?: Partial<Omit<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>, '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'>>): CreateDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
  * Creates a `DeleteDocumentAction` object.
  * @param doc - A handle uniquely identifying the document to be deleted.
  * @returns A `DeleteDocumentAction` object ready for dispatch.
  * @beta
  */
-declare function deleteDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): DeleteDocumentAction<TDocumentType, TDataset, TProjectId>;
+declare function deleteDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): DeleteDocumentAction<TDocumentType, TDataset, TProjectId>;
+/**
+ * Options for creating an `EditDocumentAction`.
+ * @beta
+ */
+interface EditDocumentOptions {
+  /**
+   * Forward the given patches verbatim instead of re-deriving them by
+   * diffing document snapshots. See {@link EditDocumentAction.preserveOperations}.
+   */
+  preserveOperations?: boolean;
+}
 /**
  * Creates an `EditDocumentAction` object with patches for modifying a document.
  * Accepts patches in either the standard `PatchOperations` format or as a `SanityMutatePatchMutation` from `@sanity/mutate`.
  *
  * @param doc - A handle uniquely identifying the document to be edited.
  * @param sanityMutatePatch - A patch mutation object from `@sanity/mutate`.
+ * @param options - Options controlling how the patches are processed.
  * @returns An `EditDocumentAction` object ready for dispatch.
  * @beta
  */
-declare function editDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>, sanityMutatePatch: PatchMutation): EditDocumentAction<TDocumentType, TDataset, TProjectId>;
+declare function editDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>, sanityMutatePatch: PatchMutation, options?: EditDocumentOptions): EditDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
  * Creates an `EditDocumentAction` object with patches for modifying a document.
  *
  * @param doc - A handle uniquely identifying the document to be edited.
  * @param patches - A single patch operation or an array of patch operations.
+ * @param options - Options controlling how the patches are processed.
  * @returns An `EditDocumentAction` object ready for dispatch.
  * @beta
  */
-declare function editDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>, patches?: PatchOperations | PatchOperations[]): EditDocumentAction<TDocumentType, TDataset, TProjectId>;
+declare function editDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>, patches?: PatchOperations | PatchOperations[], options?: EditDocumentOptions): EditDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
  * Creates a `PublishDocumentAction` object.
  * @param doc - A handle uniquely identifying the document to be published.
@@ -1218,141 +1157,272 @@ declare function unpublishDocument<TDocumentType extends string = string, TDatas
  * @beta
  */
 declare function discardDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): DiscardDocumentAction<TDocumentType, TDataset, TProjectId>;
+/**
+ * Creates a new release. The `releaseId` must be unique within the current
+ * retention period.
+ * @beta
+ */
+interface CreateReleaseAction extends ReleaseHandle {
+  type: 'release.create';
+  metadata: ReleaseDocument$1['metadata'];
+}
+/**
+ * Patches the metadata of an existing release.
+ * @beta
+ */
+interface EditReleaseAction extends ReleaseHandle {
+  type: 'release.edit';
+  patch: PatchOperations;
+}
+/**
+ * Publishes all version documents in a release.
+ * @beta
+ */
+interface PublishReleaseAction extends ReleaseHandle {
+  type: 'release.publish';
+}
+/**
+ * Schedules a release to be published at the given UTC time. Locks the
+ * version documents server-side until the release is unscheduled or published.
+ * @beta
+ */
+interface ScheduleReleaseAction extends ReleaseHandle {
+  type: 'release.schedule';
+  publishAt: string;
+}
+/**
+ * Unschedules a release that was previously scheduled, returning it to the
+ * active editable state.
+ * @beta
+ */
+interface UnscheduleReleaseAction extends ReleaseHandle {
+  type: 'release.unschedule';
+}
+/**
+ * Archives an active release. Version documents within the release are
+ * removed and no longer queryable, though still recoverable through history
+ * during the retention period.
+ * @beta
+ */
+interface ArchiveReleaseAction extends ReleaseHandle {
+  type: 'release.archive';
+}
+/**
+ * Restores an archived release. Only possible during the retention period.
+ * @beta
+ */
+interface UnarchiveReleaseAction extends ReleaseHandle {
+  type: 'release.unarchive';
+}
+/**
+ * Permanently deletes an archived or published release. To remove an active
+ * release, use the archive action first.
+ * @beta
+ */
+interface DeleteReleaseAction extends ReleaseHandle {
+  type: 'release.delete';
+}
+/**
+ * Union of all release actions that can be dispatched alongside document
+ * actions through `applyDocumentActions`.
+ * @beta
+ */
+type ReleaseAction = CreateReleaseAction | EditReleaseAction | PublishReleaseAction | ScheduleReleaseAction | UnscheduleReleaseAction | ArchiveReleaseAction | UnarchiveReleaseAction | DeleteReleaseAction;
+/** @beta */
+declare function createRelease(handle: ReleaseHandle, metadata?: ReleaseDocument$1['metadata']): CreateReleaseAction;
+/** @beta */
+declare function editRelease(handle: ReleaseHandle, patch: PatchOperations): EditReleaseAction;
+/** @beta */
+declare function publishRelease(handle: ReleaseHandle): PublishReleaseAction;
+/** @beta */
+declare function scheduleRelease(handle: ReleaseHandle, publishAt: string): ScheduleReleaseAction;
+/** @beta */
+declare function unscheduleRelease(handle: ReleaseHandle): UnscheduleReleaseAction;
+/** @beta */
+declare function archiveRelease(handle: ReleaseHandle): ArchiveReleaseAction;
+/** @beta */
+declare function unarchiveRelease(handle: ReleaseHandle): UnarchiveReleaseAction;
+/** @beta */
+declare function deleteRelease(handle: ReleaseHandle): DeleteReleaseAction;
+/**
+ * Split the entire path string on dots "outside" of any brackets.
+ *
+ * For example:
+ * ```
+ * "friends[0].name"
+ * ```
+ *
+ * becomes:
+ *
+ * ```
+ * [...ParseSegment<"friends[0]">, ...ParseSegment<"name">]
+ * ```
+ *
+ * (We use a simple recursion that splits on the first dot.)
+ */
+type PathParts<TPath extends string> = TPath extends `${infer Head}.${infer Tail}` ? [Head, ...PathParts<Tail>] : TPath extends '' ? [] : [TPath];
+/**
+ * Given a type T and an array of "access keys" Parts, recursively index into T.
+ *
+ * If a part is a key, it looks up that property.
+ * If T is an array and the part is a number, it "indexes" into the element type.
+ */
+type DeepGet<TValue, TPath extends readonly (string | number)[]> = TPath extends [] ? TValue : TPath extends readonly [infer THead, ...infer TTail] ? DeepGet<TValue extends undefined | null ? undefined : THead extends keyof TValue ? TValue[THead] : THead extends number ? TValue extends readonly (infer TElement)[] ? TElement | undefined : undefined : undefined // Key/index doesn't exist
+, TTail extends readonly (string | number)[] ? TTail : []> : never;
+/**
+ * Given a document type TDocument and a JSON Match path string TPath,
+ * compute the type found at that path.
+ * @beta
+ */
+type JsonMatch<TDocument, TPath extends string> = DeepGet<TDocument, PathParts<TPath>>;
 /**
  * Represents a set of document that will go into `applyMutations`. Before
  * applying a mutation, it's expected that all relevant documents that the
  * mutations affect are included, including those that do not exist yet.
  * Documents that don't exist have a `null` value.
  */
-type DocumentSet<TDocument extends SanityDocument$2 = SanityDocument$2> = { [TDocumentId in string]?: TDocument | null };
+type DocumentSet<TDocument extends SanityDocument$2 = SanityDocument$2> = { [TDocumentId in string]?: TDocument | null; };
+type Grant = 'read' | 'update' | 'create' | 'history';
 /** @beta */
-interface ActionsResult<TDocument extends SanityDocument$2 = SanityDocument$2> {
-  transactionId: string;
-  documents: DocumentSet<TDocument>;
-  previous: DocumentSet<TDocument>;
-  previousRevs: {
-    [documentId: string]: string | undefined;
-  };
-  appeared: string[];
-  updated: string[];
-  disappeared: string[];
-  submitted: () => ReturnType<SanityClient['action']>;
+interface PermissionDeniedReason {
+  type: 'precondition' | 'access';
+  message: string;
+  documentId?: string;
 }
 /** @beta */
-interface ApplyDocumentActionsOptions {
+type DocumentPermissionsResult = {
+  allowed: false;
+  message: string;
+  reasons: PermissionDeniedReason[];
+} | {
+  allowed: true;
+  message?: undefined;
+  reasons?: undefined;
+};
+interface SharedListener {
+  events: Observable<ListenEvent<SanityDocument$1>>;
+  dispose: () => void;
+}
+interface DocumentStoreState {
+  documentStates: { [TDocumentId in string]?: DocumentState; };
+  queued: QueuedTransaction[];
+  applied: AppliedTransaction[];
+  outgoing?: OutgoingTransaction;
+  grants?: Record<Grant, ExprNode>;
   /**
-   * List of actions to apply.
+   * The current user's identity (their user ID).
    */
-  actions: DocumentAction[];
+  identity?: string;
+  error?: unknown;
+  sharedListener: SharedListener;
+  fetchDocument: (documentId: string) => Observable<SanityDocument$3 | null>;
+  events: Subject<DocumentEvent>;
+}
+interface DocumentState {
+  id: string;
   /**
-   * The resource to which the documents being acted on belong.
+   * the "remote" local copy that matches the server. represents the last known
+   * server state. this gets updated every time we confirm remote patches
    */
-  resource: DocumentResource;
+  remote?: SanityDocument$3 | null;
   /**
-   * Optionally provide an ID to be used as this transaction ID
+   * the current ephemeral working copy that includes local optimistic changes
+   * that have not yet been confirmed by the server
    */
-  transactionId?: string;
+  local?: SanityDocument$3 | null;
   /**
-   * Set this to true to prevent this action from being batched with others.
+   * the revision that our remote document is at
    */
-  disableBatching?: boolean;
-}
-/** @beta */
-declare function applyDocumentActions(instance: SanityInstance, options: ApplyDocumentActionsOptions): Promise<ActionsResult>;
-/**
- * Represents a reactive state source that provides synchronized access to store data
- *
- * @remarks
- * Designed to work with React's useSyncExternalStore hook. Provides three ways to access data:
- * 1. `getCurrent()` for synchronous current value access
- * 2. `subscribe()` for imperative change notifications
- * 3. `observable` for reactive stream access
- *
- * @public
- */
-interface StateSource<T> {
+  remoteRev?: string | null;
   /**
-   * Subscribes to state changes with optional callback
-   * @param onStoreChanged - Called whenever relevant state changes occur
-   * @returns Unsubscribe function to clean up the subscription
+   * Array of subscription IDs. This document state will be deleted if there are
+   * no subscribers.
    */
-  subscribe: (onStoreChanged?: () => void) => () => void;
+  subscriptions: string[];
   /**
-   * Gets the current derived state value
-   *
-   * @remarks
-   * Safe to call without subscription. Will always return the latest value
-   * based on the current store state and selector parameters.
+   * An object keyed by transaction ID of revisions sent out but that have not
+   * yet been verified yet. When an applied transaction is transitioned to an
+   * outgoing transaction, it also adds unverified revisions for each document
+   * that is part of that outgoing transaction. Transactions are submitted to
+   * the server with a locally generated transaction ID. This way we can observe
+   * when our transaction comes back through the shared listener. Each listener
+   * event that comes back contains a `previousRev`. If we see our own
+   * transaction with a different `previousRev` than expected, we can rebase our
+   * local transactions on top of this new remote.
    */
-  getCurrent: () => T;
+  unverifiedRevisions?: { [TTransactionId in string]?: UnverifiedDocumentRevision; };
   /**
-   * Observable stream of state values
-   *
-   * @remarks
-   * Shares a single underlying subscription between all observers. Emits:
-   * - Immediately with current value on subscription
-   * - On every relevant state change
-   * - Errors if selector throws
+   * transaction IDs recently submitted by this client for this document,
+   * newest last. used to label `remote-patches` events with the correct
+   * `origin` even after the corresponding `unverifiedRevisions` entry has
+   * been pruned (e.g. by a sync event that raced the listener echo). capped
+   * to the most recent entries.
    */
-  observable: Observable<T>;
+  recentOwnTransactionIds?: string[];
 }
 /**
- * Context passed to selectors when deriving state
- *
- * @remarks
- * Provides access to both the current state value and the Sanity instance,
- * allowing selectors to use configuration values when computing derived state.
- * The context is memoized for each state object and instance combination
- * to optimize performance and prevent unnecessary recalculations.
- *
- * @example
- * ```ts
- * // Using both state and instance in a selector (psuedo example)
- * const getUserByProjectId = createStateSourceAction(
- *   ({ state, instance }: SelectorContext<UsersState>, options?: ResourceHandle) => {
- *     const allUsers = state.users
- *     const projectId = options?.projectId ?? instance.config.defaultResource?.projectId
- *     return allUsers.filter(user => user.projectId === projectId)
- *   }
- * )
- * ```
+ * @beta
+ * Options for specifying a document and optionally a path within it.
  */
-interface SelectorContext<TState> {
-  /**
-   * The current state object from the store
-   */
-  state: TState;
-  /**
-   * The Sanity instance associated with this state
-   */
-  instance: SanityInstance;
+interface DocumentOptions<TPath extends string | undefined = undefined, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  path?: TPath;
 }
-/**
- * Function type for selecting derived state from store state and parameters
- * @public
- */
-type Selector<TState, TParams extends unknown[], TReturn> = (context: SelectorContext<TState>, ...params: TParams) => TReturn;
+/** @beta */
+declare function getDocumentState<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: DocumentOptions<undefined, TDocumentType, TDataset, TProjectId>): StateSource<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`> | undefined | null>;
+/** @beta */
+declare function getDocumentState<TPath extends string = string, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: DocumentOptions<TPath, TDocumentType, TDataset, TProjectId>): StateSource<JsonMatch<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>, TPath> | undefined>;
+/** @beta */
+declare function getDocumentState<TData>(instance: SanityInstance, options: DocumentOptions<string | undefined>): StateSource<TData | undefined | null>;
+/** @beta */
+declare function resolveDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, docHandle: DocumentHandle<TDocumentType, TDataset, TProjectId>): Promise<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`> | null>;
+/** @beta */
+declare function resolveDocument<TData extends SanityDocument$3>(instance: SanityInstance, docHandle: DocumentHandle<string, string, string>): Promise<TData | null>;
+/** @beta */
+declare const getDocumentSyncStatus: BoundStoreAction<DocumentStoreState, [doc: DocumentHandle<string, string, string>], StateSource<boolean | undefined>>;
+type PermissionsStateOptions = {
+  resource?: DocumentResource;
+  actions: DocumentAction[];
+};
+/** @beta */
+declare const getPermissionsState: BoundStoreAction<DocumentStoreState, [PermissionsStateOptions], StateSource<DocumentPermissionsResult>>;
+/** @beta */
+declare const resolvePermissions: BoundStoreAction<DocumentStoreState, [options: PermissionsStateOptions], Promise<DocumentPermissionsResult>>;
+/** @beta */
+declare const subscribeDocumentEvents: BoundStoreAction<DocumentStoreState, [options: {
+  resource?: DocumentResource;
+  eventHandler: (e: DocumentEvent) => void;
+}], () => void>;
 type ActionMap = {
   create: 'sanity.action.document.version.create';
-  createLiveEdit: 'sanity.action.document.create';
   discard: 'sanity.action.document.version.discard';
   unpublish: 'sanity.action.document.unpublish';
   delete: 'sanity.action.document.delete';
   edit: 'sanity.action.document.edit';
   publish: 'sanity.action.document.publish';
+  releaseCreate: 'sanity.action.release.create';
+  releaseEdit: 'sanity.action.release.edit';
+  releasePublish: 'sanity.action.release.publish';
+  releaseSchedule: 'sanity.action.release.schedule';
+  releaseUnschedule: 'sanity.action.release.unschedule';
+  releaseArchive: 'sanity.action.release.archive';
+  releaseUnarchive: 'sanity.action.release.unarchive';
+  releaseDelete: 'sanity.action.release.delete';
 };
 type OptimisticLock = {
   ifDraftRevisionId?: string;
   ifPublishedRevisionId?: string;
 };
+interface ReleaseMetadataPayload {
+  title?: string;
+  description?: string;
+  intendedPublishAt?: string;
+  releaseType?: 'asap' | 'scheduled' | 'undecided';
+  cardinality?: 'one' | 'many';
+}
 type HttpAction = {
   actionType: ActionMap['create'];
   publishedId: string;
   attributes: SanityDocumentLike;
-} | {
-  actionType: ActionMap['createLiveEdit'];
-  publishedId: string;
-  attributes: SanityDocumentLike;
 } | {
   actionType: ActionMap['discard'];
   versionId: string;
@@ -1374,7 +1444,34 @@ type HttpAction = {
   actionType: ActionMap['publish'];
   draftId: string;
   publishedId: string;
-} & OptimisticLock);
+} & OptimisticLock) | {
+  actionType: ActionMap['releaseCreate'];
+  releaseId: string;
+  metadata?: ReleaseMetadataPayload;
+} | {
+  actionType: ActionMap['releaseEdit'];
+  releaseId: string;
+  patch: PatchOperations;
+} | {
+  actionType: ActionMap['releasePublish'];
+  releaseId: string;
+} | {
+  actionType: ActionMap['releaseSchedule'];
+  releaseId: string;
+  publishAt: string;
+} | {
+  actionType: ActionMap['releaseUnschedule'];
+  releaseId: string;
+} | {
+  actionType: ActionMap['releaseArchive'];
+  releaseId: string;
+} | {
+  actionType: ActionMap['releaseUnarchive'];
+  releaseId: string;
+} | {
+  actionType: ActionMap['releaseDelete'];
+  releaseId: string;
+};
 /**
  * Represents a transaction that is queued to be applied but has not yet been
  * applied. A transaction will remain in a queued state until all required
@@ -1390,7 +1487,7 @@ interface QueuedTransaction {
    * actions don't mention draft IDs and is meant to abstract away the draft
    * model from users.
    */
-  actions: DocumentAction[];
+  actions: Action[];
   /**
    * An optional flag set to disable this transaction from being batched with
    * other transactions.
@@ -1429,7 +1526,7 @@ interface AppliedTransaction extends QueuedTransaction {
   /**
    * the `_rev`s from `previous` document set
    */
-  previousRevs: { [TDocumentId in string]?: string };
+  previousRevs: { [TDocumentId in string]?: string; };
   /**
    * a timestamp for when this transaction was applied locally
    */
@@ -1441,9 +1538,9 @@ interface AppliedTransaction extends QueuedTransaction {
    */
   outgoingActions: HttpAction[];
   /**
-   * similar to `outgoingActions` but comprised of mutations instead of action.
-   * this left here for debugging purposes but could be used to send mutations
-   * to Content Lake instead of actions.
+   * similar to `outgoingActions` but comprised of mutations instead of actions.
+   * Useful for debugging, and is also used by liveEdit documents to send mutations,
+   * since they can't use the Actions API which is pretty dependent on the draft model.
    */
   outgoingMutations: Mutation[];
 }
@@ -1463,8 +1560,10 @@ interface UnverifiedDocumentRevision {
   previousRev: string | undefined;
   timestamp: string;
 }
+/** @beta Response body from submitting an outgoing transaction (actions or mutations API). */
+type DocumentTransactionSubmissionResult = Awaited<ReturnType<SanityClient['action']>> | MultipleMutationResult;
 /** @beta */
-type DocumentEvent = ActionErrorEvent | TransactionRevertedEvent | TransactionAcceptedEvent | DocumentRebaseErrorEvent | DocumentEditedEvent | DocumentCreatedEvent | DocumentDeletedEvent | DocumentPublishedEvent | DocumentUnpublishedEvent | DocumentDiscardedEvent;
+type DocumentEvent = ActionErrorEvent | TransactionRevertedEvent | TransactionAcceptedEvent | DocumentRebaseErrorEvent | DocumentEditedEvent | DocumentCreatedEvent | DocumentDeletedEvent | DocumentPublishedEvent | DocumentUnpublishedEvent | DocumentDiscardedEvent | DocumentRemotePatchesEvent;
 /**
  * @beta
  * Event emitted when a precondition to applying an action fails.
@@ -1484,7 +1583,7 @@ interface ActionErrorEvent {
 interface TransactionAcceptedEvent {
   type: 'accepted';
   outgoing: OutgoingTransaction;
-  result: Awaited<ReturnType<SanityClient['action']>>;
+  result: DocumentTransactionSubmissionResult;
 }
 /**
  * @beta
@@ -1561,100 +1660,78 @@ interface DocumentDiscardedEvent {
   documentId: string;
   outgoing: OutgoingTransaction;
 }
-type Grant = 'read' | 'update' | 'create' | 'history';
-/** @beta */
-interface PermissionDeniedReason {
-  type: 'precondition' | 'access';
-  message: string;
-  documentId?: string;
+/**
+ * @beta
+ * Event emitted when patches for a document are observed through the listener.
+ *
+ * Unlike the whole-document snapshots the store keeps, these are the raw patch
+ * operations from the transaction that produced the change, preserving the
+ * operational intent of the edit (e.g. keyed array inserts/unsets). Consumers
+ * that maintain their own local state, like collaborative text editors, can
+ * apply these directly instead of diffing document snapshots.
+ *
+ * `origin` is `'local'` when the transaction was submitted by this document
+ * store instance (an own edit observed back through the listener) and
+ * `'remote'` when it came from another client.
+ */
+interface DocumentRemotePatchesEvent {
+  type: 'remote-patches';
+  /** The ID of the document version the patches apply to (e.g. a draft ID). */
+  documentId: string;
+  /** The transaction ID that carried these patches. */
+  transactionId: string;
+  /** The revision the document was at before this transaction. */
+  previousRev?: string;
+  /** The timestamp of the transaction. */
+  timestamp: string;
+  /** The patch operations, rooted at the document. */
+  patches: PatchOperations[];
+  /** Whether the transaction originated from this client or another one. */
+  origin: 'local' | 'remote';
 }
 /** @beta */
-type DocumentPermissionsResult = {
-  allowed: false;
-  message: string;
-  reasons: PermissionDeniedReason[];
-} | {
-  allowed: true;
-  message?: undefined;
-  reasons?: undefined;
-};
-interface SharedListener {
-  events: Observable<ListenEvent<SanityDocument$1>>;
-  dispose: () => void;
-}
-interface DocumentStoreState {
-  documentStates: { [TDocumentId in string]?: DocumentState };
-  queued: QueuedTransaction[];
-  applied: AppliedTransaction[];
-  outgoing?: OutgoingTransaction;
-  grants?: Record<Grant, ExprNode>;
-  error?: unknown;
-  sharedListener: SharedListener;
-  fetchDocument: (documentId: string) => Observable<SanityDocument$2 | null>;
-  events: Subject<DocumentEvent>;
+interface ActionsResult<TDocument extends SanityDocument$3 = SanityDocument$3> {
+  transactionId: string;
+  documents: DocumentSet<TDocument>;
+  previous: DocumentSet<TDocument>;
+  previousRevs: {
+    [documentId: string]: string | undefined;
+  };
+  appeared: string[];
+  updated: string[];
+  disappeared: string[];
+  submitted: () => Promise<DocumentTransactionSubmissionResult>;
 }
-interface DocumentState {
-  id: string;
-  /**
-   * 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$2 | null;
+/** @beta */
+interface ApplyDocumentActionsOptions {
   /**
-   * the current ephemeral working copy that includes local optimistic changes
-   * that have not yet been confirmed by the server
+   * List of actions to apply. Accepts both document actions and release
+   * lifecycle actions because they share the same transaction pipeline.
    */
-  local?: SanityDocument$2 | null;
+  actions: Action[];
   /**
-   * the revision that our remote document is at
+   * The resource to which the documents being acted on belong.
    */
-  remoteRev?: string | null;
-  /**
-   * Array of subscription IDs. This document state will be deleted if there are
-   * no subscribers.
+  resource?: DocumentResource;
+  /**
+   * Optionally provide an ID to be used as this transaction ID
    */
-  subscriptions: string[];
+  transactionId?: string;
   /**
-   * An object keyed by transaction ID of revisions sent out but that have not
-   * yet been verified yet. When an applied transaction is transitioned to an
-   * outgoing transaction, it also adds unverified revisions for each document
-   * that is part of that outgoing transaction. Transactions are submitted to
-   * the server with a locally generated transaction ID. This way we can observe
-   * when our transaction comes back through the shared listener. Each listener
-   * event that comes back contains a `previousRev`. If we see our own
-   * transaction with a different `previousRev` than expected, we can rebase our
-   * local transactions on top of this new remote.
+   * Set this to true to prevent this action from being batched with others.
    */
-  unverifiedRevisions?: { [TTransactionId in string]?: UnverifiedDocumentRevision };
+  disableBatching?: boolean;
 }
+/** @beta */
+declare function applyDocumentActions<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: ApplyDocumentActionsOptions): Promise<ActionsResult<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>>>;
+/** @beta */
+declare function applyDocumentActions(instance: SanityInstance, options: ApplyDocumentActionsOptions): Promise<ActionsResult>;
 /**
+ * Returns the full release document ID for the given release name.
+ * e.g. `getReleaseDocumentId('my-release') === '_.releases.my-release'`
  * @beta
- * Options for specifying a document and optionally a path within it.
  */
-interface DocumentOptions<TPath extends string | undefined = undefined, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  path?: TPath;
-}
-/** @beta */
-declare function getDocumentState<TData>(instance: SanityInstance, options: DocumentOptions<string | undefined>): StateSource<TData | undefined | null>;
-/** @beta */
-declare function resolveDocument<TData extends SanityDocument$2>(instance: SanityInstance, docHandle: DocumentHandle): Promise<TData | null>;
-/** @beta */
-declare function resolveDocument(instance: SanityInstance, docHandle: DocumentHandle): Promise<SanityDocument$2 | null>;
-/** @beta */
-declare const getDocumentSyncStatus: BoundStoreAction<DocumentStoreState, [doc: DocumentHandle<string, string, string>], StateSource<boolean | undefined>>;
-type PermissionsStateOptions = {
-  resource: DocumentResource;
-  actions: DocumentAction[];
-};
-/** @beta */
-declare const getPermissionsState: BoundStoreAction<DocumentStoreState, [PermissionsStateOptions], StateSource<DocumentPermissionsResult>>;
-/** @beta */
-declare const resolvePermissions: BoundStoreAction<DocumentStoreState, [options: PermissionsStateOptions], Promise<DocumentPermissionsResult>>;
-/** @beta */
-declare const subscribeDocumentEvents: BoundStoreAction<DocumentStoreState, [options: {
-  resource: DocumentResource;
-  eventHandler: (e: DocumentEvent) => void;
-}], () => void>;
+declare function getReleaseDocumentId(releaseId: string): string;
 /**
  * @public
  */
@@ -1676,7 +1753,7 @@ interface FavoriteDocumentContext extends DocumentHandle {
  * @returns A StateSource emitting `{ isFavorited: boolean }`.
  * @public
  */
-declare const getFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], StateSource<FavoriteStatusResponse | undefined>>;
+declare const getFavoritesState: BoundStoreAction<import("../_exports").FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], import("../_exports").StateSource<FavoriteStatusResponse | undefined>>;
 /**
  * Resolves the favorite status for a document.
  * @param instance - The Sanity instance.
@@ -1684,100 +1761,238 @@ declare const getFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDoc
  * @returns A Promise resolving to `{ isFavorited: boolean }`.
  * @public
  */
-declare const resolveFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], Promise<FavoriteStatusResponse>>;
+declare const resolveFavoritesState: BoundStoreAction<import("../_exports").FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], Promise<FavoriteStatusResponse>>;
 /**
+ * Related data the Installations API can embed in a response. Each token adds
+ * a top-level field to the {@link Installation} item.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-interface SanityUser {
-  sanityUserId: string;
-  profile: UserProfile;
-  memberships: Membership[];
-}
+type InstallationInclude = 'activeConfig' | 'access' | 'interfaces';
 /**
+ * A resource an installation accesses, embedded when `access` is included.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-interface Membership {
-  addedAt?: string;
-  resourceType: string;
+interface InstallationAccess {
+  id: string;
+  resourceType: 'datasets' | 'canvases' | 'dashboards' | 'media-libraries';
   resourceId: string;
-  roleNames: Array<string>;
-  lastSeenAt?: string | null;
 }
 /**
+ * An interface exposed by an installation, embedded when `interfaces` is
+ * included.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-interface UserProfile {
+interface InstallationInterface {
   id: string;
-  displayName: string;
-  email: string;
-  familyName?: string;
-  givenName?: string;
-  middleName?: string | null;
-  imageUrl?: string;
-  provider: string;
-  tosAcceptedAt?: string;
+  type: 'app' | 'worker' | 'asset_source' | 'panel';
+  name: string;
+  title: string;
+  version: string;
+  /** Module federation module ID; resolved from the host mf-manifest at runtime */
+  moduleId: string;
+  metadata: {
+    group?: string;
+    priority?: number;
+  } | null;
+}
+/**
+ * The active config of an installation, embedded when `activeConfig` is
+ * included. `null` when nothing is deployed.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @public
+ */
+interface InstallationActiveConfig {
+  id: string;
+  installationId: string;
+  deployedBy: string | null;
+  version: string;
+  isActive: boolean;
   createdAt: string;
-  updatedAt?: string;
-  isCurrentUser?: boolean;
-  providerId?: string;
 }
 /**
+ * The always-present fields of an active singleton installation returned by the
+ * Installations API (`/installations`), before any {@link InstallationInclude}.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-interface GetUsersOptions {
-  projectId?: string;
-  resourceType?: 'organization' | 'project';
-  batchSize?: number;
-  organizationId?: string;
-  userId?: string;
+interface InstallationBase {
+  id: string;
+  applicationId: string;
+  organizationId: string;
+  installedBy: string | null;
+  createdAt: string;
+  updatedAt: string;
+  application: {
+    title: string;
+    slug: string | null;
+  };
 }
 /**
+ * An active singleton installation as returned by the Installations API
+ * (`/installations`). `activeConfig`, `access` and `interfaces` are top-level
+ * fields, each present only when the matching {@link InstallationInclude} token
+ * was requested.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-interface UsersGroupState {
-  subscriptions: string[];
-  totalCount?: number;
-  nextCursor?: string | null;
-  lastLoadMoreRequest?: string;
-  users?: SanityUser[];
-  error?: unknown;
+type Installation<Include extends InstallationInclude = never> = InstallationBase & Included<InstallationInclude, 'activeConfig', Include, {
+  activeConfig: InstallationActiveConfig | null;
+}> & Included<InstallationInclude, 'access', Include, {
+  access: InstallationAccess[];
+}> & Included<InstallationInclude, 'interfaces', Include, {
+  interfaces: InstallationInterface[];
+}>;
+/**
+ * Options for listing an organization's installations.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @public
+ */
+interface InstallationsOptions<Include extends InstallationInclude = InstallationInclude> {
+  organizationId: string;
+  include?: Include[];
+  /** Page size (1-100, default 50), or `'none'` to disable pagination */
+  limit?: number | 'none';
+  /** Cursor from a previous response's `nextCursor` */
+  cursor?: string;
 }
 /**
+ * The cursor-paginated envelope returned by `GET /installations`.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
  * @public
  */
-interface SanityUserResponse {
-  data: SanityUser[];
-  totalCount: number;
+interface InstallationsResponse<Include extends InstallationInclude = never> {
   nextCursor: string | null;
+  data: Installation<Include>[];
 }
 /**
- * @public
+ * Fetcher for an organization's installations (`GET /installations`), on the
+ * shared fetcher cache.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
  */
-interface UsersStoreState {
-  users: { [TUsersKey in string]?: UsersGroupState };
-  error?: unknown;
+declare const installations: Fetcher<[options: InstallationsOptions<InstallationInclude>], InstallationsResponse<InstallationInclude>>;
+/**
+ * Fetcher for a single installation (`GET /installations/:id`), on the shared
+ * fetcher cache. No pre-seeding from {@link installations}: its list keys
+ * include the organization, which this fetcher's params can't reconstruct.
+ *
+ * @see https://www.sanity.io/docs/http-reference/applications-api
+ * @internal
+ */
+declare const installation: Fetcher<[installationId: string, options?: {
+  include?: InstallationInclude[];
+} | undefined], Installation<InstallationInclude>>;
+/** @public */
+interface OrganizationMember {
+  sanityUserId: string;
+  isCurrentUser: boolean;
+  user: {
+    id: string;
+    displayName: string;
+    familyName: string;
+    givenName: string;
+    middleName: string | null;
+    imageUrl: string | null;
+    email: string;
+    loginProvider: string;
+  };
+  roles: Array<{
+    name: string;
+    title: string;
+    description?: string;
+  }>;
 }
 /**
+ * The base fields returned from `/organizations/<id>` for every organization.
  * @public
  */
-interface ResolveUsersOptions extends GetUsersOptions {
-  signal?: AbortSignal;
+interface OrganizationBase {
+  id: string;
+  name: string;
+  slug: string | null;
+  createdAt: string;
+  createdByUserId: string;
+  updatedAt: string;
+  deletedAt: string | null;
+  dashboardStatus: 'enabled' | 'disabled';
+  aiFeaturesStatus: 'enabled' | 'disabled';
+  mediaLibraryStatus: 'enabled' | 'disabled';
+  requestAccessStatus: 'allowed' | 'disabled';
+  telemetryConsentStatus: 'allowed' | 'msa_denied' | 'customer_denied';
+  oauthAppsStatus: 'allowed' | 'blocked';
+  defaultRoleName: string;
+  domains: string[] | null;
+}
+/** @public */
+interface OrganizationOptions<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false> {
+  includeMembers?: IncludeMembers;
+  includeFeatures?: IncludeFeatures;
+  organizationId: string;
 }
 /**
+ * An `Organization` with `members` and/or `features` conditionally included
+ * based on the query options used to fetch it.
  * @public
  */
-interface GetUserOptions {
-  projectId?: string;
-  userId: string;
-  resourceType?: 'organization' | 'project';
-  organizationId?: string;
-}
+type Organization<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false> = OrganizationBase & (boolean extends IncludeMembers ? {
+  members?: OrganizationMember[];
+} : IncludeMembers extends true ? {
+  members: OrganizationMember[];
+} : unknown) & (boolean extends IncludeFeatures ? {
+  features?: string[];
+} : IncludeFeatures extends true ? {
+  features: string[];
+} : unknown);
+/**
+ * Fetcher for a single organization (`GET /organizations/:id`), on the shared
+ * fetcher cache. No pre-seeding from the organizations list: it returns a
+ * subset of the detail fields, and a partial seed would serve as fresh for
+ * the whole stale window.
+ *
+ * @internal
+ */
+declare const organization: Fetcher<[options?: OrganizationOptions<boolean, boolean> | undefined], Organization<boolean, boolean>>;
 /**
+ * The list shape returned from `/organizations`, with `members` and/or
+ * `features` conditionally included based on the query options used.
  * @public
  */
-interface ResolveUserOptions extends GetUserOptions {
-  signal?: AbortSignal;
+type Organizations<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false> = (Pick<OrganizationBase, 'id' | 'name' | 'slug' | 'createdAt' | 'updatedAt' | 'defaultRoleName' | 'dashboardStatus' | 'aiFeaturesStatus'> & (boolean extends IncludeMembers ? {
+  members?: OrganizationMember[];
+} : IncludeMembers extends true ? {
+  members: OrganizationMember[];
+} : unknown) & (boolean extends IncludeFeatures ? {
+  features?: string[];
+} : IncludeFeatures extends true ? {
+  features: string[];
+} : unknown))[];
+/** @public */
+interface OrganizationsOptions<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false> extends Omit<OrganizationOptions<IncludeMembers, IncludeFeatures>, 'organizationId'> {
+  /**
+   * When `true`, includes organisations the user has access to via
+   * project-level grants, not just direct organisation memberships.
+   */
+  includeImplicitMemberships?: boolean;
 }
+/**
+ * Fetcher for the current user's organizations (`GET /organizations`), on the
+ * shared fetcher cache.
+ *
+ * @internal
+ */
+declare const organizations: Fetcher<[options?: OrganizationsOptions<boolean, boolean> | undefined], Organizations<boolean, boolean>>;
 /** @public */
 interface PresenceLocation {
   type: 'document';
@@ -1814,128 +2029,110 @@ interface DisconnectEvent {
   sessionId: string;
   timestamp: string;
 }
-type PresenceStoreState = {
-  locations: Map<string, {
-    userId: string;
-    locations: PresenceLocation[];
-  }>;
-  users: Record<string, SanityUser | undefined>;
-};
-/** @public */
-
 /** @beta */
-declare const getPresence: BoundStoreAction<PresenceStoreState, [{
+declare function getPresence(instance: SanityInstance, params?: {
   resource?: DocumentResource;
-}, ...unknown[]], StateSource<UserPresence[]>>;
+}): StateSource<UserPresence[]>;
 /**
- * Generates a GROQ projection for preview data without requiring a schema.
- * Uses common field names to make educated guesses about which fields to use.
- *
- * @internal
+ * @beta
+ * @deprecated This type is deprecated and will be removed in a future release.
  */
-declare const PREVIEW_PROJECTION: string;
+type GetPreviewStateOptions = DocumentHandle;
 /**
- * @public
- * The result of a projection query
+ * @beta
+ * @deprecated This function is deprecated and will be removed in a future release.
  */
-interface ProjectionValuePending<TValue extends object> {
-  data: TValue | null;
-  isPending: boolean;
-}
-interface DocumentStatus {
-  lastEditedDraftAt?: string;
-  lastEditedPublishedAt?: string;
-  lastEditedVersionAt?: string;
-}
+declare function getPreviewState<TResult extends object>(instance: SanityInstance, options: GetPreviewStateOptions): StateSource<ValuePending<TResult>>;
 /**
- *
- * @internal
+ * @beta
+ * @deprecated This function is deprecated and will be removed in a future release.
  */
-interface PreviewQueryResult {
-  _id: string;
-  _type: string;
-  _updatedAt: string;
-  titleCandidates: Record<string, unknown>;
-  subtitleCandidates: Record<string, unknown>;
-  media?: PreviewMedia | null;
-  _status?: DocumentStatus;
-}
+declare function getPreviewState(instance: SanityInstance, options: GetPreviewStateOptions): StateSource<ValuePending<PreviewValue>>;
 /**
- * Represents a media asset in a preview.
- *
- * @public
+ * @beta
+ * @deprecated This type is deprecated and will be removed in a future release.
+ */
+type ResolvePreviewOptions = DocumentHandle;
+/**
+ * @beta
+ * @deprecated This function is deprecated and will be removed in a future release.
  */
-interface PreviewMedia {
-  type: 'image-asset';
-  _ref: string;
-  url: string;
+declare function resolvePreview(instance: SanityInstance, options: ResolvePreviewOptions): Promise<ValuePending<PreviewValue>>;
+/** @public */
+interface ProjectMemberRole {
+  name: string;
+  title: string;
+  description: string;
+}
+/** @public */
+interface ProjectMember {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  isCurrentUser: boolean;
+  isRobot: boolean;
+  roles: ProjectMemberRole[];
+}
+/** @public */
+interface ProjectMetadata {
+  color?: string;
+  externalStudioHost?: string;
+  initialTemplate?: string;
+  cliInitializedAt?: string;
+  integration: 'manage' | 'cli';
 }
 /**
- * Represents the set of values displayed as a preview for a given Sanity document.
- * This includes a primary title, a secondary subtitle, an optional piece of media associated
- * with the document, and the document's status.
- *
+ * The base fields returned from `/projects` for every project.
  * @public
  */
-interface PreviewValue {
-  /**
-   * The primary text displayed for the document preview.
-   */
-  title: string;
-  /**
-   * A secondary line of text providing additional context about the document.
-   */
-  subtitle?: string;
-  /**
-   * An optional piece of media representing the document within its preview.
-   * Currently, only image assets are available.
-   */
-  media?: PreviewMedia | null;
-  /**
-   * The status of the document.
-   */
-  _status?: {
-    /** The date of the last published edit */
-    lastEditedPublishedAt?: string;
-    /** The date of the last draft edit */
-    lastEditedDraftAt?: string;
-  };
+interface ProjectBase {
+  id: string;
+  displayName: string;
+  studioHost: string | null;
+  organizationId: string;
+  metadata: ProjectMetadata;
+  isBlocked: boolean;
+  isDisabled: boolean;
+  isDisabledByUser: boolean;
+  activityFeedEnabled: boolean;
+  createdAt: string;
+  updatedAt: string;
 }
 /**
- * Represents the current state of a preview value along with a flag indicating whether
- * the preview data is still being fetched or is fully resolved.
- *
- * The tuple contains a preview value or null, and a boolean indicating if the data is
- * pending. A `true` value means a fetch is ongoing; `false` indicates that the
- * currently provided preview value is up-to-date.
- *
+ * A `Project` with `members` and/or `features` conditionally included
+ * based on the query options used to fetch it.
  * @public
  */
-type ValuePending<T> = {
-  data: T | null;
-  isPending: boolean;
-};
+type Project<IncludeMembers extends boolean = true, IncludeFeatures extends boolean = true> = ProjectBase & (boolean extends IncludeMembers ? {
+  members?: ProjectMember[];
+} : IncludeMembers extends true ? {
+  members: ProjectMember[];
+} : unknown) & (boolean extends IncludeFeatures ? {
+  features?: string[];
+} : IncludeFeatures extends true ? {
+  features: string[];
+} : unknown);
+/** @public */
+interface ProjectOptions<IncludeMembers extends boolean = true, IncludeFeatures extends boolean = true> extends ProjectHandle {
+  includeMembers?: IncludeMembers;
+  includeFeatures?: IncludeFeatures;
+}
 /**
- * Transforms a projection result (with titleCandidates, subtitleCandidates, media)
- * into a PreviewValue (with title, subtitle, media).
+ * Fetcher for a single project (`GET /projects/:id`), on the shared fetcher
+ * cache. Pre-seeds from the default {@link projects} list entry when it can
+ * satisfy the read — the default list carries features but not members, so
+ * only `includeMembers: false` reads seed.
  *
- * @param projectionResult - The raw projection result from GROQ
- * @param instance - The Sanity instance to use for client configuration
- * @param resource - Data resource for the preview
  * @internal
  */
-declare function transformProjectionToPreview(instance: SanityInstance, resource: DocumentResource, projectionResult: PreviewQueryResult): PreviewValue;
-/** @public */
-type ProjectHandle = {
-  projectId: string;
-};
-/** @public */
-declare const getProjectState: BoundStoreAction<FetcherStoreState<[options: ProjectHandle], _sanity_client12.SanityProject>, [options: ProjectHandle], StateSource<_sanity_client12.SanityProject | undefined>>;
-/** @public */
-declare const resolveProject: BoundStoreAction<FetcherStoreState<[options: ProjectHandle], _sanity_client12.SanityProject>, [options: ProjectHandle], Promise<_sanity_client12.SanityProject>>;
+declare const project: Fetcher<[options?: ProjectOptions<boolean, boolean> | undefined], Project<boolean, boolean>>;
 interface ProjectionOptions<TProjection extends string = string, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
   projection: TProjection;
 }
+/**
+ * @beta
+ */
+declare function getProjectionState<TProjection extends string = string, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: ProjectionOptions<TProjection, TDocumentType, TDataset, TProjectId>): StateSource<ProjectionValuePending<SanityProjectionResult<TProjection, TDocumentType, `${TProjectId}.${TDataset}`>> | undefined>;
 /**
  * @beta
  */
@@ -1945,103 +2142,53 @@ declare function getProjectionState<TData extends object>(instance: SanityInstan
  */
 declare function getProjectionState(instance: SanityInstance, options: ProjectionOptions): StateSource<ProjectionValuePending<Record<string, unknown>> | undefined>;
 /** @beta */
+declare function resolveProjection<TProjection extends string = string, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: ProjectionOptions<TProjection, TDocumentType, TDataset, TProjectId>): Promise<ProjectionValuePending<SanityProjectionResult<TProjection, TDocumentType, `${TProjectId}.${TDataset}`>>>;
+/** @beta */
 declare function resolveProjection<TData extends object>(instance: SanityInstance, options: ProjectionOptions): Promise<ProjectionValuePending<TData>>;
 /** @public */
-declare const getProjectsState: BoundStoreAction<FetcherStoreState<[options?: {
-  organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], Omit<_sanity_client12.SanityProject, "members">[]>, [options?: {
-  organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], StateSource<Omit<_sanity_client12.SanityProject, "members">[] | undefined>>;
-/** @public */
-declare const resolveProjects: BoundStoreAction<FetcherStoreState<[options?: {
+interface ProjectsOptions<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = true> {
   organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], Omit<_sanity_client12.SanityProject, "members">[]>, [options?: {
-  organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], Promise<Omit<_sanity_client12.SanityProject, "members">[]>>;
-/**
- * @beta
- */
-interface QueryOptions<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string> extends Pick<ResponseQueryOptions, 'useCdn' | 'cache' | 'next' | 'cacheMode' | 'tag'>, ResourceHandle<TDataset, TProjectId> {
-  query: TQuery;
-  params?: Record<string, unknown>;
-}
-/**
- * @beta
- */
-interface ResolveQueryOptions<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string> extends QueryOptions<TQuery, TDataset, TProjectId> {
-  signal?: AbortSignal;
+  includeMembers?: IncludeMembers;
+  includeFeatures?: IncludeFeatures;
+  onlyExplicitMembership?: boolean;
 }
-/** @beta */
-declare const getQueryKey: (options: QueryOptions) => string;
-/** @beta */
-declare const parseQueryKey: (key: string) => QueryOptions;
 /**
- * Returns the state source for a query.
+ * Fetcher for the current user's projects (`GET /projects`), on the shared
+ * fetcher cache.
  *
- * This function returns a state source that represents the current result of a GROQ query.
- * Subscribing to the state source will instruct the SDK to fetch the query (if not already fetched)
- * and will keep the query live using the Live content API (considering sync tags) to provide up-to-date results.
- * When the last subscriber is removed, the query state is automatically cleaned up from the store.
- *
- * Note: This functionality is for advanced users who want to build their own framework integrations.
- * Our SDK also provides a React integration (useQuery hook) for convenient usage.
- *
- * Note: Automatic cleanup can interfere with React Suspense because if a component suspends while being the only subscriber,
- * cleanup might occur unexpectedly. In such cases, consider using `resolveQuery` instead.
- *
- * @beta
+ * @internal
  */
-declare function getQueryState<TData>(instance: SanityInstance, queryOptions: QueryOptions): StateSource<TData | undefined>;
-/** @beta */
-declare function getQueryState(instance: SanityInstance, queryOptions: QueryOptions): StateSource<unknown>;
+declare const projects: Fetcher<[options?: ProjectsOptions<boolean, boolean> | undefined], Project<boolean, boolean>[]>;
 /**
- * Resolves the result of a query without registering a lasting subscriber.
- *
- * This function fetches the result of a GROQ query and returns a promise that resolves with the query result.
- * Unlike `getQueryState`, which registers subscribers to keep the query live and performs automatic cleanup,
- * `resolveQuery` does not track subscribers. This makes it ideal for use with React Suspense, where the returned
- * promise is thrown to delay rendering until the query result becomes available.
- * Once the promise resolves, it is expected that a real subscriber will be added via `getQueryState` to manage ongoing updates.
- *
- * Additionally, an optional AbortSignal can be provided to cancel the query and immediately clear the associated state
- * if there are no active subscribers.
- *
+ * Lifecycle states a release document can be in. Mirrors the server's
+ * `ReleaseState`.
  * @beta
  */
-declare function resolveQuery<TData>(instance: SanityInstance, queryOptions: ResolveQueryOptions): Promise<TData>;
-/**
- * Represents a document in a Sanity dataset that represents release options.
- * @internal
- */
-type ReleaseDocument = SanityDocument$2 & {
-  name: string;
-  publishAt?: string;
-  state: 'active' | 'scheduled';
-  metadata: {
-    title: string;
-    releaseType: 'asap' | 'scheduled' | 'undecided';
-    intendedPublishAt?: string;
-    description?: string;
-  };
-};
+type ReleaseState = 'active' | 'archiving' | 'unarchiving' | 'archived' | 'published' | 'publishing' | 'scheduled' | 'scheduling';
 interface ReleasesStoreState {
-  activeReleases?: ReleaseDocument[];
+  activeReleases?: ReleaseDocument$1[];
+  allReleases?: ReleaseDocument$1[];
   error?: unknown;
 }
 /**
  * Get the active releases from the store.
  * @internal
  */
-declare const getActiveReleasesState: (instance: SanityInstance, options: {
-  resource: DocumentResource;
-}) => StateSource<ReleaseDocument[] | undefined>;
+declare const getActiveReleasesState: (instance: SanityInstance, options?: {
+  resource?: DocumentResource;
+}) => StateSource<ReleaseDocument$1[] | undefined>;
+/**
+ * Get every release in the store, including archived and published.
+ * @internal
+ */
+declare const getAllReleasesState: (instance: SanityInstance, options?: {
+  resource?: DocumentResource;
+}) => StateSource<ReleaseDocument$1[] | undefined>;
 declare const _getPerspectiveStateSelector: StoreAction<ReleasesStoreState, [_?: (PerspectiveHandle & {
+  projectId?: string;
+  dataset?: string;
   resource?: DocumentResource;
-}) | undefined], StateSource<string[] | "previewDrafts" | "published" | "drafts" | "raw" | undefined>, unknown>;
+}) | undefined], import("../_exports").StateSource<string[] | "previewDrafts" | "published" | "drafts" | "raw" | undefined>, unknown>;
 type OmitFirst<T extends unknown[]> = T extends [unknown, ...infer R] ? R : never;
 type SelectorParams = OmitFirst<Parameters<typeof _getPerspectiveStateSelector>>;
 type BoundGetPerspectiveState = BoundStoreAction<ReleasesStoreState, SelectorParams, ReturnType<typeof _getPerspectiveStateSelector>>;
@@ -2058,22 +2205,6 @@ type BoundGetPerspectiveState = BoundStoreAction<ReleasesStoreState, SelectorPar
  * @public
  */
 declare const getPerspectiveState: BoundGetPerspectiveState;
-/** @internal */
-declare const getUsersKey: (_instance: SanityInstance, {
-  resourceType,
-  organizationId,
-  batchSize,
-  projectId,
-  userId
-}?: GetUsersOptions) => string;
-/** @internal */
-declare const parseUsersKey: (key: string) => {
-  batchSize: number;
-  resourceType?: "organization" | "project";
-  projectId?: string;
-  organizationId?: string;
-  userId?: string;
-};
 /**
  * Returns the state source for users associated with a specific resource.
  *
@@ -2087,7 +2218,7 @@ declare const parseUsersKey: (key: string) => {
  *
  * @beta
  */
-declare const getUsersState: BoundStoreAction<UsersStoreState, [options?: GetUsersOptions | undefined], StateSource<{
+declare const getUsersState: BoundStoreAction<UsersStoreState, [options?: GetUsersOptions | undefined], import("../_exports").StateSource<{
   data: SanityUser[];
   totalCount: number;
   hasMore: boolean;
@@ -2151,7 +2282,7 @@ interface StoreEntry<TParams extends unknown[], TData> {
  * @public
  */
 interface FetcherStoreState<TParams extends unknown[], TData> {
-  stateByParams: { [TSerializedKey in string]?: StoreEntry<TParams, TData> };
+  stateByParams: { [TSerializedKey in string]?: StoreEntry<TParams, TData>; };
   error?: unknown;
 }
 /**
@@ -2163,163 +2294,34 @@ interface FetcherStore<TParams extends unknown[], TData> {
   resolveState: BoundStoreAction<FetcherStoreState<TParams, TData>, TParams, Promise<TData>>;
 }
 /**
- * Creates a GROQ search filter string (`[@] match text::query("...")`)
- * from a raw search query string.
- *
- * It applies wildcard ('*') logic to the last eligible token and escapes
- * double quotes within the search term.
- *
- * If the input query is empty or only whitespace, it returns an empty string.
- *
- * @param query - The raw input search string.
- * @returns The GROQ search filter string, or an empty string.
- * @internal
- */
-declare function createGroqSearchFilter(query: string): string;
-/**
- * Filter criteria for intent matching. Can be combined to create more specific intents.
- *
- * @example
- * ```typescript
- * // matches only geopoints in the travel-project project, production dataset
- * const filter: IntentFilter = {
- *   projectId: 'travel-project',
- *   dataset: 'production',
- *   types: ['geopoint']
- * }
- *
- * // matches all documents in the travel-project project
- * const filter: IntentFilter = {
- *   projectId: 'travel-project',
- *   types: ['*']
- * }
- *
- * // matches geopoints in the travel-project production dataset and map pins in all projects in the org
- * const filters: IntentFilter[] = [
- *  {
- *    projectId: 'travel-project',
- *    dataset: 'production',
- *    types: ['geopoint']
- *  },
- *  {
- *    types: ['map-pin']
- *  }
- * ]
- * ```
- * @public
- */
-interface IntentFilter {
-  /**
-   * Project ID to match against
-   * @remarks When specified, the intent will only match for the specified project.
-   */
-  projectId?: string;
-  /**
-   * Dataset to match against
-   * @remarks When specified, the intent will only match for the specified dataset. Requires projectId to be specified.
-   */
-  dataset?: string;
-  /**
-   * Document types that this intent can handle
-   * @remarks This is required for all filters. Use ['*'] to match all document types.
-   */
-  types: string[];
-}
-/**
- * Intent definition structure for registering user intents
  * @public
+ * Extracts the project ID from a CorsOriginError message.
+ * @param error - The error to extract the project ID from.
+ * @returns The project ID or null if the error is not a CorsOriginError.
  */
-interface Intent {
-  /**
-   * Unique identifier for this intent
-   * @remarks Should be unique across all registered intents in an org for proper matching
-   */
-  id: string;
-  /**
-   * The action that this intent performs
-   * @remarks Examples: "view", "edit", "create", "delete"
-   */
-  action: 'view' | 'edit' | 'create' | 'delete';
-  /**
-   * Human-readable title for this intent
-   * @remarks Used for display purposes in UI or logs
-   */
-  title: string;
-  /**
-   * Detailed description of what this intent does
-   * @remarks Helps users understand the purpose and behavior of the intent
-   */
-  description?: string;
-  /**
-   * Array of filter criteria for intent matching
-   * @remarks At least one filter is required. Use `{types: ['*']}` to match everything
-   */
-  filters: IntentFilter[];
-}
+declare function getCorsErrorProjectId(error: Error): string | null;
 /**
- * Creates a properly typed intent definition for registration with the backend.
- *
- * This utility function provides TypeScript support and validation for intent declarations.
- * It is also used in the CLI if intents are declared as bare objects in an intents file.
+ * Returns true when the given error looks like a dynamic-import or
+ * code-split chunk-loading failure.
  *
- * @param intent - The intent definition object
- * @returns The same intent object with proper typing
+ * These errors typically surface when a user has a tab open against a
+ * previously-deployed version of an app and the JavaScript or CSS chunk
+ * filenames have since changed: a fresh deployment removes the hashed assets
+ * the open tab still references. Detecting them lets the SDK trigger an
+ * automatic reload so the user gets the new build without manual intervention.
  *
- * @example
- * ```typescript
- * // Specific filter for a document type
- * const viewGeopointInMapApp = defineIntent({
- *   id: 'viewGeopointInMapApp',
- *   action: 'view',
- *   title: 'View a geopoint in the map app',
- *   description: 'This lets you view a geopoint in the map app',
- *   filters: [
- *     {
- *       projectId: 'travel-project',
- *       dataset: 'production',
- *       types: ['geopoint']
- *     }
- *   ]
- * })
- *
- * export default viewGeopointInMapApp
- * ```
+ * Recognized shapes (webpack ChunkLoadError, Vite "Failed to fetch
+ * dynamically imported module", Firefox "error loading dynamically imported
+ * module", Safari "Importing a module script failed", and Vite "Unable to
+ * preload CSS").
  *
- * If your intent is asynchronous, resolve the promise before defining / returning the intent
- * ```typescript
- * async function createAsyncIntent() {
- *   const currentProject = await asyncProjectFunction()
- *   const currentDataset = await asyncDatasetFunction()
- *
- *   return defineIntent({
- *     id: 'dynamicIntent',
- *     action: 'view',
- *     title: 'Dynamic Intent',
- *     description: 'Intent with dynamically resolved values',
- *     filters: [
- *       {
- *         projectId: currentProject,  // Resolved value
- *         dataset: currentDataset,    // Resolved value
- *         types: ['document']
- *       }
- *     ]
- *   })
- * }
- *
- * const intent = await createAsyncIntent()
- * export default intent
- * ```
+ * @param error - The value to inspect. Anything that is not an Error
+ *   instance returns false.
+ * @returns True if the error matches a known import/chunk-load failure.
  *
  * @public
  */
-declare function defineIntent(intent: Intent): Intent;
-/**
- * @public
- * Extracts the project ID from a CorsOriginError message.
- * @param error - The error to extract the project ID from.
- * @returns The project ID or null if the error is not a CorsOriginError.
- */
-declare function getCorsErrorProjectId(error: Error): string | null;
+declare function isImportError(error: unknown): boolean;
 /**
  * This version is provided by pkg-utils at build time
  * @internal
@@ -2329,4 +2331,5 @@ declare const CORE_SDK_VERSION: {};
  * @public
  */
 type SanityProject = SanityProject$1;
-export { type ActionErrorEvent, type ActionsResult, type AgentGenerateOptions, type AgentGenerateResult, type AgentPatchOptions, type AgentPatchResult, type AgentPromptOptions, type AgentPromptResult, type AgentResourceOptions, type AgentTransformOptions, type AgentTransformResult, type AgentTranslateOptions, type AgentTranslateResult, type ApiErrorBody, type ApplyDocumentActionsOptions, type AuthConfig, type AuthProvider, type AuthState, AuthStateType, type AuthStoreState, CORE_SDK_VERSION, type CanvasResource, type ClientOptions, type ClientStoreState as ClientState, type ComlinkControllerState, type ComlinkNodeState, type CreateDocumentAction, type CurrentUser, DEFAULT_RESOURCE_NAME, type DatasetResource, type DeleteDocumentAction, type DiscardDocumentAction, type DisconnectEvent, type DocumentAction, type DocumentCreatedEvent, type DocumentDeletedEvent, type DocumentDiscardedEvent, type DocumentEditedEvent, type DocumentEvent, type DocumentHandle, type DocumentOptions, type DocumentPermissionsResult, type DocumentPublishedEvent, type DocumentResource, type DocumentTypeHandle, type DocumentUnpublishedEvent, type EditDocumentAction, type ErrorAuthState, type FavoriteStatusResponse, type FetcherStore, type FetcherStoreState, type FrameMessage, type GetUserOptions, type GetUsersOptions, type InstanceContext, type Intent, type IntentFilter, type LogContext, type LogLevel, type LogNamespace, type LoggedInAuthState, type LoggedOutAuthState, type Logger, type LoggerConfig, type LoggingInAuthState, type MediaLibraryResource, type Membership, type NewTokenResponseMessage, type NodeState, type OrgVerificationResult, PREVIEW_PROJECTION, type PermissionDeniedReason, type PerspectiveHandle, type PresenceLocation, type PreviewMedia, type PreviewQueryResult, type PreviewValue, type ProjectHandle, type ProjectionValuePending, type PublishDocumentAction, type QueryOptions, type ReleaseDocument, type ReleasePerspective, type RequestNewTokenMessage, type ResolveUserOptions, type ResolveUsersOptions, type ResourceHandle, type Role, type RollCallEvent, type SanityConfig, type SanityDocument, type SanityInstance, SanityProject, type SanityUser, type SanityUserResponse, type Selector, type StateEvent, type StateSource, type StudioConfig, type TokenSource, type TransactionAcceptedEvent, type TransactionRevertedEvent, type TransportEvent, type UnpublishDocumentAction, type UserPresence, type UserProfile, type UsersGroupState, type UsersStoreState, type ValuePending, type WindowMessage, agentGenerate, agentPatch, agentPrompt, agentTransform, agentTranslate, applyDocumentActions, configureLogging, createDocument, createDocumentHandle, createDocumentTypeHandle, createGroqSearchFilter, createResourceHandle, createSanityInstance, defineIntent, deleteDocument, destroyController, discardDocument, editDocument, getActiveReleasesState, getAuthState, getClient, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getClientState, getCorsErrorProjectId, getCurrentUserState, getDashboardOrganizationId, getDatasetsState, getDocumentState, getDocumentSyncStatus, getFavoritesState, getIndexForKey, getIsInDashboardState, getLoginUrlState, getNodeState, getOrCreateChannel, getOrCreateController, getOrCreateNode, getPathDepth, getPermissionsState, getPerspectiveState, getPresence, getProjectState, getProjectionState, getProjectsState, getQueryKey, getQueryState, getTokenState, getUserState, getUsersKey, getUsersState, handleAuthCallback, isCanvasResource, isDatasetResource, isMediaLibraryResource, isProjectUserNotFoundClientError, isStudioConfig, joinPaths, jsonMatch, loadMoreUsers, logout, observeOrganizationVerificationState, parseQueryKey, parseUsersKey, publishDocument, releaseChannel, releaseNode, resolveDatasets, resolveDocument, resolveFavoritesState, resolvePermissions, resolveProject, resolveProjection, resolveProjects, resolveQuery, resolveUser, resolveUsers, setAuthToken, slicePath, stringifyPath, subscribeDocumentEvents, transformProjectionToPreview, unpublishDocument };
+export { type AccessResourceType, type Action, type ActionErrorEvent, type ActionsResult, type AgentGenerateOptions, type AgentGenerateResult, type AgentPatchOptions, type AgentPatchResult, type AgentPromptOptions, type AgentPromptResult, type AgentTransformOptions, type AgentTransformResult, type AgentTranslateOptions, type AgentTranslateResult, type ApiErrorBody, type Application, type ApplicationAccess, type ApplicationBase, type ApplicationDeployment, type ApplicationInclude, type ApplicationInterface, type ApplicationStudioConfig, type ApplicationVisibility, type ApplicationWorkspace, type ApplicationsOptions, type ApplicationsResponse, type ApplyDocumentActionsOptions, type ArchiveReleaseAction, type AuthConfig, type AuthProvider, type AuthState, AuthStateType, type AuthStoreState, CORE_SDK_VERSION, type CanvasResource, type CanvasSource, type ClientOptions, type ClientStoreState as ClientState, type ComlinkControllerState, type ComlinkNodeState, type CreateDocumentAction, type CreateReleaseAction, type CreateUserApplicationInput, type CurrentUser, type DatasetHandle, type DatasetResource, type DatasetSource, type DeleteApplicationInput, type DeleteDocumentAction, type DeleteReleaseAction, type DeleteUserApplicationInput, type DeletedResult, type DiscardDocumentAction, type DisconnectEvent, type DocumentAction, type DocumentCreatedEvent, type DocumentDeletedEvent, type DocumentDiscardedEvent, type DocumentEditedEvent, type DocumentEvent, type DocumentHandle, type DocumentOptions, type DocumentPermissionsResult, type DocumentPublishedEvent, type DocumentRemotePatchesEvent, type DocumentResource, type DocumentSource, type DocumentTransactionSubmissionResult, type DocumentTypeHandle, type DocumentUnpublishedEvent, type EditDocumentAction, type EditDocumentOptions, type EditReleaseAction, type ErrorAuthState, type FavoriteStatusResponse, type FetcherStore, type FetcherStoreState, type FrameMessage, type GetPreviewStateOptions, type GetUserOptions, type GetUsersOptions, type Installation, type InstallationAccess, type InstallationActiveConfig, type InstallationBase, type InstallationInclude, type InstallationInterface, type InstallationsOptions, type InstallationsResponse, type InstanceContext, type JsonMatch, type LogContext, type LogLevel, type LogNamespace, type LoggedInAuthState, type LoggedOutAuthState, type Logger, type LoggerConfig, type LoggingInAuthState, type MediaLibraryResource, type MediaLibrarySource, type Membership, type NewTokenResponseMessage, type NodeState, type OrgVerificationResult, type Organization, type OrganizationBase, type OrganizationMember, type OrganizationOptions, type Organizations, type OrganizationsOptions, PREVIEW_PROJECTION, type PermissionDeniedReason, type PerspectiveHandle, type PresenceLocation, type PreviewMedia, type PreviewQueryResult, type PreviewStoreState, type PreviewValue, type Project, type ProjectBase, type ProjectHandle, type ProjectMember, type ProjectMemberRole, type ProjectMetadata, type ProjectOptions, type ProjectionValuePending, type ProjectsOptions, type PublishDocumentAction, type PublishReleaseAction, type QueryOptions, type ReleaseAction, type ReleaseDocument, type ReleaseHandle, type ReleasePerspective, type ReleaseState, type RequestNewTokenMessage, type ResolvePreviewOptions, type ResolveUserOptions, type ResolveUsersOptions, type Role, type RollCallEvent, type SanityConfig, type SanityDocument, type SanityInstance, SanityProject, type SanityUser, type SanityUserResponse, type ScheduleReleaseAction, type Selector, type StateEvent, type StateSource, type StudioConfig, type TokenSource, type TransactionAcceptedEvent, type TransactionRevertedEvent, type TransportEvent, type UnarchiveReleaseAction, type UnpublishDocumentAction, type UnscheduleReleaseAction, type UpdateApplicationInput, type UpdateUserApplicationInput, type UserApplication, type UserApplicationDeployment, type UserApplicationWriteFields, type UserApplicationsOptions, type UserPresence, type UserProfile, type UsersGroupState, type UsersStoreState, type ValidProjection, type ValuePending, type WindowMessage, agentGenerate, agentPatch, agentPrompt, agentTransform, agentTranslate, application, applications, applyDocumentActions, archiveRelease, checkPermissions, configureLogging, createDatasetHandle, createDocument, createDocumentHandle, createDocumentTypeHandle, createGroqSearchFilter, createProjectHandle, createRelease, createSanityInstance, createUserApplication, deleteApplication, deleteDocument, deleteRelease, deleteUserApplication, destroyController, discardDocument, editDocument, editRelease, getActiveReleasesState, getAllReleasesState, getAuthState, getClient, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getClientState, getCorsErrorProjectId, getCurrentUserState, getDashboardOrganizationId, getDatasetsState, getDocumentState, getDocumentSyncStatus, getFavoritesState, getIndexForKey, getIsInDashboardState, getLoginUrlState, getNodeState, getOrCreateChannel, getOrCreateController, getOrCreateNode, getPathDepth, getPermissionsState, getPerspectiveState, getPresence, getPreviewState, getProjectionState, getQueryKey, getQueryState, getReleaseDocumentId, getTokenState, getUserState, getUsersKey, getUsersState, handleAuthCallback, installation, installations, isCanvasResource, isCanvasSource, isDatasetResource, isDatasetSource, isImportError, isMediaLibraryResource, isMediaLibrarySource, isProjectUserNotFoundClientError, isStudioConfig, joinPaths, jsonMatch, loadMoreUsers, logout, observeOrganizationVerificationState, organization, organizations, parseQueryKey, parseUsersKey, project, projects, publishDocument, publishRelease, releaseChannel, releaseNode, resolveDatasets, resolveDocument, resolveFavoritesState, resolvePermissions, resolvePreview, resolveProjection, resolveQuery, resolveUser, resolveUsers, scheduleRelease, setAuthToken, slicePath, stringifyPath, subscribeDocumentEvents, transformProjectionToPreview, unarchiveRelease, unpublishDocument, unscheduleRelease, updateApplication, updateUserApplication, userApplication, userApplications };
+//# sourceMappingURL=index.d.ts.map