feat(clerk-expo): Deprecate useOAuth and introduce docs for useSSO

[LauraBeatris]

Related: #1907

Important

🔎 Previews:

• https://clerk.com/docs/pr/1908/references/expo/use-sso

Explanation:

⚠️ Needs these redirects https://github.com/clerk/clerk/pull/941

A new React hook got added to @clerk/expo to handle all SSO strategies, such as SAML and social/custom OAuth

useOAuth got deprecated in favor of useSSO

This PR:

Resolves ORGS-460

• Deprecates useOAuth guide
• Introduces docs for useSSO
• Introduces code snippets for both social OAuth and SAML

Checklist

• I have clicked on "Files changed" and performed a thorough self-review
• I have added the "deploy-preview" label and added the preview link(s) to this PR description
• All existing checks pass

[github-actions]

Hey, here’s your docs preview: https://clerk.com/docs/pr/1908

[victoriaxyz]

If this is a custom sign-in flow, do we still want to link to this page?

[LauraBeatris]

Which page? Do you mean /docs/authentication/social-connections/google?

[victoriaxyz]

Yes! Would it make sense?

[victoriaxyz]

Hey @LauraBeatris, here's my review.

Update: d13a572

• fixed page title
• formatted the <Properties /> table
• currently, since strategy is nested under enterprise_sso, it looks like everything that falls under that type, but enterprise_sso doesn’t have oauth_<provider>, also this differs from the other PR
  • context: feat(clerk-expo): Deprecate useOAuth and introduce docs for useSSO #1908 (comment) | feat(clerk-expo): Deprecate useOAuth and introduce docs for useSSO #1908 (comment)
• fixed code:
  • added intros to explain functionality and context: 1fd1a11
  • use correct function startSSOFlow vs. useSSOFlow and fix function signature: feat(clerk-expo): Deprecate useOAuth and introduce docs for useSSO #1908 (comment)
  • removed unused imports and imported React ones
  • rewrote and added comments for clarity (e.g., what scheme is in createURL)

Notes

• the linter is failing because of the missing files that are in the other PR
• the other PR also edits the same file: docs/references/expo/use-sso.mdx
• identifier is required for enterprise_sso but doesn't exist in UseSSOParams
• docs/_partials/expo/oauth-custom-flow.mdx file needs to be restored if this code is still being used
• got errors when testing the code: feat(clerk-expo): Deprecate useOAuth and introduce docs for useSSO #1908 (comment)

[LauraBeatris]

We should also update for: https://clerk.com/docs/custom-flows/oauth-connections

[alexisintech]

Hi! Just did a review, and a question:

1. I'm not seeing parameters for the useSSO() hook?

Summary of my review:
manifest.json

• Added useOAuth() back to the sidenav, and marked it as deprecated
  docs/references/expo/use-oauth.mdx
• Updated the deprecation callout in the useOAuth() guide
  docs/references/expo/use-sso.mdx
• aligned parameter descriptions with what's used in other docs
• added missing params for StartSSOFlowParams

[alexisintech]

Will test the custom flow code when the JavaScript PR is ready to merge/is merged.

Outstanding question:
I'm not seeing parameters for the useSSO() hook?

[alexisintech]

wooooooooo !! 🥳

[alexisintech]

oh wait, there's a TODO there for ya @LauraBeatris

[LauraBeatris]

@alexisintech We need to merge https://github.com/clerk/clerk/pull/941 right after this one as well!