5.14.1

Fixed

• Fixed handling of rejected promises in the App Instance API Client (#536)

5.14.0

Added

• Single reports of a MulticastSendReport now include the sent message, in addition to the response.
• It is now possible to validate multiple messages at once by adding a parameter to the send* Methods (Documentation)
• It is now possible to check a list of registration tokens whether they are valid and known, unknown, or invalid (Documentation)
• Added methods:
  • Kreait\Firebase\Messaging::validateRegistrationTokens($registrationTokenOrTokens)

Deprecated

• Kreait\Firebase\Http\Requests::findBy()
• Kreait\Firebase\Messaging\MulticastSendReport::withAdded()

Fixed

• 5.13 introduced a bug which caused expired ID tokens not to be rejected as invalid. #526

5.13.0

This release ensures compatibility with PHP 8.0

5.12.0

Added

• The Auth component is now tenant-aware. (Documentation)
• Added methods
  • \Kreait\Firebase\RemoteConfig\Parameter::description()

Fixed

• Fix usage of deprecated functionality from lcobucci/jwt

5.11.0

Added

• Added helper methods to add default/specific notification sounds to messages (Documentation)
  • Kreait\Firebase\Messaging\ApnsConfig::withDefaultSound()
  • Kreait\Firebase\Messaging\ApnsConfig::withSound($sound)
  • Kreait\Firebase\Messaging\AndroidConfig::withDefaultSound()
  • Kreait\Firebase\Messaging\AndroidConfig::withSound($sound)
  • Kreait\Firebase\Messaging\CloudMessage::withDefaultSounds()
• Added exception handler for FCM errors concerning quota/rate limits. When a quota is exceeded, a Kreait\Firebase\Exception\Messaging\QuotaExceeded exception is thrown. You can get the datetime after which to retry with Kreait\Firebase\Exception\Messaging\QuotaExceeded::retryAfter()
• When the Firebase API is unavailable and/or overloaded, the response might return a Retry-After header. When it does, you can get the datetime after which it is suggested to retry with Kreait\Firebase\Exception\Messaging\ServerUnavailable::retryAfter()
• Added support for the retrieval of user's last activity time with Kreait\Firebase\Auth\UserMetadata::$lastRefreshedAt

Fixed

• Kreait\Firebase\Messaging\CloudMessage::fromArray() did not allow providing pre-configured message components (objects instead of "pure" arrays)

5.10.0

Added

• Added Kreait\Firebase\Auth::getUsers() enables retrieving multiple users at once. (#477) (Documentation)
• Added support to sign in with Twitter OAuth credentials (#481)
• Added convenience method to sign in with IDP credentials (Documentation):
  • Kreait\Firebase\Auth::signInWithTwitterOauthCredential($accessToken, $oauthTokenSecret)
  • Kreait\Firebase\Auth::signInWithGoogleIdToken($idToken)
  • Kreait\Firebase\Auth::signInWithFacebookAccessToken($accessToken)
• It is now possible to add/remove multiple topic subscriptions for multiple registration tokens. (Previously, you could already work with multiple registration tokens, but only on single message topics). (Documentation)
  • Kreait\Firebase\Messaging::subscribeToTopics($topics, $registrationTokenOrTokens)
  • Kreait\Firebase\Messaging::unsubscribeFromTopics($topics, $registrationTokenOrTokens)
  • Kreait\Firebase\Messaging::unsubscribeFromAllTopics($registrationTokenOrTokens)
• The RemoteConfig component now support Parameter Groups. (Documentation)
• Added methods allowing to use the email address associated with OOB password resets. (#482, #485)
  • Kreait\Firebase\Auth::verifyPasswordResetCodeAndReturnEmail(string $oobCode)
  • Kreait\Firebase\Auth::confirmPasswordResetAndReturnEmail(string $oobCode, $newPassword, bool $invalidatePreviousSessions = true)

Changed

• Replaced usage of deprecated Guzzle helpers

Deprecated

• Kreait\Firebase\RemoteConfig\Parameter::fromArray()
• Kreait\Firebase\RemoteConfig\Template::fromResponse()

5.9.0

PHP ^8.0 is now an allowed (but untested) PHP version

5.8.1

The HttpClientOptions introduced in 5.8.0 caused a misconfiguration in the underlying HTTP Client by trying to be too fancy (I'm sorry). (#466)

This is technically a breaking change because the return type of some public methods of the HttpClientOptions has changed - but since they are meant to be used for service creation, it is very unlikely that they have been used outside the SDK internals, so the risk of breaking an existing application with this change is so low that I'll take the risk of getting shouted at for it.

5.8.0

• It is now possible to remove emails from users in the auth database. (#459)
• You can configure the behavior of the HTTP Client performing the API requests by passing an instance of Kreait\Firebase\Http\HttpClientOptions to the factory before creating a service. (Documentation)

5.7.0

Added

• Added Kreait\Firebase\RemoteConfig\DefaultValue now has an added value() method to retrieve a default value's value.
• When a given service account could not be processed, the error message now includes more details.