sm-crypto-wasm 0.3.0 → 0.3.1

package/README.md

@@ -240,6 +240,8 @@ import { encryptCBC } from 'sm-crypto-wasm/sm4';
 | 浏览器（经打包器） | `fetch(new URL('../<algo>/<algo>.wasm', import.meta.url))`，由打包器归档并重写 URL |
 | Web Worker | 加载器不依赖 DOM，Worker 内可用 |
 | Deno / Bun | 走 Node 同路径 |
+| 微信内置浏览器 | 与浏览器相同（`fetch` + `crypto.getRandomValues`）；见[微信与小程序](https://jktantan.github.io/sm-crypto-wasm/guide/wechat) |
+| 微信小程序 | `WXWebAssembly` + `wx.getRandomValues`；见[微信与小程序](https://jktantan.github.io/sm-crypto-wasm/guide/wechat) |
 
 ### 打包器支持
 
@@ -604,6 +606,8 @@ Available sub-paths: `sm-crypto-wasm/sm2` · `/sm3` · `/sm4` · `/sm9` · `/zuc
 | Browser (via a bundler) | `fetch(new URL('../<algo>/<algo>.wasm', import.meta.url))`; the bundler archives and rewrites it |
 | Web Worker | the loader is DOM-free and works inside a Worker |
 | Deno / Bun | follows the Node path |
+| WeChat built-in browser | same as browsers (`fetch` + `crypto.getRandomValues`); see [WeChat & Mini Programs](https://jktantan.github.io/sm-crypto-wasm/en/guide/wechat) |
+| WeChat Mini Program | `WXWebAssembly` + `wx.getRandomValues`; see [WeChat & Mini Programs](https://jktantan.github.io/sm-crypto-wasm/en/guide/wechat) |
 
 ### Bundler support
 
@@ -997,6 +1001,8 @@ import { encryptCBC } from 'sm-crypto-wasm/sm4';
 | Браузер (через сборщик) | `fetch(new URL('../<algo>/<algo>.wasm', import.meta.url))`; сборщик кладёт файл в вывод и переписывает URL |
 | Web Worker | загрузчик не зависит от DOM и работает внутри Worker'а |
 | Deno / Bun | идут по Node-пути |
+| Встроенный браузер WeChat | как обычный браузер (`fetch` + `crypto.getRandomValues`); см. [WeChat и мини-программы](https://jktantan.github.io/sm-crypto-wasm/ru/guide/wechat) |
+| Мини-программа WeChat | `WXWebAssembly` + `wx.getRandomValues`; см. [WeChat и мини-программы](https://jktantan.github.io/sm-crypto-wasm/ru/guide/wechat) |
 
 ### Поддержка сборщиков
 

package/dist/runtime/base64.core.d.ts

@@ -0,0 +1,22 @@
+/**
+ * base64 纯 JS 实现（宿主既没有 `Buffer`、也没有 `btoa` / `atob` 时的兜底）。
+ *
+ * 存在理由：微信小程序等运行时没有 `btoa` / `atob`，而 SM2 / SM9 的 PEM 密钥
+ * 生成与解析需要 base64。base64 是确定性编码、不属于密码学原语，因此在库内兜底
+ * 不需要像 RNG 那样 fail-closed。
+ *
+ * 只在 `runtime/convert.ts` 的最后一级回退里使用；Node 有 `Buffer`、浏览器有
+ * `btoa` / `atob` 时都不会走到这里。零 `node:*` 引用，可安全进入浏览器/小程序产物。
+ */
+/** 标准 base64 编码（带 `=` padding）。 */
+export declare function encodeBase64(bytes: Uint8Array): string;
+/**
+ * 标准 base64 解码。
+ *
+ * 与 `atob` 的宽松度对齐：允许空白字符与缺失 padding；非法字符、非法长度抛
+ * `TypeError`（`convert.base64ToBytes` 的契约是失败抛 TypeError）。
+ *
+ * @param b64 base64 字符串。
+ * @param label 错误信息里的字段名。
+ */
+export declare function decodeBase64(b64: string, label?: string): Uint8Array;

package/dist/runtime/base64.core.js

@@ -0,0 +1,68 @@
+/**
+ * base64 纯 JS 实现（宿主既没有 `Buffer`、也没有 `btoa` / `atob` 时的兜底）。
+ *
+ * 存在理由：微信小程序等运行时没有 `btoa` / `atob`，而 SM2 / SM9 的 PEM 密钥
+ * 生成与解析需要 base64。base64 是确定性编码、不属于密码学原语，因此在库内兜底
+ * 不需要像 RNG 那样 fail-closed。
+ *
+ * 只在 `runtime/convert.ts` 的最后一级回退里使用；Node 有 `Buffer`、浏览器有
+ * `btoa` / `atob` 时都不会走到这里。零 `node:*` 引用，可安全进入浏览器/小程序产物。
+ */
+const B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/** 标准 base64 编码（带 `=` padding）。 */
+export function encodeBase64(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i] ?? 0;
+        const hasB = i + 1 < bytes.length;
+        const hasC = i + 2 < bytes.length;
+        const b = hasB ? (bytes[i + 1] ?? 0) : 0;
+        const c = hasC ? (bytes[i + 2] ?? 0) : 0;
+        const n = (a << 16) | (b << 8) | c;
+        out += B64.charAt((n >> 18) & 63);
+        out += B64.charAt((n >> 12) & 63);
+        out += hasB ? B64.charAt((n >> 6) & 63) : '=';
+        out += hasC ? B64.charAt(n & 63) : '=';
+    }
+    return out;
+}
+/**
+ * 标准 base64 解码。
+ *
+ * 与 `atob` 的宽松度对齐：允许空白字符与缺失 padding；非法字符、非法长度抛
+ * `TypeError`（`convert.base64ToBytes` 的契约是失败抛 TypeError）。
+ *
+ * @param b64 base64 字符串。
+ * @param label 错误信息里的字段名。
+ */
+export function decodeBase64(b64, label = 'base64') {
+    const stripped = b64.replace(/[\t\n\f\r ]/g, '');
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(stripped)) {
+        throw new TypeError(`${label}: invalid base64`);
+    }
+    const pad = stripped.endsWith('==') ? 2 : stripped.endsWith('=') ? 1 : 0;
+    if (pad > 0 && stripped.length % 4 !== 0) {
+        throw new TypeError(`${label}: invalid base64 padding`);
+    }
+    const body = pad > 0 ? stripped.slice(0, -pad) : stripped;
+    if (body.length % 4 === 1) {
+        throw new TypeError(`${label}: invalid base64 length`);
+    }
+    const out = new Uint8Array(Math.floor((body.length * 3) / 4));
+    let buffer = 0;
+    let bits = 0;
+    let pos = 0;
+    for (let i = 0; i < body.length; i++) {
+        const v = B64.indexOf(body.charAt(i));
+        if (v < 0)
+            throw new TypeError(`${label}: invalid base64 character at index ${i}`);
+        buffer = (buffer << 6) | v;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            out[pos++] = (buffer >> bits) & 0xff;
+            buffer &= (1 << bits) - 1;
+        }
+    }
+    return out.subarray(0, pos);
+}

package/dist/runtime/convert.d.ts

@@ -40,10 +40,19 @@ export declare function fromBytes(bytes: Uint8Array, format?: OutputFormat): str
 export declare function bytesToHex(bytes: Uint8Array): string;
 /** hex 字符串 → bytes。支持 `0x` 前缀。奇数位长度或非法字符抛错。 */
 export declare function hexToBytes(hex: string, label?: string): Uint8Array;
-/** bytes → base64。Node `Buffer` 优先，浏览器回落到 `btoa`。 */
+/**
+ * bytes → base64。优先级：Node `Buffer` → 宿主 `btoa` → 纯 JS 兜底。
+ *
+ * 微信小程序既没有 `Buffer` 也没有 `btoa`，会走最后一级；不需要宿主再安装
+ * base64 polyfill。
+ */
 export declare function bytesToBase64(bytes: Uint8Array): string;
-/** base64 字符串 → bytes。失败抛 TypeError。 */
-export declare function base64ToBytes(b64: string, _label?: string): Uint8Array;
+/**
+ * base64 字符串 → bytes。失败抛 TypeError。
+ *
+ * 优先级：Node `Buffer` → 宿主 `atob` → 纯 JS 兜底（微信小程序等）。
+ */
+export declare function base64ToBytes(b64: string, label?: string): Uint8Array;
 /** PEM → bytes。剥去 BEGIN/END armor，base64 解码。 */
 export declare function pemToBytes(pem: string, label?: string): Uint8Array;
 /** bytes → PEM（带 BEGIN/END 头）。`kind` 例：`SM2 PRIVATE KEY`。 */

package/dist/runtime/convert.js

@@ -16,6 +16,7 @@
  *
  * spec/plan 对应：plan Task 2；spec §6 API 默认 hex、§9 安全姿态。
  */
+import { decodeBase64, encodeBase64 } from './base64.core.js';
 /**
  * 把任意 `Input` 归一化为 `Uint8Array`。
  *
@@ -106,20 +107,32 @@ export function hexToBytes(hex, label = 'hex') {
     // tryParseHex 已覆盖全部合法情形，走到这里说明上面漏判，兜底抛错。
     throw new TypeError(`hexToBytes(${label}): invalid hex`);
 }
-/** bytes → base64。Node `Buffer` 优先，浏览器回落到 `btoa`。 */
+/**
+ * bytes → base64。优先级：Node `Buffer` → 宿主 `btoa` → 纯 JS 兜底。
+ *
+ * 微信小程序既没有 `Buffer` 也没有 `btoa`，会走最后一级；不需要宿主再安装
+ * base64 polyfill。
+ */
 export function bytesToBase64(bytes) {
     if (HAS_BUFFER) {
         return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('base64');
     }
-    let bin = '';
-    for (let i = 0; i < bytes.length; i++)
-        bin += String.fromCharCode(bytes[i] ?? 0);
-    return btoa(bin);
+    if (HAS_BTOA) {
+        let bin = '';
+        for (let i = 0; i < bytes.length; i++)
+            bin += String.fromCharCode(bytes[i] ?? 0);
+        return btoa(bin);
+    }
+    return encodeBase64(bytes);
 }
 /** base64 合法字符集（含结尾 padding）。 */
 const B64_RE = /^[A-Za-z0-9+/]*={0,2}$/;
-/** base64 字符串 → bytes。失败抛 TypeError。 */
-export function base64ToBytes(b64, _label = 'base64') {
+/**
+ * base64 字符串 → bytes。失败抛 TypeError。
+ *
+ * 优先级：Node `Buffer` → 宿主 `atob` → 纯 JS 兜底（微信小程序等）。
+ */
+export function base64ToBytes(b64, label = 'base64') {
     // Node 快路径。`Buffer.from(..., 'base64')` 对非法字符是静默丢弃的，
     // 先用正则挡掉，非法的落到 `atob` 去抛错，保持与浏览器一致的行为。
     if (HAS_BUFFER && B64_RE.test(b64)) {
@@ -128,11 +141,14 @@ export function base64ToBytes(b64, _label = 'base64') {
         out.set(buf);
         return out;
     }
-    const bin = atob(b64);
-    const out = new Uint8Array(bin.length);
-    for (let i = 0; i < bin.length; i++)
-        out[i] = bin.charCodeAt(i);
-    return out;
+    if (HAS_ATOB) {
+        const bin = atob(b64);
+        const out = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; i++)
+            out[i] = bin.charCodeAt(i);
+        return out;
+    }
+    return decodeBase64(b64, label);
 }
 /** PEM → bytes。剥去 BEGIN/END armor，base64 解码。 */
 export function pemToBytes(pem, label = 'pem') {
@@ -169,6 +185,9 @@ export function bytesToPem(bytes, kind) {
  * （实测 4 KB 输入：hex 编码 52.6 µs → 1.9 µs）。
  */
 const HAS_BUFFER = typeof Buffer !== 'undefined' && typeof Buffer.from === 'function';
+/** 宿主是否提供 `btoa` / `atob`（现代浏览器有；微信小程序没有）。 */
+const HAS_BTOA = typeof btoa === 'function';
+const HAS_ATOB = typeof atob === 'function';
 /** 16 进制数字查表（浏览器路径）。 */
 const HEX_CHARS = '0123456789abcdef';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sm-crypto-wasm",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "国密 SM2/SM3/SM4/SM9/ZUC 的 WASM 实现，Node 18+ 与现代浏览器均可使用，按算法分包懒加载。",
   "description:en": "SM2/SM3/SM4/SM9/ZUC (China crypto) implemented in AssemblyScript -> WASM. Node 18+ & modern browsers, per-algorithm lazy loading.",
   "license": "Apache-2.0",
@@ -96,6 +96,7 @@
     "docs:dev": "pnpm build && vitepress dev website",
     "docs:build": "pnpm build && vitepress build website",
     "docs:preview": "vitepress preview website",
+    "example:wechat:prepare": "node examples/wechat-miniprogram/scripts/prepare.mjs",
     "prepack": "pnpm build && pnpm test"
   },
   "devDependencies": {