feat: implement premium user role

- Added premium user role
- Defined premium permissions
- Added premium limits

Author: fulleni

lib/src/rbac/role_permissions.dart

@@ -21,6 +21,12 @@ final Set<String> _standardUserPermissions = {
   Permissions.userDeleteOwned,
 };
 
+// For now, premium users have the same permissions as standard users,
+// but this set can be expanded later for premium-specific features.
+final Set<String> _premiumUserPermissions = {
+  ..._standardUserPermissions,
+};
+
 final Set<String> _adminPermissions = {
   ..._standardUserPermissions,
   Permissions.headlineCreate,
@@ -54,5 +60,6 @@ final Set<String> _adminPermissions = {
 final Map<UserRole, Set<String>> rolePermissions = {
   UserRole.guestUser: _guestUserPermissions,
   UserRole.standardUser: _standardUserPermissions,
+  UserRole.premiumUser: _premiumUserPermissions, // Added premium user
   UserRole.admin: _adminPermissions,
 };

lib/src/services/default_user_preference_limit_service.dart

@@ -46,16 +46,15 @@ class DefaultUserPreferenceLimitService implements UserPreferenceLimitService {
             // Applies to countries, sources, categories
             limit = limits.authenticatedFollowedItemsLimit;
           }
+        case UserRole.premiumUser:
+          if (itemType == 'headline') {
+            limit = limits.premiumSavedHeadlinesLimit;
+          } else {
+            limit = limits.premiumFollowedItemsLimit;
+          }
         case UserRole.admin:
           // Admins have no limits
           return;
-        // Add premium user case when implemented
-        // case UserRole.premiumUser:
-        //   if (itemType == 'headline') {
-        //     limit = limits.premiumSavedHeadlinesLimit;
-        //   } else {
-        //     limit = limits.premiumFollowedItemsLimit;
-        //   }
       }
 
       // 3. Check if adding the item would exceed the limit
@@ -100,13 +99,12 @@ class DefaultUserPreferenceLimitService implements UserPreferenceLimitService {
         case UserRole.standardUser:
           followedItemsLimit = limits.authenticatedFollowedItemsLimit;
           savedHeadlinesLimit = limits.authenticatedSavedHeadlinesLimit;
+        case UserRole.premiumUser:
+          followedItemsLimit = limits.premiumFollowedItemsLimit;
+          savedHeadlinesLimit = limits.premiumSavedHeadlinesLimit;
         case UserRole.admin:
           // Admins have no limits
           return;
-        // Add premium user case when implemented
-        // case UserRole.premiumUser:
-        //   followedItemsLimit = limits.premiumFollowedItemsLimit;
-        //   savedHeadlinesLimit = limits.premiumSavedHeadlinesLimit;
       }
 
       // 3. Check if proposed preferences exceed limits

lib/src/services/jwt_auth_token_service.dart

@@ -14,6 +14,7 @@ String _userRoleToString(UserRole role) {
     UserRole.admin => 'admin',
     UserRole.standardUser => 'standard_user',
     UserRole.guestUser => 'guest_user',
+    UserRole.premiumUser => 'premium_user', // Added premium user
   };
 }