// =============================================================================
// version_handler_node.txt — Node (Express) /__version__ 探针 (gongkong L2)
// =============================================================================
// 复制本片段到你的 Express app 入口文件即可。
//
// 作用: 暴露 GET /__version__ 路由, 返回当前进程的 commit/build_time/service。
// build-deploy-node.sh 通过写 version.json 文件注入, 部署后 curl 校验服务器跑的
// commit == 本地 HEAD, 对得上才说明真的部署生效 (gongce 协议0)。
//
// 接入步骤:
//   1. 把本片段贴到你的 app.js/index.js 入口
//   2. systemd unit 加: Environment=VERSION_FILE=/etc/<service>/version.json
//      (build-deploy-node.sh 会自动写这个文件)
//   3. 部署脚本跑 bash build-deploy-node.sh
// =============================================================================

const express = require('express');
const fs = require('fs');
const path = require('path');

const app = express();

// 进程启动时间(只在启动时记录一次)
const _START_TIME = new Date().toISOString();

/**
 * 读 version.json 文件, 拿到 commit/build_time/service。
 * 文件由 build-deploy-node.sh 在部署时写入, 路径由环境变量 VERSION_FILE 指定。
 * 读不到文件时返回 unknown, 说明 systemd unit 没配 VERSION_FILE 环境变量。
 */
function _versionInfo() {
  const versionFile = process.env.VERSION_FILE;
  let info = {
    service: 'your-service-name',
    commit: 'unknown',
    build_time: 'unknown',
  };
  if (versionFile && fs.existsSync(versionFile)) {
    try {
      info = JSON.parse(fs.readFileSync(versionFile, 'utf8'));
    } catch (e) {
      // 解析失败保留 unknown, 部署脚本会因 commit != HEAD 而报错回滚
    }
  }
  info.start_time = _START_TIME;
  return info;
}

// GET /__version__ — 部署脚本 curl 这个路由校验 commit==本地 HEAD
app.get('/__version__', (req, res) => {
  res.json(_versionInfo());
});

// =============================================================================
// systemd unit 必须加(否则读不到 version.json, /__version__ 返回 unknown):
//   Environment=VERSION_FILE=/etc/yourapp/version.json
// build-deploy-node.sh 会自动写这个文件:
//   {"service":"yourapp","commit":"abc1234","build_time":"2026-08-21T06:42:06Z"}
// =============================================================================
