refactor: Permissions out of DB Watcher

[ricardogarim]

As per the updates mentioned in PROJ-7 SCA-4 and ADR #74, this pull request focuses on relocating Permissions entity out of DB Watcher service.

Quick context to public readers

In essence, this modification empowers RocketChat's app to directly call listeners through the api.broadcast global function, eliminating the reliance on MongoDB Change Stream data propagation

Why is this beneficial? It provides better control over notifying users by enabling more precise use-case management. Unlike Change Streams, which notify every action on Mongo's documents and sometimes might result in unnecessary duplicate notifications. Moreover, it contributes to the future removal of the DB Watcher deployment, thereby optimizing resource utilization.

Proposed changes

Key changes include:

• Conditionally incorporating Permissions entity import within DB watchers on application startup based on the dbWatchersDisabled flag.
• Enabling support for the following use cases to directly trigger permission.changed listener event, subject to the dbWatchersDisabled flag.

Updated use cases.

Use Case	Route/Trigger	Notes
removeRole	Method authorization:removeRoleFromPermission
setRoles	Route POST permissions.update
addRole	Method authorization:addPermissionToRole

Steps to test or reproduce

1. Start RocketChat's application with the DISABLE_DB_WATCHERS flag set to true.
2. Perform a POST request to above given endpoints available on updated use cases.
3. Observe websocket received events. Related events should be of eventName: permissions-changed, containing all changed fields as well as the updated permission identification data.

Further comments

To maintain consistency and avoid potential regressions, event names and signatures have been kept unchanged on both the client and app sides. This decision streamlines efforts and mitigates the risk of unintended consequences.

Startup and feature activation events were not refactored to call listener event.

• apps/meteor/ee/server/lib/deviceManagement/startup.ts
• apps/meteor/ee/server/lib/audit/startup.ts
• apps/meteor/ee/app/livechat-enterprise/server/permissions.ts
• apps/meteor/ee/app/canned-responses/server/permissions.ts
• apps/meteor/app/discussion/server/permissions.ts
• apps/meteor/app/autotranslate/server/permissions.ts
• app/authorization/server/functions/upsertPermissions.ts

Permissions model WBS. Used to guide changes discovery.

🔄 Work in progress
✅ Done
➖ Not applicable

Function	Status
createOrUpdate	✅
create	✅
addRole	✅
setRoles	✅
removeRole	✅
findByLevel	➖

[changeset-bot]

⚠️ No Changeset found

Latest commit: 50dd03f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[dionisio-bot]

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

[codecov]

Codecov Report

Attention: Patch coverage is 3.03030% with 32 lines in your changes are missing coverage. Please review.

Project coverage is 55.60%. Comparing base (18cae03) to head (50dd03f).

Additional details and impacted files

@@             Coverage Diff             @@
##           develop   #32360      +/-   ##
===========================================
- Coverage    55.62%   55.60%   -0.02%     
===========================================
  Files         2408     2408              
  Lines        52965    52997      +32     
  Branches     10884    10894      +10     
===========================================
+ Hits         29462    29470       +8     
- Misses       20888    20918      +30     
+ Partials      2615     2609       -6     

Flag	Coverage Δ
e2e	55.08% <ø> (+0.03%)	⬆️
unit	73.03% <3.03%> (-0.24%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

[sampaiodiego]

it needs to get conflicts solved as well

[ricardogarim]

Additionally, I've used this PR to relocate Role related functions to the same notifyListener.ts file as its peers entities. No rules were changed; only function naming and file names were adjusted.

cc @sampaiodiego