@decocms/blocks 8.19.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.
@@ -32,6 +32,16 @@ export interface AnalyticsClientOptions {
32
32
  heatmapRate?: number;
33
33
  /** Errors module: cross-origin script hosts that count as the site's own. */
34
34
  errorHosts?: string[];
35
+ /**
36
+ * The visitor's A/B tests as the page rendered them: each test of the saved `experiments`
37
+ * block on or off, exactly the map that decided the page (on TanStack, what the worker
38
+ * decided, `requestAssignments(request)?.experiments`). Every event then carries each test's
39
+ * arm, `on` or `off`, in `exp`, the first page view included, and the collector stores it as
40
+ * it stores any `exp`. Passing the decision rather than an id keeps what is measured equal to
41
+ * what was shown, a preview's switched tests and a release change included. Leave it unset
42
+ * on a preview, whose switched tests are no visitor's.
43
+ */
44
+ experiments?: Readonly<Record<string, boolean>>;
35
45
  }
36
46
  /**
37
47
  * Starts collection in the browser: the page view now and on every client-side
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/v8/analytics/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,UAAU,GACV,SAAS,GACT,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAcD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAsCzC"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/v8/analytics/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,UAAU,GACV,SAAS,GACT,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjD;AA2BD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAkDzC"}
@@ -8,6 +8,18 @@
8
8
  * `startAnalytics()` does the work in the browser and never rejects, so a
9
9
  * failure is "analytics stopped", never "the page broke".
10
10
  */
11
+ /** The decided tests as the collector's `exp` values, `on` or `off`; non-boolean entries left out. */
12
+ function armsOf(experiments) {
13
+ const arms = Object.create(null);
14
+ if (typeof experiments !== "object" || experiments === null)
15
+ return arms;
16
+ for (const name of Object.keys(experiments)) {
17
+ const on = experiments[name];
18
+ if (typeof on === "boolean")
19
+ arms[name] = on ? "on" : "off";
20
+ }
21
+ return arms;
22
+ }
11
23
  /** One loader per file, so a bundler splits each module into its own chunk. */
12
24
  const MODULES = {
13
25
  click: () => import("./runtime/modules/click.js"),
@@ -35,8 +47,15 @@ export async function startAnalytics(options = {}) {
35
47
  return null;
36
48
  const w = window;
37
49
  try {
38
- if (w.__dqBooted)
39
- return typeof w.__dq?.track === "function" ? w.__dq : null;
50
+ const arms = armsOf(options.experiments);
51
+ if (w.__dqBooted) {
52
+ // The tag booted first: its API is the client, so the arms go through it.
53
+ if (typeof w.__dq?.track !== "function")
54
+ return null;
55
+ for (const name of Object.keys(arms))
56
+ w.__dq.setExperiment?.(name, arms[name]);
57
+ return w.__dq;
58
+ }
40
59
  // The same fields the collector writes ahead of `/_dq/a.js`, and the same precedence: what
41
60
  // the page already set on `window.__dq` wins. `q` is held back and replayed below, once
42
61
  // every module has registered: core replays its stub in a microtask, and a module in its
@@ -53,13 +72,20 @@ export async function startAnalytics(options = {}) {
53
72
  ...(options.key ? { k: options.key } : {}),
54
73
  ...(options.heatmapRate !== undefined ? { hr: options.heatmapRate } : {}),
55
74
  ...(options.errorHosts?.length ? { er: options.errorHosts } : {}),
56
- }, page, { q: [] });
75
+ }, page,
76
+ // The page's own map (another script's tests) is kept; on a name both carry, the arm the
77
+ // page rendered wins. Set before core boots, so the first page view carries it.
78
+ Object.keys(arms).length ? { x: { ...page.x, ...arms } } : {}, { q: [] });
57
79
  await import("./runtime/src/index.js");
58
80
  // Core assigns its API only when it collects; skipped means skipped, modules included.
59
81
  if (typeof w.__dq.track !== "function")
60
82
  return null;
61
83
  for (const name of new Set(options.modules ?? []))
62
84
  await MODULES[name]?.();
85
+ // A module may set a test of its own on load: `deco` reads v7's `deco_segment`, which a
86
+ // migrated visitor still carries and v8 never rewrites. The arm the page rendered wins.
87
+ for (const name of Object.keys(arms))
88
+ w.__dq.setExperiment?.(name, arms[name]);
63
89
  for (const r of queued)
64
90
  w.__dq.q?.push?.(r);
65
91
  return w.__dq;
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/v8/analytics/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/v8/analytics/client.ts"],"names":[],"mappings":"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"}
@@ -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.19.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
@@ -42,6 +42,29 @@ export interface AnalyticsClientOptions {
42
42
  heatmapRate?: number;
43
43
  /** Errors module: cross-origin script hosts that count as the site's own. */
44
44
  errorHosts?: string[];
45
+ /**
46
+ * The visitor's A/B tests as the page rendered them: each test of the saved `experiments`
47
+ * block on or off, exactly the map that decided the page (on TanStack, what the worker
48
+ * decided, `requestAssignments(request)?.experiments`). Every event then carries each test's
49
+ * arm, `on` or `off`, in `exp`, the first page view included, and the collector stores it as
50
+ * it stores any `exp`. Passing the decision rather than an id keeps what is measured equal to
51
+ * what was shown, a preview's switched tests and a release change included. Leave it unset
52
+ * on a preview, whose switched tests are no visitor's.
53
+ */
54
+ experiments?: Readonly<Record<string, boolean>>;
55
+ }
56
+
57
+ /** The decided tests as the collector's `exp` values, `on` or `off`; non-boolean entries left out. */
58
+ function armsOf(
59
+ experiments: Readonly<Record<string, boolean>> | undefined,
60
+ ): Record<string, string> {
61
+ const arms = Object.create(null) as Record<string, string>;
62
+ if (typeof experiments !== "object" || experiments === null) return arms;
63
+ for (const name of Object.keys(experiments)) {
64
+ const on = experiments[name];
65
+ if (typeof on === "boolean") arms[name] = on ? "on" : "off";
66
+ }
67
+ return arms;
45
68
  }
46
69
 
47
70
  /** One loader per file, so a bundler splits each module into its own chunk. */
@@ -73,7 +96,13 @@ export async function startAnalytics(
73
96
  if (typeof window === "undefined") return null;
74
97
  const w = window as unknown as Record<string, any>;
75
98
  try {
76
- if (w.__dqBooted) return typeof w.__dq?.track === "function" ? w.__dq : null;
99
+ const arms = armsOf(options.experiments);
100
+ if (w.__dqBooted) {
101
+ // The tag booted first: its API is the client, so the arms go through it.
102
+ if (typeof w.__dq?.track !== "function") return null;
103
+ for (const name of Object.keys(arms)) w.__dq.setExperiment?.(name, arms[name]);
104
+ return w.__dq;
105
+ }
77
106
 
78
107
  // The same fields the collector writes ahead of `/_dq/a.js`, and the same precedence: what
79
108
  // the page already set on `window.__dq` wins. `q` is held back and replayed below, once
@@ -94,6 +123,9 @@ export async function startAnalytics(
94
123
  ...(options.errorHosts?.length ? { er: options.errorHosts } : {}),
95
124
  },
96
125
  page,
126
+ // The page's own map (another script's tests) is kept; on a name both carry, the arm the
127
+ // page rendered wins. Set before core boots, so the first page view carries it.
128
+ Object.keys(arms).length ? { x: { ...(page.x as object), ...arms } } : {},
97
129
  { q: [] },
98
130
  );
99
131
 
@@ -102,6 +134,9 @@ export async function startAnalytics(
102
134
  if (typeof w.__dq.track !== "function") return null;
103
135
 
104
136
  for (const name of new Set(options.modules ?? [])) await MODULES[name]?.();
137
+ // A module may set a test of its own on load: `deco` reads v7's `deco_segment`, which a
138
+ // migrated visitor still carries and v8 never rewrites. The arm the page rendered wins.
139
+ for (const name of Object.keys(arms)) w.__dq.setExperiment?.(name, arms[name]);
105
140
  for (const r of queued) w.__dq.q?.push?.(r);
106
141
  return w.__dq;
107
142
  } catch {
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";