sfcc-dev-mcp 1.0.19 → 1.0.21

package/tests/servers/sfcc-mock-server/src/app.js

@@ -1,182 +0,0 @@
-/**
- * Express Application Setup
- * 
- * Main Express application configuration with middleware setup and route registration.
- * Follows modular architecture with clean separation of concerns.
- */
-
-const express = require('express');
-const { createCorsMiddleware } = require('./middleware/cors');
-const { createRequestLogger, createResponseLogger, createErrorLogger } = require('./middleware/logging');
-const AuthenticationManager = require('./middleware/auth');
-const WebDAVRouteHandler = require('./routes/webdav');
-const CartridgeWebDAVHandler = require('./routes/cartridge-webdav');
-const StorefrontHandler = require('./routes/storefront');
-const OCAPIRouteHandler = require('./routes/ocapi');
-
-class SFCCMockApp {
-    constructor(config) {
-        this.config = config;
-        this.app = express();
-        this.authManager = new AuthenticationManager(config);
-        this.setupMiddleware();
-        this.setupRoutes();
-        this.setupErrorHandling();
-    }
-
-    setupMiddleware() {
-        // CORS middleware (if enabled)
-        if (this.config.features.cors) {
-            this.app.use(createCorsMiddleware());
-        }
-
-        // Body parsing middleware
-        this.app.use(express.json({ limit: '10mb' }));
-        this.app.use(express.urlencoded({ extended: true, limit: '10mb' }));
-
-        // Logging middleware (if enabled)
-        if (this.config.features.logging) {
-            this.app.use(createRequestLogger(this.config.isDevMode));
-            this.app.use(createResponseLogger(this.config.isDevMode));
-        }
-
-        // Custom method support for WebDAV
-        this.app.use((req, res, next) => {
-            // Add support for PROPFIND method
-            if (req.headers['content-length'] === '0' && req.method === 'POST') {
-                // Check if this might be a PROPFIND disguised as POST
-                const contentType = req.headers['content-type'];
-                if (!contentType || contentType.includes('application/xml')) {
-                    req.method = 'PROPFIND';
-                }
-            }
-            next();
-        });
-    }
-
-    setupRoutes() {
-        // Health check endpoint
-        this.app.get('/health', (req, res) => {
-            const summary = this.config.getSummary();
-            res.json({ 
-                status: 'ok', 
-                message: 'SFCC Mock Server is running',
-                timestamp: new Date().toISOString(),
-                config: summary
-            });
-        });
-
-        // Server info endpoint
-        this.app.get('/info', (req, res) => {
-            const summary = this.config.getSummary();
-            res.json({
-                name: 'SFCC Mock Server',
-                version: '1.0.0',
-                description: 'Unified WebDAV and OCAPI mock server for SFCC development',
-                config: summary
-            });
-        });
-
-        // WebDAV routes (if enabled)
-        if (this.config.features.webdav) {
-            const webdavHandler = new WebDAVRouteHandler(this.config);
-            this.app.use(webdavHandler.getRouter());
-            
-            // Cartridge WebDAV routes for script debugger controller verification
-            const cartridgeWebdavHandler = new CartridgeWebDAVHandler(this.config);
-            this.app.use(cartridgeWebdavHandler.getRouter());
-            
-            if (this.config.isDevMode) {
-                console.log('✅ WebDAV routes enabled');
-                console.log('✅ Cartridge WebDAV routes enabled');
-            }
-        }
-
-        // Storefront routes (for debugger trigger)
-        const storefrontHandler = new StorefrontHandler(this.config);
-        this.app.use(storefrontHandler.getRouter());
-        
-        if (this.config.isDevMode) {
-            console.log('✅ Storefront routes enabled');
-        }
-
-        // OCAPI routes (if enabled)
-        if (this.config.features.ocapi) {
-            const ocapiHandler = new OCAPIRouteHandler(this.config, this.authManager);
-            this.app.use(ocapiHandler.getRouter());
-            
-            if (this.config.isDevMode) {
-                console.log('✅ OCAPI routes enabled');
-            }
-        }
-
-        // Catch-all for undefined routes
-        this.app.use('*', (req, res) => {
-            res.status(404).json({
-                error: 'Not Found',
-                message: `Route ${req.method} ${req.originalUrl} not found`,
-                timestamp: new Date().toISOString(),
-                availableEndpoints: this.getAvailableEndpoints()
-            });
-        });
-    }
-
-    setupErrorHandling() {
-        // Error logging middleware
-        this.app.use(createErrorLogger());
-
-        // Final error handler
-        this.app.use((err, req, res, next) => {
-            // Prevent header already sent errors
-            if (res.headersSent) {
-                return next(err);
-            }
-
-            const statusCode = err.statusCode || err.status || 500;
-            const message = err.message || 'Internal Server Error';
-            
-            res.status(statusCode).json({
-                error: 'Server Error',
-                message: message,
-                timestamp: new Date().toISOString(),
-                ...(this.config.isDevMode && { stack: err.stack })
-            });
-        });
-    }
-
-    getAvailableEndpoints() {
-        const baseUrl = this.config.getServerUrl();
-        const endpoints = {
-            health: `${baseUrl}/health`,
-            info: `${baseUrl}/info`
-        };
-
-        if (this.config.features.webdav) {
-            endpoints.webdav = {
-                logs: this.config.getWebdavLogsUrl(),
-                directLogs: `${baseUrl}/Logs/`
-            };
-        }
-
-        if (this.config.features.ocapi) {
-            const ocapiBase = this.config.getOcapiBaseUrl();
-            endpoints.ocapi = {
-                oauth: `${baseUrl}/dw/oauth2/access_token`,
-                systemObjects: `${ocapiBase}/system_object_definitions`,
-                codeVersions: `${ocapiBase}/code_versions`
-            };
-        }
-
-        return endpoints;
-    }
-
-    getExpressApp() {
-        return this.app;
-    }
-
-    getAuthManager() {
-        return this.authManager;
-    }
-}
-
-module.exports = SFCCMockApp;

package/tests/servers/sfcc-mock-server/src/config/server-config.js

@@ -1,124 +0,0 @@
-/**
- * Server Configuration Management
- * 
- * Handles server configuration with sensible defaults and environment overrides.
- * Follows single responsibility principle for configuration management.
- */
-
-class ServerConfig {
-    constructor(options = {}) {
-        // Server basics
-        this.port = options.port || process.env.PORT || 3000;
-        this.host = options.host || process.env.HOST || 'localhost';
-        this.isDevMode = options.dev || process.env.NODE_ENV === 'development' || false;
-        
-        // API versions
-        this.ocapiVersion = options.ocapiVersion || 'v23_2';
-        
-        // Paths
-        this.mockDataPath = options.mockDataPath || require('path').join(__dirname, '../../mock-data');
-        this.webdavBasePath = '/on/demandware.servlet/webdav/Sites';
-        
-        // Authentication - Mock credentials for testing
-        this.validCredentials = {
-            clientId: 'test-client-id',
-            clientSecret: 'test-client-secret',
-            username: 'test-user',
-            password: 'test-password'
-        };
-        
-        // Features toggle
-        this.features = {
-            webdav: options.enableWebdav !== false, // enabled by default
-            ocapi: options.enableOcapi !== false,   // enabled by default
-            cors: options.enableCors !== false,     // enabled by default
-            logging: options.enableLogging !== false, // enabled by default
-            randomErrors: options.enableRandomErrors === true // disabled by default for reliable tests
-        };
-    }
-
-    /**
-     * Get WebDAV configuration
-     */
-    getWebdavConfig() {
-        return {
-            basePath: this.webdavBasePath,
-            logsPath: require('path').join(this.mockDataPath, 'logs'),
-            enabled: this.features.webdav
-        };
-    }
-
-    /**
-     * Get OCAPI configuration
-     */
-    getOcapiConfig() {
-        return {
-            version: this.ocapiVersion,
-            basePath: `/s/-/dw/data/${this.ocapiVersion}`,
-            mockDataPath: require('path').join(this.mockDataPath, 'ocapi'),
-            enabled: this.features.ocapi
-        };
-    }
-
-    /**
-     * Get full server URL
-     */
-    getServerUrl() {
-        return `http://${this.host}:${this.port}`;
-    }
-
-    /**
-     * Get WebDAV logs URL
-     */
-    getWebdavLogsUrl() {
-        return `${this.getServerUrl()}${this.webdavBasePath}/Logs/`;
-    }
-
-    /**
-     * Get OCAPI base URL
-     */
-    getOcapiBaseUrl() {
-        return `${this.getServerUrl()}/s/-/dw/data/${this.ocapiVersion}`;
-    }
-
-    /**
-     * Validate configuration
-     */
-    validate() {
-        const errors = [];
-        
-        if (!this.port || this.port < 1 || this.port > 65535) {
-            errors.push('Invalid port number');
-        }
-        
-        if (!this.host || typeof this.host !== 'string') {
-            errors.push('Invalid host');
-        }
-        
-        if (!this.features.webdav && !this.features.ocapi) {
-            errors.push('At least one feature (WebDAV or OCAPI) must be enabled');
-        }
-        
-        return errors;
-    }
-
-    /**
-     * Get configuration summary for logging
-     */
-    getSummary() {
-        return {
-            server: `${this.host}:${this.port}`,
-            mode: this.isDevMode ? 'development' : 'production',
-            features: Object.entries(this.features)
-                .filter(([_, enabled]) => enabled)
-                .map(([feature, _]) => feature),
-            endpoints: {
-                ...(this.features.webdav && { webdav: this.getWebdavLogsUrl() }),
-                ...(this.features.ocapi && { ocapi: this.getOcapiBaseUrl() }),
-                health: `${this.getServerUrl()}/health`
-            }
-        };
-    }
-}
-
-module.exports = ServerConfig;

package/tests/servers/sfcc-mock-server/src/middleware/auth.js

@@ -1,101 +0,0 @@
-/**
- * Authentication Middleware
- * 
- * Handles OAuth token generation and validation for OCAPI endpoints.
- * Maintains simple in-memory token storage suitable for testing.
- */
-
-class AuthenticationManager {
-    constructor(config) {
-        this.config = config;
-        this.activeTokens = new Set();
-        this.validCredentials = config.validCredentials;
-    }
-
-    /**
-     * Handle OAuth2 token requests
-     */
-    handleOAuthToken(req, res) {
-        const { grant_type } = req.body;
-        
-        // Validate grant type
-        if (grant_type !== 'client_credentials' && 
-            grant_type !== 'urn:demandware:params:oauth:grant-type:client-id:dwsid:dwsecuretoken') {
-            return res.status(400).json({
-                error: 'unsupported_grant_type',
-                error_description: 'The authorization grant type is not supported'
-            });
-        }
-        
-        // Extract credentials from Basic Auth header
-        const authHeader = req.headers.authorization;
-        if (!authHeader || !authHeader.startsWith('Basic ')) {
-            return res.status(401).json({
-                error: 'invalid_client',
-                error_description: 'Client authentication failed - missing Basic auth header'
-            });
-        }
-        
-        const base64Credentials = authHeader.split(' ')[1];
-        const credentials = Buffer.from(base64Credentials, 'base64').toString('ascii');
-        const [client_id, client_secret] = credentials.split(':');
-        
-        // Validate credentials
-        if (client_id !== this.validCredentials.clientId || 
-            client_secret !== this.validCredentials.clientSecret) {
-            return res.status(401).json({
-                error: 'invalid_client',
-                error_description: 'Client authentication failed'
-            });
-        }
-        
-        // Generate mock access token
-        const accessToken = `mock_token_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-        this.activeTokens.add(accessToken);
-        
-        res.json({
-            access_token: accessToken,
-            token_type: 'Bearer',
-            expires_in: 3600,
-            scope: 'SFCC_DATA_API'
-        });
-    }
-
-    /**
-     * Middleware to require Bearer token authentication
-     */
-    requireAuth() {
-        return (req, res, next) => {
-            const authHeader = req.headers.authorization;
-            
-            if (!authHeader || !authHeader.startsWith('Bearer ')) {
-                return res.status(401).json({
-                    error: 'unauthorized',
-                    message: 'Missing or invalid authorization header'
-                });
-            }
-            
-            const token = authHeader.substring(7);
-            
-            if (!this.activeTokens.has(token)) {
-                return res.status(401).json({
-                    error: 'invalid_token',
-                    message: 'The access token is invalid or expired'
-                });
-            }
-            
-            req.accessToken = token;
-            next();
-        };
-    }
-
-    /**
-     * Clear expired tokens (for cleanup)
-     */
-    clearExpiredTokens() {
-        // For testing purposes, we'll keep tokens active
-        // In a real implementation, you'd track token expiration
-    }
-}
-
-module.exports = AuthenticationManager;

package/tests/servers/sfcc-mock-server/src/middleware/cors.js

@@ -1,39 +0,0 @@
-/**
- * CORS Middleware
- * 
- * Handles Cross-Origin Resource Sharing configuration for the unified server.
- * Provides permissive CORS settings suitable for testing environments.
- */
-
-const cors = require('cors');
-
-/**
- * Create CORS middleware with appropriate settings for testing
- */
-function createCorsMiddleware() {
-    return cors({
-        origin: '*',
-        methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'PROPFIND'],
-        allowedHeaders: [
-            'Content-Type', 
-            'Authorization', 
-            'Depth', 
-            'Range',
-            'X-Requested-With',
-            'Cache-Control'
-        ],
-        exposedHeaders: [
-            'Content-Range', 
-            'Accept-Ranges',
-            'Content-Length',
-            'Last-Modified'
-        ],
-        credentials: true,
-        preflightContinue: false,
-        optionsSuccessStatus: 200
-    });
-}
-
-module.exports = {
-    createCorsMiddleware
-};

package/tests/servers/sfcc-mock-server/src/middleware/logging.js

@@ -1,124 +0,0 @@
-/**
- * Logging Middleware
- * 
- * Provides request/response logging functionality for debugging and monitoring.
- * Configurable logging levels and output formatting.
- */
-
-/**
- * Create request logging middleware
- */
-function createRequestLogger(isDevMode = false) {
-    if (!isDevMode) {
-        // Return no-op middleware in production mode
-        return (req, res, next) => next();
-    }
-
-    return (req, res, next) => {
-        const timestamp = new Date().toISOString();
-        const method = req.method;
-        const url = req.url;
-        const userAgent = req.headers['user-agent'] || 'Unknown';
-        
-        console.log(`📥 [${timestamp}] ${method} ${url}`, {
-            headers: {
-                authorization: req.headers.authorization ? '[REDACTED]' : undefined,
-                'content-type': req.headers['content-type'],
-                'depth': req.headers.depth,
-                'range': req.headers.range,
-                'user-agent': userAgent
-            },
-            query: Object.keys(req.query).length > 0 ? req.query : undefined,
-            body: req.body && Object.keys(req.body).length > 0 ? req.body : undefined
-        });
-        
-        next();
-    };
-}
-
-/**
- * Create response logging middleware
- */
-function createResponseLogger(isDevMode = false) {
-    if (!isDevMode) {
-        // Return no-op middleware in production mode
-        return (req, res, next) => next();
-    }
-
-    return (req, res, next) => {
-        const originalSend = res.send;
-        const originalJson = res.json;
-        
-        // Override res.send
-        res.send = function(body) {
-            logResponse(req, res, body, 'send');
-            return originalSend.call(this, body);
-        };
-        
-        // Override res.json
-        res.json = function(obj) {
-            logResponse(req, res, obj, 'json');
-            return originalJson.call(this, obj);
-        };
-        
-        next();
-    };
-}
-
-/**
- * Log response details
- */
-function logResponse(req, res, body, type) {
-    const timestamp = new Date().toISOString();
-    const method = req.method;
-    const url = req.url;
-    const statusCode = res.statusCode;
-    
-    let bodyPreview = body;
-    
-    // Truncate large responses for readability
-    if (typeof body === 'string' && body.length > 500) {
-        bodyPreview = body.substring(0, 500) + '... [truncated]';
-    } else if (typeof body === 'object' && body !== null) {
-        const bodyStr = JSON.stringify(body);
-        if (bodyStr.length > 500) {
-            bodyPreview = JSON.stringify(body, null, 2).substring(0, 500) + '... [truncated]';
-        }
-    }
-    
-    console.log(`📤 [${timestamp}] ${method} ${url} -> ${statusCode}`, {
-        headers: {
-            'content-type': res.getHeader('content-type'),
-            'content-length': res.getHeader('content-length'),
-            'content-range': res.getHeader('content-range')
-        },
-        type,
-        body: bodyPreview
-    });
-}
-
-/**
- * Create error logging middleware
- */
-function createErrorLogger() {
-    return (err, req, res, next) => {
-        const timestamp = new Date().toISOString();
-        const method = req.method;
-        const url = req.url;
-        
-        console.error(`❌ [${timestamp}] ERROR ${method} ${url}:`, {
-            message: err.message,
-            stack: err.stack,
-            code: err.code
-        });
-        
-        // Don't handle the error, just log it
-        next(err);
-    };
-}
-
-module.exports = {
-    createRequestLogger,
-    createResponseLogger,
-    createErrorLogger
-};