@vlian/framework 1.0.0

package/dist/library/storage/encryption.cjs

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EncryptionUtils", {
+    enumerable: true,
+    get: function() {
+        return EncryptionUtils;
+    }
+});
+const _security = require("../../utils/security");
+const _errors = require("../../utils/errors");
+let EncryptionUtils = class EncryptionUtils {
+    /**
+   * 生成加密密钥
+   */ static async generateKey() {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new _errors.StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            return await window.crypto.subtle.generateKey({
+                name: 'AES-GCM',
+                length: 256
+            }, true, [
+                'encrypt',
+                'decrypt'
+            ]);
+        } catch (error) {
+            throw new _errors.StorageError('生成加密密钥失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 使用 PBKDF2 派生密钥
+   */ static async deriveKey(password, salt, iterations = 100000) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new _errors.StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            // 导入密码
+            const encoder = new TextEncoder();
+            const passwordKey = await window.crypto.subtle.importKey('raw', encoder.encode(password), 'PBKDF2', false, [
+                'deriveBits',
+                'deriveKey'
+            ]);
+            // 使用 PBKDF2 派生密钥
+            // 确保 salt 是 BufferSource 类型（使用类型断言）
+            const saltBuffer = salt instanceof Uint8Array ? salt : new Uint8Array(salt);
+            return await window.crypto.subtle.deriveKey({
+                name: 'PBKDF2',
+                salt: saltBuffer,
+                iterations: iterations,
+                hash: 'SHA-256'
+            }, passwordKey, {
+                name: 'AES-GCM',
+                length: 256
+            }, false, [
+                'encrypt',
+                'decrypt'
+            ]);
+        } catch (error) {
+            throw new _errors.StorageError('密钥派生失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 从字符串导入密钥（使用 PBKDF2 派生）
+   * 
+   * 注意：如果没有提供 salt，每次调用都会生成新的 salt，导致密钥不一致。
+   * 建议在生产环境中使用固定的 salt 或从安全存储中获取。
+   */ static async importKey(keyString, salt) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new _errors.StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            // 如果没有提供 salt，尝试从 sessionStorage 获取或生成一个固定的
+            let keySalt = salt;
+            if (!keySalt) {
+                // 尝试从 sessionStorage 获取固定的 salt（用于当前会话）
+                const saltKey = '__encryption_salt__';
+                const storedSalt = sessionStorage.getItem(saltKey);
+                if (storedSalt) {
+                    // 从存储中恢复 salt
+                    const saltArray = Uint8Array.from(JSON.parse(storedSalt));
+                    keySalt = saltArray;
+                } else {
+                    // 生成新的 salt 并存储（用于当前会话）
+                    keySalt = window.crypto.getRandomValues(new Uint8Array(16));
+                    sessionStorage.setItem(saltKey, JSON.stringify(Array.from(keySalt)));
+                }
+            }
+            // 使用 PBKDF2 派生密钥
+            return await this.deriveKey(keyString, keySalt);
+        } catch (error) {
+            throw new _errors.StorageError('导入加密密钥失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 加密数据
+   */ static async encrypt(data, key) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new _errors.StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            const encoder = new TextEncoder();
+            const dataBuffer = encoder.encode(data);
+            // 生成随机 IV
+            const iv = window.crypto.getRandomValues(new Uint8Array(12));
+            const encrypted = await window.crypto.subtle.encrypt({
+                name: 'AES-GCM',
+                iv: iv
+            }, key, dataBuffer);
+            // 将 IV 和加密数据组合
+            const combined = new Uint8Array(iv.length + encrypted.byteLength);
+            combined.set(iv);
+            combined.set(new Uint8Array(encrypted), iv.length);
+            // 转换为 Base64
+            return btoa(String.fromCharCode(...combined));
+        } catch (error) {
+            throw new _errors.StorageError('加密数据失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 解密数据
+   */ static async decrypt(encryptedData, key) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new _errors.StorageError('解密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            // 从 Base64 解码
+            const combined = Uint8Array.from(atob(encryptedData), (c)=>c.charCodeAt(0));
+            // 提取 IV 和加密数据
+            const iv = combined.slice(0, 12);
+            const encrypted = combined.slice(12);
+            const decrypted = await window.crypto.subtle.decrypt({
+                name: 'AES-GCM',
+                iv: iv
+            }, key, encrypted);
+            const decoder = new TextDecoder();
+            return decoder.decode(decrypted);
+        } catch (error) {
+            throw new _errors.StorageError('解密数据失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 检查字段是否需要加密
+   */ static shouldEncrypt(key) {
+        return _security.SecurityUtils.isSensitiveField(key);
+    }
+};
+
+//# sourceMappingURL=encryption.js.map

package/dist/library/storage/encryption.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/library/storage/encryption.ts"],"sourcesContent":["import { SecurityUtils } from '../../utils/security';\nimport { StorageError } from '../../utils/errors';\n\n/**\n * 加密配置\n */\nexport interface EncryptionConfig {\n  /**\n   * 是否启用加密\n   */\n  enabled: boolean;\n  /**\n   * 加密密钥（可选，如果不提供则使用默认密钥）\n   */\n  key?: string;\n}\n\n/**\n * 加密工具类\n */\nexport class EncryptionUtils {\n\n  /**\n   * 生成加密密钥\n   */\n  static async generateKey(): Promise<CryptoKey> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      return await window.crypto.subtle.generateKey(\n        {\n          name: 'AES-GCM',\n          length: 256,\n        },\n        true,\n        ['encrypt', 'decrypt']\n      );\n    } catch (error) {\n      throw new StorageError('生成加密密钥失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 使用 PBKDF2 派生密钥\n   */\n  static async deriveKey(\n    password: string,\n    salt: Uint8Array,\n    iterations: number = 100000\n  ): Promise<CryptoKey> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      // 导入密码\n      const encoder = new TextEncoder();\n      const passwordKey = await window.crypto.subtle.importKey(\n        'raw',\n        encoder.encode(password),\n        'PBKDF2',\n        false,\n        ['deriveBits', 'deriveKey']\n      );\n\n      // 使用 PBKDF2 派生密钥\n      // 确保 salt 是 BufferSource 类型（使用类型断言）\n      const saltBuffer: BufferSource = (salt instanceof Uint8Array \n        ? salt \n        : new Uint8Array(salt)) as BufferSource;\n      return await window.crypto.subtle.deriveKey(\n        {\n          name: 'PBKDF2',\n          salt: saltBuffer,\n          iterations: iterations,\n          hash: 'SHA-256',\n        },\n        passwordKey,\n        {\n          name: 'AES-GCM',\n          length: 256,\n        },\n        false,\n        ['encrypt', 'decrypt']\n      );\n    } catch (error) {\n      throw new StorageError('密钥派生失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 从字符串导入密钥（使用 PBKDF2 派生）\n   * \n   * 注意：如果没有提供 salt，每次调用都会生成新的 salt，导致密钥不一致。\n   * 建议在生产环境中使用固定的 salt 或从安全存储中获取。\n   */\n  static async importKey(keyString: string, salt?: Uint8Array): Promise<CryptoKey> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      // 如果没有提供 salt，尝试从 sessionStorage 获取或生成一个固定的\n      let keySalt = salt;\n      \n      if (!keySalt) {\n        // 尝试从 sessionStorage 获取固定的 salt（用于当前会话）\n        const saltKey = '__encryption_salt__';\n        const storedSalt = sessionStorage.getItem(saltKey);\n        \n        if (storedSalt) {\n          // 从存储中恢复 salt\n          const saltArray = Uint8Array.from(JSON.parse(storedSalt));\n          keySalt = saltArray;\n        } else {\n          // 生成新的 salt 并存储（用于当前会话）\n          keySalt = window.crypto.getRandomValues(new Uint8Array(16));\n          sessionStorage.setItem(saltKey, JSON.stringify(Array.from(keySalt)));\n        }\n      }\n      \n      // 使用 PBKDF2 派生密钥\n      return await this.deriveKey(keyString, keySalt);\n    } catch (error) {\n      throw new StorageError('导入加密密钥失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 加密数据\n   */\n  static async encrypt(data: string, key: CryptoKey): Promise<string> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      const encoder = new TextEncoder();\n      const dataBuffer = encoder.encode(data);\n\n      // 生成随机 IV\n      const iv = window.crypto.getRandomValues(new Uint8Array(12));\n\n      const encrypted = await window.crypto.subtle.encrypt(\n        {\n          name: 'AES-GCM',\n          iv: iv,\n        },\n        key,\n        dataBuffer\n      );\n\n      // 将 IV 和加密数据组合\n      const combined = new Uint8Array(iv.length + encrypted.byteLength);\n      combined.set(iv);\n      combined.set(new Uint8Array(encrypted), iv.length);\n\n      // 转换为 Base64\n      return btoa(String.fromCharCode(...combined));\n    } catch (error) {\n      throw new StorageError('加密数据失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 解密数据\n   */\n  static async decrypt(encryptedData: string, key: CryptoKey): Promise<string> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('解密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      // 从 Base64 解码\n      const combined = Uint8Array.from(atob(encryptedData), (c) => c.charCodeAt(0));\n\n      // 提取 IV 和加密数据\n      const iv = combined.slice(0, 12);\n      const encrypted = combined.slice(12);\n\n      const decrypted = await window.crypto.subtle.decrypt(\n        {\n          name: 'AES-GCM',\n          iv: iv,\n        },\n        key,\n        encrypted\n      );\n\n      const decoder = new TextDecoder();\n      return decoder.decode(decrypted);\n    } catch (error) {\n      throw new StorageError('解密数据失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 检查字段是否需要加密\n   */\n  static shouldEncrypt(key: string): boolean {\n    return SecurityUtils.isSensitiveField(key);\n  }\n}\n"],"names":["EncryptionUtils","generateKey","window","crypto","subtle","StorageError","name","length","error","Error","undefined","deriveKey","password","salt","iterations","encoder","TextEncoder","passwordKey","importKey","encode","saltBuffer","Uint8Array","hash","keyString","keySalt","saltKey","storedSalt","sessionStorage","getItem","saltArray","from","JSON","parse","getRandomValues","setItem","stringify","Array","encrypt","data","key","dataBuffer","iv","encrypted","combined","byteLength","set","btoa","String","fromCharCode","decrypt","encryptedData","atob","c","charCodeAt","slice","decrypted","decoder","TextDecoder","decode","shouldEncrypt","SecurityUtils","isSensitiveField"],"mappings":"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"}

package/dist/library/storage/encryption.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 加密配置
+ */
+export interface EncryptionConfig {
+    /**
+     * 是否启用加密
+     */
+    enabled: boolean;
+    /**
+     * 加密密钥（可选，如果不提供则使用默认密钥）
+     */
+    key?: string;
+}
+/**
+ * 加密工具类
+ */
+export declare class EncryptionUtils {
+    /**
+     * 生成加密密钥
+     */
+    static generateKey(): Promise<CryptoKey>;
+    /**
+     * 使用 PBKDF2 派生密钥
+     */
+    static deriveKey(password: string, salt: Uint8Array, iterations?: number): Promise<CryptoKey>;
+    /**
+     * 从字符串导入密钥（使用 PBKDF2 派生）
+     *
+     * 注意：如果没有提供 salt，每次调用都会生成新的 salt，导致密钥不一致。
+     * 建议在生产环境中使用固定的 salt 或从安全存储中获取。
+     */
+    static importKey(keyString: string, salt?: Uint8Array): Promise<CryptoKey>;
+    /**
+     * 加密数据
+     */
+    static encrypt(data: string, key: CryptoKey): Promise<string>;
+    /**
+     * 解密数据
+     */
+    static decrypt(encryptedData: string, key: CryptoKey): Promise<string>;
+    /**
+     * 检查字段是否需要加密
+     */
+    static shouldEncrypt(key: string): boolean;
+}
+//# sourceMappingURL=encryption.d.ts.map

package/dist/library/storage/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../../src/library/storage/encryption.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,eAAe;IAE1B;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAmB9C;;OAEG;WACU,SAAS,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,UAAU,GAAE,MAAe,GAC1B,OAAO,CAAC,SAAS,CAAC;IAyCrB;;;;;OAKG;WACU,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAgChF;;OAEG;WACU,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCnE;;OAEG;WACU,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B5E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG3C"}

package/dist/library/storage/encryption.js

@@ -0,0 +1,142 @@
+import { SecurityUtils } from "../../utils/security";
+import { StorageError } from "../../utils/errors";
+/**
+ * 加密工具类
+ */ export class EncryptionUtils {
+    /**
+   * 生成加密密钥
+   */ static async generateKey() {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            return await window.crypto.subtle.generateKey({
+                name: 'AES-GCM',
+                length: 256
+            }, true, [
+                'encrypt',
+                'decrypt'
+            ]);
+        } catch (error) {
+            throw new StorageError('生成加密密钥失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 使用 PBKDF2 派生密钥
+   */ static async deriveKey(password, salt, iterations = 100000) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            // 导入密码
+            const encoder = new TextEncoder();
+            const passwordKey = await window.crypto.subtle.importKey('raw', encoder.encode(password), 'PBKDF2', false, [
+                'deriveBits',
+                'deriveKey'
+            ]);
+            // 使用 PBKDF2 派生密钥
+            // 确保 salt 是 BufferSource 类型（使用类型断言）
+            const saltBuffer = salt instanceof Uint8Array ? salt : new Uint8Array(salt);
+            return await window.crypto.subtle.deriveKey({
+                name: 'PBKDF2',
+                salt: saltBuffer,
+                iterations: iterations,
+                hash: 'SHA-256'
+            }, passwordKey, {
+                name: 'AES-GCM',
+                length: 256
+            }, false, [
+                'encrypt',
+                'decrypt'
+            ]);
+        } catch (error) {
+            throw new StorageError('密钥派生失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 从字符串导入密钥（使用 PBKDF2 派生）
+   * 
+   * 注意：如果没有提供 salt，每次调用都会生成新的 salt，导致密钥不一致。
+   * 建议在生产环境中使用固定的 salt 或从安全存储中获取。
+   */ static async importKey(keyString, salt) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            // 如果没有提供 salt，尝试从 sessionStorage 获取或生成一个固定的
+            let keySalt = salt;
+            if (!keySalt) {
+                // 尝试从 sessionStorage 获取固定的 salt（用于当前会话）
+                const saltKey = '__encryption_salt__';
+                const storedSalt = sessionStorage.getItem(saltKey);
+                if (storedSalt) {
+                    // 从存储中恢复 salt
+                    const saltArray = Uint8Array.from(JSON.parse(storedSalt));
+                    keySalt = saltArray;
+                } else {
+                    // 生成新的 salt 并存储（用于当前会话）
+                    keySalt = window.crypto.getRandomValues(new Uint8Array(16));
+                    sessionStorage.setItem(saltKey, JSON.stringify(Array.from(keySalt)));
+                }
+            }
+            // 使用 PBKDF2 派生密钥
+            return await this.deriveKey(keyString, keySalt);
+        } catch (error) {
+            throw new StorageError('导入加密密钥失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 加密数据
+   */ static async encrypt(data, key) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new StorageError('加密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            const encoder = new TextEncoder();
+            const dataBuffer = encoder.encode(data);
+            // 生成随机 IV
+            const iv = window.crypto.getRandomValues(new Uint8Array(12));
+            const encrypted = await window.crypto.subtle.encrypt({
+                name: 'AES-GCM',
+                iv: iv
+            }, key, dataBuffer);
+            // 将 IV 和加密数据组合
+            const combined = new Uint8Array(iv.length + encrypted.byteLength);
+            combined.set(iv);
+            combined.set(new Uint8Array(encrypted), iv.length);
+            // 转换为 Base64
+            return btoa(String.fromCharCode(...combined));
+        } catch (error) {
+            throw new StorageError('加密数据失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 解密数据
+   */ static async decrypt(encryptedData, key) {
+        if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {
+            throw new StorageError('解密功能需要浏览器支持 Web Crypto API');
+        }
+        try {
+            // 从 Base64 解码
+            const combined = Uint8Array.from(atob(encryptedData), (c)=>c.charCodeAt(0));
+            // 提取 IV 和加密数据
+            const iv = combined.slice(0, 12);
+            const encrypted = combined.slice(12);
+            const decrypted = await window.crypto.subtle.decrypt({
+                name: 'AES-GCM',
+                iv: iv
+            }, key, encrypted);
+            const decoder = new TextDecoder();
+            return decoder.decode(decrypted);
+        } catch (error) {
+            throw new StorageError('解密数据失败', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+   * 检查字段是否需要加密
+   */ static shouldEncrypt(key) {
+        return SecurityUtils.isSensitiveField(key);
+    }
+}
+
+//# sourceMappingURL=encryption.js.map

package/dist/library/storage/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/library/storage/encryption.ts"],"sourcesContent":["import { SecurityUtils } from '../../utils/security';\nimport { StorageError } from '../../utils/errors';\n\n/**\n * 加密配置\n */\nexport interface EncryptionConfig {\n  /**\n   * 是否启用加密\n   */\n  enabled: boolean;\n  /**\n   * 加密密钥（可选，如果不提供则使用默认密钥）\n   */\n  key?: string;\n}\n\n/**\n * 加密工具类\n */\nexport class EncryptionUtils {\n\n  /**\n   * 生成加密密钥\n   */\n  static async generateKey(): Promise<CryptoKey> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      return await window.crypto.subtle.generateKey(\n        {\n          name: 'AES-GCM',\n          length: 256,\n        },\n        true,\n        ['encrypt', 'decrypt']\n      );\n    } catch (error) {\n      throw new StorageError('生成加密密钥失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 使用 PBKDF2 派生密钥\n   */\n  static async deriveKey(\n    password: string,\n    salt: Uint8Array,\n    iterations: number = 100000\n  ): Promise<CryptoKey> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      // 导入密码\n      const encoder = new TextEncoder();\n      const passwordKey = await window.crypto.subtle.importKey(\n        'raw',\n        encoder.encode(password),\n        'PBKDF2',\n        false,\n        ['deriveBits', 'deriveKey']\n      );\n\n      // 使用 PBKDF2 派生密钥\n      // 确保 salt 是 BufferSource 类型（使用类型断言）\n      const saltBuffer: BufferSource = (salt instanceof Uint8Array \n        ? salt \n        : new Uint8Array(salt)) as BufferSource;\n      return await window.crypto.subtle.deriveKey(\n        {\n          name: 'PBKDF2',\n          salt: saltBuffer,\n          iterations: iterations,\n          hash: 'SHA-256',\n        },\n        passwordKey,\n        {\n          name: 'AES-GCM',\n          length: 256,\n        },\n        false,\n        ['encrypt', 'decrypt']\n      );\n    } catch (error) {\n      throw new StorageError('密钥派生失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 从字符串导入密钥（使用 PBKDF2 派生）\n   * \n   * 注意：如果没有提供 salt，每次调用都会生成新的 salt，导致密钥不一致。\n   * 建议在生产环境中使用固定的 salt 或从安全存储中获取。\n   */\n  static async importKey(keyString: string, salt?: Uint8Array): Promise<CryptoKey> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      // 如果没有提供 salt，尝试从 sessionStorage 获取或生成一个固定的\n      let keySalt = salt;\n      \n      if (!keySalt) {\n        // 尝试从 sessionStorage 获取固定的 salt（用于当前会话）\n        const saltKey = '__encryption_salt__';\n        const storedSalt = sessionStorage.getItem(saltKey);\n        \n        if (storedSalt) {\n          // 从存储中恢复 salt\n          const saltArray = Uint8Array.from(JSON.parse(storedSalt));\n          keySalt = saltArray;\n        } else {\n          // 生成新的 salt 并存储（用于当前会话）\n          keySalt = window.crypto.getRandomValues(new Uint8Array(16));\n          sessionStorage.setItem(saltKey, JSON.stringify(Array.from(keySalt)));\n        }\n      }\n      \n      // 使用 PBKDF2 派生密钥\n      return await this.deriveKey(keyString, keySalt);\n    } catch (error) {\n      throw new StorageError('导入加密密钥失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 加密数据\n   */\n  static async encrypt(data: string, key: CryptoKey): Promise<string> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('加密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      const encoder = new TextEncoder();\n      const dataBuffer = encoder.encode(data);\n\n      // 生成随机 IV\n      const iv = window.crypto.getRandomValues(new Uint8Array(12));\n\n      const encrypted = await window.crypto.subtle.encrypt(\n        {\n          name: 'AES-GCM',\n          iv: iv,\n        },\n        key,\n        dataBuffer\n      );\n\n      // 将 IV 和加密数据组合\n      const combined = new Uint8Array(iv.length + encrypted.byteLength);\n      combined.set(iv);\n      combined.set(new Uint8Array(encrypted), iv.length);\n\n      // 转换为 Base64\n      return btoa(String.fromCharCode(...combined));\n    } catch (error) {\n      throw new StorageError('加密数据失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 解密数据\n   */\n  static async decrypt(encryptedData: string, key: CryptoKey): Promise<string> {\n    if (typeof window === 'undefined' || !window.crypto || !window.crypto.subtle) {\n      throw new StorageError('解密功能需要浏览器支持 Web Crypto API');\n    }\n\n    try {\n      // 从 Base64 解码\n      const combined = Uint8Array.from(atob(encryptedData), (c) => c.charCodeAt(0));\n\n      // 提取 IV 和加密数据\n      const iv = combined.slice(0, 12);\n      const encrypted = combined.slice(12);\n\n      const decrypted = await window.crypto.subtle.decrypt(\n        {\n          name: 'AES-GCM',\n          iv: iv,\n        },\n        key,\n        encrypted\n      );\n\n      const decoder = new TextDecoder();\n      return decoder.decode(decrypted);\n    } catch (error) {\n      throw new StorageError('解密数据失败', error instanceof Error ? error : undefined);\n    }\n  }\n\n  /**\n   * 检查字段是否需要加密\n   */\n  static shouldEncrypt(key: string): boolean {\n    return SecurityUtils.isSensitiveField(key);\n  }\n}\n"],"names":["SecurityUtils","StorageError","EncryptionUtils","generateKey","window","crypto","subtle","name","length","error","Error","undefined","deriveKey","password","salt","iterations","encoder","TextEncoder","passwordKey","importKey","encode","saltBuffer","Uint8Array","hash","keyString","keySalt","saltKey","storedSalt","sessionStorage","getItem","saltArray","from","JSON","parse","getRandomValues","setItem","stringify","Array","encrypt","data","key","dataBuffer","iv","encrypted","combined","byteLength","set","btoa","String","fromCharCode","decrypt","encryptedData","atob","c","charCodeAt","slice","decrypted","decoder","TextDecoder","decode","shouldEncrypt","isSensitiveField"],"mappings":"AAAA,SAASA,aAAa,QAAQ,uBAAuB;AACrD,SAASC,YAAY,QAAQ,qBAAqB;AAgBlD;;CAEC,GACD,OAAO,MAAMC;IAEX;;GAEC,GACD,aAAaC,cAAkC;QAC7C,IAAI,OAAOC,WAAW,eAAe,CAACA,OAAOC,MAAM,IAAI,CAACD,OAAOC,MAAM,CAACC,MAAM,EAAE;YAC5E,MAAM,IAAIL,aAAa;QACzB;QAEA,IAAI;YACF,OAAO,MAAMG,OAAOC,MAAM,CAACC,MAAM,CAACH,WAAW,CAC3C;gBACEI,MAAM;gBACNC,QAAQ;YACV,GACA,MACA;gBAAC;gBAAW;aAAU;QAE1B,EAAE,OAAOC,OAAO;YACd,MAAM,IAAIR,aAAa,YAAYQ,iBAAiBC,QAAQD,QAAQE;QACtE;IACF;IAEA;;GAEC,GACD,aAAaC,UACXC,QAAgB,EAChBC,IAAgB,EAChBC,aAAqB,MAAM,EACP;QACpB,IAAI,OAAOX,WAAW,eAAe,CAACA,OAAOC,MAAM,IAAI,CAACD,OAAOC,MAAM,CAACC,MAAM,EAAE;YAC5E,MAAM,IAAIL,aAAa;QACzB;QAEA,IAAI;YACF,OAAO;YACP,MAAMe,UAAU,IAAIC;YACpB,MAAMC,cAAc,MAAMd,OAAOC,MAAM,CAACC,MAAM,CAACa,SAAS,CACtD,OACAH,QAAQI,MAAM,CAACP,WACf,UACA,OACA;gBAAC;gBAAc;aAAY;YAG7B,iBAAiB;YACjB,oCAAoC;YACpC,MAAMQ,aAA4BP,gBAAgBQ,aAC9CR,OACA,IAAIQ,WAAWR;YACnB,OAAO,MAAMV,OAAOC,MAAM,CAACC,MAAM,CAACM,SAAS,CACzC;gBACEL,MAAM;gBACNO,MAAMO;gBACNN,YAAYA;gBACZQ,MAAM;YACR,GACAL,aACA;gBACEX,MAAM;gBACNC,QAAQ;YACV,GACA,OACA;gBAAC;gBAAW;aAAU;QAE1B,EAAE,OAAOC,OAAO;YACd,MAAM,IAAIR,aAAa,UAAUQ,iBAAiBC,QAAQD,QAAQE;QACpE;IACF;IAEA;;;;;GAKC,GACD,aAAaQ,UAAUK,SAAiB,EAAEV,IAAiB,EAAsB;QAC/E,IAAI,OAAOV,WAAW,eAAe,CAACA,OAAOC,MAAM,IAAI,CAACD,OAAOC,MAAM,CAACC,MAAM,EAAE;YAC5E,MAAM,IAAIL,aAAa;QACzB;QAEA,IAAI;YACF,4CAA4C;YAC5C,IAAIwB,UAAUX;YAEd,IAAI,CAACW,SAAS;gBACZ,wCAAwC;gBACxC,MAAMC,UAAU;gBAChB,MAAMC,aAAaC,eAAeC,OAAO,CAACH;gBAE1C,IAAIC,YAAY;oBACd,cAAc;oBACd,MAAMG,YAAYR,WAAWS,IAAI,CAACC,KAAKC,KAAK,CAACN;oBAC7CF,UAAUK;gBACZ,OAAO;oBACL,wBAAwB;oBACxBL,UAAUrB,OAAOC,MAAM,CAAC6B,eAAe,CAAC,IAAIZ,WAAW;oBACvDM,eAAeO,OAAO,CAACT,SAASM,KAAKI,SAAS,CAACC,MAAMN,IAAI,CAACN;gBAC5D;YACF;YAEA,iBAAiB;YACjB,OAAO,MAAM,IAAI,CAACb,SAAS,CAACY,WAAWC;QACzC,EAAE,OAAOhB,OAAO;YACd,MAAM,IAAIR,aAAa,YAAYQ,iBAAiBC,QAAQD,QAAQE;QACtE;IACF;IAEA;;GAEC,GACD,aAAa2B,QAAQC,IAAY,EAAEC,GAAc,EAAmB;QAClE,IAAI,OAAOpC,WAAW,eAAe,CAACA,OAAOC,MAAM,IAAI,CAACD,OAAOC,MAAM,CAACC,MAAM,EAAE;YAC5E,MAAM,IAAIL,aAAa;QACzB;QAEA,IAAI;YACF,MAAMe,UAAU,IAAIC;YACpB,MAAMwB,aAAazB,QAAQI,MAAM,CAACmB;YAElC,UAAU;YACV,MAAMG,KAAKtC,OAAOC,MAAM,CAAC6B,eAAe,CAAC,IAAIZ,WAAW;YAExD,MAAMqB,YAAY,MAAMvC,OAAOC,MAAM,CAACC,MAAM,CAACgC,OAAO,CAClD;gBACE/B,MAAM;gBACNmC,IAAIA;YACN,GACAF,KACAC;YAGF,eAAe;YACf,MAAMG,WAAW,IAAItB,WAAWoB,GAAGlC,MAAM,GAAGmC,UAAUE,UAAU;YAChED,SAASE,GAAG,CAACJ;YACbE,SAASE,GAAG,CAAC,IAAIxB,WAAWqB,YAAYD,GAAGlC,MAAM;YAEjD,aAAa;YACb,OAAOuC,KAAKC,OAAOC,YAAY,IAAIL;QACrC,EAAE,OAAOnC,OAAO;YACd,MAAM,IAAIR,aAAa,UAAUQ,iBAAiBC,QAAQD,QAAQE;QACpE;IACF;IAEA;;GAEC,GACD,aAAauC,QAAQC,aAAqB,EAAEX,GAAc,EAAmB;QAC3E,IAAI,OAAOpC,WAAW,eAAe,CAACA,OAAOC,MAAM,IAAI,CAACD,OAAOC,MAAM,CAACC,MAAM,EAAE;YAC5E,MAAM,IAAIL,aAAa;QACzB;QAEA,IAAI;YACF,cAAc;YACd,MAAM2C,WAAWtB,WAAWS,IAAI,CAACqB,KAAKD,gBAAgB,CAACE,IAAMA,EAAEC,UAAU,CAAC;YAE1E,cAAc;YACd,MAAMZ,KAAKE,SAASW,KAAK,CAAC,GAAG;YAC7B,MAAMZ,YAAYC,SAASW,KAAK,CAAC;YAEjC,MAAMC,YAAY,MAAMpD,OAAOC,MAAM,CAACC,MAAM,CAAC4C,OAAO,CAClD;gBACE3C,MAAM;gBACNmC,IAAIA;YACN,GACAF,KACAG;YAGF,MAAMc,UAAU,IAAIC;YACpB,OAAOD,QAAQE,MAAM,CAACH;QACxB,EAAE,OAAO/C,OAAO;YACd,MAAM,IAAIR,aAAa,UAAUQ,iBAAiBC,QAAQD,QAAQE;QACpE;IACF;IAEA;;GAEC,GACD,OAAOiD,cAAcpB,GAAW,EAAW;QACzC,OAAOxC,cAAc6D,gBAAgB,CAACrB;IACxC;AACF"}

package/dist/library/storage/index.cjs

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get EncryptionUtils () {
+        return _encryption.EncryptionUtils;
+    },
+    get MultiLevelCache () {
+        return _cache.MultiLevelCache;
+    },
+    get storage () {
+        return storage;
+    }
+});
+const _utils = require("@vlian/utils");
+const _cache = require("./cache");
+const _encryption = require("./encryption");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let Storage = class Storage {
+    get local() {
+        return this._local;
+    }
+    get session() {
+        return this._session;
+    }
+    get indexedDB() {
+        return this._indexedDB;
+    }
+    /**
+     * 获取本地存储缓存
+     */ get localCache() {
+        return this._localCache;
+    }
+    /**
+     * 获取会话存储缓存
+     */ get sessionCache() {
+        return this._sessionCache;
+    }
+    /**
+   * 获取单例实例
+   * 
+   * @returns Singleton 实例
+   */ static getInstance() {
+        if (!Storage.instance) {
+            Storage.instance = new Storage();
+        }
+        return Storage.instance;
+    }
+    initialize(options) {
+        const local = (0, _utils.createStorage)({
+            type: 'local',
+            prefix: options?.prefix || 'vlian',
+            defaultExpire: options?.defaultExpire || 24 * 60 * 60 * 1000
+        });
+        const session = (0, _utils.createStorage)({
+            type: 'session',
+            prefix: options?.prefix || 'vlian',
+            defaultExpire: options?.defaultExpire || 24 * 60 * 60 * 1000
+        });
+        const indexedDB = (0, _utils.createStorage)({
+            type: 'indexedDB',
+            prefix: options?.prefix || 'vlian',
+            defaultExpire: options?.defaultExpire || 24 * 60 * 60 * 1000,
+            dbName: options?.tableName
+        });
+        this._local = local;
+        this._session = session;
+        this._indexedDB = indexedDB;
+        // 初始化缓存
+        this.cacheEnabled = options?.cache?.enabled ?? false;
+        if (this.cacheEnabled) {
+            this._localCache = new _cache.MultiLevelCache(local, {
+                defaultTTL: options?.cache?.defaultTTL,
+                maxSize: options?.cache?.maxSize
+            });
+            this._sessionCache = new _cache.MultiLevelCache(session, {
+                defaultTTL: options?.cache?.defaultTTL,
+                maxSize: options?.cache?.maxSize
+            });
+        }
+    }
+    /**
+     * 清理过期缓存
+     */ async cleanupCache() {
+        if (this._localCache) {
+            await this._localCache.cleanup();
+        }
+        if (this._sessionCache) {
+            await this._sessionCache.cleanup();
+        }
+    }
+    /**
+     * 私有构造函数，防止外部直接实例化
+     */ constructor(){
+        _define_property(this, "_local", void 0);
+        _define_property(this, "_session", void 0);
+        _define_property(this, "_indexedDB", void 0);
+        _define_property(this, "_localCache", void 0);
+        _define_property(this, "_sessionCache", void 0);
+        _define_property(this, "cacheEnabled", false);
+    // 私有构造函数
+    }
+};
+_define_property(Storage, "instance", null);
+const storage = Storage.getInstance();
+
+//# sourceMappingURL=index.js.map

package/dist/library/storage/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/library/storage/index.ts"],"sourcesContent":["import { createStorage } from '@vlian/utils';\nimport type { StorageInstance } from '@vlian/utils';\nimport type { StorageOptions } from '../../types';\nimport type { EncryptionConfig } from './encryption';\nimport { MultiLevelCache } from './cache';\n\n/**\n * 增强的存储选项\n */\nexport interface EnhancedStorageOptions extends StorageOptions {\n  /**\n   * 加密配置\n   */\n  encryption?: EncryptionConfig;\n  /**\n   * 缓存配置\n   */\n  cache?: {\n    enabled?: boolean;\n    defaultTTL?: number;\n    maxSize?: number;\n  };\n}\n\nclass Storage {\n    private static instance: Storage | null = null;\n\n    private _local!: StorageInstance;\n    private _session!: StorageInstance;\n    private _indexedDB!: StorageInstance;\n    private _localCache?: MultiLevelCache;\n    private _sessionCache?: MultiLevelCache;\n    private cacheEnabled: boolean = false;\n\n    public get local(): StorageInstance {\n        return this._local;\n    }\n\n    public get session(): StorageInstance {\n        return this._session;\n    }\n\n    public get indexedDB(): StorageInstance {\n        return this._indexedDB;\n    }\n\n    /**\n     * 获取本地存储缓存\n     */\n    public get localCache(): MultiLevelCache | undefined {\n        return this._localCache;\n    }\n\n    /**\n     * 获取会话存储缓存\n     */\n    public get sessionCache(): MultiLevelCache | undefined {\n        return this._sessionCache;\n    }\n\n    /**\n     * 私有构造函数，防止外部直接实例化\n     */\n    private constructor() {\n        // 私有构造函数\n    }\n\n    /**\n   * 获取单例实例\n   * \n   * @returns Singleton 实例\n   */\n    public static getInstance(): Storage {\n        if (!Storage.instance) {\n            Storage.instance = new Storage();\n        }\n        return Storage.instance;\n    }\n\n    public initialize(options?: EnhancedStorageOptions): void {\n        const local = createStorage({\n            type: 'local',\n            prefix: options?.prefix || 'vlian',\n            defaultExpire: options?.defaultExpire || 24 * 60 * 60 * 1000,\n        });\n        const session = createStorage({\n            type: 'session',\n            prefix: options?.prefix || 'vlian',\n            defaultExpire: options?.defaultExpire || 24 * 60 * 60 * 1000,\n        });\n        const indexedDB = createStorage({\n            type: 'indexedDB',\n            prefix: options?.prefix || 'vlian',\n            defaultExpire: options?.defaultExpire || 24 * 60 * 60 * 1000,\n            dbName: options?.tableName,\n        });\n\n        this._local = local;\n        this._session = session;\n        this._indexedDB = indexedDB;\n\n        // 初始化缓存\n        this.cacheEnabled = options?.cache?.enabled ?? false;\n        if (this.cacheEnabled) {\n            this._localCache = new MultiLevelCache(local, {\n                defaultTTL: options?.cache?.defaultTTL,\n                maxSize: options?.cache?.maxSize,\n            });\n            this._sessionCache = new MultiLevelCache(session, {\n                defaultTTL: options?.cache?.defaultTTL,\n                maxSize: options?.cache?.maxSize,\n            });\n        }\n    }\n\n    /**\n     * 清理过期缓存\n     */\n    public async cleanupCache(): Promise<void> {\n        if (this._localCache) {\n            await this._localCache.cleanup();\n        }\n        if (this._sessionCache) {\n            await this._sessionCache.cleanup();\n        }\n    }\n}\n\nexport const storage = Storage.getInstance();\n\n// 导出加密和缓存相关类型\nexport type { EncryptionConfig } from './encryption';\nexport type { CacheConfig } from './cache';\nexport { MultiLevelCache } from './cache';\nexport { EncryptionUtils } from './encryption';"],"names":["EncryptionUtils","MultiLevelCache","storage","Storage","local","_local","session","_session","indexedDB","_indexedDB","localCache","_localCache","sessionCache","_sessionCache","getInstance","instance","initialize","options","createStorage","type","prefix","defaultExpire","dbName","tableName","cacheEnabled","cache","enabled","defaultTTL","maxSize","cleanupCache","cleanup"],"mappings":";;;;;;;;;;;QAsISA;eAAAA,2BAAe;;QADfC;eAAAA,sBAAe;;QALXC;eAAAA;;;uBAhIiB;uBAIE;4BAkIA;;;;;;;;;;;;;;AA9GhC,IAAA,AAAMC,UAAN,MAAMA;IAUF,IAAWC,QAAyB;QAChC,OAAO,IAAI,CAACC,MAAM;IACtB;IAEA,IAAWC,UAA2B;QAClC,OAAO,IAAI,CAACC,QAAQ;IACxB;IAEA,IAAWC,YAA6B;QACpC,OAAO,IAAI,CAACC,UAAU;IAC1B;IAEA;;KAEC,GACD,IAAWC,aAA0C;QACjD,OAAO,IAAI,CAACC,WAAW;IAC3B;IAEA;;KAEC,GACD,IAAWC,eAA4C;QACnD,OAAO,IAAI,CAACC,aAAa;IAC7B;IASA;;;;GAID,GACC,OAAcC,cAAuB;QACjC,IAAI,CAACX,QAAQY,QAAQ,EAAE;YACnBZ,QAAQY,QAAQ,GAAG,IAAIZ;QAC3B;QACA,OAAOA,QAAQY,QAAQ;IAC3B;IAEOC,WAAWC,OAAgC,EAAQ;QACtD,MAAMb,QAAQc,IAAAA,oBAAa,EAAC;YACxBC,MAAM;YACNC,QAAQH,SAASG,UAAU;YAC3BC,eAAeJ,SAASI,iBAAiB,KAAK,KAAK,KAAK;QAC5D;QACA,MAAMf,UAAUY,IAAAA,oBAAa,EAAC;YAC1BC,MAAM;YACNC,QAAQH,SAASG,UAAU;YAC3BC,eAAeJ,SAASI,iBAAiB,KAAK,KAAK,KAAK;QAC5D;QACA,MAAMb,YAAYU,IAAAA,oBAAa,EAAC;YAC5BC,MAAM;YACNC,QAAQH,SAASG,UAAU;YAC3BC,eAAeJ,SAASI,iBAAiB,KAAK,KAAK,KAAK;YACxDC,QAAQL,SAASM;QACrB;QAEA,IAAI,CAAClB,MAAM,GAAGD;QACd,IAAI,CAACG,QAAQ,GAAGD;QAChB,IAAI,CAACG,UAAU,GAAGD;QAElB,QAAQ;QACR,IAAI,CAACgB,YAAY,GAAGP,SAASQ,OAAOC,WAAW;QAC/C,IAAI,IAAI,CAACF,YAAY,EAAE;YACnB,IAAI,CAACb,WAAW,GAAG,IAAIV,sBAAe,CAACG,OAAO;gBAC1CuB,YAAYV,SAASQ,OAAOE;gBAC5BC,SAASX,SAASQ,OAAOG;YAC7B;YACA,IAAI,CAACf,aAAa,GAAG,IAAIZ,sBAAe,CAACK,SAAS;gBAC9CqB,YAAYV,SAASQ,OAAOE;gBAC5BC,SAASX,SAASQ,OAAOG;YAC7B;QACJ;IACJ;IAEA;;KAEC,GACD,MAAaC,eAA8B;QACvC,IAAI,IAAI,CAAClB,WAAW,EAAE;YAClB,MAAM,IAAI,CAACA,WAAW,CAACmB,OAAO;QAClC;QACA,IAAI,IAAI,CAACjB,aAAa,EAAE;YACpB,MAAM,IAAI,CAACA,aAAa,CAACiB,OAAO;QACpC;IACJ;IAjEA;;KAEC,GACD,aAAsB;QApCtB,uBAAQzB,UAAR,KAAA;QACA,uBAAQE,YAAR,KAAA;QACA,uBAAQE,cAAR,KAAA;QACA,uBAAQE,eAAR,KAAA;QACA,uBAAQE,iBAAR,KAAA;QACA,uBAAQW,gBAAwB;IAgC5B,SAAS;IACb;AA6DJ;AArGI,iBADErB,SACaY,YAA2B;AAuGvC,MAAMb,UAAUC,QAAQW,WAAW"}

package/dist/library/storage/index.d.ts

@@ -0,0 +1,62 @@
+import type { StorageInstance } from '@vlian/utils';
+import type { StorageOptions } from '../../types';
+import type { EncryptionConfig } from './encryption';
+import { MultiLevelCache } from './cache';
+/**
+ * 增强的存储选项
+ */
+export interface EnhancedStorageOptions extends StorageOptions {
+    /**
+     * 加密配置
+     */
+    encryption?: EncryptionConfig;
+    /**
+     * 缓存配置
+     */
+    cache?: {
+        enabled?: boolean;
+        defaultTTL?: number;
+        maxSize?: number;
+    };
+}
+declare class Storage {
+    private static instance;
+    private _local;
+    private _session;
+    private _indexedDB;
+    private _localCache?;
+    private _sessionCache?;
+    private cacheEnabled;
+    get local(): StorageInstance;
+    get session(): StorageInstance;
+    get indexedDB(): StorageInstance;
+    /**
+     * 获取本地存储缓存
+     */
+    get localCache(): MultiLevelCache | undefined;
+    /**
+     * 获取会话存储缓存
+     */
+    get sessionCache(): MultiLevelCache | undefined;
+    /**
+     * 私有构造函数，防止外部直接实例化
+     */
+    private constructor();
+    /**
+   * 获取单例实例
+   *
+   * @returns Singleton 实例
+   */
+    static getInstance(): Storage;
+    initialize(options?: EnhancedStorageOptions): void;
+    /**
+     * 清理过期缓存
+     */
+    cleanupCache(): Promise<void>;
+}
+export declare const storage: Storage;
+export type { EncryptionConfig } from './encryption';
+export type { CacheConfig } from './cache';
+export { MultiLevelCache } from './cache';
+export { EncryptionUtils } from './encryption';
+//# sourceMappingURL=index.d.ts.map

package/dist/library/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/library/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,cAAM,OAAO;IACT,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwB;IAE/C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAkB;IAEtC,IAAW,KAAK,IAAI,eAAe,CAElC;IAED,IAAW,OAAO,IAAI,eAAe,CAEpC;IAED,IAAW,SAAS,IAAI,eAAe,CAEtC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,eAAe,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,eAAe,GAAG,SAAS,CAErD;IAED;;OAEG;IACH,OAAO;IAIP;;;;KAIC;WACa,WAAW,IAAI,OAAO;IAO7B,UAAU,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAoCzD;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7C;AAED,eAAO,MAAM,OAAO,SAAwB,CAAC;AAG7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}