npm - @webnumseoagent/next - Versions diffs - 0.1.15 → 0.1.17 - Mend

@webnumseoagent/next 0.1.15 → 0.1.17

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/analytics.tsx ADDED Viewed

@@ -0,0 +1,73 @@
+// Серверный компонент: вставляет счётчики аналитики (GA4 / Google Tag Manager / Яндекс.Метрика).
+// Скрипты рендерятся в SSR-HTML и выполняются браузером при загрузке. Смонтируй ОДИН раз в layout:
+//   import { SeoAnalytics } from "@webnumseoagent/next/analytics";
+//   <body>… <SeoAnalytics /> …</body>
+// Fail-safe: платформа недоступна → seoAnalytics() вернёт {} → ничего не рендерим.
+import { seoAnalytics } from "./client";
+// ID валидируются на платформе (saveAnalytics), но санитайзим и здесь (defense-in-depth):
+// значения попадают в inline-скрипт, поэтому пропускаем только ожидаемый набор символов.
+// typeof-гард: /config — недоверенный источник, нестроковое значение НЕ должно ронять рендер.
+const ga4Id = (s?: string) => (typeof s === "string" && /^G-[A-Z0-9]+$/i.test(s.trim()) ? s.trim() : "");
+const gtmId = (s?: string) => (typeof s === "string" && /^GTM-[A-Z0-9]+$/i.test(s.trim()) ? s.trim() : "");
+// Метрика вставляется как ЧИСЛОВОЙ литерал — срезаем ведущие нули (иначе sloppy-mode парсит как octal).
+const ymId = (s?: string) => (typeof s === "string" && /^\d+$/.test(s.trim()) ? s.trim().replace(/^0+(?=\d)/, "") : "");
+export async function SeoAnalytics({ route, locale }: { route?: string; locale?: string } = {}) {
+  const a = await seoAnalytics(route ?? "/", locale);
+  const ga4 = ga4Id(a.ga4);
+  const gtm = gtmId(a.gtm);
+  const ym = ymId(a.metrica);
+  if (!ga4 && !gtm && !ym) return null;
+  return (
+    <>
+      {gtm && (
+        <>
+          <script
+            // eslint-disable-next-line react/no-danger
+            dangerouslySetInnerHTML={{
+              __html: `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','${gtm}');`,
+            }}
+          />
+          <noscript>
+            <iframe
+              src={`https://www.googletagmanager.com/ns.html?id=${gtm}`}
+              height="0"
+              width="0"
+              style={{ display: "none", visibility: "hidden" }}
+            />
+          </noscript>
+        </>
+      )}
+      {ga4 && (
+        <>
+          <script async src={`https://www.googletagmanager.com/gtag/js?id=${ga4}`} />
+          <script
+            // eslint-disable-next-line react/no-danger
+            dangerouslySetInnerHTML={{
+              __html: `window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','${ga4}');`,
+            }}
+          />
+        </>
+      )}
+      {ym && (
+        <>
+          <script
+            // eslint-disable-next-line react/no-danger
+            dangerouslySetInnerHTML={{
+              __html: `(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};m[i].l=1*new Date();for(var j=0;j<document.scripts.length;j++){if(document.scripts[j].src===r){return;}}k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})(window,document,"script","https://mc.yandex.ru/metrika/tag.js","ym");ym(${ym},"init",{clickmap:true,trackLinks:true,accurateTrackBounce:true,webvisor:true});`,
+            }}
+          />
+          <noscript>
+            <div>
+              <img src={`https://mc.yandex.ru/watch/${ym}`} style={{ position: "absolute", left: "-9999px" }} alt="" />
+            </div>
+          </noscript>
+        </>
+      )}
+    </>
+  );
+}

package/client.ts CHANGED Viewed

@@ -21,10 +21,12 @@ interface SeoFields {
   description?: string;
   canonical?: string;
   robots?: { index?: boolean; follow?: boolean };
-  og?: { title?: string; description?: string; image?: string };
-  twitter?: { card?: string; image?: string };
+  og?: { title?: string; description?: string; image?: string; siteName?: string; locale?: string };
+  twitter?: { card?: string; image?: string; site?: string };
+  facebook?: { appId?: string; admins?: string }; // fb:app_id / fb:admins (admins — через запятую)
   jsonLd?: unknown[];
   verification?: Record<string, string>; // проверочные мета-теги: metaName → content
+  analytics?: { ga4?: string; gtm?: string; metrica?: string }; // счётчики (см. analytics.tsx)
 }
 async function fetchJson<T>(path: string, revalidate = 300): Promise<T | null> {
@@ -67,6 +69,8 @@ function mergeIntoMetadata(fallback: Metadata, f: SeoFields): Metadata {
       ...(f.og.title ? { title: f.og.title } : {}),
       ...(f.og.description ? { description: f.og.description } : {}),
       ...(f.og.image ? { images: [f.og.image] } : {}),
+      ...(f.og.siteName ? { siteName: f.og.siteName } : {}),
+      ...(f.og.locale ? { locale: f.og.locale } : {}),
     };
   }
   if (f.twitter) {
@@ -74,8 +78,19 @@ function mergeIntoMetadata(fallback: Metadata, f: SeoFields): Metadata {
       ...(m.twitter ?? {}),
       ...(f.twitter.card ? { card: f.twitter.card as "summary" | "summary_large_image" } : {}),
       ...(f.twitter.image ? { images: [f.twitter.image] } : {}),
+      ...(f.twitter.site ? { site: f.twitter.site } : {}),
     };
   }
+  // fb:app_id / fb:admins — только через нативный metadata.facebook (property=, не name=).
+  // Тип Next — union (appId XOR admins), поэтому собираем объект и приводим к типу.
+  if (f.facebook && (f.facebook.appId || f.facebook.admins)) {
+    const admins = (f.facebook.admins ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    m.facebook = {
+      ...(m.facebook ?? {}), // как и остальные блоки — накладываемся поверх дефолта сайта, не затирая его
+      ...(f.facebook.appId ? { appId: f.facebook.appId } : {}),
+      ...(admins.length ? { admins: admins.length === 1 ? admins[0] : admins } : {}),
+    } as Metadata["facebook"];
+  }
   // Проверочные мета-теги веб-мастерских → <meta name content> через metadata.other.
   // Мержим, не затирая существующий other сайта.
   if (f.verification && typeof f.verification === "object") {
@@ -168,3 +183,11 @@ export async function seoJsonLd(route: string, locale?: string): Promise<unknown
   );
   return data?.fields?.jsonLd ?? [];
 }
+// Счётчики аналитики (общесайтовые). Читаются в analytics.tsx (<SeoAnalytics/>).
+export async function seoAnalytics(route = "/", locale?: string): Promise<{ ga4?: string; gtm?: string; metrica?: string }> {
+  const data = await fetchJson<{ fields: SeoFields }>(
+    `/config?route=${encodeURIComponent(route)}&locale=${encodeURIComponent(locale ?? "")}`,
+  );
+  return data?.fields?.analytics ?? {};
+}

package/dist/analytics.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export declare function SeoAnalytics({ route, locale }?: {
+    route?: string;
+    locale?: string;
+}): Promise<import("react").JSX.Element | null>;

package/dist/analytics.js ADDED Viewed

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoAnalytics = SeoAnalytics;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// Серверный компонент: вставляет счётчики аналитики (GA4 / Google Tag Manager / Яндекс.Метрика).
+// Скрипты рендерятся в SSR-HTML и выполняются браузером при загрузке. Смонтируй ОДИН раз в layout:
+//   import { SeoAnalytics } from "@webnumseoagent/next/analytics";
+//   <body>… <SeoAnalytics /> …</body>
+// Fail-safe: платформа недоступна → seoAnalytics() вернёт {} → ничего не рендерим.
+const client_1 = require("./client");
+// ID валидируются на платформе (saveAnalytics), но санитайзим и здесь (defense-in-depth):
+// значения попадают в inline-скрипт, поэтому пропускаем только ожидаемый набор символов.
+// typeof-гард: /config — недоверенный источник, нестроковое значение НЕ должно ронять рендер.
+const ga4Id = (s) => (typeof s === "string" && /^G-[A-Z0-9]+$/i.test(s.trim()) ? s.trim() : "");
+const gtmId = (s) => (typeof s === "string" && /^GTM-[A-Z0-9]+$/i.test(s.trim()) ? s.trim() : "");
+// Метрика вставляется как ЧИСЛОВОЙ литерал — срезаем ведущие нули (иначе sloppy-mode парсит как octal).
+const ymId = (s) => (typeof s === "string" && /^\d+$/.test(s.trim()) ? s.trim().replace(/^0+(?=\d)/, "") : "");
+async function SeoAnalytics({ route, locale } = {}) {
+    const a = await (0, client_1.seoAnalytics)(route ?? "/", locale);
+    const ga4 = ga4Id(a.ga4);
+    const gtm = gtmId(a.gtm);
+    const ym = ymId(a.metrica);
+    if (!ga4 && !gtm && !ym)
+        return null;
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [gtm && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("script", {
+                        // eslint-disable-next-line react/no-danger
+                        dangerouslySetInnerHTML: {
+                            __html: `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','${gtm}');`,
+                        } }), (0, jsx_runtime_1.jsx)("noscript", { children: (0, jsx_runtime_1.jsx)("iframe", { src: `https://www.googletagmanager.com/ns.html?id=${gtm}`, height: "0", width: "0", style: { display: "none", visibility: "hidden" } }) })] })), ga4 && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("script", { async: true, src: `https://www.googletagmanager.com/gtag/js?id=${ga4}` }), (0, jsx_runtime_1.jsx)("script", {
+                        // eslint-disable-next-line react/no-danger
+                        dangerouslySetInnerHTML: {
+                            __html: `window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','${ga4}');`,
+                        } })] })), ym && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("script", {
+                        // eslint-disable-next-line react/no-danger
+                        dangerouslySetInnerHTML: {
+                            __html: `(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};m[i].l=1*new Date();for(var j=0;j<document.scripts.length;j++){if(document.scripts[j].src===r){return;}}k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})(window,document,"script","https://mc.yandex.ru/metrika/tag.js","ym");ym(${ym},"init",{clickmap:true,trackLinks:true,accurateTrackBounce:true,webvisor:true});`,
+                        } }), (0, jsx_runtime_1.jsx)("noscript", { children: (0, jsx_runtime_1.jsx)("div", { children: (0, jsx_runtime_1.jsx)("img", { src: `https://mc.yandex.ru/watch/${ym}`, style: { position: "absolute", left: "-9999px" }, alt: "" }) }) })] }))] }));
+}

package/dist/client.d.ts CHANGED Viewed

@@ -11,3 +11,8 @@ export declare function seoSitemap(): Promise<MetadataRoute.Sitemap>;
 export declare function seoRobots(): Promise<MetadataRoute.Robots>;
 export declare function seoRobotsTxt(): Promise<string>;
 export declare function seoJsonLd(route: string, locale?: string): Promise<unknown[]>;
+export declare function seoAnalytics(route?: string, locale?: string): Promise<{
+    ga4?: string;
+    gtm?: string;
+    metrica?: string;
+}>;

package/dist/client.js CHANGED Viewed

@@ -18,6 +18,7 @@ exports.seoSitemap = seoSitemap;
 exports.seoRobots = seoRobots;
 exports.seoRobotsTxt = seoRobotsTxt;
 exports.seoJsonLd = seoJsonLd;
+exports.seoAnalytics = seoAnalytics;
 const API = process.env.SEOAGENT_API_BASE ?? "";
 const SITE = process.env.SEOAGENT_SITE_ID ?? "";
 const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
@@ -66,6 +67,8 @@ function mergeIntoMetadata(fallback, f) {
             ...(f.og.title ? { title: f.og.title } : {}),
             ...(f.og.description ? { description: f.og.description } : {}),
             ...(f.og.image ? { images: [f.og.image] } : {}),
+            ...(f.og.siteName ? { siteName: f.og.siteName } : {}),
+            ...(f.og.locale ? { locale: f.og.locale } : {}),
         };
     }
     if (f.twitter) {
@@ -73,6 +76,17 @@ function mergeIntoMetadata(fallback, f) {
             ...(m.twitter ?? {}),
             ...(f.twitter.card ? { card: f.twitter.card } : {}),
             ...(f.twitter.image ? { images: [f.twitter.image] } : {}),
+            ...(f.twitter.site ? { site: f.twitter.site } : {}),
+        };
+    }
+    // fb:app_id / fb:admins — только через нативный metadata.facebook (property=, не name=).
+    // Тип Next — union (appId XOR admins), поэтому собираем объект и приводим к типу.
+    if (f.facebook && (f.facebook.appId || f.facebook.admins)) {
+        const admins = (f.facebook.admins ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+        m.facebook = {
+            ...(m.facebook ?? {}), // как и остальные блоки — накладываемся поверх дефолта сайта, не затирая его
+            ...(f.facebook.appId ? { appId: f.facebook.appId } : {}),
+            ...(admins.length ? { admins: admins.length === 1 ? admins[0] : admins } : {}),
         };
     }
     // Проверочные мета-теги веб-мастерских → <meta name content> через metadata.other.
@@ -160,3 +174,8 @@ async function seoJsonLd(route, locale) {
     const data = await fetchJson(`/config?route=${encodeURIComponent(route)}&locale=${encodeURIComponent(locale ?? "")}`);
     return data?.fields?.jsonLd ?? [];
 }
+// Счётчики аналитики (общесайтовые). Читаются в analytics.tsx (<SeoAnalytics/>).
+async function seoAnalytics(route = "/", locale) {
+    const data = await fetchJson(`/config?route=${encodeURIComponent(route)}&locale=${encodeURIComponent(locale ?? "")}`);
+    return data?.fields?.analytics ?? {};
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",
@@ -19,12 +19,17 @@
     "./redirects": {
       "types": "./dist/redirects.d.ts",
       "default": "./dist/redirects.js"
+    },
+    "./analytics": {
+      "types": "./dist/analytics.d.ts",
+      "default": "./dist/analytics.js"
     }
   },
   "files": [
     "dist",
     "client.ts",
     "jsonld.tsx",
+    "analytics.tsx",
     "sitemap-xsl.ts",
     "sitemap-build.ts",
     "redirects.ts",