daiso 1.0.3 → 1.0.4

package/README.md

@@ -52,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

@@ -9,6 +9,7 @@ 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() {
@@ -89,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) {
@@ -101,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) {
@@ -179,8 +195,8 @@ export async function runCli(argv, deps) {
             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);
@@ -194,8 +210,8 @@ 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);
@@ -208,8 +224,8 @@ export async function runCli(argv, deps) {
             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);
@@ -225,8 +241,8 @@ 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);
@@ -240,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

@@ -59,40 +59,42 @@ 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 강남역',
     ],
 };

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.3",
+  "version": "1.0.4",
   "description": "Daiso MCP Server for mobile access via Cloudflare Workers",
   "main": "dist/index.js",
   "bin": {