[Firebase Auth] added access to User metadata

allows to recover the account creation date, and the last sign in date
of an user.

With them, you can determine if a user logs in for the first time.
(and then, create a welcome/ setup page, for example)

Author: LucasParsy

packages/firebase_auth/android/src/main/java/io/flutter/plugins/firebaseauth/FirebaseAuthPlugin.java

@@ -610,6 +610,8 @@ private Map<String, Object> mapFromUser(FirebaseUser user) {
         providerData.add(Collections.unmodifiableMap(userInfoToMap(userInfo)));
       }
       Map<String, Object> userMap = userInfoToMap(user);
+      userMap.put("creationTimestamp", user.getMetadata().getCreationTimestamp());
+      userMap.put("lastSignInTimestamp", user.getMetadata().getLastSignInTimestamp());
       userMap.put("isAnonymous", user.isAnonymous());
       userMap.put("isEmailVerified", user.isEmailVerified());
       userMap.put("providerData", Collections.unmodifiableList(providerData));

packages/firebase_auth/ios/Classes/FirebaseAuthPlugin.m

@@ -275,7 +275,13 @@ - (NSMutableDictionary *)dictionaryFromUser:(FIRUser *)user {
   for (id<FIRUserInfo> userInfo in user.providerData) {
     [providerData addObject:toDictionary(userInfo)];
   }
+
+  long creationDate = [user.metadata.creationDate timeIntervalSince1970];
+  long lastSignInDate = [user.metadata.lastSignInDate timeIntervalSince1970];
+
   NSMutableDictionary *userData = [toDictionary(user) mutableCopy];
+  userData[@"creationTimestamp"] = [NSNumber numberWithLong:creationDate];
+  userData[@"lastSignInTimestamp"] = [NSNumber numberWithInt:lastSignInDate];
   userData[@"isAnonymous"] = [NSNumber numberWithBool:user.isAnonymous];
   userData[@"isEmailVerified"] = [NSNumber numberWithBool:user.isEmailVerified];
   userData[@"providerData"] = providerData;

packages/firebase_auth/lib/firebase_auth.dart

@@ -8,6 +8,16 @@ import 'package:flutter/services.dart';
 import 'package:meta/meta.dart';
 
 /// Represents user data returned from an identity provider.
+
+class FirebaseUserMetadata {
+  final Map<dynamic, dynamic> _data;
+
+  FirebaseUserMetadata._(this._data);
+
+  int get creationTimestamp => _data['creationTimestamp'];
+  int get lastSignInTimestamp => _data['lastSignInTimestamp'];
+}
+
 class UserInfo {
   final Map<dynamic, dynamic> _data;
 
@@ -57,16 +67,20 @@ class UserUpdateInfo {
 /// Represents a user.
 class FirebaseUser extends UserInfo {
   final List<UserInfo> providerData;
+  final FirebaseUserMetadata _metadata;
 
   FirebaseUser._(Map<dynamic, dynamic> data)
       : providerData = data['providerData']
             .map<UserInfo>((dynamic item) => new UserInfo._(item))
             .toList(),
+        _metadata = new FirebaseUserMetadata._(data),
         super._(data);
 
   // Returns true if the user is anonymous; that is, the user account was
   // created with signInAnonymously() and has not been linked to another
   // account.
+  FirebaseUserMetadata get metadata => _metadata;
+
   bool get isAnonymous => _data['isAnonymous'];
 
   /// Returns true if the user's email is verified.