react-native-nitro-ali-push 0.0.0-stage → 1.0.1

package/ios/HybridAliPushPlugin.swift

@@ -0,0 +1,519 @@
+import Foundation
+import UIKit
+import UserNotifications
+import CloudPushSDK
+import NitroModules
+
+/// 通知栏消息类型。
+private let ALIYUN_PUSH_TYPE_NOTIFICATION = "notification"
+/// 透传 / 非通知栏消息类型。
+private let ALIYUN_PUSH_TYPE_MESSAGE = "message"
+
+/// Debug 下输出日志（对应原 Objective-C 的 `DLog` 宏）。
+private func DLog(_ message: String, file: String = #file, line: UInt = #line) {
+  #if DEBUG
+  print("<\((file as NSString).lastPathComponent):\(line)> \(message)")
+  #endif
+}
+
+/**
+ * react-native-nitro-ali-push 的 iOS 原生实现（Swift，Nitro HybridObject）。
+ *
+ * 通过 `nitrogen` 生成的 `HybridAliPushPluginSpec` 协议暴露给 JS；初始化、APNs 注册、
+ * `CloudPushSDK` 回调以及事件分发都在本类完成。
+ *
+ * iOS 端的推送初始化必须在原生层完成（AppDelegate 调用 `shared.setParams`），而不是
+ * 从 JS 调用 `initPush`（该方法在 iOS 上为无操作）。
+ */
+/// 必须 `public`：本库作为 pod 是独立模块，App 的 Swift/ObjC 需要引用它。
+/// 仅 `internal` 时不会写进 `<react_native_nitro_ali_push-Swift.h>`，App 端编译报
+/// "Use of undeclared identifier 'HybridAliPushPlugin'"。`@objc` 运行时名保持不变。
+@objc(HybridAliPushPlugin)
+public final class HybridAliPushPlugin: HybridAliPushPluginSpec, UNUserNotificationCenterDelegate {
+  /// 由 AppDelegate 创建的权威实例（持有 UNUserNotificationCenter 代理与 CloudPushSDK 回调）。
+  private static var sharedInstance: HybridAliPushPlugin?
+  /// JS 注册的监听器（静态池，AppDelegate 实例与 JS 实例共享）。
+  private static var listeners: [UUID: (AliPushMessage) -> Void] = [:]
+  /// App 冷启动（被通知唤起）时、JS 尚未完成订阅的窗口期内到达的首条消息缓存。
+  private static var initialNotification: AliPushMessage?
+
+  // MARK: - 单例（供 AppDelegate 使用）
+
+  @objc public static func shared() -> HybridAliPushPlugin {
+    if let instance = sharedInstance { return instance }
+    let instance = HybridAliPushPlugin()
+    sharedInstance = instance
+    return instance
+  }
+
+  // MARK: - 生命周期 / Nitro 必填
+
+  override init() {
+    super.init()
+  }
+
+  // MARK: - 由原生 AppDelegate 调用完成 iOS 端推送初始化（不应从 JS 调用）
+
+  @objc public func setParams(_ appKey: String,
+                       appSecret: String,
+                       lauchOptions: [AnyHashable: Any]?,
+                       createNotificationCategoryHandler: @escaping () -> Void) {
+    registerAPNs(createNotificationCategoryHandler)
+    initCloudPush(appKey: appKey, appSecret: appSecret)
+    listenerOnChannelOpened()
+    registerMessageReceive()
+    CloudPushSDK.sendNotificationAck(lauchOptions)
+  }
+
+  // MARK: - APNs 注册
+
+  private func registerAPNs(_ createNotificationCategoryHandler: (() -> Void)?) {
+    let center = UNUserNotificationCenter.current()
+    createNotificationCategoryHandler?()
+    center.delegate = self
+
+    center.requestAuthorization(options: [.alert, .badge, .sound]) { granted, error in
+      if granted {
+        DLog("User authorized notification.")
+        DispatchQueue.main.async {
+          UIApplication.shared.registerForRemoteNotifications()
+        }
+      } else {
+        DLog("User denied notification: \(String(describing: error))")
+      }
+    }
+  }
+
+  // MARK: - SDK 初始化
+
+  private func initCloudPush(appKey: String, appSecret: String) {
+    CloudPushSDK.start(withAppkey: appKey, appSecret: appSecret) { res in
+      if res?.success ?? false {
+        DLog("Push SDK init success, deviceId: \(String(describing: CloudPushSDK.getDeviceId())).")
+      } else {
+        DLog("Push SDK init failed, error: \(String(describing: res?.error)).")
+      }
+    }
+  }
+
+  // MARK: - AppDelegate 转发方法
+
+  @objc public func application(_ application: UIApplication,
+                          didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+    CloudPushSDK.registerDevice(deviceToken) { res in
+      if res?.success ?? false {
+        DLog("Register deviceToken success.")
+      } else {
+        DLog("Register deviceToken failed, error: \(String(describing: res?.error)).")
+      }
+    }
+  }
+
+  @objc public func application(_ application: UIApplication,
+                          didFailToRegisterForRemoteNotificationsWithError error: Error) {
+    DLog("Get deviceToken failed, error: \(error.localizedDescription)")
+  }
+
+  @objc public func application(_ application: UIApplication,
+                          didReceiveRemoteNotification userInfo: [AnyHashable: Any],
+                          fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
+    CloudPushSDK.sendNotificationAck(userInfo)
+    completionHandler(.newData)
+  }
+
+  // MARK: - UNUserNotificationCenterDelegate
+
+  /// App 处于前台时收到通知。
+  func userNotificationCenter(_ center: UNUserNotificationCenter,
+                              willPresent notification: UNNotification,
+                              withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
+    DLog("Receive a notification in foreground.")
+    let content = notification.request.content
+    let userInfo = content.userInfo
+
+    var dict: [AnyHashable: Any] = [:]
+    dict["date"] = notification.date
+    dict["title"] = content.title
+    dict["subtitle"] = content.subtitle
+    if let body = content.body as String? { dict["body"] = body }
+    if let badge = content.badge as? NSNumber { dict["badge"] = badge }
+    UIApplication.shared.applicationIconBadgeNumber = content.badge?.intValue ?? 0
+    dict["extras"] = userInfo
+    dict["type"] = ALIYUN_PUSH_TYPE_NOTIFICATION
+
+    sendEventToJs(buildMessage(dict))
+    CloudPushSDK.sendNotificationAck(userInfo)
+
+    completionHandler(content.body.isEmpty ? [] : [.sound, .alert, .badge])
+  }
+
+  /// 用户点击 / 删除 / 自定义 action 回调。
+  func userNotificationCenter(_ center: UNUserNotificationCenter,
+                              didReceive response: UNNotificationResponse,
+                              withCompletionHandler completionHandler: @escaping () -> Void) {
+    DLog("Open/delete a notification.")
+    let content = response.notification.request.content
+    let userInfo = content.userInfo
+
+    var dict: [AnyHashable: Any] = [:]
+    dict["date"] = response.notification.date
+    dict["title"] = content.title
+    dict["subtitle"] = content.subtitle
+    if let body = content.body as String? { dict["body"] = body }
+    if let badge = content.badge as? NSNumber { dict["badge"] = badge }
+    UIApplication.shared.applicationIconBadgeNumber = content.badge?.intValue ?? 0
+    dict["extras"] = userInfo
+    dict["type"] = ALIYUN_PUSH_TYPE_NOTIFICATION
+
+    if response.actionIdentifier == UNNotificationDefaultActionIdentifier {
+      dict["actionIdentifier"] = "opened"
+    } else if response.actionIdentifier == UNNotificationDismissActionIdentifier {
+      dict["actionIdentifier"] = "removed"
+    } else {
+      dict["actionIdentifier"] = response.actionIdentifier
+    }
+
+    sendEventToJs(buildMessage(dict))
+    CloudPushSDK.sendNotificationAck(userInfo)
+    completionHandler()
+  }
+
+  // MARK: - 通道 / 消息监听
+
+  private func listenerOnChannelOpened() {
+    NotificationCenter.default.addObserver(
+      self,
+      selector: #selector(onChannelOpened(_:)),
+      name: NSNotification.Name("CCPDidChannelConnectedSuccess"),
+      object: nil
+    )
+  }
+
+  @objc private func onChannelOpened(_ notification: Notification) {
+    DLog("ChannelOpened.")
+  }
+
+  private func registerMessageReceive() {
+    NotificationCenter.default.addObserver(
+      self,
+      selector: #selector(onMessageReceived(_:)),
+      name: NSNotification.Name("CCPDidReceiveMessageNotification"),
+      object: nil
+    )
+  }
+
+  @objc private func onMessageReceived(_ notification: Notification) {
+    DLog("onMessageReceived.")
+    let data = (notification.object as? [AnyHashable: Any]) ?? [:]
+
+    var dict: [AnyHashable: Any] = [:]
+    if let title = data["title"] { dict["title"] = title }
+    if let body = data["body"] { dict["body"] = body }
+    dict["extras"] = notification.userInfo ?? [:]
+    dict["type"] = ALIYUN_PUSH_TYPE_MESSAGE
+
+    sendEventToJs(buildMessage(dict))
+  }
+
+  // MARK: - 发送事件
+
+  /// 把原生字典组装为 `AliPushMessage` 并分发给 JS 监听器（或缓存首条冷启动消息）。
+  private func sendEventToJs(_ message: AliPushMessage) {
+    DLog("sendEventToJs:")
+    var payload = message
+    payload = withAppState(payload)
+
+    if HybridAliPushPlugin.listeners.isEmpty {
+      if HybridAliPushPlugin.initialNotification == nil {
+        HybridAliPushPlugin.initialNotification = payload
+      }
+      return
+    }
+    for listener in HybridAliPushPlugin.listeners.values {
+      listener(payload)
+    }
+  }
+
+  private func withAppState(_ message: AliPushMessage) -> AliPushMessage {
+    let state: AliPushAppState
+    switch UIApplication.shared.applicationState {
+    case .active: state = .active
+    case .inactive: state = .inactive
+    case .background: state = .background
+    @unknown default: return message
+    }
+    return AliPushMessage(
+      title: message.title,
+      subtitle: message.subtitle,
+      body: message.body,
+      badge: message.badge,
+      extras: message.extras,
+      type: message.type,
+      actionIdentifier: message.actionIdentifier,
+      appState: state,
+      date: message.date
+    )
+  }
+
+  /// 由 `[AnyHashable: Any]` 组装 `AliPushMessage`。
+  private func buildMessage(_ dict: [AnyHashable: Any]) -> AliPushMessage {
+    let title = dict["title"] as? String
+    let subtitle = dict["subtitle"] as? String
+    let body = dict["body"] as? String
+    let badge = (dict["badge"] as? NSNumber)?.doubleValue
+
+    var type: AliPushMessageType?
+    if let rawType = dict["type"] as? String, let t = AliPushMessageType(fromString: rawType) {
+      type = t
+    }
+    let actionIdentifier = dict["actionIdentifier"] as? String
+
+    var appState: AliPushAppState?
+    if let rawState = dict["appState"] as? String, let s = AliPushAppState(fromString: rawState) {
+      appState = s
+    }
+
+    let extras: AnyMap?
+    if let rawExtras = dict["extras"] as? [AnyHashable: Any] {
+      var safe: [String: Any?] = [:]
+      for (k, v) in rawExtras {
+        if let key = k as? String {
+          safe[key] = v
+        }
+      }
+      extras = (try? AnyMap.fromDictionaryIgnoreIncompatible(safe)) ?? nil
+    } else {
+      extras = nil
+    }
+
+    let date: Variant_Double_String?
+    if let rawDate = dict["date"] as? Date {
+      date = .first(rawDate.timeIntervalSince1970)
+    } else if let rawDate = dict["date"] as? String {
+      date = .second(rawDate)
+    } else if let rawDate = dict["date"] as? NSNumber {
+      date = .first(rawDate.doubleValue)
+    } else {
+      date = nil
+    }
+
+    return AliPushMessage(
+      title: title,
+      subtitle: subtitle,
+      body: body,
+      badge: badge,
+      extras: extras,
+      type: type,
+      actionIdentifier: actionIdentifier,
+      appState: appState,
+      date: date
+    )
+  }
+
+  // MARK: - 暴露给 JS 的方法
+
+  func initPush(appKey: String, appSecret: String) throws -> Promise<Void> {
+    // iOS 端初始化在 AppDelegate 中完成，这里直接成功。
+    return Promise.resolved()
+  }
+
+  func getDeviceId() throws -> Promise<String> {
+    return Promise.async {
+      if let deviceId = CloudPushSDK.getDeviceId() {
+        return deviceId
+      } else {
+        throw RuntimeError.error(withMessage: "getDeviceId() failed.")
+      }
+    }
+  }
+
+  func bindAccount(account: String) throws -> Promise<Void> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.bindAccount(account, withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume()
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func unbindAccount() throws -> Promise<Void> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.unbindAccount(withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume()
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func bindTag(target: Double, tags: [String], alias: Variant_NullType_String?) throws -> Promise<Void> {
+    let aliasString: String?
+    if case .second(let s) = alias {
+      aliasString = s
+    } else {
+      aliasString = nil
+    }
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.bindTag(Int(target), withTags: tags, withAlias: aliasString, withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume()
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func unbindTag(target: Double, tags: [String], alias: Variant_NullType_String?) throws -> Promise<Void> {
+    let aliasString: String?
+    if case .second(let s) = alias {
+      aliasString = s
+    } else {
+      aliasString = nil
+    }
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.unbindTag(Int(target), withTags: tags, withAlias: aliasString, withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume()
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func listTags(target: Double) throws -> Promise<String> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.listTags(Int(target), withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume(returning: res.data as? String ?? "")
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func addAlias(alias: String) throws -> Promise<Void> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.addAlias(alias, withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume()
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func removeAlias(alias: String) throws -> Promise<Void> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.removeAlias(alias, withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume()
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func listAliases() throws -> Promise<String> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        CloudPushSDK.listAliases(withCallback: { res in
+          if let res = res, res.success {
+            continuation.resume(returning: res.data as? String ?? "")
+          } else {
+            let err = res?.error
+            continuation.resume(throwing: RuntimeError.error(
+              withMessage: err?.localizedDescription ?? "unknown error"))
+          }
+        })
+      }
+    }
+  }
+
+  func setApplicationIconBadgeNumber(badge: Double) throws -> Promise<Void> {
+    return Promise.async {
+      UIApplication.shared.applicationIconBadgeNumber = Int(badge)
+    }
+  }
+
+  func getApplicationIconBadgeNumber() throws -> Promise<Double> {
+    return Promise.resolved(withResult: Double(UIApplication.shared.applicationIconBadgeNumber))
+  }
+
+  func getInitialMessage() throws -> Promise<Variant_NullType_AliPushMessage> {
+    if let cached = HybridAliPushPlugin.initialNotification {
+      HybridAliPushPlugin.initialNotification = nil
+      return Promise.resolved(withResult: .second(cached))
+    }
+    return Promise.resolved(withResult: .first(NullType.null))
+  }
+
+  func getAuthorizationStatus() throws -> Promise<Bool> {
+    return Promise.async {
+      try await withCheckedThrowingContinuation { continuation in
+        if #available(iOS 10.0, *) {
+          UNUserNotificationCenter.current().getNotificationSettings { settings in
+            continuation.resume(returning: settings.authorizationStatus == .authorized)
+          }
+        } else {
+          continuation.resume(returning: true)
+        }
+      }
+    }
+  }
+
+  func syncBadgeNum(badge: Double) throws -> Promise<Void> {
+    return Promise.async {
+      CloudPushSDK.syncBadgeNum(Int(badge))
+    }
+  }
+
+  func addListener(listener: @escaping (AliPushMessage) -> Void) throws -> () -> Void {
+    let id = UUID()
+    HybridAliPushPlugin.listeners[id] = listener
+    if let cached = HybridAliPushPlugin.initialNotification {
+      HybridAliPushPlugin.initialNotification = nil
+      listener(cached)
+    }
+    return {
+      HybridAliPushPlugin.listeners.removeValue(forKey: id)
+    }
+  }
+}

package/lib/index.d.ts

@@ -0,0 +1,195 @@
+import { ALI_PUSH_EVENT } from './types';
+import type { AliPushEvent, AliPushMessage, AliPushTagTarget } from './types';
+/**
+ * 初始化阿里云推送。
+ *
+ * @remarks
+ * **Android**：调用此方法并通过 `appKey` / `appSecret` 向阿里云推送服务注册应用，
+ * 必须在 `App` 挂载前调用。需要在 `AndroidManifest.xml` 中配置推送 `AppKey` /
+ * `AppSecret`（见 README）。
+ *
+ * **iOS**：推送初始化在原生 `AppDelegate` 中通过 `CloudPushSDK` 完成，此方法在
+ * iOS 上为无操作。
+ *
+ * @param appKey - 阿里云推送控制台分配的 AppKey。
+ * @param appSecret - 阿里云推送控制台分配的 AppSecret。
+ * @returns 初始化完成的 Promise。
+ *
+ * @example
+ * ```ts
+ * await AliPush.initPush('your_app_key', 'your_app_secret');
+ * ```
+ */
+export declare function initPush(appKey: string, appSecret: string): Promise<void>;
+/**
+ * 获取设备唯一标识 `deviceId`。
+ *
+ * @returns 解析为设备 `deviceId` 字符串的 Promise。
+ *
+ * @example
+ * ```ts
+ * const deviceId = await AliPush.getDeviceId();
+ * console.log(deviceId);
+ * ```
+ */
+export declare function getDeviceId(): Promise<string>;
+/**
+ * 绑定账号。
+ *
+ * @param account - 待绑定的账号（字符串，长度建议 ≤ 64）。
+ * @returns 操作完成的 Promise。
+ */
+export declare function bindAccount(account: string): Promise<void>;
+/**
+ * 解绑账号（解绑当前已绑定账号）。
+ *
+ * @returns 操作完成的 Promise。
+ */
+export declare function unbindAccount(): Promise<void>;
+/**
+ * 绑定标签。
+ *
+ * @param target - 目标类型：`1` 设备 / `2` 账号 / `3` 别名。
+ * @param tags - 标签数组（字符串）。
+ * @param alias - 别名（可空，仅 `target = 3` 时生效）。
+ * @returns 操作完成的 Promise。
+ *
+ * @example
+ * ```ts
+ * await AliPush.bindTag(1, ['news', 'sports'], null);
+ * ```
+ */
+export declare function bindTag(target: AliPushTagTarget, tags: string[], alias: string | null): Promise<void>;
+/**
+ * 解绑标签。参数语义同 {@link bindTag}。
+ *
+ * @param target - 目标类型：`1` 设备 / `2` 账号 / `3` 别名。
+ * @param tags - 待解绑的标签数组。
+ * @param alias - 别名（可空）。
+ * @returns 操作完成的 Promise。
+ */
+export declare function unbindTag(target: AliPushTagTarget, tags: string[], alias: string | null): Promise<void>;
+/**
+ * 列出当前已绑定的标签。
+ *
+ * @param target - 目标类型：`1` 设备 / `2` 账号 / `3` 别名。
+ * @returns 解析为服务端响应字符串（含标签列表）的 Promise。
+ */
+export declare function listTags(target: AliPushTagTarget): Promise<string>;
+/**
+ * 添加别名。
+ *
+ * @param alias - 待添加的别名。
+ * @returns 操作完成的 Promise。
+ */
+export declare function addAlias(alias: string): Promise<void>;
+/**
+ * 移除别名。
+ *
+ * @param alias - 待移除的别名。
+ * @returns 操作完成的 Promise。
+ */
+export declare function removeAlias(alias: string): Promise<void>;
+/**
+ * 列出当前已添加的别名。
+ *
+ * @returns 解析为服务端响应字符串（含别名列表）的 Promise。
+ */
+export declare function listAliases(): Promise<string>;
+/**
+ * 设置应用角标（桌面图标右上角数字）。
+ *
+ * @param badge - 角标数字，`0` 表示清除。
+ * @returns 操作完成的 Promise。
+ */
+export declare function setApplicationIconBadgeNumber(badge: number): Promise<void>;
+/**
+ * 获取应用当前角标数字。
+ *
+ * @returns 解析为当前角标数字的 Promise。
+ */
+export declare function getApplicationIconBadgeNumber(): Promise<number>;
+/**
+ * 获取 App 冷启动（被通知唤起）时缓存的首条推送消息。
+ *
+ * @remarks
+ * 当 App 完全退出后被通知点击唤起，JS 尚未完成订阅的窗口期内到达的消息会被原生端
+ * 缓存，待 JS 就绪后通过此方法或 {@link ALI_PUSH_EVENT} 事件返回。
+ *
+ * @returns 缓存消息对象，无则 `null`。
+ */
+export declare function getInitialMessage(): Promise<AliPushMessage | null>;
+/**
+ * 获取 iOS 通知授权状态。
+ *
+ * @remarks Android 平台固定返回 `true`（Android 不做通知权限前置拦截）。
+ *
+ * @returns 解析为是否已授权的布尔值 Promise。
+ */
+export declare function getAuthorizationStatus(): Promise<boolean>;
+/**
+ * 将角标数字同步到阿里云服务端。
+ *
+ * @remarks 仅 iOS 有效，Android 为无操作。
+ *
+ * @param badge - 角标数字。
+ * @returns 操作完成的 Promise。
+ */
+export declare function syncBadgeNum(badge: number): Promise<void>;
+/**
+ * 订阅推送消息事件。
+ *
+ * @param event - 事件名，本库仅支持 {@link ALI_PUSH_EVENT}（`'aliyunPushReceived'`）。
+ * @param listener - 回调，参数为 {@link AliPushMessage}。
+ * @returns 退订函数，调用即可取消该监听。
+ *
+ * @example
+ * ```ts
+ * const unsubscribe = AliPush.addEventListener('aliyunPushReceived', (msg) => {
+ *   console.log('收到推送', msg.title, msg.body);
+ * });
+ * // 不再需要时
+ * unsubscribe();
+ * ```
+ */
+export declare function addEventListener(event: AliPushEvent, listener: (message: AliPushMessage) => void): () => void;
+/**
+ * 取消订阅推送消息事件。
+ *
+ * @param unsubscribe - {@link addEventListener} 返回的退订函数。
+ *
+ * @example
+ * ```ts
+ * AliPush.removeEventListener(unsubscribe);
+ * ```
+ */
+export declare function removeEventListener(unsubscribe: () => void): void;
+/**
+ * 默认导出对象（同时支持具名与默认导入）。
+ *
+ * @public
+ */
+declare const AliPush: {
+    initPush: typeof initPush;
+    getDeviceId: typeof getDeviceId;
+    bindAccount: typeof bindAccount;
+    unbindAccount: typeof unbindAccount;
+    bindTag: typeof bindTag;
+    unbindTag: typeof unbindTag;
+    listTags: typeof listTags;
+    addAlias: typeof addAlias;
+    removeAlias: typeof removeAlias;
+    listAliases: typeof listAliases;
+    setApplicationIconBadgeNumber: typeof setApplicationIconBadgeNumber;
+    getApplicationIconBadgeNumber: typeof getApplicationIconBadgeNumber;
+    getInitialMessage: typeof getInitialMessage;
+    getAuthorizationStatus: typeof getAuthorizationStatus;
+    syncBadgeNum: typeof syncBadgeNum;
+    addEventListener: typeof addEventListener;
+    removeEventListener: typeof removeEventListener;
+    /** 事件名常量，便于 `addEventListener(AliPush.ALI_PUSH_EVENT, ...)`。 */
+    ALI_PUSH_EVENT: "aliyunPushReceived";
+};
+export { ALI_PUSH_EVENT };
+export type { AliPushEvent, AliPushMessage, AliPushTagTarget };
+export default AliPush;