rnxsim 0.1.420 → 0.1.422

package/cli/outbound-endpoints.ts

@@ -137,6 +137,18 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     category: 'guest_app_network',
     count: 1,
   },
+  'packages/sootsim/src/cloud.ts :: fetch :: `${origin}/v1/boxes`': {
+    category: 'rnx_cloud_sim',
+    count: 1,
+  },
+  'packages/sootsim/src/cloud.ts :: fetch :: `${this.session.origin}/v1/sims/${encodeURIComponent(this.session.simId)}/commands`':
+    { category: 'rnx_cloud_sim', count: 1 },
+  'packages/sootsim/src/cloud.ts :: fetch :: `${this.session.origin}/v1/sims/${encodeURIComponent(this.session.simId)}/claim`':
+    { category: 'rnx_cloud_sim', count: 1 },
+  'packages/sootsim/src/cloud.ts :: fetch :: `${this.session.origin}/v1/boxes/${encodeURIComponent(this.session.boxId)}/simulators`':
+    { category: 'rnx_cloud_sim', count: 1 },
+  'packages/sootsim/src/cloud.ts :: fetch :: `${this.session.origin}/v1/boxes/${encodeURIComponent(this.session.boxId)}`':
+    { category: 'rnx_cloud_sim', count: 1 },
   // maestro's flow `http` API. the url is whatever the flow author wrote, and
   // it is fetched from a child process because that API is synchronous.
   'packages/sootsim/cli/internal-child.ts :: fetch :: request.url': {

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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/dist-lib/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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/dist-lib/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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/dist-lib/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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/dist-lib/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/beta.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/beta.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_MAX_MS = 5e3;

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/bridge-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_DEFAULT_MS = 500;

package/dist-lib/capture-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/capture-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/capture-contract.ts
 var RNX_SCREEN_CAPTURE_VERSION = 1;

package/dist-lib/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/cloud-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;

package/dist-lib/cloud-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.420 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.422 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/cloud-contract.ts
 var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;

package/dist-lib/cloud.cjs

@@ -0,0 +1,447 @@
+/*! rnx v0.1.422 | (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 __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cloud.ts
+var cloud_exports = {};
+__export(cloud_exports, {
+  NanoBox: () => NanoBox,
+  RNX_CLOUD_COMMAND_TYPES: () => RNX_CLOUD_COMMAND_TYPES,
+  RNX_CLOUD_MAX_ARTIFACT_BYTES: () => RNX_CLOUD_MAX_ARTIFACT_BYTES,
+  createNanoBox: () => createNanoBox,
+  isRnxCloudCommandType: () => isRnxCloudCommandType
+});
+module.exports = __toCommonJS(cloud_exports);
+
+// src/backend-origin.ts
+function normalizeHostname(hostname) {
+  return hostname.replace(/^\[|\]$/g, "").toLowerCase();
+}
+function isLoopbackHost(hostname) {
+  const normalized = normalizeHostname(hostname);
+  return normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "0.0.0.0" || normalized === "::1" || /^127(?:\.\d{1,3}){3}$/.test(normalized);
+}
+
+// src/cloud-contract.ts
+var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
+var RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES = 1024 * 1024;
+var RNX_CLOUD_COMMAND_TYPES = Object.freeze([
+  "state",
+  "query",
+  "resolve",
+  "perform",
+  "waitFor",
+  "reset",
+  "screenshot",
+  "capture",
+  "captureRegions",
+  "settle",
+  "setAppearance",
+  "openUrl",
+  "tree",
+  "tap",
+  "longPress",
+  "memory",
+  "diagnostics"
+]);
+var RNX_CLOUD_COMMAND_TYPE_SET = new Set(RNX_CLOUD_COMMAND_TYPES);
+function isRnxCloudCommandType(value) {
+  return RNX_CLOUD_COMMAND_TYPE_SET.has(value);
+}
+
+// src/public-brand.ts
+var name = "rnx";
+var rnxPublicBrand = Object.freeze({
+  name,
+  packageName: "rnxsim",
+  commandName: "rnx",
+  domain: "rnxsim.com",
+  origin: "https://rnxsim.com"
+});
+
+// src/cloud.ts
+var DEFAULT_DEVICE = "iphone-16";
+var DEFAULT_WAIT_READY_MS = 2e4;
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeCloudOrigin(source) {
+  let parsed;
+  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) {
+  const configured = value?.trim() || process.env.RNX_CLOUD_ORIGIN?.trim();
+  return normalizeCloudOrigin(configured || rnxPublicBrand.origin);
+}
+function responseError(status, text) {
+  if (text) {
+    try {
+      const parsed = 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 {
+    }
+  }
+  return new Error(
+    `RNX Cloud request failed (${status})${text.trim() ? `: ${text.trim()}` : ""}`
+  );
+}
+function copyArrayBuffer(bytes) {
+  const copy = new ArrayBuffer(bytes.byteLength);
+  new Uint8Array(copy).set(bytes);
+  return copy;
+}
+async function sha256Hex(bytes) {
+  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) {
+  let source;
+  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) {
+  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) {
+  return `sha256:${sha256}`;
+}
+function readArtifact(value, expectedId, expectedBytes) {
+  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, expectedId, expectedBytes) {
+  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, expectedBytes, expectedSha256) {
+  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) {
+  const clean = {};
+  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 };
+}
+var NanoBox = class _NanoBox {
+  session;
+  constructor(session) {
+    this.session = session;
+  }
+  get boxId() {
+    return this.session.boxId;
+  }
+  get simId() {
+    return this.session.simId;
+  }
+  get claim() {
+    return this.session.claim;
+  }
+  get receipt() {
+    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, options) {
+    const body = {
+      id: globalThis.crypto.randomUUID(),
+      claimId: this.session.claim.id,
+      command: cloudCommand(command)
+    };
+    let 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;
+    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() {
+    return this.command({ type: "tree" });
+  }
+  do(command) {
+    return this.command(command);
+  }
+  wait(condition, options) {
+    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 + 1e3 }
+    );
+  }
+  screenshot(options) {
+    return this.command({
+      type: "screenshot",
+      layers: options?.layers ?? "tenant"
+    });
+  }
+  capture() {
+    return this.command({ type: "capture" });
+  }
+  reset() {
+    return this.command({ type: "reset" });
+  }
+  async confirm() {
+    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;
+    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 = {}) {
+    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 === void 0 ? {} : { storageFrom: input.storageFrom }
+        })
+      }
+    );
+    const text = await response.text();
+    if (!response.ok) throw responseError(response.status, text);
+    let parsed;
+    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() {
+    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);
+    }
+  }
+};
+async function createNanoBox(input) {
+  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;
+  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;
+  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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NanoBox,
+  RNX_CLOUD_COMMAND_TYPES,
+  RNX_CLOUD_MAX_ARTIFACT_BYTES,
+  createNanoBox,
+  isRnxCloudCommandType
+});