@flopay/js 1.4.3 → 1.4.5

package/dist/index.d.cts

@@ -295,6 +295,7 @@ interface RawCheckoutSession {
         testEventCode?: string | null;
     };
 }
+type AccountSnapshotTelemetryMode = 'blocking' | 'best_effort';
 interface PaymentAPIOptions {
     /** Flo-owned privacy-safe telemetry is enabled by default; set false to opt out. */
     telemetry?: boolean;
@@ -315,6 +316,13 @@ declare class PaymentAPI {
     /** Dispose the reporter owned by direct public usage. Internal hooks are never disposed here. */
     destroy(): void;
     private reportDirectFailure;
+    /**
+     * A hosted-vault snapshot timeout is an observed fallback, not a checkout
+     * failure: the widget charge is already proceeding with the session baseline.
+     * Every other snapshot failure and every default/direct timeout remains an
+     * alert-level technical error.
+     */
+    private reportAccountSnapshotFailure;
     private telemetryTimestamp;
     private beginDirectTelemetryCheckout;
     private beginDirectTelemetryOperation;
@@ -449,6 +457,12 @@ declare class PaymentAPI {
     }, options?: {
         signal?: AbortSignal;
         timeoutMs?: number;
+        /**
+         * Downgrade only a timeout to `operation.fallback` when the caller can
+         * continue safely. The promise still rejects and all other failures stay
+         * technical errors. Defaults to `blocking`.
+         */
+        telemetryMode?: AccountSnapshotTelemetryMode;
     }): Promise<void>;
     /** Create a wallet/APM/PayPal intent through the session-scoped contract. */
     createSessionIntent(sessionId: string, nonce: string, request: CreateSessionIntentRequest, options?: {

package/dist/index.d.ts

@@ -295,6 +295,7 @@ interface RawCheckoutSession {
         testEventCode?: string | null;
     };
 }
+type AccountSnapshotTelemetryMode = 'blocking' | 'best_effort';
 interface PaymentAPIOptions {
     /** Flo-owned privacy-safe telemetry is enabled by default; set false to opt out. */
     telemetry?: boolean;
@@ -315,6 +316,13 @@ declare class PaymentAPI {
     /** Dispose the reporter owned by direct public usage. Internal hooks are never disposed here. */
     destroy(): void;
     private reportDirectFailure;
+    /**
+     * A hosted-vault snapshot timeout is an observed fallback, not a checkout
+     * failure: the widget charge is already proceeding with the session baseline.
+     * Every other snapshot failure and every default/direct timeout remains an
+     * alert-level technical error.
+     */
+    private reportAccountSnapshotFailure;
     private telemetryTimestamp;
     private beginDirectTelemetryCheckout;
     private beginDirectTelemetryOperation;
@@ -449,6 +457,12 @@ declare class PaymentAPI {
     }, options?: {
         signal?: AbortSignal;
         timeoutMs?: number;
+        /**
+         * Downgrade only a timeout to `operation.fallback` when the caller can
+         * continue safely. The promise still rejects and all other failures stay
+         * technical errors. Defaults to `blocking`.
+         */
+        telemetryMode?: AccountSnapshotTelemetryMode;
     }): Promise<void>;
     /** Create a wallet/APM/PayPal intent through the session-scoped contract. */
     createSessionIntent(sessionId: string, nonce: string, request: CreateSessionIntentRequest, options?: {