ebay-mcp-remote-edition 1.0.0

package/build/scripts/diagnostics.js

@@ -0,0 +1,301 @@
+/**
+ * Diagnostics Script - Troubleshooting and system health checks
+ *
+ * Usage:
+ *   npm run diagnose
+ *   npx ebay-mcp-remote-edition --diagnose
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { runSecurityChecks, displaySecurityResults } from '../utils/security-checker.js';
+import { validateSetup, displayRecommendations } from '../utils/setup-validator.js';
+import { detectLLMClients } from '../utils/llm-client-detector.js';
+import { displayScopeVerification, parseScopeString } from '../utils/scope-helper.js';
+import { EbaySellerApi } from '../api/index.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_ROOT = join(__dirname, '../..');
+/**
+ * Parse .env file
+ */
+function parseEnvFile(filePath) {
+    const env = {};
+    if (!existsSync(filePath)) {
+        return env;
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        const match = /^([^=]+)=(.*)$/.exec(trimmed);
+        if (match) {
+            const key = match[1].trim();
+            let value = match[2].trim();
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            env[key] = value;
+        }
+    }
+    return env;
+}
+/**
+ * Check API connectivity
+ */
+async function checkApiConnectivity() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch('https://api.ebay.com/health', {
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        return { canReachEbay: response.ok || response.status === 404 };
+    }
+    catch (error) {
+        return {
+            canReachEbay: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Test eBay API authentication
+ */
+async function testEbayAuthentication(config) {
+    try {
+        const api = new EbaySellerApi(config);
+        await api.initialize();
+        // Try to get user info
+        const userInfo = await api.identity.getUser();
+        return { success: true, userInfo };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Display diagnostic header
+ */
+function displayHeader() {
+    console.clear();
+    console.log(chalk.bold.cyan(`
+╔══════════════════════════════════════════════════════════════╗
+║                                                              ║
+║              eBay MCP Server Diagnostics                     ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+  `));
+    console.log(chalk.gray(`Run date: ${new Date().toISOString()}\n`));
+}
+/**
+ * Display system information
+ */
+function displaySystemInfo() {
+    console.log(chalk.bold.cyan('💻 System Information\n'));
+    console.log(`  ${chalk.gray('Node.js:')} ${process.version}`);
+    console.log(`  ${chalk.gray('Platform:')} ${process.platform}`);
+    console.log(`  ${chalk.gray('Architecture:')} ${process.arch}`);
+    console.log(`  ${chalk.gray('CWD:')} ${process.cwd()}`);
+    console.log('');
+}
+/**
+ * Display configuration status
+ */
+function displayConfigurationStatus(envVars) {
+    console.log(chalk.bold.cyan('⚙️  Configuration Status\n'));
+    const checks = [
+        { key: 'EBAY_CLIENT_ID', label: 'Client ID', redact: true },
+        { key: 'EBAY_CLIENT_SECRET', label: 'Client Secret', redact: true },
+        { key: 'EBAY_REDIRECT_URI', label: 'Redirect URI', redact: false },
+        { key: 'EBAY_ENVIRONMENT', label: 'Environment', redact: false },
+        { key: 'EBAY_MARKETPLACE_ID', label: 'Marketplace ID', redact: false },
+        { key: 'EBAY_CONTENT_LANGUAGE', label: 'Content Language', redact: false },
+        { key: 'EBAY_USER_REFRESH_TOKEN', label: 'User Refresh Token', redact: true },
+        { key: 'EBAY_USER_ACCESS_TOKEN', label: 'User Access Token', redact: true },
+        { key: 'EBAY_APP_ACCESS_TOKEN', label: 'App Access Token', redact: true },
+    ];
+    for (const check of checks) {
+        const value = envVars[check.key];
+        let status;
+        let displayValue;
+        if (value && value.trim() && !value.includes('_here')) {
+            status = chalk.green('✓ Set');
+            displayValue = check.redact ? `${value.substring(0, 10)}...` : value;
+        }
+        else {
+            status = chalk.red('✗ Not set');
+            displayValue = chalk.gray('(not configured)');
+        }
+        console.log(`  ${status} ${chalk.bold(check.label)}: ${displayValue}`);
+    }
+    console.log('');
+}
+/**
+ * Display LLM client status
+ */
+function displayLLMClientStatus() {
+    console.log(chalk.bold.cyan('🤖 LLM Client Detection\n'));
+    const clients = detectLLMClients();
+    for (const client of clients) {
+        const detected = client.detected ? chalk.green('✓ Detected') : chalk.gray('✗ Not found');
+        const configured = client.configExists
+            ? chalk.green('[Configured]')
+            : chalk.gray('[Not configured]');
+        console.log(`  ${detected} ${chalk.bold(client.displayName)} ${configured}`);
+        if (client.detected) {
+            console.log(chalk.gray(`    Config: ${client.configPath}`));
+        }
+    }
+    console.log('');
+}
+/**
+ * Test API authentication and display results
+ */
+async function displayAuthenticationTest(config) {
+    console.log(chalk.bold.cyan('🔐 API Authentication Test\n'));
+    const result = await testEbayAuthentication(config);
+    if (result.success) {
+        console.log(chalk.green('  ✓ Successfully authenticated with eBay API\n'));
+        if (result.userInfo) {
+            console.log(chalk.bold.white('  User Information:'));
+            console.log(chalk.gray(JSON.stringify(result.userInfo, null, 2)));
+            console.log('');
+        }
+    }
+    else {
+        console.log(chalk.red('  ✗ Authentication failed\n'));
+        console.log(chalk.yellow(`  Error: ${result.error}\n`));
+    }
+}
+/**
+ * Generate diagnostic report
+ */
+async function generateDiagnosticReport(exportPath) {
+    const envPath = join(PROJECT_ROOT, '.env');
+    const envVars = parseEnvFile(envPath);
+    // Run security checks
+    const securityResults = await runSecurityChecks(PROJECT_ROOT);
+    // Run configuration validation
+    const validationSummary = await validateSetup(PROJECT_ROOT);
+    // Detect LLM clients
+    const llmClients = detectLLMClients();
+    // Check API connectivity
+    const apiConnection = await checkApiConnectivity();
+    const report = {
+        timestamp: new Date().toISOString(),
+        environment: {
+            nodeVersion: process.version,
+            platform: process.platform,
+            arch: process.arch,
+        },
+        security: securityResults,
+        configuration: validationSummary,
+        llmClients,
+        apiConnection,
+    };
+    // If we have credentials, test authentication
+    if (envVars.EBAY_CLIENT_ID && envVars.EBAY_CLIENT_SECRET) {
+        const config = {
+            clientId: envVars.EBAY_CLIENT_ID,
+            clientSecret: envVars.EBAY_CLIENT_SECRET,
+            redirectUri: envVars.EBAY_REDIRECT_URI,
+            environment: (envVars.EBAY_ENVIRONMENT || 'sandbox'),
+        };
+        const authResult = await testEbayAuthentication(config);
+        report.tokenInfo = {
+            hasUserToken: !!envVars.EBAY_USER_REFRESH_TOKEN,
+            hasAppToken: !!envVars.EBAY_APP_ACCESS_TOKEN,
+        };
+        if (authResult.success) {
+            report.tokenInfo.scopes = envVars.EBAY_USER_REFRESH_TOKEN
+                ? parseScopeString(envVars.EBAY_USER_REFRESH_TOKEN)
+                : [];
+        }
+    }
+    // Export report if path provided
+    if (exportPath) {
+        writeFileSync(exportPath, JSON.stringify(report, null, 2), 'utf-8');
+        console.log(chalk.green(`\n✓ Diagnostic report exported to: ${exportPath}\n`));
+    }
+    return report;
+}
+/**
+ * Main diagnostics function
+ */
+async function runDiagnostics(exportReport = false) {
+    displayHeader();
+    displaySystemInfo();
+    // Security checks
+    const securityResults = await runSecurityChecks(PROJECT_ROOT);
+    displaySecurityResults(securityResults);
+    // Configuration status
+    const envPath = join(PROJECT_ROOT, '.env');
+    const envVars = parseEnvFile(envPath);
+    displayConfigurationStatus(envVars);
+    // LLM client detection
+    displayLLMClientStatus();
+    // API connectivity
+    console.log(chalk.bold.cyan('🌐 API Connectivity\n'));
+    const apiConnection = await checkApiConnectivity();
+    if (apiConnection.canReachEbay) {
+        console.log(chalk.green('  ✓ Can reach eBay API servers\n'));
+    }
+    else {
+        console.log(chalk.red('  ✗ Cannot reach eBay API servers'));
+        console.log(chalk.yellow(`  Error: ${apiConnection.error}\n`));
+    }
+    // Configuration validation
+    console.log(chalk.bold.cyan('📋 Configuration Validation\n'));
+    const validationSummary = await validateSetup(PROJECT_ROOT);
+    displayRecommendations(validationSummary);
+    // If we have credentials, test authentication
+    if (envVars.EBAY_CLIENT_ID && envVars.EBAY_CLIENT_SECRET) {
+        const config = {
+            clientId: envVars.EBAY_CLIENT_ID,
+            clientSecret: envVars.EBAY_CLIENT_SECRET,
+            redirectUri: envVars.EBAY_REDIRECT_URI,
+            environment: (envVars.EBAY_ENVIRONMENT || 'sandbox'),
+        };
+        await displayAuthenticationTest(config);
+        // Scope verification if user has refresh token
+        if (envVars.EBAY_USER_REFRESH_TOKEN) {
+            try {
+                const api = new EbaySellerApi(config);
+                await api.initialize();
+                const authClient = api.getAuthClient();
+                const tokenInfo = authClient.getTokenInfo();
+                if (tokenInfo.scopeInfo) {
+                    displayScopeVerification(tokenInfo.scopeInfo.tokenScopes, config.environment);
+                }
+            }
+            catch {
+                console.log(chalk.yellow('⚠️  Could not verify token scopes\n'));
+            }
+        }
+    }
+    // Export report if requested
+    if (exportReport) {
+        const reportPath = join(PROJECT_ROOT, `ebay-mcp-diagnostic-${Date.now()}.json`);
+        await generateDiagnosticReport(reportPath);
+    }
+    console.log(chalk.bold.green('✅ Diagnostics complete!\n'));
+    console.log(chalk.gray('For more help, visit:'));
+    console.log(chalk.blue.underline('  https://github.com/mrnajiboy/ebay-mcp-remote-edition#troubleshooting\n'));
+}
+// CLI handler
+const args = process.argv.slice(2);
+const exportReport = args.includes('--export') || args.includes('-e');
+runDiagnostics(exportReport).catch((error) => {
+    console.error(chalk.red('\n❌ Diagnostics failed:'), error);
+    process.exit(1);
+});

package/build/scripts/download-specs.js

@@ -0,0 +1,116 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DOCS_DIR = path.resolve(__dirname, '../../docs');
+const README_PATH = path.resolve(__dirname, '../../docs/sell-apps/README.md');
+const getUrlsFromReadme = (content) => {
+    // Regex to find URLs that end with .json, specifically for OpenAPI specs
+    // This assumes the README will directly link to the JSON spec files, but is less strict to allow for variations.
+    const urlRegex = /(https:\/\/[^\s)]+\.json)/g;
+    const urls = Array.from(content.matchAll(urlRegex)).map((match) => match[1]);
+    console.log('Found URLs:', urls);
+    return urls;
+};
+const _getSpecUrlsFromHtml = (html) => {
+    const linkRegex = /<a[^>]*?class="[^"]*\bspec-parent\b[^"]*"[^>]*?href="([^"]+)"/g;
+    const matches = [...html.matchAll(linkRegex)];
+    const urls = matches.map((match) => match[1]);
+    // Filter out duplicates
+    return [...new Set(urls)];
+};
+const getFolderName = (specUrl) => {
+    const fileName = path.basename(specUrl);
+    // mapping from file name to folder name
+    // This mapping is based on the README.md structure and common API groupings
+    const folderMap = {
+        // Application Settings
+        'developer_analytics_v1_beta_oas3.json': 'application-settings',
+        'developer_key_management_v1_oas3.json': 'application-settings',
+        'developer_client_registration_v1_oas3.json': 'application-settings',
+        // Selling Apps - Listing Management
+        'sell_inventory_v1_oas3.json': 'sell-apps/listing-management',
+        'sell_feed_v1_oas3.json': 'sell-apps/listing-management',
+        'commerce_media_v1_beta_oas3.json': 'sell-apps/listing-management',
+        'sell_stores_v1_oas3.json': 'sell-apps/listing-management',
+        // Selling Apps - Listing Metadata & Taxonomy
+        'sell_metadata_v1_oas3.json': 'sell-apps/listing-metadata',
+        'commerce_taxonomy_v1_oas3.json': 'sell-apps/listing-metadata',
+        'commerce_charity_v1_oas3.json': 'sell-apps/listing-metadata',
+        // Selling Apps - Account Management
+        'sell_account_v1_oas3.json': 'sell-apps/account-management',
+        'sell_account_v2_oas3.json': 'sell-apps/account-management',
+        'sell_finances_v1_oas3.json': 'sell-apps/account-management',
+        // Selling Apps - Communication & Negotiation
+        'commerce_message_v1_oas3.json': 'sell-apps/communication',
+        'commerce_notification_v1_oas3.json': 'sell-apps/communication',
+        'sell_negotiation_v1_oas3.json': 'sell-apps/communication',
+        'commerce_feedback_v1_beta_oas3.json': 'sell-apps/communication',
+        // Selling Apps - Order Management
+        'sell_fulfillment_v1_oas3.json': 'sell-apps/order-management',
+        'sell_logistics_v1_oas3.json': 'sell-apps/order-management',
+        // Selling Apps - Marketing & Promotions
+        'sell_marketing_v1_oas3.json': 'sell-apps/marketing-and-promotions',
+        'sell_recommendation_v1_oas3.json': 'sell-apps/marketing-and-promotions',
+        'sell_analytics_v1_oas3.json': 'sell-apps/analytics-and-report',
+        // Selling Apps - Other Selling APIs
+        'commerce_translation_v1_beta_oas3.json': 'sell-apps/other-apis',
+        'sell_compliance_v1_oas3.json': 'sell-apps/other-apis',
+        'commerce_identity_v1_oas3.json': 'sell-apps/other-apis',
+        'sell_edelivery_international_shipping_oas3.json': 'sell-apps/other-apis',
+        'commerce_vero_v1_oas3.json': 'sell-apps/other-apis',
+        // Buying Apps - Inventory Discovery & Refresh
+        'buy_browse_v1_oas3.json': 'buy-apps/inventory-discovery',
+        'buy_feed_v1_beta_oas3.json': 'buy-apps/inventory-discovery',
+        'buy_feed_v1_oas3.json': 'buy-apps/inventory-discovery',
+        // commerce_notification_v1_oas3.json is already mapped under sell-apps,
+        // but it's also relevant here. We'll prioritize the first mapping or create a symlink if needed.
+        // Buying Apps - Marketing & Discounts
+        'buy_deal_v1_oas3.json': 'buy-apps/marketing-and-discounts',
+        'buy_marketing_v1_beta_oas3.json': 'buy-apps/marketing-and-discounts',
+        // Buying Apps - Marketplace Metadata
+        // commerce_taxonomy_v1_oas3.json is already mapped under sell-apps
+        'commerce_catalog_v1_beta_oas3.json': 'buy-apps/marketplace-metadata',
+        // commerce_charity_v1_oas3.json is already mapped under sell-apps
+        // Buying Apps - Checkout & Bidding
+        'buy_order_v2_oas3.json': 'buy-apps/checkout-and-bidding',
+        'buy_offer_v1_beta_oas3.json': 'buy-apps/checkout-and-bidding',
+        // Buying Apps - Other Buying APIs
+        // commerce_translation_v1_beta_oas3.json is already mapped under sell-apps
+        // commerce_identity_v1_oas3.json is already mapped under sell-apps
+    };
+    // Default to 'other-apis' if not found in map, or use the mapped folder
+    return folderMap[fileName] || 'other-apis';
+};
+const downloadFile = async (url, folderPath, fileName) => {
+    try {
+        const response = await axios.get(url, { responseType: 'arraybuffer' });
+        const filePath = path.join(folderPath, fileName);
+        fs.mkdirSync(folderPath, { recursive: true });
+        fs.writeFileSync(filePath, response.data);
+        console.log(`Downloaded ${fileName} to ${folderPath}`);
+    }
+    catch (error) {
+        console.error(`Failed to download ${url}:`, error);
+    }
+};
+const main = async () => {
+    try {
+        const readmeContent = fs.readFileSync(README_PATH, 'utf-8');
+        const urls = getUrlsFromReadme(readmeContent);
+        for (const url of urls) {
+            console.log(`Processing URL: ${url}`);
+            const fileName = path.basename(url);
+            const folderName = getFolderName(url);
+            const folderPath = path.join(DOCS_DIR, folderName);
+            await downloadFile(url, folderPath, fileName);
+        }
+    }
+    catch (error) {
+        console.error('Failed to read README.md:', error);
+    }
+};
+void main();