Allow authenticating users

[jeromegamez]

The changes in this branch allow authenticating users with given credentials (or no credentials at all :))

• Kreait\Firebase\Auth::signInAnonymously()
• Kreait\Firebase\Auth::signInAsUser($userOrUid, array $claims = null)
• Kreait\Firebase\Auth::signInWithCustomToken($customToken)
• Kreait\Firebase\Auth::signInWithEmailAndPassword($email, $clearTextPassword)
• Kreait\Firebase\Auth::signInWithRefreshToken($refreshToken)

Todo

• Authenticate with Identity Provider Credentials (= Access- or ID Tokens from federated users)
• Authenticate anonymously
• Use the new methods instead of going through Kreait\Firebase\Auth\ApiClient, where applicable
• Documentation

How to test

Add this to the composer.json file of your project:

"kreait/firebase-php": "dev-user-authentication"

The methods mentioned above will return an instance of Kreait\Firebase\Auth\AuthenticationResult with the following getters and checkers:

• idToken(): Kreait\Firebase\Auth\IdToken
• accessToken(): Kreait\Firebase\Auth\AccessToken (not always set)
• refreshToken(): Kreait\Firebase\Auth\RefreshToken
• isExpired(): bool

For the rest, you'll have to dig through the code 😅

[codecov]

Codecov Report

Merging #390 into master will increase coverage by 0.21%.
The diff coverage is 97.64%.

@@             Coverage Diff              @@
##             master     #390      +/-   ##
============================================
+ Coverage     96.48%   96.69%   +0.21%     
- Complexity     1204     1260      +56     
============================================
  Files           139      146       +7     
  Lines          3099     3239     +140     
============================================
+ Hits           2990     3132     +142     
+ Misses          109      107       -2     

[baudev]

Amazing PR!
How soon do you plan to release it?

[jeromegamez]

@baudev I‘m currently working on the documentation, it shouldn‘t be too long 🤞

[jeromegamez]

Merged with e9be70f