react-native-push-signal 0.1.8 → 0.1.9

package/PushSignal.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://antonseagull.com.git", :tag => "#{s.version}" }
+  s.source       = { :git => "https://github.com/AntonSeagull/react-native-push-signal.git", :tag => "#{s.version}" }
 
   s.source_files = "ios/**/*.{h,m,mm,cpp}"
   s.private_header_files = "ios/**/*.h"

package/README.md

@@ -108,6 +108,23 @@ Without `initialize(...)` or that file, `getCredentials()` throws.
 
 If the host app already declares its own `FirebaseMessagingService`, only one service can handle `com.google.firebase.MESSAGING_EVENT`. Prefer this library’s service or forward events into it.
 
+### When it fails on Xiaomi: `SERVICE_NOT_AVAILABLE`
+
+If `getCredentials()` throws `Failed to get an FCM token: SERVICE_NOT_AVAILABLE`, the FCM token could not be obtained. Your server never receives a token, so there is nowhere to send pushes — delivery itself is not the problem.
+
+Before requesting the token the library checks Google Play services and retries a few times with backoff, but some causes can only be fixed on the device:
+
+- **Google account.** The device must be signed into a Google account. FCM does not issue a token without one.
+- **Google Play services.** They must be installed, enabled and up to date. On a China-only ROM without GMS, FCM cannot work at all — you need another push provider.
+- **Network.** Check connectivity and disable VPN and private DNS.
+- **MIUI / HyperOS.** Enable autostart and remove battery restrictions: Settings → Apps → your app → Autostart; Battery → No restrictions. Allow background data for the app.
+
+What to look for in the logs:
+
+```sh
+adb logcat | grep -iE "SERVICE_NOT_AVAILABLE|FirebaseMessaging|PushSignal"
+```
+
 ## Incoming messages vs taps
 
 | App state | iOS | Android (notification payload) | Android (data-only) |

package/README.ru.md

@@ -108,6 +108,23 @@ apply plugin: "com.google.gms.google-services"
 
 Если в хост-приложении уже есть свой `FirebaseMessagingService`, обработать `com.google.firebase.MESSAGING_EVENT` может только один сервис. Оставьте сервис этой библиотеки или пробрасывайте события в него.
 
+### Если не работает на Xiaomi: `SERVICE_NOT_AVAILABLE`
+
+Если `getCredentials()` бросает `Failed to get an FCM token: SERVICE_NOT_AVAILABLE`, значит не удалось получить FCM-токен. Сервер не получает токен и слать пуши некуда — сама доставка здесь ни при чём.
+
+Перед запросом токена библиотека проверяет Google Play services и делает несколько попыток с паузами, но часть причин лечится только на устройстве:
+
+- **Google-аккаунт.** На устройстве должен быть выполнен вход в Google-аккаунт. Без него FCM токен не выдаёт.
+- **Google Play services.** Должны быть установлены, включены и обновлены. На китайской прошивке без GMS FCM не заработает в принципе — нужен другой провайдер пушей.
+- **Сеть.** Проверьте интернет, отключите VPN и приватный DNS.
+- **MIUI / HyperOS.** Включите автозапуск и снимите ограничения батареи: Настройки → Приложения → «ваше приложение» → Автозапуск; Батарея → Без ограничений. Разрешите приложению фоновые данные.
+
+Что смотреть в логах:
+
+```sh
+adb logcat | grep -iE "SERVICE_NOT_AVAILABLE|FirebaseMessaging|PushSignal"
+```
+
 ## Входящее сообщение и тап
 
 | Состояние | iOS | Android (notification payload) | Android (data-only) |

package/android/build.gradle

@@ -51,5 +51,6 @@ dependencies {
   implementation "com.facebook.react:react-android"
   implementation "androidx.activity:activity-ktx:1.10.1"
   implementation "androidx.core:core-ktx:1.16.0"
+  implementation "com.google.android.gms:play-services-base:18.5.0"
   implementation "com.google.firebase:firebase-messaging:24.1.2"
 }

package/android/src/main/java/com/pushsignal/PushSignalCenter.kt

@@ -11,8 +11,11 @@ import android.os.Build
 import android.os.Bundle
 import android.os.Handler
 import android.os.Looper
+import android.util.Log
 import androidx.activity.ComponentActivity
 import androidx.core.app.NotificationCompat
+import com.google.android.gms.common.ConnectionResult
+import com.google.android.gms.common.GoogleApiAvailability
 import com.google.android.gms.tasks.Tasks
 import com.google.firebase.FirebaseApp
 import com.google.firebase.FirebaseOptions
@@ -22,10 +25,16 @@ import java.util.Collections
 import java.util.UUID
 import java.util.WeakHashMap
 import java.util.concurrent.CopyOnWriteArrayList
+import java.util.concurrent.TimeUnit
 
 internal object PushSignalCenter : Application.ActivityLifecycleCallbacks {
+  private const val TAG = "PushSignal"
   private const val EXTRA_HANDLED = "pushsignal.handled"
   private const val CHANNEL_ID = "push_signal_default"
+  private const val TOKEN_TIMEOUT_SECONDS = 10L
+  private const val TOKEN_MAX_ATTEMPTS = 5
+  private const val TOKEN_INITIAL_RETRY_DELAY_MS = 1_000L
+  private const val TOKEN_MAX_RETRY_DELAY_MS = 8_000L
 
   private val lock = Any()
   private val mainHandler = Handler(Looper.getMainLooper())
@@ -100,6 +109,8 @@ internal object PushSignalCenter : Application.ActivityLifecycleCallbacks {
     val context = application
       ?: throw IllegalStateException("PushSignal is not initialized")
 
+    ensurePlayServices(context)
+
     try {
       if (FirebaseApp.getApps(context).isEmpty()) {
         FirebaseApp.initializeApp(context)
@@ -112,15 +123,7 @@ internal object PushSignalCenter : Application.ActivityLifecycleCallbacks {
       )
     }
 
-    val task = FirebaseMessaging.getInstance().token
-    val token = try {
-      Tasks.await(task)
-    } catch (error: Exception) {
-      throw IllegalStateException(
-        "Failed to get an FCM token. Call initialize({ project_id, mobilesdk_app_id, current_key, project_number }) or add google-services.json.",
-        error
-      )
-    }
+    val token = awaitTokenWithRetry()
 
     if (token.isNullOrEmpty()) {
       throw IllegalStateException("Firebase returned an empty FCM token")
@@ -129,6 +132,93 @@ internal object PushSignalCenter : Application.ActivityLifecycleCallbacks {
     return token
   }
 
+  /**
+   * Fails fast with an actionable message when Google Play services cannot serve FCM
+   * (for example a China-only ROM without GMS).
+   */
+  private fun ensurePlayServices(context: Context) {
+    val status = GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(context)
+    if (status == ConnectionResult.SUCCESS) {
+      return
+    }
+
+    val reason = when (status) {
+      ConnectionResult.SERVICE_MISSING ->
+        "Google Play services are missing on this device, so FCM cannot be used. A ROM without GMS needs another push provider."
+      ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED ->
+        "Google Play services are outdated. Update them in the Play Store and try again."
+      ConnectionResult.SERVICE_DISABLED ->
+        "Google Play services are disabled. Enable them in the device settings and try again."
+      ConnectionResult.SERVICE_INVALID ->
+        "Google Play services are invalid or corrupted on this device. Reinstalling them usually helps."
+      else ->
+        "Google Play services are unavailable (code $status)."
+    }
+    Log.w(TAG, "Play services check failed: $reason")
+    throw IllegalStateException(reason)
+  }
+
+  /**
+   * FCM returns SERVICE_NOT_AVAILABLE for transient conditions (no Google account yet,
+   * Play services still starting, flaky network). Xiaomi/MIUI devices hit this often,
+   * so retry with backoff before surfacing the failure.
+   */
+  private fun awaitTokenWithRetry(): String? {
+    var delayMs = TOKEN_INITIAL_RETRY_DELAY_MS
+    var lastError: Exception? = null
+
+    for (attempt in 1..TOKEN_MAX_ATTEMPTS) {
+      try {
+        return Tasks.await(
+          FirebaseMessaging.getInstance().token,
+          TOKEN_TIMEOUT_SECONDS,
+          TimeUnit.SECONDS
+        )
+      } catch (error: Exception) {
+        lastError = error
+        if (attempt == TOKEN_MAX_ATTEMPTS || !isRetryableTokenError(error)) {
+          break
+        }
+        Log.w(TAG, "FCM token attempt $attempt/$TOKEN_MAX_ATTEMPTS failed: ${error.message}. Retrying in ${delayMs}ms")
+        try {
+          Thread.sleep(delayMs)
+        } catch (_: InterruptedException) {
+          Thread.currentThread().interrupt()
+          break
+        }
+        delayMs = (delayMs * 2).coerceAtMost(TOKEN_MAX_RETRY_DELAY_MS)
+      }
+    }
+
+    val cause = lastError
+    throw IllegalStateException(
+      "Failed to get an FCM token: ${cause?.message ?: "unknown error"}. " +
+        "Make sure the device is signed into a Google account, Google Play services are up to date, " +
+        "and the app is allowed to use background data. " +
+        "Call initialize({ project_id, mobilesdk_app_id, current_key, project_number }) or add google-services.json.",
+      cause
+    )
+  }
+
+  private fun isRetryableTokenError(error: Throwable): Boolean {
+    var current: Throwable? = error
+    while (current != null) {
+      if (current is java.io.IOException || current is java.util.concurrent.TimeoutException) {
+        return true
+      }
+      val message = current.message?.uppercase() ?: ""
+      if (
+        message.contains("SERVICE_NOT_AVAILABLE") ||
+        message.contains("TIMEOUT") ||
+        message.contains("INTERNAL_SERVER_ERROR")
+      ) {
+        return true
+      }
+      current = current.cause
+    }
+    return false
+  }
+
   fun emitMessage(remoteMessage: RemoteMessage) {
     val message = remoteMessage.toPushMessage()
     runOnMain { deliverMessage(message) }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-push-signal",
-  "version": "0.1.8",
-  "description": "Push",
+  "version": "0.1.9",
+  "description": "React Native push notifications with direct APNs and FCM integration — get device tokens for your server and listen for incoming messages and taps",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
@@ -45,18 +45,28 @@
   "keywords": [
     "react-native",
     "ios",
-    "android"
+    "android",
+    "push",
+    "push-notifications",
+    "notifications",
+    "apns",
+    "fcm",
+    "firebase",
+    "firebase-cloud-messaging",
+    "device-token",
+    "push-token",
+    "remote-notifications"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://antonseagull.com.git"
+    "url": "git+https://github.com/AntonSeagull/react-native-push-signal.git"
   },
   "author": "AntonSeagull <hi@antonseagull.com> (https://antonseagull.com)",
   "license": "MIT",
   "bugs": {
-    "url": "https://antonseagull.com/issues"
+    "url": "https://github.com/AntonSeagull/react-native-push-signal/issues"
   },
-  "homepage": "https://antonseagull.com#readme",
+  "homepage": "https://github.com/AntonSeagull/react-native-push-signal#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },