mcp-wordpress 2.5.0 → 2.5.1

package/dist/src/config/ConfigurationSchema.d.ts

@@ -0,0 +1,281 @@
+import { z } from "zod";
+/**
+ * Zod schema for WordPress authentication methods
+ */
+declare const AuthMethodSchema: z.ZodEnum<["app-password", "jwt", "basic", "api-key", "cookie"]>;
+/**
+ * Zod schema for URL validation with security checks
+ */
+declare const UrlSchema: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+/**
+ * Zod schema for WordPress site configuration
+ */
+declare const SiteConfigSchema: z.ZodObject<{
+    WORDPRESS_SITE_URL: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    WORDPRESS_USERNAME: z.ZodString;
+    WORDPRESS_APP_PASSWORD: z.ZodEffects<z.ZodString, string, string>;
+    WORDPRESS_AUTH_METHOD: z.ZodDefault<z.ZodOptional<z.ZodEnum<["app-password", "jwt", "basic", "api-key", "cookie"]>>>;
+}, "strip", z.ZodTypeAny, {
+    WORDPRESS_SITE_URL: string;
+    WORDPRESS_USERNAME: string;
+    WORDPRESS_APP_PASSWORD: string;
+    WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+}, {
+    WORDPRESS_SITE_URL: string;
+    WORDPRESS_USERNAME: string;
+    WORDPRESS_APP_PASSWORD: string;
+    WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+}>;
+/**
+ * Zod schema for site configuration with metadata
+ */
+declare const SiteSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    config: z.ZodObject<{
+        WORDPRESS_SITE_URL: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        WORDPRESS_USERNAME: z.ZodString;
+        WORDPRESS_APP_PASSWORD: z.ZodEffects<z.ZodString, string, string>;
+        WORDPRESS_AUTH_METHOD: z.ZodDefault<z.ZodOptional<z.ZodEnum<["app-password", "jwt", "basic", "api-key", "cookie"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        WORDPRESS_SITE_URL: string;
+        WORDPRESS_USERNAME: string;
+        WORDPRESS_APP_PASSWORD: string;
+        WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+    }, {
+        WORDPRESS_SITE_URL: string;
+        WORDPRESS_USERNAME: string;
+        WORDPRESS_APP_PASSWORD: string;
+        WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    config: {
+        WORDPRESS_SITE_URL: string;
+        WORDPRESS_USERNAME: string;
+        WORDPRESS_APP_PASSWORD: string;
+        WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+    };
+}, {
+    id: string;
+    name: string;
+    config: {
+        WORDPRESS_SITE_URL: string;
+        WORDPRESS_USERNAME: string;
+        WORDPRESS_APP_PASSWORD: string;
+        WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+    };
+}>;
+/**
+ * Zod schema for multi-site configuration file
+ */
+declare const MultiSiteConfigSchema: z.ZodObject<{
+    sites: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        config: z.ZodObject<{
+            WORDPRESS_SITE_URL: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+            WORDPRESS_USERNAME: z.ZodString;
+            WORDPRESS_APP_PASSWORD: z.ZodEffects<z.ZodString, string, string>;
+            WORDPRESS_AUTH_METHOD: z.ZodDefault<z.ZodOptional<z.ZodEnum<["app-password", "jwt", "basic", "api-key", "cookie"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+        }, {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+        };
+    }, {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+        };
+    }>, "many">, {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+        };
+    }[], {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+        };
+    }[]>, {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+        };
+    }[], {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+        };
+    }[]>, {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+        };
+    }[], {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+        };
+    }[]>;
+}, "strip", z.ZodTypeAny, {
+    sites: {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+        };
+    }[];
+}, {
+    sites: {
+        id: string;
+        name: string;
+        config: {
+            WORDPRESS_SITE_URL: string;
+            WORDPRESS_USERNAME: string;
+            WORDPRESS_APP_PASSWORD: string;
+            WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+        };
+    }[];
+}>;
+/**
+ * Zod schema for environment variables (single-site mode)
+ */
+declare const EnvironmentConfigSchema: z.ZodObject<{
+    WORDPRESS_SITE_URL: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    WORDPRESS_USERNAME: z.ZodString;
+    WORDPRESS_APP_PASSWORD: z.ZodEffects<z.ZodString, string, string>;
+    WORDPRESS_AUTH_METHOD: z.ZodDefault<z.ZodOptional<z.ZodEnum<["app-password", "jwt", "basic", "api-key", "cookie"]>>>;
+    NODE_ENV: z.ZodOptional<z.ZodEnum<["development", "production", "test", "dxt", "ci"]>>;
+    DEBUG: z.ZodOptional<z.ZodString>;
+    DISABLE_CACHE: z.ZodOptional<z.ZodString>;
+    LOG_LEVEL: z.ZodOptional<z.ZodEnum<["error", "warn", "info", "debug"]>>;
+}, "strip", z.ZodTypeAny, {
+    WORDPRESS_SITE_URL: string;
+    WORDPRESS_USERNAME: string;
+    WORDPRESS_APP_PASSWORD: string;
+    WORDPRESS_AUTH_METHOD: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
+    NODE_ENV?: "development" | "production" | "test" | "dxt" | "ci" | undefined;
+    DEBUG?: string | undefined;
+    LOG_LEVEL?: "info" | "debug" | "warn" | "error" | undefined;
+    DISABLE_CACHE?: string | undefined;
+}, {
+    WORDPRESS_SITE_URL: string;
+    WORDPRESS_USERNAME: string;
+    WORDPRESS_APP_PASSWORD: string;
+    NODE_ENV?: "development" | "production" | "test" | "dxt" | "ci" | undefined;
+    WORDPRESS_AUTH_METHOD?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+    DEBUG?: string | undefined;
+    LOG_LEVEL?: "info" | "debug" | "warn" | "error" | undefined;
+    DISABLE_CACHE?: string | undefined;
+}>;
+/**
+ * Zod schema for MCP configuration passed from client
+ */
+declare const McpConfigSchema: z.ZodOptional<z.ZodObject<{
+    wordpressSiteUrl: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    wordpressUsername: z.ZodOptional<z.ZodString>;
+    wordpressAppPassword: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    wordpressAuthMethod: z.ZodOptional<z.ZodEnum<["app-password", "jwt", "basic", "api-key", "cookie"]>>;
+}, "strip", z.ZodTypeAny, {
+    wordpressSiteUrl?: string | undefined;
+    wordpressUsername?: string | undefined;
+    wordpressAppPassword?: string | undefined;
+    wordpressAuthMethod?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+}, {
+    wordpressSiteUrl?: string | undefined;
+    wordpressUsername?: string | undefined;
+    wordpressAppPassword?: string | undefined;
+    wordpressAuthMethod?: "app-password" | "jwt" | "basic" | "api-key" | "cookie" | undefined;
+}>>;
+/**
+ * Type definitions derived from Zod schemas
+ */
+export type SiteConfigType = z.infer<typeof SiteConfigSchema>;
+export type SiteType = z.infer<typeof SiteSchema>;
+export type MultiSiteConfigType = z.infer<typeof MultiSiteConfigSchema>;
+export type EnvironmentConfigType = z.infer<typeof EnvironmentConfigSchema>;
+export type McpConfigType = z.infer<typeof McpConfigSchema>;
+/**
+ * Configuration validation utilities
+ */
+export declare class ConfigurationValidator {
+    /**
+     * Validate multi-site configuration from JSON file
+     */
+    static validateMultiSiteConfig(config: unknown): MultiSiteConfigType;
+    /**
+     * Validate environment configuration for single-site mode
+     */
+    static validateEnvironmentConfig(env: Record<string, string | undefined>): EnvironmentConfigType;
+    /**
+     * Validate MCP configuration passed from client
+     */
+    static validateMcpConfig(config: unknown): McpConfigType;
+    /**
+     * Validate a single site configuration
+     */
+    static validateSiteConfig(config: unknown): SiteType;
+    /**
+     * Check if a configuration file structure is valid without throwing
+     */
+    static isValidMultiSiteConfig(config: unknown): boolean;
+    /**
+     * Check if environment configuration is valid without throwing
+     */
+    static isValidEnvironmentConfig(env: Record<string, string | undefined>): boolean;
+    /**
+     * Get validation errors without throwing
+     */
+    static getValidationErrors(schema: z.ZodSchema, data: unknown): string[];
+}
+export { SiteConfigSchema, SiteSchema, MultiSiteConfigSchema, EnvironmentConfigSchema, McpConfigSchema, AuthMethodSchema, UrlSchema, };
+//# sourceMappingURL=ConfigurationSchema.d.ts.map

package/dist/src/config/ConfigurationSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationSchema.d.ts","sourceRoot":"","sources":["../../../src/config/ConfigurationSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,QAAA,MAAM,gBAAgB,kEAAyE,CAAC;AAEhG;;GAEG;AACH,QAAA,MAAM,SAAS,yEA2ByC,CAAC;AAEzD;;GAEG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;EAgBpB,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQd,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBzB,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;GAOR,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE5D;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB;IAYpE;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,qBAAqB;IAYhG;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa;IAYxD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ;IAYpD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAKvD;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO;IAKjF;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;CAOzE;AAGD,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,SAAS,GACV,CAAC"}

package/dist/src/config/ConfigurationSchema.js

@@ -0,0 +1,205 @@
+import { z } from "zod";
+/**
+ * Zod schema for WordPress authentication methods
+ */
+const AuthMethodSchema = z.enum(["app-password", "jwt", "basic", "api-key", "cookie"]);
+/**
+ * Zod schema for URL validation with security checks
+ */
+const UrlSchema = z
+    .string()
+    .url("Must be a valid URL")
+    .refine((url) => {
+    const parsed = new URL(url);
+    return parsed.protocol === "http:" || parsed.protocol === "https:";
+}, "URL must use http or https protocol")
+    .refine((url) => {
+    // Additional security checks
+    const parsed = new URL(url);
+    const hostname = parsed.hostname.toLowerCase();
+    // In production, block localhost and private IPs
+    if (process.env.NODE_ENV === "production") {
+        if (hostname === "localhost" ||
+            hostname === "127.0.0.1" ||
+            hostname === "::1" ||
+            hostname.match(/^10\./) ||
+            hostname.match(/^172\.(1[6-9]|2[0-9]|3[01])\./) ||
+            hostname.match(/^192\.168\./)) {
+            return false;
+        }
+    }
+    return true;
+}, "Private/localhost URLs not allowed in production");
+/**
+ * Zod schema for WordPress site configuration
+ */
+const SiteConfigSchema = z.object({
+    WORDPRESS_SITE_URL: UrlSchema,
+    WORDPRESS_USERNAME: z
+        .string()
+        .min(1, "Username is required")
+        .max(60, "Username must be 60 characters or less")
+        .regex(/^[a-zA-Z0-9._@-]+$/, "Username contains invalid characters"),
+    WORDPRESS_APP_PASSWORD: z
+        .string()
+        .min(1, "Password is required")
+        .refine((password) => {
+        // WordPress app passwords are typically 24 characters with spaces
+        // But we'll be flexible to support different auth methods
+        return password.length >= 8;
+    }, "Password must be at least 8 characters"),
+    WORDPRESS_AUTH_METHOD: AuthMethodSchema.optional().default("app-password"),
+});
+/**
+ * Zod schema for site configuration with metadata
+ */
+const SiteSchema = z.object({
+    id: z
+        .string()
+        .min(1, "Site ID is required")
+        .max(50, "Site ID must be 50 characters or less")
+        .regex(/^[a-zA-Z0-9_-]+$/, "Site ID can only contain letters, numbers, underscores, and hyphens"),
+    name: z.string().min(1, "Site name is required").max(100, "Site name must be 100 characters or less"),
+    config: SiteConfigSchema,
+});
+/**
+ * Zod schema for multi-site configuration file
+ */
+const MultiSiteConfigSchema = z.object({
+    sites: z
+        .array(SiteSchema)
+        .min(1, "At least one site must be configured")
+        .max(50, "Maximum of 50 sites supported")
+        .refine((sites) => {
+        const ids = sites.map((site) => site.id);
+        const uniqueIds = new Set(ids);
+        return ids.length === uniqueIds.size;
+    }, "Site IDs must be unique")
+        .refine((sites) => {
+        const names = sites.map((site) => site.name);
+        const uniqueNames = new Set(names);
+        return names.length === uniqueNames.size;
+    }, "Site names must be unique")
+        .refine((sites) => {
+        const urls = sites.map((site) => site.config.WORDPRESS_SITE_URL);
+        const uniqueUrls = new Set(urls);
+        return urls.length === uniqueUrls.size;
+    }, "Site URLs must be unique"),
+});
+/**
+ * Zod schema for environment variables (single-site mode)
+ */
+const EnvironmentConfigSchema = z.object({
+    WORDPRESS_SITE_URL: UrlSchema,
+    WORDPRESS_USERNAME: SiteConfigSchema.shape.WORDPRESS_USERNAME,
+    WORDPRESS_APP_PASSWORD: SiteConfigSchema.shape.WORDPRESS_APP_PASSWORD,
+    WORDPRESS_AUTH_METHOD: AuthMethodSchema.optional().default("app-password"),
+    // Optional environment variables
+    NODE_ENV: z.enum(["development", "production", "test", "dxt", "ci"]).optional(),
+    DEBUG: z.string().optional(),
+    DISABLE_CACHE: z.string().optional(),
+    LOG_LEVEL: z.enum(["error", "warn", "info", "debug"]).optional(),
+});
+/**
+ * Zod schema for MCP configuration passed from client
+ */
+const McpConfigSchema = z
+    .object({
+    wordpressSiteUrl: UrlSchema.optional(),
+    wordpressUsername: SiteConfigSchema.shape.WORDPRESS_USERNAME.optional(),
+    wordpressAppPassword: SiteConfigSchema.shape.WORDPRESS_APP_PASSWORD.optional(),
+    wordpressAuthMethod: AuthMethodSchema.optional(),
+})
+    .optional();
+/**
+ * Configuration validation utilities
+ */
+export class ConfigurationValidator {
+    /**
+     * Validate multi-site configuration from JSON file
+     */
+    static validateMultiSiteConfig(config) {
+        try {
+            return MultiSiteConfigSchema.parse(config);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const messages = error.errors.map((err) => `${err.path.join(".")}: ${err.message}`).join("; ");
+                throw new Error(`Multi-site configuration validation failed: ${messages}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate environment configuration for single-site mode
+     */
+    static validateEnvironmentConfig(env) {
+        try {
+            return EnvironmentConfigSchema.parse(env);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const messages = error.errors.map((err) => `${err.path.join(".")}: ${err.message}`).join("; ");
+                throw new Error(`Environment configuration validation failed: ${messages}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate MCP configuration passed from client
+     */
+    static validateMcpConfig(config) {
+        try {
+            return McpConfigSchema.parse(config);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const messages = error.errors.map((err) => `${err.path.join(".")}: ${err.message}`).join("; ");
+                throw new Error(`MCP configuration validation failed: ${messages}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate a single site configuration
+     */
+    static validateSiteConfig(config) {
+        try {
+            return SiteSchema.parse(config);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const messages = error.errors.map((err) => `${err.path.join(".")}: ${err.message}`).join("; ");
+                throw new Error(`Site configuration validation failed: ${messages}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if a configuration file structure is valid without throwing
+     */
+    static isValidMultiSiteConfig(config) {
+        const result = MultiSiteConfigSchema.safeParse(config);
+        return result.success;
+    }
+    /**
+     * Check if environment configuration is valid without throwing
+     */
+    static isValidEnvironmentConfig(env) {
+        const result = EnvironmentConfigSchema.safeParse(env);
+        return result.success;
+    }
+    /**
+     * Get validation errors without throwing
+     */
+    static getValidationErrors(schema, data) {
+        const result = schema.safeParse(data);
+        if (result.success) {
+            return [];
+        }
+        return result.error.errors.map((err) => `${err.path.join(".")}: ${err.message}`);
+    }
+}
+// Export schemas for direct use if needed
+export { SiteConfigSchema, SiteSchema, MultiSiteConfigSchema, EnvironmentConfigSchema, McpConfigSchema, AuthMethodSchema, UrlSchema, };
+//# sourceMappingURL=ConfigurationSchema.js.map

package/dist/src/config/ConfigurationSchema.js.map

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

package/dist/src/config/ServerConfiguration.d.ts

@@ -0,0 +1,47 @@
+import { WordPressClient } from "../client/api.js";
+import { type SiteType as SiteConfig, type MultiSiteConfigType as MultiSiteConfig, type McpConfigType } from "./ConfigurationSchema.js";
+export type { SiteConfig, MultiSiteConfig, McpConfigType };
+/**
+ * Configuration loader for MCP WordPress Server
+ * Handles both single-site (environment variables) and multi-site (JSON config) modes
+ */
+export declare class ServerConfiguration {
+    private static instance;
+    private readonly logger;
+    private rootDir;
+    private envPath;
+    constructor();
+    /**
+     * Get singleton instance of ServerConfiguration
+     */
+    static getInstance(): ServerConfiguration;
+    /**
+     * Load WordPress client configurations
+     * Returns a Map of site ID to WordPressClient instances
+     */
+    loadClientConfigurations(mcpConfig?: McpConfigType): {
+        clients: Map<string, WordPressClient>;
+        configs: SiteConfig[];
+    };
+    /**
+     * Load multi-site configuration from JSON file
+     */
+    private loadMultiSiteConfig;
+    /**
+     * Check if we're in CI environment
+     */
+    private isCIEnvironment;
+    /**
+     * Create mock configuration for CI environments
+     */
+    private createMockConfiguration;
+    /**
+     * Load single-site configuration from environment variables
+     */
+    private loadSingleSiteFromEnv;
+    /**
+     * Get root directory path
+     */
+    getRootDir(): string;
+}
+//# sourceMappingURL=ServerConfiguration.d.ts.map

package/dist/src/config/ServerConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerConfiguration.d.ts","sourceRoot":"","sources":["../../../src/config/ServerConfiguration.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOnD,OAAO,EAEL,KAAK,QAAQ,IAAI,UAAU,EAC3B,KAAK,mBAAmB,IAAI,eAAe,EAC3C,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;AAE3D;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;;IAyCxB;;OAEG;WACW,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,wBAAwB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG;QAC1D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACtC,OAAO,EAAE,UAAU,EAAE,CAAC;KACvB;IAkBD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkD3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4F7B;;OAEG;IACI,UAAU,IAAI,MAAM;CAG5B"}