스킬 정리 및 리팩토링

lib/kis/domestic.ts

@@ -10,6 +10,27 @@ import {
   resolveDomesticKisSession,
   shouldUseOvertimeOrderBookApi,
 } from "@/lib/kis/domestic-market-session";
+import {
+  firstDefinedNumber,
+  firstDefinedString,
+  firstPositive,
+  mergeCandlesByTimestamp,
+  minutesForTimeframe,
+  normalizeSignedValue,
+  nowHmsInKst,
+  nowYmdInKst,
+  parseDayCandleRow,
+  parseMinuteCandleRow,
+  parseOutput2Rows,
+  readRowString,
+  resolveCurrentPriceSource,
+  resolveMarket,
+  shiftYmd,
+  subOneMinute,
+  toCandles,
+  toNumber,
+  toOptionalNumber,
+} from "@/lib/kis/domestic-helpers";
 
 /**
  * @file lib/kis/domestic.ts
@@ -59,18 +80,6 @@ interface KisDomesticDailyPriceOutput {
   stck_clpr?: string;
   acml_vol?: string;
 }
-interface KisDomesticItemChartRow {
-  stck_bsop_date?: string;
-  stck_cntg_hour?: string;
-  stck_oprc?: string;
-  stck_hgpr?: string;
-  stck_lwpr?: string;
-  stck_clpr?: string;
-  stck_prpr?: string;
-  cntg_vol?: string;
-  acml_vol?: string;
-}
-
 export interface KisDomesticOrderBookOutput {
   stck_prpr?: string;
   total_askp_rsqn?: string;
@@ -394,87 +403,6 @@ export async function getDomesticOverview(
   };
 }
 
-function toNumber(value?: string) {
-  if (!value) return 0;
-  const normalized = value.replace(/,/g, "").trim();
-  if (!normalized) return 0;
-  const parsed = Number(normalized);
-  return Number.isFinite(parsed) ? parsed : 0;
-}
-
-function toOptionalNumber(value?: string) {
-  if (!value) return undefined;
-  const normalized = value.replace(/,/g, "").trim();
-  if (!normalized) return undefined;
-  const parsed = Number(normalized);
-  return Number.isFinite(parsed) ? parsed : undefined;
-}
-
-function normalizeSignedValue(value: number, signCode?: string) {
-  const abs = Math.abs(value);
-
-  if (signCode === "4" || signCode === "5") return -abs;
-  if (signCode === "1" || signCode === "2") return abs;
-  return value;
-}
-
-function resolveMarket(...values: Array<string | undefined>) {
-  const merged = values.filter(Boolean).join(" ");
-  if (merged.includes("코스닥") || merged.toUpperCase().includes("KOSDAQ"))
-    return "KOSDAQ" as const;
-  return "KOSPI" as const;
-}
-
-function toCandles(
-  rows: KisDomesticDailyPriceOutput[],
-  currentPrice: number,
-): StockCandlePoint[] {
-  const parsed = rows
-    .map((row) => ({
-      date: row.stck_bsop_date ?? "",
-      open: toNumber(row.stck_oprc),
-      high: toNumber(row.stck_hgpr),
-      low: toNumber(row.stck_lwpr),
-      close: toNumber(row.stck_clpr),
-      volume: toNumber(row.acml_vol),
-    }))
-    .filter((item) => item.date.length === 8 && item.close > 0)
-    .sort((a, b) => a.date.localeCompare(b.date))
-    .slice(-80)
-    .map((item) => ({
-      time: formatDate(item.date),
-      price: item.close,
-      open: item.open > 0 ? item.open : item.close,
-      high: item.high > 0 ? item.high : item.close,
-      low: item.low > 0 ? item.low : item.close,
-      close: item.close,
-      volume: item.volume,
-    }));
-
-  if (parsed.length > 0) return parsed;
-
-  const now = new Date();
-  const mm = `${now.getMonth() + 1}`.padStart(2, "0");
-  const dd = `${now.getDate()}`.padStart(2, "0");
-  const safePrice = Math.max(currentPrice, 0);
-  return [
-    {
-      time: `${mm}/${dd}`,
-      timestamp: Math.floor(now.getTime() / 1000),
-      price: safePrice,
-      open: safePrice,
-      high: safePrice,
-      low: safePrice,
-      close: safePrice,
-      volume: 0,
-    },
-  ];
-}
-
-function formatDate(date: string) {
-  return `${date.slice(4, 6)}/${date.slice(6, 8)}`;
-}
-
 function getDomesticMarketPhaseInKst(
   now = new Date(),
   sessionOverride?: string | null,
@@ -484,231 +412,16 @@ function getDomesticMarketPhaseInKst(
   );
 }
 
-function firstDefinedNumber(...values: Array<number | undefined>) {
-  return values.find((value) => value !== undefined);
-}
-
-function firstDefinedString(...values: Array<string | undefined>) {
-  return values.find((value) => Boolean(value));
-}
-
-function resolveCurrentPriceSource(
-  marketPhase: DomesticMarketPhase,
-  overtime: KisDomesticOvertimePriceOutput,
-  ccnl: KisDomesticCcnlOutput,
-  quote: KisDomesticQuoteOutput,
-): DomesticPriceSource {
-  const hasOvertimePrice =
-    toOptionalNumber(overtime.ovtm_untp_prpr) !== undefined;
-  const hasCcnlPrice = toOptionalNumber(ccnl.stck_prpr) !== undefined;
-  const hasQuotePrice = toOptionalNumber(quote.stck_prpr) !== undefined;
-
-  if (marketPhase === "afterHours") {
-    if (hasOvertimePrice) return "inquire-overtime-price";
-    if (hasCcnlPrice) return "inquire-ccnl";
-    return "inquire-price";
-  }
-
-  if (hasCcnlPrice) return "inquire-ccnl";
-  if (hasQuotePrice) return "inquire-price";
-  return "inquire-price";
-}
-
 function resolvePriceMarketDivCode() {
   return "J";
 }
 
-function firstPositive(...values: number[]) {
-  return values.find((value) => value > 0) ?? 0;
-}
-
 export interface DomesticChartResult {
   candles: StockCandlePoint[];
   nextCursor: string | null;
   hasMore: boolean;
 }
 
-// ─── KIS output2 배열 추출 ─────────────────────────────────
-function parseOutput2Rows(envelope: {
-  output2?: unknown;
-  output1?: unknown;
-  output?: unknown;
-}) {
-  if (Array.isArray(envelope.output2))
-    return envelope.output2 as KisDomesticItemChartRow[];
-  if (Array.isArray(envelope.output))
-    return envelope.output as KisDomesticItemChartRow[];
-  for (const key of ["output2", "output", "output1"] as const) {
-    const v = envelope[key];
-    if (v && typeof v === "object" && !Array.isArray(v))
-      return [v as KisDomesticItemChartRow];
-  }
-  return [];
-}
-
-// ─── Row → StockCandlePoint 변환 ───────────────────────────
-function readRowString(row: KisDomesticItemChartRow, ...keys: string[]) {
-  const record = row as Record<string, unknown>;
-  for (const key of keys) {
-    const v = record[key];
-    if (typeof v === "string" && v.trim()) return v.trim();
-  }
-  return "";
-}
-
-function readOhlcv(row: KisDomesticItemChartRow) {
-  const close = toNumber(
-    readRowString(row, "stck_clpr", "STCK_CLPR") ||
-      readRowString(row, "stck_prpr", "STCK_PRPR"),
-  );
-  if (close <= 0) return null;
-
-  const open = toNumber(readRowString(row, "stck_oprc", "STCK_OPRC")) || close;
-  const high =
-    toNumber(readRowString(row, "stck_hgpr", "STCK_HGPR")) ||
-    Math.max(open, close);
-  const low =
-    toNumber(readRowString(row, "stck_lwpr", "STCK_LWPR")) ||
-    Math.min(open, close);
-  const volume = toNumber(
-    readRowString(row, "acml_vol", "ACML_VOL") ||
-      readRowString(row, "cntg_vol", "CNTG_VOL"),
-  );
-  return { open, high, low, close, volume };
-}
-
-function parseDayCandleRow(
-  row: KisDomesticItemChartRow,
-): StockCandlePoint | null {
-  const date = readRowString(row, "stck_bsop_date", "STCK_BSOP_DATE");
-  if (!/^\d{8}$/.test(date)) return null;
-  const ohlcv = readOhlcv(row);
-  if (!ohlcv) return null;
-
-  return {
-    time: formatDate(date),
-    timestamp: toKstTimestamp(date, "090000"),
-    price: ohlcv.close,
-    ...ohlcv,
-  };
-}
-
-function parseMinuteCandleRow(
-  row: KisDomesticItemChartRow,
-  minuteBucket: number,
-): StockCandlePoint | null {
-  let date = readRowString(row, "stck_bsop_date", "STCK_BSOP_DATE");
-  const rawTime = readRowString(row, "stck_cntg_hour", "STCK_CNTG_HOUR");
-  const time = /^\d{6}$/.test(rawTime)
-    ? rawTime
-    : /^\d{4}$/.test(rawTime)
-      ? `${rawTime}00`
-      : "";
-
-  if (!/^\d{8}$/.test(date)) date = nowYmdInKst(); // 당일 분봉은 날짜가 빠져있을 수 있음
-  if (!/^\d{8}$/.test(date) || !/^\d{6}$/.test(time)) return null;
-
-  const ohlcv = readOhlcv(row);
-  if (!ohlcv) return null;
-
-  const bucketed = alignTimeToMinuteBucket(time, minuteBucket);
-  return {
-    time: `${bucketed.slice(0, 2)}:${bucketed.slice(2, 4)}`,
-    timestamp: toKstTimestamp(date, bucketed),
-    price: ohlcv.close,
-    ...ohlcv,
-  };
-}
-
-// ─── 같은 타임스탬프 봉 병합 ───────────────────────────────
-function mergeCandlesByTimestamp(rows: StockCandlePoint[]) {
-  const map = new Map<number, StockCandlePoint>();
-  for (const row of rows) {
-    if (!row.timestamp) continue;
-    const prev = map.get(row.timestamp);
-    if (!prev) {
-      map.set(row.timestamp, row);
-      continue;
-    }
-    map.set(row.timestamp, {
-      ...prev,
-      price: row.close ?? row.price,
-      close: row.close ?? row.price,
-      high: Math.max(prev.high ?? prev.price, row.high ?? row.price),
-      low: Math.min(prev.low ?? prev.price, row.low ?? row.price),
-      volume: (prev.volume ?? 0) + (row.volume ?? 0),
-    });
-  }
-  return Array.from(map.values()).sort(
-    (a, b) => (a.timestamp ?? 0) - (b.timestamp ?? 0),
-  );
-}
-
-// ─── 시간 유틸 ─────────────────────────────────────────────
-function alignTimeToMinuteBucket(hhmmss: string, bucket: number) {
-  if (/^\d{4}$/.test(hhmmss)) hhmmss = `${hhmmss}00`;
-  if (bucket <= 1) return hhmmss;
-  const hh = Number(hhmmss.slice(0, 2));
-  const mm = Number(hhmmss.slice(2, 4));
-  const aligned = Math.floor(mm / bucket) * bucket;
-  return `${hh.toString().padStart(2, "0")}${aligned.toString().padStart(2, "0")}00`;
-}
-
-function toKstTimestamp(yyyymmdd: string, hhmmss: string) {
-  const y = Number(yyyymmdd.slice(0, 4));
-  const mo = Number(yyyymmdd.slice(4, 6));
-  const d = Number(yyyymmdd.slice(6, 8));
-  const hh = Number(hhmmss.slice(0, 2));
-  const mm = Number(hhmmss.slice(2, 4));
-  const ss = Number(hhmmss.slice(4, 6));
-  return Math.floor(Date.UTC(y, mo - 1, d, hh - 9, mm, ss) / 1000);
-}
-
-function toYmd(date: Date) {
-  return `${date.getUTCFullYear()}${`${date.getUTCMonth() + 1}`.padStart(2, "0")}${`${date.getUTCDate()}`.padStart(2, "0")}`;
-}
-
-function shiftYmd(ymd: string, days: number) {
-  const utc = new Date(
-    Date.UTC(
-      Number(ymd.slice(0, 4)),
-      Number(ymd.slice(4, 6)) - 1,
-      Number(ymd.slice(6, 8)),
-    ),
-  );
-  utc.setUTCDate(utc.getUTCDate() + days);
-  return toYmd(utc);
-}
-
-function nowYmdInKst() {
-  const parts = new Intl.DateTimeFormat("en-CA", {
-    timeZone: "Asia/Seoul",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-  }).formatToParts(new Date());
-  const m = new Map(parts.map((p) => [p.type, p.value]));
-  return `${m.get("year")}${m.get("month")}${m.get("day")}`;
-}
-
-function nowHmsInKst() {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: "Asia/Seoul",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-    hour12: false,
-  }).formatToParts(new Date());
-  const m = new Map(parts.map((p) => [p.type, p.value]));
-  return `${m.get("hour")}${m.get("minute")}${m.get("second")}`;
-}
-
-function minutesForTimeframe(tf: DashboardChartTimeframe) {
-  if (tf === "30m") return 30;
-  if (tf === "1h") return 60;
-  return 1;
-}
-
 /**
  * 국내주식 주식일별분봉조회 (과거 분봉)
  * @param symbol 종목코드
@@ -794,7 +507,7 @@ export async function getDomesticChart(
 
   // ── 분봉 (1m / 30m / 1h) ──
   const minuteBucket = minutesForTimeframe(timeframe);
-  let rawRows: KisDomesticItemChartRow[] = [];
+  let rawRows: Array<Record<string, unknown>> = [];
   let nextCursor: string | null = null;
 
   // Case A: 과거 데이터 조회 (커서 존재)
@@ -896,14 +609,3 @@ export async function getDomesticChart(
 
   return { candles, hasMore: Boolean(nextCursor), nextCursor };
 }
-
-function subOneMinute(hhmmss: string) {
-  const hh = Number(hhmmss.slice(0, 2));
-  const mm = Number(hhmmss.slice(2, 4));
-  let totalMin = hh * 60 + mm - 1;
-  if (totalMin < 0) totalMin = 0;
-  
-  const h = Math.floor(totalMin / 60);
-  const m = totalMin % 60;
-  return `${String(h).padStart(2, '0')}${String(m).padStart(2, '0')}00`;
-}