@prenta/core 0.118.0

package/dist/seo/issue-fix.js

@@ -0,0 +1,266 @@
+import { stripHtmlTags } from './analysis.js';
+import { resolveRenderedMetaTitle, maxPageTitleLengthForTemplate } from './title-templates.js';
+export const META_TITLE_MAX = 60;
+export const META_TITLE_MIN = 30;
+export const META_DESC_MAX = 160;
+export const META_DESC_MIN = 120;
+/** Issue types that support a deterministic one-click fix in Phase 1. */
+export const DETERMINISTIC_FIX_TYPES = new Set([
+    'meta-title-length',
+    'meta-description-length',
+    'accidental-noindex',
+    'missing-meta-title',
+    'missing-meta-description',
+    'missing-canonical',
+]);
+/** Truncate at a word boundary when possible so snippets read naturally. */
+export function truncateAtWordBoundary(text, maxLen) {
+    const trimmed = text.trim();
+    if (trimmed.length <= maxLen)
+        return trimmed;
+    const slice = trimmed.slice(0, maxLen);
+    const lastSpace = slice.lastIndexOf(' ');
+    if (lastSpace > Math.floor(maxLen * 0.6)) {
+        return slice.slice(0, lastSpace).trim();
+    }
+    return slice.trim();
+}
+/** Build a meta description excerpt from page body (plain text). */
+export function excerptForMetaDescription(content, maxLen = META_DESC_MAX) {
+    const plain = stripHtmlTags(content).replace(/\s+/g, ' ').trim();
+    if (!plain)
+        return '';
+    return truncateAtWordBoundary(plain, maxLen);
+}
+function pageTitlePortion(entity) {
+    return entity.metaTitlePage?.trim() || entity.title.trim();
+}
+function buildMetaTitlePageFromEntity(title, siteSeo) {
+    const vars = { site: siteSeo?.siteName ?? '' };
+    const maxPage = maxPageTitleLengthForTemplate(siteSeo?.titleTemplate, vars, META_TITLE_MAX);
+    const candidate = title.trim();
+    if (candidate.length <= maxPage)
+        return candidate;
+    return truncateAtWordBoundary(candidate, maxPage);
+}
+function renderedMetaTitleForPage(pageTitle, siteSeo) {
+    return resolveRenderedMetaTitle({
+        metaTitlePage: pageTitle,
+        documentTitle: pageTitle,
+        site: siteSeo ?? undefined,
+    });
+}
+function absoluteCanonicalUrl(entity, siteSeo) {
+    const siteUrl = siteSeo?.siteUrl?.replace(/\/+$/, '') ?? '';
+    if (!siteUrl)
+        return null;
+    const path = entity.url?.trim() ?? '';
+    if (!path)
+        return null;
+    if (path.startsWith('http://') || path.startsWith('https://'))
+        return path;
+    return `${siteUrl}${path.startsWith('/') ? path : `/${path}`}`;
+}
+export function buildFixFingerprint(entityId, issueType, updatedAt) {
+    const ms = updatedAt instanceof Date ? updatedAt.getTime() : new Date(updatedAt).getTime();
+    return `${entityId}:${ms}:${issueType}`;
+}
+function fieldChange(field, label, before, after) {
+    return { field, label, before, after };
+}
+function notFixable(issue, ctx, reason) {
+    const entityId = issue.entityId ?? ctx.entity.entityId;
+    return {
+        autoFixable: false,
+        fingerprint: buildFixFingerprint(entityId, issue.type, ctx.updatedAt),
+        patch: {},
+        changes: [],
+        justification: reason,
+    };
+}
+/**
+ * Compute a deterministic fix suggestion for an audit issue. Returns
+ * `autoFixable: false` when the issue type is unsupported or required context
+ * is missing (e.g. no site URL for canonical).
+ */
+export function suggestDeterministicFix(issue, ctx) {
+    const { entity, siteSeo } = ctx;
+    const entityId = issue.entityId ?? entity.entityId;
+    const fingerprint = buildFixFingerprint(entityId, issue.type, ctx.updatedAt);
+    if (!DETERMINISTIC_FIX_TYPES.has(issue.type)) {
+        return notFixable(issue, ctx, issue.recommendation ?? 'This issue requires manual review.');
+    }
+    switch (issue.type) {
+        case 'accidental-noindex': {
+            if (!entity.noindex) {
+                return notFixable(issue, ctx, 'This page is already set to index.');
+            }
+            return {
+                autoFixable: true,
+                source: 'deterministic',
+                fingerprint,
+                patch: { noindex: false },
+                changes: [fieldChange('noindex', 'Index in search engines', true, false)],
+                justification: 'Removes the noindex flag so search engines can index this public page again.',
+            };
+        }
+        case 'missing-meta-title': {
+            const proposed = buildMetaTitlePageFromEntity(entity.title, siteSeo);
+            if (!proposed) {
+                return notFixable(issue, ctx, 'Add a page title first, then retry the fix.');
+            }
+            const rendered = renderedMetaTitleForPage(proposed, siteSeo);
+            return {
+                autoFixable: true,
+                source: 'deterministic',
+                fingerprint,
+                patch: { metaTitle: proposed },
+                changes: [fieldChange('metaTitle', 'Meta title', entity.metaTitle ?? null, rendered)],
+                justification: `Sets the page meta title (${proposed.length} characters); your site template renders it as "${rendered}".`,
+            };
+        }
+        case 'meta-title-length': {
+            const currentRendered = entity.metaTitle?.trim() ?? '';
+            if (!currentRendered) {
+                return notFixable(issue, ctx, 'No meta title is set — use the missing-meta-title fix instead.');
+            }
+            const currentPage = pageTitlePortion(entity);
+            let proposedPage = currentPage;
+            if (currentRendered.length > META_TITLE_MAX) {
+                proposedPage = truncateAtWordBoundary(currentPage, maxPageTitleLengthForTemplate(siteSeo?.titleTemplate, { site: siteSeo?.siteName ?? '' }, META_TITLE_MAX));
+            }
+            else if (currentRendered.length < META_TITLE_MIN) {
+                proposedPage = buildMetaTitlePageFromEntity(entity.title, siteSeo);
+            }
+            const proposedRendered = renderedMetaTitleForPage(proposedPage, siteSeo);
+            if (proposedPage === currentPage) {
+                return notFixable(issue, ctx, 'Could not derive a better meta title automatically.');
+            }
+            return {
+                autoFixable: true,
+                source: 'deterministic',
+                fingerprint,
+                patch: { metaTitle: proposedPage },
+                changes: [fieldChange('metaTitle', 'Meta title', currentRendered, proposedRendered)],
+                justification: currentRendered.length > META_TITLE_MAX
+                    ? `Shortened the page meta title so the rendered title is ${proposedRendered.length} characters.`
+                    : `Expanded the page meta title; your site template renders it as "${proposedRendered}".`,
+            };
+        }
+        case 'missing-meta-description': {
+            const proposed = excerptForMetaDescription(entity.content ?? '');
+            if (!proposed) {
+                return notFixable(issue, ctx, 'Add page content first so a description can be generated from the body.');
+            }
+            return {
+                autoFixable: true,
+                source: 'deterministic',
+                fingerprint,
+                patch: { metaDescription: proposed },
+                changes: [
+                    fieldChange('metaDescription', 'Meta description', entity.metaDescription ?? null, proposed),
+                ],
+                justification: `Drafts a ${proposed.length}-character meta description from the page content.`,
+            };
+        }
+        case 'meta-description-length': {
+            const current = entity.metaDescription?.trim() ?? '';
+            if (!current) {
+                return notFixable(issue, ctx, 'No meta description is set — use the missing-meta-description fix instead.');
+            }
+            let proposed = current;
+            if (current.length > META_DESC_MAX) {
+                proposed = truncateAtWordBoundary(current, META_DESC_MAX);
+            }
+            else if (current.length < META_DESC_MIN) {
+                const fromBody = excerptForMetaDescription(entity.content ?? '', META_DESC_MAX);
+                proposed = fromBody.length >= current.length ? fromBody : current;
+                if (proposed.length < META_DESC_MIN && fromBody) {
+                    proposed = fromBody;
+                }
+            }
+            if (proposed === current) {
+                return notFixable(issue, ctx, 'Could not improve the meta description automatically — expand the page content or edit manually.');
+            }
+            return {
+                autoFixable: true,
+                source: 'deterministic',
+                fingerprint,
+                patch: { metaDescription: proposed },
+                changes: [fieldChange('metaDescription', 'Meta description', current, proposed)],
+                justification: current.length > META_DESC_MAX
+                    ? `Shortened the meta description to ${proposed.length} characters for SERP display.`
+                    : `Extended the meta description to ${proposed.length} characters using page content.`,
+            };
+        }
+        case 'missing-canonical': {
+            const proposed = absoluteCanonicalUrl(entity, siteSeo);
+            if (!proposed) {
+                return notFixable(issue, ctx, 'Configure your site URL in SEO settings, then retry the canonical fix.');
+            }
+            const stored = entity.canonicalUrl?.trim() || null;
+            return {
+                autoFixable: true,
+                source: 'deterministic',
+                fingerprint,
+                patch: { canonical: proposed },
+                changes: [fieldChange('canonicalUrl', 'Canonical URL', stored, proposed)],
+                justification: 'Sets the canonical URL to this page’s preferred public address.',
+            };
+        }
+        default:
+            return notFixable(issue, ctx, 'This issue type is not supported for automatic fixes yet.');
+    }
+}
+/** Returns true when a deterministic meta description is too short to be useful. */
+function deterministicDescriptionTooShort(suggestion) {
+    const desc = suggestion.patch.metaDescription;
+    return typeof desc === 'string' && desc.length > 0 && desc.length < META_DESC_MIN;
+}
+/**
+ * Resolve a fix suggestion: deterministic first, then AI when needed.
+ */
+export async function suggestIssueFix(issue, ctx, aiDeps) {
+    if (issue.type === 'broken-internal-link' && aiDeps?.db) {
+        const { suggestBrokenLinkFix } = await import('./issue-fix-redirect.js');
+        let documentData;
+        if (aiDeps.collection && issue.entityId) {
+            const doc = await aiDeps.db.document.findFirst({
+                where: { id: issue.entityId, deletedAt: null },
+                select: { data: true },
+            });
+            if (doc?.data && typeof doc.data === 'object' && !Array.isArray(doc.data)) {
+                documentData = doc.data;
+            }
+        }
+        const suggestion = await suggestBrokenLinkFix(issue, ctx.metadata, aiDeps.db, ctx.updatedAt, documentData);
+        return { suggestion, cacheForApply: suggestion.autoFixable };
+    }
+    const deterministic = suggestDeterministicFix(issue, ctx);
+    const { suggestAiFix, AI_FIX_TYPES } = await import('./issue-fix-ai.js');
+    const needsAi = AI_FIX_TYPES.has(issue.type) &&
+        aiDeps &&
+        (!deterministic.autoFixable || deterministicDescriptionTooShort(deterministic));
+    if (!needsAi) {
+        return { suggestion: deterministic, cacheForApply: false };
+    }
+    const ai = await suggestAiFix(issue, ctx, aiDeps);
+    if (!ai.ok) {
+        return {
+            suggestion: {
+                autoFixable: false,
+                source: 'ai',
+                fingerprint: deterministic.fingerprint,
+                patch: {},
+                changes: [],
+                justification: ai.message,
+            },
+            cacheForApply: false,
+        };
+    }
+    return {
+        suggestion: ai.suggestion,
+        cacheForApply: ai.suggestion.source === 'ai' && ai.suggestion.autoFixable,
+    };
+}
+//# sourceMappingURL=issue-fix.js.map

package/dist/seo/issue-fix.js.map

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

package/dist/seo/link-graph.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Static internal / external link graph for published front-end content.
+ * No outbound HTTP — safe for dashboard snapshots and AI suggestion prep.
+ */
+import type { AuditEntityInput } from './audit-engine.js';
+export interface LinkGraphEntityRef {
+    id: string;
+    title: string;
+    url: string;
+    path: string;
+    collection: string;
+    entityType: 'page' | 'post';
+    isHome: boolean;
+}
+export interface LinkGraphSnapshot {
+    scannedAt: string;
+    postsCrawled: number;
+    internalLinks: number;
+    externalLinks: number;
+    /** Internal links as a fraction of all classified links (0–1). */
+    internalRatio: number;
+    orphanCount: number;
+    /** Published entities with zero inbound internal links (excluding home). */
+    orphaned: LinkGraphEntityRef[];
+    /** Share of crawlable entities that receive at least one inbound internal link. */
+    linkCoveragePercent: number;
+    /** Entities with fewer than two outbound internal links. */
+    underLinked: Array<LinkGraphEntityRef & {
+        outboundInternal: number;
+    }>;
+    brokenLinkCount: number;
+    aiIndexLastRunAt: string | null;
+    aiIndexReady: boolean;
+}
+export interface BuildLinkGraphInput {
+    entities: AuditEntityInput[];
+    siteUrl: string;
+    /** Map entityId -> collection slug (when not on AuditEntityInput). */
+    collections?: Record<string, string>;
+    brokenLinkCount?: number;
+    aiIndexLastRunAt?: string | null;
+    /**
+     * Internal link targets from global site chrome (header / nav / footer menus)
+     * that live outside per-document content. Each resolvable target seeds a
+     * virtual inbound edge so pages reachable only via global navigation are not
+     * mis-reported as orphaned or under-linked. These do NOT count toward the
+     * in-content `internalLinks` / `externalLinks` tallies.
+     */
+    navLinks?: string[];
+}
+/** Serialize document fields that may contain links (sections JSON, body HTML, etc.). */
+export declare function contentBlobForLinkScan(content: string, extra?: Record<string, unknown> | null): string;
+export declare function buildLinkGraphSnapshot(input: BuildLinkGraphInput): LinkGraphSnapshot;
+//# sourceMappingURL=link-graph.d.ts.map

package/dist/seo/link-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-graph.d.ts","sourceRoot":"","sources":["../../src/seo/link-graph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAA;IAC3B,4DAA4D;IAC5D,WAAW,EAAE,KAAK,CAAC,kBAAkB,GAAG;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrE,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAcD,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,MAAM,CASR;AAkCD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,CAuGpF"}

package/dist/seo/link-graph.js.map

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

package/dist/seo/link-probe.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Outbound URL extraction + classification for Live link health (`GET /seo/link-health`)
+ * and the light probe in `GET /seo/summary`.
+ *
+ * Important: never extract URLs from `JSON.stringify(doc.data)`. Stringifying
+ * escapes quotes as `\"`, and a naive `https?:\/\/…` regex captures the
+ * preceding backslash as part of the URL — every probe then hits a malformed
+ * target and floods false positives.
+ */
+/** Browser-like headers so hosts that reject bare HEAD/bot UAs still respond. */
+export declare const LINK_PROBE_HEADERS: Readonly<Record<string, string>>;
+/**
+ * Walk document JSON and collect raw string fields (rich text, section content,
+ * etc.) without re-serializing — so attribute quotes stay unescaped.
+ */
+export declare function collectDocumentStrings(value: unknown, out?: string[]): string[];
+/**
+ * Normalize a raw URL match before probing: strip JSON-escape backslashes and
+ * trailing punctuation, then validate with the URL constructor.
+ */
+export declare function normalizeProbeUrl(raw: string): string | null;
+/**
+ * First-party Vercel Blob media hosted by the CMS. These are managed uploads —
+ * probing them over HTTP is noisy (and was the largest false-positive source
+ * when extraction appended `\`).
+ */
+export declare function isCmsBlobMediaUrl(url: string): boolean;
+/**
+ * Extract unique http(s) URLs from document `data` for outbound probing.
+ * Prefers `href` / `src` attributes; also picks up bare URLs in plain text.
+ */
+export declare function extractOutboundUrlsFromDocumentData(data: unknown): string[];
+/**
+ * Whether a probe HTTP status should appear in the Live link health **issues**
+ * list. 2xx/3xx are healthy; 403/405/429/999 are treated as unverifiable
+ * (bot-walled / method not allowed), not broken.
+ *
+ * Network failure (`0`) is treated as an issue for the live-scan UI (the link
+ * could not be reached). Audit confirmation uses {@link isConfirmedDeadLinkStatus}
+ * instead so unreachable probes are dropped rather than reported as 404s.
+ */
+export declare function isLinkProbeIssueStatus(status: number): boolean;
+/**
+ * True only when the origin **confirmed** the URL is dead (4xx/5xx other than
+ * bot-wall codes). Live 2xx/3xx, unverifiable bot walls, SSRF blocks, and
+ * network failures all return false — do not claim "404" or auto-redirect.
+ */
+export declare function isConfirmedDeadLinkStatus(status: number): boolean;
+//# sourceMappingURL=link-probe.d.ts.map

package/dist/seo/link-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-probe.d.ts","sourceRoot":"","sources":["../../src/seo/link-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK9D,CAAA;AAQF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAenF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAyB3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKjE"}

package/dist/seo/link-probe.js

@@ -0,0 +1,147 @@
+/**
+ * Outbound URL extraction + classification for Live link health (`GET /seo/link-health`)
+ * and the light probe in `GET /seo/summary`.
+ *
+ * Important: never extract URLs from `JSON.stringify(doc.data)`. Stringifying
+ * escapes quotes as `\"`, and a naive `https?:\/\/…` regex captures the
+ * preceding backslash as part of the URL — every probe then hits a malformed
+ * target and floods false positives.
+ */
+/** Browser-like headers so hosts that reject bare HEAD/bot UAs still respond. */
+export const LINK_PROBE_HEADERS = Object.freeze({
+    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
+    Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
+    'Accept-Language': 'en-US,en;q=0.9',
+});
+const HREF_OR_SRC_RE = /(?:href|src)\s*=\s*["']([^"']+)["']/gi;
+const BARE_HTTP_RE = /https?:\/\/[^\s"'<>\\]+/gi;
+/** Status codes that usually mean “bot / method blocked”, not a dead page. */
+const UNVERIFIABLE_STATUSES = new Set([403, 405, 429, 999]);
+/**
+ * Walk document JSON and collect raw string fields (rich text, section content,
+ * etc.) without re-serializing — so attribute quotes stay unescaped.
+ */
+export function collectDocumentStrings(value, out = []) {
+    if (typeof value === 'string') {
+        if (value.length > 0)
+            out.push(value);
+        return out;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectDocumentStrings(item, out);
+        return out;
+    }
+    if (value && typeof value === 'object') {
+        for (const v of Object.values(value)) {
+            collectDocumentStrings(v, out);
+        }
+    }
+    return out;
+}
+/**
+ * Normalize a raw URL match before probing: strip JSON-escape backslashes and
+ * trailing punctuation, then validate with the URL constructor.
+ */
+export function normalizeProbeUrl(raw) {
+    let url = raw.trim();
+    if (!url)
+        return null;
+    // JSON.stringify artifact: `href=\"https://example.com\"` → match ends with `\`
+    url = url.replace(/\\+$/g, '');
+    url = url.replace(/[",;)}\]\s]+$/g, '');
+    // Defensive: unescape a trailing `\"` residue if still present
+    if (url.endsWith('\\"'))
+        url = url.slice(0, -2);
+    url = url.replace(/\\+$/g, '');
+    if (!/^https?:\/\//i.test(url))
+        return null;
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+            return null;
+        return parsed.href;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * First-party Vercel Blob media hosted by the CMS. These are managed uploads —
+ * probing them over HTTP is noisy (and was the largest false-positive source
+ * when extraction appended `\`).
+ */
+export function isCmsBlobMediaUrl(url) {
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        return (host === 'public.blob.vercel-storage.com' || host.endsWith('.public.blob.vercel-storage.com'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract unique http(s) URLs from document `data` for outbound probing.
+ * Prefers `href` / `src` attributes; also picks up bare URLs in plain text.
+ */
+export function extractOutboundUrlsFromDocumentData(data) {
+    const strings = collectDocumentStrings(data);
+    const found = new Set();
+    for (const text of strings) {
+        HREF_OR_SRC_RE.lastIndex = 0;
+        let match;
+        while ((match = HREF_OR_SRC_RE.exec(text)) !== null) {
+            const href = match[1];
+            if (!href || href.startsWith('#') || href.startsWith('mailto:') || href.startsWith('tel:')) {
+                continue;
+            }
+            if (!/^https?:\/\//i.test(href))
+                continue;
+            const clean = normalizeProbeUrl(href);
+            if (clean && !isCmsBlobMediaUrl(clean))
+                found.add(clean);
+        }
+        BARE_HTTP_RE.lastIndex = 0;
+        while ((match = BARE_HTTP_RE.exec(text)) !== null) {
+            const clean = normalizeProbeUrl(match[0] ?? '');
+            if (clean && !isCmsBlobMediaUrl(clean))
+                found.add(clean);
+        }
+    }
+    return [...found];
+}
+/**
+ * Whether a probe HTTP status should appear in the Live link health **issues**
+ * list. 2xx/3xx are healthy; 403/405/429/999 are treated as unverifiable
+ * (bot-walled / method not allowed), not broken.
+ *
+ * Network failure (`0`) is treated as an issue for the live-scan UI (the link
+ * could not be reached). Audit confirmation uses {@link isConfirmedDeadLinkStatus}
+ * instead so unreachable probes are dropped rather than reported as 404s.
+ */
+export function isLinkProbeIssueStatus(status) {
+    if (status === 0)
+        return true; // network / unknown failure
+    if (status < 0)
+        return false; // SSRF blocked — not a content defect
+    if (status >= 200 && status < 400)
+        return false;
+    if (UNVERIFIABLE_STATUSES.has(status))
+        return false;
+    return status >= 400;
+}
+/**
+ * True only when the origin **confirmed** the URL is dead (4xx/5xx other than
+ * bot-wall codes). Live 2xx/3xx, unverifiable bot walls, SSRF blocks, and
+ * network failures all return false — do not claim "404" or auto-redirect.
+ */
+export function isConfirmedDeadLinkStatus(status) {
+    if (status <= 0)
+        return false;
+    if (status >= 200 && status < 400)
+        return false;
+    if (UNVERIFIABLE_STATUSES.has(status))
+        return false;
+    return status >= 400;
+}
+//# sourceMappingURL=link-probe.js.map

package/dist/seo/link-probe.js.map

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

package/dist/seo/llms-select.d.ts

@@ -0,0 +1,34 @@
+import type { LlmsTxtPage } from './llms-txt.js';
+export type LlmsInclude = 'AUTO' | 'ALWAYS' | 'NEVER';
+/** Tri-state per-doc include flag; defaults to AUTO for unrecognized values. */
+export declare function readLlmsInclude(data: unknown): LlmsInclude;
+/** A doc is excluded from every llms surface when it is noindexed. */
+export declare function isLlmsNoindex(data: unknown): boolean;
+export interface LlmsSelectableDoc {
+    collection: string;
+    data: unknown;
+}
+/**
+ * Apply the curation + privacy rules:
+ *   - internal/system collections excluded
+ *   - noindexed docs excluded (privacy boundary)
+ *   - `llmsInclude` NEVER excluded, ALWAYS included (overrides eligibility),
+ *     AUTO included only when the collection is eligible
+ */
+export declare function selectLlmsDocs<T extends LlmsSelectableDoc>(docs: T[], opts: {
+    isInternalCollection: (c: string) => boolean;
+    eligible: Set<string> | null;
+}): T[];
+export interface LlmsDocForPage {
+    title?: string | null;
+    slug?: string | null;
+    collection: string;
+    updatedAt?: Date | null;
+    data: unknown;
+}
+/** Map a selected document to the generator's page shape (curation-aware). */
+export declare function toLlmsPage(d: LlmsDocForPage, opts: {
+    base: string;
+    urlPrefix?: string;
+}): LlmsTxtPage;
+//# sourceMappingURL=llms-select.d.ts.map

package/dist/seo/llms-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-select.d.ts","sourceRoot":"","sources":["../../src/seo/llms-select.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAErD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAG1D;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,iBAAiB,EACxD,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE;IAAE,oBAAoB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;CAAE,GACnF,CAAC,EAAE,CAWL;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,OAAO,CAAA;CACd;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,CAAC,EAAE,cAAc,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,WAAW,CA6Bb"}