feat: Add OpenAPI Support to oauth-apps.list API

[ahmed-n-abdeltwab]

https://rocketchat.atlassian.net/browse/ARCH-1730
Description:
This PR integrates OpenAPI support into the Rocket.Chat API, migrate of Rocket.Chat API endpoints to the new OpenAPI pattern. The update includes improved API documentation, enhanced type safety, and response validation using AJV.

Key Changes:

• Implemented the new pattern and added AJV-based JSON schema validation for API.
• Uses the ExtractRoutesFromAPI utility from the TypeScript definitions to dynamically derive the routes from the endpoint specifications.
• Enabled Swagger UI integration for this API.
• This does not introduce any breaking changes to the endpoint logic.

Issue Reference:
Relates to #34983, part of the ongoing OpenAPI integration effort.

Testing:

• Verified that the API response schemas are correctly documented in Swagger UI.

• All tests passed without any breaking changes

  $ yarn testapi -f '[OAuthApps]'        
  
  
  [OAuthApps]
    [/oauth-apps.list]
      ✔ should return an error when the user does not have the necessary permission (205ms)
      ✔ should return an array of oauth apps (183ms)
    [/oauth-apps.create]
      ✔ should return an error when the user does not have the necessary permission (382ms)
      ✔ should return an error when the 'name' property is invalid (115ms)
      ✔ should return an error when the 'redirectUri' property is invalid
      ✔ should return an error when the 'active' property is not a boolean
      ✔ should create an oauthApp (151ms)
    [/oauth-apps.get]
      ✔ should return a single oauthApp by client id
      ✔ should return a single oauthApp by _id
      ✔ should return a single oauthApp by appId (deprecated)
      ✔ should return only non sensitive information if user does not have the permission to manage oauth apps when searching by clientId (194ms)
      ✔ should return only non sensitive information if user does not have the permission to manage oauth apps when searching by _id (185ms)
      ✔ should return only non sensitive information if user does not have the permission to manage oauth apps when searching by appId (deprecated) (188ms)
      ✔ should fail returning an oauth app when an invalid id is provided (avoid NoSQL injections)
      ✔ should fail returning an oauth app when an invalid id string is provided (avoid NoSQL injections)
      ✔ should fail returning an oauth app when an invalid clientId is provided (avoid NoSQL injections)
      ✔ should fail returning an oauth app when an invalid clientId string is provided (avoid NoSQL injections)
      ✔ should fail returning an oauth app when an invalid appId is provided (avoid NoSQL injections; deprecated)
      ✔ should fail returning an oauth app when an invalid appId string is provided (avoid NoSQL injections; deprecated)
    [/oauth-apps.update]
      ✔ should update an app's name, its Active and Redirect URI fields correctly by its id
      ✔ should fail updating an app if user does NOT have the manage-oauth-apps permission (243ms)
    [/oauth-apps.delete]
      ✔ should delete an app by its id
      ✔ should fail deleting an app by its id if user does NOT have the manage-oauth-apps permission (176ms)
  
  
  23 passing (4s)

Endpoints:

• Get List of OAuth Apps

  

Looking forward to your feedback! 🚀

[changeset-bot]

🦋 Changeset detected

Latest commit: 288a340

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 39 packages

Name	Type
@rocket.chat/meteor	Patch
@rocket.chat/rest-typings	Patch
@rocket.chat/api-client	Patch
@rocket.chat/core-services	Patch
@rocket.chat/ddp-client	Patch
@rocket.chat/http-router	Patch
@rocket.chat/models	Patch
@rocket.chat/ui-contexts	Patch
@rocket.chat/web-ui-registration	Patch
@rocket.chat/account-service	Patch
@rocket.chat/authorization-service	Patch
@rocket.chat/ddp-streamer	Patch
@rocket.chat/stream-hub-service	Patch
@rocket.chat/omnichannel-services	Patch
@rocket.chat/presence	Patch
rocketchat-services	Patch
@rocket.chat/omnichannel-transcript	Patch
@rocket.chat/presence-service	Patch
@rocket.chat/queue-worker	Patch
@rocket.chat/network-broker	Patch
@rocket.chat/livechat	Patch
@rocket.chat/mock-providers	Patch
@rocket.chat/cron	Patch
@rocket.chat/instance-status	Patch
@rocket.chat/omni-core	Patch
@rocket.chat/omni-core-ee	Patch
@rocket.chat/uikit-playground	Patch
@rocket.chat/fuselage-ui-kit	Patch
@rocket.chat/gazzodown	Patch
@rocket.chat/ui-avatar	Patch
@rocket.chat/ui-client	Patch
@rocket.chat/ui-video-conf	Patch
@rocket.chat/ui-voip	Patch
@rocket.chat/core-typings	Patch
@rocket.chat/apps	Patch
@rocket.chat/freeswitch	Patch
@rocket.chat/model-typings	Patch
@rocket.chat/license	Patch
@rocket.chat/pdf-worker	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[dionisio-bot]

Looks like this PR is ready to merge! 🎉
If you have any trouble, please check the PR guidelines

[cardoso]

With #36574 merged, you should update the error schemas accordingly.

[ahmed-n-abdeltwab]

With #36574 merged, you should update the error schemas accordingly.

done