dsh-mobile-plugin 0.5.12 → 0.5.14

package/lib/shared/e2ee-request.js

@@ -65,6 +65,17 @@ function signedPath(req) {
   return hit >= 0 ? pathname.slice(hit) : pathname;
 }
 
+/**
+ * v3 二进制分片的 AAD：`v2|up|METHOD|PATH|<uploadId>|<offset>`。
+ *
+ * 在 v2 的四段后面绑上这两格，是为了让「把一片搬到别的上传 / 搬到同一上传的别的偏移」
+ * 在 AEAD 这一层就不成立 —— 签名只覆盖路径与字节，绑不到上传身份上。
+ *
+ * 字符串口径写在 `docs/native-upload.md` 的 v3 章，与 App 侧下一阶段的实现对齐；这里只
+ * 负责把它拼出来，不额外规范化 offset（`"042"` 与 `"42"` 拼出来不同，客户端必须原样发）。
+ */
+const binChunkAad = (method, path, uploadId, offset) => `v2|up|${method}|${path}|${uploadId}|${offset}`;
+
 /** 查询串按线上原样（含 `?`），不排序：它必须与 App 真正发出去的那串一致。 */
 function signedQuery(req) {
   const raw = String(req?.url || '');
@@ -81,6 +92,8 @@ function signedQuery(req) {
  * @param {Buffer} [deps.rawBody] 已读到的请求体原文（没读过就给 undefined，这里会自己读）
  * @returns {{ ok: true, body: object|undefined, keys: object, device: object }
  *          | { ok: false, status: number, code: string, extra?: object }}
+ *
+ * 带 `X-Dsh-Wire: bin` 的请求没有 JSON body，解出来的明文放在 `req.rawBody`（Buffer）上。
  */
 function openRequest(req, deps, rawBody) {
   const keyId = headerOf(req, 'x-dsh-key-id').trim();
@@ -133,6 +146,32 @@ function openRequest(req, deps, rawBody) {
     nonces.set(keyId, table);
   }
 
+  // ── 二进制 wire（v3 的上行分片体，见 docs/native-upload.md 的 v3 章）──
+  //
+  // 只对**明确带头**的请求生效：老 App 不会发 `X-Dsh-Wire`，所以它走的仍是下面那条
+  // JSON 信封分支，一个字节都不变。反过来，带了 `bin` 就说明客户端知道自己在发裸密文，
+  // 这时候把它当 JSON 解只会得到一个「请求体不是合法 JSON」的 400。
+  if (headerOf(req, 'x-dsh-wire').trim().toLowerCase() === 'bin') {
+    const uploadId = headerOf(req, 'x-dsh-upload-id').trim();
+    const offsetText = headerOf(req, 'x-dsh-upload-offset').trim();
+    // 这两格既进 AAD 也进业务判据，缺一格就没法把「这一片」绑到「这个上传的这个偏移」上。
+    if (!uploadId || !/^\d+$/.test(offsetText)) {
+      return { ok: false, status: 400, code: 'e2ee-bad-envelope', extra: { reason: 'missing wire headers' } };
+    }
+    let plain;
+    try {
+      // AAD 比 v2 多两段：先把一片搬到别的上传、或搬到同一上传的别的偏移，认证就不过。
+      // 签名口径不变（签的仍是线上这串密文字节），所以上面那步验签一行没动。
+      plain = e2ee.open(keys.up, rawBody || Buffer.alloc(0), binChunkAad(method, signedPath(req), uploadId, offsetText));
+    } catch {
+      return { ok: false, status: 400, code: 'e2ee-decrypt-failed' };
+    }
+    // 业务 handler 拿不到 JSON（这一片本来就不是 JSON）：明文交给 `req.rawBody`，
+    // 上传 handler 用 `readRawBody` 取。响应仍由上面的守卫封成普通的 v2 JSON 信封。
+    req.rawBody = plain;
+    return { ok: true, body: undefined, keys, device: record, req: { ts, nonce } };
+  }
+
   // ── 解封请求体 ──
   let body;
   if (rawBody && rawBody.length > 0) {

package/lib/shared/http-util.js

@@ -137,4 +137,59 @@ function readJsonBody(req, maxBytes = JSON_MAX_BODY) {
   });
 }
 
-module.exports = { sendJson, sendHtml, readJsonBody, encodeJsonBody, wantsGzip, JSON_GZIP_MIN_BYTES, JSON_MAX_BODY };
+/**
+ * 读原始请求体，回 Buffer；超限 / 连接出错 → null。
+ *
+ * 与 `readJsonBody` 的分工：那条路交出去的是**解析好的 JSON**，这条路交出去的是**字节**。
+ * v3 的二进制分片（`X-Dsh-Wire: bin`）加密后就是裸字节，中间没有 JSON 这一层；handler 拿
+ * 到的明文片（守卫解封之后）同样是字节，所以两边都用这一条。
+ *
+ * `req.rawBody` 优先：信封守卫（`shared/e2ee-request.js`）已经把密文读走、解封完放在那里，
+ * 请求流早就见底了，再 `on('data')` 只会等来一个空 body —— 那会表现为「每片都解出 0 字节」，
+ * 而错误信息只会是「分片是空的」。
+ *
+ * @param {object} req         node:http IncomingMessage
+ * @param {number} [maxBytes]  请求体上限（字节），缺省按普通 JSON 那一档
+ * @returns {Promise<Buffer|null>}
+ */
+function readRawBody(req, maxBytes = JSON_MAX_BODY) {
+  const handed = req && req.rawBody;
+  if (Buffer.isBuffer(handed)) return Promise.resolve(handed.length > maxBytes ? null : handed);
+  return new Promise((resolve) => {
+    const chunks = [];
+    let total = 0;
+    let settled = false;
+    req.on('data', (chunk) => {
+      if (settled) return;
+      total += chunk.length;
+      if (total > maxBytes) {
+        settled = true;
+        req.destroy();
+        resolve(null);
+        return;
+      }
+      chunks.push(Buffer.from(chunk));
+    });
+    req.on('end', () => {
+      if (settled) return;
+      settled = true;
+      resolve(Buffer.concat(chunks));
+    });
+    req.on('error', () => {
+      if (settled) return;
+      settled = true;
+      resolve(null);
+    });
+  });
+}
+
+module.exports = {
+  sendJson,
+  sendHtml,
+  readJsonBody,
+  readRawBody,
+  encodeJsonBody,
+  wantsGzip,
+  JSON_GZIP_MIN_BYTES,
+  JSON_MAX_BODY,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (dsh 0.2.x, peers resolved by the host)",
   "license": "MIT",
   "icon": "./icon.png",