@prenta/core 0.118.0

package/dist/seo/config-store.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Editable SEO config — DB-backed overrides for the static `prenta.config.ts`
+ * `seo` block + per-collection `CollectionSEOConfig`.
+ *
+ * Static config in `prenta.config.ts` is the source of truth at code level,
+ * but admins need to be able to change site name, default OG image, robots
+ * policy, default Schema.org types per collection, etc. without redeploying.
+ *
+ * Storage: a single Document row with `collection = '__seo_config__'` and
+ * `data.{site, collections}`. The leading double underscore makes the slug
+ * un-spellable as a normal collection (slugs are lowercased + dashed in the
+ * config validator), so it can never collide with a user collection.
+ *
+ * Merge semantics: DB values take precedence over static config, field by
+ * field. Removing a value in the UI (setting it to undefined / empty string)
+ * falls back to the static default — so the admin panel is purely additive,
+ * never destructive of code-level config.
+ */
+import type { PrentaCMSConfig, CollectionSEOConfig, SiteSEOConfig } from '../config/types.js';
+export declare const SEO_CONFIG_COLLECTION = "__seo_config__";
+/**
+ * Shape of the overrides document stored in the DB. Every field is optional —
+ * a freshly-installed CMS has no row at all and the UI lazily creates one on
+ * first save.
+ */
+export interface SeoConfigOverrides {
+    /** Site-wide overrides. Merged shallow-then-deep over static `config.seo`. */
+    site?: Partial<SiteSEOConfig>;
+    /** Per-collection overrides keyed by collection slug. */
+    collections?: Record<string, Partial<CollectionSEOConfig>>;
+    /** SEO module settings edited from the Technical tab (crawl/robots/sitemap). */
+    module?: Partial<SeoModuleSettings>;
+    /** Last update timestamp (set by the writer). */
+    updatedAt?: string;
+    /** User id of the last editor (set by the writer). */
+    updatedBy?: string;
+}
+/**
+ * Editable SEO-module behaviour surfaced on the Technical tab. These are the
+ * crawl/index toggles, sitemap options, custom robots.txt body, and the
+ * Search Console connection flag from the SEO spec's `SEOConfig` shape. Stored
+ * alongside the field overrides in the same `__seo_config__` document.
+ */
+export interface SeoModuleSettings {
+    sitemapEnabled: boolean;
+    robotsEnabled: boolean;
+    autoRegenerateSitemapOnPublish: boolean;
+    /** Notify Google/Bing when the sitemap changes (guarded to production). */
+    pingSearchEnginesOnPublish: boolean;
+    includeImagesInSitemap: boolean;
+    includePostsInSitemap: boolean;
+    indexEntireSite: boolean;
+    /** Custom robots.txt body. Empty string means "use generated defaults". */
+    robotsTxt: string;
+    /** Whether Google Search Console is connected (gated; false in demo/local). */
+    searchConsoleConnected: boolean;
+    /** ISO timestamp of the last manual sitemap regeneration (null = never). */
+    sitemapLastGeneratedAt: string | null;
+    /** Re-rank ambiguous redirect matches (40–84%) with semantic search when AI is configured. */
+    redirectRecoveryAiRerank: boolean;
+    /** Auto-create 301 redirects for high-confidence matches (off by default). */
+    redirectRecoveryAutoApply: boolean;
+    /** Minimum match confidence (0–100) required for auto-apply. Default 85. */
+    redirectRecoveryAutoApplyMinConfidence: number;
+    /** ISO timestamp of the last AI link-index scan (Links dashboard). */
+    linkAiIndexLastRunAt: string | null;
+}
+/** Safe defaults applied when the overrides document has no `module` block. */
+export declare const DEFAULT_SEO_MODULE_SETTINGS: SeoModuleSettings;
+/** Merge stored module settings over the defaults (field-by-field). */
+export declare function resolveSeoModuleSettings(overrides: SeoConfigOverrides | null): SeoModuleSettings;
+/** Persist a partial patch onto SEO module settings. */
+export declare function patchSeoModuleSettings(db: unknown, patch: Partial<SeoModuleSettings>, userId: string): Promise<SeoModuleSettings>;
+/** Read the SEO overrides document. Returns null when no row exists yet. */
+export declare function getSeoOverrides(db: unknown): Promise<SeoConfigOverrides | null>;
+/**
+ * Upsert the SEO overrides document. The caller is responsible for auth/role
+ * checks — this function only handles storage.
+ */
+export declare function putSeoOverrides(db: unknown, overrides: SeoConfigOverrides, userId: string): Promise<SeoConfigOverrides>;
+/**
+ * Merge static site-wide SEO config with the DB overrides. Nested objects
+ * (`robots`, `sitemap`, `ogImage`, `organization`) merge field-by-field;
+ * primitive values use override-wins-if-set.
+ */
+export declare function mergeSiteSeoConfig(base: SiteSEOConfig | undefined, over: Partial<SiteSEOConfig> | undefined): SiteSEOConfig;
+/** Same merge semantics as the site-wide version, applied to a single collection. */
+export declare function mergeCollectionSeoConfig(base: CollectionSEOConfig | undefined, over: Partial<CollectionSEOConfig> | undefined): CollectionSEOConfig;
+/**
+ * Return a new config object with DB-stored SEO overrides applied. The
+ * static config is never mutated — callers receive a shallow copy with
+ * `seo` and each collection's `seo` block replaced by the merged values.
+ *
+ * Routes that compose SEO output call this once per request, then thread
+ * the result through to `composePageMeta` / sitemap helpers exactly like
+ * the static config they replaced.
+ */
+export declare function applySeoOverrides(config: PrentaCMSConfig | null | undefined, overrides: SeoConfigOverrides | null): PrentaCMSConfig | null;
+//# sourceMappingURL=config-store.d.ts.map

package/dist/seo/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/seo/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,eAAe,EAEf,mBAAmB,EACnB,aAAa,EACd,MAAM,oBAAoB,CAAA;AAE3B,eAAO,MAAM,qBAAqB,mBAAmB,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC7B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAC1D,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACnC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;IACtB,8BAA8B,EAAE,OAAO,CAAA;IACvC,2EAA2E;IAC3E,0BAA0B,EAAE,OAAO,CAAA;IACnC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,qBAAqB,EAAE,OAAO,CAAA;IAC9B,eAAe,EAAE,OAAO,CAAA;IACxB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;IACjB,+EAA+E;IAC/E,sBAAsB,EAAE,OAAO,CAAA;IAC/B,4EAA4E;IAC5E,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,8FAA8F;IAC9F,wBAAwB,EAAE,OAAO,CAAA;IACjC,8EAA8E;IAC9E,yBAAyB,EAAE,OAAO,CAAA;IAClC,4EAA4E;IAC5E,sCAAsC,EAAE,MAAM,CAAA;IAC9C,sEAAsE;IACtE,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B,EAAE,iBAezC,CAAA;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,GAAG,iBAAiB,CAMhG;AAED,wDAAwD;AACxD,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,OAAO,EACX,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACjC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAY5B;AAED,4EAA4E;AAC5E,wBAAsB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAerF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAwBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,GACvC,aAAa,CAiCf;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,mBAAmB,GAAG,SAAS,EACrC,IAAI,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,GAC7C,mBAAmB,CAiBrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC1C,SAAS,EAAE,kBAAkB,GAAG,IAAI,GACnC,eAAe,GAAG,IAAI,CAkBxB"}

package/dist/seo/config-store.js

@@ -0,0 +1,194 @@
+/**
+ * Editable SEO config — DB-backed overrides for the static `prenta.config.ts`
+ * `seo` block + per-collection `CollectionSEOConfig`.
+ *
+ * Static config in `prenta.config.ts` is the source of truth at code level,
+ * but admins need to be able to change site name, default OG image, robots
+ * policy, default Schema.org types per collection, etc. without redeploying.
+ *
+ * Storage: a single Document row with `collection = '__seo_config__'` and
+ * `data.{site, collections}`. The leading double underscore makes the slug
+ * un-spellable as a normal collection (slugs are lowercased + dashed in the
+ * config validator), so it can never collide with a user collection.
+ *
+ * Merge semantics: DB values take precedence over static config, field by
+ * field. Removing a value in the UI (setting it to undefined / empty string)
+ * falls back to the static default — so the admin panel is purely additive,
+ * never destructive of code-level config.
+ */
+export const SEO_CONFIG_COLLECTION = '__seo_config__';
+/** Safe defaults applied when the overrides document has no `module` block. */
+export const DEFAULT_SEO_MODULE_SETTINGS = {
+    sitemapEnabled: true,
+    robotsEnabled: true,
+    autoRegenerateSitemapOnPublish: true,
+    pingSearchEnginesOnPublish: true,
+    includeImagesInSitemap: true,
+    includePostsInSitemap: true,
+    indexEntireSite: true,
+    robotsTxt: '',
+    searchConsoleConnected: false,
+    sitemapLastGeneratedAt: null,
+    redirectRecoveryAiRerank: true,
+    redirectRecoveryAutoApply: false,
+    redirectRecoveryAutoApplyMinConfidence: 85,
+    linkAiIndexLastRunAt: null,
+};
+/** Merge stored module settings over the defaults (field-by-field). */
+export function resolveSeoModuleSettings(overrides) {
+    const stored = overrides?.module ?? {};
+    return {
+        ...DEFAULT_SEO_MODULE_SETTINGS,
+        ...Object.fromEntries(Object.entries(stored).filter(([, v]) => v !== undefined && v !== null)),
+    };
+}
+/** Persist a partial patch onto SEO module settings. */
+export async function patchSeoModuleSettings(db, patch, userId) {
+    const current = (await getSeoOverrides(db)) ?? {};
+    const saved = await putSeoOverrides(db, {
+        site: current.site,
+        collections: current.collections,
+        module: { ...(current.module ?? {}), ...patch },
+    }, userId);
+    return resolveSeoModuleSettings(saved);
+}
+/** Read the SEO overrides document. Returns null when no row exists yet. */
+export async function getSeoOverrides(db) {
+    const d = db;
+    if (!d?.document?.findFirst)
+        return null;
+    try {
+        const doc = await d.document.findFirst({
+            where: { collection: SEO_CONFIG_COLLECTION, deletedAt: null },
+            select: { data: true },
+        });
+        if (!doc)
+            return null;
+        const data = doc.data;
+        if (!data || typeof data !== 'object')
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Upsert the SEO overrides document. The caller is responsible for auth/role
+ * checks — this function only handles storage.
+ */
+export async function putSeoOverrides(db, overrides, userId) {
+    const d = db;
+    const data = {
+        ...overrides,
+        updatedAt: new Date().toISOString(),
+        updatedBy: userId,
+    };
+    const existing = await d.document.findFirst({
+        where: { collection: SEO_CONFIG_COLLECTION, deletedAt: null },
+        select: { id: true },
+    });
+    if (existing) {
+        await d.document.update({
+            where: { id: existing.id },
+            data: { data, updatedById: userId },
+        });
+    }
+    else {
+        await d.document.create({
+            data: {
+                collection: SEO_CONFIG_COLLECTION,
+                data,
+                status: 'PUBLISHED',
+                title: 'SEO defaults',
+                slug: 'seo-config',
+                createdById: userId,
+                updatedById: userId,
+            },
+        });
+    }
+    return data;
+}
+/**
+ * Shallow-merge that drops undefined / empty-string values on the override
+ * side so the UI can "unset" a field by submitting an empty string.
+ */
+function mergeFields(base, over) {
+    const out = { ...(base ?? {}) };
+    if (!over)
+        return out;
+    for (const [k, v] of Object.entries(over)) {
+        if (v === undefined)
+            continue;
+        if (typeof v === 'string' && v.trim() === '')
+            continue;
+        if (v === null) {
+            delete out[k];
+            continue;
+        }
+        out[k] = v;
+    }
+    return out;
+}
+/**
+ * Merge static site-wide SEO config with the DB overrides. Nested objects
+ * (`robots`, `sitemap`, `ogImage`, `organization`) merge field-by-field;
+ * primitive values use override-wins-if-set.
+ */
+export function mergeSiteSeoConfig(base, over) {
+    if (!over)
+        return { ...(base ?? {}) };
+    // The SEO config interfaces are declared with explicit named fields and no
+    // index signature, so we cast through Record<string, unknown> when calling
+    // the generic merge helper. Behaviour is unchanged; this is purely a
+    // structural-typing escape hatch.
+    const merged = mergeFields(base, over);
+    return {
+        ...merged,
+        robots: mergeFields(base?.robots, over.robots),
+        sitemap: mergeFields(base?.sitemap, over.sitemap),
+        ogImage: mergeFields(base?.ogImage, over.ogImage),
+        organization: mergeFields(base?.organization, over.organization),
+        verification: mergeFields(base?.verification, over.verification),
+    };
+}
+/** Same merge semantics as the site-wide version, applied to a single collection. */
+export function mergeCollectionSeoConfig(base, over) {
+    if (!over)
+        return { ...(base ?? {}) };
+    const merged = mergeFields(base, over);
+    return {
+        ...merged,
+        defaultRobots: mergeFields(base?.defaultRobots, over.defaultRobots),
+        defaultOgImage: mergeFields(base?.defaultOgImage, over.defaultOgImage),
+    };
+}
+/**
+ * Return a new config object with DB-stored SEO overrides applied. The
+ * static config is never mutated — callers receive a shallow copy with
+ * `seo` and each collection's `seo` block replaced by the merged values.
+ *
+ * Routes that compose SEO output call this once per request, then thread
+ * the result through to `composePageMeta` / sitemap helpers exactly like
+ * the static config they replaced.
+ */
+export function applySeoOverrides(config, overrides) {
+    if (!config)
+        return null;
+    if (!overrides)
+        return config;
+    const mergedSite = mergeSiteSeoConfig(config.seo, overrides.site);
+    const mergedCollections = {};
+    for (const [slug, col] of Object.entries(config.collections ?? {})) {
+        const colOver = overrides.collections?.[slug];
+        mergedCollections[slug] = colOver
+            ? { ...col, seo: mergeCollectionSeoConfig(col.seo, colOver) }
+            : col;
+    }
+    return {
+        ...config,
+        seo: mergedSite,
+        collections: mergedCollections,
+    };
+}
+//# sourceMappingURL=config-store.js.map

package/dist/seo/config-store.js.map

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

package/dist/seo/confirm-broken-links.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Live confirmation for CMS-static "broken internal link" candidates.
+ *
+ * Static detection only knows about CMS documents + redirect rules. Hybrid /
+ * Astro-native routes (e.g. `/how-it-works`) look like 404s to that pass even
+ * when the public site returns 200. This module probes the site origin before
+ * any issue is raised or a recovery redirect is planned.
+ */
+import { safeFetch } from '../security/safe-fetch.js';
+export type BrokenLinkCandidate = {
+    url: string;
+    fromEntityId: string;
+    fromTitle: string;
+    fromUrl: string;
+};
+export type ConfirmBrokenLinksOptions = {
+    siteUrl: string;
+    /** Injected for tests. Defaults to cms-core `safeFetch`. */
+    fetchFn?: typeof safeFetch;
+    timeoutMs?: number;
+    concurrency?: number;
+};
+/**
+ * Probe a site-relative path (`/how-it-works`) against `siteUrl`.
+ * Returns the HTTP status, or `0` on network failure / `−1` on SSRF block.
+ */
+export declare function probeSitePathStatus(siteUrl: string, path: string, options?: {
+    fetchFn?: typeof safeFetch;
+    timeoutMs?: number;
+}): Promise<number>;
+/**
+ * Keep only candidates whose target path is **confirmed dead** on the live
+ * site. Live 200/3xx paths (including non-CMS framework routes) are dropped.
+ * When `siteUrl` is empty, returns `[]` — CMS resolution alone must not claim
+ * "returns 404".
+ */
+export declare function confirmBrokenLinksOverHttp(candidates: BrokenLinkCandidate[], options: ConfirmBrokenLinksOptions): Promise<BrokenLinkCandidate[]>;
+/**
+ * Return the subset of recovery source paths that are confirmed dead on the
+ * live site. Live (2xx/3xx) and unverifiable sources are excluded so we never
+ * suggest or auto-apply a redirect that would take a working page offline.
+ */
+export declare function filterConfirmedDeadRecoveryPaths(paths: string[], siteUrl: string, options?: {
+    fetchFn?: typeof safeFetch;
+    timeoutMs?: number;
+    concurrency?: number;
+}): Promise<Set<string>>;
+//# sourceMappingURL=confirm-broken-links.d.ts.map

package/dist/seo/confirm-broken-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-broken-links.d.ts","sourceRoot":"","sources":["../../src/seo/confirm-broken-links.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAoB,MAAM,2BAA2B,CAAA;AAGvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAuCD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACd,GACL,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA8BhC;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CAChB,GACL,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAuBtB"}

package/dist/seo/confirm-broken-links.js

@@ -0,0 +1,135 @@
+/**
+ * Live confirmation for CMS-static "broken internal link" candidates.
+ *
+ * Static detection only knows about CMS documents + redirect rules. Hybrid /
+ * Astro-native routes (e.g. `/how-it-works`) look like 404s to that pass even
+ * when the public site returns 200. This module probes the site origin before
+ * any issue is raised or a recovery redirect is planned.
+ */
+import { normalizeRedirectPath } from '../redirects/graph.js';
+import { safeFetch, SsrfBlockedError } from '../security/safe-fetch.js';
+import { isConfirmedDeadLinkStatus, LINK_PROBE_HEADERS } from './link-probe.js';
+function hrefToSitePath(href, siteUrl) {
+    const trimmed = href.trim();
+    if (!trimmed ||
+        trimmed.startsWith('#') ||
+        trimmed.startsWith('mailto:') ||
+        trimmed.startsWith('tel:')) {
+        return null;
+    }
+    if (/^https?:\/\//i.test(trimmed)) {
+        const base = siteUrl.replace(/\/+$/, '').toLowerCase();
+        if (!base || !trimmed.toLowerCase().startsWith(base))
+            return null;
+        return normalizeRedirectPath(trimmed.slice(base.length) || '/');
+    }
+    return normalizeRedirectPath(trimmed);
+}
+async function mapWithConcurrency(items, concurrency, worker) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    async function run() {
+        while (cursor < items.length) {
+            const index = cursor++;
+            results[index] = await worker(items[index]);
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(concurrency, Math.max(items.length, 1)) }, () => run()));
+    return results;
+}
+/**
+ * Probe a site-relative path (`/how-it-works`) against `siteUrl`.
+ * Returns the HTTP status, or `0` on network failure / `−1` on SSRF block.
+ */
+export async function probeSitePathStatus(siteUrl, path, options = {}) {
+    const base = siteUrl.replace(/\/+$/, '');
+    const normalized = normalizeRedirectPath(path);
+    if (!base || !normalized)
+        return 0;
+    const absolute = `${base}${normalized === '/' ? '/' : normalized}`;
+    const fetchFn = options.fetchFn ?? safeFetch;
+    try {
+        const resp = await fetchFn(absolute, {
+            method: 'GET',
+            headers: { ...LINK_PROBE_HEADERS },
+            timeoutMs: options.timeoutMs ?? 4000,
+            // Follow redirects so a 301→200 native route is treated as alive.
+            followRedirects: true,
+            maxRedirects: 5,
+        });
+        try {
+            await resp.body?.cancel();
+        }
+        catch {
+            /* noop */
+        }
+        return resp.status;
+    }
+    catch (err) {
+        if (err instanceof SsrfBlockedError)
+            return -1;
+        return 0;
+    }
+}
+/**
+ * Keep only candidates whose target path is **confirmed dead** on the live
+ * site. Live 200/3xx paths (including non-CMS framework routes) are dropped.
+ * When `siteUrl` is empty, returns `[]` — CMS resolution alone must not claim
+ * "returns 404".
+ */
+export async function confirmBrokenLinksOverHttp(candidates, options) {
+    const siteUrl = options.siteUrl.replace(/\/+$/, '');
+    if (!siteUrl || candidates.length === 0)
+        return [];
+    const byPath = new Map();
+    for (const c of candidates) {
+        const path = hrefToSitePath(c.url, siteUrl);
+        if (!path || path === '/')
+            continue;
+        const list = byPath.get(path) ?? [];
+        list.push(c);
+        byPath.set(path, list);
+    }
+    const paths = [...byPath.keys()];
+    const concurrency = options.concurrency ?? 6;
+    const statuses = await mapWithConcurrency(paths, concurrency, (path) => probeSitePathStatus(siteUrl, path, {
+        fetchFn: options.fetchFn,
+        timeoutMs: options.timeoutMs,
+    }));
+    const confirmed = [];
+    for (let i = 0; i < paths.length; i++) {
+        const path = paths[i];
+        const status = statuses[i];
+        if (!isConfirmedDeadLinkStatus(status))
+            continue;
+        confirmed.push(...(byPath.get(path) ?? []));
+    }
+    return confirmed;
+}
+/**
+ * Return the subset of recovery source paths that are confirmed dead on the
+ * live site. Live (2xx/3xx) and unverifiable sources are excluded so we never
+ * suggest or auto-apply a redirect that would take a working page offline.
+ */
+export async function filterConfirmedDeadRecoveryPaths(paths, siteUrl, options = {}) {
+    const base = siteUrl.replace(/\/+$/, '');
+    const dead = new Set();
+    if (!base || paths.length === 0)
+        return dead;
+    const unique = [
+        ...new Set(paths
+            .map((p) => normalizeRedirectPath(p))
+            .filter((p) => Boolean(p) && p !== '/')),
+    ];
+    const concurrency = options.concurrency ?? 6;
+    const statuses = await mapWithConcurrency(unique, concurrency, (path) => probeSitePathStatus(base, path, {
+        fetchFn: options.fetchFn,
+        timeoutMs: options.timeoutMs,
+    }));
+    for (let i = 0; i < unique.length; i++) {
+        if (isConfirmedDeadLinkStatus(statuses[i]))
+            dead.add(unique[i]);
+    }
+    return dead;
+}
+//# sourceMappingURL=confirm-broken-links.js.map

package/dist/seo/confirm-broken-links.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * 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 declare function htmlToMarkdown(html: string | null | undefined, baseUrl?: string | null): string;
+export interface DocumentMarkdownInput {
+    title?: string | null;
+    /** The document's `data` JSON column. */
+    data?: Record<string, unknown> | null;
+    /** Pre-extracted plain text fallback (the `plainText` column). */
+    plainText?: string | null;
+}
+export interface DocumentMarkdownOptions {
+    /**
+     * Site base URL used to absolutize relative links/images in body content, so
+     * the off-host `.md` / `/llms-full.txt` export stays navigable.
+     */
+    baseUrl?: string | null;
+}
+/**
+ * Render a published document to clean Markdown:
+ *   `# Title`, an optional one-line takeaway, then the body.
+ */
+export declare function documentToMarkdown(doc: DocumentMarkdownInput, options?: DocumentMarkdownOptions): string;
+//# sourceMappingURL=content-markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-markdown.d.ts","sourceRoot":"","sources":["../../src/seo/content-markdown.ts"],"names":[],"mappings":"AAmEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAc/F;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACrC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AA2BD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAqBR"}