ebay-mcp-remote-edition 3.2.0 → 3.3.1

package/build/validation/providers/ebay.js

@@ -1,31 +1,11 @@
+import axios from 'axios';
 import { getBaseUrl } from '../../config/environment.js';
+import { buildResolvedBrowseQueryPlan } from './query-utils.js';
 function round(value) {
     return Math.round(value * 100) / 100;
 }
-function buildQueryTerms(request) {
-    const terms = new Set();
-    const addTerms = (values, maxTerms = values.length) => {
-        for (const value of values) {
-            if (!value)
-                continue;
-            const normalized = value.trim();
-            if (!normalized)
-                continue;
-            terms.add(normalized);
-            if (terms.size >= maxTerms) {
-                break;
-            }
-        }
-    };
-    addTerms([request.item.name], 1);
-    addTerms(request.item.canonicalArtists, 3);
-    addTerms(request.item.relatedAlbums, 5);
-    addTerms(request.item.variation, 7);
-    addTerms([request.validation.validationType], 8);
-    return Array.from(terms);
-}
-export function buildEbayValidationQuery(request) {
-    return buildQueryTerms(request).join(' ').replace(/\s+/g, ' ').trim();
+export function buildEbayValidationQueries(request) {
+    return buildResolvedBrowseQueryPlan(request).queryPlan.map((candidate) => candidate.query);
 }
 function deriveTrend(current, previous, fallback) {
     if (current === null || previous === null || previous <= 0) {
@@ -48,8 +28,31 @@ function median(values) {
     }
     return sorted[middle];
 }
+function getAxiosFailureDebug(error) {
+    if (!axios.isAxiosError(error)) {
+        return {
+            responseStatus: null,
+            responseBodyExcerpt: null,
+        };
+    }
+    const responseStatus = error.response?.status ?? null;
+    const rawBody = error.response?.data;
+    if (rawBody === undefined) {
+        return {
+            responseStatus,
+            responseBodyExcerpt: null,
+        };
+    }
+    const bodyText = typeof rawBody === 'string' ? rawBody : JSON.stringify(rawBody, null, 2);
+    return {
+        responseStatus,
+        responseBodyExcerpt: bodyText.slice(0, 500),
+    };
+}
 export async function getEbayValidationSignals(api, request) {
-    const ebayQuery = buildEbayValidationQuery(request);
+    const { queryPlan, queryResolution } = buildResolvedBrowseQueryPlan(request);
+    const queryCandidates = queryPlan.map((candidate) => candidate.query);
+    const ebayQuery = queryCandidates[0] ?? '';
     const fallbackTrend = request.validation.currentMetrics.marketPriceTrend || 'Stable';
     const emptyResult = {
         avgWatchersPerListing: null,
@@ -59,6 +62,13 @@ export async function getEbayValidationSignals(api, request) {
         competitionLevel: null,
         marketPriceTrend: fallbackTrend,
         ebayQuery,
+        queryCandidates,
+        selectedQuery: ebayQuery || undefined,
+        selectedQueryTier: ebayQuery ? 1 : null,
+        queryDiagnostics: [],
+        selectionReason: queryCandidates.length
+            ? 'Cleaned browse candidates were generated, but none have been evaluated yet.'
+            : 'No valid browse query candidates were generated after sanitization and semantic filtering.',
         sampleSize: 0,
         soldVelocity: {
             day1Sold: request.validation.currentMetrics.day1Sold,
@@ -68,45 +78,93 @@ export async function getEbayValidationSignals(api, request) {
             day5Sold: request.validation.currentMetrics.day5Sold,
             daysTracked: request.validation.currentMetrics.daysTracked,
         },
+        queryResolution,
     };
-    if (!ebayQuery) {
+    if (queryCandidates.length === 0) {
         return emptyResult;
     }
     try {
         const environment = api.getAuthClient().getConfig().environment;
-        const browseUrl = `${getBaseUrl(environment)}/buy/browse/v1/item_summary/search`;
-        const response = await api.getAuthClient().getWithFullUrl(browseUrl, {
-            q: ebayQuery,
-            limit: 25,
-            sort: 'newlyListed',
-        });
-        const itemSummaries = response.itemSummaries ?? [];
-        const prices = itemSummaries
-            .map((item) => Number(item.price?.value ?? Number.NaN))
-            .filter((value) => Number.isFinite(value) && value > 0);
-        const shipping = itemSummaries
-            .map((item) => Number(item.shippingOptions?.[0]?.shippingCost?.value ?? Number.NaN))
-            .filter((value) => Number.isFinite(value) && value >= 0);
-        const marketPriceUsd = median(prices);
-        const avgShippingCostUsd = shipping.length > 0
-            ? shipping.reduce((sum, value) => sum + value, 0) / shipping.length
-            : null;
-        const totalListings = typeof response.total === 'number' && Number.isFinite(response.total)
-            ? response.total
-            : itemSummaries.length;
+        const browseUrl = new URL('/buy/browse/v1/item_summary/search', getBaseUrl(environment)).toString();
+        let selectedResult = emptyResult;
+        let bestScore = -1;
+        const queryDiagnostics = [];
+        for (const [index, query] of queryCandidates.entries()) {
+            const response = await api.getAuthClient().getWithFullUrl(browseUrl, {
+                q: query,
+                limit: 25,
+                sort: 'newlyListed',
+            });
+            const itemSummaries = response.itemSummaries ?? [];
+            const prices = itemSummaries
+                .map((item) => Number(item.price?.value ?? Number.NaN))
+                .filter((value) => Number.isFinite(value) && value > 0);
+            const shipping = itemSummaries
+                .map((item) => Number(item.shippingOptions?.[0]?.shippingCost?.value ?? Number.NaN))
+                .filter((value) => Number.isFinite(value) && value >= 0);
+            const marketPriceUsd = median(prices);
+            const avgShippingCostUsd = shipping.length > 0
+                ? shipping.reduce((sum, value) => sum + value, 0) / shipping.length
+                : null;
+            const totalListings = typeof response.total === 'number' && Number.isFinite(response.total)
+                ? response.total
+                : itemSummaries.length;
+            const attemptScore = Math.max(itemSummaries.length, totalListings);
+            queryDiagnostics.push({
+                query,
+                tier: index + 1,
+                family: queryPlan[index]?.family,
+                itemSummaryCount: itemSummaries.length,
+                totalListings,
+            });
+            if (attemptScore <= bestScore) {
+                if (itemSummaries.length >= 5 || totalListings >= 5) {
+                    break;
+                }
+                continue;
+            }
+            bestScore = attemptScore;
+            selectedResult = {
+                avgWatchersPerListing: null,
+                preOrderListingsCount: totalListings,
+                marketPriceUsd: marketPriceUsd === null ? null : round(marketPriceUsd),
+                avgShippingCostUsd: avgShippingCostUsd === null ? null : round(avgShippingCostUsd),
+                competitionLevel: totalListings,
+                marketPriceTrend: deriveTrend(marketPriceUsd, request.validation.currentMetrics.marketPriceUsd, fallbackTrend),
+                ebayQuery: query,
+                queryCandidates,
+                selectedQuery: query,
+                selectedQueryTier: index + 1,
+                queryDiagnostics: [...queryDiagnostics],
+                selectionReason: itemSummaries.length >= 5 || totalListings >= 5
+                    ? 'Selected because this cleaned browse candidate produced sufficient listing depth.'
+                    : attemptScore > 0
+                        ? 'Selected as the strongest cleaned browse fallback after higher-priority candidates returned weaker results.'
+                        : 'All cleaned browse candidates seen so far returned zero results; keeping the highest-priority candidate for traceability.',
+                sampleSize: itemSummaries.length,
+                soldVelocity: emptyResult.soldVelocity,
+                queryResolution,
+            };
+            if (itemSummaries.length >= 5 || totalListings >= 5) {
+                break;
+            }
+        }
         return {
-            avgWatchersPerListing: null,
-            preOrderListingsCount: totalListings,
-            marketPriceUsd: marketPriceUsd === null ? null : round(marketPriceUsd),
-            avgShippingCostUsd: avgShippingCostUsd === null ? null : round(avgShippingCostUsd),
-            competitionLevel: totalListings,
-            marketPriceTrend: deriveTrend(marketPriceUsd, request.validation.currentMetrics.marketPriceUsd, fallbackTrend),
-            ebayQuery,
-            sampleSize: itemSummaries.length,
-            soldVelocity: emptyResult.soldVelocity,
+            ...selectedResult,
+            queryDiagnostics,
+            selectionReason: selectedResult.selectionReason ??
+                'Browse selection completed without a stronger candidate than the highest-priority cleaned query.',
         };
     }
-    catch {
-        return emptyResult;
+    catch (error) {
+        const failureDebug = getAxiosFailureDebug(error);
+        return {
+            ...emptyResult,
+            selectionReason: 'Browse query execution failed before result selection could complete; returning the cleaned fallback candidate set for debug traceability.',
+            errorMessage: error instanceof Error ? error.message : String(error),
+            responseStatus: failureDebug.responseStatus,
+            responseBodyExcerpt: failureDebug.responseBodyExcerpt,
+            queryResolution,
+        };
     }
 }