@heyplaybook/hydrogen 0.2.0 → 0.3.0

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/index.js CHANGED
@@ -1,12 +1,12 @@
1
- import { createContext, useContext, useMemo, useCallback, useState, useEffect } from 'react';
2
- import { jsx, Fragment } from 'react/jsx-runtime';
1
+ import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
2
+ import { createContext, Component, useContext, useMemo, useCallback, useState, useEffect, useSyncExternalStore, useRef } from 'react';
3
3
 
4
4
  // src/growthbook.ts
5
- function hashFnv32a(str) {
5
+ function hashFnv32a(str2) {
6
6
  let hval = 2166136261;
7
- const l = str.length;
7
+ const l = str2.length;
8
8
  for (let i = 0; i < l; i++) {
9
- hval ^= str.charCodeAt(i);
9
+ hval ^= str2.charCodeAt(i);
10
10
  hval += (hval << 1) + (hval << 4) + (hval << 7) + (hval << 8) + (hval << 24);
11
11
  }
12
12
  return hval >>> 0;
@@ -411,6 +411,7 @@ async function verifyPreviewToken({
411
411
  var FRESH_MS = 6e4;
412
412
  var STALE_MS = 3e5;
413
413
  var RENDER_BUDGET_MS = 300;
414
+ var FAILURE_BACKOFF_MS = 3e4;
414
415
  var FETCH_TIMEOUT_MS = 5e3;
415
416
  var memory = /* @__PURE__ */ new Map();
416
417
  function rulesUrl(platformUrl, shopId) {
@@ -418,12 +419,53 @@ function rulesUrl(platformUrl, shopId) {
418
419
  url.searchParams.set("shop", shopId);
419
420
  return url.toString();
420
421
  }
421
- function isRuleset(value) {
422
- const v = value;
423
- return !!v && typeof v === "object" && Array.isArray(v.tests) && v.tests.every(
424
- (t) => t && typeof t.key === "string" && typeof t.status === "string" && Array.isArray(t.arms) && t.arms.every((a) => a && typeof a.key === "string")
422
+ var STATUSES = /* @__PURE__ */ new Set(["running", "paused", "completed"]);
423
+ var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
424
+ var isNum = (v) => typeof v === "number" && Number.isFinite(v);
425
+ var optional = (v, check) => v === void 0 || v === null || check(v);
426
+ function isValidRule(t) {
427
+ if (!isObj(t)) return false;
428
+ if (typeof t.key !== "string" || !t.key || t.key.length > 64) return false;
429
+ if (typeof t.status !== "string" || !STATUSES.has(t.status)) return false;
430
+ if (!Array.isArray(t.arms) || !t.arms.every(
431
+ (a) => isObj(a) && typeof a.key === "string" && !!a.key && isNum(a.weight) && a.weight >= 0
432
+ )) {
433
+ return false;
434
+ }
435
+ if (!optional(t.seed, (v) => typeof v === "string")) return false;
436
+ if (!optional(t.hashVersion, isNum)) return false;
437
+ if (!optional(t.coverage, (v) => isNum(v) && v >= 0 && v <= 1)) return false;
438
+ if (!optional(t.winner, (v) => typeof v === "string")) return false;
439
+ if (!optional(t.config, isObj)) return false;
440
+ if (!optional(
441
+ t.namespace,
442
+ (v) => isObj(v) && typeof v.id === "string" && Array.isArray(v.range) && v.range.length === 2 && v.range.every(isNum)
443
+ )) {
444
+ return false;
445
+ }
446
+ return optional(
447
+ t.targeting,
448
+ (v) => isObj(v) && optional(
449
+ v.pathPrefix,
450
+ (p) => Array.isArray(p) && p.every((s2) => typeof s2 === "string")
451
+ ) && optional(v.device, (d) => d === "mobile" || d === "desktop") && optional(v.visitorType, (d) => d === "new" || d === "returning")
425
452
  );
426
453
  }
454
+ function sanitizeRuleset(value) {
455
+ if (!isObj(value) || !Array.isArray(value.tests)) return null;
456
+ if (typeof value.version !== "string") return null;
457
+ const tests = value.tests.filter(isValidRule);
458
+ if (tests.length !== value.tests.length) {
459
+ console.warn(
460
+ "[playbook] dropped invalid rules",
461
+ value.tests.length - tests.length
462
+ );
463
+ }
464
+ return { ...value, tests };
465
+ }
466
+ function inBackoff(entry, now) {
467
+ return entry.failedAt > 0 && now - entry.failedAt < FAILURE_BACKOFF_MS;
468
+ }
427
469
  function refresh(key, url, entry, fetchImpl) {
428
470
  if (entry.inflight) return entry.inflight;
429
471
  const controller = new AbortController();
@@ -433,12 +475,14 @@ function refresh(key, url, entry, fetchImpl) {
433
475
  signal: controller.signal
434
476
  }).then(async (res) => {
435
477
  if (!res.ok) throw new Error(`ruleset ${res.status}`);
436
- const json = await res.json();
437
- if (!isRuleset(json)) throw new Error("ruleset malformed");
478
+ const json = sanitizeRuleset(await res.json());
479
+ if (!json) throw new Error("ruleset malformed");
438
480
  entry.ruleset = json;
439
481
  entry.fetchedAt = Date.now();
482
+ entry.failedAt = 0;
440
483
  return json;
441
484
  }).catch((error) => {
485
+ entry.failedAt = Date.now();
442
486
  console.warn("[playbook] ruleset fetch failed", String(error));
443
487
  return entry.ruleset;
444
488
  }).finally(() => {
@@ -449,6 +493,7 @@ function refresh(key, url, entry, fetchImpl) {
449
493
  return entry.inflight;
450
494
  }
451
495
  var COLD_RENDER_BUDGET_MS = 1500;
496
+ var BUDGET_MISSED = /* @__PURE__ */ Symbol("budget-missed");
452
497
  async function getRulesetWithSource({
453
498
  platformUrl,
454
499
  shopId,
@@ -460,12 +505,17 @@ async function getRulesetWithSource({
460
505
  const entry = memory.get(key) ?? {
461
506
  ruleset: null,
462
507
  fetchedAt: 0,
508
+ failedAt: 0,
463
509
  inflight: null
464
510
  };
465
- const age = Date.now() - entry.fetchedAt;
511
+ const now = Date.now();
512
+ const age = now - entry.fetchedAt;
466
513
  if (entry.ruleset && age < FRESH_MS) {
467
514
  return { ruleset: entry.ruleset, source: "memory" };
468
515
  }
516
+ if (inBackoff(entry, now)) {
517
+ return { ruleset: entry.ruleset, source: "backoff" };
518
+ }
469
519
  if (entry.ruleset && age < FRESH_MS + STALE_MS) {
470
520
  const p2 = refresh(key, url, entry, fetchImpl);
471
521
  waitUntil?.(p2);
@@ -477,14 +527,17 @@ async function getRulesetWithSource({
477
527
  let timer;
478
528
  const budget = new Promise((resolve) => {
479
529
  timer = setTimeout(
480
- () => resolve(null),
530
+ () => resolve(BUDGET_MISSED),
481
531
  lastGood ? RENDER_BUDGET_MS : COLD_RENDER_BUDGET_MS
482
532
  );
483
533
  });
484
534
  const result = await Promise.race([p, budget]);
485
535
  clearTimeout(timer);
486
- if (result && result !== lastGood)
536
+ if (result === BUDGET_MISSED) {
537
+ if (entry.inflight && entry.failedAt === 0) entry.failedAt = Date.now();
538
+ } else if (result && result !== lastGood) {
487
539
  return { ruleset: result, source: "fetched" };
540
+ }
488
541
  if (lastGood) return { ruleset: lastGood, source: "last-good" };
489
542
  return { ruleset: null, source: "cold-fallback" };
490
543
  }
@@ -527,7 +580,8 @@ async function createPlaybook({
527
580
  waitUntil,
528
581
  fetchImpl,
529
582
  overrides,
530
- consentRequired = false
583
+ consentRequired = false,
584
+ consent: consentAdapter
531
585
  }) {
532
586
  const url = new URL(request.url);
533
587
  const device = detectDevice(request.headers.get("user-agent"));
@@ -561,7 +615,7 @@ async function createPlaybook({
561
615
  const domain = cookieDomainFor(url.hostname);
562
616
  const secure = url.protocol === "https:";
563
617
  const setCookieHeaders = [];
564
- let consent = analyticsConsentFromCookie(cookies[TRACKING_CONSENT_COOKIE]);
618
+ let consent = consentAdapter ? consentAdapter.fromRequest(request) : analyticsConsentFromCookie(cookies[TRACKING_CONSENT_COOKIE]);
565
619
  if (consent === "absent" && consentRequired) consent = "pending";
566
620
  const persistentAllowed = consent === "granted" || consent === "absent";
567
621
  const existing = [
@@ -603,7 +657,7 @@ async function createPlaybook({
603
657
  })
604
658
  );
605
659
  }
606
- if (cookies[VISITOR_COOKIE]) {
660
+ if (consent === "denied" && cookies[VISITOR_COOKIE]) {
607
661
  setCookieHeaders.push(
608
662
  serializeCookie(VISITOR_COOKIE, "", { maxAge: 0, secure })
609
663
  );
@@ -714,6 +768,454 @@ async function createPlaybook({
714
768
  };
715
769
  }
716
770
 
771
+ // src/cart.ts
772
+ var CART_VISITOR_ATTRIBUTE = "_pb_vid";
773
+ function playbookCartAttribute(visitorId) {
774
+ return { key: CART_VISITOR_ATTRIBUTE, value: visitorId };
775
+ }
776
+ function cartHasPlaybookAttribute(attributes, visitorId) {
777
+ return !!attributes?.some(
778
+ (a) => a.key === CART_VISITOR_ATTRIBUTE && a.value === visitorId
779
+ );
780
+ }
781
+
782
+ // src/env.ts
783
+ function hasPlaybookParams(url) {
784
+ let search;
785
+ try {
786
+ search = (typeof url === "string" ? new URL(url) : url).search;
787
+ } catch {
788
+ return false;
789
+ }
790
+ return search.includes("_pv=") || search.includes("pbk=") || search.includes("pb_mode=brand_preview") || search.includes("_preview=true");
791
+ }
792
+ function isKillSwitchOn(value) {
793
+ const v = (value ?? "").trim().toLowerCase();
794
+ return v === "1" || v === "true" || v === "yes" || v === "on";
795
+ }
796
+ function isPreviewHost(hostname) {
797
+ const h = hostname.toLowerCase();
798
+ return h === "localhost" || h === "127.0.0.1" || /\.myshopify\.(dev|com)$/.test(h) || /\.shopifypreview\.com$/.test(h) || /\.workers\.dev$/.test(h);
799
+ }
800
+
801
+ // src/request-context.ts
802
+ var FINALIZE_WAIT_MS = 2e3;
803
+ var FINALIZE_REDIRECT_WAIT_MS = 0;
804
+ function str(v) {
805
+ return typeof v === "string" && v ? v : void 0;
806
+ }
807
+ function createPlaybookContext({
808
+ request,
809
+ env,
810
+ waitUntil,
811
+ shopId: shopIdOption,
812
+ platformUrl: platformUrlOption,
813
+ disabled: disabledOption,
814
+ consentRequired = false,
815
+ consent,
816
+ overrides,
817
+ fetchImpl
818
+ }) {
819
+ const e = env ?? {};
820
+ const disabled = disabledOption ?? isKillSwitchOn(str(e.PLAYBOOK_TESTS_DISABLED));
821
+ const configuredShop = shopIdOption ?? str(e.PUBLIC_PLAYBOOK_SHOP_ID) ?? null;
822
+ const shopId = disabled ? null : configuredShop;
823
+ const platformUrl = platformUrlOption || str(e.PLAYBOOK_PLATFORM_URL) || DEFAULT_PLATFORM_URL;
824
+ let promise = null;
825
+ let settled = false;
826
+ if (shopId && request.method === "GET") {
827
+ try {
828
+ prefetchRuleset({ platformUrl, shopId, waitUntil, fetchImpl });
829
+ } catch {
830
+ }
831
+ }
832
+ const get = () => {
833
+ if (!promise) {
834
+ promise = createPlaybook({
835
+ // Kill switch → shopId null → createPlaybook's disabled path:
836
+ // everyone control, no cookies, `enabled: false` on the client.
837
+ shopId,
838
+ platformUrl,
839
+ request,
840
+ waitUntil,
841
+ fetchImpl,
842
+ overrides,
843
+ consentRequired,
844
+ consent
845
+ }).catch((error) => {
846
+ console.error("[playbook] createPlaybook failed", String(error));
847
+ return null;
848
+ }).finally(() => {
849
+ settled = true;
850
+ });
851
+ }
852
+ return promise;
853
+ };
854
+ const cookiesFor = async (waitMs) => {
855
+ if (!promise) return [];
856
+ if (!settled) {
857
+ let timer;
858
+ const timeout = new Promise((resolve) => {
859
+ timer = setTimeout(() => resolve("timeout"), waitMs);
860
+ });
861
+ const winner = await Promise.race([promise, timeout]);
862
+ clearTimeout(timer);
863
+ if (winner === "timeout") return [];
864
+ return winner?.setCookieHeaders ?? [];
865
+ }
866
+ return (await promise)?.setCookieHeaders ?? [];
867
+ };
868
+ const append = (headers, cookies) => {
869
+ for (const cookie of cookies) headers.append("Set-Cookie", cookie);
870
+ };
871
+ return {
872
+ shopId,
873
+ platformUrl,
874
+ disabled: disabled || !configuredShop,
875
+ get,
876
+ async loaderData() {
877
+ const result = await get();
878
+ return {
879
+ playbook: result?.state ?? null,
880
+ hasPlaybookParams: hasPlaybookParams(request.url)
881
+ };
882
+ },
883
+ cartAttribute() {
884
+ if (!shopId) return null;
885
+ try {
886
+ const cookies = parseCookies(request.headers.get("cookie"));
887
+ const state = consent ? consent.fromRequest(request) : analyticsConsentFromCookie(cookies[TRACKING_CONSENT_COOKIE]);
888
+ const allowed = state === "granted" || state === "absent" && !consentRequired;
889
+ if (!allowed) return null;
890
+ const id = [cookies[VISITOR_COOKIE], cookies[SESSION_VISITOR_COOKIE]].find((v) => isValidVisitorId(v));
891
+ return id ? { key: CART_VISITOR_ATTRIBUTE, value: id } : null;
892
+ } catch {
893
+ return null;
894
+ }
895
+ },
896
+ async appendCookies(headers) {
897
+ try {
898
+ append(headers, await cookiesFor(FINALIZE_WAIT_MS));
899
+ } catch {
900
+ }
901
+ },
902
+ async finalize(response) {
903
+ try {
904
+ const isRedirect = response.status >= 300 && response.status < 400;
905
+ const cookies = await cookiesFor(
906
+ isRedirect ? FINALIZE_REDIRECT_WAIT_MS : FINALIZE_WAIT_MS
907
+ );
908
+ if (!cookies.length) return response;
909
+ try {
910
+ append(response.headers, cookies);
911
+ return response;
912
+ } catch {
913
+ const headers = new Headers(response.headers);
914
+ append(headers, cookies);
915
+ return new Response(response.body, {
916
+ status: response.status,
917
+ statusText: response.statusText,
918
+ headers
919
+ });
920
+ }
921
+ } catch {
922
+ return response;
923
+ }
924
+ }
925
+ };
926
+ }
927
+ async function withPlaybook(options, handler) {
928
+ const playbook = createPlaybookContext(options);
929
+ return playbook.finalize(await handler(playbook));
930
+ }
931
+
932
+ // src/visitor-sync.ts
933
+ function writeCookie(value, days) {
934
+ try {
935
+ const expires = new Date(Date.now() + days * 864e5).toUTCString();
936
+ const secure = window.location.protocol === "https:" ? ";Secure" : "";
937
+ document.cookie = `${VISITOR_COOKIE}=${value};expires=${expires};path=/;SameSite=Lax${secure}`;
938
+ } catch {
939
+ }
940
+ }
941
+ function readCookie() {
942
+ try {
943
+ const parts = `; ${document.cookie}`.split(`; ${VISITOR_COOKIE}=`);
944
+ return parts.length === 2 ? parts.pop()?.split(";").shift() ?? null : null;
945
+ } catch {
946
+ return null;
947
+ }
948
+ }
949
+ function syncVisitorId(visitorId, consent) {
950
+ try {
951
+ window.sessionStorage.setItem(VISITOR_COOKIE, visitorId);
952
+ } catch {
953
+ }
954
+ if (consent === "granted" || consent === "absent") {
955
+ if (readCookie() !== visitorId) writeCookie(visitorId, 365);
956
+ } else if (consent === "denied" && readCookie() !== null) {
957
+ writeCookie("", -1);
958
+ }
959
+ }
960
+ function visitorSeedScript(visitorId) {
961
+ if (!isValidVisitorId(visitorId ?? void 0)) return "";
962
+ return `try{sessionStorage.setItem(${JSON.stringify(VISITOR_COOKIE)},${JSON.stringify(visitorId)})}catch(e){}`;
963
+ }
964
+ var DEFAULT_SDK_URL = "https://cdn.heyplaybook.com/playbook.js";
965
+ var DEFAULT_PROXY_ENDPOINT = "/apps/playbook";
966
+ var ANTI_FLICKER_CSS = "html:not(.pb-ready){opacity:0!important}html.pb-ready{opacity:1!important;transition:opacity 0.3s ease-in!important}";
967
+ function revealScript(hasPlaybookParams2) {
968
+ return `
969
+ (function(){
970
+ function reveal() {
971
+ document.documentElement.classList.add('pb-ready');
972
+ if (window.__pbFlickerTimeout) {
973
+ clearTimeout(window.__pbFlickerTimeout);
974
+ window.__pbFlickerTimeout = null;
975
+ }
976
+ }
977
+
978
+ ${hasPlaybookParams2 ? "window.__pbFlickerTimeout = setTimeout(reveal, 3000);" : ""}
979
+
980
+ window.Playbook = window.Playbook || {};
981
+ window.Playbook.pageReady = reveal;
982
+ })();
983
+ `;
984
+ }
985
+ function PlaybookHead({
986
+ shopId,
987
+ apiEndpoint = DEFAULT_PROXY_ENDPOINT,
988
+ sdkUrl = DEFAULT_SDK_URL,
989
+ hasPlaybookParams: hasPlaybookParams2 = false,
990
+ state,
991
+ visitorId,
992
+ nonce
993
+ }) {
994
+ if (!shopId) return null;
995
+ const id = visitorId !== void 0 ? visitorId : state?.enabled ? state.visitorId : null;
996
+ const seed = visitorSeedScript(id);
997
+ return /* @__PURE__ */ jsxs(Fragment, { children: [
998
+ hasPlaybookParams2 && /* @__PURE__ */ jsx(
999
+ "style",
1000
+ {
1001
+ id: "pb-anti-flicker",
1002
+ nonce,
1003
+ dangerouslySetInnerHTML: { __html: ANTI_FLICKER_CSS }
1004
+ }
1005
+ ),
1006
+ /* @__PURE__ */ jsx(
1007
+ "script",
1008
+ {
1009
+ nonce,
1010
+ dangerouslySetInnerHTML: { __html: revealScript(hasPlaybookParams2) }
1011
+ }
1012
+ ),
1013
+ seed && /* @__PURE__ */ jsx("script", { nonce, dangerouslySetInnerHTML: { __html: seed } }),
1014
+ /* @__PURE__ */ jsx(
1015
+ "script",
1016
+ {
1017
+ src: sdkUrl,
1018
+ nonce,
1019
+ "data-pb-config": JSON.stringify({ shopId, apiEndpoint }),
1020
+ async: true
1021
+ }
1022
+ )
1023
+ ] });
1024
+ }
1025
+ var PlaybookBoundary = class extends Component {
1026
+ state = { failed: false };
1027
+ static getDerivedStateFromError() {
1028
+ return { failed: true };
1029
+ }
1030
+ componentDidCatch(error) {
1031
+ try {
1032
+ console.warn(`[playbook] ${this.props.name} disabled`, String(error));
1033
+ } catch {
1034
+ }
1035
+ }
1036
+ render() {
1037
+ return this.state.failed ? null : this.props.children ?? null;
1038
+ }
1039
+ };
1040
+
1041
+ // src/cart-sync.ts
1042
+ function mergeAttributes(current, add) {
1043
+ const map = /* @__PURE__ */ new Map();
1044
+ for (const a of current ?? []) {
1045
+ if (a?.key) map.set(a.key, a.value ?? "");
1046
+ }
1047
+ for (const a of add) {
1048
+ if (!a.value) map.delete(a.key);
1049
+ else map.set(a.key, a.value);
1050
+ }
1051
+ return [...map].map(([key, value]) => ({ key, value }));
1052
+ }
1053
+ var WRITE_TIMEOUT_MS = 8e3;
1054
+ async function withTimeout(fetchImpl, url, init) {
1055
+ const controller = new AbortController();
1056
+ const timer = setTimeout(() => controller.abort(), WRITE_TIMEOUT_MS);
1057
+ try {
1058
+ return await fetchImpl(url, { ...init, signal: controller.signal });
1059
+ } finally {
1060
+ clearTimeout(timer);
1061
+ }
1062
+ }
1063
+ function attributesFrom(data) {
1064
+ const attrs = data?.cart?.attributes;
1065
+ return Array.isArray(attrs) ? attrs : null;
1066
+ }
1067
+ function createCartAttributeWriter({
1068
+ endpoint = "/api/cart",
1069
+ serverMerges = false,
1070
+ fetchImpl
1071
+ } = {}) {
1072
+ return async (add, current) => {
1073
+ try {
1074
+ const list = serverMerges ? add.map((a) => ({ key: a.key, value: a.value ?? "" })) : mergeAttributes(current, add);
1075
+ const form = new FormData();
1076
+ form.append("action", "AttributesUpdateInput");
1077
+ form.append("attributes", JSON.stringify(list));
1078
+ form.append(
1079
+ "cartFormInput",
1080
+ JSON.stringify({
1081
+ action: "AttributesUpdateInput",
1082
+ inputs: { attributes: list }
1083
+ })
1084
+ );
1085
+ const res = await withTimeout(fetchImpl ?? fetch, endpoint, {
1086
+ method: "POST",
1087
+ body: form,
1088
+ headers: { accept: "application/json" }
1089
+ });
1090
+ if (!res.ok) return { ok: false };
1091
+ let data = null;
1092
+ try {
1093
+ data = await res.json();
1094
+ } catch {
1095
+ return { ok: true, attributes: null };
1096
+ }
1097
+ const d = data;
1098
+ const failed = !!(d?.userErrors?.length || d?.errors?.length);
1099
+ return { ok: !failed, attributes: attributesFrom(data) };
1100
+ } catch {
1101
+ return { ok: false };
1102
+ }
1103
+ };
1104
+ }
1105
+ function createCartAttributeReader({
1106
+ endpoint = "/api/cart",
1107
+ fetchImpl
1108
+ } = {}) {
1109
+ return async () => {
1110
+ try {
1111
+ const res = await withTimeout(fetchImpl ?? fetch, endpoint, {
1112
+ headers: { accept: "application/json" }
1113
+ });
1114
+ if (!res.ok) return null;
1115
+ return attributesFrom(await res.json());
1116
+ } catch {
1117
+ return null;
1118
+ }
1119
+ };
1120
+ }
1121
+ var CART_SYNC_IDLE_MS = 3e3;
1122
+ var MAX_WRITES_PER_CART = 3;
1123
+ function createCartAttributeSync({
1124
+ write,
1125
+ read,
1126
+ maxWritesPerCart = MAX_WRITES_PER_CART,
1127
+ idleMs = CART_SYNC_IDLE_MS,
1128
+ protectedKeyPrefixes = ["_ig"],
1129
+ onEvent
1130
+ }) {
1131
+ let counted = {
1132
+ cartId: null,
1133
+ count: 0
1134
+ };
1135
+ let inFlight = false;
1136
+ let timer = null;
1137
+ let disposed = false;
1138
+ const emit = (e) => {
1139
+ try {
1140
+ onEvent?.(e);
1141
+ } catch {
1142
+ }
1143
+ };
1144
+ const isProtected = (key) => protectedKeyPrefixes.some((p) => key.startsWith(p));
1145
+ const cancel = () => {
1146
+ if (timer) clearTimeout(timer);
1147
+ timer = null;
1148
+ };
1149
+ async function run(s2) {
1150
+ if (disposed || inFlight) return;
1151
+ if (counted.cartId !== s2.cartId) counted = { cartId: s2.cartId, count: 0 };
1152
+ if (counted.count >= maxWritesPerCart) {
1153
+ emit({ type: "capped", cartId: s2.cartId });
1154
+ return;
1155
+ }
1156
+ counted.count += 1;
1157
+ inFlight = true;
1158
+ try {
1159
+ const before = (s2.attributes ?? []).filter(
1160
+ (a) => a?.key && isProtected(a.key) && a.value
1161
+ );
1162
+ const attribute = { key: CART_VISITOR_ATTRIBUTE, value: s2.visitorId };
1163
+ const result = await write([attribute], s2.attributes);
1164
+ emit({ type: "written", cartId: s2.cartId, ok: result.ok });
1165
+ if (!before.length) return;
1166
+ const after = result.attributes ?? (read ? await read() : null) ?? null;
1167
+ if (!after) return;
1168
+ const present = new Set(after.map((a) => a.key));
1169
+ const lost = before.filter((a) => !present.has(a.key));
1170
+ if (!lost.length) return;
1171
+ const restored = await write(lost, after);
1172
+ emit({
1173
+ type: "restored",
1174
+ cartId: s2.cartId,
1175
+ keys: lost.map((a) => a.key),
1176
+ ok: restored.ok
1177
+ });
1178
+ } catch {
1179
+ } finally {
1180
+ inFlight = false;
1181
+ }
1182
+ }
1183
+ return {
1184
+ update(s2) {
1185
+ cancel();
1186
+ if (disposed || !s2.eligible || !s2.cartId || !s2.visitorId) return;
1187
+ if (s2.status && s2.status !== "idle") return;
1188
+ if (cartHasPlaybookAttribute(s2.attributes, s2.visitorId)) return;
1189
+ if (inFlight) return;
1190
+ if (counted.cartId === s2.cartId && counted.count >= maxWritesPerCart) {
1191
+ return;
1192
+ }
1193
+ const ready = { ...s2, cartId: s2.cartId, visitorId: s2.visitorId };
1194
+ emit({ type: "scheduled", cartId: s2.cartId });
1195
+ timer = setTimeout(() => {
1196
+ timer = null;
1197
+ void run(ready);
1198
+ }, idleMs);
1199
+ },
1200
+ dispose() {
1201
+ disposed = true;
1202
+ cancel();
1203
+ },
1204
+ /** Test/debug: writes made for the current cart. */
1205
+ writesForCart(cartId) {
1206
+ return counted.cartId === cartId ? counted.count : 0;
1207
+ }
1208
+ };
1209
+ }
1210
+ function withPlaybookCartAttribute(input, attribute) {
1211
+ const base = input ?? {};
1212
+ if (!attribute?.value) return base;
1213
+ return {
1214
+ ...base,
1215
+ attributes: mergeAttributes(base.attributes, [attribute])
1216
+ };
1217
+ }
1218
+
717
1219
  // src/tracker.ts
718
1220
  var ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
719
1221
  var KEY_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
@@ -747,6 +1249,7 @@ function cleanProps(props) {
747
1249
  }
748
1250
  return out;
749
1251
  }
1252
+ var DEFAULT_DATALAYER_EVENT = "view_experiment";
750
1253
  var config = {
751
1254
  state: null,
752
1255
  consent: "pending",
@@ -754,7 +1257,8 @@ var config = {
754
1257
  exposureUrl: "/apps/playbook/api/storefront/tests/exposure",
755
1258
  eventUrl: "/apps/playbook/api/storefront/tests/event",
756
1259
  supportedEvents: new Set(DEFAULT_SUPPORTED_EVENTS),
757
- store: {}
1260
+ store: {},
1261
+ dataLayer: {}
758
1262
  };
759
1263
  var seenOnPage = /* @__PURE__ */ new Set();
760
1264
  function configureTracker(next) {
@@ -862,12 +1366,12 @@ function viewportBucket(width) {
862
1366
  return "xl";
863
1367
  }
864
1368
  function exposureContext() {
865
- const s = config.state;
1369
+ const s2 = config.state;
866
1370
  const session = getSessionContext();
867
1371
  const ua = typeof navigator !== "undefined" ? navigator.userAgent : "";
868
1372
  return {
869
- country: s?.geo?.country ?? null,
870
- region: s?.geo?.region ?? null,
1373
+ country: s2?.geo?.country ?? null,
1374
+ region: s2?.geo?.region ?? null,
871
1375
  market: config.store.market ?? null,
872
1376
  locale: config.store.locale ?? null,
873
1377
  utm: session?.utm ?? {},
@@ -923,16 +1427,16 @@ function post(url, body2, { beacon = false } = {}) {
923
1427
  });
924
1428
  }
925
1429
  function baseValid(testKey, arm) {
926
- const s = config.state;
927
- if (!s?.enabled || !s.visitorId || !s.shopId) return null;
928
- if (!ID_RE.test(s.shopId) || !ID_RE.test(s.visitorId)) return null;
1430
+ const s2 = config.state;
1431
+ if (!s2?.enabled || !s2.visitorId || !s2.shopId) return null;
1432
+ if (!ID_RE.test(s2.shopId) || !ID_RE.test(s2.visitorId)) return null;
929
1433
  if (!KEY_RE.test(testKey) || !KEY_RE.test(arm)) return null;
930
- return s;
1434
+ return s2;
931
1435
  }
932
- function body(s, testKey, arm, extra) {
1436
+ function body(s2, testKey, arm, extra) {
933
1437
  const json = JSON.stringify({
934
- shopId: s.shopId,
935
- visitorId: s.visitorId,
1438
+ shopId: s2.shopId,
1439
+ visitorId: s2.visitorId,
936
1440
  testKey,
937
1441
  arm,
938
1442
  ...extra,
@@ -942,13 +1446,40 @@ function body(s, testKey, arm, extra) {
942
1446
  });
943
1447
  return json.length <= MAX_BODY_BYTES ? json : null;
944
1448
  }
1449
+ function pushExposureToDataLayer(s2, testKey, arm) {
1450
+ const option = config.dataLayer;
1451
+ if (option === false) return;
1452
+ try {
1453
+ const dl = window.dataLayer;
1454
+ if (!Array.isArray(dl) && typeof dl?.push !== "function") {
1455
+ return;
1456
+ }
1457
+ const assignment = s2.tests[testKey];
1458
+ if (!assignment?.inTest || assignment.forced) return;
1459
+ const cfg = assignment?.config ?? {};
1460
+ const str2 = (v) => typeof v === "string" && v ? v.slice(0, 100) : null;
1461
+ dl.push({
1462
+ event: option.eventName || DEFAULT_DATALAYER_EVENT,
1463
+ experiment_id: testKey,
1464
+ // The ruleset carries no display names yet; an explicit
1465
+ // `config.experimentName` wins, else the key (never a variant's copy).
1466
+ experiment_name: str2(cfg.experimentName) ?? testKey,
1467
+ variant_id: arm,
1468
+ variant_name: arm,
1469
+ experiment_variant: arm,
1470
+ pb_vid: s2.visitorId
1471
+ });
1472
+ } catch {
1473
+ }
1474
+ }
945
1475
  function sendExposure(testKey, arm) {
946
- const s = baseValid(testKey, arm);
947
- if (!s || !analyticsAllowed()) return;
948
- if (!claimOnce(exposureKey(s.visitorId, testKey), arm)) return;
949
- const json = body(s, testKey, arm, {
950
- device: s.device,
951
- visitorType: s.visitorType,
1476
+ const s2 = baseValid(testKey, arm);
1477
+ if (!s2 || !analyticsAllowed()) return;
1478
+ if (!claimOnce(exposureKey(s2.visitorId, testKey), arm)) return;
1479
+ pushExposureToDataLayer(s2, testKey, arm);
1480
+ const json = body(s2, testKey, arm, {
1481
+ device: s2.device,
1482
+ visitorType: s2.visitorType,
952
1483
  context: exposureContext()
953
1484
  });
954
1485
  if (json) post(config.exposureUrl, json);
@@ -962,15 +1493,15 @@ function sendExposure(testKey, arm) {
962
1493
  });
963
1494
  }
964
1495
  function testsFor(scope) {
965
- const s = config.state;
966
- if (!s?.enabled || !s.visitorId) return [];
1496
+ const s2 = config.state;
1497
+ if (!s2?.enabled || !s2.visitorId) return [];
967
1498
  const out = [];
968
- for (const [key, a] of Object.entries(s.tests)) {
1499
+ for (const [key, a] of Object.entries(s2.tests)) {
969
1500
  if (!a.inTest || a.forced) continue;
970
1501
  if (typeof scope === "object") {
971
1502
  if (scope.testKeys.includes(key)) out.push([key, a.arm]);
972
1503
  } else if (scope === "visitor") {
973
- if (hasSentExposure(s.visitorId, key)) out.push([key, a.arm]);
1504
+ if (hasSentExposure(s2.visitorId, key)) out.push([key, a.arm]);
974
1505
  } else if (
975
1506
  // Tested page type only: the test targets a pathPrefix that matches
976
1507
  // this page, and its slot was on screen during this page view.
@@ -991,8 +1522,8 @@ function playbookTrack(event, rawProps = {}, scope = "visitor", { oncePerSession
991
1522
  if (!targets.length) return 0;
992
1523
  const allowed = analyticsAllowed();
993
1524
  for (const [testKey, arm] of targets) {
994
- const s = baseValid(testKey, arm);
995
- if (!s) continue;
1525
+ const s2 = baseValid(testKey, arm);
1526
+ if (!s2) continue;
996
1527
  const entry = {
997
1528
  at: (/* @__PURE__ */ new Date()).toISOString(),
998
1529
  kind: "event",
@@ -1006,7 +1537,7 @@ function playbookTrack(event, rawProps = {}, scope = "visitor", { oncePerSession
1006
1537
  record(entry);
1007
1538
  continue;
1008
1539
  }
1009
- if (oncePerSession && !claimOnce(`pb_evt:${s.visitorId}:${testKey}:${oncePerSession}`, arm)) {
1540
+ if (oncePerSession && !claimOnce(`pb_evt:${s2.visitorId}:${testKey}:${oncePerSession}`, arm)) {
1010
1541
  continue;
1011
1542
  }
1012
1543
  let wire = {
@@ -1022,7 +1553,7 @@ function playbookTrack(event, rawProps = {}, scope = "visitor", { oncePerSession
1022
1553
  continue;
1023
1554
  }
1024
1555
  const json = body(
1025
- s,
1556
+ s2,
1026
1557
  testKey,
1027
1558
  arm,
1028
1559
  Object.keys(wire.props).length ? wire : { event: wire.event }
@@ -1127,89 +1658,200 @@ function usePreviewParamRedirect(location) {
1127
1658
  params.set("pb_preview", token);
1128
1659
  return `${location.pathname}?${params.toString()}${location.hash}`;
1129
1660
  }
1130
-
1131
- // src/visitor-sync.ts
1132
- function writeCookie(value, days) {
1661
+ var FLAG = "pb_debug";
1662
+ function readFlag() {
1133
1663
  try {
1134
- const expires = new Date(Date.now() + days * 864e5).toUTCString();
1135
- const secure = window.location.protocol === "https:" ? ";Secure" : "";
1136
- document.cookie = `${VISITOR_COOKIE}=${value};expires=${expires};path=/;SameSite=Lax${secure}`;
1664
+ return window.sessionStorage.getItem(FLAG) === "1";
1137
1665
  } catch {
1666
+ return false;
1138
1667
  }
1139
1668
  }
1140
- function readCookie() {
1669
+ function writeFlag(on) {
1141
1670
  try {
1142
- const parts = `; ${document.cookie}`.split(`; ${VISITOR_COOKIE}=`);
1143
- return parts.length === 2 ? parts.pop()?.split(";").shift() ?? null : null;
1671
+ window.sessionStorage.setItem(FLAG, on ? "1" : "0");
1144
1672
  } catch {
1145
- return null;
1146
1673
  }
1147
1674
  }
1148
- function syncVisitorId(visitorId, consent) {
1149
- try {
1150
- window.sessionStorage.setItem(VISITOR_COOKIE, visitorId);
1151
- } catch {
1675
+ var SERVER_REASONS = {
1676
+ "not-running": "not running",
1677
+ "no-visitor": "no visitor id",
1678
+ "targeting-device": "targeting: device",
1679
+ "targeting-visitor-type": "targeting: new vs returning",
1680
+ namespace: "out of namespace",
1681
+ "hash-error": "hash error",
1682
+ coverage: "out of coverage",
1683
+ winner: "completed: winner served",
1684
+ preview: "forced: preview link",
1685
+ "preview-isolated": "another test is being previewed",
1686
+ override: "forced: override"
1687
+ };
1688
+ function whyNotInTest(key, a, pathname, implementedTests) {
1689
+ if (implementedTests && !implementedTests.has(key)) {
1690
+ return "no code on this storefront";
1152
1691
  }
1153
- if (consent === "granted" || consent === "absent") {
1154
- if (readCookie() !== visitorId) writeCookie(visitorId, 365);
1155
- } else if (readCookie() !== null) {
1156
- writeCookie("", -1);
1692
+ if (a.forced) return SERVER_REASONS[a.reason] ?? "forced";
1693
+ if (!a.inTest) {
1694
+ if (a.reason === "not-running") return a.status;
1695
+ return SERVER_REASONS[a.reason] ?? a.reason;
1157
1696
  }
1697
+ if (!matchesPathPrefix(pathname, a.pathPrefix)) return "targeting: path";
1698
+ return null;
1158
1699
  }
1159
- function visitorSeedScript(visitorId) {
1160
- return `try{sessionStorage.setItem(${JSON.stringify(VISITOR_COOKIE)},${JSON.stringify(visitorId)})}catch(e){}`;
1700
+ function debugPanelAllowed(state, hostname, allowed) {
1701
+ if (allowed !== void 0) return allowed;
1702
+ return isPreviewHost(hostname) || !!state?.previewToken;
1703
+ }
1704
+ var s = {
1705
+ panel: {
1706
+ position: "fixed",
1707
+ bottom: 16,
1708
+ left: 16,
1709
+ zIndex: 2147483e3,
1710
+ maxHeight: "70vh",
1711
+ width: "min(380px, calc(100vw - 2rem))",
1712
+ overflowY: "auto",
1713
+ borderRadius: 12,
1714
+ background: "#fff",
1715
+ color: "#111",
1716
+ padding: 12,
1717
+ font: "12px/1.45 ui-sans-serif, system-ui, -apple-system, sans-serif",
1718
+ boxShadow: "0 8px 30px rgba(0,0,0,0.18)"
1719
+ },
1720
+ row: { display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8, marginBottom: 8 },
1721
+ title: { fontWeight: 600, margin: 0 },
1722
+ close: { width: 24, height: 24, border: 0, borderRadius: 999, background: "#f2f2f2", cursor: "pointer", fontSize: 14, lineHeight: 1 },
1723
+ card: { background: "#f6f6f6", borderRadius: 8, padding: 8, marginBottom: 8 },
1724
+ muted: { color: "#666", margin: 0 },
1725
+ p: { margin: 0 },
1726
+ grid: { display: "grid", gridTemplateColumns: "auto 1fr", columnGap: 12, rowGap: 4, margin: 0 },
1727
+ dd: { margin: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
1728
+ btn: { border: 0, borderRadius: 4, background: "#fff", padding: "2px 6px", cursor: "pointer", fontWeight: 500 },
1729
+ list: { listStyle: "none", margin: 0, padding: 0 }
1730
+ };
1731
+ function copyText(text) {
1732
+ if (navigator.clipboard?.writeText) {
1733
+ navigator.clipboard.writeText(text).catch(() => window.prompt("", text));
1734
+ } else {
1735
+ window.prompt("", text);
1736
+ }
1161
1737
  }
1162
- function PlaybookProvider({
1738
+ function PlaybookDebugPanel({
1163
1739
  state,
1164
- pathname,
1165
- exposureUrl = DEFAULT_EXPOSURE_URL,
1166
- eventUrl = DEFAULT_EVENT_URL,
1167
- supportedEvents = DEFAULT_SUPPORTED_EVENTS,
1168
- storeContext,
1169
- children
1740
+ location,
1741
+ allowed,
1742
+ implementedTests
1170
1743
  }) {
1171
- const [consent, setConsent] = useState("pending");
1172
- const consentRequired = !!state?.consentRequired;
1173
- useEffect(() => {
1174
- if (consentRequired) declareConsentRequired();
1175
- let live = true;
1176
- const update = () => live && setConsent(getConsentState());
1177
- waitForConsentAPI().then(update);
1178
- const unsubscribe = onConsentChange(update);
1179
- return () => {
1180
- live = false;
1181
- unsubscribe();
1182
- };
1183
- }, [consentRequired]);
1184
- const visitorId = state?.enabled ? state.visitorId : null;
1185
- useEffect(() => {
1186
- if (visitorId) syncVisitorId(visitorId, consent);
1187
- }, [visitorId, consent]);
1188
- if (typeof window !== "undefined") {
1189
- configureTracker({
1190
- state: state ?? null,
1191
- consent,
1192
- pathname,
1193
- exposureUrl,
1194
- eventUrl,
1195
- supportedEvents: new Set(supportedEvents),
1196
- store: storeContext ?? {}
1197
- });
1198
- }
1199
- const value = useMemo(
1200
- () => ({ state: state ?? null, pathname, exposureUrl, eventUrl, consent }),
1201
- [state, pathname, exposureUrl, eventUrl, consent]
1744
+ const { pathname, search = "" } = location;
1745
+ const param = new URLSearchParams(search).get(FLAG);
1746
+ const [stored, setStored] = useState(readFlag);
1747
+ const [copied, setCopied] = useState(false);
1748
+ const consent = usePlaybookConsent();
1749
+ const tracked = useSyncExternalStore(
1750
+ subscribeTrackedLog,
1751
+ getTrackedLog,
1752
+ getServerTrackedLog
1202
1753
  );
1203
- return /* @__PURE__ */ jsx(PlaybookContext.Provider, { value, children });
1204
- }
1205
- function PlaybookExposure({
1206
- testKey,
1207
- variant,
1208
- enabled,
1209
- children
1210
- }) {
1211
- const ref = usePlaybookExposure(testKey, variant, { enabled });
1212
- return /* @__PURE__ */ jsx(Fragment, { children: children(ref) });
1754
+ const permitted = debugPanelAllowed(state, window.location.hostname, allowed);
1755
+ const open = permitted && (param === "1" ? true : param === "0" ? false : stored);
1756
+ useEffect(() => {
1757
+ if (permitted && (param === "1" || param === "0")) writeFlag(param === "1");
1758
+ }, [param, permitted]);
1759
+ if (!open) return null;
1760
+ const close = () => {
1761
+ writeFlag(false);
1762
+ setStored(false);
1763
+ if (param === "1") {
1764
+ try {
1765
+ const url = new URL(window.location.href);
1766
+ url.searchParams.set(FLAG, "0");
1767
+ window.history.replaceState(window.history.state, "", url);
1768
+ } catch {
1769
+ }
1770
+ }
1771
+ };
1772
+ const implemented = implementedTests ? new Set(implementedTests) : void 0;
1773
+ const tests = Object.entries(state?.tests ?? {});
1774
+ const vid = state?.visitorId;
1775
+ return /* @__PURE__ */ jsxs("aside", { "aria-label": "Playbook tests debug", style: s.panel, children: [
1776
+ /* @__PURE__ */ jsxs("div", { style: s.row, children: [
1777
+ /* @__PURE__ */ jsx("p", { style: s.title, children: "Playbook tests" }),
1778
+ /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Close debug panel", style: s.close, onClick: close, children: "\xD7" })
1779
+ ] }),
1780
+ !state?.enabled ? /* @__PURE__ */ jsx("p", { style: s.p, children: "Disabled: no shop id, or PLAYBOOK_TESTS_DISABLED is on." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
1781
+ /* @__PURE__ */ jsxs("dl", { style: { ...s.grid, ...s.card }, children: [
1782
+ /* @__PURE__ */ jsx("dt", { style: s.muted, children: "Visitor" }),
1783
+ /* @__PURE__ */ jsxs("dd", { style: { ...s.dd, display: "flex", gap: 8, alignItems: "center" }, children: [
1784
+ /* @__PURE__ */ jsx("code", { style: { overflow: "hidden", textOverflow: "ellipsis" }, children: vid ?? "none (preview)" }),
1785
+ vid && /* @__PURE__ */ jsx(
1786
+ "button",
1787
+ {
1788
+ type: "button",
1789
+ style: s.btn,
1790
+ onClick: () => {
1791
+ copyText(vid);
1792
+ setCopied(true);
1793
+ setTimeout(() => setCopied(false), 1500);
1794
+ },
1795
+ children: copied ? "Copied" : "Copy"
1796
+ }
1797
+ )
1798
+ ] }),
1799
+ /* @__PURE__ */ jsx("dt", { style: s.muted, children: "Type" }),
1800
+ /* @__PURE__ */ jsxs("dd", { style: s.dd, children: [
1801
+ state.visitorType,
1802
+ " \xB7 ",
1803
+ state.device
1804
+ ] }),
1805
+ /* @__PURE__ */ jsx("dt", { style: s.muted, children: "Analytics" }),
1806
+ /* @__PURE__ */ jsxs("dd", { style: s.dd, children: [
1807
+ consent === "absent" ? "API absent" : consent,
1808
+ " (server: ",
1809
+ state.serverConsent,
1810
+ ")",
1811
+ consent === "denied" || consent === "pending" ? " \xB7 no beacons" : ""
1812
+ ] }),
1813
+ /* @__PURE__ */ jsx("dt", { style: s.muted, children: "Ruleset" }),
1814
+ /* @__PURE__ */ jsx("dd", { style: s.dd, children: state.rulesetSource === "cold-fallback" ? "cold fallback (everyone gets control)" : `${state.rulesetVersion ?? "none"} \xB7 ${state.rulesetSource}` })
1815
+ ] }),
1816
+ !tests.length && /* @__PURE__ */ jsx("p", { style: s.p, children: "No tests in the ruleset." }),
1817
+ /* @__PURE__ */ jsx("ul", { style: s.list, children: tests.map(([key, a]) => {
1818
+ const why = whyNotInTest(key, a, pathname, implemented);
1819
+ const exposed = !!vid && hasSentExposure(vid, key);
1820
+ return /* @__PURE__ */ jsxs("li", { style: s.card, children: [
1821
+ /* @__PURE__ */ jsx("p", { style: { ...s.p, fontWeight: 600 }, children: key }),
1822
+ /* @__PURE__ */ jsxs("p", { style: s.p, children: [
1823
+ a.status,
1824
+ " \xB7 arm ",
1825
+ /* @__PURE__ */ jsx("strong", { children: a.arm }),
1826
+ " \xB7 inTest ",
1827
+ String(a.inTest && !why),
1828
+ " \xB7 forced",
1829
+ " ",
1830
+ String(a.forced)
1831
+ ] }),
1832
+ why && /* @__PURE__ */ jsxs("p", { style: s.muted, children: [
1833
+ "Why: ",
1834
+ why
1835
+ ] }),
1836
+ /* @__PURE__ */ jsxs("p", { style: s.muted, children: [
1837
+ "Exposure this session: ",
1838
+ exposed ? "sent" : "not sent"
1839
+ ] })
1840
+ ] }, key);
1841
+ }) }),
1842
+ /* @__PURE__ */ jsx("p", { style: { ...s.p, fontWeight: 600, marginTop: 4 }, children: "Last beacons" }),
1843
+ tracked.length ? /* @__PURE__ */ jsx("ol", { style: s.list, children: tracked.slice(0, 8).map((t) => /* @__PURE__ */ jsxs("li", { style: { ...s.dd, display: "flex", gap: 8 }, children: [
1844
+ /* @__PURE__ */ jsx("span", { style: t.status === "sent" ? void 0 : s.muted, children: t.status }),
1845
+ /* @__PURE__ */ jsx("span", { style: { fontWeight: 500 }, children: t.name }),
1846
+ /* @__PURE__ */ jsxs("span", { style: { ...s.muted, overflow: "hidden", textOverflow: "ellipsis" }, children: [
1847
+ t.testKey,
1848
+ ":",
1849
+ t.arm,
1850
+ t.props && Object.keys(t.props).length ? ` ${JSON.stringify(t.props)}` : ""
1851
+ ] })
1852
+ ] }, `${t.at}-${t.name}-${t.testKey}`)) }) : /* @__PURE__ */ jsx("p", { style: s.muted, children: "None yet this page." })
1853
+ ] })
1854
+ ] });
1213
1855
  }
1214
1856
  var MILESTONES = [25, 50, 75, 100];
1215
1857
  var IDLE_MS = 5e3;
@@ -1280,6 +1922,450 @@ function usePageEngagement(pathname, enabled) {
1280
1922
  };
1281
1923
  }, [pathname, enabled]);
1282
1924
  }
1925
+ function PlaybookProvider({
1926
+ state,
1927
+ pathname,
1928
+ exposureUrl = DEFAULT_EXPOSURE_URL,
1929
+ eventUrl = DEFAULT_EVENT_URL,
1930
+ supportedEvents = DEFAULT_SUPPORTED_EVENTS,
1931
+ storeContext,
1932
+ consent: consentAdapter,
1933
+ dataLayer = {},
1934
+ children
1935
+ }) {
1936
+ const [consent, setConsent] = useState("pending");
1937
+ const consentRequired = !!state?.consentRequired;
1938
+ useEffect(() => {
1939
+ let live = true;
1940
+ if (consentAdapter) {
1941
+ const update2 = () => {
1942
+ if (!live) return;
1943
+ try {
1944
+ setConsent(consentAdapter.read());
1945
+ } catch {
1946
+ setConsent("pending");
1947
+ }
1948
+ };
1949
+ update2();
1950
+ const unsubscribe2 = consentAdapter.subscribe(update2);
1951
+ return () => {
1952
+ live = false;
1953
+ unsubscribe2();
1954
+ };
1955
+ }
1956
+ if (consentRequired) declareConsentRequired();
1957
+ const update = () => live && setConsent(getConsentState());
1958
+ waitForConsentAPI().then(update);
1959
+ const unsubscribe = onConsentChange(update);
1960
+ return () => {
1961
+ live = false;
1962
+ unsubscribe();
1963
+ };
1964
+ }, [consentRequired, consentAdapter]);
1965
+ const visitorId = state?.enabled ? state.visitorId : null;
1966
+ useEffect(() => {
1967
+ if (visitorId) syncVisitorId(visitorId, consent);
1968
+ }, [visitorId, consent]);
1969
+ if (typeof window !== "undefined") {
1970
+ try {
1971
+ configureTracker({
1972
+ state: state ?? null,
1973
+ consent,
1974
+ pathname,
1975
+ exposureUrl,
1976
+ eventUrl,
1977
+ supportedEvents: new Set(supportedEvents),
1978
+ store: storeContext ?? {},
1979
+ dataLayer
1980
+ });
1981
+ } catch {
1982
+ }
1983
+ }
1984
+ const value = useMemo(
1985
+ () => ({ state: state ?? null, pathname, exposureUrl, eventUrl, consent }),
1986
+ [state, pathname, exposureUrl, eventUrl, consent]
1987
+ );
1988
+ return /* @__PURE__ */ jsx(PlaybookContext.Provider, { value, children });
1989
+ }
1990
+ function PlaybookExposure({
1991
+ testKey,
1992
+ variant,
1993
+ enabled,
1994
+ children
1995
+ }) {
1996
+ const ref = usePlaybookExposure(testKey, variant, { enabled });
1997
+ return /* @__PURE__ */ jsx(Fragment, { children: children(ref) });
1998
+ }
1999
+ var AA_SITEWIDE_TEST = "aa-sitewide";
2000
+ var noopSubscribe = () => () => {
2001
+ };
2002
+ function useHydrated() {
2003
+ return useSyncExternalStore(
2004
+ noopSubscribe,
2005
+ () => true,
2006
+ () => false
2007
+ );
2008
+ }
2009
+ function visitorInRunningTest(state) {
2010
+ if (!state?.enabled || !state.visitorId) return false;
2011
+ return Object.values(state.tests).some(
2012
+ (a) => a.inTest && !a.forced && a.status === "running"
2013
+ );
2014
+ }
2015
+ function CartAttributeSync({
2016
+ state,
2017
+ cart,
2018
+ onEvent
2019
+ }) {
2020
+ const allowed = useAnalyticsAllowed();
2021
+ const cartRef = useRef(cart);
2022
+ cartRef.current = cart;
2023
+ const onEventRef = useRef(onEvent);
2024
+ onEventRef.current = onEvent;
2025
+ const sync = useMemo(
2026
+ () => createCartAttributeSync({
2027
+ write: (add, current) => {
2028
+ const c = cartRef.current;
2029
+ const writer = c.write ?? createCartAttributeWriter({
2030
+ endpoint: c.endpoint,
2031
+ serverMerges: c.serverMerges
2032
+ });
2033
+ return writer(add, current);
2034
+ },
2035
+ read: () => {
2036
+ const c = cartRef.current;
2037
+ return (c.read ?? createCartAttributeReader({ endpoint: c.endpoint }))();
2038
+ },
2039
+ onEvent: (e) => onEventRef.current?.(e)
2040
+ }),
2041
+ []
2042
+ );
2043
+ useEffect(() => () => sync.dispose(), [sync]);
2044
+ const eligible = allowed && visitorInRunningTest(state);
2045
+ let attrSignature = "";
2046
+ try {
2047
+ attrSignature = JSON.stringify(cart.attributes ?? []);
2048
+ } catch {
2049
+ attrSignature = String(cart.attributes?.length ?? 0);
2050
+ }
2051
+ useEffect(() => {
2052
+ sync.update({
2053
+ cartId: cartRef.current.cartId,
2054
+ attributes: cartRef.current.attributes,
2055
+ status: cartRef.current.status,
2056
+ visitorId: state.visitorId,
2057
+ eligible
2058
+ });
2059
+ }, [sync, cart.cartId, attrSignature, cart.status, state.visitorId, eligible]);
2060
+ return null;
2061
+ }
2062
+ function PreviewParam({
2063
+ location,
2064
+ navigate
2065
+ }) {
2066
+ const target = usePreviewParamRedirect({
2067
+ pathname: location.pathname,
2068
+ search: location.search ?? "",
2069
+ hash: location.hash ?? ""
2070
+ });
2071
+ useEffect(() => {
2072
+ if (!target) return;
2073
+ if (navigate) navigate(target, { replace: true, preventScrollReset: true });
2074
+ else window.location.replace(target);
2075
+ }, [target]);
2076
+ return null;
2077
+ }
2078
+ var SENTINEL_STYLE = {
2079
+ position: "fixed",
2080
+ top: 0,
2081
+ left: 0,
2082
+ width: 1,
2083
+ height: 1,
2084
+ opacity: 0,
2085
+ pointerEvents: "none"
2086
+ };
2087
+ function PlaybookAAExposure({ testKey = AA_SITEWIDE_TEST }) {
2088
+ const variant = usePlaybookVariant(testKey);
2089
+ const ref = usePlaybookExposure(testKey, variant);
2090
+ return /* @__PURE__ */ jsx("span", { ref, "aria-hidden": "true", style: SENTINEL_STYLE });
2091
+ }
2092
+ function Engagement({ pathname, enabled }) {
2093
+ usePageEngagement(pathname, enabled);
2094
+ return null;
2095
+ }
2096
+ function PlaybookRoot({
2097
+ state,
2098
+ location,
2099
+ navigate,
2100
+ cart,
2101
+ consent,
2102
+ storeContext,
2103
+ editorPreview = false,
2104
+ aaSentinel = true,
2105
+ debug,
2106
+ dataLayer,
2107
+ onCartSyncEvent,
2108
+ exposureUrl,
2109
+ eventUrl,
2110
+ supportedEvents,
2111
+ children
2112
+ }) {
2113
+ const hydrated = useHydrated();
2114
+ const enabled = !!state?.enabled;
2115
+ return /* @__PURE__ */ jsxs(
2116
+ PlaybookProvider,
2117
+ {
2118
+ state,
2119
+ pathname: location.pathname,
2120
+ storeContext,
2121
+ consent,
2122
+ dataLayer,
2123
+ exposureUrl,
2124
+ eventUrl,
2125
+ supportedEvents,
2126
+ children: [
2127
+ children,
2128
+ hydrated && /* @__PURE__ */ jsxs(Fragment, { children: [
2129
+ /* @__PURE__ */ jsx(PlaybookBoundary, { name: "engagement", children: /* @__PURE__ */ jsx(Engagement, { pathname: location.pathname, enabled }) }),
2130
+ enabled && state?.visitorId && cart && !editorPreview && /* @__PURE__ */ jsx(PlaybookBoundary, { name: "cart attribute", children: /* @__PURE__ */ jsx(
2131
+ CartAttributeSync,
2132
+ {
2133
+ state,
2134
+ cart,
2135
+ onEvent: onCartSyncEvent
2136
+ }
2137
+ ) }),
2138
+ state?.previewToken && /* @__PURE__ */ jsx(PlaybookBoundary, { name: "preview param", children: /* @__PURE__ */ jsx(PreviewParam, { location, navigate }) }),
2139
+ enabled && aaSentinel && !editorPreview && /* @__PURE__ */ jsx(PlaybookBoundary, { name: "aa sentinel", children: /* @__PURE__ */ jsx(PlaybookAAExposure, {}) }),
2140
+ /* @__PURE__ */ jsx(PlaybookBoundary, { name: "debug panel", children: /* @__PURE__ */ jsx(
2141
+ PlaybookDebugPanel,
2142
+ {
2143
+ state,
2144
+ location,
2145
+ allowed: debug?.allowed,
2146
+ implementedTests: debug?.implementedTests
2147
+ }
2148
+ ) })
2149
+ ] })
2150
+ ]
2151
+ }
2152
+ );
2153
+ }
2154
+
2155
+ // src/proxy.ts
2156
+ var FORWARDED_REQUEST_HEADERS = [
2157
+ "accept",
2158
+ "accept-language",
2159
+ "content-type",
2160
+ "referer",
2161
+ "user-agent",
2162
+ "x-forwarded-for"
2163
+ ];
2164
+ var FORWARDED_RESPONSE_HEADERS = ["content-type", "cache-control", "etag"];
2165
+ var CORS_HEADERS = {
2166
+ "access-control-allow-origin": "*",
2167
+ "access-control-allow-methods": "GET, POST, OPTIONS",
2168
+ "access-control-allow-headers": "Content-Type"
2169
+ };
2170
+ var ALLOWED_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "POST", "OPTIONS"]);
2171
+ var NULL_BODY_STATUSES = /* @__PURE__ */ new Set([101, 204, 205, 304]);
2172
+ var PROXY_PREFIX = "/apps/playbook/";
2173
+ var PROXY_TIMEOUT_MS = 5e3;
2174
+ var PROXY_MAX_BODY_BYTES = 64 * 1024;
2175
+ function playbookBackendUrl(requestUrl, platformUrl) {
2176
+ const url = new URL(requestUrl);
2177
+ const idx = url.pathname.indexOf(PROXY_PREFIX);
2178
+ const subPath = idx !== -1 ? url.pathname.slice(idx + PROXY_PREFIX.length) : "";
2179
+ const backendPath = subPath.startsWith("api/") ? `/${subPath}` : `/api/${subPath}`;
2180
+ const backend = new URL(backendPath, platformUrl);
2181
+ backend.search = url.search;
2182
+ return backend.toString();
2183
+ }
2184
+ function plain(status, text) {
2185
+ return new Response(text, {
2186
+ status,
2187
+ headers: {
2188
+ ...CORS_HEADERS,
2189
+ "content-type": "text/plain; charset=utf-8",
2190
+ "cache-control": "no-store"
2191
+ }
2192
+ });
2193
+ }
2194
+ function resolvePlatformUrl(option, args) {
2195
+ const fromOption = typeof option === "function" ? option(args) : option;
2196
+ if (fromOption) return fromOption;
2197
+ const env = args.context?.env;
2198
+ const fromEnv = env?.PLAYBOOK_PLATFORM_URL;
2199
+ return typeof fromEnv === "string" && fromEnv ? fromEnv : DEFAULT_PLATFORM_URL;
2200
+ }
2201
+ async function readCappedBody(request, max) {
2202
+ const declared = Number(request.headers.get("content-length"));
2203
+ if (Number.isFinite(declared) && declared > max) return null;
2204
+ const text = await request.text();
2205
+ return new TextEncoder().encode(text).length > max ? null : text;
2206
+ }
2207
+ function createPlaybookProxyHandler({
2208
+ platformUrl,
2209
+ timeoutMs = PROXY_TIMEOUT_MS,
2210
+ maxBodyBytes = PROXY_MAX_BODY_BYTES,
2211
+ fetchImpl
2212
+ } = {}) {
2213
+ const proxy = async (args) => {
2214
+ const { request } = args;
2215
+ const method = request.method.toUpperCase();
2216
+ if (method === "OPTIONS") {
2217
+ return new Response(null, {
2218
+ status: 204,
2219
+ headers: { ...CORS_HEADERS, "access-control-max-age": "86400" }
2220
+ });
2221
+ }
2222
+ if (!ALLOWED_METHODS.has(method)) return plain(405, "Method Not Allowed");
2223
+ const controller = new AbortController();
2224
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
2225
+ try {
2226
+ const backendUrl = playbookBackendUrl(
2227
+ request.url,
2228
+ resolvePlatformUrl(platformUrl, args)
2229
+ );
2230
+ const headers = new Headers();
2231
+ for (const name of FORWARDED_REQUEST_HEADERS) {
2232
+ const value = request.headers.get(name);
2233
+ if (value) headers.set(name, value);
2234
+ }
2235
+ headers.set("x-forwarded-host", new URL(request.url).host);
2236
+ const init = { method, headers, signal: controller.signal };
2237
+ if (method !== "GET" && method !== "HEAD") {
2238
+ const body3 = await readCappedBody(request, maxBodyBytes);
2239
+ if (body3 === null) return plain(413, "Payload Too Large");
2240
+ init.body = body3;
2241
+ }
2242
+ const upstream = await (fetchImpl ?? fetch)(backendUrl, init);
2243
+ const responseHeaders = new Headers();
2244
+ for (const name of FORWARDED_RESPONSE_HEADERS) {
2245
+ const value = upstream.headers.get(name);
2246
+ if (value) responseHeaders.set(name, value);
2247
+ }
2248
+ for (const [k, v] of Object.entries(CORS_HEADERS)) responseHeaders.set(k, v);
2249
+ responseHeaders.set("cache-control", "no-store");
2250
+ const nullBody = NULL_BODY_STATUSES.has(upstream.status) || method === "HEAD";
2251
+ const body2 = nullBody ? null : await upstream.arrayBuffer();
2252
+ return new Response(body2, { status: upstream.status, headers: responseHeaders });
2253
+ } catch (error) {
2254
+ const timedOut = controller.signal.aborted;
2255
+ console.warn(
2256
+ "[playbook] proxy",
2257
+ timedOut ? "upstream timeout" : "upstream failed",
2258
+ String(error)
2259
+ );
2260
+ return timedOut ? plain(504, "Gateway Timeout") : plain(502, "Bad Gateway");
2261
+ } finally {
2262
+ clearTimeout(timer);
2263
+ }
2264
+ };
2265
+ return { loader: proxy, action: proxy };
2266
+ }
2267
+
2268
+ // src/consent-adapters.ts
2269
+ var TRUEVAULT_CONSENT_COOKIE = "polaris_consent_settings";
2270
+ var TRUEVAULT_CONSENT_EVENT = "consentChanged";
2271
+ var POLL_INTERVAL_MS = 500;
2272
+ var POLL_CHECKS = 20;
2273
+ function trueVaultDecision(raw, gpc, { whenMissing = "pending", gpc: gpcMode = "follow-banner" } = {}) {
2274
+ if (gpc && gpcMode === "deny") return "denied";
2275
+ if (raw === null || raw === void 0 || raw === "") return whenMissing;
2276
+ let data = null;
2277
+ for (const candidate of [raw, safeDecode(raw)]) {
2278
+ if (candidate === null) continue;
2279
+ try {
2280
+ data = JSON.parse(candidate);
2281
+ break;
2282
+ } catch {
2283
+ }
2284
+ }
2285
+ const permitted = data?.analyticsPermitted;
2286
+ if (permitted === true) return "granted";
2287
+ if (permitted === false) return "denied";
2288
+ return "pending";
2289
+ }
2290
+ function safeDecode(raw) {
2291
+ try {
2292
+ return decodeURIComponent(raw);
2293
+ } catch {
2294
+ return null;
2295
+ }
2296
+ }
2297
+ function readDocumentCookie(name) {
2298
+ try {
2299
+ const match = document.cookie.match(
2300
+ new RegExp(`(?:^|; )${name}=([^;]*)`)
2301
+ );
2302
+ return match ? match[1] : null;
2303
+ } catch {
2304
+ return null;
2305
+ }
2306
+ }
2307
+ function clientGpc() {
2308
+ try {
2309
+ return navigator.globalPrivacyControl === true;
2310
+ } catch {
2311
+ return false;
2312
+ }
2313
+ }
2314
+ function createTrueVaultConsent(options = {}) {
2315
+ return {
2316
+ id: "truevault",
2317
+ fromRequest(request) {
2318
+ try {
2319
+ const cookies = parseCookies(request.headers.get("cookie"));
2320
+ const gpc = request.headers.get("sec-gpc") === "1";
2321
+ return trueVaultDecision(
2322
+ cookies[TRUEVAULT_CONSENT_COOKIE],
2323
+ gpc,
2324
+ options
2325
+ );
2326
+ } catch {
2327
+ return "pending";
2328
+ }
2329
+ },
2330
+ read() {
2331
+ if (typeof document === "undefined") return "pending";
2332
+ return trueVaultDecision(
2333
+ readDocumentCookie(TRUEVAULT_CONSENT_COOKIE),
2334
+ clientGpc(),
2335
+ options
2336
+ );
2337
+ },
2338
+ subscribe(onChange) {
2339
+ if (typeof window === "undefined") return () => {
2340
+ };
2341
+ const handler = () => setTimeout(onChange, 0);
2342
+ const onVisible = () => {
2343
+ if (document.visibilityState === "visible") onChange();
2344
+ };
2345
+ window.addEventListener(TRUEVAULT_CONSENT_EVENT, handler);
2346
+ document.addEventListener("visibilitychange", onVisible);
2347
+ let poll = null;
2348
+ if (readDocumentCookie(TRUEVAULT_CONSENT_COOKIE) === null) {
2349
+ let checks = 0;
2350
+ poll = setInterval(() => {
2351
+ checks += 1;
2352
+ const present = readDocumentCookie(TRUEVAULT_CONSENT_COOKIE) !== null;
2353
+ if (present || checks >= POLL_CHECKS) {
2354
+ if (poll) clearInterval(poll);
2355
+ poll = null;
2356
+ if (present) onChange();
2357
+ }
2358
+ }, POLL_INTERVAL_MS);
2359
+ }
2360
+ return () => {
2361
+ window.removeEventListener(TRUEVAULT_CONSENT_EVENT, handler);
2362
+ document.removeEventListener("visibilitychange", onVisible);
2363
+ if (poll) clearInterval(poll);
2364
+ };
2365
+ }
2366
+ };
2367
+ }
2368
+ var truevaultConsent = createTrueVaultConsent();
1283
2369
 
1284
2370
  // src/cart-events.ts
1285
2371
  var nextSource = null;
@@ -1295,6 +2381,39 @@ function numericId(gid) {
1295
2381
  const id = gid?.split("/").pop();
1296
2382
  return id && /^\d{1,30}$/.test(id) ? id : null;
1297
2383
  }
2384
+ function parseJson(value) {
2385
+ if (typeof value !== "string" || !value) return null;
2386
+ try {
2387
+ return JSON.parse(value);
2388
+ } catch {
2389
+ return null;
2390
+ }
2391
+ }
2392
+ function addedLinesFrom(input) {
2393
+ if (!input) return [];
2394
+ if (Array.isArray(input)) return input;
2395
+ if (typeof FormData === "undefined" || !(input instanceof FormData)) return [];
2396
+ const formInput = parseJson(input.get("cartFormInput"));
2397
+ if (formInput?.inputs?.lines) return formInput.inputs.lines;
2398
+ const action = input.get("action");
2399
+ const raw = action === "Create" ? parseJson(input.get("cart"))?.lines : parseJson(input.get("lines"));
2400
+ return Array.isArray(raw) ? raw : [];
2401
+ }
2402
+ function trackAddToCart(source, {
2403
+ lines,
2404
+ cart
2405
+ }) {
2406
+ try {
2407
+ const conn = cart?.lines;
2408
+ const snapshots = Array.isArray(conn) ? conn : conn?.nodes ?? conn?.edges?.map((e) => e.node) ?? [];
2409
+ trackAddToCartLines(
2410
+ addedLinesFrom(lines),
2411
+ snapshots,
2412
+ source ?? takeAddSource()
2413
+ );
2414
+ } catch {
2415
+ }
2416
+ }
1298
2417
  function trackAddToCartLines(lines, cartLines, source) {
1299
2418
  try {
1300
2419
  for (const line of lines) {
@@ -1319,15 +2438,4 @@ function trackAddToCartLines(lines, cartLines, source) {
1319
2438
  }
1320
2439
  }
1321
2440
 
1322
- // src/cart.ts
1323
- var CART_VISITOR_ATTRIBUTE = "_pb_vid";
1324
- function playbookCartAttribute(visitorId) {
1325
- return { key: CART_VISITOR_ATTRIBUTE, value: visitorId };
1326
- }
1327
- function cartHasPlaybookAttribute(attributes, visitorId) {
1328
- return !!attributes?.some(
1329
- (a) => a.key === CART_VISITOR_ATTRIBUTE && a.value === visitorId
1330
- );
1331
- }
1332
-
1333
- export { CART_VISITOR_ATTRIBUTE, CONTROL_ARM, DEFAULT_EVENT_URL, DEFAULT_EXPOSURE_URL, DEFAULT_PLATFORM_URL, DEFAULT_SUPPORTED_EVENTS, LEGACY_VISITOR_COOKIE, PlaybookExposure, PlaybookProvider, SESSION_VISITOR_COOKIE, STANDARD_EVENTS, VISITOR_COOKIE, analyticsConsentFromCookie, assignTest, cartHasPlaybookAttribute, chooseVariation, createPlaybook, declareConsentRequired, detectDevice, detectGeo, getBucketRanges, getConsentState, getEqualWeights, getServerTrackedLog, getSessionContext, getTrackedLog, hasSentExposure, hash, inNamespace, isAnalyticsConsentGranted, matchesPathPrefix, onConsentChange, playbookCartAttribute, playbookTrack, prefetchRuleset, setNextAddSource, subscribeTrackedLog, syncVisitorId, takeAddSource, trackAddToCartLines, useAnalyticsAllowed, usePageEngagement, usePlaybookConsent, usePlaybookExposure, usePlaybookInteraction, usePlaybookState, usePlaybookVariant, usePreviewParamRedirect, visitorSeedScript, waitForConsentAPI };
2441
+ export { AA_SITEWIDE_TEST, CART_SYNC_IDLE_MS, CART_VISITOR_ATTRIBUTE, CONTROL_ARM, DEFAULT_DATALAYER_EVENT, DEFAULT_EVENT_URL, DEFAULT_EXPOSURE_URL, DEFAULT_PLATFORM_URL, DEFAULT_PROXY_ENDPOINT, DEFAULT_SDK_URL, DEFAULT_SUPPORTED_EVENTS, LEGACY_VISITOR_COOKIE, MAX_WRITES_PER_CART, PlaybookAAExposure, PlaybookBoundary, PlaybookDebugPanel, PlaybookExposure, PlaybookHead, PlaybookProvider, PlaybookRoot, SESSION_VISITOR_COOKIE, STANDARD_EVENTS, TRUEVAULT_CONSENT_COOKIE, VISITOR_COOKIE, addedLinesFrom, analyticsConsentFromCookie, assignTest, cartHasPlaybookAttribute, chooseVariation, createCartAttributeReader, createCartAttributeSync, createCartAttributeWriter, createPlaybook, createPlaybookContext, createPlaybookProxyHandler, createTrueVaultConsent, debugPanelAllowed, declareConsentRequired, detectDevice, detectGeo, getBucketRanges, getConsentState, getEqualWeights, getServerTrackedLog, getSessionContext, getTrackedLog, hasPlaybookParams, hasSentExposure, hash, inNamespace, isAnalyticsConsentGranted, isKillSwitchOn, isPreviewHost, matchesPathPrefix, mergeAttributes, onConsentChange, playbookBackendUrl, playbookCartAttribute, playbookTrack, prefetchRuleset, revealScript, sanitizeRuleset, setNextAddSource, subscribeTrackedLog, syncVisitorId, takeAddSource, trackAddToCart, trackAddToCartLines, trueVaultDecision, truevaultConsent, useAnalyticsAllowed, usePageEngagement, usePlaybookConsent, usePlaybookExposure, usePlaybookInteraction, usePlaybookState, usePlaybookVariant, usePreviewParamRedirect, visitorInRunningTest, visitorSeedScript, waitForConsentAPI, withPlaybook, withPlaybookCartAttribute };