software-mansion__argent/packages/argent/scripts/argent-simulator-server.cjs

#!/usr/bin/env node
"use strict";

// Thin dispatcher exposed as the `argent-simulator-server` bin entry in
// package.json. Picks the platform-specific simulator-server binary at
// invocation time and execs it with the caller's args. Required because
// npm's `bin` field resolves to a single file regardless of host platform,
// but the binary itself is platform-specific (Mach-O for darwin, ELF for
// linux). The native-devtools-ios resolver uses the same per-platform
// subdirectory layout, so a stable layout lives in exactly one place.

const { spawn } = require("node:child_process");
const path = require("node:path");
const fs = require("node:fs");

// Mirrors hostPlatformKey() in @argent/native-devtools-ios: darwin ships a
// universal (lipo) binary, but Linux binaries are single-arch ELFs, so arm64
// Linux resolves to its own "linux-arm64" directory next to the x86_64 one
// ("linux"). Duplicated here because the dispatcher must stay a standalone
// file — it ships verbatim as the npm `bin` entry.
const platformKey =
  process.platform === "linux" && process.arch === "arm64" ? "linux-arm64" : process.platform;

// PE `.exe` on Windows, extensionless ELF/Mach-O elsewhere. Mirrors
// simulatorServerBinaryName() in @argent/native-devtools-ios; inlined because
// this file ships verbatim as the npm `bin` entry and can't import.
const binaryName = process.platform === "win32" ? "simulator-server.exe" : "simulator-server";

const binary = path.join(__dirname, platformKey, binaryName);
if (!fs.existsSync(binary)) {
  console.error(
    `argent-simulator-server: no binary for platform "${platformKey}" at ${binary}.\n` +
      `Supported hosts today: darwin, linux (x86_64 and arm64), win32.`
  );
  process.exit(1);
}

const child = spawn(binary, process.argv.slice(2), { stdio: "inherit" });

// Forward termination signals so a supervisor that signals only the dispatcher
// PID (systemd, `kill -TERM <pid>`, container stop) doesn't orphan the child.
// Ctrl+C in a TTY already broadcasts to the whole process group so the child
// receives it too — these handlers cover the non-TTY case where the parent
// would otherwise exit alone and leave the binary reparented to init.
/** @type {NodeJS.Signals[]} */
const FORWARDED_SIGNALS = ["SIGTERM", "SIGINT", "SIGHUP"];
for (const sig of FORWARDED_SIGNALS) {
  process.on(sig, () => {
    if (!child.killed) {
      try {
        child.kill(sig);
      } catch {
        // Already exited between the signal arriving and us forwarding it.
      }
    }
  });
}

child.on("exit", (code, signal) => {
  if (signal) {
    process.kill(process.pid, signal);
  } else {
    process.exit(code ?? 1);
  }
});
child.on("error", (err) => {
  console.error(`argent-simulator-server: failed to spawn ${binary}: ${err.message}`);
  process.exit(1);
});