@pack/react 4.4.0 → 4.6.0

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import { useOverlayScript } from "./use-overlay-script";
 import { usePlaybookCart } from "./use-playbook-cart";
 import { registerSection } from "./register-section";
 import { registerStorefrontSettingsSchema } from "./register-storefront-settings-schema";
-export { PackProvider, PreviewProvider, RenderSection, RenderSections, registerSection, registerStorefrontSettingsSchema, useLocale, useOverlayScript, usePackContext, usePlaybookCart, useSections, useSiteSettings, };
+import { setPackConsent } from "./pack/consent";
+export { PackProvider, PreviewProvider, RenderSection, RenderSections, registerSection, registerStorefrontSettingsSchema, setPackConsent, useLocale, useOverlayScript, usePackContext, usePlaybookCart, useSections, useSiteSettings, };
 export type { PlaybookCartAdd, PlaybookCartInput } from "./use-playbook-cart";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAEzF,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,gCAAgC,EAChC,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,GAChB,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,gCAAgC,EAChC,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,GAChB,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -7,4 +7,5 @@ import { useOverlayScript } from "./use-overlay-script";
 import { usePlaybookCart } from "./use-playbook-cart";
 import { registerSection } from "./register-section";
 import { registerStorefrontSettingsSchema } from "./register-storefront-settings-schema";
-export { PackProvider, PreviewProvider, RenderSection, RenderSections, registerSection, registerStorefrontSettingsSchema, useLocale, useOverlayScript, usePackContext, usePlaybookCart, useSections, useSiteSettings, };
+import { setPackConsent } from "./pack/consent";
+export { PackProvider, PreviewProvider, RenderSection, RenderSections, registerSection, registerStorefrontSettingsSchema, setPackConsent, useLocale, useOverlayScript, usePackContext, usePlaybookCart, useSections, useSiteSettings, };

package/dist/pack/consent.d.ts

@@ -0,0 +1,25 @@
+declare const PURPOSES: readonly ["analytics", "marketing", "preferences", "saleOfData"];
+export type ConsentPurpose = (typeof PURPOSES)[number];
+/** A consent update, per purpose. Omitted purposes keep their current state. */
+export type PackConsentUpdate = Partial<Record<ConsentPurpose, boolean>>;
+export declare const UNSUPPORTED_RETRY_MS: number;
+/**
+ * Record the visitor's consent with Pack, for themes whose banner is not
+ * Shopify's (OneTrust, Cookiebot, ...). The server sets
+ * `__pack_user_consent`; purposes that already match are not re-sent.
+ *
+ * Stops for 30 minutes, then retries, once the answer can't be Pack's
+ * endpoint: a 404 or 405, a redirect, or a 2xx that isn't JSON. A tab left open
+ * across an upgrade to `@pack/hydrogen` 4.0 records again after the retry.
+ */
+export declare function setPackConsent(update: PackConsentUpdate): Promise<void>;
+/**
+ * Forward the visitor's answer to Shopify's privacy banner to Pack.
+ *
+ * Reads Shopify's Customer Privacy API once it is loaded and again whenever
+ * the visitor answers the banner. An unanswered purpose is never sent, so the
+ * server keeps treating it as unknown.
+ */
+export declare function usePackConsentBridge(): void;
+export {};
+//# sourceMappingURL=consent.d.ts.map

package/dist/pack/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/pack/consent.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,QAAQ,kEAAmE,CAAC;AAQlF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAIvD,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;AAwCzE,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAuBnD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC7E;AAkCD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CA0B3C"}

package/dist/pack/consent.js

@@ -0,0 +1,171 @@
+import { useEffect } from "react";
+// Must mirror @pack/hydrogen/src/session/consent.ts (cookie name, keys and
+// value format) and consent-endpoint.ts (path).
+const CONSENT_COOKIE = "__pack_user_consent";
+const CONSENT_PATH = "/pack/consent";
+const PURPOSES = ["analytics", "marketing", "preferences", "saleOfData"];
+const COOKIE_KEYS = {
+    analytics: "a",
+    marketing: "m",
+    preferences: "p",
+    saleOfData: "s",
+};
+function readConsentCookie() {
+    const consent = {
+        analytics: "unknown",
+        marketing: "unknown",
+        preferences: "unknown",
+        saleOfData: "unknown",
+    };
+    let raw;
+    try {
+        const entry = document.cookie
+            .split("; ")
+            .find((part) => part.startsWith(`${CONSENT_COOKIE}=`));
+        raw = entry && decodeURIComponent(entry.slice(CONSENT_COOKIE.length + 1));
+    }
+    catch {
+        return consent;
+    }
+    if (!raw)
+        return consent;
+    if (raw === "true" || raw === "false") {
+        consent.analytics = raw === "true" ? "granted" : "denied";
+        return consent;
+    }
+    const params = new URLSearchParams(raw);
+    for (const purpose of PURPOSES) {
+        const value = params.get(COOKIE_KEYS[purpose]);
+        if (value === "1")
+            consent[purpose] = "granted";
+        else if (value === "0")
+            consent[purpose] = "denied";
+    }
+    return consent;
+}
+// A server without the endpoint (@pack/hydrogen before 4.0, or another
+// framework) never writes the cookie, so without this every answer and every
+// page load would post again. Retried after a while so a tab left open across
+// an upgrade to 4.0 starts recording again.
+const UNSUPPORTED_KEY = "__pack_consent_unsupported";
+export const UNSUPPORTED_RETRY_MS = 30 * 60 * 1000;
+let unsupportedAtInMemory;
+function isEndpointUnsupported() {
+    let since = unsupportedAtInMemory;
+    if (since === undefined) {
+        try {
+            const stored = Number(sessionStorage.getItem(UNSUPPORTED_KEY));
+            if (stored > 0)
+                since = stored;
+        }
+        catch { }
+    }
+    return since !== undefined && Date.now() - since < UNSUPPORTED_RETRY_MS;
+}
+function markEndpointUnsupported() {
+    const now = Date.now();
+    try {
+        sessionStorage.setItem(UNSUPPORTED_KEY, String(now));
+    }
+    catch {
+        unsupportedAtInMemory = now;
+    }
+}
+/**
+ * Record the visitor's consent with Pack, for themes whose banner is not
+ * Shopify's (OneTrust, Cookiebot, ...). The server sets
+ * `__pack_user_consent`; purposes that already match are not re-sent.
+ *
+ * Stops for 30 minutes, then retries, once the answer can't be Pack's
+ * endpoint: a 404 or 405, a redirect, or a 2xx that isn't JSON. A tab left open
+ * across an upgrade to `@pack/hydrogen` 4.0 records again after the retry.
+ */
+export async function setPackConsent(update) {
+    if (isEndpointUnsupported())
+        return;
+    const current = readConsentCookie();
+    const changed = {};
+    for (const purpose of PURPOSES) {
+        const value = update[purpose];
+        if (typeof value !== "boolean")
+            continue;
+        if (current[purpose] !== (value ? "granted" : "denied")) {
+            changed[purpose] = value;
+        }
+    }
+    if (!Object.keys(changed).length)
+        return;
+    try {
+        const response = await fetch(CONSENT_PATH, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(changed),
+            credentials: "same-origin",
+            keepalive: true,
+        });
+        const isPackEndpoint = response.status !== 404 &&
+            response.status !== 405 &&
+            !response.redirected &&
+            (!response.ok ||
+                !!response.headers
+                    .get("Content-Type")
+                    ?.toLowerCase()
+                    .includes("application/json"));
+        if (!isPackEndpoint)
+            markEndpointUnsupported();
+    }
+    catch (error) {
+        console.error("Error hit /pack/consent: ", error?.message);
+    }
+}
+function fromShopifyValue(value) {
+    if (value === "yes")
+        return true;
+    if (value === "no")
+        return false;
+    return undefined;
+}
+function readShopifyConsent() {
+    const customerPrivacy = window.Shopify?.customerPrivacy;
+    const consent = customerPrivacy?.currentVisitorConsent?.();
+    if (!consent)
+        return undefined;
+    return {
+        analytics: fromShopifyValue(consent.analytics),
+        marketing: fromShopifyValue(consent.marketing),
+        preferences: fromShopifyValue(consent.preferences),
+        saleOfData: fromShopifyValue(consent.sale_of_data),
+    };
+}
+/**
+ * Forward the visitor's answer to Shopify's privacy banner to Pack.
+ *
+ * Reads Shopify's Customer Privacy API once it is loaded and again whenever
+ * the visitor answers the banner. An unanswered purpose is never sent, so the
+ * server keeps treating it as unknown.
+ */
+export function usePackConsentBridge() {
+    useEffect(() => {
+        const syncFromApi = () => {
+            const consent = readShopifyConsent();
+            if (consent)
+                setPackConsent(consent);
+        };
+        const onCollected = (event) => {
+            const detail = event.detail || {};
+            setPackConsent({
+                analytics: detail.analyticsAllowed,
+                marketing: detail.marketingAllowed,
+                preferences: detail.preferencesAllowed,
+                saleOfData: detail.saleOfDataAllowed,
+            });
+        };
+        document.addEventListener("visitorConsentCollected", onCollected);
+        document.addEventListener("consentTrackingApiLoaded", syncFromApi);
+        syncFromApi();
+        return () => {
+            document.removeEventListener("visitorConsentCollected", onCollected);
+            document.removeEventListener("consentTrackingApiLoaded", syncFromApi);
+        };
+    }, []);
+}

package/dist/pack/pack-context.d.ts

@@ -1,4 +1,5 @@
 import React, { type ReactNode } from "react";
+import { type PreviewContext } from "./preview-toolbar";
 import "./pack-debug";
 type PackContextValue = {
     isPreview: boolean;
@@ -7,16 +8,7 @@ type PackContextValue = {
             src?: string;
             version?: string;
         };
-        previewContext?: {
-            linkName?: string;
-            releaseId?: string;
-            releaseName?: string;
-            locale?: string;
-            pageDraft?: string;
-            siteSettingsDraft?: string;
-            testHandle?: string;
-            testVariantHandle?: string;
-        };
+        previewContext?: PreviewContext;
         [key: string]: any;
     };
     siteSettings: any;

package/dist/pack/pack-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-context.d.ts","sourceRoot":"","sources":["../../src/pack/pack-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAKZ,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAKf,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE;YACR,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,cAAc,CAAC,EAAE;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,GAAG,CAAC;IAClB,eAAe,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,GAAG,CAAC;IACjB,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,SAAS,EAAE,CACT,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,KACL,IAAI,CAAC;CACX,CAAC;AAEF,eAAO,MAAM,WAAW,iCAUtB,CAAC;AAEH,eAAO,MAAM,cAAc,wBAAgC,CAAC;AAE5D,UAAU,gBAAgB;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAUD,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,oBAA4B,EAC5B,YAAY,EAAE,yBAAyB,EACvC,cAAc,EACd,kBAAuB,EACvB,MAAM,EAAE,aAAoB,GAC7B,EAAE,gBAAgB,qBAuDlB;AAED,eAAO,MAAM,eAAe,qBAAe,CAAC"}
+{"version":3,"file":"pack-context.d.ts","sourceRoot":"","sources":["../../src/pack/pack-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAKZ,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE;YACR,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,GAAG,CAAC;IAClB,eAAe,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,GAAG,CAAC;IACjB,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,SAAS,EAAE,CACT,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,KACL,IAAI,CAAC;CACX,CAAC;AAEF,eAAO,MAAM,WAAW,iCAUtB,CAAC;AAEH,eAAO,MAAM,cAAc,wBAAgC,CAAC;AAE5D,UAAU,gBAAgB;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAUD,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,oBAA4B,EAC5B,YAAY,EAAE,yBAAyB,EACvC,cAAc,EACd,kBAAuB,EACvB,MAAM,EAAE,aAAoB,GAC7B,EAAE,gBAAgB,qBAwDlB;AAED,eAAO,MAAM,eAAe,qBAAe,CAAC"}

package/dist/pack/pack-context.js

@@ -1,6 +1,7 @@
 import React, { createContext, useContext, useState, useMemo, useEffect, } from "react";
 import { usePackTrack } from "./pack-analytics";
-import { PreviewToast } from "./preview-toast";
+import { usePackConsentBridge } from "./consent";
+import { PreviewToolbar } from "./preview-toolbar";
 import { useOverlayScript } from "../use-overlay-script";
 import { useCustomizerShell } from "../use-customizer-shell";
 import "./pack-debug";
@@ -53,9 +54,10 @@ export function PackProvider({ children, isPreviewModeEnabled = false, siteSetti
         setSiteSettings(previewStorefrontSettings);
     }, [previewStorefrontSettings]);
     usePackTrack();
+    usePackConsentBridge();
     return (React.createElement(PackContext.Provider, { value: value },
         React.createElement(CustomizerShell, null),
         children,
-        React.createElement(PreviewToast, { isPreviewModeEnabled: !!isPreviewModeEnabled, environment: value.contentEnvironment, previewContext: customizerMeta?.previewContext })));
+        React.createElement(PreviewToolbar, { isPreviewModeEnabled: !!isPreviewModeEnabled, environment: value.contentEnvironment, previewContext: customizerMeta?.previewContext })));
 }
 export const PreviewProvider = PackProvider;

package/dist/pack/pack-debug.d.ts

@@ -11,6 +11,7 @@ interface StorefrontTestRulesCacheInfo {
 }
 interface PackDebugHelpers {
     getTestInfo(): StorefrontTestInfo | null;
+    getTestInfos(): StorefrontTestInfo[];
     getTestRulesCacheInfo(): StorefrontTestRulesCacheInfo | null;
 }
 declare global {

package/dist/pack/pack-debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-debug.d.ts","sourceRoot":"","sources":["../../src/pack/pack-debug.ts"],"names":[],"mappings":"AAmBA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,gBAAgB;IACxB,WAAW,IAAI,kBAAkB,GAAG,IAAI,CAAC;IACzC,qBAAqB,IAAI,4BAA4B,GAAG,IAAI,CAAC;CAC9D;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAC9B;CACF;AA0HD,OAAO,EAAE,CAAC"}
+{"version":3,"file":"pack-debug.d.ts","sourceRoot":"","sources":["../../src/pack/pack-debug.ts"],"names":[],"mappings":"AA2BA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,gBAAgB;IACxB,WAAW,IAAI,kBAAkB,GAAG,IAAI,CAAC;IACzC,YAAY,IAAI,kBAAkB,EAAE,CAAC;IACrC,qBAAqB,IAAI,4BAA4B,GAAG,IAAI,CAAC;CAC9D;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAC9B;CACF;AAwKD,OAAO,EAAE,CAAC"}

package/dist/pack/pack-debug.js

@@ -57,18 +57,53 @@ function parseTestSessionCookie(cookieHeader) {
     }
     return null;
 }
-function getStorefrontTestInfo() {
-    const payload = parseTestSessionCookie(document.cookie || "");
-    const test = payload?.test_data?.handle;
-    const variant = payload?.test_data?.testVariant?.handle;
+function toStorefrontTestInfo(assignment, expiresAt) {
+    const test = assignment?.handle;
+    const variant = assignment?.testVariant?.handle;
     if (!test || !variant) {
         return null;
     }
-    return {
-        test,
-        variant,
-        expiresAt: payload?.test_expire_at || null,
-    };
+    return { test, variant, expiresAt };
+}
+/**
+ * Every test the visitor is currently bucketed into, oldest assignment first.
+ *
+ * Read from the session cookie, so this is what the visitor is *assigned* to —
+ * not which of those tests is serving the current page. Which assignment supplies
+ * content is decided per request on the server from the page's targeting rules
+ * and is never persisted; check the CMS request log or `useAbTest()` for that.
+ *
+ * Falls back to the pre-4.0 single-slot payload for sessions written by an older
+ * SDK that have not been migrated yet.
+ */
+function getStorefrontTestInfos() {
+    const payload = parseTestSessionCookie(document.cookie || "");
+    const expiresAt = payload?.test_expire_at || null;
+    const assignments = payload?.test_data_map;
+    if (assignments && typeof assignments === "object") {
+        // Ordered the way the SDK picks its primary: oldest first, ties broken on
+        // test id. Every assignment made in one request shares a millisecond, so the
+        // tie-break decides the common case — without it `getTestInfo()` can name a
+        // different test than `pack.abTest` does. The map is keyed by test id, so
+        // the key stands in when a hand-edited entry has none.
+        return Object.entries(assignments)
+            .sort(([idA, a], [idB, b]) => (a?.assignedAt ?? 0) - (b?.assignedAt ?? 0) ||
+            (a?.id ?? idA).localeCompare(b?.id ?? idB))
+            .map(([, assignment]) => toStorefrontTestInfo(assignment, expiresAt))
+            .filter((info) => info !== null);
+    }
+    const legacy = toStorefrontTestInfo(payload?.test_data, expiresAt);
+    return legacy ? [legacy] : [];
+}
+/**
+ * The oldest assignment on the session.
+ *
+ * Deliberately not "the test serving this page": a visitor can be assigned to
+ * several tests at once, and the one supplying content varies by page. Kept for
+ * back-compat with the single-test debug surface — prefer `getTestInfos()`.
+ */
+function getStorefrontTestInfo() {
+    return getStorefrontTestInfos()[0] || null;
 }
 function getStorefrontTestRulesCacheInfo() {
     const payload = parseTestSessionCookie(document.cookie || "");
@@ -98,6 +133,7 @@ function initializePackDebugHelpers() {
     window.packDebug = {
         ...window.packDebug,
         getTestInfo: getStorefrontTestInfo,
+        getTestInfos: getStorefrontTestInfos,
         getTestRulesCacheInfo: getStorefrontTestRulesCacheInfo,
     };
 }

package/dist/pack/preview-toolbar.d.ts

@@ -0,0 +1,47 @@
+import { type CSSProperties } from "react";
+import * as React from "react";
+export interface PreviewContext {
+    linkName?: string;
+    releaseId?: string;
+    releaseName?: string;
+    locale?: string;
+    pageDraft?: string;
+    siteSettingsDraft?: string;
+    testHandle?: string;
+    testVariantHandle?: string;
+}
+export interface PreviewToolbarProps {
+    isPreviewModeEnabled: boolean;
+    environment?: string;
+    previewContext?: PreviewContext;
+}
+export type PreviewDetail = {
+    label: string;
+    value: string;
+};
+type ToolbarEdge = "top" | "right" | "bottom" | "left";
+type ToolbarRect = {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+};
+type ToolbarViewport = {
+    width: number;
+    height: number;
+};
+export declare function buildPreviewDetails(environment?: string, previewContext?: PreviewContext): PreviewDetail[];
+export declare function buildPreviewSummary(environment?: string, previewContext?: PreviewContext): string;
+export declare function getConstrainedPillPosition(position: {
+    left: number;
+    top: number;
+}, viewport: ToolbarViewport): CSSProperties;
+export declare function getPanelPosition(edge: ToolbarEdge, pillRect: ToolbarRect | null, viewport: ToolbarViewport): CSSProperties;
+/**
+ * Thin gate so production storefront pages (preview off) mount no listeners,
+ * timers, storage reads, or effects. The top-window check is a hydration-safe
+ * client-only snapshot; it renders nothing on the server and during hydration.
+ */
+export declare const PreviewToolbar: ({ isPreviewModeEnabled, environment, previewContext, }: PreviewToolbarProps) => React.JSX.Element | null;
+export {};
+//# sourceMappingURL=preview-toolbar.d.ts.map

package/dist/pack/preview-toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-toolbar.d.ts","sourceRoot":"","sources":["../../src/pack/preview-toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAUnB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAUF,KAAK,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,KAAK,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAChF,KAAK,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA4CzD,wBAAgB,mBAAmB,CACjC,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,cAAc,GAC9B,aAAa,EAAE,CA2CjB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,cAAc,UAqBhC;AAsID,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACvC,QAAQ,EAAE,eAAe,GACxB,aAAa,CAOf;AA0DD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,WAAW,GAAG,IAAI,EAC5B,QAAQ,EAAE,eAAe,GACxB,aAAa,CA6Cf;AAorBD;;;;GAIG;AACH,eAAO,MAAM,cAAc,2DAIxB,mBAAmB,6BAerB,CAAC"}