feat: 新增版本管理系统，重构 /health → /api/meta

src/server/bootstrap.ts

@@ -17,6 +17,7 @@ export interface BootstrapOptions {
   configPath?: string;
   mode: RuntimeMode;
   staticAssets?: StartServerOptions["staticAssets"];
+  version?: string;
 }
 
 export async function bootstrap(options: BootstrapOptions, dependencies: BootstrapDependencies = {}): Promise<void> {
@@ -38,7 +39,7 @@ export async function bootstrap(options: BootstrapOptions, dependencies: Bootstr
     onSignal("SIGINT", shutdown);
     onSignal("SIGTERM", shutdown);
 
-    serve({ config, mode: options.mode, staticAssets: options.staticAssets });
+    serve({ config, mode: options.mode, staticAssets: options.staticAssets, version: options.version });
   } catch (error) {
     logError("启动失败:", error instanceof Error ? error.message : error);
     process.exit(1);

src/server/helpers.ts

@@ -1,4 +1,4 @@
-import type { ApiErrorResponse, HealthResponse, RuntimeMode } from "../shared/api";
+import type { ApiErrorResponse, MetaResponse, RuntimeMode } from "../shared/api";
 
 import { APP } from "../shared/app";
 
@@ -17,11 +17,12 @@ export function createHeaders(mode: RuntimeMode, init: HeadersInit): Headers {
   return headers;
 }
 
-export function createHealthResponse(): HealthResponse {
+export function createMetaResponse(version: string): MetaResponse {
   return {
     ok: true,
     service: APP.name,
     timestamp: new Date().toISOString(),
+    version,
   };
 }
 

src/server/routes/health.ts

@@ -1,7 +0,0 @@
-import type { RuntimeMode } from "../../shared/api";
-
-import { createHealthResponse, jsonResponse } from "../helpers";
-
-export function handleHealth(mode: RuntimeMode): Response {
-  return jsonResponse(createHealthResponse(), { mode });
-}

src/server/routes/meta.ts

@@ -0,0 +1,7 @@
+import type { RuntimeMode } from "../../shared/api";
+
+import { createMetaResponse, jsonResponse } from "../helpers";
+
+export function handleMeta(mode: RuntimeMode, version: string): Response {
+  return jsonResponse(createMetaResponse(version), { mode });
+}

src/server/server.ts

@@ -4,17 +4,24 @@ import type { StaticAssets } from "./static";
 
 import { APP } from "../shared/app";
 import { createApiError, jsonResponse } from "./helpers";
-import { handleHealth } from "./routes/health";
+import { handleMeta } from "./routes/meta";
 import { serveStaticAsset } from "./static";
+import { readAppVersion } from "./version";
 
 export interface StartServerOptions {
   config: ServerConfig;
   mode: RuntimeMode;
   staticAssets?: StaticAssets;
+  version?: string;
 }
 
 export function startServer(options: StartServerOptions) {
-  const { config, mode, staticAssets } = options;
+  const { config, mode, staticAssets, version } = options;
+
+  const resolveVersion = (): Promise<string> => {
+    if (version) return Promise.resolve(version);
+    return readAppVersion();
+  };
 
   const server = Bun.serve({
     fetch(req) {
@@ -27,8 +34,11 @@ export function startServer(options: StartServerOptions) {
     port: config.port,
     routes: {
       "/api/*": () => jsonResponse(createApiError("API route not found", 404), { mode, status: 404 }),
-      "/health": {
-        GET: () => handleHealth(mode),
+      "/api/meta": {
+        GET: async () => {
+          const resolvedVersion = await resolveVersion();
+          return handleMeta(mode, resolvedVersion);
+        },
       },
     },
   });

src/server/version.ts

@@ -0,0 +1,17 @@
+import { resolve } from "node:path";
+
+import { validateVersion } from "../../scripts/bump-version-logic";
+
+const PACKAGE_JSON_PATH = resolve(import.meta.dir, "..", "..", "package.json");
+
+export async function readAppVersion(): Promise<string> {
+  const packageJson = (await Bun.file(PACKAGE_JSON_PATH).json()) as { version: string };
+  const version = packageJson.version;
+
+  if (typeof version !== "string") {
+    throw new Error("package.json does not have a valid version field");
+  }
+
+  validateVersion(version);
+  return version;
+}