@deeeed/metamask-harness 0.26.4 → 0.26.5

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.26.5 - 2026-07-31
+
+### Fixed
+
+- Forward Mobile launch's resolved Metro port to every runtime leaf so stale slot context cannot start, compile, launch, or observe a second Metro.
+- Propagate inline Segment configuration into detached Mobile Metro runs and invalidate the Metro cache when it changes.
+- Navigate through Mobile's root settings navigator before changing analytics consent.
+
 ## 0.26.4 - 2026-07-31
 
 ### Fixed

package/adapters/mobile/start-metro.sh

@@ -57,6 +57,7 @@ LOG_DIR="$TARGET/$(recipe_runtime_dir)" || exit 1
 mkdir -p "$LOG_DIR"
 LOG_FILE="$LOG_DIR/metro.log"
 PID_FILE="$LOG_DIR/metro.pid"
+INLINE_ENV_FILE="$LOG_DIR/metro-inline-env.sh"
 
 # --- helpers ------------------------------------------------------------------
 
@@ -73,6 +74,24 @@ default_metro_workers() {
   fi
 }
 
+write_inline_metro_env() {
+  local temporary name
+  temporary="$(mktemp "$LOG_DIR/.metro-inline-env.XXXXXX")" || return 1
+  chmod 600 "$temporary" || { rm -f "$temporary"; return 1; }
+  for name in \
+    SEGMENT_PROXY_URL \
+    SEGMENT_WRITE_KEY \
+    SEGMENT_FLUSH_INTERVAL \
+    SEGMENT_FLUSH_EVENT_LIMIT
+  do
+    if declare -p "$name" >/dev/null 2>&1; then
+      printf 'export %s=%q\n' "$name" "${!name}" >> "$temporary" \
+        || { rm -f "$temporary"; return 1; }
+    fi
+  done
+  mv -f "$temporary" "$INLINE_ENV_FILE"
+}
+
 # Log-tail viewer window (session-safe): sourced so its run-owned-session rule is
 # unit-testable and can never leak a window into an unrelated user session.
 # shellcheck disable=SC1091
@@ -96,6 +115,10 @@ set +a
 # build.sh remaps MM_SENTRY_DSN from MM_SENTRY_DSN_DEV for dev builds; quick-launch
 # bypasses it, so without this Sentry never initializes in the dev client.
 [ -n "\${MM_SENTRY_DSN:-}" ] || export MM_SENTRY_DSN="\${MM_SENTRY_DSN_DEV:-}"
+[ ! -f $(printf '%q' "$INLINE_ENV_FILE") ] || {
+  . $(printf '%q' "$INLINE_ENV_FILE")
+  rm -f $(printf '%q' "$INLINE_ENV_FILE")
+}
 export EXPO_NO_TYPESCRIPT_SETUP=1
 export WATCHER_PORT="$(printf '%q' "$PORT")" METRO_PORT="$(printf '%q' "$PORT")"
 export METRO_MAX_WORKERS="$(printf '%q' "$METRO_WORKERS")"
@@ -165,6 +188,11 @@ printf 'Starting Metro on port %s (workers=%s%s)\n' \
   "$PORT" "$METRO_WORKERS" "$CLEAR_LABEL" >&2
 printf '(Full log: %s — mm-harness logs | mm-harness logs --full)\n' "$LOG_FILE" >&2
 
+write_inline_metro_env || {
+  printf 'start-metro: could not stage inline Metro environment\n' >&2
+  exit 1
+}
+
 if ! start_metro_tmux; then
   # Metro runs detached, writing to the log. The tmux window is a read-only tail.
   (
@@ -189,6 +217,11 @@ if ! start_metro_tmux; then
     # = build.sh ios main dev); quick-launch bypasses build.sh, so without this the
     # dev client's MM_SENTRY_DSN stays empty and Sentry never initializes.
     [ -n "${MM_SENTRY_DSN:-}" ] || export MM_SENTRY_DSN="${MM_SENTRY_DSN_DEV:-}"
+    [ ! -f "$INLINE_ENV_FILE" ] || {
+      # shellcheck disable=SC1090
+      . "$INLINE_ENV_FILE"
+      rm -f "$INLINE_ENV_FILE"
+    }
     export EXPO_NO_TYPESCRIPT_SETUP=1
     export WATCHER_PORT="${PORT}" METRO_PORT="${PORT}"
     export METRO_MAX_WORKERS="${METRO_WORKERS}"

package/dist/adapters/mobile/metro-env.js

@@ -3,6 +3,12 @@ import fs from "node:fs";
 import path from "node:path";
 import { recipeRuntimePath } from "../../paths.js";
 const ENV_INPUTS = [".js.env", ".env", ".env.local"];
+const PROCESS_ENV_INPUTS = [
+  "SEGMENT_PROXY_URL",
+  "SEGMENT_WRITE_KEY",
+  "SEGMENT_FLUSH_INTERVAL",
+  "SEGMENT_FLUSH_EVENT_LIMIT"
+];
 const BASELINE_FILE = "metro-env-baseline.json";
 function mobileMetroEnvFingerprint(target) {
   const hash = createHash("sha256");
@@ -13,6 +19,9 @@ function mobileMetroEnvFingerprint(target) {
     else hash.update("<absent>");
     hash.update("\0");
   }
+  for (const name of PROCESS_ENV_INPUTS) {
+    hash.update(`${name}\0${process.env[name] ?? "<absent>"}\0`);
+  }
   return hash.digest("hex");
 }
 function mobileMetroEnvCheck(target) {

package/dist/adapters/mobile/prepare.js

@@ -56,20 +56,34 @@ async function prepareMobile(target, opts = {}) {
         target,
         platform,
         json,
-        preflightMode
+        preflightMode,
+        opts.watcherPort
       );
-      return launch2.status === 0 ? startMobileConsoleForwarder(target, platform, json) : launch2;
+      return launch2.status === 0 ? startMobileConsoleForwarder(target, platform, json, opts.watcherPort) : launch2;
     }
-    const surface = await ensureMobileHumanSurface(target, platform, json);
+    const surface = await ensureMobileHumanSurface(
+      target,
+      platform,
+      json,
+      opts.watcherPort
+    );
     if (surface.status !== 0) return surface;
     const confirm = await dispatchAction(
       { id: "wait-for-bridge", cwd: target, argv: ["--max-polls", String(READY_BRIDGE_CONFIRM_POLLS)] },
       target,
       platform,
       json,
-      preflightMode
+      preflightMode,
+      opts.watcherPort
     );
-    if (confirm.status === 0) return startMobileConsoleForwarder(target, platform, json);
+    if (confirm.status === 0) {
+      return startMobileConsoleForwarder(
+        target,
+        platform,
+        json,
+        opts.watcherPort
+      );
+    }
     if (!json) {
       process.stderr.write(
         `launch: runtime looked ready but no ${platform} bridge target answered; launching the app.
@@ -81,9 +95,10 @@ async function prepareMobile(target, opts = {}) {
       target,
       platform,
       json,
-      preflightMode
+      preflightMode,
+      opts.watcherPort
     );
-    return launch.status === 0 ? startMobileConsoleForwarder(target, platform, json) : launch;
+    return launch.status === 0 ? startMobileConsoleForwarder(target, platform, json, opts.watcherPort) : launch;
   }
   if (report.decision === "unknown") {
     const msg = "mobile prepare: runtime state unknown\n  Next: run mm-harness verify --adapter mobile --target <checkout>";
@@ -97,7 +112,14 @@ async function prepareMobile(target, opts = {}) {
     ) : report.actions,
     restartApp
   );
-  const actionResult = await dispatchActionSequence(actions, target, platform, json, preflightMode);
+  const actionResult = await dispatchActionSequence(
+    actions,
+    target,
+    platform,
+    json,
+    preflightMode,
+    opts.watcherPort
+  );
   if (actionResult.status !== 0) return actionResult;
   if (report.decision === "install" && !process.env["RECIPE_UP_INSTALL_ATTEMPTED"]) {
     process.env["RECIPE_UP_INSTALL_ATTEMPTED"] = "1";
@@ -116,9 +138,21 @@ async function prepareMobile(target, opts = {}) {
         return { status: EXIT.runtime, output: msg };
       }
       case "ready": {
-        const surface = await ensureMobileHumanSurface(target, platform, json);
+        const surface = await ensureMobileHumanSurface(
+          target,
+          platform,
+          json,
+          opts.watcherPort
+        );
         if (surface.status !== 0) return surface;
-        const bridge = await dispatchAction({ id: "wait-for-bridge", cwd: target }, target, platform, json, preflightMode);
+        const bridge = await dispatchAction(
+          { id: "wait-for-bridge", cwd: target },
+          target,
+          platform,
+          json,
+          preflightMode,
+          opts.watcherPort
+        );
         if (bridge.status !== 0) return bridge;
         break;
       }
@@ -128,7 +162,8 @@ async function prepareMobile(target, opts = {}) {
           target,
           platform,
           json,
-          preflightMode
+          preflightMode,
+          opts.watcherPort
         );
         if (result.status !== 0) return result;
         break;
@@ -142,19 +177,33 @@ async function prepareMobile(target, opts = {}) {
       }
     }
   }
-  return startMobileConsoleForwarder(target, platform, json);
+  return startMobileConsoleForwarder(
+    target,
+    platform,
+    json,
+    opts.watcherPort
+  );
 }
-function startMobileConsoleForwarder(target, platform, json) {
+function startMobileConsoleForwarder(target, platform, json, watcherPort) {
   return dispatchAction(
     { id: "start-console-forwarder", cwd: target, argv: json ? ["--quiet"] : [] },
     target,
     platform,
-    json
+    json,
+    "fast",
+    watcherPort
   );
 }
-function ensureMobileHumanSurface(target, platform, json) {
+function ensureMobileHumanSurface(target, platform, json, watcherPort) {
   if (platform !== "ios") return Promise.resolve({ status: 0, output: "" });
-  return dispatchAction({ id: "ensure-device-ui", cwd: target }, target, platform, json);
+  return dispatchAction(
+    { id: "ensure-device-ui", cwd: target },
+    target,
+    platform,
+    json,
+    "fast",
+    watcherPort
+  );
 }
 function withAppRestart(actions, restartApp) {
   if (!restartApp) return actions;
@@ -162,7 +211,7 @@ function withAppRestart(actions, restartApp) {
     (action) => action.id === "launch-mobile-runtime" ? { ...action, argv: [...action.argv ?? [], "--restart"] } : action
   );
 }
-async function dispatchActionSequence(requestedActions, target, platform, json, preflightMode) {
+async function dispatchActionSequence(requestedActions, target, platform, json, preflightMode, watcherPort) {
   const resolved = path.resolve(target);
   const actions = applyMobileMetroEnvPolicy(resolved, requestedActions);
   let pendingMetroEnvFingerprint;
@@ -170,7 +219,14 @@ async function dispatchActionSequence(requestedActions, target, platform, json,
     if (action.id === "start-metro") {
       pendingMetroEnvFingerprint = mobileMetroEnvCheck(resolved).fingerprint;
     }
-    const result = await dispatchAction(action, target, platform, json, preflightMode);
+    const result = await dispatchAction(
+      action,
+      target,
+      platform,
+      json,
+      preflightMode,
+      watcherPort
+    );
     if (result.status !== 0) return result;
     if (action.id === "yarn-setup") recordDepsBaseline(resolved);
     if (action.id === "prewarm-bundle" && pendingMetroEnvFingerprint) {
@@ -184,7 +240,7 @@ async function dispatchActionSequence(requestedActions, target, platform, json,
   }
   return { status: 0, output: "" };
 }
-async function dispatchAction(action, target, platform, json, preflightMode = "fast") {
+async function dispatchAction(action, target, platform, json, preflightMode = "fast", watcherPort) {
   const cwd = action.cwd ?? target;
   switch (action.id) {
     case "yarn-setup": {
@@ -194,34 +250,62 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
     case "start-metro": {
       const leaf = path.join(runnerDir, "adapters/mobile/start-metro.sh");
       const extra = action.argv ?? [];
-      return spawnScriptStreaming(leaf, ["--target", cwd, ...extra], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(["--target", cwd, ...extra], watcherPort),
+        target
+      );
     }
     case "start-console-forwarder": {
       const leaf = path.join(runnerDir, "adapters/mobile/start-console-forwarder.sh");
-      return spawnScriptStreaming(leaf, ["--target", cwd, ...action.argv ?? []], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(
+          ["--target", cwd, ...action.argv ?? []],
+          watcherPort
+        ),
+        target
+      );
     }
     case "prewarm-bundle": {
       const leaf = path.join(runnerDir, "adapters/mobile/prewarm-bundle.sh");
-      return spawnScriptStreaming(leaf, ["--platform", platform, "--target", cwd], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(
+          ["--platform", platform, "--target", cwd, ...action.argv ?? []],
+          watcherPort
+        ),
+        target
+      );
     }
     case "wait-for-bridge": {
       const leaf = path.join(runnerDir, "adapters/mobile/wait-for-bridge.sh");
       const extra = action.argv ?? [];
-      return spawnScriptStreaming(leaf, ["--target", cwd, "--platform", platform, ...extra], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(
+          ["--target", cwd, "--platform", platform, ...extra],
+          watcherPort
+        ),
+        target
+      );
     }
     case "launch-mobile-runtime": {
       const leaf = path.join(runnerDir, "adapters/mobile/open-device.sh");
       return spawnScriptStreaming(
         leaf,
-        [
-          "--platform",
-          platform,
-          "--target",
-          cwd,
-          "--preflight-mode",
-          preflightMode,
-          ...action.argv ?? []
-        ],
+        withWatcherPort(
+          [
+            "--platform",
+            platform,
+            "--target",
+            cwd,
+            "--preflight-mode",
+            preflightMode,
+            ...action.argv ?? []
+          ],
+          watcherPort
+        ),
         target,
         POD_PROBE_ENV
       );
@@ -230,7 +314,10 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
       const leaf = path.join(runnerDir, "adapters/mobile/open-device.sh");
       return spawnScriptStreaming(
         leaf,
-        ["--platform", platform, "--target", cwd, "--ui-only"],
+        withWatcherPort(
+          ["--platform", platform, "--target", cwd, "--ui-only"],
+          watcherPort
+        ),
         target,
         POD_PROBE_ENV
       );
@@ -245,6 +332,10 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
       return { status: 0, output: "" };
   }
 }
+function withWatcherPort(args, watcherPort) {
+  if (watcherPort === void 0 || args.includes("--port")) return args;
+  return [...args, "--port", String(watcherPort)];
+}
 export {
   mobileRuntimeStatus,
   prepareMobile

package/library/actions/mobile/analytics/set_consent.mjs

@@ -6,11 +6,8 @@ const SWITCH_IDS = {
   marketing: 'data-collection-switch',
 };
 
-function toggleExpression(testId, expected, timeoutMs) {
-  return `(async () => {
-    const deadline = Date.now() + ${JSON.stringify(timeoutMs)};
-    let invoked = false;
-    const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function toggleExpression(testId, expected, invoke) {
+  return `(() => {
     const find = () => {
       const hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
       const rootsFor = hook?.getFiberRoots;
@@ -28,57 +25,96 @@ function toggleExpression(testId, expected, timeoutMs) {
       }
       return null;
     };
-    while (Date.now() < deadline) {
-      const target = find();
-      const props = target?.memoizedProps;
-      if (props && Boolean(props.value) === ${JSON.stringify(expected)}) {
-        return { ok: true, testId: ${JSON.stringify(testId)}, changed: invoked };
-      }
-      if (props && !invoked) {
-        if (typeof props.onValueChange !== 'function') {
-          throw new Error('Consent switch has no onValueChange handler: ${testId}');
-        }
-        invoked = true;
-        await props.onValueChange(${JSON.stringify(expected)});
-      }
-      await delay(100);
+    const target = find();
+    const props = target?.memoizedProps;
+    if (!props) return { matched: false, found: false, invoked: false };
+    if (Boolean(props.value) === ${JSON.stringify(expected)}) {
+      return { matched: true, found: true, invoked: false };
+    }
+    if (!${JSON.stringify(invoke)}) {
+      return { matched: false, found: true, invoked: false };
+    }
+    if (typeof props.onValueChange !== 'function') {
+      throw new Error('Consent switch has no onValueChange handler: ${testId}');
     }
-    throw new Error('Timed out setting consent switch ${testId} to ${expected}.');
+    return Promise.resolve(
+      props.onValueChange(${JSON.stringify(expected)})
+    ).then(() => ({
+      matched: false,
+      found: true,
+      invoked: true
+    }));
   })()`;
 }
 
-function stateExpression(participate, marketing, timeoutMs) {
-  return `(async () => {
-    const deadline = Date.now() + ${JSON.stringify(timeoutMs)};
-    const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-    while (Date.now() < deadline) {
-      const state = globalThis.store?.getState?.();
-      const analytics = state?.engine?.backgroundState?.AnalyticsController ?? {};
-      const consent = {
-        optedIn: Boolean(analytics.optedIn),
-        dataCollectionForMarketing: Boolean(state?.security?.dataCollectionForMarketing),
-        analyticsId: analytics.analyticsId ? 'set' : null
-      };
-      if (
+function stateExpression(participate, marketing) {
+  return `(() => {
+    const state = globalThis.store?.getState?.();
+    const analytics = state?.engine?.backgroundState?.AnalyticsController ?? {};
+    const consent = {
+      optedIn: Boolean(analytics.optedIn),
+      dataCollectionForMarketing: Boolean(state?.security?.dataCollectionForMarketing),
+      analyticsId: analytics.analyticsId ? 'set' : null
+    };
+    return {
+      ready:
         consent.optedIn === ${JSON.stringify(participate)} &&
         consent.dataCollectionForMarketing === ${JSON.stringify(marketing)} &&
-        (!${JSON.stringify(participate)} || consent.analyticsId === 'set')
-      ) return consent;
-      await delay(100);
-    }
-    throw new Error('Timed out reading back Mobile analytics consent.');
+        (!${JSON.stringify(participate)} || consent.analyticsId === 'set'),
+      consent
+    };
   })()`;
 }
 
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function setSwitch(input, testId, expected, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  let invoked = false;
+  while (Date.now() < deadline) {
+    const result = await evalAsync(
+      input,
+      toggleExpression(testId, expected, !invoked),
+    );
+    invoked ||= Boolean(result?.invoked);
+    if (result?.matched) {
+      return { ...result, changed: invoked };
+    }
+    await delay(100);
+  }
+  throw new Error(`Timed out setting consent switch ${testId} to ${expected}.`);
+}
+
+async function readConsent(input, participate, marketing, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const result = await evalAsync(
+      input,
+      stateExpression(participate, marketing),
+    );
+    if (result?.ready) {
+      return result.consent;
+    }
+    await delay(100);
+  }
+  throw new Error('Timed out reading back Mobile analytics consent.');
+}
+
 runAdapter(async (input) => {
   const { participate, marketing, timeoutMs } = consentParams(input.node);
 
-  const navigation = await navigate(input, 'SecuritySettings');
-  await evalAsync(input, toggleExpression(SWITCH_IDS.participate, participate, timeoutMs));
-  await evalAsync(input, toggleExpression(SWITCH_IDS.marketing, marketing, timeoutMs));
-  const consent = await evalAsync(
+  const navigation = await navigate(input, 'SettingsView', {
+    screen: 'SecuritySettings',
+  }, 'SecuritySettings');
+  await setSwitch(input, SWITCH_IDS.participate, participate, timeoutMs);
+  await setSwitch(input, SWITCH_IDS.marketing, marketing, timeoutMs);
+  const consent = await readConsent(
     input,
-    stateExpression(participate, marketing, timeoutMs),
+    participate,
+    marketing,
+    timeoutMs,
   );
 
   return {

package/library/actions/mobile/platform/bridge.mjs

@@ -355,11 +355,14 @@ export async function evalSync(input, expression) {
   return parseMaybeJson(await bridgeCommand(input, ['eval', expression]));
 }
 
-export async function navigate(input, route, params = {}) {
+export async function navigate(input, route, params = {}, expectedRoute) {
   const navigation = await bridgeCommand(input, ['navigate', route, JSON.stringify(params)]);
-  const verifiedRoute = navigation && typeof navigation === 'object' && navigation.navigated
-    ? String(navigation.navigated)
-    : String(route);
+  const verifiedRoute = String(
+    expectedRoute ??
+      (navigation && typeof navigation === 'object' && navigation.navigated
+        ? navigation.navigated
+        : route),
+  );
   const currentRoute = await waitForRoute(input, verifiedRoute, Number(input.node?.navigation_timeout_ms ?? 15000));
   return { ...navigation, currentRoute, verifiedRoute };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.26.4",
+  "version": "0.26.5",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"