ebay-mcp 1.8.9 → 1.9.0

package/build/api/account-management/account.js

@@ -1,3 +1,4 @@
+import { withApiError } from '../../api/shared/request.js';
 /**
  * Account API - Seller account configuration, policies, programs
  * Based on: docs/sell-apps/account-management/sell_account_v1_oas3.json
@@ -13,46 +14,46 @@ export class AccountApi {
      */
     async getCustomPolicies(policyTypes) {
         const params = policyTypes ? { policy_types: policyTypes } : undefined;
-        return await this.client.get(`${this.basePath}/custom_policy`, params);
+        return await withApiError('Failed to get custom policies', () => this.client.get(`${this.basePath}/custom_policy`, params));
     }
     /**
      * Get a specific custom policy
      */
     async getCustomPolicy(customPolicyId) {
-        return await this.client.get(`${this.basePath}/custom_policy/${customPolicyId}`);
+        return await withApiError('Failed to get custom policy', () => this.client.get(`${this.basePath}/custom_policy/${customPolicyId}`));
     }
     /**
      * Get fulfillment policies
      * @param marketplaceId - Required: The eBay marketplace ID
      */
     async getFulfillmentPolicies(marketplaceId) {
-        return await this.client.get(`${this.basePath}/fulfillment_policy`, {
+        return await withApiError('Failed to get fulfillment policies', () => this.client.get(`${this.basePath}/fulfillment_policy`, {
             marketplace_id: marketplaceId,
-        });
+        }));
     }
     /**
      * Get payment policies
      * @param marketplaceId - Required: The eBay marketplace ID
      */
     async getPaymentPolicies(marketplaceId) {
-        return await this.client.get(`${this.basePath}/payment_policy`, {
+        return await withApiError('Failed to get payment policies', () => this.client.get(`${this.basePath}/payment_policy`, {
             marketplace_id: marketplaceId,
-        });
+        }));
     }
     /**
      * Get return policies
      * @param marketplaceId - Required: The eBay marketplace ID
      */
     async getReturnPolicies(marketplaceId) {
-        return await this.client.get(`${this.basePath}/return_policy`, {
+        return await withApiError('Failed to get return policies', () => this.client.get(`${this.basePath}/return_policy`, {
             marketplace_id: marketplaceId,
-        });
+        }));
     }
     /**
      * Get seller account privileges
      */
     async getPrivileges() {
-        return await this.client.get(`${this.basePath}/privilege`);
+        return await withApiError('Failed to get privileges', () => this.client.get(`${this.basePath}/privilege`));
     }
     // ============================================================
     // Fulfillment Policy Methods
@@ -61,34 +62,34 @@ export class AccountApi {
      * Create a new fulfillment policy
      */
     async createFulfillmentPolicy(policy) {
-        return await this.client.post(`${this.basePath}/fulfillment_policy`, policy);
+        return await withApiError('Failed to create fulfillment policy', () => this.client.post(`${this.basePath}/fulfillment_policy`, policy));
     }
     /**
      * Get a specific fulfillment policy by ID
      */
     async getFulfillmentPolicy(fulfillmentPolicyId) {
-        return await this.client.get(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`);
+        return await withApiError('Failed to get fulfillment policy', () => this.client.get(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`));
     }
     /**
      * Get a fulfillment policy by name
      */
     async getFulfillmentPolicyByName(marketplaceId, name) {
-        return await this.client.get(`${this.basePath}/fulfillment_policy_by_name`, {
+        return await withApiError('Failed to get fulfillment policy by name', () => this.client.get(`${this.basePath}/fulfillment_policy_by_name`, {
             marketplace_id: marketplaceId,
             name,
-        });
+        }));
     }
     /**
      * Update a fulfillment policy
      */
     async updateFulfillmentPolicy(fulfillmentPolicyId, policy) {
-        return await this.client.put(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`, policy);
+        return await withApiError('Failed to update fulfillment policy', () => this.client.put(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`, policy));
     }
     /**
      * Delete a fulfillment policy
      */
     async deleteFulfillmentPolicy(fulfillmentPolicyId) {
-        return await this.client.delete(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`);
+        return await withApiError('Failed to delete fulfillment policy', () => this.client.delete(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`));
     }
     // ============================================================
     // Payment Policy Methods
@@ -97,34 +98,34 @@ export class AccountApi {
      * Create a new payment policy
      */
     async createPaymentPolicy(policy) {
-        return await this.client.post(`${this.basePath}/payment_policy`, policy);
+        return await withApiError('Failed to create payment policy', () => this.client.post(`${this.basePath}/payment_policy`, policy));
     }
     /**
      * Get a specific payment policy by ID
      */
     async getPaymentPolicy(paymentPolicyId) {
-        return await this.client.get(`${this.basePath}/payment_policy/${paymentPolicyId}`);
+        return await withApiError('Failed to get payment policy', () => this.client.get(`${this.basePath}/payment_policy/${paymentPolicyId}`));
     }
     /**
      * Get a payment policy by name
      */
     async getPaymentPolicyByName(marketplaceId, name) {
-        return await this.client.get(`${this.basePath}/payment_policy_by_name`, {
+        return await withApiError('Failed to get payment policy by name', () => this.client.get(`${this.basePath}/payment_policy_by_name`, {
             marketplace_id: marketplaceId,
             name,
-        });
+        }));
     }
     /**
      * Update a payment policy
      */
     async updatePaymentPolicy(paymentPolicyId, policy) {
-        return await this.client.put(`${this.basePath}/payment_policy/${paymentPolicyId}`, policy);
+        return await withApiError('Failed to update payment policy', () => this.client.put(`${this.basePath}/payment_policy/${paymentPolicyId}`, policy));
     }
     /**
      * Delete a payment policy
      */
     async deletePaymentPolicy(paymentPolicyId) {
-        return await this.client.delete(`${this.basePath}/payment_policy/${paymentPolicyId}`);
+        return await withApiError('Failed to delete payment policy', () => this.client.delete(`${this.basePath}/payment_policy/${paymentPolicyId}`));
     }
     // ============================================================
     // Return Policy Methods
@@ -133,34 +134,34 @@ export class AccountApi {
      * Create a new return policy
      */
     async createReturnPolicy(policy) {
-        return await this.client.post(`${this.basePath}/return_policy`, policy);
+        return await withApiError('Failed to create return policy', () => this.client.post(`${this.basePath}/return_policy`, policy));
     }
     /**
      * Get a specific return policy by ID
      */
     async getReturnPolicy(returnPolicyId) {
-        return await this.client.get(`${this.basePath}/return_policy/${returnPolicyId}`);
+        return await withApiError('Failed to get return policy', () => this.client.get(`${this.basePath}/return_policy/${returnPolicyId}`));
     }
     /**
      * Get a return policy by name
      */
     async getReturnPolicyByName(marketplaceId, name) {
-        return await this.client.get(`${this.basePath}/return_policy_by_name`, {
+        return await withApiError('Failed to get return policy by name', () => this.client.get(`${this.basePath}/return_policy_by_name`, {
             marketplace_id: marketplaceId,
             name,
-        });
+        }));
     }
     /**
      * Update a return policy
      */
     async updateReturnPolicy(returnPolicyId, policy) {
-        return await this.client.put(`${this.basePath}/return_policy/${returnPolicyId}`, policy);
+        return await withApiError('Failed to update return policy', () => this.client.put(`${this.basePath}/return_policy/${returnPolicyId}`, policy));
     }
     /**
      * Delete a return policy
      */
     async deleteReturnPolicy(returnPolicyId) {
-        return await this.client.delete(`${this.basePath}/return_policy/${returnPolicyId}`);
+        return await withApiError('Failed to delete return policy', () => this.client.delete(`${this.basePath}/return_policy/${returnPolicyId}`));
     }
     // ============================================================
     // Custom Policy Methods
@@ -169,19 +170,19 @@ export class AccountApi {
      * Create a new custom policy
      */
     async createCustomPolicy(policy) {
-        return await this.client.post(`${this.basePath}/custom_policy`, policy);
+        return await withApiError('Failed to create custom policy', () => this.client.post(`${this.basePath}/custom_policy`, policy));
     }
     /**
      * Update a custom policy
      */
     async updateCustomPolicy(customPolicyId, policy) {
-        return await this.client.put(`${this.basePath}/custom_policy/${customPolicyId}`, policy);
+        return await withApiError('Failed to update custom policy', () => this.client.put(`${this.basePath}/custom_policy/${customPolicyId}`, policy));
     }
     /**
      * Delete a custom policy
      */
     async deleteCustomPolicy(customPolicyId) {
-        return await this.client.delete(`${this.basePath}/custom_policy/${customPolicyId}`);
+        return await withApiError('Failed to delete custom policy', () => this.client.delete(`${this.basePath}/custom_policy/${customPolicyId}`));
     }
     // ============================================================
     // KYC, Payments Program, Rate Tables, Sales Tax, Subscription, Programs
@@ -190,85 +191,85 @@ export class AccountApi {
      * Get KYC status
      */
     async getKyc() {
-        return await this.client.get(`${this.basePath}/kyc`);
+        return await withApiError('Failed to get kyc', () => this.client.get(`${this.basePath}/kyc`));
     }
     /**
      * Opt-in to a payments program
      */
     async optInToPaymentsProgram(marketplaceId, paymentsProgramType) {
-        return await this.client.post(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`, {});
+        return await withApiError('Failed to opt in to payments program', () => this.client.post(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`, {}));
     }
     /**
      * Get payments program status
      */
     async getPaymentsProgramStatus(marketplaceId, paymentsProgramType) {
-        return await this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`);
+        return await withApiError('Failed to get payments program status', () => this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`));
     }
     /**
      * Get rate tables
      */
     async getRateTables() {
-        return await this.client.get(`${this.basePath}/rate_table`);
+        return await withApiError('Failed to get rate tables', () => this.client.get(`${this.basePath}/rate_table`));
     }
     /**
      * Create or replace sales tax table
      */
     async createOrReplaceSalesTax(countryCode, jurisdictionId, salesTaxBase) {
-        return await this.client.put(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`, salesTaxBase);
+        return await withApiError('Failed to create or replace sales tax', () => this.client.put(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`, salesTaxBase));
     }
     /**
      * Bulk create or replace sales tax tables
      */
     async bulkCreateOrReplaceSalesTax(requests) {
-        return await this.client.post(`${this.basePath}/sales_tax/bulk_create_or_replace`, {
+        return await withApiError('Failed to bulk create or replace sales tax', () => this.client.post(`${this.basePath}/sales_tax/bulk_create_or_replace`, {
             requests,
-        });
+        }));
     }
     /**
      * Delete sales tax table
      */
     async deleteSalesTax(countryCode, jurisdictionId) {
-        return await this.client.delete(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`);
+        return await withApiError('Failed to delete sales tax', () => this.client.delete(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`));
     }
     /**
      * Get sales tax table
      */
     async getSalesTax(countryCode, jurisdictionId) {
-        return await this.client.get(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`);
+        return await withApiError('Failed to get sales tax', () => this.client.get(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`));
     }
     /**
      * Get all sales tax tables
      * @param countryCode - Required: Two-letter ISO 3166-1 country code
      */
     async getSalesTaxes(countryCode) {
-        return await this.client.get(`${this.basePath}/sales_tax`, {
+        return await withApiError('Failed to get sales taxes', () => this.client.get(`${this.basePath}/sales_tax`, {
             country_code: countryCode,
-        });
+        }));
     }
     /**
      * Get subscription information
      */
     async getSubscription(limitType) {
         const params = limitType ? { limit: limitType } : undefined;
-        return await this.client.get(`${this.basePath}/subscription`, params);
+        return await withApiError('Failed to get subscription', () => this.client.get(`${this.basePath}/subscription`, params));
     }
     /**
      * Opt-in to a program
      */
     async optInToProgram(request) {
-        return await this.client.post(`${this.basePath}/program/opt_in`, request);
+        return await withApiError('Failed to opt in to program', () => this.client.post(`${this.basePath}/program/opt_in`, request));
     }
     /**
      * Opt-out of a program
      */
     async optOutOfProgram(request) {
-        return await this.client.post(`${this.basePath}/program/opt_out`, request);
+        return await withApiError('Failed to opt out of program', () => this.client.post(`${this.basePath}/program/opt_out`, request));
     }
     /**
      * Get opted-in programs
      */
     async getOptedInPrograms() {
-        return await this.client.get(`${this.basePath}/program`);
+        return await withApiError('Failed to get opted in programs', () => this.client.get(`${this.basePath}/program`));
     }
     /**
      * Get seller eligibility for advertising programs
@@ -278,11 +279,11 @@ export class AccountApi {
      */
     async getAdvertisingEligibility(marketplaceId, programTypes) {
         const params = programTypes ? { program_types: programTypes } : undefined;
-        return await this.client.get(`${this.basePath}/advertising_eligibility`, params, {
+        return await withApiError('Failed to get advertising eligibility', () => this.client.get(`${this.basePath}/advertising_eligibility`, params, {
             headers: {
                 'X-EBAY-C-MARKETPLACE-ID': marketplaceId,
             },
-        });
+        }));
     }
     /**
      * Get payments program status for a marketplace
@@ -291,7 +292,7 @@ export class AccountApi {
      * @param paymentsProgramType - The type of payments program
      */
     async getPaymentsProgram(marketplaceId, paymentsProgramType) {
-        return await this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`);
+        return await withApiError('Failed to get payments program', () => this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`));
     }
     /**
      * Get payments program onboarding information
@@ -300,6 +301,6 @@ export class AccountApi {
      * @param paymentsProgramType - The type of payments program
      */
     async getPaymentsProgramOnboarding(marketplaceId, paymentsProgramType) {
-        return await this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}/onboarding`);
+        return await withApiError('Failed to get payments program onboarding', () => this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}/onboarding`));
     }
 }

package/build/api/analytics-and-report/analytics.js

@@ -1,3 +1,4 @@
+import { withApiError } from '../../api/shared/request.js';
 /**
  * Analytics API - Sales and traffic analytics
  * Based on: docs/sell-apps/analytics-and-report/sell_analytics_v1_oas3.json
@@ -33,12 +34,7 @@ export class AnalyticsApi {
         };
         if (sort)
             params.sort = sort;
-        try {
-            return await this.client.get(`${this.basePath}/traffic_report`, params);
-        }
-        catch (error) {
-            throw new Error(`Failed to get traffic report: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
+        return await withApiError('Failed to get traffic report', () => this.client.get(`${this.basePath}/traffic_report`, params));
     }
     /**
      * Find all seller standards profiles
@@ -46,12 +42,7 @@ export class AnalyticsApi {
      * @throws Error if the request fails
      */
     async findSellerStandardsProfiles() {
-        try {
-            return await this.client.get(`${this.basePath}/seller_standards_profile`);
-        }
-        catch (error) {
-            throw new Error(`Failed to find seller standards profiles: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
+        return await withApiError('Failed to find seller standards profiles', () => this.client.get(`${this.basePath}/seller_standards_profile`));
     }
     /**
      * Get a specific seller standards profile
@@ -66,12 +57,7 @@ export class AnalyticsApi {
         if (!cycle || typeof cycle !== 'string') {
             throw new Error('cycle is required and must be a string');
         }
-        try {
-            return await this.client.get(`${this.basePath}/seller_standards_profile/${program}/${cycle}`);
-        }
-        catch (error) {
-            throw new Error(`Failed to get seller standards profile: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
+        return await withApiError('Failed to get seller standards profile', () => this.client.get(`${this.basePath}/seller_standards_profile/${program}/${cycle}`));
     }
     /**
      * Get customer service metrics
@@ -92,11 +78,6 @@ export class AnalyticsApi {
         const params = {
             evaluation_marketplace_id: evaluationMarketplaceId,
         };
-        try {
-            return await this.client.get(`${this.basePath}/customer_service_metric/${customerServiceMetricType}/${evaluationType}`, params);
-        }
-        catch (error) {
-            throw new Error(`Failed to get customer service metric: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
+        return await withApiError('Failed to get customer service metric', () => this.client.get(`${this.basePath}/customer_service_metric/${customerServiceMetricType}/${evaluationType}`, params));
     }
 }

package/build/api/client-trading.js

@@ -1,5 +1,6 @@
-import axios from 'axios';
 import { XMLBuilder, XMLParser } from 'fast-xml-parser';
+import { getBaseUrl } from '../config/environment.js';
+import { httpRequest } from '../utils/http.js';
 import { apiLogger } from '../utils/logger.js';
 import { isRecord } from '../utils/type-guards.js';
 const COMPAT_LEVEL = '1451';
@@ -14,8 +15,8 @@ export class TradingApiClient {
     builder;
     constructor(restClient) {
         this.restClient = restClient;
-        const env = restClient.getConfig().environment;
-        this.baseUrl = env === 'sandbox' ? 'https://api.sandbox.ebay.com' : 'https://api.ebay.com';
+        const config = restClient.getConfig();
+        this.baseUrl = getBaseUrl(config.environment, config.apiBaseUrl);
         this.parser = new XMLParser({
             ignoreAttributes: false,
             removeNSPrefix: true,
@@ -53,7 +54,6 @@ export class TradingApiClient {
      * Execute a named Trading API call with XML request/response conversion.
      */
     async execute(callName, params) {
-        const token = await this.restClient.getOAuthClient().getAccessToken();
         const requestTag = `${callName}Request`;
         const responseTag = `${callName}Response`;
         const xmlObj = {};
@@ -63,18 +63,28 @@ export class TradingApiClient {
         };
         const xmlBody = `<?xml version="1.0" encoding="utf-8"?>\n${this.builder.build(xmlObj)}`;
         apiLogger.debug(`Trading API ${callName}`, { xmlBody });
-        let response;
+        const headers = {
+            'X-EBAY-API-SITEID': SITE_ID,
+            'X-EBAY-API-COMPATIBILITY-LEVEL': COMPAT_LEVEL,
+            'X-EBAY-API-CALL-NAME': callName,
+            'Content-Type': 'text/xml',
+        };
+        // Proxy auth mode: omit the IAF token and skip token acquisition — the proxy
+        // injects the credential the Trading API requires.
+        if (!this.restClient.getConfig().disableAuthHeader) {
+            headers['X-EBAY-API-IAF-TOKEN'] = await this.restClient.getOAuthClient().getAccessToken();
+        }
+        let responseXml;
         try {
-            response = await axios.post(`${this.baseUrl}/ws/api.dll`, xmlBody, {
-                headers: {
-                    'X-EBAY-API-SITEID': SITE_ID,
-                    'X-EBAY-API-COMPATIBILITY-LEVEL': COMPAT_LEVEL,
-                    'X-EBAY-API-CALL-NAME': callName,
-                    'X-EBAY-API-IAF-TOKEN': token,
-                    'Content-Type': 'text/xml',
-                },
-                timeout: 30000,
+            const response = await httpRequest({
+                method: 'POST',
+                url: `${this.baseUrl}/ws/api.dll`,
+                headers,
+                body: xmlBody,
+                timeoutMs: 30000,
+                responseType: 'text',
             });
+            responseXml = response.data;
         }
         catch (error) {
             const message = error instanceof Error ? error.message : 'Unknown HTTP error';
@@ -82,7 +92,7 @@ export class TradingApiClient {
         }
         let parsed;
         try {
-            const parsedValue = this.parser.parse(response.data);
+            const parsedValue = this.parser.parse(responseXml);
             if (!isRecord(parsedValue)) {
                 throw new Error('Trading API response must be an object');
             }