coda-backend 0.2.246 → 0.2.250-preview

package/bin/coda-backend.mjs

@@ -1,10 +1,12 @@
 #!/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.
+// npm owns the package; the standard installer owns the backend. This foreground launcher installs the package's backend
+// when none is installed or the package's is newer, and keeps it running for the machine's process manager. Updates come
+// from Coda's clients (docs/deployment.md「用 npm 自己部署」): the parent process switches releases in place, or the
+// installer stops the backend and this starts the release it recorded.
 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 { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const script = fileURLToPath(import.meta.url);
@@ -18,60 +20,36 @@ function run(file, args) {
   });
 }
 
-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;
+// A backend version starts with its build's UTC commit time (docs/deployment.md「客户端更新后更新后端」); one without is older.
+export function newer(offered, installed) {
+  const time = version => /^(\d{14})-/.exec(version ?? '')?.[1] ?? '';
+  return !installed || time(offered) > time(installed);
 }
 
-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;
+export async function runBackend(root, { signals = process, report = log } = {}) {
+  let child, stopping = false, deadline;
   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);
+    stopping = true; child?.kill('SIGTERM');
+    deadline ??= setTimeout(() => child?.kill('SIGKILL'), 40_000);
   };
-  signals.on('SIGTERM', shutdown); signals.on('SIGINT', shutdown);
-  if (autoUpdate) timer = setTimeout(poll, firstCheck);
+  signals.on('SIGTERM', stop); signals.on('SIGINT', stop);
   try {
-    const code = await new Promise((done, reject) => {
-      child.once('error', reject); child.once('close', code => done(code ?? 1));
-    });
-    return { code, restart };
+    for (;;) {
+      const started = readJSON(join(root, 'installation.json'));
+      child = spawn(started.supervisor ?? started.node, started.supervisor ? ['--root', root]
+        : [join(root, 'backend-service.mjs'), 'run', '--root', root], { stdio: 'inherit', detached: true });
+      const code = await new Promise((done, reject) => {
+        child.once('error', reject); child.once('close', code => done(code ?? 1));
+      });
+      if (stopping) return code;
+      // The installer stopped it for the release it installed; anything else ends here, for the process manager.
+      const now = readJSON(join(root, 'installation.json'));
+      if (now.backend === started.backend && now.supervisor === started.supervisor) return code;
+      report('后端已更新，启动新版本');
+    }
   } finally {
-    controller.abort(); clearTimeout(timer); clearTimeout(deadline);
-    signals.removeListener('SIGTERM', shutdown); signals.removeListener('SIGINT', shutdown);
+    clearTimeout(deadline);
+    signals.removeListener('SIGTERM', stop); signals.removeListener('SIGINT', stop);
   }
 }
 
@@ -80,23 +58,23 @@ async function main() {
   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 后端，默认定期自动更新；交给本机的进程管理器常驻。');
+  if (!['run', 'install'].includes(command) || args.length > 1) {
+    console.log('coda-backend run：在前台运行 Coda 后端，交给本机的进程管理器常驻；在 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) {
+  // A client may have updated it past this package since; it is never taken back.
+  if (newer(version, installed)) {
     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'),
+      const install = [join(stage, 'scripts/backend-service.mjs'), 'install', '--no-start', '--foreground', '--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)) {
@@ -107,12 +85,7 @@ async function main() {
     } 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;
+  process.exitCode = await runBackend(root);
 }
 
 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,6 @@
 {
   "name": "coda-backend",
-  "version": "0.2.246",
+  "version": "0.2.250-preview",
   "description": "Coda 后端，由本机的进程管理器常驻运行",
   "type": "module",
   "bin": {
@@ -9,9 +9,12 @@
   "engines": {
     "node": ">=24"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coda-console/coda.git"
+  },
   "coda": {
-    "repository": "damaged-soda/coda-releases",
-    "channel": "stable"
+    "channel": "preview"
   },
   "os": [
     "linux",

package/payload/version

@@ -1 +1 @@
-20261024102151-f6c29c95e7ce-f363269f46f6
+20261027090016-b448042e8485-b91d68b6c557