@prenta/core 5.3.1 → 5.4.0

package/dist/seo/search-console/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/seo/search-console/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAwB;IAErC,YAAY,IAA4B,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/seo/search-insight-signals.d.ts

@@ -0,0 +1,29 @@
+import type { AuditEntityInput, AuditExtraSignals } from './audit-engine.js';
+/** Fire `declining-performance` when clicks drop by at least this fraction. */
+export declare const DECLINE_DROP_RATIO = 0.4;
+/** …and the prior window had at least this many clicks (noise floor). */
+export declare const DECLINE_MIN_PREV_CLICKS = 50;
+export interface SearchInsightRow {
+    path: string;
+    entityId: string | null;
+    clicks28d: number;
+    clicksPrev28d: number;
+    impressions28d: number;
+    lcpMs: number | null;
+    inpMs: number | null;
+    cls: number | null;
+    cwvStatus: string | null;
+}
+export interface SearchInsightSignals {
+    slowPages: NonNullable<AuditExtraSignals['slowPages']>;
+    decliningPages: NonNullable<AuditExtraSignals['decliningPages']>;
+    impressionsByEntityId: Record<string, number>;
+}
+/**
+ * Pure detector — maps insight rows onto audited entities. Exported for unit
+ * tests; `gatherSearchInsightSignals` is the DB-reading wrapper.
+ */
+export declare function detectSearchInsightSignals(rows: SearchInsightRow[], entities: Pick<AuditEntityInput, 'entityId' | 'entityType' | 'title' | 'url'>[]): SearchInsightSignals;
+/** Load insight rows and derive audit signals. Empty signals when the table is absent. */
+export declare function gatherSearchInsightSignals(db: any, entities: Pick<AuditEntityInput, 'entityId' | 'entityType' | 'title' | 'url'>[]): Promise<SearchInsightSignals>;
+//# sourceMappingURL=search-insight-signals.d.ts.map

package/dist/seo/search-insight-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-insight-signals.d.ts","sourceRoot":"","sources":["../../src/seo/search-insight-signals.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE5E,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,WAAW,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAA;IACtD,cAAc,EAAE,WAAW,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAChE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C;AAYD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,gBAAgB,EAAE,EACxB,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC,EAAE,GAC9E,oBAAoB,CA0CtB;AAED,0FAA0F;AAC1F,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,GAAG,EACP,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC,EAAE,GAC9E,OAAO,CAAC,oBAAoB,CAAC,CA0B/B"}

package/dist/seo/search-insight-signals.js

@@ -0,0 +1,103 @@
+/**
+ * Audit signals derived from synced Search Console / CrUX data
+ * (`prenta_search_page_insights`). The sync engine only writes data — this
+ * module is how the audit engine (the single issue writer) consumes it:
+ *
+ * - `cwvStatus: 'poor'` rows become `slowPages` (the existing signal that
+ *   finally moves the performance category off its neutral 70).
+ * - A ≥40% click drop vs the prior 28-day window (with meaningful prior
+ *   volume) becomes a `decliningPages` entry → `declining-performance` issue.
+ * - `impressionsByEntityId` lets quick-wins ranking weight issue groups by
+ *   real traffic.
+ *
+ * Only insight rows that match an audited entity produce signals — an issue
+ * row must point at a document an editor can act on.
+ */
+import { hasModel } from '../api/route-helpers.js';
+/** Fire `declining-performance` when clicks drop by at least this fraction. */
+export const DECLINE_DROP_RATIO = 0.4;
+/** …and the prior window had at least this many clicks (noise floor). */
+export const DECLINE_MIN_PREV_CLICKS = 50;
+/** Human-readable CWV summary for the slow-page issue description. */
+function cwvNote(row) {
+    const parts = [];
+    if (row.lcpMs !== null)
+        parts.push(`LCP ${(row.lcpMs / 1000).toFixed(1)}s`);
+    if (row.inpMs !== null)
+        parts.push(`INP ${row.inpMs}ms`);
+    if (row.cls !== null)
+        parts.push(`CLS ${row.cls}`);
+    const detail = parts.length > 0 ? ` (p75: ${parts.join(', ')})` : '';
+    return `Real-user Core Web Vitals from the Chrome UX Report are in the "poor" range${detail}.`;
+}
+/**
+ * Pure detector — maps insight rows onto audited entities. Exported for unit
+ * tests; `gatherSearchInsightSignals` is the DB-reading wrapper.
+ */
+export function detectSearchInsightSignals(rows, entities) {
+    const byId = new Map(entities.map((e) => [e.entityId, e]));
+    const byUrl = new Map(entities.map((e) => [e.url, e]));
+    const slowPages = [];
+    const decliningPages = [];
+    const impressionsByEntityId = {};
+    for (const row of rows) {
+        const entity = (row.entityId && byId.get(row.entityId)) || byUrl.get(row.path);
+        if (!entity)
+            continue;
+        if (row.impressions28d > 0) {
+            impressionsByEntityId[entity.entityId] =
+                (impressionsByEntityId[entity.entityId] ?? 0) + row.impressions28d;
+        }
+        if (row.cwvStatus === 'poor') {
+            slowPages.push({
+                entityId: entity.entityId,
+                title: entity.title,
+                url: entity.url,
+                note: cwvNote(row),
+            });
+        }
+        if (row.clicksPrev28d >= DECLINE_MIN_PREV_CLICKS &&
+            row.clicks28d <= row.clicksPrev28d * (1 - DECLINE_DROP_RATIO)) {
+            decliningPages.push({
+                entityId: entity.entityId,
+                entityType: entity.entityType,
+                title: entity.title,
+                url: entity.url,
+                clicks28d: row.clicks28d,
+                clicksPrev28d: row.clicksPrev28d,
+            });
+        }
+    }
+    return { slowPages, decliningPages, impressionsByEntityId };
+}
+/** Load insight rows and derive audit signals. Empty signals when the table is absent. */
+export async function gatherSearchInsightSignals(db, entities) {
+    const empty = {
+        slowPages: [],
+        decliningPages: [],
+        impressionsByEntityId: {},
+    };
+    if (!db || !hasModel(db, 'searchPageInsight'))
+        return empty;
+    try {
+        const rows = (await db.searchPageInsight.findMany({
+            select: {
+                path: true,
+                entityId: true,
+                clicks28d: true,
+                clicksPrev28d: true,
+                impressions28d: true,
+                lcpMs: true,
+                inpMs: true,
+                cls: true,
+                cwvStatus: true,
+            },
+            take: 5000,
+        }));
+        return detectSearchInsightSignals(rows, entities);
+    }
+    catch {
+        return empty;
+    }
+}
+//# sourceMappingURL=search-insight-signals.js.map

package/dist/seo/search-insight-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-insight-signals.js","sourceRoot":"","sources":["../../src/seo/search-insight-signals.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prenta/core",
-  "version": "5.3.1",
+  "version": "5.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/prisma/migrations/0016_search_console_tables/migration.sql

@@ -0,0 +1,56 @@
+-- Search Console + CrUX integration (spec: 2026-08-29-search-console-integration-design.md).
+-- Two additive tables written by the nightly search sync:
+--   prenta_search_perf_daily    — (date, path) GSC search analytics, 90-day rolling window
+--   prenta_search_page_insights — per-page 28d totals/deltas, top-query snapshot, CrUX p75s
+-- Dates are stored exactly as GSC reports them (property timezone), never converted to UTC.
+
+CREATE TABLE "prenta_search_perf_daily" (
+    "id" TEXT NOT NULL,
+    "date" DATE NOT NULL,
+    "path" TEXT NOT NULL,
+    "clicks" INTEGER NOT NULL DEFAULT 0,
+    "impressions" INTEGER NOT NULL DEFAULT 0,
+    "ctr" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "position" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "prenta_search_perf_daily_pkey" PRIMARY KEY ("id")
+);
+
+-- Upsert key for the nightly sync (idempotent re-fetch of lagging days).
+CREATE UNIQUE INDEX "prenta_search_perf_daily_date_path_key" ON "prenta_search_perf_daily"("date", "path");
+
+-- Per-page trend queries (28d windows).
+CREATE INDEX "prenta_search_perf_daily_path_idx" ON "prenta_search_perf_daily"("path");
+
+CREATE TABLE "prenta_search_page_insights" (
+    "id" TEXT NOT NULL,
+    "path" TEXT NOT NULL,
+    "entityId" TEXT,
+    "entityType" TEXT,
+    "topQueries" JSONB,
+    "clicks28d" INTEGER NOT NULL DEFAULT 0,
+    "impressions28d" INTEGER NOT NULL DEFAULT 0,
+    "avgPosition28d" DOUBLE PRECISION,
+    "clicksPrev28d" INTEGER NOT NULL DEFAULT 0,
+    "impressionsPrev28d" INTEGER NOT NULL DEFAULT 0,
+    "avgPositionPrev28d" DOUBLE PRECISION,
+    "lcpMs" INTEGER,
+    "inpMs" INTEGER,
+    "cls" DOUBLE PRECISION,
+    "cwvStatus" TEXT,
+    "cwvCollectedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "lastSyncedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "prenta_search_page_insights_pkey" PRIMARY KEY ("id")
+);
+
+-- One insight row per normalized path.
+CREATE UNIQUE INDEX "prenta_search_page_insights_path_key" ON "prenta_search_page_insights"("path");
+
+-- "Top pages by impressions" ordering (overview table, CrUX rotation).
+CREATE INDEX "prenta_search_page_insights_impressions28d_idx" ON "prenta_search_page_insights"("impressions28d");
+
+-- Document-scoped lookups (editor pane, AI prompt context).
+CREATE INDEX "prenta_search_page_insights_entityId_idx" ON "prenta_search_page_insights"("entityId");

package/prisma/schema.prisma

@@ -571,6 +571,55 @@ model AiCrawlerHit {
   @@map("prenta_ai_crawler_hits")
 }
 
+/// One row per (page path, day) of Google Search Console search analytics,
+/// written by the nightly search sync. Dates are stored exactly as GSC
+/// reports them (property timezone) — never converted to UTC. Rolling
+/// 90-day window, pruned during sync.
+model SearchPerfDaily {
+  id          String   @id @default(cuid())
+  date        DateTime @db.Date
+  path        String
+  clicks      Int      @default(0)
+  impressions Int      @default(0)
+  ctr         Float    @default(0)
+  position    Float    @default(0)
+  createdAt   DateTime @default(now())
+
+  @@unique([date, path])
+  @@index([path])
+  @@map("prenta_search_perf_daily")
+}
+
+/// Per-page search insight snapshot: trailing-28-day totals + prior-window
+/// deltas (computed from SearchPerfDaily), top queries from GSC, and CrUX
+/// Core Web Vitals p75s. One row per normalized path, upserted by the sync.
+/// `cwvStatus` null means CrUX has no field data for the URL (normal for
+/// low-traffic pages), never an error.
+model SearchPageInsight {
+  id                 String    @id @default(cuid())
+  path               String    @unique
+  entityId           String?
+  entityType         String?
+  topQueries         Json?
+  clicks28d          Int       @default(0)
+  impressions28d     Int       @default(0)
+  avgPosition28d     Float?
+  clicksPrev28d      Int       @default(0)
+  impressionsPrev28d Int       @default(0)
+  avgPositionPrev28d Float?
+  lcpMs              Int?
+  inpMs              Int?
+  cls                Float?
+  cwvStatus          String?
+  cwvCollectedAt     DateTime?
+  createdAt          DateTime  @default(now())
+  lastSyncedAt       DateTime  @updatedAt
+
+  @@index([impressions28d])
+  @@index([entityId])
+  @@map("prenta_search_page_insights")
+}
+
 /// An AI/heuristic suggestion for a 404 destination. Confidence-scored and
 /// never auto-applied below the configured threshold.
 model RedirectSuggestion {