ebay-mcp 1.13.2 → 1.14.0

package/build/utils/other/edelivery.js

@@ -1,235 +0,0 @@
-import { z } from 'zod';
-import { idSchema } from '../schema-helpers.js';
-/**
- * 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 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/schema-helpers.js

@@ -1,13 +0,0 @@
-import { z } from 'zod';
-/**
- * Reusable schema builder for required string ID parameters.
- */
-export function idSchema(name, description) {
-    const normalized = name.toLowerCase().replace(/\s+/g, '_');
-    return z.string({
-        message: `${name} is required`,
-        required_error: `${normalized} is required`,
-        invalid_type_error: `${normalized} must be a string`,
-        description,
-    });
-}

package/build/utils/scope-helper.js

@@ -1,207 +0,0 @@
-/**
- * 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 for a full OAuth scope URL.
- */
-export function describeScopeFromOAuthUrl(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);
-}