@tigeropenapi/tigeropen 0.3.0 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/dist/cjs/client/case-convert.js +4 -3
  2. package/dist/cjs/client/http-client.js +123 -6
  3. package/dist/cjs/config/client-config.js +56 -12
  4. package/dist/cjs/config/index.js +3 -1
  5. package/dist/cjs/config/token-manager.js +54 -4
  6. package/dist/cjs/index.js +51 -2
  7. package/dist/cjs/model/enums.js +89 -7
  8. package/dist/cjs/model/order-status.js +46 -0
  9. package/dist/cjs/model/quote-requests.js +11 -0
  10. package/dist/cjs/model/trade-requests.js +13 -0
  11. package/dist/cjs/push/pb/OrderStatusData.js +24 -0
  12. package/dist/cjs/push/proto-message.js +6 -0
  13. package/dist/cjs/push/push-client.js +111 -16
  14. package/dist/cjs/push/push-message.js +4 -0
  15. package/dist/cjs/quote/quote-client.js +333 -9
  16. package/dist/cjs/trade/trade-client.js +204 -25
  17. package/dist/esm/client/api-request.js +1 -1
  18. package/dist/esm/client/api-response.js +1 -1
  19. package/dist/esm/client/case-convert.js +4 -3
  20. package/dist/esm/client/http-client.js +128 -11
  21. package/dist/esm/client/index.js +6 -6
  22. package/dist/esm/config/client-config.js +59 -15
  23. package/dist/esm/config/index.js +4 -3
  24. package/dist/esm/config/token-manager.js +55 -5
  25. package/dist/esm/index.js +15 -1
  26. package/dist/esm/logger/index.js +1 -1
  27. package/dist/esm/model/contract-helpers.js +1 -1
  28. package/dist/esm/model/enums.js +87 -6
  29. package/dist/esm/model/order-helpers.js +1 -1
  30. package/dist/esm/model/order-status.js +43 -0
  31. package/dist/esm/model/quote-requests.js +10 -0
  32. package/dist/esm/model/trade-requests.js +12 -0
  33. package/dist/esm/push/index.js +5 -5
  34. package/dist/esm/push/pb/OrderStatusData.js +24 -0
  35. package/dist/esm/push/pb/PushData.js +11 -11
  36. package/dist/esm/push/pb/QuoteBasicData.js +1 -1
  37. package/dist/esm/push/pb/Response.js +1 -1
  38. package/dist/esm/push/pb/index.js +17 -17
  39. package/dist/esm/push/proto-message.js +9 -3
  40. package/dist/esm/push/push-client.js +118 -23
  41. package/dist/esm/push/push-message.js +4 -0
  42. package/dist/esm/quote/index.js +1 -1
  43. package/dist/esm/quote/quote-client.js +335 -11
  44. package/dist/esm/signer/index.js +2 -2
  45. package/dist/esm/trade/index.js +1 -1
  46. package/dist/esm/trade/trade-client.js +206 -27
  47. package/dist/types/client/case-convert.d.ts +3 -1
  48. package/dist/types/client/http-client.d.ts +32 -1
  49. package/dist/types/config/client-config.d.ts +16 -1
  50. package/dist/types/config/index.d.ts +2 -0
  51. package/dist/types/config/token-manager.d.ts +27 -3
  52. package/dist/types/index.d.ts +22 -1
  53. package/dist/types/model/enums.d.ts +60 -6
  54. package/dist/types/model/order-status.d.ts +14 -0
  55. package/dist/types/model/quote-requests.d.ts +344 -0
  56. package/dist/types/model/quote.d.ts +261 -0
  57. package/dist/types/model/trade-requests.d.ts +260 -0
  58. package/dist/types/model/trade.d.ts +214 -1
  59. package/dist/types/push/pb/OrderStatusData.d.ts +4 -0
  60. package/dist/types/push/push-client.d.ts +36 -3
  61. package/dist/types/push/push-message.d.ts +4 -0
  62. package/dist/types/quote/quote-client.d.ts +121 -6
  63. package/dist/types/trade/trade-client.d.ts +95 -12
  64. package/package.json +2 -2
@@ -17,7 +17,9 @@ function camelToSnake(key) {
17
17
  /**
18
18
  * Recursively convert all object keys from camelCase to snake_case.
19
19
  * Preserves arrays, primitives, and Date/null/undefined.
20
- * Keys already containing an underscore are kept as-is (already snake_case).
20
+ *
21
+ * Note: camelToSnake is idempotent for pure snake_case keys (no uppercase
22
+ * letters → no replacements), so no pre-check is needed.
21
23
  */
22
24
  function keysToSnakeCase(value) {
23
25
  if (Array.isArray(value)) {
@@ -26,8 +28,7 @@ function keysToSnakeCase(value) {
26
28
  if (value && typeof value === 'object' && value.constructor === Object) {
27
29
  const out = {};
28
30
  for (const [k, v] of Object.entries(value)) {
29
- const newKey = k.includes('_') ? k : camelToSnake(k);
30
- out[newKey] = keysToSnakeCase(v);
31
+ out[camelToSnake(k)] = keysToSnakeCase(v);
31
32
  }
32
33
  return out;
33
34
  }
@@ -1,13 +1,14 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.HttpClient = void 0;
4
+ const token_manager_1 = require("../config/token-manager");
4
5
  const sign_content_1 = require("../signer/sign-content");
5
6
  const signer_1 = require("../signer/signer");
6
7
  const errors_1 = require("./errors");
7
8
  const retry_1 = require("./retry");
8
9
  const api_response_1 = require("./api-response");
9
10
  /** SDK 版本号 */
10
- const SDK_VERSION = '0.1.0';
11
+ const SDK_VERSION = '0.4.0';
11
12
  /** User-Agent 字符串 */
12
13
  const USER_AGENT = `openapi-typescript-sdk-${SDK_VERSION}`;
13
14
  /** 默认字符集 */
@@ -16,14 +17,45 @@ const DEFAULT_CHARSET = 'UTF-8';
16
17
  const DEFAULT_SIGN_TYPE = 'RSA';
17
18
  /** 默认 API 版本 */
18
19
  const DEFAULT_VERSION = '2.0';
20
+ /** Token 刷新 API 方法名 */
21
+ const METHOD_TOKEN_REFRESH = 'user_token_refresh';
22
+ /** 默认后台 token 检查间隔(毫秒):5 分钟 */
23
+ const DEFAULT_TOKEN_CHECK_INTERVAL = 5 * 60 * 1000;
19
24
  /**
20
25
  * HttpClient handles HTTP requests, signing, retry, and timeout
21
26
  */
22
27
  class HttpClient {
23
28
  constructor(config, retryPolicy, options) {
29
+ /** non-null when auto-refresh is active */
30
+ this.tokenManager = null;
24
31
  this.config = config;
25
32
  this.retryPolicy = retryPolicy ?? (0, retry_1.defaultRetryPolicy)();
26
33
  this.targetUrl = options?.useQuoteServerUrl ? config.quoteServerUrl : config.serverUrl;
34
+ // Auto-start token refresh when tokenRefreshDuration is configured (mirrors Go SDK behaviour)
35
+ if (config.tokenRefreshDuration && config.tokenRefreshDuration > 0) {
36
+ const interval = config.tokenCheckInterval ?? DEFAULT_TOKEN_CHECK_INTERVAL;
37
+ const opts = {
38
+ refreshDuration: config.tokenRefreshDuration,
39
+ refreshInterval: interval,
40
+ };
41
+ if (config.tokenWriter) {
42
+ opts.tokenWriter = config.tokenWriter;
43
+ }
44
+ if (config.tokenLoader) {
45
+ opts.tokenLoader = config.tokenLoader;
46
+ }
47
+ this.tokenManager = this.startTokenAutoRefresh(null, opts);
48
+ }
49
+ }
50
+ /**
51
+ * Stop the background token auto-refresh timer.
52
+ * Call this when the HttpClient is no longer needed to avoid timer leaks.
53
+ */
54
+ close() {
55
+ if (this.tokenManager) {
56
+ this.tokenManager.stopAutoRefresh();
57
+ this.tokenManager = null;
58
+ }
27
59
  }
28
60
  /**
29
61
  * Build common request parameters
@@ -34,7 +66,11 @@ class HttpClient {
34
66
  method: apiMethod,
35
67
  charset: DEFAULT_CHARSET,
36
68
  sign_type: DEFAULT_SIGN_TYPE,
37
- timestamp: new Date().toISOString().replace('T', ' ').substring(0, 19),
69
+ timestamp: (() => {
70
+ const d = new Date();
71
+ const pad = (n) => String(n).padStart(2, '0');
72
+ return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
73
+ })(),
38
74
  version: version || DEFAULT_VERSION,
39
75
  biz_content: bizContent,
40
76
  };
@@ -61,6 +97,7 @@ class HttpClient {
61
97
  const headers = {
62
98
  'Content-Type': 'application/json;charset=UTF-8',
63
99
  'User-Agent': USER_AGENT,
100
+ 'Connection': 'close',
64
101
  };
65
102
  if (this.config.token) {
66
103
  headers['Authorization'] = this.config.token;
@@ -71,7 +108,8 @@ class HttpClient {
71
108
  body,
72
109
  signal: AbortSignal.timeout(this.config.timeout * 1000),
73
110
  });
74
- return response.text();
111
+ const text = await response.text();
112
+ return text;
75
113
  }
76
114
  /**
77
115
  * Execute a structured API request, returning a parsed ApiResponse.
@@ -98,6 +136,10 @@ class HttpClient {
98
136
  }
99
137
  catch (err) {
100
138
  lastErr = err;
139
+ // Only retry on network errors, not API business errors (TigerError with code)
140
+ if (err.code !== undefined && err.code !== -1) {
141
+ throw err; // API returned a business error code, don't retry
142
+ }
101
143
  if (!this.retryPolicy.shouldRetry(request.method)) {
102
144
  throw err;
103
145
  }
@@ -110,9 +152,10 @@ class HttpClient {
110
152
  *
111
153
  * @param apiMethod - API method name (e.g. "market_state", "place_order")
112
154
  * @param requestJson - Raw biz_content JSON string
155
+ * @param version - Optional API version override (default: "2.0")
113
156
  * @returns Raw response JSON string, unparsed
114
157
  */
115
- async execute(apiMethod, requestJson) {
158
+ async execute(apiMethod, requestJson, version) {
116
159
  // Parameter validation
117
160
  if (!apiMethod) {
118
161
  throw new errors_1.TigerError(-1, 'api_method must not be empty');
@@ -123,7 +166,7 @@ class HttpClient {
123
166
  catch {
124
167
  throw new errors_1.TigerError(-1, 'request_json is not valid JSON');
125
168
  }
126
- const params = this.buildCommonParams(apiMethod, requestJson);
169
+ const params = this.buildCommonParams(apiMethod, requestJson, version);
127
170
  const sign = this.signParams(params);
128
171
  params['sign'] = sign;
129
172
  let lastErr;
@@ -144,6 +187,10 @@ class HttpClient {
144
187
  }
145
188
  catch (err) {
146
189
  lastErr = err;
190
+ // Don't retry API business errors
191
+ if (err.code !== undefined && err.code !== -1) {
192
+ throw err;
193
+ }
147
194
  if (!this.retryPolicy.shouldRetry(apiMethod)) {
148
195
  throw err;
149
196
  }
@@ -151,6 +198,75 @@ class HttpClient {
151
198
  }
152
199
  throw lastErr;
153
200
  }
201
+ /**
202
+ * 调用 user_token_refresh 接口获取新 token,返回新 token 字符串。
203
+ * 此方法仅查询,不修改 config 中的 token。
204
+ */
205
+ async queryToken() {
206
+ const params = this.buildCommonParams(METHOD_TOKEN_REFRESH, '{}');
207
+ const sign = this.signParams(params);
208
+ params['sign'] = sign;
209
+ const body = await this.doHttpPost(params);
210
+ const response = (0, api_response_1.parseApiResponse)(body);
211
+ this.verifyResponseSign(params['timestamp'], response.sign);
212
+ const data = (0, api_response_1.unmarshalData)(response.data);
213
+ const newToken = data?.token;
214
+ if (!newToken) {
215
+ throw new errors_1.TigerError(-1, '服务端返回空 token');
216
+ }
217
+ return newToken;
218
+ }
219
+ /**
220
+ * 刷新 token:调用接口获取新 token 后更新 config.token。
221
+ *
222
+ * @param tokenManager - 可选外部 TokenManager;若提供则调用 setToken() 写文件并触发回调。
223
+ * 若 NewHttpClient 已自动启动内部 TokenManager,其内存 token 也会同步更新。
224
+ */
225
+ async refreshToken(tokenManager) {
226
+ const newToken = await this.queryToken();
227
+ this.config.token = newToken;
228
+ // Keep internal tokenManager in sync so shouldTokenRefresh stays accurate.
229
+ if (this.tokenManager && tokenManager !== this.tokenManager) {
230
+ this.tokenManager.syncToken(newToken);
231
+ }
232
+ if (tokenManager) {
233
+ tokenManager.setToken(newToken);
234
+ }
235
+ }
236
+ /**
237
+ * 启动后台 token 自动刷新。
238
+ *
239
+ * @param tokenManager - 可为 null:SDK 内部自动创建一个仅内存的 TokenManager,
240
+ * 适合直接通过 token 在代码里设置、不使用文件的场景。
241
+ * @param options - 仅在 tokenManager 为 null 时生效,用于配置内部 TokenManager
242
+ * (refreshDuration / refreshInterval / tokenWriter / tokenLoader)。
243
+ * @returns 使用或创建的 TokenManager 实例
244
+ */
245
+ startTokenAutoRefresh(tokenManager, options) {
246
+ if (!tokenManager) {
247
+ tokenManager = new token_manager_1.TokenManager(options);
248
+ // 从 config.token 同步当前 token,使 shouldTokenRefresh 能正确判断。
249
+ // 若 config.token 暂时为空(异步 tokenLoader 尚未 resolve),则先异步加载。
250
+ if (this.config.token) {
251
+ tokenManager.syncToken(this.config.token);
252
+ }
253
+ else if (options?.tokenLoader) {
254
+ // tokenLoader 可能是异步的;在后台 resolve 后同步到 config.token 和 TokenManager。
255
+ Promise.resolve(options.tokenLoader()).then((t) => {
256
+ if (t) {
257
+ this.config.token = t;
258
+ tokenManager.syncToken(t);
259
+ }
260
+ }).catch(() => { });
261
+ }
262
+ }
263
+ tokenManager.startAutoRefresh(async () => {
264
+ const newToken = await this.queryToken();
265
+ this.config.token = newToken;
266
+ return newToken;
267
+ });
268
+ return tokenManager;
269
+ }
154
270
  /** Delay for the specified milliseconds */
155
271
  sleep(ms) {
156
272
  return new Promise((resolve) => setTimeout(resolve, ms));
@@ -164,7 +280,8 @@ class HttpClient {
164
280
  */
165
281
  verifyResponseSign(timestamp, signBase64) {
166
282
  if (!signBase64) {
167
- throw new errors_1.TigerError(-1, 'Response signature is missing');
283
+ // Some endpoints don't return a signature; skip verification silently.
284
+ return;
168
285
  }
169
286
  const valid = (0, signer_1.verifyWithRSA)(this.config.tigerPublicKey, timestamp, signBase64);
170
287
  if (!valid) {
@@ -17,6 +17,7 @@ const path_1 = require("path");
17
17
  const os_1 = require("os");
18
18
  const config_parser_1 = require("./config-parser");
19
19
  const domain_1 = require("./domain");
20
+ const token_manager_1 = require("./token-manager");
20
21
  /** Default config file name */
21
22
  const CONFIG_FILE_NAME = 'tiger_openapi_config.properties';
22
23
  /** Defaults */
@@ -30,6 +31,7 @@ const ENV_TIGER_ID = 'TIGEROPEN_TIGER_ID';
30
31
  const ENV_PRIVATE_KEY = 'TIGEROPEN_PRIVATE_KEY';
31
32
  const ENV_ACCOUNT = 'TIGEROPEN_ACCOUNT';
32
33
  const ENV_TOKEN = 'TIGEROPEN_TOKEN';
34
+ const ENV_TOKEN_FILE = 'TIGEROPEN_TOKEN_FILE';
33
35
  /**
34
36
  * Load and parse a Java-style properties file.
35
37
  *
@@ -103,7 +105,18 @@ function createClientConfig(options) {
103
105
  // Load properties: explicit path > auto-discovery
104
106
  let fileProps = {};
105
107
  if (opts.propertiesFilePath) {
106
- fileProps = loadPropertiesFile(opts.propertiesFilePath);
108
+ // Support both directory path and full file path
109
+ let filePath = opts.propertiesFilePath;
110
+ if ((0, fs_1.existsSync)(filePath) && (0, fs_1.statSync)(filePath).isDirectory()) {
111
+ filePath = (0, path_1.join)(filePath, CONFIG_FILE_NAME);
112
+ }
113
+ else if (!(0, fs_1.existsSync)(filePath) && !filePath.endsWith('.properties')) {
114
+ // Path doesn't exist as-is; try treating it as a directory
115
+ const asDir = (0, path_1.join)(filePath, CONFIG_FILE_NAME);
116
+ if ((0, fs_1.existsSync)(asDir))
117
+ filePath = asDir;
118
+ }
119
+ fileProps = loadPropertiesFile(filePath);
107
120
  }
108
121
  else {
109
122
  const discovered = discoverConfigFile();
@@ -136,6 +149,37 @@ function createClientConfig(options) {
136
149
  if (envToken) {
137
150
  token = envToken;
138
151
  }
152
+ // Token loading priority: env TIGEROPEN_TOKEN > tokenLoader > token file (TIGEROPEN_TOKEN_FILE or default)
153
+ if (!token) {
154
+ if (opts.tokenLoader) {
155
+ // tokenLoader is async-capable; we do a best-effort synchronous call here.
156
+ // If the loader returns a Promise, the token will be set later via HttpClient.
157
+ try {
158
+ const result = opts.tokenLoader();
159
+ if (result instanceof Promise) {
160
+ // Cannot await in sync constructor; HttpClient.startTokenAutoRefresh() will
161
+ // resolve this Promise and sync the token after construction.
162
+ }
163
+ else if (result) {
164
+ token = result;
165
+ }
166
+ }
167
+ catch {
168
+ // loader failed; leave token undefined
169
+ }
170
+ }
171
+ else {
172
+ // Load from token file: TIGEROPEN_TOKEN_FILE env var > default file
173
+ const tokenFilePath = process.env[ENV_TOKEN_FILE] || 'tiger_openapi_token.properties';
174
+ const tm = new token_manager_1.TokenManager({ filePath: tokenFilePath });
175
+ try {
176
+ token = tm.loadTokenSync();
177
+ }
178
+ catch {
179
+ // file not found or no token field; leave token undefined
180
+ }
181
+ }
182
+ }
139
183
  // Validate required fields
140
184
  if (!tigerId) {
141
185
  throw new Error(`tigerId is required. Set it via options.tigerId, a config file, or the ${ENV_TIGER_ID} environment variable.`);
@@ -147,15 +191,16 @@ function createClientConfig(options) {
147
191
  const enableDynamicDomain = opts.enableDynamicDomain ?? true;
148
192
  let serverUrl;
149
193
  let quoteServerUrl;
194
+ // Query dynamic domains once (may spawn a child process); reuse for both URLs.
195
+ let domainConf = {};
196
+ if (enableDynamicDomain && (!opts.serverUrl || !opts.quoteServerUrl)) {
197
+ domainConf = (0, domain_1.queryDomains)(license);
198
+ }
150
199
  if (opts.serverUrl) {
151
200
  serverUrl = opts.serverUrl;
152
201
  }
153
202
  else {
154
- let dynamicUrl = '';
155
- if (enableDynamicDomain) {
156
- const domainConf = (0, domain_1.queryDomains)(license);
157
- dynamicUrl = (0, domain_1.resolveDynamicServerUrl)(domainConf, license);
158
- }
203
+ const dynamicUrl = (0, domain_1.resolveDynamicServerUrl)(domainConf, license);
159
204
  serverUrl = dynamicUrl || DEFAULT_SERVER_URL;
160
205
  }
161
206
  // Resolve quote server URL: explicit > dynamic domain > serverUrl fallback
@@ -163,11 +208,7 @@ function createClientConfig(options) {
163
208
  quoteServerUrl = opts.quoteServerUrl;
164
209
  }
165
210
  else {
166
- let dynamicQuoteUrl = '';
167
- if (enableDynamicDomain) {
168
- const domainConf = (0, domain_1.queryDomains)(license);
169
- dynamicQuoteUrl = (0, domain_1.resolveDynamicQuoteServerUrl)(domainConf, license);
170
- }
211
+ const dynamicQuoteUrl = (0, domain_1.resolveDynamicQuoteServerUrl)(domainConf, license);
171
212
  quoteServerUrl = dynamicQuoteUrl || serverUrl;
172
213
  }
173
214
  return {
@@ -180,10 +221,13 @@ function createClientConfig(options) {
180
221
  timeout: opts.timeout ?? DEFAULT_TIMEOUT,
181
222
  token,
182
223
  tokenRefreshDuration: opts.tokenRefreshDuration,
224
+ tokenCheckInterval: opts.tokenCheckInterval,
225
+ tokenLoader: opts.tokenLoader,
226
+ tokenWriter: opts.tokenWriter,
183
227
  serverUrl,
184
228
  quoteServerUrl,
185
229
  deviceId: detectDeviceId(),
186
- tigerPublicKey: TIGER_PUBLIC_KEY,
230
+ tigerPublicKey: opts.tigerPublicKey ?? TIGER_PUBLIC_KEY,
187
231
  };
188
232
  }
189
233
  /**
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.resolveDynamicQuoteServerUrl = exports.resolveDynamicServerUrl = exports.queryDomains = exports.loadPropertiesFile = exports.createClientConfig = exports.parsePropertiesString = exports.parsePropertiesFile = void 0;
3
+ exports.resolveDynamicQuoteServerUrl = exports.resolveDynamicServerUrl = exports.queryDomains = exports.TokenManager = exports.loadPropertiesFile = exports.createClientConfig = exports.parsePropertiesString = exports.parsePropertiesFile = void 0;
4
4
  /**
5
5
  * 配置层导出
6
6
  */
@@ -10,6 +10,8 @@ Object.defineProperty(exports, "parsePropertiesString", { enumerable: true, get:
10
10
  var client_config_1 = require("./client-config");
11
11
  Object.defineProperty(exports, "createClientConfig", { enumerable: true, get: function () { return client_config_1.createClientConfig; } });
12
12
  Object.defineProperty(exports, "loadPropertiesFile", { enumerable: true, get: function () { return client_config_1.loadPropertiesFile; } });
13
+ var token_manager_1 = require("./token-manager");
14
+ Object.defineProperty(exports, "TokenManager", { enumerable: true, get: function () { return token_manager_1.TokenManager; } });
13
15
  var domain_1 = require("./domain");
14
16
  Object.defineProperty(exports, "queryDomains", { enumerable: true, get: function () { return domain_1.queryDomains; } });
15
17
  Object.defineProperty(exports, "resolveDynamicServerUrl", { enumerable: true, get: function () { return domain_1.resolveDynamicServerUrl; } });
@@ -21,6 +21,7 @@ class TokenManager {
21
21
  constructor(options) {
22
22
  this.token = '';
23
23
  this.timer = null;
24
+ this.fileEnabled = options?.filePath !== undefined;
24
25
  this.filePath = options?.filePath ?? DEFAULT_TOKEN_FILE;
25
26
  this.refreshInterval = options?.refreshInterval ?? DEFAULT_REFRESH_INTERVAL;
26
27
  let dur = options?.refreshDuration ?? 0;
@@ -28,9 +29,39 @@ class TokenManager {
28
29
  dur = 30;
29
30
  }
30
31
  this.refreshDuration = dur;
32
+ this.tokenLoader = options?.tokenLoader;
33
+ this.tokenWriter = options?.tokenWriter;
31
34
  }
32
- /** 从 properties 文件加载 Token */
33
- loadToken() {
35
+ /**
36
+ * 从 properties 文件(或自定义 tokenLoader)加载 Token。
37
+ * 若设置了 tokenLoader,优先调用;否则从 properties 文件读取。
38
+ */
39
+ async loadToken() {
40
+ if (this.tokenLoader) {
41
+ const token = await this.tokenLoader();
42
+ if (!token) {
43
+ throw new Error('自定义 tokenLoader 返回空值');
44
+ }
45
+ this.token = token;
46
+ return token;
47
+ }
48
+ const content = (0, fs_1.readFileSync)(this.filePath, 'utf-8');
49
+ const props = (0, config_parser_1.parsePropertiesString)(content);
50
+ const token = props['token'];
51
+ if (!token) {
52
+ throw new Error('Token 文件中未找到 token 字段');
53
+ }
54
+ this.token = token;
55
+ return token;
56
+ }
57
+ /**
58
+ * 同步版文件加载(仅用于无 tokenLoader 时的兼容入口)。
59
+ * 建议优先使用 loadToken()(异步)。
60
+ */
61
+ loadTokenSync() {
62
+ if (this.tokenLoader) {
63
+ throw new Error('tokenLoader 是异步函数,请使用 loadToken()');
64
+ }
34
65
  const content = (0, fs_1.readFileSync)(this.filePath, 'utf-8');
35
66
  const props = (0, config_parser_1.parsePropertiesString)(content);
36
67
  const token = props['token'];
@@ -44,10 +75,25 @@ class TokenManager {
44
75
  getToken() {
45
76
  return this.token;
46
77
  }
47
- /** 设置 Token 并更新文件 */
78
+ /**
79
+ * 设置 Token;若启用了文件持久化(显式传入 filePath),则同步写文件。
80
+ * 成功后触发 tokenWriter 回调(如有)。
81
+ */
48
82
  setToken(token) {
49
83
  this.token = token;
50
- this.saveTokenToFile(token);
84
+ if (this.fileEnabled) {
85
+ this.saveTokenToFile(token);
86
+ }
87
+ if (this.tokenWriter) {
88
+ this.tokenWriter(token);
89
+ }
90
+ }
91
+ /**
92
+ * 仅更新内存中的 token,不写文件,不触发 tokenWriter 回调。
93
+ * 用于多个组件共享 token 时的内部同步。
94
+ */
95
+ syncToken(token) {
96
+ this.token = token;
51
97
  }
52
98
  /** 将 Token 保存到 properties 文件 */
53
99
  saveTokenToFile(token) {
@@ -104,6 +150,10 @@ class TokenManager {
104
150
  // 刷新失败时静默跳过
105
151
  }
106
152
  }, this.refreshInterval);
153
+ // 防止 timer 阻止 Node.js 进程退出
154
+ if (this.timer.unref) {
155
+ this.timer.unref();
156
+ }
107
157
  }
108
158
  /** 停止后台刷新 */
109
159
  stopAutoRefresh() {
package/dist/cjs/index.js CHANGED
@@ -16,6 +16,55 @@
16
16
  * @packageDocumentation
17
17
  */
18
18
  Object.defineProperty(exports, "__esModule", { value: true });
19
- exports.VERSION = void 0;
19
+ exports.orderStatusCode = exports.BarPeriod = exports.License = exports.Language = exports.FinancialReportPeriod = exports.OptionAnalysisPeriod = exports.SortDirection = exports.IndustryLevel = exports.CorporateActionType = exports.OrderSortBy = exports.SegmentType = exports.QuoteRight = exports.Currency = exports.Market = exports.TimeInForce = exports.OrderType = exports.SecurityType = exports.OrderStatus = exports.normalizeOrderStatus = exports.stopLimitOrder = exports.stopOrder = exports.limitOrder = exports.marketOrder = exports.SubjectType = exports.ConnectionState = exports.PushClient = exports.TradeClient = exports.parseOptionIdentifier = exports.QuoteClient = exports.classifyErrorCode = exports.TigerError = exports.HttpClient = exports.TokenManager = exports.loadPropertiesFile = exports.createClientConfig = exports.VERSION = void 0;
20
20
  /** SDK 版本号 */
21
- exports.VERSION = '0.3.0';
21
+ exports.VERSION = '0.4.4';
22
+ // Config
23
+ var config_1 = require("./config");
24
+ Object.defineProperty(exports, "createClientConfig", { enumerable: true, get: function () { return config_1.createClientConfig; } });
25
+ Object.defineProperty(exports, "loadPropertiesFile", { enumerable: true, get: function () { return config_1.loadPropertiesFile; } });
26
+ var config_2 = require("./config");
27
+ Object.defineProperty(exports, "TokenManager", { enumerable: true, get: function () { return config_2.TokenManager; } });
28
+ // Transport
29
+ var client_1 = require("./client");
30
+ Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return client_1.HttpClient; } });
31
+ var client_2 = require("./client");
32
+ Object.defineProperty(exports, "TigerError", { enumerable: true, get: function () { return client_2.TigerError; } });
33
+ Object.defineProperty(exports, "classifyErrorCode", { enumerable: true, get: function () { return client_2.classifyErrorCode; } });
34
+ // Clients
35
+ var quote_1 = require("./quote");
36
+ Object.defineProperty(exports, "QuoteClient", { enumerable: true, get: function () { return quote_1.QuoteClient; } });
37
+ Object.defineProperty(exports, "parseOptionIdentifier", { enumerable: true, get: function () { return quote_1.parseOptionIdentifier; } });
38
+ var trade_1 = require("./trade");
39
+ Object.defineProperty(exports, "TradeClient", { enumerable: true, get: function () { return trade_1.TradeClient; } });
40
+ var push_1 = require("./push");
41
+ Object.defineProperty(exports, "PushClient", { enumerable: true, get: function () { return push_1.PushClient; } });
42
+ Object.defineProperty(exports, "ConnectionState", { enumerable: true, get: function () { return push_1.ConnectionState; } });
43
+ Object.defineProperty(exports, "SubjectType", { enumerable: true, get: function () { return push_1.SubjectType; } });
44
+ var order_helpers_1 = require("./model/order-helpers");
45
+ Object.defineProperty(exports, "marketOrder", { enumerable: true, get: function () { return order_helpers_1.marketOrder; } });
46
+ Object.defineProperty(exports, "limitOrder", { enumerable: true, get: function () { return order_helpers_1.limitOrder; } });
47
+ Object.defineProperty(exports, "stopOrder", { enumerable: true, get: function () { return order_helpers_1.stopOrder; } });
48
+ Object.defineProperty(exports, "stopLimitOrder", { enumerable: true, get: function () { return order_helpers_1.stopLimitOrder; } });
49
+ var order_status_1 = require("./model/order-status");
50
+ Object.defineProperty(exports, "normalizeOrderStatus", { enumerable: true, get: function () { return order_status_1.normalizeOrderStatus; } });
51
+ // Enums
52
+ var enums_1 = require("./model/enums");
53
+ Object.defineProperty(exports, "OrderStatus", { enumerable: true, get: function () { return enums_1.OrderStatus; } });
54
+ Object.defineProperty(exports, "SecurityType", { enumerable: true, get: function () { return enums_1.SecurityType; } });
55
+ Object.defineProperty(exports, "OrderType", { enumerable: true, get: function () { return enums_1.OrderType; } });
56
+ Object.defineProperty(exports, "TimeInForce", { enumerable: true, get: function () { return enums_1.TimeInForce; } });
57
+ Object.defineProperty(exports, "Market", { enumerable: true, get: function () { return enums_1.Market; } });
58
+ Object.defineProperty(exports, "Currency", { enumerable: true, get: function () { return enums_1.Currency; } });
59
+ Object.defineProperty(exports, "QuoteRight", { enumerable: true, get: function () { return enums_1.QuoteRight; } });
60
+ Object.defineProperty(exports, "SegmentType", { enumerable: true, get: function () { return enums_1.SegmentType; } });
61
+ Object.defineProperty(exports, "OrderSortBy", { enumerable: true, get: function () { return enums_1.OrderSortBy; } });
62
+ Object.defineProperty(exports, "CorporateActionType", { enumerable: true, get: function () { return enums_1.CorporateActionType; } });
63
+ Object.defineProperty(exports, "IndustryLevel", { enumerable: true, get: function () { return enums_1.IndustryLevel; } });
64
+ Object.defineProperty(exports, "SortDirection", { enumerable: true, get: function () { return enums_1.SortDirection; } });
65
+ Object.defineProperty(exports, "OptionAnalysisPeriod", { enumerable: true, get: function () { return enums_1.OptionAnalysisPeriod; } });
66
+ Object.defineProperty(exports, "FinancialReportPeriod", { enumerable: true, get: function () { return enums_1.FinancialReportPeriod; } });
67
+ Object.defineProperty(exports, "Language", { enumerable: true, get: function () { return enums_1.Language; } });
68
+ Object.defineProperty(exports, "License", { enumerable: true, get: function () { return enums_1.License; } });
69
+ Object.defineProperty(exports, "BarPeriod", { enumerable: true, get: function () { return enums_1.BarPeriod; } });
70
+ Object.defineProperty(exports, "orderStatusCode", { enumerable: true, get: function () { return enums_1.orderStatusCode; } });
@@ -4,7 +4,8 @@
4
4
  * 所有枚举值与 API JSON 保持一致
5
5
  */
6
6
  Object.defineProperty(exports, "__esModule", { value: true });
7
- exports.TimeInForce = exports.License = exports.QuoteRight = exports.Language = exports.BarPeriod = exports.OrderStatus = exports.OrderType = exports.Currency = exports.SecurityType = exports.Market = void 0;
7
+ exports.FinancialReportPeriod = exports.OptionAnalysisPeriod = exports.SortDirection = exports.IndustryLevel = exports.CorporateActionType = exports.SegmentType = exports.OrderSortBy = exports.TimeInForce = exports.License = exports.QuoteRight = exports.Language = exports.BarPeriod = exports.OrderStatus = exports.OrderType = exports.Currency = exports.SecurityType = exports.Market = void 0;
8
+ exports.orderStatusCode = orderStatusCode;
8
9
  /** 市场枚举 */
9
10
  var Market;
10
11
  (function (Market) {
@@ -51,19 +52,49 @@ var OrderType;
51
52
  OrderType["VWAP"] = "VWAP";
52
53
  OrderType["OCA"] = "OCA";
53
54
  })(OrderType || (exports.OrderType = OrderType = {}));
54
- /** 订单状态枚举 */
55
+ /**
56
+ * 订单状态枚举。对齐 Java SDK OrderStatus 定义。
57
+ *
58
+ * 服务端 wire 返回的值同时可能是:
59
+ * - 数字: -2 / -1 / 3 / 4 / 5 / 6 / 7 / 8
60
+ * - 字符串: "Invalid" / "Initial" / "PendingCancel" / "Cancelled" /
61
+ * "Submitted" / "Filled" / "Inactive" / "PendingSubmit"
62
+ *
63
+ * Client 层通过 normalizeOrderStatus() 做数字→字符串归一,不做跨别名合并。
64
+ */
55
65
  var OrderStatus;
56
66
  (function (OrderStatus) {
57
- OrderStatus["PendingNew"] = "PendingNew";
67
+ OrderStatus["Invalid"] = "Invalid";
58
68
  OrderStatus["Initial"] = "Initial";
69
+ OrderStatus["PendingCancel"] = "PendingCancel";
70
+ OrderStatus["Cancelled"] = "Cancelled";
59
71
  OrderStatus["Submitted"] = "Submitted";
60
- OrderStatus["PartiallyFilled"] = "PartiallyFilled";
61
72
  OrderStatus["Filled"] = "Filled";
62
- OrderStatus["Cancelled"] = "Cancelled";
63
- OrderStatus["PendingCancel"] = "PendingCancel";
64
73
  OrderStatus["Inactive"] = "Inactive";
65
- OrderStatus["Invalid"] = "Invalid";
74
+ OrderStatus["PendingSubmit"] = "PendingSubmit";
66
75
  })(OrderStatus || (exports.OrderStatus = OrderStatus = {}));
76
+ /** 返回订单状态对应的服务端数字码,未知返回 0。 */
77
+ function orderStatusCode(status) {
78
+ switch (status) {
79
+ case OrderStatus.Invalid:
80
+ return -2;
81
+ case OrderStatus.Initial:
82
+ return -1;
83
+ case OrderStatus.PendingCancel:
84
+ return 3;
85
+ case OrderStatus.Cancelled:
86
+ return 4;
87
+ case OrderStatus.Submitted:
88
+ return 5;
89
+ case OrderStatus.Filled:
90
+ return 6;
91
+ case OrderStatus.Inactive:
92
+ return 7;
93
+ case OrderStatus.PendingSubmit:
94
+ return 8;
95
+ }
96
+ return 0;
97
+ }
67
98
  /** K 线周期枚举 */
68
99
  var BarPeriod;
69
100
  (function (BarPeriod) {
@@ -108,3 +139,54 @@ var TimeInForce;
108
139
  TimeInForce["GTC"] = "GTC";
109
140
  TimeInForce["OPG"] = "OPG";
110
141
  })(TimeInForce || (exports.TimeInForce = TimeInForce = {}));
142
+ /** 订单排序字段 */
143
+ var OrderSortBy;
144
+ (function (OrderSortBy) {
145
+ OrderSortBy["LatestCreated"] = "LATEST_CREATED";
146
+ OrderSortBy["LatestStatusUpdated"] = "LATEST_STATUS_UPDATED";
147
+ })(OrderSortBy || (exports.OrderSortBy = OrderSortBy = {}));
148
+ /** 账户分部类型 */
149
+ var SegmentType;
150
+ (function (SegmentType) {
151
+ SegmentType["All"] = "ALL";
152
+ SegmentType["Sec"] = "SEC";
153
+ SegmentType["Fut"] = "FUT";
154
+ SegmentType["Fund"] = "FUND";
155
+ })(SegmentType || (exports.SegmentType = SegmentType = {}));
156
+ /** 公司行动类型 */
157
+ var CorporateActionType;
158
+ (function (CorporateActionType) {
159
+ CorporateActionType["Split"] = "split";
160
+ CorporateActionType["Dividend"] = "dividend";
161
+ CorporateActionType["Earning"] = "earning";
162
+ })(CorporateActionType || (exports.CorporateActionType = CorporateActionType = {}));
163
+ /** 行业级别 (1~4 级) */
164
+ var IndustryLevel;
165
+ (function (IndustryLevel) {
166
+ IndustryLevel["GSector"] = "GSECTOR";
167
+ IndustryLevel["GGroup"] = "GGROUP";
168
+ IndustryLevel["GInd"] = "GIND";
169
+ IndustryLevel["GSubInd"] = "GSUBIND";
170
+ })(IndustryLevel || (exports.IndustryLevel = IndustryLevel = {}));
171
+ /** 排序方向 */
172
+ var SortDirection;
173
+ (function (SortDirection) {
174
+ SortDirection["No"] = "SortDir_No";
175
+ SortDirection["Ascend"] = "SortDir_Ascend";
176
+ SortDirection["Descend"] = "SortDir_Descend";
177
+ })(SortDirection || (exports.SortDirection = SortDirection = {}));
178
+ /** 期权分析周期 */
179
+ var OptionAnalysisPeriod;
180
+ (function (OptionAnalysisPeriod) {
181
+ OptionAnalysisPeriod["ThreeYear"] = "3year";
182
+ OptionAnalysisPeriod["FiftyTwoWeek"] = "52week";
183
+ OptionAnalysisPeriod["TwentySixWeek"] = "26week";
184
+ OptionAnalysisPeriod["ThirteenWeek"] = "13week";
185
+ })(OptionAnalysisPeriod || (exports.OptionAnalysisPeriod = OptionAnalysisPeriod = {}));
186
+ /** 财报类型 */
187
+ var FinancialReportPeriod;
188
+ (function (FinancialReportPeriod) {
189
+ FinancialReportPeriod["Annual"] = "Annual";
190
+ FinancialReportPeriod["Quarterly"] = "Quarterly";
191
+ FinancialReportPeriod["LTM"] = "LTM";
192
+ })(FinancialReportPeriod || (exports.FinancialReportPeriod = FinancialReportPeriod = {}));