docs: add JSDoc comments to custom hooks

[bfernando]

Summary

• add JSDoc blocks to all custom hooks in hooks/
• document parameters, return values, and usage examples for dispute, invoice, team, wallet, and invoice-status hooks

Testing

• npm ci
• git diff --check

Notes

• npm run typecheck currently fails on a pre-existing syntax error in types/api.ts.
• npm run lint currently fails on pre-existing unrelated issues in components/auth/TOTPSetupGuide.tsx and dashboard hook dependencies.
• npm test reports existing accessibility failures and was interrupted after hanging on the repo test process.

Closes #75

[vercel]

@bradleyfernando is attempting to deploy a commit to the dreamgenex's projects Team on Vercel.

A member of the Team first needs to authorize it.