@webnumseoagent/next 0.1.11 → 0.1.14

package/bin/cli.mjs

@@ -97,7 +97,7 @@ 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"]) {
+    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts"]) {
       const dest = path.join(vendor, f);
       if (!(await exists(dest))) {
         await fs.mkdir(vendor, { recursive: true });
@@ -224,6 +224,65 @@ async function init() {
     `import { revalidateTag } from "next/cache";\n\nexport async function POST(req${ext === "ts" ? ": Request" : ""}) {\n  if (req.headers.get("x-revalidate-secret") !== process.env.SEOAGENT_REVALIDATE_SECRET) {\n    return new Response("unauthorized", { status: 401 });\n  }\n  revalidateTag(\`seo-\${process.env.SEOAGENT_SITE_ID}\`);\n  return Response.json({ ok: true });\n}\n`,
   );
 
+  // 4.5 middleware (переадресации). Next разрешает ОДИН middleware, а авто-слияние чужого
+  // небезопасно → создаём свой, только если своего нет; иначе печатаем ручную инструкцию.
+  {
+    const MW_MATCHER = '"/((?!api|_next/static|_next/image|favicon.ico|.*\\\\..*).*)"';
+    const mwBase = appDir === "src/app" ? "src" : "."; // middleware рядом с app/
+    const mwDirAbs = path.join(root, mwBase === "." ? "" : mwBase);
+    const existing = [];
+    for (const b of [".", "src"]) {
+      for (const f of ["middleware.ts", "middleware.js"]) {
+        const rel = b === "." ? f : `${b}/${f}`;
+        if (await exists(path.join(root, rel))) existing.push(rel);
+      }
+    }
+    const redirImport = pkgMode
+      ? "@webnumseoagent/next/redirects"
+      : (() => {
+          let rel = path.relative(mwDirAbs, path.join(root, "seoagent")).split(path.sep).join("/");
+          if (!rel.startsWith(".")) rel = "./" + rel;
+          return `${rel}/redirects`;
+        })();
+
+    if (existing.length) {
+      log(`\n  \x1b[1mmiddleware уже есть (${existing.join(", ")})\x1b[0m — добавь переадресации ВРУЧНУЮ (Next разрешает один middleware):`);
+      log(`    \x1b[36mimport { seoRedirects } from "${redirImport}";\x1b[0m`);
+      log(`    1) первым в функции middleware:  \x1b[36mconst r = await seoRedirects(request); if (r) return r;\x1b[0m`);
+      log(`    2) добавь в config.matcher:  \x1b[36m${MW_MATCHER}\x1b[0m`);
+      log(`    3) если middleware делает auth — оставь свою логику scoped (напр. if(!path.startsWith("/admin")) return NextResponse.next()).`);
+      log(`       \x1b[1mAuth-чувствительно: проверь git diff и вход перед деплоем.\x1b[0m`);
+    } else {
+      const mwPath = path.join(mwDirAbs, `middleware.${ext}`);
+      const body =
+        ext === "ts"
+          ? `import { NextResponse, type NextRequest } from "next/server";\nimport { seoRedirects } from "${redirImport}";\n\nexport async function middleware(request: NextRequest) {\n  const redirect = await seoRedirects(request);\n  if (redirect) return redirect;\n  return NextResponse.next();\n}\n\nexport const config = { matcher: [${MW_MATCHER}] };\n`
+          : `import { NextResponse } from "next/server";\nimport { seoRedirects } from "${redirImport}";\n\nexport async function middleware(request) {\n  const redirect = await seoRedirects(request);\n  if (redirect) return redirect;\n  return NextResponse.next();\n}\n\nexport const config = { matcher: [${MW_MATCHER}] };\n`;
+      await ensureFile(mwPath, body);
+    }
+  }
+
+  // 4.6 Мониторинг 404: роут-приёмник на сайте (форвардит хит в платформу с СЕРВЕРНЫМ
+  // токеном) + not-found-репортер (клиентский маячок с путём 404). Репортер отдаём сырым
+  // исходником (client-компонент из dist пакета не работает — tsc ставит "use strict" первой).
+  {
+    const reqType = ext === "ts" ? ": Request" : "";
+    const fwd = `export async function POST(req${reqType}) {\n  const origin = req.headers.get("origin"), host = req.headers.get("host");\n  if (origin && host) { try { if (new URL(origin).host !== host) return new Response(null, { status: 204 }); } catch { return new Response(null, { status: 204 }); } }\n  const API = process.env.SEOAGENT_API_BASE, SITE = process.env.SEOAGENT_SITE_ID, TOKEN = process.env.SEOAGENT_TOKEN;\n  if (!API || !SITE || !TOKEN) return new Response(null, { status: 204 });\n  let path = "";\n  try { const b = await req.json(); if (typeof b?.path === "string") path = b.path; } catch {}\n  if (!path) return new Response(null, { status: 204 });\n  try { await fetch(\`\${API}/api/seo/\${SITE}/not-found\`, { method: "POST", headers: { "content-type": "application/json", "x-seo-agent-key": TOKEN }, body: JSON.stringify({ path }), signal: AbortSignal.timeout(5000) }); } catch {}\n  return new Response(null, { status: 204 });\n}\n`;
+    await ensureFile(path.join(root, appDir, `api/seoagent-404/route.${ext}`), fwd);
+
+    const reporter = `"use client";\n\nimport Link from "next/link";\nimport { usePathname } from "next/navigation";\nimport { useEffect, useRef } from "react";\n\n// Страница 404 + репортер для «Мониторинг 404» (SEO Agent).\nexport default function NotFound() {\n  const pathname = usePathname();\n  const lastSent = useRef(null);\n  useEffect(() => {\n    const p = pathname || window.location.pathname;\n    if (lastSent.current === p) return;\n    lastSent.current = p;\n    try {\n      const body = JSON.stringify({ path: p });\n      if (navigator.sendBeacon) navigator.sendBeacon("/api/seoagent-404", new Blob([body], { type: "application/json" }));\n      else fetch("/api/seoagent-404", { method: "POST", headers: { "content-type": "application/json" }, body, keepalive: true }).catch(() => {});\n    } catch {}\n  }, [pathname]);\n  return (\n    <main style={{ minHeight: "60vh", display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", gap: "1rem", padding: "2rem", textAlign: "center" }}>\n      <h1 style={{ fontSize: "3rem", margin: 0 }}>404</h1>\n      <p style={{ color: "#64748b", margin: 0 }}>Страница не найдена.</p>\n      <Link href="/" style={{ color: "#2563eb" }}>На главную</Link>\n    </main>\n  );\n}\n`;
+    const nfExt = ext === "ts" ? "tsx" : "js";
+    const hasNotFound = await anyExists([
+      `${appDir}/not-found.js`, `${appDir}/not-found.jsx`, `${appDir}/not-found.ts`, `${appDir}/not-found.tsx`,
+    ]);
+    if (hasNotFound) {
+      log(`\n  \x1b[1mnot-found уже есть\x1b[0m — добавь репортер 404 (Мониторинг 404) в свой not-found:`);
+      log(`    \x1b[36m"use client"; ... useEffect(() => { navigator.sendBeacon?.("/api/seoagent-404", new Blob([JSON.stringify({ path: location.pathname })], { type: "application/json" })); }, []);\x1b[0m`);
+    } else {
+      await ensureFile(path.join(root, appDir, `not-found.${nfExt}`), reporter);
+    }
+  }
+
   // 5. .env.local
   const envPath = path.join(root, ".env.local");
   const cur = (await exists(envPath)) ? await fs.readFile(envPath, "utf8") : "";

package/client.ts

@@ -24,6 +24,7 @@ interface SeoFields {
   og?: { title?: string; description?: string; image?: string };
   twitter?: { card?: string; image?: string };
   jsonLd?: unknown[];
+  verification?: Record<string, string>; // проверочные мета-теги: metaName → content
 }
 
 async function fetchJson<T>(path: string, revalidate = 300): Promise<T | null> {
@@ -75,6 +76,11 @@ function mergeIntoMetadata(fallback: Metadata, f: SeoFields): Metadata {
       ...(f.twitter.image ? { images: [f.twitter.image] } : {}),
     };
   }
+  // Проверочные мета-теги веб-мастерских → <meta name content> через metadata.other.
+  // Мержим, не затирая существующий other сайта.
+  if (f.verification && typeof f.verification === "object") {
+    m.other = { ...(m.other ?? {}), ...f.verification };
+  }
   return m;
 }
 

package/dist/client.js

@@ -75,6 +75,11 @@ function mergeIntoMetadata(fallback, f) {
             ...(f.twitter.image ? { images: [f.twitter.image] } : {}),
         };
     }
+    // Проверочные мета-теги веб-мастерских → <meta name content> через metadata.other.
+    // Мержим, не затирая существующий other сайта.
+    if (f.verification && typeof f.verification === "object") {
+        m.other = { ...(m.other ?? {}), ...f.verification };
+    }
     return m;
 }
 // В generateMetadata: const md = await seoMeta({ route, locale, fallback: compiled });

package/dist/redirects.d.ts

@@ -0,0 +1,2 @@
+import { NextResponse, type NextRequest } from "next/server";
+export declare function seoRedirects(request: NextRequest): Promise<NextResponse | null>;

package/dist/redirects.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seoRedirects = seoRedirects;
+// Рантайм-переадресации для Next.js middleware (Edge). Тянет активные правила с
+// платформы и применяет к входящему запросу. Отдельный сабпас "@webnumseoagent/next/redirects",
+// чтобы Edge-код не попадал в RSC-бандлы.
+//
+// В Edge middleware Next Data Cache (next:{revalidate,tags}) НЕ работает и revalidateTag
+// сюда не достаёт — поэтому кэшируем правила модульным TTL (переживает жизнь изолята).
+// Правки на платформе применяются в пределах TTL (~минута), не мгновенно.
+//
+// FAIL-SAFE: при любой ошибке / отсутствии env возвращаем null — сайт работает как обычно.
+const server_1 = require("next/server");
+const API = process.env.SEOAGENT_API_BASE ?? "";
+const SITE = process.env.SEOAGENT_SITE_ID ?? "";
+const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
+const TTL_OK = 60000; // успех — правила живут минуту
+const TTL_FAIL = 10000; // ошибка — быстрее повторить, но не долбить
+const FETCH_TIMEOUT = 2000; // middleware на горячем пути каждого запроса — таймаут короткий
+const MAX_PATTERN = 200;
+const MAX_PATH = 2000;
+const is3xx = (c) => c === 301 || c === 302 || c === 307;
+function normPath(p) {
+    let s = p;
+    try {
+        s = decodeURIComponent(p);
+    }
+    catch {
+        /* битый % — оставляем как есть */
+    }
+    if (s.length > MAX_PATH)
+        s = s.slice(0, MAX_PATH);
+    if (s.length > 1)
+        s = s.replace(/\/+$/, "") || "/";
+    return s;
+}
+function normSource(v) {
+    let s = (v ?? "").trim();
+    if (!s)
+        return s;
+    if (/^https?:\/\//i.test(s))
+        return s.replace(/\/+$/, "");
+    if (!s.startsWith("/"))
+        s = "/" + s;
+    return s.length > 1 ? s.replace(/\/+$/, "") : s;
+}
+function compile(rules) {
+    const out = [];
+    for (const r of rules) {
+        if (!r || r.active === false)
+            continue;
+        const code = Number(r.code);
+        if (is3xx(code) && !r.destination)
+            continue; // 3xx без назначения бессмысленно
+        if (![301, 302, 307, 410, 451].includes(code))
+            continue;
+        const tests = [];
+        for (const src of r.sources ?? []) {
+            const raw = (src?.value ?? "").trim();
+            if (!raw || raw.length > MAX_PATTERN)
+                continue;
+            const ci = src.ignoreCase !== false; // по умолчанию регистронезависимо
+            if (src.type === "regex") {
+                try {
+                    const re = new RegExp(raw, ci ? "i" : ""); // компилируем ОДИН раз
+                    tests.push((p) => re.test(p));
+                }
+                catch {
+                    /* битый regex — пропускаем только этот источник */
+                }
+            }
+            else {
+                // exact/start — пути (нормализуем как путь); contains/end — под-строка/суффикс
+                // (берём как есть, только trim), иначе навязанный '/' ломает совпадение (".html").
+                const norm = src.type === "exact" || src.type === "start" ? normSource(raw) : raw.trim();
+                const v = ci ? norm.toLowerCase() : norm;
+                const f = (p) => (ci ? p.toLowerCase() : p);
+                if (src.type === "exact")
+                    tests.push((p) => f(p) === v);
+                else if (src.type === "contains")
+                    tests.push((p) => f(p).includes(v));
+                else if (src.type === "start")
+                    tests.push((p) => f(p).startsWith(v));
+                else if (src.type === "end")
+                    tests.push((p) => f(p).endsWith(v));
+            }
+        }
+        if (tests.length)
+            out.push({ test: (p) => tests.some((t) => t(p)), destination: r.destination, code });
+    }
+    return out;
+}
+let cache = null;
+let inflight = null;
+async function loadRules() {
+    if (!API || !SITE || !TOKEN)
+        return null;
+    try {
+        const r = await fetch(`${API}/api/seo/${SITE}/redirects`, {
+            headers: { "x-seo-agent-key": TOKEN },
+            signal: AbortSignal.timeout(FETCH_TIMEOUT),
+            // без next:{revalidate,tags} — в Edge middleware не действуют
+        });
+        if (!r.ok)
+            return null;
+        const body = (await r.json());
+        const raw = Array.isArray(body) ? body : (body?.rules ?? []);
+        return compile(Array.isArray(raw) ? raw : []);
+    }
+    catch {
+        return null;
+    }
+}
+async function getRules() {
+    const now = Date.now();
+    if (cache && now - cache.at < cache.ttl)
+        return cache.rules;
+    if (inflight)
+        return inflight; // дедуп конкурентных промахов на холодном изоляте
+    inflight = loadRules()
+        .then((rules) => {
+        cache = { at: Date.now(), ttl: rules === null ? TTL_FAIL : TTL_OK, rules };
+        inflight = null;
+        return rules;
+    })
+        .catch(() => {
+        inflight = null;
+        return cache?.rules ?? null;
+    });
+    return inflight;
+}
+// Вызывать ПЕРВЫМ в middleware: `const r = await seoRedirects(request); if (r) return r;`
+async function seoRedirects(request) {
+    try {
+        const rules = await getRules();
+        if (!rules || rules.length === 0)
+            return null;
+        const path = normPath(request.nextUrl.pathname);
+        for (const rule of rules) {
+            if (!rule.test(path))
+                continue;
+            if (rule.code === 410 || rule.code === 451) {
+                const msg = rule.code === 410 ? "410 Gone" : "451 Unavailable For Legal Reasons";
+                return new server_1.NextResponse(msg, { status: rule.code, headers: { "content-type": "text/plain; charset=utf-8" } });
+            }
+            const abs = /^https?:\/\//i.test(rule.destination);
+            const target = abs ? new URL(rule.destination) : new URL(rule.destination, request.url);
+            // Защита от петли: назначение = текущий путь того же origin — пропускаем.
+            if (target.origin === request.nextUrl.origin && normPath(target.pathname) === path)
+                continue;
+            // Сохраняем входящий query, если у назначения своего нет.
+            if (!target.search && request.nextUrl.search)
+                target.search = request.nextUrl.search;
+            return server_1.NextResponse.redirect(target, rule.code);
+        }
+        return null;
+    }
+    catch {
+        return null; // любая ошибка → сайт продолжает работать
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.11",
+  "version": "0.1.14",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",
@@ -15,6 +15,10 @@
     "./jsonld": {
       "types": "./dist/jsonld.d.ts",
       "default": "./dist/jsonld.js"
+    },
+    "./redirects": {
+      "types": "./dist/redirects.d.ts",
+      "default": "./dist/redirects.js"
     }
   },
   "files": [
@@ -23,6 +27,7 @@
     "jsonld.tsx",
     "sitemap-xsl.ts",
     "sitemap-build.ts",
+    "redirects.ts",
     "bin",
     "README.md"
   ],

package/redirects.ts

@@ -0,0 +1,166 @@
+// Рантайм-переадресации для Next.js middleware (Edge). Тянет активные правила с
+// платформы и применяет к входящему запросу. Отдельный сабпас "@webnumseoagent/next/redirects",
+// чтобы Edge-код не попадал в RSC-бандлы.
+//
+// В Edge middleware Next Data Cache (next:{revalidate,tags}) НЕ работает и revalidateTag
+// сюда не достаёт — поэтому кэшируем правила модульным TTL (переживает жизнь изолята).
+// Правки на платформе применяются в пределах TTL (~минута), не мгновенно.
+//
+// FAIL-SAFE: при любой ошибке / отсутствии env возвращаем null — сайт работает как обычно.
+import { NextResponse, type NextRequest } from "next/server";
+
+const API = process.env.SEOAGENT_API_BASE ?? "";
+const SITE = process.env.SEOAGENT_SITE_ID ?? "";
+const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
+
+type MatchType = "exact" | "contains" | "start" | "end" | "regex";
+interface Source {
+  value: string;
+  type: MatchType;
+  ignoreCase?: boolean;
+}
+interface RawRule {
+  id?: string;
+  sources: Source[];
+  destination: string;
+  code: number;
+  active?: boolean;
+}
+interface CompiledRule {
+  test: (path: string) => boolean;
+  destination: string;
+  code: number;
+}
+
+const TTL_OK = 60_000; // успех — правила живут минуту
+const TTL_FAIL = 10_000; // ошибка — быстрее повторить, но не долбить
+const FETCH_TIMEOUT = 2_000; // middleware на горячем пути каждого запроса — таймаут короткий
+const MAX_PATTERN = 200;
+const MAX_PATH = 2_000;
+
+const is3xx = (c: number) => c === 301 || c === 302 || c === 307;
+
+function normPath(p: string): string {
+  let s = p;
+  try {
+    s = decodeURIComponent(p);
+  } catch {
+    /* битый % — оставляем как есть */
+  }
+  if (s.length > MAX_PATH) s = s.slice(0, MAX_PATH);
+  if (s.length > 1) s = s.replace(/\/+$/, "") || "/";
+  return s;
+}
+
+function normSource(v: string): string {
+  let s = (v ?? "").trim();
+  if (!s) return s;
+  if (/^https?:\/\//i.test(s)) return s.replace(/\/+$/, "");
+  if (!s.startsWith("/")) s = "/" + s;
+  return s.length > 1 ? s.replace(/\/+$/, "") : s;
+}
+
+function compile(rules: RawRule[]): CompiledRule[] {
+  const out: CompiledRule[] = [];
+  for (const r of rules) {
+    if (!r || r.active === false) continue;
+    const code = Number(r.code);
+    if (is3xx(code) && !r.destination) continue; // 3xx без назначения бессмысленно
+    if (![301, 302, 307, 410, 451].includes(code)) continue;
+
+    const tests: Array<(p: string) => boolean> = [];
+    for (const src of r.sources ?? []) {
+      const raw = (src?.value ?? "").trim();
+      if (!raw || raw.length > MAX_PATTERN) continue;
+      const ci = src.ignoreCase !== false; // по умолчанию регистронезависимо
+      if (src.type === "regex") {
+        try {
+          const re = new RegExp(raw, ci ? "i" : ""); // компилируем ОДИН раз
+          tests.push((p) => re.test(p));
+        } catch {
+          /* битый regex — пропускаем только этот источник */
+        }
+      } else {
+        // exact/start — пути (нормализуем как путь); contains/end — под-строка/суффикс
+        // (берём как есть, только trim), иначе навязанный '/' ломает совпадение (".html").
+        const norm = src.type === "exact" || src.type === "start" ? normSource(raw) : raw.trim();
+        const v = ci ? norm.toLowerCase() : norm;
+        const f = (p: string) => (ci ? p.toLowerCase() : p);
+        if (src.type === "exact") tests.push((p) => f(p) === v);
+        else if (src.type === "contains") tests.push((p) => f(p).includes(v));
+        else if (src.type === "start") tests.push((p) => f(p).startsWith(v));
+        else if (src.type === "end") tests.push((p) => f(p).endsWith(v));
+      }
+    }
+    if (tests.length) out.push({ test: (p) => tests.some((t) => t(p)), destination: r.destination, code });
+  }
+  return out;
+}
+
+let cache: { at: number; ttl: number; rules: CompiledRule[] | null } | null = null;
+let inflight: Promise<CompiledRule[] | null> | null = null;
+
+async function loadRules(): Promise<CompiledRule[] | null> {
+  if (!API || !SITE || !TOKEN) return null;
+  try {
+    const r = await fetch(`${API}/api/seo/${SITE}/redirects`, {
+      headers: { "x-seo-agent-key": TOKEN },
+      signal: AbortSignal.timeout(FETCH_TIMEOUT),
+      // без next:{revalidate,tags} — в Edge middleware не действуют
+    });
+    if (!r.ok) return null;
+    const body = (await r.json()) as { rules?: RawRule[] } | RawRule[] | null;
+    const raw = Array.isArray(body) ? body : (body?.rules ?? []);
+    return compile(Array.isArray(raw) ? raw : []);
+  } catch {
+    return null;
+  }
+}
+
+async function getRules(): Promise<CompiledRule[] | null> {
+  const now = Date.now();
+  if (cache && now - cache.at < cache.ttl) return cache.rules;
+  if (inflight) return inflight; // дедуп конкурентных промахов на холодном изоляте
+  inflight = loadRules()
+    .then((rules) => {
+      cache = { at: Date.now(), ttl: rules === null ? TTL_FAIL : TTL_OK, rules };
+      inflight = null;
+      return rules;
+    })
+    .catch(() => {
+      inflight = null;
+      return cache?.rules ?? null;
+    });
+  return inflight;
+}
+
+// Вызывать ПЕРВЫМ в middleware: `const r = await seoRedirects(request); if (r) return r;`
+export async function seoRedirects(request: NextRequest): Promise<NextResponse | null> {
+  try {
+    const rules = await getRules();
+    if (!rules || rules.length === 0) return null;
+    const path = normPath(request.nextUrl.pathname);
+
+    for (const rule of rules) {
+      if (!rule.test(path)) continue;
+
+      if (rule.code === 410 || rule.code === 451) {
+        const msg = rule.code === 410 ? "410 Gone" : "451 Unavailable For Legal Reasons";
+        return new NextResponse(msg, { status: rule.code, headers: { "content-type": "text/plain; charset=utf-8" } });
+      }
+
+      const abs = /^https?:\/\//i.test(rule.destination);
+      const target = abs ? new URL(rule.destination) : new URL(rule.destination, request.url);
+
+      // Защита от петли: назначение = текущий путь того же origin — пропускаем.
+      if (target.origin === request.nextUrl.origin && normPath(target.pathname) === path) continue;
+
+      // Сохраняем входящий query, если у назначения своего нет.
+      if (!target.search && request.nextUrl.search) target.search = request.nextUrl.search;
+      return NextResponse.redirect(target, rule.code);
+    }
+    return null;
+  } catch {
+    return null; // любая ошибка → сайт продолжает работать
+  }
+}