@prenta/core 7.6.6 → 7.7.1

package/dist/api/routes/seo/handlers/public-files.js

@@ -0,0 +1,328 @@
+import { getPrentaConfig } from '../../../../config/runtime.js';
+import { recordAiCrawlerFromRequest, recordAiCrawlerHit } from '../../../../seo/ai-crawler-log.js';
+import { detectAiBot } from '../../../../seo/ai-bots.js';
+import { json, errorResponse, internalError, hasModel, requireAuth, } from '../../../route-helpers.js';
+import { db } from './shared.js';
+export async function getLlmsTxt(request) {
+    try {
+        // Public surface: must exclude soft-deleted docs and internal/system
+        // collections (e.g. `__seo_config__`). Over-fetch then filter so the
+        // 50-page cap still lands on real content after exclusion.
+        const { isInternalCollection } = await import('../../../../seo/audit-runner.js');
+        const { siteUrlFromRequest, loadEffectiveConfig } = await import('../../seo-public.js');
+        // Layer DB overrides (Settings → SEO) so an admin-edited siteName /
+        // defaultMetaDescription flows into the llms heading + summary too, exactly
+        // as sitemap.xml, robots.txt, /og.png and the feeds already do.
+        const cfg = (await loadEffectiveConfig()) ?? getPrentaConfig();
+        const llmsCfg = cfg?.seo?.llms;
+        const base = siteUrlFromRequest(request, cfg);
+        // Operators can disable the file entirely (it's optionality, not a
+        // guaranteed traffic channel).
+        if (llmsCfg?.disabled) {
+            return new Response('Not found', { status: 404 });
+        }
+        const maxEntries = llmsCfg?.maxEntries ?? 50;
+        const maxPerSection = llmsCfg?.maxPerSection ?? 25;
+        // Restrict AUTO selection to the configured high-value collections when
+        // set, so blog archives don't flood the curated guide.
+        const eligible = Array.isArray(llmsCfg?.eligibleCollections) && llmsCfg.eligibleCollections.length > 0
+            ? new Set(llmsCfg.eligibleCollections)
+            : null;
+        const rawDocs = await db().document.findMany({
+            where: { status: 'PUBLISHED', deletedAt: null },
+            select: { title: true, slug: true, collection: true, updatedAt: true, data: true },
+            orderBy: { updatedAt: 'desc' },
+            take: 500,
+        });
+        // Per-doc curation + privacy boundary (noindex exclusion) live in the
+        // shared selector so `/llms.txt` and `/llms-full.txt` can never diverge.
+        const { selectLlmsDocs, toLlmsPage } = await import('../../../../seo/llms-select.js');
+        const selected = selectLlmsDocs(rawDocs, { isInternalCollection, eligible });
+        const { generateLlmsTxt } = await import('../../../../seo/llms-txt.js');
+        const pages = selected.map((d) => toLlmsPage(d, {
+            base,
+            urlPrefix: cfg?.collections?.[d.collection]?.urlPrefix,
+            trailingSlash: cfg?.seo?.trailingSlash,
+        }));
+        const txt = generateLlmsTxt({
+            siteName: cfg?.seo?.siteName || 'Prenta CMS',
+            siteUrl: base,
+            siteDescription: llmsCfg?.summary || cfg?.seo?.defaultMetaDescription || 'Content managed by Prenta CMS',
+            intro: llmsCfg?.intro,
+            maxPages: maxEntries,
+            maxPerSection,
+        }, pages);
+        // Opt-in honeypot: append a unique trap link. No human reads llms.txt, so
+        // a fetch of this URL is an automated reader — recorded under the
+        // "honeypot" surface in the AI-crawler panel.
+        let body = txt;
+        if (llmsCfg?.honeypot) {
+            const trapUrl = `${base.replace(/\/$/, '')}/api/cms/ai-crawlers/trap`;
+            body += `\n## Reference\n\n- [Complete content index](${trapUrl}): Full machine-readable content map.\n`;
+        }
+        // Measurement: if a known AI crawler fetched the index, count it.
+        await recordAiCrawlerFromRequest(db(), request, 'llms');
+        return new Response(body, {
+            status: 200,
+            headers: {
+                'Content-Type': 'text/plain; charset=utf-8',
+                // The file itself is a machine-facing index, not a page to rank.
+                'X-Robots-Tag': 'noindex',
+                // Same CDN TTL as robots.txt — the index is cheap to regenerate
+                // after publish but should not be fetched on every agent request.
+                'Cache-Control': 'public, max-age=3600, s-maxage=3600',
+            },
+        });
+    }
+    catch (err) {
+        return internalError(err, 'llms.txt');
+    }
+}
+// `/llms-full.txt` — same curated selection as `/llms.txt`, but inlines each
+// page's content rendered to clean Markdown so an agent can read the actual
+// body without fetching every URL. Opt-in (these files get large) and bounded
+// by a byte budget. noindex + never in the sitemap; HTML stays canonical.
+export async function getLlmsFullTxt(request) {
+    try {
+        const { isInternalCollection } = await import('../../../../seo/audit-runner.js');
+        const { siteUrlFromRequest, loadEffectiveConfig } = await import('../../seo-public.js');
+        // Honor admin overrides (siteName / summary / defaultMetaDescription) the
+        // same way `/llms.txt` and the other public SEO surfaces do.
+        const cfg = (await loadEffectiveConfig()) ?? getPrentaConfig();
+        const llmsCfg = cfg?.seo?.llms;
+        const base = siteUrlFromRequest(request, cfg);
+        // Gated independently from `/llms.txt`: must be both enabled overall and
+        // have the full variant turned on.
+        if (llmsCfg?.disabled || !llmsCfg?.fullEnabled) {
+            return new Response('Not found', { status: 404 });
+        }
+        const maxEntries = llmsCfg?.maxEntries ?? 50;
+        const maxBytes = llmsCfg?.maxFullBytes ?? 2_000_000;
+        const eligible = Array.isArray(llmsCfg?.eligibleCollections) && llmsCfg.eligibleCollections.length > 0
+            ? new Set(llmsCfg.eligibleCollections)
+            : null;
+        const rawDocs = await db().document.findMany({
+            where: { status: 'PUBLISHED', deletedAt: null },
+            select: {
+                title: true,
+                slug: true,
+                collection: true,
+                updatedAt: true,
+                data: true,
+                plainText: true,
+            },
+            orderBy: { updatedAt: 'desc' },
+            take: 500,
+        });
+        const { selectLlmsDocs, toLlmsPage } = await import('../../../../seo/llms-select.js');
+        const { documentToMarkdown } = await import('../../../../seo/content-markdown.js');
+        const selected = selectLlmsDocs(rawDocs, { isInternalCollection, eligible }).slice(0, maxEntries);
+        const header = [
+            `# ${cfg?.seo?.siteName || 'Prenta CMS'}`,
+            '',
+            `> ${llmsCfg?.summary || cfg?.seo?.defaultMetaDescription || 'Full content export for AI agents.'}`,
+            '',
+        ].join('\n');
+        const chunks = [header];
+        let bytes = Buffer.byteLength(header, 'utf8');
+        let truncated = false;
+        for (const d of selected) {
+            const page = toLlmsPage(d, {
+                base,
+                urlPrefix: cfg?.collections?.[d.collection]?.urlPrefix,
+                trailingSlash: cfg?.seo?.trailingSlash,
+            });
+            const md = documentToMarkdown({
+                title: d.title,
+                data: d.data,
+                plainText: d.plainText,
+            }, { baseUrl: base });
+            // Each entry is delimited by a horizontal rule and carries its canonical
+            // URL so the inlined content stays traceable back to the live page.
+            const block = `\n---\n\nURL: ${page.url}\n\n${md}\n`;
+            const blockBytes = Buffer.byteLength(block, 'utf8');
+            if (bytes + blockBytes > maxBytes) {
+                truncated = true;
+                break;
+            }
+            chunks.push(block);
+            bytes += blockBytes;
+        }
+        if (truncated) {
+            chunks.push('\n---\n\n> Output truncated at the configured size limit.\n');
+        }
+        await recordAiCrawlerFromRequest(db(), request, 'llms-full');
+        return new Response(chunks.join(''), {
+            status: 200,
+            headers: {
+                'Content-Type': 'text/plain; charset=utf-8',
+                'X-Robots-Tag': 'noindex',
+                'Cache-Control': 'public, max-age=3600, s-maxage=3600',
+            },
+        });
+    }
+    catch (err) {
+        return internalError(err, 'llms-full.txt');
+    }
+}
+// Per-page Markdown: `GET /md?path=/about` returns a clean Markdown rendering
+// of a single published page so an agent can fetch the content, not just the
+// link. Fresh installs expose this at clean `/{path}.md` URLs via a scaffolded
+// rewrite. CRITICAL: always noindex, never in the sitemap — the HTML page
+// stays canonical (per-page `.md` is the most common duplicate-content trap).
+export async function getMarkdownForPath(request) {
+    try {
+        const cfg = getPrentaConfig();
+        const url = new URL(request.url);
+        const pathParam = url.searchParams.get('path');
+        if (!pathParam) {
+            return errorResponse('Missing required "path" query parameter', 400);
+        }
+        // Part of the AI/agent layer — honor the same master switch as llms.txt.
+        if (cfg?.seo?.llms?.disabled) {
+            return new Response('Not found', { status: 404 });
+        }
+        const { matchPathToCollection } = await import('../../../../seo/resolve-path.js');
+        const match = matchPathToCollection(cfg, pathParam);
+        if (!match) {
+            return new Response('Not found', { status: 404 });
+        }
+        const slugFilter = match.isRoot
+            ? {
+                OR: [
+                    { data: { path: ['slug'], equals: 'home' } },
+                    { data: { path: ['slug'], equals: 'index' } },
+                    { slug: 'home' },
+                    { slug: 'index' },
+                ],
+            }
+            : {
+                OR: [{ data: { path: ['slug'], equals: match.slug } }, { slug: match.slug }],
+            };
+        const doc = await db().document.findFirst({
+            where: {
+                collection: match.collection,
+                deletedAt: null,
+                status: 'PUBLISHED',
+                ...slugFilter,
+            },
+            select: { title: true, data: true, plainText: true },
+        });
+        if (!doc) {
+            return new Response('Not found', { status: 404 });
+        }
+        const data = doc.data || {};
+        // The selection filter is the privacy boundary: noindexed or explicitly
+        // excluded pages must not be fetchable as Markdown either.
+        const { isLlmsNoindex, readLlmsInclude } = await import('../../../../seo/llms-select.js');
+        if (isLlmsNoindex(data) || readLlmsInclude(data) === 'NEVER') {
+            return new Response('Not found', { status: 404 });
+        }
+        const { documentToMarkdown } = await import('../../../../seo/content-markdown.js');
+        const { siteUrlFromRequest } = await import('../../seo-public.js');
+        const base = siteUrlFromRequest(request, cfg);
+        const md = documentToMarkdown({ title: doc.title, data, plainText: doc.plainText }, { baseUrl: base });
+        await recordAiCrawlerFromRequest(db(), request, 'md');
+        return new Response(md, {
+            status: 200,
+            headers: {
+                'Content-Type': 'text/markdown; charset=utf-8',
+                'X-Robots-Tag': 'noindex',
+            },
+        });
+    }
+    catch (err) {
+        return internalError(err, 'md');
+    }
+}
+// Honeypot: a unique trap URL appended to llms.txt only when
+// `seo.llms.honeypot` is enabled. No human visits it, so any fetch is an
+// automated reader that followed a link from the file. Always records (even
+// if the flag was later turned off, a cached llms.txt may still point here)
+// and returns a tiny noindex body.
+export async function getAiCrawlerTrap(request) {
+    try {
+        const detected = detectAiBot(request.headers.get('user-agent'));
+        await recordAiCrawlerHit(db(), {
+            bot: detected?.token ?? 'unknown',
+            surface: 'honeypot',
+            category: detected?.category ?? 'other',
+        });
+        return new Response('This endpoint exists to detect automated indexers.\n', {
+            status: 200,
+            headers: {
+                'Content-Type': 'text/plain; charset=utf-8',
+                'X-Robots-Tag': 'noindex',
+            },
+        });
+    }
+    catch (err) {
+        return internalError(err, 'ai-crawlers/trap');
+    }
+}
+// Admin: aggregated AI-crawler activity for the SEO → Technical panel.
+// Any authenticated admin may read it (analytics, not a mutation).
+export async function getAiCrawlers(request) {
+    try {
+        const auth = await requireAuth(request);
+        if (auth.error)
+            return auth.error;
+        if (!hasModel(db(), 'aiCrawlerHit')) {
+            return json({
+                data: { enabled: false, rows: [], totals: { hits: 0, bots: 0, honeypot: 0 } },
+            });
+        }
+        const rows = await db().aiCrawlerHit.findMany({
+            orderBy: { lastSeenAt: 'desc' },
+            take: 500,
+        });
+        const totalHits = rows.reduce((sum, r) => sum + Number(r.hits ?? 0), 0);
+        const honeypotHits = rows
+            .filter((r) => r.surface === 'honeypot')
+            .reduce((sum, r) => sum + Number(r.hits ?? 0), 0);
+        const uniqueBots = new Set(rows.map((r) => r.bot)).size;
+        // Recency windowing. `hits` is a lifetime cumulative counter (one row per
+        // bot×surface), so we can't derive per-window hit *counts* from it — but
+        // `lastSeenAt` lets us answer the actionable question "which bots/surfaces
+        // were active in the last 24h / 7d". Per-window hit-count trends would
+        // need a (bot, surface, day) bucket table (a future additive migration);
+        // this keeps storage bounded while making recency visible today.
+        const nowMs = Date.now();
+        const DAY_MS = 24 * 60 * 60 * 1000;
+        const within = (v, ms) => {
+            if (!v)
+                return false;
+            const t = v instanceof Date ? v.getTime() : new Date(v).getTime();
+            return Number.isFinite(t) && nowMs - t <= ms;
+        };
+        const windowSummary = (ms) => {
+            const active = rows.filter((r) => within(r.lastSeenAt, ms));
+            return {
+                bots: new Set(active.map((r) => r.bot)).size,
+                surfaces: new Set(active.map((r) => r.surface)).size,
+                rows: active.length,
+            };
+        };
+        return json({
+            data: {
+                enabled: true,
+                rows: rows.map((r) => ({
+                    bot: r.bot,
+                    surface: r.surface,
+                    category: r.category,
+                    hits: Number(r.hits ?? 0),
+                    firstSeenAt: r.firstSeenAt,
+                    lastSeenAt: r.lastSeenAt,
+                    activeLast24h: within(r.lastSeenAt, DAY_MS),
+                    activeLast7d: within(r.lastSeenAt, 7 * DAY_MS),
+                })),
+                totals: { hits: totalHits, bots: uniqueBots, honeypot: honeypotHits },
+                windows: { last24h: windowSummary(DAY_MS), last7d: windowSummary(7 * DAY_MS) },
+            },
+        });
+    }
+    catch (err) {
+        return internalError(err, 'ai-crawlers');
+    }
+}
+//# sourceMappingURL=public-files.js.map

package/dist/api/routes/seo/handlers/public-files.js.map

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

package/dist/api/routes/seo/handlers/shared.d.ts

@@ -0,0 +1,24 @@
+import { assertPlanFeature } from '../../../../plan/features.js';
+import { guardedDb } from '../../../guarded-db.js';
+import { type AuthSession } from '../../../route-helpers.js';
+export declare const db: typeof guardedDb;
+export declare const seoLogger: import("../../../../diagnostics/logger.js").ScopedLogger;
+export declare function planRequiredResponse(denial: NonNullable<ReturnType<typeof assertPlanFeature>>): Response;
+export declare function mapInternalLinkInsertError(err: unknown): Response | null;
+export declare function seoAiGenerationError(result: {
+    code: string;
+    message: string;
+}): Response;
+/** Sort issues by risk (critical → warning → info), then most-recent first. */
+export declare function sortIssuesBySeverity<T extends {
+    severity?: unknown;
+    lastDetectedAt?: unknown;
+}>(issues: T[]): T[];
+/**
+ * Content-writing fix strategies (`add-section`, `insert-link`, `fix-link`)
+ * write a document the route cannot name up front, so the API-key collection
+ * scope is checked inside `applyIssueFix` once the collection is known. JWT
+ * sessions already passed the route's `WRITE_ROLES` check and are never denied.
+ */
+export declare function contentWriteGate(session: AuthSession): (collection: string) => string | null;
+//# sourceMappingURL=shared.d.ts.map

package/dist/api/routes/seo/handlers/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/api/routes/seo/handlers/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAA;AAElC,eAAO,MAAM,EAAE,kBAAY,CAAA;AAK3B,eAAO,MAAM,SAAS,0DAAsB,CAAA;AAO5C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,GACxD,QAAQ,CAUV;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAgBxE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAQxF;AACD,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7F,MAAM,EAAE,CAAC,EAAE,GACV,CAAC,EAAE,CAQL;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAE5F"}

package/dist/api/routes/seo/handlers/shared.js

@@ -0,0 +1,67 @@
+import { createLogger } from '../../../../diagnostics/logger.js';
+import { guardedDb } from '../../../guarded-db.js';
+import { apiKeyCollectionScopeDenial, errorResponse, json, } from '../../../route-helpers.js';
+export const db = guardedDb;
+// Explicit risk order. A plain `severity: 'asc'` DB sort orders the values
+// alphabetically (critical, info, warning) which wrongly ranks `info` above
+// `warning`. Unknown severities sort last.
+export const seoLogger = createLogger('seo');
+const SEVERITY_RANK = { critical: 0, warning: 1, info: 2 };
+function severityRank(severity) {
+    return SEVERITY_RANK[String(severity)] ?? 99;
+}
+export function planRequiredResponse(denial) {
+    return json({
+        error: denial.message,
+        code: 'plan_required',
+        requiredTier: denial.requiredTier,
+        feature: denial.feature,
+    }, 403);
+}
+export function mapInternalLinkInsertError(err) {
+    const msg = err instanceof Error ? err.message : '';
+    switch (msg) {
+        case 'SOURCE_NOT_FOUND':
+            return errorResponse('Source document not found', 404);
+        case 'TARGET_NOT_FOUND':
+            return errorResponse('Target document not found', 404);
+        case 'NOT_WRAPPABLE':
+            return errorResponse('Anchor is not wrappable in the live source document.', 422);
+        case 'ALREADY_LINKED':
+            return errorResponse('Source already links to this target.', 422);
+        case 'TARGET_PATH_MISMATCH':
+            return errorResponse('Target path does not match the live document.', 422);
+        default:
+            return null;
+    }
+}
+export function seoAiGenerationError(result) {
+    if (result.code === 'unavailable' || result.code === 'feature_disabled') {
+        return errorResponse(result.message, 503);
+    }
+    if (result.code === 'rate_limited' || result.code === 'budget_exceeded') {
+        return errorResponse(result.message, 429);
+    }
+    return errorResponse(result.message, 422);
+}
+/** Sort issues by risk (critical → warning → info), then most-recent first. */
+export function sortIssuesBySeverity(issues) {
+    return [...issues].sort((a, b) => {
+        const rankDiff = severityRank(a.severity) - severityRank(b.severity);
+        if (rankDiff !== 0)
+            return rankDiff;
+        const at = a.lastDetectedAt ? new Date(a.lastDetectedAt).getTime() : 0;
+        const bt = b.lastDetectedAt ? new Date(b.lastDetectedAt).getTime() : 0;
+        return bt - at;
+    });
+}
+/**
+ * Content-writing fix strategies (`add-section`, `insert-link`, `fix-link`)
+ * write a document the route cannot name up front, so the API-key collection
+ * scope is checked inside `applyIssueFix` once the collection is known. JWT
+ * sessions already passed the route's `WRITE_ROLES` check and are never denied.
+ */
+export function contentWriteGate(session) {
+    return (collection) => apiKeyCollectionScopeDenial(session, collection, 'update');
+}
+//# sourceMappingURL=shared.js.map

package/dist/api/routes/seo/handlers/shared.js.map

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

package/dist/api/routes/seo.d.ts

@@ -1,8 +1,8 @@
 import type { ApiRouter } from '../router.js';
-/** Sort issues by risk (critical → warning → info), then most-recent first. */
-export declare function sortIssuesBySeverity<T extends {
-    severity?: unknown;
-    lastDetectedAt?: unknown;
-}>(issues: T[]): T[];
+export { sortIssuesBySeverity } from './seo/handlers/shared.js';
+/**
+ * SEO HTTP routes. Handlers live under `./seo/handlers` so this file stays a
+ * registration list. Request behavior is unchanged.
+ */
 export declare function registerSeoRoutes(router: ApiRouter): void;
 //# sourceMappingURL=seo.d.ts.map

package/dist/api/routes/seo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../../src/api/routes/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AA4G7C,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7F,MAAM,EAAE,CAAC,EAAE,GACV,CAAC,EAAE,CAQL;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0vFzD"}
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../../src/api/routes/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAmD7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2CzD"}