@alibarbar/common 1.0.10 → 1.1.0

package/dist/storage.d.mts

@@ -15,6 +15,39 @@ interface StorageOptions {
     /** 是否启用加密，默认为 true */
     encrypt?: boolean;
 }
+/**
+ * 存储初始化配置
+ */
+interface StorageInitOptions {
+    /** 是否自动生成密钥对（如果未设置），默认为 true */
+    autoGenerateKeys?: boolean;
+    /** 是否持久化密钥到 localStorage，默认为 false */
+    persistKeys?: boolean;
+    /** 密钥存储键名（用于持久化），如果未提供将自动生成随机键名 */
+    keyStorageKey?: string;
+    /** 用于加密持久化私钥的密码（如果提供，将使用 PBKDF2 + AES-GCM 加密） */
+    keyEncryptionPassword?: string;
+    /** PBKDF2 迭代次数，默认为 100000 */
+    pbkdf2Iterations?: number;
+    /** RSA密钥长度，默认为 2048 */
+    keyModulusLength?: number;
+    /** 是否启用HMAC数据完整性校验，默认为 true */
+    enableHMAC?: boolean;
+    /** 是否启用时间戳验证（防重放攻击），默认为 true */
+    enableTimestampValidation?: boolean;
+    /** 时间戳有效期（毫秒），默认 7 天，0 表示不验证 */
+    timestampMaxAge?: number;
+    /** 是否为生产环境（影响日志输出），默认为 false */
+    isProduction?: boolean;
+    /** 是否强制重新初始化（即使已经初始化过），默认为 false */
+    forceReinitialize?: boolean;
+}
+/**
+ * 初始化存储密钥对
+ * @param options - 初始化选项
+ * @returns Promise<void>
+ */
+declare function initializeStorageKeys(options?: StorageInitOptions): Promise<void>;
 /**
  * 设置全局RSA密钥对
  * @param keyPair - RSA密钥对
@@ -25,6 +58,18 @@ declare function setStorageKeyPair(keyPair: RSAKeyPair): void;
  * @returns 全局密钥对或null
  */
 declare function getStorageKeyPair(): RSAKeyPair | null;
+/**
+ * 清除持久化的密钥（如果存在）
+ */
+declare function clearPersistedKeys(): void;
+/**
+ * 获取密钥使用计数
+ */
+declare function getKeyUsageCount(): number;
+/**
+ * 重置密钥使用计数
+ */
+declare function resetKeyUsageCount(): void;
 /**
  * localStorage封装（支持过期时间和RSA加密）
  */
@@ -173,4 +218,4 @@ declare const storage: {
     clear(): void;
 };
 
-export { type StorageOptions, cookie, getStorageKeyPair, localStorage, sessionStorage, setStorageKeyPair, storage };
+export { type StorageInitOptions, type StorageOptions, clearPersistedKeys, cookie, getKeyUsageCount, getStorageKeyPair, initializeStorageKeys, localStorage, resetKeyUsageCount, sessionStorage, setStorageKeyPair, storage };

package/dist/storage.d.ts

@@ -15,6 +15,39 @@ interface StorageOptions {
     /** 是否启用加密，默认为 true */
     encrypt?: boolean;
 }
+/**
+ * 存储初始化配置
+ */
+interface StorageInitOptions {
+    /** 是否自动生成密钥对（如果未设置），默认为 true */
+    autoGenerateKeys?: boolean;
+    /** 是否持久化密钥到 localStorage，默认为 false */
+    persistKeys?: boolean;
+    /** 密钥存储键名（用于持久化），如果未提供将自动生成随机键名 */
+    keyStorageKey?: string;
+    /** 用于加密持久化私钥的密码（如果提供，将使用 PBKDF2 + AES-GCM 加密） */
+    keyEncryptionPassword?: string;
+    /** PBKDF2 迭代次数，默认为 100000 */
+    pbkdf2Iterations?: number;
+    /** RSA密钥长度，默认为 2048 */
+    keyModulusLength?: number;
+    /** 是否启用HMAC数据完整性校验，默认为 true */
+    enableHMAC?: boolean;
+    /** 是否启用时间戳验证（防重放攻击），默认为 true */
+    enableTimestampValidation?: boolean;
+    /** 时间戳有效期（毫秒），默认 7 天，0 表示不验证 */
+    timestampMaxAge?: number;
+    /** 是否为生产环境（影响日志输出），默认为 false */
+    isProduction?: boolean;
+    /** 是否强制重新初始化（即使已经初始化过），默认为 false */
+    forceReinitialize?: boolean;
+}
+/**
+ * 初始化存储密钥对
+ * @param options - 初始化选项
+ * @returns Promise<void>
+ */
+declare function initializeStorageKeys(options?: StorageInitOptions): Promise<void>;
 /**
  * 设置全局RSA密钥对
  * @param keyPair - RSA密钥对
@@ -25,6 +58,18 @@ declare function setStorageKeyPair(keyPair: RSAKeyPair): void;
  * @returns 全局密钥对或null
  */
 declare function getStorageKeyPair(): RSAKeyPair | null;
+/**
+ * 清除持久化的密钥（如果存在）
+ */
+declare function clearPersistedKeys(): void;
+/**
+ * 获取密钥使用计数
+ */
+declare function getKeyUsageCount(): number;
+/**
+ * 重置密钥使用计数
+ */
+declare function resetKeyUsageCount(): void;
 /**
  * localStorage封装（支持过期时间和RSA加密）
  */
@@ -173,4 +218,4 @@ declare const storage: {
     clear(): void;
 };
 
-export { type StorageOptions, cookie, getStorageKeyPair, localStorage, sessionStorage, setStorageKeyPair, storage };
+export { type StorageInitOptions, type StorageOptions, clearPersistedKeys, cookie, getKeyUsageCount, getStorageKeyPair, initializeStorageKeys, localStorage, resetKeyUsageCount, sessionStorage, setStorageKeyPair, storage };