daiso 1.0.2 → 1.0.4

package/README.md

@@ -41,6 +41,7 @@ CLI (npx):
 
 ```bash
 npx daiso help
+npx daiso help products
 npx daiso url
 npx daiso health
 npx daiso claude
@@ -51,6 +52,9 @@ npx daiso product 1034604
 npx daiso stores 강남역
 npx daiso inventory 1034604 --keyword 강남역
 npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056
+
+# 원본 JSON 필요 시
+npx daiso products 수납박스 --json
 ```
 
 <br>

package/dist/cli.js

@@ -8,6 +8,8 @@ import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
+import { printCommandHelp, printHelp } from './cliHelp.js';
+import { renderApiEnvelope } from './cliRenderer.js';
 const DEFAULT_BASE_URL = 'https://mcp.aka.page';
 const DEFAULT_MCP_URL = `${DEFAULT_BASE_URL}/mcp`;
 function loadVersion() {
@@ -20,34 +22,6 @@ function loadVersion() {
     const parsed = JSON.parse(raw);
     return parsed.version ?? '0.0.0';
 }
-function printHelp(writeOut) {
-    writeOut('daiso CLI');
-    writeOut('');
-    writeOut('사용법:');
-    writeOut('  daiso <command> [options]');
-    writeOut('');
-    writeOut('명령어:');
-    writeOut('  help                 도움말 출력');
-    writeOut('  version              CLI 버전 출력');
-    writeOut('  url                  MCP 엔드포인트 URL 출력');
-    writeOut('  health               원격 서버 상태 확인');
-    writeOut('  claude               Claude Code MCP 등록 명령 출력');
-    writeOut('  claude --exec        Claude Code MCP 등록 명령 실행');
-    writeOut('  get                  임의 API 경로 GET 호출');
-    writeOut('  products             다이소 제품 검색');
-    writeOut('  product              다이소 제품 상세 조회');
-    writeOut('  stores               다이소 매장 검색');
-    writeOut('  inventory            다이소 재고 조회');
-    writeOut('');
-    writeOut('예시:');
-    writeOut('  npx daiso url');
-    writeOut('  npx daiso health');
-    writeOut('  npx daiso claude');
-    writeOut('  npx daiso products 수납박스');
-    writeOut('  npx daiso stores 강남역');
-    writeOut('  npx daiso inventory 1034604 --keyword 강남역');
-    writeOut('  npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056');
-}
 async function execCommand(command, args) {
     return await new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -116,7 +90,17 @@ function applyOptionsToQuery(url, options) {
         url.searchParams.set(key, value);
     }
 }
-async function requestAndPrintJson(fetchImpl, writeOut, writeErr, url) {
+function toQueryOptions(options) {
+    const queryOptions = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (key === 'help' || key === 'json') {
+            continue;
+        }
+        queryOptions[key] = value;
+    }
+    return queryOptions;
+}
+async function requestAndPrintResponse(fetchImpl, writeOut, writeErr, url, command, asJson) {
     try {
         const response = await fetchImpl(url.toString());
         if (!response.ok) {
@@ -128,7 +112,12 @@ async function requestAndPrintJson(fetchImpl, writeOut, writeErr, url) {
             return 1;
         }
         const payload = (await response.json());
-        writeOut(JSON.stringify(payload, null, 2));
+        if (asJson) {
+            writeOut(JSON.stringify(payload, null, 2));
+        }
+        else {
+            writeOut(renderApiEnvelope(command, url, payload));
+        }
         return 0;
     }
     catch (error) {
@@ -144,6 +133,10 @@ export async function runCli(argv, deps) {
     };
     const [command, ...options] = argv;
     if (!command || command === 'help' || command === '--help' || command === '-h') {
+        const maybeCommand = options[0];
+        if (maybeCommand) {
+            return printCommandHelp(maybeCommand, resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         printHelp(resolvedDeps.writeOut);
         return 0;
     }
@@ -193,17 +186,23 @@ export async function runCli(argv, deps) {
     }
     if (command === 'get') {
         const parsed = parseCliArgs(options);
+        if (parsed.options.help === 'true') {
+            return printCommandHelp('get', resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         const targetPath = parsed.positionals[0];
         if (!targetPath) {
             resolvedDeps.writeErr('get 명령은 경로가 필요합니다. 예: daiso get /api/daiso/products --q 수납박스');
             return 1;
         }
         const targetUrl = toUrl(targetPath);
-        applyOptionsToQuery(targetUrl, parsed.options);
-        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
     }
     if (command === 'products') {
         const parsed = parseCliArgs(options);
+        if (parsed.options.help === 'true') {
+            return printCommandHelp('products', resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         const query = parsed.positionals[0];
         if (!query) {
             resolvedDeps.writeErr('products 명령은 검색어가 필요합니다. 예: daiso products 수납박스');
@@ -211,22 +210,28 @@ export async function runCli(argv, deps) {
         }
         const targetUrl = toUrl('/api/daiso/products');
         targetUrl.searchParams.set('q', query);
-        applyOptionsToQuery(targetUrl, parsed.options);
-        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
     }
     if (command === 'product') {
         const parsed = parseCliArgs(options);
+        if (parsed.options.help === 'true') {
+            return printCommandHelp('product', resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         const productId = parsed.positionals[0];
         if (!productId) {
             resolvedDeps.writeErr('product 명령은 제품 ID가 필요합니다. 예: daiso product 1034604');
             return 1;
         }
         const targetUrl = toUrl(`/api/daiso/products/${productId}`);
-        applyOptionsToQuery(targetUrl, parsed.options);
-        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
     }
     if (command === 'stores') {
         const parsed = parseCliArgs(options);
+        if (parsed.options.help === 'true') {
+            return printCommandHelp('stores', resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         const keyword = parsed.positionals[0];
         if (keyword) {
             parsed.options.keyword = keyword;
@@ -236,11 +241,14 @@ export async function runCli(argv, deps) {
             return 1;
         }
         const targetUrl = toUrl('/api/daiso/stores');
-        applyOptionsToQuery(targetUrl, parsed.options);
-        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
     }
     if (command === 'inventory') {
         const parsed = parseCliArgs(options);
+        if (parsed.options.help === 'true') {
+            return printCommandHelp('inventory', resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         const productId = parsed.positionals[0];
         if (!productId) {
             resolvedDeps.writeErr('inventory 명령은 제품 ID가 필요합니다. 예: daiso inventory 1034604 --keyword 강남역');
@@ -248,8 +256,8 @@ export async function runCli(argv, deps) {
         }
         const targetUrl = toUrl('/api/daiso/inventory');
         targetUrl.searchParams.set('productId', productId);
-        applyOptionsToQuery(targetUrl, parsed.options);
-        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
     }
     resolvedDeps.writeErr(`알 수 없는 명령어: ${command}`);
     resolvedDeps.writeErr('도움말: daiso help');

package/dist/cliHelp.js

@@ -0,0 +1,135 @@
+/**
+ * CLI 도움말 정의
+ */
+export const COMMAND_LIST = [
+    'help',
+    'version',
+    'url',
+    'health',
+    'claude',
+    'get',
+    'products',
+    'product',
+    'stores',
+    'inventory',
+];
+const COMMAND_SUMMARY = {
+    help: '도움말 출력',
+    version: 'CLI 버전 출력',
+    url: 'MCP 엔드포인트 URL 출력',
+    health: '원격 서버 상태 확인',
+    claude: 'Claude Code MCP 등록 명령 출력/실행',
+    get: '임의 API 경로 GET 호출',
+    products: '다이소 제품 검색',
+    product: '다이소 제품 상세 조회',
+    stores: '다이소 매장 검색',
+    inventory: '다이소 재고 조회',
+};
+const COMMAND_DETAIL = {
+    help: [
+        '명령: help',
+        '설명: 전체 도움말 또는 특정 명령 상세 도움말을 출력합니다.',
+        '사용법: daiso help [command]',
+        '예시: daiso help products',
+    ],
+    version: [
+        '명령: version',
+        '설명: 설치된 daiso CLI 버전을 출력합니다.',
+        '사용법: daiso version',
+    ],
+    url: [
+        '명령: url',
+        '설명: MCP 엔드포인트 URL을 출력합니다.',
+        '사용법: daiso url',
+        '출력 예시: https://mcp.aka.page/mcp',
+    ],
+    health: [
+        '명령: health',
+        '설명: 서버 /health API를 호출해 상태를 확인합니다.',
+        '사용법: daiso health',
+        '출력: status, endpoint, checkedAt(JSON)',
+    ],
+    claude: [
+        '명령: claude',
+        '설명: Claude Code MCP 등록 명령을 출력하거나 실행합니다.',
+        '사용법: daiso claude [--exec]',
+        '옵션: --exec 실제 claude 명령 실행',
+        '예시: daiso claude --exec',
+    ],
+    get: [
+        '명령: get',
+        '설명: 임의 API 경로를 GET으로 호출합니다.',
+        '사용법: 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] [--json]',
+        '필수: <query>',
+        '옵션: --page, --pageSize, --json',
+        '예시: daiso products 수납박스 --page 1 --pageSize 30',
+    ],
+    product: [
+        '명령: product',
+        '설명: 다이소 제품 상세 API를 호출합니다.',
+        '사용법: daiso product <productId> [--json]',
+        '필수: <productId>',
+        '옵션: --json',
+        '예시: daiso product 1034604',
+    ],
+    stores: [
+        '명령: stores',
+        '설명: 다이소 매장 검색 API를 호출합니다.',
+        '사용법: daiso stores [keyword] [--sido 값] [--gugun 값] [--dong 값] [--limit N] [--json]',
+        '필수: keyword 또는 --sido',
+        '옵션: --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] [--json]',
+        '필수: <productId>',
+        '옵션: --keyword, --lat, --lng, --page, --pageSize, --json',
+        '예시: daiso inventory 1034604 --keyword 강남역',
+    ],
+};
+export function printHelp(writeOut) {
+    writeOut('daiso CLI');
+    writeOut('');
+    writeOut('사용법:');
+    writeOut('  daiso <command> [options]');
+    writeOut('');
+    writeOut('명령어:');
+    for (const command of COMMAND_LIST) {
+        writeOut(`  ${command.padEnd(20, ' ')}${COMMAND_SUMMARY[command]}`);
+    }
+    writeOut('');
+    writeOut('예시:');
+    writeOut('  npx daiso url');
+    writeOut('  npx daiso health');
+    writeOut('  npx daiso claude');
+    writeOut('  npx daiso products 수납박스');
+    writeOut('  npx daiso stores 강남역');
+    writeOut('  npx daiso inventory 1034604 --keyword 강남역');
+    writeOut('  npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056');
+    writeOut('');
+    writeOut('상세 도움말:');
+    writeOut('  npx daiso help <command>');
+}
+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');
+        return 1;
+    }
+    const detail = COMMAND_DETAIL[command];
+    for (const line of detail) {
+        writeOut(line);
+    }
+    return 0;
+}

package/dist/cliRenderer.js

@@ -0,0 +1,135 @@
+/**
+ * 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 {
+        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');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Daiso MCP Server for mobile access via Cloudflare Workers",
   "main": "dist/index.js",
   "bin": {