Notifications and deep links

ACCESS_TOKEN=$(gcloud auth print-access-token)
curl -s -X POST "https://fcm.googleapis.com/v1/projects/hoco-dev/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" \
  -d '{"message":{"token":"<fcm-token>","notification":{"title":"Commande confirmée","body":"CMD-2026-000158"},
       "android":{"notification":{"channel_id":"transactional"}},
       "data":{"eventKey":"order.validated","route":"/orders/0192f4b8-7c1e-7a10-9f00-5b6d2c8e1a01",
               "entityType":"ORDER","entityId":"0192f4b8-7c1e-7a10-9f00-5b6d2c8e1a01","notificationId":"0192f4c1-2b3a-7d44-8e21-3f9a0c7d5e02"}}}'

Future<void> registerDevice(Ref ref) async {
  final messaging = FirebaseMessaging.instance;
  final settings = await messaging.getNotificationSettings();
  final token = settings.authorizationStatus == AuthorizationStatus.authorized ? await messaging.getToken() : null;
  final info = ref.read(clientInfoProvider);
  await ref.read(hocoApiProvider).me.meDevicesRegister(
        idempotencyKey: uuidV7(),
        body: DeviceRegistration(
          deviceId: info.deviceId,
          platform: info.platform,             // android
          pushToken: token,
          appId: info.appId,                   // RESELLER_APP or DELEGATE_APP
          appVersion: info.appVersion,         // 1.4.2
          locale: info.locale,
          osVersion: info.osVersion,
          model: info.model,
        ),
      );
}

{
  "message": {
    "token": "fcm-device-token",
    "notification": { "title": "Commande confirmée", "body": "Votre commande CMD-2026-000158 de 125 000,00 DA est confirmée. Nous la préparons." },
    "android": {
      "collapse_key": "order:0192f4b8-7c1e-7a10-9f00-5b6d2c8e1a01",
      "priority": "high",
      "notification": { "channel_id": "transactional", "tag": "order:0192f4b8-7c1e-7a10-9f00-5b6d2c8e1a01" }
    },
    "data": {
      "notificationId": "0192f4c1-2b3a-7d44-8e21-3f9a0c7d5e02",
      "eventKey": "order.validated",
      "route": "/orders/0192f4b8-7c1e-7a10-9f00-5b6d2c8e1a01",
      "entityType": "ORDER",
      "entityId": "0192f4b8-7c1e-7a10-9f00-5b6d2c8e1a01"
    }
  }
}

@pragma('vm:entry-point')
Future<void> firebaseBackgroundHandler(RemoteMessage message) async {
  if (message.data['type'] == 'sync') {
    await scheduleOneOffSync(reason: 'push:${message.data['scope']}'); // WorkManager, network required
  }
}

Future<void> wirePush(GoRouter router, PendingRoute pending) async {
  FirebaseMessaging.onBackgroundMessage(firebaseBackgroundHandler);
  FirebaseMessaging.onMessage.listen(showInAppBanner);
  FirebaseMessaging.onMessageOpenedApp.listen((m) => openFromPush(router, m.data));
  final initial = await FirebaseMessaging.instance.getInitialMessage();
  if (initial != null) pending.set(initial.data); // consumed once the gate leaves Booting
}

Future<void> createChannels(FlutterLocalNotificationsPlugin plugin, AppLocalizations l10n) async {
  final android = plugin.resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>();
  for (final c in [
    AndroidNotificationChannel('transactional', l10n.channelTransactional, importance: Importance.high),
    AndroidNotificationChannel('security', l10n.channelSecurity, importance: Importance.high),
    AndroidNotificationChannel('field', l10n.channelField, importance: Importance.high),
    AndroidNotificationChannel('promotional', l10n.channelPromotional),
    AndroidNotificationChannel('announcement', l10n.channelAnnouncement),
    AndroidNotificationChannel('tour_tracking', l10n.channelTourTracking, importance: Importance.low),
    AndroidNotificationChannel('sync', l10n.channelSync, importance: Importance.low),
  ]) {
    await android?.createNotificationChannel(c);
  }
}

<activity android:name=".MainActivity" android:launchMode="singleTop" android:exported="true">
  <intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="${appLinkHost}" android:pathPrefix="/i/" />
  </intent-filter>
</activity>

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "dz.hoco.reseller",
      "sha256_cert_fingerprints": ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
    }
  }
]

Future<void> reportInstallOnce(Ref ref) async {
  final prefs = ref.read(preferencesProvider);
  if (await prefs.getBool('attribution.done') ?? false) return;
  try {
    final r = await PlayInstallReferrer.installReferrer;                 // package play_install_referrer
    final raw = r.installReferrer ?? '';
    final result = await ref.read(hocoApiProvider).invitations.invitationsAttribute(
          idempotencyKey: uuidV7(),
          body: AttributionRequest(
            deviceId: ref.read(clientInfoProvider).deviceId,
            installReferrer: raw,                                        // "inv=AB12CD34&utm_medium=whatsapp"
            referrerClickedAt: r.referrerClickTimestampSeconds.toUtcDateTimeOrNull(),
            installBeganAt: r.installBeginTimestampSeconds.toUtcDateTimeOrNull(),
          ),
        );
    if (result.invitation != null) ref.read(invitationCodeProvider.notifier).set(result.invitation!.code);
  } on Exception {
    // no Play Store (sideloaded test build), referrer service unavailable, offline: retry on next launch
    return;
  }
  await prefs.setBool('attribution.done', true);
}