@decocms/blocks 8.20.0 → 8.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -22,5 +22,21 @@ type InstrumentedFetch = (input: string | URL | Request, init?: RequestInit & {
22
22
  operation?: string;
23
23
  }) => Promise<Response>;
24
24
  export declare function createInstrumentedFetch(options: InstrumentedFetchOptions): InstrumentedFetch;
25
+ /**
26
+ * Report a provider failure found inside an otherwise successful HTTP response.
27
+ * The client owns its protocol's error handling; this only records a sampled
28
+ * log on the CMS's current telemetry pipeline. Do not also report HTTP failures:
29
+ * `createInstrumentedFetch` already records those.
30
+ *
31
+ * Pass static provider/operation identifiers and a curated code, never upstream
32
+ * error messages, arbitrary response codes, documents, variables or shopper data.
33
+ */
34
+ export declare function reportUpstreamError({ provider, operation, code, severity, status, }: {
35
+ provider: string;
36
+ operation: string;
37
+ code: string;
38
+ severity?: "error" | "warn";
39
+ status?: number;
40
+ }): void;
25
41
  export {};
26
42
  //# sourceMappingURL=fetch.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/v8/fetch.ts"],"names":[],"mappings":"AAcA,UAAU,wBAAwB;IAChC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oHAAoH;IACpH,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,yFAAyF;IACzF,cAAc,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KACxC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAYvB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA4G5F"}
1
+ {"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/v8/fetch.ts"],"names":[],"mappings":"AAcA,UAAU,wBAAwB;IAChC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oHAAoH;IACpH,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,yFAAyF;IACzF,cAAc,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KACxC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAYvB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA4G5F;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,QAAkB,EAClB,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAOP"}
package/dist/v8/fetch.js CHANGED
@@ -116,6 +116,23 @@ export function createInstrumentedFetch(options) {
116
116
  return response;
117
117
  };
118
118
  }
119
+ /**
120
+ * Report a provider failure found inside an otherwise successful HTTP response.
121
+ * The client owns its protocol's error handling; this only records a sampled
122
+ * log on the CMS's current telemetry pipeline. Do not also report HTTP failures:
123
+ * `createInstrumentedFetch` already records those.
124
+ *
125
+ * Pass static provider/operation identifiers and a curated code, never upstream
126
+ * error messages, arbitrary response codes, documents, variables or shopper data.
127
+ */
128
+ export function reportUpstreamError({ provider, operation, code, severity = "error", status, }) {
129
+ currentTelemetry()?.[severity](`${provider} ${operation} failed (${code})`, {
130
+ "error.code": code,
131
+ provider,
132
+ operation,
133
+ ...(status === undefined ? {} : { "http.response.status_code": status }),
134
+ });
135
+ }
119
136
  function isAbort(error) {
120
137
  const name = error?.name;
121
138
  return name === "AbortError" || name === "TimeoutError";
@@ -1 +1 @@
1
- {"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/v8/fetch.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/v8/fetch.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@decocms/blocks",
3
- "version": "8.20.0",
3
+ "version": "8.20.1",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=24"
@@ -51,9 +51,19 @@ const data = await shopify.storefront.query<ProductByHandleQuery, { handle: stri
51
51
  | Case | `codes` |
52
52
  |---|---|
53
53
  | HTTP error | `[]` |
54
- | GraphQL `errors` | each error's `extensions.code`, or `UNKNOWN`, deduplicated |
54
+ | GraphQL `errors` | recognized `extensions.code` values, or `UNKNOWN`, deduplicated |
55
55
  | No `data` | `["MISSING_DATA"]` |
56
56
  | Body isn't JSON (an HTML error page) | `["INVALID_JSON"]` |
57
+ | Invalid GraphQL envelope or non-object `data` | `["INVALID_RESPONSE"]` |
58
+
59
+ HTTP failures use the shared fetch logs. HTTP-success GraphQL failures emit one
60
+ sampled log before rejecting: internal, unknown and malformed responses are ERROR;
61
+ throttling, access, inactive-shop and recognized query-validation failures are WARN.
62
+ Messages, variables, tokens and arbitrary upstream codes are never included. Both
63
+ levels follow the CMS's `errorSampleRate` and telemetry enable switch.
64
+
65
+ Mutation `userErrors`, `customerUserErrors` and cart warnings inside `data` are
66
+ returned unchanged and do not emit a log. Sites own their validation and UX.
57
67
 
58
68
  A response with both `data` and `errors` is rejected as a whole. The client doesn't
59
69
  guess which fields are still trustworthy. If a query can partly fail and you still want
package/src/v8/fetch.ts CHANGED
@@ -152,6 +152,36 @@ export function createInstrumentedFetch(options: InstrumentedFetchOptions): Inst
152
152
  };
153
153
  }
154
154
 
155
+ /**
156
+ * Report a provider failure found inside an otherwise successful HTTP response.
157
+ * The client owns its protocol's error handling; this only records a sampled
158
+ * log on the CMS's current telemetry pipeline. Do not also report HTTP failures:
159
+ * `createInstrumentedFetch` already records those.
160
+ *
161
+ * Pass static provider/operation identifiers and a curated code, never upstream
162
+ * error messages, arbitrary response codes, documents, variables or shopper data.
163
+ */
164
+ export function reportUpstreamError({
165
+ provider,
166
+ operation,
167
+ code,
168
+ severity = "error",
169
+ status,
170
+ }: {
171
+ provider: string;
172
+ operation: string;
173
+ code: string;
174
+ severity?: "error" | "warn";
175
+ status?: number;
176
+ }): void {
177
+ currentTelemetry()?.[severity](`${provider} ${operation} failed (${code})`, {
178
+ "error.code": code,
179
+ provider,
180
+ operation,
181
+ ...(status === undefined ? {} : { "http.response.status_code": status }),
182
+ });
183
+ }
184
+
155
185
  function isAbort(error: unknown): boolean {
156
186
  const name = (error as { name?: unknown } | null)?.name;
157
187
  return name === "AbortError" || name === "TimeoutError";