daiso 1.0.10 → 1.1.0

package/dist/pages/openapiSpecActions.js

@@ -1,398 +1,8 @@
 /**
  * OpenAI Actions용 축약 OpenAPI 스펙
  */
-import { ACTION_QUERY_ACTIONS } from '../api/actionsProxy.js';
+import { ACTION_QUERY_PARAMETERS } from './openapiSpecActionParameters.js';
 import { OPENAPI_COMPONENTS } from './openapiSpecComponents.js';
-const ACTION_QUERY_PARAMETERS = [
-    {
-        name: 'action',
-        in: 'query',
-        required: true,
-        description: '실행할 액션 이름입니다. 사용 가능한 값은 enum 목록을 참고하세요.',
-        schema: {
-            type: 'string',
-            enum: ACTION_QUERY_ACTIONS,
-        },
-    },
-    {
-        name: 'q',
-        in: 'query',
-        required: false,
-        description: '다이소 제품 검색어',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'query',
-        in: 'query',
-        required: false,
-        description: '세븐일레븐 상품 검색어',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'itemCode',
-        in: 'query',
-        required: false,
-        description: 'GS25 상품 코드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'productId',
-        in: 'query',
-        required: false,
-        description: '제품 ID 또는 상세 조회용 path 파라미터. 상품명만 알면 먼저 daisoSearchProducts 또는 /api/daiso/products로 productId를 확인하세요.',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'keyword',
-        in: 'query',
-        required: false,
-        description: '공통 키워드 파라미터',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'location',
-        in: 'query',
-        required: false,
-        description: '주변 장소 검색 지역/역/주소 키워드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'category',
-        in: 'query',
-        required: false,
-        description: '주변 장소 카테고리(restaurant, cafe, food, dessert, all)',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'services',
-        in: 'query',
-        required: false,
-        description: '통합 비교 서비스 목록(daiso,gs25,seveneleven,emart24)',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'type',
-        in: 'query',
-        required: false,
-        description: '개발자 요청 유형(bug, improvement, feature, docs, other)',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'severity',
-        in: 'query',
-        required: false,
-        description: '개발자 요청 영향도(low, medium, high, critical)',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'title',
-        in: 'query',
-        required: false,
-        description: '개발자 요청 제목',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'description',
-        in: 'query',
-        required: false,
-        description: '개발자 요청 상세 설명',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'toolName',
-        in: 'query',
-        required: false,
-        description: '문제가 발생했거나 개선이 필요한 MCP 도구 이름',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'reproduction',
-        in: 'query',
-        required: false,
-        description: '오류 재현 방법',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'expected',
-        in: 'query',
-        required: false,
-        description: '기대 결과',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'actual',
-        in: 'query',
-        required: false,
-        description: '실제 결과',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'source',
-        in: 'query',
-        required: false,
-        description: '요청 출처(mcp, chatgpt, claude, cli, api, other)',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'sido',
-        in: 'query',
-        required: false,
-        description: '다이소 시/도',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'gugun',
-        in: 'query',
-        required: false,
-        description: '다이소 구/군',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'dong',
-        in: 'query',
-        required: false,
-        description: '다이소 동',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'area',
-        in: 'query',
-        required: false,
-        description: '롯데마트 지역',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'area1',
-        in: 'query',
-        required: false,
-        description: '이마트24 1차 지역',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'area2',
-        in: 'query',
-        required: false,
-        description: '이마트24 2차 지역',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'areaCode',
-        in: 'query',
-        required: false,
-        description: '메가박스 지역 코드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'brandVariant',
-        in: 'query',
-        required: false,
-        description: '롯데마트 브랜드 변형',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'lat',
-        in: 'query',
-        required: false,
-        description: '위도',
-        schema: { type: 'number', format: 'float' },
-    },
-    {
-        name: 'lng',
-        in: 'query',
-        required: false,
-        description: '경도',
-        schema: { type: 'number', format: 'float' },
-    },
-    {
-        name: 'page',
-        in: 'query',
-        required: false,
-        description: '페이지 번호',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'pageIdx',
-        in: 'query',
-        required: false,
-        description: '올리브영 페이지 번호',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'pageLimit',
-        in: 'query',
-        required: false,
-        description: '롯데마트 추가 페이지 수',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'pageSize',
-        in: 'query',
-        required: false,
-        description: '페이지 크기',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'size',
-        in: 'query',
-        required: false,
-        description: '페이지 크기 또는 검색 크기',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'offset',
-        in: 'query',
-        required: false,
-        description: 'CU 검색 오프셋',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'limit',
-        in: 'query',
-        required: false,
-        description: '최대 결과 수',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'storeLimit',
-        in: 'query',
-        required: false,
-        description: '매장 결과 제한 수',
-        schema: { type: 'integer' },
-    },
-    {
-        name: 'storeCode',
-        in: 'query',
-        required: false,
-        description: '매장 코드. 다이소 진열 위치는 /api/daiso/inventory 응답의 storeInventory.stores[].storeCode에서 확인하세요.',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'storeName',
-        in: 'query',
-        required: false,
-        description: '매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'storeKeyword',
-        in: 'query',
-        required: false,
-        description: '매장 키워드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'playDate',
-        in: 'query',
-        required: false,
-        description: '상영일(YYYYMMDD)',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'regionCode',
-        in: 'query',
-        required: false,
-        description: 'CGV 지역 코드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'theaterCode',
-        in: 'query',
-        required: false,
-        description: 'CGV 극장 코드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'theaterId',
-        in: 'query',
-        required: false,
-        description: '메가박스/롯데시네마 지점 ID',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'movieCode',
-        in: 'query',
-        required: false,
-        description: 'CGV 영화 코드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'movieId',
-        in: 'query',
-        required: false,
-        description: '메가박스/롯데시네마 영화 ID',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'pluCd',
-        in: 'query',
-        required: false,
-        description: '이마트24 상품 PLU 코드',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'bizNoArr',
-        in: 'query',
-        required: false,
-        description: '이마트24 사업자번호 목록',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'label',
-        in: 'query',
-        required: false,
-        description: '세븐일레븐 인기 검색어 라벨',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'sort',
-        in: 'query',
-        required: false,
-        description: '정렬 기준',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'searchSort',
-        in: 'query',
-        required: false,
-        description: 'CU 검색 정렬 기준',
-        schema: { type: 'string' },
-    },
-    {
-        name: 'service24h',
-        in: 'query',
-        required: false,
-        description: '이마트24 24시간 필터',
-        schema: { type: 'boolean' },
-    },
-    {
-        name: 'includeSoldOut',
-        in: 'query',
-        required: false,
-        description: '올리브영 품절 포함 여부',
-        schema: { type: 'boolean' },
-    },
-    {
-        name: 'includeIssues',
-        in: 'query',
-        required: false,
-        description: '세븐일레븐 이달의 행사지 포함 여부',
-        schema: { type: 'boolean' },
-    },
-    {
-        name: 'includeExhibition',
-        in: 'query',
-        required: false,
-        description: '세븐일레븐 전시상품 포함 여부',
-        schema: { type: 'boolean' },
-    },
-    {
-        name: 'timeoutMs',
-        in: 'query',
-        required: false,
-        description: '세븐일레븐 inventory 타임아웃',
-        schema: { type: 'integer' },
-    },
-];
 export function generateOpenApiSpec(baseUrl) {
     return {
         openapi: '3.1.0',

package/dist/pages/openapiSpecComponentsLottecinema.js

@@ -49,8 +49,8 @@ export const OPENAPI_LOTTECINEMA_COMPONENT_SCHEMAS = {
             startTime: { type: 'string', example: '10:40' },
             endTime: { type: 'string', example: '12:47' },
             totalSeats: { type: 'integer', example: 32 },
-            bookedSeats: { type: 'integer', example: 28 },
-            remainingSeats: { type: 'integer', example: 4 },
+            bookedSeats: { type: 'integer', example: 4 },
+            remainingSeats: { type: 'integer', example: 28 },
         },
     },
     LotteCinemaTheaterSearchResponse: {

package/dist/pages/openapiSpecPathsDtryx.js

@@ -0,0 +1,148 @@
+/** 디트릭스 공개 API 경로와 응답 스키마입니다. */
+const text = { type: 'string' };
+const integer = { type: 'integer' };
+const cinema = {
+    type: 'object',
+    properties: {
+        brandCode: text,
+        cinemaCode: text,
+        cinemaName: text,
+        region: text,
+        address: text,
+    },
+};
+const movie = {
+    type: 'object',
+    properties: { movieCode: text, movieName: text, rating: text, runningMinutes: integer },
+};
+const showtime = {
+    type: 'object',
+    properties: {
+        scheduleId: text,
+        brandCode: text,
+        cinemaCode: text,
+        cinemaName: text,
+        screenCode: text,
+        screenName: text,
+        movieCode: text,
+        movieName: text,
+        playDate: text,
+        startTime: text,
+        endTime: text,
+        runningMinutes: integer,
+        rating: text,
+        totalSeats: integer,
+        remainingSeats: integer,
+        bookedSeats: integer,
+        planStatus: text,
+    },
+};
+const query = (name, description, schema = text) => ({
+    name,
+    in: 'query',
+    required: false,
+    description,
+    schema,
+});
+const filters = [
+    query('keyword', '극장명 부분 검색'),
+    query('brandCode', '브랜드 코드. 미등록 극장을 조회할 때 cinemaCode와 함께 지정합니다.'),
+];
+const selector = [query('cinemaCode', '극장 코드 (예: 000067)'), ...filters];
+const region = query('region', '광역 지역명. 극장명과 함께 지정하면 두 조건을 모두 적용합니다.');
+const limit = query('limit', '최대 결과 수', { ...integer, minimum: 1, maximum: 200, default: 50 });
+const timeout = query('timeoutMs', '원본 요청 제한 시간(ms)', {
+    ...integer,
+    minimum: 1,
+    maximum: 60000,
+    default: 15000,
+});
+const error = {
+    description: '요청 조건 오류 또는 원본 조회 실패',
+    content: { 'application/json': { schema: { $ref: '#/components/schemas/ErrorResponse' } } },
+};
+function responses(properties) {
+    return {
+        '200': {
+            description: '조회 성공. 일부 극장 조회 실패는 failedCinemas에 표시합니다.',
+            content: {
+                'application/json': {
+                    schema: {
+                        type: 'object',
+                        properties: {
+                            success: { type: 'boolean', const: true },
+                            data: { type: 'object', properties },
+                            meta: { type: 'object', properties: { total: integer, pageSize: integer } },
+                        },
+                    },
+                },
+            },
+        },
+        '400': error,
+        '404': error,
+        '500': error,
+        '503': error,
+    };
+}
+export const OPENAPI_PATHS_DTRYX = {
+    '/api/dtryx/cinemas': {
+        get: {
+            operationId: 'dtryxListCinemas',
+            summary: '디트릭스 독립·예술영화관 목록',
+            description: '확인된 극장 카탈로그를 검색합니다. 전체 제휴 극장 목록이나 실시간 위치 정보는 아닙니다.',
+            parameters: [...filters, region, limit],
+            responses: responses({
+                filters: { type: 'object' },
+                count: integer,
+                cinemas: { type: 'array', items: cinema },
+            }),
+        },
+    },
+    '/api/dtryx/movies': {
+        get: {
+            operationId: 'dtryxListNowShowing',
+            summary: '디트릭스 극장 상영작 조회',
+            description: 'cinemaCode 또는 keyword가 필요합니다. 극장명 검색은 첫 번째 일치 극장을 선택합니다.',
+            parameters: [
+                ...selector,
+                query('includePlayDates', '상영 가능한 날짜 포함', { type: 'boolean', default: false }),
+                timeout,
+            ],
+            responses: responses({
+                cinema,
+                count: integer,
+                movies: { type: 'array', items: movie },
+                playDates: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: { playDate: text, hidden: { type: 'boolean' }, rest: { type: 'boolean' } },
+                    },
+                },
+            }),
+        },
+    },
+    '/api/dtryx/seats': {
+        get: {
+            operationId: 'dtryxGetRemainingSeats',
+            summary: '디트릭스 상영시간표와 잔여 좌석 조회',
+            description: '극장 조건이 없으면 카탈로그 전체를 조회합니다. 일부 실패는 failedCinemas에 표시하고 전체 실패는 503을 반환합니다.',
+            parameters: [
+                ...selector,
+                region,
+                query('movieName', '영화명 부분 일치'),
+                query('playDate', 'YYYYMMDD 또는 YYYY-MM-DD. 기본값은 한국 날짜 기준 오늘입니다.'),
+                limit,
+                timeout,
+            ],
+            responses: responses({
+                playDate: text,
+                filters: { type: 'object' },
+                searchedCinemaCount: integer,
+                failedCinemas: { type: 'array', items: text },
+                count: integer,
+                showtimes: { type: 'array', items: showtime },
+            }),
+        },
+    },
+};

package/dist/pages/openapiSpecPathsLotteMart.js

@@ -29,7 +29,15 @@ export const OPENAPI_PATHS_LOTTEMART = {
                     description: '브랜드 변형 필터',
                     schema: {
                         type: 'string',
-                        enum: ['lottemart', 'toysrus', 'max', 'bottlebunker', 'mealguru', 'grandgrocery', 'other'],
+                        enum: [
+                            'lottemart',
+                            'toysrus',
+                            'max',
+                            'bottlebunker',
+                            'mealguru',
+                            'grandgrocery',
+                            'other',
+                        ],
                     },
                 },
                 {
@@ -123,7 +131,7 @@ export const OPENAPI_PATHS_LOTTEMART = {
                     in: 'query',
                     required: false,
                     description: '요청 제한 시간(ms)',
-                    schema: { type: 'integer', default: 45000, minimum: 1 },
+                    schema: { type: 'integer', default: 15000, minimum: 1 },
                 },
             ],
             responses: {

package/dist/pages/promptRetailCinemaText.js

@@ -2,7 +2,15 @@
  * 프롬프트 리테일/영화 API 섹션
  */
 export function buildPromptRetailCinemaText(baseUrl) {
-    return `### 6-0. 키 없는 통합 상품 가격 후보 비교
+    return `### 디트릭스 독립·예술영화관
+
+- 극장 카탈로그: ${baseUrl}/api/dtryx/cinemas?region=서울
+- 상영작: ${baseUrl}/api/dtryx/movies?keyword=모모&includePlayDates=true
+- 회차와 잔여 좌석: ${baseUrl}/api/dtryx/seats?region=서울
+
+상영작 조회는 cinemaCode 또는 keyword가 필요합니다. 날짜 기본값은 한국 날짜 기준 오늘이며 YYYYMMDD 또는 YYYY-MM-DD를 받습니다. 지역·극장명·브랜드 필터는 함께 적용합니다. 카탈로그는 확인된 22곳이며 전체 제휴 극장이 아닙니다. 일부 실패는 failedCinemas로 표시하고 전체 조회 실패는 오류입니다.
+
+### 6-0. 키 없는 통합 상품 가격 후보 비교
 
 **설명**: 새 외부 API 키 없이 기존 다이소, GS25, 세븐일레븐, 이마트24 상품 검색을 묶어 가격 후보를 비교합니다. 실제 매장 재고와 행사가까지 확정하는 기능이 아니라 "어디가 싸 보이는지"를 빠르게 고르는 1차 검색입니다.
 

package/dist/services/cgv/errors.js

@@ -0,0 +1,12 @@
+/**
+ * CGV 원본 및 대체 전송 경로를 사용할 수 없는 상태
+ */
+export class CgvUpstreamUnavailableError extends Error {
+    constructor() {
+        super('CGV 원본 서비스에 연결할 수 없습니다. 잠시 후 다시 시도해주세요.');
+        this.name = 'CgvUpstreamUnavailableError';
+    }
+}
+export function isCgvUpstreamUnavailableError(error) {
+    return error instanceof CgvUpstreamUnavailableError;
+}

package/dist/services/cgv/transport.js

@@ -6,6 +6,7 @@
 import { createTimeoutController } from '../../utils/http.js';
 import { decodeZyteHttpBody, requestByZyte } from '../../utils/zyte.js';
 import { CGV_API } from './api.js';
+import { CgvUpstreamUnavailableError } from './errors.js';
 function toBase64(bytes) {
     if (typeof Buffer !== 'undefined') {
         return Buffer.from(bytes).toString('base64');
@@ -49,7 +50,11 @@ async function requestByZyteCgv(path, searchParams, timeout, apiKey) {
             { name: 'X-TIMESTAMP', value: timestamp },
             { name: 'X-SIGNATURE', value: signature },
         ],
+        tags: { service: 'cgv' },
     });
+    if (result.statusCode === 401 || result.statusCode === 403) {
+        throw new CgvUpstreamUnavailableError();
+    }
     return decodeZyteHttpBody(result);
 }
 export async function requestCgv(path, searchParams, timeout = 15000, zyteApiKey) {
@@ -71,8 +76,20 @@ export async function requestCgv(path, searchParams, timeout = 15000, zyteApiKey
         if (response.ok) {
             return await parseJsonResponse(response);
         }
-        if (response.status === 403 && zyteApiKey) {
-            return await requestByZyteCgv(path, searchParams, timeout, zyteApiKey);
+        if (response.status === 401 || response.status === 403) {
+            const normalizedZyteApiKey = zyteApiKey?.trim();
+            if (!normalizedZyteApiKey) {
+                throw new CgvUpstreamUnavailableError();
+            }
+            try {
+                return await requestByZyteCgv(path, searchParams, timeout, normalizedZyteApiKey);
+            }
+            catch (fallbackError) {
+                if (fallbackError instanceof CgvUpstreamUnavailableError) {
+                    throw fallbackError;
+                }
+                throw new CgvUpstreamUnavailableError();
+            }
         }
         throw new Error(`CGV API 호출 실패: ${response.status}`);
     }