npm - @webnumseoagent/next - Versions diffs - 0.1.25 → 0.2.1 - Mend

@webnumseoagent/next 0.1.25 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/bin/cli.mjs CHANGED Viewed

@@ -101,7 +101,7 @@ async function init() {
     // Вендор-файлы адаптера — генерируемые (их не правят руками): при повторном init ОБНОВЛЯЕМ,
     // если содержимое изменилось. Иначе апгрейд оставит старый client.ts без новых экспортов
     // (напр. seoMerchantFeedXml), а свежесозданный роут импортнёт несуществующий символ → build падёт.
-    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts"]) {
+    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts", "blog.tsx"]) {
       const dest = path.join(vendor, f);
       const src = await fs.readFile(path.join(pkgRoot, f));
       const cur = await fs.readFile(dest).catch(() => null);
@@ -117,6 +117,7 @@ async function init() {
   // Импорт клиента/jsonld для файла на нужной глубине (в vendor-режиме путь относительный).
   const clientFor = (file) => (pkgMode ? "@webnumseoagent/next" : `${importPath(appDir, file)}/client`);
   const jsonldFor = (file) => (pkgMode ? "@webnumseoagent/next/jsonld" : `${importPath(appDir, file)}/jsonld`);
+  const blogFor = (file) => (pkgMode ? "@webnumseoagent/next/blog" : `${importPath(appDir, file)}/blog`);
   // Не создаём sitemap/robots, если у сайта они УЖЕ есть (public/, отдельный роут и т.п.) —
   // чтобы не перекрыть существующую карту сайта пустой.
@@ -368,6 +369,37 @@ async function init() {
   if (!jsonLdMounted) {
     log(`\n  И смонтируй JSON-LD в layout (внутри <body>):\n    \x1b[36mimport { SeoJsonLd } from "${importJsonld}";\n    <SeoJsonLd route="/" />\x1b[0m`);
   }
+  // 7. Блог (пакет-рендер, Фаза 3.1c) — ОПТ-ИН по флагу --blog: ставит роуты /blog и /blog/[slug].
+  // ПОСЛЕ авто-обёртки generateMetadata: у блог-роута свой generateMetadata (seoBlogPost), его НЕ
+  // оборачиваем seoMeta. Компоненты сами тянут конфиг+статьи; тело статьи уже санитайзено (доставка).
+  if (args.includes("--blog")) {
+    const jsxExt = ext === "ts" ? "tsx" : "jsx";
+    const mdParam = ext === "ts" ? "{ params }: { params: { slug: string } }" : "{ params }";
+    await ensureFile(
+      path.join(root, appDir, `blog/page.${jsxExt}`),
+      `import { SeoBlogIndex } from "${blogFor("blog/page.tsx")}";\nexport const revalidate = 300;\nexport default function BlogPage() {\n  return <SeoBlogIndex title="Блог" />;\n}\n`,
+    );
+    // У сайта уже может быть app/blog/[иной-сегмент] — Next не даёт два разных динамических имени
+    // на один путь. Тогда наш /blog/[slug] не создаём (иначе билд упадёт), а печатаем ручную инструкцию.
+    let blogDynConflict = false;
+    const blogDir = path.join(root, appDir, "blog");
+    if (await exists(blogDir)) {
+      const names = await fs.readdir(blogDir).catch(() => []);
+      blogDynConflict = names.some((n) => /^\[.*\]$/.test(n) && n !== "[slug]");
+    }
+    if (blogDynConflict) {
+      log(`\n  \x1b[1mУ сайта уже есть app/${appDir === "src/app" ? "" : ""}blog/[иной-сегмент]\x1b[0m — роут статьи /blog/[slug] не создаю (Next запрещает два динамических сегмента).`);
+      log(`    Подключи статьи к своему сегменту вручную:  \x1b[36mimport { seoBlogPost, SeoBlogArticle } from "${blogFor("blog/[slug]/page.tsx")}";\x1b[0m`);
+    } else {
+      await ensureFile(
+        path.join(root, appDir, `blog/[slug]/page.${jsxExt}`),
+        `import { notFound } from "next/navigation";\nimport { seoBlogPost, SeoBlogArticle } from "${blogFor("blog/[slug]/page.tsx")}";\nexport const revalidate = 300;\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`,
+      );
+    }
+    log(`\n  \x1b[32m✓\x1b[0m Блог: роут /blog (пакет-рендер). Настрой доставку+anon-ключ на платформе.`);
+  }
   log("\n\x1b[1mЗатем:\x1b[0m задай эти же env-переменные в Vercel (Settings → Environment Variables) и сделай git push.\n");
 }
@@ -420,6 +452,10 @@ async function findMetadataPages(dir, acc = []) {
       await findMetadataPages(p, acc);
     } else if (/\.(tsx|ts|jsx|js)$/.test(e.name) && /page\.|layout\./.test(e.name)) {
       const txt = await fs.readFile(p, "utf8");
+      // Наши блог-роуты (пакет-рендер) имеют СВОЙ generateMetadata (seoBlogPost) — НЕ оборачиваем
+      // их seoMeta даже при повторном init --wrap (иначе перетрём пер-статейное SEO). Отсекаем по
+      // уникальным символам скаффолда, а не по папке blog/ (у сайта может быть свой блог для обёртки).
+      if (/\b(SeoBlogIndex|SeoBlogArticle|seoBlogPost|seoBlogList)\b/.test(txt)) continue;
       // Собираем и функции generateMetadata, и статический `export const metadata`.
       if (/generateMetadata/.test(txt) || /export\s+const\s+metadata\b/.test(txt)) acc.push(p);
     }

package/blog.tsx ADDED Viewed

@@ -0,0 +1,271 @@
+// @webnumseoagent/next/blog — рендер блога код-сайта (Фаза 3.1c).
+// Пакет тянет ПУБЛИЧНЫЙ конфиг блога с платформы (config-API /blog: supabaseUrl + anonKey +
+// таблица/формат/локали/маппинг), затем читает ОПУБЛИКОВАННЫЕ статьи прямо из Supabase клиента
+// (anon-ключ + public-read RLS) и рендерит обложку + заголовок + тело (картинки/таблицы/ссылки).
+//
+// Тело статьи уже САНИТАЙЗЕНО на стороне платформы при доставке (Фаза 3.1b), поэтому здесь оно
+// рендерится как HTML (dangerouslySetInnerHTML) — граница доверия проходит по доставке, не по рендеру.
+//
+// Все функции FAIL-SAFE: при ошибке/таймауте возвращают пусто — блог просто не покажет контент,
+// сборка/рендер сайта НИКОГДА не падает.
+//
+// Использование (роуты ставит `npx @webnumseoagent/next init --blog`):
+//   app/blog/page.tsx:            export default () => <SeoBlogIndex title="Блог" />
+//   app/blog/[slug]/page.tsx:     const post = await seoBlogPost(params.slug); if(!post) notFound();
+//                                 return <SeoBlogArticle post={post} />
+const API = process.env.SEOAGENT_API_BASE ?? "";
+const SITE = process.env.SEOAGENT_SITE_ID ?? "";
+const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
+const REVALIDATE = 300;
+export interface SeoBlogMapping {
+  title: string; excerpt?: string; body: string;
+  id?: string; image?: string; published?: string; publishedAt?: string;
+}
+export interface SeoBlogConfig {
+  supabaseUrl: string; anonKey: string; table: string;
+  format: "html" | "minimarkup"; locales: string[]; mapping: SeoBlogMapping;
+}
+export interface SeoBlogSummary { slug: string; title: string; excerpt: string; cover: string | null; date: string | null }
+export interface SeoBlogPostFull extends SeoBlogSummary { bodyHtml: string }
+function firstLocale(cfg: SeoBlogConfig): string {
+  return (cfg.locales ?? []).filter(Boolean)[0] ?? "";
+}
+// Публичный конфиг блога с платформы (кэш ISR + тег seo-<site> — сбрасывается ревалидацией).
+async function fetchBlogConfig(): Promise<SeoBlogConfig | null> {
+  if (!API || !SITE || !TOKEN) return null;
+  try {
+    const r = await fetch(`${API}/api/seo/${SITE}/blog`, {
+      headers: { "x-seo-agent-key": TOKEN },
+      next: { revalidate: REVALIDATE, tags: [`seo-${SITE}`, `seo-blog-${SITE}`] },
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!r.ok) return null;
+    const d = (await r.json()) as { blog?: SeoBlogConfig | null };
+    const b = d?.blog ?? null;
+    if (!b?.supabaseUrl || !b?.anonKey || !b?.table || !b?.mapping?.title || !b?.mapping?.body) return null;
+    return b;
+  } catch {
+    return null;
+  }
+}
+// Запрос к REST API Supabase клиента (anon). Возвращает массив строк либо null.
+async function supaGet(cfg: SeoBlogConfig, url: string): Promise<Record<string, unknown>[] | null> {
+  try {
+    const r = await fetch(url, {
+      headers: { apikey: cfg.anonKey, Authorization: `Bearer ${cfg.anonKey}` },
+      next: { revalidate: REVALIDATE, tags: [`seo-blog-${SITE}`] },
+      signal: AbortSignal.timeout(6000),
+    });
+    if (!r.ok) return null;
+    const d = await r.json();
+    return Array.isArray(d) ? d : null;
+  } catch {
+    return null;
+  }
+}
+const S = (v: unknown): string => (v == null ? "" : String(v));
+const base = (cfg: SeoBlogConfig): string => cfg.supabaseUrl.replace(/\/+$/, "");
+async function fetchPosts(cfg: SeoBlogConfig, locale: string, limit: number): Promise<SeoBlogSummary[]> {
+  const m = cfg.mapping;
+  if (!m.id) return []; // без колонки id/slug ссылки на статьи не построить
+  const suf = locale ? `_${locale}` : "";
+  const titleCol = m.title + suf;
+  const excerptCol = m.excerpt ? m.excerpt + suf : "";
+  const cols = [m.id, titleCol, excerptCol, m.image || "", m.publishedAt || ""].filter(Boolean).join(",");
+  let url = `${base(cfg)}/rest/v1/${encodeURIComponent(cfg.table)}?select=${cols}`;
+  if (m.published) url += `&${m.published}=eq.true`;
+  if (m.publishedAt) url += `&order=${m.publishedAt}.desc`;
+  url += `&limit=${limit}`;
+  const rows = await supaGet(cfg, url);
+  return (rows ?? [])
+    .map((r) => ({
+      slug: S(r[m.id!]),
+      title: S(r[titleCol]),
+      excerpt: excerptCol ? S(r[excerptCol]) : "",
+      cover: m.image ? (r[m.image] as string | null) ?? null : null,
+      date: m.publishedAt ? (r[m.publishedAt] as string | null) ?? null : null,
+    }))
+    .filter((p) => p.slug && p.title);
+}
+async function fetchPost(cfg: SeoBlogConfig, slug: string, locale: string): Promise<SeoBlogPostFull | null> {
+  const m = cfg.mapping;
+  if (!m.id) return null;
+  const suf = locale ? `_${locale}` : "";
+  let url = `${base(cfg)}/rest/v1/${encodeURIComponent(cfg.table)}?select=*&${m.id}=eq.${encodeURIComponent(slug)}`;
+  if (m.published) url += `&${m.published}=eq.true`;
+  url += `&limit=1`;
+  const rows = await supaGet(cfg, url);
+  const r = rows && rows[0];
+  if (!r) return null;
+  const rawBody = S(r[m.body + suf]);
+  return {
+    slug: S(r[m.id]) || slug,
+    title: S(r[m.title + suf]),
+    excerpt: m.excerpt ? S(r[m.excerpt + suf]) : "",
+    cover: m.image ? (r[m.image] as string | null) ?? null : null,
+    date: m.publishedAt ? (r[m.publishedAt] as string | null) ?? null : null,
+    bodyHtml: cfg.format === "minimarkup" ? miniMarkupToHtml(rawBody) : sanitizeDeliveryHtml(rawBody),
+  };
+}
+// ── Публичные data-функции (для generateMetadata / generateStaticParams) ──
+export async function seoBlogList(opts?: { locale?: string; limit?: number }): Promise<SeoBlogSummary[]> {
+  const cfg = await fetchBlogConfig();
+  if (!cfg) return [];
+  return fetchPosts(cfg, opts?.locale ?? firstLocale(cfg), opts?.limit ?? 100);
+}
+export async function seoBlogPost(slug: string, opts?: { locale?: string }): Promise<SeoBlogPostFull | null> {
+  const cfg = await fetchBlogConfig();
+  if (!cfg) return null;
+  return fetchPost(cfg, slug, opts?.locale ?? firstLocale(cfg));
+}
+// ── Мини-разметка (## / - / **) → HTML (для legacy-формата; текст экранируем). ──
+function esc(s: string): string {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function inlineMini(s: string): string {
+  return esc(s).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+}
+function miniMarkupToHtml(src: string): string {
+  const out: string[] = [];
+  for (const block of (src || "").split(/\n{2,}/)) {
+    const b = block.trim();
+    if (!b) continue;
+    const lines = b.split("\n");
+    if (lines.every((l) => l.startsWith("- "))) {
+      out.push("<ul>" + lines.map((l) => `<li>${inlineMini(l.slice(2))}</li>`).join("") + "</ul>");
+    } else if (b.startsWith("## ")) {
+      out.push(`<h2>${inlineMini(b.slice(3))}</h2>`);
+    } else {
+      out.push(`<p>${inlineMini(b)}</p>`);
+    }
+  }
+  return out.join("");
+}
+// ── Санитайзер HTML (защита-в-глубину перед dangerouslySetInnerHTML) — ЗЕРКАЛО доставки
+// (src/lib/blog/blog-delivery.ts + Edge blog-autopilot). Тело уже санитайзено при доставке, но
+// если у сайта не настроен RLS (провиженинг опционален) — это последний рубеж. ──
+const SANITIZE_ALLOWED_TAGS = new Set([
+  "h1", "h2", "h3", "h4", "h5", "h6", "p", "br", "hr", "strong", "b", "em", "i", "u", "s",
+  "ul", "ol", "li", "blockquote", "a", "img", "figure", "figcaption",
+  "table", "thead", "tbody", "tfoot", "tr", "th", "td", "caption", "code", "pre", "span", "div",
+]);
+const SANITIZE_ALLOWED_ATTRS = /^(href|src|alt|title|target|rel|width|height|loading|colspan|rowspan|scope|start|type)$/;
+const SANITIZE_VOID = new Set(["br", "hr", "img"]);
+function decodeSchemeEntities(v: string): string {
+  return v
+    .replace(/&#x([0-9a-fA-F]+);?/g, (_m, h) => { try { return String.fromCodePoint(parseInt(h, 16)); } catch { return ""; } })
+    .replace(/&#(\d+);?/g, (_m, d) => { try { return String.fromCodePoint(parseInt(d, 10)); } catch { return ""; } })
+    .replace(/&(colon|tab|newline|lf|cr|sol|amp);?/gi, (m) => {
+      const k = m.replace(/[&;]/g, "").toLowerCase();
+      return ({ colon: ":", sol: "/", amp: "&", tab: " ", newline: " ", lf: " ", cr: " " } as Record<string, string>)[k] ?? " ";
+    });
+}
+function safeUrl(val: string): boolean {
+  const v = decodeSchemeEntities(val).toLowerCase().replace(/\s/g, "");
+  if (!/^[a-z][a-z0-9+.-]*:/.test(v)) return true;
+  return /^(https?:|mailto:|tel:)/.test(v);
+}
+function sanitizeAttrs(tag: string, attrsRaw: string): string {
+  const out: string[] = [];
+  const re = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"'>]+))/g;
+  let m: RegExpExecArray | null;
+  let href = "";
+  while ((m = re.exec(attrsRaw))) {
+    const name = m[1].toLowerCase();
+    const val = m[3] ?? m[4] ?? m[5] ?? "";
+    if (name.startsWith("on") || name === "style" || name === "srcset") continue;
+    if ((name === "href" || name === "src") && !safeUrl(val)) continue;
+    if (!SANITIZE_ALLOWED_ATTRS.test(name)) continue;
+    if (name === "href") href = val;
+    out.push(`${name}="${val.replace(/"/g, "&quot;")}"`);
+  }
+  if (tag === "a" && !out.some((a) => a.startsWith("rel="))) {
+    if (/^(https?:)?\/\//i.test(href.trim())) out.push('rel="noopener nofollow"');
+  }
+  return out.length ? " " + out.join(" ") : "";
+}
+function sanitizeDeliveryHtml(html: string): string {
+  let s = html || "";
+  s = s.replace(/<(script|style|iframe|object|embed|form|noscript|template|svg|math)\b[\s\S]*?<\/\1\s*>/gi, "");
+  s = s.replace(/<!--[\s\S]*?-->/g, "");
+  s = s.replace(/<(\/?)([a-zA-Z][a-zA-Z0-9]*)\b((?:"[^"]*"|'[^']*'|[^>])*)>/g, (_full, slash, tag, attrs) => {
+    const t = tag.toLowerCase();
+    if (!SANITIZE_ALLOWED_TAGS.has(t)) return "";
+    if (slash) return `</${t}>`;
+    return `<${t}${sanitizeAttrs(t, attrs)}${SANITIZE_VOID.has(t) ? " /" : ""}>`;
+  });
+  return s.trim();
+}
+// ── Компоненты (серверные) ──────────────────────────────────────────────────────────────────
+const BODY_CSS = `.seoagent-blog-body img{max-width:100%;height:auto;border-radius:8px;margin:1rem 0}
+.seoagent-blog-body table{width:100%;border-collapse:collapse;margin:1rem 0;font-size:.95em}
+.seoagent-blog-body th,.seoagent-blog-body td{border:1px solid #e5e7eb;padding:.5rem .75rem;text-align:left}
+.seoagent-blog-body th{background:#f8fafc}
+.seoagent-blog-body h2{margin:1.75rem 0 .75rem;font-size:1.5rem;line-height:1.3}
+.seoagent-blog-body h3{margin:1.4rem 0 .6rem;font-size:1.2rem}
+.seoagent-blog-body p{margin:0 0 1rem}
+.seoagent-blog-body a{color:#2563eb}
+.seoagent-blog-body figure{margin:1.25rem 0}
+.seoagent-blog-body figcaption{color:#94a3b8;font-size:.85em;text-align:center;margin-top:.4rem}
+.seoagent-blog-body blockquote{margin:1rem 0;padding:.5rem 1rem;border-left:3px solid #e5e7eb;color:#475569}`;
+// Список статей блога. Сам тянет конфиг+статьи. Пусто/ошибка → null (ничего не ломаем).
+export async function SeoBlogIndex(props: { locale?: string; basePath?: string; limit?: number; title?: string }) {
+  const cfg = await fetchBlogConfig();
+  if (!cfg) return null;
+  const locale = props.locale ?? firstLocale(cfg);
+  const posts = await fetchPosts(cfg, locale, props.limit ?? 30);
+  if (!posts.length) return null;
+  const basePath = (props.basePath ?? "/blog").replace(/\/+$/, "");
+  return (
+    <div style={{ maxWidth: 1080, margin: "0 auto", padding: "1.5rem" }}>
+      {props.title ? <h1 style={{ fontSize: "2rem", margin: "0 0 1.5rem" }}>{props.title}</h1> : null}
+      <div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fill, minmax(280px, 1fr))", gap: "1.5rem" }}>
+        {posts.map((p) => (
+          <a key={p.slug} href={`${basePath}/${p.slug}`}
+            style={{ display: "block", textDecoration: "none", color: "inherit", border: "1px solid #e5e7eb", borderRadius: 12, overflow: "hidden" }}>
+            {p.cover ? <img src={p.cover} alt={p.title} style={{ width: "100%", height: 180, objectFit: "cover", display: "block" }} /> : null}
+            <div style={{ padding: "1rem" }}>
+              <h2 style={{ fontSize: "1.1rem", margin: "0 0 .5rem", lineHeight: 1.3 }}>{p.title}</h2>
+              {p.excerpt ? <p style={{ margin: 0, color: "#64748b", fontSize: ".9rem", lineHeight: 1.5 }}>{p.excerpt}</p> : null}
+            </div>
+          </a>
+        ))}
+      </div>
+    </div>
+  );
+}
+// Одна статья. Принимает пост (из seoBlogPost) — так страница может сделать notFound()/метаданные.
+export function SeoBlogArticle({ post, locale }: { post: SeoBlogPostFull; locale?: string }) {
+  return (
+    <article style={{ maxWidth: 760, margin: "0 auto", padding: "1.5rem", lineHeight: 1.7 }}>
+      <style dangerouslySetInnerHTML={{ __html: BODY_CSS }} />
+      {post.cover ? <img src={post.cover} alt={post.title} style={{ width: "100%", borderRadius: 12, marginBottom: "1.5rem" }} /> : null}
+      <h1 style={{ fontSize: "2.2rem", lineHeight: 1.2, margin: "0 0 1rem" }}>{post.title}</h1>
+      {post.date ? <p style={{ color: "#94a3b8", margin: "0 0 1.5rem" }}>{fmtDate(post.date, locale)}</p> : null}
+      {/* Тело уже санитайзено при доставке (Фаза 3.1b) — рендерим как HTML. */}
+      <div className="seoagent-blog-body" dangerouslySetInnerHTML={{ __html: post.bodyHtml }} />
+    </article>
+  );
+}
+function fmtDate(d: string, locale?: string): string {
+  try {
+    return new Date(d).toLocaleDateString(locale || undefined, { year: "numeric", month: "long", day: "numeric" });
+  } catch {
+    return "";
+  }
+}

package/client.ts CHANGED Viewed

@@ -260,7 +260,7 @@ export async function seoSitemapXml(path: string): Promise<string> {
 //   export async function GET() { return new Response(await seoMerchantFeedXml("/merchant-feed.xml"), {headers:{"content-type":"application/xml"}}) }
 export async function seoMerchantFeedXml(path: string): Promise<string> {
   // Валидный RSS-канал (title/link/description обязательны в RSS 2.0) с пустым списком товаров.
-  const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">\n<channel>\n  <title>Merchant feed</title>\n  <link>https://seonum.uz</link>\n  <description>Merchant feed temporarily unavailable</description>\n</channel>\n</rss>\n`;
+  const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">\n<channel>\n  <title>Merchant feed</title>\n  <link></link>\n  <description>Merchant feed temporarily unavailable</description>\n</channel>\n</rss>\n`;
   if (!API || !SITE || !TOKEN) return FALLBACK;
   try {
     const r = await fetch(`${API}/api/seo/${SITE}${path}`, {

package/dist/blog.d.ts ADDED Viewed

@@ -0,0 +1,44 @@
+export interface SeoBlogMapping {
+    title: string;
+    excerpt?: string;
+    body: string;
+    id?: string;
+    image?: string;
+    published?: string;
+    publishedAt?: string;
+}
+export interface SeoBlogConfig {
+    supabaseUrl: string;
+    anonKey: string;
+    table: string;
+    format: "html" | "minimarkup";
+    locales: string[];
+    mapping: SeoBlogMapping;
+}
+export interface SeoBlogSummary {
+    slug: string;
+    title: string;
+    excerpt: string;
+    cover: string | null;
+    date: string | null;
+}
+export interface SeoBlogPostFull extends SeoBlogSummary {
+    bodyHtml: string;
+}
+export declare function seoBlogList(opts?: {
+    locale?: string;
+    limit?: number;
+}): Promise<SeoBlogSummary[]>;
+export declare function seoBlogPost(slug: string, opts?: {
+    locale?: string;
+}): Promise<SeoBlogPostFull | null>;
+export declare function SeoBlogIndex(props: {
+    locale?: string;
+    basePath?: string;
+    limit?: number;
+    title?: string;
+}): Promise<import("react").JSX.Element | null>;
+export declare function SeoBlogArticle({ post, locale }: {
+    post: SeoBlogPostFull;
+    locale?: string;
+}): import("react").JSX.Element;

package/dist/blog.js ADDED Viewed

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seoBlogList = seoBlogList;
+exports.seoBlogPost = seoBlogPost;
+exports.SeoBlogIndex = SeoBlogIndex;
+exports.SeoBlogArticle = SeoBlogArticle;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// @webnumseoagent/next/blog — рендер блога код-сайта (Фаза 3.1c).
+// Пакет тянет ПУБЛИЧНЫЙ конфиг блога с платформы (config-API /blog: supabaseUrl + anonKey +
+// таблица/формат/локали/маппинг), затем читает ОПУБЛИКОВАННЫЕ статьи прямо из Supabase клиента
+// (anon-ключ + public-read RLS) и рендерит обложку + заголовок + тело (картинки/таблицы/ссылки).
+//
+// Тело статьи уже САНИТАЙЗЕНО на стороне платформы при доставке (Фаза 3.1b), поэтому здесь оно
+// рендерится как HTML (dangerouslySetInnerHTML) — граница доверия проходит по доставке, не по рендеру.
+//
+// Все функции FAIL-SAFE: при ошибке/таймауте возвращают пусто — блог просто не покажет контент,
+// сборка/рендер сайта НИКОГДА не падает.
+//
+// Использование (роуты ставит `npx @webnumseoagent/next init --blog`):
+//   app/blog/page.tsx:            export default () => <SeoBlogIndex title="Блог" />
+//   app/blog/[slug]/page.tsx:     const post = await seoBlogPost(params.slug); if(!post) notFound();
+//                                 return <SeoBlogArticle post={post} />
+const API = process.env.SEOAGENT_API_BASE ?? "";
+const SITE = process.env.SEOAGENT_SITE_ID ?? "";
+const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
+const REVALIDATE = 300;
+function firstLocale(cfg) {
+    return (cfg.locales ?? []).filter(Boolean)[0] ?? "";
+}
+// Публичный конфиг блога с платформы (кэш ISR + тег seo-<site> — сбрасывается ревалидацией).
+async function fetchBlogConfig() {
+    if (!API || !SITE || !TOKEN)
+        return null;
+    try {
+        const r = await fetch(`${API}/api/seo/${SITE}/blog`, {
+            headers: { "x-seo-agent-key": TOKEN },
+            next: { revalidate: REVALIDATE, tags: [`seo-${SITE}`, `seo-blog-${SITE}`] },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!r.ok)
+            return null;
+        const d = (await r.json());
+        const b = d?.blog ?? null;
+        if (!b?.supabaseUrl || !b?.anonKey || !b?.table || !b?.mapping?.title || !b?.mapping?.body)
+            return null;
+        return b;
+    }
+    catch {
+        return null;
+    }
+}
+// Запрос к REST API Supabase клиента (anon). Возвращает массив строк либо null.
+async function supaGet(cfg, url) {
+    try {
+        const r = await fetch(url, {
+            headers: { apikey: cfg.anonKey, Authorization: `Bearer ${cfg.anonKey}` },
+            next: { revalidate: REVALIDATE, tags: [`seo-blog-${SITE}`] },
+            signal: AbortSignal.timeout(6000),
+        });
+        if (!r.ok)
+            return null;
+        const d = await r.json();
+        return Array.isArray(d) ? d : null;
+    }
+    catch {
+        return null;
+    }
+}
+const S = (v) => (v == null ? "" : String(v));
+const base = (cfg) => cfg.supabaseUrl.replace(/\/+$/, "");
+async function fetchPosts(cfg, locale, limit) {
+    const m = cfg.mapping;
+    if (!m.id)
+        return []; // без колонки id/slug ссылки на статьи не построить
+    const suf = locale ? `_${locale}` : "";
+    const titleCol = m.title + suf;
+    const excerptCol = m.excerpt ? m.excerpt + suf : "";
+    const cols = [m.id, titleCol, excerptCol, m.image || "", m.publishedAt || ""].filter(Boolean).join(",");
+    let url = `${base(cfg)}/rest/v1/${encodeURIComponent(cfg.table)}?select=${cols}`;
+    if (m.published)
+        url += `&${m.published}=eq.true`;
+    if (m.publishedAt)
+        url += `&order=${m.publishedAt}.desc`;
+    url += `&limit=${limit}`;
+    const rows = await supaGet(cfg, url);
+    return (rows ?? [])
+        .map((r) => ({
+        slug: S(r[m.id]),
+        title: S(r[titleCol]),
+        excerpt: excerptCol ? S(r[excerptCol]) : "",
+        cover: m.image ? r[m.image] ?? null : null,
+        date: m.publishedAt ? r[m.publishedAt] ?? null : null,
+    }))
+        .filter((p) => p.slug && p.title);
+}
+async function fetchPost(cfg, slug, locale) {
+    const m = cfg.mapping;
+    if (!m.id)
+        return null;
+    const suf = locale ? `_${locale}` : "";
+    let url = `${base(cfg)}/rest/v1/${encodeURIComponent(cfg.table)}?select=*&${m.id}=eq.${encodeURIComponent(slug)}`;
+    if (m.published)
+        url += `&${m.published}=eq.true`;
+    url += `&limit=1`;
+    const rows = await supaGet(cfg, url);
+    const r = rows && rows[0];
+    if (!r)
+        return null;
+    const rawBody = S(r[m.body + suf]);
+    return {
+        slug: S(r[m.id]) || slug,
+        title: S(r[m.title + suf]),
+        excerpt: m.excerpt ? S(r[m.excerpt + suf]) : "",
+        cover: m.image ? r[m.image] ?? null : null,
+        date: m.publishedAt ? r[m.publishedAt] ?? null : null,
+        bodyHtml: cfg.format === "minimarkup" ? miniMarkupToHtml(rawBody) : sanitizeDeliveryHtml(rawBody),
+    };
+}
+// ── Публичные data-функции (для generateMetadata / generateStaticParams) ──
+async function seoBlogList(opts) {
+    const cfg = await fetchBlogConfig();
+    if (!cfg)
+        return [];
+    return fetchPosts(cfg, opts?.locale ?? firstLocale(cfg), opts?.limit ?? 100);
+}
+async function seoBlogPost(slug, opts) {
+    const cfg = await fetchBlogConfig();
+    if (!cfg)
+        return null;
+    return fetchPost(cfg, slug, opts?.locale ?? firstLocale(cfg));
+}
+// ── Мини-разметка (## / - / **) → HTML (для legacy-формата; текст экранируем). ──
+function esc(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function inlineMini(s) {
+    return esc(s).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+}
+function miniMarkupToHtml(src) {
+    const out = [];
+    for (const block of (src || "").split(/\n{2,}/)) {
+        const b = block.trim();
+        if (!b)
+            continue;
+        const lines = b.split("\n");
+        if (lines.every((l) => l.startsWith("- "))) {
+            out.push("<ul>" + lines.map((l) => `<li>${inlineMini(l.slice(2))}</li>`).join("") + "</ul>");
+        }
+        else if (b.startsWith("## ")) {
+            out.push(`<h2>${inlineMini(b.slice(3))}</h2>`);
+        }
+        else {
+            out.push(`<p>${inlineMini(b)}</p>`);
+        }
+    }
+    return out.join("");
+}
+// ── Санитайзер HTML (защита-в-глубину перед dangerouslySetInnerHTML) — ЗЕРКАЛО доставки
+// (src/lib/blog/blog-delivery.ts + Edge blog-autopilot). Тело уже санитайзено при доставке, но
+// если у сайта не настроен RLS (провиженинг опционален) — это последний рубеж. ──
+const SANITIZE_ALLOWED_TAGS = new Set([
+    "h1", "h2", "h3", "h4", "h5", "h6", "p", "br", "hr", "strong", "b", "em", "i", "u", "s",
+    "ul", "ol", "li", "blockquote", "a", "img", "figure", "figcaption",
+    "table", "thead", "tbody", "tfoot", "tr", "th", "td", "caption", "code", "pre", "span", "div",
+]);
+const SANITIZE_ALLOWED_ATTRS = /^(href|src|alt|title|target|rel|width|height|loading|colspan|rowspan|scope|start|type)$/;
+const SANITIZE_VOID = new Set(["br", "hr", "img"]);
+function decodeSchemeEntities(v) {
+    return v
+        .replace(/&#x([0-9a-fA-F]+);?/g, (_m, h) => { try {
+        return String.fromCodePoint(parseInt(h, 16));
+    }
+    catch {
+        return "";
+    } })
+        .replace(/&#(\d+);?/g, (_m, d) => { try {
+        return String.fromCodePoint(parseInt(d, 10));
+    }
+    catch {
+        return "";
+    } })
+        .replace(/&(colon|tab|newline|lf|cr|sol|amp);?/gi, (m) => {
+        const k = m.replace(/[&;]/g, "").toLowerCase();
+        return { colon: ":", sol: "/", amp: "&", tab: " ", newline: " ", lf: " ", cr: " " }[k] ?? " ";
+    });
+}
+function safeUrl(val) {
+    const v = decodeSchemeEntities(val).toLowerCase().replace(/\s/g, "");
+    if (!/^[a-z][a-z0-9+.-]*:/.test(v))
+        return true;
+    return /^(https?:|mailto:|tel:)/.test(v);
+}
+function sanitizeAttrs(tag, attrsRaw) {
+    const out = [];
+    const re = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"'>]+))/g;
+    let m;
+    let href = "";
+    while ((m = re.exec(attrsRaw))) {
+        const name = m[1].toLowerCase();
+        const val = m[3] ?? m[4] ?? m[5] ?? "";
+        if (name.startsWith("on") || name === "style" || name === "srcset")
+            continue;
+        if ((name === "href" || name === "src") && !safeUrl(val))
+            continue;
+        if (!SANITIZE_ALLOWED_ATTRS.test(name))
+            continue;
+        if (name === "href")
+            href = val;
+        out.push(`${name}="${val.replace(/"/g, "&quot;")}"`);
+    }
+    if (tag === "a" && !out.some((a) => a.startsWith("rel="))) {
+        if (/^(https?:)?\/\//i.test(href.trim()))
+            out.push('rel="noopener nofollow"');
+    }
+    return out.length ? " " + out.join(" ") : "";
+}
+function sanitizeDeliveryHtml(html) {
+    let s = html || "";
+    s = s.replace(/<(script|style|iframe|object|embed|form|noscript|template|svg|math)\b[\s\S]*?<\/\1\s*>/gi, "");
+    s = s.replace(/<!--[\s\S]*?-->/g, "");
+    s = s.replace(/<(\/?)([a-zA-Z][a-zA-Z0-9]*)\b((?:"[^"]*"|'[^']*'|[^>])*)>/g, (_full, slash, tag, attrs) => {
+        const t = tag.toLowerCase();
+        if (!SANITIZE_ALLOWED_TAGS.has(t))
+            return "";
+        if (slash)
+            return `</${t}>`;
+        return `<${t}${sanitizeAttrs(t, attrs)}${SANITIZE_VOID.has(t) ? " /" : ""}>`;
+    });
+    return s.trim();
+}
+// ── Компоненты (серверные) ──────────────────────────────────────────────────────────────────
+const BODY_CSS = `.seoagent-blog-body img{max-width:100%;height:auto;border-radius:8px;margin:1rem 0}
+.seoagent-blog-body table{width:100%;border-collapse:collapse;margin:1rem 0;font-size:.95em}
+.seoagent-blog-body th,.seoagent-blog-body td{border:1px solid #e5e7eb;padding:.5rem .75rem;text-align:left}
+.seoagent-blog-body th{background:#f8fafc}
+.seoagent-blog-body h2{margin:1.75rem 0 .75rem;font-size:1.5rem;line-height:1.3}
+.seoagent-blog-body h3{margin:1.4rem 0 .6rem;font-size:1.2rem}
+.seoagent-blog-body p{margin:0 0 1rem}
+.seoagent-blog-body a{color:#2563eb}
+.seoagent-blog-body figure{margin:1.25rem 0}
+.seoagent-blog-body figcaption{color:#94a3b8;font-size:.85em;text-align:center;margin-top:.4rem}
+.seoagent-blog-body blockquote{margin:1rem 0;padding:.5rem 1rem;border-left:3px solid #e5e7eb;color:#475569}`;
+// Список статей блога. Сам тянет конфиг+статьи. Пусто/ошибка → null (ничего не ломаем).
+async function SeoBlogIndex(props) {
+    const cfg = await fetchBlogConfig();
+    if (!cfg)
+        return null;
+    const locale = props.locale ?? firstLocale(cfg);
+    const posts = await fetchPosts(cfg, locale, props.limit ?? 30);
+    if (!posts.length)
+        return null;
+    const basePath = (props.basePath ?? "/blog").replace(/\/+$/, "");
+    return ((0, jsx_runtime_1.jsxs)("div", { style: { maxWidth: 1080, margin: "0 auto", padding: "1.5rem" }, children: [props.title ? (0, jsx_runtime_1.jsx)("h1", { style: { fontSize: "2rem", margin: "0 0 1.5rem" }, children: props.title }) : null, (0, jsx_runtime_1.jsx)("div", { style: { display: "grid", gridTemplateColumns: "repeat(auto-fill, minmax(280px, 1fr))", gap: "1.5rem" }, children: posts.map((p) => ((0, jsx_runtime_1.jsxs)("a", { href: `${basePath}/${p.slug}`, style: { display: "block", textDecoration: "none", color: "inherit", border: "1px solid #e5e7eb", borderRadius: 12, overflow: "hidden" }, children: [p.cover ? (0, jsx_runtime_1.jsx)("img", { src: p.cover, alt: p.title, style: { width: "100%", height: 180, objectFit: "cover", display: "block" } }) : null, (0, jsx_runtime_1.jsxs)("div", { style: { padding: "1rem" }, children: [(0, jsx_runtime_1.jsx)("h2", { style: { fontSize: "1.1rem", margin: "0 0 .5rem", lineHeight: 1.3 }, children: p.title }), p.excerpt ? (0, jsx_runtime_1.jsx)("p", { style: { margin: 0, color: "#64748b", fontSize: ".9rem", lineHeight: 1.5 }, children: p.excerpt }) : null] })] }, p.slug))) })] }));
+}
+// Одна статья. Принимает пост (из seoBlogPost) — так страница может сделать notFound()/метаданные.
+function SeoBlogArticle({ post, locale }) {
+    return ((0, jsx_runtime_1.jsxs)("article", { style: { maxWidth: 760, margin: "0 auto", padding: "1.5rem", lineHeight: 1.7 }, children: [(0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: BODY_CSS } }), post.cover ? (0, jsx_runtime_1.jsx)("img", { src: post.cover, alt: post.title, style: { width: "100%", borderRadius: 12, marginBottom: "1.5rem" } }) : null, (0, jsx_runtime_1.jsx)("h1", { style: { fontSize: "2.2rem", lineHeight: 1.2, margin: "0 0 1rem" }, children: post.title }), post.date ? (0, jsx_runtime_1.jsx)("p", { style: { color: "#94a3b8", margin: "0 0 1.5rem" }, children: fmtDate(post.date, locale) }) : null, (0, jsx_runtime_1.jsx)("div", { className: "seoagent-blog-body", dangerouslySetInnerHTML: { __html: post.bodyHtml } })] }));
+}
+function fmtDate(d, locale) {
+    try {
+        return new Date(d).toLocaleDateString(locale || undefined, { year: "numeric", month: "long", day: "numeric" });
+    }
+    catch {
+        return "";
+    }
+}

package/dist/client.js CHANGED Viewed

@@ -262,7 +262,7 @@ async function seoSitemapXml(path) {
 //   export async function GET() { return new Response(await seoMerchantFeedXml("/merchant-feed.xml"), {headers:{"content-type":"application/xml"}}) }
 async function seoMerchantFeedXml(path) {
     // Валидный RSS-канал (title/link/description обязательны в RSS 2.0) с пустым списком товаров.
-    const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">\n<channel>\n  <title>Merchant feed</title>\n  <link>https://seonum.uz</link>\n  <description>Merchant feed temporarily unavailable</description>\n</channel>\n</rss>\n`;
+    const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">\n<channel>\n  <title>Merchant feed</title>\n  <link></link>\n  <description>Merchant feed temporarily unavailable</description>\n</channel>\n</rss>\n`;
     if (!API || !SITE || !TOKEN)
         return FALLBACK;
     try {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.25",
+  "version": "0.2.1",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",
@@ -23,6 +23,10 @@
     "./analytics": {
       "types": "./dist/analytics.d.ts",
       "default": "./dist/analytics.js"
+    },
+    "./blog": {
+      "types": "./dist/blog.d.ts",
+      "default": "./dist/blog.js"
     }
   },
   "files": [
@@ -30,6 +34,7 @@
     "client.ts",
     "jsonld.tsx",
     "analytics.tsx",
+    "blog.tsx",
     "sitemap-xsl.ts",
     "sitemap-build.ts",
     "redirects.ts",