feat: support throwing errors instead of returning them

[kiwicopple]

Fixes supabase/supabase-js#1688

Add support for throwOnError option in AuthClient to throw errors instead of returning them.

• GoTrueClient Changes:

  • Add throwOnError option to GoTrueClient constructor.
  • Modify methods to throw errors when throwOnError is true.
  • Update methods like signUp, signInWithPassword, updateUser, and others to throw errors if throwOnError is true.

• AuthClient Changes:

  • Update AuthClient to pass throwOnError option to GoTrueClient.

• Tests:

  • Add tests in test/GoTrueClient.test.ts to verify throwOnError functionality.

---

For more details, open the Copilot Workspace session.

[kiwicopple]

---

[hf]

Maybe a better way to deal with this is to have a function like so:

private function _returnResult<D, E>(result: { data: D, error: E }): { data: D, error: E } {
  if (this.throwOnError && result.error) {
    throw result.error
  }

  return result
}

Then each time we return the object we call:

return this._returnResult({ data: null, error })

It will be easier to spot and we could also potentially write a lint rule for it so it's not forgotten.

[hf]

Don't worry about the check-conventional-commits errors, I'll fix those before merging.

[mandarini]

moved: supabase/supabase-js#1766