@idooel/components 0.0.2-beta.3 → 0.0.2-beta.31

package/packages/utils/runtime-context/dataPoolAPI.js

@@ -0,0 +1,501 @@
+/**
+ * 统一的数据池 API 接口
+ * 提供简洁易用的数据操作接口，封装全局数据池的复杂性
+ */
+
+
+/**
+ * 数据池 API 类
+ */
+export class DataPoolAPI {
+  constructor() {
+    this.dataPool = window.__idooel_data_pool__
+    if (!this.dataPool) {
+      throw new Error('Global data pool not initialized. Please ensure runtime-context/index.js is imported before using this API.')
+    }
+  }
+
+  // ==================== 模型实例管理 ====================
+
+  /**
+   * 创建树形表格模型实例
+   * @param {string} instanceId 实例ID（可选，不提供则自动生成）
+   * @param {object} options 初始化选项
+   * @returns {object} 模型方法实例
+   */
+  createTreeTableModel(instanceId, options = {}) {
+    const id = instanceId || this.dataPool.utils.generateId('treeTableModel')
+    return this.dataPool.factory.createModel('tree-table', id, options)
+  }
+
+  /**
+   * 获取模型实例
+   * @param {string} instanceId 实例ID
+   * @returns {object|null} 模型方法实例
+   */
+  getModel(instanceId) {
+    return this.dataPool.manager.getModel(instanceId)
+  }
+
+  /**
+   * 获取所有指定类型的模型
+   * @param {string} modelType 模型类型
+   * @returns {object} 模型实例集合
+   */
+  getAllModels(modelType = null) {
+    return this.dataPool.manager.getAllModels(modelType)
+  }
+
+  /**
+   * 销毁模型实例
+   * @param {string} instanceId 实例ID
+   */
+  destroyModel(instanceId) {
+    this.dataPool.manager.unregisterModel(instanceId)
+  }
+
+  // ==================== 数据操作 ====================
+
+  /**
+   * 设置模型数据
+   * @param {string} instanceId 实例ID
+   * @param {string} key 数据键
+   * @param {any} value 数据值
+   */
+  setModelData(instanceId, key, value) {
+    this.dataPool.manager.setData(instanceId, key, value)
+    return this
+  }
+
+  /**
+   * 获取模型数据
+   * @param {string} instanceId 实例ID
+   * @param {string} key 数据键
+   * @param {any} defaultValue 默认值
+   * @returns {any} 数据值
+   */
+  getModelData(instanceId, key, defaultValue = null) {
+    return this.dataPool.manager.getData(instanceId, key, defaultValue)
+  }
+
+  /**
+   * 批量设置模型数据
+   * @param {string} instanceId 实例ID
+   * @param {object} data 数据对象
+   */
+  setBatchModelData(instanceId, data) {
+    Object.entries(data).forEach(([key, value]) => {
+      this.setModelData(instanceId, key, value)
+    })
+    return this
+  }
+
+  /**
+   * 获取模型的所有数据
+   * @param {string} instanceId 实例ID
+   * @returns {object} 模型数据
+   */
+  getAllModelData(instanceId) {
+    const model = this.dataPool.manager.getModel(instanceId)
+    if (!model) {
+      return {}
+    }
+
+    const exported = model.export() || {}
+    return exported.data || {}
+  }
+
+  // ==================== 共享数据操作 ====================
+
+  /**
+   * 设置用户信息
+   * @param {object} userInfo 用户信息
+   */
+  setUserInfo(userInfo) {
+    this.dataPool.manager.setSharedData(
+      SHARED_NAMESPACES.USER,
+      SHARED_KEYS.USER_INFO,
+      userInfo,
+      ACCESS_LEVELS.PROTECTED
+    )
+    return this
+  }
+
+  /**
+   * 获取用户信息
+   * @returns {object} 用户信息
+   */
+  getUserInfo() {
+    return this.dataPool.manager.getSharedData(
+      SHARED_NAMESPACES.USER,
+      SHARED_KEYS.USER_INFO,
+      {},
+      ACCESS_LEVELS.PROTECTED
+    )
+  }
+
+  /**
+   * 设置用户权限
+   * @param {array} permissions 权限列表
+   */
+  setUserPermissions(permissions) {
+    this.dataPool.manager.setSharedData(
+      SHARED_NAMESPACES.USER,
+      SHARED_KEYS.USER_PERMISSIONS,
+      permissions,
+      ACCESS_LEVELS.PROTECTED
+    )
+    return this
+  }
+
+  /**
+   * 获取用户权限
+   * @returns {array} 权限列表
+   */
+  getUserPermissions() {
+    return this.dataPool.manager.getSharedData(
+      SHARED_NAMESPACES.USER,
+      SHARED_KEYS.USER_PERMISSIONS,
+      [],
+      ACCESS_LEVELS.PROTECTED
+    )
+  }
+
+  /**
+   * 设置系统配置
+   * @param {object} config 系统配置
+   */
+  setSystemConfig(config) {
+    this.dataPool.manager.setSharedData(
+      SHARED_NAMESPACES.SYSTEM,
+      SHARED_KEYS.SYSTEM_CONFIG,
+      config,
+      ACCESS_LEVELS.PROTECTED
+    )
+    return this
+  }
+
+  /**
+   * 获取系统配置
+   * @returns {object} 系统配置
+   */
+  getSystemConfig() {
+    return this.dataPool.manager.getSharedData(
+      SHARED_NAMESPACES.SYSTEM,
+      SHARED_KEYS.SYSTEM_CONFIG,
+      {},
+      ACCESS_LEVELS.PROTECTED
+    )
+  }
+
+  /**
+   * 设置系统主题
+   * @param {object} theme 主题配置
+   */
+  setSystemTheme(theme) {
+    this.dataPool.manager.setSharedData(
+      SHARED_NAMESPACES.SYSTEM,
+      SHARED_KEYS.SYSTEM_THEME,
+      theme,
+      ACCESS_LEVELS.PUBLIC
+    )
+    return this
+  }
+
+  /**
+   * 获取系统主题
+   * @returns {object} 主题配置
+   */
+  getSystemTheme() {
+    return this.dataPool.manager.getSharedData(
+      SHARED_NAMESPACES.SYSTEM,
+      SHARED_KEYS.SYSTEM_THEME,
+      {},
+      ACCESS_LEVELS.PUBLIC
+    )
+  }
+
+  /**
+   * 设置模态框父级数据
+   * @param {object} parentData 父级数据
+   */
+  setModalParentData(parentData) {
+    this.dataPool.manager.setSharedData(
+      SHARED_NAMESPACES.MODAL,
+      SHARED_KEYS.MODAL_PARENT_DATA,
+      parentData,
+      ACCESS_LEVELS.PRIVATE
+    )
+    return this
+  }
+
+  /**
+   * 获取模态框父级数据
+   * @returns {object} 父级数据
+   */
+  getModalParentData() {
+    return this.dataPool.manager.getSharedData(
+      SHARED_NAMESPACES.MODAL,
+      SHARED_KEYS.MODAL_PARENT_DATA,
+      null,
+      ACCESS_LEVELS.PRIVATE
+    )
+  }
+
+  /**
+   * 设置业务字典
+   * @param {object} dictionaries 业务字典
+   */
+  setBusinessDictionaries(dictionaries) {
+    this.dataPool.manager.setSharedData(
+      SHARED_NAMESPACES.BUSINESS,
+      SHARED_KEYS.BUSINESS_DICTIONARIES,
+      dictionaries,
+      ACCESS_LEVELS.PUBLIC
+    )
+    return this
+  }
+
+  /**
+   * 获取业务字典
+   * @returns {object} 业务字典
+   */
+  getBusinessDictionaries() {
+    return this.dataPool.manager.getSharedData(
+      SHARED_NAMESPACES.BUSINESS,
+      SHARED_KEYS.BUSINESS_DICTIONARIES,
+      {},
+      ACCESS_LEVELS.PUBLIC
+    )
+  }
+
+  // ==================== 订阅系统 ====================
+
+  /**
+   * 订阅模型数据变化
+   * @param {string} instanceId 实例ID
+   * @param {string} key 数据键
+   * @param {function} callback 回调函数
+   * @returns {function} 取消订阅函数
+   */
+  subscribeModelData(instanceId, key, callback) {
+    return this.dataPool.manager.subscribe({
+      instanceId,
+      key
+    }, callback)
+  }
+
+  /**
+   * 订阅用户信息变化
+   * @param {function} callback 回调函数
+   * @returns {function} 取消订阅函数
+   */
+  subscribeUserInfo(callback) {
+    return this.dataPool.manager.subscribe({
+      namespace: SHARED_NAMESPACES.USER,
+      key: SHARED_KEYS.USER_INFO
+    }, callback)
+  }
+
+  /**
+   * 订阅系统配置变化
+   * @param {function} callback 回调函数
+   * @returns {function} 取消订阅函数
+   */
+  subscribeSystemConfig(callback) {
+    return this.dataPool.manager.subscribe({
+      namespace: SHARED_NAMESPACES.SYSTEM,
+      key: SHARED_KEYS.SYSTEM_CONFIG
+    }, callback)
+  }
+
+  /**
+   * 订阅系统主题变化
+   * @param {function} callback 回调函数
+   * @returns {function} 取消订阅函数
+   */
+  subscribeSystemTheme(callback) {
+    return this.dataPool.manager.subscribe({
+      namespace: SHARED_NAMESPACES.SYSTEM,
+      key: SHARED_KEYS.SYSTEM_THEME
+    }, callback)
+  }
+
+  /**
+   * 订阅模态框父级数据变化
+   * @param {function} callback 回调函数
+   * @returns {function} 取消订阅函数
+   */
+  subscribeModalParentData(callback) {
+    return this.dataPool.manager.subscribe({
+      namespace: SHARED_NAMESPACES.MODAL,
+      key: SHARED_KEYS.MODAL_PARENT_DATA
+    }, callback)
+  }
+
+  // ==================== 工具方法 ====================
+
+  /**
+   * 导出模型数据
+   * @param {string} instanceId 实例ID
+   * @returns {object} 导出的数据
+   */
+  exportModelData(instanceId) {
+    const model = this.dataPool.manager.getModel(instanceId)
+    return model ? model.export() : null
+  }
+
+  /**
+   * 导入模型数据
+   * @param {string} instanceId 实例ID
+   * @param {object} data 要导入的数据
+   */
+  importModelData(instanceId, data) {
+    this.dataPool.manager.importData(instanceId, data)
+    return this
+  }
+
+  /**
+   * 清理模型数据
+   * @param {string} instanceId 实例ID
+   */
+  clearModelData(instanceId) {
+    this.dataPool.manager.clearModelData(instanceId)
+    return this
+  }
+
+  /**
+   * 获取调试信息
+   * @returns {object} 调试信息
+   */
+  getDebugInfo() {
+    return this.dataPool.manager.debug()
+  }
+
+  /**
+   * 生成唯一ID
+   * @param {string} prefix 前缀
+   * @returns {string} 唯一ID
+   */
+  generateId(prefix = 'data') {
+    return this.dataPool.utils.generateId(prefix)
+  }
+
+  /**
+   * 深拷贝对象
+   * @param {any} obj 要拷贝的对象
+   * @returns {any} 拷贝后的对象
+   */
+  deepClone(obj) {
+    return this.dataPool.utils.deepClone(obj)
+  }
+
+  /**
+   * 检查对象是否为空
+   * @param {any} value 要检查的值
+   * @returns {boolean} 是否为空
+   */
+  isEmpty(value) {
+    return this.dataPool.utils.isEmpty(value)
+  }
+
+  /**
+   * 检查是否为对象
+   * @param {any} value 要检查的值
+   * @returns {boolean} 是否为对象
+   */
+  isObject(value) {
+    return this.dataPool.utils.isObject(value)
+  }
+
+  /**
+   * 获取当前时间戳
+   * @returns {number} 时间戳
+   */
+  now() {
+    return this.dataPool.utils.now()
+  }
+}
+
+/**
+ * 创建数据池 API 实例
+ * @returns {DataPoolAPI} API 实例
+ */
+export const createDataPoolAPI = () => {
+  return new DataPoolAPI()
+}
+
+/**
+ * 全局数据池 API 实例 - 延迟初始化
+ */
+let dataPoolAPIInstance = null
+
+export const dataPoolAPI = new Proxy({}, {
+  get(target, prop) {
+    if (!dataPoolAPIInstance) {
+      dataPoolAPIInstance = createDataPoolAPI()
+    }
+    return dataPoolAPIInstance[prop]
+  }
+})
+
+/**
+ * 便捷的导出函数，供直接使用 - 延迟初始化
+ */
+const getAPI = () => {
+  if (!dataPoolAPIInstance) {
+    dataPoolAPIInstance = createDataPoolAPI()
+  }
+  return dataPoolAPIInstance
+}
+
+// 模型管理
+export const createTreeTableModel = (instanceId, options = {}) => getAPI().createTreeTableModel(instanceId, options)
+export const getModel = (instanceId) => getAPI().getModel(instanceId)
+export const getAllModels = (modelType = null) => getAPI().getAllModels(modelType)
+export const destroyModel = (instanceId) => getAPI().destroyModel(instanceId)
+
+// 数据操作
+export const setModelData = (instanceId, key, value) => getAPI().setModelData(instanceId, key, value)
+export const getModelData = (instanceId, key, defaultValue = null) => getAPI().getModelData(instanceId, key, defaultValue)
+export const setBatchModelData = (instanceId, data) => getAPI().setBatchModelData(instanceId, data)
+export const getAllModelData = (instanceId) => getAPI().getAllModelData(instanceId)
+
+// 用户数据
+export const setUserInfo = (userInfo) => getAPI().setUserInfo(userInfo)
+export const getUserInfo = () => getAPI().getUserInfo()
+export const setUserPermissions = (permissions) => getAPI().setUserPermissions(permissions)
+export const getUserPermissions = () => getAPI().getUserPermissions()
+
+// 系统数据
+export const setSystemConfig = (config) => getAPI().setSystemConfig(config)
+export const getSystemConfig = () => getAPI().getSystemConfig()
+export const setSystemTheme = (theme) => getAPI().setSystemTheme(theme)
+export const getSystemTheme = () => getAPI().getSystemTheme()
+
+// 业务数据
+export const setModalParentData = (parentData) => getAPI().setModalParentData(parentData)
+export const getModalParentData = () => getAPI().getModalParentData()
+export const setBusinessDictionaries = (dictionaries) => getAPI().setBusinessDictionaries(dictionaries)
+export const getBusinessDictionaries = () => getAPI().getBusinessDictionaries()
+
+// 订阅
+export const subscribeModelData = (instanceId, key, callback) => getAPI().subscribeModelData(instanceId, key, callback)
+export const subscribeUserInfo = (callback) => getAPI().subscribeUserInfo(callback)
+export const subscribeSystemConfig = (callback) => getAPI().subscribeSystemConfig(callback)
+export const subscribeSystemTheme = (callback) => getAPI().subscribeSystemTheme(callback)
+export const subscribeModalParentData = (callback) => getAPI().subscribeModalParentData(callback)
+
+// 工具
+export const exportModelData = (instanceId) => getAPI().exportModelData(instanceId)
+export const importModelData = (instanceId, data) => getAPI().importModelData(instanceId, data)
+export const clearModelData = (instanceId) => getAPI().clearModelData(instanceId)
+export const getDebugInfo = (instanceId = null) => getAPI().getDebugInfo(instanceId)
+export const generateId = (prefix = '') => getAPI().generateId(prefix)
+export const deepClone = (obj) => getAPI().deepClone(obj)
+export const isEmpty = (value) => getAPI().isEmpty(value)
+export const isObject = (value) => getAPI().isObject(value)
+export const now = () => getAPI().now()
+
+// 默认导出 API 实例
+export default dataPoolAPI