@consilioweb/payload-seo-analyzer 1.11.0 → 1.12.0

package/dist/index.cjs

@@ -1705,6 +1705,7 @@ async function buildAuditCache(payload, collections, globals, seoConfig) {
           });
           for (const doc of result.docs) {
             if (ignoredSlugs.includes(doc.slug)) continue;
+            if (doc._status === "draft") continue;
             if (allResults.length >= MAX_DOCS2) {
               capped = true;
               break collectionsLoop;
@@ -2680,6 +2681,9 @@ function createRedirectsHandler(redirectsCollection) {
         return Response.json({ error: "Missing id or ids" }, { status: 400 });
       }
       if (method === "PATCH") {
+        if (!isAdmin3(req.user)) {
+          return Response.json({ error: "Admin access required" }, { status: 403 });
+        }
         const patchBody = await parseJsonBody(req);
         const id = typeof patchBody.id === "string" ? patchBody.id.trim() : void 0;
         const from = typeof patchBody.from === "string" ? patchBody.from.trim() : void 0;
@@ -3021,6 +3025,77 @@ function sanitizeSuggestions(s, currentFocusKeyword) {
   const rationale = s.rationale.map((r) => r.trim()).filter(Boolean).slice(0, RATIONALE_MAX_ITEMS).map((r) => r.length > RATIONALE_ITEM_MAX ? `${r.slice(0, RATIONALE_ITEM_MAX - 1)}\u2026` : r);
   return { metaTitle, metaDescription, focusKeyword, rationale };
 }
+async function optimizeDocMeta(payload, opts) {
+  const { collection, id, mergedConfig } = opts;
+  let doc;
+  try {
+    doc = await payload.findByID({ collection, id, depth: 1, overrideAccess: true });
+  } catch {
+    return { ok: false, error: `Document not found: ${collection}/${id}`, status: 404 };
+  }
+  const seoInput = buildSeoInputFromDoc(doc, collection);
+  const analysis = analyzeSeo(seoInput, mergedConfig);
+  const metaGroups = /* @__PURE__ */ new Set(["title", "meta-description", "content", "url", "headings"]);
+  const issues = analysis.checks.filter((c) => (c.status === "fail" || c.status === "warning") && metaGroups.has(c.group)).map((c) => ({ label: c.label, message: c.message })).slice(0, 12);
+  const pageTitle = doc.title || "";
+  const slug = doc.slug || "";
+  const currentFocusKeyword = doc.focusKeyword || "";
+  const currentMetaTitle = seoInput.metaTitle || "";
+  const currentMetaDescription = seoInput.metaDescription || "";
+  const content = extractDocContent(doc).text;
+  const apiKey = opts.apiKey;
+  const model = opts.model || DEFAULT_MODEL;
+  let suggestions;
+  let method;
+  const heuristicFallback = () => ({
+    metaTitle: generateMetaTitle(pageTitle, currentFocusKeyword, slug),
+    metaDescription: generateMetaDescription(content, currentFocusKeyword, slug),
+    focusKeyword: currentFocusKeyword,
+    rationale: []
+  });
+  if (apiKey) {
+    try {
+      const aiResult = await callClaudeOptimize(apiKey, model, {
+        pageTitle,
+        slug,
+        focusKeyword: currentFocusKeyword,
+        currentMetaTitle,
+        currentMetaDescription,
+        issues,
+        content
+      });
+      if (aiResult) {
+        suggestions = aiResult;
+        method = "ai";
+      } else {
+        suggestions = heuristicFallback();
+        method = "heuristic";
+      }
+    } catch (error) {
+      payload.logger.error(`[seo] ai-optimize Claude API error: ${error instanceof Error ? error.message : "unknown"}`);
+      suggestions = heuristicFallback();
+      method = "heuristic";
+    }
+  } else {
+    suggestions = heuristicFallback();
+    method = "heuristic";
+  }
+  const sanitized = sanitizeSuggestions(suggestions, currentFocusKeyword);
+  return {
+    ok: true,
+    title: pageTitle,
+    method,
+    ...method === "ai" ? { model } : {},
+    score: analysis.score,
+    current: {
+      metaTitle: currentMetaTitle,
+      metaDescription: currentMetaDescription,
+      focusKeyword: currentFocusKeyword
+    },
+    suggestions: sanitized,
+    issues
+  };
+}
 function createAiOptimizeHandler(targetCollections, seoConfig, localeMapping) {
   return async (req) => {
     try {
@@ -3036,83 +3111,27 @@ function createAiOptimizeHandler(targetCollections, seoConfig, localeMapping) {
       if (targetCollections && !targetCollections.includes(collection)) {
         return Response.json({ error: "Collection not allowed" }, { status: 403 });
       }
-      let doc;
-      try {
-        const result = await req.payload.findByID({
-          collection,
-          id,
-          depth: 1,
-          overrideAccess: true
-        });
-        doc = result;
-      } catch {
-        return Response.json({ error: `Document not found: ${collection}/${id}` }, { status: 404 });
-      }
       const { config: mergedConfig } = await loadMergedConfig(req.payload, seoConfig, {
         reqLocale: req.locale,
         localeMapping
       });
-      const seoInput = buildSeoInputFromDoc(doc, collection);
-      const analysis = analyzeSeo(seoInput, mergedConfig);
-      const metaGroups = /* @__PURE__ */ new Set(["title", "meta-description", "content", "url", "headings"]);
-      const issues = analysis.checks.filter((c) => (c.status === "fail" || c.status === "warning") && metaGroups.has(c.group)).map((c) => ({ label: c.label, message: c.message })).slice(0, 12);
-      const pageTitle = doc.title || "";
-      const slug = doc.slug || "";
-      const currentFocusKeyword = doc.focusKeyword || "";
-      const currentMetaTitle = seoInput.metaTitle || "";
-      const currentMetaDescription = seoInput.metaDescription || "";
-      const content = extractDocContent(doc).text;
-      const apiKey = process.env.ANTHROPIC_API_KEY;
-      const model = process.env.SEO_AI_MODEL || DEFAULT_MODEL;
-      let suggestions;
-      let method;
-      const heuristicFallback = () => ({
-        metaTitle: generateMetaTitle(pageTitle, currentFocusKeyword, slug),
-        metaDescription: generateMetaDescription(content, currentFocusKeyword, slug),
-        focusKeyword: currentFocusKeyword,
-        rationale: []
+      const r = await optimizeDocMeta(req.payload, {
+        collection,
+        id,
+        mergedConfig,
+        apiKey: process.env.ANTHROPIC_API_KEY,
+        model: process.env.SEO_AI_MODEL
       });
-      if (apiKey) {
-        try {
-          const aiResult = await callClaudeOptimize(apiKey, model, {
-            pageTitle,
-            slug,
-            focusKeyword: currentFocusKeyword,
-            currentMetaTitle,
-            currentMetaDescription,
-            issues,
-            content
-          });
-          if (aiResult) {
-            suggestions = aiResult;
-            method = "ai";
-          } else {
-            suggestions = heuristicFallback();
-            method = "heuristic";
-          }
-        } catch (error) {
-          req.payload.logger.error(
-            `[seo] ai-optimize Claude API error: ${error instanceof Error ? error.message : "unknown"}`
-          );
-          suggestions = heuristicFallback();
-          method = "heuristic";
-        }
-      } else {
-        suggestions = heuristicFallback();
-        method = "heuristic";
+      if (!r.ok) {
+        return Response.json({ error: r.error }, { status: r.status || 500 });
       }
-      const sanitized = sanitizeSuggestions(suggestions, currentFocusKeyword);
       return Response.json({
-        method,
-        ...method === "ai" ? { model } : {},
-        score: analysis.score,
-        current: {
-          metaTitle: currentMetaTitle,
-          metaDescription: currentMetaDescription,
-          focusKeyword: currentFocusKeyword
-        },
-        suggestions: sanitized,
-        issues
+        method: r.method,
+        ...r.method === "ai" ? { model: r.model } : {},
+        score: r.score,
+        current: r.current,
+        suggestions: r.suggestions,
+        issues: r.issues
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -3567,6 +3586,177 @@ function createAiContentBriefHandler(targetCollections, seoConfig) {
   };
 }
 
+// src/endpoints/aiOptimizeBulk.ts
+var TITLE_MAX = 70;
+var DESC_MAX = 160;
+var KEYWORD_MAX2 = 60;
+function isAdmin5(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 createAiOptimizeBulkHandler(targetCollections, seoConfig, localeMapping) {
+  return async (req) => {
+    try {
+      if (!isAdmin5(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      const body = await parseJsonBody(req);
+      const rawIds = Array.isArray(body.ids) ? body.ids.map(String) : [];
+      const defaultCollection = typeof body.collection === "string" ? body.collection : void 0;
+      const apply = body.apply === true;
+      const MAX = 100;
+      const limit = Math.min(MAX, Math.max(1, parseInt(String(body.limit ?? 50), 10) || 50));
+      const corrections = Array.isArray(body.corrections) ? body.corrections : null;
+      if (apply && corrections && corrections.length > 0) {
+        let applied2 = 0;
+        let i2 = 0;
+        const rows = [];
+        for (const c of corrections.slice(0, MAX)) {
+          i2++;
+          const collection = typeof c.collection === "string" ? c.collection : defaultCollection;
+          const id = c.id != null ? String(c.id) : void 0;
+          if (!collection || !id || collection.startsWith("global:")) continue;
+          if (targetCollections && !targetCollections.includes(collection)) continue;
+          const metaTitle = typeof c.metaTitle === "string" ? truncateWords(c.metaTitle.trim(), TITLE_MAX) : "";
+          const metaDescription = typeof c.metaDescription === "string" ? truncateWords(c.metaDescription.trim(), DESC_MAX) : "";
+          const focusKeyword = typeof c.focusKeyword === "string" ? c.focusKeyword.trim().slice(0, KEYWORD_MAX2) : "";
+          const patch = {};
+          if (metaTitle || metaDescription) patch.meta = { title: metaTitle, description: metaDescription };
+          if (focusKeyword) patch.focusKeyword = focusKeyword;
+          try {
+            if (Object.keys(patch).length > 0) {
+              await req.payload.update({ collection, id, data: patch, overrideAccess: true });
+              applied2++;
+              rows.push({ collection, id, applied: true });
+            }
+          } catch (e) {
+            rows.push({ collection, id, applied: false, error: e instanceof Error ? e.message : "error" });
+          }
+          if (i2 % 5 === 0) await new Promise((resolve) => setImmediate(resolve));
+        }
+        return Response.json(
+          { processed: rows.length, applied: applied2, mode: "corrections", results: rows },
+          { headers: { "Cache-Control": "no-store" } }
+        );
+      }
+      if (rawIds.length === 0) {
+        return Response.json({ error: 'Provide a non-empty "ids" array' }, { status: 400 });
+      }
+      const targets = [];
+      for (const raw of rawIds) {
+        let collection;
+        let id;
+        if (raw.includes("::")) {
+          const [c, i2] = raw.split("::");
+          collection = c;
+          id = i2;
+        } else {
+          collection = defaultCollection;
+          id = raw;
+        }
+        if (!collection || !id) continue;
+        if (collection.startsWith("global:")) continue;
+        if (targetCollections && !targetCollections.includes(collection)) continue;
+        targets.push({ collection, id });
+      }
+      const capped = targets.length > limit;
+      const slice = targets.slice(0, limit);
+      const { config: mergedConfig } = await loadMergedConfig(req.payload, seoConfig, {
+        reqLocale: req.locale,
+        localeMapping
+      });
+      const apiKey = process.env.ANTHROPIC_API_KEY;
+      const model = process.env.SEO_AI_MODEL;
+      const results = [];
+      let applied = 0;
+      let i = 0;
+      for (const target of slice) {
+        i++;
+        try {
+          const r = await optimizeDocMeta(req.payload, {
+            collection: target.collection,
+            id: target.id,
+            mergedConfig,
+            apiKey,
+            model
+          });
+          if (!r.ok || !r.current || !r.suggestions) {
+            results.push({
+              collection: target.collection,
+              id: target.id,
+              title: "",
+              before: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+              after: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+              changed: false,
+              applied: false,
+              error: r.error || "optimize_failed"
+            });
+            continue;
+          }
+          const before = r.current;
+          const after = {
+            metaTitle: r.suggestions.metaTitle,
+            metaDescription: r.suggestions.metaDescription,
+            focusKeyword: r.suggestions.focusKeyword
+          };
+          const changed = after.metaTitle !== before.metaTitle || after.metaDescription !== before.metaDescription || after.focusKeyword !== before.focusKeyword;
+          let didApply = false;
+          if (apply && changed) {
+            const patch = {};
+            if (after.metaTitle || after.metaDescription) {
+              patch.meta = { title: after.metaTitle, description: after.metaDescription };
+            }
+            if (after.focusKeyword && after.focusKeyword !== before.focusKeyword) {
+              patch.focusKeyword = after.focusKeyword;
+            }
+            if (Object.keys(patch).length > 0) {
+              await req.payload.update({ collection: target.collection, id: target.id, data: patch, overrideAccess: true });
+              didApply = true;
+              applied++;
+            }
+          }
+          results.push({
+            collection: target.collection,
+            id: target.id,
+            title: r.title || "",
+            before,
+            after,
+            changed,
+            applied: didApply,
+            method: r.method
+          });
+        } catch (e) {
+          results.push({
+            collection: target.collection,
+            id: target.id,
+            title: "",
+            before: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+            after: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+            changed: false,
+            applied: false,
+            error: e instanceof Error ? e.message : "error"
+          });
+        }
+        if (i % 3 === 0) await new Promise((resolve) => setImmediate(resolve));
+      }
+      return Response.json(
+        {
+          processed: results.length,
+          changedCount: results.filter((r) => r.changed).length,
+          applied,
+          capped,
+          results
+        },
+        { headers: { "Cache-Control": "no-store" } }
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] ai-optimize-bulk error: ${message}`);
+      return Response.json({ error: message }, { status: 500 });
+    }
+  };
+}
+
 // src/endpoints/cannibalization.ts
 function canonicalIntent(keyword) {
   return keyword.toLowerCase().normalize("NFD").replace(/\p{Diacritic}/gu, "").replace(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/).filter(Boolean).sort().join(" ");
@@ -4151,7 +4341,7 @@ function getDateThreshold(period) {
       return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1e3);
   }
 }
-function isAdmin5(user) {
+function isAdmin6(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -4256,7 +4446,7 @@ function createPerformanceHandler() {
         });
       }
       if (method === "POST") {
-        if (!isAdmin5(req.user)) {
+        if (!isAdmin6(req.user)) {
           return Response.json({ error: "Admin access required" }, { status: 403 });
         }
         const body = await parseJsonBody(req);
@@ -5970,7 +6160,7 @@ function createAiRewriteHandler(targetCollections) {
 }
 
 // src/endpoints/robots.ts
-function isAdmin6(user) {
+function isAdmin7(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -6019,7 +6209,7 @@ function createRobotsUpdateHandler() {
       if (!req.user) {
         return Response.json({ error: "Unauthorized" }, { status: 401 });
       }
-      if (!isAdmin6(req.user)) {
+      if (!isAdmin7(req.user)) {
         return Response.json({ error: "Admin access required" }, { status: 403 });
       }
       const body = await parseJsonBody(req);
@@ -7249,7 +7439,7 @@ function getClientIp(req) {
 
 // src/endpoints/seoLogs.ts
 var VALID_LOG_TYPES = ["404", "redirect", "error"];
-function isAdmin7(user) {
+function isAdmin8(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -7346,7 +7536,7 @@ function createSeoLogsHandler(seoLogsSecret) {
       return Response.json({ error: "Unauthorized" }, { status: 401 });
     }
     if (method === "DELETE") {
-      if (!isAdmin7(req.user)) {
+      if (!isAdmin8(req.user)) {
         return Response.json({ error: "Admin access required" }, { status: 403 });
       }
       try {
@@ -7523,6 +7713,7 @@ async function doWarmUp(payload, collections = ["pages", "posts"], globals = [])
   }
 }
 function startCacheWarmUp(payload, _basePath, globals = [], collections = ["pages", "posts"]) {
+  stopCacheWarmUp();
   setTimeout(() => {
     void doWarmUp(payload, collections, globals);
   }, STARTUP_DELAY);
@@ -7564,6 +7755,7 @@ async function doSnapshot(payload, basePath, seoConfig) {
   }
 }
 function startRankTracker(payload, basePath, seoConfig) {
+  stopRankTracker();
   setTimeout(() => {
     void doSnapshot(payload, basePath, seoConfig);
   }, STARTUP_DELAY2);
@@ -7586,7 +7778,7 @@ function stopRankTracker() {
 }
 
 // src/endpoints/alerts.ts
-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;
@@ -7752,7 +7944,7 @@ async function deliverAlertDigest(payload, digest, cfg, siteUrl) {
 function createAlertsDigestHandler() {
   return async (req) => {
     try {
-      if (!isAdmin8(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       return Response.json(
@@ -7778,7 +7970,7 @@ function createAlertsDigestHandler() {
 function createAlertsRunHandler(siteUrl) {
   return async (req) => {
     try {
-      if (!isAdmin8(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin9(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);
@@ -7813,6 +8005,7 @@ async function runDigest(payload, siteUrl) {
   }
 }
 function startAlertsScheduler(payload, siteUrl) {
+  stopAlertsScheduler();
   const intervalHours = Math.max(1, parseInt(process.env.SEO_ALERT_INTERVAL_HOURS || "24", 10) || 24);
   const intervalMs = intervalHours * 60 * 60 * 1e3;
   setTimeout(() => {
@@ -8828,8 +9021,15 @@ var fr = {
     markCornerstone: "Marquer pilier",
     unmarkCornerstone: "D\xE9marquer pilier",
     bulkOptimizeMeta: "Optimiser m\xE9ta (IA)",
-    bulkOptimizing: "Optimisation\u2026",
+    bulkOptimizing: "Analyse\u2026",
     bulkConfirm: "Confirmer ?",
+    bulkPreviewTitle: "Corrections m\xE9ta propos\xE9es",
+    bulkApply: "Appliquer",
+    bulkApplying: "Application\u2026",
+    bulkCancel: "Annuler",
+    bulkExport: "Exporter CSV",
+    bulkNoChanges: "Aucune correction n\xE9cessaire sur la s\xE9lection.",
+    bulkCappedNote: "limite atteinte (affine la s\xE9lection)",
     searchPlaceholder: "Rechercher (titre, slug, keyword)...",
     allCollections: "Toutes les collections",
     allScores: "Tous les scores",
@@ -9423,8 +9623,15 @@ var en = {
     markCornerstone: "Mark as cornerstone",
     unmarkCornerstone: "Unmark cornerstone",
     bulkOptimizeMeta: "Optimize meta (AI)",
-    bulkOptimizing: "Optimizing\u2026",
+    bulkOptimizing: "Analyzing\u2026",
     bulkConfirm: "Confirm?",
+    bulkPreviewTitle: "Proposed meta corrections",
+    bulkApply: "Apply",
+    bulkApplying: "Applying\u2026",
+    bulkCancel: "Cancel",
+    bulkExport: "Export CSV",
+    bulkNoChanges: "No corrections needed on the selection.",
+    bulkCappedNote: "limit reached (narrow the selection)",
     searchPlaceholder: "Search (title, slug, keyword)...",
     allCollections: "All collections",
     allScores: "All scores",
@@ -10277,7 +10484,8 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       { path: `${basePath}/ai-optimize`, method: "post", handler: createAiOptimizeHandler(targetCollections, seoConfig) },
       { path: `${basePath}/alt-text-audit`, method: "get", handler: createAltTextAuditHandler(uploadsCollection) },
       { path: `${basePath}/ai-alt-text`, method: "post", handler: withRateLimit(createAiAltTextHandler(uploadsCollection, seoConfig)) },
-      { path: `${basePath}/ai-content-brief`, method: "post", handler: withRateLimit(createAiContentBriefHandler(targetCollections, seoConfig)) }
+      { path: `${basePath}/ai-content-brief`, method: "post", handler: withRateLimit(createAiContentBriefHandler(targetCollections, seoConfig)) },
+      { path: `${basePath}/ai-optimize-bulk`, method: "post", handler: withRateLimit(createAiOptimizeBulkHandler(targetCollections, seoConfig)) }
     );
   }
   if (features.cannibalization) {

package/dist/index.d.cts

@@ -470,6 +470,13 @@ interface DashboardTranslations {
         bulkOptimizeMeta: string;
         bulkOptimizing: string;
         bulkConfirm: string;
+        bulkPreviewTitle: string;
+        bulkApply: string;
+        bulkApplying: string;
+        bulkCancel: string;
+        bulkExport: string;
+        bulkNoChanges: string;
+        bulkCappedNote: string;
         searchPlaceholder: string;
         allCollections: string;
         allScores: string;

package/dist/index.d.ts

@@ -470,6 +470,13 @@ interface DashboardTranslations {
         bulkOptimizeMeta: string;
         bulkOptimizing: string;
         bulkConfirm: string;
+        bulkPreviewTitle: string;
+        bulkApply: string;
+        bulkApplying: string;
+        bulkCancel: string;
+        bulkExport: string;
+        bulkNoChanges: string;
+        bulkCappedNote: string;
         searchPlaceholder: string;
         allCollections: string;
         allScores: string;