ebay-mcp-remote-edition 3.1.2 → 3.3.0

package/build/api/listing-metadata/metadata.js

@@ -27,7 +27,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_automotive_parts_compatibility_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get automotive parts compatibility policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get automotive parts compatibility policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -49,7 +49,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_category_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get category policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get category policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -71,7 +71,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_extended_producer_responsibility_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get extended producer responsibility policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get extended producer responsibility policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -87,7 +87,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_hazardous_materials_labels`);
         }
         catch (error) {
-            throw new Error(`Failed to get hazardous materials labels: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get hazardous materials labels: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -109,7 +109,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_item_condition_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get item condition policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get item condition policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -131,7 +131,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_listing_structure_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get listing structure policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get listing structure policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -153,7 +153,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_negotiated_price_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get negotiated price policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get negotiated price policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -169,7 +169,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_product_safety_labels`);
         }
         catch (error) {
-            throw new Error(`Failed to get product safety labels: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get product safety labels: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -191,7 +191,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_regulatory_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get regulatory policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get regulatory policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -213,7 +213,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_return_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get return policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get return policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -235,7 +235,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_shipping_cost_type_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get shipping cost type policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get shipping cost type policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -257,7 +257,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_classified_ad_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get classified ad policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get classified ad policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -273,7 +273,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_currencies`);
         }
         catch (error) {
-            throw new Error(`Failed to get currencies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get currencies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -295,7 +295,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_listing_type_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get listing type policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get listing type policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -317,7 +317,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_motors_listing_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get motors listing policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get motors listing policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -339,7 +339,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_shipping_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get shipping policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get shipping policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -361,7 +361,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_site_visibility_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get site visibility policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get site visibility policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -377,7 +377,7 @@ export class MetadataApi {
             return await this.client.post(`${this.basePath}/compatibilities/get_compatibilities_by_specification`, specification);
         }
         catch (error) {
-            throw new Error(`Failed to get compatibilities by specification: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get compatibilities by specification: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -393,7 +393,7 @@ export class MetadataApi {
             return await this.client.post(`${this.basePath}/compatibilities/get_compatibility_property_names`, data);
         }
         catch (error) {
-            throw new Error(`Failed to get compatibility property names: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get compatibility property names: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -409,7 +409,7 @@ export class MetadataApi {
             return await this.client.post(`${this.basePath}/compatibilities/get_compatibility_property_values`, data);
         }
         catch (error) {
-            throw new Error(`Failed to get compatibility property values: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get compatibility property values: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -425,7 +425,7 @@ export class MetadataApi {
             return await this.client.post(`${this.basePath}/compatibilities/get_multi_compatibility_property_values`, data);
         }
         catch (error) {
-            throw new Error(`Failed to get multi compatibility property values: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get multi compatibility property values: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -441,7 +441,7 @@ export class MetadataApi {
             return await this.client.post(`${this.basePath}/compatibilities/get_product_compatibilities`, data);
         }
         catch (error) {
-            throw new Error(`Failed to get product compatibilities: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get product compatibilities: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -457,7 +457,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/country/${countryCode}/sales_tax_jurisdiction`);
         }
         catch (error) {
-            throw new Error(`Failed to get sales tax jurisdictions: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get sales tax jurisdictions: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**
@@ -479,7 +479,7 @@ export class MetadataApi {
             return await this.client.get(`${this.basePath}/marketplace/${marketplaceId}/get_product_compliance_policies`, params);
         }
         catch (error) {
-            throw new Error(`Failed to get product compliance policies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to get product compliance policies: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
 }

package/build/auth/multi-user-store.js

@@ -44,7 +44,7 @@ export class MultiUserAuthStore {
      * `lastUsedAt` once per TOUCH_THROTTLE_MS (default: 1 hour).
      */
     sessionTouchCache = new Map();
-    static TOUCH_THROTTLE_MS = 60 * 60 * 1_000; // 1 hour
+    static touchThrottleMs = 60 * 60 * 1_000; // 1 hour
     stateKey(state) {
         return `oauth_state:${state}`;
     }
@@ -67,6 +67,12 @@ export class MultiUserAuthStore {
         await this.kv.put(this.stateKey(state), record, OAUTH_STATE_TTL_S);
         return record;
     }
+    async getOAuthState(state) {
+        return await this.kv.get(this.stateKey(state));
+    }
+    async deleteOAuthState(state) {
+        await this.kv.delete(this.stateKey(state));
+    }
     async consumeOAuthState(state) {
         const key = this.stateKey(state);
         const record = await this.kv.get(key);
@@ -122,7 +128,7 @@ export class MultiUserAuthStore {
         // Skip the KV write entirely if we touched this session recently.
         // The in-memory cache in CloudflareKVStore already keeps reads free,
         // so the only cost we're avoiding here is the unnecessary KV PUT.
-        if (lastTouched !== undefined && now - lastTouched < MultiUserAuthStore.TOUCH_THROTTLE_MS) {
+        if (lastTouched !== undefined && now - lastTouched < MultiUserAuthStore.touchThrottleMs) {
             return;
         }
         const record = await this.getSession(sessionToken);

package/build/auth/oauth.js

@@ -1,5 +1,5 @@
 import axios from 'axios';
-import { getBaseUrl } from '../config/environment.js';
+import { getOAuthTokenBaseUrl } from '../config/environment.js';
 import { MultiUserAuthStore } from '../auth/multi-user-store.js';
 export class EbayOAuthClient {
     config;
@@ -8,15 +8,20 @@ export class EbayOAuthClient {
     appAccessTokenExpiry = 0;
     userTokens = null;
     authStore = new MultiUserAuthStore();
+    authSource = null;
     constructor(config, context) {
         this.config = config;
         this.context = context;
     }
+    getTokenEndpoint() {
+        return `${getOAuthTokenBaseUrl(this.config.environment)}/identity/v1/oauth2/token`;
+    }
     async initialize() {
         if (this.context?.userId && this.context.environment) {
             const stored = await this.authStore.getUserTokens(this.context.userId, this.context.environment);
             if (stored?.tokenData) {
                 this.userTokens = stored.tokenData;
+                this.authSource = 'stored_user_tokens';
                 return;
             }
         }
@@ -24,7 +29,7 @@ export class EbayOAuthClient {
         const envRefreshToken = process.env.EBAY_USER_REFRESH_TOKEN;
         if (envRefreshToken) {
             try {
-                const authUrl = `${getBaseUrl(this.config.environment)}/identity/v1/oauth2/token`;
+                const authUrl = this.getTokenEndpoint();
                 const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString('base64');
                 const response = await axios.post(authUrl, new URLSearchParams({
                     grant_type: 'refresh_token',
@@ -50,6 +55,7 @@ export class EbayOAuthClient {
                         : now + 18 * 30 * 24 * 60 * 60 * 1000,
                     scope: tokenData.scope,
                 };
+                this.authSource = 'env_refresh_token_fallback';
             }
             catch {
                 // If refresh fails, leave userTokens as null
@@ -99,13 +105,14 @@ export class EbayOAuthClient {
             userAccessTokenExpiry: accessTokenExpiry ?? now + 7200 * 1000,
             userRefreshTokenExpiry: refreshTokenExpiry ?? now + 18 * 30 * 24 * 60 * 60 * 1000,
         };
+        this.authSource = 'manual_set_user_tokens';
         await this.persistUserTokens();
     }
     async getOrRefreshAppAccessToken() {
         if (this.appAccessToken && Date.now() < this.appAccessTokenExpiry) {
             return this.appAccessToken;
         }
-        const authUrl = `${getBaseUrl(this.config.environment)}/identity/v1/oauth2/token`;
+        const authUrl = this.getTokenEndpoint();
         const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString('base64');
         const response = await axios.post(authUrl, new URLSearchParams({
             grant_type: 'client_credentials',
@@ -124,7 +131,7 @@ export class EbayOAuthClient {
         if (!this.config.redirectUri) {
             throw new Error('Redirect URI is required for authorization code exchange');
         }
-        const tokenUrl = `${getBaseUrl(this.config.environment)}/identity/v1/oauth2/token`;
+        const tokenUrl = this.getTokenEndpoint();
         const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString('base64');
         try {
             const response = await axios.post(tokenUrl, new URLSearchParams({
@@ -150,6 +157,7 @@ export class EbayOAuthClient {
                 userRefreshTokenExpiry: now + tokenData.refresh_token_expires_in * 1000,
                 scope: tokenData.scope,
             };
+            this.authSource = 'authorization_code_exchange';
             await this.persistUserTokens();
             return tokenData;
         }
@@ -157,10 +165,10 @@ export class EbayOAuthClient {
             if (axios.isAxiosError(error) && error.response?.data) {
                 const data = error.response.data;
                 if (data.error_description) {
-                    throw new Error(data.error_description);
+                    throw new Error(data.error_description, { cause: error });
                 }
                 if (data.error) {
-                    throw new Error(data.error);
+                    throw new Error(data.error, { cause: error });
                 }
             }
             throw error;
@@ -170,7 +178,7 @@ export class EbayOAuthClient {
         if (!this.userTokens) {
             throw new Error('No user tokens available to refresh');
         }
-        const authUrl = `${getBaseUrl(this.config.environment)}/identity/v1/oauth2/token`;
+        const authUrl = this.getTokenEndpoint();
         const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString('base64');
         const response = await axios.post(authUrl, new URLSearchParams({
             grant_type: 'refresh_token',
@@ -198,6 +206,24 @@ export class EbayOAuthClient {
         };
         await this.persistUserTokens();
     }
+    getAuthDebugInfo() {
+        return {
+            tokenEndpoint: this.getTokenEndpoint(),
+            environment: this.config.environment,
+            hasClientId: this.config.clientId.trim().length > 0,
+            hasClientSecret: this.config.clientSecret.trim().length > 0,
+            hasRefreshToken: !!this.userTokens?.userRefreshToken,
+            hasAccessToken: !!this.userTokens?.userAccessToken,
+            hasRedirectUri: !!this.config.redirectUri,
+            ...(this.userTokens?.userRefreshTokenExpiry
+                ? { refreshTokenExpiry: this.userTokens.userRefreshTokenExpiry }
+                : {}),
+            ...(this.userTokens?.userAccessTokenExpiry
+                ? { accessTokenExpiry: this.userTokens.userAccessTokenExpiry }
+                : {}),
+            ...(this.authSource ? { source: this.authSource } : {}),
+        };
+    }
     isAuthenticated() {
         if (this.userTokens && !this.isUserAccessTokenExpired(this.userTokens)) {
             return true;

package/build/auth/token-verifier.js

@@ -20,7 +20,7 @@ export class TokenVerifier {
                 this.metadata = response.data;
             }
             catch (error) {
-                throw new Error(`Failed to load OAuth server metadata: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                throw new Error(`Failed to load OAuth server metadata: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
             }
         }
         else {
@@ -104,7 +104,7 @@ export class TokenVerifier {
         }
         catch (error) {
             if (axios.isAxiosError(error)) {
-                throw new Error(`Token introspection failed: ${error.response?.data?.error_description || error.message}`);
+                throw new Error(`Token introspection failed: ${error.response?.data?.error_description || error.message}`, { cause: error });
             }
             throw error;
         }
@@ -150,7 +150,7 @@ export class TokenVerifier {
             };
         }
         catch (error) {
-            throw new Error(`JWT verification failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`JWT verification failed: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
         }
     }
     /**

package/build/config/environment.js

@@ -289,9 +289,19 @@ export function getEbayConfig(environmentOverride) {
         appAccessToken: process.env.EBAY_APP_ACCESS_TOKEN ?? '',
     };
 }
+export function getValidationRunnerUserId(environment) {
+    const envSpecific = environment === 'production'
+        ? process.env.VALIDATION_RUNNER_USER_ID_PRODUCTION
+        : process.env.VALIDATION_RUNNER_USER_ID_SANDBOX;
+    const resolved = (envSpecific ?? process.env.VALIDATION_RUNNER_USER_ID ?? '').trim();
+    return resolved || null;
+}
 export function getBaseUrl(environment) {
     return environment === 'production' ? 'https://api.ebay.com' : 'https://api.sandbox.ebay.com';
 }
+export function getOAuthTokenBaseUrl(environment) {
+    return environment === 'production' ? 'https://api.ebay.com' : 'https://api.sandbox.ebay.com';
+}
 export function getIdentityBaseUrl(environment) {
     return environment === 'production' ? 'https://apiz.ebay.com' : 'https://apiz.sandbox.ebay.com';
 }

package/build/scripts/{run-with-local-env.js → env-check.js}

@@ -11,7 +11,7 @@ function isHostedEnvironment() {
 function main() {
     const args = process.argv.slice(2);
     if (args.length === 0) {
-        throw new Error('Usage: tsx src/scripts/run-with-local-env.ts <command> [args...]');
+        throw new Error('Usage: tsx src/scripts/env-check.ts <command> [args...]');
     }
     const hosted = isHostedEnvironment();
     const [command, ...commandArgs] = args;