daiso 1.0.5 → 1.0.7

package/dist/api/healthChecks.js

@@ -2,8 +2,15 @@
  * 개별 서비스 헬스 체크 실행기
  */
 const HEALTH_CHECK_CACHE_TTL_MS = 60_000;
-const DEFAULT_HEALTH_CHECK_TIMEOUT_MS = 3000;
-const MAX_HEALTH_CHECK_TIMEOUT_MS = 10_000;
+const DEFAULT_HEALTH_CHECK_TIMEOUT_MS = 7000;
+const MAX_HEALTH_CHECK_TIMEOUT_MS = 20_000;
+const DEFAULT_HEALTH_CHECK_CONCURRENCY = 1;
+const DEFAULT_HEALTH_CHECK_SLOW_THRESHOLD_MS = 0;
+const GS25_CLOUDFRONT_403_PATTERNS = [
+    '403 Forbidden',
+    'The request could not be satisfied',
+    '403 ERROR',
+];
 const HEALTH_CHECKS = [
     {
         id: 'cli.contract',
@@ -19,6 +26,8 @@ const HEALTH_CHECKS = [
         target: 'products',
         mode: 'quick',
         path: '/api/daiso/products?q=%ED%85%8C%EC%9D%B4%ED%94%84&pageSize=1',
+        collectionKey: 'products',
+        requiredFields: ['id', 'name', 'productName', 'itemName', 'goodsName'],
     },
     {
         id: 'cu.stores',
@@ -26,6 +35,8 @@ const HEALTH_CHECKS = [
         target: 'stores',
         mode: 'quick',
         path: '/api/cu/stores?keyword=%EA%B0%95%EB%82%A8&limit=1',
+        collectionKey: 'stores',
+        requiredFields: ['storeCode', 'storeName', 'name'],
     },
     {
         id: 'emart24.products',
@@ -33,6 +44,8 @@ const HEALTH_CHECKS = [
         target: 'products',
         mode: 'quick',
         path: '/api/emart24/products?keyword=%EC%BB%A4%ED%94%BC&pageSize=1',
+        collectionKey: 'products',
+        requiredFields: ['pluCd', 'goodsName', 'itemName', 'name'],
     },
     {
         id: 'gs25.products',
@@ -40,6 +53,9 @@ const HEALTH_CHECKS = [
         target: 'products',
         mode: 'quick',
         path: '/api/gs25/products?keyword=%EC%BD%9C%EB%9D%BC&limit=1',
+        collectionKey: 'products',
+        requiredFields: ['itemCode', 'itemName', 'name'],
+        degradedFailurePatterns: GS25_CLOUDFRONT_403_PATTERNS,
     },
     {
         id: 'gs25.stores',
@@ -47,6 +63,8 @@ const HEALTH_CHECKS = [
         target: 'stores',
         mode: 'quick',
         path: '/api/gs25/stores?keyword=%EA%B0%95%EB%82%A8&limit=1',
+        collectionKey: 'stores',
+        requiredFields: ['storeCode', 'storeName', 'name'],
     },
     {
         id: 'seveneleven.products',
@@ -54,20 +72,27 @@ const HEALTH_CHECKS = [
         target: 'products',
         mode: 'quick',
         path: '/api/seveneleven/products?query=%EC%BB%A4%ED%94%BC&size=1',
+        collectionKey: 'products',
+        requiredFields: ['itemCode', 'itemName', 'productNo', 'name'],
     },
     {
         id: 'lottemart.products',
         service: 'lottemart',
         target: 'products',
         mode: 'quick',
-        path: '/api/lottemart/products?keyword=%EC%BD%9C%EB%9D%BC&storeCode=2301&area=%EC%84%9C%EC%9A%B8&pageLimit=1',
+        path: '/api/lottemart/products?keyword=%EC%BD%9C%EB%9D%BC&storeCode=2301&area=%EC%84%9C%EC%9A%B8&pageLimit=1&source=zetta',
+        collectionKey: 'products',
+        requiredFields: ['productCode', 'name', 'productName'],
     },
     {
         id: 'oliveyoung.products',
         service: 'oliveyoung',
         target: 'products',
         mode: 'quick',
-        path: '/api/oliveyoung/products?keyword=%EC%84%A0%ED%81%AC%EB%A6%BC&size=1',
+        path: '/api/oliveyoung/products?keyword=%EB%A6%BD%EB%B0%A4&size=1',
+        collectionKey: 'products',
+        requiredFields: ['goodsNumber', 'goodsName', 'productNo', 'productName', 'name'],
+        timeoutMs: 5000,
     },
     {
         id: 'megabox.theaters',
@@ -75,6 +100,8 @@ const HEALTH_CHECKS = [
         target: 'theaters',
         mode: 'quick',
         path: '/api/megabox/theaters?keyword=%EA%B0%95%EB%82%A8&limit=1',
+        collectionKey: 'theaters',
+        requiredFields: ['theaterCode', 'theaterName', 'name'],
     },
     {
         id: 'lottecinema.theaters',
@@ -82,6 +109,8 @@ const HEALTH_CHECKS = [
         target: 'theaters',
         mode: 'quick',
         path: '/api/lottecinema/theaters?keyword=%EC%9E%A0%EC%8B%A4&limit=1',
+        collectionKey: 'theaters',
+        requiredFields: ['theaterCode', 'theaterName', 'name'],
     },
     {
         id: 'cgv.theaters',
@@ -89,6 +118,59 @@ const HEALTH_CHECKS = [
         target: 'theaters',
         mode: 'quick',
         path: '/api/cgv/theaters?keyword=%EA%B0%95%EB%82%A8&limit=1',
+        collectionKey: 'theaters',
+        requiredFields: ['theaterCode', 'theaterName', 'name'],
+    },
+    {
+        id: 'cu.inventory',
+        service: 'cu',
+        target: 'inventory',
+        mode: 'deep',
+        path: '/api/cu/inventory?keyword=%EC%BB%A4%ED%94%BC&size=1&storeLimit=0&storeCheck=false',
+        collectionKey: 'inventoryItems',
+        requiredFields: ['itemCode', 'itemName', 'name'],
+    },
+    {
+        id: 'emart24.inventory',
+        service: 'emart24',
+        target: 'inventory',
+        mode: 'deep',
+        path: '/api/emart24/inventory?keyword=%EC%BB%A4%ED%94%BC&storeKeyword=%EA%B0%95%EB%82%A8&limit=1',
+        collectionKey: 'inventoryItems',
+        requiredFields: ['pluCd', 'goodsName', 'itemName', 'name'],
+    },
+    {
+        id: 'gs25.inventory',
+        service: 'gs25',
+        target: 'inventory',
+        mode: 'deep',
+        path: '/api/gs25/inventory?keyword=%EC%BD%9C%EB%9D%BC&storeKeyword=%EA%B0%95%EB%82%A8&limit=1',
+        collectionKey: 'inventoryItems',
+        requiredFields: ['itemCode', 'itemName', 'name'],
+        degradedFailurePatterns: [
+            '401 Unauthorized',
+            '인증키가 제공되지 않음',
+            ...GS25_CLOUDFRONT_403_PATTERNS,
+        ],
+    },
+    {
+        id: 'seveneleven.inventory',
+        service: 'seveneleven',
+        target: 'inventory',
+        mode: 'deep',
+        path: '/api/seveneleven/inventory?keyword=%EC%BB%A4%ED%94%BC&storeKeyword=%EA%B0%95%EB%82%A8&size=1',
+        collectionKey: 'inventoryItems',
+        requiredFields: ['itemCode', 'itemName', 'productNo', 'name'],
+    },
+    {
+        id: 'oliveyoung.inventory',
+        service: 'oliveyoung',
+        target: 'inventory',
+        mode: 'deep',
+        path: '/api/oliveyoung/inventory?keyword=%EC%84%A0%ED%81%AC%EB%A6%BC&storeKeyword=%EB%AA%85%EB%8F%99&size=1&storeLimit=1&stockCheckLimit=0',
+        collectionKey: 'inventoryProducts',
+        requiredFields: ['goodsNumber', 'goodsName', 'productNo', 'productName', 'name'],
+        timeoutMs: 5000,
     },
 ];
 const healthCheckCache = new Map();
@@ -105,13 +187,15 @@ function createCacheKey(params) {
         params.check || '',
         params.mode,
         params.timeoutMs,
+        params.slowThresholdMs || 0,
+        params.cacheBust ? 'cache-bust' : 'cache',
         params.includeSamples ? 'samples' : 'no-samples',
     ].join('|');
 }
 function selectChecks(params) {
     const mode = params.mode || 'quick';
     return HEALTH_CHECKS.filter((check) => {
-        if (check.mode !== mode) {
+        if (mode !== 'full' && check.mode !== mode) {
             return false;
         }
         if (params.service && check.service !== params.service) {
@@ -123,6 +207,19 @@ function selectChecks(params) {
         return true;
     });
 }
+async function mapWithConcurrency(items, concurrency, mapper) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    const workerCount = Math.min(Math.max(1, concurrency), items.length);
+    await Promise.all(Array.from({ length: workerCount }, async () => {
+        while (nextIndex < items.length) {
+            const currentIndex = nextIndex;
+            nextIndex += 1;
+            results[currentIndex] = await mapper(items[currentIndex]);
+        }
+    }));
+    return results;
+}
 function toCount(data) {
     if (!data || typeof data !== 'object') {
         return null;
@@ -137,6 +234,15 @@ function toCount(data) {
             return value.length;
         }
     }
+    if (record.inventory && typeof record.inventory === 'object') {
+        const inventory = record.inventory;
+        for (const key of ['products', 'items']) {
+            const value = inventory[key];
+            if (Array.isArray(value)) {
+                return value.length;
+            }
+        }
+    }
     return null;
 }
 function toFirstName(data) {
@@ -156,8 +262,67 @@ function toFirstName(data) {
             }
         }
     }
+    if (record.inventory && typeof record.inventory === 'object') {
+        const inventory = record.inventory;
+        for (const key of ['products', 'items']) {
+            const value = inventory[key];
+            if (!Array.isArray(value) || !value[0] || typeof value[0] !== 'object') {
+                continue;
+            }
+            const item = value[0];
+            for (const nameKey of ['productName', 'itemName', 'goodsName', 'name']) {
+                if (typeof item[nameKey] === 'string' && item[nameKey].trim().length > 0) {
+                    return item[nameKey].trim();
+                }
+            }
+        }
+    }
     return undefined;
 }
+function getCollectionItems(data, collectionKey) {
+    if (!data || typeof data !== 'object') {
+        return [];
+    }
+    const record = data;
+    if (collectionKey === 'inventoryProducts' || collectionKey === 'inventoryItems') {
+        const inventory = record.inventory;
+        if (!inventory || typeof inventory !== 'object') {
+            return [];
+        }
+        const key = collectionKey === 'inventoryProducts' ? 'products' : 'items';
+        const value = inventory[key];
+        return Array.isArray(value) ? value : [];
+    }
+    if (collectionKey && Array.isArray(record[collectionKey])) {
+        return record[collectionKey];
+    }
+    for (const key of ['products', 'stores', 'theaters', 'movies', 'showtimes']) {
+        /* c8 ignore next -- 현재 정의된 체크는 collectionKey를 명시한다. */
+        if (Array.isArray(record[key])) {
+            return record[key];
+        }
+    }
+    return [];
+}
+function hasRequiredRepresentativeFields(data, collectionKey, requiredFields = []) {
+    /* c8 ignore next -- 현재 정의된 API 체크는 requiredFields를 명시한다. */
+    if (requiredFields.length === 0) {
+        return true;
+    }
+    const items = getCollectionItems(data, collectionKey);
+    if (items.length === 0) {
+        return true;
+    }
+    const first = items[0];
+    if (!first || typeof first !== 'object' || Array.isArray(first)) {
+        return false;
+    }
+    const record = first;
+    return requiredFields.some((field) => {
+        const value = record[field];
+        return typeof value === 'string' ? value.trim().length > 0 : value !== undefined && value !== null;
+    });
+}
 function aggregateStatus(checks) {
     if (checks.length === 0) {
         return 'skipped';
@@ -170,9 +335,30 @@ function aggregateStatus(checks) {
     }
     return 'ok';
 }
-function buildCheckUrl(baseUrl, check, timeoutMs) {
+function shouldDegradeFailedResponse(check, message) {
+    return check.degradedFailurePatterns?.some((pattern) => message.includes(pattern)) ?? false;
+}
+function shouldDegradeCliContractPath(path, message) {
+    return path.startsWith('/api/gs25/') && GS25_CLOUDFRONT_403_PATTERNS.some((pattern) => message.includes(pattern));
+}
+function resolveCheckTimeoutMs(check, timeoutMs) {
+    if (check.timeoutMs === undefined) {
+        return timeoutMs;
+    }
+    return Math.min(timeoutMs, Math.trunc(check.timeoutMs));
+}
+function resolveCliContractTimeoutMs(path, timeoutMs) {
+    if (path.startsWith('/api/oliveyoung/')) {
+        return Math.min(timeoutMs, 5000);
+    }
+    return timeoutMs;
+}
+function buildCheckUrl(baseUrl, check, timeoutMs, cacheBustValue) {
     const url = new URL(check.path, baseUrl);
     url.searchParams.set('timeoutMs', String(timeoutMs));
+    if (typeof cacheBustValue === 'number') {
+        url.searchParams.set('_healthCheck', String(cacheBustValue));
+    }
     return url.toString();
 }
 const CLI_CONTRACT_PATHS = [
@@ -201,14 +387,22 @@ function isCliCompatibleEnvelope(path, body) {
 }
 async function runCliContractCheck(check, params) {
     const startedAt = params.now();
+    const cacheBustValue = params.cacheBust ? startedAt : undefined;
+    const degradedMessages = [];
     for (const path of CLI_CONTRACT_PATHS) {
+        const checkTimeoutMs = resolveCliContractTimeoutMs(path, params.timeoutMs);
         const syntheticCheck = { ...check, path };
         try {
-            const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, syntheticCheck, params.timeoutMs), {
-                signal: AbortSignal.timeout(params.timeoutMs),
+            const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, syntheticCheck, checkTimeoutMs, cacheBustValue), {
+                signal: AbortSignal.timeout(checkTimeoutMs),
             });
             const body = (await response.json().catch(() => ({})));
             if (!response.ok || !isCliCompatibleEnvelope(path, body)) {
+                const message = body.error?.message || `${path} CLI 계약 응답이 올바르지 않습니다.`;
+                if (shouldDegradeCliContractPath(path, message)) {
+                    degradedMessages.push(`${path}: ${message}`);
+                    continue;
+                }
                 return {
                     id: check.id,
                     service: check.service,
@@ -216,7 +410,7 @@ async function runCliContractCheck(check, params) {
                     status: 'fail',
                     durationMs: params.now() - startedAt,
                     httpStatus: response.status,
-                    message: body.error?.message || `${path} CLI 계약 응답이 올바르지 않습니다.`,
+                    message,
                 };
             }
         }
@@ -235,37 +429,51 @@ async function runCliContractCheck(check, params) {
         id: check.id,
         service: check.service,
         target: check.target,
-        status: 'ok',
+        status: degradedMessages.length > 0 ? 'degraded' : 'ok',
         durationMs: params.now() - startedAt,
-        message: `${CLI_CONTRACT_PATHS.length} CLI contract endpoint(s) passed`,
+        message: degradedMessages.length > 0
+            ? `known upstream issue: ${degradedMessages[0]}`
+            : `${CLI_CONTRACT_PATHS.length} CLI contract endpoint(s) passed`,
     };
 }
 async function runSingleCheck(check, params) {
     if (check.kind === 'cli-contract') {
         return runCliContractCheck(check, params);
     }
-    const timeoutMs = params.timeoutMs;
+    const timeoutMs = resolveCheckTimeoutMs(check, params.timeoutMs);
     const startedAt = params.now();
+    const cacheBustValue = params.cacheBust ? startedAt : undefined;
     try {
-        const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, check, timeoutMs), {
+        const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, check, timeoutMs, cacheBustValue), {
             signal: AbortSignal.timeout(timeoutMs),
         });
         const body = (await response.json().catch(() => ({})));
         const durationMs = params.now() - startedAt;
         if (!response.ok || body.success === false) {
+            const message = body.error?.message || `HTTP ${response.status}`;
             return {
                 id: check.id,
                 service: check.service,
                 target: check.target,
-                status: 'fail',
+                status: shouldDegradeFailedResponse(check, message) ? 'degraded' : 'fail',
                 durationMs,
                 httpStatus: response.status,
-                message: body.error?.message || `HTTP ${response.status}`,
+                message,
             };
         }
         const count = typeof body.meta?.total === 'number' ? body.meta.total : toCount(body.data);
-        const status = count === 0 ? 'degraded' : 'ok';
+        const shapeOk = hasRequiredRepresentativeFields(body.data, check.collectionKey, check.requiredFields);
+        const slowThresholdMs = params.slowThresholdMs || DEFAULT_HEALTH_CHECK_SLOW_THRESHOLD_MS;
+        const slow = slowThresholdMs > 0 && durationMs > slowThresholdMs;
+        const status = count === 0 || !shapeOk || slow ? 'degraded' : 'ok';
         const first = params.includeSamples ? toFirstName(body.data) : undefined;
+        const message = slow
+            ? `slow response: ${durationMs}ms > ${slowThresholdMs}ms`
+            : !shapeOk && count !== 0
+                ? `response missing required fields: ${check.requiredFields.join(', ')}`
+                : count === null
+                    ? 'response ok'
+                    : `${count} item(s) returned`;
         return {
             id: check.id,
             service: check.service,
@@ -273,7 +481,7 @@ async function runSingleCheck(check, params) {
             status,
             durationMs,
             httpStatus: response.status,
-            message: count === null ? 'response ok' : `${count} item(s) returned`,
+            message,
             ...(first ? { sample: { first } } : {}),
         };
     }
@@ -293,7 +501,10 @@ export async function runHealthChecks(params) {
     const fetchImpl = params.fetchImpl || ((input, init) => globalThis.fetch(input, init));
     const mode = params.mode || 'quick';
     const timeoutMs = clampTimeout(params.timeoutMs ?? DEFAULT_HEALTH_CHECK_TIMEOUT_MS);
-    const cacheKey = createCacheKey({ ...params, mode, timeoutMs, baseUrl: params.baseUrl });
+    const slowThresholdMs = Number.isFinite(params.slowThresholdMs) && params.slowThresholdMs && params.slowThresholdMs > 0
+        ? Math.trunc(params.slowThresholdMs)
+        : DEFAULT_HEALTH_CHECK_SLOW_THRESHOLD_MS;
+    const cacheKey = createCacheKey({ ...params, mode, timeoutMs, slowThresholdMs, baseUrl: params.baseUrl });
     const cached = healthCheckCache.get(cacheKey);
     const startedAt = now();
     if (!params.fresh && cached && cached.expiresAt > startedAt) {
@@ -302,13 +513,15 @@ export async function runHealthChecks(params) {
             cached: true,
         };
     }
-    const checks = await Promise.all(selectChecks(params).map((check) => runSingleCheck(check, {
+    const checks = await mapWithConcurrency(selectChecks(params), DEFAULT_HEALTH_CHECK_CONCURRENCY, (check) => runSingleCheck(check, {
         baseUrl: params.baseUrl,
         fetchImpl,
         now,
         timeoutMs,
+        slowThresholdMs,
         includeSamples: params.includeSamples,
-    })));
+        cacheBust: params.cacheBust,
+    }));
     const summary = {
         status: aggregateStatus(checks),
         checkedAt: new Date(startedAt).toISOString(),

package/dist/api/lottemartHandlers.js

@@ -5,6 +5,15 @@ import { errorResponse, successResponse } from './response.js';
 import { fetchLotteMartStores, searchLotteMartProducts } from '../services/lottemart/client.js';
 import { DEFAULT_LOTTEMART_TIMEOUT_MS } from '../services/lottemart/config.js';
 import { probeLotteMartUpstream } from '../services/lottemart/debug.js';
+function parseLotteMartProductSource(value) {
+    if (!value || value === 'auto') {
+        return 'auto';
+    }
+    if (value === 'legacy' || value === 'zetta') {
+        return value;
+    }
+    return null;
+}
 /**
  * 롯데마트 매장 검색 API 핸들러
  * GET /api/lottemart/stores?keyword={키워드}&lat={위도}&lng={경도}
@@ -62,9 +71,15 @@ export async function handleLotteMartSearchProducts(c) {
     const storeCode = c.req.query('storeCode') || '';
     const storeName = c.req.query('storeName') || '';
     const pageLimit = parseInt(c.req.query('pageLimit') || '3', 10);
+    const parsedTimeoutMs = parseInt(c.req.query('timeoutMs') || String(DEFAULT_LOTTEMART_TIMEOUT_MS), 10);
+    const timeoutMs = Number.isFinite(parsedTimeoutMs) && parsedTimeoutMs > 0 ? parsedTimeoutMs : DEFAULT_LOTTEMART_TIMEOUT_MS;
+    const source = parseLotteMartProductSource(c.req.query('source'));
     if (keyword.trim().length === 0) {
         return errorResponse(c, 'MISSING_QUERY', '검색어(keyword)를 입력해주세요.');
     }
+    if (!source) {
+        return errorResponse(c, 'INVALID_LOTTEMART_SOURCE', 'source는 auto, legacy, zetta 중 하나여야 합니다.');
+    }
     if (storeCode.trim().length === 0 && storeName.trim().length === 0) {
         return errorResponse(c, 'MISSING_STORE', 'storeCode 또는 storeName 중 하나를 입력해주세요.');
     }
@@ -75,8 +90,9 @@ export async function handleLotteMartSearchProducts(c) {
             storeName,
             keyword,
             pageLimit,
+            source,
         }, {
-            timeout: DEFAULT_LOTTEMART_TIMEOUT_MS,
+            timeout: timeoutMs,
             zyteApiKey: c.env?.ZYTE_API_KEY,
         });
         return successResponse(c, {

package/dist/api/placesHandlers.js

@@ -0,0 +1,44 @@
+/**
+ * 장소 검색 GET API 핸들러
+ */
+import { errorResponse, successResponse } from './response.js';
+import { searchNaverLocalPlaces } from '../services/places/client.js';
+import { getErrorMessage } from '../core/errors.js';
+const PLACE_CATEGORIES = new Set(['restaurant', 'cafe', 'food', 'dessert', 'all']);
+function parseCategory(value) {
+    if (value && PLACE_CATEGORIES.has(value)) {
+        return value;
+    }
+    return 'all';
+}
+export async function handlePlacesSearch(c) {
+    const location = c.req.query('location') || '';
+    const keyword = c.req.query('keyword') || '';
+    const limit = Number.parseInt(c.req.query('limit') || '5', 10);
+    const start = Number.parseInt(c.req.query('start') || '1', 10);
+    const sort = c.req.query('sort') === 'comment' ? 'comment' : 'random';
+    const category = parseCategory(c.req.query('category'));
+    if (location.trim().length === 0 && keyword.trim().length === 0) {
+        return errorResponse(c, 'MISSING_QUERY', '위치(location) 또는 검색어(keyword)를 입력해주세요.');
+    }
+    try {
+        const result = await searchNaverLocalPlaces({
+            naverClientId: c.env?.NAVER_CLIENT_ID,
+            naverClientSecret: c.env?.NAVER_CLIENT_SECRET,
+            location,
+            keyword,
+            category,
+            limit,
+            start,
+            sort,
+        });
+        return successResponse(c, result, {
+            total: result.totalCount,
+            page: start,
+            pageSize: result.count,
+        });
+    }
+    catch (error) {
+        return errorResponse(c, 'PLACES_SEARCH_FAILED', getErrorMessage(error), 500);
+    }
+}

package/dist/api/response.js

@@ -1,6 +1,7 @@
 /**
  * API 공통 응답 유틸리티
  */
+import { toStandardErrorDiagnostics } from '../core/errors.js';
 /**
  * 성공 응답 생성
  */
@@ -18,5 +19,6 @@ export function errorResponse(c, code, message, status = 400) {
     return c.json({
         success: false,
         error: { code, message },
+        diagnostics: toStandardErrorDiagnostics(code, message, { status }),
     }, status);
 }

package/dist/api/routes/healthRoutes.js

@@ -14,6 +14,15 @@ function readHealthCheckToken(headers) {
     }
     return (headers.get('x-health-check-key') || '').trim();
 }
+function parseMode(value) {
+    if (!value || value === 'quick') {
+        return 'quick';
+    }
+    if (value === 'deep' || value === 'full') {
+        return value;
+    }
+    return null;
+}
 export function registerHealthRoutes(app) {
     app.get('/api/health/checks', async (c) => {
         const secret = c.env?.HEALTH_CHECK_SECRET?.trim();
@@ -23,10 +32,16 @@ export function registerHealthRoutes(app) {
         if (readHealthCheckToken(c.req.raw.headers) !== secret) {
             return errorResponse(c, 'UNAUTHORIZED_HEALTH_CHECK', '유효한 헬스 체크 시크릿 키가 필요합니다.', 401);
         }
-        const mode = c.req.query('mode') === 'deep' ? 'deep' : 'quick';
+        const mode = parseMode(c.req.query('mode'));
+        if (!mode) {
+            return errorResponse(c, 'INVALID_HEALTH_CHECK_MODE', 'mode는 quick, deep, full 중 하나여야 합니다.', 400);
+        }
         const timeoutMs = Number.parseInt(c.req.query('timeoutMs') || '3000', 10);
-        const baseUrl = c.env?.HEALTH_CHECK_BASE_URL?.trim() || new URL(c.req.url).origin;
-        const fetchImpl = c.env?.HEALTH_CHECK_BASE_URL && c.env?.HEALTH_CHECK_TRANSPORT !== 'network'
+        const slowThresholdMs = Number.parseInt(c.req.query('slowThresholdMs') || c.env?.HEALTH_CHECK_SLOW_THRESHOLD_MS || '0', 10);
+        const baseUrl = c.req.query('baseUrl')?.trim() || c.env?.HEALTH_CHECK_BASE_URL?.trim() || new URL(c.req.url).origin;
+        const transport = c.req.query('transport') || c.env?.HEALTH_CHECK_TRANSPORT || 'internal';
+        const cacheBust = parseBoolean(c.req.query('cacheBust')) || transport === 'network';
+        const fetchImpl = transport !== 'network'
             ? async (input, init) => app.fetch(new Request(input, init), c.env)
             : undefined;
         const result = await runHealthChecks({
@@ -35,8 +50,10 @@ export function registerHealthRoutes(app) {
             check: c.req.query('check') || undefined,
             mode,
             timeoutMs,
+            slowThresholdMs,
             includeSamples: parseBoolean(c.req.query('includeSamples')),
             fresh: parseBoolean(c.req.query('fresh')),
+            cacheBust,
             fetchImpl,
         });
         return c.json(result);

package/dist/api/routes/placesRoutes.js

@@ -0,0 +1,9 @@
+import { withEdgeCache } from '../../utils/cache.js';
+import { handlePlacesSearch } from '../placesHandlers.js';
+export function registerPlacesRoutes(app) {
+    app.get('/api/places/search', async (c) => withEdgeCache(c.req.url, {
+        ttlSeconds: 60 * 60,
+        staleWhileRevalidateSeconds: 60 * 10,
+        keyPrefix: 'places-search-v1',
+    }, () => handlePlacesSearch(c)));
+}

package/dist/cli/args.js

@@ -52,3 +52,24 @@ export function toQueryOptions(options) {
     }
     return queryOptions;
 }
+export function findUnknownOption(options, allowedOptions) {
+    const allowed = new Set(allowedOptions);
+    for (const key of Object.keys(options)) {
+        if (!allowed.has(key)) {
+            return key;
+        }
+    }
+    return null;
+}
+export function writeUnknownOptionError(options, allowedOptions, writeErr, hint) {
+    const unknownOption = findUnknownOption(options, allowedOptions);
+    if (!unknownOption) {
+        return false;
+    }
+    writeErr(`알 수 없는 옵션: --${unknownOption}`);
+    if (hint) {
+        writeErr(hint);
+    }
+    writeErr('도움말: daiso help');
+    return true;
+}