whistle.mockbubu 1.0.0-dev.4 → 2.0.0

package/lib/group-manager.js

@@ -0,0 +1,491 @@
+/**
+ * Mock 数据分组管理器
+ * 负责管理多个 Mock 数据组，每个组有独立的 mock 配置
+ */
+class GroupManager {
+  constructor(storage) {
+    this.storage = storage
+    this.GROUPS_KEY = '__groups__'
+    this.DEFAULT_GROUP_ID = 'default'
+    this.DEFAULT_GROUP_NAME = '默认组'
+
+    // 初始化：确保默认组存在
+    this.ensureDefaultGroup()
+  }
+
+  /**
+   * 确保默认组存在
+   */
+  ensureDefaultGroup() {
+    const groupsData = this.getGroupsData()
+    if (!groupsData || !groupsData.groups || groupsData.groups.length === 0) {
+      // 首次使用，创建默认组
+      const defaultGroup = {
+        id: this.DEFAULT_GROUP_ID,
+        name: this.DEFAULT_GROUP_NAME,
+        description: '系统默认分组',
+        createTime: Date.now(),
+        updateTime: Date.now(),
+        isDefault: true,
+      }
+
+      this.storage.setProperty(this.GROUPS_KEY, {
+        groups: [defaultGroup],
+        currentGroupId: this.DEFAULT_GROUP_ID,
+      })
+    }
+  }
+
+  /**
+   * 获取组列表数据（内部方法）
+   */
+  getGroupsData() {
+    return this.storage.getProperty(this.GROUPS_KEY) || {
+      groups: [],
+      currentGroupId: this.DEFAULT_GROUP_ID,
+    }
+  }
+
+  /**
+   * 保存组列表数据（内部方法）
+   */
+  setGroupsData(data) {
+    this.storage.setProperty(this.GROUPS_KEY, data)
+  }
+
+  /**
+   * 获取所有组
+   */
+  getGroups() {
+    const data = this.getGroupsData()
+    return data.groups || []
+  }
+
+  /**
+   * 获取当前组ID
+   */
+  getCurrentGroupId() {
+    const data = this.getGroupsData()
+    return data.currentGroupId || this.DEFAULT_GROUP_ID
+  }
+
+  /**
+   * 获取当前组信息
+   */
+  getCurrentGroup() {
+    const currentId = this.getCurrentGroupId()
+    const groups = this.getGroups()
+    return groups.find(g => g.id === currentId) || groups[0]
+  }
+
+  /**
+   * 设置当前组
+   */
+  setCurrentGroup(groupId) {
+    const groups = this.getGroups()
+    const group = groups.find(g => g.id === groupId)
+
+    if (!group) {
+      throw new Error(`组不存在: ${groupId}`)
+    }
+
+    const data = this.getGroupsData()
+    data.currentGroupId = groupId
+    this.setGroupsData(data)
+
+    return group
+  }
+
+  /**
+   * 生成唯一组ID
+   */
+  generateGroupId() {
+    return 'group_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9)
+  }
+
+  /**
+   * 创建新组
+   * @param {Object} params
+   * @param {string} params.name - 组名
+   * @param {string} params.description - 组描述
+   * @param {string} params.copyFromGroupId - 从哪个组复制（可选）
+   */
+  createGroup({ name, description = '', copyFromGroupId = null }) {
+    if (!name || !name.trim()) {
+      throw new Error('组名不能为空')
+    }
+
+    const groups = this.getGroups()
+
+    // 检查组名是否重复
+    if (groups.some(g => g.name === name)) {
+      throw new Error('组名已存在')
+    }
+
+    // 检查组数量限制（最多10个）
+    if (groups.length >= 10) {
+      throw new Error('组数量已达上限（10个）')
+    }
+
+    const newGroup = {
+      id: this.generateGroupId(),
+      name: name.trim(),
+      description: description.trim(),
+      createTime: Date.now(),
+      updateTime: Date.now(),
+      isDefault: false,
+    }
+
+    // 如果指定了复制源，复制配置
+    if (copyFromGroupId) {
+      this.copyGroupConfigs(copyFromGroupId, newGroup.id)
+    }
+
+    // 保存新组
+    const data = this.getGroupsData()
+    data.groups.push(newGroup)
+    this.setGroupsData(data)
+
+    return newGroup
+  }
+
+  /**
+   * 更新组信息
+   */
+  updateGroup(groupId, { name, description }) {
+    const groups = this.getGroups()
+    const groupIndex = groups.findIndex(g => g.id === groupId)
+
+    if (groupIndex === -1) {
+      throw new Error(`组不存在: ${groupId}`)
+    }
+
+    // 检查新名称是否与其他组重复
+    if (name && groups.some((g, idx) => idx !== groupIndex && g.name === name)) {
+      throw new Error('组名已存在')
+    }
+
+    const group = groups[groupIndex]
+    if (name) group.name = name.trim()
+    if (description !== undefined) group.description = description.trim()
+    group.updateTime = Date.now()
+
+    const data = this.getGroupsData()
+    data.groups[groupIndex] = group
+    this.setGroupsData(data)
+
+    return group
+  }
+
+  /**
+   * 删除组
+   */
+  deleteGroup(groupId) {
+    if (groupId === this.DEFAULT_GROUP_ID) {
+      throw new Error('不能删除默认组')
+    }
+
+    const groups = this.getGroups()
+    const groupIndex = groups.findIndex(g => g.id === groupId)
+
+    if (groupIndex === -1) {
+      throw new Error(`组不存在: ${groupId}`)
+    }
+
+    // 删除组的所有配置
+    this.deleteGroupConfigs(groupId)
+
+    // 从列表中移除
+    groups.splice(groupIndex, 1)
+
+    const data = this.getGroupsData()
+    data.groups = groups
+
+    // 如果删除的是当前组，切换到默认组
+    if (data.currentGroupId === groupId) {
+      data.currentGroupId = this.DEFAULT_GROUP_ID
+    }
+
+    this.setGroupsData(data)
+  }
+
+  /**
+   * 获取组的配置键名
+   */
+  getGroupConfigKey(groupId, filename) {
+    return `group.${groupId}.${filename}`
+  }
+
+  /**
+   * 获取组的文件配置
+   */
+  getGroupFileConfig(groupId, filename) {
+    const key = this.getGroupConfigKey(groupId, filename)
+    const config = this.storage.getProperty(key)
+
+    return config || {
+      mock: false,
+      locked: false,
+      mockVersion: null,
+      mockTime: null,
+    }
+  }
+
+  /**
+   * 设置组的文件配置
+   * 注意:直接使用 storage.setProperty 而不是 setProperty 工具函数
+   * 因为 setProperty 会使用 Object.assign 合并对象,而我们需要完全替换
+   */
+  setGroupFileConfig(groupId, filename, config) {
+    const key = this.getGroupConfigKey(groupId, filename)
+    // 直接设置,不使用 Object.assign 合并
+    this.storage.setProperty(key, config)
+  }
+
+  /**
+   * 复制组配置（从源组到目标组）
+   */
+  copyGroupConfigs(sourceGroupId, targetGroupId) {
+    // 获取所有文件名
+    const fileList = this.storage.getFileList()
+
+    fileList.forEach(item => {
+      const filename = item.name
+      const sourceKey = this.getGroupConfigKey(sourceGroupId, filename)
+      const sourceConfig = this.storage.getProperty(sourceKey)
+
+      if (sourceConfig) {
+        const targetKey = this.getGroupConfigKey(targetGroupId, filename)
+        // 深拷贝配置
+        this.storage.setProperty(targetKey, JSON.parse(JSON.stringify(sourceConfig)))
+      }
+    })
+  }
+
+  /**
+   * 删除组的所有配置
+   */
+  deleteGroupConfigs(groupId) {
+    // 完全隔离架构：删除该组所有文件的配置
+    const fileList = this.storage.getFileList()
+    const prefix = `${groupId}/`
+
+    // 过滤出属于该组的文件
+    const groupFiles = fileList.filter(item => item.name.startsWith(prefix))
+
+    groupFiles.forEach(item => {
+      // 提取纯文件名（移除 groupId/ 前缀）
+      const filename = item.name.replace(prefix, '')
+      const key = this.getGroupConfigKey(groupId, filename)
+      // 检查该属性是否存在，存在则删除
+      if (this.storage.getProperty(key)) {
+        this.storage.removeProperty(key)
+      }
+    })
+  }
+
+  /**
+   * 迁移现有数据到默认组
+   * 将旧版本的配置迁移到默认组
+   */
+  migrateExistingData() {
+    console.log('[mockbubu] 开始数据迁移检查...')
+
+    // 不进行自动迁移！旧数据可能包含超大文件导致内存溢出
+    // 用户如果需要迁移旧数据,应该手动删除 properties 文件中的旧配置
+    console.log('[mockbubu] 跳过自动迁移,避免内存溢出')
+    console.log('[mockbubu] 如需迁移旧数据,请手动删除 properties 中的超大文件')
+  }
+
+  /**
+   * 检查组是否有文件配置
+   */
+  hasGroupConfig(groupId, filename) {
+    const key = this.getGroupConfigKey(groupId, filename)
+    return this.storage.hasProperty(key)
+  }
+
+  /**
+   * 删除组的文件配置（仅删除 Layer 3）
+   * 不删除原始数据和全局元数据
+   * @param {string} groupId - 组ID
+   * @param {string} filename - 文件名
+   */
+  removeGroupFileConfig(groupId, filename) {
+    const key = this.getGroupConfigKey(groupId, filename)
+    this.storage.removeProperty(key)
+  }
+
+  /**
+   * ❌ 废弃：完全隔离架构下不再需要此函数
+   * 原因：每个组有独立的物理文件存储（groupId/filename），删除时直接删除即可
+   *
+   * @deprecated 将在 Phase 2 完成后移除此函数及其所有调用
+   *
+   * 检查文件是否被其他组使用
+   * @param {string} currentGroupId - 当前组ID
+   * @param {string} filename - 文件名
+   * @returns {boolean} - 永远返回 false（完全隔离架构下无需判断）
+   */
+  isFileUsedByOtherGroups(currentGroupId, filename) {
+    // ⚠️ 临时实现：返回 false，因为完全隔离架构下每个组文件独立
+    // 在 Phase 2.4 更新所有调用方后，此函数将被完全移除
+    return false
+  }
+
+  /**
+   * ❌ 废弃：完全隔离架构下不再需要此函数
+   * 原因：每个组有独立的物理文件，无需跨组查询
+   *
+   * @deprecated 将在 Phase 2 完成后移除（仅用于已废弃的批量删除预览接口）
+   *
+   * 获取所有使用该文件的组列表
+   * @param {string} filename - 文件名
+   * @returns {Array<Object>} - 空数组（完全隔离架构下无意义）
+   */
+  getGroupsUsingFile(filename) {
+    // ⚠️ 临时实现：返回空数组
+    // 此函数仅被已废弃的 batchDeletePreview 接口使用
+    return []
+  }
+
+  /**
+   * 获取组的版本列表
+   */
+  getGroupVersions(groupId, filename) {
+    const config = this.getGroupFileConfig(groupId, filename)
+    const list = []
+
+    Object.keys(config).forEach((key) => {
+      const matchs = key.match(/^version\.(.+)/)
+      if (matchs && matchs[1]) {
+        const versionName = matchs[1]
+        const metaKey = `versionMeta.${versionName}`
+        const meta = config[metaKey] || {}
+
+        list.push({
+          filename: versionName,
+          content: config[key],
+          description: meta.description || '',
+          createTime: meta.createTime || 0,
+          updateTime: meta.updateTime || 0,
+        })
+      }
+    })
+
+    // 按修改时间倒序
+    return list.sort((a, b) => b.updateTime - a.updateTime)
+  }
+
+  /**
+   * 添加组的版本
+   */
+  addGroupVersion(groupId, filename, versionName, content, description = '') {
+    const config = this.getGroupFileConfig(groupId, filename)
+
+    // 检查版本数量限制
+    const versions = this.getGroupVersions(groupId, filename)
+    if (versions.length >= 10) {
+      throw new Error('版本数量已达上限(10个)，请删除旧版本后再创建')
+    }
+
+    const versionKey = `version.${versionName}`
+    const metaKey = `versionMeta.${versionName}`
+    const now = Date.now()
+
+    config[versionKey] = content
+    config[metaKey] = {
+      description,
+      createTime: now,
+      updateTime: now,
+    }
+
+    this.setGroupFileConfig(groupId, filename, config)
+  }
+
+  /**
+   * 更新组的版本内容
+   */
+  updateGroupVersionContent(groupId, filename, versionName, content) {
+    const config = this.getGroupFileConfig(groupId, filename)
+    const versionKey = `version.${versionName}`
+    const metaKey = `versionMeta.${versionName}`
+
+    config[versionKey] = content
+    if (config[metaKey]) {
+      config[metaKey].updateTime = Date.now()
+    } else {
+      config[metaKey] = {
+        description: '',
+        createTime: Date.now(),
+        updateTime: Date.now(),
+      }
+    }
+
+    this.setGroupFileConfig(groupId, filename, config)
+  }
+
+  /**
+   * 获取组的版本内容
+   */
+  getGroupVersionContent(groupId, filename, versionName) {
+    const config = this.getGroupFileConfig(groupId, filename)
+    const versionKey = `version.${versionName}`
+    return config[versionKey]
+  }
+
+  /**
+   * 删除组的版本
+   */
+  deleteGroupVersion(groupId, filename, versionName) {
+    const config = this.getGroupFileConfig(groupId, filename)
+    const versionKey = `version.${versionName}`
+    const metaKey = `versionMeta.${versionName}`
+
+    delete config[versionKey]
+    delete config[metaKey]
+
+    this.setGroupFileConfig(groupId, filename, config)
+  }
+
+  /**
+   * 更新组的版本元信息
+   */
+  updateGroupVersionMeta(groupId, filename, versionName, newVersionName, description) {
+    const config = this.getGroupFileConfig(groupId, filename)
+    const oldVersionKey = `version.${versionName}`
+    const oldMetaKey = `versionMeta.${versionName}`
+    const content = config[oldVersionKey]
+    const oldMeta = config[oldMetaKey] || {}
+
+    if (!content) {
+      throw new Error('版本不存在')
+    }
+
+    // 如果版本名变了
+    if (versionName !== newVersionName) {
+      delete config[oldVersionKey]
+      delete config[oldMetaKey]
+
+      const newVersionKey = `version.${newVersionName}`
+      const newMetaKey = `versionMeta.${newVersionName}`
+      config[newVersionKey] = content
+      config[newMetaKey] = {
+        ...oldMeta,
+        description,
+        updateTime: Date.now(),
+      }
+    } else {
+      // 只更新元数据
+      config[oldMetaKey] = {
+        ...oldMeta,
+        description,
+        updateTime: Date.now(),
+      }
+    }
+
+    this.setGroupFileConfig(groupId, filename, config)
+  }
+}
+
+module.exports = GroupManager