=== Summary: 675 files | 7 generated | 484 fresh | 4605 untracked | 4268 adopted | 355 marked | 466 validated-ok | 2+0 stale (sig+body) | 0 skipped | 0 failed | elapsed 11:08:11.442 (40091.44s) ===

2026-06-28 02:50:05 -07:00
parent a19fb90902
commit 586f02a2ca
654 changed files with 5260 additions and 0 deletions
@@ -10,29 +10,34 @@ public interface IAuthorityService
    /// </summary>
    /// <param name="userId">The unique identifier of the user whose authorizations are being requested.</param>
    /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> objects for the user.</returns>
+    /// <!-- aidoc:v1 sig=1476a1a -->
    public Task<List<Authorization>> GetUserAuthorities(ObjectId userId);
    /// <summary>
    /// Creates a new role with the specified name and associates it with the given user.
    /// </summary>
    /// <param name="roleName">The name of the role to create.</param>
    /// <param name="userId">The identifier of the user to associate with the new role.</param>
+    /// <!-- aidoc:v1 sig=ea6d5b6 -->
    public void CreateNew(string roleName, ObjectId userId);
    /// <summary>
    /// Inserts a new authorization record into the data store.
    /// </summary>
    /// <param name="authorization">The authorization entity to insert.</param>
    /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=bf14da0 -->
    public Task InsertOne(Authorization authorization);
    /// <summary>
    /// Updates a single authorization record.
    /// </summary>
    /// <param name="authorization">The authorization object containing the data to be updated.</param>
+    /// <!-- aidoc:v1 sig=2e9fb22 -->
    public Task updateOne(Authorization authorization);

    /// <summary>
    /// Asynchronously retrieves all authorizations.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains a list of all authorization objects.</returns>
+    /// <!-- aidoc:v1 sig=dd351e0 -->
    public Task<List<Authorization>> GetAllAuthorities();

    /// <summary>
@@ -40,23 +45,27 @@ public interface IAuthorityService
    /// </summary>
    /// <param name="id">The unique identifier of the user whose authorities should be removed.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if authorities were deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=851a476 -->
    Task<bool> DeleteAuthoritiesForUser(ObjectId id);
    /// <summary>
    /// Creates a new user authority based on the provided <paramref name="authorization"/>.
    /// </summary>
    /// <param name="authorization">The authorization data used to create the new user authority.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="Authorization"/>, or <c>null</c> if the authority could not be created.</returns>
+    /// <!-- aidoc:v1 sig=adb1353 -->
    Task<Authorization?> CreateNewUserAuthority(Authorization authorization);
    /// <summary>
    /// Asynchronously deletes a user authority identified by the provided parsed identifier.
    /// </summary>
    /// <param name="userAuthorityIdParsed">The parsed identifier of the user authority to delete.</param>
    /// <returns>A task that represents the asynchronous delete operation. The task result is <see langword="true"/> if the user authority was successfully deleted; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=d8ae827 -->
    Task<bool> DeleteUserAuthority(ObjectId userAuthorityIdParsed);
    /// <summary>
    /// Edits the user authority using the provided authorization data.
    /// </summary>
    /// <param name="authorization">The authorization object containing the user authority details to be updated.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Authorization"/>, or <c>null</c> if the authorization was not found.</returns>
+    /// <!-- aidoc:v1 sig=857d49a -->
    Task<Authorization?> EditUserAuthority(Authorization authorization);
 }
@@ -15,12 +15,14 @@ public interface ILoginService
    /// <param name="username">The username of the user attempting to log in.</param>
    /// <param name="password">The password associated with the username.</param>
    /// <returns>A <see cref="Task{User}"/> representing the asynchronous operation, containing the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=a4700d5 -->
    Task<User> Login(string username, string password);
    /// <summary>
    /// Authenticates a user based on the provided HTTP context.
    /// </summary>
    /// <param name="context">The HTTP context containing the request information used to perform the login.</param>
    /// <returns>A task that represents the asynchronous login operation. The task result contains the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=ff09cb3 -->
    Task<User> Login(HttpContext context);

    /// <summary>
@@ -29,29 +31,34 @@ public interface ILoginService
    /// <param name="username">The username of the user to authenticate.</param>
    /// <param name="password">The password of the user to authenticate.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=a232f05 -->
    Task<User> Authenticate(string username, string password);
    /// <summary>
    /// Retrieves a user by their unique identifier, returning null if no matching user is found.
    /// </summary>
    /// <param name="id">The unique identifier of the user to look up.</param>
    /// <returns>The user with the specified identifier, or null if no user is found.</returns>
+    /// <!-- aidoc:v1 sig=ab4b64e -->
    Task<User?> GetById(ObjectId id);
    /// <summary>
    /// Retrieves a user from the data store by their email address, or returns null if no matching user is found.
    /// </summary>
    /// <param name="email">The email address used to look up the user.</param>
    /// <returns>A task that resolves to the <see cref="User"/> matching the provided email, or null if no user is found.</returns>
+    /// <!-- aidoc:v1 sig=aad49e4 -->
    Task<User?> GetByEmail(string email);
    /// <summary>
    /// Retrieves a user by their username asynchronously, returning <c>null</c> if no matching user is found.
    /// </summary>
    /// <param name="username">The username to look up.</param>
    /// <returns>A <see cref="Task{User}"/> that resolves to the matching <see cref="User"/>, or <c>null</c> if no user exists with the specified username.</returns>
+    /// <!-- aidoc:v1 sig=d91b767 -->
    Task<User?> GetByUsername(string username);

    /// <summary>
    /// Asynchronously retrieves a list of all users in the system.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="User"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=850c090 -->
    Task<List<User>> GetAllUsers();
 }
@@ -13,12 +13,14 @@ public interface ITokenService
    /// <param name="username">The username used to look up the security token.</param>
    /// <param name="claims">The list of claims associated with the token.</param>
    /// <returns>A <see cref="SecurityToken"/> if a matching token is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=78fe633 -->
    SecurityToken? GetToken(string username, List<Claim> claims);

    /// <summary>
    /// Retrieves the current refresh token used to obtain new access tokens for authentication.
    /// </summary>
    /// <returns>The refresh token as a string.</returns>
+    /// <!-- aidoc:v1 sig=575d89a -->
    string GetRefreshToken();

    /// <summary>
@@ -26,5 +28,6 @@ public interface ITokenService
    /// </summary>
    /// <param name="token">The security token to serialize.</param>
    /// <returns>A string containing the serialized form of the security token.</returns>
+    /// <!-- aidoc:v1 sig=0e94bd2 -->
    string Serialize(SecurityToken token);
 }
@@ -20,6 +20,7 @@ public interface IUserService
    /// <param name="username">The username of the user attempting to log in.</param>
    /// <param name="password">The password associated with the specified username.</param>
    /// <returns>A task that represents the asynchronous login operation, containing the <see cref="TokenResult"/> with the authentication token information.</returns>
+    /// <!-- aidoc:v1 sig=d557171 -->
    Task<TokenResult> Login(string username, string password);
    /// <summary>
    /// Authenticates a user based on the provided username and password and returns the corresponding user.
@@ -27,12 +28,14 @@ public interface IUserService
    /// <param name="username">The username of the user to authenticate.</param>
    /// <param name="password">The password of the user to authenticate.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=b9ab570 -->
    Task<User> GetUser(string username, string password);
    /// <summary>
    /// Refreshes an authentication token using the provided refresh token and returns the resulting token information.
    /// </summary>
    /// <param name="refreshToken">The refresh token used to obtain a new access token.</param>
    /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing the <see cref="TokenResult"/> with the refreshed token details.</returns>
+    /// <!-- aidoc:v1 sig=c0187cf -->
    Task<TokenResult> RefreshToken(string refreshToken);

    /// <summary>
@@ -40,6 +43,7 @@ public interface IUserService
    /// </summary>
    /// <param name="token">The access token used to authenticate the user.</param>
    /// <returns>A task that represents the asynchronous login operation, containing the <see cref="TokenResult"/> with the outcome of the authentication.</returns>
+    /// <!-- aidoc:v1 sig=b806672 -->
    Task<TokenResult> LoginWithAccessToken(string token);
    /// <summary>
    /// Validates the specified token according to its type and outputs the corresponding <see cref="SecurityToken"/>.
@@ -47,6 +51,7 @@ public interface IUserService
    /// <param name="token">The token string to be validated.</param>
    /// <param name="tokenType">The type of the token, used to determine the appropriate validation strategy.</param>
    /// <param name="securityToken">When the method returns, contains the validated <see cref="SecurityToken"/> if validation succeeds.</param>
+    /// <!-- aidoc:v1 sig=994e231 -->
    void ValidateToken(string token, string tokenType, out SecurityToken securityToken);
    /// <summary>
    /// Retrieves the user associated with the provided JWT security token.
@@ -54,6 +59,7 @@ public interface IUserService
    /// </summary>
    /// <param name="jwtToken">The JWT security token used to identify the user. May be <c>null</c>.</param>
    /// <returns>A task that resolves to the <see cref="User"/> associated with the token, or <c>null</c> if the token is invalid or no user matches.</returns>
+    /// <!-- aidoc:v1 sig=4e2d176 -->
    Task<User?> GetUserByToken(JwtSecurityToken? jwtToken);
    /// <summary>
    /// Asynchronously retrieves a user by validating a CAS (Central Authentication Service) ticket against the specified service.
@@ -61,41 +67,48 @@ public interface IUserService
    /// <param name="service">The service URL or identifier that the ticket was issued for and must be validated against.</param>
    /// <param name="ticket">The CAS ticket string used to authenticate and identify the user.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the associated <see cref="User"/> if the ticket is valid, or <c>null</c> if the user cannot be found.</returns>
+    /// <!-- aidoc:v1 sig=35a0f18 -->
    Task<User?> GetUserByCasTicket(string service, string ticket);
    /// <summary>
    /// Asynchronously generates a JSON Web Token (JWT) for the specified user and returns the token result.
    /// </summary>
    /// <param name="user">The user for whom the JWT is being generated.</param>
    /// <returns>A task that represents the asynchronous operation, containing the <see cref="TokenResult"/> with the generated token details.</returns>
+    /// <!-- aidoc:v1 sig=87e065c -->
    Task<TokenResult> GenerateJwt(User user);
    /// <summary>
    /// Asynchronously retrieves all users from the data store.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="User"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=52f36eb -->
    Task<List<User>> GetAll();
    /// <summary>
    /// Asynchronously retrieves a user by their unique identifier, returning <c>null</c> when no user matches the provided id.
    /// </summary>
    /// <param name="id">The unique <see cref="ObjectId"/> identifier of the user to look up.</param>
    /// <returns>A task that resolves to the matching <see cref="User"/>, or <c>null</c> if no user is found for the given id.</returns>
+    /// <!-- aidoc:v1 sig=9fe25b3 -->
    Task<User?> GetUserById(ObjectId id);
    /// <summary>
    /// Asynchronously retrieves a user by their unique username, returning null when no matching user is found.
    /// </summary>
    /// <param name="name">The username used to look up the user.</param>
    /// <returns>A task that represents the asynchronous operation, containing the matching user if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=917e8bd -->
    Task<User?> GetUserByUserName(string name);
    /// <summary>
    /// Asynchronously retrieves a user matching the specified name, returning <c>null</c> when no matching user is found.
    /// </summary>
    /// <param name="name">The name used to look up the user.</param>
    /// <returns>A task that resolves to the matching <see cref="User"/>, or <c>null</c> if no user with the given name exists.</returns>
+    /// <!-- aidoc:v1 sig=ea58eab -->
    Task<User?> GetUserByName(string name);
    /// <summary>
    /// Creates a user from the provided LDAP user entry.
    /// </summary>
    /// <param name="userEntryLdap">The LDAP user entry used to create the user.</param>
    /// <returns>A task that represents the asynchronous create operation, containing the created <see cref="User"/> or <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=aefe667 -->
    Task<User?> CreateUser(User userEntryLdap);
    /// <summary>
    /// Creates a new user based on the provided user data, typically originating from an incoming request.
@@ -103,6 +116,7 @@ public interface IUserService
    /// </summary>
    /// <param name="user">The user data to use for creating the new user.</param>
    /// <returns>A task that represents the asynchronous operation. The result is the created <see cref="User"/>, or <see langword="null"/> if creation failed.</returns>
+    /// <!-- aidoc:v1 sig=658bda4 -->
    Task<User?> CreateNewUserByRequest(User user);

    /// <summary>
@@ -110,6 +124,7 @@ public interface IUserService
    /// </summary>
    /// <param name="createUserWithAuthDto">The data transfer object containing the information required to create the user and its authorities.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="User"/> instance, or <c>null</c> if no user was created.</returns>
+    /// <!-- aidoc:v1 sig=f76bd48 -->
    Task<User?> CreateNewUserWithAuthorities(CreateUserWithAuthDto createUserWithAuthDto);
    /// <summary>
    /// Updates an existing user along with the associated authorities, optionally updating the password.
@@ -117,6 +132,7 @@ public interface IUserService
    /// <param name="createUserWithAuthDto">The data transfer object containing the user information and authorities to update.</param>
    /// <param name="updatePass">A flag indicating whether the user's password should be updated as part of the operation.</param>
    /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="User"/> or <c>null</c> if the user was not found.</returns>
+    /// <!-- aidoc:v1 sig=a4bc265 -->
    Task<User?> UpdateUserWithAuthorities(UpdateUserWithAuthDto createUserWithAuthDto, bool updatePass);
    /// <summary>
    /// Updates a user's information based on the provided user data, with an option to include password updates.
@@ -124,6 +140,7 @@ public interface IUserService
    /// <param name="user">The user entity containing the updated information to be persisted.</param>
    /// <param name="updatePass">A flag indicating whether the user's password should be updated during this operation.</param>
    /// <returns>A task that returns the updated <see cref="User"/>, or null if the user could not be found.</returns>
+    /// <!-- aidoc:v1 sig=4c6a1ca -->
    Task<User?> UpdateUsersByRequest(User user, bool updatePass);
    /// <summary>
    /// Updates the password for the user identified by the specified identifier, verifying the old password before applying the new one.
@@ -132,41 +149,48 @@ public interface IUserService
    /// <param name="oldPassword">The user's current password, used to verify the request.</param>
    /// <param name="newPassword">The new password to set for the user.</param>
    /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the password was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=38635ef -->
    Task<bool> UpdateUserPassword(ObjectId id, string oldPassword, string newPassword);
    /// <summary>
    /// Asynchronously deletes a user identified by the specified identifier.
    /// </summary>
    /// <param name="id">The unique identifier of the user to delete.</param>
    /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the user was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=8d34422 -->
    Task<bool> DeleteUser(ObjectId id);
    /// <summary>
    /// Retrieves a paginated list of users based on the provided pagination filter configuration.
    /// </summary>
    /// <param name="config">The pagination filter that defines paging parameters such as page number and page size.</param>
    /// <returns>A task that represents the asynchronous operation, containing the paginated response of <see cref="User"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=e324e87 -->
    Task<PaginationResponse<User>> GetPaginatedUsers(PaginationFilter config);
    /// <summary>
    /// Asynchronously creates a new authority based on the provided authorization data.
    /// </summary>
    /// <param name="auth">The authorization information used to create the new authority.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="Authorization"/>.</returns>
+    /// <!-- aidoc:v1 sig=d636b5c -->
    Task<Authorization> CreateNewAuthority(Authorization auth);
    /// <summary>
    /// Asynchronously deletes an authority identified by the specified identifier.
    /// </summary>
    /// <param name="id">The unique identifier of the authority to delete.</param>
    /// <returns>A task that represents the asynchronous delete operation. The task result contains a boolean indicating whether the authority was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=e85ede9 -->
    Task<bool> DeleteAuthority(string id);
    /// <summary>
    /// Updates the authority information based on the provided authorization data.
    /// </summary>
    /// <param name="authorization">The authorization entity containing the authority details to be updated.</param>
    /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=0295989 -->
    Task<bool> UpdateAuthority(Authorization authorization);
    /// <summary>
    /// Authenticates the user using the provided access token and returns the resulting token information.
    /// </summary>
    /// <param name="token">The access token used to perform the login.</param>
    /// <returns>A task that represents the asynchronous login operation, containing the token result.</returns>
+    /// <!-- aidoc:v1 sig=485f1d7 -->
    Task<TokenResult> LoginWithGivenAccessToken(string token);
 }