@flopay/react 1.9.21 → 1.9.24

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as _flopay_shared from '@flopay/shared';
-import { InlineSessionDraft, CheckoutButtonMethod, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, FloPayAppearance, ButtonsLayoutTheme, ButtonsLayoutStyles, PaymentResult, CheckoutSession, FloPayError, DeclineEvent, InlineSessionPatch, GatewayEnvironment, PayPalProviderObjectType, PayPalApprovalPresentation, TokenizedBody, FloInstrumentEvent, BeforeButtonClickEvent, CheckoutMode, AVSFieldConfig, CardCaptureAdapter, VaultCardThemeColors } from '@flopay/shared';
-export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, FloInstrumentEvent, InlineSessionDraft, InlineSessionPatch, SentryEventLike, SentryStackFrameLike, dropThirdPartyOnlyError } from '@flopay/shared';
+import { InlineSessionDraft, CheckoutButtonMethod, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, FloPayAppearance, ButtonsLayoutTheme, ButtonsLayoutStyles, PaymentResult, CheckoutSession, FloPayError, DeclineEvent, InlineSessionPatch, GatewayEnvironment, PayPalProviderObjectType, PayPalApprovalPresentation, TokenizedBody, TelemetryPresentationMode, TelemetryTerminalReason, FloInstrumentEvent, WalletPresentation, BeforeButtonClickEvent, CheckoutMode, AVSFieldConfig, CardCaptureAdapter, VaultCardThemeColors } from '@flopay/shared';
+export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, FloInstrumentEvent, InlineSessionDraft, InlineSessionPatch, SentryEventLike, SentryStackFrameLike, WalletPresentation, dropThirdPartyOnlyError } from '@flopay/shared';
 import React from 'react';
 export { FloPayCardSetup, FloPayCardSetupCancelEvent, FloPayCardSetupCompleteEvent, FloPayCardSetupDeclineEvent, FloPayCardSetupError, FloPayCardSetupProps } from './card-setup-entry.cjs';
 import { FloPay } from '@flopay/js';
@@ -116,10 +116,16 @@ interface DirectPayPalBeforeButtonClickResult {
  */
 type DirectPayPalRunBeforeButtonClick = (method: CheckoutButtonMethod) => Promise<DirectPayPalBeforeButtonClickResult>;
 type DirectPayPalInitializationState = 'loading' | 'retrying' | 'ready' | 'exhausted';
-type DirectPayPalTechnicalFailureHandler = (method: 'paypal', err: unknown, options?: {
+interface DirectPayPalTechnicalFailureOptions {
     code?: string;
     popupBlocked?: boolean;
-}) => void;
+    telemetryReported?: boolean;
+    provider?: 'paypal';
+    paymentMethodCategory?: 'paypal';
+    presentationMode?: TelemetryPresentationMode;
+    terminalReason?: TelemetryTerminalReason;
+}
+type DirectPayPalTechnicalFailureHandler = (method: 'paypal', err: unknown, options?: DirectPayPalTechnicalFailureOptions) => void;
 interface DirectPayPalButtonProps {
     /** Checkout session ID. */
     sessionId: string;
@@ -276,6 +282,11 @@ interface FloPayCheckoutProps {
      * bootstrap-time validation error.
      */
     showStripe?: boolean;
+    /**
+     * Preferred approval presentation for supported wallets. Defaults to
+     * `'auto'`. Safety signals and provider capability remain authoritative.
+     */
+    walletPresentation?: WalletPresentation;
     /**
      * Override the wallet/APM list the session advertises via
      * `gateways.stripe.enabledPaymentMethods`. Omit (the default) and the
@@ -443,7 +454,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, nonce: nonceProp, createSession: createSessionParams, billingApiUrl, telemetry, appearance: appearanceOverride, locale, loading: loadingNode, error: errorNode, onComplete, onError, onInstrument, onDecline, onCountryChange, onZipChange, showPayPal, showStripe, enabledPaymentMethods: enabledPaymentMethodsProp, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, initialPayPalOrderId, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, nonce: nonceProp, createSession: createSessionParams, billingApiUrl, telemetry, appearance: appearanceOverride, locale, loading: loadingNode, error: errorNode, onComplete, onError, onInstrument, onDecline, onCountryChange, onZipChange, showPayPal, showStripe, walletPresentation, enabledPaymentMethods: enabledPaymentMethodsProp, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, initialPayPalOrderId, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -591,6 +602,11 @@ interface SplitCardFormProps {
      * configured) throws a bootstrap-time validation error.
      */
     showStripe?: boolean;
+    /**
+     * Preferred approval presentation for supported wallets. Defaults to
+     * `'auto'`. Safety signals and provider capability remain authoritative.
+     */
+    walletPresentation?: WalletPresentation;
     /**
      * Per-session list of Stripe payment method type identifiers (as returned
      * by the billing API on `gateways.stripe.enabledPaymentMethods`). When

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _flopay_shared from '@flopay/shared';
-import { InlineSessionDraft, CheckoutButtonMethod, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, FloPayAppearance, ButtonsLayoutTheme, ButtonsLayoutStyles, PaymentResult, CheckoutSession, FloPayError, DeclineEvent, InlineSessionPatch, GatewayEnvironment, PayPalProviderObjectType, PayPalApprovalPresentation, TokenizedBody, FloInstrumentEvent, BeforeButtonClickEvent, CheckoutMode, AVSFieldConfig, CardCaptureAdapter, VaultCardThemeColors } from '@flopay/shared';
-export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, FloInstrumentEvent, InlineSessionDraft, InlineSessionPatch, SentryEventLike, SentryStackFrameLike, dropThirdPartyOnlyError } from '@flopay/shared';
+import { InlineSessionDraft, CheckoutButtonMethod, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, FloPayAppearance, ButtonsLayoutTheme, ButtonsLayoutStyles, PaymentResult, CheckoutSession, FloPayError, DeclineEvent, InlineSessionPatch, GatewayEnvironment, PayPalProviderObjectType, PayPalApprovalPresentation, TokenizedBody, TelemetryPresentationMode, TelemetryTerminalReason, FloInstrumentEvent, WalletPresentation, BeforeButtonClickEvent, CheckoutMode, AVSFieldConfig, CardCaptureAdapter, VaultCardThemeColors } from '@flopay/shared';
+export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, FloInstrumentEvent, InlineSessionDraft, InlineSessionPatch, SentryEventLike, SentryStackFrameLike, WalletPresentation, dropThirdPartyOnlyError } from '@flopay/shared';
 import React from 'react';
 export { FloPayCardSetup, FloPayCardSetupCancelEvent, FloPayCardSetupCompleteEvent, FloPayCardSetupDeclineEvent, FloPayCardSetupError, FloPayCardSetupProps } from './card-setup-entry.js';
 import { FloPay } from '@flopay/js';
@@ -116,10 +116,16 @@ interface DirectPayPalBeforeButtonClickResult {
  */
 type DirectPayPalRunBeforeButtonClick = (method: CheckoutButtonMethod) => Promise<DirectPayPalBeforeButtonClickResult>;
 type DirectPayPalInitializationState = 'loading' | 'retrying' | 'ready' | 'exhausted';
-type DirectPayPalTechnicalFailureHandler = (method: 'paypal', err: unknown, options?: {
+interface DirectPayPalTechnicalFailureOptions {
     code?: string;
     popupBlocked?: boolean;
-}) => void;
+    telemetryReported?: boolean;
+    provider?: 'paypal';
+    paymentMethodCategory?: 'paypal';
+    presentationMode?: TelemetryPresentationMode;
+    terminalReason?: TelemetryTerminalReason;
+}
+type DirectPayPalTechnicalFailureHandler = (method: 'paypal', err: unknown, options?: DirectPayPalTechnicalFailureOptions) => void;
 interface DirectPayPalButtonProps {
     /** Checkout session ID. */
     sessionId: string;
@@ -276,6 +282,11 @@ interface FloPayCheckoutProps {
      * bootstrap-time validation error.
      */
     showStripe?: boolean;
+    /**
+     * Preferred approval presentation for supported wallets. Defaults to
+     * `'auto'`. Safety signals and provider capability remain authoritative.
+     */
+    walletPresentation?: WalletPresentation;
     /**
      * Override the wallet/APM list the session advertises via
      * `gateways.stripe.enabledPaymentMethods`. Omit (the default) and the
@@ -443,7 +454,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, nonce: nonceProp, createSession: createSessionParams, billingApiUrl, telemetry, appearance: appearanceOverride, locale, loading: loadingNode, error: errorNode, onComplete, onError, onInstrument, onDecline, onCountryChange, onZipChange, showPayPal, showStripe, enabledPaymentMethods: enabledPaymentMethodsProp, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, initialPayPalOrderId, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, nonce: nonceProp, createSession: createSessionParams, billingApiUrl, telemetry, appearance: appearanceOverride, locale, loading: loadingNode, error: errorNode, onComplete, onError, onInstrument, onDecline, onCountryChange, onZipChange, showPayPal, showStripe, walletPresentation, enabledPaymentMethods: enabledPaymentMethodsProp, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, initialPayPalOrderId, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -591,6 +602,11 @@ interface SplitCardFormProps {
      * configured) throws a bootstrap-time validation error.
      */
     showStripe?: boolean;
+    /**
+     * Preferred approval presentation for supported wallets. Defaults to
+     * `'auto'`. Safety signals and provider capability remain authoritative.
+     */
+    walletPresentation?: WalletPresentation;
     /**
      * Per-session list of Stripe payment method type identifiers (as returned
      * by the billing API on `gateways.stripe.enabledPaymentMethods`). When