/** * @file lib/kis/config.ts * @description KIS 거래 환경(real/mock) 설정과 키/도메인 로딩 */ export type KisTradingEnv = "real" | "mock"; export interface KisCredentialInput { tradingEnv?: KisTradingEnv; appKey?: string; appSecret?: string; baseUrl?: string; } export interface KisConfig { tradingEnv: KisTradingEnv; appKey: string; appSecret: string; baseUrl: string; } const DEFAULT_KIS_REAL_BASE_URL = "https://openapi.koreainvestment.com:9443"; const DEFAULT_KIS_MOCK_BASE_URL = "https://openapivts.koreainvestment.com:29443"; const DEFAULT_KIS_REAL_WS_URL = "ws://ops.koreainvestment.com:21000"; const DEFAULT_KIS_MOCK_WS_URL = "ws://ops.koreainvestment.com:31000"; /** * 거래 환경 문자열을 정규화합니다. * @param value 환경값 * @returns real | mock */ export function normalizeTradingEnv(value?: string): KisTradingEnv { return (value ?? "mock").toLowerCase() === "real" ? "real" : "mock"; } /** * KIS 웹소켓 URL을 반환합니다. * @param tradingEnvInput 거래 모드(real/mock) * @returns websocket base url */ export function getKisWebSocketUrl(tradingEnvInput?: KisTradingEnv) { const tradingEnv = normalizeTradingEnv(tradingEnvInput); if (tradingEnv === "real") { return DEFAULT_KIS_REAL_WS_URL; } return DEFAULT_KIS_MOCK_WS_URL; } /** * 설정 준비 여부를 확인합니다. * @param input 외부(사용자 입력) 키가 있으면 우선 사용 * @returns 사용 가능 여부 */ export function hasKisConfig(input?: KisCredentialInput) { return Boolean(input?.appKey?.trim() && input?.appSecret?.trim()); } /** * KIS 호출에 필요한 설정을 반환합니다. * @param input 사용자 입력 키(선택) * @returns tradingEnv/appKey/appSecret/baseUrl */ export function getKisConfig(input?: KisCredentialInput): KisConfig { if (input?.appKey?.trim() && input?.appSecret?.trim()) { const tradingEnv = normalizeTradingEnv(input.tradingEnv); const baseUrl = input.baseUrl ?? (tradingEnv === "real" ? DEFAULT_KIS_REAL_BASE_URL : DEFAULT_KIS_MOCK_BASE_URL); return { tradingEnv, appKey: input.appKey.trim(), appSecret: input.appSecret.trim(), baseUrl, }; } throw new Error( "KIS API 키가 없습니다. 설정 화면에서 앱 키와 앱 시크릿을 먼저 입력해 주세요.", ); }