par3-cli 0.0.0-stage → 0.1.51

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# Server
 
-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.
+Node.js WebSocket server for the Par3 app.

package/bin/t3.mjs

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+// Share the installer's runtime cache; pre-0.0.41 services re-enter here over IPC.
+import { spawn, spawnSync } from "node:child_process";
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const { version } = JSON.parse(
+  fs.readFileSync(path.join(import.meta.dirname, "../package.json"), "utf8"),
+);
+
+const SUPPORTED = ["darwin-arm64", "linux-arm64", "linux-x64", "win32-arm64", "win32-x64"];
+
+function t3Home() {
+  const raw = (process.env.T3CODE_HOME || "").trim();
+  if (raw === "") return path.join(os.homedir(), ".t3");
+  if (raw === "~") return os.homedir();
+  if (raw.startsWith("~/") || raw.startsWith("~\\")) return path.join(os.homedir(), raw.slice(2));
+  return path.resolve(raw);
+}
+
+async function get(url) {
+  const response = await fetch(url);
+  if (response.status === 404) {
+    throw new Error(
+      `${url} does not exist yet. If ${version} was just released, try again in a few minutes.`,
+    );
+  }
+  if (!response.ok) throw new Error(`GET ${url} returned HTTP ${response.status}`);
+  return response;
+}
+
+async function download(url, file) {
+  const response = await get(url);
+  const total = Number(response.headers.get("content-length")) || 0;
+  const hash = crypto.createHash("sha256");
+  const out = fs.openSync(file, "w");
+  const tty = process.stderr.isTTY;
+  let received = 0;
+  let shown = -1;
+  try {
+    for await (const chunk of response.body) {
+      hash.update(chunk);
+      fs.writeSync(out, chunk);
+      received += chunk.byteLength;
+      // Redraw once per percent (or per MB without a length), not per chunk.
+      const step = total ? Math.floor((received * 100) / total) : Math.floor(received / 1048576);
+      if (tty && step !== shown) {
+        shown = step;
+        const percent = total ? ` ${step}%` : "";
+        process.stderr.write(
+          `\r\x1b[2Kpar3: downloading Par3 ${version}${percent} (${(received / 1048576).toFixed(1)} MB)`,
+        );
+      }
+    }
+  } finally {
+    fs.closeSync(out);
+    if (tty) process.stderr.write("\r\x1b[2K");
+  }
+  return hash.digest("hex");
+}
+
+async function install(dir, key) {
+  const archive = `t3-${version}-${key}.${process.platform === "win32" ? "zip" : "tar.gz"}`;
+  const base = (
+    process.env.T3CODE_RELEASE_BASE_URL || "https://github.com/Pho3niX90/par3/releases/download"
+  ).replace(/\/+$/, "");
+  const sums = await (await get(`${base}/v${version}/SHA256SUMS`)).text();
+  const expected = /^([0-9a-f]{64})\s+\*?(.+)$/im;
+  const line = sums
+    .split(/\r?\n/)
+    .map((l) => expected.exec(l.trim()))
+    .find((m) => m && m[2] === archive);
+  if (!line) throw new Error(`${archive} is not listed in the release's SHA256SUMS`);
+
+  // Stage beside the destination and rename atomically to avoid half-installed versions.
+  fs.mkdirSync(path.dirname(dir), { recursive: true });
+  const staging = fs.mkdtempSync(`${dir}.staging-`);
+  try {
+    const file = path.join(staging, archive);
+    if ((await download(`${base}/v${version}/${archive}`, file)) !== line[1].toLowerCase()) {
+      throw new Error(`checksum mismatch for ${archive}`);
+    }
+    // Windows' own tar.exe reads zip; a Git-for-Windows tar on PATH cannot.
+    const tar =
+      process.platform === "win32" ? `${process.env.SystemRoot}\\System32\\tar.exe` : "tar";
+    const extract = spawnSync(tar, ["-xf", file, "-C", staging, "--strip-components=1"], {
+      stdio: "inherit",
+    });
+    if (extract.status !== 0) throw new Error(`could not extract ${archive}`);
+    fs.rmSync(file);
+    fs.writeFileSync(path.join(staging, ".install-complete"), `${version}\n`);
+    publish(staging, dir);
+  } finally {
+    fs.rmSync(staging, { recursive: true, force: true });
+  }
+}
+
+const isComplete = (dir) => {
+  try {
+    return fs.readFileSync(path.join(dir, ".install-complete"), "utf8").trim() === version;
+  } catch {
+    return false;
+  }
+};
+
+/** Preserve concurrently published complete installs; replace only incomplete folders without the completion marker. */
+function publish(staging, dir) {
+  try {
+    fs.renameSync(staging, dir);
+  } catch (error) {
+    if (isComplete(dir)) return;
+    if (!fs.existsSync(dir)) throw error;
+    fs.rmSync(dir, { recursive: true, force: true });
+    fs.renameSync(staging, dir);
+  }
+}
+
+async function main() {
+  const key = `${process.platform}-${process.arch}`;
+  if (!SUPPORTED.includes(key)) {
+    throw new Error(
+      `no Par3 CLI build is available for ${key} (supported: ${SUPPORTED.join(", ")}).\n` +
+        "The desktop app is at https://github.com/Pho3niX90/par3/releases",
+    );
+  }
+  const dir = path.join(t3Home(), "runtime", "versions", version);
+  if (!isComplete(dir)) await install(dir, key);
+
+  // Service IPC and signals must reach the child; terminal Ctrl-C already does, so do not forward SIGINT twice.
+  const ipc = process.send !== undefined;
+  const child = spawn(
+    path.join(dir, process.platform === "win32" ? "t3.exe" : "t3"),
+    process.argv.slice(2),
+    {
+      stdio: ipc ? ["inherit", "inherit", "inherit", "ipc"] : "inherit",
+      // The executable lives in the T3 home, so this is how it knows npm launched it.
+      env: { ...process.env, T3CODE_NPM_LAUNCHER_PATH: import.meta.filename },
+    },
+  );
+  if (ipc) {
+    process.on("message", (message) => child.connected && child.send(message));
+    child.on("message", (message) => process.connected && process.send(message));
+    process.on("disconnect", () => child.connected && child.disconnect());
+  }
+  for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+    process.on(signal, () => (ipc || signal !== "SIGINT") && child.kill(signal));
+  }
+  child.on("error", (error) => fail(error));
+  child.on("exit", (code, signal) =>
+    process.exit(code ?? 128 + (os.constants.signals[signal] || 1)),
+  );
+}
+
+function fail(error) {
+  process.stderr.write(`par3: ${error.message}\n`);
+  process.exit(1);
+}
+
+await main().catch(fail);

package/dist/bin.mjs

@@ -0,0 +1,2 @@
+// Legacy background services still enter the npm package through this path.
+import "../bin/t3.mjs";

package/package.json

@@ -1,6 +1,22 @@
 {
   "name": "par3-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.51",
+  "description": "Par3 CLI. Downloads the self-contained executable for this platform from the GitHub Release.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pho3niX90/par3.git"
+  },
+  "bin": {
+    "par3": "./bin/t3.mjs",
+    "p3": "./bin/t3.mjs",
+    "par3-cli": "./bin/t3.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.11"
+  }
+}