ebay-mcp 1.13.2 → 1.14.0

package/build/utils/logger.js

@@ -2,11 +2,13 @@ import winston from 'winston';
 import { join } from 'path';
 import { existsSync, mkdirSync } from 'fs';
 import { homedir } from 'os';
+import { getLoggingConfig } from '../config/environment.js';
 /**
  * Log directory for eBay MCP Server
  * Stored in user's home directory under .ebay-mcp/logs
  */
 const LOG_DIR = join(homedir(), '.ebay-mcp', 'logs');
+const loggingConfig = getLoggingConfig();
 // Ensure log directory exists
 if (!existsSync(LOG_DIR)) {
     mkdirSync(LOG_DIR, { recursive: true });
@@ -15,11 +17,11 @@ if (!existsSync(LOG_DIR)) {
  * Log level from environment variable or default to 'info'
  * Levels: error, warn, info, http, verbose, debug, silly
  */
-const LOG_LEVEL = process.env.EBAY_LOG_LEVEL || 'info';
+const LOG_LEVEL = loggingConfig.logLevel;
 /**
  * Whether to enable file logging (disabled in production MCP mode by default)
  */
-const ENABLE_FILE_LOGGING = process.env.EBAY_ENABLE_FILE_LOGGING === 'true';
+let fileLoggingEnabled = loggingConfig.enableFileLogging;
 /**
  * Custom log format with timestamp and colored output
  */
@@ -43,7 +45,7 @@ const transports = [
     }),
 ];
 // Add file transports if enabled
-if (ENABLE_FILE_LOGGING) {
+if (fileLoggingEnabled) {
     transports.push(
     // Error log - only errors
     new winston.transports.File({
@@ -82,29 +84,36 @@ const logger = winston.createLogger({
 });
 /**
  * Create a child logger for a specific component
+ *
+ * @param component - Component label prefixed to every emitted message.
+ * @returns Component-scoped logger methods.
+ *
+ * @example
+ * ```ts
+ * const logger = createLogger('API');
+ * logger.info('Ready');
+ * ```
  */
-export function createLogger(component) {
-    return {
-        error: (message, meta) => {
-            logger.error(`[${component}] ${message}`, meta);
-        },
-        warn: (message, meta) => {
-            logger.warn(`[${component}] ${message}`, meta);
-        },
-        info: (message, meta) => {
-            logger.info(`[${component}] ${message}`, meta);
-        },
-        http: (message, meta) => {
-            logger.http(`[${component}] ${message}`, meta);
-        },
-        debug: (message, meta) => {
-            logger.debug(`[${component}] ${message}`, meta);
-        },
-        verbose: (message, meta) => {
-            logger.verbose(`[${component}] ${message}`, meta);
-        },
-    };
-}
+export const createLogger = (component) => ({
+    error: (message, meta) => {
+        logger.error(`[${component}] ${message}`, meta);
+    },
+    warn: (message, meta) => {
+        logger.warn(`[${component}] ${message}`, meta);
+    },
+    info: (message, meta) => {
+        logger.info(`[${component}] ${message}`, meta);
+    },
+    http: (message, meta) => {
+        logger.http(`[${component}] ${message}`, meta);
+    },
+    debug: (message, meta) => {
+        logger.debug(`[${component}] ${message}`, meta);
+    },
+    verbose: (message, meta) => {
+        logger.verbose(`[${component}] ${message}`, meta);
+    },
+});
 /**
  * Pre-configured loggers for different components
  */
@@ -120,17 +129,40 @@ export const toolLogger = createLogger('Tool');
 export const setupLogger = createLogger('Setup');
 /**
  * Log HTTP request details
+ *
+ * @param method - HTTP method being sent.
+ * @param url - Request URL.
+ * @param params - Optional query parameters.
+ * @param body - Optional request body.
+ * @returns Nothing; writes to configured logger transports.
+ *
+ * @example
+ * ```ts
+ * logRequest('GET', url, params);
+ * ```
  */
-export function logRequest(method, url, params, body) {
+export const logRequest = (method, url, params, body) => {
     apiLogger.http(`Request: ${method.toUpperCase()} ${url}`, {
         params: params && Object.keys(params).length > 0 ? params : undefined,
         body: body ? truncateData(body) : undefined,
     });
-}
+};
 /**
  * Log HTTP response details
+ *
+ * @param status - HTTP response status code.
+ * @param statusText - HTTP response status text.
+ * @param data - Optional response payload.
+ * @param rateLimitRemaining - Optional remaining request quota.
+ * @param rateLimitTotal - Optional total request quota.
+ * @returns Nothing; writes to configured logger transports.
+ *
+ * @example
+ * ```ts
+ * logResponse(200, 'OK', data);
+ * ```
  */
-export function logResponse(status, statusText, data, rateLimitRemaining, rateLimitTotal) {
+export const logResponse = (status, statusText, data, rateLimitRemaining, rateLimitTotal) => {
     const meta = {};
     if (rateLimitRemaining && rateLimitTotal) {
         meta.rateLimit = `${rateLimitRemaining}/${rateLimitTotal}`;
@@ -139,42 +171,81 @@ export function logResponse(status, statusText, data, rateLimitRemaining, rateLi
         meta.data = truncateData(data);
     }
     apiLogger.http(`Response: ${status} ${statusText}`, meta);
-}
+};
 /**
  * Log HTTP error response
+ *
+ * @param status - HTTP status code, when a response exists.
+ * @param statusText - HTTP status text, when a response exists.
+ * @param url - Request URL that failed.
+ * @param errorData - Optional parsed error payload.
+ * @returns Nothing; writes to configured logger transports.
+ *
+ * @example
+ * ```ts
+ * logErrorResponse(error.status, error.statusText, url, error.data);
+ * ```
  */
-export function logErrorResponse(status, statusText, url, errorData) {
-    apiLogger.error(`Error Response: ${status || 'N/A'} ${statusText || 'No response'}`, {
+export const logErrorResponse = (status, statusText, url, errorData) => {
+    const statusLabel = status === undefined ? 'No status' : String(status);
+    const statusTextLabel = statusText ?? 'No response';
+    apiLogger.error(`Error Response: ${statusLabel} ${statusTextLabel}`, {
         url,
         error: errorData ? truncateData(errorData) : undefined,
     });
-}
+};
 /**
  * Truncate large data objects for logging
  */
-function truncateData(data, maxLength = 1000) {
+const truncateData = (data, maxLength = 1000) => {
     const str = JSON.stringify(data);
     if (str.length <= maxLength) {
         return data;
     }
     return `${str.substring(0, maxLength)}... [truncated]`;
-}
+};
 /**
  * Get log file paths for user reference
+ *
+ * @returns Paths to the log directory and known log files.
+ *
+ * @example
+ * ```ts
+ * const paths = getLogPaths();
+ * ```
  */
-export function getLogPaths() {
-    return {
-        logDir: LOG_DIR,
-        errorLog: join(LOG_DIR, 'error.log'),
-        combinedLog: join(LOG_DIR, 'combined.log'),
-        debugLog: join(LOG_DIR, 'debug.log'),
-    };
-}
+export const getLogPaths = () => ({
+    logDir: LOG_DIR,
+    errorLog: join(LOG_DIR, 'error.log'),
+    combinedLog: join(LOG_DIR, 'combined.log'),
+    debugLog: join(LOG_DIR, 'debug.log'),
+});
+/**
+ * Reports whether file logging is currently enabled.
+ *
+ * @returns True when Winston file transports are enabled.
+ *
+ * @example
+ * ```ts
+ * if (isFileLoggingEnabled()) {
+ *   serverLogger.info('File logging enabled');
+ * }
+ * ```
+ */
+export const isFileLoggingEnabled = () => fileLoggingEnabled;
 /**
  * Enable or disable file logging at runtime
+ *
+ * @param enabled - Whether file logging should be enabled.
+ * @returns Nothing; mutates Winston transports when enabling.
+ *
+ * @example
+ * ```ts
+ * setFileLogging(true);
+ * ```
  */
-export function setFileLogging(enabled) {
-    if (enabled && !ENABLE_FILE_LOGGING) {
+export const setFileLogging = (enabled) => {
+    if (enabled && !fileLoggingEnabled) {
         logger.add(new winston.transports.File({
             filename: join(LOG_DIR, 'error.log'),
             level: 'error',
@@ -190,17 +261,22 @@ export function setFileLogging(enabled) {
             maxFiles: 5,
             tailable: true,
         }));
+        fileLoggingEnabled = true;
         logger.info('File logging enabled');
     }
-}
+};
 /**
  * Set log level at runtime
+ *
+ * @param level - Winston log level name.
+ * @returns Nothing; mutates the shared Winston logger level.
+ *
+ * @example
+ * ```ts
+ * setLogLevel('debug');
+ * ```
  */
-export function setLogLevel(level) {
+export const setLogLevel = (level) => {
     logger.level = level;
     logger.info(`Log level set to: ${level}`);
-}
-/**
- * Default Winston logger instance.
- */
-export default logger;
+};

package/build/utils/{oauth-helper.js → oauthHelper.js}

@@ -4,18 +4,25 @@
 import chalk from 'chalk';
 import { createServer } from 'http';
 import { getOAuthAuthorizationUrl } from '../config/environment.js';
+import { writeCliLine } from './cliOutput.js';
 /**
  * Generate terminal hyperlink (if supported)
  */
-function hyperlink(text, url) {
-    return `\u001B]8;;${url}\u0007${text}\u001B]8;;\u0007`;
-}
+const hyperlink = (text, url) => `\u001B]8;;${url}\u0007${text}\u001B]8;;\u0007`;
 /**
- * Generate eBay OAuth authorization URL
+ * Generates an eBay OAuth authorization URL.
+ *
+ * @param clientId eBay application client ID.
+ * @param redirectUri Redirect URI or RuName configured for the application.
+ * @param environment eBay environment that should receive the authorization request.
+ * @param scopes OAuth scopes to request; defaults come from the environment helper.
+ * @returns Fully qualified eBay OAuth authorization URL.
+ * @example
+ * ```ts
+ * const url = generateAuthUrl(clientId, redirectUri, 'sandbox');
+ * ```
  */
-export function generateAuthUrl(clientId, redirectUri, environment, scopes) {
-    return getOAuthAuthorizationUrl(clientId, redirectUri, environment, scopes);
-}
+export const generateAuthUrl = (clientId, redirectUri, environment, scopes) => getOAuthAuthorizationUrl(clientId, redirectUri, environment, scopes);
 /**
  * Escape a string for safe interpolation into HTML text/attribute context.
  *
@@ -25,14 +32,12 @@ export function generateAuthUrl(clientId, redirectUri, environment, scopes) {
  * HTML-significant characters neutralizes the markup while keeping the message
  * legible.
  */
-function escapeHtml(value) {
-    return value
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#39;');
-}
+const escapeHtml = (value) => value
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
 /**
  * Render the small HTML page the user lands on after eBay redirects back.
  *
@@ -41,7 +46,7 @@ function escapeHtml(value) {
  *   potentially attacker-controlled (eBay's `error_description`), so it is
  *   HTML-escaped before interpolation.
  */
-function renderCallbackPage(success, detail = '') {
+const renderCallbackPage = (success, detail = '') => {
     const gradient = success
         ? 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)'
         : 'linear-gradient(135deg, #f093fb 0%, #f5576c 100%)';
@@ -78,7 +83,7 @@ function renderCallbackPage(success, detail = '') {
     ${autoClose}
   </body>
 </html>`;
-}
+};
 /**
  * Start a loopback HTTP server that captures the eBay OAuth redirect.
  *
@@ -94,8 +99,12 @@ function renderCallbackPage(success, detail = '') {
  * @param timeoutMs How long to wait for the redirect before settling with `timeout`.
  * @param options Path and CSRF-`state` tuning — see {@link CallbackServerOptions}.
  * @returns The live server plus a promise resolving to the callback result.
+ * @example
+ * ```ts
+ * const { server, codePromise } = await startCallbackServer(3000);
+ * ```
  */
-export async function startCallbackServer(port = 3000, timeoutMs = 300000, options = {}) {
+export const startCallbackServer = async (port = 3000, timeoutMs = 300_000, options = {}) => {
     const callbackPath = options.path ?? '/oauth/callback';
     const { expectedState } = options;
     return await new Promise((resolve, reject) => {
@@ -160,76 +169,99 @@ export async function startCallbackServer(port = 3000, timeoutMs = 300000, optio
             resolve({ server, codePromise });
         });
     });
-}
+};
 /**
- * Interactive OAuth flow with local callback server
+ * Runs an interactive OAuth flow with a local callback server.
+ *
+ * @param config eBay application configuration used to build the authorization URL.
+ * @param scopes OAuth scopes to request for the user token.
+ * @returns The authorization code when the browser callback succeeds, otherwise `null`.
+ * @example
+ * ```ts
+ * const code = await interactiveOAuthFlow(config);
+ * ```
  */
-export async function interactiveOAuthFlow(config, scopes) {
-    console.log(chalk.bold.cyan('\n🔐 Interactive OAuth Flow\n'));
+export const interactiveOAuthFlow = async (config, scopes) => {
+    writeCliLine(chalk.bold.cyan('\n🔐 Interactive OAuth Flow\n'));
     // Check if redirect URI is localhost
     const redirectUri = config.redirectUri || 'http://localhost:3000/oauth/callback';
     const isLocalhost = redirectUri.includes('localhost') || redirectUri.includes('127.0.0.1');
     if (!isLocalhost) {
-        console.log(chalk.yellow('⚠️  Your redirect URI is not localhost. Interactive flow requires localhost callback.\n'));
+        writeCliLine(chalk.yellow('⚠️  Your redirect URI is not localhost. Interactive flow requires localhost callback.\n'));
         return null;
     }
     // Extract port from redirect URI
     const portMatch = /:(\d+)/.exec(redirectUri);
-    const port = portMatch ? parseInt(portMatch[1], 10) : 3000;
+    const port = portMatch ? Number.parseInt(portMatch[1], 10) : 3000;
     // Start callback server
-    console.log(chalk.cyan('Starting local OAuth callback server...\n'));
+    writeCliLine(chalk.cyan('Starting local OAuth callback server...\n'));
     const { server, codePromise } = await startCallbackServer(port);
     // Generate auth URL
     const authUrl = generateAuthUrl(config.clientId, redirectUri, config.environment, scopes);
-    console.log(chalk.bold.white('📋 Step 1: Authorize the Application\n'));
-    console.log(chalk.gray('Open this URL in your browser:\n'));
-    console.log(chalk.blue.underline(hyperlink(authUrl.substring(0, 20) + '...', authUrl)));
-    console.log('');
-    console.log(chalk.gray('Waiting for authorization...'));
-    console.log(chalk.gray('(This window will update automatically after you authorize)\n'));
+    writeCliLine(chalk.bold.white('📋 Step 1: Authorize the Application\n'));
+    writeCliLine(chalk.gray('Open this URL in your browser:\n'));
+    writeCliLine(chalk.blue.underline(hyperlink(authUrl.substring(0, 20) + '...', authUrl)));
+    writeCliLine('');
+    writeCliLine(chalk.gray('Waiting for authorization...'));
+    writeCliLine(chalk.gray('(This window will update automatically after you authorize)\n'));
     // Wait for callback
     const result = await codePromise;
     // Close server
     server.close();
     if (result.error) {
-        console.log(chalk.red(`\n✗ Authorization failed: ${result.errorDescription || result.error}\n`));
+        writeCliLine(chalk.red(`\n✗ Authorization failed: ${result.errorDescription || result.error}\n`));
         return null;
     }
     if (result.code) {
-        console.log(chalk.green('\n✓ Authorization successful!\n'));
+        writeCliLine(chalk.green('\n✓ Authorization successful!\n'));
         return result.code;
     }
-    console.log(chalk.yellow('\n⚠️  No authorization code received.\n'));
+    writeCliLine(chalk.yellow('\n⚠️  No authorization code received.\n'));
     return null;
-}
+};
 /**
- * Display manual OAuth instructions
+ * Displays manual OAuth instructions in the setup CLI.
+ *
+ * @param clientId eBay application client ID.
+ * @param redirectUri Redirect URI or RuName configured for the application.
+ * @param environment eBay environment for the authorization URL.
+ * @param scopes OAuth scopes to include in the manual authorization URL.
+ * @returns Nothing; instructions are written to stdout.
+ * @example
+ * ```ts
+ * displayManualOAuthInstructions(clientId, redirectUri, 'sandbox');
+ * ```
  */
-export function displayManualOAuthInstructions(clientId, redirectUri, environment, scopes) {
+export const displayManualOAuthInstructions = (clientId, redirectUri, environment, scopes) => {
     const authUrl = generateAuthUrl(clientId, redirectUri, environment, scopes);
-    console.log(chalk.bold.cyan('\n📖 Manual OAuth Token Acquisition Guide\n'));
-    console.log(chalk.white('Step 1: Generate Authorization URL\n'));
-    console.log(chalk.gray('Copy this URL and open it in your browser:\n'));
-    console.log(chalk.blue.underline(authUrl));
-    console.log('');
-    console.log(chalk.white('\nStep 2: Authorize the Application\n'));
-    console.log(chalk.gray('  • Log in to your eBay account'));
-    console.log(chalk.gray('  • Review the permissions requested'));
-    console.log(chalk.gray('  • Click "Agree" to authorize\n'));
-    console.log(chalk.white('Step 3: Get the Authorization Code\n'));
-    console.log(chalk.gray('  • After authorization, you will be redirected to your redirect URI'));
-    console.log(chalk.gray('  • The URL will contain a "code" parameter'));
-    console.log(chalk.gray('  • Example: https://your-redirect-uri?code=v^1.1#i^1...\n'));
-    console.log(chalk.white('Step 4: Exchange Code for Tokens\n'));
-    console.log(chalk.gray('  • Use the code to get your refresh token'));
-    console.log(chalk.gray('  • This can be done through the MCP tool: ebay_exchange_auth_code'));
-    console.log(chalk.gray('  • Or paste the code in the setup wizard when prompted\n'));
-}
+    writeCliLine(chalk.bold.cyan('\n📖 Manual OAuth Token Acquisition Guide\n'));
+    writeCliLine(chalk.white('Step 1: Generate Authorization URL\n'));
+    writeCliLine(chalk.gray('Copy this URL and open it in your browser:\n'));
+    writeCliLine(chalk.blue.underline(authUrl));
+    writeCliLine('');
+    writeCliLine(chalk.white('\nStep 2: Authorize the Application\n'));
+    writeCliLine(chalk.gray('  • Log in to your eBay account'));
+    writeCliLine(chalk.gray('  • Review the permissions requested'));
+    writeCliLine(chalk.gray('  • Click "Agree" to authorize\n'));
+    writeCliLine(chalk.white('Step 3: Get the Authorization Code\n'));
+    writeCliLine(chalk.gray('  • After authorization, you will be redirected to your redirect URI'));
+    writeCliLine(chalk.gray('  • The URL will contain a "code" parameter'));
+    writeCliLine(chalk.gray('  • Example: https://your-redirect-uri?code=v^1.1#i^1...\n'));
+    writeCliLine(chalk.white('Step 4: Exchange Code for Tokens\n'));
+    writeCliLine(chalk.gray('  • Use the code to get your refresh token'));
+    writeCliLine(chalk.gray('  • This can be done through the MCP tool: ebay_exchange_auth_code'));
+    writeCliLine(chalk.gray('  • Or paste the code in the setup wizard when prompted\n'));
+};
 /**
- * Get help text for RuName (Redirect URI)
+ * Gets help text for RuName (Redirect URI) setup.
+ *
+ * @returns A formatted help block explaining eBay RuName creation.
+ * @example
+ * ```ts
+ * writeCliLine(getRuNameHelp());
+ * ```
  */
-export function getRuNameHelp() {
-    return `
+export const getRuNameHelp = () => `
 ${chalk.bold.cyan('What is a RuName (Redirect URI)?')}
 
 A RuName (Redirect URL name) is a unique identifier for your OAuth redirect URI.
@@ -260,37 +292,42 @@ ${chalk.bold.white('Common RuName formats:')}
 ${chalk.yellow('Note:')} The RuName is NOT the same as the redirect URI itself.
 It's a reference name that eBay associates with your redirect URI.
 `;
-}
 /**
- * Display first-time developer guide
+ * Displays the first-time eBay developer guide in the setup CLI.
+ *
+ * @returns Nothing; the guide is written to stdout.
+ * @example
+ * ```ts
+ * displayFirstTimeDeveloperGuide();
+ * ```
  */
-export function displayFirstTimeDeveloperGuide() {
-    console.log(chalk.bold.cyan('\n🆕 First-Time eBay Developer Guide\n'));
-    console.log(chalk.white("Welcome! Here's how to get started:\n"));
-    console.log(chalk.bold.yellow('Step 1: Create eBay Developer Account\n'));
-    console.log(chalk.gray('  1. Visit: ') + chalk.blue.underline('https://developer.ebay.com/'));
-    console.log(chalk.gray('  2. Click "Register" or "Join"'));
-    console.log(chalk.gray('  3. Complete the registration form'));
-    console.log(chalk.gray('  4. Verify your email address\n'));
-    console.log(chalk.bold.yellow('Step 2: Create an Application\n'));
-    console.log(chalk.gray('  1. Go to: ') + chalk.blue.underline('https://developer.ebay.com/my/keys'));
-    console.log(chalk.gray('  2. Click "Create Application"'));
-    console.log(chalk.gray('  3. Fill in application details (name, description)'));
-    console.log(chalk.gray('  4. Choose Sandbox environment to start\n'));
-    console.log(chalk.bold.yellow('Step 3: Get Your Credentials\n'));
-    console.log(chalk.gray('  After creating the app, you will see:'));
-    console.log(chalk.gray('  • App ID (Client ID) - Copy this'));
-    console.log(chalk.gray('  • Cert ID (Client Secret) - Copy this'));
-    console.log(chalk.gray('  • These are needed for the setup wizard\n'));
-    console.log(chalk.bold.yellow('Step 4: Create RuName (Redirect URI)\n'));
-    console.log(chalk.gray('  1. In your application settings'));
-    console.log(chalk.gray('  2. Navigate to "User Tokens" section'));
-    console.log(chalk.gray('  3. Click "Add RuName"'));
-    console.log(chalk.gray('  4. Enter: http://localhost:3000/oauth/callback'));
-    console.log(chalk.gray('  5. Save and copy the generated RuName\n'));
-    console.log(chalk.bold.yellow('Step 5: Get User Token\n'));
-    console.log(chalk.gray('  Option A: Use this setup wizard (recommended)'));
-    console.log(chalk.gray('  Option B: Manual OAuth flow through eBay Developer Portal\n'));
-    console.log(chalk.green.bold("✅ Once you have these, you're ready to continue!\n"));
-    console.log(chalk.gray('Press Enter to continue when you have your credentials ready...'));
-}
+export const displayFirstTimeDeveloperGuide = () => {
+    writeCliLine(chalk.bold.cyan('\n🆕 First-Time eBay Developer Guide\n'));
+    writeCliLine(chalk.white("Welcome! Here's how to get started:\n"));
+    writeCliLine(chalk.bold.yellow('Step 1: Create eBay Developer Account\n'));
+    writeCliLine(chalk.gray('  1. Visit: ') + chalk.blue.underline('https://developer.ebay.com/'));
+    writeCliLine(chalk.gray('  2. Click "Register" or "Join"'));
+    writeCliLine(chalk.gray('  3. Complete the registration form'));
+    writeCliLine(chalk.gray('  4. Verify your email address\n'));
+    writeCliLine(chalk.bold.yellow('Step 2: Create an Application\n'));
+    writeCliLine(chalk.gray('  1. Go to: ') + chalk.blue.underline('https://developer.ebay.com/my/keys'));
+    writeCliLine(chalk.gray('  2. Click "Create Application"'));
+    writeCliLine(chalk.gray('  3. Fill in application details (name, description)'));
+    writeCliLine(chalk.gray('  4. Choose Sandbox environment to start\n'));
+    writeCliLine(chalk.bold.yellow('Step 3: Get Your Credentials\n'));
+    writeCliLine(chalk.gray('  After creating the app, you will see:'));
+    writeCliLine(chalk.gray('  • App ID (Client ID) - Copy this'));
+    writeCliLine(chalk.gray('  • Cert ID (Client Secret) - Copy this'));
+    writeCliLine(chalk.gray('  • These are needed for the setup wizard\n'));
+    writeCliLine(chalk.bold.yellow('Step 4: Create RuName (Redirect URI)\n'));
+    writeCliLine(chalk.gray('  1. In your application settings'));
+    writeCliLine(chalk.gray('  2. Navigate to "User Tokens" section'));
+    writeCliLine(chalk.gray('  3. Click "Add RuName"'));
+    writeCliLine(chalk.gray('  4. Enter: http://localhost:3000/oauth/callback'));
+    writeCliLine(chalk.gray('  5. Save and copy the generated RuName\n'));
+    writeCliLine(chalk.bold.yellow('Step 5: Get User Token\n'));
+    writeCliLine(chalk.gray('  Option A: Use this setup wizard (recommended)'));
+    writeCliLine(chalk.gray('  Option B: Manual OAuth flow through eBay Developer Portal\n'));
+    writeCliLine(chalk.green.bold("✅ Once you have these, you're ready to continue!\n"));
+    writeCliLine(chalk.gray('Press Enter to continue when you have your credentials ready...'));
+};

package/build/utils/other/compliance.js

@@ -1,51 +1,44 @@
-import { z } from 'zod';
+import { z } from '../../utils/effectSchema.js';
 /**
- * Zod schemas for Compliance API input validation
+ * Effect-backed schemas for Compliance API input validation
  * Based on: src/api/other/compliance.ts
  * OpenAPI spec: docs/sell-apps/other-apis/sell_compliance_v1_oas3.json
  * Types from: src/types/sell_compliance_v1_oas3.ts
  */
-// Reusable schema for compliance_type parameter
+// Reusable schema for complianceType parameter
 const complianceTypeSchema = z
     .string({
-    invalid_type_error: 'compliance_type must be a string',
+    invalid_type_error: 'complianceType must be a string',
     description: 'Compliance type(s) to filter violations (e.g., ASPECTS_ADOPTION, HTTPS, OUTSIDE_EBAY_BUYING_AND_SELLING, RETURNS_POLICY)',
 })
     .optional();
-// Reusable schema for offset parameter (string in API)
+// Reusable schema for offset parameter
 const offsetSchema = z
-    .string({
-    invalid_type_error: 'offset must be a string',
+    .number({
+    invalid_type_error: 'offset must be a number',
     description: 'Number of items to skip (zero-based index)',
 })
+    .int()
+    .nonnegative()
     .optional();
-// Reusable schema for limit parameter (string in API)
+// Reusable schema for limit parameter
 const limitSchema = z
-    .string({
-    invalid_type_error: 'limit must be a string',
+    .number({
+    invalid_type_error: 'limit must be a number',
     description: 'Maximum number of items to return (default: 100, max: 200)',
 })
+    .int()
+    .positive()
     .optional();
 /**
  * Schema for getListingViolations method
  * Endpoint: GET /listing_violation
- * Query: GetListingViolationsParams - compliance_type (required), offset, limit, listing_id, filter
+ * Query: complianceType, offset, limit, filter
  */
 export const getListingViolationsSchema = z.object({
-    compliance_type: z.string({
-        message: 'Compliance type is required',
-        required_error: 'compliance_type is required',
-        invalid_type_error: 'compliance_type must be a string',
-        description: 'The compliance type of violations to retrieve (only one type allowed per call)',
-    }),
+    complianceType: complianceTypeSchema,
     offset: offsetSchema,
     limit: limitSchema,
-    listing_id: z
-        .string({
-        invalid_type_error: 'listing_id must be a string',
-        description: 'Filter by specific eBay listing ID (not yet supported)',
-    })
-        .optional(),
     filter: z
         .string({
         invalid_type_error: 'filter must be a string',
@@ -56,21 +49,8 @@ export const getListingViolationsSchema = z.object({
 /**
  * Schema for getListingViolationsSummary method
  * Endpoint: GET /listing_violation_summary
- * Query: GetListingViolationsSummaryParams - compliance_type
+ * Query: complianceType
  */
 export const getListingViolationsSummarySchema = z.object({
-    compliance_type: complianceTypeSchema,
-});
-/**
- * Schema for suppressViolation method
- * Endpoint: POST /suppress_violation
- * Body: listing_violation_id (required)
- */
-export const suppressViolationSchema = z.object({
-    listing_violation_id: z.string({
-        message: 'Listing violation ID is required',
-        required_error: 'listing_violation_id is required',
-        invalid_type_error: 'listing_violation_id must be a string',
-        description: 'The unique identifier of the listing violation to suppress',
-    }),
+    complianceType: complianceTypeSchema,
 });