@suro4ek/appmetrica-push-sdk 1.0.2

package/docs/IOS_APNS_SETUP.md

@@ -0,0 +1,95 @@
+# Настройка APNS токена для iOS
+
+## Обязательные требования
+
+Для корректной работы AppMetrica Push SDK на iOS **обязательно** необходимо передавать APNS токен при инициализации.
+
+## Установка зависимостей
+
+```bash
+npm install @react-native-firebase/messaging
+```
+
+## Получение APNS токена
+
+```typescript
+import { Platform } from "react-native";
+import { getAPNSToken, getMessaging } from "@react-native-firebase/messaging";
+
+// Получение APNS токена для iOS
+let apnsToken = "";
+if (Platform.OS === "ios") {
+  const messaging = getMessaging();
+  apnsToken = (await getAPNSToken(messaging)) ?? "";
+}
+```
+
+## Инициализация с APNS токеном
+
+```typescript
+import { AppMetricaPush } from "@suro4ek/appmetrica-push-sdk";
+
+await AppMetricaPush.initialize({
+  debugMode: __DEV__,
+  apnsToken: Platform.OS === "ios" ? apnsToken : undefined,
+});
+```
+
+## Полный пример
+
+```typescript
+import { Platform } from "react-native";
+import { getAPNSToken, getMessaging } from "@react-native-firebase/messaging";
+import { AppMetricaPush } from "@suro4ek/appmetrica-push-sdk";
+
+const initializeAppMetricaPush = async () => {
+  try {
+    // Получение APNS токена для iOS
+    let apnsToken = "";
+    if (Platform.OS === "ios") {
+      const messaging = getMessaging();
+      apnsToken = (await getAPNSToken(messaging)) ?? "";
+
+      if (!apnsToken) {
+        console.error("Failed to get APNS token for iOS");
+        return;
+      }
+    }
+
+    // Инициализация AppMetrica Push SDK
+    const result = await AppMetricaPush.initialize({
+      debugMode: __DEV__,
+      apnsToken: Platform.OS === "ios" ? apnsToken : undefined,
+    });
+
+    if (result.success) {
+      console.log("AppMetrica Push SDK initialized successfully");
+    } else {
+      console.error("Failed to initialize AppMetrica Push SDK:", result.error);
+    }
+  } catch (error) {
+    console.error("Error initializing AppMetrica Push SDK:", error);
+  }
+};
+```
+
+## Важные моменты
+
+1. **APNS токен обязателен для iOS** - без него push уведомления не будут работать
+2. **Android не требует APNS токен** - для Android используется Firebase Cloud Messaging
+3. **Токен получается асинхронно** - используйте `await` при получении токена
+4. **Проверяйте наличие токена** - убедитесь, что токен получен перед инициализацией
+
+## Troubleshooting
+
+### APNS токен не получается
+
+1. Убедитесь, что Firebase настроен правильно
+2. Проверьте, что приложение имеет разрешения на push уведомления
+3. Убедитесь, что используется правильный bundle ID в Firebase консоли
+
+### Push уведомления не приходят на iOS
+
+1. Проверьте, что APNS токен передается при инициализации
+2. Убедитесь, что сертификаты APNS настроены правильно
+3. Проверьте, что AppMetrica Push SDK инициализирован успешно

package/ios/AppMetricaPushSDK/AppMetricaPushModule.m

@@ -0,0 +1,25 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(AppMetricaPushModule, NSObject)
+
+RCT_EXTERN_METHOD(initialize:(NSDictionary *)config
+                  resolver:(RCTPromiseResolveBlock)resolver
+                  rejecter:(RCTPromiseRejectBlock)rejecter)
+
+RCT_EXTERN_METHOD(isNotificationFromAppMetrica:(NSDictionary *)notification
+                  resolver:(RCTPromiseResolveBlock)resolver
+                  rejecter:(RCTPromiseRejectBlock)rejecter)
+
+RCT_EXTERN_METHOD(getSDKInfo:(RCTPromiseResolveBlock)resolver
+                  rejecter:(RCTPromiseRejectBlock)rejecter)
+
+RCT_EXTERN_METHOD(getUserData:(NSDictionary *)notification
+                  resolver:(RCTPromiseResolveBlock)resolver
+                  rejecter:(RCTPromiseRejectBlock)rejecter)
+
+RCT_EXTERN_METHOD(registerDeviceToken:(NSString *)deviceToken
+                  resolver:(RCTPromiseResolveBlock)resolver
+                  rejecter:(RCTPromiseRejectBlock)rejecter)
+
+
+@end

package/ios/AppMetricaPushSDK/AppMetricaPushModule.swift

@@ -0,0 +1,200 @@
+import Foundation
+import React
+import AppMetricaPush
+import UserNotifications
+
+// MARK: - Data Extension for Hex String
+extension Data {
+    init?(hexString: String) {
+        let len = hexString.count / 2
+        var data = Data(capacity: len)
+        var i = hexString.startIndex
+        for _ in 0..<len {
+            let j = hexString.index(i, offsetBy: 2)
+            let bytes = hexString[i..<j]
+            if var num = UInt8(bytes, radix: 16) {
+                data.append(&num, count: 1)
+            } else {
+                return nil
+            }
+            i = j
+        }
+        self = data
+    }
+}
+
+
+@objc(AppMetricaPushModule)
+class AppMetricaPushModule: NSObject, RCTBridgeModule {
+    
+    // MARK: - RCTBridgeModule Protocol
+    
+    static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+    
+    static func moduleName() -> String! {
+        return "AppMetricaPushModule"
+    }
+    
+    // MARK: - Initialization (Deprecated - use AppMetricaPushInitializer)
+    
+    @objc
+    func initialize(_ config: NSDictionary, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+        let debugMode = config["debugMode"] as? Bool ?? false
+        
+        DispatchQueue.main.async {
+            do {
+                // Выполняем инициализацию
+                self.performInitialization(config: config, debugMode: debugMode, resolver: resolver, rejecter: rejecter)
+                
+            } catch {
+                rejecter("INIT_ERROR", error.localizedDescription, error)
+            }
+        }
+    }
+    
+    private func performInitialization(config: NSDictionary, debugMode: Bool, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+        do {
+            // 1. Настройка App Group если указан
+            if let appGroup = config["appGroup"] as? String {
+                AppMetricaPush.setExtensionAppGroup(appGroup)
+                if debugMode {
+                    print("App Group set: \(appGroup)")
+                }
+            }
+            
+            // 2. Инициализация AppMetrica Push SDK
+            AppMetricaPush.handleApplicationDidFinishLaunching(options: nil)
+            
+            // 3. Настройка push-уведомлений
+            self.setupPushNotifications(debugMode: debugMode)
+            
+            // 4. Настройка автоматической обработки push-уведомлений
+            self.setupNotificationDelegate()
+            
+            if debugMode {
+                print("AppMetrica Push SDK initialized successfully from TypeScript")
+            }
+            
+            resolver(true)
+        } catch {
+            rejecter("INIT_ERROR", error.localizedDescription, error)
+        }
+    }
+    
+    /**
+     * Настройка push-уведомлений
+     */
+    private func setupPushNotifications(debugMode: Bool) {
+        let center = UNUserNotificationCenter.current()
+        center.requestAuthorization(options: [.badge, .alert, .sound]) { (granted, error) in
+            if granted {
+                DispatchQueue.main.async {
+                    UIApplication.shared.registerForRemoteNotifications()
+                }
+                
+                if debugMode {
+                    print("Push notification permissions granted")
+                }
+            } else {
+                if debugMode {
+                    print("Push notification permissions denied")
+                }
+            }
+        }
+    }
+    
+    /**
+     * Настройка автоматической обработки push-уведомлений
+     */
+    private func setupNotificationDelegate() {
+        let delegate = AppMetricaPush.userNotificationCenterDelegate
+        UNUserNotificationCenter.current().delegate = delegate
+    }
+    
+    
+    // MARK: - Notification Analysis
+    
+    @objc
+    func isNotificationFromAppMetrica(_ notification: NSDictionary, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+        DispatchQueue.main.async {
+            // Преобразуем NSDictionary в [AnyHashable : Any] для AppMetrica
+            let notificationDict = notification as? [AnyHashable : Any] ?? [:]
+            let isRelatedToAppMetricaSDK = AppMetricaPush.isNotificationRelated(toSDK: notificationDict)
+            resolver(isRelatedToAppMetricaSDK)
+        }
+    }
+    
+    // MARK: - SDK Information
+    
+    @objc
+    func getSDKInfo(_ resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+        DispatchQueue.main.async {
+            let info: [String: Any] = [
+                "version": "3.2.0",
+                "platform": "ios",
+                "sdkName": "AppMetrica Push SDK",
+                "libraryVersion": "1.0.0"
+            ]
+            resolver(info)
+        }
+    }
+    
+    // MARK: - User Data Extraction
+    
+    @objc
+    func getUserData(_ notification: NSDictionary, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+        DispatchQueue.main.async {
+            // Преобразуем NSDictionary в [AnyHashable : Any] для AppMetrica
+            let notificationDict = notification as? [AnyHashable : Any] ?? [:]
+            // Получаем дополнительную информацию из push-уведомления согласно документации
+            let userData = AppMetricaPush.userData(forNotification: notificationDict)
+            resolver(userData)
+        }
+    }
+    
+    // MARK: - Device Token Registration
+    
+    @objc
+    func registerDeviceToken(_ deviceToken: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+        DispatchQueue.main.async {
+            do {
+                // Преобразуем строку в Data
+                // Пробуем сначала как hex строку, потом как обычную строку
+                var tokenData: Data?
+                
+                // Пробуем как hex строку (APNs токен)
+                if deviceToken.count % 2 == 0 && deviceToken.allSatisfy({ $0.isHexDigit }) {
+                    tokenData = Data(hexString: deviceToken)
+                }
+                
+                // Если не получилось как hex, пробуем как обычную строку
+                if tokenData == nil {
+                    tokenData = deviceToken.data(using: .utf8)
+                }
+                
+                guard let finalTokenData = tokenData else {
+                    rejecter("INVALID_TOKEN", "Failed to convert device token to Data", nil)
+                    return
+                }
+                
+                // Определяем окружение для APNs
+                #if DEBUG
+                let pushEnvironment = AppMetricaPushEnvironment.development
+                #else
+                let pushEnvironment = AppMetricaPushEnvironment.production
+                #endif
+                
+                AppMetricaPush.setDeviceTokenFrom(finalTokenData, pushEnvironment: pushEnvironment)
+                
+                resolver(true)
+            } catch {
+                rejecter("REGISTRATION_ERROR", error.localizedDescription, error)
+            }
+        }
+    }
+    
+    
+}
+

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@suro4ek/appmetrica-push-sdk",
+  "version": "1.0.2",
+  "description": "React Native library for Yandex AppMetrica Push SDK",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "prepublishOnly": "npm run lint",
+    "publish:patch": "./scripts/publish.sh patch",
+    "publish:minor": "./scripts/publish.sh minor",
+    "publish:major": "./scripts/publish.sh major",
+    "publish:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "react-native",
+    "appmetrica",
+    "push",
+    "notifications",
+    "yandex",
+    "analytics"
+  ],
+  "author": "Artem Egorov",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suro4ek/appmetrica-push-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/suro4ek/appmetrica-push-sdk/issues"
+  },
+  "homepage": "https://github.com/suro4ek/appmetrica-push-sdk#readme",
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "@types/react-native": "^0.72.0",
+    "typescript": "^5.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0"
+  },
+  "dependencies": {
+    "react-native-permissions": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-native": ">=0.60.0",
+    "@react-native-firebase/messaging": ">=18.0.0",
+    "@appmetrica/react-native-analytics": ">=3.5.0"
+  },
+  "react-native": {
+    "android": {
+      "sourceDir": "android",
+      "packageImportPath": "import com.appmetricapush.AppMetricaPushPackage;"
+    },
+    "ios": {
+      "sharedLibraries": [
+        "libc++"
+      ]
+    }
+  },
+  "files": [
+    "src",
+    "android",
+    "ios",
+    "AppMetricaPushSDK.podspec",
+    "README.md",
+    "LICENSE",
+    "docs"
+  ]
+}

package/src/AppMetricaPushModule.ts

@@ -0,0 +1,188 @@
+import { NativeModules, Platform } from "react-native";
+import { PushConfig, SDKInfo, InitializationResult } from "./types";
+
+const { AppMetricaPushModule } = NativeModules;
+
+/**
+ * Основной класс для работы с AppMetrica Push SDK
+ */
+class AppMetricaPush {
+  private static instance: AppMetricaPush | null = null;
+  private isInitialized = false;
+  private config: PushConfig | null = null;
+
+  /**
+   * Получить экземпляр класса (Singleton)
+   */
+  static getInstance(): AppMetricaPush {
+    if (!AppMetricaPush.instance) {
+      AppMetricaPush.instance = new AppMetricaPush();
+    }
+    return AppMetricaPush.instance;
+  }
+
+  /**
+   * Инициализация AppMetrica Push SDK
+   */
+  async initialize(config: PushConfig): Promise<InitializationResult> {
+    try {
+      if (!AppMetricaPushModule) {
+        throw new Error(
+          "AppMetricaPushModule is not available. Make sure the native module is properly linked."
+        );
+      }
+
+      if (this.isInitialized) {
+        console.warn("AppMetrica Push SDK is already initialized");
+        return { success: true };
+      }
+
+      const result = await AppMetricaPushModule.initialize(config);
+
+      if (result) {
+        this.isInitialized = true;
+        this.config = config;
+
+        if (config.debugMode) {
+          console.log("AppMetrica Push SDK initialized successfully");
+        }
+
+        // Автоматически регистрируем APNs device token для iOS если предоставлен
+        // APNs токен должен быть получен через messaging.getAPNSToken()
+        if (config.apnsToken && Platform.OS === "ios") {
+          await this.registerDeviceToken(config.apnsToken);
+
+          if (config.debugMode) {
+            console.log("APNs device token registered for iOS");
+          }
+        }
+
+        return { success: true };
+      } else {
+        return {
+          success: false,
+          error: "Failed to initialize AppMetrica Push SDK",
+        };
+      }
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.message : "Unknown error";
+      console.error("AppMetrica Push initialization failed:", errorMessage);
+      return { success: false, error: errorMessage };
+    }
+  }
+
+  /**
+   * Проверка, что уведомление от AppMetrica
+   * Используется в собственных сервисах обработки push уведомлений
+   */
+  async isNotificationFromAppMetrica(notification: any): Promise<boolean> {
+    try {
+      if (!AppMetricaPushModule) {
+        return false;
+      }
+
+      // Проверяем наличие метода в нативном модуле
+      if (
+        typeof AppMetricaPushModule.isNotificationFromAppMetrica === "function"
+      ) {
+        return await AppMetricaPushModule.isNotificationFromAppMetrica(
+          notification
+        );
+      } else {
+        // Fallback для iOS - проверяем поля вручную
+        if (Platform.OS === "ios") {
+          const data = notification?.data || notification?.aps?.data;
+          return !!(
+            data?.ym_push_id ||
+            data?.ym_campaign_id ||
+            data?.ym_message_id
+          );
+        }
+        return false;
+      }
+    } catch (error) {
+      console.error(
+        "Failed to check if notification is from AppMetrica:",
+        error
+      );
+      return false;
+    }
+  }
+
+  /**
+   * Получение информации о SDK
+   */
+  async getSDKInfo(): Promise<SDKInfo | null> {
+    try {
+      if (!AppMetricaPushModule) {
+        return null;
+      }
+
+      return await AppMetricaPushModule.getSDKInfo();
+    } catch (error) {
+      console.error("Failed to get SDK info:", error);
+      return null;
+    }
+  }
+
+  /**
+   * Получение дополнительной информации из push-уведомления
+   * Согласно документации AppMetrica Push SDK
+   */
+  async getUserData(notification: any): Promise<any> {
+    try {
+      if (!AppMetricaPushModule) {
+        return null;
+      }
+
+      return await AppMetricaPushModule.getUserData(notification);
+    } catch (error) {
+      console.error("Failed to get user data:", error);
+      return null;
+    }
+  }
+
+  /**
+   * Регистрация device token для push-уведомлений
+   */
+  async registerDeviceToken(deviceToken: string): Promise<boolean> {
+    try {
+      if (!AppMetricaPushModule) {
+        throw new Error("AppMetricaPushModule is not available");
+      }
+
+      const result = await AppMetricaPushModule.registerDeviceToken(
+        deviceToken
+      );
+      return result;
+    } catch (error) {
+      console.error("Failed to register device token:", error);
+      return false;
+    }
+  }
+
+  /**
+   * Проверка инициализации
+   */
+  isSDKInitialized(): boolean {
+    return this.isInitialized;
+  }
+
+  /**
+   * Получение текущей конфигурации
+   */
+  getConfig(): PushConfig | null {
+    return this.config;
+  }
+
+  /**
+   * Сброс состояния (для тестирования)
+   */
+  reset(): void {
+    this.isInitialized = false;
+    this.config = null;
+  }
+}
+
+export default AppMetricaPush;

package/src/hooks/useAppMetricaPush.ts

@@ -0,0 +1,81 @@
+import { useEffect, useState, useCallback } from 'react'
+import { getPushSDKInfo, isSDKInitialized } from '../utils'
+import { SDKInfo } from '../types'
+
+/**
+ * Интерфейс возвращаемых значений хука
+ */
+export interface UseAppMetricaPushReturn {
+  /** Информация о SDK */
+  sdkInfo: SDKInfo | null
+  /** Статус инициализации SDK */
+  isInitialized: boolean
+  /** Загрузка данных */
+  isLoading: boolean
+  /** Обновление информации о SDK */
+  refreshSDKInfo: () => Promise<void>
+}
+
+/**
+ * Хук для работы с AppMetrica Push уведомлениями
+ *
+ * @example
+ * ```tsx
+ * import { useAppMetricaPush } from '@moyka/appmetrica-push-sdk'
+ *
+ * const MyComponent = () => {
+ *   const {
+ *     sdkInfo,
+ *     isInitialized
+ *   } = useAppMetricaPush()
+ *
+ *   return (
+ *     <View>
+ *       <Text>SDK initialized: {isInitialized ? 'Yes' : 'No'}</Text>
+ *     </View>
+ *   )
+ * }
+ * ```
+ */
+export const useAppMetricaPush = (): UseAppMetricaPushReturn => {
+  const [sdkInfo, setSdkInfo] = useState<SDKInfo | null>(null)
+  const [isInitialized, setIsInitialized] = useState<boolean>(false)
+  const [isLoading, setIsLoading] = useState<boolean>(true)
+
+  const loadSDKInfo = useCallback(async () => {
+    try {
+      const info = await getPushSDKInfo()
+      setSdkInfo(info)
+    } catch (error) {
+      console.error('Failed to load SDK info:', error)
+    }
+  }, [])
+
+  const checkInitialization = useCallback(() => {
+    const initialized = isSDKInitialized()
+    setIsInitialized(initialized)
+  }, [])
+
+  const refreshSDKInfo = useCallback(async () => {
+    await loadSDKInfo()
+  }, [loadSDKInfo])
+
+  // Инициализация при монтировании компонента
+  useEffect(() => {
+    const initialize = async () => {
+      setIsLoading(true)
+      checkInitialization()
+      await loadSDKInfo()
+      setIsLoading(false)
+    }
+
+    initialize()
+  }, [loadSDKInfo, checkInitialization])
+
+  return {
+    sdkInfo,
+    isInitialized,
+    isLoading,
+    refreshSDKInfo,
+  }
+}

package/src/index.ts

@@ -0,0 +1,24 @@
+// Основной класс
+export { default as AppMetricaPush } from "./AppMetricaPushModule";
+
+// Хуки
+export { useAppMetricaPush } from "./hooks/useAppMetricaPush";
+export type { UseAppMetricaPushReturn } from "./hooks/useAppMetricaPush";
+
+// Утилиты
+export {
+  initializeAppMetricaPush,
+  isNotificationFromAppMetrica,
+  getPushSDKInfo,
+  getUserDataFromNotification,
+  registerDeviceToken,
+  isSDKInitialized,
+  getCurrentConfig,
+  resetSDK,
+} from "./utils";
+
+// Типы
+export type { PushConfig, SDKInfo, InitializationResult } from "./types";
+
+// Версия библиотеки
+export const VERSION = "1.0.0";