kasy-cli 1.2.1

package/templates/firebase/lib/core/guards/user_info_guard.dart

@@ -0,0 +1,55 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/config/features.dart';
+import 'package:kasy_kit/core/guards/guard.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+class UserInfosGuard extends ConsumerWidget {
+  final Widget child;
+  final String fallbackRoute;
+
+  const UserInfosGuard({
+    super.key,
+    required this.child,
+    required this.fallbackRoute,
+  });
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final authState = ref.watch(userStateNotifierProvider);
+    if (authState.user.isLoading) {
+      return Material(
+        color: context.colors.background,
+        child: const Center(
+          child: CircularProgressIndicator.adaptive(),
+        ),
+      );
+    }
+
+    // Web: skip onboarding but require sign-in (or explicit guest choice).
+    // The /signin page's "Continue without account" button calls onOnboarded()
+    // which marks isOnboarded=true locally, allowing the guard to pass.
+    if (kIsWeb && withWeb) {
+      return Guard(
+        canActivate: Future.value(
+          authState.user.idOrNull != null || authState.user.isOnboarded,
+        ),
+        fallbackRoute: '/signin',
+        child: child,
+      );
+    }
+
+    // Native: all users (including guests with no ID) go through onboarding.
+    // Guests are never forced to /signin here; individual features that
+    // require authentication redirect to /signin on their own.
+    return Guard(
+      canActivate: Future.value(
+        !withOnboarding || authState.user.isOnboarded,
+      ),
+      fallbackRoute: fallbackRoute,
+      child: child,
+    );
+  }
+}

package/templates/firebase/lib/core/haptics/haptic_feedback_notifier.dart

@@ -0,0 +1,19 @@
+import 'package:kasy_kit/core/shared_preferences/shared_preferences.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'haptic_feedback_notifier.g.dart';
+
+@Riverpod(keepAlive: true)
+class HapticFeedbackNotifier extends _$HapticFeedbackNotifier {
+  @override
+  bool build() {
+    final prefs = ref.read(sharedPreferencesProvider);
+    return prefs.getHapticFeedbackEnabled();
+  }
+
+  Future<void> toggle() async {
+    final newValue = !state;
+    state = newValue;
+    await ref.read(sharedPreferencesProvider).setHapticFeedbackEnabled(newValue);
+  }
+}

package/templates/firebase/lib/core/haptics/kasy_haptics.dart

@@ -0,0 +1,27 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/haptics/haptic_feedback_notifier.dart';
+
+class KasyHaptics {
+  KasyHaptics._();
+
+  static bool _isEnabled(BuildContext context) =>
+      ProviderScope.containerOf(context).read(hapticFeedbackProvider);
+
+  static Future<void> light(BuildContext context) async {
+    if (_isEnabled(context)) await HapticFeedback.lightImpact();
+  }
+
+  static Future<void> medium(BuildContext context) async {
+    if (_isEnabled(context)) await HapticFeedback.mediumImpact();
+  }
+
+  static Future<void> heavy(BuildContext context) async {
+    if (_isEnabled(context)) await HapticFeedback.heavyImpact();
+  }
+
+  static Future<void> selection(BuildContext context) async {
+    if (_isEnabled(context)) await HapticFeedback.selectionClick();
+  }
+}

package/templates/firebase/lib/core/home_widgets/home_widget_background_task.dart

@@ -0,0 +1,41 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/home_widgets/home_widget_mywidget_service.dart';
+import 'package:kasy_kit/core/shared_preferences/shared_preferences.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/features/authentication/api/authentication_api.dart';
+import 'package:kasy_kit/features/subscription/repositories/subscription_repository.dart';
+import 'package:logger/logger.dart';
+
+/// Generated by Kasy CLI
+/// ----
+/// Background task callback for workmanager
+/// This allows updating home widgets even when the app is in the background
+@pragma('vm:entry-point')
+Future<void> homeWidgetCallbackDispatcher() async {
+  try {
+    Logger().i('🔄 Home Widget background task triggered');
+    final globalContainer = ProviderContainer();
+    final sharedPreferences = globalContainer.read(sharedPreferencesProvider);
+    await sharedPreferences.init();
+    await globalContainer.read(authenticationApiProvider).init();
+    await globalContainer.read(subscriptionRepositoryProvider).init();
+    await globalContainer.read(userStateNotifierProvider.notifier).init();
+
+    /// If you want to restric the background task to only run when the user is subscribed,
+    /// you can use the subscription variable here.
+    // final subscription = globalContainer
+    //     .read(userStateNotifierProvider)
+    //     .subscription;
+
+    final myWidgetWidget = globalContainer.read(
+      myWidgetHomeWidgetProvider.notifier,
+    );
+    await myWidgetWidget.update();
+
+    globalContainer.dispose();
+    return;
+  } catch (e) {
+    Logger().e('Error in background task: $e');
+    return;
+  }
+}

package/templates/firebase/lib/core/home_widgets/home_widget_mywidget_service.dart

@@ -0,0 +1,57 @@
+import 'package:home_widget/home_widget.dart';
+import 'package:kasy_kit/core/home_widgets/home_widget_service.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:logger/logger.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'home_widget_mywidget_service.g.dart';
+
+@Riverpod(keepAlive: true)
+class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
+    implements UpdatableHomeWidget {
+  static const String _androidWidgetName = 'MyWidgetReceiver';
+  static const String _iosWidgetName = 'MyWidgetWidget';
+
+  @override
+  void build() {}
+
+  @override
+  Future<void> update() {
+    Logger().i('🔄 Updating MyWidget Home Widget');
+    // Example: fetch some data from the user state
+    final userState = ref.read(userStateNotifierProvider);
+    final userName = userState.user.idOrNull ?? 'Guest';
+
+    return updateWidget({'title': 'Hello, $userName', 'counter': '0'});
+  }
+
+  /// Update widget data
+  ///
+  /// This will save data that the widget can read
+  Future<void> updateWidget(Map<String, String> data) async {
+    await HomeWidget.saveWidgetData<String>('title', data['title'] ?? 'Hello');
+
+    await HomeWidget.saveWidgetData<String>('counter', data['counter'] ?? '0');
+
+    // Trigger widget update
+    await HomeWidget.updateWidget(
+      name: _androidWidgetName,
+      iOSName: _iosWidgetName,
+    );
+  }
+
+  /// Get current widget data
+  Future<Map<String, dynamic>> getWidgetData() async {
+    return {
+      'title': await HomeWidget.getWidgetData<String>(
+        'title',
+        defaultValue: 'Hello',
+      ),
+
+      'counter': await HomeWidget.getWidgetData<String>(
+        'counter',
+        defaultValue: '0',
+      ),
+    };
+  }
+}

package/templates/firebase/lib/core/home_widgets/home_widget_service.dart

@@ -0,0 +1,54 @@
+import 'package:background_fetch/background_fetch.dart';
+import 'package:flutter/foundation.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:home_widget/home_widget.dart';
+import 'package:kasy_kit/core/home_widgets/home_widget_background_task.dart';
+import 'package:kasy_kit/core/initializer/onstart_service.dart';
+import 'package:logger/logger.dart';
+
+final homeWidgetsManagerProvider = Provider<HomeWidgetsManager>(
+  (ref) => HomeWidgetsManager(),
+);
+
+const String appGroupId = 'group.com.aicrus.firebase.kit';
+
+/// Manager for all home widgets
+/// -> Don't modify this file
+/// ------------------------------------------------------------
+/// will be used to initialize the home widgets and set the app group id
+/// Register the background task for the home widgets
+class HomeWidgetsManager implements OnStartService {
+  @override
+  Future<void> init() async {
+    if (kIsWeb) return;
+    try {
+      await HomeWidget.setAppGroupId(appGroupId);
+
+      final status = await BackgroundFetch.configure(
+        BackgroundFetchConfig(
+          minimumFetchInterval: 15,
+          stopOnTerminate: false,
+          enableHeadless: true,
+          requiresBatteryNotLow: false,
+          requiresCharging: false,
+          requiresStorageNotLow: false,
+          requiresDeviceIdle: false,
+          requiredNetworkType: NetworkType.ANY,
+        ),
+        (String taskId) async {
+          final res = await homeWidgetCallbackDispatcher();
+          BackgroundFetch.finish(taskId);
+          return res;
+        },
+      );
+      Logger().i('🔄 - Home widgets manager initialized with status: $status');
+      await BackgroundFetch.start();
+    } catch (e, s) {
+      Logger().e('⚠️  Could not initialize home widgets: $e $s');
+    }
+  }
+}
+
+abstract class UpdatableHomeWidget {
+  Future<void> update();
+}

package/templates/firebase/lib/core/icons/kasy_icons.dart

@@ -0,0 +1,86 @@
+import 'package:flutter/material.dart' show Icons;
+import 'package:flutter/widgets.dart';
+import 'package:lucide_icons_flutter/lucide_icons.dart';
+
+/// Central icon registry for the kit.
+///
+/// Keep UI code using semantic names from this class so the icon pack can be
+/// swapped in a single file in the future.
+abstract final class KasyIcons {
+  static const IconData add = LucideIcons.plus300;
+
+  /// Assistente / IA (sparkles).
+  static const IconData assistant = LucideIcons.sparkles300;
+  static const IconData arrowBack = LucideIcons.arrowLeft300;
+  static const IconData arrowBackIos = LucideIcons.chevronLeft300;
+  static const IconData arrowForwardIos = LucideIcons.chevronRight300;
+  static const IconData arrowUp = LucideIcons.arrowUp300;
+  static const IconData chevronUp = LucideIcons.chevronUp300;
+  static const IconData chevronUpBold = LucideIcons.chevronUp400;
+  static const IconData voteUp = LucideIcons.chevronUp400;
+  static const IconData book = LucideIcons.book300;
+  static const IconData calendar = LucideIcons.calendar300;
+  static const IconData cameraAlt = LucideIcons.camera400;
+  static const IconData check = LucideIcons.check300;
+  static const IconData checkCircle = LucideIcons.circleCheck300;
+  static const IconData chevronRight = LucideIcons.chevronRight300;
+  static const IconData chevronDown = LucideIcons.chevronDown300;
+  static const IconData close = LucideIcons.x300;
+  static const IconData copy = LucideIcons.copy300;
+  static const IconData darkMode = LucideIcons.moon300;
+  static const IconData error = LucideIcons.circleAlert300;
+  static const IconData eye = LucideIcons.eye300;
+  static const IconData eyeOff = LucideIcons.eyeOff300;
+  static const IconData favorite = LucideIcons.heart300;
+  static const IconData favoriteOutline = LucideIcons.heartOff300;
+
+  /// Coração preenchido (usa glifo Material junto aos Lucides quando precisa fill).
+  static const IconData favoriteFilled = Icons.favorite_rounded;
+  static const IconData flash = LucideIcons.zap300;
+  static const IconData idea = LucideIcons.lightbulb300;
+  static const IconData flashOff = LucideIcons.zapOff300;
+  static const IconData flashlight = LucideIcons.flashlight300;
+  static const IconData gallery = LucideIcons.images300;
+  static const IconData help = LucideIcons.circleQuestionMark300;
+  static const IconData info = LucideIcons.info300;
+  static const IconData home = LucideIcons.house300;
+  static const IconData language = LucideIcons.languages300;
+  static const IconData lightMode = LucideIcons.sun300;
+  static const IconData logout = LucideIcons.logOut300;
+  static const IconData download = LucideIcons.download300;
+  static const IconData linkOutlined = LucideIcons.link300;
+  static const IconData message = LucideIcons.messageSquare300;
+  static const IconData moreVert = LucideIcons.ellipsisVertical300;
+  static const IconData microphone = LucideIcons.mic300;
+  static const IconData northEast = LucideIcons.arrowUpRight300;
+  static const IconData notification = LucideIcons.bell300;
+  static const IconData notificationActive = LucideIcons.bellRing300;
+  static const IconData notificationAdd = LucideIcons.bellPlus300;
+  static const IconData notificationOff = LucideIcons.bellOff300;
+  static const IconData note = LucideIcons.notebook300;
+  static const IconData packageOutline = LucideIcons.package300;
+  static const IconData payment = LucideIcons.wallet300;
+  static const IconData palette = LucideIcons.palette300;
+  static const IconData trash = LucideIcons.trash300;
+  static const IconData person = LucideIcons.userRound300;
+  static const IconData phone = LucideIcons.phone300;
+  static const IconData phoneAndroid = LucideIcons.smartphone300;
+  static const IconData fingerprint = LucideIcons.fingerprintPattern300;
+  static const IconData privacy = LucideIcons.shieldAlert300;
+  static const IconData refresh = LucideIcons.refreshCw300;
+  static const IconData search = LucideIcons.search300;
+  static const IconData security = LucideIcons.shield300;
+  static const IconData send = LucideIcons.send300;
+
+  /// Compartilhar (Lucide «share» peso 300).
+  static const IconData share = LucideIcons.share300;
+  static const IconData settings = LucideIcons.settings300;
+  static const IconData sms = LucideIcons.messagesSquare300;
+  static const IconData shoppingBag = LucideIcons.shoppingBag300;
+  static const IconData star = LucideIcons.star300;
+  static const IconData time = LucideIcons.clock300;
+  static const IconData ticket = LucideIcons.ticket300;
+  static const IconData upload = LucideIcons.upload300;
+  static const IconData video = LucideIcons.video300;
+  static const IconData widgets = LucideIcons.component300;
+}

package/templates/firebase/lib/core/initializer/models/run_state.dart

@@ -0,0 +1,14 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'run_state.freezed.dart';
+
+@freezed
+sealed class AppRunState with _$AppRunState {
+  const factory AppRunState.loading() = AppLoadingState;
+
+  const factory AppRunState.ready() = AppReadyState;
+
+  const factory AppRunState.error(String error) = AppErrorState;
+
+  const AppRunState._();
+}

package/templates/firebase/lib/core/initializer/onstart_service.dart

@@ -0,0 +1,38 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/initializer/models/run_state.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'onstart_service.g.dart';
+
+abstract class OnStartService {
+  Future<void> init();
+}
+
+@Riverpod(keepAlive: true)
+class OnStartNotifier extends _$OnStartNotifier {
+  final List<OnStartService> _services = [];
+
+  @override
+  AppRunState build() {
+    return const AppRunState.loading();
+  }
+
+  void register(OnStartService service) {
+    _services.add(service);
+  }
+
+  void onEnded() {
+    state = const AppRunState.ready();
+  }
+
+  void notifyError(String error) {
+    state = AppRunState.error(error);
+  }
+
+  void printDebugState() {
+    debugPrint('OnStartNotifier state');
+    for (final el in _services) {
+      debugPrint(' - ${el.runtimeType} started');
+    }
+  }
+}

package/templates/firebase/lib/core/initializer/onstart_widget.dart

@@ -0,0 +1,83 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_native_splash/flutter_native_splash.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/initializer/models/run_state.dart';
+import 'package:kasy_kit/core/initializer/onstart_service.dart';
+import 'package:kasy_kit/core/initializer/pending_notification_handler.dart';
+import 'package:kasy_kit/core/states/events_dispatcher.dart';
+import 'package:kasy_kit/core/states/models/event_model.dart';
+import 'package:kasy_kit/main.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+typedef OnInitErrorBuilder =
+    Widget Function(BuildContext context, String error);
+
+class Initializer extends ConsumerStatefulWidget {
+  final Widget onReady;
+  final Widget onLoading;
+  final OnInitErrorBuilder? onError;
+  final List<ProviderListenable<OnStartService>> services;
+
+  const Initializer({
+    super.key,
+    required this.onReady,
+    required this.onLoading,
+    this.onError,
+    this.services = const [],
+  });
+
+  @override
+  ConsumerState<ConsumerStatefulWidget> createState() => _InitializerState();
+}
+
+class _InitializerState extends ConsumerState<Initializer> {
+
+  @override
+  void initState() {
+    super.initState();
+    Future.delayed(Duration.zero, () async {
+      try {
+        final onStartHandler = ref.read(onStartProvider.notifier);
+        for (final service in widget.services) {
+          final serviceInstance = ref.read(service);
+          debugPrint('- Initializing service: ${serviceInstance.runtimeType}');
+          await serviceInstance.init();
+          onStartHandler.register(serviceInstance); // useless now
+        }
+        onStartHandler.onEnded();
+
+        final pendingNotificationHandler = ref.read(pendingNotificationHandlerProvider);
+        final pendingNotification = await pendingNotificationHandler.fetchNotificationToProcess();
+        if (pendingNotification != null) {
+          Future.delayed(const Duration(milliseconds: 2000), () async {
+            try {
+              await pendingNotification.onTap();
+            } catch (e, s) {
+              Sentry.captureException(e, stackTrace: s);
+            }
+          });
+        }
+
+        ref.publishAppEvent(OnAppStartEvent.create());
+      } catch (e,s) {
+        Sentry.captureException(e, stackTrace: s);
+        ref.read(onStartProvider.notifier).notifyError(e.toString());
+      } finally {
+        FlutterNativeSplash.remove();
+      }
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final onStartState = ref.watch(onStartProvider);
+
+    return switch (onStartState) {
+      AppLoadingState() => widget.onLoading,
+      AppReadyState() => widget.onReady,
+      AppErrorState(:final error) => widget.onError?.call(context, error) 
+        ?? AppErrorWidget(error: FlutterErrorDetails(exception: error, stack: StackTrace.current)),
+    };
+  }
+}

package/templates/firebase/lib/core/initializer/pending_notification_handler.dart

@@ -0,0 +1,48 @@
+import 'package:flutter_local_notifications/flutter_local_notifications.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/features/notifications/api/local_notifier.dart';
+import 'package:kasy_kit/features/notifications/api/notifications_api.dart';
+import 'package:kasy_kit/features/notifications/providers/models/notification.dart';
+
+final pendingNotificationHandlerProvider = Provider<PendingNotificationHandler>(
+  (ref) => PendingNotificationHandler(
+    notificationsApi: ref.watch(notificationsApiProvider),
+  ),
+);
+
+/// This class is responsible for handling the pending notification
+/// and when the app is ready, we process the notification
+/// Firebase automatically stores the initial message and remove it after getting it
+class PendingNotificationHandler {
+
+  final NotificationsApi _notificationsApi;
+
+  PendingNotificationHandler({
+    required NotificationsApi notificationsApi,
+  }) : _notificationsApi = notificationsApi;
+
+  Future<Notification?> fetchNotificationToProcess() async {
+    final message = await _notificationsApi.getInitialMessage();
+    if (message == null) {
+      return null;
+    }
+    if (message.notification == null) {
+      return null;
+    }
+    // Only process if the notification was sent recently (within 30 seconds).
+    // This prevents re-navigation on hot restart during development, where the
+    // native Firebase layer keeps the last message even after a Dart restart.
+    final sentTime = message.sentTime;
+    if (sentTime != null && DateTime.now().difference(sentTime).inSeconds > 30) {
+      return null;
+    }
+    final notification = Notification.from(
+      message.notification!.toMap(),
+      data: message.data,
+      notifierApi: LocalNotifier(notificationManager: FlutterLocalNotificationsPlugin()),
+      notifierSettings: defaultNotificationSettings,
+    );
+    return notification;
+  }
+
+}