@economist/web-apple-pay 0.1.1-beta.0

package/dist/src/clients/payment-checkout/messages.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Canonical user-facing error messages for the Apple Pay Express Checkout flow.
+ *
+ * All copy here is verified against sma-checkout (src/actions/constants/index.ts
+ * and handlers/create-on-payment-authorized-handler/) to ensure parity with the
+ * reference implementation. Update both repos if copy changes.
+ */
+/** Shown when a required Apple Pay contact field is absent. */
+export declare const MSG_MISSING_REQUIRED_FIELD = "Missing required field";
+/** Shown when the email address format is invalid (matches sma-checkout FormErrorMessages.EMAIL_WRONG_FORMAT). */
+export declare const MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
+/** Shown when the email address exceeds 80 characters (matches sma-checkout FormErrorMessages.MAX_80_CHARS). */
+export declare const MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
+/** Shown when the billing country is not in the supported list for the offer. */
+export declare const MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+/**
+ * Generic fallback error shown to the user when merchant validation or the
+ * purchase call fails. Redirected as an inlineError on the checkout fallback page.
+ * Matches sma-checkout GENERIC_ERROR_MSG pattern.
+ */
+export declare const MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
+/**
+ * Shown when a reCAPTCHA security check fails.
+ * Matches sma-checkout reference: handlers/create-on-payment-authorized-handler/subscribe.
+ */
+export declare const MSG_RECAPTCHA_VALIDATION_FAILED = "Security check failed. Please try again.";
+/**
+ * Shown when the BFF returns an EMAIL_COLLISION error (account already exists).
+ * Matches sma-checkout L103-104.
+ */
+export declare const MSG_EMAIL_COLLISION = "This email address is already linked to an account. Please log in, or try a different email address.";
+/** Internal ContactValidationError message — not shown to the user directly. */
+export declare const MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";

package/dist/src/clients/payment-checkout/messages.js

@@ -0,0 +1,19 @@
+// src/clients/payment-checkout/messages.ts
+var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
+var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
+var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
+var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
+var MSG_RECAPTCHA_VALIDATION_FAILED = "Security check failed. Please try again.";
+var MSG_EMAIL_COLLISION = "This email address is already linked to an account. Please log in, or try a different email address.";
+var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
+export {
+  MSG_CONTACT_VALIDATION_INTERNAL,
+  MSG_EMAIL_COLLISION,
+  MSG_EMAIL_TOO_LONG,
+  MSG_EMAIL_WRONG_FORMAT,
+  MSG_MISSING_REQUIRED_FIELD,
+  MSG_PAYMENT_GENERIC_ERROR,
+  MSG_RECAPTCHA_VALIDATION_FAILED,
+  MSG_UNSUPPORTED_BILLING_COUNTRY
+};

package/dist/src/clients/payment-checkout/payment-handler.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Central onpaymentauthorized orchestrator.
+ *
+ * The BFF /v1/wallet/purchase orchestrates ALL backend logic:
+ *   - Eligibility check
+ *   - Passwordless user registration (if anonymous)
+ *   - Basket creation
+ *   - Payment finalization
+ *
+ * This handler is responsible for:
+ *   1. Local billing/shipping contact validation (keeps Apple Pay sheet open on error)
+ *   2. Calling the single /v1/wallet/purchase endpoint
+ *   3. Handling success → redirect to /checkout/complete
+ *   4. Handling structured BFF errors → deterministic UI actions per errorType
+ */
+import type { SessionResponse } from './types';
+export type PaymentHandlerConfig = {
+    skuId: string;
+    country: string;
+    returnUrl: string;
+    /**
+     * Optional `&country=` query param captured from the page URL at the moment
+     * the payment sheet was authorised (via `buildQueryString()`).
+     * Appended verbatim to the checkout-complete and fallback redirect URLs so
+     * the country context is preserved across the redirect.
+     * e.g. `'&country=US'`, `'&country=GB%2FIE'`, or `''` when absent.
+     */
+    queryString?: string;
+    supportedBillingCountries: string[];
+    recaptchaTokens: {
+        checkEligibility: string;
+        newBasket: string;
+        registerUser: string;
+    };
+};
+export declare function handlePaymentAuthorized(event: ApplePayJS.ApplePayPaymentAuthorizedEvent, session: ApplePaySession, sessionData: SessionResponse, config: PaymentHandlerConfig): Promise<void>;

package/dist/src/clients/payment-checkout/payment-handler.js

@@ -0,0 +1,389 @@
+// src/clients/payment-checkout/config.ts
+var runtimeConfig = null;
+var getApplePayConfig = () => runtimeConfig;
+
+// src/clients/payment-checkout/types.ts
+var ApiError = class extends Error {
+  status;
+  body;
+  constructor(status, body) {
+    super(`API request failed with status ${status}`);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+
+// src/clients/payment-checkout/index.ts
+var getWalletApiBaseUrl = () => {
+  const config = getApplePayConfig();
+  if (!config?.walletApiBaseUrl) {
+    throw new Error(
+      "[web-apple-pay] Missing walletApiBaseUrl. Call configureApplePay({ merchantId, walletApiBaseUrl, ... }) before making wallet API requests."
+    );
+  }
+  return config.walletApiBaseUrl;
+};
+var apiFetch = async (path, options = {}) => {
+  const baseUrl = getWalletApiBaseUrl();
+  const method = (options.method ?? "GET").toUpperCase();
+  const hasBody = options.body !== void 0 && options.body !== null;
+  const headers = new Headers(options.headers);
+  if (!headers.has("Accept")) {
+    headers.set("Accept", "application/json");
+  }
+  if (!headers.has("Content-Type")) {
+    if (hasBody || method !== "GET" && method !== "HEAD") {
+      headers.set("Content-Type", "application/json");
+    }
+  }
+  const response = await fetch(`${baseUrl}${path}`, {
+    ...options,
+    headers
+  });
+  if (!response.ok) {
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      const errorBody = await response.json();
+      throw new ApiError(response.status, errorBody);
+    }
+    const errorText = await response.text();
+    throw new Error(
+      `API request failed: ${response.status} ${response.statusText} - ${errorText}`
+    );
+  }
+  return response.json();
+};
+var performPurchase = (data) => {
+  return apiFetch("/v1/wallet/purchase", {
+    method: "POST",
+    body: JSON.stringify(data),
+    credentials: "include"
+  });
+};
+
+// src/utils/expressCheckoutTracking.ts
+var EXPRESS_CHECKOUT_EVENTS = {
+  /** Wallet button displayed */
+  IMPRESSION: "express_wallet_impression",
+  /** Wallet button clicked */
+  BUTTON_CLICK: "express_wallet_click",
+  /** Apple Pay sheet opened */
+  SHEET_OPEN: "wallet_payment_sheet_open",
+  /** Payment authorised by the user in the Apple Pay sheet */
+  AUTHORISED: "wallet_payment_authorised",
+  /** Purchase completed — BFF returned success */
+  SUCCESS: "wallet_payment_success",
+  /** Payment failed — BFF returned error */
+  FAILURE: "wallet_payment_failure",
+  /** Redirect to standard checkout (any fallback path) */
+  FALLBACK_CHECKOUT: "fallback_checkout"
+};
+var emitTedlEvent = (event) => {
+  window.tedl = window.tedl ?? {};
+  window.tedl.events = window.tedl.events ?? [];
+  window.tedl.events.push(event);
+};
+var track = (action, extra) => {
+  emitTedlEvent({
+    name: "user.journey",
+    type: "checkout",
+    action,
+    info: "applepay",
+    ...extra
+  });
+};
+var trackWalletPaymentSuccess = (skuId, basketId) => {
+  track(EXPRESS_CHECKOUT_EVENTS.SUCCESS, {
+    sku_id: skuId,
+    basket_id: basketId
+  });
+};
+var trackWalletPaymentFailure = (skuId, reason) => {
+  track(EXPRESS_CHECKOUT_EVENTS.FAILURE, {
+    sku_id: skuId,
+    failure_reason: reason
+  });
+};
+var trackFallbackCheckout = (skuId) => {
+  track(EXPRESS_CHECKOUT_EVENTS.FALLBACK_CHECKOUT, { sku_id: skuId });
+};
+var trackValidationFieldError = (field, errorType) => {
+  track(`validation_${field}_${errorType}`, {});
+};
+
+// src/clients/payment-checkout/messages.ts
+var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
+var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
+var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
+var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
+var MSG_RECAPTCHA_VALIDATION_FAILED = "Security check failed. Please try again.";
+var MSG_EMAIL_COLLISION = "This email address is already linked to an account. Please log in, or try a different email address.";
+var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
+
+// src/clients/payment-checkout/contact-validation.ts
+var pushFieldError = (errors, billingOrShippingContact = "billing", field, errorType, errorText) => {
+  const errorCode = billingOrShippingContact === "billing" ? "billingContactInvalid" : "shippingContactInvalid";
+  errors.push(new ApplePayError(errorCode, field, errorText));
+  trackValidationFieldError(field, errorType);
+  return "";
+};
+var pushRequiredFieldError = (errors, billingOrShippingContact = "billing", field) => {
+  return pushFieldError(
+    errors,
+    billingOrShippingContact,
+    field,
+    "required",
+    MSG_MISSING_REQUIRED_FIELD
+  );
+};
+var ContactValidationError = class extends Error {
+  constructor(errors) {
+    super(MSG_CONTACT_VALIDATION_INTERNAL);
+    this.errors = errors;
+  }
+};
+
+// src/clients/payment-checkout/billing-contact-details.ts
+var countriesWithoutCityField = ["KY", "CK", "NR", "TC"];
+var countriesRequiringAllFields = ["US", "CA", "GB"];
+var resolveCountryConfig = (country) => {
+  const hasCityField = !countriesWithoutCityField.includes(country);
+  const requiresStateAndPostcode = countriesRequiringAllFields.includes(country);
+  return {
+    hasCityField,
+    requiresStateAndPostcode,
+    // if there is no city field, we require state and use it in place of city
+    requiresStateField: !hasCityField || requiresStateAndPostcode
+  };
+};
+var validateAddressFields = (errors, contact, { hasCityField, requiresStateAndPostcode, requiresStateField }) => {
+  const locality = !hasCityField ? contact.administrativeArea : contact.locality;
+  if (!contact.addressLines?.at(0)?.trim()) {
+    pushRequiredFieldError(errors, "billing", "addressLines");
+  }
+  if (!locality?.trim() && hasCityField) {
+    pushRequiredFieldError(errors, "billing", "locality");
+  }
+  if (!contact.administrativeArea?.trim() && requiresStateField) {
+    pushRequiredFieldError(errors, "billing", "administrativeArea");
+  }
+  if (!contact.postalCode?.trim() && requiresStateAndPostcode) {
+    pushRequiredFieldError(errors, "billing", "postalCode");
+  }
+};
+var validateNameFields = (errors, contact) => {
+  const firstName = contact.givenName?.trim() || "";
+  const lastName = contact.familyName?.trim() || "";
+  if (!firstName || !lastName) {
+    pushRequiredFieldError(errors, "billing", "name");
+  }
+  return { firstName, lastName };
+};
+var validateCountrySupport = (errors, country, supportedBillingCountries) => {
+  if (!supportedBillingCountries.includes(country)) {
+    pushFieldError(
+      errors,
+      "billing",
+      "countryCode",
+      "not-supported",
+      MSG_UNSUPPORTED_BILLING_COUNTRY
+    );
+  }
+};
+var billingContactDetails = (contact, supportedBillingCountries) => {
+  const errors = [];
+  const country = contact.countryCode?.toUpperCase() || pushRequiredFieldError(errors, "billing", "country");
+  const config = resolveCountryConfig(country);
+  validateAddressFields(errors, contact, config);
+  const { firstName, lastName } = validateNameFields(errors, contact);
+  validateCountrySupport(errors, country, supportedBillingCountries);
+  if (errors.length > 0) {
+    throw new ContactValidationError(errors);
+  }
+  return { firstName, lastName };
+};
+
+// src/clients/payment-checkout/shipping-contact-details.ts
+var EMAIL_FORMAT_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var shippingContactDetails = (shippingContact) => {
+  const errors = [];
+  let emailAddress = "";
+  if (shippingContact?.emailAddress === void 0 || shippingContact?.emailAddress === "") {
+    pushRequiredFieldError(errors, "shipping", "emailAddress");
+  } else {
+    emailAddress = shippingContact.emailAddress.trim();
+    if (emailAddress.length > 80) {
+      pushFieldError(
+        errors,
+        "shipping",
+        "emailAddress",
+        "format",
+        MSG_EMAIL_TOO_LONG
+      );
+    } else if (!EMAIL_FORMAT_REGEX.test(emailAddress)) {
+      pushFieldError(
+        errors,
+        "shipping",
+        "emailAddress",
+        "format",
+        MSG_EMAIL_WRONG_FORMAT
+      );
+    }
+  }
+  if (errors.length > 0) {
+    throw new ContactValidationError(errors);
+  }
+  return { emailAddress };
+};
+
+// src/utils/expressCheckoutRedirect.ts
+var decodeSku = (sku) => {
+  try {
+    return atob(sku.substring(sku.indexOf("-") + 1));
+  } catch {
+    return sku;
+  }
+};
+var redirectToCheckoutComplete = (params) => {
+  const url = new URL("/checkout/complete", window.location.origin);
+  url.searchParams.set("basketId", params.basketId);
+  if (params.queryString) {
+    const qs = params.queryString.startsWith("?") ? params.queryString.slice(1) : params.queryString;
+    new URLSearchParams(qs).forEach((v, k) => url.searchParams.set(k, v));
+  }
+  url.searchParams.set("lmo_offer", params.skuId);
+  url.searchParams.set("status", params.status);
+  url.searchParams.set("redirectToCheckout", "true");
+  url.searchParams.set("returnUrl", params.returnUrl);
+  return url.pathname + url.search;
+};
+var redirectToCheckoutFallback = (params) => {
+  const url = new URL(window.location.href);
+  url.pathname = "/checkout";
+  url.searchParams.set("lmo_offer", params.skuId);
+  if (params.inlineError)
+    url.searchParams.set("inlineError", params.inlineError);
+  if (params.email) url.searchParams.set("email", params.email);
+  if (params.emailError) url.searchParams.set("emailError", params.emailError);
+  url.searchParams.set("returnUrl", params.returnUrl);
+  return url.pathname + url.search;
+};
+
+// src/clients/payment-checkout/payment-handler.ts
+var MSG_ELIGIBILITY = "Something went wrong, please try again";
+var MSG_REGISTRATION = "We couldn't create your account. Please enter your email or try a different login method.";
+var failApplePaySession = (session, errors = []) => {
+  session.completePayment({
+    status: ApplePaySession.STATUS_FAILURE,
+    errors
+  });
+};
+function parseWalletApiError(err) {
+  const body = err instanceof ApiError ? err.body : err;
+  if (body && typeof body === "object" && "errorType" in body && "message" in body) {
+    return body;
+  }
+  return null;
+}
+function validateContacts(event, sessionData, supportedBillingCountries) {
+  billingContactDetails(
+    event.payment.billingContact,
+    supportedBillingCountries
+  );
+  if (!sessionData.loggedIn) {
+    return shippingContactDetails(event.payment.shippingContact).emailAddress;
+  }
+  return void 0;
+}
+function redirectFallback(skuId, returnUrl, options) {
+  trackFallbackCheckout(skuId);
+  window.location.href = redirectToCheckoutFallback({
+    skuId,
+    returnUrl,
+    ...options
+  });
+}
+var ERROR_HANDLERS = {
+  EMAIL_COLLISION: ({ skuId, returnUrl, validatedEmail }) => redirectFallback(skuId, returnUrl, {
+    emailError: MSG_EMAIL_COLLISION,
+    email: validatedEmail
+  }),
+  PAYMENT_DECLINED: ({ skuId, returnUrl }) => (
+    // Matches sma-checkout catch-all: always redirect with generic inlineError.
+    redirectFallback(skuId, returnUrl, { inlineError: MSG_PAYMENT_GENERIC_ERROR })
+  ),
+  ELIGIBILITY_REJECTED: ({ skuId, returnUrl }) => redirectFallback(skuId, returnUrl, { inlineError: MSG_ELIGIBILITY }),
+  REGISTRATION_FAILED: ({ skuId, returnUrl }) => redirectFallback(skuId, returnUrl, { inlineError: MSG_REGISTRATION }),
+  VALIDATION_ERROR: ({ skuId, returnUrl }) => redirectFallback(skuId, returnUrl, { inlineError: MSG_RECAPTCHA_VALIDATION_FAILED })
+};
+function handleStructuredError(ctx) {
+  const handler = ERROR_HANDLERS[ctx.walletError.errorType];
+  if (handler) {
+    handler(ctx);
+  } else {
+    redirectFallback(ctx.skuId, ctx.returnUrl, { inlineError: MSG_PAYMENT_GENERIC_ERROR });
+  }
+}
+async function handlePaymentAuthorized(event, session, sessionData, config) {
+  const { skuId, returnUrl, queryString } = config;
+  let validatedEmail;
+  console.log("[web-apple-pay] handlePaymentAuthorized: starting", { skuId, userLoggedIn: sessionData.loggedIn });
+  try {
+    console.log("[web-apple-pay] handlePaymentAuthorized: step 1 \u2014 validating contacts");
+    validatedEmail = validateContacts(
+      event,
+      sessionData,
+      config.supportedBillingCountries
+    );
+    console.log("[web-apple-pay] handlePaymentAuthorized: contacts valid", { validatedEmail });
+    console.log("[web-apple-pay] handlePaymentAuthorized: step 2 \u2014 calling performPurchase", { skuId });
+    const result = await performPurchase({
+      applePayToken: event.payment.token,
+      skuId: config.skuId,
+      billingContact: event.payment.billingContact,
+      ...event.payment.shippingContact && {
+        shippingContact: event.payment.shippingContact
+      },
+      recaptchaTokens: config.recaptchaTokens
+    });
+    console.log("[web-apple-pay] handlePaymentAuthorized: performPurchase succeeded", { basketId: result.basketId });
+    console.log("[web-apple-pay] handlePaymentAuthorized: step 3 \u2014 completing payment and redirecting");
+    trackWalletPaymentSuccess(skuId, result.basketId);
+    session.completePayment({ status: ApplePaySession.STATUS_SUCCESS });
+    const userStatus = sessionData.loggedIn ? "lex" : "nex";
+    window.location.href = redirectToCheckoutComplete({
+      basketId: result.basketId,
+      status: userStatus,
+      skuId: decodeSku(skuId),
+      returnUrl,
+      queryString
+    });
+  } catch (err) {
+    if (err instanceof ContactValidationError) {
+      console.warn("[web-apple-pay] handlePaymentAuthorized: contact validation failed", err.errors);
+      failApplePaySession(session, err.errors);
+      return;
+    }
+    console.error("[web-apple-pay] onpaymentauthorized error", { skuId, err });
+    const walletError = parseWalletApiError(err);
+    console.error("[web-apple-pay] handlePaymentAuthorized: BFF/network error", {
+      skuId,
+      errorType: walletError?.errorType ?? "UNKNOWN",
+      message: walletError?.message
+    });
+    trackWalletPaymentFailure(skuId, walletError?.errorType ?? "UNKNOWN");
+    failApplePaySession(session);
+    if (!walletError) {
+      console.warn("[web-apple-pay] handlePaymentAuthorized: unstructured error, using generic fallback");
+      redirectFallback(skuId, returnUrl, { inlineError: MSG_PAYMENT_GENERIC_ERROR });
+      return;
+    }
+    console.log("[web-apple-pay] handlePaymentAuthorized: dispatching structured error handler", { errorType: walletError.errorType });
+    handleStructuredError({ skuId, returnUrl, validatedEmail, walletError });
+  }
+}
+export {
+  handlePaymentAuthorized
+};

package/dist/src/clients/payment-checkout/session.d.ts

@@ -0,0 +1,2 @@
+import type { SessionResponse } from './types';
+export declare const getExpressCheckoutSession: () => Promise<SessionResponse>;

package/dist/src/clients/payment-checkout/session.js

@@ -0,0 +1,67 @@
+// src/clients/payment-checkout/config.ts
+var runtimeConfig = null;
+var getApplePayConfig = () => runtimeConfig;
+
+// src/clients/payment-checkout/types.ts
+var ApiError = class extends Error {
+  status;
+  body;
+  constructor(status, body) {
+    super(`API request failed with status ${status}`);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+
+// src/clients/payment-checkout/index.ts
+var getWalletApiBaseUrl = () => {
+  const config = getApplePayConfig();
+  if (!config?.walletApiBaseUrl) {
+    throw new Error(
+      "[web-apple-pay] Missing walletApiBaseUrl. Call configureApplePay({ merchantId, walletApiBaseUrl, ... }) before making wallet API requests."
+    );
+  }
+  return config.walletApiBaseUrl;
+};
+var apiFetch = async (path, options = {}) => {
+  const baseUrl = getWalletApiBaseUrl();
+  const method = (options.method ?? "GET").toUpperCase();
+  const hasBody = options.body !== void 0 && options.body !== null;
+  const headers = new Headers(options.headers);
+  if (!headers.has("Accept")) {
+    headers.set("Accept", "application/json");
+  }
+  if (!headers.has("Content-Type")) {
+    if (hasBody || method !== "GET" && method !== "HEAD") {
+      headers.set("Content-Type", "application/json");
+    }
+  }
+  const response = await fetch(`${baseUrl}${path}`, {
+    ...options,
+    headers
+  });
+  if (!response.ok) {
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      const errorBody = await response.json();
+      throw new ApiError(response.status, errorBody);
+    }
+    const errorText = await response.text();
+    throw new Error(
+      `API request failed: ${response.status} ${response.statusText} - ${errorText}`
+    );
+  }
+  return response.json();
+};
+
+// src/clients/payment-checkout/session.ts
+var getExpressCheckoutSession = () => {
+  return apiFetch("/v1/wallet/session", {
+    method: "GET",
+    credentials: "include"
+  });
+};
+export {
+  getExpressCheckoutSession
+};

package/dist/src/clients/payment-checkout/shipping-contact-details.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Apple Pay shipping contact local validator.
+ * Ported from sma-checkout — handlers/create-on-payment-authorized-handler/subscribe/shipping-contact-details.ts
+ *
+ * Validates the shipping contact's email address if present.
+ */
+export type ShippingValidationResult = {
+    emailAddress: string;
+};
+export declare const shippingContactDetails: (shippingContact: ApplePayJS.ApplePayPaymentContact | undefined) => ShippingValidationResult;

package/dist/src/clients/payment-checkout/shipping-contact-details.js

@@ -0,0 +1,83 @@
+// src/utils/expressCheckoutTracking.ts
+var emitTedlEvent = (event) => {
+  window.tedl = window.tedl ?? {};
+  window.tedl.events = window.tedl.events ?? [];
+  window.tedl.events.push(event);
+};
+var track = (action, extra) => {
+  emitTedlEvent({
+    name: "user.journey",
+    type: "checkout",
+    action,
+    info: "applepay",
+    ...extra
+  });
+};
+var trackValidationFieldError = (field, errorType) => {
+  track(`validation_${field}_${errorType}`, {});
+};
+
+// src/clients/payment-checkout/messages.ts
+var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
+var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
+var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
+var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
+
+// src/clients/payment-checkout/contact-validation.ts
+var pushFieldError = (errors, billingOrShippingContact = "billing", field, errorType, errorText) => {
+  const errorCode = billingOrShippingContact === "billing" ? "billingContactInvalid" : "shippingContactInvalid";
+  errors.push(new ApplePayError(errorCode, field, errorText));
+  trackValidationFieldError(field, errorType);
+  return "";
+};
+var pushRequiredFieldError = (errors, billingOrShippingContact = "billing", field) => {
+  return pushFieldError(
+    errors,
+    billingOrShippingContact,
+    field,
+    "required",
+    MSG_MISSING_REQUIRED_FIELD
+  );
+};
+var ContactValidationError = class extends Error {
+  constructor(errors) {
+    super(MSG_CONTACT_VALIDATION_INTERNAL);
+    this.errors = errors;
+  }
+};
+
+// src/clients/payment-checkout/shipping-contact-details.ts
+var EMAIL_FORMAT_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var shippingContactDetails = (shippingContact) => {
+  const errors = [];
+  let emailAddress = "";
+  if (shippingContact?.emailAddress === void 0 || shippingContact?.emailAddress === "") {
+    pushRequiredFieldError(errors, "shipping", "emailAddress");
+  } else {
+    emailAddress = shippingContact.emailAddress.trim();
+    if (emailAddress.length > 80) {
+      pushFieldError(
+        errors,
+        "shipping",
+        "emailAddress",
+        "format",
+        MSG_EMAIL_TOO_LONG
+      );
+    } else if (!EMAIL_FORMAT_REGEX.test(emailAddress)) {
+      pushFieldError(
+        errors,
+        "shipping",
+        "emailAddress",
+        "format",
+        MSG_EMAIL_WRONG_FORMAT
+      );
+    }
+  }
+  if (errors.length > 0) {
+    throw new ContactValidationError(errors);
+  }
+  return { emailAddress };
+};
+export {
+  shippingContactDetails
+};