@funnelfox/billing 0.9.3-feat-defer-session-on-interaction.34 → 0.10.0

package/src/types.d.ts

@@ -74,40 +74,10 @@ export interface BillingCardOptions extends CheckoutCardOptions {
   emailAddress?: BillingCardEmailAddressOptions;
 }
 
-/**
- * Apple Pay button types (https://developer.apple.com/documentation/applepayontheweb/applepaybuttontype).
- *
- * The legacy 7 values (Primer's union) render through Primer's CSS approach.
- * The newer values (e.g. 'continue') cannot be rendered by WebKit via CSS, so
- * the SDK overlays Apple's official <apple-pay-button> element on top of the
- * Primer button and forwards clicks (see utils/apple-pay-native-button.ts,
- * PRD-1426). Payment flow stays fully Primer-driven either way.
- */
-export type ApplePayButtonType =
-  | NonNullable<ApplePayOptions['buttonType']>
-  | 'add-money'
-  | 'continue'
-  | 'contribute'
-  | 'order'
-  | 'pay'
-  | 'reload'
-  | 'rent'
-  | 'support'
-  | 'tip'
-  | 'top-up';
-
-export type BillingApplePayOptions = Omit<
-  ApplePayOptions,
-  'container' | 'buttonType'
-> & {
-  buttonType?: ApplePayButtonType;
-};
-
 export interface PrimerCheckoutConfig extends Pick<
   Partial<HeadlessUniversalCheckoutOptions>,
-  'paypal' | 'googlePay' | 'style'
+  'paypal' | 'applePay' | 'googlePay' | 'style'
 > {
-  applePay?: BillingApplePayOptions;
   card?: BillingCardOptions;
   cardSelectors?: CardInputSelectors;
   paymentButtonSelectors?: PaymentButtonSelectors;
@@ -123,29 +93,27 @@ export interface CheckoutConfig extends PrimerCheckoutConfig {
   enableTax?: boolean;
   onTaxChange?: (info: TaxInfo) => void;
   onTaxError?: (error: Error) => void;
-  /** See InitMethodOptions.sessionCreation. Wallet buttons only. */
-  sessionCreation?: SessionCreationMode;
+  onTaxPending?: () => void;
 }
 
 export interface TaxInfo {
   /** Minor units; the total the customer pays. */
   amountTotal: number;
-  /** Minor units; tax ADDED on top of the price — 0 for tax-inclusive pricing and non-taxed locations. */
+  /** Minor units; the tax to show the buyer — added on top when exclusive, already inside the price when inclusive, 0 when unknown. */
   taxAmount: number;
   currency: string;
+  taxBehavior?: TaxBehavior;
 }
 
+export type TaxBehavior = 'inclusive' | 'exclusive';
+
 export interface PaymentButtonSelectors {
   paypal: string;
   googlePay: string;
   applePay: string;
 }
 
-export interface CheckoutOptions extends Omit<
-  Partial<HeadlessUniversalCheckoutOptions>,
-  'applePay'
-> {
-  applePay?: BillingApplePayOptions;
+export interface CheckoutOptions extends Partial<HeadlessUniversalCheckoutOptions> {
   onTokenizeSuccess: OnTokenizeSuccess;
   onResumeSuccess: OnResumeSuccess;
   onAvailablePaymentMethodsLoad?: (items: PaymentMethod[]) => void;
@@ -300,6 +268,8 @@ export interface APIError extends FunnefoxSDKError {
   errorType: string | null;
   requestId: string | null;
   response: unknown;
+  declineCode: string | null;
+  declineCodeSource: DeclineCodeSource | null;
 }
 
 export interface PrimerError extends FunnefoxSDKError {
@@ -386,13 +356,12 @@ export interface InitMethodOptions
       Partial<
         Pick<
           HeadlessUniversalCheckoutOptions,
-          'style' | 'card' | 'paypal' | 'googlePay'
+          'style' | 'card' | 'applePay' | 'paypal' | 'googlePay'
         >
       >,
       'card'
     >,
     InitMethodCallbacks {
-  applePay?: BillingApplePayOptions;
   card?: BillingCardOptions;
   orgId: string;
   baseUrl?: string;
@@ -400,29 +369,28 @@ export interface InitMethodOptions
   externalId: string;
   email?: string;
   meta?: MetadataType;
-  /**
-   * When to create the client session for wallet buttons.
-   * 'onMount' (default) creates it immediately — one session per page render.
-   * 'onInteraction' renders Apple's native button first and creates the
-   * session on the visitor's first interaction, so bounced and prerendered
-   * views cost nothing. Requires a native-only Apple Pay buttonType; falls
-   * back to 'onMount' when Apple's SDK is unavailable.
-   */
-  sessionCreation?: SessionCreationMode;
 }
 
-export type SessionCreationMode = 'onMount' | 'onInteraction';
+export type DeclineCodeSource = ('primer' | 'stripe' | 'adyen') | (string & {});
+
+export type PaymentFailure = Error & {
+  declineCode?: string | null;
+  declineCodeSource?: DeclineCodeSource | null;
+};
 
 export interface InitMethodCallbacks {
   onRenderSuccess?: () => void;
   onRenderError?: (err: PaymentMethod) => void;
   onPaymentSuccess?: () => void;
-  onPaymentFail?: (err: Error) => void;
+  onPaymentFail?: (err: PaymentFailure) => void;
   onPaymentCancel?: () => void;
   onErrorMessageChange?: (msg: string) => void;
   onLoaderChange?: (state: boolean) => void;
   onPaymentStarted?: (method: PaymentMethod) => void;
   onMethodsAvailable?: (methods: PaymentMethod[]) => void;
+  onTaxChange?: (info: TaxInfo) => void;
+  onTaxError?: (error: Error) => void;
+  onTaxPending?: () => void;
 }
 
 export declare function initMethod(
@@ -448,7 +416,7 @@ export declare function getAvailablePaymentMethods(params: {
 export interface StripeCardFormOptions
   extends
     CreateClientSessionOptions,
-    Omit<InitMethodCallbacks, 'onPaymentSuccess'> {
+    Omit<InitMethodCallbacks, 'onPaymentSuccess' | 'onTaxPending'> {
   onPaymentSuccess?: (
     paymentMethod: import('@stripe/stripe-js').PaymentMethod,
     orderId: string
@@ -465,12 +433,16 @@ export interface StripeCardFormOptions
 export interface StripeWalletOptions
   extends
     CreateClientSessionOptions,
-    Omit<InitMethodCallbacks, 'onPaymentSuccess'> {
+    Omit<
+      InitMethodCallbacks,
+      'onPaymentSuccess' | 'onTaxPending' | 'onTaxError'
+    > {
   onPaymentSuccess?: (
     paymentMethod: import('@stripe/stripe-js').PaymentMethod,
     orderId: string
   ) => void;
   totalLabel?: string;
+  onTaxChange?: (info: TaxInfo) => void;
 }
 
 export interface StripeCardForm {
@@ -584,6 +556,8 @@ export interface CreateClientSessionResponse {
     // Session tax estimate (detected-country) in minor units — for showing tax on mount and in the
     // wallet sheet, and (Stripe-direct) collecting it via the wallet.
     tax_amount?: number;
+    tax_inclusive_amount?: number;
+    tax_behavior?: TaxBehavior;
     amount_total?: number;
     currency?: string;
     tax_calculation_id?: string;
@@ -611,6 +585,8 @@ export interface TaxRecalculationData {
   tax_calculation_id: string;
   amount_total: number;
   tax_amount: number;
+  tax_inclusive_amount?: number;
+  tax_behavior?: TaxBehavior;
   currency: string;
 }
 
@@ -629,6 +605,8 @@ export interface PaymentResponseData {
   action_required_token: string;
   checkout_status: 'processing' | 'succeeded' | 'failed' | 'cancelled';
   failed_message_for_user: string;
+  decline_code?: string | null;
+  decline_code_source?: DeclineCodeSource | null;
   order_id: string;
 }