@getalby/lightning-tools 7.0.2 → 8.1.0

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

@@ -0,0 +1,51 @@
+interface Wallet {
+    payInvoice(args: {
+        invoice: string;
+    }): Promise<{
+        preimage: string;
+    }>;
+}
+
+declare const fetchWithL402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+interface WwwAuthenticatePayload {
+    token: string;
+    invoice: string;
+    [key: string]: string;
+}
+/**
+ * Client: parse "www-authenticate" header from server response
+ * @param input
+ * @returns details from the header value (token or macaroon, invoice)
+ */
+declare const parseL402: (input: string) => WwwAuthenticatePayload;
+
+type MacaroonPayload<T> = T & {
+    paymentHash: string;
+};
+declare function issueL402Macaroon<T extends Record<string, unknown>>(secret: string, paymentHash: string, params?: T): Promise<string>;
+declare function verifyL402Macaroon<T = unknown>(secret: string, token: string): Promise<MacaroonPayload<T>>;
+
+/**
+ * Server: create a WWW-Authenticate header for a given macaroon and invoice
+ * @param args the macaroon/token and invoice generated for the client's request
+ * @returns the header value
+ */
+declare const makeL402AuthenticateHeader: (args: {
+    token?: string;
+    invoice: string;
+}) => string;
+/**
+ * Server: parse "authorization" header sent from client
+ * @param input value from authorization header
+ * @returns the macaroon and preimage
+ */
+declare function parseL402Authorization(input: string): {
+    token: string;
+    preimage: string;
+} | null;
+
+export { fetchWithL402, issueL402Macaroon, makeL402AuthenticateHeader, parseL402, parseL402Authorization, verifyL402Macaroon };
+export type { MacaroonPayload };

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

@@ -0,0 +1,26 @@
+interface Wallet {
+    payInvoice(args: {
+        invoice: string;
+    }): Promise<{
+        preimage: string;
+    }>;
+}
+
+/**
+ * Fetch a resource protected by the draft-lightning-charge-00 payment
+ * authentication protocol.
+ *
+ * On a `402 Payment Required` response that carries a
+ * `WWW-Authenticate: Payment method="lightning" intent="charge" …` header
+ * the function pays the embedded BOLT11 invoice and retries with the
+ * resulting preimage as the credential.
+ *
+ * Note: lightning-charge uses consume-once challenge semantics – each
+ * challenge embeds a fresh invoice, so paid credentials cannot be reused.
+ * The `store` option is accepted for API consistency but is not used.
+ */
+declare const fetchWithMpp: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+export { fetchWithMpp };

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

@@ -0,0 +1,13 @@
+interface Wallet {
+    payInvoice(args: {
+        invoice: string;
+    }): Promise<{
+        preimage: string;
+    }>;
+}
+
+declare const fetchWithX402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+export { fetchWithX402 };

package/dist/types/402.d.ts

@@ -0,0 +1,78 @@
+interface Wallet {
+    payInvoice(args: {
+        invoice: string;
+    }): Promise<{
+        preimage: string;
+    }>;
+}
+declare function createGuardedWallet(wallet: Wallet, maxAmountSats: number): Wallet;
+
+declare const fetch402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+    maxAmount?: number;
+}) => Promise<Response>;
+
+declare const fetchWithL402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+interface WwwAuthenticatePayload {
+    token: string;
+    invoice: string;
+    [key: string]: string;
+}
+/**
+ * Client: parse "www-authenticate" header from server response
+ * @param input
+ * @returns details from the header value (token or macaroon, invoice)
+ */
+declare const parseL402: (input: string) => WwwAuthenticatePayload;
+
+type MacaroonPayload<T> = T & {
+    paymentHash: string;
+};
+declare function issueL402Macaroon<T extends Record<string, unknown>>(secret: string, paymentHash: string, params?: T): Promise<string>;
+declare function verifyL402Macaroon<T = unknown>(secret: string, token: string): Promise<MacaroonPayload<T>>;
+
+/**
+ * Server: create a WWW-Authenticate header for a given macaroon and invoice
+ * @param args the macaroon/token and invoice generated for the client's request
+ * @returns the header value
+ */
+declare const makeL402AuthenticateHeader: (args: {
+    token?: string;
+    invoice: string;
+}) => string;
+/**
+ * Server: parse "authorization" header sent from client
+ * @param input value from authorization header
+ * @returns the macaroon and preimage
+ */
+declare function parseL402Authorization(input: string): {
+    token: string;
+    preimage: string;
+} | null;
+
+declare const fetchWithX402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+/**
+ * Fetch a resource protected by the draft-lightning-charge-00 payment
+ * authentication protocol.
+ *
+ * On a `402 Payment Required` response that carries a
+ * `WWW-Authenticate: Payment method="lightning" intent="charge" …` header
+ * the function pays the embedded BOLT11 invoice and retries with the
+ * resulting preimage as the credential.
+ *
+ * Note: lightning-charge uses consume-once challenge semantics – each
+ * challenge embeds a fresh invoice, so paid credentials cannot be reused.
+ * The `store` option is accepted for API consistency but is not used.
+ */
+declare const fetchWithMpp: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+export { createGuardedWallet, fetch402, fetchWithL402, fetchWithMpp, fetchWithX402, issueL402Macaroon, makeL402AuthenticateHeader, parseL402, parseL402Authorization, verifyL402Macaroon };
+export type { MacaroonPayload, Wallet };

package/dist/types/bolt11.d.ts

@@ -17,11 +17,14 @@ declare const fromHexString: (hexString: string) => Uint8Array<ArrayBuffer>;
 type DecodedInvoice = {
     paymentHash: string;
     satoshi: number;
+    millisatoshi: number;
+    amountRaw: string;
     timestamp: number;
     expiry: number | undefined;
     description: string | undefined;
 };
 declare const decodeInvoice: (paymentRequest: string) => DecodedInvoice | null;
+declare function validatePreimage(preimage: string, paymentHash: string): boolean;
 
 declare class Invoice {
     paymentRequest: string;
@@ -29,6 +32,8 @@ declare class Invoice {
     preimage: string | null;
     verify: string | null;
     satoshi: number;
+    millisatoshi: number;
+    amountRaw: string;
     expiry: number | undefined;
     timestamp: number;
     createdDate: Date;
@@ -42,5 +47,5 @@ declare class Invoice {
     hasExpired(): boolean;
 }
 
-export { Invoice, decodeInvoice, fromHexString };
+export { Invoice, decodeInvoice, fromHexString, validatePreimage };
 export type { InvoiceArgs, SuccessAction };

package/dist/types/index.d.ts

@@ -20,11 +20,14 @@ declare const fromHexString: (hexString: string) => Uint8Array<ArrayBuffer>;
 type DecodedInvoice = {
     paymentHash: string;
     satoshi: number;
+    millisatoshi: number;
+    amountRaw: string;
     timestamp: number;
     expiry: number | undefined;
     description: string | undefined;
 };
 declare const decodeInvoice: (paymentRequest: string) => DecodedInvoice | null;
+declare function validatePreimage(preimage: string, paymentHash: string): boolean;
 
 declare class Invoice {
     paymentRequest: string;
@@ -32,6 +35,8 @@ declare class Invoice {
     preimage: string | null;
     verify: string | null;
     satoshi: number;
+    millisatoshi: number;
+    amountRaw: string;
     expiry: number | undefined;
     timestamp: number;
     createdDate: Date;
@@ -235,37 +240,80 @@ declare class LightningAddress {
     private parseNostrResponse;
 }
 
-interface KVStorage {
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-}
-declare class MemoryStorage implements KVStorage {
-    storage: any;
-    constructor(initial?: Record<string, unknown>);
-    getItem(key: string): any;
-    setItem(key: string, value: unknown): void;
-}
-declare class NoStorage implements KVStorage {
-    constructor(initial?: unknown);
-    getItem(key: string): null;
-    setItem(key: string, value: unknown): void;
-}
-declare const parseL402: (input: string) => Record<string, string>;
-declare const makeAuthenticateHeader: (args: {
-    macaroon: string;
-    invoice: string;
-    key?: string;
-}) => string;
-
 interface Wallet {
-    sendPayment(paymentRequest: string): Promise<{
+    payInvoice(args: {
+        invoice: string;
+    }): Promise<{
         preimage: string;
     }>;
 }
+declare function createGuardedWallet(wallet: Wallet, maxAmountSats: number): Wallet;
+
+declare const fetch402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+    maxAmount?: number;
+}) => Promise<Response>;
+
 declare const fetchWithL402: (url: string, fetchArgs: RequestInit, options: {
-    headerKey?: string;
-    wallet?: Wallet;
-    store?: KVStorage;
+    wallet: Wallet;
+}) => Promise<Response>;
+
+interface WwwAuthenticatePayload {
+    token: string;
+    invoice: string;
+    [key: string]: string;
+}
+/**
+ * Client: parse "www-authenticate" header from server response
+ * @param input
+ * @returns details from the header value (token or macaroon, invoice)
+ */
+declare const parseL402: (input: string) => WwwAuthenticatePayload;
+
+type MacaroonPayload<T> = T & {
+    paymentHash: string;
+};
+declare function issueL402Macaroon<T extends Record<string, unknown>>(secret: string, paymentHash: string, params?: T): Promise<string>;
+declare function verifyL402Macaroon<T = unknown>(secret: string, token: string): Promise<MacaroonPayload<T>>;
+
+/**
+ * Server: create a WWW-Authenticate header for a given macaroon and invoice
+ * @param args the macaroon/token and invoice generated for the client's request
+ * @returns the header value
+ */
+declare const makeL402AuthenticateHeader: (args: {
+    token?: string;
+    invoice: string;
+}) => string;
+/**
+ * Server: parse "authorization" header sent from client
+ * @param input value from authorization header
+ * @returns the macaroon and preimage
+ */
+declare function parseL402Authorization(input: string): {
+    token: string;
+    preimage: string;
+} | null;
+
+declare const fetchWithX402: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
+}) => Promise<Response>;
+
+/**
+ * Fetch a resource protected by the draft-lightning-charge-00 payment
+ * authentication protocol.
+ *
+ * On a `402 Payment Required` response that carries a
+ * `WWW-Authenticate: Payment method="lightning" intent="charge" …` header
+ * the function pays the embedded BOLT11 invoice and retries with the
+ * resulting preimage as the credential.
+ *
+ * Note: lightning-charge uses consume-once challenge semantics – each
+ * challenge embeds a fresh invoice, so paid credentials cannot be reused.
+ * The `store` option is accepted for API consistency but is not used.
+ */
+declare const fetchWithMpp: (url: string, fetchArgs: RequestInit, options: {
+    wallet: Wallet;
 }) => Promise<Response>;
 
 interface FiatCurrency {
@@ -290,5 +338,5 @@ declare const getFormattedFiatValue: ({ satoshi, currency, locale, }: {
     locale: string;
 }) => Promise<string>;
 
-export { DEFAULT_PROXY, Invoice, LN_ADDRESS_REGEX, LightningAddress, MemoryStorage, NoStorage, decodeInvoice, fetchWithL402, fromHexString, generateZapEvent, getEventHash, getFiatBtcRate, getFiatCurrencies, getFiatValue, getFormattedFiatValue, getSatoshiValue, isUrl, isValidAmount, makeAuthenticateHeader, parseKeysendResponse, parseL402, parseLnUrlPayResponse, parseNostrResponse, sendBoostagram, serializeEvent, validateEvent };
-export type { Boost, BoostArguments, BoostOptions, Event, FiatCurrency, InvoiceArgs, KVStorage, KeySendRawData, KeysendResponse, LUD18PayerData, LUD18ServicePayerData, LnUrlPayResponse, LnUrlRawData, NostrProvider, NostrResponse, RequestInvoiceArgs, SuccessAction, WeblnBoostParams, ZapArgs, ZapOptions };
+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 type { Boost, BoostArguments, BoostOptions, Event, FiatCurrency, InvoiceArgs, KeySendRawData, KeysendResponse, LUD18PayerData, LUD18ServicePayerData, LnUrlPayResponse, LnUrlRawData, MacaroonPayload, NostrProvider, NostrResponse, RequestInvoiceArgs, SuccessAction, Wallet, WeblnBoostParams, ZapArgs, ZapOptions };

package/dist/types/lnurl.d.ts

@@ -140,6 +140,8 @@ declare class Invoice {
     preimage: string | null;
     verify: string | null;
     satoshi: number;
+    millisatoshi: number;
+    amountRaw: string;
     expiry: number | undefined;
     timestamp: number;
     createdDate: Date;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getalby/lightning-tools",
-  "version": "7.0.2",
+  "version": "8.1.0",
   "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",
@@ -39,10 +39,25 @@
       "require": "./dist/cjs/fiat.cjs",
       "types": "./dist/types/fiat.d.ts"
     },
-    "./l402": {
-      "import": "./dist/esm/l402.js",
-      "require": "./dist/cjs/l402.cjs",
-      "types": "./dist/types/l402.d.ts"
+    "./402": {
+      "import": "./dist/esm/402.js",
+      "require": "./dist/cjs/402.cjs",
+      "types": "./dist/types/402.d.ts"
+    },
+    "./402/l402": {
+      "import": "./dist/esm/402/l402.js",
+      "require": "./dist/cjs/402/l402.cjs",
+      "types": "./dist/types/402/l402.d.ts"
+    },
+    "./402/x402": {
+      "import": "./dist/esm/402/x402.js",
+      "require": "./dist/cjs/402/x402.cjs",
+      "types": "./dist/types/402/x402.d.ts"
+    },
+    "./402/mpp": {
+      "import": "./dist/esm/402/mpp.js",
+      "require": "./dist/cjs/402/mpp.cjs",
+      "types": "./dist/types/402/mpp.d.ts"
     },
     "./lnurl": {
       "import": "./dist/esm/lnurl.js",

package/dist/cjs/l402.cjs

@@ -1,93 +0,0 @@
-'use strict';
-
-class MemoryStorage {
-    constructor(initial) {
-        this.storage = initial || {};
-    }
-    getItem(key) {
-        return this.storage[key];
-    }
-    setItem(key, value) {
-        this.storage[key] = value;
-    }
-}
-class NoStorage {
-    constructor(initial) { }
-    getItem(key) {
-        return null;
-    }
-    setItem(key, value) { }
-}
-const parseL402 = (input) => {
-    // Remove the L402 and LSAT identifiers
-    const string = input.replace("L402", "").replace("LSAT", "").trim();
-    // Initialize an object to store the key-value pairs
-    const keyValuePairs = {};
-    // Regular expression to match key and (quoted or unquoted) value
-    const regex = /(\w+)=("([^"]*)"|'([^']*)'|([^,]*))/g;
-    let match;
-    // Use regex to find all key-value pairs
-    while ((match = regex.exec(string)) !== null) {
-        // Key is always match[1]
-        // Value is either match[3] (double-quoted), match[4] (single-quoted), or match[5] (unquoted)
-        keyValuePairs[match[1]] = match[3] || match[4] || match[5];
-    }
-    return keyValuePairs;
-};
-const makeAuthenticateHeader = (args) => {
-    const key = args.key || "L402";
-    return `${key} macaroon="${args.macaroon}", invoice="${args.invoice}"`;
-};
-
-const memoryStorage = new MemoryStorage();
-const HEADER_KEY = "L402";
-const fetchWithL402 = async (url, fetchArgs, options) => {
-    if (!options) {
-        options = {};
-    }
-    const headerKey = options.headerKey || HEADER_KEY;
-    const wallet = options.wallet;
-    if (!wallet) {
-        throw new Error("wallet is missing");
-    }
-    const store = options.store || memoryStorage;
-    if (!fetchArgs) {
-        fetchArgs = {};
-    }
-    fetchArgs.cache = "no-store";
-    fetchArgs.mode = "cors";
-    if (!fetchArgs.headers) {
-        fetchArgs.headers = {};
-    }
-    const cachedL402Data = store.getItem(url);
-    if (cachedL402Data) {
-        const data = JSON.parse(cachedL402Data);
-        fetchArgs.headers["Authorization"] =
-            `${headerKey} ${data.token}:${data.preimage}`;
-        return await fetch(url, fetchArgs);
-    }
-    fetchArgs.headers["Accept-Authenticate"] = headerKey;
-    const initResp = await fetch(url, fetchArgs);
-    const header = initResp.headers.get("www-authenticate");
-    if (!header) {
-        return initResp;
-    }
-    const details = parseL402(header);
-    const token = details.token || details.macaroon;
-    const inv = details.invoice;
-    const invResp = await wallet.sendPayment(inv);
-    store.setItem(url, JSON.stringify({
-        token: token,
-        preimage: invResp.preimage,
-    }));
-    fetchArgs.headers["Authorization"] =
-        `${headerKey} ${token}:${invResp.preimage}`;
-    return await fetch(url, fetchArgs);
-};
-
-exports.MemoryStorage = MemoryStorage;
-exports.NoStorage = NoStorage;
-exports.fetchWithL402 = fetchWithL402;
-exports.makeAuthenticateHeader = makeAuthenticateHeader;
-exports.parseL402 = parseL402;
-//# sourceMappingURL=l402.cjs.map

package/dist/cjs/l402.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"l402.cjs","sources":["../../src/l402/utils.ts","../../src/l402/l402.ts"],"sourcesContent":["export interface KVStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nexport class MemoryStorage implements KVStorage {\n  storage;\n\n  constructor(initial?: Record<string, unknown>) {\n    this.storage = initial || {};\n  }\n\n  getItem(key: string) {\n    return this.storage[key];\n  }\n\n  setItem(key: string, value: unknown) {\n    this.storage[key] = value;\n  }\n}\n\nexport class NoStorage implements KVStorage {\n  constructor(initial?: unknown) {}\n\n  getItem(key: string) {\n    return null;\n  }\n\n  setItem(key: string, value: unknown) {}\n}\n\nexport const parseL402 = (input: string): Record<string, string> => {\n  // Remove the L402 and LSAT identifiers\n  const string = input.replace(\"L402\", \"\").replace(\"LSAT\", \"\").trim();\n\n  // Initialize an object to store the key-value pairs\n  const keyValuePairs = {};\n\n  // Regular expression to match key and (quoted or unquoted) value\n  const regex = /(\\w+)=(\"([^\"]*)\"|'([^']*)'|([^,]*))/g;\n  let match;\n\n  // Use regex to find all key-value pairs\n  while ((match = regex.exec(string)) !== null) {\n    // Key is always match[1]\n    // Value is either match[3] (double-quoted), match[4] (single-quoted), or match[5] (unquoted)\n    keyValuePairs[match[1]] = match[3] || match[4] || match[5];\n  }\n\n  return keyValuePairs;\n};\n\nexport const makeAuthenticateHeader = (args: { macaroon: string, invoice: string, key?: string }) => {\n  const key = args.key || \"L402\";\n\n  return `${key} macaroon=\"${args.macaroon}\", invoice=\"${args.invoice}\"`;\n}\n","import { KVStorage, MemoryStorage, parseL402 } from \"./utils\";\n\nconst memoryStorage = new MemoryStorage();\n\nconst HEADER_KEY = \"L402\";\n\ninterface Wallet {\n  sendPayment(paymentRequest: string): Promise<{ preimage: string }>;\n}\n\nexport const fetchWithL402 = async (\n  url: string,\n  fetchArgs: RequestInit,\n  options: {\n    headerKey?: string;\n    wallet?: Wallet;\n    store?: KVStorage;\n  },\n) => {\n  if (!options) {\n    options = {};\n  }\n  const headerKey = options.headerKey || HEADER_KEY;\n  const wallet: Wallet | undefined = options.wallet;\n  if (!wallet) {\n    throw new Error(\"wallet is missing\");\n  }\n  const store = options.store || memoryStorage;\n  if (!fetchArgs) {\n    fetchArgs = {};\n  }\n  fetchArgs.cache = \"no-store\";\n  fetchArgs.mode = \"cors\";\n  if (!fetchArgs.headers) {\n    fetchArgs.headers = {};\n  }\n  const cachedL402Data = store.getItem(url);\n  if (cachedL402Data) {\n    const data = JSON.parse(cachedL402Data);\n    fetchArgs.headers[\"Authorization\"] =\n      `${headerKey} ${data.token}:${data.preimage}`;\n    return await fetch(url, fetchArgs);\n  }\n\n  fetchArgs.headers[\"Accept-Authenticate\"] = headerKey;\n  const initResp = await fetch(url, fetchArgs);\n  const header = initResp.headers.get(\"www-authenticate\");\n  if (!header) {\n    return initResp;\n  }\n\n  const details = parseL402(header);\n  const token = details.token || details.macaroon;\n  const inv = details.invoice;\n\n  const invResp = await wallet.sendPayment(inv);\n\n  store.setItem(\n    url,\n    JSON.stringify({\n      token: token,\n      preimage: invResp.preimage,\n    }),\n  );\n\n  fetchArgs.headers[\"Authorization\"] =\n    `${headerKey} ${token}:${invResp.preimage}`;\n  return await fetch(url, fetchArgs);\n};\n"],"names":[],"mappings":"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"}

package/dist/esm/l402.js

@@ -1,87 +0,0 @@
-class MemoryStorage {
-    constructor(initial) {
-        this.storage = initial || {};
-    }
-    getItem(key) {
-        return this.storage[key];
-    }
-    setItem(key, value) {
-        this.storage[key] = value;
-    }
-}
-class NoStorage {
-    constructor(initial) { }
-    getItem(key) {
-        return null;
-    }
-    setItem(key, value) { }
-}
-const parseL402 = (input) => {
-    // Remove the L402 and LSAT identifiers
-    const string = input.replace("L402", "").replace("LSAT", "").trim();
-    // Initialize an object to store the key-value pairs
-    const keyValuePairs = {};
-    // Regular expression to match key and (quoted or unquoted) value
-    const regex = /(\w+)=("([^"]*)"|'([^']*)'|([^,]*))/g;
-    let match;
-    // Use regex to find all key-value pairs
-    while ((match = regex.exec(string)) !== null) {
-        // Key is always match[1]
-        // Value is either match[3] (double-quoted), match[4] (single-quoted), or match[5] (unquoted)
-        keyValuePairs[match[1]] = match[3] || match[4] || match[5];
-    }
-    return keyValuePairs;
-};
-const makeAuthenticateHeader = (args) => {
-    const key = args.key || "L402";
-    return `${key} macaroon="${args.macaroon}", invoice="${args.invoice}"`;
-};
-
-const memoryStorage = new MemoryStorage();
-const HEADER_KEY = "L402";
-const fetchWithL402 = async (url, fetchArgs, options) => {
-    if (!options) {
-        options = {};
-    }
-    const headerKey = options.headerKey || HEADER_KEY;
-    const wallet = options.wallet;
-    if (!wallet) {
-        throw new Error("wallet is missing");
-    }
-    const store = options.store || memoryStorage;
-    if (!fetchArgs) {
-        fetchArgs = {};
-    }
-    fetchArgs.cache = "no-store";
-    fetchArgs.mode = "cors";
-    if (!fetchArgs.headers) {
-        fetchArgs.headers = {};
-    }
-    const cachedL402Data = store.getItem(url);
-    if (cachedL402Data) {
-        const data = JSON.parse(cachedL402Data);
-        fetchArgs.headers["Authorization"] =
-            `${headerKey} ${data.token}:${data.preimage}`;
-        return await fetch(url, fetchArgs);
-    }
-    fetchArgs.headers["Accept-Authenticate"] = headerKey;
-    const initResp = await fetch(url, fetchArgs);
-    const header = initResp.headers.get("www-authenticate");
-    if (!header) {
-        return initResp;
-    }
-    const details = parseL402(header);
-    const token = details.token || details.macaroon;
-    const inv = details.invoice;
-    const invResp = await wallet.sendPayment(inv);
-    store.setItem(url, JSON.stringify({
-        token: token,
-        preimage: invResp.preimage,
-    }));
-    fetchArgs.headers["Authorization"] =
-        `${headerKey} ${token}:${invResp.preimage}`;
-    return await fetch(url, fetchArgs);
-};
-
-export { MemoryStorage, NoStorage, fetchWithL402, makeAuthenticateHeader, parseL402 };
-//# sourceMappingURL=l402.js.map

package/dist/esm/l402.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"l402.js","sources":["../../src/l402/utils.ts","../../src/l402/l402.ts"],"sourcesContent":["export interface KVStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nexport class MemoryStorage implements KVStorage {\n  storage;\n\n  constructor(initial?: Record<string, unknown>) {\n    this.storage = initial || {};\n  }\n\n  getItem(key: string) {\n    return this.storage[key];\n  }\n\n  setItem(key: string, value: unknown) {\n    this.storage[key] = value;\n  }\n}\n\nexport class NoStorage implements KVStorage {\n  constructor(initial?: unknown) {}\n\n  getItem(key: string) {\n    return null;\n  }\n\n  setItem(key: string, value: unknown) {}\n}\n\nexport const parseL402 = (input: string): Record<string, string> => {\n  // Remove the L402 and LSAT identifiers\n  const string = input.replace(\"L402\", \"\").replace(\"LSAT\", \"\").trim();\n\n  // Initialize an object to store the key-value pairs\n  const keyValuePairs = {};\n\n  // Regular expression to match key and (quoted or unquoted) value\n  const regex = /(\\w+)=(\"([^\"]*)\"|'([^']*)'|([^,]*))/g;\n  let match;\n\n  // Use regex to find all key-value pairs\n  while ((match = regex.exec(string)) !== null) {\n    // Key is always match[1]\n    // Value is either match[3] (double-quoted), match[4] (single-quoted), or match[5] (unquoted)\n    keyValuePairs[match[1]] = match[3] || match[4] || match[5];\n  }\n\n  return keyValuePairs;\n};\n\nexport const makeAuthenticateHeader = (args: { macaroon: string, invoice: string, key?: string }) => {\n  const key = args.key || \"L402\";\n\n  return `${key} macaroon=\"${args.macaroon}\", invoice=\"${args.invoice}\"`;\n}\n","import { KVStorage, MemoryStorage, parseL402 } from \"./utils\";\n\nconst memoryStorage = new MemoryStorage();\n\nconst HEADER_KEY = \"L402\";\n\ninterface Wallet {\n  sendPayment(paymentRequest: string): Promise<{ preimage: string }>;\n}\n\nexport const fetchWithL402 = async (\n  url: string,\n  fetchArgs: RequestInit,\n  options: {\n    headerKey?: string;\n    wallet?: Wallet;\n    store?: KVStorage;\n  },\n) => {\n  if (!options) {\n    options = {};\n  }\n  const headerKey = options.headerKey || HEADER_KEY;\n  const wallet: Wallet | undefined = options.wallet;\n  if (!wallet) {\n    throw new Error(\"wallet is missing\");\n  }\n  const store = options.store || memoryStorage;\n  if (!fetchArgs) {\n    fetchArgs = {};\n  }\n  fetchArgs.cache = \"no-store\";\n  fetchArgs.mode = \"cors\";\n  if (!fetchArgs.headers) {\n    fetchArgs.headers = {};\n  }\n  const cachedL402Data = store.getItem(url);\n  if (cachedL402Data) {\n    const data = JSON.parse(cachedL402Data);\n    fetchArgs.headers[\"Authorization\"] =\n      `${headerKey} ${data.token}:${data.preimage}`;\n    return await fetch(url, fetchArgs);\n  }\n\n  fetchArgs.headers[\"Accept-Authenticate\"] = headerKey;\n  const initResp = await fetch(url, fetchArgs);\n  const header = initResp.headers.get(\"www-authenticate\");\n  if (!header) {\n    return initResp;\n  }\n\n  const details = parseL402(header);\n  const token = details.token || details.macaroon;\n  const inv = details.invoice;\n\n  const invResp = await wallet.sendPayment(inv);\n\n  store.setItem(\n    url,\n    JSON.stringify({\n      token: token,\n      preimage: invResp.preimage,\n    }),\n  );\n\n  fetchArgs.headers[\"Authorization\"] =\n    `${headerKey} ${token}:${invResp.preimage}`;\n  return await fetch(url, fetchArgs);\n};\n"],"names":[],"mappings":"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"}

package/dist/types/l402.d.ts

@@ -1,35 +0,0 @@
-interface KVStorage {
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-}
-declare class MemoryStorage implements KVStorage {
-    storage: any;
-    constructor(initial?: Record<string, unknown>);
-    getItem(key: string): any;
-    setItem(key: string, value: unknown): void;
-}
-declare class NoStorage implements KVStorage {
-    constructor(initial?: unknown);
-    getItem(key: string): null;
-    setItem(key: string, value: unknown): void;
-}
-declare const parseL402: (input: string) => Record<string, string>;
-declare const makeAuthenticateHeader: (args: {
-    macaroon: string;
-    invoice: string;
-    key?: string;
-}) => string;
-
-interface Wallet {
-    sendPayment(paymentRequest: string): Promise<{
-        preimage: string;
-    }>;
-}
-declare const fetchWithL402: (url: string, fetchArgs: RequestInit, options: {
-    headerKey?: string;
-    wallet?: Wallet;
-    store?: KVStorage;
-}) => Promise<Response>;
-
-export { MemoryStorage, NoStorage, fetchWithL402, makeAuthenticateHeader, parseL402 };
-export type { KVStorage };