coda-backend 0.0.0-stage → 0.2.246

package/bin/coda-backend.mjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+// npm owns the package; the standard installer owns the backend. This foreground launcher checks for updates
+// and restarts through the updated npm entry point. The machine's process manager keeps the command running.
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, mkdtempSync, readFileSync, realpathSync, rmSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const script = fileURLToPath(import.meta.url);
+const readJSON = file => JSON.parse(readFileSync(file, 'utf8'));
+const log = message => console.log(`coda-backend: ${message}`);
+function run(file, args) {
+  return new Promise((done, reject) => {
+    const child = spawn(file, args, { stdio: 'inherit', detached: true });
+    child.once('error', reject);
+    child.once('close', code => code === 0 ? done() : reject(new Error(`${file} 失败（${code}）`)));
+  });
+}
+
+export async function checkForUpdate(directory, pkg, { signal, fetch = globalThis.fetch, execute = run } = {}) {
+  const { repository, channel } = pkg.coda;
+  const response = await fetch(`https://api.github.com/repos/${repository}/releases/latest`, {
+    signal: AbortSignal.any([...(signal ? [signal] : []), AbortSignal.timeout(30_000)]),
+    headers: { 'User-Agent': 'coda-backend', Accept: 'application/vnd.github+json' },
+  });
+  if (!response.ok) throw new Error(`检查更新失败：HTTP ${response.status}`);
+  const release = await response.json();
+  const offered = (channel === 'preview' ? /^v(\d+\.\d+\.\d+)-preview$/ : /^v(\d+\.\d+\.\d+)$/).exec(release.tag_name)?.[1];
+  if (release.draft || release.prerelease || !offered) throw new Error('发布不属于本后端的更新通道');
+  const current = pkg.version.replace(/-preview$/, '').split('.').map(Number);
+  if (!(offered.split('.').map((part, i) => Number(part) - current[i]).find(value => value !== 0) > 0)) return false;
+  const url = `https://github.com/${repository}/releases/download/${release.tag_name}/coda-backend.tgz`;
+  if (!release.assets?.some(asset => asset.name === 'coda-backend.tgz' && asset.browser_download_url === url))
+    throw new Error('发布没有 npm 安装包');
+  // Keep the same global prefix even if the process manager's npm config has changed.
+  const prefix = resolve(directory, '../../..');
+  if (join(prefix, 'lib/node_modules/coda-backend') !== directory) throw new Error('自动更新需要通过 npm install -g 安装');
+  log(`更新到 ${release.tag_name}`);
+  await execute('npm', ['install', '--global', '--prefix', prefix, '--no-audit', '--no-fund', url]);
+  signal?.throwIfAborted();
+  // Prepare dependencies while the current backend still serves. Let the installer finish its own cleanup on stop.
+  await execute(process.execPath, [join(directory, 'bin/coda-backend.mjs'), 'install']);
+  return true;
+}
+
+export async function runBackend(root, { autoUpdate = true, check, firstCheck = 60_000, interval = 6 * 60 * 60_000,
+  signals = process, report = log } = {}) {
+  const config = readJSON(join(root, 'installation.json'));
+  const child = spawn(config.supervisor ?? config.node, config.supervisor ? ['--root', root]
+    : [join(root, 'backend-service.mjs'), 'run', '--root', root], { stdio: 'inherit', detached: true });
+  const controller = new AbortController();
+  let timer, deadline, restart = false;
+  const stop = () => {
+    clearTimeout(timer); controller.abort(); child.kill('SIGTERM');
+    deadline ??= setTimeout(() => child.kill('SIGKILL'), 40_000);
+  };
+  const shutdown = () => { restart = false; stop(); };
+  const poll = async () => {
+    try {
+      if (await check({ signal: controller.signal }) && !controller.signal.aborted) { restart = true; stop(); }
+    } catch (error) { if (!controller.signal.aborted) report(`自动更新未完成：${error.message}；下次继续检查`); }
+    if (!controller.signal.aborted) timer = setTimeout(poll, interval);
+  };
+  signals.on('SIGTERM', shutdown); signals.on('SIGINT', shutdown);
+  if (autoUpdate) timer = setTimeout(poll, firstCheck);
+  try {
+    const code = await new Promise((done, reject) => {
+      child.once('error', reject); child.once('close', code => done(code ?? 1));
+    });
+    return { code, restart };
+  } finally {
+    controller.abort(); clearTimeout(timer); clearTimeout(deadline);
+    signals.removeListener('SIGTERM', shutdown); signals.removeListener('SIGINT', shutdown);
+  }
+}
+
+async function main() {
+  const directory = dirname(dirname(script)), payload = join(directory, 'payload');
+  const version = readFileSync(join(payload, 'version'), 'utf8').trim(), root = join(homedir(), '.local/share/coda');
+  const args = process.argv.slice(2), command = args[0] ?? 'run';
+  if (command === '--version' || command === 'version') { console.log(version); return; }
+  if (!['run', 'install'].includes(command) || args.slice(1).some(arg => arg !== '--no-auto-update')) {
+    console.log('coda-backend run [--no-auto-update]：在前台运行 Coda 后端，默认定期自动更新；交给本机的进程管理器常驻。');
+    process.exitCode = ['help', '--help'].includes(command) ? 0 : 2; return;
+  }
+  if (Number(process.versions.node.split('.')[0]) < 24) throw new Error(`需要 Node.js 24 或更新，现在是 ${process.version}`);
+  if (spawnSync('git', ['--version'], { stdio: 'ignore' }).status !== 0) throw new Error('需要 Git，请先安装');
+  const pkg = readJSON(join(directory, 'package.json'));
+  const configFile = join(root, 'installation.json'), existing = existsSync(configFile) ? readJSON(configFile) : null;
+  if (existing?.manager === 'coda-app') throw new Error('此后端由 Coda App 管理，请从该 App 更新');
+  if (existing && (existing.channel ?? 'stable') !== pkg.coda.channel) throw new Error('此后端属于另一个更新通道');
+  const installed = existsSync(join(root, 'backend-version')) ? readFileSync(join(root, 'backend-version'), 'utf8').trim() : null;
+  if (installed !== version) {
+    log(`安装后端 ${version} 到 ${root}`);
+    const stage = mkdtempSync(join(tmpdir(), 'coda-backend-'));
+    try {
+      await run('tar', ['-xzf', join(payload, 'backend.tar.gz'), '-C', stage]);
+      const install = [join(stage, 'scripts/backend-service.mjs'), 'install', '--no-start', '--source', join(stage, 'backend'),
+        '--package-version', version, '--channel', pkg.coda.channel];
+      const parent = join(payload, `supervisor-${process.platform}-${process.arch}.tar.gz`);
+      if (existsSync(parent)) {
+        await run('tar', ['-xzf', parent, '-C', stage]);
+        install.push('--supervisor', join(stage, 'coda-supervisor'));
+      }
+      await run(process.execPath, install);
+    } finally { rmSync(stage, { recursive: true, force: true }); }
+  }
+  if (command === 'install') return;
+  const result = await runBackend(root, {
+    autoUpdate: !args.includes('--no-auto-update') && process.env.CODA_NPM_AUTO_UPDATE !== '0',
+    check: options => checkForUpdate(directory, pkg, options),
+  });
+  if (result.restart) process.execve(process.execPath, [process.execPath, script, ...args], process.env);
+  process.exitCode = result.code;
+}
+
+if (process.argv[1] && realpathSync(process.argv[1]) === script) main().catch(error => { console.error(`coda-backend: ${error.message}`); process.exitCode = 1; });

package/package.json

@@ -1,6 +1,21 @@
 {
   "name": "coda-backend",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.246",
+  "description": "Coda 后端，由本机的进程管理器常驻运行",
+  "type": "module",
+  "bin": {
+    "coda-backend": "bin/coda-backend.mjs"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "coda": {
+    "repository": "damaged-soda/coda-releases",
+    "channel": "stable"
+  },
+  "os": [
+    "linux",
+    "darwin"
+  ],
+  "license": "UNLICENSED"
+}

package/payload/version

@@ -0,0 +1 @@
+20261024102151-f6c29c95e7ce-f363269f46f6

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.