@pisell/core 1.1.3 → 1.1.5

package/es/indexDB/index.d.ts

@@ -3,7 +3,7 @@ import App from "../app";
  * IndexDB 管理器模块
  *
  * 这个模块提供了对浏览器 IndexedDB 的简单封装，并在不支持 IndexedDB 的环境中
- * 自动降级使用 localStorage 作为备选存储方案。
+ * 自动降级使用内存存储作为备选存储方案。
  */
 /**
  * 数据库配置选项接口
@@ -30,10 +30,11 @@ export interface DBOptions {
             options?: IDBIndexParameters;
         }[];
     }[];
+    timeout?: number;
 }
 /**
  * IndexDB 管理器类
- * 提供对 IndexedDB 的简单封装，支持自动降级到 localStorage
+ * 提供对 IndexedDB 的简单封装，支持自动降级到内存存储
  * @class IndexDBManager
  */
 declare class IndexDBManager {
@@ -49,25 +50,34 @@ declare class IndexDBManager {
     private stores;
     private useIndexDB;
     private app;
+    private memoryStorage;
+    private timeout;
     /**
      * 创建 IndexDBManager 实例
      * @param {DBOptions} options - 数据库配置选项
      */
     constructor(app: App, options: DBOptions);
+    /**
+     * 超时包装器 - 为 Promise 添加超时控制
+     * @param {Promise<T>} promise - 需要包装的 Promise
+     * @param {string} operation - 操作名称（用于错误提示）
+     * @returns {Promise<T>} 带超时控制的 Promise
+     * @private
+     */
+    private withTimeout;
     /**
      * 初始化数据库连接
-     * 如果环境不支持 IndexedDB，将自动使用 localStorage
+     * 如果环境不支持 IndexedDB，将自动使用内存存储
      * @returns {Promise<boolean>} 连接是否成功
      */
     connect(): Promise<boolean>;
     /**
-     * 生成用于 localStorage 的存储键
+     * 获取内存存储中指定 store 的 Map
      * @param {string} storeName - 存储对象名称
-     * @param {string|number} [key] - 可选的键值
-     * @returns {string} 格式化的存储键
+     * @returns {Map<string | number, any>} 存储 Map
      * @private
      */
-    private getStorageKey;
+    private getMemoryStore;
     /**
      * 添加数据到指定的存储对象
      * @param {string} storeName - 存储对象名称
@@ -169,9 +179,9 @@ declare class IndexDBManager {
     close(): void;
     /**
      * 获取当前使用的存储方式
-     * @returns {'indexDB'|'localStorage'} 当前使用的存储方式
+     * @returns {'indexDB'|'memory'} 当前使用的存储方式
      */
-    getCurrentStorage(): 'indexDB' | 'localStorage';
+    getCurrentStorage(): 'indexDB' | 'memory';
 }
 /**
  * 使用示例:
@@ -240,12 +250,18 @@ declare class IndexDBManager {
  * db.close();
  *
  * // 15. 检查当前使用的存储方式
- * const storageType = db.getCurrentStorage(); // 'indexDB' 或 'localStorage'
+ * const storageType = db.getCurrentStorage(); // 'indexDB' 或 'memory'
  *
  * // 性能优化建议：
  * // - 使用 exists() 而不是 get() 来检查数据是否存在
  * // - 为常用查询字段创建索引
  * // - 使用索引查询方法来提高查询效率
  * // - 批量操作时使用事务（可以考虑后续扩展）
+ *
+ * // 降级方案说明：
+ * // - 当浏览器不支持 IndexedDB 时，会自动使用内存存储 (Map) 作为降级方案
+ * // - 内存存储的数据在页面刷新后会丢失，仅适合临时数据存储
+ * // - 内存存储支持所有 IndexedDB API，包括索引查询
+ * // - 对于需要持久化的数据，请确保浏览器支持 IndexedDB
  */
 export default IndexDBManager;