@evervault/js 2.18.0 → 2.19.0

package/dist/evervault.d.ts

@@ -56,6 +56,30 @@ declare type ApplePayButtonOptions = {
         amount: number;
         lineItems?: TransactionLineItem[];
     }>;
+    /**
+     * Shipping type label on the Apple Pay sheet (shipping / delivery / pickup).
+     * Payment (one-off) transactions only — rejected for recurring and disbursement.
+     */
+    shippingType?: ApplePayShippingType;
+    /**
+     * Shipping methods shown as selectable options on the Apple Pay sheet.
+     * Requires `requestShipping: true` (auto-enabled when methods are provided).
+     * Payment (one-off) transactions only — rejected for recurring and disbursement.
+     *
+     * When the customer selects a method, totals are recomputed. Provide
+     * `onShippingMethodSelected` to control the amount/line items yourself;
+     * otherwise the SDK adjusts the total by the selected method's amount.
+     */
+    shippingMethods?: ApplePayShippingMethod[];
+    /**
+     * Called when the customer selects a shipping method on the sheet.
+     * Return updated totals. Maps to PaymentRequest `shippingoptionchange`.
+     * Requires `shippingMethods` (and shipping to be requested).
+     */
+    onShippingMethodSelected?: (shippingMethod: ApplePayShippingMethod) => Promise<{
+        amount: number;
+        lineItems?: TransactionLineItem[];
+    }>;
     /**
      * Show the coupon field on the Apple Pay sheet and receive updates when the
      * customer changes the code. Maps to ApplePayRequest.supportsCouponCode /
@@ -88,6 +112,16 @@ declare type ApplePayButtonOptions = {
      * transaction) — this field has no effect on disbursement-type transactions.
      */
     shippingContact?: PaymentContact;
+    /**
+     * Opaque merchant data included on the Apple Pay request
+     * (ApplePayRequest.applicationData). Must be a Base64-encoded string.
+     */
+    applicationData?: string;
+    /**
+     * Restrict payments to cards issued in these ISO 3166 country codes
+     * (ApplePayRequest.supportedCountries).
+     */
+    supportedCountries?: string[];
     prepareTransaction?: () => Promise<{
         amount?: number;
         lineItems?: TransactionLineItem[];
@@ -133,6 +167,25 @@ declare type ApplePayMerchantCapability =
 | "supportsDebit"
 | "supportsInstantFundsOut";
 
+/**
+ * A shipping method the customer can pick on the Apple Pay sheet.
+ * Amounts use the same smallest-currency-unit convention as line items (e.g. cents).
+ * Maps to PaymentDetailsInit.shippingOptions / PaymentShippingOption.
+ */
+declare interface ApplePayShippingMethod {
+    id: string;
+    label: string;
+    amount: number;
+    detail?: string;
+    selected?: boolean;
+}
+
+/**
+ * Shipping type shown on the Apple Pay sheet. Maps to PaymentOptions.shippingType
+ * (storePickup / servicePickup → "pickup" on the Payment Request bridge).
+ */
+declare type ApplePayShippingType = "shipping" | "delivery" | "storePickup" | "servicePickup";
+
 declare type ApplePayTransactionType = "oneOff" | "recurring" | "disbursement";
 
 declare interface BaseTransactionDetails {
@@ -942,6 +995,16 @@ EncryptedDPAN<"apple">,
         emailAddress?: string;
         phoneNumber?: string;
     };
+    /**
+     * The shipping method the customer selected on the Apple Pay sheet.
+     * Present when `shippingMethods` were configured on the web Apple Pay button.
+     */
+    shippingMethod?: {
+        id: string;
+        label: string;
+        amount: number;
+        detail?: string;
+    };
 };
 
 declare interface EncryptedDPAN<P> {
@@ -10568,8 +10631,16 @@ declare type TransactionDetailsWithDomain = TransactionDetails & {
 declare interface TransactionLineItem {
     amount: number;
     label: string;
+    /**
+     * Whether the line item amount is final or still pending (e.g. tax/shipping).
+     * Maps to Apple Pay `ApplePayLineItem.type` / Payment Request `PaymentItem.pending`.
+     * Defaults to `"final"` when omitted.
+     */
+    type?: TransactionLineItemType;
 }
 
+declare type TransactionLineItemType = "final" | "pending";
+
 declare interface TranslationsObject {
     [key: string]: string | TranslationsObject | undefined;
 }

package/package.json

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