@dshtrading/connector-alpaca 0.5.0 → 0.6.1

package/README.md

@@ -7,7 +7,7 @@
 node scripts/new-connector.mjs --slug bybit --title Bybit --market crypto
 ```
 
-生成后按 [docs/connector-playbook.md](../../docs/connector-playbook.md) 的填写顺序
+生成后按 [docs/guides/connector-playbook.md](../../docs/guides/connector-playbook.md) 的填写顺序
 （src/rest.ts 头部清单 7 项）实现 TODO。每个 TODO 的参照段都在 connector-okx
 （packages/connector-okx/），它是本仓第一个真实 TradeService 连接器。
 

package/lib/index.d.ts

@@ -49,7 +49,7 @@ declare class AlpacaMarketDataService extends Service implements MarketDataServi
 }
 declare class AlpacaTradeService extends Service implements TradeService {
   private readonly client;
-  /** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 总闸门）。 */
+  /** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
   private readonly config;
   private readonly getCredentials;
   constructor(ctx: Context, options: AlpacaRestOptions & {

package/lib/index.js

@@ -1,8 +1,14 @@
 import { AlpacaRestClient, INTERVAL_TO_ALPACA, INTERVAL_VOCABULARY, TradingServiceError, normalizeUsSymbol } from "./rest.js";
+import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
+/**
+* Alpaca 连接器插件（dsh-trading us 切片）：MarketDataService 与 TradeService。
+*
+* @module @dshtrading/connector-alpaca
+*/
 const name = "dsh-trading-us-connector-alpaca";
 const Config = Schema.object({
 	enabled: Schema.boolean().default(false),
@@ -97,7 +103,7 @@ var AlpacaMarketDataService = class extends Service {
 };
 var AlpacaTradeService = class extends Service {
 	client;
-	/** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 总闸门）。 */
+	/** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
 	config;
 	getCredentials;
 	constructor(ctx, options, getCredentials, serviceName = TRADING_US_TRADE_KEY) {
@@ -116,7 +122,7 @@ var AlpacaTradeService = class extends Service {
 	}
 	async placeOrder(order) {
 		const requestedDryRun = order.dryRun ?? true;
-		if (!requestedDryRun && !this.config.liveTrading) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `Alpaca TradeService.placeOrder rejected: the request asks for real execution (dryRun=${String(order.dryRun)}) but liveTrading=false — enable liveTrading explicitly or keep dryRun=true for a simulated fill.`);
+		if (!requestedDryRun && !liveTradingEnabled(this.config.liveTrading)) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `Alpaca TradeService.placeOrder rejected: the request asks for real execution (dryRun=${String(order.dryRun)}) but the signed live-trading authority does not grant real execution (see @dshtrading/authority) — keep dryRun=true for a simulated fill.`);
 		if (requestedDryRun || this.config.dryRun) return {
 			id: `dry-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
 			symbol: order.symbol,
@@ -138,7 +144,7 @@ var AlpacaTradeService = class extends Service {
 		});
 	}
 	async cancelOrder(orderId, _symbol) {
-		if (!this.config.liveTrading || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "Alpaca TradeService.cancelOrder rejected at the service seam: cancel is a live action and requires liveTrading=true with dryRun=false.");
+		if (!liveTradingEnabled(this.config.liveTrading) || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "Alpaca TradeService.cancelOrder rejected at the service seam: cancel is a live action and requires a signed live-trading grant (see @dshtrading/authority) with dryRun=false.");
 		const creds = await this.getCredentials();
 		await this.client.cancelOrder(creds, orderId);
 	}
@@ -173,10 +179,10 @@ var AlpacaTradeService = class extends Service {
 };
 function evaluateOrderGate(config, args) {
 	const requestedDryRun = args.dryRun ?? true;
-	if (!requestedDryRun && !config.liveTrading) return {
+	if (!requestedDryRun && !liveTradingEnabled(config.liveTrading)) return {
 		action: "reject",
 		code: "TRADING_LIVE_TRADING_DISABLED",
-		message: `us_place_order rejected: real execution requested (dryRun=${String(args.dryRun)}) but live trading is disabled (liveTrading=false). Enable liveTrading explicitly or keep dryRun=true.`
+		message: `us_place_order rejected: real execution requested (dryRun=${String(args.dryRun)}) but live trading is disabled (no signed live-trading grant from the authority plane). Ask the operator to sign a live-trading grant, or keep dryRun=true.`
 	};
 	if (requestedDryRun || config.dryRun) return { action: "simulate" };
 	return { action: "live" };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-alpaca",
   "description": "【模板】交易所连接器插件脚手架：Alpaca（alpaca）v2 插件骨架 —— 市场数据服务 + 交易服务 + 三态闸门 + BYOK 凭证 ref。生成器：node scripts/new-connector.mjs --slug <exchange>",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,7 +21,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.5.0"
+    "@dshtrading/authority": "^0.6.1",
+    "@dshtrading/api": "^0.6.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",