feat return a boolean indicating whether the [data] was successfully sent using the [shareData] method

doc improve documentation form [shareData] method

feat return the original Future from the [disposeOverlayListener] method

Author: serhiisdev

lib/src/overlay_window.dart

@@ -1,6 +1,7 @@
 import 'dart:async';
 import 'dart:developer';
 
+import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:flutter_overlay_window/src/overlay_config.dart';
 
@@ -81,9 +82,33 @@ class FlutterOverlayWindow {
     return _res;
   }
 
-  /// Broadcast data to and from overlay app
-  static Future shareData(dynamic data) async {
-    return await _overlayMessageChannel.send(data);
+  /// Broadcast [data] to and from overlay app.
+  ///
+  /// If `true` is returned, it indicates that the [data] was sent. However, it does not guarantee
+  /// that the [data] has arrived at its destination,
+  /// i.e. to the listeners of the [overlayListener] stream.
+  /// Typically, success in sending should imply successful delivery.
+  ///
+  /// If `false` is returned, it means that the [data] was not sent.
+  ///
+  /// This method may return `false` under the following conditions:
+  /// - The overlay is closed.
+  /// - The application is detached from the activity, i.e. the application is closed.
+  ///
+  /// Returns `true` if the [data] was sent successfully, otherwise `false`.
+  /// May return `null` if an unexpected condition occurs, e.g.
+  /// the overlay is visible but the overlay's message channel is not registered,
+  /// resulting in the [data] not being sent.
+  static Future<bool?> shareData(dynamic data) async {
+    final isSent = await _overlayMessageChannel.send(data);
+    if (isSent == null) {
+      debugPrintStack(
+          stackTrace: StackTrace.current,
+          label: '[FlutterOverlayWindow] ERROR: '
+              'Failed to send the [data] using the [shareData] method.');
+      return null;
+    }
+    return isSent as bool;
   }
 
   /// Streams message shared between overlay and main app
@@ -123,7 +148,7 @@ class FlutterOverlayWindow {
   /// Dispose overlay stream.
   ///
   /// Once disposed, only a complete restart of the application will re-initialize the listener.
-  static void disposeOverlayListener() {
-    _controller.close();
+  static Future<dynamic> disposeOverlayListener() {
+    return _controller.close();
   }
 }