daiso 1.0.4 → 1.0.6

package/dist/api/healthChecks.js

@@ -0,0 +1,504 @@
+/**
+ * 개별 서비스 헬스 체크 실행기
+ */
+const HEALTH_CHECK_CACHE_TTL_MS = 60_000;
+const DEFAULT_HEALTH_CHECK_TIMEOUT_MS = 7000;
+const MAX_HEALTH_CHECK_TIMEOUT_MS = 20_000;
+const DEFAULT_HEALTH_CHECK_CONCURRENCY = 6;
+const DEFAULT_HEALTH_CHECK_SLOW_THRESHOLD_MS = 0;
+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',
+        collectionKey: 'products',
+        requiredFields: ['id', 'name', 'productName', 'itemName', 'goodsName'],
+    },
+    {
+        id: 'cu.stores',
+        service: 'cu',
+        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',
+        service: 'emart24',
+        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',
+        service: 'gs25',
+        target: 'products',
+        mode: 'quick',
+        path: '/api/gs25/products?keyword=%EC%BD%9C%EB%9D%BC&limit=1',
+        collectionKey: 'products',
+        requiredFields: ['itemCode', 'itemName', 'name'],
+    },
+    {
+        id: 'gs25.stores',
+        service: 'gs25',
+        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',
+        service: 'seveneleven',
+        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&source=zetta',
+        collectionKey: 'products',
+        requiredFields: ['productCode', 'name', 'productName'],
+    },
+    {
+        id: 'oliveyoung.products',
+        service: 'oliveyoung',
+        target: 'products',
+        mode: 'quick',
+        path: '/api/oliveyoung/products?keyword=%EB%A6%BD%EB%B0%A4&size=1',
+        collectionKey: 'products',
+        requiredFields: ['goodsNumber', 'goodsName', 'productNo', 'productName', 'name'],
+    },
+    {
+        id: 'megabox.theaters',
+        service: 'megabox',
+        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',
+        service: 'lottecinema',
+        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',
+        service: 'cgv',
+        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'],
+    },
+    {
+        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'],
+    },
+];
+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.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 (mode !== 'full' && 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;
+    });
+}
+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;
+    }
+    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;
+        }
+    }
+    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) {
+    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();
+            }
+        }
+    }
+    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';
+    }
+    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, 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 = [
+    '/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();
+    const cacheBustValue = params.cacheBust ? startedAt : undefined;
+    for (const path of CLI_CONTRACT_PATHS) {
+        const syntheticCheck = { ...check, path };
+        try {
+            const response = await params.fetchImpl(buildCheckUrl(params.baseUrl, syntheticCheck, params.timeoutMs, cacheBustValue), {
+                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();
+    const cacheBustValue = params.cacheBust ? startedAt : undefined;
+    try {
+        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) {
+            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 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,
+            target: check.target,
+            status,
+            durationMs,
+            httpStatus: response.status,
+            message,
+            ...(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 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) {
+        return {
+            ...cached.summary,
+            cached: true,
+        };
+    }
+    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(),
+        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);
+    }
+}