feat: 78e41967de0ef13ee2cab02e44ec1af95536b0b2

Author: serverpod_cloud

ground_control_client/lib/src/protocol/client.dart

@@ -477,6 +477,7 @@ class EndpointProjects extends _i1.EndpointRef {
       );
 
   /// Invites a user to a project by assigning the specified project roles.
+  /// If the user does not exist, a user invitation email is sent.
   ///
   /// Throws [NotFoundException] if the project or any of the roles
   /// do not exist.

…roject/models/account_authorization.dart …/users/models/account_authorization.dartground_control_client/lib/src/protocol/features/project/models/account_authorization.dart renamed to ground_control_client/lib/src/protocol/domains/users/models/account_authorization.dart ground_control_client/lib/src/protocol/features/project/models/account_authorization.dart renamed to ground_control_client/lib/src/protocol/domains/users/models/account_authorization.dart

@@ -11,6 +11,7 @@
 // ignore_for_file: no_leading_underscores_for_library_prefixes
 import 'package:serverpod_client/serverpod_client.dart' as _i1;
 
+/// This model and table is deprecated. Use UserInvitation instead.
 abstract class AccountAuthorization implements _i1.SerializableModel {
   AccountAuthorization._({
     this.id,

ground_control_client/lib/src/protocol/domains/users/models/user.dart

@@ -10,7 +10,8 @@
 
 // ignore_for_file: no_leading_underscores_for_library_prefixes
 import 'package:serverpod_client/serverpod_client.dart' as _i1;
-import '../../../features/project/models/user_role_membership.dart' as _i2;
+import '../../../domains/users/models/user_account_status.dart' as _i2;
+import '../../../features/project/models/user_role_membership.dart' as _i3;
 
 /// Represents a Serverpod cloud customer user.
 abstract class User implements _i1.SerializableModel {
@@ -19,26 +20,28 @@ abstract class User implements _i1.SerializableModel {
     DateTime? createdAt,
     DateTime? updatedAt,
     this.archivedAt,
-    required this.userAuthId,
+    _i2.UserAccountStatus? accountStatus,
+    this.userAuthId,
     this.displayName,
     required this.email,
     this.image,
     this.memberships,
-    int? maxOwnedProjects,
+    this.maxOwnedProjects,
   })  : createdAt = createdAt ?? DateTime.now(),
         updatedAt = updatedAt ?? DateTime.now(),
-        maxOwnedProjects = maxOwnedProjects ?? 3;
+        accountStatus = accountStatus ?? _i2.UserAccountStatus.registered;
 
   factory User({
     int? id,
     DateTime? createdAt,
     DateTime? updatedAt,
     DateTime? archivedAt,
-    required String userAuthId,
+    _i2.UserAccountStatus? accountStatus,
+    String? userAuthId,
     String? displayName,
     required String email,
     Uri? image,
-    List<_i2.UserRoleMembership>? memberships,
+    List<_i3.UserRoleMembership>? memberships,
     int? maxOwnedProjects,
   }) = _UserImpl;
 
@@ -52,15 +55,17 @@ abstract class User implements _i1.SerializableModel {
       archivedAt: jsonSerialization['archivedAt'] == null
           ? null
           : _i1.DateTimeJsonExtension.fromJson(jsonSerialization['archivedAt']),
-      userAuthId: jsonSerialization['userAuthId'] as String,
+      accountStatus: _i2.UserAccountStatus.fromJson(
+          (jsonSerialization['accountStatus'] as String)),
+      userAuthId: jsonSerialization['userAuthId'] as String?,
       displayName: jsonSerialization['displayName'] as String?,
       email: jsonSerialization['email'] as String,
       image: jsonSerialization['image'] == null
           ? null
           : _i1.UriJsonExtension.fromJson(jsonSerialization['image']),
       memberships: (jsonSerialization['memberships'] as List?)
           ?.map((e) =>
-              _i2.UserRoleMembership.fromJson((e as Map<String, dynamic>)))
+              _i3.UserRoleMembership.fromJson((e as Map<String, dynamic>)))
           .toList(),
       maxOwnedProjects: jsonSerialization['maxOwnedProjects'] as int?,
     );
@@ -77,8 +82,11 @@ abstract class User implements _i1.SerializableModel {
 
   DateTime? archivedAt;
 
+  /// The status of the user's account.
+  _i2.UserAccountStatus accountStatus;
+
   /// External user authentication id. Must be unique.
-  String userAuthId;
+  String? userAuthId;
 
   String? displayName;
 
@@ -89,10 +97,9 @@ abstract class User implements _i1.SerializableModel {
   Uri? image;
 
   /// The role memberships of this user.
-  List<_i2.UserRoleMembership>? memberships;
+  List<_i3.UserRoleMembership>? memberships;
 
   /// Max number of projects this user can own.
-  /// If null, the default value is used.
   int? maxOwnedProjects;
 
   /// Returns a shallow copy of this [User]
@@ -103,11 +110,12 @@ abstract class User implements _i1.SerializableModel {
     DateTime? createdAt,
     DateTime? updatedAt,
     DateTime? archivedAt,
+    _i2.UserAccountStatus? accountStatus,
     String? userAuthId,
     String? displayName,
     String? email,
     Uri? image,
-    List<_i2.UserRoleMembership>? memberships,
+    List<_i3.UserRoleMembership>? memberships,
     int? maxOwnedProjects,
   });
   @override
@@ -117,7 +125,8 @@ abstract class User implements _i1.SerializableModel {
       'createdAt': createdAt.toJson(),
       'updatedAt': updatedAt.toJson(),
       if (archivedAt != null) 'archivedAt': archivedAt?.toJson(),
-      'userAuthId': userAuthId,
+      'accountStatus': accountStatus.toJson(),
+      if (userAuthId != null) 'userAuthId': userAuthId,
       if (displayName != null) 'displayName': displayName,
       'email': email,
       if (image != null) 'image': image?.toJson(),
@@ -141,17 +150,19 @@ class _UserImpl extends User {
     DateTime? createdAt,
     DateTime? updatedAt,
     DateTime? archivedAt,
-    required String userAuthId,
+    _i2.UserAccountStatus? accountStatus,
+    String? userAuthId,
     String? displayName,
     required String email,
     Uri? image,
-    List<_i2.UserRoleMembership>? memberships,
+    List<_i3.UserRoleMembership>? memberships,
     int? maxOwnedProjects,
   }) : super._(
           id: id,
           createdAt: createdAt,
           updatedAt: updatedAt,
           archivedAt: archivedAt,
+          accountStatus: accountStatus,
           userAuthId: userAuthId,
           displayName: displayName,
           email: email,
@@ -169,7 +180,8 @@ class _UserImpl extends User {
     DateTime? createdAt,
     DateTime? updatedAt,
     Object? archivedAt = _Undefined,
-    String? userAuthId,
+    _i2.UserAccountStatus? accountStatus,
+    Object? userAuthId = _Undefined,
     Object? displayName = _Undefined,
     String? email,
     Object? image = _Undefined,
@@ -181,11 +193,12 @@ class _UserImpl extends User {
       createdAt: createdAt ?? this.createdAt,
       updatedAt: updatedAt ?? this.updatedAt,
       archivedAt: archivedAt is DateTime? ? archivedAt : this.archivedAt,
-      userAuthId: userAuthId ?? this.userAuthId,
+      accountStatus: accountStatus ?? this.accountStatus,
+      userAuthId: userAuthId is String? ? userAuthId : this.userAuthId,
       displayName: displayName is String? ? displayName : this.displayName,
       email: email ?? this.email,
       image: image is Uri? ? image : this.image,
-      memberships: memberships is List<_i2.UserRoleMembership>?
+      memberships: memberships is List<_i3.UserRoleMembership>?
           ? memberships
           : this.memberships?.map((e0) => e0.copyWith()).toList(),
       maxOwnedProjects:

ground_control_client/lib/src/protocol/domains/users/models/user_account_status.dart

@@ -0,0 +1,37 @@
+/* AUTOMATICALLY GENERATED CODE DO NOT MODIFY */
+/*   To generate run: "serverpod generate"    */
+
+// ignore_for_file: implementation_imports
+// ignore_for_file: library_private_types_in_public_api
+// ignore_for_file: non_constant_identifier_names
+// ignore_for_file: public_member_api_docs
+// ignore_for_file: type_literal_in_constant_pattern
+// ignore_for_file: use_super_parameters
+
+// ignore_for_file: no_leading_underscores_for_library_prefixes
+import 'package:serverpod_client/serverpod_client.dart' as _i1;
+
+enum UserAccountStatus implements _i1.SerializableModel {
+  /// User has been invited to access the system (implies pre-authorized).
+  invited,
+
+  /// User has authenticated and registered an account.
+  registered;
+
+  static UserAccountStatus fromJson(String name) {
+    switch (name) {
+      case 'invited':
+        return UserAccountStatus.invited;
+      case 'registered':
+        return UserAccountStatus.registered;
+      default:
+        throw ArgumentError(
+            'Value "$name" cannot be converted to "UserAccountStatus"');
+    }
+  }
+
+  @override
+  String toJson() => name;
+  @override
+  String toString() => name;
+}