@openreceive/browser 0.3.1 → 0.3.2

package/dist/headless.js

@@ -54,6 +54,7 @@ import {
   createTransientFeedbackController,
   createWizardRouteAssetDisplays,
   createWizardRouteDisplays,
+  currentCheckoutUrl,
   deriveCheckoutStateLabels,
   deriveStatus,
   enterCheckoutResumePath,
@@ -62,6 +63,7 @@ import {
   formatAmountCaption,
   formatDepositAmount,
   formatFiatAmount,
+  formatMethodNetworkDetail,
   formatMsats,
   formatNetworkSummary,
   formatSwapLimit,
@@ -100,8 +102,10 @@ import {
   prepareCheckout,
   requestCheckout,
   requestSwapRefund,
+  requestSwapStatus,
   resolveTransactionDetailRows,
   resolveWizardSelection,
+  resumeSwapAttempt,
   selectCheckoutDisplayInvoice,
   selectCurrentSwapInvoice,
   startSwapRequest,
@@ -111,14 +115,18 @@ import {
   swapOptionLimitSentence,
   swapPickerKey,
   updatePaymentWizardSelection
-} from "./chunk-JR3DCSHN.js";
+} from "./chunk-D4S2GCC4.js";
+
+// src/headless.ts
+import { createAssetBaseUrlResolver, getPaymentWizardRoutes } from "@openreceive/provider-data";
 
 // src/internal/checkout-props.ts
 var CREATE_MODE_ONLY_PROPS = [
   "metadata",
   "syncUrl",
   "resumePathPrefix",
-  "routeReference"
+  "routeReference",
+  "resumePaymentHash"
 ];
 var warnedSnapshotModeProps = /* @__PURE__ */ new Set();
 function validateCheckoutProps(props) {
@@ -412,6 +420,9 @@ function createModeAttributes(options) {
   if (options.routeReference !== void 0) {
     attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.routeReference] = options.routeReference;
   }
+  if (options.resumePaymentHash !== void 0) {
+    attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.resumePaymentHash] = options.resumePaymentHash;
+  }
   return attributes;
 }
 function sharedElementAttributes(options) {
@@ -595,10 +606,6 @@ function createCheckoutShell(snapshot, options = {}) {
     themeToggle
   };
 }
-
-// src/headless.ts
-import { createAssetBaseUrlResolver } from "@openreceive/provider-data";
-import { getPaymentWizardRoutes } from "@openreceive/provider-data";
 export {
   BrowserRequestError,
   OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES,
@@ -666,6 +673,7 @@ export {
   createTransientFeedbackController,
   createWizardRouteAssetDisplays,
   createWizardRouteDisplays,
+  currentCheckoutUrl,
   deriveCheckoutStateLabels,
   deriveStatus,
   enterCheckoutResumePath,
@@ -673,6 +681,7 @@ export {
   formatAmountCaption,
   formatDepositAmount,
   formatFiatAmount,
+  formatMethodNetworkDetail,
   formatMsats,
   formatNetworkSummary,
   formatSwapLimit,
@@ -711,8 +720,10 @@ export {
   readThemePreference,
   requestCheckout,
   requestSwapRefund,
+  requestSwapStatus,
   resolveTransactionDetailRows,
   resolveWizardSelection,
+  resumeSwapAttempt,
   selectCheckoutDisplayInvoice,
   selectCurrentSwapInvoice,
   startSwapRequest,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { aQ as BrowserLogLevel } from './status-BZEGi6Ca.js';
-export { aR as BrowserLogEntry, V as BrowserLogger, B as BrowserLoggerOption, X as BrowserRequestError, Y as CheckoutController, Z as CheckoutControllerOptions, g as CheckoutSnapshot, i as CheckoutState, aS as CopyInvoiceOptions, aT as GuestCheckoutResumeController, aU as GuestCheckoutResumeOptions, aV as OpenWalletOptions, aW as PrepareCheckoutOptions, aX as QrOptions, aY as RequestCheckoutOptions, an as Status, aZ as StatusInvoiceLike, U as UnixSeconds, as as copyInvoice, au as createCheckoutController, a_ as createGuestCheckoutResume, a$ as createGuestOrderFetcher, b0 as createLightningUri, b1 as createQrPngDataUrl, az as createQrSvg, aE as deriveStatus, aF as enterCheckoutResumePath, aN as openWallet, aO as prepareCheckout, aP as requestCheckout } from './status-BZEGi6Ca.js';
+import { aR as BrowserLogLevel } from './status-BMYd00Xn.js';
+export { aS as BrowserLogEntry, V as BrowserLogger, B as BrowserLoggerOption, X as BrowserRequestError, Y as CheckoutController, Z as CheckoutControllerOptions, g as CheckoutSnapshot, i as CheckoutState, aT as CopyInvoiceOptions, aU as GuestCheckoutResumeController, aV as GuestCheckoutResumeOptions, aW as OpenWalletOptions, aX as PrepareCheckoutOptions, aY as QrOptions, aZ as RequestCheckoutOptions, an as Status, a_ as StatusInvoiceLike, U as UnixSeconds, as as copyInvoice, au as createCheckoutController, a$ as createGuestCheckoutResume, b0 as createGuestOrderFetcher, b1 as createLightningUri, b2 as createQrPngDataUrl, az as createQrSvg, aF as deriveStatus, aG as enterCheckoutResumePath, aO as openWallet, aP as prepareCheckout, aQ as requestCheckout } from './status-BMYd00Xn.js';
 import '@openreceive/provider-data';
 import '@openreceive/core';
 

package/dist/index.js

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

package/dist/{status-BZEGi6Ca.d.ts → status-BMYd00Xn.d.ts}

@@ -1,18 +1,6 @@
 import { PaymentWizardRoute, AssetIndexEntry } from '@openreceive/provider-data';
 import { TransactionSettlementStatus } from '@openreceive/core';
 
-/**
- * A unix timestamp in **seconds** — the unit every OpenReceive wire field uses
- * (`expires_at`, `provider_expires_at`, `settled_at`, `paid_at`) and therefore
- * the unit every `now` option compares against.
- *
- * It is a plain `number`; the alias exists so the unit shows up where the
- * option does. `Date.now()` is MILLISECONDS and is the wrong value here —
- * {@link resolveNow} rejects it rather than letting every invoice read as
- * expired. Use `Math.floor(Date.now() / 1000)`.
- */
-type UnixSeconds = number;
-
 /**
  * Trim insignificant trailing zeros from a decimal crypto amount for display,
  * e.g. "12.25900000" -> "12.259" and "5.000" -> "5". Only fractional digits are
@@ -268,6 +256,12 @@ declare const OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES: {
      * push/replace the URL via the History API.
      */
     readonly routeReference: "route-reference";
+    /**
+     * Create mode only. Payment hash of a swap attempt this order already has in
+     * flight; the element reopens it after prepare instead of showing the method
+     * grid. A hash the server will not serve is ignored.
+     */
+    readonly resumePaymentHash: "resume-payment-hash";
     /**
      * 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
@@ -305,6 +299,18 @@ declare const OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES: {
     readonly storageKey: "storage-key";
 };
 
+/**
+ * A unix timestamp in **seconds** — the unit every OpenReceive wire field uses
+ * (`expires_at`, `provider_expires_at`, `settled_at`, `paid_at`) and therefore
+ * the unit every `now` option compares against.
+ *
+ * It is a plain `number`; the alias exists so the unit shows up where the
+ * option does. `Date.now()` is MILLISECONDS and is the wrong value here —
+ * {@link resolveNow} rejects it rather than letting every invoice read as
+ * expired. Use `Math.floor(Date.now() / 1000)`.
+ */
+type UnixSeconds = number;
+
 interface TransientFeedbackOptions<T> {
     readonly resetValue: T;
     readonly delayMs?: number;
@@ -537,6 +543,13 @@ interface SwapDisplayModel {
      * to notice: render this string, never either label directly.
      */
     readonly refundReturnLabel: string;
+    /**
+     * Whether the host declared this checkout resumable — the fact
+     * {@link SwapDisplayModel.refundReturnLabel} was chosen from. Exposed so a UI
+     * can render the affordance the sentence names (a copy button for the URL)
+     * without re-deriving the decision or string-matching the label.
+     */
+    readonly resumable: boolean;
     readonly refundTxId?: string;
     readonly refundReason?: string;
     readonly depositReceivedAmount?: string;
@@ -640,6 +653,12 @@ interface CheckoutElementAttributeOptions {
      * Order id from the app router (e.g. Next.js). When set, skip History API URL sync.
      */
     readonly routeReference?: string;
+    /**
+     * Payment hash of a swap attempt this order already has in flight. Create
+     * mode reopens it after prepare instead of showing the method grid; a hash
+     * the server will not serve is ignored.
+     */
+    readonly resumePaymentHash?: string;
     /**
      * 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.
@@ -1221,6 +1240,16 @@ declare function enterCheckoutResumePath(reference: string, options?: {
     /** When set, skip History API sync (Next.js / file-based routes own the URL). */
     readonly routeReference?: string;
 }): void;
+/**
+ * The URL a resumable checkout tells the payer to copy, or `undefined` off a
+ * browser.
+ *
+ * `checkoutLabels.refundReturnWarning` says "Bookmark this page, or copy its
+ * URL", and a sentence that names an affordance should be next to one. Both
+ * renderers read it through this function so the refund screens cannot disagree
+ * about what "its URL" means.
+ */
+declare function currentCheckoutUrl(): string | undefined;
 /**
  * Guest resume fetch for a host-owned order endpoint. OpenReceive ships no order-read route.
  * Pass the result as `fetchOrder` to {@link createGuestCheckoutResume}.
@@ -1252,4 +1281,4 @@ declare function deriveStatus(invoice: StatusInvoiceLike, options?: {
     readonly now?: UnixSeconds;
 }): Status;
 
-export { type CheckoutStatusRefresh as $, type ThemeToggleElementAttributes as A, type BrowserLoggerOption as B, type CheckoutInvoiceSnapshot as C, type StoredThemeModelOptions as D, type ThemeModel as E, type ThemeModelOptions as F, type ReadThemePreferenceOptions as G, type ThemeControlTargets as H, type ThemeStorageOptions as I, type PaymentWizardControllerOptions as J, type PaymentWizardController as K, type PaymentWizardSelection as L, type PaymentWizardModel as M, type WizardRouteDisplay as N, type PaymentWizardSelectionAction as O, type ParseOpenReceiveOptionalIntegerOptions as P, type BrowserLogContext as Q, type ResolvedTheme as R, type SwapDisplayModel as S, type ThemePreference as T, type UnixSeconds as U, type BrowserLogger as V, type WizardRouteAssetDisplay as W, BrowserRequestError as X, type CheckoutController as Y, type CheckoutControllerOptions as Z, type CheckoutPhase as _, type PaymentMethod as a, createGuestOrderFetcher as a$, OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES as a0, OPENRECEIVE_CHECKOUT_DATA_SELECTORS as a1, OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES as a2, OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS as a3, OPENRECEIVE_CHECKOUT_ELEMENT_PARTS as a4, OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS as a5, OPENRECEIVE_CHECKOUT_ELEMENT_SLOTS as a6, OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME as a7, OPENRECEIVE_COPY_FEEDBACK_MS as a8, OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS as a9, createQrSvgController as aA, createStatusFetcher as aB, createThemeChangeEvent as aC, deriveCheckoutStateLabels as aD, deriveStatus as aE, enterCheckoutResumePath as aF, escapeHtml as aG, formatAmountCaption as aH, formatDepositAmount as aI, formatFiatAmount as aJ, formatMsats as aK, formatSwapLimit as aL, formatUnixTime as aM, openWallet as aN, prepareCheckout as aO, requestCheckout as aP, type BrowserLogLevel as aQ, type BrowserLogEntry as aR, type CopyInvoiceOptions as aS, type GuestCheckoutResumeController as aT, type GuestCheckoutResumeOptions as aU, type OpenWalletOptions as aV, type PrepareCheckoutOptions as aW, type QrOptions as aX, type RequestCheckoutOptions as aY, type StatusInvoiceLike as aZ, createGuestCheckoutResume as a_, OPENRECEIVE_DEFAULT_PREFIX as aa, OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES as ab, OPENRECEIVE_PAYMENT_WIZARD_SELECTORS as ac, OPENRECEIVE_PROVIDER_PREVIEW_LIMIT as ad, OPENRECEIVE_THEME_STORAGE_KEY as ae, OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES as af, OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS as ag, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS as ah, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS as ai, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME as aj, type QrEncoder as ak, type QrSvgController as al, type QrSvgControllerOptions as am, type Status as an, type SwapCopyRow as ao, type SwapRefundStaging as ap, type WizardProviderDisplay as aq, assertDisplayInvoice as ar, copyInvoice as as, createCheckoutActionEvent as at, createCheckoutController as au, createCheckoutErrorEvent as av, createCheckoutProviderCopyEvent as aw, createCheckoutStateEvent as ax, createQrPayloadSvg as ay, createQrSvg as az, type PaymentMethodOption as b, createLightningUri as b0, createQrPngDataUrl as b1, type TickingValueOptions as c, type TickingValueController as d, type TransientFeedbackOptions as e, type TransientFeedbackController as f, type CheckoutSnapshot as g, type SwapDepositRisk as h, type CheckoutState as i, type TransactionDetailsInput as j, type TransactionDetailRow as k, type CreateCheckoutStateOptions as l, type CheckoutStatusModelInput as m, type CheckoutStatusModel as n, type CheckoutPaymentMethod as o, type ThemeAttributeTarget as p, type CheckoutElementAttributes as q, type CheckoutElementAttributeOptions as r, type CheckoutElementEventHandlers as s, type CheckoutElementListeners as t, type CreateCheckoutShellOptions as u, type CheckoutShellElements as v, type CheckoutShellOptions as w, type CheckoutShellModel as x, type CreateOpenReceiveThemeToggleElementOptions as y, type ThemeToggleElementAttributeOptions as z };
+export { type CheckoutStatusRefresh as $, type ThemeToggleElementAttributes as A, type BrowserLoggerOption as B, type CheckoutInvoiceSnapshot as C, type StoredThemeModelOptions as D, type ThemeModel as E, type ThemeModelOptions as F, type ReadThemePreferenceOptions as G, type ThemeControlTargets as H, type ThemeStorageOptions as I, type PaymentWizardControllerOptions as J, type PaymentWizardController as K, type PaymentWizardSelection as L, type PaymentWizardModel as M, type WizardRouteDisplay as N, type PaymentWizardSelectionAction as O, type ParseOpenReceiveOptionalIntegerOptions as P, type BrowserLogContext as Q, type ResolvedTheme as R, type SwapDisplayModel as S, type ThemePreference as T, type UnixSeconds as U, type BrowserLogger as V, type WizardRouteAssetDisplay as W, BrowserRequestError as X, type CheckoutController as Y, type CheckoutControllerOptions as Z, type CheckoutPhase as _, type PaymentMethod as a, createGuestCheckoutResume as a$, OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES as a0, OPENRECEIVE_CHECKOUT_DATA_SELECTORS as a1, OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES as a2, OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS as a3, OPENRECEIVE_CHECKOUT_ELEMENT_PARTS as a4, OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS as a5, OPENRECEIVE_CHECKOUT_ELEMENT_SLOTS as a6, OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME as a7, OPENRECEIVE_COPY_FEEDBACK_MS as a8, OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS as a9, createQrSvgController as aA, createStatusFetcher as aB, createThemeChangeEvent as aC, currentCheckoutUrl as aD, deriveCheckoutStateLabels as aE, deriveStatus as aF, enterCheckoutResumePath as aG, escapeHtml as aH, formatAmountCaption as aI, formatDepositAmount as aJ, formatFiatAmount as aK, formatMsats as aL, formatSwapLimit as aM, formatUnixTime as aN, openWallet as aO, prepareCheckout as aP, requestCheckout as aQ, type BrowserLogLevel as aR, type BrowserLogEntry as aS, type CopyInvoiceOptions as aT, type GuestCheckoutResumeController as aU, type GuestCheckoutResumeOptions as aV, type OpenWalletOptions as aW, type PrepareCheckoutOptions as aX, type QrOptions as aY, type RequestCheckoutOptions as aZ, type StatusInvoiceLike as a_, OPENRECEIVE_DEFAULT_PREFIX as aa, OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES as ab, OPENRECEIVE_PAYMENT_WIZARD_SELECTORS as ac, OPENRECEIVE_PROVIDER_PREVIEW_LIMIT as ad, OPENRECEIVE_THEME_STORAGE_KEY as ae, OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES as af, OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS as ag, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS as ah, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS as ai, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME as aj, type QrEncoder as ak, type QrSvgController as al, type QrSvgControllerOptions as am, type Status as an, type SwapCopyRow as ao, type SwapRefundStaging as ap, type WizardProviderDisplay as aq, assertDisplayInvoice as ar, copyInvoice as as, createCheckoutActionEvent as at, createCheckoutController as au, createCheckoutErrorEvent as av, createCheckoutProviderCopyEvent as aw, createCheckoutStateEvent as ax, createQrPayloadSvg as ay, createQrSvg as az, type PaymentMethodOption as b, createGuestOrderFetcher as b0, createLightningUri as b1, createQrPngDataUrl as b2, type TickingValueOptions as c, type TickingValueController as d, type TransientFeedbackOptions as e, type TransientFeedbackController as f, type CheckoutSnapshot as g, type SwapDepositRisk as h, type CheckoutState as i, type TransactionDetailsInput as j, type TransactionDetailRow as k, type CreateCheckoutStateOptions as l, type CheckoutStatusModelInput as m, type CheckoutStatusModel as n, type CheckoutPaymentMethod as o, type ThemeAttributeTarget as p, type CheckoutElementAttributes as q, type CheckoutElementAttributeOptions as r, type CheckoutElementEventHandlers as s, type CheckoutElementListeners as t, type CreateCheckoutShellOptions as u, type CheckoutShellElements as v, type CheckoutShellOptions as w, type CheckoutShellModel as x, type CreateOpenReceiveThemeToggleElementOptions as y, type ThemeToggleElementAttributeOptions as z };