@microsoft/power-apps-native-host 0.3.3 → 0.5.1

package/README.md

@@ -82,6 +82,23 @@ wiring.
     npm run dev
     ```
 
+    For a device that cannot reach the workstation over LAN, use a private,
+    authenticated Microsoft Dev Tunnel:
+
+    ```bash
+    az login
+    npm run dev -- --tunnel
+    ```
+
+    Pass `--tunnel-tenant <tenant-id>` to select an Entra tenant. The command
+    creates no anonymous access rule and deletes the tunnel when Metro exits.
+    Entra authentication stays on the workstation; the QR code gives the Dev
+    Player a tunnel-scoped connect token for Metro bundle and asset requests.
+    Enterprise firewalls must allow outbound HTTPS on port 443
+    to `login.microsoftonline.com`, `global.rel.tunnels.api.visualstudio.com`,
+    `*.rel.tunnels.api.visualstudio.com`, and `*.devtunnels.ms`, with TLS 1.2 or
+    newer.
+
 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
@@ -153,6 +170,48 @@ export default function App() {
 
 See `src/index.ts` for the full exported API.
 
+### Custom multi-tenant experience
+
+Single-tenant apps and multi-tenant apps using the built-in screens do not
+need any root-layout changes. To replace the multi-tenant sign-in, discovery,
+environment selection, loading, and error screens, pass a component through
+`multiTenantExperience`:
+
+```tsx
+import {
+    PowerAppsProvider,
+    PowerAppsRuntimeGate,
+    usePowerAppsExperience,
+} from '@microsoft/power-apps-native-host';
+
+function CustomerExperience({ children }: React.PropsWithChildren) {
+    const experience = usePowerAppsExperience();
+
+    if (experience.status === 'signIn') {
+        return <LoginScreen error={experience.error} onSignIn={experience.signIn} />;
+    }
+    if (experience.status === 'selectEnvironment') {
+        return <EnvironmentPicker {...experience} />;
+    }
+    if (experience.status === 'ready') {
+        return <PowerAppsRuntimeGate>{children}</PowerAppsRuntimeGate>;
+    }
+    return <BootstrapStatusScreen experience={experience} />;
+}
+
+export default function RootLayout() {
+    return (
+        <PowerAppsProvider {...config} multiTenantExperience={CustomerExperience}>
+            <Slot />
+        </PowerAppsProvider>
+    );
+}
+```
+
+The experience model exposes presentation-safe state and commands only. Target
+authentication sessions, access tokens, token brokers, and stale-operation
+generation state remain internal to `PowerAppsProvider`.
+
 ## Metro Logger
 
 Metro configuration can import the Node-only logger from
@@ -177,6 +236,7 @@ withPowerNativeMetroLogging(middleware, {
 This package exposes these CLI scripts through the `bin` field:
 
 - `generate-connector-schemas` - generates TypeScript schemas from connector definitions.
+- `power-apps-dev` - starts Expo; pass `--tunnel` for a private authenticated Dev Tunnel.
 - `js-bundle` - packages the JavaScript bundle for embedding.
 - `build-ios-base` - builds the iOS base framework.
 - `wrap` - builds a wrapped Android or iOS app.

package/compatibility/current.json

@@ -13,7 +13,7 @@
     }
   },
   "expoSdk": 55,
-  "expoVersion": "55.0.26",
+  "expoVersion": "55.0.29",
   "expoDoctorVersion": "1.20.0",
   "managedDependencies": {
     "@expo/config-plugins": "55.0.11",