coda-backend 0.0.0-stage → 0.2.250-preview

package/bin/coda-backend.mjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+// 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 } 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}）`)));
+  });
+}
+
+// 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, { signals = process, report = log } = {}) {
+  let child, stopping = false, deadline;
+  const stop = () => {
+    stopping = true; child?.kill('SIGTERM');
+    deadline ??= setTimeout(() => child?.kill('SIGKILL'), 40_000);
+  };
+  signals.on('SIGTERM', stop); signals.on('SIGINT', stop);
+  try {
+    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 {
+    clearTimeout(deadline);
+    signals.removeListener('SIGTERM', stop); signals.removeListener('SIGINT', stop);
+  }
+}
+
+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.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 && (existing.channel ?? 'stable') !== pkg.coda.channel) throw new Error('此后端属于另一个更新通道');
+  const installed = existsSync(join(root, 'backend-version')) ? readFileSync(join(root, 'backend-version'), 'utf8').trim() : null;
+  // 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', '--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)) {
+        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;
+  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,24 @@
 {
   "name": "coda-backend",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.250-preview",
+  "description": "Coda 后端，由本机的进程管理器常驻运行",
+  "type": "module",
+  "bin": {
+    "coda-backend": "bin/coda-backend.mjs"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coda-console/coda.git"
+  },
+  "coda": {
+    "channel": "preview"
+  },
+  "os": [
+    "linux",
+    "darwin"
+  ],
+  "license": "UNLICENSED"
+}

package/payload/backend.tar.gz

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: package/payload/backend.tar.gz
+size: 34674760 bytes
+sha256: c13ef36ea3ec36f8c58e2ff88d5a02d651153a662be08f4dc08bf2e6157c7d29

package/payload/version

@@ -0,0 +1 @@
+20261027090016-b448042e8485-b91d68b6c557

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.