@2oolkit/kiwoom-cli 0.1.0 → 0.1.1

package/README.md

@@ -106,7 +106,25 @@ kiwoom-cli chart week  <코드>                             주봉 (ka10082)
 kiwoom-cli chart month <코드>                             월봉 (ka10083)
 kiwoom-cli chart year  <코드>                             년봉 (ka10094)
 ```
-모두 `-n, --count <n>`(행 수, 기본 50), `--raw`(수정주가 미적용) 지원.
+모두 `-n, --count <n>`(봉 개수, 기본 50), `--raw`(수정주가 미적용), `-p, --paginate`(강제 다중 페이지) 지원.
+
+**1회 요청당 최대 봉 개수 (per-request cap)** — 그 이상은 `cont-yn`/`next-key` 헤더로 **자동 페이지네이션**:
+
+| 차트 | 1회 최대 | `--count` 한도 |
+|---|---|---|
+| tick / min | 900 | 100,000 (자동 분할) |
+| day | 600 | 100,000 (자동 분할) |
+| week | 300 | 100,000 (자동 분할) |
+| month | 240 | 100,000 (자동 분할) |
+| year | 30 | 100,000 (자동 분할) |
+
+`--count`가 1회 최대를 넘으면 자동으로 여러 페이지를 받아 합칩니다(시간순 정렬·중복 제거는 API 순서를 그대로 유지). `-p/--paginate`로 강제할 수도 있습니다. `--count`는 양의 정수여야 하며 100,000으로 클램프됩니다.
+
+```bash
+kiwoom-cli chart day 005930 -n 600              # 한 페이지(최대) — 일봉 600개
+kiwoom-cli chart day 005930 -n 2000 -o json     # 자동 페이지네이션 — 일봉 ~2000개
+kiwoom-cli chart min 005930 -i 1 -n 2000 -o json # 1분봉 ~2000개 (여러 페이지)
+```
 
 ### `account` — 계좌
 ```

package/dist/index.js

@@ -89,6 +89,15 @@ var ORDER_TYPES = {
   "81": "\uC7A5\uB9C8\uAC10\uD6C4\uC2DC\uAC04\uC678"
 };
 var MARKET_ORDER_TYPES = /* @__PURE__ */ new Set(["3", "13", "23"]);
+var CHART_PER_PAGE_CAP = {
+  tick: 900,
+  minute: 900,
+  day: 600,
+  week: 300,
+  month: 240,
+  year: 30
+};
+var CHART_MAX_COUNT = 1e5;
 
 // src/config/store.ts
 var DEFAULT_CONFIG = { env: "real" };
@@ -438,7 +447,7 @@ var KiwoomClient = class {
    */
   async callEndpoint(def, body = {}, opts = {}) {
     if (opts.paginate && def.listKey) {
-      const data = await this.requestAll(def.apiId, def.path, body, def.listKey);
+      const data = await this.requestAll(def.apiId, def.path, body, def.listKey, opts.maxPages);
       return { data, contYn: false, nextKey: "" };
     }
     return this.request(def.apiId, def.path, body, {
@@ -448,9 +457,11 @@ var KiwoomClient = class {
   }
   /**
    * Fetch all pages of a TR, concatenating the array under `listKey`.
-   * Caps at `maxPages` to avoid runaway loops.
+   * Caps at `maxPages` to avoid runaway loops (default 100 — high enough for
+   * large chart pulls; callers pass a tighter bound when they know how many
+   * pages a target row count needs).
    */
-  async requestAll(apiId, path2, body, listKey, maxPages = 20) {
+  async requestAll(apiId, path2, body, listKey, maxPages = 100) {
     let page = await this.request(apiId, path2, body);
     const acc = Array.isArray(page.data[listKey]) ? [...page.data[listKey]] : [];
     let pages = 1;
@@ -1254,81 +1265,102 @@ var CHART_ROW_FORMATTERS = {
   pred_pre: unpad,
   trde_tern_rt: unpad
 };
+var PER_PAGE_CAP = CHART_PER_PAGE_CAP;
+function parseCount(raw) {
+  const n = parseIntStrict(raw, "count");
+  if (n < 1) {
+    throw new ActionableError(`--count must be a positive integer (got ${n}).`);
+  }
+  return Math.min(n, CHART_MAX_COUNT);
+}
 function emitChart(data, ep, fmt, count) {
+  const all = Array.isArray(data[ep.listKey]) ? data[ep.listKey] : [];
+  const sliced = all.slice(0, count);
   if (fmt === "json") {
-    output(data, "json");
+    output({ ...data, [ep.listKey]: sliced }, "json");
     return;
   }
-  const all = Array.isArray(data[ep.listKey]) ? data[ep.listKey] : [];
-  if (all.length === 0) {
+  if (sliced.length === 0) {
     console.log("No data");
     return;
   }
   output(
-    all.slice(0, count).map((row) => formatFields(row, CHART_ROW_FORMATTERS)),
+    sliced.map((row) => formatFields(row, CHART_ROW_FORMATTERS)),
     "table"
   );
 }
 function registerChartCommands(program2) {
-  const chart = program2.command("chart").description("OHLC charts \u2014 tick / minute / daily / weekly / monthly / yearly");
-  async function runIntraday(ep, code, ticScope, options) {
+  const chart = program2.command("chart").description(
+    "OHLC charts \u2014 tick / minute / daily / weekly / monthly / yearly. Per-request caps: tick/min 900, day 600, week 300, month 240, year 30. --count beyond the cap auto-paginates via cont-yn/next-key."
+  );
+  function planFetch(type, count, paginate) {
+    const cap = PER_PAGE_CAP[type];
+    const active = paginate || count > cap;
+    const maxPages = active ? Math.max(1, Math.ceil(count / cap)) : 1;
+    return { paginate: active, maxPages };
+  }
+  async function runIntraday(ep, type, code, ticScope, options) {
     const client = createClient();
     const stk = normalizeStockCode(code);
-    const { data } = await client.callEndpoint(ep, {
-      stk_cd: stk,
-      tic_scope: ticScope,
-      upd_stkpc_tp: options.raw ? "0" : "1"
-    });
-    emitChart(data, ep, getOutputFormat(options), parseIntStrict(options.count, "count"));
+    const count = parseCount(options.count);
+    const plan = planFetch(type, count, !!options.paginate);
+    const { data } = await client.callEndpoint(
+      ep,
+      { stk_cd: stk, tic_scope: ticScope, upd_stkpc_tp: options.raw ? "0" : "1" },
+      { paginate: plan.paginate, maxPages: plan.maxPages }
+    );
+    emitChart(data, ep, getOutputFormat(options), count);
   }
-  async function runPeriod(ep, code, baseDt, options) {
+  async function runPeriod(ep, type, code, baseDt, options) {
     const client = createClient();
     const stk = normalizeStockCode(code);
-    const { data } = await client.callEndpoint(ep, {
-      stk_cd: stk,
-      base_dt: baseDt,
-      upd_stkpc_tp: options.raw ? "0" : "1"
-    });
-    emitChart(data, ep, getOutputFormat(options), parseIntStrict(options.count, "count"));
+    const count = parseCount(options.count);
+    const plan = planFetch(type, count, !!options.paginate);
+    const { data } = await client.callEndpoint(
+      ep,
+      { stk_cd: stk, base_dt: baseDt, upd_stkpc_tp: options.raw ? "0" : "1" },
+      { paginate: plan.paginate, maxPages: plan.maxPages }
+    );
+    emitChart(data, ep, getOutputFormat(options), count);
   }
-  chart.command("tick <code>").description("Tick chart (ka10079)").option("-s, --scope <n>", "Ticks per candle (1/3/5/10/30)", "1").option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+  chart.command("tick <code>").description(`Tick chart (ka10079) \u2014 up to ${PER_PAGE_CAP.tick} candles/request, auto-paginates beyond that`).option("-s, --scope <n>", "Ticks per candle (1/3/5/10/30)", "1").option("-n, --count <n>", "Number of candles (auto-paginates when > 900)", "50").option("-p, --paginate", "Force fetching multiple pages (cont-yn/next-key)").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
     try {
-      await runIntraday(ENDPOINTS.tickChart, code, options.scope, options);
+      await runIntraday(ENDPOINTS.tickChart, "tick", code, options.scope, options);
     } catch (err) {
       handleError(err);
     }
   });
-  chart.command("min <code>").alias("minute").description("Minute chart (ka10080)").option("-i, --interval <n>", "Minutes per candle (1/3/5/10/15/30/45/60)", "1").option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+  chart.command("min <code>").alias("minute").description(`Minute chart (ka10080) \u2014 up to ${PER_PAGE_CAP.minute} candles/request, auto-paginates beyond that`).option("-i, --interval <n>", "Minutes per candle (1/3/5/10/15/30/45/60)", "1").option("-n, --count <n>", "Number of candles (auto-paginates when > 900)", "50").option("-p, --paginate", "Force fetching multiple pages (cont-yn/next-key)").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
     try {
-      await runIntraday(ENDPOINTS.minuteChart, code, options.interval, options);
+      await runIntraday(ENDPOINTS.minuteChart, "minute", code, options.interval, options);
     } catch (err) {
       handleError(err);
     }
   });
-  chart.command("day <code>").alias("daily").description("Daily chart (ka10081)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+  chart.command("day <code>").alias("daily").description(`Daily chart (ka10081) \u2014 up to ${PER_PAGE_CAP.day} candles/request, auto-paginates beyond that`).option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles (auto-paginates when > 600)", "50").option("-p, --paginate", "Force fetching multiple pages (cont-yn/next-key)").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
     try {
-      await runPeriod(ENDPOINTS.dailyChart, code, options.date, options);
+      await runPeriod(ENDPOINTS.dailyChart, "day", code, options.date, options);
     } catch (err) {
       handleError(err);
     }
   });
-  chart.command("week <code>").description("Weekly chart (ka10082)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+  chart.command("week <code>").description(`Weekly chart (ka10082) \u2014 up to ${PER_PAGE_CAP.week} candles/request, auto-paginates beyond that`).option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles (auto-paginates when > 300)", "50").option("-p, --paginate", "Force fetching multiple pages (cont-yn/next-key)").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
     try {
-      await runPeriod(ENDPOINTS.weeklyChart, code, options.date, options);
+      await runPeriod(ENDPOINTS.weeklyChart, "week", code, options.date, options);
     } catch (err) {
       handleError(err);
     }
   });
-  chart.command("month <code>").description("Monthly chart (ka10083)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+  chart.command("month <code>").description(`Monthly chart (ka10083) \u2014 up to ${PER_PAGE_CAP.month} candles/request, auto-paginates beyond that`).option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles (auto-paginates when > 240)", "50").option("-p, --paginate", "Force fetching multiple pages (cont-yn/next-key)").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
     try {
-      await runPeriod(ENDPOINTS.monthlyChart, code, options.date, options);
+      await runPeriod(ENDPOINTS.monthlyChart, "month", code, options.date, options);
     } catch (err) {
       handleError(err);
     }
   });
-  chart.command("year <code>").description("Yearly chart (ka10094)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+  chart.command("year <code>").description(`Yearly chart (ka10094) \u2014 up to ${PER_PAGE_CAP.year} candles/request, auto-paginates beyond that`).option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles (auto-paginates when > 30)", "50").option("-p, --paginate", "Force fetching multiple pages (cont-yn/next-key)").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
     try {
-      await runPeriod(ENDPOINTS.yearlyChart, code, options.date, options);
+      await runPeriod(ENDPOINTS.yearlyChart, "year", code, options.date, options);
     } catch (err) {
       handleError(err);
     }