@canvas-digital/blog-sdk 2.0.0

package/dist/lib/revalidate.js

@@ -0,0 +1,91 @@
+import { revalidatePath, revalidateTag } from 'next/cache';
+/**
+ * Cache tags.
+ *
+ * Publishing invalidates a small, explicit set of tags rather than the whole
+ * site — the post itself, the indexes it appears in, and the sitemap. Everything
+ * else stays warm at the edge, which is what keeps a publish from causing a
+ * traffic spike against the origin.
+ */
+export const tags = {
+    tenant: (tenantSlug) => `tenant:${tenantSlug}`,
+    post: (tenantSlug, postSlug) => `post:${tenantSlug}:${postSlug}`,
+    postIndex: (tenantSlug) => `post-index:${tenantSlug}`,
+    category: (tenantSlug, categorySlug) => `category:${tenantSlug}:${categorySlug}`,
+    sitemap: (tenantSlug) => `sitemap:${tenantSlug}`,
+    redirects: (tenantSlug) => `redirects:${tenantSlug}`,
+};
+/** Tags touched when a single post changes state. */
+export const tagsForPost = (args) => {
+    const { tenantSlug, postSlug, categorySlugs = [] } = args;
+    return [
+        tags.post(tenantSlug, postSlug),
+        tags.postIndex(tenantSlug),
+        tags.sitemap(tenantSlug),
+        ...categorySlugs.map((c) => tags.category(tenantSlug, c)),
+    ];
+};
+export const revalidateTags = (list) => {
+    for (const tag of new Set(list)) {
+        try {
+            revalidateTag(tag);
+        }
+        catch {
+            // revalidateTag throws outside a request/render scope (e.g. during seed).
+            // A miss here is a stale cache entry, never a data problem, so it is safe
+            // to swallow — but we surface it in development.
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn(`[revalidate] could not invalidate "${tag}" outside request scope`);
+            }
+        }
+    }
+};
+const revalidateSitePaths = () => {
+    for (const path of ['/', '/blog']) {
+        try {
+            revalidatePath(path, 'layout');
+        }
+        catch {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn(`[revalidate] could not invalidate path "${path}" outside request scope`);
+            }
+        }
+    }
+};
+/** When CMS and renderer are separate deployments, bust the public cache too. */
+const notifyRenderer = async (args) => {
+    const secret = process.env.REVALIDATE_SECRET;
+    const renderer = process.env.RENDERER_ORIGIN?.trim().replace(/\/$/, '');
+    const self = process.env.NEXT_PUBLIC_SERVER_URL?.trim().replace(/\/$/, '');
+    if (!secret || !renderer || (self && renderer === self))
+        return;
+    try {
+        await fetch(`${renderer}/api/revalidate`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${secret}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(args),
+        });
+    }
+    catch {
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn('[revalidate] could not reach renderer origin');
+        }
+    }
+};
+/** Invalidate every public cache entry a post publish/update touches. */
+export const purgePublicCaches = async (args) => {
+    const tagList = args.postSlug
+        ? tagsForPost({
+            tenantSlug: args.tenantSlug,
+            postSlug: args.postSlug,
+            categorySlugs: args.categorySlugs,
+        })
+        : [tags.postIndex(args.tenantSlug), tags.tenant(args.tenantSlug), tags.sitemap(args.tenantSlug)];
+    // Shared-host "all brands" index uses these tags too.
+    revalidateTags([...tagList, tags.postIndex('all'), 'tenant:all']);
+    revalidateSitePaths();
+    await notifyRenderer(args);
+};

package/dist/lib/robots.d.ts

@@ -0,0 +1,19 @@
+import type { Tenant } from '../payload-types';
+export declare const DEFAULT_ROBOTS_ALLOW: string[];
+export declare const DEFAULT_ROBOTS_DISALLOW: string[];
+export declare const pathsFromRows: (rows: {
+    path?: string | null;
+}[] | null | undefined, fallback: string[]) => string[];
+export type RobotsConfig = {
+    allowPaths: string[];
+    disallowPaths: string[];
+    includeSitemap: boolean;
+    extraRules: string;
+};
+export declare const resolveRobotsConfig: (tenant?: Pick<Tenant, "robots"> | null) => RobotsConfig;
+/** Build the production robots.txt body for a brand. */
+export declare const buildRobotsTxt: (args: {
+    config: RobotsConfig;
+    sitemapUrl?: string | null;
+}) => string;
+//# sourceMappingURL=robots.d.ts.map

package/dist/lib/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../app/lib/robots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,eAAO,MAAM,oBAAoB,UAAY,CAAA;AAC7C,eAAO,MAAM,uBAAuB,UAA8B,CAAA;AAQlE,eAAO,MAAM,aAAa,GACxB,MAAM;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,IAAI,GAAG,SAAS,EACnD,UAAU,MAAM,EAAE,KACjB,MAAM,EAKR,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,SAAS,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,KACrC,YAKD,CAAA;AAEF,wDAAwD;AACxD,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,KAAG,MAkBH,CAAA"}

package/dist/lib/robots.js

@@ -0,0 +1,38 @@
+export const DEFAULT_ROBOTS_ALLOW = ['/blog'];
+export const DEFAULT_ROBOTS_DISALLOW = ['/admin', '/cms', '/api/'];
+const normaliseRobotPath = (raw) => {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return '';
+    return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+};
+export const pathsFromRows = (rows, fallback) => {
+    const parsed = (rows ?? [])
+        .map((r) => normaliseRobotPath(String(r?.path ?? '')))
+        .filter(Boolean);
+    return parsed.length ? [...new Set(parsed)] : fallback;
+};
+export const resolveRobotsConfig = (tenant) => ({
+    allowPaths: pathsFromRows(tenant?.robots?.allowPaths, DEFAULT_ROBOTS_ALLOW),
+    disallowPaths: pathsFromRows(tenant?.robots?.disallowPaths, DEFAULT_ROBOTS_DISALLOW),
+    includeSitemap: tenant?.robots?.includeSitemap !== false,
+    extraRules: (tenant?.robots?.extraRules ?? '').trim(),
+});
+/** Build the production robots.txt body for a brand. */
+export const buildRobotsTxt = (args) => {
+    const lines = ['User-agent: *'];
+    for (const path of args.config.allowPaths)
+        lines.push(`Allow: ${path}`);
+    for (const path of args.config.disallowPaths)
+        lines.push(`Disallow: ${path}`);
+    if (args.config.extraRules) {
+        lines.push('');
+        lines.push(...args.config.extraRules.split(/\r?\n/).map((l) => l.trimEnd()).filter(Boolean));
+    }
+    if (args.config.includeSitemap && args.sitemapUrl) {
+        lines.push('');
+        lines.push(`Sitemap: ${args.sitemapUrl}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+};

package/dist/lib/seo-analysis.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lightweight Yoast-style SEO + readability checks for the post editor.
+ * Runs fully client-side from the draft the editor already holds.
+ */
+export type CheckTone = 'good' | 'ok' | 'bad';
+export type AnalysisCheck = {
+    id: string;
+    label: string;
+    detail: string;
+    tone: CheckTone;
+};
+export type SeoAnalysisInput = {
+    title: string;
+    slug: string;
+    excerpt: string;
+    metaTitle: string;
+    metaDescription: string;
+    focusKeyphrase: string;
+    contentText: string;
+    contentHtml: string;
+    hasFeaturedImage: boolean;
+    featuredAlt: string;
+};
+export declare const analyseSeo: (input: SeoAnalysisInput) => AnalysisCheck[];
+export declare const analyseReadability: (input: Pick<SeoAnalysisInput, "contentText" | "contentHtml">) => AnalysisCheck[];
+export declare const summariseTone: (checks: AnalysisCheck[]) => CheckTone;
+export declare const toneLabel: (tone: CheckTone) => string;
+//# sourceMappingURL=seo-analysis.d.ts.map

package/dist/lib/seo-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-analysis.d.ts","sourceRoot":"","sources":["../../app/lib/seo-analysis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAiCD,eAAO,MAAM,UAAU,GAAI,OAAO,gBAAgB,KAAG,aAAa,EA+JjE,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,OAAO,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,aAAa,CAAC,KAAG,aAAa,EA2E9G,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,QAAQ,aAAa,EAAE,KAAG,SAIvD,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,SAAS,KAAG,MACoB,CAAA"}

package/dist/lib/seo-analysis.js

@@ -0,0 +1,153 @@
+/**
+ * Lightweight Yoast-style SEO + readability checks for the post editor.
+ * Runs fully client-side from the draft the editor already holds.
+ */
+const wordsOf = (text) => text
+    .toLowerCase()
+    .replace(/[^a-z0-9\s'-]/g, ' ')
+    .split(/\s+/)
+    .filter(Boolean);
+const sentencesOf = (text) => text
+    .split(/[.!?]+/)
+    .map((s) => s.trim())
+    .filter((s) => s.length > 0);
+const countKeyphrase = (haystack, phrase) => {
+    if (!phrase.trim())
+        return 0;
+    const h = haystack.toLowerCase();
+    const p = phrase.toLowerCase().trim();
+    let n = 0;
+    let i = 0;
+    while ((i = h.indexOf(p, i)) !== -1) {
+        n += 1;
+        i += p.length;
+    }
+    return n;
+};
+const TRANSITIONS = /\b(however|therefore|moreover|furthermore|additionally|meanwhile|consequently|instead|similarly|likewise|for example|for instance|in addition|on the other hand|as a result|in conclusion|finally|next|then|also|because|although|while|whereas)\b/gi;
+const PASSIVE = /\b(is|are|was|were|be|been|being)\s+\w+ed\b/gi;
+export const analyseSeo = (input) => {
+    const phrase = input.focusKeyphrase.trim();
+    const seoTitle = (input.metaTitle || input.title).trim();
+    const meta = (input.metaDescription || input.excerpt).trim();
+    const body = input.contentText.trim();
+    const words = wordsOf(body);
+    const intro = body.slice(0, 300);
+    const slug = input.slug.toLowerCase();
+    const checks = [];
+    const push = (id, label, detail, tone) => checks.push({ id, label, detail, tone });
+    if (!phrase) {
+        push('keyphrase', 'Focus keyphrase', 'No focus keyphrase was set for this page.', 'bad');
+    }
+    else {
+        const inTitle = seoTitle.toLowerCase().includes(phrase.toLowerCase());
+        push('keyphrase-title', 'Keyphrase in SEO title', inTitle ? 'The focus keyphrase appears in the SEO title.' : 'Include the focus keyphrase in the SEO title.', inTitle ? 'good' : 'bad');
+        const inMeta = meta.toLowerCase().includes(phrase.toLowerCase());
+        push('keyphrase-meta', 'Keyphrase in meta description', inMeta ? 'Keyphrase appears in the meta description.' : 'Add the keyphrase to the meta description.', inMeta ? 'good' : 'bad');
+        const inSlug = slug.includes(phrase.toLowerCase().replace(/\s+/g, '-'));
+        push('keyphrase-slug', 'Keyphrase in slug', inSlug ? 'Great work — the slug reflects the keyphrase.' : 'Include the keyphrase in the permalink slug.', inSlug ? 'good' : 'ok');
+        const inIntro = intro.toLowerCase().includes(phrase.toLowerCase());
+        push('keyphrase-intro', 'Keyphrase in introduction', inIntro
+            ? 'The keyphrase appears early in the content.'
+            : 'Use the focus keyphrase (or a close synonym) in the first paragraph.', inIntro ? 'good' : 'bad');
+        const density = words.length ? (countKeyphrase(body, phrase) / words.length) * 100 : 0;
+        const densityOk = density >= 0.5 && density <= 3;
+        push('keyphrase-density', 'Keyphrase density', words.length
+            ? `Found about ${density.toFixed(1)}% density across ${words.length} words.`
+            : 'Write some body content to measure keyphrase density.', !words.length ? 'ok' : densityOk ? 'good' : 'ok');
+        const phraseWords = phrase.split(/\s+/).filter(Boolean).length;
+        push('keyphrase-length', 'Keyphrase length', phraseWords > 4
+            ? 'Your keyphrase is longer than the recommended maximum length.'
+            : phraseWords < 2
+                ? 'Your keyphrase is very short. Consider using a longer phrase.'
+                : 'Your keyphrase has a good length.', phraseWords > 4 ? 'bad' : phraseWords < 2 ? 'ok' : 'good');
+    }
+    const titleLen = seoTitle.length;
+    push('seo-title-length', 'SEO title width', titleLen === 0
+        ? 'Add an SEO title (or a post title).'
+        : titleLen < 30
+            ? `Title is short (${titleLen} chars). Aim for 30–60.`
+            : titleLen > 60
+                ? `Title may truncate in Google (${titleLen} chars). Aim for ≤60.`
+                : `Title length looks good (${titleLen} characters).`, titleLen === 0 ? 'bad' : titleLen < 30 || titleLen > 60 ? 'ok' : 'good');
+    const metaLen = meta.length;
+    push('meta-length', 'Meta description length', metaLen === 0
+        ? 'Add a meta description (or an excerpt).'
+        : metaLen < 120
+            ? `Description is short (${metaLen} chars). Aim for 120–156.`
+            : metaLen > 156
+                ? `Description is over 156 characters (${metaLen}). Shorten it for full SERP visibility.`
+                : `Description length looks good (${metaLen} characters).`, metaLen === 0 ? 'bad' : metaLen < 120 || metaLen > 156 ? 'ok' : 'good');
+    const hasImg = input.hasFeaturedImage || /<img[\s>]/i.test(input.contentHtml);
+    push('images', 'Images', hasImg ? 'At least one image is present.' : 'Add a featured image or inline images.', hasImg ? 'good' : 'bad');
+    if (phrase && input.hasFeaturedImage) {
+        const altHas = input.featuredAlt.toLowerCase().includes(phrase.toLowerCase());
+        push('alt-keyphrase', 'Keyphrase in image alt attributes', altHas
+            ? 'Featured image alt includes the keyphrase.'
+            : 'Include the focus keyphrase in the featured image alt text.', altHas ? 'good' : 'ok');
+    }
+    const h2count = (input.contentHtml.match(/<h[23]\b/gi) || []).length;
+    push('subheadings', 'Keyphrase in subheading', h2count > 0
+        ? `Found ${h2count} H2/H3 subheading(s).`
+        : 'Add H2/H3 subheadings to structure the article.', h2count > 0 ? 'good' : 'ok');
+    push('text-length', 'Text length', words.length === 0
+        ? 'No body text yet.'
+        : words.length < 300
+            ? `Only ${words.length} words — aim for at least 300 for a solid article.`
+            : `The text contains ${words.length} words.`, words.length === 0 ? 'bad' : words.length < 300 ? 'ok' : 'good');
+    const internal = (input.contentHtml.match(/data-link-type="internal"|href="\/blog/gi) || []).length;
+    const outbound = (input.contentHtml.match(/href="https?:\/\//gi) || []).length;
+    push('internal-links', 'Internal links', internal > 0 ? `Found ${internal} internal link(s).` : 'Add internal links to related posts or categories.', internal > 0 ? 'good' : 'ok');
+    push('outbound-links', 'Outbound links', outbound > 0 ? `Found ${outbound} outbound link(s).` : 'Consider adding a relevant outbound link.', outbound > 0 ? 'good' : 'ok');
+    return checks;
+};
+export const analyseReadability = (input) => {
+    const body = input.contentText.trim();
+    const sentences = sentencesOf(body);
+    const words = wordsOf(body);
+    const checks = [];
+    const push = (id, label, detail, tone) => checks.push({ id, label, detail, tone });
+    if (!sentences.length) {
+        push('empty', 'Readability', 'Write some content to analyse readability.', 'ok');
+        return checks;
+    }
+    const longSentences = sentences.filter((s) => wordsOf(s).length > 20).length;
+    const longPct = (longSentences / sentences.length) * 100;
+    push('sentence-length', 'Sentence length', longPct <= 25
+        ? 'Great — most sentences are a comfortable length.'
+        : `${Math.round(longPct)}% of sentences are over 20 words. Shorten some of them.`, longPct <= 25 ? 'good' : 'bad');
+    const passiveHits = (body.match(PASSIVE) || []).length;
+    const passivePct = sentences.length ? (passiveHits / sentences.length) * 100 : 0;
+    push('passive-voice', 'Passive voice', passivePct <= 10
+        ? "You are not using too much passive voice. That's great!"
+        : `${Math.round(passivePct)}% of sentences look passive. Prefer active voice.`, passivePct <= 10 ? 'good' : 'ok');
+    const withTransition = sentences.filter((s) => TRANSITIONS.test(s)).length;
+    TRANSITIONS.lastIndex = 0;
+    const transitionPct = (withTransition / sentences.length) * 100;
+    push('transition-words', 'Transition words', transitionPct >= 30
+        ? 'Enough sentences use transition words.'
+        : `Only ${Math.round(transitionPct)}% of sentences contain transition words, which is not enough. Use more of them.`, transitionPct >= 30 ? 'good' : 'bad');
+    const paras = input.contentHtml
+        .split(/<\/p>/i)
+        .map((p) => p.replace(/<[^>]+>/g, ' ').trim())
+        .filter(Boolean);
+    const longParas = paras.filter((p) => wordsOf(p).length > 150).length;
+    push('paragraph-length', 'Paragraph length', longParas === 0
+        ? 'There are no paragraphs that are too long. Great job!'
+        : `${longParas} paragraph(s) are very long. Break them up.`, longParas === 0 ? 'good' : 'ok');
+    const headings = (input.contentHtml.match(/<h[2-4]\b/gi) || []).length;
+    push('subheading-distribution', 'Subheading distribution', words.length < 300
+        ? 'Short posts need fewer subheadings.'
+        : headings > 0
+            ? 'Great job!'
+            : 'Add subheadings to break up longer sections.', words.length < 300 || headings > 0 ? 'good' : 'ok');
+    return checks;
+};
+export const summariseTone = (checks) => {
+    if (checks.some((c) => c.tone === 'bad'))
+        return 'bad';
+    if (checks.some((c) => c.tone === 'ok'))
+        return 'ok';
+    return 'good';
+};
+export const toneLabel = (tone) => tone === 'good' ? 'Good' : tone === 'ok' ? 'OK' : 'Needs work';

package/dist/lib/seo-limits.d.ts

@@ -0,0 +1,19 @@
+/** Payload field caps for the shared SEO group — keep the editor in sync with these. */
+export declare const SEO_FIELD_LIMITS: {
+    readonly metaTitle: 70;
+    readonly metaDescription: 180;
+    readonly ogTitle: 70;
+    readonly ogDescription: 200;
+};
+export type SeoLengthInput = {
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    ogTitle?: string | null;
+    ogDescription?: string | null;
+};
+export type SeoFieldError = {
+    field: string;
+    message: string;
+};
+export declare const seoFieldLengthErrors: (seo: SeoLengthInput | null | undefined) => SeoFieldError[];
+//# sourceMappingURL=seo-limits.d.ts.map

package/dist/lib/seo-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-limits.d.ts","sourceRoot":"","sources":["../../app/lib/seo-limits.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,eAAO,MAAM,oBAAoB,GAAI,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,KAAG,aAAa,EAiC1F,CAAA"}

package/dist/lib/seo-limits.js

@@ -0,0 +1,39 @@
+/** Payload field caps for the shared SEO group — keep the editor in sync with these. */
+export const SEO_FIELD_LIMITS = {
+    metaTitle: 70,
+    metaDescription: 180,
+    ogTitle: 70,
+    ogDescription: 200,
+};
+export const seoFieldLengthErrors = (seo) => {
+    const errors = [];
+    const metaTitle = (seo?.metaTitle ?? '').trim();
+    const metaDescription = (seo?.metaDescription ?? '').trim();
+    const ogTitle = (seo?.ogTitle ?? '').trim();
+    const ogDescription = (seo?.ogDescription ?? '').trim();
+    if (metaTitle.length > SEO_FIELD_LIMITS.metaTitle) {
+        errors.push({
+            field: 'seo.metaTitle',
+            message: `SEO title must be ${SEO_FIELD_LIMITS.metaTitle} characters or fewer (currently ${metaTitle.length}).`,
+        });
+    }
+    if (metaDescription.length > SEO_FIELD_LIMITS.metaDescription) {
+        errors.push({
+            field: 'seo.metaDescription',
+            message: `Meta description must be ${SEO_FIELD_LIMITS.metaDescription} characters or fewer (currently ${metaDescription.length}).`,
+        });
+    }
+    if (ogTitle.length > SEO_FIELD_LIMITS.ogTitle) {
+        errors.push({
+            field: 'seo.ogTitle',
+            message: `Social title must be ${SEO_FIELD_LIMITS.ogTitle} characters or fewer (currently ${ogTitle.length}).`,
+        });
+    }
+    if (ogDescription.length > SEO_FIELD_LIMITS.ogDescription) {
+        errors.push({
+            field: 'seo.ogDescription',
+            message: `Social description must be ${SEO_FIELD_LIMITS.ogDescription} characters or fewer (currently ${ogDescription.length}).`,
+        });
+    }
+    return errors;
+};

package/dist/lib/seo.d.ts

@@ -0,0 +1,50 @@
+import type { Metadata } from 'next';
+import type { Media, Post, Tenant } from '../payload-types';
+/**
+ * The SEO layer.
+ *
+ * Canonicals and structured data are *generated* from stored fields, never
+ * authored. An editor cannot produce a canonical that disagrees with the page it
+ * sits on, and JSON-LD cannot drift from the content it describes, because
+ * neither is a field anyone can type into.
+ */
+type Rel<T> = T | string | number | null | undefined;
+export declare const mediaUrl: (m: Rel<Media>, size?: "thumbnail" | "card" | "hero" | "og") => string | null;
+export declare const mediaDimensions: (m: Rel<Media>, size?: "thumbnail" | "card" | "hero" | "og") => {
+    width: number;
+    height: number;
+} | null;
+export declare const postMetadata: (args: {
+    tenant: Tenant;
+    post: Post;
+    origin: string;
+    path?: string;
+}) => Metadata;
+export declare const listingMetadata: (args: {
+    tenant: Tenant;
+    origin: string;
+    title: string;
+    description?: string | null;
+    path: string;
+    noindex?: boolean;
+    page?: number;
+}) => Metadata;
+/**
+ * A single @graph containing Article, BreadcrumbList, Person and Organization.
+ * One script tag, cross-referenced by @id, is what Google prefers over several
+ * disconnected blocks.
+ */
+export declare const articleJsonLd: (args: {
+    tenant: Tenant;
+    post: Post;
+    origin: string;
+}) => Record<string, unknown>;
+export declare const blogJsonLd: (args: {
+    tenant: Tenant;
+    origin: string;
+    posts: Post[];
+}) => Record<string, unknown>;
+/** JSON-LD is serialised with `<` escaped so it can never break out of the script tag. */
+export declare const jsonLdScript: (data: Record<string, unknown>) => string;
+export {};
+//# sourceMappingURL=seo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../app/lib/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,KAAK,EAAoB,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAM7E;;;;;;;GAOG;AAEH,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAIpD,eAAO,MAAM,QAAQ,GACnB,GAAG,GAAG,CAAC,KAAK,CAAC,EACb,OAAO,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,KAC1C,MAAM,GAAG,IAOX,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,GAAG,GAAG,CAAC,KAAK,CAAC,EACb,OAAO,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,KAC1C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAQtC,CAAA;AAkCD,eAAO,MAAM,YAAY,GAAI,MAAM;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,KAAG,QAmDH,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,KAAG,QAkBH,CAAA;AAiCD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA6DzB,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,IAAI,EAAE,CAAA;CACd,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAsBzB,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MACd,CAAA"}