@webnumseoagent/next 0.1.6 → 0.1.7

package/bin/cli.mjs

@@ -96,7 +96,7 @@ async function init() {
     ok("Пакет @webnumseoagent/next установлен — импорт из пакета.");
   } else {
     const vendor = path.join(root, "seoagent");
-    for (const f of ["client.ts", "jsonld.tsx"]) {
+    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts"]) {
       const dest = path.join(vendor, f);
       if (!(await exists(dest))) {
         await fs.mkdir(vendor, { recursive: true });
@@ -109,6 +109,10 @@ async function init() {
     importJsonld = `${imp}/jsonld`;
   }
 
+  // Импорт клиента/jsonld для файла на нужной глубине (в vendor-режиме путь относительный).
+  const clientFor = (file) => (pkgMode ? "@webnumseoagent/next" : `${importPath(appDir, file)}/client`);
+  const jsonldFor = (file) => (pkgMode ? "@webnumseoagent/next/jsonld" : `${importPath(appDir, file)}/jsonld`);
+
   // Не создаём sitemap/robots, если у сайта они УЖЕ есть (public/, отдельный роут и т.п.) —
   // чтобы не перекрыть существующую карту сайта пустой.
   const anyExists = async (paths) => {
@@ -122,11 +126,24 @@ async function init() {
     `${appDir}/sitemap.ts`, `${appDir}/sitemap.js`, `${appDir}/sitemap.xml`,
     `${appDir}/sitemap.xml/route.ts`, `${appDir}/sitemap.xml/route.js`,
   ]);
+  // Стилизованная карта: индекс + под-карты по разделам + XSL-таблица стилей
+  // (человекочитаемый вид в браузере, как у RankMath). Всё собирает платформа.
   if (hasSitemap) skip("sitemap (у сайта уже есть — не трогаем)");
-  else await ensureFile(
-    path.join(root, appDir, `sitemap.${ext}`),
-    `import { seoSitemap } from "${importClient}";\nexport const revalidate = 300;\nexport default async function sitemap() {\n  return seoSitemap();\n}\n`,
-  );
+  else {
+    const tt = ext === "ts";
+    await ensureFile(
+      path.join(root, appDir, `sitemap.xml/route.${ext}`),
+      `import { seoSitemapXml } from "${clientFor("sitemap.xml/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoSitemapXml("/sitemap.xml"), { headers: { "content-type": "application/xml; charset=utf-8", "x-seoagent-sitemap": "1" } });\n}\n`,
+    );
+    await ensureFile(
+      path.join(root, appDir, `sitemap/[name]/route.${ext}`),
+      `import { seoSitemapXml } from "${clientFor("sitemap/[name]/route.ts")}";\nexport const revalidate = 300;\nexport async function GET(${tt ? "_req: Request, { params }: { params: { name: string } }" : "_req, { params }"}) {\n  return new Response(await seoSitemapXml("/sitemap/" + params.name), { headers: { "content-type": "application/xml; charset=utf-8", "x-seoagent-sitemap": "1" } });\n}\n`,
+    );
+    await ensureFile(
+      path.join(root, appDir, `sitemap.xsl/route.${ext}`),
+      `import { SITEMAP_XSL } from "${clientFor("sitemap.xsl/route.ts")}";\nexport function GET() {\n  return new Response(SITEMAP_XSL, { headers: { "content-type": "text/xsl; charset=utf-8" } });\n}\n`,
+    );
+  }
 
   // 3. robots.txt (вариант B — byte-exact: отдаём сырой текст с платформы как есть).
   // Если у сайта уже есть свой robots — НЕ трогаем (его можно передать платформе позже).
@@ -138,7 +155,7 @@ async function init() {
   if (hasRobots) skip("robots (у сайта уже есть — не трогаем)");
   else await ensureFile(
     path.join(root, appDir, `robots.txt/route.${ext}`),
-    `import { seoRobotsTxt } from "${importClient}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoRobotsTxt(), { headers: { "content-type": "text/plain; charset=utf-8", "x-seoagent-robots": "1" } });\n}\n`,
+    `import { seoRobotsTxt } from "${clientFor("robots.txt/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoRobotsTxt(), { headers: { "content-type": "text/plain; charset=utf-8", "x-seoagent-robots": "1" } });\n}\n`,
   );
 
   // 4. revalidate-роут (мгновенное применение правок с платформы)
@@ -174,7 +191,7 @@ async function init() {
       const rel = path.relative(path.join(root, appDir), p);
       const { expr } = routeFromFile(rel);
       const code = await fs.readFile(p, "utf8");
-      const r = await wrapFile(code, expr, importClient);
+      const r = await wrapFile(code, expr, clientFor(rel));
       if (r.ok) { await fs.writeFile(p, r.code); ok(`${path.relative(root, p)} → обёрнут (route: ${expr})`); wrapped++; }
       else { manual.push({ p, expr, reason: r.reason }); skip(`${path.relative(root, p)} → вручную (${r.reason})`); }
     }
@@ -183,7 +200,7 @@ async function init() {
       log("\n  Осталось вручную (замени `return { … }` на):");
       for (const m of manual) {
         log(`    • ${path.relative(root, m.p)}`);
-        log(`      \x1b[36mimport { seoMeta } from "${importClient}";\n      return seoMeta({ route: ${m.expr}, locale, fallback: { /* прежний объект */ } });\x1b[0m`);
+        log(`      \x1b[36mimport { seoMeta } from "${clientFor(path.relative(path.join(root, appDir), m.p))}";\n      return seoMeta({ route: ${m.expr}, locale, fallback: { /* прежний объект */ } });\x1b[0m`);
       }
     }
 
@@ -193,7 +210,7 @@ async function init() {
       const layouts = await findLayouts(path.join(root, appDir));
       for (const lp of layouts) {
         const code = await fs.readFile(lp, "utf8");
-        const r = await mountJsonLd(code, importJsonld);
+        const r = await mountJsonLd(code, jsonldFor(path.relative(path.join(root, appDir), lp)));
         if (r.ok) { await fs.writeFile(lp, r.code); ok(`${path.relative(root, lp)} → смонтирован <SeoJsonLd/>`); jsonLdMounted = true; }
         else if (r.reason === "already" || r.reason === "existing-jsonld") jsonLdMounted = true;
       }

package/client.ts

@@ -92,6 +92,27 @@ export async function seoMeta(opts: {
   return mergeIntoMetadata(fallback, data.fields);
 }
 
+// Стилизованная карта: сырой XML с платформы (индекс/urlset со ссылкой на XSL).
+// app/sitemap.xml/route.ts:  GET() { return new Response(await seoSitemapXml("/sitemap.xml"), {headers:{"content-type":"application/xml"}}) }
+// app/sitemap/[name]/route.ts: GET(_, {params}) { return new Response(await seoSitemapXml("/sitemap/" + params.name), ...) }
+export async function seoSitemapXml(path: string): Promise<string> {
+  const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>\n`;
+  if (!API || !SITE || !TOKEN) return FALLBACK;
+  try {
+    const r = await fetch(`${API}/api/seo/${SITE}${path}`, {
+      headers: { "x-seo-agent-key": TOKEN },
+      next: { revalidate: 300, tags: [`seo-${SITE}`] },
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!r.ok) return FALLBACK;
+    return await r.text();
+  } catch {
+    return FALLBACK;
+  }
+}
+
+export { SITEMAP_XSL } from "./sitemap-xsl";
+
 // app/sitemap.ts:  export default async function sitemap() { return seoSitemap() }
 export async function seoSitemap(): Promise<MetadataRoute.Sitemap> {
   const data = await fetchJson<{ entries: { url: string; alternates: Record<string, string>; lastModified?: string }[] }>(

package/dist/client.d.ts

@@ -4,6 +4,8 @@ export declare function seoMeta(opts: {
     locale?: string;
     fallback?: Metadata;
 }): Promise<Metadata>;
+export declare function seoSitemapXml(path: string): Promise<string>;
+export { SITEMAP_XSL } from "./sitemap-xsl";
 export declare function seoSitemap(): Promise<MetadataRoute.Sitemap>;
 export declare function seoRobots(): Promise<MetadataRoute.Robots>;
 export declare function seoRobotsTxt(): Promise<string>;

package/dist/client.js

@@ -11,7 +11,9 @@
 // Все хелперы FAIL-SAFE: при ошибке/таймауте возвращают переданный fallback
 // (скомпилированные дефолты сайта) — сборка/рендер НИКОГДА не падает и НЕ уходит в noindex.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITEMAP_XSL = void 0;
 exports.seoMeta = seoMeta;
+exports.seoSitemapXml = seoSitemapXml;
 exports.seoSitemap = seoSitemap;
 exports.seoRobots = seoRobots;
 exports.seoRobotsTxt = seoRobotsTxt;
@@ -83,6 +85,29 @@ async function seoMeta(opts) {
         return fallback;
     return mergeIntoMetadata(fallback, data.fields);
 }
+// Стилизованная карта: сырой XML с платформы (индекс/urlset со ссылкой на XSL).
+// app/sitemap.xml/route.ts:  GET() { return new Response(await seoSitemapXml("/sitemap.xml"), {headers:{"content-type":"application/xml"}}) }
+// app/sitemap/[name]/route.ts: GET(_, {params}) { return new Response(await seoSitemapXml("/sitemap/" + params.name), ...) }
+async function seoSitemapXml(path) {
+    const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>\n`;
+    if (!API || !SITE || !TOKEN)
+        return FALLBACK;
+    try {
+        const r = await fetch(`${API}/api/seo/${SITE}${path}`, {
+            headers: { "x-seo-agent-key": TOKEN },
+            next: { revalidate: 300, tags: [`seo-${SITE}`] },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!r.ok)
+            return FALLBACK;
+        return await r.text();
+    }
+    catch {
+        return FALLBACK;
+    }
+}
+var sitemap_xsl_1 = require("./sitemap-xsl");
+Object.defineProperty(exports, "SITEMAP_XSL", { enumerable: true, get: function () { return sitemap_xsl_1.SITEMAP_XSL; } });
 // app/sitemap.ts:  export default async function sitemap() { return seoSitemap() }
 async function seoSitemap() {
     const data = await fetchJson("/sitemap");

package/dist/sitemap-xsl.d.ts

@@ -0,0 +1 @@
+export declare const SITEMAP_XSL = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<xsl:stylesheet version=\"1.0\"\n  xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"\n  xmlns:s=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n<xsl:output method=\"html\" encoding=\"UTF-8\" indent=\"yes\"/>\n<xsl:template match=\"/\">\n<html lang=\"ru\">\n<head>\n<meta charset=\"UTF-8\"/>\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"/>\n<title>XML-\u043A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430</title>\n<style>\n  *{box-sizing:border-box}\n  body{font-family:-apple-system,system-ui,'Segoe UI',Roboto,sans-serif;color:#1e293b;margin:0;background:#f8fafc}\n  .head{background:#2563eb;color:#fff;padding:28px 40px}\n  .head h1{margin:0 0 8px;font-size:26px;font-weight:600}\n  .head p{margin:0;font-size:14px;opacity:.92;max-width:920px;line-height:1.55}\n  .head a{color:#fff}\n  .wrap{padding:24px 40px}\n  .count{color:#475569;font-size:14px;margin:0 0 14px}\n  table{width:100%;border-collapse:collapse;background:#fff;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden}\n  th{background:#eff2f7;color:#334155;text-align:left;font-size:12px;text-transform:uppercase;letter-spacing:.03em;padding:12px 16px}\n  td{padding:11px 16px;font-size:14px;border-top:1px solid #f1f5f9}\n  tr:hover td{background:#f8fafc}\n  td a{color:#2563eb;text-decoration:none;word-break:break-all}\n  td a:hover{text-decoration:underline}\n  .n{width:80px;color:#64748b;text-align:right}\n</style>\n</head>\n<body>\n<div class=\"head\">\n  <h1>XML-\u043A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430</h1>\n  <p>\u0421\u043F\u0438\u0441\u043E\u043A \u0441\u0442\u0440\u0430\u043D\u0438\u0446 \u0434\u043B\u044F \u043F\u043E\u0438\u0441\u043A\u043E\u0432\u044B\u0445 \u0441\u0438\u0441\u0442\u0435\u043C. \u0421\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u043E \u043F\u043B\u0430\u0442\u0444\u043E\u0440\u043C\u043E\u0439 <b>SEO Agent</b>. \u041F\u043E\u0434\u0440\u043E\u0431\u043D\u0435\u0435 \u043E\u0431 <a href=\"https://www.sitemaps.org/\">XML-\u043A\u0430\u0440\u0442\u0430\u0445 \u0441\u0430\u0439\u0442\u0430</a>.</p>\n</div>\n<div class=\"wrap\">\n<xsl:choose>\n  <xsl:when test=\"s:sitemapindex\">\n    <p class=\"count\">\u0418\u043D\u0434\u0435\u043A\u0441\u043D\u044B\u0439 \u0444\u0430\u0439\u043B \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u0442 <b><xsl:value-of select=\"count(s:sitemapindex/s:sitemap)\"/></b> \u043A\u0430\u0440\u0442(\u044B) \u0441\u0430\u0439\u0442\u0430.</p>\n    <table>\n      <tr><th>\u041A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430</th></tr>\n      <xsl:for-each select=\"s:sitemapindex/s:sitemap\">\n        <tr><td><a href=\"{s:loc}\"><xsl:value-of select=\"s:loc\"/></a></td></tr>\n      </xsl:for-each>\n    </table>\n  </xsl:when>\n  <xsl:otherwise>\n    <p class=\"count\">\u042D\u0442\u0430 \u043A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430 \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u0442 <b><xsl:value-of select=\"count(s:urlset/s:url)\"/></b> URL.</p>\n    <table>\n      <tr><th class=\"n\">#</th><th>URL</th></tr>\n      <xsl:for-each select=\"s:urlset/s:url\">\n        <tr>\n          <td class=\"n\"><xsl:value-of select=\"position()\"/></td>\n          <td><a href=\"{s:loc}\"><xsl:value-of select=\"s:loc\"/></a></td>\n        </tr>\n      </xsl:for-each>\n    </table>\n  </xsl:otherwise>\n</xsl:choose>\n</div>\n</body>\n</html>\n</xsl:template>\n</xsl:stylesheet>\n";

package/dist/sitemap-xsl.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITEMAP_XSL = void 0;
+// XSL-таблица стилей для человекочитаемого вида XML-карты в браузере (как у RankMath).
+// Отдаётся адаптером на домене сайта по /sitemap.xsl; сам XML на неё ссылается.
+exports.SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:s="http://www.sitemaps.org/schemas/sitemap/0.9">
+<xsl:output method="html" encoding="UTF-8" indent="yes"/>
+<xsl:template match="/">
+<html lang="ru">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>XML-карта сайта</title>
+<style>
+  *{box-sizing:border-box}
+  body{font-family:-apple-system,system-ui,'Segoe UI',Roboto,sans-serif;color:#1e293b;margin:0;background:#f8fafc}
+  .head{background:#2563eb;color:#fff;padding:28px 40px}
+  .head h1{margin:0 0 8px;font-size:26px;font-weight:600}
+  .head p{margin:0;font-size:14px;opacity:.92;max-width:920px;line-height:1.55}
+  .head a{color:#fff}
+  .wrap{padding:24px 40px}
+  .count{color:#475569;font-size:14px;margin:0 0 14px}
+  table{width:100%;border-collapse:collapse;background:#fff;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden}
+  th{background:#eff2f7;color:#334155;text-align:left;font-size:12px;text-transform:uppercase;letter-spacing:.03em;padding:12px 16px}
+  td{padding:11px 16px;font-size:14px;border-top:1px solid #f1f5f9}
+  tr:hover td{background:#f8fafc}
+  td a{color:#2563eb;text-decoration:none;word-break:break-all}
+  td a:hover{text-decoration:underline}
+  .n{width:80px;color:#64748b;text-align:right}
+</style>
+</head>
+<body>
+<div class="head">
+  <h1>XML-карта сайта</h1>
+  <p>Список страниц для поисковых систем. Сгенерировано платформой <b>SEO Agent</b>. Подробнее об <a href="https://www.sitemaps.org/">XML-картах сайта</a>.</p>
+</div>
+<div class="wrap">
+<xsl:choose>
+  <xsl:when test="s:sitemapindex">
+    <p class="count">Индексный файл содержит <b><xsl:value-of select="count(s:sitemapindex/s:sitemap)"/></b> карт(ы) сайта.</p>
+    <table>
+      <tr><th>Карта сайта</th></tr>
+      <xsl:for-each select="s:sitemapindex/s:sitemap">
+        <tr><td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td></tr>
+      </xsl:for-each>
+    </table>
+  </xsl:when>
+  <xsl:otherwise>
+    <p class="count">Эта карта сайта содержит <b><xsl:value-of select="count(s:urlset/s:url)"/></b> URL.</p>
+    <table>
+      <tr><th class="n">#</th><th>URL</th></tr>
+      <xsl:for-each select="s:urlset/s:url">
+        <tr>
+          <td class="n"><xsl:value-of select="position()"/></td>
+          <td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td>
+        </tr>
+      </xsl:for-each>
+    </table>
+  </xsl:otherwise>
+</xsl:choose>
+</div>
+</body>
+</html>
+</xsl:template>
+</xsl:stylesheet>
+`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",
@@ -21,6 +21,7 @@
     "dist",
     "client.ts",
     "jsonld.tsx",
+    "sitemap-xsl.ts",
     "bin",
     "README.md"
   ],

package/sitemap-xsl.ts

@@ -0,0 +1,66 @@
+// XSL-таблица стилей для человекочитаемого вида XML-карты в браузере (как у RankMath).
+// Отдаётся адаптером на домене сайта по /sitemap.xsl; сам XML на неё ссылается.
+export const SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:s="http://www.sitemaps.org/schemas/sitemap/0.9">
+<xsl:output method="html" encoding="UTF-8" indent="yes"/>
+<xsl:template match="/">
+<html lang="ru">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>XML-карта сайта</title>
+<style>
+  *{box-sizing:border-box}
+  body{font-family:-apple-system,system-ui,'Segoe UI',Roboto,sans-serif;color:#1e293b;margin:0;background:#f8fafc}
+  .head{background:#2563eb;color:#fff;padding:28px 40px}
+  .head h1{margin:0 0 8px;font-size:26px;font-weight:600}
+  .head p{margin:0;font-size:14px;opacity:.92;max-width:920px;line-height:1.55}
+  .head a{color:#fff}
+  .wrap{padding:24px 40px}
+  .count{color:#475569;font-size:14px;margin:0 0 14px}
+  table{width:100%;border-collapse:collapse;background:#fff;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden}
+  th{background:#eff2f7;color:#334155;text-align:left;font-size:12px;text-transform:uppercase;letter-spacing:.03em;padding:12px 16px}
+  td{padding:11px 16px;font-size:14px;border-top:1px solid #f1f5f9}
+  tr:hover td{background:#f8fafc}
+  td a{color:#2563eb;text-decoration:none;word-break:break-all}
+  td a:hover{text-decoration:underline}
+  .n{width:80px;color:#64748b;text-align:right}
+</style>
+</head>
+<body>
+<div class="head">
+  <h1>XML-карта сайта</h1>
+  <p>Список страниц для поисковых систем. Сгенерировано платформой <b>SEO Agent</b>. Подробнее об <a href="https://www.sitemaps.org/">XML-картах сайта</a>.</p>
+</div>
+<div class="wrap">
+<xsl:choose>
+  <xsl:when test="s:sitemapindex">
+    <p class="count">Индексный файл содержит <b><xsl:value-of select="count(s:sitemapindex/s:sitemap)"/></b> карт(ы) сайта.</p>
+    <table>
+      <tr><th>Карта сайта</th></tr>
+      <xsl:for-each select="s:sitemapindex/s:sitemap">
+        <tr><td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td></tr>
+      </xsl:for-each>
+    </table>
+  </xsl:when>
+  <xsl:otherwise>
+    <p class="count">Эта карта сайта содержит <b><xsl:value-of select="count(s:urlset/s:url)"/></b> URL.</p>
+    <table>
+      <tr><th class="n">#</th><th>URL</th></tr>
+      <xsl:for-each select="s:urlset/s:url">
+        <tr>
+          <td class="n"><xsl:value-of select="position()"/></td>
+          <td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td>
+        </tr>
+      </xsl:for-each>
+    </table>
+  </xsl:otherwise>
+</xsl:choose>
+</div>
+</body>
+</html>
+</xsl:template>
+</xsl:stylesheet>
+`;