rnxsim 0.1.419 → 0.1.421

package/src/cloud.ts

@@ -0,0 +1,499 @@
+// typed RNX Cloud nano client for agents. the CLI produces artifact bytes
+// (local file or a fetched URL); this module talks to the service in those
+// bytes only. command types and receipts are the same ones the CLI already
+// sends. do not invent a second vocabulary.
+
+import { isLoopbackHost } from './backend-origin'
+import {
+  isRnxCloudCommandType,
+  RNX_CLOUD_COMMAND_TYPES,
+  RNX_CLOUD_MAX_ARTIFACT_BYTES,
+  type RnxCloudBoxCreateReceipt,
+  type RnxCloudClaim,
+} from './cloud-contract'
+import { rnxPublicBrand } from './public-brand'
+
+export { isRnxCloudCommandType, RNX_CLOUD_COMMAND_TYPES, RNX_CLOUD_MAX_ARTIFACT_BYTES }
+export type { RnxCloudBoxCreateReceipt, RnxCloudClaim }
+
+const DEFAULT_DEVICE = 'iphone-16'
+const DEFAULT_WAIT_READY_MS = 20_000
+
+export type NanoCommand = {
+  type: (typeof RNX_CLOUD_COMMAND_TYPES)[number]
+  [key: string]: unknown
+}
+
+export interface CreateNanoBoxInput {
+  artifact: Uint8Array
+  authorization: string
+  origin?: string
+  device?: string
+  sha256?: string
+}
+
+export interface AddNanoSimulatorInput {
+  device?: string
+  storageFrom?: string | null
+}
+
+interface NanoSession {
+  origin: string
+  authorization: string
+  boxId: string
+  boxToken: string
+  simId: string
+  simulatorToken: string
+  claim: RnxCloudClaim
+  artifact: RnxCloudBoxCreateReceipt['artifact']
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function normalizeCloudOrigin(source: string): string {
+  let parsed: URL
+  try {
+    parsed = new URL(source)
+  } catch {
+    throw new Error(`invalid RNX Cloud origin: ${source}`)
+  }
+  if (
+    (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') ||
+    parsed.username ||
+    parsed.password ||
+    parsed.pathname !== '/' ||
+    parsed.search ||
+    parsed.hash
+  ) {
+    throw new Error(`RNX Cloud origin must be an HTTP(S) origin: ${source}`)
+  }
+  if (parsed.protocol === 'http:' && !isLoopbackHost(parsed.hostname)) {
+    throw new Error(`RNX Cloud origin requires HTTPS outside loopback: ${source}`)
+  }
+  return parsed.origin
+}
+
+function resolveOrigin(value?: string): string {
+  const configured = value?.trim() || process.env.RNX_CLOUD_ORIGIN?.trim()
+  return normalizeCloudOrigin(configured || rnxPublicBrand.origin)
+}
+
+function responseError(status: number, text: string): Error {
+  if (text) {
+    try {
+      const parsed: unknown = JSON.parse(text)
+      const error = isRecord(parsed) ? parsed.error : null
+      if (isRecord(error) && typeof error.message === 'string') {
+        return new Error(`RNX Cloud request failed (${status}): ${error.message}`)
+      }
+    } catch {
+      // body was not json; fall through to the raw text
+    }
+  }
+  return new Error(
+    `RNX Cloud request failed (${status})${text.trim() ? `: ${text.trim()}` : ''}`,
+  )
+}
+
+function copyArrayBuffer(bytes: Uint8Array): ArrayBuffer {
+  const copy = new ArrayBuffer(bytes.byteLength)
+  new Uint8Array(copy).set(bytes)
+  return copy
+}
+
+async function sha256Hex(bytes: Uint8Array): Promise<string> {
+  const digest = await globalThis.crypto.subtle.digest('SHA-256', copyArrayBuffer(bytes))
+  const view = new Uint8Array(digest)
+  let hex = ''
+  for (const byte of view) hex += byte.toString(16).padStart(2, '0')
+  return hex
+}
+
+function readJsArtifact(bytes: Uint8Array): string {
+  let source: string
+  try {
+    source = new TextDecoder('utf-8', { fatal: true }).decode(bytes)
+  } catch {
+    throw new Error('rnx Cloud artifact must be valid UTF-8 JavaScript, not bytecode')
+  }
+  if (source.includes('\0') || !source.includes('__d(') || !source.includes('__r(')) {
+    throw new Error('rnx Cloud artifact must be a Metro JavaScript bundle')
+  }
+  return source
+}
+
+function readClaim(value: unknown): RnxCloudClaim {
+  if (
+    !isRecord(value) ||
+    typeof value.id !== 'string' ||
+    !value.id ||
+    typeof value.expiresAt !== 'number'
+  ) {
+    throw new Error('RNX Cloud returned an invalid claim')
+  }
+  return { id: value.id, expiresAt: value.expiresAt }
+}
+
+function artifactDigestId(sha256: string): `sha256:${string}` {
+  return `sha256:${sha256}`
+}
+
+function readArtifact(
+  value: unknown,
+  expectedId: `sha256:${string}`,
+  expectedBytes: number,
+): RnxCloudBoxCreateReceipt['artifact'] {
+  if (
+    !isRecord(value) ||
+    value.id !== expectedId ||
+    typeof value.bytes !== 'number' ||
+    !Number.isInteger(value.bytes) ||
+    value.bytes !== expectedBytes
+  ) {
+    throw new Error('RNX Cloud returned an invalid artifact receipt')
+  }
+  return { id: expectedId, bytes: expectedBytes }
+}
+
+function readSimulatorCreate(
+  value: unknown,
+  expectedId: `sha256:${string}`,
+  expectedBytes: number,
+): {
+  simId: string
+  token: string
+  claim: RnxCloudClaim
+  artifact: RnxCloudBoxCreateReceipt['artifact']
+} {
+  if (!isRecord(value)) throw new Error('RNX Cloud create returned an invalid simulator')
+  const claim = readClaim(value.claim)
+  if (
+    typeof value.simId !== 'string' ||
+    !value.simId ||
+    typeof value.token !== 'string'
+  ) {
+    throw new Error('RNX Cloud create returned an invalid simulator')
+  }
+  return {
+    simId: value.simId,
+    token: value.token,
+    claim,
+    artifact: readArtifact(value.artifact, expectedId, expectedBytes),
+  }
+}
+
+function readBoxCreate(
+  value: unknown,
+  expectedBytes: number,
+  expectedSha256: string,
+): {
+  receipt: RnxCloudBoxCreateReceipt
+  boxToken: string
+  simulatorToken: string
+} {
+  const artifactId = artifactDigestId(expectedSha256)
+  if (!isRecord(value)) throw new Error('RNX Cloud create returned invalid JSON')
+  const simulator = readSimulatorCreate(value.simulator, artifactId, expectedBytes)
+  if (
+    typeof value.boxId !== 'string' ||
+    !value.boxId ||
+    value.size !== 'nano' ||
+    typeof value.token !== 'string' ||
+    !value.token
+  ) {
+    throw new Error('RNX Cloud create returned an invalid box receipt')
+  }
+  return {
+    receipt: {
+      boxId: value.boxId,
+      size: 'nano',
+      artifact: readArtifact(value.artifact, artifactId, expectedBytes),
+      simulator: {
+        simId: simulator.simId,
+        artifact: simulator.artifact,
+        claim: simulator.claim,
+      },
+    },
+    boxToken: value.token,
+    simulatorToken: simulator.token,
+  }
+}
+
+function cloudCommand(command: { type: string; [key: string]: unknown }): NanoCommand {
+  const clean: Record<string, unknown> = {}
+  for (const [key, value] of Object.entries(command)) {
+    if (key !== 'id' && key !== 'simId') clean[key] = value
+  }
+  if (!isRnxCloudCommandType(command.type)) {
+    throw new Error(`RNX Cloud does not support bridge command type ${command.type}`)
+  }
+  return { ...clean, type: command.type }
+}
+
+export class NanoBox {
+  private session: NanoSession
+
+  constructor(session: NanoSession) {
+    this.session = session
+  }
+
+  get boxId(): string {
+    return this.session.boxId
+  }
+
+  get simId(): string {
+    return this.session.simId
+  }
+
+  get claim(): RnxCloudClaim {
+    return this.session.claim
+  }
+
+  get receipt(): RnxCloudBoxCreateReceipt {
+    return {
+      boxId: this.session.boxId,
+      size: 'nano',
+      artifact: this.session.artifact,
+      simulator: {
+        simId: this.session.simId,
+        artifact: this.session.artifact,
+        claim: this.session.claim,
+      },
+    }
+  }
+
+  async command(
+    command: { type: string; [key: string]: unknown },
+    options?: { timeoutMs?: number },
+  ): Promise<unknown> {
+    const body = {
+      id: globalThis.crypto.randomUUID(),
+      claimId: this.session.claim.id,
+      command: cloudCommand(command),
+    }
+    let response: Response
+    try {
+      response = await fetch(
+        `${this.session.origin}/v1/sims/${encodeURIComponent(this.session.simId)}/commands`,
+        {
+          method: 'POST',
+          headers: {
+            authorization: `Bearer ${this.session.simulatorToken}`,
+            'content-type': 'application/json',
+          },
+          body: JSON.stringify(body),
+          ...(options?.timeoutMs
+            ? { signal: AbortSignal.timeout(options.timeoutMs) }
+            : {}),
+        },
+      )
+    } catch (error) {
+      throw new Error(
+        `could not reach RNX Cloud at ${this.session.origin}: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      )
+    }
+    const text = await response.text()
+    if (!response.ok) throw responseError(response.status, text)
+    let parsed: unknown
+    try {
+      parsed = JSON.parse(text)
+    } catch {
+      throw new Error('RNX Cloud command returned unreadable JSON')
+    }
+    if (!isRecord(parsed) || parsed.id !== body.id) {
+      throw new Error('RNX Cloud command returned an invalid command receipt')
+    }
+    if (typeof parsed.error === 'string' && parsed.error) throw new Error(parsed.error)
+    if (!Object.hasOwn(parsed, 'result')) {
+      throw new Error('RNX Cloud command receipt has no result')
+    }
+    return parsed.result
+  }
+
+  describe(): Promise<unknown> {
+    return this.command({ type: 'tree' })
+  }
+
+  do(command: { type: string; [key: string]: unknown }): Promise<unknown> {
+    return this.command(command)
+  }
+
+  wait(
+    condition: 'ready' | { type: 'selector'; selector: string },
+    options?: { maxMs?: number },
+  ): Promise<unknown> {
+    const timeoutMs = options?.maxMs ?? DEFAULT_WAIT_READY_MS
+    const waitCondition = condition === 'ready' ? { type: 'ready' } : condition
+    return this.command(
+      {
+        type: 'waitFor',
+        waitForOptions: { condition: waitCondition, timeoutMs },
+      },
+      { timeoutMs: timeoutMs + 1_000 },
+    )
+  }
+
+  screenshot(options?: { layers?: 'full' | 'tenant' | 'shell' }): Promise<unknown> {
+    return this.command({
+      type: 'screenshot',
+      layers: options?.layers ?? 'tenant',
+    })
+  }
+
+  capture(): Promise<unknown> {
+    return this.command({ type: 'capture' })
+  }
+
+  reset(): Promise<unknown> {
+    return this.command({ type: 'reset' })
+  }
+
+  async confirm(): Promise<RnxCloudClaim> {
+    const response = await fetch(
+      `${this.session.origin}/v1/sims/${encodeURIComponent(this.session.simId)}/claim`,
+      {
+        method: 'POST',
+        headers: {
+          authorization: `Bearer ${this.session.simulatorToken}`,
+          'content-type': 'application/json',
+        },
+        body: JSON.stringify({ claimId: this.session.claim.id }),
+      },
+    )
+    const text = await response.text()
+    if (!response.ok) throw responseError(response.status, text)
+    let parsed: unknown
+    try {
+      parsed = JSON.parse(text)
+    } catch {
+      throw new Error('RNX Cloud claim returned unreadable JSON')
+    }
+    const claim = readClaim(isRecord(parsed) ? parsed.claim : null)
+    if (claim.id !== this.session.claim.id) {
+      throw new Error('RNX Cloud confirmation replaced the initial claim')
+    }
+    this.session = { ...this.session, claim }
+    return claim
+  }
+
+  async addSimulator(input: AddNanoSimulatorInput = {}): Promise<NanoBox> {
+    const device = input.device?.trim() || DEFAULT_DEVICE
+    const response = await fetch(
+      `${this.session.origin}/v1/boxes/${encodeURIComponent(this.session.boxId)}/simulators`,
+      {
+        method: 'POST',
+        headers: {
+          authorization: `Bearer ${this.session.boxToken}`,
+          'x-rnx-account-authorization': this.session.authorization,
+          'content-type': 'application/json',
+        },
+        body: JSON.stringify({
+          device,
+          ...(input.storageFrom === undefined ? {} : { storageFrom: input.storageFrom }),
+        }),
+      },
+    )
+    const text = await response.text()
+    if (!response.ok) throw responseError(response.status, text)
+    let parsed: unknown
+    try {
+      parsed = JSON.parse(text)
+    } catch {
+      throw new Error('RNX Cloud simulator create returned unreadable JSON')
+    }
+    if (!isRecord(parsed) || parsed.boxId !== this.session.boxId) {
+      throw new Error('RNX Cloud simulator create returned an invalid box id')
+    }
+    const simulator = readSimulatorCreate(
+      parsed.simulator,
+      this.session.artifact.id,
+      this.session.artifact.bytes,
+    )
+    const pooled = new NanoBox({
+      ...this.session,
+      simId: simulator.simId,
+      simulatorToken: simulator.token,
+      claim: simulator.claim,
+    })
+    await pooled.confirm()
+    return pooled
+  }
+
+  async close(): Promise<void> {
+    const response = await fetch(
+      `${this.session.origin}/v1/boxes/${encodeURIComponent(this.session.boxId)}`,
+      {
+        method: 'DELETE',
+        headers: { authorization: `Bearer ${this.session.boxToken}` },
+      },
+    )
+    const text = await response.text()
+    if (!response.ok && response.status !== 404) {
+      throw responseError(response.status, text)
+    }
+  }
+}
+
+export async function createNanoBox(input: CreateNanoBoxInput): Promise<NanoBox> {
+  if (input.artifact.byteLength > RNX_CLOUD_MAX_ARTIFACT_BYTES) {
+    throw new Error(
+      `rnx Cloud artifact is ${input.artifact.byteLength} bytes and exceeds the ${RNX_CLOUD_MAX_ARTIFACT_BYTES}-byte limit`,
+    )
+  }
+  if (input.artifact.byteLength <= 0) {
+    throw new Error('rnx Cloud artifact is empty')
+  }
+  readJsArtifact(input.artifact)
+  const origin = resolveOrigin(input.origin)
+  const sha256 = await sha256Hex(input.artifact)
+  if (input.sha256 && input.sha256 !== sha256) {
+    throw new Error('rnx Cloud artifact sha256 does not match the provided digest')
+  }
+  const device = input.device?.trim() || DEFAULT_DEVICE
+  let response: Response
+  try {
+    response = await fetch(`${origin}/v1/boxes`, {
+      method: 'POST',
+      headers: {
+        authorization: input.authorization,
+        'content-type': 'application/javascript',
+        'x-rnx-box-size': 'nano',
+        'x-rnx-artifact-sha256': sha256,
+        'x-rnx-platform': 'ios',
+        'x-rnx-device': device,
+      },
+      body: copyArrayBuffer(input.artifact),
+    })
+  } catch (error) {
+    throw new Error(
+      `could not reach RNX Cloud at ${origin}: ${
+        error instanceof Error ? error.message : String(error)
+      }`,
+    )
+  }
+  const responseText = await response.text()
+  if (!response.ok) throw responseError(response.status, responseText)
+  let parsed: unknown
+  try {
+    parsed = JSON.parse(responseText)
+  } catch {
+    throw new Error('RNX Cloud create returned unreadable JSON')
+  }
+  const created = readBoxCreate(parsed, input.artifact.byteLength, sha256)
+  const box = new NanoBox({
+    origin,
+    authorization: input.authorization,
+    boxId: created.receipt.boxId,
+    boxToken: created.boxToken,
+    simId: created.receipt.simulator.simId,
+    simulatorToken: created.simulatorToken,
+    claim: created.receipt.simulator.claim,
+    artifact: created.receipt.artifact,
+  })
+  await box.confirm()
+  return box
+}

package/src/dev-bundle-resolution.ts

@@ -179,12 +179,15 @@ async function probeExpoManifest(
     async (res) => (res.ok ? { ok: true as const, body: await res.text() } : null),
     () => undefined,
   )
+  let probeDeadline: ReturnType<typeof setTimeout> | undefined
   const answered = await Promise.race([
     pending,
-    new Promise<'timeout'>((resolve) =>
-      setTimeout(() => resolve('timeout'), MANIFEST_PROBE_TIMEOUT_MS).unref?.(),
-    ),
+    new Promise<'timeout'>((resolve) => {
+      probeDeadline = setTimeout(() => resolve('timeout'), MANIFEST_PROBE_TIMEOUT_MS)
+    }),
   ])
+  // the race is settled, so drop the deadline rather than leaving it pending.
+  clearTimeout(probeDeadline)
   if (answered === 'timeout' || answered === undefined) return { state: 'no-answer' }
   if (answered === null) return { state: 'no-manifest' }
   body = answered.body

package/src/dev-server-open.ts

@@ -129,9 +129,11 @@ export function openRnxDesktopWhenMetroIsReady({
 
   return new Promise((resolve) => {
     let finished = false
+    let retryTimer: ReturnType<typeof setTimeout> | undefined
     const finish = (opened: boolean) => {
       if (finished) return
       finished = true
+      clearTimeout(retryTimer)
       scheduledMetroOpens.delete(key)
       resolve(opened)
     }
@@ -144,8 +146,7 @@ export function openRnxDesktopWhenMetroIsReady({
         finish(false)
         return
       }
-      const timer = setTimeout(check, intervalMs)
-      timer.unref()
+      retryTimer = setTimeout(check, intervalMs)
     }
     const check = () => {
       const request = http.get(