fix(authentication): make sur access token is available on every steps

- wyatt_analysis@2.4.0

.drone.yml

@@ -0,0 +1,36 @@
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+# 
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+kind: pipeline
+type: docker
+name: default
+
+steps:
+- name: quality-check
+  image: git.wyatt-studio.fr/wyatt-foss/flutter-melos:2.9.0
+  commands:
+  - melos run quality-check
+  - melos run publish:validate
+- name: publish
+  image: git.wyatt-studio.fr/wyatt-foss/flutter-melos:2.9.0
+  commands:
+  - melos run publish:validate
+
+trigger:
+  branch:
+  - master
+  event:
+  - push

.gitignore

@@ -13,10 +13,6 @@ build/
 # If you're building an application, you may want to check-in your pubspec.lock
 pubspec.lock
 
-# Directory created by dartdoc
-# If you don't generate documentation locally you can remove this line.
-doc/api/
-
 # dotenv environment variables file
 .env*
 
@@ -38,7 +34,6 @@ doc/api/
 
 ### Flutter ###
 # Flutter/Dart/Pub related
-**/doc/api/
 .fvm/
 .pub-cache/
 .pub/
@@ -197,4 +192,7 @@ $RECYCLE.BIN/
 .idea/
 *.iml
 google-services.json
-pubspec_overrides.yaml
+pubspec_overrides.yaml
+
+# Mason
+.mason/

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v2.1.1
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args: [build, ci, docs, feat, fix, perf, refactor, style, test, chore]

CHANGELOG.md

@@ -3,6 +3,179 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 2023-02-07
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_analysis` - `v2.4.0`](#wyatt_analysis---v240)
+
+---
+
+#### `wyatt_analysis` - `v2.4.0`
+
+ - **FEAT**: add new lint rules.
+ - **DOCS**: add instructions to create a new version (closes #104).
+
+
+## 2022-12-13
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_authentication_bloc` - `v0.4.1`](#wyatt_authentication_bloc---v041)
+
+---
+
+#### `wyatt_authentication_bloc` - `v0.4.1`
+
+ - **REFACTOR**: use fromFirebaseUser factory to parse user.
+ - **REFACTOR**: update deps and re-export them.
+ - **FIX**: fix mock on register.
+ - **FEAT**: add google sign in in signIn cubit.
+ - **FEAT**: add google sign in parameter in firebase data source constructor.
+ - **FEAT**: add google sign_in support (closes #59).
+ - **FEAT**: add reauthenticate, updateEmail and updatePassword.
+ - **DOCS**: add correct header.
+
+
+## 2022-12-12
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_analysis` - `v2.3.0`](#wyatt_analysis---v230)
+
+---
+
+#### `wyatt_analysis` - `v2.3.0`
+
+ - **REFACTOR**: follow melos versioning.
+ - **FIX**: change file include to keep coherence.
+ - **FEAT**: exclude generated code, and add dart>2.16 rules.
+ - **FEAT**: add overwrite protection.
+ - **FEAT**: add 2.2.2 files for archive.
+ - **FEAT**: add utils script to easely bump version.
+
+
+## 2022-12-04
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - [`wyatt_bloc_helper` - `v2.0.0`](#wyatt_bloc_helper---v200)
+
+Packages with other changes:
+
+ - [`wyatt_type_utils` - `v0.0.4`](#wyatt_type_utils---v004)
+ - [`wyatt_authentication_bloc` - `v0.4.0+3`](#wyatt_authentication_bloc---v0403)
+ - [`wyatt_crud_bloc` - `v0.1.0+2`](#wyatt_crud_bloc---v0102)
+ - [`wyatt_architecture` - `v0.1.0+1`](#wyatt_architecture---v0101)
+ - [`wyatt_form_bloc` - `v0.2.0+2`](#wyatt_form_bloc---v0202)
+
+Packages with dependency updates only:
+
+> Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
+
+ - `wyatt_authentication_bloc` - `v0.4.0+3`
+ - `wyatt_crud_bloc` - `v0.1.0+2`
+ - `wyatt_architecture` - `v0.1.0+1`
+ - `wyatt_form_bloc` - `v0.2.0+2`
+
+---
+
+#### `wyatt_bloc_helper` - `v2.0.0`
+
+ - **BREAKING** **REFACTOR**: update onWrap label (close #46).
+
+#### `wyatt_type_utils` - `v0.0.4`
+
+ - **FEAT**: add Result extension on FutureOr type (close #40).
+
+
+## 2022-12-03
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - [`wyatt_architecture` - `v0.1.0`](#wyatt_architecture---v010)
+
+Packages with other changes:
+
+ - [`wyatt_authentication_bloc` - `v0.4.0+2`](#wyatt_authentication_bloc---v0402)
+ - [`wyatt_crud_bloc` - `v0.1.0+1`](#wyatt_crud_bloc---v0101)
+ - [`wyatt_form_bloc` - `v0.2.0+1`](#wyatt_form_bloc---v0201)
+
+Packages with dependency updates only:
+
+> Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
+
+ - `wyatt_authentication_bloc` - `v0.4.0+2`
+ - `wyatt_crud_bloc` - `v0.1.0+1`
+ - `wyatt_form_bloc` - `v0.2.0+1`
+
+---
+
+#### `wyatt_architecture` - `v0.1.0`
+
+ - **REFACTOR**: update naming methodes (close #47).
+ - **REFACTOR**: update example. (close #38).
+ - **FIX**: fix execute method on error handler. (#38).
+ - **FEAT**: update usecase en add  &  sepcific case. (#38).
+ - **FEAT**: add obsevers for alternative usecase scenarions (#38).
+ - **DOCS**: generate class model. (#38).
+ - **DOCS**: update Readme. (#38).
+ - **BREAKING** **CHORE**: update exports. (#38).
+
+
+## 2022-11-16
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_authentication_bloc` - `v0.4.0+1`](#wyatt_authentication_bloc---v0401)
+
+---
+
+#### `wyatt_authentication_bloc` - `v0.4.0+1`
+
+ - **FIX**: add sort of mutex on onAuthChanges callback trigger.
+
+
 ## 2022-11-16
 
 ### Changes

README.md

@@ -1,17 +1,17 @@
 <!--
  * Copyright (C) 2022 WYATT GROUP
  * Please see the AUTHORS file for details.
- * 
+ *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * any later version.
- * 
+ *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  * GNU General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
 -->
@@ -51,39 +51,54 @@ and open source.
 
 ---
 
-## Development
+## Contribution
 
 Clone this repo.
 
-You have to install [melos](https://github.com/invertase/melos).
+```shell
+git clone ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-packages.git
+```
+
+### Prerequisite
+
+- [Flutter](https://github.com/flutter/flutter).
+
+- [Melos](https://github.com/invertase/melos). Used to manage Dart projects with multiple packages.
 
 ```shell
 dart pub global activate melos
 ```
 
-Then bootstrap with `melos bs`.
+- [Mason](https://github.com/felangel/mason). Used for code generation.
+
+```shell
+dart pub global activate mason_cli
+```
+
+- [Lcov](https://github.com/linux-test-project/lcov). Used to generate coverage data.
+
+```shell
+# on macos
+brew install lcov
+```
+
+- genhtml. Used to convert coverage data into html pages.
+
+After installing all these packages, bootstrap with `melos bs`.
 
 ### Create a new package
 
 Create a new package in `packages/` folder.
 
 ```shell
-dart create -t package-simple wyatt_<name>
-```
-
-Remove any `example/` subfolder. Then create a new sample project.
-
-```shell
-flutter create --platforms android --project-name <name>_example example
+mason make wyatt_package --package_name  wyatt_<name> --description A new Wyatt package --flutter_only false
 ```
 
 Then bootstrap project with `melos bs` command.
 
-### Convention
-
 #### Naming
 
-In the previous instructions `<name>` variable is important. 
+In the previous instructions `<name>` variable is important.
 It have to be clear and intelligible.
 
 You **MUST** use underscores.
@@ -93,15 +108,44 @@ You **MUST** use `wyatt` prefix for package.
 You **MUST** name example with specific name.
 
 For example, if name is CRUD BLOC
+
 - name will be crud_bloc
 - so the package will be: `wyatt_crud_bloc`
 - and the example will be: `crud_bloc_example`
 
-#### Commits
+### Create issues
+
+Add the issues directly related to what you want to develop and label them correctly.
+
+```
+Type(scope): issue.
+```
+
+For example, on notification bloc package :
+
+- `Feature(notification_bloc): add firebase messaging data source.`
+- `Test(notification_bloc): add test for pushwoosh datasource.`
+
+### Branches
+
+Master is protected. You can't push on it. Please develop your feature on another branch. The name of your branch has to match with the issue opened.
+
+`type(scope):issue`
+
+Example :
+Issue :
+
+- `Feature(notification_bloc): add firebase messaging data source.`
+
+Branch related to this issue :
+
+- `feature(notification_bloc)/add_firebase_messaging_data_source`
+
+### Commits
 
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-tl;dr : `type(scope): description`.
+tl;dr : `type(scope): description #issue`.
 Here allowed <type> values:
 
 - **feat** for a new feature for the user, not a new feature for build script. Such commit will trigger a release bumping a MINOR version.
@@ -115,11 +159,74 @@ Here allowed <type> values:
 
 Some examples :
 
-- `feat(auth): add AWS support.` = add a feature in authentication_bloc package.
+- `feat(auth): add AWS support. (#31)` = add a feature in authentication_bloc package, linked to the 31st issue.
 - `docs: update readme.` = update **this** readme file.
-- `fix(crud)!: fix bug in awesome() function.` = fix a bug, `!` is important and indicate `BREAKING CHANGES`.
+- `fix(crud)!: fix bug in awesome() function. (#32)` = fix a bug, `!` is important and indicate `BREAKING CHANGES` linked with the 32nd issue.
 
-Conventional commits are important for `melos version` command !
+When you have finished developing, and are ready to close the issue, close it via your commit :
+
+`feat(auth): add AWS support. (close #31)`
+
+Note that your issue will be close after merging on master.
+Before closing the issue, please check tests and update coverage. You might run :
+
+```shell
+melos run test:all # this will run all tests in this project
+melos run gen-coverage # this will generate coverage report
+melos run gen-class-models # this will generate plantuml class diagrams
+melos run quality-check # this will run all targets generally expected in CI
+melos run publish:validate # this will run a validation before publish packages
+melos run publish # this will publish packages
+```
+
+> Note that only modified package will be verified and published.
+
+#### Merge your work
+
+After closing your issue, some work may have been done on master in the meantime. To keep a clean git history, please rebase before opening a change request.
+
+Two situations :
+
+- You have not yet created your branch and have committed locally :
+
+```shell
+git pull --rebase
+```
+
+- You are already working on your branch :
+
+```shell
+git rebase -i master
+```
+
+If possible, please use `--fixup` on your commit in interactive rebase.
+
+Then, opend your PR, get the necessary approval and merge your work. Then you're done ✅.
+
+#### Update version.
+
+Once your work is on the master, you can update your package version. Please filter packages to update only your package. `--scope` is used to do it.
+For example, after merging changes on `wyatt_otification_bloc` package, you might run :
+
+```shell
+melos version --scope="*wyatt_notification_bloc*"
+```
+
+In fact, melos will filter all packages that match the `wyatt_notification_block` pattern.
+
+You can update check all packages tests by running :
+
+```shell
+melos run test
+```
+
+#### Publish your package
+
+If package is ready for procution, publish it runnig :
+
+```shell
+melos publish --scope"*package*"
+```
 
 #### Badging
 
@@ -130,7 +237,8 @@ In the package `readme.md` file, please specify the supported SDK:
 ```markdown
 ![SDK: Dart & Flutter](https://img.shields.io/badge/SDK-Dart%20%7C%20Flutter-blue?style=flat-square)
 ```
-or 
+
+or
 
 ![SDK: Dart](https://img.shields.io/badge/SDK-Dart-blue?style=flat-square)
 
@@ -161,4 +269,10 @@ Here you can change `package name` and `package version`.
 
 ![Status: Experimental](https://img.shields.io/badge/Status-WIP-red?style=flat-square)
 
-This repository is maintained by Wyatt Studio but work is in progress.
+This repository is maintained by Wyatt Studio but work is in progress.
+
+## Simple work flow diagramm
+
+To sum up, here a simple work flow diagramm.
+
+![Dev Wokflow](doc/workflow.svg)

combine_coverage.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+escapedPath="$(echo `pwd` | sed 's/\//\\\//g')"
+
+if grep flutter pubspec.yaml > /dev/null; then
+  if [ -d "coverage" ]; then
+    # combine line coverage info from package tests to a common file
+    if [ ! -d "$MELOS_ROOT_PATH/coverage" ]; then
+      mkdir "$MELOS_ROOT_PATH/coverage"
+    fi
+    sed "s/^SF:lib/SF:$escapedPath\/lib/g" coverage/lcov.info >> "$MELOS_ROOT_PATH/coverage/lcov.info"
+    rm -rf "coverage"
+  fi
+fi

doc/work_flow.puml

@@ -0,0 +1,15 @@
+@startuml Simple Developpment Workflow
+start
+:Create an issue;
+:Create branch related to the issue;
+repeat :Commit related to the issue;
+repeat while (feature is done)
+:Update coverage;
+:Close issue via last commit;
+:Rebase from `master`;
+:Create pull request;
+:Merge branches;
+:Update version;
+:Publish package;
+stop
+@enduml

mason-lock.json

@@ -0,0 +1 @@
+{"bricks":{"wyatt_clean_code":{"git":{"url":"ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git","path":"bricks/wyatt_clean_code","ref":"5009f1ef21d8531b773298c0fc08704d8f69afd1"}},"wyatt_feature_brick":{"git":{"url":"ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git","path":"bricks/wyatt_feature_brick","ref":"5009f1ef21d8531b773298c0fc08704d8f69afd1"}},"wyatt_package_template":{"git":{"url":"ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git","path":"bricks/wyatt_package_template","ref":"5009f1ef21d8531b773298c0fc08704d8f69afd1"}}}}

mason.yaml

@@ -0,0 +1,13 @@
+bricks:
+  wyatt_clean_code:
+    git:
+      url: "ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git"
+      path: bricks/wyatt_clean_code
+  wyatt_feature_brick:
+    git:
+      url: "ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git"
+      path: bricks/wyatt_feature_brick
+  wyatt_package_template:
+    git:
+      url: "ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git"
+      path: bricks/wyatt_package_template

melos.yaml

@@ -21,8 +21,7 @@ scripts:
 
   analyze:
     run: |
-      melos exec -c 10 -- \
-        flutter analyze --fatal-infos
+      melos exec -c 1 -- flutter analyze --fatal-infos
     description: Run `flutter analyze` for all packages.
 
   format:
@@ -36,6 +35,40 @@ scripts:
   clean:deep:
     run: git clean -x -d -f -q
     description: Clean things very deeply with `git clean`.
+
+  test:selective_unit_test:
+    run: melos exec -- flutter test --no-pub --coverage
+    description: Run Flutter tests for a specific package in this project.
+    select-package:
+      dir-exists:
+        - test
+      ignore:
+        - '*example*'
+
+  test:all:
+    run: melos run test:selective_unit_test --no-select
+    description: Run all Flutter tests in this project.
+
+  gen-coverage: melos exec -- sh "\$MELOS_ROOT_PATH/combine_coverage.sh" && genhtml coverage/lcov.info -o coverage/html
+
+  gen-class-models: 
+    run: melos exec -- dart pub global run dcdg -o models/class-models.puml
+    select-package:
+      ignore:
+        - '*example*'
+
+  quality-check:
+    run: |
+      melos clean && \
+      melos bootstrap && \
+      melos run test:all
+    description: Run all targets generally expected in CI for a full local quality check.
+
+  publish:validate:
+    run: melos publish --diff="origin/$DRONE_COMMIT_BRANCH...HEAD" --yes
+  
+  # publish:
+  #   run: melos publish --diff="origin/$DRONE_COMMIT_BRANCH...HEAD" --no-dry-run --yes
   
   # Additional cleanup lifecycle script, executed when `melos clean` is run.
   postclean: >

packages/wyatt_analysis/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 2.4.0
+
+ - **FEAT**: add new lint rules.
+ - **DOCS**: add instructions to create a new version (closes #104).
+
+## 2.3.0
+
+ - **REFACTOR**: follow melos versioning.
+ - **FIX**: change file include to keep coherence.
+ - **FEAT**: exclude generated code, and add dart>2.16 rules.
+ - **FEAT**: add overwrite protection.
+ - **FEAT**: add 2.2.2 files for archive.
+ - **FEAT**: add utils script to easely bump version.
+
 ## 2.2.2
 
  - **DOCS**: add publish_to self hosted pub server.

packages/wyatt_analysis/README.md

@@ -1,5 +1,5 @@
 <!--
- * Copyright (C) 2022 WYATT GROUP
+ * Copyright (C) 2023 WYATT GROUP
  * Please see the AUTHORS file for details.
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -7,7 +7,7 @@
  * the Free Software Foundation, either version 3 of the License, or
  * any later version.
  * 
- * This program is distributed in the hope that it will be useful,
+ * This program is distributed in the hope that it will be useful, 
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  * GNU General Public License for more details.
@@ -20,24 +20,21 @@
 
 ![SDK: Dart & Flutter](https://img.shields.io/badge/SDK-Dart%20%7C%20Flutter-blue?style=flat-square)
 
-This package provides lint rules for Dart and Flutter which are used at [Wyatt](https://wyattapp.io) and [Wyatt Studio](https://wyatt-studio.fr). For more information, see the complete list of options in **lib/analysis_options.2.0.0.yaml**.
+This package provides lint rules for Dart and Flutter which are used at [Wyatt](https://wyattapp.io) and [Wyatt Studio](https://wyatt-studio.fr). For more information, see the complete list of options in **lib/analysis_options.2.4.0.yaml**.
 
 **Note**: This package was heavily inspired by [pedantic](https://github.com/dart-lang/pedantic), [Very Good Analysis](https://github.com/VeryGoodOpenSource/very_good_analysis) and the official [flutter_lints](https://pub.dev/packages/flutter_lints).
 
 ## Usage
 
-To use the lints, add a dependency in your `pubspec.yaml`:
+To use the lints, add a dependency in your `pubspec.yaml` :
 
 ```yaml
-dev_dependencies:
-  wyatt_analysis:
-    git:
-      url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.0.0
-      path: packages/wyatt_analysis
+wyatt_analysis:
+    hosted: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub/
+    version: 2.4.0
 ```
 
-Then, add an include in `analysis_options.yaml`:
+Then, add an include in `analysis_options.yaml` :
 
 ```yaml
 include: package:wyatt_analysis/analysis_options.yaml
@@ -52,13 +49,13 @@ include: package:wyatt_analysis/analysis_options.flutter.yaml
 If you wish to restrict the lint version, specify a version of `analysis_options.yaml` instead:
 
 ```yaml
-include: package:wyatt_analysis/analysis_options.flutter.2.0.0.yaml
+include: package:wyatt_analysis/analysis_options.flutter.2.4.0.yaml
 ```
 
 If you just want **Dart** version:
 
 ```yaml
-include: package:wyatt_analysis/analysis_options.2.0.0.yaml
+include: package:wyatt_analysis/analysis_options.2.4.0.yaml
 ```
 
 ## Suppressing Lints
@@ -90,7 +87,7 @@ class B {}
 
 ### Project Level
 
-To surpress a specific lint rule for an entire project, modify `analysis_options.yaml`:
+To surpress a specific lint rule for an entire project, modify `analysis_options.yaml` :
 
 ```yaml
 include: package:wyatt_analysis/analysis_options.yaml
@@ -107,6 +104,16 @@ To indicate your project is using `wyatt_analysis` → [![style: wyatt analysis]
 [![style: wyatt analysis](https://img.shields.io/badge/Style-Wyatt%20Analysis-blue)](https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_analysis)
 ```
 
+## Development
+
+When you want to create a new version of the plugin. Before any modification, execute the following command to create new files:
+
+```sh
+./new_version.sh <previous_version> <new_version>
+```
+> Where `<previous_version>` is 2.4.0
+
+
 ## Notes
 
-You can explore every lint rules [here](https://dart-lang.github.io/linter/lints/).
+You can explore every lint rules [here](https://dart-lang.github.io/linter/lints/).

packages/wyatt_analysis/lib/analysis_options.2.2.2.yaml

@@ -0,0 +1,206 @@
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+analyzer:
+  language:
+    strict-casts: true
+    strict-inference: true
+    strict-raw-types: true
+
+  errors:
+    todo: ignore
+    close_sinks: ignore
+    missing_required_param: error
+    missing_return: error
+
+  exclude:
+    - example/**
+    - lib/l10n/**
+    - lib/generated/**
+    - lib/generated_plugin_registrant.dart
+    - test/.test_coverage.dart
+
+linter:
+  rules:
+    - always_declare_return_types
+    - always_require_non_null_named_parameters
+    - always_put_control_body_on_new_line
+    - always_put_required_named_parameters_first
+    - always_use_package_imports
+    - annotate_overrides
+    - avoid_bool_literals_in_conditional_expressions
+    - avoid_catching_errors
+    - avoid_double_and_int_checks
+    - avoid_dynamic_calls
+    - avoid_empty_else
+    - avoid_equals_and_hash_code_on_mutable_classes
+    - avoid_escaping_inner_quotes
+    - avoid_field_initializers_in_const_classes
+    - avoid_function_literals_in_foreach_calls
+    - avoid_init_to_null
+    - avoid_js_rounded_ints
+    - avoid_null_checks_in_equality_operators
+    - avoid_positional_boolean_parameters
+    - avoid_private_typedef_functions
+    - avoid_redundant_argument_values
+    - avoid_relative_lib_imports
+    - avoid_renaming_method_parameters
+    - avoid_return_types_on_setters
+    - avoid_returning_null
+    - avoid_returning_null_for_future
+    - avoid_returning_null_for_void
+    - avoid_returning_this
+    - avoid_setters_without_getters
+    - avoid_shadowing_type_parameters
+    - avoid_single_cascade_in_expression_statements
+    - avoid_slow_async_io
+    - avoid_type_to_string
+    - avoid_types_as_parameter_names
+    - avoid_types_on_closure_parameters
+    - avoid_unused_constructor_parameters
+    - avoid_void_async
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - cancel_subscriptions
+    - cascade_invocations
+    - cast_nullable_to_non_nullable
+    - comment_references
+    - conditional_uri_does_not_exist
+    - constant_identifier_names
+    - control_flow_in_finally
+    - curly_braces_in_flow_control_structures
+    - depend_on_referenced_packages
+    - deprecated_consistency
+    - directives_ordering
+    - empty_catches
+    - empty_constructor_bodies
+    - empty_statements
+    - eol_at_end_of_file
+    - exhaustive_cases
+    - file_names
+    - flutter_style_todos
+    - hash_and_equals
+    - implementation_imports
+    - iterable_contains_unrelated_type
+    - join_return_with_assignment
+    - leading_newlines_in_multiline_strings
+    - library_names
+    - library_prefixes
+    - library_private_types_in_public_api
+    - lines_longer_than_80_chars
+    - list_remove_unrelated_type
+    - literal_only_boolean_expressions
+    - missing_whitespace_between_adjacent_strings
+    - no_adjacent_strings_in_list
+    - no_default_cases
+    - no_duplicate_case_values
+    - no_leading_underscores_for_local_identifiers
+    - no_runtimeType_toString
+    - non_constant_identifier_names
+    - noop_primitive_operations
+    - null_check_on_nullable_type_parameter
+    - null_closures
+    - one_member_abstracts
+    - only_throw_errors
+    - overridden_fields
+    - package_api_docs
+    - package_names
+    - package_prefixed_library_names
+    - parameter_assignments
+    - prefer_adjacent_string_concatenation
+    - prefer_asserts_in_initializer_lists
+    - prefer_asserts_with_message
+    - prefer_collection_literals
+    - prefer_conditional_assignment
+    - prefer_const_constructors
+    - prefer_const_constructors_in_immutables
+    - prefer_const_declarations
+    - prefer_const_literals_to_create_immutables
+    - prefer_constructors_over_static_methods
+    - prefer_contains
+    - prefer_equal_for_default_values
+    - prefer_expression_function_bodies
+    - prefer_final_fields
+    - prefer_final_in_for_each
+    - prefer_final_locals
+    - prefer_for_elements_to_map_fromIterable
+    - prefer_function_declarations_over_variables
+    - prefer_generic_function_type_aliases
+    - prefer_if_elements_to_conditional_expressions
+    - prefer_if_null_operators
+    - prefer_initializing_formals
+    - prefer_inlined_adds
+    - prefer_int_literals
+    - prefer_interpolation_to_compose_strings
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_is_not_operator
+    - prefer_iterable_whereType
+    - prefer_mixin
+    - prefer_null_aware_operators
+    - prefer_null_aware_method_calls
+    - prefer_single_quotes
+    - prefer_spread_collections
+    - prefer_typing_uninitialized_variables
+    - prefer_void_to_null
+    - provide_deprecation_message
+    - recursive_getters
+    - require_trailing_commas
+    - slash_for_doc_comments
+    - sort_unnamed_constructors_first
+    - test_types_in_equals
+    - throw_in_finally
+    - tighten_type_of_initializing_formals
+    - type_annotate_public_apis
+    - type_init_formals
+    - unawaited_futures
+    - unnecessary_await_in_return
+    - unnecessary_brace_in_string_interps
+    - unnecessary_const
+    - unnecessary_constructor_name
+    - unnecessary_getters_setters
+    - unnecessary_lambdas
+    - unnecessary_late
+    - unnecessary_new
+    - unnecessary_null_aware_assignments
+    - unnecessary_null_checks
+    - unnecessary_null_in_if_null_operators
+    - unnecessary_nullable_for_final_variable_declarations
+    - unnecessary_overrides
+    - unnecessary_parenthesis
+    - unnecessary_raw_strings
+    - unnecessary_statements
+    - unnecessary_string_escapes
+    - unnecessary_string_interpolations
+    - unnecessary_this
+    - unrelated_type_equality_checks
+    - unsafe_html
+    - use_enums
+    - use_function_type_syntax_for_parameters
+    - use_if_null_to_convert_nulls_to_bools
+    - use_is_even_rather_than_modulo
+    - use_late_for_private_fields_and_variables
+    - use_named_constants
+    - use_raw_strings
+    - use_rethrow_when_possible
+    - use_setters_to_change_properties
+    - use_string_buffers
+    - use_super_parameters
+    - use_test_throws_matchers
+    - use_to_and_as_if_applicable
+    - valid_regexps
+    - void_checks

packages/wyatt_analysis/lib/analysis_options.2.3.0.yaml

@@ -0,0 +1,213 @@
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+analyzer:
+  language:
+    strict-casts: true
+    strict-inference: true
+    strict-raw-types: true
+
+  errors:
+    todo: info
+    close_sinks: ignore
+    missing_required_param: error
+    missing_return: error
+
+  exclude:
+    - lib/l10n/**
+    - lib/generated/**
+    - lib/gen/**
+    - lib/generated_plugin_registrant.dart
+    - test/.test_coverage.dart
+    - '**/*.g.dart'
+    - '**/*.freezed.dart'
+
+linter:
+  rules:
+    - always_declare_return_types
+    - always_put_control_body_on_new_line
+    - always_put_required_named_parameters_first
+    - always_require_non_null_named_parameters
+    - always_use_package_imports
+    - annotate_overrides
+    - avoid_bool_literals_in_conditional_expressions
+    - avoid_catching_errors
+    - avoid_double_and_int_checks
+    - avoid_dynamic_calls
+    - avoid_empty_else
+    - avoid_equals_and_hash_code_on_mutable_classes
+    - avoid_escaping_inner_quotes
+    - avoid_field_initializers_in_const_classes
+    - avoid_final_parameters
+    - avoid_function_literals_in_foreach_calls
+    - avoid_init_to_null
+    - avoid_js_rounded_ints
+    - avoid_multiple_declarations_per_line
+    - avoid_null_checks_in_equality_operators
+    - avoid_positional_boolean_parameters
+    - avoid_private_typedef_functions
+    - avoid_redundant_argument_values
+    - avoid_relative_lib_imports
+    - avoid_renaming_method_parameters
+    - avoid_return_types_on_setters
+    - avoid_returning_null
+    - avoid_returning_null_for_future
+    - avoid_returning_null_for_void
+    - avoid_returning_this
+    - avoid_setters_without_getters
+    - avoid_shadowing_type_parameters
+    - avoid_single_cascade_in_expression_statements
+    - avoid_slow_async_io
+    - avoid_type_to_string
+    - avoid_types_as_parameter_names
+    - avoid_types_on_closure_parameters
+    - avoid_unused_constructor_parameters
+    - avoid_void_async
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - cancel_subscriptions
+    - cascade_invocations
+    - cast_nullable_to_non_nullable
+    - comment_references
+    - conditional_uri_does_not_exist
+    - constant_identifier_names
+    - control_flow_in_finally
+    - curly_braces_in_flow_control_structures
+    - depend_on_referenced_packages
+    - deprecated_consistency
+    - directives_ordering
+    - empty_catches
+    - empty_constructor_bodies
+    - empty_statements
+    - eol_at_end_of_file
+    - exhaustive_cases
+    - file_names
+    - flutter_style_todos
+    - hash_and_equals
+    - implementation_imports
+    - iterable_contains_unrelated_type
+    - join_return_with_assignment
+    - leading_newlines_in_multiline_strings
+    - library_names
+    - library_prefixes
+    - library_private_types_in_public_api
+    - lines_longer_than_80_chars
+    - list_remove_unrelated_type
+    - literal_only_boolean_expressions
+    - missing_whitespace_between_adjacent_strings
+    - no_adjacent_strings_in_list
+    - no_default_cases
+    - no_duplicate_case_values
+    - no_leading_underscores_for_library_prefixes
+    - no_leading_underscores_for_local_identifiers
+    - no_runtimeType_toString
+    - non_constant_identifier_names
+    - noop_primitive_operations
+    - null_check_on_nullable_type_parameter
+    - null_closures
+    - one_member_abstracts
+    - only_throw_errors
+    - overridden_fields
+    - package_api_docs
+    - package_names
+    - package_prefixed_library_names
+    - parameter_assignments
+    - prefer_adjacent_string_concatenation
+    - prefer_asserts_in_initializer_lists
+    - prefer_asserts_with_message
+    - prefer_collection_literals
+    - prefer_conditional_assignment
+    - prefer_const_constructors
+    - prefer_const_constructors_in_immutables
+    - prefer_const_declarations
+    - prefer_const_literals_to_create_immutables
+    - prefer_constructors_over_static_methods
+    - prefer_contains
+    - prefer_equal_for_default_values
+    - prefer_expression_function_bodies
+    - prefer_final_fields
+    - prefer_final_in_for_each
+    - prefer_final_locals
+    - prefer_for_elements_to_map_fromIterable
+    - prefer_function_declarations_over_variables
+    - prefer_generic_function_type_aliases
+    - prefer_if_elements_to_conditional_expressions
+    - prefer_if_null_operators
+    - prefer_initializing_formals
+    - prefer_inlined_adds
+    - prefer_int_literals
+    - prefer_interpolation_to_compose_strings
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_is_not_operator
+    - prefer_iterable_whereType
+    - prefer_mixin
+    - prefer_null_aware_method_calls
+    - prefer_null_aware_operators
+    - prefer_single_quotes
+    - prefer_spread_collections
+    - prefer_typing_uninitialized_variables
+    - prefer_void_to_null
+    - provide_deprecation_message
+    - recursive_getters
+    - require_trailing_commas
+    - slash_for_doc_comments
+    - sort_constructors_first
+    - sort_unnamed_constructors_first
+    - test_types_in_equals
+    - throw_in_finally
+    - tighten_type_of_initializing_formals
+    - type_annotate_public_apis
+    - type_init_formals
+    - unawaited_futures
+    - unnecessary_await_in_return
+    - unnecessary_brace_in_string_interps
+    - unnecessary_const
+    - unnecessary_constructor_name
+    - unnecessary_getters_setters
+    - unnecessary_lambdas
+    - unnecessary_late
+    - unnecessary_new
+    - unnecessary_null_aware_assignments
+    - unnecessary_null_checks
+    - unnecessary_null_in_if_null_operators
+    - unnecessary_nullable_for_final_variable_declarations
+    - unnecessary_overrides
+    - unnecessary_parenthesis
+    - unnecessary_raw_strings
+    - unnecessary_statements
+    - unnecessary_string_escapes
+    - unnecessary_string_interpolations
+    - unnecessary_this
+    - unnecessary_to_list_in_spreads
+    - unrelated_type_equality_checks
+    - unsafe_html
+    - use_enums
+    - use_function_type_syntax_for_parameters
+    - use_if_null_to_convert_nulls_to_bools
+    - use_is_even_rather_than_modulo
+    - use_late_for_private_fields_and_variables
+    - use_named_constants
+    - use_raw_strings
+    - use_rethrow_when_possible
+    - use_setters_to_change_properties
+    - use_string_buffers
+    - use_super_parameters
+    - use_test_throws_matchers
+    - use_to_and_as_if_applicable
+    - valid_regexps
+    - void_checks

packages/wyatt_analysis/lib/analysis_options.2.4.0.yaml

@@ -0,0 +1,217 @@
+# Copyright (C) 2023 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+analyzer:
+  language:
+    strict-casts: true
+    strict-inference: true
+    strict-raw-types: true
+
+  errors:
+    todo: info
+    close_sinks: ignore
+    missing_required_param: error
+    missing_return: error
+
+  exclude:
+    - lib/l10n/**
+    - lib/generated/**
+    - lib/gen/**
+    - lib/generated_plugin_registrant.dart
+    - test/.test_coverage.dart
+    - '**/*.g.dart'
+    - '**/*.freezed.dart'
+
+linter:
+  rules:
+    - always_declare_return_types
+    - always_put_control_body_on_new_line
+    - always_put_required_named_parameters_first
+    - always_require_non_null_named_parameters
+    - always_use_package_imports
+    - annotate_overrides
+    - avoid_bool_literals_in_conditional_expressions
+    - avoid_catching_errors
+    - avoid_double_and_int_checks
+    - avoid_dynamic_calls
+    - avoid_empty_else
+    - avoid_equals_and_hash_code_on_mutable_classes
+    - avoid_escaping_inner_quotes
+    - avoid_field_initializers_in_const_classes
+    - avoid_final_parameters
+    - avoid_function_literals_in_foreach_calls
+    - avoid_init_to_null
+    - avoid_js_rounded_ints
+    - avoid_multiple_declarations_per_line
+    - avoid_null_checks_in_equality_operators
+    - avoid_positional_boolean_parameters
+    - avoid_private_typedef_functions
+    - avoid_redundant_argument_values
+    - avoid_relative_lib_imports
+    - avoid_renaming_method_parameters
+    - avoid_return_types_on_setters
+    - avoid_returning_null
+    - avoid_returning_null_for_future
+    - avoid_returning_null_for_void
+    - avoid_returning_this
+    - avoid_setters_without_getters
+    - avoid_shadowing_type_parameters
+    - avoid_single_cascade_in_expression_statements
+    - avoid_slow_async_io
+    - avoid_type_to_string
+    - avoid_types_as_parameter_names
+    - avoid_types_on_closure_parameters
+    - avoid_unused_constructor_parameters
+    - avoid_void_async
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - cancel_subscriptions
+    - cascade_invocations
+    - cast_nullable_to_non_nullable
+    - collection_methods_unrelated_type
+    - combinators_ordering
+    - comment_references
+    - conditional_uri_does_not_exist
+    - constant_identifier_names
+    - control_flow_in_finally
+    - curly_braces_in_flow_control_structures
+    - depend_on_referenced_packages
+    - deprecated_consistency
+    - directives_ordering
+    - empty_catches
+    - empty_constructor_bodies
+    - empty_statements
+    - eol_at_end_of_file
+    - exhaustive_cases
+    - file_names
+    - flutter_style_todos
+    - hash_and_equals
+    - implementation_imports
+    - implicit_call_tearoffs
+    - iterable_contains_unrelated_type
+    - join_return_with_assignment
+    - leading_newlines_in_multiline_strings
+    - library_names
+    - library_prefixes
+    - library_private_types_in_public_api
+    - lines_longer_than_80_chars
+    - list_remove_unrelated_type
+    - literal_only_boolean_expressions
+    - missing_whitespace_between_adjacent_strings
+    - no_adjacent_strings_in_list
+    - no_default_cases
+    - no_duplicate_case_values
+    - no_leading_underscores_for_library_prefixes
+    - no_leading_underscores_for_local_identifiers
+    - no_runtimeType_toString
+    - non_constant_identifier_names
+    - noop_primitive_operations
+    - null_check_on_nullable_type_parameter
+    - null_closures
+    - one_member_abstracts
+    - only_throw_errors
+    - overridden_fields
+    - package_api_docs
+    - package_names
+    - package_prefixed_library_names
+    - parameter_assignments
+    - prefer_adjacent_string_concatenation
+    - prefer_asserts_in_initializer_lists
+    - prefer_asserts_with_message
+    - prefer_collection_literals
+    - prefer_conditional_assignment
+    - prefer_const_constructors
+    - prefer_const_constructors_in_immutables
+    - prefer_const_declarations
+    - prefer_const_literals_to_create_immutables
+    - prefer_constructors_over_static_methods
+    - prefer_contains
+    - prefer_equal_for_default_values
+    - prefer_expression_function_bodies
+    - prefer_final_fields
+    - prefer_final_in_for_each
+    - prefer_final_locals
+    - prefer_for_elements_to_map_fromIterable
+    - prefer_function_declarations_over_variables
+    - prefer_generic_function_type_aliases
+    - prefer_if_elements_to_conditional_expressions
+    - prefer_if_null_operators
+    - prefer_initializing_formals
+    - prefer_inlined_adds
+    - prefer_int_literals
+    - prefer_interpolation_to_compose_strings
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_is_not_operator
+    - prefer_iterable_whereType
+    - prefer_mixin
+    - prefer_null_aware_method_calls
+    - prefer_null_aware_operators
+    - prefer_single_quotes
+    - prefer_spread_collections
+    - prefer_typing_uninitialized_variables
+    - prefer_void_to_null
+    - provide_deprecation_message
+    - recursive_getters
+    - require_trailing_commas
+    - slash_for_doc_comments
+    - sort_constructors_first
+    - sort_unnamed_constructors_first
+    - test_types_in_equals
+    - throw_in_finally
+    - tighten_type_of_initializing_formals
+    - type_annotate_public_apis
+    - type_init_formals
+    - unawaited_futures
+    - unnecessary_await_in_return
+    - unnecessary_brace_in_string_interps
+    - unnecessary_const
+    - unnecessary_constructor_name
+    - unnecessary_getters_setters
+    - unnecessary_lambdas
+    - unnecessary_late
+    - unnecessary_new
+    - unnecessary_null_aware_assignments
+    - unnecessary_null_checks
+    - unnecessary_null_in_if_null_operators
+    - unnecessary_nullable_for_final_variable_declarations
+    - unnecessary_overrides
+    - unnecessary_parenthesis
+    - unnecessary_raw_strings
+    - unnecessary_statements
+    - unnecessary_string_escapes
+    - unnecessary_string_interpolations
+    - unnecessary_this
+    - unnecessary_to_list_in_spreads
+    - unrelated_type_equality_checks
+    - unsafe_html
+    - use_enums
+    - use_function_type_syntax_for_parameters
+    - use_if_null_to_convert_nulls_to_bools
+    - use_is_even_rather_than_modulo
+    - use_late_for_private_fields_and_variables
+    - use_named_constants
+    - use_raw_strings
+    - use_rethrow_when_possible
+    - use_setters_to_change_properties
+    - use_string_buffers
+    - use_string_in_part_of_directives
+    - use_super_parameters
+    - use_test_throws_matchers
+    - use_to_and_as_if_applicable
+    - valid_regexps
+    - void_checks

packages/wyatt_analysis/lib/analysis_options.flutter.2.2.0.yaml

@@ -14,7 +14,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-include: package:wyatt_analysis/analysis_options.2.1.1.yaml
+include: package:wyatt_analysis/analysis_options.2.2.0.yaml
 
 linter:
   rules:

packages/wyatt_analysis/lib/analysis_options.flutter.2.2.2.yaml

@@ -0,0 +1,32 @@
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include: package:wyatt_analysis/analysis_options.2.2.2.yaml
+
+linter:
+  rules:
+    - avoid_print
+    - avoid_unnecessary_containers
+    - avoid_web_libraries_in_flutter
+    - no_logic_in_create_state
+    - sized_box_for_whitespace
+    - sized_box_shrink_expand
+    - sort_child_properties_last
+    - use_build_context_synchronously
+    - use_colored_box
+    - use_decorated_box
+    - use_full_hex_values_for_flutter_colors
+    - use_key_in_widget_constructors

packages/wyatt_analysis/lib/analysis_options.flutter.2.3.0.yaml

@@ -0,0 +1,32 @@
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include: package:wyatt_analysis/analysis_options.2.3.0.yaml
+
+linter:
+  rules:
+    - avoid_print
+    - avoid_unnecessary_containers
+    - avoid_web_libraries_in_flutter
+    - no_logic_in_create_state
+    - sized_box_for_whitespace
+    - sized_box_shrink_expand
+    - sort_child_properties_last
+    - use_build_context_synchronously
+    - use_colored_box
+    - use_decorated_box
+    - use_full_hex_values_for_flutter_colors
+    - use_key_in_widget_constructors

packages/wyatt_analysis/lib/analysis_options.flutter.2.4.0.yaml

@@ -0,0 +1,32 @@
+# Copyright (C) 2023 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include: package:wyatt_analysis/analysis_options.2.4.0.yaml
+
+linter:
+  rules:
+    - avoid_print
+    - avoid_unnecessary_containers
+    - avoid_web_libraries_in_flutter
+    - no_logic_in_create_state
+    - sized_box_for_whitespace
+    - sized_box_shrink_expand
+    - sort_child_properties_last
+    - use_build_context_synchronously
+    - use_colored_box
+    - use_decorated_box
+    - use_full_hex_values_for_flutter_colors
+    - use_key_in_widget_constructors

packages/wyatt_analysis/lib/analysis_options.flutter.yaml

@@ -1,4 +1,4 @@
-# Copyright (C) 2022 WYATT GROUP
+# Copyright (C) 2023 WYATT GROUP
 # Please see the AUTHORS file for details.
 #
 # This program is free software: you can redistribute it and/or modify
@@ -14,4 +14,5 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-include: package:wyatt_analysis/analysis_options.flutter.2.2.1.yaml
+include: package:wyatt_analysis/analysis_options.flutter.2.4.0.yaml
+

packages/wyatt_analysis/lib/analysis_options.yaml

@@ -1,4 +1,4 @@
-# Copyright (C) 2022 WYATT GROUP
+# Copyright (C) 2023 WYATT GROUP
 # Please see the AUTHORS file for details.
 #
 # This program is free software: you can redistribute it and/or modify
@@ -14,4 +14,5 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-include: package:wyatt_analysis/analysis_options.2.2.1.yaml
+include: package:wyatt_analysis/analysis_options.2.4.0.yaml
+

packages/wyatt_analysis/lib/wyatt_analysis.dart

@@ -1,4 +1,4 @@
-// Copyright (C) 2022 WYATT GROUP
+// Copyright (C) 2023 WYATT GROUP
 // Please see the AUTHORS file for details.
 //
 // This program is free software: you can redistribute it and/or modify
@@ -15,8 +15,7 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 /// Wyatt analyzer settings and best practices
-/// used internally at [Wyatt](https://wyattapp.io)
-/// and [Wyatt Studio](https://wyatt-studio.fr).
+/// used internally at [Wyatt Studio](https://wyatt-studio.fr).
 library wyatt_analysis;
 
-const String wyattAnalysisVersion = '2.2.1';
+const String wyattAnalysisVersion = '2.4.0';

packages/wyatt_analysis/new_version.sh

@@ -0,0 +1,133 @@
+#!/usr/bin/env sh
+
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+usage="
+usage:
+    $(basename "$0") <previous_version> <new_version> -- create new analyzer files.
+
+where:
+    previous_version: last version, for example \`2.3.0\`
+    new_version: new version, for example \`2.4.0\`"
+
+old=$1
+new=$2
+
+if [ -z "$old" ]; then
+   echo "previous_version cannot be null"
+   echo "${usage}"
+   exit 1
+fi
+
+if [ -z "$new" ]; then
+   echo "new_version cannot be null"
+   echo "${usage}"
+   exit 1
+fi
+
+SCRIPT_PATH="${BASH_SOURCE:-$0}"
+ABS_SCRIPT_PATH="$(realpath "${SCRIPT_PATH}")"
+ABS_DIRECTORY="$(dirname "${ABS_SCRIPT_PATH}")"
+
+LIB="${ABS_DIRECTORY}/lib/wyatt_analysis.dart"
+OPTIONS="${ABS_DIRECTORY}/lib/analysis_options.yaml"
+OLD_OPTIONS="${ABS_DIRECTORY}/lib/analysis_options.${old}.yaml"
+NEW_OPTIONS="${ABS_DIRECTORY}/lib/analysis_options.${new}.yaml"
+
+OPTIONS_FLUTTER="${ABS_DIRECTORY}/lib/analysis_options.flutter.yaml"
+OLD_OPTIONS_FLUTTER="${ABS_DIRECTORY}/lib/analysis_options.flutter.${old}.yaml"
+NEW_OPTIONS_FLUTTER="${ABS_DIRECTORY}/lib/analysis_options.flutter.${new}.yaml"
+
+if [ ! -e "$OLD_OPTIONS" ]; then
+   echo "analysis_options.${old}.yaml doesn't exists"
+   echo "${usage}"
+   exit 1
+fi
+
+if [ ! -e "$OLD_OPTIONS_FLUTTER" ]; then
+   echo "analysis_options.flutter.${old}.yaml doesn't exists"
+   echo "${usage}"
+   exit 1
+fi
+
+if [ -e "$NEW_OPTIONS" ]; then
+   echo "analysis_options.${new}.yaml already exists"
+   echo "${usage}"
+   exit 1
+fi
+
+if [ -e "$NEW_OPTIONS_FLUTTER" ]; then
+   echo "analysis_options.flutter.${old}.yaml already exists"
+   echo "${usage}"
+   exit 1
+fi
+
+# Copy previous version files
+cp "${OLD_OPTIONS}" "${NEW_OPTIONS}"
+cp "${OLD_OPTIONS_FLUTTER}" "${NEW_OPTIONS_FLUTTER}"
+
+# Search and replace old version string occurences in new files
+sed -e "s/${old}/${new}/g" "${NEW_OPTIONS_FLUTTER}" > tempfile.tmp
+mv -f tempfile.tmp "${NEW_OPTIONS_FLUTTER}"
+
+sed -e "s/${old}/${new}/g" "${LIB}" > tempfile.tmp
+mv -f tempfile.tmp "${LIB}"
+
+sed -e "s/${old}/${new}/g" "README.md" > tempfile.tmp
+mv -f tempfile.tmp "README.md"
+
+echo "
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include: package:wyatt_analysis/analysis_options.${new}.yaml
+" > "${OPTIONS}"
+
+echo "
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include: package:wyatt_analysis/analysis_options.flutter.${new}.yaml
+" > "${OPTIONS_FLUTTER}"
+
+exit 0

packages/wyatt_analysis/pubspec.yaml

@@ -1,7 +1,23 @@
+# Copyright (C) 2023 WYATT GROUP
+# Please see the AUTHORS file for details.
+# 
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 name: wyatt_analysis
-description: Lint rules for Dart and Flutter used internally at Wyatt and Wyatt Studio.
+description: Lint rules for Dart and Flutter used internally at Wyatt Studio.
 repository: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_analysis
-version: 2.2.2
+version: 2.4.0
 
 publish_to: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub
 

packages/wyatt_architecture/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 0.1.0+1
+
+ - Update a dependency to the latest release.
+
+## 0.1.0
+
+> Note: This release has breaking changes.
+
+ - **REFACTOR**: update naming methodes (close #47).
+ - **REFACTOR**: update example. (close #38).
+ - **FIX**: fix execute method on error handler. (#38).
+ - **FEAT**: update usecase en add  &  sepcific case. (#38).
+ - **FEAT**: add obsevers for alternative usecase scenarions (#38).
+ - **DOCS**: generate class model. (#38).
+ - **DOCS**: update Readme. (#38).
+ - **BREAKING** **CHORE**: update exports. (#38).
+
 ## 0.0.2
 
  - Graduate package to a stable release. See pre-releases prior to this version for changelog entries.

packages/wyatt_architecture/README.md

@@ -7,7 +7,7 @@
  * the Free Software Foundation, either version 3 of the License, or
  * any later version.
 
- * This program is distributed in the hope that it will be useful, 
+ * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  * GNU General Public License for more details.
@@ -31,10 +31,10 @@ The Wyatt Architecture for Flutter.
 
 ## Features
 
-* Usecase
-* Repository
-* DataSource
-* Entity
+- Usecase
+- Repository
+- DataSource
+- Entity
 
 ## Usage
 
@@ -73,19 +73,20 @@ abstract class PhotoRepository extends BaseRepository {
 }
 ```
 
-> Here the repository is just a proxy of the data sources with result type (to have beautiful  error handling).
+> Here the repository is just a proxy of the data sources with result type (to have beautiful error handling).
 
-And finaly create your different usecases by using `UseCase<Parameters, ReturnType>` :
+And finaly create your different usecases :
+
+Several use cases are supported :
+
+- Classic usecase :
 
 ```dart
-class RetrieveAllPhoto extends UseCase<QueryParameters, List<Photo>> {
-  final PhotoRepository _photoRepository;
-
-  RetrieveAllPhotos(this._photoRepository);
+class Test extends AsyncUseCase<QueryParameters, List<Photo>>> {
 
   @override
-  FutureResult<List<Photo>> call(QueryParameters params) {
-    final photos = _photoRepository.getAllPhotos(
+  FuturOrResult<List<Photo>>> call(QueryParameters? params) {
+     final photos = _photoRepository.getAllPhotos(
       start: params.start,
       limit: params.limit,
     );
@@ -94,6 +95,54 @@ class RetrieveAllPhoto extends UseCase<QueryParameters, List<Photo>> {
 }
 ```
 
+You can add alternatve scenarios and check pre/post conditions using our extensions :
+
+```dart
+class SearchPhotos extends AsyncUseCase<QueryParameters, List<Photo>>> {
+
+  @override
+  FutureOrResult<List<Photo>>> call(QueryParameters? params) {
+     final photos = _photoRepository.getAllPhotos(
+      start: params.start,
+      limit: params.limit,
+    );
+    return photos;
+  }
+
+
+  @override
+  FutureOr<void> onStart(QueryParameters? params) {
+    if(params.start == null || params.limit == null){
+      throw ClientException('Préconndition non valides');
+    }
+  }
+
+}
+```
+
+You can implement error scenarios overriding `onError`, or check postconditions by overriding `onComplete` .
+
+- Stream usecase :
+
+```dart
+class SearchPhotos extends StreamUseCase<QueryParameters, List<Photo>>> {
+
+  @override
+  FutureOrResult<Stream<List<Photo>>>> call(QueryParameters? params) {
+     final photos = _photoRepository.getAllPhotos(
+      start: params.start,
+      limit: params.limit,
+    );
+    return photos;
+  }
+
+}
+```
+
+On this case, observers allow you to add alternative scénarios when data changed, overriding `onData` or `onDone`.
+
+Please note that to use handlers, call `call` method and not `execute`.
+
 > In fact, here we need a new parameter object, so let's create it:
 
 ```dart
@@ -171,4 +220,4 @@ class PhotoRepositoryImpl extends PhotoRepository {
 }
 ```
 
-That's all.
+That's all.

packages/wyatt_architecture/example/lib/data/data_sources/remote/album_api_data_source_impl.dart

@@ -24,9 +24,8 @@ import 'package:wyatt_http_client/wyatt_http_client.dart';
 import 'package:wyatt_type_utils/wyatt_type_utils.dart';
 
 class AlbumApiDataSourceImpl extends AlbumRemoteDataSource {
-  final MiddlewareClient _client;
-
   AlbumApiDataSourceImpl(this._client);
+  final MiddlewareClient _client;
 
   @override
   Future<Album> getAlbum(int id) async {

packages/wyatt_architecture/example/lib/data/data_sources/remote/photo_api_data_source_impl.dart

@@ -24,9 +24,8 @@ import 'package:wyatt_http_client/wyatt_http_client.dart';
 import 'package:wyatt_type_utils/wyatt_type_utils.dart';
 
 class PhotoApiDataSourceImpl extends PhotoRemoteDataSource {
-  final MiddlewareClient _client;
-
   PhotoApiDataSourceImpl(this._client);
+  final MiddlewareClient _client;
 
   @override
   Future<Photo> getPhoto(int id) async {

packages/wyatt_architecture/example/lib/data/repositories/photo_repository_impl.dart

@@ -24,57 +24,58 @@ import 'package:wyatt_architecture/wyatt_architecture.dart';
 import 'package:wyatt_type_utils/wyatt_type_utils.dart';
 
 class PhotoRepositoryImpl extends PhotoRepository {
-  final PhotoRemoteDataSource _photoRemoteDataSource;
-  final AlbumRemoteDataSource _albumRemoteDataSource;
-  final FavoriteLocalDataSource _favoriteLocalDataSource;
 
   PhotoRepositoryImpl(
     this._photoRemoteDataSource,
     this._albumRemoteDataSource,
     this._favoriteLocalDataSource,
   );
+  final PhotoRemoteDataSource _photoRemoteDataSource;
+  final AlbumRemoteDataSource _albumRemoteDataSource;
+  final FavoriteLocalDataSource _favoriteLocalDataSource;
 
   @override
-  FutureResult<void> addPhotoToFavorites(Photo photo) => Result.tryCatchAsync(
+  FutureOrResult<void> addPhotoToFavorites(Photo photo) => Result.tryCatchAsync(
         () => _favoriteLocalDataSource.addPhotoToFavorites(photo),
         (error) => ClientException('Cannot add photo to favorites.'),
       );
 
   @override
-  FutureResult<bool> checkIfPhotoIsInFavorites(int id) => Result.tryCatchAsync(
+  FutureOrResult<bool> checkIfPhotoIsInFavorites(int id) =>
+      Result.tryCatchAsync(
         () => _favoriteLocalDataSource.checkIfPhotoIsInFavorites(id),
         (error) =>
             ClientException('Cannot check if photo `$id` is in favorites.'),
       );
 
   @override
-  FutureResult<void> deletePhotoFromFavorites(int id) => Result.tryCatchAsync(
+  FutureOrResult<void> deletePhotoFromFavorites(int id) => Result.tryCatchAsync(
         () => _favoriteLocalDataSource.deletePhotoFromFavorites(id),
         (error) => ClientException('Cannot delete photo `$id` from favorites.'),
       );
 
   @override
-  FutureResult<Album> getAlbum(int id) => Result.tryCatchAsync(
+  FutureOrResult<Album> getAlbum(int id) => Result.tryCatchAsync(
         () => _albumRemoteDataSource.getAlbum(id),
         (error) => ServerException('Cannot retrieve album $id.'),
       );
 
   @override
-  FutureResult<List<Album>> getAllAlbums({int? start, int? limit}) =>
+  FutureOrResult<List<Album>> getAllAlbums({int? start, int? limit}) =>
       Result.tryCatchAsync(
         () => _albumRemoteDataSource.getAllAlbums(start: start, limit: limit),
         (error) => ServerException('Cannot retrieve all albums.'),
       );
 
   @override
-  FutureResult<List<Photo>> getAllPhotos({int? start, int? limit}) async =>
+  FutureOrResult<List<Photo>> getAllPhotos({int? start, int? limit}) async =>
       Result.tryCatchAsync(
         () => _photoRemoteDataSource.getAllPhotos(start: start, limit: limit),
         (error) => ServerException('Cannot retrieve all photos.'),
       );
 
   @override
-  FutureResult<List<Photo>> getAllPhotosFromFavorites() async {
+  FutureOrResult<List<Photo>> getAllPhotosFromFavorites() async {
     try {
       final response = <Photo>[];
       final favorites =
@@ -95,13 +96,13 @@ class PhotoRepositoryImpl extends PhotoRepository {
   }
 
   @override
-  FutureResult<Photo> getPhoto(int id) => Result.tryCatchAsync(
+  FutureOrResult<Photo> getPhoto(int id) => Result.tryCatchAsync(
         () => _photoRemoteDataSource.getPhoto(id),
         (error) => ServerException('Cannot retrieve photo $id.'),
       );
 
   @override
-  FutureResult<List<Photo>> getPhotosFromAlbum(
+  FutureOrResult<List<Photo>> getPhotosFromAlbum(
     int albumId, {
     int? start,
     int? limit,

packages/wyatt_architecture/example/lib/domain/repositories/photo_repository.dart

@@ -19,17 +19,17 @@ import 'package:architecture_example/domain/entities/photo.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
 abstract class PhotoRepository extends BaseRepository {
-  FutureResult<Album> getAlbum(int id);
-  FutureResult<List<Album>> getAllAlbums({int? start, int? limit});
-  FutureResult<Photo> getPhoto(int id);
-  FutureResult<List<Photo>> getAllPhotos({int? start, int? limit});
-  FutureResult<List<Photo>> getPhotosFromAlbum(
+  FutureOrResult<Album> getAlbum(int id);
+  FutureOrResult<List<Album>> getAllAlbums({int? start, int? limit});
+  FutureOrResult<Photo> getPhoto(int id);
+  FutureOrResult<List<Photo>> getAllPhotos({int? start, int? limit});
+  FutureOrResult<List<Photo>> getPhotosFromAlbum(
     int albumId, {
     int? start,
     int? limit,
   });
-  FutureResult<void> addPhotoToFavorites(Photo photo);
-  FutureResult<void> deletePhotoFromFavorites(int id);
-  FutureResult<List<Photo>> getAllPhotosFromFavorites();
-  FutureResult<bool> checkIfPhotoIsInFavorites(int id);
+  FutureOrResult<void> addPhotoToFavorites(Photo photo);
+  FutureOrResult<void> deletePhotoFromFavorites(int id);
+  FutureOrResult<List<Photo>> getAllPhotosFromFavorites();
+  FutureOrResult<bool> checkIfPhotoIsInFavorites(int id);
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/add_photo_to_favorites.dart

@@ -1,31 +1,40 @@
 // Copyright (C) 2022 WYATT GROUP
 // Please see the AUTHORS file for details.
-// 
+//
 // This program is free software: you can redistribute it and/or modify
 // it under the terms of the GNU General Public License as published by
 // the Free Software Foundation, either version 3 of the License, or
 // any later version.
-// 
+//
 // This program is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 // GNU General Public License for more details.
-// 
+//
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:architecture_example/domain/entities/photo.dart';
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class AddPhotoToFavorites extends UseCase<Photo, List<Photo>> {
-  final PhotoRepository _photoRepository;
+class AddPhotoToFavorites extends AsyncUseCase<Photo, List<Photo>> {
 
   AddPhotoToFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Photo>> call(Photo params) async {
-    await _photoRepository.addPhotoToFavorites(params);
+  FutureOrResult<List<Photo>> execute(Photo? params) async {
+    await _photoRepository.addPhotoToFavorites(params!);
     return _photoRepository.getAllPhotosFromFavorites();
   }
+
+  @override
+  FutureOr<void> onStart(Photo? params) {
+    if (params == null) {
+      throw ClientException('Photo cannot be null');
+    }
+  }
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/check_if_photo_is_in_favorites.dart

@@ -14,15 +14,24 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class CheckIfPhotoIsInFavorites extends UseCase<int, bool> {
-  final PhotoRepository _photoRepository;
+class CheckIfPhotoIsInFavorites extends AsyncUseCase<int, bool> {
 
   CheckIfPhotoIsInFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<bool> call(int params) async =>
-      _photoRepository.checkIfPhotoIsInFavorites(params);
+  FutureOrResult<bool> execute(int? params) async =>
+      _photoRepository.checkIfPhotoIsInFavorites(params!);
+
+  @override
+  FutureOr<void> onStart(int? params) {
+    if (params == null) {
+      throw ClientException('id cannot be null');
+    }
+  }
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/display_favorites.dart

@@ -1,16 +1,16 @@
 // Copyright (C) 2022 WYATT GROUP
 // Please see the AUTHORS file for details.
-// 
+//
 // This program is free software: you can redistribute it and/or modify
 // it under the terms of the GNU General Public License as published by
 // the Free Software Foundation, either version 3 of the License, or
 // any later version.
-// 
+//
 // This program is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 // GNU General Public License for more details.
-// 
+//
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
@@ -18,13 +18,13 @@ import 'package:architecture_example/domain/entities/photo.dart';
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class DisplayFavorites extends UseCase<void, List<Photo>> {
-  final PhotoRepository _photoRepository;
+class DisplayFavorites extends AsyncUseCase<NoParam, List<Photo>> {
 
   DisplayFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Photo>> call(void params) {
+  FutureOrResult<List<Photo>> execute(void params) {
     final photos = _photoRepository.getAllPhotosFromFavorites();
     return photos;
   }

packages/wyatt_architecture/example/lib/domain/usecases/photos/display_photo.dart

@@ -14,18 +14,27 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:architecture_example/domain/entities/photo.dart';
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class DisplayPhoto extends UseCase<int, Photo> {
-  final PhotoRepository _photoRepository;
+class DisplayPhoto extends AsyncUseCase<int, Photo> {
 
   DisplayPhoto(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<Photo> call(int params) {
-    final photo = _photoRepository.getPhoto(params);
+  FutureOrResult<Photo> execute(int? params) {
+    final photo = _photoRepository.getPhoto(params!);
     return photo;
   }
+
+  @override
+  FutureOr<void> onStart(int? params) {
+    if (params == null) {
+      throw ClientException('id cannot be null');
+    }
+  }
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/open_album.dart

@@ -14,24 +14,33 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:architecture_example/domain/entities/photo.dart';
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:architecture_example/domain/usecases/photos/params/query_parameters.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class OpenAlbum extends UseCase<QueryParameters, List<Photo>> {
-  final PhotoRepository _photoRepository;
+class OpenAlbum extends AsyncUseCase<QueryParameters, List<Photo>> {
 
   OpenAlbum(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Photo>> call(QueryParameters params) {
+  FutureOrResult<List<Photo>> execute(QueryParameters? params) {
     final photos = _photoRepository.getPhotosFromAlbum(
-      params.albumId,
+      params!.albumId,
       start: params.start,
       limit: params.limit,
     );
 
     return photos;
   }
+
+  @override
+  FutureOr<void> onStart(QueryParameters? params) {
+    if (params == null) {
+      throw ClientException('params cannot be null');
+    }
+  }
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/params/query_parameters.dart

@@ -15,9 +15,9 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 class QueryParameters {
+
+  QueryParameters(this.start, this.limit, {this.albumId = -1});
   final int albumId;
   final int? start;
   final int? limit;
-
-  QueryParameters(this.start, this.limit, {this.albumId = -1});
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/remove_photo_from_favorites.dart

@@ -14,18 +14,27 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:architecture_example/domain/entities/photo.dart';
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class RemovePhotoFromFavorites extends UseCase<int, List<Photo>> {
-  final PhotoRepository _photoRepository;
+class RemovePhotoFromFavorites extends AsyncUseCase<int, List<Photo>> {
 
   RemovePhotoFromFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Photo>> call(int params) async {
-    await _photoRepository.deletePhotoFromFavorites(params);
+  FutureOrResult<List<Photo>> execute(int? params) async {
+    await _photoRepository.deletePhotoFromFavorites(params!);
     return _photoRepository.getAllPhotosFromFavorites();
   }
+
+  @override
+  FutureOr<void> onStart(int? params) {
+    if (params == null) {
+      throw ClientException('id cannot be null');
+    }
+  }
 }

packages/wyatt_architecture/example/lib/domain/usecases/photos/retrieve_all_albums.dart

@@ -14,22 +14,31 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:architecture_example/domain/entities/album.dart';
 import 'package:architecture_example/domain/repositories/photo_repository.dart';
 import 'package:architecture_example/domain/usecases/photos/params/query_parameters.dart';
 import 'package:wyatt_architecture/wyatt_architecture.dart';
 
-class RetrieveAllAlbums extends UseCase<QueryParameters, List<Album>> {
-  final PhotoRepository _photoRepository;
+class RetrieveAllAlbums extends AsyncUseCase<QueryParameters, List<Album>> {
 
   RetrieveAllAlbums(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Album>> call(QueryParameters params) {
+  FutureOrResult<List<Album>> execute(QueryParameters? params) {
     final albums = _photoRepository.getAllAlbums(
-      start: params.start,
+      start: params!.start,
       limit: params.limit,
     );
     return albums;
   }
+
+  @override
+  FutureOr<void> onStart(QueryParameters? params) {
+    if (params == null) {
+      throw ClientException('params cannot be null');
+    }
+  }
 }

packages/wyatt_architecture/example/lib/presentation/features/albums/blocs/album/album_bloc.dart

@@ -33,7 +33,6 @@ EventTransformer<E> throttleDroppable<E>(Duration duration) =>
     (events, mapper) => droppable<E>().call(events.throttle(duration), mapper);
 
 class AlbumBloc extends Bloc<AlbumEvent, AlbumState> {
-  final RetrieveAllAlbums _retrieveAllAlbums;
 
   AlbumBloc(this._retrieveAllAlbums) : super(const AlbumState()) {
     on<AlbumFetched>(
@@ -41,6 +40,7 @@ class AlbumBloc extends Bloc<AlbumEvent, AlbumState> {
       transformer: throttleDroppable(throttleDuration),
     );
   }
+  final RetrieveAllAlbums _retrieveAllAlbums;
 
   Future<void> _onAlbumFetched(
     AlbumFetched event,

packages/wyatt_architecture/example/lib/presentation/features/photo_details/blocs/photo_details/photo_details_state.dart

@@ -26,19 +26,19 @@ abstract class PhotoDetailsState extends Equatable {
 class PhotoDetailsInitial extends PhotoDetailsState {}
 
 class PhotoDetailsSuccess extends PhotoDetailsState {
-  final Photo photo;
-  final bool isFavorite;
 
   const PhotoDetailsSuccess(this.photo, {required this.isFavorite});
+  final Photo photo;
+  final bool isFavorite;
 
   @override
   List<Object> get props => [photo, isFavorite];
 }
 
 class PhotoDetailsFailure extends PhotoDetailsState {
-  final String error;
 
   const PhotoDetailsFailure(this.error);
+  final String error;
 
   @override
   List<Object> get props => [error];

packages/wyatt_architecture/example/lib/presentation/features/photos/blocs/favorite_checker/favorite_checker_cubit.dart

@@ -23,10 +23,10 @@ import 'package:flutter_bloc/flutter_bloc.dart';
 part 'favorite_checker_state.dart';
 
 class FavoriteCheckerCubit extends Cubit<FavoriteCheckerState> {
-  final CheckIfPhotoIsInFavorites _checkIfPhotoIsInFavorites;
 
   FavoriteCheckerCubit(this._checkIfPhotoIsInFavorites)
       : super(FavoriteCheckerInitial());
+  final CheckIfPhotoIsInFavorites _checkIfPhotoIsInFavorites;
 
   FutureOr<void> checkIfPhotoIsInFavorites(int photoId) async {
     final response = await _checkIfPhotoIsInFavorites.call(photoId);

packages/wyatt_architecture/example/lib/presentation/features/photos/blocs/favorite_checker/favorite_checker_state.dart

@@ -10,19 +10,19 @@ abstract class FavoriteCheckerState extends Equatable {
 class FavoriteCheckerInitial extends FavoriteCheckerState {}
 
 class FavoriteCheckerSuccess extends FavoriteCheckerState {
-  final int photoId;
-  final bool isFavorite;
 
   const FavoriteCheckerSuccess(this.photoId, {required this.isFavorite});
+  final int photoId;
+  final bool isFavorite;
 
   @override
   List<Object> get props => [photoId, isFavorite];
 }
 
 class FavoriteCheckerFailure extends FavoriteCheckerState {
-  final String error;
 
   const FavoriteCheckerFailure(this.error);
+  final String error;
 
   @override
   List<Object> get props => [error];

packages/wyatt_architecture/example/lib/presentation/features/photos/blocs/photo/photo_bloc.dart

@@ -33,7 +33,6 @@ EventTransformer<E> throttleDroppable<E>(Duration duration) =>
     (events, mapper) => droppable<E>().call(events.throttle(duration), mapper);
 
 class PhotoBloc extends Bloc<PhotoEvent, PhotoState> {
-  final OpenAlbum _openAlbum;
 
   PhotoBloc(this._openAlbum) : super(const PhotoState()) {
     on<PhotoFetched>(
@@ -41,6 +40,7 @@ class PhotoBloc extends Bloc<PhotoEvent, PhotoState> {
       transformer: throttleDroppable(throttleDuration),
     );
   }
+  final OpenAlbum _openAlbum;
 
   Future<void> _onPhotoFetched(
     PhotoFetched event,

packages/wyatt_architecture/example/lib/presentation/features/photos/blocs/photo/photo_event.dart

@@ -24,7 +24,7 @@ abstract class PhotoEvent extends Equatable {
 }
 
 class PhotoFetched extends PhotoEvent {
-  final int albumId;
 
   const PhotoFetched(this.albumId);
+  final int albumId;
 }

packages/wyatt_architecture/example/pubspec.yaml

@@ -36,7 +36,7 @@ dependencies:
 
   wyatt_type_utils:
     hosted: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub
-    version: ^0.0.3+1
+    version: ^0.0.4
 
   wyatt_http_client:
     git:
@@ -49,7 +49,7 @@ dependencies:
   
   wyatt_bloc_helper:
     hosted: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub/
-    version: ^1.2.0
+    version: ^2.0.0
   equatable: ^2.0.5
   stream_transform: ^2.1.0
   bloc_concurrency: ^0.2.0
@@ -67,7 +67,7 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.2.2
+      ref: wyatt_analysis-v2.4.0
       path: packages/wyatt_analysis
 
 # For information on the generic Dart part of this file, see the

packages/wyatt_architecture/lib/src/core/exceptions/exceptions.dart

@@ -17,9 +17,9 @@
 import 'package:wyatt_type_utils/wyatt_type_utils.dart';
 
 abstract class AppException implements Exception {
-  final String? message;
 
   AppException([this.message]);
+  final String? message;
 
   @override
   String toString() {

packages/wyatt_architecture/lib/src/domain/usecases/observers.dart

@@ -0,0 +1,44 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import 'dart:async';
+
+import 'package:wyatt_architecture/wyatt_architecture.dart';
+
+/// Usecase observers
+mixin Observer<Parameters, ReturnType> {
+  /// Called before usecase is runned.
+  /// Usefull to check the preconditions
+  FutureOr<void> onStart(Parameters? params) {}
+
+  /// Called when error occures during main scenario
+  /// Usefull to run alternative scenario
+  FutureOr<void> onError(AppException? error) {}
+}
+
+/// Specific observer for classic usecase
+mixin AsyncObserver<ReturnType> {
+  FutureOr<void> onComplete(ReturnType? data) {}
+}
+
+/// Specific observer for stream case usecase
+mixin StreamObserver<ReturnType> {
+  /// Replaces the data event handler of this subscription.
+  void onDone() {}
+
+  ///  Replaces the done event handler of this subscription.
+  void onData(ReturnType? data) {}
+}

packages/wyatt_architecture/lib/src/domain/usecases/usecase.dart

@@ -1,27 +1,80 @@
 // Copyright (C) 2022 WYATT GROUP
 // Please see the AUTHORS file for details.
-// 
+//
 // This program is free software: you can redistribute it and/or modify
 // it under the terms of the GNU General Public License as published by
 // the Free Software Foundation, either version 3 of the License, or
 // any later version.
-// 
+//
 // This program is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 // GNU General Public License for more details.
-// 
+//
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'dart:async';
+
 import 'package:wyatt_architecture/src/core/exceptions/exceptions.dart';
+import 'package:wyatt_architecture/src/domain/usecases/observers.dart';
 import 'package:wyatt_type_utils/wyatt_type_utils.dart';
 
-typedef FutureResult<T> = Future<Result<T, AppException>>;
+typedef FutureOrResult<T> = FutureOr<Result<T, AppException>>;
 typedef StreamResult<T> = Stream<Result<T, AppException>>;
-typedef Res<T> = Result<T, AppException>;
 
-// ignore: one_member_abstracts
-abstract class UseCase<Parameters, ReturnType> {
-  FutureResult<ReturnType> call(Parameters params);
+/// Abstract class of a use case
+abstract class BaseUseCase<Parameters, ReturnType> {
+  /// Run use case scenarios
+  ReturnType call(Parameters parameters);
+
+  /// Private function to implement main scenario
+  /// of your usecase.
+  ReturnType execute(Parameters params);
+}
+
+/// Abstract class of a use case that deals specifically
+/// with the response and its state.
+abstract class UseCase<Parameters, ReturnType>
+    extends BaseUseCase<Parameters?, FutureOrResult<ReturnType>>
+    with Observer<Parameters, ReturnType> {
+  FutureOr<void> _onSuccess(ReturnType data);
+
+  /// Supports the result of the main scenario and integrates
+  /// some alternative scenarios if necessary.
+  @override
+  FutureOrResult<ReturnType> call(Parameters? parameters) async {
+    try {
+      await onStart(parameters);
+      final response = await execute(parameters);
+      if (response.isErr) {
+        await onError(response.err);
+      } else if (response.isOk && response.ok != null) {
+        await _onSuccess(response.ok as ReturnType);
+      }
+      return response;
+    } catch (e) {
+      return Err(ClientException(e.toString()));
+    }
+  }
+}
+
+/// Abtstract classic usecase.
+abstract class AsyncUseCase<Parameters, ReturnType>
+    extends UseCase<Parameters?, ReturnType> with AsyncObserver<ReturnType> {
+  @override
+  FutureOr<void> _onSuccess(ReturnType data) => onComplete(data);
+}
+
+/// Abstract specific usecase bases on streams
+abstract class StreamUseCase<Parameters, ReturnType>
+    extends UseCase<Parameters?, Stream<ReturnType>>
+    with StreamObserver<ReturnType> {
+  @override
+  FutureOr<void> _onSuccess(Stream<ReturnType> data) {
+    data.listen(
+      onData,
+      onDone: onDone,
+    );
+  }
 }

packages/wyatt_architecture/lib/src/domain/usecases/usecases.dart

@@ -15,4 +15,5 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 export 'no_param.dart';
+export 'observers.dart';
 export 'usecase.dart';

packages/wyatt_architecture/models/class_model.puml

@@ -0,0 +1,86 @@
+@startuml
+set namespaceSeparator ::
+
+abstract class "wyatt_architecture::src::core::exceptions::exceptions.dart::AppException" {
+  +String? message
+  +String toString()
+}
+
+"dart::core::Exception" <|-- "wyatt_architecture::src::core::exceptions::exceptions.dart::AppException"
+
+class "wyatt_architecture::src::core::exceptions::exceptions.dart::ClientException" {
+}
+
+"wyatt_architecture::src::core::exceptions::exceptions.dart::AppException" <|-- "wyatt_architecture::src::core::exceptions::exceptions.dart::ClientException"
+class "wyatt_architecture::src::core::exceptions::exceptions.dart::ServerException" {
+}
+
+"wyatt_architecture::src::core::exceptions::exceptions.dart::AppException" <|-- "wyatt_architecture::src::core::exceptions::exceptions.dart::ServerException"
+
+abstract class "wyatt_architecture::src::domain::repositories::base_repository.dart::BaseRepository" {
+}
+
+abstract class "wyatt_architecture::src::domain::data_sources::local::base_local_data_source.dart::BaseLocalDataSource" {
+}
+
+"wyatt_architecture::src::domain::data_sources::base_data_source.dart::BaseDataSource" <|-- "wyatt_architecture::src::domain::data_sources::local::base_local_data_source.dart::BaseLocalDataSource"
+
+abstract class "wyatt_architecture::src::domain::data_sources::base_data_source.dart::BaseDataSource" {
+}
+
+abstract class "wyatt_architecture::src::domain::data_sources::remote::base_remote_data_source.dart::BaseRemoteDataSource" {
+}
+
+"wyatt_architecture::src::domain::data_sources::base_data_source.dart::BaseDataSource" <|-- "wyatt_architecture::src::domain::data_sources::remote::base_remote_data_source.dart::BaseRemoteDataSource"
+
+class "wyatt_architecture::src::domain::usecases::no_param.dart::NoParam" {
+}
+
+"wyatt_architecture::src::domain::entities::entity.dart::Entity" <|-- "wyatt_architecture::src::domain::usecases::no_param.dart::NoParam"
+
+abstract class "wyatt_architecture::src::domain::usecases::observers.dart::Observer" {
+  +FutureOr<void> onStart()
+  +FutureOr<void> onError()
+}
+
+abstract class "wyatt_architecture::src::domain::usecases::observers.dart::AsyncObserver" {
+  +FutureOr<void> onComplete()
+}
+
+abstract class "wyatt_architecture::src::domain::usecases::observers.dart::StreamObserver" {
+  +void onDone()
+  +void onData()
+}
+
+abstract class "wyatt_architecture::src::domain::usecases::usecase.dart::BaseUseCase" {
+  +ReturnType execute()
+  +ReturnType call()
+}
+
+abstract class "wyatt_architecture::src::domain::usecases::usecase.dart::UseCase" {
+  -FutureOr<void> _onSuccess()
+  +FutureOr<Result<ReturnType, AppException>> execute()
+}
+
+"wyatt_architecture::src::domain::usecases::usecase.dart::BaseUseCase" <|-- "wyatt_architecture::src::domain::usecases::usecase.dart::UseCase"
+"wyatt_architecture::src::domain::usecases::observers.dart::Observer" <|-- "wyatt_architecture::src::domain::usecases::usecase.dart::UseCase"
+
+abstract class "wyatt_architecture::src::domain::usecases::usecase.dart::AsyncUseCase" {
+  -FutureOr<void> _onSuccess()
+}
+
+"wyatt_architecture::src::domain::usecases::usecase.dart::UseCase" <|-- "wyatt_architecture::src::domain::usecases::usecase.dart::AsyncUseCase"
+"wyatt_architecture::src::domain::usecases::observers.dart::AsyncObserver" <|-- "wyatt_architecture::src::domain::usecases::usecase.dart::AsyncUseCase"
+
+abstract class "wyatt_architecture::src::domain::usecases::usecase.dart::StreamUseCase" {
+  -FutureOr<void> _onSuccess()
+}
+
+"wyatt_architecture::src::domain::usecases::usecase.dart::UseCase" <|-- "wyatt_architecture::src::domain::usecases::usecase.dart::StreamUseCase"
+"wyatt_architecture::src::domain::usecases::observers.dart::StreamObserver" <|-- "wyatt_architecture::src::domain::usecases::usecase.dart::StreamUseCase"
+
+abstract class "wyatt_architecture::src::domain::entities::entity.dart::Entity" {
+}
+
+
+@enduml

packages/wyatt_architecture/pubspec.yaml

@@ -1,7 +1,7 @@
 name: wyatt_architecture
 description: A new Wyatt package
 repository: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_architecture
-version: 0.0.2
+version: 0.1.0+1
 
 publish_to: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub
 
@@ -15,7 +15,7 @@ dependencies:
 
   wyatt_type_utils:
     hosted: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub
-    version: ^0.0.3+1
+    version: ^0.0.4
 
 dev_dependencies:
   
@@ -24,4 +24,4 @@ dev_dependencies:
   
   wyatt_analysis:
     hosted: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub
-    version: ^2.2.2
+    version: ^2.4.0

packages/wyatt_authentication_bloc/.gitignore

@@ -23,7 +23,6 @@
 # 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/
 .packages
 build/

packages/wyatt_authentication_bloc/.pubignore

@@ -1 +1,2 @@
-firebase_options.dart
+firebase_options.dart
+.vscode

packages/wyatt_authentication_bloc/.vscode

@@ -1 +0,0 @@
-../../.vscode/

packages/wyatt_authentication_bloc/.vscode/settings.json

@@ -0,0 +1,76 @@
+{
+    // Dart
+    "dart.runPubGetOnPubspecChanges": "never",
+    // Gitea
+    "gitea.owner": "Wyatt-FOSS",
+    "gitea.repo": "wyatt-packages",
+    // Header
+    "psi-header.changes-tracking": {
+        "isActive": true
+      },
+      "psi-header.config": {
+        "blankLinesAfter": 1,
+        "forceToTop": true
+      },
+      "psi-header.lang-config": [
+        {
+          "beforeHeader": [
+            "# -*- coding:utf-8 -*-",
+            "#!/usr/bin/env python3"
+          ],
+          "begin": "###",
+          "end": "###",
+          "language": "python",
+          "prefix": "# "
+        },
+        {
+          "beforeHeader": [
+            "#!/usr/bin/env sh",
+            ""
+          ],
+          "language": "shellscript",
+          "begin": "",
+          "end": "",
+          "prefix": "# "
+        },
+        {
+          "begin": "",
+          "end": "",
+          "language": "dart",
+          "prefix": "// "
+        },
+        {
+          "begin": "",
+          "end": "",
+          "language": "yaml",
+          "prefix": "# "
+        },
+        {
+          "begin": "<!--",
+          "end": "-->",
+          "language": "markdown",
+        },
+      ],
+      "psi-header.templates": [
+        {
+          "language": "*",
+          "template": [
+            "Copyright (C) <<year>> WYATT GROUP",
+            "Please see the AUTHORS file for details.",
+            "",
+            "This program is free software: you can redistribute it and/or modify",
+            "it under the terms of the GNU General Public License as published by",
+            "the Free Software Foundation, either version 3 of the License, or",
+            "any later version.",
+            "",
+            "This program is distributed in the hope that it will be useful,",
+            "but WITHOUT ANY WARRANTY; without even the implied warranty of",
+            "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the",
+            "GNU General Public License for more details.",
+            "",
+            "You should have received a copy of the GNU General Public License",
+            "along with this program. If not, see <https://www.gnu.org/licenses/>."
+          ],
+        }
+      ],
+}

packages/wyatt_authentication_bloc/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 0.4.1
+
+ - **REFACTOR**: use fromFirebaseUser factory to parse user.
+ - **REFACTOR**: update deps and re-export them.
+ - **FIX**: fix mock on register.
+ - **FEAT**: add google sign in in signIn cubit.
+ - **FEAT**: add google sign in parameter in firebase data source constructor.
+ - **FEAT**: add google sign_in support (closes #59).
+ - **FEAT**: add reauthenticate, updateEmail and updatePassword.
+ - **DOCS**: add correct header.
+
+## 0.4.0+3
+
+ - Update a dependency to the latest release.
+
+## 0.4.0+2
+
+ - Update a dependency to the latest release.
+
+## 0.4.0+1
+
+ - **FIX**: add sort of mutex on onAuthChanges callback trigger.
+
 ## 0.4.0
 
 > Note: This release has breaking changes.

packages/wyatt_authentication_bloc/README.md

@@ -1,5 +1,5 @@
 <!--
- * Copyright (C) 2022 WYATT GROUP
+ * Copyright (C) 2023 WYATT GROUP
  * Please see the AUTHORS file for details.
 
  * This program is free software: you can redistribute it and/or modify
@@ -7,7 +7,7 @@
  * the Free Software Foundation, either version 3 of the License, or
  * any later version.
 
- * This program is distributed in the hope that it will be useful,
+ * This program is distributed in the hope that it will be useful, 
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  * GNU General Public License for more details.
@@ -19,9 +19,7 @@
 # Flutter - Authentication BLoC
 
 <p align="left">
-  <a href="https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_analysis">
-    <img src="https://img.shields.io/badge/Style-Wyatt%20Analysis-blue.svg?style=flat-square" alt="Style: Wyatt Analysis" />
-  </a>
+  <a href="https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_analysis"><img src="https://img.shields.io/badge/Style-Wyatt%20Analysis-blue.svg?style=flat-square" alt="Style: Wyatt Analysis" /></a>
   <img src="https://img.shields.io/badge/SDK-Flutter-blue?style=flat-square" alt="SDK: Flutter" />
 </p>
 
@@ -29,37 +27,195 @@ Authentication Bloc for Flutter.
 
 ## Features
 
-- Wyatt Architecture
-- Entities:
-    - Account : AccountModel -> Contains account information from provider
-    - AccountWrapper : AccountWrapperModel -> Contains account and extra data.
-- Data Sources:
-    - Local:
-        - Cached Authentication Data : AuthenticationCacheDataSourceImpl -> Provides a cache implementation
-    - Remote:
-        - Remote Authentication Data : AuthenticationFirebaseDataSourceImpl -> Provides a proxy to FirebaseAuth
-- Repositories:
-    - AuthenticationRepository : AuthenticationRepositoryImpl -> Provides all authentication methods
-- Features:
-    - Authentication:
-        - AuthenticationBuilder : widget to build reactive view from authentication state
-        - AuthenticationCubit : tracks every auth changes, have sign out capability.
-    - SignUp:
-        - SignUpCubit: implementation of a FormDataCubit from `wyatt_form_bloc` for the sign up
-    - SignIn:
-        - SignUpCubit: implementation of a FormDataCubit from `wyatt_form_bloc` for the sign in
-- Consistent
-    * Every class have same naming convention
-- Tested
+* 🧐 Wyatt Architecture
+* 🧱 Entities
+    - Account -> Contains account information from provider.
+    - Session -> Contains account and associated data retrieved from an external source.
+    - AuthenticationChangeEvent -> Describes an event in authentication change (sign in, sign up, sign out, etc...)
+    - SessionWrapper -> Contains latest authentication change event and session.
+* 🔑 Powerful and secured authentication repository
+* 🔥 Multiple data sources
+    - Mock
+    - Firebase
+* 🧊 Cubits, why make it complicated when you can make it simple?
+    - Goes to the essential.
+* 📐 Consistent
+    - Every class have same naming convention
+* 🧪 Tested
+* 📚 Documented: [available here](./doc/api/index.md)
 
 ## Getting started
 
-Simply add `wyatt_authentication_bloc` in `pubspec.yaml`, then
+Simply add `wyatt_authentication_bloc` in `pubspec.yaml` , then
 
 ```dart
 import 'package:wyatt_authentication_bloc/wyatt_authentication_bloc.dart';
 ```
 
-## Usage
+### Data source
 
-// TODO
+The first step is to provide a data source.
+
+```dart
+getIt.registerLazySingleton<AuthenticationRemoteDataSource<int>>(
+    () => AuthenticationFirebaseDataSourceImpl<int>(
+        firebaseAuth: FirebaseAuth.instance,
+        googleSignIn:
+            GoogleSignIn(clientId: DefaultFirebaseOptions.ios.iosClientId)),
+);
+```
+
+> Here we use GetIt (see example project)
+
+### Repository
+
+Then you can configure your repository.
+
+```dart
+final AuthenticationRepository<int> authenticationRepository = AuthenticationRepositoryImpl(
+    authenticationRemoteDataSource:
+        getIt<AuthenticationRemoteDataSource<int>>(),
+    customPasswordValidator: const CustomPassword.pure(),
+    extraSignUpInputs: [
+        FormInput(
+        AuthFormField.confirmPassword,
+        const ConfirmedPassword.pure(),
+        metadata: const FormInputMetadata<void>(export: false),
+        ),
+    ],
+);
+```
+
+> Here we pass some extra inputs for the sign up, and a custom password validator.
+
+### Cubits
+
+It is necessary to implement each cubit. Don't panic, most of the work is already done 😊 you just have to customize the logic of these.
+
+In each of these cubits it is necessary to overload the various callbacks.
+
+> Here the associated data `Data` is a `int`
+
+#### Authentication
+
+In the authentication are managed, the refresh, the deletion of account or the disconnection.
+
+```dart
+class ExampleAuthenticationCubit extends AuthenticationCubit<int> {
+  ExampleAuthenticationCubit({required super.authenticationRepository});
+
+  @override
+  FutureOrResult<int?> onReauthenticate(Result<Account, AppException> result) async {
+    // TODO
+  }
+
+  @override
+  FutureOrResult<int?> onRefresh(Result<Account, AppException> result) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult<int?> onSignInFromCache(SessionWrapper<int> wrapper) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult<void> onSignOut() {
+    // TODO
+  }
+
+  @override
+  FutureOrResult<void> onDelete() {
+    // TODO
+  }
+}
+```
+
+#### Sign Up
+
+```dart
+class ExampleSignUpCubit extends SignUpCubit<int> {
+  ExampleSignUpCubit({
+    required super.authenticationRepository,
+  });
+
+  @override
+  FutureOrResult<int?> onSignUpWithEmailAndPassword(Result<Account, AppException> result, WyattForm form) async {
+    // TODO
+  }
+}
+
+```
+
+#### Sign In
+
+```dart
+class ExampleSignInCubit extends SignInCubit<int> {
+  ExampleSignInCubit({
+    required super.authenticationRepository,
+  });
+
+  @override
+  FutureOrResult<int?> onSignInWithEmailAndPassword(Result<Account, AppException> result, WyattForm form) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult<int?> onSignInAnonymously(Result<Account, AppException> result, WyattForm form) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult<int?> onSignInWithGoogle(Result<Account, AppException> result, WyattForm form) {
+    // TODO
+  }
+}
+```
+
+After setting up all these cubits you can provide them in the application. And that's it!
+
+```dart
+BlocProvider<SignUpCubit<int>>(
+    create: (_) => ExampleSignUpCubit(
+        authenticationRepository: authenticationRepository,
+    ),
+),
+BlocProvider<SignInCubit<int>>(
+    create: (_) => ExampleSignInCubit(
+        authenticationRepository: authenticationRepository,
+    ),
+),
+```
+
+### Widgets
+
+Widgets are provided to make your life easier. Starting with the `AuthenticationBuilder` which allows you to build according to the authentication state.
+
+```dart
+AuthenticationBuilder<int>(
+    authenticated: (context, sessionWrapper) => Text(
+        'Logged as ${sessionWrapper.session?.account.email} | GeneratedId is ${sessionWrapper.session?.data}'),
+    unauthenticated: (context) =>
+        const Text('Not logged (unauthenticated)'),
+    unknown: (context) => const Text('Not logged (unknown)'),
+),
+```
+
+A `BuildContext` extension is also available to access certain attributes more quickly.
+
+```dart
+Text('Home | ${context.account<AuthenticationCubit<int>, int>()?.email}'),
+```
+
+Listeners are used to listen to the status of the sign in and sign up forms.
+
+```dart
+return SignInListener<int>(
+    onError: (context, status, errorMessage) => ScaffoldMessenger.of(context)
+    ..hideCurrentSnackBar()
+    ..showSnackBar(
+        SnackBar(content: Text(errorMessage ?? 'Sign In Failure')),
+    ),
+    child: ...
+);
+```

packages/wyatt_authentication_bloc/analysis_options.yaml

@@ -1,4 +1 @@
-include: package:wyatt_analysis/analysis_options.flutter.yaml
-
-analyzer:
-  exclude: "!example/**"
+include: package:wyatt_analysis/analysis_options.flutter.yaml

packages/wyatt_authentication_bloc/doc/api/__404error.md

@@ -0,0 +1,6 @@
+# 404
+
+Oops, something's gone wrong :-(
+
+You've tried to visit a page that doesn't exist. Luckily this site has other
+[pages](index.md).

packages/wyatt_authentication_bloc/doc/api/categories.json

@@ -0,0 +1 @@
+[]

packages/wyatt_authentication_bloc/doc/api/index.md

@@ -0,0 +1,214 @@
+
+
+
+# wyatt_authentication_bloc - Dart API docs
+
+
+<!--
+ * Copyright (C) 2023 WYATT GROUP
+ * Please see the AUTHORS file for details.
+
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * any later version.
+
+ * This program is distributed in the hope that it will be useful, 
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+-->
+<h1 id="flutter---authentication-bloc">Flutter - Authentication BLoC</h1><p align="left">
+  <a href="https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_analysis"><img src="https://img.shields.io/badge/Style-Wyatt%20Analysis-blue.svg?style=flat-square" alt="Style: Wyatt Analysis"></a>
+  <img src="https://img.shields.io/badge/SDK-Flutter-blue?style=flat-square" alt="SDK: Flutter">
+</p>
+<p>Authentication Bloc for Flutter.</p>
+<h2 id="features">Features</h2>
+<ul>
+<li>🧐 Wyatt Architecture</li>
+<li>🧱 Entities
+<ul>
+<li>Account -&gt; Contains account information from provider.</li>
+<li>Session -&gt; Contains account and associated data retrieved from an external source.</li>
+<li>AuthenticationChangeEvent -&gt; Describes an event in authentication change (sign in, sign up, sign out, etc...)</li>
+<li>SessionWrapper -&gt; Contains latest authentication change event and session.</li>
+</ul>
+</li>
+<li>🔑 Powerful and secured authentication repository</li>
+<li>🔥 Multiple data sources
+<ul>
+<li>Mock</li>
+<li>Firebase</li>
+</ul>
+</li>
+<li>🧊 Cubits, why make it complicated when you can make it simple?
+<ul>
+<li>Goes to the essential.</li>
+</ul>
+</li>
+<li>📐 Consistent
+<ul>
+<li>Every class have same naming convention</li>
+</ul>
+</li>
+<li>🧪 Tested</li>
+<li>📚 Documented: <a href="./doc/api/index.md">available here</a></li>
+</ul>
+<h2 id="getting-started">Getting started</h2>
+<p>Simply add <code>wyatt_authentication_bloc</code> in <code>pubspec.yaml</code> , then</p>
+<pre class="language-dart"><code class="language-dart">import 'package:wyatt_authentication_bloc/wyatt_authentication_bloc.dart';
+</code></pre>
+<h3 id="data-source">Data source</h3>
+<p>The first step is to provide a data source.</p>
+<pre class="language-dart"><code class="language-dart">getIt.registerLazySingleton&lt;AuthenticationRemoteDataSource&lt;int&gt;&gt;(
+    () =&gt; AuthenticationFirebaseDataSourceImpl&lt;int&gt;(
+        firebaseAuth: FirebaseAuth.instance,
+        googleSignIn:
+            GoogleSignIn(clientId: DefaultFirebaseOptions.ios.iosClientId)),
+);
+</code></pre>
+<blockquote>
+<p>Here we use GetIt (see example project)</p>
+</blockquote>
+<h3 id="repository">Repository</h3>
+<p>Then you can configure your repository.</p>
+<pre class="language-dart"><code class="language-dart">final AuthenticationRepository&lt;int&gt; authenticationRepository = AuthenticationRepositoryImpl(
+    authenticationRemoteDataSource:
+        getIt&lt;AuthenticationRemoteDataSource&lt;int&gt;&gt;(),
+    customPasswordValidator: const CustomPassword.pure(),
+    extraSignUpInputs: [
+        FormInput(
+        AuthFormField.confirmPassword,
+        const ConfirmedPassword.pure(),
+        metadata: const FormInputMetadata&lt;void&gt;(export: false),
+        ),
+    ],
+);
+</code></pre>
+<blockquote>
+<p>Here we pass some extra inputs for the sign up, and a custom password validator.</p>
+</blockquote>
+<h3 id="cubits">Cubits</h3>
+<p>It is necessary to implement each cubit. Don't panic, most of the work is already done 😊 you just have to customize the logic of these.</p>
+<p>In each of these cubits it is necessary to overload the various callbacks.</p>
+<blockquote>
+<p>Here the associated data <code>Data</code> is a <code>int</code></p>
+</blockquote>
+<h4 id="authentication">Authentication</h4>
+<p>In the authentication are managed, the refresh, the deletion of account or the disconnection.</p>
+<pre class="language-dart"><code class="language-dart">class ExampleAuthenticationCubit extends AuthenticationCubit&lt;int&gt; {
+  ExampleAuthenticationCubit({required super.authenticationRepository});
+
+  @override
+  FutureOrResult&lt;int?&gt; onReauthenticate(Result&lt;Account, AppException&gt; result) async {
+    // TODO
+  }
+
+  @override
+  FutureOrResult&lt;int?&gt; onRefresh(Result&lt;Account, AppException&gt; result) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult&lt;int?&gt; onSignInFromCache(SessionWrapper&lt;int&gt; wrapper) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult&lt;void&gt; onSignOut() {
+    // TODO
+  }
+
+  @override
+  FutureOrResult&lt;void&gt; onDelete() {
+    // TODO
+  }
+}
+</code></pre>
+<h4 id="sign-up">Sign Up</h4>
+<pre class="language-dart"><code class="language-dart">class ExampleSignUpCubit extends SignUpCubit&lt;int&gt; {
+  ExampleSignUpCubit({
+    required super.authenticationRepository,
+  });
+
+  @override
+  FutureOrResult&lt;int?&gt; onSignUpWithEmailAndPassword(Result&lt;Account, AppException&gt; result, WyattForm form) async {
+    // TODO
+  }
+}
+
+</code></pre>
+<h4 id="sign-in">Sign In</h4>
+<pre class="language-dart"><code class="language-dart">class ExampleSignInCubit extends SignInCubit&lt;int&gt; {
+  ExampleSignInCubit({
+    required super.authenticationRepository,
+  });
+
+  @override
+  FutureOrResult&lt;int?&gt; onSignInWithEmailAndPassword(Result&lt;Account, AppException&gt; result, WyattForm form) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult&lt;int?&gt; onSignInAnonymously(Result&lt;Account, AppException&gt; result, WyattForm form) {
+    // TODO
+  }
+
+  @override
+  FutureOrResult&lt;int?&gt; onSignInWithGoogle(Result&lt;Account, AppException&gt; result, WyattForm form) {
+    // TODO
+  }
+}
+</code></pre>
+<p>After setting up all these cubits you can provide them in the application. And that's it!</p>
+<pre class="language-dart"><code class="language-dart">BlocProvider&lt;SignUpCubit&lt;int&gt;&gt;(
+    create: (_) =&gt; ExampleSignUpCubit(
+        authenticationRepository: authenticationRepository,
+    ),
+),
+BlocProvider&lt;SignInCubit&lt;int&gt;&gt;(
+    create: (_) =&gt; ExampleSignInCubit(
+        authenticationRepository: authenticationRepository,
+    ),
+),
+</code></pre>
+<h3 id="widgets">Widgets</h3>
+<p>Widgets are provided to make your life easier. Starting with the <code>AuthenticationBuilder</code> which allows you to build according to the authentication state.</p>
+<pre class="language-dart"><code class="language-dart">AuthenticationBuilder&lt;int&gt;(
+    authenticated: (context, sessionWrapper) =&gt; Text(
+        'Logged as ${sessionWrapper.session?.account.email} | GeneratedId is ${sessionWrapper.session?.data}'),
+    unauthenticated: (context) =&gt;
+        const Text('Not logged (unauthenticated)'),
+    unknown: (context) =&gt; const Text('Not logged (unknown)'),
+),
+</code></pre>
+<p>A <code>BuildContext</code> extension is also available to access certain attributes more quickly.</p>
+<pre class="language-dart"><code class="language-dart">Text('Home | ${context.account&lt;AuthenticationCubit&lt;int&gt;, int&gt;()?.email}'),
+</code></pre>
+<p>Listeners are used to listen to the status of the sign in and sign up forms.</p>
+<pre class="language-dart"><code class="language-dart">return SignInListener&lt;int&gt;(
+    onError: (context, status, errorMessage) =&gt; ScaffoldMessenger.of(context)
+    ..hideCurrentSnackBar()
+    ..showSnackBar(
+        SnackBar(content: Text(errorMessage ?? 'Sign In Failure')),
+    ),
+    child: ...
+);
+</code></pre>
+
+
+## Libraries
+
+##### [wyatt_authentication_bloc](wyatt_authentication_bloc/wyatt_authentication_bloc-library.md)
+An authentication library for BLoC.
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/search.md

@@ -0,0 +1,6 @@
+# 404
+
+Oops, something's gone wrong :-(
+
+You've tried to visit a page that doesn't exist. Luckily this site has other
+[pages](index.md).

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account-class.md

@@ -0,0 +1,237 @@
+
+
+
+# Account class
+
+
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+<p>Represents a user <a href="../wyatt_authentication_bloc/Account-class.md">Account</a> in the 
+various identity provisioning systems.</p>
+
+
+
+**Inheritance**
+
+- [Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)
+- [Equatable](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable-class.html)
+- Account
+
+
+
+**Implementers**
+
+- [AccountModel](../wyatt_authentication_bloc/AccountModel-class.md)
+
+
+
+
+
+## Constructors
+
+[Account](../wyatt_authentication_bloc/Account/Account.md) ({required [String](https://api.flutter.dev/flutter/dart-core/String-class.html) id, required [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) isAnonymous, required [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) emailVerified, required [String](https://api.flutter.dev/flutter/dart-core/String-class.html) providerId, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? email, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? phoneNumber, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? photoURL, [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)? creationTime, [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)? lastSignInTime, [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)? isNewUser, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? accessToken, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? refreshToken})
+
+  _const_ 
+
+
+## Properties
+
+##### [accessToken](../wyatt_authentication_bloc/Account/accessToken.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+The user access token  
+_<span class="feature">final</span>_
+
+
+
+##### [creationTime](../wyatt_authentication_bloc/Account/creationTime.md) &#8594; [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)?
+
+
+
+Returns the users account creation time.  
+_<span class="feature">final</span>_
+
+
+
+##### [email](../wyatt_authentication_bloc/Account/email.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+The users email address.  
+_<span class="feature">final</span>_
+
+
+
+##### [emailVerified](../wyatt_authentication_bloc/Account/emailVerified.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+Returns whether the users email address has been verified.  
+_<span class="feature">final</span>_
+
+
+
+##### [hashCode](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/hashCode.html) &#8594; [int](https://api.flutter.dev/flutter/dart-core/int-class.html)
+
+
+
+The hash code for this object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [id](../wyatt_authentication_bloc/Account/id.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+The user's unique ID.  
+_<span class="feature">final</span>_
+
+
+
+##### [isAnonymous](../wyatt_authentication_bloc/Account/isAnonymous.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+Returns whether the user is a anonymous.  
+_<span class="feature">final</span>_
+
+
+
+##### [isNewUser](../wyatt_authentication_bloc/Account/isNewUser.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)?
+
+
+
+Whether the user account has been recently created.  
+_<span class="feature">final</span>_
+
+
+
+##### [lastSignInTime](../wyatt_authentication_bloc/Account/lastSignInTime.md) &#8594; [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)?
+
+
+
+When the user last signed in as dictated by the server clock.  
+_<span class="feature">final</span>_
+
+
+
+##### [phoneNumber](../wyatt_authentication_bloc/Account/phoneNumber.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+Returns the users phone number.  
+_<span class="feature">final</span>_
+
+
+
+##### [photoURL](../wyatt_authentication_bloc/Account/photoURL.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+Returns a photo URL for the user.  
+_<span class="feature">final</span>_
+
+
+
+##### [props](../wyatt_authentication_bloc/Account/props.md) &#8594; [List](https://api.flutter.dev/flutter/dart-core/List-class.html)&lt;[Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)?>
+
+
+
+The list of properties that will be used to determine whether
+two instances are equal.  
+_<span class="feature">read-only</span><span class="feature">override</span>_
+
+
+
+##### [providerId](../wyatt_authentication_bloc/Account/providerId.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+The provider ID for the user.  
+_<span class="feature">final</span>_
+
+
+
+##### [refreshToken](../wyatt_authentication_bloc/Account/refreshToken.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+The user refresh token  
+_<span class="feature">final</span>_
+
+
+
+##### [runtimeType](https://api.flutter.dev/flutter/dart-core/Object/runtimeType.html) &#8594; [Type](https://api.flutter.dev/flutter/dart-core/Type-class.html)
+
+
+
+A representation of the runtime type of the object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [stringify](../wyatt_authentication_bloc/Account/stringify.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+If set to <code>true</code>, the <a href="https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/toString.html">toString</a> method will be overridden to output
+this instance's <a href="../wyatt_authentication_bloc/Account/props.md">props</a>.  
+_<span class="feature">read-only</span><span class="feature">override</span>_
+
+
+
+
+
+## Methods
+
+##### [noSuchMethod](https://api.flutter.dev/flutter/dart-core/Object/noSuchMethod.html)([Invocation](https://api.flutter.dev/flutter/dart-core/Invocation-class.html) invocation) dynamic
+
+
+
+Invoked when a non-existent method or property is accessed.  
+_<span class="feature">inherited</span>_
+
+
+
+##### [toString](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/toString.html)() [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+A string representation of this object.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+## Operators
+
+##### [operator ==](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/operator_equals.html)([Object](https://api.flutter.dev/flutter/dart-core/Object-class.html) other) [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+The equality operator.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/Account.md

@@ -0,0 +1,43 @@
+
+
+
+# Account constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+const
+Account({required [String](https://api.flutter.dev/flutter/dart-core/String-class.html) id, required [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) isAnonymous, required [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) emailVerified, required [String](https://api.flutter.dev/flutter/dart-core/String-class.html) providerId, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? email, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? phoneNumber, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? photoURL, [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)? creationTime, [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)? lastSignInTime, [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)? isNewUser, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? accessToken, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? refreshToken})
+
+
+
+
+
+## Implementation
+
+```dart
+const Account({
+  required this.id,
+  required this.isAnonymous,
+  required this.emailVerified,
+  required this.providerId,
+  this.email,
+  this.phoneNumber,
+  this.photoURL,
+  this.creationTime,
+  this.lastSignInTime,
+  this.isNewUser,
+  this.accessToken,
+  this.refreshToken,
+});
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/accessToken.md

@@ -0,0 +1,34 @@
+
+
+
+# accessToken property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? accessToken
+  
+_<span class="feature">final</span>_
+
+
+
+<p>The user access token</p>
+
+
+
+## Implementation
+
+```dart
+final String? accessToken;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/creationTime.md

@@ -0,0 +1,35 @@
+
+
+
+# creationTime property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)? creationTime
+  
+_<span class="feature">final</span>_
+
+
+
+<p>Returns the users account creation time.</p>
+<p>When this account was created as dictated by the server clock.</p>
+
+
+
+## Implementation
+
+```dart
+final DateTime? creationTime;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/email.md

@@ -0,0 +1,35 @@
+
+
+
+# email property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? email
+  
+_<span class="feature">final</span>_
+
+
+
+<p>The users email address.</p>
+<p>Will be <code>null</code> if signing in anonymously.</p>
+
+
+
+## Implementation
+
+```dart
+final String? email;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/emailVerified.md

@@ -0,0 +1,35 @@
+
+
+
+# emailVerified property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) emailVerified
+  
+_<span class="feature">final</span>_
+
+
+
+<p>Returns whether the users email address has been verified.</p>
+<p>To send a verification email, see <code>SendEmailVerification</code>.</p>
+
+
+
+## Implementation
+
+```dart
+final bool emailVerified;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/id.md

@@ -0,0 +1,34 @@
+
+
+
+# id property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html) id
+  
+_<span class="feature">final</span>_
+
+
+
+<p>The user's unique ID.</p>
+
+
+
+## Implementation
+
+```dart
+final String id;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/isAnonymous.md

@@ -0,0 +1,34 @@
+
+
+
+# isAnonymous property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) isAnonymous
+  
+_<span class="feature">final</span>_
+
+
+
+<p>Returns whether the user is a anonymous.</p>
+
+
+
+## Implementation
+
+```dart
+final bool isAnonymous;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/isNewUser.md

@@ -0,0 +1,34 @@
+
+
+
+# isNewUser property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)? isNewUser
+  
+_<span class="feature">final</span>_
+
+
+
+<p>Whether the user account has been recently created.</p>
+
+
+
+## Implementation
+
+```dart
+final bool? isNewUser;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/lastSignInTime.md

@@ -0,0 +1,34 @@
+
+
+
+# lastSignInTime property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)? lastSignInTime
+  
+_<span class="feature">final</span>_
+
+
+
+<p>When the user last signed in as dictated by the server clock.</p>
+
+
+
+## Implementation
+
+```dart
+final DateTime? lastSignInTime;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/phoneNumber.md

@@ -0,0 +1,36 @@
+
+
+
+# phoneNumber property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? phoneNumber
+  
+_<span class="feature">final</span>_
+
+
+
+<p>Returns the users phone number.</p>
+<p>This property will be <code>null</code> if the user has not signed in or been has
+their phone number linked.</p>
+
+
+
+## Implementation
+
+```dart
+final String? phoneNumber;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/photoURL.md

@@ -0,0 +1,36 @@
+
+
+
+# photoURL property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? photoURL
+  
+_<span class="feature">final</span>_
+
+
+
+<p>Returns a photo URL for the user.</p>
+<p>This property will be populated if the user has signed in or been linked
+with a 3rd party OAuth provider (such as Google).</p>
+
+
+
+## Implementation
+
+```dart
+final String? photoURL;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/props.md

@@ -0,0 +1,55 @@
+
+
+
+# props property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+
+
+**Annotations**
+
+- @[override](https://api.flutter.dev/flutter/dart-core/override-constant.html)
+[List](https://api.flutter.dev/flutter/dart-core/List-class.html)&lt;[Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)?> props
+  
+_<span class="feature">override</span>_
+
+
+
+<p>The list of properties that will be used to determine whether
+two instances are equal.</p>
+
+
+
+## Implementation
+
+```dart
+@override
+List<Object?> get props => [
+      id,
+      isAnonymous,
+      email,
+      emailVerified,
+      phoneNumber,
+      photoURL,
+      creationTime,
+      lastSignInTime,
+      providerId,
+      isNewUser,
+      accessToken,
+      refreshToken,
+    ];
+```
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/providerId.md

@@ -0,0 +1,34 @@
+
+
+
+# providerId property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html) providerId
+  
+_<span class="feature">final</span>_
+
+
+
+<p>The provider ID for the user.</p>
+
+
+
+## Implementation
+
+```dart
+final String providerId;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/refreshToken.md

@@ -0,0 +1,34 @@
+
+
+
+# refreshToken property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? refreshToken
+  
+_<span class="feature">final</span>_
+
+
+
+<p>The user refresh token</p>
+
+
+
+## Implementation
+
+```dart
+final String? refreshToken;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/Account/stringify.md

@@ -0,0 +1,47 @@
+
+
+
+# stringify property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+
+
+**Annotations**
+
+- @[override](https://api.flutter.dev/flutter/dart-core/override-constant.html)
+[bool](https://api.flutter.dev/flutter/dart-core/bool-class.html) stringify
+  
+_<span class="feature">override</span>_
+
+
+
+<p>If set to <code>true</code>, the <a href="https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/toString.html">toString</a> method will be overridden to output
+this instance's <a href="../../wyatt_authentication_bloc/Account/props.md">props</a>.</p>
+<p>A global default value for <a href="../../wyatt_authentication_bloc/Account/stringify.md">stringify</a> can be set using
+<code>EquatableConfig.stringify</code>.</p>
+<p>If this instance's <a href="../../wyatt_authentication_bloc/Account/stringify.md">stringify</a> is set to null, the value of
+<code>EquatableConfig.stringify</code> will be used instead. This defaults to
+<code>false</code>.</p>
+
+
+
+## Implementation
+
+```dart
+@override
+bool get stringify => true;
+```
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AccountModel-class.md

@@ -0,0 +1,247 @@
+
+
+
+# AccountModel class
+
+
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+<p>Account Model to parse Firebase User data</p>
+
+
+
+**Inheritance**
+
+- [Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)
+- [Equatable](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable-class.html)
+- [Account](../wyatt_authentication_bloc/Account-class.md)
+- AccountModel
+
+
+
+
+
+
+
+
+## Constructors
+
+[AccountModel.fromFirebaseUser](../wyatt_authentication_bloc/AccountModel/AccountModel.fromFirebaseUser.md) ([User](https://pub.dev/documentation/firebase_auth/4.2.0/firebase_auth/User-class.html)? user, {[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? accessToken})
+
+   _factory_
+
+[AccountModel.fromFirebaseUserCredential](../wyatt_authentication_bloc/AccountModel/AccountModel.fromFirebaseUserCredential.md) ([UserCredential](https://pub.dev/documentation/firebase_auth/4.2.0/firebase_auth/UserCredential-class.html)? userCredential)
+
+   _factory_
+
+
+## Properties
+
+##### [accessToken](../wyatt_authentication_bloc/Account/accessToken.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+The user access token  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [creationTime](../wyatt_authentication_bloc/Account/creationTime.md) &#8594; [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)?
+
+
+
+Returns the users account creation time.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [email](../wyatt_authentication_bloc/Account/email.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+The users email address.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [emailVerified](../wyatt_authentication_bloc/Account/emailVerified.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+Returns whether the users email address has been verified.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [hashCode](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/hashCode.html) &#8594; [int](https://api.flutter.dev/flutter/dart-core/int-class.html)
+
+
+
+The hash code for this object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [id](../wyatt_authentication_bloc/Account/id.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+The user's unique ID.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [isAnonymous](../wyatt_authentication_bloc/Account/isAnonymous.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+Returns whether the user is a anonymous.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [isNewUser](../wyatt_authentication_bloc/Account/isNewUser.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)?
+
+
+
+Whether the user account has been recently created.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [lastSignInTime](../wyatt_authentication_bloc/Account/lastSignInTime.md) &#8594; [DateTime](https://api.flutter.dev/flutter/dart-core/DateTime-class.html)?
+
+
+
+When the user last signed in as dictated by the server clock.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [phoneNumber](../wyatt_authentication_bloc/Account/phoneNumber.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+Returns the users phone number.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [photoURL](../wyatt_authentication_bloc/Account/photoURL.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+Returns a photo URL for the user.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [props](../wyatt_authentication_bloc/Account/props.md) &#8594; [List](https://api.flutter.dev/flutter/dart-core/List-class.html)&lt;[Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)?>
+
+
+
+The list of properties that will be used to determine whether
+two instances are equal.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [providerId](../wyatt_authentication_bloc/Account/providerId.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+The provider ID for the user.  
+_<span class="feature">final</span><span class="feature">inherited</span>_
+
+
+
+##### [refreshToken](../wyatt_authentication_bloc/AccountModel/refreshToken.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)?
+
+
+
+The user refresh token  
+_<span class="feature">read-only</span><span class="feature">override</span>_
+
+
+
+##### [runtimeType](https://api.flutter.dev/flutter/dart-core/Object/runtimeType.html) &#8594; [Type](https://api.flutter.dev/flutter/dart-core/Type-class.html)
+
+
+
+A representation of the runtime type of the object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [stringify](../wyatt_authentication_bloc/Account/stringify.md) &#8594; [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+If set to <code>true</code>, the <a href="https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/toString.html">toString</a> method will be overridden to output
+this instance's <a href="../wyatt_authentication_bloc/Account/props.md">props</a>.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [user](../wyatt_authentication_bloc/AccountModel/user.md) &#8594; [User](https://pub.dev/documentation/firebase_auth/4.2.0/firebase_auth/User-class.html)?
+
+
+
+  
+_<span class="feature">final</span>_
+
+
+
+
+
+## Methods
+
+##### [noSuchMethod](https://api.flutter.dev/flutter/dart-core/Object/noSuchMethod.html)([Invocation](https://api.flutter.dev/flutter/dart-core/Invocation-class.html) invocation) dynamic
+
+
+
+Invoked when a non-existent method or property is accessed.  
+_<span class="feature">inherited</span>_
+
+
+
+##### [toString](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/toString.html)() [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+A string representation of this object.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+## Operators
+
+##### [operator ==](https://pub.dev/documentation/equatable/2.0.5/equatable/Equatable/operator_equals.html)([Object](https://api.flutter.dev/flutter/dart-core/Object-class.html) other) [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+The equality operator.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AccountModel/AccountModel.fromFirebaseUser.md

@@ -0,0 +1,51 @@
+
+
+
+# AccountModel.fromFirebaseUser constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+AccountModel.fromFirebaseUser([User](https://pub.dev/documentation/firebase_auth/4.2.0/firebase_auth/User-class.html)? user, {[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? accessToken})
+
+
+
+
+
+## Implementation
+
+```dart
+factory AccountModel.fromFirebaseUser(User? user, {String? accessToken}) {
+  if (user != null) {
+    final providerId =
+        (user.providerData.isEmpty) ? '' : user.providerData.first.providerId;
+    return AccountModel._(
+      user: user,
+      id: user.uid,
+      emailVerified: user.emailVerified,
+      isAnonymous: user.isAnonymous,
+      providerId: providerId,
+      creationTime: user.metadata.creationTime,
+      lastSignInTime: user.metadata.lastSignInTime,
+      isNewUser: false,
+      email: user.email,
+      phoneNumber: user.phoneNumber,
+      photoURL: user.photoURL,
+      accessToken: accessToken,
+    );
+  } else {
+    throw ModelParsingFailureFirebase('null-user', 'User cannot be null');
+  }
+}
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AccountModel/AccountModel.fromFirebaseUserCredential.md

@@ -0,0 +1,54 @@
+
+
+
+# AccountModel.fromFirebaseUserCredential constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+AccountModel.fromFirebaseUserCredential([UserCredential](https://pub.dev/documentation/firebase_auth/4.2.0/firebase_auth/UserCredential-class.html)? userCredential)
+
+
+
+
+
+## Implementation
+
+```dart
+factory AccountModel.fromFirebaseUserCredential(
+  UserCredential? userCredential,
+) {
+  final user = userCredential?.user;
+  if (user != null) {
+    final providerId =
+        (user.providerData.isEmpty) ? '' : user.providerData.first.providerId;
+    return AccountModel._(
+      user: user,
+      id: user.uid,
+      emailVerified: user.emailVerified,
+      isAnonymous: user.isAnonymous,
+      providerId: providerId,
+      creationTime: user.metadata.creationTime,
+      lastSignInTime: user.metadata.lastSignInTime,
+      isNewUser: userCredential?.additionalUserInfo?.isNewUser,
+      email: user.email,
+      phoneNumber: user.phoneNumber,
+      photoURL: user.photoURL,
+      accessToken: userCredential?.credential?.accessToken,
+    );
+  } else {
+    throw ModelParsingFailureFirebase('null-user', 'User cannot be null');
+  }
+}
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AccountModel/refreshToken.md

@@ -0,0 +1,41 @@
+
+
+
+# refreshToken property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+
+
+**Annotations**
+
+- @[override](https://api.flutter.dev/flutter/dart-core/override-constant.html)
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? refreshToken
+  
+_<span class="feature">override</span>_
+
+
+
+<p>The user refresh token</p>
+
+
+
+## Implementation
+
+```dart
+@override
+String? get refreshToken => user?.refreshToken;
+```
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AccountModel/user.md

@@ -0,0 +1,33 @@
+
+
+
+# user property
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[User](https://pub.dev/documentation/firebase_auth/4.2.0/firebase_auth/User-class.html)? user
+  
+_<span class="feature">final</span>_
+
+
+
+
+
+
+## Implementation
+
+```dart
+final User? user;
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/ApplyActionCodeFailureFirebase-class.md

@@ -0,0 +1,137 @@
+
+
+
+# ApplyActionCodeFailureFirebase class
+
+
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+<p>Thrown if during the apply action code process if a failure occurs.</p>
+
+
+
+**Inheritance**
+
+- [Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)
+- [AuthenticationFailureInterface](../wyatt_authentication_bloc/AuthenticationFailureInterface-class.md)
+- [ApplyActionCodeFailureInterface](../wyatt_authentication_bloc/ApplyActionCodeFailureInterface-class.md)
+- ApplyActionCodeFailureFirebase
+
+
+
+
+
+
+
+
+## Constructors
+
+[ApplyActionCodeFailureFirebase](../wyatt_authentication_bloc/ApplyActionCodeFailureFirebase/ApplyActionCodeFailureFirebase.md) ([[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? code, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? msg])
+
+   
+
+[ApplyActionCodeFailureFirebase.fromCode](../wyatt_authentication_bloc/ApplyActionCodeFailureFirebase/ApplyActionCodeFailureFirebase.fromCode.md) ([String](https://api.flutter.dev/flutter/dart-core/String-class.html) code)
+
+   
+
+
+## Properties
+
+##### [code](../wyatt_authentication_bloc/AuthenticationFailureInterface/code.md) &#8596; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+  
+_<span class="feature">read / write</span><span class="feature">inherited</span>_
+
+
+
+##### [hashCode](https://api.flutter.dev/flutter/dart-core/Object/hashCode.html) &#8594; [int](https://api.flutter.dev/flutter/dart-core/int-class.html)
+
+
+
+The hash code for this object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [message](../wyatt_authentication_bloc/AuthenticationFailureInterface/message.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [msg](../wyatt_authentication_bloc/AuthenticationFailureInterface/msg.md) &#8596; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+  
+_<span class="feature">read / write</span><span class="feature">inherited</span>_
+
+
+
+##### [runtimeType](https://api.flutter.dev/flutter/dart-core/Object/runtimeType.html) &#8594; [Type](https://api.flutter.dev/flutter/dart-core/Type-class.html)
+
+
+
+A representation of the runtime type of the object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+
+
+## Methods
+
+##### [noSuchMethod](https://api.flutter.dev/flutter/dart-core/Object/noSuchMethod.html)([Invocation](https://api.flutter.dev/flutter/dart-core/Invocation-class.html) invocation) dynamic
+
+
+
+Invoked when a non-existent method or property is accessed.  
+_<span class="feature">inherited</span>_
+
+
+
+##### [toString](../wyatt_authentication_bloc/AuthenticationFailureInterface/toString.md)() [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+A string representation of this object.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+## Operators
+
+##### [operator ==](https://api.flutter.dev/flutter/dart-core/Object/operator_equals.html)([Object](https://api.flutter.dev/flutter/dart-core/Object-class.html) other) [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+The equality operator.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/ApplyActionCodeFailureFirebase/ApplyActionCodeFailureFirebase.fromCode.md

@@ -0,0 +1,49 @@
+
+
+
+# ApplyActionCodeFailureFirebase.fromCode constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+ApplyActionCodeFailureFirebase.fromCode([String](https://api.flutter.dev/flutter/dart-core/String-class.html) code)
+
+
+
+
+
+## Implementation
+
+```dart
+ApplyActionCodeFailureFirebase.fromCode(String code) : super.fromCode(code) {
+  switch (code) {
+    case 'expired-action-code':
+      msg = 'Action code has expired.';
+      break;
+    case 'invalid-action-code':
+      msg = 'Action code is invalid.';
+      break;
+    case 'user-disabled':
+      msg = 'This user has been disabled. Please contact support for help.';
+      break;
+    case 'user-not-found':
+      msg = 'Email is not found, please create an account.';
+      break;
+
+    default:
+      this.code = 'unknown';
+      msg = 'An unknown error occurred.';
+  }
+}
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/ApplyActionCodeFailureFirebase/ApplyActionCodeFailureFirebase.md

@@ -0,0 +1,31 @@
+
+
+
+# ApplyActionCodeFailureFirebase constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+ApplyActionCodeFailureFirebase([[String](https://api.flutter.dev/flutter/dart-core/String-class.html)? code, [String](https://api.flutter.dev/flutter/dart-core/String-class.html)? msg])
+
+
+
+
+
+## Implementation
+
+```dart
+ApplyActionCodeFailureFirebase([String? code, String? msg])
+    : super(code ?? 'unknown', msg ?? 'An unknown error occurred.');
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/ApplyActionCodeFailureInterface-class.md

@@ -0,0 +1,139 @@
+
+
+
+# ApplyActionCodeFailureInterface class
+
+
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+<p>Thrown if during the apply action code process if a failure occurs.</p>
+
+
+
+**Inheritance**
+
+- [Object](https://api.flutter.dev/flutter/dart-core/Object-class.html)
+- [AuthenticationFailureInterface](../wyatt_authentication_bloc/AuthenticationFailureInterface-class.md)
+- ApplyActionCodeFailureInterface
+
+
+
+**Implementers**
+
+- [ApplyActionCodeFailureFirebase](../wyatt_authentication_bloc/ApplyActionCodeFailureFirebase-class.md)
+
+
+
+
+
+## Constructors
+
+[ApplyActionCodeFailureInterface](../wyatt_authentication_bloc/ApplyActionCodeFailureInterface/ApplyActionCodeFailureInterface.md) ([String](https://api.flutter.dev/flutter/dart-core/String-class.html) code, [String](https://api.flutter.dev/flutter/dart-core/String-class.html) msg)
+
+Thrown if during the apply action code process if a failure occurs.   
+
+[ApplyActionCodeFailureInterface.fromCode](../wyatt_authentication_bloc/ApplyActionCodeFailureInterface/ApplyActionCodeFailureInterface.fromCode.md) ([String](https://api.flutter.dev/flutter/dart-core/String-class.html) code)
+
+Thrown if during the apply action code process if a failure occurs.   
+
+
+## Properties
+
+##### [code](../wyatt_authentication_bloc/AuthenticationFailureInterface/code.md) &#8596; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+  
+_<span class="feature">read / write</span><span class="feature">inherited</span>_
+
+
+
+##### [hashCode](https://api.flutter.dev/flutter/dart-core/Object/hashCode.html) &#8594; [int](https://api.flutter.dev/flutter/dart-core/int-class.html)
+
+
+
+The hash code for this object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [message](../wyatt_authentication_bloc/AuthenticationFailureInterface/message.md) &#8594; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [msg](../wyatt_authentication_bloc/AuthenticationFailureInterface/msg.md) &#8596; [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+  
+_<span class="feature">read / write</span><span class="feature">inherited</span>_
+
+
+
+##### [runtimeType](https://api.flutter.dev/flutter/dart-core/Object/runtimeType.html) &#8594; [Type](https://api.flutter.dev/flutter/dart-core/Type-class.html)
+
+
+
+A representation of the runtime type of the object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+
+
+## Methods
+
+##### [noSuchMethod](https://api.flutter.dev/flutter/dart-core/Object/noSuchMethod.html)([Invocation](https://api.flutter.dev/flutter/dart-core/Invocation-class.html) invocation) dynamic
+
+
+
+Invoked when a non-existent method or property is accessed.  
+_<span class="feature">inherited</span>_
+
+
+
+##### [toString](../wyatt_authentication_bloc/AuthenticationFailureInterface/toString.md)() [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+A string representation of this object.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+## Operators
+
+##### [operator ==](https://api.flutter.dev/flutter/dart-core/Object/operator_equals.html)([Object](https://api.flutter.dev/flutter/dart-core/Object-class.html) other) [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+The equality operator.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/ApplyActionCodeFailureInterface/ApplyActionCodeFailureInterface.fromCode.md

@@ -0,0 +1,31 @@
+
+
+
+# ApplyActionCodeFailureInterface.fromCode constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+ApplyActionCodeFailureInterface.fromCode([String](https://api.flutter.dev/flutter/dart-core/String-class.html) code)
+
+
+<p>Thrown if during the apply action code process if a failure occurs.</p>
+
+
+
+## Implementation
+
+```dart
+ApplyActionCodeFailureInterface.fromCode(super.code) : super.fromCode();
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/ApplyActionCodeFailureInterface/ApplyActionCodeFailureInterface.md

@@ -0,0 +1,31 @@
+
+
+
+# ApplyActionCodeFailureInterface constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+ApplyActionCodeFailureInterface([String](https://api.flutter.dev/flutter/dart-core/String-class.html) code, [String](https://api.flutter.dev/flutter/dart-core/String-class.html) msg)
+
+
+<p>Thrown if during the apply action code process if a failure occurs.</p>
+
+
+
+## Implementation
+
+```dart
+ApplyActionCodeFailureInterface(super.code, super.msg);
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormField-class.md

@@ -0,0 +1,122 @@
+
+
+
+# AuthFormField class
+
+
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+<p>Default authentication form fields name</p>
+
+
+
+
+## Constructors
+
+[AuthFormField](../wyatt_authentication_bloc/AuthFormField/AuthFormField.md) ()
+
+   
+
+
+## Properties
+
+##### [hashCode](https://api.flutter.dev/flutter/dart-core/Object/hashCode.html) &#8594; [int](https://api.flutter.dev/flutter/dart-core/int-class.html)
+
+
+
+The hash code for this object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [runtimeType](https://api.flutter.dev/flutter/dart-core/Object/runtimeType.html) &#8594; [Type](https://api.flutter.dev/flutter/dart-core/Type-class.html)
+
+
+
+A representation of the runtime type of the object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+
+
+## Methods
+
+##### [noSuchMethod](https://api.flutter.dev/flutter/dart-core/Object/noSuchMethod.html)([Invocation](https://api.flutter.dev/flutter/dart-core/Invocation-class.html) invocation) dynamic
+
+
+
+Invoked when a non-existent method or property is accessed.  
+_<span class="feature">inherited</span>_
+
+
+
+##### [toString](https://api.flutter.dev/flutter/dart-core/Object/toString.html)() [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+A string representation of this object.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+## Operators
+
+##### [operator ==](https://api.flutter.dev/flutter/dart-core/Object/operator_equals.html)([Object](https://api.flutter.dev/flutter/dart-core/Object-class.html) other) [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+The equality operator.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+
+
+
+
+
+## Constants
+
+##### [confirmPassword](../wyatt_authentication_bloc/AuthFormField/confirmPassword-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Confirm Password field: <code>wyattConfirmPasswordField</code>  
+
+
+
+
+##### [email](../wyatt_authentication_bloc/AuthFormField/email-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Email field: <code>wyattEmailField</code>  
+
+
+
+
+##### [password](../wyatt_authentication_bloc/AuthFormField/password-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Password field: <code>wyattPasswordField</code>  
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormField/AuthFormField.md

@@ -0,0 +1,25 @@
+
+
+
+# AuthFormField constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+AuthFormField()
+
+
+
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormField/confirmPassword-constant.md

@@ -0,0 +1,34 @@
+
+
+
+# confirmPassword constant
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html) const confirmPassword
+  
+
+
+
+
+<p>Confirm Password field: <code>wyattConfirmPasswordField</code></p>
+
+
+
+## Implementation
+
+```dart
+static const confirmPassword = 'wyattConfirmPasswordField';
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormField/email-constant.md

@@ -0,0 +1,34 @@
+
+
+
+# email constant
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html) const email
+  
+
+
+
+
+<p>Email field: <code>wyattEmailField</code></p>
+
+
+
+## Implementation
+
+```dart
+static const email = 'wyattEmailField';
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormField/password-constant.md

@@ -0,0 +1,34 @@
+
+
+
+# password constant
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html) const password
+  
+
+
+
+
+<p>Password field: <code>wyattPasswordField</code></p>
+
+
+
+## Implementation
+
+```dart
+static const password = 'wyattPasswordField';
+```
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormName-class.md

@@ -0,0 +1,131 @@
+
+
+
+# AuthFormName class
+
+
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+<p>Default authentication form name</p>
+
+
+
+
+## Constructors
+
+[AuthFormName](../wyatt_authentication_bloc/AuthFormName/AuthFormName.md) ()
+
+   
+
+
+## Properties
+
+##### [hashCode](https://api.flutter.dev/flutter/dart-core/Object/hashCode.html) &#8594; [int](https://api.flutter.dev/flutter/dart-core/int-class.html)
+
+
+
+The hash code for this object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+##### [runtimeType](https://api.flutter.dev/flutter/dart-core/Object/runtimeType.html) &#8594; [Type](https://api.flutter.dev/flutter/dart-core/Type-class.html)
+
+
+
+A representation of the runtime type of the object.  
+_<span class="feature">read-only</span><span class="feature">inherited</span>_
+
+
+
+
+
+## Methods
+
+##### [noSuchMethod](https://api.flutter.dev/flutter/dart-core/Object/noSuchMethod.html)([Invocation](https://api.flutter.dev/flutter/dart-core/Invocation-class.html) invocation) dynamic
+
+
+
+Invoked when a non-existent method or property is accessed.  
+_<span class="feature">inherited</span>_
+
+
+
+##### [toString](https://api.flutter.dev/flutter/dart-core/Object/toString.html)() [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+A string representation of this object.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+## Operators
+
+##### [operator ==](https://api.flutter.dev/flutter/dart-core/Object/operator_equals.html)([Object](https://api.flutter.dev/flutter/dart-core/Object-class.html) other) [bool](https://api.flutter.dev/flutter/dart-core/bool-class.html)
+
+
+
+The equality operator.  
+_<span class="feature">inherited</span>_
+
+
+
+
+
+
+
+
+
+
+## Constants
+
+##### [editAccountForm](../wyatt_authentication_bloc/AuthFormName/editAccountForm-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Edit account form: <code>wyattEditAccountForm</code>  
+
+
+
+
+##### [passwordResetForm](../wyatt_authentication_bloc/AuthFormName/passwordResetForm-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Password reset form: <code>wyattPasswordResetForm</code>  
+
+
+
+
+##### [signInForm](../wyatt_authentication_bloc/AuthFormName/signInForm-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Sign In form: <code>wyattSignInForm</code>  
+
+
+
+
+##### [signUpForm](../wyatt_authentication_bloc/AuthFormName/signUpForm-constant.md) const [String](https://api.flutter.dev/flutter/dart-core/String-class.html)
+
+
+
+Sign Up form: <code>wyattSignUpForm</code>  
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormName/AuthFormName.md

@@ -0,0 +1,25 @@
+
+
+
+# AuthFormName constructor
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+AuthFormName()
+
+
+
+
+
+
+
+
+
+
+
+

packages/wyatt_authentication_bloc/doc/api/wyatt_authentication_bloc/AuthFormName/editAccountForm-constant.md

@@ -0,0 +1,34 @@
+
+
+
+# editAccountForm constant
+
+
+
+
+    *[<Null safety>](https://dart.dev/null-safety)*
+
+
+
+[String](https://api.flutter.dev/flutter/dart-core/String-class.html) const editAccountForm
+  
+
+
+
+
+<p>Edit account form: <code>wyattEditAccountForm</code></p>
+
+
+
+## Implementation
+
+```dart
+static const String editAccountForm = 'wyattEditAccountForm';
+```
+
+
+
+
+
+
+