ebay-mcp 1.4.3

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/index.d.ts

@@ -0,0 +1,96 @@
+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 { 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 type { EbayConfig } from '../types/ebay.js';
+/**
+ * Main API facade providing access to all eBay APIs
+ */
+export declare class EbaySellerApi {
+    private client;
+    account: AccountApi;
+    inventory: InventoryApi;
+    fulfillment: FulfillmentApi;
+    dispute: DisputeApi;
+    marketing: MarketingApi;
+    recommendation: RecommendationApi;
+    analytics: AnalyticsApi;
+    metadata: MetadataApi;
+    taxonomy: TaxonomyApi;
+    negotiation: NegotiationApi;
+    message: MessageApi;
+    notification: NotificationApi;
+    feedback: FeedbackApi;
+    identity: IdentityApi;
+    compliance: ComplianceApi;
+    vero: VeroApi;
+    translation: TranslationApi;
+    edelivery: EDeliveryApi;
+    constructor(config: EbayConfig);
+    /**
+     * Initialize the API (load tokens from storage)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the API client is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Check if user tokens are available
+     */
+    hasUserTokens(): boolean;
+    /**
+     * Set user access and refresh tokens
+     */
+    setUserTokens(accessToken: string, refreshToken: string): Promise<void>;
+    /**
+     * Get OAuth client for advanced operations
+     */
+    getAuthClient(): EbayApiClient;
+    /**
+     * Get token information for debugging
+     */
+    getTokenInfo(): {
+        hasUserToken: boolean;
+        hasAppAccessToken: boolean;
+        scopeInfo?: {
+            tokenScopes: string[];
+            environmentScopes: string[];
+            missingScopes: string[];
+        };
+    };
+}
+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';

package/build/api/index.js

@@ -0,0 +1,121 @@
+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 { 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';
+/**
+ * Main API facade providing access to all eBay APIs
+ */
+export class EbaySellerApi {
+    client;
+    // API categories
+    account;
+    inventory;
+    fulfillment;
+    dispute;
+    marketing;
+    recommendation;
+    analytics;
+    metadata;
+    taxonomy;
+    negotiation;
+    message;
+    notification;
+    feedback;
+    identity;
+    compliance;
+    vero;
+    translation;
+    edelivery;
+    constructor(config) {
+        this.client = new EbayApiClient(config);
+        // Initialize API category handlers
+        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);
+    }
+    /**
+     * Initialize the API (load tokens from storage)
+     */
+    async initialize() {
+        await this.client.initialize();
+    }
+    /**
+     * Check if the API client is authenticated
+     */
+    isAuthenticated() {
+        return this.client.isAuthenticated();
+    }
+    /**
+     * Check if user tokens are available
+     */
+    hasUserTokens() {
+        return this.client.hasUserTokens();
+    }
+    /**
+     * Set user access and refresh tokens
+     */
+    async setUserTokens(accessToken, refreshToken) {
+        await this.client.setUserTokens(accessToken, refreshToken);
+    }
+    /**
+     * Get OAuth client for advanced operations
+     */
+    getAuthClient() {
+        return this.client;
+    }
+    /**
+     * Get token information for debugging
+     */
+    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';