@tigeropenapi/tigeropen 0.3.0 → 0.4.5

package/dist/esm/client/http-client.js

@@ -1,10 +1,11 @@
-import { getSignContent } from '../signer/sign-content';
-import { signWithRSA, verifyWithRSA } from '../signer/signer';
-import { TigerError } from './errors';
-import { defaultRetryPolicy } from './retry';
-import { parseApiResponse } from './api-response';
+import { TokenManager } from '../config/token-manager.js';
+import { getSignContent } from '../signer/sign-content.js';
+import { signWithRSA, verifyWithRSA } from '../signer/signer.js';
+import { TigerError } from './errors.js';
+import { defaultRetryPolicy } from './retry.js';
+import { parseApiResponse, unmarshalData } from './api-response.js';
 /** SDK 版本号 */
-const SDK_VERSION = '0.1.0';
+const SDK_VERSION = '0.4.0';
 /** User-Agent 字符串 */
 const USER_AGENT = `openapi-typescript-sdk-${SDK_VERSION}`;
 /** 默认字符集 */
@@ -13,14 +14,45 @@ const DEFAULT_CHARSET = 'UTF-8';
 const DEFAULT_SIGN_TYPE = 'RSA';
 /** 默认 API 版本 */
 const DEFAULT_VERSION = '2.0';
+/** Token 刷新 API 方法名 */
+const METHOD_TOKEN_REFRESH = 'user_token_refresh';
+/** 默认后台 token 检查间隔（毫秒）：5 分钟 */
+const DEFAULT_TOKEN_CHECK_INTERVAL = 5 * 60 * 1000;
 /**
  * HttpClient handles HTTP requests, signing, retry, and timeout
  */
 export class HttpClient {
     constructor(config, retryPolicy, options) {
+        /** non-null when auto-refresh is active */
+        this.tokenManager = null;
         this.config = config;
         this.retryPolicy = retryPolicy ?? defaultRetryPolicy();
         this.targetUrl = options?.useQuoteServerUrl ? config.quoteServerUrl : config.serverUrl;
+        // Auto-start token refresh when tokenRefreshDuration is configured (mirrors Go SDK behaviour)
+        if (config.tokenRefreshDuration && config.tokenRefreshDuration > 0) {
+            const interval = config.tokenCheckInterval ?? DEFAULT_TOKEN_CHECK_INTERVAL;
+            const opts = {
+                refreshDuration: config.tokenRefreshDuration,
+                refreshInterval: interval,
+            };
+            if (config.tokenWriter) {
+                opts.tokenWriter = config.tokenWriter;
+            }
+            if (config.tokenLoader) {
+                opts.tokenLoader = config.tokenLoader;
+            }
+            this.tokenManager = this.startTokenAutoRefresh(null, opts);
+        }
+    }
+    /**
+     * Stop the background token auto-refresh timer.
+     * Call this when the HttpClient is no longer needed to avoid timer leaks.
+     */
+    close() {
+        if (this.tokenManager) {
+            this.tokenManager.stopAutoRefresh();
+            this.tokenManager = null;
+        }
     }
     /**
      * Build common request parameters
@@ -31,7 +63,11 @@ export class HttpClient {
             method: apiMethod,
             charset: DEFAULT_CHARSET,
             sign_type: DEFAULT_SIGN_TYPE,
-            timestamp: new Date().toISOString().replace('T', ' ').substring(0, 19),
+            timestamp: (() => {
+                const d = new Date();
+                const pad = (n) => String(n).padStart(2, '0');
+                return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+            })(),
             version: version || DEFAULT_VERSION,
             biz_content: bizContent,
         };
@@ -58,6 +94,7 @@ export class HttpClient {
         const headers = {
             'Content-Type': 'application/json;charset=UTF-8',
             'User-Agent': USER_AGENT,
+            'Connection': 'close',
         };
         if (this.config.token) {
             headers['Authorization'] = this.config.token;
@@ -68,7 +105,8 @@ export class HttpClient {
             body,
             signal: AbortSignal.timeout(this.config.timeout * 1000),
         });
-        return response.text();
+        const text = await response.text();
+        return text;
     }
     /**
      * Execute a structured API request, returning a parsed ApiResponse.
@@ -95,6 +133,10 @@ export class HttpClient {
             }
             catch (err) {
                 lastErr = err;
+                // Only retry on network errors, not API business errors (TigerError with code)
+                if (err.code !== undefined && err.code !== -1) {
+                    throw err; // API returned a business error code, don't retry
+                }
                 if (!this.retryPolicy.shouldRetry(request.method)) {
                     throw err;
                 }
@@ -107,9 +149,10 @@ export class HttpClient {
      *
      * @param apiMethod - API method name (e.g. "market_state", "place_order")
      * @param requestJson - Raw biz_content JSON string
+     * @param version - Optional API version override (default: "2.0")
      * @returns Raw response JSON string, unparsed
      */
-    async execute(apiMethod, requestJson) {
+    async execute(apiMethod, requestJson, version) {
         // Parameter validation
         if (!apiMethod) {
             throw new TigerError(-1, 'api_method must not be empty');
@@ -120,7 +163,7 @@ export class HttpClient {
         catch {
             throw new TigerError(-1, 'request_json is not valid JSON');
         }
-        const params = this.buildCommonParams(apiMethod, requestJson);
+        const params = this.buildCommonParams(apiMethod, requestJson, version);
         const sign = this.signParams(params);
         params['sign'] = sign;
         let lastErr;
@@ -141,6 +184,10 @@ export class HttpClient {
             }
             catch (err) {
                 lastErr = err;
+                // Don't retry API business errors
+                if (err.code !== undefined && err.code !== -1) {
+                    throw err;
+                }
                 if (!this.retryPolicy.shouldRetry(apiMethod)) {
                     throw err;
                 }
@@ -148,6 +195,75 @@ export class HttpClient {
         }
         throw lastErr;
     }
+    /**
+     * 调用 user_token_refresh 接口获取新 token，返回新 token 字符串。
+     * 此方法仅查询，不修改 config 中的 token。
+     */
+    async queryToken() {
+        const params = this.buildCommonParams(METHOD_TOKEN_REFRESH, '{}');
+        const sign = this.signParams(params);
+        params['sign'] = sign;
+        const body = await this.doHttpPost(params);
+        const response = parseApiResponse(body);
+        this.verifyResponseSign(params['timestamp'], response.sign);
+        const data = unmarshalData(response.data);
+        const newToken = data?.token;
+        if (!newToken) {
+            throw new TigerError(-1, '服务端返回空 token');
+        }
+        return newToken;
+    }
+    /**
+     * 刷新 token：调用接口获取新 token 后更新 config.token。
+     *
+     * @param tokenManager - 可选外部 TokenManager；若提供则调用 setToken() 写文件并触发回调。
+     *                       若 NewHttpClient 已自动启动内部 TokenManager，其内存 token 也会同步更新。
+     */
+    async refreshToken(tokenManager) {
+        const newToken = await this.queryToken();
+        this.config.token = newToken;
+        // Keep internal tokenManager in sync so shouldTokenRefresh stays accurate.
+        if (this.tokenManager && tokenManager !== this.tokenManager) {
+            this.tokenManager.syncToken(newToken);
+        }
+        if (tokenManager) {
+            tokenManager.setToken(newToken);
+        }
+    }
+    /**
+     * 启动后台 token 自动刷新。
+     *
+     * @param tokenManager - 可为 null：SDK 内部自动创建一个仅内存的 TokenManager，
+     *   适合直接通过 token 在代码里设置、不使用文件的场景。
+     * @param options - 仅在 tokenManager 为 null 时生效，用于配置内部 TokenManager
+     *   （refreshDuration / refreshInterval / tokenWriter / tokenLoader）。
+     * @returns 使用或创建的 TokenManager 实例
+     */
+    startTokenAutoRefresh(tokenManager, options) {
+        if (!tokenManager) {
+            tokenManager = new TokenManager(options);
+            // 从 config.token 同步当前 token，使 shouldTokenRefresh 能正确判断。
+            // 若 config.token 暂时为空（异步 tokenLoader 尚未 resolve），则先异步加载。
+            if (this.config.token) {
+                tokenManager.syncToken(this.config.token);
+            }
+            else if (options?.tokenLoader) {
+                // tokenLoader 可能是异步的；在后台 resolve 后同步到 config.token 和 TokenManager。
+                Promise.resolve(options.tokenLoader()).then((t) => {
+                    if (t) {
+                        this.config.token = t;
+                        tokenManager.syncToken(t);
+                    }
+                }).catch(() => { });
+            }
+        }
+        tokenManager.startAutoRefresh(async () => {
+            const newToken = await this.queryToken();
+            this.config.token = newToken;
+            return newToken;
+        });
+        return tokenManager;
+    }
     /** Delay for the specified milliseconds */
     sleep(ms) {
         return new Promise((resolve) => setTimeout(resolve, ms));
@@ -161,7 +277,8 @@ export class HttpClient {
      */
     verifyResponseSign(timestamp, signBase64) {
         if (!signBase64) {
-            throw new TigerError(-1, 'Response signature is missing');
+            // Some endpoints don't return a signature; skip verification silently.
+            return;
         }
         const valid = verifyWithRSA(this.config.tigerPublicKey, timestamp, signBase64);
         if (!valid) {

package/dist/esm/client/index.js

@@ -1,9 +1,9 @@
 /**
  * Transport layer exports.
  */
-export { HttpClient } from './http-client';
-export { TigerError, classifyErrorCode } from './errors';
-export { RetryPolicy, defaultRetryPolicy, isTradeOperation } from './retry';
-export { createApiRequest } from './api-request';
-export { parseApiResponse, unmarshalData } from './api-response';
-export { camelToSnake, keysToSnakeCase } from './case-convert';
+export { HttpClient } from './http-client.js';
+export { TigerError, classifyErrorCode } from './errors.js';
+export { RetryPolicy, defaultRetryPolicy, isTradeOperation } from './retry.js';
+export { createApiRequest } from './api-request.js';
+export { parseApiResponse, unmarshalData } from './api-response.js';
+export { camelToSnake, keysToSnakeCase } from './case-convert.js';

package/dist/esm/config/client-config.js

@@ -8,11 +8,12 @@
  *
  * Priority: environment variables > code options (incl. config file) > defaults
  */
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync, existsSync, statSync } from 'fs';
 import { join } from 'path';
 import { homedir, networkInterfaces } from 'os';
-import { parsePropertiesString } from './config-parser';
-import { queryDomains, resolveDynamicServerUrl, resolveDynamicQuoteServerUrl } from './domain';
+import { parsePropertiesString } from './config-parser.js';
+import { queryDomains, resolveDynamicServerUrl, resolveDynamicQuoteServerUrl } from './domain.js';
+import { TokenManager } from './token-manager.js';
 /** Default config file name */
 const CONFIG_FILE_NAME = 'tiger_openapi_config.properties';
 /** Defaults */
@@ -26,6 +27,7 @@ const ENV_TIGER_ID = 'TIGEROPEN_TIGER_ID';
 const ENV_PRIVATE_KEY = 'TIGEROPEN_PRIVATE_KEY';
 const ENV_ACCOUNT = 'TIGEROPEN_ACCOUNT';
 const ENV_TOKEN = 'TIGEROPEN_TOKEN';
+const ENV_TOKEN_FILE = 'TIGEROPEN_TOKEN_FILE';
 /**
  * Load and parse a Java-style properties file.
  *
@@ -99,7 +101,18 @@ export function createClientConfig(options) {
     // Load properties: explicit path > auto-discovery
     let fileProps = {};
     if (opts.propertiesFilePath) {
-        fileProps = loadPropertiesFile(opts.propertiesFilePath);
+        // Support both directory path and full file path
+        let filePath = opts.propertiesFilePath;
+        if (existsSync(filePath) && statSync(filePath).isDirectory()) {
+            filePath = join(filePath, CONFIG_FILE_NAME);
+        }
+        else if (!existsSync(filePath) && !filePath.endsWith('.properties')) {
+            // Path doesn't exist as-is; try treating it as a directory
+            const asDir = join(filePath, CONFIG_FILE_NAME);
+            if (existsSync(asDir))
+                filePath = asDir;
+        }
+        fileProps = loadPropertiesFile(filePath);
     }
     else {
         const discovered = discoverConfigFile();
@@ -132,6 +145,37 @@ export function createClientConfig(options) {
     if (envToken) {
         token = envToken;
     }
+    // Token loading priority: env TIGEROPEN_TOKEN > tokenLoader > token file (TIGEROPEN_TOKEN_FILE or default)
+    if (!token) {
+        if (opts.tokenLoader) {
+            // tokenLoader is async-capable; we do a best-effort synchronous call here.
+            // If the loader returns a Promise, the token will be set later via HttpClient.
+            try {
+                const result = opts.tokenLoader();
+                if (result instanceof Promise) {
+                    // Cannot await in sync constructor; HttpClient.startTokenAutoRefresh() will
+                    // resolve this Promise and sync the token after construction.
+                }
+                else if (result) {
+                    token = result;
+                }
+            }
+            catch {
+                // loader failed; leave token undefined
+            }
+        }
+        else {
+            // Load from token file: TIGEROPEN_TOKEN_FILE env var > default file
+            const tokenFilePath = process.env[ENV_TOKEN_FILE] || 'tiger_openapi_token.properties';
+            const tm = new TokenManager({ filePath: tokenFilePath });
+            try {
+                token = tm.loadTokenSync();
+            }
+            catch {
+                // file not found or no token field; leave token undefined
+            }
+        }
+    }
     // Validate required fields
     if (!tigerId) {
         throw new Error(`tigerId is required. Set it via options.tigerId, a config file, or the ${ENV_TIGER_ID} environment variable.`);
@@ -143,15 +187,16 @@ export function createClientConfig(options) {
     const enableDynamicDomain = opts.enableDynamicDomain ?? true;
     let serverUrl;
     let quoteServerUrl;
+    // Query dynamic domains once (may spawn a child process); reuse for both URLs.
+    let domainConf = {};
+    if (enableDynamicDomain && (!opts.serverUrl || !opts.quoteServerUrl)) {
+        domainConf = queryDomains(license);
+    }
     if (opts.serverUrl) {
         serverUrl = opts.serverUrl;
     }
     else {
-        let dynamicUrl = '';
-        if (enableDynamicDomain) {
-            const domainConf = queryDomains(license);
-            dynamicUrl = resolveDynamicServerUrl(domainConf, license);
-        }
+        const dynamicUrl = resolveDynamicServerUrl(domainConf, license);
         serverUrl = dynamicUrl || DEFAULT_SERVER_URL;
     }
     // Resolve quote server URL: explicit > dynamic domain > serverUrl fallback
@@ -159,11 +204,7 @@ export function createClientConfig(options) {
         quoteServerUrl = opts.quoteServerUrl;
     }
     else {
-        let dynamicQuoteUrl = '';
-        if (enableDynamicDomain) {
-            const domainConf = queryDomains(license);
-            dynamicQuoteUrl = resolveDynamicQuoteServerUrl(domainConf, license);
-        }
+        const dynamicQuoteUrl = resolveDynamicQuoteServerUrl(domainConf, license);
         quoteServerUrl = dynamicQuoteUrl || serverUrl;
     }
     return {
@@ -176,10 +217,13 @@ export function createClientConfig(options) {
         timeout: opts.timeout ?? DEFAULT_TIMEOUT,
         token,
         tokenRefreshDuration: opts.tokenRefreshDuration,
+        tokenCheckInterval: opts.tokenCheckInterval,
+        tokenLoader: opts.tokenLoader,
+        tokenWriter: opts.tokenWriter,
         serverUrl,
         quoteServerUrl,
         deviceId: detectDeviceId(),
-        tigerPublicKey: TIGER_PUBLIC_KEY,
+        tigerPublicKey: opts.tigerPublicKey ?? TIGER_PUBLIC_KEY,
     };
 }
 /**

package/dist/esm/config/index.js

@@ -1,6 +1,7 @@
 /**
  * 配置层导出
  */
-export { parsePropertiesFile, parsePropertiesString } from './config-parser';
-export { createClientConfig, loadPropertiesFile } from './client-config';
-export { queryDomains, resolveDynamicServerUrl, resolveDynamicQuoteServerUrl } from './domain';
+export { parsePropertiesFile, parsePropertiesString } from './config-parser.js';
+export { createClientConfig, loadPropertiesFile } from './client-config.js';
+export { TokenManager } from './token-manager.js';
+export { queryDomains, resolveDynamicServerUrl, resolveDynamicQuoteServerUrl } from './domain.js';

package/dist/esm/config/token-manager.js

@@ -6,7 +6,7 @@
  */
 import { readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { dirname } from 'path';
-import { parsePropertiesString } from './config-parser';
+import { parsePropertiesString } from './config-parser.js';
 /** 默认 Token 文件名 */
 const DEFAULT_TOKEN_FILE = 'tiger_openapi_token.properties';
 /** 默认刷新间隔（毫秒）：24 小时 */
@@ -18,6 +18,7 @@ export class TokenManager {
     constructor(options) {
         this.token = '';
         this.timer = null;
+        this.fileEnabled = options?.filePath !== undefined;
         this.filePath = options?.filePath ?? DEFAULT_TOKEN_FILE;
         this.refreshInterval = options?.refreshInterval ?? DEFAULT_REFRESH_INTERVAL;
         let dur = options?.refreshDuration ?? 0;
@@ -25,9 +26,39 @@ export class TokenManager {
             dur = 30;
         }
         this.refreshDuration = dur;
+        this.tokenLoader = options?.tokenLoader;
+        this.tokenWriter = options?.tokenWriter;
     }
-    /** 从 properties 文件加载 Token */
-    loadToken() {
+    /**
+     * 从 properties 文件（或自定义 tokenLoader）加载 Token。
+     * 若设置了 tokenLoader，优先调用；否则从 properties 文件读取。
+     */
+    async loadToken() {
+        if (this.tokenLoader) {
+            const token = await this.tokenLoader();
+            if (!token) {
+                throw new Error('自定义 tokenLoader 返回空值');
+            }
+            this.token = token;
+            return token;
+        }
+        const content = readFileSync(this.filePath, 'utf-8');
+        const props = parsePropertiesString(content);
+        const token = props['token'];
+        if (!token) {
+            throw new Error('Token 文件中未找到 token 字段');
+        }
+        this.token = token;
+        return token;
+    }
+    /**
+     * 同步版文件加载（仅用于无 tokenLoader 时的兼容入口）。
+     * 建议优先使用 loadToken()（异步）。
+     */
+    loadTokenSync() {
+        if (this.tokenLoader) {
+            throw new Error('tokenLoader 是异步函数，请使用 loadToken()');
+        }
         const content = readFileSync(this.filePath, 'utf-8');
         const props = parsePropertiesString(content);
         const token = props['token'];
@@ -41,10 +72,25 @@ export class TokenManager {
     getToken() {
         return this.token;
     }
-    /** 设置 Token 并更新文件 */
+    /**
+     * 设置 Token；若启用了文件持久化（显式传入 filePath），则同步写文件。
+     * 成功后触发 tokenWriter 回调（如有）。
+     */
     setToken(token) {
         this.token = token;
-        this.saveTokenToFile(token);
+        if (this.fileEnabled) {
+            this.saveTokenToFile(token);
+        }
+        if (this.tokenWriter) {
+            this.tokenWriter(token);
+        }
+    }
+    /**
+     * 仅更新内存中的 token，不写文件，不触发 tokenWriter 回调。
+     * 用于多个组件共享 token 时的内部同步。
+     */
+    syncToken(token) {
+        this.token = token;
     }
     /** 将 Token 保存到 properties 文件 */
     saveTokenToFile(token) {
@@ -101,6 +147,10 @@ export class TokenManager {
                 // 刷新失败时静默跳过
             }
         }, this.refreshInterval);
+        // 防止 timer 阻止 Node.js 进程退出
+        if (this.timer.unref) {
+            this.timer.unref();
+        }
     }
     /** 停止后台刷新 */
     stopAutoRefresh() {

package/dist/esm/index.js

@@ -15,4 +15,18 @@
  * @packageDocumentation
  */
 /** SDK 版本号 */
-export const VERSION = '0.3.0';
+export const VERSION = '0.4.4';
+// Config
+export { createClientConfig, loadPropertiesFile } from './config/index.js';
+export { TokenManager } from './config/index.js';
+// Transport
+export { HttpClient } from './client/index.js';
+export { TigerError, classifyErrorCode } from './client/index.js';
+// Clients
+export { QuoteClient, parseOptionIdentifier } from './quote/index.js';
+export { TradeClient } from './trade/index.js';
+export { PushClient, ConnectionState, SubjectType } from './push/index.js';
+export { marketOrder, limitOrder, stopOrder, stopLimitOrder } from './model/order-helpers.js';
+export { normalizeOrderStatus } from './model/order-status.js';
+// Enums
+export { OrderStatus, SecurityType, OrderType, TimeInForce, Market, Currency, QuoteRight, SegmentType, OrderSortBy, CorporateActionType, IndustryLevel, SortDirection, OptionAnalysisPeriod, FinancialReportPeriod, Language, License, BarPeriod, orderStatusCode, } from './model/enums.js';

package/dist/esm/logger/index.js

@@ -1,4 +1,4 @@
 /**
  * 日志模块导出
  */
-export * from './logger';
+export * from './logger.js';

package/dist/esm/model/contract-helpers.js

@@ -1,4 +1,4 @@
-import { SecurityType } from './enums';
+import { SecurityType } from './enums.js';
 /** 构造股票合约 */
 export function stockContract(symbol, currency) {
     return { symbol, secType: SecurityType.STK, currency };

package/dist/esm/model/enums.js

@@ -48,19 +48,49 @@ export var OrderType;
     OrderType["VWAP"] = "VWAP";
     OrderType["OCA"] = "OCA";
 })(OrderType || (OrderType = {}));
-/** 订单状态枚举 */
+/**
+ * 订单状态枚举。对齐 Java SDK OrderStatus 定义。
+ *
+ * 服务端 wire 返回的值同时可能是:
+ * - 数字: -2 / -1 / 3 / 4 / 5 / 6 / 7 / 8
+ * - 字符串: "Invalid" / "Initial" / "PendingCancel" / "Cancelled" /
+ *           "Submitted" / "Filled" / "Inactive" / "PendingSubmit"
+ *
+ * Client 层通过 normalizeOrderStatus() 做数字→字符串归一,不做跨别名合并。
+ */
 export var OrderStatus;
 (function (OrderStatus) {
-    OrderStatus["PendingNew"] = "PendingNew";
+    OrderStatus["Invalid"] = "Invalid";
     OrderStatus["Initial"] = "Initial";
+    OrderStatus["PendingCancel"] = "PendingCancel";
+    OrderStatus["Cancelled"] = "Cancelled";
     OrderStatus["Submitted"] = "Submitted";
-    OrderStatus["PartiallyFilled"] = "PartiallyFilled";
     OrderStatus["Filled"] = "Filled";
-    OrderStatus["Cancelled"] = "Cancelled";
-    OrderStatus["PendingCancel"] = "PendingCancel";
     OrderStatus["Inactive"] = "Inactive";
-    OrderStatus["Invalid"] = "Invalid";
+    OrderStatus["PendingSubmit"] = "PendingSubmit";
 })(OrderStatus || (OrderStatus = {}));
+/** 返回订单状态对应的服务端数字码,未知返回 0。 */
+export function orderStatusCode(status) {
+    switch (status) {
+        case OrderStatus.Invalid:
+            return -2;
+        case OrderStatus.Initial:
+            return -1;
+        case OrderStatus.PendingCancel:
+            return 3;
+        case OrderStatus.Cancelled:
+            return 4;
+        case OrderStatus.Submitted:
+            return 5;
+        case OrderStatus.Filled:
+            return 6;
+        case OrderStatus.Inactive:
+            return 7;
+        case OrderStatus.PendingSubmit:
+            return 8;
+    }
+    return 0;
+}
 /** K 线周期枚举 */
 export var BarPeriod;
 (function (BarPeriod) {
@@ -105,3 +135,54 @@ export var TimeInForce;
     TimeInForce["GTC"] = "GTC";
     TimeInForce["OPG"] = "OPG";
 })(TimeInForce || (TimeInForce = {}));
+/** 订单排序字段 */
+export var OrderSortBy;
+(function (OrderSortBy) {
+    OrderSortBy["LatestCreated"] = "LATEST_CREATED";
+    OrderSortBy["LatestStatusUpdated"] = "LATEST_STATUS_UPDATED";
+})(OrderSortBy || (OrderSortBy = {}));
+/** 账户分部类型 */
+export var SegmentType;
+(function (SegmentType) {
+    SegmentType["All"] = "ALL";
+    SegmentType["Sec"] = "SEC";
+    SegmentType["Fut"] = "FUT";
+    SegmentType["Fund"] = "FUND";
+})(SegmentType || (SegmentType = {}));
+/** 公司行动类型 */
+export var CorporateActionType;
+(function (CorporateActionType) {
+    CorporateActionType["Split"] = "split";
+    CorporateActionType["Dividend"] = "dividend";
+    CorporateActionType["Earning"] = "earning";
+})(CorporateActionType || (CorporateActionType = {}));
+/** 行业级别 (1~4 级) */
+export var IndustryLevel;
+(function (IndustryLevel) {
+    IndustryLevel["GSector"] = "GSECTOR";
+    IndustryLevel["GGroup"] = "GGROUP";
+    IndustryLevel["GInd"] = "GIND";
+    IndustryLevel["GSubInd"] = "GSUBIND";
+})(IndustryLevel || (IndustryLevel = {}));
+/** 排序方向 */
+export var SortDirection;
+(function (SortDirection) {
+    SortDirection["No"] = "SortDir_No";
+    SortDirection["Ascend"] = "SortDir_Ascend";
+    SortDirection["Descend"] = "SortDir_Descend";
+})(SortDirection || (SortDirection = {}));
+/** 期权分析周期 */
+export var OptionAnalysisPeriod;
+(function (OptionAnalysisPeriod) {
+    OptionAnalysisPeriod["ThreeYear"] = "3year";
+    OptionAnalysisPeriod["FiftyTwoWeek"] = "52week";
+    OptionAnalysisPeriod["TwentySixWeek"] = "26week";
+    OptionAnalysisPeriod["ThirteenWeek"] = "13week";
+})(OptionAnalysisPeriod || (OptionAnalysisPeriod = {}));
+/** 财报类型 */
+export var FinancialReportPeriod;
+(function (FinancialReportPeriod) {
+    FinancialReportPeriod["Annual"] = "Annual";
+    FinancialReportPeriod["Quarterly"] = "Quarterly";
+    FinancialReportPeriod["LTM"] = "LTM";
+})(FinancialReportPeriod || (FinancialReportPeriod = {}));

package/dist/esm/model/order-helpers.js

@@ -1,4 +1,4 @@
-import { OrderType, TimeInForce } from './enums';
+import { OrderType, TimeInForce } from './enums.js';
 /** Market order */
 export function marketOrder(account, symbol, secType, action, quantity) {
     return {

package/dist/esm/model/order-status.js

@@ -0,0 +1,43 @@
+/**
+ * Order status normalization.
+ *
+ * 服务端返回的订单状态有时是整数(-2/-1/3/4/5/6/7/8),有时是字符串
+ * ("Invalid"/"Submitted"/...)。本模块把二者统一为 Java SDK OrderStatus 的
+ * 字符串值。不做跨别名合并。
+ *
+ * 对齐 Java SDK OrderStatus.java。
+ */
+import { OrderStatus } from './enums.js';
+/** 把数字状态码映射到字符串,未识别返回空串。 */
+function statusIntToString(n) {
+    switch (n) {
+        case -2:
+            return OrderStatus.Invalid;
+        case -1:
+            return OrderStatus.Initial;
+        case 3:
+            return OrderStatus.PendingCancel;
+        case 4:
+            return OrderStatus.Cancelled;
+        case 5:
+            return OrderStatus.Submitted;
+        case 6:
+            return OrderStatus.Filled;
+        case 7:
+            return OrderStatus.Inactive;
+        case 8:
+            return OrderStatus.PendingSubmit;
+    }
+    return '';
+}
+/**
+ * 把服务端可能返回的 string/number 订单状态归一为字符串。
+ * 字符串原样透传;数字按映射表转换;其他输入返回空串。
+ */
+export function normalizeOrderStatus(raw) {
+    if (typeof raw === 'string')
+        return raw;
+    if (typeof raw === 'number')
+        return statusIntToString(raw);
+    return '';
+}