@dshtrading/api 0.2.1 → 0.3.0

package/lib/index.d.ts

@@ -616,6 +616,10 @@ declare module '@deepseek-ai/cordis' {
     tradingCnMarketData: MarketDataService;
     /** hk 市场行情服务（由腾讯连接器同包双实例提供，config.market 分流；cn+hk 切片 2026-08-31 补齐）。 */
     tradingHkMarketData: MarketDataService;
+    /** futures 市场行情服务（由同花顺期货连接器提供，issue #97；日K + 当日分时聚合）。 */
+    tradingFuturesMarketData: MarketDataService;
+    /** 全球品种行情（global 市场：大宗/外汇/海外指数；@dshtrading/connector-jin10 dataplane 行提供）。 */
+    tradingGlobalMarketData: MarketDataService;
     /**
      * crypto 市场交易服务（R3 2026-08-29 补齐，crypto 市场第一个真实 TradeService）：
      * 由 connector-okx 实现（签名 demo/live 下单），与 connector-binance 经
@@ -646,6 +650,8 @@ declare module '@deepseek-ai/cordis' {
      * 各市场 Kit apply 时注册 aggregateNews 纯函数，GUI 行情桥按市场获取。
      */
     tradingNewsRegistry: TradingNewsRegistry;
+    /** 跨市场快讯源（@dshtrading/connector-jin10 提供；缺席 = 未安装快讯连接器）。 */
+    tradingFlashFeed: FlashFeedService;
   }
 }
 /**
@@ -721,6 +727,8 @@ interface NewsItem {
   readonly publishedAt: string;
   /** 关联标的代码（可选，格式随源不同）。 */
   readonly relatedCodes?: readonly string[];
+  /** 热度等级（可选；金十快讯网页版 火/热/沸/爆，其他源不填）。 */
+  readonly hot?: string;
 }
 /** 新闻聚合请求选项。 */
 interface AggregateNewsOptions {
@@ -732,6 +740,11 @@ interface AggregateNewsOptions {
   symbol?: string | undefined;
   /** CryptoPanic API token（仅 crypto 市场使用，可选）。 */
   cryptoPanicKey?: string | undefined;
+  /**
+   * 启用的新闻/公告源 id 列表（issue #96 源配置化；各 kit 的 NewsSource 词汇）。
+   * 缺省 = 该市场全部默认源；空数组 = 显式关闭（返回空结果）。
+   */
+  sources?: readonly string[] | undefined;
 }
 /** 新闻聚合结果。 */
 interface AggregateNewsResult {
@@ -742,6 +755,29 @@ interface AggregateNewsResult {
 }
 /** 新闻聚合器函数签名（各 Kit 导出的 aggregateNews 符合此形状）。 */
 type NewsAggregator = (options?: AggregateNewsOptions) => Promise<AggregateNewsResult>;
+/**
+ * 跨市场快讯源契约（2026-09-13 金十接入）：host 平面由快讯连接器 provide
+ * tradingFlashFeed，GUI 快讯面板（桥 /dshtrading/api/flash）与 agent 快讯工具
+ * 共用同一取数实现；服务缺席 = 未安装/未启用该数据源 → 消费方报
+ * TRADING_NOT_IMPLEMENTED，绝不把「没有数据源」伪装成「没有快讯」。
+ */
+interface FlashFeedService {
+  /**
+   * 最新快讯流（cursor 翻页）；条目只含元数据（标题/时间/链接）。
+   * `hot` 非空时按热度等级服务端过滤（金十网页版 火/热/沸/爆）。
+   */
+  listFlash(options?: {
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    hot?: readonly string[] | undefined;
+  }): Promise<{
+    readonly items: readonly NewsItem[];
+    readonly nextCursor?: string | undefined;
+    readonly hasMore: boolean;
+  }>;
+  /** 关键词搜快讯（上游一次性返回、不支持翻页）。 */
+  searchFlash(keyword: string, limit?: number | undefined): Promise<readonly NewsItem[]>;
+}
 /** 新闻聚合器注册表契约（Issue #37，router 插件提供）。 */
 interface TradingNewsRegistry {
   register(market: string, aggregator: NewsAggregator): () => void;
@@ -749,4 +785,4 @@ interface TradingNewsRegistry {
   markets(): string[];
 }
 //#endregion
-export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, ForecastSummary, FundamentalsPackage, HolderNumSummary, IAccount, InsiderTradeItem, InstitutionalHoldingItem, Interval, Kline, LimitUpPoolItem, MainOperationSegment, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingError, TradingErrorCode, TradingNewsRegistry };
+export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, IAccount, InsiderTradeItem, InstitutionalHoldingItem, Interval, Kline, LimitUpPoolItem, MainOperationSegment, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingError, TradingErrorCode, TradingNewsRegistry };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/api",
   "description": "Pure TypeScript contracts for dsh-trading: market-data/trade service interfaces, domain types, and the shared error vocabulary",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",