kasy-cli 1.2.1

package/lib/scaffold/backends/api/patch/lib/features/onboarding/models/user_info.dart

@@ -0,0 +1,94 @@
+import 'package:kasy_kit/features/onboarding/api/entities/user_info_entity.dart';
+
+enum UserInfoKeys {
+  genre,
+  age,
+}
+
+enum Genre {
+  male,
+  female,
+  none,
+}
+
+enum AgeRange {
+  age18_30,
+  age31_40,
+  age41_50,
+  age51_60,
+  none,
+}
+
+abstract class UserInfoDetail<T> {
+  final T value;
+
+  UserInfoDetail(this.value);
+
+  
+
+  UserInfoEntity toEntity(String userId);
+}
+
+/// ======================================
+/// user age info
+/// ======================================
+class UserAgeInfo extends UserInfoDetail<AgeRange> {
+  UserAgeInfo(super.value);
+
+  factory UserAgeInfo.fromEntity(UserInfoEntity entity) {
+    final value = AgeRange.values.firstWhere(
+      (element) => element.name == entity.value,
+      orElse: () => AgeRange.none,
+    );
+    return UserAgeInfo(value);
+  }
+
+  factory UserAgeInfo.fromString(String value) {
+    final sexe = AgeRange.values.firstWhere(
+      (element) => element.name == value,
+      orElse: () => AgeRange.none,
+    );
+    return UserAgeInfo(sexe);
+  }
+
+  
+  
+  @override
+  UserInfoEntity toEntity(String userId) => UserInfoEntity(
+        key: UserInfoKeys.age.name,
+        value: value.name,
+        userId: userId,
+      );
+}
+
+/// ======================================
+/// user genre info
+/// ======================================
+class UserSexeInfo extends UserInfoDetail<Genre> {
+  UserSexeInfo(super.value);
+
+  factory UserSexeInfo.fromEntity(UserInfoEntity entity) {
+    final value = Genre.values.firstWhere(
+      (element) => element.name == entity.value,
+      orElse: () => Genre.none,
+    );
+    return UserSexeInfo(value);
+  }
+
+  factory UserSexeInfo.fromString(String value) {
+    final genre = Genre.values.firstWhere(
+      (element) => element.name == value,
+      orElse: () => Genre.none,
+    );
+    return UserSexeInfo(genre);
+  }
+
+  
+  
+  @override
+  UserInfoEntity toEntity(String userId) => UserInfoEntity(
+        key: UserInfoKeys.genre.name,
+        value: value.name,
+        userId: userId,
+      );
+}

package/lib/scaffold/backends/api/patch/lib/features/onboarding/repositories/user_infos_repository.dart

@@ -0,0 +1,29 @@
+import 'package:kasy_kit/features/onboarding/api/user_infos_api.dart';
+import 'package:kasy_kit/features/onboarding/models/user_info.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+final userInfosRepositoryProvider = Provider<UserInfosRepository>(
+  (ref) => UserInfosRepository(
+    userInfosApi: ref.read(userInfosApiProvider),
+  ),
+);
+
+class UserInfosRepository {
+  final UserInfosApi _userInfosApi;
+
+  UserInfosRepository({
+    required UserInfosApi userInfosApi,
+  }) : _userInfosApi = userInfosApi;
+
+  Future<void> save(String userId, UserInfoDetail info) async {
+    
+    final entity = info.toEntity(userId);
+    final alreadyExistingInfo =
+        await _userInfosApi.getByKey(userId, entity.key);
+    if (alreadyExistingInfo != null) {
+      return _userInfosApi.update(userId, entity.copyWith(id: alreadyExistingInfo.id));
+    }
+
+    return _userInfosApi.create(userId, entity);
+  }
+}

package/lib/scaffold/backends/api/patch/lib/features/onboarding/ui/animations/movefade_anim.dart

@@ -0,0 +1,34 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_animate/flutter_animate.dart';
+
+class MoveFadeAnim extends StatelessWidget {
+  final int? delayInMs;
+  final Widget child;
+
+  const MoveFadeAnim({
+    super.key,
+    required this.child,
+    this.delayInMs,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return Animate(
+      effects: [
+        FadeEffect(
+          delay: Duration(milliseconds: delayInMs ?? 0),
+          duration: const Duration(milliseconds: 200),
+          curve: Curves.easeIn,
+        ),
+        MoveEffect(
+          delay: Duration(milliseconds: delayInMs ?? 0),
+          duration: const Duration(milliseconds: 450),
+          curve: Curves.easeOut,
+          begin: const Offset(0, 50),
+          end: Offset.zero,
+        ),
+      ],
+      child: child,
+    );
+  }
+}

package/lib/scaffold/backends/api/patch/lib/features/onboarding/ui/components/onboarding_att_setup.dart

@@ -0,0 +1,66 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/data/api/analytics_api.dart';
+import 'package:kasy_kit/core/data/api/tracking_api.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_background.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_illustration_scaffold.dart';
+import 'package:kasy_kit/features/subscription/repositories/subscription_repository.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+import 'package:permission_handler/permission_handler.dart';
+
+/// ATT Permission Step
+/// ATT is only available on iOS
+/// This is the consent screen for iOS 14+ that asks the user to allow the app to access the ATT framework
+/// In a few words you need this to get the IDFA (Identifier for Advertisers) which is used for tracking purposes
+/// So you can create better facebook ads, google ads, etc...
+class AttPermissionStep extends ConsumerWidget {
+  final String nextRoute;
+
+  const AttPermissionStep({
+    super.key,
+    required this.nextRoute,
+  });
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final translations = Translations.of(context).onboarding.att;
+
+    return OnboardingBackground(
+      child: OnboardingIllustrationScaffold(
+        progress: 0.9,
+        title: translations.title,
+        description: translations.description,
+        imageAsset: 'assets/images/onboarding/img3.jpg',
+        footerActions: [
+          KasyButton(
+            label: translations.continue_button,
+            expand: true,
+            onPressed: () async {
+              final Map<Permission, PermissionStatus> permission = await [
+                Permission.appTrackingTransparency,
+              ].request();
+              final isGranted =
+                  permission.values.first == PermissionStatus.granted;
+              ref.read(analyticsApiProvider).logEvent('att_request', {
+                'granted': isGranted,
+              });
+              final userId =
+                  ref.read(userStateNotifierProvider).user.idOrNull;
+              if (userId != null) {
+                ref
+                    .read(subscriptionRepositoryProvider)
+                    .initUser(userId)
+                    .ignore();
+                ref.read(facebookEventApiProvider).initUser(userId).ignore();
+              }
+              if (!context.mounted) return;
+              Navigator.of(context).pushNamed(nextRoute);
+            },
+          ),
+        ],
+      ),
+    );
+  }
+}

package/lib/scaffold/backends/api/patch/lib/features/onboarding/ui/components/onboarding_notifications_setup.dart

@@ -0,0 +1,73 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/data/api/analytics_api.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/features/notifications/providers/models/notification.dart';
+import 'package:kasy_kit/features/notifications/repositories/notifications_repository.dart';
+import 'package:kasy_kit/features/onboarding/providers/onboarding_provider.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_background.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_illustration_scaffold.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+
+final _formStep3Key = GlobalKey<FormState>();
+
+class NotificationsPermissionStep extends ConsumerWidget {
+  final String nextRoute;
+
+  const NotificationsPermissionStep({
+    super.key,
+    required this.nextRoute,
+  });
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final notifRepository = ref.watch(notificationRepositoryProvider);
+    final permissionFuture = notifRepository.getPermissionStatus();
+    final translations = Translations.of(context).onboarding.notifications;
+
+    return OnboardingBackground(
+      child: FutureBuilder<NotificationPermission>(
+        future: permissionFuture,
+        builder: (context, snapshot) {
+          if (!snapshot.hasData) {
+            return const SizedBox();
+          }
+          return Form(
+            key: _formStep3Key,
+            child: OnboardingIllustrationScaffold(
+              progress: 0.9,
+              title: translations.title,
+              description: translations.description,
+              imageAsset: 'assets/images/onboarding/img2.jpg',
+              footerActions: [
+                KasyButton(
+                  label: translations.continue_button,
+                  expand: true,
+                  onPressed: () => ref.onboardingNotifier
+                      .setupNotifications()
+                      .then((_) {
+                    if (!context.mounted) return;
+                    Navigator.of(context).pushNamed(nextRoute);
+                  }),
+                ),
+                const SizedBox(height: KasySpacing.smd),
+                KasyButton(
+                  label: translations.skip_button,
+                  variant: KasyButtonVariant.soft,
+                  expand: true,
+                  onPressed: () {
+                    ref
+                        .read(analyticsApiProvider)
+                        .logEvent('setup_notifications_refused', {});
+                    Navigator.of(context).pushNamed(nextRoute);
+                  },
+                ),
+              ],
+            ),
+          );
+        },
+      ),
+    );
+  }
+}

package/lib/scaffold/backends/api/patch/lib/features/onboarding/ui/widgets/onboarding_radio_question.dart

@@ -0,0 +1,173 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_animate/flutter_animate.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/animations/movefade_anim.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/responsive_layout.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_background.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_progress.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_sticky_footer.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/selectable_row_tile.dart';
+
+typedef OptionBuilder = Widget Function(String key, bool selected);
+
+typedef ReassuranceBuilder = Widget? Function(String key);
+
+typedef OnOptionIdSelected = void Function(String id);
+
+typedef OnValidate = void Function(String? key);
+
+/// Single choice question with radio buttons
+class OnboardingRadioQuestion extends ConsumerStatefulWidget {
+  final double? progress;
+  final String title;
+  final String description;
+  final String btnText;
+  final List<String> optionIds;
+  final OptionBuilder optionBuilder;
+  final ReassuranceBuilder? reassuranceBuilder;
+  final OnOptionIdSelected? onOptionIdSelected;
+  final OnValidate? onValidate;
+
+  const OnboardingRadioQuestion({
+    super.key,
+    required this.title,
+    required this.description,
+    required this.btnText,
+    required this.optionIds,
+    required this.optionBuilder,
+    this.progress,
+    this.onOptionIdSelected,
+    this.onValidate,
+    this.reassuranceBuilder,
+  });
+
+  @override
+  ConsumerState<OnboardingRadioQuestion> createState() =>
+      _OnboardingRadioQuestionState();
+}
+
+class _OnboardingRadioQuestionState
+    extends ConsumerState<OnboardingRadioQuestion> {
+  String? selectedChoiceId;
+
+  @override
+  Widget build(BuildContext context) {
+    final scrollBody = Column(
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: [
+        if (widget.progress != null)
+          OnboardingProgress(value: widget.progress!),
+        Padding(
+          padding: const EdgeInsets.fromLTRB(
+            KasySpacing.md,
+            KasySpacing.xl,
+            KasySpacing.md,
+            0,
+          ),
+          child: MoveFadeAnim(
+            delayInMs: 100,
+            child: Text(
+              widget.title,
+              textAlign: TextAlign.center,
+              style: context.textTheme.headlineLarge?.copyWith(
+                color: context.colors.onBackground,
+              ),
+            ),
+          ),
+        ),
+        Padding(
+          padding: const EdgeInsets.fromLTRB(
+            KasySpacing.lg,
+            KasySpacing.md,
+            KasySpacing.lg,
+            KasySpacing.xl,
+          ),
+          child: MoveFadeAnim(
+            delayInMs: 200,
+            child: Text(
+              widget.description,
+              textAlign: TextAlign.center,
+              style: context.textTheme.bodyLarge?.copyWith(
+                color: context.colors.onBackground.withValues(alpha: 0.6),
+              ),
+            ),
+          ),
+        ),
+        Padding(
+          padding: const EdgeInsets.symmetric(horizontal: KasySpacing.md),
+          child: OnboardingSelectableRowGroup(
+            physics: const NeverScrollableScrollPhysics(),
+            options: widget.optionIds
+                .map(
+              (e) {
+                final index = widget.optionIds.indexOf(e);
+                return Animate(
+                  effects: [
+                    FadeEffect(
+                      delay: Duration(milliseconds: 300 + index * 100),
+                      duration: const Duration(milliseconds: 550),
+                      curve: Curves.easeInOut,
+                    ),
+                  ],
+                  child: widget.optionBuilder(e, e == selectedChoiceId),
+                );
+              },
+            ).toList(),
+            onSelect: (index, selected) {
+              widget.onOptionIdSelected?.call(widget.optionIds[index]);
+              setState(() {
+                selectedChoiceId = widget.optionIds[index];
+              });
+            },
+            onSelectInfoWidget: widget.optionIds
+                .map((el) => widget.reassuranceBuilder?.call(el))
+                .toList(),
+          ),
+        ),
+        const SizedBox(height: KasySpacing.xl),
+      ],
+    );
+
+    return OnboardingBackground(
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          Expanded(
+            child: SafeArea(
+              bottom: false,
+              child: SingleChildScrollView(
+                padding: const EdgeInsets.only(bottom: KasySpacing.md),
+                child: ResponsiveBuilder(
+                  small: scrollBody,
+                  medium: Center(
+                    child: ConstrainedBox(
+                      constraints: const BoxConstraints(maxWidth: 600),
+                      child: scrollBody,
+                    ),
+                  ),
+                ),
+              ),
+            ),
+          ),
+          DeviceSizeBuilder(
+            builder: (device) => OnboardingStickyFooter(
+              maxContentWidth:
+                  device == DeviceType.small ? null : 600,
+              children: [
+                KasyButton(
+                  label: widget.btnText,
+                  expand: true,
+                  onPressed: selectedChoiceId == null
+                      ? null
+                      : () => widget.onValidate?.call(selectedChoiceId),
+                ),
+              ],
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

package/lib/scaffold/backends/api/patch/lib/features/settings/ui/widgets/avatar_utils.dart

@@ -0,0 +1,33 @@
+typedef OnAvatarTap = void Function();
+
+final Map<String, String> _avatarUrlCache = {};
+
+void clearAvatarCache([String? userId]) {
+  if (userId != null) {
+    _avatarUrlCache.remove(userId);
+  } else {
+    _avatarUrlCache.clear();
+  }
+}
+
+String? getCachedAvatarUrl(String userId) => _avatarUrlCache[userId];
+
+void cacheAvatarUrl(String userId, String url) {
+  if (url.isNotEmpty) _avatarUrlCache[userId] = url;
+}
+
+String cacheBustedAvatarUrl(String url, Object version) {
+  if (url.isEmpty) return url;
+  final uri = Uri.tryParse(url);
+  if (uri == null) {
+    final separator = url.contains('?') ? '&' : '?';
+    return '$url${separator}v=$version';
+  }
+  final query = Map<String, String>.from(uri.queryParameters)
+    ..['v'] = version.toString();
+  return uri.replace(queryParameters: query).toString();
+}
+
+Future<String> resolveAvatarUrl(String userId) async {
+  return _avatarUrlCache[userId] ?? '';
+}

package/lib/scaffold/backends/api/patch/lib/features/subscription/api/entities/subscription_entity.dart

@@ -0,0 +1,34 @@
+// ignore_for_file: invalid_annotation_target, constant_identifier_names
+
+
+
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'subscription_entity.freezed.dart';
+part 'subscription_entity.g.dart';
+
+enum SubscriptionStatus {
+  ACTIVE,
+  PAUSED,
+  EXPIRED,
+  LIFETIME,
+  CANCELLED,
+}
+
+
+@freezed
+sealed class SubscriptionEntity with _$SubscriptionEntity {
+  const factory SubscriptionEntity({
+    @JsonKey(includeIfNull: false) String? id,
+    @JsonKey(name: 'offer_id') required String offerId,
+    @JsonKey(name: 'sku_id') required String skuId,
+    @JsonKey(name: 'creation_date') DateTime? creationDate,
+    @JsonKey(name: 'last_update_date') DateTime? lastUpdateDate,
+    @JsonKey(name: 'period_end_date') DateTime? periodEndDate,
+    @JsonKey(name: 'status') required SubscriptionStatus status,
+  }) = SubscriptionEntityData;
+
+  factory SubscriptionEntity.fromJson(Map<String, Object?> json) =>
+      _$SubscriptionEntityFromJson(json);
+}
+

package/lib/scaffold/backends/api/patch/lib/features/subscription/api/subscription_api.dart

@@ -0,0 +1,49 @@
+import 'package:kasy_kit/core/data/api/base_api_exceptions.dart';
+import 'package:kasy_kit/core/data/api/http_client.dart';
+import 'package:kasy_kit/features/subscription/api/entities/subscription_entity.dart';
+import 'package:dio/dio.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:logger/logger.dart';
+
+final subscriptionApiProvider = Provider(
+  (ref) => SubscriptionApi(
+    client: ref.read(httpClientProvider),
+    logger: Logger(),
+  ),
+);
+
+/// Subscription API
+/// Your backend should handle a webhook from the payment provider
+/// to update the subscription status
+/// Don't save the subscription status in the app,
+/// always do this from a webhook call between you backend and the payment provider
+class SubscriptionApi {
+  final Logger _logger;
+  final HttpClient _client;
+
+  SubscriptionApi({
+    required HttpClient client,
+    required Logger logger,
+  })  : _client = client,
+        _logger = logger;
+
+  Future<SubscriptionEntity?> get(String userId) async {
+    try {
+      final response = await _client.get('/user/$userId/subscription');
+      // final json = jsonDecode(response.data) as Map<String, dynamic>;
+      return SubscriptionEntity.fromJson(response.data as Map<String, dynamic>);
+    } on DioException catch (e, stackTrace) {
+      _logger.e(
+        "Error while getting user subscription from backend: $e",
+        stackTrace: stackTrace,
+      );
+      throw ApiError.fromDioException(e);
+    } catch (e) {
+      _logger.e(e);
+      throw ApiError(
+        code: 0,
+        message: '$e',
+      );
+    }
+  }
+}

package/lib/scaffold/backends/api/patch/lib/features/subscription/shared/maybeshow_premium.dart

@@ -0,0 +1,88 @@
+// ignore_for_file: use_build_context_synchronously
+
+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/data/models/user.dart';
+import 'package:kasy_kit/core/shared_preferences/shared_preferences.dart';
+import 'package:kasy_kit/core/states/components/maybeshow_component.dart';
+import 'package:kasy_kit/core/states/models/event_model.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/router.dart';
+
+const _lastAskKey = 'subscription_last_asking_date';
+
+const _lastShowPromoKey = 'subscription_last_show_promo_date';
+
+const _kDaysToAsk = 2;
+
+class MaybeShowPremiumPage implements MaybeShowWithRef {
+  @override
+  Future<bool> handle(WidgetRef ref, AppEvent event) async {
+    if (event is! OnAppStartEvent) {
+      return false;
+    }
+    if (kIsWeb && !revenuecatWeb) return false;
+    debugPrint("🧐 MaybeShowPremiumPage");
+    final userState = ref.watch(userStateNotifierProvider);
+    if (userState.subscription?.isActive == true) {
+      return false;
+    }
+    final userCreationDate = switch(userState.user) {
+      AuthenticatedUserData(:final creationDate) => creationDate,
+      AnonymousUserData(:final creationDate) => creationDate,
+      _ => null,
+    };
+
+    if (userCreationDate == null) {
+      return false;
+    }
+    
+    final now = DateTime.now();
+    final prefs = ref.watch(sharedPreferencesProvider).prefs;
+    
+    // await prefs.remove(_lastAskKey);
+    // await prefs.remove(_lastShowPromoKey);
+
+    final lastAskingDate = prefs.getInt(_lastAskKey);
+
+
+    /// 🧐 🧐 🧐 if we have a promo - we only show the promo once or customize it
+    /// ----
+    // final lastShowPromoInMS = prefs.getInt(_lastShowPromoKey);
+    // final lastShowPromoDate = lastShowPromoInMS == null ? null : DateTime.fromMillisecondsSinceEpoch(lastShowPromoInMS);
+    // if (now.isAfter(userCreationDate.add(const Duration(days: 3))) && lastShowPromoDate == null && ref.context.mounted) {
+    //   await prefs.setInt(_lastShowPromoKey, now.millisecondsSinceEpoch);
+    //   await prefs.setInt(_lastAskKey, DateTime.now().millisecondsSinceEpoch);
+    //   PromoBottomSheet.show(ref.context);
+    //   return true;
+    // }
+
+    if (now.isBefore(userCreationDate.add(const Duration(days: 1)))) {
+      return false;
+    }
+    
+    if (lastAskingDate == null) {
+      await prefs.setInt(_lastAskKey, DateTime.now().millisecondsSinceEpoch);
+      showPremiumPage(ref);
+      return true;
+    }
+
+    final lastDate = DateTime.fromMillisecondsSinceEpoch(lastAskingDate);
+    
+    final difference = now.difference(lastDate);
+
+    if (difference.inDays >= _kDaysToAsk) {
+      await prefs.setInt(_lastAskKey, now.millisecondsSinceEpoch);
+      showPremiumPage(ref);
+      return true;
+    }
+    
+    return false;
+  }
+
+  void showPremiumPage(WidgetRef ref) {
+    ref.read(goRouterProvider).push("/premium");
+  }
+}