daiso 1.2.5 → 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/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,7 @@
  * 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';
@@ -245,6 +246,7 @@ const handleRootMcpRequest = async (c) => {
 };
 // Hono 앱 생성
 const app = new Hono();
+app.use('*', diagnosticsMiddleware);
 // CORS 설정
 app.use('*', cors({
     origin: '*',
@@ -257,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/transport.js

@@ -1,3 +1,4 @@
+import { diagnosticHeaders } from '../../utils/diagnostics.js';
 /** 디트릭스 전용 중계 설정과 인증 전송입니다. */
 import { ServiceError } from '../../core/errors.js';
 import { createTimeoutController } from '../../utils/http.js';
@@ -38,6 +39,7 @@ export async function requestDtryxRelay(path, body, options, timeout) {
         throw new ServiceError('DTRYX_RELAY_CONFIG_ERROR', '디트릭스 릴레이 URL, 토큰 및 Access 설정을 확인하세요.', 503, false);
     }
     const headers = {
+        ...diagnosticHeaders(),
         'Content-Type': 'application/json',
         Accept: 'application/json',
         Authorization: `Bearer ${relayToken}`,

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.5",
+  "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": {