Absorb review changes

example/lib/main.dart

@@ -38,19 +38,19 @@ class MainScreen extends StatelessWidget {
     //     print(message.message);
     //   }
     // }
-    //
-    // final customNstackMessageOptions =
-    //     CustomNstackMessageOptions(onMessage: onMessage);
+
+    // final customNstackHandlerConfiguration =
+    //     CustomNstackHandlerConfiguration(onMessage: onMessage);
 
     // Message option for showing default dialog.
-    final defaultNstackMessageOptions = DefaultNstackMessageOptions(
+    final defaultHandlerConfiguration = DefaultNstackHandlerConfiguration(
       okButtonTitle: localizationAsset.test.okButtonTitle,
       openUrlButtonTitle: localizationAsset.test.openUrlButtonTitle,
       dialogTitle: localizationAsset.test.dialogTitle,
     );
 
     return NStackMessageWidget(
-      messageOptions: defaultNstackMessageOptions,
+      handlerConfiguration: defaultHandlerConfiguration,
       child: Scaffold(
         appBar: AppBar(
           title: Text(localizationAsset.test.testDollarSign),

example/lib/nstack.dart

@@ -15,10 +15,13 @@
  * `context.localization.assets.yourSection.yourKey`.
  *
  * 💬 MESSAGES
- * 
- * To use messages, you can use `NStackMessageWidget`,
- * and if you want the default dialog, use `DefaultNstackMessageOptions`.
- * Or you can use `CustomNstackMessageOptions` to get the `Message` object from the NStack.
+ *  
+ * Use `NStackMessageWidget` to access the Messages feature.
+ *
+ * [NStackMessageWidget.handlerConfiguration] allows you to configure how incoming messages are handled.
+ * - Use `DefaultNstackHandlerConfiguration` if you want to display a default adaptive dialog
+ * - Or use `CustomNstackHandlerConfiguration` if you want to handle the message yourself.
+ *   it has the `onMessage` callback that provides you with the received `Message` object.
  *
  * 🛠️ IMPORTANT NOTES FOR SDK USERS
  * 
@@ -256,9 +259,16 @@ class NStackState extends State<NStackWidget> {
   }
 }
 
-abstract class NStackMessageOptions {}
+/*
+ *
+ * NStack Message
+ * 
+ */
+
+sealed class NStackHandlerConfiguration {}
 
-class DefaultNstackMessageOptions implements NStackMessageOptions {
+final class DefaultNstackHandlerConfiguration
+    implements NStackHandlerConfiguration {
   /// Title of the OK button.
   final String? okButtonTitle;
 
@@ -268,30 +278,33 @@ class DefaultNstackMessageOptions implements NStackMessageOptions {
   /// Title of the dialog.
   final String? dialogTitle;
 
-  DefaultNstackMessageOptions({
+  DefaultNstackHandlerConfiguration({
     this.okButtonTitle,
     this.openUrlButtonTitle,
     this.dialogTitle,
   });
 }
 
-class CustomNstackMessageOptions implements NStackMessageOptions {
+final class CustomNstackHandlerConfiguration
+    implements NStackHandlerConfiguration {
   /// Callback to customize the message UI.
   final void Function(Message message) onMessage;
 
-  CustomNstackMessageOptions({
+  CustomNstackHandlerConfiguration({
     required this.onMessage,
   });
 }
 
 class NStackMessageWidget extends StatefulWidget {
   const NStackMessageWidget({
     super.key,
-    required this.messageOptions,
+    required this.handlerConfiguration,
     this.child,
   });
 
-  final NStackMessageOptions messageOptions;
+  /// Configuration of how the message will be handled.
+  /// It can be either `DefaultNstackHandlerConfiguration` or `CustomNstackHandlerConfiguration`.
+  final NStackHandlerConfiguration handlerConfiguration;
 
   final Widget? child;
 
@@ -318,20 +331,20 @@ class _NStackMessageWidgetSate extends State<NStackMessageWidget> {
   }
 
   void _onMessage(Message message) {
-    if (widget.messageOptions is CustomNstackMessageOptions) {
-      (widget.messageOptions as CustomNstackMessageOptions)
-          .onMessage
-          .call(message);
-    } else {
-      final messageOptions =
-          widget.messageOptions as DefaultNstackMessageOptions;
-      NStackMessageDialog.show(
-        context,
-        message: message,
-        okButtonTitle: messageOptions.okButtonTitle,
-        openUrlButtonTitle: messageOptions.openUrlButtonTitle,
-        dialogTitle: messageOptions.dialogTitle,
-      );
+    final messageOptions = widget.handlerConfiguration;
+    switch (messageOptions) {
+      case CustomNstackHandlerConfiguration():
+        messageOptions.onMessage(message);
+        break;
+      case DefaultNstackHandlerConfiguration():
+        NStackMessageDialog.show(
+          context,
+          message: message,
+          okButtonTitle: messageOptions.okButtonTitle,
+          openUrlButtonTitle: messageOptions.openUrlButtonTitle,
+          dialogTitle: messageOptions.dialogTitle,
+        );
+        break;
     }
   }
 

lib/sdk/messages/nstack_messages.dart

@@ -19,15 +19,18 @@ class NStackMessages {
   }) : _repository = repository;
 
   Future<void> setMessageViewed(int messageId) async {
+    final appOpenData = _appOpenData;
+
+    if (appOpenData == null) {
+      LogUtil.log('NStack --> Could not post message seen.');
+      return;
+    }
+
     try {
-      if (_appOpenData != null) {
-        await _repository.postMessageSeen(
-          appOpenData: _appOpenData!,
-          messageId: messageId,
-        );
-      } else {
-        LogUtil.log('NStack --> Could not post message seen.');
-      }
+      await _repository.postMessageSeen(
+        appOpenData: appOpenData,
+        messageId: messageId,
+      );
     } catch (e) {
       LogUtil.log('NStack --> Could not post message seen.');
     }

lib/templates/nstack_template.txt

@@ -15,10 +15,13 @@
  * `context.localization.assets.yourSection.yourKey`.
  *
  * 💬 MESSAGES
- * 
- * To use messages, you can use `NStackMessageWidget`,
- * and if you want the default dialog, use `DefaultNstackMessageOptions`.
- * Or you can use `CustomNstackMessageOptions` to get the `Message` object from the NStack.
+ *  
+ * Use `NStackMessageWidget` to access the Messages feature.
+ *
+ * [NStackMessageWidget.handlerConfiguration] allows you to configure how incoming messages are handled.
+ * - Use `DefaultNstackHandlerConfiguration` if you want to display a default adaptive dialog
+ * - Or use `CustomNstackHandlerConfiguration` if you want to handle the message yourself.
+ *   it has the `onMessage` callback that provides you with the received `Message` object.
  *
  * 🛠️ IMPORTANT NOTES FOR SDK USERS
  * 
@@ -206,9 +209,16 @@ class NStackState extends State<NStackWidget> {
   }
 }
 
-abstract class NStackMessageOptions {}
+/*
+ *
+ * NStack Message
+ * 
+ */
+
+sealed class NStackHandlerConfiguration {}
 
-class DefaultNstackMessageOptions implements NStackMessageOptions {
+final class DefaultNstackHandlerConfiguration
+    implements NStackHandlerConfiguration {
   /// Title of the OK button.
   final String? okButtonTitle;
 
@@ -218,30 +228,33 @@ class DefaultNstackMessageOptions implements NStackMessageOptions {
   /// Title of the dialog.
   final String? dialogTitle;
 
-  DefaultNstackMessageOptions({
+  DefaultNstackHandlerConfiguration({
     this.okButtonTitle,
     this.openUrlButtonTitle,
     this.dialogTitle,
   });
 }
 
-class CustomNstackMessageOptions implements NStackMessageOptions {
+final class CustomNstackHandlerConfiguration
+    implements NStackHandlerConfiguration {
   /// Callback to customize the message UI.
   final void Function(Message message) onMessage;
 
-  CustomNstackMessageOptions({
+  CustomNstackHandlerConfiguration({
     required this.onMessage,
   });
 }
 
 class NStackMessageWidget extends StatefulWidget {
   const NStackMessageWidget({
     super.key,
-    required this.messageOptions,
+    required this.handlerConfiguration,
     this.child,
   });
 
-  final NStackMessageOptions messageOptions;
+  /// Configuration of how the message will be handled.
+  /// It can be either `DefaultNstackHandlerConfiguration` or `CustomNstackHandlerConfiguration`.
+  final NStackHandlerConfiguration handlerConfiguration;
 
   final Widget? child;
 
@@ -268,20 +281,20 @@ class _NStackMessageWidgetSate extends State<NStackMessageWidget> {
   }
 
   void _onMessage(Message message) {
-    if (widget.messageOptions is CustomNstackMessageOptions) {
-      (widget.messageOptions as CustomNstackMessageOptions)
-          .onMessage
-          .call(message);
-    } else {
-      final messageOptions =
-          widget.messageOptions as DefaultNstackMessageOptions;
-      NStackMessageDialog.show(
-        context,
-        message: message,
-        okButtonTitle: messageOptions.okButtonTitle,
-        openUrlButtonTitle: messageOptions.openUrlButtonTitle,
-        dialogTitle: messageOptions.dialogTitle,
-      );
+    final messageOptions = widget.handlerConfiguration;
+    switch (messageOptions) {
+      case CustomNstackHandlerConfiguration():
+        messageOptions.onMessage(message);
+        break;
+      case DefaultNstackHandlerConfiguration():
+        NStackMessageDialog.show(
+          context,
+          message: message,
+          okButtonTitle: messageOptions.okButtonTitle,
+          openUrlButtonTitle: messageOptions.openUrlButtonTitle,
+          dialogTitle: messageOptions.dialogTitle,
+        );
+        break;
     }
   }