@jayfong/x-server 2.65.0 → 2.67.0

package/lib/_cjs/services/crypto.js

@@ -138,5 +138,38 @@ class CryptoService {
     decrypted += decipher.final('utf8');
     return decrypted;
   }
+
+  /**
+   * 使用AES加密算法对JSON数据进行加密
+   *
+   * 该方法首先将payload参数序列化为JSON字符串，然后使用指定的密钥进行AES加密
+   * 主要用于在传输敏感信息前，对数据进行加密处理，以确保数据的安全性
+   *
+   * @param payload 任何类型的对象，代表需要加密的原始数据
+   * @param key 字符串类型的密钥，用于AES加密算法
+   *            密钥需要符合AES加密算法的长度要求
+   * @returns 返回加密后的字符串数据
+   *          加密后的数据可以安全地进行网络传输或存储
+   */
+  aesEncryptJson(payload, key) {
+    // 将payload对象序列化为JSON字符串，以便进行加密处理
+    // 使用指定的密钥对序列化后的JSON字符串进行AES加密
+    // 返回加密后的数据，确保数据在传输或存储过程中的安全性
+    return this.aesEncrypt(JSON.stringify(payload), key);
+  }
+
+  /**
+   * 使用AES算法解密给定的文本，并将解密后的结果解析为JSON对象
+   *
+   * @param text 需要解密的加密文本
+   * @param key 解密用的密钥，必须与加密时使用的密钥相同
+   * @returns 返回解密后的JSON对象，类型为泛型T，根据调用时指定的类型解析
+   */
+  aesDecryptJson(text, key) {
+    // 使用指定的密钥对给定的加密数据进行AES解密
+    // 将解密后的数据反序列化为JSON对象，以便后续的处理
+    // 返回解密后的数据，确保数据在传输或存储过程中的安全性
+    return JSON.parse(this.aesDecrypt(text, key));
+  }
 }
 exports.CryptoService = CryptoService;

package/lib/services/crypto.d.ts

@@ -81,6 +81,27 @@ export declare class CryptoService implements BaseService {
      * @param key - 用于解密的密钥（仅支持16字节的密钥）。
      */
     aesDecrypt(text: string, key: string): string;
+    /**
+     * 使用AES加密算法对JSON数据进行加密
+     *
+     * 该方法首先将payload参数序列化为JSON字符串，然后使用指定的密钥进行AES加密
+     * 主要用于在传输敏感信息前，对数据进行加密处理，以确保数据的安全性
+     *
+     * @param payload 任何类型的对象，代表需要加密的原始数据
+     * @param key 字符串类型的密钥，用于AES加密算法
+     *            密钥需要符合AES加密算法的长度要求
+     * @returns 返回加密后的字符串数据
+     *          加密后的数据可以安全地进行网络传输或存储
+     */
+    aesEncryptJson(payload: any, key: string): string;
+    /**
+     * 使用AES算法解密给定的文本，并将解密后的结果解析为JSON对象
+     *
+     * @param text 需要解密的加密文本
+     * @param key 解密用的密钥，必须与加密时使用的密钥相同
+     * @returns 返回解密后的JSON对象，类型为泛型T，根据调用时指定的类型解析
+     */
+    aesDecryptJson<T>(text: string, key: string): T;
 }
 declare module '../x' {
     interface X {

package/lib/services/crypto.js

@@ -133,4 +133,37 @@ export class CryptoService {
     decrypted += decipher.final('utf8');
     return decrypted;
   }
+
+  /**
+   * 使用AES加密算法对JSON数据进行加密
+   *
+   * 该方法首先将payload参数序列化为JSON字符串，然后使用指定的密钥进行AES加密
+   * 主要用于在传输敏感信息前，对数据进行加密处理，以确保数据的安全性
+   *
+   * @param payload 任何类型的对象，代表需要加密的原始数据
+   * @param key 字符串类型的密钥，用于AES加密算法
+   *            密钥需要符合AES加密算法的长度要求
+   * @returns 返回加密后的字符串数据
+   *          加密后的数据可以安全地进行网络传输或存储
+   */
+  aesEncryptJson(payload, key) {
+    // 将payload对象序列化为JSON字符串，以便进行加密处理
+    // 使用指定的密钥对序列化后的JSON字符串进行AES加密
+    // 返回加密后的数据，确保数据在传输或存储过程中的安全性
+    return this.aesEncrypt(JSON.stringify(payload), key);
+  }
+
+  /**
+   * 使用AES算法解密给定的文本，并将解密后的结果解析为JSON对象
+   *
+   * @param text 需要解密的加密文本
+   * @param key 解密用的密钥，必须与加密时使用的密钥相同
+   * @returns 返回解密后的JSON对象，类型为泛型T，根据调用时指定的类型解析
+   */
+  aesDecryptJson(text, key) {
+    // 使用指定的密钥对给定的加密数据进行AES解密
+    // 将解密后的数据反序列化为JSON对象，以便后续的处理
+    // 返回解密后的数据，确保数据在传输或存储过程中的安全性
+    return JSON.parse(this.aesDecrypt(text, key));
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayfong/x-server",
-  "version": "2.65.0",
+  "version": "2.67.0",
   "license": "ISC",
   "sideEffects": false,
   "main": "lib/_cjs/index.js",