@sanity/sdk 2.8.0 → 3.0.0-rc.0

package/dist/index.js

@@ -17,15 +17,17 @@ import { isKeySegment, isKeyedObject } from "@sanity/types";
 import { createDocumentLoaderFromClient } from "@sanity/mutate/_unstable_store";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { fromUrl } from "@sanity/bifur-client";
+import { createImageUrlBuilder } from "@sanity/image-url";
 import { DocumentId, getPublishedId as getPublishedId$2, getDraftId as getDraftId$1, getVersionId, isDraftId, isVersionId, isPublishedId } from "@sanity/id-utils";
-function isDatasetSource(source) {
-  return "projectId" in source && "dataset" in source;
+const DEFAULT_RESOURCE_NAME = "default";
+function isDatasetResource(resource) {
+  return "projectId" in resource && "dataset" in resource;
 }
-function isMediaLibrarySource(source) {
-  return "mediaLibraryId" in source;
+function isMediaLibraryResource(resource) {
+  return "mediaLibraryId" in resource;
 }
-function isCanvasSource(source) {
-  return "canvasId" in source;
+function isCanvasResource(resource) {
+  return "canvasId" in resource;
 }
 const isReleasePerspective = (perspective) => typeof perspective == "object" && perspective !== null && "releaseName" in perspective;
 function getPublishedId(id) {
@@ -154,27 +156,19 @@ function createLogger(namespace, baseContext) {
   };
 }
 function createSanityInstance(config = {}) {
-  const instanceId = crypto.randomUUID(), disposeListeners = /* @__PURE__ */ new Map(), disposed = { current: !1 }, instanceContext = {
-    instanceId,
-    projectId: config.projectId,
-    dataset: config.dataset
-  }, logger = createLogger("sdk", { instanceContext });
-  logger.info("Sanity instance created", {
-    hasProjectId: !!config.projectId,
-    hasDataset: !!config.dataset,
+  const instanceId = crypto.randomUUID(), disposeListeners = /* @__PURE__ */ new Map(), disposed = { current: !1 }, logger = createLogger("sdk", { instanceContext: {
+    instanceId
+  } });
+  return logger.info("Sanity instance created", {
     hasAuth: !!config.auth,
     hasPerspective: !!config.perspective
   }), logger.debug("Instance configuration", {
-    projectId: config.projectId,
-    dataset: config.dataset,
     perspective: config.perspective,
     hasStudioConfig: !!config.studio,
     hasStudioTokenSource: !!config.studio?.auth?.token,
-    legacyStudioMode: config.studioMode?.enabled,
     hasAuthProviders: !!config.auth?.providers,
     hasAuthToken: !!config.auth?.token
-  });
-  const instance = {
+  }), {
     instanceId,
     config,
     isDisposed: () => disposed.current,
@@ -193,39 +187,8 @@ function createSanityInstance(config = {}) {
       return disposeListeners.set(listenerId, cb), () => {
         disposeListeners.delete(listenerId);
       };
-    },
-    getParent: () => {
-    },
-    createChild: (next) => {
-      logger.debug("Creating child instance", {
-        parentInstanceId: instanceId.slice(0, 8),
-        overridingProjectId: !!next.projectId,
-        overridingDataset: !!next.dataset,
-        overridingAuth: !!next.auth
-      });
-      const child = Object.assign(
-        createSanityInstance({
-          ...config,
-          ...next,
-          ...config.auth === next.auth ? config.auth : config.auth && next.auth && { auth: { ...config.auth, ...next.auth } }
-        }),
-        { getParent: () => instance }
-      );
-      return logger.trace("Child instance created", {
-        internal: !0,
-        childInstanceId: child.instanceId.slice(0, 8)
-      }), child;
-    },
-    match: (targetConfig) => {
-      if (Object.entries(pick(targetConfig, "auth", "projectId", "dataset")).every(
-        ([key, value]) => config[key] === value
-      ))
-        return instance;
-      const parent = instance.getParent();
-      if (parent) return parent.match(targetConfig);
     }
   };
-  return instance;
 }
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
@@ -278,36 +241,35 @@ function createActionBinder(keyFn) {
     };
   };
 }
-const bindActionByDataset = createActionBinder((instance, options) => {
-  const projectId = options?.projectId ?? instance.config.projectId, dataset = options?.dataset ?? instance.config.dataset;
-  if (!projectId || !dataset)
-    throw new Error("This API requires a project ID and dataset configured.");
-  return { name: `${projectId}.${dataset}`, projectId, dataset };
-}), createSourceKey = (instance, source) => {
-  let name, sourceForKey;
-  if (source) {
-    if (sourceForKey = source, isDatasetSource(source))
-      name = `${source.projectId}.${source.dataset}`;
-    else if (isMediaLibrarySource(source))
-      name = `media-library:${source.mediaLibraryId}`;
-    else if (isCanvasSource(source))
-      name = `canvas:${source.canvasId}`;
-    else
-      throw new Error(`Received invalid source: ${JSON.stringify(source)}`);
-    return { name, source: sourceForKey };
-  }
-  const { projectId, dataset } = instance.config;
-  if (!projectId || !dataset)
-    throw new Error("This API requires a project ID and dataset configured.");
-  return { name: `${projectId}.${dataset}`, source: { projectId, dataset } };
-}, bindActionBySource = createActionBinder((instance, { source }) => createSourceKey(instance, source)), bindActionBySourceAndPerspective = createActionBinder((instance, options) => {
-  const { source, perspective } = options, utilizedPerspective = perspective ?? instance.config.perspective ?? "drafts";
+const resourceKeyName = (resource) => {
+  if (isDatasetResource(resource)) return `${resource.projectId}.${resource.dataset}`;
+  if (isMediaLibraryResource(resource)) return `media-library:${resource.mediaLibraryId}`;
+  if (isCanvasResource(resource)) return `canvas:${resource.canvasId}`;
+  throw new Error(`Received invalid resource: ${JSON.stringify(resource)}`);
+}, createResourceKey = (instance, resource) => {
+  if (resource)
+    return { name: resourceKeyName(resource), resource };
+  const defaultResource = instance.config.defaultResource;
+  if (!defaultResource)
+    throw new Error(
+      'No resource provided and no default resource configured. Provide a "default" resource in your resources map, or pass an explicit resource.'
+    );
+  return { name: resourceKeyName(defaultResource), resource: defaultResource };
+}, bindActionByResource = createActionBinder((instance, { resource }) => createResourceKey(instance, resource)), bindActionByResourceAndPerspective = createActionBinder((instance, options) => {
+  const { resource, perspective } = options, utilizedPerspective = perspective ?? instance.config.perspective ?? "drafts";
   let perspectiveKey;
-  isReleasePerspective(utilizedPerspective) ? perspectiveKey = utilizedPerspective.releaseName : typeof utilizedPerspective == "string" ? perspectiveKey = utilizedPerspective : perspectiveKey = JSON.stringify(utilizedPerspective);
-  const sourceKey = createSourceKey(instance, source);
+  if (isReleasePerspective(utilizedPerspective))
+    perspectiveKey = utilizedPerspective.releaseName;
+  else if (typeof utilizedPerspective == "string")
+    perspectiveKey = utilizedPerspective;
+  else
+    throw new Error(
+      `Stackable perspectives are not supported. Received perspective: ${JSON.stringify(utilizedPerspective)}`
+    );
+  const resourceKey = createResourceKey(instance, resource);
   return {
-    name: `${sourceKey.name}:${perspectiveKey}`,
-    source: sourceKey.source,
+    name: `${resourceKey.name}:${perspectiveKey}`,
+    resource: resourceKey.resource,
     perspective: utilizedPerspective
   };
 }), bindActionGlobally = createActionBinder((..._rest) => ({ name: "global" }));
@@ -363,7 +325,7 @@ function resolveAuthMode(config, locationHref) {
   return isStudioConfig(config) ? "studio" : detectDashboardContext(locationHref) ? "dashboard" : "standalone";
 }
 function isStudioConfig(config) {
-  return !!config.studio || !!config.studioMode?.enabled;
+  return !!config.studio;
 }
 function detectDashboardContext(locationHref) {
   try {
@@ -540,7 +502,7 @@ const refreshStampedToken = ({ state }) => {
     }
   });
 }, subscribeToStateAndFetchCurrentUser = ({ state, instance }, fetchOptions) => {
-  const { clientFactory, apiHost } = state.get().options, useProjectHostname = fetchOptions?.useProjectHostname ?? isStudioConfig(instance.config), projectId = instance.config.projectId;
+  const { clientFactory, apiHost } = state.get().options, useProjectHostname = fetchOptions?.useProjectHostname ?? isStudioConfig(instance.config), projectId = instance.config.studio?.projectId;
   return state.observable.pipe(
     map(({ authState, options: storeOptions }) => ({
       authState,
@@ -581,6 +543,15 @@ const refreshStampedToken = ({ state }) => {
     }
   });
 };
+function createLoggedInAuthState(token, currentUser, existingLastTokenRefresh) {
+  const isStampedToken = token.includes("-st"), lastTokenRefresh = existingLastTokenRefresh ?? (isStampedToken ? Date.now() : void 0);
+  return {
+    type: AuthStateType.LOGGED_IN,
+    token,
+    currentUser,
+    ...lastTokenRefresh !== void 0 && { lastTokenRefresh }
+  };
+}
 function getAuthCode(callbackUrl, locationHref) {
   const loc = new URL(locationHref, DEFAULT_BASE), callbackLocation = callbackUrl ? new URL(callbackUrl, DEFAULT_BASE) : void 0, callbackLocationMatches = callbackLocation ? loc.pathname.toLowerCase().startsWith(callbackLocation.pathname.toLowerCase()) : !0;
   let authCode = new URLSearchParams(loc.hash.slice(1)).get(AUTH_CODE_PARAM) || new URLSearchParams(loc.search).get(AUTH_CODE_PARAM);
@@ -670,7 +641,7 @@ function parseDashboardContext(locationHref) {
 function getDashboardInitialState(options) {
   const { authConfig, initialLocationHref } = options, providedToken = authConfig.token, callbackUrl = authConfig.callbackUrl, storageKey = "__sanity_auth_token", dashboardContext = parseDashboardContext(initialLocationHref), storageArea = void 0;
   return providedToken ? {
-    authState: { type: AuthStateType.LOGGED_IN, token: providedToken, currentUser: null },
+    authState: createLoggedInAuthState(providedToken, null),
     storageKey,
     storageArea,
     authMethod: void 0,
@@ -712,7 +683,7 @@ const subscribeToStorageEventsAndSetToken = ({
     distinctUntilChanged()
   ).subscribe((token) => {
     state.set("updateTokenFromStorageEvent", {
-      authState: token ? { type: AuthStateType.LOGGED_IN, token, currentUser: null } : { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
+      authState: token ? createLoggedInAuthState(token, null) : { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
     });
   });
 };
@@ -720,7 +691,7 @@ function getStandaloneInitialState(options) {
   const { authConfig, initialLocationHref } = options, providedToken = authConfig.token, callbackUrl = authConfig.callbackUrl, storageKey = "__sanity_auth_token", storageArea = authConfig.storageArea ?? getDefaultStorage();
   if (providedToken)
     return {
-      authState: { type: AuthStateType.LOGGED_IN, token: providedToken, currentUser: null },
+      authState: createLoggedInAuthState(providedToken, null),
       storageKey,
       storageArea,
       authMethod: void 0,
@@ -736,7 +707,7 @@ function getStandaloneInitialState(options) {
     };
   const token = getTokenFromStorage(storageArea, storageKey);
   return token ? {
-    authState: { type: AuthStateType.LOGGED_IN, token, currentUser: null },
+    authState: createLoggedInAuthState(token, null),
     storageKey,
     storageArea,
     authMethod: "localstorage",
@@ -796,13 +767,13 @@ function getStudioInitialState(options) {
   let authMethod;
   const token = getStudioTokenFromLocalStorage(storageArea, studioStorageKey);
   return token && (authMethod = "localstorage"), providedToken ? {
-    authState: { type: AuthStateType.LOGGED_IN, token: providedToken, currentUser: null },
+    authState: createLoggedInAuthState(providedToken, null),
     storageKey: studioStorageKey,
     storageArea,
     authMethod,
     dashboardContext: {}
   } : token ? {
-    authState: { type: AuthStateType.LOGGED_IN, token, currentUser: null },
+    authState: createLoggedInAuthState(token, null),
     storageKey: studioStorageKey,
     storageArea,
     authMethod: "localstorage",
@@ -820,14 +791,17 @@ function initializeStudioAuth(context, tokenRefresherRunning2) {
   return tokenSource ? initializeWithTokenSource(context, tokenSource) : initializeWithFallback(context, tokenRefresherRunning2);
 }
 function initializeWithTokenSource(context, tokenSource) {
-  const subscriptions = [];
+  const subscriptions = [], studioAuthenticated = context.instance.config.studio?.authenticated === !0;
   subscriptions.push(subscribeToStateAndFetchCurrentUser(context, { useProjectHostname: !0 }));
   const tokenSub = tokenSource.subscribe({
     next: (token) => {
       const { state } = context;
       token ? state.set("studioTokenSource", (prev) => ({
         options: { ...prev.options, authMethod: void 0 },
-        authState: { type: AuthStateType.LOGGED_IN, token, currentUser: null }
+        authState: createLoggedInAuthState(token, null)
+      })) : studioAuthenticated ? state.set("studioTokenSourceCookieAuth", (prev) => ({
+        options: { ...prev.options, authMethod: "cookie" },
+        authState: prev.authState.type === AuthStateType.LOGGED_IN ? prev.authState : createLoggedInAuthState("", null)
       })) : state.set("studioTokenSourceLoggedOut", (prev) => ({
         options: { ...prev.options, authMethod: void 0 },
         authState: { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
@@ -851,11 +825,11 @@ function initializeWithFallback(context, tokenRefresherRunning2) {
   try {
     const { instance, state } = context;
     if (!(state.get().authState?.type === AuthStateType.LOGGED_IN && state.get().authState.token)) {
-      const projectIdValue = instance.config.projectId, clientFactory = state.get().options.clientFactory;
+      const projectIdValue = instance.config.studio?.projectId, clientFactory = state.get().options.clientFactory;
       checkForCookieAuth(projectIdValue, clientFactory).then((isCookieAuthEnabled) => {
         isCookieAuthEnabled && state.set("enableCookieAuth", (prev) => ({
           options: { ...prev.options, authMethod: "cookie" },
-          authState: prev.authState.type === AuthStateType.LOGGED_IN ? prev.authState : { type: AuthStateType.LOGGED_IN, token: "", currentUser: null }
+          authState: prev.authState.type === AuthStateType.LOGGED_IN ? prev.authState : createLoggedInAuthState("", null)
         }));
       });
     }
@@ -890,7 +864,7 @@ const authStore = {
     loginUrl.searchParams.set("origin", getCleanedUrl(initialLocationHref)), loginUrl.searchParams.set("type", "stampedToken"), loginUrl.searchParams.set("withSid", "true");
     const mode = resolveAuthMode(instance.config, initialLocationHref), strategyOptions = {
       authConfig,
-      projectId: instance.config.projectId,
+      projectId: instance.config.studio?.projectId,
       initialLocationHref,
       tokenSource: instance.config.studio?.auth?.token
     };
@@ -971,17 +945,17 @@ const authStore = {
   )
 ), setAuthToken = bindActionGlobally(authStore, ({ state }, token) => {
   const currentAuthState = state.get().authState;
-  token ? (currentAuthState.type !== AuthStateType.LOGGED_IN || currentAuthState.token !== token) && state.set("setToken", {
-    authState: {
-      type: AuthStateType.LOGGED_IN,
-      token,
-      // Keep existing user or set to null? Setting to null forces refetch.
-      // Keep existing user to avoid unnecessary refetches if user data is still valid.
-      currentUser: currentAuthState.type === AuthStateType.LOGGED_IN ? currentAuthState.currentUser : null
+  if (token) {
+    if (currentAuthState.type !== AuthStateType.LOGGED_IN || currentAuthState.token !== token) {
+      const currentUser = currentAuthState.type === AuthStateType.LOGGED_IN ? currentAuthState.currentUser : null, preservedLastTokenRefresh = currentAuthState.type === AuthStateType.LOGGED_IN ? currentAuthState.lastTokenRefresh : void 0;
+      state.set("setToken", {
+        authState: createLoggedInAuthState(token, currentUser, preservedLastTokenRefresh)
+      });
     }
-  }) : currentAuthState.type !== AuthStateType.LOGGED_OUT && state.set("setToken", {
-    authState: { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
-  });
+  } else
+    currentAuthState.type !== AuthStateType.LOGGED_OUT && state.set("setToken", {
+      authState: { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
+    });
 }), DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
   apiHost: null,
   useCdn: null,
@@ -998,7 +972,7 @@ const authStore = {
   requestTagPrefix: null,
   useProjectHostname: null,
   "~experimental_resource": null,
-  source: null
+  resource: null
 }), DEFAULT_CLIENT_CONFIG = {
   apiVersion: DEFAULT_API_VERSION,
   useCdn: !1,
@@ -1036,9 +1010,9 @@ const authStore = {
       );
     }
     const tokenFromState = state.get().token, { clients, authMethod } = state.get();
-    let resource;
-    options.source && (isDatasetSource(options.source) ? resource = { type: "dataset", id: `${options.source.projectId}.${options.source.dataset}` } : isMediaLibrarySource(options.source) ? resource = { type: "media-library", id: options.source.mediaLibraryId } : isCanvasSource(options.source) && (resource = { type: "canvas", id: options.source.canvasId }));
-    const projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
+    let resource, projectId = options.projectId, dataset = options.dataset;
+    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, effectiveOptions = {
       ...DEFAULT_CLIENT_CONFIG,
       ...(options.scope === "global" || !projectId || resource) && { useProjectHostname: !1 },
       token: authMethod === "cookie" ? void 0 : tokenFromState ?? void 0,
@@ -1048,52 +1022,52 @@ const authStore = {
       ...apiHost && { apiHost },
       ...resource && { "~experimental_resource": resource }
     };
-    resource && ((options.projectId || options.dataset) && console.warn(
-      "Both source and explicit projectId/dataset are provided. The source 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;
-    const key = getClientConfigKey(effectiveOptions);
+    options.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."
+    ), 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 { resource: _omitResource, ...clientConfig } = effectiveOptions, key = getClientConfigKey(effectiveOptions);
     if (clients[key]) return clients[key];
-    const client = createClient(effectiveOptions);
+    const client = createClient(clientConfig);
     return state.set("addClient", (prev) => ({ clients: { ...prev.clients, [key]: client } })), client;
   }
 ), getClientState = bindActionGlobally(
   clientStore,
   createStateSourceAction(({ instance }, options) => getClient(instance, options))
-), API_VERSION$6 = "vX";
+), API_VERSION$7 = "vX";
 function agentGenerate(instance, options) {
+  const { resource, ...agentOptions } = options;
   return getClientState(instance, {
-    apiVersion: API_VERSION$6,
-    projectId: instance.config.projectId,
-    dataset: instance.config.dataset
-  }).observable.pipe(switchMap((client) => client.observable.agent.action.generate(options)));
+    apiVersion: API_VERSION$7,
+    resource
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.generate(agentOptions)));
 }
 function agentTransform(instance, options) {
+  const { resource, ...agentOptions } = options;
   return getClientState(instance, {
-    apiVersion: API_VERSION$6,
-    projectId: instance.config.projectId,
-    dataset: instance.config.dataset
-  }).observable.pipe(switchMap((client) => client.observable.agent.action.transform(options)));
+    apiVersion: API_VERSION$7,
+    resource
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.transform(agentOptions)));
 }
 function agentTranslate(instance, options) {
+  const { resource, ...agentOptions } = options;
   return getClientState(instance, {
-    apiVersion: API_VERSION$6,
-    projectId: instance.config.projectId,
-    dataset: instance.config.dataset
-  }).observable.pipe(switchMap((client) => client.observable.agent.action.translate(options)));
+    apiVersion: API_VERSION$7,
+    resource
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.translate(agentOptions)));
 }
 function agentPrompt(instance, options) {
+  const { resource, ...agentOptions } = options;
   return getClientState(instance, {
-    apiVersion: API_VERSION$6,
-    projectId: instance.config.projectId,
-    dataset: instance.config.dataset
-  }).observable.pipe(switchMap((client) => from(client.agent.action.prompt(options))));
+    apiVersion: API_VERSION$7,
+    resource
+  }).observable.pipe(switchMap((client) => from(client.agent.action.prompt(agentOptions))));
 }
 function agentPatch(instance, options) {
+  const { resource, ...agentOptions } = options;
   return getClientState(instance, {
-    apiVersion: API_VERSION$6,
-    projectId: instance.config.projectId,
-    dataset: instance.config.dataset
-  }).observable.pipe(switchMap((client) => from(client.agent.action.patch(options))));
+    apiVersion: API_VERSION$7,
+    resource
+  }).observable.pipe(switchMap((client) => from(client.agent.action.patch(agentOptions))));
 }
 function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
   return projectOrganizationId !== currentDashboardOrgId ? {
@@ -1233,28 +1207,21 @@ function createFetcherStore({
   );
   return { getState, resolveState };
 }
-const API_VERSION$5 = "v2025-02-19", project = createFetcherStore({
+const API_VERSION$6 = "v2025-02-19", project = createFetcherStore({
   name: "Project",
-  getKey: (instance, options) => {
-    const projectId = options?.projectId ?? instance.config.projectId;
+  getKey: (_instance, options) => {
+    const projectId = options?.projectId;
     if (!projectId)
       throw new Error("A projectId is required to use the project API.");
     return projectId;
   },
-  fetcher: (instance) => (options = {}) => {
-    const projectId = options.projectId ?? instance.config.projectId;
+  fetcher: (instance) => (options) => {
+    const projectId = options.projectId;
     return getClientState(instance, {
-      apiVersion: API_VERSION$5,
+      apiVersion: API_VERSION$6,
       scope: "global",
       projectId
-    }).observable.pipe(
-      switchMap(
-        (client) => client.observable.projects.getById(
-          // non-null assertion is fine with the above throwing
-          projectId ?? instance.config.projectId
-        )
-      )
-    );
+    }).observable.pipe(switchMap((client) => client.observable.projects.getById(projectId)));
   }
 }), getProjectState = project.getState, resolveProject = project.resolveState, getDashboardOrganizationId = bindActionGlobally(
   authStore,
@@ -1299,7 +1266,7 @@ const handleAuthCallback = bindActionGlobally(
     const cleanedUrl = getCleanedUrl(locationHref), tokenFromUrl = getTokenFromLocation(locationHref);
     if (tokenFromUrl)
       return state.set("setTokenFromUrl", {
-        authState: { type: AuthStateType.LOGGED_IN, token: tokenFromUrl, currentUser: null }
+        authState: createLoggedInAuthState(tokenFromUrl, null)
       }), cleanedUrl;
     const authCode = getAuthCode(callbackUrl, locationHref);
     if (!authCode) return !1;
@@ -1331,7 +1298,7 @@ const handleAuthCallback = bindActionGlobally(
         query: { sid: authCode },
         tag: "fetch-token"
       });
-      return storageArea?.setItem(storageKey, JSON.stringify({ token })), state.set("setToken", { authState: { type: AuthStateType.LOGGED_IN, token, currentUser: null } }), cleanedUrl;
+      return storageArea?.setItem(storageKey, JSON.stringify({ token })), state.set("setToken", { authState: createLoggedInAuthState(token, null) }), cleanedUrl;
     } catch (error) {
       return state.set("exchangeSessionForTokenError", { authState: { type: AuthStateType.ERROR, error } }), cleanedUrl;
     }
@@ -1500,10 +1467,7 @@ function createDocumentHandle(handle) {
 function createDocumentTypeHandle(handle) {
   return handle;
 }
-function createProjectHandle(handle) {
-  return handle;
-}
-function createDatasetHandle(handle) {
+function createResourceHandle(handle) {
   return handle;
 }
 function configureLogging(config) {
@@ -1521,18 +1485,12 @@ function configureLogging(config) {
     source: "programmatic"
   });
 }
-const API_VERSION$4 = "v2025-02-19", datasets = createFetcherStore({
+const API_VERSION$5 = "v2025-02-19", datasets = createFetcherStore({
   name: "Datasets",
-  getKey: (instance, options) => {
-    const projectId = options?.projectId ?? instance.config.projectId;
-    if (!projectId)
-      throw new Error("A projectId is required to use the project API.");
-    return projectId;
-  },
+  getKey: (_instance, options) => options.projectId,
   fetcher: (instance) => (options) => getClientState(instance, {
-    apiVersion: API_VERSION$4,
-    // non-null assertion is fine because we check above
-    projectId: options?.projectId ?? instance.config.projectId,
+    apiVersion: API_VERSION$5,
+    projectId: options.projectId,
     useProjectHostname: !0
   }).observable.pipe(switchMap((client) => client.observable.datasets.list()))
 }), getDatasetsState = datasets.getState, resolveDatasets = datasets.resolveState, isSanityMutatePatch = (value) => !(typeof value != "object" || !value || !("type" in value) || typeof value.type != "string" || value.type !== "patch" || !("id" in value) || typeof value.id != "string" || !("patches" in value) || !Array.isArray(value.patches));
@@ -1598,7 +1556,7 @@ function discardDocument(doc) {
     documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
   };
 }
-const DOCUMENT_STATE_CLEAR_DELAY = 1e3, INITIAL_OUTGOING_THROTTLE_TIME = 1e3, API_VERSION$3 = "v2025-05-06";
+const DOCUMENT_STATE_CLEAR_DELAY = 1e3, INITIAL_OUTGOING_THROTTLE_TIME = 1e3, API_VERSION$4 = "v2025-05-06";
 function generateArrayKey(length = 12) {
   const numBytes = Math.ceil(length / 2), bytes = crypto.getRandomValues(new Uint8Array(numBytes));
   return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("").slice(0, length);
@@ -2923,10 +2881,11 @@ function getDocumentEvents(outgoing) {
     )
   );
 }
-const API_VERSION$2 = "v2025-05-06";
-function createSharedListener(instance) {
+const API_VERSION$3 = "v2025-05-06";
+function createSharedListener(instance, resource) {
   const dispose$ = new Subject(), events$ = getClientState(instance, {
-    apiVersion: API_VERSION$2
+    apiVersion: API_VERSION$3,
+    ...resource ? { resource } : {}
   }).observable.pipe(
     switchMap(
       (client) => (
@@ -2960,9 +2919,9 @@ function createSharedListener(instance) {
     dispose: () => dispose$.next()
   };
 }
-function createFetchDocument(instance) {
+function createFetchDocument(instance, resource) {
   return function(documentId) {
-    return getClientState(instance, { apiVersion: API_VERSION$2 }).observable.pipe(
+    return getClientState(instance, { apiVersion: API_VERSION$3, resource }).observable.pipe(
       switchMap((client) => createDocumentLoaderFromClient(client)(documentId)),
       map((result) => {
         if (!result.accessible) {
@@ -2977,13 +2936,13 @@ function createFetchDocument(instance) {
 }
 const documentStore = {
   name: "Document",
-  getInitialState: (instance) => ({
+  getInitialState: (instance, { resource }) => ({
     documentStates: {},
     // these can be emptied on refetch
     queued: [],
     applied: [],
-    sharedListener: createSharedListener(instance),
-    fetchDocument: createFetchDocument(instance),
+    sharedListener: createSharedListener(instance, resource),
+    fetchDocument: createFetchDocument(instance, resource),
     events: new Subject()
   }),
   initialize(context) {
@@ -3001,7 +2960,7 @@ const documentStore = {
 function getDocumentState(...args) {
   return _getDocumentState(...args);
 }
-const _getDocumentState = bindActionByDataset(
+const _getDocumentState = bindActionByResource(
   documentStore,
   createStateSourceAction({
     selector: ({ state: { error, documentStates } }, options) => {
@@ -3031,7 +2990,7 @@ const _getDocumentState = bindActionByDataset(
 function resolveDocument(...args) {
   return _resolveDocument(...args);
 }
-const _resolveDocument = bindActionByDataset(
+const _resolveDocument = bindActionByResource(
   documentStore,
   ({ instance }, docHandle) => firstValueFrom(
     getDocumentState(instance, {
@@ -3039,7 +2998,7 @@ const _resolveDocument = bindActionByDataset(
       path: void 0
     }).observable.pipe(filter((i) => i !== void 0))
   )
-), getDocumentSyncStatus = bindActionByDataset(
+), getDocumentSyncStatus = bindActionByResource(
   documentStore,
   createStateSourceAction({
     selector: ({ state: { error, documentStates: documents, outgoing, applied, queued } }, doc) => {
@@ -3053,24 +3012,26 @@ const _resolveDocument = bindActionByDataset(
     },
     onSubscribe: (context, doc) => manageSubscriberIds(context, doc.documentId)
   })
-), getPermissionsState = bindActionByDataset(
+), getPermissionsState = bindActionByResource(
   documentStore,
   createStateSourceAction({
     selector: calculatePermissions,
     onSubscribe: (context, { actions }) => manageSubscriberIds(context, getDocumentIdsFromActions(actions))
   })
-), resolvePermissions = bindActionByDataset(
+), resolvePermissions = bindActionByResource(
   documentStore,
   ({ instance }, options) => firstValueFrom(
     getPermissionsState(instance, options).observable.pipe(filter((i) => i !== void 0))
   )
-), subscribeDocumentEvents = bindActionByDataset(
+), subscribeDocumentEvents = bindActionByResource(
   documentStore,
-  ({ state }, eventHandler) => {
-    const { events } = state.get(), subscription = events.subscribe(eventHandler);
+  ({ state }, options) => {
+    const { events } = state.get(), subscription = events.subscribe(options.eventHandler);
     return () => subscription.unsubscribe();
   }
-), subscribeToQueuedAndApplyNextTransaction = ({ state }) => {
+), subscribeToQueuedAndApplyNextTransaction = ({
+  state
+}) => {
   const { events } = state.get();
   return state.observable.pipe(
     map(applyFirstQueuedTransaction),
@@ -3093,7 +3054,8 @@ const _resolveDocument = bindActionByDataset(
   ).subscribe({ error: (error) => state.set("setError", { error }) });
 }, subscribeToAppliedAndSubmitNextTransaction = ({
   state,
-  instance
+  instance,
+  key: { resource }
 }) => {
   const { events } = state.get();
   return state.observable.pipe(
@@ -3113,7 +3075,12 @@ const _resolveDocument = bindActionByDataset(
     tap$1((next) => state.set("transitionAppliedTransactionsToOutgoing", next)),
     map((s) => s.outgoing),
     distinctUntilChanged(),
-    withLatestFrom(getClientState(instance, { apiVersion: API_VERSION$3 }).observable),
+    withLatestFrom(
+      getClientState(instance, {
+        apiVersion: API_VERSION$4,
+        ...resource ? { resource } : {}
+      }).observable
+    ),
     concatMap(([outgoing, client]) => outgoing ? client.observable.action(outgoing.outgoingActions, {
       transactionId: outgoing.transactionId,
       skipCrossDatasetReferenceValidation: !0
@@ -3169,23 +3136,36 @@ const _resolveDocument = bindActionByDataset(
 }, subscribeToClientAndFetchDatasetAcl = ({
   instance,
   state,
-  key: { projectId, dataset }
-}) => getClientState(instance, { apiVersion: API_VERSION$3 }).observable.pipe(
-  switchMap(
-    (client) => client.observable.request({
-      uri: `/projects/${projectId}/datasets/${dataset}/acl`,
-      tag: "acl.get",
-      withCredentials: !0
-    })
-  ),
-  tap$1((datasetAcl) => state.set("setGrants", { grants: createGrantsLookup(datasetAcl) }))
-).subscribe({
-  error: (error) => state.set("setError", { error })
-});
+  key: { resource }
+}) => {
+  const clientOptions = { apiVersion: API_VERSION$4 };
+  resource && (clientOptions.resource = resource);
+  let uri;
+  if (resource && isDatasetResource(resource))
+    uri = `/projects/${resource.projectId}/datasets/${resource.dataset}/acl`;
+  else if (resource && isMediaLibraryResource(resource))
+    uri = `/media-libraries/${resource.mediaLibraryId}/acl`;
+  else if (resource && isCanvasResource(resource))
+    uri = `/canvases/${resource.canvasId}/acl`;
+  else
+    throw new Error(`Received invalid resource: ${JSON.stringify(resource)}`);
+  return getClientState(instance, clientOptions).observable.pipe(
+    switchMap(
+      (client) => client.observable.request({
+        uri,
+        tag: "acl.get",
+        withCredentials: !0
+      })
+    ),
+    tap$1((datasetAcl) => state.set("setGrants", { grants: createGrantsLookup(datasetAcl) }))
+  ).subscribe({
+    error: (error) => state.set("setError", { error })
+  });
+};
 function applyDocumentActions(...args) {
   return boundApplyDocumentActions(...args);
 }
-const boundApplyDocumentActions = bindActionByDataset(documentStore, _applyDocumentActions);
+const boundApplyDocumentActions = bindActionByResource(documentStore, _applyDocumentActions);
 async function _applyDocumentActions({ state }, { actions, transactionId = crypto.randomUUID(), disableBatching }) {
   const { events } = state.get(), transaction = {
     transactionId,
@@ -3280,11 +3260,11 @@ const favorites = createFetcherStore({
       })
     );
   }
-}), getFavoritesState = favorites.getState, resolveFavoritesState = favorites.resolveState, API_VERSION$1 = "vX", PROJECT_API_VERSION = "2025-07-18", USERS_STATE_CLEAR_DELAY = 5e3, DEFAULT_USERS_BATCH_SIZE = 100, getUsersKey = (instance, {
+}), getFavoritesState = favorites.getState, resolveFavoritesState = favorites.resolveState, API_VERSION$2 = "vX", PROJECT_API_VERSION = "2025-07-18", USERS_STATE_CLEAR_DELAY = 5e3, DEFAULT_USERS_BATCH_SIZE = 100, getUsersKey = (_instance, {
   resourceType,
   organizationId,
   batchSize = DEFAULT_USERS_BATCH_SIZE,
-  projectId = instance.config.projectId,
+  projectId,
   userId
 } = {}) => JSON.stringify({
   resourceType,
@@ -3379,7 +3359,7 @@ const favorites = createFetcherStore({
             );
           const scope = userId.startsWith("g") ? "global" : void 0, client = getClient(instance, {
             scope,
-            apiVersion: API_VERSION$1
+            apiVersion: API_VERSION$2
           }), resourceType2 = options.resourceType || "project", resourceId = resourceType2 === "organization" ? options.organizationId : options.projectId;
           return resourceId ? client.observable.request({
             method: "GET",
@@ -3398,7 +3378,7 @@ const favorites = createFetcherStore({
           filter((i) => typeof i == "string")
         ), resource$ = resourceType === "project" ? projectId ? of({ type: "project", id: projectId }) : throwError(() => new Error("Project ID required for this API.")) : organizationId$.pipe(map((id) => ({ type: "organization", id }))), client$ = getClientState(instance, {
           scope: "global",
-          apiVersion: API_VERSION$1
+          apiVersion: API_VERSION$2
         }).observable, loadMore$ = state.observable.pipe(
           map((s) => s.users[group$.key]?.lastLoadMoreRequest),
           distinctUntilChanged()
@@ -3557,11 +3537,19 @@ const handleIncomingMessage = (event) => {
     const {
       instance,
       state,
-      key: { projectId, dataset }
-    } = context, sessionId = crypto.randomUUID(), client = getClient(instance, {
+      key: { resource }
+    } = context;
+    if (isMediaLibraryResource(resource))
+      throw new Error(
+        "Presence is not supported for media library resources. Presence tracking requires a dataset resource with a projectId."
+      );
+    if (isCanvasResource(resource))
+      throw new Error(
+        "Presence is not supported for canvas resources. Presence tracking requires a dataset resource with a projectId."
+      );
+    const sessionId = crypto.randomUUID(), client = getClient(instance, {
       apiVersion: "2022-06-30",
-      projectId,
-      dataset
+      resource
     }), token$ = getTokenState(instance).observable.pipe(distinctUntilChanged()), [incomingEvents$, dispatch] = createBifurTransport({
       client,
       token$,
@@ -3600,11 +3588,11 @@ const handleIncomingMessage = (event) => {
     sessionId,
     locations: locs
   }))
-), getPresence = bindActionByDataset(
+), getPresence = bindActionByResource(
   presenceStore,
   createStateSourceAction({
-    selector: (context, _) => selectPresence(context.state),
-    onSubscribe: (context, _) => {
+    selector: (context) => selectPresence(context.state),
+    onSubscribe: (context) => {
       const subscription = context.state.observable.pipe(
         map(
           (state) => Array.from(state.locations.values()).map((l) => l.userId).filter((id) => !!id)
@@ -3618,7 +3606,7 @@ const handleIncomingMessage = (event) => {
             (userId) => getUserState(context.instance, {
               userId,
               resourceType: "project",
-              projectId: context.key.projectId
+              projectId: context.key.resource && isDatasetResource(context.key.resource) ? context.key.resource.projectId : void 0
             }).pipe(filter((v) => !!v))
           );
           return combineLatest(userObservables);
@@ -3635,7 +3623,64 @@ const handleIncomingMessage = (event) => {
       return () => subscription.unsubscribe();
     }
   })
-);
+), TITLE_CANDIDATES = ["title", "name", "label", "heading", "header", "caption"], SUBTITLE_CANDIDATES = ["description", "subtitle", ...TITLE_CANDIDATES], PREVIEW_PROJECTION = `{
+  // Get all potential title fields
+  "titleCandidates": {
+    ${TITLE_CANDIDATES.map((field) => `"${field}": ${field}`).join(`,
+      `)}
+  },
+  // Get all potential subtitle fields
+  "subtitleCandidates": {
+    ${SUBTITLE_CANDIDATES.map((field) => `"${field}": ${field}`).join(`,
+      `)}
+  },
+  "media": coalesce(
+    select(
+      defined(asset) => {"type": "image-asset", "_ref": asset._ref},
+      defined(image.asset) => {"type": "image-asset", "_ref": image.asset._ref},
+      defined(mainImage.asset) => {"type": "image-asset", "_ref": mainImage.asset._ref},
+      null
+    )
+  ),
+  _type,
+  _id,
+  _updatedAt
+}`, API_VERSION$1 = "v2025-05-06";
+function hasImageRef(value) {
+  return isObject(value) && "_ref" in value && typeof value._ref == "string";
+}
+function normalizeMedia(media, client) {
+  if (!media || !hasImageRef(media)) return null;
+  const url = createImageUrlBuilder(client).image({ _ref: media._ref }).url();
+  return {
+    type: "image-asset",
+    _ref: media._ref,
+    url
+  };
+}
+function findFirstDefined(fieldsToSearch, candidates, exclude) {
+  if (candidates)
+    for (const field of fieldsToSearch) {
+      const value = candidates[field];
+      if (typeof value == "string" && value.trim() !== "" && value !== exclude)
+        return value;
+    }
+}
+function transformProjectionToPreview(instance, resource, projectionResult) {
+  const title = findFirstDefined(TITLE_CANDIDATES, projectionResult.titleCandidates), subtitle = findFirstDefined(SUBTITLE_CANDIDATES, projectionResult.subtitleCandidates, title), client = getClient(instance, { apiVersion: API_VERSION$1, resource });
+  return {
+    title: String(title || `${projectionResult._type}: ${projectionResult._id}`),
+    subtitle: subtitle || void 0,
+    media: normalizeMedia(projectionResult.media, client),
+    ...projectionResult._status && { _status: projectionResult._status }
+  };
+}
+function hashString(str) {
+  let hash = 0;
+  for (let i = 0; i < str.length; i++)
+    hash = (hash * 31 + str.charCodeAt(i)) % 2147483647;
+  return Math.abs(hash).toString(16).padStart(8, "0");
+}
 function sortReleases(releases = []) {
   return [...releases].sort((a, b) => {
     if (a.metadata.releaseType === "undecided" && b.metadata.releaseType !== "undecided")
@@ -3663,21 +3708,20 @@ const ARCHIVED_RELEASE_STATES = ["archived", "published"], STABLE_EMPTY_RELEASES
     const subscription = subscribeToReleases(context);
     return () => subscription.unsubscribe();
   }
-}, getActiveReleasesState = bindActionByDataset(
+}, _getActiveReleasesState = bindActionByResource(
   releasesStore,
   createStateSourceAction({
     selector: ({ state }, _) => state.activeReleases
   })
-), RELEASES_QUERY = "releases::all()", subscribeToReleases = ({
+), getActiveReleasesState = (instance, options) => _getActiveReleasesState(instance, options), RELEASES_QUERY = "releases::all()", subscribeToReleases = ({
   instance,
   state,
-  key: { projectId, dataset }
+  key: { resource }
 }) => {
   const { observable: releases$ } = getQueryState(instance, {
     query: RELEASES_QUERY,
     perspective: "raw",
-    projectId,
-    dataset,
+    resource,
     tag: "releases"
   });
   return releases$.pipe(
@@ -3713,10 +3757,10 @@ const ARCHIVED_RELEASE_STATES = ["archived", "published"], STABLE_EMPTY_RELEASES
   )
 });
 let _boundGetPerspectiveState;
-const getPerspectiveState = (...args) => (_boundGetPerspectiveState || (_boundGetPerspectiveState = bindActionByDataset(
+const getPerspectiveState = (instance, ...rest) => (_boundGetPerspectiveState || (_boundGetPerspectiveState = bindActionByResource(
   releasesStore,
   _getPerspectiveStateSelector
-)), _boundGetPerspectiveState(...args)), QUERY_STATE_CLEAR_DELAY = 1e3, QUERY_STORE_API_VERSION = "v2025-05-06", QUERY_STORE_DEFAULT_PERSPECTIVE = "drafts", setQueryError = (key, error) => (prev) => {
+)), _boundGetPerspectiveState(instance, ...rest)), QUERY_STATE_CLEAR_DELAY = 1e3, QUERY_STORE_API_VERSION = "v2025-05-06", QUERY_STORE_DEFAULT_PERSPECTIVE = "drafts", setQueryError = (key, error) => (prev) => {
   const prevQuery = prev.queries[key];
   return prevQuery ? { ...prev, queries: { ...prev.queries, [key]: { ...prevQuery, error } } } : prev;
 }, setQueryData = (key, result, syncTags) => (prev) => {
@@ -3761,7 +3805,11 @@ const queryStore = {
         subscription.unsubscribe();
     };
   }
-}, errorHandler = (state) => (error) => state.set("setError", { error }), listenForNewSubscribersAndFetch = ({ state, instance }) => state.observable.pipe(
+}, errorHandler = (state) => (error) => state.set("setError", { error }), listenForNewSubscribersAndFetch = ({
+  state,
+  instance,
+  key: { resource: boundResource }
+}) => state.observable.pipe(
   map((s) => new Set(Object.keys(s.queries))),
   distinctUntilChanged((curr, next) => curr.size !== next.size ? !1 : Array.from(next).every((i) => curr.has(i))),
   startWith$1(/* @__PURE__ */ new Set()),
@@ -3784,19 +3832,16 @@ const queryStore = {
         ), {
           query,
           params,
-          projectId,
-          dataset,
           tag,
-          source,
+          resource,
           perspective: perspectiveFromOptions,
           ...restOptions
         } = parseQueryKey(group$.key), perspective$ = isReleasePerspective(perspectiveFromOptions) ? getPerspectiveState(instance, {
-          perspective: perspectiveFromOptions
+          perspective: perspectiveFromOptions,
+          resource: resource ?? boundResource
         }).observable.pipe(filter(Boolean)) : of(perspectiveFromOptions ?? QUERY_STORE_DEFAULT_PERSPECTIVE), client$ = getClientState(instance, {
           apiVersion: QUERY_STORE_API_VERSION,
-          projectId,
-          dataset,
-          source
+          resource: resource ?? boundResource
         }).observable;
         return combineLatest({
           lastLiveEventId: lastLiveEventId$,
@@ -3824,12 +3869,11 @@ const queryStore = {
 ).subscribe({ error: errorHandler(state) }), listenToLiveClientAndSetLastLiveEventIds = ({
   state,
   instance,
-  key: { source }
+  key: { resource }
 }) => {
   const liveMessages$ = getClientState(instance, {
     apiVersion: QUERY_STORE_API_VERSION,
-    // temporary guard here until we're ready for everything to be queried via global api
-    ...source && !isDatasetSource(source) ? { source } : {}
+    resource
   }).observable.pipe(
     switchMap(
       (client) => defer(
@@ -3866,7 +3910,7 @@ const queryStore = {
 function getQueryState(...args) {
   return _getQueryState(...args);
 }
-const _getQueryState = bindActionBySource(
+const _getQueryState = bindActionByResource(
   queryStore,
   createStateSourceAction({
     selector: ({ state, instance }, options) => {
@@ -3889,7 +3933,7 @@ const _getQueryState = bindActionBySource(
 function resolveQuery(...args) {
   return _resolveQuery(...args);
 }
-const _resolveQuery = bindActionBySource(
+const _resolveQuery = bindActionByResource(
   queryStore,
   ({ state, instance }, { signal, ...options }) => {
     const normalized = normalizeOptionsWithPerspective(instance, options), { getCurrent } = getQueryState(instance, normalized), key = getQueryKey(normalized), aborted$ = signal ? new Observable((observer) => {
@@ -3911,213 +3955,6 @@ const _resolveQuery = bindActionBySource(
     );
     return firstValueFrom(race([resolved$, aborted$]));
   }
-);
-function hashString(str) {
-  let hash = 0;
-  for (let i = 0; i < str.length; i++)
-    hash = (hash * 31 + str.charCodeAt(i)) % 2147483647;
-  return Math.abs(hash).toString(16).padStart(8, "0");
-}
-const TITLE_CANDIDATES = ["title", "name", "label", "heading", "header", "caption"], SUBTITLE_CANDIDATES = ["description", "subtitle", ...TITLE_CANDIDATES], PREVIEW_PROJECTION = `{
-  // Get all potential title fields
-  "titleCandidates": {
-    ${TITLE_CANDIDATES.map((field) => `"${field}": ${field}`).join(`,
-      `)}
-  },
-  // Get all potential subtitle fields
-  "subtitleCandidates": {
-    ${SUBTITLE_CANDIDATES.map((field) => `"${field}": ${field}`).join(`,
-      `)}
-  },
-  "media": coalesce(
-    select(
-      defined(asset) => {"type": "image-asset", "_ref": asset._ref},
-      defined(image.asset) => {"type": "image-asset", "_ref": image.asset._ref},
-      defined(mainImage.asset) => {"type": "image-asset", "_ref": mainImage.asset._ref},
-      null
-    )
-  ),
-  _type,
-  _id,
-  _updatedAt
-}`, PREVIEW_TAG = "preview", PREVIEW_PERSPECTIVE = "raw", STABLE_EMPTY_PREVIEW = { data: null, isPending: !1 }, STABLE_ERROR_PREVIEW = {
-  data: {
-    title: "Preview Error",
-    ...!!getEnv("DEV") && { subtitle: "Check the console for more details" }
-  },
-  isPending: !1
-};
-function assetIdToUrl(assetId, projectId, dataset) {
-  const pattern = /^image-(?<assetName>[A-Za-z0-9]+)-(?<dimensions>\d+x\d+)-(?<format>[a-z]+)$/, match = assetId.match(pattern);
-  if (!match?.groups)
-    throw new Error(
-      `Invalid asset ID \`${assetId}\`. Expected: image-{assetName}-{width}x{height}-{format}`
-    );
-  const { assetName, dimensions, format } = match.groups;
-  return `https://cdn.sanity.io/images/${projectId}/${dataset}/${assetName}-${dimensions}.${format}`;
-}
-function hasImageRef(value) {
-  return isObject(value) && "_ref" in value && typeof value._ref == "string";
-}
-function normalizeMedia(media, projectId, dataset) {
-  return !media || !hasImageRef(media) ? null : {
-    type: "image-asset",
-    _ref: media._ref,
-    url: assetIdToUrl(media._ref, projectId, dataset)
-  };
-}
-function findFirstDefined(fieldsToSearch, candidates, exclude) {
-  if (candidates)
-    for (const field of fieldsToSearch) {
-      const value = candidates[field];
-      if (typeof value == "string" && value.trim() !== "" && value !== exclude)
-        return value;
-    }
-}
-function processPreviewQuery({
-  projectId,
-  dataset,
-  ids,
-  results
-}) {
-  const resultMap = results.reduce((acc, next) => (acc[next._id] = next, acc), {});
-  return Object.fromEntries(
-    Array.from(ids).map((id) => {
-      const publishedId = getPublishedId(id), draftId = getDraftId(id), draftResult = resultMap[draftId], publishedResult = resultMap[publishedId];
-      if (!draftResult && !publishedResult) return [id, STABLE_EMPTY_PREVIEW];
-      try {
-        const result = draftResult || publishedResult;
-        if (!result) return [id, STABLE_EMPTY_PREVIEW];
-        const title = findFirstDefined(TITLE_CANDIDATES, result.titleCandidates), subtitle = findFirstDefined(SUBTITLE_CANDIDATES, result.subtitleCandidates, title), preview = {
-          title: String(title || `${result._type}: ${result._id}`),
-          subtitle: subtitle || void 0,
-          media: normalizeMedia(result.media, projectId, dataset)
-        }, _status = {
-          ...draftResult?._updatedAt && { lastEditedDraftAt: draftResult._updatedAt },
-          ...publishedResult?._updatedAt && { lastEditedPublishedAt: publishedResult._updatedAt }
-        };
-        return [id, { data: { ...preview, _status }, isPending: !1 }];
-      } catch (e) {
-        return console.warn(e), [id, STABLE_ERROR_PREVIEW];
-      }
-    })
-  );
-}
-function createPreviewQuery(documentIds) {
-  const allIds = Array.from(documentIds).flatMap((id) => [getPublishedId(id), getDraftId(id)]), queryHash = hashString(PREVIEW_PROJECTION);
-  return {
-    query: `*[_id in $__ids_${queryHash}]${PREVIEW_PROJECTION}`,
-    params: {
-      [`__ids_${queryHash}`]: allIds
-    }
-  };
-}
-const BATCH_DEBOUNCE_TIME$1 = 50, isSetEqual$1 = (a, b) => a.size === b.size && Array.from(a).every((i) => b.has(i)), subscribeToStateAndFetchBatches$1 = ({
-  state,
-  instance,
-  key: { projectId, dataset }
-}) => state.observable.pipe(
-  map(({ subscriptions }) => new Set(Object.keys(subscriptions))),
-  distinctUntilChanged(isSetEqual$1),
-  debounceTime(BATCH_DEBOUNCE_TIME$1),
-  startWith$1(/* @__PURE__ */ new Set()),
-  pairwise$1(),
-  tap$1(([prevIds, currIds]) => {
-    const newIds = [...currIds].filter((element) => !prevIds.has(element));
-    state.set("updatingPending", (prev) => {
-      const pendingValues = newIds.reduce((acc, id) => {
-        const prevValue = prev.values[id], value = prevValue?.data ? prevValue.data : null;
-        return acc[id] = { data: value, isPending: !0 }, acc;
-      }, {});
-      return { values: { ...prev.values, ...pendingValues } };
-    });
-  }),
-  map(([, ids]) => ids),
-  distinctUntilChanged(isSetEqual$1)
-).pipe(
-  switchMap((ids) => {
-    if (!ids.size) return EMPTY;
-    const { query, params } = createPreviewQuery(ids), controller = new AbortController();
-    return new Observable((observer) => {
-      const { getCurrent, observable } = getQueryState(instance, {
-        query,
-        params,
-        tag: PREVIEW_TAG,
-        perspective: PREVIEW_PERSPECTIVE,
-        projectId,
-        dataset
-      }), subscription = defer(() => getCurrent() === void 0 ? from(
-        resolveQuery(instance, {
-          query,
-          params,
-          tag: PREVIEW_TAG,
-          perspective: PREVIEW_PERSPECTIVE,
-          signal: controller.signal,
-          projectId,
-          dataset
-        })
-      ).pipe(switchMap(() => observable)) : observable).pipe(filter((result) => result !== void 0)).subscribe(observer);
-      return () => {
-        controller.signal.aborted || controller.abort(), subscription.unsubscribe();
-      };
-    }).pipe(map((data) => ({ data, ids })));
-  }),
-  map(({ ids, data }) => ({
-    values: processPreviewQuery({
-      projectId,
-      dataset,
-      ids,
-      results: data
-    })
-  }))
-).subscribe({
-  next: ({ values }) => {
-    state.set("updateResult", (prev) => ({ values: { ...prev.values, ...values } }));
-  }
-}), previewStore = {
-  name: "Preview",
-  getInitialState() {
-    return {
-      subscriptions: {},
-      values: {}
-    };
-  },
-  initialize: (context) => {
-    const subscription = subscribeToStateAndFetchBatches$1(context);
-    return () => subscription.unsubscribe;
-  }
-};
-function getPreviewState(...args) {
-  return _getPreviewState(...args);
-}
-const _getPreviewState = bindActionByDataset(
-  previewStore,
-  createStateSourceAction({
-    selector: ({ state }, docHandle) => state.values[docHandle.documentId] ?? STABLE_EMPTY_PREVIEW,
-    onSubscribe: ({ state }, docHandle) => {
-      const subscriptionId = insecureRandomId(), documentId = getPublishedId(docHandle.documentId);
-      return state.set("addSubscription", (prev) => ({
-        subscriptions: {
-          ...prev.subscriptions,
-          [documentId]: {
-            ...prev.subscriptions[documentId],
-            [subscriptionId]: !0
-          }
-        }
-      })), () => {
-        state.set("removeSubscription", (prev) => {
-          const documentSubscriptions = omit(prev.subscriptions[documentId], subscriptionId), hasSubscribers = !!Object.keys(documentSubscriptions).length, prevValue = prev.values[documentId], previewValue = prevValue?.data ? prevValue.data : null;
-          return {
-            subscriptions: hasSubscribers ? { ...prev.subscriptions, [documentId]: documentSubscriptions } : omit(prev.subscriptions, documentId),
-            values: hasSubscribers ? prev.values : { ...prev.values, [documentId]: { data: previewValue, isPending: !1 } }
-          };
-        });
-      };
-    }
-  })
-), resolvePreview = bindActionByDataset(
-  previewStore,
-  ({ instance }, docHandle) => firstValueFrom(getPreviewState(instance, docHandle).observable.pipe(filter((i) => !!i.data)))
 ), PROJECTION_TAG = "projection", PROJECTION_STATE_CLEAR_DELAY = 1e3, STABLE_EMPTY_PROJECTION = {
   data: null,
   isPending: !1
@@ -4197,7 +4034,7 @@ function processStatusQueryResults(results) {
 const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Array.from(a).every((i) => b.has(i)), subscribeToStateAndFetchBatches = ({
   state,
   instance,
-  key: { source, perspective }
+  key: { resource, perspective }
 }) => {
   const documentProjections$ = state.observable.pipe(
     map((s) => s.documentProjections),
@@ -4241,8 +4078,7 @@ const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Arra
           params,
           tag: PROJECTION_TAG,
           perspective,
-          // temporary guard here until we're ready for everything to be queried via global API
-          ...source && !isDatasetSource(source) ? { source } : {}
+          resource
         }), subscription = defer(() => getCurrent() === void 0 ? from(
           resolveQuery(instance, {
             query,
@@ -4250,8 +4086,7 @@ const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Arra
             tag: PROJECTION_TAG,
             signal: controller.signal,
             perspective,
-            // temporary guard here until we're ready for everything to be queried via global API in v3
-            ...source && !isDatasetSource(source) ? { source } : {}
+            resource
           })
         ).pipe(switchMap(() => observable)) : observable).pipe(filter((result) => result !== void 0)).subscribe(observer);
         return () => {
@@ -4263,8 +4098,7 @@ const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Arra
           params: statusParams,
           tag: PROJECTION_TAG,
           perspective: "raw",
-          // temporary guard here until we're ready for everything to be queried via global API
-          ...source && !isDatasetSource(source) ? { source } : {}
+          resource
         }), subscription = defer(() => getCurrent() === void 0 ? from(
           resolveQuery(instance, {
             query: statusQuery,
@@ -4272,8 +4106,7 @@ const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Arra
             tag: PROJECTION_TAG,
             signal: controller.signal,
             perspective: "raw",
-            // temporary guard here until we're ready for everything to be queried via global API
-            ...source && !isDatasetSource(source) ? { source } : {}
+            resource
           })
         ).pipe(switchMap(() => observable)) : observable).pipe(filter((result) => result !== void 0)).subscribe(observer);
         return () => {
@@ -4343,7 +4176,7 @@ const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Arra
 function getProjectionState(...args) {
   return _getProjectionState(...args);
 }
-const _getProjectionState = bindActionBySourceAndPerspective(
+const _getProjectionState = bindActionByResourceAndPerspective(
   projectionStore,
   createStateSourceAction({
     selector: ({ state }, options) => {
@@ -4403,7 +4236,7 @@ const _getProjectionState = bindActionBySourceAndPerspective(
 function resolveProjection(...args) {
   return _resolveProjection(...args);
 }
-const _resolveProjection = bindActionBySourceAndPerspective(
+const _resolveProjection = bindActionByResourceAndPerspective(
   projectionStore,
   ({ instance }, options) => firstValueFrom(
     getProjectionState(instance, options).observable.pipe(
@@ -4511,11 +4344,13 @@ function getCorsErrorProjectId(error) {
   const projMatch = (error.message || "").match(/manage\/project\/([^/?#]+)/);
   return projMatch ? projMatch[1] : null;
 }
-var version = "2.8.0";
+var version = "3.0.0-rc.0";
 const CORE_SDK_VERSION = getEnv("PKG_VERSION") || `${version}-development`;
 export {
   AuthStateType,
   CORE_SDK_VERSION,
+  DEFAULT_RESOURCE_NAME,
+  PREVIEW_PROJECTION,
   agentGenerate,
   agentPatch,
   agentPrompt,
@@ -4523,12 +4358,11 @@ export {
   agentTranslate,
   applyDocumentActions,
   configureLogging,
-  createDatasetHandle,
   createDocument,
   createDocumentHandle,
   createDocumentTypeHandle,
   createGroqSearchFilter,
-  createProjectHandle,
+  createResourceHandle,
   createSanityInstance,
   defineIntent,
   deleteDocument,
@@ -4560,7 +4394,6 @@ export {
   getPermissionsState,
   getPerspectiveState,
   getPresence,
-  getPreviewState,
   getProjectState,
   getProjectionState,
   getProjectsState,
@@ -4571,9 +4404,9 @@ export {
   getUsersKey,
   getUsersState,
   handleAuthCallback,
-  isCanvasSource,
-  isDatasetSource,
-  isMediaLibrarySource,
+  isCanvasResource,
+  isDatasetResource,
+  isMediaLibraryResource,
   isProjectUserNotFoundClientError,
   isStudioConfig,
   joinPaths,
@@ -4590,7 +4423,6 @@ export {
   resolveDocument,
   resolveFavoritesState,
   resolvePermissions,
-  resolvePreview,
   resolveProject,
   resolveProjection,
   resolveProjects,
@@ -4601,6 +4433,7 @@ export {
   slicePath2 as slicePath,
   stringifyPath2 as stringifyPath,
   subscribeDocumentEvents,
+  transformProjectionToPreview,
   unpublishDocument
 };
 //# sourceMappingURL=index.js.map