africa-fx-feed 1.0.0

package/cli.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+import { getRwandaRates, getRwandaRSSFeed } from "./src/index.js";
+
+const arg = process.argv[2];
+
+if (arg === "--json") {
+  const data = await getRwandaRates();
+  console.log(JSON.stringify(data, null, 2));
+} 
+else if (arg === "--rss") {
+  const xml = await getRwandaRSSFeed();
+  console.log(xml);
+} 
+else {
+  console.log(`
+Africa FX Feed — Rwanda (NBC)
+
+Usage:
+  africa-fx-feed --json     Output JSON
+  africa-fx-feed --rss      Output RSS XML
+`);
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "africa-fx-feed",
+  "version": "1.0.0",
+  "description": "Official Rwanda exchange rates feed from NBC (JSON + RSS)",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "africa-fx-feed": "./cli.js"
+  },
+  "files": [
+    "src",
+    "cli.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node cli.js",
+    "test": "node src/index.js"
+  },
+  "keywords": [
+    "rwanda",
+    "ncb",
+    "exchange",
+    "rates",
+    "rss",
+    "fx"
+  ],
+  "author": "David Iyera",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IYERADavid/Africa-FX-Feed"
+  },
+  "bugs": {
+    "url": "https://github.com/IYERADavid/Africa-FX-Feed/issues"
+  },
+  "homepage": "https://github.com/IYERADavid/Africa-FX-Feed#readme",
+  "dependencies": {
+    "cheerio": "^1.0.0",
+    "node-cache": "^5.1.2",
+    "undici": "^6.0.0",
+    "xmlbuilder2": "^3.0.2"
+  }
+}

package/src/cache.js

@@ -0,0 +1,3 @@
+import NodeCache from "node-cache";
+
+export const cache = new NodeCache({ stdTTL: 86400 }); // 24 hours

package/src/index.js

@@ -0,0 +1,20 @@
+import { scrapeNBCRWRates } from "./scraper.js";
+import { normalizeRates } from "./parser.js";
+import { generateRSS } from "./rss.js";
+import { cache } from "./cache.js";
+
+export async function getRwandaRates() {
+  const cached = cache.get("rwanda_rates");
+  if (cached) return cached;
+
+  const raw = await scrapeNBCRWRates();
+  const data = normalizeRates(raw);
+
+  cache.set("rwanda_rates", data);
+  return data;
+}
+
+export async function getRwandaRSSFeed() {
+  const data = await getRwandaRates();
+  return generateRSS(data);
+}

package/src/parser.js

@@ -0,0 +1,9 @@
+export function normalizeRates(rawRates) {
+    return {
+      source: "NBC",
+      country: "Rwanda",
+      base: "RWF",
+      date: new Date().toISOString().split("T")[0],
+      rates: rawRates
+    };
+}

package/src/rss.js

@@ -0,0 +1,21 @@
+import { create } from "xmlbuilder2";
+
+export function generateRSS(data) {
+  const root = create({ version: "1.0" })
+    .ele("rss", { version: "2.0" })
+    .ele("channel");
+
+  root.ele("title").txt("NBC Rwanda Exchange Rates");
+  root.ele("description").txt("Official exchange rates from NBC Group");
+  root.ele("link").txt("https://rw.ncbagroup.com/forex-rates/");
+  root.ele("pubDate").txt(new Date().toUTCString());
+
+  data.rates.forEach(rate => {
+    const item = root.ele("item");
+    item.ele("title").txt(`${rate.currency} / RWF`);
+    item.ele("description").txt(`Buy: ${rate.buy} | Sell: ${rate.sell}`);
+    item.ele("pubDate").txt(new Date().toUTCString());
+  });
+
+  return root.end({ prettyPrint: true });
+}

package/src/scraper.js

@@ -0,0 +1,37 @@
+import { fetch } from "undici";
+import * as cheerio from "cheerio";
+
+const NBC_RW_URL = "https://rw.ncbagroup.com/forex-rates/";
+
+export async function scrapeNBCRWRates() {
+  const res = await fetch(NBC_RW_URL, {
+    headers: {
+      "User-Agent": "Mozilla/5.0",
+    },
+  });
+
+  const html = await res.text();
+  const $ = cheerio.load(html);
+
+  const table = $("#tab-daily-rates table tbody tr");
+
+  const rates = [];
+
+  table.each((_, row) => {
+    const cols = $(row).find("td");
+
+    const currency = $(cols[1]).text().trim();
+    const buy = parseNumber($(cols[2]).text());
+    const sell = parseNumber($(cols[3]).text());
+
+    if (currency && buy && sell) {
+      rates.push({ currency, buy, sell });
+    }
+  });
+
+  return rates;
+}
+
+function parseNumber(value) {
+  return parseFloat(value.replace(/,/g, "").trim());
+}