Docs/frontend sdk reference

[kiel997]

closes #495

Summary

• Add frontend SDK reference documentation
• Document all exposed client methods, parameters, and return types
• Document convenience SDK functions and error-handling behavior
• Document retry, timeout, rate-limit, and API error handling

Testing

• Verified the documentation against the current frontend SDK wrapper implementation
• Ran the relevant project tests

Scope

This PR only adds the frontend SDK reference documentation and does not modify the backend SDK API.

[drips-wave]

@kiel997 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[vercel]

@kiel997 is attempting to deploy a commit to the aminubabafatima8-gmailcom's projects Team on Vercel.

A member of the Team first needs to authorize it.

[phertyameen]

fix this ci too please

[phertyameen]

Merged to \main\ as part of a consolidated integration (branch \merge-final, now pushed as commit \5155235\ on main).

Validation on main:

• Frontend CI: green
• Lighthouse CI: green
• Mobile CI: Lint & Type Check, Unit Tests, and Android/iOS prebuild all green

Note: the Mobile CI Android/iOS native debug build jobs still fail on pre-existing repo issues unrelated to this PR (react-native-reanimated vs RN 0.81 compile error, and the macos-14 runner's Xcode 15.4 vs RN's required Xcode >= 16.1). Tracked as follow-up work, not blocked by this change.