feat(auth, ios): Add support for Facebook Limited Login

[MegaMaddin]

Description

Add support for Facebook Limited Login, as well as some testing and documentation around that feature.

Related issues

Fixes #5441.

Release Summary

Add support for Facebook Limited Login.

Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
  • Yes
• My change supports the following platforms;
  • Android
  • iOS
• My change includes tests;
  • e2e tests added or updated in packages/\*\*/e2e
  • jest tests added or updated in packages/\*\*/__tests__
• I have updated TypeScript types that are affected by my change.
• This is a breaking change;
  • Yes
  • No

Test Plan

Using this patchset in one of my own apps, login into Facebook w/ and w/o limited login is still functional:

userStateChanged to {
    "displayName": "Martin Maze",
    "email": null,
    "emailVerified": false,
    "isAnonymous": false,
    "metadata": {
        "creationTime": 1644870528653,
        "lastSignInTime": 1644875913305
    },
    "phoneNumber": null,
    "photoURL": "https://graph.facebook.com/137XXXXXXXXXX/picture",
    "providerData": [[Object]],
    "providerId": "firebase",
    "refreshToken": "AI....",
    "tenantId": null,
    "uid": "XXXYYYZZZZ"
}

🔥

[CLAassistant]

All committers have signed the CLA.

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployments, click below or on the icon next to each commit.

react-native-firebase – ./

🔍 Inspect: https://vercel.com/invertase/react-native-firebase/6n4jz3FjC2nrWh9C7TddngfnDjUJ
✅ Preview: https://react-native-firebase-git-fork-megamaddin-ios-8939cd-invertase.vercel.app

react-native-firebase-next – ./website_modular

🔍 Inspect: https://vercel.com/invertase/react-native-firebase-next/7zRJTWvkAMA1iHm2dJd8Aua6bKB7
✅ Preview: Canceled

[Deployment for a3a1abb canceled]

[mikehardy]

Wow, this looks great, thank you for the PR! Hopefully CI goes green, frequently there is some trivial lint thing but I don't see anything with the naked eye right now...

[codecov]

Codecov Report

Merging #6073 (bf82870) into main (a217978) will not change coverage.
The diff coverage is 0.00%.

❗ Current head bf82870 differs from pull request most recent head a3a1abb. Consider uploading reports for the commit a3a1abb to get more accurate results

@@            Coverage Diff            @@
##               main    #6073   +/-   ##
=========================================
  Coverage     52.92%   52.92%           
  Complexity      622      622           
=========================================
  Files           208      208           
  Lines         10220    10220           
  Branches       1625     1626    +1     
=========================================
  Hits           5408     5408           
  Misses         4558     4558           
  Partials        254      254           

[MegaMaddin]

Fixed format errors.

[mikehardy]

at a computer now (was mobile prior) and still looks good to me. I approved the second CI run, hopefully goes green this time ;-)