Enhance Documentation for toBooleanFlag Function with JSDoc

[tmdeveloper007]

Summary of What Has Been Done

Added comprehensive JSDoc documentation to the toBooleanFlag function in lib/validations.ts documenting its behavior, accepted values, return type, and providing a usage example.

Changes Made

• lib/validations.ts: Added JSDoc @description, @param, @returns, and @example to toBooleanFlag function. Documents that the function accepts undefined, 'true', 'false', '1', '0' and returns true for 'true' or '1', false otherwise.

Impact it Made

Improves developer experience by documenting the function's semantics, which are not immediately obvious from the one-line implementation. Helps new contributors understand URL parameter coercion patterns.

Closes #8336

Note: Please assign this PR to the tmdeveloper007 account.

[vercel]

@tmdeveloper007 is attempting to deploy a commit to the jhasourav07's projects Team on Vercel.

A member of the Team first needs to authorize it.

[retenta-bot]

This PR enhances the documentation for the toBooleanFlag function, which is crucial for improving developer experience and understanding of the code. Similar to past decisions like the documentation for null handling in the User Details API, this effort aims to clarify function semantics and improve type safety. Thank you for your contribution, and I look forward to seeing this merged!

[github-actions]

👋 Hey @tmdeveloper007! Thanks for your interest in contributing to CommitPulse! 🙏

Unfortunately, this PR has been automatically closed because you are not assigned to the linked issue #8336 — docs(validations): add JSDoc for toBooleanFlag function.

To avoid this in the future, please follow these steps:

1. Claim the issue — Comment /claim on #8336 if you are the issue author, or ask a maintainer to /assign you.
2. Wait for confirmation — The bot will confirm your assignment with a ✅ reply.
3. Then open your PR — Link the issue with Fixes #8336 in your description.

💡 You can be assigned to up to 5 open issues at a time. Check your current assignments before claiming a new one.

We look forward to your contribution once you're assigned! 🚀