ebay-mcp-remote-edition 1.0.0

package/build/utils/other/edelivery.js

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for eDelivery API input validation
+ * Based on: src/api/other/edelivery.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/sell_edelivery_international_shipping_oas3.json
+ * Types from: src/types/sell_edelivery_international_shipping_oas3.ts
+ *
+ * Note: The eDelivery API is only available for Greater-China based sellers with an active eDIS account.
+ */
+// Reusable schema for ID parameters
+const idSchema = (name, description) => z.string({
+    message: `${name} is required`,
+    required_error: `${name.toLowerCase().replace(/\s+/g, '_')} is required`,
+    invalid_type_error: `${name.toLowerCase().replace(/\s+/g, '_')} must be a string`,
+    description,
+});
+// Reusable schema for query parameters
+const paramsSchema = z
+    .record(z.string(), {
+    description: 'Query parameters for the request',
+})
+    .optional();
+// Reusable schema for request body objects
+const requestBodySchema = (name) => z.record(z.unknown(), {
+    message: `${name} is required`,
+    required_error: `${name.toLowerCase().replace(/\s+/g, '_')} is required`,
+    invalid_type_error: `${name.toLowerCase().replace(/\s+/g, '_')} must be an object`,
+    description: `The ${name.toLowerCase()} containing required details`,
+});
+/**
+ * Schema for createShippingQuote method
+ * Endpoint: POST /shipping_quote
+ * Body: ShippingQuoteRequest - complex object with shipping details
+ */
+export const createShippingQuoteSchema = z.object({
+    shipping_quote_request: requestBodySchema('Shipping quote request'),
+});
+/**
+ * Schema for getShippingQuote method
+ * Endpoint: GET /shipping_quote/{shipping_quote_id}
+ * Path: shipping_quote_id (required)
+ */
+export const getShippingQuoteSchema = z.object({
+    shipping_quote_id: idSchema('Shipping quote ID', 'The unique identifier for the shipping quote'),
+});
+// ==================== Cost & Preferences ====================
+/**
+ * Schema for getActualCosts method
+ * Endpoint: GET /actual_costs
+ */
+export const getActualCostsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getAddressPreferences method
+ * Endpoint: GET /address_preference
+ */
+export const getAddressPreferencesSchema = z.object({});
+/**
+ * Schema for createAddressPreference method
+ * Endpoint: POST /address_preference
+ */
+export const createAddressPreferenceSchema = z.object({
+    address_preference: requestBodySchema('Address preference'),
+});
+/**
+ * Schema for getConsignPreferences method
+ * Endpoint: GET /consign_preference
+ */
+export const getConsignPreferencesSchema = z.object({});
+/**
+ * Schema for createConsignPreference method
+ * Endpoint: POST /consign_preference
+ */
+export const createConsignPreferenceSchema = z.object({
+    consign_preference: requestBodySchema('Consign preference'),
+});
+// ==================== Agents & Services ====================
+/**
+ * Schema for getAgents method
+ * Endpoint: GET /agents
+ */
+export const getAgentsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getBatteryQualifications method
+ * Endpoint: GET /battery_qualifications
+ */
+export const getBatteryQualificationsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getDropoffSites method
+ * Endpoint: GET /dropoff_sites
+ */
+export const getDropoffSitesSchema = z.object({
+    params: z.record(z.string(), {
+        description: 'Query parameters (postal_code, country, etc.)',
+    }),
+});
+/**
+ * Schema for getShippingServices method
+ * Endpoint: GET /services
+ */
+export const getShippingServicesSchema = z.object({
+    params: paramsSchema,
+});
+// ==================== Bundles ====================
+/**
+ * Schema for createBundle method
+ * Endpoint: POST /bundle
+ */
+export const createBundleSchema = z.object({
+    bundle_request: requestBodySchema('Bundle request'),
+});
+/**
+ * Schema for getBundle method
+ * Endpoint: GET /bundle/{bundle_id}
+ */
+export const getBundleSchema = z.object({
+    bundle_id: idSchema('Bundle ID', 'The unique identifier for the bundle'),
+});
+/**
+ * Schema for cancelBundle method
+ * Endpoint: POST /bundle/{bundle_id}/cancel
+ */
+export const cancelBundleSchema = z.object({
+    bundle_id: idSchema('Bundle ID', 'The unique identifier for the bundle to cancel'),
+});
+/**
+ * Schema for getBundleLabel method
+ * Endpoint: GET /bundle/{bundle_id}/label
+ */
+export const getBundleLabelSchema = z.object({
+    bundle_id: idSchema('Bundle ID', 'The unique identifier for the bundle'),
+});
+// ==================== Packages (Single) ====================
+/**
+ * Schema for createPackage method
+ * Endpoint: POST /package
+ */
+export const createPackageSchema = z.object({
+    package_request: requestBodySchema('Package request'),
+});
+/**
+ * Schema for getPackage method
+ * Endpoint: GET /package/{package_id}
+ */
+export const getPackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package'),
+});
+/**
+ * Schema for deletePackage method
+ * Endpoint: DELETE /package/{package_id}
+ */
+export const deletePackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to delete'),
+});
+/**
+ * Schema for getPackageByOrderLineItem method
+ * Endpoint: GET /package/{order_line_item_id}/item
+ */
+export const getPackageByOrderLineItemSchema = z.object({
+    order_line_item_id: idSchema('Order line item ID', 'The order line item identifier'),
+});
+/**
+ * Schema for cancelPackage method
+ * Endpoint: POST /package/{package_id}/cancel
+ */
+export const cancelPackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to cancel'),
+});
+/**
+ * Schema for clonePackage method
+ * Endpoint: POST /package/{package_id}/clone
+ */
+export const clonePackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to clone'),
+});
+/**
+ * Schema for confirmPackage method
+ * Endpoint: POST /package/{package_id}/confirm
+ */
+export const confirmPackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to confirm'),
+});
+// ==================== Packages (Bulk) ====================
+/**
+ * Schema for bulkCancelPackages method
+ * Endpoint: POST /package/bulk_cancel_packages
+ */
+export const bulkCancelPackagesSchema = z.object({
+    bulk_cancel_request: requestBodySchema('Bulk cancel request'),
+});
+/**
+ * Schema for bulkConfirmPackages method
+ * Endpoint: POST /package/bulk_confirm_packages
+ */
+export const bulkConfirmPackagesSchema = z.object({
+    bulk_confirm_request: requestBodySchema('Bulk confirm request'),
+});
+/**
+ * Schema for bulkDeletePackages method
+ * Endpoint: POST /package/bulk_delete_packages
+ */
+export const bulkDeletePackagesSchema = z.object({
+    bulk_delete_request: requestBodySchema('Bulk delete request'),
+});
+// ==================== Labels & Tracking ====================
+/**
+ * Schema for getLabels method
+ * Endpoint: GET /labels
+ */
+export const getLabelsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getHandoverSheet method
+ * Endpoint: GET /handover_sheet
+ */
+export const getHandoverSheetSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getTracking method
+ * Endpoint: GET /tracking
+ */
+export const getTrackingSchema = z.object({
+    params: z.record(z.string(), {
+        description: 'Query parameters (tracking_number required)',
+    }),
+});
+// ==================== Other ====================
+/**
+ * Schema for createComplaint method
+ * Endpoint: POST /complaint
+ */
+export const createComplaintSchema = z.object({
+    complaint_request: requestBodySchema('Complaint request'),
+});

package/build/utils/other/identity.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Identity API input validation
+ * Based on: src/api/other/identity.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_identity_v1_oas3.json
+ * Types from: src/types/commerce_identity_v1_oas3.ts
+ */
+/**
+ * Schema for getUser method
+ * Endpoint: GET /user
+ * No parameters required - retrieves the authenticated user's account profile
+ */
+export const getUserSchema = z.object({});

package/build/utils/other/translation.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Translation API input validation
+ * Based on: src/api/other/translation.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_translation_v1_beta_oas3.json
+ * Types from: src/types/commerce_translation_v1_beta_oas3.ts
+ */
+/**
+ * Schema for translate method
+ * Endpoint: POST /translate
+ * Body: TranslateRequest - from, to, translationContext, text
+ */
+export const translateSchema = z.object({
+    from: z
+        .string({
+        invalid_type_error: 'from must be a string',
+        description: 'The language of the input text to be translated (e.g., en_US, fr_FR, de_DE)',
+    })
+        .optional(),
+    to: z
+        .string({
+        invalid_type_error: 'to must be a string',
+        description: 'The target language for translation (e.g., en_US, fr_FR, de_DE)',
+    })
+        .optional(),
+    translation_context: z
+        .string({
+        invalid_type_error: 'translation_context must be a string',
+        description: 'The listing entity to translate (ITEM_TITLE or ITEM_DESCRIPTION)',
+    })
+        .optional(),
+    text: z
+        .array(z.string({
+        invalid_type_error: 'text array items must be strings',
+        description: 'Text string to translate',
+    }), {
+        invalid_type_error: 'text must be an array',
+        description: 'Array of text to translate (max 1000 chars for ITEM_TITLE, 20,000 for ITEM_DESCRIPTION)',
+    })
+        .optional(),
+});

package/build/utils/other/vero.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for VERO API input validation
+ * Based on: src/api/other/vero.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_vero_v1_oas3.json
+ * Types from: src/types/commerce_vero_v1_oas3.ts
+ *
+ * Note: The VERO API is only available for members of the Verified Rights Owner (VeRO) Program
+ */
+// Reusable schema for filter parameter
+const filterSchema = z
+    .string({
+    message: 'Filter must be a string',
+    invalid_type_error: 'filter must be a string',
+    description: 'Filter criteria for the query (e.g., date range)',
+})
+    .optional();
+// Reusable schema for limit parameter (string in API)
+const limitSchema = z
+    .string({
+    invalid_type_error: 'limit must be a string',
+    description: 'Maximum number of items to return',
+})
+    .optional();
+// Reusable schema for offset parameter (string in API)
+const offsetSchema = z
+    .string({
+    invalid_type_error: 'offset must be a string',
+    description: 'Number of items to skip',
+})
+    .optional();
+/**
+ * Schema for createVeroReport method
+ * Endpoint: POST /vero_report
+ * Body: VeroReportItemsRequest - report data
+ */
+export const createVeroReportSchema = z.object({
+    report_data: z.record(z.unknown(), {
+        message: 'Report data is required',
+        required_error: 'report_data is required',
+        invalid_type_error: 'report_data must be an object',
+        description: 'The VeRO report data containing item details and intellectual property violation information',
+    }),
+});
+/**
+ * Schema for getVeroReport method
+ * Endpoint: GET /vero_report/{vero_report_id}
+ * Path: vero_report_id
+ */
+export const getVeroReportSchema = z.object({
+    vero_report_id: z
+        .string({
+        message: 'VERO report ID is required',
+        required_error: 'vero_report_id is required',
+        invalid_type_error: 'vero_report_id must be a string',
+        description: 'The unique identifier of the VERO report',
+    })
+        .min(1, 'VERO report ID cannot be empty'),
+});
+/**
+ * Schema for getVeroReportItems method
+ * Endpoint: GET /vero_report_items
+ * Query: filter, limit, offset
+ */
+export const getVeroReportItemsSchema = z.object({
+    filter: filterSchema,
+    limit: limitSchema,
+    offset: offsetSchema,
+});
+/**
+ * Schema for getVeroReasonCode method
+ * Endpoint: GET /vero_reason_code/{vero_reason_code_id}
+ * Path: vero_reason_code_id
+ */
+export const getVeroReasonCodeSchema = z.object({
+    vero_reason_code_id: z
+        .string({
+        message: 'VERO reason code ID is required',
+        required_error: 'vero_reason_code_id is required',
+        invalid_type_error: 'vero_reason_code_id must be a string',
+        description: 'The unique identifier of the VERO reason code',
+    })
+        .min(1, 'VERO reason code ID cannot be empty'),
+});
+/**
+ * Schema for getVeroReasonCodes method
+ * Endpoint: GET /vero_reason_code
+ * No parameters required
+ */
+export const getVeroReasonCodesSchema = z.object({});

package/build/utils/scope-helper.js

@@ -0,0 +1,207 @@
+/**
+ * Scope Helper - Manages eBay OAuth scopes
+ */
+import chalk from 'chalk';
+import { getDefaultScopes } from '../config/environment.js';
+/**
+ * Get all available scope categories
+ */
+export function getScopeCategories() {
+    return [
+        {
+            name: 'Inventory Management',
+            description: 'Create, read, update, and delete inventory items',
+            scopes: ['https://api.ebay.com/oauth/api_scope/sell.inventory'],
+            required: true,
+        },
+        {
+            name: 'Order Fulfillment',
+            description: 'View and manage orders, shipping, and fulfillment',
+            scopes: [
+                'https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+                'https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+            ],
+            required: true,
+        },
+        {
+            name: 'Account Management',
+            description: 'Manage account settings, policies, and preferences',
+            scopes: [
+                'https://api.ebay.com/oauth/api_scope/sell.account',
+                'https://api.ebay.com/oauth/api_scope/sell.account.readonly',
+            ],
+            required: true,
+        },
+        {
+            name: 'Analytics & Reports',
+            description: 'Access sales analytics and performance reports',
+            scopes: [
+                'https://api.ebay.com/oauth/api_scope/sell.analytics.readonly',
+                'https://api.ebay.com/oauth/api_scope/sell.marketplace.insights.readonly',
+            ],
+            required: false,
+        },
+        {
+            name: 'Marketing & Promotions',
+            description: 'Create and manage marketing campaigns and promotions',
+            scopes: [
+                'https://api.ebay.com/oauth/api_scope/sell.marketing',
+                'https://api.ebay.com/oauth/api_scope/sell.marketing.readonly',
+            ],
+            required: false,
+        },
+        {
+            name: 'Finance & Payments',
+            description: 'Access financial data and payment information',
+            scopes: ['https://api.ebay.com/oauth/api_scope/sell.finances'],
+            required: false,
+        },
+        {
+            name: 'Reputation & Feedback',
+            description: 'Manage seller reputation and customer feedback',
+            scopes: ['https://api.ebay.com/oauth/api_scope/sell.reputation'],
+            required: false,
+        },
+        {
+            name: 'Commerce Services',
+            description: 'Identity verification, notifications, and messaging',
+            scopes: [
+                'https://api.ebay.com/oauth/api_scope/commerce.identity.readonly',
+                'https://api.ebay.com/oauth/api_scope/commerce.notification.subscription',
+                'https://api.ebay.com/oauth/api_scope/sell.stores',
+            ],
+            required: false,
+        },
+    ];
+}
+/**
+ * Get recommended scopes for the environment
+ */
+export function getRecommendedScopes(environment) {
+    return getDefaultScopes(environment);
+}
+/**
+ * Display scope selection interface
+ */
+export function displayScopeCategories() {
+    console.log(chalk.bold.cyan('\n📋 Available OAuth Scopes\n'));
+    const categories = getScopeCategories();
+    for (const category of categories) {
+        const badge = category.required ? chalk.green('[Required]') : chalk.gray('[Optional]');
+        console.log(`${badge} ${chalk.bold.white(category.name)}`);
+        console.log(`  ${chalk.gray(category.description)}`);
+        console.log(chalk.gray(`  Scopes: ${category.scopes.length}`));
+        console.log('');
+    }
+}
+/**
+ * Verify if token has required scopes
+ */
+export function verifyScopesCoverage(tokenScopes, requiredScopes) {
+    const tokenScopeSet = new Set(tokenScopes);
+    const requiredScopeSet = new Set(requiredScopes);
+    const missingScopes = requiredScopes.filter((scope) => !tokenScopeSet.has(scope));
+    const extraScopes = tokenScopes.filter((scope) => !requiredScopeSet.has(scope));
+    return {
+        hasAllRequired: missingScopes.length === 0,
+        missingScopes,
+        extraScopes,
+    };
+}
+/**
+ * Display scope verification results
+ */
+export function displayScopeVerification(tokenScopes, environment) {
+    console.log(chalk.bold.cyan('\n🔍 Scope Verification\n'));
+    const recommendedScopes = getRecommendedScopes(environment);
+    const verification = verifyScopesCoverage(tokenScopes, recommendedScopes);
+    console.log(chalk.bold.white('Token Scopes:'));
+    console.log(chalk.gray(`  Total: ${tokenScopes.length}\n`));
+    if (verification.hasAllRequired) {
+        console.log(chalk.green('✓ Token has all recommended scopes\n'));
+    }
+    else {
+        console.log(chalk.yellow('⚠️  Token is missing some recommended scopes\n'));
+        console.log(chalk.bold.white('Missing Scopes:'));
+        for (const scope of verification.missingScopes) {
+            console.log(chalk.yellow(`  • ${scope}`));
+        }
+        console.log('');
+    }
+    if (verification.extraScopes.length > 0) {
+        console.log(chalk.gray('Additional Scopes (not in recommended list):'));
+        for (const scope of verification.extraScopes) {
+            console.log(chalk.gray(`  • ${scope}`));
+        }
+        console.log('');
+    }
+    // Display scope categories and their status
+    const categories = getScopeCategories();
+    const tokenScopeSet = new Set(tokenScopes);
+    console.log(chalk.bold.white('Coverage by Category:\n'));
+    for (const category of categories) {
+        const hasAllCategoryScopes = category.scopes.every((scope) => tokenScopeSet.has(scope));
+        const hasSomeCategoryScopes = category.scopes.some((scope) => tokenScopeSet.has(scope));
+        let status;
+        if (hasAllCategoryScopes) {
+            status = chalk.green('✓ Full');
+        }
+        else if (hasSomeCategoryScopes) {
+            status = chalk.yellow('◐ Partial');
+        }
+        else {
+            status = chalk.red('✗ None');
+        }
+        const badge = category.required ? chalk.red('[Required]') : chalk.gray('[Optional]');
+        console.log(`${status} ${badge} ${category.name}`);
+    }
+    console.log('');
+}
+/**
+ * Get scope description
+ */
+export function getScopeDescription(scope) {
+    const descriptions = {
+        'https://api.ebay.com/oauth/api_scope/sell.inventory': 'Manage inventory items and offers',
+        'https://api.ebay.com/oauth/api_scope/sell.fulfillment': 'Manage orders and shipping',
+        'https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly': 'View orders and shipping',
+        'https://api.ebay.com/oauth/api_scope/sell.account': 'Manage account settings',
+        'https://api.ebay.com/oauth/api_scope/sell.account.readonly': 'View account settings',
+        'https://api.ebay.com/oauth/api_scope/sell.analytics.readonly': 'View analytics and reports',
+        'https://api.ebay.com/oauth/api_scope/sell.marketing': 'Manage marketing campaigns',
+        'https://api.ebay.com/oauth/api_scope/sell.marketing.readonly': 'View marketing campaigns',
+        'https://api.ebay.com/oauth/api_scope/sell.finances': 'View financial data',
+        'https://api.ebay.com/oauth/api_scope/sell.reputation': 'Manage seller reputation',
+        'https://api.ebay.com/oauth/api_scope/commerce.identity.readonly': 'View user identity',
+        'https://api.ebay.com/oauth/api_scope/sell.stores': 'Manage eBay Stores',
+        'https://api.ebay.com/oauth/api_scope/commerce.notification.subscription': 'Manage notification subscriptions',
+        'https://api.ebay.com/oauth/api_scope/sell.marketplace.insights.readonly': 'View marketplace insights',
+    };
+    return descriptions[scope] || 'No description available';
+}
+/**
+ * Format scopes for display
+ */
+export function formatScopesForDisplay(scopes) {
+    return scopes
+        .map((scope) => {
+        const shortName = scope.split('/').pop() || scope;
+        return `  • ${shortName}`;
+    })
+        .join('\n');
+}
+/**
+ * Get all scopes as a space-separated string
+ */
+export function getAllScopesString(environment) {
+    return getRecommendedScopes(environment).join(' ');
+}
+/**
+ * Parse scope string to array
+ */
+export function parseScopeString(scopeString) {
+    return scopeString
+        .split(/\s+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}