sfcc-dev-mcp 1.0.0

package/dist/log-client.js

@@ -0,0 +1,226 @@
+/**
+ * SFCC WebDAV Log Client
+ *
+ * This module handles all interactions with SFCC's WebDAV log interface.
+ * It provides methods to fetch, parse, and analyze log files from the
+ * Salesforce B2C Commerce Cloud logging system.
+ */
+import { createClient } from "webdav";
+import { getCurrentDate, formatBytes, parseLogEntries, extractUniqueErrors, normalizeFilePath } from "./utils.js";
+/**
+ * Client for accessing SFCC logs via WebDAV
+ *
+ * This class encapsulates all the logic for connecting to SFCC's WebDAV interface
+ * and performing various log-related operations like fetching, searching, and analyzing logs.
+ */
+export class SFCCLogClient {
+    webdavClient;
+    config;
+    /**
+     * Initialize the SFCC log client
+     *
+     * @param config - SFCC configuration with authentication details
+     */
+    constructor(config) {
+        this.config = config;
+        this.setupWebDAVClient();
+    }
+    /**
+     * Set up the WebDAV client with appropriate authentication
+     * Supports both basic authentication and OAuth credentials
+     *
+     * @private
+     */
+    setupWebDAVClient() {
+        const webdavUrl = `https://${this.config.hostname}/on/demandware.servlet/webdav/Sites/Logs/`;
+        let authConfig = {};
+        if (this.config.username && this.config.password) {
+            // Basic authentication
+            authConfig = {
+                username: this.config.username,
+                password: this.config.password,
+            };
+        }
+        else if (this.config.apiKey && this.config.apiSecret) {
+            // OAuth authentication (using API key as username and secret as password for WebDAV)
+            authConfig = {
+                username: this.config.apiKey,
+                password: this.config.apiSecret,
+            };
+        }
+        else {
+            throw new Error("Either username/password or apiKey/apiSecret must be provided");
+        }
+        this.webdavClient = createClient(webdavUrl, authConfig);
+    }
+    /**
+     * Get list of log files for a specific date
+     *
+     * @param date - Date in YYYYMMDD format (defaults to today)
+     * @returns Array of log file names for the specified date
+     */
+    async getLogFiles(date) {
+        const targetDate = date || getCurrentDate();
+        const contents = await this.webdavClient.getDirectoryContents("/");
+        return contents
+            .filter((item) => item.type === "file" &&
+            item.filename.includes(targetDate) &&
+            item.filename.endsWith(".log"))
+            .map((item) => item.filename);
+    }
+    /**
+     * Get the latest log entries for a specific log level
+     *
+     * @param level - Log level to fetch (error, warn, info)
+     * @param limit - Maximum number of entries to return
+     * @param date - Date in YYYYMMDD format (defaults to today)
+     * @returns Formatted log entries
+     */
+    async getLatestLogs(level, limit, date) {
+        const targetDate = date || getCurrentDate();
+        const logFiles = await this.getLogFiles(targetDate);
+        // Filter files for the specific log level
+        const levelFiles = logFiles.filter(file => {
+            const filename = normalizeFilePath(file);
+            return filename.startsWith(level + '-');
+        });
+        if (levelFiles.length === 0) {
+            const availableFiles = logFiles.map(f => normalizeFilePath(f)).join(', ');
+            return `No ${level} log files found for date ${targetDate}. Available files: ${availableFiles}`;
+        }
+        // Get the most recent log file (sort by filename, latest timestamp should be last)
+        const latestFile = levelFiles.sort().pop();
+        const logContent = await this.webdavClient.getFileContents(latestFile, { format: "text" });
+        const logEntries = parseLogEntries(logContent, level.toUpperCase());
+        const latestEntries = logEntries.slice(-limit).reverse();
+        return `Latest ${limit} ${level} messages from ${normalizeFilePath(latestFile)}:\n\n${latestEntries.join('\n\n---\n\n')}`;
+    }
+    /**
+     * Generate a comprehensive summary of logs for a specific date
+     *
+     * @param date - Date in YYYYMMDD format (defaults to today)
+     * @returns Detailed log summary with counts and key issues
+     */
+    async summarizeLogs(date) {
+        const targetDate = date || getCurrentDate();
+        const logFiles = await this.getLogFiles(targetDate);
+        if (logFiles.length === 0) {
+            return `No log files found for date ${targetDate}`;
+        }
+        const summary = {
+            date: targetDate,
+            errorCount: 0,
+            warningCount: 0,
+            infoCount: 0,
+            keyIssues: [],
+            files: logFiles,
+        };
+        // Analyze each log file for counts and patterns
+        for (const file of logFiles) {
+            try {
+                const content = await this.webdavClient.getFileContents(file, { format: "text" });
+                const lines = content.split('\n');
+                // Count different log levels
+                for (const line of lines) {
+                    if (line.includes(' ERROR '))
+                        summary.errorCount++;
+                    if (line.includes(' WARN '))
+                        summary.warningCount++;
+                    if (line.includes(' INFO '))
+                        summary.infoCount++;
+                }
+                // Extract key error patterns from error files
+                const filename = normalizeFilePath(file);
+                if (filename.startsWith('error-')) {
+                    const errors = parseLogEntries(content, 'ERROR');
+                    const uniqueErrors = extractUniqueErrors(errors);
+                    summary.keyIssues.push(...uniqueErrors);
+                }
+            }
+            catch (error) {
+                console.error(`Error reading file ${file}:`, error);
+            }
+        }
+        // Remove duplicate key issues
+        summary.keyIssues = [...new Set(summary.keyIssues)];
+        return this.formatLogSummary(summary);
+    }
+    /**
+     * Search for specific patterns across log files
+     *
+     * @param pattern - Search pattern or keyword
+     * @param logLevel - Optional log level to restrict search to
+     * @param limit - Maximum number of matches to return
+     * @param date - Date in YYYYMMDD format (defaults to today)
+     * @returns Formatted search results
+     */
+    async searchLogs(pattern, logLevel, limit = 20, date) {
+        const targetDate = date || getCurrentDate();
+        const logFiles = await this.getLogFiles(targetDate);
+        let filesToSearch = logFiles;
+        if (logLevel) {
+            filesToSearch = logFiles.filter(file => {
+                const filename = normalizeFilePath(file);
+                return filename.startsWith(logLevel + '-');
+            });
+        }
+        const matchingEntries = [];
+        for (const file of filesToSearch) {
+            try {
+                const content = await this.webdavClient.getFileContents(file, { format: "text" });
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    if (line.toLowerCase().includes(pattern.toLowerCase()) && matchingEntries.length < limit) {
+                        matchingEntries.push(`[${normalizeFilePath(file)}] ${line.trim()}`);
+                    }
+                }
+            }
+            catch (error) {
+                console.error(`Error searching file ${file}:`, error);
+            }
+        }
+        return matchingEntries.length > 0
+            ? `Found ${matchingEntries.length} matches for "${pattern}":\n\n${matchingEntries.join('\n\n')}`
+            : `No matches found for "${pattern}" in logs for ${targetDate}`;
+    }
+    /**
+     * List all available log files with metadata
+     *
+     * @returns Formatted list of log files with size and modification dates
+     */
+    async listLogFiles() {
+        try {
+            const contents = await this.webdavClient.getDirectoryContents("/");
+            const logFiles = contents
+                .filter((item) => item.type === "file" && item.filename.endsWith(".log"))
+                .map((item) => ({
+                name: item.filename,
+                size: item.size,
+                lastModified: item.lastmod,
+            }));
+            return `Available log files:\n\n${logFiles.map((file) => `📄 ${file.name}\n   Size: ${formatBytes(file.size)}\n   Modified: ${file.lastModified}`).join('\n\n')}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to list log files: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Format a log summary into a readable string
+     *
+     * @param summary - Log summary data
+     * @returns Formatted summary string
+     * @private
+     */
+    formatLogSummary(summary) {
+        return `Log Summary for ${summary.date}:\n\n` +
+            `📊 Counts:\n` +
+            `- Errors: ${summary.errorCount}\n` +
+            `- Warnings: ${summary.warningCount}\n` +
+            `- Info: ${summary.infoCount}\n\n` +
+            `📁 Log Files (${summary.files.length}):\n` +
+            `${summary.files.map((f) => `- ${f}`).join('\n')}\n\n` +
+            `🔥 Key Issues:\n` +
+            `${summary.keyIssues.length > 0 ? summary.keyIssues.map((issue) => `- ${issue}`).join('\n') : 'No major issues detected'}`;
+    }
+}
+//# sourceMappingURL=log-client.js.map

package/dist/log-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-client.js","sourceRoot":"","sources":["../src/log-client.ts"],"names":[],"mappings":"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"}

package/dist/main.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Main entry point for the SFCC Development MCP Server
+ *
+ * This script initializes and starts the MCP server with SFCC development capabilities
+ * including log analysis and comprehensive documentation querying.
+ *
+ * Usage:
+ *   node build/main.js
+ *   npm start
+ *   npm run start -- --dw-json /path/to/dw.json
+ *   npm run start -- --dw-json ./dw.json
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}

package/dist/main.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * Main entry point for the SFCC Development MCP Server
+ *
+ * This script initializes and starts the MCP server with SFCC development capabilities
+ * including log analysis and comprehensive documentation querying.
+ *
+ * Usage:
+ *   node build/main.js
+ *   npm start
+ *   npm run start -- --dw-json /path/to/dw.json
+ *   npm run start -- --dw-json ./dw.json
+ */
+import { SFCCDevServer } from "./server.js";
+import { loadDwJsonConfig } from "./config.js";
+import { existsSync } from "fs";
+import { resolve } from "path";
+/**
+ * Parse command line arguments to extract configuration options
+ */
+function parseCommandLineArgs() {
+    const args = process.argv.slice(2);
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--dw-json" && i + 1 < args.length) {
+            options.dwJsonPath = args[i + 1];
+            i++; // Skip the next argument since we consumed it
+        }
+    }
+    return options;
+}
+/**
+ * Load configuration from various sources in order of preference:
+ * 1. Command line --dw-json argument
+ * 2. ./dw.json in current directory
+ * 3. Environment variables
+ * 4. Default values
+ */
+function loadConfiguration() {
+    const { dwJsonPath } = parseCommandLineArgs();
+    // 1. Try command line argument first
+    if (dwJsonPath) {
+        const resolvedPath = resolve(dwJsonPath);
+        if (!existsSync(resolvedPath)) {
+            console.error(`Error: dw.json file not found at: ${resolvedPath}`);
+            process.exit(1);
+        }
+        console.log(`Loading configuration from: ${resolvedPath}`);
+        return loadDwJsonConfig(resolvedPath);
+    }
+    // 2. Try ./dw.json in current directory
+    const defaultDwJsonPath = "./dw.json";
+    if (existsSync(defaultDwJsonPath)) {
+        console.log(`Loading configuration from: ${resolve(defaultDwJsonPath)}`);
+        return loadDwJsonConfig(defaultDwJsonPath);
+    }
+    // 3. Fall back to environment variables
+    console.log("Loading configuration from environment variables");
+    const config = {
+        hostname: process.env.SFCC_HOSTNAME || "your-instance.sandbox.us01.dx.commercecloud.salesforce.com",
+        clientId: process.env.SFCC_CLIENT_ID || "",
+        clientSecret: process.env.SFCC_CLIENT_SECRET || "",
+        username: process.env.SFCC_USERNAME || "",
+        password: process.env.SFCC_PASSWORD || "",
+        siteId: process.env.SFCC_SITE_ID || "RefArch",
+    };
+    return config;
+}
+async function main() {
+    try {
+        // Load configuration from dw.json or environment variables
+        const config = loadConfiguration();
+        console.log(config);
+        // Validate that we have the minimum required configuration
+        if (!config.hostname) {
+            console.error("Error: SFCC hostname is required. Please provide it via:");
+            console.error("  1. dw.json file: npm run start -- --dw-json /path/to/dw.json");
+            console.error("  2. Environment variable: SFCC_HOSTNAME=your-instance.com npm start");
+            process.exit(1);
+        }
+        if (!config.username && !config.clientId) {
+            console.error("Error: Authentication credentials are required. Please provide either:");
+            console.error("  1. Username/password in dw.json or via SFCC_USERNAME/SFCC_PASSWORD");
+            console.error("  2. Client ID/secret via SFCC_CLIENT_ID/SFCC_CLIENT_SECRET");
+            process.exit(1);
+        }
+        // Initialize and start the MCP server
+        const server = new SFCCDevServer(config);
+        console.log("Starting SFCC Development MCP Server...");
+        console.log(`Connected to: ${config.hostname}`);
+        console.log(`Authentication: ${config.username ? "Username/Password" : "Client ID/Secret"}`);
+        await server.run();
+    }
+    catch (error) {
+        console.error("Failed to start SFCC Development MCP server:", error);
+        process.exit(1);
+    }
+}
+// Handle graceful shutdown
+process.on("SIGINT", () => {
+    console.error("Received SIGINT, shutting down gracefully...");
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    console.error("Received SIGTERM, shutting down gracefully...");
+    process.exit(0);
+});
+main();
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MCP Server for SFCC Development
+ *
+ * This module implements the Model Context Protocol (MCP) server for accessing
+ * Salesforce B2C Commerce Cloud development features. It provides a standardized interface
+ * for AI assistants to interact with SFCC development tools and data.
+ */
+import { SFCCConfig } from "./types.js";
+/**
+ * MCP Server implementation for SFCC development assistance
+ *
+ * This class sets up the MCP server, defines available tools, and handles
+ * requests from MCP clients (like AI assistants) to interact with SFCC development features.
+ */
+export declare class SFCCDevServer {
+    private server;
+    private logClient;
+    private docsClient;
+    private bestPracticesClient;
+    /**
+     * Initialize the SFCC Development MCP Server
+     *
+     * @param config - SFCC configuration for connecting to the logging system
+     */
+    constructor(config: SFCCConfig);
+    /**
+     * Set up MCP tool handlers for SFCC operations
+     */
+    private setupToolHandlers;
+    /**
+     * Start the MCP server
+     */
+    run(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,UAAU,EAAY,MAAM,YAAY,CAAC;AAKlD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,mBAAmB,CAA0B;IAErD;;;;OAIG;gBACS,MAAM,EAAE,UAAU;IAmB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmiBzB;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAK3B"}