@prenta/core 0.118.0

package/dist/seo/schema-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-sync.js","sourceRoot":"","sources":["../../src/seo/schema-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAElE,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,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,IAAI,CAAA;AAChG,CAAC;AAED,6DAA6D;AAC7D,SAAS,4BAA4B,CACnC,UAA0C;IAE1C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IAClC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IAErE,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAE3C,wEAAwE;IACxE,wEAAwE;IACxE,0EAA0E;IAC1E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC;QACnB,SAAS;QACT,cAAc;QACd,gBAAgB;QAChB,aAAa;QACb,QAAQ;QACR,SAAS;KACV,CAAC,CAAA;IACF,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;QAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACzB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACrC,6DAA6D;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;QAC3B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACxC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IACvE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA6B;IACzD,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,YAAY,CAAA;IAClD,OAAO,QAAQ,CAAC,EAAE,CAAC,IAAI,SAAS,CAAA;AAClC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,yBAAyB,CACvC,aAAsD;IAEtD,OAAO,aAAa,EAAE,IAAI,KAAK,MAAM,IAAI,aAAa,EAAE,IAAI,KAAK,MAAM,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAK1C;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAC9B,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAC/C,MAAM,UAAU,GAAG,4BAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAA;IAChF,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IAEjC,OAAO,CACL,UAAU,CACR,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,UAAU,EACf,YAAY,EAAE,UAAU,EACxB,YAAY,EAAE,kBAAkB,EAChC,MAAM,CAAC,aAAa,EAAE,GAAG,EAAE,iBAAiB,CAC7C,IAAI,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CACzC,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,MAA+B;IAClE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IACrE,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IACxB,OAAO,EAAE,GAAG,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;AAClE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,+BAA+B,CAC7C,UAAkB,EAClB,IAA6B,EAC7B,aAA2C,EAC3C,cAA+C;IAE/C,MAAM,SAAS,GAAG,0BAA0B,CAAC;QAC3C,UAAU;QACV,IAAI;QACJ,cAAc;QACd,aAAa;KACd,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;IACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAAE,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAA;IAC7E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;IAC7D,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAW/C;IACC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAA;IAC7E,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAE1D,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,GAAG,EAAE;YACH,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;YACrB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;YACrB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW;YACnC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS;YAC/B,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,YAAY,IAAI,IAAI;SACnC;QACD,UAAU,EAAE,aAAa;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAA;AAChC,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAkB,EAClB,IAA6B,EAC7B,UAWI,EAAE;IAEN,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAsB,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IAClF,IAAI,CAAC,yBAAyB,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,CAAA;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,+BAA+B,CAC9C,UAAU,EACV,IAAI,EACJ,aAAa,EACb,sBAAsB,CACvB,CAAA;IAED,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IAC3B,CAAC;IAED,MAAM,cAAc,GAAG,+BAA+B,CAAC;QACrD,UAAU;QACV,GAAG,EAAE;YACH,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,cAAc,EAAE,sBAAsB;SACvC;QACD,MAAM,EAAE,MAAM,IAAI,IAAI;KACvB,CAAC,CAAA;IAEF,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AACjF,CAAC"}

package/dist/seo/score.d.ts

@@ -0,0 +1,132 @@
+/**
+ * SEO scoring model.
+ *
+ * Pure, dependency-light functions that turn a page/post's metadata + content
+ * into an explainable 0-100 score, and aggregate per-category signals into a
+ * site-wide score. Nothing here is persisted directly — the audit engine
+ * (Phase 2) calls these and snapshots the results into `SeoAuditRun` /
+ * `SeoIssue` rows, while the Content SEO table recomputes page scores on read.
+ *
+ * The score is intentionally NOT a mystery number: every result carries a
+ * `checks` array describing exactly which points were earned/lost and why, so
+ * the admin UI can show editors what to fix. The unit tests in
+ * `__tests__/seo/score.test.ts` are the source of truth for the weights.
+ */
+export type SeoGrade = 'good' | 'fair' | 'poor' | 'critical';
+export type SeoCheckStatus = 'pass' | 'warn' | 'fail';
+/** One explainable line item in a page score. */
+export interface SeoScoreCheck {
+    id: string;
+    label: string;
+    /** Points earned (0..max). */
+    points: number;
+    /** Maximum points this check contributes. */
+    max: number;
+    status: SeoCheckStatus;
+    message: string;
+}
+export interface PageSeoScoreResult {
+    score: number;
+    grade: SeoGrade;
+    checks: SeoScoreCheck[];
+}
+/** The metadata + content subset a page score depends on. */
+export interface PageSeoScoreInput {
+    title?: string | null;
+    slug?: string | null;
+    url?: string | null;
+    /** Raw HTML or plain content body, used for H1 + length checks. */
+    content?: string | null;
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    focusKeyword?: string | null;
+    canonicalUrl?: string | null;
+    ogTitle?: string | null;
+    ogDescription?: string | null;
+    ogImage?: string | null;
+    structuredDataType?: string | null;
+    noindex?: boolean | null;
+    /** True when this content is intended to be public/indexable. */
+    shouldBeIndexable?: boolean;
+    /** Number of internal links that failed validation, when known. */
+    brokenInternalLinks?: number;
+    /** Pre-computed word count; falls back to counting `content`. */
+    wordCount?: number | null;
+}
+/** Page score weights. Must sum to 100. */
+export declare const PAGE_SEO_WEIGHTS: {
+    readonly metaTitlePresent: 10;
+    readonly metaTitleLength: 5;
+    readonly metaDescPresent: 10;
+    readonly metaDescLength: 5;
+    readonly focusKeyword: 8;
+    readonly canonical: 7;
+    readonly h1: 10;
+    readonly contentLength: 10;
+    readonly ogImage: 8;
+    readonly ogTitleDesc: 5;
+    readonly structuredData: 7;
+    readonly internalLinks: 5;
+    readonly indexable: 10;
+};
+/** Site score category weights (spec). Must sum to 100. */
+export declare const SITE_SEO_WEIGHTS: {
+    readonly content: 30;
+    readonly technical: 25;
+    readonly linkRedirect: 20;
+    readonly structuredSocial: 15;
+    readonly performance: 10;
+};
+/** Map a 0-100 score to a grade. Aligns with the Content SEO table colours. */
+export declare function gradeForSeoScore(score: number): SeoGrade;
+/**
+ * Count H1 headings in content that may be HTML or Markdown (case-insensitive
+ * for HTML tags, ATX `#`/Setext `===` for Markdown), so markdown-bodied posts
+ * aren't penalised for a "missing" H1 that is actually present.
+ */
+export declare function countH1(html: string): number;
+/**
+ * Compute a page/post SEO score (0-100) with an explainable breakdown.
+ *
+ * Points are additive per {@link PAGE_SEO_WEIGHTS}; "warn" checks earn partial
+ * credit. The total is clamped to 0-100 and rounded.
+ */
+export declare function calculatePageSeoScore(input: PageSeoScoreInput): PageSeoScoreResult;
+export interface SiteScoreCategory {
+    /** 0-100 sub-score for this category. */
+    score: number;
+    weight: number;
+}
+export interface SiteSeoScoreInput {
+    /** 0-100 — metadata completeness/uniqueness across content. */
+    content: number;
+    /** 0-100 — crawl/index health (sitemap, robots, canonicals, noindex). */
+    technical: number;
+    /** 0-100 — internal link + redirect health. */
+    linkRedirect: number;
+    /** 0-100 — structured data + social metadata coverage. */
+    structuredSocial: number;
+    /** 0-100 — performance + search signals (defaults neutral when unknown). */
+    performance?: number;
+}
+export interface SiteSeoScoreBreakdownItem {
+    category: keyof typeof SITE_SEO_WEIGHTS;
+    score: number;
+    weight: number;
+    /** Weighted contribution to the final score. */
+    contribution: number;
+}
+export interface SiteSeoScoreResult {
+    score: number;
+    grade: SeoGrade;
+    breakdown: SiteSeoScoreBreakdownItem[];
+}
+/**
+ * Combine per-category sub-scores into a weighted 0-100 site score.
+ *
+ * Performance defaults to 70 (neutral) when not supplied, so sites without a
+ * connected performance source aren't unfairly penalised — the weight is still
+ * applied so connecting Search Console can only improve the signal's accuracy.
+ */
+export declare function calculateSiteSeoScore(input: SiteSeoScoreInput): SiteSeoScoreResult;
+//# sourceMappingURL=score.d.ts.map

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

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

package/dist/seo/score.js

@@ -0,0 +1,216 @@
+/**
+ * SEO scoring model.
+ *
+ * Pure, dependency-light functions that turn a page/post's metadata + content
+ * into an explainable 0-100 score, and aggregate per-category signals into a
+ * site-wide score. Nothing here is persisted directly — the audit engine
+ * (Phase 2) calls these and snapshots the results into `SeoAuditRun` /
+ * `SeoIssue` rows, while the Content SEO table recomputes page scores on read.
+ *
+ * The score is intentionally NOT a mystery number: every result carries a
+ * `checks` array describing exactly which points were earned/lost and why, so
+ * the admin UI can show editors what to fix. The unit tests in
+ * `__tests__/seo/score.test.ts` are the source of truth for the weights.
+ */
+import { extractHeadings, stripHtmlTags } from './analysis.js';
+/** Page score weights. Must sum to 100. */
+export const PAGE_SEO_WEIGHTS = {
+    metaTitlePresent: 10,
+    metaTitleLength: 5,
+    metaDescPresent: 10,
+    metaDescLength: 5,
+    focusKeyword: 8,
+    canonical: 7,
+    h1: 10,
+    contentLength: 10,
+    ogImage: 8,
+    ogTitleDesc: 5,
+    structuredData: 7,
+    internalLinks: 5,
+    indexable: 10,
+};
+/** Site score category weights (spec). Must sum to 100. */
+export const SITE_SEO_WEIGHTS = {
+    content: 30,
+    technical: 25,
+    linkRedirect: 20,
+    structuredSocial: 15,
+    performance: 10,
+};
+const MIN_CONTENT_WORDS = 300;
+const IMPROVE_CONTENT_WORDS = 150;
+function present(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/** Map a 0-100 score to a grade. Aligns with the Content SEO table colours. */
+export function gradeForSeoScore(score) {
+    if (score >= 80)
+        return 'good';
+    if (score >= 60)
+        return 'fair';
+    if (score >= 1)
+        return 'poor';
+    return 'critical';
+}
+/**
+ * Count H1 headings in content that may be HTML or Markdown (case-insensitive
+ * for HTML tags, ATX `#`/Setext `===` for Markdown), so markdown-bodied posts
+ * aren't penalised for a "missing" H1 that is actually present.
+ */
+export function countH1(html) {
+    return extractHeadings(html, 1).length;
+}
+function wordCountOf(content) {
+    const text = stripHtmlTags(content);
+    if (!text)
+        return 0;
+    return text.split(/\s+/).filter((w) => w.length > 0).length;
+}
+/**
+ * Compute a page/post SEO score (0-100) with an explainable breakdown.
+ *
+ * Points are additive per {@link PAGE_SEO_WEIGHTS}; "warn" checks earn partial
+ * credit. The total is clamped to 0-100 and rounded.
+ */
+export function calculatePageSeoScore(input) {
+    const checks = [];
+    const push = (id, label, max, status, message) => {
+        const points = status === 'pass' ? max : status === 'warn' ? Math.round(max * 0.5) : 0;
+        checks.push({ id, label, points, max, status, message });
+    };
+    // -- Meta title -----------------------------------------------------------
+    const metaTitle = (input.metaTitle ?? '').trim();
+    if (metaTitle.length === 0) {
+        push('meta-title', 'Meta title', PAGE_SEO_WEIGHTS.metaTitlePresent, 'fail', 'No meta title set.');
+        push('meta-title-length', 'Meta title length', PAGE_SEO_WEIGHTS.metaTitleLength, 'fail', 'Add a 30–60 character meta title.');
+    }
+    else {
+        push('meta-title', 'Meta title', PAGE_SEO_WEIGHTS.metaTitlePresent, 'pass', 'Meta title is set.');
+        const len = metaTitle.length;
+        if (len >= 30 && len <= 60) {
+            push('meta-title-length', 'Meta title length', PAGE_SEO_WEIGHTS.metaTitleLength, 'pass', `Meta title is ${len} characters — ideal.`);
+        }
+        else {
+            push('meta-title-length', 'Meta title length', PAGE_SEO_WEIGHTS.metaTitleLength, 'warn', `Meta title is ${len} characters. Aim for 30–60.`);
+        }
+    }
+    // -- Meta description -----------------------------------------------------
+    const metaDesc = (input.metaDescription ?? '').trim();
+    if (metaDesc.length === 0) {
+        push('meta-description', 'Meta description', PAGE_SEO_WEIGHTS.metaDescPresent, 'fail', 'No meta description set.');
+        push('meta-description-length', 'Meta description length', PAGE_SEO_WEIGHTS.metaDescLength, 'fail', 'Add a 120–160 character description.');
+    }
+    else {
+        push('meta-description', 'Meta description', PAGE_SEO_WEIGHTS.metaDescPresent, 'pass', 'Meta description is set.');
+        const len = metaDesc.length;
+        if (len >= 120 && len <= 160) {
+            push('meta-description-length', 'Meta description length', PAGE_SEO_WEIGHTS.metaDescLength, 'pass', `Meta description is ${len} characters — ideal.`);
+        }
+        else {
+            push('meta-description-length', 'Meta description length', PAGE_SEO_WEIGHTS.metaDescLength, 'warn', `Meta description is ${len} characters. Aim for 120–160.`);
+        }
+    }
+    // -- Focus keyword --------------------------------------------------------
+    push('focus-keyword', 'Focus keyword', PAGE_SEO_WEIGHTS.focusKeyword, present(input.focusKeyword) ? 'pass' : 'warn', present(input.focusKeyword) ? 'Focus keyword is set.' : 'No focus keyword set.');
+    // -- Canonical ------------------------------------------------------------
+    push('canonical', 'Canonical URL', PAGE_SEO_WEIGHTS.canonical, present(input.canonicalUrl) ? 'pass' : 'warn', present(input.canonicalUrl) ? 'Canonical URL is set.' : 'No canonical URL set.');
+    // -- H1 -------------------------------------------------------------------
+    const content = input.content ?? '';
+    const h1Count = countH1(content);
+    if (h1Count === 1) {
+        push('h1', 'H1 heading', PAGE_SEO_WEIGHTS.h1, 'pass', 'Exactly one H1 heading.');
+    }
+    else if (h1Count === 0) {
+        push('h1', 'H1 heading', PAGE_SEO_WEIGHTS.h1, content.length === 0 ? 'warn' : 'fail', 'No H1 heading found.');
+    }
+    else {
+        push('h1', 'H1 heading', PAGE_SEO_WEIGHTS.h1, 'warn', `Found ${h1Count} H1 headings. Use exactly one.`);
+    }
+    // -- Content length -------------------------------------------------------
+    const words = typeof input.wordCount === 'number' ? input.wordCount : wordCountOf(content);
+    if (words >= MIN_CONTENT_WORDS) {
+        push('content-length', 'Content length', PAGE_SEO_WEIGHTS.contentLength, 'pass', `${words} words — meets the ${MIN_CONTENT_WORDS}-word minimum.`);
+    }
+    else if (words >= IMPROVE_CONTENT_WORDS) {
+        push('content-length', 'Content length', PAGE_SEO_WEIGHTS.contentLength, 'warn', `${words} words. Aim for ${MIN_CONTENT_WORDS}+.`);
+    }
+    else {
+        push('content-length', 'Content length', PAGE_SEO_WEIGHTS.contentLength, 'fail', `Only ${words} words. Aim for ${MIN_CONTENT_WORDS}+.`);
+    }
+    // -- OG image -------------------------------------------------------------
+    push('og-image', 'Open Graph image', PAGE_SEO_WEIGHTS.ogImage, present(input.ogImage) ? 'pass' : 'warn', present(input.ogImage) ? 'OG image is set.' : 'No OG image — social shares show a placeholder.');
+    // -- OG title / description ----------------------------------------------
+    push('og-title-desc', 'Open Graph title & description', PAGE_SEO_WEIGHTS.ogTitleDesc, present(input.ogTitle) || present(input.ogDescription) ? 'pass' : 'warn', present(input.ogTitle) || present(input.ogDescription)
+        ? 'OG title/description set or inherited.'
+        : 'No OG title/description set.');
+    // -- Structured data ------------------------------------------------------
+    push('structured-data', 'Structured data', PAGE_SEO_WEIGHTS.structuredData, present(input.structuredDataType) ? 'pass' : 'warn', present(input.structuredDataType)
+        ? `Schema type: ${input.structuredDataType}.`
+        : 'No structured data type set.');
+    // -- Internal links -------------------------------------------------------
+    const broken = input.brokenInternalLinks ?? 0;
+    push('internal-links', 'Internal links', PAGE_SEO_WEIGHTS.internalLinks, broken === 0 ? 'pass' : 'fail', broken === 0 ? 'No broken internal links.' : `${broken} broken internal link(s).`);
+    // -- Indexability ---------------------------------------------------------
+    const shouldIndex = input.shouldBeIndexable !== false;
+    const accidentalNoindex = shouldIndex && input.noindex === true;
+    push('indexable', 'Indexability', PAGE_SEO_WEIGHTS.indexable, accidentalNoindex ? 'fail' : 'pass', accidentalNoindex
+        ? 'Page is set to noindex but should be indexable.'
+        : 'Indexability is correct.');
+    const earned = checks.reduce((sum, c) => sum + c.points, 0);
+    const score = Math.max(0, Math.min(100, Math.round(earned)));
+    return { score, grade: gradeForSeoScore(score), checks };
+}
+function clampScore(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(100, n));
+}
+/**
+ * Combine per-category sub-scores into a weighted 0-100 site score.
+ *
+ * Performance defaults to 70 (neutral) when not supplied, so sites without a
+ * connected performance source aren't unfairly penalised — the weight is still
+ * applied so connecting Search Console can only improve the signal's accuracy.
+ */
+export function calculateSiteSeoScore(input) {
+    const categories = [
+        {
+            category: 'content',
+            score: clampScore(input.content),
+            weight: SITE_SEO_WEIGHTS.content,
+            contribution: 0,
+        },
+        {
+            category: 'technical',
+            score: clampScore(input.technical),
+            weight: SITE_SEO_WEIGHTS.technical,
+            contribution: 0,
+        },
+        {
+            category: 'linkRedirect',
+            score: clampScore(input.linkRedirect),
+            weight: SITE_SEO_WEIGHTS.linkRedirect,
+            contribution: 0,
+        },
+        {
+            category: 'structuredSocial',
+            score: clampScore(input.structuredSocial),
+            weight: SITE_SEO_WEIGHTS.structuredSocial,
+            contribution: 0,
+        },
+        {
+            category: 'performance',
+            score: clampScore(input.performance ?? 70),
+            weight: SITE_SEO_WEIGHTS.performance,
+            contribution: 0,
+        },
+    ];
+    let total = 0;
+    for (const c of categories) {
+        c.contribution = (c.score * c.weight) / 100;
+        total += c.contribution;
+    }
+    const score = Math.max(0, Math.min(100, Math.round(total)));
+    return { score, grade: gradeForSeoScore(score), breakdown: categories };
+}
+//# sourceMappingURL=score.js.map

package/dist/seo/score.js.map

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

package/dist/seo/serving-origin.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Serving-origin ops guard (Launch Gate E / serving-contract §9).
+ *
+ * Production must not silently fall back to the CMS/request host for absolute
+ * SEO URLs. Call {@link assertServingOriginConfigured} at Astro/Next boot so a
+ * misconfigured deploy fails loudly instead of shipping wrong sitemap/OG hosts.
+ */
+export declare class ServingOriginError extends Error {
+    constructor(message: string);
+}
+/** Trim and strip a trailing slash from an origin/URL. */
+export declare function normalizeOrigin(url: string): string;
+/** Compare two origins (scheme + host [+ port]), ignoring trailing slashes. */
+export declare function originsMatch(a: string, b: string): boolean;
+/**
+ * True when `siteUrlFromRequest` would fall back to the inbound request host
+ * because `seo.siteUrl` / `NEXT_PUBLIC_SITE_URL` is unset — a serving-reality leak.
+ */
+export declare function siteUrlWouldFallbackToRequest(seoSiteUrl?: string | null): boolean;
+export interface AssertServingOriginOptions {
+    /**
+     * Configured public apex (`seo.siteUrl` / `NEXT_PUBLIC_SITE_URL`).
+     * When unset in strict mode, assertion fails.
+     */
+    siteUrl?: string | null;
+    /**
+     * Runtime serving origin (Astro `SITE`, request public host). When both this
+     * and `siteUrl` are set, they must match.
+     */
+    servingOrigin?: string | null;
+    /**
+     * When true, throw {@link ServingOriginError}. When false, `console.error` only.
+     * Defaults to production/preview-like environments.
+     */
+    strict?: boolean;
+}
+/**
+ * Fail (or loudly warn) when the public apex is missing or disagrees with the
+ * serving origin. Safe to call once at middleware/boot.
+ */
+export declare function assertServingOriginConfigured(options: AssertServingOriginOptions): void;
+//# sourceMappingURL=serving-origin.d.ts.map

package/dist/seo/serving-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-origin.d.ts","sourceRoot":"","sources":["../../src/seo/serving-origin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAS1D;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEjF;AAUD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAsCvF"}

package/dist/seo/serving-origin.js

@@ -0,0 +1,83 @@
+/**
+ * Serving-origin ops guard (Launch Gate E / serving-contract §9).
+ *
+ * Production must not silently fall back to the CMS/request host for absolute
+ * SEO URLs. Call {@link assertServingOriginConfigured} at Astro/Next boot so a
+ * misconfigured deploy fails loudly instead of shipping wrong sitemap/OG hosts.
+ */
+export class ServingOriginError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ServingOriginError';
+    }
+}
+/** Trim and strip a trailing slash from an origin/URL. */
+export function normalizeOrigin(url) {
+    return url.trim().replace(/\/+$/, '');
+}
+/** Compare two origins (scheme + host [+ port]), ignoring trailing slashes. */
+export function originsMatch(a, b) {
+    const left = normalizeOrigin(a);
+    const right = normalizeOrigin(b);
+    if (!left || !right)
+        return false;
+    try {
+        return new URL(left).origin === new URL(right).origin;
+    }
+    catch {
+        return left === right;
+    }
+}
+/**
+ * True when `siteUrlFromRequest` would fall back to the inbound request host
+ * because `seo.siteUrl` / `NEXT_PUBLIC_SITE_URL` is unset — a serving-reality leak.
+ */
+export function siteUrlWouldFallbackToRequest(seoSiteUrl) {
+    return !normalizeOrigin(seoSiteUrl ?? '');
+}
+function isProdLikeEnv() {
+    return (process.env.NODE_ENV === 'production' ||
+        process.env.VERCEL_ENV === 'production' ||
+        process.env.VERCEL_ENV === 'preview');
+}
+/**
+ * Fail (or loudly warn) when the public apex is missing or disagrees with the
+ * serving origin. Safe to call once at middleware/boot.
+ */
+export function assertServingOriginConfigured(options) {
+    const strict = options.strict ?? isProdLikeEnv();
+    const siteUrl = options.siteUrl ? normalizeOrigin(options.siteUrl) : '';
+    const serving = options.servingOrigin ? normalizeOrigin(options.servingOrigin) : '';
+    let message = null;
+    if (!siteUrl && !serving) {
+        message =
+            '[prenta] Public site origin is unset (seo.siteUrl / NEXT_PUBLIC_SITE_URL / SITE). ' +
+                'Absolute URLs in sitemap, robots, OG, and JSON-LD will fall back to the request host ' +
+                '(serving-reality leak). Set the public apex before go-live (Launch Gate E).';
+    }
+    else if (siteUrl && serving && !originsMatch(siteUrl, serving)) {
+        message =
+            `[prenta] Public origin mismatch: configured=${siteUrl} serving=${serving}. ` +
+                'seo.siteUrl / NEXT_PUBLIC_SITE_URL must equal the Astro public apex (SITE).';
+    }
+    else if (!siteUrl && serving) {
+        // Serving origin alone is enough for the Astro host; CMS still needs siteUrl.
+        // Warn in strict mode so split deploys remember to set CMS env too — but do
+        // not throw when only SITE is present on the public host.
+        if (strict && typeof console !== 'undefined') {
+            console.warn('[prenta] SITE is set but seo.siteUrl / NEXT_PUBLIC_SITE_URL was not passed to ' +
+                'assertServingOriginConfigured. On the CMS host, set NEXT_PUBLIC_SITE_URL to ' +
+                `${serving} so siteUrlFromRequest does not fall back to the request origin.`);
+        }
+        return;
+    }
+    if (!message)
+        return;
+    if (strict) {
+        throw new ServingOriginError(message);
+    }
+    if (typeof console !== 'undefined') {
+        console.error(message);
+    }
+}
+//# sourceMappingURL=serving-origin.js.map

package/dist/seo/serving-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-origin.js","sourceRoot":"","sources":["../../src/seo/serving-origin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACvC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;IAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;IAChC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,KAAK,KAAK,CAAA;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAA0B;IACtE,OAAO,CAAC,eAAe,CAAC,UAAU,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QACrC,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,YAAY;QACvC,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CACrC,CAAA;AACH,CAAC;AAoBD;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAmC;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,EAAE,CAAA;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEnF,IAAI,OAAO,GAAkB,IAAI,CAAA;IAEjC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,oFAAoF;gBACpF,uFAAuF;gBACvF,6EAA6E,CAAA;IACjF,CAAC;SAAM,IAAI,OAAO,IAAI,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QACjE,OAAO;YACL,+CAA+C,OAAO,YAAY,OAAO,IAAI;gBAC7E,6EAA6E,CAAA;IACjF,CAAC;SAAM,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QAC/B,8EAA8E;QAC9E,4EAA4E;QAC5E,0DAA0D;QAC1D,IAAI,MAAM,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YAC7C,OAAO,CAAC,IAAI,CACV,gFAAgF;gBAC9E,8EAA8E;gBAC9E,GAAG,OAAO,kEAAkE,CAC/E,CAAA;QACH,CAAC;QACD,OAAM;IACR,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;AACH,CAAC"}

package/dist/seo/site-identity.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Shared site-identity JSON-LD helpers.
+ *
+ * Article/Blog surfaces often reference `${siteUrl}/#organization` as
+ * `publisher` / `author`. Those `@id`s only resolve when the Organization
+ * (and usually WebSite) nodes are **on the same page**. This helper emits
+ * those nodes so any Astro/Next page can drop them in without hand-rolling
+ * schema — fixing the dangling-`@id` class that blocks Article rich results.
+ *
+ * CMS-resolved pages that go through `composePageMeta` already include these
+ * nodes via `buildSchemaGraph`. Use this helper for static routes, hand-rolled
+ * Article JSON-LD, and layouts that need a fallback when page meta lacks
+ * Organization.
+ */
+import type { SiteSEOConfig } from '../config/types.js';
+import { type OrganizationSchemaType } from '../content/structured-data.js';
+export interface SiteIdentityInput {
+    /** Public apex, no trailing slash (e.g. `https://example.com`). */
+    siteUrl: string;
+    /** Brand / site name. */
+    siteName: string;
+    siteDescription?: string;
+    organizationName?: string;
+    organizationUrl?: string;
+    organizationLogo?: string | null;
+    organizationSameAs?: string[];
+    organizationType?: OrganizationSchemaType | OrganizationSchemaType[];
+    searchUrlTemplate?: string;
+    defaultLanguage?: string;
+    /**
+     * When false, emit only the Organization node (for pages that already ship
+     * a WebSite node). Default true.
+     */
+    includeWebSite?: boolean;
+}
+/**
+ * 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 declare function siteIdentityFromSeo(site: SiteSEOConfig | null | undefined, fallbacks?: {
+    siteUrl?: string;
+    siteName?: string;
+}): SiteIdentityInput | null;
+/** WebSite + Organization nodes with stable `#website` / `#organization` @ids. */
+export declare function siteIdentityNodes(input: SiteIdentityInput): Record<string, unknown>[];
+/** Full JSON-LD document (`@context` + `@graph`) for site identity. */
+export declare function siteIdentityJsonLd(input: SiteIdentityInput): {
+    '@context': 'https://schema.org';
+    '@graph': Record<string, unknown>[];
+};
+/** XSS-safe `<script type="application/ld+json">` for site identity. */
+export declare function siteIdentityJsonLdHtml(input: SiteIdentityInput): string;
+/**
+ * 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 declare function jsonLdHasOrganization(jsonLd: unknown): boolean;
+//# sourceMappingURL=site-identity.d.ts.map

package/dist/seo/site-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-identity.d.ts","sourceRoot":"","sources":["../../src/seo/site-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,+BAA+B,CAAA;AAEtC,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAA;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AA6BD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACtC,SAAS,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,iBAAiB,GAAG,IAAI,CAgB1B;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CASrF;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAC5D,UAAU,EAAE,oBAAoB,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CACpC,CAKA;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAOvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAyB9D"}