@prenta/core 0.118.0

package/dist/seo/content-markdown.js

@@ -0,0 +1,235 @@
+/**
+ * Document → clean Markdown serialization for the AI/agent layer.
+ *
+ * Powers per-page `.md` output and `/llms-full.txt`. The goal is a faithful,
+ * readable rendering of the *content* (so an agent can fetch the page body, not
+ * just the link) — never the chrome, settings, ids, or URLs that live alongside
+ * it in the document model.
+ *
+ * HTML/rich-text slots are converted with Turndown; structured section content
+ * is walked generically (allow-listed prose/heading keys only) so new section
+ * types render acceptably without per-type code. Output is always `noindex`-only
+ * — callers must serve it with `X-Robots-Tag: noindex` and keep it out of the
+ * sitemap (the HTML page stays canonical).
+ */
+import TurndownService from 'turndown';
+import { getSectionType } from '../sections/registry.js';
+let _td = null;
+function turndown() {
+    if (!_td) {
+        _td = new TurndownService({
+            headingStyle: 'atx',
+            codeBlockStyle: 'fenced',
+            bulletListMarker: '-',
+            emDelimiter: '_',
+        });
+        // Drop code/style/embed containers so their inner text isn't flattened into
+        // the AI-facing export as noise (inert, but pure garbage in the .md/txt).
+        _td.remove(['script', 'style', 'noscript', 'template']);
+    }
+    return _td;
+}
+const HTML_LIKE = /<[a-z!/][\s\S]*>/i;
+// Markdown link/image target: captures the `[label]` (optionally `!`-prefixed
+// for images), the URL, and an optional ` "title"` suffix Turndown may emit.
+const MD_LINK_RE = /(!?\[[^\]]*\])\(([^)\s]+)((?:\s+"[^"]*")?)\)/g;
+/**
+ * Resolve a possibly-relative URL against the site base. Absolute URLs,
+ * protocol-relative (`//`), fragment (`#`), and non-navigational schemes
+ * (`mailto:`, `tel:`, `data:`) are left untouched.
+ */
+function absolutizeUrl(url, base) {
+    const u = url.trim();
+    if (!u)
+        return url;
+    if (/^[a-z][a-z0-9+.-]*:/i.test(u) || u.startsWith('//') || u.startsWith('#'))
+        return url;
+    try {
+        return new URL(u, base).href;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Rewrite relative link/image targets in Markdown to absolute URLs. The .md and
+ * /llms-full.txt exports are consumed off-host by AI agents, where a relative
+ * `/foo` has no resolvable base — so internal links and images would go dead.
+ */
+function absolutizeMarkdownUrls(md, base) {
+    if (!base)
+        return md;
+    return md.replace(MD_LINK_RE, (_m, label, url, title) => {
+        return `${label}(${absolutizeUrl(url, base)}${title})`;
+    });
+}
+/**
+ * Convert an HTML/rich-text fragment to Markdown. Plain text passes through.
+ * When `baseUrl` is provided, relative link/image targets are absolutized
+ * against it so the off-host export stays navigable.
+ */
+export function htmlToMarkdown(html, baseUrl) {
+    if (!html)
+        return '';
+    const s = String(html);
+    if (!HTML_LIKE.test(s))
+        return s.replace(/\s+/g, ' ').trim();
+    try {
+        const md = turndown().turndown(s).trim();
+        return baseUrl ? absolutizeMarkdownUrls(md, baseUrl) : md;
+    }
+    catch {
+        // Defensive: never throw from a public serializer — degrade to stripped text.
+        return s
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+}
+// Keys whose string values are prose paragraphs.
+const PROSE_KEYS = new Set([
+    'body',
+    'content',
+    'html',
+    'text',
+    'copy',
+    'description',
+    'answer',
+    'quote',
+    'excerpt',
+]);
+// Keys whose string values are headings/sub-headings within a section.
+const HEADING_KEYS = new Set([
+    'heading',
+    'title',
+    'subtitle',
+    'subheading',
+    'eyebrow',
+    'question',
+    'label',
+]);
+const MAX_DEPTH = 8;
+/**
+ * Render a published document to clean Markdown:
+ *   `# Title`, an optional one-line takeaway, then the body.
+ */
+export function documentToMarkdown(doc, options = {}) {
+    const data = (doc.data ?? {});
+    const baseUrl = options.baseUrl ?? undefined;
+    const out = [];
+    const title = firstString(data.metaTitle, doc.title, data.title) ?? 'Untitled';
+    out.push(`# ${oneLine(title)}`, '');
+    const intro = firstString(data.keyTakeaway, data.metaDescription, data.seoDescription);
+    if (intro) {
+        out.push(oneLine(intro), '');
+    }
+    const body = buildBody(data, baseUrl);
+    if (body) {
+        out.push(body);
+    }
+    else if (doc.plainText) {
+        out.push(String(doc.plainText).trim());
+    }
+    return collapseBlankLines(out.join('\n')).trim() + '\n';
+}
+function buildBody(data, baseUrl) {
+    const parts = [];
+    const sections = Array.isArray(data.sections) ? data.sections : null;
+    if (sections) {
+        for (const s of sections) {
+            collectFromSection(s, parts, baseUrl);
+        }
+    }
+    if (parts.length === 0 && data._layout && typeof data._layout === 'object') {
+        collectFromTree(data._layout, parts, 0, baseUrl);
+    }
+    if (parts.length === 0) {
+        const html = firstString(data.body, data.content, data.html);
+        if (html)
+            parts.push(htmlToMarkdown(html, baseUrl));
+    }
+    return parts
+        .map((p) => p.trim())
+        .filter(Boolean)
+        .join('\n\n')
+        .trim();
+}
+function collectFromSection(section, parts, baseUrl) {
+    if (!isRecord(section))
+        return;
+    if (section.visible === false)
+        return;
+    const content = section.content;
+    if (!isRecord(content))
+        return;
+    // Resolve which slots hold rich text (HTML) from the section-type registry,
+    // so we convert those with Turndown rather than treating them as plain text.
+    const richKeys = new Set();
+    const typeId = typeof section.sectionType === 'string' ? section.sectionType : '';
+    const def = typeId ? getSectionType(typeId) : undefined;
+    for (const field of def?.fields ?? []) {
+        if (field?.type === 'richText' && typeof field.key === 'string')
+            richKeys.add(field.key);
+    }
+    walkContent(content, richKeys, parts, 0, baseUrl);
+}
+function collectFromTree(node, parts, depth, baseUrl) {
+    if (depth > MAX_DEPTH || !isRecord(node))
+        return;
+    if (isRecord(node.data)) {
+        // Block data carries author content (richText body, headings, etc.).
+        walkContent(node.data, new Set(), parts, 0, baseUrl);
+    }
+    if (Array.isArray(node.children)) {
+        for (const child of node.children)
+            collectFromTree(child, parts, depth + 1, baseUrl);
+    }
+}
+function walkContent(obj, richKeys, parts, depth, baseUrl) {
+    if (depth > MAX_DEPTH)
+        return;
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            if (!trimmed)
+                continue;
+            if (richKeys.has(key) || HTML_LIKE.test(trimmed)) {
+                const md = htmlToMarkdown(trimmed, baseUrl);
+                if (md)
+                    parts.push(md);
+            }
+            else if (HEADING_KEYS.has(key)) {
+                parts.push(`## ${oneLine(trimmed)}`);
+            }
+            else if (PROSE_KEYS.has(key)) {
+                parts.push(oneLine(trimmed));
+            }
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                if (isRecord(item))
+                    walkContent(item, richKeys, parts, depth + 1, baseUrl);
+            }
+        }
+        else if (isRecord(value)) {
+            walkContent(value, richKeys, parts, depth + 1, baseUrl);
+        }
+    }
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function firstString(...candidates) {
+    for (const c of candidates) {
+        if (typeof c === 'string' && c.trim())
+            return c;
+    }
+    return undefined;
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function collapseBlankLines(s) {
+    return s.replace(/\n{3,}/g, '\n\n');
+}
+//# sourceMappingURL=content-markdown.js.map

package/dist/seo/content-markdown.js.map

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

package/dist/seo/document-content.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Single-copy document body for SEO analysis / readability.
+ *
+ * Distinct from `contentBlobForLinkScan`, which re-appends `body`/`content` and
+ * JSON-stringifies sections (correct for href harvesting, wrong for word count).
+ */
+export interface DocumentContentInput {
+    data?: unknown;
+    plainText?: string | null;
+}
+/**
+ * Build the HTML/prose blob used by `/seo/analysis` and `/seo/readability`.
+ * Uses a single body/content copy (never both), optionally enriched with
+ * section prose. Falls back to `plainText` when body is empty (section-built
+ * pages often store the full extract there).
+ */
+export declare function documentContentForSeoAnalysis(doc: DocumentContentInput): string;
+//# sourceMappingURL=document-content.d.ts.map

package/dist/seo/document-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-content.d.ts","sourceRoot":"","sources":["../../src/seo/document-content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAuB/E"}

package/dist/seo/document-content.js

@@ -0,0 +1,80 @@
+/**
+ * Single-copy document body for SEO analysis / readability.
+ *
+ * Distinct from `contentBlobForLinkScan`, which re-appends `body`/`content` and
+ * JSON-stringifies sections (correct for href harvesting, wrong for word count).
+ */
+const HTML_LIKE = /<\/?[a-z][\s\S]*>/i;
+function asRecord(v) {
+    return v && typeof v === 'object' && !Array.isArray(v) ? v : null;
+}
+function str(v) {
+    return typeof v === 'string' && v.trim() ? v : undefined;
+}
+function collectStrings(value, out, depth) {
+    if (depth > 6 || value == null)
+        return;
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (trimmed)
+            out.push(trimmed);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectStrings(item, out, depth + 1);
+        return;
+    }
+    const rec = asRecord(value);
+    if (!rec)
+        return;
+    for (const v of Object.values(rec))
+        collectStrings(v, out, depth + 1);
+}
+function sectionsToHtml(sections) {
+    if (!Array.isArray(sections))
+        return '';
+    const parts = [];
+    for (const section of sections) {
+        const rec = asRecord(section);
+        if (!rec || rec.visible === false)
+            continue;
+        const content = asRecord(rec.content) ?? rec;
+        const chunks = [];
+        collectStrings(content, chunks, 0);
+        for (const chunk of chunks) {
+            parts.push(HTML_LIKE.test(chunk) ? chunk : `<p>${chunk}</p>`);
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Build the HTML/prose blob used by `/seo/analysis` and `/seo/readability`.
+ * Uses a single body/content copy (never both), optionally enriched with
+ * section prose. Falls back to `plainText` when body is empty (section-built
+ * pages often store the full extract there).
+ */
+export function documentContentForSeoAnalysis(doc) {
+    const data = asRecord(doc.data) ?? {};
+    const body = str(data.body);
+    const contentField = str(data.content);
+    // Prefer `body` over `content` — never concatenate both (they often duplicate).
+    const primary = body ?? contentField;
+    const fromSections = sectionsToHtml(data.sections);
+    const plain = typeof doc.plainText === 'string' ? doc.plainText.trim() : '';
+    const parts = [];
+    if (primary)
+        parts.push(primary);
+    if (fromSections)
+        parts.push(fromSections);
+    if (parts.length === 0)
+        return plain;
+    // Section-built pages: sections may only hold short headings while `plainText`
+    // is the full indexed extract. Prefer the richer plainText when there is no
+    // authored body/content field.
+    if (!primary && plain && plain.length > parts.join('\n').length) {
+        return plain;
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=document-content.js.map

package/dist/seo/document-content.js.map

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

package/dist/seo/document-path.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Client-safe document public path helpers (zero Node / server dependencies).
+ * Shared by cms-admin preview/live URL builders and the SEO meta composer.
+ */
+/**
+ * Site-relative public path for a document — the single authority every
+ * View-live / preview / share / nav builder must use (see serving contract).
+ *
+ * Precedence:
+ *   1. explicit `data.path` (or `path` alias) →
+ *   2. home/index/empty slug → `/` →
+ *   3. `<urlPrefix>/<slug>`.
+ */
+export declare function documentPublicPath(params: {
+    urlPrefix?: string | null;
+    slug?: string | null;
+    data?: Record<string, unknown> | null;
+    /** Convenience alias for `data.path` when callers already have a path string. */
+    path?: string | null;
+}): string;
+/**
+ * Resolve the canonical public URL for a document. Shared by the public meta
+ * composer and the XML sitemap so the two cannot disagree.
+ *
+ * Precedence mirrors {@link documentPublicPath}.
+ */
+export declare function resolveDocumentUrl(params: {
+    siteUrl: string;
+    urlPrefix?: string | null;
+    slug?: string | null;
+    data?: Record<string, unknown> | null;
+}): string;
+//# sourceMappingURL=document-path.d.ts.map

package/dist/seo/document-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-path.d.ts","sourceRoot":"","sources":["../../src/seo/document-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACrC,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,GAAG,MAAM,CAeT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACtC,GAAG,MAAM,CAKT"}

package/dist/seo/document-path.js

@@ -0,0 +1,44 @@
+/**
+ * Client-safe document public path helpers (zero Node / server dependencies).
+ * Shared by cms-admin preview/live URL builders and the SEO meta composer.
+ */
+function trimTrailingSlash(url) {
+    return url.replace(/\/+$/, '');
+}
+/**
+ * Site-relative public path for a document — the single authority every
+ * View-live / preview / share / nav builder must use (see serving contract).
+ *
+ * Precedence:
+ *   1. explicit `data.path` (or `path` alias) →
+ *   2. home/index/empty slug → `/` →
+ *   3. `<urlPrefix>/<slug>`.
+ */
+export function documentPublicPath(params) {
+    const data = params.data ?? {};
+    const fromAlias = typeof params.path === 'string' ? params.path.trim() : '';
+    const explicitPath = fromAlias || (typeof data.path === 'string' ? data.path.trim() : '');
+    if (explicitPath) {
+        const normalized = `/${explicitPath.replace(/^\/+|\/+$/g, '')}`;
+        return normalized === '/' ? '/' : normalized;
+    }
+    const slug = ((params.slug ?? data.slug ?? '') || '').replace(/^\/+|\/+$/g, '');
+    if (slug === 'home' || slug === 'index' || slug === '')
+        return '/';
+    const prefix = (params.urlPrefix ?? '').replace(/^\/+|\/+$/g, '');
+    return prefix ? `/${prefix}/${slug}` : `/${slug}`;
+}
+/**
+ * Resolve the canonical public URL for a document. Shared by the public meta
+ * composer and the XML sitemap so the two cannot disagree.
+ *
+ * Precedence mirrors {@link documentPublicPath}.
+ */
+export function resolveDocumentUrl(params) {
+    const base = trimTrailingSlash(params.siteUrl);
+    const path = documentPublicPath(params);
+    if (path === '/')
+        return base || '/';
+    return `${base}${path}`;
+}
+//# sourceMappingURL=document-path.js.map

package/dist/seo/document-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-path.js","sourceRoot":"","sources":["../../src/seo/document-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAMlC;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAC9B,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3E,MAAM,YAAY,GAAG,SAAS,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACzF,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAA;QAC/D,OAAO,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAA;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,IAAK,IAAI,CAAC,IAA2B,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CACnF,YAAY,EACZ,EAAE,CACH,CAAA;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,GAAG,CAAA;IAClE,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IACjE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAKlC;IACC,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,IAAI,GAAG,CAAA;IACpC,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,CAAA;AACzB,CAAC"}

package/dist/seo/feeds.d.ts

@@ -0,0 +1,44 @@
+/**
+ * RSS 2.0 + JSON Feed 1.1 builders.
+ *
+ * Feeds are how readers, aggregators, and increasingly AI agents subscribe to
+ * fresh content without polling HTML. These are pure functions over an already
+ * resolved item list so they are trivially testable; the route layer
+ * (`seo-public.ts`) does the DB work and URL resolution.
+ */
+export interface FeedItem {
+    /** Absolute, canonical URL — also used as the stable GUID / id. */
+    url: string;
+    title: string;
+    /** Plain-text summary (key takeaway / meta description / excerpt). */
+    description?: string;
+    /**
+     * Full article body as HTML. Emitted as `<content:encoded>` (RSS) and
+     * `content_html` (JSON Feed) so subscribers receive the whole post, not just
+     * a title stub. Optional — when absent, feeds fall back to a text content
+     * field derived from the summary so the JSON Feed "content_html or
+     * content_text must be present" rule is never violated.
+     */
+    content?: string;
+    /** ISO 8601 timestamp of publication. */
+    date?: string;
+    /** ISO 8601 timestamp of last modification (when newer than `date`). */
+    dateModified?: string;
+    author?: string;
+}
+export interface FeedChannel {
+    title: string;
+    /** Site home page URL. */
+    homeUrl: string;
+    /** Absolute URL of this feed document. */
+    feedUrl: string;
+    description?: string;
+    /** ISO 8601 timestamp of the newest item / build. */
+    updated?: string;
+    language?: string;
+}
+/** Build an RSS 2.0 document. */
+export declare function buildRssFeed(channel: FeedChannel, items: FeedItem[]): string;
+/** Build a JSON Feed 1.1 document (https://www.jsonfeed.org/version/1.1/). */
+export declare function buildJsonFeed(channel: FeedChannel, items: FeedItem[]): string;
+//# sourceMappingURL=feeds.d.ts.map

package/dist/seo/feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.ts","sourceRoot":"","sources":["../../src/seo/feeds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAgBD,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAyC5E;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CA0B7E"}

package/dist/seo/feeds.js

@@ -0,0 +1,95 @@
+/**
+ * RSS 2.0 + JSON Feed 1.1 builders.
+ *
+ * Feeds are how readers, aggregators, and increasingly AI agents subscribe to
+ * fresh content without polling HTML. These are pure functions over an already
+ * resolved item list so they are trivially testable; the route layer
+ * (`seo-public.ts`) does the DB work and URL resolution.
+ */
+import { escapeXml } from '../api/route-helpers.js';
+function toRfc822(iso) {
+    if (!iso)
+        return undefined;
+    const d = new Date(iso);
+    return Number.isNaN(d.getTime()) ? undefined : d.toUTCString();
+}
+/**
+ * Wrap arbitrary HTML in a CDATA section, escaping any `]]>` sequence in the
+ * body so it can't prematurely terminate the section and corrupt the feed.
+ */
+function cdata(html) {
+    return `<![CDATA[${html.replace(/]]>/g, ']]]]><![CDATA[>')}]]>`;
+}
+/** Build an RSS 2.0 document. */
+export function buildRssFeed(channel, items) {
+    const lastBuild = toRfc822(channel.updated ?? items[0]?.date);
+    // Only declare the content module namespace when at least one item ships a
+    // full body, so lean feeds stay minimal.
+    const hasContent = items.some((i) => typeof i.content === 'string' && i.content.length > 0);
+    const rssOpen = hasContent
+        ? '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">'
+        : '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">';
+    const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        rssOpen,
+        '  <channel>',
+        `    <title>${escapeXml(channel.title)}</title>`,
+        `    <link>${escapeXml(channel.homeUrl || '/')}</link>`,
+        `    <atom:link href="${escapeXml(channel.feedUrl)}" rel="self" type="application/rss+xml" />`,
+    ];
+    // RSS 2.0 requires <description> on every channel. Fall back to the title so
+    // the mandatory element is never absent (a common valid config leaves the
+    // site meta description unset), which would otherwise fail feed validators.
+    lines.push(`    <description>${escapeXml(channel.description || `${channel.title} feed`)}</description>`);
+    if (channel.language)
+        lines.push(`    <language>${escapeXml(channel.language)}</language>`);
+    if (lastBuild)
+        lines.push(`    <lastBuildDate>${lastBuild}</lastBuildDate>`);
+    for (const item of items) {
+        lines.push('    <item>');
+        lines.push(`      <title>${escapeXml(item.title)}</title>`);
+        lines.push(`      <link>${escapeXml(item.url)}</link>`);
+        lines.push(`      <guid isPermaLink="true">${escapeXml(item.url)}</guid>`);
+        if (item.description)
+            lines.push(`      <description>${escapeXml(item.description)}</description>`);
+        if (item.content)
+            lines.push(`      <content:encoded>${cdata(item.content)}</content:encoded>`);
+        const pub = toRfc822(item.date);
+        if (pub)
+            lines.push(`      <pubDate>${pub}</pubDate>`);
+        if (item.author)
+            lines.push(`      <author>${escapeXml(item.author)}</author>`);
+        lines.push('    </item>');
+    }
+    lines.push('  </channel>', '</rss>');
+    return lines.join('\n');
+}
+/** Build a JSON Feed 1.1 document (https://www.jsonfeed.org/version/1.1/). */
+export function buildJsonFeed(channel, items) {
+    const feed = {
+        version: 'https://jsonfeed.org/version/1.1',
+        title: channel.title,
+        home_page_url: channel.homeUrl,
+        feed_url: channel.feedUrl,
+        ...(channel.description ? { description: channel.description } : {}),
+        ...(channel.language ? { language: channel.language } : {}),
+        items: items.map((item) => ({
+            id: item.url,
+            url: item.url,
+            title: item.title,
+            // JSON Feed 1.1 requires content_html and/or content_text on every item.
+            // Prefer the full HTML body; otherwise always emit content_text (from the
+            // summary, falling back to the title) so the required field is never
+            // missing and readers never render a title-only stub.
+            ...(item.content
+                ? { content_html: item.content }
+                : { content_text: item.description || item.title }),
+            ...(item.description ? { summary: item.description } : {}),
+            ...(item.date ? { date_published: item.date } : {}),
+            ...(item.dateModified ? { date_modified: item.dateModified } : {}),
+            ...(item.author ? { authors: [{ name: item.author }] } : {}),
+        })),
+    };
+    return JSON.stringify(feed, null, 2);
+}
+//# sourceMappingURL=feeds.js.map

package/dist/seo/feeds.js.map

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

package/dist/seo/fix-brief-export.d.ts

@@ -0,0 +1,47 @@
+import { type SeoContentBrief } from './issue-content-brief.js';
+import { type SeoContentResearch } from './issue-content-research.js';
+/** Issue types handled by inline Approve fix (deterministic + AI). */
+export declare const INLINE_FIX_ISSUE_TYPES: Set<string>;
+export interface FixBriefIssue {
+    id: string;
+    type: string;
+    title: string;
+    description: string | null;
+    impact: string | null;
+    recommendation: string | null;
+    severity: string;
+    category: string;
+    status: string;
+    entityType: string | null;
+    entityId: string | null;
+    entityTitle: string | null;
+    url: string | null;
+    fixActionType: string | null;
+    fixable: boolean;
+    /** Cached AI content brief when included in export. */
+    contentBrief?: SeoContentBrief | null;
+    /** Cached topic research when included in export. */
+    contentResearch?: SeoContentResearch | null;
+}
+export interface FixBriefExportInput {
+    siteName?: string | null;
+    siteUrl?: string | null;
+    auditRunId?: string | null;
+    auditDate?: string | Date | null;
+    issues: FixBriefIssue[];
+    /** When true (default), omit issues with inline Approve fix in the Audit tab. */
+    manualOnly?: boolean;
+}
+/**
+ * True when an issue should be handed off via export rather than inline approve.
+ */
+export declare function isManualHandoffIssue(issue: Pick<FixBriefIssue, 'type' | 'fixActionType' | 'fixable'>): boolean;
+export declare function filterFixBriefIssues(issues: FixBriefIssue[], manualOnly?: boolean): FixBriefIssue[];
+export declare function fixBriefFilename(siteName?: string | null, auditDate?: string | Date | null): string;
+/** Relative admin path for opening the page/editor (consumer resolves basePath). */
+export declare function adminPathForIssue(issue: FixBriefIssue): string | null;
+/**
+ * Build a developer handoff markdown document from open audit issues.
+ */
+export declare function buildSeoFixBriefMarkdown(input: FixBriefExportInput): string;
+//# sourceMappingURL=fix-brief-export.d.ts.map

package/dist/seo/fix-brief-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-brief-export.d.ts","sourceRoot":"","sources":["../../src/seo/fix-brief-export.ts"],"names":[],"mappings":"AAMA,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEpG,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,aAAiE,CAAA;AAUpG,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACrC,qDAAqD;IACrD,eAAe,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC,GAC/D,OAAO,CAMT;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,UAAU,UAAO,GAAG,aAAa,EAAE,CAGhG;AAaD,wBAAgB,gBAAgB,CAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAC/B,MAAM,CAKR;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CA0CrE;AAmDD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CA8E3E"}