@getalby/lightning-tools 6.0.0 → 6.1.0

package/README.md

@@ -6,7 +6,11 @@
 
 An npm package that provides useful and common tools and helpers to build lightning web applications.
 
-## 🚀 Quick Start
+## 🤖 🚀 ⚡ For Developers using Agents / LLMs / Vibe Coding
+
+Skip the rest of this README and use the [Alby Bitcoin Payments Agent Skill](https://github.com/getAlby/alby-agent-skill) instead. It will handle the rest!
+
+## Manual Installation
 
 ```
 npm install @getalby/lightning-tools
@@ -242,6 +246,10 @@ const { paymentHash, satoshi, description, createdDate, expiryDate } = invoice;
 
 Helpers to convert sats values to fiat and fiat values to sats.
 
+##### getFiatCurrencies(): Promise<FiatCurrency[]>
+
+Returns the list of available fiat currencies sorted by priority
+
 ##### getFiatValue(satoshi: number, currency: string): number
 
 Returns the fiat value for a specified currency of a satoshi amount
@@ -257,6 +265,7 @@ Like `getFiatValue` but returns a formatted string for a given locale using Java
 #### Examples
 
 ```js
+await fiat.getFiatCurrencies();
 await fiat.getFiatValue({ satoshi: 2100, currency: "eur" });
 await fiat.getSatoshiValue({ amount: 100, currency: "eur" }); // for 1 EUR
 await fiat.getFormattedFiatValue({

package/dist/cjs/fiat.cjs

@@ -1,6 +1,26 @@
 'use strict';
 
 const numSatsInBtc = 100000000;
+const getFiatCurrencies = async () => {
+    const url = "https://getalby.com/api/rates";
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch currencies: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const mappedCurrencies = Object.entries(data)
+        .filter(([code]) => code.toUpperCase() !== "BTC")
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .map(([code, details]) => ({
+        code: code.toUpperCase(),
+        name: details.name,
+        priority: details.priority,
+        symbol: details.symbol,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .sort((a, b) => a.priority - b.priority);
+    return mappedCurrencies;
+};
 const getFiatBtcRate = async (currency) => {
     const url = "https://getalby.com/api/rates/" + currency.toLowerCase() + ".json";
     const response = await fetch(url);
@@ -30,6 +50,7 @@ const getFormattedFiatValue = async ({ satoshi, currency, locale, }) => {
 };
 
 exports.getFiatBtcRate = getFiatBtcRate;
+exports.getFiatCurrencies = getFiatCurrencies;
 exports.getFiatValue = getFiatValue;
 exports.getFormattedFiatValue = getFormattedFiatValue;
 exports.getSatoshiValue = getSatoshiValue;

package/dist/cjs/fiat.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fiat.cjs","sources":["../../src/fiat/fiat.ts"],"sourcesContent":["const numSatsInBtc = 100_000_000;\n\nexport const getFiatBtcRate = async (currency: string): Promise<number> => {\n  const url =\n    \"https://getalby.com/api/rates/\" + currency.toLowerCase() + \".json\";\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    throw new Error(\n      `Failed to fetch rate: ${response.status} ${response.statusText}`,\n    );\n  }\n\n  const data = await response.json();\n\n  return data.rate_float / numSatsInBtc;\n};\n\nexport const getFiatValue = async ({\n  satoshi,\n  currency,\n}: {\n  satoshi: number | string;\n  currency: string;\n}) => {\n  const rate = await getFiatBtcRate(currency);\n\n  return Number(satoshi) * rate;\n};\n\nexport const getSatoshiValue = async ({\n  amount,\n  currency,\n}: {\n  amount: number | string;\n  currency: string;\n}) => {\n  const rate = await getFiatBtcRate(currency);\n\n  return Math.floor(Number(amount) / rate);\n};\n\nexport const getFormattedFiatValue = async ({\n  satoshi,\n  currency,\n  locale,\n}: {\n  satoshi: number | string;\n  currency: string;\n  locale: string;\n}) => {\n  if (!locale) {\n    locale = \"en\";\n  }\n  const fiatValue = await getFiatValue({ satoshi, currency });\n  return fiatValue.toLocaleString(locale, {\n    style: \"currency\",\n    currency,\n  });\n};\n"],"names":[],"mappings":";;AAAA,MAAM,YAAY,GAAG,SAAW;MAEnB,cAAc,GAAG,OAAO,QAAgB,KAAqB;IACxE,MAAM,GAAG,GACP,gCAAgC,GAAG,QAAQ,CAAC,WAAW,EAAE,GAAG,OAAO;AACrE,IAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;AAEjC,IAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AAChB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,sBAAA,EAAyB,QAAQ,CAAC,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAC,UAAU,CAAA,CAAE,CAClE;IACH;AAEA,IAAA,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;AAElC,IAAA,OAAO,IAAI,CAAC,UAAU,GAAG,YAAY;AACvC;AAEO,MAAM,YAAY,GAAG,OAAO,EACjC,OAAO,EACP,QAAQ,GAIT,KAAI;AACH,IAAA,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC;AAE3C,IAAA,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;AAC/B;AAEO,MAAM,eAAe,GAAG,OAAO,EACpC,MAAM,EACN,QAAQ,GAIT,KAAI;AACH,IAAA,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC;IAE3C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC1C;AAEO,MAAM,qBAAqB,GAAG,OAAO,EAC1C,OAAO,EACP,QAAQ,EACR,MAAM,GAKP,KAAI;IACH,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,GAAG,IAAI;IACf;IACA,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC3D,IAAA,OAAO,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE;AACtC,QAAA,KAAK,EAAE,UAAU;QACjB,QAAQ;AACT,KAAA,CAAC;AACJ;;;;;;;"}
+{"version":3,"file":"fiat.cjs","sources":["../../src/fiat/fiat.ts"],"sourcesContent":["const numSatsInBtc = 100_000_000;\n\nexport interface FiatCurrency {\n  code: string;\n  name: string;\n  symbol: string;\n  priority: number;\n}\n\nexport const getFiatCurrencies = async (): Promise<FiatCurrency[]> => {\n  const url = \"https://getalby.com/api/rates\";\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    throw new Error(\n      `Failed to fetch currencies: ${response.status} ${response.statusText}`,\n    );\n  }\n\n  const data = await response.json();\n  const mappedCurrencies: FiatCurrency[] = Object.entries(data)\n    .filter(([code]) => code.toUpperCase() !== \"BTC\")\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    .map(([code, details]: any) => ({\n      code: code.toUpperCase(),\n      name: details.name,\n      priority: details.priority,\n      symbol: details.symbol,\n    }))\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .sort((a, b) => a.priority - b.priority) as FiatCurrency[];\n\n  return mappedCurrencies;\n};\n\nexport const getFiatBtcRate = async (currency: string): Promise<number> => {\n  const url =\n    \"https://getalby.com/api/rates/\" + currency.toLowerCase() + \".json\";\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    throw new Error(\n      `Failed to fetch rate: ${response.status} ${response.statusText}`,\n    );\n  }\n\n  const data = await response.json();\n\n  return data.rate_float / numSatsInBtc;\n};\n\nexport const getFiatValue = async ({\n  satoshi,\n  currency,\n}: {\n  satoshi: number | string;\n  currency: string;\n}) => {\n  const rate = await getFiatBtcRate(currency);\n\n  return Number(satoshi) * rate;\n};\n\nexport const getSatoshiValue = async ({\n  amount,\n  currency,\n}: {\n  amount: number | string;\n  currency: string;\n}) => {\n  const rate = await getFiatBtcRate(currency);\n\n  return Math.floor(Number(amount) / rate);\n};\n\nexport const getFormattedFiatValue = async ({\n  satoshi,\n  currency,\n  locale,\n}: {\n  satoshi: number | string;\n  currency: string;\n  locale: string;\n}) => {\n  if (!locale) {\n    locale = \"en\";\n  }\n  const fiatValue = await getFiatValue({ satoshi, currency });\n  return fiatValue.toLocaleString(locale, {\n    style: \"currency\",\n    currency,\n  });\n};\n"],"names":[],"mappings":";;AAAA,MAAM,YAAY,GAAG,SAAW;AASzB,MAAM,iBAAiB,GAAG,YAAoC;IACnE,MAAM,GAAG,GAAG,+BAA+B;AAC3C,IAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;AAEjC,IAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AAChB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,4BAAA,EAA+B,QAAQ,CAAC,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAC,UAAU,CAAA,CAAE,CACxE;IACH;AAEA,IAAA,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;AAClC,IAAA,MAAM,gBAAgB,GAAmB,MAAM,CAAC,OAAO,CAAC,IAAI;AACzD,SAAA,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK;;SAE/C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAM,MAAM;AAC9B,QAAA,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;AACvB,KAAA,CAAC;AACD,SAAA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,SAAA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAmB;AAE5D,IAAA,OAAO,gBAAgB;AACzB;MAEa,cAAc,GAAG,OAAO,QAAgB,KAAqB;IACxE,MAAM,GAAG,GACP,gCAAgC,GAAG,QAAQ,CAAC,WAAW,EAAE,GAAG,OAAO;AACrE,IAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;AAEjC,IAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AAChB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,sBAAA,EAAyB,QAAQ,CAAC,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAC,UAAU,CAAA,CAAE,CAClE;IACH;AAEA,IAAA,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;AAElC,IAAA,OAAO,IAAI,CAAC,UAAU,GAAG,YAAY;AACvC;AAEO,MAAM,YAAY,GAAG,OAAO,EACjC,OAAO,EACP,QAAQ,GAIT,KAAI;AACH,IAAA,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC;AAE3C,IAAA,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;AAC/B;AAEO,MAAM,eAAe,GAAG,OAAO,EACpC,MAAM,EACN,QAAQ,GAIT,KAAI;AACH,IAAA,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC;IAE3C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC1C;AAEO,MAAM,qBAAqB,GAAG,OAAO,EAC1C,OAAO,EACP,QAAQ,EACR,MAAM,GAKP,KAAI;IACH,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,GAAG,IAAI;IACf;IACA,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC3D,IAAA,OAAO,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE;AACtC,QAAA,KAAK,EAAE,UAAU;QACjB,QAAQ;AACT,KAAA,CAAC;AACJ;;;;;;;;"}

package/dist/cjs/index.cjs

@@ -1742,6 +1742,26 @@ const fetchWithL402 = async (url, fetchArgs, options) => {
 };
 
 const numSatsInBtc = 100000000;
+const getFiatCurrencies = async () => {
+    const url = "https://getalby.com/api/rates";
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch currencies: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const mappedCurrencies = Object.entries(data)
+        .filter(([code]) => code.toUpperCase() !== "BTC")
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .map(([code, details]) => ({
+        code: code.toUpperCase(),
+        name: details.name,
+        priority: details.priority,
+        symbol: details.symbol,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .sort((a, b) => a.priority - b.priority);
+    return mappedCurrencies;
+};
 const getFiatBtcRate = async (currency) => {
     const url = "https://getalby.com/api/rates/" + currency.toLowerCase() + ".json";
     const response = await fetch(url);
@@ -1782,6 +1802,7 @@ exports.fromHexString = fromHexString;
 exports.generateZapEvent = generateZapEvent;
 exports.getEventHash = getEventHash;
 exports.getFiatBtcRate = getFiatBtcRate;
+exports.getFiatCurrencies = getFiatCurrencies;
 exports.getFiatValue = getFiatValue;
 exports.getFormattedFiatValue = getFormattedFiatValue;
 exports.getSatoshiValue = getSatoshiValue;