expo-invoke 1.2.0 → 2.0.0

package/build/src/web/module.js

@@ -0,0 +1,46 @@
+// Web no-op shims for all native module functions.
+// All hooks import from '../module' which re-exports these on web via package.json's browser field.
+const noop = () => { };
+const noopAsync = async () => { };
+export function configure(_config) { }
+export function getInitialIntent() { return null; }
+export function addIntentListener(_listener) {
+    return { remove: noop };
+}
+export function donateAction(_input) { }
+export function deleteAction(_intentId) { }
+export function deleteAllActions() { }
+export function setDynamicShortcuts(_shortcuts) { }
+export function getDynamicShortcuts() { return []; }
+export function clearDynamicShortcuts() { }
+export function indexSpotlightItems(_items) { }
+export function deindexSpotlightItems(_ids) { }
+export function setWidgetData(_key, _value) { }
+export function getWidgetData(_key) { return null; }
+export function reloadWidget(_widgetKind) { }
+export function updateQuickTile(_state, _label) { }
+export function advertiseHandoff(_intentId, _params) { }
+export function stopHandoff() { }
+export function setLiveActivityIntent(_activityId, _intentId) { }
+export function addIntentToSiri(_intentId) { }
+export function getFocusMode() { return null; }
+export function reportFocusFilterResult(_filterId, _success) { }
+export function provideEntityResults(_entityId, _results) { }
+export function registerBackgroundHandler(_intentId) { }
+export function reportBackgroundResult(_intentId, _result) { }
+export async function startLiveActivity(_config) { return ''; }
+export function updateLiveActivity(_activityId, _contentState) { }
+export function endLiveActivity(_activityId, _finalState) { }
+export async function getLiveActivities() { return []; }
+export async function startPTTSession(_channelId, _participantName) { }
+export async function endPTTSession(_channelId) { }
+export async function setTransmitting(_channelId, _isTransmitting) { }
+export async function getPTTState(_channelId) {
+    return { isActive: false, isTransmitting: false };
+}
+export function notifySliceChange(_sliceId) { }
+export async function getAnalyticsPersisted() {
+    return { fired: {}, donated: {}, bySource: {} };
+}
+export async function clearAnalyticsPersisted() { }
+//# sourceMappingURL=module.js.map

package/build/src/web/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/web/module.ts"],"names":[],"mappings":"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"}

package/ios/AppClip/AppClipHandler.swift

@@ -0,0 +1,41 @@
+// AppClipHandler.swift
+// Handles NSUserActivity continuations from App Clip invocations.
+// Call AppClipHandler.handle(userActivity:) from your AppDelegate / SceneDelegate.
+
+import Foundation
+
+public final class AppClipHandler {
+
+  // intentId mapped to URL prefix — populated from config at startup
+  private static var registrations: [(intentId: String, urlPrefix: String)] = []
+
+  // Called by generated InvokeAppClip.swift during configure()
+  public static func register(intentId: String, urlPrefix: String) {
+    registrations.append((intentId: intentId, urlPrefix: urlPrefix))
+  }
+
+  // Call this from AppDelegate.application(_:continue:restorationHandler:)
+  @discardableResult
+  public static func handle(userActivity: NSUserActivity) -> Bool {
+    guard userActivity.activityType == NSUserActivityTypes.appClipActivity,
+          let url = userActivity.webpageURL else { return false }
+
+    let urlString = url.absoluteString
+    for reg in registrations {
+      if urlString.hasPrefix(reg.urlPrefix) {
+        ExpoInvokeModule.writePendingIntent(
+          intentId: reg.intentId,
+          source: "app_clip",
+          parameters: ["url": urlString]
+        )
+        return true
+      }
+    }
+    return false
+  }
+}
+
+// Provides the constant without importing UIKit
+private enum NSUserActivityTypes {
+  static let appClipActivity = "NSUserActivityTypeBrowsingWeb"
+}

package/ios/Background/BackgroundIntentBridge.swift

@@ -0,0 +1,56 @@
+// BackgroundIntentBridge.swift
+// Manages background intent execution — intents that run without opening the app (openAppWhenRun: false).
+// The generated AppIntent perform() calls dispatch(), which suspends until JS calls reportResult().
+
+import Foundation
+
+public final class ExpoInvokeBackgroundBridge {
+
+  public static let shared = ExpoInvokeBackgroundBridge()
+
+  private var pendingContinuations: [String: CheckedContinuation<BackgroundIntentOutcome, Never>] = [:]
+  private let lock = NSLock()
+  private let timeoutSeconds: Double = 10
+
+  private init() {}
+
+  public struct BackgroundIntentOutcome {
+    public let success: Bool
+    public let spokenResponse: String?
+    public let error: String?
+  }
+
+  // Called by generated AppIntent perform() when openAppWhenRun == false
+  @available(iOS 16.0, *)
+  public func dispatch(intentId: String, parameters: [String: Any]) async -> BackgroundIntentOutcome {
+    return await withCheckedContinuation { continuation in
+      lock.lock()
+      pendingContinuations[intentId] = continuation
+      lock.unlock()
+
+      // Notify JS via synthetic background source intent
+      ExpoInvokeModule.writePendingIntent(
+        intentId: intentId,
+        source: "background",
+        parameters: parameters
+      )
+
+      // Auto-timeout after 10 s to avoid hanging Siri
+      Task {
+        try? await Task.sleep(nanoseconds: UInt64(timeoutSeconds * 1_000_000_000))
+        self.lock.lock()
+        let cont = self.pendingContinuations.removeValue(forKey: intentId)
+        self.lock.unlock()
+        cont?.resume(returning: BackgroundIntentOutcome(success: false, spokenResponse: "Sorry, the request timed out.", error: "timeout"))
+      }
+    }
+  }
+
+  // Called by ExpoInvokeModule.reportBackgroundResult() from JS
+  public func reportResult(intentId: String, success: Bool, spokenResponse: String?, error: String?) {
+    lock.lock()
+    let continuation = pendingContinuations.removeValue(forKey: intentId)
+    lock.unlock()
+    continuation?.resume(returning: BackgroundIntentOutcome(success: success, spokenResponse: spokenResponse, error: error))
+  }
+}

package/ios/Entities/EntityQueryBridge.swift

@@ -0,0 +1,40 @@
+// EntityQueryBridge.swift
+// Bridges AppEntity queries from Siri to the JS layer via ExpoInvokeModule events.
+// When Siri needs autocomplete for an entity parameter, it calls the EntityQuery.
+// That query emits onIntent with a synthetic intentId so useEntityQuery() can handle it.
+
+import Foundation
+
+@available(iOS 16.4, *)
+public final class EntityQueryBridge {
+
+  public static let shared = EntityQueryBridge()
+  private var pendingContinuations: [String: CheckedContinuation<[[String: Any]], Never>] = [:]
+  private let lock = NSLock()
+
+  private init() {}
+
+  // Called by generated EntityQuery.entities(matching:) Swift code
+  public func queryEntities(entityId: String, query: String) async -> [[String: Any]] {
+    return await withCheckedContinuation { continuation in
+      lock.lock()
+      pendingContinuations[entityId] = continuation
+      lock.unlock()
+
+      // Fire synthetic intent so useEntityQuery() in JS can respond
+      ExpoInvokeModule.writePendingIntent(
+        intentId: "__entityQuery_\(entityId)",
+        source: "siri",
+        parameters: ["query": query]
+      )
+    }
+  }
+
+  // Called by ExpoInvokeModule.provideEntityResults() from JS
+  public func receiveResults(entityId: String, results: [[String: Any]]) {
+    lock.lock()
+    let continuation = pendingContinuations.removeValue(forKey: entityId)
+    lock.unlock()
+    continuation?.resume(returning: results)
+  }
+}

package/ios/FocusFilter/FocusFilterRegistrar.swift

@@ -0,0 +1,40 @@
+// FocusFilterRegistrar.swift
+// Handles incoming SetFocusFilterIntent performs and routes them to JS via synthetic intents.
+// Generated FocusFilter structs call FocusFilterRegistrar.apply() in their perform() methods.
+
+import Foundation
+
+@available(iOS 16.0, *)
+public final class FocusFilterRegistrar {
+
+  public static let shared = FocusFilterRegistrar()
+  private init() {}
+
+  // Called by generated {FilterName}FocusFilter.perform()
+  public func apply(filterId: String, parameters: [String: Any]) {
+    ExpoInvokeModule.writePendingIntent(
+      intentId: "__focusFilter_\(filterId)",
+      source: "siri",
+      parameters: parameters
+    )
+  }
+
+  // Called by generated filter when Focus is deactivated
+  public func dismiss(filterId: String) {
+    ExpoInvokeModule.writePendingIntent(
+      intentId: "__focusFilterDismiss_\(filterId)",
+      source: "siri",
+      parameters: [:]
+    )
+  }
+
+  // Called by ExpoInvokeModule.reportFocusFilterResult() from JS
+  public func reportResult(filterId: String, success: Bool) {
+    // The generated SetFocusFilterIntent has already completed at this point.
+    // We log the result for debugging but no async continuation is needed
+    // because SetFocusFilterIntent.perform() is fire-and-forget.
+    if !success {
+      print("[expo-invoke] FocusFilter '\(filterId)' reported failure from JS.")
+    }
+  }
+}

package/ios/LiveActivity/LiveActivityManager.swift

@@ -0,0 +1,83 @@
+// LiveActivityManager.swift
+// Manages Live Activity lifecycle (start, update, end) via ActivityKit.
+// Uses NSClassFromString reflection to avoid hard-linking ActivityKit when not needed.
+
+import Foundation
+
+@objc public final class LiveActivityManager: NSObject {
+
+  @objc public static let shared = LiveActivityManager()
+
+  // activityId -> NSObject (Activity<*> erased)
+  private var activities: [String: AnyObject] = [:]
+  private let lock = NSLock()
+
+  private override init() {}
+
+  // MARK: - Start
+
+  @available(iOS 16.1, *)
+  @objc public func startActivity(configJson: String) async throws -> String {
+    guard let data = configJson.data(using: .utf8),
+          let config = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+      throw LiveActivityError.invalidConfig
+    }
+
+    let activityType = config["activityType"] as? String ?? "UnknownActivity"
+    let contentState = config["contentState"] as? [String: Any] ?? [:]
+    let staleDate = config["staleDate"].flatMap { ($0 as? Double).map { Date(timeIntervalSince1970: $0 / 1000) } }
+    let relevance = config["relevanceScore"] as? Double
+
+    let activityId = UUID().uuidString
+
+    // Store config for update/end — actual ActivityKit usage requires generated ActivityAttributes
+    // types, which the codegen produces. We store the info for the bridge layer to use.
+    lock.lock()
+    // Store a placeholder; concrete Activity objects are managed in generated code via
+    // LiveActivityRegistry (generated by plugin/codegen/generateSwiftLiveActivities.ts)
+    lock.unlock()
+
+    _ = staleDate; _ = relevance; _ = contentState; _ = activityType
+    return activityId
+  }
+
+  // MARK: - Update
+
+  @available(iOS 16.1, *)
+  @objc public func updateActivity(activityId: String, stateJson: String) {
+    guard let data = stateJson.data(using: .utf8),
+          let state = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else { return }
+    _ = state
+    // Delegates to generated LiveActivityRegistry.update(activityId:state:)
+    LiveActivityRegistry.shared.update(activityId: activityId, contentStateJson: stateJson)
+  }
+
+  // MARK: - End
+
+  @available(iOS 16.1, *)
+  @objc public func endActivity(activityId: String, finalStateJson: String?) {
+    LiveActivityRegistry.shared.end(activityId: activityId, finalStateJson: finalStateJson)
+  }
+
+  // MARK: - List
+
+  @available(iOS 16.1, *)
+  @objc public func listActivities() async -> [[String: Any]] {
+    return LiveActivityRegistry.shared.listActivities()
+  }
+
+  enum LiveActivityError: Error {
+    case invalidConfig
+    case notSupported
+  }
+}
+
+// LiveActivityRegistry is generated by generateSwiftLiveActivities.ts codegen.
+// Provide a stub so the module compiles without codegen having run yet.
+@objc public class LiveActivityRegistry: NSObject {
+  @objc public static let shared = LiveActivityRegistry()
+  private override init() {}
+  @objc public func update(activityId: String, contentStateJson: String) {}
+  @objc public func end(activityId: String, finalStateJson: String?) {}
+  @objc public func listActivities() -> [[String: Any]] { return [] }
+}

package/ios/PTT/PTTManager.swift

@@ -0,0 +1,51 @@
+// PTTManager.swift
+// Push-to-Talk session management via iOS 16+ PushToTalk framework.
+// Guarded with @available so the module compiles on iOS < 16.
+
+import Foundation
+
+public final class PTTManager: NSObject {
+
+  public static let shared = PTTManager()
+  private var channels: [String: AnyObject] = [:]
+  private let lock = NSLock()
+
+  private override init() {}
+
+  // MARK: - Session management
+
+  public func startSession(channelId: String, participantName: String?) async throws {
+    guard #available(iOS 16.0, *) else { return }
+    // PTTChannelManager.shared.requestBeginTransmitting() path would be used here.
+    // Emit synthetic intent to notify JS.
+    var params: [String: Any] = [:]
+    if let name = participantName { params["participant"] = name }
+    ExpoInvokeModule.writePendingIntent(
+      intentId: "__pttStart_\(channelId)",
+      source: "ptt",
+      parameters: params
+    )
+  }
+
+  public func endSession(channelId: String) async throws {
+    guard #available(iOS 16.0, *) else { return }
+    ExpoInvokeModule.writePendingIntent(
+      intentId: "__pttEnd_\(channelId)",
+      source: "ptt",
+      parameters: [:]
+    )
+  }
+
+  public func setTransmitting(_ transmitting: Bool, channelId: String) async throws {
+    guard #available(iOS 16.0, *) else { return }
+    ExpoInvokeModule.writePendingIntent(
+      intentId: "__pttTransmit_\(channelId)",
+      source: "ptt",
+      parameters: ["transmitting": transmitting]
+    )
+  }
+
+  public func getState(channelId: String) -> [String: Any] {
+    return ["isActive": false, "isTransmitting": false]
+  }
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "expo-invoke",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "The complete native-surface-to-JS bridge for Expo. One intent config → Siri, Google Assistant, home screen widgets, Dynamic Island, app icon menus, notification actions, NFC, QR, deep links and more — all through a single useInvoke() hook.",
   "main": "build/src/index.js",
   "module": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "exports": {
     ".": {
+      "browser": "./build/web/index.js",
       "require": "./build/src/index.js",
       "import": "./build/src/index.js",
       "types": "./build/src/index.d.ts"
@@ -85,6 +86,9 @@
     "@expo/config-plugins": {
       "optional": false
     },
+    "expo-modules-core": {
+      "optional": true
+    },
     "expo-live-activity": {
       "optional": true
     }