feat(cat-voices): opening proposal editor via links (#2551)

* feat: proposal editor links handle

* feat: adding proposalRef into tryCatch bloc

* feat: change name from action to unlock

* fix: format

Author: LynxLynxx

catalyst_voices/apps/voices/lib/pages/proposal_builder/proposal_builder_page.dart

@@ -18,6 +18,7 @@ import 'package:catalyst_voices/widgets/modals/comment/submit_comment_error_dial
 import 'package:catalyst_voices/widgets/modals/proposals/proposal_limit_reached_dialog.dart';
 import 'package:catalyst_voices/widgets/modals/proposals/publish_proposal_error_dialog.dart';
 import 'package:catalyst_voices/widgets/modals/proposals/submit_proposal_error_dialog.dart';
+import 'package:catalyst_voices/widgets/modals/proposals/unlock_edit_proposal.dart';
 import 'package:catalyst_voices/widgets/snackbar/voices_snackbar.dart';
 import 'package:catalyst_voices/widgets/snackbar/voices_snackbar_action.dart';
 import 'package:catalyst_voices/widgets/snackbar/voices_snackbar_type.dart';
@@ -164,6 +165,8 @@ class _ProposalBuilderPageState extends State<ProposalBuilderPage>
         unawaited(_showEmailNotVerifiedDialog());
       case MaxProposalsLimitReachedSignal():
         unawaited(_showProposalLimitReachedDialog(signal));
+      case UnlockProposalSignal():
+        unawaited(_showUnlockProposalDialog(signal));
     }
   }
 
@@ -317,6 +320,28 @@ class _ProposalBuilderPageState extends State<ProposalBuilderPage>
     );
   }
 
+  Future<void> _showUnlockProposalDialog(
+    UnlockProposalSignal signal, {
+    ProposalBuilderBloc? bloc,
+  }) async {
+    bloc ??= context.read<ProposalBuilderBloc>();
+    final unlock = await UnlockEditProposalDialog.show(
+          context: context,
+          title: signal.title,
+          version: signal.version,
+        ) ??
+        false;
+
+    if (unlock && mounted) {
+      return bloc.add(const UnlockProposalBuilderEvent());
+    }
+    if (mounted) {
+      Router.neglect(context, () {
+        const WorkspaceRoute().replace(context);
+      });
+    }
+  }
+
   void _showValidationErrorSnackbar(ProposalBuilderValidationException error) {
     VoicesSnackBar.hideCurrent(context);
 

catalyst_voices/packages/internal/catalyst_voices_blocs/lib/src/proposal_builder/proposal_builder_bloc.dart

@@ -65,6 +65,7 @@ final class ProposalBuilderBloc extends Bloc<ProposalBuilderEvent, ProposalBuild
     on<MaxProposalsLimitChangedEvent>(_updateMaxProposalsLimitReached);
     on<MaxProposalsLimitReachedEvent>(_onMaxProposalsLimitReached);
     on<UpdateUsernameEvent>(_onUpdateUsername);
+    on<UnlockProposalBuilderEvent>(_unlockProposal);
 
     final activeAccount = _userService.user.activeAccount;
 
@@ -414,7 +415,8 @@ final class ProposalBuilderBloc extends Bloc<ProposalBuilderEvent, ProposalBuild
     LoadProposalEvent event,
     Emitter<ProposalBuilderState> emit,
   ) async {
-    final proposalRef = event.proposalId;
+    final proposalRef = await _proposalService.getLatestProposalVersion(ref: event.proposalId);
+
     if (state.metadata.documentRef == proposalRef) {
       _logger.info('Loading proposal: $proposalRef ignored, already loaded');
       return;
@@ -429,6 +431,15 @@ final class ProposalBuilderBloc extends Bloc<ProposalBuilderEvent, ProposalBuild
 
       final proposal = Proposal.fromData(proposalData);
 
+      if (proposalData.publish.isPublished) {
+        emitSignal(
+          UnlockProposalSignal(
+            title: proposal.title,
+            version: proposal.versionCount,
+          ),
+        );
+      }
+
       final versions = proposalData.versions.mapIndexed((index, version) {
         final versionRef = version.document.metadata.selfRef;
         final versionId = versionRef.version ?? versionRef.id;
@@ -914,6 +925,27 @@ final class ProposalBuilderBloc extends Bloc<ProposalBuilderEvent, ProposalBuild
     emitSignal(const SubmittedProposalBuilderSignal());
   }
 
+  Future<void> _unlockProposal(
+    UnlockProposalBuilderEvent event,
+    Emitter<ProposalBuilderState> emit,
+  ) async {
+    try {
+      final proposalRef = state.metadata.documentRef! as SignedDocumentRef;
+      final categoryId = state.metadata.categoryId!;
+      emit(state.copyWith(isChanging: true));
+      await _proposalService.unlockProposal(
+        proposalRef: proposalRef,
+        categoryId: categoryId,
+      );
+      final stateMetadata = state.metadata.copyWith(publish: ProposalPublish.publishedDraft);
+      _cache = _cache.copyWith(proposalMetadata: Optional(stateMetadata));
+      emit(state.copyWith(metadata: stateMetadata, isChanging: false));
+    } catch (e, stackTrace) {
+      _logger.severe('Unlock proposal failed', e, stackTrace);
+      emitError(LocalizedException.create(e));
+    }
+  }
+
   Future<void> _updateCommentBuilder(
     UpdateCommentBuilderEvent event,
     Emitter<ProposalBuilderState> emit,

catalyst_voices/packages/internal/catalyst_voices_blocs/lib/src/proposal_builder/proposal_builder_event.dart

@@ -140,6 +140,13 @@ final class SubmitProposalEvent extends ProposalBuilderEvent {
   List<Object?> get props => [];
 }
 
+final class UnlockProposalBuilderEvent extends ProposalBuilderEvent {
+  const UnlockProposalBuilderEvent();
+
+  @override
+  List<Object?> get props => [];
+}
+
 final class UpdateCommentBuilderEvent extends ProposalBuilderEvent {
   final SignedDocumentRef ref;
   final bool show;

catalyst_voices/packages/internal/catalyst_voices_blocs/lib/src/proposal_builder/proposal_builder_signal.dart

@@ -59,3 +59,16 @@ final class SubmittedProposalBuilderSignal extends ProposalBuilderSignal {
   @override
   List<Object?> get props => [];
 }
+
+final class UnlockProposalSignal extends ProposalBuilderSignal {
+  final String title;
+  final int version;
+
+  const UnlockProposalSignal({
+    required this.title,
+    required this.version,
+  });
+
+  @override
+  List<Object?> get props => [title, version];
+}

catalyst_voices/packages/internal/catalyst_voices_services/lib/src/proposal/proposal_service.dart

@@ -49,6 +49,8 @@ abstract interface class ProposalService {
   /// Similar to [watchFavoritesProposalsIds] stops after first emit.
   Future<List<String>> getFavoritesProposalsIds();
 
+  Future<DocumentRef> getLatestProposalVersion({required DocumentRef ref});
+
   Future<ProposalData> getProposal({
     required DocumentRef ref,
   });
@@ -224,6 +226,20 @@ final class ProposalServiceImpl implements ProposalService {
         .first;
   }
 
+  @override
+  Future<DocumentRef> getLatestProposalVersion({
+    required DocumentRef ref,
+  }) async {
+    final proposalVersions = await _documentRepository.getAllVersionsOfId(
+      id: ref.id,
+    );
+    final refList = List<DocumentRef>.from(
+      proposalVersions.map((e) => e.metadata.selfRef).toList(),
+    )..sort();
+
+    return refList.last;
+  }
+
   @override
   Future<ProposalData> getProposal({
     required DocumentRef ref,