@prenta/core 5.8.1 → 5.10.0

package/dist/seo/faq-eligibility.js

@@ -0,0 +1,61 @@
+/**
+ * Shared "can this page get a FAQ section?" rules for the `missing-faq`
+ * scanner and the `add-faq-section` apply path, so the two never disagree.
+ */
+import { collectionSupportsSections } from '../config/collection-lookup.js';
+import { isPageBuilderTree } from '../sections/bridge.js';
+import { coerceSections } from '../sections/helpers.js';
+import { getSectionType, isSectionTypeAddable, isSectionTypeAllowedForTemplate, readDocumentTemplate, } from '../sections/registry.js';
+/** True when any section — visible or hidden — has `sectionType === 'faq'`. */
+export function hasFaqSection(data) {
+    const sections = data?.sections;
+    return (Array.isArray(sections) &&
+        sections.some((s) => s && typeof s === 'object' && s.sectionType === 'faq'));
+}
+/** True when the document has no readable sections and its content lives in a legacy `_layout` tree. */
+function hasOnlyLegacyLayout(data) {
+    return (coerceSections(data.sections, { onUnknown: 'preserve' }).length === 0 &&
+        isPageBuilderTree(data._layout));
+}
+/**
+ * Whether a `faq` section may be inserted into this document: type pins,
+ * template allowlist, the collection's `sections` storage contract, and the
+ * legacy-layout guard. The `missing-faq` scanner and the `add-section` apply
+ * branch both call this so a proposal is never raised that apply would refuse.
+ */
+export function canAddFaqSection(data, opts = {}) {
+    const def = getSectionType('faq');
+    if (!def)
+        return { ok: false, reason: 'unknown-type' };
+    if (!isSectionTypeAddable(def))
+        return { ok: false, reason: 'not-addable' };
+    if (!isSectionTypeAllowedForTemplate(def, readDocumentTemplate(data ?? null))) {
+        return { ok: false, reason: 'template-disallows' };
+    }
+    if (opts.collection !== undefined && !collectionSupportsSections(opts.collection)) {
+        return { ok: false, reason: 'no-sections-field' };
+    }
+    if (data && hasOnlyLegacyLayout(data))
+        return { ok: false, reason: 'legacy-layout' };
+    return { ok: true };
+}
+function joinNames(names) {
+    if (names.length <= 1)
+        return names[0] ?? 'AI engines';
+    return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;
+}
+/** One human line naming the strongest signal; GEO referrals, then retrieval crawls, then the top question. */
+export function strongestFaqSignalText(signals) {
+    const g = signals.geo;
+    if (g && g.referralVisits > 0) {
+        return `Cited by ${joinNames(g.engines)} ${g.referralVisits}× in the last 28 days`;
+    }
+    if (g && g.retrievalHits > 0) {
+        return `Fetched by ${joinNames(g.engines)} ${g.retrievalHits}× in the last 28 days`;
+    }
+    const q = signals.queries[0];
+    if (q)
+        return `Asked "${q.query}" ${q.impressions}× on Google in the last 28 days`;
+    return 'People reach this page with questions';
+}
+//# sourceMappingURL=faq-eligibility.js.map

package/dist/seo/faq-eligibility.js.map

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

package/dist/seo/faq-schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * FAQPage helpers shared by the composer-adjacent audit type
+ * (`faq-schema-missing`) and its deterministic fix. Pure; no DB.
+ */
+import type { FaqItem } from './page-meta.js';
+/** A `faq` section needs at least this many complete rows before schema is worth emitting. */
+export declare const FAQ_SCHEMA_MIN_ROWS = 2;
+/** True when `node`, or any entry of its `@graph`, is (or includes) FAQPage. */
+export declare function jsonLdHasFaqPage(node: unknown): boolean;
+export declare function buildFaqPageNode(items: FaqItem[], url: string): Record<string, unknown>;
+/** Return a copy of `override` with `node` added to its graph (wrapping a single node into `@graph`). */
+export declare function insertFaqPageNode(override: Record<string, unknown>, node: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=faq-schema.d.ts.map

package/dist/seo/faq-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-schema.d.ts","sourceRoot":"","sources":["../../src/seo/faq-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C,8FAA8F;AAC9F,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAMpC,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAWvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUvF;AAQD,yGAAyG;AACzG,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/seo/faq-schema.js

@@ -0,0 +1,41 @@
+/** A `faq` section needs at least this many complete rows before schema is worth emitting. */
+export const FAQ_SCHEMA_MIN_ROWS = 2;
+function typeHasFaq(type) {
+    return type === 'FAQPage' || (Array.isArray(type) && type.includes('FAQPage'));
+}
+/** True when `node`, or any entry of its `@graph`, is (or includes) FAQPage. */
+export function jsonLdHasFaqPage(node) {
+    if (!node || typeof node !== 'object')
+        return false;
+    const rec = node;
+    if (typeHasFaq(rec['@type']))
+        return true;
+    const graph = rec['@graph'];
+    return (Array.isArray(graph) &&
+        graph.some((n) => n && typeof n === 'object' && typeHasFaq(n['@type'])));
+}
+export function buildFaqPageNode(items, url) {
+    return {
+        '@type': 'FAQPage',
+        '@id': `${url}#faq`,
+        mainEntity: items.map((item) => ({
+            '@type': 'Question',
+            name: item.question,
+            acceptedAnswer: { '@type': 'Answer', text: item.answer },
+        })),
+    };
+}
+function stripContext(node) {
+    const rest = { ...node };
+    delete rest['@context'];
+    return rest;
+}
+/** Return a copy of `override` with `node` added to its graph (wrapping a single node into `@graph`). */
+export function insertFaqPageNode(override, node) {
+    const context = override['@context'] ?? 'https://schema.org';
+    if (Array.isArray(override['@graph'])) {
+        return { ...override, '@context': context, '@graph': [...override['@graph'], node] };
+    }
+    return { '@context': context, '@graph': [stripContext(override), node] };
+}
+//# sourceMappingURL=faq-schema.js.map

package/dist/seo/faq-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-schema.js","sourceRoot":"","sources":["../../src/seo/faq-schema.ts"],"names":[],"mappings":"AAMA,8FAA8F;AAC9F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAEpC,SAAS,UAAU,CAAC,IAAa;IAC/B,OAAO,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;AAChF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACnD,MAAM,GAAG,GAAG,IAA+B,CAAA;IAC3C,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC3B,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,UAAU,CAAE,CAA6B,CAAC,OAAO,CAAC,CAAC,CACzF,CACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,GAAW;IAC5D,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,GAAG,GAAG,MAAM;QACnB,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,cAAc,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;SACzD,CAAC,CAAC;KACJ,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAA6B;IACjD,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;IACxB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAA;IACvB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,iBAAiB,CAC/B,QAAiC,EACjC,IAA6B;IAE7B,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAA;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,CAAA;IACtF,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,CAAA;AAC1E,CAAC"}

package/dist/seo/faq-signals.d.ts

@@ -0,0 +1,54 @@
+import type { AuditEntityInput } from './audit-engine.js';
+export interface FaqSignals {
+    geo: {
+        referralVisits: number;
+        retrievalHits: number;
+        engines: string[];
+    } | null;
+    queries: Array<{
+        query: string;
+        impressions: number;
+        clicks: number;
+    }>;
+}
+export declare const FAQ_SIGNAL_WINDOW_DAYS = 28;
+export declare const FAQ_QUERY_MIN_IMPRESSIONS = 10;
+export declare const FAQ_QUERY_MAX = 10;
+export declare const FAQ_QUERY_MAX_LEN = 120;
+export declare function isQuestionQuery(query: string): boolean;
+/**
+ * Pathname for matching GEO rows: leading `/`, no trailing slash,
+ * percent-decoded, lowercased, `/` for root. GEO rows are stored through
+ * `normalizeRedirectPath`, which lowercases; both sides go through this
+ * function so the comparison stays symmetric.
+ */
+export declare function entityPathname(url: string, siteUrl: string): string;
+export interface FaqSignalRows {
+    referrals: Array<{
+        path: string;
+        visits: number;
+        engines: string[];
+    }>;
+    retrievalCrawls: Array<{
+        path: string;
+        hits: number;
+    }>;
+    insights: Array<{
+        entityId: string | null;
+        path: string;
+        topQueries: unknown;
+    }>;
+}
+/**
+ * Pure detector — maps GEO daily rows and Search Console insight rows onto
+ * audited entities by pathname (or insight `entityId`). Entities without any
+ * signal are omitted from the result.
+ */
+export declare function detectFaqSignals(rows: FaqSignalRows, entities: Pick<AuditEntityInput, 'entityId' | 'url'>[], siteUrl: string): Record<string, FaqSignals>;
+/** DB wrapper — every read is optional; a missing table or a query error yields no signal. */
+export declare function gatherFaqSignals(db: unknown, entities: Pick<AuditEntityInput, 'entityId' | 'url'>[], opts: {
+    siteUrl: string;
+    now?: Date;
+    geoEnabled: boolean;
+}): Promise<Record<string, FaqSignals>>;
+//# sourceMappingURL=faq-signals.d.ts.map

package/dist/seo/faq-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-signals.d.ts","sourceRoot":"","sources":["../../src/seo/faq-signals.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAA;IAChF,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvE;AAED,eAAO,MAAM,sBAAsB,KAAK,CAAA;AACxC,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAC3C,eAAO,MAAM,aAAa,KAAK,CAAA;AAC/B,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAKpC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAItD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAcnE;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACrE,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtD,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAChF;AAkBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,KAAK,CAAC,EAAE,EACtD,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA8C5B;AAED,8FAA8F;AAC9F,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,KAAK,CAAC,EAAE,EACtD,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACzD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAmDrC"}

package/dist/seo/faq-signals.js

@@ -0,0 +1,176 @@
+/**
+ * Signals that a page attracts questions: AI-engine referrals / retrieval
+ * crawls (GEO measurement) and question-shaped Search Console queries.
+ * Pure detector + DB wrapper, mirroring `search-insight-signals.ts`.
+ * Consumed by the audit engine as `AuditExtraSignals.faqSignalsByEntityId`.
+ */
+import { hasModel } from '../api/route-helpers.js';
+import { startOfDayUTC } from './autopilot-ledger.js';
+import { GEO_OTHER_PATH } from './geo-record.js';
+export const FAQ_SIGNAL_WINDOW_DAYS = 28;
+export const FAQ_QUERY_MIN_IMPRESSIONS = 10;
+export const FAQ_QUERY_MAX = 10;
+export const FAQ_QUERY_MAX_LEN = 120;
+const QUESTION_START = /^(who|what|when|where|why|how|which|can|could|should|does|do|is|are|will)\b/i;
+export function isQuestionQuery(query) {
+    const q = query.trim();
+    if (!q)
+        return false;
+    return QUESTION_START.test(q) || q.endsWith('?');
+}
+/**
+ * Pathname for matching GEO rows: leading `/`, no trailing slash,
+ * percent-decoded, lowercased, `/` for root. GEO rows are stored through
+ * `normalizeRedirectPath`, which lowercases; both sides go through this
+ * function so the comparison stays symmetric.
+ */
+export function entityPathname(url, siteUrl) {
+    let pathname;
+    try {
+        pathname = new URL(url, siteUrl || 'https://localhost').pathname;
+    }
+    catch {
+        pathname = url.startsWith('/') ? url : `/${url}`;
+    }
+    try {
+        pathname = decodeURIComponent(pathname);
+    }
+    catch {
+        /* keep encoded */
+    }
+    const stripped = pathname.replace(/\/+$/, '').toLowerCase();
+    return stripped === '' ? '/' : stripped;
+}
+function questionRows(topQueries) {
+    if (!Array.isArray(topQueries))
+        return [];
+    const out = [];
+    for (const raw of topQueries) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const r = raw;
+        const query = typeof r.query === 'string' ? r.query.trim() : '';
+        const impressions = typeof r.impressions === 'number' ? r.impressions : 0;
+        const clicks = typeof r.clicks === 'number' ? r.clicks : 0;
+        if (!query || impressions < FAQ_QUERY_MIN_IMPRESSIONS || !isQuestionQuery(query))
+            continue;
+        out.push({ query: query.slice(0, FAQ_QUERY_MAX_LEN), impressions, clicks });
+    }
+    out.sort((a, b) => b.impressions - a.impressions);
+    return out.slice(0, FAQ_QUERY_MAX);
+}
+/**
+ * Pure detector — maps GEO daily rows and Search Console insight rows onto
+ * audited entities by pathname (or insight `entityId`). Entities without any
+ * signal are omitted from the result.
+ */
+export function detectFaqSignals(rows, entities, siteUrl) {
+    const byPath = new Map();
+    const byId = new Set();
+    for (const e of entities) {
+        byPath.set(entityPathname(e.url, siteUrl), e.entityId);
+        byId.add(e.entityId);
+    }
+    const out = {};
+    const ensure = (entityId) => (out[entityId] ??= { geo: null, queries: [] });
+    const geoOf = (entityId) => {
+        const s = ensure(entityId);
+        s.geo ??= { referralVisits: 0, retrievalHits: 0, engines: [] };
+        return s.geo;
+    };
+    for (const r of rows.referrals) {
+        if (r.path === GEO_OTHER_PATH)
+            continue;
+        const id = byPath.get(entityPathname(r.path, siteUrl));
+        if (!id)
+            continue;
+        const g = geoOf(id);
+        g.referralVisits += r.visits;
+        for (const eng of r.engines)
+            if (!g.engines.includes(eng))
+                g.engines.push(eng);
+    }
+    for (const c of rows.retrievalCrawls) {
+        if (c.path === GEO_OTHER_PATH)
+            continue;
+        const id = byPath.get(entityPathname(c.path, siteUrl));
+        if (!id)
+            continue;
+        geoOf(id).retrievalHits += c.hits;
+    }
+    for (const row of rows.insights) {
+        const id = (row.entityId && byId.has(row.entityId) ? row.entityId : null) ??
+            byPath.get(entityPathname(row.path, siteUrl));
+        if (!id)
+            continue;
+        const q = questionRows(row.topQueries);
+        if (q.length === 0)
+            continue;
+        const s = ensure(id);
+        s.queries = [...s.queries, ...q]
+            .sort((a, b) => b.impressions - a.impressions)
+            .slice(0, FAQ_QUERY_MAX);
+    }
+    for (const [id, s] of Object.entries(out)) {
+        if (s.geo)
+            s.geo.engines.sort();
+        if (!s.geo && s.queries.length === 0)
+            delete out[id];
+    }
+    return out;
+}
+/** DB wrapper — every read is optional; a missing table or a query error yields no signal. */
+export async function gatherFaqSignals(db, entities, opts) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Prisma boundary
+    const d = db;
+    const now = opts.now ?? new Date();
+    const from = startOfDayUTC(new Date(now.getTime() - (FAQ_SIGNAL_WINDOW_DAYS - 1) * 86_400_000));
+    const rows = { referrals: [], retrievalCrawls: [], insights: [] };
+    if (opts.geoEnabled && hasModel(d, 'geoReferralDaily')) {
+        try {
+            const grouped = await d.geoReferralDaily.groupBy({
+                by: ['path', 'engine'],
+                where: { date: { gte: from } },
+                _sum: { visits: true },
+            });
+            const byPath = new Map();
+            for (const g of grouped) {
+                const cur = byPath.get(g.path) ?? { visits: 0, engines: [] };
+                cur.visits += g._sum.visits ?? 0;
+                if (!cur.engines.includes(g.engine))
+                    cur.engines.push(g.engine);
+                byPath.set(g.path, cur);
+            }
+            rows.referrals = Array.from(byPath, ([path, v]) => ({ path, ...v }));
+        }
+        catch {
+            /* optional */
+        }
+    }
+    if (opts.geoEnabled && hasModel(d, 'geoCrawlDaily')) {
+        try {
+            const grouped = await d.geoCrawlDaily.groupBy({
+                by: ['path'],
+                where: { date: { gte: from }, category: 'retrieval' },
+                _sum: { hits: true },
+            });
+            rows.retrievalCrawls = grouped.map((g) => ({ path: g.path, hits: g._sum.hits ?? 0 }));
+        }
+        catch {
+            /* optional */
+        }
+    }
+    if (hasModel(d, 'searchPageInsight')) {
+        try {
+            rows.insights = await d.searchPageInsight.findMany({
+                select: { entityId: true, path: true, topQueries: true },
+                take: 5000,
+            });
+        }
+        catch {
+            /* optional */
+        }
+    }
+    return detectFaqSignals(rows, entities, opts.siteUrl);
+}
+//# sourceMappingURL=faq-signals.js.map

package/dist/seo/faq-signals.js.map

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

package/dist/seo/geo-record.d.ts

@@ -0,0 +1,75 @@
+import type { AiBotCategory } from './ai-bots.js';
+export { GEO_RETENTION_DEFAULT_DAYS, GEO_RETENTION_MAX_DAYS, GEO_RETENTION_MIN_DAYS, clampGeoRetentionDays, } from './geo-retention.js';
+/**
+ * Max distinct paths per `(date, bot)` — the rest of that bot's day rolls into
+ * {@link GEO_OTHER_PATH}, so a crawler (or an attacker replaying the public
+ * beacon) cannot grow the table by inventing paths.
+ *
+ * This is a **soft bound**: the distinct-path count is memoised per isolate
+ * for {@link GEO_CAP_MEMO_MS}, so N cold isolates (serverless) that each read
+ * a below-cap count in the same minute can together overshoot to ≈ N × cap
+ * rows for that `(date, actor)` before their memos expire. Bounded, not exact.
+ */
+export declare const GEO_CRAWL_PATH_CAP = 500;
+/**
+ * Same cap and the same soft-bound caveat, keyed by `(date, engine)`. Referral
+ * beacons are as unauthenticated as crawl beacons, so "a path must exist on
+ * the site to be linked" is not a property the server can rely on.
+ */
+export declare const GEO_REFERRAL_PATH_CAP = 500;
+export declare const GEO_OTHER_PATH = "(other)";
+/** How long a `(date, actor)` distinct-path count is trusted before re-counting. */
+export declare const GEO_CAP_MEMO_MS = 60000;
+/** How long the kill-switch setting is trusted before re-reading it. */
+export declare const GEO_SETTINGS_MEMO_MS = 30000;
+/** Minimum gap between two storage-failure `console.warn`s per process. */
+export declare const GEO_WARN_THROTTLE_MS = 60000;
+export declare const GEO_MAX_PATH_LEN = 2048;
+export declare const GEO_MAX_ACTOR_LEN = 64;
+/** Largest `POST /geo/beacon` body accepted; a real payload is under 200 bytes. */
+export declare const GEO_MAX_BEACON_BYTES = 4096;
+export type GeoRecordOutcome = 'recorded' | 'other' | 'skipped';
+/** Body of `POST /geo/beacon` — the only thing the middleware ever transmits. */
+export interface GeoBeaconPayload {
+    kind: 'crawl' | 'referral';
+    /** Bot token (crawl) or engine name (referral). Validated against the server registry. */
+    actor: string;
+    /** Advisory only — the server re-derives it from the registry. */
+    category?: AiBotCategory;
+    /** `url.pathname` only. */
+    path: string;
+}
+/** UTC calendar day — the same convention as `SearchPerfDaily`. */
+export declare function geoDay(now: Date): Date;
+/**
+ * Site-relative path for storage: lower-cased, no query/hash, no trailing
+ * slash. Absolute URLs, over-long inputs and anything outside
+ * {@link GEO_PATH_CHARS} are rejected (`null` → the hit is dropped).
+ */
+export declare function normalizeGeoPath(input: string): string | null;
+/** Test hook; also called after a successful settings write so it takes effect at once. */
+export declare function resetGeoSettingsMemo(): void;
+/**
+ * `SeoModuleSettings.geoMeasurementEnabled`, memoised for
+ * {@link GEO_SETTINGS_MEMO_MS}. Both writers consult it, so flipping the switch
+ * stops server-side recording as well as the beacon. `getSeoOverrides` never
+ * throws (it returns `null` on any read failure), which resolves to the
+ * default — measurement on.
+ */
+export declare function isGeoMeasurementEnabled(db: unknown): Promise<boolean>;
+/** Test hook. */
+export declare function resetGeoWarnThrottle(): void;
+/** Test hook. */
+export declare function resetGeoCapMemo(): void;
+export declare function recordGeoCrawl(db: unknown, input: {
+    bot: string;
+    category: AiBotCategory;
+    path: string;
+    now?: Date;
+}): Promise<GeoRecordOutcome>;
+export declare function recordGeoReferral(db: unknown, input: {
+    engine: string;
+    path: string;
+    now?: Date;
+}): Promise<GeoRecordOutcome>;
+//# sourceMappingURL=geo-record.d.ts.map

package/dist/seo/geo-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-record.d.ts","sourceRoot":"","sources":["../../src/seo/geo-record.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIjD,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,MAAqB,CAAA;AACvD,eAAO,MAAM,cAAc,YAAY,CAAA;AACvC,oFAAoF;AACpF,eAAO,MAAM,eAAe,QAAS,CAAA;AACrC,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAC1C,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAE1C,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,eAAO,MAAM,iBAAiB,KAAK,CAAA;AACnC,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;AAE/D,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,GAAG,UAAU,CAAA;IAC1B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;CACb;AAgBD,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAEtC;AAUD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAMD,2FAA2F;AAC3F,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E;AAMD,iBAAiB;AACjB,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAwBD,iBAAiB;AACjB,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AA6FD,wBAAsB,cAAc,CAClC,EAAE,EAAE,OAAO,EACX,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,GACxE,OAAO,CAAC,gBAAgB,CAAC,CAwB3B;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,OAAO,EACX,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,GAClD,OAAO,CAAC,gBAAgB,CAAC,CAuB3B"}