ebay-mcp-remote-edition 1.0.0

package/build/api/communication/notification.js

@@ -0,0 +1,373 @@
+/**
+ * Notification API - Event notifications and subscriptions
+ * Based on: docs/sell-apps/communication/commerce_notification_v1_oas3.json
+ */
+export class NotificationApi {
+    client;
+    basePath = '/commerce/notification/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get public key for validating notifications
+     * @throws Error if required parameters are missing or invalid
+     */
+    async getPublicKey(publicKeyId) {
+        if (!publicKeyId || typeof publicKeyId !== 'string') {
+            throw new Error('publicKeyId is required and must be a string');
+        }
+        try {
+            return await this.client.get(`${this.basePath}/public_key/${publicKeyId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to get public key: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get notification config
+     * @throws Error if the request fails
+     */
+    async getConfig() {
+        try {
+            return await this.client.get(`${this.basePath}/config`);
+        }
+        catch (error) {
+            throw new Error(`Failed to get config: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Update notification config
+     * @throws Error if required parameters are missing or invalid
+     */
+    async updateConfig(config) {
+        if (!config || typeof config !== 'object') {
+            throw new Error('config is required and must be an object');
+        }
+        try {
+            return await this.client.put(`${this.basePath}/config`, config);
+        }
+        catch (error) {
+            throw new Error(`Failed to update config: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get all destinations (paginated)
+     * @throws Error if the request fails
+     */
+    async getDestinations(limit, continuationToken) {
+        const params = {};
+        if (limit !== undefined)
+            params.limit = String(limit);
+        if (continuationToken)
+            params.continuation_token = continuationToken;
+        try {
+            return await this.client.get(`${this.basePath}/destination`, params);
+        }
+        catch (error) {
+            throw new Error(`Failed to get destinations: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get destination
+     * @throws Error if required parameters are missing or invalid
+     */
+    async getDestination(destinationId) {
+        if (!destinationId || typeof destinationId !== 'string') {
+            throw new Error('destinationId is required and must be a string');
+        }
+        try {
+            return await this.client.get(`${this.basePath}/destination/${destinationId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to get destination: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Create destination
+     * @throws Error if required parameters are missing or invalid
+     */
+    async createDestination(destination) {
+        if (!destination || typeof destination !== 'object') {
+            throw new Error('destination is required and must be an object');
+        }
+        try {
+            return await this.client.post(`${this.basePath}/destination`, destination);
+        }
+        catch (error) {
+            throw new Error(`Failed to create destination: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Update destination
+     * @throws Error if required parameters are missing or invalid
+     */
+    async updateDestination(destinationId, destination) {
+        if (!destinationId || typeof destinationId !== 'string') {
+            throw new Error('destinationId is required and must be a string');
+        }
+        if (!destination || typeof destination !== 'object') {
+            throw new Error('destination is required and must be an object');
+        }
+        try {
+            return await this.client.put(`${this.basePath}/destination/${destinationId}`, destination);
+        }
+        catch (error) {
+            throw new Error(`Failed to update destination: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Delete destination
+     * @throws Error if required parameters are missing or invalid
+     */
+    async deleteDestination(destinationId) {
+        if (!destinationId || typeof destinationId !== 'string') {
+            throw new Error('destinationId is required and must be a string');
+        }
+        try {
+            return await this.client.delete(`${this.basePath}/destination/${destinationId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to delete destination: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get all subscriptions
+     * Endpoint: GET /subscription
+     * @throws Error if the request fails
+     */
+    async getSubscriptions(limit, continuationToken) {
+        const params = {};
+        if (limit !== undefined) {
+            if (typeof limit !== 'number' || limit < 1) {
+                throw new Error('limit must be a positive number when provided');
+            }
+            params.limit = limit;
+        }
+        if (continuationToken !== undefined) {
+            if (typeof continuationToken !== 'string') {
+                throw new Error('continuationToken must be a string when provided');
+            }
+            params.continuation_token = continuationToken;
+        }
+        try {
+            return await this.client.get(`${this.basePath}/subscription`, params);
+        }
+        catch (error) {
+            throw new Error(`Failed to get subscriptions: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Create a subscription
+     * Endpoint: POST /subscription
+     * @throws Error if required parameters are missing or invalid
+     */
+    async createSubscription(subscription) {
+        if (!subscription || typeof subscription !== 'object') {
+            throw new Error('subscription is required and must be an object');
+        }
+        try {
+            return await this.client.post(`${this.basePath}/subscription`, subscription);
+        }
+        catch (error) {
+            throw new Error(`Failed to create subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get a subscription
+     * Endpoint: GET /subscription/{subscription_id}
+     * @throws Error if required parameters are missing or invalid
+     */
+    async getSubscription(subscriptionId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        try {
+            return await this.client.get(`${this.basePath}/subscription/${subscriptionId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to get subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Update a subscription
+     * Endpoint: PUT /subscription/{subscription_id}
+     * @throws Error if required parameters are missing or invalid
+     */
+    async updateSubscription(subscriptionId, subscription) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        if (!subscription || typeof subscription !== 'object') {
+            throw new Error('subscription is required and must be an object');
+        }
+        try {
+            return await this.client.put(`${this.basePath}/subscription/${subscriptionId}`, subscription);
+        }
+        catch (error) {
+            throw new Error(`Failed to update subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Delete a subscription
+     * Endpoint: DELETE /subscription/{subscription_id}
+     * @throws Error if required parameters are missing or invalid
+     */
+    async deleteSubscription(subscriptionId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        try {
+            return await this.client.delete(`${this.basePath}/subscription/${subscriptionId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to delete subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Disable a subscription
+     * Endpoint: POST /subscription/{subscription_id}/disable
+     * @throws Error if required parameters are missing or invalid
+     */
+    async disableSubscription(subscriptionId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        try {
+            return await this.client.post(`${this.basePath}/subscription/${subscriptionId}/disable`, {});
+        }
+        catch (error) {
+            throw new Error(`Failed to disable subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Enable a subscription
+     * Endpoint: POST /subscription/{subscription_id}/enable
+     * @throws Error if required parameters are missing or invalid
+     */
+    async enableSubscription(subscriptionId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        try {
+            return await this.client.post(`${this.basePath}/subscription/${subscriptionId}/enable`, {});
+        }
+        catch (error) {
+            throw new Error(`Failed to enable subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Test a subscription
+     * Endpoint: POST /subscription/{subscription_id}/test
+     * @throws Error if required parameters are missing or invalid
+     */
+    async testSubscription(subscriptionId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        try {
+            return await this.client.post(`${this.basePath}/subscription/${subscriptionId}/test`, {});
+        }
+        catch (error) {
+            throw new Error(`Failed to test subscription: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get a topic
+     * Endpoint: GET /topic/{topic_id}
+     * @throws Error if required parameters are missing or invalid
+     */
+    async getTopic(topicId) {
+        if (!topicId || typeof topicId !== 'string') {
+            throw new Error('topicId is required and must be a string');
+        }
+        try {
+            return await this.client.get(`${this.basePath}/topic/${topicId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to get topic: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get all topics
+     * Endpoint: GET /topic
+     * @throws Error if the request fails
+     */
+    async getTopics(limit, continuationToken) {
+        const params = {};
+        if (limit !== undefined) {
+            if (typeof limit !== 'number' || limit < 1) {
+                throw new Error('limit must be a positive number when provided');
+            }
+            params.limit = limit;
+        }
+        if (continuationToken !== undefined) {
+            if (typeof continuationToken !== 'string') {
+                throw new Error('continuationToken must be a string when provided');
+            }
+            params.continuation_token = continuationToken;
+        }
+        try {
+            return await this.client.get(`${this.basePath}/topic`, params);
+        }
+        catch (error) {
+            throw new Error(`Failed to get topics: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Create a subscription filter
+     * Endpoint: POST /subscription/{subscription_id}/filter
+     * @throws Error if required parameters are missing or invalid
+     */
+    async createSubscriptionFilter(subscriptionId, filter) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        if (!filter || typeof filter !== 'object') {
+            throw new Error('filter is required and must be an object');
+        }
+        try {
+            return await this.client.post(`${this.basePath}/subscription/${subscriptionId}/filter`, filter);
+        }
+        catch (error) {
+            throw new Error(`Failed to create subscription filter: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get a subscription filter
+     * Endpoint: GET /subscription/{subscription_id}/filter/{filter_id}
+     * @throws Error if required parameters are missing or invalid
+     */
+    async getSubscriptionFilter(subscriptionId, filterId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        if (!filterId || typeof filterId !== 'string') {
+            throw new Error('filterId is required and must be a string');
+        }
+        try {
+            return await this.client.get(`${this.basePath}/subscription/${subscriptionId}/filter/${filterId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to get subscription filter: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Delete a subscription filter
+     * Endpoint: DELETE /subscription/{subscription_id}/filter/{filter_id}
+     * @throws Error if required parameters are missing or invalid
+     */
+    async deleteSubscriptionFilter(subscriptionId, filterId) {
+        if (!subscriptionId || typeof subscriptionId !== 'string') {
+            throw new Error('subscriptionId is required and must be a string');
+        }
+        if (!filterId || typeof filterId !== 'string') {
+            throw new Error('filterId is required and must be a string');
+        }
+        try {
+            return await this.client.delete(`${this.basePath}/subscription/${subscriptionId}/filter/${filterId}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to delete subscription filter: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}

package/build/api/developer/developer.js

@@ -0,0 +1,81 @@
+/**
+ * Developer API - Rate limits, client registration, and signing keys
+ * Based on:
+ * - docs/sell-apps/application-settings/developer_analytics_v1_beta_oas3.json
+ * - docs/sell-apps/application-settings/developer_client_registration_v1_oas3.json
+ * - docs/sell-apps/application-settings/developer_key_management_v1_oas3.json
+ */
+export class DeveloperApi {
+    client;
+    analyticsBasePath = '/developer/analytics/v1_beta';
+    clientBasePath = '/developer/client_registration/v1';
+    keyBasePath = '/developer/key_management/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    // ========================================
+    // RATE LIMITS (Analytics API)
+    // ========================================
+    /**
+     * Get application rate limits
+     * Endpoint: GET /rate_limit/
+     */
+    async getRateLimits(apiContext, apiName) {
+        const params = {};
+        if (apiContext)
+            params.api_context = apiContext;
+        if (apiName)
+            params.api_name = apiName;
+        return await this.client.get(`${this.analyticsBasePath}/rate_limit/`, Object.keys(params).length > 0 ? params : undefined);
+    }
+    /**
+     * Get user rate limits
+     * Endpoint: GET /user_rate_limit/
+     */
+    async getUserRateLimits(apiContext, apiName) {
+        const params = {};
+        if (apiContext)
+            params.api_context = apiContext;
+        if (apiName)
+            params.api_name = apiName;
+        return await this.client.get(`${this.analyticsBasePath}/user_rate_limit/`, Object.keys(params).length > 0 ? params : undefined);
+    }
+    // ========================================
+    // CLIENT REGISTRATION
+    // ========================================
+    /**
+     * Register a new third party financial application with eBay
+     * Endpoint: POST /client/register
+     * Note: This is primarily for Open Banking / PSD2 compliance
+     */
+    async registerClient(clientSettings) {
+        return await this.client.post(`${this.clientBasePath}/client/register`, clientSettings);
+    }
+    // ========================================
+    // SIGNING KEY MANAGEMENT
+    // ========================================
+    /**
+     * Get all signing keys for the application
+     * Endpoint: GET /signing_key
+     */
+    async getSigningKeys() {
+        return await this.client.get(`${this.keyBasePath}/signing_key`);
+    }
+    /**
+     * Create a new signing key
+     * Endpoint: POST /signing_key
+     */
+    async createSigningKey(request) {
+        return await this.client.post(`${this.keyBasePath}/signing_key`, request || {});
+    }
+    /**
+     * Get a specific signing key by ID
+     * Endpoint: GET /signing_key/{signing_key_id}
+     */
+    async getSigningKey(signingKeyId) {
+        if (!signingKeyId || typeof signingKeyId !== 'string') {
+            throw new Error('signingKeyId is required and must be a string');
+        }
+        return await this.client.get(`${this.keyBasePath}/signing_key/${signingKeyId}`);
+    }
+}

package/build/api/index.js

@@ -0,0 +1,109 @@
+import { AccountApi } from '../api/account-management/account.js';
+import { AnalyticsApi } from '../api/analytics-and-report/analytics.js';
+import { EbayApiClient } from '../api/client.js';
+import { FeedbackApi } from '../api/communication/feedback.js';
+import { MessageApi } from '../api/communication/message.js';
+import { NegotiationApi } from '../api/communication/negotiation.js';
+import { NotificationApi } from '../api/communication/notification.js';
+import { DeveloperApi } from '../api/developer/developer.js';
+import { InventoryApi } from '../api/listing-management/inventory.js';
+import { MetadataApi } from '../api/listing-metadata/metadata.js';
+import { TaxonomyApi } from '../api/listing-metadata/taxonomy.js';
+import { MarketingApi } from '../api/marketing-and-promotions/marketing.js';
+import { RecommendationApi } from '../api/marketing-and-promotions/recommendation.js';
+import { DisputeApi } from '../api/order-management/dispute.js';
+import { FulfillmentApi } from '../api/order-management/fulfillment.js';
+import { ComplianceApi } from '../api/other/compliance.js';
+import { EDeliveryApi } from '../api/other/edelivery.js';
+import { IdentityApi } from '../api/other/identity.js';
+import { TranslationApi } from '../api/other/translation.js';
+import { VeroApi } from '../api/other/vero.js';
+import { TradingApiClient } from '../api/client-trading.js';
+import { TradingApi } from '../api/trading/trading.js';
+export class EbaySellerApi {
+    client;
+    account;
+    inventory;
+    fulfillment;
+    dispute;
+    marketing;
+    recommendation;
+    analytics;
+    metadata;
+    taxonomy;
+    negotiation;
+    message;
+    notification;
+    feedback;
+    identity;
+    compliance;
+    vero;
+    translation;
+    edelivery;
+    developer;
+    trading;
+    constructor(config, context) {
+        this.client = new EbayApiClient(config, context);
+        this.account = new AccountApi(this.client);
+        this.inventory = new InventoryApi(this.client);
+        this.fulfillment = new FulfillmentApi(this.client);
+        this.dispute = new DisputeApi(this.client);
+        this.marketing = new MarketingApi(this.client);
+        this.recommendation = new RecommendationApi(this.client);
+        this.analytics = new AnalyticsApi(this.client);
+        this.metadata = new MetadataApi(this.client);
+        this.taxonomy = new TaxonomyApi(this.client);
+        this.negotiation = new NegotiationApi(this.client);
+        this.message = new MessageApi(this.client);
+        this.notification = new NotificationApi(this.client);
+        this.feedback = new FeedbackApi(this.client);
+        this.identity = new IdentityApi(this.client);
+        this.compliance = new ComplianceApi(this.client);
+        this.vero = new VeroApi(this.client);
+        this.translation = new TranslationApi(this.client);
+        this.edelivery = new EDeliveryApi(this.client);
+        this.developer = new DeveloperApi(this.client);
+        const tradingClient = new TradingApiClient(this.client);
+        this.trading = new TradingApi(tradingClient);
+    }
+    async initialize() {
+        await this.client.initialize();
+    }
+    isAuthenticated() {
+        return this.client.isAuthenticated();
+    }
+    hasUserTokens() {
+        return this.client.hasUserTokens();
+    }
+    async setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry) {
+        await this.client.setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry);
+    }
+    getAuthClient() {
+        return this.client;
+    }
+    getTokenInfo() {
+        return this.client.getTokenInfo();
+    }
+}
+export * from '../api/account-management/account.js';
+export * from '../api/analytics-and-report/analytics.js';
+export * from '../api/client.js';
+export * from '../api/communication/feedback.js';
+export * from '../api/communication/message.js';
+export * from '../api/communication/negotiation.js';
+export * from '../api/communication/notification.js';
+export * from '../api/listing-management/inventory.js';
+export * from '../api/listing-metadata/metadata.js';
+export * from '../api/listing-metadata/taxonomy.js';
+export * from '../api/marketing-and-promotions/marketing.js';
+export * from '../api/marketing-and-promotions/recommendation.js';
+export * from '../api/order-management/dispute.js';
+export * from '../api/order-management/fulfillment.js';
+export * from '../api/other/compliance.js';
+export * from '../api/other/edelivery.js';
+export * from '../api/other/identity.js';
+export * from '../api/other/translation.js';
+export * from '../api/other/vero.js';
+export * from '../api/developer/developer.js';
+export * from '../api/trading/trading.js';
+export * from '../api/client-trading.js';