kasy-cli 1.16.0 → 1.17.0

package/templates/firebase/android/app/src/main/kotlin/com/aicrus/firebase/kit/OpenAppAction.kt

@@ -0,0 +1,26 @@
+package com.aicrus.firebase.kit
+
+import android.content.Context
+import android.content.Intent
+import androidx.glance.GlanceId
+import androidx.glance.action.ActionParameters
+import androidx.glance.appwidget.action.ActionCallback
+
+// Custom ActionCallback used by MyWidgetWidget instead of actionStartActivity.
+// actionStartActivity wraps the launch in an internal "glance-action://CALLBACK"
+// intent that ends up reaching MainActivity (because launchMode=singleTop) as
+// the new intent — Flutter sees that URI as a deep link and go_router blows up
+// with "no routes for location: glance-action:/CALLBACK". Running the launch
+// ourselves through onAction bypasses that wrapping entirely.
+class OpenAppAction : ActionCallback {
+    override suspend fun onAction(
+        context: Context,
+        glanceId: GlanceId,
+        parameters: ActionParameters,
+    ) {
+        val intent = Intent(context, MainActivity::class.java).apply {
+            flags = Intent.FLAG_ACTIVITY_SINGLE_TOP or Intent.FLAG_ACTIVITY_NEW_TASK
+        }
+        context.startActivity(intent)
+    }
+}

package/templates/firebase/docs/revenuecat-setup.es.md

@@ -9,12 +9,24 @@ Guía para activar suscripciones y compras en la app después de que la CLI gene
 | Ya listo | Lo que falta |
 |----------|--------------|
 | Instaló `purchases_flutter` | Crear cuenta en RevenueCat |
-| Configuró las claves en `Makefile` y `.vscode/launch.json` | Crear Productos, Entitlements y Offerings en el panel RC |
+| Configuró las claves en `.env` (test/iOS prod/Android prod) | Crear Productos, Entitlements y Offerings en el panel RC |
 | Generó el código del paywall y del repositorio de suscripciones | Registrar la URL del webhook en el panel RC |
 | Firebase: desplegó la Cloud Function del webhook | — |
 | Supabase: desplegó la Edge Function del webhook | — |
 
-> Las claves quedan en `.vscode/launch.json` y `Makefile`. Ambos archivos están en `.gitignore` — las claves nunca van al repositorio.
+> Las claves quedan en `.env` en la raíz (fuente de verdad) y reflejadas en `.vscode/launch.json` + `Makefile`. Todos en `.gitignore` — nunca van al repositorio.
+
+### ¿Qué clave usar?
+
+La CLI pregunta **tres claves opcionales** (al menos una es obligatoria):
+
+| Variable | Prefijo | Uso |
+|---|---|---|
+| `RC_TEST_KEY` | `test_` | Test Store. **Una sola clave**, sirve para iOS+Android. Usada automáticamente en simulador/emulador. |
+| `RC_IOS_PROD_KEY` | `appl_` | App Store (Sandbox + Producción). Usada automáticamente en iPhone físico. |
+| `RC_ANDROID_PROD_KEY` | `goog_` | Google Play (Sandbox + Producción). Usada automáticamente en Android físico. |
+
+`kasy run` elige la clave correcta según el dispositivo. Forzar manualmente: `kasy run --rc=test` o `kasy run --rc=prod`.
 
 ---
 
@@ -155,9 +167,13 @@ Después de completar todo y configurar el idioma del grupo, el estado sale de *
 
 [app.revenuecat.com](https://app.revenuecat.com) → tu proyecto → **Apps** → `+ Add app` → **App Store** → copia la clave `appl_xxx`.
 
-Actualiza en los archivos del proyecto:
-- `.vscode/launch.json` → reemplaza `RC_IOS_API_KEY`
-- `Makefile` → reemplaza la misma variable en el bloque `DEFINES`
+Pégala en el `.env` de la raíz:
+
+```env
+RC_IOS_PROD_KEY=appl_xxxxxxxxxxxxxxx
+```
+
+`kasy run` usa esta clave automáticamente en iPhone físico (el simulador sigue con `RC_TEST_KEY`).
 
 **6. Crear Sandbox Tester — obligatorio para probar en iPhone físico**
 
@@ -253,9 +269,13 @@ d) Google Play Console → **Configuración** → **Usuarios y permisos** → **
 
 [app.revenuecat.com](https://app.revenuecat.com) → tu proyecto → **Apps** → `+ Add app` → **Google Play** → sube el archivo JSON → copia la clave `goog_xxx`.
 
-Actualiza en los archivos del proyecto:
-- `.vscode/launch.json` → reemplaza `RC_ANDROID_API_KEY`
-- `Makefile` → reemplaza la misma variable en el bloque `DEFINES`
+Pégala en el `.env` de la raíz:
+
+```env
+RC_ANDROID_PROD_KEY=goog_xxxxxxxxxxxxxxx
+```
+
+`kasy run` usa esta clave automáticamente en Android físico (el emulador sigue con `RC_TEST_KEY`).
 
 **8. Agregar License Tester — obligatorio para probar en el dispositivo**
 

package/templates/firebase/docs/revenuecat-setup.pt.md

@@ -9,12 +9,24 @@ Guia para ativar assinaturas e compras no app depois que a CLI gerou o projeto.
 | Já pronto | O que ainda falta |
 |-----------|-------------------|
 | Instalou `purchases_flutter` | Criar conta no RevenueCat |
-| Configurou as chaves no `Makefile` e `.vscode/launch.json` | Criar Produtos, Entitlements e Offerings no painel RC |
+| Configurou as chaves no `.env` (test/iOS prod/Android prod) | Criar Produtos, Entitlements e Offerings no painel RC |
 | Gerou o código do paywall e do repositório de assinaturas | Registrar a URL do webhook no painel RC |
 | Firebase: implantou a Cloud Function do webhook | — |
 | Supabase: implantou a Edge Function do webhook | — |
 
-> As chaves ficam em `.vscode/launch.json` e `Makefile`. Esses dois arquivos estão no `.gitignore` — as chaves nunca vão para o repositório.
+> As chaves ficam em `.env` na raiz (fonte da verdade) e refletidas no `.vscode/launch.json` + `Makefile`. Todos no `.gitignore` — nunca vão para o repositório.
+
+### Qual chave usar?
+
+A CLI pergunta **três chaves opcionais** (pelo menos uma é obrigatória):
+
+| Variável | Prefixo | Uso |
+|---|---|---|
+| `RC_TEST_KEY` | `test_` | Test Store. **Uma chave única**, vale iOS+Android. Usada automaticamente em simulador/emulador. |
+| `RC_IOS_PROD_KEY` | `appl_` | App Store (Sandbox + Produção). Usada automaticamente em iPhone físico. |
+| `RC_ANDROID_PROD_KEY` | `goog_` | Google Play (Sandbox + Produção). Usada automaticamente em Android físico. |
+
+O `kasy run` escolhe a chave certa baseado no device. Forçar manual: `kasy run --rc=test` ou `kasy run --rc=prod`.
 
 ---
 
@@ -155,9 +167,13 @@ Após preencher tudo e configurar o idioma do grupo, o status sai de **Missing M
 
 [app.revenuecat.com](https://app.revenuecat.com) → seu projeto → **Apps** → `+ Add app` → **App Store** → copie a chave `appl_xxx`.
 
-Atualize nos arquivos do projeto:
-- `.vscode/launch.json` → substitua `RC_IOS_API_KEY`
-- `Makefile` → substitua a mesma variável no bloco `DEFINES`
+Cole no `.env` da raiz:
+
+```env
+RC_IOS_PROD_KEY=appl_xxxxxxxxxxxxxxx
+```
+
+O `kasy run` usa essa chave automaticamente em iPhone físico (simulador continua com `RC_TEST_KEY`).
 
 **6. Criar Sandbox Tester — obrigatório para testar no iPhone físico**
 
@@ -253,9 +269,13 @@ d) Google Play Console → **Configurações** → **Usuários e permissões**
 
 [app.revenuecat.com](https://app.revenuecat.com) → seu projeto → **Apps** → `+ Add app` → **Google Play** → faça upload do arquivo JSON → copie a chave `goog_xxx`.
 
-Atualize nos arquivos do projeto:
-- `.vscode/launch.json` → substitua `RC_ANDROID_API_KEY`
-- `Makefile` → substitua a mesma variável no bloco `DEFINES`
+Cole no `.env` da raiz:
+
+```env
+RC_ANDROID_PROD_KEY=goog_xxxxxxxxxxxxxxx
+```
+
+O `kasy run` usa essa chave automaticamente em Android físico (emulador continua com `RC_TEST_KEY`).
 
 **8. Adicionar License Tester — obrigatório para testar no dispositivo**
 

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

@@ -1,7 +1,3 @@
-import 'dart:async';
-import 'dart:io' show Platform;
-
-import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:home_widget/home_widget.dart';
 import 'package:kasy_kit/core/data/models/user.dart';
 import 'package:kasy_kit/core/home_widgets/home_widget_service.dart';
@@ -38,12 +34,6 @@ class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
   /// Snapshot of the user fields the widget reads. Used to skip the update
   /// when an unrelated field changes (e.g. lastUpdateDate refresh).
   (String?, String?, String?, bool) _widgetSignature(User user) {
-    final isPro = switch (user) {
-      AuthenticatedUserData(:final subscription) ||
-      AnonymousUserData(:final subscription) =>
-        subscription?.isActive ?? false,
-      _ => false,
-    };
     final name = switch (user) {
       AuthenticatedUserData(:final name) => name,
       _ => null,
@@ -52,21 +42,41 @@ class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
       AuthenticatedUserData(:final email) => email,
       _ => null,
     };
-    return (user.idOrNull, name, email, isPro);
+    return (user.idOrNull, name, email, _cachedIsPro(user));
   }
 
   @override
-  Future<void> update() => updateForLocale(LocaleSettings.currentLocale);
-
-  /// Same as [update] but renders against an explicit locale. Use this
-  /// from the language picker so the widget never falls one step behind:
-  /// `LocaleSettings.setLocale` propagates to `currentLocale` over a
-  /// frame boundary, and an [update] call scheduled at the same time
-  /// can race with it. Passing the locale removes the race.
-  Future<void> updateForLocale(AppLocale locale) async {
+  Future<void> update() => _renderForLocale(
+        LocaleSettings.currentLocale,
+        refreshSubscription: true,
+      );
+
+  /// Same as [update] but renders against an explicit locale and skips the
+  /// RevenueCat refresh. Two reasons:
+  ///  1. `LocaleSettings.setLocale` propagates to `currentLocale` over a
+  ///     frame boundary, and an [update] call scheduled at the same time
+  ///     can race with it — passing the locale removes the race.
+  ///  2. The network call inside [_resolveIsPro] adds up to 2s of latency
+  ///     before the new strings reach SharedPreferences, which is what made
+  ///     the widget look "one step behind" after switching language.
+  Future<void> updateForLocale(AppLocale locale) =>
+      _renderForLocale(locale, refreshSubscription: false);
+
+  Future<void> _renderForLocale(
+    AppLocale locale, {
+    required bool refreshSubscription,
+  }) async {
     final logger = Logger();
     logger.i('🔄 Updating MyWidget Home Widget (${locale.languageCode})');
     final user = ref.read(userStateNotifierProvider).user;
+
+    // Slang lazy-loads non-base locales: AppLocale.pt.translations falls back
+    // silently to the base locale (en) until the locale's bundle is loaded
+    // into memory. setLocale() kicks off that load asynchronously, so a tap
+    // on "Português" immediately followed by updateForLocale(pt) would push
+    // English text to the widget on the first try and the correct one on
+    // the retry. Awaiting loadLocale here removes the race.
+    await LocaleSettings.instance.loadLocale(locale);
     final t = locale.translations;
 
     // "Logged out" = no user id at all (post-logout in authRequired mode, or
@@ -86,7 +96,8 @@ class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
       _ => null,
     };
 
-    final isPro = !isLoggedOut && await _resolveIsPro(user);
+    final isPro = !isLoggedOut &&
+        (refreshSubscription ? await _resolveIsPro(user) : _cachedIsPro(user));
 
     final greeting = _greeting(t);
     final title = isLoggedOut
@@ -115,18 +126,20 @@ class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
     });
   }
 
+  bool _cachedIsPro(User user) => switch (user) {
+        AuthenticatedUserData(:final subscription) ||
+        AnonymousUserData(:final subscription) =>
+          subscription?.isActive ?? false,
+        _ => false,
+      };
+
   /// Returns true if the user has an active subscription.
   /// Queries the SubscriptionRepository directly so the widget reflects the
   /// most recent state — including the RevenueCat fallback when the backend
   /// webhook is delayed. Falls back to the in-memory user.subscription if the
   /// fresh fetch fails (no network, RC not initialised, etc.).
   Future<bool> _resolveIsPro(User user) async {
-    final cached = switch (user) {
-      AuthenticatedUserData(:final subscription) ||
-      AnonymousUserData(:final subscription) =>
-        subscription?.isActive ?? false,
-      _ => false,
-    };
+    final cached = _cachedIsPro(user);
     final userId = user.idOrNull;
     if (userId == null) return cached;
     try {
@@ -152,21 +165,6 @@ class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
     await HomeWidget.saveWidgetData<String>('isPro', data['isPro'] ?? 'false');
     await HomeWidget.saveWidgetData<String>('quote', data['quote'] ?? '');
 
-    // On Android, saveWidgetData writes via SharedPreferences.apply() which
-    // is asynchronous. Glance's HomeWidgetGlanceStateDefinition reads from
-    // the same prefs, but a tight saveWidgetData→updateWidget sequence can
-    // race the apply() flush — Glance recomposes with the previous values
-    // (most visible right after a locale change). Fire two updates spaced
-    // out by 400ms each so even slow devices catch the new state.
-    if (!kIsWeb && Platform.isAndroid) {
-      await Future<void>.delayed(const Duration(milliseconds: 400));
-      await HomeWidget.updateWidget(
-        name: _androidWidgetName,
-        iOSName: _iosWidgetName,
-      );
-      await Future<void>.delayed(const Duration(milliseconds: 400));
-    }
-
     await HomeWidget.updateWidget(
       name: _androidWidgetName,
       iOSName: _iosWidgetName,

package/templates/firebase/lib/router.dart

@@ -24,6 +24,7 @@ import 'package:kasy_kit/features/settings/ui/components/admin/admin_routes.dart
 import 'package:kasy_kit/features/settings/ui/components/admin/send_push_notification_page.dart';
 import 'package:kasy_kit/features/subscription/ui/component/premium_page_factory.dart';
 import 'package:kasy_kit/features/subscription/ui/premium_page.dart';
+import 'package:logger/logger.dart';
 
 final goRouterProvider = Provider<GoRouter>((ref) => generateRouter());
 
@@ -41,7 +42,20 @@ GoRouter generateRouter({
   return GoRouter(
     initialLocation: '/',
     navigatorKey: navigatorKey,
-    errorBuilder: (context, state) => const PageNotFound(),
+    // Catches unknown routes (e.g. an Android warm-start from the home widget
+    // landed on a stale URI) and silently sends the user home instead of
+    // surfacing a dead-end "404" page. We log the offending URI so a real
+    // misconfigured route doesn't get masked.
+    // Note: GoRouter doesn't accept both onException and errorBuilder, so the
+    // /404 GoRoute below is what reaches PageNotFound when explicitly navigated.
+    onException: (context, state, router) {
+      Logger().w(
+        'GoRouter caught unknown route → "${state.uri}" '
+        '(matched: "${state.matchedLocation}", error: ${state.error}). '
+        'Redirecting to "/".',
+      );
+      router.go('/');
+    },
     observers: [
       AnalyticsObserver(analyticsApi: MixpanelAnalyticsApi.instance()),