@evervault/js 2.20.0 → 2.22.0

package/dist/evervault.d.ts

@@ -146,6 +146,24 @@ declare interface ApplePayCardEnrichment {
 
 declare type ApplePayCardNetwork = "amex" | "bancomat" | "bancontact" | "cartesBancaires" | "chinaUnionPay" | "dankort" | "discover" | "eftpos" | "electron" | "elo" | "girocard" | "interac" | "jcb" | "mada" | "maestro" | "masterCard" | "mir" | "privateLabel" | "visa" | "vPay";
 
+/** Shape of Apple Pay's native billing/shipping contact, as passed through unmodified. */
+declare interface ApplePayContact {
+    givenName?: string;
+    familyName?: string;
+    phoneticGivenName?: string;
+    phoneticFamilyName?: string;
+    emailAddress?: string;
+    phoneNumber?: string;
+    addressLines?: string[];
+    subLocality?: string;
+    locality?: string;
+    postalCode?: string;
+    subAdministrativeArea?: string;
+    administrativeArea?: string;
+    country?: string;
+    countryCode?: string;
+}
+
 /** Maps to ApplePayErrorCode values for coupon validation on the sheet. */
 declare type ApplePayCouponCodeErrorCode = "couponCodeInvalid" | "couponCodeExpired";
 
@@ -1097,27 +1115,12 @@ EncryptedDPAN<"apple">,
 > & {
     networkToken: PaymentToken<"apple"> & { rawExpiry: string };
     card: EncryptedDPAN<"apple">["card"] & ApplePayCardEnrichment;
-    billingContact?: {
-        givenName?: string;
-        familyName?: string;
-        phoneticGivenName?: string;
-        phoneticFamilyName?: string;
-        emailAddress?: string;
-        phoneNumber?: string;
-        address?: unknown;
-    };
+    billingContact?: ApplePayContact;
     paymentDataType: string;
     transactionType: ApplePayTransactionType;
     transactionId: string;
     deviceManufacturerIdentifier: string;
-    shippingContact?: {
-        givenName?: string;
-        familyName?: string;
-        phoneticGivenName?: string;
-        phoneticFamilyName?: string;
-        emailAddress?: string;
-        phoneNumber?: string;
-    };
+    shippingContact?: ApplePayContact;
     /**
      * Set when `requestPayerDetails` is used. Apple Pay collects these on the
      * shipping contact, so they also appear on `shippingContact`.
@@ -1168,11 +1171,30 @@ declare interface EncryptedFPAN {
 }
 
 declare type EncryptedGooglePayData = (
-| EncryptedDPAN<"google">
-| EncryptedFPAN
+| EncryptedGooglePayDPAN
+| EncryptedGooglePayFPAN
 ) & {
     email?: string | null;
     billingAddress?: google.payments.api.Address | null;
+    /**
+     * The address the buyer chose in the sheet. Present when shipping-address
+     * collection was enabled directly or through `shippingOptions`.
+     */
+    shippingAddress?: google.payments.api.Address | null;
+    /**
+     * The shipping option the buyer chose in the sheet. Present only when
+     * `shippingOptions` were configured on the Google Pay button.
+     */
+    shippingOption?: GooglePayShippingOption | null;
+    assuranceDetails?: google.payments.api.AssuranceDetails | null;
+};
+
+declare type EncryptedGooglePayDPAN = Omit<EncryptedDPAN<"google">, "card"> & {
+    card: EncryptedDPAN<"google">["card"] & GooglePayCardEnrichment;
+};
+
+declare type EncryptedGooglePayFPAN = Omit<EncryptedFPAN, "card"> & {
+    card: EncryptedFPAN["card"] & GooglePayCardEnrichment;
 };
 
 declare const encryptionConstants: {
@@ -1351,7 +1373,18 @@ declare class GooglePay {
             allowedAuthMethods: google.payments.api.CardAuthMethod[] | undefined;
             allowedCardNetworks: google.payments.api.CardNetwork[] | undefined;
             billingAddress: GooglePayBillingAddressConfig | undefined;
+            shippingAddress: GooglePayShippingAddressConfig | undefined;
+            shippingOptions: GooglePayShippingOptionsConfig | undefined;
             emailRequired: boolean | undefined;
+            checkoutOption: google.payments.api.CheckoutOption | undefined;
+            transactionId: string | undefined;
+            totalPriceStatus: "ESTIMATED" | "FINAL" | undefined;
+            allowPrepaidCards: boolean | undefined;
+            allowCreditCards: boolean | undefined;
+            softwareInfo: google.payments.api.SoftwareInfo | undefined;
+            assuranceDetailsRequired: boolean | undefined;
+            existingPaymentMethodRequired: boolean | undefined;
+            prefetchPaymentData: boolean | undefined;
         };
     };
     mount(selector: SelectorType): this;
@@ -1412,6 +1445,37 @@ declare type GooglePayButtonType =
 | "plain"
 | "subscribe";
 
+declare interface GooglePayCardEnrichment {
+    funding?: string;
+    segment?: string;
+    country?: string;
+    currency?: string;
+    issuer?: string;
+}
+
+/** Rejects the buyer's current selection and shows an error in the sheet. */
+declare interface GooglePayDataChangeFailure {
+    error: GooglePayErrorMessage;
+    amount?: never;
+    lineItems?: never;
+    shippingOptions?: never;
+}
+
+/**
+ * A successful patch for the open sheet. Omitted fields retain their current
+ * values. Amounts use the currency's minor units, like `transaction.amount`.
+ */
+declare interface GooglePayDataChangeSuccess {
+    amount?: number;
+    lineItems?: TransactionLineItem[];
+    shippingOptions?: GooglePayShippingOptionsConfig;
+    error?: never;
+}
+
+declare type GooglePayDataChangeUpdate =
+| GooglePayDataChangeSuccess
+| GooglePayDataChangeFailure;
+
 declare interface GooglePayErrorMessage {
     message: string;
     reason?: google.payments.api.ErrorReason;
@@ -1442,7 +1506,119 @@ declare interface GooglePayOptions {
     allowedAuthMethods?: google.payments.api.CardAuthMethod[];
     allowedCardNetworks?: google.payments.api.CardNetwork[];
     billingAddress?: GooglePayBillingAddressConfig;
+    /**
+     * Collect a shipping address in the sheet. Pass `true` for any supported
+     * country, or parameters to restrict countries / request a phone number.
+     */
+    shippingAddress?: GooglePayShippingAddressConfig;
+    /**
+     * Offer shipping options in the sheet. This also enables shipping-address
+     * collection when `shippingAddress` is omitted.
+     */
+    shippingOptions?: GooglePayShippingOptionsConfig;
+    /**
+     * Called when the buyer picks or changes their shipping address, while the
+     * sheet is still open. Return updated totals, line items or options. The
+     * callback has 10 seconds to complete.
+     */
+    onShippingAddressChange?: (
+    address: google.payments.api.IntermediateAddress,
+    context: GooglePayShippingContext
+    ) =>
+    | GooglePayDataChangeUpdate
+    | void
+    | Promise<GooglePayDataChangeUpdate | void>;
+    /**
+     * Called when the buyer picks a different shipping option. The callback has
+     * 10 seconds to complete.
+     */
+    onShippingOptionChange?: (
+    option: GooglePayShippingOption,
+    context: GooglePayShippingContext
+    ) =>
+    | GooglePayDataChangeUpdate
+    | void
+    | Promise<GooglePayDataChangeUpdate | void>;
     theme?: ThemeDefinition;
+    /**
+     * Whether to show a 'Continue' or 'Pay Now' button on the Google Pay sheet.
+     * @default "DEFAULT"
+     */
+    checkoutOption?: google.payments.api.CheckoutOption;
+    /**
+     * A merchant-generated ID for this transaction, used for fraud correlation.
+     */
+    transactionId?: string;
+    /**
+     * Whether the total price is known and final, or still an estimate.
+     *
+     * `"NOT_CURRENTLY_KNOWN"` isn't supported — same as Android and our
+     * current shipping implementation.
+     * @default "FINAL"
+     */
+    totalPriceStatus?: Exclude<
+    google.payments.api.TotalPriceStatus,
+    "NOT_CURRENTLY_KNOWN"
+    >;
+    /** @default true */
+    allowPrepaidCards?: boolean;
+    /** @default true */
+    allowCreditCards?: boolean;
+    /**
+     * Identifies the software used to integrate with Google Pay, for Google's
+     * own metrics.
+     */
+    softwareInfo?: google.payments.api.SoftwareInfo;
+    /**
+     * When true, requests that Google Pay perform cardholder ID&V/possession
+     * checks and return the result as `assuranceDetails` on the payment method.
+     */
+    assuranceDetailsRequired?: boolean;
+    /**
+     * When true, requires the user to have an existing payment method
+     * associated with their Google account for the button to be shown as
+     * ready. Checked by `isReadyToPay`, not `loadPaymentData`.
+     * @default false
+     */
+    existingPaymentMethodRequired?: boolean;
+    /**
+     * When true, asks Google Pay to prefetch payment data as soon as the
+     * button is ready, so the sheet opens faster when the user clicks it.
+     * Fire-and-forget; has no effect on `process()`'s result.
+     */
+    prefetchPaymentData?: boolean;
+}
+
+declare type GooglePayShippingAddressConfig =
+| boolean
+| GooglePayShippingAddressParameters;
+
+declare type GooglePayShippingAddressParameters =
+google.payments.api.ShippingAddressParameters;
+
+/** The current shipping state when Google Pay asks for an update. */
+declare interface GooglePayShippingContext {
+    trigger: google.payments.api.CallbackTrigger;
+    shippingAddress?: google.payments.api.IntermediateAddress | null;
+    selectedShippingOption?: GooglePayShippingOption | null;
+    /** The current total in the currency's minor units. */
+    amount: number;
+    lineItems?: TransactionLineItem[];
+    shippingOptions?: GooglePayShippingOptionsConfig;
+}
+
+declare type GooglePayShippingOption = google.payments.api.SelectionOption & {
+    /**
+     * Optional shipping cost in minor units. Google Pay does not display this
+     * field automatically. Include it in `label` when buyers must see the price.
+     */
+    amount?: number;
+};
+
+declare interface GooglePayShippingOptionsConfig {
+    options: GooglePayShippingOption[];
+    /** Defaults to the first option when omitted, matching Google's own default. */
+    defaultSelectedOptionId?: string;
 }
 
 declare interface HttpConfig {
@@ -11755,10 +11931,19 @@ declare interface SwipedCard {
 
 declare type ThemeDefinition = ThemeObject | ThemeFunction;
 
+declare interface ThemeFontFace {
+    fontFamily: string;
+    src: string;
+    fontWeight?: string | number;
+    fontStyle?: string;
+    fontDisplay?: string;
+}
+
 declare type ThemeFunction = (utilities: ThemeUtilities) => ThemeObject;
 
 declare interface ThemeObject {
     fonts?: string[];
+    fontFaces?: ThemeFontFace[];
     styles?: ThemeStyles;
 }
 
@@ -11835,6 +12020,12 @@ declare interface TransactionLineItem {
      * Defaults to `"final"` when omitted.
      */
     type?: TransactionLineItemType;
+    /**
+     * The kind of line item, for platforms that distinguish it (currently Google
+     * Pay only, where it maps to `displayItems[].type`). Has no effect on Apple
+     * Pay or disbursements. Defaults to `"line_item"` when omitted.
+     */
+    category?: "line_item" | "subtotal" | "tax" | "discount" | "shipping_option";
 }
 
 declare type TransactionLineItemType = "final" | "pending";

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@evervault/js",
-  "version": "2.20.0",
+  "version": "2.22.0",
   "description": "Evervault.js loader for client-side browser applications",
   "license": "MIT",
   "type": "module",
@@ -20,10 +20,10 @@
     "typescript": "5.6.3",
     "vite": "^8.1.4",
     "vite-plugin-dts": "^5.0.2",
-    "themes": "0.1.24",
-    "@evervault/browser": "2.63.0",
+    "@evervault/browser": "2.65.0",
     "tsconfig": "0.1.0",
-    "types": "0.23.1"
+    "types": "0.23.1",
+    "themes": "0.1.24"
   },
   "scripts": {
     "build": "vite build",