@consilioweb/payload-seo-analyzer 1.10.0 → 1.11.0

package/dist/index.cjs

@@ -3443,6 +3443,130 @@ function createAiAltTextHandler(uploadsCollection, seoConfig) {
   };
 }
 
+// src/endpoints/aiContentBrief.ts
+var DEFAULT_MODEL3 = "claude-opus-4-8";
+var trimList = (arr, max, itemMax = 160) => Array.isArray(arr) ? arr.filter((x) => typeof x === "string").map((x) => x.trim()).filter(Boolean).slice(0, max).map((x) => x.length > itemMax ? `${x.slice(0, itemMax - 1)}\u2026` : x) : [];
+function parseBrief(raw) {
+  let s = raw.trim();
+  if (s.startsWith("```")) s = s.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
+  if (!s.startsWith("{")) {
+    const start = s.indexOf("{");
+    const end = s.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start) return null;
+    s = s.slice(start, end + 1);
+  }
+  try {
+    const p = JSON.parse(s);
+    return sanitizeBrief({
+      outline: Array.isArray(p.outline) ? p.outline.map((o) => {
+        const r = o || {};
+        return { level: r.level === "h3" ? "h3" : "h2", text: typeof r.text === "string" ? r.text : "" };
+      }) : [],
+      entities: trimList(p.entities, 30),
+      questions: trimList(p.questions, 15),
+      internalLinkIdeas: trimList(p.internalLinkIdeas, 10),
+      recommendedWordCount: typeof p.recommendedWordCount === "number" ? p.recommendedWordCount : 0,
+      notes: trimList(p.notes, 6)
+    });
+  } catch {
+    return null;
+  }
+}
+function sanitizeBrief(b) {
+  return {
+    outline: b.outline.filter((o) => o.text && o.text.trim()).slice(0, 25).map((o) => ({ level: o.level === "h3" ? "h3" : "h2", text: o.text.trim().slice(0, 160) })),
+    entities: trimList(b.entities, 30),
+    questions: trimList(b.questions, 15),
+    internalLinkIdeas: trimList(b.internalLinkIdeas, 10),
+    recommendedWordCount: Math.min(1e4, Math.max(0, Math.round(b.recommendedWordCount || 0))),
+    notes: trimList(b.notes, 6)
+  };
+}
+async function callClaudeBrief(apiKey, model, language, params) {
+  const systemPrompt = `You are an SEO content strategist applying June 2026 best practices.
+Produce a concise WRITING BRIEF for the target keyword so a writer can create a page that ranks AND is citable by AI engines.
+Rules:
+- Base the brief on genuine search intent for the keyword; cover entities and questions a complete page must address.
+- Be specific and non-generic; no filler. Write in ${language === "en" ? "English" : "French"}.
+- Do not invent facts, brands, prices or statistics.
+Return ONLY a JSON object (no markdown, no prose) with EXACTLY this shape:
+{"outline":[{"level":"h2"|"h3","text":string}],"entities":[string],"questions":[string],"internalLinkIdeas":[string],"recommendedWordCount":number,"notes":[string]}
+- outline: 5-12 headings (logical H2/H3 structure).
+- entities: 8-20 key terms/concepts to mention.
+- questions: 4-10 questions the page should answer (People-Also-Ask style).
+- internalLinkIdeas: 3-8 topics worth linking to internally.
+- notes: up to 4 short strategic tips.`;
+  const userPrompt = `Target keyword: ${params.keyword}
+${params.pageTitle ? `Existing page title: ${params.pageTitle}` : ""}
+${params.existingContent ? `Existing content (first 2000 chars, complement it \u2014 don't repeat):
+${params.existingContent.substring(0, 2e3)}` : ""}
+
+Return the JSON brief now:`;
+  const response = await fetch("https://api.anthropic.com/v1/messages", {
+    method: "POST",
+    headers: { "Content-Type": "application/json", "x-api-key": apiKey, "anthropic-version": "2023-06-01" },
+    body: JSON.stringify({
+      model,
+      max_tokens: 1500,
+      system: systemPrompt,
+      messages: [{ role: "user", content: userPrompt }]
+    })
+  });
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Claude API error ${response.status}: ${body}`);
+  }
+  const data = await response.json();
+  if (data.stop_reason === "refusal") return null;
+  const text = (data.content?.find((b) => b.type === "text")?.text || "").trim();
+  if (!text) return null;
+  return parseBrief(text);
+}
+function createAiContentBriefHandler(targetCollections, seoConfig) {
+  return async (req) => {
+    try {
+      if (!req.user) return Response.json({ error: "Unauthorized" }, { status: 401 });
+      const body = await parseJsonBody(req);
+      const keyword = typeof body.keyword === "string" ? body.keyword.trim() : "";
+      if (!keyword) return Response.json({ error: "Missing required field: keyword" }, { status: 400 });
+      const apiKey = process.env.ANTHROPIC_API_KEY;
+      if (!apiKey) {
+        return Response.json(
+          { error: "AI not configured. Set ANTHROPIC_API_KEY to generate a content brief.", code: "no_api_key" },
+          { status: 400 }
+        );
+      }
+      let pageTitle;
+      let existingContent;
+      const collection = typeof body.collection === "string" ? body.collection : void 0;
+      const id = body.id != null ? String(body.id) : void 0;
+      if (collection && id && (!targetCollections || targetCollections.includes(collection))) {
+        try {
+          const doc = await req.payload.findByID({ collection, id, depth: 1, overrideAccess: true });
+          pageTitle = doc.title || void 0;
+          existingContent = extractDocContent(doc).text || void 0;
+        } catch {
+        }
+      }
+      const model = process.env.SEO_AI_MODEL || DEFAULT_MODEL3;
+      const language = seoConfig?.locale === "en" ? "en" : "fr";
+      let brief;
+      try {
+        brief = await callClaudeBrief(apiKey, model, language, { keyword, pageTitle, existingContent });
+      } catch (e) {
+        req.payload.logger.error(`[seo] ai-content-brief Claude error: ${e instanceof Error ? e.message : "unknown"}`);
+        return Response.json({ error: "Content brief generation failed." }, { status: 502 });
+      }
+      if (!brief) return Response.json({ error: "The model did not return a brief (possibly declined)." }, { status: 502 });
+      return Response.json({ keyword, brief, model });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] ai-content-brief 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(" ");
@@ -5240,24 +5364,46 @@ function buildArticleSchema(doc, siteUrl) {
   }
   return schema;
 }
-function buildLocalBusinessSchema(doc, siteUrl) {
+function buildLocationNode(loc, doc, siteUrl) {
   const meta = doc.meta || {};
-  const schema = {
-    "@context": "https://schema.org",
-    "@type": "LocalBusiness",
-    name: doc.title || meta.title || "",
-    description: meta.description || "",
-    url: `${siteUrl}/${doc.slug || ""}`
+  const node = {
+    "@type": typeof loc.type === "string" && loc.type || "LocalBusiness",
+    name: loc.name || doc.title || meta.title || "",
+    description: loc.description || meta.description || "",
+    url: loc.url || `${siteUrl}/${doc.slug || ""}`
   };
-  if (doc.telephone) schema.telephone = doc.telephone;
-  if (doc.email) schema.email = doc.email;
-  if (doc.address && typeof doc.address === "object") {
-    schema.address = {
-      "@type": "PostalAddress",
-      ...doc.address
+  if (loc.telephone) node.telephone = loc.telephone;
+  if (loc.email) node.email = loc.email;
+  if (loc.priceRange) node.priceRange = loc.priceRange;
+  const address = loc.address;
+  if (address && typeof address === "object") {
+    node.address = { "@type": "PostalAddress", ...address };
+  } else if (typeof address === "string" && address) {
+    node.address = address;
+  }
+  const geo = loc.geo || {};
+  const lat = geo.latitude ?? loc.latitude ?? loc.lat;
+  const lng = geo.longitude ?? loc.longitude ?? loc.lng;
+  if (lat != null && lng != null) {
+    node.geo = { "@type": "GeoCoordinates", latitude: lat, longitude: lng };
+  }
+  if (Array.isArray(loc.openingHours) && loc.openingHours.length > 0) {
+    node.openingHours = loc.openingHours;
+  } else if (typeof loc.openingHours === "string" && loc.openingHours) {
+    node.openingHours = loc.openingHours;
+  }
+  return node;
+}
+function buildLocalBusinessSchema(doc, siteUrl) {
+  const locations = Array.isArray(doc.locations) ? doc.locations.filter((l) => !!l && typeof l === "object") : [];
+  if (locations.length > 1) {
+    return {
+      "@context": "https://schema.org",
+      "@graph": locations.map((loc) => buildLocationNode(loc, doc, siteUrl))
     };
   }
-  return schema;
+  const base = locations.length === 1 ? locations[0] : doc;
+  return { "@context": "https://schema.org", ...buildLocationNode(base, doc, siteUrl) };
 }
 function buildBreadcrumbSchema(doc, siteUrl) {
   const slug = doc.slug || "";
@@ -6008,6 +6154,191 @@ function createSitemapHandler(targetCollections) {
   };
 }
 
+// src/endpoints/sitemapExtensions.ts
+function escapeXml2(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function resolveSiteUrl3(seoConfig) {
+  return (seoConfig?.siteUrl || process.env.NEXT_PUBLIC_SERVER_URL || process.env.PAYLOAD_PUBLIC_SERVER_URL || "").replace(/\/$/, "");
+}
+function docPath(slug) {
+  return slug === "home" || slug === "" ? "" : `/${slug}`;
+}
+function xmlResponse(xml, status = 200) {
+  return new Response(xml, {
+    status,
+    headers: { "Content-Type": "application/xml", "Cache-Control": "public, max-age=3600, s-maxage=3600" }
+  });
+}
+function mediaUrl(media, siteUrl) {
+  if (typeof media.url === "string" && media.url) {
+    return media.url.startsWith("http") ? media.url : `${siteUrl}${media.url}`;
+  }
+  if (typeof media.filename === "string" && media.filename) {
+    return `${siteUrl}/media/${media.filename}`;
+  }
+  return void 0;
+}
+function collectMediaUrls(node, mimePrefix, siteUrl, out, depth = 0) {
+  if (!node || typeof node !== "object" || depth > 8) return;
+  if (Array.isArray(node)) {
+    for (const item of node) collectMediaUrls(item, mimePrefix, siteUrl, out, depth + 1);
+    return;
+  }
+  const obj = node;
+  const mime = typeof obj.mimeType === "string" ? obj.mimeType : "";
+  if (mime.startsWith(mimePrefix)) {
+    const url = mediaUrl(obj, siteUrl);
+    if (url) out.add(url);
+  }
+  for (const key of Object.keys(obj)) {
+    if (key === "sizes" || key === "_status") continue;
+    collectMediaUrls(obj[key], mimePrefix, siteUrl, out, depth + 1);
+  }
+}
+async function eachPublishedDoc(payload, collections, depth, onDoc) {
+  const BATCH = Math.min(100, Math.max(1, parseInt(process.env.SEO_SITEMAP_BATCH_SIZE || "50", 10) || 50));
+  const MAX = Math.max(1, parseInt(process.env.SEO_SITEMAP_MAX_DOCS || "5000", 10) || 5e3);
+  let count = 0;
+  for (const collection of collections) {
+    try {
+      let page = 1;
+      let hasMore = true;
+      while (hasMore) {
+        const res = await payload.find({ collection, limit: BATCH, page, depth, overrideAccess: true });
+        for (const doc of res.docs) {
+          if (doc._status === "draft") continue;
+          if (count >= MAX) return;
+          onDoc(doc, collection);
+          count++;
+        }
+        hasMore = res.hasNextPage;
+        page++;
+        await new Promise((resolve) => setImmediate(resolve));
+      }
+    } catch {
+    }
+  }
+}
+function createNewsSitemapHandler(targetCollections, seoConfig) {
+  return async (req) => {
+    try {
+      const siteUrl = resolveSiteUrl3(seoConfig);
+      const language = seoConfig?.locale === "en" ? "en" : "fr";
+      let publication = seoConfig?.siteName || "";
+      if (!publication && siteUrl) {
+        try {
+          publication = new URL(siteUrl).hostname;
+        } catch {
+        }
+      }
+      const cutoff = Date.now() - 48 * 36e5;
+      const entries = [];
+      await eachPublishedDoc(req.payload, targetCollections, 0, (doc) => {
+        const dateStr = typeof doc.publishedAt === "string" && doc.publishedAt || typeof doc.date === "string" && doc.date || typeof doc.createdAt === "string" && doc.createdAt || "";
+        if (!dateStr) return;
+        const t = new Date(dateStr).getTime();
+        if (isNaN(t) || t < cutoff) return;
+        const title = doc.title || doc.meta?.title || "";
+        if (!title) return;
+        const loc = `${siteUrl}${docPath(doc.slug || "")}`;
+        entries.push(
+          `  <url>
+    <loc>${escapeXml2(loc)}</loc>
+    <news:news>
+      <news:publication>
+        <news:name>${escapeXml2(publication)}</news:name>
+        <news:language>${language}</news:language>
+      </news:publication>
+      <news:publication_date>${new Date(dateStr).toISOString()}</news:publication_date>
+      <news:title>${escapeXml2(title)}</news:title>
+    </news:news>
+  </url>`
+        );
+      });
+      const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9">
+${entries.join("\n")}
+</urlset>`;
+      return xmlResponse(xml);
+    } catch (error) {
+      req.payload.logger.error(`[seo] sitemap-news error: ${error instanceof Error ? error.message : "unknown"}`);
+      return xmlResponse('<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>', 500);
+    }
+  };
+}
+function createImageSitemapHandler(targetCollections, seoConfig) {
+  return async (req) => {
+    try {
+      const siteUrl = resolveSiteUrl3(seoConfig);
+      const entries = [];
+      await eachPublishedDoc(req.payload, targetCollections, 1, (doc) => {
+        const urls = /* @__PURE__ */ new Set();
+        collectMediaUrls(doc, "image/", siteUrl, urls);
+        if (urls.size === 0) return;
+        const loc = `${siteUrl}${docPath(doc.slug || "")}`;
+        const imgs = Array.from(urls).slice(0, 1e3).map((u) => `    <image:image><image:loc>${escapeXml2(u)}</image:loc></image:image>`).join("\n");
+        entries.push(`  <url>
+    <loc>${escapeXml2(loc)}</loc>
+${imgs}
+  </url>`);
+      });
+      const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1">
+${entries.join("\n")}
+</urlset>`;
+      return xmlResponse(xml);
+    } catch (error) {
+      req.payload.logger.error(`[seo] sitemap-images error: ${error instanceof Error ? error.message : "unknown"}`);
+      return xmlResponse('<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>', 500);
+    }
+  };
+}
+function createVideoSitemapHandler(targetCollections, seoConfig) {
+  return async (req) => {
+    try {
+      const siteUrl = resolveSiteUrl3(seoConfig);
+      const entries = [];
+      await eachPublishedDoc(req.payload, targetCollections, 1, (doc) => {
+        const meta = doc.meta || {};
+        const videoUrls = /* @__PURE__ */ new Set();
+        collectMediaUrls(doc, "video/", siteUrl, videoUrls);
+        for (const k of ["videoUrl", "contentUrl", "playerUrl"]) {
+          if (typeof doc[k] === "string" && doc[k]) videoUrls.add(doc[k]);
+        }
+        if (videoUrls.size === 0) return;
+        const title = doc.title || meta.title || "";
+        const description = meta.description || title;
+        const thumbs = /* @__PURE__ */ new Set();
+        collectMediaUrls(meta.image, "image/", siteUrl, thumbs);
+        if (thumbs.size === 0) collectMediaUrls(doc, "image/", siteUrl, thumbs);
+        const thumbnail = Array.from(thumbs)[0] || "";
+        const loc = `${siteUrl}${docPath(doc.slug || "")}`;
+        const videos = Array.from(videoUrls).slice(0, 100).map(
+          (u) => `    <video:video>
+${thumbnail ? `      <video:thumbnail_loc>${escapeXml2(thumbnail)}</video:thumbnail_loc>
+` : ""}      <video:title>${escapeXml2(title || "Video")}</video:title>
+      <video:description>${escapeXml2(description || title || "Video")}</video:description>
+      <video:content_loc>${escapeXml2(u)}</video:content_loc>
+    </video:video>`
+        ).join("\n");
+        entries.push(`  <url>
+    <loc>${escapeXml2(loc)}</loc>
+${videos}
+  </url>`);
+      });
+      const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
+${entries.join("\n")}
+</urlset>`;
+      return xmlResponse(xml);
+    } catch (error) {
+      req.payload.logger.error(`[seo] sitemap-video error: ${error instanceof Error ? error.message : "unknown"}`);
+      return xmlResponse('<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>', 500);
+    }
+  };
+}
+
 // src/collections/SeoScoreHistory.ts
 function createSeoScoreHistoryCollection() {
   return {
@@ -8496,6 +8827,9 @@ var fr = {
     pagesAnalyzed: "pages analys\xE9es",
     markCornerstone: "Marquer pilier",
     unmarkCornerstone: "D\xE9marquer pilier",
+    bulkOptimizeMeta: "Optimiser m\xE9ta (IA)",
+    bulkOptimizing: "Optimisation\u2026",
+    bulkConfirm: "Confirmer ?",
     searchPlaceholder: "Rechercher (titre, slug, keyword)...",
     allCollections: "Toutes les collections",
     allScores: "Tous les scores",
@@ -9088,6 +9422,9 @@ var en = {
     pagesAnalyzed: "pages analyzed",
     markCornerstone: "Mark as cornerstone",
     unmarkCornerstone: "Unmark cornerstone",
+    bulkOptimizeMeta: "Optimize meta (AI)",
+    bulkOptimizing: "Optimizing\u2026",
+    bulkConfirm: "Confirm?",
     searchPlaceholder: "Search (title, slug, keyword)...",
     allCollections: "All collections",
     allScores: "All scores",
@@ -9939,7 +10276,8 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       { path: `${basePath}/ai-rewrite`, method: "post", handler: createAiRewriteHandler(targetCollections) },
       { 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-alt-text`, method: "post", handler: withRateLimit(createAiAltTextHandler(uploadsCollection, seoConfig)) },
+      { path: `${basePath}/ai-content-brief`, method: "post", handler: withRateLimit(createAiContentBriefHandler(targetCollections, seoConfig)) }
     );
   }
   if (features.cannibalization) {
@@ -10031,6 +10369,21 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       path: `${basePath}/sitemap.xml`,
       method: "get",
       handler: createSitemapHandler(targetCollections)
+    },
+    {
+      path: `${basePath}/sitemap-news.xml`,
+      method: "get",
+      handler: createNewsSitemapHandler(targetCollections, seoConfig)
+    },
+    {
+      path: `${basePath}/sitemap-images.xml`,
+      method: "get",
+      handler: createImageSitemapHandler(targetCollections, seoConfig)
+    },
+    {
+      path: `${basePath}/sitemap-video.xml`,
+      method: "get",
+      handler: createVideoSitemapHandler(targetCollections, seoConfig)
     }
   );
   config.endpoints = [
@@ -10135,7 +10488,7 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
 };
 
 // src/helpers/buildMetadata.ts
-function resolveSiteUrl3(explicit) {
+function resolveSiteUrl4(explicit) {
   return (explicit || process.env.NEXT_PUBLIC_SERVER_URL || process.env.PAYLOAD_PUBLIC_SERVER_URL || "").replace(/\/$/, "");
 }
 function parseRobots(doc, meta) {
@@ -10169,7 +10522,7 @@ function absoluteUrl(value, siteUrl) {
   return `${siteUrl}${value.startsWith("/") ? "" : "/"}${value}`;
 }
 function buildSeoMetadata(doc, options = {}) {
-  const siteUrl = resolveSiteUrl3(options.siteUrl);
+  const siteUrl = resolveSiteUrl4(options.siteUrl);
   const meta = doc.meta || {};
   const rawTitle = meta.title || doc.title || "";
   const title = options.titleTemplate && rawTitle ? options.titleTemplate.replace("%s", rawTitle) : rawTitle;

package/dist/index.d.cts

@@ -467,6 +467,9 @@ interface DashboardTranslations {
         pagesAnalyzed: string;
         markCornerstone: string;
         unmarkCornerstone: string;
+        bulkOptimizeMeta: string;
+        bulkOptimizing: string;
+        bulkConfirm: string;
         searchPlaceholder: string;
         allCollections: string;
         allScores: string;

package/dist/index.d.ts

@@ -467,6 +467,9 @@ interface DashboardTranslations {
         pagesAnalyzed: string;
         markCornerstone: string;
         unmarkCornerstone: string;
+        bulkOptimizeMeta: string;
+        bulkOptimizing: string;
+        bulkConfirm: string;
         searchPlaceholder: string;
         allCollections: string;
         allScores: string;