kasy-cli 1.21.8 → 1.22.0

package/templates/firebase/lib/features/settings/ui/components/admin/send_push_notification_page.dart

@@ -12,6 +12,7 @@ import 'package:kasy_kit/features/notifications/api/notifications_api.dart';
 import 'package:kasy_kit/features/settings/ui/components/admin/send_push_notifier.dart';
 import 'package:kasy_kit/features/settings/ui/widgets/settings_tile.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
+import 'package:package_info_plus/package_info_plus.dart';
 
 class SendPushNotificationPage extends ConsumerStatefulWidget {
   const SendPushNotificationPage({super.key});
@@ -38,6 +39,15 @@ class _SendPushNotificationPageState
 
   bool _sendToAll = false;
   final List<String> _emails = [];
+  String _appName = '';
+
+  @override
+  void initState() {
+    super.initState();
+    PackageInfo.fromPlatform().then((info) {
+      if (mounted) setState(() => _appName = info.appName);
+    });
+  }
 
   @override
   void dispose() {
@@ -165,6 +175,28 @@ class _SendPushNotificationPageState
                       child: Column(
                         crossAxisAlignment: CrossAxisAlignment.stretch,
                         children: [
+                          Padding(
+                            padding: const EdgeInsets.only(
+                              left: KasySpacing.xs,
+                              bottom: KasySpacing.sm,
+                            ),
+                            child: Text(
+                              tr.send_push_preview_label.toUpperCase(),
+                              style: context.textTheme.labelMedium?.copyWith(
+                                color: context.colors.muted,
+                                letterSpacing: 1.2,
+                                fontWeight: FontWeight.w700,
+                                fontSize: 12,
+                              ),
+                            ),
+                          ),
+                          _NotificationPreview(
+                            appName: _appName,
+                            title: _titleCtrl.text,
+                            body: _bodyCtrl.text,
+                            imageUrl: _imageCtrl.text,
+                          ),
+                          const SizedBox(height: KasySpacing.lg),
                           SettingsSwitchTile(
                             icon: KasyIcons.notificationActive,
                             title: tr.send_push_to_all,
@@ -214,6 +246,7 @@ class _SendPushNotificationPageState
                             hint: tr.send_push_image_hint,
                             controller: _imageCtrl,
                             focusNode: _imageFocus,
+                            onChanged: (_) => setState(() {}),
                             textInputAction: TextInputAction.next,
                             onEditingComplete: () => _routeFocus.requestFocus(),
                           ),
@@ -364,3 +397,206 @@ class _EmailChip extends StatelessWidget {
     );
   }
 }
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Live notification preview — an iOS-style banner that mirrors what the push
+// will look like, updating as the admin types. Cosmetic only (no logic).
+// ─────────────────────────────────────────────────────────────────────────────
+
+class _NotificationPreview extends StatelessWidget {
+  final String appName;
+  final String title;
+  final String body;
+  final String imageUrl;
+
+  const _NotificationPreview({
+    required this.appName,
+    required this.title,
+    required this.body,
+    required this.imageUrl,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final tr = t.settings.admin;
+    final String name = appName.trim().isEmpty ? 'App' : appName.trim();
+    final String url = imageUrl.trim();
+    final bool showImage = url.startsWith('http');
+    final bool titleEmpty = title.trim().isEmpty;
+    final bool bodyEmpty = body.trim().isEmpty;
+
+    return Container(
+      padding: const EdgeInsets.all(12),
+      decoration: BoxDecoration(
+        color: context.colors.surface,
+        borderRadius: BorderRadius.circular(20),
+        border: Border.all(
+          color: context.colors.outline.withValues(
+            alpha: context.isDark ? 0.4 : 0.2,
+          ),
+        ),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: context.isDark ? 0.45 : 0.10),
+            blurRadius: 24,
+            offset: const Offset(0, 10),
+          ),
+        ],
+      ),
+      child: Row(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          _AppIconBadge(name: name),
+          const SizedBox(width: 10),
+          Expanded(
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                Row(
+                  children: [
+                    Expanded(
+                      child: Text(
+                        name.toUpperCase(),
+                        maxLines: 1,
+                        overflow: TextOverflow.ellipsis,
+                        style: context.textTheme.labelSmall?.copyWith(
+                          color: context.colors.muted,
+                          letterSpacing: 0.4,
+                          fontWeight: FontWeight.w600,
+                        ),
+                      ),
+                    ),
+                    const SizedBox(width: 6),
+                    Text(
+                      tr.send_push_preview_now,
+                      style: context.textTheme.labelSmall?.copyWith(
+                        color: context.colors.muted,
+                      ),
+                    ),
+                  ],
+                ),
+                const SizedBox(height: 3),
+                Text(
+                  titleEmpty ? tr.send_push_preview_title_placeholder : title.trim(),
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                  style: context.textTheme.bodyMedium?.copyWith(
+                    color: titleEmpty
+                        ? context.colors.muted
+                        : context.colors.onSurface,
+                    fontWeight: FontWeight.w600,
+                  ),
+                ),
+                const SizedBox(height: 2),
+                Text(
+                  bodyEmpty ? tr.send_push_preview_body_placeholder : body.trim(),
+                  maxLines: 2,
+                  overflow: TextOverflow.ellipsis,
+                  style: context.textTheme.bodySmall?.copyWith(
+                    color: context.colors.muted,
+                    height: 1.3,
+                  ),
+                ),
+              ],
+            ),
+          ),
+          if (showImage) ...[
+            const SizedBox(width: 10),
+            _PreviewThumb(url: url),
+          ],
+        ],
+      ),
+    );
+  }
+}
+
+/// Rounded-square app icon (iOS app-icon look). Uses the REAL launcher icon
+/// (`assets/images/icon.png`) so the preview always mirrors the app's actual
+/// logo — change the icon and this follows. Falls back to a tinted square with
+/// the app's initial if the asset can't be loaded.
+class _AppIconBadge extends StatelessWidget {
+  final String name;
+  const _AppIconBadge({required this.name});
+
+  @override
+  Widget build(BuildContext context) {
+    return ClipRRect(
+      borderRadius: BorderRadius.circular(10),
+      child: Image.asset(
+        'assets/images/icon.png',
+        width: 40,
+        height: 40,
+        fit: BoxFit.cover,
+        errorBuilder: (context, error, stack) => _fallback(context),
+      ),
+    );
+  }
+
+  Widget _fallback(BuildContext context) {
+    final String letter =
+        name.isNotEmpty ? name.substring(0, 1).toUpperCase() : 'A';
+    return Container(
+      width: 40,
+      height: 40,
+      decoration: BoxDecoration(
+        gradient: LinearGradient(
+          begin: Alignment.topLeft,
+          end: Alignment.bottomRight,
+          colors: [
+            context.colors.primary,
+            context.colors.primary.withValues(alpha: 0.7),
+          ],
+        ),
+        borderRadius: BorderRadius.circular(10),
+      ),
+      alignment: Alignment.center,
+      child: Text(
+        letter,
+        style: context.textTheme.titleMedium?.copyWith(
+          color: context.colors.onPrimary,
+          fontWeight: FontWeight.w800,
+        ),
+      ),
+    );
+  }
+}
+
+/// Thumbnail of the notification image, loaded live from the URL. Keeps the old
+/// frame while a new URL loads (gaplessPlayback) and shows a fallback on error.
+class _PreviewThumb extends StatelessWidget {
+  final String url;
+  const _PreviewThumb({required this.url});
+
+  @override
+  Widget build(BuildContext context) {
+    return ClipRRect(
+      borderRadius: BorderRadius.circular(8),
+      child: SizedBox(
+        width: 40,
+        height: 40,
+        child: Image.network(
+          url,
+          fit: BoxFit.cover,
+          gaplessPlayback: true,
+          loadingBuilder: (context, child, progress) =>
+              progress == null ? child : _placeholder(context, loading: true),
+          errorBuilder: (context, error, stack) =>
+              _placeholder(context, loading: false),
+        ),
+      ),
+    );
+  }
+
+  Widget _placeholder(BuildContext context, {required bool loading}) {
+    return Container(
+      color: context.colors.surfaceNeutralSoft,
+      alignment: Alignment.center,
+      child: Icon(
+        loading ? Icons.image_outlined : Icons.broken_image_outlined,
+        size: 18,
+        color: context.colors.muted,
+      ),
+    );
+  }
+}

package/templates/firebase/lib/features/settings/ui/components/avatar_component.dart

@@ -354,7 +354,7 @@ class _AvatarContent extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    // 1. Arquivo temporário escolhido da galeria (prioridade máxima)
+    // 1. Temporary file picked from the gallery (highest priority)
     if (localImage != null) {
       return KasyAvatar(
         diameter: diameter,
@@ -376,7 +376,7 @@ class _AvatarContent extends StatelessWidget {
 
     final id = userId;
     if (id != null) {
-      // 2. URL em cache: síncrono, sem FutureBuilder, sem flash de fallback
+      // 2. Cached URL: synchronous, no FutureBuilder, no fallback flash
       final cachedUrl = getCachedAvatarUrl(id);
       if (cachedUrl != null && cachedUrl.isNotEmpty) {
         return KasyAvatar(
@@ -387,7 +387,7 @@ class _AvatarContent extends StatelessWidget {
         );
       }
 
-      // 3. URL não está em cache: busca async (primeiro acesso ou após upload)
+      // 3. URL not cached: async fetch (first access or after upload)
       return FutureBuilder<String>(
         future: resolveAvatarUrl(id),
         builder: (context, snapshot) {

package/templates/firebase/lib/features/settings/ui/widgets/kasy_user_avatar.dart

@@ -0,0 +1,77 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/kasy_avatar.dart';
+import 'package:kasy_kit/components/kasy_avatar_presets.dart';
+import 'package:kasy_kit/core/data/models/user.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/features/settings/ui/widgets/avatar_utils.dart';
+
+/// The signed-in user's avatar, resolved through the exact same path as the
+/// settings screen — so it behaves identically across the **Firebase, Supabase
+/// and API** backends. [avatar_utils] (the URL resolver) is swapped per backend
+/// by the CLI, and the user identity comes from [userStateNotifierProvider]
+/// (backend-agnostic), so this widget never references a specific backend.
+///
+/// Resolution order: the user's `avatarPath` URL → the in-memory cache →
+/// the backend's avatar store (async). Falls back to a [gradient] fill while
+/// loading, for guests, or when no photo exists.
+class KasyUserAvatar extends ConsumerWidget {
+  const KasyUserAvatar({
+    super.key,
+    this.diameter = 36,
+    this.gradient = KasyAvatarGradients.indigo,
+    this.onTap,
+  });
+
+  /// Avatar diameter in logical pixels.
+  final double diameter;
+
+  /// Gradient shown when the user has no photo (or while it loads).
+  final KasyAvatarGradientData gradient;
+
+  /// Tap handler (open account menu / profile). Null = inert.
+  final VoidCallback? onTap;
+
+  KasyAvatar _avatar([ImageProvider? image]) => KasyAvatar(
+    diameter: diameter,
+    image: image,
+    backgroundGradient: gradient,
+    onTap: onTap,
+  );
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final User user = ref.watch(userStateNotifierProvider).user;
+
+    // 1. A direct URL on the user record (social logins; Supabase/API users).
+    final String? avatarPath = switch (user) {
+      AuthenticatedUserData(:final avatarPath) => avatarPath,
+      _ => null,
+    };
+    if (avatarPath != null && avatarPath.isNotEmpty) {
+      return _avatar(NetworkImage(avatarPath));
+    }
+
+    final String? userId = user.idOrNull;
+    if (userId != null) {
+      // 2. Cached URL — synchronous, avoids a fallback flash.
+      final String? cached = getCachedAvatarUrl(userId);
+      if (cached != null && cached.isNotEmpty) {
+        return _avatar(NetworkImage(cached));
+      }
+      // 3. Resolve through the backend's avatar store (async, per-backend).
+      return FutureBuilder<String>(
+        future: resolveAvatarUrl(userId),
+        builder: (context, snapshot) {
+          final String? url = snapshot.data;
+          return _avatar(
+            (url != null && url.isNotEmpty) ? NetworkImage(url) : null,
+          );
+        },
+      );
+    }
+
+    // 4. Guest / loading → gradient fill.
+    return _avatar();
+  }
+}

package/templates/firebase/lib/features/settings/ui/widgets/settings_tile.dart

@@ -156,6 +156,7 @@ class SettingsTile extends StatelessWidget {
     return KasyHover(
       onTap: onTap,
       hoverEnabled: false,
+      pressEnabled: false,
       semanticLabel: title,
       padding: const EdgeInsets.symmetric(vertical: KasySpacing.sm),
       child: Row(

package/templates/firebase/lib/features/{subscription → subscriptions}/api/entities/subscription_entity.dart

@@ -15,6 +15,19 @@ enum SubscriptionStatus {
   CANCELLED,
 }
 
+/// Where the subscription was purchased (its origin). Used to route the user to
+/// the correct management flow regardless of the device they are currently on.
+/// `STRIPE` means the subscription was bought on the web via Stripe.
+enum SubscriptionStore {
+  PLAY_STORE,
+  APPLE_STORE,
+  EARLY_BIRD,
+  STRIPE,
+  // Forward-compat: any value the backend sends that we don't know yet maps
+  // here, so parsing never throws and routing safely falls back to platform.
+  unknown,
+}
+
 
 @freezed
 sealed class SubscriptionEntity with _$SubscriptionEntity {
@@ -32,6 +45,10 @@ sealed class SubscriptionEntity with _$SubscriptionEntity {
     @TimestampConverter()
     DateTime? periodEndDate,
     @JsonKey(name: 'status') required SubscriptionStatus status,
+    // Origin of the subscription (apple/play/stripe/...). Nullable + tolerant
+    // parsing so old records (no `store`) and future values never break.
+    @JsonKey(name: 'store', unknownEnumValue: SubscriptionStore.unknown)
+    SubscriptionStore? store,
   }) = SubscriptionEntityData;
 
   factory SubscriptionEntity.fromJson(String id, Map<String, Object?> json) =>

package/templates/firebase/lib/features/{subscription → subscriptions}/api/inapp_subscription_api.dart

@@ -1,21 +1,22 @@
 import 'package:flutter/foundation.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter/services.dart' show PlatformException;
+import 'package:kasy_kit/core/data/models/entitlement.dart';
 import 'package:kasy_kit/core/data/models/subscription.dart';
-import 'package:kasy_kit/environnements.dart';
+import 'package:kasy_kit/environments.dart';
+import 'package:kasy_kit/features/subscriptions/api/entities/subscription_entity.dart';
+import 'package:kasy_kit/features/subscriptions/api/revenuecat_product.dart';
+import 'package:kasy_kit/features/subscriptions/api/subscription_payment_api.dart';
 import 'package:logger/logger.dart';
 import 'package:purchases_flutter/purchases_flutter.dart';
 import 'package:universal_io/io.dart';
 import 'package:url_launcher/url_launcher.dart';
 
-final inAppSubscriptionApiProvider = Provider(
-  (ref) => RevenueCatPaymentApi(environment: ref.read(environmentProvider)),
-);
-
-// We chose to use RevenueCat for in-app subscription
-// but you can use any other provider (RevenueCat, ...)
+// We chose to use RevenueCat for in-app subscription (mobile: App Store / Play
+// Store). Web subscriptions are handled by the separate Stripe module via
+// [StripePaymentApi]; both implement [SubscriptionPaymentApi].
 // ---
 // We wrap the RevenueCat API to be able to fake it properly (Glassfy use static methods which are hard for tests)
-class RevenueCatPaymentApi {
+class RevenueCatPaymentApi implements SubscriptionPaymentApi {
   bool _hasInit = false;
   final Environment _environment;
 
@@ -30,16 +31,7 @@ class RevenueCatPaymentApi {
     return key.startsWith('test_');
   }
 
-  /// Web Billing sandbox keys (`rcb_sb_`) must not ship in release.
-  static bool isRevenueCatWebSandboxKey(String? key) {
-    if (key == null || key.isEmpty) return false;
-    return key.startsWith('rcb_sb_');
-  }
-
   String? _apiKeyForCurrentPlatform() {
-    if (kIsWeb) {
-      return _environment.revenueCatWebApiKey;
-    }
     if (Platform.isAndroid) {
       return _environment.revenueCatAndroidApiKey;
     }
@@ -52,13 +44,26 @@ class RevenueCatPaymentApi {
   bool _mustSkipConfigureDueToSandboxKeyInRelease() {
     if (!kReleaseMode) return false;
     final String? key = _apiKeyForCurrentPlatform();
-    if (kIsWeb) {
-      return isRevenueCatWebSandboxKey(key);
-    }
     return isRevenueCatTestStorePublicKey(key);
   }
 
+  /// Map a RevenueCat [EntitlementInfo] to the provider-agnostic [Entitlement].
+  Entitlement _toEntitlement(EntitlementInfo e) => Entitlement(
+    identifier: e.identifier,
+    isActive: e.isActive,
+    isInTrial: e.periodType == PeriodType.trial,
+    willRenew: e.willRenew,
+    productId: e.productIdentifier,
+    expirationDate: e.expirationDate != null
+        ? DateTime.tryParse(e.expirationDate!)
+        : null,
+  );
+
+  @override
   Future<void> init() async {
+    // RevenueCat is mobile-only (Android/iOS). Web subscriptions are handled by
+    // the Stripe module when present; never configure RevenueCat on web.
+    if (kIsWeb) return;
     if (!_environment.isRevenueCatConfigured) {
       Logger().w('=== RevenueCat API key not provided ===');
       Logger().w(
@@ -77,15 +82,7 @@ class RevenueCatPaymentApi {
     }
     await Purchases.setLogLevel(kDebugMode ? LogLevel.debug : LogLevel.warn);
     PurchasesConfiguration configuration;
-    if (kIsWeb) {
-      final webKey = _environment.revenueCatWebApiKey;
-      if (webKey == null || webKey.isEmpty) {
-        throw Exception(
-          'RevenueCat Web API key not configured. Set RC_WEB_API_KEY.',
-        );
-      }
-      configuration = PurchasesConfiguration(webKey);
-    } else if (Platform.isAndroid) {
+    if (Platform.isAndroid) {
       configuration = PurchasesConfiguration(
         _environment.revenueCatAndroidApiKey!,
       );
@@ -99,6 +96,7 @@ class RevenueCatPaymentApi {
   }
 
   // We use a custom subscriber id to be able to identify the user
+  @override
   Future<void> initUser(String userId) async {
     if (kDebugMode && !_environment.isRevenueCatConfigured) {
       Logger().w('=== RevenueCat API key not provided ===');
@@ -115,6 +113,7 @@ class RevenueCatPaymentApi {
   }
 
   // We can dissociate the user from the subscription
+  @override
   Future<void> disconnectUser() async {
     if (!_hasInit) {
       return;
@@ -122,6 +121,7 @@ class RevenueCatPaymentApi {
     await Purchases.logOut();
   }
 
+  @override
   Future<List<SubscriptionProduct>> getOffers(String? offerId) async {
     if (kDebugMode && !_environment.isRevenueCatConfigured) {
       Logger().d(
@@ -211,6 +211,25 @@ class RevenueCatPaymentApi {
     return Purchases.purchase(purchaseParams);
   }
 
+  @override
+  Future<void> purchaseProduct(SubscriptionProduct product) async {
+    if (product is! RevenueCatProduct) {
+      throw ArgumentError(
+        'RevenueCatPaymentApi can only purchase a RevenueCatProduct',
+      );
+    }
+    try {
+      await purchasePackage(product.revenueCatPackage);
+    } on PlatformException catch (e) {
+      final error = PurchasesErrorHelper.getErrorCode(e);
+      if (error == PurchasesErrorCode.purchaseCancelledError) {
+        throw UserCancelledPurchaseException();
+      }
+      rethrow;
+    }
+  }
+
+  @override
   Future<void> presentCodeRedemptionSheet() {
     if (TargetPlatform.iOS != defaultTargetPlatform) {
       throw "Only available on iOS";
@@ -221,12 +240,11 @@ class RevenueCatPaymentApi {
     return Purchases.presentCodeRedemptionSheet();
   }
 
-  Future<void> unsubscribe() async {
-    if (kIsWeb) {
-      // Web Billing: user manages subscription via RevenueCat customer portal
-      // or the checkout flow. No-op here; UI can show a link to the portal.
-      return;
-    }
+  @override
+  Future<void> unsubscribe(SubscriptionStore? origin) async {
+    // RevenueCat only manages App Store / Play Store subscriptions, and only on
+    // the matching device. The caller (provider) already decided this is the
+    // right place to manage; here we just open the current platform's store.
     if (Platform.isAndroid) {
       launchUrl(
         Uri.parse("https://play.google.com/store/account/subscriptions"),
@@ -266,6 +284,7 @@ class RevenueCatPaymentApi {
     return result;
   }
 
+  @override
   Future<SubscriptionProduct?> getFromProductId(String productId) async {
     if (!_hasInit) {
       return null;
@@ -323,10 +342,10 @@ class RevenueCatPaymentApi {
     return products;
   }
 
+  @override
   Future<void> restorePurchase() async {
     if (kIsWeb) {
-      // Restore is not supported on web; Web Billing manages subscriptions
-      // via the customer portal. Return without error.
+      // Restore is not supported on web for RevenueCat. Return without error.
       return;
     }
     if (!_hasInit) {
@@ -338,20 +357,26 @@ class RevenueCatPaymentApi {
     }
   }
 
-  Future<List<EntitlementInfo>> getPermissions() async {
+  @override
+  Future<List<Entitlement>> getPermissions() async {
     if (!_hasInit) {
       return [];
     }
     final customerInfo = await Purchases.getCustomerInfo();
-    return customerInfo.entitlements.active.values.toList();
+    return customerInfo.entitlements.active.values
+        .map(_toEntitlement)
+        .toList();
   }
 
-  Future<List<EntitlementInfo>?> getEntitlements() async {
+  @override
+  Future<List<Entitlement>?> getEntitlements() async {
     if (!_hasInit) {
       return [];
     }
     final customerInfo = await Purchases.getCustomerInfo();
-    return customerInfo.entitlements.active.values.toList();
+    return customerInfo.entitlements.active.values
+        .map(_toEntitlement)
+        .toList();
   }
 }
 
@@ -383,7 +408,3 @@ class SubscriptionProductAdapter {
     }
   }
 }
-
-class UserCancelledPurchaseException implements Exception {
-  UserCancelledPurchaseException();
-}