mars-ram 0.0.0-stage → 0.1.3

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# mars-ram 0.1.3
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The computer side of mars-ram: the command that pairs your phone with this computer, the Pi session bridge and the private-link server. Linux, macOS and Windows; Node.js 24 or newer.
+
+```bash
+pnpm add -g mars-ram    # recommended
+npm i -g mars-ram       # or
+bun add -g mars-ram     # or
+```
+
+Then:
+
+```bash
+mars-ram install
+mars-ram pair
+```
+
+`mars-ram install` copies everything to `~/.mars-ram` in your user account (no administrator rights) and installs the bridge into each Pi you choose. `mars-ram doctor` checks the setup, `mars-ram uninstall` removes it (then `pnpm remove -g mars-ram` removes the package). To update: `pnpm add -g mars-ram`, then `mars-ram install`; if you installed earlier with the curl script and `mars-ram install` still runs the old version, run `mars-ram uninstall` first.
+
+The package has no install scripts and no dependencies. It carries the release archive `mars-ram-0.1.3.tar.gz` (SHA-256 `7f0bf65fad1a5c2398c8d8bb7047c7c7de91867d81671ef4771d34f78809836e`, the same file as the GitHub release) and a launcher that checks that SHA-256, unpacks the archive into a private temporary folder and runs it, because Node does not run TypeScript from `node_modules`. After `mars-ram install`, the launcher runs the installed copy directly when it is this same version.
+
+Install guide: https://marssall.github.io/mars-ram/install
+
+---
+
+**Español.** Instalá con `pnpm add -g mars-ram` (recomendado) o `npm i -g mars-ram`, después ejecutá `mars-ram install` y `mars-ram pair`. Requiere Node.js 24 o más nuevo. Guía: https://marssall.github.io/mars-ram/install

package/bin/mars-ram.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+// mars-ram npm launcher. Node refuses to strip TypeScript types under node_modules, so this package carries the
+// release archive and runs it from a private temporary folder, as install.sh does. Node built-ins only; rendered by
+// host/cli/scripts/build-release.ts, which writes the version, the archive SHA-256 and the CLI fingerprint below.
+import { execFileSync, spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { lstatSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { constants, homedir, tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+const VERSION = '0.1.3';
+const ARCHIVE_SHA256 = '7f0bf65fad1a5c2398c8d8bb7047c7c7de91867d81671ef4771d34f78809836e';
+const CLI_FINGERPRINT = 'f53d63e493b1f2d1a7850694b2b41c112621a7840088ebc73d55fe99a31fd269';
+
+// Same locale rule as the CLI (host/cli/src/adapters/terminal.ts); an empty variable counts as unset.
+const spanish = (process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || Intl.DateTimeFormat().resolvedOptions().locale).toLowerCase().startsWith('es');
+const say = (en, es) => spanish ? es : en;
+function fail(message) {
+ process.stderr.write(`${message}\n`);
+ process.exit(1);
+}
+
+const args = process.argv.slice(2);
+const packageRoot = join(import.meta.dirname, '..');
+
+// The copy `mars-ram install` wrote runs directly when it is this package's CLI; install and uninstall always run
+// from the package, so they never replace or remove the code that is running them.
+function installedMain() {
+ if (args[0] === 'install' || args[0] === 'uninstall') return undefined;
+ const cli = join(homedir(), '.mars-ram', 'cli');
+ try {
+  if (readFileSync(join(cli, 'fingerprint.sha256'), 'utf8').trim() !== CLI_FINGERPRINT) return undefined;
+  const main = join(cli, 'src', 'main.ts'), stat = lstatSync(main);
+  return stat.isFile() && !stat.isSymbolicLink() ? main : undefined;
+ } catch { return undefined; }
+}
+
+// Checks the embedded archive against the SHA-256 pinned at build time, then unpacks the checked bytes (not the file
+// again) into a new folder only this user can read.
+function extract() {
+ const name = `mars-ram-${VERSION}`;
+ const bytes = readFileSync(join(packageRoot, 'archive', `${name}.tar.gz`));
+ const actual = createHash('sha256').update(bytes).digest('hex');
+ if (actual !== ARCHIVE_SHA256) fail(say(
+  `The mars-ram package is damaged: its archive does not match the expected SHA-256.\nExpected: ${ARCHIVE_SHA256}\nActual:   ${actual}\nNothing was run. Reinstall it: pnpm add -g mars-ram (or npm i -g mars-ram).`,
+  `El paquete mars-ram está dañado: su archivo no coincide con el SHA-256 esperado.\nEsperado: ${ARCHIVE_SHA256}\nObtenido: ${actual}\nNo se ejecutó nada. Instalalo de nuevo: pnpm add -g mars-ram (o npm i -g mars-ram).`));
+ const dir = mkdtempSync(join(tmpdir(), 'mars-ram-'));
+ try {
+  writeFileSync(join(dir, 'archive.tar.gz'), bytes, { mode: 0o600, flag: 'wx' });
+  // Windows 10+ ships bsdtar as System32\tar.exe; name it so an earlier tar on PATH is never picked.
+  const tar = process.platform === 'win32' ? join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'tar.exe') : 'tar';
+  // Relative names with cwd: GNU tar would read "C:\..." as a remote host.
+  execFileSync(tar, ['-xzf', 'archive.tar.gz'], { cwd: dir, stdio: ['ignore', 'ignore', 'pipe'], shell: false, windowsHide: true });
+  rmSync(join(dir, 'archive.tar.gz'));
+ } catch (error) {
+  rmSync(dir, { recursive: true, force: true });
+  fail(say(`mars-ram could not unpack its files: ${error.message}`, `mars-ram no pudo descomprimir sus archivos: ${error.message}`));
+ }
+ return { main: join(dir, name, 'cli', 'src', 'main.ts'), dir };
+}
+
+// Signal handlers come first, before the archive is unpacked: a SIGTERM or SIGHUP that arrives during startup then waits
+// for the synchronous unpacking, reaches the CLI as soon as it starts, and the temporary copy is still removed. Only
+// SIGKILL leaves it behind. Ctrl+C reaches the whole process group, so the CLI gets it directly and decides; this
+// process only waits. Signals sent to this process alone are passed on.
+let child, dir;
+const cleanup = () => { if (dir) rmSync(dir, { recursive: true, force: true }); };
+const forward = signal => {
+ if (child) child.kill(signal);
+ else { cleanup(); process.exit(128 + (constants.signals[signal] ?? 0)); }
+};
+const handlers = { SIGINT: () => {}, SIGTERM: forward, SIGHUP: forward };
+for (const [signal, handler] of Object.entries(handlers)) process.on(signal, handler);
+
+const installed = installedMain();
+let main = installed;
+if (!installed) ({ main, dir } = extract());
+
+// MARS_RAM_PACKAGE_BIN tells `mars-ram install` that this package's bin is the command, so it writes no launcher of
+// its own (one earlier on PATH would keep running the old version).
+child = spawn(process.execPath, ['--disable-warning=ExperimentalWarning', main, ...args], { stdio: 'inherit', shell: false, env: { ...process.env, MARS_RAM_PACKAGE_BIN: import.meta.filename } });
+child.on('error', error => {
+ cleanup();
+ fail(say(`mars-ram could not start Node: ${error.message}`, `mars-ram no pudo iniciar Node: ${error.message}`));
+});
+child.on('exit', (code, signal) => {
+ cleanup();
+ for (const [name, handler] of Object.entries(handlers)) process.off(name, handler);
+ if (signal) {
+  // End the same way, so a calling shell sees the signal.
+  process.kill(process.pid, signal);
+  process.exit(128 + (constants.signals[signal] ?? 0));
+ }
+ process.exit(code ?? 1);
+});

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "mars-ram",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.3",
+  "description": "Computer side of mars-ram: pairs your phone with this computer and installs the Pi session bridge and private-link server.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "mars-ram": "bin/mars-ram.mjs"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "files": [
+    "archive",
+    "bin",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MarsSall/mars-ram.git"
+  },
+  "homepage": "https://marssall.github.io/mars-ram/install"
+}