@microsoft/power-apps-native-host 0.2.22 → 0.3.0

package/README.md

@@ -1,42 +1,154 @@
 # @microsoft/power-apps-native-host
 
-React Native host integration for `@microsoft/power-apps`. Provides the
-provider tree, authentication context, connection setup UI, and platform
-bridges required to embed Power Apps in a React Native / Expo application.
+React Native host integration for `@microsoft/power-apps`. It provides the
+provider tree, authentication context, connection setup UI, and platform bridges
+needed to embed Power Apps in a React Native or Expo app.
 
-## Build a Mobile App with Power Platform
+## Requirements
 
-Start from the Power Platform mobile app template, then use the mobile-app
-skill to generate the app plan, data model, screens, native capabilities, and
-connector wiring.
+- Node.js 22 LTS.
+- npm 10 or newer.
+- The Power Apps Developer app from the Apple App Store or Google Play.
 
-```sh
-npx degit microsoft/power-platform-skills/plugins/mobile-apps/template#main my-mobile-app
-cd my-mobile-app
-npm install
+## Setup
+
+**Building native mobile apps with Power Platform is in Private Preview; do not
+use this in production.**
+
+Start from the Power Platform mobile app template, then use the mobile-app skill
+to generate the app plan, data model, screens, native capabilities, and connector
+wiring.
+
+1. Create a new app from the template and install dependencies:
+
+    ```sh
+    npx degit microsoft/power-platform-skills/plugins/mobile-apps/template#main my-mobile-app
+    cd my-mobile-app
+    npm install
+    ```
+
+2. Install the mobile-app plugin from the Power Platform Skills marketplace.
+
+    In GitHub Copilot for VS Code, open the Extensions view, search for
+    `@agentplugin`, find the Power Platform mobile-app plugin, and select
+    **Install**. Reload VS Code if prompted, then open Copilot Chat in Agent
+    mode.
+
+    Alternatively, install it from a terminal:
+
+    ```sh
+    copilot plugin marketplace add microsoft/power-platform-skills
+    copilot plugin install mobile-app@power-platform-skills
+    ```
+
+    For Claude CLI:
+
+    ```sh
+    claude plugin marketplace add microsoft/power-platform-skills
+    claude plugin install mobile-app@power-platform-skills --scope user
+    ```
+
+3. Open the template folder in VS Code and run the skill from Copilot Chat:
+
+    ```text
+    /create-mobile-app
+    ```
+
+    The skill updates the app in place as it designs and generates the mobile
+    experience. When prompted to sign in, use credentials for the tenant where
+    the Dataverse environment belongs.
+
+4. Create the Microsoft Entra app registration from Power Apps Wrap.
+
+    Open the app-registration page for the Power Platform environment selected
+    during `/create-mobile-app`:
+
+    ```text
+    https://make.powerapps.com/environments/<environment-id>/wraps#create-app-registration
+    ```
+
+    Create the registration, copy its **Application (client) ID**, and paste it
+    when `/create-mobile-app` asks. Wrap configures the native app registration;
+    redirect URIs, API permissions, and tenant-wide admin consent do not need to
+    be configured manually.
+
+    If the app was created without a client ID, run `/set-app-registration-native`
+    later from the app folder. It opens the same page and writes the pasted
+    client ID to `auth.config.json`.
+
+5. Start the mobile app from the app directory:
+
+    ```bash
+    npm run dev
+    ```
+
+6. Preview the app by scanning the QR code with the Power Apps Developer app.
+
+    - App Store: https://apps.apple.com/us/app/power-apps-developer/id6753083462
+    - Google Play: coming soon
+    - App Center: https://install.appcenter.ms/orgs/appmagic-player-x6ys/apps/rn-dev-player-preview/distribution_groups/public_distribution/releases
+
+## Upgrade the Native Host
+
+From the app directory, preview the next template upgrade:
+
+```bash
+npx --package @microsoft/power-apps-native-host@latest upgrade-template --dry-run
+```
+
+Apply it:
+
+```bash
+npx --package @microsoft/power-apps-native-host@latest upgrade-template
 ```
 
-Install the mobile-app skill from the Power Platform skills plugin:
+Each run upgrades one template version, installs compatible dependencies, and
+runs Expo validation. If another version is available, run the command again.
+The current version is stored in `app.json` under
+`expo.extra.powerappsNative`; do not edit this object.
 
-```text
-https://github.com/microsoft/power-platform-skills/tree/main/plugins/mobile-apps/plugin.json
+Apps created before this version file existed must specify their source template
+version:
+
+```bash
+npx --package @microsoft/power-apps-native-host@latest \
+    upgrade-template --from-version 1
 ```
 
-Then open the template folder in VS Code and run the skill from Copilot Chat:
+The upgrader never changes `app/`, `src/`, `android/`, or `ios/`. If a root
+configuration change conflicts with your customization, it writes a `.rej` file
+for manual resolution. Failed validation restores files managed by the upgrade.
+
+Supported package managers are npm, pnpm, and Bun.
+
+## Web
 
-```text
-/create-mobile-app
+Start the browser app:
+
+```bash
+npm run web
 ```
 
-The template includes this host package and the required Expo / React Native
-runtime dependencies. The skill updates the app in place as it designs and
-generates the mobile experience.
+The command opens **Local Play** in your default browser and embeds the local
+Expo app in the hosted Power Apps player. Use the same browser profile as your
+Power Platform tenant.
+
+Web builds are supported in Code Apps. They are also supported in Power Pages
+when the app uses Dataverse only.
 
+To publish as a Code App, run `npm run bundle:web`, set `appType` to `CodeApp`
+and `distPath` to `dist-web` in `power.config.json`, then run
+`npx power-apps push`.
+
+To publish to Power Pages, run `npm run bundle:web -- powerpages`, then use the
+Power Pages skills to upload the generated `dist-web` directory. Before
+publishing, enable the required Dataverse table permissions and Power Pages Web
+API site settings.
 
 ## Usage
 
 ```tsx
-import { PowerAppsProvider, useAuth } from '@microsoft/power-apps-native-host';
+import { PowerAppsProvider } from '@microsoft/power-apps-native-host';
 
 export default function App() {
   return (
@@ -49,11 +161,35 @@ export default function App() {
 
 See `src/index.ts` for the full exported API.
 
-## Bundled CLI scripts
+## Metro Logger
+
+Metro configuration can import the Node-only logger from
+`@microsoft/power-apps-native-host/metro-logger`. Pass `projectRoot` when
+wrapping middleware. An optional `onError(error, context)` callback receives the
+first instrumentation failure for that project; `context` contains `phase` and
+`logPath`. The callback is invoked at most once so diagnostics cannot recurse.
+When it is omitted, the first failure is written once through the original
+stderr stream. Logging and callback failures never propagate into Metro.
+
+```js
+withPowerNativeMetroLogging(middleware, {
+    projectRoot: __dirname,
+    onError(error, { phase, logPath }) {
+        reportMetroLoggingFailure({ error, phase, logPath });
+    },
+});
+```
+
+## Bundled CLI Scripts
+
+This package exposes these CLI scripts through the `bin` field:
 
-This package exposes three CLI scripts via the `bin` field:
+- `generate-connector-schemas` - generates TypeScript schemas from connector definitions.
+- `js-bundle` - packages the JavaScript bundle for embedding.
+- `build-ios-base` - builds the iOS base framework.
+- `wrap` - builds a wrapped Android or iOS app.
+- `upgrade-template` - upgrades an app to this host release's compatibility profile.
 
-- `generate-connector-schemas` — generates TypeScript schemas from connector definitions
-- `js-bundle` — packages the JS bundle for embedding
-- `build-ios-base` — builds the iOS base framework
+## License and Notices
 
+This package is provided under the license in `LICENSE`.

package/compatibility/current.json

@@ -0,0 +1,87 @@
+{
+  "schemaVersion": 1,
+  "id": "expo-55",
+  "targetTemplateVersion": 1,
+  "expoSdk": 55,
+  "expoVersion": "55.0.26",
+  "expoDoctorVersion": "1.20.0",
+  "managedDependencies": {
+    "@expo/metro-runtime": "55.0.11",
+    "@expo/vector-icons": "15.1.1",
+    "@microsoft/power-apps": "1.2.7",
+    "@microsoft/power-apps-native-offline": "^0.1.3",
+    "@react-native-async-storage/async-storage": "^2.1.2",
+    "@react-native-community/datetimepicker": "8.6.0",
+    "@react-native-community/netinfo": "11.5.2",
+    "@tamagui/animations-react-native": "2.4.5",
+    "@tamagui/config": "2.4.5",
+    "@tamagui/core": "2.4.5",
+    "@tamagui/portal": "2.4.5",
+    "@tamagui/toast": "2.4.5",
+    "@tanstack/react-query": "5.62.0",
+    "burnt": "0.12.2",
+    "expo-application": "55.0.15",
+    "expo-asset": "55.0.17",
+    "expo-audio": "55.0.14",
+    "expo-auth-session": "55.0.15",
+    "expo-camera": "55.0.18",
+    "expo-cellular": "55.0.13",
+    "expo-checkbox": "55.0.4",
+    "expo-clipboard": "55.0.13",
+    "expo-constants": "55.0.16",
+    "expo-crypto": "55.0.14",
+    "expo-dev-client": "55.0.32",
+    "expo-device": "55.0.16",
+    "expo-document-picker": "55.0.13",
+    "expo-file-system": "55.0.19",
+    "expo-font": "55.0.7",
+    "expo-image": "55.0.10",
+    "expo-image-manipulator": "55.0.16",
+    "expo-image-picker": "55.0.20",
+    "expo-intent-launcher": "55.0.12",
+    "expo-keep-awake": "55.0.8",
+    "expo-linear-gradient": "55.0.13",
+    "expo-linking": "55.0.15",
+    "expo-local-authentication": "55.0.13",
+    "expo-location": "55.1.9",
+    "expo-mail-composer": "55.0.13",
+    "expo-media-library": "55.0.16",
+    "expo-modules-core": "55.0.25",
+    "expo-print": "55.0.14",
+    "expo-router": "55.0.14",
+    "expo-screen-orientation": "55.0.14",
+    "expo-secure-store": "55.0.13",
+    "expo-sharing": "55.0.18",
+    "expo-splash-screen": "55.0.20",
+    "expo-status-bar": "55.0.6",
+    "expo-system-ui": "55.0.17",
+    "expo-video": "55.0.16",
+    "expo-web-browser": "55.0.15",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "react-hook-form": "7.54.0",
+    "react-native": "0.83.6",
+    "react-native-gesture-handler": "2.30.1",
+    "react-native-get-random-values": "^2.0.0",
+    "react-native-reanimated": "4.2.1",
+    "react-native-safe-area-context": "5.6.2",
+    "react-native-screens": "4.23.0",
+    "react-native-web": "^0.21.2",
+    "react-native-worklets": "0.7.4",
+    "tamagui": "2.4.5",
+    "zod": "3.24.0"
+  },
+  "managedDevDependencies": {
+    "@babel/core": "7.29.6",
+    "@tamagui/babel-plugin": "2.4.5",
+    "@types/react": "19.2.14",
+    "babel-preset-expo": "55.0.18",
+    "typescript": "5.9.3"
+  },
+  "managedOverrides": {
+    "esbuild": "0.28.1",
+    "uuid": ">=11.1.1 <12",
+    "shell-quote": ">=1.8.4 <2",
+    "postcss": ">=8.5.10 <9"
+  }
+}