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

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

@@ -0,0 +1,118 @@
+/**
+ * Types mapping to the wallet-payments-api BFF.
+ * Aligned with UI-Integration-Mocks.md.
+ */
+export type PaymentOptionsRequest = {
+    sku: string;
+    countryCode: string;
+    currencyCode: string;
+    /** The current page URL, sent to Commerce Services for logging purposes. */
+    checkoutUrl: string;
+};
+/**
+ * Relevant subset of the wallet-payments-api BFF GET /v1/wallet/payment-options/sku/:sku/:countryCode/:currencyCode response.
+ * Only the apple_pay field is consumed by this package.
+ */
+export type PaymentOptionsResponse = {
+    options: {
+        apple_pay?: {
+            provider: string;
+            settings: {
+                supported_networks: string[];
+            };
+        };
+    };
+};
+/**
+ * GET /v1/wallet/session — uses credentials: 'include' (cookie-based).
+ *
+ * BFF always returns userType, even for anonymous users.
+ * Scenario C (active-subscription) → frontend MUST suppress Apple Pay button.
+ */
+export type SessionResponse = {
+    loggedIn: false;
+    userType: 'new-eligible-user';
+} | {
+    loggedIn: true;
+    emailAddress: string;
+    contactId: string;
+    userType: 'active-subscription' | 'b2b-user' | 'new-eligible-user';
+};
+export type ValidateMerchantRequest = {
+    validationURL: string;
+    recaptchaToken: string;
+};
+export type ValidateMerchantResponse = {
+    merchantSession: Record<string, unknown>;
+};
+/**
+ * Minimal shape of the Apple Pay token received from `onpaymentauthorized`.
+ * Mirrors the relevant subset of `ApplePayJS.ApplePayPaymentToken` without
+ * requiring the `@types/applepayjs` package as a dependency.
+ */
+export type ApplePayPaymentToken = {
+    paymentData: unknown;
+    paymentMethod: {
+        displayName?: string;
+        network?: string;
+        type?: string;
+    };
+    transactionIdentifier: string;
+};
+/**
+ * Subset of ApplePayJS.ApplePayPaymentContact used in purchase and shipping.
+ */
+export type ApplePayPaymentContact = {
+    emailAddress?: string;
+    givenName?: string;
+    familyName?: string;
+    phoneNumber?: string;
+    addressLines?: string[];
+    locality?: string;
+    administrativeArea?: string;
+    postalCode?: string;
+    countryCode?: string;
+};
+/**
+ * POST /v1/wallet/purchase
+ *
+ * The BFF orchestrates eligibility check, passwordless registration,
+ * basket creation, and payment finalization in a single call.
+ */
+export type PurchaseRequest = {
+    applePayToken: ApplePayPaymentToken;
+    /**
+     * @TODO [BFF Contract Misalignment]
+     * BFF spec requests `offerData: { ratePlanId, offerId }` but Commerce Services
+     * only provide a `skuId`. Frontend uses `skuId` directly — BFF must be aligned.
+     */
+    skuId: string;
+    billingContact: ApplePayPaymentContact;
+    /** Required if loggedIn: false — contains emailAddress from Apple Pay sheet. */
+    shippingContact?: ApplePayPaymentContact;
+    recaptchaTokens: {
+        checkEligibility: string;
+        newBasket: string;
+        registerUser: string;
+    };
+};
+export type PurchaseResponse = {
+    basketId: string;
+};
+/**
+ * Structured error body returned by all /v1/wallet/* endpoints on 4xx/5xx.
+ */
+export type WalletApiError = {
+    errorType: 'SERVICE_UNAVAILABLE' | 'PAYMENT_DECLINED' | 'VALIDATION_ERROR' | 'BAD_REQUEST' | 'EMAIL_COLLISION' | 'ELIGIBILITY_REJECTED' | 'REGISTRATION_FAILED';
+    message: string;
+};
+/**
+ * Error thrown by apiFetch for non-2xx responses.
+ * Carries the HTTP status and the parsed response body so callers can
+ * branch on structured error types (e.g. WalletApiError).
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}

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

@@ -0,0 +1,14 @@
+// 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;
+  }
+};
+export {
+  ApiError
+};

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export { ApplePayButton, APPLE_PAY_EXCLUDED_VARIANTS, } from './apple-pay-button';
+export { ApplePayModal } from './apple-pay-modal';
+export { ensureApplePayLogoSymbol } from './apple-pay-logo';
+export { configureApplePay } from './clients/payment-checkout/config';
+export type { ApplePayRuntimeConfig } from './clients/payment-checkout/config';
+export type { Offer } from './types/offer.types';
+export declare function defineApplePayElements(): void;