@mulsok/traders-client 0.1.0

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

@@ -0,0 +1,370 @@
+/**
+ * 키움 WebSocket 클라이언트 (apps/client)
+ *
+ * 책임:
+ *   1. WS 연결 수립 (wss://api.kiwoom.com:10000/api/dostk/websocket)
+ *   2. Authorization 헤더 경유 인증 (OAuth2 토큰 재사용)
+ *   3. 재접속 + exponential backoff (1s → 30s)
+ *   4. ping keepalive (30s 주기)
+ *   5. 요청/응답 매칭 (trnm + seq)
+ *   6. 실시간 스트림 pub/sub (realtime-bus.ts 로 위임)
+ *   7. 라이프사이클 이벤트 (listeners)
+ *
+ * 단일 인스턴스 (프로세스 1개의 connection 공유).
+ * 조건검색 · 실시간 시세 등 모든 WS 기반 기능이 이 클라이언트 사용.
+ */
+import WebSocket from "ws";
+import { loadConfig } from "../../../config.js";
+import { getAccessToken } from "../client.js";
+const WS_HOSTS = {
+    live: "wss://api.kiwoom.com:10000",
+    demo: "wss://mockapi.kiwoom.com:10000",
+};
+const WS_PATH = "/api/dostk/websocket";
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+const KEEPALIVE_INTERVAL_MS = 30_000;
+const RECONNECT_INITIAL_MS = 1_000;
+const RECONNECT_MAX_MS = 30_000;
+export class KiwoomWebSocketClient {
+    opts;
+    ws;
+    status = "disconnected";
+    listeners = new Set();
+    pending = new Map(); // key: `${trnm}:${seq ?? ""}`
+    subscriptions = new Map();
+    keepaliveTimer;
+    reconnectTimer;
+    reconnectAttempt = 0;
+    explicitlyClosed = false;
+    creds;
+    onReadyResolvers = [];
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    /* ─────────── 공개 API ─────────── */
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    getStatus() {
+        return this.status;
+    }
+    isReady() {
+        return this.status === "ready" && this.ws?.readyState === WebSocket.OPEN;
+    }
+    /**
+     * 연결 + 토큰 인증. 이미 ready 면 no-op.
+     *
+     * 주의: 호출자가 명시 connect 필요 (첫 request 시 lazy auto-connect 도 지원).
+     */
+    async connect() {
+        if (this.isReady())
+            return { ok: true, data: undefined };
+        if (this.status === "connecting" || this.status === "authenticating") {
+            // 이미 시도 중 · 대기
+            return new Promise((resolve) => {
+                this.onReadyResolvers.push((ok) => resolve(ok ? { ok: true, data: undefined } : { ok: false, error: { kind: "network", message: "WS 연결 대기 중 실패" } }));
+            });
+        }
+        this.explicitlyClosed = false;
+        // creds 준비
+        if (!this.creds) {
+            const c = this.opts.credentials ?? loadCredsFromConfig();
+            if (!c) {
+                return { ok: false, error: { kind: "auth", message: "WS creds 확보 실패 · AppKey/SecretKey 미설정" } };
+            }
+            this.creds = c;
+        }
+        // 토큰 발급
+        this.setStatus("connecting");
+        const tokenRes = await getAccessToken(this.creds);
+        if (!tokenRes.ok) {
+            this.setStatus("disconnected");
+            this.flushReady(false);
+            return { ok: false, error: tokenRes.error };
+        }
+        const accessToken = tokenRes.data.token;
+        const url = `${WS_HOSTS[this.creds.isDemo ? "demo" : "live"]}${WS_PATH}`;
+        try {
+            this.ws = new WebSocket(url, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                },
+            });
+        }
+        catch (e) {
+            this.setStatus("disconnected");
+            this.flushReady(false);
+            return { ok: false, error: { kind: "network", message: `WS 연결 생성 실패: ${String(e)}` } };
+        }
+        return new Promise((resolve) => {
+            const settle = (result) => {
+                this.flushReady(result.ok);
+                resolve(result);
+            };
+            // LOGIN 전문 응답 대기용 매칭 (handleIncoming 에서 trnm="LOGIN" 만나면 resolve)
+            this.pending.set("LOGIN:", {
+                trnm: "LOGIN",
+                resolve: (msg) => {
+                    if (msg.return_code !== undefined && msg.return_code !== 0) {
+                        this.setStatus("disconnected");
+                        try {
+                            this.ws?.close(1008, "LOGIN rejected");
+                        }
+                        catch {
+                            /* noop */
+                        }
+                        settle({
+                            ok: false,
+                            error: {
+                                kind: "auth",
+                                message: `WS LOGIN 거부 (${msg.return_code})`,
+                                returnCode: msg.return_code,
+                                returnMsg: msg.return_msg,
+                            },
+                        });
+                        return;
+                    }
+                    this.setStatus("ready");
+                    this.reconnectAttempt = 0;
+                    this.startKeepalive();
+                    this.resubscribeAll();
+                    settle({ ok: true, data: undefined });
+                },
+                reject: (err) => settle({ ok: false, error: { kind: "network", message: err.message } }),
+                timeoutHandle: setTimeout(() => {
+                    this.pending.delete("LOGIN:");
+                    settle({ ok: false, error: { kind: "network", message: "WS LOGIN timeout" } });
+                }, 10_000),
+                createdAt: Date.now(),
+            });
+            this.ws.on("open", () => {
+                // 키움 WS 는 업그레이드 직후 LOGIN 전문을 요구함.
+                // (업그레이드 헤더의 Authorization: Bearer <token> 만으로는 "로그인 인증이 들어오기 전에
+                //  다른 전문이 들어왔습니다 (100013)" 에러 발생 · 공식 PDF 에는 명시 안 되어 있지만
+                //  실제 동작 기반 확인)
+                this.setStatus("authenticating");
+                try {
+                    this.ws.send(JSON.stringify({ trnm: "LOGIN", token: accessToken }));
+                }
+                catch (e) {
+                    this.pending.delete("LOGIN:");
+                    settle({ ok: false, error: { kind: "network", message: `LOGIN 전송 실패: ${String(e)}` } });
+                }
+            });
+            this.ws.on("message", (raw) => this.handleIncoming(raw));
+            this.ws.on("error", (err) => {
+                this.emitEvent({ type: "error", error: err });
+            });
+            this.ws.on("close", (code, reason) => {
+                const prev = this.status;
+                this.stopKeepalive();
+                this.ws = undefined;
+                this.rejectAllPending(new Error(`WS 연결 종료 (code=${code}, reason=${reason.toString()})`));
+                if (this.explicitlyClosed) {
+                    this.setStatus("disconnected");
+                    return;
+                }
+                // 자동 재접속
+                this.setStatus("reconnecting");
+                this.scheduleReconnect();
+                if (prev === "connecting" || prev === "authenticating") {
+                    settle({
+                        ok: false,
+                        error: { kind: "network", message: `WS 초기 연결 실패 (code=${code})` },
+                    });
+                }
+            });
+        });
+    }
+    async disconnect() {
+        this.explicitlyClosed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        this.stopKeepalive();
+        this.rejectAllPending(new Error("WS 명시적 종료"));
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.setStatus("closing");
+            this.ws.close(1000, "client disconnect");
+        }
+        this.setStatus("disconnected");
+    }
+    /**
+     * 요청/응답 매칭 방식 호출.
+     *
+     * @param body    { trnm, ...params } · 필수 trnm
+     * @param opts    matchKey: 응답 매칭용 (seq 등) · timeoutMs
+     */
+    async request(body, opts = {}) {
+        if (!this.isReady()) {
+            const connected = await this.connect();
+            if (!connected.ok)
+                return connected;
+        }
+        const key = `${body.trnm}:${opts.matchKey ?? ""}`;
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        return new Promise((resolve) => {
+            const timeoutHandle = setTimeout(() => {
+                this.pending.delete(key);
+                resolve({ ok: false, error: { kind: "network", message: `WS 요청 timeout ${timeoutMs}ms (trnm=${body.trnm})` } });
+            }, timeoutMs);
+            this.pending.set(key, {
+                trnm: body.trnm,
+                seq: opts.matchKey,
+                resolve: (msg) => resolve({ ok: true, data: msg }),
+                reject: (err) => resolve({ ok: false, error: { kind: "network", message: err.message } }),
+                timeoutHandle,
+                createdAt: Date.now(),
+            });
+            try {
+                this.ws.send(JSON.stringify(body));
+            }
+            catch (e) {
+                this.pending.delete(key);
+                clearTimeout(timeoutHandle);
+                resolve({ ok: false, error: { kind: "network", message: `WS send 실패: ${String(e)}` } });
+            }
+        });
+    }
+    /**
+     * 실시간 스트림 구독.
+     *
+     * @param id          고유 식별자 (해제용)
+     * @param trnm        스트림 메시지의 trnm (예: "REAL")
+     * @param handler     메시지 핸들러
+     * @param filter      추가 필터 (true 면 handler 호출)
+     */
+    subscribeStream(id, trnm, handler, filter) {
+        this.subscriptions.set(id, { id, trnm, handler, filter });
+        return () => {
+            this.subscriptions.delete(id);
+        };
+    }
+    /* ─────────── 내부 ─────────── */
+    handleIncoming(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw.toString());
+        }
+        catch (e) {
+            this.emitEvent({ type: "error", error: new Error(`WS 메시지 파싱 실패: ${String(e)}`) });
+            return;
+        }
+        this.emitEvent({ type: "message", message: msg });
+        // 요청/응답 매칭
+        if (msg.trnm) {
+            const seqField = (typeof msg.seq === "string" ? msg.seq : undefined) ??
+                (typeof msg.matchKey === "string"
+                    ? msg.matchKey
+                    : undefined);
+            const keyWithSeq = `${msg.trnm}:${seqField ?? ""}`;
+            const keyWithoutSeq = `${msg.trnm}:`;
+            const pending = this.pending.get(keyWithSeq) ?? this.pending.get(keyWithoutSeq);
+            if (pending) {
+                clearTimeout(pending.timeoutHandle);
+                this.pending.delete(keyWithSeq);
+                this.pending.delete(keyWithoutSeq);
+                pending.resolve(msg);
+                return;
+            }
+        }
+        // 실시간 스트림 디스패치
+        for (const sub of this.subscriptions.values()) {
+            if (sub.trnm === msg.trnm) {
+                if (!sub.filter || sub.filter(msg)) {
+                    try {
+                        sub.handler(msg);
+                    }
+                    catch (e) {
+                        this.emitEvent({ type: "error", error: e });
+                    }
+                }
+            }
+        }
+    }
+    startKeepalive() {
+        this.stopKeepalive();
+        this.keepaliveTimer = setInterval(() => {
+            if (this.ws?.readyState === WebSocket.OPEN) {
+                try {
+                    this.ws.ping();
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }, KEEPALIVE_INTERVAL_MS);
+    }
+    stopKeepalive() {
+        if (this.keepaliveTimer) {
+            clearInterval(this.keepaliveTimer);
+            this.keepaliveTimer = undefined;
+        }
+    }
+    scheduleReconnect() {
+        if (this.explicitlyClosed)
+            return;
+        const delay = Math.min(RECONNECT_INITIAL_MS * 2 ** this.reconnectAttempt, RECONNECT_MAX_MS);
+        this.reconnectAttempt++;
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = undefined;
+            await this.connect();
+        }, delay);
+    }
+    resubscribeAll() {
+        // 현재 subscriptions 는 메모리 보존 · 재연결 후 자동 적용.
+        // 단, 조건검색 ka10173 같은 "서버측 구독 상태" 는 호출자가 직접 재요청 필요.
+        // 그래서 이벤트로 알림.
+        this.emitEvent({ type: "status", status: "ready" });
+    }
+    rejectAllPending(err) {
+        for (const [k, p] of this.pending.entries()) {
+            clearTimeout(p.timeoutHandle);
+            p.reject(err);
+            this.pending.delete(k);
+        }
+    }
+    flushReady(ok) {
+        for (const r of this.onReadyResolvers)
+            r(ok);
+        this.onReadyResolvers = [];
+    }
+    setStatus(next) {
+        if (this.status === next)
+            return;
+        this.status = next;
+        this.emitEvent({ type: "status", status: next });
+    }
+    emitEvent(ev) {
+        for (const l of this.listeners) {
+            try {
+                l(ev);
+            }
+            catch {
+                // listener 오류는 무시 (다른 listener 에 영향 없도록)
+            }
+        }
+    }
+}
+function loadCredsFromConfig() {
+    const cfg = loadConfig();
+    if (cfg.broker.kind !== "kiwoom")
+        return null;
+    if (!cfg.broker.appKey || !cfg.broker.appSecret)
+        return null;
+    return {
+        appKey: cfg.broker.appKey,
+        secretKey: cfg.broker.appSecret,
+        isDemo: cfg.broker.isDemo,
+    };
+}
+/* ─────────── 싱글톤 ─────────── */
+let singleton;
+export function getKiwoomWs() {
+    if (!singleton)
+        singleton = new KiwoomWebSocketClient();
+    return singleton;
+}
+//# sourceMappingURL=client.js.map

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

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

package/dist/server/broker/kiwoom/ws/endpoints/condition.js

@@ -0,0 +1,146 @@
+import { getKiwoomWs } from "../client.js";
+import { subscribeConditionStream, } from "../realtime-bus.js";
+export async function listConditions() {
+    const ws = getKiwoomWs();
+    const res = await ws.request({ trnm: "CNSRLST" });
+    if (!res.ok)
+        return res;
+    const data = res.data;
+    if (data.return_code !== undefined && data.return_code !== 0) {
+        return {
+            ok: false,
+            error: {
+                kind: "business",
+                message: `조건검색 목록조회 실패 (${data.return_code})`,
+                returnCode: data.return_code,
+                returnMsg: data.return_msg,
+            },
+        };
+    }
+    const arr = data.data ?? [];
+    const items = arr.map(([seq, name]) => ({ seq, name }));
+    return { ok: true, data: items };
+}
+export async function requestCondition(opts) {
+    const ws = getKiwoomWs();
+    const res = await ws.request({
+        trnm: "CNSRREQ",
+        seq: opts.seq,
+        search_type: "0", // 0:조건검색 (1회)
+        stex_tp: opts.exchange ?? "K",
+        cont_yn: opts.contYn ?? "N",
+        next_key: opts.nextKey ?? "",
+    }, { matchKey: opts.seq, timeoutMs: 15_000 });
+    if (!res.ok)
+        return res;
+    const data = res.data;
+    if (data.return_code !== undefined && data.return_code !== 0) {
+        return {
+            ok: false,
+            error: {
+                kind: "business",
+                message: `조건검색 요청 실패 (${data.return_code})`,
+                returnCode: data.return_code,
+                returnMsg: data.return_msg,
+            },
+        };
+    }
+    const arr = data.data ?? [];
+    const items = arr.map((row) => ({
+        symbolCode: String(row["9001"] ?? "").replace(/^A/, ""), // "A005930" → "005930"
+        symbolName: String(row["302"] ?? ""),
+        currentPriceKrw: toNumFromSignedStr(row["10"]),
+        changeSign: String(row["25"] ?? ""),
+        changeKrw: toNumFromSignedStr(row["11"]),
+        changePct: toNumFromSignedStr(row["12"]),
+        volume: toNum(row["13"]),
+        openKrw: toNum(row["16"]),
+        highKrw: toNum(row["17"]),
+        lowKrw: toNum(row["18"]),
+        raw: row,
+    }));
+    return { ok: true, data: items };
+}
+export async function startConditionRealtime(seq, handler, opts = {}) {
+    const ws = getKiwoomWs();
+    // 1) 클라이언트 구독 먼저 (레이스 방지 · 서버 응답 직후 push 올 수 있음)
+    const unsubscribe = subscribeConditionStream(seq, handler);
+    // 2) 서버측 실시간 모드 요청
+    const res = await ws.request({
+        trnm: "CNSRREQ",
+        seq,
+        search_type: "1", // 1: 조건검색 + 실시간
+        stex_tp: opts.exchange ?? "K",
+    }, { matchKey: seq, timeoutMs: 15_000 });
+    if (!res.ok) {
+        unsubscribe();
+        return res;
+    }
+    const data = res.data;
+    if (data.return_code !== undefined && data.return_code !== 0) {
+        unsubscribe();
+        return {
+            ok: false,
+            error: {
+                kind: "business",
+                message: `조건검색 실시간 요청 실패 (${data.return_code})`,
+                returnCode: data.return_code,
+                returnMsg: data.return_msg,
+            },
+        };
+    }
+    const initialCodes = (data.data ?? [])
+        .map((row) => String(row.jmcode ?? "").replace(/^A/, ""))
+        .filter((code) => code.length > 0);
+    return {
+        ok: true,
+        data: {
+            initialCodes,
+            unsubscribe,
+        },
+    };
+}
+/* ════════════════════════════════════════════════════════════
+ * ka10174 · 조건검색 실시간 해제
+ * ════════════════════════════════════════════════════════════ */
+export async function stopConditionRealtime(seq) {
+    const ws = getKiwoomWs();
+    const res = await ws.request({ trnm: "CNSRCLR", seq }, { matchKey: seq, timeoutMs: 10_000 });
+    if (!res.ok)
+        return res;
+    if (res.data.return_code !== undefined && res.data.return_code !== 0) {
+        return {
+            ok: false,
+            error: {
+                kind: "business",
+                message: `조건검색 실시간 해제 실패 (${res.data.return_code})`,
+                returnCode: res.data.return_code,
+                returnMsg: res.data.return_msg,
+            },
+        };
+    }
+    return { ok: true, data: undefined };
+}
+/* ─────────── utils ─────────── */
+function toNum(v) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v === "string") {
+        const n = Number(v.replace(/,/g, "").replace(/^\+/, ""));
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+/**
+ * 키움 시세 응답은 "부호 prefix" 형식 (+70500, -79000). 부호를 살려서 정수화.
+ */
+function toNumFromSignedStr(v) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v !== "string")
+        return 0;
+    const trimmed = v.replace(/,/g, "");
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? n : 0;
+}
+//# sourceMappingURL=condition.js.map

package/dist/server/broker/kiwoom/ws/endpoints/condition.js.map

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

package/dist/server/broker/kiwoom/ws/realtime-bus.js

@@ -0,0 +1,42 @@
+import { getKiwoomWs } from "./client.js";
+/**
+ * 특정 조건식 seq 의 실시간 이벤트 구독.
+ *
+ * 주의: 이 함수는 "구독 등록" 만 한다. 서버측 실시간 조회 요청 (ka10173) 은
+ *       별도로 endpoints/condition.ts 의 requestConditionRealtime() 으로 실행.
+ *       두 호출을 묶는 편의 함수는 endpoints/condition.ts 에서 제공.
+ *
+ * @returns unsubscribe 함수 (클라이언트 메모리 · 서버측 해제는 ka10174 별도 호출)
+ */
+export function subscribeConditionStream(seq, handler) {
+    const ws = getKiwoomWs();
+    const subId = `condition-stream:${seq}:${Math.random().toString(36).slice(2, 8)}`;
+    return ws.subscribeStream(subId, "REAL", (msg) => dispatchConditionStream(msg, seq, handler));
+}
+function dispatchConditionStream(msg, targetSeq, handler) {
+    const dataArr = Array.isArray(msg.data) ? msg.data : [];
+    for (const entry of dataArr) {
+        const type = String(entry.type ?? "");
+        if (type !== "02")
+            continue; // 조건검색 이외 스트림은 무시
+        const values = entry.values ?? {};
+        const seq = String(values["841"] ?? "");
+        if (seq !== targetSeq)
+            continue;
+        const ev = {
+            seq,
+            symbolCode: String(values["9001"] ?? entry.item ?? ""),
+            kind: values["843"] === "I" ? "insert" : "delete",
+            timestamp: String(values["20"] ?? ""),
+            sideCode: String(values["907"] ?? ""),
+            raw: entry,
+        };
+        try {
+            handler(ev);
+        }
+        catch {
+            // 핸들러 오류는 다른 구독자에 영향 안 주기 위해 swallow
+        }
+    }
+}
+//# sourceMappingURL=realtime-bus.js.map

package/dist/server/broker/kiwoom/ws/realtime-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-bus.js","sourceRoot":"","sources":["../../../../../src-server/broker/kiwoom/ws/realtime-bus.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoB1C;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAW,EACX,OAA+B;IAE/B,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,oBAAoB,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,uBAAuB,CAC9B,GAAmB,EACnB,SAAiB,EACjB,OAA+B;IAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,IAAkC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS,CAAoC,kBAAkB;QAClF,MAAM,MAAM,GAAI,KAAK,CAAC,MAA8C,IAAI,EAAE,CAAC;QAC3E,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAEhC,MAAM,EAAE,GAAyB;YAC/B,GAAG;YACH,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YACtD,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YACjD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACrC,GAAG,EAAE,KAAK;SACX,CAAC;QACF,IAAI,CAAC;YACH,OAAO,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/server/broker/kiwoom/ws/types.js

@@ -0,0 +1,19 @@
+/**
+ * 키움 WebSocket 공통 타입
+ *
+ * 프로토콜 기본:
+ *   - 도메인: wss://api.kiwoom.com:10000 · wss://mockapi.kiwoom.com:10000
+ *   - URL path: /api/dostk/websocket
+ *   - 인증: HTTP 업그레이드 요청의 `Authorization: Bearer <access_token>` 헤더
+ *           (REST 와 같은 토큰 재사용)
+ *   - 메시지 형식: JSON · 키 `trnm` 으로 서비스 구분
+ *
+ * 주요 trnm:
+ *   - CNSRLST  조건검색 목록 조회 (ka10171)
+ *   - CNSRREQ  조건검색 요청 (일반 = ka10172 · 실시간 = ka10173)
+ *   - CNSRCLR  조건검색 실시간 해제 (ka10174)
+ *   - REAL     실시간 스트림 데이터 (ka10173 이후 push 메시지)
+ *   - PING     keepalive (키움 spec 에 있는 경우)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/broker/kiwoom/ws/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src-server/broker/kiwoom/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/server/broker/news.js

@@ -0,0 +1,34 @@
+/**
+ * 뉴스/공시 stub (apps/client)
+ *
+ * 한국 주식 뉴스 source:
+ *   1. 키움 공시 endpoint (있다면 · 현재 미확인)
+ *   2. NAVER 금융 공시 (web scrape · 비공식)
+ *   3. DART 공시 시스템 (공식 · API 키 필요 · 무료)
+ *   4. 외부 LLM 기반 sentiment API (유료)
+ *
+ * MVP stub:
+ *   - 인터페이스만 정의
+ *   - 실 구현은 P+1 (DART API 가 가장 안정적)
+ *   - 너울 v1.7.0 의 "Step 4 뉴스 확인" 호출 호환
+ */
+/**
+ * 종목 뉴스 조회 (stub · 항상 빈 결과 반환 · 실 구현 P+1)
+ *
+ * 사용법: 너울 v1.7.0 의 "Step 4 뉴스 확인" 에서 호출 · 응답 비어도 logic 진행 가능
+ */
+export async function getStockNews(symbolCode) {
+    // stub · 향후 DART API 또는 NAVER 뉴스 연동
+    return {
+        symbolCode,
+        items: [],
+        overall: "neutral",
+        isStub: true,
+    };
+}
+/** 가장 최근 시장 전체 주요 공시 (stub) */
+export async function getRecentMarketNews(limit = 10) {
+    void limit;
+    return [];
+}
+//# sourceMappingURL=news.js.map

package/dist/server/broker/news.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"news.js","sourceRoot":"","sources":["../../../src-server/broker/news.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwBH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,oCAAoC;IACpC,OAAO;QACL,UAAU;QACV,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAK,GAAG,EAAE;IAClD,KAAK,KAAK,CAAC;IACX,OAAO,EAAE,CAAC;AACZ,CAAC"}