@dshtrading/client-ui-trading 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+/** 本插件不硬依赖任何服务（headless 宿主零要求）；web 面依赖在 apply 内声明。 */
+declare const inject: readonly string[];
+/**
+ * Host plugin body：注册 /dshtrading/api 路由（web 宿主）或静默挂起（headless）。
+ * @param ctx - Host cordis context（bundle loader entry）。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { apply, inject };

package/lib/index.js

@@ -0,0 +1,141 @@
+import { BridgeProtocolError, MARKET_SERVICE_KEYS, TradingBridge, createBridgeHost, dispatchBridgeRequest } from "./bridge.js";
+import { attachEventStream } from "./sse.js";
+import { createFileCustomIndicatorStore } from "@dshtrading/indicators/plugin";
+import { createFileKnowledgeCardStore } from "@dshtrading/knowledge/plugin";
+import { createFileCustomStrategyStore } from "@dshtrading/strategies/plugin";
+import { createFileSelectionStore, createFileWatchlistStore } from "@dshtrading/watchlist/plugin";
+import os from "node:os";
+import path from "node:path";
+//#region src/index.ts
+/** 本插件不硬依赖任何服务（headless 宿主零要求）；web 面依赖在 apply 内声明。 */
+const inject = [];
+/** 发送 JSON 响应（禁缓存：行情是易变数据，代理层也不许中间层缓存）。 */
+function sendJson(res, status, payload) {
+	const body = JSON.stringify(payload);
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-store"
+	});
+	res.end(body);
+}
+/**
+* Host plugin body：注册 /dshtrading/api 路由（web 宿主）或静默挂起（headless）。
+* @param ctx - Host cordis context（bundle loader entry）。
+*/
+function apply(ctx) {
+	const serviceGet = (key) => ctx.get?.(key, false);
+	const customIndicatorsStore = serviceGet("tradingCustomIndicators")?.store ?? createFileCustomIndicatorStore(path.join(os.homedir(), ".dsh", "indicators", "custom.json"));
+	const knowledgeStore = serviceGet("tradingKnowledgeCards")?.store ?? createFileKnowledgeCardStore(path.join(os.homedir(), ".dsh", "knowledge", "cards.json"));
+	const strategyStorePath = path.join(os.homedir(), ".dsh", "strategies", "custom.json");
+	const strategyStore = createFileCustomStrategyStore(strategyStorePath);
+	const watchlistStorePath = path.join(os.homedir(), ".dsh", "watchlists.json");
+	const watchlistStore = createFileWatchlistStore(watchlistStorePath);
+	const selectionStorePath = path.join(os.homedir(), ".dsh", "selection.json");
+	const selectionStore = createFileSelectionStore(selectionStorePath);
+	const eventsOf = () => ctx.get?.("tradingEvents", false);
+	ctx.inject(["webServer", "connection"], (webCtx) => {
+		const webServer = webCtx.get("webServer");
+		const connection = webCtx.get("connection");
+		if (webServer === void 0 || connection === void 0) return;
+		const host = createBridgeHost({
+			registry: webCtx.get("tradingMarketDataRegistry", false),
+			tradeRegistry: webCtx.get("tradingTradeRegistry", false),
+			router: webCtx.get("tradingMarketRouter", false),
+			legacy: (market) => webCtx.get(MARKET_SERVICE_KEYS[market]),
+			customIndicatorsStore,
+			knowledgeStore,
+			strategyStore,
+			watchlistStore,
+			selectionStore,
+			newsRegistry: webCtx.get("tradingNewsRegistry", false),
+			newsKey: () => {
+				return webCtx.get("tradingMarketRouter", false)?.newsKey?.();
+			}
+		});
+		const bridge = new TradingBridge(host);
+		const route = {
+			kind: "prefix",
+			path: "/dshtrading/api",
+			handler: async (req, res) => {
+				const rejection = connection.requestRejection(req);
+				if (rejection !== void 0) {
+					res.writeHead(rejection);
+					res.end(rejection === 401 ? "unauthorized" : "forbidden");
+					return;
+				}
+				try {
+					const url = new URL(req.url ?? "/", "http://dsh.local");
+					const mount = "/dshtrading/api";
+					const raw = url.pathname;
+					const sub = raw === mount || raw.startsWith(`${mount}/`) ? raw.slice(15) || "/" : raw;
+					if (req.method === "GET" && sub === "/events") {
+						const events = eventsOf();
+						if (events === void 0) {
+							sendJson(res, 503, {
+								ok: false,
+								code: "TRADING_EVENTS_UNAVAILABLE",
+								message: "tradingEvents service is not mounted"
+							});
+							return;
+						}
+						attachEventStream(res, events);
+						return;
+					}
+					let body;
+					if (req.method === "PUT" || req.method === "POST") body = await readJsonBody(req);
+					const { status, payload } = await dispatchBridgeRequest(bridge, req.method ?? "GET", sub, url.searchParams, body);
+					if (status === 200 && payload?.ok === true) {
+						if (req.method === "DELETE" && sub === "/indicators/custom") eventsOf()?.emit("indicators");
+						if (req.method === "DELETE" && sub === "/strategies/custom") eventsOf()?.emit("strategies");
+						if ((req.method === "PUT" || req.method === "POST" || req.method === "DELETE") && (sub === "/watchlists" || sub === "/watchlists/import")) eventsOf()?.emit("watchlists");
+						if (req.method === "PUT" && sub === "/selection") eventsOf()?.emit("selection");
+					}
+					sendJson(res, status, payload);
+				} catch (error) {
+					if (error instanceof BridgeProtocolError) {
+						sendJson(res, error.status, {
+							ok: false,
+							code: "TRADING_PROTOCOL",
+							message: error.message
+						});
+						return;
+					}
+					sendJson(res, 200, {
+						ok: false,
+						...errorPayloadOf(error)
+					});
+				}
+			}
+		};
+		ctx.effect(() => webServer.register(route), "dsh-trading-client-ui-trading: /dshtrading/api route");
+	});
+}
+/** JSON body 读取（PUT/POST 用；1MB 封顶，非法 JSON → 400 协议错误）。 */
+async function readJsonBody(req) {
+	const chunks = [];
+	let total = 0;
+	for await (const chunk of req) {
+		total += chunk.length;
+		if (total > 1048576) throw new BridgeProtocolError(413, "request body too large (1MB cap)");
+		chunks.push(chunk);
+	}
+	const text = Buffer.concat(chunks).toString("utf8").trim();
+	if (!text) return {};
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new BridgeProtocolError(400, "request body must be valid JSON");
+	}
+}
+function errorPayloadOf(error) {
+	if (error instanceof Error) return {
+		code: typeof error.code === "string" ? error.code : "TRADING_UNKNOWN",
+		message: error.message
+	};
+	return {
+		code: "TRADING_UNKNOWN",
+		message: String(error)
+	};
+}
+//#endregion
+export { apply, inject };

package/lib/sse.js

@@ -0,0 +1,30 @@
+//#region src/sse.ts
+/** 心跳间隔（issue 规格：15s）。 */
+const SSE_HEARTBEAT_MS = 15e3;
+/** 挂载 SSE 流：写响应头 + 订阅扇出 + 心跳；返回清理函数（res.close 时自动调用）。 */
+function attachEventStream(res, events) {
+	res.writeHead(200, {
+		"content-type": "text/event-stream; charset=utf-8",
+		"cache-control": "no-store",
+		"x-accel-buffering": "no"
+	});
+	res.write(": connected\n\n");
+	const unsubscribe = events.subscribe((event) => {
+		res.write(`event: store.changed\ndata: ${JSON.stringify(event)}\n\n`);
+	});
+	const heartbeat = setInterval(() => {
+		res.write(": heartbeat\n\n");
+	}, SSE_HEARTBEAT_MS);
+	let cleaned = false;
+	const cleanup = () => {
+		if (cleaned) return;
+		cleaned = true;
+		clearInterval(heartbeat);
+		unsubscribe();
+	};
+	res.once("close", cleanup);
+	res.once("error", cleanup);
+	return cleanup;
+}
+//#endregion
+export { SSE_HEARTBEAT_MS, attachEventStream };

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@dshtrading/client-ui-trading",
+  "description": "Professional three-column trading terminal shell for the dsh web client: market/watchlist sidebar (shell.overlay), Lightweight Charts v5 quote stage view (MiddleStage), hero-fused session history (shadows sidebar.workspaces), session rail (fold/new/settings), and the /dshtrading/api market-data HTTP bridge on the node half.",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./locales": {
+      "types": "./lib/client/locales.d.ts",
+      "default": "./lib/client/locales.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dependencies": {
+    "lightweight-charts": "^5.2.1",
+    "@dshtrading/eventbus": "^0.1.0",
+    "@dshtrading/indicators": "^0.1.0",
+    "@dshtrading/api": "^0.1.0",
+    "@dshtrading/knowledge": "^0.1.0",
+    "@dshtrading/strategies": "^0.1.0",
+    "@dshtrading/router": "^0.1.0",
+    "@dshtrading/watchlist": "^0.1.0",
+    "@dshtrading/kit-cn": "^0.1.0",
+    "@dshtrading/kit-us": "^0.1.0",
+    "@dshtrading/kit-crypto": "^0.1.0",
+    "@dshtrading/kit-hk": "^0.1.0",
+    "@dshtrading/client-ui-strategies": "^0.1.0",
+    "@dshtrading/client-ui-knowledge": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/dsh-api-session-controller": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-layout": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-workspace": ">=0.1.2-alpha.1",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.7",
+    "lightningcss": "^1.0.0",
+    "react": "^18.2.0",
+    "tsdown": "^0.22.0",
+    "vitest": "^3.0.0",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.2-alpha.3",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.3",
+    "jsdom": "^30.0.1",
+    "react-dom": "^18.3.1"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-workspace"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown && tsdown --config tsdown.client.config.mjs",
+    "build": "tsdown && tsdown --config tsdown.client.config.mjs",
+    "test": "vitest run"
+  }
+}