@prenta/core 0.118.0

package/dist/seo/meta-tags.js

@@ -0,0 +1,353 @@
+/**
+ * Common bare language subtags → a sensible default territory for OG. Open
+ * Graph's `og:locale` requires `language_TERRITORY`; a crawler treats a bare
+ * language (or a hyphenated BCP-47 tag) as unset. When only a language subtag
+ * is supplied we map the well-known ones and otherwise fall back to
+ * `lang_LANG` (e.g. `fr` → `fr_FR`).
+ */
+const DEFAULT_TERRITORY_FOR_LANGUAGE = {
+    en: 'US',
+    ja: 'JP',
+    zh: 'CN',
+    ko: 'KR',
+    cs: 'CZ',
+    da: 'DK',
+    el: 'GR',
+    he: 'IL',
+    ja_jp: 'JP',
+    nb: 'NO',
+    sv: 'SE',
+    uk: 'UA',
+    vi: 'VN',
+};
+/**
+ * Normalize a locale to Open Graph `language_TERRITORY` form. Accepts OG form
+ * (`en_US`), a BCP-47 tag (`en-US`), or a bare language (`en`). Returns
+ * undefined for empty input.
+ */
+export function normalizeOgLocale(locale) {
+    if (!locale || typeof locale !== 'string')
+        return undefined;
+    const raw = locale.trim();
+    if (!raw)
+        return undefined;
+    // Split on the first hyphen/underscore into language + region.
+    const [langPart, ...rest] = raw.split(/[-_]/);
+    const lang = (langPart ?? '').toLowerCase();
+    if (!lang)
+        return undefined;
+    const region = rest.find((p) => p.length === 2 || p.length === 3);
+    if (region)
+        return `${lang}_${region.toUpperCase()}`;
+    const fallbackRegion = DEFAULT_TERRITORY_FOR_LANGUAGE[lang] ?? lang.toUpperCase();
+    return `${lang}_${fallbackRegion}`;
+}
+/** Normalize + dedupe alternate locales, excluding the primary. */
+function normalizeOgLocaleAlternates(locales, primary) {
+    if (!Array.isArray(locales))
+        return [];
+    const out = [];
+    for (const l of locales) {
+        const norm = normalizeOgLocale(l);
+        if (norm && norm !== primary && !out.includes(norm))
+            out.push(norm);
+    }
+    return out;
+}
+const HTML_ESCAPE_MAP = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+function escapeHtml(str) {
+    return str.replace(/[&<>"']/g, (ch) => HTML_ESCAPE_MAP[ch]);
+}
+export function generateMetaTags(input) {
+    const tags = {};
+    const ogTitle = input.ogTitle ?? input.title;
+    const ogDescription = input.ogDescription ?? input.description;
+    const twTitle = input.twitterTitle ?? ogTitle;
+    const twDescription = input.twitterDescription ?? ogDescription;
+    const twImage = input.twitterImage ?? input.ogImage?.url;
+    tags['og:title'] = ogTitle;
+    if (ogDescription)
+        tags['og:description'] = ogDescription;
+    tags['og:url'] = input.url;
+    tags['og:site_name'] = input.siteName;
+    tags['og:locale'] = normalizeOgLocale(input.locale) ?? 'en_US';
+    const primaryLocale = tags['og:locale'];
+    // og:locale:alternate for the other configured locales (Record can only hold
+    // the last one — renderMetaTagsHtml re-emits the full list).
+    const altLocales = normalizeOgLocaleAlternates(input.localeAlternates, primaryLocale);
+    if (altLocales.length > 0)
+        tags['og:locale:alternate'] = altLocales[altLocales.length - 1];
+    tags['og:type'] = input.type ?? 'website';
+    if (input.ogImage) {
+        tags['og:image'] = input.ogImage.url;
+        if (input.ogImage.width != null)
+            tags['og:image:width'] = String(input.ogImage.width);
+        if (input.ogImage.height != null)
+            tags['og:image:height'] = String(input.ogImage.height);
+        if (input.ogImage.alt)
+            tags['og:image:alt'] = input.ogImage.alt;
+    }
+    if (input.type === 'profile') {
+        if (input.profileFirstName)
+            tags['profile:first_name'] = input.profileFirstName;
+        if (input.profileLastName)
+            tags['profile:last_name'] = input.profileLastName;
+    }
+    if (input.type === 'article') {
+        if (input.publishedTime)
+            tags['article:published_time'] = input.publishedTime;
+        if (input.modifiedTime)
+            tags['article:modified_time'] = input.modifiedTime;
+        if (input.author)
+            tags['article:author'] = input.author;
+        if (input.section)
+            tags['article:section'] = input.section;
+        if (input.tags) {
+            for (const tag of input.tags) {
+                tags['article:tag'] = tag;
+            }
+        }
+    }
+    const hasImage = !!(twImage || input.ogImage);
+    tags['twitter:card'] = input.twitterCard ?? (hasImage ? 'summary_large_image' : 'summary');
+    tags['twitter:title'] = twTitle;
+    if (twDescription)
+        tags['twitter:description'] = twDescription;
+    if (twImage) {
+        tags['twitter:image'] = twImage;
+        const twAlt = input.twitterImageAlt ?? input.ogImage?.alt;
+        if (twAlt)
+            tags['twitter:image:alt'] = twAlt;
+    }
+    if (input.twitterSite)
+        tags['twitter:site'] = input.twitterSite;
+    const robotsParts = [];
+    if (input.noIndex)
+        robotsParts.push('noindex');
+    if (input.noFollow)
+        robotsParts.push('nofollow');
+    if (robotsParts.length > 0)
+        tags['robots'] = robotsParts.join(', ');
+    return tags;
+}
+const OG_PROPERTY_PREFIXES = ['og:', 'article:', 'profile:'];
+function isPropertyTag(key) {
+    return OG_PROPERTY_PREFIXES.some((prefix) => key.startsWith(prefix));
+}
+export function renderMetaTagsHtml(input) {
+    const tags = generateMetaTags(input);
+    const lines = [];
+    if (input.canonical) {
+        lines.push(`<link rel="canonical" href="${escapeHtml(input.canonical)}" />`);
+    }
+    // Pagination rel=prev/next (still consumed by Bing; harmless for Google).
+    if (input.prev)
+        lines.push(`<link rel="prev" href="${escapeHtml(input.prev)}" />`);
+    if (input.next)
+        lines.push(`<link rel="next" href="${escapeHtml(input.next)}" />`);
+    for (const alt of input.alternates ?? []) {
+        lines.push(`<link rel="alternate" hreflang="${escapeHtml(alt.hreflang)}" href="${escapeHtml(alt.href)}" />`);
+    }
+    for (const [key, value] of Object.entries(tags)) {
+        const escaped = escapeHtml(value);
+        if (isPropertyTag(key)) {
+            lines.push(`<meta property="${key}" content="${escaped}" />`);
+        }
+        else {
+            lines.push(`<meta name="${key}" content="${escaped}" />`);
+        }
+    }
+    // article:tag can have multiple values — generateMetaTags only stores the last one.
+    // Re-emit all tags for the article:tag case.
+    if (input.type === 'article' && input.tags && input.tags.length > 1) {
+        for (let i = 0; i < input.tags.length - 1; i++) {
+            lines.push(`<meta property="article:tag" content="${escapeHtml(input.tags[i])}" />`);
+        }
+    }
+    // og:locale:alternate is also multi-valued; the flat map only kept the last.
+    const primaryLocale = tags['og:locale'];
+    const altLocales = normalizeOgLocaleAlternates(input.localeAlternates, primaryLocale ?? '');
+    if (altLocales.length > 1) {
+        for (let i = 0; i < altLocales.length - 1; i++) {
+            lines.push(`<meta property="og:locale:alternate" content="${escapeHtml(altLocales[i])}" />`);
+        }
+    }
+    return lines.join('\n');
+}
+function cleanToken(v) {
+    return typeof v === 'string' && v.trim() !== '' ? v.trim() : undefined;
+}
+/** Standard provider → meta-tag-name mapping. */
+const VERIFICATION_TAG_NAMES = {
+    googleSearchConsole: 'google-site-verification',
+    bingWebmasterTools: 'msvalidate.01',
+    yandex: 'yandex-verification',
+    pinterest: 'p:domain_verify',
+    facebookDomain: 'facebook-domain-verification',
+};
+/**
+ * Build the flat list of verification `<meta>` entries from the configured
+ * tokens. Empty values are skipped. Custom tags require a `content` plus at
+ * least one of `name`/`property`.
+ */
+export function buildVerificationMetaEntries(tokens) {
+    if (!tokens)
+        return [];
+    const entries = [];
+    for (const [key, metaName] of Object.entries(VERIFICATION_TAG_NAMES)) {
+        const content = cleanToken(tokens[key]);
+        if (content)
+            entries.push({ name: metaName, content });
+    }
+    for (const tag of tokens.customMetaTags ?? []) {
+        const content = cleanToken(tag?.content);
+        const name = cleanToken(tag?.name);
+        const property = cleanToken(tag?.property);
+        if (!content || (!name && !property))
+            continue;
+        entries.push(property ? { property, content } : { name: name, content });
+    }
+    return entries;
+}
+/** Render verification entries as escaped `<meta>` HTML lines. */
+export function renderVerificationMetaHtml(tokens) {
+    return buildVerificationMetaEntries(tokens)
+        .map((e) => e.property
+        ? `<meta property="${escapeHtml(e.property)}" content="${escapeHtml(e.content)}" />`
+        : `<meta name="${escapeHtml(e.name)}" content="${escapeHtml(e.content)}" />`)
+        .join('\n');
+}
+/**
+ * Build the Next.js `metadata.verification` object. Google + Yandex map to
+ * first-class keys; everything else (Bing, Pinterest, Facebook, custom
+ * name-based tags) goes under `other`. Returns undefined when nothing is set.
+ */
+export function buildNextVerification(tokens) {
+    if (!tokens)
+        return undefined;
+    const out = {};
+    const other = {};
+    const google = cleanToken(tokens.googleSearchConsole);
+    if (google)
+        out.google = google;
+    const yandex = cleanToken(tokens.yandex);
+    if (yandex)
+        out.yandex = yandex;
+    const bing = cleanToken(tokens.bingWebmasterTools);
+    if (bing)
+        other['msvalidate.01'] = bing;
+    const pinterest = cleanToken(tokens.pinterest);
+    if (pinterest)
+        other['p:domain_verify'] = pinterest;
+    const facebook = cleanToken(tokens.facebookDomain);
+    if (facebook)
+        other['facebook-domain-verification'] = facebook;
+    for (const tag of tokens.customMetaTags ?? []) {
+        const content = cleanToken(tag?.content);
+        const name = cleanToken(tag?.name);
+        if (content && name)
+            other[name] = content;
+    }
+    if (Object.keys(other).length > 0)
+        out.other = other;
+    return out.google || out.yandex || out.other ? out : undefined;
+}
+export function generateNextMetadata(input) {
+    const ogTitle = input.ogTitle ?? input.title;
+    const ogDescription = input.ogDescription ?? input.description;
+    const twTitle = input.twitterTitle ?? ogTitle;
+    const twDescription = input.twitterDescription ?? ogDescription;
+    const twImage = input.twitterImage ?? input.ogImage?.url;
+    const hasImage = !!(twImage || input.ogImage);
+    const metadata = {
+        title: input.title,
+    };
+    if (input.description)
+        metadata.description = input.description;
+    if (input.metadataBase) {
+        try {
+            metadata.metadataBase = new URL(input.metadataBase);
+        }
+        catch {
+            // Ignore an unparseable base — Next.js falls back to the deploy origin.
+        }
+    }
+    const languages = {};
+    for (const alt of input.alternates ?? []) {
+        if (alt.hreflang && alt.href)
+            languages[alt.hreflang] = alt.href;
+    }
+    if (input.canonical || Object.keys(languages).length > 0) {
+        metadata.alternates = {
+            ...(input.canonical ? { canonical: input.canonical } : {}),
+            ...(Object.keys(languages).length > 0 ? { languages } : {}),
+        };
+    }
+    metadata.robots = {
+        index: !input.noIndex,
+        follow: !input.noFollow,
+    };
+    const ogLocale = normalizeOgLocale(input.locale) ?? 'en_US';
+    const openGraph = {
+        title: ogTitle,
+        url: input.url,
+        siteName: input.siteName,
+        locale: ogLocale,
+        type: input.type ?? 'website',
+    };
+    const altLocales = normalizeOgLocaleAlternates(input.localeAlternates, ogLocale);
+    if (altLocales.length > 0)
+        openGraph.alternateLocale = altLocales;
+    if (input.type === 'profile') {
+        if (input.profileFirstName)
+            openGraph.firstName = input.profileFirstName;
+        if (input.profileLastName)
+            openGraph.lastName = input.profileLastName;
+    }
+    if (ogDescription)
+        openGraph.description = ogDescription;
+    if (input.ogImage) {
+        openGraph.images = [
+            {
+                url: input.ogImage.url,
+                ...(input.ogImage.width != null && { width: input.ogImage.width }),
+                ...(input.ogImage.height != null && { height: input.ogImage.height }),
+                ...(input.ogImage.alt && { alt: input.ogImage.alt }),
+            },
+        ];
+    }
+    if (input.type === 'article') {
+        if (input.publishedTime)
+            openGraph.publishedTime = input.publishedTime;
+        if (input.modifiedTime)
+            openGraph.modifiedTime = input.modifiedTime;
+        if (input.author)
+            openGraph.authors = [input.author];
+        if (input.section)
+            openGraph.section = input.section;
+        if (input.tags)
+            openGraph.tags = input.tags;
+    }
+    metadata.openGraph = openGraph;
+    const twitter = {
+        card: input.twitterCard ?? (hasImage ? 'summary_large_image' : 'summary'),
+        title: twTitle,
+    };
+    if (twDescription)
+        twitter.description = twDescription;
+    if (twImage) {
+        const twAlt = input.twitterImageAlt ?? input.ogImage?.alt;
+        twitter.images = [twAlt ? { url: twImage, alt: twAlt } : twImage];
+    }
+    if (input.twitterSite)
+        twitter.site = input.twitterSite;
+    metadata.twitter = twitter;
+    return metadata;
+}
+//# sourceMappingURL=meta-tags.js.map

package/dist/seo/meta-tags.js.map

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

package/dist/seo/migrate-meta.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Backfill meta title and description on content documents.
+ *
+ * Pages may emit correct meta via title templates and key takeaways at render
+ * time without persisting `metaTitle` / `metaDescription` on `data`. Stamping
+ * the effective values keeps the Content SEO table and audit aligned with live
+ * output. Idempotent — safe to re-run.
+ */
+import type { ActionContext } from '../actions.js';
+export interface MigrateMetaOptions {
+    dryRun?: boolean;
+    batchSize?: number;
+    collections?: string[];
+}
+export interface MigrateMetaResult {
+    scanned: number;
+    migrated: number;
+    skipped: number;
+    migratedIds: string[];
+}
+/** Backfill metaTitle/metaDescription from effective render-time values. */
+export declare function migrateMetaFields(ctx: ActionContext, options?: MigrateMetaOptions): Promise<MigrateMetaResult>;
+//# sourceMappingURL=migrate-meta.d.ts.map

package/dist/seo/migrate-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-meta.d.ts","sourceRoot":"","sources":["../../src/seo/migrate-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAQlD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAoBD,4EAA4E;AAC5E,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAgH5B"}

package/dist/seo/migrate-meta.js

@@ -0,0 +1,114 @@
+import { updateDocumentSeoFields } from '../actions.js';
+import { getPrentaConfig } from '../config/runtime.js';
+import { applySeoOverrides, getSeoOverrides } from './config-store.js';
+import { frontEndContentCollectionTypes } from './audit-runner.js';
+import { isPublicContentCollection } from './schema-sync.js';
+import { resolveEffectiveMeta } from './page-meta.js';
+function isPlainObject(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function pickString(...candidates) {
+    for (const c of candidates) {
+        if (typeof c === 'string' && c.trim().length > 0)
+            return c.trim();
+    }
+    return undefined;
+}
+function needsMetaMigration(data) {
+    return (!pickString(data.metaTitle, data.seoTitle) ||
+        !pickString(data.metaDescription, data.seoDescription));
+}
+/** Backfill metaTitle/metaDescription from effective render-time values. */
+export async function migrateMetaFields(ctx, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const batchSize = options.batchSize && options.batchSize > 0 ? options.batchSize : 100;
+    const config = getPrentaConfig();
+    const defaultCollections = Object.keys(frontEndContentCollectionTypes(config));
+    const targetCollections = options.collections && options.collections.length > 0 ? options.collections : defaultCollections;
+    const result = {
+        scanned: 0,
+        migrated: 0,
+        skipped: 0,
+        migratedIds: [],
+    };
+    if (targetCollections.length === 0)
+        return result;
+    const overrides = await getSeoOverrides(ctx.db).catch(() => null);
+    const mergedConfig = applySeoOverrides(config, overrides);
+    const siteSeo = mergedConfig?.seo;
+    const siteUrl = siteSeo?.siteUrl?.replace(/\/+$/, '');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Prisma client is intentionally untyped at the core/config boundary.
+    const db = ctx.db;
+    let cursor;
+    for (;;) {
+        const batch = await db.document.findMany({
+            where: {
+                deletedAt: null,
+                status: 'PUBLISHED',
+                collection: { in: targetCollections },
+            },
+            orderBy: { id: 'asc' },
+            take: batchSize,
+            ...(cursor ? { skip: 1, cursor: { id: cursor } } : {}),
+            select: {
+                id: true,
+                collection: true,
+                title: true,
+                slug: true,
+                status: true,
+                data: true,
+                publishedAt: true,
+            },
+        });
+        if (batch.length === 0)
+            break;
+        cursor = batch[batch.length - 1].id;
+        for (const doc of batch) {
+            result.scanned++;
+            const data = isPlainObject(doc.data) ? doc.data : null;
+            if (!data) {
+                result.skipped++;
+                continue;
+            }
+            const collectionDef = mergedConfig?.collections?.[doc.collection] ?? null;
+            if (!isPublicContentCollection(collectionDef)) {
+                result.skipped++;
+                continue;
+            }
+            if (!needsMetaMigration(data)) {
+                result.skipped++;
+                continue;
+            }
+            const effective = resolveEffectiveMeta({
+                data,
+                docTitle: doc.title,
+                publishedAt: doc.publishedAt,
+                collection: collectionDef,
+                collectionSlug: doc.collection,
+                site: siteSeo,
+                siteUrl,
+            });
+            const patch = {};
+            if (!pickString(data.metaTitle, data.seoTitle)) {
+                if (effective.metaTitle)
+                    patch.metaTitle = effective.metaTitle;
+            }
+            if (!pickString(data.metaDescription, data.seoDescription) && effective.metaDescription) {
+                patch.metaDescription = effective.metaDescription;
+            }
+            if (Object.keys(patch).length === 0) {
+                result.skipped++;
+                continue;
+            }
+            if (!dryRun) {
+                await updateDocumentSeoFields(doc.collection, doc.id, patch, ctx);
+            }
+            result.migrated++;
+            result.migratedIds.push(doc.id);
+        }
+        if (batch.length < batchSize)
+            break;
+    }
+    return result;
+}
+//# sourceMappingURL=migrate-meta.js.map

package/dist/seo/migrate-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-meta.js","sourceRoot":"","sources":["../../src/seo/migrate-meta.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAerD,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,UAAU,CAAC,GAAG,UAA0B;IAC/C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;IACnE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAA6B;IACvD,OAAO,CACL,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC1C,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,CACvD,CAAA;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAkB,EAClB,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAA;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA;IACtF,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9E,MAAM,iBAAiB,GACrB,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAA;IAElG,MAAM,MAAM,GAAsB;QAChC,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,EAAE;KAChB,CAAA;IAED,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IAEjD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACjE,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG,YAAY,EAAE,GAAG,CAAA;IACjC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAErD,qIAAqI;IACrI,MAAM,EAAE,GAAG,GAAG,CAAC,EAAS,CAAA;IACxB,IAAI,MAA0B,CAAA;IAE9B,SAAS,CAAC;QACR,MAAM,KAAK,GAQN,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC9B,KAAK,EAAE;gBACL,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE;aACtC;YACD,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;YACtB,IAAI,EAAE,SAAS;YACf,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,MAAM,EAAE;gBACN,EAAE,EAAE,IAAI;gBACR,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,IAAI;aAClB;SACF,CAAC,CAAA;QAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAK;QAC7B,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE,CAAA;QAEpC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,EAAE,CAAA;YAChB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;YACtD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,CAAC,OAAO,EAAE,CAAA;gBAChB,SAAQ;YACV,CAAC;YAED,MAAM,aAAa,GAAG,YAAY,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAA;YACzE,IAAI,CAAC,yBAAyB,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,OAAO,EAAE,CAAA;gBAChB,SAAQ;YACV,CAAC;YAED,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,OAAO,EAAE,CAAA;gBAChB,SAAQ;YACV,CAAC;YAED,MAAM,SAAS,GAAG,oBAAoB,CAAC;gBACrC,IAAI;gBACJ,QAAQ,EAAE,GAAG,CAAC,KAAK;gBACnB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,UAAU,EAAE,aAAa;gBACzB,cAAc,EAAE,GAAG,CAAC,UAAU;gBAC9B,IAAI,EAAE,OAAO;gBACb,OAAO;aACR,CAAC,CAAA;YAEF,MAAM,KAAK,GAA2B,EAAE,CAAA;YACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/C,IAAI,SAAS,CAAC,SAAS;oBAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;YAChE,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;gBACxF,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAA;YACnD,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,OAAO,EAAE,CAAA;gBAChB,SAAQ;YACV,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,uBAAuB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;YACnE,CAAC;YAED,MAAM,CAAC,QAAQ,EAAE,CAAA;YACjB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACjC,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS;YAAE,MAAK;IACrC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/seo/migrate-schema.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Backfill structured-data fields on content documents.
+ *
+ * Legacy published pages often emit JSON-LD at render time but never persisted
+ * `structuredDataType` / `schemaType` on `data` or JSON-LD on `structuredData`.
+ * The SEO audit (pre-schema-sync) flagged those as missing even though the public
+ * site was fine. This migration stamps the effective types and, for published
+ * documents, materializes JSON-LD through the same `updateDocument` path as a
+ * normal save. Idempotent — safe to re-run.
+ */
+import type { ActionContext } from '../actions.js';
+export interface MigrateStructuredDataOptions {
+    dryRun?: boolean;
+    batchSize?: number;
+    /** Restrict to these collection slugs (defaults to front-end content collections). */
+    collections?: string[];
+}
+export interface MigrateStructuredDataResult {
+    scanned: number;
+    migrated: number;
+    skipped: number;
+    migratedIds: string[];
+}
+/**
+ * Backfill schema type fields (and published JSON-LD) for content documents.
+ */
+export declare function migrateStructuredDataFields(ctx: ActionContext, options?: MigrateStructuredDataOptions): Promise<MigrateStructuredDataResult>;
+//# sourceMappingURL=migrate-schema.d.ts.map

package/dist/seo/migrate-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-schema.d.ts","sourceRoot":"","sources":["../../src/seo/migrate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAMlD,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AA4BD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CAmHtC"}