@dshtrading/connector-tencent 0.1.3 → 0.1.5

package/lib/index.d.ts

@@ -40,6 +40,11 @@ declare class TencentMarketDataService extends Service implements MarketDataServ
    */
   getOrderbook(symbol: string): Promise<Orderbook>;
   getKlines(symbol: string, interval: Interval, limit?: number): Promise<Kline[]>;
+  listInstruments(query?: string): Promise<Array<{
+    symbol: string;
+    name: string;
+    pinyin?: string;
+  }>>;
   subscribeTicker(symbol: string, cb: (ticker: Ticker) => void, options?: SubscribeTickerOptions): Disposable;
 }
 /** <market>_place_order 参数契约（dryRun 缺省 true）。 */

package/lib/index.js

@@ -46,6 +46,9 @@ var TencentMarketDataService = class extends Service {
 	getKlines(symbol, interval, limit) {
 		return this.client.getKlines(symbol, interval, limit);
 	}
+	listInstruments(query) {
+		return this.client.listInstruments(query);
+	}
 	subscribeTicker(symbol, cb, options) {
 		const ms = Math.max(options?.intervalMs ?? SUBSCRIBE_DEFAULT_MS, SUBSCRIBE_MIN_MS);
 		const tick = () => {

package/lib/rest.d.ts

@@ -8,8 +8,8 @@ declare class TradingServiceError extends Error {
 type TencentMarket = 'cn' | 'hk';
 /**
  * 规范化 A 股符号：接受 `600519` / `SH600519` / `sh600519` / `sz000001`，统一为
- * 腾讯 wire 形态小写 `<sh|sz><6位数字>`。6/9 开头→sh（沪，含科创板 688），0/3 开头→sz
- * （深，含创业板 300）。4/8 开头（北交所）不在本切片支持范围。
+ * 腾讯 wire 形态小写 `<sh|sz><6位数字>`。6/9 开头→sh（沪，含科创板 688），5 开头→sh（沪市基金/ETF），
+ * 0/3 开头→sz（深，含创业板 300；知名上海指数 000688/000300 等推断为 sh）。4/8 开头（北交所）不在本切片支持范围。
  */
 declare function normalizeCnSymbol(symbol: string): string;
 /**
@@ -94,6 +94,8 @@ interface TencentRestOptions {
   readonly klineBaseUrl?: string;
   /** 覆盖分钟 K 线 base（测试/反代用），末尾不带斜杠。 */
   readonly mklineBaseUrl?: string;
+  /** 覆盖智能联想搜索 base（测试/反代用），末尾不带斜杠。 */
+  readonly searchBaseUrl?: string;
   /** 单请求超时（ms），默认 10s。 */
   readonly timeoutMs?: number;
   /** 注入 fetch 实现；缺省用全局 fetch（Node 22+ 内置）。 */
@@ -124,6 +126,15 @@ declare class TencentRestClient {
    * 港股 mkline 端点不支持分钟线，请求 5m/30m 会抛出 TRADING_UNSUPPORTED_INTERVAL。
    */
   getKlines(symbol: string, interval: Interval, limit?: number): Promise<Kline[]>;
+  /**
+   * 智能联想标的列表（按名称、代码、拼音模糊检索）：
+   * 接入腾讯证券智能联想端点，统一格式输出标的 symbol、name、pinyin。
+   */
+  listInstruments(query?: string): Promise<Array<{
+    symbol: string;
+    name: string;
+    pinyin?: string;
+  }>>;
 }
 //#endregion
 export { CnTickerExtra, HkTickerExtra, INTERVAL_VOCABULARY, TencentFundamentals, TencentIntervalDef, TencentKlineType, TencentMarket, TencentRestClient, TencentRestOptions, TencentTicker, TradingServiceError, klineDateToEpochMs, minuteKlineTimeToEpochMs, normalizeCnSymbol, normalizeHkSymbol, normalizeSymbol, parseCnOrderbook, toCanonicalTencentSymbol, wallTimeToEpochMs };

package/lib/rest.js

@@ -10,11 +10,18 @@ var TradingServiceError = class extends Error {
 	}
 };
 const CN_SYMBOL_PATTERN = /^(?:(sh|sz)(\d{6})|(\d{6})(?:\.(sh|sz))?)$/;
+const KNOWN_SH_INDICES = /* @__PURE__ */ new Set([
+	"000688",
+	"000300",
+	"000016",
+	"000905",
+	"000852"
+]);
 const HK_SYMBOL_PATTERN = /^(?:r_hk|hk)?([a-z0-9^]{1,10})(?:\.hk)?$/i;
 /**
 * 规范化 A 股符号：接受 `600519` / `SH600519` / `sh600519` / `sz000001`，统一为
-* 腾讯 wire 形态小写 `<sh|sz><6位数字>`。6/9 开头→sh（沪，含科创板 688），0/3 开头→sz
-* （深，含创业板 300）。4/8 开头（北交所）不在本切片支持范围。
+* 腾讯 wire 形态小写 `<sh|sz><6位数字>`。6/9 开头→sh（沪，含科创板 688），5 开头→sh（沪市基金/ETF），
+* 0/3 开头→sz（深，含创业板 300；知名上海指数 000688/000300 等推断为 sh）。4/8 开头（北交所）不在本切片支持范围。
 */
 function normalizeCnSymbol(symbol) {
 	if (typeof symbol !== "string" || !symbol.trim()) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", "Symbol must be a non-empty string, e.g. 600519 / SH600519 / sz000001");
@@ -22,9 +29,10 @@ function normalizeCnSymbol(symbol) {
 	const m = CN_SYMBOL_PATTERN.exec(raw);
 	if (!m) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `Symbol ${JSON.stringify(symbol)} is not a valid CN A-share symbol (expected 6-digit code, optionally SH/SZ prefixed)`);
 	if (m[1]) return `${m[1]}${m[2]}`;
-	const code = m[3];
+	const code = m[3] ?? "";
+	if (!code) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `Symbol ${JSON.stringify(symbol)} is not a valid CN A-share symbol (expected 6-digit code, optionally SH/SZ prefixed)`);
 	if (m[4]) return `${m[4]}${code}`;
-	return `${code.startsWith("6") || code.startsWith("9") ? "sh" : "sz"}${code}`;
+	return `${code.startsWith("6") || code.startsWith("9") || code.startsWith("5") || KNOWN_SH_INDICES.has(code) ? "sh" : "sz"}${code}`;
 }
 /**
 * 规范化港股符号：接受 `00700` / `700`（1-5 位数字，不足 5 位左补零，统一为 5 位数字
@@ -300,12 +308,14 @@ function parseHkFundamentals(fields, timestamp) {
 const DEFAULT_QUOTE_BASE_URL = "https://qt.gtimg.cn";
 const DEFAULT_KLINE_BASE_URL = "https://web.ifzq.gtimg.cn";
 const DEFAULT_MKLINE_BASE_URL = "https://ifzq.gtimg.cn";
+const DEFAULT_SEARCH_BASE_URL = "https://smartbox.gtimg.cn";
 const DEFAULT_TIMEOUT_MS = 1e4;
 var TencentRestClient = class {
 	#market;
 	#quoteBaseUrl;
 	#klineBaseUrl;
 	#mklineBaseUrl;
+	#searchBaseUrl;
 	#timeoutMs;
 	#fetchImpl;
 	constructor(market, options = {}) {
@@ -313,6 +323,7 @@ var TencentRestClient = class {
 		this.#quoteBaseUrl = options.quoteBaseUrl ?? DEFAULT_QUOTE_BASE_URL;
 		this.#klineBaseUrl = options.klineBaseUrl ?? DEFAULT_KLINE_BASE_URL;
 		this.#mklineBaseUrl = options.mklineBaseUrl ?? DEFAULT_MKLINE_BASE_URL;
+		this.#searchBaseUrl = options.searchBaseUrl ?? DEFAULT_SEARCH_BASE_URL;
 		this.#timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
 		this.#fetchImpl = options.fetchImpl ?? ((input, init) => globalThis.fetch(input, init));
 	}
@@ -444,6 +455,53 @@ var TencentRestClient = class {
 		}
 		return klines;
 	}
+	/**
+	* 智能联想标的列表（按名称、代码、拼音模糊检索）：
+	* 接入腾讯证券智能联想端点，统一格式输出标的 symbol、name、pinyin。
+	*/
+	async listInstruments(query) {
+		const q = query?.trim();
+		if (!q) return [];
+		const url = `${this.#searchBaseUrl}/s3/?t=all&q=${encodeURIComponent(q)}`;
+		let text = "";
+		try {
+			const res = await this.#fetchImpl(url);
+			if (!res.ok) return [];
+			text = await res.text();
+		} catch {
+			return [];
+		}
+		const m = /v_hint="([^"]*)"/.exec(text);
+		if (!m || !m[1]) return [];
+		const records = m[1].replace(/\\u([0-9a-fA-F]{4})/g, (_, hex) => String.fromCharCode(parseInt(hex, 16))).split("^").filter(Boolean);
+		const results = [];
+		const seen = /* @__PURE__ */ new Set();
+		for (const rec of records) {
+			const parts = rec.split("~");
+			if (parts.length < 3) continue;
+			const [mkt, code, name, pinyin] = parts;
+			if (!mkt || !code || !name) continue;
+			let canonicalSymbol = "";
+			if (this.#market === "cn") {
+				const lowerMkt = mkt.toLowerCase();
+				if (lowerMkt === "sh") canonicalSymbol = `${code}.SH`;
+				else if (lowerMkt === "sz") canonicalSymbol = `${code}.SZ`;
+				else if (lowerMkt === "bj") canonicalSymbol = `${code}.BJ`;
+				else continue;
+			} else if (this.#market === "hk") {
+				if (mkt.toLowerCase() === "hk") canonicalSymbol = /^\d+$/.test(code) ? `${code.padStart(5, "0")}.HK` : `${code.toUpperCase()}.HK`;
+				else continue;
+			} else continue;
+			if (seen.has(canonicalSymbol)) continue;
+			seen.add(canonicalSymbol);
+			results.push({
+				symbol: canonicalSymbol,
+				name,
+				...pinyin ? { pinyin: pinyin.toUpperCase() } : {}
+			});
+		}
+		return results;
+	}
 };
 //#endregion
 export { INTERVAL_VOCABULARY, TencentRestClient, TradingServiceError, klineDateToEpochMs, minuteKlineTimeToEpochMs, normalizeCnSymbol, normalizeHkSymbol, normalizeSymbol, parseCnOrderbook, toCanonicalTencentSymbol, wallTimeToEpochMs };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-tencent",
   "description": "CN + HK dual-market connector plugin for dsh-trading: public market data from Tencent quote/kline endpoints implementing the @dshtrading/api contracts (single package, per-instance market split; no key, no official authorization — personal use boundary at your own discretion)",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,7 +21,7 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.1.3"
+    "@dshtrading/api": "^0.1.5"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",