@pi-spi/app 0.0.0-stage → 1.2.0

package/src/core/api_mock_data.ts

@@ -0,0 +1,51 @@
+// Registre statique des réponses mockées du mode démo (assets/json/), équivalent
+// de `rootBundle.loadString('packages/bceao_pispi_app/assets/json/...')` en Flutter :
+// Metro n'accepte que des `require` statiques, d'où cette table.
+/* eslint-disable @typescript-eslint/no-require-imports */
+export const mockJsonFiles: Record<string, unknown> = {
+  'alias/get_alias.json': require('../../assets/json/alias/get_alias.json'),
+  'alias/post_alias_mbno.json': require('../../assets/json/alias/post_alias_mbno.json'),
+  'alias/post_alias_shid.json': require('../../assets/json/alias/post_alias_shid.json'),
+  'alias/revendications_+221771141100-1741866844571.json': require('../../assets/json/alias/revendications_+221771141100-1741866844571.json'),
+  'alias/revendications_+221773242400-1741866854571.json': require('../../assets/json/alias/revendications_+221773242400-1741866854571.json'),
+  'alias/revendications_post.json': require('../../assets/json/alias/revendications_post.json'),
+  'alias/revendications_put_rejets.json': require('../../assets/json/alias/revendications_put_rejets.json'),
+  'alias/revendications_put_reponses.json': require('../../assets/json/alias/revendications_put_reponses.json'),
+  'comptes/get_compte_details.json': require('../../assets/json/comptes/get_compte_details.json'),
+  'comptes/get_compte_solde.json': require('../../assets/json/comptes/get_compte_solde.json'),
+  'notifications/get_liste_by_type.json': require('../../assets/json/notifications/get_liste_by_type.json'),
+  'notifications/get_liste.json': require('../../assets/json/notifications/get_liste.json'),
+  'subscriptions/get_liste.json': require('../../assets/json/subscriptions/get_liste.json'),
+  'transferts/get_annulation.json': require('../../assets/json/transferts/get_annulation.json'),
+  'transferts/get_echouee.json': require('../../assets/json/transferts/get_echouee.json'),
+  'transferts/get_participants.json': require('../../assets/json/transferts/get_participants.json'),
+  'transferts/get_rtp_initiee.json': require('../../assets/json/transferts/get_rtp_initiee.json'),
+  'transferts/get_rtp_recue_401.json': require('../../assets/json/transferts/get_rtp_recue_401.json'),
+  'transferts/get_rtp_recue_500_debitdiff.json': require('../../assets/json/transferts/get_rtp_recue_500_debitdiff.json'),
+  'transferts/get_rtp_recue_500_picash.json': require('../../assets/json/transferts/get_rtp_recue_500_picash.json'),
+  'transferts/get_rtp_recue_500_pico.json': require('../../assets/json/transferts/get_rtp_recue_500_pico.json'),
+  'transferts/get_rtp_recue_521_debitdiff.json': require('../../assets/json/transferts/get_rtp_recue_521_debitdiff.json'),
+  'transferts/get_rtp_recue_631_split.json': require('../../assets/json/transferts/get_rtp_recue_631_split.json'),
+  'transferts/get_rtp_recue_631.json': require('../../assets/json/transferts/get_rtp_recue_631.json'),
+  'transferts/get_transfert_emis_401.json': require('../../assets/json/transferts/get_transfert_emis_401.json'),
+  'transferts/get_transfert_emis_alias.json': require('../../assets/json/transferts/get_transfert_emis_alias.json'),
+  'transferts/get_transfert_emis_compte.json': require('../../assets/json/transferts/get_transfert_emis_compte.json'),
+  'transferts/get_transfert_emis_split.json': require('../../assets/json/transferts/get_transfert_emis_split.json'),
+  'transferts/get_transfert_recu_alias.json': require('../../assets/json/transferts/get_transfert_recu_alias.json'),
+  'transferts/get_transfert_recu_iban.json': require('../../assets/json/transferts/get_transfert_recu_iban.json'),
+  'transferts/get_transferts_recents.json': require('../../assets/json/transferts/get_transferts_recents.json'),
+  'transferts/get_transferts_search_old.json': require('../../assets/json/transferts/get_transferts_search_old.json'),
+  'transferts/get_transferts_search.json': require('../../assets/json/transferts/get_transferts_search.json'),
+  'transferts/post_rtp_201.json': require('../../assets/json/transferts/post_rtp_201.json'),
+  'transferts/post_transfert_alias.json': require('../../assets/json/transferts/post_transfert_alias.json'),
+  'transferts/post_transfert_iban.json': require('../../assets/json/transferts/post_transfert_iban.json'),
+  'transferts/post_transfert_othr.json': require('../../assets/json/transferts/post_transfert_othr.json'),
+  'transferts/post_transfert_qrcode.json': require('../../assets/json/transferts/post_transfert_qrcode.json'),
+  'transferts/put_abonnement_fin.json': require('../../assets/json/transferts/put_abonnement_fin.json'),
+  'transferts/put_abonnement_frequence.json': require('../../assets/json/transferts/put_abonnement_frequence.json'),
+  'transferts/put_abonnement_once.json': require('../../assets/json/transferts/put_abonnement_once.json'),
+  'transferts/put_annulation.json': require('../../assets/json/transferts/put_annulation.json'),
+  'transferts/put_confirmation.json': require('../../assets/json/transferts/put_confirmation.json'),
+  'transferts/put_return_annulation.json': require('../../assets/json/transferts/put_return_annulation.json'),
+  'transferts/put_return.json': require('../../assets/json/transferts/put_return.json'),
+};

package/src/core/assets.ts

@@ -0,0 +1,224 @@
+/* eslint-disable @typescript-eslint/no-require-imports */
+
+/**
+ * Tous les assets du SDK, regroupés dans un seul fichier (comme assets.dart
+ * dans le SDK Flutter) : une faute de frappe dans un chemin est détectée au
+ * build par Metro, et chaque asset n'est déclaré qu'une seule fois.
+ *
+ * Metro n'accepte que des `require` statiques : chaque asset est donc
+ * référencé ici par un `require` vers le dossier `assets/` du package (un
+ * module Metro, accepté par `Image` de react-native comme par expo-image).
+ */
+export class Images {
+  /** Constructeur privé : la classe n'est jamais instanciée. */
+  private constructor() {}
+
+  // Logo Spi Dark
+  static readonly logo: number = require('../../assets/images/logo.png');
+  static readonly ic: number = require('../../assets/images/ic.png');
+  static readonly logoDark: number = require('../../assets/images/spi-150.png');
+  static readonly logoSpiLight: number = require('../../assets/images/logo_spi_light.png');
+  static readonly logoSpiDark: number = require('../../assets/images/logo_spi_dark.png');
+
+  // Store
+  static readonly playstore: number = require('../../assets/icons/playstore.png');
+  static readonly appstore: number = require('../../assets/icons/appstore.png');
+
+  // Chemin vers les vidéos d'introduction
+  static readonly introductionVideo1: number = require('../../assets/videos/onboarding_fr_1.mp4');
+  static readonly introductionVideo2: number = require('../../assets/videos/onboarding_fr_2.mp4');
+  static readonly introductionVideo3: number = require('../../assets/videos/onboarding_fr_3.mp4');
+  static readonly introductionVideo4: number = require('../../assets/videos/onboarding_fr_4.mp4');
+  static readonly introductionVideo5: number = require('../../assets/videos/onboarding_fr_5.mp4');
+  static readonly introductionVideo6: number = require('../../assets/videos/onboarding_fr_6.mp4');
+
+  // Chemin vers les vidéos d'introduction en anglais
+  static readonly introductionVideo1En: number = require('../../assets/videos/onboarding_en_1.mp4');
+  static readonly introductionVideo2En: number = require('../../assets/videos/onboarding_en_2.mp4');
+  static readonly introductionVideo3En: number = require('../../assets/videos/onboarding_en_3.mp4');
+  static readonly introductionVideo4En: number = require('../../assets/videos/onboarding_en_4.mp4');
+  static readonly introductionVideo5En: number = require('../../assets/videos/onboarding_en_5.mp4');
+  static readonly introductionVideo6En: number = require('../../assets/videos/onboarding_en_6.mp4');
+
+  // Keyboard icons
+  static readonly virtualKeyboardIconsFace: number = require('../../assets/icons/face.png');
+  // face.png utilisé aussi pour Autoriser Biométrie
+
+  // Permissions application
+  static readonly identificationPermissions: Record<string, number> = {
+    fingerprint: require('../../assets/images/permission_fingerprint.png'),
+    face: require('../../assets/images/permission_face.png'),
+    all: require('../../assets/images/permission_fingerprint.png'),
+  };
+  static readonly permissionNotification: number = require('../../assets/images/permission_notification.png');
+  static readonly permissionContact: number = require('../../assets/images/permission_contact.png');
+
+  // Alias
+  static readonly aliasIconUser: number = require('../../assets/icons/user.png');
+  static readonly aliasIconPhone: number = require('../../assets/icons/phone.png');
+  static readonly iconBf: number = require('../../assets/icons/bf.png');
+  static readonly iconBj: number = require('../../assets/icons/bj.png');
+  static readonly iconCi: number = require('../../assets/icons/ci.png');
+  static readonly iconGw: number = require('../../assets/icons/gw.png');
+  static readonly iconMa: number = require('../../assets/icons/ma.png');
+  static readonly iconNe: number = require('../../assets/icons/ne.png');
+  static readonly iconSn: number = require('../../assets/icons/sn.png');
+  static readonly iconTg: number = require('../../assets/icons/tg.png');
+  static readonly aliasIcon: number = require('../../assets/icons/arobase_alias.png');
+
+  // Loading - Validation
+  static readonly gifDone: number = require('../../assets/gif/done.gif');
+  static readonly gifError: number = require('../../assets/gif/error.gif');
+  static readonly gifLogoLoading: number = require('../../assets/gif/logo.gif');
+
+  // Home page
+  static readonly iconAnalytique: number = require('../../assets/icons/analytique.png');
+  static readonly arrowUp: number = require('../../assets/icons/arrow_up.png');
+  static readonly arrowDown: number = require('../../assets/icons/arrow_down.png');
+  static readonly homeFooterHome: number = require('../../assets/icons/home_outline.png'); // .svg en Flutter : Metro ne charge pas de SVG sans transformer, la version .png est utilisée.
+  static readonly homeFooterQrcode: number = require('../../assets/icons/qrcode.png');
+  static readonly homeFooterTransfer: number = require('../../assets/icons/transfer.png');
+  static readonly iconEdit: number = require('../../assets/icons/edit.png');
+  static readonly iconAdd: number = require('../../assets/icons/add.png');
+  static readonly iconDelete: number = require('../../assets/icons/delete.png');
+  static readonly iconSend: number = require('../../assets/icons/send.png');
+  static readonly iconHome: number = require('../../assets/icons/icon_home.png');
+
+  // Home page - More menu
+  static readonly homeMoreFindSubscription: number = require('../../assets/icons/find_subscription.png');
+  static readonly homeMoreSplitPayments: number = require('../../assets/icons/split_payments.png');
+  static readonly homeMoreSavingBox: number = require('../../assets/icons/saving_box.png');
+  static readonly homeMoreSetBudgets: number = require('../../assets/icons/set_budgets.png');
+  static readonly homeMoreAddWidget: number = require('../../assets/icons/add_widget.png');
+
+  // Profile page
+  static readonly iconsAddUser: number = require('../../assets/icons/user_add.png');
+  // user_circle.png est utilisé aussi pour personnes de confiance
+  // dans Sécurité et confidentialité
+  static readonly iconsCircleUser: number = require('../../assets/icons/user_circle.png');
+  static readonly iconsHelp: number = require('../../assets/icons/help.png');
+  static readonly iconsInfo: number = require('../../assets/icons/info.png');
+  static readonly iconsSecurity: number = require('../../assets/icons/security.png');
+  static readonly iconsSetting: number = require('../../assets/icons/setting.png');
+  static readonly iconsLogout: number = require('../../assets/icons/logout.png');
+  static readonly iconsDetailsCompte: number = require('../../assets/icons/compte.png');
+
+  // Profile Securité et confidentialité page
+  static readonly iconsLock: number = require('../../assets/icons/lock.png');
+  static readonly iconsBlacklist: number = require('../../assets/icons/user_delete.png');
+  static readonly iconsAppareils: number = require('../../assets/icons/mobile.png');
+  static readonly iconsBiometry: number = require('../../assets/icons/user.png');
+  static readonly iconsEyeOff: number = require('../../assets/icons/eye_off.png');
+  static readonly iconsMobileShake: number = require('../../assets/icons/mobile_shake.png');
+
+  static readonly imagesEyeOffIllustration: number = require('../../assets/images/illustration_hide_amount.png');
+
+  // Transactions
+  static readonly transactionAvatar: number = require('../../assets/images/avatar.png');
+  static readonly iconTransactionSendByAlias: number = require('../../assets/icons/alias.png');
+  static readonly iconTransactionSendByIban: number = require('../../assets/icons/bank.png');
+  static readonly iconTransactionSendByOthr: number = require('../../assets/icons/other_account.png');
+  static readonly iconTransactionSendByNewContact: number = require('../../assets/icons/person.png');
+  static readonly iconsPiBadge: number = require('../../assets/icons/pi_badge.png');
+  static readonly ticketCaisse: number = require('../../assets/images/ticket_caisse.png');
+
+  // Transactions Forms
+  static readonly iconTransactionPasteAlias: number = require('../../assets/icons/paste-alias.png');
+
+  // Transaction Details
+  static readonly transactionPartager: number = require('../../assets/icons/partager.png');
+  static readonly transactionPlanifier: number = require('../../assets/icons/planifier.png');
+  static readonly transactionCancel: number = require('../../assets/icons/x-mark.png');
+
+  // QR Code
+  static readonly iconsPiOctogone: number = require('../../assets/icons/pi_octogone.png');
+  static readonly iconsQr: number = require('../../assets/icons/logo_qr.png');
+  // TODO change image
+  static readonly iconFlashOn: number = require('../../assets/icons/flash.png');
+  static readonly iconFlashOff: number = require('../../assets/icons/flash.png');
+  static readonly iconsGalerie: number = require('../../assets/icons/galerie.png');
+
+  // Categorie
+  static readonly categorie: number = require('../../assets/icons/categories/categorie.png');
+  static readonly categorieImageSelect: number = require('../../assets/icons/categories/categorie-edit-image.png');
+  static readonly iconsFacture: number = require('../../assets/icons/categories/facture.png');
+  static readonly iconsCash: number = require('../../assets/icons/categories/cash.png');
+  static readonly iconsRestaurant: number = require('../../assets/icons/categories/restaurant.png');
+  static readonly iconsShopping: number = require('../../assets/icons/categories/shopping.png');
+  static readonly iconsLoisir: number = require('../../assets/icons/categories/loisir.png');
+  static readonly iconsAlimentation: number = require('../../assets/icons/categories/alimentation.png');
+  static readonly iconsSante: number = require('../../assets/icons/categories/sante.png');
+  static readonly iconsLogement: number = require('../../assets/icons/categories/logement.png');
+  static readonly iconsTransfert: number = require('../../assets/icons/categories/transfert.png');
+  static readonly iconsTransaction: number = require('../../assets/icons/categories/transaction.png');
+  static readonly iconsSoinspersonnel: number = require('../../assets/icons/categories/soins.png');
+  static readonly iconsBudget: number = require('../../assets/icons/categories/budget.png');
+  static readonly iconsEconomie: number = require('../../assets/icons/categories/economie.png');
+  static readonly iconsTransport: number = require('../../assets/icons/categories/transport.png');
+  static readonly iconsVoyage: number = require('../../assets/icons/categories/voyage.png');
+  static readonly iconsDepensereligieuse: number = require('../../assets/icons/categories/depensereligieuse.png');
+  static readonly iconsDon: number = require('../../assets/icons/categories/don.png');
+  static readonly iconsEducation: number = require('../../assets/icons/categories/education.png');
+  static readonly iconsAutre: number = require('../../assets/icons/categories/autre.png');
+
+  static readonly iconsCafe: number = require('../../assets/icons/categories/cafe.png');
+  static readonly iconsSport: number = require('../../assets/icons/categories/running.png');
+  static readonly iconsCadeau: number = require('../../assets/icons/categories/gift.png');
+  static readonly iconsBeaute: number = require('../../assets/icons/categories/beaute.png');
+  static readonly iconsBoissons: number = require('../../assets/icons/categories/boissons.png');
+  static readonly iconsDonation: number = require('../../assets/icons/categories/donation.png');
+  static readonly categorieIconEmoji: number = require('../../assets/icons/categories/emoji.png');
+  static readonly categorieIconImage: number = require('../../assets/icons/categories/image.png');
+  static readonly categorieIconPhoto: number = require('../../assets/icons/categories/photo.png');
+
+  // Notification
+  static readonly notificationCloche: number = require('../../assets/images/notification_cloche.png');
+  static readonly notificationAliasClaim: number = require('../../assets/icons/arobase_alias.png');
+  static readonly notificationAnnulation: number = require('../../assets/icons/demande-annulation.png');
+
+  // Subscription
+  static readonly subscriptionCalendar: number = require('../../assets/images/subscription.png');
+  static readonly iconRepeat: number = require('../../assets/icons/repeat.png');
+
+  // Profile Paramètres de l’application page
+  static readonly iconsLanguage: number = require('../../assets/icons/language.png');
+  static readonly iconsLanguageFr: number = require('../../assets/icons/language_fr.png');
+  static readonly iconsLanguageEn: number = require('../../assets/icons/language_en.png');
+  static readonly iconsLanguagePt: number = require('../../assets/icons/language_pt.png');
+  static readonly iconsTheme: number = require('../../assets/icons/theme.png');
+  static readonly iconsCloche: number = require('../../assets/icons/cloche.png');
+  static readonly imageNotifStyleDialog: number = require('../../assets/images/notif_style_dialog.png');
+  static readonly imageNotifStyleNone: number = require('../../assets/images/notif_style_none.png');
+  static readonly imageNotifStyleSnackbar: number = require('../../assets/images/notif_style_snackbar.png');
+
+  static readonly imageThemeSystem: number = require('../../assets/images/theme_system.png');
+  static readonly imageThemeLight: number = require('../../assets/images/theme_light.jpeg');
+  static readonly imageThemeLightBlue: number = require('../../assets/images/theme_light_blue.jpeg');
+  static readonly imageThemeLightGreen: number = require('../../assets/images/theme_light_green.jpeg');
+  static readonly imageThemeLightYellow: number = require('../../assets/images/theme_light_yellow.jpeg');
+  static readonly imageThemeLightRed: number = require('../../assets/images/theme_light_red.jpeg');
+  static readonly imageThemeLightOrange: number = require('../../assets/images/theme_light_orange.jpeg');
+  static readonly imageThemeLightPurple: number = require('../../assets/images/theme_light_purple.jpeg');
+  static readonly imageThemeLightPink: number = require('../../assets/images/theme_light_pink.jpeg');
+  static readonly imageThemeDark: number = require('../../assets/images/theme_dark.jpeg');
+
+  static readonly imageHomeThemeDefault: number = require('../../assets/images/home_default.jpeg');
+  static readonly imageHomeThemeWithQr: number = require('../../assets/images/home_with_qr.jpeg');
+
+  // Economie
+  static readonly savingBox: number = require('../../assets/images/economie.png');
+  static readonly savingIconDefault: number = require('../../assets/images/saving_default.png');
+  static readonly savingAdd: number = require('../../assets/icons/saving_add.png');
+  static readonly savingWithdraw: number = require('../../assets/icons/saving_withdraw.png');
+
+  static readonly iconTarget: number = require('../../assets/icons/target.png');
+  static readonly iconFlag: number = require('../../assets/icons/flag.png');
+  static readonly iconList: number = require('../../assets/icons/list.png');
+  static readonly iconFraction: number = require('../../assets/icons/fraction.png');
+  static readonly iconArrondi: number = require('../../assets/icons/arrondi.png');
+
+  // Notification
+  static readonly iconAuthPhone: number = require('../../assets/icons/auth_phone.png');
+  static readonly iconAuthLogin: number = require('../../assets/icons/auth_login.png');
+
+}

package/src/core/bloc.ts

@@ -0,0 +1,156 @@
+import { StreamController, type Stream } from './stream';
+
+/**
+ * Mini-implémentation du pattern BLoC (`package:flutter_bloc`) utilisé par
+ * tous les modules du SDK Flutter, pour que chaque `*_bloc.dart`,
+ * `*_event.dart` et `*_state.dart` se traduise presque ligne à ligne :
+ *
+ * ```ts
+ * class ConfigBloc extends Bloc<ConfigEvent, ConfigState> {
+ *   constructor(readonly configInputPort: ConfigInputPort) {
+ *     super(new ConfigLoadedState(configInputPort.recuperer(), null));
+ *     this.on(ConfigChangeEvent, (event, emit) => this.onConfigChangeEvent(event, emit));
+ *   }
+ * }
+ * ```
+ *
+ * Les liaisons React (`BlocProvider`, `useBlocBuilder`, ...) sont dans
+ * `bloc_react.tsx`.
+ */
+
+/** Équivalent de `Emitter<S>` : n'émet plus rien une fois le handler terminé ou le bloc fermé. */
+export interface Emitter<S> {
+  (state: S): void;
+  readonly isDone: boolean;
+}
+
+/** Équivalent de `BlocObserver` (voir `Bloc.observer`). */
+export class BlocObserver {
+  onCreate(_bloc: BlocBase<unknown>): void {}
+  onEvent(_bloc: Bloc<unknown, unknown>, _event: unknown): void {}
+  onChange(_bloc: BlocBase<unknown>, _change: { currentState: unknown; nextState: unknown }): void {}
+  onError(_bloc: BlocBase<unknown>, _error: unknown): void {}
+  onClose(_bloc: BlocBase<unknown>): void {}
+}
+
+type Constructor<T> = abstract new (...args: any[]) => T;
+
+export abstract class BlocBase<S> {
+  /** Observateur global, comme `Bloc.observer` en Dart. */
+  static observer: BlocObserver = new BlocObserver();
+
+  private currentState: S;
+  private readonly controller = new StreamController<S>();
+  private closed = false;
+
+  constructor(initialState: S) {
+    this.currentState = initialState;
+    BlocBase.observer.onCreate(this as BlocBase<unknown>);
+  }
+
+  get state(): S {
+    return this.currentState;
+  }
+
+  /** Flux des nouveaux états (sans l'état courant). */
+  get stream(): Stream<S> {
+    return this.controller.stream;
+  }
+
+  get isClosed(): boolean {
+    return this.closed;
+  }
+
+  protected emitState(state: S): void {
+    if (this.closed) return;
+    // Comme en Dart : un état identique à l'état courant n'est pas réémis.
+    if (Object.is(state, this.currentState)) return;
+    BlocBase.observer.onChange(this as BlocBase<unknown>, { currentState: this.currentState, nextState: state });
+    this.currentState = state;
+    this.controller.add(state);
+  }
+
+  protected addError(error: unknown): void {
+    BlocBase.observer.onError(this as BlocBase<unknown>, error);
+  }
+
+  close(): void {
+    if (this.closed) return;
+    this.closed = true;
+    BlocBase.observer.onClose(this as BlocBase<unknown>);
+  }
+}
+
+/** Équivalent de `Cubit<S>` : l'état est modifié directement par `emit`. */
+export abstract class Cubit<S> extends BlocBase<S> {
+  emit(state: S): void {
+    this.emitState(state);
+  }
+}
+
+/** Équivalent de `Bloc<E, S>` : l'état est modifié par des handlers d'événements (`on<E>`). */
+export abstract class Bloc<E, S> extends BlocBase<S> {
+  private readonly handlers: Array<{
+    type: Constructor<E>;
+    handler: (event: any, emit: Emitter<S>) => void | Promise<void>;
+  }> = [];
+
+  /**
+   * Enregistre le handler des événements de type [type] (et de ses
+   * sous-classes), comme `on<EventType>(handler)` en Dart. Les événements
+   * sont traités de façon concurrente (transformer par défaut de flutter_bloc).
+   */
+  protected on<T extends E>(type: Constructor<T>, handler: (event: T, emit: Emitter<S>) => void | Promise<void>): void {
+    if (this.handlers.some((h) => h.type === type)) {
+      throw new Error(`on<${type.name}> a déjà été enregistré pour ${this.constructor.name}.`);
+    }
+    this.handlers.push({ type, handler });
+  }
+
+  /** Ajoute un événement au bloc (équivalent de `bloc.add(event)`). */
+  add(event: E): void {
+    if (this.isClosed) {
+      throw new Error(`Impossible d'ajouter ${String((event as object)?.constructor?.name)} : ${this.constructor.name} est fermé.`);
+    }
+    const entry = this.handlers.find((h) => event instanceof h.type);
+    if (!entry) {
+      throw new Error(
+        `${String((event as object)?.constructor?.name)} ajouté sans handler enregistré dans ${this.constructor.name} ` +
+          '(oubli d’un this.on(...) dans le constructeur ?).',
+      );
+    }
+    BlocBase.observer.onEvent(this as Bloc<unknown, unknown>, event);
+
+    let done = false;
+    const emit = ((state: S) => {
+      if (done) {
+        console.warn(`[PI-SPI] emit() appelé après la fin du handler dans ${this.constructor.name} : ignoré.`);
+        return;
+      }
+      this.emitState(state);
+    }) as Emitter<S>;
+    Object.defineProperty(emit, 'isDone', { get: () => done || this.isClosed });
+
+    try {
+      const result = entry.handler(event, emit);
+      if (result && typeof (result as Promise<void>).then === 'function') {
+        (result as Promise<void>).then(
+          () => {
+            done = true;
+          },
+          (error) => {
+            done = true;
+            this.addError(error);
+            console.error(`[PI-SPI] Erreur non gérée dans ${this.constructor.name}`, error);
+          },
+        );
+      } else {
+        done = true;
+      }
+    } catch (error) {
+      done = true;
+      this.addError(error);
+      throw error;
+    }
+  }
+}

package/src/core/bloc_react.tsx

@@ -0,0 +1,123 @@
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore, type ReactNode } from 'react';
+
+import type { BlocBase } from './bloc';
+
+/**
+ * Liaisons React du pattern BLoC (voir bloc.ts), équivalents de
+ * `BlocProvider`, `MultiBlocProvider`, `context.read`, `BlocBuilder` et
+ * `BlocListener` de flutter_bloc.
+ */
+
+type AnyBloc = BlocBase<any>;
+type BlocClass<B extends AnyBloc> = abstract new (...args: any[]) => B;
+
+const BlocRegistryContext = createContext<ReadonlyMap<Function, AnyBloc>>(new Map());
+
+/**
+ * Met à disposition des écrans descendants un ou plusieurs blocs, retrouvés
+ * ensuite par leur classe avec {@link useBloc} (≈ `MultiBlocProvider` +
+ * `BlocProvider.value`). Le provider ne ferme pas les blocs : c'est le rôle
+ * de celui qui les a créés (comme `BlocProvider.value`).
+ */
+export function BlocProvider({ blocs, children }: { blocs: AnyBloc[]; children: ReactNode }) {
+  const parent = useContext(BlocRegistryContext);
+  const registry = useMemo(() => {
+    const map = new Map(parent);
+    for (const bloc of blocs) map.set(bloc.constructor, bloc);
+    return map;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [parent, ...blocs]);
+  return <BlocRegistryContext.Provider value={registry}>{children}</BlocRegistryContext.Provider>;
+}
+
+/** Retrouve le bloc de classe [type] fourni par un {@link BlocProvider} parent (≈ `context.read<B>()`). */
+export function useBloc<B extends AnyBloc>(type: BlocClass<B>): B {
+  const registry = useContext(BlocRegistryContext);
+  const bloc = registry.get(type);
+  if (!bloc) {
+    throw new Error(`Aucun ${type.name} trouvé : ajoutez-le à un <BlocProvider> parent.`);
+  }
+  return bloc as B;
+}
+
+/** Variante de {@link useBloc} qui retourne `undefined` si aucun bloc n'est fourni. */
+export function useMaybeBloc<B extends AnyBloc>(type: BlocClass<B>): B | undefined {
+  return useContext(BlocRegistryContext).get(type) as B | undefined;
+}
+
+/**
+ * État courant de [bloc], avec re-rendu à chaque nouvel état — ou seulement
+ * quand `buildWhen(previous, current)` est vrai (≈ `BlocBuilder`).
+ */
+export function useBlocBuilder<S>(bloc: BlocBase<S>, buildWhen?: (previous: S, current: S) => boolean): S {
+  const built = useRef<{ bloc: BlocBase<S>; state: S }>({ bloc, state: bloc.state });
+  if (built.current.bloc !== bloc) built.current = { bloc, state: bloc.state };
+
+  const buildWhenRef = useRef(buildWhen);
+  buildWhenRef.current = buildWhen;
+
+  const subscribe = useCallback(
+    (onStoreChange: () => void) => {
+      const apply = (state: S) => {
+        const previous = built.current.state;
+        if (state === previous) return;
+        if (!buildWhenRef.current || buildWhenRef.current(previous, state)) {
+          built.current = { bloc, state };
+          onStoreChange();
+        }
+      };
+      const unsubscribe = bloc.stream.listen(apply);
+      // L'abonnement n'a lieu qu'après le premier rendu : un état émis
+      // entre-temps (ex. résultat quasi immédiat) serait sinon perdu.
+      apply(bloc.state);
+      return unsubscribe;
+    },
+    [bloc],
+  );
+  const getSnapshot = useCallback(() => built.current.state, []);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+
+/**
+ * Appelle [listener] à chaque nouvel état de [bloc] (ou seulement quand
+ * `listenWhen(previous, current)` est vrai), sans re-rendu (≈ `BlocListener`).
+ */
+export function useBlocListener<S>(
+  bloc: BlocBase<S>,
+  listener: (state: S) => void,
+  listenWhen?: (previous: S, current: S) => boolean,
+): void {
+  const listenerRef = useRef(listener);
+  listenerRef.current = listener;
+  const listenWhenRef = useRef(listenWhen);
+  listenWhenRef.current = listenWhen;
+
+  useEffect(() => {
+    let previous = bloc.state;
+    return bloc.stream.listen((state) => {
+      const shouldListen = !listenWhenRef.current || listenWhenRef.current(previous, state);
+      previous = state;
+      if (shouldListen) listenerRef.current(state);
+    });
+  }, [bloc]);
+}
+
+/**
+ * Crée un bloc pour la durée de vie du composant et le ferme au démontage
+ * (≈ `BlocProvider(create: ...)` local à un écran).
+ */
+export function useCreateBloc<B extends AnyBloc>(create: () => B): B {
+  const createRef = useRef(create);
+  createRef.current = create;
+  const [bloc, setBloc] = useState(create);
+  useEffect(() => {
+    // En StrictMode, l'effet est démonté puis remonté : le bloc fermé au
+    // premier démontage est alors recréé.
+    if (bloc.isClosed) {
+      setBloc(createRef.current());
+      return undefined;
+    }
+    return () => bloc.close();
+  }, [bloc]);
+  return bloc;
+}

package/src/core/compte_alias_status.ts

@@ -0,0 +1,33 @@
+import { AliasExistState, AliasNotExistState, type AliasState } from '../modules/alias/presentation/bloc/alias_state';
+
+/** État de l'alias PI-SPI du compte actif (voir `Di.activeCompteAlias`). */
+export enum CompteAliasStatus {
+  /** Vérification en cours (ex. juste après un swipe dans le carrousel). */
+  checking = 'checking',
+
+  /** Le compte a un alias : toutes les actions de l'accueil sont permises. */
+  exists = 'exists',
+
+  /** Le compte n'a pas d'alias (404). */
+  missing = 'missing',
+
+  /**
+   * L'alias n'a pas pu être vérifié (réseau, erreur serveur) : à
+   * réessayer, sans conclure que le compte n'a pas d'alias.
+   */
+  error = 'error',
+}
+
+// eslint-disable-next-line @typescript-eslint/no-namespace
+export namespace CompteAliasStatus {
+  export function hasAlias(status: CompteAliasStatus): boolean {
+    return status === CompteAliasStatus.exists;
+  }
+
+  /** Statut correspondant à la réponse de `AliasBloc.fetchFor`. */
+  export function fromState(state: AliasState): CompteAliasStatus {
+    if (state instanceof AliasExistState) return CompteAliasStatus.exists;
+    if (state instanceof AliasNotExistState) return CompteAliasStatus.missing;
+    return CompteAliasStatus.error;
+  }
+}