@sanity/sdk 2.10.0 → 2.11.0

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

@@ -1,4 +1,4 @@
-import * as _sanity_client20 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";
@@ -186,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;
   /**
@@ -301,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
  */
@@ -313,7 +311,6 @@ interface SanityInstance {
   readonly instanceId: string;
   /**
    * Resolved configuration for this instance
-   * @remarks Merges values from parent instances where appropriate
    */
   readonly config: SanityConfig;
   /**
@@ -335,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;
   /**
@@ -348,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;
 }
@@ -441,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.
@@ -449,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.
@@ -457,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.
@@ -465,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.
@@ -473,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.
  *
@@ -999,9 +998,9 @@ interface Logger {
  */
 declare function configureLogging(config: LoggerConfig): void;
 /** @public */
-declare const getDatasetsState: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client20.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client20.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_client20.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client20.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).
@@ -1619,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
  */
@@ -1890,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_client20.SanityProject>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client20.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 */
+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: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client20.SanityProject>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client20.SanityProject>>;
+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;
 }
@@ -1913,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_client20.SanityProject, never>[]>, [options?: {
+interface ProjectsOptions<IncludeMembers extends boolean = false, IncludeFeatures extends boolean = true> {
   organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], StateSource<Omit<_sanity_client20.SanityProject, never>[] | 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_client20.SanityProject, never>[]>, [options?: {
-  organizationId?: string;
-  includeMembers?: boolean;
-} | undefined], Promise<Omit<_sanity_client20.SanityProject, never>[]>>;
+declare const getProjectsState: GetProjectsState;
+/** @public */
+declare const resolveProjects: ResolveProjects;
 /**
  * @beta
  */
@@ -2447,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 { getProjectsState as $, getClientState as $n, getDocumentState as $t, isImportError as A, Logger as An, DocumentSource as Ar, SanityUser as At, loadMoreUsers as B, releaseNode as Bn, isCanvasResource as Br, applyDocumentActions as Bt, getIndexForKey as C, getDatasetsState as Cn, CanvasResource$1 as Cr, TransportEvent as Ct, slicePath as D, LogContext as Dn, DatasetSource as Dr, Membership as Dt, jsonMatch as E, InstanceContext as En, DatasetResource as Er, GetUsersOptions as Et, createGroqSearchFilter as F, createProjectHandle as Fn, ProjectHandle as Fr, FavoriteStatusResponse as Ft, getPerspectiveState as G, releaseChannel as Gn, isMediaLibrarySource as Gr, DocumentEditedEvent as Gt, resolveUsers as H, destroyController as Hn, isDatasetResource as Hr, DocumentCreatedEvent as Ht, FetcherStore as I, NodeState as In, ReleasePerspective as Ir, getFavoritesState as It, QueryOptions as J, RequestNewTokenMessage as Jn, DocumentTransactionSubmissionResult as Jt, ReleaseDocument as K, FrameMessage as Kn, AuthConfig as Kr, DocumentEvent as Kt, FetcherStoreState as L, getNodeState as Ln, SanityConfig as Lr, resolveFavoritesState as Lt, Intent as M, createDatasetHandle as Mn, MediaLibraryResource as Mr, UserProfile as Mt, IntentFilter as N, createDocumentHandle as Nn, MediaLibrarySource as Nr, UsersGroupState as Nt, stringifyPath as O, LogLevel as On, DocumentHandle as Or, ResolveUserOptions as Ot, defineIntent as P, createDocumentTypeHandle as Pn, PerspectiveHandle as Pr, UsersStoreState as Pt, resolveQuery as Q, getClient as Qn, DocumentOptions as Qt, getUserState as R, ComlinkNodeState as Rn, StudioConfig as Rr, ActionsResult as Rt, SanityProject$1 as S, unpublishDocument as Sn, isStudioConfig as Sr, StateEvent as St, joinPaths as T, configureLogging as Tn, DatasetHandle as Tr, GetUserOptions as Tt, getUsersKey as U, getOrCreateChannel as Un, isDatasetSource as Ur, DocumentDeletedEvent as Ut, resolveUser as V, ComlinkControllerState as Vn, isCanvasSource as Vr, ActionErrorEvent as Vt, parseUsersKey as W, getOrCreateController as Wn, isMediaLibraryResource as Wr, DocumentDiscardedEvent as Wt, getQueryState as X, ClientOptions as Xn, TransactionAcceptedEvent as Xt, getQueryKey as Y, WindowMessage as Yn, DocumentUnpublishedEvent as Yt, parseQueryKey as Z, ClientStoreState as Zn, TransactionRevertedEvent as Zt, getTokenState as _, createDocument as _n, agentPrompt as _r, ValidProjection as _t, isProjectUserNotFoundClientError as a, DocumentPermissionsResult as an, AgentGenerateOptions as ar, ResolvePreviewOptions as at, Role as b, editDocument as bn, SanityInstance as br, PresenceLocation as bt, ErrorAuthState as c, Selector as cn, AgentPatchResult as cr, PREVIEW_PROJECTION as ct, LoggingInAuthState as d, DeleteDocumentAction as dn, AgentTransformOptions as dr, PreviewMedia as dt, getDocumentSyncStatus as en, logout as er, resolveProjects as et, getAuthState as f, DiscardDocumentAction as fn, AgentTransformResult as fr, PreviewQueryResult as ft, getLoginUrlState as g, UnpublishDocumentAction as gn, agentPatch as gr, ProjectionValuePending as gt, getIsInDashboardState as h, PublishDocumentAction as hn, agentGenerate as hr, ValuePending as ht, getClientErrorApiType as i, subscribeDocumentEvents as in, AuthStateType as ir, resolveProject as it, getCorsErrorProjectId as j, LoggerConfig as jn, DocumentTypeHandle as jr, SanityUserResponse as jt, CORE_SDK_VERSION as k, LogNamespace as kn, DocumentResource as kr, ResolveUsersOptions as kt, LoggedInAuthState as l, StateSource as ln, AgentPromptOptions as lr, GetPreviewStateOptions as lt, getDashboardOrganizationId as m, EditDocumentAction as mn, AgentTranslateResult as mr, PreviewValue as mt, getClientErrorApiBody as n, resolveDocument as nn, observeOrganizationVerificationState as nr, getProjectionState as nt, AuthState as o, PermissionDeniedReason as on, AgentGenerateResult as or, resolvePreview as ot, getCurrentUserState as p, DocumentAction as pn, AgentTranslateOptions as pr, PreviewStoreState as pt, getActiveReleasesState as q, NewTokenResponseMessage as qn, AuthProvider as qr, DocumentPublishedEvent as qt, getClientErrorApiDescription as r, resolvePermissions as rn, OrgVerificationResult as rr, getProjectState as rt, AuthStoreState as s, JsonMatch as sn, AgentPatchOptions as sr, transformProjectionToPreview as st, ApiErrorBody as t, getPermissionsState as tn, handleAuthCallback as tr, resolveProjection as tt, LoggedOutAuthState as u, CreateDocumentAction as un, AgentPromptResult as ur, getPreviewState as ut, setAuthToken as v, deleteDocument as vn, agentTransform as vr, getPresence as vt, getPathDepth as w, resolveDatasets as wn, CanvasSource as wr, UserPresence as wt, SanityDocument$3 as x, publishDocument as xn, createSanityInstance as xr, RollCallEvent as xt, CurrentUser$1 as y, discardDocument as yn, agentTranslate as yr, DisconnectEvent as yt, getUsersState as z, getOrCreateNode as zn, TokenSource as zr, ApplyDocumentActionsOptions 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,

package/dist/_chunks-es/_internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"_internal.js","sources":["../../src/telemetry/devMode.ts","../../src/telemetry/__telemetry__/sdk.telemetry.ts","../../src/telemetry/initTelemetry.ts"],"sourcesContent":["/**\n * Checks whether the current URL points to a local development server.\n *\n * @param win - The window object to check\n * @returns True if running on localhost or 127.0.0.1\n * @internal\n */\nfunction isLocalUrl(win: Window): boolean {\n  const url = win.location?.href\n  if (!url) return false\n  return (\n    url.startsWith('http://localhost') ||\n    url.startsWith('https://localhost') ||\n    url.startsWith('http://127.0.0.1') ||\n    url.startsWith('https://127.0.0.1')\n  )\n}\n\n/**\n * Determines whether the SDK should enable dev-mode telemetry.\n *\n * Combines a browser URL check (localhost/127.0.0.1) with a Node.js\n * environment variable check (`NODE_ENV === 'development'`). Returns\n * false in production environments so bundlers can tree-shake the\n * telemetry code path entirely.\n *\n * @returns True if the SDK is running in a development environment\n * @internal\n */\nexport function isDevMode(): boolean {\n  if (typeof process !== 'undefined' && process.env?.['NODE_ENV'] === 'production') {\n    return false\n  }\n\n  if (typeof window !== 'undefined') {\n    return isLocalUrl(window)\n  }\n\n  return typeof process !== 'undefined' && process.env?.['NODE_ENV'] === 'development'\n}\n","import {defineEvent} from '@sanity/telemetry'\n\n/** @internal */\nexport const SDKDevSessionStarted = defineEvent<{\n  version: string\n  projectId: string\n  perspective: string\n  authMethod: string\n}>({\n  name: 'SDK Dev Session Started',\n  version: 1,\n  description: 'SDK instance created in development mode',\n})\n\n/** @internal */\nexport const SDKHookMounted = defineEvent<{\n  hookName: string\n}>({\n  name: 'SDK Hook Mounted',\n  version: 1,\n  description: 'An SDK hook was mounted for the first time in this session',\n})\n\n/** @internal */\nexport const SDKDevSessionEnded = defineEvent<{\n  durationSeconds: number\n  hooksUsed: string[]\n}>({\n  name: 'SDK Dev Session Ended',\n  version: 1,\n  description: 'SDK instance disposed in development mode',\n})\n\n/** @internal */\nexport const SDKDevError = defineEvent<{\n  errorType: string\n  hookName: string\n}>({\n  name: 'SDK Dev Error',\n  version: 1,\n  description: 'Runtime error caught during SDK development',\n})\n","import {type SanityInstance} from '../store/createSanityInstance'\nimport {createLogger} from '../utils/logger'\nimport {isDevMode} from './devMode'\nimport {type TelemetryManager} from './telemetryManager'\n\nconst DEFAULT_TELEMETRY_API_VERSION = '2024-11-12'\n\nconst logger = createLogger('telemetry')\n\n/**\n * Per-instance map of active telemetry managers. Allows the React\n * package (and other consumers) to look up the manager for a given\n * instance and log hook usage / errors without importing the full\n * telemetry module themselves.\n *\n * @internal\n */\nconst telemetryManagers = new WeakMap<SanityInstance, TelemetryManager>()\nconst pendingHooks = new WeakMap<SanityInstance, Set<string>>()\nconst initInFlight = new WeakSet<SanityInstance>()\n\n/**\n * Initializes dev-mode telemetry for a SDK instance if the environment\n * qualifies. Both `telemetryManager` and `clientStore` are dynamically\n * imported to avoid circular dependencies and to keep telemetry code\n * out of production bundles via code splitting.\n *\n * The `projectId` must be passed explicitly because the resource\n * configuration is typically set by the React layer after the\n * instance has already been created.\n *\n * @internal\n */\nexport function initTelemetry(instance: SanityInstance, projectId: string): void {\n  if (!isDevMode()) {\n    logger.trace('initTelemetry skipped: not dev mode', {internal: true})\n    return\n  }\n  if (!projectId) {\n    logger.trace('initTelemetry skipped: no projectId', {internal: true})\n    return\n  }\n  if (telemetryManagers.has(instance) || initInFlight.has(instance)) {\n    return\n  }\n  initInFlight.add(instance)\n\n  logger.debug('initializing telemetry', {projectId})\n\n  Promise.all([\n    import('./telemetryManager'),\n    import('../client/clientStore'),\n    import('../auth/authStore'),\n  ])\n    .then(async ([{createTelemetryManager}, {getClient}, {getTokenState}]) => {\n      if (instance.isDisposed()) {\n        initInFlight.delete(instance)\n        logger.debug('telemetry skipped: instance disposed before imports resolved')\n        return\n      }\n\n      // Wait for the auth store to resolve a token. The client needs a\n      // Bearer token for the consent check and batch POSTs. If the token\n      // is already available (e.g. static token config), this resolves\n      // immediately. For OAuth/localStorage discovery it waits for the\n      // first emission. For unauthenticated apps the promise never\n      // resolves, which is fine since telemetry requires auth anyway.\n      const token = getTokenState(instance).getCurrent()\n      logger.trace('auth token check', {tokenPresent: !!token, internal: true})\n\n      if (!token) {\n        logger.debug('waiting for auth token')\n        const hasToken = await new Promise<boolean>((resolve) => {\n          if (instance.isDisposed()) return resolve(false)\n          const cleanup = {unsubscribe: () => {}}\n          const unsub = instance.onDispose(() => {\n            cleanup.unsubscribe()\n            resolve(false)\n          })\n          const sub = getTokenState(instance).observable.subscribe((t) => {\n            if (t) {\n              logger.debug('auth token received')\n              sub.unsubscribe()\n              unsub()\n              resolve(true)\n            }\n          })\n          cleanup.unsubscribe = () => sub.unsubscribe()\n        })\n        if (!hasToken || instance.isDisposed()) {\n          initInFlight.delete(instance)\n          logger.debug('telemetry skipped: no token resolved or instance disposed')\n          return\n        }\n      }\n\n      const manager = createTelemetryManager({\n        sessionId: instance.instanceId,\n        getClient: () => getClient(instance, {apiVersion: DEFAULT_TELEMETRY_API_VERSION}),\n        projectId,\n      })\n\n      const consented = await manager.checkConsent()\n      logger.debug('consent check complete', {consented})\n      if (!consented || instance.isDisposed()) {\n        initInFlight.delete(instance)\n        manager.dispose()\n        return\n      }\n\n      initInFlight.delete(instance)\n      telemetryManagers.set(instance, manager)\n\n      const buffered = pendingHooks.get(instance)\n      if (buffered) {\n        logger.debug('flushing buffered hooks', {hooks: Array.from(buffered)})\n        for (const hookName of buffered) {\n          manager.logHookFirstUsed(hookName)\n        }\n        pendingHooks.delete(instance)\n      }\n\n      const config = instance.config\n      const perspective = typeof config.perspective === 'string' ? config.perspective : 'published'\n      const authMethod = config.auth?.token\n        ? 'token'\n        : config.studio?.auth?.token\n          ? 'studio'\n          : 'default'\n\n      logger.info('telemetry session started', {projectId, perspective, authMethod})\n      manager.logSessionStarted({\n        projectId,\n        perspective,\n        authMethod,\n      })\n\n      instance.onDispose(() => {\n        manager.endSession()\n        telemetryManagers.delete(instance)\n        logger.debug('telemetry session ended')\n      })\n    })\n    .catch((err) => {\n      initInFlight.delete(instance)\n      logger.warn('telemetry init failed', {error: err})\n    })\n}\n\n/**\n * Retrieves the telemetry manager for an instance, if one exists.\n * Returns undefined when telemetry is disabled or not yet initialized.\n *\n * @internal\n */\nexport function getTelemetryManager(instance: SanityInstance): TelemetryManager | undefined {\n  return telemetryManagers.get(instance)\n}\n\n/**\n * Record a hook name for an instance. If the telemetry manager is\n * already initialized the event is logged immediately. Otherwise\n * the name is buffered and flushed when init completes.\n *\n * @internal\n */\nexport function trackHookMounted(instance: SanityInstance, hookName: string): void {\n  if (!isDevMode()) return\n\n  const manager = findManager(instance)\n  if (manager) {\n    logger.trace('hook mounted (logged)', {hookName, internal: true})\n    manager.logHookFirstUsed(hookName)\n    return\n  }\n\n  const root = getRootInstance(instance)\n  let hooks = pendingHooks.get(root)\n  if (!hooks) {\n    hooks = new Set()\n    pendingHooks.set(root, hooks)\n  }\n  if (!hooks.has(hookName)) {\n    logger.trace('hook mounted (buffered)', {hookName, internal: true})\n  }\n  hooks.add(hookName)\n}\n\nfunction findManager(instance: SanityInstance): TelemetryManager | undefined {\n  let current: SanityInstance | undefined = instance\n  while (current) {\n    const manager = telemetryManagers.get(current)\n    if (manager) return manager\n    current = typeof current.getParent === 'function' ? current.getParent() : undefined\n  }\n  return undefined\n}\n\nfunction getRootInstance(instance: SanityInstance): SanityInstance {\n  let current = instance\n  while (typeof current.getParent === 'function' && current.getParent()) {\n    current = current.getParent()!\n  }\n  return current\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"_internal.js","sources":["../../src/telemetry/devMode.ts","../../src/telemetry/__telemetry__/sdk.telemetry.ts","../../src/telemetry/initTelemetry.ts"],"sourcesContent":["/**\n * Checks whether the current URL points to a local development server.\n *\n * @param win - The window object to check\n * @returns True if running on localhost or 127.0.0.1\n * @internal\n */\nfunction isLocalUrl(win: Window): boolean {\n  const url = win.location?.href\n  if (!url) return false\n  return (\n    url.startsWith('http://localhost') ||\n    url.startsWith('https://localhost') ||\n    url.startsWith('http://127.0.0.1') ||\n    url.startsWith('https://127.0.0.1')\n  )\n}\n\n/**\n * Determines whether the SDK should enable dev-mode telemetry for the\n * SDK consumer (i.e. a developer building an app with `@sanity/sdk`).\n *\n * Browser: returns true only when the URL is `localhost` or `127.0.0.1`.\n * The URL check is the primary signal because consumer bundlers may or\n * may not forward `NODE_ENV` to the browser reliably.\n *\n * Node (scripts / non-browser): falls back to `NODE_ENV === 'development'`.\n *\n * Bracket-notation `process.env['NODE_ENV']` is used to avoid bundler\n * dead-code replacement.\n *\n * @returns True if the SDK is running in a development environment\n * @internal\n */\nexport function isDevMode(): boolean {\n  if (typeof window !== 'undefined') {\n    return isLocalUrl(window)\n  }\n\n  return typeof process !== 'undefined' && process.env?.['NODE_ENV'] === 'development'\n}\n","import {defineEvent} from '@sanity/telemetry'\n\n/** @internal */\nexport const SDKDevSessionStarted = defineEvent<{\n  version: string\n  projectId: string\n  perspective: string\n  authMethod: string\n}>({\n  name: 'SDK Dev Session Started',\n  version: 1,\n  description: 'SDK instance created in development mode',\n})\n\n/** @internal */\nexport const SDKHookMounted = defineEvent<{\n  hookName: string\n}>({\n  name: 'SDK Hook Mounted',\n  version: 1,\n  description: 'An SDK hook was mounted for the first time in this session',\n})\n\n/** @internal */\nexport const SDKDevSessionEnded = defineEvent<{\n  durationSeconds: number\n  hooksUsed: string[]\n}>({\n  name: 'SDK Dev Session Ended',\n  version: 1,\n  description: 'SDK instance disposed in development mode',\n})\n\n/** @internal */\nexport const SDKDevError = defineEvent<{\n  errorType: string\n  hookName: string\n}>({\n  name: 'SDK Dev Error',\n  version: 1,\n  description: 'Runtime error caught during SDK development',\n})\n","import {type SanityInstance} from '../store/createSanityInstance'\nimport {createLogger} from '../utils/logger'\nimport {isDevMode} from './devMode'\nimport {type TelemetryManager} from './telemetryManager'\n\nconst DEFAULT_TELEMETRY_API_VERSION = '2024-11-12'\n\nconst logger = createLogger('telemetry')\n\n/**\n * Per-instance map of active telemetry managers. Allows the React\n * package (and other consumers) to look up the manager for a given\n * instance and log hook usage / errors without importing the full\n * telemetry module themselves.\n *\n * @internal\n */\nconst telemetryManagers = new WeakMap<SanityInstance, TelemetryManager>()\nconst pendingHooks = new WeakMap<SanityInstance, Set<string>>()\nconst initInFlight = new WeakSet<SanityInstance>()\n\n/**\n * Initializes dev-mode telemetry for a SDK instance if the environment\n * qualifies. Both `telemetryManager` and `clientStore` are dynamically\n * imported to avoid circular dependencies and to keep telemetry code\n * out of production bundles via code splitting.\n *\n * The `projectId` must be passed explicitly because the resource\n * configuration is typically set by the React layer after the\n * instance has already been created.\n *\n * @internal\n */\nexport function initTelemetry(instance: SanityInstance, projectId: string): void {\n  if (!isDevMode()) {\n    logger.trace('initTelemetry skipped: not dev mode', {internal: true})\n    return\n  }\n  if (!projectId) {\n    logger.trace('initTelemetry skipped: no projectId', {internal: true})\n    return\n  }\n  if (telemetryManagers.has(instance) || initInFlight.has(instance)) {\n    return\n  }\n  initInFlight.add(instance)\n\n  logger.debug('initializing telemetry', {projectId})\n\n  Promise.all([\n    import('./telemetryManager'),\n    import('../client/clientStore'),\n    import('../auth/authStore'),\n  ])\n    .then(async ([{createTelemetryManager}, {getClient}, {getTokenState}]) => {\n      if (instance.isDisposed()) {\n        initInFlight.delete(instance)\n        logger.debug('telemetry skipped: instance disposed before imports resolved')\n        return\n      }\n\n      // Wait for the auth store to resolve a token. The client needs a\n      // Bearer token for the consent check and batch POSTs. If the token\n      // is already available (e.g. static token config), this resolves\n      // immediately. For OAuth/localStorage discovery it waits for the\n      // first emission. For unauthenticated apps the promise never\n      // resolves, which is fine since telemetry requires auth anyway.\n      const token = getTokenState(instance).getCurrent()\n      logger.trace('auth token check', {tokenPresent: !!token, internal: true})\n\n      if (!token) {\n        logger.debug('waiting for auth token')\n        const hasToken = await new Promise<boolean>((resolve) => {\n          if (instance.isDisposed()) return resolve(false)\n          const cleanup = {unsubscribe: () => {}}\n          const unsub = instance.onDispose(() => {\n            cleanup.unsubscribe()\n            resolve(false)\n          })\n          const sub = getTokenState(instance).observable.subscribe((t) => {\n            if (t) {\n              logger.debug('auth token received')\n              sub.unsubscribe()\n              unsub()\n              resolve(true)\n            }\n          })\n          cleanup.unsubscribe = () => sub.unsubscribe()\n        })\n        if (!hasToken || instance.isDisposed()) {\n          initInFlight.delete(instance)\n          logger.debug('telemetry skipped: no token resolved or instance disposed')\n          return\n        }\n      }\n\n      const manager = createTelemetryManager({\n        sessionId: instance.instanceId,\n        getClient: () => getClient(instance, {apiVersion: DEFAULT_TELEMETRY_API_VERSION}),\n        projectId,\n      })\n\n      const consented = await manager.checkConsent()\n      logger.debug('consent check complete', {consented})\n      if (!consented || instance.isDisposed()) {\n        initInFlight.delete(instance)\n        manager.dispose()\n        return\n      }\n\n      initInFlight.delete(instance)\n      telemetryManagers.set(instance, manager)\n\n      const buffered = pendingHooks.get(instance)\n      if (buffered) {\n        logger.debug('flushing buffered hooks', {hooks: Array.from(buffered)})\n        for (const hookName of buffered) {\n          manager.logHookFirstUsed(hookName)\n        }\n        pendingHooks.delete(instance)\n      }\n\n      const config = instance.config\n      const perspective = typeof config.perspective === 'string' ? config.perspective : 'published'\n      const authMethod = config.auth?.token\n        ? 'token'\n        : config.studio?.auth?.token\n          ? 'studio'\n          : 'default'\n\n      logger.info('telemetry session started', {projectId, perspective, authMethod})\n      manager.logSessionStarted({\n        projectId,\n        perspective,\n        authMethod,\n      })\n\n      instance.onDispose(() => {\n        manager.endSession()\n        telemetryManagers.delete(instance)\n        logger.debug('telemetry session ended')\n      })\n    })\n    .catch((err) => {\n      initInFlight.delete(instance)\n      logger.warn('telemetry init failed', {error: err})\n    })\n}\n\n/**\n * Retrieves the telemetry manager for an instance, if one exists.\n * Returns undefined when telemetry is disabled or not yet initialized.\n *\n * @internal\n */\nexport function getTelemetryManager(instance: SanityInstance): TelemetryManager | undefined {\n  return telemetryManagers.get(instance)\n}\n\n/**\n * Record a hook name for an instance. If the telemetry manager is\n * already initialized the event is logged immediately. Otherwise\n * the name is buffered and flushed when init completes.\n *\n * @internal\n */\nexport function trackHookMounted(instance: SanityInstance, hookName: string): void {\n  if (!isDevMode()) return\n\n  const manager = findManager(instance)\n  if (manager) {\n    logger.trace('hook mounted (logged)', {hookName, internal: true})\n    manager.logHookFirstUsed(hookName)\n    return\n  }\n\n  const root = getRootInstance(instance)\n  let hooks = pendingHooks.get(root)\n  if (!hooks) {\n    hooks = new Set()\n    pendingHooks.set(root, hooks)\n  }\n  if (!hooks.has(hookName)) {\n    logger.trace('hook mounted (buffered)', {hookName, internal: true})\n  }\n  hooks.add(hookName)\n}\n\nfunction findManager(instance: SanityInstance): TelemetryManager | undefined {\n  return telemetryManagers.get(instance)\n}\n\nfunction getRootInstance(instance: SanityInstance): SanityInstance {\n  return instance\n}\n"],"names":[],"mappings":";;AAOA,SAAS,WAAW,KAAsB;AACxC,QAAM,MAAM,IAAI,UAAU;AAC1B,SAAK,MAEH,IAAI,WAAW,kBAAkB,KACjC,IAAI,WAAW,mBAAmB,KAClC,IAAI,WAAW,kBAAkB,KACjC,IAAI,WAAW,mBAAmB,IALnB;AAOnB;AAkBO,SAAS,YAAqB;AACnC,SAAI,OAAO,SAAW,MACb,WAAW,MAAM,IAGnB,OAAO,UAAY,OAAe,QAAQ,KAAM,aAAgB;AACzE;ACrCO,MAAM,uBAAuB,YAKjC;AAAA,EACD,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AACf,CAAC,GAGY,iBAAiB,YAE3B;AAAA,EACD,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AACf,CAAC,GAGY,qBAAqB,YAG/B;AAAA,EACD,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AACf,CAAC,GAGY,cAAc,YAGxB;AAAA,EACD,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AACf,CAAC,GCpCK,gCAAgC,cAEhC,SAAS,aAAa,WAAW,GAUjC,oBAAoB,oBAAI,QAAA,GACxB,eAAe,oBAAI,QAAA,GACnB,mCAAmB,QAAA;AAclB,SAAS,cAAc,UAA0B,WAAyB;AAC/E,MAAI,CAAC,aAAa;AAChB,WAAO,MAAM,uCAAuC,EAAC,UAAU,IAAK;AACpE;AAAA,EACF;AACA,MAAI,CAAC,WAAW;AACd,WAAO,MAAM,uCAAuC,EAAC,UAAU,IAAK;AACpE;AAAA,EACF;AACI,oBAAkB,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,MAGhE,aAAa,IAAI,QAAQ,GAEzB,OAAO,MAAM,0BAA0B,EAAC,WAAU,GAElD,QAAQ,IAAI;AAAA,IACV,OAAO,uBAAoB;AAAA,IAC3B,OAAO,6BAAuB,EAAA,KAAA,SAAA,GAAA;AAAA,aAAA,EAAA;AAAA,IAAA,CAAA;AAAA,IAC9B,OAAO,6BAAmB,EAAA,KAAA,SAAA,GAAA;AAAA,aAAA,EAAA;AAAA,IAAA,CAAA;AAAA,EAAA,CAC3B,EACE,KAAK,OAAO,CAAC,EAAC,uBAAA,GAAyB,EAAC,UAAA,GAAY,EAAC,cAAA,CAAc,MAAM;AACxE,QAAI,SAAS,cAAc;AACzB,mBAAa,OAAO,QAAQ,GAC5B,OAAO,MAAM,8DAA8D;AAC3E;AAAA,IACF;AAQA,UAAM,QAAQ,cAAc,QAAQ,EAAE,WAAA;AAGtC,QAFA,OAAO,MAAM,oBAAoB,EAAC,cAAc,CAAC,CAAC,OAAO,UAAU,GAAA,CAAK,GAEpE,CAAC,UACH,OAAO,MAAM,wBAAwB,GAkBjC,CAjBa,MAAM,IAAI,QAAiB,CAAC,YAAY;AACvD,UAAI,SAAS,WAAA,EAAc,QAAO,QAAQ,EAAK;AAC/C,YAAM,UAAU,EAAC,aAAa,MAAM;AAAA,MAAC,KAC/B,QAAQ,SAAS,UAAU,MAAM;AACrC,gBAAQ,YAAA,GACR,QAAQ,EAAK;AAAA,MACf,CAAC,GACK,MAAM,cAAc,QAAQ,EAAE,WAAW,UAAU,CAAC,MAAM;AAC1D,cACF,OAAO,MAAM,qBAAqB,GAClC,IAAI,YAAA,GACJ,MAAA,GACA,QAAQ,EAAI;AAAA,MAEhB,CAAC;AACD,cAAQ,cAAc,MAAM,IAAI,YAAA;AAAA,IAClC,CAAC,KACgB,SAAS,WAAA,IAAc;AACtC,mBAAa,OAAO,QAAQ,GAC5B,OAAO,MAAM,2DAA2D;AACxE;AAAA,IACF;AAGF,UAAM,UAAU,uBAAuB;AAAA,MACrC,WAAW,SAAS;AAAA,MACpB,WAAW,MAAM,UAAU,UAAU,EAAC,YAAY,+BAA8B;AAAA,MAChF;AAAA,IAAA,CACD,GAEK,YAAY,MAAM,QAAQ,aAAA;AAEhC,QADA,OAAO,MAAM,0BAA0B,EAAC,WAAU,GAC9C,CAAC,aAAa,SAAS,cAAc;AACvC,mBAAa,OAAO,QAAQ,GAC5B,QAAQ,QAAA;AACR;AAAA,IACF;AAEA,iBAAa,OAAO,QAAQ,GAC5B,kBAAkB,IAAI,UAAU,OAAO;AAEvC,UAAM,WAAW,aAAa,IAAI,QAAQ;AAC1C,QAAI,UAAU;AACZ,aAAO,MAAM,2BAA2B,EAAC,OAAO,MAAM,KAAK,QAAQ,GAAE;AACrE,iBAAW,YAAY;AACrB,gBAAQ,iBAAiB,QAAQ;AAEnC,mBAAa,OAAO,QAAQ;AAAA,IAC9B;AAEA,UAAM,SAAS,SAAS,QAClB,cAAc,OAAO,OAAO,eAAgB,WAAW,OAAO,cAAc,aAC5E,aAAa,OAAO,MAAM,QAC5B,UACA,OAAO,QAAQ,MAAM,QACnB,WACA;AAEN,WAAO,KAAK,6BAA6B,EAAC,WAAW,aAAa,WAAA,CAAW,GAC7E,QAAQ,kBAAkB;AAAA,MACxB;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD,GAED,SAAS,UAAU,MAAM;AACvB,cAAQ,WAAA,GACR,kBAAkB,OAAO,QAAQ,GACjC,OAAO,MAAM,yBAAyB;AAAA,IACxC,CAAC;AAAA,EACH,CAAC,EACA,MAAM,CAAC,QAAQ;AACd,iBAAa,OAAO,QAAQ,GAC5B,OAAO,KAAK,yBAAyB,EAAC,OAAO,KAAI;AAAA,EACnD,CAAC;AACL;AAQO,SAAS,oBAAoB,UAAwD;AAC1F,SAAO,kBAAkB,IAAI,QAAQ;AACvC;AASO,SAAS,iBAAiB,UAA0B,UAAwB;AACjF,MAAI,CAAC,YAAa;AAElB,QAAM,UAAU,YAAY,QAAQ;AACpC,MAAI,SAAS;AACX,WAAO,MAAM,yBAAyB,EAAC,UAAU,UAAU,IAAK,GAChE,QAAQ,iBAAiB,QAAQ;AACjC;AAAA,EACF;AAEA,QAAM,OAAuB;AAC7B,MAAI,QAAQ,aAAa,IAAI,IAAI;AAC5B,YACH,QAAQ,oBAAI,IAAA,GACZ,aAAa,IAAI,MAAM,KAAK,IAEzB,MAAM,IAAI,QAAQ,KACrB,OAAO,MAAM,2BAA2B,EAAC,UAAU,UAAU,IAAK,GAEpE,MAAM,IAAI,QAAQ;AACpB;AAEA,SAAS,YAAY,UAAwD;AAC3E,SAAO,kBAAkB,IAAI,QAAQ;AACvC;"}

package/dist/_chunks-es/createGroqSearchFilter.js

@@ -1039,12 +1039,9 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
       );
     }
     const tokenFromState = state.get().token, { clients, authMethod } = state.get();
-    let resource;
-    options.resource && (isDatasetResource(options.resource) ? resource = {
-      type: "dataset",
-      id: `${options.resource.projectId}.${options.resource.dataset}`
-    } : isMediaLibraryResource(options.resource) ? resource = { type: "media-library", id: options.resource.mediaLibraryId } : isCanvasResource(options.resource) && (resource = { type: "canvas", id: options.resource.canvasId }));
-    const projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost ?? getStagingApiHost(), effectiveOptions = {
+    let projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, resource;
+    options.resource && (isMediaLibraryResource(options.resource) ? resource = { type: "media-library", id: options.resource.mediaLibraryId } : isCanvasResource(options.resource) ? resource = { type: "canvas", id: options.resource.canvasId } : isDatasetResource(options.resource) && (projectId = options.resource.projectId, dataset = options.resource.dataset));
+    const apiHost = options.apiHost ?? instance.config.auth?.apiHost ?? getStagingApiHost(), effectiveOptions = {
       ...DEFAULT_CLIENT_CONFIG,
       ...(options.scope === "global" || !projectId || resource) && { useProjectHostname: !1 },
       token: authMethod === "cookie" ? void 0 : tokenFromState ?? void 0,
@@ -1054,9 +1051,7 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
       ...resource ? { resource } : { resource: void 0 },
       ...apiHost && { apiHost }
     };
-    resource && ((options.projectId || options.dataset) && console.warn(
-      "Both resource and explicit projectId/dataset are provided. The resource will be used and projectId/dataset will be ignored."
-    ), delete effectiveOptions.projectId, delete effectiveOptions.dataset), effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
+    resource && (delete effectiveOptions.projectId, delete effectiveOptions.dataset), effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
     const key = getClientConfigKey(effectiveOptions);
     if (clients[key]) return clients[key];
     const client = createClient(effectiveOptions);
@@ -1153,7 +1148,7 @@ const ARCHIVED_RELEASE_STATES = ["archived", "published"], STABLE_EMPTY_RELEASES
   const { observable: releases$ } = getQueryState(instance, {
     query: RELEASES_QUERY,
     perspective: "raw",
-    resource: resource && !isDatasetResource(resource) ? resource : void 0,
+    resource,
     tag: "releases"
   });
   return releases$.pipe(
@@ -1304,8 +1299,7 @@ const queryStore = {
 }) => {
   const liveMessages$ = getClientState(instance, {
     apiVersion: QUERY_STORE_API_VERSION,
-    // temporary guard here until we're ready for everything to be queried via global api
-    ...resource && !isDatasetResource(resource) ? { resource } : {}
+    resource
   }).observable.pipe(
     switchMap(
       (client) => defer(
@@ -1433,8 +1427,7 @@ function findFirstDefined(fieldsToSearch, candidates, exclude) {
 function transformProjectionToPreview(instance, projectionResult, resource) {
   const title = findFirstDefined(TITLE_CANDIDATES, projectionResult.titleCandidates), subtitle = findFirstDefined(SUBTITLE_CANDIDATES, projectionResult.subtitleCandidates, title), client = getClient(instance, {
     apiVersion: API_VERSION,
-    // TODO: remove in v3 when we're ready for everything to be queried via resource
-    resource: resource && !isDatasetResource(resource) ? resource : void 0
+    resource
   });
   return {
     title: String(title || `${projectionResult._type}: ${projectionResult._id}`),