init

app_services/i_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/i_app_services/README.md

@@ -0,0 +1 @@
+# Хранит в себе все интерфейсы для реализации общих сервисов

app_services/i_app_services/analysis_options.yaml

@@ -0,0 +1,10 @@
+include: package:friflex_lint_rules/analysis_options.yaml
+
+analyzer:
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+    - "**/*.yaml"
+    - "app_services/aurora/**"
+    - "/app_services/aurora/**"
+    - "**/app_services/aurora/**"

app_services/i_app_services/lib/i_app_services.dart

@@ -0,0 +1,4 @@
+library i_app_services;
+
+export 'src/i_path_provider.dart';
+export 'src/i_secure_storage.dart';

app_services/i_app_services/lib/src/i_debug_service.dart

@@ -0,0 +1,60 @@
+import 'package:flutter/material.dart';
+
+/// Интерфейс для сервиса отладки
+abstract interface class IDebugService {
+  /// Наименование сервиса
+  static const name = 'IDebugService';
+
+  /// Метод для создания обработчика для BLoC
+  Object createBlocObserver();
+
+  /// Метод для создания обработчика для роутера
+  NavigatorObserver createRouterObserver();
+
+  /// Метод для создания обработчика для http-клиентов
+  Object createHttpInterceptor();
+
+  /// Метод для логгирования предупреждений
+  ///
+  /// Принимает:
+  /// - [message] - сообщение для логгирования в формате [String]
+  void warning(String message);
+
+  /// Метод для логгирования ошибок
+  ///
+  /// Принимает:
+  /// - [message] - сообщение для логгирования в формате [String]
+  /// - [exception] - исключение
+  /// - [stackTrace] - стек вызова
+  void error(String message, [Object? exception, StackTrace? stackTrace]);
+
+  /// Метод для обработки ошибок
+  ///
+  /// Принимает:
+  /// - [error] - исключение
+  /// - [stackTrace] - стек вызова
+  /// - [message] - сообщение для логгирования в формате [String]
+  void handleError(Object error, [StackTrace? stackTrace, String? message]);
+
+  /// Метод для логгирования информативных сообщений
+  ///
+  /// Принимает:
+  /// - [message] - сообщение для логгирования в формате [String]
+  void info(String message);
+
+  /// Метод для логгирования сообщений
+  ///
+  /// Принимает:
+  /// - [message] - сообщение для логгирования в формате [String]
+  void log(String message);
+
+  /// Метод для открытия окна отладки
+  ///
+  /// Принимает:
+  /// - [context] - для определения навигатора по нему
+  /// - [useRootNavigator] - при true, открывает окно в корневом навигаторе
+  Future<T?> openDebugScreen<T>(
+    BuildContext context, {
+    bool useRootNavigator = false,
+  });
+}

app_services/i_app_services/lib/src/i_path_provider.dart

@@ -0,0 +1,9 @@
+/// Класс для описания интерфейса сервиса
+/// для получения пути хранения файлов
+abstract interface class IPathProvider {
+  /// Наименования интерфейса
+  static const name = 'IPathProvider';
+
+  /// Получение path на внутренне хранилище приложения
+  Future<String> getAppDocumentsDirectoryPath();
+}

app_services/i_app_services/lib/src/i_secure_storage.dart

@@ -0,0 +1,44 @@
+/// Класс интерфейса для работы с защищенным хранилищем
+abstract interface class ISecureStorage {
+  /// Описывает обязательные параметры имплементаций
+  ///
+  /// Требует:
+  /// - [secretKey] - секретный ключ для шифрования данных
+  const ISecureStorage._({
+    required this.secretKey,
+  });
+
+  /// Секретный ключ для шифрования данных
+  final String secretKey;
+
+  /// Наименования интерфейса
+  static const name = 'ISecureStorage';
+
+  /// Метод для получения значения из защищенного хранилища
+  ///
+  /// Принимает:
+  /// - [key] - ключ
+  Future<String?> read(String key);
+
+  /// Метод для записи значения в защищенное хранилище
+  ///
+  /// Принимает:
+  /// - [key] - ключ
+  /// - [value] - значение
+  Future<void> write(String key, String value);
+
+  /// Метод для удаления значения из защищенного хранилища
+  ///
+  /// Принимает:
+  /// - [key] - ключ
+  Future<void> delete(String key);
+
+  /// Метод для очистки защищенного хранилища
+  Future<void> clear();
+
+  /// Метод для проверки наличия значения в защищенном хранилище
+  ///
+  /// Принимает:
+  /// - [key] - ключ
+  Future<bool> exists(String key);
+}

app_services/i_app_services/pubspec.yaml

@@ -0,0 +1,17 @@
+name: i_app_services
+description: "Хранит в себе все интерфейсы для реализации общих сервисов"
+version: 0.0.1
+publish_to: "none"
+
+environment:
+  sdk: ^3.5.0
+  flutter: ^3.24.0
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+dev_dependencies:
+  friflex_lint_rules:
+    hosted: https://pub.friflex.com
+    version: 4.0.1