compose [nfc]: Expose an uploadFiles method on ComposeBoxController

This will be used soon to allow uploading files from outside
this source file, via using `MessageListPageState`.

Author: rajveermalviya

lib/widgets/compose_box.dart

@@ -929,6 +929,7 @@ Future<void> _uploadFiles({
   required BuildContext context,
   required ComposeContentController contentController,
   required FocusNode contentFocusNode,
+  bool shouldRequestFocus = true,
   required Iterable<FileToUpload> files,
 }) async {
   assert(context.mounted);
@@ -965,7 +966,7 @@ Future<void> _uploadFiles({
       zulipLocalizations);
     uploadsInProgress.add((tag, file));
   }
-  if (!contentFocusNode.hasFocus) {
+  if (shouldRequestFocus && !contentFocusNode.hasFocus) {
     contentFocusNode.requestFocus();
   }
 
@@ -1550,6 +1551,32 @@ sealed class ComposeBoxController {
     contentFocusNode.requestFocus();
   }
 
+  /// Uploads the provided files, populating the content input with their links.
+  ///
+  /// If any of the files are larger than maximum file size allowed by the
+  /// server, an error dialog is shown mentioning their names and actual
+  /// file sizes.
+  ///
+  /// While uploading, a placeholder link is inserted in the content input and
+  /// if [shouldRequestFocus] is true it will be focused. And then after
+  /// uploading completes successfully the placeholder link will be replaced
+  /// with an actual link.
+  ///
+  /// If there is an error while uploading a file, then an error dialog is
+  /// shown mentioning the corresponding file name.
+  Future<void> uploadFiles({
+    required BuildContext context,
+    required Iterable<FileToUpload> files,
+    required bool shouldRequestFocus,
+  }) async {
+    await _uploadFiles(
+      context: context,
+      contentController: content,
+      contentFocusNode: contentFocusNode,
+      shouldRequestFocus: shouldRequestFocus,
+      files: files);
+  }
+
   @mustCallSuper
   void dispose() {
     content.dispose();