@absolutejs/absolute 0.20.0-beta.40 → 0.20.0-beta.42

package/dist/mobile/index.js

@@ -862,7 +862,7 @@ var init_deviceCapabilities = __esm(() => {
 // src/cli/scripts/telemetry.ts
 import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync5, writeFileSync } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 var configDir, configPath, getTelemetryConfig = () => {
   try {
     if (!existsSync4(configPath))
@@ -875,14 +875,14 @@ var configDir, configPath, getTelemetryConfig = () => {
   }
 };
 var init_telemetry = __esm(() => {
-  configDir = join16(homedir3(), ".absolutejs");
-  configPath = join16(configDir, "telemetry.json");
+  configDir = join17(homedir3(), ".absolutejs");
+  configPath = join17(configDir, "telemetry.json");
 });
 
 // src/cli/telemetryEvent.ts
 import { existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
 import { arch, platform } from "os";
-import { dirname as dirname12, join as join17, parse } from "path";
+import { dirname as dirname12, join as join18, parse } from "path";
 var checkCandidate = (candidate) => {
   if (!existsSync5(candidate)) {
     return null;
@@ -902,7 +902,7 @@ var checkCandidate = (candidate) => {
 }, findPackageVersion = () => {
   let { dir } = import.meta;
   while (dir !== parse(dir).root) {
-    const candidate = join17(dir, "package.json");
+    const candidate = join18(dir, "package.json");
     const version = checkCandidate(candidate);
     if (version) {
       return version;
@@ -6037,6 +6037,7 @@ var expoPackage = () => ({
     expo: "~57.0.9",
     "expo-asset": "~57.0.15",
     "expo-constants": "~57.0.16",
+    "expo-dev-client": "~57.0.16",
     "expo-file-system": "~57.0.6",
     "expo-haptics": "~57.0.2",
     "expo-linking": "~57.0.8",
@@ -6079,13 +6080,67 @@ var expoAppConfig = (config) => ({
       ...config.iosVersion ? { buildNumber: config.iosVersion } : {}
     },
     name: config.appName,
-    plugins: ["expo-router"],
+    plugins: [
+      "expo-router",
+      ["expo-dev-client", { launchMode: "most-recent" }]
+    ],
     runtimeVersion: { policy: "appVersion" },
     scheme: config.deepLinkScheme,
     slug: config.appId.toLowerCase().replaceAll(".", "-"),
     version: config.iosVersion ?? "0.1.0"
   }
 });
+var expoDynamicAppConfig = `${EXPO_GENERATED_HEADER}const config = require('./app.json');
+
+if (process.env.ABSOLUTE_EXPO_DEVELOPMENT === '1' && process.env.ABSOLUTE_EXPO_DEVELOPMENT_CA_PATH) {
+	config.expo.plugins = [
+		...config.expo.plugins,
+		'./plugins/withAbsoluteDevelopmentCa'
+	];
+}
+
+module.exports = config;
+`;
+var expoDevelopmentCaPlugin = `${EXPO_GENERATED_HEADER}const { AndroidConfig, withAndroidManifest, withDangerousMod } = require('expo/config-plugins');
+const { copyFile, mkdir } = require('node:fs/promises');
+const path = require('node:path');
+
+const NETWORK_CONFIG = [
+	'<?xml version="1.0" encoding="utf-8"?>',
+	'<network-security-config>',
+	'	<debug-overrides>',
+	'		<trust-anchors>',
+	'			<certificates src="@raw/absolutejs_dev_ca" />',
+	'		</trust-anchors>',
+	'	</debug-overrides>',
+	'</network-security-config>',
+	''
+].join('\\n');
+
+const withAbsoluteDevelopmentCa = config => {
+	config = withAndroidManifest(config, value => {
+		const application = AndroidConfig.Manifest.getMainApplicationOrThrow(value.modResults);
+		application.$['android:networkSecurityConfig'] = '@xml/absolutejs_dev_network_security';
+		return value;
+	});
+	return withDangerousMod(config, ['android', async value => {
+		const certificate = process.env.ABSOLUTE_EXPO_DEVELOPMENT_CA_PATH;
+		if (!certificate) throw new Error('AbsoluteJS Expo HTTPS development requires its development CA path.');
+		const resources = path.join(value.modRequest.platformProjectRoot, 'app', 'src', 'main', 'res');
+		await Promise.all([
+			mkdir(path.join(resources, 'raw'), { recursive: true }),
+			mkdir(path.join(resources, 'xml'), { recursive: true })
+		]);
+		await Promise.all([
+			copyFile(certificate, path.join(resources, 'raw', 'absolutejs_dev_ca.pem')),
+			require('node:fs/promises').writeFile(path.join(resources, 'xml', 'absolutejs_dev_network_security.xml'), NETWORK_CONFIG)
+		]);
+		return value;
+	}]);
+};
+
+module.exports = withAbsoluteDevelopmentCa;
+`;
 var metroConfig = (projectRoot) => `${EXPO_GENERATED_HEADER}const { getDefaultConfig } = require('expo/metro-config');
 const path = require('node:path');
 
@@ -6147,7 +6202,7 @@ var webHostSource = (config) => {
 import * as Linking from 'expo-linking';
 import { router, usePathname } from 'expo-router';
 import { useEffect, useRef, useState } from 'react';
-import { ActivityIndicator, BackHandler, StyleSheet, View } from 'react-native';
+import { ActivityIndicator, BackHandler, Platform, StyleSheet, View } from 'react-native';
 import { WebView, type WebViewMessageEvent } from 'react-native-webview';
 import { materializeAbsoluteWebBundle } from './webAssets';
 
@@ -6156,11 +6211,19 @@ const MAX_MESSAGE_BYTES = 64 * 1024;
 const MAX_HTTP_BODY_BYTES = 48 * 1024;
 const NATIVE_ROUTES = new Set(${JSON.stringify(nativeRoutes)});
 const PRODUCTION_ORIGIN = ${JSON.stringify(config.productionOrigin)};
+const DEV_ORIGIN = Platform.OS === 'android'
+	? process.env.EXPO_PUBLIC_ABSOLUTE_DEV_ANDROID_ORIGIN
+	: process.env.EXPO_PUBLIC_ABSOLUTE_DEV_IOS_ORIGIN;
+const HMR_TARGET = Platform.OS === 'android' ? 'expo-android' : 'expo-ios';
 
-const bridgeBootstrap = (path: string) => \`(() => {
+const bridgeBootstrap = (path: string) => {
+	const initialPath = DEV_ORIGIN
+		? 'location.pathname + location.search + location.hash'
+		: JSON.stringify(path);
+	return \`(() => {
 	const pending = new Map();
 	let sequence = 0;
-	let currentPath = \${JSON.stringify(path)};
+	let currentPath = \${initialPath};
 	const send = value => {
 		const source = JSON.stringify(value);
 		if (new TextEncoder().encode(source).byteLength > 65536) throw new Error('Expo bridge message exceeds 64 KiB.');
@@ -6191,6 +6254,24 @@ const bridgeBootstrap = (path: string) => \`(() => {
 			send({ format: 1, kind: 'event', event: 'navigation', path });
 		}
 	};
+	if (\${DEV_ORIGIN ? 'true' : 'false'}) {
+		const publishPath = () => {
+			const path = location.pathname + location.search + location.hash;
+			if (path === currentPath) return;
+			currentPath = path;
+			send({ format: 1, kind: 'event', event: 'navigation', path });
+		};
+		for (const method of ['pushState', 'replaceState']) {
+			const original = history[method];
+			history[method] = function(...args) {
+				const result = original.apply(this, args);
+				publishPath();
+				return result;
+			};
+		}
+		addEventListener('popstate', publishPath);
+		addEventListener('hashchange', publishPath);
+	}
 	document.addEventListener('click', event => {
 		const anchor = event.target instanceof Element ? event.target.closest('a[href]') : null;
 		if (!anchor) return;
@@ -6199,8 +6280,9 @@ const bridgeBootstrap = (path: string) => \`(() => {
 		event.preventDefault();
 		send({ format: 1, kind: 'event', event: 'navigation', path: url.pathname + url.search + url.hash });
 	}, true);
-	send({ format: 1, kind: 'event', event: 'ready', path: \${JSON.stringify(path)} });
+	send({ format: 1, kind: 'event', event: 'ready', path: currentPath });
 })(); true;\`;
+};
 
 const impact = async (params: Record<string, unknown>) => {
 	const style = params.style;
@@ -6242,7 +6324,15 @@ export function AbsoluteWebHost() {
 	const [canGoBack, setCanGoBack] = useState(false);
 	const activeWebPath = useRef(pathname);
 
-	useEffect(() => { void materializeAbsoluteWebBundle().then(setIndexUri); }, []);
+	useEffect(() => {
+		if (DEV_ORIGIN) {
+			const target = new URL(pathname, DEV_ORIGIN);
+			target.searchParams.set('__absolute_target', HMR_TARGET);
+			setIndexUri(target.href);
+			return;
+		}
+		void materializeAbsoluteWebBundle().then(uri => setIndexUri(uri + '?absolutePath=' + encodeURIComponent(pathname)));
+	}, [pathname]);
 	useEffect(() => {
 		const subscription = BackHandler.addEventListener('hardwareBackPress', () => {
 			if (!canGoBack) return false;
@@ -6257,6 +6347,9 @@ export function AbsoluteWebHost() {
 		if (new TextEncoder().encode(source).byteLength > MAX_MESSAGE_BYTES) throw new Error('Expo bridge response exceeds 64 KiB.');
 		webView.current?.injectJavaScript(\`globalThis.__absoluteExpoReceive(\${JSON.stringify(source)}); true;\`);
 	};
+	const hasOrigin = (source: string, origin: string) => {
+		try { return new URL(source).origin === origin; } catch { return false; }
+	};
 	const onMessage = async (event: WebViewMessageEvent) => {
 		const source = event.nativeEvent.data;
 		if (new TextEncoder().encode(source).byteLength > MAX_MESSAGE_BYTES) return;
@@ -6298,12 +6391,12 @@ export function AbsoluteWebHost() {
 		onMessage={onMessage}
 		onNavigationStateChange={state => setCanGoBack(state.canGoBack)}
 		onShouldStartLoadWithRequest={request => {
-			if (request.url.startsWith('file:') || request.url.startsWith(PRODUCTION_ORIGIN)) return true;
+			if (request.url.startsWith('file:') || hasOrigin(request.url, PRODUCTION_ORIGIN) || DEV_ORIGIN && hasOrigin(request.url, DEV_ORIGIN)) return true;
 			void Linking.openURL(request.url);
 			return false;
 		}}
 		ref={webView}
-		source={{ uri: indexUri + '?absolutePath=' + encodeURIComponent(pathname) }}
+		source={{ uri: indexUri }}
 		style={styles.web}
 	/>;
 }
@@ -6352,6 +6445,10 @@ var writeManagedFile = async (path, source, force) => {
 };
 var jsonSource = (value) => `${JSON.stringify(value, null, "\t")}
 `;
+var emptyWebAssetsSource = `${EXPO_GENERATED_HEADER}export const materializeAbsoluteWebBundle = async () => {
+	throw new Error('The embedded AbsoluteJS bundle is unavailable. Run absolute prepare before a production Expo build.');
+};
+`;
 var writeAbsoluteExpoProject = async (config, options) => {
   if (config.engine !== "expo")
     throw new TypeError("Expo project generation requires mobile.engine: expo.");
@@ -6387,8 +6484,13 @@ node_modules/
 `
     ],
     [join14(project, "app.json"), jsonSource(expoAppConfig(config))],
+    [join14(project, "app.config.js"), expoDynamicAppConfig],
     [join14(project, "package.json"), jsonSource(expoPackage())],
     [join14(project, "metro.config.js"), metroConfig(projectRoot)],
+    [
+      join14(project, "plugins", "withAbsoluteDevelopmentCa.js"),
+      expoDevelopmentCaPlugin
+    ],
     [
       join14(project, "tsconfig.json"),
       jsonSource(expoTsConfig(projectRoot, project))
@@ -6403,6 +6505,10 @@ node_modules/
       webHostSource(config)
     ]
   ]);
+  const webAssetsPath = join14(project, "src", "generated", "webAssets.ts");
+  if (!await exists3(webAssetsPath)) {
+    files.set(webAssetsPath, emptyWebAssetsSource);
+  }
   if (!config.expoNativeRoutes["/"]) {
     files.set(join14(project, "app", "index.tsx"), webRouteSource);
   }
@@ -6902,9 +7008,341 @@ var parseAbsoluteExpoBridgeMessage = (source) => {
     return parseEvent(parsed);
   throw new TypeError("Expo bridge message kind is unsupported.");
 };
+// src/mobile/expoDevController.ts
+import { spawn } from "child_process";
+import { access as access10 } from "fs/promises";
+import { join as join16 } from "path";
+var METRO_READY_TIMEOUT_MS = 60000;
+var PROCESS_CLOSE_TIMEOUT_MS = 2000;
+var commandEnvironment = (options) => ({
+  ABSOLUTE_EXPO_DEVELOPMENT: "1",
+  ...options.certificateAuthorityPath ? {
+    ABSOLUTE_EXPO_DEVELOPMENT_CA_PATH: options.certificateAuthorityPath
+  } : {},
+  ...options.androidOrigin ? { EXPO_PUBLIC_ABSOLUTE_DEV_ANDROID_ORIGIN: options.androidOrigin } : {},
+  ...options.iosOrigin ? { EXPO_PUBLIC_ABSOLUTE_DEV_IOS_ORIGIN: options.iosOrigin } : {}
+});
+var absoluteExpoExecutable = async (project) => {
+  const executable = join16(project, "node_modules", ".bin", "expo");
+  try {
+    await access10(executable);
+    return executable;
+  } catch {
+    throw new TypeError("Expo dependencies are not installed in the generated shell. Run `absolute mobile init --yes`.");
+  }
+};
+var planAbsoluteExpoDevSession = (config, options) => {
+  if (config.engine !== "expo")
+    throw new TypeError("The Expo development controller requires Expo.");
+  if (options.platforms.length === 0)
+    throw new TypeError("Expo development requires a local target platform.");
+  const secureOrigin = [options.androidOrigin, options.iosOrigin].some((origin) => origin && new URL(origin).protocol === "https:");
+  if (secureOrigin && !options.certificateAuthorityPath)
+    throw new TypeError("Expo HTTPS development requires the AbsoluteJS development CA certificate.");
+  const env = commandEnvironment(options);
+  const metro = {
+    args: [
+      "start",
+      "--dev-client",
+      "--host",
+      "localhost",
+      "--port",
+      String(options.metroPort)
+    ],
+    env,
+    role: "metro"
+  };
+  const prepare = {
+    args: [
+      "prebuild",
+      "--clean",
+      "--no-install",
+      "--platform",
+      options.platforms.length === 2 ? "all" : options.platforms[0] ?? "all"
+    ],
+    env,
+    role: "native-prepare"
+  };
+  const native = options.platforms.map((platform) => {
+    const device = platform === "android" ? options.androidDevice : options.iosDevice;
+    const command = {
+      args: [
+        `run:${platform}`,
+        "--no-bundler",
+        "--port",
+        String(options.metroPort),
+        ...device ? ["--device", device] : []
+      ],
+      env,
+      platform,
+      role: "native-build"
+    };
+    return command;
+  });
+  return {
+    commands: [prepare, metro, ...native],
+    metroPort: options.metroPort,
+    project: config.nativeProjectDirectory
+  };
+};
+var abortError = () => new DOMException("Expo development aborted.", "AbortError");
+var forwardLines = (process2, onLine) => {
+  const attach = (stream) => {
+    if (!stream)
+      return;
+    let buffered = "";
+    stream.on("data", (chunk) => {
+      buffered += chunk.toString("utf8");
+      let newline = buffered.indexOf(`
+`);
+      while (newline >= 0) {
+        onLine(buffered.slice(0, newline).replace(/\r$/u, ""));
+        buffered = buffered.slice(newline + 1);
+        newline = buffered.indexOf(`
+`);
+      }
+    });
+    stream.on("end", () => {
+      if (buffered)
+        onLine(buffered);
+    });
+  };
+  attach(process2.stdout);
+  attach(process2.stderr);
+};
+var stopProcess = async (process2) => {
+  if (process2.exitCode !== null || process2.killed)
+    return;
+  process2.kill("SIGTERM");
+  await Promise.race([
+    new Promise((resolve14) => process2.once("exit", () => resolve14())),
+    new Promise((resolve14) => setTimeout(resolve14, PROCESS_CLOSE_TIMEOUT_MS))
+  ]);
+  if (process2.exitCode === null)
+    process2.kill("SIGKILL");
+};
+var waitForExit = (process2) => new Promise((resolve14) => {
+  if (process2.exitCode !== null) {
+    resolve14(process2.exitCode);
+    return;
+  }
+  process2.once("exit", (code) => resolve14(code ?? 1));
+});
+var runUtilityCommand = async (run, command, args, options) => {
+  const child = run(command, args, {
+    cwd: options.cwd,
+    env: process.env,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  forwardLines(child, options.log);
+  const abort = () => void stopProcess(child);
+  options.signal?.addEventListener("abort", abort, { once: true });
+  const exitCode = await waitForExit(child);
+  options.signal?.removeEventListener("abort", abort);
+  if (options.signal?.aborted)
+    throw abortError();
+  return exitCode;
+};
+var startAbsoluteExpoDevSession = async (options) => {
+  const plan = planAbsoluteExpoDevSession(options.config, options);
+  const executable = options.executable ?? await absoluteExpoExecutable(plan.project);
+  const run = options.spawnProcess ?? spawn;
+  const log = options.log ?? (() => {
+    return;
+  });
+  const timings = {};
+  let caEnrollmentServer = null;
+  const closeEnrollmentServer = async () => {
+    const server = caEnrollmentServer;
+    caEnrollmentServer = null;
+    await server?.close();
+  };
+  const publishTiming = (phase, durationMs) => {
+    timings[phase] = (timings[phase] ?? 0) + durationMs;
+    options.onPhaseTiming?.({ durationMs, phase });
+  };
+  const setState = (state) => {
+    options.onStateChange?.(state);
+  };
+  if (options.signal?.aborted)
+    throw abortError();
+  const prepareCommand = plan.commands.find((command) => command.role === "native-prepare");
+  const metroCommand = plan.commands.find((command) => command.role === "metro");
+  const nativeCommands = plan.commands.filter((command) => command.role === "native-build");
+  if (!prepareCommand)
+    throw new TypeError("Expo native preparation command is missing.");
+  if (!metroCommand)
+    throw new TypeError("Expo Metro command is missing.");
+  setState("preparing-native");
+  const prepareStarted = performance.now();
+  const prepareProcess = run(executable, prepareCommand.args, {
+    cwd: plan.project,
+    env: { ...process.env, ...prepareCommand.env },
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  forwardLines(prepareProcess, (line) => {
+    if (line)
+      log(`[prebuild] ${line}`);
+  });
+  const abortPrepare = () => void stopProcess(prepareProcess);
+  options.signal?.addEventListener("abort", abortPrepare, { once: true });
+  const prepareExit = await waitForExit(prepareProcess);
+  options.signal?.removeEventListener("abort", abortPrepare);
+  if (options.signal?.aborted)
+    throw abortError();
+  if (prepareExit !== 0) {
+    setState("failed");
+    throw new Error(`Expo native preparation exited with status ${prepareExit}.`);
+  }
+  const prepareMs = performance.now() - prepareStarted;
+  timings["preparing-native"] = prepareMs;
+  options.onPhaseTiming?.({
+    durationMs: prepareMs,
+    phase: "preparing-native"
+  });
+  setState("starting-metro");
+  const metroStarted = performance.now();
+  const metro = run(executable, metroCommand.args, {
+    cwd: plan.project,
+    env: { ...process.env, ...metroCommand.env },
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  let metroReady = false;
+  let resolveMetro;
+  const metroPromise = new Promise((resolve14, reject) => {
+    const timeout = setTimeout(() => {
+      reject(new Error("Expo Metro did not become ready within 60 seconds."));
+    }, METRO_READY_TIMEOUT_MS);
+    resolveMetro = () => {
+      clearTimeout(timeout);
+      resolve14();
+    };
+    metro.once("exit", (code) => {
+      if (!metroReady) {
+        clearTimeout(timeout);
+        reject(new Error(`Expo Metro exited with status ${code ?? 1}.`));
+      }
+    });
+  });
+  forwardLines(metro, (line) => {
+    if (line)
+      log(`[metro] ${line}`);
+    if (!metroReady && /(?:Waiting on|Metro waiting on|Dev server ready)/iu.test(line)) {
+      metroReady = true;
+      resolveMetro?.();
+    }
+  });
+  const abort = () => void stopProcess(metro);
+  options.signal?.addEventListener("abort", abort, { once: true });
+  const runNativeCommand = async (command) => {
+    if (options.signal?.aborted)
+      throw abortError();
+    const { platform } = command;
+    if (!platform)
+      throw new TypeError("Expo native build command is missing a platform.");
+    const state = platform === "android" ? "building-android" : "building-ios";
+    setState(state);
+    const started = performance.now();
+    const child = run(executable, command.args, {
+      cwd: plan.project,
+      env: { ...process.env, ...command.env },
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    forwardLines(child, (line) => {
+      if (line)
+        log(`[${platform}] ${line}`);
+    });
+    const abortChild = () => void stopProcess(child);
+    options.signal?.addEventListener("abort", abortChild, { once: true });
+    const exitCode = await waitForExit(child);
+    options.signal?.removeEventListener("abort", abortChild);
+    if (options.signal?.aborted)
+      throw abortError();
+    if (exitCode !== 0) {
+      throw new Error(`Expo ${platform} development build exited with status ${exitCode}.`);
+    }
+    if (platform === "ios" && options.certificateAuthorityPath && options.iosOrigin && new URL(options.iosOrigin).protocol === "https:" && !options.iosDevice) {
+      setState("enrolling-trust");
+      const trustStarted = performance.now();
+      const utilityOptions = {
+        cwd: plan.project,
+        signal: options.signal,
+        log: (line) => line && log(`[ios-trust] ${line}`)
+      };
+      const trustExit = await runUtilityCommand(run, "xcrun", [
+        "simctl",
+        "keychain",
+        "booted",
+        "add-root-cert",
+        options.certificateAuthorityPath
+      ], utilityOptions);
+      if (trustExit !== 0)
+        throw new Error(`Expo iOS Simulator development CA trust exited with status ${trustExit}.`);
+      await runUtilityCommand(run, "xcrun", ["simctl", "terminate", "booted", options.config.appId], utilityOptions);
+      const launchExit = await runUtilityCommand(run, "xcrun", ["simctl", "launch", "booted", options.config.appId], utilityOptions);
+      if (launchExit !== 0)
+        throw new Error(`Expo iOS Simulator relaunch exited with status ${launchExit}.`);
+      log("Installed the AbsoluteJS development CA into the Expo iOS Simulator and relaunched the app.");
+      publishTiming("enrolling-trust", performance.now() - trustStarted);
+    }
+    const durationMs = performance.now() - started;
+    timings[state] = durationMs;
+    options.onPhaseTiming?.({ durationMs, phase: state });
+  };
+  const runNativeCommands = async (commands) => {
+    const [command, ...remaining] = commands;
+    if (!command)
+      return;
+    await runNativeCommand(command);
+    await runNativeCommands(remaining);
+  };
+  const startPhysicalIosEnrollment = async () => {
+    if (!options.iosDevice || !options.certificateAuthorityPath || !options.iosOrigin || new URL(options.iosOrigin).protocol !== "https:") {
+      return;
+    }
+    setState("enrolling-trust");
+    const trustStarted = performance.now();
+    const startEnrollment = options.startCaEnrollmentServer ?? startAbsoluteIosCaEnrollmentServer;
+    caEnrollmentServer = await startEnrollment({
+      certificateAuthorityPath: options.certificateAuthorityPath,
+      displayHost: new URL(options.iosOrigin).hostname
+    });
+    log(`On the iOS device, open ${caEnrollmentServer.url}, install the AbsoluteJS development CA profile, then enable it under Settings > General > About > Certificate Trust Settings. This public CA endpoint exists only for this dev session.`);
+    publishTiming("enrolling-trust", performance.now() - trustStarted);
+  };
+  try {
+    await startPhysicalIosEnrollment();
+    await metroPromise;
+    const metroMs = performance.now() - metroStarted;
+    timings["starting-metro"] = metroMs;
+    options.onPhaseTiming?.({
+      durationMs: metroMs,
+      phase: "starting-metro"
+    });
+    await runNativeCommands(nativeCommands);
+    setState("ready");
+    return {
+      metroPort: plan.metroPort,
+      platforms: options.platforms,
+      timings,
+      close: async () => {
+        options.signal?.removeEventListener("abort", abort);
+        await stopProcess(metro);
+        await closeEnrollmentServer();
+        setState("closed");
+      }
+    };
+  } catch (error) {
+    options.signal?.removeEventListener("abort", abort);
+    await stopProcess(metro);
+    await closeEnrollmentServer();
+    setState("failed");
+    throw error;
+  }
+};
 // src/mobile/ciWorkflow.ts
 import { existsSync as existsSync3 } from "fs";
-import { access as access10, mkdir as mkdir12, readFile as readFile16, writeFile as writeFile13 } from "fs/promises";
+import { access as access11, mkdir as mkdir12, readFile as readFile16, writeFile as writeFile13 } from "fs/promises";
 import { dirname as dirname11, extname as extname4, relative as relative11, resolve as resolve14, sep as sep6 } from "path";
 var ABSOLUTE_MOBILE_CI_WORKFLOW_FORMAT = 1;
 var SECRET_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/u;
@@ -6926,7 +7364,7 @@ var RESERVED_SECRET_NAMES = new Set([
 ]);
 var exists4 = async (path) => {
   try {
-    await access10(path);
+    await access11(path);
     return true;
   } catch {
     return false;
@@ -6969,7 +7407,7 @@ var normalizeSecretEnvironment = (values = []) => {
 };
 var customSecretEnvironment = (names, indentation = CI_ENV_INDENTATION) => names.map((name) => `${" ".repeat(indentation)}${name}: \${{ secrets.${name} }}`).join(`
 `);
-var commandEnvironment = (options) => `      ABSOLUTE_CONFIG_PATH: ${yamlString(options.configPath ?? "")}
+var commandEnvironment2 = (options) => `      ABSOLUTE_CONFIG_PATH: ${yamlString(options.configPath ?? "")}
       ABSOLUTE_REGISTRY_MODULE: ${yamlString(options.registryModule)}
       ABSOLUTE_SERVER_ENTRY: ${yamlString(options.serverEntry)}`;
 var appendConfigArgument = `if [[ -n "$ABSOLUTE_CONFIG_PATH" ]]; then
@@ -7128,7 +7566,7 @@ var androidJob = (options) => {
       ABSOLUTE_ANDROID_KEY_PASSWORD: \${{ secrets.ABSOLUTE_ANDROID_KEY_PASSWORD }}
       ABSOLUTE_ANDROID_KEYSTORE_PATH: \${{ runner.temp }}/absolute-release.jks${publishEnvironment}${custom ? `
 ${custom}` : ""}
-${commandEnvironment({ configPath: undefined, registryModule: "", serverEntry: "" })}
+${commandEnvironment2({ configPath: undefined, registryModule: "", serverEntry: "" })}
     steps:
 ${installSteps}
       - name: Provision Android signing
@@ -7227,7 +7665,7 @@ var iosJob = (options) => {
       ABSOLUTE_IOS_KEYCHAIN_PASSWORD: \${{ secrets.ABSOLUTE_IOS_KEYCHAIN_PASSWORD }}${publishEnvironment}${custom ? `
 ${custom}` : ""}
       ABSOLUTE_IOS_DEVELOPMENT_TEAM: \${{ secrets.ABSOLUTE_IOS_DEVELOPMENT_TEAM }}
-${commandEnvironment({ configPath: undefined, registryModule: "", serverEntry: "" })}
+${commandEnvironment2({ configPath: undefined, registryModule: "", serverEntry: "" })}
     steps:
 ${installSteps}
       - name: Provision iOS signing
@@ -7321,7 +7759,7 @@ var createAbsoluteMobileGithubWorkflow = (options) => {
   const serverEntry = projectPath(options.projectRoot, options.serverEntry ?? "server.ts", "mobile ci github server entry");
   const configPath = options.configPath ? projectPath(options.projectRoot, options.configPath, "mobile ci github --config") : undefined;
   const registryModule = projectPath(options.projectRoot, options.registryModule ?? "mobile.release.ts", "mobile ci github --registry", { allowMissing: !includePublishing });
-  const environment = commandEnvironment({
+  const environment = commandEnvironment2({
     configPath,
     registryModule,
     serverEntry
@@ -7613,7 +8051,7 @@ var createAbsoluteMobilePreviewPlugin = (mobile) => {
 };
 // src/mobile/nativeDeepLinks.ts
 import { readFile as readFile17, rename as rename12, writeFile as writeFile14 } from "fs/promises";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 var START_MARKER = "<!-- absolutejs:deep-links:start -->";
 var END_MARKER = "<!-- absolutejs:deep-links:end -->";
 var IOS_ENTITLEMENTS = "App/AbsoluteJS.entitlements";
@@ -7670,7 +8108,7 @@ ${hosts}
 `;
 };
 var configureAndroid = async (config) => {
-  const path = join18(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
+  const path = join19(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
   const source = await readFile17(path, "utf8");
   const mainActivity = source.indexOf('android:name=".MainActivity"');
   if (mainActivity === NOT_FOUND) {
@@ -7696,7 +8134,7 @@ var iosSchemeRegion = (scheme) => `	${START_MARKER}
 	${END_MARKER}
 `;
 var configureIosInfo = async (config) => {
-  const path = join18(config.nativeProjectDirectory, "ios/App/App/Info.plist");
+  const path = join19(config.nativeProjectDirectory, "ios/App/App/Info.plist");
   const source = await readFile17(path, "utf8");
   const region = config.deepLinkScheme ? iosSchemeRegion(config.deepLinkScheme) : `	${START_MARKER}
 	${END_MARKER}
@@ -7720,7 +8158,7 @@ ${domains}
 `;
 };
 var configureIosEntitlements = async (config) => {
-  const path = join18(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
+  const path = join19(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
   let current = "";
   try {
     current = await readFile17(path, "utf8");
@@ -7738,7 +8176,7 @@ var configureIosEntitlements = async (config) => {
   return true;
 };
 var configureIosProject = async (config) => {
-  const path = join18(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
+  const path = join19(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
   const source = await readFile17(path, "utf8");
   const declarations = [
     ...source.matchAll(/CODE_SIGN_ENTITLEMENTS = ([^;]+);/g)
@@ -7779,7 +8217,7 @@ var applyAbsoluteNativeDeepLinks = async (config, platforms = config.platforms)
 // src/mobile/nativeDeviceCapabilities.ts
 init_deviceCapabilities();
 import { readFile as readFile18, rename as rename13, writeFile as writeFile15 } from "fs/promises";
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->";
 var END_MARKER2 = "<!-- absolutejs:device-capabilities:end -->";
 var NOT_FOUND2 = -1;
@@ -7929,7 +8367,7 @@ var writeIosPrivacyManifest = async (path, current, source) => {
 var configureIosPrivacyProject = async (config, requirements) => {
   if (requirements.iosPrivacyAccessedApis.length === 0)
     return false;
-  const projectPath2 = join19(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
+  const projectPath2 = join20(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
   const project = await readFile18(projectPath2, "utf8");
   return writeChangedFile2(projectPath2, addIosPrivacyProjectReference(project));
 };
@@ -7982,7 +8420,7 @@ ${next.slice(index)}`;
   return next;
 };
 var configureIos2 = async (config, plan) => {
-  const path = join19(config.nativeProjectDirectory, "ios/App/App/Info.plist");
+  const path = join20(config.nativeProjectDirectory, "ios/App/App/Info.plist");
   const source = await readFile18(path, "utf8");
   const requirements = absoluteDeviceNativeRequirements(plan);
   const existingSystemBars = source.match(/<key>UIViewControllerBasedStatusBarAppearance<\/key>\s*<(true|false)\s*\/>/u);
@@ -8003,7 +8441,7 @@ ${content}
 	${END_MARKER2}
 ` : "";
   const infoChanged = await writeChangedFile2(path, managed(source, region, source.lastIndexOf("</dict>")));
-  const privacyPath = join19(config.nativeProjectDirectory, "ios/App/App/PrivacyInfo.xcprivacy");
+  const privacyPath = join20(config.nativeProjectDirectory, "ios/App/App/PrivacyInfo.xcprivacy");
   const privacyCurrent = await optionalSource(privacyPath);
   const privacySource = privacyManifestSource(privacyCurrent, requirements);
   const [privacyChanged, projectChanged, pushChanged] = await Promise.all([
@@ -8014,7 +8452,7 @@ ${content}
   return infoChanged || privacyChanged || projectChanged || pushChanged;
 };
 var configureIosPushNotifications = async (config, enabled) => {
-  const entitlementsPath = join19(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
+  const entitlementsPath = join20(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
   const entitlements = await optionalSource(entitlementsPath);
   if (entitlements === null && !enabled)
     return false;
@@ -8026,7 +8464,7 @@ var configureIosPushNotifications = async (config, enabled) => {
 	<!-- ${PUSH_END_MARKER} -->
 ` : "";
   const nextEntitlements = replacePushRegion(entitlements, entitlementRegion, entitlements.lastIndexOf("</dict>"));
-  const delegatePath = join19(config.nativeProjectDirectory, "ios/App/App/AppDelegate.swift");
+  const delegatePath = join20(config.nativeProjectDirectory, "ios/App/App/AppDelegate.swift");
   const delegate = await optionalSource(delegatePath);
   if (delegate === null && !enabled)
     return false;
@@ -8075,7 +8513,7 @@ var replacePushRegion = (source, region, insertion) => {
   return `${source.slice(0, insertion)}${region}${source.slice(insertion)}`;
 };
 var configureAndroid2 = async (config, plan) => {
-  const path = join19(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
+  const path = join20(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
   const source = await readFile18(path, "utf8");
   const permissions = absoluteDeviceNativeRequirements(plan).androidPermissions;
   const content = permissions.map((permission) => `    <uses-permission android:name="${escapeXml2(permission)}" />`).join(`
@@ -8111,7 +8549,7 @@ ${content}
     throw new TypeError(`Android google-services.json does not contain package ${config.appId}.`);
   const [manifestChanged, firebaseChanged] = await Promise.all([
     writeChangedFile2(path, nextManifest),
-    writeOptionalChangedFile(join19(config.nativeProjectDirectory, "android/app/google-services.json"), firebaseSource)
+    writeOptionalChangedFile(join20(config.nativeProjectDirectory, "android/app/google-services.json"), firebaseSource)
   ]);
   return manifestChanged || firebaseChanged;
 };
@@ -8125,7 +8563,7 @@ var applyAbsoluteNativeDeviceCapabilities = async (projectRoot, config, platform
   };
 };
 // src/mobile/releasePublisher.ts
-import { access as access11 } from "fs/promises";
+import { access as access12 } from "fs/promises";
 import { isAbsolute as isAbsolute6, relative as relative12, resolve as resolve15, sep as sep7 } from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 var prepareAbsoluteIosRelease = async (publisher, options) => {
@@ -8162,7 +8600,7 @@ var publisherModulePath = (projectRoot, requested) => {
 };
 var loadAbsoluteNativeReleasePublisher = async (projectRoot, requestedModulePath) => {
   const modulePath = publisherModulePath(projectRoot, requestedModulePath);
-  await access11(modulePath).catch(() => {
+  await access12(modulePath).catch(() => {
     throw new TypeError(`Native release registry module does not exist: ${modulePath}`);
   });
   const loaded = await import(pathToFileURL3(modulePath).href);
@@ -8972,6 +9410,7 @@ export {
   startAbsoluteIosTcpRelay,
   startAbsoluteIosDevSession,
   startAbsoluteIosCaEnrollmentServer,
+  startAbsoluteExpoDevSession,
   serializeAbsoluteMobileAuthEnvironment,
   runWithAbsoluteMobileProducer,
   runAbsoluteAndroidUpgradeConformance,
@@ -8994,6 +9433,7 @@ export {
   prepareAbsoluteIosRelease,
   prepareAbsoluteIosDevProject,
   prepareAbsoluteAndroidRelease,
+  planAbsoluteExpoDevSession,
   parseIosSimulators,
   parseIosRuntimes,
   parseIosDeviceTypes,
@@ -9075,6 +9515,7 @@ export {
   absoluteRemoteMacSshBase,
   absoluteMobilePreviewDocument,
   absoluteIosDeviceAcceptanceCommands,
+  absoluteExpoExecutable,
   absoluteDeviceNativeRequirements,
   MOBILE_PAGE_REQUEST_HEADERS,
   AbsoluteMobilePageProtocolError,
@@ -9104,5 +9545,5 @@ export {
   ABSOLUTE_ANDROID_RELEASE_FORMAT
 };
 
-//# debugId=81AD994206FFE2B464756E2164756E21
+//# debugId=711828E2D236C77164756E2164756E21
 //# sourceMappingURL=index.js.map