@openreceive/browser 0.4.14 → 0.4.17

package/README.md

@@ -68,3 +68,14 @@ Content-Security-Policy has a strict `img-src`, allow `data:`.
   `@openreceive/provider-data`; `/headless` re-exports
   `loadPayTutorialImages` / `payTutorialImage` for the lazy tutorial chunk.
   See [docs/guides/provider-registry.md](https://github.com/OpenReceive/openreceive/blob/master/docs/guides/provider-registry.md#assets).
+
+## Agent skills
+
+Run `npx openreceive skills install` from your application after installing an
+OpenReceive server adapter. The offline copy ships in `@openreceive/node`, a
+server-adapter dependency. For a frontend-only project, use
+`npx skills add OpenReceive/openreceive`.
+See [agent setup](https://openreceive.org/agents). The bundled installers write
+to `.agents/skills/`; use `--dir .claude/skills` for Claude Code. They replace
+only `integrate-openreceive` and `debug-openreceive-payment`, preserving
+unrelated skills.

package/dist/{chunk-FBM57URY.js → chunk-LFX45HHQ.js}

@@ -170,6 +170,7 @@ var OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES = {
    * grid. A hash the server will not serve is ignored.
    */
   resumePaymentHash: "resume-payment-hash",
+  resumePaymentRail: "resume-payment-rail",
   /**
    * Does a payer who closes this tab have a URL that brings them back to this
    * checkout? Only the refund screen's copy depends on it — see
@@ -805,7 +806,7 @@ function formatSwapLimit(checkout, limitMsats, rounding = "ceil") {
     }
   }
   const sats = rounding === "floor" ? Math.floor(limitMsats / 1e3) : Math.ceil(limitMsats / 1e3);
-  return `${sats} ${sats === 1 ? "sat" : "sats"}`;
+  return `${sats.toLocaleString("en-US")} ${sats === 1 ? "sat" : "sats"}`;
 }
 function scaleFiatLimitExact(input) {
   const fiat = parseDecimal(input.fiatValue);
@@ -2475,7 +2476,8 @@ function mergeMintedCheckout(checkout, previous) {
     payment_methods: previous.payment_methods ?? checkout.payment_methods,
     // Prepare answered with it and create echoes it, but a host that only
     // returns it from one of the two must not lose it at the mint.
-    description: checkout.description ?? previous.description
+    description: checkout.description ?? previous.description,
+    fiat: checkout.fiat ?? previous.fiat
   });
 }
 
@@ -2798,7 +2800,13 @@ function checkoutSnapshot(checkout) {
     status: "open",
     amount_msats: amountMsats,
     active: invoice,
-    invoices: [invoice]
+    invoices: [invoice],
+    ...invoice.fiat_quote?.fiat === void 0 ? {} : {
+      fiat: {
+        currency: requiredString(invoice.fiat_quote.fiat.currency, "fiat.currency"),
+        value: requiredString(invoice.fiat_quote.fiat.value, "fiat.value")
+      }
+    }
   };
 }
 function normalizePaymentMethods(value) {
@@ -3051,6 +3059,11 @@ async function resumeSwapAttempt(options) {
     return options.snapshot;
   }
 }
+async function resumeCheckoutAttempt(options) {
+  if (options.rail !== "lightning") return resumeSwapAttempt(options);
+  if (options.paymentHash.length === 0) return options.snapshot;
+  return requestCheckout({ ...options, previous: options.snapshot });
+}
 async function requestSwapRefund(options) {
   const body = await postJson({
     fetch: options.fetch,
@@ -3847,6 +3860,7 @@ export {
   startSwapRequest,
   requestSwapStatus,
   resumeSwapAttempt,
+  resumeCheckoutAttempt,
   requestSwapRefund,
   createCheckoutController,
   deriveStatus,

package/dist/headless.d.ts

@@ -1,7 +1,7 @@
 import { AssetIndexEntry, PaymentWizardRoute } from '@openreceive/provider-data';
 export { PaymentWizardRoute, PaymentWizardRouteRequest, getPaymentWizardRoutes, loadPayTutorialImages, payTutorialImage } from '@openreceive/provider-data';
-import { P as PaymentIconId, a as ParseOpenReceiveOptionalIntegerOptions, b as PaymentMethod, R as ResolvedTheme, T as ThemePreference, c as PaymentMethodOption, d as TickingValueOptions, e as TickingValueController, f as TransientFeedbackOptions, g as TransientFeedbackController, C as CheckoutInvoiceSnapshot, U as UnixSeconds, S as SwapDisplayModel, h as CheckoutSnapshot, i as SwapDepositRisk, j as CheckoutState, k as TransactionDetailsInput, l as TransactionDetailRow, m as CreateCheckoutStateOptions, n as CheckoutStatusModelInput, o as CheckoutStatusModel, p as CheckoutPaymentMethod, B as BrowserLoggerOption, q as ThemeAttributeTarget, r as CheckoutElementAttributes, s as CheckoutElementAttributeOptions, t as CheckoutElementEventHandlers, u as CheckoutElementListeners, v as CreateCheckoutShellOptions, w as CheckoutShellElements, x as CheckoutShellOptions, y as CheckoutShellModel, z as CreateOpenReceiveThemeToggleElementOptions, A as ThemeToggleElementAttributeOptions, D as ThemeToggleElementAttributes, E as StoredThemeModelOptions, F as ThemeModel, G as ThemeModelOptions, H as ReadThemePreferenceOptions, I as ThemeControlTargets, J as ThemeStorageOptions, K as PaymentWizardControllerOptions, L as PaymentWizardController, M as PaymentWizardSelection, N as PaymentWizardModel, W as WizardRouteAssetDisplay, O as WizardRouteDisplay, Q as PaymentWizardSelectionAction } from './status-Q1CJqaYo.js';
-export { V as BrowserLogContext, X as BrowserLogger, Y as BrowserRequestError, Z as CheckoutController, _ as CheckoutControllerOptions, $ as CheckoutPhase, a0 as CheckoutShellRootAttributes, a1 as CheckoutStatusRefresh, a2 as OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES, a3 as OPENRECEIVE_CHECKOUT_DATA_SELECTORS, a4 as OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES, a5 as OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS, a6 as OPENRECEIVE_CHECKOUT_ELEMENT_PARTS, a7 as OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS, a8 as OPENRECEIVE_CHECKOUT_ELEMENT_SLOTS, a9 as OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, aa as OPENRECEIVE_COPY_FEEDBACK_MS, ab as OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS, ac as OPENRECEIVE_DEFAULT_PREFIX, ad as OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES, ae as OPENRECEIVE_PAYMENT_WIZARD_SELECTORS, af as OPENRECEIVE_PROVIDER_PREVIEW_LIMIT, ag as OPENRECEIVE_STYLE_ROOT_ATTRIBUTE, ah as OPENRECEIVE_STYLE_ROOT_SELECTOR, ai as OPENRECEIVE_THEME_STORAGE_KEY, aj as OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES, ak as OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS, al as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS, am as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS, an as OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, ao as QrEncoder, ap as QrSvgController, aq as QrSvgControllerOptions, ar as Status, as as SwapCopyRow, at as SwapRefundStaging, au as WizardProviderDisplay, av as assertDisplayInvoice, aw as copyInvoice, ax as createCheckoutActionEvent, ay as createCheckoutController, az as createCheckoutErrorEvent, aA as createCheckoutProviderCopyEvent, aB as createCheckoutStateEvent, aC as createQrPayloadSvg, aD as createQrSvg, aE as createQrSvgController, aF as createStatusFetcher, aG as createThemeChangeEvent, aH as currentCheckoutUrl, aI as deriveCheckoutStateLabels, aJ as deriveStatus, aK as enterCheckoutResumePath, aL as escapeHtml, aM as formatAmountCaption, aN as formatDepositAmount, aO as formatFiatAmount, aP as formatMsats, aQ as formatSwapLimit, aR as formatUnixTime, aS as openWallet, aT as paymentIconSvgs, aU as prepareCheckout, aV as requestCheckout } from './status-Q1CJqaYo.js';
+import { P as PaymentIconId, a as ParseOpenReceiveOptionalIntegerOptions, b as PaymentMethod, R as ResolvedTheme, T as ThemePreference, c as PaymentMethodOption, d as TickingValueOptions, e as TickingValueController, f as TransientFeedbackOptions, g as TransientFeedbackController, C as CheckoutInvoiceSnapshot, U as UnixSeconds, S as SwapDisplayModel, h as CheckoutSnapshot, i as SwapDepositRisk, j as CheckoutState, k as TransactionDetailsInput, l as TransactionDetailRow, m as CreateCheckoutStateOptions, n as CheckoutStatusModelInput, o as CheckoutStatusModel, p as CheckoutPaymentMethod, B as BrowserLoggerOption, q as ThemeAttributeTarget, r as CheckoutElementAttributes, s as CheckoutElementAttributeOptions, t as CheckoutElementEventHandlers, u as CheckoutElementListeners, v as CreateCheckoutShellOptions, w as CheckoutShellElements, x as CheckoutShellOptions, y as CheckoutShellModel, z as CreateOpenReceiveThemeToggleElementOptions, A as ThemeToggleElementAttributeOptions, D as ThemeToggleElementAttributes, E as StoredThemeModelOptions, F as ThemeModel, G as ThemeModelOptions, H as ReadThemePreferenceOptions, I as ThemeControlTargets, J as ThemeStorageOptions, K as PaymentWizardControllerOptions, L as PaymentWizardController, M as PaymentWizardSelection, N as PaymentWizardModel, W as WizardRouteAssetDisplay, O as WizardRouteDisplay, Q as PaymentWizardSelectionAction } from './status-BC2Rl8KA.js';
+export { V as BrowserLogContext, X as BrowserLogger, Y as BrowserRequestError, Z as CheckoutController, _ as CheckoutControllerOptions, $ as CheckoutPhase, a0 as CheckoutShellRootAttributes, a1 as CheckoutStatusRefresh, a2 as OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES, a3 as OPENRECEIVE_CHECKOUT_DATA_SELECTORS, a4 as OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES, a5 as OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS, a6 as OPENRECEIVE_CHECKOUT_ELEMENT_PARTS, a7 as OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS, a8 as OPENRECEIVE_CHECKOUT_ELEMENT_SLOTS, a9 as OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, aa as OPENRECEIVE_COPY_FEEDBACK_MS, ab as OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS, ac as OPENRECEIVE_DEFAULT_PREFIX, ad as OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES, ae as OPENRECEIVE_PAYMENT_WIZARD_SELECTORS, af as OPENRECEIVE_PROVIDER_PREVIEW_LIMIT, ag as OPENRECEIVE_STYLE_ROOT_ATTRIBUTE, ah as OPENRECEIVE_STYLE_ROOT_SELECTOR, ai as OPENRECEIVE_THEME_STORAGE_KEY, aj as OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES, ak as OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS, al as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS, am as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS, an as OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, ao as QrEncoder, ap as QrSvgController, aq as QrSvgControllerOptions, ar as Status, as as SwapCopyRow, at as SwapRefundStaging, au as WizardProviderDisplay, av as assertDisplayInvoice, aw as copyInvoice, ax as createCheckoutActionEvent, ay as createCheckoutController, az as createCheckoutErrorEvent, aA as createCheckoutProviderCopyEvent, aB as createCheckoutStateEvent, aC as createQrPayloadSvg, aD as createQrSvg, aE as createQrSvgController, aF as createStatusFetcher, aG as createThemeChangeEvent, aH as currentCheckoutUrl, aI as deriveCheckoutStateLabels, aJ as deriveStatus, aK as enterCheckoutResumePath, aL as escapeHtml, aM as formatAmountCaption, aN as formatDepositAmount, aO as formatFiatAmount, aP as formatMsats, aQ as formatSwapLimit, aR as formatUnixTime, aS as openWallet, aT as paymentIconSvgs, aU as prepareCheckout, aV as requestCheckout } from './status-BC2Rl8KA.js';
 import '@openreceive/core';
 
 /** Each packaged payment icon as a `data:image/svg+xml` URI, keyed by id. */
@@ -662,6 +662,8 @@ interface CheckoutComponentProps {
      * attempt only until it expires. See docs/guides/swap-refunds.md.
      */
     readonly resumePaymentHash?: string;
+    /** Rail of the remembered attempt; defaults to swap for existing integrations. */
+    readonly resumePaymentRail?: "lightning" | "swap";
     /**
      * Does a payer who closes this tab have a URL that brings them back to this
      * checkout? It decides ONE thing: which of the two refund-return warnings the
@@ -676,7 +678,7 @@ interface CheckoutComponentProps {
     readonly resumable?: boolean;
 }
 /** Which props only do something in create mode (no `checkout` snapshot). */
-declare const CREATE_MODE_ONLY_PROPS: readonly ["metadata", "syncUrl", "resumePathPrefix", "routeReference", "resumePaymentHash"];
+declare const CREATE_MODE_ONLY_PROPS: readonly ["metadata", "syncUrl", "resumePathPrefix", "routeReference", "resumePaymentHash", "resumePaymentRail"];
 type CreateModeOnlyProp = (typeof CREATE_MODE_ONLY_PROPS)[number];
 /**
  * What the check reads: the two mode props plus the create-only ones, derived
@@ -910,6 +912,13 @@ declare function resumeSwapAttempt(options: SwapRequestOptions & {
     readonly paymentHash: string;
     readonly snapshot: CheckoutSnapshot;
 }): Promise<CheckoutSnapshot>;
+/** Resume the host-selected rail; old callers continue to use swap recovery. */
+declare function resumeCheckoutAttempt(options: SwapRequestOptions & {
+    readonly reference: string;
+    readonly paymentHash: string;
+    readonly rail?: "lightning" | "swap";
+    readonly snapshot: CheckoutSnapshot;
+}): Promise<CheckoutSnapshot>;
 /**
  * Review-or-confirm a swap refund for one attempt, and return the normalized
  * swap invoice — carrying the staged refund address on review.
@@ -1249,4 +1258,4 @@ declare function createPaymentWizardModel(selection: PaymentWizardSelection): Pa
 declare function updatePaymentWizardSelection(selection: PaymentWizardSelection, action: PaymentWizardSelectionAction): PaymentWizardSelection;
 declare function createPaymentWizardController(options?: PaymentWizardControllerOptions): PaymentWizardController;
 
-export { BrowserLoggerOption, type CheckoutComponentProps, CheckoutElementAttributeOptions, CheckoutElementAttributes, CheckoutElementEventHandlers, CheckoutElementListeners, CheckoutInvoiceSnapshot, CheckoutPaymentMethod, type CheckoutPropsValidation, type CheckoutSession, type CheckoutSessionOptions, CheckoutShellElements, CheckoutShellModel, CheckoutShellOptions, CheckoutSnapshot, CheckoutState, CheckoutStatusModel, type CheckoutSwapOptions, CreateCheckoutShellOptions, type DetailLinkKind, type MethodGridContinueDisplay, type MethodGridDisplay, type MethodGridDisplayEntry, type MethodGridEntry, type MethodGridGroupDisplay, PaymentIconId, PaymentMethod, PaymentWizardController, PaymentWizardModel, PaymentWizardSelection, ResolvedTheme, StoredThemeModelOptions, SwapDepositRisk, SwapDisplayModel, type SwapLimitContext, type SwapMethodGroup, type SwapSelection, type SwapUnavailableModel, ThemeModel, ThemeModelOptions, ThemePreference, ThemeToggleElementAttributeOptions, ThemeToggleElementAttributes, TransactionDetailRow, TransactionDetailsInput, type TransactionDetailsSource, TransientFeedbackController, UnixSeconds, WizardRouteAssetDisplay, WizardRouteDisplay, type WizardSelection, applyCheckoutElementAttributes, assetButtonClasses, buildMethodGridEntries, checkoutElementStyles, checkoutLabels, createBlockExplorerUrl, createCheckoutElementAttributes, createCheckoutElementListeners, createCheckoutSession, createCheckoutShell, createCheckoutShellModel, createCheckoutSnapshotFromInvoice, createCheckoutState, createCheckoutStatusModel, createDetailExternalLink, createLightningInvoiceDecodeUrl, createMethodGridDisplay, createPaymentWizardController, createPaymentWizardModel, createPaymentWizardSelection, createStoredThemeModel, createSwapDisplayModel, createSwapUnavailableModel, createThemeModel, createThemeToggleElement, createThemeToggleElementAttributes, createTickingValueController, createTransactionDetails, createTransactionDetailsFromState, createTransientFeedbackController, createWizardRouteAssetDisplays, createWizardRouteDisplays, formatMethodNetworkDetail, formatNetworkSummary, getExplorerNetwork, getNetworkIcon, getNetworkIconId, getPaymentMethodIcon, getPaymentMethodIconId, getRouteNetworkLabel, getSwapOptionIcon, getSwapOptionIconId, getSwapRefundFormError, getWizardEmptyMessage, isReusableLightningInvoice, mergeAttemptIntoCheckout, mergeAttemptIntoSnapshot, networkButtonClasses, networkCheckClasses, networkMobileRevealClasses, networkSummaryIconClasses, normalizeSwapStartInvoice, orClasses, parseBooleanAttribute, parseMethodPickerKey, parseOptionalInteger, parsePaymentMethod, parseResolvedTheme, parseThemePreference, paymentAccentId, paymentIconUrls, paymentMethods, postJson, readThemePreference, requestSwapRefund, requestSwapStatus, resolveTransactionDetailRows, resolveWizardSelection, resumeSwapAttempt, selectCheckoutDisplayInvoice, selectCurrentSwapInvoice, startSwapRequest, swapAssetMatchesRoute, swapDepositRisk, swapOptionLimitMessage, swapOptionLimitSentence, swapPickerKey, syncStoredThemeControls, toggleStoredThemeControls, updatePaymentWizardSelection, validateCheckoutProps, writeThemePreference };
+export { BrowserLoggerOption, type CheckoutComponentProps, CheckoutElementAttributeOptions, CheckoutElementAttributes, CheckoutElementEventHandlers, CheckoutElementListeners, CheckoutInvoiceSnapshot, CheckoutPaymentMethod, type CheckoutPropsValidation, type CheckoutSession, type CheckoutSessionOptions, CheckoutShellElements, CheckoutShellModel, CheckoutShellOptions, CheckoutSnapshot, CheckoutState, CheckoutStatusModel, type CheckoutSwapOptions, CreateCheckoutShellOptions, type DetailLinkKind, type MethodGridContinueDisplay, type MethodGridDisplay, type MethodGridDisplayEntry, type MethodGridEntry, type MethodGridGroupDisplay, PaymentIconId, PaymentMethod, PaymentWizardController, PaymentWizardModel, PaymentWizardSelection, ResolvedTheme, StoredThemeModelOptions, SwapDepositRisk, SwapDisplayModel, type SwapLimitContext, type SwapMethodGroup, type SwapSelection, type SwapUnavailableModel, ThemeModel, ThemeModelOptions, ThemePreference, ThemeToggleElementAttributeOptions, ThemeToggleElementAttributes, TransactionDetailRow, TransactionDetailsInput, type TransactionDetailsSource, TransientFeedbackController, UnixSeconds, WizardRouteAssetDisplay, WizardRouteDisplay, type WizardSelection, applyCheckoutElementAttributes, assetButtonClasses, buildMethodGridEntries, checkoutElementStyles, checkoutLabels, createBlockExplorerUrl, createCheckoutElementAttributes, createCheckoutElementListeners, createCheckoutSession, createCheckoutShell, createCheckoutShellModel, createCheckoutSnapshotFromInvoice, createCheckoutState, createCheckoutStatusModel, createDetailExternalLink, createLightningInvoiceDecodeUrl, createMethodGridDisplay, createPaymentWizardController, createPaymentWizardModel, createPaymentWizardSelection, createStoredThemeModel, createSwapDisplayModel, createSwapUnavailableModel, createThemeModel, createThemeToggleElement, createThemeToggleElementAttributes, createTickingValueController, createTransactionDetails, createTransactionDetailsFromState, createTransientFeedbackController, createWizardRouteAssetDisplays, createWizardRouteDisplays, formatMethodNetworkDetail, formatNetworkSummary, getExplorerNetwork, getNetworkIcon, getNetworkIconId, getPaymentMethodIcon, getPaymentMethodIconId, getRouteNetworkLabel, getSwapOptionIcon, getSwapOptionIconId, getSwapRefundFormError, getWizardEmptyMessage, isReusableLightningInvoice, mergeAttemptIntoCheckout, mergeAttemptIntoSnapshot, networkButtonClasses, networkCheckClasses, networkMobileRevealClasses, networkSummaryIconClasses, normalizeSwapStartInvoice, orClasses, parseBooleanAttribute, parseMethodPickerKey, parseOptionalInteger, parsePaymentMethod, parseResolvedTheme, parseThemePreference, paymentAccentId, paymentIconUrls, paymentMethods, postJson, readThemePreference, requestSwapRefund, requestSwapStatus, resolveTransactionDetailRows, resolveWizardSelection, resumeCheckoutAttempt, resumeSwapAttempt, selectCheckoutDisplayInvoice, selectCurrentSwapInvoice, startSwapRequest, swapAssetMatchesRoute, swapDepositRisk, swapOptionLimitMessage, swapOptionLimitSentence, swapPickerKey, syncStoredThemeControls, toggleStoredThemeControls, updatePaymentWizardSelection, validateCheckoutProps, writeThemePreference };

package/dist/headless.js

@@ -109,6 +109,7 @@ import {
   requestSwapStatus,
   resolveTransactionDetailRows,
   resolveWizardSelection,
+  resumeCheckoutAttempt,
   resumeSwapAttempt,
   selectCheckoutDisplayInvoice,
   selectCurrentSwapInvoice,
@@ -119,7 +120,7 @@ import {
   swapOptionLimitSentence,
   swapPickerKey,
   updatePaymentWizardSelection
-} from "./chunk-FBM57URY.js";
+} from "./chunk-LFX45HHQ.js";
 
 // src/headless.ts
 import {
@@ -134,7 +135,8 @@ var CREATE_MODE_ONLY_PROPS = [
   "syncUrl",
   "resumePathPrefix",
   "routeReference",
-  "resumePaymentHash"
+  "resumePaymentHash",
+  "resumePaymentRail"
 ];
 var warnedSnapshotModeProps = /* @__PURE__ */ new Set();
 function validateCheckoutProps(props) {
@@ -496,6 +498,9 @@ function createModeAttributes(options) {
   if (options.resumePaymentHash !== void 0) {
     attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.resumePaymentHash] = options.resumePaymentHash;
   }
+  if (options.resumePaymentRail !== void 0) {
+    attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.resumePaymentRail] = options.resumePaymentRail;
+  }
   return attributes;
 }
 function sharedElementAttributes(options) {
@@ -806,6 +811,7 @@ export {
   requestSwapStatus,
   resolveTransactionDetailRows,
   resolveWizardSelection,
+  resumeCheckoutAttempt,
   resumeSwapAttempt,
   selectCheckoutDisplayInvoice,
   selectCurrentSwapInvoice,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { aW as BrowserLogLevel } from './status-Q1CJqaYo.js';
-export { aX as BrowserLogEntry, X as BrowserLogger, B as BrowserLoggerOption, Y as BrowserRequestError, Z as CheckoutController, _ as CheckoutControllerOptions, h as CheckoutSnapshot, j as CheckoutState, aY as CopyInvoiceOptions, aZ as GuestCheckoutResumeController, a_ as GuestCheckoutResumeOptions, a$ as OpenWalletOptions, b0 as PrepareCheckoutOptions, b1 as QrOptions, b2 as RequestCheckoutOptions, ar as Status, b3 as StatusInvoiceLike, U as UnixSeconds, aw as copyInvoice, ay as createCheckoutController, b4 as createGuestCheckoutResume, b5 as createGuestOrderFetcher, b6 as createLightningUri, b7 as createQrPngDataUrl, aD as createQrSvg, aJ as deriveStatus, aK as enterCheckoutResumePath, aS as openWallet, aU as prepareCheckout, aV as requestCheckout } from './status-Q1CJqaYo.js';
+import { aW as BrowserLogLevel } from './status-BC2Rl8KA.js';
+export { aX as BrowserLogEntry, X as BrowserLogger, B as BrowserLoggerOption, Y as BrowserRequestError, Z as CheckoutController, _ as CheckoutControllerOptions, h as CheckoutSnapshot, j as CheckoutState, aY as CopyInvoiceOptions, aZ as GuestCheckoutResumeController, a_ as GuestCheckoutResumeOptions, a$ as OpenWalletOptions, b0 as PrepareCheckoutOptions, b1 as QrOptions, b2 as RequestCheckoutOptions, ar as Status, b3 as StatusInvoiceLike, U as UnixSeconds, aw as copyInvoice, ay as createCheckoutController, b4 as createGuestCheckoutResume, b5 as createGuestOrderFetcher, b6 as createLightningUri, b7 as createQrPngDataUrl, aD as createQrSvg, aJ as deriveStatus, aK as enterCheckoutResumePath, aS as openWallet, aU as prepareCheckout, aV as requestCheckout } from './status-BC2Rl8KA.js';
 import '@openreceive/provider-data';
 import '@openreceive/core';
 

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   openWallet,
   prepareCheckout,
   requestCheckout
-} from "./chunk-FBM57URY.js";
+} from "./chunk-LFX45HHQ.js";
 export {
   BrowserRequestError,
   copyInvoice,

package/dist/{status-Q1CJqaYo.d.ts → status-BC2Rl8KA.d.ts}

@@ -286,6 +286,7 @@ declare const OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES: {
      * grid. A hash the server will not serve is ignored.
      */
     readonly resumePaymentHash: "resume-payment-hash";
+    readonly resumePaymentRail: "resume-payment-rail";
     /**
      * Does a payer who closes this tab have a URL that brings them back to this
      * checkout? Only the refund screen's copy depends on it — see
@@ -680,6 +681,7 @@ interface CheckoutElementAttributeOptions {
      * the server will not serve is ignored.
      */
     readonly resumePaymentHash?: string;
+    readonly resumePaymentRail?: "lightning" | "swap";
     /**
      * Does a payer who closes this tab have a URL that brings them back? Emitted
      * in every mode, because the refund screen it governs shows in every mode.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openreceive/browser",
-  "version": "0.4.14",
+  "version": "0.4.17",
   "description": "Browser helpers and a headless UI engine for Bitcoin Lightning checkout and optional USDT, USDC, SOL and ETH swaps.",
   "keywords": [
     "bitcoin",
@@ -30,8 +30,8 @@
     "./styles.css": "./dist/styles.css"
   },
   "dependencies": {
-    "@openreceive/core": "0.4.14",
-    "@openreceive/provider-data": "0.4.14",
+    "@openreceive/core": "0.4.17",
+    "@openreceive/provider-data": "0.4.17",
     "qrcode": "^1.5.4"
   },
   "devDependencies": {
@@ -41,7 +41,6 @@
   },
   "files": [
     "dist",
-    "skills",
     "README.md",
     "LICENSE"
   ],

package/skills/debug-openreceive-payment/SKILL.md

@@ -1,97 +0,0 @@
----
-name: debug-openreceive-payment
-description: >
-  Diagnose a failing OpenReceive integration. Use when an OpenReceive-powered
-  checkout misbehaves: the server refuses to boot, checkout routes return 403,
-  404, 409, or 5xx, a paid invoice never settles, a swap refund seems
-  unreachable, or the checkout UI renders nothing.
-license: MIT
----
-
-# Debug an OpenReceive payment
-
-Work top-down: configuration, then the request, then settlement. Every guide
-URL below is raw markdown — fetch it when the step needs it.
-
-## 1. Run the doctor first
-
-```sh
-npx openreceive doctor                     # Node version, NWC_URI, swap config, wallet probe
-npx openreceive doctor --db <db>           # + are openreceive_payments/openreceive_meta migrated?
-npx openreceive doctor --url http://localhost:3000   # + are the routes actually mounted?
-```
-
-Each failing line states its own fix. `npx openreceive debug-report` prints the
-same diagnostics redacted, always exit 0 — safe to share.
-
-## 2. Boot failures
-
-| Symptom | Cause and fix |
-| --- | --- |
-| `MISSING_NWC` / "needs a receive-only NWC code" | `NWC_URI` is not in the server process env. A `.env` file alone is not enough — something must load it (`dotenv/config`, Next auto-load). Get a code: https://openreceive.org/get_a_nwc_code_to_receive_payments |
-| `INVALID_NWC` / "not a valid NWC code" | The value is malformed (must be `nostr+walletconnect://` with 64-hex pubkey and secret, ≥1 `wss` relay). Re-copy it from the wallet. |
-| "NOT receive-only" / spend methods advertised | The wallet minted a spend-capable code; OpenReceive fails closed because a leak would drain the wallet. Mint a receive-only code. Overriding (`allowSpendCapableWallet` / `OPENRECEIVE_ALLOW_SPEND_CAPABLE_NWC`) is a last resort. |
-| Wallet preflight failed (methods/encryption) | The wallet must advertise `make_invoice` + `list_transactions` and NIP-04 or NIP-44 v2. Use a compatible wallet. |
-| "The openreceive_meta table does not exist" / raw `no such table: openreceive_payments` | The migration was never applied. Node: `npx openreceive scaffold payments --orm <yours>`, then run the emitted migration through the app's normal workflow. Rails: `bin/rails generate openreceive:install`, then `bin/rails db:migrate`. https://openreceive.org/guides/storage.md |
-| "requires amountFor / onPaid / authorize / host" | The factory is missing a required hook — see the host contract in https://openreceive.org/guides/api-reference.md |
-
-## 3. Request-time errors from the routes
-
-| Status | Meaning | Where to look |
-| --- | --- | --- |
-| 403 FORBIDDEN | Your own `authorize` hook denied it, or the request looked cross-site. Check the session/cookie actually reaches the checkout routes. https://openreceive.org/guides/authorization.md |
-| Never 403s — any visitor can mint, poll, or refund for any reference | The opposite failure: on Rails the generated `config.authorize = OpenReceive::ALLOW_ALL_AUTHORIZE` placeholder is still installed (the engine warns at boot; `bin/rails openreceive:doctor` reports it). Replace it with the app's real ownership check. https://openreceive.org/guides/authorization.md |
-| 404 NOT_FOUND | `amountFor` returned `null` (unknown reference), or the `payment_hash` does not belong to that reference. |
-| 409 CONFLICT | **Normal state, not a bug**: the reference already settled, or an unpaid checkout for that method is already live. Show it as order state; never retry-loop. |
-| 503 retryable | The host hook failed while persisting the attempt (instructions withheld), or the wallet is unavailable. Read the server log for the underlying error. |
-| Framework 404 / HTML error page | The router is not mounted, or mounted at a different prefix than the UI's `prefix` prop. `doctor --url` distinguishes these. |
-
-## 4. Paid but never settles
-
-- Settlement is opportunistic: any OpenReceive request runs one reconcile pass
-  through a durable gate (min 3s between wallet scans, stretched by invoice
-  age). A quiet server settles on the next request — or run the optional
-  notification worker. No timer is missing; that is the design.
-- An unpaid attempt closes only after a successful wallet scan at/after expiry
-  plus a 900s grace constant — a local clock alone never closes one. `expired`
-  arriving "late" is correct.
-- `onPaid` runs once per reference, first settled attempt only, inside the
-  settlement transaction. If your fulfillment did not run, check whether the
-  guarded `UPDATE … WHERE` matched zero rows (already transitioned).
-  https://openreceive.org/guides/storage.md
-
-## 5. Swaps and refunds
-
-- A deposit that arrives short or late becomes `refund_required`; the payer
-  claims it on a second visit. That needs a per-order URL you serve
-  (`/checkout/:reference`, `syncUrl` on the drop-ins). Keep the
-  `payment_hash`: `POST /swaps/status` reopens the attempt with no expiry
-  window, while re-picking the coin mints a new deposit after ~30 minutes.
-- Refunds exist only for swap deposits from `refund_required`. There is **no
-  Lightning refund** — the wallet cannot spend. Do not chase one.
-  https://openreceive.org/guides/swap-refunds.md
-- "Payer reports two different amounts on a stablecoin checkout" (50.05 or
-  50.03?): the deposit amount is a token quantity, `fee.pay_in_fiat` is its
-  fiat valuation. Only `swap.deposit_amount` is an instruction. From 0.4.10 the
-  packaged checkout renders a USD stablecoin's breakdown in the token and never
-  shows `pay_in_fiat`; on an older bundle, upgrade `@openreceive/*`. To verify,
-  read the row's `deposit_amount` and `fee` and confirm the UI shows only the
-  deposit amount. A custom UI must call `createSwapFeeBreakdown(fee, swap)`
-  with the swap, not the fee alone.
-
-## 6. Checkout UI shows nothing
-
-- The components require `prefix` — the exact base path the routes are mounted
-  at (`"/openreceive"` unless you changed it).
-- Import the stylesheet (`@openreceive/react/styles.css` or the elements
-  sheet).
-- "invoice must not be an NWC connection string" means a server secret leaked
-  into a browser payload — stop and fix the server response; never render it.
-  https://openreceive.org/guides/frontend-checkout.md
-
-## Still stuck
-
-The full route/option/error reference:
-https://openreceive.org/guides/api-reference.md · machine-readable contract:
-https://openreceive.org/openapi.yaml · library bug reports:
-https://openreceive.org/contact

package/skills/integrate-openreceive/SKILL.md

@@ -1,139 +0,0 @@
----
-name: integrate-openreceive
-description: >
-  Integrate OpenReceive inbound Bitcoin Lightning payments into an application.
-  Use when adding Bitcoin, Lightning, or crypto checkout to a Node.js, Express,
-  Fastify, Next.js, Rails, React, Vue, Svelte, Angular, or plain-HTML
-  application with OpenReceive (the @openreceive/* npm packages or the
-  openreceive-rails gem), or when connecting a BTCPay Server store to a
-  receive-only NWC wallet with the OpenReceive plugin.
-license: MIT
----
-
-# Integrate OpenReceive
-
-OpenReceive is a payment library that runs inside the application you are
-editing. It mounts HTTP routes there, issues Lightning invoices against a
-wallet the merchant already controls, and calls back into your code when one
-settles. There is no OpenReceive account and no API key; funds land directly in
-the merchant's wallet. The one required credential is a **receive-only NWC
-code** (`NWC_URI`).
-
-## Pick the stack, then follow its directions
-
-1. Identify the server stack of the application you are in.
-2. Open the matching reference — it is complete (quickstart inlined) and needs
-   no network access:
-   - Node, Express: [references/node.md](references/node.md)
-   - Node, Fastify: [references/fastify.md](references/fastify.md)
-   - Node, Next.js App Router: [references/next.md](references/next.md)
-   - Rails: [references/rails.md](references/rails.md)
-   - Django: [references/django.md](references/django.md)
-   - Laravel: [references/laravel.md](references/laravel.md)
-   - WordPress + WooCommerce: [references/woocommerce.md](references/woocommerce.md) — the packaged gateway and merchant settings.
-   - BTCPay Server: [references/btcpay.md](references/btcpay.md) — a plugin,
-     configured in BTCPay's store UI or Greenfield API; no application code,
-     no npm packages, no gem. The rest of this file is about the library.
-3. Follow its **Step 0** first: before writing code or searching the machine,
-   ask the user for the receive-only NWC code (then the swap URI), one question
-   per message, and store each pasted code in the project's env file yourself.
-   Never print the value; never invent a placeholder.
-
-Install, per adapter — Express: `npm install @openreceive/express @openreceive/react`;
-Fastify: `npm install @openreceive/fastify @openreceive/react`; Next.js:
-`npm install @openreceive/next @openreceive/react`. Swap the UI package (`vue`,
-`svelte`, `angular`, `elements`) for the frontend the app already has. Install
-(Rails): `bundle add openreceive-rails`.
-
-## The three server objects
-
-| Object | Built with | Talks to |
-| --- | --- | --- |
-| Wallet client | `createOpenReceive()` | the merchant's wallet — mints invoices, reads settlement, holds the NWC code |
-| Host | `createHost()` | your database — your hooks plus the `openreceive_payments` table |
-| HTTP routes | `openReceiveExpress()` / `openReceiveFastify()` / `openReceiveNext()` / the Rails engine | the browser — mounted at `/openreceive` by default |
-
-The quickstart's one-factory form (`openReceiveExpress({ wallet, storage,
-amountFor, authorize })`) builds all three; compose them separately only for a
-shared wallet client or a custom repository. The checkout UI
-(`<Checkout reference={...} prefix="/openreceive" />`) is the optional fourth
-piece.
-
-## The host contract: authorize, amountFor, onPaid
-
-Your application keeps orders, users, prices, and fulfillment. Three hooks are
-the entire bridge — wire them to the models this app already has, never to
-copied demo models:
-
-- `amountFor(reference)` — the authoritative price, read from your own data.
-  Return `{ currency, value, description }` with `value` a **decimal string**
-  (never a float, never payer input), or `null` when there is nothing to pay
-  for. The `reference` is your order id: one per thing you fulfill, created
-  before checkout, kept across retries, never reused.
-- `authorize({ action, request, resource })` — your own access check, run on
-  every request. `resource.reference` is a claim the payer made, not proof;
-  read a real session.
-- `onPaid({ reference, paidAt, query })` — fulfillment, run once per reference
-  inside the settlement transaction, only for the first settled attempt. Use
-  the provided `query`, not your ORM's other connection, and guard the
-  transition (`UPDATE … WHERE state = 'awaiting_payment'`).
-
-## 409 is a state, not a failure
-
-The library serializes attempts per reference. A create that returns **409
-CONFLICT** is normal checkout flow: the reference already settled, or an unpaid
-checkout for that payment method is already in progress. Surface it as order
-state; do not retry-loop it, and do not build an idempotency store around it —
-that serialization is the library's job. (A hook failure while persisting an
-attempt is a **503 retryable**, deliberately distinct.)
-
-## Amounts on the deposit panel
-
-`swap.deposit_amount` is the ONLY amount a payer is ever told to send, in the
-pay-in token. `swap.fee.pay_in_fiat` / `payout_fiat` are fiat valuations that
-explain the spread (why the deposit exceeds the cart total); they are not
-instructions. For a stablecoin pegged to the fee currency (USDT, USDC) the
-packaged checkout expresses the breakdown in the token and never renders
-`pay_in_fiat` — "$50.03" under "50.05 USDC" reads as the same number with a
-typo. A custom UI gets the same rule from `createSwapFeeBreakdown(fee, swap)`;
-pass the swap, not just the fee.
-
-## Secrets
-
-`NWC_URI` and `LSC_URI_*` are server-only. Never put them in browser code,
-logs, assets, or tests. Boot fails closed if the NWC code advertises spend
-methods such as `pay_invoice` — mint a receive-only code
-(https://openreceive.org/get_a_nwc_code_to_receive_payments) instead of
-overriding.
-
-## Database tables
-
-```sh
-npx openreceive scaffold payments --orm prisma   # or drizzle | typeorm | sequelize | knex
-```
-
-emits the `openreceive_payments` + `openreceive_meta` migration for THIS app's
-database (Rails: `bin/rails generate openreceive:install`); run it through the
-app's normal migration workflow. The tables sit beside your models — no
-relations to them, no separate database, no Redis.
-
-## Verify, and test without a real wallet
-
-`npx openreceive doctor` checks the configuration and says what to fix.
-
-For tests, inject a fake wallet at the stable seams — `client` on
-`createOpenReceive` (any object with `preflight`, `makeInvoice`,
-`listTransactions`) or `config.nwc_client` in Rails — plus
-`StaticPriceProvider` for fiat pricing without a network. Your routes,
-persistence, reconcile, and `onPaid` then run the production code paths.
-Details: https://openreceive.org/guides/host-testing.md
-
-## Deeper documentation
-
-Fetch on demand — each URL is raw markdown:
-https://openreceive.org/guides/authorization.md ·
-https://openreceive.org/guides/storage.md ·
-https://openreceive.org/guides/api-reference.md ·
-https://openreceive.org/guides/security.md ·
-https://openreceive.org/openapi.yaml (the normative HTTP contract) ·
-https://openreceive.org/llms.txt (the full index)