/**
|
* 存储驱动接口（策略模式核心抽象）
|
* 所有存储实现（localStorage、IndexedDB、Memory 等）都需要实现此接口
|
* Driver 层只负责纯粹的 KV 存取，不感知 TTL 和前缀
|
*/
|
interface IStorageDriver {
|
/** 清除所有存储项 */
|
clear(): Promise<void>;
|
|
/** 获取存储项 */
|
getItem<T>(key: string): Promise<null | T>;
|
|
/** 获取所有 key */
|
keys(): Promise<string[]>;
|
|
/** 移除存储项 */
|
removeItem(key: string): Promise<void>;
|
|
/** 设置存储项 */
|
setItem(key: string, value: unknown): Promise<void>;
|
}
|
|
/**
|
* 带 TTL 的存储项包装结构
|
* TTL 逻辑由 StorageManager 统一管理，Driver 层不感知
|
*/
|
interface StorageItem<T> {
|
expiry?: number;
|
value: T;
|
}
|
|
interface StorageManagerOptions {
|
/** 存储驱动实例 */
|
driver?: IStorageDriver;
|
/** 键前缀，用于命名空间隔离 */
|
prefix?: string;
|
}
|
|
export type { IStorageDriver, StorageItem, StorageManagerOptions };
|
