dsh-mobile-plugin 0.5.20 → 0.5.22

package/lib/tailcat/wiring.cjs

@@ -0,0 +1,96 @@
+'use strict';
+
+/**
+ * 把直连隧道挂进装配层：回环入口 + 助手会话 + 一条自己的启停 effect。
+ *
+ * 单独一个文件是因为装配层有行数上限（`test/assembly-layer.test.cjs` 钉着）——那些上限不是
+ * 「装配层恰好该多长」，而是「实现不许搬回装配层」。这里的三样东西都是装配动作，实现分别
+ * 在 `ingress.cjs` 与 `session.cjs`。
+ *
+ * 任何一步起不来都只意味着「这台机器没有这条通道」：`mount` 兜住异常并留一行日志，中转与
+ * 局域网一行不受影响。
+ */
+
+const { createLoopbackIngress } = require('./ingress.cjs');
+const { createTailcatSession } = require('./session.cjs');
+
+/**
+ * @param {object} options
+ * @param {(label: string, fn: Function) => any} options.mount 装配层的兜底挂载
+ * @param {(message: string) => void} options.warn 告警出口（拿不到 logger 时为空实现）
+ * @param {object} options.state relay.json 那份内存状态（唯一真值）
+ * @param {(state: object) => void} options.saveState 落盘
+ * @param {() => number} options.lanPortInUse 当前局域网端口（会漂）
+ * @param {() => string} options.hostName 电脑名
+ * @param {object} options.ctx 插件 ctx（只为 `ctx.effect`）
+ * @param {string} options.name 插件名，用于 effect 标签
+ * @returns {object|undefined} 会话；起不来就是 undefined（路由与面板按「不可用」处理）
+ */
+function mountTailcat(options) {
+  const { mount, warn, state, saveState, lanPortInUse, hostName, ctx, name } = options;
+  const ingress = mount('直连隧道入口', () =>
+    createLoopbackIngress({ targetPort: () => lanPortInUse(), log: message => warn(message) }),
+  );
+
+  /**
+   * 端口是异步拿到的（`listen(0)` 要等 `listening`），所以会话也是异步建好的。
+   * 路由和面板在装配阶段就要拿到一个对象，于是对外交的是**门面**：里面那格可能还是空，
+   * 调用方问到的就是「暂不可用」，等挂上了自然就通了 —— 不需要谁去等一次 Promise。
+   */
+  let session = null;
+  const door = {
+    status: () => (session ? session.status() : { available: Boolean(ingress), enabled: true, ready: false, address: '', paired: 0, error: 'starting' }),
+    openPairingWindow: ttl => (session ? session.openPairingWindow(ttl) : Promise.resolve(null)),
+    setAllowed: keys => (session ? session.setAllowed(keys) : false),
+    setEnabled: enabled => (session ? session.setEnabled(enabled) : false),
+    enroll: publicKey => (session ? session.enroll(publicKey) : Promise.resolve(null)),
+    allowedClients: () => (session ? session.allowedClients() : []),
+    start: () => (session ? session.start() : undefined),
+    stop: () => (session ? session.stop() : Promise.resolve()),
+  };
+
+  // 启停单独一条命：跟 sidecar 不是一件事，谁挂了都不该带走对方。
+  // 关的时候先停助手再关回环门——门是助手唯一的去处，反过来会让最后几条连接瞬间断在门上。
+  mount('直连隧道生命周期', () =>
+    ctx.effect(() => {
+      let closed = false;
+      const wiring = ingress
+        ? Promise.resolve(ingress.start())
+            .then(port => {
+              if (closed || !port) return;
+              session = createTailcatSession({
+                readState: () => state,
+                writeState: patch => {
+                  Object.assign(state, patch);
+                  saveState(state);
+                },
+                localPort: port,
+                hostName,
+                log: message => warn(message),
+              });
+              session.start();
+            })
+            .catch(error => warn(`直连隧道没有起来：${error && error.message ? error.message : error}`))
+        : Promise.resolve();
+      return () => {
+        closed = true;
+        void wiring.then(() => {
+          try {
+            if (session) session.stop();
+            session = null;
+          } catch {
+            /* 已经在停 */
+          }
+          try {
+            if (ingress) ingress.close();
+          } catch {
+            /* 已经关了 */
+          }
+        });
+      };
+    }, `${name}: tailcat`),
+  );
+  return door;
+}
+
+module.exports = { mountTailcat };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.5.20",
+  "version": "0.5.22",
   "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",
@@ -42,6 +42,8 @@
     "dsh-mobile-credentials",
     "locale/*.json",
     "icon.png",
+    "assets/pets/**",
+    "extensions/**",
     "README.md"
   ],
   "publishConfig": {
@@ -58,6 +60,13 @@
     "qrcode": "1.5.4",
     "ws": "8.18.0"
   },
+  "optionalDependencies": {
+    "dsh-mobile-tailcat-darwin-arm64": "1.0.0",
+    "dsh-mobile-tailcat-darwin-x64": "1.0.0",
+    "dsh-mobile-tailcat-linux-arm64": "1.0.0",
+    "dsh-mobile-tailcat-linux-x64": "1.0.0",
+    "dsh-mobile-tailcat-win32-x64": "1.0.0"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
     "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2 || ^0.2.0-rc.1 || ^0.2.1-rc.2",