ebay-mcp-remote-edition 1.0.0

package/build/api/marketing-and-promotions/recommendation.js

@@ -0,0 +1,32 @@
+/**
+ * Recommendation API - Listing recommendations
+ * Based on: docs/sell-apps/marketing-and-promotions/sell_recommendation_v1_oas3.json
+ */
+export class RecommendationApi {
+    client;
+    basePath = '/sell/recommendation/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Find listing recommendations
+     * Endpoint: POST /find
+     */
+    async findListingRecommendations(requestBody, filter, limit, offset, marketplaceId) {
+        const params = {};
+        if (filter)
+            params.filter = filter;
+        if (limit)
+            params.limit = limit;
+        if (offset)
+            params.offset = offset;
+        const headers = {};
+        if (marketplaceId) {
+            headers['X-EBAY-C-MARKETPLACE-ID'] = marketplaceId;
+        }
+        return await this.client.post(`${this.basePath}/find`, requestBody || {}, {
+            params,
+            headers,
+        });
+    }
+}

package/build/api/order-management/dispute.js

@@ -0,0 +1,69 @@
+/**
+ * Dispute API - Manage payment disputes
+ * Based on: docs/sell-apps/order-management/sell_fulfillment_v1_oas3.json
+ */
+export class DisputeApi {
+    client;
+    basePath = '/sell/fulfillment/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get payment dispute details
+     */
+    async getPaymentDispute(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}`);
+    }
+    /**
+     * Get payment dispute evidence file
+     */
+    async fetchEvidenceContent(paymentDisputeId, evidenceId, fileId) {
+        const params = {
+            evidence_id: evidenceId,
+            file_id: fileId,
+        };
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}/fetch_evidence_content`, params);
+    }
+    /**
+     * Get payment dispute activity
+     */
+    async getActivities(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}/activity`);
+    }
+    /**
+     * Search for payment disputes
+     */
+    async getPaymentDisputeSummaries(params) {
+        return await this.client.get(`${this.basePath}/payment_dispute_summary`, params);
+    }
+    /**
+     * Contest a payment dispute
+     */
+    async contestPaymentDispute(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/contest`, body);
+    }
+    /**
+     * Accept a payment dispute
+     */
+    async acceptPaymentDispute(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/accept`, body);
+    }
+    /**
+     * Upload an evidence file
+     */
+    async uploadEvidenceFile(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/upload_evidence_file`, body, { headers: { 'Content-Type': 'multipart/form-data' } });
+    }
+    /**
+     * Add an evidence file
+     */
+    async addEvidence(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/add_evidence`, body);
+    }
+    /**
+     * Update an evidence file
+     */
+    async updateEvidence(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/update_evidence`, body);
+    }
+}

package/build/api/order-management/fulfillment.js

@@ -0,0 +1,89 @@
+/**
+ * Fulfillment API - Order processing and shipping
+ * Based on: docs/sell-apps/order-management/sell_fulfillment_v1_oas3.json
+ */
+export class FulfillmentApi {
+    client;
+    basePath = '/sell/fulfillment/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get orders for the seller
+     */
+    async getOrders(filter, limit, offset) {
+        const params = {};
+        if (filter)
+            params.filter = filter;
+        if (limit)
+            params.limit = limit;
+        if (offset)
+            params.offset = offset;
+        return await this.client.get(`${this.basePath}/order`, params);
+    }
+    /**
+     * Get a specific order
+     */
+    async getOrder(orderId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}`);
+    }
+    /**
+     * Create a shipping fulfillment
+     */
+    async createShippingFulfillment(orderId, fulfillment) {
+        return await this.client.post(`${this.basePath}/order/${orderId}/shipping_fulfillment`, fulfillment);
+    }
+    /**
+     * Get shipping fulfillments for an order
+     */
+    async getShippingFulfillments(orderId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}/shipping_fulfillment`);
+    }
+    /**
+     * Get a specific shipping fulfillment
+     * @param orderId The unique identifier of the order.
+     * @param fulfillmentId The unique identifier of the fulfillment.
+     */
+    async getShippingFulfillment(orderId, fulfillmentId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}/shipping_fulfillment/${fulfillmentId}`);
+    }
+    /**
+     * Issue a refund
+     */
+    async issueRefund(orderId, refund) {
+        return await this.client.post(`${this.basePath}/order/${orderId}/issue_refund`, refund);
+    }
+    /**
+     * Get payment dispute summaries
+     * Note: This method delegates to the DisputeApi
+     */
+    async getPaymentDisputeSummaries(params) {
+        return await this.client.get(`${this.basePath}/payment_dispute_summary`, params);
+    }
+    /**
+     * Get payment dispute activities
+     * Note: This method delegates to the DisputeApi
+     */
+    async getActivities(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}/activity`);
+    }
+    /**
+     * Get payment dispute details
+     * Note: This method delegates to the DisputeApi
+     */
+    async getPaymentDispute(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}`);
+    }
+    /**
+     * Get shipping quote
+     */
+    async getShippingQuote(request) {
+        return await this.client.post(`${this.basePath}/shipping_quote`, request);
+    }
+    /**
+     * Get cancellation details for an order
+     */
+    async getCancellation(orderId, cancellationId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}/cancellation/${cancellationId}`);
+    }
+}

package/build/api/other/compliance.js

@@ -0,0 +1,47 @@
+/**
+ * Compliance API - Listing compliance checks
+ * Based on: docs/sell-apps/other-apis/sell_compliance_v1_oas3.json
+ */
+export class ComplianceApi {
+    client;
+    basePath = '/sell/compliance/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get listing violations
+     */
+    async getListingViolations(complianceType, offset, limit) {
+        const params = {};
+        if (complianceType)
+            params.compliance_type = complianceType;
+        if (offset)
+            params.offset = offset;
+        if (limit)
+            params.limit = limit;
+        return await this.client.get(`${this.basePath}/listing_violation`, params);
+    }
+    /**
+     * Get listing violation summary
+     */
+    async getListingViolationsSummary(complianceType) {
+        const params = {};
+        if (complianceType)
+            params.compliance_type = complianceType;
+        return await this.client.get(`${this.basePath}/listing_violation_summary`, params);
+    }
+    /**
+     * Suppress a violation
+     */
+    async suppressViolation(listingViolationId) {
+        return await this.client.post(`${this.basePath}/suppress_violation`, {
+            listing_violation_id: listingViolationId,
+        });
+    }
+    /**
+     * Get compliance snapshot (alias for getListingViolations)
+     */
+    async getComplianceSnapshot(complianceType, offset, limit) {
+        return await this.getListingViolations(complianceType, offset, limit);
+    }
+}

package/build/api/other/edelivery.js

@@ -0,0 +1,219 @@
+/**
+ * eDelivery API - International shipping eDelivery
+ * Based on: docs/sell-apps/other-apis/sell_edelivery_international_shipping_oas3.json
+ */
+export class EDeliveryApi {
+    client;
+    basePath = '/sell/logistics/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create shipping quote
+     */
+    async createShippingQuote(shippingQuoteRequest) {
+        return await this.client.post(`${this.basePath}/shipping_quote`, shippingQuoteRequest);
+    }
+    /**
+     * Get shipping quote
+     */
+    async getShippingQuote(shippingQuoteId) {
+        return await this.client.get(`${this.basePath}/shipping_quote/${shippingQuoteId}`);
+    }
+    // ==================== Cost & Preferences ====================
+    /**
+     * Get actual costs for shipped packages
+     * Endpoint: GET /actual_costs
+     */
+    async getActualCosts(params) {
+        return await this.client.get(`${this.basePath}/actual_costs`, params);
+    }
+    /**
+     * Get address preferences
+     * Endpoint: GET /address_preference
+     */
+    async getAddressPreferences() {
+        return await this.client.get(`${this.basePath}/address_preference`);
+    }
+    /**
+     * Create address preference
+     * Endpoint: POST /address_preference
+     */
+    async createAddressPreference(addressPreference) {
+        return await this.client.post(`${this.basePath}/address_preference`, addressPreference);
+    }
+    /**
+     * Get consign preferences
+     * Endpoint: GET /consign_preference
+     */
+    async getConsignPreferences() {
+        return await this.client.get(`${this.basePath}/consign_preference`);
+    }
+    /**
+     * Create consign preference
+     * Endpoint: POST /consign_preference
+     */
+    async createConsignPreference(consignPreference) {
+        return await this.client.post(`${this.basePath}/consign_preference`, consignPreference);
+    }
+    // ==================== Agents & Services ====================
+    /**
+     * Get available shipping agents
+     * Endpoint: GET /agents
+     */
+    async getAgents(params) {
+        return await this.client.get(`${this.basePath}/agents`, params);
+    }
+    /**
+     * Get battery qualifications
+     * Endpoint: GET /battery_qualifications
+     */
+    async getBatteryQualifications(params) {
+        return await this.client.get(`${this.basePath}/battery_qualifications`, params);
+    }
+    /**
+     * Get dropoff sites
+     * Endpoint: GET /dropoff_sites
+     */
+    async getDropoffSites(params) {
+        return await this.client.get(`${this.basePath}/dropoff_sites`, params);
+    }
+    /**
+     * Get available shipping services
+     * Endpoint: GET /services
+     */
+    async getShippingServices(params) {
+        return await this.client.get(`${this.basePath}/services`, params);
+    }
+    // ==================== Bundles ====================
+    /**
+     * Create a bundle of packages
+     * Endpoint: POST /bundle
+     */
+    async createBundle(bundleRequest) {
+        return await this.client.post(`${this.basePath}/bundle`, bundleRequest);
+    }
+    /**
+     * Get bundle by ID
+     * Endpoint: GET /bundle/{bundle_id}
+     */
+    async getBundle(bundleId) {
+        return await this.client.get(`${this.basePath}/bundle/${bundleId}`);
+    }
+    /**
+     * Cancel a bundle
+     * Endpoint: POST /bundle/{bundle_id}/cancel
+     */
+    async cancelBundle(bundleId) {
+        return await this.client.post(`${this.basePath}/bundle/${bundleId}/cancel`, {});
+    }
+    /**
+     * Get bundle label
+     * Endpoint: GET /bundle/{bundle_id}/label
+     */
+    async getBundleLabel(bundleId) {
+        return await this.client.get(`${this.basePath}/bundle/${bundleId}/label`);
+    }
+    // ==================== Packages (Single) ====================
+    /**
+     * Create a package
+     * Endpoint: POST /package
+     */
+    async createPackage(packageRequest) {
+        return await this.client.post(`${this.basePath}/package`, packageRequest);
+    }
+    /**
+     * Get package by ID
+     * Endpoint: GET /package/{package_id}
+     */
+    async getPackage(packageId) {
+        return await this.client.get(`${this.basePath}/package/${packageId}`);
+    }
+    /**
+     * Delete a package
+     * Endpoint: DELETE /package/{package_id}
+     */
+    async deletePackage(packageId) {
+        return await this.client.delete(`${this.basePath}/package/${packageId}`);
+    }
+    /**
+     * Get package by order line item
+     * Endpoint: GET /package/{order_line_item_id}/item
+     */
+    async getPackageByOrderLineItem(orderLineItemId) {
+        return await this.client.get(`${this.basePath}/package/${orderLineItemId}/item`);
+    }
+    /**
+     * Cancel a package
+     * Endpoint: POST /package/{package_id}/cancel
+     */
+    async cancelPackage(packageId) {
+        return await this.client.post(`${this.basePath}/package/${packageId}/cancel`, {});
+    }
+    /**
+     * Clone a package
+     * Endpoint: POST /package/{package_id}/clone
+     */
+    async clonePackage(packageId) {
+        return await this.client.post(`${this.basePath}/package/${packageId}/clone`, {});
+    }
+    /**
+     * Confirm a package
+     * Endpoint: POST /package/{package_id}/confirm
+     */
+    async confirmPackage(packageId) {
+        return await this.client.post(`${this.basePath}/package/${packageId}/confirm`, {});
+    }
+    // ==================== Packages (Bulk) ====================
+    /**
+     * Bulk cancel packages
+     * Endpoint: POST /package/bulk_cancel_packages
+     */
+    async bulkCancelPackages(bulkCancelRequest) {
+        return await this.client.post(`${this.basePath}/package/bulk_cancel_packages`, bulkCancelRequest);
+    }
+    /**
+     * Bulk confirm packages
+     * Endpoint: POST /package/bulk_confirm_packages
+     */
+    async bulkConfirmPackages(bulkConfirmRequest) {
+        return await this.client.post(`${this.basePath}/package/bulk_confirm_packages`, bulkConfirmRequest);
+    }
+    /**
+     * Bulk delete packages
+     * Endpoint: POST /package/bulk_delete_packages
+     */
+    async bulkDeletePackages(bulkDeleteRequest) {
+        return await this.client.post(`${this.basePath}/package/bulk_delete_packages`, bulkDeleteRequest);
+    }
+    // ==================== Labels & Tracking ====================
+    /**
+     * Get labels
+     * Endpoint: GET /labels
+     */
+    async getLabels(params) {
+        return await this.client.get(`${this.basePath}/labels`, params);
+    }
+    /**
+     * Get handover sheet
+     * Endpoint: GET /handover_sheet
+     */
+    async getHandoverSheet(params) {
+        return await this.client.get(`${this.basePath}/handover_sheet`, params);
+    }
+    /**
+     * Get tracking information
+     * Endpoint: GET /tracking
+     */
+    async getTracking(params) {
+        return await this.client.get(`${this.basePath}/tracking`, params);
+    }
+    // ==================== Other ====================
+    /**
+     * Create a complaint
+     * Endpoint: POST /complaint
+     */
+    async createComplaint(complaintRequest) {
+        return await this.client.post(`${this.basePath}/complaint`, complaintRequest);
+    }
+}

package/build/api/other/identity.js

@@ -0,0 +1,24 @@
+import { getIdentityBaseUrl } from '../../config/environment.js';
+/**
+ * Identity API - User identity verification
+ * Based on: docs/sell-apps/other-apis/commerce_identity_v1_oas3.json
+ *
+ * Note: Identity API uses apiz subdomain instead of api
+ */
+export class IdentityApi {
+    client;
+    basePath = '/commerce/identity/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get user information
+     * Uses apiz.ebay.com instead of api.ebay.com
+     */
+    async getUser() {
+        const config = this.client.getConfig();
+        const identityBaseUrl = getIdentityBaseUrl(config.environment);
+        const fullUrl = `${identityBaseUrl}${this.basePath}/user`;
+        return await this.client.getWithFullUrl(fullUrl);
+    }
+}

package/build/api/other/translation.js

@@ -0,0 +1,22 @@
+/**
+ * Translation API - Translation services
+ * Based on: docs/sell-apps/other-apis/commerce_translation_v1_beta_oas3.json
+ */
+export class TranslationApi {
+    client;
+    basePath = '/commerce/translation/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Translate listing text
+     */
+    async translate(from, to, translationContext, text) {
+        return await this.client.post(`${this.basePath}/translate`, {
+            from,
+            to,
+            translationContext,
+            text,
+        });
+    }
+}

package/build/api/other/vero.js

@@ -0,0 +1,48 @@
+/**
+ * VERO API - Verified Rights Owner program
+ * Based on: docs/sell-apps/other-apis/commerce_vero_v1_oas3.json
+ */
+export class VeroApi {
+    client;
+    basePath = '/commerce/vero/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a VERO report to report intellectual property infringement
+     */
+    async createVeroReport(reportData) {
+        return await this.client.post(`${this.basePath}/vero_report`, reportData);
+    }
+    /**
+     * Get a specific VERO report by ID
+     */
+    async getVeroReport(veroReportId) {
+        return await this.client.get(`${this.basePath}/vero_report/${veroReportId}`);
+    }
+    /**
+     * Get VERO report items (listings reported for infringement)
+     */
+    async getVeroReportItems(filter, limit, offset) {
+        const params = {};
+        if (filter)
+            params.filter = filter;
+        if (limit)
+            params.limit = limit;
+        if (offset)
+            params.offset = offset;
+        return await this.client.get(`${this.basePath}/vero_report_items`, params);
+    }
+    /**
+     * Get a specific VERO reason code by ID
+     */
+    async getVeroReasonCode(veroReasonCodeId) {
+        return await this.client.get(`${this.basePath}/vero_reason_code/${veroReasonCodeId}`);
+    }
+    /**
+     * Get all available VERO reason codes
+     */
+    async getVeroReasonCodes() {
+        return await this.client.get(`${this.basePath}/vero_reason_code`);
+    }
+}

package/build/api/trading/trading.js

@@ -0,0 +1,78 @@
+export class TradingApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getActiveListings(page = 1, entriesPerPage = 50) {
+        const result = await this.client.execute('GetMyeBaySelling', {
+            ActiveList: {
+                Sort: 'TimeLeft',
+                Pagination: {
+                    EntriesPerPage: entriesPerPage,
+                    PageNumber: page,
+                },
+            },
+        });
+        const activeList = result.ActiveList;
+        const itemArray = activeList?.ItemArray;
+        const items = itemArray?.Item || [];
+        const pagination = activeList?.PaginationResult;
+        const listings = items.map((item) => {
+            const sellingStatus = item.SellingStatus;
+            const currentPrice = sellingStatus?.CurrentPrice;
+            const priceValue = typeof currentPrice === 'object' && currentPrice !== null
+                ? Number(currentPrice['#text'] || 0)
+                : Number(currentPrice || 0);
+            return {
+                itemId: String(item.ItemID ?? ''),
+                title: String(item.Title ?? ''),
+                sku: String(item.SKU ?? ''),
+                quantity: Number(item.Quantity || 0),
+                quantityAvailable: Number(item.QuantityAvailable || 0),
+                currentPrice: priceValue,
+                watchCount: Number(item.WatchCount || 0),
+                listingType: String(item.ListingType ?? ''),
+            };
+        });
+        return {
+            listings,
+            total: Number(pagination?.TotalNumberOfEntries || 0),
+            totalPages: Number(pagination?.TotalNumberOfPages || 0),
+        };
+    }
+    async getListing(itemId) {
+        if (!itemId)
+            throw new Error('itemId is required');
+        const result = await this.client.execute('GetItem', {
+            ItemID: itemId,
+            DetailLevel: 'ReturnAll',
+        });
+        const items = result.Item;
+        return items?.[0] || result;
+    }
+    async createListing(item) {
+        return await this.client.execute('AddFixedPriceItem', { Item: item });
+    }
+    async reviseListing(itemId, fields) {
+        if (!itemId)
+            throw new Error('itemId is required');
+        return await this.client.execute('ReviseFixedPriceItem', {
+            Item: { ...fields, ItemID: itemId },
+        });
+    }
+    async endListing(itemId, reason = 'NotAvailable') {
+        if (!itemId)
+            throw new Error('itemId is required');
+        return await this.client.execute('EndFixedPriceItem', {
+            ItemID: itemId,
+            EndingReason: reason,
+        });
+    }
+    async relistItem(itemId, modifications) {
+        if (!itemId)
+            throw new Error('itemId is required');
+        return await this.client.execute('RelistFixedPriceItem', {
+            Item: { ...modifications, ItemID: itemId },
+        });
+    }
+}

package/build/auth/kv-store.js

@@ -0,0 +1,40 @@
+import axios from 'axios';
+export class CloudflareKVStore {
+    client;
+    accountId;
+    namespaceId;
+    constructor() {
+        this.accountId = process.env.CLOUDFLARE_ACCOUNT_ID || '';
+        this.namespaceId = process.env.CLOUDFLARE_KV_NAMESPACE_ID || '';
+        const apiToken = process.env.CLOUDFLARE_API_TOKEN || '';
+        this.client = axios.create({
+            baseURL: `https://api.cloudflare.com/client/v4/accounts/${this.accountId}/storage/kv/namespaces/${this.namespaceId}`,
+            headers: {
+                Authorization: `Bearer ${apiToken}`,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+        });
+    }
+    async get(key) {
+        try {
+            const response = await this.client.get(`/values/${encodeURIComponent(key)}`, {
+                responseType: 'text',
+            });
+            return JSON.parse(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error) && error.response?.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async put(key, value, expirationTtl) {
+        const params = expirationTtl ? { expiration_ttl: expirationTtl } : undefined;
+        await this.client.put(`/values/${encodeURIComponent(key)}`, JSON.stringify(value), { params });
+    }
+    async delete(key) {
+        await this.client.delete(`/values/${encodeURIComponent(key)}`);
+    }
+}