@flopay/react 1.4.16 → 1.4.18

package/dist/index.d.cts

@@ -2,7 +2,7 @@ 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, AVSFieldConfig, GatewayEnvironment, CardCaptureAdapter, VaultCardThemeColors, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, ButtonsLayoutTheme, ButtonsLayoutStyles } from '@flopay/shared';
-export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, InlineSessionDraft, InlineSessionPatch } from '@flopay/shared';
+export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, InlineSessionDraft, InlineSessionPatch, SentryEventLike, SentryStackFrameLike, dropThirdPartyOnlyError } from '@flopay/shared';
 
 /** Props for the `FloPayProvider` component. */
 interface FloPayProviderProps {
@@ -289,6 +289,8 @@ interface CheckoutState {
     session: CheckoutSession | null;
     loading: boolean;
     error: FloPayError | null;
+    /** True while a detached session shell is not yet safe to charge. */
+    claimPending?: boolean;
 }
 /**
  * Returns the current checkout session state.
@@ -340,7 +342,6 @@ declare const PaymentElement: React.FC<PaymentElementProps>;
 declare const AddressElement: React.FC<ElementComponentProps>;
 
 type MaybePromise<T> = T | Promise<T>;
-/** Props for the `SplitCardForm` component. */
 interface SplitCardFormProps {
     /** The checkout session ID (UUID from billing API). */
     sessionId: string;
@@ -549,6 +550,19 @@ interface SplitCardFormProps {
     isSubscription?: boolean;
     /** 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).
+     *
+     * 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.
+     */
+    dataAttachmentPending?: 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

@@ -2,7 +2,7 @@ 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, AVSFieldConfig, GatewayEnvironment, CardCaptureAdapter, VaultCardThemeColors, CheckoutProduct, CheckoutItem, CheckoutSubscription, ThemeId, ButtonsLayoutTheme, ButtonsLayoutStyles } from '@flopay/shared';
-export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, InlineSessionDraft, InlineSessionPatch } from '@flopay/shared';
+export { BeforeButtonClickEvent, CheckoutButtonMethod, DeclineEvent, InlineSessionDraft, InlineSessionPatch, SentryEventLike, SentryStackFrameLike, dropThirdPartyOnlyError } from '@flopay/shared';
 
 /** Props for the `FloPayProvider` component. */
 interface FloPayProviderProps {
@@ -289,6 +289,8 @@ interface CheckoutState {
     session: CheckoutSession | null;
     loading: boolean;
     error: FloPayError | null;
+    /** True while a detached session shell is not yet safe to charge. */
+    claimPending?: boolean;
 }
 /**
  * Returns the current checkout session state.
@@ -340,7 +342,6 @@ declare const PaymentElement: React.FC<PaymentElementProps>;
 declare const AddressElement: React.FC<ElementComponentProps>;
 
 type MaybePromise<T> = T | Promise<T>;
-/** Props for the `SplitCardForm` component. */
 interface SplitCardFormProps {
     /** The checkout session ID (UUID from billing API). */
     sessionId: string;
@@ -549,6 +550,19 @@ interface SplitCardFormProps {
     isSubscription?: boolean;
     /** 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).
+     *
+     * 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.
+     */
+    dataAttachmentPending?: boolean;
     /**
      * Enables on-screen diagnostic panels for the PayPal/wallet gating decision
      * and the `DirectPayPalButton` lifecycle. Intended for debugging in-app