Skip to content

CLAUDE.md

Latest commit

 

History

History
30 lines (23 loc) · 1.23 KB

CLAUDE.md

File metadata and controls

30 lines (23 loc) · 1.23 KB
Raw

treasury-cli

Unofficial CLI + TypeScript client for the US Treasury Fiscal Data API.

Build & Test

npm run build        # tsc -> dist/
npm test             # unit tests (mocked HTTP)
npm run test:integration  # live API tests (no auth needed — API is open)
npm run dev -- <args>     # run CLI directly via tsx

Architecture

  • src/api/client.ts — TreasuryClient class, one method per API endpoint, uses native fetch
  • src/api/types.ts — all TypeScript types for Treasury API requests/responses
  • src/cli.ts — CLI entry point, routes commands to handlers
  • src/commands/ — one file per command group (debt, dts, mts, exchange, query)
  • src/cli/ — parseArgs configs, formatters (json/csv/table), help text
  • src/tests/ — node:test runner, fixtures in tests/fixtures/

Conventions

  • Zero runtime dependencies (Node 18+ native fetch, parseArgs, test runner)
  • ESM ("type": "module") with .js import extensions
  • All API params use snake_case (matching Treasury API), CLI flags use kebab-case
  • JSON output includes _truncated and _next_offset when results are paginated
  • Tests mock global.fetch — no external mock libraries
  • No API key required — Treasury Fiscal Data API is completely open