daiso 1.2.4 → 1.2.6

package/README.md

@@ -85,11 +85,11 @@
 **[실시간 서비스 상태 보기](https://aka-page.betteruptime.com/)**
 
 <!-- WORKERS_INVOCATIONS_CHART:START -->
-<h3>Cloudflare 요청 수 (2026-08-29 ~ 2026-09-27, 30일)</h3>
+<h3>Cloudflare 요청 수 (2026-08-30 ~ 2026-09-28, 30일)</h3>
 
-<img src="./assets/analytics/workers-invocations.png?v=2026-09-27T19:00:02.076Z" alt="Cloudflare 요청 수 그래프 (2026-08-29 ~ 2026-09-27)" width="100%">
+<img src="./assets/analytics/workers-invocations.png?v=2026-09-28T21:15:27.313Z" alt="Cloudflare 요청 수 그래프 (2026-08-30 ~ 2026-09-28)" width="100%">
 
-<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-09-28 04:00 KST</sub>
+<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-09-29 06:15 KST</sub>
 <br><sub>집계: Worker 실행 + 루트 GET 리디렉션 요청 · 사용자 수와 다릅니다.</sub>
 
 </div>

package/dist/api/configStatus.js

@@ -1,3 +1,4 @@
+import { isValidDtryxRelayUrl } from '../services/dtryx/transport.js';
 import { isValidOliveyoungRelayUrl } from '../services/oliveyoung/transport.js';
 function isConfigured(value) {
     return typeof value === 'string' && value.trim().length > 0;
@@ -11,6 +12,18 @@ export function buildConfigStatus(bindings) {
     const accessPairValid = (bindings?.OY_ACCESS_CLIENT_ID === undefined &&
         bindings?.OY_ACCESS_CLIENT_SECRET === undefined) ||
         accessConfigured;
+    const dtryxId = isConfigured(bindings?.DTRYX_ACCESS_CLIENT_ID);
+    const dtryxSecret = isConfigured(bindings?.DTRYX_ACCESS_CLIENT_SECRET);
+    const dtryx = {
+        urlValid: isValidDtryxRelayUrl(bindings?.DTRYX_RELAY_URL),
+        tokenConfigured: isConfigured(bindings?.DTRYX_RELAY_TOKEN),
+        accessClientIdConfigured: dtryxId,
+        accessClientSecretConfigured: dtryxSecret,
+        accessConfigured: dtryxId && dtryxSecret,
+        accessPairValid: (bindings?.DTRYX_ACCESS_CLIENT_ID === undefined &&
+            bindings?.DTRYX_ACCESS_CLIENT_SECRET === undefined) ||
+            (dtryxId && dtryxSecret),
+    };
     return {
         oliveyoungRelay: {
             configured: urlValid && tokenConfigured && accessPairValid,
@@ -23,6 +36,17 @@ export function buildConfigStatus(bindings) {
             accessPairValid,
             usedBy: ['oliveyoung'],
         },
+        dtryxRelay: {
+            configured: dtryx.urlValid && dtryx.tokenConfigured && dtryx.accessPairValid,
+            urlConfigured: isConfigured(bindings?.DTRYX_RELAY_URL),
+            urlValid: dtryx.urlValid,
+            tokenConfigured: dtryx.tokenConfigured,
+            accessClientIdConfigured: dtryx.accessClientIdConfigured,
+            accessClientSecretConfigured: dtryx.accessClientSecretConfigured,
+            accessConfigured: dtryx.accessConfigured,
+            accessPairValid: dtryx.accessPairValid,
+            usedBy: ['dtryx'],
+        },
         googleMapsApiKey: {
             configured: isConfigured(bindings?.GOOGLE_MAPS_API_KEY),
             usedBy: ['gs25', 'cu', 'lottemart', 'megabox', 'lottecinema', 'cgv'],

package/dist/api/dtryxHandlers.js

@@ -1,10 +1,12 @@
 /**
  * 디트릭스 GET API 핸들러
  */
+import { ServiceError } from '../core/errors.js';
+import { dtryxTransportFromBindings } from '../services/dtryx/transport.js';
 import { resolveDtryxCinemas } from '../services/dtryx/location.js';
 import { DTRYX_INVALID_INPUT, hasInvalidDtryxOptions } from '../services/dtryx/validation.js';
 import { fetchDtryxNowShowing, fetchDtryxPlayDates, fetchDtryxTimetable, toYyyymmdd, } from '../services/dtryx/client.js';
-import { errorResponse, successResponse } from './response.js';
+import { errorResponse, serviceErrorResponse, successResponse, } from './response.js';
 export async function handleDtryxListCinemas(c) {
     const keyword = c.req.query('keyword') || undefined;
     const region = c.req.query('region') || undefined;
@@ -45,8 +47,10 @@ export async function handleDtryxListNowShowing(c) {
             timeout: timeoutMs,
         };
         const [movies, playDates] = await Promise.all([
-            fetchDtryxNowShowing(request),
-            includePlayDates ? fetchDtryxPlayDates(request) : Promise.resolve([]),
+            fetchDtryxNowShowing(request, dtryxTransportFromBindings(c.env)),
+            includePlayDates
+                ? fetchDtryxPlayDates(request, dtryxTransportFromBindings(c.env))
+                : Promise.resolve([]),
         ]);
         return successResponse(c, {
             cinema,
@@ -56,6 +60,8 @@ export async function handleDtryxListNowShowing(c) {
         }, { total: movies.length });
     }
     catch (error) {
+        if (error instanceof ServiceError)
+            return serviceErrorResponse(c, error, 'now_showing');
         const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
         return errorResponse(c, 'DTRYX_NOW_SHOWING_FAILED', message, 500);
     }
@@ -82,7 +88,7 @@ export async function handleDtryxGetRemainingSeats(c) {
         cinemaCode: cinema.cinemaCode,
         playDate,
         timeout: timeoutMs,
-    })));
+    }, dtryxTransportFromBindings(c.env))));
     const failedCinemas = cinemas
         .filter((_, index) => settled[index]?.status === 'rejected')
         .map((cinema) => cinema.cinemaName || cinema.cinemaCode);

package/dist/api/routes/oliveyoungRoutes.js

@@ -1,22 +1,23 @@
 /**
  * 올리브영 GET API 라우트 등록
  */
+import { oliveyoungCacheKey } from '../../utils/oliveyoungCacheKey.js';
 import { withEdgeCache } from '../../utils/cache.js';
 import { handleOliveyoungFindStores, handleOliveyoungCheckInventory, handleOliveyoungSearchProducts, } from '../handlers.js';
 export function registerOliveyoungRoutes(app) {
-    app.get('/api/oliveyoung/products', async (c) => withEdgeCache(c.req.url, {
+    app.get('/api/oliveyoung/products', async (c) => withEdgeCache(oliveyoungCacheKey(c.req.url), {
         ttlSeconds: 60 * 5,
         staleWhileRevalidateSeconds: 60,
-        keyPrefix: 'oliveyoung-products-v1',
+        keyPrefix: 'oliveyoung-products-v2',
     }, () => handleOliveyoungSearchProducts(c)));
-    app.get('/api/oliveyoung/stores', async (c) => withEdgeCache(c.req.url, {
+    app.get('/api/oliveyoung/stores', async (c) => withEdgeCache(oliveyoungCacheKey(c.req.url), {
         ttlSeconds: 60 * 60 * 24,
         staleWhileRevalidateSeconds: 60 * 5,
-        keyPrefix: 'oliveyoung-stores-v1',
+        keyPrefix: 'oliveyoung-stores-v2',
     }, () => handleOliveyoungFindStores(c)));
-    app.get('/api/oliveyoung/inventory', async (c) => withEdgeCache(c.req.url, {
+    app.get('/api/oliveyoung/inventory', async (c) => withEdgeCache(oliveyoungCacheKey(c.req.url), {
         ttlSeconds: 60 * 10,
         staleWhileRevalidateSeconds: 60,
-        keyPrefix: 'oliveyoung-inventory-v1',
+        keyPrefix: 'oliveyoung-inventory-v2',
     }, () => handleOliveyoungCheckInventory(c)));
 }

package/dist/core/registry.js

@@ -3,6 +3,7 @@
  *
  * 서비스 프로바이더를 등록하고 MCP 서버에 도구를 연결합니다.
  */
+import { diagnosticEvent } from '../utils/diagnostics.js';
 import { getErrorMessage, ServiceError, toServiceErrorDiagnostics } from './errors.js';
 import { createToolOutputSchema } from './outputSchema.js';
 function parseJsonText(text) {
@@ -172,11 +173,13 @@ export class ServiceRegistry {
             outputSchema: createToolOutputSchema(tool.name, tool.metadata.outputSchema),
         };
         server.registerTool(tool.name, metadata, async (args) => {
+            const started = Date.now();
             let result;
             try {
                 result = await tool.handler(args);
             }
             catch (error) {
+                diagnosticEvent({ stage: 'tool', operation: tool.name, outcome: 'error', durationMs: Date.now() - started });
                 const message = error instanceof ServiceError
                     ? JSON.stringify({
                         error: { code: error.code, message: error.message },
@@ -188,6 +191,7 @@ export class ServiceRegistry {
                     content: [{ type: 'text', text: message }],
                 };
             }
+            diagnosticEvent({ stage: 'tool', operation: tool.name, outcome: result.isError ? 'error' : 'ok', durationMs: Date.now() - started });
             const content = result.content.map((item) => ({
                 type: item.type,
                 text: item.text,

package/dist/index.js

@@ -4,6 +4,8 @@
  * Cloudflare Workers에서 실행되는 플러그인 기반 MCP 서버입니다.
  * 다이소, 편의점, 백화점 등 다양한 서비스를 확장할 수 있습니다.
  */
+import { diagnosticsMiddleware } from './middleware/diagnostics.js';
+import { dtryxTransportFromBindings } from './services/dtryx/transport.js';
 import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -76,7 +78,7 @@ const createRegistry = (bindings) => {
             zyteApiKey: bindings?.ZYTE_API_KEY,
         }),
         createMegaboxService,
-        createDtryxService,
+        () => createDtryxService(dtryxTransportFromBindings(bindings)),
         () => createLotteCinemaService({
             googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
         }),
@@ -244,6 +246,7 @@ const handleRootMcpRequest = async (c) => {
 };
 // Hono 앱 생성
 const app = new Hono();
+app.use('*', diagnosticsMiddleware);
 // CORS 설정
 app.use('*', cors({
     origin: '*',
@@ -256,7 +259,7 @@ app.use('*', cors({
         'Last-Event-ID',
         'mcp-protocol-version',
     ],
-    exposeHeaders: ['mcp-session-id', 'mcp-protocol-version'],
+    exposeHeaders: ['mcp-session-id', 'mcp-protocol-version', 'x-request-id'],
 }));
 // Zyte 연동 공개 GET API의 일일 호출량을 IP별로 제한합니다.
 app.use('/api/*', createDailyRateLimitMiddleware());

package/dist/middleware/diagnostics.js

@@ -0,0 +1,17 @@
+import { withDiagnostics, diagnosticEvent, diagnosticHeaders, diagnosticOperation, } from '../utils/diagnostics.js';
+export const diagnosticsMiddleware = async (c, next) => withDiagnostics(async () => {
+    const start = performance.now();
+    try {
+        await next();
+    }
+    finally {
+        c.header('x-request-id', diagnosticHeaders()['x-request-id']);
+        diagnosticEvent({
+            stage: 'request',
+            operation: diagnosticOperation(c.req.url),
+            outcome: c.error || c.res.status >= 400 ? 'error' : 'ok',
+            status: c.res.status,
+            durationMs: performance.now() - start,
+        });
+    }
+});

package/dist/services/dtryx/client.js

@@ -3,6 +3,7 @@
  */
 import { formatTime, toNumber, toYyyymmdd } from '../../utils/format.js';
 import { createTimeoutController } from '../../utils/http.js';
+import { hasDtryxRelayOptions, requestDtryxRelay, } from './transport.js';
 import { DTRYX_API } from './api.js';
 const DEFAULT_TIMEOUT_MS = 15000;
 /**
@@ -65,14 +66,20 @@ function buildScheduleId(cinemaCode, playDate, screenCode, showSeq) {
     return `${playDate}-${cinemaCode}-${screenCode}-${showSeq}`;
 }
 /** 상영 회차와 좌석 현황을 조회합니다. */
-export async function fetchDtryxTimetable(params) {
+export async function fetchDtryxTimetable(params, options = {}) {
     const playDate = params.playDate || toYyyymmdd();
-    const response = await requestDtryx(DTRYX_API.ENDPOINTS.TIMETABLE_LIST, DTRYX_API.WORK_GUIDS.TIMETABLE_LIST, {
-        BrandCd: params.brandCode,
-        CinemaCd: params.cinemaCode,
-        PlaySDT: toDashedDate(playDate),
-        ImgSize: 'small',
-    }, params.timeout);
+    const response = hasDtryxRelayOptions(options)
+        ? await requestDtryxRelay('timetable', {
+            brandCode: params.brandCode,
+            cinemaCode: params.cinemaCode,
+            playDate: toCompactDate(playDate),
+        }, options, params.timeout ?? DEFAULT_TIMEOUT_MS)
+        : await requestDtryx(DTRYX_API.ENDPOINTS.TIMETABLE_LIST, DTRYX_API.WORK_GUIDS.TIMETABLE_LIST, {
+            BrandCd: params.brandCode,
+            CinemaCd: params.cinemaCode,
+            PlaySDT: toDashedDate(playDate),
+            ImgSize: 'small',
+        }, params.timeout);
     return response.Recordset.filter((item) => item.CinemaCd && item.MovieCd && item.ScreenCd).map((item) => {
         const totalSeats = toNumber(item.TotalSeatCnt);
         const remainingSeats = toNumber(item.RemainSeatCnt);
@@ -102,12 +109,14 @@ export async function fetchDtryxTimetable(params) {
     });
 }
 /** 예매 가능한 상영 날짜를 조회합니다. */
-export async function fetchDtryxPlayDates(params) {
-    const response = await requestDtryx(DTRYX_API.ENDPOINTS.PLAY_DATE_LIST, DTRYX_API.WORK_GUIDS.PLAY_DATE_LIST, {
-        BrandCd: params.brandCode,
-        CinemaCd: params.cinemaCode,
-        MovieCd: '',
-    }, params.timeout);
+export async function fetchDtryxPlayDates(params, options = {}) {
+    const response = hasDtryxRelayOptions(options)
+        ? await requestDtryxRelay('play-dates', { brandCode: params.brandCode, cinemaCode: params.cinemaCode }, options, params.timeout ?? DEFAULT_TIMEOUT_MS)
+        : await requestDtryx(DTRYX_API.ENDPOINTS.PLAY_DATE_LIST, DTRYX_API.WORK_GUIDS.PLAY_DATE_LIST, {
+            BrandCd: params.brandCode,
+            CinemaCd: params.cinemaCode,
+            MovieCd: '',
+        }, params.timeout);
     return response.Recordset.filter((item) => item.PlaySDT).map((item) => ({
         playDate: toCompactDate(item.PlaySDT),
         hidden: item.HiddenYn === 'Y',
@@ -115,12 +124,14 @@ export async function fetchDtryxPlayDates(params) {
     }));
 }
 /** 현재 상영작 목록을 조회합니다. */
-export async function fetchDtryxNowShowing(params) {
-    const response = await requestDtryx(DTRYX_API.ENDPOINTS.MOVIE_NOW, DTRYX_API.WORK_GUIDS.MOVIE_NOW, {
-        BrandCd: params.brandCode,
-        CinemaCd: params.cinemaCode,
-        ImgSize: 'small',
-    }, params.timeout);
+export async function fetchDtryxNowShowing(params, options = {}) {
+    const response = hasDtryxRelayOptions(options)
+        ? await requestDtryxRelay('movies', { brandCode: params.brandCode, cinemaCode: params.cinemaCode }, options, params.timeout ?? DEFAULT_TIMEOUT_MS)
+        : await requestDtryx(DTRYX_API.ENDPOINTS.MOVIE_NOW, DTRYX_API.WORK_GUIDS.MOVIE_NOW, {
+            BrandCd: params.brandCode,
+            CinemaCd: params.cinemaCode,
+            ImgSize: 'small',
+        }, params.timeout);
     return response.Recordset.filter((item) => item.MovieCd && item.MovieNm).map((item) => ({
         movieCode: String(item.MovieCd),
         movieName: item.MovieNm,

package/dist/services/dtryx/index.js

@@ -13,12 +13,20 @@ const DTRYX_METADATA = {
     description: '디트릭스 예매 플랫폼 기반 독립·예술영화관 목록, 상영작, 상영시간표·잔여 좌석 조회 서비스',
 };
 class DtryxService {
+    options;
     metadata = DTRYX_METADATA;
+    constructor(options) {
+        this.options = options;
+    }
     getTools() {
-        return [createListCinemasTool(), createListNowShowingTool(), createGetRemainingSeatsTool()];
+        return [
+            createListCinemasTool(),
+            createListNowShowingTool(this.options),
+            createGetRemainingSeatsTool(this.options),
+        ];
     }
 }
-export function createDtryxService() {
-    return new DtryxService();
+export function createDtryxService(options = {}) {
+    return new DtryxService(options);
 }
 export * from './types.js';

package/dist/services/dtryx/tools/getRemainingSeats.js

@@ -12,7 +12,7 @@ function matchesMovie(showtime, movieName) {
     const normalize = (value) => value.replace(/\s+/g, '').toLowerCase();
     return normalize(showtime.movieName).includes(normalize(movieName));
 }
-async function getRemainingSeats(args) {
+async function getRemainingSeats(args, options) {
     if (hasInvalidDtryxOptions(args)) {
         return { isError: true, content: [{ type: 'text', text: DTRYX_INVALID_INPUT }] };
     }
@@ -37,7 +37,7 @@ async function getRemainingSeats(args) {
         cinemaCode: cinema.cinemaCode,
         playDate,
         timeout: timeoutMs,
-    })));
+    }, options)));
     const failedCinemas = cinemas
         .filter((_, index) => settled[index]?.status === 'rejected')
         .map((cinema) => cinema.cinemaName || cinema.cinemaCode);
@@ -84,7 +84,7 @@ async function getRemainingSeats(args) {
         ],
     };
 }
-export function createGetRemainingSeatsTool() {
+export function createGetRemainingSeatsTool(options = {}) {
     return {
         name: 'dtryx_get_remaining_seats',
         metadata: {
@@ -112,6 +112,6 @@ export function createGetRemainingSeatsTool() {
                     .describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: ((args) => getRemainingSeats(args)),
+        handler: ((args) => getRemainingSeats(args, options)),
     };
 }

package/dist/services/dtryx/tools/listNowShowing.js

@@ -5,7 +5,7 @@ import * as z from 'zod';
 import { DTRYX_INVALID_INPUT, hasInvalidDtryxOptions, dtryxTimeoutSchema } from '../validation.js';
 import { resolveDtryxCinemas } from '../location.js';
 import { fetchDtryxNowShowing, fetchDtryxPlayDates } from '../client.js';
-async function listNowShowing(args) {
+async function listNowShowing(args, options) {
     if (hasInvalidDtryxOptions(args)) {
         return { isError: true, content: [{ type: 'text', text: DTRYX_INVALID_INPUT }] };
     }
@@ -31,8 +31,8 @@ async function listNowShowing(args) {
         timeout: timeoutMs,
     };
     const [movies, playDates] = await Promise.all([
-        fetchDtryxNowShowing(request),
-        includePlayDates ? fetchDtryxPlayDates(request) : Promise.resolve([]),
+        fetchDtryxNowShowing(request, options),
+        includePlayDates ? fetchDtryxPlayDates(request, options) : Promise.resolve([]),
     ]);
     return {
         content: [
@@ -48,7 +48,7 @@ async function listNowShowing(args) {
         ],
     };
 }
-export function createListNowShowingTool() {
+export function createListNowShowingTool(options = {}) {
     return {
         name: 'dtryx_list_now_showing',
         metadata: {
@@ -72,6 +72,6 @@ export function createListNowShowingTool() {
                     .describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: ((args) => listNowShowing(args)),
+        handler: ((args) => listNowShowing(args, options)),
     };
 }

package/dist/services/dtryx/transport.js

@@ -0,0 +1,91 @@
+import { diagnosticHeaders } from '../../utils/diagnostics.js';
+/** 디트릭스 전용 중계 설정과 인증 전송입니다. */
+import { ServiceError } from '../../core/errors.js';
+import { createTimeoutController } from '../../utils/http.js';
+export function isValidDtryxRelayUrl(value) {
+    if (!value?.trim())
+        return false;
+    try {
+        const url = new URL(value);
+        return (!url.username &&
+            !url.password &&
+            !url.search &&
+            !url.hash &&
+            (url.protocol === 'https:' ||
+                (url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))));
+    }
+    catch {
+        return false;
+    }
+}
+/** 바인딩은 요청마다 변환하며 프로세스 전역에 저장하지 않습니다. */
+export function dtryxTransportFromBindings(bindings) {
+    return {
+        relayUrl: bindings?.DTRYX_RELAY_URL,
+        relayToken: bindings?.DTRYX_RELAY_TOKEN,
+        accessClientId: bindings?.DTRYX_ACCESS_CLIENT_ID,
+        accessClientSecret: bindings?.DTRYX_ACCESS_CLIENT_SECRET,
+    };
+}
+export function hasDtryxRelayOptions(options) {
+    return Object.values(options).some((value) => value !== undefined);
+}
+export async function requestDtryxRelay(path, body, options, timeout) {
+    const { relayUrl, relayToken, accessClientId, accessClientSecret } = options;
+    const accessPresent = accessClientId !== undefined || accessClientSecret !== undefined;
+    if (!isValidDtryxRelayUrl(relayUrl) ||
+        !relayToken?.trim() ||
+        (accessPresent && (!accessClientId?.trim() || !accessClientSecret?.trim()))) {
+        throw new ServiceError('DTRYX_RELAY_CONFIG_ERROR', '디트릭스 릴레이 URL, 토큰 및 Access 설정을 확인하세요.', 503, false);
+    }
+    const headers = {
+        ...diagnosticHeaders(),
+        'Content-Type': 'application/json',
+        Accept: 'application/json',
+        Authorization: `Bearer ${relayToken}`,
+    };
+    if (accessPresent) {
+        headers['CF-Access-Client-Id'] = accessClientId;
+        headers['CF-Access-Client-Secret'] = accessClientSecret;
+    }
+    const { controller, timeoutId } = createTimeoutController(timeout);
+    try {
+        // 리다이렉트를 따라 인증 정보를 다른 호스트에 전달하지 않습니다.
+        const response = await fetch(`${relayUrl.replace(/\/$/, '')}/v1/dtryx/${path}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            redirect: 'manual',
+            signal: controller.signal,
+        });
+        if (response.status !== 200) {
+            void response.body?.cancel().catch(() => { });
+            const status = response.status;
+            const mapped = status === 429 || status === 503 || status === 504 ? status : 502;
+            throw new ServiceError('DTRYX_RELAY_FAILED', '디트릭스 릴레이 요청에 실패했습니다.', mapped, status === 429 || status >= 500, status);
+        }
+        const result = await response.json();
+        if (typeof result !== 'object' ||
+            result === null ||
+            !('RetCode' in result) ||
+            result.RetCode !== 'success' ||
+            !('Recordset' in result) ||
+            !Array.isArray(result.Recordset) ||
+            !result.Recordset.every((item) => typeof item === 'object' && item !== null && !Array.isArray(item))) {
+            throw new Error('응답 형식 오류');
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ServiceError)
+            throw error;
+        if (controller.signal.aborted) {
+            throw new ServiceError('DTRYX_RELAY_TIMEOUT', '디트릭스 릴레이 요청 시간이 초과되었습니다.', 504, true);
+        }
+        throw new ServiceError('DTRYX_RELAY_FAILED', '디트릭스 릴레이 요청에 실패했습니다.', 502, true);
+    }
+    finally {
+        clearTimeout(timeoutId);
+        controller.abort();
+    }
+}

package/dist/services/oliveyoung/transport.js

@@ -1,3 +1,4 @@
+import { diagnosticHeaders } from '../../utils/diagnostics.js';
 /** 올리브영 무료 직접 요청 및 운영자가 설정한 브라우저 릴레이 전송. */
 import { fetchJson } from '../../utils/http.js';
 import { toOliveyoungRelayError } from './errors.js';
@@ -35,6 +36,7 @@ export async function requestOliveyoung(path, body, options = {}) {
         if (!relayToken?.trim())
             throw new Error('OY_RELAY_TOKEN이 필요합니다.');
         url = `${relayUrl.replace(/\/$/, '')}/v1/oliveyoung/${path.split('/').pop()}`;
+        Object.assign(headers, diagnosticHeaders());
         headers.Authorization = `Bearer ${relayToken}`;
         const { accessClientId, accessClientSecret } = options;
         if (accessClientId !== undefined || accessClientSecret !== undefined) {

package/dist/utils/diagnostics.js

@@ -0,0 +1,76 @@
+/** 비밀값과 원문 없이 요청 경계를 연결하는 진단 컨텍스트입니다. */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const context = new AsyncLocalStorage();
+export function withDiagnostics(work) {
+    if (context.getStore())
+        return work();
+    return context.run({ requestId: crypto.randomUUID(), sampled: Math.random() < 0.01, events: 0 }, work);
+}
+export function diagnosticHeaders() {
+    const current = context.getStore();
+    return current ? { 'x-request-id': current.requestId } : {};
+}
+export function diagnosticEvent(event) {
+    const current = context.getStore();
+    // 요청당 상한으로 재시도/팬아웃 로그가 무한히 늘어나지 않게 합니다.
+    if (!current || (event.outcome === 'ok' && !current.sampled) || current.events >= 32)
+        return;
+    current.events++;
+    console.error(JSON.stringify({
+        event: 'diagnostic',
+        time: new Date().toISOString(),
+        requestId: current.requestId,
+        stage: event.stage,
+        outcome: event.outcome,
+        operation: event.operation,
+        status: event.status,
+        durationMs: event.durationMs,
+    }));
+}
+const services = new Set([
+    'daiso',
+    'oliveyoung',
+    'dtryx',
+    'gs25',
+    'cu',
+    'seveneleven',
+    'emart24',
+    'lottemart',
+    'cgv',
+    'megabox',
+    'lottecinema',
+    'opinet',
+    'places',
+    'compare',
+    'feedback',
+    'health',
+    'rate-limit',
+    'actions',
+]);
+const operations = new Set([
+    'products',
+    'stores',
+    'inventory',
+    'movies',
+    'theaters',
+    'timetable',
+    'play-dates',
+    'seats',
+    'remaining-seats',
+    'average',
+    'lowest',
+    'requests',
+    'checks',
+    'stats',
+    'query',
+    'popwords',
+    'price',
+]);
+export function diagnosticOperation(url) {
+    const parts = new URL(url).pathname.split('/');
+    if (parts[1] === 'mcp')
+        return 'mcp';
+    if (parts[1] === 'api' && services.has(parts[2]) && operations.has(parts[3]))
+        return `${parts[2]}.${parts[3]}`;
+    return 'other';
+}

package/dist/utils/http.js

@@ -1,6 +1,4 @@
-/**
- * 공용 HTTP 유틸리티
- */
+import { diagnosticEvent } from './diagnostics.js';
 export class HttpError extends Error {
     status;
     statusText;
@@ -73,11 +71,15 @@ async function requestWithTimeout(url, options, readResponse) {
     for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
         const { controller, timeoutId } = createTimeoutController(timeout);
         let readingResponse = false;
+        const started = Date.now();
+        let responseStatus;
         try {
             const response = await fetch(url, {
                 ...restOptions,
                 signal: controller.signal,
             });
+            responseStatus = response.status;
+            diagnosticEvent({ stage: 'http', outcome: response.ok ? 'ok' : 'error', status: response.status, durationMs: Date.now() - started });
             if (retryAllowed &&
                 attempt < maxAttempts &&
                 isRetryableStatus(response.status, retryStatusCodes)) {
@@ -99,6 +101,7 @@ async function requestWithTimeout(url, options, readResponse) {
             return await readResponse(response);
         }
         catch (error) {
+            diagnosticEvent({ stage: 'http', outcome: 'error', status: responseStatus, durationMs: Date.now() - started });
             if (readingResponse || !retryAllowed || attempt >= maxAttempts) {
                 throw error;
             }

package/dist/utils/oliveyoungCacheKey.js

@@ -0,0 +1,28 @@
+/** 핸들러가 읽는 query만 캐시 키에 포함하고 동일한 기본값을 합칩니다. */
+const product = { keyword: '', page: '1', size: '20', sort: '01', includeSoldOut: 'false' };
+const location = { lat: '37.5665', lng: '126.978' };
+const defaults = {
+    '/api/oliveyoung/products': product,
+    '/api/oliveyoung/stores': { keyword: '', ...location, pageIdx: '1', limit: '20' },
+    '/api/oliveyoung/inventory': {
+        ...product,
+        ...location,
+        storeKeyword: '',
+        storeLimit: '10',
+        stockCheckLimit: '5',
+    },
+};
+export function oliveyoungCacheKey(input) {
+    const url = new URL(input);
+    const values = defaults[url.pathname];
+    if (!values)
+        return input;
+    const key = new URL(url.origin + url.pathname);
+    for (const [name, fallback] of Object.entries({ ...values, timeoutMs: '15000' })) {
+        key.searchParams.set(name, url.searchParams.get(name) || fallback);
+    }
+    const fresh = url.searchParams.get('_healthCheck');
+    if (fresh !== null)
+        key.searchParams.set('_healthCheck', fresh);
+    return key.toString();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "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": {