@djvlc/openapi-admin-client 1.6.10 → 1.6.11

package/openapi/src/openapi.yaml

@@ -75,12 +75,24 @@ paths:
     $ref: './paths/pages.yaml#/update'
   /pages/{pageId}/delete:
     $ref: './paths/pages.yaml#/delete'
+  /pages/{pageId}/duplicate:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1duplicate'
+  /pages/{pageId}/preview:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1preview'
+  /pages/{pageId}/stats:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1stats'
+  /pages/{pageId}/archive:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1archive'
+  /pages/{pageId}/restore:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1restore'
+  /pages/batch/delete:
+    $ref: './paths/pages.yaml#/pages~1batch~1delete'
   
   # 草稿管理
   /pages/{pageId}/draft:
-    $ref: './paths/drafts.yaml#/draft'
-  /pages/{pageId}/draft/save:
-    $ref: './paths/drafts.yaml#/save'
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1draft'
+  /pages/{pageId}/schema:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1schema'
   /pages/{pageId}/draft/discard:
     $ref: './paths/drafts.yaml#/discard'
   
@@ -89,14 +101,14 @@ paths:
     $ref: './paths/versions.yaml#/versions'
   /pages/{pageId}/versions/{versionId}:
     $ref: './paths/versions.yaml#/versions~1{versionId}'
+  /pages/{pageId}/versions/{versionId1}/compare/{versionId2}:
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1versions~1{versionId1}~1compare~1{versionId2}'
   /pages/{pageId}/publish:
-    $ref: './paths/versions.yaml#/publish'
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1publish'
   /pages/{pageId}/rollback:
-    $ref: './paths/versions.yaml#/rollback'
+    $ref: './paths/pages.yaml#/pages~1{pageId}~1rollback'
   
   # 预览管理
-  /pages/{pageId}/preview:
-    $ref: './paths/preview.yaml#/preview'
   /pages/{pageId}/preview/tokens:
     $ref: './paths/preview.yaml#/previewList'
   /preview/tokens/{token}:

package/openapi/src/paths/pages.yaml

@@ -133,15 +133,356 @@ delete:
         content:
           application/json:
             schema:
-              type: object
-              properties:
-                success:
-                  type: boolean
-                message:
+              allOf:
+                - $ref: '../components/schemas/_index.yaml#/SuccessResponse'
+                - type: object
+                  properties:
+                    data:
+                      type: object
+                      properties:
+                        success:
+                          type: boolean
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+      '500':
+        $ref: '../components/responses/_index.yaml#/InternalError'
+
+pages/batch/delete:
+  post:
+    tags: [Pages]
+    operationId: batchDeletePages
+    summary: 批量删除页面
+    description: 批量软删除页面（可恢复）
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            type: object
+            required: [uids]
+            properties:
+              uids:
+                type: array
+                items:
                   type: string
+                minItems: 1
+                maxItems: 100
+                description: 页面 UID 列表（最多 100 个）
+    responses:
+      '200':
+        description: 批量删除成功
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '../components/schemas/_index.yaml#/SuccessResponse'
+                - type: object
+                  properties:
+                    data:
+                      type: object
+                      properties:
+                        deletedCount:
+                          type: integer
+                          description: 成功删除的数量
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '500':
+        $ref: '../components/responses/_index.yaml#/InternalError'
+
+# 草稿管理
+pages/{pageId}/draft:
+  get:
+    tags: [Drafts]
+    operationId: getDraft
+    summary: 获取页面草稿
+    description: 获取页面的当前草稿（包含完整 Schema）
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    responses:
+      '200':
+        description: 成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/DraftResponse'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+pages/{pageId}/schema:
+  post:
+    tags: [Drafts]
+    operationId: saveDraft
+    summary: 保存页面草稿
+    description: 更新页面的 Schema（编辑器自动保存）
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../components/schemas/_index.yaml#/SaveDraftRequest'
+    responses:
+      '200':
+        description: 保存成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/DraftResponse'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+# 发布管理
+pages/{pageId}/publish:
+  post:
+    tags: [Versions]
+    operationId: publishPage
+    summary: 发布页面
+    description: |
+      发布页面到指定环境，使用 Transactional Outbox 模式。
+      
+      发布流程（根据设计总纲 V2）：
+      1. 读取草稿
+      2. 发布期校验（Schema 校验、表达式 lint、组件 compat 校验、Definitions 绑定校验）
+      3. 生成 pageVersionId（不可变）
+      4. 写入 Command Tables（page_versions, manifests）+ Outbox
+      5. Worker 消费 Outbox，投影写入 Query Tables + CDN
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../components/schemas/_index.yaml#/PublishRequest'
+    responses:
+      '200':
+        description: 发布成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/PublishResponse'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
       '401':
         $ref: '../components/responses/_index.yaml#/Unauthorized'
       '404':
         $ref: '../components/responses/_index.yaml#/NotFound'
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
+
+pages/{pageId}/rollback:
+  post:
+    tags: [Versions]
+    operationId: rollbackPage
+    summary: 回滚到指定版本
+    description: |
+      将页面回滚到指定的历史版本（秒级生效）。
+      
+      回滚流程：
+      1. 验证目标版本存在
+      2. 更新 page_pointers 指向目标版本（秒级生效）
+      3. 写入 Outbox 事件
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../components/schemas/_index.yaml#/RollbackRequest'
+    responses:
+      '200':
+        description: 回滚成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/PublishResponse'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+      '500':
+        $ref: '../components/responses/_index.yaml#/InternalError'
+
+# 其他功能
+pages/{pageId}/duplicate:
+  post:
+    tags: [Pages]
+    operationId: duplicatePage
+    summary: 复制页面
+    description: 复制一个页面，生成新的页面副本
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    responses:
+      '200':
+        description: 复制成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/PageResponse'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+pages/{pageId}/preview:
+  get:
+    tags: [Preview]
+    operationId: getPreview
+    summary: 预览页面
+    description: 获取页面预览数据
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - name: device
+        in: query
+        schema:
+          type: string
+          enum: [h5, tablet, pc, responsive]
+        description: 预览设备类型
+    responses:
+      '200':
+        description: 获取成功
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '../components/schemas/_index.yaml#/SuccessResponse'
+                - type: object
+                  properties:
+                    data:
+                      type: object
+                      description: 预览数据
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+pages/{pageId}/stats:
+  get:
+    tags: [Pages]
+    operationId: getPageStats
+    summary: 获取页面统计信息
+    description: 获取页面的访问次数、版本数量等统计数据
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    responses:
+      '200':
+        description: 获取成功
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '../components/schemas/_index.yaml#/SuccessResponse'
+                - type: object
+                  properties:
+                    data:
+                      type: object
+                      properties:
+                        viewCount:
+                          type: integer
+                        versionCount:
+                          type: integer
+                        lastPublishedAt:
+                          type: string
+                          format: date-time
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+pages/{pageId}/archive:
+  post:
+    tags: [Pages]
+    operationId: archivePage
+    summary: 归档页面
+    description: 将页面归档，归档后页面不可编辑和发布
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    responses:
+      '200':
+        description: 归档成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/PageResponse'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+pages/{pageId}/restore:
+  post:
+    tags: [Pages]
+    operationId: restorePage
+    summary: 恢复归档页面
+    description: 将已归档的页面恢复为正常状态
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+    responses:
+      '200':
+        description: 恢复成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/PageResponse'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+
+pages/{pageId}/versions/{versionId1}/compare/{versionId2}:
+  get:
+    tags: [Versions]
+    operationId: compareVersions
+    summary: 比较两个版本
+    description: 获取两个版本的 Schema 用于对比
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - name: versionId1
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 版本1 ID
+      - name: versionId2
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 版本2 ID
+    responses:
+      '200':
+        description: 查询成功
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '../components/schemas/_index.yaml#/SuccessResponse'
+                - type: object
+                  properties:
+                    data:
+                      type: object
+                      properties:
+                        version1:
+                          type: object
+                        version2:
+                          type: object
+                        diff:
+                          type: object
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/openapi-admin-client",
-  "version": "1.6.10",
+  "version": "1.6.11",
   "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.8"
+    "@djvlc/openapi-client-core": "1.2.9"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",