@yinuo-ngm/server 1.0.15 → 1.0.17

package/lib/routes/api-client/hub-token.routes.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiClientHubTokenRoutes = apiClientHubTokenRoutes;
-const core_1 = require("@yinuo-ngm/core");
+const errors_1 = require("@yinuo-ngm/errors");
 const api_1 = require("@yinuo-ngm/api");
 const node_stream_1 = require("node:stream");
 function normalizeNonEmptyString(value, field) {
     if (typeof value !== "string" || value.trim() === "") {
-        throw new core_1.AppError("BAD_REQUEST", `${field} is required`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, `${field} is required`);
     }
     return value.trim();
 }
@@ -32,13 +32,13 @@ async function resolveHubTokenConfig(app, body, tokenType) {
         return { baseUrl: inlineBaseUrl, token: inlineToken };
     }
     if (!body.projectId) {
-        throw new core_1.AppError("BAD_REQUEST", "projectId is required when baseUrl/token are not provided");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "projectId is required when baseUrl/token are not provided");
     }
     const project = await app.core.project.get(body.projectId);
     const config = readHubTokenConfigFromProject(project);
     const resolvedToken = tokenType === "personal" ? body.personalToken?.trim() || config.personalToken : config.token;
     if (!config.baseUrl || !resolvedToken) {
-        throw new core_1.AppError("BAD_REQUEST", tokenType === "personal"
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, tokenType === "personal"
             ? "project hub-v2 config missing (NGM_HUB_V2_BASE_URL/NGM_HUB_V2_PERSONAL_TOKEN)"
             : "project hub-v2 config missing (NGM_HUB_V2_BASE_URL/NGM_HUB_V2_TOKEN)");
     }
@@ -59,7 +59,7 @@ async function apiClientHubTokenRoutes(fastify) {
         const response = await requestHubApiRaw(baseUrl, "/api/token", token, "GET", normalizedPath);
         if (!response.ok) {
             const payload = await parseJson(response);
-            throw new core_1.AppError("BAD_REQUEST", payload?.message || `hub-v2 request failed (${response.status})`, {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, payload?.message || `hub-v2 request failed (${response.status})`, {
                 status: response.status,
                 response: payload,
             });
@@ -81,7 +81,29 @@ async function apiClientHubTokenRoutes(fastify) {
         const response = await requestHubApiRaw(baseUrl, "/api/token", token, "GET", normalizedPath);
         if (!response.ok) {
             const payload = await parseJson(response);
-            throw new core_1.AppError("BAD_REQUEST", payload?.message || `hub-v2 request failed (${response.status})`, {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, payload?.message || `hub-v2 request failed (${response.status})`, {
+                status: response.status,
+                response: payload,
+            });
+        }
+        copyRawResponseHeaders(response, reply);
+        const body = response.body;
+        if (!body) {
+            return reply.status(response.status).send();
+        }
+        return reply.status(response.status).send(node_stream_1.Readable.fromWeb(body));
+    });
+    fastify.get("/projects/:projectId/rd-items/:itemId/uploads/:uploadId/raw", async (req, reply) => {
+        const params = (req.params ?? {});
+        const projectId = normalizeNonEmptyString(params.projectId, "projectId");
+        const itemId = normalizeNonEmptyString(params.itemId, "itemId");
+        const uploadId = normalizeNonEmptyString(params.uploadId, "uploadId");
+        const { baseUrl, token, projectKey } = await resolveHubTokenConfig(fastify, { projectId }, "project");
+        const normalizedPath = normalizeHubTokenPath(`/rd-items/${itemId}/uploads/${uploadId}/raw`, projectKey);
+        const response = await requestHubApiRaw(baseUrl, "/api/token", token, "GET", normalizedPath);
+        if (!response.ok) {
+            const payload = await parseJson(response);
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, payload?.message || `hub-v2 request failed (${response.status})`, {
                 status: response.status,
                 response: payload,
             });
@@ -184,14 +206,14 @@ async function requestHubApi(baseUrl, apiPrefix, token, method, path, query, bod
     });
     const payload = await parseJson(response);
     if (!response.ok) {
-        throw new core_1.AppError("BAD_REQUEST", payload?.message || `hub-v2 request failed (${response.status})`, {
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, payload?.message || `hub-v2 request failed (${response.status})`, {
             status: response.status,
             response: payload,
         });
     }
     if (payload && typeof payload === "object" && "code" in payload) {
         if (payload.code !== "OK") {
-            throw new core_1.AppError("BAD_REQUEST", payload.message || "hub-v2 response error", {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, payload.message || "hub-v2 response error", {
                 response: payload,
             });
         }
@@ -237,7 +259,7 @@ function assertPathProjectSegmentNotLocalProjectId(path, projectId) {
     }
     const projectSegment = (matched[1] ?? "").trim();
     if (projectSegment && projectSegment === localProjectId) {
-        throw new core_1.AppError("BAD_REQUEST", "path must use projectKey (or business relative path), not local projectId");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "path must use projectKey (or business relative path), not local projectId");
     }
 }
 function normalizeHubTokenPath(path, projectKey) {
@@ -249,7 +271,7 @@ function normalizeHubTokenPath(path, projectKey) {
         return `/projects/${key}${rest}`;
     }
     if (!projectKey) {
-        throw new core_1.AppError("BAD_REQUEST", "projectKey is required when path does not include /projects/:projectKey");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "projectKey is required when path does not include /projects/:projectKey");
     }
     return `/projects/${projectKey}${p}`;
 }

package/lib/routes/api-client/request.routes.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiClientRequestsRoutes = apiClientRequestsRoutes;
+const errors_1 = require("@yinuo-ngm/errors");
 function parseScope(q) {
     const scope = (q?.scope ?? "project");
     const projectId = q?.projectId;
     if (scope === "project" && !projectId) {
-        throw new Error("projectId is required when scope=project");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "projectId is required when scope=project");
     }
     return { scope, projectId };
 }
@@ -30,9 +31,9 @@ async function apiClientRequestsRoutes(fastify) {
         const body = req.body;
         const scope = body?.scope ?? "project";
         if (scope === "project" && !body.projectId)
-            throw new Error("projectId is required when scope=project");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "projectId is required when scope=project");
         if (!body?.request?.id)
-            throw new Error("request.id is required");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "request.id is required");
         await api.saveRequest(body.request, scope, body.projectId);
         return { id: body.request.id };
     });
@@ -40,12 +41,12 @@ async function apiClientRequestsRoutes(fastify) {
         const body = req.body;
         const scope = body?.scope ?? "project";
         if (scope === "project" && !body.projectId)
-            throw new Error("projectId is required when scope=project");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "projectId is required when scope=project");
         if (!body?.request?.id)
-            throw new Error("request.id is required");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "request.id is required");
         const old = await api.getRequest(body.request.id, scope, body.projectId);
         if (!old)
-            throw new Error("request not found: " + body.request.id);
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, "request not found: " + body.request.id);
         const updated = {
             ...old,
             ...body.request,

package/lib/routes/api-client/send.routes.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiClientSendRoutes = apiClientSendRoutes;
+const errors_1 = require("@yinuo-ngm/errors");
 const hub_cookie_jar_1 = require("./hub-cookie-jar");
 async function apiClientSendRoutes(fastify) {
     const api = fastify.api;
@@ -8,9 +9,9 @@ async function apiClientSendRoutes(fastify) {
         const body = req.body;
         const scope = body.scope ?? "project";
         if (scope === "project" && !body.projectId)
-            throw new Error("projectId is required when scope=project");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "projectId is required when scope=project");
         if (!body.request && !body.requestId)
-            throw new Error("request or requestId is required");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "request or requestId is required");
         const useCookieJar = body.useCookieJar !== false;
         const sessionKey = body.sessionKey ?? `${scope}:${body.projectId ?? "global"}:${body.envId ?? "default"}`;
         if (body.clearCookieJar) {

package/lib/routes/config.routes.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = configRoutes;
-const core_1 = require("@yinuo-ngm/core");
+const errors_1 = require("@yinuo-ngm/errors");
 const editor_1 = require("../common/editor");
 async function configRoutes(fastify) {
     fastify.get("/catalog/:projectId", async (req) => {
@@ -17,7 +17,7 @@ async function configRoutes(fastify) {
         const body = req.body;
         const next = body?.raw ?? body?.data;
         if (next === undefined) {
-            throw new core_1.AppError("CONFIG_WRITE_FAILED", "missing body.raw or body.data", { projectId, docId });
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.CONFIG_WRITE_FAILED, "missing body.raw or body.data", { projectId, docId });
         }
         return await fastify.core.config.writeDoc(projectId, docId, next);
     });
@@ -29,7 +29,7 @@ async function configRoutes(fastify) {
             return { ok: true };
         }
         catch (e) {
-            throw new core_1.AppError("EDITOR_LAUNCH_FAILED", e?.message || "openInEditor failed");
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.EDITOR_LAUNCH_FAILED, e?.message || "openInEditor failed");
         }
     });
     fastify.get("/readSchema/:projectId/:domainId", async (req) => {
@@ -41,7 +41,7 @@ async function configRoutes(fastify) {
         const body = req.body;
         const vm = body?.vm;
         if (vm === undefined) {
-            throw new core_1.AppError("BAD_REQUEST", "missing body.vm");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "missing body.vm");
         }
         await fastify.core.config.writeDomainSchema(projectId, domainId, vm);
         return {
@@ -58,7 +58,7 @@ async function configRoutes(fastify) {
         const body = req.body;
         const vm = body?.vm;
         if (vm === undefined) {
-            throw new core_1.AppError("BAD_REQUEST", "missing body.vm");
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "missing body.vm");
         }
         return await fastify.core.config.diffDomainSchema(projectId, domainId, vm);
     });

package/lib/routes/hub.routes.js

@@ -1,23 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = hubRoutes;
-const core_1 = require("@yinuo-ngm/core");
+const errors_1 = require("@yinuo-ngm/errors");
 const DEFAULT_HUB_PUBLIC_BASE_URL = "http://192.168.1.31:7070/api/public";
 function normalizeText(value, maxLen, fieldName) {
     if (value === undefined || value === null)
         return undefined;
     if (typeof value !== "string") {
-        throw new core_1.AppError("BAD_REQUEST", `${fieldName} must be string`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, `${fieldName} must be string`);
     }
     const text = value.trim();
     if (text.length > maxLen) {
-        throw new core_1.AppError("BAD_REQUEST", `${fieldName} length must <= ${maxLen}`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, `${fieldName} length must <= ${maxLen}`);
     }
     return text;
 }
 function validateBody(input) {
     if (!input || typeof input !== "object") {
-        throw new core_1.AppError("BAD_REQUEST", "invalid feedback payload");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "invalid feedback payload");
     }
     const body = input;
     const category = body.category;
@@ -29,13 +29,13 @@ function validateBody(input) {
     const clientVersion = normalizeText(body.clientVersion, 60, "clientVersion");
     const osInfo = normalizeText(body.osInfo, 200, "osInfo");
     if (!category || !["bug", "suggestion", "feature", "other"].includes(category)) {
-        throw new core_1.AppError("BAD_REQUEST", "invalid feedback category");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "invalid feedback category");
     }
     if (!title) {
-        throw new core_1.AppError("BAD_REQUEST", "feedback title is required");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "feedback title is required");
     }
     if (!content) {
-        throw new core_1.AppError("BAD_REQUEST", "feedback content is required");
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "feedback content is required");
     }
     return {
         category,
@@ -82,7 +82,7 @@ async function hubRoutes(app) {
             });
         }
         catch (error) {
-            throw new core_1.AppError("UNKNOWN_ERROR", "failed to connect hub service", { cause: error?.message || String(error), targetUrl });
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.UNKNOWN_ERROR, "failed to connect hub service", { cause: error?.message || String(error), targetUrl });
         }
         let payload = null;
         try {
@@ -93,10 +93,10 @@ async function hubRoutes(app) {
         }
         if (!response.ok) {
             const message = payload?.message || `hub response error (${response.status})`;
-            throw new core_1.AppError("UNKNOWN_ERROR", message, { status: response.status, payload });
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.UNKNOWN_ERROR, message, { status: response.status, payload });
         }
         if (payload?.code !== "OK") {
-            throw new core_1.AppError("UNKNOWN_ERROR", payload?.message || "hub feedback submit failed", { payload });
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.UNKNOWN_ERROR, payload?.message || "hub feedback submit failed", { payload });
         }
         return payload?.data ?? payload;
     });

package/lib/routes/index.js

@@ -19,6 +19,7 @@ const svn_routes_1 = __importDefault(require("./svn.routes"));
 const sprite_browse_routes_1 = __importDefault(require("./sprite-browse.routes"));
 const static_files_routes_1 = __importDefault(require("./static-files.routes"));
 const hub_routes_1 = __importDefault(require("./hub.routes"));
+const node_version_routes_1 = __importDefault(require("./node-version.routes"));
 async function routes(fastify) {
     await fastify.register(system_routes_1.default);
     await fastify.register(task_routes_1.default, { prefix: '/api/tasks' });
@@ -40,4 +41,5 @@ async function routes(fastify) {
     await fastify.register(api_client_1.apiClientCollectionsRoutes, { prefix: '/api/client/collections' });
     await fastify.register(api_client_1.apiClientHubTokenRoutes, { prefix: '/api/client/hub-token' });
     await fastify.register(nginx_routes_1.nginxRoutes, { prefix: '/api/nginx' });
+    await fastify.register(node_version_routes_1.default, { prefix: '/api/node-version' });
 }

package/lib/routes/nginx/nginx-lifecycle.routes.js

@@ -65,6 +65,10 @@ function registerNginxLifecycleRoutes(context) {
             success: true,
         });
     });
+    fastify.get('/local-ip', async (_request, reply) => {
+        const result = await nginx.service.getLocalIp();
+        return reply.send(result);
+    });
     fastify.post('/start', async (_request, reply) => {
         const result = await nginx.service.start();
         if (result.success) {

package/lib/routes/nginx/nginx-route.context.js

@@ -2,23 +2,39 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createNginxRouteContext = createNginxRouteContext;
 exports.sendBadRequest = sendBadRequest;
+const promises_1 = require("fs/promises");
 const path_1 = require("path");
-const core_1 = require("@yinuo-ngm/core");
+const errors_1 = require("@yinuo-ngm/errors");
 function createNginxRouteContext(fastify) {
     const nginx = fastify.nginx;
     const normalizeFsPath = (filePath) => (0, path_1.resolve)(filePath).replace(/\\/g, '/').toLowerCase();
     const ensureManageableConfigFile = async (rawPath) => {
         const filePath = rawPath?.trim();
         if (!filePath) {
-            throw new Error('配置文件路径不能为空');
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, '配置文件路径不能为空');
         }
         const included = await nginx.config.getIncludedConfigs();
-        const includedSet = new Set(included.map(item => normalizeFsPath(item)));
-        const normalizedTarget = normalizeFsPath(filePath);
+        const includedSet = new Set();
+        for (const item of included) {
+            try {
+                includedSet.add(normalizeFsPath(await (0, promises_1.realpath)(item)));
+            }
+            catch {
+                includedSet.add(normalizeFsPath((0, path_1.resolve)(item)));
+            }
+        }
+        const resolvedTarget = (0, path_1.resolve)(filePath);
+        let normalizedTarget;
+        try {
+            normalizedTarget = normalizeFsPath(await (0, promises_1.realpath)(resolvedTarget));
+        }
+        catch {
+            normalizedTarget = normalizeFsPath(resolvedTarget);
+        }
         if (!includedSet.has(normalizedTarget)) {
-            throw new Error('配置文件不在当前可管理列表中');
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.OP_NOT_FOUND, '配置文件不在当前可管理列表中');
         }
-        return (0, path_1.resolve)(filePath);
+        return resolvedTarget;
     };
     return {
         fastify,
@@ -29,7 +45,7 @@ function createNginxRouteContext(fastify) {
 }
 function sendBadRequest(reply, error) {
     const message = error instanceof Error ? error.message : String(error ?? '未知错误');
-    throw new core_1.AppError('BAD_REQUEST', message, {
+    throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, message, {
         route: reply.request?.url,
         method: reply.request?.method,
     });

package/lib/routes/nginx/nginx-server.routes.js

@@ -1,16 +1,80 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerNginxServerRoutes = registerNginxServerRoutes;
-const core_1 = require("@yinuo-ngm/core");
+const errors_1 = require("@yinuo-ngm/errors");
 const nginx_route_context_1 = require("./nginx-route.context");
 function registerNginxServerRoutes(context) {
     const { fastify, nginx } = context;
+    const buildRuntimeStatus = (enabled, nginxRunning, pendingReload) => {
+        if (!enabled) {
+            return 'disabled';
+        }
+        if (nginxRunning === null) {
+            return 'unknown';
+        }
+        if (pendingReload) {
+            return 'pending';
+        }
+        return nginxRunning ? 'running' : 'stopped';
+    };
+    const parseIsoMs = (value) => {
+        const text = String(value || '').trim();
+        if (!text) {
+            return null;
+        }
+        const ms = Date.parse(text);
+        return Number.isFinite(ms) ? ms : null;
+    };
+    const isServerPendingReload = (server, nginxRunning, lastAppliedAt) => {
+        if (!server.enabled || !nginxRunning) {
+            return false;
+        }
+        if (lastAppliedAt === null) {
+            return false;
+        }
+        const changedAt = parseIsoMs(server.updatedAt) ?? parseIsoMs(server.createdAt);
+        if (changedAt === null) {
+            return false;
+        }
+        return changedAt > lastAppliedAt;
+    };
+    const resolveActor = (request) => {
+        const directHeader = request.headers['x-ngm-user'] || request.headers['x-user'] || request.headers['x-username'];
+        if (typeof directHeader === 'string' && directHeader.trim()) {
+            return directHeader.trim();
+        }
+        const user = request?.user;
+        if (typeof user?.name === 'string' && user.name.trim()) {
+            return user.name.trim();
+        }
+        if (typeof user?.username === 'string' && user.username.trim()) {
+            return user.username.trim();
+        }
+        if (typeof user?.id === 'string' && user.id.trim()) {
+            return user.id.trim();
+        }
+        return undefined;
+    };
     fastify.get('/servers', async (_request, reply) => {
         try {
             const servers = await nginx.server.getAllServers();
+            let nginxRunning = null;
+            let lastAppliedAt = null;
+            try {
+                const status = await nginx.service.getStatus();
+                nginxRunning = Boolean(status.isRunning);
+                lastAppliedAt = nginx.service.getLastConfigAppliedAt();
+            }
+            catch {
+                nginxRunning = null;
+            }
+            const enriched = servers.map(server => ({
+                ...server,
+                runtimeStatus: buildRuntimeStatus(Boolean(server.enabled), nginxRunning, isServerPendingReload(server, nginxRunning, lastAppliedAt)),
+            }));
             return reply.send({
                 success: true,
-                servers,
+                servers: enriched,
             });
         }
         catch (error) {
@@ -22,11 +86,25 @@ function registerNginxServerRoutes(context) {
         try {
             const server = await nginx.server.getServer(id);
             if (!server) {
-                throw new core_1.AppError('NOT_FOUND', 'Server 不存在');
+                throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, 'Server 不存在');
+            }
+            let nginxRunning = null;
+            let lastAppliedAt = null;
+            try {
+                const status = await nginx.service.getStatus();
+                nginxRunning = Boolean(status.isRunning);
+                lastAppliedAt = nginx.service.getLastConfigAppliedAt();
             }
+            catch {
+                nginxRunning = null;
+            }
+            const enriched = {
+                ...server,
+                runtimeStatus: buildRuntimeStatus(Boolean(server.enabled), nginxRunning, isServerPendingReload(server, nginxRunning, lastAppliedAt)),
+            };
             return reply.send({
                 success: true,
-                server,
+                server: enriched,
             });
         }
         catch (error) {
@@ -35,7 +113,11 @@ function registerNginxServerRoutes(context) {
     });
     fastify.post('/servers', async (request, reply) => {
         try {
-            const server = await nginx.server.createServer(request.body);
+            const actor = resolveActor(request);
+            const payload = actor
+                ? { ...request.body, createdBy: request.body?.createdBy || actor }
+                : { ...request.body };
+            const server = await nginx.server.createServer(payload);
             return reply.send({
                 success: true,
                 server,
@@ -61,9 +143,26 @@ function registerNginxServerRoutes(context) {
     fastify.delete('/servers/:id', async (request, reply) => {
         const { id } = request.params;
         try {
-            await nginx.server.deleteServer(id);
+            const result = await nginx.server.deleteServer(id);
+            return reply.send({
+                success: true,
+                snapshotId: result.snapshotId,
+            });
+        }
+        catch (error) {
+            return (0, nginx_route_context_1.sendBadRequest)(reply, error);
+        }
+    });
+    fastify.post('/servers/restore-deleted', async (request, reply) => {
+        try {
+            const snapshotId = String(request.body?.snapshotId || '').trim();
+            if (!snapshotId) {
+                throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, 'snapshotId 不能为空');
+            }
+            const server = await nginx.server.restoreDeletedServer(snapshotId);
             return reply.send({
                 success: true,
+                server,
             });
         }
         catch (error) {
@@ -94,4 +193,57 @@ function registerNginxServerRoutes(context) {
             return (0, nginx_route_context_1.sendBadRequest)(reply, error);
         }
     });
+    fastify.post('/servers/import/parse', async (request, reply) => {
+        try {
+            const content = String(request.body?.content || '').trim();
+            if (!content) {
+                return reply.send({
+                    success: true,
+                    candidates: [],
+                });
+            }
+            const candidates = await nginx.server.parseImportCandidates(content);
+            return reply.send({
+                success: true,
+                candidates,
+            });
+        }
+        catch (error) {
+            return (0, nginx_route_context_1.sendBadRequest)(reply, error);
+        }
+    });
+    fastify.post('/servers/import/analyze', async (request, reply) => {
+        try {
+            const requests = Array.isArray(request.body?.requests) ? request.body.requests : [];
+            const candidates = await nginx.server.analyzeImportRequests(requests);
+            return reply.send({
+                success: true,
+                candidates,
+            });
+        }
+        catch (error) {
+            return (0, nginx_route_context_1.sendBadRequest)(reply, error);
+        }
+    });
+    fastify.post('/servers/validate-ssl-paths', async (request, reply) => {
+        try {
+            const certPath = String(request.body?.sslCert || '').trim();
+            const keyPath = String(request.body?.sslKey || '').trim();
+            const cert = certPath
+                ? await nginx.service.validateFileReadable(certPath)
+                : { exists: false, readable: false, error: '证书路径为空' };
+            const key = keyPath
+                ? await nginx.service.validateFileReadable(keyPath)
+                : { exists: false, readable: false, error: '私钥路径为空' };
+            return reply.send({
+                success: true,
+                valid: cert.exists && cert.readable && key.exists && key.readable,
+                cert,
+                key,
+            });
+        }
+        catch (error) {
+            return (0, nginx_route_context_1.sendBadRequest)(reply, error);
+        }
+    });
 }

package/lib/routes/node-version.routes.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from 'fastify';
+export default function nodeVersionRoutes(fastify: FastifyInstance): Promise<void>;

package/lib/routes/node-version.routes.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = nodeVersionRoutes;
+const errors_1 = require("@yinuo-ngm/errors");
+async function nodeVersionRoutes(fastify) {
+    fastify.get('/current', async () => {
+        const service = fastify.core.nodeVersion;
+        return await service.getCurrentVersion();
+    });
+    fastify.post('/switch', async (req) => {
+        const { version } = req.body || {};
+        if (!version) {
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.VERSION_REQUIRED, '请指定要切换的 Node 版本', {});
+        }
+        const service = fastify.core.nodeVersion;
+        return await service.switchVersion(version);
+    });
+    fastify.post('/project-requirement', async (req) => {
+        const { projectPath } = req.body || {};
+        if (!projectPath) {
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.PROJECT_PATH_REQUIRED, '请指定项目路径', {});
+        }
+        const service = fastify.core.nodeVersion;
+        return await service.detectProjectRequirement(projectPath);
+    });
+    fastify.post('/install', async (req) => {
+        const { version } = req.body || {};
+        if (!version) {
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.VERSION_REQUIRED, '请指定要安装的 Node 版本', {});
+        }
+        const service = fastify.core.nodeVersion;
+        const result = await service.installNodeVersion(version);
+        return result;
+    });
+    fastify.post('/uninstall', async (req) => {
+        const { version } = req.body || {};
+        if (!version) {
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.VERSION_REQUIRED, '请指定要卸载的 Node 版本', {});
+        }
+        const service = fastify.core.nodeVersion;
+        const success = await service.uninstallNodeVersion(version);
+        return { success };
+    });
+    fastify.post('/write-engine-config', async (req) => {
+        const { projectPath, version } = req.body || {};
+        if (!projectPath) {
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.PROJECT_PATH_REQUIRED, '请指定项目路径', {});
+        }
+        if (!version) {
+            throw new errors_1.CoreError(errors_1.CoreErrorCodes.VERSION_REQUIRED, '请指定版本要求', {});
+        }
+        const service = fastify.core.nodeVersion;
+        const success = await service.writeEngineConfig(projectPath, version);
+        return { success };
+    });
+}