@nokecy/qc-ui 1.0.93 → 1.0.94

package/dist/cjs/ag-grid-plus/schemes/storage/localStorageAdapter.js

@@ -12,23 +12,36 @@ function _asyncToGenerator(fn) { return function () { var self = this, args = ar
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * LocalStorage 配置
+ */
 /**
  * LocalStorage 存储适配器实现
- * 默认的方案存储方式，支持自动迁移旧数据
+ * 默认的方案存储方式，支持自动迁移旧数据和用户隔离
  */
 var LocalStorageAdapter = exports.LocalStorageAdapter = /*#__PURE__*/function () {
   function LocalStorageAdapter() {
+    var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
     _classCallCheck(this, LocalStorageAdapter);
+    _defineProperty(this, "config", void 0);
+    this.config = config;
   }
+
+  /**
+   * 生成存储键名
+   * 如果配置了 getUserId，则键名会包含用户标识
+   */
   _createClass(LocalStorageAdapter, [{
     key: "getStorageKey",
-    value:
-    /**
-     * 生成存储键名
-     */
-    function getStorageKey(gridId) {
+    value: function getStorageKey(gridId) {
+      var _this$config$getUserI, _this$config;
+      var userId = (_this$config$getUserI = (_this$config = this.config).getUserId) === null || _this$config$getUserI === void 0 ? void 0 : _this$config$getUserI.call(_this$config);
+      if (userId) {
+        return "".concat(_constants.STORAGE_PREFIX, "-").concat(userId, "-").concat(gridId);
+      }
       return "".concat(_constants.STORAGE_PREFIX, "-").concat(gridId);
     }
 
@@ -270,10 +283,16 @@ var LocalStorageAdapter = exports.LocalStorageAdapter = /*#__PURE__*/function ()
 
     /**
      * 生成当前方案ID存储键名
+     * 如果配置了 getUserId，则键名会包含用户标识
      */
   }, {
     key: "getCurrentSchemeKey",
     value: function getCurrentSchemeKey(gridId) {
+      var _this$config$getUserI2, _this$config2;
+      var userId = (_this$config$getUserI2 = (_this$config2 = this.config).getUserId) === null || _this$config$getUserI2 === void 0 ? void 0 : _this$config$getUserI2.call(_this$config2);
+      if (userId) {
+        return "".concat(_constants.STORAGE_PREFIX, "-").concat(userId, "-").concat(gridId).concat(_constants.CURRENT_SCHEME_SUFFIX);
+      }
       return "".concat(_constants.STORAGE_PREFIX, "-").concat(gridId).concat(_constants.CURRENT_SCHEME_SUFFIX);
     }
 
@@ -349,6 +368,7 @@ var LocalStorageAdapter = exports.LocalStorageAdapter = /*#__PURE__*/function ()
   return LocalStorageAdapter;
 }();
 /**
- * 导出默认实例
+ * 导出默认实例（不带用户隔离）
+ * 如需用户隔离，请创建新实例并传入 getUserId 配置
  */
 var defaultStorageAdapter = exports.defaultStorageAdapter = new LocalStorageAdapter();

package/dist/cjs/ag-grid-plus/schemes/storage/priorityStorageAdapter.d.ts

@@ -0,0 +1,122 @@
+import { ColumnScheme, StorageAdapter } from '../types';
+/**
+ * 优先级存储适配器配置
+ */
+export interface PriorityStorageConfig {
+    /**
+     * 主存储适配器（优先使用）
+     * 通常是远端存储适配器
+     */
+    primary: StorageAdapter;
+    /**
+     * 备用存储适配器（主存储失败时使用）
+     * 通常是本地存储适配器
+     * 可选，如果不提供则主存储失败时直接抛出错误
+     */
+    fallback?: StorageAdapter;
+    /**
+     * 是否启用自动降级
+     * 当主存储连续失败达到阈值时，自动切换到备用存储
+     * 默认: false
+     */
+    enableAutoDemotion?: boolean;
+    /**
+     * 自动降级的失败阈值
+     * 默认: 3
+     */
+    demotionThreshold?: number;
+    /**
+     * 降级恢复检测间隔（毫秒）
+     * 定期检测主存储是否恢复，如果恢复则切换回主存储
+     * 默认: 60000 (1分钟)
+     */
+    recoveryCheckInterval?: number;
+    /**
+     * 是否在主存储可用时同步数据到备用存储
+     * 默认: false
+     */
+    syncToFallback?: boolean;
+    /**
+     * 错误处理回调
+     */
+    onError?: (error: Error, adapter: 'primary' | 'fallback') => void;
+    /**
+     * 降级事件回调
+     */
+    onDemotion?: () => void;
+    /**
+     * 恢复事件回调
+     */
+    onRecovery?: () => void;
+}
+/**
+ * 优先级存储适配器
+ * 实现远端优先、本地备用的存储策略
+ *
+ * 核心特性：
+ * 1. 主存储优先：优先使用主存储（通常是远端）
+ * 2. 自动降级：主存储连续失败时，自动切换到备用存储
+ * 3. 自动恢复：定期检测主存储状态，恢复后自动切换回主存储
+ * 4. 数据同步：可选地将主存储数据同步到备用存储
+ * 5. 完全隔离：不会混用主存储和备用存储的数据
+ */
+export declare class PriorityStorageAdapter implements StorageAdapter {
+    private config;
+    private failureCount;
+    private isDemoted;
+    private recoveryCheckTimer?;
+    constructor(config: PriorityStorageConfig);
+    /**
+     * 开始恢复检测
+     */
+    private startRecoveryCheck;
+    /**
+     * 停止恢复检测
+     */
+    private stopRecoveryCheck;
+    /**
+     * 处理主存储错误
+     */
+    private handlePrimaryError;
+    /**
+     * 执行带降级的操作
+     */
+    private executeWithFallback;
+    /**
+     * 获取指定表格的所有方案
+     */
+    getSchemes(gridId: string): Promise<ColumnScheme[]>;
+    /**
+     * 保存方案列表
+     * 只保存到主存储，确保数据一致性
+     */
+    saveSchemes(gridId: string, schemes: ColumnScheme[]): Promise<void>;
+    /**
+     * 清除指定表格的所有方案
+     */
+    clearSchemes(gridId: string): Promise<void>;
+    /**
+     * 获取当前激活的方案ID
+     */
+    getCurrentSchemeId(gridId: string): Promise<string | null>;
+    /**
+     * 保存当前激活的方案ID
+     */
+    saveCurrentSchemeId(gridId: string, schemeId: string | null): Promise<void>;
+    /**
+     * 获取当前存储状态
+     */
+    getStatus(): {
+        isDemoted: boolean;
+        failureCount: number;
+        primaryAvailable: boolean;
+    };
+    /**
+     * 手动重置到主存储
+     */
+    resetToPrimary(): void;
+    /**
+     * 清理资源
+     */
+    dispose(): void;
+}