@djvlc/openapi-admin-client 1.6.15 → 1.6.16

package/openapi/src/paths/components.yaml

@@ -8,7 +8,7 @@ components:
     description: 获取平台中所有可用的组件
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageParam'
-      - $ref: '../components/parameters/_index.yaml#/LimitParam'
+      - $ref: '../components/parameters/_index.yaml#/PageSizeParam'
       - name: category
         in: query
         schema:
@@ -41,7 +41,7 @@ componentVersions:
     parameters:
       - $ref: '../components/parameters/_index.yaml#/ComponentIdPath'
       - $ref: '../components/parameters/_index.yaml#/PageParam'
-      - $ref: '../components/parameters/_index.yaml#/LimitParam'
+      - $ref: '../components/parameters/_index.yaml#/PageSizeParam'
     responses:
       '200':
         description: 成功

package/openapi/src/paths/drafts.yaml

@@ -30,6 +30,8 @@ save:
     description: 保存页面草稿，支持增量保存
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -62,6 +64,8 @@ discard:
     description: 丢弃当前草稿，恢复到最后发布的版本
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       content:
         application/json:

package/openapi/src/paths/pages.yaml

@@ -8,7 +8,7 @@ pages:
     description: 分页获取所有页面的基本信息
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageParam'
-      - $ref: '../components/parameters/_index.yaml#/LimitParam'
+      - $ref: '../components/parameters/_index.yaml#/PageSizeParam'
       - name: status
         in: query
         schema:
@@ -38,6 +38,9 @@ create:
     operationId: createPage
     summary: 创建新页面
     description: 创建一个新的页面，返回页面 ID
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -88,6 +91,8 @@ update:
     description: 更新页面的元数据（不包括页面内容）
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -118,6 +123,8 @@ delete:
     description: 软删除页面（可恢复）
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       content:
         application/json:
@@ -155,6 +162,9 @@ pages/batch/delete:
     operationId: batchDeletePages
     summary: 批量删除页面
     description: 批量软删除页面（可恢复）
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -222,6 +232,8 @@ pages/{pageId}/schema:
     description: 更新页面的 Schema（编辑器自动保存）
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -259,6 +271,8 @@ pages/{pageId}/publish:
       5. Worker 消费 Outbox，投影写入 Query Tables + CDN
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -295,6 +309,8 @@ pages/{pageId}/rollback:
       3. 写入 Outbox 事件
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     requestBody:
       required: true
       content:
@@ -326,6 +342,8 @@ pages/{pageId}/duplicate:
     description: 复制一个页面，生成新的页面副本
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     responses:
       '200':
         description: 复制成功
@@ -411,6 +429,8 @@ pages/{pageId}/archive:
     description: 将页面归档，归档后页面不可编辑和发布
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     responses:
       '200':
         description: 归档成功
@@ -431,6 +451,8 @@ pages/{pageId}/restore:
     description: 将已归档的页面恢复为正常状态
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
     responses:
       '200':
         description: 恢复成功

package/openapi/src/paths/templates.yaml

@@ -0,0 +1,164 @@
+# 模板管理相关路径
+
+templates:
+  get:
+    tags: [Templates]
+    operationId: listTemplates
+    summary: 获取模板列表
+    description: 分页获取所有模板
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/PageParam'
+      - $ref: '../components/parameters/_index.yaml#/PageSizeParam'
+      - name: search
+        in: query
+        schema:
+          type: string
+        description: 搜索关键词
+      - name: tags
+        in: query
+        schema:
+          type: array
+          items:
+            type: string
+        description: 按标签筛选
+    responses:
+      '200':
+        description: 成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/TemplateListResponse'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '500':
+        $ref: '../components/responses/_index.yaml#/InternalError'
+
+create:
+  post:
+    tags: [Templates]
+    operationId: createTemplate
+    summary: 创建模板
+    description: 创建一个新的模板
+    parameters:
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../components/schemas/_index.yaml#/CreateTemplateRequest'
+    responses:
+      '200':
+        description: 创建成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/TemplateResponse'
+      '400':
+        $ref: '../components/responses/_index.yaml#/BadRequest'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '500':
+        $ref: '../components/responses/_index.yaml#/InternalError'
+
+templates/{templateId}:
+  get:
+    tags: [Templates]
+    operationId: getTemplate
+    summary: 获取模板详情
+    description: 获取指定模板的详细信息
+    parameters:
+      - name: templateId
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 模板 ID
+    responses:
+      '200':
+        description: 成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/TemplateResponse'
+      '401':
+        $ref: '../components/responses/_index.yaml#/Unauthorized'
+      '404':
+        $ref: '../components/responses/_index.yaml#/NotFound'
+      '500':
+        $ref: '../components/responses/_index.yaml#/InternalError'
+
+update:
+  post:
+    tags: [Templates]
+    operationId: updateTemplate
+    summary: 更新模板
+    description: 更新模板信息
+    parameters:
+      - name: templateId
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 模板 ID
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../components/schemas/_index.yaml#/UpdateTemplateRequest'
+    responses:
+      '200':
+        description: 更新成功
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas/_index.yaml#/TemplateResponse'
+      '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'
+
+delete:
+  post:
+    tags: [Templates]
+    operationId: deleteTemplate
+    summary: 删除模板
+    description: 删除指定模板
+    parameters:
+      - name: templateId
+        in: path
+        required: true
+        schema:
+          type: string
+        description: 模板 ID
+      - $ref: '../components/parameters/_index.yaml#/IdempotencyKeyHeader'
+      - $ref: '../components/parameters/_index.yaml#/XTraceIdHeader'
+    responses:
+      '200':
+        description: 删除成功
+        content:
+          application/json:
+            schema:
+              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'

package/openapi/src/paths/versions.yaml

@@ -9,7 +9,7 @@ versions:
     parameters:
       - $ref: '../components/parameters/_index.yaml#/PageIdPath'
       - $ref: '../components/parameters/_index.yaml#/PageParam'
-      - $ref: '../components/parameters/_index.yaml#/LimitParam'
+      - $ref: '../components/parameters/_index.yaml#/PageSizeParam'
     responses:
       '200':
         description: 成功
@@ -46,65 +46,3 @@ versions/{versionId}:
         $ref: '../components/responses/_index.yaml#/NotFound'
       '500':
         $ref: '../components/responses/_index.yaml#/InternalError'
-
-publish:
-  post:
-    tags: [Versions]
-    operationId: publishVersion
-    summary: 发布版本
-    description: 将当前草稿发布为新版本
-    parameters:
-      - $ref: '../components/parameters/_index.yaml#/PageIdPath'
-    requestBody:
-      required: true
-      content:
-        application/json:
-          schema:
-            $ref: '../components/schemas/_index.yaml#/PublishRequest'
-    responses:
-      '201':
-        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'
-      '409':
-        $ref: '../components/responses/_index.yaml#/Conflict'
-      '500':
-        $ref: '../components/responses/_index.yaml#/InternalError'
-
-rollback:
-  post:
-    tags: [Versions]
-    operationId: rollbackVersion
-    summary: 回滚版本
-    description: 回滚到指定的历史版本
-    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'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/openapi-admin-client",
-  "version": "1.6.15",
+  "version": "1.6.16",
   "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.11"
+    "@djvlc/openapi-client-core": "1.2.12"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",