@sanity/client 7.13.1 → 7.14.0

package/dist/index.d.cts

@@ -430,6 +430,7 @@ export declare type AssetMetadataType =
   | 'palette'
   | 'lqip'
   | 'blurhash'
+  | 'thumbhash'
   | 'none'
 
 /** @internal */
@@ -697,7 +698,26 @@ export declare interface ClientConfig {
   /** @defaultValue true */
   useCdn?: boolean
   token?: string
-  /** @internal */
+  /**
+   * Configure the client to work with a specific Sanity resource (Media Library, Canvas, etc.)
+   * @remarks
+   * This allows the client to interact with resources beyond traditional project datasets.
+   * When configured, methods like `fetch()`, `assets.upload()`, and mutations will operate on the specified resource.
+   * @example
+   * ```ts
+   * createClient({
+   *   resource: {
+   *     type: 'media-library',
+   *     id: 'your-media-library-id'
+   *   }
+   * })
+   * ```
+   */
+  resource?: ClientConfigResource
+  /**
+   * @deprecated Use `resource` instead
+   * @internal
+   */
   '~experimental_resource'?: ClientConfigResource
   /**
    * What perspective to use for the client. See {@link https://www.sanity.io/docs/perspectives|perspective documentation}
@@ -5565,6 +5585,7 @@ export declare interface SanityImageAssetDocument extends SanityAssetDocument {
     isOpaque: boolean
     lqip?: string
     blurHash?: string
+    thumbHash?: string
     dimensions: {
       _type: 'sanity.imageDimensions'
       aspectRatio: number

package/dist/index.d.ts

@@ -430,6 +430,7 @@ export declare type AssetMetadataType =
   | 'palette'
   | 'lqip'
   | 'blurhash'
+  | 'thumbhash'
   | 'none'
 
 /** @internal */
@@ -697,7 +698,26 @@ export declare interface ClientConfig {
   /** @defaultValue true */
   useCdn?: boolean
   token?: string
-  /** @internal */
+  /**
+   * Configure the client to work with a specific Sanity resource (Media Library, Canvas, etc.)
+   * @remarks
+   * This allows the client to interact with resources beyond traditional project datasets.
+   * When configured, methods like `fetch()`, `assets.upload()`, and mutations will operate on the specified resource.
+   * @example
+   * ```ts
+   * createClient({
+   *   resource: {
+   *     type: 'media-library',
+   *     id: 'your-media-library-id'
+   *   }
+   * })
+   * ```
+   */
+  resource?: ClientConfigResource
+  /**
+   * @deprecated Use `resource` instead
+   * @internal
+   */
   '~experimental_resource'?: ClientConfigResource
   /**
    * What perspective to use for the client. See {@link https://www.sanity.io/docs/perspectives|perspective documentation}
@@ -5565,6 +5585,7 @@ export declare interface SanityImageAssetDocument extends SanityAssetDocument {
     isOpaque: boolean
     lqip?: string
     blurHash?: string
+    thumbHash?: string
     dimensions: {
       _type: 'sanity.imageDimensions'
       aspectRatio: number

package/dist/index.js

@@ -905,7 +905,10 @@ 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 hasDataConfig = (client) => client.config().dataset !== void 0 && client.config().projectId !== void 0 || client.config()["~experimental_resource"] !== void 0, isQuery = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "query")), isMutate = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "mutate")), isDoc = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "doc", "")), isListener = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "listen")), isHistory = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "history", "")), isData = (client, uri) => uri.startsWith("/data/") || isQuery(client, uri) || isMutate(client, uri) || isDoc(client, uri) || isListener(client, uri) || isHistory(client, uri);
+const hasDataConfig = (client) => {
+  const config = client.config();
+  return config.dataset !== void 0 && config.projectId !== void 0 || config.resource !== void 0;
+}, isQuery = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "query")), isMutate = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "mutate")), isDoc = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "doc", "")), isListener = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "listen")), isHistory = (client, uri) => hasDataConfig(client) && uri.startsWith(_getDataUrl(client, "history", "")), isData = (client, uri) => uri.startsWith("/data/") || isQuery(client, uri) || isMutate(client, uri) || isDoc(client, uri) || isListener(client, uri) || isHistory(client, 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 && isData(client, uri) : options.canUseCdn;
   let useCdn = (options.useCdn ?? config.useCdn) && canUseCdn;
@@ -938,7 +941,7 @@ function _request(client, httpRequest, options) {
 }
 function _getDataUrl(client, operation, path) {
   const config = client.config();
-  if (config["~experimental_resource"]) {
+  if (config.resource) {
     resourceConfig(config);
     const resourceBase = resourceDataBase(config), uri2 = path !== void 0 ? `${operation}/${path}` : operation;
     return `${resourceBase}/${uri2}`.replace(/\/($|\?)/, "$1");
@@ -971,9 +974,10 @@ function _createAbortError(signal) {
   return error.name = "AbortError", error;
 }
 const resourceDataBase = (config) => {
-  if (!config["~experimental_resource"])
+  const resource = config.resource;
+  if (!resource)
     throw new Error("`resource` must be provided to perform resource queries");
-  const { type, id } = config["~experimental_resource"];
+  const { type, id } = resource;
   switch (type) {
     case "dataset": {
       const segments = id.split(".");
@@ -1134,7 +1138,12 @@ function _upload(client, httpRequest, assetType, body, opts = {}) {
   validateAssetType(assetType);
   let meta = opts.extract || void 0;
   meta && !meta.length && (meta = ["none"]);
-  const config = client.config(), 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, isMediaLibrary = config.resource?.type === "media-library", query = isMediaLibrary ? {
+    // Media Library only supports basic parameters
+    title,
+    filename
+  } : {
+    // Content Lake supports full set of parameters
     label,
     title,
     description,
@@ -1142,7 +1151,7 @@ function _upload(client, httpRequest, assetType, body, opts = {}) {
     meta,
     creditLine
   };
-  return source && (query.sourceId = source.id, query.sourceName = source.name, query.sourceUrl = source.url), _requestObservable(client, httpRequest, {
+  return source && !isMediaLibrary && (query.sourceId = source.id, query.sourceName = source.name, query.sourceUrl = source.url), _requestObservable(client, httpRequest, {
     tag,
     method: "POST",
     timeout: options.timeout || 0,
@@ -1153,9 +1162,9 @@ function _upload(client, httpRequest, assetType, body, opts = {}) {
   });
 }
 function buildAssetUploadUrl(config, assetType) {
-  const assetTypeEndpoint = assetType === "image" ? "images" : "files";
-  if (config["~experimental_resource"]) {
-    const { type, id } = config["~experimental_resource"];
+  const assetTypeEndpoint = assetType === "image" ? "images" : "files", resource = config.resource;
+  if (resource) {
+    const { type, id } = resource;
     switch (type) {
       case "dataset":
         throw new Error(
@@ -1455,7 +1464,7 @@ class ObservableMediaLibraryVideoClient {
    * @param options - Options for transformations and expiration
    */
   getPlaybackInfo(assetIdentifier, options = {}) {
-    const configMediaLibraryId = this.#client.config()["~experimental_resource"]?.id, { instanceId, libraryId } = parseAssetInstanceId(assetIdentifier), effectiveLibraryId = libraryId || configMediaLibraryId;
+    const config = this.#client.config(), configMediaLibraryId = (config.resource || config["~experimental_resource"])?.id, { instanceId, libraryId } = parseAssetInstanceId(assetIdentifier), effectiveLibraryId = libraryId || configMediaLibraryId;
     if (!effectiveLibraryId)
       throw new Error(
         "Could not determine Media Library ID - you need to provide a valid Media Library ID in the client config or a Media Library GDR"
@@ -2668,7 +2677,7 @@ function defineDeprecatedCreateClient(createClient2) {
     return printNoDefaultExport(), createClient2(config);
   };
 }
-var name = "@sanity/client", version = "7.13.1";
+var name = "@sanity/client", version = "7.14.0";
 const middleware = [
   debug({ verbose: !0, namespace: "sanity:client" }),
   headers({ "User-Agent": `${name} ${version}` }),