@kne/fastify-app-manager 0.1.16 → 0.1.18

package/README.md

@@ -263,7 +263,7 @@ await fastify.listen({ port: 3000 });
 |--------|------|------|--------|------|
 | name | string | 是 | - | slug：`^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$` |
 | label | string | 是 | - | 展示名 |
-| domain | string | 否 | - | 绑定 Host（唯一）；冲突返回 409 |
+| domain | string / null | 否 | - | 绑定 Host（唯一）；冲突返回 409；空值存为 `null` |
 | icon | string | 否 | - | 图标 |
 | description | string | 否 | - | 描述 |
 | category | object / string | 否 | - | 应用分类（应用中心分组用），写入 `options.category`；推荐传 fastify-group 分组对象，对象只保留 `{ code, name }`，字符串原样保存 |
@@ -282,7 +282,7 @@ await fastify.listen({ port: 3000 });
 | 参数名 | 类型 | 必填 | 说明 |
 |--------|------|------|------|
 | name | string | 是 | 应用 slug |
-| label / domain / icon / description / env / pm2Config / options | - | 否 | 传入的字段才更新；`env` 按 patch 语义合并 |
+| label / domain / icon / description / env / pm2Config / options | - | 否 | 传入的字段才更新；`env` 按 patch 语义合并；`domain` 传 `null` / `''` 解绑域名（存为 `null`） |
 | category | object / string / null | 否 | 合并写入 `options.category`（对象只保留 `{ code, name }`），不影响 `options` 其它键；传空值清除分类 |
 | isPublic | boolean | 否 | 合并写入 `options.isPublic`，不影响 `options` 其它键 |
 | entries | array / null | 否 | 整体替换 `options.entries`（规则同创建），不影响 `options` 其它键；传 `[]` / `null` 清空入口 |
@@ -428,7 +428,7 @@ await fastify.listen({ port: 3000 });
 
 ##### POST `{prefix}/app/deploy`
 
-选择版本部署。版本目录不在磁盘时先经 `resolveVersionFile` 取回 zip 解压并 `npm install`（耗时，取不回返回 400 且不改应用状态），再以数据库中的 SQL 覆盖目录内 `.sql`；接着按版本的 `env.schema.json` 校验最终环境变量（含注入的变量），版本没有 schema 或变量不合规时返回 400，且不切换版本、不执行迁移、不启动进程；随后立即返回 `deploying`，后台做健康检查。进程启动后删除该应用其它有 `fileId` 的版本目录（只保留当前版本）。
+选择版本部署。同一应用同时只能有一个部署：已有部署未结束（含就绪检查阶段）时返回 409，不影响进行中的部署。版本目录不在磁盘时先经 `resolveVersionFile` 取回 zip 解压并 `npm install`（耗时，取不回返回 400 且不改应用状态），再以数据库中的 SQL 覆盖目录内 `.sql`；接着按版本的 `env.schema.json` 校验最终环境变量（含注入的变量），版本没有 schema 或变量不合规时返回 400，且不切换版本、不执行迁移、不启动进程；随后立即返回 `deploying`，后台做健康检查。进程启动后删除该应用其它有 `fileId` 的版本目录（只保留当前版本）。
 
 | 参数名 | 类型 | 必填 | 默认值 | 说明 |
 |--------|------|------|--------|------|
@@ -757,7 +757,7 @@ data: {"name":"demo","ts":1791456608533,...}
 | `pruneAllVersionArtifacts()` | 对所有应用执行 `pruneVersionArtifacts` |
 | `restoreMissingArtifacts()` | 当前版本目录（`artifactPath/server`）缺失时，按版本 `fileId` 经 `resolveVersionFile` 取回 zip 重建并恢复 `current` 链接（不跑 SQL 迁移）；返回 `[{ name, version, action: 'restored' \| 'skipped' \| 'failed', reason? }]`，无 `fileId` 的记 `skipped` |
 | `listVersions({ name, perPage, currentPage })` | 版本列表 |
-| `deploy({ name, versionId, version, runMigration, migrations?, progressId? })` | 部署；版本目录缺失时先从宿主文件重建，启动后清理其它版本目录；立即 `deploying`，后台 `syncRealStatus`；各阶段进度写入 `getDeployProgress()` |
+| `deploy({ name, versionId, version, runMigration, migrations?, progressId? })` | 部署；同一应用已有部署未结束时 409；版本目录缺失时先从宿主文件重建，启动后清理其它版本目录；立即 `deploying`，后台 `syncRealStatus`；各阶段进度写入 `getDeployProgress()` |
 | `getDeployProgress()` | 部署进度中心：`emitter`（事件名 `deploy:{name}`、日志 `deploy-log:{name}`）、`snapshot(name)` 返回最近一次部署 `{ progressId, status, events, ... }`、`active(name)` 进行中的部署 |
 | `deployList({ name, perPage?, currentPage? })` | 同 `GET .../app/deploy/list` |
 | `deployDetail({ name, progressId?, logLines? })` | 同 `GET .../app/deploy/detail` |

package/libs/controllers/app.js

@@ -23,7 +23,7 @@ module.exports = fp(async (fastify, options) => {
           properties: {
             name: { type: 'string' },
             label: { type: 'string' },
-            domain: { type: 'string' },
+            domain: { type: ['string', 'null'] },
             icon: { type: 'string' },
             description: { type: 'string' },
             category: { type: ['object', 'string', 'null'] },
@@ -54,7 +54,7 @@ module.exports = fp(async (fastify, options) => {
           properties: {
             name: { type: 'string' },
             label: { type: 'string' },
-            domain: { type: 'string' },
+            domain: { type: ['string', 'null'] },
             icon: { type: 'string' },
             description: { type: 'string' },
             category: { type: ['object', 'string', 'null'] },

package/libs/services/app.js

@@ -181,6 +181,10 @@ module.exports = fp(async (fastify, options) => {
       }
       patch[k] = v;
     }
+    // 空域名存 null：domain 有唯一约束，多个应用存 '' 会冲突
+    if (patch.domain !== undefined) {
+      patch.domain = patch.domain || null;
+    }
     if (patch.domain) {
       const domainTaken = await models.app.findOne({ where: { domain: patch.domain } });
       if (domainTaken && domainTaken.name !== name) {
@@ -1089,6 +1093,11 @@ module.exports = fp(async (fastify, options) => {
       httpError(404, 'version not found');
     }
 
+    // 判断与登记之间不能有 await，否则并发请求会同时通过
+    const running = deployProgress.active(app.name);
+    if (running) {
+      httpError(409, `app ${app.name} is deploying version ${running.version}`);
+    }
     const progress = deployProgress.begin(app.name, progressId || crypto.randomUUID(), { versionId: String(ver.id), version: ver.version });
     let step = 'package';
     progress.report(step, 'running');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kne/fastify-app-manager",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Fastify 单机应用市场插件：版本上传、PM2 托管、路径/域名反代与日志 SSE",
   "main": "index.js",
   "scripts": {