fix(ios): implement push notification handling and add docs (#9)

* fix(ios): implement push notification handling and add docs

- receivePush now calls Intercom.handlePushNotification() so tapping
  a notification opens the conversation (was a no-op before)
- Dispatch Intercom SDK calls to main thread to avoid UI-on-background
  thread crashes
- Add iOS push notification setup docs to README covering Info.plist,
  AppDelegate, and JS-side registration/tap handling

* fix(ios): decode APNs hex token to raw bytes for Intercom

The previous implementation used token.data(using: .utf8) which treated
the hex string as UTF-8 text. APNs device tokens are hex-encoded and
must be decoded to raw Data bytes. Added Data(hexString:) initializer
to properly decode the token, with error handling for invalid hex strings
and main thread dispatch for Intercom SDK calls.

* style: fix prettier formatting in IntercomInitProvider.java

Author: WcaleNieWolny

README.md

@@ -65,6 +65,80 @@ Alternatively, you can initialize at runtime using `loadWithKeys()`.
 
 The Intercom iOS SDK (`~> 19.0`) is included automatically via CocoaPods or Swift Package Manager.
 
+#### Push Notifications
+
+1. **Disable Intercom's auto push integration** — Add this to your `Info.plist` to prevent conflicts with Capacitor's push handling:
+
+```xml
+<key>IntercomAutoIntegratePushNotifications</key>
+<false/>
+```
+
+2. **Forward the device token to Capacitor** — In your `AppDelegate.swift`:
+
+```swift
+import UIKit
+import Capacitor
+
+@UIApplicationMain
+class AppDelegate: UIResponder, UIApplicationDelegate {
+
+    var window: UIWindow?
+
+    func application(_ application: UIApplication,
+                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        return true
+    }
+
+    func application(_ application: UIApplication,
+                     didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+        // Forward to Capacitor — the plugin's observer picks this up
+        // and sends the token to Intercom automatically
+        NotificationCenter.default.post(
+            name: .capacitorDidRegisterForRemoteNotifications,
+            object: deviceToken
+        )
+    }
+
+    func application(_ application: UIApplication,
+                     didFailToRegisterForRemoteNotificationsWithError error: Error) {
+        NotificationCenter.default.post(
+            name: .capacitorDidFailToRegisterForRemoteNotifications,
+            object: error
+        )
+    }
+}
+```
+
+3. **Register for push and handle notification taps** — In your app's JavaScript:
+
+```typescript
+import { PushNotifications } from '@capacitor/push-notifications';
+import { CapgoIntercom as Intercom } from '@capgo/capacitor-intercom';
+
+// Request permission + register
+const perm = await PushNotifications.requestPermissions();
+if (perm.receive === 'granted') {
+  await PushNotifications.register();
+}
+
+// Auto-forward FCM token to Intercom
+PushNotifications.addListener('registration', async (token) => {
+  await Intercom.sendPushTokenToIntercom({ value: token.value });
+});
+
+// When user taps a notification, tell Intercom to open the conversation
+PushNotifications.addListener('pushNotificationActionPerformed', async (action) => {
+  const data = action.notification?.data;
+  // iOS uses 'intercom_push_type', Android uses 'receiver'
+  if (data?.intercom_push_type || data?.receiver === 'intercom_sdk') {
+    await Intercom.receivePush(data);
+  }
+});
+```
+
+> **Note:** The plugin automatically registers the APNs device token with Intercom when it detects `.capacitorDidRegisterForRemoteNotifications`. You must still upload your APNs Authentication Key (`.p8`) in the Firebase Console under **Project Settings → Cloud Messaging → APNs Authentication Key**.
+
 ### Android
 
 The Intercom Android SDK (`17.4.2`) is included automatically via Gradle.

android/src/main/java/app/capgo/capacitor/intercom/IntercomInitProvider.java

@@ -68,13 +68,27 @@ public boolean onCreate() {
     }
 
     @Override
-    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { return null; }
+    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
+        return null;
+    }
+
     @Override
-    public String getType(Uri uri) { return null; }
+    public String getType(Uri uri) {
+        return null;
+    }
+
     @Override
-    public Uri insert(Uri uri, ContentValues values) { return null; }
+    public Uri insert(Uri uri, ContentValues values) {
+        return null;
+    }
+
     @Override
-    public int delete(Uri uri, String selection, String[] selectionArgs) { return 0; }
+    public int delete(Uri uri, String selection, String[] selectionArgs) {
+        return 0;
+    }
+
     @Override
-    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { return 0; }
+    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
+        return 0;
+    }
 }

ios/Sources/CapgoIntercomPlugin/CapgoIntercomPlugin.swift

@@ -2,6 +2,32 @@ import Foundation
 import Capacitor
 import Intercom
 
+private extension Data {
+    init?(hexString: String) {
+        let hex = hexString.replacingOccurrences(of: ["<", ">", " "], with: "")
+        guard hex.count.isMultiple(of: 2) else { return nil }
+        var data = Data(capacity: hex.count / 2)
+        var index = hex.startIndex
+        while index < hex.endIndex {
+            let nextIndex = hex.index(index, offsetBy: 2)
+            guard let byte = UInt8(hex[index..<nextIndex], radix: 16) else { return nil }
+            data.append(byte)
+            index = nextIndex
+        }
+        self = data
+    }
+}
+
+private extension String {
+    func replacingOccurrences(of targets: [String], with replacement: String) -> String {
+        var result = self
+        for target in targets {
+            result = result.replacingOccurrences(of: target, with: replacement)
+        }
+        return result
+    }
+}
+
 @objc(CapgoIntercomPlugin)
 public class CapgoIntercomPlugin: CAPPlugin, CAPBridgedPlugin {
     public let identifier = "CapgoIntercomPlugin"
@@ -355,13 +381,23 @@ public class CapgoIntercomPlugin: CAPPlugin, CAPBridgedPlugin {
             return
         }
 
-        if let tokenData = token.data(using: .utf8) {
+        guard let tokenData = Data(hexString: token) else {
+            call.reject("Invalid hex token string")
+            return
+        }
+        DispatchQueue.main.async {
             Intercom.setDeviceToken(tokenData, completion: nil)
         }
         call.resolve()
     }
 
     @objc func receivePush(_ call: CAPPluginCall) {
+        let userInfo = call.options as? [AnyHashable: Any] ?? [:]
+        DispatchQueue.main.async {
+            if Intercom.isIntercomPushNotification(userInfo) {
+                Intercom.handlePushNotification(userInfo)
+            }
+        }
         call.resolve()
     }