gangtise-openapi-cli 0.17.0 → 0.17.2

package/dist/src/cli.js

@@ -261,10 +261,19 @@ insight.addCommand(foreignOpinion);
 insight.addCommand(independentOpinion);
 program.addCommand(insight);
 const quote = new Command("quote").description("Quote APIs");
-quote.command("day-kline").option("--security <code>", "Security code (A-share: .SH/.SZ/.BJ, or 'all' for full market)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => callKlineWithSharding(client, "quote.day-kline", buildQuoteKlineBody(options), { shardDays: 1 })));
-quote.command("day-kline-hk").option("--security <code>", "Security code (HK stock: .HK, or 'all' for full market)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => callKlineWithSharding(client, "quote.day-kline-hk", buildQuoteKlineBody(options), { shardDays: 2 })));
-quote.command("day-kline-us").option("--security <code>", "Security code (US stock: e.g. AAPL.O, or 'all' for full market)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => callKlineWithSharding(client, "quote.day-kline-us", buildQuoteKlineBody(options), { shardDays: 1 })));
-quote.command("index-day-kline").option("--security <code>", "Index code (.SH/.SZ/.BJ, or 'all' for full market)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => callKlineWithSharding(client, "quote.index-day-kline", buildQuoteKlineBody(options), { shardDays: 30 })));
+const addKlineCommand = (name, endpointKey, securityHelp, shardDays) => quote.command(name)
+    .option("--security <code>", securityHelp, collectList, [])
+    .option("--start-date <date>", "Start date (default: 1 year before end-date)")
+    .option("--end-date <date>", "End date (default: latest)")
+    .option("--limit <number>", "Max rows per request (default: 6000, max: 10000)")
+    .option("--field <field>", "Field", collectList, [])
+    .option("--format <format>", "Output format", "table")
+    .option("--output <path>")
+    .action((options) => emit(options, (client) => callKlineWithSharding(client, endpointKey, buildQuoteKlineBody(options), { shardDays })));
+addKlineCommand("day-kline", "quote.day-kline", "Security code (A-share: .SH/.SZ/.BJ, or 'all' for full market)", 1);
+addKlineCommand("day-kline-hk", "quote.day-kline-hk", "Security code (HK stock: .HK, or 'all' for full market)", 2);
+addKlineCommand("day-kline-us", "quote.day-kline-us", "Security code (US stock: e.g. AAPL.O, or 'all' for full market)", 1);
+addKlineCommand("index-day-kline", "quote.index-day-kline", "Index code (.SH/.SZ/.BJ, or 'all' for full market)", 30);
 quote.command("minute-kline").option("--security <code>", "Security code (A-share only: .SH/.SZ/.BJ)").option("--start-time <datetime>", "Start time (yyyy-MM-dd HH:mm:ss)").option("--end-time <datetime>", "End time (yyyy-MM-dd HH:mm:ss)").option("--limit <number>", "Max rows per request (default: 5000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("quote.minute-kline", { securityCode: options.security, startTime: options.startTime, endTime: options.endTime, limit: parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1 }), fieldList: maybeArray(options.field) })));
 quote.command("realtime").description("Realtime quote snapshot (A-share / HK / US)").option("--security <code>", "Security code (e.g. 600519.SH / 00700.HK / AAPL.O), or market keyword: aShares / hkStocks / usStocks", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("quote.realtime", { securityList: maybeArray(options.security), fieldList: maybeArray(options.field) })));
 program.addCommand(quote);

package/dist/src/core/client.js

@@ -9,7 +9,10 @@ import { ENDPOINTS } from "./endpoints.js";
 import { getLookupData } from "./lookupData/index.js";
 import { getDispatcher, isVerbose, logTiming, markRetryable, runWithConcurrency, withRetry } from "./transport.js";
 const PAGINATION_CONCURRENCY = Number(process.env.GANGTISE_PAGE_CONCURRENCY ?? 5) || 5;
-const AUTH_RETRY_CODES = new Set(["8000014", "8000015"]);
+// Auth errors that warrant a forced re-login + one replay. 8000014/8000015 are
+// AK/SK errors; 0000001008 is a server-side token invalidation (the token still
+// looks valid by local expiry, so only a forced refresh recovers it).
+const AUTH_RETRY_CODES = new Set(["8000014", "8000015", "0000001008"]);
 export class GangtiseClient {
     config;
     refreshPromise = null;
@@ -165,8 +168,10 @@ export class GangtiseClient {
             nextFrom += size;
         }
         const MAX_PAGES = 1000;
+        let truncatedByPageCap = false;
         if (pageRequests.length + 1 > MAX_PAGES) {
             pageRequests.length = MAX_PAGES - 1;
+            truncatedByPageCap = true;
         }
         let unexpectedShape = false;
         let totalDrift = false;
@@ -195,6 +200,12 @@ export class GangtiseClient {
         if (totalDrift && isVerbose()) {
             process.stderr.write(`[gangtise] warning: 'total' changed across pages (data shifted during fetch)\n`);
         }
+        // Always surface a cap-induced truncation (not gated on verbose): the user
+        // asked for everything and is silently getting a subset, mirroring the
+        // partial-result warning in quoteSharding.
+        if (truncatedByPageCap) {
+            process.stderr.write(`[gangtise] warning: hit the ${MAX_PAGES}-page safety cap; fetched ${collected.length} of ${total} rows. Narrow the query (e.g. a shorter date range) or pass --size to fetch a bounded subset.\n`);
+        }
         return {
             ...firstPage,
             total,
@@ -330,7 +341,16 @@ export class GangtiseClient {
             // Stream directly to disk when caller already knows the destination
             if (options?.streamTo) {
                 await fs.mkdir(path.dirname(options.streamTo), { recursive: true });
-                await pipeline(response.body, createWriteStream(options.streamTo));
+                try {
+                    await pipeline(response.body, createWriteStream(options.streamTo));
+                }
+                catch (error) {
+                    // A mid-stream failure leaves a truncated file on disk; remove it so a
+                    // failed download never looks like a complete one. withRetry may still
+                    // replay the request (the next attempt re-creates the file).
+                    await fs.unlink(options.streamTo).catch(() => { });
+                    throw error;
+                }
                 logTiming(`GET ${endpoint.path} (stream)`, Date.now() - startedAt, `${response.statusCode}`);
                 return { contentType, filename, savedPath: options.streamTo };
             }

package/dist/src/core/errors.js

@@ -16,6 +16,7 @@ const ERROR_HINTS = {
     "999995": "当前账号积分不足。",
     "900002": "请求缺少 uid。",
     "900001": "请求参数为空或缺少必填项。",
+    "0000001008": "Token 已失效（多为他处登录挤掉本会话）；有 AK/SK 时 CLI 会自动重新登录重试一次，否则请重新登录。",
     "8000014": "GANGTISE_ACCESS_KEY 错误。",
     "8000015": "GANGTISE_SECRET_KEY 错误。",
     "8000016": "开发账号状态异常。",

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated — DO NOT EDIT
-export const CLI_VERSION = "0.17.0";
+export const CLI_VERSION = "0.17.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.17.0",
+  "version": "0.17.2",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {