expo-invoke 1.0.0

package/ios/Notifications/NotificationActionHandler.swift

@@ -0,0 +1,80 @@
+import Foundation
+import UserNotifications
+
+/// Registers UNNotificationCategory entries from the notificationActions config.
+/// Called once at app launch (auto-called by the generated AppDelegate extension).
+public struct NotificationActionHandler {
+
+  public static func registerCategories(from configJson: String) {
+    guard let data = configJson.data(using: .utf8),
+          let config = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+          let categories = config["notificationActions"] as? [[String: Any]] else { return }
+
+    var unCategories = Set<UNNotificationCategory>()
+
+    for category in categories {
+      guard let categoryId = category["categoryId"] as? String,
+            let actions = category["actions"] as? [[String: Any]] else { continue }
+
+      let unActions: [UNNotificationAction] = actions.compactMap { action in
+        guard let id = action["id"] as? String,
+              let title = action["title"] as? String else { return nil }
+
+        var options: UNNotificationActionOptions = []
+        if action["foreground"] as? Bool == true { options.insert(.foreground) }
+        if action["destructive"] as? Bool == true { options.insert(.destructive) }
+
+        return UNNotificationAction(
+          identifier: id,
+          title: title,
+          options: options
+        )
+      }
+
+      unCategories.insert(UNNotificationCategory(
+        identifier: categoryId,
+        actions: unActions,
+        intentIdentifiers: [],
+        options: []
+      ))
+    }
+
+    UNUserNotificationCenter.current().setNotificationCategories(unCategories)
+  }
+
+  /// Call from your UNUserNotificationCenterDelegate didReceive response handler.
+  public static func handleResponse(
+    categoryIdentifier: String,
+    actionIdentifier: String,
+    configJson: String
+  ) {
+    guard let data = configJson.data(using: .utf8),
+          let config = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+          let categories = config["notificationActions"] as? [[String: Any]] else { return }
+
+    for category in categories {
+      guard (category["categoryId"] as? String) == categoryIdentifier,
+            let actions = category["actions"] as? [[String: Any]] else { continue }
+
+      if actionIdentifier == UNNotificationDefaultActionIdentifier {
+        // Body tap — use tapIntent
+        if let tapIntentId = category["tapIntent"] as? String {
+          ExpoInvokeModule.writePendingIntent(
+            intentId: tapIntentId,
+            source: "notification_tap"
+          )
+        }
+        return
+      }
+
+      if let action = actions.first(where: { $0["id"] as? String == actionIdentifier }),
+         let intentId = action["intentId"] as? String {
+        ExpoInvokeModule.writePendingIntent(
+          intentId: intentId,
+          source: "notification"
+        )
+      }
+      return
+    }
+  }
+}

package/ios/Shortcuts/DonationManager.swift

@@ -0,0 +1,44 @@
+import Foundation
+import Intents
+
+public struct DonationManager {
+
+  public static func donate(from json: String) {
+    guard let data = json.data(using: .utf8),
+          let payload = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+          let intentId = payload["intentId"] as? String else { return }
+
+    let title = payload["title"] as? String ?? intentId
+    let intent = buildIntent(title: title, identifier: intentId)
+    let interaction = INInteraction(intent: intent, response: nil)
+    interaction.identifier = "\(intentId)-\(UUID().uuidString)"
+    interaction.groupIdentifier = intentId
+    interaction.donate { error in
+      if let error = error {
+        print("[expo-invoke] Donation failed for \(intentId): \(error)")
+      }
+    }
+  }
+
+  public static func delete(intentId: String) {
+    INInteraction.delete(with: intentId) { _ in }
+  }
+
+  public static func deleteAll() {
+    INInteraction.deleteAll { _ in }
+  }
+
+  private static func buildIntent(title: String, identifier: String) -> INIntent {
+    let intent = INSendMessageIntent(
+      recipients: nil,
+      outgoingMessageType: .outgoingMessageText,
+      content: title,
+      speakableGroupName: INSpeakableString(spokenPhrase: title),
+      conversationIdentifier: identifier,
+      serviceName: Bundle.main.bundleIdentifier,
+      sender: nil,
+      attachments: nil
+    )
+    return intent
+  }
+}

package/ios/Shortcuts/ShortcutsManager.swift

@@ -0,0 +1,32 @@
+import Foundation
+import Intents
+
+public struct ShortcutsManager {
+
+  public static func update(from json: String) {
+    guard let data = json.data(using: .utf8),
+          let items = try? JSONSerialization.jsonObject(with: data) as? [[String: Any]] else { return }
+
+    let shortcuts: [INShortcut] = items.compactMap { item in
+      guard let id = item["id"] as? String,
+            let title = item["title"] as? String else { return nil }
+
+      let activity = NSUserActivity(activityType: "expo.invoke.shortcut.\(id)")
+      activity.title = title
+      activity.userInfo = item
+      activity.isEligibleForSearch = true
+      activity.isEligibleForPrediction = true
+      activity.persistentIdentifier = id
+      if let subtitle = item["subtitle"] as? String {
+        activity.userInfo?["subtitle"] = subtitle
+      }
+      return INShortcut(userActivity: activity)
+    }
+
+    INVoiceShortcutCenter.shared.setShortcutSuggestions(shortcuts)
+  }
+
+  public static func clear() {
+    INVoiceShortcutCenter.shared.setShortcutSuggestions([])
+  }
+}

package/ios/Shortcuts/SpotlightManager.swift

@@ -0,0 +1,48 @@
+import Foundation
+import CoreSpotlight
+import MobileCoreServices
+
+public struct SpotlightManager {
+
+  public static func index(from json: String) {
+    guard let data = json.data(using: .utf8),
+          let items = try? JSONSerialization.jsonObject(with: data) as? [[String: Any]] else { return }
+
+    let searchItems: [CSSearchableItem] = items.compactMap { item in
+      guard let id = item["id"] as? String,
+            let title = item["title"] as? String else { return nil }
+
+      let attrs = CSSearchableItemAttributeSet(contentType: .item)
+      attrs.title = title
+      attrs.contentDescription = item["description"] as? String
+      if let keywords = item["keywords"] as? [String] { attrs.keywords = keywords }
+      if let thumbUrl = item["thumbnailUrl"] as? String,
+         let url = URL(string: thumbUrl) {
+        attrs.thumbnailURL = url
+      }
+
+      // Store intent info in userInfo for retrieval on tap
+      let userInfo: [String: Any] = [
+        "intentId": item["intentId"] as? String ?? "",
+        "intentParameters": item["intentParameters"] ?? [:],
+      ]
+      attrs.userInfo = userInfo as NSDictionary
+
+      return CSSearchableItem(
+        uniqueIdentifier: id,
+        domainIdentifier: Bundle.main.bundleIdentifier,
+        attributeSet: attrs
+      )
+    }
+
+    CSSearchableIndex.default().indexSearchableItems(searchItems) { error in
+      if let error = error {
+        print("[expo-invoke] Spotlight indexing error: \(error)")
+      }
+    }
+  }
+
+  public static func deindex(ids: [String]) {
+    CSSearchableIndex.default().deleteSearchableItems(withIdentifiers: ids) { _ in }
+  }
+}

package/ios/Widget/WidgetManager.swift

@@ -0,0 +1,19 @@
+import Foundation
+
+/// Triggers a reload of all WidgetKit widget timelines so they display fresh data
+/// after setWidgetData() is called.
+public struct WidgetManager {
+  @available(iOS 14.0, *)
+  public static func reloadAll() {
+    // WidgetCenter is in WidgetKit — use performSelector to avoid hard linking
+    // the framework in packages that don't need it.
+    if let widgetCenter = NSClassFromString("WidgetKit.WidgetCenter") as? NSObject.Type,
+       let center = widgetCenter.value(forKey: "shared") as? NSObject {
+      center.performSelector(inBackground: #selector(NSObject.reloadAllTimelines), with: nil)
+    }
+  }
+}
+
+extension NSObject {
+  @objc func reloadAllTimelines() {}
+}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "expo-invoke",
+  "version": "1.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": {
+    ".": {
+      "require": "./build/src/index.js",
+      "import": "./build/src/index.js",
+      "types": "./build/src/index.d.ts"
+    }
+  },
+  "expo": {
+    "plugin": "./build/plugin/src/withInvoke"
+  },
+  "files": [
+    "build",
+    "ios",
+    "android/src",
+    "android/build.gradle",
+    "expo-module.config.json",
+    "README.md",
+    "MIGRATION.md",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.node.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.node.json --noEmit",
+    "clean": "rm -rf build",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "jest"
+  },
+  "bin": {
+    "expo-invoke": "./build/cli/index.js"
+  },
+  "keywords": [
+    "expo",
+    "react-native",
+    "siri",
+    "app-intents",
+    "google-assistant",
+    "app-actions",
+    "shortcuts",
+    "voice",
+    "widget",
+    "widgetkit",
+    "dynamic-island",
+    "live-activities",
+    "nfc",
+    "deep-link",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smarthivelabs/expo-invoke"
+  },
+  "bugs": {
+    "url": "https://github.com/smarthivelabs/expo-invoke/issues"
+  },
+  "homepage": "https://github.com/smarthivelabs/expo-invoke#readme",
+  "author": "SmartHive Labs",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "expo": ">=50.0.0",
+    "expo-modules-core": ">=1.12.0",
+    "react": ">=18.0.0",
+    "react-native": ">=0.73.0"
+  },
+  "peerDependenciesMeta": {
+    "expo-live-activity": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@expo/config-plugins": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.19.41",
+    "@types/react": "^19.2.16",
+    "@types/react-native": "^0.73.0",
+    "expo-modules-core": "^56.0.14",
+    "jest": "^29.0.0",
+    "react": "^18.3.1",
+    "react-native": "^0.73.11",
+    "ts-jest": "^29.4.11",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "moduleNameMapper": {
+      "^react-native$": "<rootDir>/node_modules/react-native/jest/setup.js",
+      "^expo-modules-core$": "<rootDir>/__mocks__/expo-modules-core.ts"
+    },
+    "testMatch": [
+      "**/__tests__/**/*.test.ts"
+    ]
+  }
+}