@getalby/lightning-tools 8.1.0 → 8.1.1

package/dist/types/402/x402.d.ts

@@ -6,8 +6,27 @@ interface Wallet {
     }>;
 }
 
+interface X402Requirements {
+    scheme: string;
+    network: string;
+    extra: {
+        invoice: string;
+        paymentMethod?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+
+/**
+ * Probe a PAYMENT-REQUIRED header for a lightning-payable offer without
+ * throwing. Returns the matching requirements, or null if the header has no
+ * lightning entry (e.g. USDC-only endpoints) or is malformed. Used by the
+ * top-level fetch402 dispatcher to decide whether to attempt payment or hand
+ * the 402 back to the caller.
+ */
+declare const findX402LightningRequirements: (x402Header: string) => X402Requirements | null;
 declare const fetchWithX402: (url: string, fetchArgs: RequestInit, options: {
     wallet: Wallet;
 }) => Promise<Response>;
 
-export { fetchWithX402 };
+export { fetchWithX402, findX402LightningRequirements };

package/dist/types/402.d.ts

@@ -53,6 +53,25 @@ declare function parseL402Authorization(input: string): {
     preimage: string;
 } | null;
 
+interface X402Requirements {
+    scheme: string;
+    network: string;
+    extra: {
+        invoice: string;
+        paymentMethod?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+
+/**
+ * Probe a PAYMENT-REQUIRED header for a lightning-payable offer without
+ * throwing. Returns the matching requirements, or null if the header has no
+ * lightning entry (e.g. USDC-only endpoints) or is malformed. Used by the
+ * top-level fetch402 dispatcher to decide whether to attempt payment or hand
+ * the 402 back to the caller.
+ */
+declare const findX402LightningRequirements: (x402Header: string) => X402Requirements | null;
 declare const fetchWithX402: (url: string, fetchArgs: RequestInit, options: {
     wallet: Wallet;
 }) => Promise<Response>;
@@ -74,5 +93,5 @@ declare const fetchWithMpp: (url: string, fetchArgs: RequestInit, options: {
     wallet: Wallet;
 }) => Promise<Response>;
 
-export { createGuardedWallet, fetch402, fetchWithL402, fetchWithMpp, fetchWithX402, issueL402Macaroon, makeL402AuthenticateHeader, parseL402, parseL402Authorization, verifyL402Macaroon };
+export { createGuardedWallet, fetch402, fetchWithL402, fetchWithMpp, fetchWithX402, findX402LightningRequirements, issueL402Macaroon, makeL402AuthenticateHeader, parseL402, parseL402Authorization, verifyL402Macaroon };
 export type { MacaroonPayload, Wallet };

package/dist/types/index.d.ts

@@ -295,6 +295,25 @@ declare function parseL402Authorization(input: string): {
     preimage: string;
 } | null;
 
+interface X402Requirements {
+    scheme: string;
+    network: string;
+    extra: {
+        invoice: string;
+        paymentMethod?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+
+/**
+ * Probe a PAYMENT-REQUIRED header for a lightning-payable offer without
+ * throwing. Returns the matching requirements, or null if the header has no
+ * lightning entry (e.g. USDC-only endpoints) or is malformed. Used by the
+ * top-level fetch402 dispatcher to decide whether to attempt payment or hand
+ * the 402 back to the caller.
+ */
+declare const findX402LightningRequirements: (x402Header: string) => X402Requirements | null;
 declare const fetchWithX402: (url: string, fetchArgs: RequestInit, options: {
     wallet: Wallet;
 }) => Promise<Response>;
@@ -338,5 +357,5 @@ declare const getFormattedFiatValue: ({ satoshi, currency, locale, }: {
     locale: string;
 }) => Promise<string>;
 
-export { DEFAULT_PROXY, Invoice, LN_ADDRESS_REGEX, LightningAddress, createGuardedWallet, decodeInvoice, fetch402, fetchWithL402, fetchWithMpp, fetchWithX402, fromHexString, generateZapEvent, getEventHash, getFiatBtcRate, getFiatCurrencies, getFiatValue, getFormattedFiatValue, getSatoshiValue, isUrl, isValidAmount, issueL402Macaroon, makeL402AuthenticateHeader, parseKeysendResponse, parseL402, parseL402Authorization, parseLnUrlPayResponse, parseNostrResponse, sendBoostagram, serializeEvent, validateEvent, validatePreimage, verifyL402Macaroon };
+export { DEFAULT_PROXY, Invoice, LN_ADDRESS_REGEX, LightningAddress, createGuardedWallet, decodeInvoice, fetch402, fetchWithL402, fetchWithMpp, fetchWithX402, findX402LightningRequirements, fromHexString, generateZapEvent, getEventHash, getFiatBtcRate, getFiatCurrencies, getFiatValue, getFormattedFiatValue, getSatoshiValue, isUrl, isValidAmount, issueL402Macaroon, makeL402AuthenticateHeader, parseKeysendResponse, parseL402, parseL402Authorization, parseLnUrlPayResponse, parseNostrResponse, sendBoostagram, serializeEvent, validateEvent, validatePreimage, verifyL402Macaroon };
 export type { Boost, BoostArguments, BoostOptions, Event, FiatCurrency, InvoiceArgs, KeySendRawData, KeysendResponse, LUD18PayerData, LUD18ServicePayerData, LnUrlPayResponse, LnUrlRawData, MacaroonPayload, NostrProvider, NostrResponse, RequestInvoiceArgs, SuccessAction, Wallet, WeblnBoostParams, ZapArgs, ZapOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getalby/lightning-tools",
-  "version": "8.1.0",
+  "version": "8.1.1",
   "description": "Collection of helpful building blocks and tools to develop Bitcoin Lightning web apps",
   "type": "module",
   "repository": "https://github.com/getAlby/js-lightning-tools.git",