@sanity/sdk 2.9.0 → 2.11.0

package/dist/_chunks-dts/utils.d.ts

@@ -1,8 +1,8 @@
-import * as _sanity_client12 from "@sanity/client";
+import * as _sanity_client4 from "@sanity/client";
 import { ClientConfig, ClientError, ClientPerspective, ListenEvent, MultipleMutationResult, ResponseQueryOptions, SanityClient, SanityDocument, SanityProject, StackablePerspective } from "@sanity/client";
 import { CurrentUser, CurrentUser as CurrentUser$1, Mutation, PatchOperations, Role, SanityDocument as SanityDocument$1, SanityDocument as SanityDocument$3, SanityDocumentLike } from "@sanity/types";
 import { Observable, Subject } from "rxjs";
-import * as _sanity_comlink5 from "@sanity/comlink";
+import * as _sanity_comlink3 from "@sanity/comlink";
 import { ChannelInput, ChannelInstance, Controller, Message, Node, NodeInput, Status } from "@sanity/comlink";
 import { PatchMutation } from "@sanity/mutate/_unstable_store";
 import { SanityDocument as SanityDocument$2, SanityProjectionResult, SanityQueryResult } from "groq";
@@ -145,9 +145,14 @@ interface DatasetHandle<TDataset extends string = string, TProjectId extends str
   dataset?: TDataset;
   /**
    * @beta
-   * Explicit source object to use for this operation.
+   * Explicit resource object to use for this operation.
    */
-  source?: DocumentSource;
+  resource?: DocumentResource;
+  /**
+   * @deprecated Use `resource` instead.
+   * @beta
+   */
+  source?: DocumentResource;
 }
 /**
  * Identifies a specific document type within a Sanity dataset and project.
@@ -181,7 +186,6 @@ interface DocumentHandle<TDocumentType extends string = string, TDataset extends
 interface SanityConfig extends DatasetHandle, PerspectiveHandle {
   /**
    * Authentication configuration for the instance
-   * @remarks Merged with parent configurations when using createChild
    */
   auth?: AuthConfig;
   /**
@@ -204,45 +208,85 @@ interface SanityConfig extends DatasetHandle, PerspectiveHandle {
   };
   /**
    * @beta
-   * A list of named sources to use for this instance.
+   * A list of named resources to use for this instance.
    */
-  sources?: Record<string, DocumentSource>;
+  resources?: Record<string, DocumentResource>;
+  /**
+   * @deprecated Use `resources` instead.
+   * @beta
+   */
+  sources?: Record<string, DocumentResource>;
 }
 /**
- * A document source can be used for querying.
+ * A document resource can be used for querying.
  * This will soon be the default way to identify where you are querying from.
  *
  * @beta
  */
-type DocumentSource = DatasetSource | MediaLibrarySource | CanvasSource;
+type DocumentResource = DatasetResource | MediaLibraryResource | CanvasResource$1;
 /**
  * @beta
  */
-type DatasetSource = {
+type DatasetResource = {
   projectId: string;
   dataset: string;
 };
 /**
  * @beta
  */
-type MediaLibrarySource = {
+type MediaLibraryResource = {
   mediaLibraryId: string;
 };
 /**
  * @beta
  */
-type CanvasSource = {
+type CanvasResource$1 = {
   canvasId: string;
 };
 /**
  * @beta
  */
+declare function isDatasetResource(resource: DocumentResource): resource is DatasetResource;
+/**
+ * @beta
+ */
+declare function isMediaLibraryResource(resource: DocumentResource): resource is MediaLibraryResource;
+/**
+ * @beta
+ */
+declare function isCanvasResource(resource: DocumentResource): resource is CanvasResource$1;
+/**
+ * @deprecated Use `DocumentResource` instead.
+ * @beta
+ */
+type DocumentSource = DocumentResource;
+/**
+ * @deprecated Use `DatasetResource` instead.
+ * @beta
+ */
+type DatasetSource = DatasetResource;
+/**
+ * @deprecated Use `MediaLibraryResource` instead.
+ * @beta
+ */
+type MediaLibrarySource = MediaLibraryResource;
+/**
+ * @deprecated Use `CanvasResource` instead.
+ * @beta
+ */
+type CanvasSource = CanvasResource$1;
+/**
+ * @deprecated Use `isDatasetResource` instead.
+ * @beta
+ */
 declare function isDatasetSource(source: DocumentSource): source is DatasetSource;
 /**
+ * @deprecated Use `isMediaLibraryResource` instead.
  * @beta
  */
 declare function isMediaLibrarySource(source: DocumentSource): source is MediaLibrarySource;
 /**
+ * @deprecated Use `isCanvasResource` instead.
  * @beta
  */
 declare function isCanvasSource(source: DocumentSource): source is CanvasSource;
@@ -256,7 +300,6 @@ declare function isCanvasSource(source: DocumentSource): source is CanvasSource;
 declare function isStudioConfig(config: SanityConfig): boolean;
 /**
  * Represents a Sanity.io resource instance with its own configuration and lifecycle
- * @remarks Instances form a hierarchy through parent/child relationships
  *
  * @public
  */
@@ -268,7 +311,6 @@ interface SanityInstance {
   readonly instanceId: string;
   /**
    * Resolved configuration for this instance
-   * @remarks Merges values from parent instances where appropriate
    */
   readonly config: SanityConfig;
   /**
@@ -290,12 +332,13 @@ interface SanityInstance {
   /**
    * Gets the parent instance in the hierarchy
    * @returns Parent instance or undefined if this is the root
+   * @deprecated The parent/child instance hierarchy is deprecated. Use a single SanityInstance instead.
    */
   getParent(): SanityInstance | undefined;
   /**
    * Creates a child instance with merged configuration
    * @param config - Configuration to merge with parent values
-   * @remarks Child instances inherit parent configuration but can override values
+   * @deprecated The parent/child instance hierarchy is deprecated. Use a single SanityInstance instead.
    */
   createChild(config: SanityConfig): SanityInstance;
   /**
@@ -303,6 +346,7 @@ interface SanityInstance {
    * matches the given target config using a shallow comparison.
    * @param targetConfig - A partial configuration object containing key-value pairs to match.
    * @returns The first matching instance or undefined if no match is found.
+   * @deprecated The parent/child instance hierarchy is deprecated. Use a single SanityInstance instead.
    */
   match(targetConfig: Partial<SanityConfig>): SanityInstance | undefined;
 }
@@ -396,7 +440,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): AgentGenerateResult;
+declare function agentGenerate(instance: SanityInstance, options: AgentGenerateOptions, resource?: DocumentResource): AgentGenerateResult;
 /**
  * Transforms a document using the agent.
  * @param instance - The Sanity instance.
@@ -404,7 +448,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): AgentTransformResult;
+declare function agentTransform(instance: SanityInstance, options: AgentTransformOptions, resource?: DocumentResource): AgentTransformResult;
 /**
  * Translates a document using the agent.
  * @param instance - The Sanity instance.
@@ -412,7 +456,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): 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.
@@ -420,7 +464,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): Observable<AgentPromptResult>;
+declare function agentPrompt(instance: SanityInstance, options: AgentPromptOptions, resource?: DocumentResource): Observable<AgentPromptResult>;
 /**
  * Patches a document using the agent.
  * @param instance - The Sanity instance.
@@ -428,7 +472,7 @@ 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): Observable<AgentPatchResult>;
+declare function agentPatch(instance: SanityInstance, options: AgentPatchOptions, resource?: DocumentResource): Observable<AgentPatchResult>;
 /**
  * Represents the various states the authentication type can be in.
  *
@@ -502,19 +546,16 @@ interface ClientOptions extends Pick<ClientConfig, AllowedClientConfigKey> {
    * 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;
+  apiVersion: string;
   /**
    * @internal
+   * The SDK resource to use for the client -- this will get transformed into a ClientConfig resource.
    */
-  '~experimental_resource'?: ClientConfig['~experimental_resource'];
-  /**
-   * @internal
-   */
-  'source'?: DocumentSource;
+  resource?: DocumentResource;
 }
 /**
  * Retrieves a Sanity client instance configured with the provided options.
@@ -595,7 +636,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<_sanity_comlink3.Message, _sanity_comlink3.Message>>;
 /**
  * Initializes or fetches a controller to handle communication
  * between an application and iframes.
@@ -636,7 +677,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<_sanity_comlink3.Message, _sanity_comlink3.Message>>;
 /**
  * @public
  */
@@ -957,9 +998,9 @@ interface Logger {
  */
 declare function configureLogging(config: LoggerConfig): void;
 /** @public */
-declare const getDatasetsState: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client12.DatasetsResponse | undefined>>;
+declare const getDatasetsState: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client4.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client4.DatasetsResponse | undefined>>;
 /** @public */
-declare const resolveDatasets: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client12.DatasetsResponse>>;
+declare const resolveDatasets: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client4.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client4.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).
@@ -1273,7 +1314,7 @@ declare function resolveDocument<TData extends SanityDocument$2>(instance: Sanit
 /** @beta */
 declare const getDocumentSyncStatus: BoundStoreAction<DocumentStoreState, [doc: DocumentHandle<string, string, string>], StateSource<boolean | undefined>>;
 type PermissionsStateOptions = {
-  source?: DocumentSource;
+  resource?: DocumentResource;
   actions: DocumentAction[];
 };
 /** @beta */
@@ -1282,7 +1323,7 @@ declare const getPermissionsState: BoundStoreAction<DocumentStoreState, [Permiss
 declare const resolvePermissions: BoundStoreAction<DocumentStoreState, [options: PermissionsStateOptions], Promise<DocumentPermissionsResult>>;
 /** @beta */
 declare const subscribeDocumentEvents: BoundStoreAction<DocumentStoreState, [options: {
-  source?: DocumentSource;
+  resource?: DocumentResource;
   eventHandler: (e: DocumentEvent) => void;
 }], () => void>;
 type ActionMap = {
@@ -1531,9 +1572,9 @@ interface ApplyDocumentActionsOptions {
    */
   actions: DocumentAction[];
   /**
-   * The source to which the documents being acted on belong.
+   * The resource to which the documents being acted on belong.
    */
-  source?: DocumentSource;
+  resource?: DocumentResource;
   /**
    * Optionally provide an ID to be used as this transaction ID
    */
@@ -1577,6 +1618,111 @@ declare const getFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDoc
  * @public
  */
 declare const resolveFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], Promise<FavoriteStatusResponse>>;
+/** @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 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
+ */
+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);
+/**
+ * Public signature for the organization state source. The conditional generics
+ * cannot flow through `BoundStoreAction`, so we declare the signature here
+ * and assign the (already-correct) runtime function to it.
+ */
+type GetOrganizationState = <IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false>(instance: SanityInstance, options: OrganizationOptions<IncludeMembers, IncludeFeatures>) => StateSource<Organization<IncludeMembers, IncludeFeatures> | undefined>;
+type ResolveOrganization = <IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false>(instance: SanityInstance, options: OrganizationOptions<IncludeMembers, IncludeFeatures>) => Promise<Organization<IncludeMembers, IncludeFeatures>>;
+/** @public */
+declare const getOrganizationState: GetOrganizationState;
+/** @public */
+declare const resolveOrganization: ResolveOrganization;
+/**
+ * The list shape returned from `/organizations`, with `members` and/or
+ * `features` conditionally included based on the query options used.
+ * @public
+ */
+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;
+}
+/**
+ * Public signature for the organization state source. The conditional generics
+ * cannot flow through `BoundStoreAction`, so we declare the signature here
+ * and assign the (already-correct) runtime function to it.
+ */
+type GetOrganizationsState = <IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false>(instance: SanityInstance, options?: OrganizationsOptions<IncludeMembers, IncludeFeatures>) => StateSource<Organizations<IncludeMembers, IncludeFeatures> | undefined>;
+type ResolveOrganizations = <IncludeMembers extends boolean = false, IncludeFeatures extends boolean = false>(instance: SanityInstance, options?: OrganizationsOptions<IncludeMembers, IncludeFeatures>) => Promise<Organizations<IncludeMembers, IncludeFeatures>>;
+/** @public */
+declare const getOrganizationsState: GetOrganizationsState;
+/** @public */
+declare const resolveOrganizations: ResolveOrganizations;
 /**
  * @public
  */
@@ -1704,20 +1850,10 @@ interface DisconnectEvent {
   sessionId: string;
   timestamp: string;
 }
-type PresenceStoreState = {
-  locations: Map<string, {
-    userId: string;
-    locations: PresenceLocation[];
-  }>;
-  users: Record<string, SanityUser | undefined>;
-};
-/** @public */
-
-/** @public */
-declare const getPresence: BoundStoreAction<PresenceStoreState, [((object & {
-  projectId?: string;
-  dataset?: string;
-}) | undefined)?, ...unknown[]], StateSource<UserPresence[]>>;
+/** @beta */
+declare function getPresence(instance: SanityInstance, params?: {
+  resource?: DocumentResource;
+}): StateSource<UserPresence[]>;
 /**
  * @public
  * The result of a projection query
@@ -1843,10 +1979,10 @@ declare const PREVIEW_PROJECTION: string;
  *
  * @param projectionResult - The raw projection result from GROQ
  * @param instance - The Sanity instance to use for client configuration
- * @param source - Data source for the preview
+ * @param resource - Data resource for the preview
  * @internal
  */
-declare function transformProjectionToPreview(instance: SanityInstance, projectionResult: PreviewQueryResult, source?: DocumentSource): PreviewValue;
+declare function transformProjectionToPreview(instance: SanityInstance, projectionResult: PreviewQueryResult, resource?: DocumentResource): PreviewValue;
 /**
  * @beta
  * @deprecated This type is deprecated and will be removed in a future release.
@@ -1858,9 +1994,75 @@ type ResolvePreviewOptions = DocumentHandle;
  */
 declare function resolvePreview(instance: SanityInstance, options: ResolvePreviewOptions): Promise<ValuePending<PreviewValue>>;
 /** @public */
-declare const getProjectState: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.SanityProject>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client12.SanityProject | undefined>>;
+interface ProjectMemberRole {
+  name: string;
+  title: string;
+  description: string;
+}
+/** @public */
+interface ProjectMember {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  isCurrentUser: boolean;
+  isRobot: boolean;
+  roles: ProjectMemberRole[];
+}
 /** @public */
-declare const resolveProject: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.SanityProject>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client12.SanityProject>>;
+interface ProjectMetadata {
+  color?: string;
+  externalStudioHost?: string;
+  initialTemplate?: string;
+  cliInitializedAt?: string;
+  integration: 'manage' | 'cli';
+}
+/**
+ * The base fields returned from `/projects` for every project.
+ * @public
+ */
+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;
+}
+/**
+ * A `Project` with `members` and/or `features` conditionally included
+ * based on the query options used to fetch it.
+ * @public
+ */
+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;
+}
+/**
+ * Public signature for the project state source. The conditional generics
+ * cannot flow through `BoundStoreAction`, so we declare the signature here
+ * and assign the (already-correct) runtime function to it.
+ */
+type GetProjectState = <IncludeMembers extends boolean = true, IncludeFeatures extends boolean = true>(instance: SanityInstance, options?: ProjectOptions<IncludeMembers, IncludeFeatures>) => StateSource<Project<IncludeMembers, IncludeFeatures> | undefined>;
+type ResolveProject = <IncludeMembers extends boolean = true, IncludeFeatures extends boolean = true>(instance: SanityInstance, options?: ProjectOptions<IncludeMembers, IncludeFeatures>) => Promise<Project<IncludeMembers, IncludeFeatures>>;
+/** @public */
+declare const getProjectState: GetProjectState;
+/** @public */
+declare const resolveProject: ResolveProject;
 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;
 }
@@ -1881,21 +2083,23 @@ declare function resolveProjection<TProjection extends string = string, TDocumen
 /** @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?: {
+interface ProjectsOptions<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = true> {
   organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], StateSource<Omit<_sanity_client12.SanityProject, "members">[] | undefined>>;
+  includeMembers?: IncludeMembers;
+  includeFeatures?: IncludeFeatures;
+  onlyExplicitMembership?: boolean;
+}
+/**
+ * Public signature for the projects state source. The conditional generics
+ * cannot flow through `BoundStoreAction`, so we declare the signature here
+ * and assign the (already-correct) runtime function to it.
+ */
+type GetProjectsState = <IncludeMembers extends boolean = false, IncludeFeatures extends boolean = true>(instance: SanityInstance, options?: ProjectsOptions<IncludeMembers, IncludeFeatures>) => StateSource<Project<IncludeMembers, IncludeFeatures>[] | undefined>;
+type ResolveProjects = <IncludeMembers extends boolean = false, IncludeFeatures extends boolean = true>(instance: SanityInstance, options?: ProjectsOptions<IncludeMembers, IncludeFeatures>) => Promise<Project<IncludeMembers, IncludeFeatures>[]>;
 /** @public */
-declare const resolveProjects: BoundStoreAction<FetcherStoreState<[options?: {
-  organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], Omit<_sanity_client12.SanityProject, "members">[]>, [options?: {
-  organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], Promise<Omit<_sanity_client12.SanityProject, "members">[]>>;
+declare const getProjectsState: GetProjectsState;
+/** @public */
+declare const resolveProjects: ResolveProjects;
 /**
  * @beta
  */
@@ -1975,12 +2179,12 @@ interface ReleasesStoreState {
  * @internal
  */
 declare const getActiveReleasesState: (instance: SanityInstance, options?: {
-  source?: DocumentSource;
+  resource?: DocumentResource;
 }) => StateSource<ReleaseDocument[] | undefined>;
 declare const _getPerspectiveStateSelector: StoreAction<ReleasesStoreState, [_?: (PerspectiveHandle & {
   projectId?: string;
   dataset?: string;
-  source?: DocumentSource;
+  resource?: DocumentResource;
 }) | undefined], 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>>;
@@ -2260,6 +2464,28 @@ declare function defineIntent(intent: Intent): Intent;
  * @returns The project ID or null if the error is not a CorsOriginError.
  */
 declare function getCorsErrorProjectId(error: Error): string | null;
+/**
+ * Returns true when the given error looks like a dynamic-import or
+ * code-split chunk-loading failure.
+ *
+ * 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.
+ *
+ * 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").
+ *
+ * @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 isImportError(error: unknown): boolean;
 /**
  * This version is provided by pkg-utils at build time
  * @internal
@@ -2393,4 +2619,4 @@ declare function getClientErrorApiType(error: ClientError): string | undefined;
 declare function getClientErrorApiDescription(error: ClientError): string | undefined;
 /** @internal True if the error represents a projectUserNotFoundError. */
 declare function isProjectUserNotFoundClientError(error: ClientError): boolean;
-export { resolveProjects as $, logout as $n, getDocumentSyncStatus as $t, getCorsErrorProjectId as A, LoggerConfig as An, ProjectHandle as Ar, SanityUserResponse as At, resolveUser as B, ComlinkControllerState as Bn, ActionErrorEvent as Bt, getIndexForKey as C, resolveDatasets as Cn, DatasetHandle as Cr, UserPresence as Ct, slicePath as D, LogLevel as Dn, DocumentTypeHandle as Dr, ResolveUserOptions as Dt, jsonMatch as E, LogContext as En, DocumentSource as Er, Membership as Et, FetcherStore as F, NodeState as Fn, isCanvasSource as Fr, getFavoritesState as Ft, ReleaseDocument as G, FrameMessage as Gn, DocumentEvent as Gt, getUsersKey as H, getOrCreateChannel as Hn, DocumentDeletedEvent as Ht, FetcherStoreState as I, getNodeState as In, isDatasetSource as Ir, resolveFavoritesState as It, getQueryKey as J, WindowMessage as Jn, DocumentUnpublishedEvent as Jt, getActiveReleasesState as K, NewTokenResponseMessage as Kn, DocumentPublishedEvent as Kt, getUserState as L, ComlinkNodeState as Ln, isMediaLibrarySource as Lr, ActionsResult as Lt, IntentFilter as M, createDocumentHandle as Mn, SanityConfig as Mr, UsersGroupState as Mt, defineIntent as N, createDocumentTypeHandle as Nn, StudioConfig as Nr, UsersStoreState as Nt, stringifyPath as O, LogNamespace as On, MediaLibrarySource as Or, ResolveUsersOptions as Ot, createGroqSearchFilter as P, createProjectHandle as Pn, TokenSource as Pr, FavoriteStatusResponse as Pt, getProjectsState as Q, getClientState as Qn, getDocumentState as Qt, getUsersState as R, getOrCreateNode as Rn, AuthConfig as Rr, ApplyDocumentActionsOptions as Rt, SanityProject$1 as S, getDatasetsState as Sn, CanvasSource as Sr, TransportEvent as St, joinPaths as T, InstanceContext as Tn, DocumentHandle as Tr, GetUsersOptions as Tt, parseUsersKey as U, getOrCreateController as Un, DocumentDiscardedEvent as Ut, resolveUsers as V, destroyController as Vn, DocumentCreatedEvent as Vt, getPerspectiveState as W, releaseChannel as Wn, DocumentEditedEvent as Wt, parseQueryKey as X, ClientStoreState as Xn, TransactionRevertedEvent as Xt, getQueryState as Y, ClientOptions as Yn, TransactionAcceptedEvent as Yt, resolveQuery as Z, getClient as Zn, DocumentOptions as Zt, getTokenState as _, deleteDocument as _n, agentTransform as _r, getPresence as _t, isProjectUserNotFoundClientError as a, PermissionDeniedReason as an, AgentGenerateResult as ar, resolvePreview as at, Role as b, publishDocument as bn, createSanityInstance as br, RollCallEvent as bt, ErrorAuthState as c, StateSource as cn, AgentPromptOptions as cr, GetPreviewStateOptions as ct, LoggingInAuthState as d, DiscardDocumentAction as dn, AgentTransformResult as dr, PreviewQueryResult as dt, getPermissionsState as en, handleAuthCallback as er, resolveProjection as et, getAuthState as f, DocumentAction as fn, AgentTranslateOptions as fr, PreviewStoreState as ft, getLoginUrlState as g, createDocument as gn, agentPrompt as gr, ValidProjection as gt, getIsInDashboardState as h, UnpublishDocumentAction as hn, agentPatch as hr, ProjectionValuePending as ht, getClientErrorApiType as i, DocumentPermissionsResult as in, AgentGenerateOptions as ir, ResolvePreviewOptions as it, Intent as j, createDatasetHandle as jn, ReleasePerspective as jr, UserProfile as jt, CORE_SDK_VERSION as k, Logger as kn, PerspectiveHandle as kr, SanityUser as kt, LoggedInAuthState as l, CreateDocumentAction as ln, AgentPromptResult as lr, getPreviewState as lt, getDashboardOrganizationId as m, PublishDocumentAction as mn, agentGenerate as mr, ValuePending as mt, getClientErrorApiBody as n, resolvePermissions as nn, OrgVerificationResult as nr, getProjectState as nt, AuthState as o, JsonMatch as on, AgentPatchOptions as or, transformProjectionToPreview as ot, getCurrentUserState as p, EditDocumentAction as pn, AgentTranslateResult as pr, PreviewValue as pt, QueryOptions as q, RequestNewTokenMessage as qn, DocumentTransactionSubmissionResult as qt, getClientErrorApiDescription as r, subscribeDocumentEvents as rn, AuthStateType as rr, resolveProject as rt, AuthStoreState as s, Selector as sn, AgentPatchResult as sr, PREVIEW_PROJECTION as st, ApiErrorBody as t, resolveDocument as tn, observeOrganizationVerificationState as tr, getProjectionState as tt, LoggedOutAuthState as u, DeleteDocumentAction as un, AgentTransformOptions as ur, PreviewMedia as ut, setAuthToken as v, discardDocument as vn, agentTranslate as vr, DisconnectEvent as vt, getPathDepth as w, configureLogging as wn, DatasetSource as wr, GetUserOptions as wt, SanityDocument$3 as x, unpublishDocument as xn, isStudioConfig as xr, StateEvent as xt, CurrentUser$1 as y, editDocument as yn, SanityInstance as yr, PresenceLocation as yt, loadMoreUsers as z, releaseNode as zn, AuthProvider as zr, applyDocumentActions as zt };
+export { ProjectsOptions as $, NodeState as $n, ReleasePerspective as $r, getFavoritesState as $t, isImportError as A, DocumentAction as An, AgentTranslateOptions as Ar, TransportEvent as At, loadMoreUsers as B, getDatasetsState as Bn, CanvasResource$1 as Br, UsersGroupState as Bt, getIndexForKey as C, PermissionDeniedReason as Cn, AgentGenerateResult as Cr, ProjectionValuePending as Ct, slicePath as D, CreateDocumentAction as Dn, AgentPromptResult as Dr, PresenceLocation as Dt, jsonMatch as E, StateSource as En, AgentPromptOptions as Er, DisconnectEvent as Et, createGroqSearchFilter as F, deleteDocument as Fn, agentTransform as Fr, ResolveUserOptions as Ft, getPerspectiveState as G, LogLevel as Gn, DocumentHandle as Gr, resolveOrganizations as Gt, resolveUsers as H, configureLogging as Hn, DatasetHandle as Hr, Organizations as Ht, FetcherStore as I, discardDocument as In, agentTranslate as Ir, ResolveUsersOptions as It, QueryOptions as J, LoggerConfig as Jn, DocumentTypeHandle as Jr, OrganizationMember as Jt, ReleaseDocument as K, LogNamespace as Kn, DocumentResource as Kr, Organization as Kt, FetcherStoreState as L, editDocument as Ln, SanityInstance as Lr, SanityUser as Lt, Intent as M, PublishDocumentAction as Mn, agentGenerate as Mr, GetUserOptions as Mt, IntentFilter as N, UnpublishDocumentAction as Nn, agentPatch as Nr, GetUsersOptions as Nt, stringifyPath as O, DeleteDocumentAction as On, AgentTransformOptions as Or, RollCallEvent as Ot, defineIntent as P, createDocument as Pn, agentPrompt as Pr, Membership as Pt, resolveQuery as Q, createProjectHandle as Qn, ProjectHandle as Qr, FavoriteStatusResponse as Qt, getUserState as R, publishDocument as Rn, createSanityInstance as Rr, SanityUserResponse as Rt, SanityProject$1 as S, DocumentPermissionsResult as Sn, AgentGenerateOptions as Sr, ValuePending as St, joinPaths as T, Selector as Tn, AgentPatchResult as Tr, getPresence as Tt, getUsersKey as U, InstanceContext as Un, DatasetResource as Ur, OrganizationsOptions as Ut, resolveUser as V, resolveDatasets as Vn, CanvasSource as Vr, UsersStoreState as Vt, parseUsersKey as W, LogContext as Wn, DatasetSource as Wr, getOrganizationsState as Wt, getQueryState as X, createDocumentHandle as Xn, MediaLibrarySource as Xr, getOrganizationState as Xt, getQueryKey as Y, createDatasetHandle as Yn, MediaLibraryResource as Yr, OrganizationOptions as Yt, parseQueryKey as Z, createDocumentTypeHandle as Zn, PerspectiveHandle as Zr, resolveOrganization as Zt, getTokenState as _, getDocumentSyncStatus as _n, logout as _r, getPreviewState as _t, isProjectUserNotFoundClientError as a, isDatasetResource as ai, DocumentCreatedEvent as an, destroyController as ar, ProjectBase as at, Role as b, resolvePermissions as bn, OrgVerificationResult as br, PreviewStoreState as bt, ErrorAuthState as c, isMediaLibrarySource as ci, DocumentEditedEvent as cn, releaseChannel as cr, ProjectMetadata as ct, LoggingInAuthState as d, DocumentTransactionSubmissionResult as dn, RequestNewTokenMessage as dr, resolveProject as dt, SanityConfig as ei, resolveFavoritesState as en, getNodeState as er, getProjectsState as et, getAuthState as f, DocumentUnpublishedEvent as fn, WindowMessage as fr, ResolvePreviewOptions as ft, getLoginUrlState as g, getDocumentState as gn, getClientState as gr, GetPreviewStateOptions as gt, getIsInDashboardState as h, DocumentOptions as hn, getClient as hr, PREVIEW_PROJECTION as ht, getClientErrorApiType as i, isCanvasSource as ii, ActionErrorEvent as in, ComlinkControllerState as ir, Project as it, getCorsErrorProjectId as j, EditDocumentAction as jn, AgentTranslateResult as jr, UserPresence as jt, CORE_SDK_VERSION as k, DiscardDocumentAction as kn, AgentTransformResult as kr, StateEvent as kt, LoggedInAuthState as l, AuthConfig as li, DocumentEvent as ln, FrameMessage as lr, ProjectOptions as lt, getDashboardOrganizationId as m, TransactionRevertedEvent as mn, ClientStoreState as mr, transformProjectionToPreview as mt, getClientErrorApiBody as n, TokenSource as ni, ApplyDocumentActionsOptions as nn, getOrCreateNode as nr, resolveProjection as nt, AuthState as o, isDatasetSource as oi, DocumentDeletedEvent as on, getOrCreateChannel as or, ProjectMember as ot, getCurrentUserState as p, TransactionAcceptedEvent as pn, ClientOptions as pr, resolvePreview as pt, getActiveReleasesState as q, Logger as qn, DocumentSource as qr, OrganizationBase as qt, getClientErrorApiDescription as r, isCanvasResource as ri, applyDocumentActions as rn, releaseNode as rr, getProjectionState as rt, AuthStoreState as s, isMediaLibraryResource as si, DocumentDiscardedEvent as sn, getOrCreateController as sr, ProjectMemberRole as st, ApiErrorBody as t, StudioConfig as ti, ActionsResult as tn, ComlinkNodeState as tr, resolveProjects as tt, LoggedOutAuthState as u, AuthProvider as ui, DocumentPublishedEvent as un, NewTokenResponseMessage as ur, getProjectState as ut, setAuthToken as v, getPermissionsState as vn, handleAuthCallback as vr, PreviewMedia as vt, getPathDepth as w, JsonMatch as wn, AgentPatchOptions as wr, ValidProjection as wt, SanityDocument$3 as x, subscribeDocumentEvents as xn, AuthStateType as xr, PreviewValue as xt, CurrentUser$1 as y, resolveDocument as yn, observeOrganizationVerificationState as yr, PreviewQueryResult as yt, getUsersState as z, unpublishDocument as zn, isStudioConfig as zr, UserProfile as zt };

package/dist/_chunks-es/_internal.js

@@ -5,7 +5,7 @@ function isLocalUrl(win) {
   return url ? url.startsWith("http://localhost") || url.startsWith("https://localhost") || url.startsWith("http://127.0.0.1") || url.startsWith("https://127.0.0.1") : !1;
 }
 function isDevMode() {
-  return typeof process < "u" && process.env?.NODE_ENV === "production" ? !1 : typeof window < "u" ? isLocalUrl(window) : typeof process < "u" && process.env?.NODE_ENV === "development";
+  return typeof window < "u" ? isLocalUrl(window) : typeof process < "u" && process.env?.NODE_ENV === "development";
 }
 const SDKDevSessionStarted = defineEvent({
   name: "SDK Dev Session Started",
@@ -99,23 +99,12 @@ function trackHookMounted(instance, hookName) {
     logger.trace("hook mounted (logged)", { hookName, internal: !0 }), manager.logHookFirstUsed(hookName);
     return;
   }
-  const root = getRootInstance(instance);
+  const root = instance;
   let hooks = pendingHooks.get(root);
   hooks || (hooks = /* @__PURE__ */ new Set(), pendingHooks.set(root, hooks)), hooks.has(hookName) || logger.trace("hook mounted (buffered)", { hookName, internal: !0 }), hooks.add(hookName);
 }
 function findManager(instance) {
-  let current = instance;
-  for (; current; ) {
-    const manager = telemetryManagers.get(current);
-    if (manager) return manager;
-    current = typeof current.getParent == "function" ? current.getParent() : void 0;
-  }
-}
-function getRootInstance(instance) {
-  let current = instance;
-  for (; typeof current.getParent == "function" && current.getParent(); )
-    current = current.getParent();
-  return current;
+  return telemetryManagers.get(instance);
 }
 export {
   SDKDevError,