kasy-cli 1.21.9 → 1.23.0

package/templates/firebase/lib/features/subscriptions/api/revenuecat_product.dart

@@ -0,0 +1,189 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/data/models/subscription.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+import 'package:purchases_flutter/purchases_flutter.dart';
+
+/// RevenueCat-backed [SubscriptionProduct] (mobile: App Store / Play Store).
+///
+/// Lives in its own file (not in `subscription.dart`) so the subscription core
+/// stays free of `purchases_flutter`. Only compiled when the RevenueCat module
+/// is enabled.
+class RevenueCatProduct implements SubscriptionProduct {
+  final Offering revenueCatOffer;
+  final Package revenueCatPackage;
+
+  RevenueCatProduct({
+    required this.revenueCatOffer,
+    required this.revenueCatPackage,
+  });
+
+  @override
+  String get skuId => revenueCatPackage.identifier;
+
+  @override
+  String get id => revenueCatOffer.identifier;
+
+  @override
+  String get description => revenueCatOffer.serverDescription;
+
+  @override
+  String get label =>
+      revenueCatPackage.presentedOfferingContext.offeringIdentifier;
+
+  @override
+  double get price => revenueCatPackage.storeProduct.price;
+
+  @override
+  String get currency => revenueCatPackage.storeProduct.currencyCode;
+
+  @override
+  int? get trialDays {
+    final introductory = revenueCatPackage.storeProduct.introductoryPrice;
+    if (introductory == null) {
+      return null;
+    }
+    if (introductory.price == 0) {
+      final unit = introductory.periodUnit;
+      switch (unit) {
+        case PeriodUnit.day:
+          return introductory.periodNumberOfUnits;
+        case PeriodUnit.week:
+          return introductory.periodNumberOfUnits * 7;
+        case PeriodUnit.month:
+          return introductory.periodNumberOfUnits * 30;
+        case PeriodUnit.year:
+          return introductory.periodNumberOfUnits * 365;
+        default:
+          return null;
+      }
+    }
+    return null;
+  }
+
+  @override
+  String? get promotion {
+    if (revenueCatOffer.metadata["promotions"] == null) {
+      return null;
+    }
+    final data =
+        revenueCatOffer.metadata["promotions"]! as Map<Object?, Object?>;
+    final locale = LocaleSettings.currentLocale.languageCode;
+    final id = skuId;
+    if (data.containsKey(id)) {
+      final promotion = data[id]! as Map<Object?, Object?>;
+      return promotion[locale]! as String;
+    }
+    return null;
+  }
+
+  @override
+  String? get title {
+    return revenueCatPackage.storeProduct.title;
+  }
+
+  @override
+  List<String>? get features {
+    final locale = LocaleSettings.currentLocale.languageCode;
+    if (revenueCatOffer.metadata[locale] == null) {
+      return null;
+    }
+    final data = revenueCatOffer.metadata[locale]! as Map<Object?, Object?>;
+    final featuerObj = data["features"]! as List<Object?>;
+    return featuerObj.map((e) => e! as String).toList();
+  }
+
+  @override
+  String get priceString {
+    return revenueCatPackage.storeProduct.priceString;
+  }
+
+  @override
+  Duration get duration =>
+      switch (revenueCatPackage.storeProduct.subscriptionPeriod) {
+        'P1W' => const Duration(days: 7),
+        'P1M' => const Duration(days: 30),
+        'P3M' => const Duration(days: 90),
+        'P6M' => const Duration(days: 180),
+        'P1Y' => const Duration(days: 365),
+        _ => Duration.zero,
+      };
+
+  @override
+  DurationType get durationType {
+    final durationCpy = duration;
+    if (durationCpy.inDays == 7) {
+      return DurationType.week;
+    } else if (durationCpy.inDays == 30) {
+      return DurationType.month;
+    } else if (durationCpy.inDays == 90) {
+      return DurationType.threeMonth;
+    } else if (durationCpy.inDays == 180) {
+      return DurationType.sixMonth;
+    } else if (durationCpy.inDays == 365) {
+      return DurationType.year;
+    }
+    return DurationType.lifetime;
+  }
+
+  @override
+  String formattedPrice(BuildContext context) {
+    final translatedDuration = switch (durationType) {
+      DurationType.week => Translations.of(context).premium.duration_weekly,
+      DurationType.year => Translations.of(context).premium.duration_annual,
+      DurationType.month => Translations.of(context).premium.duration_monthly,
+      DurationType.lifetime => Translations.of(
+        context,
+      ).premium.duration_lifetime,
+      _ => "",
+    };
+    return "${revenueCatPackage.storeProduct.priceString} $translatedDuration";
+  }
+
+  @override
+  String pricePerMonth(BuildContext context) {
+    final translatedDuration = Translations.of(
+      context,
+    ).premium.duration_monthly;
+    if (durationType == DurationType.lifetime) {
+      return revenueCatPackage.storeProduct.priceString;
+    }
+    final pricePerMonth = switch (durationType) {
+      DurationType.year => price / 12,
+      DurationType.threeMonth => price / 3,
+      DurationType.sixMonth => price / 6,
+      DurationType.week => (price * 4) / 12,
+      _ => 1,
+    };
+    final pricePerMonthString = pricePerMonth.toStringAsFixed(2);
+    final money = revenueCatPackage.storeProduct.currencyCode;
+    if (money == "USD") {
+      return "\$$pricePerMonthString/$translatedDuration";
+    } else if (money == "EUR") {
+      return "$pricePerMonthString/$translatedDuration";
+    }
+    return "$pricePerMonthString $money/$translatedDuration";
+  }
+
+  @override
+  String? pricePerYear(BuildContext context) {
+    final translatedDuration = Translations.of(context).premium.duration_annual;
+    if (durationType == DurationType.lifetime) {
+      return revenueCatPackage.storeProduct.priceString;
+    }
+    final pricePerMonth = switch (durationType) {
+      DurationType.year => price,
+      DurationType.threeMonth => price * 4,
+      DurationType.sixMonth => price * 2,
+      DurationType.week => (price * 4) * 12,
+      _ => 1,
+    };
+    final pricePerMonthString = pricePerMonth.toStringAsFixed(2);
+    final money = revenueCatPackage.storeProduct.currencyCode;
+    if (money == "USD") {
+      return "\$$pricePerMonthString/$translatedDuration";
+    } else if (money == "EUR") {
+      return "$pricePerMonthString/$translatedDuration";
+    }
+    return "$pricePerMonthString $money/$translatedDuration";
+  }
+}

package/templates/firebase/lib/features/subscriptions/api/stripe_backend_api.dart

@@ -0,0 +1,55 @@
+import 'package:cloud_functions/cloud_functions.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/features/subscriptions/api/stripe_product.dart';
+
+final stripeBackendApiProvider = Provider<StripeBackendApi>(
+  (ref) => StripeBackendApi(
+    functions: FirebaseFunctions.instanceFor(region: 'europe-west1'),
+  ),
+);
+
+/// Talks to the Stripe backend (Firebase Cloud Functions). The user identity is
+/// taken server-side from the authenticated callable context — never trusted
+/// from the client. This file is replaced per backend (Supabase / API) so the
+/// rest of the Stripe client code stays backend-agnostic.
+class StripeBackendApi {
+  final FirebaseFunctions _functions;
+
+  StripeBackendApi({required FirebaseFunctions functions})
+    : _functions = functions;
+
+  /// Active recurring prices, mapped to paywall offers.
+  Future<List<StripeProduct>> listPrices() async {
+    final res = await _functions
+        .httpsCallable('stripeFunctions-listPrices')
+        .call();
+    final list = (res.data as List).cast<dynamic>();
+    return list
+        .map((e) => StripeProduct.fromJson(Map<String, dynamic>.from(e as Map)))
+        .toList();
+  }
+
+  /// Create a hosted Checkout session for [priceId] and return its URL.
+  Future<String> createCheckoutSession({
+    required String priceId,
+    String? successUrl,
+    String? cancelUrl,
+  }) async {
+    final res = await _functions
+        .httpsCallable('stripeFunctions-createCheckoutSession')
+        .call({
+          'priceId': priceId,
+          if (successUrl != null) 'successUrl': successUrl,
+          if (cancelUrl != null) 'cancelUrl': cancelUrl,
+        });
+    return (res.data as Map)['url'] as String;
+  }
+
+  /// Create a Customer Portal session (manage / cancel) and return its URL.
+  Future<String> createPortalSession({String? returnUrl}) async {
+    final res = await _functions
+        .httpsCallable('stripeFunctions-createPortalSession')
+        .call({if (returnUrl != null) 'returnUrl': returnUrl});
+    return (res.data as Map)['url'] as String;
+  }
+}

package/templates/firebase/lib/features/subscriptions/api/stripe_payment_api.dart

@@ -0,0 +1,82 @@
+import 'package:kasy_kit/core/data/models/entitlement.dart';
+import 'package:kasy_kit/core/data/models/subscription.dart';
+import 'package:kasy_kit/features/subscriptions/api/entities/subscription_entity.dart';
+import 'package:kasy_kit/features/subscriptions/api/stripe_backend_api.dart';
+import 'package:kasy_kit/features/subscriptions/api/subscription_payment_api.dart';
+import 'package:url_launcher/url_launcher.dart';
+
+/// Stripe web subscription provider.
+///
+/// Uses hosted Stripe Checkout + Customer Portal: all card handling / PCI stay
+/// on Stripe and the client only opens the URLs the backend returns. Premium
+/// status lives server-side (the Stripe webhook writes the `subscriptions`
+/// record), so this provider exposes no local entitlements — the repository
+/// reads the status from the backend just like for RevenueCat.
+class StripePaymentApi implements SubscriptionPaymentApi {
+  final StripeBackendApi _backend;
+
+  StripePaymentApi({required StripeBackendApi backend}) : _backend = backend;
+
+  @override
+  Future<void> init() async {}
+
+  @override
+  Future<void> initUser(String userId) async {}
+
+  @override
+  Future<void> disconnectUser() async {}
+
+  @override
+  Future<List<SubscriptionProduct>> getOffers(String? offerId) {
+    return _backend.listPrices();
+  }
+
+  @override
+  Future<void> purchaseProduct(SubscriptionProduct product) async {
+    final returnUrl = Uri.base.toString();
+    final url = await _backend.createCheckoutSession(
+      priceId: product.skuId,
+      successUrl: returnUrl,
+      cancelUrl: returnUrl,
+    );
+    await _open(url);
+  }
+
+  @override
+  Future<void> unsubscribe(SubscriptionStore? origin) async {
+    final url = await _backend.createPortalSession(
+      returnUrl: Uri.base.toString(),
+    );
+    await _open(url);
+  }
+
+  @override
+  Future<void> restorePurchase() async {
+    // Stripe status is server-side (webhook -> backend). Nothing to restore on
+    // the device; the repository re-reads the subscription from the backend.
+  }
+
+  @override
+  Future<List<Entitlement>> getPermissions() async => [];
+
+  @override
+  Future<List<Entitlement>?> getEntitlements() async => [];
+
+  @override
+  Future<SubscriptionProduct?> getFromProductId(String productId) async {
+    final prices = await _backend.listPrices();
+    for (final price in prices) {
+      if (price.skuId == productId) return price;
+    }
+    return null;
+  }
+
+  @override
+  Future<void> presentCodeRedemptionSheet() async {}
+
+  Future<void> _open(String url) async {
+    // On web, redirect the current tab so the user returns to the app after
+    // Stripe Checkout / the Customer Portal.
+    await launchUrl(Uri.parse(url), webOnlyWindowName: '_self');
+  }
+}

package/templates/firebase/lib/features/subscriptions/api/stripe_product.dart

@@ -0,0 +1,178 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/data/models/subscription.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+
+/// Stripe-backed [SubscriptionProduct] (web). Built from a Stripe Price returned
+/// by the `stripe-list-prices` backend function, so the existing paywall UI
+/// renders it exactly like a RevenueCat product — no UI changes needed.
+class StripeProduct implements SubscriptionProduct {
+  /// Stripe Price id (`price_...`) — used as the sku and to start checkout.
+  final String priceId;
+
+  /// Stripe Product id (`prod_...`).
+  final String productId;
+
+  /// Stripe Product name.
+  final String productName;
+
+  final String _description;
+
+  /// Amount in the currency's minor unit (e.g. cents).
+  final int unitAmount;
+
+  final String _currency;
+
+  /// Recurring interval reported by Stripe: `day` | `week` | `month` | `year`.
+  final String interval;
+
+  /// Recurring interval count (e.g. 3 months).
+  final int intervalCount;
+
+  final int? _trialDays;
+
+  final List<String>? _features;
+
+  StripeProduct({
+    required this.priceId,
+    required this.productId,
+    required this.productName,
+    required String description,
+    required this.unitAmount,
+    required String currency,
+    required this.interval,
+    this.intervalCount = 1,
+    int? trialDays,
+    List<String>? features,
+  })  : _description = description,
+        _currency = currency,
+        _trialDays = trialDays,
+        _features = features;
+
+  factory StripeProduct.fromJson(Map<String, dynamic> json) => StripeProduct(
+    priceId: json['priceId'] as String,
+    productId: (json['productId'] ?? '') as String,
+    productName: (json['productName'] ?? '') as String,
+    description: (json['description'] ?? '') as String,
+    unitAmount: (json['unitAmount'] as num?)?.toInt() ?? 0,
+    currency: (json['currency'] ?? 'usd') as String,
+    interval: (json['interval'] ?? 'month') as String,
+    intervalCount: (json['intervalCount'] as num?)?.toInt() ?? 1,
+    trialDays: (json['trialDays'] as num?)?.toInt(),
+    features: (json['features'] as List?)?.map((e) => e.toString()).toList(),
+  );
+
+  @override
+  String get skuId => priceId;
+
+  @override
+  String get id => productId;
+
+  @override
+  String get description => _description;
+
+  @override
+  String get label => productName;
+
+  @override
+  double get price => unitAmount / 100.0;
+
+  @override
+  String get currency => _currency.toUpperCase();
+
+  @override
+  int? get trialDays => _trialDays;
+
+  @override
+  String? get promotion => null;
+
+  @override
+  String? get title => productName;
+
+  @override
+  List<String>? get features => _features;
+
+  @override
+  String get priceString => _formatMoney(price);
+
+  @override
+  Duration get duration => switch (durationType) {
+    DurationType.week => const Duration(days: 7),
+    DurationType.month => const Duration(days: 30),
+    DurationType.threeMonth => const Duration(days: 90),
+    DurationType.sixMonth => const Duration(days: 180),
+    DurationType.year => const Duration(days: 365),
+    DurationType.lifetime => Duration.zero,
+  };
+
+  @override
+  DurationType get durationType {
+    switch (interval) {
+      case 'week':
+        return DurationType.week;
+      case 'year':
+        return DurationType.year;
+      case 'month':
+        if (intervalCount == 3) return DurationType.threeMonth;
+        if (intervalCount == 6) return DurationType.sixMonth;
+        if (intervalCount >= 12) return DurationType.year;
+        return DurationType.month;
+      default:
+        return DurationType.month;
+    }
+  }
+
+  String _formatMoney(double value) {
+    final amount = value.toStringAsFixed(2);
+    if (currency == 'USD') return "\$$amount";
+    if (currency == 'EUR') return "$amount€";
+    return "$amount $currency";
+  }
+
+  @override
+  String formattedPrice(BuildContext context) {
+    final translatedDuration = switch (durationType) {
+      DurationType.week => Translations.of(context).premium.duration_weekly,
+      DurationType.year => Translations.of(context).premium.duration_annual,
+      DurationType.month => Translations.of(context).premium.duration_monthly,
+      DurationType.lifetime => Translations.of(
+        context,
+      ).premium.duration_lifetime,
+      _ => "",
+    };
+    return "$priceString $translatedDuration";
+  }
+
+  @override
+  String pricePerMonth(BuildContext context) {
+    final translatedDuration = Translations.of(
+      context,
+    ).premium.duration_monthly;
+    if (durationType == DurationType.lifetime) {
+      return priceString;
+    }
+    final monthly = switch (durationType) {
+      DurationType.year => price / 12,
+      DurationType.threeMonth => price / 3,
+      DurationType.sixMonth => price / 6,
+      DurationType.week => (price * 4) / 12,
+      _ => price,
+    };
+    return "${_formatMoney(monthly)}/$translatedDuration";
+  }
+
+  @override
+  String? pricePerYear(BuildContext context) {
+    final translatedDuration = Translations.of(context).premium.duration_annual;
+    if (durationType == DurationType.lifetime) {
+      return priceString;
+    }
+    final yearly = switch (durationType) {
+      DurationType.year => price,
+      DurationType.threeMonth => price * 4,
+      DurationType.sixMonth => price * 2,
+      DurationType.week => (price * 4) * 12,
+      _ => price * 12,
+    };
+    return "${_formatMoney(yearly)}/$translatedDuration";
+  }
+}

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

@@ -1,7 +1,7 @@
 import 'package:cloud_firestore/cloud_firestore.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:kasy_kit/core/data/api/firestore_retry.dart';
-import 'package:kasy_kit/features/subscription/api/entities/subscription_entity.dart';
+import 'package:kasy_kit/features/subscriptions/api/entities/subscription_entity.dart';
 
 final subscriptionApiProvider = Provider(
   (ref) => SubscriptionApi(client: FirebaseFirestore.instance),

package/templates/firebase/lib/features/subscriptions/api/subscription_payment_api.dart

@@ -0,0 +1,53 @@
+import 'package:kasy_kit/core/data/models/entitlement.dart';
+import 'package:kasy_kit/core/data/models/subscription.dart';
+import 'package:kasy_kit/features/subscriptions/api/entities/subscription_entity.dart';
+
+/// Provider-agnostic contract for a subscription payment provider.
+///
+/// Implemented by `RevenueCatPaymentApi` (mobile: App Store / Play Store) and
+/// `StripePaymentApi` (web). The repository depends on this interface only, so
+/// the right provider is injected per platform and a project can ship either,
+/// both, or (web-only) just Stripe — without pulling the other's SDK.
+abstract interface class SubscriptionPaymentApi {
+  /// Configure the provider SDK (no-op on platforms it does not support).
+  Future<void> init();
+
+  /// Associate the current app user with the provider.
+  Future<void> initUser(String userId);
+
+  /// Dissociate the current user from the provider.
+  Future<void> disconnectUser();
+
+  /// Available offers shown on the paywall.
+  Future<List<SubscriptionProduct>> getOffers(String? offerId);
+
+  /// Start the purchase flow for [product].
+  ///
+  /// Throws [UserCancelledPurchaseException] when the user cancels.
+  Future<void> purchaseProduct(SubscriptionProduct product);
+
+  /// Open the management/cancellation flow for a subscription whose origin is
+  /// [origin] (where it was purchased). Implementations only open external
+  /// management when allowed on the current platform.
+  Future<void> unsubscribe(SubscriptionStore? origin);
+
+  /// Restore / re-sync previous purchases.
+  Future<void> restorePurchase();
+
+  /// Currently active entitlements (access rights).
+  Future<List<Entitlement>> getPermissions();
+
+  /// Currently active entitlements, or null when none can be determined.
+  Future<List<Entitlement>?> getEntitlements();
+
+  /// Resolve a [SubscriptionProduct] from a store product id.
+  Future<SubscriptionProduct?> getFromProductId(String productId);
+
+  /// iOS-only: present the offer-code redemption sheet.
+  Future<void> presentCodeRedemptionSheet();
+}
+
+/// Thrown when the user cancels a purchase flow.
+class UserCancelledPurchaseException implements Exception {
+  UserCancelledPurchaseException();
+}

package/templates/firebase/lib/features/subscriptions/api/subscription_payment_api_provider.dart

@@ -0,0 +1,21 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/config/features.dart';
+import 'package:kasy_kit/environments.dart';
+import 'package:kasy_kit/features/subscriptions/api/inapp_subscription_api.dart';
+import 'package:kasy_kit/features/subscriptions/api/stripe_backend_api.dart';
+import 'package:kasy_kit/features/subscriptions/api/stripe_payment_api.dart';
+import 'package:kasy_kit/features/subscriptions/api/subscription_payment_api.dart';
+
+/// Selects the subscription payment provider per platform × enabled feature:
+/// - web  + Stripe module  -> [StripePaymentApi]
+/// - mobile + RevenueCat   -> [RevenueCatPaymentApi]
+///
+/// The CLI regenerates this file to match the modules a project enabled, so a
+/// web-only Stripe app never references RevenueCat (and vice-versa).
+final inAppSubscriptionApiProvider = Provider<SubscriptionPaymentApi>((ref) {
+  if (kIsWeb && withStripe) {
+    return StripePaymentApi(backend: ref.read(stripeBackendApiProvider));
+  }
+  return RevenueCatPaymentApi(environment: ref.read(environmentProvider));
+});

package/templates/firebase/lib/features/{subscription → subscriptions}/providers/premium_page_provider.dart

@@ -7,13 +7,12 @@ import 'package:kasy_kit/core/states/translations.dart';
 import 'package:kasy_kit/core/states/user_state_notifier.dart';
 import 'package:kasy_kit/core/toast/toast_service.dart';
 import 'package:kasy_kit/features/feedbacks/repositories/feature_request_repository.dart';
-import 'package:kasy_kit/features/subscription/api/inapp_subscription_api.dart'
+import 'package:kasy_kit/features/subscriptions/api/subscription_payment_api.dart'
     show UserCancelledPurchaseException;
-import 'package:kasy_kit/features/subscription/providers/models/premium_state.dart';
-import 'package:kasy_kit/features/subscription/repositories/subscription_repository.dart';
+import 'package:kasy_kit/features/subscriptions/providers/models/premium_state.dart';
+import 'package:kasy_kit/features/subscriptions/repositories/subscription_repository.dart';
 import 'package:kasy_kit/router.dart';
 import 'package:logger/logger.dart';
-import 'package:purchases_flutter/purchases_flutter.dart';
 import 'package:riverpod_annotation/riverpod_annotation.dart';
 import 'package:sentry_flutter/sentry_flutter.dart';
 
@@ -90,7 +89,7 @@ class PremiumStateNotifier extends _$PremiumStateNotifier {
     if (TargetPlatform.iOS != defaultTargetPlatform) {
       return;
     }
-    await Purchases.presentCodeRedemptionSheet();
+    await _subscriptionRepository.presentCodeRedemptionSheet();
   }
 
   void selectOffer(SubscriptionProduct offer) {
@@ -184,7 +183,11 @@ class PremiumStateNotifier extends _$PremiumStateNotifier {
 
   Future<void> unsubscribe() async {
     // _analytics.logPageOpened("launch_unsubscribe_page");
-    await _subscriptionRepository.unsubscribe();
+    // Route by the subscription's origin (store). The UI only reaches here when
+    // the subscription can be managed on the current platform; the cross-platform
+    // case is handled with an info dialog before this is called.
+    final store = _userState.subscription?.store;
+    await _subscriptionRepository.unsubscribe(store);
   }
 
   Future<void> saveUnsubscribeReason(String reason) async {