@dshtrading/client-ui-trading 0.1.0

package/lib/bridge.js

@@ -0,0 +1,794 @@
+import { aggregateNews, fetchCnFundamentalsPackage } from "@dshtrading/kit-cn";
+import { aggregateNews as aggregateNews$1, fetchHkFundamentalsPackage } from "@dshtrading/kit-hk";
+import { aggregateNews as aggregateNews$2, fetchUsFundamentalsPackage } from "@dshtrading/kit-us";
+import { aggregateNews as aggregateNews$3, fetchCryptoFundamentalsPackage } from "@dshtrading/kit-crypto";
+import { createMemoryCustomIndicatorStore } from "@dshtrading/indicators";
+import { createMemoryKnowledgeCardStore } from "@dshtrading/knowledge";
+import { createMemoryCustomStrategyStore } from "@dshtrading/strategies";
+import { createMemorySelectionStore, createMemoryWatchlistStore } from "@dshtrading/watchlist";
+//#region src/bridge.ts
+const MARKET_IDS = [
+	"crypto",
+	"us",
+	"cn",
+	"hk"
+];
+/** market → Context 服务键（@dshtrading/api 的 Context 增强）。 */
+const MARKET_SERVICE_KEYS = {
+	crypto: "tradingCryptoMarketData",
+	us: "tradingUsMarketData",
+	cn: "tradingCnMarketData",
+	hk: "tradingHkMarketData"
+};
+/**
+* 桥宿主工厂（registry-first 解析的唯一实现，node 半与单测共用）：
+* - getMarketService：注册表有激活注册项 → 用之；否则回退 legacy 市场键直读
+*   （2026-08-30 前形态：连接器老 dataplane 互斥 provide 市场键的部署）。
+* - activeProvider：优先报告实际供数的注册项 provider；注册表未裁决时回退 router 值
+*   （选中但未注册 → 用户能在 GUI 看到设置目标，行情区报「未安装/未激活」）。
+*/
+function createBridgeHost(services) {
+	return {
+		getMarketService: (market) => {
+			const active = services.registry?.active(market);
+			if (active !== void 0) return active.service;
+			return services.legacy(market);
+		},
+		getTradeService: (market) => services.tradeRegistry?.active(market)?.service,
+		activeProvider: (market) => services.registry?.active(market)?.provider ?? services.router?.activeProvider(market),
+		customIndicatorsStore: services.customIndicatorsStore ?? createMemoryCustomIndicatorStore(),
+		knowledgeStore: services.knowledgeStore ?? createMemoryKnowledgeCardStore(),
+		strategyStore: services.strategyStore ?? createMemoryCustomStrategyStore(),
+		watchlistStore: services.watchlistStore ?? createMemoryWatchlistStore(),
+		selectionStore: services.selectionStore ?? createMemorySelectionStore(),
+		newsRegistry: services.newsRegistry,
+		newsKey: services.newsKey
+	};
+}
+/** 单次 K 线 limit 封顶（与 Binance/Bybit 单请求上限对齐；OKX 超出 300 的部分由连接器 after 游标翻页补足）。 */
+const MAX_KLINE_LIMIT = 1e3;
+var BridgeProtocolError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(message);
+		this.status = status;
+	}
+};
+function isMarketId(value) {
+	return MARKET_IDS.includes(value);
+}
+/** 动态标的全集缓存 TTL（30分钟）。 */
+const SYMBOLS_CACHE_TTL_MS = 18e5;
+/**
+* 基本面数据包缓存 TTL（5分钟）：财报级/日级数据，非 tick；同键 in-flight 去重
+* 让 tab 翻转与快速切标的只打一轮上游（issue #36 整改，2026-09-02）。
+*/
+const FUNDAMENTALS_CACHE_TTL_MS = 3e5;
+/** 从 Error 上提取结构化错误词汇（连接器按 TradingError 形状附加 code）。 */
+function errorPayload(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)
+	};
+}
+var TradingBridge = class {
+	host;
+	symbolsCache = /* @__PURE__ */ new Map();
+	fundamentalsCache = /* @__PURE__ */ new Map();
+	fundamentalsInflight = /* @__PURE__ */ new Map();
+	constructor(host) {
+		this.host = host;
+	}
+	/** 已安装（有行情服务）的市场清单 + 当前 provider slug。 */
+	markets() {
+		const markets = [];
+		for (const id of MARKET_IDS) {
+			if (this.host.getMarketService(id) === void 0) continue;
+			const provider = this.host.activeProvider(id);
+			markets.push(provider === void 0 ? { id } : {
+				id,
+				provider
+			});
+		}
+		return { markets };
+	}
+	/** 批量报价：逐 symbol 独立成功/失败（一个坏代码不拖垮整批）。 */
+	async tickers(market, symbols) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const unique = [...new Set(symbols.map((symbol) => symbol.trim()).filter(Boolean))];
+		if (unique.length === 0) throw new BridgeProtocolError(400, "tickers: symbols is required");
+		if (unique.length > 32) throw new BridgeProtocolError(400, `tickers: too many symbols (${unique.length} > 32)`);
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		const outcomes = await Promise.all(unique.map(async (symbol) => {
+			try {
+				return {
+					ok: true,
+					ticker: await service.getTicker(symbol)
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					...errorPayload(error)
+				};
+			}
+		}));
+		const tickers = {};
+		unique.forEach((symbol, index) => {
+			tickers[symbol] = outcomes[index];
+		});
+		return { tickers };
+	}
+	/** K 线：透传 interval（连接器自行校验各自支持集）。 */
+	async klines(market, symbol, interval, rawLimit) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trimmed = symbol.trim();
+		if (trimmed === "") throw new BridgeProtocolError(400, "klines: symbol is required");
+		const limit = rawLimit === null || rawLimit === void 0 ? void 0 : Number(rawLimit);
+		if (limit !== void 0 && (!Number.isInteger(limit) || limit <= 0 || limit > 1e3)) throw new BridgeProtocolError(400, `klines: limit must be an integer in 1..${MAX_KLINE_LIMIT}`);
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		return { klines: await service.getKlines(trimmed, interval, limit) };
+	}
+	/** 动态标的全集（带 30min 进程内缓存；未实现或异常静默回落空列表）。 */
+	async symbols(market, query) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		if (typeof service.listInstruments !== "function") return { symbols: [] };
+		const trimmed = query?.trim().toLowerCase();
+		if (trimmed) try {
+			const list = await service.listInstruments(trimmed);
+			let symbols = Array.isArray(list) ? list.map((item) => ({
+				symbol: item.symbol,
+				...item.name ? { name: item.name } : {}
+			})) : [];
+			if (!(symbols.length === 0 || symbols.every((s) => s.symbol.toLowerCase().includes(trimmed) || s.name !== void 0 && s.name.toLowerCase().includes(trimmed)))) symbols = symbols.filter((s) => s.symbol.toLowerCase().includes(trimmed) || s.name !== void 0 && s.name.toLowerCase().includes(trimmed));
+			return { symbols };
+		} catch {
+			return { symbols: [] };
+		}
+		const cached = this.symbolsCache.get(market);
+		if (cached !== void 0 && Date.now() - cached.fetchedAt < 18e5) return { symbols: cached.list };
+		try {
+			const list = await service.listInstruments();
+			const symbols = Array.isArray(list) ? list.map((item) => ({
+				symbol: item.symbol,
+				...item.name ? { name: item.name } : {}
+			})) : [];
+			this.symbolsCache.set(market, {
+				list: symbols,
+				fetchedAt: Date.now()
+			});
+			return { symbols };
+		} catch {
+			return { symbols: [] };
+		}
+	}
+	/**
+	* 衍生品指标快照（GUI「衍生品」面板，issue #38）：单 symbol 透传注册表解析出的
+	* 行情服务。连接器未实现可选 getDerivatives（现货/股票数据源）→ 业务错误
+	* TRADING_NOT_IMPLEMENTED（HTTP 200 + ok:false），前端直接隐藏面板（不降级）。
+	*/
+	async derivatives(market, symbol) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trimmed = symbol.trim();
+		if (trimmed === "") throw new BridgeProtocolError(400, "derivatives: symbol is required");
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		if (typeof service.getDerivatives !== "function") throw Object.assign(/* @__PURE__ */ new Error(`market ${market} provider does not implement derivatives — spot market`), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			derivatives: await service.getDerivatives(trimmed)
+		};
+	}
+	/**
+	* 衍生品历史序列（GUI「衍生品」页签趋势卡，issue #54）：单 symbol 透传。
+	* 连接器未实现可选 getDerivativesHistory → TRADING_NOT_IMPLEMENTED 业务错误
+	* （HTTP 200 + ok:false），前端隐藏趋势卡、保留快照读数（与快照同纪律）。
+	*/
+	async derivativesHistory(market, symbol) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trimmed = symbol.trim();
+		if (trimmed === "") throw new BridgeProtocolError(400, "derivatives history: symbol is required");
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		if (typeof service.getDerivativesHistory !== "function") throw Object.assign(/* @__PURE__ */ new Error(`market ${market} provider does not implement derivatives history`), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			history: await service.getDerivativesHistory(trimmed)
+		};
+	}
+	/**
+	* 盘口快照（GUI「盘口」竖栏，issue #39）：单 symbol 透传。连接器未实现可选
+	* getOrderbook（yahoo/stooq/腾讯 r_hk）→ TRADING_NOT_IMPLEMENTED 业务错误，
+	* 前端竖栏显示「该市场未提供盘口」。
+	*/
+	async orderbook(market, symbol) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trimmed = symbol.trim();
+		if (trimmed === "") throw new BridgeProtocolError(400, "orderbook: symbol is required");
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		if (typeof service.getOrderbook !== "function") throw Object.assign(/* @__PURE__ */ new Error(`market ${market} provider does not implement orderbook`), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			orderbook: await service.getOrderbook(trimmed)
+		};
+	}
+	/**
+	* 最近逐笔成交（GUI「分笔」流水，issue #39）：透传 limit（服务端封顶）。
+	* 未实现可选 getRecentTrades（腾讯沪深行情行无逐笔端点）→ TRADING_NOT_IMPLEMENTED。
+	*/
+	async trades(market, symbol, rawLimit) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trimmed = symbol.trim();
+		if (trimmed === "") throw new BridgeProtocolError(400, "trades: symbol is required");
+		const limit = rawLimit === null || rawLimit === void 0 ? void 0 : Number(rawLimit);
+		if (limit !== void 0 && (!Number.isInteger(limit) || limit <= 0 || limit > 100)) throw new BridgeProtocolError(400, `trades: limit must be an integer in 1..100`);
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		if (typeof service.getRecentTrades !== "function") throw Object.assign(/* @__PURE__ */ new Error(`market ${market} provider does not implement recent trades`), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			trades: await service.getRecentTrades(trimmed, limit)
+		};
+	}
+	/** 交易服务解析：注册表无注册项（未安装交易连接器）→ undefined（调用方 400）。 */
+	#requireTradeService(market) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trade = this.host.getTradeService?.(market);
+		if (trade === void 0) throw new BridgeProtocolError(400, `no trade service for market ${market}`);
+		return trade;
+	}
+	async positions(market) {
+		return {
+			ok: true,
+			positions: await this.#requireTradeService(market).getPositions()
+		};
+	}
+	async balances(market) {
+		const trade = this.#requireTradeService(market);
+		if (typeof trade.getBalances !== "function") throw Object.assign(/* @__PURE__ */ new Error("trade service does not implement balances"), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			balances: await trade.getBalances()
+		};
+	}
+	async openOrders(market) {
+		const trade = this.#requireTradeService(market);
+		if (typeof trade.listOpenOrders !== "function") throw Object.assign(/* @__PURE__ */ new Error("trade service does not implement open orders"), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			orders: await trade.listOpenOrders()
+		};
+	}
+	async tradeFills(market) {
+		const trade = this.#requireTradeService(market);
+		if (typeof trade.listTradeFills !== "function") throw Object.assign(/* @__PURE__ */ new Error("trade service does not implement trade fills"), { code: "TRADING_NOT_IMPLEMENTED" });
+		return {
+			ok: true,
+			fills: await trade.listTradeFills()
+		};
+	}
+	/**
+	* GUI 下单（真交易执行）：支持实盘报单（默认 dryRun: false）。
+	* 若底层连接器未配置 API 凭证或未开启 liveTrading，由服务缝闸门抛出标准错误，
+	* 桥层如实向前端返回，杜绝伪造假成交。
+	*/
+	async placeOrderFromGui(market, body) {
+		const trade = this.#requireTradeService(market);
+		const symbol = typeof body.symbol === "string" ? body.symbol.trim() : "";
+		const side = body.side === "sell" ? "sell" : body.side === "buy" ? "buy" : void 0;
+		const type = body.type === "limit" ? "limit" : body.type === "market" ? "market" : void 0;
+		const quantity = typeof body.quantity === "number" ? body.quantity : NaN;
+		if (symbol === "") throw new BridgeProtocolError(400, "place order: symbol is required");
+		if (side === void 0) throw new BridgeProtocolError(400, "place order: side must be buy or sell");
+		if (type === void 0) throw new BridgeProtocolError(400, "place order: type must be market or limit");
+		if (!Number.isFinite(quantity) || quantity <= 0) throw new BridgeProtocolError(400, "place order: quantity must be a positive number");
+		const price = typeof body.price === "number" ? body.price : void 0;
+		if (type === "limit" && (price === void 0 || !Number.isFinite(price) || price <= 0)) throw new BridgeProtocolError(400, "place order: limit orders require a positive price");
+		const requestedDryRun = typeof body.dryRun === "boolean" ? body.dryRun : false;
+		return {
+			ok: true,
+			order: await trade.placeOrder({
+				symbol,
+				side,
+				type,
+				quantity,
+				...price !== void 0 ? { price } : {},
+				dryRun: requestedDryRun
+			})
+		};
+	}
+	/** GUI 撤单（issue #40）：按 market + orderId + 可选 symbol 分发到激活的交易服务。 */
+	async cancelOrderFromGui(market, orderId, symbol) {
+		const trade = this.#requireTradeService(market);
+		const trimmedId = orderId.trim();
+		if (!trimmedId) throw new BridgeProtocolError(400, "cancel order: id is required");
+		await trade.cancelOrder(trimmedId, symbol?.trim());
+		return {
+			ok: true,
+			canceled: true
+		};
+	}
+	/** 自定义指标列表。 */
+	async customIndicators() {
+		const store = this.host.customIndicatorsStore;
+		if (store === void 0) return {
+			ok: true,
+			indicators: []
+		};
+		return {
+			ok: true,
+			indicators: await store.list()
+		};
+	}
+	/** 删除自定义指标。 */
+	async deleteCustomIndicator(id) {
+		const store = this.host.customIndicatorsStore;
+		if (store === void 0) return {
+			ok: true,
+			removed: false
+		};
+		return {
+			ok: true,
+			removed: await store.remove(id)
+		};
+	}
+	/** 获取全部沉淀的知识卡片列表。 */
+	async knowledgeCards() {
+		const store = this.host.knowledgeStore;
+		if (store === void 0) return {
+			ok: true,
+			cards: []
+		};
+		return {
+			ok: true,
+			cards: await store.list()
+		};
+	}
+	/**
+	* 标的新闻与公告聚合（issue #37）：按市场从 newsRegistry 解析到 Kit 注册的
+	* 聚合器；未注册时回退到各 Kit 导出的 aggregateNews 纯函数（无活跃会话时亦可用）。
+	* 只返回与标的相关的条目（2026-09-03 owner 裁决）：无相关新闻/公告就返回空列表，
+	* 不再回退展示大盘要闻——此前的智能回退会把已抓到的公告挤出 limit 截尾窗。
+	*/
+	async news(market, symbol, rawLimit) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const aggregator = this.host.newsRegistry?.get(market) ?? (market === "cn" ? aggregateNews : market === "hk" ? aggregateNews$1 : market === "us" ? aggregateNews$2 : market === "crypto" ? aggregateNews$3 : void 0);
+		if (aggregator === void 0) throw Object.assign(/* @__PURE__ */ new Error(`market ${market} does not have a news provider`), { code: "TRADING_NOT_IMPLEMENTED" });
+		const limit = rawLimit === null || rawLimit === void 0 ? void 0 : Number(rawLimit);
+		if (limit !== void 0 && (!Number.isInteger(limit) || limit <= 0 || limit > 50)) throw new BridgeProtocolError(400, `news: limit must be an integer in 1..50`);
+		const result = await aggregator({
+			symbol: symbol ?? void 0,
+			limit: limit ?? 20,
+			windowHours: 24,
+			cryptoPanicKey: this.host.newsKey?.()
+		});
+		return {
+			ok: true,
+			items: result.items,
+			unavailable: result.unavailable
+		};
+	}
+	/** 自定义策略名册（issue #31）：返回记录，前端校验后并入名册。 */
+	async customStrategies() {
+		const store = this.host.strategyStore;
+		if (store === void 0) return {
+			ok: true,
+			strategies: []
+		};
+		return {
+			ok: true,
+			strategies: await store.list()
+		};
+	}
+	/** 删除自定义策略（issue #31）。 */
+	async deleteCustomStrategy(id) {
+		const store = this.host.strategyStore;
+		if (store === void 0) return {
+			ok: true,
+			removed: false
+		};
+		return {
+			ok: true,
+			removed: await store.remove(id)
+		};
+	}
+	/**
+	* 标的基本面快照与多期财务矩阵（GUI「基本面」页签，2026-09-02 / Issue #36）。
+	*
+	* 语义（重构自协作者初版，2026-09-02 审查整改）：
+	* - 数据包（kit 的多期报表/股东/分红等下钻）直接按市场取，不要求连接器实现
+	*   getFundamentals——us/crypto 由此可达；快照部分为可选增强（连接器实现了才合并）。
+	* - 快照与数据包并行取（Promise.all）；任一失败只降级自己那半，另一半照常返回。
+	* - 两个都失败 → TRADING_NOT_IMPLEMENTED 业务错误（HTTP 200 + ok:false），
+	*   前端显示诚实空态；不再有「半旧数据冒充新标的」的路径。
+	* - 5 分钟进程内 TTL 缓存（财报级数据，非 tick）+ 同键 in-flight 去重，
+	*   对齐本桥 symbols() 的缓存先例；一次 tab 翻转只打一轮上游。
+	*/
+	async fundamentals(market, symbol) {
+		if (!isMarketId(market)) throw new BridgeProtocolError(400, `unknown market ${JSON.stringify(market)}`);
+		const trimmed = symbol.trim();
+		if (trimmed === "") throw new BridgeProtocolError(400, "fundamentals: symbol is required");
+		const service = this.host.getMarketService(market);
+		if (service === void 0) throw new BridgeProtocolError(400, `market ${market} is not installed`);
+		const cacheKey = `${market}:${trimmed}`;
+		const cached = this.fundamentalsCache.get(cacheKey);
+		if (cached !== void 0 && Date.now() - cached.fetchedAt < 3e5) return {
+			ok: true,
+			fundamentals: cached.pkg
+		};
+		const inflight = this.fundamentalsInflight.get(cacheKey);
+		if (inflight !== void 0) return {
+			ok: true,
+			fundamentals: await inflight
+		};
+		const job = (async () => {
+			const [snapshot, pkg] = await Promise.all([typeof service.getFundamentals === "function" ? service.getFundamentals(trimmed).catch(() => void 0) : Promise.resolve(void 0), this.#fetchPkg(market, trimmed)]);
+			if (snapshot === void 0 && pkg === void 0) throw Object.assign(/* @__PURE__ */ new Error(`no fundamentals data for ${market}/${trimmed} — provider and drill-down both unavailable`), { code: "TRADING_NOT_IMPLEMENTED" });
+			const result = pkg !== void 0 ? {
+				...pkg,
+				stock: {
+					...pkg.stock ?? {},
+					...snapshot ?? {}
+				},
+				timestamp: snapshot?.timestamp ?? Date.now()
+			} : snapshot;
+			this.fundamentalsCache.set(cacheKey, {
+				pkg: result,
+				fetchedAt: Date.now()
+			});
+			return result;
+		})();
+		this.fundamentalsInflight.set(cacheKey, job);
+		try {
+			return {
+				ok: true,
+				fundamentals: await job
+			};
+		} finally {
+			this.fundamentalsInflight.delete(cacheKey);
+		}
+	}
+	/** 按市场拉 kit 基本面数据包；kit 未覆盖或上游失败 → undefined（不算错误）。 */
+	async #fetchPkg(market, symbol) {
+		try {
+			const pkg = market === "cn" ? await fetchCnFundamentalsPackage(symbol) : market === "hk" ? await fetchHkFundamentalsPackage(symbol) : market === "us" ? await fetchUsFundamentalsPackage(symbol) : market === "crypto" ? await fetchCryptoFundamentalsPackage(symbol) : void 0;
+			if (pkg === void 0) return void 0;
+			return pkg.matrix !== void 0 || pkg.stock !== void 0 || pkg.crypto !== void 0 || pkg.profile?.description !== void 0 || pkg.profile?.industry !== void 0 || (pkg.shareholders?.length ?? 0) > 0 || (pkg.reports?.length ?? 0) > 0 || (pkg.mainOperations?.length ?? 0) > 0 || (pkg.dividends?.length ?? 0) > 0 || pkg.forecast !== void 0 || pkg.holderSummary !== void 0 || pkg.efficiency !== void 0 || (pkg.insiderTrades?.length ?? 0) > 0 || (pkg.institutionalHoldings?.length ?? 0) > 0 || (pkg.dividends?.length ?? 0) > 0 || (pkg.splits?.length ?? 0) > 0 ? pkg : void 0;
+		} catch {}
+	}
+	/** 全量读取自选行（不含客户端种子回退）。 */
+	async watchlistRows() {
+		const store = this.host.watchlistStore;
+		if (store === void 0) return {
+			ok: true,
+			watchlists: {}
+		};
+		return {
+			ok: true,
+			watchlists: await store.list()
+		};
+	}
+	/** 全量替换自选（客户端启动同步）。 */
+	async replaceWatchlists(body) {
+		const store = this.host.watchlistStore;
+		if (store === void 0) return {
+			ok: true,
+			watchlists: {}
+		};
+		const map = parseWatchlistsMap(body);
+		await store.save(map);
+		return {
+			ok: true,
+			watchlists: await store.list()
+		};
+	}
+	/** 追加一行（POST /watchlists）。 */
+	async addWatchlistRow(body) {
+		const store = this.host.watchlistStore;
+		if (store === void 0) return {
+			ok: true,
+			added: false,
+			instrument: parseInstrumentBody(body)
+		};
+		const instrument = parseInstrumentBody(body);
+		return {
+			ok: true,
+			added: await store.add(instrument.market, instrument),
+			instrument
+		};
+	}
+	/** 移除一行（DELETE /watchlists?market&symbol）。 */
+	async removeWatchlistRow(market, symbol) {
+		const store = this.host.watchlistStore;
+		if (store === void 0 || !market || !symbol) return {
+			ok: true,
+			removed: false
+		};
+		return {
+			ok: true,
+			removed: await store.remove(market, symbol)
+		};
+	}
+	/**
+	* 一次性迁移导入（POST /watchlists/import）：host 非空拒绝（幂等，防重复导入）。
+	*/
+	async importWatchlists(body) {
+		const store = this.host.watchlistStore;
+		if (store === void 0) return {
+			ok: false,
+			imported: false,
+			reason: "watchlist store is not mounted"
+		};
+		const existing = await store.list();
+		if (Object.values(existing).reduce((sum, rows) => sum + (rows?.length ?? 0), 0) > 0) return {
+			ok: false,
+			imported: false,
+			reason: "host watchlist store is not empty — migration already done (idempotent guard)"
+		};
+		const map = parseWatchlistsMap(body);
+		await store.save(map);
+		return {
+			ok: true,
+			imported: true
+		};
+	}
+	/** 读取选中标的（GET /selection）。 */
+	async selection() {
+		const store = this.host.selectionStore;
+		if (store === void 0) return {
+			ok: true,
+			instrument: null
+		};
+		return {
+			ok: true,
+			instrument: (await store.get()).instrument
+		};
+	}
+	/** 设置选中标的（PUT /selection；watchlist_select 工具与左栏点击同源）。 */
+	async putSelection(body) {
+		const store = this.host.selectionStore;
+		const parsed = body;
+		const instrument = parsed?.instrument === void 0 || parsed.instrument === null ? null : {
+			market: String(parsed.instrument.market ?? ""),
+			symbol: String(parsed.instrument.symbol ?? ""),
+			...parsed.instrument.name !== void 0 ? { name: String(parsed.instrument.name) } : {}
+		};
+		if (store === void 0) return {
+			ok: true,
+			instrument
+		};
+		await store.set({ instrument });
+		return {
+			ok: true,
+			instrument
+		};
+	}
+};
+/** 自选 map 的形状校验（Record<market, Instrument[]>，宽容 name 缺省）。 */
+function parseWatchlistsMap(body) {
+	if (typeof body !== "object" || body === null) throw new BridgeProtocolError(400, "watchlists body must be an object");
+	const raw = body.watchlists ?? body;
+	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) throw new BridgeProtocolError(400, "watchlists must be an object keyed by market");
+	const out = {};
+	for (const [market, rows] of Object.entries(raw)) {
+		if (!Array.isArray(rows)) continue;
+		out[market] = rows.map((row) => {
+			const r = row;
+			if (typeof r?.symbol !== "string" || !r.symbol) throw new BridgeProtocolError(400, `watchlists[${market}] rows must have string symbol`);
+			return {
+				market: typeof r.market === "string" ? r.market : market,
+				symbol: r.symbol,
+				...typeof r.name === "string" && r.name ? { name: r.name } : {}
+			};
+		});
+	}
+	return out;
+}
+/** 单行 instrument 的形状校验。 */
+function parseInstrumentBody(body) {
+	const raw = body ?? {};
+	const market = typeof raw.market === "string" ? raw.market.trim() : "";
+	const symbol = typeof raw.symbol === "string" ? raw.symbol.trim() : "";
+	if (!market || !symbol) throw new BridgeProtocolError(400, "instrument body requires string market and symbol");
+	return {
+		market,
+		symbol,
+		...typeof raw.name === "string" && raw.name ? { name: raw.name } : {}
+	};
+}
+/** 请求分发：把 (method, pathname, searchParams) 路由到桥方法，返回 (status, payload)。 */
+async function dispatchBridgeRequest(bridge, method, pathname, search, body) {
+	if (method === "GET") switch (pathname) {
+		case "/markets": return {
+			status: 200,
+			payload: bridge.markets()
+		};
+		case "/tickers": {
+			const market = search.get("market") ?? "";
+			const symbols = (search.get("symbols") ?? "").split(",");
+			return {
+				status: 200,
+				payload: await bridge.tickers(market, symbols)
+			};
+		}
+		case "/klines": {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			const interval = search.get("interval") ?? "1d";
+			const limit = search.get("limit");
+			return {
+				status: 200,
+				payload: await bridge.klines(market, symbol, interval, limit)
+			};
+		}
+		case "/symbols": {
+			const market = search.get("market") ?? "";
+			const query = search.get("query") ?? void 0;
+			return {
+				status: 200,
+				payload: await bridge.symbols(market, query)
+			};
+		}
+		case "/fundamentals": {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			return {
+				status: 200,
+				payload: await bridge.fundamentals(market, symbol)
+			};
+		}
+		case "/derivatives": {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			return {
+				status: 200,
+				payload: await bridge.derivatives(market, symbol)
+			};
+		}
+		case "/derivatives/history": {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			return {
+				status: 200,
+				payload: await bridge.derivativesHistory(market, symbol)
+			};
+		}
+		case "/orderbook": {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			return {
+				status: 200,
+				payload: await bridge.orderbook(market, symbol)
+			};
+		}
+		case "/trades": {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			return {
+				status: 200,
+				payload: await bridge.trades(market, symbol, search.get("limit"))
+			};
+		}
+		case "/trade/positions": return {
+			status: 200,
+			payload: await bridge.positions(search.get("market") ?? "")
+		};
+		case "/trade/balances": return {
+			status: 200,
+			payload: await bridge.balances(search.get("market") ?? "")
+		};
+		case "/trade/orders": return {
+			status: 200,
+			payload: await bridge.openOrders(search.get("market") ?? "")
+		};
+		case "/trade/fills": return {
+			status: 200,
+			payload: await bridge.tradeFills(search.get("market") ?? "")
+		};
+		case "/indicators/custom": return {
+			status: 200,
+			payload: await bridge.customIndicators()
+		};
+		case "/knowledge/cards": return {
+			status: 200,
+			payload: await bridge.knowledgeCards()
+		};
+		case "/news": {
+			const market = search.get("market") ?? "";
+			if (!market) throw new BridgeProtocolError(400, "news: market is required");
+			return {
+				status: 200,
+				payload: await bridge.news(market, search.get("symbol"), search.get("limit"))
+			};
+		}
+		case "/strategies/custom": return {
+			status: 200,
+			payload: await bridge.customStrategies()
+		};
+		case "/watchlists": return {
+			status: 200,
+			payload: await bridge.watchlistRows()
+		};
+		case "/selection": return {
+			status: 200,
+			payload: await bridge.selection()
+		};
+		default: throw new BridgeProtocolError(404, `no such endpoint: ${pathname}`);
+	}
+	if (method === "DELETE") {
+		if (pathname === "/indicators/custom") {
+			const id = search.get("id") ?? "";
+			if (!id) throw new BridgeProtocolError(400, "delete custom indicator: id is required");
+			return {
+				status: 200,
+				payload: await bridge.deleteCustomIndicator(id)
+			};
+		}
+		if (pathname === "/strategies/custom") {
+			const id = search.get("id") ?? "";
+			if (!id) throw new BridgeProtocolError(400, "delete custom strategy: id is required");
+			return {
+				status: 200,
+				payload: await bridge.deleteCustomStrategy(id)
+			};
+		}
+		if (pathname === "/trade/order") {
+			const market = search.get("market") ?? "";
+			const orderId = search.get("id") ?? search.get("orderId") ?? "";
+			const symbol = search.get("symbol") ?? void 0;
+			if (!market) throw new BridgeProtocolError(400, "cancel order: market is required");
+			if (!orderId) throw new BridgeProtocolError(400, "cancel order: id is required");
+			return {
+				status: 200,
+				payload: await bridge.cancelOrderFromGui(market, orderId, symbol)
+			};
+		}
+		if (pathname === "/watchlists") {
+			const market = search.get("market") ?? "";
+			const symbol = search.get("symbol") ?? "";
+			if (!market || !symbol) throw new BridgeProtocolError(400, "delete watchlist row: market and symbol are required");
+			return {
+				status: 200,
+				payload: await bridge.removeWatchlistRow(market, symbol)
+			};
+		}
+		throw new BridgeProtocolError(404, `no such endpoint: ${pathname}`);
+	}
+	if (method === "PUT") {
+		if (pathname === "/watchlists") return {
+			status: 200,
+			payload: await bridge.replaceWatchlists(body)
+		};
+		if (pathname === "/selection") return {
+			status: 200,
+			payload: await bridge.putSelection(body)
+		};
+		throw new BridgeProtocolError(404, `no such endpoint: ${pathname}`);
+	}
+	if (method === "POST") {
+		if (pathname === "/trade/order") return {
+			status: 200,
+			payload: await bridge.placeOrderFromGui(search.get("market") ?? "", body)
+		};
+		if (pathname === "/watchlists") return {
+			status: 200,
+			payload: await bridge.addWatchlistRow(body)
+		};
+		if (pathname === "/watchlists/import") return {
+			status: 200,
+			payload: await bridge.importWatchlists(body)
+		};
+		throw new BridgeProtocolError(404, `no such endpoint: ${pathname}`);
+	}
+	throw new BridgeProtocolError(405, "only GET/PUT/POST/DELETE are supported");
+}
+//#endregion
+export { BridgeProtocolError, FUNDAMENTALS_CACHE_TTL_MS, MARKET_IDS, MARKET_SERVICE_KEYS, MAX_KLINE_LIMIT, SYMBOLS_CACHE_TTL_MS, TradingBridge, createBridgeHost, dispatchBridgeRequest, errorPayload };