kasy-cli 1.37.1 → 1.39.0

package/templates/firebase/lib/core/chrome/app_bar_config.dart

@@ -0,0 +1,214 @@
+import 'package:flutter/widgets.dart';
+import 'package:kasy_kit/components/kasy_avatar_presets.dart';
+
+/// Declares what the desktop application bar ([KasyAppBar.application]) shows for
+/// a given screen.
+///
+/// The shell (`WebContentWrapper`) renders one application bar above all content
+/// and seeds it with an app-wide default. A screen overrides that default by
+/// wrapping its body in a [KasyAppBarConfigurator] (or, for screens built on
+/// `KasyOverlayScaffold`, by passing `applicationBar:`). So each screen decides
+/// its own desktop chrome — search here, just notifications there — instead of
+/// every screen sharing one fixed bar.
+///
+/// Each element has a `showX` flag (presets toggle these) plus the data/callbacks
+/// it needs when shown. A bare [KasyAppBarConfig] mirrors the app default.
+@immutable
+class KasyAppBarConfig {
+  // Search ------------------------------------------------------------------
+  final bool showSearch;
+  final TextEditingController? searchController;
+  final String searchHint;
+  final ValueChanged<String>? onSearchChanged;
+  final ValueChanged<String>? onSearchSubmitted;
+
+  // Theme toggle ------------------------------------------------------------
+  final bool showThemeToggle;
+  final VoidCallback? onToggleTheme;
+
+  // Notifications -----------------------------------------------------------
+  final bool showNotifications;
+
+  /// Custom notifications control (e.g. a data-aware bell). Replaces the built-in
+  /// bell when set and [showNotifications] is true.
+  final Widget? notifications;
+  final VoidCallback? onNotifications;
+  final bool showNotificationBadge;
+
+  // Create ------------------------------------------------------------------
+  final bool showCreate;
+  final String createLabel;
+  final VoidCallback? onCreate;
+
+  // Profile -----------------------------------------------------------------
+  final bool showAvatar;
+  final Widget? avatar;
+  final KasyAvatarGradientData? avatarGradient;
+  final VoidCallback? onAvatarTap;
+
+  /// Full control: every element shown by default (matches the app shell). Set a
+  /// `showX` to false to drop that element, or pass data/callbacks to wire it.
+  const KasyAppBarConfig({
+    this.showSearch = true,
+    this.searchController,
+    this.searchHint = 'Search...',
+    this.onSearchChanged,
+    this.onSearchSubmitted,
+    this.showThemeToggle = true,
+    this.onToggleTheme,
+    this.showNotifications = true,
+    this.notifications,
+    this.onNotifications,
+    this.showNotificationBadge = false,
+    this.showCreate = true,
+    this.createLabel = 'Create',
+    this.onCreate,
+    this.showAvatar = false,
+    this.avatar,
+    this.avatarGradient,
+    this.onAvatarTap,
+  });
+
+  /// Preset: only the theme toggle — the quietest bar (settings-style screens).
+  const KasyAppBarConfig.minimal({VoidCallback? onToggleTheme})
+      : this(
+          showSearch: false,
+          showThemeToggle: true,
+          onToggleTheme: onToggleTheme,
+          showNotifications: false,
+          showCreate: false,
+          showAvatar: false,
+        );
+
+  /// Preset: search + theme, no quick-create (browse / list screens).
+  const KasyAppBarConfig.search({
+    TextEditingController? controller,
+    String hint = 'Search...',
+    ValueChanged<String>? onChanged,
+    ValueChanged<String>? onSubmitted,
+    VoidCallback? onToggleTheme,
+  }) : this(
+          showSearch: true,
+          searchController: controller,
+          searchHint: hint,
+          onSearchChanged: onChanged,
+          onSearchSubmitted: onSubmitted,
+          showThemeToggle: true,
+          onToggleTheme: onToggleTheme,
+          showNotifications: false,
+          showCreate: false,
+          showAvatar: false,
+        );
+
+  /// Show ONLY the listed elements (everything else hidden), keeping each one's
+  /// data and callbacks from the shell default — so a screen can say "just the
+  /// notifications and theme here" without rebuilding the bell or theme wiring.
+  ///
+  /// ```dart
+  /// configure: (bar) => bar.only(search: true),            // browse screen
+  /// configure: (bar) => bar.only(notifications: true, themeToggle: true),
+  /// ```
+  KasyAppBarConfig only({
+    bool search = false,
+    bool themeToggle = false,
+    bool notifications = false,
+    bool create = false,
+    bool avatar = false,
+  }) {
+    return copyWith(
+      showSearch: search,
+      showThemeToggle: themeToggle,
+      showNotifications: notifications,
+      showCreate: create,
+      showAvatar: avatar,
+    );
+  }
+
+  /// Copy with selective overrides — handy for adapting the shell default.
+  KasyAppBarConfig copyWith({
+    bool? showSearch,
+    TextEditingController? searchController,
+    String? searchHint,
+    ValueChanged<String>? onSearchChanged,
+    ValueChanged<String>? onSearchSubmitted,
+    bool? showThemeToggle,
+    VoidCallback? onToggleTheme,
+    bool? showNotifications,
+    Widget? notifications,
+    VoidCallback? onNotifications,
+    bool? showNotificationBadge,
+    bool? showCreate,
+    String? createLabel,
+    VoidCallback? onCreate,
+    bool? showAvatar,
+    Widget? avatar,
+    KasyAvatarGradientData? avatarGradient,
+    VoidCallback? onAvatarTap,
+  }) {
+    return KasyAppBarConfig(
+      showSearch: showSearch ?? this.showSearch,
+      searchController: searchController ?? this.searchController,
+      searchHint: searchHint ?? this.searchHint,
+      onSearchChanged: onSearchChanged ?? this.onSearchChanged,
+      onSearchSubmitted: onSearchSubmitted ?? this.onSearchSubmitted,
+      showThemeToggle: showThemeToggle ?? this.showThemeToggle,
+      onToggleTheme: onToggleTheme ?? this.onToggleTheme,
+      showNotifications: showNotifications ?? this.showNotifications,
+      notifications: notifications ?? this.notifications,
+      onNotifications: onNotifications ?? this.onNotifications,
+      showNotificationBadge: showNotificationBadge ?? this.showNotificationBadge,
+      showCreate: showCreate ?? this.showCreate,
+      createLabel: createLabel ?? this.createLabel,
+      onCreate: onCreate ?? this.onCreate,
+      showAvatar: showAvatar ?? this.showAvatar,
+      avatar: avatar ?? this.avatar,
+      avatarGradient: avatarGradient ?? this.avatarGradient,
+      onAvatarTap: onAvatarTap ?? this.onAvatarTap,
+    );
+  }
+
+  @override
+  bool operator ==(Object other) {
+    return other is KasyAppBarConfig &&
+        other.showSearch == showSearch &&
+        other.searchController == searchController &&
+        other.searchHint == searchHint &&
+        other.onSearchChanged == onSearchChanged &&
+        other.onSearchSubmitted == onSearchSubmitted &&
+        other.showThemeToggle == showThemeToggle &&
+        other.onToggleTheme == onToggleTheme &&
+        other.showNotifications == showNotifications &&
+        other.notifications == notifications &&
+        other.onNotifications == onNotifications &&
+        other.showNotificationBadge == showNotificationBadge &&
+        other.showCreate == showCreate &&
+        other.createLabel == createLabel &&
+        other.onCreate == onCreate &&
+        other.showAvatar == showAvatar &&
+        other.avatar == avatar &&
+        other.avatarGradient == avatarGradient &&
+        other.onAvatarTap == onAvatarTap;
+  }
+
+  @override
+  int get hashCode => Object.hashAll(<Object?>[
+        showSearch,
+        searchController,
+        searchHint,
+        onSearchChanged,
+        onSearchSubmitted,
+        showThemeToggle,
+        onToggleTheme,
+        showNotifications,
+        notifications,
+        onNotifications,
+        showNotificationBadge,
+        showCreate,
+        createLabel,
+        onCreate,
+        showAvatar,
+        avatar,
+        avatarGradient,
+        onAvatarTap,
+      ]);
+}

package/templates/firebase/lib/core/chrome/app_bar_scope.dart

@@ -0,0 +1,102 @@
+import 'package:flutter/widgets.dart';
+import 'package:kasy_kit/core/chrome/app_bar_config.dart';
+
+/// Transforms the shell's default application-bar config into a screen's version.
+/// Receives the shell default (with its wired bell, theme toggle, etc.) so a
+/// screen only toggles/overrides what it needs and inherits the rest.
+typedef KasyAppBarConfigure = KasyAppBarConfig Function(KasyAppBarConfig base);
+
+/// Marks the subtree that sits BELOW the desktop application bar
+/// ([KasyAppBar.application]) — i.e. the shell content area, provided by
+/// [WebContentWrapper] — and carries the config the bar renders from.
+///
+/// Two jobs:
+/// 1. Presence ([of]) lets the page-level [KasyAppBar] hide on desktop INSIDE the
+///    shell (where the application bar owns the chrome) but stay visible OUTSIDE
+///    it (a full-screen pushed route), so the back button is never lost.
+/// 2. [config] is the live config the bar listens to; [defaultConfig] is the
+///    shell's app-wide default. A [KasyAppBarConfigurator] in the routed page
+///    publishes `configure(defaultConfig)` into [config] to override the bar for
+///    that screen.
+class KasyAppBarScope extends InheritedWidget {
+  /// Live config the application bar renders from. The bar listens; screens write.
+  final ValueNotifier<KasyAppBarConfig> config;
+
+  /// The shell's app-wide default — the starting point screen overrides build on.
+  final KasyAppBarConfig defaultConfig;
+
+  const KasyAppBarScope({
+    super.key,
+    required this.config,
+    required this.defaultConfig,
+    required super.child,
+  });
+
+  /// True when a [KasyAppBarScope] is an ancestor (no rebuild dependency —
+  /// presence is fixed for a given subtree).
+  static bool of(BuildContext context) => maybeOf(context) != null;
+
+  /// The nearest scope, or null outside the shell (e.g. full-screen routes).
+  static KasyAppBarScope? maybeOf(BuildContext context) =>
+      context.getInheritedWidgetOfExactType<KasyAppBarScope>();
+
+  @override
+  bool updateShouldNotify(KasyAppBarScope oldWidget) =>
+      config != oldWidget.config || defaultConfig != oldWidget.defaultConfig;
+}
+
+/// Wrap a routed page's body with this to override the desktop application bar
+/// for that screen. On phone/tablet (no scope above) it is a transparent
+/// pass-through, so it is always safe to add.
+///
+/// ```dart
+/// KasyAppBarConfigurator(
+///   configure: (bar) => bar.only(search: true),
+///   child: MyScreen(),
+/// )
+/// ```
+class KasyAppBarConfigurator extends StatefulWidget {
+  /// How this screen adapts the shell default. Return [base] unchanged to keep
+  /// the default, or e.g. `base.only(...)` / `base.copyWith(...)`.
+  final KasyAppBarConfigure configure;
+  final Widget child;
+
+  const KasyAppBarConfigurator({
+    super.key,
+    required this.configure,
+    required this.child,
+  });
+
+  @override
+  State<KasyAppBarConfigurator> createState() => _KasyAppBarConfiguratorState();
+}
+
+class _KasyAppBarConfiguratorState extends State<KasyAppBarConfigurator> {
+  void _publish() {
+    if (!mounted) return;
+    final KasyAppBarScope? scope = KasyAppBarScope.maybeOf(context);
+    if (scope == null) return; // phone/tablet: no application bar to configure.
+    // Always build from the ORIGINAL default (not the current value), so the
+    // override is stable across rebuilds. The setter is a no-op when the result
+    // is unchanged (==), so an inline-built config does not churn the bar.
+    //
+    // Published post-frame: the bar (a sibling above this page in the shell
+    // Column) has already built this frame, so it picks the override up next.
+    scope.config.value = widget.configure(scope.defaultConfig);
+  }
+
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    WidgetsBinding.instance.addPostFrameCallback((_) => _publish());
+  }
+
+  @override
+  void didUpdateWidget(covariant KasyAppBarConfigurator oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    WidgetsBinding.instance.addPostFrameCallback((_) => _publish());
+  }
+
+  @override
+  Widget build(BuildContext context) => widget.child;
+}

package/templates/firebase/lib/core/data/api/user_api.dart

@@ -53,6 +53,10 @@ class UserApi {
     );
   }
 
+  Stream<String?> watchRole(String id) {
+    return _collection.doc(id).snapshots().map((snap) => snap.data()?.role);
+  }
+
   Future<void> update(UserEntity user) {
     final data = user.toJson();
     data.removeWhere((key, value) => value == null);
@@ -74,6 +78,17 @@ class UserApi {
         'authFunctions-deleteUserAccount',
       );
       await callable.call();
+    } on FirebaseFunctionsException catch (err, stacktrace) {
+      // Surface the REAL cause in the logs instead of a generic message, so a
+      // failed deletion is diagnosable at a glance:
+      //   code 'not-found'      → the function isn't deployed yet (run a deploy)
+      //   code 'unauthenticated'→ the user's token didn't reach the function
+      //   code 'internal'       → the function ran but threw (see its own logs)
+      _logger.e(
+        "delete user error [${err.code}] ${err.message}",
+        stackTrace: stacktrace,
+      );
+      throw ApiError(message: err.message ?? "Error while deleting user");
     } catch (err, stacktrace) {
       _logger.e("delete user error $err", stackTrace: stacktrace);
       throw ApiError(message: "Error while deleting user");

package/templates/firebase/lib/core/data/repositories/user_repository.dart

@@ -59,6 +59,11 @@ class UserRepository {
     }
   }
 
+  /// Streams the user's role so a change made in the backend console (e.g.
+  /// promoting someone to "admin") is picked up at runtime without a restart.
+  /// Delegates to the backend-specific [UserApi].
+  Stream<String?> watchRole(String id) => _userApi.watchRole(id);
+
   /// We updates the user avatar
   /// We convert the image to jpeg and resize it to 300px width
   /// and 80% quality to reduce the size of the image