@openreceive/react 0.4.30 → 0.4.32

package/dist/index.d.ts

@@ -286,6 +286,12 @@ interface PaymentWizardProps {
      * Used by the create-mode deferred flow; safe to omit in snapshot mode.
      */
     readonly onRequestLightning?: () => void | Promise<void>;
+    /**
+     * Why the last `onRequestLightning` mint failed, in words for the payer. The
+     * wizard shows it above the methods with a Try again button that requests
+     * Lightning again. Create mode passes it; snapshot mode has no mint.
+     */
+    readonly lightningMintError?: string;
     /**
      * Called after a swap deposit attempt is created or reused so create-mode can poll
      * the shadow Lightning payment_hash for settlement.

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   OPENRECEIVE_DEFAULT_PREFIX,
   OPENRECEIVE_STYLE_ROOT_ATTRIBUTE as OPENRECEIVE_STYLE_ROOT_ATTRIBUTE2,
   orClasses as orClasses7,
+  payerErrorMessage,
   prepareCheckout,
   requestCheckout,
   resumeCheckoutAttempt,
@@ -2255,6 +2256,33 @@ function PaymentWizardSession(props) {
     {
       className: joinClassNames(orClasses6.wizard, props.className)
     },
+    // The Lightning mint failed. Try again picks Bitcoin again, as the method
+    // button does, so the payer does not have to walk back to the list first.
+    props.lightningMintError === void 0 ? null : React9.createElement(
+      "div",
+      { key: "wizard-error", role: "alert", className: orClasses6.paymentStatus },
+      React9.createElement(
+        "div",
+        { className: orClasses6.paymentStatusBody },
+        React9.createElement(
+          "p",
+          { className: orClasses6.paymentStatusDetail },
+          props.lightningMintError
+        ),
+        React9.createElement(
+          "button",
+          {
+            className: orClasses6.btn,
+            type: "button",
+            onClick: () => {
+              updateWizardSelection((controller) => controller.selectMethod("bitcoin"));
+              void props.onRequestLightning?.();
+            }
+          },
+          checkoutLabels5.tryAgain
+        )
+      )
+    ),
     selection.selectedMethod === null ? renderCompactPaymentMethodSelector({
       swapAssetOptions,
       // Create-checkout snapshot has no payment_methods yet; order status fills them
@@ -3076,7 +3104,7 @@ function CheckoutCreate(props) {
       onErrorRef.current?.(error);
       setCreated({
         status: "error",
-        ...error instanceof Error && error.message.length > 0 ? { errorMessage: error.message } : {}
+        errorMessage: payerErrorMessage(error, checkoutLabels6.startCheckoutFailedDetail)
       });
     });
     return () => {
@@ -3102,6 +3130,7 @@ function CheckoutCreate(props) {
       checkout: created.checkout,
       prefix: resolvedPrefix,
       mintingLightning: session.mintingLightning,
+      ...session.wizardError === void 0 ? {} : { lightningMintError: session.wizardError },
       onRequestLightning: session.ensureLightning,
       onSwapStarted
     });
@@ -3125,7 +3154,9 @@ function CheckoutCreate(props) {
         { className: orClasses7.creating },
         React10.createElement("p", { role: "alert" }, "Could not start checkout."),
         // The thrown error carries the server's payer-facing text (e.g. the
-        // rate-limit message or "Exchange rates are temporarily unavailable").
+        // rate-limit message or "Exchange rates are temporarily unavailable");
+        // payerErrorMessage swaps an operator-facing wallet message for one
+        // the payer can act on.
         created.errorMessage === void 0 ? null : React10.createElement("p", null, created.errorMessage),
         React10.createElement(
           "button",
@@ -3191,6 +3222,7 @@ function CheckoutView(props) {
     onRequestLightning,
     onSwapStarted,
     mintingLightning = false,
+    lightningMintError,
     qrEncoder,
     logger,
     decodeLinkUrl,
@@ -3488,6 +3520,7 @@ function CheckoutView(props) {
           onProviderCopy,
           onCopy,
           onRequestLightning,
+          ...lightningMintError === void 0 ? {} : { lightningMintError },
           onSwapStarted,
           // Whether a payer who closes the tab has a URL to come back
           // to. Explicit wins — only the host knows about a per-order

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openreceive/react",
-  "version": "0.4.30",
+  "version": "0.4.32",
   "description": "React components and hooks for Bitcoin Lightning checkout and optional USDT, USDC, SOL and ETH swaps.",
   "keywords": [
     "bitcoin",
@@ -10,7 +10,13 @@
     "bolt11",
     "openreceive",
     "react",
-    "checkout"
+    "checkout",
+    "stablecoin",
+    "usdt",
+    "usdc",
+    "payment-gateway",
+    "self-hosted",
+    "bitcoin-payments"
   ],
   "type": "module",
   "sideEffects": [
@@ -19,8 +25,8 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@openreceive/browser": "0.4.30",
-    "@openreceive/core": "0.4.30"
+    "@openreceive/browser": "0.4.32",
+    "@openreceive/core": "0.4.32"
   },
   "peerDependencies": {
     "react": ">=18.0.0"