@djvlc/openapi-admin-client 1.6.1 → 1.6.3

package/openapi/src/paths/definitions.yaml

@@ -101,7 +101,9 @@ actionDefinitionById:
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
   
-  put:
+
+actionDefinitionUpdate:
+  post:
     tags:
       - Definitions
     summary: 更新 ActionDefinition
@@ -134,6 +136,28 @@ actionDefinitionById:
         $ref: '../components/responses/_index.yaml#/BadRequest'
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
+  
+
+actionDefinitionDelete:
+  post:
+    tags:
+      - Definitions
+    summary: 删除 ActionDefinition
+    operationId: deleteActionDefinition
+    description: 删除 ActionDefinition（仅 draft 状态可删除）
+    parameters:
+      - name: definitionId
+        in: path
+        required: true
+        schema:
+          type: string
+    responses:
+      '204':
+        description: 删除成功
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+      '409':
+        $ref: '../components/responses/_index.yaml#/Conflict'
 
 actionDefinitionVersions:
   get:
@@ -156,6 +180,11 @@ actionDefinitionVersions:
         in: query
         schema:
           type: string
+      - name: status
+        in: query
+        schema:
+          type: string
+          enum: [draft, stable, deprecated, blocked]
     responses:
       '200':
         description: 成功
@@ -178,6 +207,9 @@ actionDefinitionVersions:
       - Definitions
     summary: 发布 ActionDefinition 新版本
     operationId: publishActionDefinitionVersion
+    description: |
+      发布新版本，版本一旦发布即不可变。
+      状态机：draft → stable → deprecated → blocked
     parameters:
       - name: definitionId
         in: path
@@ -202,6 +234,10 @@ actionDefinitionVersions:
                   type: boolean
                 data:
                   $ref: '../components/schemas/_index.yaml#/DefinitionVersionInfo'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
 
 # Data Query Definitions
 dataQueryDefinitions:
@@ -270,6 +306,10 @@ dataQueryDefinitions:
                   type: boolean
                 data:
                   $ref: '../components/schemas/_index.yaml#/DataQueryDefinitionInfo'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
 
 dataQueryDefinitionById:
   get:
@@ -297,6 +337,64 @@ dataQueryDefinitionById:
                   $ref: '../components/schemas/_index.yaml#/DataQueryDefinitionDetail'
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
+  
+
+dataQueryDefinitionUpdate:
+  post:
+    tags:
+      - Definitions
+    summary: 更新 DataQueryDefinition
+    operationId: updateDataQueryDefinition
+    parameters:
+      - name: definitionId
+        in: path
+        required: true
+        schema:
+          type: string
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../components/schemas/_index.yaml#/UpdateDataQueryDefinitionRequest'
+    responses:
+      '200':
+        description: 更新成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                data:
+                  $ref: '../components/schemas/_index.yaml#/DataQueryDefinitionInfo'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+  
+
+dataQueryDefinitionDelete:
+  post:
+    tags:
+      - Definitions
+    summary: 删除 DataQueryDefinition
+    operationId: deleteDataQueryDefinition
+    description: 删除 DataQueryDefinition（仅 draft 状态可删除）
+    parameters:
+      - name: definitionId
+        in: path
+        required: true
+        schema:
+          type: string
+    responses:
+      '204':
+        description: 删除成功
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+      '409':
+        $ref: '../components/responses/_index.yaml#/Conflict'
 
 dataQueryDefinitionVersions:
   get:
@@ -310,6 +408,11 @@ dataQueryDefinitionVersions:
         required: true
         schema:
           type: string
+      - name: status
+        in: query
+        schema:
+          type: string
+          enum: [draft, stable, deprecated, blocked]
     responses:
       '200':
         description: 成功
@@ -330,6 +433,9 @@ dataQueryDefinitionVersions:
       - Definitions
     summary: 发布 DataQueryDefinition 新版本
     operationId: publishDataQueryDefinitionVersion
+    description: |
+      发布新版本，版本一旦发布即不可变。
+      状态机：draft → stable → deprecated → blocked
     parameters:
       - name: definitionId
         in: path
@@ -354,3 +460,7 @@ dataQueryDefinitionVersions:
                   type: boolean
                 data:
                   $ref: '../components/schemas/_index.yaml#/DefinitionVersionInfo'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'

package/openapi/src/paths/drafts.yaml

@@ -22,7 +22,8 @@ draft:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
-  put:
+save:
+  post:
     tags: [Drafts]
     operationId: saveDraft
     summary: 保存草稿
@@ -53,16 +54,35 @@ draft:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
-  delete:
+discard:
+  post:
     tags: [Drafts]
     operationId: discardDraft
     summary: 丢弃草稿
     description: 丢弃当前草稿，恢复到最后发布的版本
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    requestBody:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              reason:
+                type: string
+                description: 丢弃原因
     responses:
-      '204':
+      '200':
         description: 丢弃成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                message:
+                  type: string
       '401':
         $ref: '../components/responses/_index.yaml#/Unauthorized'
       '404':

package/openapi/src/paths/health.yaml

@@ -0,0 +1,88 @@
+# Health 健康检查 API
+
+health:
+  get:
+    tags:
+      - Health
+    summary: 健康检查
+    operationId: healthCheck
+    description: |
+      综合健康检查，包含所有依赖服务状态。
+      
+      返回：
+      - 服务状态（healthy/degraded/unhealthy）
+      - 版本信息
+      - 运行时间
+      - 依赖服务状态
+    responses:
+      '200':
+        description: 服务健康
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/HealthResponse'
+      '503':
+        description: 服务不健康
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/HealthResponse'
+    security: []
+
+ready:
+  get:
+    tags:
+      - Health
+    summary: 就绪检查
+    operationId: readinessCheck
+    description: |
+      Kubernetes readiness probe。
+      检查服务是否准备好接收流量。
+    responses:
+      '200':
+        description: 服务就绪
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                ready:
+                  type: boolean
+                  example: true
+      '503':
+        description: 服务未就绪
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                ready:
+                  type: boolean
+                  example: false
+                reason:
+                  type: string
+    security: []
+
+live:
+  get:
+    tags:
+      - Health
+    summary: 存活检查
+    operationId: livenessCheck
+    description: |
+      Kubernetes liveness probe。
+      检查服务是否存活。
+    responses:
+      '200':
+        description: 服务存活
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                alive:
+                  type: boolean
+                  example: true
+      '503':
+        description: 服务不存活
+    security: []

package/openapi/src/paths/operations.yaml

@@ -18,7 +18,8 @@ killSwitch:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
-  put:
+killSwitchSet:
+  post:
     tags: [Operations]
     operationId: setGlobalKillSwitch
     summary: 设置全局 Kill Switch
@@ -67,7 +68,8 @@ killSwitchPage:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
-  put:
+killSwitchPageSet:
+  post:
     tags: [Operations]
     operationId: setPageKillSwitch
     summary: 设置页面 Kill Switch

package/openapi/src/paths/pages.yaml

@@ -32,6 +32,7 @@ pages:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
+create:
   post:
     tags: [Pages]
     operationId: createPage
@@ -44,7 +45,7 @@ pages:
           schema:
             $ref: '../components/schemas/_index.yaml#/CreatePageRequest'
     responses:
-      '201':
+      '200':
         description: 创建成功
         content:
           application/json:
@@ -79,7 +80,8 @@ pages/{pageId}:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
-  put:
+update:
+  post:
     tags: [Pages]
     operationId: updatePage
     summary: 更新页面信息
@@ -108,16 +110,35 @@ pages/{pageId}:
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
 
-  delete:
+delete:
+  post:
     tags: [Pages]
     operationId: deletePage
     summary: 删除页面
     description: 软删除页面（可恢复）
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    requestBody:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              reason:
+                type: string
+                description: 删除原因
     responses:
-      '204':
+      '200':
         description: 删除成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                message:
+                  type: string
       '401':
         $ref: '../components/responses/_index.yaml#/Unauthorized'
       '404':

package/openapi/src/paths/preview.yaml

@@ -0,0 +1,146 @@
+# Preview 预览 API
+
+preview:
+  post:
+    tags:
+      - Preview
+    summary: 生成预览 Token
+    operationId: createPreviewToken
+    description: |
+      为当前草稿生成预览 Token。
+      
+      特点：
+      - Token 有效期短（默认 30 分钟）
+      - 预览使用 Runtime 渲染（确保"预览即线上"）
+      - 可配置预览设备类型
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    requestBody:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              expiresIn:
+                type: integer
+                minimum: 60
+                maximum: 86400
+                default: 1800
+                description: 过期时间（秒），默认 30 分钟
+              deviceType:
+                type: string
+                enum: [mobile, tablet, desktop]
+                description: 预览设备类型
+              context:
+                type: object
+                additionalProperties: true
+                description: 预览上下文数据
+    responses:
+      '201':
+        description: 创建成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                data:
+                  $ref: '../components/schemas/_index.yaml#/PreviewTokenInfo'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+previewToken:
+  get:
+    tags:
+      - Preview
+    summary: 获取预览 Token 信息
+    operationId: getPreviewToken
+    description: 获取指定预览 Token 的详细信息
+    parameters:
+      - name: token
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 预览 Token
+    responses:
+      '200':
+        description: 成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                data:
+                  $ref: '../components/schemas/_index.yaml#/PreviewTokenInfo'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+previewTokenRevoke:
+  post:
+    tags:
+      - Preview
+    summary: 撤销预览 Token
+    operationId: revokePreviewToken
+    description: 撤销指定的预览 Token
+    parameters:
+      - name: token
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 预览 Token
+    requestBody:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              reason:
+                type: string
+                description: 撤销原因
+    responses:
+      '200':
+        description: 撤销成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                message:
+                  type: string
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+previewList:
+  get:
+    tags:
+      - Preview
+    summary: 获取预览 Token 列表
+    operationId: listPreviewTokens
+    description: 获取指定页面的所有有效预览 Token
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    responses:
+      '200':
+        description: 成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                data:
+                  type: array
+                  items:
+                    $ref: '../components/schemas/_index.yaml#/PreviewTokenInfo'

package/openapi/src/paths/rollout.yaml

@@ -26,8 +26,9 @@ rollout:
                   $ref: '../components/schemas/_index.yaml#/RolloutConfig'
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
-  
-  put:
+
+rolloutUpdate:
+  post:
     tags:
       - Rollout
     summary: 更新页面灰度配置
@@ -60,21 +61,41 @@ rollout:
         $ref: '../components/responses/_index.yaml#/BadRequest'
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
-  
-  delete:
+
+rolloutRemove:
+  post:
     tags:
       - Rollout
-    summary: 删除页面灰度配置（使用默认版本）
-    operationId: deleteRolloutConfig
+    summary: 删除页面灰度配置
+    operationId: removeRolloutConfig
+    description: 删除页面灰度配置（使用默认版本）
     parameters:
       - name: pageId
         in: path
         required: true
         schema:
           type: string
+    requestBody:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              reason:
+                type: string
+                description: 删除原因
     responses:
-      '204':
+      '200':
         description: 删除成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                message:
+                  type: string
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
 
@@ -97,7 +118,7 @@ rolloutStrategies:
           schema:
             $ref: '../components/schemas/_index.yaml#/AddRolloutStrategyRequest'
     responses:
-      '201':
+      '200':
         description: 添加成功
         content:
           application/json:
@@ -109,8 +130,8 @@ rolloutStrategies:
                 data:
                   $ref: '../components/schemas/_index.yaml#/RolloutStrategy'
 
-rolloutStrategyById:
-  put:
+rolloutStrategyUpdate:
+  post:
     tags:
       - Rollout
     summary: 更新灰度策略
@@ -144,12 +165,13 @@ rolloutStrategyById:
                   type: boolean
                 data:
                   $ref: '../components/schemas/_index.yaml#/RolloutStrategy'
-  
-  delete:
+
+rolloutStrategyRemove:
+  post:
     tags:
       - Rollout
     summary: 删除灰度策略
-    operationId: deleteRolloutStrategy
+    operationId: removeRolloutStrategy
     parameters:
       - name: pageId
         in: path
@@ -161,6 +183,24 @@ rolloutStrategyById:
         required: true
         schema:
           type: string
+    requestBody:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              reason:
+                type: string
+                description: 删除原因
     responses:
-      '204':
+      '200':
         description: 删除成功
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                success:
+                  type: boolean
+                message:
+                  type: string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/openapi-admin-client",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "DJV Low-code Platform - Admin API 客户端（自动生成）",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -26,7 +26,7 @@
     "generate": "openapi-generator-cli generate -i openapi/admin-api.yaml -g typescript-fetch -o src/generated --additional-properties=supportsES6=true,typescriptThreePlus=true"
   },
   "dependencies": {
-    "@djvlc/openapi-client-core": "1.2.0"
+    "@djvlc/openapi-client-core": "1.2.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",