rnxsim 0.1.458 → 0.1.460

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.458 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.460 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.458",
+  "version": "0.1.460",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/src/bridge-contract-input.ts

@@ -1,9 +1,8 @@
+import { SIM_LONG_PRESS_MAX_MS } from './bridge-contract'
 // untrusted JSON -> bridge-contract argument. one owner for that conversion, so
 // every transport in front of a sim (the RNX Cloud sim service's HTTP and
 // WebSocket routes) validates its request bodies here rather than growing a
 // second reader for the same shapes.
-
-import { SIM_LONG_PRESS_MAX_MS } from './bridge-contract'
 import type {
   ResetOptions,
   SemanticWaitOptions,
@@ -13,6 +12,7 @@ import type {
   SimStateOptions,
 } from './bridge-contract'
 import type { SimPerformStep, SimScreenshotOptions } from './sim-client'
+import type { SootSimReplayTarget } from '@rnx/globals'
 
 /** the caller sent a value this bridge argument cannot be read from. */
 export class BridgeInputError extends Error {
@@ -113,6 +113,7 @@ export function parsePerformStep(value: unknown, index: number): SimPerformStep
     case 'tap':
       return {
         type,
+        target: parseTapTarget(step.target),
         x: numberValue(step.x, `${path}.x`),
         y: numberValue(step.y, `${path}.y`),
       }
@@ -388,3 +389,22 @@ export function parseScreenshotOptions(value: unknown): SimScreenshotOptions {
         }),
   }
 }
+
+export function parseTapTarget(value: unknown): SootSimReplayTarget | undefined {
+  if (value === undefined) return undefined
+  const input = recordValue(value, 'tap.target')
+  const target: SootSimReplayTarget = {}
+  if (input.nodeId !== undefined && input.nodeId !== null) {
+    const nodeId = numberValue(input.nodeId, 'tap.target.nodeId')
+    if (!Number.isSafeInteger(nodeId))
+      validationFailure('tap.target.nodeId', 'must be an integer')
+    target.nodeId = nodeId
+  }
+  for (const key of ['id', 'testID', 'text', 'type'] as const) {
+    if (input[key] !== undefined && input[key] !== null)
+      target[key] = stringValue(input[key], `tap.target.${key}`)
+  }
+  if (target.nodeId === undefined && !target.testID && !target.id)
+    validationFailure('tap.target', 'requires nodeId, testID or id')
+  return target
+}

package/src/host/bridge-host.ts

@@ -223,6 +223,7 @@ interface BridgeForwardedCommand {
 }
 
 export interface BridgeHostOptions {
+  /** use 0 for an OS-assigned port; startAsync returns the bound address. */
   port?: number
   openUrl?: (url: string, options?: OpenUrlOptions) => Promise<void> | void
   /** Contrast-specific excludes for the agent host's dev-server scan. passed
@@ -466,7 +467,7 @@ export class SootSimBridgeHost {
   private static SCAN_FRESH_MS = 2000
 
   constructor(opts: BridgeHostOptions = {}) {
-    this.preferredPort = opts.port || DEFAULT_SOOTSIM_BRIDGE_PORT
+    this.preferredPort = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT
     this.port = this.preferredPort
     // default off — callers that want the lockfile (rnx serve) opt in.
     this.shouldWriteLockfile = opts.writeLockfile === true
@@ -537,9 +538,9 @@ export class SootSimBridgeHost {
     for (let attempt = 0; attempt < this.portFallbackCount; attempt++) {
       const candidate = this.preferredPort + attempt
       try {
-        await this.bindOnce(candidate, options?.silent === true)
-        this.effectivePort = candidate
-        this.port = candidate
+        const boundPort = await this.bindOnce(candidate, options?.silent === true)
+        this.effectivePort = boundPort
+        this.port = boundPort
         this.startedAt = Date.now()
         if (attempt > 0 && !options?.silent) {
           process.stderr.write(
@@ -547,7 +548,7 @@ export class SootSimBridgeHost {
           )
         }
         this.afterBind()
-        return candidate
+        return boundPort
       } catch (err: unknown) {
         const e = err as NodeJS.ErrnoException
         if (e?.code !== 'EADDRINUSE') {
@@ -566,8 +567,8 @@ export class SootSimBridgeHost {
     )
   }
 
-  private bindOnce(port: number, _silent: boolean): Promise<void> {
-    return new Promise<void>((resolve, reject) => {
+  private bindOnce(port: number, _silent: boolean): Promise<number> {
+    return new Promise<number>((resolve, reject) => {
       const server = createServer((req, res) => this.handleHttpRequest(req, res))
       let settled = false
 
@@ -589,6 +590,11 @@ export class SootSimBridgeHost {
       // 127.0.0.1 explicitly to avoid the localhost-vs-::1 DNS coinflip.
       server.listen(port, '127.0.0.1', () => {
         if (settled) return
+        const address = server.address()
+        if (!address || typeof address === 'string') {
+          onError(new Error('ws bridge has no bound TCP address'))
+          return
+        }
         settled = true
         server.removeListener('error', onError)
         server.on('error', (err) => {
@@ -603,7 +609,7 @@ export class SootSimBridgeHost {
             this.wss?.emit('connection', ws, req)
           })
         })
-        resolve()
+        resolve(address.port)
       })
     })
   }

package/src/sim-client.ts

@@ -480,11 +480,22 @@ export class SimClient implements WsBridge, InspectBridge {
       const { text, ...textOpts } = target
       return this.throwUnlessTapped(await tapByText(this, text, textOpts), text)
     }
-    if ('testID' in target && typeof target.testID === 'string') {
+    if (
+      'testID' in target &&
+      typeof target.testID === 'string' &&
+      typeof target.nodeId !== 'number'
+    ) {
       return this.throwUnlessTapped(await tapById(this, target.testID), target.testID)
     }
     const coords = this.coordsForTapTarget(target)
-    const result = await this.send({ type: 'tap', x: coords.x, y: coords.y })
+    const result = await this.send({
+      type: 'tap',
+      x: coords.x,
+      y: coords.y,
+      ...('nodeId' in target && typeof target.nodeId === 'number'
+        ? { target: { nodeId: target.nodeId } }
+        : {}),
+    })
     if (!isTapSuccess(result)) {
       throw new SimTapError(
         `tap at ${coords.x},${coords.y} missed: ${JSON.stringify(result)}`,
@@ -559,6 +570,7 @@ export class SimClient implements WsBridge, InspectBridge {
         x: target.x,
         y: target.y,
         target: {
+          nodeId: target.nodeId,
           testID: target.testID ?? undefined,
           text: target.text ?? undefined,
           type: target.type ?? undefined,