daiso 1.0.4 → 1.0.5

package/dist/cli/commands/convenience.js

@@ -0,0 +1,241 @@
+/**
+ * 편의점 및 기타 서비스 CLI 명령 핸들러
+ * (CU, 이마트24, 롯데마트, GS25, 세븐일레븐, 롯데시네마)
+ */
+import { printCommandHelp } from '../../cliHelp.js';
+import { parseCliArgs, toUrl, applyOptionsToQuery, toQueryOptions } from '../args.js';
+import { requestAndPrintResponse } from '../http.js';
+export async function handleCuStores(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('cu-stores', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/cu/stores');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'cu-stores', parsed.options.json === 'true');
+}
+export async function handleCuInventory(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('cu-inventory', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (!keyword) {
+        deps.writeErr('cu-inventory 명령은 검색어가 필요합니다. 예: daiso cu-inventory 과자');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/cu/inventory');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'cu-inventory', parsed.options.json === 'true');
+}
+export async function handleEmart24Stores(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('emart24-stores', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/emart24/stores');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'emart24-stores', parsed.options.json === 'true');
+}
+export async function handleEmart24Products(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('emart24-products', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (!keyword) {
+        deps.writeErr('emart24-products 명령은 검색어가 필요합니다. 예: daiso emart24-products 두바이');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/emart24/products');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'emart24-products', parsed.options.json === 'true');
+}
+export async function handleEmart24Inventory(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('emart24-inventory', deps.writeOut, deps.writeErr);
+    }
+    const pluCd = parsed.positionals[0];
+    const bizNoArr = parsed.options.bizNoArr;
+    if (!pluCd || !bizNoArr) {
+        deps.writeErr('emart24-inventory 명령은 pluCd와 --bizNoArr가 필요합니다. 예: daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/emart24/inventory');
+    targetUrl.searchParams.set('pluCd', pluCd);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'emart24-inventory', parsed.options.json === 'true');
+}
+export async function handleLotteMartStores(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('lottemart-stores', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/lottemart/stores');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'lottemart-stores', parsed.options.json === 'true');
+}
+export async function handleLotteMartProducts(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('lottemart-products', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (!keyword) {
+        deps.writeErr('lottemart-products 명령은 검색어가 필요합니다. 예: daiso lottemart-products 콜라 --storeName 강변점');
+        return 1;
+    }
+    if (!parsed.options.storeCode && !parsed.options.storeName) {
+        deps.writeErr('lottemart-products 명령은 --storeCode 또는 --storeName이 필요합니다. 예: daiso lottemart-products 콜라 --storeName 강변점');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/lottemart/products');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'lottemart-products', parsed.options.json === 'true');
+}
+export async function handleGs25Stores(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('gs25-stores', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/gs25/stores');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'gs25-stores', parsed.options.json === 'true');
+}
+export async function handleGs25Products(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('gs25-products', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (!keyword) {
+        deps.writeErr('gs25-products 명령은 검색어가 필요합니다. 예: daiso gs25-products 오감자');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/gs25/products');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'gs25-products', parsed.options.json === 'true');
+}
+export async function handleGs25Inventory(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('gs25-inventory', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (!keyword) {
+        deps.writeErr('gs25-inventory 명령은 검색어가 필요합니다. 예: daiso gs25-inventory 오감자');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/gs25/inventory');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'gs25-inventory', parsed.options.json === 'true');
+}
+export async function handleSevenElevenProducts(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('seveneleven-products', deps.writeOut, deps.writeErr);
+    }
+    const query = parsed.positionals[0];
+    if (!query) {
+        deps.writeErr('seveneleven-products 명령은 검색어가 필요합니다. 예: daiso seveneleven-products 삼각김밥');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/seveneleven/products');
+    targetUrl.searchParams.set('query', query);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'seveneleven-products', parsed.options.json === 'true');
+}
+export async function handleSevenElevenStores(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('seveneleven-stores', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (!keyword) {
+        deps.writeErr('seveneleven-stores 명령은 검색어가 필요합니다. 예: daiso seveneleven-stores 안산 중앙역');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/seveneleven/stores');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'seveneleven-stores', parsed.options.json === 'true');
+}
+export async function handleSevenElevenPopwords(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('seveneleven-popwords', deps.writeOut, deps.writeErr);
+    }
+    const targetUrl = toUrl('/api/seveneleven/popwords');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'seveneleven-popwords', parsed.options.json === 'true');
+}
+export async function handleSevenElevenCatalog(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('seveneleven-catalog', deps.writeOut, deps.writeErr);
+    }
+    const targetUrl = toUrl('/api/seveneleven/catalog');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'seveneleven-catalog', parsed.options.json === 'true');
+}
+export async function handleLottecinemaTheaters(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('lottecinema-theaters', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/lottecinema/theaters');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'lottecinema-theaters', parsed.options.json === 'true');
+}
+export async function handleLottecinemaMovies(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('lottecinema-movies', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/lottecinema/movies');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'lottecinema-movies', parsed.options.json === 'true');
+}
+export async function handleLottecinemaSeats(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('lottecinema-seats', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    const targetUrl = toUrl('/api/lottecinema/seats');
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'lottecinema-seats', parsed.options.json === 'true');
+}

package/dist/cli/commands/daiso.js

@@ -0,0 +1,96 @@
+/**
+ * 다이소 관련 CLI 명령 핸들러
+ */
+import { printCommandHelp } from '../../cliHelp.js';
+import { parseCliArgs, toUrl, applyOptionsToQuery, toQueryOptions } from '../args.js';
+import { requestAndPrintResponse, requestAndPrintStoresWithKeywordFallback } from '../http.js';
+export async function handleGet(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('get', deps.writeOut, deps.writeErr);
+    }
+    const targetPath = parsed.positionals[0];
+    if (!targetPath) {
+        deps.writeErr('get 명령은 경로가 필요합니다. 예: daiso get /api/daiso/products --q 수납박스');
+        return 1;
+    }
+    const targetUrl = toUrl(targetPath);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'get', parsed.options.json === 'true');
+}
+export async function handleProducts(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('products', deps.writeOut, deps.writeErr);
+    }
+    const query = parsed.positionals[0];
+    if (!query) {
+        deps.writeErr('products 명령은 검색어가 필요합니다. 예: daiso products 수납박스');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/daiso/products');
+    targetUrl.searchParams.set('q', query);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'products', parsed.options.json === 'true');
+}
+export async function handleProduct(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('product', deps.writeOut, deps.writeErr);
+    }
+    const productId = parsed.positionals[0];
+    if (!productId) {
+        deps.writeErr('product 명령은 제품 ID가 필요합니다. 예: daiso product 1034604');
+        return 1;
+    }
+    const targetUrl = toUrl(`/api/daiso/products/${productId}`);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'product', parsed.options.json === 'true');
+}
+export async function handleStores(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('stores', deps.writeOut, deps.writeErr);
+    }
+    const keyword = parsed.positionals[0];
+    if (keyword) {
+        parsed.options.keyword = keyword;
+    }
+    if (!parsed.options.keyword && !parsed.options.sido) {
+        deps.writeErr('stores 명령은 keyword 또는 --sido가 필요합니다. 예: daiso stores 강남역 / daiso stores --sido 서울');
+        return 1;
+    }
+    return await requestAndPrintStoresWithKeywordFallback(deps.fetchImpl, deps.writeOut, deps.writeErr, toQueryOptions(parsed.options), parsed.options.json === 'true');
+}
+export async function handleInventory(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('inventory', deps.writeOut, deps.writeErr);
+    }
+    const productId = parsed.positionals[0];
+    if (!productId) {
+        deps.writeErr('inventory 명령은 제품 ID가 필요합니다. 예: daiso inventory 1034604 --keyword 강남역');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/daiso/inventory');
+    targetUrl.searchParams.set('productId', productId);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'inventory', parsed.options.json === 'true');
+}
+export async function handleDisplayLocation(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('display-location', deps.writeOut, deps.writeErr);
+    }
+    const productId = parsed.positionals[0];
+    const storeCode = parsed.positionals[1];
+    if (!productId || !storeCode) {
+        deps.writeErr('display-location 명령은 productId와 storeCode가 필요합니다. 예: daiso display-location 1034604 04515');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/daiso/display-location');
+    targetUrl.searchParams.set('productId', productId);
+    targetUrl.searchParams.set('storeCode', storeCode);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'display-location', parsed.options.json === 'true');
+}

package/dist/cli/constants.js

@@ -0,0 +1,5 @@
+/**
+ * CLI 공통 상수
+ */
+export const DEFAULT_BASE_URL = 'https://mcp.aka.page';
+export const DEFAULT_MCP_URL = `${DEFAULT_BASE_URL}/mcp`;

package/dist/cli/deps.js

@@ -0,0 +1,48 @@
+/**
+ * CLI 기본 의존성 생성
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+import { runInteractiveCli } from '../cliInteractive.js';
+function loadVersion() {
+    const cliPath = fileURLToPath(import.meta.url);
+    const packagePath = path.resolve(path.dirname(cliPath), '../../package.json');
+    if (!existsSync(packagePath)) {
+        return '0.0.0';
+    }
+    const raw = readFileSync(packagePath, 'utf8');
+    const parsed = JSON.parse(raw);
+    return parsed.version ?? '0.0.0';
+}
+async function execCommand(command, args) {
+    return await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: 'inherit',
+            shell: false,
+        });
+        child.on('error', (error) => {
+            reject(error);
+        });
+        child.on('close', (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+export function createDefaultDeps() {
+    return {
+        fetchImpl: fetch,
+        writeOut: (message) => {
+            process.stdout.write(`${message}\n`);
+        },
+        writeErr: (message) => {
+            process.stderr.write(`${message}\n`);
+        },
+        getVersion: loadVersion,
+        nowIso: () => new Date().toISOString(),
+        runCommand: execCommand,
+        isInteractiveTerminal: () => Boolean(process.stdin.isTTY && process.stdout.isTTY),
+        runInteractive: runInteractiveCli,
+    };
+}

package/dist/cli/http.js

@@ -0,0 +1,98 @@
+/**
+ * HTTP 요청 및 응답 처리 유틸리티
+ */
+import { renderApiEnvelope } from '../cliRenderer.js';
+import { buildDaisoStoreKeywordVariants } from '../utils/daisoKeyword.js';
+import { applyOptionsToQuery, toUrl } from './args.js';
+export async function requestAndPrintResponse(fetchImpl, writeOut, writeErr, url, command, asJson) {
+    try {
+        const response = await fetchImpl(url.toString());
+        if (!response.ok) {
+            const bodyText = await response.text();
+            writeErr(`요청 실패: HTTP ${response.status}`);
+            if (bodyText) {
+                writeErr(bodyText);
+            }
+            return 1;
+        }
+        const payload = (await response.json());
+        if (asJson) {
+            writeOut(JSON.stringify(payload, null, 2));
+        }
+        else {
+            writeOut(renderApiEnvelope(command, url, payload));
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writeErr(`요청 중 오류 발생: ${message}`);
+        return 1;
+    }
+}
+function toStoreCount(payload) {
+    if (typeof payload !== 'object' || payload === null) {
+        return 0;
+    }
+    const record = payload;
+    if (record.success !== true || typeof record.data !== 'object' || record.data === null) {
+        return 0;
+    }
+    const stores = record.data.stores;
+    return Array.isArray(stores) ? stores.length : 0;
+}
+export async function requestAndPrintStoresWithKeywordFallback(fetchImpl, writeOut, writeErr, options, asJson) {
+    const originalKeyword = options.keyword;
+    if (!originalKeyword) {
+        const url = toUrl('/api/daiso/stores');
+        applyOptionsToQuery(url, options);
+        return await requestAndPrintResponse(fetchImpl, writeOut, writeErr, url, 'stores', asJson);
+    }
+    const keywords = buildDaisoStoreKeywordVariants(originalKeyword);
+    const candidates = keywords.length > 0 ? keywords : [originalKeyword];
+    try {
+        let lastUrl = toUrl('/api/daiso/stores');
+        let lastPayload = null;
+        for (const keyword of candidates) {
+            const targetUrl = toUrl('/api/daiso/stores');
+            applyOptionsToQuery(targetUrl, { ...options, keyword });
+            lastUrl = targetUrl;
+            const response = await fetchImpl(targetUrl.toString());
+            if (!response.ok) {
+                const bodyText = await response.text();
+                writeErr(`요청 실패: HTTP ${response.status}`);
+                if (bodyText) {
+                    writeErr(bodyText);
+                }
+                return 1;
+            }
+            const payload = (await response.json());
+            lastPayload = payload;
+            if (toStoreCount(payload) > 0) {
+                if (keyword !== originalKeyword) {
+                    writeOut(`입력 키워드 "${originalKeyword}" 대신 "${keyword}"로 매장을 찾았습니다.`);
+                }
+                if (asJson) {
+                    writeOut(JSON.stringify(payload, null, 2));
+                }
+                else {
+                    writeOut(renderApiEnvelope('stores', targetUrl, payload));
+                }
+                return 0;
+            }
+        }
+        if (asJson) {
+            writeOut(JSON.stringify(lastPayload, null, 2));
+        }
+        else {
+            writeOut(renderApiEnvelope('stores', lastUrl, lastPayload));
+        }
+        writeOut('힌트: "안산 중앙역" 대신 "안산중앙" 또는 "고잔"으로 검색해보세요.');
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writeErr(`요청 중 오류 발생: ${message}`);
+        return 1;
+    }
+}

package/dist/cli/interactiveFetch.js

@@ -0,0 +1,31 @@
+/**
+ * 인터랙티브 CLI API 호출 헬퍼
+ */
+import { buildDaisoStoreKeywordVariants, parseStores } from '../utils/cliInteractiveHelpers.js';
+const BASE_URL = 'https://mcp.aka.page';
+export async function fetchEnvelope(fetchImpl, path, query = {}) {
+    const url = new URL(path, BASE_URL);
+    for (const [key, value] of Object.entries(query)) {
+        url.searchParams.set(key, value);
+    }
+    const response = await fetchImpl(url.toString());
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} (${url.pathname})`);
+    }
+    return (await response.json());
+}
+export async function fetchStoresWithKeywordFallback(fetchImpl, service, keyword) {
+    const candidates = service === 'daiso' ? buildDaisoStoreKeywordVariants(keyword) : [keyword];
+    const keywords = candidates.length > 0 ? candidates : [keyword];
+    for (const currentKeyword of keywords) {
+        const payload = await fetchEnvelope(fetchImpl, `/api/${service}/stores`, {
+            keyword: currentKeyword,
+            limit: '10',
+        });
+        const stores = parseStores(payload);
+        if (stores.length > 0) {
+            return { stores, matchedKeyword: currentKeyword };
+        }
+    }
+    return { stores: [], matchedKeyword: keyword };
+}