mcp-wordpress 2.4.2 → 2.5.0

package/dist/utils/error.js

@@ -1,6 +1,23 @@
 /**
  * Error handling utilities
  */
+import { LoggerFactory } from "./logger.js";
+import { config } from "../config/Config.js";
+const logger = LoggerFactory.server().child({ component: "ErrorUtils" });
+// Environment flag to control legacy console logging noise. Default enabled to preserve
+// backward compatibility and existing test expectations. Set LEGACY_ERROR_LOGS=0 to disable
+// the direct console.error side-channel (structured logger still emits).
+const LEGACY_ERROR_LOGS_ENABLED = config().error.legacyLogsEnabled;
+// Internal helper to avoid sprinkling conditionals
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function legacyConsoleError(...args) {
+    if (LEGACY_ERROR_LOGS_ENABLED) {
+        console.error(...args);
+    }
+}
+// Test hook: exported only for instrumentation in unit tests (tree-shakeable)
+// @__PURE__ This constant has no side effects and can be dropped in production builds
+export const __errorUtilsLogger = logger;
 export function getErrorMessage(error) {
     if (error instanceof Error) {
         return error.message;
@@ -17,18 +34,32 @@ export function isError(error) {
     return error instanceof Error;
 }
 export function logAndReturn(error, defaultValue) {
-    console.error("Error occurred:", getErrorMessage(error));
+    const message = getErrorMessage(error);
+    // Legacy console logging (can be disabled via LEGACY_ERROR_LOGS=0)
+    legacyConsoleError("Error occurred:", message);
+    logger.warn("Error occurred - returning default value", {
+        error: message,
+    });
     return defaultValue;
 }
 /**
  * Enhanced error handler for consistent tool error handling
  */
 export function handleToolError(error, operation, context) {
-    console.error(`Error in ${operation}:`, error);
+    const message = getErrorMessage(error);
+    const errObj = error instanceof Error ? error : new Error(message);
+    // Legacy console logging (can be disabled via LEGACY_ERROR_LOGS=0)
+    legacyConsoleError(`Error in ${operation}:`, errObj);
     if (context) {
-        console.error("Context:", context);
+        legacyConsoleError("Context:", context);
+    }
+    logger.error(`Error in ${operation}`, {
+        error: message,
+        ...(context && { context }),
+    });
+    if (error instanceof Error && error.stack) {
+        logger.debug("Error stack trace", { stack: error.stack });
     }
-    const message = getErrorMessage(error);
     // Provide more specific error messages based on error content
     if (message.includes("ECONNREFUSED") || message.includes("ENOTFOUND")) {
         throw new Error(`Connection failed during ${operation}. Please check your WordPress site URL and network connection.`);
@@ -48,7 +79,13 @@ export function handleToolError(error, operation, context) {
  * Validates required parameters
  */
 export function validateRequired(params, required) {
-    const missing = required.filter((key) => !params[key]);
+    // Runtime guard: ensure params is a non-null object (tests expect throw on invalid input)
+    if (params === null || typeof params !== "object") {
+        throw new Error("Parameters must be an object");
+    }
+    // Only treat undefined or null as missing; accept legitimate falsy values: 0, false, ""
+    const obj = params;
+    const missing = required.filter((key) => obj[key] === undefined || obj[key] === null);
     if (missing.length > 0) {
         throw new Error(`Missing required parameters: ${missing.join(", ")}`);
     }

package/dist/utils/error.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Centralized Logging System
+ *
+ * Replaces scattered console.log usage with structured, configurable logging.
+ * Integrates with the centralized Config system for environment-aware behavior.
+ */
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+export type LogContext = Record<string, unknown>;
+export interface LogEntry {
+    readonly timestamp: string;
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly context?: LogContext | undefined;
+    readonly component?: string | undefined;
+    readonly requestId?: string | undefined;
+    readonly siteId?: string | undefined;
+    readonly userId?: string | undefined;
+}
+export interface LoggerOptions {
+    readonly component?: string | undefined;
+    readonly context?: LogContext | undefined;
+    readonly siteId?: string | undefined;
+    readonly requestId?: string | undefined;
+}
+/**
+ * Main Logger Class
+ */
+export declare class Logger {
+    private readonly options;
+    constructor(options?: LoggerOptions);
+    /**
+     * Create child logger with additional context
+     */
+    child(additionalOptions: LoggerOptions): Logger;
+    /**
+     * Log at specific level
+     */
+    log(level: LogLevel, message: string, context?: LogContext): void;
+    trace(message: string, context?: LogContext): void;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+    error(error: Error, context?: LogContext): void;
+    fatal(message: string, context?: LogContext): void;
+    fatal(error: Error, context?: LogContext): void;
+    /**
+     * Time a function execution
+     */
+    time<T>(message: string, fn: () => T): T;
+    time<T>(message: string, fn: () => Promise<T>): Promise<T>;
+}
+/**
+ * Default logger instance
+ */
+export declare const logger: Logger;
+/**
+ * Create component-specific logger
+ */
+export declare function createLogger(component: string, options?: Omit<LoggerOptions, "component">): Logger;
+/**
+ * Create site-specific logger
+ */
+export declare function createSiteLogger(siteId: string, component?: string | undefined): Logger;
+/**
+ * Create request-specific logger
+ */
+export declare function createRequestLogger(requestId: string, component?: string | undefined, siteId?: string | undefined): Logger;
+/**
+ * Logger factory for common scenarios
+ */
+export declare const LoggerFactory: {
+    /**
+     * Create logger for WordPress API operations
+     */
+    api: (siteId?: string | undefined) => Logger;
+    /**
+     * Create logger for cache operations
+     */
+    cache: (siteId?: string | undefined) => Logger;
+    /**
+     * Create logger for tool operations
+     */
+    tool: (toolName: string, siteId?: string | undefined) => Logger;
+    /**
+     * Create logger for authentication
+     */
+    auth: (siteId?: string | undefined) => Logger;
+    /**
+     * Create logger for configuration
+     */
+    config: () => Logger;
+    /**
+     * Create logger for security operations
+     */
+    security: () => Logger;
+    /**
+     * Create logger for performance monitoring
+     */
+    performance: () => Logger;
+    /**
+     * Create logger for server operations
+     */
+    server: () => Logger;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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

package/dist/utils/logger.js

@@ -0,0 +1,280 @@
+/**
+ * Centralized Logging System
+ *
+ * Replaces scattered console.log usage with structured, configurable logging.
+ * Integrates with the centralized Config system for environment-aware behavior.
+ */
+import { ConfigHelpers } from "../config/Config.js";
+/**
+ * Log level priorities (higher number = more important)
+ */
+const LOG_LEVELS = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+};
+/**
+ * Get minimum log level from configuration
+ */
+function getMinLogLevel() {
+    const configInstance = ConfigHelpers.get();
+    const appConfig = configInstance.get();
+    const configLevel = appConfig.debug.logLevel.toLowerCase();
+    return LOG_LEVELS[configLevel] !== undefined ? configLevel : "info";
+}
+/**
+ * Check if log level should be output
+ */
+function shouldLog(level) {
+    const minLevel = getMinLogLevel();
+    return LOG_LEVELS[level] >= LOG_LEVELS[minLevel];
+}
+/**
+ * Format log entry for output
+ */
+function formatLogEntry(entry) {
+    const timestamp = entry.timestamp;
+    const level = entry.level.toUpperCase().padEnd(5);
+    const component = entry.component ? `[${entry.component}]` : "";
+    const siteId = entry.siteId ? `{site:${entry.siteId}}` : "";
+    const requestId = entry.requestId ? `{req:${entry.requestId.slice(0, 8)}}` : "";
+    let message = `${timestamp} ${level} ${component}${siteId}${requestId} ${entry.message}`;
+    if (entry.context && Object.keys(entry.context).length > 0) {
+        const contextStr = JSON.stringify(entry.context);
+        message += ` ${contextStr}`;
+    }
+    return message;
+}
+/**
+ * Sanitize sensitive data from log context
+ */
+function sanitizeContext(context) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(context)) {
+        const keyLower = key.toLowerCase();
+        const isSensitive = keyLower.includes("password") ||
+            keyLower.includes("secret") ||
+            keyLower.includes("token") ||
+            keyLower.includes("key") ||
+            keyLower.includes("credential");
+        if (isSensitive) {
+            if (typeof value === "string") {
+                sanitized[key] = value.length > 0 ? `[REDACTED:${value.length}chars]` : "[EMPTY]";
+            }
+            else if (Array.isArray(value)) {
+                sanitized[key] = "[EMPTY]"; // Redact entire array for sensitive fields
+            }
+            else {
+                sanitized[key] = value; // Keep non-string, non-array values as-is
+            }
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Output log entry to appropriate destination
+ */
+function outputLog(entry) {
+    // In test environment, only log errors and fatals
+    if (ConfigHelpers.isTest() && LOG_LEVELS[entry.level] < LOG_LEVELS.error) {
+        return;
+    }
+    // In DXT mode, suppress most logging
+    if (ConfigHelpers.isDXT() && LOG_LEVELS[entry.level] < LOG_LEVELS.warn) {
+        return;
+    }
+    const formatted = formatLogEntry(entry);
+    // Use stderr for all log output to avoid STDIO interference
+    console.error(formatted);
+}
+/**
+ * Main Logger Class
+ */
+export class Logger {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Create child logger with additional context
+     */
+    child(additionalOptions) {
+        return new Logger({
+            component: additionalOptions.component ?? this.options.component,
+            siteId: additionalOptions.siteId ?? this.options.siteId,
+            requestId: additionalOptions.requestId ?? this.options.requestId,
+            context: {
+                ...this.options.context,
+                ...additionalOptions.context,
+            },
+        });
+    }
+    /**
+     * Log at specific level
+     */
+    log(level, message, context) {
+        if (!shouldLog(level)) {
+            return;
+        }
+        const mergedContext = context ? sanitizeContext({ ...this.options.context, ...context }) : this.options.context;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...(mergedContext && Object.keys(mergedContext).length > 0 && { context: mergedContext }),
+            ...(this.options.component && { component: this.options.component }),
+            ...(this.options.requestId && { requestId: this.options.requestId }),
+            ...(this.options.siteId && { siteId: this.options.siteId }),
+        };
+        outputLog(entry);
+    }
+    // Convenience methods
+    trace(message, context) {
+        this.log("trace", message, context);
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(messageOrError, context) {
+        if (messageOrError instanceof Error) {
+            this.log("error", messageOrError.message, {
+                ...context,
+                errorName: messageOrError.name,
+                errorStack: messageOrError.stack,
+            });
+        }
+        else {
+            this.log("error", messageOrError, context);
+        }
+    }
+    fatal(messageOrError, context) {
+        if (messageOrError instanceof Error) {
+            this.log("fatal", messageOrError.message, {
+                ...context,
+                errorName: messageOrError.name,
+                errorStack: messageOrError.stack,
+            });
+        }
+        else {
+            this.log("fatal", messageOrError, context);
+        }
+    }
+    time(message, fn) {
+        const start = Date.now();
+        this.debug(`Starting: ${message}`);
+        try {
+            const result = fn();
+            // Check if result is a Promise by checking for then method
+            if (result && typeof result === "object" && "then" in result) {
+                // Cast to Promise<T> since we know it has a then method
+                const promiseResult = result;
+                return promiseResult
+                    .then((value) => {
+                    const duration = Date.now() - start;
+                    this.debug(`Completed: ${message}`, { duration: `${duration}ms` });
+                    return value;
+                })
+                    .catch((error) => {
+                    const duration = Date.now() - start;
+                    this.error(`Failed: ${message}`, {
+                        duration: `${duration}ms`,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                });
+            }
+            else {
+                const duration = Date.now() - start;
+                this.debug(`Completed: ${message}`, { duration: `${duration}ms` });
+                return result;
+            }
+        }
+        catch (error) {
+            const duration = Date.now() - start;
+            this.error(`Failed: ${message}`, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+}
+/**
+ * Default logger instance
+ */
+export const logger = new Logger();
+/**
+ * Create component-specific logger
+ */
+export function createLogger(component, options = {}) {
+    return new Logger({ ...options, component });
+}
+/**
+ * Create site-specific logger
+ */
+export function createSiteLogger(siteId, component) {
+    return new Logger({
+        siteId,
+        ...(component && { component }),
+    });
+}
+/**
+ * Create request-specific logger
+ */
+export function createRequestLogger(requestId, component, siteId) {
+    return new Logger({
+        requestId,
+        ...(component && { component }),
+        ...(siteId && { siteId }),
+    });
+}
+/**
+ * Logger factory for common scenarios
+ */
+export const LoggerFactory = {
+    /**
+     * Create logger for WordPress API operations
+     */
+    api: (siteId) => createLogger("API", siteId ? { siteId } : {}),
+    /**
+     * Create logger for cache operations
+     */
+    cache: (siteId) => createLogger("CACHE", siteId ? { siteId } : {}),
+    /**
+     * Create logger for tool operations
+     */
+    tool: (toolName, siteId) => createLogger(`TOOL:${toolName}`, siteId ? { siteId } : {}),
+    /**
+     * Create logger for authentication
+     */
+    auth: (siteId) => createLogger("AUTH", siteId ? { siteId } : {}),
+    /**
+     * Create logger for configuration
+     */
+    config: () => createLogger("CONFIG"),
+    /**
+     * Create logger for security operations
+     */
+    security: () => createLogger("SECURITY"),
+    /**
+     * Create logger for performance monitoring
+     */
+    performance: () => createLogger("PERF"),
+    /**
+     * Create logger for server operations
+     */
+    server: () => createLogger("SERVER"),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/streaming.d.ts

@@ -5,8 +5,8 @@
 export interface StreamingOptions {
     batchSize?: number;
     delay?: number;
-    transformItem?: (item: any) => any;
-    filterItem?: (item: any) => boolean;
+    transformItem?: (item: unknown) => unknown;
+    filterItem?: (item: unknown) => boolean;
 }
 export interface StreamingResult<T> {
     data: T[];
@@ -43,28 +43,28 @@ export declare class WordPressDataStreamer {
     /**
      * Streams WordPress posts with author and taxonomy information
      */
-    static streamPosts(posts: any[], options?: {
+    static streamPosts(posts: unknown[], options?: {
         includeAuthor?: boolean;
         includeCategories?: boolean;
         includeTags?: boolean;
         batchSize?: number;
-    }): AsyncGenerator<StreamingResult<any>, void, unknown>;
+    }): AsyncGenerator<StreamingResult<unknown>, void, unknown>;
     /**
      * Streams WordPress users with role information
      */
-    static streamUsers(users: any[], options?: {
+    static streamUsers(users: unknown[], options?: {
         includeRoles?: boolean;
         includeCapabilities?: boolean;
         batchSize?: number;
-    }): AsyncGenerator<StreamingResult<any>, void, unknown>;
+    }): AsyncGenerator<StreamingResult<unknown>, void, unknown>;
     /**
      * Streams WordPress comments with moderation status
      */
-    static streamComments(comments: any[], options?: {
+    static streamComments(comments: unknown[], options?: {
         includeAuthor?: boolean;
         includePost?: boolean;
         batchSize?: number;
-    }): AsyncGenerator<StreamingResult<any>, void, unknown>;
+    }): AsyncGenerator<StreamingResult<unknown>, void, unknown>;
 }
 /**
  * Utility functions for streaming responses
@@ -73,7 +73,7 @@ export declare class StreamingUtils {
     /**
      * Formats streaming results for display
      */
-    static formatStreamingResponse(results: StreamingResult<any>[], type?: "posts" | "users" | "comments" | "media"): string;
+    static formatStreamingResponse(results: StreamingResult<unknown>[], type?: "posts" | "users" | "comments" | "media"): string;
     /**
      * Implements progressive loading for large datasets
      */

package/dist/utils/streaming.d.ts.map

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