feat: New capabilities

lib/src/action_api/action_executor.dart

@@ -2,14 +2,15 @@ import "package:duit_kernel/duit_kernel.dart";
 
 /// The [ActionExecutor] is an abstract class responsible for executing actions.
 ///
-/// It relies on a [UIDriver] to perform actions and an [DebugLogger] to log messages.
+/// It relies on a [UIDriver] to perform actions and an DebugLogger to log messages.
 /// This class serves as a base for concrete implementations that define how actions
 /// should be executed.
 ///
 /// Subclasses must implement the [executeAction] method to handle different types
 /// of [ServerAction]s.
 abstract class ActionExecutor {
   final UIDriver driver;
+  @Deprecated("Use [LoggingCapabilityDelegate] instead")
   final DebugLogger? logger;
 
   ActionExecutor({
@@ -58,10 +59,10 @@ final class DefaultActionExecutor extends ActionExecutor {
 
           return null;
         } catch (e, s) {
-          logger?.error(
+          driver.logError(
             "[Error while executing transport action]",
-            error: e,
-            stackTrace: s,
+            e,
+            s,
           );
         }
 
@@ -71,10 +72,10 @@ final class DefaultActionExecutor extends ActionExecutor {
         try {
           return action.event;
         } catch (e, s) {
-          logger?.error(
+          driver.logError(
             "[Error while executing local action]",
-            error: e,
-            stackTrace: s,
+            e,
+            s,
           );
         }
         break;
@@ -97,10 +98,10 @@ final class DefaultActionExecutor extends ActionExecutor {
 
           return null;
         } catch (e, s) {
-          logger?.error(
+          driver.logError(
             "[Error while executing script action]",
-            error: e,
-            stackTrace: s,
+            e,
+            s,
           );
         }
         break;

lib/src/action_api/event_resolver.dart

@@ -5,6 +5,7 @@ import "package:flutter/material.dart" show BuildContext;
 
 abstract class EventResolver {
   final UIDriver driver;
+  @Deprecated("Use [LoggingCapabilityDelegate] instead")
   final DebugLogger? logger;
 
   EventResolver({
@@ -32,8 +33,6 @@ final class DefaultEventResolver extends EventResolver {
     }
 
     try {
-      final driver = this.driver;
-
       switch (event) {
         case UpdateEvent():
           event.updates.forEach((key, value) async {
@@ -46,7 +45,7 @@ final class DefaultEventResolver extends EventResolver {
             "ExternalEventHandler instance is not set",
           );
           if (driver.externalEventHandler != null) {
-            logger?.error("ExternalEventHandler instance is not set");
+            driver.logError("ExternalEventHandler instance is not set");
             throw StateError("ExternalEventHandler instance is not set");
           }
           await driver.externalEventHandler?.handleNavigation(
@@ -57,7 +56,7 @@ final class DefaultEventResolver extends EventResolver {
           break;
         case OpenUrlEvent():
           if (driver.externalEventHandler != null) {
-            logger?.error("ExternalEventHandler instance is not set");
+            driver.logError("ExternalEventHandler instance is not set");
             throw StateError("ExternalEventHandler instance is not set");
           }
           await driver.externalEventHandler?.handleOpenUrl(event.url);
@@ -106,10 +105,10 @@ final class DefaultEventResolver extends EventResolver {
           break;
       }
     } catch (e, s) {
-      logger?.error(
+      driver.logError(
         "Error while resolving ${event.type} event",
-        error: e,
-        stackTrace: s,
+        e,
+        s,
       );
     }
   }

lib/src/capabilities/index.dart

@@ -2,3 +2,7 @@ export "actions_capability.dart";
 export "focus_capability.dart";
 export "ui_controller_capability.dart";
 export "viewmodel_capability.dart";
+export "transport_capability.dart";
+export "scripting_capability.dart";
+export "logging/index.dart";
+export "native_module_capability.dart";

lib/src/capabilities/logging/index.dart

@@ -0,0 +1,2 @@
+export "logging_capability.dart";
+export "io.dart" if (dart.library.js_interop) "web.dart";

lib/src/capabilities/logging/io.dart

@@ -0,0 +1,82 @@
+import "package:duit_kernel/src/capabilities/logging/logging_capability.dart";
+import "package:flutter/foundation.dart";
+
+/// A class that provides logging capabilities for the Duit UI system.
+///
+/// This class implements the [LoggingCapabilityDelegate] mixin and provides
+/// concrete implementations for logging messages at different levels.
+final class LoggingManager with LoggingCapabilityDelegate {
+  const LoggingManager();
+
+  @override
+  void logCritical(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] CRITICAL: $message \nTime: ${DateTime.now().toUtc()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    debugPrint(buff.toString());
+  }
+
+  @override
+  void logDebug(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] DEBUG: $message \nTime: ${DateTime.now().toUtc()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    debugPrint(buff.toString());
+  }
+
+  @override
+  void logError(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] ERROR: $message \nTime: ${DateTime.now().toUtc()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    debugPrint(buff.toString());
+  }
+
+  @override
+  void logInfo(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] INFO: $message \nTime: ${DateTime.now().toUtc()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    debugPrint(buff.toString());
+  }
+
+  @override
+  void logVerbose(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] VERBOSE: $message \nTime: ${DateTime.now().toUtc()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    debugPrint(buff.toString());
+  }
+
+  @override
+  void logWarning(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] WARNING: $message \nTime: ${DateTime.now().toUtc()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    debugPrint(buff.toString());
+  }
+}

lib/src/capabilities/logging/logging_capability.dart

@@ -0,0 +1,99 @@
+import "package:duit_kernel/src/misc/error.dart";
+import "package:meta/meta.dart";
+
+/// A mixin that provides logging capabilities compatible with Talker API.
+///
+/// This mixin defines methods for logging messages at different levels,
+/// handling exceptions, and logging custom log types. All methods must be
+/// overridden by implementing classes.
+mixin LoggingCapabilityDelegate {
+  /// Logs an informational message.
+  ///
+  /// Use this method to log general informational messages about the
+  /// application's state or flow.
+  @mustBeOverridden
+  void logInfo(
+    message, [
+    Object? exception,
+    StackTrace? stackTrace,
+  ]) =>
+      throw const MissingCapabilityMethodImplementation(
+        "info",
+        "LoggingCapabilityDelegate",
+      );
+
+  /// Logs a debug message.
+  ///
+  /// Use this method to log detailed debugging information that is typically
+  /// only useful during development.
+  @mustBeOverridden
+  void logDebug(
+    message, [
+    Object? exception,
+    StackTrace? stackTrace,
+  ]) =>
+      throw const MissingCapabilityMethodImplementation(
+        "debug",
+        "LoggingCapabilityDelegate",
+      );
+
+  /// Logs a warning message.
+  ///
+  /// Use this method to log warnings about potential issues or unexpected
+  /// conditions that don't prevent the application from functioning.
+  @mustBeOverridden
+  void logWarning(
+    message, [
+    Object? exception,
+    StackTrace? stackTrace,
+  ]) =>
+      throw const MissingCapabilityMethodImplementation(
+        "warning",
+        "LoggingCapabilityDelegate",
+      );
+
+  /// Logs an error message.
+  ///
+  /// Use this method to log error messages that indicate problems or failures
+  /// in the application.
+  @mustBeOverridden
+  void logError(
+    message, [
+    Object? exception,
+    StackTrace? stackTrace,
+  ]) =>
+      throw const MissingCapabilityMethodImplementation(
+        "error",
+        "LoggingCapabilityDelegate",
+      );
+
+  /// Logs a critical error message.
+  ///
+  /// Use this method to log critical errors that require immediate attention
+  /// and may indicate serious problems in the application.
+  @mustBeOverridden
+  void logCritical(
+    message, [
+    Object? exception,
+    StackTrace? stackTrace,
+  ]) =>
+      throw const MissingCapabilityMethodImplementation(
+        "critical",
+        "LoggingCapabilityDelegate",
+      );
+
+  /// Logs a verbose message.
+  ///
+  /// Use this method to log very detailed information that is typically only
+  /// useful for deep debugging or troubleshooting.
+  @mustBeOverridden
+  void logVerbose(
+    message, [
+    Object? exception,
+    StackTrace? stackTrace,
+  ]) =>
+      throw const MissingCapabilityMethodImplementation(
+        "verbose",
+        "LoggingCapabilityDelegate",
+      );
+}

lib/src/capabilities/logging/web.dart

@@ -0,0 +1,84 @@
+import "dart:js_interop";
+
+import "package:duit_kernel/src/capabilities/logging/logging_capability.dart";
+import "package:web/web.dart";
+
+/// A class that provides logging capabilities for the Duit UI system.
+///
+/// This class implements the [LoggingCapabilityDelegate] mixin and provides
+/// concrete implementations for logging messages at different levels.
+final class LoggingManager with LoggingCapabilityDelegate {
+  const LoggingManager();
+
+  @override
+  void logCritical(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] CRITICAL: $message \nTime: ${DateTime.now().toIso8601String()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    console.error(buff.toString().toJS);
+  }
+
+  @override
+  void logDebug(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] DEBUG: $message \nTime: ${DateTime.now().toIso8601String()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    console.debug(buff.toString().toJS);
+  }
+
+  @override
+  void logError(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] ERROR: $message \nTime: ${DateTime.now().toIso8601String()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    console.error(buff.toString().toJS);
+  }
+
+  @override
+  void logInfo(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] INFO: $message \nTime: ${DateTime.now().toIso8601String()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    console.info(buff.toString().toJS);
+  }
+
+  @override
+  void logVerbose(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] VERBOSE: $message \nTime: ${DateTime.now().toIso8601String()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    console.log(buff.toString().toJS);
+  }
+
+  @override
+  void logWarning(message, [Object? exception, StackTrace? stackTrace]) {
+    final buff = StringBuffer("[DUIT FRAMEWORK] WARNING: $message \nTime: ${DateTime.now().toIso8601String()}");
+    if (exception != null) {
+      buff.write("\nException: ${exception.toString()}");
+    }
+    if (stackTrace != null) {
+      buff.write("\nStackTrace: ${stackTrace.toString()}");
+    }
+    console.warn(buff.toString().toJS);
+  }
+}