@sanity/client 6.28.3-instruct.0 → 6.28.3-resources.0

package/dist/index.browser.js

@@ -107,8 +107,8 @@ function defineHttpRequest(envMiddleware2) {
 }
 function shouldRetry(err, attempt, options) {
   if (options.maxRetries === 0) return !1;
-  const isSafe = options.method === "GET" || options.method === "HEAD", isQuery = (options.uri || options.url).startsWith("/data/query"), isRetriableResponse = err.response && (err.response.statusCode === 429 || err.response.statusCode === 502 || err.response.statusCode === 503);
-  return (isSafe || isQuery) && isRetriableResponse ? !0 : retry.shouldRetry(err, attempt, options);
+  const isSafe = options.method === "GET" || options.method === "HEAD", isQuery2 = (options.uri || options.url).startsWith("/data/query"), isRetriableResponse = err.response && (err.response.statusCode === 429 || err.response.statusCode === 502 || err.response.statusCode === 503);
+  return (isSafe || isQuery2) && isRetriableResponse ? !0 : retry.shouldRetry(err, attempt, options);
 }
 const BASE_URL = "https://www.sanity.io/help/";
 function generateHelpUrl(slug) {
@@ -155,6 +155,20 @@ const VALID_ASSET_TYPES = ["image", "file"], VALID_INSERT_LOCATIONS = ["before",
       "Tag can only contain alphanumeric characters, underscores, dashes and dots, and be between one and 75 characters long."
     );
   return tag;
+}, resourceBase = (config) => {
+  if (!config["~experimental_resource"])
+    throw new Error("`resource` must be provided to perform queries");
+  const resourceConfig = config["~experimental_resource"];
+  if (resourceConfig.type === "dataset") {
+    const segments = resourceConfig.id.split(".");
+    if (segments.length !== 2)
+      throw new Error('Dataset ID must be in the format "project.dataset"');
+    return `/projects/${segments[0]}/datasets/${segments[1]}`;
+  }
+  return `/${resourceConfig.type}/${resourceConfig.id}`;
+}, resourceGuard = (service, config) => {
+  if (config["~experimental_resource"])
+    throw new Error(`\`${service}\` does not support resource-based operations`);
 };
 function once(fn) {
   let didCall = !1, returnValue;
@@ -180,6 +194,9 @@ const createWarningPrinter = (message) => (
   `See ${generateHelpUrl(
     "js-client-browser-token"
   )} for more information and how to hide this warning.`
+]), printCredentialedTokenWarning = createWarningPrinter([
+  "You have configured Sanity client to use a token, but also provided `withCredentials: true`.",
+  "This is no longer supported - only token will be used - remove `withCredentials: true`."
 ]), printNoApiVersionSpecifiedWarning = createWarningPrinter([
   "Using the Sanity client without specifying an API version is deprecated.",
   `See ${generateHelpUrl("js-client-api-version")}`
@@ -198,21 +215,11 @@ function validateApiVersion(apiVersion) {
   if (!(/^\d{4}-\d{2}-\d{2}$/.test(apiVersion) && apiDate instanceof Date && apiDate.getTime() > 0))
     throw new Error("Invalid API version string, expected `1` or date in format `YYYY-MM-DD`");
 }
-const VALID_PERSPECTIVE = /^[a-z0-9_]+$/i;
 function validateApiPerspective(perspective) {
-  if (Array.isArray(perspective) && perspective.includes("raw"))
+  if (Array.isArray(perspective) && perspective.length > 1 && perspective.includes("raw"))
     throw new TypeError(
       'Invalid API perspective value: "raw". The raw-perspective can not be combined with other perspectives'
     );
-  const invalid = (Array.isArray(perspective) ? perspective : [perspective]).filter(
-    (perspectiveName) => typeof perspectiveName != "string" || !VALID_PERSPECTIVE.test(perspectiveName)
-  );
-  if (invalid.length > 0) {
-    const formatted = invalid.map((v) => JSON.stringify(v));
-    throw new TypeError(
-      `Invalid API perspective value${invalid.length === 1 ? "" : "s"}: ${formatted.join(", ")}, expected \`published\`, \`drafts\`, \`raw\` or a release identifier string`
-    );
-  }
 }
 const initConfig = (config, prevConfig) => {
   const specifiedConfig = {
@@ -227,14 +234,14 @@ const initConfig = (config, prevConfig) => {
   const newConfig = {
     ...defaultConfig,
     ...specifiedConfig
-  }, projectBased = newConfig.useProjectHostname;
+  }, projectBased = newConfig.useProjectHostname && !newConfig["~experimental_resource"];
   if (typeof Promise > "u") {
     const helpUrl = generateHelpUrl("js-client-promise-polyfill");
     throw new Error(`No native Promise-implementation found, polyfill needed - see ${helpUrl}`);
   }
   if (projectBased && !newConfig.projectId)
     throw new Error("Configuration must contain `projectId`");
-  if (typeof newConfig.perspective < "u" && validateApiPerspective(newConfig.perspective), "encodeSourceMap" in newConfig)
+  if (newConfig["~experimental_resource"] && resourceBase(newConfig), typeof newConfig.perspective < "u" && validateApiPerspective(newConfig.perspective), "encodeSourceMap" in newConfig)
     throw new Error(
       "It looks like you're using options meant for '@sanity/preview-kit/client'. 'encodeSourceMap' is not supported in '@sanity/client'. Did you mean 'stega.enabled'?"
     );
@@ -250,10 +257,10 @@ const initConfig = (config, prevConfig) => {
     throw new Error(
       `stega.studioUrl must be a string or a function, received ${newConfig.stega.studioUrl}`
     );
-  const isBrowser = typeof window < "u" && window.location && window.location.hostname, isLocalhost = isBrowser && isLocal(window.location.hostname);
-  isBrowser && isLocalhost && newConfig.token && newConfig.ignoreBrowserTokenWarning !== !0 ? printBrowserTokenWarning() : typeof newConfig.useCdn > "u" && printCdnWarning(), projectBased && projectId(newConfig.projectId), newConfig.dataset && dataset(newConfig.dataset), "requestTagPrefix" in newConfig && (newConfig.requestTagPrefix = newConfig.requestTagPrefix ? requestTag(newConfig.requestTagPrefix).replace(/\.+$/, "") : void 0), newConfig.apiVersion = `${newConfig.apiVersion}`.replace(/^v/, ""), newConfig.isDefaultApi = newConfig.apiHost === defaultConfig.apiHost, newConfig.useCdn === !0 && newConfig.withCredentials && printCdnAndWithCredentialsWarning(), newConfig.useCdn = newConfig.useCdn !== !1 && !newConfig.withCredentials, validateApiVersion(newConfig.apiVersion);
+  const isBrowser = typeof window < "u" && window.location && window.location.hostname, isLocalhost = isBrowser && isLocal(window.location.hostname), hasToken = !!newConfig.token;
+  newConfig.withCredentials && hasToken && (printCredentialedTokenWarning(), newConfig.withCredentials = !1), isBrowser && isLocalhost && hasToken && newConfig.ignoreBrowserTokenWarning !== !0 ? printBrowserTokenWarning() : typeof newConfig.useCdn > "u" && printCdnWarning(), projectBased && projectId(newConfig.projectId), newConfig.dataset && dataset(newConfig.dataset), "requestTagPrefix" in newConfig && (newConfig.requestTagPrefix = newConfig.requestTagPrefix ? requestTag(newConfig.requestTagPrefix).replace(/\.+$/, "") : void 0), newConfig.apiVersion = `${newConfig.apiVersion}`.replace(/^v/, ""), newConfig.isDefaultApi = newConfig.apiHost === defaultConfig.apiHost, newConfig.useCdn === !0 && newConfig.withCredentials && printCdnAndWithCredentialsWarning(), newConfig.useCdn = newConfig.useCdn !== !1 && !newConfig.withCredentials, validateApiVersion(newConfig.apiVersion);
   const hostParts = newConfig.apiHost.split("://", 2), protocol = hostParts[0], host = hostParts[1], cdnHost = newConfig.isDefaultApi ? defaultCdnHost : host;
-  return newConfig.useProjectHostname ? (newConfig.url = `${protocol}://${newConfig.projectId}.${host}/v${newConfig.apiVersion}`, newConfig.cdnUrl = `${protocol}://${newConfig.projectId}.${cdnHost}/v${newConfig.apiVersion}`) : (newConfig.url = `${newConfig.apiHost}/v${newConfig.apiVersion}`, newConfig.cdnUrl = newConfig.url), newConfig;
+  return projectBased ? (newConfig.url = `${protocol}://${newConfig.projectId}.${host}/v${newConfig.apiVersion}`, newConfig.cdnUrl = `${protocol}://${newConfig.projectId}.${cdnHost}/v${newConfig.apiVersion}`) : (newConfig.url = `${newConfig.apiHost}/v${newConfig.apiVersion}`, newConfig.cdnUrl = newConfig.url), newConfig;
 };
 class ConnectionFailedError extends Error {
   name = "ConnectionFailedError";
@@ -699,7 +706,7 @@ const projectHeader = "X-Sanity-Project-ID";
 function requestOptions(config, overrides = {}) {
   const headers = {}, token = overrides.token || config.token;
   token && (headers.Authorization = `Bearer ${token}`), !overrides.useGlobalApi && !config.useProjectHostname && config.projectId && (headers[projectHeader] = config.projectId);
-  const withCredentials = !!(typeof overrides.withCredentials > "u" ? config.token || config.withCredentials : overrides.withCredentials), timeout = typeof overrides.timeout > "u" ? config.timeout : overrides.timeout;
+  const withCredentials = !!(typeof overrides.withCredentials > "u" ? config.withCredentials : overrides.withCredentials), timeout = typeof overrides.timeout > "u" ? config.timeout : overrides.timeout;
   return Object.assign({}, overrides, {
     headers: Object.assign({}, headers, overrides.headers || {}),
     timeout: typeof timeout > "u" ? 5 * 60 * 1e3 : timeout,
@@ -821,7 +828,7 @@ function _action(client, httpRequest, actions, options) {
   );
 }
 function _dataRequest(client, httpRequest, endpoint, body, options = {}) {
-  const isMutation = endpoint === "mutate", isAction = endpoint === "actions", isQuery = endpoint === "query", strQuery = isMutation || isAction ? "" : encodeQueryString(body), useGet = !isMutation && !isAction && strQuery.length < getQuerySizeLimit, stringQuery = useGet ? strQuery : "", returnFirst = options.returnFirst, { timeout, token, tag, headers, returnQuery, lastLiveEventId, cacheMode } = options, uri = _getDataUrl(client, endpoint, stringQuery), reqOptions = {
+  const isMutation = endpoint === "mutate", isAction = endpoint === "actions", isQuery2 = endpoint === "query", strQuery = isMutation || isAction ? "" : encodeQueryString(body), useGet = !isMutation && !isAction && strQuery.length < getQuerySizeLimit, stringQuery = useGet ? strQuery : "", returnFirst = options.returnFirst, { timeout, token, tag, headers, returnQuery, lastLiveEventId, cacheMode } = options, uri = _getDataUrl(client, endpoint, stringQuery), reqOptions = {
     method: useGet ? "GET" : "POST",
     uri,
     json: !0,
@@ -836,7 +843,7 @@ function _dataRequest(client, httpRequest, endpoint, body, options = {}) {
     resultSourceMap: options.resultSourceMap,
     lastLiveEventId: Array.isArray(lastLiveEventId) ? lastLiveEventId[0] : lastLiveEventId,
     cacheMode,
-    canUseCdn: isQuery,
+    canUseCdn: isQuery2,
     signal: options.signal,
     fetch: options.fetch,
     useAbortSignal: options.useAbortSignal,
@@ -864,11 +871,22 @@ function _create(client, httpRequest, doc, op, options = {}) {
   const mutation = { [op]: doc }, opts = Object.assign({ returnFirst: !0, returnDocuments: !0 }, options);
   return _dataRequest(client, httpRequest, "mutate", { mutations: [mutation] }, opts);
 }
+const isQuery = (config, uri) => uri.startsWith("/data/query/") || config["~experimental_resource"] && uri.startsWith(
+  `/${config["~experimental_resource"].type}/${config["~experimental_resource"].id}/query`
+), isMutate = (config, uri) => uri.startsWith("/data/mutate/") || config["~experimental_resource"] && uri.startsWith(
+  `/${config["~experimental_resource"].type}/${config["~experimental_resource"].id}/mutate`
+), isDoc = (config, uri) => uri.startsWith("/data/doc/") || config["~experimental_resource"] && uri.startsWith(
+  `/${config["~experimental_resource"].type}/${config["~experimental_resource"].id}/doc/`
+), isListener = (config, uri) => uri.startsWith("/data/listen/") || config["~experimental_resource"] && uri.startsWith(
+  `/${config["~experimental_resource"].type}/${config["~experimental_resource"].id}/listen`
+), isHistory = (config, uri) => uri.startsWith("/data/history/") || config["~experimental_resource"] && uri.startsWith(
+  `/${config["~experimental_resource"].type}/${config["~experimental_resource"].id}/history/`
+), isData = (config, uri) => uri.startsWith("/data/") || isQuery(config, uri) || isMutate(config, uri) || isDoc(config, uri) || isListener(config, uri) || isHistory(config, uri);
 function _requestObservable(client, httpRequest, options) {
-  const uri = options.url || options.uri, config = client.config(), canUseCdn = typeof options.canUseCdn > "u" ? ["GET", "HEAD"].indexOf(options.method || "GET") >= 0 && uri.indexOf("/data/") === 0 : options.canUseCdn;
+  const uri = options.url || options.uri, config = client.config(), canUseCdn = typeof options.canUseCdn > "u" ? ["GET", "HEAD"].indexOf(options.method || "GET") >= 0 && isData(config, uri) : options.canUseCdn;
   let useCdn = (options.useCdn ?? config.useCdn) && canUseCdn;
   const tag = options.tag && config.requestTagPrefix ? [config.requestTagPrefix, options.tag].join(".") : options.tag || config.requestTagPrefix;
-  if (tag && options.tag !== null && (options.query = { tag: requestTag(tag), ...options.query }), ["GET", "HEAD", "POST"].indexOf(options.method || "GET") >= 0 && uri.indexOf("/data/query/") === 0) {
+  if (tag && options.tag !== null && (options.query = { tag: requestTag(tag), ...options.query }), ["GET", "HEAD", "POST"].indexOf(options.method || "GET") >= 0 && isQuery(config, uri)) {
     const resultSourceMap = options.resultSourceMap ?? config.resultSourceMap;
     resultSourceMap !== void 0 && resultSourceMap !== !1 && (options.query = { resultSourceMap, ...options.query });
     const perspectiveOption = options.perspective || config.perspective;
@@ -895,7 +913,12 @@ function _request(client, httpRequest, options) {
   );
 }
 function _getDataUrl(client, operation, path) {
-  const config = client.config(), catalog = hasDataset(config), baseUri = `/${operation}/${catalog}`;
+  const config = client.config();
+  if (config["~experimental_resource"]) {
+    const resourceBase$1 = resourceBase(config), uri2 = path ? `${operation}/${path}` : operation;
+    return `${resourceBase$1}/${uri2}`.replace(/\/($|\?)/, "$1");
+  }
+  const catalog = hasDataset(config), baseUri = `/${operation}/${catalog}`;
   return `/data${path ? `${baseUri}/${path}` : baseUri}`.replace(/\/($|\?)/, "$1");
 }
 function _getUrl(client, uri, canUseCdn = !1) {
@@ -954,7 +977,7 @@ function _upload(client, httpRequest, assetType, body, opts = {}) {
   validateAssetType(assetType);
   let meta = opts.extract || void 0;
   meta && !meta.length && (meta = ["none"]);
-  const dataset2 = hasDataset(client.config()), assetEndpoint = assetType === "image" ? "images" : "files", options = optionsFromFile(opts, body), { tag, label, title, description, creditLine, filename, source } = options, query = {
+  const config = client.config(), options = optionsFromFile(opts, body), { tag, label, title, description, creditLine, filename, source } = options, query = {
     label,
     title,
     description,
@@ -966,12 +989,19 @@ function _upload(client, httpRequest, assetType, body, opts = {}) {
     tag,
     method: "POST",
     timeout: options.timeout || 0,
-    uri: `/assets/${assetEndpoint}/${dataset2}`,
+    uri: buildAssetUploadUrl(config, assetType),
     headers: options.contentType ? { "Content-Type": options.contentType } : {},
     query,
     body
   });
 }
+function buildAssetUploadUrl(config, assetType) {
+  const assetTypeEndpoint = assetType === "image" ? "images" : "files";
+  if (config["~experimental_resource"])
+    return `${config["~experimental_resource"].type}/${config["~experimental_resource"].id}/assets/${assetTypeEndpoint}`;
+  const dataset2 = hasDataset(config);
+  return `assets/${assetTypeEndpoint}/${dataset2}`;
+}
 function optionsFromFile(opts, file) {
   return typeof File > "u" || !(file instanceof File) ? opts : Object.assign(
     {
@@ -981,42 +1011,6 @@ function optionsFromFile(opts, file) {
     opts
   );
 }
-function _instruct(client, httpRequest, request) {
-  const dataset2 = hasDataset(client.config());
-  return _request(client, httpRequest, {
-    method: "POST",
-    uri: `/assist/tasks/instruct/${dataset2}`,
-    body: request
-  });
-}
-class ObservableAssistClient {
-  #client;
-  #httpRequest;
-  constructor(client, httpRequest) {
-    this.#client = client, this.#httpRequest = httpRequest;
-  }
-  /**
-   * Run an ad-hoc instruction for a target document.
-   * @param request instruction request
-   */
-  instruct(request) {
-    return _instruct(this.#client, this.#httpRequest, request);
-  }
-}
-class AssistClient {
-  #client;
-  #httpRequest;
-  constructor(client, httpRequest) {
-    this.#client = client, this.#httpRequest = httpRequest;
-  }
-  /**
-   * Run an ad-hoc instruction for a target document.
-   * @param request instruction request
-   */
-  instruct(request) {
-    return lastValueFrom(_instruct(this.#client, this.#httpRequest, request));
-  }
-}
 var defaults = (obj, defaults2) => Object.keys(defaults2).concat(Object.keys(obj)).reduce((target, prop) => (target[prop] = typeof obj[prop] > "u" ? defaults2[prop] : obj[prop], target), {});
 const pick = (obj, props) => props.reduce((selection, prop) => (typeof obj[prop] > "u" || (selection[prop] = obj[prop]), selection), {}), eventSourcePolyfill = defer(() => import("@sanity/eventsource")).pipe(
   map(({ default: EventSource2 }) => EventSource2),
@@ -1045,7 +1039,7 @@ function _listen(query, params, opts = {}) {
   if (uri.length > MAX_URL_LENGTH)
     return throwError(() => new Error("Query too large for listener"));
   const listenFor = options.events ? options.events : ["mutation"], esOptions = {};
-  return (token || withCredentials) && (esOptions.withCredentials = !0), token && (esOptions.headers = {
+  return withCredentials && (esOptions.withCredentials = !0), token && (esOptions.headers = {
     Authorization: `Bearer ${token}`
   }), connectEventSource(() => (
     // use polyfill if there is no global EventSource or if we need to set headers
@@ -1099,6 +1093,7 @@ class LiveClient {
     includeDrafts = !1,
     tag: _tag
   } = {}) {
+    resourceGuard("live", this.#client.config());
     const {
       projectId: projectId2,
       apiVersion: _apiVersion,
@@ -1228,7 +1223,7 @@ class DatasetsClient {
    * @param options - Options for the dataset
    */
   create(name, options) {
-    return lastValueFrom(
+    return resourceGuard("dataset", this.#client.config()), lastValueFrom(
       _modify(this.#client, this.#httpRequest, "PUT", name, options)
     );
   }
@@ -1239,7 +1234,7 @@ class DatasetsClient {
    * @param options - New options for the dataset
    */
   edit(name, options) {
-    return lastValueFrom(
+    return resourceGuard("dataset", this.#client.config()), lastValueFrom(
       _modify(this.#client, this.#httpRequest, "PATCH", name, options)
     );
   }
@@ -1249,19 +1244,19 @@ class DatasetsClient {
    * @param name - Name of the dataset to delete
    */
   delete(name) {
-    return lastValueFrom(_modify(this.#client, this.#httpRequest, "DELETE", name));
+    return resourceGuard("dataset", this.#client.config()), lastValueFrom(_modify(this.#client, this.#httpRequest, "DELETE", name));
   }
   /**
    * Fetch a list of datasets for the configured project
    */
   list() {
-    return lastValueFrom(
+    return resourceGuard("dataset", this.#client.config()), lastValueFrom(
       _request(this.#client, this.#httpRequest, { uri: "/datasets", tag: null })
     );
   }
 }
 function _modify(client, httpRequest, method, name, options) {
-  return dataset(name), _request(client, httpRequest, {
+  return resourceGuard("dataset", client.config()), dataset(name), _request(client, httpRequest, {
     method,
     uri: `/datasets/${name}`,
     body: options,
@@ -1275,6 +1270,7 @@ class ObservableProjectsClient {
     this.#client = client, this.#httpRequest = httpRequest;
   }
   list(options) {
+    resourceGuard("projects", this.#client.config());
     const uri = options?.includeMembers === !1 ? "/projects?includeMembers=false" : "/projects";
     return _request(this.#client, this.#httpRequest, { uri });
   }
@@ -1284,7 +1280,7 @@ class ObservableProjectsClient {
    * @param projectId - ID of the project to fetch
    */
   getById(projectId2) {
-    return _request(this.#client, this.#httpRequest, { uri: `/projects/${projectId2}` });
+    return resourceGuard("projects", this.#client.config()), _request(this.#client, this.#httpRequest, { uri: `/projects/${projectId2}` });
   }
 }
 class ProjectsClient {
@@ -1294,6 +1290,7 @@ class ProjectsClient {
     this.#client = client, this.#httpRequest = httpRequest;
   }
   list(options) {
+    resourceGuard("projects", this.#client.config());
     const uri = options?.includeMembers === !1 ? "/projects?includeMembers=false" : "/projects";
     return lastValueFrom(_request(this.#client, this.#httpRequest, { uri }));
   }
@@ -1303,7 +1300,7 @@ class ProjectsClient {
    * @param projectId - ID of the project to fetch
    */
   getById(projectId2) {
-    return lastValueFrom(
+    return resourceGuard("projects", this.#client.config()), lastValueFrom(
       _request(this.#client, this.#httpRequest, { uri: `/projects/${projectId2}` })
     );
   }
@@ -1352,7 +1349,6 @@ class ObservableSanityClient {
   live;
   projects;
   users;
-  assist;
   /**
    * Private properties
    */
@@ -1363,7 +1359,7 @@ class ObservableSanityClient {
    */
   listen = _listen;
   constructor(httpRequest, config = defaultConfig) {
-    this.config(config), this.#httpRequest = httpRequest, this.assets = new ObservableAssetsClient(this, this.#httpRequest), this.datasets = new ObservableDatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.projects = new ObservableProjectsClient(this, this.#httpRequest), this.users = new ObservableUsersClient(this, this.#httpRequest), this.assist = new ObservableAssistClient(this, this.#httpRequest);
+    this.config(config), this.#httpRequest = httpRequest, this.assets = new ObservableAssetsClient(this, this.#httpRequest), this.datasets = new ObservableDatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.projects = new ObservableProjectsClient(this, this.#httpRequest), this.users = new ObservableUsersClient(this, this.#httpRequest);
   }
   /**
    * Clone the client - returns a new instance
@@ -1502,7 +1498,6 @@ class SanityClient {
   live;
   projects;
   users;
-  assist;
   /**
    * Observable version of the Sanity client, with the same configuration as the promise-based one
    */
@@ -1517,7 +1512,7 @@ class SanityClient {
    */
   listen = _listen;
   constructor(httpRequest, config = defaultConfig) {
-    this.config(config), this.#httpRequest = httpRequest, this.assets = new AssetsClient(this, this.#httpRequest), this.datasets = new DatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.assist = new AssistClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
+    this.config(config), this.#httpRequest = httpRequest, this.assets = new AssetsClient(this, this.#httpRequest), this.datasets = new DatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
   }
   /**
    * Clone the client - returns a new instance