@absolutejs/absolute 0.20.0-beta.97 → 0.20.0-beta.99

package/dist/mobile/index.js

@@ -30584,9 +30584,39 @@ var generateAbsoluteExpoCodeSigning = async (options) => {
 // src/mobile/expoDevController.ts
 import { spawn } from "child_process";
 import { access as access11 } from "fs/promises";
+import { createServer as createServer2 } from "net";
 import { join as join18, resolve as resolvePath4 } from "path";
 var METRO_READY_TIMEOUT_MS = 120000;
+var METRO_START_MAX_ATTEMPTS = 4;
+var MAX_TCP_PORT = 65535;
 var PROCESS_CLOSE_TIMEOUT_MS = 2000;
+var allocateAvailableMetroPort = () => new Promise((resolve15, reject) => {
+  const server = createServer2();
+  server.unref();
+  server.once("error", reject);
+  server.listen(0, "127.0.0.1", () => {
+    const address = server.address();
+    if (!address || typeof address === "string") {
+      server.close();
+      reject(new Error("Failed to allocate a replacement Metro port."));
+      return;
+    }
+    server.close((error) => {
+      if (error)
+        reject(error);
+      else
+        resolve15(address.port);
+    });
+  });
+});
+var metroPortConflict = (line) => /(?:EADDRINUSE|address already in use|port \d+ is being used by another process)/iu.test(line);
+
+class MetroStartupError extends Error {
+  constructor(exitCode, conflict) {
+    super(`Expo Metro exited with status ${exitCode}.`);
+    this.conflict = conflict;
+  }
+}
 var preserveWindowsSubstRealpaths = `
 const fs = require('node:fs');
 const path = require('node:path');
@@ -31081,7 +31111,7 @@ var parseBootedAbsoluteExpoIosSimulators = (source) => {
   });
 };
 var startAbsoluteExpoDevSession = async (options) => {
-  const plan = planAbsoluteExpoDevSession(options.config, options);
+  let plan = planAbsoluteExpoDevSession(options.config, options);
   const executable = options.executable ?? await absoluteExpoExecutable(plan.project);
   const run = options.spawnProcess ?? spawn;
   const host3 = options.host ?? detectAbsoluteMobileHost();
@@ -31096,9 +31126,9 @@ var startAbsoluteExpoDevSession = async (options) => {
     caEnrollmentServer = null;
     await server?.close();
   };
-  const publishTiming = (phase, durationMs) => {
+  const publishTiming = (phase, durationMs, details = {}) => {
     timings[phase] = (timings[phase] ?? 0) + durationMs;
-    options.onPhaseTiming?.({ durationMs, phase });
+    options.onPhaseTiming?.({ durationMs, phase, ...details });
   };
   const setState = (state) => {
     options.onStateChange?.(state);
@@ -31106,8 +31136,8 @@ var startAbsoluteExpoDevSession = async (options) => {
   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");
+  let metroCommand = plan.commands.find((command) => command.role === "metro");
+  let nativeCommands = plan.commands.filter((command) => command.role === "native-build");
   const runPrepareCommand = async (command) => {
     setState("preparing-native");
     const prepareStarted = performance.now();
@@ -31138,41 +31168,67 @@ var startAbsoluteExpoDevSession = async (options) => {
   if (managedMetro)
     setState("starting-metro");
   const metroStarted = performance.now();
-  const metro = metroCommand ? run(executable, metroCommand.args, {
-    cwd: plan.project,
-    env: { ...process.env, ...metroCommand.env },
-    stdio: ["ignore", "pipe", "pipe"]
-  }) : undefined;
-  let metroReady = false;
-  let resolveMetro;
-  const metroPromise = new Promise((resolve15, reject) => {
-    if (!metro) {
-      resolve15();
-      return;
-    }
+  let metro;
+  let metroRetryCount = 0;
+  const attemptedMetroPorts = [plan.metroPort];
+  const waitForMetroReady = (child) => new Promise((resolve15, reject) => {
+    let ready = false;
+    let conflict = false;
     const timeout = setTimeout(() => {
       reject(new Error("Expo Metro did not become ready within 120 seconds."));
     }, METRO_READY_TIMEOUT_MS);
-    resolveMetro = () => {
-      clearTimeout(timeout);
-      resolve15();
-    };
-    metro.once("exit", (code) => {
-      if (!metroReady) {
+    forwardLines(child, (line) => {
+      if (line)
+        log(`[metro] ${line}`);
+      if (metroPortConflict(line))
+        conflict = true;
+      if (!ready && /(?:Waiting on|Metro waiting on|Dev server ready)/iu.test(line)) {
+        ready = true;
         clearTimeout(timeout);
-        reject(new Error(`Expo Metro exited with status ${code ?? 1}.`));
+        resolve15();
       }
     });
+    child.once("exit", (code) => {
+      if (ready)
+        return;
+      clearTimeout(timeout);
+      reject(new MetroStartupError(code ?? 1, conflict));
+    });
   });
-  if (metro)
-    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 startManagedMetro = async () => {
+    if (!metroCommand)
+      return;
+    if (options.signal?.aborted)
+      throw abortError();
+    metro = run(executable, metroCommand.args, {
+      cwd: plan.project,
+      env: { ...process.env, ...metroCommand.env },
+      stdio: ["ignore", "pipe", "pipe"]
     });
+    try {
+      await waitForMetroReady(metro);
+    } catch (error) {
+      if (!(error instanceof MetroStartupError) || !error.conflict || attemptedMetroPorts.length >= METRO_START_MAX_ATTEMPTS) {
+        throw error;
+      }
+      await stopProcess(metro);
+      const allocate = options.allocateMetroPort ?? allocateAvailableMetroPort;
+      const replacementPort = await allocate(attemptedMetroPorts);
+      if (!Number.isSafeInteger(replacementPort) || replacementPort < 1 || replacementPort > MAX_TCP_PORT || attemptedMetroPorts.includes(replacementPort)) {
+        throw new Error("Could not allocate a distinct replacement Metro port.", { cause: error });
+      }
+      attemptedMetroPorts.push(replacementPort);
+      metroRetryCount += 1;
+      log("Metro port was claimed during startup; retrying automatically on a new port.");
+      plan = planAbsoluteExpoDevSession(options.config, {
+        ...options,
+        metroPort: replacementPort
+      });
+      metroCommand = plan.commands.find((command) => command.role === "metro");
+      nativeCommands = plan.commands.filter((command) => command.role === "native-build");
+      await startManagedMetro();
+    }
+  };
   const abort = () => {
     if (metro)
       stopProcess(metro);
@@ -31187,7 +31243,7 @@ var startAbsoluteExpoDevSession = async (options) => {
     const state = platform2 === "android" ? "building-android" : "building-ios";
     setState(state);
     const started = performance.now();
-    const invocation = platform2 === "android" && host3 === "wsl" ? encodedWindowsExpoAndroidCommand(plan.project, options.androidRoot ?? absoluteManagedAndroidSdkRoot(host3), options.config.appId, command.args, capture, options.metroPort, options.androidDevice) : [executable, ...command.args];
+    const invocation = platform2 === "android" && host3 === "wsl" ? encodedWindowsExpoAndroidCommand(plan.project, options.androidRoot ?? absoluteManagedAndroidSdkRoot(host3), options.config.appId, command.args, capture, plan.metroPort, options.androidDevice) : [executable, ...command.args];
     if (platform2 === "android" && host3 === "wsl") {
       log("[android] Mirroring native inputs to the Windows host for accelerated Expo build and launch.");
     }
@@ -31215,7 +31271,7 @@ var startAbsoluteExpoDevSession = async (options) => {
     if (platform2 === "android" && host3 !== "wsl") {
       const androidRoot = options.androidRoot ?? process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT ?? absoluteManagedAndroidSdkRoot(host3);
       const adb = options.androidAdb ?? join18(androidRoot, "platform-tools", host3 === "windows" ? "adb.exe" : "adb");
-      connectLocalExpoAndroid(adb, options.config.appId, options.metroPort, capture, options.androidDevice);
+      connectLocalExpoAndroid(adb, options.config.appId, plan.metroPort, capture, options.androidDevice);
       log("Connected the Expo Android development client to Metro.");
     }
     if (platform2 === "ios" && options.certificateAuthorityPath && options.iosOrigin && new URL(options.iosOrigin).protocol === "https:" && !options.iosDevice) {
@@ -31253,7 +31309,7 @@ var startAbsoluteExpoDevSession = async (options) => {
         "simctl",
         "openurl",
         "booted",
-        expoDevelopmentClientUrl(options.config.appId, options.metroHost ?? "localhost", options.metroPort)
+        expoDevelopmentClientUrl(options.config.appId, options.metroHost ?? "localhost", plan.metroPort)
       ], utilityOptions);
       if (connectExit !== 0)
         throw new Error(`Expo iOS Simulator Metro connection exited with status ${connectExit}.`);
@@ -31286,9 +31342,14 @@ var startAbsoluteExpoDevSession = async (options) => {
   };
   try {
     await startPhysicalIosEnrollment();
-    await metroPromise;
+    await startManagedMetro();
     if (managedMetro)
-      publishTiming("starting-metro", performance.now() - metroStarted);
+      publishTiming("starting-metro", performance.now() - metroStarted, {
+        ...metroRetryCount > 0 ? {
+          reason: "metro-port-conflict",
+          retryCount: metroRetryCount
+        } : {}
+      });
     await runNativeCommands(nativeCommands);
     setState("ready");
     let closed = false;
@@ -31336,6 +31397,97 @@ var startAbsoluteExpoDevSession = async (options) => {
     throw error;
   }
 };
+// src/mobile/expoAndroidQuality.ts
+var KIB_PER_MIB = 1024;
+var XML_BOUND_BOTTOM_INDEX = 4;
+var XML_BOUND_LEFT_INDEX = 1;
+var XML_BOUND_RIGHT_INDEX = 3;
+var XML_BOUND_TOP_INDEX = 2;
+var DEFAULT_ABSOLUTE_EXPO_ANDROID_QUALITY_BUDGETS = {
+  bridgeP95Ms: 500,
+  coldLaunchMs: 25000,
+  hmrP95Ms: 1e4,
+  maxMemoryGrowthMiB: 160,
+  maxTotalPssMiB: 700,
+  minTouchTargetDp: 44,
+  warmLaunchMs: 5000
+};
+var requiredInteger = (source, name) => {
+  const match = new RegExp(`^${name}:\\s*(\\d+)$`, "mu").exec(source);
+  const value = Number(match?.[1]);
+  if (!Number.isSafeInteger(value))
+    throw new TypeError(`Android launch output is missing ${name}.`);
+  return value;
+};
+var optionalInteger = (source, name) => {
+  const match = new RegExp(`^${name}:\\s*(\\d+)$`, "mu").exec(source);
+  if (!match)
+    return;
+  const value = Number(match[1]);
+  if (!Number.isSafeInteger(value))
+    throw new TypeError(`Android launch output has invalid ${name}.`);
+  return value;
+};
+var parseAbsoluteExpoAndroidLaunchTiming = (source) => ({
+  launchState: /^LaunchState:\s*(\S+)$/mu.exec(source)?.[1],
+  thisTimeMs: optionalInteger(source, "ThisTime"),
+  totalTimeMs: requiredInteger(source, "TotalTime"),
+  waitTimeMs: requiredInteger(source, "WaitTime")
+});
+var parseAbsoluteExpoAndroidMemory = (source) => {
+  const summary = /^\s*TOTAL PSS:\s*(\d+)/mu.exec(source)?.[1];
+  const table = /^\s*TOTAL\s+(\d+)\s+/mu.exec(source)?.[1];
+  const totalPssKiB = Number(summary ?? table);
+  if (!Number.isSafeInteger(totalPssKiB) || totalPssKiB < 0)
+    throw new TypeError("Android meminfo output is missing total PSS.");
+  return { totalPssKiB };
+};
+var decodeXml = (value) => value.replaceAll("&quot;", '"').replaceAll("&apos;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
+var nodeAttributes = (source) => Object.fromEntries([...source.matchAll(/([\w:-]+)="([^"]*)"/gu)].map(([, name = "", value = ""]) => [name, decodeXml(value)]));
+var nodeBounds = (source) => {
+  const match = /^\[(\d+),(\d+)\]\[(\d+),(\d+)\]$/u.exec(source);
+  if (!match)
+    return { bottom: 0, left: 0, right: 0, top: 0 };
+  return {
+    bottom: Number(match[XML_BOUND_BOTTOM_INDEX]),
+    left: Number(match[XML_BOUND_LEFT_INDEX]),
+    right: Number(match[XML_BOUND_RIGHT_INDEX]),
+    top: Number(match[XML_BOUND_TOP_INDEX])
+  };
+};
+var absoluteAndroidNodeLabel = (node) => node.contentDescription.trim() || node.text.trim();
+var absoluteAndroidTouchTargetDp = (node, density) => {
+  if (!Number.isFinite(density) || density <= 0)
+    throw new TypeError("Android display density must be positive.");
+  return {
+    height: (node.bounds.bottom - node.bounds.top) / density,
+    width: (node.bounds.right - node.bounds.left) / density
+  };
+};
+var absolutePercentile = (values, ratio) => {
+  if (values.length === 0)
+    throw new TypeError("A percentile requires at least one measurement.");
+  if (!Number.isFinite(ratio) || ratio < 0 || ratio > 1)
+    throw new TypeError("A percentile ratio must be between zero and one.");
+  const ordered = [...values].sort((left, right) => left - right);
+  const index = Math.ceil(ratio * ordered.length) - 1;
+  return ordered[Math.max(0, index)] ?? 0;
+};
+var absolutePssMiB = (memory) => memory.totalPssKiB / KIB_PER_MIB;
+var parseAbsoluteAndroidAccessibilityHierarchy = (source) => [...source.matchAll(/<node\s+([^>]*?)\/?>(?:<\/node>)?/gu)].map(([, raw = ""]) => {
+  const attributes = nodeAttributes(raw);
+  return {
+    bounds: nodeBounds(attributes.bounds ?? ""),
+    className: attributes.class ?? "",
+    clickable: attributes.clickable === "true",
+    contentDescription: attributes["content-desc"] ?? "",
+    enabled: attributes.enabled === "true",
+    packageName: attributes.package ?? "",
+    resourceId: attributes["resource-id"] ?? "",
+    text: attributes.text ?? "",
+    visible: attributes["visible-to-user"] !== "false"
+  };
+});
 // src/mobile/expoNativeWatcher.ts
 import { watch as watch2 } from "fs";
 import { access as access12, readdir as readdir5, readFile as readFile16 } from "fs/promises";
@@ -40794,8 +40946,11 @@ export {
   ANDROID_ASSOCIATION_PATH,
   APPLE_ASSOCIATION_PATH,
   AbsoluteMobilePageProtocolError,
+  DEFAULT_ABSOLUTE_EXPO_ANDROID_QUALITY_BUDGETS,
   DEFAULT_MOBILE_UPDATE_REGISTRY_MODULE,
   MOBILE_PAGE_REQUEST_HEADERS,
+  absoluteAndroidNodeLabel,
+  absoluteAndroidTouchTargetDp,
   absoluteDeviceNativeRequirements,
   absoluteExpoExecutable,
   absoluteExpoNativeObservabilityFiles,
@@ -40803,6 +40958,8 @@ export {
   absoluteIosDeviceAcceptanceCommands,
   absoluteMobilePreviewDocument,
   absoluteMobileUpdateSigningPayload,
+  absolutePercentile,
+  absolutePssMiB,
   absoluteRemoteMacSshBase,
   absoluteRemoteProjectSyncCommands,
   absoluteRemoteReleaseInputSyncCommands,
@@ -40918,7 +41075,10 @@ export {
   normalizeAbsoluteMobileUpdatePath,
   openAbsoluteMobileSheet,
   pairAbsoluteRemoteMac,
+  parseAbsoluteAndroidAccessibilityHierarchy,
   parseAbsoluteAndroidInstalledApp,
+  parseAbsoluteExpoAndroidLaunchTiming,
+  parseAbsoluteExpoAndroidMemory,
   parseAbsoluteExpoBridgeMessage,
   parseAbsoluteExpoUpdateDescriptor,
   parseAbsoluteIosHmrLog,
@@ -40996,5 +41156,5 @@ export {
   writeAbsoluteMobileUpdateRegistry
 };
 
-//# debugId=CC8C4D11922DDEB264756E2164756E21
+//# debugId=9BE9503423C665BD64756E2164756E21
 //# sourceMappingURL=index.js.map