peachsim 0.1.1404 → 0.1.1463

package/LICENSE

@@ -5,10 +5,14 @@ Copyright (c) Tamagui LLC. All rights reserved.
 This package (peachsim) is proprietary software of Tamagui LLC, licensed under
 the Peach Software License Agreement: https://peachsim.com/legal/license
 
-In summary (the agreement governs): personal, non-commercial use is free;
-commercial use requires an active Pro subscription after a single 30-day
-evaluation period; embedding or redistributing the software requires a
-separate written agreement with Tamagui LLC.
+In summary (the agreement governs): Seed is free for individuals and companies
+under 10 people and under $1M yearly revenue, including commercial desktop and
+local use. A company at or above either limit needs Team while it has under
+100 people and under $10M yearly revenue, or Enterprise at or above either of
+those limits. Members, agents, API keys and local simulators are unlimited.
+Company size is self-reported and enforced through the license terms only.
+Embedding or redistributing the software requires a separate written agreement
+with Tamagui LLC.
 
 Versions of this package published before this license change remain under
 the license they were published with.

package/README.md

@@ -11,7 +11,8 @@ installation. The `peachsim` npm package contains bundler plugins, testing
 drivers, and library exports; its only command, `npx peachsim`, runs that same
 installer from the copy of `install.sh` it ships.
 
-The executable updates itself with `peach upgrade`. Successful interactive human
+The executable updates itself with `peach upgrade`, which then restarts a running
+background daemon onto the new executable and runtime. Successful interactive human
 commands refresh a cached stable CLI version in a detached process at most once
 every 20 hours. A newer version produces one short notice on stderr, once per
 version and no more than weekly. CI, agents, JSON output, pipes, and
@@ -151,7 +152,8 @@ graph TD
 **The CLI process** (`cli/bin.ts` routes, `cli/main.ts` parses argv) lazy-imports
 exactly one command module per run. Bare `peach` opens ConnectRN, whose simulator UI discovers
 running React Native development servers. The first human run offers the
-recommended background service and optional Desktop app, then opens the simulator
+recommended background service and simulator window; on Mac, Desktop uses an
+already installed app. It then opens the simulator
 before asking about private diagnostics or an optional repository install. `peach open`
 ensures the engine runtime exists when the bridge supplies the shell and starts
 a local foreground bridge when no daemon is reachable, then opens a `WsBridge`
@@ -173,6 +175,16 @@ browser launch inside a Team Machine session and prints the URL plus
 `--driver playwright --headless` guidance. Interactive human launches keep
 their system browser behavior.
 
+For apps using `react-native-config`, open with `peach open <app-port> --load-env`.
+This reads the local project's native dotenv values for `RNCConfigModule`;
+`runtimeConfig.env` populates the guest's `process.env` independently. Starting a
+sidecar or supplying process environment variables does not select the app's
+native API roots. Verify the mounted app's `Config` values and captured request
+destinations before driving a network flow. Without `--load-env`, the native
+config dictionary is empty and the app can select its own public defaults.
+Preserve failures from those endpoints rather than remapping them to a successful
+local response. The same flag is available on `peach flow`.
+
 **The daemon is one process** — `SootSimBridgeHost` (`src/host/bridge-host.ts`).
 `peach serve` runs it in the foreground; the background daemon is the *same
 process* wrapped with autostart and the `~/.peach/daemon.json` lockfile. It is
@@ -194,6 +206,9 @@ shell's bridge world without reading the other process's lockfile directory.
 An explicit `--port` also participates in `--sim` ownership discovery even
 without a local heartbeat record. The bridge must report that simulator as
 open; a port that names another simulator's world is rejected.
+SDK `connect({ sim })` and batched `do --then` actions use that same ownership
+discovery. An inferred default port does not override the named sim's world;
+an explicit SDK port or CLI `--port` retains the ownership check.
 
 **The sim** is a browser/Electron *page* launched by a CLI driver. Inside that
 page run three workers: the **shell worker** owns device and native state, the
@@ -278,6 +293,11 @@ library path, so no host needs `apt-get` or root. The bundle is pinned in
 `cli/drivers/linux-browser-libs.lock.json`; `bun scripts/linux-browser-libs.ts
 resolve` re-pins it, and the CLI release publishes any bundle the bucket lacks.
 
+On Mac, headless launches attach an installed compatible native host. With no
+host, they render in the browser without downloading or placing the app. The
+browser logo menu offers the app; `peach desktop install --native` remains the
+explicit CLI installer. Linux still acquires its standalone host under `~/.peach`.
+
 Headed launches on Linux use full Chromium, whose extra libraries the bundle
 also carries. Later opens reuse that sim and
 reload it at the requested target. Use `peach do reload` when the target has not

package/cli/app-fonts.ts

@@ -22,6 +22,11 @@ export type DiscoveredAppFontSpec = ConfigPluginFontSpec
 
 type ExpoConfigGetter = (dir: string, opts: Record<string, unknown>) => { exp?: unknown }
 
+// every font file is found on disk, so the asset urls are decided here and
+// never by asking the dev server: metro's asset endpoint resolves a path
+// against its config.projectRoot, which is the root it advertises and the one
+// projectDir names. a reachability request would make the result depend on how
+// busy the dev server is, and a cold build answers late enough to drop fonts.
 export function discoverNativeLinkedAppFonts(opts: {
   bundleUrl: string
   projectDir: string
@@ -29,13 +34,35 @@ export function discoverNativeLinkedAppFonts(opts: {
 }): DiscoveredAppFontSpec[] {
   const metroOrigin = loopbackOriginOf(opts.bundleUrl)
   if (!metroOrigin) return []
-  return metroFontSpecsFromPaths(discoverNativeLinkedAppFontPaths(opts), metroOrigin)
+  const specs = metroFontSpecsFromPaths(
+    projectRelativeFontPaths(opts.projectDir, discoverNativeLinkedAppFontPaths(opts)),
+    metroOrigin,
+  )
+  // a family linked from more than one file keeps the first declaration.
+  const byFamily = new Map<string, DiscoveredAppFontSpec>()
+  for (const spec of specs)
+    if (!byFamily.has(spec.family)) byFamily.set(spec.family, spec)
+  return [...byFamily.values()]
+}
+
+function projectRelativeFontPaths(projectDir: string, fontPaths: string[]): string[] {
+  return fontPaths.map((fontPath) =>
+    path.relative(path.resolve(projectDir), fontPath).split(path.sep).join('/'),
+  )
 }
 
+function isFile(filePath: string): boolean {
+  try {
+    return fs.statSync(filePath).isFile()
+  } catch {
+    return false
+  }
+}
+
+// absolute paths of every existing font file the native app links.
 function discoverNativeLinkedAppFontPaths(opts: {
   projectDir: string
   platform?: string
-  bundleUrl?: string
 }): string[] {
   const project = resolveAppProject(opts.projectDir)
   const selectedAppDir = project?.appDir ?? null
@@ -69,10 +96,14 @@ function discoverNativeLinkedAppFontPaths(opts: {
     } catch {}
   }
 
+  // a declared path with no file behind it links nothing natively.
   const fontPaths = expoFontPathsFromPlugins(
     plugins,
     platform === 'android' ? 'android' : 'ios',
-  ).slice(0, 256)
+  )
+    .slice(0, 256)
+    .map((fontPath) => path.resolve(selectedAppDir, fontPath))
+    .filter(isFile)
   // the walk is bounded by WORK, not by a clock: at most 64 readdirs, at most 64
   // queued dirs, 4 levels deep, 256 paths. those ceilings are what keep a stray
   // node_modules from being crawled, and no machine can blow through them. a
@@ -81,7 +112,7 @@ function discoverNativeLinkedAppFontPaths(opts: {
   // and no error at all.
   let scannedFontDirectories = 0
 
-  const collectFontFiles = (root: string, metroPathPrefix: string): void => {
+  const collectFontFiles = (root: string): void => {
     const pending: Array<{ dir: string; depth: number }> = [{ dir: root, depth: 0 }]
     let nextIndex = 0
     while (
@@ -108,8 +139,7 @@ function discoverNativeLinkedAppFontPaths(opts: {
           continue
         }
         if (!entry.isFile() || !/\.(ttf|otf|woff|woff2)$/i.test(entry.name)) continue
-        const relative = path.relative(root, fullPath).split(path.sep).join('/')
-        fontPaths.push(path.posix.join(metroPathPrefix, relative))
+        fontPaths.push(fullPath)
         if (fontPaths.length >= 256) break
       }
     }
@@ -145,18 +175,7 @@ function discoverNativeLinkedAppFontPaths(opts: {
       const root = path.resolve(selectedAppDir, configuredDir)
       const relativeRoot = path.relative(selectedAppDir, root)
       if (!relativeRoot.startsWith('..') && !path.isAbsolute(relativeRoot)) {
-        collectFontFiles(root, relativeRoot.split(path.sep).join('/'))
-      }
-
-      // the bundle path is the entry relative to metro's root, so a bundle at
-      // /apps/app/index.bundle served for /repo/apps/app puts that root at /repo.
-      const bundleDir = path.posix
-        .dirname(opts.bundleUrl ? new URL(opts.bundleUrl).pathname : '/')
-        .replace(/^\/+/, '')
-      const appRelativeDir = bundleDir.split('/').join(path.sep)
-      const metroRootCandidates = [selectedAppDir]
-      if (bundleDir && selectedAppDir.endsWith(path.sep + appRelativeDir)) {
-        metroRootCandidates.push(selectedAppDir.slice(0, -appRelativeDir.length - 1))
+        collectFontFiles(root)
       }
       const vectorIconRequire = createRequire(path.join(selectedAppDir, 'package.json'))
       for (const dependencyName of vectorIconDependencies) {
@@ -170,18 +189,9 @@ function discoverNativeLinkedAppFontPaths(opts: {
           const fontsDir =
             dependencyName === 'react-native-vector-icons' ? 'Fonts' : 'fonts'
           // the package can sit outside the app (a hoisted workspace
-          // node_modules or a pnpm store). metro resolves asset paths against
-          // its config.projectRoot, which is the app in expo's monorepo setup
-          // but the repo root when metro.config sets it there, so offer the
-          // path from each candidate root; the reachability check keeps the
-          // one metro actually serves.
-          const fontsRoot = path.join(packageRoot, fontsDir)
-          for (const metroRoot of metroRootCandidates) {
-            collectFontFiles(
-              fontsRoot,
-              path.relative(metroRoot, fontsRoot).split(path.sep).join('/'),
-            )
-          }
+          // node_modules or a pnpm store); its fonts are then served through
+          // metro's unstable_path from the watch folder that holds its js.
+          collectFontFiles(path.join(packageRoot, fontsDir))
         } catch {}
       }
     }
@@ -206,7 +216,7 @@ function discoverNativeLinkedAppFontPaths(opts: {
           const root = path.resolve(selectedAppDir, assetDir)
           const relativeRoot = path.relative(selectedAppDir, root)
           if (relativeRoot.startsWith('..') || path.isAbsolute(relativeRoot)) continue
-          collectFontFiles(root, relativeRoot.split(path.sep).join('/'))
+          collectFontFiles(root)
         }
       }
     }
@@ -252,16 +262,9 @@ function discoverNativeLinkedAppFontPaths(opts: {
           const fontPath = candidates.find((candidate) => {
             const relative = path.relative(selectedAppDir, candidate)
             if (relative.startsWith('..') || path.isAbsolute(relative)) return false
-            try {
-              return fs.statSync(candidate).isFile()
-            } catch {
-              return false
-            }
+            return isFile(candidate)
           })
-          if (!fontPath) continue
-          fontPaths.push(
-            path.relative(selectedAppDir, fontPath).split(path.sep).join('/'),
-          )
+          if (fontPath) fontPaths.push(fontPath)
         }
       }
     } catch {}
@@ -280,10 +283,13 @@ export function readNativeLinkedAppFontsWire(opts: {
     throw new Error(`native font project is unavailable: ${opts.projectDir}`)
   }
   return encodeAppFontsWire(
-    nativeLinkedFontSpecsFromPaths(discoverNativeLinkedAppFontPaths(opts), (fontPath) => {
-      const bytes = fs.readFileSync(path.resolve(opts.projectDir, fontPath))
-      return `data:${fontContentType(fontPath)};base64,${bytes.toString('base64')}`
-    }),
+    nativeLinkedFontSpecsFromPaths(
+      projectRelativeFontPaths(opts.projectDir, discoverNativeLinkedAppFontPaths(opts)),
+      (fontPath) => {
+        const bytes = fs.readFileSync(path.resolve(opts.projectDir, fontPath))
+        return `data:${fontContentType(fontPath)};base64,${bytes.toString('base64')}`
+      },
+    ),
   )
 }
 

package/cli/bin.ts

@@ -10,16 +10,17 @@
 // whole process, so the CLI itself lives in `./main` and is imported only once
 // none of them has claimed the run.
 
+import { exitWithFlushedOutput } from '../src/process-output'
 import { RNX_FORKED_SCRIPT_ENV, RNX_INTERNAL_COMMAND } from './internal-child'
 
 if (process.argv[2] === '__shell-init') {
   const { renderRnxShellInit } = await import('./shell-init')
   try {
     process.stdout.write(renderRnxShellInit(process.argv[3] ?? ''))
-    process.exit(0)
+    await exitWithFlushedOutput(0)
   } catch (error) {
     process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`)
-    process.exit(1)
+    await exitWithFlushedOutput(1)
   }
 }
 
@@ -34,14 +35,14 @@ if (process.argv[2] === '__cloud-confirm') {
     // a box has no claim to keep alive: its simulator is held by the Box page
     // for as long as the box runs, so a shell on a box confirms nothing.
     if (session.service === 'sim') await confirmCloudSimulator(session)
-    process.exit(0)
+    await exitWithFlushedOutput(0)
   } catch (error) {
     process.stderr.write(
       `Peach Cloud confirmation failed: ${
         error instanceof Error ? error.message : String(error)
       }\n`,
     )
-    process.exit(1)
+    await exitWithFlushedOutput(1)
   }
 }
 

package/cli/bridge-diagnostics.ts

@@ -201,6 +201,11 @@ export async function printBridgeFailureDiagnostics(
   bridge: WsBridge,
   opts: FailureDiagnosticsOptions = {},
 ) {
+  try {
+    if (!(await bridge.listSims()).some((sim) => sim.readyState === 'open')) return
+  } catch {
+    // an unavailable inventory must not discard the existing diagnostic reads
+  }
   try {
     await printBridgeStateSummary(bridge)
   } catch {

package/cli/bridge-flow-runner.ts

@@ -10,7 +10,7 @@ import {
   isPeachAccessibilityTree,
   waitReadyReason,
 } from './commands/inspect/core'
-import { waitForSootsimIdle } from './commands/inspect/settling'
+import { IdleObservationError, waitForSootsimIdle } from './commands/inspect/settling'
 import { callShellCommandWhenReady, getShellState } from './commands/inspect/shared'
 import { PERMISSION_KINDS } from './commands/permissions'
 import { saveCurrentSimId } from './current-sim'
@@ -2753,18 +2753,26 @@ export class SootSimBridgeFlowRunner {
   // a screen that never stops proceeds when the budget runs out, as there,
   // and names what kept it moving: every such step pays the whole budget.
   private async waitForAppToSettle() {
-    const result = await waitForSootsimIdle({
-      bridge: this.bridge,
-      simId: this.opts.simId,
-      maxMs: 3000,
-      pollMs: 32,
-      strict: true,
-      paintStill: true,
-    })
-    if (!result.settled) {
-      console.warn(
-        `  [flow]   still moving after ${result.elapsed}ms: ${result.blockedBy}`,
-      )
+    try {
+      const result = await waitForSootsimIdle({
+        bridge: this.bridge,
+        simId: this.opts.simId,
+        maxMs: 3000,
+        pollMs: 32,
+        strict: true,
+        paintStill: true,
+      })
+      if (!result.settled) {
+        console.warn(
+          `  [flow]   still moving after ${result.elapsed}ms: ${result.blockedBy}`,
+        )
+      }
+    } catch (error) {
+      if (error instanceof IdleObservationError) {
+        console.warn(`  [flow]   ${error.message}`)
+        return
+      }
+      throw error
     }
   }
 

package/cli/cloud-client.ts

@@ -24,6 +24,7 @@ import {
   buildRnxCloudArtifact,
   type RnxCloudArtifactReceipt,
 } from '../../contrast-bundler/src/metroCloudArtifact.ts'
+import { rewriteGuestImportMeta } from '../../peach-engine/src/guest-import-meta.ts'
 import { loadMetroFingerprintRegistry } from '../../peach-engine/src/metro-fingerprint-registry-client.ts'
 import { inferMetroModuleIdentity } from '../../peach-engine/src/metro-fingerprint.ts'
 import { isLoopbackHost } from '../src/backend-origin.ts'
@@ -260,10 +261,10 @@ async function loadBundleSource(bundleInput: string): Promise<string> {
   const source = isRemoteBundleInput(bundleInput)
     ? await fetchBundleSource(bundleInput)
     : readImmutableBundleSource(bundleInput)
-  // a box evaluates the bundle as a script; refuse invalid syntax before
-  // allocating a billable host. compiling does not execute guest code.
+  // validate the actual runtime script form without executing guest code or
+  // allocating a host.
   try {
-    new Script(source, { filename: bundleInput })
+    new Script(rewriteGuestImportMeta(source), { filename: bundleInput })
   } catch (error) {
     throw new Error(
       `${REMOTE_COMMAND} bundle contains invalid JavaScript: ${