@funnelfox/billing 0.10.0 → 0.11.0

package/src/types.d.ts

@@ -74,10 +74,40 @@ 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' | 'applePay' | 'googlePay' | 'style'
+  'paypal' | 'googlePay' | 'style'
 > {
+  applePay?: BillingApplePayOptions;
   card?: BillingCardOptions;
   cardSelectors?: CardInputSelectors;
   paymentButtonSelectors?: PaymentButtonSelectors;
@@ -103,17 +133,43 @@ export interface TaxInfo {
   taxAmount: number;
   currency: string;
   taxBehavior?: TaxBehavior;
+  taxRate?: number;
+  taxBreakdown?: TaxBreakdownEntry[];
 }
 
 export type TaxBehavior = 'inclusive' | 'exclusive';
 
+export interface TaxBreakdownEntry {
+  amount: string;
+  percentage: string;
+  inclusive: boolean;
+  taxType?: string | null;
+  country?: string | null;
+  subdivision?: string | null;
+  taxabilityReason?: string | null;
+}
+
+export interface TaxBreakdownEntryResponse {
+  amount: string;
+  percentage: string;
+  inclusive: boolean;
+  tax_type?: string | null;
+  country?: string | null;
+  subdivision?: string | null;
+  taxability_reason?: string | null;
+}
+
 export interface PaymentButtonSelectors {
   paypal: string;
   googlePay: string;
   applePay: string;
 }
 
-export interface CheckoutOptions extends Partial<HeadlessUniversalCheckoutOptions> {
+export interface CheckoutOptions extends Omit<
+  Partial<HeadlessUniversalCheckoutOptions>,
+  'applePay'
+> {
+  applePay?: BillingApplePayOptions;
   onTokenizeSuccess: OnTokenizeSuccess;
   onResumeSuccess: OnResumeSuccess;
   onAvailablePaymentMethodsLoad?: (items: PaymentMethod[]) => void;
@@ -356,12 +412,13 @@ export interface InitMethodOptions
       Partial<
         Pick<
           HeadlessUniversalCheckoutOptions,
-          'style' | 'card' | 'applePay' | 'paypal' | 'googlePay'
+          'style' | 'card' | 'paypal' | 'googlePay'
         >
       >,
       'card'
     >,
     InitMethodCallbacks {
+  applePay?: BillingApplePayOptions;
   card?: BillingCardOptions;
   orgId: string;
   baseUrl?: string;
@@ -558,6 +615,7 @@ export interface CreateClientSessionResponse {
     tax_amount?: number;
     tax_inclusive_amount?: number;
     tax_behavior?: TaxBehavior;
+    tax_breakdown?: TaxBreakdownEntryResponse[];
     amount_total?: number;
     currency?: string;
     tax_calculation_id?: string;
@@ -587,6 +645,7 @@ export interface TaxRecalculationData {
   tax_amount: number;
   tax_inclusive_amount?: number;
   tax_behavior?: TaxBehavior;
+  tax_breakdown?: TaxBreakdownEntryResponse[];
   currency: string;
 }