@flopay/react 1.9.9 → 1.9.11

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _flopay_shared from '@flopay/shared';
-import { InlineSessionDraft, CheckoutButtonMethod, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, FloPayAppearance, ButtonsLayoutTheme, ButtonsLayoutStyles, PaymentResult, CheckoutSession, FloPayError, DeclineEvent, InlineSessionPatch, GatewayEnvironment, PayPalProviderObjectType, TokenizedBody, FloInstrumentEvent, BeforeButtonClickEvent, CheckoutMode, AVSFieldConfig, CardCaptureAdapter, VaultCardThemeColors } 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 React from 'react';
 export { FloPayCardSetup, FloPayCardSetupCancelEvent, FloPayCardSetupCompleteEvent, FloPayCardSetupDeclineEvent, FloPayCardSetupError, FloPayCardSetupProps } from './card-setup-entry.cjs';
@@ -153,6 +153,11 @@ interface DirectPayPalButtonProps {
      * sessions continue to derive the flow from `isSubscription`.
      */
     providerObjectType?: PayPalProviderObjectType;
+    /**
+     * Backend-advertised approval presentation. The backing session value is
+     * authoritative when both are supplied. No return URL can be provided here.
+     */
+    approvalPresentation?: PayPalApprovalPresentation;
     /**
      * If provided, called with the tokenized body once PayPal capture
      * completes. When omitted, the component processes payment internally.
@@ -453,7 +458,7 @@ declare function useCheckout(): CheckoutState;
 /** Props for the `FloPayProvider` component. */
 interface FloPayProviderProps {
     /** A `FloPay` instance or a promise that resolves to one (from `loadFloPay()`). */
-    flopay: Promise<FloPay> | FloPay;
+    flopay: Promise<FloPay> | FloPay | null;
     /**
      * Optional Stripe `FloPay` instance used to drive the Stripe-rendered PayPal
      * fallback. When omitted or `null`, the Stripe-rendered PayPal button is
@@ -502,6 +507,8 @@ interface SplitCardFormProps {
     nonce?: string;
     /** Billing API base URL. Optional — defaults to the value from FloPayProvider or the shared constant. */
     billingApiUrl?: string;
+    /** Flo-owned privacy-safe telemetry is enabled by default; set false to opt out. */
+    telemetry?: boolean;
     /** User's email (required for creating payment intents). */
     email?: string;
     /** User ID (required for processing payments). */
@@ -704,6 +711,8 @@ interface SplitCardFormProps {
          * Retained as a fallback for integrations that do not supply a session.
          */
         providerObjectType?: PayPalProviderObjectType;
+        /** Backend-advertised non-popup presentation for one-time PayPal Orders. */
+        approvalPresentation?: _flopay_shared.PayPalApprovalPresentation;
     };
     /** Whether the active session represents a subscription (drives direct PayPal intent). */
     isSubscription?: boolean;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _flopay_shared from '@flopay/shared';
-import { InlineSessionDraft, CheckoutButtonMethod, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, FloPayAppearance, ButtonsLayoutTheme, ButtonsLayoutStyles, PaymentResult, CheckoutSession, FloPayError, DeclineEvent, InlineSessionPatch, GatewayEnvironment, PayPalProviderObjectType, TokenizedBody, FloInstrumentEvent, BeforeButtonClickEvent, CheckoutMode, AVSFieldConfig, CardCaptureAdapter, VaultCardThemeColors } 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 React from 'react';
 export { FloPayCardSetup, FloPayCardSetupCancelEvent, FloPayCardSetupCompleteEvent, FloPayCardSetupDeclineEvent, FloPayCardSetupError, FloPayCardSetupProps } from './card-setup-entry.js';
@@ -153,6 +153,11 @@ interface DirectPayPalButtonProps {
      * sessions continue to derive the flow from `isSubscription`.
      */
     providerObjectType?: PayPalProviderObjectType;
+    /**
+     * Backend-advertised approval presentation. The backing session value is
+     * authoritative when both are supplied. No return URL can be provided here.
+     */
+    approvalPresentation?: PayPalApprovalPresentation;
     /**
      * If provided, called with the tokenized body once PayPal capture
      * completes. When omitted, the component processes payment internally.
@@ -453,7 +458,7 @@ declare function useCheckout(): CheckoutState;
 /** Props for the `FloPayProvider` component. */
 interface FloPayProviderProps {
     /** A `FloPay` instance or a promise that resolves to one (from `loadFloPay()`). */
-    flopay: Promise<FloPay> | FloPay;
+    flopay: Promise<FloPay> | FloPay | null;
     /**
      * Optional Stripe `FloPay` instance used to drive the Stripe-rendered PayPal
      * fallback. When omitted or `null`, the Stripe-rendered PayPal button is
@@ -502,6 +507,8 @@ interface SplitCardFormProps {
     nonce?: string;
     /** Billing API base URL. Optional — defaults to the value from FloPayProvider or the shared constant. */
     billingApiUrl?: string;
+    /** Flo-owned privacy-safe telemetry is enabled by default; set false to opt out. */
+    telemetry?: boolean;
     /** User's email (required for creating payment intents). */
     email?: string;
     /** User ID (required for processing payments). */
@@ -704,6 +711,8 @@ interface SplitCardFormProps {
          * Retained as a fallback for integrations that do not supply a session.
          */
         providerObjectType?: PayPalProviderObjectType;
+        /** Backend-advertised non-popup presentation for one-time PayPal Orders. */
+        approvalPresentation?: _flopay_shared.PayPalApprovalPresentation;
     };
     /** Whether the active session represents a subscription (drives direct PayPal intent). */
     isSubscription?: boolean;