fix: add auth.jwt() function

[kangmingtay]

What kind of change does this PR introduce?

• Add auth.jwt() function to return the user's jwt claims
• Add comments to signal deprecating auth.email, auth.uid, auth.role and to use auth.jwt instead

[github-actions]

🎉 This PR is included in version 2.6.31 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

[dshukertjr]

Would auth.uid() be removed at some point after deprecation, or does existing project have access to auth.uid() indefinitely?

[kangmingtay]

hmm yeah i think we've decided to not deprecate the auth.uid() function in view of convenience since doing auth.jwt()->>'sub'::uuid everytime is gonna be pretty annoying

will remove the comment to deprecate that function

cc @kiwicopple

[tvogel]

The deprecation notice on auth.uid() still seems to be there and was confusing me today. And I very much agree that having a short-hand for that is worth it. Actually, I tend to think the same for auth.email() even though it's probably used a lot less. And I think, the deprecation notice for auth.role() should point to https://github.com/orgs/supabase/discussions/16703 because using auth.jwt() -> 'role' in RLS rules instead is not the intended effect of the deprecation.