feat: integrate guest role (AppFlowy-IO#7967)

* fix: turn off share apis when fg is off

* chore: bump client-api version

* fix: use workspace id in turn into member api

* feat: hide the invite textfield when user role is guest

* fix: improve error handling for invitation failures in share tab

* fix: handle sharing disabled state in share tab

* chore: bump version

* feat: replace sidebar menu with AFMenu

* chore: add error code

* feat: shared with me

* fix: app scale issue

* chore: udpate error message

* feat: support more access levels

* chore: delegate the view item events

* feat: inject the callbacks into shared page list

* fix: flutter analyze

* feat: support rename / change icon in shared folder

* feat: added shared page actions button

* fix: tests

* chore: update version

Author: LucasXu0

frontend/appflowy_flutter/integration_test/desktop/uncategorized/zoom_in_out_test.dart

@@ -56,6 +56,9 @@ void main() {
           await tester.pumpAndSettle();
 
           currentScaleFactor += 0.1;
+          currentScaleFactor = double.parse(
+            currentScaleFactor.toStringAsFixed(2),
+          );
 
           final scaleFactor = await windowSizeManager.getScaleFactor();
           expect(currentScaleFactor, appflowyScaleFactor);

frontend/appflowy_flutter/lib/features/share_tab/data/repositories/local_share_with_user_repository.dart

@@ -145,7 +145,7 @@ class LocalShareWithUserRepository extends ShareWithUserRepository {
 
   @override
   Future<FlowyResult<void, FlowyError>> changeRole({
-    required String pageId,
+    required String workspaceId,
     required String email,
     required ShareRole role,
   }) async {

frontend/appflowy_flutter/lib/features/share_tab/data/repositories/rust_share_with_user_repository.dart

@@ -23,7 +23,7 @@ class RustShareWithUserRepository extends ShareWithUserRepository {
 
     return result.fold(
       (success) {
-        Log.info('get shared users: $success');
+        Log.debug('get shared users: $success');
 
         return FlowySuccess(success.sharedUsers);
       },
@@ -93,30 +93,31 @@ class RustShareWithUserRepository extends ShareWithUserRepository {
   Future<FlowyResult<SharedUsers, FlowyError>> getAvailableSharedUsers({
     required String pageId,
   }) async {
-    // TODO: Implement this
     return FlowySuccess([]);
   }
 
   @override
   Future<FlowyResult<void, FlowyError>> changeRole({
-    required String pageId,
+    required String workspaceId,
     required String email,
     required ShareRole role,
   }) async {
     final request = UpdateWorkspaceMemberPB(
-      workspaceId: pageId,
+      workspaceId: workspaceId,
       email: email,
       role: role.userRole,
     );
     final result = await UserEventUpdateWorkspaceMember(request).send();
     return result.fold(
       (success) {
-        Log.info('change role($role) for user($email) in page($pageId)');
+        Log.info(
+          'change role($role) for user($email) in workspaceId($workspaceId)',
+        );
         return FlowySuccess(success);
       },
       (failure) {
         Log.error(
-          'failed to change role($role) for user($email) in page($pageId)',
+          'failed to change role($role) for user($email) in workspaceId($workspaceId)',
           failure,
         );
         return FlowyFailure(failure);

frontend/appflowy_flutter/lib/features/share_tab/data/repositories/share_with_user_repository.dart

@@ -34,7 +34,7 @@ abstract class ShareWithUserRepository {
 
   /// Change the role of a user in a shared page.
   Future<FlowyResult<void, FlowyError>> changeRole({
-    required String pageId,
+    required String workspaceId,
     required String email,
     required ShareRole role,
   });

frontend/appflowy_flutter/lib/features/share_tab/logic/share_with_user_bloc.dart

@@ -2,6 +2,7 @@ import 'package:appflowy/features/share_tab/data/models/models.dart';
 import 'package:appflowy/features/share_tab/data/repositories/share_with_user_repository.dart';
 import 'package:appflowy/plugins/document/presentation/editor_plugins/copy_and_paste/clipboard_service.dart';
 import 'package:appflowy/plugins/shared/share/constants.dart';
+import 'package:appflowy/shared/feature_flags.dart';
 import 'package:appflowy/startup/startup.dart';
 import 'package:appflowy/user/application/user_service.dart';
 import 'package:appflowy_backend/protobuf/flowy-error/errors.pb.dart';
@@ -37,6 +38,17 @@ class ShareWithUserBloc extends Bloc<ShareWithUserEvent, ShareWithUserState> {
     Initial event,
     Emitter<ShareWithUserState> emit,
   ) async {
+    if (!FeatureFlag.sharedSection.isOn) {
+      emit(
+        state.copyWith(
+          errorMessage: 'Sharing is currently disabled.',
+          users: [],
+          isLoading: false,
+        ),
+      );
+      return;
+    }
+
     final result = await UserBackendService.getCurrentUserProfile();
     final currentUser = result.fold(
       (user) => user,
@@ -63,6 +75,10 @@ class ShareWithUserBloc extends Bloc<ShareWithUserEvent, ShareWithUserState> {
     GetSharedUsers event,
     Emitter<ShareWithUserState> emit,
   ) async {
+    if (!FeatureFlag.sharedSection.isOn) {
+      return;
+    }
+
     emit(
       state.copyWith(
         errorMessage: '',
@@ -288,7 +304,7 @@ class ShareWithUserBloc extends Bloc<ShareWithUserEvent, ShareWithUserState> {
     );
 
     final result = await repository.changeRole(
-      pageId: pageId,
+      workspaceId: workspaceId,
       email: event.email,
       role: ShareRole.member,
     );

frontend/appflowy_flutter/lib/features/share_tab/presentation/share_tab.dart

@@ -1,10 +1,12 @@
-import 'package:appflowy/features/share_tab/data/models/share_access_level.dart';
+import 'package:appflowy/features/share_tab/data/models/models.dart';
 import 'package:appflowy/features/share_tab/logic/share_with_user_bloc.dart';
 import 'package:appflowy/features/share_tab/presentation/widgets/copy_link_widget.dart';
 import 'package:appflowy/features/share_tab/presentation/widgets/people_with_access_section.dart';
 import 'package:appflowy/features/share_tab/presentation/widgets/share_with_user_widget.dart';
 import 'package:appflowy/workspace/presentation/widgets/dialogs.dart';
+import 'package:appflowy_backend/protobuf/flowy-error/code.pbenum.dart';
 import 'package:appflowy_ui/appflowy_ui.dart';
+import 'package:collection/collection.dart';
 import 'package:flowy_infra_ui/flowy_infra_ui.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
@@ -46,20 +48,29 @@ class _ShareTabState extends State<ShareTab> {
           return const SizedBox.shrink();
         }
 
+        final currentUserRole = state.users
+            .firstWhereOrNull(
+              (user) => user.email == state.currentUser?.email,
+            )
+            ?.role;
+
         return Column(
           crossAxisAlignment: CrossAxisAlignment.start,
           mainAxisSize: MainAxisSize.min,
           children: [
             // share page with user by email
-            VSpace(theme.spacing.l),
-            ShareWithUserWidget(
-              controller: controller,
-              onInvite: (emails) => _onSharePageWithUser(
-                context,
-                emails: emails,
-                accessLevel: ShareAccessLevel.readOnly,
+            // hide this when the user is guest
+            if (currentUserRole != ShareRole.guest) ...[
+              VSpace(theme.spacing.l),
+              ShareWithUserWidget(
+                controller: controller,
+                onInvite: (emails) => _onSharePageWithUser(
+                  context,
+                  emails: emails,
+                  accessLevel: ShareAccessLevel.readOnly,
+                ),
               ),
-            ),
+            ],
 
             // shared users
 
@@ -104,7 +115,12 @@ class _ShareTabState extends State<ShareTab> {
   ) {
     return PeopleWithAccessSectionCallbacks(
       onSelectAccessLevel: (user, accessLevel) {
-        // do nothing. the event doesn't support in the backend yet
+        context.read<ShareWithUserBloc>().add(
+              ShareWithUserEvent.updateAccessLevel(
+                email: user.email,
+                accessLevel: accessLevel,
+              ),
+            );
       },
       onTurnIntoMember: (user) {
         context.read<ShareWithUserBloc>().add(
@@ -133,9 +149,22 @@ class _ShareTabState extends State<ShareTab> {
           message: 'Invitation sent',
         );
       }, (error) {
-        // TODO: handle the limiation error
+        String message;
+        switch (error.code) {
+          case ErrorCode.InvalidGuest:
+            message = 'The email is already in the list';
+            break;
+          case ErrorCode.FreePlanGuestLimitExceeded:
+            message = 'Please upgrade to a Pro plan to invite more guests';
+            break;
+          case ErrorCode.PaidPlanGuestLimitExceeded:
+            message = 'You have reached the maximum number of guests';
+            break;
+          default:
+            message = error.msg;
+        }
         showToastNotification(
-          message: error.msg,
+          message: message,
           type: ToastificationType.error,
         );
       });

frontend/appflowy_flutter/lib/features/share_tab/presentation/widgets/access_level_list_widget.dart

@@ -50,51 +50,34 @@ class AccessLevelListCallbacks {
 class AccessLevelListWidget extends StatelessWidget {
   const AccessLevelListWidget({
     super.key,
-    this.enableAccessLevelSelection = false,
     required this.selectedAccessLevel,
     required this.callbacks,
+    required this.supportedAccessLevels,
   });
 
-  /// Enable access level selection
-  final bool enableAccessLevelSelection;
-
   /// The currently selected access level
   final ShareAccessLevel selectedAccessLevel;
 
   /// Callbacks
   final AccessLevelListCallbacks callbacks;
 
+  /// Supported access levels
+  final List<ShareAccessLevel> supportedAccessLevels;
+
   @override
   Widget build(BuildContext context) {
     final theme = AppFlowyTheme.of(context);
     return AFMenu(
-      width: enableAccessLevelSelection ? 240 : 160,
+      width: supportedAccessLevels.isNotEmpty ? 240 : 160,
       children: [
         // Display all available access level options
-        if (enableAccessLevelSelection) ...[
-          _buildAccessLevelItem(
-            context,
-            accessLevel: ShareAccessLevel.fullAccess,
-            onTap: () =>
-                callbacks.onSelectAccessLevel(ShareAccessLevel.fullAccess),
-          ),
-          _buildAccessLevelItem(
-            context,
-            accessLevel: ShareAccessLevel.readAndWrite,
-            onTap: () =>
-                callbacks.onSelectAccessLevel(ShareAccessLevel.readAndWrite),
-          ),
-          _buildAccessLevelItem(
-            context,
-            accessLevel: ShareAccessLevel.readAndComment,
-            onTap: () =>
-                callbacks.onSelectAccessLevel(ShareAccessLevel.readAndComment),
-          ),
-          _buildAccessLevelItem(
-            context,
-            accessLevel: ShareAccessLevel.readOnly,
-            onTap: () =>
-                callbacks.onSelectAccessLevel(ShareAccessLevel.readOnly),
+        if (supportedAccessLevels.isNotEmpty) ...[
+          ...supportedAccessLevels.map(
+            (accessLevel) => _buildAccessLevelItem(
+              context,
+              accessLevel: accessLevel,
+              onTap: () => callbacks.onSelectAccessLevel(accessLevel),
+            ),
           ),
           AFDivider(spacing: theme.spacing.m),
         ],

frontend/appflowy_flutter/lib/features/share_tab/presentation/widgets/edit_access_level_widget.dart

@@ -10,6 +10,7 @@ class EditAccessLevelWidget extends StatefulWidget {
     super.key,
     required this.callbacks,
     required this.selectedAccessLevel,
+    required this.supportedAccessLevels,
     this.disabled = false,
   });
 
@@ -22,6 +23,9 @@ class EditAccessLevelWidget extends StatefulWidget {
   /// Whether the widget is disabled
   final bool disabled;
 
+  /// Supported access levels
+  final List<ShareAccessLevel> supportedAccessLevels;
+
   @override
   State<EditAccessLevelWidget> createState() => _EditAccessLevelWidgetState();
 }
@@ -47,6 +51,7 @@ class _EditAccessLevelWidgetState extends State<EditAccessLevelWidget> {
       popover: (_) {
         return AccessLevelListWidget(
           selectedAccessLevel: widget.selectedAccessLevel,
+          supportedAccessLevels: widget.supportedAccessLevels,
           callbacks: widget.callbacks.copyWith(
             onSelectAccessLevel: (accessLevel) {
               widget.callbacks.onSelectAccessLevel(accessLevel);

frontend/appflowy_flutter/lib/features/share_tab/presentation/widgets/shared_group_widget.dart

@@ -74,6 +74,7 @@ class SharedGroupWidget extends StatelessWidget {
   Widget _buildTrailing(BuildContext context) {
     return EditAccessLevelWidget(
       disabled: true,
+      supportedAccessLevels: ShareAccessLevel.values,
       selectedAccessLevel: ShareAccessLevel.fullAccess,
       callbacks: AccessLevelListCallbacks.none(),
     );

frontend/appflowy_flutter/lib/features/share_tab/presentation/widgets/shared_user_widget.dart

@@ -96,8 +96,22 @@ class SharedUserWidget extends StatelessWidget {
   ) {
     final isCurrentUser = user.email == currentUser.email;
     final theme = AppFlowyTheme.of(context);
+    // Guest: read and write, read only
+    // Member: full access <- only have full access until the backend supports more access levels
+    // Owner: all access levels
+    final supportedAccessLevels = switch (user.role) {
+      ShareRole.guest => [
+          ShareAccessLevel.readAndWrite,
+          ShareAccessLevel.readOnly,
+        ],
+      ShareRole.member => [ShareAccessLevel.fullAccess],
+      ShareRole.owner => [ShareAccessLevel.fullAccess],
+    };
     // The current guest user can't edit the access level of the other user
-    return isCurrentUser || currentUser.role == ShareRole.guest
+    return isCurrentUser ||
+            currentUser.role == ShareRole.guest ||
+            user.role == ShareRole.member ||
+            user.role == ShareRole.owner
         ? AFGhostTextButton.disabled(
             text: user.accessLevel.i18n,
             textStyle: theme.textStyle.body.standard(
@@ -106,6 +120,7 @@ class SharedUserWidget extends StatelessWidget {
           )
         : EditAccessLevelWidget(
             selectedAccessLevel: user.accessLevel,
+            supportedAccessLevels: supportedAccessLevels,
             callbacks: callbacks ?? AccessLevelListCallbacks.none(),
           );
   }