@allratestoday/sdk 1.4.6 → 1.4.8

package/README.md

@@ -95,6 +95,8 @@ console.log(data);
 
 ### Historical Exchange Rates
 
+> Historical methods (`forDate`, `timeSeries`, `getHistoricalRates` and `convert` with a `date`) need a paid plan from €4.99/month. Free and trial keys get latest rates only and receive a 403 `historical_requires_paid_plan` for history.
+
 Travel back in time to get rates from any date:
 
 ```typescript
@@ -282,8 +284,8 @@ console.log(sources.map((s) => `${s.code} ${s.latest}${s.stale ? ' (stale)' : ''
 ```
 
 Always cite the returned `rate_date` — it is the institution's publication date,
-not the time of your call. Dated tables, history and publication calendars sit
-behind the free key on `/api/v1/central-bank/{bank}/{date}`; see the
+not the time of your call. Dated tables and history need a paid plan and use
+`/api/v1/central-bank/{bank}/{date}`; publication calendars work on any key. See the
 [central bank rates API](https://allratestoday.com/central-bank-rates-api/).
 
 ### Historical Rates by Period

package/dist/index.js

@@ -303,7 +303,18 @@ var AllRatesToday = class {
     const key = this.resolveKey(options.apiKey);
     const params = { source: from, target: to };
     if (amount !== void 0) params.amount = String(amount);
-    return this.request("/api/v1/rates", params, key);
+    const raw = await this.request("/api/v1/rates", params, key);
+    if (Array.isArray(raw) || !("from" in raw)) {
+      const r = Array.isArray(raw) ? raw[0] : raw;
+      if (!r) throw new AllRatesTodayError(`No rate returned for ${from}/${to}`);
+      return {
+        from: { currency: r.source, amount: 1 },
+        to: { currency: r.target, amount: r.rate },
+        rate: r.rate,
+        source: "mid-market"
+      };
+    }
+    return raw;
   }
   /**
    * Get authenticated exchange rates with metadata.
@@ -329,11 +340,15 @@ var AllRatesToday = class {
    */
   async getHistoricalRates(source, target, period = "7d", options = {}) {
     const key = this.resolveKey(options.apiKey);
-    return this.request(
-      "/api/historical-rates",
-      { source, target, period },
-      key
-    );
+    const points = await this.historyPoints(source, target, period, key);
+    const rates = points.map((p) => ({ rate: p.rate, time: p.date }));
+    return {
+      source,
+      target,
+      period,
+      current: rates[rates.length - 1] ?? { rate: 0, time: "" },
+      rates
+    };
   }
   /**
    * Convert an amount between two currencies.

package/dist/index.mjs

@@ -277,7 +277,18 @@ var AllRatesToday = class {
     const key = this.resolveKey(options.apiKey);
     const params = { source: from, target: to };
     if (amount !== void 0) params.amount = String(amount);
-    return this.request("/api/v1/rates", params, key);
+    const raw = await this.request("/api/v1/rates", params, key);
+    if (Array.isArray(raw) || !("from" in raw)) {
+      const r = Array.isArray(raw) ? raw[0] : raw;
+      if (!r) throw new AllRatesTodayError(`No rate returned for ${from}/${to}`);
+      return {
+        from: { currency: r.source, amount: 1 },
+        to: { currency: r.target, amount: r.rate },
+        rate: r.rate,
+        source: "mid-market"
+      };
+    }
+    return raw;
   }
   /**
    * Get authenticated exchange rates with metadata.
@@ -303,11 +314,15 @@ var AllRatesToday = class {
    */
   async getHistoricalRates(source, target, period = "7d", options = {}) {
     const key = this.resolveKey(options.apiKey);
-    return this.request(
-      "/api/historical-rates",
-      { source, target, period },
-      key
-    );
+    const points = await this.historyPoints(source, target, period, key);
+    const rates = points.map((p) => ({ rate: p.rate, time: p.date }));
+    return {
+      source,
+      target,
+      period,
+      current: rates[rates.length - 1] ?? { rate: 0, time: "" },
+      rates
+    };
   }
   /**
    * Convert an amount between two currencies.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allratestoday/sdk",
-  "version": "1.4.6",
+  "version": "1.4.8",
   "description": "Exchange Rate API — Real-time mid-market currency exchange rates for Node.js and browsers. 160+ currencies, zero dependencies, free tier.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",