@evervault/js 2.0.2 → 2.2.0

package/dist/evervault.d.ts

@@ -1,96 +1,37 @@
 import { events } from 'events';
 
-declare class ApplePay {
-    #private;
-    constructor(client: EvervaultClient, transaction: Transaction, options: ApplePayOptions);
-    get config(): {
-        config: {
-            type: ApplePayButtonType | undefined;
-            style: ApplePayButtonStyle | undefined;
-            locale: ApplePayButtonLocale | undefined;
-            borderRadius: number | undefined;
-            allowedCardNetworks: ApplePayCardNetwork[] | undefined;
-            transaction: TransactionDetailsWithDomain;
-            paymentOverrides: {
-                paymentMethodData?: PaymentMethodData[];
-                paymentDetails?: PaymentDetailsInit;
-            } | undefined;
-            disbursementOverrides: {
-                disbursementDetails?: PaymentDetailsInit;
-            } | undefined;
-            requestPayerDetails: ("name" | "email" | "phone")[] | undefined;
-        };
-    };
-    mount(selector: SelectorType): this;
-    update(options?: ApplePayOptions): this;
-    unmount(): this;
-    on<T extends keyof ApplePayEvents>(event: T, callback: ApplePayEvents[T]): () => void;
-}
-
 declare class ApplePayButton {
     #private;
     client: EvervaultClient;
     transaction: Transaction;
     constructor(client: EvervaultClient, transaction: Transaction, options: ApplePayButtonOptions);
-    on(event: keyof ApplePayEvents_2, callback: ApplePayEvents_2[keyof ApplePayEvents_2]): () => void;
-    mount(selector: SelectorType): void;
+    on(event: keyof ApplePayEvents, callback: ApplePayEvents[keyof ApplePayEvents]): () => void;
+    /**
+     * Checks the availability of Apple Pay on the current device.
+     *
+     * @returns {Promise<"available" | "unavailable" | "unsupported">} A promise that resolves to a string indicating the availability status of Apple Pay:
+     * - "available": Apple Pay is available and can be used.
+     * - "unavailable": Apple Pay is not available due to payment credentials being unavailable.
+     * - "unsupported": Apple Pay is not supported on this device or browser.
+     */
+    availability(): Promise<"available" | "unavailable" | "unsupported">;
+    mount(selector: SelectorType): Promise<void>;
     unmount(): void;
 }
 
-declare type ApplePayButtonLocale =
-| "ar-AB"
-| "ca-ES"
-| "cs-CZ"
-| "da-DK"
-| "de-DE"
-| "el-GR"
-| "en-AU"
-| "en-GB"
-| "en-US"
-| "es-ES"
-| "es-MX"
-| "fi-FI"
-| "fr-CA"
-| "fr-FR"
-| "he-IL"
-| "hi-IN"
-| "hr-HR"
-| "hu-HU"
-| "id-ID"
-| "it-IT"
-| "ja-JP"
-| "ko-KR"
-| "ms-MY"
-| "nb-NO"
-| "nl-NL"
-| "pl-PL"
-| "pt-BR"
-| "pt-PT"
-| "ro-RO"
-| "ru-RU"
-| "sk-SK"
-| "sv-SE"
-| "th-TH"
-| "tr-TR"
-| "uk-UA"
-| "vi-VN"
-| "zh-CN"
-| "zh-HK"
-| "zh-TW";
-
-declare type ApplePayButtonLocale_2 = "ar-AB" | "ca-ES" | "cs-CZ" | "da-DK" | "de-DE" | "el-GR" | "en-AU" | "en-GB" | "en-US" | "es-ES" | "es-MX" | "fi-FI" | "fr-CA" | "fr-FR" | "he-IL" | "hi-IN" | "hr-HR" | "hu-HU" | "id-ID" | "it-IT" | "ja-JP" | "ko-KR" | "ms-MY" | "nb-NO" | "nl-NL" | "pl-PL" | "pt-BR" | "pt-PT" | "ro-RO" | "ru-RU" | "sk-SK" | "sv-SE" | "th-TH" | "tr-TR" | "uk-UA" | "vi-VN" | "zh-CN" | "zh-HK" | "zh-TW";
+declare type ApplePayButtonLocale = "ar-AB" | "ca-ES" | "cs-CZ" | "da-DK" | "de-DE" | "el-GR" | "en-AU" | "en-GB" | "en-US" | "es-ES" | "es-MX" | "fi-FI" | "fr-CA" | "fr-FR" | "he-IL" | "hi-IN" | "hr-HR" | "hu-HU" | "id-ID" | "it-IT" | "ja-JP" | "ko-KR" | "ms-MY" | "nb-NO" | "nl-NL" | "pl-PL" | "pt-BR" | "pt-PT" | "ro-RO" | "ru-RU" | "sk-SK" | "sv-SE" | "th-TH" | "tr-TR" | "uk-UA" | "vi-VN" | "zh-CN" | "zh-HK" | "zh-TW";
 
 declare type ApplePayButtonOptions = {
-    type?: ApplePayButtonType_2;
-    style?: ApplePayButtonStyle_2;
-    locale?: ApplePayButtonLocale_2;
+    type?: ApplePayButtonType;
+    style?: ApplePayButtonStyle;
+    locale?: ApplePayButtonLocale;
     padding?: string;
-    borderRadius?: string;
+    borderRadius?: string | number;
     size?: {
         width: string | number;
         height: string | number;
     };
-    allowedCardNetworks?: ApplePayCardNetwork_2[];
+    allowedCardNetworks?: ApplePayCardNetwork[];
     requestPayerDetails?: ("name" | "email" | "phone")[];
     requestBillingAddress?: boolean;
     requestShipping?: boolean;
@@ -101,6 +42,14 @@ declare type ApplePayButtonOptions = {
     disbursementOverrides?: {
         disbursementDetails?: PaymentDetailsInit;
     };
+    onShippingAddressChange?: (newAddress: ShippingAddress) => Promise<{
+        amount: number;
+        lineItems?: TransactionLineItem[];
+    }>;
+    prepareTransaction?: () => Promise<{
+        amount?: number;
+        lineItems?: TransactionLineItem[];
+    }>;
     process: (data: EncryptedApplePayData, helpers: {
         fail: (error?: ApplePayErrorMessage) => void;
     }) => Promise<void>;
@@ -108,95 +57,20 @@ declare type ApplePayButtonOptions = {
 
 declare type ApplePayButtonStyle = "black" | "white" | "white-outline";
 
-declare type ApplePayButtonStyle_2 = "black" | "white" | "white-outline";
+declare type ApplePayButtonType = "add-money" | "book" | "buy" | "check-out" | "continue" | "contribute" | "donate" | "order" | "pay" | "plain" | "reload" | "rent" | "set-up" | "subscribe" | "support" | "tip" | "top-up";
 
-declare type ApplePayButtonType =
-| "add-money"
-| "book"
-| "buy"
-| "check-out"
-| "continue"
-| "contribute"
-| "donate"
-| "order"
-| "pay"
-| "plain"
-| "reload"
-| "rent"
-| "set-up"
-| "subscribe"
-| "support"
-| "tip"
-| "top-up";
-
-declare type ApplePayButtonType_2 = "add-money" | "book" | "buy" | "check-out" | "continue" | "contribute" | "donate" | "order" | "pay" | "plain" | "reload" | "rent" | "set-up" | "subscribe" | "support" | "tip" | "top-up";
-
-declare type ApplePayCardNetwork =
-| "amex"
-| "bancomat"
-| "bancontact"
-| "cartesBancaires"
-| "chinaUnionPay"
-| "dankort"
-| "discover"
-| "eftpos"
-| "electron"
-| "elo"
-| "girocard"
-| "interac"
-| "jcb"
-| "mada"
-| "maestro"
-| "masterCard"
-| "mir"
-| "privateLabel"
-| "visa"
-| "vPay";
-
-declare type ApplePayCardNetwork_2 = "amex" | "bancomat" | "bancontact" | "cartesBancaires" | "chinaUnionPay" | "dankort" | "discover" | "eftpos" | "electron" | "elo" | "girocard" | "interac" | "jcb" | "mada" | "maestro" | "masterCard" | "mir" | "privateLabel" | "visa" | "vPay";
+declare type ApplePayCardNetwork = "amex" | "bancomat" | "bancontact" | "cartesBancaires" | "chinaUnionPay" | "dankort" | "discover" | "eftpos" | "electron" | "elo" | "girocard" | "interac" | "jcb" | "mada" | "maestro" | "masterCard" | "mir" | "privateLabel" | "visa" | "vPay";
 
 declare interface ApplePayErrorMessage {
     message: string;
 }
 
 declare interface ApplePayEvents {
-    ready: () => void;
-    success: () => void;
-    error: (error: string) => void;
-    cancel: () => void;
-}
-
-declare interface ApplePayEvents_2 {
     success: () => void;
     error: (message?: string) => void;
     cancel: () => void;
 }
 
-declare interface ApplePayOptions {
-    process: (
-    data: EncryptedApplePayData,
-    helpers: {
-        fail: (error: ApplePayErrorMessage) => void;
-    }
-    ) => Promise<void>;
-    type?: ApplePayButtonType;
-    style?: ApplePayButtonStyle;
-    locale?: ApplePayButtonLocale;
-    padding?: string;
-    borderRadius?: number;
-    size?: { width: WalletDimension; height: WalletDimension };
-    allowedCardNetworks?: ApplePayCardNetwork[];
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    paymentOverrides?: {
-        paymentMethodData?: PaymentMethodData[];
-        paymentDetails?: PaymentDetailsInit;
-    };
-    disbursementOverrides?: {
-        disbursementDetails?: PaymentDetailsInit;
-    };
-    requestPayerDetails?: ("name" | "email" | "phone")[];
-}
-
 declare interface BaseTransactionDetails {
     amount: number;
     currency: string;
@@ -239,6 +113,7 @@ declare class Card {
             } | undefined;
             autoProgress: boolean | undefined;
             redactCVC: boolean | undefined;
+            allow3DigitAmexCVC: boolean | undefined;
         };
     };
     mount(selector: SelectorType): this;
@@ -262,7 +137,8 @@ declare type CardBrandName =
 | "hipercard"
 | "hiper"
 | "szep"
-| "uatp";
+| "uatp"
+| "rupay";
 
 declare interface CardEvents {
     ready: () => void;
@@ -303,6 +179,7 @@ declare interface CardOptions {
     translations?: Partial<CardTranslations>;
     autoProgress?: boolean;
     redactCVC?: boolean;
+    allow3DigitAmexCVC?: boolean;
     defaultValues?: {
         name?: string;
     };
@@ -926,6 +803,8 @@ declare interface EncryptedDPAN<P> {
     token: PaymentToken<P>;
     card: {
         brand: string;
+        lastFour?: string;
+        displayName?: string;
     };
     cryptogram: string;
     eci: string;
@@ -935,6 +814,8 @@ declare interface EncryptedFPAN {
     card: {
         brand: string;
         number: string;
+        lastFour?: string;
+        displayName?: string;
         expiry: {
             month: string;
             year: string;
@@ -942,7 +823,12 @@ declare interface EncryptedFPAN {
     };
 }
 
-declare type EncryptedGooglePayData = EncryptedDPAN<"google"> | EncryptedFPAN;
+declare type EncryptedGooglePayData = (
+| EncryptedDPAN<"google">
+| EncryptedFPAN
+) & {
+    billingAddress?: google.payments.api.Address | null;
+};
 
 declare const encryptionConstants: {
     cipherAlgorithm: "aes-256-gcm";
@@ -1044,7 +930,7 @@ declare class EvervaultClient {
     }>;
     isInDebugMode(): boolean;
     get transactions(): {
-        create: (details: CreateTransactionDetails | DisbursementTransactionDetails) => Transaction;
+        create: (details: CreateTransactionDetails | RecurringTransactionDetails | DisbursementTransactionDetails) => Transaction;
     };
 }
 
@@ -1115,6 +1001,7 @@ declare class GooglePay {
             borderRadius: number | undefined;
             allowedAuthMethods: google.payments.api.CardAuthMethod[] | undefined;
             allowedCardNetworks: google.payments.api.CardNetwork[] | undefined;
+            billingAddress: GooglePayBillingAddressConfig | undefined;
         };
     };
     mount(selector: SelectorType): this;
@@ -1122,6 +1009,13 @@ declare class GooglePay {
     on<T extends keyof GooglePayEvents>(event: T, callback: GooglePayEvents[T]): () => void;
 }
 
+declare type GooglePayBillingAddressConfig =
+| boolean
+| {
+    format?: google.payments.api.BillingAddressFormat;
+    phoneNumber?: boolean;
+};
+
 declare type GooglePayButtonColor = "black" | "white";
 
 declare type GooglePayButtonLocale =
@@ -1194,6 +1088,7 @@ declare interface GooglePayOptions {
     size?: { width: WalletDimension; height: WalletDimension };
     allowedAuthMethods?: google.payments.api.CardAuthMethod[];
     allowedCardNetworks?: google.payments.api.CardNetwork[];
+    billingAddress?: GooglePayBillingAddressConfig;
 }
 
 declare interface HttpConfig {
@@ -4340,6 +4235,19 @@ declare namespace Property {
     type VectorEffect = Globals | "non-scaling-stroke" | "none";
 }
 
+declare interface RecurringTransactionDetails extends BaseTransactionDetails {
+    type: "recurring";
+    managementURL: string;
+    billingAgreement: string;
+    description: string;
+    regularBilling: TransactionLineItem & {
+        recurringPaymentStartDate: Date;
+    };
+    trialBilling?: TransactionLineItem & {
+        trialPaymentStartDate: Date;
+    };
+}
+
 declare type RequiredRecipientDetail = "email" | "phone" | "name" | "address";
 
 declare class Reveal {
@@ -4422,6 +4330,19 @@ declare type SdkContext = "inputs" | "default";
 
 declare type SelectorType = string | HTMLElement;
 
+declare interface ShippingAddress {
+    addressLine: string[];
+    city: string;
+    country: string;
+    dependentLocality: string;
+    organization: string;
+    phone: string;
+    postalCode: string;
+    recipient: string;
+    region: string;
+    sortingCode: string;
+}
+
 declare interface StandardLonghandProperties<TLength = (string & {}) | 0, TTime = string & {}> {
     /**
      * The **`accent-color`** CSS property sets the accent color for user-interface controls generated by some elements.
@@ -10428,11 +10349,12 @@ declare interface ThreeDSecureOptions {
 
 declare class Transaction {
     details: TransactionDetailsWithDomain;
-    constructor(details: CreateTransactionDetails | DisbursementTransactionDetails);
+    constructor(details: CreateTransactionDetails | RecurringTransactionDetails | DisbursementTransactionDetails);
 }
 
 declare type TransactionDetails =
 | PaymentTransactionDetails
+| RecurringTransactionDetails
 | DisbursementTransactionDetails;
 
 declare type TransactionDetailsWithDomain = TransactionDetails & {
@@ -10458,7 +10380,10 @@ declare class UIComponents {
     form(opts?: FormOptions): Form;
     threeDSecure(session: string, opts?: ThreeDSecureOptions): ThreeDSecure;
     googlePay(tx: Transaction, opts: GooglePayOptions): GooglePay;
-    applePay(tx: Transaction, opts: ApplePayOptions): ApplePay;
+    applePay(tx: Transaction, opts: ApplePayButtonOptions): ApplePayButton;
+    /**
+     * @deprecated Use `applePay` instead.
+     */
     applePayButton(tx: Transaction, opts: ApplePayButtonOptions): ApplePayButton;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@evervault/js",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "Evervault.js loader for client-side browser applications",
   "license": "MIT",
   "type": "module",
@@ -20,10 +20,10 @@
     "typescript": "5.5.4",
     "vite": "^5.4.11",
     "vite-plugin-dts": "^4.3.0",
-    "@evervault/browser": "2.42.3",
+    "themes": "0.1.16",
     "tsconfig": "0.1.0",
-    "types": "0.13.0",
-    "themes": "0.1.13"
+    "types": "0.16.0",
+    "@evervault/browser": "2.46.0"
   },
   "scripts": {
     "build": "vite build",
@@ -34,6 +34,6 @@
     "lint:fix": "eslint --fix .",
     "preinstall": "npx only-allow pnpm",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf .turbo node_modules dist"
+    "clean": "rm -rf node_modules dist"
   }
 }