@prenta/core 5.3.1 → 5.4.0

package/dist/seo/search-console/sync.d.ts

@@ -0,0 +1,67 @@
+import type { PrentaCMSConfig } from '../../config/types.js';
+import { type SearchConsoleClientOptions, type SearchSyncStatus, type TopQueryEntry } from './types.js';
+/** Rolling retention window for daily rows. */
+export declare const SEARCH_PERF_RETENTION_DAYS = 90;
+/** CrUX URLs checked per invocation (fits `maxDuration: 30`). */
+export declare const CRUX_URLS_PER_RUN = 20;
+export interface SearchSyncOptions extends SearchConsoleClientOptions {
+    /** CrUX per-run cap override (tests). */
+    cruxUrlsPerRun?: number;
+    /** Effective config override (tests); defaults to the runtime config + DB overrides. */
+    effectiveConfig?: PrentaCMSConfig | null;
+    /** Attribution for the settings write. */
+    userId?: string;
+}
+export interface SearchSyncResult {
+    status: SearchSyncStatus;
+    rowsUpserted: number;
+    pagesUpdated: number;
+    cruxChecked: number;
+    pruned: number;
+}
+/**
+ * Add calendar days to a `YYYY-MM-DD` string. Uses a UTC-noon anchor so the
+ * math is immune to DST — GSC dates are calendar days, not instants.
+ */
+export declare function addDays(date: string, days: number): string;
+/**
+ * Normalize a GSC page URL to the site-relative path used everywhere else
+ * (`documentPublicPath` form: no trailing slash, no query/hash). Returns null
+ * for URLs on other hosts — required for `sc-domain:` properties, which
+ * report every subdomain and protocol.
+ */
+export declare function normalizeGscPageUrl(pageUrl: string, siteHost: string | null): string | null;
+/** Derive the host to filter GSC rows by: public site URL, else the property itself. */
+export declare function resolveFilterHost(siteUrl: string | null, property: string): string | null;
+/**
+ * Collapse GSC `(date, page)` rows onto normalized paths. Several URL variants
+ * (protocol, www, trailing slash, query strings) can merge into one path, so
+ * clicks/impressions sum and position becomes the impressions-weighted mean.
+ */
+export declare function aggregateDailyRows(rows: Array<{
+    keys: string[];
+    clicks: number;
+    impressions: number;
+    position: number;
+}>, siteHost: string | null): Array<{
+    date: string;
+    path: string;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+}>;
+/** Group `(query, page)` rows into per-path top-query lists (by clicks, then impressions). */
+export declare function buildTopQueries(rows: Array<{
+    keys: string[];
+    clicks: number;
+    impressions: number;
+    position: number;
+}>, siteHost: string | null): Map<string, TopQueryEntry[]>;
+/**
+ * Run one search-data sync pass. Never throws for expected failure modes —
+ * the returned `status` carries per-part outcomes, and the same status object
+ * is persisted to the SEO settings for the admin card.
+ */
+export declare function runSearchSync(db: any, options?: SearchSyncOptions): Promise<SearchSyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/seo/search-console/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/seo/search-console/sync.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAY5D,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAA;AAEnB,+CAA+C;AAC/C,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAO5C,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAMnC,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACnE,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wFAAwF;IACxF,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACxC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAaD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAe3F;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAezF;AAcD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EACtF,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAC,CAqCD;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EACtF,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAqB9B;AA6ED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,GAAG,EACP,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAgQ3B"}

package/dist/seo/search-console/sync.js

@@ -0,0 +1,469 @@
+/**
+ * Nightly search-data sync: Google Search Console analytics + CrUX Core Web
+ * Vitals → `prenta_search_perf_daily` / `prenta_search_page_insights`.
+ *
+ * Design contract (spec: 2026-08-29-search-console-integration-design.md):
+ *
+ * - **Sync writes data only — never SeoIssue rows.** The audit engine is the
+ *   single issue writer; it reads the insight table on its own runs.
+ * - **Timezone rule:** GSC reports dates in the property's timezone. Dates are
+ *   stored exactly as reported (`YYYY-MM-DD` → UTC-midnight DATE column) and
+ *   all window math happens on those as-reported calendar days.
+ * - **Chunked for serverless:** the GSC fetch is one paginated request; CrUX
+ *   is capped per invocation with a rotating cursor persisted in settings, so
+ *   every run fits Vercel's 30s function budget.
+ * - **CrUX 404 = no field data** (normal for low-traffic URLs) — recorded as
+ *   `cwvStatus: null`, never a failure.
+ */
+import { hasModel } from '../../api/route-helpers.js';
+import { getPrentaConfig } from '../../config/runtime.js';
+import { decryptSecret } from '../../security/secret-storage.js';
+import { applySeoOverrides, getSeoOverrides, patchSeoModuleSettings, resolveSeoModuleSettings, } from '../config-store.js';
+import { CruxError, fetchCruxMetrics } from '../crux.js';
+import { applyTrailingSlashToPathname, documentPublicPath } from '../document-path.js';
+import { resolvePublicSiteUrlFromSnapshot } from '../public-site-url.js';
+import { parseServiceAccountKey, queryAllSearchAnalytics, toGscDate } from './client.js';
+import { SearchConsoleError, } from './types.js';
+/** Rolling retention window for daily rows. */
+export const SEARCH_PERF_RETENTION_DAYS = 90;
+/** GSC data lags ~2 days; always re-request this trailing window to self-heal. */
+const LAG_REFRESH_DAYS = 3;
+/** Trailing window for query snapshots, totals, and deltas. */
+const INSIGHT_WINDOW_DAYS = 28;
+/** Top queries kept per page in the insight snapshot. */
+const TOP_QUERIES_PER_PAGE = 20;
+/** CrUX URLs checked per invocation (fits `maxDuration: 30`). */
+export const CRUX_URLS_PER_RUN = 20;
+/** How many top-by-impressions pages participate in the CrUX rotation. */
+const CRUX_ROTATION_POOL = 500;
+/** Documents loaded for path→entity matching (mirrors AUDIT_MAX_ENTITIES). */
+const MATCH_MAX_DOCUMENTS = 5000;
+/**
+ * Add calendar days to a `YYYY-MM-DD` string. Uses a UTC-noon anchor so the
+ * math is immune to DST — GSC dates are calendar days, not instants.
+ */
+export function addDays(date, days) {
+    const parts = date.split('-').map(Number);
+    const y = parts[0] ?? 1970;
+    const m = parts[1] ?? 1;
+    const d = parts[2] ?? 1;
+    return toGscDate(new Date(Date.UTC(y, m - 1, d + days, 12)));
+}
+/** Store a GSC calendar day in the DATE column (UTC midnight, by convention). */
+function toDbDate(date) {
+    return new Date(`${date}T00:00:00.000Z`);
+}
+/** Host comparison with apex/www equivalence (`www.example.com` ≡ `example.com`). */
+function hostsMatch(a, b) {
+    const strip = (h) => h.toLowerCase().replace(/^www\./, '');
+    return strip(a) === strip(b);
+}
+/**
+ * Normalize a GSC page URL to the site-relative path used everywhere else
+ * (`documentPublicPath` form: no trailing slash, no query/hash). Returns null
+ * for URLs on other hosts — required for `sc-domain:` properties, which
+ * report every subdomain and protocol.
+ */
+export function normalizeGscPageUrl(pageUrl, siteHost) {
+    let parsed;
+    try {
+        parsed = new URL(pageUrl);
+    }
+    catch {
+        return null;
+    }
+    if (siteHost && !hostsMatch(parsed.hostname, siteHost))
+        return null;
+    let path = parsed.pathname.replace(/\/+$/, '') || '/';
+    try {
+        path = decodeURIComponent(path);
+    }
+    catch {
+        // keep the encoded form when decoding fails
+    }
+    return path.startsWith('/') ? path : `/${path}`;
+}
+/** Derive the host to filter GSC rows by: public site URL, else the property itself. */
+export function resolveFilterHost(siteUrl, property) {
+    if (siteUrl) {
+        try {
+            return new URL(siteUrl).hostname;
+        }
+        catch {
+            // fall through to the property
+        }
+    }
+    const trimmed = property.trim();
+    if (trimmed.startsWith('sc-domain:'))
+        return trimmed.slice('sc-domain:'.length) || null;
+    try {
+        return new URL(trimmed).hostname;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Collapse GSC `(date, page)` rows onto normalized paths. Several URL variants
+ * (protocol, www, trailing slash, query strings) can merge into one path, so
+ * clicks/impressions sum and position becomes the impressions-weighted mean.
+ */
+export function aggregateDailyRows(rows, siteHost) {
+    const byKey = new Map();
+    for (const row of rows) {
+        const [date, page] = row.keys;
+        if (!date || !page)
+            continue;
+        const path = normalizeGscPageUrl(page, siteHost);
+        if (!path)
+            continue;
+        const key = `${date}\u0000${path}`;
+        const agg = byKey.get(key) ?? {
+            date,
+            path,
+            clicks: 0,
+            impressions: 0,
+            positionWeight: 0,
+            positionSum: 0,
+            rows: 0,
+        };
+        agg.clicks += row.clicks;
+        agg.impressions += row.impressions;
+        agg.positionWeight += row.position * row.impressions;
+        agg.positionSum += row.position;
+        agg.rows += 1;
+        byKey.set(key, agg);
+    }
+    return [...byKey.values()].map((agg) => ({
+        date: agg.date,
+        path: agg.path,
+        clicks: agg.clicks,
+        impressions: agg.impressions,
+        ctr: agg.impressions > 0 ? agg.clicks / agg.impressions : 0,
+        position: agg.impressions > 0
+            ? agg.positionWeight / agg.impressions
+            : agg.rows > 0
+                ? agg.positionSum / agg.rows
+                : 0,
+    }));
+}
+/** Group `(query, page)` rows into per-path top-query lists (by clicks, then impressions). */
+export function buildTopQueries(rows, siteHost) {
+    const byPath = new Map();
+    for (const row of rows) {
+        const [query, page] = row.keys;
+        if (!query || !page)
+            continue;
+        const path = normalizeGscPageUrl(page, siteHost);
+        if (!path)
+            continue;
+        const list = byPath.get(path) ?? [];
+        list.push({
+            query,
+            clicks: row.clicks,
+            impressions: row.impressions,
+            position: Math.round(row.position * 10) / 10,
+        });
+        byPath.set(path, list);
+    }
+    for (const [path, list] of byPath) {
+        list.sort((a, b) => b.clicks - a.clicks || b.impressions - a.impressions);
+        byPath.set(path, list.slice(0, TOP_QUERIES_PER_PAGE));
+    }
+    return byPath;
+}
+/** Build a path → document map from published front-end documents. */
+async function buildEntityMap(db, effectiveConfig) {
+    const map = new Map();
+    const collections = (effectiveConfig?.collections ?? {});
+    const slugs = [];
+    const types = {};
+    for (const [slug, col] of Object.entries(collections)) {
+        if (col?.type !== 'page' && col?.type !== 'post')
+            continue;
+        if (col?.admin?.hidden)
+            continue;
+        slugs.push(slug);
+        types[slug] = col.type;
+    }
+    if (slugs.length === 0 || !hasModel(db, 'document'))
+        return map;
+    try {
+        const docs = await db.document.findMany({
+            where: { collection: { in: slugs }, status: 'PUBLISHED', deletedAt: null },
+            select: { id: true, collection: true, slug: true, data: true },
+            take: MATCH_MAX_DOCUMENTS,
+        });
+        for (const doc of docs) {
+            const data = doc.data && typeof doc.data === 'object' && !Array.isArray(doc.data)
+                ? doc.data
+                : {};
+            const path = documentPublicPath({
+                urlPrefix: collections[doc.collection]?.urlPrefix,
+                slug: doc.slug,
+                data,
+            });
+            if (!map.has(path)) {
+                map.set(path, { entityId: doc.id, entityType: types[doc.collection] ?? 'page' });
+            }
+        }
+    }
+    catch {
+        // best-effort matching — insights still store path-only rows
+    }
+    return map;
+}
+/** Sum a date window from the daily table, grouped by path. */
+async function loadWindowTotals(db, start, end) {
+    const out = new Map();
+    const groups = await db.searchPerfDaily.groupBy({
+        by: ['path'],
+        where: { date: { gte: toDbDate(start), lte: toDbDate(end) } },
+        _sum: { clicks: true, impressions: true },
+        _avg: { position: true },
+    });
+    for (const g of groups) {
+        out.set(g.path, {
+            clicks: g._sum.clicks ?? 0,
+            impressions: g._sum.impressions ?? 0,
+            avgPosition: g._avg.position === null ? null : Math.round(g._avg.position * 10) / 10,
+        });
+    }
+    return out;
+}
+/**
+ * Run one search-data sync pass. Never throws for expected failure modes —
+ * the returned `status` carries per-part outcomes, and the same status object
+ * is persisted to the SEO settings for the admin card.
+ */
+export async function runSearchSync(db, options = {}) {
+    const overrides = await getSeoOverrides(db);
+    const settings = resolveSeoModuleSettings(overrides);
+    const empty = {
+        status: { state: 'not-configured' },
+        rowsUpserted: 0,
+        pagesUpdated: 0,
+        cruxChecked: 0,
+        pruned: 0,
+    };
+    if (!settings.gscServiceAccountKey || !settings.gscPropertyUrl.trim()) {
+        return empty;
+    }
+    if (!hasModel(db, 'searchPerfDaily') || !hasModel(db, 'searchPageInsight')) {
+        return {
+            ...empty,
+            status: {
+                state: 'error',
+                message: 'Search data tables are missing — run the pending database migration.',
+            },
+        };
+    }
+    const property = settings.gscPropertyUrl.trim();
+    const effectiveConfig = options.effectiveConfig !== undefined
+        ? options.effectiveConfig
+        : applySeoOverrides(getPrentaConfig(), overrides);
+    const site = resolvePublicSiteUrlFromSnapshot(effectiveConfig, overrides);
+    const siteHost = resolveFilterHost(site.siteUrl, property);
+    const nowMs = options.now ?? Date.now;
+    const today = toGscDate(new Date(nowMs()));
+    const endDate = addDays(today, -1);
+    const windowStart = addDays(today, -SEARCH_PERF_RETENTION_DAYS);
+    const clientOptions = { fetchFn: options.fetchFn, now: options.now };
+    const status = { state: 'ok', parts: {} };
+    let rowsUpserted = 0;
+    let pagesUpdated = 0;
+    let gscOk = false;
+    // ── Part 1: Search Console ────────────────────────────────────────────
+    try {
+        const key = parseServiceAccountKey(await decryptSecret(settings.gscServiceAccountKey));
+        // Fetch every day missing from the retention window, plus the trailing
+        // lag window (GSC finalizes data ~2 days late). One paginated request
+        // covers the whole contiguous span; re-fetched days upsert idempotently.
+        const existingRows = (await db.searchPerfDaily.findMany({
+            where: { date: { gte: toDbDate(windowStart) } },
+            select: { date: true },
+            distinct: ['date'],
+        }));
+        const existingDates = new Set(existingRows.map((r) => toGscDate(r.date)));
+        let fetchStart = addDays(endDate, -(LAG_REFRESH_DAYS - 1));
+        for (let d = windowStart; d <= endDate; d = addDays(d, 1)) {
+            if (!existingDates.has(d)) {
+                if (d < fetchStart)
+                    fetchStart = d;
+                break;
+            }
+        }
+        const dailyRows = await queryAllSearchAnalytics(key, property, { startDate: fetchStart, endDate, dimensions: ['date', 'page'] }, clientOptions);
+        const aggregated = aggregateDailyRows(dailyRows, siteHost);
+        // Replace-then-insert keeps the write to two statements regardless of
+        // row count (a 90-day backfill can be tens of thousands of upserts).
+        await db.searchPerfDaily.deleteMany({
+            where: { date: { gte: toDbDate(fetchStart), lte: toDbDate(endDate) } },
+        });
+        if (aggregated.length > 0) {
+            await db.searchPerfDaily.createMany({
+                data: aggregated.map((r) => ({
+                    date: toDbDate(r.date),
+                    path: r.path,
+                    clicks: r.clicks,
+                    impressions: r.impressions,
+                    ctr: r.ctr,
+                    position: r.position,
+                })),
+            });
+        }
+        rowsUpserted = aggregated.length;
+        // Query snapshot over the trailing 28 days.
+        const snapStart = addDays(endDate, -(INSIGHT_WINDOW_DAYS - 1));
+        const queryRows = await queryAllSearchAnalytics(key, property, { startDate: snapStart, endDate, dimensions: ['query', 'page'] }, clientOptions);
+        const topQueriesByPath = buildTopQueries(queryRows, siteHost);
+        // 28d totals + prior-window deltas from the daily table.
+        const current = await loadWindowTotals(db, snapStart, endDate);
+        const prevEnd = addDays(snapStart, -1);
+        const prevStart = addDays(prevEnd, -(INSIGHT_WINDOW_DAYS - 1));
+        const previous = await loadWindowTotals(db, prevStart, prevEnd);
+        const entityMap = await buildEntityMap(db, effectiveConfig);
+        const allPaths = new Set([
+            ...current.keys(),
+            ...previous.keys(),
+            ...topQueriesByPath.keys(),
+        ]);
+        for (const path of allPaths) {
+            const cur = current.get(path);
+            const prev = previous.get(path);
+            const entity = entityMap.get(path);
+            const fields = {
+                entityId: entity?.entityId ?? null,
+                entityType: entity?.entityType ?? null,
+                topQueries: topQueriesByPath.get(path) ?? [],
+                clicks28d: cur?.clicks ?? 0,
+                impressions28d: cur?.impressions ?? 0,
+                avgPosition28d: cur?.avgPosition ?? null,
+                clicksPrev28d: prev?.clicks ?? 0,
+                impressionsPrev28d: prev?.impressions ?? 0,
+                avgPositionPrev28d: prev?.avgPosition ?? null,
+            };
+            await db.searchPageInsight.upsert({
+                where: { path },
+                update: fields,
+                create: { path, ...fields },
+            });
+            pagesUpdated++;
+        }
+        // Pages that dropped out of both windows are stale: zero the counters but
+        // keep the row (and its CWV data) so the editor pane can still show it.
+        if (allPaths.size > 0) {
+            await db.searchPageInsight.updateMany({
+                where: { path: { notIn: [...allPaths] } },
+                data: {
+                    clicks28d: 0,
+                    impressions28d: 0,
+                    avgPosition28d: null,
+                    clicksPrev28d: 0,
+                    impressionsPrev28d: 0,
+                    avgPositionPrev28d: null,
+                },
+            });
+        }
+        gscOk = true;
+        status.parts = {
+            ...status.parts,
+            searchConsole: { ok: true, rowsUpserted },
+        };
+    }
+    catch (err) {
+        const message = err instanceof SearchConsoleError
+            ? err.message
+            : `Unexpected sync failure: ${err instanceof Error ? err.message : String(err)}`;
+        status.parts = { ...status.parts, searchConsole: { ok: false, message } };
+    }
+    // ── Part 2: CrUX (independent of the GSC part) ────────────────────────
+    let cruxChecked = 0;
+    let cruxOk = null;
+    let nextCruxCursor = settings.searchSyncCruxCursor;
+    if (settings.cruxApiKey) {
+        if (!site.siteUrl) {
+            cruxOk = false;
+            status.parts = {
+                ...status.parts,
+                crux: { ok: false, message: 'Set the public site URL before collecting Core Web Vitals.' },
+            };
+        }
+        else {
+            try {
+                const cruxKey = await decryptSecret(settings.cruxApiKey);
+                const pool = (await db.searchPageInsight.findMany({
+                    orderBy: { impressions28d: 'desc' },
+                    select: { id: true, path: true },
+                    take: CRUX_ROTATION_POOL,
+                }));
+                const cap = Math.min(options.cruxUrlsPerRun ?? CRUX_URLS_PER_RUN, pool.length);
+                const start = pool.length > 0 ? settings.searchSyncCruxCursor % pool.length : 0;
+                for (let i = 0; i < cap; i++) {
+                    const row = pool[(start + i) % pool.length];
+                    if (!row)
+                        continue;
+                    const pathname = applyTrailingSlashToPathname(row.path, site.trailingSlash);
+                    const url = pathname === '/' ? `${site.siteUrl}/` : `${site.siteUrl}${pathname}`;
+                    const metrics = await fetchCruxMetrics(cruxKey, url, { fetchFn: options.fetchFn });
+                    await db.searchPageInsight.update({
+                        where: { id: row.id },
+                        data: {
+                            lcpMs: metrics.lcpMs,
+                            inpMs: metrics.inpMs,
+                            cls: metrics.cls,
+                            cwvStatus: metrics.status,
+                            cwvCollectedAt: new Date(nowMs()),
+                        },
+                    });
+                    cruxChecked++;
+                }
+                nextCruxCursor = pool.length > 0 ? (start + cap) % pool.length : 0;
+                cruxOk = true;
+                status.parts = { ...status.parts, crux: { ok: true, pagesChecked: cruxChecked } };
+            }
+            catch (err) {
+                cruxOk = false;
+                const message = err instanceof CruxError
+                    ? err.message
+                    : `Unexpected CrUX failure: ${err instanceof Error ? err.message : String(err)}`;
+                status.parts = { ...status.parts, crux: { ok: false, message, pagesChecked: cruxChecked } };
+            }
+        }
+    }
+    // ── Part 3: prune + status ────────────────────────────────────────────
+    let pruned = 0;
+    try {
+        const del = await db.searchPerfDaily.deleteMany({
+            where: { date: { lt: toDbDate(windowStart) } },
+        });
+        pruned = typeof del?.count === 'number' ? del.count : 0;
+    }
+    catch {
+        // prune is housekeeping — never fail the run over it
+    }
+    status.state = gscOk
+        ? cruxOk === false
+            ? 'partial'
+            : 'ok'
+        : cruxOk === true
+            ? 'partial'
+            : 'error';
+    if (!gscOk)
+        status.message = status.parts?.searchConsole?.message;
+    else if (cruxOk === false)
+        status.message = status.parts?.crux?.message;
+    try {
+        await patchSeoModuleSettings(db, {
+            searchSyncLastRunAt: new Date(nowMs()).toISOString(),
+            searchSyncStatus: status,
+            searchSyncCruxCursor: nextCruxCursor,
+            searchConsoleConnected: gscOk,
+        }, options.userId ?? 'system');
+    }
+    catch {
+        // status persistence is best-effort; the sync result still returns it
+    }
+    return { status, rowsUpserted, pagesUpdated, cruxChecked, pruned };
+}
+//# sourceMappingURL=sync.js.map

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

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

package/dist/seo/search-console/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Shared types for the Google Search Console integration (spec:
+ * docs/superpowers/specs/2026-08-29-search-console-integration-design.md).
+ *
+ * Dates flow through this module as `YYYY-MM-DD` strings exactly as GSC
+ * reports them (property timezone) — never as Date objects converted to UTC.
+ */
+/** The fields of a Google service-account JSON key this integration uses. */
+export interface GscServiceAccountKey {
+    client_email: string;
+    private_key: string;
+    /** OAuth2 token endpoint. Present in every Google-issued key file. */
+    token_uri?: string;
+}
+/**
+ * Discriminated failure states, each mapped to an actionable admin hint by
+ * the settings/test endpoints. `not-configured` is the quiet no-op state —
+ * a fresh install syncs nothing and reports nothing.
+ */
+export type SearchConsoleErrorCode = 'not-configured' | 'auth-failed' | 'property-not-granted' | 'quota-exceeded' | 'network';
+export declare class SearchConsoleError extends Error {
+    readonly code: SearchConsoleErrorCode;
+    constructor(code: SearchConsoleErrorCode, message: string);
+}
+/** One row from the Search Analytics API. `keys` order matches `dimensions`. */
+export interface SearchAnalyticsRow {
+    keys: string[];
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+}
+export type SearchAnalyticsDimension = 'date' | 'page' | 'query';
+export interface SearchAnalyticsQuery {
+    /** Inclusive, `YYYY-MM-DD` in the property's timezone. */
+    startDate: string;
+    /** Inclusive, `YYYY-MM-DD` in the property's timezone. */
+    endDate: string;
+    dimensions: SearchAnalyticsDimension[];
+    /** Per-request page size. Defaults to the API maximum (25,000). */
+    rowLimit?: number;
+    startRow?: number;
+}
+/** Injectable seams so every call is fixture-testable without Google. */
+export interface SearchConsoleClientOptions {
+    fetchFn?: typeof fetch;
+    /** Clock override for token-expiry tests. */
+    now?: () => number;
+}
+/** Sync status persisted in the SEO config store and shown in the admin. */
+export interface SearchSyncStatus {
+    state: 'ok' | 'partial' | 'error' | 'not-configured';
+    message?: string;
+    /** Per-part outcome so a CrUX failure doesn't hide a GSC success. */
+    parts?: {
+        searchConsole?: {
+            ok: boolean;
+            message?: string;
+            rowsUpserted?: number;
+        };
+        crux?: {
+            ok: boolean;
+            message?: string;
+            pagesChecked?: number;
+        };
+    };
+}
+/** Top-query entry stored in `SearchPageInsight.topQueries`. */
+export interface TopQueryEntry {
+    query: string;
+    clicks: number;
+    impressions: number;
+    position: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/seo/search-console/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/seo/search-console/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAC9B,gBAAgB,GAChB,aAAa,GACb,sBAAsB,GACtB,gBAAgB,GAChB,SAAS,CAAA;AAEb,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;gBAEzB,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAK1D;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAEhE,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,wBAAwB,EAAE,CAAA;IACtC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAA;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qEAAqE;IACrE,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACxE,IAAI,CAAC,EAAE;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAChE,CAAA;CACF;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB"}

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

@@ -0,0 +1,16 @@
+/**
+ * Shared types for the Google Search Console integration (spec:
+ * docs/superpowers/specs/2026-08-29-search-console-integration-design.md).
+ *
+ * Dates flow through this module as `YYYY-MM-DD` strings exactly as GSC
+ * reports them (property timezone) — never as Date objects converted to UTC.
+ */
+export class SearchConsoleError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'SearchConsoleError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map