expo-invoke 1.0.0

package/build/src/utils/validation.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+const VALID_IDENTIFIER = /^[a-z][a-z0-9_]*$/i;
+const MAX_PHRASE_LENGTH = 140;
+const MAX_IOS_SHORTCUTS = 10;
+const MAX_ANDROID_SHORTCUTS = 5;
+function validatePhrase(phrase, intentId) {
+    const errs = [];
+    if (phrase.length > MAX_PHRASE_LENGTH) {
+        errs.push({
+            field: `intents[${intentId}].phrases`,
+            message: `Phrase "${phrase.slice(0, 40)}..." exceeds ${MAX_PHRASE_LENGTH} characters.`,
+        });
+    }
+    if (!phrase.includes('${applicationName}')) {
+        errs.push({
+            field: `intents[${intentId}].phrases`,
+            message: `Phrase "${phrase.slice(0, 60)}" should include \${applicationName} for Siri to locate the app.`,
+        });
+    }
+    return errs;
+}
+function validateIntent(intent) {
+    var _a, _b;
+    const errs = [];
+    if (!VALID_IDENTIFIER.test(intent.id)) {
+        errs.push({
+            field: `intents[${intent.id}].id`,
+            message: `Intent id "${intent.id}" must be a valid identifier (letters, numbers, underscores).`,
+        });
+    }
+    if (!intent.phrases || intent.phrases.length === 0) {
+        errs.push({
+            field: `intents[${intent.id}].phrases`,
+            message: `Intent "${intent.id}" must have at least one voice phrase.`,
+        });
+    }
+    for (const phrase of (_a = intent.phrases) !== null && _a !== void 0 ? _a : []) {
+        errs.push(...validatePhrase(phrase, intent.id));
+    }
+    const params = (_b = intent.parameters) !== null && _b !== void 0 ? _b : [];
+    const paramNames = new Set();
+    for (const param of params) {
+        if (paramNames.has(param.name)) {
+            errs.push({
+                field: `intents[${intent.id}].parameters`,
+                message: `Duplicate parameter name "${param.name}" in intent "${intent.id}".`,
+            });
+        }
+        paramNames.add(param.name);
+        if (!VALID_IDENTIFIER.test(param.name)) {
+            errs.push({
+                field: `intents[${intent.id}].parameters[${param.name}]`,
+                message: `Parameter name "${param.name}" must be a valid identifier.`,
+            });
+        }
+        if (param.type === 'enum') {
+            const optionIds = new Set();
+            for (const opt of param.options) {
+                if (optionIds.has(opt.id)) {
+                    errs.push({
+                        field: `intents[${intent.id}].parameters[${param.name}].options`,
+                        message: `Duplicate enum option id "${opt.id}".`,
+                    });
+                }
+                optionIds.add(opt.id);
+            }
+        }
+    }
+    return errs;
+}
+function validateConfig(config) {
+    var _a;
+    const errors = [];
+    const warnings = [];
+    if (!config.intents || config.intents.length === 0) {
+        errors.push({ field: 'intents', message: 'At least one intent is required.' });
+        return { valid: false, errors, warnings };
+    }
+    // Check for duplicate intent IDs
+    const intentIds = new Set();
+    for (const intent of config.intents) {
+        if (intentIds.has(intent.id)) {
+            errors.push({
+                field: 'intents',
+                message: `Duplicate intent id "${intent.id}".`,
+            });
+        }
+        intentIds.add(intent.id);
+        errors.push(...validateIntent(intent));
+    }
+    // Check for conflicting phrases across intents
+    const phraseMap = new Map();
+    for (const intent of config.intents) {
+        for (const phrase of (_a = intent.phrases) !== null && _a !== void 0 ? _a : []) {
+            const normalized = phrase.toLowerCase().trim();
+            const existing = phraseMap.get(normalized);
+            if (existing) {
+                errors.push({
+                    field: 'intents',
+                    message: `Phrase "${phrase}" is used by both "${existing}" and "${intent.id}".`,
+                });
+            }
+            phraseMap.set(normalized, intent.id);
+        }
+    }
+    // Shortcut count warnings
+    const shortcutIntents = config.intents.filter((i) => i.shortTitle);
+    if (shortcutIntents.length > MAX_IOS_SHORTCUTS) {
+        warnings.push({
+            field: 'intents',
+            message: `${shortcutIntents.length} intents with shortTitle — iOS allows max ${MAX_IOS_SHORTCUTS}.`,
+        });
+    }
+    if (shortcutIntents.length > MAX_ANDROID_SHORTCUTS) {
+        warnings.push({
+            field: 'intents',
+            message: `${shortcutIntents.length} intents with shortTitle — Android allows max ${MAX_ANDROID_SHORTCUTS} launcher shortcuts.`,
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/build/src/utils/validation.js.map

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

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["ExpoInvokeModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.invoke.ExpoInvokeModule"]
+  }
+}

package/ios/Focus/FocusFilterManager.swift

@@ -0,0 +1,19 @@
+import Foundation
+import Intents
+
+/// Reads the currently active iOS Focus mode (Do Not Disturb, Work, Personal, Sleep, etc.).
+/// Returns the display name string or nil if no Focus is active.
+public struct FocusFilterManager {
+  public static func currentFocusMode() -> String? {
+    // INFocusStatusCenter is available iOS 15+
+    if #available(iOS 15, *) {
+      let status = INFocusStatusCenter.default.focusStatus
+      if status.isFocused == true {
+        // System doesn't expose the name directly; return a generic identifier
+        return "focused"
+      }
+      return nil
+    }
+    return nil
+  }
+}

package/ios/Intents/BaseInvokeIntent.swift

@@ -0,0 +1,42 @@
+import AppIntents
+import Foundation
+
+/// Base protocol for App Intents created by expo-invoke consumers.
+///
+/// The config plugin auto-generates a concrete struct for each intent in app.json.
+/// For custom parameter handling, you can override the generated file.
+///
+/// Generated file example (InvokeIntents.swift):
+///
+/// ```swift
+/// @available(iOS 16.4, *)
+/// struct CreateErrandIntent: AppIntent {
+///   static var title: LocalizedStringResource = "Create an Errand"
+///   static var description = IntentDescription("Start a new errand with Mira.")
+///   static var openAppWhenRun: Bool = true
+///
+///   @Parameter(title: "Pickup Location")
+///   var pickup: CLPlacemark?
+///
+///   @Parameter(title: "Errand Type")
+///   var errandType: String?
+///
+///   func perform() async throws -> some IntentResult {
+///     ExpoInvokeModule.writePendingIntent(
+///       intentId: "create_errand",
+///       source: "siri",
+///       parameters: [
+///         "pickup": pickup.map { ["latitude": $0.location?.coordinate.latitude ?? 0,
+///                                 "longitude": $0.location?.coordinate.longitude ?? 0,
+///                                 "name": $0.name ?? ""] } as Any,
+///         "errandType": errandType as Any,
+///       ].compactMapValues { $0 }
+///     )
+///     return .result()
+///   }
+/// }
+/// ```
+@available(iOS 16.4, *)
+public protocol InvokeAppIntent: AppIntent {
+  static var intentId: String { get }
+}

package/ios/Intents/HandoffManager.swift

@@ -0,0 +1,49 @@
+import Foundation
+import UIKit
+
+private var _currentActivity: NSUserActivity?
+
+public struct HandoffManager {
+
+  public static func advertise(intentId: String, paramsJson: String) {
+    let activity = NSUserActivity(activityType: "expo.invoke.handoff.\(intentId)")
+    activity.title = intentId
+    activity.isEligibleForHandoff = true
+    activity.isEligibleForSearch = false
+
+    var userInfo: [String: Any] = ["intentId": intentId, "source": "handoff"]
+    if let data = paramsJson.data(using: .utf8),
+       let params = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
+      userInfo["parameters"] = params
+    }
+    activity.userInfo = userInfo
+
+    // Must be set as the current activity on the key window scene
+    DispatchQueue.main.async {
+      _currentActivity = activity
+      activity.becomeCurrent()
+    }
+  }
+
+  public static func stop() {
+    DispatchQueue.main.async {
+      _currentActivity?.invalidate()
+      _currentActivity = nil
+    }
+  }
+
+  /// Call from AppDelegate application(_:continue:restorationHandler:)
+  public static func handleContinue(userActivity: NSUserActivity) -> Bool {
+    guard userActivity.activityType.hasPrefix("expo.invoke.handoff."),
+          let userInfo = userActivity.userInfo,
+          let intentId = userInfo["intentId"] as? String else { return false }
+
+    let params = userInfo["parameters"] as? [String: Any] ?? [:]
+    ExpoInvokeModule.writePendingIntent(
+      intentId: intentId,
+      source: "handoff",
+      parameters: params
+    )
+    return true
+  }
+}

package/ios/Intents/InvokeActionStore.swift

@@ -0,0 +1,21 @@
+import Foundation
+
+/// Convenience wrapper used by generated App Intent files.
+/// Thin wrapper around ExpoInvokeModule static helpers.
+public struct InvokeActionStore {
+  public static func write(
+    intentId: String,
+    source: String = "siri",
+    parameters: [String: Any] = [:]
+  ) {
+    ExpoInvokeModule.writePendingIntent(
+      intentId: intentId,
+      source: source,
+      parameters: parameters
+    )
+  }
+
+  public static func consume() -> String? {
+    return ExpoInvokeModule.consumePendingIntent()
+  }
+}

package/ios/Intents/InvokeParameterTypes.swift

@@ -0,0 +1,142 @@
+import AppIntents
+import Contacts
+import CoreLocation
+
+// ─── Location Entity ──────────────────────────────────────────────────────────
+
+@available(iOS 16.0, *)
+public struct LocationEntity: AppEntity {
+  public static var typeDisplayRepresentation: TypeDisplayRepresentation = "Location"
+  public static var defaultQuery = LocationEntityQuery()
+
+  public let id: String
+  public let name: String
+  public let latitude: Double
+  public let longitude: Double
+
+  public var displayRepresentation: DisplayRepresentation {
+    DisplayRepresentation(title: "\(name)")
+  }
+
+  public init(id: String, name: String, latitude: Double, longitude: Double) {
+    self.id = id
+    self.name = name
+    self.latitude = latitude
+    self.longitude = longitude
+  }
+
+  public func toJSON() -> [String: Any] {
+    return ["latitude": latitude, "longitude": longitude, "name": name]
+  }
+}
+
+@available(iOS 16.0, *)
+public struct LocationEntityQuery: EntityQuery {
+  public init() {}
+  public func entities(for identifiers: [String]) async throws -> [LocationEntity] { [] }
+}
+
+// ─── Enum Entity ──────────────────────────────────────────────────────────────
+
+@available(iOS 16.0, *)
+public struct EnumEntity: AppEntity {
+  public static var typeDisplayRepresentation: TypeDisplayRepresentation = "Option"
+  public static var defaultQuery = EnumEntityQuery()
+
+  public let id: String
+  public let title: String
+  public let subtitle: String?
+
+  public var displayRepresentation: DisplayRepresentation {
+    if let sub = subtitle {
+      return DisplayRepresentation(title: "\(title)", subtitle: "\(sub)")
+    }
+    return DisplayRepresentation(title: "\(title)")
+  }
+
+  public init(id: String, title: String, subtitle: String? = nil) {
+    self.id = id
+    self.title = title
+    self.subtitle = subtitle
+  }
+}
+
+@available(iOS 16.0, *)
+public struct EnumEntityQuery: EntityQuery {
+  public init() {}
+  public func entities(for identifiers: [String]) async throws -> [EnumEntity] { [] }
+}
+
+// ─── Person Entity ────────────────────────────────────────────────────────────
+
+@available(iOS 16.0, *)
+public struct PersonEntity: AppEntity {
+  public static var typeDisplayRepresentation: TypeDisplayRepresentation = "Person"
+  public static var defaultQuery = PersonEntityQuery()
+
+  public let id: String
+  public let displayName: String
+  public let phoneNumber: String?
+  public let emailAddress: String?
+  public let contactIdentifier: String?
+
+  public var displayRepresentation: DisplayRepresentation {
+    DisplayRepresentation(title: "\(displayName)")
+  }
+
+  public init(
+    id: String,
+    displayName: String,
+    phoneNumber: String? = nil,
+    emailAddress: String? = nil,
+    contactIdentifier: String? = nil
+  ) {
+    self.id = id
+    self.displayName = displayName
+    self.phoneNumber = phoneNumber
+    self.emailAddress = emailAddress
+    self.contactIdentifier = contactIdentifier
+  }
+
+  public func toJSON() -> [String: Any] {
+    var dict: [String: Any] = ["displayName": displayName]
+    if let phone = phoneNumber { dict["phoneNumber"] = phone }
+    if let email = emailAddress { dict["emailAddress"] = email }
+    if let cid = contactIdentifier { dict["contactIdentifier"] = cid }
+    return dict
+  }
+}
+
+@available(iOS 16.0, *)
+public struct PersonEntityQuery: EntityQuery {
+  public init() {}
+  public func entities(for identifiers: [String]) async throws -> [PersonEntity] { [] }
+}
+
+// ─── Date Entity ──────────────────────────────────────────────────────────────
+
+@available(iOS 16.0, *)
+public struct DateEntity: AppEntity {
+  public static var typeDisplayRepresentation: TypeDisplayRepresentation = "Date"
+  public static var defaultQuery = DateEntityQuery()
+
+  public let id: String
+  public let date: Date
+
+  public var displayRepresentation: DisplayRepresentation {
+    let formatter = DateFormatter()
+    formatter.dateStyle = .medium
+    return DisplayRepresentation(title: "\(formatter.string(from: date))")
+  }
+
+  public init(id: String, date: Date) {
+    self.id = id
+    self.date = date
+  }
+}
+
+@available(iOS 16.0, *)
+public struct DateEntityQuery: EntityQuery {
+  public init() {}
+  public func entities(for identifiers: [String]) async throws -> [DateEntity] { [] }
+}

package/ios/LiveActivity/LiveActivityIntentBridge.swift

@@ -0,0 +1,44 @@
+import AppIntents
+import Foundation
+
+/// Bridges a Live Activity tap to an expo-invoke intent.
+///
+/// When expo-live-activity is installed alongside expo-invoke, the config plugin
+/// links them automatically. Tapping the Dynamic Island or Lock Screen Live Activity
+/// fires the intent configured via `setLiveActivityIntent(activityId, intentId)`.
+///
+/// Usage (generated by config plugin, not written manually):
+///
+/// ```swift
+/// @available(iOS 16.2, *)
+/// struct TrackErrandLiveActivityIntent: LiveActivityIntent {
+///   static var title: LocalizedStringResource = "Track Errand"
+///   static var openAppWhenRun: Bool = true
+///
+///   func perform() async throws -> some IntentResult {
+///     // Look up which intentId is registered for this activity type
+///     let intentId = UserDefaults.standard.string(
+///       forKey: "expo.invoke.liveActivityIntent.errandInProgress"
+///     ) ?? "track_errand"
+///
+///     ExpoInvokeModule.writePendingIntent(
+///       intentId: intentId,
+///       source: "live_activity"
+///     )
+///     return .result()
+///   }
+/// }
+/// ```
+public struct LiveActivityIntentBridge {
+  /// Write the intent for a given Live Activity type. Called from generated Swift.
+  public static func fire(activityType: String, source: String = "live_activity") {
+    let intentId = UserDefaults.standard.string(
+      forKey: "expo.invoke.liveActivityIntent.\(activityType)"
+    ) ?? activityType
+
+    ExpoInvokeModule.writePendingIntent(
+      intentId: intentId,
+      source: source
+    )
+  }
+}

package/ios/Module/ExpoInvokeModule.swift

@@ -0,0 +1,170 @@
+import ExpoModulesCore
+import Foundation
+import CoreSpotlight
+import Intents
+
+private let kPendingIntentKey  = "expo.invoke.pendingIntent"
+private let kConfigKey         = "expo.invoke.config"
+private let kShortcutsKey      = "expo.invoke.shortcuts"
+private let kWidgetGroupSuite   = "group.expo.invoke.widget"
+private let kDefaultTTL: TimeInterval = 30.0
+
+public class ExpoInvokeModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("ExpoInvoke")
+
+    Events("onIntent")
+
+    // ── configure ────────────────────────────────────────────────────────────
+    Function("configure") { (configJson: String) in
+      UserDefaults.standard.set(configJson, forKey: kConfigKey)
+      UserDefaults.standard.synchronize()
+    }
+
+    // ── getInitialIntent ─────────────────────────────────────────────────────
+    Function("getInitialIntent") { () -> String? in
+      return ExpoInvokeModule.consumePendingIntent()
+    }
+
+    // ── Donations ─────────────────────────────────────────────────────────────
+    Function("donateAction") { (json: String) in
+      DonationManager.donate(from: json)
+    }
+
+    Function("deleteAction") { (intentId: String) in
+      DonationManager.delete(intentId: intentId)
+    }
+
+    Function("deleteAllActions") {
+      DonationManager.deleteAll()
+    }
+
+    // ── Dynamic shortcuts ─────────────────────────────────────────────────────
+    Function("setDynamicShortcuts") { (json: String) in
+      UserDefaults.standard.set(json, forKey: kShortcutsKey)
+      UserDefaults.standard.synchronize()
+      ShortcutsManager.update(from: json)
+    }
+
+    Function("getDynamicShortcuts") { () -> String in
+      return UserDefaults.standard.string(forKey: kShortcutsKey) ?? "[]"
+    }
+
+    Function("clearDynamicShortcuts") {
+      UserDefaults.standard.removeObject(forKey: kShortcutsKey)
+      UserDefaults.standard.synchronize()
+      ShortcutsManager.clear()
+    }
+
+    // ── Spotlight ─────────────────────────────────────────────────────────────
+    Function("indexSpotlightItems") { (json: String) in
+      SpotlightManager.index(from: json)
+    }
+
+    Function("deindexSpotlightItems") { (ids: [String]) in
+      SpotlightManager.deindex(ids: ids)
+    }
+
+    // ── Widget data (App Groups) ──────────────────────────────────────────────
+    Function("setWidgetData") { (key: String, value: String) in
+      let suite = UserDefaults(suiteName: kWidgetGroupSuite) ?? UserDefaults.standard
+      suite.set(value, forKey: key)
+      suite.synchronize()
+      // Reload all widget timelines to display fresh data
+      if #available(iOS 14.0, *) {
+        WidgetManager.reloadAll()
+      }
+    }
+
+    Function("getWidgetData") { (key: String) -> String? in
+      let suite = UserDefaults(suiteName: kWidgetGroupSuite) ?? UserDefaults.standard
+      return suite.string(forKey: key)
+    }
+
+    // ── Handoff ───────────────────────────────────────────────────────────────
+    Function("advertiseHandoff") { (intentId: String, paramsJson: String) in
+      HandoffManager.advertise(intentId: intentId, paramsJson: paramsJson)
+    }
+
+    Function("stopHandoff") {
+      HandoffManager.stop()
+    }
+
+    // ── Live Activity intent ──────────────────────────────────────────────────
+    Function("setLiveActivityIntent") { (activityId: String, intentId: String) in
+      UserDefaults.standard.set(intentId, forKey: "expo.invoke.liveActivityIntent.\(activityId)")
+      UserDefaults.standard.synchronize()
+    }
+
+    // ── Add to Siri ───────────────────────────────────────────────────────────
+    Function("addIntentToSiri") { (intentId: String) in
+      // Store the intent ID so the AddToSiriButton component can read it
+      UserDefaults.standard.set(intentId, forKey: "expo.invoke.addToSiriIntent")
+      UserDefaults.standard.synchronize()
+      // Post notification so the native AddToSiriButton can pick it up
+      NotificationCenter.default.post(
+        name: Notification.Name("ExpoInvokeAddToSiri"),
+        object: nil,
+        userInfo: ["intentId": intentId]
+      )
+    }
+
+    // ── Focus mode ────────────────────────────────────────────────────────────
+    Function("getFocusMode") { () -> String? in
+      return FocusFilterManager.currentFocusMode()
+    }
+
+    // ── Quick tile — no-op on iOS ─────────────────────────────────────────────
+    Function("updateQuickTile") { (_: String, _: String) in /* iOS no-op */ }
+
+    // ── Warm start ────────────────────────────────────────────────────────────
+    OnAppBecomesActive {
+      if let json = ExpoInvokeModule.consumePendingIntent() {
+        self.sendEvent("onIntent", ["json": json])
+      }
+    }
+  }
+
+  // ─── Public static helpers (called by native App Intents) ──────────────────
+
+  /// Write a resolved intent to UserDefaults before the app launches.
+  /// Call this from your AppIntent's perform() method.
+  public static func writePendingIntent(
+    intentId: String,
+    source: String = "siri",
+    parameters: [String: Any] = [],
+    spokenResponse: String? = nil
+  ) {
+    var payload: [String: Any] = [
+      "intentId": intentId,
+      "source": source,
+      "timestamp": Date().timeIntervalSince1970 * 1000,
+      "parameters": parameters,
+    ]
+    if let spoken = spokenResponse {
+      payload["_spokenResponse"] = spoken
+    }
+    if let data = try? JSONSerialization.data(withJSONObject: payload),
+       let json = String(data: data, encoding: .utf8) {
+      UserDefaults.standard.set(json, forKey: kPendingIntentKey)
+      UserDefaults.standard.synchronize()
+    }
+  }
+
+  /// Read and atomically clear the pending intent. Returns nil if stale.
+  public static func consumePendingIntent() -> String? {
+    guard let json = UserDefaults.standard.string(forKey: kPendingIntentKey),
+          let data = json.data(using: .utf8),
+          let payload = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+          let tsMs = payload["timestamp"] as? Double else { return nil }
+
+    UserDefaults.standard.removeObject(forKey: kPendingIntentKey)
+    UserDefaults.standard.synchronize()
+
+    let ttl = (payload["_ttl"] as? Double) ?? (kDefaultTTL * 1000)
+    let ageMs = Date().timeIntervalSince1970 * 1000 - tsMs
+    guard ageMs < ttl else { return nil }
+
+    return json
+  }
+}