refactor(full refactor): Рефакторинг стартера (#8)

app_services/aurora/app_services/lib/src/app_path_provider.dart

@@ -1,8 +1,13 @@
 import 'package:i_app_services/i_app_services.dart';
 import 'package:path_provider/path_provider.dart';
 
-/// Класс для Aurora реализации сервиса работы с путями
+/// {@template app_path_provider}
+/// Класс для Аврора реализации сервиса работы с путями
+/// {@endtemplate}
 class AppPathProvider implements IPathProvider {
+  /// {@macro app_path_provider}
+  const AppPathProvider();
+
   /// Наименование сервиса
   static const name = 'AuroraAppPathProvider';
 

app_services/aurora/app_services/lib/src/app_secure_storage.dart

@@ -2,21 +2,23 @@ import 'package:flutter_secure_storage/flutter_secure_storage.dart';
 import 'package:flutter_secure_storage_aurora/flutter_secure_storage_aurora.dart';
 import 'package:i_app_services/i_app_services.dart';
 
+/// {@template app_secure_storage}
 /// Класс для Aurora реализации сервис по работе с защищенным хранилищем
+/// [secretKey] - ключ для шифрования данных, обязательный параметр для Авроры
+/// {@endtemplate}
 final class AppSecureStorage implements ISecureStorage {
   /// Создает сервис для работы с защищенным хранилищем
   ///
   /// Принимает:
   /// - [secretKey] - ключ шифрования данных
-  AppSecureStorage({required this.secretKey}){
-     FlutterSecureStorageAurora.setSecret(secretKey);
+  AppSecureStorage({required this.secretKey}) {
+    FlutterSecureStorageAurora.setSecret(secretKey);
   }
 
   @override
   final String secretKey;
 
-
-   static const name = 'AuroraAppSecureStorage';
+  static const name = 'AuroraAppSecureStorage';
 
   /// Экземпляр хранилища данных
   final _box = const FlutterSecureStorage();
@@ -46,6 +48,6 @@ final class AppSecureStorage implements ISecureStorage {
     await _box.write(key: key, value: value);
   }
 
-    @override
+  @override
   String get nameImpl => AppSecureStorage.name;
 }

app_services/aurora/app_services/pubspec.yaml

@@ -4,8 +4,8 @@ version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.5.0
-  flutter: ^3.24.0
+  sdk: ^3.6.0
+  flutter: ">=3.24.0"
 
 
 dependencies:

app_services/base/app_services/lib/src/app_path_provider.dart

@@ -1,10 +1,15 @@
 import 'package:i_app_services/i_app_services.dart';
 import 'package:path_provider/path_provider.dart';
 
+/// {@template app_path_provider}
 /// Класс для базовой реализации сервиса работы с путями
+/// {@endtemplate}
 class AppPathProvider implements IPathProvider {
+  /// {@macro app_path_provider}
+  const AppPathProvider();
+
   /// Наименование сервиса
-  static const name = 'GmsAppPathProvider';
+  static const name = 'BaseAppPathProvider';
 
   @override
   Future<String> getAppDocumentsDirectoryPath() async {

app_services/base/app_services/lib/src/app_secure_storage.dart

@@ -1,24 +1,23 @@
 import 'package:flutter_secure_storage/flutter_secure_storage.dart';
 import 'package:i_app_services/i_app_services.dart';
 
-/// Класс для базовой реализации сервис по работе с защищенным хранилищем
+/// {@template app_secure_storage}
+/// Класс для Aurora реализации сервис по работе с защищенным хранилищем
+/// [secretKey] - ключ для шифрования данных, если нужен
+/// {@endtemplate}
 final class AppSecureStorage implements ISecureStorage {
-  /// Создает сервис для работы с защищенным хранилищем
-  ///
-  /// Принимает:
-  /// - [secretKey] - ключ шифрования данных
-  AppSecureStorage({required this.secretKey});
+  AppSecureStorage({this.secretKey});
 
   @override
-  final String secretKey;
+  final String? secretKey;
 
-  static const name = 'GmsAppSecureStorage';
+  static const name = 'BaseAppSecureStorage';
 
   /// Экземпляр хранилища данных
   final _box = const FlutterSecureStorage();
 
   @override
-  Future<void> clear() async {
+  Future<void> deleteAll() async {
     await _box.deleteAll();
   }
 
@@ -28,7 +27,7 @@ final class AppSecureStorage implements ISecureStorage {
   }
 
   @override
-  Future<bool> exists(String key) {
+  Future<bool> containsKey(String key) {
     return _box.containsKey(key: key);
   }
 
@@ -41,7 +40,7 @@ final class AppSecureStorage implements ISecureStorage {
   Future<void> write(String key, String value) async {
     await _box.write(key: key, value: value);
   }
-  
+
   @override
   String get nameImpl => AppSecureStorage.name;
 }

app_services/base/app_services/pubspec.yaml

@@ -1,11 +1,11 @@
 name: app_services
-description: "Google сервисы для приложения"
+description: "Базовые сервисы для приложения"
 version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.5.0
-  flutter: ^3.24.0
+  sdk: ^3.6.0
+  flutter: ">=3.24.0"
 
 dependencies:
   flutter:

app_services/i_app_services/lib/src/i_path_provider.dart

@@ -5,5 +5,5 @@ abstract interface class IPathProvider {
   static const name = 'IPathProvider';
 
   /// Получение path на внутренне хранилище приложения
-  Future<String> getAppDocumentsDirectoryPath();
+  Future<String?> getAppDocumentsDirectoryPath();
 }

app_services/i_app_services/lib/src/i_secure_storage.dart

@@ -9,7 +9,9 @@ abstract interface class ISecureStorage {
   });
 
   /// Секретный ключ для шифрования данных
-  final String secretKey;
+  /// Нужен, если надо передать ключ в реализацию
+  /// например, в Aurora
+  final String? secretKey;
 
   /// Наименования интерфейса
   static const name = 'ISecureStorage';
@@ -34,13 +36,13 @@ abstract interface class ISecureStorage {
   Future<void> delete(String key);
 
   /// Метод для очистки защищенного хранилища
-  Future<void> clear();
+  Future<void> deleteAll();
 
   /// Метод для проверки наличия значения в защищенном хранилище
   ///
   /// Принимает:
   /// - [key] - ключ
-  Future<bool> exists(String key);
+  Future<bool> containsKey(String key);
 
   String get nameImpl;
 }

app_services/web/app_services/.gitignore

@@ -0,0 +1,29 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+build/

app_services/web/app_services/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "7482962148e8d758338d8a28f589f317e1e42ba4"
+  channel: "stable"
+
+project_type: package

app_services/web/app_services/README.md

@@ -0,0 +1 @@
+# Базовые сервисы для приложения

app_services/web/app_services/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:friflex_lint_rules/analysis_options.yaml

app_services/web/app_services/lib/app_services.dart

@@ -0,0 +1,4 @@
+library app_services;
+
+export 'src/app_path_provider.dart';
+export 'src/app_secure_storage.dart';

app_services/web/app_services/lib/src/app_path_provider.dart

@@ -0,0 +1,19 @@
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_path_provider}
+/// Класс для WEB реализации сервиса работы с путями
+/// {@endtemplate}
+class AppPathProvider implements IPathProvider {
+  /// {@macro app_path_provider}
+  const AppPathProvider();
+
+  /// Наименование сервиса
+  static const name = 'WebAppPathProvider';
+
+  @override
+  Future<String?> getAppDocumentsDirectoryPath() async {
+    // В веб у нас нет доступа к файловой системе.
+    // Возвращаем null, так как не можем предоставить путь к директории.
+    return null;
+  }
+}

app_services/web/app_services/lib/src/app_secure_storage.dart

@@ -0,0 +1,47 @@
+import 'package:flutter_secure_storage/flutter_secure_storage.dart';
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_secure_storage}
+/// Класс для Aurora реализации сервис по работе с защищенным хранилищем
+/// [secretKey] - ключ для шифрования данных, если нужен
+/// {@endtemplate}
+final class AppSecureStorage implements ISecureStorage {
+  /// @macro app_secure_storage
+  AppSecureStorage({this.secretKey});
+
+  @override
+  final String? secretKey;
+
+  static const name = 'WebAppSecureStorage';
+
+  /// Экземпляр хранилища данных
+  final _box = const FlutterSecureStorage();
+
+  @override
+  Future<void> deleteAll() async {
+    await _box.deleteAll();
+  }
+
+  @override
+  Future<void> delete(String key) async {
+    await _box.delete(key: key);
+  }
+
+  @override
+  Future<bool> containsKey(String key) {
+    return _box.containsKey(key: key);
+  }
+
+  @override
+  Future<String?> read(String key) async {
+    return _box.read(key: key);
+  }
+
+  @override
+  Future<void> write(String key, String value) async {
+    await _box.write(key: key, value: value);
+  }
+
+  @override
+  String get nameImpl => AppSecureStorage.name;
+}

app_services/web/app_services/pubspec.yaml

@@ -0,0 +1,27 @@
+name: app_services
+description: "Базовые сервисы для приложения"
+version: 0.0.1
+publish_to: none
+
+environment:
+  sdk: ^3.6.0
+  flutter: ">=3.24.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+  # Зависимости для сервиса защищенного хранилища
+  flutter_secure_storage: 9.2.4
+
+  # Зависимости для сервиса незащищенного хранилища
+  shared_preferences: 2.3.5
+
+  # Обязательные интерфейсы
+  i_app_services:
+    path: ../../i_app_services
+
+dev_dependencies:
+  friflex_lint_rules:
+    hosted: https://pub.friflex.com
+    version: 4.0.1