@webnumseoagent/next 0.7.1 → 0.7.3

package/README.md

@@ -105,6 +105,10 @@ Vercel и `git push`. **Проверь `git diff`** перед коммитом
   контент = git-коммит → редеплой пересобирает страницы.
 - Тема оформления (фирменный цвет) и канонический URL-префикс берутся из `content/blog/.blogfs.json`.
 - Sitemap блога добавляется автоматически (раздел `sitemap/blog.xml`).
+- `init`/`blog` **сами** прописывают в `next.config` `outputFileTracingIncludes` для `content/blog` —
+  без этого на Vercel файлы блога не попадают в serverless-бандл, и рантайм-чтение (ISR-ревалидация
+  страниц + route-handler карты сайта) находит пусто → блог исчезает с сайта и из sitemap. Идемпотентно;
+  запускается и на авто-обновлении адаптера, поэтому сайт чинится сам, без правок разработчика.
 
 ## Гарантии
 - **Fail-safe:** при недоступности платформы адаптер возвращает твои дефолты и

package/bin/cli.mjs

@@ -95,6 +95,54 @@ async function detectLocales() {
   return [];
 }
 
+// Вставляет ключ в объектный литерал конфига Next (после его открывающей "{"). Возвращает
+// новый текст или null, если знакомую форму конфига не нашли (тогда печатаем ручную инструкцию).
+function injectIntoConfigObject(src, insert) {
+  const patterns = [
+    /(\bconst\s+nextConfig\b[^=]*=\s*)\{/,
+    /(\bconst\s+config\b[^=]*=\s*)\{/,
+    /(\bmodule\.exports\s*=\s*)\{/,
+    /(\bexport\s+default\s+)\{/,
+  ];
+  for (const re of patterns) {
+    const m = src.match(re);
+    if (m) {
+      const braceIdx = m.index + m[0].length - 1; // позиция "{"
+      return src.slice(0, braceIdx + 1) + insert + src.slice(braceIdx + 1);
+    }
+  }
+  return null;
+}
+
+// Гарантирует, что папка блога попадёт в serverless-бандл Vercel (Next `outputFileTracingIncludes`).
+// ЗАЧЕМ: блог читает content/blog через node:fs. На Vercel это надёжно только на СБОРКЕ. Но в РАНТАЙМЕ
+// файлы читают и ISR-ревалидация страниц блога, и route-handler карты сайта (/sitemap/<раздел>.xml —
+// он всегда рантайм). Трассировщик Next не видит динамический readdirSync(cwd + env) → content/blog не
+// кладётся в лямбду → в рантайме там пусто → статьи схлопываются в 404/«нет статей», блога нет в sitemap.
+// Этот ключ форсит включение content/blog в бандл функций. Идемпотентно; best-effort (никогда не роняет).
+// Живёт в CLI (а не в разовой инструкции), чтобы self-update (`npx … blog --force`) авто-чинил ЛЮБОЙ сайт
+// без участия разработчика сайта.
+async function ensureContentTracing(contentDir = "content/blog") {
+  const glob = `./${contentDir.replace(/^\.?\/+/, "").replace(/\/+$/, "")}/**/*`;
+  const names = ["next.config.ts", "next.config.mjs", "next.config.js", "next.config.cjs"];
+  let cfgPath = null;
+  for (const n of names) { if (await exists(path.join(root, n))) { cfgPath = path.join(root, n); break; } }
+  const manual = `\n  \x1b[33mℹ\x1b[0m Добавь в next.config, чтобы блог работал на Vercel (ISR + карта сайта читают файлы в рантайме):\n    \x1b[36moutputFileTracingIncludes: { "/**": ["${glob}"] }\x1b[0m`;
+  if (!cfgPath) { log(manual); return; }
+  const rel = path.relative(root, cfgPath);
+  let src = await fs.readFile(cfgPath, "utf8");
+  if (/outputFileTracingIncludes/.test(src)) {
+    if (src.includes(glob) || /content\/blog/.test(src)) { skip(`${rel} — трассировка блога уже настроена`); return; }
+    log(`\n  \x1b[33mℹ\x1b[0m В ${rel} уже есть outputFileTracingIncludes — добавь в него ключ "${glob}".`);
+    return;
+  }
+  const insert = `\n  // SEO Agent: включаем файлы блога (content/blog) в serverless-бандл — нужно для ISR-ревалидации\n  // страниц блога и route-handler карты сайта, которые читают эти файлы в рантайме на Vercel.\n  outputFileTracingIncludes: {\n    "/**": ["${glob}"],\n  },`;
+  const patched = injectIntoConfigObject(src, insert);
+  if (!patched) { log(`\n  \x1b[33mℹ\x1b[0m Не смог авто-обновить ${rel}.${manual}`); return; }
+  await fs.writeFile(cfgPath, patched);
+  ok(`${rel} (outputFileTracingIncludes → content/blog в бандле)`);
+}
+
 async function init() {
   log("\n\x1b[1m@webnumseoagent/next — установка\x1b[0m\n");
   // Проверяем чистоту git ДО создания файлов (чтобы весь дифф установки был обозрим).
@@ -406,7 +454,7 @@ async function init() {
   // generateMetadata: у блог-роута свой generateMetadata (seoBlogPost), его НЕ оборачиваем seoMeta.
   if (!args.includes("--no-blog")) {
     const jsxExt = ext === "ts" ? "tsx" : "jsx";
-    const mdParam = ext === "ts" ? "{ params }: { params: { slug: string } }" : "{ params }";
+    const mdParam = ext === "ts" ? "{ params }: { params: Promise<{ slug: string }> }" : "{ params }";
     const madeIndex = await ensureFile(
       path.join(root, appDir, `blog/page.${jsxExt}`),
       `import { SeoBlogIndex } from "${blogFor("blog/page.tsx")}";\nexport const dynamic = "force-static";\nexport default function BlogPage() {\n  return <SeoBlogIndex title="Блог" />;\n}\n`,
@@ -426,7 +474,7 @@ async function init() {
     } else {
       madeArticle = await ensureFile(
         path.join(root, appDir, `blog/[slug]/page.${jsxExt}`),
-        `import { notFound } from "next/navigation";\nimport { seoBlogPost, seoBlogStaticParams, SeoBlogArticle } from "${blogFor("blog/[slug]/page.tsx")}";\nexport const dynamic = "force-static";\nexport const dynamicParams = false;\n\n// Полностью статический рендер: все статьи пре-рендерятся на сборке из файлов content/blog. Контент\n// меняется git-коммитом → редеплой. dynamicParams=false: неизвестный слаг → 404 (без рантайм-чтения).\nexport async function generateStaticParams() {\n  return seoBlogStaticParams();\n}\n\nexport async function generateMetadata(${mdParam}) {\n  const post = await seoBlogPost(params.slug);\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${mdParam}) {\n  const post = await seoBlogPost(params.slug);\n  if (!post) notFound();\n  return <SeoBlogArticle post={post} />;\n}\n`,
+        `import { notFound } from "next/navigation";\nimport { seoBlogPost, seoBlogStaticParams, SeoBlogArticle } from "${blogFor("blog/[slug]/page.tsx")}";\nexport const dynamic = "force-static";\nexport const dynamicParams = false;\n\n// Полностью статический рендер: все статьи пре-рендерятся на сборке из файлов content/blog. Контент\n// меняется git-коммитом → редеплой. dynamicParams=false: неизвестный слаг → 404 (без рантайм-чтения).\nexport async function generateStaticParams() {\n  return seoBlogStaticParams();\n}\n\nexport async function generateMetadata(${mdParam}) {\n  const { slug } = await params;\n  const post = await seoBlogPost(slug);\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${mdParam}) {\n  const { slug } = await params;\n  const post = await seoBlogPost(slug);\n  if (!post) notFound();\n  return <SeoBlogArticle post={post} />;\n}\n`,
       );
     }
     if (madeIndex || madeArticle) {
@@ -434,6 +482,8 @@ async function init() {
     } else {
       log(`\n  \x1b[33mℹ\x1b[0m Блог: у сайта уже есть роуты /blog — не трогаю.`);
     }
+    // Файлы блога должны попасть в serverless-бандл Vercel (иначе рантайм-чтение в лямбде пусто).
+    await ensureContentTracing();
   }
 
   log("\n\x1b[1mЗатем:\x1b[0m задай эти же env-переменные в Vercel (Settings → Environment Variables) и сделай git push.\n");
@@ -694,33 +744,42 @@ async function blogPage() {
   // index-роут (список): в [locale] прокидываем locale + basePath. СТАТИЧЕСКИЙ (Фаза 1 git-native):
   // без searchParams (иначе роут стал бы динамическим и в рантайме Vercel не увидел бы файлы content/blog).
   const idxSig = param
-    ? (ext === "ts" ? `{ params }: { params: { ${param}: string } }` : "{ params }")
+    ? (ext === "ts" ? `{ params }: { params: Promise<{ ${param}: string }> }` : "{ params }")
     : "";
+  // Next 15: params — Promise, читаем через await (в Next 14 await над объектом тоже безвреден).
+  // param==="locale" — деструктурим без переименования (иначе eslint no-useless-rename).
+  const idxAwait = param ? `  const { ${param === "locale" ? "locale" : `${param}: locale`} } = await params;\n` : "";
   const idxBody = param
-    ? `<SeoBlogIndex locale={params.${param}} basePath={\`/\${params.${param}}/blog\`} />`
+    ? `<SeoBlogIndex locale={locale} basePath={\`/\${locale}/blog\`} />`
     : `<SeoBlogIndex />`;
   await writeOurRoute(
     path.join(root, appDir, under, `blog/page.${jsxExt}`),
-    `import { SeoBlogIndex } from "${blogFor(`${under}blog/page.tsx`)}";\nexport const dynamic = "force-static";\nexport default function BlogPage(${idxSig}) {\n  return ${idxBody};\n}\n`,
+    `import { SeoBlogIndex } from "${blogFor(`${under}blog/page.tsx`)}";\nexport const dynamic = "force-static";\nexport default async function BlogPage(${idxSig}) {\n${idxAwait}  return ${idxBody};\n}\n`,
   );
 
   if (blogDynConflict) {
     log(`\n  \x1b[1mУ сайта уже есть blog/[иной-сегмент]\x1b[0m — роут статьи /blog/[slug] не создаю. Подключи вручную: \x1b[36mimport { seoBlogPost, SeoBlogArticle } from "${blogFor(`${under}blog/[slug]/page.tsx`)}";\x1b[0m`);
   } else {
     const artSig = ext === "ts"
-      ? (param ? `{ params }: { params: { ${param}: string; slug: string } }` : `{ params }: { params: { slug: string } }`)
+      ? (param ? `{ params }: { params: Promise<{ ${param}: string; slug: string }> }` : `{ params }: { params: Promise<{ slug: string }> }`)
       : "{ params }";
-    const localeArg = param ? `, { locale: params.${param} }` : "";
-    const localeProp = param ? ` locale={params.${param}}` : "";
+    // Next 15: params — Promise, читаем через await. Локаль переименовываем в locale (кроме param==="locale").
+    const artAwait = param ? `  const { slug, ${param === "locale" ? "locale" : `${param}: locale`} } = await params;\n` : `  const { slug } = await params;\n`;
+    const localeArg = param ? `, { locale }` : "";
+    const localeProp = param ? ` locale={locale}` : "";
     // Мультиязычный роут /[locale]/blog/[slug]: пре-рендерим КАЖДУЮ статью под КАЖДУЮ локаль (передаём имя
     // сегмента локали) — иначе force-static не покроет комбинацию locale×slug и статьи отдадут 404.
     const gsp = param ? `seoBlogStaticParams({ localeParam: "${param}" })` : `seoBlogStaticParams()`;
     await writeOurRoute(
       path.join(root, appDir, under, `blog/[slug]/page.${jsxExt}`),
-      `import { notFound } from "next/navigation";\nimport { seoBlogPost, seoBlogStaticParams, SeoBlogArticle } from "${blogFor(`${under}blog/[slug]/page.tsx`)}";\nexport const dynamic = "force-static";\nexport const dynamicParams = false;\n\n// Полностью статический рендер: все статьи пре-рендерятся на сборке из файлов content/blog. Контент\n// меняется git-коммитом → редеплой. dynamicParams=false: неизвестный слаг → 404 (без рантайм-чтения).\nexport async function generateStaticParams() {\n  return ${gsp};\n}\n\nexport async function generateMetadata(${artSig}) {\n  const post = await seoBlogPost(params.slug${localeArg});\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${artSig}) {\n  const post = await seoBlogPost(params.slug${localeArg});\n  if (!post) notFound();\n  return <SeoBlogArticle post={post}${localeProp} />;\n}\n`,
+      `import { notFound } from "next/navigation";\nimport { seoBlogPost, seoBlogStaticParams, SeoBlogArticle } from "${blogFor(`${under}blog/[slug]/page.tsx`)}";\nexport const dynamic = "force-static";\nexport const dynamicParams = false;\n\n// Полностью статический рендер: все статьи пре-рендерятся на сборке из файлов content/blog. Контент\n// меняется git-коммитом → редеплой. dynamicParams=false: неизвестный слаг → 404 (без рантайм-чтения).\nexport async function generateStaticParams() {\n  return ${gsp};\n}\n\nexport async function generateMetadata(${artSig}) {\n${artAwait}  const post = await seoBlogPost(slug${localeArg});\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${artSig}) {\n${artAwait}  const post = await seoBlogPost(slug${localeArg});\n  if (!post) notFound();\n  return <SeoBlogArticle post={post}${localeProp} />;\n}\n`,
     );
   }
 
+  // Файлы блога должны попасть в serverless-бандл Vercel (ISR-ревалидация + карта сайта читают их в
+  // рантайме). Идемпотентно — запускается и на self-update (`npx … blog --force`), авто-чиня сайт.
+  await ensureContentTracing();
+
   log(`\n  \x1b[32m✓\x1b[0m Готово. Проверь \x1b[36mgit diff\x1b[0m, затем commit + push. Блог: \x1b[1m${localeDir ? `/${param}/blog` : "/blog"}\x1b[0m — дизайн/шапка с сайта, список 4-в-ряд, статический рендер из файлов.\n`);
 }
 

package/package.json

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