@flopay/react 0.4.3 → 0.4.5

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import React from 'react';
 import { FloPay, FloPayElements } from '@flopay/js';
 import * as _flopay_shared from '@flopay/shared';
-import { FloPayAppearance, InlineSessionDraft, FloPayError, PaymentResult, DeclineEvent, CheckoutButtonMethod, BeforeButtonClickEvent, InlineSessionPatch, CheckoutMode, CheckoutSession, ElementOptions, ElementChangeEvent, TokenizedBody } from '@flopay/shared';
+import { FloPayAppearance, InlineSessionDraft, FloPayError, PaymentResult, DeclineEvent, CheckoutButtonMethod, BeforeButtonClickEvent, InlineSessionPatch, CheckoutMode, CheckoutSession, ElementOptions, ElementChangeEvent, TokenizedBody, CheckoutItem, CheckoutSubscription, ButtonsLayoutTheme, ButtonsLayoutStyles } from '@flopay/shared';
 export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, InlineSessionDraft, InlineSessionPatch } from '@flopay/shared';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** Props for the `FloPayProvider` component. */
 interface FloPayProviderProps {
@@ -102,6 +103,8 @@ interface FloPayCheckoutProps {
     cardBackButtonContent?: React.ReactNode;
     /** Custom React content rendered for the card-form title. */
     cardTitleContent?: React.ReactNode;
+    /** Whether to show the default security footer in `layout="default"`. Defaults to `true`. */
+    showSecurityFooter?: boolean;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
@@ -125,6 +128,8 @@ interface FloPayCheckoutProps {
     submitLabel?: string;
     /** Additional CSS class for the wrapper. */
     className?: string;
+    /** Seed an initial checkout error message for the rendered payment form. */
+    initialErrorMessage?: string | null;
     /**
      * Override the default `SplitCardForm`. When provided, children are rendered
      * inside the initialized `FloPayProvider` with session props auto-injected.
@@ -164,7 +169,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -425,6 +430,8 @@ interface SplitCardFormProps {
     cardBackButtonContent?: React.ReactNode;
     /** Custom React content rendered for the card-form title. */
     cardTitleContent?: React.ReactNode;
+    /** Whether to show the default security footer in `layout="default"`. Defaults to `true`. */
+    showSecurityFooter?: boolean;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
@@ -521,4 +528,35 @@ interface PayPalButtonProps {
  */
 declare function PayPalButton({ sessionId, billingApiUrl, email, userId, firstName, lastName, chv, onTokenizedBody, onComplete, onErrorChange, isProcessing, }: PayPalButtonProps): React.ReactElement;
 
-export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };
+interface FloPayAutomaticPaymentSuccessEvent {
+    result: PaymentResult;
+    session: CheckoutSession | null;
+    sessionId: string | null;
+    autoCompleted: boolean;
+}
+interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'onError'> {
+    sessionId?: string;
+    createSession?: InlineSessionDraft;
+    paymentMethodId?: string;
+    clientId?: string;
+    items?: CheckoutItem[];
+    subscriptions?: CheckoutSubscription[];
+    account?: InlineSessionDraft['account'];
+    successUrl?: string;
+    cancelUrl?: string;
+    couponCodes?: string[];
+    tagsData?: InlineSessionDraft['tagsData'];
+    utmMetadata?: InlineSessionDraft['utmMetadata'];
+    billingApiUrl?: string;
+    locale?: string;
+    fallbackPublishableKey?: string;
+    buttonsTheme?: ButtonsLayoutTheme;
+    buttonsStyles?: ButtonsLayoutStyles;
+    onSuccess?: (event: FloPayAutomaticPaymentSuccessEvent) => void;
+    onError?: (error: FloPayError) => void;
+    onDecline?: (decline: DeclineEvent) => void;
+    children?: React.ReactNode;
+}
+declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, fallbackPublishableKey, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
+
+export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
 import { FloPay, FloPayElements } from '@flopay/js';
 import * as _flopay_shared from '@flopay/shared';
-import { FloPayAppearance, InlineSessionDraft, FloPayError, PaymentResult, DeclineEvent, CheckoutButtonMethod, BeforeButtonClickEvent, InlineSessionPatch, CheckoutMode, CheckoutSession, ElementOptions, ElementChangeEvent, TokenizedBody } from '@flopay/shared';
+import { FloPayAppearance, InlineSessionDraft, FloPayError, PaymentResult, DeclineEvent, CheckoutButtonMethod, BeforeButtonClickEvent, InlineSessionPatch, CheckoutMode, CheckoutSession, ElementOptions, ElementChangeEvent, TokenizedBody, CheckoutItem, CheckoutSubscription, ButtonsLayoutTheme, ButtonsLayoutStyles } from '@flopay/shared';
 export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, InlineSessionDraft, InlineSessionPatch } from '@flopay/shared';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** Props for the `FloPayProvider` component. */
 interface FloPayProviderProps {
@@ -102,6 +103,8 @@ interface FloPayCheckoutProps {
     cardBackButtonContent?: React.ReactNode;
     /** Custom React content rendered for the card-form title. */
     cardTitleContent?: React.ReactNode;
+    /** Whether to show the default security footer in `layout="default"`. Defaults to `true`. */
+    showSecurityFooter?: boolean;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
@@ -125,6 +128,8 @@ interface FloPayCheckoutProps {
     submitLabel?: string;
     /** Additional CSS class for the wrapper. */
     className?: string;
+    /** Seed an initial checkout error message for the rendered payment form. */
+    initialErrorMessage?: string | null;
     /**
      * Override the default `SplitCardForm`. When provided, children are rendered
      * inside the initialized `FloPayProvider` with session props auto-injected.
@@ -164,7 +169,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -425,6 +430,8 @@ interface SplitCardFormProps {
     cardBackButtonContent?: React.ReactNode;
     /** Custom React content rendered for the card-form title. */
     cardTitleContent?: React.ReactNode;
+    /** Whether to show the default security footer in `layout="default"`. Defaults to `true`. */
+    showSecurityFooter?: boolean;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
@@ -521,4 +528,35 @@ interface PayPalButtonProps {
  */
 declare function PayPalButton({ sessionId, billingApiUrl, email, userId, firstName, lastName, chv, onTokenizedBody, onComplete, onErrorChange, isProcessing, }: PayPalButtonProps): React.ReactElement;
 
-export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };
+interface FloPayAutomaticPaymentSuccessEvent {
+    result: PaymentResult;
+    session: CheckoutSession | null;
+    sessionId: string | null;
+    autoCompleted: boolean;
+}
+interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'onError'> {
+    sessionId?: string;
+    createSession?: InlineSessionDraft;
+    paymentMethodId?: string;
+    clientId?: string;
+    items?: CheckoutItem[];
+    subscriptions?: CheckoutSubscription[];
+    account?: InlineSessionDraft['account'];
+    successUrl?: string;
+    cancelUrl?: string;
+    couponCodes?: string[];
+    tagsData?: InlineSessionDraft['tagsData'];
+    utmMetadata?: InlineSessionDraft['utmMetadata'];
+    billingApiUrl?: string;
+    locale?: string;
+    fallbackPublishableKey?: string;
+    buttonsTheme?: ButtonsLayoutTheme;
+    buttonsStyles?: ButtonsLayoutStyles;
+    onSuccess?: (event: FloPayAutomaticPaymentSuccessEvent) => void;
+    onError?: (error: FloPayError) => void;
+    onDecline?: (decline: DeclineEvent) => void;
+    children?: React.ReactNode;
+}
+declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, fallbackPublishableKey, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
+
+export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };