@openreceive/browser 0.2.1 → 0.2.3

package/dist/headless.d.ts

@@ -1,5 +1,5 @@
-import { P as ParseOpenReceiveOptionalIntegerOptions, a as PaymentMethod, R as ResolvedTheme, T as ThemePreference, b as PaymentMethodOption, c as TickingValueOptions, d as TickingValueController, e as TransientFeedbackOptions, f as TransientFeedbackController, C as CheckoutInvoiceSnapshot, S as SwapDisplayModel, g as CheckoutInvoiceSwapSnapshot, h as CheckoutState, i as TransactionDetailsInput, j as TransactionDetailRow, k as CheckoutSnapshot, l as CreateCheckoutStateOptions, m as CheckoutStatusModelInput, n as CheckoutStatusModel, o as CheckoutPaymentMethod, B as BrowserLoggerOption, p as ThemeAttributeTarget, q as CheckoutElementAttributes, r as CheckoutElementAttributeOptions, s as CheckoutElementEventHandlers, t as CheckoutElementListeners, u as CreateCheckoutShellOptions, v as CheckoutShellElements, w as CheckoutShellOptions, x as CheckoutShellModel, y as CreateOpenReceiveThemeToggleElementOptions, z as ThemeToggleElementAttributeOptions, A as ThemeToggleElementAttributes, D as StoredThemeModelOptions, E as ThemeModel, F as ThemeModelOptions, G as ReadThemePreferenceOptions, H as ThemeControlTargets, I as ThemeStorageOptions, J as PaymentWizardControllerOptions, K as PaymentWizardController, L as PaymentWizardSelection, M as PaymentWizardModel, W as WizardRouteAssetDisplay, N as WizardRouteDisplay, O as PaymentWizardSelectionAction } from './status-CLCX5lfx.js';
-export { Q as BrowserLogContext, U as BrowserLogger, V as BrowserRequestError, X as CheckoutController, Y as CheckoutControllerOptions, Z as CheckoutPhase, _ as CheckoutStatusRefresh, $ as OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES, a0 as OPENRECEIVE_CHECKOUT_DATA_SELECTORS, a1 as OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES, a2 as OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS, a3 as OPENRECEIVE_CHECKOUT_ELEMENT_PARTS, a4 as OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS, a5 as OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, a6 as OPENRECEIVE_COPY_FEEDBACK_MS, a7 as OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS, a8 as OPENRECEIVE_DEFAULT_PREFIX, a9 as OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES, aa as OPENRECEIVE_PAYMENT_WIZARD_SELECTORS, ab as OPENRECEIVE_THEME_STORAGE_KEY, ac as OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES, ad as OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS, ae as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS, af as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS, ag as OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, ah as QrEncoder, ai as Status, aj as WizardProviderDisplay, ak as assertDisplayInvoice, al as copyInvoice, am as createCheckoutActionEvent, an as createCheckoutController, ao as createCheckoutErrorEvent, ap as createCheckoutProviderCopyEvent, aq as createCheckoutStateEvent, ar as createQrPayloadSvg, as as createQrSvg, at as createStatusFetcher, au as createThemeChangeEvent, av as deriveCheckoutStateLabels, aw as deriveStatus, ax as enterCheckoutResumePath, ay as escapeHtml, az as formatAmountCaption, aA as formatDepositAmount, aB as formatFiatAmount, aC as formatMsats, aD as formatSwapLimit, aE as formatUnixTime, aF as openWallet, aG as prepareCheckout, aH as requestCheckout } from './status-CLCX5lfx.js';
+import { P as ParseOpenReceiveOptionalIntegerOptions, a as PaymentMethod, R as ResolvedTheme, T as ThemePreference, b as PaymentMethodOption, c as TickingValueOptions, d as TickingValueController, e as TransientFeedbackOptions, f as TransientFeedbackController, C as CheckoutInvoiceSnapshot, U as UnixSeconds, S as SwapDisplayModel, g as CheckoutInvoiceSwapSnapshot, h as CheckoutState, i as TransactionDetailsInput, j as TransactionDetailRow, k as CheckoutSnapshot, l as CreateCheckoutStateOptions, m as CheckoutStatusModelInput, n as CheckoutStatusModel, o as CheckoutPaymentMethod, B as BrowserLoggerOption, p as ThemeAttributeTarget, q as CheckoutElementAttributes, r as CheckoutElementAttributeOptions, s as CheckoutElementEventHandlers, t as CheckoutElementListeners, u as CreateCheckoutShellOptions, v as CheckoutShellElements, w as CheckoutShellOptions, x as CheckoutShellModel, y as CreateOpenReceiveThemeToggleElementOptions, z as ThemeToggleElementAttributeOptions, A as ThemeToggleElementAttributes, D as StoredThemeModelOptions, E as ThemeModel, F as ThemeModelOptions, G as ReadThemePreferenceOptions, H as ThemeControlTargets, I as ThemeStorageOptions, J as PaymentWizardControllerOptions, K as PaymentWizardController, L as PaymentWizardSelection, M as PaymentWizardModel, W as WizardRouteAssetDisplay, N as WizardRouteDisplay, O as PaymentWizardSelectionAction } from './status-B1vDOhvh.js';
+export { Q as BrowserLogContext, V as BrowserLogger, X as BrowserRequestError, Y as CheckoutController, Z as CheckoutControllerOptions, _ as CheckoutPhase, $ as CheckoutStatusRefresh, a0 as OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES, a1 as OPENRECEIVE_CHECKOUT_DATA_SELECTORS, a2 as OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES, a3 as OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS, a4 as OPENRECEIVE_CHECKOUT_ELEMENT_PARTS, a5 as OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS, a6 as OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, a7 as OPENRECEIVE_COPY_FEEDBACK_MS, a8 as OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS, a9 as OPENRECEIVE_DEFAULT_PREFIX, aa as OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES, ab as OPENRECEIVE_PAYMENT_WIZARD_SELECTORS, ac as OPENRECEIVE_THEME_STORAGE_KEY, ad as OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES, ae as OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS, af as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS, ag as OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS, ah as OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, ai as QrEncoder, aj as Status, ak as WizardProviderDisplay, al as assertDisplayInvoice, am as copyInvoice, an as createCheckoutActionEvent, ao as createCheckoutController, ap as createCheckoutErrorEvent, aq as createCheckoutProviderCopyEvent, ar as createCheckoutStateEvent, as as createQrPayloadSvg, at as createQrSvg, au as createStatusFetcher, av as createThemeChangeEvent, aw as deriveCheckoutStateLabels, ax as deriveStatus, ay as enterCheckoutResumePath, az as escapeHtml, aA as formatAmountCaption, aB as formatDepositAmount, aC as formatFiatAmount, aD as formatMsats, aE as formatSwapLimit, aF as formatUnixTime, aG as openWallet, aH as prepareCheckout, aI as requestCheckout } from './status-B1vDOhvh.js';
 import { AssetIndexEntry, PaymentWizardRoute } from '@openreceive/provider-data';
 import '@openreceive/core';
 
@@ -258,8 +258,13 @@ declare function parsePaymentMethod(value: string | null): PaymentMethod | null;
 declare function createTransientFeedbackController<T>(options: TransientFeedbackOptions<T>): TransientFeedbackController<T>;
 declare function createTickingValueController(options: TickingValueOptions): TickingValueController;
 
+/**
+ * @param options.now Unix timestamp in **seconds** ({@link UnixSeconds}); the
+ *   provider countdown is measured against it. Milliseconds (`Date.now()`)
+ *   throw rather than pinning every deposit window at zero.
+ */
 declare function createSwapDisplayModel(invoice: CheckoutInvoiceSnapshot, options?: {
-    readonly now?: number;
+    readonly now?: UnixSeconds;
 }): SwapDisplayModel | undefined;
 /**
  * Poll snapshots omit the locally staged refund address/nonce. Overlay them so
@@ -379,7 +384,7 @@ declare function selectCheckoutDisplayInvoice(snapshot: CheckoutSnapshot): Check
  * seconds remaining. Pass an optional `now` (Unix seconds) for deterministic tests; defaults to the
  * current clock.
  */
-declare function isReusableLightningInvoice(expiresAt: number, now?: number): boolean;
+declare function isReusableLightningInvoice(expiresAt: number, now?: UnixSeconds): boolean;
 declare function createCheckoutState(snapshot: CheckoutSnapshot, options?: CreateCheckoutStateOptions): CheckoutState;
 /**
  * Wrap ONE payment attempt as a whole checkout snapshot.
@@ -399,7 +404,7 @@ declare function createCheckoutSnapshotFromInvoice(attempt: CheckoutInvoiceSnaps
     readonly reference?: string;
 }): CheckoutSnapshot;
 declare function createCheckoutStatusModel(source?: CheckoutState | CheckoutStatusModelInput, options?: {
-    readonly now?: number;
+    readonly now?: UnixSeconds;
 }): CheckoutStatusModel;
 
 /**
@@ -796,4 +801,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, CreateCheckoutShellOptions, type DetailLinkKind, type MethodGridEntry, type PaymentDataSource, PaymentMethod, PaymentWizardController, PaymentWizardModel, PaymentWizardSelection, ResolvedTheme, StoredThemeModelOptions, SwapDisplayModel, type SwapLimitContext, type SwapMethodGroup, type SwapSelection, type SwapUnavailableModel, ThemeModel, ThemeModelOptions, ThemePreference, ThemeToggleElementAttributeOptions, ThemeToggleElementAttributes, TransactionDetailRow, TransactionDetailsInput, type TransactionDetailsSource, TransientFeedbackController, WizardRouteAssetDisplay, WizardRouteDisplay, applyCheckoutElementAttributes, assetButtonClasses, buildMethodGridEntries, checkoutElementStyles, checkoutLabels, createBlockExplorerUrl, createCheckoutElementAttributes, createCheckoutElementListeners, createCheckoutSession, createCheckoutShell, createCheckoutShellModel, createCheckoutSnapshotFromInvoice, createCheckoutState, createCheckoutStatusModel, createDetailExternalLink, createLightningInvoiceDecodeUrl, createPaymentDataEntries, createPaymentWizardController, createPaymentWizardModel, createPaymentWizardSelection, createStoredThemeModel, createSwapDisplayModel, createSwapUnavailableModel, createThemeModel, createThemeToggleElement, createThemeToggleElementAttributes, createTickingValueController, createTransactionDetails, createTransactionDetailsFromState, createTransientFeedbackController, createWizardRouteAssetDisplays, createWizardRouteDisplays, findSwapGridGroup, formatChooseNetworkHeading, formatNetworkSummary, getExplorerNetwork, getNetworkIcon, getPaymentMethodIcon, getRouteNetworkLabel, getSwapOptionIcon, getSwapRefundFormError, getWizardEmptyMessage, isReusableLightningInvoice, mergeAttemptIntoCheckout, mergeAttemptIntoSnapshot, networkButtonClasses, networkCheckClasses, networkMobileRevealClasses, networkSummaryIconClasses, normalizeSwapStartInvoice, orClasses, overlaySwapRefundStaging, parseBooleanAttribute, parseMethodPickerKey, parseOptionalInteger, parsePaymentMethod, parseResolvedTheme, parseThemePreference, paymentAccentId, paymentIconUrls, paymentMethods, postJson, readThemePreference, requestSwapRefund, resolvePreservedNetworkSelection, resolveTransactionDetailRows, selectCheckoutDisplayInvoice, startSwapRequest, swapAssetMatchesRoute, swapGroupLimitOption, swapOptionLimitMessage, swapPickerKey, syncStoredThemeControls, toggleStoredThemeControls, updatePaymentWizardSelection, updateSelectedSwapNetworks, validateCheckoutProps, wizardNetworkGroupIds, writeThemePreference };
+export { BrowserLoggerOption, type CheckoutComponentProps, CheckoutElementAttributeOptions, CheckoutElementAttributes, CheckoutElementEventHandlers, CheckoutElementListeners, CheckoutInvoiceSnapshot, CheckoutPaymentMethod, type CheckoutPropsValidation, type CheckoutSession, type CheckoutSessionOptions, CheckoutShellElements, CheckoutShellModel, CheckoutShellOptions, CheckoutSnapshot, CheckoutState, CheckoutStatusModel, CreateCheckoutShellOptions, type DetailLinkKind, type MethodGridEntry, type PaymentDataSource, PaymentMethod, PaymentWizardController, PaymentWizardModel, PaymentWizardSelection, ResolvedTheme, StoredThemeModelOptions, SwapDisplayModel, type SwapLimitContext, type SwapMethodGroup, type SwapSelection, type SwapUnavailableModel, ThemeModel, ThemeModelOptions, ThemePreference, ThemeToggleElementAttributeOptions, ThemeToggleElementAttributes, TransactionDetailRow, TransactionDetailsInput, type TransactionDetailsSource, TransientFeedbackController, UnixSeconds, WizardRouteAssetDisplay, WizardRouteDisplay, applyCheckoutElementAttributes, assetButtonClasses, buildMethodGridEntries, checkoutElementStyles, checkoutLabels, createBlockExplorerUrl, createCheckoutElementAttributes, createCheckoutElementListeners, createCheckoutSession, createCheckoutShell, createCheckoutShellModel, createCheckoutSnapshotFromInvoice, createCheckoutState, createCheckoutStatusModel, createDetailExternalLink, createLightningInvoiceDecodeUrl, createPaymentDataEntries, createPaymentWizardController, createPaymentWizardModel, createPaymentWizardSelection, createStoredThemeModel, createSwapDisplayModel, createSwapUnavailableModel, createThemeModel, createThemeToggleElement, createThemeToggleElementAttributes, createTickingValueController, createTransactionDetails, createTransactionDetailsFromState, createTransientFeedbackController, createWizardRouteAssetDisplays, createWizardRouteDisplays, findSwapGridGroup, formatChooseNetworkHeading, formatNetworkSummary, getExplorerNetwork, getNetworkIcon, getPaymentMethodIcon, getRouteNetworkLabel, getSwapOptionIcon, getSwapRefundFormError, getWizardEmptyMessage, isReusableLightningInvoice, mergeAttemptIntoCheckout, mergeAttemptIntoSnapshot, networkButtonClasses, networkCheckClasses, networkMobileRevealClasses, networkSummaryIconClasses, normalizeSwapStartInvoice, orClasses, overlaySwapRefundStaging, parseBooleanAttribute, parseMethodPickerKey, parseOptionalInteger, parsePaymentMethod, parseResolvedTheme, parseThemePreference, paymentAccentId, paymentIconUrls, paymentMethods, postJson, readThemePreference, requestSwapRefund, resolvePreservedNetworkSelection, resolveTransactionDetailRows, selectCheckoutDisplayInvoice, startSwapRequest, swapAssetMatchesRoute, swapGroupLimitOption, swapOptionLimitMessage, swapPickerKey, syncStoredThemeControls, toggleStoredThemeControls, updatePaymentWizardSelection, updateSelectedSwapNetworks, validateCheckoutProps, wizardNetworkGroupIds, writeThemePreference };

package/dist/headless.js

@@ -56,6 +56,7 @@ import {
   deriveStatus,
   enterCheckoutResumePath,
   escapeHtml,
+  findReusableLightningInvoice,
   findSwapGridGroup,
   formatAmountCaption,
   formatChooseNetworkHeading,
@@ -74,6 +75,9 @@ import {
   getWizardEmptyMessage,
   isPaidCheckoutSnapshot,
   isReusableLightningInvoice,
+  mergeAttemptIntoCheckout,
+  mergeAttemptIntoSnapshot,
+  mergeMintedCheckout,
   networkButtonClasses,
   networkCheckClasses,
   networkMobileRevealClasses,
@@ -107,52 +111,7 @@ import {
   updatePaymentWizardSelection,
   updateSelectedSwapNetworks,
   wizardNetworkGroupIds
-} from "./chunk-V7C55QB2.js";
-
-// src/internal/checkout-merge.ts
-function findReusableLightningInvoice(snapshot, now) {
-  return snapshot.invoices.find(
-    (invoice) => invoice.rail === "lightning" && typeof invoice.invoice === "string" && invoice.invoice.length > 0 && invoice.expires_at !== void 0 && isReusableLightningInvoice(invoice.expires_at, now)
-  );
-}
-function mergeAttemptIntoSnapshot(invoice, base) {
-  const withoutSame = base.invoices.filter(
-    (entry) => entry.invoice_id !== invoice.invoice_id && entry.rail !== "checkout_lock"
-  );
-  return {
-    ...base,
-    checkout_id: invoice.invoice_id,
-    active: invoice,
-    invoices: [invoice, ...withoutSame],
-    ...invoice.amount_msats === void 0 ? {} : { amount_msats: invoice.amount_msats }
-  };
-}
-function mergeAttemptIntoCheckout(invoice, previous, reference) {
-  const base = previous ?? {
-    checkout_id: invoice.invoice_id,
-    reference,
-    status: "open",
-    amount_msats: invoice.amount_msats ?? 0,
-    invoices: []
-  };
-  return mergeAttemptIntoSnapshot(invoice, base);
-}
-function mergeMintedCheckout(checkout, previous) {
-  const minted = selectCheckoutDisplayInvoice(checkout) ?? checkout.active;
-  if (minted === void 0) {
-    return {
-      ...checkout,
-      ...previous?.payment_methods === void 0 ? {} : { payment_methods: previous.payment_methods }
-    };
-  }
-  if (previous === void 0) return mergeAttemptIntoSnapshot(minted, checkout);
-  return mergeAttemptIntoSnapshot(minted, {
-    ...previous,
-    ...checkout,
-    invoices: previous.invoices,
-    payment_methods: previous.payment_methods ?? checkout.payment_methods
-  });
-}
+} from "./chunk-JFJBHGR4.js";
 
 // src/internal/checkout-props.ts
 var CREATE_MODE_ONLY_PROPS = [

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { aI as BrowserLogLevel } from './status-CLCX5lfx.js';
-export { aJ as BrowserLogEntry, U as BrowserLogger, B as BrowserLoggerOption, V as BrowserRequestError, X as CheckoutController, Y as CheckoutControllerOptions, k as CheckoutSnapshot, h as CheckoutState, aK as CopyInvoiceOptions, aL as GuestCheckoutResumeController, aM as GuestCheckoutResumeOptions, aN as OpenWalletOptions, aO as PrepareCheckoutOptions, aP as QrOptions, aQ as RequestCheckoutOptions, ai as Status, aR as StatusInvoiceLike, al as copyInvoice, an as createCheckoutController, aS as createGuestCheckoutResume, aT as createGuestOrderFetcher, aU as createLightningUri, aV as createQrPngDataUrl, as as createQrSvg, aw as deriveStatus, ax as enterCheckoutResumePath, aF as openWallet, aG as prepareCheckout, aH as requestCheckout } from './status-CLCX5lfx.js';
+import { aJ as BrowserLogLevel } from './status-B1vDOhvh.js';
+export { aK as BrowserLogEntry, V as BrowserLogger, B as BrowserLoggerOption, X as BrowserRequestError, Y as CheckoutController, Z as CheckoutControllerOptions, k as CheckoutSnapshot, h as CheckoutState, aL as CopyInvoiceOptions, aM as GuestCheckoutResumeController, aN as GuestCheckoutResumeOptions, aO as OpenWalletOptions, aP as PrepareCheckoutOptions, aQ as QrOptions, aR as RequestCheckoutOptions, aj as Status, aS as StatusInvoiceLike, U as UnixSeconds, am as copyInvoice, ao as createCheckoutController, aT as createGuestCheckoutResume, aU as createGuestOrderFetcher, aV as createLightningUri, aW as createQrPngDataUrl, at as createQrSvg, ax as deriveStatus, ay as enterCheckoutResumePath, aG as openWallet, aH as prepareCheckout, aI as requestCheckout } from './status-B1vDOhvh.js';
 import '@openreceive/provider-data';
 import '@openreceive/core';
 

package/dist/index.js

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

package/dist/{status-CLCX5lfx.d.ts → status-B1vDOhvh.d.ts}

@@ -1,6 +1,18 @@
 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
@@ -273,7 +285,8 @@ interface TransientFeedbackController<T> {
 interface TickingValueOptions {
     readonly active?: boolean;
     readonly intervalMs?: number;
-    readonly now?: () => number;
+    /** Clock returning unix **seconds** ({@link UnixSeconds}), not milliseconds. */
+    readonly now?: () => UnixSeconds;
     readonly setInterval?: typeof globalThis.setInterval;
     readonly clearInterval?: typeof globalThis.clearInterval;
     readonly onValue: (value: number) => void;
@@ -611,7 +624,20 @@ interface CheckoutStatusModel {
     readonly countdownLabel?: string;
 }
 type CheckoutStatusRefresh = (reference: string) => Promise<CheckoutSnapshot | null>;
-type RequestCheckoutOptions = RequestCheckoutBaseOptions;
+interface RequestCheckoutOptions extends RequestCheckoutBaseOptions {
+    /**
+     * The snapshot already on screen — normally what {@link prepareCheckout}
+     * returned, or the running snapshot after an earlier attempt.
+     *
+     * `POST /checkouts` answers with the minted bolt11 alone; it does NOT carry
+     * the warmed `payment_methods` catalog that prepare returned. Without this,
+     * minting Lightning ERASES the method list a picker renders from: the payer
+     * selects Bitcoin, changes their mind, and the swap options are gone.
+     * Passing the previous snapshot folds the mint into it, keeping
+     * `payment_methods` and any sibling attempts.
+     */
+    readonly previous?: CheckoutSnapshot;
+}
 /**
  * `prepareCheckout` posts only the order id — it locks the amount and lists
  * payment methods without minting — so there is no memo or metadata to carry.
@@ -645,7 +671,8 @@ interface CheckoutWatcherOptions {
     readonly snapshot: CheckoutSnapshot;
     readonly refreshStatus?: CheckoutStatusRefresh;
     readonly pollIntervalMs?: number;
-    readonly now?: () => number;
+    /** Clock returning unix **seconds** ({@link UnixSeconds}), not milliseconds. */
+    readonly now?: () => UnixSeconds;
     readonly setInterval?: typeof globalThis.setInterval;
     readonly clearInterval?: typeof globalThis.clearInterval;
     readonly logger?: BrowserLoggerOption;
@@ -680,7 +707,12 @@ interface CheckoutController {
     openWallet(): string;
 }
 interface CreateCheckoutStateOptions {
-    readonly now?: number;
+    /**
+     * Unix timestamp in **seconds** ({@link UnixSeconds}) the expiry clock is
+     * measured against; defaults to the current time. Milliseconds
+     * (`Date.now()`) throw a RangeError — see the type.
+     */
+    readonly now?: UnixSeconds;
     readonly logger?: BrowserLoggerOption;
     /**
      * How this state was produced. Controls which browser log events fire:
@@ -956,8 +988,14 @@ interface StatusInvoiceLike {
     readonly transaction_state?: string;
     readonly expires_at?: number | string | null;
 }
+/**
+ * @param options.now Unix timestamp in **seconds** ({@link UnixSeconds}) to
+ *   compare `expires_at` against; defaults to the current time. Milliseconds
+ *   (`Date.now()`) throw a RangeError rather than reading every invoice as
+ *   expired.
+ */
 declare function deriveStatus(invoice: StatusInvoiceLike, options?: {
-    readonly now?: number;
+    readonly now?: UnixSeconds;
 }): Status;
 
-export { OPENRECEIVE_CHECKOUT_DATA_ATTRIBUTES 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 BrowserLogger as U, BrowserRequestError as V, type WizardRouteAssetDisplay as W, type CheckoutController as X, type CheckoutControllerOptions as Y, type CheckoutPhase as Z, type CheckoutStatusRefresh as _, type PaymentMethod as a, OPENRECEIVE_CHECKOUT_DATA_SELECTORS as a0, OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES as a1, OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS as a2, OPENRECEIVE_CHECKOUT_ELEMENT_PARTS as a3, OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS as a4, OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME as a5, OPENRECEIVE_COPY_FEEDBACK_MS as a6, OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS as a7, OPENRECEIVE_DEFAULT_PREFIX as a8, OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES as a9, formatDepositAmount as aA, formatFiatAmount as aB, formatMsats as aC, formatSwapLimit as aD, formatUnixTime as aE, openWallet as aF, prepareCheckout as aG, requestCheckout as aH, type BrowserLogLevel as aI, type BrowserLogEntry as aJ, type CopyInvoiceOptions as aK, type GuestCheckoutResumeController as aL, type GuestCheckoutResumeOptions as aM, type OpenWalletOptions as aN, type PrepareCheckoutOptions as aO, type QrOptions as aP, type RequestCheckoutOptions as aQ, type StatusInvoiceLike as aR, createGuestCheckoutResume as aS, createGuestOrderFetcher as aT, createLightningUri as aU, createQrPngDataUrl as aV, OPENRECEIVE_PAYMENT_WIZARD_SELECTORS as aa, OPENRECEIVE_THEME_STORAGE_KEY as ab, OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES as ac, OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS as ad, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS as ae, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS as af, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME as ag, type QrEncoder as ah, type Status as ai, type WizardProviderDisplay as aj, assertDisplayInvoice as ak, copyInvoice as al, createCheckoutActionEvent as am, createCheckoutController as an, createCheckoutErrorEvent as ao, createCheckoutProviderCopyEvent as ap, createCheckoutStateEvent as aq, createQrPayloadSvg as ar, createQrSvg as as, createStatusFetcher as at, createThemeChangeEvent as au, deriveCheckoutStateLabels as av, deriveStatus as aw, enterCheckoutResumePath as ax, escapeHtml as ay, formatAmountCaption as az, type PaymentMethodOption as b, type TickingValueOptions as c, type TickingValueController as d, type TransientFeedbackOptions as e, type TransientFeedbackController as f, type CheckoutInvoiceSwapSnapshot as g, type CheckoutState as h, type TransactionDetailsInput as i, type TransactionDetailRow as j, type CheckoutSnapshot 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, 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_TAG_NAME as a6, OPENRECEIVE_COPY_FEEDBACK_MS as a7, OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS as a8, OPENRECEIVE_DEFAULT_PREFIX as a9, formatAmountCaption as aA, formatDepositAmount as aB, formatFiatAmount as aC, formatMsats as aD, formatSwapLimit as aE, formatUnixTime as aF, openWallet as aG, prepareCheckout as aH, requestCheckout as aI, type BrowserLogLevel as aJ, type BrowserLogEntry as aK, type CopyInvoiceOptions as aL, type GuestCheckoutResumeController as aM, type GuestCheckoutResumeOptions as aN, type OpenWalletOptions as aO, type PrepareCheckoutOptions as aP, type QrOptions as aQ, type RequestCheckoutOptions as aR, type StatusInvoiceLike as aS, createGuestCheckoutResume as aT, createGuestOrderFetcher as aU, createLightningUri as aV, createQrPngDataUrl as aW, OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES as aa, OPENRECEIVE_PAYMENT_WIZARD_SELECTORS as ab, OPENRECEIVE_THEME_STORAGE_KEY as ac, OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES as ad, OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS as ae, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PARTS as af, OPENRECEIVE_THEME_TOGGLE_ELEMENT_PART_SELECTORS as ag, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME as ah, type QrEncoder as ai, type Status as aj, type WizardProviderDisplay as ak, assertDisplayInvoice as al, copyInvoice as am, createCheckoutActionEvent as an, createCheckoutController as ao, createCheckoutErrorEvent as ap, createCheckoutProviderCopyEvent as aq, createCheckoutStateEvent as ar, createQrPayloadSvg as as, createQrSvg as at, createStatusFetcher as au, createThemeChangeEvent as av, deriveCheckoutStateLabels as aw, deriveStatus as ax, enterCheckoutResumePath as ay, escapeHtml as az, type PaymentMethodOption as b, type TickingValueOptions as c, type TickingValueController as d, type TransientFeedbackOptions as e, type TransientFeedbackController as f, type CheckoutInvoiceSwapSnapshot as g, type CheckoutState as h, type TransactionDetailsInput as i, type TransactionDetailRow as j, type CheckoutSnapshot 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openreceive/browser",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Framework-free browser helpers for OpenReceive checkout: prepare/create calls, status polling, QR and wallet helpers.",
   "keywords": [
     "bitcoin",
@@ -31,8 +31,8 @@
     "./assets/*": "./dist/assets/*"
   },
   "dependencies": {
-    "@openreceive/core": "0.2.1",
-    "@openreceive/provider-data": "0.2.1",
+    "@openreceive/core": "0.2.3",
+    "@openreceive/provider-data": "0.2.3",
     "qrcode": "^1.5.4"
   },
   "devDependencies": {