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

package/lib/typescript/module/provider/PowerAppsProvider.d.ts

@@ -28,11 +28,12 @@ import React from 'react';
 import { createTamagui } from '@tamagui/core';
 import type { AuthProviderProps } from '../auth/AuthContext';
 import type { PowerAppsHostProviderProps } from './PowerAppsHostProvider';
-import type { ConnectorSchema } from '../platform/useConnectionRefs.js';
-import type { DatabaseReference } from '../platform/PowerPlatformEnvironmentApi.js';
-import type { OnDisambiguationNeeded } from '../connections/types.js';
+import type { ConnectorSchema } from '../connections/useConnectionRefs.js';
+import type { DatabaseReference } from '../platform/DataverseDataSources.js';
+import type { ConnectionReferenceConfig, OnDisambiguationNeeded } from '../connections/types.js';
 import type { ThemeTokens } from '../theme/tokens.js';
 import type { ILogger } from '@microsoft/power-apps-native-common';
+import type { ApplicationInsightsTelemetryProviderConfig } from '@microsoft/power-apps-native-common';
 /** Shape of power.config.json consumed by the provider. */
 export interface PowerConfig {
     /**
@@ -53,10 +54,7 @@ export interface PowerConfig {
      * Omit for the default global collector.
      */
     geoRegion?: string;
-    connectionReferences?: Record<string, {
-        id: string;
-        dataSources: string[];
-    }>;
+    connectionReferences?: Record<string, ConnectionReferenceConfig>;
     databaseReferences?: Record<string, DatabaseReference>;
     /**
      * Allow additional keys — the offline SDK reads arbitrary fields from
@@ -67,7 +65,29 @@ export interface PowerConfig {
     [key: string]: unknown;
 }
 type TamaguiConfig = ReturnType<typeof createTamagui>;
+export interface AppInsightsConfig extends Omit<ApplicationInsightsTelemetryProviderConfig, 'deviceId' | 'sessionId'> {
+    /** Explicit opt-in. Application Insights telemetry is disabled unless this is true. */
+    enabled: boolean;
+}
+export interface PowerAppsAppConfig {
+    expo?: {
+        extra?: {
+            appInsightsConfig?: unknown;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
 export interface PowerAppsProviderProps {
+    /**
+     * Contents of the generated app.json.
+     *
+     * Pass this when the app runs inside a host such as Dev Player, where
+     * `Constants.expoConfig` describes the host instead of the loaded app.
+     * The provider falls back to `Constants.expoConfig` when omitted.
+     */
+    appConfig?: PowerAppsAppConfig;
     /** MSAL configuration from auth.config.json (msal section). */
     msalConfig: AuthProviderProps['msalConfig'];
     /** Intune MAM configuration. Defaults to enabled in release builds. */
@@ -106,6 +126,12 @@ export interface PowerAppsProviderProps {
     renderOAuthWebView?: PowerAppsHostProviderProps['renderOAuthWebView'];
     /** See PowerAppsHostProviderProps.onDisambiguationNeeded. */
     onDisambiguationNeeded?: OnDisambiguationNeeded;
+    /** See PowerAppsHostProviderProps.onConnectionConsent. */
+    onConnectionConsent?: PowerAppsHostProviderProps['onConnectionConsent'];
+    /** See PowerAppsHostProviderProps.onResourceConsent. */
+    onResourceConsent?: PowerAppsHostProviderProps['onResourceConsent'];
+    /** See PowerAppsHostProviderProps.onConnectionConsentDeclined. */
+    onConnectionConsentDeclined?: PowerAppsHostProviderProps['onConnectionConsentDeclined'];
     /**
      * App name used as `clientType` in the auto-wired 1DS telemetry provider.
      * Appears in Kusto as the `clientType` column — use a stable
@@ -125,6 +151,25 @@ export interface PowerAppsProviderProps {
      *   logger becomes a no-op regardless of build variant.
      */
     logger?: ILogger | null;
+    /**
+     * Show app and telemetry session details after a three-finger long press.
+     * Available in both development and published native apps. @default true
+     */
+    showSessionDetailsOnLongPress?: boolean;
+    /**
+     * @deprecated Use `showSessionDetailsOnLongPress` instead.
+     */
+    showSessionDetailsOnSwipe?: boolean;
+    /**
+     * Optional customer-owned Application Insights destination.
+     *
+     * Events are sent directly to the selected C1-owned Application Insights
+     * resource and fan out alongside the default Microsoft OneDS provider.
+     * Defaults to `appConfig.expo.extra.appInsightsConfig`, then falls back to
+     * `Constants.expoConfig.extra.appInsightsConfig`.
+     * Ignored when `logger` is provided or `null`.
+     */
+    appInsightsConfig?: AppInsightsConfig;
     /**
      * Offline profile JSON — optional override.
      * Primary source: SDK config plugin embeds offline-profile.json into the app
@@ -142,7 +187,7 @@ export interface PowerAppsProviderProps {
  * component, eliminating all provider boilerplate from the consuming app's
  * root layout.
  */
-export declare function PowerAppsProvider({ msalConfig, intuneConfig, powerConfig, schemaMap, tamaguiConfig, // override with app's tamagui.config.ts
-defaultTheme, theme, darkTheme, followSystemTheme, renderOAuthWebView, onDisambiguationNeeded, appName, logger: loggerProp, offlineProfile, children, }: PowerAppsProviderProps): React.JSX.Element;
+export declare function PowerAppsProvider({ appConfig, msalConfig, intuneConfig, powerConfig, schemaMap, tamaguiConfig, // override with app's tamagui.config.ts
+defaultTheme, theme, darkTheme, followSystemTheme, renderOAuthWebView, onDisambiguationNeeded, onConnectionConsent, onResourceConsent, onConnectionConsentDeclined, appName, logger: loggerProp, showSessionDetailsOnLongPress, showSessionDetailsOnSwipe, appInsightsConfig, offlineProfile, children, }: PowerAppsProviderProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=PowerAppsProvider.d.ts.map

package/lib/typescript/module/provider/SessionDetailsGesture.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface SessionDetailsGestureProps {
+    enabled: boolean;
+    appName: string;
+    appId?: string;
+    environmentId?: string;
+    region: string;
+    appVersion?: string;
+    children: React.ReactNode;
+}
+export declare function SessionDetailsGesture({ enabled, appName, appId, environmentId, region, appVersion, children, }: SessionDetailsGestureProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=SessionDetailsGesture.d.ts.map

package/lib/typescript/module/telemetry/OfflineSdkTelemetry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Forwards the privacy-safe Offline SDK transport through the host's existing
+ * app logger so offline events carry the same session, device, and user data.
+ *
+ * The host owns exactly one thing here: binding the SDK transport to this
+ * host's logger. Buffering and teardown semantics live in the SDK.
+ *
+ * Setup and teardown are fail-open but not silent. This runs from an effect in
+ * the provider that roots the app, so an unguarded throw would take down the
+ * whole tree — telemetry is never worth an app that will not start. An
+ * unexpected failure is therefore downgraded to a logged diagnostic rather than
+ * swallowed, so broken wiring stays observable.
+ */
+export declare function configureOfflineSdkTelemetry(forwardEvents: boolean): () => void;
+//# sourceMappingURL=OfflineSdkTelemetry.d.ts.map

package/lib/typescript/module/telemetry/OfflineSdkTelemetry.web.d.ts

@@ -0,0 +1,2 @@
+export declare function configureOfflineSdkTelemetry(_forwardEvents: boolean): () => void;
+//# sourceMappingURL=OfflineSdkTelemetry.web.d.ts.map

package/lib/typescript/module/telemetry/index.d.ts

@@ -7,7 +7,9 @@
  * (`getAppLogger` / `configureAppLogger`). This module re-exports those
  * alongside the canonical host operation-name constants.
  */
-export { getAppLogger, configureAppLogger } from '@microsoft/power-apps-native-common';
+import { HttpClient } from '@microsoft/power-apps-native-common/http';
+export { getAppLogger, configureAppLogger, getCustomerTelemetryLogger } from '@microsoft/power-apps-native-common';
+export type { ICustomerTelemetryLogger } from '@microsoft/power-apps-native-common';
 /**
  * Canonical operation names for host package telemetry.
  * Follow the `PowerAppsHost.<Subsystem>.<Action>` convention so events are
@@ -34,15 +36,25 @@ export declare const HostOperationNames: {
     readonly BridgeTokenAcquireFailed: "PowerAppsHost.Bridge.TokenAcquire.Failed";
     /** Top-level React error boundary caught an unhandled JS error. */
     readonly RuntimeUnhandledJsError: "PowerAppsHost.Runtime.UnhandledJsError";
+    /** Power Platform RP HTTP request, including backend correlation IDs. */
+    readonly PlatformHttpRequest: "PowerAppsHost.Platform.HttpRequest";
     /** Resolve Dataverse instanceUrl from Power Platform environment API. */
     readonly PlatformFetchInstanceUrl: "PowerAppsHost.Platform.FetchInstanceUrl";
     /** useConnectionRefs failed to resolve connections (recoverable). Recorded only on failure. */
     readonly PlatformLoadConnectionsFailed: "PowerAppsHost.Platform.LoadConnections.Failed";
     /** Create a new Power Platform connection. */
     readonly PlatformCreateConnection: "PowerAppsHost.Platform.CreateConnection";
+    /** Repair an existing Power Platform connection. */
+    readonly PlatformRepairConnection: "PowerAppsHost.Platform.RepairConnection";
+    /** Poll a connection until it becomes active. */
+    readonly PlatformPollConnectionStatus: "PowerAppsHost.Platform.PollConnectionStatus";
     /** Resolve app connection references for the current launch. */
     readonly PlatformResolveConnectionRefs: "PowerAppsHost.Platform.ResolveConnectionRefs";
     /** Grant this app access to a Power Platform connection ACL. */
     readonly PlatformConnectionAclGrant: "PowerAppsHost.Platform.ConnectionAclGrant";
+    /** Installed Offline SDK predates the SDK-owned routing contract. */
+    readonly OfflineRoutingContractUnsupported: "PowerAppsHost.Offline.RoutingContract.Unsupported";
 };
+export declare const bridgeHttpClient: HttpClient;
+export declare const platformHttpClient: HttpClient;
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/power-apps-native-host",
-  "version": "0.2.25",
+  "version": "0.3.3",
   "description": "React Native host integration for @microsoft/power-apps",
   "author": "Microsoft Corporation",
   "license": "SEE LICENSE IN LICENSE",
@@ -12,28 +12,44 @@
   },
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
-  "types": "./lib/typescript/commonjs/index.d.ts",
+  "types": "./src/config/index.d.ts",
   "exports": {
     ".": {
       "browser": {
-        "types": "./lib/typescript/commonjs/index.d.ts",
-        "default": "./lib/commonjs/index.js"
+        "types": "./src/config/index.d.ts",
+        "default": "./lib/module/index.js"
       },
       "import": {
-        "types": "./lib/typescript/module/index.d.ts",
+        "types": "./src/config/index.d.ts",
         "default": "./lib/module/index.js"
       },
       "require": {
-        "types": "./lib/typescript/commonjs/index.d.ts",
+        "types": "./src/config/index.d.ts",
         "default": "./lib/commonjs/index.js"
       }
     },
     "./package.json": "./package.json",
+    "./config/tsconfig": "./src/config/tsconfig.json",
+    "./config/*": {
+      "browser": {
+        "types": "./lib/typescript/module/config/*.d.ts",
+        "default": "./lib/module/config/*.js"
+      },
+      "import": {
+        "types": "./lib/typescript/module/config/*.d.ts",
+        "default": "./lib/module/config/*.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/config/*.d.ts",
+        "default": "./lib/commonjs/config/*.js"
+      }
+    },
     "./app.plugin.js": "./app.plugin.js"
   },
   "bin": {
     "generate-connector-schemas": "scripts/generate-connector-schemas.js",
     "js-bundle": "scripts/bundle.js",
+    "build-codegen-package": "scripts/build-codegen-package.js",
     "build-ios-base": "scripts/build-ios-base.js",
     "power-apps-web": "scripts/start-web.mjs",
     "wrap": "scripts/wrap.js",
@@ -42,19 +58,26 @@
   "files": [
     "lib/",
     "!lib/**/*.map",
+    "src/config/generated-config.d.ts",
+    "src/config/index.d.ts",
+    "src/config/tsconfig.json",
     "app.plugin.js",
     "scripts/",
     "compatibility/"
   ],
   "scripts": {
-    "prepack": "npm run test:upgrade && bob build && node ../../scripts/notices.js",
-    "build": "bob build && node ../../scripts/notices.js",
+    "prepack": "npm run build && npm test",
+    "build": "bob build && node ../../scripts/package-build/notices.js",
     "type-check": "tsc --noEmit",
-    "test:upgrade": "node --test test/upgrade.test.js"
+    "test": "node --test --test-force-exit test/*.test.js",
+    "test:upgrade": "node --test --test-force-exit test/upgrade.test.js",
+    "test:offline-compatibility": "bob build && node --test test/OfflineSdkCompatibility.test.js"
   },
   "dependencies": {
-    "@microsoft/power-apps-native-auth": "^0.3.5",
-    "@microsoft/power-apps-native-common": "^0.1.8",
+    "@expo/config-plugins": "55.0.11",
+    "@microsoft/power-apps-native-assets": "^0.3.0",
+    "@microsoft/power-apps-native-auth": "^0.3.8",
+    "@microsoft/power-apps-native-common": "^0.2.2",
     "@ster5/global-mutex": "3.3.0",
     "@tamagui/config": "2.4.5",
     "@tamagui/core": "2.4.5",
@@ -66,12 +89,20 @@
     "write-file-atomic": "7.0.1"
   },
   "peerDependencies": {
+    "@expo/vector-icons": ">=15.1.1 <16",
     "@microsoft/power-apps": "*",
-    "@microsoft/power-apps-native-offline": ">=0.1.0",
+    "@microsoft/power-apps-native-offline": ">=0.1.32",
     "@react-native-community/netinfo": ">=11.0.0",
     "burnt": ">=0.12.2",
+    "expo-application": ">=55.0.0 <56",
     "expo-constants": ">=55.0.0 <56",
+    "expo-clipboard": ">=55.0.0 <56",
+    "expo-document-picker": ">=55.0.13 <56",
+    "expo-file-system": ">=55.0.19 <56",
+    "expo-image-picker": ">=55.0.20 <56",
     "expo-linking": ">=55.0.14 <56",
+    "expo-sharing": ">=55.0.18 <56",
+    "expo-secure-store": ">=55.0.0 <56",
     "expo-web-browser": ">=55.0.14 <56",
     "react": ">=19.2.0 <20",
     "react-dom": ">=19.2.0 <19.3.0",
@@ -91,9 +122,13 @@
     }
   },
   "devDependencies": {
+    "@microsoft/power-apps-cli": "0.15.3",
     "@types/react": "19.2.14",
     "cross-env": "7.0.3",
+    "expo-application": "55.0.15",
+    "expo-clipboard": "55.0.13",
     "expo-constants": "55.0.16",
+    "expo-secure-store": "55.0.13",
     "expo-web-browser": "55.0.15",
     "react": "19.2.0",
     "react-dom": "19.2.0",
@@ -109,10 +144,14 @@
   "publishConfig": {
     "access": "public"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "**/index.js",
+    "**/index.ts"
+  ],
   "react-native-builder-bob": {
     "source": "src",
     "output": "lib",
+    "exclude": "config/{generated-config.d.ts,index.d.ts,tsconfig.json}",
     "targets": [
       [
         "module",

package/scripts/build-codegen-package.js

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+/**
+ * Codegen native package producer.
+ *
+ * Produces a *self-consistent* native asset package for the Power Apps wrap
+ * pipeline from a single `expo export`, so the embedded Hermes bundle and the
+ * hash-addressed asset files share one Metro AssetRegistry (their hashes line
+ * up with what the runtime asset resolver sees). No JavaScript is compiled or
+ * downloaded inside the wrap pipeline — this step runs at customer deploy time.
+ *
+ * Usage (via the app's npm scripts):
+ *   build-codegen-package android
+ *   build-codegen-package ios
+ *
+ * Emits into ./dist (deploy uploads the whole dist/ to blob):
+ *   dist/index.android.bundle.hbc | dist/main.jsbundle.hbc   ← Hermes bundle
+ *   dist/powerapps-customer-assets-<platform>/manifest.json
+ *   dist/powerapps-customer-assets-<platform>/assets/<fileHash>.<type>
+ *
+ * Android and iOS asset packages are kept in separate, platform-suffixed dirs
+ * because their scales/densities (and therefore fileHashes) differ. The wrap
+ * pipeline downloads the platform-matching dir and injects it into the base app
+ * under the neutral name `powerapps-customer-assets/`, which the native module
+ * reads at runtime.
+ *
+ * manifest.json shape (schemaVersion 1):
+ *   {
+ *     "schemaVersion": 1,
+ *     "platform": "android" | "ios",
+ *     "bundle": { "path": "index.android.bundle.hbc" },
+ *     "assets": [
+ *       { "fileHash": "<md5>", "type": "png", "path": "assets/<md5>.png",
+ *         "hash": "<metroRegistryHash>", "scale": 2 }
+ *     ]
+ *   }
+ *
+ * The `hash` (Metro AssetRegistry hash) + `scale` let the native module build a
+ * runtime lookup the JS resolver keys by `"<hash>@<scale>"`. Integrity fields
+ * (sha256, signing) are intentionally out of scope here (Scope 3).
+ */
+
+'use strict';
+
+const { execFileSync, spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const crypto = require('crypto');
+
+const platform = process.argv[2];
+if (platform !== 'android' && platform !== 'ios') {
+  console.error('Usage: build-codegen-package <android|ios>');
+  process.exit(1);
+}
+
+const isWin = process.platform === 'win32';
+const isLinux = process.platform === 'linux';
+
+const projectRoot = process.cwd();
+const workspaceRoot = path.resolve(projectRoot, '../..');
+
+const HERMES_MAGIC = Buffer.from([0xc6, 0x1f, 0xbc, 0x03]);
+// Platform-suffixed in blob so android/ios packages don't clobber each other;
+// the wrap injects into the neutral `powerapps-customer-assets/` on-device.
+const ASSET_DIR_NAME = `powerapps-customer-assets-${platform}`;
+const bundleName =
+  platform === 'android' ? 'index.android.bundle.hbc' : 'main.jsbundle.hbc';
+
+function resolveExpoBin() {
+  const name = isWin ? 'expo.cmd' : 'expo';
+  const local = path.join(projectRoot, 'node_modules', '.bin', name);
+  const hoisted = path.join(workspaceRoot, 'node_modules', '.bin', name);
+  return fs.existsSync(local) ? local : hoisted;
+}
+
+function resolveHermesc() {
+  const hcPkg = require.resolve('hermes-compiler/package.json', {
+    paths: [projectRoot, workspaceRoot],
+  });
+  const hcDir = path.dirname(hcPkg);
+  const binDir = isWin ? 'win64-bin' : isLinux ? 'linux64-bin' : 'osx-bin';
+  const binName = isWin ? 'hermesc.exe' : 'hermesc';
+  const flat = path.join(hcDir, binDir, binName);
+  const nested = path.join(hcDir, binName, binDir, binName);
+  return fs.existsSync(flat) ? flat : nested;
+}
+
+function findFiles(dir, predicate) {
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+    const p = path.join(dir, entry.name);
+    return entry.isDirectory()
+      ? findFiles(p, predicate)
+      : predicate(p)
+        ? [p]
+        : [];
+  });
+}
+
+function sha256File(filePath) {
+  return crypto
+    .createHash('sha256')
+    .update(fs.readFileSync(filePath))
+    .digest('hex');
+}
+
+function isHermesBytecode(filePath) {
+  const fd = fs.openSync(filePath, 'r');
+  try {
+    const head = Buffer.alloc(4);
+    fs.readSync(fd, head, 0, 4, 0);
+    return head.equals(HERMES_MAGIC);
+  } finally {
+    fs.closeSync(fd);
+  }
+}
+
+/**
+ * Run `expo export` for the native platform and wait for completion. Unlike
+ * `expo export:embed`, this yields hash-addressed assets and (with
+ * `--dump-assetmap`) an assetmap.json we can turn into a manifest.
+ */
+function runExpoExport(expoBin, outputDir) {
+  const marker = `Exported: ${outputDir}`;
+  return new Promise((resolve, reject) => {
+    const child = spawn(
+      expoBin,
+      [
+        'export',
+        '--platform',
+        platform,
+        '--output-dir',
+        outputDir,
+        '--dump-assetmap',
+        '--clear',
+      ],
+      {
+        cwd: projectRoot,
+        env: { ...process.env, CI: process.env.CI ?? '1', EXPO_NO_TELEMETRY: '1' },
+        shell: isWin,
+        stdio: ['ignore', 'pipe', 'pipe'],
+      },
+    );
+    let tail = '';
+    let done = false;
+    const forward = (chunk, dest) => {
+      dest.write(chunk);
+      tail = (tail + chunk).slice(-marker.length * 2);
+      if (!done && tail.includes(marker)) {
+        done = true;
+        if (isWin && child.pid) {
+          try {
+            execFileSync('taskkill', ['/pid', String(child.pid), '/t', '/f'], {
+              stdio: 'ignore',
+            });
+          } catch {
+            child.kill();
+          }
+        } else {
+          child.kill('SIGKILL');
+        }
+      }
+    };
+    child.stdout.on('data', (c) => forward(c, process.stdout));
+    child.stderr.on('data', (c) => forward(c, process.stderr));
+    child.once('error', reject);
+    child.once('exit', (code, signal) => {
+      if (done) resolve();
+      else
+        reject(
+          new Error(
+            code === 0
+              ? `Expo export exited before completion marker: ${marker}`
+              : `Expo export failed (${signal ? `signal ${signal}` : `code ${code}`})`,
+          ),
+        );
+    });
+  });
+}
+
+function locateBundle(exportDir) {
+  const jsDir = path.join(exportDir, '_expo', 'static', 'js', platform);
+  const candidates = findFiles(jsDir, (p) => /\.(hbc|js)$/.test(p));
+  const hbc = candidates.find((p) => p.endsWith('.hbc'));
+  if (hbc) return { file: hbc, isHermes: true };
+  if (candidates.length === 1) return { file: candidates[0], isHermes: false };
+  throw new Error(
+    `Expected exactly one native bundle under ${jsDir}, found ${candidates.length}`,
+  );
+}
+
+function buildAssetPackage(exportDir, distDir, bundlePath) {
+  const assetMapPath = path.join(exportDir, 'assetmap.json');
+  const assetsOutDir = path.join(distDir, ASSET_DIR_NAME, 'assets');
+  const manifestPath = path.join(distDir, ASSET_DIR_NAME, 'manifest.json');
+
+  const manifest = {
+    schemaVersion: 1,
+    platform,
+    // BIN-3: sha256 pins every artifact the wrap pipeline injects. The wrap
+    // recomputes these before use, so a truncated or swapped blob fails the
+    // build instead of shipping inside a signed app.
+    bundle: { path: bundleName, sha256: sha256File(bundlePath) },
+    assets: [],
+  };
+
+  // No assets is valid (an app may reference none). Still emit an empty
+  // manifest so the wrap injection + native module behave uniformly.
+  if (fs.existsSync(assetMapPath)) {
+    fs.mkdirSync(assetsOutDir, { recursive: true });
+    const assetMap = JSON.parse(fs.readFileSync(assetMapPath, 'utf8'));
+    for (const [registryHash, entry] of Object.entries(assetMap)) {
+      const type = String(entry.type ?? '').replace(/^\./, '') || 'dat';
+      const fileHashes = entry.fileHashes ?? [];
+      const scales = entry.scales ?? [];
+      for (let i = 0; i < fileHashes.length; i++) {
+        const fileHash = fileHashes[i];
+        const scale = scales[i] ?? 1;
+        const src = path.join(exportDir, 'assets', fileHash);
+        if (!fs.existsSync(src)) {
+          throw new Error(`Exported asset missing on disk: assets/${fileHash}`);
+        }
+        const relPath = `assets/${fileHash}.${type}`;
+        const destPath = path.join(distDir, ASSET_DIR_NAME, relPath);
+        fs.copyFileSync(src, destPath);
+        manifest.assets.push({
+          fileHash,
+          type,
+          path: relPath,
+          hash: registryHash,
+          scale,
+          sha256: sha256File(destPath),
+        });
+      }
+    }
+  } else {
+    fs.mkdirSync(path.join(distDir, ASSET_DIR_NAME), { recursive: true });
+  }
+
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+  return manifest.assets.length;
+}
+
+async function main() {
+  const distDir = path.join(projectRoot, 'dist');
+  fs.mkdirSync(distDir, { recursive: true });
+
+  const exportDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pa-codegen-export-'));
+  try {
+    console.log(`\n[package] Step 1: expo export (${platform})`);
+    await runExpoExport(resolveExpoBin(), exportDir);
+
+    console.log('[package] Step 2: locate + stage Hermes bundle');
+    const { file, isHermes } = locateBundle(exportDir);
+    const outBundle = path.join(distDir, bundleName);
+    if (isHermes) {
+      fs.copyFileSync(file, outBundle);
+    } else {
+      console.log('[package]   plain JS bundle exported; compiling with hermesc');
+      execFileSync(resolveHermesc(), ['-emit-binary', '-out', outBundle, file], {
+        stdio: 'inherit',
+      });
+    }
+    if (!isHermesBytecode(outBundle)) {
+      throw new Error(`Staged bundle is not Hermes bytecode: ${outBundle}`);
+    }
+
+    console.log('[package] Step 3: build asset package + manifest');
+    const count = buildAssetPackage(exportDir, distDir, outBundle);
+
+    console.log(
+      `\n[package] Done. Bundle: "${outBundle}"; assets: ${count}; ` +
+        `manifest: "${path.join(distDir, ASSET_DIR_NAME, 'manifest.json')}"`,
+    );
+  } finally {
+    fs.rmSync(exportDir, { recursive: true, force: true });
+  }
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/scripts/start-web.mjs

@@ -7,7 +7,9 @@ import process from 'node:process';
 
 const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
 const npxCommand = process.platform === 'win32' ? 'npx.cmd' : 'npx';
-const localAppUrl = 'http://localhost:8082';
+const localAppPort = process.env.POWER_APPS_WEB_APP_PORT?.trim() || '8082';
+const playerPort = process.env.POWER_APPS_WEB_PLAYER_PORT?.trim() || '8080';
+const localAppUrl = `http://localhost:${localAppPort}`;
 const children = new Set();
 let shuttingDown = false;
 
@@ -106,7 +108,9 @@ function captureLocalPlayUrl(child, environmentId) {
     child.stdout.removeAllListeners('data');
     child.stdout.pipe(process.stdout);
     void waitForApp()
-      .then(() => openBrowser(playUrl.href))
+      .then(() => {
+        if (process.env.POWER_APPS_WEB_NO_OPEN !== 'true') openBrowser(playUrl.href);
+      })
       .catch((error) => {
         console.error(error instanceof Error ? error.message : String(error));
         shutdown(1);
@@ -128,10 +132,10 @@ const schemaProcess = spawn(npmCommand, ['run', 'generate-schemas'], {
 const schemaExitCode = await new Promise((resolve) => schemaProcess.once('exit', resolve));
 if (schemaExitCode !== 0) process.exit(schemaExitCode ?? 1);
 
-run(npxCommand, ['expo', 'start', '--port', '8082', '--localhost']);
+run(npxCommand, ['expo', 'start', '--port', localAppPort, '--localhost']);
 const powerApps = run(
   npxCommand,
-  ['power-apps', 'run', '--port', '8080', '--local-app-url', localAppUrl],
+  ['pa', 'app', 'run', '--config-only', '--port', playerPort, '--local-app-url', localAppUrl],
   { stdio: ['inherit', 'pipe', 'inherit'] }
 );
-captureLocalPlayUrl(powerApps, powerConfig.environmentId);
+captureLocalPlayUrl(powerApps, powerConfig.environmentId);