@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.
- package/dist/v8/fetch.d.ts +16 -0
- package/dist/v8/fetch.d.ts.map +1 -1
- package/dist/v8/fetch.js +17 -0
- package/dist/v8/fetch.js.map +1 -1
- package/package.json +1 -1
- package/skills/deco-apps/references/shopify.md +11 -1
- package/src/v8/fetch.ts +30 -0
package/dist/v8/fetch.d.ts
CHANGED
|
@@ -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
|
package/dist/v8/fetch.d.ts.map
CHANGED
|
@@ -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";
|
package/dist/v8/fetch.js.map
CHANGED
|
@@ -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":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAsBxE,+DAA+D;AAC/D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACrD;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5D,yDAAyD;AACzD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAExE,MAAM,UAAU,uBAAuB,CAAC,OAAiC;IACvE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACpD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE;QAChC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,CACb,WAAW,CAAC,MAAM,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CACxE,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QAClD,MAAM,UAAU,GACd,KAAK,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,QAA8B,CAAC;QACnC,IAAI,OAAgB,CAAC;QAErB,IAAI,cAAc,IAAI,QAAQ,IAAI,cAAc,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;YACpF,OAAO,GAAG,IAAI,KAAK,CAAC,GAAG,QAAQ,IAAI,SAAS,wBAAwB,QAAQ,WAAW,CAAC,CAAC;QAC3F,CAAC;aAAM,CAAC;YACN,SAAS,CAAC;gBACR,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,OAAO,CACtB,UAAU,GAAG,CAAC,IAAI,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,EAClE,WAAW,CACZ,CAAC;oBACF,OAAO,GAAG,SAAS,CAAC;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,GAAG,SAAS,CAAC;oBACrB,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC;gBACD,MAAM,SAAS,GACb,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnF,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,UAAU;oBAAE,MAAM;gBAC/C,KAAK,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC9C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAC9D,CAAC;gBACF,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;gBAChE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,IAAI,MAAM,IAAI,QAAQ,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;oBAClD,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACrC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG;gBACb,QAAQ;gBACR,SAAS;gBACT,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;gBAC3E,qFAAqF;gBACrF,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK;gBAClD,OAAO;aACR,CAAC;YACF,SAAS,CAAC,SAAS,CACjB,8BAA8B,EAC9B,MAAM,EACN,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CACrC,CAAC;YACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,SAAS,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,SAAS,YAAY,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE;oBACvE,YAAY,EAAE,cAAc;oBAC5B,QAAQ;oBACR,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAC/B,MAAM,KAAK,GACT,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;oBAC3B,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;wBAC5B,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,SAAS,CAAC;gBAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,IAAI,SAAS,qBAAqB,MAAM,EAAE,EAAE;wBACtE,YAAY,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,oBAAoB;wBAC3E,QAAQ;wBACR,SAAS;wBACT,qBAAqB,EAAE,MAAM;wBAC7B,2BAA2B,EAAE,MAAM;wBACnC,OAAO;wBACP,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5B,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,GAAG,QAAQ,IAAI,SAAS,EAAE;oBAChC,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,UAAU,EAAE;oBACrB,KAAK,EAAE,SAAS;oBAChB,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;oBACf,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,EAAE;oBACxE,KAAK,EAAE,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,QAAQ,GAAG,OAAO,EAClB,MAAM,GAOP;IACC,gBAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,IAAI,SAAS,YAAY,IAAI,GAAG,EAAE;QAC1E,YAAY,EAAE,IAAI;QAClB,QAAQ;QACR,SAAS;QACT,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,2BAA2B,EAAE,MAAM,EAAE,CAAC;KACzE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,CAAC;AAC1D,CAAC"}
|
package/package.json
CHANGED
|
@@ -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` |
|
|
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";
|