@webnumseoagent/next 0.1.19 → 0.1.21

package/client.ts

@@ -20,13 +20,63 @@ interface SeoFields {
   title?: string;
   description?: string;
   canonical?: string;
-  robots?: { index?: boolean; follow?: boolean; noarchive?: boolean; nosnippet?: boolean; noimageindex?: boolean };
+  robots?: {
+    index?: boolean; follow?: boolean; noarchive?: boolean; nosnippet?: boolean; noimageindex?: boolean;
+    // Расширенные директивы (RankMath «Advanced Robots»): предел сниппета, превью видео, размер превью картинок.
+    maxSnippet?: number; maxVideoPreview?: number; maxImagePreview?: "none" | "standard" | "large";
+  };
   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> {
@@ -68,18 +118,45 @@ function robotsFromString(s: string): Record<string, unknown> {
 // robots: index/follow меняем ТОЛЬКО при явном булеве (иначе сохраняем дефолт сайта — защита
 // от случайного деиндекса); ограничительные директивы (noarchive/nosnippet/noimageindex)
 // добавляем поверх дефолта сайта только когда явно включены.
-function mergeIntoMetadata(fallback: Metadata, f: SeoFields): Metadata {
+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) {
     const r = f.robots;
@@ -92,6 +169,10 @@ function mergeIntoMetadata(fallback: Metadata, f: SeoFields): Metadata {
     if (r.noarchive) base.noarchive = true;
     if (r.nosnippet) base.nosnippet = true;
     if (r.noimageindex) base.noimageindex = true;
+    // Расширенные директивы — ключи с дефисом, как их ждёт Next (эмитятся в <meta name="robots">).
+    if (typeof r.maxSnippet === "number") base["max-snippet"] = r.maxSnippet;
+    if (typeof r.maxVideoPreview === "number") base["max-video-preview"] = r.maxVideoPreview;
+    if (r.maxImagePreview) base["max-image-preview"] = r.maxImagePreview;
     m.robots = base as Metadata["robots"];
   }
   if (f.og) {
@@ -141,7 +222,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;
@@ -76,11 +114,31 @@ function robotsFromString(s) {
 // robots: index/follow меняем ТОЛЬКО при явном булеве (иначе сохраняем дефолт сайта — защита
 // от случайного деиндекса); ограничительные директивы (noarchive/nosnippet/noimageindex)
 // добавляем поверх дефолта сайта только когда явно включены.
-function mergeIntoMetadata(fallback, f) {
+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 };
         }
@@ -88,8 +146,15 @@ 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) {
@@ -107,6 +172,13 @@ function mergeIntoMetadata(fallback, f) {
             base.nosnippet = true;
         if (r.noimageindex)
             base.noimageindex = true;
+        // Расширенные директивы — ключи с дефисом, как их ждёт Next (эмитятся в <meta name="robots">).
+        if (typeof r.maxSnippet === "number")
+            base["max-snippet"] = r.maxSnippet;
+        if (typeof r.maxVideoPreview === "number")
+            base["max-video-preview"] = r.maxVideoPreview;
+        if (r.maxImagePreview)
+            base["max-image-preview"] = r.maxImagePreview;
         m.robots = base;
     }
     if (f.og) {
@@ -150,7 +222,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.19",
+  "version": "0.1.21",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",