@zonos/elements 1.3.266 → 1.3.268

package/dist/collection/components/checkout/zonos-checkout/zonos-checkout-payment/zonos-checkout-payment.js

@@ -1,8 +1,9 @@
 import { Fragment, h, Host, } from "@stencil/core";
 import { cartStore, cartStoreNextStep, } from "../../../store/checkout/cart";
 import { paypalStore } from "../../../store/checkout/paypal";
+import { isPolicyConsentRequired, policyConsentStore, } from "../../../store/checkout/policyConsent";
 import { storeCreditStore, storeCreditStoreCoversFullAmount, } from "../../../store/checkout/storeCredit";
-import { stripeStore } from "../../../store/checkout/stripe";
+import { stripeStore, stripeStoreRecordPolicyConsent, } from "../../../store/checkout/stripe";
 import { storageStore } from "../../../store/storageStore";
 import { translate } from "../../../store/translationStore";
 import { zonosStore } from "../../../store/zonosStore";
@@ -67,6 +68,30 @@ export class ZonosCheckoutPayment {
                 }, 10);
                 return;
             }
+            // Block submit when the merchant requires policy consent and the buyer hasn't accepted.
+            if (isPolicyConsentRequired() && !policyConsentStore.accepted) {
+                policyConsentStore.showError = true;
+                setTimeout(() => {
+                    var _a;
+                    (_a = this.ele
+                        .querySelector('zonos-policy-consent')) === null || _a === void 0 ? void 0 : _a.scrollIntoView({ behavior: 'smooth' });
+                }, 10);
+                return;
+            }
+            // Lock consent state for the rest of the flow so the buyer can't uncheck
+            // during the async work below (which would create a race where the
+            // metadata builder sees `accepted=false` and skips writing the consent
+            // entry). Cleared on every checkout close.
+            if (isPolicyConsentRequired()) {
+                policyConsentStore.locked = true;
+            }
+            // Persist the buyer's consent into the checkout session metadata BEFORE confirming
+            // payment, so the recorded consent is durable even if Stripe takes a while or fails.
+            // We deliberately don't block payment on a recording failure — a transient network
+            // hiccup shouldn't gate the buyer out, and the failure is logged inside the helper
+            // via `logError` for observability. The buyer's consent intent is also captured
+            // client-side via the checkbox state and `acceptedAt` timestamp.
+            await stripeStoreRecordPolicyConsent();
             stripeStore.checkoutSettlementCurrency = currencyCode;
             // submit google tag when the form is complete
             submitAnalytics({
@@ -106,17 +131,46 @@ export class ZonosCheckoutPayment {
             });
         };
         this.placeTestOrder = async () => {
-            this.internalContinueLoading = true;
-            const { errors } = await placeTestOrder();
-            if (errors.length) {
-                this.stagingOrderCreateErrorMessage =
-                    errors[0] || 'Failed to create staging order. Please try again.';
-                this.internalContinueLoading = false;
+            // Staging "Place test order" still represents the buyer placing an order,
+            // so apply the same consent gate the real Pay button uses. Consistency
+            // matters here: merchants testing the flow should see the same blockers
+            // a real buyer would hit.
+            if (isPolicyConsentRequired() && !policyConsentStore.accepted) {
+                policyConsentStore.showError = true;
+                setTimeout(() => {
+                    var _a;
+                    (_a = this.ele
+                        .querySelector('zonos-policy-consent')) === null || _a === void 0 ? void 0 : _a.scrollIntoView({ behavior: 'smooth' });
+                }, 10);
                 return;
             }
-            this.internalContinueLoading = false;
-            // continue to the next step
-            cartStoreNextStep();
+            const consentWasRequired = isPolicyConsentRequired();
+            if (consentWasRequired) {
+                policyConsentStore.locked = true;
+            }
+            try {
+                this.internalContinueLoading = true;
+                // Don't block the test order on a consent-record failure — failure is logged
+                // inside the helper and surfaced in Vercel logs for observability.
+                await stripeStoreRecordPolicyConsent();
+                const { errors } = await placeTestOrder();
+                if (errors.length) {
+                    this.stagingOrderCreateErrorMessage =
+                        errors[0] || 'Failed to create staging order. Please try again.';
+                    this.internalContinueLoading = false;
+                    return;
+                }
+                this.internalContinueLoading = false;
+                // continue to the next step
+                cartStoreNextStep();
+            }
+            finally {
+                // Release the consent lock on every terminal exit so a failed test order
+                // doesn't leave the checkbox stuck disabled in the merchant's staging UI.
+                if (consentWasRequired) {
+                    policyConsentStore.locked = false;
+                }
+            }
         };
     }
     continueLoadingWatcher() {
@@ -155,7 +209,7 @@ export class ZonosCheckoutPayment {
                 const theme = this.isMobile
                     ? zonosStore.appearance.theme
                     : themeBasedColor;
-                return (h(Fragment, null, this.stagingOrderCreateErrorMessage && (h("zonos-banner", { class: "zonos--error-banner", intent: "error" }, this.stagingOrderCreateErrorMessage)), h("zonos-empty-state-payment", { emptyStateText: translate('No payment method needed for staging'), theme: theme }), h("div", { class: "zonos--group-btn" }, h("zonos-button", { backgroundColor: this.submitBtnColor, loading: this.internalContinueLoading, onClick: () => {
+                return (h(Fragment, null, this.stagingOrderCreateErrorMessage && (h("zonos-banner", { class: "zonos--error-banner", intent: "error" }, this.stagingOrderCreateErrorMessage)), h("zonos-empty-state-payment", { emptyStateText: translate('No payment method needed for staging'), theme: theme }), h("zonos-policy-consent", null), h("div", { class: "zonos--group-btn" }, h("zonos-button", { backgroundColor: this.submitBtnColor, loading: this.internalContinueLoading, onClick: () => {
                         void this.placeTestOrder();
                     }, size: "lg",
                     // use primary type when on mobile mode
@@ -164,7 +218,7 @@ export class ZonosCheckoutPayment {
             return (h(Fragment, null, this.showErrorBanner && (h("zonos-banner", { class: "zonos--error-banner", intent: "error" }, translate('Missing required fields. Make sure all fields are completed.'))), this.hasStripePaymentError && (h("zonos-banner", { class: "zonos--payment-error-banner", intent: "error" }, stripeStore.customErrorMessage ||
                 translate("We couldn't complete your payment. Please verify the payment details and try again."))), paypalStore.paypalErrorMessage && (h("zonos-banner", { class: "zonos--payment-error-banner", intent: "error" }, paypalStore.paypalErrorMessage)), cartStore.customerAuthenticationToken &&
                 storeCreditStore.availableBalance != null &&
-                storeCreditStore.availableBalance > 0 && (h("zonos-store-credit", null)), storeCreditCoversFullOrder ? (h("zonos-banner", { intent: "info" }, translate('Store credit covers your full order'))) : (h("zonos-payment", null)), h("div", { class: "zonos--group-btn" }, (!isPaypalTabSelected || storeCreditCoversFullOrder) && (h(Fragment, null, h("zonos-button", { backgroundColor: this.submitBtnColor, bold: true, isDisabled: this.continueLoading &&
+                storeCreditStore.availableBalance > 0 && (h("zonos-store-credit", null)), storeCreditCoversFullOrder ? (h("zonos-banner", { intent: "info" }, translate('Store credit covers your full order'))) : (h("zonos-payment", null)), h("zonos-policy-consent", null), h("div", { class: "zonos--group-btn" }, (!isPaypalTabSelected || storeCreditCoversFullOrder) && (h(Fragment, null, h("zonos-button", { backgroundColor: this.submitBtnColor, bold: true, isDisabled: this.continueLoading &&
                     stripeStore.checkoutSettlementCurrency === 'USD', loading: this.continueLoading &&
                     stripeStore.checkoutSettlementCurrency !== 'USD', onClick: async () => {
                     if (!cartStore.checkoutSession) {

package/dist/collection/components/checkout/zonos-checkout/zonos-checkout.js

@@ -1,6 +1,7 @@
 import { Fragment, h, Host, } from "@stencil/core";
 import { cartStore, cartStoreClearCheckoutInterval, cartStoreNextStep, cartStoreOnChange, cartStoreReset, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateToErrorState, } from "../../store/checkout/cart";
 import { paypalInitScript, paypalStore, paypalStoreHasPaypalEnabled, } from "../../store/checkout/paypal";
+import { isPolicyConsentRequired, policyConsentStore, policyConsentStoreReset, } from "../../store/checkout/policyConsent";
 import { storeCreditStoreApplyCredit, storeCreditStoreCoversFullAmount, storeCreditStoreCreateOrder, storeCreditStoreGetEffectiveAmount, } from "../../store/checkout/storeCredit";
 import { getCheckoutSessionBody, initStripeElements, stripeStore, stripeStoreCleanupDomesticShippingSession, stripeStoreConfirmPayment, stripeStoreGetPaymentIntent, stripeStoreHandleInventoryCheck, stripeStoreHandleInventoryRefund, stripeStoreInitCheckoutSession, stripeStoreOnChange, stripeStorePrefetchLandedCost, stripeStoreReset, stripeStoreRetrievePayment, stripeStoreUpdateCheckoutSessionBaseCurrency, } from "../../store/checkout/stripe";
 import { localizationStore, localizationStoreOnChange, } from "../../store/hello/localization";
@@ -562,6 +563,12 @@ export class ZonosCheckout {
             // reset cart store if it's not preview mode and only when checkout is in the finish step.
             cartStoreReset();
         }
+        // Clear policy consent on every close (not just finish) so a buyer who
+        // checked the box mid-flow and then closed can't carry the prior
+        // acceptance into a new attempt without a fresh checkbox click.
+        if (!this.preview) {
+            policyConsentStoreReset();
+        }
         // reset step to customer info
         cartStore.step = 'customer-info';
         // reset the tab item, so that user needs to click on Continue button to re-quote the landed cost if needed.
@@ -1390,77 +1397,104 @@ export class ZonosCheckout {
             stripeStore.shouldRenderPayInUsdButton &&
             !this.payInUsdConfirmDialogOpen) {
             this.payInUsdConfirmDialogOpen = true;
+            // Don't unlock consent here — the USD-confirm dialog is mid-flow; the
+            // lock should hold until the user resolves the dialog and we re-enter.
             return;
         }
         // Close the dialog after the user confirms to proceed with the payment in USD
         this.payInUsdConfirmDialogOpen = false;
-        // reset paypal error message
-        paypalStore.paypalErrorMessage = null;
-        // reset error state
-        stripeStore.hasPaymentError = false;
-        this.submitLoading = true;
-        // reset inventory check message
-        cartStore.inventoryCheckErrorMessage = null;
-        // Attempt to change settlement currency to USD
-        const baseCurrencyUpdateSuccess = await stripeStoreUpdateCheckoutSessionBaseCurrency();
-        // Should not proceed to confirm payment if base currency update failed
-        if (!baseCurrencyUpdateSuccess) {
-            stripeStore.hasPaymentError = true;
-            stripeStore.customErrorMessage = translate('Unable to complete payment in [currency]. Please try again or select a different currency. If the issue persists, contact our support team for assistance.', {
-                currency: stripeStore.checkoutSettlementCurrency,
-            });
-            this.submitLoading = false;
-            return;
-        }
+        // Track whether consent was required at the start of this flow so we know
+        // whether to release the lock in `finally`. The store reset on checkout
+        // close will catch any stragglers, but releasing here lets the buyer
+        // recover (uncheck / retry) when an async step aborts.
+        const consentWasRequired = isPolicyConsentRequired();
         try {
-            // check inventory before proceeding to payment
-            cartStore.inventoryCheckErrorMessage =
-                await stripeStoreHandleInventoryCheck();
-        }
-        catch (_a) {
-            // If user provide callback and it throw an exception, default to this message and stop the payment.
-            cartStore.inventoryCheckErrorMessage = translate('Unable to check inventory. Please try again.');
-        }
-        // Don't proceed to payment if there's an error message
-        if (cartStore.inventoryCheckErrorMessage) {
-            // stop the submit loading state
-            this.submitLoading = false;
-            return;
-        }
-        // Apply store credit if customer has selected an amount
-        const storeCreditAmount = storeCreditStoreGetEffectiveAmount();
-        if (storeCreditAmount > 0) {
-            const storeCreditResult = await storeCreditStoreApplyCredit();
-            if (!storeCreditResult.success) {
+            // reset paypal error message
+            paypalStore.paypalErrorMessage = null;
+            // reset error state
+            stripeStore.hasPaymentError = false;
+            this.submitLoading = true;
+            // reset inventory check message
+            cartStore.inventoryCheckErrorMessage = null;
+            // Attempt to change settlement currency to USD
+            const baseCurrencyUpdateSuccess = await stripeStoreUpdateCheckoutSessionBaseCurrency();
+            // Should not proceed to confirm payment if base currency update failed
+            if (!baseCurrencyUpdateSuccess) {
                 stripeStore.hasPaymentError = true;
-                stripeStore.customErrorMessage =
-                    storeCreditResult.error ||
-                        translate('Unable to apply store credit. Please try again.');
+                stripeStore.customErrorMessage = translate('Unable to complete payment in [currency]. Please try again or select a different currency. If the issue persists, contact our support team for assistance.', {
+                    currency: stripeStore.checkoutSettlementCurrency,
+                });
                 this.submitLoading = false;
                 return;
             }
-        }
-        // If store credit covers the full order, create order directly without payment
-        if (storeCreditStoreCoversFullAmount()) {
             try {
-                // Validate checkout session (landed cost ID, etc.) before creating order
-                const checkoutSessionStatus = await validateCheckoutSession();
-                if (!checkoutSessionStatus.valid) {
+                // check inventory before proceeding to payment
+                cartStore.inventoryCheckErrorMessage =
+                    await stripeStoreHandleInventoryCheck();
+            }
+            catch (_a) {
+                // If user provide callback and it throw an exception, default to this message and stop the payment.
+                cartStore.inventoryCheckErrorMessage = translate('Unable to check inventory. Please try again.');
+            }
+            // Don't proceed to payment if there's an error message
+            if (cartStore.inventoryCheckErrorMessage) {
+                // stop the submit loading state
+                this.submitLoading = false;
+                return;
+            }
+            // Apply store credit if customer has selected an amount
+            const storeCreditAmount = storeCreditStoreGetEffectiveAmount();
+            if (storeCreditAmount > 0) {
+                const storeCreditResult = await storeCreditStoreApplyCredit();
+                if (!storeCreditResult.success) {
                     stripeStore.hasPaymentError = true;
-                    stripeStore.customErrorMessage = checkoutSessionStatus.errorMessage;
+                    stripeStore.customErrorMessage =
+                        storeCreditResult.error ||
+                            translate('Unable to apply store credit. Please try again.');
                     this.submitLoading = false;
                     return;
                 }
-                const orderResult = await storeCreditStoreCreateOrder();
-                if (!orderResult.success) {
+            }
+            // If store credit covers the full order, create order directly without payment
+            if (storeCreditStoreCoversFullAmount()) {
+                try {
+                    // Validate checkout session (landed cost ID, etc.) before creating order
+                    const checkoutSessionStatus = await validateCheckoutSession();
+                    if (!checkoutSessionStatus.valid) {
+                        stripeStore.hasPaymentError = true;
+                        stripeStore.customErrorMessage = checkoutSessionStatus.errorMessage;
+                        this.submitLoading = false;
+                        return;
+                    }
+                    const orderResult = await storeCreditStoreCreateOrder();
+                    if (!orderResult.success) {
+                        stripeStore.hasPaymentError = true;
+                        stripeStore.customErrorMessage =
+                            orderResult.error ||
+                                translate('Unable to place order with store credit. Please try again.');
+                        this.submitLoading = false;
+                        return;
+                    }
+                    cartStoreNextStep();
+                    cartStoreClearCheckoutInterval();
+                }
+                catch (err) {
+                    logError(err);
+                    submitAnalytics({
+                        event: 'zonos-checkout-payment-fail',
+                        metadata: {
+                            checkoutSessionId: storageStore.checkoutSessionId,
+                        },
+                    });
                     stripeStore.hasPaymentError = true;
-                    stripeStore.customErrorMessage =
-                        orderResult.error ||
-                            translate('Unable to place order with store credit. Please try again.');
-                    this.submitLoading = false;
-                    return;
                 }
+                this.submitLoading = false;
+                return;
+            }
+            try {
+                await stripeStoreConfirmPayment();
                 cartStoreNextStep();
+                // clear the checkout session timeout timer when purchase is complete
                 cartStoreClearCheckoutInterval();
             }
             catch (err) {
@@ -1472,32 +1506,22 @@ export class ZonosCheckout {
                     },
                 });
                 stripeStore.hasPaymentError = true;
+                // should request inventory refund if there's an error during payment
+                if (stripeStore.shouldInventoryRefund) {
+                    void stripeStoreHandleInventoryRefund();
+                    stripeStore.shouldInventoryRefund = false;
+                }
             }
             this.submitLoading = false;
-            return;
         }
-        try {
-            await stripeStoreConfirmPayment();
-            cartStoreNextStep();
-            // clear the checkout session timeout timer when purchase is complete
-            cartStoreClearCheckoutInterval();
-        }
-        catch (err) {
-            logError(err);
-            submitAnalytics({
-                event: 'zonos-checkout-payment-fail',
-                metadata: {
-                    checkoutSessionId: storageStore.checkoutSessionId,
-                },
-            });
-            stripeStore.hasPaymentError = true;
-            // should request inventory refund if there's an error during payment
-            if (stripeStore.shouldInventoryRefund) {
-                void stripeStoreHandleInventoryRefund();
-                stripeStore.shouldInventoryRefund = false;
+        finally {
+            // Release the consent lock on every terminal exit (success or failure)
+            // so the buyer can re-toggle / retry. On success the cart advances and
+            // the close-handler reset would clean this up anyway.
+            if (consentWasRequired) {
+                policyConsentStore.locked = false;
             }
         }
-        this.submitLoading = false;
     }
     async handleFinishClick() {
         // reset stripe store
@@ -1509,6 +1533,8 @@ export class ZonosCheckout {
         }
         // reset cart store
         cartStoreReset();
+        // reset policy consent so the next checkout starts un-accepted
+        policyConsentStoreReset();
         // redirect to vendor store url if this is legacy checkout.
         if (window.Zonos.isLegacyCheckout && window.Zonos.cartData) {
             const storeBaseUrl = window.Zonos.cartData.storeBaseUrl ||
@@ -1710,6 +1736,8 @@ export class ZonosCheckout {
         stripeStoreReset();
         // reset cart store
         cartStoreReset();
+        // reset policy consent
+        policyConsentStoreReset();
         // cleanup onChange listener
         this.storeUnsubscribeList.forEach(unsubscribe => unsubscribe());
         window.removeEventListener('message', this.handleHostedOpenWindowCallback);

package/dist/collection/components/checkout/zonos-checkout/zonos-policy-consent/zonos-policy-consent.css

@@ -0,0 +1,93 @@
+:host {
+  font-family: var(--zonos--font-family, Inter), Inter;
+  display: block;
+  white-space: normal;
+}
+:host * {
+  font-family: var(--zonos--font-family, Inter), Inter;
+}
+:host img {
+  max-width: 100%;
+}
+:host dl,
+:host dd,
+:host h1,
+:host h2,
+:host h3,
+:host h4,
+:host h5,
+:host h6,
+:host hr,
+:host figure,
+:host p,
+:host pre {
+  margin: 0;
+}
+
+/* All sets of variable are here */
+/* smooth font rendering */
+:host {
+  -moz-osx-font-smoothing: grayscale;
+  -webkit-font-smoothing: antialiased;
+}
+
+:host {
+  display: block;
+  margin-top: 20px;
+}
+
+.zonos--policy-consent {
+  background-color: var(--zonos-elements-gray-50);
+  border: 1px solid var(--zonos-elements-gray-200);
+  border-radius: 8px;
+  padding: 12px 14px;
+  transition: border-color 0.15s ease, background-color 0.15s ease;
+}
+
+.zonos--policy-consent:hover {
+  border-color: var(--zonos-elements-gray-300);
+}
+
+.zonos--policy-consent--error {
+  background-color: var(--zonos-elements-red-50);
+  border-color: var(--zonos-elements-red-400);
+}
+
+.zonos--policy-consent-label {
+  align-items: center;
+  cursor: pointer;
+  display: flex;
+  gap: 10px;
+  user-select: none;
+}
+
+.zonos--policy-consent-checkbox {
+  accent-color: var(--zonos-elements-blue-600);
+  cursor: pointer;
+  flex-shrink: 0;
+  height: 18px;
+  margin: 0;
+  width: 18px;
+}
+
+.zonos--policy-consent-text {
+  color: var(--zonos-elements-gray-800);
+  font-size: 14px;
+  line-height: 1.45;
+}
+.zonos--policy-consent-text a {
+  color: var(--zonos-elements-blue-600);
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+.zonos--policy-consent-text a:hover {
+  color: var(--zonos-elements-blue-700);
+}
+
+.zonos--policy-consent-error {
+  color: var(--zonos-elements-red-600);
+  font-size: 13px;
+  line-height: 1.4;
+  margin-top: 8px;
+  padding: 0 4px;
+}

package/dist/collection/components/checkout/zonos-checkout/zonos-policy-consent/zonos-policy-consent.js

@@ -0,0 +1,93 @@
+import { Fragment, h, Host } from "@stencil/core";
+import { getEnabledPolicies, policyConsentStore, } from "../../../store/checkout/policyConsent";
+import { localizationStore } from "../../../store/hello/localization";
+import { translate } from "../../../store/translationStore";
+import { zonosStore } from "../../../store/zonosStore";
+const POLICIES_SENTINEL = 'POLICIES';
+export class ZonosPolicyConsent {
+    render() {
+        const policies = getEnabledPolicies();
+        if (!policies.length) {
+            return null;
+        }
+        // Build the locale-aware joined list ("X, Y, and Z" in English, equivalent in other locales).
+        const ListFormatCtor = Intl
+            .ListFormat;
+        const parts = ListFormatCtor
+            ? new ListFormatCtor(localizationStore.selectedLocale, {
+                style: 'long',
+                type: 'conjunction',
+            }).formatToParts(policies.map(p => p.name))
+            : // Fallback for environments without Intl.ListFormat: simple ", "-joined list.
+                policies.flatMap((p, idx) => idx === 0
+                    ? [{ type: 'element', value: p.name }]
+                    : [
+                        { type: 'literal', value: ', ' },
+                        { type: 'element', value: p.name },
+                    ]);
+        const listNodes = parts.map(part => {
+            if (part.type === 'literal') {
+                return part.value;
+            }
+            // 'element' part — match back to the policy by name to recover its URL.
+            const policy = policies.find(p => p.name === part.value);
+            if (!policy) {
+                return part.value;
+            }
+            return (h("a", { href: policy.url,
+                // Prevent the surrounding <label> from also activating the checkbox
+                // when the link is clicked — `stopPropagation` alone doesn't suppress
+                // the label's default behavior in every browser. We explicitly open
+                // the URL ourselves and call `preventDefault` to swallow the click.
+                onClick: (event) => {
+                    event.preventDefault();
+                    event.stopPropagation();
+                    window.open(policy.url, '_blank', 'noopener,noreferrer');
+                }, rel: "noopener noreferrer", target: "_blank" }, part.value));
+        });
+        // Use the merchant-name template when an org name is available, falling back to the generic
+        // phrasing otherwise so we never render a stray apostrophe (e.g. " 's Terms...").
+        // Reads from `zonosStore` so this works when consumed via the npm package
+        // (where `window.Zonos.cartSettings` may not be populated).
+        const merchantName = zonosStore.organizationName;
+        const template = merchantName
+            ? translate("I agree to [merchantName]'s [policies]", {
+                merchantName,
+                policies: POLICIES_SENTINEL,
+            })
+            : translate('I agree to the [policies]', {
+                policies: POLICIES_SENTINEL,
+            });
+        const [before = '', after = ''] = template.split(POLICIES_SENTINEL);
+        const showError = policyConsentStore.showError;
+        const errorId = 'zonos--policy-consent-error';
+        return (h(Host, { class: "zonos--policy-consent-host" }, h("div", { class: `zonos--policy-consent${showError ? ' zonos--policy-consent--error' : ''}` }, h("label", { class: "zonos--policy-consent-label" }, h("input", { "aria-describedby": showError ? errorId : undefined, "aria-invalid": showError ? 'true' : 'false', checked: policyConsentStore.accepted, class: "zonos--policy-consent-checkbox", disabled: policyConsentStore.locked, onChange: (event) => {
+                const isChecked = event.target.checked;
+                policyConsentStore.accepted = isChecked;
+                if (isChecked) {
+                    // Snapshot the timestamp at the moment of acceptance so later
+                    // session-metadata updates don't drift it forward.
+                    if (!policyConsentStore.acceptedAt) {
+                        policyConsentStore.acceptedAt = new Date().toISOString();
+                    }
+                    policyConsentStore.showError = false;
+                }
+                else {
+                    // If the buyer un-checks, the prior acceptance is no longer valid.
+                    policyConsentStore.acceptedAt = null;
+                }
+            }, type: "checkbox" }), h("span", { class: "zonos--policy-consent-text" }, before, h(Fragment, null, listNodes), after))), showError && (h("div", { class: "zonos--policy-consent-error", id: errorId, role: "alert" }, translate('You must accept the policies to place this order')))));
+    }
+    static get is() { return "zonos-policy-consent"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["zonos-policy-consent.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["zonos-policy-consent.css"]
+        };
+    }
+}

package/dist/collection/components/common/zonos-stripe-phone-input/zonos-stripe-phone-input.js

@@ -259,7 +259,7 @@ export class ZonosStripePhoneInput {
                 "mutable": false,
                 "complexType": {
                     "original": "GenericZonosSettings['countryFields'] | null",
-                    "resolved": "null | undefined | { CC: CountryFields; TO: CountryFields; AD: CountryFields; AE: CountryFields; AF: CountryFields; AG: CountryFields; AI: CountryFields; AL: CountryFields; AM: CountryFields; AO: CountryFields; AQ: CountryFields; AR: CountryFields; AS: CountryFields; AT: CountryFields; AU: CountryFields; AW: CountryFields; AX: CountryFields; AZ: CountryFields; BA: CountryFields; BB: CountryFields; BD: CountryFields; BE: CountryFields; BF: CountryFields; BG: CountryFields; BH: CountryFields; BI: CountryFields; BJ: CountryFields; BL: CountryFields; BM: CountryFields; BN: CountryFields; BO: CountryFields; BQ: CountryFields; BR: CountryFields; BS: CountryFields; BT: CountryFields; BV: CountryFields; BW: CountryFields; BY: CountryFields; BZ: CountryFields; CA: CountryFields; CD: CountryFields; CF: CountryFields; CG: CountryFields; CH: CountryFields; CI: CountryFields; CK: CountryFields; CL: CountryFields; CM: CountryFields; CN: CountryFields; CO: CountryFields; CR: CountryFields; CU: CountryFields; CV: CountryFields; CW: CountryFields; CX: CountryFields; CY: CountryFields; CZ: CountryFields; DE: CountryFields; DJ: CountryFields; DK: CountryFields; DM: CountryFields; DO: CountryFields; DZ: CountryFields; EC: CountryFields; EE: CountryFields; EG: CountryFields; EH: CountryFields; ER: CountryFields; ES: CountryFields; ET: CountryFields; FI: CountryFields; FJ: CountryFields; FK: CountryFields; FM: CountryFields; FO: CountryFields; FR: CountryFields; GA: CountryFields; GB: CountryFields; GD: CountryFields; GE: CountryFields; GF: CountryFields; GG: CountryFields; GH: CountryFields; GI: CountryFields; GL: CountryFields; GM: CountryFields; GN: CountryFields; GP: CountryFields; GQ: CountryFields; GR: CountryFields; GS: CountryFields; GT: CountryFields; GU: CountryFields; GW: CountryFields; GY: CountryFields; HK: CountryFields; HM: CountryFields; HN: CountryFields; HR: CountryFields; HT: CountryFields; HU: CountryFields; IC: CountryFields; ID: CountryFields; IE: CountryFields; IL: CountryFields; IM: CountryFields; IN: CountryFields; IO: CountryFields; IQ: CountryFields; IR: CountryFields; IS: CountryFields; IT: CountryFields; JE: CountryFields; JM: CountryFields; JO: CountryFields; JP: CountryFields; KE: CountryFields; KG: CountryFields; KH: CountryFields; KI: CountryFields; KM: CountryFields; KN: CountryFields; KP: CountryFields; KR: CountryFields; KW: CountryFields; KY: CountryFields; KZ: CountryFields; LA: CountryFields; LB: CountryFields; LC: CountryFields; LI: CountryFields; LK: CountryFields; LR: CountryFields; LS: CountryFields; LT: CountryFields; LU: CountryFields; LV: CountryFields; LY: CountryFields; MA: CountryFields; MC: CountryFields; MD: CountryFields; ME: CountryFields; MF: CountryFields; MG: CountryFields; MH: CountryFields; MK: CountryFields; ML: CountryFields; MM: CountryFields; MN: CountryFields; MO: CountryFields; MP: CountryFields; MQ: CountryFields; MR: CountryFields; MS: CountryFields; MT: CountryFields; MU: CountryFields; MV: CountryFields; MW: CountryFields; MX: CountryFields; MY: CountryFields; MZ: CountryFields; NA: CountryFields; NC: CountryFields; NE: CountryFields; NF: CountryFields; NG: CountryFields; NI: CountryFields; NL: CountryFields; NO: CountryFields; NP: CountryFields; NR: CountryFields; NU: CountryFields; NZ: CountryFields; OM: CountryFields; PA: CountryFields; PE: CountryFields; PF: CountryFields; PG: CountryFields; PH: CountryFields; PK: CountryFields; PL: CountryFields; PM: CountryFields; PN: CountryFields; PR: CountryFields; PS: CountryFields; PT: CountryFields; PW: CountryFields; PY: CountryFields; QA: CountryFields; RE: CountryFields; RO: CountryFields; RS: CountryFields; RU: CountryFields; RW: CountryFields; SA: CountryFields; SB: CountryFields; SC: CountryFields; SD: CountryFields; SE: CountryFields; SG: CountryFields; SH: CountryFields; SI: CountryFields; SJ: CountryFields; SK: CountryFields; SL: CountryFields; SM: CountryFields; SN: CountryFields; SO: CountryFields; SR: CountryFields; SS: CountryFields; ST: CountryFields; SV: CountryFields; SX: CountryFields; SY: CountryFields; SZ: CountryFields; TC: CountryFields; TD: CountryFields; TF: CountryFields; TG: CountryFields; TH: CountryFields; TJ: CountryFields; TK: CountryFields; TL: CountryFields; TM: CountryFields; TN: CountryFields; TR: CountryFields; TT: CountryFields; TV: CountryFields; TW: CountryFields; TZ: CountryFields; UA: CountryFields; UG: CountryFields; UM: CountryFields; US: CountryFields; UY: CountryFields; UZ: CountryFields; VA: CountryFields; VC: CountryFields; VE: CountryFields; VG: CountryFields; VI: CountryFields; VN: CountryFields; VU: CountryFields; WF: CountryFields; WS: CountryFields; YE: CountryFields; YT: CountryFields; ZA: CountryFields; ZM: CountryFields; ZW: CountryFields; }",
+                    "resolved": "null | undefined | { AQ: CountryFields; AX: CountryFields; CC: CountryFields; ER: CountryFields; PF: CountryFields; SO: CountryFields; SX: CountryFields; TO: CountryFields; AD: CountryFields; AE: CountryFields; AF: CountryFields; AG: CountryFields; AI: CountryFields; AL: CountryFields; AM: CountryFields; AO: CountryFields; AR: CountryFields; AS: CountryFields; AT: CountryFields; AU: CountryFields; AW: CountryFields; AZ: CountryFields; BA: CountryFields; BB: CountryFields; BD: CountryFields; BE: CountryFields; BF: CountryFields; BG: CountryFields; BH: CountryFields; BI: CountryFields; BJ: CountryFields; BL: CountryFields; BM: CountryFields; BN: CountryFields; BO: CountryFields; BQ: CountryFields; BR: CountryFields; BS: CountryFields; BT: CountryFields; BV: CountryFields; BW: CountryFields; BY: CountryFields; BZ: CountryFields; CA: CountryFields; CD: CountryFields; CF: CountryFields; CG: CountryFields; CH: CountryFields; CI: CountryFields; CK: CountryFields; CL: CountryFields; CM: CountryFields; CN: CountryFields; CO: CountryFields; CR: CountryFields; CU: CountryFields; CV: CountryFields; CW: CountryFields; CX: CountryFields; CY: CountryFields; CZ: CountryFields; DE: CountryFields; DJ: CountryFields; DK: CountryFields; DM: CountryFields; DO: CountryFields; DZ: CountryFields; EC: CountryFields; EE: CountryFields; EG: CountryFields; EH: CountryFields; ES: CountryFields; ET: CountryFields; FI: CountryFields; FJ: CountryFields; FK: CountryFields; FM: CountryFields; FO: CountryFields; FR: CountryFields; GA: CountryFields; GB: CountryFields; GD: CountryFields; GE: CountryFields; GF: CountryFields; GG: CountryFields; GH: CountryFields; GI: CountryFields; GL: CountryFields; GM: CountryFields; GN: CountryFields; GP: CountryFields; GQ: CountryFields; GR: CountryFields; GS: CountryFields; GT: CountryFields; GU: CountryFields; GW: CountryFields; GY: CountryFields; HK: CountryFields; HM: CountryFields; HN: CountryFields; HR: CountryFields; HT: CountryFields; HU: CountryFields; IC: CountryFields; ID: CountryFields; IE: CountryFields; IL: CountryFields; IM: CountryFields; IN: CountryFields; IO: CountryFields; IQ: CountryFields; IR: CountryFields; IS: CountryFields; IT: CountryFields; JE: CountryFields; JM: CountryFields; JO: CountryFields; JP: CountryFields; KE: CountryFields; KG: CountryFields; KH: CountryFields; KI: CountryFields; KM: CountryFields; KN: CountryFields; KP: CountryFields; KR: CountryFields; KW: CountryFields; KY: CountryFields; KZ: CountryFields; LA: CountryFields; LB: CountryFields; LC: CountryFields; LI: CountryFields; LK: CountryFields; LR: CountryFields; LS: CountryFields; LT: CountryFields; LU: CountryFields; LV: CountryFields; LY: CountryFields; MA: CountryFields; MC: CountryFields; MD: CountryFields; ME: CountryFields; MF: CountryFields; MG: CountryFields; MH: CountryFields; MK: CountryFields; ML: CountryFields; MM: CountryFields; MN: CountryFields; MO: CountryFields; MP: CountryFields; MQ: CountryFields; MR: CountryFields; MS: CountryFields; MT: CountryFields; MU: CountryFields; MV: CountryFields; MW: CountryFields; MX: CountryFields; MY: CountryFields; MZ: CountryFields; NA: CountryFields; NC: CountryFields; NE: CountryFields; NF: CountryFields; NG: CountryFields; NI: CountryFields; NL: CountryFields; NO: CountryFields; NP: CountryFields; NR: CountryFields; NU: CountryFields; NZ: CountryFields; OM: CountryFields; PA: CountryFields; PE: CountryFields; PG: CountryFields; PH: CountryFields; PK: CountryFields; PL: CountryFields; PM: CountryFields; PN: CountryFields; PR: CountryFields; PS: CountryFields; PT: CountryFields; PW: CountryFields; PY: CountryFields; QA: CountryFields; RE: CountryFields; RO: CountryFields; RS: CountryFields; RU: CountryFields; RW: CountryFields; SA: CountryFields; SB: CountryFields; SC: CountryFields; SD: CountryFields; SE: CountryFields; SG: CountryFields; SH: CountryFields; SI: CountryFields; SJ: CountryFields; SK: CountryFields; SL: CountryFields; SM: CountryFields; SN: CountryFields; SR: CountryFields; SS: CountryFields; ST: CountryFields; SV: CountryFields; SY: CountryFields; SZ: CountryFields; TC: CountryFields; TD: CountryFields; TF: CountryFields; TG: CountryFields; TH: CountryFields; TJ: CountryFields; TK: CountryFields; TL: CountryFields; TM: CountryFields; TN: CountryFields; TR: CountryFields; TT: CountryFields; TV: CountryFields; TW: CountryFields; TZ: CountryFields; UA: CountryFields; UG: CountryFields; UM: CountryFields; US: CountryFields; UY: CountryFields; UZ: CountryFields; VA: CountryFields; VC: CountryFields; VE: CountryFields; VG: CountryFields; VI: CountryFields; VN: CountryFields; VU: CountryFields; WF: CountryFields; WS: CountryFields; YE: CountryFields; YT: CountryFields; ZA: CountryFields; ZM: CountryFields; ZW: CountryFields; }",
                     "references": {
                         "GenericZonosSettings": {
                             "location": "import",

package/dist/collection/components/main/zonos-controller.js

@@ -7,6 +7,7 @@ import { getZonosSettings } from "../utils/api/getZonosSettings";
 import { initCheckout } from "../utils/checkout/initCheckout";
 import { initCollect } from "../utils/checkout/initCollect";
 import { initInvoice } from "../utils/checkout/initInvoice";
+import { injectDomesticElementHideStyle } from "../utils/checkout/injectDomesticElementHideStyle";
 import { handleFetch } from "../utils/handleFetch";
 import { initHello } from "../utils/hello/initHello";
 import { CheckoutAddressService } from "../utils/iframe/CheckoutAddressService";
@@ -234,6 +235,9 @@ export class ZonosController {
                 zonosSettings: json,
             });
             zonosStore.zonosMode = zonosMode;
+            // Inject the merchant's domestic-element hide style now that
+            // checkoutSettings have been merged into the store.
+            injectDomesticElementHideStyle(zonosStore.checkoutSettings.domesticElementSelector);
             // setup google font after store loaded
             void this.setupGoogleFont();
             if (zonosStore.helloSettings.visibilityStatus === 'DISABLED') {
@@ -331,7 +335,7 @@ export class ZonosController {
         zonosStore.organizationName = organizationName;
     }
     render() {
-        return h(Host, { key: '681a81baa59bfe91e9fe0927aee49fa720fcb35b', class: "zonos--elements" });
+        return h(Host, { key: 'fe1f262a2bfbf4f6f39c0f23783c132bde8d2dd7', class: "zonos--elements" });
     }
     static get is() { return "zonos-controller"; }
     static get encapsulation() { return "shadow"; }
@@ -602,7 +606,7 @@ export class ZonosController {
                     "signature": "(countryCode: CountryCode) => Promise<void>",
                     "parameters": [{
                             "name": "countryCode",
-                            "type": "\"CC\" | \"TO\" | \"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AQ\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AX\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BH\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CD\" | \"CF\" | \"CG\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CM\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EG\" | \"EH\" | \"ER\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"IC\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KG\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LB\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"ML\" | \"MM\" | \"MN\" | \"MO\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NO\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PF\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PN\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SO\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SX\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\"",
+                            "type": "\"AQ\" | \"AX\" | \"CC\" | \"ER\" | \"PF\" | \"SO\" | \"SX\" | \"TO\" | \"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BH\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CD\" | \"CF\" | \"CG\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CM\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EG\" | \"EH\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"IC\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KG\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LB\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"ML\" | \"MM\" | \"MN\" | \"MO\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NO\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PN\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\"",
                             "docs": ""
                         }],
                     "references": {