@appsonair.ir/react-native 1.0.2 → 1.0.4

package/android/build.gradle

@@ -54,6 +54,7 @@ android {
   sourceSets {
     main {
       java.srcDirs += ["src/main/java"]
+      assets.srcDirs += [file("${projectDir}/../firebase")]
       if (isReactNative76OrNewer()) {
         java.srcDirs += ["src/reacthost76/java"]
       }
@@ -65,4 +66,5 @@ dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib"
   implementation "androidx.core:core:1.13.1"
+  implementation "com.google.firebase:firebase-messaging:24.1.1"
 }

package/android/src/main/AndroidManifest.xml

@@ -1,5 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
   <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
 
   <application>
     <activity
@@ -8,6 +9,12 @@
       android:process=":ota_restart"
       android:theme="@android:style/Theme.Translucent.NoTitleBar" />
 
+    <provider
+      android:name=".OTAFirebaseInitProvider"
+      android:authorities="${applicationId}.otaupdater.firebaseinit"
+      android:exported="false"
+      android:initOrder="99" />
+
     <provider
       android:name="androidx.core.content.FileProvider"
       android:authorities="${applicationId}.otaupdater.fileprovider"
@@ -17,5 +24,9 @@
         android:name="android.support.FILE_PROVIDER_PATHS"
         android:resource="@xml/ota_file_paths" />
     </provider>
+
+    <meta-data
+      android:name="com.google.firebase.messaging.default_notification_channel_id"
+      android:value="ota_updates" />
   </application>
 </manifest>

package/android/src/main/java/com/otaupdater/OTAFcmHelper.kt

@@ -0,0 +1,174 @@
+package com.otaupdater
+
+import android.Manifest
+import android.app.Activity
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.content.Context
+import android.content.pm.PackageManager
+import android.os.Build
+import androidx.core.app.ActivityCompat
+import androidx.core.content.ContextCompat
+import com.google.firebase.FirebaseApp
+import com.google.firebase.FirebaseOptions
+import com.google.firebase.messaging.FirebaseMessaging
+import org.json.JSONObject
+
+/**
+ * Shared Firebase project shipped inside this library. Host apps do not need
+ * their own google-services.json — drop yours into
+ * `packages/react-native/firebase/google-services.json` before publishing.
+ */
+internal object OTAFcmHelper {
+  const val APP_NAME = "ota-updater"
+  const val CHANNEL_ID = "ota_updates"
+  private const val CONFIG_ASSET = "google-services.json"
+
+  fun warmup(context: Context) {
+    ensureFirebaseApp(context.applicationContext)
+    ensureNotificationChannel(context.applicationContext)
+  }
+
+  fun requestNotificationPermission(activity: Activity?) {
+    if (activity == null || Build.VERSION.SDK_INT < 33) {
+      return
+    }
+
+    try {
+      val permission = Manifest.permission.POST_NOTIFICATIONS
+      if (ContextCompat.checkSelfPermission(activity, permission) !=
+        PackageManager.PERMISSION_GRANTED
+      ) {
+        ActivityCompat.requestPermissions(activity, arrayOf(permission), 2401)
+      }
+    } catch (_: Throwable) {
+      // Host app may omit the permission; token fetch still proceeds.
+    }
+  }
+
+  fun getToken(context: Context, callback: (String?) -> Unit) {
+    val app = ensureFirebaseApp(context.applicationContext)
+    if (app == null) {
+      callback(null)
+      return
+    }
+
+    ensureNotificationChannel(context.applicationContext)
+
+    try {
+      FirebaseMessaging.getInstance(app).token.addOnCompleteListener { task ->
+        val token =
+          if (task.isSuccessful) {
+            task.result?.takeIf { it.isNotBlank() }
+          } else {
+            null
+          }
+        callback(token)
+      }
+    } catch (_: Throwable) {
+      callback(null)
+    }
+  }
+
+  fun ensureFirebaseApp(context: Context): FirebaseApp? {
+    try {
+      return FirebaseApp.getInstance(APP_NAME)
+    } catch (_: IllegalStateException) {
+      // Not created yet.
+    }
+
+    val options = loadOptions(context) ?: return null
+    return try {
+      FirebaseApp.initializeApp(context, options, APP_NAME)
+    } catch (_: IllegalStateException) {
+      try {
+        FirebaseApp.getInstance(APP_NAME)
+      } catch (_: Throwable) {
+        null
+      }
+    } catch (_: Throwable) {
+      null
+    }
+  }
+
+  private fun loadOptions(context: Context): FirebaseOptions? {
+    return try {
+      val json =
+        context.assets.open(CONFIG_ASSET).bufferedReader().use { it.readText() }
+      parseGoogleServices(json, context.packageName)
+    } catch (_: Throwable) {
+      null
+    }
+  }
+
+  private fun parseGoogleServices(raw: String, packageName: String): FirebaseOptions? {
+    val root = JSONObject(raw)
+    val info = root.optJSONObject("project_info") ?: return null
+    val clients = root.optJSONArray("client") ?: return null
+    if (clients.length() == 0) {
+      return null
+    }
+
+    var client = clients.getJSONObject(0)
+    for (i in 0 until clients.length()) {
+      val candidate = clients.getJSONObject(i)
+      val pkg =
+        candidate
+          .optJSONObject("client_info")
+          ?.optJSONObject("android_client_info")
+          ?.optString("package_name")
+      if (pkg == packageName) {
+        client = candidate
+        break
+      }
+    }
+
+    val appId =
+      client.optJSONObject("client_info")?.optString("mobilesdk_app_id").orEmpty()
+    val apiKey =
+      client.optJSONArray("api_key")?.optJSONObject(0)?.optString("current_key").orEmpty()
+    val projectId = info.optString("project_id")
+    val senderId = info.optString("project_number")
+    val bucket = info.optString("storage_bucket")
+
+    if (!isUsable(appId) || !isUsable(apiKey) || !isUsable(projectId) || !isUsable(senderId)) {
+      return null
+    }
+
+    val builder =
+      FirebaseOptions.Builder()
+        .setApplicationId(appId)
+        .setApiKey(apiKey)
+        .setProjectId(projectId)
+        .setGcmSenderId(senderId)
+
+    if (bucket.isNotBlank()) {
+      builder.setStorageBucket(bucket)
+    }
+
+    return builder.build()
+  }
+
+  private fun isUsable(value: String?): Boolean {
+    val text = value?.trim().orEmpty()
+    return text.isNotEmpty() && text != "REPLACE_ME"
+  }
+
+  private fun ensureNotificationChannel(context: Context) {
+    if (Build.VERSION.SDK_INT < 26) {
+      return
+    }
+
+    try {
+      val manager = context.getSystemService(NotificationManager::class.java) ?: return
+      if (manager.getNotificationChannel(CHANNEL_ID) != null) {
+        return
+      }
+      manager.createNotificationChannel(
+        NotificationChannel(CHANNEL_ID, "Updates", NotificationManager.IMPORTANCE_DEFAULT),
+      )
+    } catch (_: Throwable) {
+      // Channel is only needed to display notification payloads.
+    }
+  }
+}

package/android/src/main/java/com/otaupdater/OTAFirebaseInitProvider.kt

@@ -0,0 +1,36 @@
+package com.otaupdater
+
+import android.content.ContentProvider
+import android.content.ContentValues
+import android.database.Cursor
+import android.net.Uri
+
+/** Initializes the library Firebase app before Application.onCreate. */
+class OTAFirebaseInitProvider : ContentProvider() {
+  override fun onCreate(): Boolean {
+    val ctx = context ?: return false
+    OTAFcmHelper.warmup(ctx)
+    return true
+  }
+
+  override fun query(
+    uri: Uri,
+    projection: Array<out String>?,
+    selection: String?,
+    selectionArgs: Array<out String>?,
+    sortOrder: String?,
+  ): Cursor? = null
+
+  override fun getType(uri: Uri): String? = null
+
+  override fun insert(uri: Uri, values: ContentValues?): Uri? = null
+
+  override fun delete(uri: Uri, selection: String?, selectionArgs: Array<out String>?): Int = 0
+
+  override fun update(
+    uri: Uri,
+    values: ContentValues?,
+    selection: String?,
+    selectionArgs: Array<out String>?,
+  ): Int = 0
+}

package/android/src/main/java/com/otaupdater/OTAUpdaterModule.kt

@@ -98,6 +98,14 @@ class OTAUpdaterModule(private val reactContext: ReactApplicationContext) :
     }
   }
 
+  @ReactMethod
+  fun getFcmToken(promise: Promise) {
+    OTAFcmHelper.requestNotificationPermission(reactContext.currentActivity)
+    OTAFcmHelper.getToken(reactContext) { token ->
+      promise.resolve(token)
+    }
+  }
+
   @ReactMethod
   fun installApk(path: String, promise: Promise) {
     UiThreadUtil.runOnUiThread {

package/appsonair-react-native.podspec

@@ -0,0 +1,27 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "appsonair-react-native"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = "https://appsonair.ir"
+  s.license      = "MIT"
+  s.authors      = "appsonair"
+  s.platforms    = { :ios => "13.0" }
+  s.source       = { :git => "https://github.com/appsonair/ota-updater.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+  s.resource_bundles = {
+    "OTAFirebaseConfig" => ["firebase/GoogleService-Info.plist"]
+  }
+
+  s.dependency "FirebaseMessaging"
+
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+end

package/firebase/GoogleService-Info.plist

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>API_KEY</key>
+	<string>REPLACE_ME</string>
+	<key>GCM_SENDER_ID</key>
+	<string>REPLACE_ME</string>
+	<key>GOOGLE_APP_ID</key>
+	<string>REPLACE_ME</string>
+	<key>PROJECT_ID</key>
+	<string>REPLACE_ME</string>
+	<key>STORAGE_BUCKET</key>
+	<string></string>
+	<key>BUNDLE_ID</key>
+	<string>ir.appsonair.ota</string>
+	<key>IS_ADS_ENABLED</key>
+	<false/>
+	<key>IS_ANALYTICS_ENABLED</key>
+	<false/>
+	<key>IS_APPINVITE_ENABLED</key>
+	<false/>
+	<key>IS_GCM_ENABLED</key>
+	<true/>
+	<key>IS_SIGNIN_ENABLED</key>
+	<false/>
+	<key>PLIST_VERSION</key>
+	<string>1</string>
+</dict>
+</plist>

package/firebase/google-services.json

@@ -0,0 +1,22 @@
+{
+  "project_info": {
+    "project_number": "REPLACE_ME",
+    "project_id": "REPLACE_ME",
+    "storage_bucket": ""
+  },
+  "client": [
+    {
+      "client_info": {
+        "mobilesdk_app_id": "REPLACE_ME",
+        "android_client_info": {
+          "package_name": "ir.appsonair.ota"
+        }
+      },
+      "api_key": [
+        {
+          "current_key": "REPLACE_ME"
+        }
+      ]
+    }
+  ]
+}

package/ios/OTAUpdaterNative.m

@@ -2,6 +2,8 @@
 #import <React/RCTLog.h>
 #import <React/RCTReloadCommand.h>
 #import <UIKit/UIKit.h>
+#import <UserNotifications/UserNotifications.h>
+#import <objc/message.h>
 
 static NSString *const kBundlePathKey = @"ota_updater_bundle_path";
 static NSString *const kNativeVersionKey = @"ota_updater_native_version";
@@ -107,4 +109,151 @@ RCT_EXPORT_METHOD(getBundlePath:(RCTPromiseResolveBlock)resolve
   resolve([OTAUpdaterNative otaBundlePath] ?: [NSNull null]);
 }
 
+RCT_EXPORT_METHOD(getFcmToken:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+  dispatch_async(dispatch_get_main_queue(), ^{
+    [OTAUpdaterNative ensureFirebaseConfigured];
+    [OTAUpdaterNative requestPushAuthorizationThen:^{
+      [OTAUpdaterNative fetchFirebaseToken:resolve];
+    }];
+  });
+}
+
++ (NSString *)embeddedGoogleServicePlistPath {
+  NSBundle *classBundle = [NSBundle bundleForClass:[OTAUpdaterNative class]];
+  NSString *direct = [classBundle pathForResource:@"GoogleService-Info" ofType:@"plist"];
+  if (direct.length > 0) {
+    return direct;
+  }
+
+  NSURL *bundleURL = [classBundle URLForResource:@"OTAFirebaseConfig" withExtension:@"bundle"];
+  if (bundleURL != nil) {
+    NSBundle *res = [NSBundle bundleWithURL:bundleURL];
+    NSString *nested = [res pathForResource:@"GoogleService-Info" ofType:@"plist"];
+    if (nested.length > 0) {
+      return nested;
+    }
+  }
+
+  NSArray<NSBundle *> *bundles = [NSBundle allBundles];
+  for (NSBundle *bundle in bundles) {
+    NSString *path = [bundle pathForResource:@"GoogleService-Info" ofType:@"plist"];
+    if (path.length == 0) {
+      continue;
+    }
+    NSString *appId = [[NSDictionary dictionaryWithContentsOfFile:path] objectForKey:@"GOOGLE_APP_ID"];
+    if ([OTAUpdaterNative isUsableFirebaseValue:appId]) {
+      return path;
+    }
+  }
+
+  return [[NSBundle mainBundle] pathForResource:@"GoogleService-Info" ofType:@"plist"];
+}
+
++ (BOOL)isUsableFirebaseValue:(NSString *)value {
+  NSString *trimmed = [value stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+  return trimmed.length > 0 && ![trimmed isEqualToString:@"REPLACE_ME"];
+}
+
++ (void)ensureFirebaseConfigured {
+  Class firApp = NSClassFromString(@"FIRApp");
+  Class firOptions = NSClassFromString(@"FIROptions");
+  if (firApp == nil || firOptions == nil) {
+    return;
+  }
+
+  SEL defaultAppSel = NSSelectorFromString(@"defaultApp");
+  if ([firApp respondsToSelector:defaultAppSel]) {
+    id existing = ((id (*)(id, SEL))objc_msgSend)(firApp, defaultAppSel);
+    if (existing != nil) {
+      return;
+    }
+  }
+
+  NSString *plistPath = [OTAUpdaterNative embeddedGoogleServicePlistPath];
+  if (plistPath.length == 0) {
+    return;
+  }
+
+  NSDictionary *plist = [NSDictionary dictionaryWithContentsOfFile:plistPath];
+  if (![OTAUpdaterNative isUsableFirebaseValue:plist[@"GOOGLE_APP_ID"]] ||
+      ![OTAUpdaterNative isUsableFirebaseValue:plist[@"API_KEY"]] ||
+      ![OTAUpdaterNative isUsableFirebaseValue:plist[@"GCM_SENDER_ID"]] ||
+      ![OTAUpdaterNative isUsableFirebaseValue:plist[@"PROJECT_ID"]]) {
+    return;
+  }
+
+  SEL initFileSel = NSSelectorFromString(@"initWithContentsOfFile:");
+  if (![firOptions instancesRespondToSelector:initFileSel]) {
+    return;
+  }
+
+  id allocated = ((id (*)(id, SEL))objc_msgSend)(firOptions, NSSelectorFromString(@"alloc"));
+  id options = ((id (*)(id, SEL, NSString *))objc_msgSend)(allocated, initFileSel, plistPath);
+  if (options == nil) {
+    return;
+  }
+
+  // Prefer the host app's bundle id so APNs maps to the installed app.
+  NSString *hostBundleId = [[NSBundle mainBundle] bundleIdentifier];
+  if (hostBundleId.length > 0) {
+    SEL setBundleId = NSSelectorFromString(@"setBundleID:");
+    if ([options respondsToSelector:setBundleId]) {
+      ((void (*)(id, SEL, NSString *))objc_msgSend)(options, setBundleId, hostBundleId);
+    }
+  }
+
+  SEL configureWithOptions = NSSelectorFromString(@"configureWithOptions:");
+  if ([firApp respondsToSelector:configureWithOptions]) {
+    ((void (*)(id, SEL, id))objc_msgSend)(firApp, configureWithOptions, options);
+  }
+}
+
++ (void)requestPushAuthorizationThen:(void (^)(void))done {
+  UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
+  UNAuthorizationOptions options =
+    UNAuthorizationOptionAlert | UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
+  [center requestAuthorizationWithOptions:options
+                        completionHandler:^(BOOL granted, NSError *error) {
+    dispatch_async(dispatch_get_main_queue(), ^{
+      [[UIApplication sharedApplication] registerForRemoteNotifications];
+      if (done) {
+        done();
+      }
+    });
+  }];
+}
+
++ (void)fetchFirebaseToken:(RCTPromiseResolveBlock)resolve {
+  Class messagingCls = NSClassFromString(@"FIRMessaging");
+  if (messagingCls == nil) {
+    resolve([NSNull null]);
+    return;
+  }
+
+  SEL messagingSel = NSSelectorFromString(@"messaging");
+  if (![messagingCls respondsToSelector:messagingSel]) {
+    resolve([NSNull null]);
+    return;
+  }
+
+  id messaging = ((id (*)(id, SEL))objc_msgSend)(messagingCls, messagingSel);
+  SEL tokenSel = NSSelectorFromString(@"tokenWithCompletion:");
+  if (messaging == nil || ![messaging respondsToSelector:tokenSel]) {
+    resolve([NSNull null]);
+    return;
+  }
+
+  void (^completion)(NSString *, NSError *) = ^(NSString *token, NSError *error) {
+    if (token.length > 0) {
+      resolve(token);
+    } else {
+      resolve([NSNull null]);
+    }
+  };
+
+  ((void (*)(id, SEL, void (^)(NSString *, NSError *)))objc_msgSend)(messaging, tokenSel, completion);
+}
+
 @end

package/lib/deviceProfile.d.ts

@@ -0,0 +1,11 @@
+export interface DeviceProfilePayload {
+    platform: string;
+    brand?: string;
+    manufacturer?: string;
+    model?: string;
+    osVersion?: string;
+    osApiLevel?: string;
+    userAgent?: string;
+    deviceAbi?: string;
+}
+export declare function getDeviceProfile(): Promise<DeviceProfilePayload>;

package/lib/deviceProfile.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeviceProfile = getDeviceProfile;
+const react_native_1 = require("react-native");
+const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
+async function safeString(loader) {
+    try {
+        const value = await loader();
+        if (value == null) {
+            return undefined;
+        }
+        const text = String(value).trim();
+        return text || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function getDeviceProfile() {
+    const brand = react_native_device_info_1.default.getBrand?.() || undefined;
+    const model = react_native_device_info_1.default.getModel?.() || undefined;
+    const osVersion = react_native_device_info_1.default.getSystemVersion?.() || undefined;
+    const platform = react_native_1.Platform.OS;
+    const [manufacturer, userAgentFromDevice, osApiLevel, deviceAbi] = await Promise.all([
+        safeString(() => react_native_device_info_1.default.getManufacturer()),
+        safeString(() => react_native_device_info_1.default.getUserAgent()),
+        platform === 'android'
+            ? safeString(() => react_native_device_info_1.default.getApiLevel())
+            : Promise.resolve(undefined),
+        platform === 'android'
+            ? safeString(async () => {
+                const native = react_native_1.NativeModules.OTAUpdaterNative;
+                if (!native?.getDeviceAbi) {
+                    return undefined;
+                }
+                return native.getDeviceAbi();
+            })
+            : Promise.resolve(undefined),
+    ]);
+    const identity = [brand, model].filter(Boolean).join(' ');
+    const userAgent = userAgentFromDevice ||
+        `OTAUpdater/${react_native_device_info_1.default.getVersion()} (${platform} ${osVersion ?? '?'}; ${identity || 'unknown'}${manufacturer ? `; ${manufacturer}` : ''})`;
+    return {
+        platform,
+        brand,
+        manufacturer,
+        model,
+        osVersion,
+        osApiLevel,
+        userAgent,
+        deviceAbi,
+    };
+}

package/lib/events.d.ts

@@ -0,0 +1,10 @@
+import type { AnalyticsEventParams } from './types';
+export type { AnalyticsEventParams };
+/**
+ * Log a custom analytics event from anywhere in the app.
+ *
+ * @example
+ * import { logEvent } from '@appsonair.ir/react-native';
+ * logEvent('checkout_started', { cartValue: 12 });
+ */
+export declare function logEvent(name: string, params?: AnalyticsEventParams): Promise<void>;

package/lib/events.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logEvent = logEvent;
+const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
+const config_1 = require("./config");
+const sync_1 = require("./sync");
+const MAX_NAME_LENGTH = 128;
+const MAX_PARAM_KEYS = 20;
+const MAX_PARAM_VALUE_LENGTH = 256;
+function sanitizeParams(params) {
+    if (!params || typeof params !== 'object' || Array.isArray(params)) {
+        return undefined;
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (Object.keys(out).length >= MAX_PARAM_KEYS) {
+            break;
+        }
+        const name = key.trim().slice(0, 64);
+        if (!name) {
+            continue;
+        }
+        if (typeof value === 'number') {
+            if (!Number.isFinite(value)) {
+                continue;
+            }
+            out[name] = value;
+            continue;
+        }
+        if (typeof value === 'boolean') {
+            out[name] = value;
+            continue;
+        }
+        if (typeof value === 'string') {
+            out[name] = value.slice(0, MAX_PARAM_VALUE_LENGTH);
+        }
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * Log a custom analytics event from anywhere in the app.
+ *
+ * @example
+ * import { logEvent } from '@appsonair.ir/react-native';
+ * logEvent('checkout_started', { cartValue: 12 });
+ */
+async function logEvent(name, params) {
+    const config = (0, config_1.getConfig)();
+    if (!config) {
+        return;
+    }
+    const eventName = String(name ?? '')
+        .trim()
+        .slice(0, MAX_NAME_LENGTH);
+    if (!eventName) {
+        return;
+    }
+    try {
+        const clientUniqueId = await (0, sync_1.getClientUniqueId)();
+        await fetch(`${(0, config_1.getServerUrl)(config)}/api/devices/event`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Deployment-Key': config.deploymentKey,
+            },
+            body: JSON.stringify({
+                name: eventName,
+                params: sanitizeParams(params),
+                clientUniqueId,
+                appVersion: react_native_device_info_1.default.getVersion(),
+            }),
+        });
+    }
+    catch {
+        // Analytics must never break the host app.
+    }
+}

package/lib/index.d.ts

@@ -1,6 +1,8 @@
 import { configure, getConfig } from './config';
 import { configureFromProject, getDeploymentKey, isOtaConfigured, resolveUpdaterConfig } from './projectConfig';
 import { sync, restartApp, installApk, resumePendingApkInstall, clearUpdate, getInstalledBundlePath, notifyAppReady } from './sync';
+import { logEvent } from './events';
+import { ping, startTelemetry, stopTelemetry } from './telemetry';
 import { UpdateCheckResult } from './types';
 export { configure, getConfig, getServerUrl } from './config';
 export { DEFAULT_SERVER_URL } from './constants';
@@ -9,6 +11,8 @@ export type { ProjectOtaConfig } from './types';
 export declare function getCurrentLabel(): Promise<string | null>;
 export declare function checkUpdate(): Promise<UpdateCheckResult>;
 export { sync, restartApp, installApk, resumePendingApkInstall, clearUpdate, getInstalledBundlePath, notifyAppReady, isSyncInProgress, respondToUpdatePrompt, } from './sync';
+export { ping, startTelemetry, stopTelemetry } from './telemetry';
+export { logEvent } from './events';
 export { OTAUpdateModal } from './ui/OTAUpdateModal';
 export { OTAUpdateProvider } from './ui/OTAUpdateProvider';
 export declare const OTAUpdater: {
@@ -23,5 +27,9 @@ export declare const OTAUpdater: {
     clearUpdate: typeof clearUpdate;
     getInstalledBundlePath: typeof getInstalledBundlePath;
     notifyAppReady: typeof notifyAppReady;
+    ping: typeof ping;
+    startTelemetry: typeof startTelemetry;
+    stopTelemetry: typeof stopTelemetry;
+    logEvent: typeof logEvent;
 };
 export * from './types';

package/lib/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OTAUpdater = exports.OTAUpdateProvider = exports.OTAUpdateModal = exports.respondToUpdatePrompt = exports.isSyncInProgress = exports.notifyAppReady = exports.getInstalledBundlePath = exports.clearUpdate = exports.resumePendingApkInstall = exports.installApk = exports.restartApp = exports.sync = exports.resolveUpdaterConfig = exports.isOtaConfigured = exports.getDeploymentKey = exports.configureFromProject = exports.DEFAULT_SERVER_URL = exports.getServerUrl = exports.getConfig = exports.configure = void 0;
+exports.OTAUpdater = exports.OTAUpdateProvider = exports.OTAUpdateModal = exports.logEvent = exports.stopTelemetry = exports.startTelemetry = exports.ping = exports.respondToUpdatePrompt = exports.isSyncInProgress = exports.notifyAppReady = exports.getInstalledBundlePath = exports.clearUpdate = exports.resumePendingApkInstall = exports.installApk = exports.restartApp = exports.sync = exports.resolveUpdaterConfig = exports.isOtaConfigured = exports.getDeploymentKey = exports.configureFromProject = exports.DEFAULT_SERVER_URL = exports.getServerUrl = exports.getConfig = exports.configure = void 0;
 exports.getCurrentLabel = getCurrentLabel;
 exports.checkUpdate = checkUpdate;
 const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
@@ -29,6 +29,8 @@ Object.defineProperty(exports, "getDeploymentKey", { enumerable: true, get: func
 Object.defineProperty(exports, "isOtaConfigured", { enumerable: true, get: function () { return projectConfig_1.isOtaConfigured; } });
 Object.defineProperty(exports, "resolveUpdaterConfig", { enumerable: true, get: function () { return projectConfig_1.resolveUpdaterConfig; } });
 const sync_1 = require("./sync");
+const events_1 = require("./events");
+const telemetry_1 = require("./telemetry");
 var config_2 = require("./config");
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return config_2.configure; } });
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_2.getConfig; } });
@@ -60,6 +62,12 @@ Object.defineProperty(exports, "getInstalledBundlePath", { enumerable: true, get
 Object.defineProperty(exports, "notifyAppReady", { enumerable: true, get: function () { return sync_2.notifyAppReady; } });
 Object.defineProperty(exports, "isSyncInProgress", { enumerable: true, get: function () { return sync_2.isSyncInProgress; } });
 Object.defineProperty(exports, "respondToUpdatePrompt", { enumerable: true, get: function () { return sync_2.respondToUpdatePrompt; } });
+var telemetry_2 = require("./telemetry");
+Object.defineProperty(exports, "ping", { enumerable: true, get: function () { return telemetry_2.ping; } });
+Object.defineProperty(exports, "startTelemetry", { enumerable: true, get: function () { return telemetry_2.startTelemetry; } });
+Object.defineProperty(exports, "stopTelemetry", { enumerable: true, get: function () { return telemetry_2.stopTelemetry; } });
+var events_2 = require("./events");
+Object.defineProperty(exports, "logEvent", { enumerable: true, get: function () { return events_2.logEvent; } });
 var OTAUpdateModal_1 = require("./ui/OTAUpdateModal");
 Object.defineProperty(exports, "OTAUpdateModal", { enumerable: true, get: function () { return OTAUpdateModal_1.OTAUpdateModal; } });
 var OTAUpdateProvider_1 = require("./ui/OTAUpdateProvider");
@@ -76,5 +84,9 @@ exports.OTAUpdater = {
     clearUpdate: sync_1.clearUpdate,
     getInstalledBundlePath: sync_1.getInstalledBundlePath,
     notifyAppReady: sync_1.notifyAppReady,
+    ping: telemetry_1.ping,
+    startTelemetry: telemetry_1.startTelemetry,
+    stopTelemetry: telemetry_1.stopTelemetry,
+    logEvent: events_1.logEvent,
 };
 __exportStar(require("./types"), exports);

package/lib/sync.d.ts

@@ -25,6 +25,7 @@ export declare const defaultMessages: {
     installing: string;
     restarting: string;
     error: string;
+    downloadInterrupted: string;
     upToDate: string;
     updateAvailable: string;
     changelogTitle: string;
@@ -47,6 +48,8 @@ export declare function clearStoredBundleMeta(): Promise<void>;
 export declare function markRestartPending(): Promise<void>;
 export declare function shouldSkipSyncAfterRestart(): Promise<boolean>;
 export declare function getDeviceAbi(): Promise<string | undefined>;
+/** FCM token from the library Firebase project (shared config, native). */
+export declare function getFcmToken(): Promise<string | undefined>;
 export declare function checkForUpdate(serverUrl: string, deploymentKey: string, appVersion: string, label?: string, packageHash?: string, clientUniqueId?: string, buildNumber?: string, deviceAbi?: string): Promise<UpdateCheckResult>;
 export declare function getBundleReleaseDir(label: string): string;
 export declare function getBundleFilePath(label: string): string;

package/lib/sync.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -18,6 +51,7 @@ exports.clearStoredBundleMeta = clearStoredBundleMeta;
 exports.markRestartPending = markRestartPending;
 exports.shouldSkipSyncAfterRestart = shouldSkipSyncAfterRestart;
 exports.getDeviceAbi = getDeviceAbi;
+exports.getFcmToken = getFcmToken;
 exports.checkForUpdate = checkForUpdate;
 exports.getBundleReleaseDir = getBundleReleaseDir;
 exports.getBundleFilePath = getBundleFilePath;
@@ -37,6 +71,7 @@ const react_native_1 = require("react-native");
 const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
 const config_1 = require("./config");
 const zipExtract_1 = require("./zipExtract");
+const deviceProfile_1 = require("./deviceProfile");
 const types_1 = require("./types");
 const initialProgressState = {
     visible: false,
@@ -75,6 +110,7 @@ exports.defaultMessages = {
     installing: 'در حال نصب به\u200cروزرسانی...',
     restarting: 'در حال راه\u200cاندازی مجدد...',
     error: 'خطا در به\u200cروزرسانی',
+    downloadInterrupted: 'دانلود قطع شد. لطفاً دوباره تلاش کنید',
     upToDate: 'برنامه به\u200cروز است',
     updateAvailable: 'نسخه جدیدی در دسترس است',
     changelogTitle: 'تغییرات این نسخه',
@@ -254,8 +290,25 @@ async function getDeviceAbi() {
     }
     return undefined;
 }
+/** FCM token from the library Firebase project (shared config, native). */
+async function getFcmToken() {
+    if (!OTAUpdaterNative?.getFcmToken) {
+        return undefined;
+    }
+    try {
+        const token = await OTAUpdaterNative.getFcmToken();
+        return typeof token === 'string' && token.trim() ? token.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 async function checkForUpdate(serverUrl, deploymentKey, appVersion, label, packageHash, clientUniqueId, buildNumber, deviceAbi) {
     const baseUrl = serverUrl.replace(/\/$/, '');
+    const [profile, fcmToken] = await Promise.all([
+        (0, deviceProfile_1.getDeviceProfile)(),
+        getFcmToken(),
+    ]);
     const response = await fetch(`${baseUrl}/api/update-check`, {
         method: 'POST',
         headers: {
@@ -268,7 +321,9 @@ async function checkForUpdate(serverUrl, deploymentKey, appVersion, label, packa
             packageHash,
             clientUniqueId,
             buildNumber,
-            deviceAbi,
+            ...profile,
+            deviceAbi: deviceAbi ?? profile.deviceAbi,
+            fcmToken,
         }),
     });
     if (!response.ok) {
@@ -413,6 +468,31 @@ async function ensureBundleDirectory() {
         await ReactNativeBlobUtil.fs.mkdir(dir);
     }
 }
+/** Keep only the active OTA package so leftover extracts don't fill disk / slow IO. */
+async function cleanupOldUpdates(keepLabel) {
+    try {
+        const ReactNativeBlobUtil = require('react-native-blob-util').default;
+        const dir = getBundleDirectory();
+        const exists = await ReactNativeBlobUtil.fs.exists(dir);
+        if (!exists)
+            return;
+        const keep = new Set([
+            keepLabel,
+            `${keepLabel}.zip`,
+            `${keepLabel}.bundle`,
+        ]);
+        const entries = await ReactNativeBlobUtil.fs.ls(dir);
+        await Promise.all(entries.map(async (entry) => {
+            if (keep.has(entry) || entry.endsWith('.apk')) {
+                return;
+            }
+            await removePathRecursive(`${dir}/${entry}`);
+        }));
+    }
+    catch {
+        // Best-effort cleanup; a leftover folder must not fail install.
+    }
+}
 async function resolveDownloadSize(downloadUrl, deploymentKey, expectedSize, deviceAbi) {
     if (expectedSize && expectedSize > 0) {
         return expectedSize;
@@ -449,6 +529,80 @@ async function resolveDownloadSize(downloadUrl, deploymentKey, expectedSize, dev
     }
     return expectedSize ?? 0;
 }
+const DOWNLOAD_MAX_ATTEMPTS = 3;
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return String(error);
+}
+function isRetryableDownloadError(error) {
+    const message = getErrorMessage(error).toLowerCase();
+    return (message.includes('download interrupted') ||
+        message.includes('network') ||
+        message.includes('timeout') ||
+        message.includes('timed out') ||
+        message.includes('connection') ||
+        message.includes('socket') ||
+        message.includes('econnreset') ||
+        message.includes('failed to connect') ||
+        message.includes('software caused connection abort'));
+}
+function toUserFacingDownloadError(error) {
+    if (isRetryableDownloadError(error)) {
+        return new Error(exports.defaultMessages.downloadInterrupted);
+    }
+    return error instanceof Error ? error : new Error(getErrorMessage(error));
+}
+async function cleanupPartialDownload(path) {
+    try {
+        const ReactNativeBlobUtil = require('react-native-blob-util').default;
+        const exists = await ReactNativeBlobUtil.fs.exists(path);
+        if (exists) {
+            await ReactNativeBlobUtil.fs.unlink(path);
+        }
+    }
+    catch {
+        // Ignore cleanup errors.
+    }
+}
+/**
+ * react-native-blob-util rejects with "Download interrupted." whenever
+ * bytesWritten !== Content-Length — including when Content-Length is wrong
+ * but the full file actually landed. Recover those cases via size/hash checks.
+ */
+async function tryRecoverCompletedDownload(destPath, extension, totalBytes, expectedHash, packageFormat, label) {
+    try {
+        const ReactNativeBlobUtil = require('react-native-blob-util').default;
+        const exists = await ReactNativeBlobUtil.fs.exists(destPath);
+        if (!exists)
+            return null;
+        const stat = await ReactNativeBlobUtil.fs.stat(destPath);
+        const minSize = extension === 'apk' ? 1024 * 100 : 1024;
+        if (!stat || stat.size < minSize)
+            return null;
+        const sizeLooksComplete = totalBytes <= 0 || Math.abs(stat.size - totalBytes) <= 1;
+        if (expectedHash) {
+            const valid = await verifyBundleHash(destPath, expectedHash);
+            if (!valid)
+                return null;
+        }
+        else if (!sizeLooksComplete) {
+            return null;
+        }
+        if (extension === 'bundle' && (await shouldExtractZipPackage(destPath, packageFormat))) {
+            return extractBundleUpdate(label, destPath);
+        }
+        return destPath;
+    }
+    catch {
+        return null;
+    }
+}
 async function downloadBundle(downloadUrl, deploymentKey, label, expectedSize, onProgress, extension = 'bundle', deviceAbi, packageFormat = 'bundle', expectedHash) {
     const ReactNativeBlobUtil = require('react-native-blob-util').default;
     const isZipBundle = extension === 'bundle' && packageFormat === 'zip';
@@ -462,76 +616,95 @@ async function downloadBundle(downloadUrl, deploymentKey, label, expectedSize, o
     if (isZipBundle) {
         await removePathRecursive(getBundleReleaseDir(label));
     }
-    const destExists = await ReactNativeBlobUtil.fs.exists(destPath);
-    if (destExists) {
-        await ReactNativeBlobUtil.fs.unlink(destPath);
-    }
-    const task = ReactNativeBlobUtil.config({
-        path: destPath,
-        fileCache: false,
-        overwrite: true,
-    }).fetch('GET', downloadUrl, {
-        'X-Deployment-Key': deploymentKey,
-        ...(deviceAbi ? { 'X-Device-Abi': deviceAbi } : {}),
-    });
-    const reportDownloadProgress = (received, total) => {
-        if (!onProgress)
-            return;
-        const resolvedTotal = total > 0 ? total : totalBytes;
-        if (resolvedTotal <= 0)
-            return;
-        onProgress(Math.min(Math.max(received / resolvedTotal, 0), 0.99));
-    };
-    let pollTimer = null;
-    if (onProgress && totalBytes > 0) {
-        pollTimer = setInterval(async () => {
-            try {
-                const exists = await ReactNativeBlobUtil.fs.exists(destPath);
-                if (!exists)
-                    return;
-                const stat = await ReactNativeBlobUtil.fs.stat(destPath);
-                reportDownloadProgress(stat.size, totalBytes);
-            }
-            catch {
-                // Ignore polling errors while the file is being written.
-            }
-        }, 150);
-    }
-    if (onProgress) {
-        task.progress({ interval: 100, count: 10 }, (received, total) => {
-            reportDownloadProgress(received, total);
+    let lastError;
+    for (let attempt = 1; attempt <= DOWNLOAD_MAX_ATTEMPTS; attempt++) {
+        await cleanupPartialDownload(destPath);
+        const task = ReactNativeBlobUtil.config({
+            path: destPath,
+            fileCache: false,
+            overwrite: true,
+            timeout: 10 * 60 * 1000,
+        }).fetch('GET', downloadUrl, {
+            'X-Deployment-Key': deploymentKey,
+            ...(deviceAbi ? { 'X-Device-Abi': deviceAbi } : {}),
         });
-    }
-    try {
-        const response = await task;
-        if (onProgress) {
-            onProgress(1);
-        }
-        const downloadedPath = String(response.path()).replace(/^file:\/\//, '');
-        if (downloadedPath !== destPath) {
-            await ReactNativeBlobUtil.fs.cp(downloadedPath, destPath);
+        const reportDownloadProgress = (received, total) => {
+            if (!onProgress)
+                return;
+            const resolvedTotal = total > 0 ? total : totalBytes;
+            if (resolvedTotal <= 0)
+                return;
+            onProgress(Math.min(Math.max(received / resolvedTotal, 0), 0.99));
+        };
+        let pollTimer = null;
+        if (onProgress && totalBytes > 0) {
+            pollTimer = setInterval(async () => {
+                try {
+                    const exists = await ReactNativeBlobUtil.fs.exists(destPath);
+                    if (!exists)
+                        return;
+                    const stat = await ReactNativeBlobUtil.fs.stat(destPath);
+                    reportDownloadProgress(stat.size, totalBytes);
+                }
+                catch {
+                    // Ignore polling errors while the file is being written.
+                }
+            }, 150);
         }
-        const stat = await ReactNativeBlobUtil.fs.stat(destPath);
-        const minSize = extension === 'apk' ? 1024 * 100 : 1024;
-        if (!stat || stat.size < minSize) {
-            throw new Error(`Downloaded file is too small (${stat?.size ?? 0} bytes)`);
+        if (onProgress) {
+            task.progress({ interval: 100, count: 10 }, (received, total) => {
+                reportDownloadProgress(received, total);
+            });
         }
-        if (expectedHash) {
-            const valid = await verifyBundleHash(destPath, expectedHash);
-            if (!valid) {
-                throw new Error('Package hash verification failed');
+        try {
+            const response = await task;
+            if (onProgress) {
+                onProgress(1);
+            }
+            const downloadedPath = String(response.path()).replace(/^file:\/\//, '');
+            if (downloadedPath !== destPath) {
+                await ReactNativeBlobUtil.fs.cp(downloadedPath, destPath);
             }
+            const stat = await ReactNativeBlobUtil.fs.stat(destPath);
+            const minSize = extension === 'apk' ? 1024 * 100 : 1024;
+            if (!stat || stat.size < minSize) {
+                throw new Error(`Downloaded file is too small (${stat?.size ?? 0} bytes)`);
+            }
+            if (expectedHash) {
+                const valid = await verifyBundleHash(destPath, expectedHash);
+                if (!valid) {
+                    throw new Error('Package hash verification failed');
+                }
+            }
+            if (extension === 'bundle' && (await shouldExtractZipPackage(destPath, packageFormat))) {
+                return extractBundleUpdate(label, destPath);
+            }
+            return destPath;
         }
-        if (extension === 'bundle' && (await shouldExtractZipPackage(destPath, packageFormat))) {
-            return extractBundleUpdate(label, destPath);
+        catch (error) {
+            lastError = error;
+            if (isRetryableDownloadError(error)) {
+                const recovered = await tryRecoverCompletedDownload(destPath, extension, totalBytes, expectedHash, packageFormat, label);
+                if (recovered) {
+                    if (onProgress)
+                        onProgress(1);
+                    return recovered;
+                }
+            }
+            await cleanupPartialDownload(destPath);
+            if (attempt < DOWNLOAD_MAX_ATTEMPTS && isRetryableDownloadError(error)) {
+                await delay(attempt * 750);
+                continue;
+            }
+            throw toUserFacingDownloadError(error);
         }
-        return destPath;
-    }
-    finally {
-        if (pollTimer) {
-            clearInterval(pollTimer);
+        finally {
+            if (pollTimer) {
+                clearInterval(pollTimer);
+            }
         }
     }
+    throw toUserFacingDownloadError(lastError);
 }
 async function verifyBundleHash(filePath, expectedHash) {
     const ReactNativeBlobUtil = require('react-native-blob-util').default;
@@ -725,6 +898,9 @@ async function performSync(options = {}, onProgress, messages) {
             packageHash: update.packageHash,
             installedAt: new Date().toISOString(),
         });
+        void Promise.resolve().then(() => __importStar(require('./telemetry'))).then((mod) => mod.ping())
+            .catch(() => { });
+        await cleanupOldUpdates(update.label);
         const shouldRestartNow = installMode === 'immediate' || update.isMandatory === true;
         if (shouldRestartNow) {
             reportProgress(showUI, messages, onProgress, types_1.SyncStatus.RESTARTING, 1, {
@@ -793,12 +969,8 @@ async function performApkSync(update, showUI, messages, onProgress, changelog) {
             label: update.label,
             description: notes,
             isMandatory: update.isMandatory,
-        }), 'apk', update.deviceAbi);
+        }), 'apk', update.deviceAbi, 'bundle', update.packageHash);
         onProgress?.(types_1.SyncStatus.INSTALLING, 1);
-        const valid = await verifyBundleHash(apkPath, update.packageHash);
-        if (!valid) {
-            throw new Error('APK hash verification failed');
-        }
         // Drop the OTA JS path before opening the installer so the new APK does not
         // keep loading the previous bundle on first launch after install.
         await clearUpdate();
@@ -855,10 +1027,16 @@ async function getInstalledBundlePath() {
     return null;
 }
 async function clearUpdate() {
+    const meta = await getStoredBundleMeta();
     await clearStoredBundleMeta();
     if (OTAUpdaterNative?.clearBundlePath) {
         await OTAUpdaterNative.clearBundlePath();
     }
+    if (meta?.label) {
+        await removePathRecursive(getBundleReleaseDir(meta.label));
+        await cleanupPartialDownload(getBundleZipPath(meta.label));
+        await cleanupPartialDownload(getLegacyBundleFilePath(meta.label));
+    }
 }
 async function notifyAppReady() {
     const meta = await getStoredBundleMeta();

package/lib/telemetry.d.ts

@@ -0,0 +1,6 @@
+export interface TelemetryPingOptions {
+    sessionStart?: boolean;
+}
+export declare function ping(options?: TelemetryPingOptions): Promise<void>;
+export declare function startTelemetry(): () => void;
+export declare function stopTelemetry(): void;

package/lib/telemetry.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ping = ping;
+exports.startTelemetry = startTelemetry;
+exports.stopTelemetry = stopTelemetry;
+const react_native_1 = require("react-native");
+const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
+const config_1 = require("./config");
+const deviceProfile_1 = require("./deviceProfile");
+const sync_1 = require("./sync");
+const PING_INTERVAL_MS = 60000;
+let started = false;
+let pingTimer = null;
+let appStateSub = null;
+let pingInFlight = null;
+async function buildPingBody(sessionStart) {
+    const config = (0, config_1.getConfig)();
+    if (!config) {
+        return null;
+    }
+    const [clientUniqueId, meta, profile, fcmToken] = await Promise.all([
+        (0, sync_1.getClientUniqueId)(),
+        (0, sync_1.getStoredBundleMeta)(),
+        (0, deviceProfile_1.getDeviceProfile)(),
+        (0, sync_1.getFcmToken)(),
+    ]);
+    return {
+        clientUniqueId,
+        appVersion: react_native_device_info_1.default.getVersion(),
+        buildNumber: react_native_device_info_1.default.getBuildNumber(),
+        ...profile,
+        label: meta?.label,
+        packageHash: meta?.packageHash,
+        fcmToken,
+        sessionStart,
+    };
+}
+async function ping(options = {}) {
+    const config = (0, config_1.getConfig)();
+    if (!config) {
+        return;
+    }
+    if (pingInFlight) {
+        return pingInFlight;
+    }
+    pingInFlight = (async () => {
+        try {
+            const body = await buildPingBody(options.sessionStart === true);
+            if (!body) {
+                return;
+            }
+            const baseUrl = (0, config_1.getServerUrl)(config);
+            await fetch(`${baseUrl}/api/devices/ping`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Deployment-Key': config.deploymentKey,
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch {
+            // Telemetry must never break update sync.
+        }
+    })().finally(() => {
+        pingInFlight = null;
+    });
+    return pingInFlight;
+}
+function startTelemetry() {
+    if (started) {
+        return stopTelemetry;
+    }
+    started = true;
+    void ping({ sessionStart: true });
+    pingTimer = setInterval(() => {
+        void ping();
+    }, PING_INTERVAL_MS);
+    appStateSub = react_native_1.AppState.addEventListener('change', (nextState) => {
+        if (nextState === 'active') {
+            void ping();
+        }
+    });
+    return stopTelemetry;
+}
+function stopTelemetry() {
+    started = false;
+    if (pingTimer) {
+        clearInterval(pingTimer);
+        pingTimer = null;
+    }
+    appStateSub?.remove();
+    appStateSub = null;
+}

package/lib/types.d.ts

@@ -117,3 +117,5 @@ export interface StoredBundleMeta {
     packageHash: string;
     installedAt: string;
 }
+/** Primitive values allowed on custom analytics events. */
+export type AnalyticsEventParams = Record<string, string | number | boolean>;

package/lib/ui/OTAUpdateProvider.js

@@ -39,6 +39,7 @@ const react_native_1 = require("react-native");
 const projectConfig_1 = require("../projectConfig");
 const progress_1 = require("../progress");
 const sync_1 = require("../sync");
+const telemetry_1 = require("../telemetry");
 const OTAUpdateModal_1 = require("./OTAUpdateModal");
 const SYNC_DELAY_MS = 2500;
 const FOREGROUND_SYNC_DEBOUNCE_MS = 30000;
@@ -54,6 +55,11 @@ function OTAUpdateProvider({ children, projectConfig, autoSync = true, skipInDev
         }
     }, [projectConfig]);
     (0, react_1.useEffect)(() => (0, progress_1.subscribeProgress)(setProgress), []);
+    (0, react_1.useEffect)(() => {
+        if (skipInDev && __DEV__)
+            return;
+        return (0, telemetry_1.startTelemetry)();
+    }, [skipInDev]);
     (0, react_1.useEffect)(() => {
         if (!autoSync)
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsonair.ir/react-native",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "React Native client SDK for self-hosted OTA updates",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -9,6 +9,8 @@
     "lib",
     "android",
     "ios",
+    "firebase",
+    "appsonair-react-native.podspec",
     "react-native.config.js"
   ],
   "scripts": {