@h-ai/crypto 1.0.0-beta.7 → 1.0.0-beta.8

package/README.en.md

@@ -156,6 +156,8 @@ if (hashed.success) {
 
 #### Transport encryption (crypto.transport)
 
+Transport client `destroy()` invalidates and aborts an in-flight handshake; late results cannot restore keys or overwrite the next handshake. It clears local state; server registry entries retain their own expiry.
+
 See the [Transport v2 wire protocol](TRANSPORT-PROTOCOL.md) for canonical encoding, verification order and replay persistence.
 
 The `crypto.transport` namespace provides transport encryption, allowing `@h-ai/serv`, `@h-ai/kit`, and `@h-ai/api-client` to share protocol constants and payload formats.

package/README.ja.md

@@ -21,6 +21,8 @@
 
 ### セキュリティに関する注意
 
+伝送クライアントの `destroy()` は進行中のハンドシェイクを無効化して中断し、遅延結果による鍵の復活や次回ハンドシェイクの上書きを防ぎます。サーバー registry は自身の期限で回収します。
+
 - **SM4 の既定の暗号化結果は構造化された暗号文**：`crypto.symmetric.encrypt(data, key)` は既定で CBC + ランダム IV を使用し、`{ mode, ciphertext, iv, encoding }` を返します。復号時はこのオブジェクトを `crypto.symmetric.decrypt(payload, key)` に渡します。
 - **SM4 にはランダムな鍵を使用してください**：`crypto.symmetric.generateKey()` で鍵を生成します。このモジュールはパスワードから暗号鍵を導出する KDF を提供しません。パスワードの保存にはサーバー専用の `crypto.password.hash(password)` を使用し、パスワードやそのハッシュを直接 SM4 の鍵にしないでください。
 - **IV は毎回一意にしてください**：同じ鍵で IV を再利用してはいけません。既定の CBC または `encryptWithIV()` による毎回の自動生成を推奨します。IV は暗号文と一緒に送信・保存します（公開可能で、秘密にする必要はありません）。

package/README.md

@@ -156,6 +156,8 @@ if (hashed.success) {
 
 #### 传输加密（crypto.transport）
 
+传输客户端 `destroy()` 使在途握手失效并取消网络等待；迟到结果不能恢复密钥或覆盖下一次握手。它只清理本地会话，服务端 registry 仍按自己的租约回收。
+
 规范编码、验证顺序与 nonce 持久化要求见 [Transport v2 协议](TRANSPORT-PROTOCOL.md)。
 
 传输加密统一通过 `crypto.transport` 命名空间提供，供 `@h-ai/serv`、`@h-ai/kit` 与 `@h-ai/api-client` 复用同一套协议常量和载荷格式。

package/dist/index.js

@@ -1125,7 +1125,9 @@ function createTransportClient(options) {
   let serverKeyId = null;
   let clientId = null;
   let initPromise = null;
-  async function doInit() {
+  let generation = 0;
+  let handshakeController;
+  async function doInit(attemptGeneration) {
     const kpResult = options.crypto.asymmetric.generateKeyPair();
     if (!kpResult.success)
       return err(HaiCommonError.INTERNAL_ERROR, cryptoM("crypto_transportClientKeyGenerateFailed"), kpResult.error);
@@ -1133,6 +1135,7 @@ function createTransportClient(options) {
     if (new TextEncoder().encode(localKeyPair.publicKey).byteLength > TRANSPORT_BODY_LIMITS.publicKeyBytes)
       return err(HaiCommonError.INTERNAL_ERROR, cryptoM("crypto_transportClientKeyGenerateFailed"));
     const controller = new AbortController();
+    handshakeController = controller;
     const timeout = setTimeout(() => controller.abort(new DOMException("Key exchange timed out", "TimeoutError")), 3e4);
     try {
       let response;
@@ -1169,6 +1172,8 @@ function createTransportClient(options) {
       } catch {
         return err(HaiCommonError.INTERNAL_ERROR, cryptoM("crypto_transportBodyLimitInvalid"));
       }
+      if (attemptGeneration !== generation || controller.signal.aborted)
+        return err(HaiCommonError.INTERNAL_ERROR, cryptoM("crypto_transportClientNotInitialized"));
       keyPair = localKeyPair;
       serverPublicKey = body.serverPublicKey;
       serverKeyId = body.serverKeyId;
@@ -1176,17 +1181,20 @@ function createTransportClient(options) {
       return ok(void 0);
     } finally {
       clearTimeout(timeout);
+      if (handshakeController === controller)
+        handshakeController = void 0;
     }
   }
   async function ensureReady() {
     if (clientId && serverPublicKey)
       return ok(void 0);
     if (!initPromise) {
-      initPromise = doInit().then((result) => {
-        if (!result.success)
+      const pending = doInit(generation).then((result) => {
+        if (!result.success && initPromise === pending)
           initPromise = null;
         return result;
       });
+      initPromise = pending;
     }
     return initPromise;
   }
@@ -1360,6 +1368,9 @@ function createTransportClient(options) {
     encryptedFetch,
     ready: () => clientId !== null && serverPublicKey !== null,
     destroy() {
+      generation++;
+      handshakeController?.abort();
+      handshakeController = void 0;
       keyPair = null;
       serverPublicKey = null;
       serverKeyId = null;