treasury-fiscaldata 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moshe Malka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# treasury-fiscaldata
+
+Typed, zero-dependency client for the **US Treasury [FiscalData API](https://fiscaldata.treasury.gov/)** — Debt to the Penny, average interest rates on Treasury securities, exchange rates, and every other endpoint, with typed pagination, sorting, and filtering. **No API key required.**
+
+```
+npm install treasury-fiscaldata
+```
+
+## Why
+
+FiscalData is the Treasury's clean, documented API for federal financial data — the national debt to the penny, what the government pays on its securities, official exchange rates, daily Treasury statements, and much more. It's free and keyless, but its filter/pagination syntax (`filter=record_date:gte:2020-01-01`, `page[size]=…`) is fiddly to hand-build. This wraps it with a typed query, convenience methods for the popular endpoints, and an async paginator.
+
+This is the sibling of [`treasurydirect`](https://github.com/moshejs/treasurydirect) — a *different* Treasury API. TreasuryDirect is auctions and securities; FiscalData is accounting and debt.
+
+```ts
+import { latestDebt, debtToPenny, avgInterestRates, query } from "treasury-fiscaldata";
+
+const debt = await latestDebt();
+Number(debt.tot_pub_debt_out_amt);  // 39_414_179_016_130.09
+
+// A date range, with the two-condition filter handled for you:
+const history = await debtToPenny({ startDate: "2026-07-01", endDate: "2026-07-08" });
+
+// Any endpoint, fully typed pagination/sort/filter:
+const rates = await query("v2/accounting/od/avg_interest_rates", {
+  filter: { security_type_desc: "Marketable", record_date: ">=2026-01-01" },
+  sort: ["-record_date"],
+  pageSize: 100,
+});
+```
+
+## API
+
+Every function takes an optional final `options`: `{ fetch?, baseUrl? }` (inject `fetch` for tests/proxies).
+
+- **`query(endpoint, params?)`** — any endpoint (path after `/services/api/fiscal_service/`). `params`: `fields`, `filter`, `sort`, `pageNumber`, `pageSize`. Returns `{ data, meta, links }`.
+- **`queryAll(endpoint, params?)`** — async generator that follows pagination and yields every row. Narrow with `filter` first — some endpoints have millions of rows.
+- **`latestDebt()`** / **`debtToPenny({ startDate, endDate })`** — Debt to the Penny.
+- **`avgInterestRates()`** — average interest rates on Treasury securities.
+- **`exchangeRates(params?)`** — Treasury reporting rates of exchange.
+
+**Filters** come in two forms: a record `{ field: ">=value" }` (leading operators `>= <= > < =` are translated; bare value means equality — one condition per field), or a raw string array `["record_date:gte:2020-01-01", "record_date:lte:2020-12-31"]` when you need two conditions on one field. Failures throw `FiscalDataError` with `status` and `url`.
+
+The mocked test suite runs offline; `npm run smoke` exercises the live API.
+
+## Related
+
+Sibling to [`treasurydirect`](https://github.com/moshejs/treasurydirect). Part of a fixed-income toolkit: [`newyorkfed`](https://github.com/moshejs/newyorkfed) · [`tbill`](https://github.com/moshejs/tbill) · [`tips-index-ratio`](https://github.com/moshejs/tips-index-ratio) · [`compounded-sofr`](https://github.com/moshejs/compounded-sofr) · [`day-count`](https://github.com/moshejs/day-count) · [`accrued-interest`](https://github.com/moshejs/accrued-interest) · [`32nds`](https://github.com/moshejs/32nds) · [`sifma-holidays`](https://github.com/moshejs/sifma-holidays) · [`instrument-identifiers`](https://github.com/moshejs/instrument-identifiers).
+
+## Author
+
+Built by **[Moshe Malka](https://moshemalka.com)** — engineering leader in New York City. Studio work at [Quentin.Code](https://www.quentin.software/).
+
+MIT © Moshe Malka

package/dist/index.cjs

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FiscalDataError: () => FiscalDataError,
+  avgInterestRates: () => avgInterestRates,
+  debtToPenny: () => debtToPenny,
+  exchangeRates: () => exchangeRates,
+  latestDebt: () => latestDebt,
+  query: () => query,
+  queryAll: () => queryAll
+});
+module.exports = __toCommonJS(index_exports);
+var FiscalDataError = class extends Error {
+  constructor(status, url) {
+    super(`FiscalData request failed with HTTP ${status}: ${url}`);
+    this.name = "FiscalDataError";
+    this.status = status;
+    this.url = url;
+  }
+};
+var DEFAULT_BASE = "https://api.fiscaldata.treasury.gov";
+var API_PREFIX = "/services/api/fiscal_service/";
+function buildQuery(params) {
+  const sp = new URLSearchParams();
+  if (params.fields && params.fields.length) sp.set("fields", params.fields.join(","));
+  if (params.filter) {
+    let parts;
+    if (Array.isArray(params.filter)) {
+      parts = params.filter;
+    } else {
+      parts = Object.entries(params.filter).map(([field, expr]) => {
+        const m = /^(>=|<=|>|<|=)(.*)$/.exec(expr);
+        const opMap = {
+          ">=": "gte",
+          "<=": "lte",
+          ">": "gt",
+          "<": "lt",
+          "=": "eq"
+        };
+        return m ? `${field}:${opMap[m[1]]}:${m[2]}` : `${field}:eq:${expr}`;
+      });
+    }
+    sp.set("filter", parts.join(","));
+  }
+  if (params.sort && params.sort.length) sp.set("sort", params.sort.join(","));
+  if (params.pageSize !== void 0) {
+    if (!Number.isInteger(params.pageSize) || params.pageSize <= 0 || params.pageSize > 1e4) {
+      throw new RangeError(`pageSize must be an integer in 1\u201310000, got ${params.pageSize}`);
+    }
+    sp.set("page[size]", String(params.pageSize));
+  }
+  if (params.pageNumber !== void 0) {
+    if (!Number.isInteger(params.pageNumber) || params.pageNumber <= 0) {
+      throw new RangeError(`pageNumber must be a positive integer, got ${params.pageNumber}`);
+    }
+    sp.set("page[number]", String(params.pageNumber));
+  }
+  const s = sp.toString();
+  return s ? `?${s}` : "";
+}
+async function request(endpoint, params, opts) {
+  const doFetch = opts.fetch ?? globalThis.fetch;
+  const base = opts.baseUrl ?? DEFAULT_BASE;
+  const path = endpoint.startsWith("/") ? endpoint : API_PREFIX + endpoint;
+  const url = base + path + buildQuery(params);
+  const res = await doFetch(url, { headers: { accept: "application/json" } });
+  if (!res.ok) throw new FiscalDataError(res.status, url);
+  return await res.json();
+}
+function query(endpoint, params = {}, opts = {}) {
+  return request(endpoint, params, opts);
+}
+async function* queryAll(endpoint, params = {}, opts = {}) {
+  let page = params.pageNumber ?? 1;
+  const size = params.pageSize ?? 100;
+  for (; ; ) {
+    const res = await request(endpoint, { ...params, pageNumber: page, pageSize: size }, opts);
+    for (const row of res.data) yield row;
+    if (page >= res.meta["total-pages"] || res.data.length === 0) return;
+    page++;
+  }
+}
+async function latestDebt(opts = {}) {
+  const res = await request(
+    "v2/accounting/od/debt_to_penny",
+    { sort: ["-record_date"], pageSize: 1 },
+    opts
+  );
+  if (!res.data.length) throw new FiscalDataError(204, "debt_to_penny (empty)");
+  return res.data[0];
+}
+async function debtToPenny(range, opts = {}) {
+  checkDate(range.startDate, "startDate");
+  checkDate(range.endDate, "endDate");
+  return request(
+    "v2/accounting/od/debt_to_penny",
+    {
+      filter: [`record_date:gte:${range.startDate}`, `record_date:lte:${range.endDate}`],
+      sort: ["record_date"],
+      pageSize: 1e4
+    },
+    opts
+  );
+}
+function avgInterestRates(opts = {}) {
+  return request(
+    "v2/accounting/od/avg_interest_rates",
+    { sort: ["-record_date"], pageSize: 100 },
+    opts
+  );
+}
+function exchangeRates(params = {}, opts = {}) {
+  return request(
+    "v1/accounting/od/rates_of_exchange",
+    { sort: ["-record_date"], pageSize: 100, ...params },
+    opts
+  );
+}
+var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function checkDate(d, label) {
+  if (!ISO_DATE_RE.test(d)) throw new RangeError(`Invalid ${label}: "${d}" (expected YYYY-MM-DD)`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FiscalDataError,
+  avgInterestRates,
+  debtToPenny,
+  exchangeRates,
+  latestDebt,
+  query,
+  queryAll
+});

package/dist/index.d.cts

@@ -0,0 +1,116 @@
+/**
+ * treasury-fiscaldata — typed, zero-dependency client for the US Treasury's
+ * FiscalData API (api.fiscaldata.treasury.gov).
+ *
+ * Debt to the Penny, average interest rates on Treasury securities, exchange
+ * rates, and any other FiscalData endpoint via a generic query with typed
+ * pagination, sorting, and filtering. No API key required.
+ *
+ * Sibling to the `treasurydirect` package — a different Treasury API with
+ * different data.
+ */
+interface FiscalDataOptions {
+    /** Custom fetch implementation (testing, proxies). Defaults to global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /** Base URL. Defaults to "https://api.fiscaldata.treasury.gov". */
+    baseUrl?: string;
+}
+/** FiscalData pagination metadata (returned as `meta` on every response). */
+interface FiscalDataMeta {
+    count: number;
+    labels: Record<string, string>;
+    dataTypes: Record<string, string>;
+    dataFormats: Record<string, string>;
+    "total-count": number;
+    "total-pages": number;
+}
+interface FiscalDataResponse<T> {
+    data: T[];
+    meta: FiscalDataMeta;
+    links: {
+        self: string;
+        first: string;
+        prev: string | null;
+        next: string | null;
+        last: string;
+    };
+}
+interface QueryParams {
+    /** Comma-free array of fields to return (maps to the `fields` param). */
+    fields?: string[];
+    /**
+     * Filters. Two forms:
+     * - a record `{ security_type_desc: "Marketable", record_date: ">=2020-01-01" }`
+     *   — bare value means equality; a leading operator (`>=`, `<=`, `>`, `<`, `=`)
+     *   is translated. One condition per field.
+     * - a string array of raw FiscalData conditions
+     *   `["record_date:gte:2020-01-01", "record_date:lte:2020-12-31"]` — use this
+     *   when you need two conditions on the same field (e.g. a date range).
+     */
+    filter?: Record<string, string> | string[];
+    /** Sort fields; prefix with "-" for descending, e.g. ["-record_date"]. */
+    sort?: string[];
+    /** 1-based page number. */
+    pageNumber?: number;
+    /** Page size (FiscalData max 10000). */
+    pageSize?: number;
+}
+declare class FiscalDataError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(status: number, url: string);
+}
+/**
+ * Query any FiscalData endpoint (path after
+ * `/services/api/fiscal_service/`, e.g. `"v2/accounting/od/debt_to_penny"`).
+ *
+ * ```ts
+ * const res = await query("v2/accounting/od/debt_to_penny", {
+ *   sort: ["-record_date"],
+ *   pageSize: 1,
+ * });
+ * res.data[0].tot_pub_debt_out_amt;
+ * ```
+ */
+declare function query<T = Record<string, string>>(endpoint: string, params?: QueryParams, opts?: FiscalDataOptions): Promise<FiscalDataResponse<T>>;
+/**
+ * Iterate every page of an endpoint, yielding rows. Follows `links.next`
+ * until exhausted. Beware unbounded endpoints — narrow with `filter` first.
+ */
+declare function queryAll<T = Record<string, string>>(endpoint: string, params?: QueryParams, opts?: FiscalDataOptions): AsyncGenerator<T, void, unknown>;
+interface DebtToPennyRow {
+    record_date: string;
+    debt_held_public_amt: string;
+    intragov_hold_amt: string;
+    tot_pub_debt_out_amt: string;
+    [field: string]: string;
+}
+/** The latest Debt to the Penny record. */
+declare function latestDebt(opts?: FiscalDataOptions): Promise<DebtToPennyRow>;
+/** Debt to the Penny over a date range (inclusive), oldest first. */
+declare function debtToPenny(range: {
+    startDate: string;
+    endDate: string;
+}, opts?: FiscalDataOptions): Promise<FiscalDataResponse<DebtToPennyRow>>;
+interface AvgInterestRateRow {
+    record_date: string;
+    security_type_desc: string;
+    security_desc: string;
+    avg_interest_rate_amt: string;
+    [field: string]: string;
+}
+/** Average interest rates on Treasury securities for the latest record date. */
+declare function avgInterestRates(opts?: FiscalDataOptions): Promise<FiscalDataResponse<AvgInterestRateRow>>;
+interface ExchangeRateRow {
+    record_date: string;
+    country: string;
+    currency: string;
+    country_currency_desc: string;
+    exchange_rate: string;
+    effective_date: string;
+    [field: string]: string;
+}
+/** Treasury reporting rates of exchange, most recent first. */
+declare function exchangeRates(params?: QueryParams, opts?: FiscalDataOptions): Promise<FiscalDataResponse<ExchangeRateRow>>;
+
+export { type AvgInterestRateRow, type DebtToPennyRow, type ExchangeRateRow, FiscalDataError, type FiscalDataMeta, type FiscalDataOptions, type FiscalDataResponse, type QueryParams, avgInterestRates, debtToPenny, exchangeRates, latestDebt, query, queryAll };

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * treasury-fiscaldata — typed, zero-dependency client for the US Treasury's
+ * FiscalData API (api.fiscaldata.treasury.gov).
+ *
+ * Debt to the Penny, average interest rates on Treasury securities, exchange
+ * rates, and any other FiscalData endpoint via a generic query with typed
+ * pagination, sorting, and filtering. No API key required.
+ *
+ * Sibling to the `treasurydirect` package — a different Treasury API with
+ * different data.
+ */
+interface FiscalDataOptions {
+    /** Custom fetch implementation (testing, proxies). Defaults to global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /** Base URL. Defaults to "https://api.fiscaldata.treasury.gov". */
+    baseUrl?: string;
+}
+/** FiscalData pagination metadata (returned as `meta` on every response). */
+interface FiscalDataMeta {
+    count: number;
+    labels: Record<string, string>;
+    dataTypes: Record<string, string>;
+    dataFormats: Record<string, string>;
+    "total-count": number;
+    "total-pages": number;
+}
+interface FiscalDataResponse<T> {
+    data: T[];
+    meta: FiscalDataMeta;
+    links: {
+        self: string;
+        first: string;
+        prev: string | null;
+        next: string | null;
+        last: string;
+    };
+}
+interface QueryParams {
+    /** Comma-free array of fields to return (maps to the `fields` param). */
+    fields?: string[];
+    /**
+     * Filters. Two forms:
+     * - a record `{ security_type_desc: "Marketable", record_date: ">=2020-01-01" }`
+     *   — bare value means equality; a leading operator (`>=`, `<=`, `>`, `<`, `=`)
+     *   is translated. One condition per field.
+     * - a string array of raw FiscalData conditions
+     *   `["record_date:gte:2020-01-01", "record_date:lte:2020-12-31"]` — use this
+     *   when you need two conditions on the same field (e.g. a date range).
+     */
+    filter?: Record<string, string> | string[];
+    /** Sort fields; prefix with "-" for descending, e.g. ["-record_date"]. */
+    sort?: string[];
+    /** 1-based page number. */
+    pageNumber?: number;
+    /** Page size (FiscalData max 10000). */
+    pageSize?: number;
+}
+declare class FiscalDataError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(status: number, url: string);
+}
+/**
+ * Query any FiscalData endpoint (path after
+ * `/services/api/fiscal_service/`, e.g. `"v2/accounting/od/debt_to_penny"`).
+ *
+ * ```ts
+ * const res = await query("v2/accounting/od/debt_to_penny", {
+ *   sort: ["-record_date"],
+ *   pageSize: 1,
+ * });
+ * res.data[0].tot_pub_debt_out_amt;
+ * ```
+ */
+declare function query<T = Record<string, string>>(endpoint: string, params?: QueryParams, opts?: FiscalDataOptions): Promise<FiscalDataResponse<T>>;
+/**
+ * Iterate every page of an endpoint, yielding rows. Follows `links.next`
+ * until exhausted. Beware unbounded endpoints — narrow with `filter` first.
+ */
+declare function queryAll<T = Record<string, string>>(endpoint: string, params?: QueryParams, opts?: FiscalDataOptions): AsyncGenerator<T, void, unknown>;
+interface DebtToPennyRow {
+    record_date: string;
+    debt_held_public_amt: string;
+    intragov_hold_amt: string;
+    tot_pub_debt_out_amt: string;
+    [field: string]: string;
+}
+/** The latest Debt to the Penny record. */
+declare function latestDebt(opts?: FiscalDataOptions): Promise<DebtToPennyRow>;
+/** Debt to the Penny over a date range (inclusive), oldest first. */
+declare function debtToPenny(range: {
+    startDate: string;
+    endDate: string;
+}, opts?: FiscalDataOptions): Promise<FiscalDataResponse<DebtToPennyRow>>;
+interface AvgInterestRateRow {
+    record_date: string;
+    security_type_desc: string;
+    security_desc: string;
+    avg_interest_rate_amt: string;
+    [field: string]: string;
+}
+/** Average interest rates on Treasury securities for the latest record date. */
+declare function avgInterestRates(opts?: FiscalDataOptions): Promise<FiscalDataResponse<AvgInterestRateRow>>;
+interface ExchangeRateRow {
+    record_date: string;
+    country: string;
+    currency: string;
+    country_currency_desc: string;
+    exchange_rate: string;
+    effective_date: string;
+    [field: string]: string;
+}
+/** Treasury reporting rates of exchange, most recent first. */
+declare function exchangeRates(params?: QueryParams, opts?: FiscalDataOptions): Promise<FiscalDataResponse<ExchangeRateRow>>;
+
+export { type AvgInterestRateRow, type DebtToPennyRow, type ExchangeRateRow, FiscalDataError, type FiscalDataMeta, type FiscalDataOptions, type FiscalDataResponse, type QueryParams, avgInterestRates, debtToPenny, exchangeRates, latestDebt, query, queryAll };

package/dist/index.js

@@ -0,0 +1,120 @@
+// src/index.ts
+var FiscalDataError = class extends Error {
+  constructor(status, url) {
+    super(`FiscalData request failed with HTTP ${status}: ${url}`);
+    this.name = "FiscalDataError";
+    this.status = status;
+    this.url = url;
+  }
+};
+var DEFAULT_BASE = "https://api.fiscaldata.treasury.gov";
+var API_PREFIX = "/services/api/fiscal_service/";
+function buildQuery(params) {
+  const sp = new URLSearchParams();
+  if (params.fields && params.fields.length) sp.set("fields", params.fields.join(","));
+  if (params.filter) {
+    let parts;
+    if (Array.isArray(params.filter)) {
+      parts = params.filter;
+    } else {
+      parts = Object.entries(params.filter).map(([field, expr]) => {
+        const m = /^(>=|<=|>|<|=)(.*)$/.exec(expr);
+        const opMap = {
+          ">=": "gte",
+          "<=": "lte",
+          ">": "gt",
+          "<": "lt",
+          "=": "eq"
+        };
+        return m ? `${field}:${opMap[m[1]]}:${m[2]}` : `${field}:eq:${expr}`;
+      });
+    }
+    sp.set("filter", parts.join(","));
+  }
+  if (params.sort && params.sort.length) sp.set("sort", params.sort.join(","));
+  if (params.pageSize !== void 0) {
+    if (!Number.isInteger(params.pageSize) || params.pageSize <= 0 || params.pageSize > 1e4) {
+      throw new RangeError(`pageSize must be an integer in 1\u201310000, got ${params.pageSize}`);
+    }
+    sp.set("page[size]", String(params.pageSize));
+  }
+  if (params.pageNumber !== void 0) {
+    if (!Number.isInteger(params.pageNumber) || params.pageNumber <= 0) {
+      throw new RangeError(`pageNumber must be a positive integer, got ${params.pageNumber}`);
+    }
+    sp.set("page[number]", String(params.pageNumber));
+  }
+  const s = sp.toString();
+  return s ? `?${s}` : "";
+}
+async function request(endpoint, params, opts) {
+  const doFetch = opts.fetch ?? globalThis.fetch;
+  const base = opts.baseUrl ?? DEFAULT_BASE;
+  const path = endpoint.startsWith("/") ? endpoint : API_PREFIX + endpoint;
+  const url = base + path + buildQuery(params);
+  const res = await doFetch(url, { headers: { accept: "application/json" } });
+  if (!res.ok) throw new FiscalDataError(res.status, url);
+  return await res.json();
+}
+function query(endpoint, params = {}, opts = {}) {
+  return request(endpoint, params, opts);
+}
+async function* queryAll(endpoint, params = {}, opts = {}) {
+  let page = params.pageNumber ?? 1;
+  const size = params.pageSize ?? 100;
+  for (; ; ) {
+    const res = await request(endpoint, { ...params, pageNumber: page, pageSize: size }, opts);
+    for (const row of res.data) yield row;
+    if (page >= res.meta["total-pages"] || res.data.length === 0) return;
+    page++;
+  }
+}
+async function latestDebt(opts = {}) {
+  const res = await request(
+    "v2/accounting/od/debt_to_penny",
+    { sort: ["-record_date"], pageSize: 1 },
+    opts
+  );
+  if (!res.data.length) throw new FiscalDataError(204, "debt_to_penny (empty)");
+  return res.data[0];
+}
+async function debtToPenny(range, opts = {}) {
+  checkDate(range.startDate, "startDate");
+  checkDate(range.endDate, "endDate");
+  return request(
+    "v2/accounting/od/debt_to_penny",
+    {
+      filter: [`record_date:gte:${range.startDate}`, `record_date:lte:${range.endDate}`],
+      sort: ["record_date"],
+      pageSize: 1e4
+    },
+    opts
+  );
+}
+function avgInterestRates(opts = {}) {
+  return request(
+    "v2/accounting/od/avg_interest_rates",
+    { sort: ["-record_date"], pageSize: 100 },
+    opts
+  );
+}
+function exchangeRates(params = {}, opts = {}) {
+  return request(
+    "v1/accounting/od/rates_of_exchange",
+    { sort: ["-record_date"], pageSize: 100, ...params },
+    opts
+  );
+}
+var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function checkDate(d, label) {
+  if (!ISO_DATE_RE.test(d)) throw new RangeError(`Invalid ${label}: "${d}" (expected YYYY-MM-DD)`);
+}
+export {
+  FiscalDataError,
+  avgInterestRates,
+  debtToPenny,
+  exchangeRates,
+  latestDebt,
+  query,
+  queryAll
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "treasury-fiscaldata",
+  "version": "1.0.0",
+  "description": "Typed, zero-dependency client for the US Treasury FiscalData API — Debt to the Penny, average interest rates, exchange rates, and any endpoint with typed pagination, sorting, and filtering. No API key required.",
+  "keywords": [
+    "treasury",
+    "fiscaldata",
+    "fiscal-data",
+    "debt-to-the-penny",
+    "national-debt",
+    "government-data",
+    "interest-rates",
+    "exchange-rates",
+    "finance",
+    "api-client",
+    "fixed-income"
+  ],
+  "homepage": "https://moshemalka.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moshejs/treasury-fiscaldata.git"
+  },
+  "bugs": "https://github.com/moshejs/treasury-fiscaldata/issues",
+  "author": "Moshe Malka <hello@moshemalka.com> (https://moshemalka.com)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}