feat: add pending status to the endpoint

apps/meteor/app/api/server/v1/users.ts

@@ -592,6 +592,31 @@ API.v1.addRoute(
 				actualSort.nameInsensitive = sort.name;
 			}
 
+			let match;
+
+			switch (status) {
+				case 'active':
+					match = {
+						active: true,
+						lastLogin: { $exists: true },
+					};
+					break;
+				case 'inactive':
+					match = {
+						active: false,
+						lastLogin: { $exists: true },
+					};
+					break;
+				case 'pending':
+					match = {
+						lastLogin: { $exists: false },
+						type: { $ne: 'bot' },
+					};
+					break;
+				default:
+					throw new Meteor.Error('error-invalid-status', 'Invalid status parameter');
+			}
+
 			const limit =
 				count !== 0
 					? [
@@ -605,8 +630,8 @@ API.v1.addRoute(
 				.aggregate<{ sortedResults: IUser[]; totalCount: { total: number }[] }>([
 					{
 						$match: {
-							active: status === 'active',
 							roles: role,
+							...match,
 						},
 					},
 					{

packages/rest-typings/src/v1/users.ts

@@ -18,6 +18,7 @@ import type { UserRegisterParamsPOST } from './users/UserRegisterParamsPOST';
 import type { UserSetActiveStatusParamsPOST } from './users/UserSetActiveStatusParamsPOST';
 import type { UsersAutocompleteParamsGET } from './users/UsersAutocompleteParamsGET';
 import type { UsersInfoParamsGet } from './users/UsersInfoParamsGet';
+import type { UsersListStatusParamsGET } from './users/UsersListStatusParamsGET';
 import type { UsersListTeamsParamsGET } from './users/UsersListTeamsParamsGET';
 import type { UsersSendConfirmationEmailParamsPOST } from './users/UsersSendConfirmationEmailParamsPOST';
 import type { UsersSetPreferencesParamsPOST } from './users/UsersSetPreferenceParamsPOST';
@@ -152,7 +153,7 @@ export type UsersEndpoints = {
 	};
 
 	'/v1/users.list/:status': {
-		GET: (params: PaginatedRequest<{ fields: string }>) => PaginatedResult<{
+		GET: (params: UsersListStatusParamsGET) => PaginatedResult<{
 			users: Pick<IUser, '_id' | 'username' | 'name' | 'status' | 'roles' | 'emails' | 'active' | 'avatarETag'>[];
 		}>;
 	};

packages/rest-typings/src/v1/users/UsersListStatusParamsGET.ts

@@ -0,0 +1,22 @@
+import Ajv from 'ajv';
+
+import type { PaginatedRequest } from '../../helpers/PaginatedRequest';
+
+const ajv = new Ajv({
+	coerceTypes: true,
+});
+
+export type UsersListStatusParamsGET = { role: string } & PaginatedRequest<{ fields: string }>;
+
+const UsersListStatusParamsGetSchema = {
+	type: 'object',
+	properties: {
+		role: {
+			type: 'string',
+		},
+	},
+	required: ['role'],
+	additionalProperties: false,
+};
+
+export const isUsersListStatusProps = ajv.compile<UsersListStatusParamsGET>(UsersListStatusParamsGetSchema);