@consilioweb/payload-seo-analyzer 1.7.1 → 1.8.1

package/dist/index.d.cts

@@ -7,7 +7,7 @@ import { Field, Plugin, Payload, PayloadHandler, CollectionConfig, CollectionAft
 type CheckStatus = 'pass' | 'warning' | 'fail';
 type CheckCategory = 'critical' | 'important' | 'bonus';
 /** Rule group label — used by the UI to group checks by topic */
-type RuleGroup = 'title' | 'meta-description' | 'url' | 'headings' | 'content' | 'images' | 'linking' | 'social' | 'schema' | 'readability' | 'quality' | 'secondary-keywords' | 'cornerstone' | 'freshness' | 'technical' | 'accessibility' | 'ecommerce';
+type RuleGroup = 'title' | 'meta-description' | 'url' | 'headings' | 'content' | 'images' | 'linking' | 'social' | 'schema' | 'readability' | 'quality' | 'secondary-keywords' | 'cornerstone' | 'freshness' | 'technical' | 'accessibility' | 'ecommerce' | 'eeat' | 'geo' | 'hreflang';
 interface SeoCheck {
     id: string;
     label: string;
@@ -25,6 +25,18 @@ interface SeoAnalysis {
     score: number;
     level: SeoLevel;
     checks: SeoCheck[];
+    /**
+     * Separate "AI-readiness" indicator (SEO 2026) — how well the page is structured to be
+     * CITED by generative engines (AI Overviews, ChatGPT, Perplexity). Aggregated from the
+     * `geo` + `eeat` groups and the `schema-coverage` check. Distinct from the SEO `score`
+     * because ranking and AI-citation are governed by different signals.
+     */
+    aiReadiness?: {
+        score: number;
+        level: SeoLevel;
+        /** Number of checks contributing to this indicator */
+        checkCount: number;
+    };
 }
 interface SeoInput {
     metaTitle?: string;
@@ -49,8 +61,21 @@ interface SeoInput {
     isCornerstone?: boolean;
     /** ISO date string — last time the document was updated */
     updatedAt?: string;
+    /** ISO date string — when the content was first published (E-E-A-T datePublished) */
+    publishedAt?: string;
     /** ISO date string — last time the content was manually reviewed */
     contentLastReviewed?: string;
+    /** Display/published date shown to readers (used to detect fake "refresh" — date changed without real updatedAt change) */
+    displayedDate?: string;
+    /** Attributed author name (E-E-A-T) — empty/undefined if none */
+    author?: string;
+    /** Author profile URL or sameAs link (E-E-A-T entity signal) */
+    authorUrl?: string;
+    /** Locale alternates for hreflang validation — empty/undefined on mono-locale sites */
+    localeAlternates?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
     /** Canonical URL for this page (if explicitly set) */
     canonicalUrl?: string;
     /** Robots meta directives (e.g. 'noindex', 'nofollow', 'noindex, nofollow') */
@@ -137,6 +162,17 @@ interface SeoFeatures {
     externalLinks?: boolean;
     /** AI content generation/rewrite (endpoints) */
     aiFeatures?: boolean;
+    /**
+     * Google Search Console API via OAuth (opt-in, default false). Requires host setup:
+     * a Google Cloud OAuth client (GSC_OAUTH_CLIENT_ID/SECRET), the Search Console API
+     * enabled, the redirect URI registered, and ideally SEO_GSC_ENCRYPTION_KEY for token-at-rest.
+     */
+    gscApi?: boolean;
+    /**
+     * Background cache warm-up on init + hourly (pre-loads collection data). Enabled by
+     * default. Set to `false` on low-memory hosting to avoid loading all documents at startup.
+     */
+    warmCache?: boolean;
     /** Duplicate content detection (endpoint) */
     duplicateContent?: boolean;
     /** Settings view (/admin/seo-config) */
@@ -817,6 +853,9 @@ interface DashboardTranslations {
         groupTechnical: string;
         groupAccessibility: string;
         groupEcommerce: string;
+        groupEeat: string;
+        groupGeo: string;
+        groupHreflang: string;
         levelExcellent: string;
         levelGood: string;
         levelFair: string;
@@ -825,6 +864,8 @@ interface DashboardTranslations {
         categoryImportant: string;
         categoryBonus: string;
         seoScore: string;
+        aiReadiness: string;
+        aiReadinessTooltip: string;
         outOf100: string;
         cornerstoneLabel: string;
         checksPassed: string;
@@ -1358,6 +1399,12 @@ declare const MIN_WORDS_GENERIC = 300;
 declare const MIN_WORDS_THIN = 100;
 declare const KEYWORD_DENSITY_MAX = 3;
 declare const KEYWORD_DENSITY_WARN = 2.5;
+/**
+ * @deprecated SEO desintox (2026): keyword density is not a ranking factor, and a
+ * minimum-density floor actively pushes toward keyword stuffing (penalised by
+ * Google spam policies). No longer used for scoring — the density check now only
+ * flags OVER-optimisation. Kept exported for backward compatibility.
+ */
 declare const KEYWORD_DENSITY_MIN = 0.5;
 declare const MAX_RECURSION_DEPTH = 50;
 declare const SCORE_EXCELLENT = 91;

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import { Field, Plugin, Payload, PayloadHandler, CollectionConfig, CollectionAft
 type CheckStatus = 'pass' | 'warning' | 'fail';
 type CheckCategory = 'critical' | 'important' | 'bonus';
 /** Rule group label — used by the UI to group checks by topic */
-type RuleGroup = 'title' | 'meta-description' | 'url' | 'headings' | 'content' | 'images' | 'linking' | 'social' | 'schema' | 'readability' | 'quality' | 'secondary-keywords' | 'cornerstone' | 'freshness' | 'technical' | 'accessibility' | 'ecommerce';
+type RuleGroup = 'title' | 'meta-description' | 'url' | 'headings' | 'content' | 'images' | 'linking' | 'social' | 'schema' | 'readability' | 'quality' | 'secondary-keywords' | 'cornerstone' | 'freshness' | 'technical' | 'accessibility' | 'ecommerce' | 'eeat' | 'geo' | 'hreflang';
 interface SeoCheck {
     id: string;
     label: string;
@@ -25,6 +25,18 @@ interface SeoAnalysis {
     score: number;
     level: SeoLevel;
     checks: SeoCheck[];
+    /**
+     * Separate "AI-readiness" indicator (SEO 2026) — how well the page is structured to be
+     * CITED by generative engines (AI Overviews, ChatGPT, Perplexity). Aggregated from the
+     * `geo` + `eeat` groups and the `schema-coverage` check. Distinct from the SEO `score`
+     * because ranking and AI-citation are governed by different signals.
+     */
+    aiReadiness?: {
+        score: number;
+        level: SeoLevel;
+        /** Number of checks contributing to this indicator */
+        checkCount: number;
+    };
 }
 interface SeoInput {
     metaTitle?: string;
@@ -49,8 +61,21 @@ interface SeoInput {
     isCornerstone?: boolean;
     /** ISO date string — last time the document was updated */
     updatedAt?: string;
+    /** ISO date string — when the content was first published (E-E-A-T datePublished) */
+    publishedAt?: string;
     /** ISO date string — last time the content was manually reviewed */
     contentLastReviewed?: string;
+    /** Display/published date shown to readers (used to detect fake "refresh" — date changed without real updatedAt change) */
+    displayedDate?: string;
+    /** Attributed author name (E-E-A-T) — empty/undefined if none */
+    author?: string;
+    /** Author profile URL or sameAs link (E-E-A-T entity signal) */
+    authorUrl?: string;
+    /** Locale alternates for hreflang validation — empty/undefined on mono-locale sites */
+    localeAlternates?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
     /** Canonical URL for this page (if explicitly set) */
     canonicalUrl?: string;
     /** Robots meta directives (e.g. 'noindex', 'nofollow', 'noindex, nofollow') */
@@ -137,6 +162,17 @@ interface SeoFeatures {
     externalLinks?: boolean;
     /** AI content generation/rewrite (endpoints) */
     aiFeatures?: boolean;
+    /**
+     * Google Search Console API via OAuth (opt-in, default false). Requires host setup:
+     * a Google Cloud OAuth client (GSC_OAUTH_CLIENT_ID/SECRET), the Search Console API
+     * enabled, the redirect URI registered, and ideally SEO_GSC_ENCRYPTION_KEY for token-at-rest.
+     */
+    gscApi?: boolean;
+    /**
+     * Background cache warm-up on init + hourly (pre-loads collection data). Enabled by
+     * default. Set to `false` on low-memory hosting to avoid loading all documents at startup.
+     */
+    warmCache?: boolean;
     /** Duplicate content detection (endpoint) */
     duplicateContent?: boolean;
     /** Settings view (/admin/seo-config) */
@@ -817,6 +853,9 @@ interface DashboardTranslations {
         groupTechnical: string;
         groupAccessibility: string;
         groupEcommerce: string;
+        groupEeat: string;
+        groupGeo: string;
+        groupHreflang: string;
         levelExcellent: string;
         levelGood: string;
         levelFair: string;
@@ -825,6 +864,8 @@ interface DashboardTranslations {
         categoryImportant: string;
         categoryBonus: string;
         seoScore: string;
+        aiReadiness: string;
+        aiReadinessTooltip: string;
         outOf100: string;
         cornerstoneLabel: string;
         checksPassed: string;
@@ -1358,6 +1399,12 @@ declare const MIN_WORDS_GENERIC = 300;
 declare const MIN_WORDS_THIN = 100;
 declare const KEYWORD_DENSITY_MAX = 3;
 declare const KEYWORD_DENSITY_WARN = 2.5;
+/**
+ * @deprecated SEO desintox (2026): keyword density is not a ranking factor, and a
+ * minimum-density floor actively pushes toward keyword stuffing (penalised by
+ * Google spam policies). No longer used for scoring — the density check now only
+ * flags OVER-optimisation. Kept exported for backward compatibility.
+ */
 declare const KEYWORD_DENSITY_MIN = 0.5;
 declare const MAX_RECURSION_DEPTH = 50;
 declare const SCORE_EXCELLENT = 91;