feat: add fresh package for authentication

docs/authentication.md

@@ -0,0 +1,39 @@
+# Authentication
+
+The guide describes token-based authentication which relies on **access** and **refresh** tokens.
+
+## Fresh
+
+The recommended approach is to use the `fresh` package.
+
+[**Fresh**](https://pub.dev/packages/fresh) is a token refresh library for dart. This library consists of a collection of packages which specialize in a particular aspect of token refresh.
+
+Project contains preconfigured classes for `fresh_dio` package to make its usage even more easier.
+
+Example:
+```dart
+final fresh = Fresh<AuthTokenPair>(
+  tokenHeader: (token) => {'Authorization': 'Bearer ${token.accessToken}'},
+  tokenStorage: const TokenStorageImpl(FlutterSecureStorage()),
+  refreshToken: (options, handler) async { ... },
+);
+
+// Add interceptor to Dio instance.
+dio.interceptors.add(fresh);
+
+// Listen to authentication status changes.
+fresh.authenticationStatus.listen((status) { ... });
+
+// Set token.
+fresh.setToken(token);
+
+// Clear token.
+fresh.clearToken();
+```
+## Token Storage
+
+`TokenStorageImpl` is an implementation of `TokenStorage<AuthTokenPair>` from `fresh` package which relies on `flutter_secure_storage`.
+
+## Auth Tokens
+
+`AuthTokenPair` is a class that represents a pair of access and refresh tokens. It is used by `TokenStorageImpl`.

lib/common/mixin/theme_wm_mixin.dart

@@ -17,6 +17,7 @@ mixin ThemeWMMixin<W extends ElementaryWidget, M extends ElementaryModel> on Wid
 
   @override
   void didChangeDependencies() {
+    super.didChangeDependencies();
     _colorScheme = AppColorScheme.of(context);
     _textScheme = AppTextScheme.of(context);
   }

lib/common/widgets/di_scope.dart

@@ -10,14 +10,14 @@ typedef ScopeFactory<T> = T Function(BuildContext context);
 class DiScope<T> extends SingleChildStatefulWidget {
   /// Create an instance [DiScope].
   const DiScope({
-    required this.onFactory,
+    required this.factory,
     this.onDispose,
     super.key,
     super.child,
   });
 
   /// Factory that returns the dependency scope.
-  final ScopeFactory<T> onFactory;
+  final ScopeFactory<T> factory;
 
   /// The method called when disposing the widget.
   final ValueChanged<T>? onDispose;
@@ -32,7 +32,7 @@ class _DiScopeState<T> extends SingleChildState<DiScope<T>> {
   @override
   void initState() {
     super.initState();
-    _scope = widget.onFactory(context);
+    _scope = widget.factory(context);
   }
 
   @override

lib/features/app/app_flow.dart

@@ -24,7 +24,7 @@ class AppFlow extends StatelessWidget {
   Widget build(BuildContext context) {
     return Nested(
       children: [
-        DiScope<IAppScope>(onFactory: (_) => appScope),
+        DiScope<IAppScope>(factory: (_) => appScope),
         ChangeNotifierProvider<AppRouter>(create: (_) => AppRouter()),
         const ThemeModeProvider(),
       ],

lib/features/debug/presentation/debug/debug_flow.dart

@@ -15,7 +15,7 @@ class DebugFlow extends StatelessWidget implements AutoRouteWrapper {
   @override
   Widget wrappedRoute(BuildContext context) {
     return DiScope<IDebugScope>(
-      onFactory: DebugScope.create,
+      factory: DebugScope.create,
       onDispose: (scope) => scope.dispose(),
       child: this,
     );

lib/features/feature_example/presentation/feature_example_flow.dart

@@ -15,7 +15,7 @@ class FeatureExampleFlow extends StatelessWidget implements AutoRouteWrapper {
   @override
   Widget wrappedRoute(BuildContext context) {
     return DiScope<IFeatureExampleScope>(
-      onFactory: FeatureExampleScope.create,
+      factory: FeatureExampleScope.create,
       onDispose: (scope) => scope.dispose(),
       child: this,
     );