@iss-ai/easy-web-store 0.0.1 → 0.0.3

package/lib/{src/easy/DexieStore.d.ts → easy/EasyDexieStore.d.ts}

@@ -10,8 +10,10 @@ export declare class EasyDexieDatabase<T extends IBase = any> extends Dexie {
     /**
      * 构造函数
      * @param dbName 数据库名称
+     * @param tableName 表名称
+     * @param tableSchema 表模式定义（可选）
      */
-    constructor(dbName: string, tableName: string, tSchema?: string);
+    constructor(dbName: string, tableName: string, tableSchema?: string);
 }
 /**
  * EasyDexieStore 类，基于 Dexie 实现 IEasyStore 接口
@@ -23,8 +25,9 @@ export declare class EasyDexieStore<T extends IBase = any> implements IEasyStore
     private tableName;
     /**
      * 构造函数
-     * @param dbName 数据库名称
-     * @param tableName 表名称（默认为 'store'）
+     * @param tableName 表名称
+     * @param dbName 数据库名称（默认为 'easy-store'）
+     * @param tableSchema 表模式定义（可选）
      */
     constructor(tableName?: string, dbName?: string, tableSchema?: string);
     /**
@@ -32,11 +35,6 @@ export declare class EasyDexieStore<T extends IBase = any> implements IEasyStore
      * @returns 数据表实例
      */
     private getTable;
-    /**
-     * 生成唯一 ID
-     * @returns 时间戳格式的 ID
-     */
-    private generateId;
     /**
      * 保存或更新单条数据
      * @param data 要保存的数据
@@ -69,9 +67,10 @@ export declare class EasyDexieStore<T extends IBase = any> implements IEasyStore
     getInfo(condition: Partial<T>): Promise<T | null>;
     /**
      * 根据条件更新信息
+     * 更新所有符合条件的数据
      * @param data 要更新的数据
      * @param condition 查询条件
-     * @returns Promise 返回更新后的数据
+     * @returns Promise 返回更新后的第一条数据
      */
     update(data: Record<string, any>, condition: Partial<T>): Promise<T | null>;
     /**
@@ -91,11 +90,26 @@ export declare class EasyDexieStore<T extends IBase = any> implements IEasyStore
      * @returns Promise 返回分页结果
      */
     getPage(condition: IQueryCondition<T>): Promise<IPage<T>>;
+    /**
+     * 应用 where 条件到查询集合
+     * @param collection 当前查询集合
+     * @param where 查询条件
+     * @returns 应用条件后的查询集合
+     */
+    private applyWhereConditions;
+    /**
+     * 应用复杂条件操作符
+     * @param collection 当前查询集合
+     * @param key 字段名
+     * @param condition 复杂条件
+     * @returns 应用条件后的查询集合
+     */
+    private applyComplexCondition;
     /**
      * 应用排序规则
-     * @param items 数据列表
+     * @param collection 当前查询集合
      * @param sort 排序规则
-     * @returns 排序后的列表
+     * @returns 应用排序后的查询集合
      */
     private applySort;
     /**
@@ -105,21 +119,6 @@ export declare class EasyDexieStore<T extends IBase = any> implements IEasyStore
      * @returns 只包含指定字段的数据
      */
     private selectFields;
-    /**
-     * 检查数据是否匹配复杂条件
-     * @param item 数据项
-     * @param key 字段名
-     * @param value 查询值
-     * @returns 是否匹配
-     */
-    private matchesCondition;
-    /**
-     * 检查数据是否匹配简单条件
-     * @param item 数据项
-     * @param condition 查询条件
-     * @returns 是否匹配
-     */
-    private matchesConditionSimple;
     /**
      * 关闭数据库连接
      */

package/lib/easy/EasyIndexedDb.d.ts

@@ -0,0 +1,2 @@
+import { EasyDexieStore } from './EasyDexieStore';
+export declare const EasyIndexedDb: typeof EasyDexieStore;

package/lib/easy/EasyLocalStorage.d.ts

@@ -0,0 +1,105 @@
+import { IBase, IEasyStore, IQueryCondition, IPage } from '../interface/types';
+/**
+ * EasyLocalStorage 类，基于 localStorage 实现 IEasyStore 接口
+ * 数据持久化存储在 localStorage 中
+ * @template T 数据类型，必须继承 IBase 接口
+ */
+export declare class EasyLocalStorage<T extends IBase = any> implements IEasyStore<T> {
+    private storeName;
+    /**
+     * 构造函数
+     * @param storeName 存储名称
+     */
+    constructor(storeName?: string);
+    /**
+     * 获取存储的键名
+     * @returns 存储键名
+     */
+    private getStorageKey;
+    /**
+     * 从 localStorage 获取所有数据
+     * @returns 数据 Map
+     */
+    private getAllData;
+    /**
+     * 将所有数据保存到 localStorage
+     * @param data 数据 Map
+     */
+    private saveAllData;
+    /**
+     * 检查数据是否匹配条件
+     * @param item 数据项
+     * @param condition 查询条件
+     * @returns 是否匹配
+     */
+    private matchesCondition;
+    /**
+     * 应用排序
+     * @param items 数据列表
+     * @param sort 排序规则
+     * @returns 排序后的列表
+     */
+    private applySort;
+    /**
+     * 选择指定字段
+     * @param item 数据项
+     * @param fields 字段选择
+     * @returns 只包含指定字段的数据
+     */
+    private selectFields;
+    /**
+     * 保存或更新单条数据
+     * @param data 要保存的数据
+     * @returns Promise 返回保存后的数据
+     */
+    save(data: Omit<T, 'id'> | T): Promise<T>;
+    /**
+     * 批量保存或更新数据
+     * @param dataList 要保存的数据列表
+     * @returns Promise 返回保存后的数据列表
+     */
+    saveList(dataList: Array<Omit<T, 'id'> | T>): Promise<T[]>;
+    /**
+     * 根据条件获取列表
+     * @param condition 查询条件
+     * @returns Promise 返回数据列表
+     */
+    getList(condition?: IQueryCondition<T>): Promise<T[]>;
+    /**
+     * 根据条件删除数据
+     * @param condition 删除条件
+     * @returns Promise 返回删除的数量
+     */
+    delete(condition: Partial<T>): Promise<number>;
+    /**
+     * 根据条件获取单条信息
+     * @param condition 查询条件
+     * @returns Promise 返回单条数据，不存在则返回 null
+     */
+    getInfo(condition: Partial<T>): Promise<T | null>;
+    /**
+     * 根据条件更新信息
+     * 更新所有符合条件的数据
+     * @param data 要更新的数据
+     * @param condition 查询条件
+     * @returns Promise 返回更新后的第一条数据
+     */
+    update(data: Record<string, any>, condition: Partial<T>): Promise<T | null>;
+    /**
+     * 根据条件统计数量
+     * @param condition 统计条件
+     * @returns Promise 返回符合条件的记录数
+     */
+    count(condition: Partial<T>): Promise<number>;
+    /**
+     * 清空所有数据
+     * @returns Promise
+     */
+    clear(): Promise<void>;
+    /**
+     * 根据条件分页获取列表
+     * @param condition 查询条件和分页参数
+     * @returns Promise 返回分页结果
+     */
+    getPage(condition: IQueryCondition<T>): Promise<IPage<T>>;
+}

package/lib/easy/EasyMemoryStore.d.ts

@@ -0,0 +1,91 @@
+import { IBase, IEasyStore, IQueryCondition, IPage } from '../interface/types';
+/**
+ * EasyMemoryStore 类，基于内存实现 IEasyStore 接口
+ * 数据存储在内存中，应用重启后数据会丢失
+ * @template T 数据类型，必须继承 IBase 接口
+ */
+export declare class EasyMemoryStore<T extends IBase = any> implements IEasyStore<T> {
+    private data;
+    private storeName;
+    /**
+     * 构造函数
+     * @param storeName 存储名称
+     */
+    constructor(storeName?: string);
+    /**
+     * 检查数据是否匹配条件
+     * @param item 数据项
+     * @param condition 查询条件
+     * @returns 是否匹配
+     */
+    private matchesCondition;
+    /**
+     * 应用排序
+     * @param items 数据列表
+     * @param sort 排序规则
+     * @returns 排序后的列表
+     */
+    private applySort;
+    /**
+     * 选择指定字段
+     * @param item 数据项
+     * @param fields 字段选择
+     * @returns 只包含指定字段的数据
+     */
+    private selectFields;
+    /**
+     * 保存或更新单条数据
+     * @param data 要保存的数据
+     * @returns Promise 返回保存后的数据
+     */
+    save(data: Omit<T, 'id'> | T): Promise<T>;
+    /**
+     * 批量保存或更新数据
+     * @param dataList 要保存的数据列表
+     * @returns Promise 返回保存后的数据列表
+     */
+    saveList(dataList: Array<Omit<T, 'id'> | T>): Promise<T[]>;
+    /**
+     * 根据条件获取列表
+     * @param condition 查询条件
+     * @returns Promise 返回数据列表
+     */
+    getList(condition?: IQueryCondition<T>): Promise<T[]>;
+    /**
+     * 根据条件删除数据
+     * @param condition 删除条件
+     * @returns Promise 返回删除的数量
+     */
+    delete(condition: Partial<T>): Promise<number>;
+    /**
+     * 根据条件获取单条信息
+     * @param condition 查询条件
+     * @returns Promise 返回单条数据，不存在则返回 null
+     */
+    getInfo(condition: Partial<T>): Promise<T | null>;
+    /**
+     * 根据条件更新信息
+     * 更新所有符合条件的数据
+     * @param data 要更新的数据
+     * @param condition 查询条件
+     * @returns Promise 返回更新后的第一条数据
+     */
+    update(data: Record<string, any>, condition: Partial<T>): Promise<T | null>;
+    /**
+     * 根据条件统计数量
+     * @param condition 统计条件
+     * @returns Promise 返回符合条件的记录数
+     */
+    count(condition: Partial<T>): Promise<number>;
+    /**
+     * 清空所有数据
+     * @returns Promise
+     */
+    clear(): Promise<void>;
+    /**
+     * 根据条件分页获取列表
+     * @param condition 查询条件和分页参数
+     * @returns Promise 返回分页结果
+     */
+    getPage(condition: IQueryCondition<T>): Promise<IPage<T>>;
+}

package/lib/easy/EasySessionStorage.d.ts

@@ -0,0 +1,105 @@
+import { IBase, IEasyStore, IQueryCondition, IPage } from '../interface/types';
+/**
+ * EasySessionStorage 类，基于 sessionStorage 实现 IEasyStore 接口
+ * 数据存储在 sessionStorage 中，页面关闭后数据会丢失
+ * @template T 数据类型，必须继承 IBase 接口
+ */
+export declare class EasySessionStorage<T extends IBase = any> implements IEasyStore<T> {
+    private storeName;
+    /**
+     * 构造函数
+     * @param storeName 存储名称
+     */
+    constructor(storeName?: string);
+    /**
+     * 获取存储的键名
+     * @returns 存储键名
+     */
+    private getStorageKey;
+    /**
+     * 从 sessionStorage 获取所有数据
+     * @returns 数据 Map
+     */
+    private getAllData;
+    /**
+     * 将所有数据保存到 sessionStorage
+     * @param data 数据 Map
+     */
+    private saveAllData;
+    /**
+     * 检查数据是否匹配条件
+     * @param item 数据项
+     * @param condition 查询条件
+     * @returns 是否匹配
+     */
+    private matchesCondition;
+    /**
+     * 应用排序
+     * @param items 数据列表
+     * @param sort 排序规则
+     * @returns 排序后的列表
+     */
+    private applySort;
+    /**
+     * 选择指定字段
+     * @param item 数据项
+     * @param fields 字段选择
+     * @returns 只包含指定字段的数据
+     */
+    private selectFields;
+    /**
+     * 保存或更新单条数据
+     * @param data 要保存的数据
+     * @returns Promise 返回保存后的数据
+     */
+    save(data: Omit<T, 'id'> | T): Promise<T>;
+    /**
+     * 批量保存或更新数据
+     * @param dataList 要保存的数据列表
+     * @returns Promise 返回保存后的数据列表
+     */
+    saveList(dataList: Array<Omit<T, 'id'> | T>): Promise<T[]>;
+    /**
+     * 根据条件获取列表
+     * @param condition 查询条件
+     * @returns Promise 返回数据列表
+     */
+    getList(condition?: IQueryCondition<T>): Promise<T[]>;
+    /**
+     * 根据条件删除数据
+     * @param condition 删除条件
+     * @returns Promise 返回删除的数量
+     */
+    delete(condition: Partial<T>): Promise<number>;
+    /**
+     * 根据条件获取单条信息
+     * @param condition 查询条件
+     * @returns Promise 返回单条数据，不存在则返回 null
+     */
+    getInfo(condition: Partial<T>): Promise<T | null>;
+    /**
+     * 根据条件更新信息
+     * 更新所有符合条件的数据
+     * @param data 要更新的数据
+     * @param condition 查询条件
+     * @returns Promise 返回更新后的第一条数据
+     */
+    update(data: Record<string, any>, condition: Partial<T>): Promise<T | null>;
+    /**
+     * 根据条件统计数量
+     * @param condition 统计条件
+     * @returns Promise 返回符合条件的记录数
+     */
+    count(condition: Partial<T>): Promise<number>;
+    /**
+     * 清空所有数据
+     * @returns Promise
+     */
+    clear(): Promise<void>;
+    /**
+     * 根据条件分页获取列表
+     * @param condition 查询条件和分页参数
+     * @returns Promise 返回分页结果
+     */
+    getPage(condition: IQueryCondition<T>): Promise<IPage<T>>;
+}