expo-invoke 1.3.0 → 2.1.0

package/build/plugin/ios/withIOSInvoke.js

@@ -38,18 +38,45 @@ const config_plugins_1 = require("@expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const generateSwiftIntents_1 = require("../codegen/generateSwiftIntents");
+const generateSwiftEntities_1 = require("../codegen/generateSwiftEntities");
+const generateSwiftFocusFilters_1 = require("../codegen/generateSwiftFocusFilters");
+const generateSwiftAppClip_1 = require("../codegen/generateSwiftAppClip");
+const withWidgetExtension_1 = require("./withWidgetExtension");
 const withIOSInvoke = (config, options) => {
-    const { intents, voiceUsageDescription, appGroupId } = options;
-    // 1. Info.plist usage description
+    var _a, _b, _c;
+    const { intents, voiceUsageDescription, appGroupId, entities = [], focusFilters = [], appClips = [], enablePushToTalk = false, pttUsageDescription, enableLiveActivities = false, enableWidget = false, widgetTitle, widgetDescription = 'Quick access from your home screen.', widgetDataKey = 'invokeWidgetData', widgetAccentColor = '#267AD9', widgetDeepLink = '', widgetSizes = ['small', 'medium'], } = options;
+    // 1. Info.plist usage descriptions + feature flags
     config = (0, config_plugins_1.withInfoPlist)(config, (cfg) => {
+        var _a;
         cfg.modResults.NSSiriUsageDescription =
             voiceUsageDescription !== null && voiceUsageDescription !== void 0 ? voiceUsageDescription : 'This app uses Siri to perform quick actions.';
         cfg.modResults.NSVoiceUsageDescription =
             voiceUsageDescription !== null && voiceUsageDescription !== void 0 ? voiceUsageDescription : 'This app uses voice commands to perform quick actions.';
+        if (enablePushToTalk) {
+            cfg.modResults.NSPushToTalkUsageDescription =
+                pttUsageDescription !== null && pttUsageDescription !== void 0 ? pttUsageDescription : 'This app uses Push to Talk for voice communication.';
+            // Add voip background mode
+            const modes = (_a = cfg.modResults.UIBackgroundModes) !== null && _a !== void 0 ? _a : [];
+            if (!modes.includes('voip')) {
+                cfg.modResults.UIBackgroundModes = [...modes, 'voip'];
+            }
+        }
+        if (enableLiveActivities) {
+            cfg.modResults.NSSupportsLiveActivities = true;
+            cfg.modResults.NSSupportsLiveActivitiesFrequentUpdates = true;
+        }
+        if (appClips.length > 0) {
+            cfg.modResults.NSAppClip = {
+                NSAppClipRequestEphemeralUserNotification: true,
+                NSAppClipRequestLocationConfirmation: true,
+            };
+        }
+        if (focusFilters.length > 0) {
+            cfg.modResults.NSFocusFilterEnabled = true;
+        }
         return cfg;
     });
-    // 2. App Groups entitlement (needed for widget data sharing)
-    // plist values are typed as a union — cast the existing array explicitly
+    // 2. App Groups entitlement (widget data sharing + App Clips)
     if (appGroupId) {
         config = (0, config_plugins_1.withEntitlementsPlist)(config, (cfg) => {
             var _a;
@@ -60,23 +87,69 @@ const withIOSInvoke = (config, options) => {
             return cfg;
         });
     }
-    // 3. Generate InvokeIntents.swift via withDangerousMod
+    // 3. Generate Swift files via withDangerousMod
     config = (0, config_plugins_1.withDangerousMod)(config, [
         'ios',
         async (cfg) => {
             var _a;
             const appName = (_a = cfg.modRequest.projectName) !== null && _a !== void 0 ? _a : 'app';
             const iosDir = path.join(cfg.modRequest.platformProjectRoot, appName);
-            // Ensure directory exists
-            if (!fs.existsSync(iosDir)) {
+            try {
                 fs.mkdirSync(iosDir, { recursive: true });
             }
-            const swiftCode = (0, generateSwiftIntents_1.generateSwiftIntents)(intents);
-            const outputPath = path.join(iosDir, 'InvokeIntents.swift');
-            fs.writeFileSync(outputPath, swiftCode, 'utf8');
+            catch (e) {
+                throw new Error(`[expo-invoke] Could not create iOS project directory at "${iosDir}".\n` +
+                    `Cause: ${e instanceof Error ? e.message : e}\n` +
+                    `Fix: Ensure the path is writable. Try running \`npx expo prebuild --clean\`.`);
+            }
+            const writeSwift = (filename, content) => {
+                const filePath = path.join(iosDir, filename);
+                try {
+                    fs.writeFileSync(filePath, content, 'utf8');
+                }
+                catch (e) {
+                    throw new Error(`[expo-invoke] Failed to write ${filename} to "${iosDir}".\n` +
+                        `Cause: ${e instanceof Error ? e.message : e}\n` +
+                        `Fix: Ensure the iOS project directory is writable. Run \`npx expo prebuild --clean\`.`);
+                }
+            };
+            // InvokeIntents.swift — AppIntent structs + AppShortcutsProvider
+            writeSwift('InvokeIntents.swift', (0, generateSwiftIntents_1.generateSwiftIntents)(intents));
+            // InvokeEntities.swift — AppEntity + EntityQuery structs
+            const entityCode = (0, generateSwiftEntities_1.generateSwiftEntities)(entities);
+            if (entityCode)
+                writeSwift('InvokeEntities.swift', entityCode);
+            // InvokeFocusFilters.swift — SetFocusFilterIntent structs
+            const focusCode = (0, generateSwiftFocusFilters_1.generateSwiftFocusFilters)(focusFilters);
+            if (focusCode)
+                writeSwift('InvokeFocusFilters.swift', focusCode);
+            // InvokeAppClip.swift — App Clip URL → intent registrations
+            const clipCode = (0, generateSwiftAppClip_1.generateSwiftAppClip)(appClips);
+            if (clipCode)
+                writeSwift('InvokeAppClip.swift', clipCode);
             return cfg;
         },
     ]);
+    // 4. Widget Extension (opt-in — requires appGroupId)
+    if (enableWidget) {
+        if (!appGroupId) {
+            console.warn('[expo-invoke] enableWidget is true but appGroupId is missing.\n' +
+                'Fix: Add appGroupId to your expo-invoke plugin config, e.g. "group.com.myapp.invoke".');
+        }
+        else {
+            const bundleIdentifier = ((_b = (_a = config.ios) === null || _a === void 0 ? void 0 : _a.bundleIdentifier) !== null && _b !== void 0 ? _b : 'com.example.app') + '.InvokeWidget';
+            config = (0, withWidgetExtension_1.withWidgetExtension)(config, {
+                appGroupId,
+                bundleId: bundleIdentifier,
+                widgetTitle: widgetTitle !== null && widgetTitle !== void 0 ? widgetTitle : ((_c = config.name) !== null && _c !== void 0 ? _c : 'My App'),
+                widgetDescription,
+                widgetDataKey,
+                widgetAccentColor,
+                widgetDeepLink,
+                widgetSizes,
+            });
+        }
+    }
     return config;
 };
 exports.withIOSInvoke = withIOSInvoke;

package/build/plugin/ios/withIOSInvoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"withIOSInvoke.js","sourceRoot":"","sources":["../../../plugin/ios/withIOSInvoke.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAK8B;AAC9B,uCAAyB;AACzB,2CAA6B;AAC7B,0EAAuE;AAShE,MAAM,aAAa,GAAmC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IAC/E,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE/D,kCAAkC;IAClC,MAAM,GAAG,IAAA,8BAAa,EAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACrC,GAAG,CAAC,UAAU,CAAC,sBAAsB;YACnC,qBAAqB,aAArB,qBAAqB,cAArB,qBAAqB,GAAI,8CAA8C,CAAC;QAC1E,GAAG,CAAC,UAAU,CAAC,uBAAuB;YACpC,qBAAqB,aAArB,qBAAqB,cAArB,qBAAqB,GAAI,wDAAwD,CAAC;QACpF,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,yEAAyE;IACzE,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,GAAG,IAAA,sCAAqB,EAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;;YAC7C,MAAM,QAAQ,GAAG,MAAC,GAAG,CAAC,UAAU,CAAC,uCAAuC,CAA0B,mCAAI,EAAE,CAAC;YACzG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnC,GAAG,CAAC,UAAU,CAAC,uCAAuC,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,UAAU,CAAC,CAAC;YACtF,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,MAAM,GAAG,IAAA,iCAAgB,EAAC,MAAM,EAAE;QAChC,KAAK;QACL,KAAK,EAAE,GAAG,EAAE,EAAE;;YACZ,MAAM,OAAO,GAAG,MAAA,GAAG,CAAC,UAAU,CAAC,WAAW,mCAAI,KAAK,CAAC;YACpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAEtE,0BAA0B;YAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,SAAS,GAAG,IAAA,2CAAoB,EAAC,OAAO,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;YAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAEhD,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AA7CW,QAAA,aAAa,iBA6CxB"}
+{"version":3,"file":"withIOSInvoke.js","sourceRoot":"","sources":["../../../plugin/ios/withIOSInvoke.ts"],"names":[],"mappings":"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"}

package/build/plugin/ios/withWidgetExtension.d.ts

@@ -0,0 +1,14 @@
+import { type ConfigPlugin } from '@expo/config-plugins';
+import { type WidgetCodegenOptions } from '../codegen/generateSwiftWidget';
+export interface WidgetExtensionOptions extends WidgetCodegenOptions {
+    bundleId: string;
+    deploymentTarget?: string;
+}
+/**
+ * Adds a WidgetKit extension target to the iOS Xcode project.
+ * Called automatically by withIOSInvoke when enableWidget: true.
+ *
+ * Developers never call this directly — it's wired up through the expo-invoke
+ * app.json plugin config.
+ */
+export declare const withWidgetExtension: ConfigPlugin<WidgetExtensionOptions>;

package/build/plugin/ios/withWidgetExtension.js

@@ -0,0 +1,185 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withWidgetExtension = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const generateSwiftWidget_1 = require("../codegen/generateSwiftWidget");
+const WIDGET_TARGET = 'InvokeWidget';
+/**
+ * Adds a WidgetKit extension target to the iOS Xcode project.
+ * Called automatically by withIOSInvoke when enableWidget: true.
+ *
+ * Developers never call this directly — it's wired up through the expo-invoke
+ * app.json plugin config.
+ */
+const withWidgetExtension = (config, opts) => {
+    const { appGroupId, bundleId, deploymentTarget = '16.0' } = opts;
+    // 1. Add App Group entitlement to the main app
+    config = (0, config_plugins_1.withEntitlementsPlist)(config, (cfg) => {
+        var _a;
+        const key = 'com.apple.security.application-groups';
+        const existing = (_a = cfg.modResults[key]) !== null && _a !== void 0 ? _a : [];
+        if (!existing.includes(appGroupId)) {
+            cfg.modResults[key] = [...existing, appGroupId];
+        }
+        return cfg;
+    });
+    // 2. Generate widget Swift source file + support files into ios/InvokeWidget/
+    config = (0, config_plugins_1.withDangerousMod)(config, [
+        'ios',
+        async (cfg) => {
+            const widgetDir = path.join(cfg.modRequest.platformProjectRoot, WIDGET_TARGET);
+            try {
+                fs.mkdirSync(widgetDir, { recursive: true });
+            }
+            catch (e) {
+                throw new Error(`[expo-invoke] Could not create widget directory at "${widgetDir}".\n` +
+                    `Cause: ${e instanceof Error ? e.message : e}\n` +
+                    `Fix: Ensure the iOS project root is writable. Try \`npx expo prebuild --clean\`.`);
+            }
+            const write = (filename, content) => {
+                try {
+                    fs.writeFileSync(path.join(widgetDir, filename), content, 'utf8');
+                }
+                catch (e) {
+                    throw new Error(`[expo-invoke] Failed to write widget file "${filename}".\n` +
+                        `Cause: ${e instanceof Error ? e.message : e}\n` +
+                        `Fix: Check write permissions on the iOS project directory.`);
+                }
+            };
+            write('InvokeWidget.swift', (0, generateSwiftWidget_1.generateSwiftWidget)(opts));
+            write('Info.plist', (0, generateSwiftWidget_1.generateWidgetInfoPlist)());
+            write(`${WIDGET_TARGET}.entitlements`, (0, generateSwiftWidget_1.generateWidgetEntitlements)(appGroupId));
+            console.log(`[expo-invoke] Widget extension files written to ${widgetDir}`);
+            return cfg;
+        },
+    ]);
+    // 3. Add widget target to the Xcode project
+    config = (0, config_plugins_1.withXcodeProject)(config, (cfg) => {
+        var _a;
+        const proj = cfg.modResults;
+        // Idempotency — skip if the target already exists
+        const existingTargets = proj.pbxNativeTargetSection();
+        const already = Object.values(existingTargets).some((t) => t && typeof t === 'object' && t.name === WIDGET_TARGET);
+        if (already) {
+            console.log('[expo-invoke] Widget target already in Xcode project, skipping');
+            return cfg;
+        }
+        // ── Add the extension target ─────────────────────────────────────────────
+        const widgetTarget = proj.addTarget(WIDGET_TARGET, 'app_extension', WIDGET_TARGET, bundleId);
+        if (!widgetTarget) {
+            console.error('[expo-invoke] addTarget() returned null — Xcode widget target NOT added');
+            return cfg;
+        }
+        const widgetUuid = widgetTarget.uuid;
+        // ── Build phases ─────────────────────────────────────────────────────────
+        proj.addBuildPhase(['InvokeWidget.swift'], 'PBXSourcesBuildPhase', 'Sources', widgetUuid);
+        proj.addBuildPhase([], 'PBXResourcesBuildPhase', 'Resources', widgetUuid);
+        // ── Frameworks ───────────────────────────────────────────────────────────
+        proj.addFramework('WidgetKit.framework', { target: widgetUuid });
+        proj.addFramework('SwiftUI.framework', { target: widgetUuid });
+        // ── Build settings ───────────────────────────────────────────────────────
+        const configurations = proj.pbxXCBuildConfigurationSection();
+        for (const [, cfgObj] of Object.entries(configurations)) {
+            const settings = cfgObj === null || cfgObj === void 0 ? void 0 : cfgObj.buildSettings;
+            if (!settings)
+                continue;
+            const prodName = settings.PRODUCT_NAME;
+            if (prodName !== `"${WIDGET_TARGET}"` && prodName !== WIDGET_TARGET)
+                continue;
+            settings.PRODUCT_BUNDLE_IDENTIFIER = `"${bundleId}"`;
+            settings.SWIFT_VERSION = '5.0';
+            settings.IPHONEOS_DEPLOYMENT_TARGET = deploymentTarget;
+            settings.INFOPLIST_FILE = `"${WIDGET_TARGET}/Info.plist"`;
+            settings.CODE_SIGN_ENTITLEMENTS = `"${WIDGET_TARGET}/${WIDGET_TARGET}.entitlements"`;
+            settings.SKIP_INSTALL = 'YES';
+            settings.TARGETED_DEVICE_FAMILY = '"1,2"';
+            settings.LD_RUNPATH_SEARCH_PATHS = '"$(inherited) @executable_path/../../Frameworks"';
+            settings.ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = 'NO';
+        }
+        // ── Embed widget in main app (Embed App Extensions phase) ────────────────
+        const mainTarget = proj.getFirstTarget();
+        if (mainTarget) {
+            const mainUuid = mainTarget.uuid;
+            // Add widget as a build dependency (builds first)
+            proj.addTargetDependency(mainUuid, [widgetUuid]);
+            // Add PBXCopyFilesBuildPhase with dstSubfolderSpec = 13 (PlugIns/Extensions)
+            const embedPhase = proj.addBuildPhase([], 'PBXCopyFilesBuildPhase', 'Embed App Extensions', mainUuid, 'application');
+            // Patch dstSubfolderSpec to 13 (Xcode extension slot)
+            if (embedPhase === null || embedPhase === void 0 ? void 0 : embedPhase.uuid) {
+                const phases = proj.hash.project.objects['PBXCopyFilesBuildPhase'];
+                if (phases === null || phases === void 0 ? void 0 : phases[embedPhase.uuid]) {
+                    phases[embedPhase.uuid].dstSubfolderSpec = 13;
+                    phases[embedPhase.uuid].name = '"Embed App Extensions"';
+                }
+            }
+            // Find the .appex product file reference and add it to the embed phase
+            const buildFiles = proj.pbxBuildFileSection();
+            for (const [fileKey, fileMeta] of Object.entries(buildFiles)) {
+                if (fileKey.endsWith('_comment'))
+                    continue;
+                const meta = fileMeta;
+                const comment = (_a = buildFiles[`${fileKey}_comment`]) !== null && _a !== void 0 ? _a : '';
+                if (!comment.includes(`${WIDGET_TARGET}.appex`))
+                    continue;
+                // Mark as code-sign-on-copy
+                if (!meta.settings) {
+                    buildFiles[fileKey].settings = {};
+                }
+                buildFiles[fileKey].settings.ATTRIBUTES = ['CodeSignOnCopy', 'RemoveHeadersOnCopy'];
+                // Add to embed phase
+                if (embedPhase === null || embedPhase === void 0 ? void 0 : embedPhase.uuid) {
+                    const phases = proj.hash.project.objects['PBXCopyFilesBuildPhase'];
+                    if (phases === null || phases === void 0 ? void 0 : phases[embedPhase.uuid]) {
+                        if (!phases[embedPhase.uuid].files)
+                            phases[embedPhase.uuid].files = [];
+                        phases[embedPhase.uuid].files.push({
+                            value: fileKey,
+                            comment: `${WIDGET_TARGET}.appex in Embed App Extensions`,
+                        });
+                    }
+                }
+                break;
+            }
+        }
+        console.log(`[expo-invoke] Widget target "${WIDGET_TARGET}" added to Xcode project ✓`);
+        return cfg;
+    });
+    return config;
+};
+exports.withWidgetExtension = withWidgetExtension;
+//# sourceMappingURL=withWidgetExtension.js.map

package/build/plugin/ios/withWidgetExtension.js.map

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

package/build/plugin/src/withInvoke.d.ts

@@ -1,5 +1,4 @@
-import { type ConfigPlugin } from '@expo/config-plugins';
-import type { IntentDefinition, WidgetDefinition, NotificationCategoryDefinition } from '../../src/types';
+import type { IntentDefinition, WidgetDefinition, NotificationCategoryDefinition, AppEntityDefinition, FocusFilterDefinition, AppClipDefinition, SliceDefinition } from '../../src/types';
 export interface InvokePluginOptions {
     /** Intent definitions. Each intent maps to Siri voice phrases, shortcuts, widget buttons, etc. */
     intents: IntentDefinition[];
@@ -11,6 +10,49 @@ export interface InvokePluginOptions {
     voiceUsageDescription?: string;
     /** iOS App Group identifier for widget data sharing (e.g. "group.com.myapp.invoke") */
     appGroupId?: string;
+    /** App Entity definitions for Siri parameter resolution (iOS 16.4+) */
+    entities?: AppEntityDefinition[];
+    /** Focus filter definitions — register the app as a Focus filter (iOS 16+) */
+    focusFilters?: FocusFilterDefinition[];
+    /** App Clip definitions (iOS 14+) */
+    appClips?: AppClipDefinition[];
+    /** Android Slice definitions for Google Search / Assistant inline content */
+    slices?: SliceDefinition[];
+    /** Enable interactive widget controls that fire without opening the app (iOS 17+ / Android 12+) */
+    enableInteractiveWidgets?: boolean;
+    /** Enable Push-to-Talk framework integration (iOS 16+) */
+    enablePushToTalk?: boolean;
+    /** NSPushToTalkUsageDescription — required if enablePushToTalk is true */
+    pttUsageDescription?: string;
+    /** Set NSSupportsLiveActivities in Info.plist */
+    enableLiveActivities?: boolean;
+    /** ActivityAttributes class names your app defines (for documentation / validation) */
+    liveActivityTypes?: string[];
+    /**
+     * Add a built-in WidgetKit home screen widget to your app.
+     * Requires `appGroupId` to be set. No native code needed — the widget Swift
+     * file is generated automatically from your config.
+     *
+     * The widget reads display data from the shared App Group UserDefaults. Use
+     * setWidgetData(key, { count, badgeLabel, title, subtitle, detail }) from your
+     * app to populate it.
+     */
+    enableWidget?: boolean;
+    /** Widget display name shown in the iOS widget picker (defaults to app name) */
+    widgetTitle?: string;
+    /** Widget description shown in the iOS widget picker */
+    widgetDescription?: string;
+    /**
+     * UserDefaults key the widget reads from.
+     * Must match the key you pass to setWidgetData(). Defaults to "invokeWidgetData".
+     */
+    widgetDataKey?: string;
+    /** Hex accent colour for widget UI (defaults to "#267AD9") */
+    widgetAccentColor?: string;
+    /** URL scheme deep-link opened when the widget is tapped (e.g. "myapp://home") */
+    widgetDeepLink?: string;
+    /** Widget sizes to generate. Defaults to ["small", "medium"] */
+    widgetSizes?: ('small' | 'medium' | 'large')[];
 }
-declare const _default: ConfigPlugin<InvokePluginOptions>;
+declare const _default: any;
 export default _default;

package/build/plugin/src/withInvoke.js

@@ -3,11 +3,37 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("@expo/config-plugins");
 const withIOSInvoke_1 = require("../ios/withIOSInvoke");
 const withAndroidInvoke_1 = require("../android/withAndroidInvoke");
+const validation_1 = require("../../src/utils/validation");
 const withInvoke = (config, options) => {
-    const { intents = [], widgets, notificationActions, voiceUsageDescription, appGroupId } = options;
-    config = (0, withIOSInvoke_1.withIOSInvoke)(config, { intents, voiceUsageDescription, appGroupId });
-    config = (0, withAndroidInvoke_1.withAndroidInvoke)(config, { intents, notificationActions });
+    const { intents = [], widgets: _widgets, notificationActions, voiceUsageDescription, appGroupId, entities = [], focusFilters = [], appClips = [], slices = [], enableInteractiveWidgets = false, enablePushToTalk = false, pttUsageDescription, enableLiveActivities = false, liveActivityTypes = [], enableWidget = false, widgetTitle, widgetDescription, widgetDataKey, widgetAccentColor, widgetDeepLink, widgetSizes, } = options;
+    // Validate options early — throws with a helpful message if misconfigured
+    (0, validation_1.validatePluginOptions)({ enablePushToTalk, pttUsageDescription, enableLiveActivities, liveActivityTypes });
+    config = (0, withIOSInvoke_1.withIOSInvoke)(config, {
+        intents,
+        voiceUsageDescription,
+        appGroupId,
+        entities,
+        focusFilters,
+        appClips,
+        enablePushToTalk,
+        pttUsageDescription,
+        enableLiveActivities,
+        liveActivityTypes,
+        enableWidget,
+        widgetTitle,
+        widgetDescription,
+        widgetDataKey,
+        widgetAccentColor,
+        widgetDeepLink,
+        widgetSizes,
+    });
+    config = (0, withAndroidInvoke_1.withAndroidInvoke)(config, {
+        intents,
+        notificationActions,
+        slices,
+        enableInteractiveWidgets,
+    });
     return config;
 };
-exports.default = (0, config_plugins_1.createRunOncePlugin)(withInvoke, 'expo-invoke', '1.0.0');
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withInvoke, 'expo-invoke', '2.0.0');
 //# sourceMappingURL=withInvoke.js.map

package/build/plugin/src/withInvoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"withInvoke.js","sourceRoot":"","sources":["../../../plugin/src/withInvoke.ts"],"names":[],"mappings":";;AAAA,yDAA8E;AAC9E,wDAAqD;AACrD,oEAAiE;AAoBjE,MAAM,UAAU,GAAsC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IACxE,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAElG,MAAM,GAAG,IAAA,6BAAa,EAAC,MAAM,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/E,MAAM,GAAG,IAAA,qCAAiB,EAAC,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAErE,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,IAAA,oCAAmB,EAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC"}
+{"version":3,"file":"withInvoke.js","sourceRoot":"","sources":["../../../plugin/src/withInvoke.ts"],"names":[],"mappings":";;AAAA,yDAA8E;AAC9E,wDAAqD;AACrD,oEAAiE;AACjE,2DAAmE;AAqEnE,MAAM,UAAU,GAAsC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IACxE,MAAM,EACJ,OAAO,GAAG,EAAE,EACZ,OAAO,EAAE,QAAQ,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,QAAQ,GAAG,EAAE,EACb,YAAY,GAAG,EAAE,EACjB,QAAQ,GAAG,EAAE,EACb,MAAM,GAAG,EAAE,EACX,wBAAwB,GAAG,KAAK,EAChC,gBAAgB,GAAG,KAAK,EACxB,mBAAmB,EACnB,oBAAoB,GAAG,KAAK,EAC5B,iBAAiB,GAAG,EAAE,EACtB,YAAY,GAAG,KAAK,EACpB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,GACZ,GAAG,OAAO,CAAC;IAEZ,0EAA0E;IAC1E,IAAA,kCAAqB,EAAC,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAE1G,MAAM,GAAG,IAAA,6BAAa,EAAC,MAAM,EAAE;QAC7B,OAAO;QACP,qBAAqB;QACrB,UAAU;QACV,QAAQ;QACR,YAAY;QACZ,QAAQ;QACR,gBAAgB;QAChB,mBAAmB;QACnB,oBAAoB;QACpB,iBAAiB;QACjB,YAAY;QACZ,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,iBAAiB;QACjB,cAAc;QACd,WAAW;KACZ,CAAC,CAAC;IAEH,MAAM,GAAG,IAAA,qCAAiB,EAAC,MAAM,EAAE;QACjC,OAAO;QACP,mBAAmB;QACnB,MAAM;QACN,wBAAwB;KACzB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,IAAA,oCAAmB,EAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC"}

package/build/src/components/AddToSiriButton.d.ts

@@ -13,6 +13,6 @@ interface AddToSiriButtonProps {
  * @example
  * <AddToSiriButton intentId="create_errand" />
  */
-export declare function AddToSiriButton({ intentId, style, labelStyle, onPress }: AddToSiriButtonProps): any;
+export declare function AddToSiriButton({ intentId, style, labelStyle, onPress }: AddToSiriButtonProps): import("react").JSX.Element | null;
 export {};
 //# sourceMappingURL=AddToSiriButton.d.ts.map

package/build/src/components/AddToSiriButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AddToSiriButton.d.ts","sourceRoot":"","sources":["../../../src/components/AddToSiriButton.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGhG,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,oBAAoB,OAkB7F"}
+{"version":3,"file":"AddToSiriButton.d.ts","sourceRoot":"","sources":["../../../src/components/AddToSiriButton.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGhG,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,oBAAoB,sCAkB7F"}

package/build/src/components/InvokeDebugger.d.ts

@@ -8,5 +8,5 @@
  * // app/_layout.tsx (dev only)
  * { __DEV__ && <InvokeDebugger /> }
  */
-export declare function InvokeDebugger(): any;
+export declare function InvokeDebugger(): import("react").JSX.Element | null;
 //# sourceMappingURL=InvokeDebugger.d.ts.map

package/build/src/components/InvokeDebugger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InvokeDebugger.d.ts","sourceRoot":"","sources":["../../../src/components/InvokeDebugger.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,QAI7B"}
+{"version":3,"file":"InvokeDebugger.d.ts","sourceRoot":"","sources":["../../../src/components/InvokeDebugger.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,uCAI7B"}

package/build/src/components/ShortcutChip.d.ts

@@ -15,6 +15,6 @@ interface ShortcutChipProps {
  * @example
  * <ShortcutChip shortcutId="quick_errand" label="Quick Errand" icon="📦" />
  */
-export declare function ShortcutChip({ shortcutId, label, icon, style, labelStyle, onPress }: ShortcutChipProps): any;
+export declare function ShortcutChip({ shortcutId, label, icon, style, labelStyle, onPress }: ShortcutChipProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=ShortcutChip.d.ts.map

package/build/src/components/ShortcutChip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShortcutChip.d.ts","sourceRoot":"","sources":["../../../src/components/ShortcutChip.tsx"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGtF,UAAU,iBAAiB;IACzB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,iBAAiB,OAuBtG"}
+{"version":3,"file":"ShortcutChip.d.ts","sourceRoot":"","sources":["../../../src/components/ShortcutChip.tsx"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGtF,UAAU,iBAAiB;IACzB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,iBAAiB,+BAuBtG"}

package/build/src/hooks/useBackgroundIntent.d.ts

@@ -0,0 +1,15 @@
+import type { BackgroundIntentResult, ParameterValue } from '../types';
+/**
+ * Register a handler for a background intent — one that runs without opening the app.
+ * The intent must have `openAppWhenRun: false` in app.json.
+ *
+ * iOS 16+ only. On Android, the handler fires normally (app opens first).
+ *
+ * @example
+ * useBackgroundIntent('mark_complete', async ({ errandId }) => {
+ *   await api.markComplete(errandId as string);
+ *   return { success: true, spokenResponse: 'Errand marked as complete.' };
+ * });
+ */
+export declare function useBackgroundIntent(intentId: string, handler: (parameters: Record<string, ParameterValue>) => Promise<BackgroundIntentResult>): void;
+//# sourceMappingURL=useBackgroundIntent.d.ts.map

package/build/src/hooks/useBackgroundIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackgroundIntent.d.ts","sourceRoot":"","sources":["../../../src/hooks/useBackgroundIntent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,GACvF,IAAI,CAyBN"}

package/build/src/hooks/useBackgroundIntent.js

@@ -0,0 +1,41 @@
+import { useEffect, useRef } from 'react';
+import { registerBackgroundHandler, reportBackgroundResult, addIntentListener } from '../module';
+/**
+ * Register a handler for a background intent — one that runs without opening the app.
+ * The intent must have `openAppWhenRun: false` in app.json.
+ *
+ * iOS 16+ only. On Android, the handler fires normally (app opens first).
+ *
+ * @example
+ * useBackgroundIntent('mark_complete', async ({ errandId }) => {
+ *   await api.markComplete(errandId as string);
+ *   return { success: true, spokenResponse: 'Errand marked as complete.' };
+ * });
+ */
+export function useBackgroundIntent(intentId, handler) {
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        registerBackgroundHandler(intentId);
+        const sub = addIntentListener(async (intent) => {
+            var _a;
+            if (intent.intentId !== intentId || intent.source !== 'background')
+                return;
+            try {
+                const result = await handlerRef.current((_a = intent.parameters) !== null && _a !== void 0 ? _a : {});
+                reportBackgroundResult(intentId, result);
+            }
+            catch (e) {
+                reportBackgroundResult(intentId, {
+                    success: false,
+                    error: e instanceof Error ? e.message : 'Handler error',
+                    spokenResponse: 'Sorry, something went wrong.',
+                });
+            }
+        });
+        return () => sub.remove();
+        // intentId is stable — re-register only if it changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [intentId]);
+}
+//# sourceMappingURL=useBackgroundIntent.js.map

package/build/src/hooks/useBackgroundIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackgroundIntent.js","sourceRoot":"","sources":["../../../src/hooks/useBackgroundIntent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGjG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAwF;IAExF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;;YAC7C,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY;gBAAE,OAAO;YAC3E,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAA,MAAM,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAC;gBACjE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,sBAAsB,CAAC,QAAQ,EAAE;oBAC/B,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;oBACvD,cAAc,EAAE,8BAA8B;iBAC/C,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC5B,sDAAsD;QACtD,uDAAuD;IACvD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/build/src/hooks/useEntityQuery.d.ts

@@ -0,0 +1,26 @@
+import type { ParameterValue } from '../types';
+import { type InvokeError } from '../utils/invokeError';
+export interface UseEntityQueryOptions {
+    /** Called when the handler throws. Receives a structured InvokeError. */
+    onError?: (error: InvokeError) => void;
+}
+/**
+ * Register a handler that Siri calls when it needs to resolve entity parameters.
+ * When the user says "Send my errand to [carrier name]", Siri fires this handler
+ * with the entity type and the user's spoken query — your app returns matching results.
+ *
+ * iOS 16.4+ only. No-op on Android.
+ *
+ * Errors from your handler are caught — Siri receives an empty result set instead of crashing.
+ *
+ * @param entityId - Must match an AppEntityDefinition id in app.json
+ * @param handler - Called with the user's query string, return matching entity records
+ *
+ * @example
+ * useEntityQuery('carrier', async (query) => {
+ *   const carriers = await api.searchCarriers(query);
+ *   return carriers.map((c) => ({ id: c.id, name: c.name, rating: c.rating }));
+ * });
+ */
+export declare function useEntityQuery(entityId: string, handler: (query: string) => Promise<Record<string, ParameterValue>[]>, options?: UseEntityQueryOptions): void;
+//# sourceMappingURL=useEntityQuery.d.ts.map

package/build/src/hooks/useEntityQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityQuery.d.ts","sourceRoot":"","sources":["../../../src/hooks/useEntityQuery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC,EACrE,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAsBN"}