chore: Custom Roles to manage permissions [ UI ] (#9865)

In admin settings, this Pr will add the UI for managing custom roles (
ref: https://github.com/chatwoot/chatwoot/pull/9995 ). It also handles
the routing logic changes to accommodate fine-tuned permissions.

---------

Co-authored-by: Pranav <pranavrajs@gmail.com>
Co-authored-by: Sivin Varghese <64252451+iamsivin@users.noreply.github.com>
Co-authored-by: iamsivin <iamsivin@gmail.com>
Co-authored-by: Muhsin Keloth <muhsinkeramam@gmail.com>

app/javascript/dashboard/helper/permissionsHelper.js

@@ -41,3 +41,32 @@ export const buildPermissionsFromRouter = (routes = []) =>
 
     return acc;
   }, {});
+
+/**
+ * Filters and transforms items based on user permissions.
+ *
+ * @param {Object} items - An object containing items to be filtered.
+ * @param {Array} userPermissions - Array of permissions the user has.
+ * @param {Function} getPermissions - Function to extract required permissions from an item.
+ * @param {Function} [transformItem] - Optional function to transform each item after filtering.
+ * @returns {Array} Filtered and transformed items.
+ */
+export const filterItemsByPermission = (
+  items,
+  userPermissions,
+  getPermissions,
+  transformItem = (key, item) => ({ key, ...item })
+) => {
+  // Helper function to check if an item has the required permissions
+  const hasRequiredPermissions = item => {
+    const requiredPermissions = getPermissions(item);
+    return (
+      requiredPermissions.length === 0 ||
+      hasPermissions(requiredPermissions, userPermissions)
+    );
+  };
+
+  return Object.entries(items)
+    .filter(([, item]) => hasRequiredPermissions(item)) // Keep only items with required permissions
+    .map(([key, item]) => transformItem(key, item)); // Transform each remaining item
+};