chore(release): publish packages

- wyatt_authentication_bloc@0.4.1

.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

@@ -197,4 +197,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]

.vscode/settings.json

@@ -1,4 +1,10 @@
 {
+    // Dart
+    "dart.runPubGetOnPubspecChanges": "never",
+    // Gitea
+    "gitea.owner": "Wyatt-FOSS",
+    "gitea.repo": "wyatt-packages",
+    // Header
     "psi-header.changes-tracking": {
         "isActive": true
       },
@@ -67,5 +73,4 @@
           ],
         }
       ],
-      "dart.runPubGetOnPubspecChanges": false,
+}
-}

CHANGELOG.md

@@ -3,6 +3,293 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 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
+
+---
+
+Packages with breaking changes:
+
+ - [`wyatt_authentication_bloc` - `v0.4.0`](#wyatt_authentication_bloc---v040)
+ - [`wyatt_form_bloc` - `v0.2.0`](#wyatt_form_bloc---v020)
+
+Packages with other changes:
+
+ - There are no other changes in this release.
+
+---
+
+#### `wyatt_authentication_bloc` - `v0.4.0`
+
+ - **REFACTOR**: update example with new input builders.
+ - **FIX**: add initial null account event in stream in the mock authentication.
+ - **BREAKING** **FIX**: add signInWithEmailAndPassword and signInAnonymously methods in SignInCubit #26.
+
+#### `wyatt_form_bloc` - `v0.2.0`
+
+ - **FIX**: disable status selection and rebuild SubmitBuilder on every state changes #28.
+ - **FIX**: fix set operations behaviors.
+ - **FIX**: add nullable validator on boolean value.
+ - **FEAT**: add metadata tag to bypass validation #29.
+ - **FEAT**: add shorthands to access validator status.
+ - **BREAKING** **REFACTOR**: input builders provides FormInput.
+
+
+## 2022-11-13
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - [`wyatt_crud_bloc` - `v0.1.0`](#wyatt_crud_bloc---v010)
+
+Packages with other changes:
+
+ - There are no other changes in this release.
+
+---
+
+#### `wyatt_crud_bloc` - `v0.1.0`
+
+ - **REFACTOR**: add vscode config.
+ - **FIX**: update example.
+ - **BREAKING** **REFACTOR**: migrate to wyatt architecture.
+
+
+## 2022-11-11
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_authentication_bloc` - `v0.3.0+1`](#wyatt_authentication_bloc---v0301)
+
+---
+
+#### `wyatt_authentication_bloc` - `v0.3.0+1`
+
+ - **FIX**: fix some bugs to validate publishing.
+
+
+## 2022-11-11
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - [`wyatt_authentication_bloc` - `v0.3.0`](#wyatt_authentication_bloc---v030)
+
+Packages with other changes:
+
+ - There are no other changes in this release.
+
+---
+
+#### `wyatt_authentication_bloc` - `v0.3.0`
+
+ - **REFACTOR**: use correct deps.
+ - **REFACTOR**: update example with new listeners.
+ - **FIX**: return exception and not throwing it anymore.
+ - **FIX**: exception returns msg as message.
+ - **FEAT**: add fully functionnal mock data source.
+ - **FEAT**: add toString and equality on entities and models.
+ - **BREAKING** **FEAT**: add email verification, password reset support.
+
+
+## 2022-11-10
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_architecture` - `v0.0.2`](#wyatt_architecture---v002)
+ - [`wyatt_authentication_bloc` - `v0.2.1+6`](#wyatt_authentication_bloc---v0216)
+ - [`wyatt_form_bloc` - `v0.1.0+1`](#wyatt_form_bloc---v0101)
+
+Packages graduated to a stable release (see pre-releases prior to the stable version for changelog entries):
+
+ - `wyatt_architecture` - `v0.0.2`
+
+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.2.1+6`
+ - `wyatt_form_bloc` - `v0.1.0+1`
+
+---
+
+#### `wyatt_architecture` - `v0.0.2`
+
+
 ## 2022-11-10
 
 ### 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>
+mason make wyatt_package --package_name  wyatt_<name> --description A new Wyatt package --flutter_only false
-```
-
-Remove any `example/` subfolder. Then create a new sample project.
-
-```shell
-flutter create --platforms android --project-name <name>_example example
 ```
 
 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":"033baa65408ec6b68e6a2ef43e64c24708ef16a1"}},"wyatt_feature_brick":{"git":{"url":"ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git","path":"bricks/wyatt_feature_brick","ref":"033baa65408ec6b68e6a2ef43e64c24708ef16a1"}},"wyatt_package":{"git":{"url":"ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git","path":"bricks/wyatt_package","ref":"033baa65408ec6b68e6a2ef43e64c24708ef16a1"}}}}

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:
+    git:
+      url: ssh://git@git.wyatt-studio.fr:993/Wyatt-FOSS/wyatt-bricks.git
+      path: bricks/wyatt_package

melos.yaml

@@ -21,8 +21,7 @@ scripts:
 
   analyze:
     run: |
-      melos exec -c 10 -- \
+      melos exec -c 1 -- flutter analyze --fatal-infos
-        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,12 @@
+## 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

@@ -20,7 +20,7 @@
 
 ![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.3.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).
 
@@ -29,12 +29,9 @@ This package provides lint rules for Dart and Flutter which are used at [Wyatt](
 To use the lints, add a dependency in your `pubspec.yaml`:
 
 ```yaml
-dev_dependencies:
+wyatt_analysis:
-  wyatt_analysis:
+    hosted: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub/
-    git:
+    version: 2.3.0
-      url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.0.0
-      path: packages/wyatt_analysis
 ```
 
 Then, add an include in `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.3.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.3.0.yaml
 ```
 
 ## Suppressing 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.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.yaml

@@ -1,3 +1,4 @@
+
 # Copyright (C) 2022 WYATT GROUP
 # Please see the AUTHORS file for details.
 #
@@ -14,4 +15,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.3.0.yaml
+

packages/wyatt_analysis/lib/analysis_options.yaml

@@ -1,3 +1,4 @@
+
 # Copyright (C) 2022 WYATT GROUP
 # Please see the AUTHORS file for details.
 #
@@ -14,4 +15,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.3.0.yaml
+

packages/wyatt_analysis/lib/wyatt_analysis.dart

@@ -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)
+/// used internally at [Wyatt Studio](https://wyatt-studio.fr).
-/// and [Wyatt Studio](https://wyatt-studio.fr).
 library wyatt_analysis;
 
-const String wyattAnalysisVersion = '2.2.1';
+const String wyattAnalysisVersion = '2.3.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,7 @@
 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.3.0
 
 publish_to: https://git.wyatt-studio.fr/api/packages/Wyatt-FOSS/pub
 

packages/wyatt_architecture/CHANGELOG.md

@@ -1,3 +1,24 @@
+## 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.
+
 ## 0.0.2-dev.0
 
  - **FEAT**: add exceptions, datasources, repositories, and usecases.

packages/wyatt_architecture/README.md

@@ -16,19 +16,18 @@
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
 -->
 
-
 # Flutter - Wyatt Architecture
 
 <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>
 
-Architecture for Flutter.
+The Wyatt Architecture for Flutter.
-
-Following: <https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html>
 
 ## Features
 
@@ -37,10 +36,188 @@ Following: <https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architect
 - DataSource
 - Entity
 
-## Getting started
-
-<!-- TODO -->
-
 ## Usage
 
-<!-- TODO -->
+### Domain
+
+Create your entities by extending `Entity` :
+
+```dart
+class Photo extends Entity {
+  final int id;
+  final String url;
+
+  const Photo({
+    required this.id,
+    required this.url,
+  });
+}
+```
+
+Then create the data sources by extending `BaseLocalDataSource` or `BaseRemoteDataSource` depending the type of data source.
+
+```dart
+abstract class PhotoRemoteDataSource extends BaseRemoteDataSource {
+  Future<Photo> getPhoto(int id);
+  Future<List<Photo>> getAllPhotos({int? start, int? limit});
+}
+
+```
+
+Then you can create your repositories by extenting `BaseRepository` :
+
+```dart
+abstract class PhotoRepository extends BaseRepository {
+  FutureResult<Photo> getPhoto(int id);
+  FutureResult<List<Photo>> getAllPhotos({int? start, int? limit});
+}
+```
+
+> 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 :
+
+Several use cases are supported :
+
+- Classic usecase :
+
+```dart
+class Test extends AsyncUseCase<QueryParameters, List<Photo>>> {
+
+  @override
+  FuturOrResult<List<Photo>>> call(QueryParameters? params) {
+     final photos = _photoRepository.getAllPhotos(
+      start: params.start,
+      limit: params.limit,
+    );
+    return photos;
+  }
+}
+```
+
+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
+class QueryParameters {
+  final int? start;
+  final int? limit;
+
+  QueryParameters(this.start, this.limit);
+}
+```
+
+### Data
+
+We start by creating models for photos and list of photos. You can use `freezed`. The `PhotoModel` extends `Photo` with some de/serializer capabilities. And those are used only in data layer.
+
+Then implements your data sources:
+
+```dart
+class PhotoApiDataSourceImpl extends PhotoRemoteDataSource {
+  final MiddlewareClient _client;
+
+  PhotoApiDataSourceImpl(this._client);
+
+  @override
+  Future<Photo> getPhoto(int id) async {
+    final response = await _client.get(Uri.parse('/photos/$id'));
+    final photo =
+        PhotoModel.fromJson(jsonDecode(response.body) as Map<String, Object?>);
+    return photo;
+  }
+
+  @override
+  Future<List<Photo>> getAllPhotos({int? start, int? limit}) async {
+    final startQuery = start.isNotNull ? '_start=$start' : '';
+    final limitQuery = limit.isNotNull ? '_limit=$limit' : '';
+    final delimiter1 =
+        (startQuery.isNotEmpty || limitQuery.isNotEmpty) ? '?' : '';
+    final delimiter2 =
+        (startQuery.isNotEmpty && limitQuery.isNotEmpty) ? '&' : '';
+    final url = '/photos$delimiter1$startQuery$delimiter2$limitQuery';
+    final response = await _client.get(Uri.parse(url));
+    final photos =
+        ListPhotoModel.fromJson({'photos': jsonDecode(response.body)});
+    return photos.photos;
+  }
+}
+```
+
+> 1: Note that here we use `MiddlewareClient` from our http package.
+
+> 2: You can create multiple implementations (one real and one mock for example).
+
+And implement the repositories:
+
+```dart
+class PhotoRepositoryImpl extends PhotoRepository {
+  final PhotoRemoteDataSource _photoRemoteDataSource;
+
+  PhotoRepositoryImpl(
+    this._photoRemoteDataSource,
+  );
+
+  @override
+  FutureResult<Photo> getPhoto(int id) => Result.tryCatchAsync(
+        () => _photoRemoteDataSource.getPhoto(id),
+        (error) => ServerException('Cannot retrieve photo $id.'),
+      );
+
+  @override
+  FutureResult<List<Photo>> getAllPhotos({int? start, int? limit}) async =>
+      Result.tryCatchAsync(
+        () => _photoRemoteDataSource.getAllPhotos(start: start, limit: limit),
+        (error) => ServerException('Cannot retrieve all photos.'),
+      );
+}
+```
+
+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);
+  FutureOrResult<Album> getAlbum(int id);
-  FutureResult<List<Album>> getAllAlbums({int? start, int? limit});
+  FutureOrResult<List<Album>> getAllAlbums({int? start, int? limit});
-  FutureResult<Photo> getPhoto(int id);
+  FutureOrResult<Photo> getPhoto(int id);
-  FutureResult<List<Photo>> getAllPhotos({int? start, int? limit});
+  FutureOrResult<List<Photo>> getAllPhotos({int? start, int? limit});
-  FutureResult<List<Photo>> getPhotosFromAlbum(
+  FutureOrResult<List<Photo>> getPhotosFromAlbum(
     int albumId, {
     int? start,
     int? limit,
   });
-  FutureResult<void> addPhotoToFavorites(Photo photo);
+  FutureOrResult<void> addPhotoToFavorites(Photo photo);
-  FutureResult<void> deletePhotoFromFavorites(int id);
+  FutureOrResult<void> deletePhotoFromFavorites(int id);
-  FutureResult<List<Photo>> getAllPhotosFromFavorites();
+  FutureOrResult<List<Photo>> getAllPhotosFromFavorites();
-  FutureResult<bool> checkIfPhotoIsInFavorites(int id);
+  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>> {
+class AddPhotoToFavorites extends AsyncUseCase<Photo, List<Photo>> {
-  final PhotoRepository _photoRepository;
 
   AddPhotoToFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Photo>> call(Photo params) async {
+  FutureOrResult<List<Photo>> execute(Photo? params) async {
-    await _photoRepository.addPhotoToFavorites(params);
+    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> {
+class CheckIfPhotoIsInFavorites extends AsyncUseCase<int, bool> {
-  final PhotoRepository _photoRepository;
 
   CheckIfPhotoIsInFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<bool> call(int params) async =>
+  FutureOrResult<bool> execute(int? params) async =>
-      _photoRepository.checkIfPhotoIsInFavorites(params);
+      _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>> {
+class DisplayFavorites extends AsyncUseCase<NoParam, List<Photo>> {
-  final PhotoRepository _photoRepository;
 
   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> {
+class DisplayPhoto extends AsyncUseCase<int, Photo> {
-  final PhotoRepository _photoRepository;
 
   DisplayPhoto(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<Photo> call(int params) {
+  FutureOrResult<Photo> execute(int? params) {
-    final photo = _photoRepository.getPhoto(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>> {
+class OpenAlbum extends AsyncUseCase<QueryParameters, List<Photo>> {
-  final PhotoRepository _photoRepository;
 
   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>> {
+class RemovePhotoFromFavorites extends AsyncUseCase<int, List<Photo>> {
-  final PhotoRepository _photoRepository;
 
   RemovePhotoFromFavorites(this._photoRepository);
+  final PhotoRepository _photoRepository;
 
   @override
-  FutureResult<List<Photo>> call(int params) async {
+  FutureOrResult<List<Photo>> execute(int? params) async {
-    await _photoRepository.deletePhotoFromFavorites(params);
+    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>> {
+class RetrieveAllAlbums extends AsyncUseCase<QueryParameters, List<Album>> {
-  final PhotoRepository _photoRepository;
 
   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.3.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/data_sources/base_data_source.dart

@@ -14,4 +14,6 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-abstract class BaseDataSource {}
+abstract class BaseDataSource {
+  const BaseDataSource();
+}

packages/wyatt_architecture/lib/src/domain/data_sources/local/base_local_data_source.dart

@@ -16,4 +16,6 @@
 
 import 'package:wyatt_architecture/src/domain/data_sources/base_data_source.dart';
 
-abstract class BaseLocalDataSource extends BaseDataSource {}
+abstract class BaseLocalDataSource extends BaseDataSource {
+  const BaseLocalDataSource();
+}

packages/wyatt_architecture/lib/src/domain/data_sources/remote/base_remote_data_source.dart

@@ -16,4 +16,6 @@
 
 import 'package:wyatt_architecture/src/domain/data_sources/base_data_source.dart';
 
-abstract class BaseRemoteDataSource extends BaseDataSource {}
+abstract class BaseRemoteDataSource extends BaseDataSource {
+  const BaseRemoteDataSource();
+}

packages/wyatt_architecture/lib/src/domain/repositories/base_repository.dart

@@ -14,4 +14,6 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-class BaseRepository {}
+abstract class BaseRepository {
+  const BaseRepository();
+}

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,25 +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>>;
 
-// ignore: one_member_abstracts
+/// Abstract class of a use case
-abstract class UseCase<Parameters, ReturnType> {
+abstract class BaseUseCase<Parameters, ReturnType> {
-  FutureResult<ReturnType> call(Parameters params);
+  /// 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

@@ -14,4 +14,6 @@
 // You should have received a copy of the GNU General Public License
 // 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-dev.0
+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.3.0

packages/wyatt_authentication_bloc/.pubignore

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

packages/wyatt_authentication_bloc/.vscode/settings.json

@@ -1,4 +1,10 @@
 {
+    // Dart
+    "dart.runPubGetOnPubspecChanges": "never",
+    // Gitea
+    "gitea.owner": "Wyatt-FOSS",
+    "gitea.repo": "wyatt-packages",
+    // Header
     "psi-header.changes-tracking": {
         "isActive": true
       },
@@ -67,5 +73,4 @@
           ],
         }
       ],
-      "dart.runPubGetOnPubspecChanges": false,
+}
-}

packages/wyatt_authentication_bloc/CHANGELOG.md

@@ -1,3 +1,54 @@
+## 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.
+
+ - **REFACTOR**: update example with new input builders.
+ - **FIX**: add initial null account event in stream in the mock authentication.
+ - **BREAKING** **FIX**: add signInWithEmailAndPassword and signInAnonymously methods in SignInCubit #26.
+
+## 0.3.0+1
+
+ - **FIX**: fix some bugs to validate publishing.
+
+## 0.3.0
+
+> Note: This release has breaking changes.
+
+ - **REFACTOR**: use correct deps.
+ - **REFACTOR**: update example with new listeners.
+ - **FIX**: return exception and not throwing it anymore.
+ - **FIX**: exception returns msg as message.
+ - **FEAT**: add fully functionnal mock data source.
+ - **FEAT**: add toString and equality on entities and models.
+ - **BREAKING** **FEAT**: add email verification, password reset support.
+
+## 0.2.1+6
+
+ - Update a dependency to the latest release.
+
 ## 0.2.1+5
 
  - Update a dependency to the latest release.

packages/wyatt_authentication_bloc/README.md

@@ -29,43 +29,28 @@ Authentication Bloc for Flutter.
 
 ## Features
 
-- UserInterface
+- Wyatt Architecture
-    * UserFirebase : FirebaseAuth user implementation
+- Entities:
-- AuthenticationRepositoryInterface
+    - Account : AccountModel -> Contains account information from provider
-    * AuthenticationRepositoryFirebase : FirebaseAuth implementation
+    - AccountWrapper : AccountWrapperModel -> Contains account and extra data.
-- ExceptionsInterface
+- Data Sources:
-    * ExceptionsFirebase : FirebaseAuth Exception parsing implementation
+    - Local:
-- AuthenticationBloc
+        - Cached Authentication Data : AuthenticationCacheDataSourceImpl -> Provides a cache implementation
-    * Tracks every user changes
+    - Remote:
-        - Right after the listener has been registered.
+        - Remote Authentication Data : AuthenticationFirebaseDataSourceImpl -> Provides a proxy to FirebaseAuth
-        - When a user is signed in.
+- Repositories:
-        - When the current user is signed out.
+    - AuthenticationRepository : AuthenticationRepositoryImpl -> Provides all authentication methods
-        - When there is a change in the current user's token.
+- Features:
-        - On `refresh()`
+    - Authentication:
-    * Start/Stop listening on demand
+        - AuthenticationBuilder : widget to build reactive view from authentication state
-        - `start()` to listen to user changes
+        - AuthenticationCubit : tracks every auth changes, have sign out capability.
-        - `stop()` to cancel listener
+    - SignUp:
-- SignUpCubit
+        - SignUpCubit: implementation of a FormDataCubit from `wyatt_form_bloc` for the sign up
-    * Handles email/password validation and password confirmation
+    - SignIn:
-    * Handles register with email/password
+        - SignUpCubit: implementation of a FormDataCubit from `wyatt_form_bloc` for the sign in
-    * Handles custom form fields thanks `wyatt_form_bloc`
-        - Use `entries` to pass a `FormData` object
-        - You can use several pre configured `FormInput` for validation
-        - You can use `updateFormData()` to change FormData and validators during runtime (intersection, union, difference or replace)
-- SignInCubit
-    * Handles email/password validation
-    * Handles login with email/password
-- EmailVerificationCubit
-    * Handles send email verification process
-    * Handles email verification check
-- PasswordResetCubit
-    * Handles send password reset email process
-- Builders
-    * AuthenticationBuilder to build widgets on user state changes
 - Consistent
     * Every class have same naming convention
 - Tested
-    * Partially tested with *bloc_test*
 
 ## Getting started
 
@@ -77,227 +62,4 @@ import 'package:wyatt_authentication_bloc/wyatt_authentication_bloc.dart';
 
 ## Usage
 
-Create an authentication repository:
+// TODO
-
-```dart
-final AuthenticationRepositoryInterface _authenticationRepository = AuthenticationRepositoryFirebase();
-```
-
-Create an authentication cubit:
-
-```dart
-final AuthenticationCubit _authenticationCubit = AuthenticationCubit(
-    authenticationRepository: _authenticationRepository,
-);
-```
-
-Create a sign up cubit:
-
-```dart
-final SignUpCubit _signUpCubit = SignUpCubit(
-    authenticationRepository: _authenticationRepository,
-    authenticationCubit: _authenticationCubit,
-);
-```
-
-You can use `AuthenticationBloc` to route your app.
-
-```dart
-return MultiRepositoryProvider(
-    providers: [
-        RepositoryProvider<AuthenticationRepositoryInterface>(
-            create: (context) => _authenticationRepository,
-        ),
-    ],
-    child: MultiBlocProvider(
-        providers: [
-            BlocProvider<AuthenticationCubit>(
-                create: (context) => _authenticationCubit..init(),
-            ),
-            BlocProvider<SignUpCubit>(
-                create: (context) => _signUpCubit,
-            ),
-        ],
-        child: const AppView(),
-    ),
-);
-```
-> Don't forget to call `init()` on authentication cubit.
-
-And in `AppView` use an `AuthenticationBuilder`:
-
-```dart
-AuthenticationBuilder(
-    unknown: (context) => const LoadingPage(),
-    unauthenticated: (context) => const LoginPage(),
-    authenticated: (context, user, userData) => const HomePage(),
-)
-```
-
-To create a `SignInCubit` you'll need the same `AuthenticationRepository`, you can use the `context`:
-
-```dart
-BlocProvider(
-    create: (_) => SignInCubit(context.read<AuthenticationRepositoryInterface>()),
-    child: const LoginForm(),
-),
-```
-
-> In practice it's better to create it in the main `MultiBlocProvider` because the LoginPage can be destroyed, and cubit closed, before login flow ends
-
-## Recipes
-
-### Password confirmation
-
-In this recipe we'll se how to create a custom `FormEntry` to confirm password.
-
-First, create an entry at the SignUpCubit creation:
-
-```dart
-SignUpCubit _signUpCubit = SignUpCubit(
-    authenticationRepository: _authenticationRepository,
-    authenticationCubit: _authenticationCubit,
-    entries: const FormData([
-        FormEntry('form_field_confirmPassword', ConfirmedPassword.pure()),
-    ]),
-);
-```
-
-Then, in the sign up form, create an input for password confirmation:
-
-- `ConfirmedPassword` validator need password value and confirm password value to compare.
-
-```dart
-return BlocBuilder<SignUpCubit, SignUpState>(
-    builder: (context, state) {
-        return TextField(
-            onChanged: (confirmPassword) => context
-                .read<SignUpCubit>()
-                .dataChanged(
-                    'form_field_confirmPassword',
-                    ConfirmedPassword.dirty(
-                        password: context.read<SignUpCubit>().state.password.value,
-                        value: confirmPassword,
-                    ),
-                ),
-            obscureText: true,
-            decoration: InputDecoration(
-                labelText: 'confirm password',
-                errorText: state.data!.input('form_field_confirmPassword').invalid
-                    ? 'passwords do not match'
-                    : null,
-            ),
-        );
-    },
-);
-```
-
-> `form_field_confirmPassword` is the field identifier used in all application to retrieve data. You can use a constant to avoid typos.
-
-You'll need to update password input to update confirm state on password update !
-
-```dart
-return BlocBuilder<SignUpCubit, SignUpState>(
-    builder: (context, state) {
-    return TextField(
-        onChanged: (password) {
-        context.read<SignUpCubit>().passwordChanged(password);
-        context.read<SignUpCubit>().dataChanged(
-                'form_field_confirmPassword',
-                ConfirmedPassword.dirty(
-                password: password,
-                value: context
-                    .read<SignUpCubit>()
-                    .state
-                    .data!
-                    .input('form_field_confirmPassword')
-                    .value,
-                ),
-            );
-        },
-        obscureText: true,
-        decoration: InputDecoration(
-            labelText: 'password',
-            errorText: state.password.invalid ? 'invalid password' : null,
-        ),
-    );
-    },
-);
-```
-
-> Here you call standard `passwordChanged()` AND `dataChanged()`.
-
-And voilà !
-
-### Create Firestore Document on Sign Up
-
-In this recipe we'll se how to create a Firestore Document on sign up success.
-
-First create a callback function:
-
-```dart
-Future<void> onSignUpSuccess(SignUpState state, String? uid) async {
-    if (uid != null) {
-        final user = {
-            'uid': uid,
-            'email': state.email.value,
-            ...state.data.toMap(),
-        };
-        await FirebaseFirestore.instance.collection('users').doc(uid).set(user);
-    }
-}
-```
-
-Then create SignUpCubit with custom entries and register callback:
-
-```dart
-SignUpCubit _signUpCubit = SignUpCubit(
-    authenticationRepository: _authenticationRepository,
-    authenticationCubit: _authenticationCubit,
-    entries: const FormData([
-        FormEntry('form_field_name', Name.pure(), fieldName: 'name'),
-        FormEntry('form_field_phone', Phone.pure(), fieldName: 'phone'),
-        FormEntry('form_field_confirmPassword', ConfirmedPassword.pure(), export: false),
-    ]),
-    onSignUpSuccess: onSignUpSuccess,
-);
-```
-
-> Use `fieldName` and `export` to control `.toMap()` result on FormData ! Useful to disable exportation of sensible data like passwords.
-
-Create widgets for each inputs:
-
-```dart
-class _PhoneInput extends StatelessWidget {
-    @override
-    Widget build(BuildContext context) {
-        return BlocBuilder<SignUpCubit, SignUpState>(
-            builder: (context, state) {
-                return TextField(
-                onChanged: (phone) => context
-                    .read<SignUpCubit>()
-                    .dataChanged('form_field_phone', Phone.dirty(phone)),
-                keyboardType: TextInputType.phone,
-                decoration: InputDecoration(
-                    labelText: 'phone',
-                    helperText: '',
-                    errorText: state.data!.input('form_field_phone').invalid
-                        ? 'invalid phone'
-                        : null,
-                    ),
-                );
-            },
-        );
-    }
-}
-```
-
-> Create widgets for Name and ConfirmedPassword too.
-
-Then add a sign up button with:
-
-```dart
-context.read<SignUpCubit>().signUpFormSubmitted()
-```
-
-And voilà, a document with `uid` as id, and fields `email`, `name`, `phone`, `uid` will be create in `users` collection.

packages/wyatt_authentication_bloc/example/.gitignore

@@ -8,6 +8,7 @@
 .buildlog/
 .history
 .svn/
+migrate_working_dir/
 
 # IntelliJ related
 *.iml
@@ -43,6 +44,4 @@ app.*.map.json
 # Android Studio will place build artifacts here
 /android/app/debug
 /android/app/profile
-/android/app/release
+/android/app/release
-
-lib/firebase_options.dart

packages/wyatt_authentication_bloc/example/.metadata

@@ -1,10 +1,30 @@
 # This file tracks properties of this Flutter project.
 # Used by Flutter tool to assess capabilities and perform upgrades etc.
 #
-# This file should be version controlled and should not be manually edited.
+# This file should be version controlled.
 
 version:
-  revision: 5464c5bac742001448fe4fc0597be939379f88ea
+  revision: e99c9c7cd9f6c0b2f8ae6e3ebfd585239f5568f4
   channel: stable
 
 project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: e99c9c7cd9f6c0b2f8ae6e3ebfd585239f5568f4
+      base_revision: e99c9c7cd9f6c0b2f8ae6e3ebfd585239f5568f4
+    - platform: ios
+      create_revision: e99c9c7cd9f6c0b2f8ae6e3ebfd585239f5568f4
+      base_revision: e99c9c7cd9f6c0b2f8ae6e3ebfd585239f5568f4
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

packages/wyatt_authentication_bloc/example/.vscode/launch.json

@@ -4,7 +4,7 @@
  * -----
  * File: launch.json
  * Created Date: 19/08/2022 15:12:25
- * Last Modified: 19/08/2022 15:22:02
+ * Last Modified: Tue Dec 13 2022
  * -----
  * Copyright (c) 2022
  */
@@ -15,11 +15,18 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "name": "example_router",
+            "name": "Mock",
             "request": "launch",
             "type": "dart",
             "program": "lib/main.dart",
             "flutterMode": "debug"
+        },
+        {
+            "name": "Firebase",
+            "request": "launch",
+            "type": "dart",
+            "program": "lib/main_firebase.dart",
+            "flutterMode": "debug"
         }
     ]
 }

packages/wyatt_authentication_bloc/example/CHANGELOG.md

@@ -1,4 +0,0 @@
-## 1.0.1
-
- - Update a dependency to the latest release.
-

packages/wyatt_authentication_bloc/example/README.md

@@ -1,4 +1,4 @@
-# authentication_bloc_example
+# example_router
 
 A new Flutter project.
 
@@ -8,9 +8,9 @@ This project is a starting point for a Flutter application.
 
 A few resources to get you started if this is your first Flutter project:
 
-- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
+- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
+- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
 
-For help getting started with Flutter, view our
+For help getting started with Flutter development, view the
-[online documentation](https://flutter.dev/docs), which offers tutorials,
+[online documentation](https://docs.flutter.dev/), which offers tutorials,
 samples, guidance on mobile development, and a full API reference.

packages/wyatt_authentication_bloc/example/android/app/build.gradle

@@ -30,6 +30,7 @@ apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
 
 android {
     compileSdkVersion flutter.compileSdkVersion
+    ndkVersion flutter.ndkVersion
 
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_1_8
@@ -46,7 +47,9 @@ android {
 
     defaultConfig {
         // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
-        applicationId "com.example.authentication_bloc_example"
+        applicationId "com.example.example_router"
+        // You can update the following values to match your application needs.
+        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
         minSdkVersion 21
         targetSdkVersion flutter.targetSdkVersion
         versionCode flutterVersionCode.toInteger()

packages/wyatt_authentication_bloc/example/android/app/google-services.json

@@ -1,91 +0,0 @@
-{
-  "project_info": {
-    "project_number": "136771801992",
-    "firebase_url": "https://tchat-beta.firebaseio.com",
-    "project_id": "tchat-beta",
-    "storage_bucket": "tchat-beta.appspot.com"
-  },
-  "client": [
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:136771801992:android:4ff419f07afdad6097203d",
-        "android_client_info": {
-          "package_name": "com.example.authentication_bloc_example"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "136771801992-nps7ic22shstvgdv0c2ojvbkj3dkntum.apps.googleusercontent.com",
-          "client_type": 1,
-          "android_info": {
-            "package_name": "com.example.authentication_bloc_example",
-            "certificate_hash": "5d8790309e13b68c35e5d4d8437c35c6d15e6131"
-          }
-        },
-        {
-          "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyAYS14uXupkS158Q5QAFP1864UrUN_yDSk"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "136771801992-e585bm1n9b3lv89t4phrl9u0glsg52ua.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.example.example"
-              }
-            }
-          ]
-        }
-      }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:136771801992:android:8482c9b90bc29de697203d",
-        "android_client_info": {
-          "package_name": "com.example.crud_bloc_example"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyAYS14uXupkS158Q5QAFP1864UrUN_yDSk"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "136771801992-e585bm1n9b3lv89t4phrl9u0glsg52ua.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.example.example"
-              }
-            }
-          ]
-        }
-      }
-    }
-  ],
-  "configuration_version": "1"
-}

packages/wyatt_authentication_bloc/example/android/app/src/debug/AndroidManifest.xml

@@ -1,6 +1,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.example.authentication_bloc_example">
+    package="com.example.example_router">
-    <!-- Flutter needs it to communicate with the running application
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
          to allow setting breakpoints, to provide hot reload, etc.
     -->
     <uses-permission android:name="android.permission.INTERNET"/>

packages/wyatt_authentication_bloc/example/android/app/src/main/AndroidManifest.xml

@@ -1,7 +1,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.example.authentication_bloc_example">
+    package="com.example.example_router">
    <application
-        android:label="authentication_bloc_example"
+        android:label="example_router"
         android:name="${applicationName}"
         android:icon="@mipmap/ic_launcher">
         <activity

packages/wyatt_authentication_bloc/example/android/app/src/main/res/values-night/styles.xml

@@ -3,7 +3,7 @@
     <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is on -->
     <style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
         <!-- Show a splash screen on the activity. Automatically removed when
-             Flutter draws its first frame -->
+             the Flutter engine draws its first frame -->
         <item name="android:windowBackground">@drawable/launch_background</item>
     </style>
     <!-- Theme applied to the Android Window as soon as the process has started.

packages/wyatt_authentication_bloc/example/android/app/src/main/res/values/styles.xml

@@ -3,7 +3,7 @@
     <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
     <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
         <!-- Show a splash screen on the activity. Automatically removed when
-             Flutter draws its first frame -->
+             the Flutter engine draws its first frame -->
         <item name="android:windowBackground">@drawable/launch_background</item>
     </style>
     <!-- Theme applied to the Android Window as soon as the process has started.

packages/wyatt_authentication_bloc/example/android/app/src/profile/AndroidManifest.xml

@@ -1,6 +1,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.example.authentication_bloc_example">
+    package="com.example.example_router">
-    <!-- Flutter needs it to communicate with the running application
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
          to allow setting breakpoints, to provide hot reload, etc.
     -->
     <uses-permission android:name="android.permission.INTERNET"/>

packages/wyatt_authentication_bloc/example/android/build.gradle

@@ -6,7 +6,7 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:4.1.0'
+        classpath 'com.android.tools.build:gradle:7.1.2'
         // START: FlutterFire Configuration
         classpath 'com.google.gms:google-services:4.3.10'
         // END: FlutterFire Configuration

packages/wyatt_authentication_bloc/example/android/gradle/wrapper/gradle-wrapper.properties

@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-all.zip

packages/wyatt_authentication_bloc/example/ios/Podfile.lock

@@ -0,0 +1,107 @@
+PODS:
+  - AppAuth (1.6.0):
+    - AppAuth/Core (= 1.6.0)
+    - AppAuth/ExternalUserAgent (= 1.6.0)
+  - AppAuth/Core (1.6.0)
+  - AppAuth/ExternalUserAgent (1.6.0):
+    - AppAuth/Core
+  - Firebase/Auth (10.3.0):
+    - Firebase/CoreOnly
+    - FirebaseAuth (~> 10.3.0)
+  - Firebase/CoreOnly (10.3.0):
+    - FirebaseCore (= 10.3.0)
+  - firebase_auth (4.2.0):
+    - Firebase/Auth (= 10.3.0)
+    - firebase_core
+    - Flutter
+  - firebase_core (2.4.0):
+    - Firebase/CoreOnly (= 10.3.0)
+    - Flutter
+  - FirebaseAuth (10.3.0):
+    - FirebaseCore (~> 10.0)
+    - GoogleUtilities/AppDelegateSwizzler (~> 7.8)
+    - GoogleUtilities/Environment (~> 7.8)
+    - GTMSessionFetcher/Core (< 4.0, >= 2.1)
+  - FirebaseCore (10.3.0):
+    - FirebaseCoreInternal (~> 10.0)
+    - GoogleUtilities/Environment (~> 7.8)
+    - GoogleUtilities/Logger (~> 7.8)
+  - FirebaseCoreInternal (10.3.0):
+    - "GoogleUtilities/NSData+zlib (~> 7.8)"
+  - Flutter (1.0.0)
+  - google_sign_in_ios (0.0.1):
+    - Flutter
+    - GoogleSignIn (~> 6.2)
+  - GoogleSignIn (6.2.4):
+    - AppAuth (~> 1.5)
+    - GTMAppAuth (~> 1.3)
+    - GTMSessionFetcher/Core (< 3.0, >= 1.1)
+  - GoogleUtilities/AppDelegateSwizzler (7.10.0):
+    - GoogleUtilities/Environment
+    - GoogleUtilities/Logger
+    - GoogleUtilities/Network
+  - GoogleUtilities/Environment (7.10.0):
+    - PromisesObjC (< 3.0, >= 1.2)
+  - GoogleUtilities/Logger (7.10.0):
+    - GoogleUtilities/Environment
+  - GoogleUtilities/Network (7.10.0):
+    - GoogleUtilities/Logger
+    - "GoogleUtilities/NSData+zlib"
+    - GoogleUtilities/Reachability
+  - "GoogleUtilities/NSData+zlib (7.10.0)"
+  - GoogleUtilities/Reachability (7.10.0):
+    - GoogleUtilities/Logger
+  - GTMAppAuth (1.3.1):
+    - AppAuth/Core (~> 1.6)
+    - GTMSessionFetcher/Core (< 3.0, >= 1.5)
+  - GTMSessionFetcher/Core (2.3.0)
+  - PromisesObjC (2.1.1)
+
+DEPENDENCIES:
+  - firebase_auth (from `.symlinks/plugins/firebase_auth/ios`)
+  - firebase_core (from `.symlinks/plugins/firebase_core/ios`)
+  - Flutter (from `Flutter`)
+  - google_sign_in_ios (from `.symlinks/plugins/google_sign_in_ios/ios`)
+
+SPEC REPOS:
+  trunk:
+    - AppAuth
+    - Firebase
+    - FirebaseAuth
+    - FirebaseCore
+    - FirebaseCoreInternal
+    - GoogleSignIn
+    - GoogleUtilities
+    - GTMAppAuth
+    - GTMSessionFetcher
+    - PromisesObjC
+
+EXTERNAL SOURCES:
+  firebase_auth:
+    :path: ".symlinks/plugins/firebase_auth/ios"
+  firebase_core:
+    :path: ".symlinks/plugins/firebase_core/ios"
+  Flutter:
+    :path: Flutter
+  google_sign_in_ios:
+    :path: ".symlinks/plugins/google_sign_in_ios/ios"
+
+SPEC CHECKSUMS:
+  AppAuth: 8fca6b5563a5baef2c04bee27538025e4ceb2add
+  Firebase: f92fc551ead69c94168d36c2b26188263860acd9
+  firebase_auth: 579a0dc15451491cc83fccaa5102296635f24938
+  firebase_core: 6f2f753e316765799d88568232ed59e300ff53db
+  FirebaseAuth: 0e415d29d846c1dce2fb641e46f35e9888d9bec6
+  FirebaseCore: 988754646ab3bd4bdcb740f1bfe26b9f6c0d5f2a
+  FirebaseCoreInternal: 29b76f784d607df8b2a1259d73c3f04f1210137b
+  Flutter: f04841e97a9d0b0a8025694d0796dd46242b2854
+  google_sign_in_ios: 4f85eb9f937450765c8573bb85fd8cd6a5af675c
+  GoogleSignIn: 5651ce3a61e56ca864160e79b484cd9ed3f49b7a
+  GoogleUtilities: bad72cb363809015b1f7f19beb1f1cd23c589f95
+  GTMAppAuth: 0ff230db599948a9ad7470ca667337803b3fc4dd
+  GTMSessionFetcher: 3a63d75eecd6aa32c2fc79f578064e1214dfdec2
+  PromisesObjC: ab77feca74fa2823e7af4249b8326368e61014cb
+
+PODFILE CHECKSUM: ef19549a9bc3046e7bb7d2fab4d021637c0c58a3
+
+COCOAPODS: 1.11.3