tinovio-dev 0.0.0-stage → 0.3.25

package/bin/tinovio-dev.cjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// The npm launcher (O296): it runs the native CLI from the platform package npm installed for this computer, with
+// the same arguments, input, output, and exit code. The listener program sits next to it. One file serves both CLIs
+// (specs/releases/02-cli-channels.md): the launcher `tinovio` runs `@tinovio/cli-<os>-<cpu>`, and `tinovio-dev`
+// runs `@tinovio/cli-dev-<os>-<cpu>`. It reads its channel from its own package name.
+"use strict";
+const { spawnSync } = require("node:child_process");
+const { randomUUID } = require("node:crypto");
+const { mkdirSync, readFileSync, writeFileSync } = require("node:fs");
+const { homedir } = require("node:os");
+const { dirname, join } = require("node:path");
+
+const home = dirname(__dirname);
+const own = JSON.parse(readFileSync(join(home, "package.json"), "utf8"));
+const command = own.name;
+const dev = command === "tinovio-dev";
+const version = own.version;
+
+/**
+ * The npm install funnel (T-202): a launcher that cannot start the CLI leaves one metadata record where install.sh
+ * leaves its own, and the CLI sends it when it next runs (cli/src/install-activity.ts). A closed reason only.
+ */
+function recordFailure(reason) {
+  try {
+    const dir = join(
+      process.env.TINOVIO_HOME || join(homedir(), dev ? ".tinovio-dev" : ".tinovio"),
+      "install-activity",
+    );
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const id = randomUUID();
+    const now = Date.now();
+    const context = { call_id: randomUUID(), started_at_ms: now, phase: "finished", source: "installer" };
+    const event = { id, action: "install", result: "failed", reason, at_ms: now, context };
+    const fallback = dev ? "https://api.dev.tinovio.com" : "https://api.tinovio.com";
+    const api = (process.env.TINOVIO_API_URL || fallback).replace(/\/$/, "");
+    writeFileSync(join(dir, `${id}.json`), JSON.stringify({ api, event }), { mode: 0o600 });
+  } catch {}
+}
+
+const os = process.platform;
+const cpu = process.arch;
+// glibcVersionRuntime is absent on musl Linux (the check esbuild uses).
+const musl = os === "linux" && !process.report?.getReport?.().header?.glibcVersionRuntime;
+const target = `cli${dev ? "-dev" : ""}-${os}-${cpu}${musl ? "-musl" : ""}`;
+const name = `@tinovio/${target}`;
+
+// T-98: only where npm puts this launcher's build, nested (global) or next to it (local, pnpm). Never
+// require.resolve, which walks up to every parent node_modules and ran a stale 0.2.1 from the home folder.
+const builds = [join(home, "node_modules", "@tinovio", target), join(dirname(home), "@tinovio", target)].flatMap(
+  (dir) => {
+    try {
+      return [{ dir, version: JSON.parse(readFileSync(join(dir, "package.json"), "utf8")).version }];
+    } catch {
+      return [];
+    }
+  },
+);
+const found = builds.find((b) => b.version === version) ?? builds[0];
+if (found?.version !== version) {
+  process.stderr.write(
+    [
+      `Failed: ${command} did not start.`,
+      found
+        ? `Why: the build for this computer, ${name}, is version ${found.version}, not ${version}.`
+        : `Why: npm did not install ${name} ${version}, the build for this computer.`,
+      `You can: Run npm install -g ${command}@latest again, or npm install ${command}@latest in the folder that holds this install, with optional dependencies allowed.`,
+      `Tell your human: No human step needed, unless the reinstall fails. Then: Tinovio could not install its build for ${os} ${cpu}${musl ? " musl" : ""} on this computer.`,
+      "",
+    ].join("\n"),
+  );
+  recordFailure(found ? "launcher_version_mismatch" : "launcher_no_build");
+  process.exit(1);
+}
+const binary = join(found.dir, "bin", os === "win32" ? `${command}.exe` : command);
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit", windowsHide: false });
+if (result.error) {
+  process.stderr.write(`Failed: ${command} did not start.\nWhy: ${result.error.message}\n`);
+  recordFailure("launcher_start");
+  process.exit(1);
+}
+if (result.signal) process.kill(process.pid, result.signal);
+process.exit(result.status ?? 1);

package/package.json

@@ -1,6 +1,25 @@
 {
   "name": "tinovio-dev",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.25",
+  "license": "UNLICENSED",
+  "description": "The Tinovio dev CLI, for api.dev.tinovio.com. It has builds nobody tested yet. Install tinovio for Tinovio.",
+  "bin": {
+    "tinovio-dev": "bin/tinovio-dev.cjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@tinovio/cli-dev-win32-x64": "0.3.25",
+    "@tinovio/cli-dev-win32-arm64": "0.3.25",
+    "@tinovio/cli-dev-darwin-x64": "0.3.25",
+    "@tinovio/cli-dev-darwin-arm64": "0.3.25",
+    "@tinovio/cli-dev-linux-x64": "0.3.25",
+    "@tinovio/cli-dev-linux-arm64": "0.3.25",
+    "@tinovio/cli-dev-linux-x64-musl": "0.3.25",
+    "@tinovio/cli-dev-linux-arm64-musl": "0.3.25"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.