chore: Add OpenAPI Support to e2e.fetchMyKeys API (#36779)

Co-authored-by: Matheus Cardoso <matheus@cardo.so>

Author: ahmed-n-abdeltwab

.changeset/short-starfishes-provide.md

@@ -0,0 +1,6 @@
+---
+"@rocket.chat/meteor": minor
+"@rocket.chat/rest-typings": minor
+---
+
+Add OpenAPI support for the Rocket.Chat e2e.fetchMyKeys endpoints by migrating to a modern chained route definition syntax and utilizing shared AJV schemas for validation to enhance API documentation and ensure type safety through response validation.

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

@@ -96,6 +96,31 @@ const e2eEndpoints = API.v1
 			return API.v1.success();
 		},
 	)
+	.get(
+		'e2e.fetchMyKeys',
+		{
+			authRequired: true,
+			query: undefined,
+			response: {
+				400: validateBadRequestErrorResponse,
+				401: validateUnauthorizedErrorResponse,
+				200: ajv.compile<{ public_key?: string; private_key?: string }>({
+					type: 'object',
+					properties: {
+						public_key: { type: 'string' },
+						private_key: { type: 'string' },
+						success: { type: 'boolean', enum: [true] },
+					},
+					required: ['success'],
+				}),
+			},
+		},
+		async function action() {
+			const result = await Users.fetchKeysByUserId(this.userId);
+
+			return API.v1.success(result);
+		},
+	)
 	.get(
 		'e2e.getUsersOfRoomWithoutKey',
 		{
@@ -142,20 +167,6 @@ const e2eEndpoints = API.v1
 		},
 	);
 
-API.v1.addRoute(
-	'e2e.fetchMyKeys',
-	{
-		authRequired: true,
-	},
-	{
-		async get() {
-			const result = await Users.fetchKeysByUserId(this.userId);
-
-			return API.v1.success(result);
-		},
-	},
-);
-
 /**
  * @openapi
  *  /api/v1/e2e.setUserPublicAndPrivateKeys:

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

@@ -158,9 +158,6 @@ export type E2eEndpoints = {
 	'/v1/e2e.rejectSuggestedGroupKey': {
 		POST: (params: E2eGetUsersOfRoomWithoutKeyProps) => void;
 	};
-	'/v1/e2e.fetchMyKeys': {
-		GET: () => { public_key: string; private_key: string };
-	};
 	'/v1/e2e.fetchUsersWaitingForGroupKey': {
 		GET: (params: E2EFetchUsersWaitingForGroupKeyProps) => {
 			usersWaitingForE2EKeys: Record<IRoom['_id'], { _id: IUser['_id']; public_key: string }[]>;