[JSDoc] Document Currency Conversion Boundaries in src/lib/utils/money.ts

[TheVicky1]

• Labels: good first issue, documentation, difficulty:beginner, area:core
• Target File: src/lib/utils/money.ts
• Estimated Time: 10–15 minutes
• Difficulty: Level 1 (Beginner)

Why This Matters

Clear documentation of financial utility contracts ensures that future contributors do not introduce floating-point rounding errors when converting between dollars and integer cents.

Current Behavior

Helper functions in src/lib/utils/money.ts lack formal JSDoc contract descriptions for integer arithmetic handling.

Requested Change

Add detailed JSDoc comments to src/lib/utils/money.ts helper functions, specifying parameter types, return contracts, and example usage.

Acceptance Criteria

• JSDoc documentation added to money helper functions.
• Test suite executes cleanly: npm run test:file -- tests/finance-domain-validation.test.ts.

Verification

npm run test:file -- tests/finance-domain-validation.test.ts

Contributor Notes

Documentation addition.

---

🚀 How to Claim and Implement an Issue

1. Choose an Issue: Browse our open issues and pick one matching your interest and available time.
2. Comment on GitHub: Leave a comment on the corresponding GitHub issue: "I would like to work on this issue. Please assign it to me."
3. Follow the Guide: Review our Beginner's Contribution Guide for step-by-step Git instructions.
4. Verify Locally: Run the specific verification command listed on the issue before opening your PR.
5. Submit PR: Open a pull request against main referencing this issue number!