whistle.mockbubu 2.0.0 → 2.1.0

package/lib/uiServer/utils/router-helpers.js

@@ -0,0 +1,100 @@
+/**
+ * 文件名: router-helpers.js
+ * 功能: 路由公共辅助函数（减少子路由中的重复逻辑）
+ * 依赖: logger.js, util.js
+ */
+
+const { createLogger } = require('../../utils/logger')
+const { createErrorResponse } = require('./util')
+
+const logger = createLogger()
+
+/**
+ * 获取当前组的V3 Storage和索引
+ *
+ * @param {Object} ctx - Koa上下文
+ * @returns {Promise<{currentGroupId: string, v3Storage: Object, fileIndexData: Object}>}
+ */
+async function getCurrentGroupContext(ctx) {
+  const { groupManager, storageAdapter } = ctx
+  const currentGroupId = await groupManager.getCurrentGroupId()
+  const v3Storage = storageAdapter.v3Storage
+  const fileIndexData = await v3Storage.getIndex(currentGroupId)
+
+  return { currentGroupId, v3Storage, fileIndexData }
+}
+
+/**
+ * 通过URL查找文件条目
+ *
+ * @param {Object} fileIndexData - 文件索引数据对象（包含files数组）
+ * @param {string} url - 文件URL
+ * @returns {Object} 文件条目
+ * @throws {Error} 文件不存在
+ */
+function findFileByUrl(fileIndexData, url) {
+  const fileEntry = fileIndexData.files.find(f => f.url === url)
+  if (!fileEntry) {
+    throw new Error('文件不存在')
+  }
+  return fileEntry
+}
+
+/**
+ * 获取文件ID（通过URL查找）
+ *
+ * @param {Object} ctx - Koa上下文
+ * @param {string} url - 文件URL
+ * @returns {Promise<{fileId: string, currentGroupId: string, v3Storage: Object}>}
+ */
+async function getFileIdByUrl(ctx, url) {
+  const { currentGroupId, v3Storage, fileIndexData } = await getCurrentGroupContext(ctx)
+  const fileEntry = findFileByUrl(fileIndexData, url)
+
+  return {
+    fileId: fileEntry.id,
+    currentGroupId,
+    v3Storage,
+  }
+}
+
+/**
+ * 路由处理器包装器（统一错误处理）
+ *
+ * @param {Function} handler - 异步路由处理函数
+ * @param {string} operation - 操作名称（用于日志）
+ * @returns {Function} 包装后的处理器
+ */
+function wrapRouteHandler(handler, operation = '操作') {
+  return async (ctx) => {
+    try {
+      await handler(ctx)
+    } catch (error) {
+      logger.error(`${operation}失败:`, error.message)
+      ctx.body = createErrorResponse(error.message)
+    }
+  }
+}
+
+/**
+ * 验证必需参数
+ *
+ * @param {Object} params - 参数对象
+ * @param {string[]} requiredFields - 必需字段名称数组
+ * @throws {Error} 缺少必需参数
+ */
+function validateRequiredParams(params, requiredFields) {
+  for (const field of requiredFields) {
+    if (!params[field]) {
+      throw new Error(`缺少必需参数: ${field}`)
+    }
+  }
+}
+
+module.exports = {
+  getCurrentGroupContext,
+  findFileByUrl,
+  getFileIdByUrl,
+  wrapRouteHandler,
+  validateRequiredParams,
+}

package/lib/uiServer/utils/util.js

@@ -0,0 +1,172 @@
+const {
+  getGroupFileList,
+} = require('../../utils/utils')
+const { RangeFilterMap, RuleFilterMap, LockedFilterMap } = require('../../config/const')
+
+// 统一错误响应格式
+const createErrorResponse = (message, code = 500) => ({
+  code,
+  msg: message || '操作失败',
+})
+
+// 统一成功响应格式
+const createSuccessResponse = (data = null, message = '操作成功') => ({
+  code: 200,
+  msg: message,
+  ...(data !== null && data !== undefined && { data }),
+})
+
+// 执行筛选
+const execFilter = (result, filter) => {
+  const { key, value, method } = filter
+  const list = result.filter((item) => {
+    const type = Object.prototype.toString.call(value)
+
+    switch (method) {
+    case 'indexOf':
+      if (type === '[object String]') {
+        return ~item[key].indexOf(value)
+      }
+      break
+    case 'equal':
+      return item[key] === value
+    case 'unequal':
+      return item[key] !== value
+    case 'range':
+      // 范围筛选，value 是 [min, max] 数组
+      if (Array.isArray(value) && value.length === 2) {
+        const itemValue = item[key]
+        return itemValue >= value[0] && itemValue <= value[1]
+      }
+      break
+    }
+
+    return true
+  })
+
+  return list
+}
+
+// 处理筛选条件
+const handleFilterList = (list, filterOptions) => {
+  if (!Array.isArray(list) || !filterOptions) return []
+
+  const filters = []
+  const { name, rule, range, ruleValue, locked } = filterOptions
+  if (name) {
+    filters.push({
+      key: 'name',
+      value: name.trim(),
+      method: 'indexOf',
+    })
+  }
+
+  if (rule) {
+    filters.push({
+      key: 'rule',
+      value: rule.trim(),
+      method: 'equal',
+    })
+  }
+
+  // 范围筛选
+  RangeFilterMap[range] && filters.push(RangeFilterMap[range])
+  // 规则值筛选
+  RuleFilterMap[ruleValue] && filters.push(RuleFilterMap[ruleValue])
+  // 锁定筛选
+  LockedFilterMap[locked] && filters.push(LockedFilterMap[locked])
+
+  // 执行筛选
+  const filteredList = filters.reduce((result, filter) => {
+    return execFilter(result, filter)
+  }, list)
+
+  return filteredList
+}
+
+/**
+ * 过滤文件配置,只保留文件级别的字段
+ * 移除全局元数据字段 (query, payload, method, rule, status, pattern, ruleValue, url, date)
+ * 移除版本字段 (version.*, versionMeta.*) - 版本通过单独的 versions 数组导出
+ */
+const filterFileConfig = (fileConfig) => {
+  if (!fileConfig) return {}
+  // 保留基础配置 + 元数据字段
+  // 元数据字段（url, method, date, status等）对于文件列表显示是必需的
+  const validKeys = ['mock', 'locked', 'mockVersion', 'mockTime', 'url', 'method', 'date', 'status', 'rule', 'ruleValue']
+  const filtered = {}
+
+  Object.keys(fileConfig).forEach(key => {
+    // 仅保留基础配置字段和元数据字段
+    if (validKeys.includes(key)) {
+      filtered[key] = fileConfig[key]
+    }
+    // 版本字段通过 versions 数组单独导出，不在 fileConfig 中保留
+  })
+
+  return filtered
+}
+
+// 获取文件列表（包含完整 session 数据）
+// 完全隔离架构：直接获取当前组的文件列表
+const getFullDataList = async (storageAdapter, groupManager, groupId) => {
+  // 获取组的物理文件列表并合并配置
+  const list = await getGroupFileList(storageAdapter, groupId) || []
+  const result = []
+  const v3Storage = storageAdapter.getV3Storage()
+
+  // ⚠️ 强制刷新索引缓存（只刷新一次）
+  v3Storage.invalidateIndex(groupId)
+
+  // 获取索引以查找真实的 fileId（只读取一次）
+  const fileIndexData = await v3Storage.getIndex(groupId)
+
+  // ✅ 读取完整数据（包含 session）,支持 Payload/Headers 视图
+  for (let idx = 0; idx < list.length; idx++) {
+    const item = list[idx]
+
+    // 从索引查找对应的文件条目
+    const indexEntry = fileIndexData.files.find(f => f.url === item.name)
+
+    if (indexEntry) {
+      const fileId = indexEntry.id
+
+      // 读取 file.json (包含 session 数据和配置)
+      const fileData = await v3Storage.getFile(groupId, fileId)
+
+      // 返回完整数据（包含 config 配置字段 + session 数据）
+      result.push({
+        name: item.name,
+        id: fileId,
+        url: indexEntry.url,
+        method: indexEntry.method,
+        status: indexEntry.status,
+        // ✅ 从 fileData.config 读取配置（而非 indexEntry）
+        mock: fileData.config?.mock || false,
+        locked: fileData.config?.locked || false,
+        mockVersion: fileData.config?.mockVersion || null,
+        mockTime: fileData.config?.mockTime || null,
+        date: indexEntry.createTime,
+        rule: indexEntry.rule || '',
+        ruleValue: indexEntry.ruleValue || 'pathname',
+        pattern: indexEntry.pattern || '',
+        domain: indexEntry.domain || null,
+        pathname: indexEntry.pathname || null,
+        urlHash: indexEntry.urlHash || null,
+        // ✅ 添加 captureTime 字段（与 api-list 保持一致）
+        captureTime: indexEntry.createTime,
+        // ✅ 直接从 file.json 读取 session 数据
+        session: fileData.session || null,
+      })
+    }
+  }
+
+  return result
+}
+
+exports.createErrorResponse = createErrorResponse
+exports.createSuccessResponse = createSuccessResponse
+exports.execFilter = execFilter
+exports.handleFilterList = handleFilterList
+exports.filterFileConfig = filterFileConfig
+exports.getFullDataList = getFullDataList

package/lib/uiServer/{validator.js → utils/validator.js}

@@ -57,11 +57,16 @@ const validateBoolean = (value, fieldName) => {
   return null
 }
 
-// 验证 ruleValue
-const validateRuleValue = (ruleValue) => {
-  const validValues = ['pathname', 'href', 'pattern']
-  if (!ruleValue || !validValues.includes(ruleValue)) {
-    return `ruleValue 必须是 ${validValues.join(', ')} 之一`
+// 验证数组
+const validateArray = (value, fieldName = 'urls') => {
+  if (!Array.isArray(value)) {
+    return `${fieldName} 必须是数组`
+  }
+  if (value.length === 0) {
+    return `${fieldName} 不能为空数组`
+  }
+  if (value.length > 1000) {
+    return `${fieldName} 长度不能超过 1000`
   }
   return null
 }
@@ -100,6 +105,6 @@ module.exports = {
   validateVersionName,
   validateMockData,
   validateBoolean,
-  validateRuleValue,
+  validateArray,
   validate,
 }