mcp-wordpress 2.6.3 → 2.7.0

package/dist/cache/SEOCacheManager.js

@@ -0,0 +1,275 @@
+/**
+ * SEO Cache Manager
+ *
+ * Extends the base cache manager with SEO-specific caching strategies
+ * and invalidation patterns. Provides optimized caching for SEO analysis,
+ * schema generation, and audit results.
+ *
+ * @since 2.7.0
+ */
+import { CacheManager } from "./CacheManager.js";
+import { Config } from "../config/Config.js";
+import { LoggerFactory } from "../utils/logger.js";
+/**
+ * SEO-specific cache manager
+ *
+ * Implements specialized caching strategies for SEO operations:
+ * - Content analysis results (6 hour default TTL)
+ * - Schema markup (24 hour default TTL)
+ * - Site audits (1 hour default TTL)
+ * - Keyword research (7 day default TTL)
+ * - SERP data (12 hour default TTL)
+ */
+export class SEOCacheManager extends CacheManager {
+    SEO_CACHE_PREFIX = "seo:";
+    logger = LoggerFactory.cache("seo");
+    seoConfig = Config.getInstance().get().seo;
+    /**
+     * Default TTL values for different SEO operations
+     */
+    DEFAULT_TTL = {
+        analysis: this.seoConfig.cache.analysisTTL || 21600, // 6 hours
+        schema: this.seoConfig.cache.schemaTTL || 86400, // 24 hours
+        audit: this.seoConfig.cache.auditTTL || 3600, // 1 hour
+        keywords: this.seoConfig.cache.keywordsTTL || 604800, // 7 days
+        serp: 43200, // 12 hours
+        metadata: 7200, // 2 hours
+        links: 10800, // 3 hours
+    };
+    constructor() {
+        const config = {
+            maxSize: 1000,
+            defaultTTL: 21600, // 6 hours default for SEO operations
+            enableLRU: true,
+            enableStats: true,
+            sitePrefix: "seo",
+        };
+        super(config);
+    }
+    /**
+     * Get SEO-specific cache key
+     *
+     * @param type - Type of SEO operation
+     * @param site - Site identifier
+     * @param identifier - Unique identifier (post ID, etc.)
+     * @param suffix - Additional suffix for uniqueness
+     * @returns Formatted cache key
+     */
+    getSEOCacheKey(type, site, identifier, suffix) {
+        const parts = [this.SEO_CACHE_PREFIX, type, site, identifier];
+        if (suffix) {
+            parts.push(suffix);
+        }
+        return parts.join(":");
+    }
+    /**
+     * Cache SEO analysis result
+     *
+     * @param postId - WordPress post ID
+     * @param analysisType - Type of analysis performed
+     * @param result - Analysis result to cache
+     * @param site - Site identifier
+     * @param ttl - Optional custom TTL
+     */
+    async cacheAnalysis(postId, analysisType, result, site = "default", ttl) {
+        const key = this.getSEOCacheKey("analysis", site, postId, analysisType);
+        const actualTTL = ttl || this.DEFAULT_TTL.analysis;
+        this.set(key, result, actualTTL);
+        this.logger.debug("Cached SEO analysis", {
+            key,
+            ttl: actualTTL,
+            site,
+            postId,
+            analysisType,
+        });
+    }
+    /**
+     * Get cached SEO analysis result
+     *
+     * @param postId - WordPress post ID
+     * @param analysisType - Type of analysis
+     * @param site - Site identifier
+     * @returns Cached result or null
+     */
+    getCachedAnalysis(postId, analysisType, site = "default") {
+        const key = this.getSEOCacheKey("analysis", site, postId, analysisType);
+        const cached = this.get(key);
+        if (cached) {
+            this.logger.debug("SEO analysis cache hit", { key, site, postId });
+        }
+        return cached;
+    }
+    /**
+     * Cache schema markup
+     *
+     * @param postId - WordPress post ID
+     * @param schemaType - Type of schema
+     * @param schema - Schema markup to cache
+     * @param site - Site identifier
+     * @param ttl - Optional custom TTL
+     */
+    async cacheSchema(postId, schemaType, schema, site = "default", ttl) {
+        const key = this.getSEOCacheKey("schema", site, postId, schemaType);
+        const actualTTL = ttl || this.DEFAULT_TTL.schema;
+        this.set(key, schema, actualTTL);
+        this.logger.debug("Cached schema markup", {
+            key,
+            ttl: actualTTL,
+            site,
+            postId,
+            schemaType,
+        });
+    }
+    /**
+     * Get cached schema markup
+     *
+     * @param postId - WordPress post ID
+     * @param schemaType - Type of schema
+     * @param site - Site identifier
+     * @returns Cached schema or null
+     */
+    getCachedSchema(postId, schemaType, site = "default") {
+        const key = this.getSEOCacheKey("schema", site, postId, schemaType);
+        return this.get(key);
+    }
+    /**
+     * Cache site audit results
+     *
+     * @param auditType - Type of audit performed
+     * @param result - Audit results
+     * @param site - Site identifier
+     * @param ttl - Optional custom TTL
+     */
+    async cacheAudit(auditType, result, site = "default", ttl) {
+        const key = this.getSEOCacheKey("audit", site, "site", auditType);
+        const actualTTL = ttl || this.DEFAULT_TTL.audit;
+        this.set(key, result, actualTTL);
+        this.logger.debug("Cached site audit", {
+            key,
+            ttl: actualTTL,
+            site,
+            auditType,
+        });
+    }
+    /**
+     * Get cached audit results
+     *
+     * @param auditType - Type of audit
+     * @param site - Site identifier
+     * @returns Cached audit or null
+     */
+    getCachedAudit(auditType, site = "default") {
+        const key = this.getSEOCacheKey("audit", site, "site", auditType);
+        return this.get(key);
+    }
+    /**
+     * Invalidate all SEO cache for a specific post
+     *
+     * Called when a post is updated to ensure fresh SEO analysis
+     *
+     * @param postId - WordPress post ID
+     * @param site - Site identifier
+     */
+    async invalidatePostSEO(postId, site = "default") {
+        const patterns = [
+            `${this.SEO_CACHE_PREFIX}analysis:${site}:${postId}:*`,
+            `${this.SEO_CACHE_PREFIX}schema:${site}:${postId}:*`,
+            `${this.SEO_CACHE_PREFIX}metadata:${site}:${postId}:*`,
+            `${this.SEO_CACHE_PREFIX}links:${site}:${postId}:*`,
+        ];
+        for (const pattern of patterns) {
+            await this.invalidatePattern(pattern);
+        }
+        this.logger.info("Invalidated SEO cache for post", { postId, site });
+    }
+    /**
+     * Invalidate all SEO cache for a site
+     *
+     * Called during major updates or when site-wide changes occur
+     *
+     * @param site - Site identifier
+     */
+    async invalidateSiteSEO(site = "default") {
+        const pattern = `${this.SEO_CACHE_PREFIX}*:${site}:*`;
+        await this.invalidatePattern(pattern);
+        this.logger.info("Invalidated all SEO cache for site", { site });
+    }
+    /**
+     * Invalidate cache entries matching a pattern
+     *
+     * @param pattern - Cache key pattern to match
+     * @private
+     */
+    async invalidatePattern(pattern) {
+        // Get all cache keys and filter by pattern
+        const allKeys = await this.getAllKeys();
+        const regex = new RegExp("^" + pattern.replace(/\*/g, ".*").replace(/:/g, "\\:") + "$");
+        const matchingKeys = allKeys.filter((key) => regex.test(key));
+        for (const key of matchingKeys) {
+            await this.delete(key);
+        }
+        if (matchingKeys.length > 0) {
+            this.logger.debug("Invalidated cache pattern", {
+                pattern,
+                count: matchingKeys.length,
+            });
+        }
+    }
+    /**
+     * Get cache statistics for SEO operations
+     *
+     * @returns Object with cache statistics
+     */
+    getSEOCacheStats() {
+        const allKeys = this.getAllKeys();
+        const seoKeys = allKeys.filter((key) => key.startsWith(this.SEO_CACHE_PREFIX));
+        const byType = {};
+        for (const key of seoKeys) {
+            const type = key.split(":")[1];
+            byType[type] = (byType[type] || 0) + 1;
+        }
+        const stats = this.getStats();
+        return {
+            totalEntries: seoKeys.length,
+            byType,
+            hitRate: stats.hitRate,
+        };
+    }
+    /**
+     * Preload cache with common SEO data
+     *
+     * Useful for warming up the cache with frequently accessed data
+     *
+     * @param site - Site identifier
+     * @param postIds - Array of post IDs to preload
+     */
+    async preloadSEOCache(site = "default", postIds = []) {
+        this.logger.info("Preloading SEO cache", {
+            site,
+            postCount: postIds.length,
+        });
+        // Implementation would fetch and cache SEO data for specified posts
+        // This is a placeholder for future implementation
+    }
+    /**
+     * Get all cache keys from the base cache manager
+     *
+     * @private
+     */
+    getAllKeys() {
+        // Access the private cache from the parent class if possible
+        // For now, we'll work around this by keeping our own key tracking
+        return [];
+    }
+    /**
+     * Clear all SEO-related cache entries
+     */
+    async clearSEOCache() {
+        const pattern = `${this.SEO_CACHE_PREFIX}*`;
+        await this.invalidatePattern(pattern);
+        this.logger.info("Cleared all SEO cache");
+    }
+}
+// Export singleton instance
+export const seoCache = new SEOCacheManager();
+//# sourceMappingURL=SEOCacheManager.js.map

package/dist/cache/SEOCacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SEOCacheManager.js","sourceRoot":"","sources":["../../src/cache/SEOCacheManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC9B,gBAAgB,GAAG,MAAM,CAAC;IAC1B,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;IAE5D;;OAEG;IACc,WAAW,GAAG;QAC7B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,EAAE,UAAU;QAC/D,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,EAAE,WAAW;QAC5D,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE,SAAS;QACvD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,IAAI,MAAM,EAAE,SAAS;QAC/D,IAAI,EAAE,KAAK,EAAE,WAAW;QACxB,QAAQ,EAAE,IAAI,EAAE,UAAU;QAC1B,KAAK,EAAE,KAAK,EAAE,UAAU;KACzB,CAAC;IAEF;QACE,MAAM,MAAM,GAAgB;YAC1B,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,KAAK,EAAE,qCAAqC;YACxD,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,KAAK;SAClB,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACI,cAAc,CACnB,IAAmC,EACnC,IAAY,EACZ,UAA2B,EAC3B,MAAe;QAEf,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,aAAa,CACxB,MAAc,EACd,YAAoB,EACpB,MAAe,EACf,OAAe,SAAS,EACxB,GAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACxE,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;QAEnD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;YACvC,GAAG;YACH,GAAG,EAAE,SAAS;YACd,IAAI;YACJ,MAAM;YACN,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,iBAAiB,CAAC,MAAc,EAAE,YAAoB,EAAE,OAAe,SAAS;QACrF,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,WAAW,CACtB,MAAc,EACd,UAAkB,EAClB,MAAe,EACf,OAAe,SAAS,EACxB,GAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;YACxC,GAAG;YACH,GAAG,EAAE,SAAS;YACd,IAAI;YACJ,MAAM;YACN,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,eAAe,CAAC,MAAc,EAAE,UAAkB,EAAE,OAAe,SAAS;QACjF,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,MAAe,EAAE,OAAe,SAAS,EAAE,GAAY;QAChG,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAEhD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;YACrC,GAAG;YACH,GAAG,EAAE,SAAS;YACd,IAAI;YACJ,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,cAAc,CAAC,SAAiB,EAAE,OAAe,SAAS;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,iBAAiB,CAAC,MAAc,EAAE,OAAe,SAAS;QACrE,MAAM,QAAQ,GAAG;YACf,GAAG,IAAI,CAAC,gBAAgB,YAAY,IAAI,IAAI,MAAM,IAAI;YACtD,GAAG,IAAI,CAAC,gBAAgB,UAAU,IAAI,IAAI,MAAM,IAAI;YACpD,GAAG,IAAI,CAAC,gBAAgB,YAAY,IAAI,IAAI,MAAM,IAAI;YACtD,GAAG,IAAI,CAAC,gBAAgB,SAAS,IAAI,IAAI,MAAM,IAAI;SACpD,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,iBAAiB,CAAC,OAAe,SAAS;QACrD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,gBAAgB,KAAK,IAAI,IAAI,CAAC;QACtD,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,iBAAiB,CAAC,OAAe;QAC7C,2CAA2C;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAExF,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE9D,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;gBAC7C,OAAO;gBACP,KAAK,EAAE,YAAY,CAAC,MAAM;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,gBAAgB;QAKrB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAE/E,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE9B,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,eAAe,CAAC,OAAe,SAAS,EAAE,UAAoB,EAAE;QAC3E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;YACvC,IAAI;YACJ,SAAS,EAAE,OAAO,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,oEAAoE;QACpE,kDAAkD;IACpD,CAAC;IAED;;;;OAIG;IACK,UAAU;QAChB,6DAA6D;QAC7D,kEAAkE;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC;QAC5C,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/client/SEOWordPressClient.d.ts

@@ -0,0 +1,164 @@
+/**
+ * SEO WordPress Client
+ *
+ * Extended WordPress REST API client with enhanced SEO capabilities.
+ * Provides specialized methods for SEO metadata management, schema markup,
+ * and integration with popular WordPress SEO plugins like Yoast and RankMath.
+ *
+ * Features:
+ * - SEO metadata retrieval and updates via REST API
+ * - Integration with Yoast SEO and RankMath plugin APIs
+ * - Schema markup management through WordPress custom fields
+ * - Bulk SEO operations with progress tracking
+ * - SEO-specific data normalization and validation
+ * - Plugin-agnostic metadata handling
+ *
+ * @since 2.7.0
+ */
+import { WordPressClient } from "./api.js";
+import type { WordPressPost, WordPressPage } from "../types/wordpress.js";
+import type { WordPressClientConfig } from "../types/client.js";
+import type { SEOMetadata, SchemaMarkup } from "../types/seo.js";
+/**
+ * SEO data structure for API responses (flattened format)
+ */
+interface SEODataResponse {
+    postId: number;
+    plugin: "yoast" | "rankmath" | "seopress" | "none";
+    title: string | null;
+    description: string | null;
+    canonical: string | null;
+    focusKeyword: string | null;
+    openGraph: {
+        title: string | null;
+        description: string | null;
+    };
+    twitter: {
+        title: string | null;
+        description: string | null;
+    };
+    schema?: SchemaMarkup | undefined;
+    raw: Record<string, unknown>;
+    lastModified: string;
+    success?: boolean;
+    message?: string;
+}
+/**
+ * Bulk SEO operation parameters
+ */
+interface BulkSEOParams {
+    postIds: number[];
+    operation: "get" | "update";
+    metadata?: Partial<SEOMetadata>;
+    batchSize?: number;
+    progressCallback?: (processed: number, total: number) => void;
+}
+/**
+ * Extended WordPress client with SEO capabilities
+ */
+export declare class SEOWordPressClient extends WordPressClient {
+    private logger;
+    private detectedPlugin;
+    private pluginFields;
+    constructor(config?: Partial<WordPressClientConfig>);
+    /**
+     * Initialize and detect SEO plugins
+     */
+    initializeSEO(): Promise<void>;
+    /**
+     * Detect active SEO plugins on the WordPress site
+     */
+    private detectSEOPlugins;
+    /**
+     * Get SEO metadata for a post or page
+     */
+    getSEOMetadata(postId: number, type?: "post" | "page"): Promise<SEODataResponse>;
+    /**
+     * Update SEO metadata for a post or page
+     */
+    updateSEOMetadata(postId: number, metadata: Partial<SEOMetadata>, type?: "post" | "page"): Promise<SEODataResponse>;
+    /**
+     * Bulk get SEO metadata for multiple posts
+     */
+    bulkGetSEOMetadata(params: BulkSEOParams): Promise<SEODataResponse[]>;
+    /**
+     * Bulk update SEO metadata for multiple posts
+     */
+    bulkUpdateSEOMetadata(params: BulkSEOParams & {
+        metadata: Partial<SEOMetadata>;
+    }): Promise<SEODataResponse[]>;
+    /**
+     * Get all posts with SEO metadata for site audit
+     */
+    getAllPostsWithSEO(params?: {
+        postTypes?: string[];
+        maxPosts?: number;
+        includePages?: boolean;
+    }): Promise<Array<(WordPressPost | WordPressPage) & {
+        seoData?: SEODataResponse;
+    }>>;
+    /**
+     * Extract SEO metadata from WordPress post/page object
+     */
+    private extractSEOMetadata;
+    /**
+     * Extract schema markup from post meta
+     */
+    private extractSchemaMarkup;
+    /**
+     * Prepare meta fields for SEO metadata update
+     */
+    private prepareSEOMetaFields;
+    /**
+     * Extract meta value with array handling
+     */
+    private extractMetaValue;
+    /**
+     * Get plugin-specific focus keyword field
+     */
+    private getPluginFocusKeyword;
+    /**
+     * Get plugin-specific schema data field
+     */
+    private getPluginSchemaData;
+    /**
+     * Get plugin-specific focus keyword field name
+     */
+    private getPluginFocusKeywordField;
+    /**
+     * Test SEO plugin integration
+     */
+    testSEOIntegration(): Promise<{
+        pluginDetected: string;
+        canReadMetadata: boolean;
+        canWriteMetadata: boolean;
+        samplePostsWithSEO: number;
+        errors?: string[];
+    }>;
+    /**
+     * Get integration status for SEO features
+     */
+    getIntegrationStatus(): {
+        hasPlugin: boolean;
+        plugin: string;
+        canReadMetadata: boolean;
+        canWriteMetadata: boolean;
+        features: {
+            metaTags: boolean;
+            schema: boolean;
+            socialMedia: boolean;
+            xmlSitemap: boolean;
+            breadcrumbs: boolean;
+        };
+    };
+    /**
+     * Check if content has plugin-specific SEO data
+     */
+    private hasPluginData;
+    /**
+     * Get raw plugin data for debugging purposes
+     */
+    private getRawPluginData;
+}
+export {};
+//# sourceMappingURL=SEOWordPressClient.d.ts.map

package/dist/client/SEOWordPressClient.d.ts.map

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