npm - @webnumseoagent/next - Versions diffs - 0.1.24 → 0.2.0 - Mend

@webnumseoagent/next 0.1.24 → 0.2.0

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 (8) hide show

package/bin/cli.mjs CHANGED Viewed

@@ -97,13 +97,17 @@ async function init() {
     ok("Пакет @webnumseoagent/next установлен — импорт из пакета.");
   } else {
     const vendor = path.join(root, "seoagent");
-    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts"]) {
+    await fs.mkdir(vendor, { recursive: true });
+    // Вендор-файлы адаптера — генерируемые (их не правят руками): при повторном init ОБНОВЛЯЕМ,
+    // если содержимое изменилось. Иначе апгрейд оставит старый client.ts без новых экспортов
+    // (напр. seoMerchantFeedXml), а свежесозданный роут импортнёт несуществующий символ → build падёт.
+    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts", "blog.tsx"]) {
       const dest = path.join(vendor, f);
-      if (!(await exists(dest))) {
-        await fs.mkdir(vendor, { recursive: true });
-        await fs.copyFile(path.join(pkgRoot, f), dest);
-        ok(`seoagent/${f}`);
-      } else skip(`seoagent/${f}`);
+      const src = await fs.readFile(path.join(pkgRoot, f));
+      const cur = await fs.readFile(dest).catch(() => null);
+      if (cur && cur.equals(src)) { skip(`seoagent/${f}`); continue; }
+      await fs.writeFile(dest, src);
+      ok(`seoagent/${f}${cur ? " (обновлён)" : ""}`);
     }
     const imp = importPath(appDir, "sitemap.ts");
     importClient = `${imp}/client`;
@@ -113,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/, отдельный роут и т.п.) —
   // чтобы не перекрыть существующую карту сайта пустой.
@@ -231,6 +236,14 @@ async function init() {
     `import { seoIndexNowKey } from "${clientFor("seoagent-indexnow.txt/route.ts")}";\nexport const dynamic = "force-dynamic";\nexport async function GET() {\n  return new Response(await seoIndexNowKey(), { headers: { "content-type": "text/plain; charset=utf-8" } });\n}\n`,
   );
+  // 4.3 Google Merchant Center — товарный фид /seoagent-merchant-feed.xml (RSS 2.0 + g:).
+  // Адаптер лишь проксирует XML с платформы (та собирает его из индекса товаров сайта).
+  // Пустой валидный RSS, пока фид не включён в настройках — роут никогда не отдаёт 404.
+  await ensureFile(
+    path.join(root, appDir, `seoagent-merchant-feed.xml/route.${ext}`),
+    `import { seoMerchantFeedXml } from "${clientFor("seoagent-merchant-feed.xml/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoMerchantFeedXml("/merchant-feed.xml"), { headers: { "content-type": "application/xml; charset=utf-8", "x-seoagent-merchant": "1" } });\n}\n`,
+  );
   // 4.5 middleware (переадресации). Next разрешает ОДИН middleware, а авто-слияние чужого
   // небезопасно → создаём свой, только если своего нет; иначе печатаем ручную инструкцию.
   {
@@ -356,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");
 }
@@ -408,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

@@ -254,6 +254,27 @@ export async function seoSitemapXml(path: string): Promise<string> {
   }
 }
+// Товарный фид Google Merchant Center (RSS 2.0 + g:-namespace): сырой XML с платформы.
+// Платформа собирает его из закэшированного индекса товаров (быстро, без живого краула).
+// app/seoagent-merchant-feed.xml/route.ts:
+//   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`;
+  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(8000),
+    });
+    if (!r.ok) return FALLBACK;
+    return await r.text();
+  } catch {
+    return FALLBACK;
+  }
+}
 export { SITEMAP_XSL } from "./sitemap-xsl";
 export { seoWrapSitemap } from "./sitemap-build";

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.d.ts CHANGED Viewed

@@ -5,6 +5,7 @@ export declare function seoMeta(opts: {
     fallback?: Metadata;
 }): Promise<Metadata>;
 export declare function seoSitemapXml(path: string): Promise<string>;
+export declare function seoMerchantFeedXml(path: string): Promise<string>;
 export { SITEMAP_XSL } from "./sitemap-xsl";
 export { seoWrapSitemap } from "./sitemap-build";
 export declare function seoSitemap(): Promise<MetadataRoute.Sitemap>;

package/dist/client.js CHANGED Viewed

@@ -14,6 +14,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.seoWrapSitemap = exports.SITEMAP_XSL = void 0;
 exports.seoMeta = seoMeta;
 exports.seoSitemapXml = seoSitemapXml;
+exports.seoMerchantFeedXml = seoMerchantFeedXml;
 exports.seoSitemap = seoSitemap;
 exports.seoRobots = seoRobots;
 exports.seoRobotsTxt = seoRobotsTxt;
@@ -255,6 +256,29 @@ async function seoSitemapXml(path) {
         return FALLBACK;
     }
 }
+// Товарный фид Google Merchant Center (RSS 2.0 + g:-namespace): сырой XML с платформы.
+// Платформа собирает его из закэшированного индекса товаров (быстро, без живого краула).
+// app/seoagent-merchant-feed.xml/route.ts:
+//   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`;
+    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(8000),
+        });
+        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; } });
 var sitemap_build_1 = require("./sitemap-build");

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.24",
+  "version": "0.2.0",
   "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",