//#region src/modules/storage.d.ts
interface StorageInfo {
  keys: string[];
  currentSize: number;
  limitSize: number;
  cacheInfo?: any;
}
interface StorageOptions {
  /**
   * 全局key前缀
   */
  prefix?: string;
  /**
   * 是否启用缓存
   */
  enableCache?: boolean;
}
/**
 * Storage抽象类，提供小程序和web平台统一的接口实现。
 * @public
 */
declare abstract class AbstractStorage<T extends string = string> {
  protected prefix: string;
  constructor(options?: StorageOptions);
  /**
   * 获取带前缀的完整key
   */
  protected getFullKey(key: T): string;
  /**
   * 从完整key中移除前缀
   */
  protected removePrefix(fullKey: string): string;
  /**
   * 按当前实例的命名空间清理存储区键值。
   * @param storage - 要清理的存储对象
   * @returns 无返回值
   */
  protected clearPrefixedStorageKeys(storage: Storage): void;
  abstract getStorageSync(key: T): unknown;
  abstract getStorage(key: T): Promise<unknown>;
  abstract setStorageSync(key: T, value: unknown): void;
  abstract setStorage(key: T, value: unknown): Promise<void>;
  abstract removeStorageSync(key: T): void;
  abstract removeStorage(key: T): Promise<void>;
  abstract clearStorage(): Promise<void>;
  /**
   * 获取存储相关信息
   */
  abstract getStorageInfoSync(): StorageInfo;
  /**
   * 获取存储相关信息异步
   */
  abstract getStorageInfo(): Promise<StorageInfo>;
  stringify(value: unknown): string;
  parse(value: string): unknown;
}
/**
 * web端 localStorage的封装
 * @public
 */
declare class WebLocalStorage<T extends string = string> extends AbstractStorage<T> {
  private cache;
  private enableCache;
  constructor(options?: StorageOptions);
  getStorageInfoSync(): StorageInfo;
  /**
   * @deprecated 使用 getKeys() 替代
   */
  Keys(): T[];
  getKeys(): T[];
  getStorageInfo(): Promise<StorageInfo>;
  /**
   * 异步清理localStorage；配置 prefix 时只清当前命名空间，否则清空整个存储区。
   * @returns Promise 对象，完成后无返回值
   */
  clearStorage(): Promise<void>;
  /**
   * 同步清理localStorage；配置 prefix 时只清当前命名空间，否则清空整个存储区，并清理缓存。
   * @returns 无返回值
   */
  clearStorageSync(): void;
  removeStorageSync(key: T): void;
  removeStorage(key: T): Promise<void>;
  setStorage(key: T, value: unknown): Promise<void>;
  getStorage(key: T): Promise<unknown>;
  setStorageSync(key: T, value: unknown): void;
  getStorageSync(key: T): unknown;
}
/**
 * 对Taro的Storage API进行封装，主要是为了提供ts类型提示。
 * @example
 * import \{ TaroStorage \} from '\@mudssky/jsutils'
 *
 * import \{
 *   clearStorageSync,
 *   getStorageInfoSync,
 *   getStorageSync,
 *   removeStorageSync,
 *   setStorageSync,
 * \} from '\@tarojs/taro'
 *
 * export type StorageKey = 'USERINFO'
 *
 * export const GlobalStorage = new TaroStorage\<StorageKey\>(\{
 *   getStorageSync,
 *   setStorageSync,
 *   clearStorageSync,
 *   removeStorageSync,
 *   getStorageInfoSync,
 * \})
 * @public
 */
declare class TaroStorage<T extends string = string> extends AbstractStorage {
  Taro: any;
  constructor(Taro: any);
  getStorageInfoSync(): StorageInfo;
  getStorageInfo(): Promise<StorageInfo>;
  clearStorage(): Promise<void>;
  clearStorageSync(): void;
  removeStorageSync(key: T): void;
  removeStorage(key: T): Promise<void>;
  getStorage(key: T): Promise<unknown>;
  setStorage(key: T, data: unknown): Promise<void>;
  getStorageSync(key: T): unknown;
  setStorageSync(key: T, data: unknown): void;
}
/**
 * 对uniapp的Storage API进行封装，主要是为了提供ts类型提示。
 * @example
 * import \{ UniStorage \} from '\@mudssky/jsutils'
 *
 * export type GlobalStorageKey = 'userId'
 *
 * export const GlobalStorage = new UniStorage\<GlobalStorageKey\>(\{
 *   getStorageSync: uni.getStorageSync,
 *   setStorageSync: uni.setStorageSync,
 *   clearStorageSync: uni.clearStorageSync,
 *   removeStorageSync: uni.removeStorageSync,
 *   getStorageInfoSync: uni.getStorageInfoSync,
 * \})
 * @public
 */
declare class UniStorage<T extends string = string> extends AbstractStorage {
  Uni: any;
  constructor(Uni: any);
  getStorageInfoSync(): StorageInfo;
  getStorageInfo(): Promise<StorageInfo>;
  clearStorage(): Promise<void>;
  clearStorageSync(): void;
  removeStorageSync(key: T): void;
  removeStorage(key: T): Promise<void>;
  getStorage(key: T): Promise<unknown>;
  setStorage(key: T, data: unknown): Promise<void>;
  getStorageSync(key: T): unknown;
  setStorageSync(key: T, data: unknown): void;
}
/**
 * web端 sessionStorage的封装
 * @public
 */
declare class WebSessionStorage<T extends string = string> extends AbstractStorage<T> {
  private cache;
  private enableCache;
  private cleanupTimer?;
  constructor(options?: StorageOptions);
  private setupSessionListeners;
  getStorageInfoSync(): StorageInfo;
  getKeys(): T[];
  getStorageInfo(): Promise<StorageInfo>;
  /**
   * 异步清理sessionStorage；配置 prefix 时只清当前命名空间，否则清空整个存储区。
   * @returns Promise 对象，完成后无返回值
   */
  clearStorage(): Promise<void>;
  /**
   * 同步清理sessionStorage；配置 prefix 时只清当前命名空间，否则清空整个存储区，并清理缓存。
   * @returns 无返回值
   */
  clearStorageSync(): void;
  removeStorageSync(key: T): void;
  removeStorage(key: T): Promise<void>;
  setStorage(key: T, value: unknown): Promise<void>;
  getStorage(key: T): Promise<unknown>;
  setStorageSync(key: T, value: unknown): void;
  getStorageSync(key: T): unknown;
  /**
   * 处理存储空间不足的情况
   */
  private handleQuotaExceeded;
  /**
   * 与 localStorage 同步数据
   */
  syncToLocalStorage(keys?: T[]): void;
  /**
   * 从 localStorage 恢复数据
   */
  restoreFromLocalStorage(keys?: T[]): void;
  /**
   * 表单数据自动保存
   */
  autoSaveForm(formId: string, interval?: number): () => void;
  /**
   * 页面状态快照
   */
  createSnapshot(snapshotId: string, state: Record<string, unknown>): void;
  /**
   * 恢复页面状态快照
   */
  restoreSnapshot(snapshotId: string): unknown;
  /**
   * 清理过期的快照数据
   */
  cleanExpiredSnapshots(maxAge?: number): void;
}
//#endregion
export { AbstractStorage, type StorageInfo, type StorageOptions, TaroStorage, UniStorage, WebLocalStorage, WebSessionStorage };