@suro4ek/appmetrica-push-sdk 1.0.2

package/AppMetricaPushSDK.podspec

@@ -0,0 +1,28 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "AppMetricaPushSDK"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "11.0" }
+  s.source       = { :git => "https://github.com/suro4ek/appmetrica-push-sdk.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.requires_arc = true
+
+  s.dependency "React-Core"
+  s.dependency "AppMetricaPush", "~> 3.2.0"
+  s.dependency "AppMetricaPushLazy", "~> 3.2.0"
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    "DEFINES_MODULE" => "YES",
+    "SWIFT_COMPILATION_MODE" => "wholemodule"
+  }
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Moyka Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @suro4ek/appmetrica-push-sdk
+
+React Native библиотека для интеграции с Yandex AppMetrica Push SDK.
+
+## Документация
+
+- 📖 [Полное руководство по интеграции](docs/INTEGRATION_GUIDE.md)
+- 📊 [Руководство по аналитике](docs/ANALYTICS_GUIDE.md)
+- 🍎 [Настройка APNS для iOS](docs/IOS_APNS_SETUP.md)
+
+## Установка
+
+```bash
+npm install @suro4ek/appmetrica-push-sdk
+# или
+yarn add @suro4ek/appmetrica-push-sdk
+```
+
+## Зависимости
+
+```bash
+npm install @react-native-firebase/messaging
+npm install @appmetrica/react-native-analytics
+```
+
+## Настройка
+
+### Android
+
+Добавьте в `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<application>
+    <receiver android:name="com.appmetricapush.SilentPushReceiver"
+              android:exported="false">
+        <intent-filter>
+            <action android:name="com.appmetricapush.action.ymp.SILENT_PUSH_RECEIVE"/>
+        </intent-filter>
+    </receiver>
+
+    <service android:name="com.appmetricapush.FirebaseMessagingMainService"
+             android:enabled="true"
+             android:exported="false">
+        <intent-filter android:priority="100">
+            <action android:name="com.google.firebase.MESSAGING_EVENT"/>
+        </intent-filter>
+    </service>
+
+    <service android:name="io.appmetrica.analytics.push.provider.firebase.AppMetricaMessagingService"
+             android:enabled="false"
+             tools:node="remove"/>
+</application>
+```
+
+### iOS
+
+```bash
+cd ios && pod install
+```
+
+## Использование
+
+```typescript
+import { Platform } from "react-native";
+import { getAPNSToken, getMessaging } from "@react-native-firebase/messaging";
+import { AppMetrica } from "@appmetrica/react-native-analytics";
+import { AppMetricaPush } from "@suro4ek/appmetrica-push-sdk";
+
+// 1. Сначала активируем основную AppMetrica
+AppMetrica.activate({
+  apiKey: "YOUR_APPMETRICA_API_KEY",
+});
+
+// 2. Получение APNS токена для iOS
+let apnsToken = "";
+if (Platform.OS === "ios") {
+  const messaging = getMessaging();
+  apnsToken = (await getAPNSToken(messaging)) ?? "";
+}
+
+// 3. Инициализация Push SDK (ТОЛЬКО после AppMetrica.activate)
+await AppMetricaPush.initialize({
+  debugMode: __DEV__,
+  apnsToken: Platform.OS === "ios" ? apnsToken : undefined,
+});
+
+// Проверка уведомления
+const isFromAppMetrica = await AppMetricaPush.isNotificationFromAppMetrica(
+  notification
+);
+
+// Получение пользовательских данных
+const userData = await AppMetricaPush.getUserData(notification);
+```
+
+## API
+
+- `initialize(config)` - инициализация SDK
+- `isNotificationFromAppMetrica(notification)` - проверка источника уведомления
+- `getUserData(notification)` - извлечение пользовательских данных
+- `getSDKInfo()` - информация о SDK
+
+## Требования
+
+- React Native >= 0.60.0
+- Android API 21+
+- iOS 11.0+
+
+## Лицензия
+
+MIT

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Thu Dec 25 09:38:41 YAKT 2025
+gradle.version=9.0.0

package/android/build.gradle

@@ -0,0 +1,44 @@
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+android {
+    namespace "com.appmetricapush"
+    compileSdkVersion 34
+    buildToolsVersion "34.0.0"
+
+    defaultConfig {
+        minSdkVersion 21
+        targetSdkVersion 34
+        versionCode 1
+        versionName "1.0"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+dependencies {
+    implementation "com.facebook.react:react-native:+"
+    
+    // Kotlin
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:2.1.20"
+    
+    // AppMetrica Push SDK (только основные зависимости)
+    implementation("io.appmetrica.analytics:push:4.2.1")
+    implementation("androidx.legacy:legacy-support-v4:1.0.0")
+    
+    // Firebase dependencies (будут переопределены основным проектом)
+    implementation platform('com.google.firebase:firebase-bom:33.2.0')
+    implementation 'com.google.firebase:firebase-messaging'
+    implementation 'com.google.firebase:firebase-messaging-ktx'
+    implementation("io.appmetrica.analytics:push-provider-firebase:4.2.1")
+}

package/android/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'AppMetricaPushSDK'

package/android/src/main/java/com/appmetricapush/AppMetricaPushModule.kt

@@ -0,0 +1,176 @@
+package com.appmetricapush
+
+import android.util.Log
+import androidx.annotation.NonNull
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.bridge.Arguments
+import io.appmetrica.analytics.push.AppMetricaPush
+
+/**
+ * React Native модуль для AppMetrica Push SDK
+ * Написан на Kotlin для лучшей интеграции с современным Android разработкой
+ */
+class AppMetricaPushModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+    
+    companion object {
+        private const val MODULE_NAME = "AppMetricaPushModule"
+        private const val TAG = "AppMetricaPush"
+    }
+
+    @NonNull
+    override fun getName(): String {
+        return MODULE_NAME
+    }
+
+    @ReactMethod
+    fun initialize(config: ReadableMap, promise: Promise) {
+        try {
+            val debugMode = if (config.hasKey("debugMode")) config.getBoolean("debugMode") else false
+
+            // Инициализация AppMetrica Push
+            AppMetricaPush.activate(reactApplicationContext)
+            
+            // Настройка дефолтного канала AppMetrica Push SDK
+            setupAppMetricaDefaultChannel()
+            
+            if (debugMode) {
+                Log.d(TAG, "AppMetrica Push initialized successfully")
+            }
+
+            promise.resolve(true)
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to initialize AppMetrica Push", e)
+            promise.reject("INIT_ERROR", e.message)
+        }
+    }
+
+
+    /**
+     * Настройка дефолтного канала AppMetrica Push SDK
+     */
+    private fun setupAppMetricaDefaultChannel() {
+        try {
+            if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
+                // Получаем дефолтный канал AppMetrica и настраиваем его
+                // appmetrica_push_channel
+                AppMetricaPush.getDefaultNotificationChannel()?.apply {
+                    description = "Push notifications from AppMetrica"
+                    importance = android.app.NotificationManager.IMPORTANCE_HIGH
+                    enableLights(true)
+                    enableVibration(true)
+                    setShowBadge(true)
+                    // Включаем звук
+                    setSound(android.media.RingtoneManager.getDefaultUri(android.media.RingtoneManager.TYPE_NOTIFICATION), null)
+                }
+                Log.d(TAG, "AppMetrica default notification channel configured with sound")
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to setup AppMetrica default channel", e)
+        }
+    }
+
+
+    @ReactMethod
+    fun isNotificationFromAppMetrica(notification: ReadableMap, promise: Promise) {
+        try {
+            // Проверяем, что push уведомление не от AppMetrica
+            // Это нужно для собственных сервисов обработки push уведомлений
+            var isFromAppMetrica = false
+            
+            if (notification.hasKey("data")) {
+                // Проверяем наличие специфических полей AppMetrica в данных
+                val data = notification.getString("data")
+                if (data != null && data.contains("appmetrica")) {
+                    isFromAppMetrica = true
+                }
+            }
+            
+            promise.resolve(isFromAppMetrica)
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to check if notification is from AppMetrica", e)
+            promise.reject("NOTIFICATION_CHECK_ERROR", e.message)
+        }
+    }
+
+    @ReactMethod
+    fun getSDKInfo(promise: Promise) {
+        try {
+            val info = Arguments.createMap().apply {
+                // Получаем актуальную версию AppMetrica Push SDK
+                putString("version", getAppMetricaPushVersion())
+                putString("platform", "android")
+                putString("sdkName", "AppMetrica Push SDK")
+                putString("libraryVersion", "1.0.0") // Версия нашей библиотеки
+            }
+            promise.resolve(info)
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to get SDK info", e)
+            promise.reject("SDK_INFO_ERROR", e.message)
+        }
+    }
+
+        @ReactMethod
+        fun getUserData(notification: ReadableMap, promise: Promise) {
+            try {
+                // Получаем дополнительную информацию из push-уведомления согласно документации
+                // AppMetrica Push SDK автоматически извлекает userData из уведомления
+                val userData = Arguments.createMap()
+                
+                // Проверяем наличие данных в уведомлении
+                if (notification.hasKey("data")) {
+                    val data = notification.getMap("data")
+                    if (data != null) {
+                        // Копируем все данные из notification.data в userData
+                        val keySetIterator = data.keySetIterator()
+                        while (keySetIterator.hasNextKey()) {
+                            val key = keySetIterator.nextKey()
+                            val value = data.getDynamic(key)
+                            userData.putString(key, value.toString())
+                        }
+                    }
+                }
+                
+                promise.resolve(userData)
+            } catch (e: Exception) {
+                Log.e(TAG, "Failed to get user data from notification", e)
+                promise.reject("USER_DATA_ERROR", e.message)
+            }
+        }
+
+    /**
+     * Регистрация device token (заглушка для iOS совместимости)
+     * В Android device token регистрируется автоматически через Firebase
+     */
+    @ReactMethod
+    fun registerDeviceToken(deviceToken: String, promise: Promise) {
+        try {
+            // В Android device token регистрируется автоматически через Firebase
+            // Этот метод добавлен для совместимости с iOS API
+            Log.d(TAG, "Device token registration not needed on Android (handled by Firebase)")
+            promise.resolve(true)
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to register device token", e)
+            promise.reject("REGISTRATION_ERROR", e.message)
+        }
+    }
+
+
+    /**
+     * Получение версии AppMetrica Push SDK
+     */
+    private fun getAppMetricaPushVersion(): String {
+        return try {
+            // Пытаемся получить версию из AppMetrica Push SDK
+            val version = io.appmetrica.analytics.push.BuildConfig.VERSION_NAME
+            version ?: "4.2.1" // Fallback версия
+        } catch (e: Exception) {
+            Log.w(TAG, "Could not get AppMetrica Push version, using fallback", e)
+            "4.2.1" // Fallback версия
+        }
+    }
+}

package/android/src/main/java/com/appmetricapush/AppMetricaPushPackage.kt

@@ -0,0 +1,21 @@
+package com.appmetricapush
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+/**
+ * React Native Package для AppMetrica Push SDK
+ * Написан на Kotlin для консистентности с остальным кодом
+ */
+class AppMetricaPushPackage : ReactPackage {
+    
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(AppMetricaPushModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/android/src/main/java/com/appmetricapush/FirebaseMessagingMainService.kt

@@ -0,0 +1,79 @@
+package com.appmetricapush
+
+import android.util.Log
+import com.google.firebase.messaging.FirebaseMessagingService
+import com.google.firebase.messaging.RemoteMessage
+import io.appmetrica.analytics.push.provider.firebase.AppMetricaMessagingService
+
+/**
+ * Основной сервис для обработки Firebase Cloud Messaging
+ * Интегрирован с AppMetrica Push SDK
+ * Входит в состав библиотеки @moyka/appmetrica-push-sdk
+ */
+class FirebaseMessagingMainService : FirebaseMessagingService() {
+    companion object {
+        private const val TAG = "AppMetricaFirebaseService"
+    }
+
+    override fun onMessageReceived(message: RemoteMessage) {
+        super.onMessageReceived(message)
+        
+        Log.d(TAG, "Firebase message received: ${message.messageId}")
+        
+        // Проверяем, что push уведомление от AppMetrica
+        if (AppMetricaMessagingService.isNotificationRelatedToSDK(message)) {
+            Log.d(TAG, "Processing AppMetrica push notification")
+            // AppMetrica Push SDK сам покажет уведомление пользователю
+            AppMetricaMessagingService().processPush(this, message)
+            return
+        }
+
+        // Обрабатываем собственные push уведомления
+        Log.d(TAG, "Processing custom push notification")
+        handleCustomPushMessage(message)
+    }
+
+    override fun onNewToken(token: String) {
+        super.onNewToken(token)
+        
+        Log.d(TAG, "New FCM token received: $token")
+        
+        // Отправляем токен в AppMetrica Push SDK
+        AppMetricaMessagingService().processToken(this, token)
+        
+        // Отправляем токен в другие SDK или обрабатываем самостоятельно
+        handleCustomToken(token)
+    }
+
+    /**
+     * Обработка собственных push уведомлений
+     */
+    private fun handleCustomPushMessage(message: RemoteMessage) {
+        try {
+            Log.d(TAG, "Custom push data: ${message.data}")
+            Log.d(TAG, "Custom push notification: ${message.notification}")
+            
+            // Здесь можно добавить логику обработки собственных push уведомлений
+            // Например, отправить событие в React Native через EventEmitter
+            
+        } catch (e: Exception) {
+            Log.e(TAG, "Error handling custom push message", e)
+        }
+    }
+
+
+    /**
+     * Обработка собственного токена
+     */
+    private fun handleCustomToken(token: String) {
+        try {
+            Log.d(TAG, "Handling custom token: $token")
+            
+            // Здесь можно отправить токен в другие SDK или на ваш сервер
+            // Например, отправить событие в React Native через EventEmitter
+            
+        } catch (e: Exception) {
+            Log.e(TAG, "Error handling custom token", e)
+        }
+    }
+}

package/android/src/main/java/com/appmetricapush/SilentPushReceiver.kt

@@ -0,0 +1,53 @@
+package com.appmetricapush
+
+import android.content.BroadcastReceiver
+import android.content.Context
+import android.content.Intent
+import android.util.Log
+import io.appmetrica.analytics.push.AppMetricaPush
+
+/**
+ * Receiver для обработки silent push уведомлений от AppMetrica
+ * Настроен согласно документации AppMetrica Push SDK
+ * Входит в состав библиотеки @suro4ek/appmetrica-push-sdk
+ */
+class SilentPushReceiver : BroadcastReceiver() {
+    companion object {
+        private const val TAG = "AppMetricaSilentPushReceiver"
+    }
+
+    override fun onReceive(context: Context, intent: Intent) {
+        try {
+            // Extract push message payload from your push message.
+            val payload = intent.getStringExtra(AppMetricaPush.EXTRA_PAYLOAD)
+            
+            if (payload != null) {
+                Log.d(TAG, "Silent push received with payload: $payload")
+                
+                // AppMetrica Push SDK автоматически обрабатывает silent push
+                // Здесь можно добавить дополнительную логику обработки
+                handleSilentPushPayload(context, payload)
+            } else {
+                Log.w(TAG, "Silent push received but payload is null")
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Error handling silent push", e)
+        }
+    }
+
+    /**
+     * Обработка payload от silent push
+     */
+    private fun handleSilentPushPayload(context: Context, payload: String) {
+        try {
+            // Логируем получение silent push
+            Log.d(TAG, "Processing silent push payload: $payload")
+            
+            // AppMetrica Push SDK автоматически обрабатывает silent push
+            // Здесь можно добавить дополнительную логику обработки
+            
+        } catch (e: Exception) {
+            Log.e(TAG, "Error processing silent push payload", e)
+        }
+    }
+}

package/docs/ANALYTICS_GUIDE.md

@@ -0,0 +1,68 @@
+# Руководство для аналитиков
+
+## Настройка push кампаний в AppMetrica
+
+При создании push кампаний в веб-интерфейсе AppMetrica **обязательно укажите канал уведомлений**:
+
+```
+appmetrica_push_channel
+```
+
+## Почему это важно:
+
+- ✅ **Звук уведомлений** - канал настроен с включенным звуком
+- ✅ **Высокий приоритет** - уведомления будут показаны пользователю
+- ✅ **Вибрация** - включена для лучшего UX
+- ✅ **Светодиод** - для визуального уведомления
+
+## Где указать канал:
+
+1. Перейдите в **AppMetrica → Push-уведомления**
+2. Создайте новую кампанию
+3. В разделе **"Настройки уведомления"** найдите поле **"Канал уведомлений"**
+4. Укажите: `appmetrica_push_channel`
+
+## Без указания канала:
+
+- ❌ Уведомления могут приходить без звука
+- ❌ Низкий приоритет уведомлений
+- ❌ Плохой пользовательский опыт
+
+## Дополнительные настройки
+
+### Silent Push уведомления
+
+Для актуализации push-токенов включите в настройках AppMetrica:
+
+1. Перейдите в **Настройки приложения → Push-уведомления**
+2. Включите **"Актуализировать токены с помощью Silent Push-уведомлений"**
+
+### Тестирование уведомлений
+
+1. **Тестовая отправка** - используйте функцию "Отправить тест"
+2. **Проверка канала** - убедитесь, что указан `appmetrica_push_channel`
+3. **Проверка звука** - уведомление должно приходить со звуком
+
+## Troubleshooting
+
+### Уведомления без звука
+
+1. ✅ Проверьте, что указан канал `appmetrica_push_channel`
+2. ✅ Убедитесь, что приложение не в режиме "Не беспокоить"
+3. ✅ Проверьте настройки звука в Android
+
+### Уведомления не доходят
+
+1. ✅ Проверьте, что SDK инициализирован
+2. ✅ Убедитесь, что пользователь дал разрешения на уведомления
+3. ✅ Проверьте, что токен получен и отправлен в AppMetrica
+
+### Низкая доставляемость
+
+1. ✅ Используйте Silent Push для актуализации токенов
+2. ✅ Проверьте, что Firebase настроен правильно
+3. ✅ Убедитесь, что все зависимости добавлены
+
+## Контакты
+
+При возникновении проблем с push уведомлениями обращайтесь к команде разработки.