@flopay/react 1.3.4 → 1.4.0

package/dist/index.d.cts

@@ -66,6 +66,8 @@ interface FloPayCheckoutProps {
     createSession?: InlineSessionDraft;
     /** Billing API base URL. Defaults to the shared `BILLING_API_URL` constant. */
     billingApiUrl?: string;
+    /** Flo-owned privacy-safe telemetry is enabled by default; set `false` to opt out. */
+    telemetry?: boolean;
     /** Visual appearance for payment elements. */
     appearance?: FloPayAppearance;
     /** Locale for payment elements (default: 'auto'). */
@@ -233,7 +235,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, nonce: nonceProp, createSession: createSessionParams, billingApiUrl, appearance: appearanceOverride, locale, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showStripe, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, 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, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showStripe, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -879,6 +881,8 @@ interface DirectPayPalButtonProps {
      * binding takes effect (PayPal's render() options aren't live-updatable).
      */
     existingOrderId?: string;
+    /** Flo-owned privacy-safe telemetry is enabled by default; set `false` to opt out. */
+    telemetry?: boolean;
     /**
      * When true, renders an on-screen lifecycle tracer panel above the button
      * (mount, loadScript, eligibility, render, errors). Intended for debugging
@@ -887,15 +891,8 @@ interface DirectPayPalButtonProps {
      */
     debug?: boolean;
 }
-/**
- * Direct PayPal renderer powered by the official PayPal JS SDK.
- *
- * Renders inside Facebook / Instagram / Meta in-app browsers where Stripe's
- * PayPal ExpressCheckoutElement breaks. Selection between this and the Stripe-
- * rendered PayPal happens at the caller site based on whether the session
- * advertises `gateways.paypal.publishableKey`.
- */
-declare function DirectPayPalButton({ sessionId, nonce, billingApiUrl, email, clientId, environment, currency, isSubscription, onTokenizedBody, onComplete, onErrorChange, onDecline, onTechnicalFailure, isProcessing, onLoadStateChange, onButtonClick, runBeforeButtonClick, session, existingOrderId, debug, }: DirectPayPalButtonProps): React.ReactElement | null;
+/** Public direct-PayPal surface: telemetry accepts only the boolean opt-out. */
+declare function DirectPayPalButton(props: DirectPayPalButtonProps): React.ReactElement | null;
 
 interface FloPayAutomaticPaymentSuccessEvent {
     result: PaymentResult;

package/dist/index.d.ts

@@ -66,6 +66,8 @@ interface FloPayCheckoutProps {
     createSession?: InlineSessionDraft;
     /** Billing API base URL. Defaults to the shared `BILLING_API_URL` constant. */
     billingApiUrl?: string;
+    /** Flo-owned privacy-safe telemetry is enabled by default; set `false` to opt out. */
+    telemetry?: boolean;
     /** Visual appearance for payment elements. */
     appearance?: FloPayAppearance;
     /** Locale for payment elements (default: 'auto'). */
@@ -233,7 +235,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, nonce: nonceProp, createSession: createSessionParams, billingApiUrl, appearance: appearanceOverride, locale, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showStripe, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, 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, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showStripe, showApplePay, showGooglePay, debug, layout, theme, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter: _showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, cardFieldOrder, cardPreFormSlot, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -879,6 +881,8 @@ interface DirectPayPalButtonProps {
      * binding takes effect (PayPal's render() options aren't live-updatable).
      */
     existingOrderId?: string;
+    /** Flo-owned privacy-safe telemetry is enabled by default; set `false` to opt out. */
+    telemetry?: boolean;
     /**
      * When true, renders an on-screen lifecycle tracer panel above the button
      * (mount, loadScript, eligibility, render, errors). Intended for debugging
@@ -887,15 +891,8 @@ interface DirectPayPalButtonProps {
      */
     debug?: boolean;
 }
-/**
- * Direct PayPal renderer powered by the official PayPal JS SDK.
- *
- * Renders inside Facebook / Instagram / Meta in-app browsers where Stripe's
- * PayPal ExpressCheckoutElement breaks. Selection between this and the Stripe-
- * rendered PayPal happens at the caller site based on whether the session
- * advertises `gateways.paypal.publishableKey`.
- */
-declare function DirectPayPalButton({ sessionId, nonce, billingApiUrl, email, clientId, environment, currency, isSubscription, onTokenizedBody, onComplete, onErrorChange, onDecline, onTechnicalFailure, isProcessing, onLoadStateChange, onButtonClick, runBeforeButtonClick, session, existingOrderId, debug, }: DirectPayPalButtonProps): React.ReactElement | null;
+/** Public direct-PayPal surface: telemetry accepts only the boolean opt-out. */
+declare function DirectPayPalButton(props: DirectPayPalButtonProps): React.ReactElement | null;
 
 interface FloPayAutomaticPaymentSuccessEvent {
     result: PaymentResult;