daiso 1.0.3 → 1.0.5

package/dist/api/healthChecks.js

@@ -0,0 +1,332 @@
+/**
+ * 개별 서비스 헬스 체크 실행기
+ */
+const HEALTH_CHECK_CACHE_TTL_MS = 60_000;
+const DEFAULT_HEALTH_CHECK_TIMEOUT_MS = 3000;
+const MAX_HEALTH_CHECK_TIMEOUT_MS = 10_000;
+const HEALTH_CHECKS = [
+    {
+        id: 'cli.contract',
+        service: 'cli',
+        target: 'api-contract',
+        mode: 'deep',
+        kind: 'cli-contract',
+        path: '/health',
+    },
+    {
+        id: 'daiso.products',
+        service: 'daiso',
+        target: 'products',
+        mode: 'quick',
+        path: '/api/daiso/products?q=%ED%85%8C%EC%9D%B4%ED%94%84&pageSize=1',
+    },
+    {
+        id: 'cu.stores',
+        service: 'cu',
+        target: 'stores',
+        mode: 'quick',
+        path: '/api/cu/stores?keyword=%EA%B0%95%EB%82%A8&limit=1',
+    },
+    {
+        id: 'emart24.products',
+        service: 'emart24',
+        target: 'products',
+        mode: 'quick',
+        path: '/api/emart24/products?keyword=%EC%BB%A4%ED%94%BC&pageSize=1',
+    },
+    {
+        id: 'gs25.products',
+        service: 'gs25',
+        target: 'products',
+        mode: 'quick',
+        path: '/api/gs25/products?keyword=%EC%BD%9C%EB%9D%BC&limit=1',
+    },
+    {
+        id: 'gs25.stores',
+        service: 'gs25',
+        target: 'stores',
+        mode: 'quick',
+        path: '/api/gs25/stores?keyword=%EA%B0%95%EB%82%A8&limit=1',
+    },
+    {
+        id: 'seveneleven.products',
+        service: 'seveneleven',
+        target: 'products',
+        mode: 'quick',
+        path: '/api/seveneleven/products?query=%EC%BB%A4%ED%94%BC&size=1',
+    },
+    {
+        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',
+    },
+    {
+        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',
+    },
+    {
+        id: 'megabox.theaters',
+        service: 'megabox',
+        target: 'theaters',
+        mode: 'quick',
+        path: '/api/megabox/theaters?keyword=%EA%B0%95%EB%82%A8&limit=1',
+    },
+    {
+        id: 'lottecinema.theaters',
+        service: 'lottecinema',
+        target: 'theaters',
+        mode: 'quick',
+        path: '/api/lottecinema/theaters?keyword=%EC%9E%A0%EC%8B%A4&limit=1',
+    },
+    {
+        id: 'cgv.theaters',
+        service: 'cgv',
+        target: 'theaters',
+        mode: 'quick',
+        path: '/api/cgv/theaters?keyword=%EA%B0%95%EB%82%A8&limit=1',
+    },
+];
+const healthCheckCache = new Map();
+function clampTimeout(timeoutMs) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 1) {
+        return DEFAULT_HEALTH_CHECK_TIMEOUT_MS;
+    }
+    return Math.min(Math.trunc(timeoutMs), MAX_HEALTH_CHECK_TIMEOUT_MS);
+}
+function createCacheKey(params) {
+    return [
+        params.baseUrl,
+        params.service || '',
+        params.check || '',
+        params.mode,
+        params.timeoutMs,
+        params.includeSamples ? 'samples' : 'no-samples',
+    ].join('|');
+}
+function selectChecks(params) {
+    const mode = params.mode || 'quick';
+    return HEALTH_CHECKS.filter((check) => {
+        if (check.mode !== mode) {
+            return false;
+        }
+        if (params.service && check.service !== params.service) {
+            return false;
+        }
+        if (params.check && check.id !== params.check) {
+            return false;
+        }
+        return true;
+    });
+}
+function toCount(data) {
+    if (!data || typeof data !== 'object') {
+        return null;
+    }
+    const record = data;
+    if (typeof record.count === 'number') {
+        return record.count;
+    }
+    for (const key of ['products', 'stores', 'theaters', 'movies', 'showtimes']) {
+        const value = record[key];
+        if (Array.isArray(value)) {
+            return value.length;
+        }
+    }
+    return null;
+}
+function toFirstName(data) {
+    if (!data || typeof data !== 'object') {
+        return undefined;
+    }
+    const record = data;
+    for (const key of ['products', 'stores', 'theaters', 'movies', 'showtimes']) {
+        const value = record[key];
+        if (!Array.isArray(value) || !value[0] || typeof value[0] !== 'object') {
+            continue;
+        }
+        const item = value[0];
+        for (const nameKey of ['productName', 'itemName', 'goodsName', 'name', 'storeName', 'theaterName', 'movieName']) {
+            if (typeof item[nameKey] === 'string' && item[nameKey].trim().length > 0) {
+                return item[nameKey].trim();
+            }
+        }
+    }
+    return undefined;
+}
+function aggregateStatus(checks) {
+    if (checks.length === 0) {
+        return 'skipped';
+    }
+    if (checks.some((check) => check.status === 'fail')) {
+        return 'fail';
+    }
+    if (checks.some((check) => check.status === 'degraded')) {
+        return 'degraded';
+    }
+    return 'ok';
+}
+function buildCheckUrl(baseUrl, check, timeoutMs) {
+    const url = new URL(check.path, baseUrl);
+    url.searchParams.set('timeoutMs', String(timeoutMs));
+    return url.toString();
+}
+const CLI_CONTRACT_PATHS = [
+    '/health',
+    '/api/daiso/products?q=%ED%85%8C%EC%9D%B4%ED%94%84&pageSize=1',
+    '/api/daiso/stores?keyword=%EA%B0%95%EB%82%A8&pageSize=1',
+    '/api/gs25/products?keyword=%EC%BD%9C%EB%9D%BC&limit=1',
+    '/api/gs25/stores?keyword=%EA%B0%95%EB%82%A8&limit=1',
+    '/api/seveneleven/products?query=%EC%BB%A4%ED%94%BC&size=1',
+    '/api/emart24/products?keyword=%EC%BB%A4%ED%94%BC&pageSize=1',
+    '/api/lottemart/products?keyword=%EC%BD%9C%EB%9D%BC&storeCode=2301&area=%EC%84%9C%EC%9A%B8&pageLimit=1',
+    '/api/oliveyoung/products?keyword=%EC%84%A0%ED%81%AC%EB%A6%BC&size=1',
+    '/api/megabox/theaters?keyword=%EA%B0%95%EB%82%A8&limit=1',
+    '/api/lottecinema/theaters?keyword=%EC%9E%A0%EC%8B%A4&limit=1',
+    '/api/cgv/theaters?keyword=%EA%B0%95%EB%82%A8&limit=1',
+];
+function isCliCompatibleEnvelope(path, body) {
+    if (!body || typeof body !== 'object') {
+        return false;
+    }
+    const record = body;
+    if (path === '/health') {
+        return record.status === 'ok';
+    }
+    return record.success === true && typeof record.data === 'object' && record.data !== null;
+}
+async function runCliContractCheck(check, params) {
+    const startedAt = params.now();
+    for (const path of CLI_CONTRACT_PATHS) {
+        const syntheticCheck = { ...check, path };
+        try {
+            const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, syntheticCheck, params.timeoutMs), {
+                signal: AbortSignal.timeout(params.timeoutMs),
+            });
+            const body = (await response.json().catch(() => ({})));
+            if (!response.ok || !isCliCompatibleEnvelope(path, body)) {
+                return {
+                    id: check.id,
+                    service: check.service,
+                    target: check.target,
+                    status: 'fail',
+                    durationMs: params.now() - startedAt,
+                    httpStatus: response.status,
+                    message: body.error?.message || `${path} CLI 계약 응답이 올바르지 않습니다.`,
+                };
+            }
+        }
+        catch (error) {
+            return {
+                id: check.id,
+                service: check.service,
+                target: check.target,
+                status: 'fail',
+                durationMs: params.now() - startedAt,
+                message: error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.',
+            };
+        }
+    }
+    return {
+        id: check.id,
+        service: check.service,
+        target: check.target,
+        status: 'ok',
+        durationMs: params.now() - startedAt,
+        message: `${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 startedAt = params.now();
+    try {
+        const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, check, timeoutMs), {
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        const body = (await response.json().catch(() => ({})));
+        const durationMs = params.now() - startedAt;
+        if (!response.ok || body.success === false) {
+            return {
+                id: check.id,
+                service: check.service,
+                target: check.target,
+                status: 'fail',
+                durationMs,
+                httpStatus: response.status,
+                message: body.error?.message || `HTTP ${response.status}`,
+            };
+        }
+        const count = typeof body.meta?.total === 'number' ? body.meta.total : toCount(body.data);
+        const status = count === 0 ? 'degraded' : 'ok';
+        const first = params.includeSamples ? toFirstName(body.data) : undefined;
+        return {
+            id: check.id,
+            service: check.service,
+            target: check.target,
+            status,
+            durationMs,
+            httpStatus: response.status,
+            message: count === null ? 'response ok' : `${count} item(s) returned`,
+            ...(first ? { sample: { first } } : {}),
+        };
+    }
+    catch (error) {
+        return {
+            id: check.id,
+            service: check.service,
+            target: check.target,
+            status: 'fail',
+            durationMs: params.now() - startedAt,
+            message: error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.',
+        };
+    }
+}
+export async function runHealthChecks(params) {
+    const now = params.now || Date.now;
+    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 cached = healthCheckCache.get(cacheKey);
+    const startedAt = now();
+    if (!params.fresh && cached && cached.expiresAt > startedAt) {
+        return {
+            ...cached.summary,
+            cached: true,
+        };
+    }
+    const checks = await Promise.all(selectChecks(params).map((check) => runSingleCheck(check, {
+        baseUrl: params.baseUrl,
+        fetchImpl,
+        now,
+        timeoutMs,
+        includeSamples: params.includeSamples,
+    })));
+    const summary = {
+        status: aggregateStatus(checks),
+        checkedAt: new Date(startedAt).toISOString(),
+        durationMs: now() - startedAt,
+        cached: false,
+        filters: {
+            service: params.service || null,
+            check: params.check || null,
+            mode,
+        },
+        checks,
+    };
+    healthCheckCache.set(cacheKey, {
+        expiresAt: startedAt + HEALTH_CHECK_CACHE_TTL_MS,
+        summary,
+    });
+    return summary;
+}
+export function __testOnlyClearHealthCheckCache() {
+    healthCheckCache.clear();
+}

package/dist/api/lottecinemaHandlers.js

@@ -0,0 +1,155 @@
+/**
+ * 롯데시네마 GET API 핸들러
+ */
+import { fetchLotteCinemaNowShowing, toYyyymmdd, } from '../services/lottecinema/client.js';
+import { fetchLotteCinemaNearbyTheaters, resolveLotteCinemaNearestTheater, } from '../services/lottecinema/location.js';
+import { errorResponse, successResponse } from './response.js';
+function parseOptionalNumber(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+export async function handleLotteCinemaFindNearbyTheaters(c) {
+    const keyword = c.req.query('keyword') || undefined;
+    const latitude = parseOptionalNumber(c.req.query('lat'));
+    const longitude = parseOptionalNumber(c.req.query('lng'));
+    const playDate = c.req.query('playDate') || toYyyymmdd();
+    const limit = parseInt(c.req.query('limit') || '10', 10);
+    const timeoutMs = parseInt(c.req.query('timeoutMs') || '15000', 10);
+    try {
+        const hasCoordinates = typeof latitude === 'number' && typeof longitude === 'number';
+        const result = await fetchLotteCinemaNearbyTheaters({
+            keyword,
+            latitude: hasCoordinates ? latitude : keyword ? undefined : 37.5665,
+            longitude: hasCoordinates ? longitude : keyword ? undefined : 126.978,
+            playDate,
+            limit,
+            timeout: timeoutMs,
+        }, {
+            timeout: timeoutMs,
+            googleMapsApiKey: c.env?.GOOGLE_MAPS_API_KEY,
+        });
+        return successResponse(c, result, { total: result.count, pageSize: limit });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'LOTTECINEMA_THEATER_SEARCH_FAILED', message, 500);
+    }
+}
+export async function handleLotteCinemaListNowShowing(c) {
+    const playDate = c.req.query('playDate') || toYyyymmdd();
+    let theaterId = c.req.query('theaterId') || undefined;
+    const movieId = c.req.query('movieId') || undefined;
+    const keyword = c.req.query('keyword') || undefined;
+    const latitude = parseOptionalNumber(c.req.query('lat'));
+    const longitude = parseOptionalNumber(c.req.query('lng'));
+    const timeoutMs = parseInt(c.req.query('timeoutMs') || '15000', 10);
+    try {
+        let resolvedTheater = null;
+        if (!theaterId && (keyword || typeof latitude === 'number' || typeof longitude === 'number')) {
+            const resolved = await resolveLotteCinemaNearestTheater({
+                playDate,
+                keyword,
+                latitude,
+                longitude,
+                timeout: timeoutMs,
+            }, {
+                timeout: timeoutMs,
+                googleMapsApiKey: c.env?.GOOGLE_MAPS_API_KEY,
+            });
+            resolvedTheater = resolved.theater;
+            theaterId = resolved.theater?.theaterId;
+        }
+        const shouldReturnEmpty = !theaterId && (keyword || typeof latitude === 'number' || typeof longitude === 'number');
+        const { theaters, movies, showtimes } = shouldReturnEmpty
+            ? { theaters: [], movies: [], showtimes: [] }
+            : await fetchLotteCinemaNowShowing({
+                playDate,
+                theaterId,
+                movieId,
+                timeout: timeoutMs,
+            });
+        return successResponse(c, {
+            playDate,
+            filters: {
+                theaterId: theaterId || null,
+                movieId: movieId || null,
+                keyword: keyword || null,
+                latitude: latitude ?? null,
+                longitude: longitude ?? null,
+            },
+            resolvedTheater,
+            theaters,
+            movies,
+            showtimes,
+        }, { total: showtimes.length });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'LOTTECINEMA_MOVIE_LIST_FAILED', message, 500);
+    }
+}
+export async function handleLotteCinemaGetRemainingSeats(c) {
+    const playDate = c.req.query('playDate') || toYyyymmdd();
+    let theaterId = c.req.query('theaterId') || undefined;
+    const movieId = c.req.query('movieId') || undefined;
+    const keyword = c.req.query('keyword') || undefined;
+    const latitude = parseOptionalNumber(c.req.query('lat'));
+    const longitude = parseOptionalNumber(c.req.query('lng'));
+    const limit = parseInt(c.req.query('limit') || '50', 10);
+    const timeoutMs = parseInt(c.req.query('timeoutMs') || '15000', 10);
+    try {
+        let resolvedTheater = null;
+        if (!theaterId && (keyword || typeof latitude === 'number' || typeof longitude === 'number')) {
+            const resolved = await resolveLotteCinemaNearestTheater({
+                playDate,
+                keyword,
+                latitude,
+                longitude,
+                timeout: timeoutMs,
+            }, {
+                timeout: timeoutMs,
+                googleMapsApiKey: c.env?.GOOGLE_MAPS_API_KEY,
+            });
+            resolvedTheater = resolved.theater;
+            theaterId = resolved.theater?.theaterId;
+        }
+        const shouldReturnEmpty = !theaterId && (keyword || typeof latitude === 'number' || typeof longitude === 'number');
+        const { showtimes } = shouldReturnEmpty
+            ? { showtimes: [] }
+            : await fetchLotteCinemaNowShowing({
+                playDate,
+                theaterId,
+                movieId,
+                timeout: timeoutMs,
+            });
+        const seats = showtimes
+            .filter((item) => (theaterId ? item.theaterId === theaterId : true))
+            .filter((item) => (movieId ? item.movieId === movieId : true))
+            .sort((a, b) => {
+            if (a.startTime === b.startTime) {
+                return a.theaterName.localeCompare(b.theaterName);
+            }
+            return a.startTime.localeCompare(b.startTime);
+        })
+            .slice(0, limit);
+        return successResponse(c, {
+            playDate,
+            filters: {
+                theaterId: theaterId || null,
+                movieId: movieId || null,
+                keyword: keyword || null,
+                latitude: latitude ?? null,
+                longitude: longitude ?? null,
+            },
+            resolvedTheater,
+            seats,
+        }, { total: seats.length, pageSize: limit });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'LOTTECINEMA_SEAT_LIST_FAILED', message, 500);
+    }
+}

package/dist/api/lottemartHandlers.js

@@ -0,0 +1,128 @@
+/**
+ * 롯데마트 GET API 핸들러
+ */
+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';
+/**
+ * 롯데마트 매장 검색 API 핸들러
+ * GET /api/lottemart/stores?keyword={키워드}&lat={위도}&lng={경도}
+ */
+export async function handleLotteMartFindStores(c) {
+    const keyword = c.req.query('keyword') || '';
+    const area = c.req.query('area') || '';
+    const brandVariant = c.req.query('brandVariant') || '';
+    const limit = parseInt(c.req.query('limit') || '20', 10);
+    const rawLat = c.req.query('lat');
+    const rawLng = c.req.query('lng');
+    const parsedLat = rawLat ? parseFloat(rawLat) : undefined;
+    const parsedLng = rawLng ? parseFloat(rawLng) : undefined;
+    const latitude = typeof parsedLat === 'number' && Number.isFinite(parsedLat) ? parsedLat : undefined;
+    const longitude = typeof parsedLng === 'number' && Number.isFinite(parsedLng) ? parsedLng : undefined;
+    try {
+        const result = await fetchLotteMartStores({
+            area,
+            keyword,
+            brandVariant,
+            latitude,
+            longitude,
+            limit,
+        }, {
+            timeout: DEFAULT_LOTTEMART_TIMEOUT_MS,
+            googleMapsApiKey: c.env?.GOOGLE_MAPS_API_KEY,
+            zyteApiKey: c.env?.ZYTE_API_KEY,
+        });
+        return successResponse(c, {
+            area: area || null,
+            keyword,
+            brandVariant: brandVariant || null,
+            geocodeUsed: result.geocodeUsed,
+            location: result.location,
+            count: result.stores.length,
+            stores: result.stores,
+        }, {
+            total: result.stores.length,
+            page: 1,
+            pageSize: limit,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'LOTTEMART_STORE_SEARCH_FAILED', message, 500);
+    }
+}
+/**
+ * 롯데마트 상품 검색 API 핸들러
+ * GET /api/lottemart/products?keyword={검색어}&storeCode={매장코드}
+ */
+export async function handleLotteMartSearchProducts(c) {
+    const keyword = c.req.query('keyword') || '';
+    const area = c.req.query('area') || '';
+    const storeCode = c.req.query('storeCode') || '';
+    const storeName = c.req.query('storeName') || '';
+    const pageLimit = parseInt(c.req.query('pageLimit') || '3', 10);
+    if (keyword.trim().length === 0) {
+        return errorResponse(c, 'MISSING_QUERY', '검색어(keyword)를 입력해주세요.');
+    }
+    if (storeCode.trim().length === 0 && storeName.trim().length === 0) {
+        return errorResponse(c, 'MISSING_STORE', 'storeCode 또는 storeName 중 하나를 입력해주세요.');
+    }
+    try {
+        const result = await searchLotteMartProducts({
+            area,
+            storeCode,
+            storeName,
+            keyword,
+            pageLimit,
+        }, {
+            timeout: DEFAULT_LOTTEMART_TIMEOUT_MS,
+            zyteApiKey: c.env?.ZYTE_API_KEY,
+        });
+        return successResponse(c, {
+            area: result.area,
+            storeCode: result.storeCode,
+            storeName: result.storeName,
+            keyword,
+            pageLimit,
+            totalPages: result.totalPages,
+            products: result.products,
+        }, {
+            total: result.totalCount,
+            page: 1,
+            pageSize: result.products.length,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'LOTTEMART_PRODUCT_SEARCH_FAILED', message, 500);
+    }
+}
+/**
+ * 롯데마트 업스트림 단독 진단 API 핸들러
+ * GET /api/lottemart/debug?target=market-options|stores|products|product-page
+ */
+export async function handleLotteMartDebug(c) {
+    const target = (c.req.query('target') || '');
+    const allowedTargets = ['market-options', 'stores', 'products', 'product-page'];
+    if (!allowedTargets.includes(target)) {
+        return errorResponse(c, 'INVALID_TARGET', 'target은 market-options, stores, products, product-page 중 하나여야 합니다.');
+    }
+    try {
+        const result = await probeLotteMartUpstream({
+            target,
+            area: c.req.query('area') || undefined,
+            type: (c.req.query('type') || undefined),
+            storeCode: c.req.query('storeCode') || undefined,
+            keyword: c.req.query('keyword') || undefined,
+            page: c.req.query('page') ? parseInt(c.req.query('page'), 10) : undefined,
+            timeout: c.req.query('timeoutMs') ? parseInt(c.req.query('timeoutMs'), 10) : DEFAULT_LOTTEMART_TIMEOUT_MS,
+            zyteApiKey: c.env?.ZYTE_API_KEY,
+        });
+        return successResponse(c, result);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'LOTTEMART_DEBUG_FAILED', message, 500);
+    }
+}