@djvlc/openapi-user-client 1.7.8 → 1.7.10

package/openapi/src/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: DJVLC User API
-  version: 2.0.0
+  version: 1.0.0
   description: |
     DJVLC 低代码平台用户端 API（数据面）
     
@@ -46,10 +46,8 @@ tags:
     description: 健康检查
 
 paths:
-  # 页面解析
-  /pages/{pageId}:
-    $ref: './paths/pages.yaml#/page'
-  /pages/{pageId}/resolve:
+  # 页面解析（根据设计总纲 V2）
+  /page/resolve:
     $ref: './paths/pages.yaml#/resolve'
   
   # Action Gateway（统一入口）

package/openapi/src/paths/pages.yaml

@@ -1,64 +1,69 @@
-# 页面获取相关路径
+# 页面解析相关路径（根据设计总纲 V2）
 
-page:
+resolve:
   get:
     tags: [Pages]
-    operationId: getPage
-    summary: 获取页面
-    description: 获取指定页面的基本信息和元数据
+    operationId: resolvePage
+    summary: 解析页面（Runtime 核心接口）
+    description: |
+      Runtime 的核心接口，返回渲染所需的完整数据。
+      
+      支持两种模式：
+      1. 稳定入口（推荐）：支持灰度/回滚/ops，返回 resolvedVersionId 和 CDN 地址
+      2. 保底模式：当 includeSnapshot=1 时，返回完整 snapshot（CDN 失败时使用）
+      
+      响应包含：
+      - resolvedVersionId: 解析后的页面版本 ID（考虑灰度/回滚）
+      - cdnBase: CDN 基础地址
+      - snapshotUrl: snapshot.json 的完整 URL
+      - manifestUrl: manifest.json 的完整 URL
+      - ops: 运维配置（killSwitch、blockedComponents、flags）
+      - etag: 内容哈希（用于缓存）
+      - cacheTtlSeconds: 缓存 TTL（建议 10~30 秒）
+      - snapshot: 完整快照（仅当 includeSnapshot=1 时返回）
     parameters:
       - name: pageId
-        in: path
+        in: query
         required: true
         schema:
           type: string
         description: 页面 ID
-      - name: version
+      - name: env
         in: query
+        required: false
         schema:
           type: string
-        description: 指定版本号（可选，默认最新版本）
-    responses:
-      '200':
-        description: 成功
-        content:
-          application/json:
-            schema:
-              $ref: '../components/schemas/_index.yaml#/PageResponse'
-      '404':
-        $ref: '../components/responses/_index.yaml#/NotFound'
-      '503':
-        $ref: '../components/responses/_index.yaml#/ServiceUnavailable'
-
-resolve:
-  post:
-    tags: [Pages]
-    operationId: resolvePage
-    summary: 解析页面
-    description: |
-      解析页面 Schema，返回完整的渲染数据。
-      
-      包括：
-      - 解析后的页面 Schema
-      - 组件资源清单
-      - 预取的数据查询结果
-      - 动作资源清单
-    parameters:
-      - name: pageId
-        in: path
-        required: true
+          enum: [prod, preview, staging]
+          default: prod
+        description: 环境（prod/preview/staging）
+      - name: uid
+        in: query
+        required: false
         schema:
           type: string
-        description: 页面 ID
-    requestBody:
-      required: true
-      content:
-        application/json:
-          schema:
-            $ref: '../components/schemas/_index.yaml#/ResolvePageRequest'
+        description: 用户 ID（用于灰度路由）
+      - name: deviceId
+        in: query
+        required: false
+        schema:
+          type: string
+        description: 设备 ID
+      - name: channel
+        in: query
+        required: false
+        schema:
+          type: string
+        description: 渠道标识
+      - name: includeSnapshot
+        in: query
+        required: false
+        schema:
+          type: boolean
+          default: false
+        description: 是否包含完整 snapshot（CDN 失败保底时使用）
     responses:
       '200':
-        description: 成功
+        description: 解析成功
         content:
           application/json:
             schema:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/openapi-user-client",
-  "version": "1.7.8",
+  "version": "1.7.10",
   "description": "DJV Low-code Platform - User API 客户端（自动生成）",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -25,7 +25,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@djvlc/openapi-client-core": "1.2.7"
+    "@djvlc/openapi-client-core": "1.2.9"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",