✨ added AppProviderScope

packages/clean_framework/example/lib/main.dart

@@ -3,18 +3,8 @@ import 'package:clean_framework_example/providers.dart';
 import 'package:clean_framework_example/routing/routes.dart';
 import 'package:clean_framework_router/clean_framework_router.dart';
 import 'package:flutter/material.dart';
-import 'package:stack_trace/stack_trace.dart' as stack_trace;
-
-final container = ProviderContainer();
 
 void main() {
-  FlutterError.demangleStackTrace = (StackTrace stack) {
-    if (stack is stack_trace.Trace) return stack.vmTrace;
-    if (stack is stack_trace.Chain) return stack.toTrace().vmTrace;
-    return stack;
-  };
-  initializeExternalInterfaces(container);
-
   runApp(const MyApp());
 }
 
@@ -23,8 +13,10 @@ class MyApp extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    return ProviderScope(
-      parent: container,
+    return AppProviderScope(
+      externalInterfaceProviders: [
+        pokemonExternalInterfaceProvider,
+      ],
       child: AppRouterScope(
         create: PokeRouter.new,
         builder: (context) {

packages/clean_framework/example/lib/providers.dart

@@ -33,7 +33,3 @@ final pokemonExternalInterfaceProvider = ExternalInterfaceProvider(
     pokemonSpeciesGateway,
   ],
 );
-
-void initializeExternalInterfaces(ProviderContainer container) {
-  pokemonExternalInterfaceProvider.initializeFor(container);
-}

packages/clean_framework/lib/src/core/app_provider_scope.dart

@@ -0,0 +1,81 @@
+import 'package:clean_framework/clean_framework_core.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:stack_trace/stack_trace.dart';
+
+class AppProviderScope extends StatelessWidget {
+  const AppProviderScope({
+    super.key,
+    required this.child,
+    this.externalInterfaceProviders = const [],
+    this.overrides = const [],
+    this.observers,
+    this.parent,
+  });
+
+  final Widget child;
+
+  final ProviderContainer? parent;
+
+  /// The listeners that subscribes to changes on providers
+  /// stored on this [ProviderScope].
+  final List<ProviderObserver>? observers;
+
+  /// Information on how to override a provider/family.
+  final List<Override> overrides;
+
+  final List<ExternalInterfaceProvider> externalInterfaceProviders;
+
+  @override
+  Widget build(BuildContext context) {
+    return ProviderScope(
+      parent: parent,
+      observers: observers,
+      overrides: overrides,
+      child: Builder(
+        builder: (context) {
+          return _ProviderInitializer(
+            container: ProviderScope.containerOf(context),
+            externalInterfaceProviders: externalInterfaceProviders,
+            child: child,
+          );
+        },
+      ),
+    );
+  }
+}
+
+class _ProviderInitializer extends StatefulWidget {
+  const _ProviderInitializer({
+    required this.container,
+    required this.child,
+    required this.externalInterfaceProviders,
+  });
+
+  final ProviderContainer container;
+  final Widget child;
+  final List<ExternalInterfaceProvider> externalInterfaceProviders;
+
+  @override
+  State<_ProviderInitializer> createState() => _ProviderInitializerState();
+}
+
+class _ProviderInitializerState extends State<_ProviderInitializer> {
+  @override
+  void initState() {
+    super.initState();
+
+    FlutterError.demangleStackTrace = (StackTrace stack) {
+      if (stack is Trace) return stack.vmTrace;
+      if (stack is Chain) return stack.toTrace().vmTrace;
+      return stack;
+    };
+
+    for (final provider in widget.externalInterfaceProviders) {
+      provider.initializeFor(widget.container);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) => widget.child;
+}

packages/clean_framework/lib/src/core/core.dart

@@ -1,3 +1,4 @@
+export 'app_provider_scope.dart';
 export 'external_interface/external_interface.dart';
 export 'external_interface/external_interface_provider.dart';
 export 'external_interface/request.dart';

packages/clean_framework/lib/src/core/use_case/helpers/input_filter_map.dart

@@ -9,7 +9,11 @@ extension InputFilterMapExtension<E extends Entity> on InputFilterMap<E> {
     final processor = this[I];
 
     if (processor == null) {
-      throw StateError('Input processor not defined for $I');
+      throw StateError(
+        'Input filter not defined for "$I".\n'
+        'Filters available for: ${keys.isEmpty ? 'none' : keys.join(', ')}\n'
+        'Dependency: $E',
+      );
     }
 
     return processor(input, entity);

packages/clean_framework/lib/src/core/use_case/helpers/output_filter_map.dart

@@ -11,7 +11,8 @@ extension OutputFilterMapExtension<E extends Entity> on OutputFilterMap<E> {
     if (builder == null) {
       throw StateError(
         'Output filter not defined for "$O".\n'
-        'Filters available for: ${keys.join(', ')}',
+        'Filters available for: ${keys.isEmpty ? 'none' : keys.join(', ')}\n'
+        'Dependency: $E',
       );
     }
 

packages/clean_framework/pubspec.yaml

@@ -15,6 +15,7 @@ dependencies:
   flutter_riverpod: ^2.1.3
   meta: '>=1.8.0 <1.9.0'
   riverpod: ^2.1.3
+  stack_trace: ">=1.10.0 <1.12.0"
 
 dev_dependencies:
   clean_framework_test: ^0.1.0