TODO.md

TODO — docs(readme) and date utils consolidation

Phase 1: README rewrite + date utils consolidation

• Update README.md (replace boilerplate; correct directory layout; add setup/scripts/testing/stack)
• Consolidate date utilities into a single module (utils/date-utils.ts, date-fns based)
• Remove redundant utils/dateUtils.ts (deleted; no longer present)
• Update all imports across the repo to the surviving date utility module
• Add TSDoc to surviving date utility exports
• Add unit tests: utils/date-utils.test.ts (parse/range/format edge cases, colocated per repo convention alongside authUtils.test.ts/paginationUtils.test.ts/transactionUtils.test.ts)

Phase 2: Validation

• Run npm run test (Vitest, includes utils/date-utils.test.ts with coverage)
• Ensure tests pass and coverage thresholds (95%) for the suite remain satisfied (98%+ overall, 100% branches in date-utils.ts)
• Run npm run lint and npx tsc --noEmit against changed files

Phase 3: Final checks

• Verify no remaining imports of removed date utils modules
• Double-check README does not leak secrets/env values (also removed pre-existing absolute local file paths leaking contributor usernames)

TODO - fix stale transaction fetches

Step 1: Cancellation threading

• Update lib/api/transactions.ts#getTransactions to accept optional AbortSignal
• Implement abortable delay and abort checks

Step 2: Hook request cancellation + latest-commit guard

• Update hooks/useTransactions.ts to create AbortController per effect run
• Abort previous request in cleanup
• Add requestId guard so only latest request commits state
• Ensure no setState after unmount

Step 3: Tests

• Create hooks/useTransactions.test.ts
• Simulate overlapping resolutions and assert last-request-wins
• Simulate unmount mid-flight and ensure no stale state commit / no unhandled rejection

Step 4: Documentation

• Add TSDoc comments documenting cancellation semantics

Step 5: Run & verify

• Run npm run test
• Confirm Vitest coverage thresholds pass