@fantastic.dev/better-stripe 0.28.2 → 0.28.4

package/src/react/workflows/payout-progress-state.ts

@@ -42,10 +42,23 @@ export type PayoutProgressState = {
   nextAttemptAt: number | null;
   holdDeadline: number | null;
   observedAt: number | null;
+  recovery?: {
+    status: NonNullable<PayoutPolicy["holdingExpiry"]>["status"];
+    balances?: {
+      currency: string;
+      available: number;
+      pending: number;
+      availableLabel: string;
+      pendingLabel: string;
+    }[];
+  };
 };
 export type PayoutProgressProps = {
   policy:
-    | Pick<PayoutPolicy, "mode" | "status" | "thresholds" | "holdDeadline">
+    | Pick<
+        PayoutPolicy,
+        "mode" | "status" | "thresholds" | "holdDeadline" | "holdingExpiry"
+      >
     | null
     | undefined;
   preview?: PayoutPreview | null;
@@ -104,6 +117,33 @@ export function payoutProgressState({
       state.status = "changing";
       state.message =
         "Payout settings are being verified. Eligibility is unavailable until the change completes.";
+    } else if (
+      policy?.holdingExpiry &&
+      policy.holdingExpiry.status !== "no_held_balance"
+    ) {
+      const expiry = policy.holdingExpiry;
+      state.status = "unavailable";
+      state.reason = "holding_expiry_unresolved";
+      state.holdDeadline = expiry.deadline;
+      state.observedAt = expiry.observedAt ?? null;
+      state.message =
+        "The holding deadline has passed. Schedule restoration does not confirm disbursement. " +
+        (expiry.status === "unverified"
+          ? "Stripe balance verification is unavailable. "
+          : "Stripe balances or payout claims still require recovery. ") +
+        "Contact platform support; automatic recovery checks will retry.";
+      state.recovery = {
+        status: expiry.status,
+        ...(expiry.balances
+          ? {
+              balances: expiry.balances.map((b) => ({
+                ...b,
+                availableLabel: formatPrice(b.available, b.currency, locale),
+                pendingLabel: formatPrice(b.pending, b.currency, locale),
+              })),
+            }
+          : {}),
+      };
     } else if (!policy || policy.mode === "stripe_managed") {
       state.status = "stripe_managed";
       state.message =
@@ -123,24 +163,36 @@ export function payoutProgressState({
         if (
           preview.currency !== currency ||
           !configured ||
-          configured.amount !== preview.threshold
+          configured.amount !== preview.threshold ||
+          (preview.minimumWaived &&
+            preview.holdDeadline !== policy.holdDeadline)
         )
           throw new Error(
             "Payout progress currency or policy does not match the assessment.",
           );
         state.status = "assessed";
         state.reason = preview.reason ?? null;
-        state.message =
-          preview.status === "qualified"
+        state.message = preview.minimumWaived
+          ? "The holding deadline is approaching. The application minimum is waived for final automatic attempts; provider limits and all balance checks still apply. " +
+            (preview.status === "qualified"
+              ? "The worker will verify eligibility again before any payout."
+              : (reasons[preview.reason ?? ""] ??
+                "Automatic payout remains on hold. Contact support before the deadline."))
+          : preview.status === "qualified"
             ? "The combined balance qualified at the assessment time. The automatic worker will verify it again before any payout."
             : (reasons[preview.reason ?? ""] ??
               "Automatic payout is on hold. Refresh or contact support.");
         state.observedAt = preview.observedAt;
         state.accounting = preview.accounting;
-        state.progress = {
-          value: Math.max(0, Math.min(preview.threshold, preview.matureUnpaid)),
-          max: preview.threshold,
-        };
+        state.progress = preview.minimumWaived
+          ? null
+          : {
+              value: Math.max(
+                0,
+                Math.min(preview.threshold, preview.matureUnpaid),
+              ),
+              max: preview.threshold,
+            };
         const definitions = [
           ["qualifying", "Combined qualifying balance", preview.matureUnpaid],
           ["pending", "Pending settlement", preview.pendingCredits],