@sanity/client 7.21.0 → 7.22.0

package/dist/stega.browser.d.cts

@@ -855,6 +855,7 @@ export declare class ClientError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any, context?: HttpContext)
 }
@@ -1515,6 +1516,7 @@ export declare interface ErrorProps {
   response: Any
   statusCode: number
   responseBody: Any
+  traceId?: string
   details: Any
 }
 
@@ -1714,7 +1716,11 @@ export declare type FitMode = 'preserve' | 'stretch' | 'crop' | 'smartcrop' | 'p
  * @returns A formatted error message string.
  * @public
  */
-export declare function formatQueryParseError(error: QueryParseError, tag?: string | null): string
+export declare function formatQueryParseError(
+  error: QueryParseError,
+  tag?: string | null,
+  traceId?: string,
+): string
 
 /** @beta */
 declare type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
@@ -6061,6 +6067,7 @@ export declare class ServerError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any)
 }

package/dist/stega.browser.d.ts

@@ -855,6 +855,7 @@ export declare class ClientError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any, context?: HttpContext)
 }
@@ -1515,6 +1516,7 @@ export declare interface ErrorProps {
   response: Any
   statusCode: number
   responseBody: Any
+  traceId?: string
   details: Any
 }
 
@@ -1714,7 +1716,11 @@ export declare type FitMode = 'preserve' | 'stretch' | 'crop' | 'smartcrop' | 'p
  * @returns A formatted error message string.
  * @public
  */
-export declare function formatQueryParseError(error: QueryParseError, tag?: string | null): string
+export declare function formatQueryParseError(
+  error: QueryParseError,
+  tag?: string | null,
+  traceId?: string,
+): string
 
 /** @beta */
 declare type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
@@ -6061,6 +6067,7 @@ export declare class ServerError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any)
 }

package/dist/stega.d.cts

@@ -855,6 +855,7 @@ export declare class ClientError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any, context?: HttpContext)
 }
@@ -1515,6 +1516,7 @@ export declare interface ErrorProps {
   response: Any
   statusCode: number
   responseBody: Any
+  traceId?: string
   details: Any
 }
 
@@ -1714,7 +1716,11 @@ export declare type FitMode = 'preserve' | 'stretch' | 'crop' | 'smartcrop' | 'p
  * @returns A formatted error message string.
  * @public
  */
-export declare function formatQueryParseError(error: QueryParseError, tag?: string | null): string
+export declare function formatQueryParseError(
+  error: QueryParseError,
+  tag?: string | null,
+  traceId?: string,
+): string
 
 /** @beta */
 declare type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
@@ -6061,6 +6067,7 @@ export declare class ServerError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any)
 }

package/dist/stega.d.ts

@@ -855,6 +855,7 @@ export declare class ClientError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any, context?: HttpContext)
 }
@@ -1515,6 +1516,7 @@ export declare interface ErrorProps {
   response: Any
   statusCode: number
   responseBody: Any
+  traceId?: string
   details: Any
 }
 
@@ -1714,7 +1716,11 @@ export declare type FitMode = 'preserve' | 'stretch' | 'crop' | 'smartcrop' | 'p
  * @returns A formatted error message string.
  * @public
  */
-export declare function formatQueryParseError(error: QueryParseError, tag?: string | null): string
+export declare function formatQueryParseError(
+  error: QueryParseError,
+  tag?: string | null,
+  traceId?: string,
+): string
 
 /** @beta */
 declare type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
@@ -6061,6 +6067,7 @@ export declare class ServerError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode']
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
   constructor(res: Any)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/client",
-  "version": "7.21.0",
+  "version": "7.22.0",
   "description": "Client for retrieving, creating and patching data from Sanity.io",
   "keywords": [
     "sanity",

package/src/http/errors.ts

@@ -64,6 +64,7 @@ export class ClientError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode'] = 400
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
 
   constructor(res: Any, context?: HttpContext) {
@@ -78,6 +79,7 @@ export class ServerError extends Error {
   response: ErrorProps['response']
   statusCode: ErrorProps['statusCode'] = 500
   responseBody: ErrorProps['responseBody']
+  traceId: ErrorProps['traceId']
   details: ErrorProps['details']
 
   constructor(res: Any) {
@@ -93,13 +95,14 @@ function extractErrorProps(res: Any, context?: HttpContext): ErrorProps {
     response: res,
     statusCode: res.statusCode,
     responseBody: stringifyBody(body, res),
+    traceId: extractTraceId(res),
     message: '',
     details: undefined as Any,
   }
 
   // Fall back early if we didn't get a JSON object returned as expected
   if (!isRecord(body)) {
-    props.message = httpErrorMessage(res, body)
+    props.message = `${httpErrorMessage(res, body)}${formatTraceId(props.traceId)}`
     return props
   }
 
@@ -107,18 +110,18 @@ function extractErrorProps(res: Any, context?: HttpContext): ErrorProps {
 
   // API/Boom style errors ({statusCode, error, message})
   if (typeof error === 'string' && typeof body.message === 'string') {
-    props.message = `${error} - ${body.message}`
+    props.message = `${error} - ${body.message}${formatTraceId(props.traceId)}`
     return props
   }
 
   // Content Lake errors with a `error` prop being an object
   if (typeof error !== 'object' || error === null) {
     if (typeof error === 'string') {
-      props.message = error
+      props.message = `${error}${formatTraceId(props.traceId)}`
     } else if (typeof body.message === 'string') {
-      props.message = body.message
+      props.message = `${body.message}${formatTraceId(props.traceId)}`
     } else {
-      props.message = httpErrorMessage(res, body)
+      props.message = `${httpErrorMessage(res, body)}${formatTraceId(props.traceId)}`
     }
     return props
   }
@@ -134,7 +137,7 @@ function extractErrorProps(res: Any, context?: HttpContext): ErrorProps {
     if (allItems.length > MAX_ITEMS_IN_ERROR_MESSAGE) {
       itemsStr += `\n...and ${allItems.length - MAX_ITEMS_IN_ERROR_MESSAGE} more`
     }
-    props.message = `${error.description}${itemsStr}`
+    props.message = `${error.description}${formatTraceId(props.traceId)}${itemsStr}`
     props.details = body.error
     return props
   }
@@ -142,20 +145,20 @@ function extractErrorProps(res: Any, context?: HttpContext): ErrorProps {
   // Query parse errors
   if (isQueryParseError(error)) {
     const tag = context?.options?.query?.tag
-    props.message = formatQueryParseError(error, tag)
+    props.message = formatQueryParseError(error, tag, props.traceId)
     props.details = body.error
     return props
   }
 
   if ('description' in error && typeof error.description === 'string') {
     // Query/database errors ({error: {description, other, arb, props}})
-    props.message = error.description
+    props.message = `${error.description}${formatTraceId(props.traceId)}`
     props.details = error
     return props
   }
 
   // Other, more arbitrary errors
-  props.message = httpErrorMessage(res, body)
+  props.message = `${httpErrorMessage(res, body)}${formatTraceId(props.traceId)}`
   return props
 }
 
@@ -196,17 +199,22 @@ export function isQueryParseError(error: object): error is QueryParseError {
  * @returns A formatted error message string.
  * @public
  */
-export function formatQueryParseError(error: QueryParseError, tag?: string | null) {
+export function formatQueryParseError(
+  error: QueryParseError,
+  tag?: string | null,
+  traceId?: string,
+) {
   const {query, start, end, description} = error
+  const withTraceId = traceId ? `\n(traceId: ${traceId})` : ''
 
   if (!query || typeof start === 'undefined') {
-    return `GROQ query parse error: ${description}`
+    return `GROQ query parse error: ${description}${withTraceId}`
   }
 
   const withTag = tag ? `\n\nTag: ${tag}` : ''
   const framed = codeFrame(query, {start, end}, description)
 
-  return `GROQ query parse error:\n${framed}${withTag}`
+  return `GROQ query parse error:\n${framed}${withTag}${withTraceId}`
 }
 
 function httpErrorMessage(res: Any, body: unknown) {
@@ -215,12 +223,33 @@ function httpErrorMessage(res: Any, body: unknown) {
   return `${res.method}-request to ${res.url} resulted in HTTP ${res.statusCode}${statusMessage}${details}`
 }
 
+/**
+ * Extract the traceId from the traceparent header on the response.
+ *
+ * The traceparent is on the format [version]-[traceId]-[parentId]-[traceFlags], but
+ * when debugging end-user issues it's the traceId we need to be able to get hold of
+ * the relevant traces.
+ *
+ * @see https://www.w3.org/TR/trace-context/
+ * @returns The traceId for HTTP response
+ */
+function extractTraceId(res: Any): string | undefined {
+  const traceparent = res?.headers?.['traceparent']
+  if (!traceparent) return
+
+  return traceparent.split('-')[1]
+}
+
 function stringifyBody(body: Any, res: Any) {
   const contentType = (res.headers['content-type'] || '').toLowerCase()
   const isJson = contentType.indexOf('application/json') !== -1
   return isJson ? JSON.stringify(body, null, 2) : body
 }
 
+function formatTraceId(traceId: string | undefined): string {
+  return traceId ? ` (traceId: ${traceId})` : ''
+}
+
 function sliceWithEllipsis(str: string, max: number) {
   return str.length > max ? `${str.slice(0, max)}…` : str
 }

package/src/types.ts

@@ -433,6 +433,7 @@ export interface ErrorProps {
   response: Any
   statusCode: number
   responseBody: Any
+  traceId?: string
   details: Any
 }
 

package/umd/sanityClient.js

@@ -2059,6 +2059,7 @@
     response;
     statusCode = 400;
     responseBody;
+    traceId;
     details;
     constructor(res, context) {
       const props = extractErrorProps(res, context);
@@ -2069,6 +2070,7 @@
     response;
     statusCode = 500;
     responseBody;
+    traceId;
     details;
     constructor(res) {
       const props = extractErrorProps(res);
@@ -2080,29 +2082,30 @@
       response: res,
       statusCode: res.statusCode,
       responseBody: stringifyBody(body, res),
+      traceId: extractTraceId(res),
       message: "",
       details: void 0
     };
     if (!isRecord(body))
-      return props.message = httpErrorMessage(res, body), props;
+      return props.message = `${httpErrorMessage(res, body)}${formatTraceId(props.traceId)}`, props;
     const error = body.error;
     if (typeof error == "string" && typeof body.message == "string")
-      return props.message = `${error} - ${body.message}`, props;
+      return props.message = `${error} - ${body.message}${formatTraceId(props.traceId)}`, props;
     if (typeof error != "object" || error === null)
-      return typeof error == "string" ? props.message = error : typeof body.message == "string" ? props.message = body.message : props.message = httpErrorMessage(res, body), props;
+      return typeof error == "string" ? props.message = `${error}${formatTraceId(props.traceId)}` : typeof body.message == "string" ? props.message = `${body.message}${formatTraceId(props.traceId)}` : props.message = `${httpErrorMessage(res, body)}${formatTraceId(props.traceId)}`, props;
     if (isMutationError(error) || isActionError(error)) {
       const allItems = error.items || [], items = allItems.slice(0, MAX_ITEMS_IN_ERROR_MESSAGE).map((item) => item.error?.description).filter(Boolean);
       let itemsStr = items.length ? `:
 - ${items.join(`
 - `)}` : "";
       return allItems.length > MAX_ITEMS_IN_ERROR_MESSAGE && (itemsStr += `
-...and ${allItems.length - MAX_ITEMS_IN_ERROR_MESSAGE} more`), props.message = `${error.description}${itemsStr}`, props.details = body.error, props;
+...and ${allItems.length - MAX_ITEMS_IN_ERROR_MESSAGE} more`), props.message = `${error.description}${formatTraceId(props.traceId)}${itemsStr}`, props.details = body.error, props;
     }
     if (isQueryParseError(error)) {
       const tag = context?.options?.query?.tag;
-      return props.message = formatQueryParseError(error, tag), props.details = body.error, props;
+      return props.message = formatQueryParseError(error, tag, props.traceId), props.details = body.error, props;
     }
-    return "description" in error && typeof error.description == "string" ? (props.message = error.description, props.details = error, props) : (props.message = httpErrorMessage(res, body), props);
+    return "description" in error && typeof error.description == "string" ? (props.message = `${error.description}${formatTraceId(props.traceId)}`, props.details = error, props) : (props.message = `${httpErrorMessage(res, body)}${formatTraceId(props.traceId)}`, props);
   }
   function isMutationError(error) {
     return "type" in error && error.type === "mutationError" && "description" in error && typeof error.description == "string";
@@ -2113,23 +2116,32 @@
   function isQueryParseError(error) {
     return isRecord(error) && error.type === "queryParseError" && typeof error.query == "string" && typeof error.start == "number" && typeof error.end == "number";
   }
-  function formatQueryParseError(error, tag) {
-    const { query, start, end, description } = error;
+  function formatQueryParseError(error, tag, traceId) {
+    const { query, start, end, description } = error, withTraceId = traceId ? `
+(traceId: ${traceId})` : "";
     if (!query || typeof start > "u")
-      return `GROQ query parse error: ${description}`;
+      return `GROQ query parse error: ${description}${withTraceId}`;
     const withTag = tag ? `
 
 Tag: ${tag}` : "";
     return `GROQ query parse error:
-${codeFrame(query, { start, end }, description)}${withTag}`;
+${codeFrame(query, { start, end }, description)}${withTag}${withTraceId}`;
   }
   function httpErrorMessage(res, body) {
     const details = typeof body == "string" ? ` (${sliceWithEllipsis(body, 100)})` : "", statusMessage = res.statusMessage ? ` ${res.statusMessage}` : "";
     return `${res.method}-request to ${res.url} resulted in HTTP ${res.statusCode}${statusMessage}${details}`;
   }
+  function extractTraceId(res) {
+    const traceparent = res?.headers?.traceparent;
+    if (traceparent)
+      return traceparent.split("-")[1];
+  }
   function stringifyBody(body, res) {
     return (res.headers["content-type"] || "").toLowerCase().indexOf("application/json") !== -1 ? JSON.stringify(body, null, 2) : body;
   }
+  function formatTraceId(traceId) {
+    return traceId ? ` (traceId: ${traceId})` : "";
+  }
   function sliceWithEllipsis(str, max) {
     return str.length > max ? `${str.slice(0, max)}\u2026` : str;
   }