feat(auth): add support for tenants (#103)

* feat(auth): add support for tenants

* add e2e tests

* more

* more

* fixes

* fix conflicts

* refactor: update terminology from 'whitelisted' to 'allowed' for consistency

---------

Co-authored-by: Ademola Fadumo <demolafadumo@gmail.com>

Author: Lyokone

packages/dart_firebase_admin/lib/src/app/exception.dart

@@ -30,7 +30,7 @@ String _platformErrorCodeMessage(String code) {
     case 'PERMISSION_DENIED':
       return 'Client does not have sufficient permission. This can happen because the OAuth token does not have the right scopes, the client does not have permission, or the API has not been enabled for the client project.';
     case 'NOT_FOUND':
-      return 'Specified resource not found, or the request is rejected due to undisclosed reasons such as whitelisting.';
+      return 'Specified resource not found, or the request is rejected due to undisclosed reasons such as allow list restrictions.';
     case 'CONFLICT':
       return 'Concurrency conflict, such as read-modify-write conflict. Only used by a few legacy services. Most services use ABORTED or ALREADY_EXISTS instead of this. Refer to the service-specific documentation to see which one to handle in your code.';
     case 'ABORTED':

packages/dart_firebase_admin/lib/src/auth.dart

@@ -25,11 +25,14 @@ import 'utils/validator.dart';
 part 'auth/action_code_settings_builder.dart';
 part 'auth/auth.dart';
 part 'auth/auth_config.dart';
+part 'auth/auth_config_tenant.dart';
 part 'auth/auth_exception.dart';
 part 'auth/auth_http_client.dart';
 part 'auth/auth_request_handler.dart';
 part 'auth/base_auth.dart';
 part 'auth/identifier.dart';
+part 'auth/tenant.dart';
+part 'auth/tenant_manager.dart';
 part 'auth/token_generator.dart';
 part 'auth/token_verifier.dart';
 part 'auth/user.dart';

packages/dart_firebase_admin/lib/src/auth/auth.dart

@@ -34,6 +34,17 @@ class Auth extends _BaseAuth implements FirebaseService {
     }
   }
 
-  // TODO tenantManager
+  TenantManager? _tenantManager;
+
+  /// The [TenantManager] instance associated with the current project.
+  ///
+  /// This provides tenant management capabilities for multi-tenant applications.
+  /// Multi-tenancy support requires Google Cloud's Identity Platform (GCIP).
+  /// To learn more about GCIP, including pricing and features, see the
+  /// [GCIP documentation](https://cloud.google.com/identity-platform).
+  TenantManager get tenantManager {
+    return _tenantManager ??= TenantManager._(app);
+  }
+
   // TODO projectConfigManager
 }