@economist/web-apple-pay 1.9.4 → 1.9.5

package/dist/index.js

@@ -1304,11 +1304,11 @@ var redirectToCheckoutFallback = (params) => {
 };
 
 // src/constants.ts
-var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
-  ApplePayEntryPoint3["PAYWALL"] = "article_paywall";
-  ApplePayEntryPoint3["REGWALL"] = "article_regwall";
-  ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  return ApplePayEntryPoint3;
+var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
+  ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
+  ApplePayEntryPoint2["REGWALL"] = "article_regwall";
+  ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
 var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
@@ -2003,6 +2003,10 @@ var getExperimentKeyFromNextData = (flagKey) => {
   return typeof experimentKey === "string" ? experimentKey : void 0;
 };
 
+// src/utils/applePayExpressEligibility.ts
+var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
+var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -2034,6 +2038,12 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    * `window.experimentIntegration`. Once all consumers are migrated, the URL param
    * fallback will be removed.
    *
+   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
+   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
+   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
+   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
+   * the dual-offer banner is only mounted for anonymous visitors.
+   *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
    * @param entryPoint - Where the button is being rendered (e.g. paywall, banner).
@@ -2045,19 +2055,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (APPLE_PAY_EXCLUDED_VARIANTS.includes(offer.product?.variant)) {
       return null;
     }
+    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
+      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
+    );
+    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
+    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+      return null;
+    }
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
-    if (experimentValue) {
-      trackApplePayExperimentExposure(
-        experimentValue,
-        getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-      );
+    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+      void isApplePayAvailable().then((available) => {
+        if (available) {
+          trackApplePayExperimentExposure(
+            experimentValue,
+            getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
+          );
+        }
+      });
     }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
-      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
-    );
     if (!isTreatment && !hasUrlParamFlag) {
       return null;
     }

package/dist/src/apple-pay-button.d.ts

@@ -20,6 +20,12 @@ export declare class ApplePayButton extends HTMLElement {
      * `window.experimentIntegration`. Once all consumers are migrated, the URL param
      * fallback will be removed.
      *
+     * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
+     * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
+     * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
+     * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
+     * the dual-offer banner is only mounted for anonymous visitors.
+     *
      * @param offer - The offer to display in the Apple Pay flow.
      * @param country - The user's country code.
      * @param entryPoint - Where the button is being rendered (e.g. paywall, banner).

package/dist/src/apple-pay-button.js

@@ -1992,6 +1992,10 @@ var getExperimentKeyFromNextData = (flagKey) => {
   return typeof experimentKey === "string" ? experimentKey : void 0;
 };
 
+// src/utils/applePayExpressEligibility.ts
+var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
+var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -2023,6 +2027,12 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    * `window.experimentIntegration`. Once all consumers are migrated, the URL param
    * fallback will be removed.
    *
+   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
+   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
+   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
+   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
+   * the dual-offer banner is only mounted for anonymous visitors.
+   *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
    * @param entryPoint - Where the button is being rendered (e.g. paywall, banner).
@@ -2034,19 +2044,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (APPLE_PAY_EXCLUDED_VARIANTS.includes(offer.product?.variant)) {
       return null;
     }
+    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
+      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
+    );
+    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
+    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+      return null;
+    }
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
-    if (experimentValue) {
-      trackApplePayExperimentExposure(
-        experimentValue,
-        getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-      );
+    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+      void isApplePayAvailable().then((available) => {
+        if (available) {
+          trackApplePayExperimentExposure(
+            experimentValue,
+            getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
+          );
+        }
+      });
     }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
-      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
-    );
     if (!isTreatment && !hasUrlParamFlag) {
       return null;
     }

package/dist/src/apple-pay-button.stories.js

@@ -2000,6 +2000,10 @@ var getExperimentKeyFromNextData = (flagKey) => {
   return typeof experimentKey === "string" ? experimentKey : void 0;
 };
 
+// src/utils/applePayExpressEligibility.ts
+var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
+var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -2031,6 +2035,12 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    * `window.experimentIntegration`. Once all consumers are migrated, the URL param
    * fallback will be removed.
    *
+   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
+   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
+   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
+   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
+   * the dual-offer banner is only mounted for anonymous visitors.
+   *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
    * @param entryPoint - Where the button is being rendered (e.g. paywall, banner).
@@ -2042,19 +2052,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (APPLE_PAY_EXCLUDED_VARIANTS.includes(offer.product?.variant)) {
       return null;
     }
+    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
+      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
+    );
+    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
+    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+      return null;
+    }
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
-    if (experimentValue) {
-      trackApplePayExperimentExposure(
-        experimentValue,
-        getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-      );
+    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+      void isApplePayAvailable().then((available) => {
+        if (available) {
+          trackApplePayExperimentExposure(
+            experimentValue,
+            getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
+          );
+        }
+      });
     }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
-      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
-    );
     if (!isTreatment && !hasUrlParamFlag) {
       return null;
     }

package/dist/src/apple-pay-modal.stories.js

@@ -1992,6 +1992,10 @@ var getExperimentKeyFromNextData = (flagKey) => {
   return typeof experimentKey === "string" ? experimentKey : void 0;
 };
 
+// src/utils/applePayExpressEligibility.ts
+var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
+var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -2023,6 +2027,12 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    * `window.experimentIntegration`. Once all consumers are migrated, the URL param
    * fallback will be removed.
    *
+   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
+   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
+   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
+   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
+   * the dual-offer banner is only mounted for anonymous visitors.
+   *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
    * @param entryPoint - Where the button is being rendered (e.g. paywall, banner).
@@ -2034,19 +2044,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (APPLE_PAY_EXCLUDED_VARIANTS.includes(offer.product?.variant)) {
       return null;
     }
+    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
+      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
+    );
+    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
+    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+      return null;
+    }
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
-    if (experimentValue) {
-      trackApplePayExperimentExposure(
-        experimentValue,
-        getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-      );
+    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+      void isApplePayAvailable().then((available) => {
+        if (available) {
+          trackApplePayExperimentExposure(
+            experimentValue,
+            getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
+          );
+        }
+      });
     }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
-      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
-    );
     if (!isTreatment && !hasUrlParamFlag) {
       return null;
     }

package/dist/src/index.js

@@ -1304,11 +1304,11 @@ var redirectToCheckoutFallback = (params) => {
 };
 
 // src/constants.ts
-var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
-  ApplePayEntryPoint3["PAYWALL"] = "article_paywall";
-  ApplePayEntryPoint3["REGWALL"] = "article_regwall";
-  ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  return ApplePayEntryPoint3;
+var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
+  ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
+  ApplePayEntryPoint2["REGWALL"] = "article_regwall";
+  ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
 var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
@@ -2003,6 +2003,10 @@ var getExperimentKeyFromNextData = (flagKey) => {
   return typeof experimentKey === "string" ? experimentKey : void 0;
 };
 
+// src/utils/applePayExpressEligibility.ts
+var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
+var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -2034,6 +2038,12 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    * `window.experimentIntegration`. Once all consumers are migrated, the URL param
    * fallback will be removed.
    *
+   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
+   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
+   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
+   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
+   * the dual-offer banner is only mounted for anonymous visitors.
+   *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
    * @param entryPoint - Where the button is being rendered (e.g. paywall, banner).
@@ -2045,19 +2055,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (APPLE_PAY_EXCLUDED_VARIANTS.includes(offer.product?.variant)) {
       return null;
     }
+    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
+      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
+    );
+    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
+    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+      return null;
+    }
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
-    if (experimentValue) {
-      trackApplePayExperimentExposure(
-        experimentValue,
-        getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-      );
+    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+      void isApplePayAvailable().then((available) => {
+        if (available) {
+          trackApplePayExperimentExposure(
+            experimentValue,
+            getExperimentKeyFromNextData(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
+          );
+        }
+      });
     }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
-      FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
-    );
     if (!isTreatment && !hasUrlParamFlag) {
       return null;
     }

package/dist/src/utils/applePayExpressEligibility.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host-side eligibility for Apple Pay Express Feature Experiment (SMA-3301).
+ *
+ * Gates createIfEnabled before getVariant / $exposure so only the intended
+ * population (homepage + Safari/iPhone) participates. Anonymous is assumed
+ * because the dual-offer banner is only mounted for anonymous visitors.
+ * Exposure is further gated on isApplePayAvailable() (BYPASS_APPLE_PAY_CHECKS
+ * respected). Amplitude audience targeting uses generic user_properties from
+ * Engagement.
+ */
+export declare const isApplePayExpressHomepage: (pathname?: string) => boolean;
+/**
+ * True when the visitor may enter the Apple Pay Express experiment path
+ * (assignment read + $exposure + optional treatment button).
+ */
+export declare const isEligibleForApplePayExpressExperiment: () => boolean;

package/dist/src/utils/applePayExpressEligibility.js

@@ -0,0 +1,14 @@
+// src/clients/payment-checkout/detects.ts
+var isAppleDeviceOrSafari = () => {
+  const isIOSOrMacTouchDevice = /iPad|iPhone|iPod/.test(navigator.userAgent) || navigator.maxTouchPoints > 1 && /Macintosh/.test(navigator.userAgent);
+  const isSafariBrowser = navigator.userAgent.indexOf("Safari") > -1 && navigator.userAgent.indexOf("Chrome") === -1;
+  return isIOSOrMacTouchDevice || isSafariBrowser;
+};
+
+// src/utils/applePayExpressEligibility.ts
+var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
+var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+export {
+  isApplePayExpressHomepage,
+  isEligibleForApplePayExpressExperiment
+};

package/dist/src/utils/expressCheckoutTracking.d.ts

@@ -50,10 +50,10 @@ export type ImpressionMetadata = {
 /**
  * Amplitude Experiment exposure for Apple Pay Express (SMA-3301).
  *
- * Fired when createIfEnabled evaluates an assigned variant (control or
- * treatment). Deduped per pathname + variant so repeated banner renders on
- * the same page do not over-count. Includes experiment_key from Engagement
- * SSR (__NEXT_DATA__) when present for Feature Experiment run attribution.
+ * Fired from createIfEnabled only after isApplePayAvailable() succeeds
+ * (control or treatment). Deduped per pathname + variant so repeated banner
+ * renders on the same page do not over-count. Includes experiment_key from
+ * Engagement SSR (__NEXT_DATA__) when present for run attribution.
  */
 export declare const trackApplePayExperimentExposure: (variant: string, experimentKey?: string) => void;
 /** Wallet button displayed — emits all 5 required analytics dimensions. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@economist/web-apple-pay",
   "description": "Web component package for Apple Pay checkout UI",
-  "version": "1.9.4",
+  "version": "1.9.5",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",