ebay-mcp 1.13.2 → 1.14.0

package/build/api/developer/developer.js

@@ -1,4 +1,5 @@
-import { withApiError } from '../../api/shared/request.js';
+import { buildEndpointParams, requestGetEffect, requestPostEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
 /**
  * Developer API - Rate limits, client registration, and signing keys
  * Based on:
@@ -18,65 +19,118 @@ export class DeveloperApi {
     // RATE LIMITS (Analytics API)
     // ========================================
     /**
-     * Get application rate limits
-     * Endpoint: GET /rate_limit/
+     * Retrieves application rate-limit usage across eBay APIs.
+     *
+     * @param input - Optional API context and API name filters.
+     * @returns An Effect that succeeds with eBay's generated RateLimitsResponse.
+     *
+     * @example
+     * ```ts
+     * const limits = await Effect.runPromise(
+     *   developerApi.getRateLimits({ apiContext: 'sell', apiName: 'inventory' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/developer/analytics/resources/rate_limit/methods/getRateLimits
      */
-    async getRateLimits(apiContext, apiName) {
-        const params = {};
-        if (apiContext)
-            params.api_context = apiContext;
-        if (apiName)
-            params.api_name = apiName;
-        return await withApiError('Failed to get rate limits', () => this.client.get(`${this.analyticsBasePath}/rate_limit/`, Object.keys(params).length > 0 ? params : undefined));
-    }
+    getRateLimits = (input = {}) => {
+        const params = buildEndpointParams({
+            apiContext: { wireName: 'api_context', value: input.apiContext },
+            apiName: { wireName: 'api_name', value: input.apiName },
+        });
+        return requestGetEffect(this.client, `${this.analyticsBasePath}/rate_limit/`, params);
+    };
     /**
-     * Get user rate limits
-     * Endpoint: GET /user_rate_limit/
+     * Retrieves user-specific rate-limit usage across eBay APIs.
+     *
+     * @param input - Optional API context and API name filters.
+     * @returns An Effect that succeeds with eBay's generated RateLimitsResponse.
+     *
+     * @example
+     * ```ts
+     * const limits = await Effect.runPromise(developerApi.getUserRateLimits({ apiContext: 'sell' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/developer/analytics/resources/user_rate_limit/methods/getUserRateLimits
      */
-    async getUserRateLimits(apiContext, apiName) {
-        const params = {};
-        if (apiContext)
-            params.api_context = apiContext;
-        if (apiName)
-            params.api_name = apiName;
-        return await withApiError('Failed to get user rate limits', () => this.client.get(`${this.analyticsBasePath}/user_rate_limit/`, Object.keys(params).length > 0 ? params : undefined));
-    }
+    getUserRateLimits = (input = {}) => {
+        const params = buildEndpointParams({
+            apiContext: { wireName: 'api_context', value: input.apiContext },
+            apiName: { wireName: 'api_name', value: input.apiName },
+        });
+        return requestGetEffect(this.client, `${this.analyticsBasePath}/user_rate_limit/`, params);
+    };
     // ========================================
     // CLIENT REGISTRATION
     // ========================================
     /**
-     * Register a new third party financial application with eBay
-     * Endpoint: POST /client/register
-     * Note: This is primarily for Open Banking / PSD2 compliance
+     * Registers a third-party financial application with eBay.
+     *
+     * @param input - Generated ClientSettings request body.
+     * @returns An Effect that succeeds with eBay's generated ClientDetails response.
+     *
+     * @example
+     * ```ts
+     * const client = await Effect.runPromise(
+     *   developerApi.registerClient({ clientSettings }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/developer/client_registration/resources/client/methods/registerClient
      */
-    async registerClient(clientSettings) {
-        return await withApiError('Failed to register client', () => this.client.post(`${this.clientBasePath}/client/register`, clientSettings));
-    }
+    registerClient = (input) => requestPostEffect(this.client, `${this.clientBasePath}/client/register`, input.clientSettings);
     // ========================================
     // SIGNING KEY MANAGEMENT
     // ========================================
     /**
-     * Get all signing keys for the application
-     * Endpoint: GET /signing_key
+     * Retrieves all signing keys for the application.
+     *
+     * @param input - Empty endpoint input object.
+     * @returns An Effect that succeeds with eBay's generated QuerySigningKeysResponse.
+     *
+     * @example
+     * ```ts
+     * const keys = await Effect.runPromise(developerApi.getSigningKeys({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/developer/key_management/resources/signing_key/methods/getSigningKeys
      */
-    async getSigningKeys() {
-        return await withApiError('Failed to get signing keys', () => this.client.get(`${this.keyBasePath}/signing_key`));
-    }
+    getSigningKeys = (input = {}) => {
+        void input;
+        return requestGetEffect(this.client, `${this.keyBasePath}/signing_key`);
+    };
     /**
-     * Create a new signing key
-     * Endpoint: POST /signing_key
+     * Creates a signing keypair for API digital signatures.
+     *
+     * @param input - Optional signing-key cipher request body.
+     * @returns An Effect that succeeds with eBay's generated SigningKey response.
+     *
+     * @example
+     * ```ts
+     * const key = await Effect.runPromise(
+     *   developerApi.createSigningKey({ request: { signingKeyCipher: 'RSA' } }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/developer/key_management/resources/signing_key/methods/createSigningKey
      */
-    async createSigningKey(request) {
-        return await withApiError('Failed to create signing key', () => this.client.post(`${this.keyBasePath}/signing_key`, request || {}));
-    }
+    createSigningKey = (input = {}) => requestPostEffect(this.client, `${this.keyBasePath}/signing_key`, input.request ?? {});
     /**
-     * Get a specific signing key by ID
-     * Endpoint: GET /signing_key/{signing_key_id}
+     * Retrieves a specific signing key by eBay signing key ID.
+     *
+     * @param input - eBay-generated signing key identifier.
+     * @returns An Effect that succeeds with eBay's generated SigningKey response.
+     *
+     * @example
+     * ```ts
+     * const key = await Effect.runPromise(developerApi.getSigningKey({ signingKeyId: 'key_001' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/developer/key_management/resources/signing_key/methods/getSigningKey
      */
-    async getSigningKey(signingKeyId) {
-        if (!signingKeyId || typeof signingKeyId !== 'string') {
-            throw new Error('signingKeyId is required and must be a string');
-        }
-        return await withApiError('Failed to get signing key', () => this.client.get(`${this.keyBasePath}/signing_key/${signingKeyId}`));
-    }
+    getSigningKey = (input) => Effect.gen(this, function* () {
+        const endpointInput = yield* requireObjectEffect(input, 'input');
+        const signingKeyId = yield* requireStringEffect(endpointInput.signingKeyId, 'signingKeyId');
+        return yield* requestGetEffect(this.client, `${this.keyBasePath}/signing_key/${signingKeyId}`);
+    });
 }

package/build/api/index.js

@@ -15,16 +15,18 @@ 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 { FindingApi } from '../api/other/finding.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 { TradingApiClient } from '../api/clientTrading.js';
 import { TradingApi } from '../api/trading/trading.js';
 /**
  * Main API facade providing access to all eBay APIs
  */
 export class EbaySellerApi {
     client;
+    config;
     // API categories
     account;
     inventory;
@@ -44,9 +46,11 @@ export class EbaySellerApi {
     vero;
     translation;
     edelivery;
+    finding;
     developer;
     trading;
     constructor(config) {
+        this.config = config;
         this.client = new EbayApiClient(config);
         // Initialize API category handlers
         this.account = new AccountApi(this.client);
@@ -67,6 +71,7 @@ export class EbaySellerApi {
         this.vero = new VeroApi(this.client);
         this.translation = new TranslationApi(this.client);
         this.edelivery = new EDeliveryApi(this.client);
+        this.finding = new FindingApi(this.client);
         this.developer = new DeveloperApi(this.client);
         const tradingClient = new TradingApiClient(this.client);
         this.trading = new TradingApi(tradingClient);
@@ -74,9 +79,7 @@ export class EbaySellerApi {
     /**
      * Initialize the API (load tokens from storage)
      */
-    async initialize() {
-        await this.client.initialize();
-    }
+    initialize = () => this.client.initialize();
     /**
      * Check if the API client is authenticated
      */
@@ -92,15 +95,26 @@ export class EbaySellerApi {
     /**
      * Set user access and refresh tokens
      */
-    async setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry) {
-        await this.client.setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry);
-    }
+    setUserTokens = (accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry) => this.client.setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry);
     /**
      * Get OAuth client for advanced operations
      */
     getAuthClient() {
         return this.client;
     }
+    /**
+     * Returns the validated runtime configuration used to construct this API facade.
+     *
+     * @returns eBay API runtime configuration with credentials, environment, and proxy flags.
+     *
+     * @example
+     * ```ts
+     * const environment = api.getConfig().environment;
+     * ```
+     */
+    getConfig() {
+        return this.config;
+    }
     /**
      * Get token information for debugging
      */
@@ -124,9 +138,10 @@ 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/finding.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';
+export * from '../api/clientTrading.js';