ebay-mcp 1.4.3

package/build/types/ebay.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Core eBay API types
+ */
+import { type LocaleEnum } from "./ebay-enums.js";
+export interface EbayConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri?: string;
+    locale?: LocaleEnum;
+    environment: 'production' | 'sandbox';
+    accessToken?: string;
+    refreshToken?: string;
+    appAccessToken?: string;
+}
+/**
+ * OAuth token response from eBay
+ * Supports both client credentials and authorization code grants
+ */
+export interface EbayAuthToken {
+    accessToken: string;
+    tokenType: string;
+    expiresIn: number;
+    refreshToken: string;
+    refreshTokenExpiresIn?: number;
+}
+/**
+ * App access token response from client credentials flow
+ * Used for application-level operations (1,000 requests/day)
+ * No refresh token - app tokens are short-lived and re-generated
+ */
+export interface EbayAppAccessTokenResponse {
+    access_token: string;
+    expires_in: number;
+    token_type: string;
+}
+/**
+ * User access token with refresh token
+ * Used for user-specific operations (10,000-50,000 requests/day)
+ */
+export interface EbayUserToken {
+    access_token: string;
+    refresh_token: string;
+    token_type: string;
+    expires_in: number;
+    refresh_token_expires_in: number;
+    scope?: string;
+}
+/**
+ * Stored user token data with expiry timestamps
+ */
+export interface StoredTokenData {
+    userAccessToken: string;
+    userRefreshToken: string;
+    tokenType: string;
+    clientId: string;
+    clientSecret: string;
+    redirectUri?: string;
+    locale?: LocaleEnum;
+    envAppToken?: string;
+    userAccessTokenExpiry?: number;
+    userRefreshTokenExpiry?: number;
+    scope?: string;
+}
+export interface EbayApiResponse<T = unknown> {
+    data: T;
+    warnings?: {
+        category: string;
+        domain: string;
+        errorId: number;
+        message: string;
+    }[];
+}
+export interface EbayApiError {
+    errors: {
+        errorId: number;
+        domain: string;
+        category: string;
+        message: string;
+        longMessage?: string;
+        parameters?: {
+            name: string;
+            value: string;
+        }[];
+    }[];
+}
+/**
+ * API category identifiers matching docs structure
+ */
+export declare enum EbayApiCategory {
+    ACCOUNT_MANAGEMENT = "account-management",
+    ANALYTICS_AND_REPORT = "analytics-and-report",
+    COMMUNICATION = "communication",
+    LISTING_MANAGEMENT = "listing-management",
+    LISTING_METADATA = "listing-metadata",
+    MARKETING_AND_PROMOTIONS = "marketing-and-promotions",
+    ORDER_MANAGEMENT = "order-management",
+    OTHER = "other"
+}
+/**
+ * Specific API identifiers
+ */
+export declare enum EbayApi {
+    ACCOUNT = "sell/account/v1",
+    ANALYTICS = "sell/analytics/v1",
+    NEGOTIATION = "sell/negotiation/v1",
+    MESSAGE = "commerce/message/v1",
+    NOTIFICATION = "commerce/notification/v1",
+    FEEDBACK = "commerce/feedback/v1",
+    INVENTORY = "sell/inventory/v1",
+    METADATA = "sell/metadata/v1",
+    MARKETING = "sell/marketing/v1",
+    RECOMMENDATION = "sell/recommendation/v1",
+    FULFILLMENT = "sell/fulfillment/v1",
+    IDENTITY = "commerce/identity/v1",
+    VERO = "commerce/vero/v1",
+    COMPLIANCE = "sell/compliance/v1",
+    TRANSLATION = "commerce/translation/v1",
+    EDELIVERY = "sell/logistics/v1"
+}
+export declare const productionScopes: string[];
+export declare const sandboxScopes: string[];
+/**
+ * OAuth API endpoints
+ */
+export declare enum EbayOAuthApi {
+    TOKEN = "/identity/v1/oauth2/token",
+    AUTHORIZE_SANDBOX = "https://auth.sandbox.ebay.com/oauth2/authorize",
+    AUTHORIZE_PRODUCTION = "https://auth.ebay.com/oauth2/authorize",
+    SIGNIN_SANDBOX = "https://signin.sandbox.ebay.com/signin",
+    SIGNIN_PRODUCTION = "https://signin.ebay.com/signin"
+}
+/**
+ * OAuth parameter descriptions
+ */
+export interface EbayOAuthParams {
+    client_id: string;
+    redirect_uri: string;
+    response_type: 'code';
+    scope: string;
+    state?: string;
+    locale?: string;
+    prompt?: 'login';
+}

package/build/types/ebay.js

@@ -0,0 +1,123 @@
+/**
+ * Core eBay API types
+ */
+/**
+ * API category identifiers matching docs structure
+ */
+export var EbayApiCategory;
+(function (EbayApiCategory) {
+    EbayApiCategory["ACCOUNT_MANAGEMENT"] = "account-management";
+    EbayApiCategory["ANALYTICS_AND_REPORT"] = "analytics-and-report";
+    EbayApiCategory["COMMUNICATION"] = "communication";
+    EbayApiCategory["LISTING_MANAGEMENT"] = "listing-management";
+    EbayApiCategory["LISTING_METADATA"] = "listing-metadata";
+    EbayApiCategory["MARKETING_AND_PROMOTIONS"] = "marketing-and-promotions";
+    EbayApiCategory["ORDER_MANAGEMENT"] = "order-management";
+    EbayApiCategory["OTHER"] = "other";
+})(EbayApiCategory || (EbayApiCategory = {}));
+/**
+ * Specific API identifiers
+ */
+export var EbayApi;
+(function (EbayApi) {
+    // Account Management
+    EbayApi["ACCOUNT"] = "sell/account/v1";
+    // Analytics and Report
+    EbayApi["ANALYTICS"] = "sell/analytics/v1";
+    // Communication
+    EbayApi["NEGOTIATION"] = "sell/negotiation/v1";
+    EbayApi["MESSAGE"] = "commerce/message/v1";
+    EbayApi["NOTIFICATION"] = "commerce/notification/v1";
+    EbayApi["FEEDBACK"] = "commerce/feedback/v1";
+    // Listing Management
+    EbayApi["INVENTORY"] = "sell/inventory/v1";
+    // Listing Metadata
+    EbayApi["METADATA"] = "sell/metadata/v1";
+    // Marketing and Promotions
+    EbayApi["MARKETING"] = "sell/marketing/v1";
+    EbayApi["RECOMMENDATION"] = "sell/recommendation/v1";
+    // Order Management
+    EbayApi["FULFILLMENT"] = "sell/fulfillment/v1";
+    // Other APIs
+    EbayApi["IDENTITY"] = "commerce/identity/v1";
+    EbayApi["VERO"] = "commerce/vero/v1";
+    EbayApi["COMPLIANCE"] = "sell/compliance/v1";
+    EbayApi["TRANSLATION"] = "commerce/translation/v1";
+    EbayApi["EDELIVERY"] = "sell/logistics/v1";
+})(EbayApi || (EbayApi = {}));
+export const productionScopes = [
+    'https://api.ebay.com/oauth/api_scope',
+    'https://api.ebay.com/oauth/api_scope/sell.marketing.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.inventory.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.inventory',
+    'https://api.ebay.com/oauth/api_scope/sell.account',
+    'https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+    'https://api.ebay.com/oauth/api_scope/sell.analytics.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.marketing',
+    'https://api.ebay.com/oauth/api_scope/sell.account.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.finances',
+    'https://api.ebay.com/oauth/api_scope/sell.payment.dispute',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.reputation',
+    'https://api.ebay.com/oauth/api_scope/sell.reputation.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.notification.subscription',
+    'https://api.ebay.com/oauth/api_scope/commerce.notification.subscription.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.stores',
+    'https://api.ebay.com/oauth/api_scope/sell.stores.readonly',
+    'https://api.ebay.com/oauth/scope/sell.edelivery',
+    'https://api.ebay.com/oauth/api_scope/commerce.vero',
+    'https://api.ebay.com/oauth/api_scope/sell.inventory.mapping',
+    'https://api.ebay.com/oauth/api_scope/commerce.message',
+    'https://api.ebay.com/oauth/api_scope/commerce.feedback',
+    'https://api.ebay.com/oauth/api_scope/commerce.shipping',
+    'https://api.ebay.com/oauth/api_scope/commerce.feedback.readonly',
+];
+export const sandboxScopes = [
+    'https://api.ebay.com/oauth/api_scope',
+    'https://api.ebay.com/oauth/api_scope/sell.marketing.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.marketing',
+    'https://api.ebay.com/oauth/api_scope/sell.inventory.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.inventory',
+    'https://api.ebay.com/oauth/api_scope/sell.account.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.account',
+    'https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+    'https://api.ebay.com/oauth/api_scope/sell.analytics.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.finances',
+    'https://api.ebay.com/oauth/api_scope/sell.payment.dispute',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.reputation',
+    'https://api.ebay.com/oauth/api_scope/sell.reputation.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.notification.subscription',
+    'https://api.ebay.com/oauth/api_scope/commerce.notification.subscription.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.stores',
+    'https://api.ebay.com/oauth/api_scope/sell.stores.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.edelivery',
+    'https://api.ebay.com/oauth/api_scope/commerce.vero',
+    'https://api.ebay.com/oauth/api_scope/sell.inventory.mapping',
+    'https://api.ebay.com/oauth/api_scope/commerce.message',
+    'https://api.ebay.com/oauth/api_scope/commerce.feedback',
+    'https://api.ebay.com/oauth/api_scope/commerce.shipping',
+    'https://api.ebay.com/oauth/api_scope/commerce.feedback.readonly',
+    'https://api.ebay.com/oauth/api_scope/sell.item.draft',
+    'https://api.ebay.com/oauth/api_scope/sell.item',
+    'https://api.ebay.com/oauth/api_scope/sell.marketplace.insights.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.email.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.phone.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.address.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.name.readonly',
+    'https://api.ebay.com/oauth/api_scope/commerce.identity.status.readonly',
+];
+/**
+ * OAuth API endpoints
+ */
+export var EbayOAuthApi;
+(function (EbayOAuthApi) {
+    EbayOAuthApi["TOKEN"] = "/identity/v1/oauth2/token";
+    EbayOAuthApi["AUTHORIZE_SANDBOX"] = "https://auth.sandbox.ebay.com/oauth2/authorize";
+    EbayOAuthApi["AUTHORIZE_PRODUCTION"] = "https://auth.ebay.com/oauth2/authorize";
+    EbayOAuthApi["SIGNIN_SANDBOX"] = "https://signin.sandbox.ebay.com/signin";
+    EbayOAuthApi["SIGNIN_PRODUCTION"] = "https://signin.ebay.com/signin";
+})(EbayOAuthApi || (EbayOAuthApi = {}));

package/build/types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Main types index
+ * Exports all eBay types for easy importing
+ */
+export * from './ebay.js';
+export * from './ebay-enums.js';

package/build/types/index.js

@@ -0,0 +1,10 @@
+/**
+ * Main types index
+ * Exports all eBay types for easy importing
+ */
+// Core eBay types
+export * from './ebay.js';
+// eBay API enums
+export * from './ebay-enums.js';
+// OpenAPI generated types are imported directly as needed
+// due to their size and specific usage patterns