@hjd-hitsz/claudex-web 4.1.4 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/.env.example +2 -0
  2. package/CHANGELOG.md +47 -0
  3. package/README.md +13 -1
  4. package/bin/auth.mjs +86 -0
  5. package/bin/claudex-web.mjs +20 -0
  6. package/bin/p2p.mjs +134 -0
  7. package/build-info.json +4 -4
  8. package/client/dist/app.js +104 -104
  9. package/client/dist/code-highlight-style.js +1 -1
  10. package/client/dist/document-editor.js +55 -54
  11. package/client/dist/file-panel.js +5 -5
  12. package/client/dist/notification-worker.js +2 -1
  13. package/client/dist/p2p-sw.js +162 -0
  14. package/client/dist/style.css +1 -1
  15. package/client/dist/terminal-panel.js +11 -11
  16. package/docs/architecture/backends.md +9 -2
  17. package/docs/architecture/behavior.md +167 -53
  18. package/docs/architecture.md +36 -337
  19. package/docs/background-tasks.md +30 -26
  20. package/docs/deployment.md +47 -6
  21. package/docs/development.md +111 -153
  22. package/docs/images/desktop-dark.png +0 -0
  23. package/docs/images/desktop-light.png +0 -0
  24. package/docs/images/mobile-sidebar.png +0 -0
  25. package/docs/images/mobile.png +0 -0
  26. package/docs/releases/v4.1.5.md +6 -0
  27. package/docs/releases/v4.2.0.md +13 -0
  28. package/docs/versioning.md +13 -3
  29. package/package.json +14 -5
  30. package/packages/background-terminal/LICENSE +674 -0
  31. package/packages/background-terminal/README.md +17 -0
  32. package/packages/background-terminal/background-jobs.mjs +457 -0
  33. package/packages/background-terminal/background-mcp.mjs +79 -0
  34. package/packages/background-terminal/background-protocol.mjs +80 -0
  35. package/packages/background-terminal/cli.mjs +14 -0
  36. package/packages/background-terminal/client.mjs +61 -0
  37. package/packages/background-terminal/codex.mjs +88 -0
  38. package/packages/background-terminal/delivery.mjs +192 -0
  39. package/packages/background-terminal/log.mjs +25 -0
  40. package/packages/background-terminal/native-watches.mjs +160 -0
  41. package/packages/background-terminal/package.json +15 -0
  42. package/packages/background-terminal/service.mjs +126 -0
  43. package/packages/translation-engine/package.json +1 -1
  44. package/server/src/application.mjs +82 -10
  45. package/server/src/auth-http.mjs +187 -0
  46. package/server/src/auth-login.mjs +144 -0
  47. package/server/src/auth-totp.mjs +233 -0
  48. package/server/src/auth.mjs +169 -220
  49. package/server/src/backends/claude/background-tasks.mjs +88 -35
  50. package/server/src/backends/claude/messages.mjs +1 -1
  51. package/server/src/backends/claude/worker-client.mjs +47 -35
  52. package/server/src/backends/claude/worker-lines.mjs +17 -0
  53. package/server/src/backends/claude/worker-server.mjs +49 -69
  54. package/server/src/backends/codex/adapter.mjs +46 -5
  55. package/server/src/backends/codex/background-service.mjs +85 -0
  56. package/server/src/backends/codex/background-task-views.mjs +87 -0
  57. package/server/src/backends/codex/background-terminals.mjs +91 -0
  58. package/server/src/backends/codex/events.mjs +11 -0
  59. package/server/src/backends/codex/methods.mjs +1 -0
  60. package/server/src/backends/codex/native-background-handoff.mjs +72 -0
  61. package/server/src/backends/codex/requests.mjs +51 -38
  62. package/server/src/backends/codex/subscriptions.mjs +34 -4
  63. package/server/src/backends/configuration.mjs +8 -0
  64. package/server/src/backends/manager.mjs +35 -33
  65. package/server/src/backends/storage.mjs +3 -14
  66. package/server/src/config.mjs +13 -0
  67. package/server/src/http/business.mjs +21 -0
  68. package/server/src/http/router.mjs +12 -25
  69. package/server/src/p2p/http.mjs +136 -0
  70. package/server/src/p2p/peers.mjs +132 -0
  71. package/server/src/p2p/service.mjs +229 -0
  72. package/server/src/p2p/storage.mjs +45 -0
  73. package/server/src/p2p/tunnel.mjs +95 -0
  74. package/server/src/p2p-http.mjs +149 -0
  75. package/server/src/p2p-peer.mjs +135 -0
  76. package/server/src/private-file.mjs +14 -0
  77. package/server/src/summary-translation.mjs +1 -1
  78. package/server/src/thread-folders.mjs +3 -13
  79. package/server/src/translation-service.mjs +3 -8
  80. package/server/src/workspace/file-search.mjs +244 -0
  81. package/server/src/workspace/service.mjs +17 -3
  82. package/shared/codex-preferences.mjs +9 -0
  83. package/shared/p2p-wire.mjs +157 -0
@@ -0,0 +1,21 @@
1
+ import { createMaintenanceHandler } from "./maintenance.mjs";
2
+ import { serveFile } from "../file-content.mjs";
3
+ import {
4
+ createSummaryTranslationHandler,
5
+ createTranslationSettingsHandler,
6
+ } from "../summary-translation.mjs";
7
+
8
+ export function createBusinessHttpHandler({ translation, maintenance }) {
9
+ const handleMaintenance = createMaintenanceHandler(maintenance);
10
+ const translate = createSummaryTranslationHandler(translation.translate);
11
+ const translationSettings = createTranslationSettingsHandler(translation);
12
+ return (request, response, path) => {
13
+ if (path === "/api/files" || path === "/api/media")
14
+ return serveFile(request, response);
15
+ if (path === "/api/translation")
16
+ return translationSettings(request, response);
17
+ if (path === "/api/translate") return translate(request, response);
18
+ if (/^\/api\/maintenance(?:\/|$)/.test(path))
19
+ return handleMaintenance(request, response, path);
20
+ };
21
+ }
@@ -1,10 +1,4 @@
1
- import { createMaintenanceHandler } from "./maintenance.mjs";
2
1
  import { X509Certificate } from "node:crypto";
3
- import {
4
- createSummaryTranslationHandler,
5
- createTranslationSettingsHandler,
6
- } from "../summary-translation.mjs";
7
- import { serveFile } from "../file-content.mjs";
8
2
  import { createStaticHandler } from "./static.mjs";
9
3
  export function createHttpHandler({
10
4
  config,
@@ -12,15 +6,10 @@ export function createHttpHandler({
12
6
  authentication,
13
7
  version,
14
8
  isReady,
15
- translation,
16
- maintenance,
9
+ handleBusiness,
10
+ handleP2p,
17
11
  }) {
18
- const handleMaintenance = createMaintenanceHandler(maintenance);
19
12
  const publicCertificate = new X509Certificate(tls.cert);
20
- const translateSummary = createSummaryTranslationHandler(
21
- translation.translate,
22
- );
23
- const translationSettings = createTranslationSettingsHandler(translation);
24
13
  const serveStatic = createStaticHandler(config.staticDir);
25
14
  return async function handleHttp(request, response) {
26
15
  const ready = isReady();
@@ -63,25 +52,23 @@ export function createHttpHandler({
63
52
  return;
64
53
  }
65
54
  if (await authentication.handle(request, response, path)) return;
55
+ const p2p = /^\/api\/p2p(?:\/|$)/.test(path);
56
+ if (p2p && authentication.maintenance(request)) {
57
+ await handleP2p(request, response, path);
58
+ return;
59
+ }
66
60
  if (
67
61
  path.startsWith("/api/") &&
68
62
  !authentication.authorize(request, response)
69
63
  )
70
64
  return;
71
- if (path.startsWith("/api/maintenance")) {
72
- await handleMaintenance(request, response, path);
73
- return;
74
- }
75
- if (["/api/files", "/api/media"].includes(path)) {
76
- await serveFile(request, response);
77
- return;
78
- }
79
- if (path === "/api/translation") {
80
- await translationSettings(request, response);
65
+ if (p2p) {
66
+ await handleP2p(request, response, path);
81
67
  return;
82
68
  }
83
- if (path === "/api/translate") {
84
- await translateSummary(request, response);
69
+ const business = handleBusiness(request, response, path);
70
+ if (business) {
71
+ await business;
85
72
  return;
86
73
  }
87
74
  if (path === "/healthz") {
@@ -0,0 +1,136 @@
1
+ import { once } from "node:events";
2
+ import { createServer } from "node:http";
3
+ import { createStaticHandler } from "../http/static.mjs";
4
+
5
+ export function fail(message, status) {
6
+ return new Error(message, { cause: status });
7
+ }
8
+
9
+ function json(response, status, body) {
10
+ if (response.destroyed) return;
11
+ response.writeHead(status, {
12
+ "Cache-Control": "no-store",
13
+ "Content-Type": "application/json; charset=utf-8",
14
+ });
15
+ response.end(JSON.stringify(body));
16
+ }
17
+
18
+ async function readObject(request, limit) {
19
+ if (!/^application\/json(?:;|$)/i.test(request.headers["content-type"] || ""))
20
+ throw fail("请使用 JSON 提交请求", 415);
21
+ let length = 0;
22
+ const chunks = [];
23
+ for await (const chunk of request.iterator({ destroyOnReturn: false })) {
24
+ length += chunk.length;
25
+ if (length > limit) throw fail("请求内容过长", 413);
26
+ chunks.push(chunk);
27
+ }
28
+ try {
29
+ const value = JSON.parse(Buffer.concat(chunks).toString("utf8"));
30
+ if (value && typeof value === "object" && !Array.isArray(value))
31
+ return value;
32
+ } catch {
33
+ // JSON 解析失败与请求形状错误使用同一响应。
34
+ }
35
+ throw fail("请求内容格式错误", 400);
36
+ }
37
+
38
+ const actions = new Map([
39
+ ["/api/p2p", "status"],
40
+ ["/api/p2p/enable", "enable"],
41
+ ["/api/p2p/disable", "disable"],
42
+ ["/api/p2p/create", "create"],
43
+ ["/api/p2p/revoke", "revoke"],
44
+ ]);
45
+
46
+ export function createP2pManagementHandler(service) {
47
+ return async (request, response, path) => {
48
+ try {
49
+ const action = actions.get(path);
50
+ if (!action) throw fail("P2P 操作不存在", 404);
51
+ if (request.method !== (action === "status" ? "GET" : "POST"))
52
+ throw fail("P2P 请求方法无效", 405);
53
+ const input =
54
+ action === "create" || action === "revoke"
55
+ ? await readObject(request, 2048)
56
+ : undefined;
57
+ json(response, 200, await service.manage(action, input));
58
+ } catch (error) {
59
+ json(response, Number.isInteger(error.cause) ? error.cause : 500, {
60
+ error: Number.isInteger(error.cause)
61
+ ? error.message
62
+ : "P2P 设置更新失败",
63
+ });
64
+ }
65
+ };
66
+ }
67
+
68
+ export async function openSignalingServer({
69
+ assetsDirectory,
70
+ getOrigin,
71
+ negotiate,
72
+ }) {
73
+ const serveStatic = createStaticHandler(assetsDirectory);
74
+ let requests = 0;
75
+
76
+ async function handle(request, response) {
77
+ const origin = getOrigin();
78
+ if (!origin || request.headers.host !== new URL(origin).host)
79
+ return json(response, 421, { error: "P2P 地址不可用" });
80
+ response.setHeader("X-Content-Type-Options", "nosniff");
81
+ response.setHeader("Referrer-Policy", "no-referrer");
82
+ response.setHeader(
83
+ "Content-Security-Policy",
84
+ "script-src 'self' 'wasm-unsafe-eval'; frame-src 'self'; frame-ancestors 'none'; base-uri 'none'; object-src 'self' blob:; form-action 'none'; upgrade-insecure-requests",
85
+ );
86
+ const path = request.url?.split("?", 1)[0];
87
+ if (request.method === "GET" || request.method === "HEAD") {
88
+ if (path === "/p2p") return serveStatic(request, response, "/");
89
+ if (path !== "/" && /^\/[\w.-]+\.(js|css|ico|png)$/.test(path || ""))
90
+ return serveStatic(request, response, path);
91
+ }
92
+ if (request.method !== "POST" || path !== "/p2p/offer")
93
+ return json(response, 404, { error: "资源不存在" });
94
+ if (
95
+ request.headers.origin !== origin ||
96
+ request.headers["sec-fetch-site"] === "cross-site"
97
+ )
98
+ return json(response, 403, { error: "P2P 信令请求来源无效" });
99
+ if (requests >= 24)
100
+ return json(response, 429, { error: "P2P 信令繁忙,请稍后重试" });
101
+ requests++;
102
+ const abort = new AbortController();
103
+ response.once("close", () => {
104
+ if (!response.writableFinished) abort.abort();
105
+ });
106
+ try {
107
+ const input = await readObject(request, 65536);
108
+ json(response, 200, await negotiate(input, abort.signal));
109
+ } finally {
110
+ requests--;
111
+ }
112
+ }
113
+
114
+ const server = createServer(
115
+ {
116
+ requestTimeout: 15000,
117
+ headersTimeout: 8000,
118
+ connectionsCheckingInterval: 2000,
119
+ },
120
+ (request, response) => {
121
+ handle(request, response).catch((error) => {
122
+ if (response.headersSent) return response.destroy();
123
+ response.setHeader("Connection", "close");
124
+ json(response, Number.isInteger(error.cause) ? error.cause : 500, {
125
+ error: Number.isInteger(error.cause)
126
+ ? error.message
127
+ : "P2P 信令处理失败",
128
+ });
129
+ });
130
+ },
131
+ );
132
+ server.setTimeout(15000);
133
+ server.listen(0, "127.0.0.1");
134
+ await once(server, "listening");
135
+ return server;
136
+ }
@@ -0,0 +1,132 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { fail } from "./http.mjs";
3
+
4
+ function directOffer(sdp) {
5
+ if (typeof sdp !== "string" || sdp.includes("\0")) return false;
6
+ const media = sdp.match(/^m=.*$/gm) || [];
7
+ const candidates = sdp.match(/^a=candidate:.*$/gm) || [];
8
+ return (
9
+ media.length === 1 &&
10
+ /^m=application \d+ UDP\/DTLS\/SCTP webrtc-datachannel\s*$/.test(
11
+ media[0],
12
+ ) &&
13
+ candidates.length <= 64 &&
14
+ !candidates.some((candidate) => /\s+typ\s+relay(?:\s|$)/i.test(candidate))
15
+ );
16
+ }
17
+
18
+ export function createPeerRegistry(PeerConnection, connectPeer) {
19
+ const peers = new Set();
20
+
21
+ async function offer(link, sdp, signal) {
22
+ if (!directOffer(sdp)) throw fail("无效的 WebRTC 直连请求", 400);
23
+ if (
24
+ peers.size >= 32 ||
25
+ [...peers].filter((peer) => peer.link === link).length >= 8
26
+ )
27
+ throw fail("P2P 连接数已达上限,请关闭闲置页面后重试", 429);
28
+ signal.throwIfAborted();
29
+ const rtc = new PeerConnection(`claudex-${randomUUID()}`, {
30
+ iceServers: ["stun:stun.l.google.com:19302"],
31
+ disableAutoNegotiation: true,
32
+ maxMessageSize: 16 * 1024,
33
+ });
34
+ let channel;
35
+ let detach;
36
+ let deadline;
37
+ let stopWaiting;
38
+ let dropDeadline;
39
+ const peer = { link, dispose };
40
+ peers.add(peer);
41
+
42
+ function dispose() {
43
+ if (!peers.delete(peer)) return;
44
+ clearTimeout(deadline);
45
+ clearTimeout(dropDeadline);
46
+ stopWaiting?.(fail("这次 P2P 连接已关闭", 409));
47
+ detach?.();
48
+ channel?.close();
49
+ rtc.close();
50
+ }
51
+
52
+ function open() {
53
+ if (!peers.has(peer) || detach) return;
54
+ clearTimeout(deadline);
55
+ try {
56
+ detach = connectPeer(channel, link);
57
+ } catch {
58
+ dispose();
59
+ }
60
+ }
61
+
62
+ const onAborted = () => dispose();
63
+ signal.addEventListener("abort", onAborted, { once: true });
64
+ try {
65
+ deadline = setTimeout(dispose, 30000);
66
+ deadline.unref();
67
+ rtc.onStateChange((state) => {
68
+ clearTimeout(dropDeadline);
69
+ if (!peers.has(peer)) return;
70
+ if (state === "failed" || state === "closed") dispose();
71
+ if (state === "disconnected") {
72
+ dropDeadline = setTimeout(dispose, 15000);
73
+ dropDeadline.unref();
74
+ }
75
+ });
76
+ rtc.onDataChannel((incoming) => {
77
+ if (!peers.has(peer) || channel || incoming.getLabel() !== "claudex") {
78
+ incoming.close();
79
+ return;
80
+ }
81
+ channel = incoming;
82
+ channel.onClosed(dispose);
83
+ channel.onError(dispose);
84
+ channel.onOpen(open);
85
+ if (channel.isOpen()) open();
86
+ });
87
+ const answer = await new Promise((resolve, reject) => {
88
+ const finish = () => {
89
+ try {
90
+ const result = rtc.localDescription();
91
+ if (!result?.sdp || result.type !== "answer")
92
+ throw fail("暂时无法收集直连地址,请重试", 503);
93
+ resolve({ sdp: result.sdp });
94
+ } catch (error) {
95
+ reject(error);
96
+ }
97
+ };
98
+ const timer = setTimeout(() => stopWaiting?.(), 8000);
99
+ timer.unref();
100
+ stopWaiting = (error) => {
101
+ clearTimeout(timer);
102
+ stopWaiting = undefined;
103
+ if (error) reject(error);
104
+ else finish();
105
+ };
106
+ try {
107
+ rtc.onGatheringStateChange((state) => {
108
+ if (state === "complete") stopWaiting?.();
109
+ });
110
+ rtc.setRemoteDescription(sdp, "offer");
111
+ rtc.setLocalDescription("answer");
112
+ } catch {
113
+ stopWaiting?.(fail("WebRTC 信令格式无效", 400));
114
+ }
115
+ });
116
+ if (!peers.has(peer)) throw fail("这次 P2P 连接已关闭", 409);
117
+ return answer;
118
+ } catch (error) {
119
+ dispose();
120
+ throw error;
121
+ } finally {
122
+ signal.removeEventListener("abort", onAborted);
123
+ }
124
+ }
125
+
126
+ return {
127
+ offer,
128
+ close(link) {
129
+ for (const peer of peers) if (!link || peer.link === link) peer.dispose();
130
+ },
131
+ };
132
+ }
@@ -0,0 +1,229 @@
1
+ import { randomBytes, randomUUID } from "node:crypto";
2
+ import { join } from "node:path";
3
+ import { fail, openSignalingServer } from "./http.mjs";
4
+ import { createPeerRegistry } from "./peers.mjs";
5
+ import { readPrivateJson, writePrivateJson } from "./storage.mjs";
6
+ import { runPublicTunnel } from "./tunnel.mjs";
7
+
8
+ export { createP2pManagementHandler } from "./http.mjs";
9
+
10
+ const tokenPattern = /^[A-Za-z0-9_-]{43}$/;
11
+ const idPattern = /^[a-f0-9-]{36}$/;
12
+
13
+ function asHttpsOrigin(input) {
14
+ const url = new URL(input);
15
+ if (url.protocol !== "https:" || url.href !== `${url.origin}/`)
16
+ throw new Error("P2P 域名须为 HTTPS 来源地址");
17
+ return url.origin;
18
+ }
19
+
20
+ function validSettings(value) {
21
+ return (
22
+ typeof value?.enabled === "boolean" &&
23
+ (value.origin === null || asHttpsOrigin(value.origin) === value.origin) &&
24
+ Array.isArray(value.links) &&
25
+ (!value.links.length || Boolean(value.origin)) &&
26
+ value.links.every(
27
+ ({ id, label, createdAt, token }) =>
28
+ idPattern.test(id) &&
29
+ typeof label === "string" &&
30
+ typeof createdAt === "string" &&
31
+ tokenPattern.test(token),
32
+ )
33
+ );
34
+ }
35
+
36
+ export function createP2pService({
37
+ configDirectory,
38
+ assetsDirectory,
39
+ connectPeer,
40
+ revokeLink,
41
+ runTunnel = runPublicTunnel,
42
+ }) {
43
+ const directory = join(configDirectory, "p2p");
44
+ const settingsFile = join(directory, "links.json");
45
+ let settings = { enabled: false, origin: null, links: [] };
46
+ let state = "disabled";
47
+ let error = null;
48
+ let settingsError = false;
49
+ let stopped = false;
50
+ let active;
51
+ let queue = Promise.resolve();
52
+ let tokens = new Map();
53
+
54
+ function serial(action) {
55
+ const update = queue.then(action);
56
+ queue = update.catch(() => {});
57
+ return update;
58
+ }
59
+
60
+ function apply(next) {
61
+ settings = next;
62
+ tokens = new Map(next.links.map(({ token, id }) => [token, id]));
63
+ }
64
+
65
+ async function save(next) {
66
+ await writePrivateJson(settingsFile, next);
67
+ apply(next);
68
+ }
69
+
70
+ function publicLink({ id, label, createdAt, token }) {
71
+ return { id, label, createdAt, url: `${settings.origin}/p2p#${token}` };
72
+ }
73
+
74
+ function status() {
75
+ return {
76
+ enabled: settings.enabled,
77
+ state,
78
+ origin: settings.origin,
79
+ error,
80
+ links: settings.links.map(publicLink),
81
+ };
82
+ }
83
+
84
+ async function serve(lifetime) {
85
+ const signal = lifetime.controller.signal;
86
+ const current = () => settings.enabled && !signal.aborted && !stopped;
87
+ let local;
88
+ try {
89
+ const sdk = await import("node-datachannel").catch(() => {
90
+ throw new Error("当前安装缺少可用的 WebRTC 原生组件");
91
+ });
92
+ if (!current()) return;
93
+ lifetime.peers = createPeerRegistry(sdk.PeerConnection, connectPeer);
94
+ local = await openSignalingServer({
95
+ assetsDirectory,
96
+ getOrigin: () => (current() ? lifetime.origin : null),
97
+ negotiate({ token, sdp }, requestSignal) {
98
+ const id = typeof token === "string" && tokens.get(token);
99
+ if (!current() || !id) throw fail("P2P 链接无效或已撤销", 401);
100
+ return lifetime.peers.offer(id, sdp, requestSignal);
101
+ },
102
+ });
103
+ if (!current()) return;
104
+ await runTunnel({
105
+ directory,
106
+ port: local.address().port,
107
+ signal,
108
+ onOrigin: (url) =>
109
+ serial(async () => {
110
+ if (!current()) return;
111
+ const origin = asHttpsOrigin(url);
112
+ if (settings.origin !== origin) {
113
+ if (settings.links.length)
114
+ throw new Error("OpenTunnel 域名与已有链接不匹配");
115
+ await save({ ...settings, origin });
116
+ }
117
+ lifetime.origin = origin;
118
+ }),
119
+ onState(next, message = null) {
120
+ if (!current()) return;
121
+ state = next;
122
+ error = message;
123
+ },
124
+ });
125
+ } catch (cause) {
126
+ if (current()) {
127
+ state = "error";
128
+ error = cause.message;
129
+ }
130
+ } finally {
131
+ lifetime.peers?.close();
132
+ if (local) {
133
+ await new Promise((resolve) => {
134
+ local.close(resolve);
135
+ local.closeAllConnections();
136
+ });
137
+ }
138
+ }
139
+ }
140
+
141
+ function startTunnel() {
142
+ if (active || !settings.enabled || stopped) return;
143
+ state = "connecting";
144
+ error = null;
145
+ const lifetime = { controller: new AbortController(), origin: null };
146
+ active = lifetime;
147
+ lifetime.done = serve(lifetime).finally(() => {
148
+ active = undefined;
149
+ if (lifetime.controller.signal.aborted) startTunnel();
150
+ });
151
+ }
152
+
153
+ function stopTunnel() {
154
+ active?.peers?.close();
155
+ active?.controller.abort();
156
+ }
157
+
158
+ return {
159
+ async start() {
160
+ try {
161
+ const stored = await readPrivateJson(settingsFile);
162
+ if (stored !== undefined) {
163
+ if (!validSettings(stored)) throw new Error("P2P 设置格式错误");
164
+ apply(stored);
165
+ }
166
+ } catch {
167
+ settingsError = true;
168
+ state = "error";
169
+ error = "无法读取 P2P 设置文件";
170
+ }
171
+ startTunnel();
172
+ },
173
+ async close() {
174
+ stopped = true;
175
+ stopTunnel();
176
+ await queue;
177
+ await active?.done;
178
+ },
179
+ manage(action, input = {}) {
180
+ return serial(async () => {
181
+ if (action === "status") return status();
182
+ if (stopped || settingsError)
183
+ throw fail(error || "P2P 服务已停止", 503);
184
+ if (action === "enable" || action === "disable") {
185
+ const enabled = action === "enable";
186
+ if (settings.enabled !== enabled)
187
+ await save({ ...settings, enabled });
188
+ if (enabled) {
189
+ if (active?.controller.signal.aborted) state = "connecting";
190
+ startTunnel();
191
+ } else {
192
+ state = "disabled";
193
+ error = null;
194
+ stopTunnel();
195
+ }
196
+ } else if (action === "create") {
197
+ if (!settings.enabled || state !== "online" || !settings.origin)
198
+ throw fail("请在 P2P 已连接后创建链接", 409);
199
+ const label =
200
+ typeof input.label === "string" ? input.label.trim() : "";
201
+ if (
202
+ (input.label !== undefined && typeof input.label !== "string") ||
203
+ [...label].length > 80 ||
204
+ /\p{Cc}/u.test(label)
205
+ )
206
+ throw fail("链接名称须为 80 字以内的文本", 400);
207
+ const link = {
208
+ id: randomUUID(),
209
+ label: label || "远程访问",
210
+ createdAt: new Date().toISOString(),
211
+ token: randomBytes(32).toString("base64url"),
212
+ };
213
+ await save({ ...settings, links: [...settings.links, link] });
214
+ return { ...status(), created: publicLink(link) };
215
+ } else if (action === "revoke") {
216
+ const links = settings.links.filter(({ id }) => id !== input.id);
217
+ if (links.length === settings.links.length)
218
+ throw fail("P2P 链接不存在", 404);
219
+ await save({ ...settings, links });
220
+ active?.peers?.close(input.id);
221
+ await revokeLink?.(input.id);
222
+ } else {
223
+ throw fail("P2P 操作不存在", 404);
224
+ }
225
+ return status();
226
+ });
227
+ },
228
+ };
229
+ }
@@ -0,0 +1,45 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { writePrivateFile } from "../private-file.mjs";
3
+
4
+ export async function readPrivateJson(file) {
5
+ try {
6
+ return JSON.parse(await readFile(file, "utf8"));
7
+ } catch (error) {
8
+ if (error.code !== "ENOENT") throw error;
9
+ return undefined;
10
+ }
11
+ }
12
+
13
+ export function writePrivateJson(file, data) {
14
+ return writePrivateFile(file, JSON.stringify(data, null, 2) + "\n");
15
+ }
16
+
17
+ export async function tunnelStorage(file, api, profile) {
18
+ let state = (await readPrivateJson(file)) ?? { api };
19
+ if (state.api !== api)
20
+ throw new Error("OpenTunnel 服务地址与现有隧道身份不匹配");
21
+
22
+ async function update(next) {
23
+ await writePrivateJson(file, next);
24
+ state = next;
25
+ }
26
+
27
+ function identity() {
28
+ return (
29
+ state.identity && {
30
+ ...state.identity,
31
+ certificateExpiry: new Date(state.identity.certificateExpiry),
32
+ }
33
+ );
34
+ }
35
+
36
+ return {
37
+ profiles: async () => (state.identity || state.pending ? [profile] : []),
38
+ load: async () => identity(),
39
+ save: (_, value) => update({ api, identity: value }),
40
+ loadPending: async () => state.pending,
41
+ savePending: (_, pending) => update({ ...state, pending }),
42
+ remove: () => update({ api }),
43
+ list: async () => (state.identity ? [{ profile, tunnel: identity() }] : []),
44
+ };
45
+ }