blun-king-cli 9.1.29 → 9.1.31

package/README.md

@@ -9,7 +9,7 @@ Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
 installiert:
 
 ```powershell
-npm install -g blun-king-cli@9.1.29
+npm install -g blun-king-cli@9.1.31
 ```
 
 ## Reproduzierbares Staging und Packen

package/bin/launcher-runtime.js

@@ -22,6 +22,7 @@ const {
   seedStandardTools,
 } = require('./standard-tools-bootstrap');
 const { CORE_LOADED_MESSAGE } = require('./core-bootstrap');
+const { prepareManagedNodeRuntime } = require('./node-runtime');
 const { acquireSharedRuntimeLease, tryAcquireUpdateLease } = require('./update-lease');
 const { runExplicitUpdate, runUpdateNotice } = require('./update-notice');
 const {
@@ -182,6 +183,33 @@ function installTelegramForProfile(packageRoot, blunDir) {
   }
 }
 
+function spawnManagedLauncher(binary, cwd) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(binary, process.argv.slice(1), {
+      cwd,
+      env: process.env,
+      stdio: 'inherit',
+      windowsHide: true,
+    });
+    child.once('error', reject);
+    child.once('exit', (code, signal) => {
+      if (Number.isInteger(code)) {
+        resolve(code);
+        return;
+      }
+      if (signal === 'SIGINT') {
+        resolve(130);
+        return;
+      }
+      if (signal === 'SIGTERM') {
+        resolve(143);
+        return;
+      }
+      resolve(1);
+    });
+  });
+}
+
 async function runLauncher(options = {}) {
   const callerCwd = process.cwd();
   const mode = options.mode || launcherModeFromArgv(process.argv);
@@ -278,6 +306,20 @@ async function runLauncher(options = {}) {
       return;
     }
 
+    const privatePaths = resolveLauncherPrivatePaths();
+    const nodeRuntime = await prepareManagedNodeRuntime({ blunDir: privatePaths.blunHome });
+    if (nodeRuntime.kind === 'failed') {
+      process.stderr.write(`${nodeRuntime.message}\n`);
+      process.exitCode = 1;
+      return;
+    }
+    if (nodeRuntime.kind === 'managed') {
+      process.stdout.write('BLUN hat die passende Node.js-Laufzeit eingerichtet.\n');
+      await releaseNotice();
+      process.exitCode = await spawnManagedLauncher(nodeRuntime.binary, callerCwd);
+      return;
+    }
+
     if (ARGS.some((arg) => arg === '--help' || arg === '-h')) {
       process.stdout.write(launcherHelpText());
       const env = createLauncherEnvironment(process.env, mode, readPackageVersion());
@@ -288,7 +330,6 @@ async function runLauncher(options = {}) {
       return;
     }
 
-    const privatePaths = resolveLauncherPrivatePaths();
     const blunDir = privatePaths.blunHome;
     ensurePrivateDirectory(blunDir);
 
@@ -356,4 +397,9 @@ async function runLauncher(options = {}) {
   }
 }
 
-module.exports = { resolveLauncherPrivatePaths, runLauncher, shouldDetachProtectedCore };
+module.exports = {
+  resolveLauncherPrivatePaths,
+  runLauncher,
+  shouldDetachProtectedCore,
+  spawnManagedLauncher,
+};

package/bin/managed-node.js

@@ -0,0 +1,150 @@
+'use strict';
+
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const https = require('node:https');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const NODE_VERSION = '24.15.0';
+const MAX_ARCHIVE_BYTES = 100 * 1024 * 1024;
+const DISTRIBUTIONS = {
+  'darwin-arm64': {
+    archive: `node-v${NODE_VERSION}-darwin-arm64.tar.gz`,
+    sha256: '372331b969779ab5d15b949884fc6eaf88d5afe87bde8ba881d6400b9100ffc4',
+  },
+  'darwin-x64': {
+    archive: `node-v${NODE_VERSION}-darwin-x64.tar.gz`,
+    sha256: 'ffd5ee293467927f3ee731a553eb88fd1f48cf74eebc2d74a6babe4af228673b',
+  },
+};
+
+function distributionFor(platform, arch) {
+  return DISTRIBUTIONS[`${platform}-${arch}`] || null;
+}
+
+function sha256File(file) {
+  const hash = crypto.createHash('sha256');
+  hash.update(fs.readFileSync(file));
+  return hash.digest('hex');
+}
+
+function downloadFile(url, destination, redirectsLeft = 3) {
+  return new Promise((resolve, reject) => {
+    const request = https.get(url, { timeout: 30_000 }, (response) => {
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        response.resume();
+        if (redirectsLeft <= 0) {
+          reject(new Error('Zu viele Weiterleitungen beim Node.js-Download.'));
+          return;
+        }
+        const redirect = new URL(response.headers.location, url);
+        if (redirect.protocol !== 'https:') {
+          reject(new Error('Unsichere Weiterleitung beim Node.js-Download abgelehnt.'));
+          return;
+        }
+        downloadFile(redirect.href, destination, redirectsLeft - 1).then(resolve, reject);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        response.resume();
+        reject(new Error(`Node.js-Download antwortete mit HTTP ${response.statusCode}.`));
+        return;
+      }
+
+      const contentLength = Number(response.headers['content-length'] || 0);
+      if (contentLength > MAX_ARCHIVE_BYTES) {
+        response.destroy();
+        reject(new Error('Node.js-Download ist groesser als erwartet.'));
+        return;
+      }
+
+      let received = 0;
+      const output = fs.createWriteStream(destination, { flags: 'wx' });
+      response.on('data', (chunk) => {
+        received += chunk.length;
+        if (received > MAX_ARCHIVE_BYTES) {
+          response.destroy(new Error('Node.js-Download ist groesser als erwartet.'));
+        }
+      });
+      response.on('error', reject);
+      output.on('error', reject);
+      output.on('finish', () => output.close(resolve));
+      response.pipe(output);
+    });
+    request.on('error', reject);
+    request.on('timeout', () => request.destroy(new Error('Zeitlimit beim Node.js-Download erreicht.')));
+  });
+}
+
+function usableNode(binary) {
+  if (!fs.existsSync(binary)) return false;
+  const result = spawnSync(binary, ['--version'], { encoding: 'utf8', timeout: 5_000 });
+  return result.status === 0 && result.stdout.trim() === `v${NODE_VERSION}`;
+}
+
+async function ensureManagedNode(blunHome, platform, arch) {
+  const distribution = distributionFor(platform, arch);
+  if (!distribution) {
+    throw new Error(
+      `Automatische Node.js-Einrichtung wird fuer ${platform}-${arch} noch nicht unterstuetzt.`,
+    );
+  }
+
+  const installDir = path.join(
+    blunHome,
+    'runtime',
+    'node',
+    `v${NODE_VERSION}-${platform}-${arch}`,
+  );
+  const binary = path.join(installDir, 'bin', 'node');
+  if (usableNode(binary)) return binary;
+
+  const staging = fs.mkdtempSync(path.join(os.tmpdir(), 'blun-node-runtime-'));
+  try {
+    const archive = path.join(staging, distribution.archive);
+    await downloadFile(
+      `https://nodejs.org/dist/v${NODE_VERSION}/${distribution.archive}`,
+      archive,
+    );
+
+    const actualSha = sha256File(archive);
+    if (actualSha !== distribution.sha256) {
+      throw new Error('Die SHA-256-Pruefsumme der Node.js-Laufzeit stimmt nicht.');
+    }
+
+    const extractedName = distribution.archive.slice(0, -'.tar.gz'.length);
+    const extractedDir = path.join(staging, extractedName);
+    const unpacked = spawnSync('/usr/bin/tar', ['-xzf', archive, '-C', staging], {
+      encoding: 'utf8',
+      timeout: 120_000,
+    });
+    if (unpacked.status !== 0 || !usableNode(path.join(extractedDir, 'bin', 'node'))) {
+      const detail = (unpacked.stderr || '').trim();
+      throw new Error(
+        `Die Node.js-Laufzeit konnte nicht entpackt werden${detail ? `: ${detail}` : '.'}`,
+      );
+    }
+
+    fs.mkdirSync(path.dirname(installDir), { recursive: true });
+    if (usableNode(binary)) return binary;
+    fs.rmSync(installDir, { recursive: true, force: true });
+    fs.renameSync(extractedDir, installDir);
+    if (!usableNode(binary)) throw new Error('Die installierte Node.js-Laufzeit startet nicht.');
+    return binary;
+  } finally {
+    fs.rmSync(staging, { recursive: true, force: true });
+  }
+}
+
+module.exports = {
+  DISTRIBUTIONS,
+  MAX_ARCHIVE_BYTES,
+  NODE_VERSION,
+  distributionFor,
+  ensureManagedNode,
+  sha256File,
+  usableNode,
+};

package/bin/node-runtime.js

@@ -0,0 +1,33 @@
+'use strict';
+
+const { ensureManagedNode } = require('./managed-node');
+const { unsupportedNodeMessage } = require('./node-version');
+
+async function prepareManagedNodeRuntime(options = {}) {
+  const version = options.version || process.versions.node;
+  const platform = options.platform || process.platform;
+  const arch = options.arch || process.arch;
+  const message = unsupportedNodeMessage(version, platform);
+  if (message === null) return { kind: 'current' };
+  if (platform !== 'darwin') return { kind: 'failed', message };
+
+  try {
+    const binary = await (options.ensureManagedNode || ensureManagedNode)(
+      options.blunDir,
+      platform,
+      arch,
+    );
+    return { binary, kind: 'managed' };
+  } catch (error) {
+    return {
+      kind: 'failed',
+      message: [
+        'Die automatische Node.js-Einrichtung ist fehlgeschlagen.',
+        error && error.message ? error.message : String(error),
+        message,
+      ].join('\n'),
+    };
+  }
+}
+
+module.exports = { prepareManagedNodeRuntime };

package/bin/node-version.js

@@ -0,0 +1,47 @@
+'use strict';
+
+const MINIMUM_NODE_VERSION = '24.15.0';
+
+function parseNodeVersion(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)/.exec(String(version));
+  return match ? match.slice(1).map(Number) : null;
+}
+
+function supportsNodeVersion(version) {
+  const actual = parseNodeVersion(version);
+  const minimum = parseNodeVersion(MINIMUM_NODE_VERSION);
+  if (!actual || !minimum) return false;
+
+  for (let index = 0; index < minimum.length; index += 1) {
+    if (actual[index] > minimum[index]) return true;
+    if (actual[index] < minimum[index]) return false;
+  }
+  return true;
+}
+
+function unsupportedNodeMessage(version, platform) {
+  if (supportsNodeVersion(version)) return null;
+
+  const lines = [
+    '',
+    'BLUN kann mit dieser Node.js-Version nicht starten.',
+    `Installiert: Node.js ${version}`,
+    `Benoetigt: Node.js ${MINIMUM_NODE_VERSION} oder neuer`,
+    '',
+  ];
+
+  if (platform === 'darwin') {
+    lines.push(`Falls die automatische Einrichtung scheitert: nvm install ${MINIMUM_NODE_VERSION}`);
+  } else {
+    lines.push(`Node.js ${MINIMUM_NODE_VERSION} oder neuer installieren: https://nodejs.org/`);
+  }
+  lines.push('Danach BLUN aktualisieren: npm i -g blun-king-cli@latest', '');
+  return lines.join('\n');
+}
+
+module.exports = {
+  MINIMUM_NODE_VERSION,
+  parseNodeVersion,
+  supportsNodeVersion,
+  unsupportedNodeMessage,
+};