🔧 refactor: Permission handling for Resource Sharing (#11283)

* 🔧 refactor: permission handling for public sharing

- Updated permission keys from SHARED_GLOBAL to SHARE across various files for consistency.
- Added public access configuration in librechat.example.yaml.
- Adjusted related tests and components to reflect the new permission structure.

* chore: Update default SHARE permission to false

* fix: Update SHARE permissions in tests and implementation

- Added SHARE permission handling for user and admin roles in permissions.spec.ts and permissions.ts.
- Updated expected permissions in tests to reflect new SHARE permission values for various permission types.

* fix: Handle undefined values in PeoplePickerAdminSettings component

- Updated the checked and value props of the Switch component to handle undefined values gracefully by defaulting to false. This ensures consistent behavior when the field value is not set.

* feat: Add CREATE permission handling for prompts and agents

- Introduced CREATE permission for user and admin roles in permissions.spec.ts and permissions.ts.
- Updated expected permissions in tests to include CREATE permission for various permission types.

* 🔧 refactor: Enhance permission handling for sharing dialog usability

* refactor: public sharing permissions for resources

- Added middleware to check SHARE_PUBLIC permissions for agents, prompts, and MCP servers.
- Updated interface configuration in librechat.example.yaml to include public sharing options.
- Enhanced components and hooks to support public sharing functionality.
- Adjusted tests to validate new permission handling for public sharing across various resource types.

* refactor: update Share2Icon styling in GenericGrantAccessDialog

* refactor: update Share2Icon size in GenericGrantAccessDialog for consistency

* refactor: improve layout and styling of Share2Icon in GenericGrantAccessDialog

* refactor: update Share2Icon size in GenericGrantAccessDialog for improved consistency

* chore: remove redundant public sharing option from People Picker

* refactor: add SHARE_PUBLIC permission handling in updateInterfacePermissions tests

packages/api/src/middleware/access.spec.ts

@@ -209,7 +209,7 @@ describe('access middleware', () => {
         permissions: {
           [PermissionTypes.AGENTS]: {
             [Permissions.USE]: true,
-            [Permissions.SHARED_GLOBAL]: false,
+            [Permissions.SHARE]: false,
           },
         },
       } as unknown as IRole;
@@ -223,9 +223,9 @@ describe('access middleware', () => {
 
       const result = await checkAccess({
         ...defaultParams,
-        permissions: [Permissions.USE, Permissions.SHARED_GLOBAL],
+        permissions: [Permissions.USE, Permissions.SHARE],
         bodyProps: {
-          [Permissions.SHARED_GLOBAL]: ['projectIds', 'removeProjectIds'],
+          [Permissions.SHARE]: ['projectIds', 'removeProjectIds'],
         } as Record<Permissions, string[]>,
         checkObject,
       });
@@ -237,7 +237,7 @@ describe('access middleware', () => {
         name: 'user',
         permissions: {
           [PermissionTypes.AGENTS]: {
-            [Permissions.SHARED_GLOBAL]: false,
+            [Permissions.SHARE]: false,
           },
         },
       } as unknown as IRole;
@@ -251,9 +251,9 @@ describe('access middleware', () => {
 
       const result = await checkAccess({
         ...defaultParams,
-        permissions: [Permissions.SHARED_GLOBAL],
+        permissions: [Permissions.SHARE],
         bodyProps: {
-          [Permissions.SHARED_GLOBAL]: ['projectIds', 'removeProjectIds'],
+          [Permissions.SHARE]: ['projectIds', 'removeProjectIds'],
         } as Record<Permissions, string[]>,
         checkObject,
       });
@@ -337,7 +337,7 @@ describe('access middleware', () => {
           [PermissionTypes.AGENTS]: {
             [Permissions.USE]: true,
             [Permissions.CREATE]: true,
-            [Permissions.SHARED_GLOBAL]: false,
+            [Permissions.SHARE]: false,
           },
         },
       } as unknown as IRole;
@@ -350,9 +350,9 @@ describe('access middleware', () => {
 
       const middleware = generateCheckAccess({
         permissionType: PermissionTypes.AGENTS,
-        permissions: [Permissions.USE, Permissions.CREATE, Permissions.SHARED_GLOBAL],
+        permissions: [Permissions.USE, Permissions.CREATE, Permissions.SHARE],
         bodyProps: {
-          [Permissions.SHARED_GLOBAL]: ['projectIds', 'removeProjectIds'],
+          [Permissions.SHARE]: ['projectIds', 'removeProjectIds'],
         } as Record<Permissions, string[]>,
         getRoleByName: mockGetRoleByName,
       });
@@ -490,7 +490,7 @@ describe('access middleware', () => {
           [PermissionTypes.PROMPTS]: {
             [Permissions.USE]: true,
             [Permissions.CREATE]: true,
-            [Permissions.SHARED_GLOBAL]: false,
+            [Permissions.SHARE]: false,
           },
         },
       } as unknown as IRole;