daiso 1.0.4 → 1.0.6

package/dist/cliInteractive.js

@@ -0,0 +1,243 @@
+/**
+ * CLI 인터랙티브 모드
+ *
+ * 좌표 입력 없이 서비스/매장/상품을 순차 선택해 재고를 확인합니다.
+ */
+import { createInterface } from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { pickFromList } from './cliPicker.js';
+import { fetchEnvelope, fetchStoresWithKeywordFallback } from './cli/interactiveFetch.js';
+import { askMenu, askNextAction, askNonEmpty, askYesNo, printStoreDetail } from './cli/interactivePrompt.js';
+import { parseLotteCinemaTheaters, printTheaterDetail, runCuItemSearch, runDaisoItemSearch, runLotteCinemaSearch, runOliveyoungItemSearch, } from './cli/interactiveItemSearch.js';
+import { buildDaisoStoreKeywordVariants, isRecord, parseDaisoProducts, parseStores, toText } from './utils/cliInteractiveHelpers.js';
+function isLocationToken(token) {
+    return /(?:역|점|동|구|시|군|읍|면|로|길)$/.test(token);
+}
+export function inferDaisoFreeTextIntent(input) {
+    const tokens = input.trim().split(/\s+/).filter(Boolean);
+    if (tokens.length <= 1) {
+        const value = tokens[0] || input.trim();
+        return { productQuery: value, storeKeyword: value };
+    }
+    const locationIndex = tokens.findIndex(isLocationToken);
+    if (locationIndex >= 0) {
+        const storeKeyword = tokens[locationIndex];
+        const productQuery = tokens.filter((_, index) => index !== locationIndex).join(' ').trim() || input.trim();
+        return { productQuery, storeKeyword };
+    }
+    const storeKeyword = tokens[tokens.length - 1];
+    const productQuery = tokens.slice(0, -1).join(' ').trim() || input.trim();
+    return { productQuery, storeKeyword };
+}
+async function askServiceChoice(prompt, writeOut) {
+    while (true) {
+        const answer = await prompt.ask('서비스 번호를 선택하세요 (0: 종료): ');
+        const picked = Number.parseInt(answer, 10);
+        if (!Number.isNaN(picked) && String(picked) === answer.trim()) {
+            if (picked >= 0 && picked <= 4) {
+                return picked;
+            }
+            writeOut('번호로 입력하세요. 0부터 4 사이에서 선택할 수 있습니다.');
+            continue;
+        }
+        if (answer.trim().length > 0) {
+            return answer.trim();
+        }
+        writeOut('번호로 입력하세요. 0부터 4 사이에서 선택할 수 있습니다.');
+    }
+}
+function createPrompt() {
+    const rl = createInterface({ input, output });
+    return {
+        ask: async (question) => {
+            const answer = await rl.question(question);
+            return answer.trim();
+        },
+        close: () => {
+            rl.close();
+        },
+    };
+}
+/**
+ * 테스트 전용 내부 헬퍼 노출
+ */
+export const cliInteractiveTestables = {
+    isRecord,
+    toText,
+    buildDaisoStoreKeywordVariants,
+    fetchEnvelope,
+    fetchStoresWithKeywordFallback,
+    parseStores,
+    parseDaisoProducts,
+    askMenu,
+    askYesNo,
+    askNonEmpty,
+    askNextAction,
+    printStoreDetail,
+    inferDaisoFreeTextIntent,
+    runDaisoItemSearch,
+    runOliveyoungItemSearch,
+    runCuItemSearch,
+    runLotteCinemaSearch,
+};
+export async function runInteractiveCli(deps) {
+    const prompt = deps.createPrompt ? deps.createPrompt() : createPrompt();
+    try {
+        deps.writeOut('daiso 인터랙티브 모드');
+        let keepRunning = true;
+        while (keepRunning) {
+            deps.writeOut('');
+            deps.writeOut('[서비스 선택]');
+            deps.writeOut('1. 다이소');
+            deps.writeOut('2. 올리브영');
+            deps.writeOut('3. CU');
+            deps.writeOut('4. 롯데시네마');
+            const serviceChoice = await askServiceChoice(prompt, deps.writeOut);
+            if (typeof serviceChoice === 'string') {
+                const intent = inferDaisoFreeTextIntent(serviceChoice);
+                deps.writeOut('자유 입력을 다이소 조회로 처리합니다.');
+                deps.writeOut(`- 상품 키워드: ${intent.productQuery}`);
+                deps.writeOut(`- 위치 키워드: ${intent.storeKeyword}`);
+                const storeResult = await fetchStoresWithKeywordFallback(deps.fetchImpl, 'daiso', intent.storeKeyword);
+                const stores = storeResult.stores;
+                if (stores.length === 0) {
+                    deps.writeOut('검색된 매장이 없습니다.');
+                    deps.writeOut('힌트: "안산 중앙역" 대신 "안산중앙" 또는 "고잔"으로 검색해보세요.');
+                    keepRunning = await askYesNo(prompt, '다시 시도할까요? (y/n): ');
+                    continue;
+                }
+                const selectedStore = stores.length === 1
+                    ? stores[0]
+                    : await pickFromList({
+                        prompt,
+                        writeOut: deps.writeOut,
+                        title: '[매장 선택]',
+                        emptyText: '검색된 매장이 없습니다.',
+                        cancelText: '매장 검색으로 돌아갑니다.',
+                        items: stores,
+                        renderItem: (store, index) => `${index + 1}. ${store.name} | ${store.address || '주소 정보 없음'}`,
+                        filterText: (store) => `${store.name} ${store.address} ${store.phone}`,
+                        indexText: '입력: 번호 선택 | /키워드 필터 | all 전체보기 | 0 다시 검색',
+                    });
+                if (!selectedStore) {
+                    continue;
+                }
+                printStoreDetail(deps.writeOut, selectedStore);
+                await runDaisoItemSearch(deps, prompt, selectedStore, intent.productQuery);
+                const nextAction = await askNextAction(prompt, deps.writeOut);
+                if (nextAction === 'exit') {
+                    keepRunning = false;
+                }
+                continue;
+            }
+            if (serviceChoice === 0) {
+                break;
+            }
+            if (serviceChoice === 4) {
+                const theaterKeyword = await askNonEmpty(prompt, '극장 검색 키워드를 입력하세요: ');
+                const payload = await fetchEnvelope(deps.fetchImpl, '/api/lottecinema/theaters', {
+                    keyword: theaterKeyword,
+                    limit: '10',
+                });
+                const theaters = parseLotteCinemaTheaters(payload).filter((entry) => `${entry.name} ${entry.address}`.includes(theaterKeyword));
+                if (theaters.length === 0) {
+                    deps.writeOut('검색된 극장이 없습니다.');
+                    keepRunning = await askYesNo(prompt, '다시 시도할까요? (y/n): ');
+                    continue;
+                }
+                const selectedTheater = await pickFromList({
+                    prompt,
+                    writeOut: deps.writeOut,
+                    title: '[극장 선택]',
+                    emptyText: '검색된 극장이 없습니다.',
+                    cancelText: '극장 검색으로 돌아갑니다.',
+                    items: theaters,
+                    renderItem: (theater, index) => `${index + 1}. ${theater.name} | ${theater.address || '주소 정보 없음'} | ${theater.distanceKm}km`,
+                    filterText: (theater) => `${theater.name} ${theater.address} ${theater.theaterId}`,
+                    indexText: '입력: 번호 선택 | /키워드 필터 | all 전체보기 | 0 다시 검색',
+                });
+                if (!selectedTheater) {
+                    continue;
+                }
+                printTheaterDetail(deps.writeOut, selectedTheater);
+                let keepTheaterSearch = true;
+                while (keepTheaterSearch) {
+                    await runLotteCinemaSearch(deps, prompt, selectedTheater);
+                    const nextAction = await askNextAction(prompt, deps.writeOut);
+                    if (nextAction === 'same-store') {
+                        continue;
+                    }
+                    if (nextAction === 'change-store') {
+                        keepTheaterSearch = false;
+                        continue;
+                    }
+                    keepRunning = false;
+                    keepTheaterSearch = false;
+                }
+                continue;
+            }
+            const service = serviceChoice === 1 ? 'daiso' : serviceChoice === 2 ? 'oliveyoung' : 'cu';
+            const storeKeyword = await askNonEmpty(prompt, '매장 검색 키워드를 입력하세요: ');
+            const storeResult = await fetchStoresWithKeywordFallback(deps.fetchImpl, service, storeKeyword);
+            const stores = storeResult.stores;
+            if (service === 'daiso' && stores.length > 0 && storeResult.matchedKeyword !== storeKeyword) {
+                deps.writeOut(`입력 키워드 "${storeKeyword}" 대신 "${storeResult.matchedKeyword}"로 매장을 찾았습니다.`);
+            }
+            if (stores.length === 0) {
+                deps.writeOut('검색된 매장이 없습니다.');
+                if (service === 'daiso') {
+                    deps.writeOut('힌트: "안산 중앙역" 대신 "안산중앙" 또는 "고잔"으로 검색해보세요.');
+                }
+                keepRunning = await askYesNo(prompt, '다시 시도할까요? (y/n): ');
+                continue;
+            }
+            const selectedStore = await pickFromList({
+                prompt,
+                writeOut: deps.writeOut,
+                title: '[매장 선택]',
+                emptyText: '검색된 매장이 없습니다.',
+                cancelText: '매장 검색으로 돌아갑니다.',
+                items: stores,
+                renderItem: (store, index) => `${index + 1}. ${store.name} | ${store.address || '주소 정보 없음'}`,
+                filterText: (store) => `${store.name} ${store.address} ${store.phone}`,
+                indexText: '입력: 번호 선택 | /키워드 필터 | all 전체보기 | 0 다시 검색',
+            });
+            if (!selectedStore) {
+                continue;
+            }
+            printStoreDetail(deps.writeOut, selectedStore);
+            let keepItemSearch = true;
+            while (keepItemSearch) {
+                if (service === 'daiso') {
+                    await runDaisoItemSearch(deps, prompt, selectedStore);
+                }
+                else if (service === 'oliveyoung') {
+                    await runOliveyoungItemSearch(deps, prompt, selectedStore);
+                }
+                else {
+                    await runCuItemSearch(deps, prompt, selectedStore);
+                }
+                const nextAction = await askNextAction(prompt, deps.writeOut);
+                if (nextAction === 'same-store') {
+                    continue;
+                }
+                if (nextAction === 'change-store') {
+                    keepItemSearch = false;
+                    continue;
+                }
+                keepRunning = false;
+                keepItemSearch = false;
+            }
+        }
+        deps.writeOut('인터랙티브 모드를 종료합니다.');
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        deps.writeErr(`인터랙티브 실행 중 오류 발생: ${message}`);
+        return 1;
+    }
+    finally {
+        prompt.close();
+    }
+}

package/dist/cliPicker.js

@@ -0,0 +1,57 @@
+/**
+ * 인터랙티브 목록 선택 유틸리티
+ *
+ * 번호 선택, /키워드 필터, all(전체 복원), 0(취소)을 지원합니다.
+ */
+function normalize(value) {
+    return value.toLowerCase();
+}
+function defaultFilterText(item) {
+    return typeof item === 'string' ? item : JSON.stringify(item);
+}
+export async function pickFromList(options) {
+    const { prompt, writeOut, title, emptyText, cancelText, items, renderItem, indexText = '입력: 번호 선택 | /키워드 필터 | all 전체보기 | 0 취소', filterText = defaultFilterText, } = options;
+    if (items.length === 0) {
+        writeOut(emptyText);
+        return null;
+    }
+    let visibleItems = items;
+    while (true) {
+        writeOut('');
+        writeOut(title);
+        for (let i = 0; i < visibleItems.length; i += 1) {
+            writeOut(renderItem(visibleItems[i], i));
+        }
+        writeOut(indexText);
+        const answer = await prompt.ask('선택: ');
+        if (answer === '0') {
+            writeOut(cancelText);
+            return null;
+        }
+        if (answer === 'all') {
+            visibleItems = items;
+            continue;
+        }
+        if (answer.startsWith('/')) {
+            const query = answer.slice(1).trim();
+            if (!query) {
+                visibleItems = items;
+                continue;
+            }
+            const needle = normalize(query);
+            const filtered = items.filter((item) => normalize(filterText(item)).includes(needle));
+            if (filtered.length === 0) {
+                writeOut(`"${query}" 검색 결과가 없습니다.`);
+                continue;
+            }
+            visibleItems = filtered;
+            continue;
+        }
+        const picked = Number.parseInt(answer, 10);
+        if (Number.isNaN(picked) || picked < 1 || picked > visibleItems.length) {
+            writeOut(`번호로 입력하세요. 1부터 ${visibleItems.length} 사이에서 선택하거나 0으로 취소하세요.`);
+            continue;
+        }
+        return visibleItems[picked - 1];
+    }
+}

package/dist/cliRenderer.js

@@ -29,7 +29,17 @@ function formatMeta(meta) {
     return [`메타: ${pairs.join(', ')}`];
 }
 function detectName(item) {
-    const keys = ['name', 'productName', 'storeName', 'theaterName', 'movieName'];
+    const keys = [
+        'name',
+        'productName',
+        'goodsNm',
+        'goodsName',
+        'itemName',
+        'searchItemName',
+        'storeName',
+        'theaterName',
+        'movieName',
+    ];
     for (const key of keys) {
         if (typeof item[key] === 'string' && item[key].trim().length > 0) {
             return item[key];
@@ -49,8 +59,18 @@ function formatCollection(title, items) {
             continue;
         }
         const name = detectName(entry);
-        const id = entry.id ?? entry.productId ?? entry.PD_NO ?? entry.storeCode ?? entry.theaterId ?? entry.movieId;
-        const price = entry.price ?? entry.prc ?? entry.PD_PRC;
+        const id = entry.id ??
+            entry.productId ??
+            entry.PD_NO ??
+            entry.itemCode ??
+            entry.pluCd ??
+            entry.goodsNumber ??
+            entry.productNo ??
+            entry.storeCode ??
+            entry.bizNo ??
+            entry.theaterId ??
+            entry.movieId;
+        const price = entry.price ?? entry.prc ?? entry.PD_PRC ?? entry.viewPrice ?? entry.priceToPay ?? entry.searchItemSellPrice;
         let detail = `- ${name}`;
         if (id !== undefined) {
             detail += ` [${toText(id)}]`;
@@ -58,6 +78,22 @@ function formatCollection(title, items) {
         if (price !== undefined) {
             detail += ` / ${toText(price)}원`;
         }
+        const detailParts = [
+            entry.address ?? entry.storeAddress,
+            entry.distance !== undefined ? `${toText(entry.distance)}km` : undefined,
+            entry.distanceKm !== undefined ? `${toText(entry.distanceKm)}km` : undefined,
+            entry.distanceM !== undefined ? `${toText(entry.distanceM)}m` : undefined,
+            entry.quantity !== undefined ? `수량 ${toText(entry.quantity)}` : undefined,
+            entry.stock !== undefined ? `수량 ${toText(entry.stock)}` : undefined,
+            entry.realStockQuantity !== undefined ? `수량 ${toText(entry.realStockQuantity)}` : undefined,
+            entry.bizQty !== undefined ? `수량 ${toText(entry.bizQty)}` : undefined,
+            entry.remainQuantity !== undefined ? `수량 ${toText(entry.remainQuantity)}` : undefined,
+            entry.o2oRemainQuantity !== undefined ? `수량 ${toText(entry.o2oRemainQuantity)}` : undefined,
+            entry.stockLabel,
+        ].filter((value) => value !== undefined);
+        if (detailParts.length > 0) {
+            detail += ` / ${detailParts.map(toText).join(' / ')}`;
+        }
         lines.push(detail);
     }
     if (items.length > preview.length) {
@@ -65,6 +101,47 @@ function formatCollection(title, items) {
     }
     return lines;
 }
+function formatNestedInventory(data) {
+    const lines = [];
+    if (isRecord(data.nearbyStores)) {
+        lines.push(...formatCollection('주변 매장', data.nearbyStores.stores));
+    }
+    if (isRecord(data.inventory)) {
+        lines.push(...formatCollection('재고 매장', data.inventory.stores));
+        lines.push(...formatCollection('재고 항목', data.inventory.items));
+        lines.push(...formatCollection('재고 상품', data.inventory.products));
+        if (Array.isArray(data.inventory.products)) {
+            for (const product of data.inventory.products.slice(0, 3)) {
+                if (!isRecord(product) || !isRecord(product.storeInventory)) {
+                    continue;
+                }
+                lines.push(...formatCollection('상품별 매장 재고', product.storeInventory.stores));
+            }
+        }
+    }
+    return lines;
+}
+function formatDisplayLocation(data) {
+    const lines = [`진열 위치: ${data.hasLocation === true ? '있음' : '없음'}`];
+    if (!Array.isArray(data.locations) || data.locations.length === 0) {
+        return lines;
+    }
+    lines.push(`위치 목록: ${data.locations.length}건`);
+    for (const location of data.locations.slice(0, 5)) {
+        if (!isRecord(location)) {
+            lines.push(`- ${toText(location)}`);
+            continue;
+        }
+        const zoneNo = toText(location.zoneNo);
+        const stairNo = toText(location.stairNo);
+        const storeErp = location.storeErp !== undefined ? ` / storeErp ${toText(location.storeErp)}` : '';
+        lines.push(`- 구역 ${zoneNo} / 층 ${stairNo}${storeErp}`);
+    }
+    if (data.locations.length > 5) {
+        lines.push(`...외 ${data.locations.length - 5}건`);
+    }
+    return lines;
+}
 function formatProductDetail(data) {
     const id = data.id ?? data.productId ?? '-';
     const name = data.name ?? data.productName ?? '-';
@@ -113,6 +190,16 @@ export function renderApiEnvelope(command, url, payload) {
     else if (command === 'inventory') {
         lines.push(...formatInventory(data));
     }
+    else if (command === 'display-location') {
+        lines.push(...formatDisplayLocation(data));
+    }
+    else if (command === 'cu-inventory') {
+        lines.push(...formatCollection('매장 목록', isRecord(data.nearbyStores) ? data.nearbyStores.stores : undefined));
+        lines.push(...formatCollection('재고 항목', isRecord(data.inventory) ? data.inventory.items : undefined));
+    }
+    else if (command.endsWith('-inventory')) {
+        lines.push(...formatNestedInventory(data));
+    }
     else {
         lines.push(...formatCollection('제품 목록', data.products));
         lines.push(...formatCollection('매장 목록', data.stores));

package/dist/core/errors.js

@@ -0,0 +1,66 @@
+/**
+ * MCP/API 공통 에러 진단 구조
+ */
+const SERVICE_PREFIXES = [
+    'daiso',
+    'gs25',
+    'seveneleven',
+    'cu',
+    'emart24',
+    'lottemart',
+    'megabox',
+    'lottecinema',
+    'cgv',
+    'oliveyoung',
+];
+function normalizeService(value) {
+    return value.toLowerCase().replace(/_/g, '');
+}
+function toOperation(parts) {
+    const filtered = parts.filter((part) => part.length > 0 && part !== 'FAILED');
+    if (filtered.length === 0) {
+        return undefined;
+    }
+    return filtered.map((part) => part.toLowerCase()).join('_');
+}
+function inferServiceAndOperation(code) {
+    const parts = code.split('_').filter((part) => part.length > 0);
+    const normalizedFirst = normalizeService(parts[0] || '');
+    const service = SERVICE_PREFIXES.find((item) => normalizeService(item) === normalizedFirst);
+    if (!service) {
+        return { operation: toOperation(parts) };
+    }
+    return {
+        service,
+        operation: toOperation(parts.slice(1)),
+    };
+}
+function isRetryable(code, status) {
+    if (typeof status === 'number') {
+        return status >= 500 || status === 408 || status === 429;
+    }
+    const normalized = code.toUpperCase();
+    return normalized.includes('TIMEOUT') || normalized.includes('FAILED');
+}
+function buildHint(retryable) {
+    return retryable
+        ? '일시적인 외부 서비스 오류일 수 있습니다. 잠시 후 다시 시도하세요.'
+        : '입력값 또는 요청 조건을 확인하세요.';
+}
+export function toStandardErrorDiagnostics(code, message, options = {}) {
+    const inferred = inferServiceAndOperation(code);
+    const retryable = isRetryable(code, options.status || options.upstreamStatus);
+    return {
+        code,
+        message,
+        status: options.status,
+        retryable,
+        service: options.service || inferred.service,
+        operation: options.operation || inferred.operation,
+        upstreamStatus: options.upstreamStatus,
+        hint: buildHint(retryable),
+    };
+}
+export function getErrorMessage(error) {
+    return error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+}