@allratestoday/sdk 1.4.4 → 1.4.6

package/dist/index.d.mts

@@ -166,6 +166,15 @@ declare class AllRatesToday {
     private resolveKey;
     private request;
     private formatDate;
+    /**
+     * The history endpoint serves fixed windows ending today (7d, 30d, 1y) and
+     * one target per call, so pick the smallest window that reaches `start`.
+     */
+    private windowFor;
+    private requireSymbols;
+    private historyPoints;
+    /** Rate on `date`, or the closest earlier point (the 1y window is weekly). */
+    private rateOn;
     /**
      * Get the latest exchange rates.
      *

package/dist/index.d.ts

@@ -166,6 +166,15 @@ declare class AllRatesToday {
     private resolveKey;
     private request;
     private formatDate;
+    /**
+     * The history endpoint serves fixed windows ending today (7d, 30d, 1y) and
+     * one target per call, so pick the smallest window that reaches `start`.
+     */
+    private windowFor;
+    private requireSymbols;
+    private historyPoints;
+    /** Rate on `date`, or the closest earlier point (the 1y window is weekly). */
+    private rateOn;
     /**
      * Get the latest exchange rates.
      *

package/dist/index.js

@@ -92,6 +92,43 @@ var AllRatesToday = class {
     }
     return date;
   }
+  /**
+   * The history endpoint serves fixed windows ending today (7d, 30d, 1y) and
+   * one target per call, so pick the smallest window that reaches `start`.
+   */
+  windowFor(start) {
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const days = Math.round((Date.parse(`${today}T00:00:00Z`) - Date.parse(`${start}T00:00:00Z`)) / 864e5);
+    if (Number.isNaN(days)) throw new AllRatesTodayError(`Invalid date: ${start}. Use YYYY-MM-DD.`);
+    if (days < 0) throw new AllRatesTodayError(`Date ${start} is in the future.`);
+    if (days <= 6) return "7d";
+    if (days <= 29) return "30d";
+    if (days <= 364) return "1y";
+    throw new AllRatesTodayError(`Historical market rates cover the last 365 days; ${start} is older.`);
+  }
+  requireSymbols(symbols, method) {
+    if (!symbols?.length) {
+      throw new AllRatesTodayError(`${method}() needs symbols, e.g. { symbols: ['EUR'] }.`);
+    }
+    return symbols;
+  }
+  async historyPoints(source, target, period, key) {
+    const raw = await this.request(
+      "/api/historical-rates",
+      { source, target, period },
+      key
+    );
+    return (raw.data ?? []).slice().sort((a, b) => a.timestamp - b.timestamp);
+  }
+  /** Rate on `date`, or the closest earlier point (the 1y window is weekly). */
+  async rateOn(source, target, date, key) {
+    let rate;
+    for (const p of await this.historyPoints(source, target, this.windowFor(date), key)) {
+      if (p.date.slice(0, 10) > date) break;
+      rate = p.rate;
+    }
+    return rate;
+  }
   // -------------------------------------------------------------------------
   // Public API
   // -------------------------------------------------------------------------
@@ -144,29 +181,13 @@ var AllRatesToday = class {
   async forDate(date, options = {}) {
     const key = this.resolveKey(options.apiKey);
     const dateStr = this.formatDate(date);
-    const params = {
-      source: options.base || "USD",
-      from: dateStr,
-      to: dateStr
-    };
-    if (options.symbols?.length) {
-      params.target = options.symbols.join(",");
-    }
-    const raw = await this.request(
-      "/api/historical-rates",
-      params,
-      key
-    );
+    const source = options.base || "USD";
     const rates = {};
-    if (raw.rates?.length) {
-      for (const r of raw.rates) {
-        rates[raw.target] = r.rate;
-      }
-    }
-    if (raw.current) {
-      rates[raw.target] = raw.current.rate;
+    for (const target of this.requireSymbols(options.symbols, "forDate")) {
+      const rate = await this.rateOn(source, target, dateStr, key);
+      if (rate !== void 0) rates[target] = rate;
     }
-    return { base: params.source, date: dateStr, rates };
+    return { base: source, date: dateStr, rates };
   }
   /**
    * Get exchange rate time series between two dates.
@@ -186,25 +207,14 @@ var AllRatesToday = class {
     const start = this.formatDate(startDate);
     const end = this.formatDate(endDate);
     const source = options.base || "USD";
-    const params = {
-      source,
-      from: start,
-      to: end
-    };
-    if (options.symbols?.length) {
-      params.target = options.symbols.join(",");
-    }
-    const raw = await this.request(
-      "/api/historical-rates",
-      params,
-      key
-    );
+    const period = this.windowFor(start);
     const rates = {};
-    if (raw.rates) {
-      for (const point of raw.rates) {
-        const dateKey = point.time.split("T")[0];
-        if (!rates[dateKey]) rates[dateKey] = {};
-        rates[dateKey][raw.target] = point.rate;
+    for (const target of this.requireSymbols(options.symbols, "timeSeries")) {
+      for (const point of await this.historyPoints(source, target, period, key)) {
+        const day = point.date.slice(0, 10);
+        if (day < start || day > end) continue;
+        if (!rates[day]) rates[day] = {};
+        rates[day][target] = point.rate;
       }
     }
     return { base: source, startDate: start, endDate: end, rates };
@@ -223,7 +233,10 @@ var AllRatesToday = class {
    */
   async symbols(options = {}) {
     const key = this.resolveKey(options.apiKey);
-    return this.request("/api/v1/symbols", {}, key);
+    const raw = await this.request("/api/v1/symbols", {}, key);
+    const symbols = {};
+    for (const c of raw.currencies ?? []) symbols[c.code] = c.name;
+    return { symbols };
   }
   /**
    * Latest table of OFFICIAL rates published by a central bank or tax
@@ -339,18 +352,10 @@ var AllRatesToday = class {
     const key = this.resolveKey(options.apiKey);
     if (options.date) {
       const dateStr = this.formatDate(options.date);
-      const params = {
-        source: from,
-        target: to,
-        from: dateStr,
-        to: dateStr
-      };
-      const raw = await this.request(
-        "/api/historical-rates",
-        params,
-        key
-      );
-      const rate = raw.current?.rate ?? raw.rates?.[0]?.rate ?? 0;
+      const rate = await this.rateOn(from, to, dateStr, key);
+      if (rate === void 0) {
+        throw new AllRatesTodayError(`No ${from}/${to} rate available on or before ${dateStr}`);
+      }
       return { from, to, amount, result: Number((amount * rate).toFixed(6)), rate, date: dateStr };
     }
     const data = await this.request(

package/dist/index.mjs

@@ -66,6 +66,43 @@ var AllRatesToday = class {
     }
     return date;
   }
+  /**
+   * The history endpoint serves fixed windows ending today (7d, 30d, 1y) and
+   * one target per call, so pick the smallest window that reaches `start`.
+   */
+  windowFor(start) {
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const days = Math.round((Date.parse(`${today}T00:00:00Z`) - Date.parse(`${start}T00:00:00Z`)) / 864e5);
+    if (Number.isNaN(days)) throw new AllRatesTodayError(`Invalid date: ${start}. Use YYYY-MM-DD.`);
+    if (days < 0) throw new AllRatesTodayError(`Date ${start} is in the future.`);
+    if (days <= 6) return "7d";
+    if (days <= 29) return "30d";
+    if (days <= 364) return "1y";
+    throw new AllRatesTodayError(`Historical market rates cover the last 365 days; ${start} is older.`);
+  }
+  requireSymbols(symbols, method) {
+    if (!symbols?.length) {
+      throw new AllRatesTodayError(`${method}() needs symbols, e.g. { symbols: ['EUR'] }.`);
+    }
+    return symbols;
+  }
+  async historyPoints(source, target, period, key) {
+    const raw = await this.request(
+      "/api/historical-rates",
+      { source, target, period },
+      key
+    );
+    return (raw.data ?? []).slice().sort((a, b) => a.timestamp - b.timestamp);
+  }
+  /** Rate on `date`, or the closest earlier point (the 1y window is weekly). */
+  async rateOn(source, target, date, key) {
+    let rate;
+    for (const p of await this.historyPoints(source, target, this.windowFor(date), key)) {
+      if (p.date.slice(0, 10) > date) break;
+      rate = p.rate;
+    }
+    return rate;
+  }
   // -------------------------------------------------------------------------
   // Public API
   // -------------------------------------------------------------------------
@@ -118,29 +155,13 @@ var AllRatesToday = class {
   async forDate(date, options = {}) {
     const key = this.resolveKey(options.apiKey);
     const dateStr = this.formatDate(date);
-    const params = {
-      source: options.base || "USD",
-      from: dateStr,
-      to: dateStr
-    };
-    if (options.symbols?.length) {
-      params.target = options.symbols.join(",");
-    }
-    const raw = await this.request(
-      "/api/historical-rates",
-      params,
-      key
-    );
+    const source = options.base || "USD";
     const rates = {};
-    if (raw.rates?.length) {
-      for (const r of raw.rates) {
-        rates[raw.target] = r.rate;
-      }
-    }
-    if (raw.current) {
-      rates[raw.target] = raw.current.rate;
+    for (const target of this.requireSymbols(options.symbols, "forDate")) {
+      const rate = await this.rateOn(source, target, dateStr, key);
+      if (rate !== void 0) rates[target] = rate;
     }
-    return { base: params.source, date: dateStr, rates };
+    return { base: source, date: dateStr, rates };
   }
   /**
    * Get exchange rate time series between two dates.
@@ -160,25 +181,14 @@ var AllRatesToday = class {
     const start = this.formatDate(startDate);
     const end = this.formatDate(endDate);
     const source = options.base || "USD";
-    const params = {
-      source,
-      from: start,
-      to: end
-    };
-    if (options.symbols?.length) {
-      params.target = options.symbols.join(",");
-    }
-    const raw = await this.request(
-      "/api/historical-rates",
-      params,
-      key
-    );
+    const period = this.windowFor(start);
     const rates = {};
-    if (raw.rates) {
-      for (const point of raw.rates) {
-        const dateKey = point.time.split("T")[0];
-        if (!rates[dateKey]) rates[dateKey] = {};
-        rates[dateKey][raw.target] = point.rate;
+    for (const target of this.requireSymbols(options.symbols, "timeSeries")) {
+      for (const point of await this.historyPoints(source, target, period, key)) {
+        const day = point.date.slice(0, 10);
+        if (day < start || day > end) continue;
+        if (!rates[day]) rates[day] = {};
+        rates[day][target] = point.rate;
       }
     }
     return { base: source, startDate: start, endDate: end, rates };
@@ -197,7 +207,10 @@ var AllRatesToday = class {
    */
   async symbols(options = {}) {
     const key = this.resolveKey(options.apiKey);
-    return this.request("/api/v1/symbols", {}, key);
+    const raw = await this.request("/api/v1/symbols", {}, key);
+    const symbols = {};
+    for (const c of raw.currencies ?? []) symbols[c.code] = c.name;
+    return { symbols };
   }
   /**
    * Latest table of OFFICIAL rates published by a central bank or tax
@@ -313,18 +326,10 @@ var AllRatesToday = class {
     const key = this.resolveKey(options.apiKey);
     if (options.date) {
       const dateStr = this.formatDate(options.date);
-      const params = {
-        source: from,
-        target: to,
-        from: dateStr,
-        to: dateStr
-      };
-      const raw = await this.request(
-        "/api/historical-rates",
-        params,
-        key
-      );
-      const rate = raw.current?.rate ?? raw.rates?.[0]?.rate ?? 0;
+      const rate = await this.rateOn(from, to, dateStr, key);
+      if (rate === void 0) {
+        throw new AllRatesTodayError(`No ${from}/${to} rate available on or before ${dateStr}`);
+      }
       return { from, to, amount, result: Number((amount * rate).toFixed(6)), rate, date: dateStr };
     }
     const data = await this.request(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allratestoday/sdk",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "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",
@@ -32,7 +32,13 @@
     "mid-market-rate",
     "fx",
     "exchangerate",
-    "exchange rate"
+    "exchange rate",
+    "currency-api",
+    "currency-exchange-rates",
+    "forex-api",
+    "currency-conversion",
+    "currency-exchange",
+    "currency-rates"
   ],
   "author": "AllRatesToday <info@allratestoday.com>",
   "license": "MIT",