daiso 1.0.9 → 1.1.0

package/dist/services/seveneleven/tools/getSearchPopwords.js

@@ -3,10 +3,11 @@
  */
 import * as z from 'zod';
 import { fetchSevenElevenSearchPopwords } from '../client.js';
-async function getSearchPopwords(args) {
+async function getSearchPopwords(args, zyteApiKey) {
     const { label = 'home', timeoutMs = 15000 } = args;
     const keywords = await fetchSevenElevenSearchPopwords(label, {
         timeout: timeoutMs,
+        zyteApiKey,
     });
     return {
         content: [
@@ -25,7 +26,7 @@ async function getSearchPopwords(args) {
         ],
     };
 }
-export function createGetSearchPopwordsTool() {
+export function createGetSearchPopwordsTool(zyteApiKey) {
     return {
         name: 'seveneleven_get_search_popwords',
         metadata: {
@@ -36,6 +37,6 @@ export function createGetSearchPopwordsTool() {
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: getSearchPopwords,
+        handler: (args) => getSearchPopwords(args, zyteApiKey),
     };
 }

package/dist/services/seveneleven/tools/searchProducts.js

@@ -9,28 +9,46 @@ function buildTextResponse(payload) {
         structuredContent: payload,
     };
 }
-async function searchProducts(args) {
+async function searchProducts(args, zyteApiKey) {
     const { query, page = 1, size = 20, sort = 'recommend', timeoutMs = 15000 } = args;
     if (!query || query.trim().length === 0) {
         throw new Error('상품 검색어(query)를 입력해주세요.');
     }
-    const result = await searchSevenElevenProductsWithVariants(query, {
-        page,
-        size,
-        sort,
-        timeout: timeoutMs,
-    });
-    return buildTextResponse({
-        query: result.query,
-        page,
-        size,
-        sort,
-        totalCount: result.totalCount,
-        count: result.products.length,
-        collectionIds: result.collectionIds,
-        appliedQueries: result.appliedQueries,
-        products: result.products,
-    });
+    try {
+        const result = await searchSevenElevenProductsWithVariants(query, {
+            page,
+            size,
+            sort,
+            timeout: timeoutMs,
+            zyteApiKey,
+        });
+        return buildTextResponse({
+            query: result.query,
+            page,
+            size,
+            sort,
+            totalCount: result.totalCount,
+            count: result.products.length,
+            collectionIds: result.collectionIds,
+            appliedQueries: result.appliedQueries,
+            products: result.products,
+        });
+    }
+    catch (error) {
+        return buildTextResponse({
+            query,
+            page,
+            size,
+            sort,
+            totalCount: 0,
+            count: 0,
+            collectionIds: [],
+            appliedQueries: [query],
+            products: [],
+            status: 'degraded',
+            message: error instanceof Error ? error.message : '세븐일레븐 상품 검색에 실패했습니다.',
+        });
+    }
 }
 const searchProductsOutputSchema = {
     query: z.string().describe('적용된 검색어'),
@@ -42,8 +60,10 @@ const searchProductsOutputSchema = {
     collectionIds: z.array(z.string()).describe('검색 컬렉션 ID 목록'),
     appliedQueries: z.array(z.string()).describe('실제로 시도한 검색어 목록'),
     products: z.array(z.unknown()).describe('세븐일레븐 상품 검색 결과'),
+    status: z.string().optional().describe('외부 API 차단 등으로 결과가 제한된 경우 degraded'),
+    message: z.string().optional().describe('degraded 상태의 원인 메시지'),
 };
-export function createSearchProductsTool() {
+export function createSearchProductsTool(zyteApiKey) {
     return {
         name: 'seveneleven_search_products',
         metadata: {
@@ -62,6 +82,6 @@ export function createSearchProductsTool() {
             },
             outputSchema: searchProductsOutputSchema,
         },
-        handler: searchProducts,
+        handler: (args) => searchProducts(args, zyteApiKey),
     };
 }

package/dist/services/seveneleven/tools/searchStores.js

@@ -3,7 +3,7 @@
  */
 import * as z from 'zod';
 import { fetchSevenElevenStoresByKeyword } from '../client.js';
-async function searchStores(args) {
+async function searchStores(args, zyteApiKey) {
     const { keyword, limit = 20, timeoutMs = 15000 } = args;
     if (!keyword || keyword.trim().length === 0) {
         throw new Error('매장 검색어(keyword)를 입력해주세요.');
@@ -13,6 +13,7 @@ async function searchStores(args) {
         limit,
     }, {
         timeout: timeoutMs,
+        zyteApiKey,
     });
     return {
         content: [
@@ -28,7 +29,7 @@ async function searchStores(args) {
         ],
     };
 }
-export function createSearchStoresTool() {
+export function createSearchStoresTool(zyteApiKey) {
     return {
         name: 'seveneleven_search_stores',
         metadata: {
@@ -40,6 +41,6 @@ export function createSearchStoresTool() {
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: searchStores,
+        handler: (args) => searchStores(args, zyteApiKey),
     };
 }

package/dist/utils/format.js

@@ -24,8 +24,15 @@ export function formatTime(raw) {
     return raw;
 }
 export function toYyyymmdd(value = new Date()) {
-    const year = value.getFullYear();
-    const month = `${value.getMonth() + 1}`.padStart(2, '0');
-    const day = `${value.getDate()}`.padStart(2, '0');
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        timeZone: 'Asia/Seoul',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    }).formatToParts(value);
+    const byType = Object.fromEntries(parts.map((part) => [part.type, part.value]));
+    const year = byType.year;
+    const month = byType.month;
+    const day = byType.day;
     return `${year}${month}${day}`;
 }

package/dist/utils/http.js

@@ -15,6 +15,17 @@ export class HttpError extends Error {
         this.bodyText = bodyText;
     }
 }
+/** HTML 원문을 노출하지 않고 예상하지 못한 응답 형식을 구분합니다. */
+export class UnexpectedHtmlResponseError extends Error {
+    status;
+    contentType;
+    constructor(status, contentType) {
+        super(`JSON 대신 HTML 응답을 받았습니다 (HTTP ${status}).`);
+        this.status = status;
+        this.contentType = contentType;
+        this.name = 'UnexpectedHtmlResponseError';
+    }
+}
 export function createTimeoutController(timeout) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
@@ -54,19 +65,22 @@ function parseRetryAfterDelayMs(response) {
     }
     return null;
 }
-export async function fetchWithTimeout(url, options = {}) {
+async function requestWithTimeout(url, options, readResponse) {
     const { timeout = 10000, retries = 0, retryDelayMs = 250, retryStatusCodes = DEFAULT_RETRY_STATUS_CODES, retryUnsafeMethods = false, retryMethods = DEFAULT_RETRY_METHODS, onRetry, ...restOptions } = options;
     const maxAttempts = Math.max(1, Math.trunc(retries) + 1);
     const method = normalizeMethod(restOptions.method);
     const retryAllowed = canRetryMethod(method, retryMethods, retryUnsafeMethods);
     for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
         const { controller, timeoutId } = createTimeoutController(timeout);
+        let readingResponse = false;
         try {
             const response = await fetch(url, {
                 ...restOptions,
                 signal: controller.signal,
             });
-            if (retryAllowed && attempt < maxAttempts && isRetryableStatus(response.status, retryStatusCodes)) {
+            if (retryAllowed &&
+                attempt < maxAttempts &&
+                isRetryableStatus(response.status, retryStatusCodes)) {
                 const delayMs = parseRetryAfterDelayMs(response) ?? retryDelayMs;
                 onRetry?.({
                     attempt,
@@ -81,10 +95,11 @@ export async function fetchWithTimeout(url, options = {}) {
                 await wait(delayMs);
                 continue;
             }
-            return response;
+            readingResponse = true;
+            return await readResponse(response);
         }
         catch (error) {
-            if (!retryAllowed || attempt >= maxAttempts) {
+            if (readingResponse || !retryAllowed || attempt >= maxAttempts) {
                 throw error;
             }
             onRetry?.({
@@ -105,17 +120,30 @@ export async function fetchWithTimeout(url, options = {}) {
     /* v8 ignore next */
     throw new Error('API 요청 재시도 처리 중 알 수 없는 오류가 발생했습니다.');
 }
+export async function fetchWithTimeout(url, options = {}) {
+    return requestWithTimeout(url, options, async (response) => response);
+}
+async function readTextResponse(url, options) {
+    // 헤더 수신뿐 아니라 본문 읽기에도 같은 요청 제한 시간을 적용합니다.
+    return requestWithTimeout(url, options, async (response) => ({
+        response,
+        body: await response.text(),
+    }));
+}
 export async function fetchJson(url, options = {}) {
-    const response = await fetchWithTimeout(url, options);
+    const { response, body } = await readTextResponse(url, options);
     if (!response.ok) {
-        throw new HttpError(response.status, response.statusText, await response.text());
+        throw new HttpError(response.status, response.statusText, body);
+    }
+    if (/^\s*(?:<!doctype\s+html\b|<html\b)/i.test(body)) {
+        throw new UnexpectedHtmlResponseError(response.status, response.headers.get('content-type') || '');
     }
-    return response.json();
+    return JSON.parse(body);
 }
 export async function fetchText(url, options = {}) {
-    const response = await fetchWithTimeout(url, options);
+    const { response, body } = await readTextResponse(url, options);
     if (!response.ok) {
-        throw new HttpError(response.status, response.statusText, await response.text());
+        throw new HttpError(response.status, response.statusText, body);
     }
-    return response.text();
+    return body;
 }

package/dist/utils/zyte.js

@@ -51,6 +51,16 @@ function isRetryableTargetStatus(statusCode) {
 function isRetryableError(error) {
     return isAbortError(error) || error instanceof RetryableZyteError;
 }
+function parseZyteResponseBody(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {
+            detail: text.trim().replace(/\s+/g, ' ').slice(0, 300),
+        };
+    }
+}
 function wait(ms) {
     if (ms <= 0) {
         return Promise.resolve();
@@ -60,7 +70,7 @@ function wait(ms) {
     });
 }
 export async function requestByZyte(options) {
-    const { timeout = 15000, retries = 1, retryDelayMs = 250, url, method = 'GET', headers = [], bodyText, apiKey, } = options;
+    const { timeout = 15000, retries = 1, retryDelayMs = 250, url, method = 'GET', headers = [], bodyText, apiKey, tags, } = options;
     const auth = encodeBasicAuth(resolveZyteApiKey(apiKey));
     const maxAttempts = Math.max(1, Math.trunc(retries) + 1);
     for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
@@ -81,6 +91,7 @@ export async function requestByZyte(options) {
                         customHttpRequestHeaders: headers,
                         httpRequestText: bodyText,
                         httpResponseBody: true,
+                        ...(tags ? { tags } : {}),
                     }),
                     signal: controller.signal,
                 });
@@ -91,7 +102,7 @@ export async function requestByZyte(options) {
                 }
                 throw error;
             }
-            const result = (await response.json());
+            const result = parseZyteResponseBody(await response.text());
             if (!response.ok) {
                 const message = `Zyte API 호출 실패: ${response.status} ${result.detail || result.title || ''}`.trim();
                 if (isRetryableZyteStatus(response.status)) {

package/dist/utils/zyteJsonFallback.js

@@ -0,0 +1,67 @@
+/**
+ * 차단 응답에만 Zyte를 사용하는 JSON 전송 유틸리티
+ */
+import { fetchJson, HttpError } from './http.js';
+import { decodeZyteHttpBody, requestByZyte, } from './zyte.js';
+const ZYTE_FALLBACK_STATUSES = new Set([400, 403, 429]);
+const ZYTE_METHODS = new Set([
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+]);
+function normalizeMethod(method) {
+    const normalized = (method || 'GET').toUpperCase();
+    if (!ZYTE_METHODS.has(normalized)) {
+        throw new Error(`Zyte에서 지원하지 않는 HTTP 메서드입니다: ${normalized}`);
+    }
+    return normalized;
+}
+function toZyteHeaders(headers) {
+    const normalized = new Headers(headers);
+    const result = [];
+    normalized.forEach((value, name) => {
+        result.push({ name, value });
+    });
+    return result;
+}
+function assertSuccessfulTarget(result) {
+    const status = result.statusCode;
+    if (typeof status !== 'number' || status < 200 || status >= 300) {
+        throw new Error(`Zyte 대상 응답 실패: ${status ?? '알 수 없음'}`);
+    }
+}
+function hasZyteApiKey(apiKey) {
+    if (apiKey?.trim()) {
+        return true;
+    }
+    /* c8 ignore next */
+    return typeof process !== 'undefined' && Boolean(process.env?.ZYTE_API_KEY?.trim());
+}
+export async function fetchJsonWithZyteFallback(url, options = {}) {
+    const { zyteApiKey, zyteTags, ...directOptions } = options;
+    try {
+        return await fetchJson(url, directOptions);
+    }
+    catch (error) {
+        if (!(error instanceof HttpError) || !ZYTE_FALLBACK_STATUSES.has(error.status)) {
+            throw error;
+        }
+        if (!hasZyteApiKey(zyteApiKey)) {
+            throw error;
+        }
+    }
+    const result = await requestByZyte({
+        apiKey: zyteApiKey,
+        url,
+        timeout: directOptions.timeout,
+        retries: 0,
+        method: normalizeMethod(directOptions.method),
+        headers: toZyteHeaders(directOptions.headers),
+        bodyText: typeof directOptions.body === 'string' ? directOptions.body : undefined,
+        tags: zyteTags,
+    });
+    assertSuccessfulTarget(result);
+    return decodeZyteHttpBody(result);
+}

package/openapi.json

@@ -22,6 +22,51 @@
         "summary": "공통 GET 액션 실행",
         "description": "action 값에 따라 기존 GET API 엔드포인트로 프록시합니다. OpenAI Actions 등록 시 이 단일 엔드포인트를 사용하세요.",
         "parameters": [
+          {
+            "name": "cinemaCode",
+            "in": "query",
+            "required": false,
+            "description": "디트릭스 극장 코드",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "brandCode",
+            "in": "query",
+            "required": false,
+            "description": "디트릭스 브랜드 코드",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "region",
+            "in": "query",
+            "required": false,
+            "description": "디트릭스 광역 지역명",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "movieName",
+            "in": "query",
+            "required": false,
+            "description": "디트릭스 영화명 부분 일치",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "includePlayDates",
+            "in": "query",
+            "required": false,
+            "description": "디트릭스 상영 가능 날짜 포함",
+            "schema": {
+              "type": "boolean"
+            }
+          },
           {
             "name": "action",
             "in": "query",
@@ -30,6 +75,9 @@
             "schema": {
               "type": "string",
               "enum": [
+                "dtryxListCinemas",
+                "dtryxListNowShowing",
+                "dtryxGetRemainingSeats",
                 "daisoSearchProducts",
                 "daisoGetProduct",
                 "daisoFindStores",
@@ -551,7 +599,7 @@
             "name": "timeoutMs",
             "in": "query",
             "required": false,
-            "description": "세븐일레븐 inventory 타임아웃",
+            "description": "원본 요청 타임아웃(ms), 디트릭스는 1~60000",
             "schema": {
               "type": "integer"
             }
@@ -2726,11 +2774,11 @@
           },
           "bookedSeats": {
             "type": "integer",
-            "example": 28
+            "example": 4
           },
           "remainingSeats": {
             "type": "integer",
-            "example": 4
+            "example": 28
           }
         }
       },

package/openapi.yaml

@@ -24,6 +24,36 @@ paths:
       summary: 공통 GET 액션 실행
       description: action 값에 따라 기존 GET API 엔드포인트로 프록시합니다. OpenAI Actions 등록 시 이 단일 엔드포인트를 사용하세요.
       parameters:
+        - name: cinemaCode
+          in: query
+          required: false
+          description: 디트릭스 극장 코드
+          schema:
+            type: string
+        - name: brandCode
+          in: query
+          required: false
+          description: 디트릭스 브랜드 코드
+          schema:
+            type: string
+        - name: region
+          in: query
+          required: false
+          description: 디트릭스 광역 지역명
+          schema:
+            type: string
+        - name: movieName
+          in: query
+          required: false
+          description: 디트릭스 영화명 부분 일치
+          schema:
+            type: string
+        - name: includePlayDates
+          in: query
+          required: false
+          description: 디트릭스 상영 가능 날짜 포함
+          schema:
+            type: boolean
         - name: action
           in: query
           required: true
@@ -31,6 +61,9 @@ paths:
           schema:
             type: string
             enum:
+              - dtryxListCinemas
+              - dtryxListNowShowing
+              - dtryxGetRemainingSeats
               - daisoSearchProducts
               - daisoGetProduct
               - daisoFindStores
@@ -389,7 +422,7 @@ paths:
         - name: timeoutMs
           in: query
           required: false
-          description: 세븐일레븐 inventory 타임아웃
+          description: 원본 요청 타임아웃(ms), 디트릭스는 1~60000
           schema:
             type: integer
       responses:
@@ -1920,10 +1953,10 @@ components:
           example: 32
         bookedSeats:
           type: integer
-          example: 28
+          example: 4
         remainingSeats:
           type: integer
-          example: 4
+          example: 28
     LotteCinemaTheaterSearchResponse:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "Korean retail and cinema MCP server, CLI, and Codex Skill for Daiso, convenience stores, marts, Olive Young, and theaters",
   "main": "dist/index.js",
   "bin": {
@@ -31,6 +31,7 @@
     "release:dry-run": "npm pack --dry-run",
     "publish:public": "npm publish --access public",
     "typecheck": "tsc --noEmit",
+    "check:source-lines": "npx tsx scripts/quality/check-source-line-limit.ts",
     "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" \"scripts/**/*.ts\" \"vitest.config.ts\"",
     "lint:fix": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" \"scripts/**/*.ts\" \"vitest.config.ts\" --fix",
     "format": "prettier .github/**/*.md .github/**/*.yml README.md SECURITY.md AGENTS.md CONTRIBUTING.md package.json tsconfig.json .prettierrc.json .mcp.json eslint.config.ts --write",
@@ -39,7 +40,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "check": "npm run format:check && npm run lint && npm run lint:biome && npm run typecheck && npm test",
+    "check": "npm run format:check && npm run lint && npm run lint:biome && npm run typecheck && npm run check:source-lines && npm test",
     "lint:biome": "biome lint"
   },
   "keywords": [
@@ -76,37 +77,40 @@
     "url": "https://github.com/hmmhmmhm/daiso-mcp/issues"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.15",
-    "@cloudflare/workers-types": "^4.20260526.1",
+    "@biomejs/biome": "^2.5.13",
+    "@cloudflare/workers-types": "^5.20260914.1",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.9.1",
-    "@vitest/coverage-v8": "^4.1.7",
-    "eslint": "^10.4.0",
+    "@types/node": "^26.5.1",
+    "@vitest/coverage-v8": "^4.1.11",
+    "eslint": "^10.8.0",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^17.4.0",
+    "globals": "^17.12.0",
     "jiti": "^2.7.0",
-    "playwright": "^1.60.0",
-    "prettier": "^3.8.3",
-    "sharp": "^0.34.5",
-    "tsx": "^4.22.3",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.0",
-    "vitest": "^4.1.7",
-    "wrangler": "^4.95.0"
+    "playwright": "^1.63.0",
+    "prettier": "^3.9.6",
+    "sharp": "^0.35.4",
+    "tsx": "^4.23.1",
+    "typescript": "6.0.3",
+    "typescript-eslint": "^8.65.0",
+    "vitest": "^4.1.11",
+    "wrangler": "^4.131.2"
   },
   "overrides": {
-    "flatted": "3.4.2",
-    "undici": "7.24.0",
-    "brace-expansion": "5.0.6",
-    "ws": "8.20.1"
+    "@modelcontextprotocol/sdk": {
+      "@hono/node-server": "2.0.11"
+    },
+    "miniflare": {
+      "sharp": "0.35.4",
+      "undici": "7.29.1"
+    }
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "hono": "^4.12.23",
-    "proj4": "^2.20.8",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "hono": "^4.13.7",
+    "proj4": "^2.22.0",
     "workers-mcp": "^0.0.13"
   }
 }