@fishjam-cloud/ios-expo-voip 0.29.0

package/README.md

@@ -0,0 +1,61 @@
+# @fishjam-cloud/ios-expo-voip
+
+iOS AppDelegate glue for [Fishjam](https://fishjam.io) VoIP. Install it alongside
+`@fishjam-cloud/react-native-client` when you enable VoIP options in the Fishjam config plugin.
+
+It contains no JavaScript and no VoIP logic of its own — just an
+[`ExpoAppDelegateSubscriber`](https://docs.expo.dev/modules/appdelegate-subscribers/) that forwards
+two AppDelegate events into the Fishjam SDK:
+
+- `didFinishLaunchingWithOptions` → starts the PushKit registry at launch, so VoIP pushes delivered
+  before the JS bundle loads (cold start) can still report an incoming call
+- `application(_:continue:restorationHandler:)` → routes Siri and Phone-app Recents call intents
+  (`INStartCallIntent`) into the SDK
+
+## Installation
+
+```sh
+npx expo install @fishjam-cloud/ios-expo-voip
+```
+
+That's it — Expo autolinking picks the module up during `pod install`. The subscriber only
+activates when the `FishjamVoIPEnabled` Info.plist flag is present, which the
+`@fishjam-cloud/react-native-client` config plugin writes automatically when `voip` options are
+set. Apps that install this package without enabling VoIP get a no-op.
+
+### Also required: the `aps-environment` entitlement
+
+This package arms `PKPushRegistry` at launch, but iOS only issues a VoIP token to an app that
+declares the push entitlement. Without it registration silently never completes — no token, no
+incoming calls — even though this subscriber ran correctly. Add it in `app.json`:
+
+```json
+{
+  "expo": {
+    "ios": {
+      "entitlements": { "aps-environment": "development" }
+    }
+  }
+}
+```
+
+Use `"production"` for TestFlight / App Store builds, and make sure Push Notifications is
+enabled for your App ID in the Apple Developer portal. VoIP pushes are never delivered to the
+iOS Simulator; test on a real device.
+
+## Bare React Native (no Expo Modules)
+
+If your app does not use `ExpoAppDelegate`, wire the two calls manually in your `AppDelegate`:
+
+```swift
+// in application(_:didFinishLaunchingWithOptions:)
+VoIPManager.registerForVoIPPushes()
+
+// in application(_:continue:restorationHandler:)
+if VoIPManager.handleContinueUserActivity(userActivity) {
+  return true
+}
+```
+
+Android needs no equivalent — everything is handled declaratively via the manifest by the config
+plugin.

package/expo-module.config.json

@@ -0,0 +1,6 @@
+{
+  "platforms": ["apple"],
+  "apple": {
+    "appDelegateSubscribers": ["VoIPAppDelegateSubscriber"]
+  }
+}

package/ios/FishjamExpoVoip.podspec

@@ -0,0 +1,20 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'FishjamExpoVoip'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.license        = package['license']
+  s.author         = { 'Fishjam Cloud' => 'https://github.com/fishjam-cloud' }
+  s.homepage       = package['homepage']
+  s.source         = { :git => 'https://github.com/fishjam-cloud/web-client-sdk.git', :tag => s.version.to_s }
+  s.platforms      = { :ios => '15.1' }
+  s.swift_version  = '5.0'
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'FishjamReactNativeWebrtc'
+
+  s.source_files = '**/*.swift'
+end

package/ios/VoIPAppDelegateSubscriber.swift

@@ -0,0 +1,38 @@
+import ExpoModulesCore
+import FishjamReactNativeWebrtc
+import UIKit
+
+/// Forwards the two AppDelegate events Fishjam VoIP needs into the SDK:
+/// - app launch -> start the PushKit registry (required before JS loads so
+///   cold-start VoIP pushes can report an incoming call)
+/// - Phone-app Recents call intents -> `VoIPManager`
+///
+/// Gated by the `FishjamVoIPEnabled` Info.plist flag, which the
+/// `@fishjam-cloud/react-native-client` config plugin writes when VoIP
+/// options are enabled, without it this subscriber does nothing.
+public class VoIPAppDelegateSubscriber: ExpoAppDelegateSubscriber {
+  private var voipEnabled: Bool {
+    Bundle.main.object(forInfoDictionaryKey: "FishjamVoIPEnabled") as? Bool ?? false
+  }
+
+  public func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
+  ) -> Bool {
+    if voipEnabled {
+      VoIPManager.registerForVoIPPushes()
+    }
+    return true
+  }
+
+  public func application(
+    _ application: UIApplication,
+    continue userActivity: NSUserActivity,
+    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
+  ) -> Bool {
+    guard voipEnabled, userActivity.activityType.hasPrefix("INStart") else {
+      return false
+    }
+    return VoIPManager.handleContinueUserActivity(userActivity)
+  }
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@fishjam-cloud/ios-expo-voip",
+  "version": "0.29.0",
+  "description": "AppDelegate glue for Fishjam VoIP on iOS — registers PushKit at launch and routes Siri/Recents call intents. Install alongside @fishjam-cloud/react-native-client when VoIP options are enabled.",
+  "license": "Apache-2.0",
+  "author": "Fishjam Team",
+  "files": [
+    "ios/**",
+    "expo-module.config.json",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fishjam-cloud/web-client-sdk.git",
+    "directory": "packages/ios-expo-voip"
+  },
+  "homepage": "https://github.com/fishjam-cloud/web-client-sdk#readme",
+  "bugs": "https://github.com/fishjam-cloud/web-client-sdk/issues",
+  "keywords": [
+    "voip",
+    "callkit",
+    "pushkit",
+    "expo",
+    "fishjam"
+  ],
+  "scripts": {
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:webrtc-published": "node ../../release-automation/check-webrtc-published.mjs"
+  },
+  "peerDependencies": {
+    "@fishjam-cloud/react-native-webrtc": "0.29.0",
+    "expo": "*"
+  },
+  "packageManager": "yarn@4.16.0"
+}