@consilioweb/payload-seo-analyzer 1.14.0 → 1.15.0

package/dist/index.cjs

@@ -7525,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();
@@ -7572,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;
@@ -7669,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 {
@@ -7911,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;
@@ -8077,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(
@@ -8103,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);
@@ -10700,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.js

@@ -7523,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();
@@ -7570,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;
@@ -7667,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 {
@@ -7909,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;
@@ -8075,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(
@@ -8101,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);
@@ -10698,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.14.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",