@openreceive/browser 0.2.4 → 0.3.1

package/dist/headless.js

@@ -6,12 +6,14 @@ import {
   OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS,
   OPENRECEIVE_CHECKOUT_ELEMENT_PARTS,
   OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS,
+  OPENRECEIVE_CHECKOUT_ELEMENT_SLOTS,
   OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME,
   OPENRECEIVE_COPY_FEEDBACK_MS,
   OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS,
   OPENRECEIVE_DEFAULT_PREFIX,
   OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES,
   OPENRECEIVE_PAYMENT_WIZARD_SELECTORS,
+  OPENRECEIVE_PROVIDER_PREVIEW_LIMIT,
   OPENRECEIVE_THEME_STORAGE_KEY,
   OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES,
   OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS,
@@ -23,7 +25,6 @@ import {
   buildMethodGridEntries,
   checkoutElementStyles,
   checkoutLabels,
-  checkoutRoutes,
   copyInvoice,
   createBlockExplorerUrl,
   createCheckoutActionEvent,
@@ -36,12 +37,13 @@ import {
   createCheckoutStatusModel,
   createDetailExternalLink,
   createLightningInvoiceDecodeUrl,
-  createPaymentDataEntries,
+  createMethodGridDisplay,
   createPaymentWizardController,
   createPaymentWizardModel,
   createPaymentWizardSelection,
   createQrPayloadSvg,
   createQrSvg,
+  createQrSvgController,
   createStatusFetcher,
   createSwapDisplayModel,
   createSwapUnavailableModel,
@@ -57,9 +59,7 @@ import {
   enterCheckoutResumePath,
   escapeHtml,
   findReusableLightningInvoice,
-  findSwapGridGroup,
   formatAmountCaption,
-  formatChooseNetworkHeading,
   formatDepositAmount,
   formatFiatAmount,
   formatMsats,
@@ -69,6 +69,7 @@ import {
   getExplorerNetwork,
   getNetworkIcon,
   getPaymentMethodIcon,
+  getRouteIconPath,
   getRouteNetworkLabel,
   getSwapOptionIcon,
   getSwapRefundFormError,
@@ -82,10 +83,9 @@ import {
   networkCheckClasses,
   networkMobileRevealClasses,
   networkSummaryIconClasses,
+  normalizeSwapStartInvoice,
   openWallet,
-  optionalSafeInteger,
   orClasses,
-  overlaySwapRefundStaging,
   parseBooleanAttribute,
   parseMethodPickerKey,
   parseOptionalInteger,
@@ -96,25 +96,22 @@ import {
   paymentIconPaths,
   paymentIconUrls,
   paymentMethods,
+  postJson,
   prepareCheckout,
-  readJsonResponse,
   requestCheckout,
-  requestHeaders,
-  resolveBrowserLogger,
-  resolvePreservedNetworkSelection,
+  requestSwapRefund,
   resolveTransactionDetailRows,
-  sanitizeBrowserLogEntry,
+  resolveWizardSelection,
   selectCheckoutDisplayInvoice,
+  selectCurrentSwapInvoice,
+  startSwapRequest,
   swapAssetMatchesRoute,
   swapDepositRisk,
-  swapGroupLimitOption,
   swapOptionLimitMessage,
   swapOptionLimitSentence,
   swapPickerKey,
-  updatePaymentWizardSelection,
-  updateSelectedSwapNetworks,
-  wizardNetworkGroupIds
-} from "./chunk-GA4FMG7L.js";
+  updatePaymentWizardSelection
+} from "./chunk-JR3DCSHN.js";
 
 // src/internal/checkout-props.ts
 var CREATE_MODE_ONLY_PROPS = [
@@ -144,201 +141,13 @@ function validateCheckoutProps(props) {
 }
 
 // src/internal/checkout-session.ts
-import { recordOrEmpty as recordOrEmpty2 } from "@openreceive/core";
-
-// src/internal/swap-http.ts
-import { nonEmptyString, recordOrEmpty } from "@openreceive/core";
-async function postJson(options) {
-  const { body } = options;
-  const routes = checkoutRoutes(options.prefix);
-  const reference = nonEmptyString(body.reference);
-  const action = nonEmptyString(body.action);
-  if (action !== void 0 && action !== "swap_quote" && action !== "refund_swap") {
-    throw new Error(`Unrecognized checkout action ${action}.`);
-  }
-  emitSwapActionLog(options.logger, "requested", body);
-  try {
-    const result = action === "swap_quote" ? await requestJson(options, routes.swapsQuote, {
-      reference,
-      pay_in_asset: body.pay_in_asset
-    }) : action === "refund_swap" ? await refundRequest(options, routes, body, reference) : await requestJson(options, routes.paymentsCheck, withoutAction(body));
-    if (action === "refund_swap") {
-      emitSwapActionLog(options.logger, "succeeded", body, swapActionResultFields(result));
-    }
-    return result;
-  } catch (error) {
-    emitSwapActionLog(options.logger, "failed", body, {
-      error_message: error instanceof Error ? error.message : String(error)
-    });
-    throw error;
-  }
-}
-function normalizeSwapStartInvoice(body) {
-  const outer = recordOrEmpty(body);
-  const swap = recordOrEmpty(outer.swap ?? body);
-  const checkout = recordOrEmpty(swap.checkout);
-  const paymentHash = nonEmptyString(swap.payment_hash ?? checkout.payment_hash);
-  if (paymentHash === void 0 || nonEmptyString(swap.provider) === void 0 || nonEmptyString(swap.pay_in_asset) === void 0 || nonEmptyString(swap.deposit_address) === void 0 || nonEmptyString(swap.deposit_amount) === void 0 || nonEmptyString(swap.provider_state) === void 0 || typeof swap.provider_expires_at !== "number") {
-    throw new Error("Swap response did not include provider instructions.");
-  }
-  const amountMsats = optionalSafeInteger(checkout.amount_msats, "amount_msats");
-  return {
-    invoice_id: paymentHash,
-    rail: "swap",
-    payment_hash: paymentHash,
-    ...amountMsats === void 0 ? {} : { amount_msats: amountMsats },
-    transaction_state: "pending",
-    workflow_state: "invoice_created",
-    expires_at: swap.provider_expires_at,
-    swap: {
-      provider: swap.provider,
-      pay_in_asset: swap.pay_in_asset,
-      deposit_address: swap.deposit_address,
-      deposit_amount: swap.deposit_amount,
-      provider_state: swap.provider_state,
-      provider_expires_at: swap.provider_expires_at,
-      ...copyOptionalSwapFields(swap)
-    }
-  };
-}
-async function startSwapRequest(options) {
-  const logBody = {
-    action: "start_swap",
-    reference: options.reference,
-    pay_in_asset: options.payInAsset
-  };
-  emitSwapActionLog(options.logger, "requested", logBody);
-  try {
-    const body = await requestJson(options, checkoutRoutes(options.prefix).swaps, {
-      reference: options.reference,
-      pay_in_asset: options.payInAsset
-    });
-    emitSwapActionLog(options.logger, "succeeded", logBody, swapActionResultFields(body));
-    return normalizeSwapStartInvoice(body);
-  } catch (error) {
-    emitSwapActionLog(options.logger, "failed", logBody, {
-      error_message: error instanceof Error ? error.message : String(error)
-    });
-    throw error;
-  }
-}
-async function requestSwapRefund(options) {
-  const payment = options.invoices.find(
-    (invoice) => invoice != null && (invoice.swap?.attempt_id ?? invoice.invoice_id) === options.attemptId
-  );
-  if (payment?.payment_hash === void 0) {
-    throw new Error("Swap refund requires the original payment hash.");
-  }
-  const body = await postJson({
-    fetch: options.fetch,
-    prefix: options.prefix,
-    ...options.logger === void 0 ? {} : { logger: options.logger },
-    ...options.headers === void 0 ? {} : { headers: options.headers },
-    body: {
-      ...options.reference === void 0 ? {} : { reference: options.reference },
-      payment_hash: payment.payment_hash,
-      action: "refund_swap",
-      attempt_id: options.attemptId,
-      refund_address: options.refundAddress,
-      confirm: options.confirm
-    }
-  });
-  return normalizeSwapStartInvoice(body);
-}
-async function refundRequest(options, routes, body, reference) {
-  if (reference === void 0) throw new Error("Swap refund requires reference.");
-  const refundAddress = nonEmptyString(body.refund_address);
-  if (refundAddress === void 0) throw new Error("Swap refund requires refund_address.");
-  const paymentHash = nonEmptyString(body.payment_hash);
-  if (paymentHash === void 0) throw new Error("Swap refund requires payment_hash.");
-  if (body.confirm === true) {
-    const status2 = recordOrEmpty(
-      await requestJson(options, routes.swapsRefunds, {
-        reference,
-        payment_hash: paymentHash,
-        refund_address: refundAddress
-      })
-    );
-    return { swap: status2 };
-  }
-  const status = recordOrEmpty(
-    await requestJson(options, routes.swapsStatus, {
-      reference,
-      payment_hash: paymentHash
-    })
-  );
-  return { swap: { ...status, refund_address: refundAddress } };
-}
-function withoutAction(body) {
-  const { action: _action, ...rest } = body;
-  return rest;
-}
-async function requestJson(options, url, body) {
-  const fetcher = options.fetch;
-  const response = await fetcher(url, {
-    method: "POST",
-    headers: requestHeaders(options.headers),
-    body: JSON.stringify(body)
-  });
-  return readJsonResponse(response, "OpenReceive request failed.");
-}
-function copyOptionalSwapFields(swap) {
-  const output = {};
-  for (const key of [
-    "deposit_memo",
-    "deposit_tx_id",
-    "payout_tx_id",
-    "refund_tx_id",
-    "refund_reason",
-    "refund_amount",
-    "attention",
-    "attempt_id",
-    "provider_order_id",
-    "refund_address",
-    "attention_reason",
-    "deposit_received_amount",
-    "fee"
-  ]) {
-    if (swap[key] !== void 0) output[key] = swap[key];
-  }
-  return output;
-}
-function emitSwapActionLog(logger, outcome, body, extra = {}) {
-  const sink = resolveBrowserLogger(logger);
-  if (sink === void 0) return;
-  const action = nonEmptyString(body.action);
-  if (action !== "start_swap" && action !== "refund_swap") return;
-  const event = action === "start_swap" ? `swap.start.${outcome}` : `swap.refund.${outcome}`;
-  const level = outcome === "failed" ? "warn" : outcome === "requested" ? "debug" : "info";
-  try {
-    sink(
-      sanitizeBrowserLogEntry({
-        level,
-        event,
-        message: `${action === "start_swap" ? "Swap start" : "Swap refund"} ${outcome}.`,
-        reference: nonEmptyString(body.reference),
-        pay_in_asset: nonEmptyString(body.pay_in_asset),
-        ...action === "refund_swap" ? { confirm: body.confirm === true } : {},
-        ...extra
-      })
-    );
-  } catch {
-  }
-}
-function swapActionResultFields(body) {
-  const swap = recordOrEmpty(recordOrEmpty(body).swap ?? body);
-  return {
-    payment_hash: nonEmptyString(swap.payment_hash),
-    provider_state: nonEmptyString(swap.provider_state),
-    attention: typeof swap.attention === "boolean" ? swap.attention : void 0
-  };
-}
-
-// src/internal/checkout-session.ts
+import { recordOrEmpty } from "@openreceive/core";
 var SWAP_START_FAILED = "Could not prepare the payment address. Please try again.";
+var MISSING_SWAP_OPTIONS = "startSwap needs the session's `swap` options (selection, prefix, fetch) \u2014 this session was created without them, so it cannot start a swap. See docs/guides/headless-checkout.md.";
+var MISSING_SWAP_WIRING = "startSwap cannot start a swap: the session was given no";
 var MINT_FAILED = "Could not create the Lightning invoice. Please try again.";
 function normalizeSwapQuote(body) {
-  const quote = recordOrEmpty2(recordOrEmpty2(body).quote ?? body);
+  const quote = recordOrEmpty(recordOrEmpty(body).quote ?? body);
   const payInAsset = quote.pay_in_asset ?? quote.pay_asset;
   return typeof payInAsset === "string" ? { ...quote, pay_in_asset: payInAsset } : void 0;
 }
@@ -385,11 +194,23 @@ function createCheckoutSession(options) {
   }
   async function startSwap(payInAsset) {
     if (startingSwapAsset !== null) return;
-    const selection = options.swapSelection;
-    const prefix = options.swapPrefix?.();
-    const fetcher = options.fetch?.();
+    const swap = options.swap;
+    if (swap === void 0) {
+      options.onError(new Error(MISSING_SWAP_OPTIONS));
+      return;
+    }
+    const selection = swap.selection;
+    const prefix = swap.prefix();
+    const fetcher = swap.fetch();
     const reference = options.reference();
-    if (selection === void 0 || prefix === void 0 || fetcher === void 0) return;
+    if (prefix === void 0 || fetcher === void 0) {
+      const missing = [
+        ...prefix === void 0 ? ["swap.prefix()"] : [],
+        ...fetcher === void 0 ? ["swap.fetch()"] : []
+      ];
+      options.onError(new Error(`${MISSING_SWAP_WIRING} ${missing.join(" and ")}.`));
+      return;
+    }
     if (reference === void 0 || reference.length === 0) return;
     const alreadyStarted = selection.started();
     if (alreadyStarted?.swap?.pay_in_asset === payInAsset && alreadyStarted.invoice_id !== selection.dismissedInvoiceId()) {
@@ -412,7 +233,7 @@ function createCheckoutSession(options) {
       });
       selection.setStarted(started);
       selection.setDismissedInvoiceId(null);
-      options.onSwapStarted?.(started);
+      swap.onStarted?.(started);
       selection.setSelectedAsset(payInAsset);
       options.onChange();
     } catch (error) {
@@ -610,6 +431,12 @@ function sharedElementAttributes(options) {
   if (options.decodeLinkUrl !== void 0) {
     attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.decodeLinkUrl] = options.decodeLinkUrl;
   }
+  if (isSet(options.assetBaseUrl)) {
+    attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.assetBaseUrl] = options.assetBaseUrl;
+  }
+  if (options.resumable !== void 0) {
+    attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.resumable] = String(options.resumable);
+  }
   if (options.polling !== void 0) {
     attributes[OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES.polling] = String(options.polling);
   }
@@ -768,6 +595,10 @@ 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,
@@ -776,12 +607,14 @@ export {
   OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS,
   OPENRECEIVE_CHECKOUT_ELEMENT_PARTS,
   OPENRECEIVE_CHECKOUT_ELEMENT_PART_SELECTORS,
+  OPENRECEIVE_CHECKOUT_ELEMENT_SLOTS,
   OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME,
   OPENRECEIVE_COPY_FEEDBACK_MS,
   OPENRECEIVE_DEFAULT_POLL_INTERVAL_MS,
   OPENRECEIVE_DEFAULT_PREFIX,
   OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES,
   OPENRECEIVE_PAYMENT_WIZARD_SELECTORS,
+  OPENRECEIVE_PROVIDER_PREVIEW_LIMIT,
   OPENRECEIVE_THEME_STORAGE_KEY,
   OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES,
   OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS,
@@ -795,6 +628,7 @@ export {
   checkoutElementStyles,
   checkoutLabels,
   copyInvoice,
+  createAssetBaseUrlResolver,
   createBlockExplorerUrl,
   createCheckoutActionEvent,
   createCheckoutController,
@@ -811,12 +645,13 @@ export {
   createCheckoutStatusModel,
   createDetailExternalLink,
   createLightningInvoiceDecodeUrl,
-  createPaymentDataEntries,
+  createMethodGridDisplay,
   createPaymentWizardController,
   createPaymentWizardModel,
   createPaymentWizardSelection,
   createQrPayloadSvg,
   createQrSvg,
+  createQrSvgController,
   createStatusFetcher,
   createStoredThemeModel,
   createSwapDisplayModel,
@@ -835,9 +670,7 @@ export {
   deriveStatus,
   enterCheckoutResumePath,
   escapeHtml,
-  findSwapGridGroup,
   formatAmountCaption,
-  formatChooseNetworkHeading,
   formatDepositAmount,
   formatFiatAmount,
   formatMsats,
@@ -847,6 +680,8 @@ export {
   getExplorerNetwork,
   getNetworkIcon,
   getPaymentMethodIcon,
+  getPaymentWizardRoutes,
+  getRouteIconPath,
   getRouteNetworkLabel,
   getSwapOptionIcon,
   getSwapRefundFormError,
@@ -861,7 +696,6 @@ export {
   normalizeSwapStartInvoice,
   openWallet,
   orClasses,
-  overlaySwapRefundStaging,
   parseBooleanAttribute,
   parseMethodPickerKey,
   parseOptionalInteger,
@@ -877,21 +711,19 @@ export {
   readThemePreference,
   requestCheckout,
   requestSwapRefund,
-  resolvePreservedNetworkSelection,
   resolveTransactionDetailRows,
+  resolveWizardSelection,
   selectCheckoutDisplayInvoice,
+  selectCurrentSwapInvoice,
   startSwapRequest,
   swapAssetMatchesRoute,
   swapDepositRisk,
-  swapGroupLimitOption,
   swapOptionLimitMessage,
   swapOptionLimitSentence,
   swapPickerKey,
   syncStoredThemeControls,
   toggleStoredThemeControls,
   updatePaymentWizardSelection,
-  updateSelectedSwapNetworks,
   validateCheckoutProps,
-  wizardNetworkGroupIds,
   writeThemePreference
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { aK as BrowserLogLevel } from './status-D3VhJsUp.js';
-export { aL as BrowserLogEntry, X as BrowserLogger, B as BrowserLoggerOption, Y as BrowserRequestError, Z as CheckoutController, _ as CheckoutControllerOptions, l as CheckoutSnapshot, i as CheckoutState, aM as CopyInvoiceOptions, aN as GuestCheckoutResumeController, aO as GuestCheckoutResumeOptions, aP as OpenWalletOptions, aQ as PrepareCheckoutOptions, aR as QrOptions, aS as RequestCheckoutOptions, ak as Status, aT as StatusInvoiceLike, U as UnixSeconds, an as copyInvoice, ap as createCheckoutController, aU as createGuestCheckoutResume, aV as createGuestOrderFetcher, aW as createLightningUri, aX as createQrPngDataUrl, au as createQrSvg, ay as deriveStatus, az as enterCheckoutResumePath, aH as openWallet, aI as prepareCheckout, aJ as requestCheckout } from './status-D3VhJsUp.js';
+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 '@openreceive/provider-data';
 import '@openreceive/core';
 

package/dist/index.js

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