@consilioweb/payload-seo-analyzer 1.13.0 → 1.15.0

package/dist/index.cjs

@@ -1683,9 +1683,9 @@ function analyzeDoc(doc, collection, seoConfig) {
   };
 }
 var CACHE_KEY = "audit";
-var auditBuildInFlight = false;
-async function buildAuditCache(payload, collections, globals, seoConfig) {
-  const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig);
+var auditBuildsInFlight = /* @__PURE__ */ new Set();
+async function buildAuditCache(payload, collections, globals, seoConfig, reqLocale) {
+  const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig, { reqLocale });
   const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "15", 10) || 15));
   const MAX_DOCS2 = Math.max(1, parseInt(process.env.SEO_AUDIT_MAX_DOCS || "1500", 10) || 1500);
   const allResults = [];
@@ -1793,15 +1793,15 @@ async function buildAuditCache(payload, collections, globals, seoConfig) {
   };
   return { enrichedResults, stats, capped };
 }
-function ensureAuditBuild(payload, collections, globals, seoConfig) {
-  if (auditBuildInFlight) return;
-  auditBuildInFlight = true;
-  void buildAuditCache(payload, collections, globals, seoConfig).then((result) => {
-    seoCache.set(CACHE_KEY, result);
+function ensureAuditBuild(payload, collections, globals, seoConfig, cacheKey, reqLocale) {
+  if (auditBuildsInFlight.has(cacheKey)) return;
+  auditBuildsInFlight.add(cacheKey);
+  void buildAuditCache(payload, collections, globals, seoConfig, reqLocale).then((result) => {
+    seoCache.set(cacheKey, result);
   }).catch((e) => {
     payload.logger.error(`[seo] audit build failed: ${e instanceof Error ? e.message : "unknown"}`);
   }).finally(() => {
-    auditBuildInFlight = false;
+    auditBuildsInFlight.delete(cacheKey);
   });
 }
 function createAuditHandler(collections, seoConfig, globals = []) {
@@ -1814,12 +1814,14 @@ function createAuditHandler(collections, seoConfig, globals = []) {
       const page = Math.max(1, parseInt(url.searchParams.get("page") || "1", 10));
       const limit = Math.min(500, Math.max(1, parseInt(url.searchParams.get("limit") || "300", 10)));
       const noCache = url.searchParams.get("nocache") === "1";
-      if (noCache && !auditBuildInFlight) {
-        seoCache.invalidateKey(CACHE_KEY);
+      const reqLocale = typeof req.locale === "string" && req.locale ? req.locale : void 0;
+      const cacheKey = reqLocale ? `${CACHE_KEY}:${reqLocale}` : CACHE_KEY;
+      if (noCache && !auditBuildsInFlight.has(cacheKey)) {
+        seoCache.invalidateKey(cacheKey);
       }
-      const cached = seoCache.get(CACHE_KEY);
+      const cached = seoCache.get(cacheKey);
       if (!cached) {
-        ensureAuditBuild(req.payload, collections, globals, seoConfig);
+        ensureAuditBuild(req.payload, collections, globals, seoConfig, cacheKey, reqLocale);
         return Response.json(
           { building: true, results: [], stats: null },
           { status: 202, headers: { "Cache-Control": "no-store" } }
@@ -7523,6 +7525,77 @@ function createCtrOpportunitiesHandler(basePath, targetCollections, seoConfig) {
   };
 }
 
+// src/endpoints/health.ts
+function isAdmin8(user) {
+  if (!user) return false;
+  if (user.role === "admin") return true;
+  if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
+  return false;
+}
+function createSeoHealthHandler(basePath, seoConfig) {
+  return async (req) => {
+    try {
+      if (!isAdmin8(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      const config = {
+        aiKey: !!process.env.ANTHROPIC_API_KEY,
+        aiModel: process.env.SEO_AI_MODEL || "claude-opus-4-8",
+        pageSpeedKey: !!(process.env.PAGESPEED_API_KEY || process.env.GOOGLE_PAGESPEED_API_KEY),
+        gscConfigured: !!getGscOAuthConfig(basePath, seoConfig),
+        gscEncryptionKey: !!process.env.SEO_GSC_ENCRYPTION_KEY,
+        alertWebhook: !!process.env.SEO_ALERT_WEBHOOK_URL,
+        alertEmail: !!process.env.SEO_ALERT_EMAIL,
+        siteUrl: seoConfig?.siteUrl || process.env.NEXT_PUBLIC_SERVER_URL || null
+      };
+      const cacheStats = seoCache.stats();
+      const auditCached = cacheStats.keys.some((k) => k === "audit" || k.startsWith("audit:"));
+      let gscConnected = false;
+      let gscEmail = null;
+      let lastRankSnapshot = null;
+      try {
+        const authDoc = await getOrCreateGscAuthDoc(req.payload);
+        gscConnected = !!authDoc.refreshTokenEnc;
+        gscEmail = authDoc.connectedEmail || null;
+      } catch {
+      }
+      try {
+        const latest = await req.payload.find({
+          collection: "seo-rank-history",
+          sort: "-snapshotDate",
+          limit: 1,
+          depth: 0,
+          overrideAccess: true
+        });
+        lastRankSnapshot = latest.docs[0]?.snapshotDate || null;
+      } catch {
+      }
+      const warnings = [];
+      if (!config.aiKey) warnings.push("ANTHROPIC_API_KEY not set \u2014 AI features fall back to heuristics.");
+      if (config.gscConfigured && !gscConnected) warnings.push("GSC configured but not connected \u2014 rank tracking & CTR opportunities inactive.");
+      if (config.gscConfigured && !config.gscEncryptionKey) warnings.push("SEO_GSC_ENCRYPTION_KEY not set \u2014 GSC token encrypted with a derived key (set an explicit key for stability).");
+      if ((config.alertWebhook || config.alertEmail) === false) warnings.push("No alert channel configured (SEO_ALERT_WEBHOOK_URL / SEO_ALERT_EMAIL) \u2014 monitoring digest will not be delivered.");
+      return Response.json(
+        {
+          ok: warnings.length === 0,
+          config,
+          runtime: {
+            auditCached,
+            cacheKeys: cacheStats.size,
+            gscConnected,
+            gscEmail,
+            lastRankSnapshot
+          },
+          warnings
+        },
+        { headers: { "Cache-Control": "no-store" } }
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] health error: ${message}`);
+      return Response.json({ error: message }, { status: 500 });
+    }
+  };
+}
+
 // src/rateLimiter.ts
 function createRateLimiter(maxRequests, windowMs) {
   const store = /* @__PURE__ */ new Map();
@@ -7570,7 +7643,7 @@ function getClientIp(req) {
 
 // src/endpoints/seoLogs.ts
 var VALID_LOG_TYPES = ["404", "redirect", "error"];
-function isAdmin8(user) {
+function isAdmin9(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -7667,7 +7740,7 @@ function createSeoLogsHandler(seoLogsSecret) {
       return Response.json({ error: "Unauthorized" }, { status: 401 });
     }
     if (method === "DELETE") {
-      if (!isAdmin8(req.user)) {
+      if (!isAdmin9(req.user)) {
         return Response.json({ error: "Admin access required" }, { status: 403 });
       }
       try {
@@ -7909,7 +7982,7 @@ function stopRankTracker() {
 }
 
 // src/endpoints/alerts.ts
-function isAdmin9(user) {
+function isAdmin10(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -8075,7 +8148,7 @@ async function deliverAlertDigest(payload, digest, cfg, siteUrl) {
 function createAlertsDigestHandler() {
   return async (req) => {
     try {
-      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin10(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       return Response.json(
@@ -8101,7 +8174,7 @@ function createAlertsDigestHandler() {
 function createAlertsRunHandler(siteUrl) {
   return async (req) => {
     try {
-      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin10(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       const delivery = await deliverAlertDigest(req.payload, digest, cfg, siteUrl);
@@ -9154,6 +9227,8 @@ var fr = {
     bulkOptimizeMeta: "Optimiser m\xE9ta (IA)",
     bulkOptimizing: "Analyse\u2026",
     bulkConfirm: "Confirmer ?",
+    optimizeSite: "Optimiser le site",
+    optimizeSiteHint: "Cible automatiquement les pages \xE0 probl\xE8me (m\xE9ta manquante, sans mot-cl\xE9, score faible) \u2192 aper\xE7u \u2192 appliquer",
     bulkPreviewTitle: "Corrections m\xE9ta propos\xE9es",
     bulkApply: "Appliquer",
     bulkApplying: "Application\u2026",
@@ -9756,6 +9831,8 @@ var en = {
     bulkOptimizeMeta: "Optimize meta (AI)",
     bulkOptimizing: "Analyzing\u2026",
     bulkConfirm: "Confirm?",
+    optimizeSite: "Optimize site",
+    optimizeSiteHint: "Auto-targets pages that need work (missing meta, no keyword, low score) \u2192 preview \u2192 apply",
     bulkPreviewTitle: "Proposed meta corrections",
     bulkApply: "Apply",
     bulkApplying: "Applying\u2026",
@@ -10694,6 +10771,11 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       handler: withRateLimit(createDuplicateContentHandler(targetCollections))
     });
   }
+  pluginEndpoints.push({
+    path: `${basePath}/health`,
+    method: "get",
+    handler: createSeoHealthHandler(basePath, seoConfig)
+  });
   pluginEndpoints.push(
     {
       path: `${basePath}/robots.txt`,

package/dist/index.d.cts

@@ -470,6 +470,8 @@ interface DashboardTranslations {
         bulkOptimizeMeta: string;
         bulkOptimizing: string;
         bulkConfirm: string;
+        optimizeSite: string;
+        optimizeSiteHint: string;
         bulkPreviewTitle: string;
         bulkApply: string;
         bulkApplying: string;

package/dist/index.d.ts

@@ -470,6 +470,8 @@ interface DashboardTranslations {
         bulkOptimizeMeta: string;
         bulkOptimizing: string;
         bulkConfirm: string;
+        optimizeSite: string;
+        optimizeSiteHint: string;
         bulkPreviewTitle: string;
         bulkApply: string;
         bulkApplying: string;

package/dist/index.js

@@ -1681,9 +1681,9 @@ function analyzeDoc(doc, collection, seoConfig) {
   };
 }
 var CACHE_KEY = "audit";
-var auditBuildInFlight = false;
-async function buildAuditCache(payload, collections, globals, seoConfig) {
-  const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig);
+var auditBuildsInFlight = /* @__PURE__ */ new Set();
+async function buildAuditCache(payload, collections, globals, seoConfig, reqLocale) {
+  const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig, { reqLocale });
   const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "15", 10) || 15));
   const MAX_DOCS2 = Math.max(1, parseInt(process.env.SEO_AUDIT_MAX_DOCS || "1500", 10) || 1500);
   const allResults = [];
@@ -1791,15 +1791,15 @@ async function buildAuditCache(payload, collections, globals, seoConfig) {
   };
   return { enrichedResults, stats, capped };
 }
-function ensureAuditBuild(payload, collections, globals, seoConfig) {
-  if (auditBuildInFlight) return;
-  auditBuildInFlight = true;
-  void buildAuditCache(payload, collections, globals, seoConfig).then((result) => {
-    seoCache.set(CACHE_KEY, result);
+function ensureAuditBuild(payload, collections, globals, seoConfig, cacheKey, reqLocale) {
+  if (auditBuildsInFlight.has(cacheKey)) return;
+  auditBuildsInFlight.add(cacheKey);
+  void buildAuditCache(payload, collections, globals, seoConfig, reqLocale).then((result) => {
+    seoCache.set(cacheKey, result);
   }).catch((e) => {
     payload.logger.error(`[seo] audit build failed: ${e instanceof Error ? e.message : "unknown"}`);
   }).finally(() => {
-    auditBuildInFlight = false;
+    auditBuildsInFlight.delete(cacheKey);
   });
 }
 function createAuditHandler(collections, seoConfig, globals = []) {
@@ -1812,12 +1812,14 @@ function createAuditHandler(collections, seoConfig, globals = []) {
       const page = Math.max(1, parseInt(url.searchParams.get("page") || "1", 10));
       const limit = Math.min(500, Math.max(1, parseInt(url.searchParams.get("limit") || "300", 10)));
       const noCache = url.searchParams.get("nocache") === "1";
-      if (noCache && !auditBuildInFlight) {
-        seoCache.invalidateKey(CACHE_KEY);
+      const reqLocale = typeof req.locale === "string" && req.locale ? req.locale : void 0;
+      const cacheKey = reqLocale ? `${CACHE_KEY}:${reqLocale}` : CACHE_KEY;
+      if (noCache && !auditBuildsInFlight.has(cacheKey)) {
+        seoCache.invalidateKey(cacheKey);
       }
-      const cached = seoCache.get(CACHE_KEY);
+      const cached = seoCache.get(cacheKey);
       if (!cached) {
-        ensureAuditBuild(req.payload, collections, globals, seoConfig);
+        ensureAuditBuild(req.payload, collections, globals, seoConfig, cacheKey, reqLocale);
         return Response.json(
           { building: true, results: [], stats: null },
           { status: 202, headers: { "Cache-Control": "no-store" } }
@@ -7521,6 +7523,77 @@ function createCtrOpportunitiesHandler(basePath, targetCollections, seoConfig) {
   };
 }
 
+// src/endpoints/health.ts
+function isAdmin8(user) {
+  if (!user) return false;
+  if (user.role === "admin") return true;
+  if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
+  return false;
+}
+function createSeoHealthHandler(basePath, seoConfig) {
+  return async (req) => {
+    try {
+      if (!isAdmin8(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      const config = {
+        aiKey: !!process.env.ANTHROPIC_API_KEY,
+        aiModel: process.env.SEO_AI_MODEL || "claude-opus-4-8",
+        pageSpeedKey: !!(process.env.PAGESPEED_API_KEY || process.env.GOOGLE_PAGESPEED_API_KEY),
+        gscConfigured: !!getGscOAuthConfig(basePath, seoConfig),
+        gscEncryptionKey: !!process.env.SEO_GSC_ENCRYPTION_KEY,
+        alertWebhook: !!process.env.SEO_ALERT_WEBHOOK_URL,
+        alertEmail: !!process.env.SEO_ALERT_EMAIL,
+        siteUrl: seoConfig?.siteUrl || process.env.NEXT_PUBLIC_SERVER_URL || null
+      };
+      const cacheStats = seoCache.stats();
+      const auditCached = cacheStats.keys.some((k) => k === "audit" || k.startsWith("audit:"));
+      let gscConnected = false;
+      let gscEmail = null;
+      let lastRankSnapshot = null;
+      try {
+        const authDoc = await getOrCreateGscAuthDoc(req.payload);
+        gscConnected = !!authDoc.refreshTokenEnc;
+        gscEmail = authDoc.connectedEmail || null;
+      } catch {
+      }
+      try {
+        const latest = await req.payload.find({
+          collection: "seo-rank-history",
+          sort: "-snapshotDate",
+          limit: 1,
+          depth: 0,
+          overrideAccess: true
+        });
+        lastRankSnapshot = latest.docs[0]?.snapshotDate || null;
+      } catch {
+      }
+      const warnings = [];
+      if (!config.aiKey) warnings.push("ANTHROPIC_API_KEY not set \u2014 AI features fall back to heuristics.");
+      if (config.gscConfigured && !gscConnected) warnings.push("GSC configured but not connected \u2014 rank tracking & CTR opportunities inactive.");
+      if (config.gscConfigured && !config.gscEncryptionKey) warnings.push("SEO_GSC_ENCRYPTION_KEY not set \u2014 GSC token encrypted with a derived key (set an explicit key for stability).");
+      if ((config.alertWebhook || config.alertEmail) === false) warnings.push("No alert channel configured (SEO_ALERT_WEBHOOK_URL / SEO_ALERT_EMAIL) \u2014 monitoring digest will not be delivered.");
+      return Response.json(
+        {
+          ok: warnings.length === 0,
+          config,
+          runtime: {
+            auditCached,
+            cacheKeys: cacheStats.size,
+            gscConnected,
+            gscEmail,
+            lastRankSnapshot
+          },
+          warnings
+        },
+        { headers: { "Cache-Control": "no-store" } }
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] health error: ${message}`);
+      return Response.json({ error: message }, { status: 500 });
+    }
+  };
+}
+
 // src/rateLimiter.ts
 function createRateLimiter(maxRequests, windowMs) {
   const store = /* @__PURE__ */ new Map();
@@ -7568,7 +7641,7 @@ function getClientIp(req) {
 
 // src/endpoints/seoLogs.ts
 var VALID_LOG_TYPES = ["404", "redirect", "error"];
-function isAdmin8(user) {
+function isAdmin9(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -7665,7 +7738,7 @@ function createSeoLogsHandler(seoLogsSecret) {
       return Response.json({ error: "Unauthorized" }, { status: 401 });
     }
     if (method === "DELETE") {
-      if (!isAdmin8(req.user)) {
+      if (!isAdmin9(req.user)) {
         return Response.json({ error: "Admin access required" }, { status: 403 });
       }
       try {
@@ -7907,7 +7980,7 @@ function stopRankTracker() {
 }
 
 // src/endpoints/alerts.ts
-function isAdmin9(user) {
+function isAdmin10(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -8073,7 +8146,7 @@ async function deliverAlertDigest(payload, digest, cfg, siteUrl) {
 function createAlertsDigestHandler() {
   return async (req) => {
     try {
-      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin10(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       return Response.json(
@@ -8099,7 +8172,7 @@ function createAlertsDigestHandler() {
 function createAlertsRunHandler(siteUrl) {
   return async (req) => {
     try {
-      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin10(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       const delivery = await deliverAlertDigest(req.payload, digest, cfg, siteUrl);
@@ -9152,6 +9225,8 @@ var fr = {
     bulkOptimizeMeta: "Optimiser m\xE9ta (IA)",
     bulkOptimizing: "Analyse\u2026",
     bulkConfirm: "Confirmer ?",
+    optimizeSite: "Optimiser le site",
+    optimizeSiteHint: "Cible automatiquement les pages \xE0 probl\xE8me (m\xE9ta manquante, sans mot-cl\xE9, score faible) \u2192 aper\xE7u \u2192 appliquer",
     bulkPreviewTitle: "Corrections m\xE9ta propos\xE9es",
     bulkApply: "Appliquer",
     bulkApplying: "Application\u2026",
@@ -9754,6 +9829,8 @@ var en = {
     bulkOptimizeMeta: "Optimize meta (AI)",
     bulkOptimizing: "Analyzing\u2026",
     bulkConfirm: "Confirm?",
+    optimizeSite: "Optimize site",
+    optimizeSiteHint: "Auto-targets pages that need work (missing meta, no keyword, low score) \u2192 preview \u2192 apply",
     bulkPreviewTitle: "Proposed meta corrections",
     bulkApply: "Apply",
     bulkApplying: "Applying\u2026",
@@ -10692,6 +10769,11 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       handler: withRateLimit(createDuplicateContentHandler(targetCollections))
     });
   }
+  pluginEndpoints.push({
+    path: `${basePath}/health`,
+    method: "get",
+    handler: createSeoHealthHandler(basePath, seoConfig)
+  });
   pluginEndpoints.push(
     {
       path: `${basePath}/robots.txt`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@consilioweb/payload-seo-analyzer",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Payload CMS SEO plugin — 50+ checks, dashboard, Lexical JSON support, Flesch FR/EN readability, i18n",
   "type": "module",
   "main": "./dist/index.cjs",