@prenta/core 0.118.0

package/dist/seo/site-identity.js

@@ -0,0 +1,109 @@
+import { buildOrganizationSchema, buildWebSiteSchema, renderJsonLdScript, } from '../content/structured-data.js';
+function trimUrl(value) {
+    if (typeof value !== 'string')
+        return '';
+    return value.trim().replace(/\/+$/, '');
+}
+function trimText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function toSiteSchema(input) {
+    const siteUrl = trimUrl(input.siteUrl);
+    const siteName = trimText(input.siteName) || 'Site';
+    const logo = trimUrl(input.organizationLogo ?? '');
+    return {
+        siteUrl,
+        siteName,
+        ...(input.siteDescription ? { siteDescription: input.siteDescription } : {}),
+        organizationName: trimText(input.organizationName) || siteName,
+        ...(input.organizationUrl ? { organizationUrl: trimUrl(input.organizationUrl) } : {}),
+        ...(logo ? { organizationLogo: logo } : {}),
+        ...(input.organizationSameAs?.length ? { organizationSameAs: input.organizationSameAs } : {}),
+        ...(input.organizationType ? { organizationType: input.organizationType } : {}),
+        ...(input.searchUrlTemplate ? { searchUrlTemplate: input.searchUrlTemplate } : {}),
+        ...(input.defaultLanguage ? { defaultLanguage: input.defaultLanguage } : {}),
+    };
+}
+/**
+ * Build identity input from Site SEO settings, with optional serving-origin
+ * fallbacks when `site.siteUrl` / `site.siteName` are empty.
+ * Returns `null` when no usable `siteUrl` can be resolved.
+ */
+export function siteIdentityFromSeo(site, fallbacks) {
+    const siteUrl = trimUrl(site?.siteUrl) || trimUrl(fallbacks?.siteUrl);
+    if (!siteUrl)
+        return null;
+    const siteName = trimText(site?.siteName) || trimText(fallbacks?.siteName) || 'Site';
+    const logo = trimUrl(site?.organization?.logo) || trimUrl(site?.defaultOgImage);
+    return {
+        siteUrl,
+        siteName,
+        ...(site?.defaultMetaDescription ? { siteDescription: site.defaultMetaDescription } : {}),
+        organizationName: trimText(site?.organization?.name) || siteName,
+        ...(site?.organization?.url ? { organizationUrl: trimUrl(site.organization.url) } : {}),
+        ...(logo ? { organizationLogo: logo } : {}),
+        ...(site?.organization?.sameAs?.length ? { organizationSameAs: site.organization.sameAs } : {}),
+        ...(site?.organization?.type ? { organizationType: site.organization.type } : {}),
+        ...(site?.searchUrlTemplate ? { searchUrlTemplate: site.searchUrlTemplate } : {}),
+    };
+}
+/** WebSite + Organization nodes with stable `#website` / `#organization` @ids. */
+export function siteIdentityNodes(input) {
+    const site = toSiteSchema(input);
+    if (!site.siteUrl)
+        return [];
+    const nodes = [];
+    if (input.includeWebSite !== false) {
+        nodes.push(buildWebSiteSchema(site));
+    }
+    nodes.push(buildOrganizationSchema(site));
+    return nodes;
+}
+/** Full JSON-LD document (`@context` + `@graph`) for site identity. */
+export function siteIdentityJsonLd(input) {
+    return {
+        '@context': 'https://schema.org',
+        '@graph': siteIdentityNodes(input),
+    };
+}
+/** XSS-safe `<script type="application/ld+json">` for site identity. */
+export function siteIdentityJsonLdHtml(input) {
+    const graph = siteIdentityNodes(input);
+    if (graph.length === 0)
+        return '';
+    return renderJsonLdScript({
+        '@context': 'https://schema.org',
+        '@graph': graph,
+    });
+}
+/**
+ * True when JSON-LD already defines an Organization-family node (by `@id` or
+ * `@type`). Use to avoid double-emitting identity on CMS pages that already
+ * went through `composePageMeta` / `buildSchemaGraph`.
+ */
+export function jsonLdHasOrganization(jsonLd) {
+    if (!jsonLd || typeof jsonLd !== 'object')
+        return false;
+    const obj = jsonLd;
+    const graph = obj['@graph'];
+    const nodes = Array.isArray(graph) ? graph : [obj];
+    for (const node of nodes) {
+        if (!node || typeof node !== 'object' || Array.isArray(node))
+            continue;
+        const n = node;
+        const id = typeof n['@id'] === 'string' ? n['@id'] : '';
+        if (id.endsWith('#organization') || id.includes('/#organization'))
+            return true;
+        const rawType = n['@type'];
+        const types = Array.isArray(rawType)
+            ? rawType.filter((t) => typeof t === 'string')
+            : typeof rawType === 'string'
+                ? [rawType]
+                : [];
+        if (types.some((t) => ['Organization', 'Corporation', 'LocalBusiness', 'OnlineBusiness'].includes(t))) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=site-identity.js.map

package/dist/seo/site-identity.js.map

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

package/dist/seo/sitemap-notify.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Sitemap regeneration + search-engine ping orchestration.
+ *
+ * Triggered as a best-effort side effect after public content is published,
+ * updated, or removed (see `actions.ts` → `sitemap-notify` pending effect).
+ * The CMS serves `/sitemap.xml` dynamically, so "regeneration" here means:
+ *   1. bump `sitemapLastGeneratedAt` so the Settings/Technical UI reflects the
+ *      change, and
+ *   2. invalidate the sitemap cache tag so the next request rebuilds it.
+ *
+ * Pinging is **production-gated** and **SSRF-aware**:
+ *   - Pings only fire when the resolved environment is `production` (or the
+ *     caller explicitly opts in via `allowNonProduction`), so preview/local
+ *     deploys never notify Google/Bing about throwaway URLs.
+ *   - The site URL is validated as a public http(s) URL before it's embedded
+ *     in a ping request, so a misconfigured `siteUrl` can't point search
+ *     engines (or our own fetch) at an internal address.
+ *
+ * Note on endpoints: Google retired its standalone sitemap-ping endpoint in
+ * 2023 (it now returns 404) and recommends discovery via robots.txt / Search
+ * Console instead, so we no longer ping it — every request was pure overhead
+ * that recorded a misleading `http-404`. Bing's endpoint still honors pings, so
+ * it's kept (non-2xx is treated as a soft failure). Instant, per-URL indexing
+ * is handled by IndexNow (below), which runs independently of the sitemap
+ * regeneration debounce.
+ */
+import type { SeoModuleSettings } from './config-store.js';
+export interface SitemapPingTarget {
+    name: string;
+    url: string;
+}
+/** Build the canonical `/sitemap.xml` URL from a configured site URL. */
+export declare function buildSitemapUrl(siteUrl: string | null | undefined): string | null;
+/**
+ * Legacy search-engine ping targets for a given (already validated) sitemap
+ * URL. Google's `/ping?sitemap=` endpoint was retired in 2023 (now a 404), so
+ * it's deliberately omitted — only Bing, which still honors pings, remains.
+ * Modern instant indexing goes through IndexNow, not these endpoints.
+ */
+export declare function buildSearchEnginePings(sitemapUrl: string): SitemapPingTarget[];
+/** IndexNow submission endpoint (a shared endpoint relays to all participants). */
+export declare const INDEXNOW_ENDPOINT = "https://api.indexnow.org/indexnow";
+export interface IndexNowSubmission {
+    host: string;
+    key: string;
+    keyLocation: string;
+    urlList: string[];
+}
+/**
+ * Build the IndexNow submission body for a set of changed URLs.
+ *
+ * IndexNow (Bing, Yandex, Seznam, Naver, …) is URL-based — unlike the legacy
+ * sitemap pings, it notifies engines of the *specific* URLs that changed for
+ * near-instant (re)crawling. Returns null when there's no key or no in-host
+ * URLs to submit (every URL must share the sitemap host).
+ */
+export declare function buildIndexNowSubmission(params: {
+    key: string | null | undefined;
+    keyLocation: string | null | undefined;
+    changedUrls: string[];
+}): IndexNowSubmission | null;
+/**
+ * Default debounce window for the expensive half of the cycle (timestamp write
+ * + search-engine ping). Bursts of publishes (bulk imports, "publish all")
+ * collapse to one regeneration per window so we don't hammer the single hot
+ * `__seo_config__` row or spam search engines. Cache invalidation is NOT
+ * debounced — it's cheap and must happen on every change for correctness.
+ */
+export declare const DEFAULT_SITEMAP_DEBOUNCE_MS = 60000;
+export interface SitemapNotifyOptions {
+    settings: Pick<SeoModuleSettings, 'sitemapEnabled' | 'autoRegenerateSitemapOnPublish' | 'pingSearchEnginesOnPublish'>;
+    /** Configured public site URL (e.g. from `NEXT_PUBLIC_SITE_URL` or seo.siteUrl). */
+    siteUrl?: string | null;
+    /** Explicit environment override; defaults to `resolveSeoEnvironment()`. */
+    environment?: string;
+    /** ISO timestamp of the last regeneration, used to debounce the write + ping. */
+    lastGeneratedAt?: string | null;
+    /** Debounce window in ms (default {@link DEFAULT_SITEMAP_DEBOUNCE_MS}). */
+    debounceMs?: number;
+    /** Injectable fetch for tests; defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Bypass the production gate (tests / explicit opt-in only). */
+    allowNonProduction?: boolean;
+    /** Per-ping timeout in ms (default 5000). */
+    timeoutMs?: number;
+    /**
+     * Absolute URLs of the content that just changed, for IndexNow submission.
+     * When omitted/empty, IndexNow is skipped (legacy sitemap pings still fire).
+     */
+    changedUrls?: string[];
+    /** IndexNow key (from `INDEXNOW_KEY`). When absent, IndexNow is disabled. */
+    indexNowKey?: string | null;
+    /** Public URL of the IndexNow key file (served at /api/cms/indexnow-key.txt). */
+    indexNowKeyLocation?: string | null;
+}
+export interface SitemapNotifyResult {
+    /**
+     * Whether the caller should drop the sitemap cache tag. True on every
+     * sitemap-relevant change (not debounced) so the next request rebuilds.
+     */
+    invalidateCache: boolean;
+    /**
+     * Whether the caller should persist a fresh `sitemapLastGeneratedAt`. Only
+     * true once per debounce window — this is the write that was amplifying.
+     */
+    regenerated: boolean;
+    sitemapUrl: string | null;
+    /** Names of search engines successfully pinged (2xx). */
+    pinged: string[];
+    /** Targets that were not pinged, with a machine-readable reason. */
+    skipped: Array<{
+        target: string;
+        reason: string;
+    }>;
+}
+/**
+ * Decide what to do after a public-content change and perform the pings.
+ * Pure-ish: all I/O goes through `fetchImpl` and the result tells the caller
+ * whether to persist a regeneration timestamp. Never throws — sitemap upkeep
+ * must not fail a content write that already committed.
+ */
+export declare function notifySitemapOnPublish(opts: SitemapNotifyOptions): Promise<SitemapNotifyResult>;
+//# sourceMappingURL=sitemap-notify.d.ts.map

package/dist/seo/sitemap-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-notify.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASjF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAG9E;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,sCAAsC,CAAA;AAEpE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACtC,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,GAAG,kBAAkB,GAAG,IAAI,CA+B5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAA;AAEjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,IAAI,CACZ,iBAAiB,EACjB,gBAAgB,GAAG,gCAAgC,GAAG,4BAA4B,CACnF,CAAA;IACD,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,oEAAoE;IACpE,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnD;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA0J9B"}

package/dist/seo/sitemap-notify.js

@@ -0,0 +1,270 @@
+/**
+ * Sitemap regeneration + search-engine ping orchestration.
+ *
+ * Triggered as a best-effort side effect after public content is published,
+ * updated, or removed (see `actions.ts` → `sitemap-notify` pending effect).
+ * The CMS serves `/sitemap.xml` dynamically, so "regeneration" here means:
+ *   1. bump `sitemapLastGeneratedAt` so the Settings/Technical UI reflects the
+ *      change, and
+ *   2. invalidate the sitemap cache tag so the next request rebuilds it.
+ *
+ * Pinging is **production-gated** and **SSRF-aware**:
+ *   - Pings only fire when the resolved environment is `production` (or the
+ *     caller explicitly opts in via `allowNonProduction`), so preview/local
+ *     deploys never notify Google/Bing about throwaway URLs.
+ *   - The site URL is validated as a public http(s) URL before it's embedded
+ *     in a ping request, so a misconfigured `siteUrl` can't point search
+ *     engines (or our own fetch) at an internal address.
+ *
+ * Note on endpoints: Google retired its standalone sitemap-ping endpoint in
+ * 2023 (it now returns 404) and recommends discovery via robots.txt / Search
+ * Console instead, so we no longer ping it — every request was pure overhead
+ * that recorded a misleading `http-404`. Bing's endpoint still honors pings, so
+ * it's kept (non-2xx is treated as a soft failure). Instant, per-URL indexing
+ * is handled by IndexNow (below), which runs independently of the sitemap
+ * regeneration debounce.
+ */
+import { resolveSeoEnvironment } from './robots.js';
+import { validateWebhookUrl } from '../security/webhook.js';
+/** Build the canonical `/sitemap.xml` URL from a configured site URL. */
+export function buildSitemapUrl(siteUrl) {
+    if (!siteUrl)
+        return null;
+    try {
+        const u = new URL(siteUrl);
+        if (u.protocol !== 'https:' && u.protocol !== 'http:')
+            return null;
+        return `${u.origin}/sitemap.xml`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Legacy search-engine ping targets for a given (already validated) sitemap
+ * URL. Google's `/ping?sitemap=` endpoint was retired in 2023 (now a 404), so
+ * it's deliberately omitted — only Bing, which still honors pings, remains.
+ * Modern instant indexing goes through IndexNow, not these endpoints.
+ */
+export function buildSearchEnginePings(sitemapUrl) {
+    const enc = encodeURIComponent(sitemapUrl);
+    return [{ name: 'bing', url: `https://www.bing.com/ping?sitemap=${enc}` }];
+}
+/** IndexNow submission endpoint (a shared endpoint relays to all participants). */
+export const INDEXNOW_ENDPOINT = 'https://api.indexnow.org/indexnow';
+/**
+ * Build the IndexNow submission body for a set of changed URLs.
+ *
+ * IndexNow (Bing, Yandex, Seznam, Naver, …) is URL-based — unlike the legacy
+ * sitemap pings, it notifies engines of the *specific* URLs that changed for
+ * near-instant (re)crawling. Returns null when there's no key or no in-host
+ * URLs to submit (every URL must share the sitemap host).
+ */
+export function buildIndexNowSubmission(params) {
+    const key = params.key?.trim();
+    const keyLocation = params.keyLocation?.trim();
+    if (!key || !keyLocation)
+        return null;
+    let host;
+    try {
+        host = new URL(keyLocation).host;
+    }
+    catch {
+        return null;
+    }
+    // Only submit absolute, same-host https/http URLs — IndexNow rejects
+    // cross-host submissions, and this also blocks a misconfigured URL from
+    // leaking off-site.
+    const seen = new Set();
+    const urlList = [];
+    for (const raw of params.changedUrls) {
+        try {
+            const u = new URL(raw);
+            if (u.protocol !== 'https:' && u.protocol !== 'http:')
+                continue;
+            if (u.host !== host)
+                continue;
+            if (seen.has(u.href))
+                continue;
+            seen.add(u.href);
+            urlList.push(u.href);
+        }
+        catch {
+            // Skip non-absolute / malformed URLs.
+        }
+    }
+    if (urlList.length === 0)
+        return null;
+    return { host, key, keyLocation, urlList };
+}
+/**
+ * Default debounce window for the expensive half of the cycle (timestamp write
+ * + search-engine ping). Bursts of publishes (bulk imports, "publish all")
+ * collapse to one regeneration per window so we don't hammer the single hot
+ * `__seo_config__` row or spam search engines. Cache invalidation is NOT
+ * debounced — it's cheap and must happen on every change for correctness.
+ */
+export const DEFAULT_SITEMAP_DEBOUNCE_MS = 60_000;
+/**
+ * Decide what to do after a public-content change and perform the pings.
+ * Pure-ish: all I/O goes through `fetchImpl` and the result tells the caller
+ * whether to persist a regeneration timestamp. Never throws — sitemap upkeep
+ * must not fail a content write that already committed.
+ */
+export async function notifySitemapOnPublish(opts) {
+    const { settings } = opts;
+    const result = {
+        invalidateCache: false,
+        regenerated: false,
+        sitemapUrl: null,
+        pinged: [],
+        skipped: [],
+    };
+    // Sitemap disabled entirely → nothing to do (no cache drop, no write).
+    if (!settings.sitemapEnabled) {
+        result.skipped.push({ target: 'sitemap', reason: 'sitemap-disabled' });
+        return result;
+    }
+    // Auto-regenerate off → the admin opted out of publish-time refresh entirely.
+    if (!settings.autoRegenerateSitemapOnPublish) {
+        result.skipped.push({ target: 'sitemap', reason: 'auto-regenerate-disabled' });
+        return result;
+    }
+    // The sitemap content changed and auto-regenerate is on → the cache must be
+    // dropped on EVERY change so the next request rebuilds. This is the cheap,
+    // un-debounced half of the cycle.
+    result.invalidateCache = true;
+    // Debounce ONLY the expensive sitemap half (DB timestamp write + legacy Bing
+    // ping): if we regenerated within the window, collapse this publish into the
+    // prior one for those side effects. IndexNow is deliberately excluded from
+    // this debounce (see below) — it's per-URL instant indexing, so every changed
+    // URL must be submitted, especially during the bursts (bulk import, "publish
+    // all") this debounce exists to smooth over.
+    const debounceMs = opts.debounceMs ?? DEFAULT_SITEMAP_DEBOUNCE_MS;
+    const lastMs = opts.lastGeneratedAt ? Date.parse(opts.lastGeneratedAt) : NaN;
+    const debounced = !Number.isNaN(lastMs) && Date.now() - lastMs < debounceMs;
+    if (debounced) {
+        result.skipped.push({ target: 'sitemap', reason: 'debounced' });
+    }
+    else {
+        result.regenerated = true;
+    }
+    const environment = resolveSeoEnvironment(opts.environment);
+    const isProduction = environment === 'production';
+    const productionAllowed = isProduction || opts.allowNonProduction === true;
+    const doFetch = opts.fetchImpl ?? globalThis.fetch;
+    const timeoutMs = opts.timeoutMs ?? 5000;
+    // Resolve + SSRF-validate the public site URL once. Both the legacy Bing ping
+    // and IndexNow are production-gated and require a safe public https URL — a
+    // misconfigured siteUrl must never point search engines (or our own fetch) at
+    // an internal address. The failure reason is reported under `target: 'ping'`
+    // for back-compat; the same gate short-circuits IndexNow below.
+    const sitemapUrl = buildSitemapUrl(opts.siteUrl);
+    if (sitemapUrl)
+        result.sitemapUrl = sitemapUrl;
+    let gateReason = null;
+    if (!settings.pingSearchEnginesOnPublish) {
+        gateReason = 'ping-disabled';
+    }
+    else if (!productionAllowed) {
+        gateReason = `non-production:${environment ?? 'unknown'}`;
+    }
+    else if (!sitemapUrl) {
+        gateReason = 'missing-or-invalid-site-url';
+    }
+    else if (!validateWebhookUrl(sitemapUrl).valid) {
+        gateReason = `unsafe-site-url:${validateWebhookUrl(sitemapUrl).error ?? 'invalid'}`;
+    }
+    else if (isProduction && !sitemapUrl.startsWith('https://')) {
+        gateReason = 'non-https-site-url';
+    }
+    else if (typeof doFetch !== 'function') {
+        gateReason = 'fetch-unavailable';
+    }
+    // The gate blocks BOTH search-engine notifications (legacy ping + IndexNow) —
+    // it only fails for reasons (opt-out, non-prod, unsafe URL) that apply equally
+    // to both, so short-circuit here.
+    if (gateReason) {
+        result.skipped.push({ target: 'ping', reason: gateReason });
+        return result;
+    }
+    // Past the gate: sitemapUrl is present and safe, doFetch is callable.
+    const safeSitemapUrl = sitemapUrl;
+    const fetchImpl = doFetch;
+    // Legacy Bing sitemap ping — debounced (collapsed within the window) since,
+    // unlike IndexNow, it only re-advertises the whole sitemap.
+    if (!debounced) {
+        const targets = buildSearchEnginePings(safeSitemapUrl);
+        await Promise.all(targets.map(async (target) => {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const res = await fetchImpl(target.url, {
+                    method: 'GET',
+                    redirect: 'error',
+                    signal: controller.signal,
+                });
+                if (res.ok) {
+                    result.pinged.push(target.name);
+                }
+                else {
+                    result.skipped.push({ target: target.name, reason: `http-${res.status}` });
+                }
+            }
+            catch (err) {
+                result.skipped.push({
+                    target: target.name,
+                    reason: err instanceof Error ? `fetch-error:${err.name}` : 'fetch-error',
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }));
+    }
+    // IndexNow — modern, URL-based instant indexing (Bing, Yandex, …). Submitted
+    // on EVERY publish (NOT debounced): the whole point is to notify engines of
+    // each specific changed/removed URL for near-instant (re)crawling, so a burst
+    // must submit every URL rather than collapse to the first. Batches whatever
+    // `changedUrls` provides (deduped, same-host only). Only fires when a key is
+    // configured AND there are in-host URLs to submit.
+    const submission = buildIndexNowSubmission({
+        key: opts.indexNowKey,
+        keyLocation: opts.indexNowKeyLocation,
+        changedUrls: opts.changedUrls ?? [],
+    });
+    if (!submission) {
+        result.skipped.push({ target: 'indexnow', reason: 'not-configured-or-no-urls' });
+    }
+    else {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetchImpl(INDEXNOW_ENDPOINT, {
+                method: 'POST',
+                redirect: 'error',
+                signal: controller.signal,
+                headers: { 'Content-Type': 'application/json; charset=utf-8' },
+                body: JSON.stringify(submission),
+            });
+            // IndexNow returns 200 (accepted) or 202 (accepted, pending). Both are OK.
+            if (res.ok) {
+                result.pinged.push('indexnow');
+            }
+            else {
+                result.skipped.push({ target: 'indexnow', reason: `http-${res.status}` });
+            }
+        }
+        catch (err) {
+            result.skipped.push({
+                target: 'indexnow',
+                reason: err instanceof Error ? `fetch-error:${err.name}` : 'fetch-error',
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sitemap-notify.js.map

package/dist/seo/sitemap-notify.js.map

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

package/dist/seo/sitemap-public.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Public sitemap URL naming (Yoast-style) and browser-facing XSLT stylesheets.
+ *
+ * Google limits each sitemap file to 50,000 URLs or 50 MB uncompressed. We split
+ * at 45,000 URLs (see SITEMAP_PAGE_SIZE) and name pages:
+ *   `{base}-sitemap.xml`     → page 0
+ *   `{base}-sitemap2.xml`    → page 1
+ *   `{base}-sitemap3.xml`    → page 2
+ *
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/large-sitemaps
+ */
+/** Yoast-style base name for a collection in sitemap filenames. */
+export declare function sitemapBaseName(collection: {
+    slug: string;
+    type?: 'page' | 'post';
+}): string;
+/** Build the public filename for a paginated collection sitemap. */
+export declare function collectionSitemapFilename(baseName: string, pageIndex: number): string;
+/** Canonical public URL for a collection sitemap page (no /api/cms prefix). */
+export declare function collectionSitemapPublicUrl(siteBase: string, baseName: string, pageIndex: number): string;
+/**
+ * Parse a Yoast-style sitemap filename.
+ * Returns null when the name does not match `{base}-sitemap{N}.xml`.
+ */
+export declare function parseCollectionSitemapFilename(filename: string): {
+    baseName: string;
+    pageIndex: number;
+} | null;
+/** Resolve a collection from a sitemap base name or legacy `{slug}.xml` slug. */
+export declare function resolveCollectionFromSitemapSlug<T extends {
+    slug: string;
+    type?: 'page' | 'post';
+}>(collections: T[], slugParam: string): {
+    collection: T;
+    pageIndex: number;
+} | null;
+/** XML stylesheet processing instruction for human-readable browser output. */
+export declare function sitemapStylesheetPi(siteBase: string, kind: 'index' | 'urlset'): string;
+/** XSLT for `<sitemapindex>` — lists child sitemaps (Yoast index layout). */
+export declare const SITEMAP_INDEX_XSL = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<xsl:stylesheet version=\"1.0\"\n  xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"\n  xmlns:s=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n  <xsl:output method=\"html\" encoding=\"UTF-8\" indent=\"yes\"/>\n  <xsl:template match=\"/\">\n    <html lang=\"en\">\n      <head>\n        <meta charset=\"UTF-8\"/>\n        <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"/>\n        <title>XML Sitemap Index</title>\n        <style>\n  * { box-sizing: border-box; }\n  body {\n    margin: 0;\n    padding: 2rem 1.5rem 3rem;\n    font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;\n    font-size: 1rem;\n    line-height: 1.5;\n    color: #18181b;\n    background: #fafafa;\n  }\n  .wrap { max-width: 72rem; margin: 0 auto; }\n  h1 { font-size: 1.5rem; font-weight: 500; margin: 0 0 0.5rem; }\n  .lead { color: #52525b; margin: 0 0 0.25rem; }\n  .meta { color: #71717a; font-size: 0.875rem; margin: 0 0 1.5rem; }\n  .meta a { color: #2563eb; }\n  table {\n    width: 100%;\n    border-collapse: collapse;\n    background: #fff;\n    border: 1px solid #e4e4e7;\n    border-radius: 0.5rem;\n    overflow: hidden;\n  }\n  th, td {\n    padding: 0.625rem 0.875rem;\n    text-align: left;\n    border-bottom: 1px solid #f4f4f5;\n    vertical-align: top;\n  }\n  th {\n    font-size: 0.875rem;\n    font-weight: 500;\n    color: #52525b;\n    background: #f4f4f5;\n  }\n  tr:nth-child(even) td { background: #fafafa; }\n  tr:last-child td { border-bottom: 0; }\n  td.num, th.num { text-align: center; width: 5rem; }\n  td.date, th.date { width: 12rem; white-space: nowrap; }\n  a { color: #2563eb; word-break: break-all; }\n  a:hover { text-decoration: underline; }\n  @media (prefers-color-scheme: dark) {\n    body { color: #fafafa; background: #09090b; }\n    .lead { color: #a1a1aa; }\n    .meta { color: #71717a; }\n    table { background: #18181b; border-color: #27272a; }\n    th { background: #27272a; color: #d4d4d8; }\n    th, td { border-bottom-color: #27272a; }\n    tr:nth-child(even) td { background: #111113; }\n    a { color: #60a5fa; }\n  }\n</style>\n      </head>\n      <body>\n        <div class=\"wrap\">\n          <h1>XML Sitemap Index</h1>\n          <p class=\"lead\">Generated by Prenta CMS \u2014 meant for consumption by search engines.</p>\n          <p class=\"meta\">\n            Learn more at <a href=\"https://www.sitemaps.org/\">sitemaps.org</a>.\n            This index contains <strong><xsl:value-of select=\"count(s:sitemapindex/s:sitemap)\"/></strong> sitemaps.\n          </p>\n          <table>\n            <thead>\n              <tr>\n                <th>Sitemap</th>\n                <th class=\"date\">Last Modified</th>\n              </tr>\n            </thead>\n            <tbody>\n              <xsl:for-each select=\"s:sitemapindex/s:sitemap\">\n                <tr>\n                  <td><a href=\"{s:loc}\"><xsl:value-of select=\"s:loc\"/></a></td>\n                  <td class=\"date\"><xsl:value-of select=\"s:lastmod\"/></td>\n                </tr>\n              </xsl:for-each>\n            </tbody>\n          </table>\n        </div>\n      </body>\n    </html>\n  </xsl:template>\n</xsl:stylesheet>";
+/** XSLT for `<urlset>` — URL list with image counts (Yoast urlset layout). */
+export declare const SITEMAP_URLSET_XSL = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<xsl:stylesheet version=\"1.0\"\n  xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"\n  xmlns:s=\"http://www.sitemaps.org/schemas/sitemap/0.9\"\n  xmlns:image=\"http://www.google.com/schemas/sitemap-image/1.1\">\n  <xsl:output method=\"html\" encoding=\"UTF-8\" indent=\"yes\"/>\n  <xsl:template match=\"/\">\n    <html lang=\"en\">\n      <head>\n        <meta charset=\"UTF-8\"/>\n        <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"/>\n        <title>XML Sitemap</title>\n        <style>\n  * { box-sizing: border-box; }\n  body {\n    margin: 0;\n    padding: 2rem 1.5rem 3rem;\n    font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;\n    font-size: 1rem;\n    line-height: 1.5;\n    color: #18181b;\n    background: #fafafa;\n  }\n  .wrap { max-width: 72rem; margin: 0 auto; }\n  h1 { font-size: 1.5rem; font-weight: 500; margin: 0 0 0.5rem; }\n  .lead { color: #52525b; margin: 0 0 0.25rem; }\n  .meta { color: #71717a; font-size: 0.875rem; margin: 0 0 1.5rem; }\n  .meta a { color: #2563eb; }\n  table {\n    width: 100%;\n    border-collapse: collapse;\n    background: #fff;\n    border: 1px solid #e4e4e7;\n    border-radius: 0.5rem;\n    overflow: hidden;\n  }\n  th, td {\n    padding: 0.625rem 0.875rem;\n    text-align: left;\n    border-bottom: 1px solid #f4f4f5;\n    vertical-align: top;\n  }\n  th {\n    font-size: 0.875rem;\n    font-weight: 500;\n    color: #52525b;\n    background: #f4f4f5;\n  }\n  tr:nth-child(even) td { background: #fafafa; }\n  tr:last-child td { border-bottom: 0; }\n  td.num, th.num { text-align: center; width: 5rem; }\n  td.date, th.date { width: 12rem; white-space: nowrap; }\n  a { color: #2563eb; word-break: break-all; }\n  a:hover { text-decoration: underline; }\n  @media (prefers-color-scheme: dark) {\n    body { color: #fafafa; background: #09090b; }\n    .lead { color: #a1a1aa; }\n    .meta { color: #71717a; }\n    table { background: #18181b; border-color: #27272a; }\n    th { background: #27272a; color: #d4d4d8; }\n    th, td { border-bottom-color: #27272a; }\n    tr:nth-child(even) td { background: #111113; }\n    a { color: #60a5fa; }\n  }\n</style>\n      </head>\n      <body>\n        <div class=\"wrap\">\n          <h1>XML Sitemap</h1>\n          <p class=\"lead\">Generated by Prenta CMS \u2014 meant for consumption by search engines.</p>\n          <p class=\"meta\">\n            Learn more at <a href=\"https://www.sitemaps.org/\">sitemaps.org</a>.\n            This sitemap contains <strong><xsl:value-of select=\"count(s:urlset/s:url)\"/></strong> URLs.\n          </p>\n          <table>\n            <thead>\n              <tr>\n                <th>URL</th>\n                <th class=\"num\">Images</th>\n                <th class=\"date\">Last Modified</th>\n              </tr>\n            </thead>\n            <tbody>\n              <xsl:for-each select=\"s:urlset/s:url\">\n                <tr>\n                  <td><a href=\"{s:loc}\"><xsl:value-of select=\"s:loc\"/></a></td>\n                  <td class=\"num\"><xsl:value-of select=\"count(image:image)\"/></td>\n                  <td class=\"date\"><xsl:value-of select=\"s:lastmod\"/></td>\n                </tr>\n              </xsl:for-each>\n            </tbody>\n          </table>\n        </div>\n      </body>\n    </html>\n  </xsl:template>\n</xsl:stylesheet>";
+//# sourceMappingURL=sitemap-public.d.ts.map

package/dist/seo/sitemap-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-public.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap-public.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,MAAM,CAI5F;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGrF;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUhD;AAED,iFAAiF;AACjF,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAClD,WAAW,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAalF;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAItF;AAwDD,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,6qGAyCZ,CAAA;AAElB,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,i1GA4Cb,CAAA"}