@webnumseoagent/next 0.1.18 → 0.1.20

package/client.ts

@@ -20,13 +20,59 @@ interface SeoFields {
   title?: string;
   description?: string;
   canonical?: string;
-  robots?: { index?: boolean; follow?: boolean };
+  robots?: { index?: boolean; follow?: boolean; noarchive?: boolean; nosnippet?: boolean; noimageindex?: boolean };
   og?: { title?: string; description?: string; image?: string; siteName?: string; locale?: string };
   twitter?: { card?: string; image?: string; site?: string };
   facebook?: { appId?: string; admins?: string }; // fb:app_id / fb:admins (admins — через запятую)
   jsonLd?: unknown[];
   verification?: Record<string, string>; // проверочные мета-теги: metaName → content
   analytics?: { ga4?: string; gtm?: string; metrica?: string }; // счётчики (см. analytics.tsx)
+  // Глобальные шаблоны заголовка/описания (site-wide) + данные для переменных.
+  titleTemplate?: string;
+  descTemplate?: string;
+  titleSep?: string;
+  siteName?: string;
+  baseUrl?: string;
+  orgProfile?: { name?: string };
+}
+
+// Подстановка переменных шаблона (RankMath-стиль). Значения подставляем ЧЕРЕЗ функции — иначе `$`
+// в значении трактовался бы как спецпаттерн String.replace. Незнакомые %...% оставляем как есть.
+function applyTemplate(tpl: string, v: { title: string; sitename: string; sep: string; excerpt: string; orgName: string; orgUrl: string; url: string }): string {
+  const now = new Date();
+  const p2 = (n: number) => String(n).padStart(2, "0");
+  const sep = v.sep || "-";
+  let out = tpl
+    .replace(/%title%/g, () => v.title)
+    .replace(/%sitename%/g, () => v.sitename)
+    .replace(/%sep%/g, () => sep)
+    .replace(/%excerpt%/g, () => v.excerpt)
+    .replace(/%currentyear%/g, () => String(now.getFullYear()))
+    .replace(/%currentmonth%/g, () => p2(now.getMonth() + 1))
+    .replace(/%currentday%/g, () => p2(now.getDate()))
+    .replace(/%currentdate%/g, () => `${p2(now.getDate())}.${p2(now.getMonth() + 1)}.${now.getFullYear()}`)
+    .replace(/%org_name%/g, () => v.orgName)
+    .replace(/%org_url%/g, () => v.orgUrl)
+    .replace(/%url%/g, () => v.url);
+  // Убираем «висячие» разделители у пустых переменных (как RankMath): задвоенные → один, и по краям.
+  const e = sep.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  out = out
+    .replace(new RegExp(`(?:\\s*${e}\\s*){2,}`, "g"), ` ${sep} `)
+    .replace(new RegExp(`^(?:\\s*${e}\\s*)+`), "")
+    .replace(new RegExp(`(?:\\s*${e}\\s*)+$`), "")
+    .replace(/\s{2,}/g, " ")
+    .trim();
+  return out;
+}
+
+// «Сырой» текст из Metadata.title (строка | {absolute|default|template}) для переменной %title%.
+function rawText(t: unknown): string {
+  if (typeof t === "string") return t;
+  if (t && typeof t === "object") {
+    const o = t as { absolute?: string; default?: string };
+    return o.absolute ?? o.default ?? "";
+  }
+  return "";
 }
 
 async function fetchJson<T>(path: string, revalidate = 300): Promise<T | null> {
@@ -44,24 +90,82 @@ async function fetchJson<T>(path: string, revalidate = 300): Promise<T | null> {
   }
 }
 
+// Next допускает robots и строкой ("noindex, nofollow"), и объектом. Чтобы не потерять
+// строковый дефолт сайта при наложении директив, разбираем его в объект (токены точным
+// сравнением — иначе "follow" совпал бы внутри "nofollow"). Незнакомые директивы (max-snippet…)
+// опускаем — они редки, а оверрайд и так намеренный.
+function robotsFromString(s: string): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (const raw of s.split(",")) {
+    switch (raw.trim().toLowerCase()) {
+      case "noindex": out.index = false; break;
+      case "index": out.index = true; break;
+      case "nofollow": out.follow = false; break;
+      case "follow": out.follow = true; break;
+      case "noarchive": out.noarchive = true; break;
+      case "nosnippet": out.nosnippet = true; break;
+      case "noimageindex": out.noimageindex = true; break;
+    }
+  }
+  return out;
+}
+
 // Накладывает удалённый конфиг ПОВЕРХ скомпилированных дефолтов сайта.
-// robots: index флипается в false ТОЛЬКО если удалённо явно index:false; иначе
-// сохраняем дефолт сайта (защита от случайного деиндекса).
-function mergeIntoMetadata(fallback: Metadata, f: SeoFields): Metadata {
+// robots: index/follow меняем ТОЛЬКО при явном булеве (иначе сохраняем дефолт сайта — защита
+// от случайного деиндекса); ограничительные директивы (noarchive/nosnippet/noimageindex)
+// добавляем поверх дефолта сайта только когда явно включены.
+function mergeIntoMetadata(fallback: Metadata, f: SeoFields, route: string): Metadata {
   const m: Metadata = { ...fallback };
-  if (f.title) {
-    // Сохраняем title.template сайта (напр. "%s · Brand"), меняем только default —
-    // иначе строка затрёт шаблон и все дочерние страницы потеряют бренд-суффикс.
+
+  // Переменные для шаблонов — из дефолтов сайта (ДО модификаций): %title% = собственный заголовок
+  // страницы, %excerpt% = собственное описание.
+  const vars = {
+    title: rawText(m.title),
+    sitename: f.siteName ?? "",
+    sep: f.titleSep ?? "-",
+    excerpt: typeof m.description === "string" ? m.description : "",
+    orgName: f.orgProfile?.name ?? "",
+    orgUrl: f.baseUrl ?? "",
+    url: f.baseUrl ? f.baseUrl.replace(/\/+$/, "") + route : route,
+  };
+
+  // Заголовок. Есть глобальный titleTemplate → платформа полностью управляет заголовком:
+  // title.absolute обходит корневой шаблон сайта (чтобы бренд не задвоился), оверрайд страницы
+  // (f.title) тоже раскрывается по переменным. Нет шаблона → прежнее поведение (оверрайд меняет
+  // только default, сохраняя title.template сайта).
+  if (f.titleTemplate) {
+    // Оверрайд страницы — это её «часть заголовка» (поле «SEO-заголовок»), поэтому подставляем его
+    // в %title% шаблона, а не заменяем весь шаблон — иначе бренд-суффикс потерялся бы у таких страниц.
+    const out = applyTemplate(f.titleTemplate, f.title ? { ...vars, title: f.title } : vars);
+    if (out) m.title = { absolute: out };
+  } else if (f.title) {
     if (m.title && typeof m.title === "object" && "template" in (m.title as object)) {
       m.title = { ...(m.title as Record<string, unknown>), default: f.title } as Metadata["title"];
     } else {
       m.title = f.title;
     }
   }
-  if (f.description) m.description = f.description;
+
+  // Описание. Глобальный descTemplate → раскрываем (оверрайд тоже как шаблон); иначе оверрайд как есть.
+  if (f.descTemplate) {
+    const out = applyTemplate(f.descTemplate, f.description ? { ...vars, excerpt: f.description } : vars);
+    if (out) m.description = out;
+  } else if (f.description) {
+    m.description = f.description;
+  }
   if (f.canonical) m.alternates = { ...(m.alternates ?? {}), canonical: f.canonical };
   if (f.robots) {
-    m.robots = { index: f.robots.index !== false, follow: f.robots.follow !== false };
+    const r = f.robots;
+    const base: Record<string, unknown> =
+      typeof m.robots === "string" ? robotsFromString(m.robots)
+      : m.robots && typeof m.robots === "object" ? { ...(m.robots as Record<string, unknown>) }
+      : {};
+    if (typeof r.index === "boolean") base.index = r.index; // false → noindex; true → index; иначе не трогаем
+    if (typeof r.follow === "boolean") base.follow = r.follow;
+    if (r.noarchive) base.noarchive = true;
+    if (r.nosnippet) base.nosnippet = true;
+    if (r.noimageindex) base.noimageindex = true;
+    m.robots = base as Metadata["robots"];
   }
   if (f.og) {
     m.openGraph = {
@@ -110,7 +214,7 @@ export async function seoMeta(opts: {
     `/config?route=${encodeURIComponent(opts.route)}&locale=${encodeURIComponent(opts.locale ?? "")}`,
   );
   if (!data?.fields) return fallback;
-  return mergeIntoMetadata(fallback, data.fields);
+  return mergeIntoMetadata(fallback, data.fields, opts.route ?? "");
 }
 
 // Стилизованная карта: сырой XML с платформы (индекс/urlset со ссылкой на XSL).

package/dist/client.js

@@ -22,6 +22,44 @@ exports.seoAnalytics = seoAnalytics;
 const API = process.env.SEOAGENT_API_BASE ?? "";
 const SITE = process.env.SEOAGENT_SITE_ID ?? "";
 const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
+// Подстановка переменных шаблона (RankMath-стиль). Значения подставляем ЧЕРЕЗ функции — иначе `$`
+// в значении трактовался бы как спецпаттерн String.replace. Незнакомые %...% оставляем как есть.
+function applyTemplate(tpl, v) {
+    const now = new Date();
+    const p2 = (n) => String(n).padStart(2, "0");
+    const sep = v.sep || "-";
+    let out = tpl
+        .replace(/%title%/g, () => v.title)
+        .replace(/%sitename%/g, () => v.sitename)
+        .replace(/%sep%/g, () => sep)
+        .replace(/%excerpt%/g, () => v.excerpt)
+        .replace(/%currentyear%/g, () => String(now.getFullYear()))
+        .replace(/%currentmonth%/g, () => p2(now.getMonth() + 1))
+        .replace(/%currentday%/g, () => p2(now.getDate()))
+        .replace(/%currentdate%/g, () => `${p2(now.getDate())}.${p2(now.getMonth() + 1)}.${now.getFullYear()}`)
+        .replace(/%org_name%/g, () => v.orgName)
+        .replace(/%org_url%/g, () => v.orgUrl)
+        .replace(/%url%/g, () => v.url);
+    // Убираем «висячие» разделители у пустых переменных (как RankMath): задвоенные → один, и по краям.
+    const e = sep.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    out = out
+        .replace(new RegExp(`(?:\\s*${e}\\s*){2,}`, "g"), ` ${sep} `)
+        .replace(new RegExp(`^(?:\\s*${e}\\s*)+`), "")
+        .replace(new RegExp(`(?:\\s*${e}\\s*)+$`), "")
+        .replace(/\s{2,}/g, " ")
+        .trim();
+    return out;
+}
+// «Сырой» текст из Metadata.title (строка | {absolute|default|template}) для переменной %title%.
+function rawText(t) {
+    if (typeof t === "string")
+        return t;
+    if (t && typeof t === "object") {
+        const o = t;
+        return o.absolute ?? o.default ?? "";
+    }
+    return "";
+}
 async function fetchJson(path, revalidate = 300) {
     if (!API || !SITE || !TOKEN)
         return null;
@@ -39,14 +77,68 @@ async function fetchJson(path, revalidate = 300) {
         return null;
     }
 }
+// Next допускает robots и строкой ("noindex, nofollow"), и объектом. Чтобы не потерять
+// строковый дефолт сайта при наложении директив, разбираем его в объект (токены точным
+// сравнением — иначе "follow" совпал бы внутри "nofollow"). Незнакомые директивы (max-snippet…)
+// опускаем — они редки, а оверрайд и так намеренный.
+function robotsFromString(s) {
+    const out = {};
+    for (const raw of s.split(",")) {
+        switch (raw.trim().toLowerCase()) {
+            case "noindex":
+                out.index = false;
+                break;
+            case "index":
+                out.index = true;
+                break;
+            case "nofollow":
+                out.follow = false;
+                break;
+            case "follow":
+                out.follow = true;
+                break;
+            case "noarchive":
+                out.noarchive = true;
+                break;
+            case "nosnippet":
+                out.nosnippet = true;
+                break;
+            case "noimageindex":
+                out.noimageindex = true;
+                break;
+        }
+    }
+    return out;
+}
 // Накладывает удалённый конфиг ПОВЕРХ скомпилированных дефолтов сайта.
-// robots: index флипается в false ТОЛЬКО если удалённо явно index:false; иначе
-// сохраняем дефолт сайта (защита от случайного деиндекса).
-function mergeIntoMetadata(fallback, f) {
+// robots: index/follow меняем ТОЛЬКО при явном булеве (иначе сохраняем дефолт сайта — защита
+// от случайного деиндекса); ограничительные директивы (noarchive/nosnippet/noimageindex)
+// добавляем поверх дефолта сайта только когда явно включены.
+function mergeIntoMetadata(fallback, f, route) {
     const m = { ...fallback };
-    if (f.title) {
-        // Сохраняем title.template сайта (напр. "%s · Brand"), меняем только default —
-        // иначе строка затрёт шаблон и все дочерние страницы потеряют бренд-суффикс.
+    // Переменные для шаблонов — из дефолтов сайта (ДО модификаций): %title% = собственный заголовок
+    // страницы, %excerpt% = собственное описание.
+    const vars = {
+        title: rawText(m.title),
+        sitename: f.siteName ?? "",
+        sep: f.titleSep ?? "-",
+        excerpt: typeof m.description === "string" ? m.description : "",
+        orgName: f.orgProfile?.name ?? "",
+        orgUrl: f.baseUrl ?? "",
+        url: f.baseUrl ? f.baseUrl.replace(/\/+$/, "") + route : route,
+    };
+    // Заголовок. Есть глобальный titleTemplate → платформа полностью управляет заголовком:
+    // title.absolute обходит корневой шаблон сайта (чтобы бренд не задвоился), оверрайд страницы
+    // (f.title) тоже раскрывается по переменным. Нет шаблона → прежнее поведение (оверрайд меняет
+    // только default, сохраняя title.template сайта).
+    if (f.titleTemplate) {
+        // Оверрайд страницы — это её «часть заголовка» (поле «SEO-заголовок»), поэтому подставляем его
+        // в %title% шаблона, а не заменяем весь шаблон — иначе бренд-суффикс потерялся бы у таких страниц.
+        const out = applyTemplate(f.titleTemplate, f.title ? { ...vars, title: f.title } : vars);
+        if (out)
+            m.title = { absolute: out };
+    }
+    else if (f.title) {
         if (m.title && typeof m.title === "object" && "template" in m.title) {
             m.title = { ...m.title, default: f.title };
         }
@@ -54,12 +146,33 @@ function mergeIntoMetadata(fallback, f) {
             m.title = f.title;
         }
     }
-    if (f.description)
+    // Описание. Глобальный descTemplate → раскрываем (оверрайд тоже как шаблон); иначе оверрайд как есть.
+    if (f.descTemplate) {
+        const out = applyTemplate(f.descTemplate, f.description ? { ...vars, excerpt: f.description } : vars);
+        if (out)
+            m.description = out;
+    }
+    else if (f.description) {
         m.description = f.description;
+    }
     if (f.canonical)
         m.alternates = { ...(m.alternates ?? {}), canonical: f.canonical };
     if (f.robots) {
-        m.robots = { index: f.robots.index !== false, follow: f.robots.follow !== false };
+        const r = f.robots;
+        const base = typeof m.robots === "string" ? robotsFromString(m.robots)
+            : m.robots && typeof m.robots === "object" ? { ...m.robots }
+                : {};
+        if (typeof r.index === "boolean")
+            base.index = r.index; // false → noindex; true → index; иначе не трогаем
+        if (typeof r.follow === "boolean")
+            base.follow = r.follow;
+        if (r.noarchive)
+            base.noarchive = true;
+        if (r.nosnippet)
+            base.nosnippet = true;
+        if (r.noimageindex)
+            base.noimageindex = true;
+        m.robots = base;
     }
     if (f.og) {
         m.openGraph = {
@@ -102,7 +215,7 @@ async function seoMeta(opts) {
     const data = await fetchJson(`/config?route=${encodeURIComponent(opts.route)}&locale=${encodeURIComponent(opts.locale ?? "")}`);
     if (!data?.fields)
         return fallback;
-    return mergeIntoMetadata(fallback, data.fields);
+    return mergeIntoMetadata(fallback, data.fields, opts.route ?? "");
 }
 // Стилизованная карта: сырой XML с платформы (индекс/urlset со ссылкой на XSL).
 // app/sitemap.xml/route.ts:  GET() { return new Response(await seoSitemapXml("/sitemap.xml"), {headers:{"content-type":"application/xml"}}) }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",