@mulsok/traders-client 0.1.0

package/dist/server/broker/kiwoom/client.js

@@ -0,0 +1,256 @@
+/**
+ * Kiwoom REST API client (apps/client)
+ *
+ * 책임:
+ *   1. OAuth2 토큰 발급 + 자동 갱신 (만료 5분 전 사전 발급 · 인메모리 캐시)
+ *   2. 모든 호출에 rate limit 적용 (token bucket)
+ *   3. 인증 헤더 자동 부착 (Authorization: Bearer <token> · api-id)
+ *   4. 응답 파싱 + KiwoomResult 표준화
+ *   5. 에러 분류 (auth · rate_limit · business · network · schema)
+ *   6. 401 토큰 만료 자동 감지 → 1회 재발급 + 재시도
+ *
+ * 비책임 (별도 모듈):
+ *   - 캐시: cache.ts · 호출자가 결정 (현재가 1s · 일봉 60s 등)
+ *   - 비즈니스 응답 매핑: endpoints/*.ts 가 raw → 도메인 객체 변환
+ */
+import { loadConfig } from "../../config.js";
+import { getRateLimiter } from "./rate-limiter.js";
+const HOSTS = {
+    live: "https://api.kiwoom.com",
+    demo: "https://mockapi.kiwoom.com",
+};
+const tokenCache = new Map();
+const TOKEN_REFRESH_BEFORE_MS = 5 * 60 * 1000; // 만료 5분 전 사전 갱신
+function tokenCacheKey(creds) {
+    return `${creds.isDemo ? "demo" : "live"}:${creds.appKey.slice(0, 12)}`;
+}
+/** ─────────── OAuth2 ─────────── */
+export async function getAccessToken(creds, forceRefresh = false) {
+    const key = tokenCacheKey(creds);
+    if (!forceRefresh) {
+        const cached = tokenCache.get(key);
+        if (cached && cached.expiresAt - Date.now() > TOKEN_REFRESH_BEFORE_MS) {
+            return {
+                ok: true,
+                data: { token: cached.token, expiresAt: new Date(cached.expiresAt).toISOString() },
+                meta: { cached: true },
+            };
+        }
+    }
+    const host = HOSTS[creds.isDemo ? "demo" : "live"];
+    // ⚠️ 중요: 토큰 발급에는 rate limiter 의 take() 를 적용하지 않음.
+    // 이유:
+    //   1. 토큰은 발급 후 12h 캐시되므로 호출 빈도 자체가 매우 낮음 (수십 분~시간 단위)
+    //   2. kiwoomCall() 진입 시 getAccessToken() 가 먼저 실행되고 그 다음 rawCall() 에서
+    //      한 번 더 take() 함 → 토큰 캐시 miss 시 같은 함수 호출이 2 토큰 소비
+    //   3. 모의투자 (capacity 4 · refill 1.5/s) 에서 첫 호출 시 spike 위험
+    //   4. 키움 측 토큰 endpoint 는 실제 시세/주문 endpoint 와 별도 quota 를 가질 가능성 높음
+    // 따라서 토큰 발급은 별도 채널 · API 호출 limiter 와 분리.
+    const start = Date.now();
+    let res;
+    try {
+        res = await fetch(`${host}/oauth2/token`, {
+            method: "POST",
+            headers: { "content-type": "application/json;charset=UTF-8" },
+            body: JSON.stringify({
+                grant_type: "client_credentials",
+                appkey: creds.appKey,
+                secretkey: creds.secretKey,
+            }),
+        });
+    }
+    catch (e) {
+        return errResult({ kind: "network", message: `토큰 발급 네트워크 실패: ${String(e)}` });
+    }
+    const text = await res.text();
+    let data = {};
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch {
+        return errResult({
+            kind: "schema",
+            message: `토큰 응답 파싱 실패: ${text.slice(0, 200)}`,
+            status: res.status,
+        });
+    }
+    if (!res.ok) {
+        return errResult({
+            kind: "auth",
+            message: `HTTP ${res.status}`,
+            status: res.status,
+            returnMsg: data.return_msg ?? text.slice(0, 200),
+        });
+    }
+    const rc = data.return_code;
+    if (rc !== undefined && rc !== 0) {
+        return errResult({
+            kind: "business",
+            message: `키움 거부 (return_code=${rc})`,
+            returnCode: rc,
+            returnMsg: data.return_msg,
+        });
+    }
+    const token = data.token ?? data.access_token;
+    if (!token) {
+        return errResult({
+            kind: "schema",
+            message: "응답에 token 필드 없음",
+            returnMsg: JSON.stringify(data).slice(0, 200),
+        });
+    }
+    // expires_dt 형식: "20260424153045" (yyyyMMddHHmmss) · 또는 expires_in (초)
+    let expiresAt = Date.now() + 12 * 60 * 60 * 1000; // 기본 12h
+    const expDt = data.expires_dt;
+    const expIn = data.expires_in;
+    if (expDt && /^\d{14}$/.test(expDt)) {
+        const y = +expDt.slice(0, 4);
+        const mo = +expDt.slice(4, 6) - 1;
+        const d = +expDt.slice(6, 8);
+        const h = +expDt.slice(8, 10);
+        const mi = +expDt.slice(10, 12);
+        const s = +expDt.slice(12, 14);
+        expiresAt = new Date(y, mo, d, h, mi, s).getTime();
+    }
+    else if (typeof expIn === "number" && expIn > 0) {
+        expiresAt = Date.now() + expIn * 1000;
+    }
+    tokenCache.set(key, { token, expiresAt });
+    return {
+        ok: true,
+        data: { token, expiresAt: new Date(expiresAt).toISOString() },
+        meta: { cached: false, latencyMs: Date.now() - start },
+    };
+}
+/**
+ * 키움 모든 endpoint 호출의 통일 게이트웨이
+ *
+ * 흐름:
+ *   1. 토큰 확보 (캐시 우선)
+ *   2. rate limiter take
+ *   3. fetch (Authorization + api-id 헤더)
+ *   4. 응답 파싱 + 에러 분류
+ *   5. 401 인증 만료 → 토큰 강제 재발급 + 1회 재시도
+ */
+export async function kiwoomCall(opts) {
+    const cfg = loadConfig();
+    if (cfg.broker.kind !== "kiwoom") {
+        return errResult({ kind: "auth", message: "broker.kind !== 'kiwoom'" });
+    }
+    if (!cfg.broker.appKey || !cfg.broker.appSecret) {
+        return errResult({ kind: "auth", message: "AppKey · SecretKey 미설정" });
+    }
+    const creds = {
+        appKey: cfg.broker.appKey,
+        secretKey: cfg.broker.appSecret,
+        isDemo: cfg.broker.isDemo,
+    };
+    // 1) 토큰
+    const tokenRes = await getAccessToken(creds);
+    if (!tokenRes.ok)
+        return tokenRes;
+    let token = tokenRes.data.token;
+    // 2) 한 번 시도 + 인증 만료 감지 시 1회 재발급/재시도.
+    //    키움은 캐시된 토큰이 서버측에서 무효화되어도 HTTP 401 이 아니라
+    //    HTTP 200 + return_code=3 + return_msg="...8005:Token이 유효하지 않습니다..."
+    //    형태로 응답하므로 두 경로 모두 재시도 트리거로 잡는다.
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const result = await rawCall(creds, token, opts);
+        if (result.ok)
+            return result;
+        if (isAuthExpired(result.error) && attempt === 0) {
+            const refreshed = await getAccessToken(creds, true);
+            if (!refreshed.ok)
+                return refreshed;
+            token = refreshed.data.token;
+            continue;
+        }
+        return result;
+    }
+    return errResult({ kind: "unknown", message: "재시도 후에도 실패" });
+}
+export function isAuthExpired(err) {
+    if (err.kind === "auth" && err.status === 401)
+        return true;
+    if (err.kind === "business" &&
+        err.returnCode === 3 &&
+        /8005|Token이 유효하지 않/.test(err.returnMsg ?? "")) {
+        return true;
+    }
+    return false;
+}
+async function rawCall(creds, token, opts) {
+    const limiter = getRateLimiter(creds.isDemo);
+    await limiter.take();
+    const host = HOSTS[creds.isDemo ? "demo" : "live"];
+    const url = `${host}${opts.path}`;
+    const headers = {
+        "content-type": "application/json;charset=UTF-8",
+        "authorization": `Bearer ${token}`,
+        "api-id": opts.trId,
+    };
+    if (opts.contYn)
+        headers["cont-yn"] = opts.contYn;
+    if (opts.nextKey)
+        headers["next-key"] = opts.nextKey;
+    const start = Date.now();
+    let res;
+    try {
+        res = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(opts.body ?? {}),
+        });
+    }
+    catch (e) {
+        return errResult({ kind: "network", message: `네트워크 실패: ${String(e)}` });
+    }
+    const text = await res.text();
+    let data = {};
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch {
+        return errResult({
+            kind: "schema",
+            message: `응답 파싱 실패: ${text.slice(0, 200)}`,
+            status: res.status,
+        });
+    }
+    if (res.status === 401) {
+        return errResult({ kind: "auth", message: "토큰 만료 또는 무효", status: 401 });
+    }
+    if (res.status === 429) {
+        return errResult({ kind: "rate_limit", message: "키움 429 · rate limit 초과", status: 429 });
+    }
+    if (!res.ok) {
+        return errResult({
+            kind: "unknown",
+            message: `HTTP ${res.status}`,
+            status: res.status,
+            returnMsg: data.return_msg ?? text.slice(0, 200),
+        });
+    }
+    const rc = data.return_code;
+    if (rc !== undefined && rc !== 0) {
+        return errResult({
+            kind: "business",
+            message: `키움 거부 (return_code=${rc})`,
+            returnCode: rc,
+            returnMsg: data.return_msg,
+        });
+    }
+    return {
+        ok: true,
+        data: data,
+        meta: { latencyMs: Date.now() - start, rateRemaining: limiter.remaining() },
+    };
+}
+function errResult(error) {
+    return { ok: false, error };
+}
+/** UX 표시용 짧은 요약 */
+export function kiwoomHostLabel(isDemo) {
+    return isDemo ? "모의투자 (mockapi.kiwoom.com)" : "실전투자 (api.kiwoom.com)";
+}
+//# sourceMappingURL=client.js.map

package/dist/server/broker/kiwoom/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src-server/broker/kiwoom/client.ts"],"names":[],"mappings":"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"}

package/dist/server/broker/kiwoom/endpoints/_helpers.js

@@ -0,0 +1,61 @@
+/**
+ * 키움 응답 매핑 공용 헬퍼
+ *
+ * 배경
+ *   - 키움 응답 필드명은 endpoint (TR ID) 별로 상이
+ *   - 같은 의미인데도 cur_prc / stck_prpr / now_price 등 다른 키 사용
+ *   - 단일 도메인 객체로 매핑 시 다중 키 시도 (광의 매핑) 필요
+ *
+ * 정책
+ *   - mapping 실패 시 0/"" 반환 (raw 보존으로 디버깅 가능)
+ *   - 호출자가 raw 검증 책임
+ */
+/** 다중 키 후보 중 첫 번째 숫자 값 반환 · 없으면 0 */
+export function pickNum(obj, keys) {
+    if (!obj || typeof obj !== "object")
+        return 0;
+    const o = obj;
+    for (const k of keys) {
+        const v = o[k];
+        if (v === undefined || v === null)
+            continue;
+        const n = typeof v === "number" ? v : Number(String(v).replace(/,/g, ""));
+        if (Number.isFinite(n))
+            return n;
+    }
+    return 0;
+}
+/** 다중 키 후보 중 첫 번째 비어있지 않은 문자열 · 없으면 "" */
+export function pickStr(obj, keys) {
+    if (!obj || typeof obj !== "object")
+        return "";
+    const o = obj;
+    for (const k of keys) {
+        const v = o[k];
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    return "";
+}
+/**
+ * 응답 객체에서 첫 번째 (비어있지 않은) array 필드 반환
+ *
+ * 키움 응답은 보통 output1 / output2 / 종목별 list 같은 키에 배열 들어감 ·
+ * 키 이름 다양 → 첫 array 자동 검색.
+ */
+export function findFirstArray(obj) {
+    for (const v of Object.values(obj)) {
+        if (Array.isArray(v) && v.length > 0 && typeof v[0] === "object") {
+            return v;
+        }
+    }
+    return null;
+}
+/** Date → yyyyMMdd 키움 일자 포맷 */
+export function ymd(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const dd = String(d.getDate()).padStart(2, "0");
+    return `${y}${m}${dd}`;
+}
+//# sourceMappingURL=_helpers.js.map

package/dist/server/broker/kiwoom/endpoints/_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../../../../src-server/broker/kiwoom/endpoints/_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qCAAqC;AACrC,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,IAAc;IAClD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,IAAc;IAClD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAA4B;IACzD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,CAA8B,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,GAAG,CAAC,CAAO;IACzB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC;AACzB,CAAC"}