@flopay/react 1.8.1 → 1.8.3

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, GatewayEnvironment, PayPalProviderObjectType, TokenizedBody, InlineSessionPatch, 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, 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';
@@ -133,6 +133,10 @@ interface DirectPayPalButtonProps {
     billingApiUrl: string;
     /** Buyer email. */
     email?: string;
+    /** Buyer name already attached to the checkout, when available. */
+    billingName?: string;
+    /** Attaches buyer identity collected from PayPal before checkout continues. */
+    onBuyerIdentityReady?: (identity: NonNullable<InlineSessionPatch['account']>) => void | Promise<void>;
     /** PayPal client identifier (`gateways.paypal.publishableKey`). */
     clientId: string;
     /** Gateway environment, drives the sandbox/live SDK script. */
@@ -634,6 +638,11 @@ interface SplitCardFormProps {
      * Runs for card, PayPal, Apple Pay, and Google Pay.
      */
     onBeforeButtonClick?: (event: BeforeButtonClickEvent) => MaybePromise<undefined | false | InlineSessionPatch>;
+    /**
+     * Called after checkout collects a missing buyer email/name. FloPayCheckout
+     * uses this to claim an email-less detached session before payment continues.
+     */
+    onBuyerIdentityReady?: (identity: NonNullable<InlineSessionPatch['account']>) => MaybePromise<void>;
     /**
      * Enable AVS (Address Verification).
      * - `true` — show country + postal code (backward compatible default)
@@ -697,18 +706,25 @@ interface SplitCardFormProps {
     /** Backing session — forwarded to direct-PayPal so it can populate accountData. */
     session?: CheckoutSession | null;
     /**
-     * True while a **detached** session's background claim is still in flight
-     * (TeamFloPay/backend#1099).
+     * True while a **detached** session's claim is waiting for buyer identity or
+     * is still in flight (TeamFloPay/backend#1099).
      *
      * The hosted card widget is already mounted and the buyer can fill it in, but
      * the session has no cart attached yet, so nothing may be submitted: the
      * billing API rejects process / intent calls on an unclaimed session with
      * `409 checkout_session_data_attachment_required`, and holds an unclaimed
-     * vault charge with a retryable `503`. While true, the card submit is gated
-     * and the non-card surfaces stay hidden; all of them enable together the
-     * moment the claim lands. `FloPayCheckout` plumbs this prop automatically.
+     * vault charge with a retryable `503`. While true, card submit stays gated.
+     * Non-card surfaces also stay hidden unless they are needed to collect the
+     * missing identity; all payment continuations enable when the claim lands.
+     * `FloPayCheckout` plumbs this prop automatically.
      */
     dataAttachmentPending?: boolean;
+    /**
+     * True when the pending detached claim is waiting for this form to collect
+     * buyer identity. Non-card collection surfaces remain available, while all
+     * payment continuations still await `onBuyerIdentityReady`.
+     */
+    dataAttachmentRequiresIdentity?: boolean;
     /**
      * Enables on-screen diagnostic panels for the PayPal/wallet gating decision
      * and the `DirectPayPalButton` lifecycle. Intended for debugging in-app

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, GatewayEnvironment, PayPalProviderObjectType, TokenizedBody, InlineSessionPatch, 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, 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';
@@ -133,6 +133,10 @@ interface DirectPayPalButtonProps {
     billingApiUrl: string;
     /** Buyer email. */
     email?: string;
+    /** Buyer name already attached to the checkout, when available. */
+    billingName?: string;
+    /** Attaches buyer identity collected from PayPal before checkout continues. */
+    onBuyerIdentityReady?: (identity: NonNullable<InlineSessionPatch['account']>) => void | Promise<void>;
     /** PayPal client identifier (`gateways.paypal.publishableKey`). */
     clientId: string;
     /** Gateway environment, drives the sandbox/live SDK script. */
@@ -634,6 +638,11 @@ interface SplitCardFormProps {
      * Runs for card, PayPal, Apple Pay, and Google Pay.
      */
     onBeforeButtonClick?: (event: BeforeButtonClickEvent) => MaybePromise<undefined | false | InlineSessionPatch>;
+    /**
+     * Called after checkout collects a missing buyer email/name. FloPayCheckout
+     * uses this to claim an email-less detached session before payment continues.
+     */
+    onBuyerIdentityReady?: (identity: NonNullable<InlineSessionPatch['account']>) => MaybePromise<void>;
     /**
      * Enable AVS (Address Verification).
      * - `true` — show country + postal code (backward compatible default)
@@ -697,18 +706,25 @@ interface SplitCardFormProps {
     /** Backing session — forwarded to direct-PayPal so it can populate accountData. */
     session?: CheckoutSession | null;
     /**
-     * True while a **detached** session's background claim is still in flight
-     * (TeamFloPay/backend#1099).
+     * True while a **detached** session's claim is waiting for buyer identity or
+     * is still in flight (TeamFloPay/backend#1099).
      *
      * The hosted card widget is already mounted and the buyer can fill it in, but
      * the session has no cart attached yet, so nothing may be submitted: the
      * billing API rejects process / intent calls on an unclaimed session with
      * `409 checkout_session_data_attachment_required`, and holds an unclaimed
-     * vault charge with a retryable `503`. While true, the card submit is gated
-     * and the non-card surfaces stay hidden; all of them enable together the
-     * moment the claim lands. `FloPayCheckout` plumbs this prop automatically.
+     * vault charge with a retryable `503`. While true, card submit stays gated.
+     * Non-card surfaces also stay hidden unless they are needed to collect the
+     * missing identity; all payment continuations enable when the claim lands.
+     * `FloPayCheckout` plumbs this prop automatically.
      */
     dataAttachmentPending?: boolean;
+    /**
+     * True when the pending detached claim is waiting for this form to collect
+     * buyer identity. Non-card collection surfaces remain available, while all
+     * payment continuations still await `onBuyerIdentityReady`.
+     */
+    dataAttachmentRequiresIdentity?: boolean;
     /**
      * Enables on-screen diagnostic panels for the PayPal/wallet gating decision
      * and the `DirectPayPalButton` lifecycle. Intended for debugging in-app