algokit-mcp 1.0.0

package/dist/types/programmers.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 프로그래머스 관련 타입 정의
+ */
+/**
+ * 프로그래머스 문제 검색 옵션
+ */
+export interface ProgrammersSearchOptions {
+    /** 난이도 필터 (0-5) */
+    levels?: number[];
+    /** 카테고리 필터 */
+    categories?: string[];
+    /** 정렬 순서 */
+    order?: 'recent' | 'accuracy' | 'popular';
+    /** 페이지 번호 (1부터 시작) */
+    page?: number;
+    /** 반환할 최대 문제 수 */
+    limit?: number;
+    /** 검색어 */
+    query?: string;
+}
+/**
+ * 프로그래머스 문제 요약 정보 (검색 결과)
+ */
+export interface ProgrammersProblemSummary {
+    /** 문제 ID */
+    problemId: string;
+    /** 문제 제목 */
+    title: string;
+    /** 난이도 (0-5) */
+    level: number;
+    /** 카테고리 */
+    category: string;
+    /** 문제 URL */
+    url: string;
+    /** 완료한 사람 수 (optional) */
+    finishedCount?: number;
+    /** 정답률 (0-100, optional) */
+    acceptanceRate?: number;
+}
+/**
+ * 프로그래머스 문제 상세 정보 (상세 페이지)
+ */
+export interface ProgrammersProblemDetail {
+    /** 문제 ID */
+    problemId: string;
+    /** 문제 제목 */
+    title: string;
+    /** 난이도 (0-5) */
+    level: number;
+    /** 카테고리 */
+    category: string;
+    /** 문제 설명 (HTML) */
+    description: string;
+    /** 제한사항 */
+    constraints: string[];
+    /** 입출력 예시 */
+    examples: ProgrammersExample[];
+    /** 태그 */
+    tags: string[];
+}
+/**
+ * 입출력 예시
+ */
+export interface ProgrammersExample {
+    /** 입력 */
+    input: string;
+    /** 출력 */
+    output: string;
+    /** 설명 (optional) */
+    explanation?: string;
+}
+//# sourceMappingURL=programmers.d.ts.map

package/dist/types/programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmers.d.ts","sourceRoot":"","sources":["../../src/types/programmers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY;IACZ,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa;IACb,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS;IACT,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS;IACT,KAAK,EAAE,MAAM,CAAC;IACd,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/programmers.js

@@ -0,0 +1,5 @@
+/**
+ * 프로그래머스 관련 타입 정의
+ */
+export {};
+//# sourceMappingURL=programmers.js.map

package/dist/types/programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmers.js","sourceRoot":"","sources":["../../src/types/programmers.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/browser-pool.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Puppeteer 브라우저 인스턴스 풀
+ *
+ * Phase 7 - Task 7.1: Puppeteer 설치 및 BrowserPool 구현
+ *
+ * 메모리 효율성을 위해 브라우저 인스턴스를 재사용합니다.
+ * - 최대 2개 인스턴스 유지
+ * - 100회 사용 후 자동 재시작 (메모리 누수 방지)
+ * - 타임아웃 및 에러 처리
+ */
+import { Browser } from 'puppeteer';
+/**
+ * BrowserPool 설정 옵션
+ */
+export interface BrowserPoolOptions {
+    /** 최대 브라우저 인스턴스 수 (기본값: 2) */
+    maxSize?: number;
+    /** 브라우저 재시작 임계값 (사용 횟수, 기본값: 100) */
+    restartThreshold?: number;
+    /** 브라우저 인스턴스 타임아웃 (밀리초, 기본값: 60000) */
+    timeout?: number;
+}
+/**
+ * Puppeteer 브라우저 풀
+ *
+ * 싱글톤 패턴으로 브라우저 인스턴스를 관리합니다.
+ *
+ * @example
+ * ```typescript
+ * const pool = BrowserPool.getInstance();
+ * const browser = await pool.acquire();
+ * try {
+ *   const page = await browser.newPage();
+ *   await page.goto('https://example.com');
+ *   // ...
+ * } finally {
+ *   await pool.release(browser);
+ * }
+ * ```
+ */
+export declare class BrowserPool {
+    private static instance;
+    private instances;
+    private readonly maxSize;
+    private readonly restartThreshold;
+    private readonly timeout;
+    private acquireQueue;
+    private constructor();
+    /**
+     * BrowserPool 싱글톤 인스턴스 획득
+     */
+    static getInstance(options?: BrowserPoolOptions): BrowserPool;
+    /**
+     * 싱글톤 인스턴스 초기화 (테스트용)
+     */
+    static resetInstance(): void;
+    /**
+     * 브라우저 인스턴스 획득
+     *
+     * 사용 가능한 인스턴스가 없으면 대기하거나 새로 생성합니다.
+     *
+     * @returns Browser 인스턴스
+     * @throws {Error} 타임아웃 또는 브라우저 실행 실패 시
+     */
+    acquire(): Promise<Browser>;
+    /**
+     * 브라우저 인스턴스 반환
+     *
+     * @param browser - 반환할 Browser 인스턴스
+     */
+    release(browser: Browser): Promise<void>;
+    /**
+     * 모든 브라우저 인스턴스 종료
+     */
+    closeAll(): Promise<void>;
+    /**
+     * 풀 상태 조회
+     */
+    getStatus(): {
+        total: number;
+        active: number;
+        waiting: number;
+    };
+    /**
+     * 새 브라우저 인스턴스 생성
+     */
+    private createBrowser;
+    /**
+     * 브라우저 인스턴스 재시작
+     */
+    private restartBrowser;
+}
+//# sourceMappingURL=browser-pool.d.ts.map

package/dist/utils/browser-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-pool.d.ts","sourceRoot":"","sources":["../../src/utils/browser-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAkB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IAEnD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,YAAY,CAGZ;IAER,OAAO;IAMP;;OAEG;WACW,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAOpE;;OAEG;WACW,aAAa,IAAI,IAAI;IAOnC;;;;;;;OAOG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAqDxC;;;;OAIG;IACU,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrD;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtC;;OAEG;IACI,SAAS,IAAI;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;IAQD;;OAEG;YACW,aAAa;IAe3B;;OAEG;YACW,cAAc;CAW7B"}

package/dist/utils/browser-pool.js

@@ -0,0 +1,193 @@
+/**
+ * Puppeteer 브라우저 인스턴스 풀
+ *
+ * Phase 7 - Task 7.1: Puppeteer 설치 및 BrowserPool 구현
+ *
+ * 메모리 효율성을 위해 브라우저 인스턴스를 재사용합니다.
+ * - 최대 2개 인스턴스 유지
+ * - 100회 사용 후 자동 재시작 (메모리 누수 방지)
+ * - 타임아웃 및 에러 처리
+ */
+import puppeteer from 'puppeteer';
+/**
+ * Puppeteer 브라우저 풀
+ *
+ * 싱글톤 패턴으로 브라우저 인스턴스를 관리합니다.
+ *
+ * @example
+ * ```typescript
+ * const pool = BrowserPool.getInstance();
+ * const browser = await pool.acquire();
+ * try {
+ *   const page = await browser.newPage();
+ *   await page.goto('https://example.com');
+ *   // ...
+ * } finally {
+ *   await pool.release(browser);
+ * }
+ * ```
+ */
+export class BrowserPool {
+    static instance = null;
+    instances = [];
+    maxSize;
+    restartThreshold;
+    timeout;
+    acquireQueue = [];
+    constructor(options = {}) {
+        this.maxSize = options.maxSize ?? 2;
+        this.restartThreshold = options.restartThreshold ?? 100;
+        this.timeout = options.timeout ?? 60000;
+    }
+    /**
+     * BrowserPool 싱글톤 인스턴스 획득
+     */
+    static getInstance(options) {
+        if (!BrowserPool.instance) {
+            BrowserPool.instance = new BrowserPool(options);
+        }
+        return BrowserPool.instance;
+    }
+    /**
+     * 싱글톤 인스턴스 초기화 (테스트용)
+     */
+    static resetInstance() {
+        if (BrowserPool.instance) {
+            BrowserPool.instance.closeAll();
+            BrowserPool.instance = null;
+        }
+    }
+    /**
+     * 브라우저 인스턴스 획득
+     *
+     * 사용 가능한 인스턴스가 없으면 대기하거나 새로 생성합니다.
+     *
+     * @returns Browser 인스턴스
+     * @throws {Error} 타임아웃 또는 브라우저 실행 실패 시
+     */
+    async acquire() {
+        // 1. 사용 가능한 인스턴스 우선 확인 (재사용)
+        const available = this.instances.find(inst => inst.browser.isConnected() && !inst.inUse);
+        if (available) {
+            available.inUse = true;
+            available.usageCount++;
+            // 재시작 임계값 초과 시 교체
+            if (available.usageCount >= this.restartThreshold) {
+                await this.restartBrowser(available);
+            }
+            return available.browser;
+        }
+        // 2. 새 인스턴스 생성 가능 여부 확인
+        if (this.instances.length < this.maxSize) {
+            const browser = await this.createBrowser();
+            const instance = {
+                browser,
+                usageCount: 1,
+                createdAt: Date.now(),
+                inUse: true,
+            };
+            this.instances.push(instance);
+            return browser;
+        }
+        // 3. 대기 큐에 추가 (풀이 가득 차고 사용 가능한 인스턴스 없음)
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                const index = this.acquireQueue.findIndex(item => item.resolve === resolve);
+                if (index !== -1) {
+                    this.acquireQueue.splice(index, 1);
+                }
+                reject(new Error('Browser acquire timeout'));
+            }, this.timeout);
+            this.acquireQueue.push({
+                resolve: (browser) => {
+                    clearTimeout(timeoutId);
+                    resolve(browser);
+                },
+                reject: (error) => {
+                    clearTimeout(timeoutId);
+                    reject(error);
+                },
+            });
+        });
+    }
+    /**
+     * 브라우저 인스턴스 반환
+     *
+     * @param browser - 반환할 Browser 인스턴스
+     */
+    async release(browser) {
+        const instance = this.instances.find(inst => inst.browser === browser);
+        if (!instance) {
+            return;
+        }
+        // 대기 중인 요청이 있으면 즉시 전달 (inUse 상태 유지)
+        if (this.acquireQueue.length > 0) {
+            const waiter = this.acquireQueue.shift();
+            if (waiter) {
+                instance.usageCount++;
+                waiter.resolve(browser);
+                return;
+            }
+        }
+        // 아니면 사용 가능 상태로 전환
+        instance.inUse = false;
+    }
+    /**
+     * 모든 브라우저 인스턴스 종료
+     */
+    async closeAll() {
+        // 대기 중인 요청 모두 거부
+        for (const waiter of this.acquireQueue) {
+            waiter.reject(new Error('BrowserPool is closing'));
+        }
+        this.acquireQueue = [];
+        // 모든 브라우저 종료
+        await Promise.all(this.instances.map(async (inst) => {
+            if (inst.browser.isConnected()) {
+                await inst.browser.close();
+            }
+        }));
+        this.instances = [];
+    }
+    /**
+     * 풀 상태 조회
+     */
+    getStatus() {
+        return {
+            total: this.instances.length,
+            active: this.instances.filter(inst => inst.browser.isConnected()).length,
+            waiting: this.acquireQueue.length,
+        };
+    }
+    /**
+     * 새 브라우저 인스턴스 생성
+     */
+    async createBrowser() {
+        return await puppeteer.launch({
+            headless: true,
+            args: [
+                '--no-sandbox',
+                '--disable-setuid-sandbox',
+                '--disable-dev-shm-usage', // 메모리 절약
+                '--disable-accelerated-2d-canvas',
+                '--no-first-run',
+                '--no-zygote',
+                '--disable-gpu',
+            ],
+        });
+    }
+    /**
+     * 브라우저 인스턴스 재시작
+     */
+    async restartBrowser(instance) {
+        if (instance.browser.isConnected()) {
+            await instance.browser.close();
+        }
+        const newBrowser = await this.createBrowser();
+        instance.browser = newBrowser;
+        instance.usageCount = 0;
+        instance.createdAt = Date.now();
+        instance.inUse = true;
+    }
+}
+//# sourceMappingURL=browser-pool.js.map

package/dist/utils/browser-pool.js.map

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

package/dist/utils/cache-stats.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 캐시 통계 수집기
+ *
+ * 여러 캐시의 통계를 중앙에서 관리하고 보고서 생성
+ */
+export interface CacheMetrics {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    capacity: number;
+}
+export interface AggregatedCacheStats {
+    totalRequests: number;
+    hitRate: number;
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    capacity: number;
+}
+/**
+ * CacheStatsCollector 클래스
+ *
+ * 여러 캐시의 통계를 수집하고 관리
+ */
+export declare class CacheStatsCollector {
+    private stats;
+    /**
+     * 캐시 통계 기록
+     *
+     * @param cacheName - 캐시 이름 (예: 'problems', 'tags')
+     * @param metrics - 캐시 메트릭
+     */
+    record(cacheName: string, metrics: CacheMetrics): void;
+    /**
+     * 특정 캐시 통계 조회
+     *
+     * @param cacheName - 캐시 이름
+     * @returns 캐시 통계 또는 undefined
+     */
+    get(cacheName: string): AggregatedCacheStats | undefined;
+    /**
+     * 모든 캐시 통계 조회
+     *
+     * @returns 모든 캐시 통계 Map
+     */
+    getAll(): Map<string, AggregatedCacheStats>;
+    /**
+     * 모든 캐시 통계 초기화
+     */
+    reset(): void;
+    /**
+     * 보고서 생성
+     *
+     * @returns 텍스트 형식의 통계 보고서
+     */
+    generateReport(): string;
+}
+//# sourceMappingURL=cache-stats.d.ts.map

package/dist/utils/cache-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-stats.d.ts","sourceRoot":"","sources":["../../src/utils/cache-stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAA2C;IAExD;;;;;OAKG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAetD;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIxD;;;;OAIG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAI3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAsBzB"}

package/dist/utils/cache-stats.js

@@ -0,0 +1,78 @@
+/**
+ * 캐시 통계 수집기
+ *
+ * 여러 캐시의 통계를 중앙에서 관리하고 보고서 생성
+ */
+/**
+ * CacheStatsCollector 클래스
+ *
+ * 여러 캐시의 통계를 수집하고 관리
+ */
+export class CacheStatsCollector {
+    stats = new Map();
+    /**
+     * 캐시 통계 기록
+     *
+     * @param cacheName - 캐시 이름 (예: 'problems', 'tags')
+     * @param metrics - 캐시 메트릭
+     */
+    record(cacheName, metrics) {
+        const totalRequests = metrics.hits + metrics.misses;
+        const hitRate = totalRequests > 0 ? metrics.hits / totalRequests : 0;
+        this.stats.set(cacheName, {
+            totalRequests,
+            hitRate,
+            hits: metrics.hits,
+            misses: metrics.misses,
+            evictions: metrics.evictions,
+            size: metrics.size,
+            capacity: metrics.capacity,
+        });
+    }
+    /**
+     * 특정 캐시 통계 조회
+     *
+     * @param cacheName - 캐시 이름
+     * @returns 캐시 통계 또는 undefined
+     */
+    get(cacheName) {
+        return this.stats.get(cacheName);
+    }
+    /**
+     * 모든 캐시 통계 조회
+     *
+     * @returns 모든 캐시 통계 Map
+     */
+    getAll() {
+        return new Map(this.stats);
+    }
+    /**
+     * 모든 캐시 통계 초기화
+     */
+    reset() {
+        this.stats.clear();
+    }
+    /**
+     * 보고서 생성
+     *
+     * @returns 텍스트 형식의 통계 보고서
+     */
+    generateReport() {
+        if (this.stats.size === 0) {
+            return '캐시 통계가 없습니다.';
+        }
+        const lines = ['=== 캐시 통계 보고서 ==='];
+        for (const [cacheName, stats] of this.stats.entries()) {
+            lines.push('');
+            lines.push(`캐시: ${cacheName}`);
+            lines.push(`총 요청: ${stats.totalRequests}`);
+            lines.push(`히트: ${stats.hits} (${(stats.hitRate * 100).toFixed(2)}%)`);
+            lines.push(`미스: ${stats.misses}`);
+            lines.push(`제거: ${stats.evictions}`);
+            lines.push(`크기: ${stats.size}/${stats.capacity}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=cache-stats.js.map

package/dist/utils/cache-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-stats.js","sourceRoot":"","sources":["../../src/utils/cache-stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAExD;;;;;OAKG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAqB;QAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;QACpD,MAAM,OAAO,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAErE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE;YACxB,aAAa;YACb,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,MAAM,KAAK,GAAa,CAAC,mBAAmB,CAAC,CAAC;QAE9C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CACR,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC3D,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 간단한 인메모리 캐시 구현
+ * TTL (Time To Live) 기반 캐싱
+ */
+/**
+ * 캐시 옵션
+ */
+export interface CacheOptions {
+    ttl?: number;
+}
+/**
+ * 인메모리 캐시 클래스
+ */
+export declare class Cache<T> {
+    private store;
+    private defaultTtl;
+    constructor(options?: CacheOptions);
+    /**
+     * 캐시에 값 저장
+     * @param key - 캐시 키
+     * @param value - 저장할 값
+     * @param ttl - TTL (밀리초, 선택사항)
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * 캐시에서 값 조회
+     * @param key - 캐시 키
+     * @returns 캐시된 값 또는 undefined
+     */
+    get(key: string): T | undefined;
+    /**
+     * 캐시에 키가 존재하는지 확인
+     * @param key - 캐시 키
+     * @returns 존재 여부
+     */
+    has(key: string): boolean;
+    /**
+     * 캐시에서 키 삭제
+     * @param key - 캐시 키
+     * @returns 삭제 성공 여부
+     */
+    delete(key: string): boolean;
+    /**
+     * 캐시 전체 삭제
+     */
+    clear(): void;
+    /**
+     * 만료된 항목 정리
+     */
+    cleanup(): void;
+    /**
+     * 캐시 크기 반환
+     */
+    size(): number;
+    /**
+     * 캐시 히트율 측정용 통계 (간단한 구현)
+     */
+    getStats(): {
+        size: number;
+    };
+}
+/**
+ * 문제 상세 정보 캐시 (싱글톤)
+ * TTL: 1시간 (문제 메타데이터는 자주 변경되지 않음)
+ */
+export declare const problemCache: Cache<unknown>;
+/**
+ * 검색 결과 캐시 (싱글톤)
+ * TTL: 10분 (검색 결과는 상대적으로 자주 변경될 수 있음)
+ */
+export declare const searchCache: Cache<unknown>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,KAAK,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,YAAiB;IAItC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAgB/B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CAK7B;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,gBAAqC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,WAAW,gBAAqC,CAAC"}