qsh-webview-sdk 2.0.2 → 2.0.4

package/README.md

@@ -33,7 +33,7 @@ npm install qsh-webview-sdk
 <!-- 微信小程序环境（可选）-->
 <script type="text/javascript">
   if (/miniProgram/i.test(navigator.userAgent) && /micromessenger/i.test(navigator.userAgent)) {
-    document.write('<script src="https://res.wx.qq.com/open/js/jweixin-1.4.0.js"><\/script>');
+    document.write('<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"><\/script>');
   }
 </script>
 
@@ -115,6 +115,45 @@ console.log('是否微信小程序:', env.isWeixinMiniProgram);
 console.log('是否 APP:', env.isAppPlus);
 ```
 
+### 加密能力（SM2/SM3/SM4）
+
+- 已内置并通过 `qsh.crypto` 暴露以下能力：`sm2`（密钥对/加解密/签名验签）、`sm3`（杂凑/HMAC）、`sm4`（对称加解密）。
+- 参考实现来源：[miniprogram-sm-crypto（GitHub）](https://github.com/wechat-miniprogram/sm-crypto)。
+
+#### ESM 使用
+
+```javascript
+import qsh from 'qsh-webview-sdk';
+
+// SM3 杂凑
+const hash = qsh.crypto.sm3Hash('abc');
+
+// SM2：生成密钥对 + 签名 + 验签（示例使用 DER 编码）
+const { publicKey, privateKey } = qsh.crypto.sm2GenerateKeyPair();
+const sig = qsh.crypto.sm2Sign('hello sm2', privateKey, { der: true });
+const ok = qsh.crypto.sm2Verify('hello sm2', sig, publicKey, { der: true });
+
+// SM4：默认 ECB + pkcs#7 填充
+const key = '0123456789abcdeffedcba9876543210';
+const cipher = qsh.crypto.sm4Encrypt('hello', key);
+const plain = qsh.crypto.sm4Decrypt(cipher, key);
+```
+
+#### UMD 使用
+
+```html
+<script src="path/to/uni-webview.umd.js"></script>
+<script>
+  // 直接通过全局 qsh 访问
+  const hash = window.qsh.crypto.sm3Hash('abc');
+</script>
+```
+
+提示：
+- SM2 默认使用 C1C3C2（cipherMode=1）。与其他工具互通时请确保模式一致。
+- SM4 支持 ECB/CBC 等模式；CBC 需提供 `iv`。
+- 如需数组输入/输出，可通过 `options.output = 'array'` 控制（与上游库一致）。
+
 ## API 文档
 
 ### 导航 API
@@ -171,6 +210,7 @@ npm run build
 
 - `example/test.html` - 完整的测试页面，包含所有功能演示
 - `example/simple.html` - 简单示例，展示基础用法
+- `example/npm-usage.html` - 以 ESModule 方式演示，包括加密能力示例
 - `test.html` - 快速测试页面
 
 ## 项目结构
@@ -187,6 +227,7 @@ src/
 ├── api/                # API 接口
 │   ├── navigation.js   # 导航 API
 │   └── message.js      # 消息 API
+ │   └── crypto.js       # 加密 API（SM2/SM3/SM4）
 ├── index.js            # 主入口
 └── index.d.ts          # 类型定义
 ```

package/dist/index.d.ts

@@ -90,6 +90,26 @@ declare namespace UniWebView {
     ready(): Promise<void>;
     /** WebView 对象（兼容旧版本） */
     webView: WebView | null;
+    /** 加密 API（SM2/SM3/SM4） */
+    crypto: {
+      // SM2
+      sm2GenerateKeyPair(random?: any): { publicKey: string; privateKey: string };
+      sm2Encrypt(message: string | number[], publicKey: string, cipherMode?: 0 | 1, options?: Record<string, any>): string | number[];
+      sm2Decrypt(cipherText: string | number[], privateKey: string, cipherMode?: 0 | 1, options?: { output?: 'array' | 'string' }): string | number[];
+      sm2Sign(message: string | number[], privateKey: string, options?: Record<string, any>): string;
+      sm2Verify(message: string | number[], signatureHex: string, publicKey: string, options?: Record<string, any>): boolean;
+      sm2GetPublicKey(privateKey: string): string;
+      sm2GetPoint(): any;
+      sm2CompressPublicKey(publicKey: string): string;
+      sm2ComparePublicKey(a: string, b: string): boolean;
+      sm2VerifyPublicKey(publicKey: string): boolean;
+      // SM3
+      sm3Hash(message: string | number[], options?: { key?: string | number[] }): string;
+      // SM4
+      sm4Encrypt(message: string | number[], key: string | number[], options?: { padding?: 'pkcs#7' | 'pkcs#5' | 'none'; output?: 'array' | 'string'; mode?: 'ecb' | 'cbc'; iv?: string | number[] }): string | number[];
+      sm4Decrypt(cipherText: string | number[], key: string | number[], options?: { padding?: 'pkcs#7' | 'pkcs#5' | 'none'; output?: 'array' | 'string'; mode?: 'ecb' | 'cbc'; iv?: string | number[] }): string | number[];
+      __raw__: any;
+    };
   }
 }