Merge pull request #503 from OpenPecha/chore/SubplansLinkShare

Chore/subplans link share

Author: tentamdin

ios/Podfile.lock

@@ -404,11 +404,11 @@ SPEC CHECKSUMS:
   Mantle: c5aa8794a29a022dfbbfc9799af95f477a69b62d
   nanopb: fad817b59e0457d11a5dfbde799381cd727c1275
   OrderedSet: e539b66b644ff081c73a262d24ad552a69be3a94
-  package_info_plus: c0502532a26c7662a62a356cebe2692ec5fe4ec4
-  path_provider_foundation: 0b743cbb62d8e47eab856f09262bb8c1ddcfe6ba
-  permission_handler_apple: ee2fe0fd04551b304eb002714ff067c371c822ed
+  package_info_plus: af8e2ca6888548050f16fa2f1938db7b5a5df499
+  path_provider_foundation: bb55f6dbba17d0dccd6737fe6f7f34fbd0376880
+  permission_handler_apple: 92d754bbaa7361d436db2d6c3c1c2a0fdcec462e
   PostHog: 82eee1ba92efc8144b06b6e4412abba5438c8fda
-  posthog_flutter: 70c295afe8f9eb52e99eefe031af0001bdf9b735
+  posthog_flutter: 343db84a70d44b12fa0fe2fc35bbb58098074bd4
   PromisesObjC: 752c3227f599e3467650e47ea36f433eeb10c273
   PromisesSwift: 217dea0fd5d2ad65222a109c48698add13cc1c5b
   SDWebImage: e9fc87c1aab89a8ab1bbd74eba378c6f53be8abf

lib/core/config/router/app_router.dart

@@ -464,10 +464,15 @@ final appRouterProvider = Provider<GoRouter>((ref) {
           final extra = state.extra as Map<String, dynamic>?;
           final plan = extra?['plan'] as Plan?;
           final seriesId = extra?['seriesId'] as String?;
+          final selectedDay = extra?['selectedDay'] as int?;
           if (plan == null) {
             throw Exception('Missing required parameters');
           }
-          return PlanPreviewDetails(plan: plan, seriesId: seriesId);
+          return PlanPreviewDetails(
+            plan: plan,
+            seriesId: seriesId,
+            initialDay: selectedDay,
+          );
         },
       ),
       GoRoute(

lib/core/deep_linking/app_links_deep_link_service.dart

@@ -21,6 +21,8 @@ class AppLinksDeepLinkService {
   DateTime? _lastDispatchedAt;
   bool _initialized = false;
   void Function(int tabIndex)? _tabSetter;
+  void Function(String planId, int? dayNumber, String? planLanguage)?
+      _planNavigator;
 
   static const Duration _duplicateDispatchWindow = Duration(seconds: 5);
 
@@ -59,6 +61,13 @@ class AppLinksDeepLinkService {
     _tabSetter = setter;
   }
 
+  void setPlanNavigator(
+    void Function(String planId, int? dayNumber, String? planLanguage)
+        navigator,
+  ) {
+    _planNavigator = navigator;
+  }
+
   bool drainPendingLink() {
     final router = _router;
     if (router == null) return false;
@@ -152,6 +161,7 @@ class AppLinksDeepLinkService {
       source: 'app_links',
       baseLocation: baseLocation,
       tabSetter: _tabSetter,
+      planNavigator: _planNavigator,
     );
     if (routed) {
       _lastDispatchedUri = uri;

lib/core/deep_linking/deep_link_router.dart

@@ -15,6 +15,8 @@ class DeepLinkRouter {
     required String source,
     String? baseLocation,
     void Function(int tabIndex)? tabSetter,
+    void Function(String planId, int? dayNumber, String? planLanguage)?
+        planNavigator,
   }) {
     try {
       final destination = _resolveRoute(uri);
@@ -23,6 +25,20 @@ class DeepLinkRouter {
         return false;
       }
 
+      // Plan links can't be expressed as a plain location: opening a specific
+      // plan requires resolving the plan model from its id, which the injected
+      // [planNavigator] handles (mirroring the PLAN push-notification path).
+      // When no navigator is wired (e.g. the Airbridge path), fall through to
+      // the destination's fallback location instead.
+      final planId = destination.planId;
+      if (planId != null && planNavigator != null) {
+        _logger.info(
+          'Deep link from $source -> plan $planId day ${destination.dayNumber} lang ${destination.planLanguage} ($uri)',
+        );
+        planNavigator(planId, destination.dayNumber, destination.planLanguage);
+        return true;
+      }
+
       _logger.info('Deep link from $source -> ${destination.location} ($uri)');
       if (destination.opensOnTop && baseLocation != null) {
         router.go(baseLocation);
@@ -140,6 +156,29 @@ class DeepLinkRouter {
       return const _DeepLinkDestination(AppRoutes.home, tabIndex: _meTabIndex);
     }
 
+    if (segments.length >= 3 &&
+        segments[0] == 'open' &&
+        segments[1] == 'plan') {
+      final planId = segments[2];
+      // /open/plan/{planId}/day/{dayNumber}?lang={language}  — specific day deep link
+      int? dayNumber;
+      if (segments.length >= 5 && segments[3] == 'day') {
+        dayNumber = int.tryParse(segments[4]);
+      }
+      // lang carries the content language the plan was enrolled in, so the
+      // recipient's app can find the enrollment even across locale differences.
+      final planLanguage = uri.queryParameters['lang'];
+      // Fallback location (My Practices) is used only when no planNavigator is
+      // wired; otherwise the navigator resolves and opens the specific plan.
+      return _DeepLinkDestination(
+        AppRoutes.practiceMyPractices,
+        planId: planId,
+        dayNumber: dayNumber,
+        planLanguage: planLanguage,
+        opensOnTop: true,
+      );
+    }
+
     if (segments.length >= 3 &&
         segments[0] == 'open' &&
         segments[1] == 'group') {
@@ -208,10 +247,26 @@ class _DeepLinkDestination {
   /// the `/home` route (e.g. the Me tab).
   final int? tabIndex;
 
+  /// When non-null, this destination targets a specific plan that must be
+  /// resolved from its id by the injected `planNavigator`. [location] then
+  /// acts only as a fallback for callers without a navigator.
+  final String? planId;
+
+  /// When non-null, the plan navigator should open this specific day instead
+  /// of computing today's day from the plan start date.
+  final int? dayNumber;
+
+  /// Content language of the shared plan (e.g. 'en', 'bo'). Passed to the
+  /// plan navigator so it can find the enrollment across locale differences.
+  final String? planLanguage;
+
   const _DeepLinkDestination(
     this.location, {
     this.extra,
     this.opensOnTop = false,
     this.tabIndex,
+    this.planId,
+    this.dayNumber,
+    this.planLanguage,
   });
 }

lib/core/deep_linking/deep_link_url_builder.dart

@@ -25,6 +25,37 @@ class DeepLinkUrlBuilder {
     );
   }
 
+  static Uri planLink({required String planId}) {
+    return Uri(
+      scheme: 'https',
+      host: _host,
+      pathSegments: ['open', 'plan', planId],
+    );
+  }
+
+  /// Returns a link that opens a specific day inside a plan.
+  ///
+  /// Format: https://webuddhist.com/open/plan/{planId}/day/{dayNumber}?lang={language}
+  ///
+  /// [language] is the content language of the plan (e.g. 'en', 'bo'). It is
+  /// included so the recipient's app can locate the correct enrollment even when
+  /// their app locale differs from the sharer's.
+  static Uri planDayLink({
+    required String planId,
+    required int dayNumber,
+    String? language,
+  }) {
+    final queryParameters = <String, String>{
+      if (language != null && language.isNotEmpty) 'lang': language,
+    };
+    return Uri(
+      scheme: 'https',
+      host: _host,
+      pathSegments: ['open', 'plan', planId, 'day', dayNumber.toString()],
+      queryParameters: queryParameters.isNotEmpty ? queryParameters : null,
+    );
+  }
+
   static Uri readerSegmentLink({
     required String textId,
     required String segmentId,

lib/core/l10n/app_bo.arb

@@ -825,5 +825,6 @@
   "license_with_value": "ཆོག་མཆན། {value}",
   "loading_previous_pages": "སྔོན་མ་འཇུག་བཞིན་པ།.. (ཤོག་གྲངས་ {count})",
   "loading_more_pages": "མང་བ་འཇུག་བཞིན་པ།.. (ཤོག་གྲངས་ {count})",
-  "drag_to_resize": "ཆེ་ཆུང་བསྒྱུར་བར་འདྲུད་རོགས།"
+  "drag_to_resize": "ཆེ་ཆུང་བསྒྱུར་བར་འདྲུད་རོགས།",
+  "day_completion_share_message": "ངས་ WeBuddhist ཐོག་ཉམས་ལེན་གྱི་ཉིན་གཅིག་མཐར་ཕྱིན་སོང་། ང་དང་ལྷན་དུ་ཉིན་རེའི་ཉམས་ལེན་གོམ་པ་འཇོག་རོགས།"
 }

lib/core/l10n/app_en.arb

@@ -994,5 +994,6 @@
       }
     }
   },
-  "drag_to_resize": "Drag to resize"
+  "drag_to_resize": "Drag to resize",
+  "day_completion_share_message": "I just completed a day of my practice on WeBuddhist. Join me and build a daily practice habit together."
 }

lib/core/l10n/app_hi.arb

@@ -891,5 +891,6 @@
   "license_with_value": "लाइसेंस: {value}",
   "loading_previous_pages": "पिछला लोड हो रहा है... ({count} पृष्ठ)",
   "loading_more_pages": "और लोड हो रहा है... ({count} पृष्ठ)",
-  "drag_to_resize": "आकार बदलने के लिए खींचें"
+  "drag_to_resize": "आकार बदलने के लिए खींचें",
+  "day_completion_share_message": "मैंने WeBuddhist पर अपने अभ्यास का एक दिन पूरा किया। मेरे साथ जुड़ें और साथ मिलकर रोज़ाना अभ्यास की आदत बनाएं।"
 }

lib/core/l10n/app_mn.arb

@@ -891,5 +891,6 @@
   "license_with_value": "Лиценз: {value}",
   "loading_previous_pages": "Өмнөхийг ачаалж байна... ({count} хуудас)",
   "loading_more_pages": "Илүү ихийг ачаалж байна... ({count} хуудас)",
-  "drag_to_resize": "Хэмжээг өөрчлөхийн тулд чирнэ үү"
+  "drag_to_resize": "Хэмжээг өөрчлөхийн тулд чирнэ үү",
+  "day_completion_share_message": "Би WeBuddhist дээр өөрийн дадлагын нэг өдрийг дуусгалаа. Надтай нэгдэж, хамтдаа өдөр тутмын дадлагын зуршил бий болгоцгооё."
 }

lib/core/l10n/app_ne.arb

@@ -891,5 +891,6 @@
   "license_with_value": "इजाजतपत्र: {value}",
   "loading_previous_pages": "अघिल्लो लोड हुँदैछ... ({count} पृष्ठ)",
   "loading_more_pages": "थप लोड हुँदैछ... ({count} पृष्ठ)",
-  "drag_to_resize": "आकार परिवर्तन गर्न तान्नुहोस्"
+  "drag_to_resize": "आकार परिवर्तन गर्न तान्नुहोस्",
+  "day_completion_share_message": "मैले WeBuddhist मा आफ्नो अभ्यासको एक दिन पूरा गरें। मसँगै सामेल हुनुस् र एकसाथ दैनिक अभ्यास बानी निर्माण गरौं।"
 }