daiso 1.0.3 → 1.0.5

package/dist/cliHelp.js

@@ -12,6 +12,24 @@ export const COMMAND_LIST = [
     'product',
     'stores',
     'inventory',
+    'display-location',
+    'cu-stores',
+    'cu-inventory',
+    'lottecinema-theaters',
+    'lottecinema-movies',
+    'lottecinema-seats',
+    'lottemart-stores',
+    'lottemart-products',
+    'emart24-stores',
+    'emart24-products',
+    'emart24-inventory',
+    'gs25-stores',
+    'gs25-products',
+    'gs25-inventory',
+    'seveneleven-products',
+    'seveneleven-stores',
+    'seveneleven-popwords',
+    'seveneleven-catalog',
 ];
 const COMMAND_SUMMARY = {
     help: '도움말 출력',
@@ -24,6 +42,24 @@ const COMMAND_SUMMARY = {
     product: '다이소 제품 상세 조회',
     stores: '다이소 매장 검색',
     inventory: '다이소 재고 조회',
+    'display-location': '다이소 진열 위치 조회',
+    'cu-stores': 'CU 매장 검색',
+    'cu-inventory': 'CU 재고 조회',
+    'lottecinema-theaters': '롯데시네마 주변 지점 조회',
+    'lottecinema-movies': '롯데시네마 영화/회차 조회',
+    'lottecinema-seats': '롯데시네마 잔여 좌석 조회',
+    'lottemart-stores': '롯데마트 매장 검색',
+    'lottemart-products': '롯데마트 상품 검색',
+    'emart24-stores': '이마트24 매장 검색',
+    'emart24-products': '이마트24 상품 검색',
+    'emart24-inventory': '이마트24 재고 조회',
+    'gs25-stores': 'GS25 매장 검색',
+    'gs25-products': 'GS25 상품 검색',
+    'gs25-inventory': 'GS25 재고 조회',
+    'seveneleven-products': '세븐일레븐 상품 검색',
+    'seveneleven-stores': '세븐일레븐 매장 검색',
+    'seveneleven-popwords': '세븐일레븐 인기 검색어 조회',
+    'seveneleven-catalog': '세븐일레븐 카탈로그 스냅샷 조회',
 };
 const COMMAND_DETAIL = {
     help: [
@@ -59,48 +95,201 @@ const COMMAND_DETAIL = {
     get: [
         '명령: get',
         '설명: 임의 API 경로를 GET으로 호출합니다.',
-        '사용법: daiso get <path|url> [--queryKey value ...]',
+        '사용법: daiso get <path|url> [--queryKey value ...] [--json]',
         '필수: <path|url>',
+        '옵션: --json 원본 JSON 출력',
         '예시: daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056',
     ],
     products: [
         '명령: products',
         '설명: 다이소 제품 검색 API를 호출합니다.',
-        '사용법: daiso products <query> [--page N] [--pageSize N]',
+        '사용법: daiso products <query> [--page N] [--pageSize N] [--json]',
         '필수: <query>',
-        '옵션: --page, --pageSize',
+        '옵션: --page, --pageSize, --json',
         '예시: daiso products 수납박스 --page 1 --pageSize 30',
     ],
     product: [
         '명령: product',
         '설명: 다이소 제품 상세 API를 호출합니다.',
-        '사용법: daiso product <productId>',
+        '사용법: daiso product <productId> [--json]',
         '필수: <productId>',
+        '옵션: --json',
         '예시: daiso product 1034604',
     ],
     stores: [
         '명령: stores',
         '설명: 다이소 매장 검색 API를 호출합니다.',
-        '사용법: daiso stores [keyword] [--sido 값] [--gugun 값] [--dong 값] [--limit N]',
+        '사용법: daiso stores [keyword] [--sido 값] [--gugun 값] [--dong 값] [--limit N] [--json]',
         '필수: keyword 또는 --sido',
-        '옵션: --keyword, --sido, --gugun, --dong, --limit',
+        '옵션: --keyword, --sido, --gugun, --dong, --limit, --json',
         '예시: daiso stores 강남역',
         '예시: daiso stores --sido 서울 --gugun 강남구',
     ],
     inventory: [
         '명령: inventory',
         '설명: 다이소 재고 API를 호출합니다.',
-        '사용법: daiso inventory <productId> [--keyword 값] [--lat 값] [--lng 값] [--page N] [--pageSize N]',
+        '사용법: daiso inventory <productId> [--keyword 값] [--lat 값] [--lng 값] [--page N] [--pageSize N] [--json]',
         '필수: <productId>',
-        '옵션: --keyword, --lat, --lng, --page, --pageSize',
+        '옵션: --keyword, --lat, --lng, --page, --pageSize, --json',
         '예시: daiso inventory 1034604 --keyword 강남역',
     ],
+    'display-location': [
+        '명령: display-location',
+        '설명: 다이소 매장 내 상품 진열 위치 API를 호출합니다.',
+        '사용법: daiso display-location <productId> <storeCode> [--json]',
+        '필수: <productId>, <storeCode>',
+        '옵션: --json',
+        '예시: daiso display-location 1034604 04515',
+    ],
+    'cu-stores': [
+        '명령: cu-stores',
+        '설명: CU 매장 검색 API를 호출합니다.',
+        '사용법: daiso cu-stores [keyword] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --limit, --json',
+        '예시: daiso cu-stores 강남',
+        '예시: daiso cu-stores --lat 37.498 --lng 127.027 --limit 10',
+    ],
+    'cu-inventory': [
+        '명령: cu-inventory',
+        '설명: CU 재고 검색 API를 호출합니다.',
+        '사용법: daiso cu-inventory <keyword> [--storeKeyword 값] [--lat 값] [--lng 값] [--size N] [--offset N] [--json]',
+        '필수: <keyword>',
+        '옵션: --storeKeyword, --lat, --lng, --size, --offset, --searchSort, --storeLimit, --json',
+        '예시: daiso cu-inventory 과자',
+        '예시: daiso cu-inventory 컵라면 --storeKeyword 강남 --size 10',
+    ],
+    'lottecinema-theaters': [
+        '명령: lottecinema-theaters',
+        '설명: 롯데시네마 주변 지점 API를 호출합니다.',
+        '사용법: daiso lottecinema-theaters [keyword] [--lat 값] [--lng 값] [--playDate YYYYMMDD] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --playDate, --limit, --json',
+        '예시: daiso lottecinema-theaters 잠실 --limit 5',
+        '예시: daiso lottecinema-theaters --keyword "안산 중앙역" --limit 5',
+    ],
+    'lottecinema-movies': [
+        '명령: lottecinema-movies',
+        '설명: 롯데시네마 영화/회차 API를 호출합니다.',
+        '사용법: daiso lottecinema-movies [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--lat 값] [--lng 값] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --lat, --lng, --json',
+        '예시: daiso lottecinema-movies 잠실 --playDate 20260310',
+        '예시: daiso lottecinema-movies --playDate 20260310 --keyword "안산 중앙역"',
+    ],
+    'lottecinema-seats': [
+        '명령: lottecinema-seats',
+        '설명: 롯데시네마 잔여 좌석 API를 호출합니다.',
+        '사용법: daiso lottecinema-seats [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --lat, --lng, --limit, --json',
+        '예시: daiso lottecinema-seats 잠실 --playDate 20260310 --movieId 23816',
+        '예시: daiso lottecinema-seats --playDate 20260310 --keyword "안산 중앙역" --movieId 23816',
+    ],
+    'lottemart-stores': [
+        '명령: lottemart-stores',
+        '설명: 롯데마트 계열 매장 검색 API를 호출합니다.',
+        '사용법: daiso lottemart-stores [keyword] [--area 값] [--brandVariant 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --area, --brandVariant, --lat, --lng, --limit, --json',
+        '예시: daiso lottemart-stores 잠실 --area 서울',
+        '예시: daiso lottemart-stores --area 경기 --brandVariant lottemart --limit 10',
+    ],
+    'lottemart-products': [
+        '명령: lottemart-products',
+        '설명: 롯데마트 매장 기준 상품 검색 API를 호출합니다.',
+        '사용법: daiso lottemart-products <keyword> [--storeCode 값 | --storeName 값] [--area 값] [--pageLimit N] [--json]',
+        '필수: <keyword>, --storeCode 또는 --storeName',
+        '옵션: --storeCode, --storeName, --area, --pageLimit, --json',
+        '예시: daiso lottemart-products 콜라 --storeName 강변점 --area 서울',
+        '예시: daiso lottemart-products 우유 --storeCode 2301 --pageLimit 2',
+    ],
+    'emart24-stores': [
+        '명령: emart24-stores',
+        '설명: 이마트24 매장 검색 API를 호출합니다.',
+        '사용법: daiso emart24-stores [keyword] [--area1 값] [--area2 값] [--lat 값] [--lng 값] [--service24h true|false] [--limit N] [--json]',
+        '옵션: --keyword, --area1, --area2, --lat, --lng, --service24h, --limit, --json',
+        '예시: daiso emart24-stores 강남',
+        '예시: daiso emart24-stores --area1 서울특별시 --area2 강남구 --service24h true',
+    ],
+    'emart24-products': [
+        '명령: emart24-products',
+        '설명: 이마트24 상품 검색 API를 호출합니다.',
+        '사용법: daiso emart24-products <keyword> [--page N] [--pageSize N] [--sortType 값] [--saleProductYn Y|N] [--json]',
+        '필수: <keyword>',
+        '옵션: --page, --pageSize, --sortType, --saleProductYn, --json',
+        '예시: daiso emart24-products 두바이',
+        '예시: daiso emart24-products 도시락 --page 2 --pageSize 20',
+    ],
+    'emart24-inventory': [
+        '명령: emart24-inventory',
+        '설명: 이마트24 매장별 재고 API를 호출합니다.',
+        '사용법: daiso emart24-inventory <pluCd> --bizNoArr 코드1,코드2 [--json]',
+        '필수: <pluCd>, --bizNoArr',
+        '옵션: --bizNoArr, --json',
+        '예시: daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015,23233',
+    ],
+    'gs25-stores': [
+        '명령: gs25-stores',
+        '설명: GS25 매장 검색 API를 호출합니다.',
+        '사용법: daiso gs25-stores [keyword] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --serviceCode, --limit, --json',
+        '예시: daiso gs25-stores 강남',
+        '예시: daiso gs25-stores --lat 37.4982 --lng 127.0276 --limit 10',
+    ],
+    'gs25-products': [
+        '명령: gs25-products',
+        '설명: GS25 상품 키워드 검색 API를 호출합니다.',
+        '사용법: daiso gs25-products <keyword> [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --serviceCode, --limit, --json',
+        '예시: daiso gs25-products 오감자',
+    ],
+    'gs25-inventory': [
+        '명령: gs25-inventory',
+        '설명: GS25 재고 검색 API를 호출합니다.',
+        '사용법: daiso gs25-inventory <keyword> [--storeKeyword 값] [--lat 값] [--lng 값] [--storeLimit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --storeKeyword, --lat, --lng, --serviceCode, --storeLimit, --json',
+        '예시: daiso gs25-inventory 오감자 --storeKeyword 강남',
+    ],
+    'seveneleven-products': [
+        '명령: seveneleven-products',
+        '설명: 세븐일레븐 상품 검색 API를 호출합니다.',
+        '사용법: daiso seveneleven-products <query> [--page N] [--size N] [--sort 값] [--json]',
+        '필수: <query>',
+        '옵션: --page, --size, --sort, --json',
+        '예시: daiso seveneleven-products 삼각김밥 --size 20',
+    ],
+    'seveneleven-stores': [
+        '명령: seveneleven-stores',
+        '설명: 세븐일레븐 매장 검색 API를 호출합니다.',
+        '사용법: daiso seveneleven-stores <keyword> [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --limit, --json',
+        '예시: daiso seveneleven-stores 안산 중앙역 --limit 10',
+    ],
+    'seveneleven-popwords': [
+        '명령: seveneleven-popwords',
+        '설명: 세븐일레븐 인기 검색어 API를 호출합니다.',
+        '사용법: daiso seveneleven-popwords [--label 값] [--json]',
+        '옵션: --label, --json',
+        '예시: daiso seveneleven-popwords --label home',
+    ],
+    'seveneleven-catalog': [
+        '명령: seveneleven-catalog',
+        '설명: 세븐일레븐 카탈로그 스냅샷 API를 호출합니다.',
+        '사용법: daiso seveneleven-catalog [--includeIssues true|false] [--includeExhibition true|false] [--limit N] [--json]',
+        '옵션: --includeIssues, --includeExhibition, --limit, --json',
+        '예시: daiso seveneleven-catalog --includeIssues true --includeExhibition true --limit 10',
+    ],
 };
 export function printHelp(writeOut) {
     writeOut('daiso CLI');
     writeOut('');
+    writeOut('기본 실행:');
+    writeOut('  npx daiso (인터랙티브 모드)');
+    writeOut('  npx daiso --non-interactive (도움말 출력)');
+    writeOut('');
     writeOut('사용법:');
     writeOut('  daiso <command> [options]');
+    writeOut('전역 옵션:');
+    writeOut('  --non-interactive  인터랙티브 진입 비활성화');
     writeOut('');
     writeOut('명령어:');
     for (const command of COMMAND_LIST) {
@@ -114,6 +303,24 @@ export function printHelp(writeOut) {
     writeOut('  npx daiso products 수납박스');
     writeOut('  npx daiso stores 강남역');
     writeOut('  npx daiso inventory 1034604 --keyword 강남역');
+    writeOut('  npx daiso display-location 1034604 04515');
+    writeOut('  npx daiso cu-stores 강남');
+    writeOut('  npx daiso cu-inventory 과자 --storeKeyword 강남');
+    writeOut('  npx daiso lottecinema-theaters --keyword "안산 중앙역" --limit 5');
+    writeOut('  npx daiso lottecinema-movies --playDate 20260310 --keyword "안산 중앙역"');
+    writeOut('  npx daiso lottecinema-seats --playDate 20260310 --keyword "안산 중앙역" --movieId 23816');
+    writeOut('  npx daiso lottemart-stores 잠실 --area 서울 --limit 10');
+    writeOut('  npx daiso lottemart-products 콜라 --storeName 강변점 --area 서울');
+    writeOut('  npx daiso emart24-stores 강남 --limit 10');
+    writeOut('  npx daiso emart24-products 두바이 --pageSize 20');
+    writeOut('  npx daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015');
+    writeOut('  npx daiso gs25-stores 강남 --limit 10');
+    writeOut('  npx daiso gs25-products 오감자');
+    writeOut('  npx daiso gs25-inventory 오감자 --storeKeyword 강남');
+    writeOut('  npx daiso seveneleven-products 삼각김밥 --size 20');
+    writeOut('  npx daiso seveneleven-stores 안산 중앙역 --limit 10');
+    writeOut('  npx daiso seveneleven-popwords --label home');
+    writeOut('  npx daiso seveneleven-catalog --limit 10');
     writeOut('  npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056');
     writeOut('');
     writeOut('상세 도움말:');
@@ -122,7 +329,7 @@ export function printHelp(writeOut) {
 export function printCommandHelp(command, writeOut, writeErr) {
     if (!Object.hasOwn(COMMAND_DETAIL, command)) {
         writeErr(`도움말을 찾을 수 없는 명령어: ${command}`);
-        writeErr('사용 가능한 명령어: help, version, url, health, claude, get, products, product, stores, inventory');
+        writeErr('사용 가능한 명령어: help, version, url, health, claude, get, products, product, stores, inventory, display-location, cu-stores, cu-inventory, lottecinema-theaters, lottecinema-movies, lottecinema-seats, lottemart-stores, lottemart-products, emart24-stores, emart24-products, emart24-inventory, gs25-stores, gs25-products, gs25-inventory, seveneleven-products, seveneleven-stores, seveneleven-popwords, seveneleven-catalog');
         return 1;
     }
     const detail = COMMAND_DETAIL[command];

package/dist/cliInteractive.js

@@ -0,0 +1,174 @@
+/**
+ * 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 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,
+    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 askMenu(prompt, '서비스 번호를 선택하세요 (0: 종료):', [
+                '다이소',
+                '올리브영',
+                'CU',
+                '롯데시네마',
+            ]);
+            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,56 @@
+/**
+ * 인터랙티브 목록 선택 유틸리티
+ *
+ * 번호 선택, /키워드 필터, 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) {
+            continue;
+        }
+        return visibleItems[picked - 1];
+    }
+}

package/dist/cliRenderer.js

@@ -0,0 +1,139 @@
+/**
+ * CLI 응답 렌더러
+ */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function toText(value) {
+    if (value === null || value === undefined) {
+        return '-';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+function formatMeta(meta) {
+    if (!isRecord(meta)) {
+        return [];
+    }
+    const pairs = Object.entries(meta)
+        .filter(([, value]) => typeof value === 'string' || typeof value === 'number')
+        .map(([key, value]) => `${key}=${value}`);
+    if (pairs.length === 0) {
+        return [];
+    }
+    return [`메타: ${pairs.join(', ')}`];
+}
+function detectName(item) {
+    const keys = ['name', 'productName', 'storeName', 'theaterName', 'movieName'];
+    for (const key of keys) {
+        if (typeof item[key] === 'string' && item[key].trim().length > 0) {
+            return item[key];
+        }
+    }
+    return '이름 없음';
+}
+function formatCollection(title, items) {
+    if (!Array.isArray(items)) {
+        return [];
+    }
+    const lines = [`${title}: ${items.length}건`];
+    const preview = items.slice(0, 5);
+    for (const entry of preview) {
+        if (!isRecord(entry)) {
+            lines.push(`- ${toText(entry)}`);
+            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;
+        let detail = `- ${name}`;
+        if (id !== undefined) {
+            detail += ` [${toText(id)}]`;
+        }
+        if (price !== undefined) {
+            detail += ` / ${toText(price)}원`;
+        }
+        lines.push(detail);
+    }
+    if (items.length > preview.length) {
+        lines.push(`...외 ${items.length - preview.length}건`);
+    }
+    return lines;
+}
+function formatProductDetail(data) {
+    const id = data.id ?? data.productId ?? '-';
+    const name = data.name ?? data.productName ?? '-';
+    const price = data.price ?? '-';
+    const soldOut = data.soldOut;
+    const lines = [`제품 상세: ${toText(name)} (${toText(id)})`, `가격: ${toText(price)}원`];
+    if (typeof soldOut === 'boolean') {
+        lines.push(`품절 여부: ${soldOut ? '품절' : '재고 있음'}`);
+    }
+    return lines;
+}
+function formatInventory(data) {
+    const lines = [];
+    const onlineStock = data.onlineStock;
+    if (onlineStock !== undefined) {
+        lines.push(`온라인 재고: ${toText(onlineStock)}`);
+    }
+    const storeInventory = data.storeInventory;
+    if (isRecord(storeInventory)) {
+        const total = storeInventory.totalStores;
+        const inStock = storeInventory.inStockCount;
+        lines.push(`매장 재고: 재고보유 ${toText(inStock)} / 전체 ${toText(total)}`);
+        lines.push(...formatCollection('매장 목록', storeInventory.stores));
+    }
+    return lines;
+}
+export function renderApiEnvelope(command, url, payload) {
+    if (!isRecord(payload)) {
+        return `요청 성공: ${url.pathname}\n${toText(payload)}\n\n원본 JSON은 --json 옵션으로 확인하세요.`;
+    }
+    const envelope = payload;
+    if (envelope.success !== true) {
+        return JSON.stringify(payload, null, 2);
+    }
+    const lines = [`요청 성공: ${url.pathname}`];
+    lines.push(...formatMeta(envelope.meta));
+    if (!isRecord(envelope.data)) {
+        lines.push(`응답 데이터: ${toText(envelope.data)}`);
+        lines.push('', '원본 JSON은 --json 옵션으로 확인하세요.');
+        return lines.join('\n');
+    }
+    const data = envelope.data;
+    if (command === 'product') {
+        lines.push(...formatProductDetail(data));
+    }
+    else if (command === 'inventory') {
+        lines.push(...formatInventory(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 {
+        lines.push(...formatCollection('제품 목록', data.products));
+        lines.push(...formatCollection('매장 목록', data.stores));
+        lines.push(...formatCollection('극장 목록', data.theaters));
+        lines.push(...formatCollection('영화 목록', data.movies));
+        lines.push(...formatCollection('시간표', data.timetable));
+        lines.push(...formatCollection('좌석 목록', data.seats));
+        lines.push(...formatCollection('상영 목록', data.showtimes));
+        if (lines.length <= 2) {
+            const summaryEntries = Object.entries(data)
+                .filter(([, value]) => typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
+                .slice(0, 8);
+            for (const [key, value] of summaryEntries) {
+                lines.push(`${key}: ${toText(value)}`);
+            }
+        }
+    }
+    lines.push('', '원본 JSON은 --json 옵션으로 확인하세요.');
+    return lines.join('\n');
+}