@orion-studios/payload-seo-audit 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+export type SeoAuditPluginConfig = {
+    site: {
+        name: string;
+        domain: string;
+        canonicalHost: string;
+        sitemapURL?: string;
+        keyURLs?: string[];
+    };
+    crawl?: {
+        maxPages?: number;
+        maxDepth?: number;
+        requestTimeoutMs?: number;
+        includePatterns?: string[];
+        excludePatterns?: string[];
+    };
+    triggers?: {
+        collections?: string[];
+        globals?: string[];
+    };
+    access?: (user: any) => boolean;
+    integrations?: {
+        enablePageSpeed?: boolean;
+        enableSearchConsole?: boolean;
+    };
+    thresholds?: {
+        targetLCPMs?: number;
+        targetCLS?: number;
+    };
+};
+export type NormalizedSeoConfig = Required<Omit<SeoAuditPluginConfig, 'site'>> & {
+    site: Required<SeoAuditPluginConfig['site']>;
+    crawl: Required<NonNullable<SeoAuditPluginConfig['crawl']>>;
+    triggers: Required<NonNullable<SeoAuditPluginConfig['triggers']>>;
+    integrations: Required<NonNullable<SeoAuditPluginConfig['integrations']>>;
+    thresholds: Required<NonNullable<SeoAuditPluginConfig['thresholds']>>;
+};
+export declare function normalizeConfig(config: SeoAuditPluginConfig): NormalizedSeoConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG;IAIjC,IAAI,EAAE;QAEJ,IAAI,EAAE,MAAM,CAAA;QAEZ,MAAM,EAAE,MAAM,CAAA;QAEd,aAAa,EAAE,MAAM,CAAA;QAErB,UAAU,CAAC,EAAE,MAAM,CAAA;QAEnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;IAKD,KAAK,CAAC,EAAE;QAEN,QAAQ,CAAC,EAAE,MAAM,CAAA;QAEjB,QAAQ,CAAC,EAAE,MAAM,CAAA;QAEjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QAEzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;QAE1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;KAC3B,CAAA;IAKD,QAAQ,CAAC,EAAE;QAET,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QAEtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;IAQD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAA;IAK/B,YAAY,CAAC,EAAE;QAEb,eAAe,CAAC,EAAE,OAAO,CAAA;QAEzB,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAC9B,CAAA;IAKD,UAAU,CAAC,EAAE;QAEX,WAAW,CAAC,EAAE,MAAM,CAAA;QAEpB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,CAAA;AAKD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,GAAG;IAC/E,IAAI,EAAE,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5C,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3D,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACjE,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;IACzE,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;CACtE,CAAA;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,mBAAmB,CAiCjF"}

package/dist/config.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeConfig = normalizeConfig;
+function normalizeConfig(config) {
+    const sitemapURL = config.site.sitemapURL || `${config.site.canonicalHost}/sitemap.xml`;
+    const keyURLs = config.site.keyURLs || [config.site.canonicalHost];
+    return {
+        site: {
+            name: config.site.name,
+            domain: config.site.domain,
+            canonicalHost: config.site.canonicalHost,
+            sitemapURL,
+            keyURLs,
+        },
+        crawl: {
+            maxPages: config.crawl?.maxPages ?? 120,
+            maxDepth: config.crawl?.maxDepth ?? 2,
+            requestTimeoutMs: config.crawl?.requestTimeoutMs ?? 10000,
+            includePatterns: config.crawl?.includePatterns ?? [],
+            excludePatterns: config.crawl?.excludePatterns ?? ['/admin', '/api', '?preview='],
+        },
+        triggers: {
+            collections: config.triggers?.collections ?? [],
+            globals: config.triggers?.globals ?? [],
+        },
+        access: config.access ?? ((user) => user?.role === 'admin'),
+        integrations: {
+            enablePageSpeed: config.integrations?.enablePageSpeed ?? true,
+            enableSearchConsole: config.integrations?.enableSearchConsole ?? false,
+        },
+        thresholds: {
+            targetLCPMs: config.thresholds?.targetLCPMs ?? 2500,
+            targetCLS: config.thresholds?.targetCLS ?? 0.1,
+        },
+    };
+}

package/dist/exports/components.d.ts

@@ -0,0 +1,4 @@
+export { SeoDashboard } from '../components/views/SeoDashboard';
+export { SeoSnapshotReport } from '../components/views/SeoSnapshotReport';
+export { SeoPageReport } from '../components/views/SeoPageReport';
+//# sourceMappingURL=components.d.ts.map

package/dist/exports/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/exports/components.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA"}

package/dist/exports/components.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoPageReport = exports.SeoSnapshotReport = exports.SeoDashboard = void 0;
+var SeoDashboard_1 = require("../components/views/SeoDashboard");
+Object.defineProperty(exports, "SeoDashboard", { enumerable: true, get: function () { return SeoDashboard_1.SeoDashboard; } });
+var SeoSnapshotReport_1 = require("../components/views/SeoSnapshotReport");
+Object.defineProperty(exports, "SeoSnapshotReport", { enumerable: true, get: function () { return SeoSnapshotReport_1.SeoSnapshotReport; } });
+var SeoPageReport_1 = require("../components/views/SeoPageReport");
+Object.defineProperty(exports, "SeoPageReport", { enumerable: true, get: function () { return SeoPageReport_1.SeoPageReport; } });

package/dist/globals/SeoDashboard.d.ts

@@ -0,0 +1,3 @@
+import type { GlobalConfig } from 'payload';
+export declare const SeoDashboard: GlobalConfig;
+//# sourceMappingURL=SeoDashboard.d.ts.map

package/dist/globals/SeoDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoDashboard.d.ts","sourceRoot":"","sources":["../../src/globals/SeoDashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,eAAO,MAAM,YAAY,EAAE,YAoB1B,CAAA"}

package/dist/globals/SeoDashboard.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoDashboard = void 0;
+const access_1 = require("../utilities/access");
+exports.SeoDashboard = {
+    slug: 'seo-dashboard',
+    label: 'SEO Dashboard',
+    admin: {
+        group: 'SEO',
+        components: {
+            views: {
+                edit: {
+                    root: {
+                        Component: '@orion-studios/payload-seo-audit/components#SeoDashboard',
+                    },
+                },
+            },
+        },
+    },
+    access: {
+        read: access_1.seoAdminAccess,
+        update: () => false,
+    },
+    fields: [],
+};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from 'payload';
+import type { SeoAuditPluginConfig, NormalizedSeoConfig } from './config';
+export type { SeoAuditPluginConfig } from './config';
+export declare const seoAuditPlugin: (pluginConfig: SeoAuditPluginConfig) => (incomingConfig: Config) => Config;
+export declare function getSeoConfig(payload: any): NormalizedSeoConfig | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAazE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAsCpD,eAAO,MAAM,cAAc,GAAI,cAAc,oBAAoB,MACvD,gBAAgB,MAAM,KAAG,MA+BlC,CAAA;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,mBAAmB,GAAG,IAAI,CAErE"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seoAuditPlugin = void 0;
+exports.getSeoConfig = getSeoConfig;
+const config_1 = require("./config");
+const SeoSnapshots_1 = require("./collections/SeoSnapshots");
+const SeoPageResults_1 = require("./collections/SeoPageResults");
+const SeoKeywordVisibility_1 = require("./collections/SeoKeywordVisibility");
+const SeoAuthoritySnapshots_1 = require("./collections/SeoAuthoritySnapshots");
+const SeoDashboard_1 = require("./globals/SeoDashboard");
+const seoAuditPlugin = (pluginConfig) => {
+    return (incomingConfig) => {
+        const seoConfig = (0, config_1.normalizeConfig)(pluginConfig);
+        const collections = [
+            ...(incomingConfig.collections || []),
+            SeoSnapshots_1.SeoSnapshots,
+            SeoPageResults_1.SeoPageResults,
+            SeoKeywordVisibility_1.SeoKeywordVisibility,
+            SeoAuthoritySnapshots_1.SeoAuthoritySnapshots,
+        ];
+        const globals = [
+            ...(incomingConfig.globals || []),
+            SeoDashboard_1.SeoDashboard,
+        ];
+        return {
+            ...incomingConfig,
+            collections,
+            globals,
+            custom: {
+                ...incomingConfig.custom,
+                seoAudit: seoConfig,
+            },
+        };
+    };
+};
+exports.seoAuditPlugin = seoAuditPlugin;
+function getSeoConfig(payload) {
+    return payload.config?.custom?.seoAudit || null;
+}

package/dist/utilities/access.d.ts

@@ -0,0 +1,8 @@
+import type { Access } from 'payload';
+type AdminUserLike = {
+    role?: string | null;
+} | null;
+export declare const seoAdminAccess: Access;
+export declare const canRunSeoAutomation: (user: AdminUserLike) => boolean;
+export {};
+//# sourceMappingURL=access.d.ts.map

package/dist/utilities/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/utilities/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,KAAK,aAAa,GAAG;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,GAAG,IAAI,CAAA;AAIR,eAAO,MAAM,cAAc,EAAE,MAG5B,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,MAAM,aAAa,YAAsB,CAAA"}

package/dist/utilities/access.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canRunSeoAutomation = exports.seoAdminAccess = void 0;
+const isAdminUser = (user) => user?.role === 'admin';
+const seoAdminAccess = ({ req }) => {
+    const user = (req.user || null);
+    return isAdminUser(user);
+};
+exports.seoAdminAccess = seoAdminAccess;
+const canRunSeoAutomation = (user) => isAdminUser(user);
+exports.canRunSeoAutomation = canRunSeoAutomation;

package/dist/utilities/auth.d.ts

@@ -0,0 +1,7 @@
+import type { NextRequest } from 'next/server';
+import type { Payload } from 'payload';
+export declare const authenticateSEOAdmin: (payload: Payload, request: NextRequest) => Promise<{
+    role?: string | null;
+} | null>;
+export declare const isValidSEOSecret: (request: NextRequest) => boolean;
+//# sourceMappingURL=auth.d.ts.map

package/dist/utilities/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/utilities/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGtC,eAAO,MAAM,oBAAoB,GAAU,SAAS,OAAO,EAAE,SAAS,WAAW;WAG7B,MAAM,GAAG,IAAI;SAMhE,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,YAWpD,CAAA"}

package/dist/utilities/auth.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSEOSecret = exports.authenticateSEOAdmin = void 0;
+const access_1 = require("../utilities/access");
+const authenticateSEOAdmin = async (payload, request) => {
+    try {
+        const result = await payload.auth({ headers: request.headers });
+        const user = (result?.user || null);
+        if (!(0, access_1.canRunSeoAutomation)(user))
+            return null;
+        return user;
+    }
+    catch {
+        return null;
+    }
+};
+exports.authenticateSEOAdmin = authenticateSEOAdmin;
+const isValidSEOSecret = (request) => {
+    const configuredSecret = process.env.SEO_AUDIT_SECRET;
+    if (!configuredSecret)
+        return false;
+    const headerSecret = request.headers.get('x-seo-audit-secret') ||
+        request.headers.get('authorization')?.replace(/^Bearer\s+/i, '');
+    const querySecret = new URL(request.url).searchParams.get('secret');
+    const bodySecret = request.headers.get('x-cron-secret');
+    return [headerSecret, querySecret, bodySecret].some((value) => value === configuredSecret);
+};
+exports.isValidSEOSecret = isValidSEOSecret;

package/dist/utilities/checks.d.ts

@@ -0,0 +1,3 @@
+import type { SEOCheckResult } from '../utilities/types';
+export declare const runSEOChecks: (url: string, html: string) => SEOCheckResult;
+//# sourceMappingURL=checks.d.ts.map

package/dist/utilities/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/utilities/checks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAgD,MAAM,oBAAoB,CAAA;AAqGtG,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,KAAG,cA2LxD,CAAA"}

package/dist/utilities/checks.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSEOChecks = void 0;
+const helpers_1 = require("../utilities/helpers");
+const getTagContent = (html, pattern) => {
+    const match = html.match(pattern);
+    return match?.[1]?.trim();
+};
+const stripHtml = (html) => html
+    .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+    .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+const extractJsonLdBlocks = (html) => [...html.matchAll(/<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi)].map((match) => match[1]?.trim() || '');
+const getHeadingLevels = (html) => [...html.matchAll(/<h([1-6])\b[^>]*>/gi)]
+    .map((match) => Number(match[1]))
+    .filter((value) => Number.isInteger(value));
+const countAnchors = (html, baseOrigin) => {
+    const links = [...html.matchAll(/<a\s+[^>]*href=["']([^"']+)["'][^>]*>/gi)]
+        .map((match) => match[1]?.trim())
+        .filter(Boolean);
+    let internal = 0;
+    let external = 0;
+    links.forEach((href) => {
+        if (href.startsWith('#') || href.startsWith('mailto:') || href.startsWith('tel:'))
+            return;
+        try {
+            const parsed = new URL(href, baseOrigin);
+            if (parsed.origin === baseOrigin)
+                internal += 1;
+            else
+                external += 1;
+        }
+        catch {
+            internal += 1;
+        }
+    });
+    return { internal, external };
+};
+const countImageAltGaps = (html) => {
+    const imageTags = [...html.matchAll(/<img\b[^>]*>/gi)].map((match) => match[0]);
+    let missingAlt = 0;
+    imageTags.forEach((tag) => {
+        const altMatch = tag.match(/\salt\s*=\s*["']([^"']*)["']/i);
+        if (!altMatch) {
+            missingAlt += 1;
+        }
+    });
+    return { imagesTotal: imageTags.length, imagesMissingAlt: missingAlt };
+};
+const countHeadingOrderIssues = (levels) => {
+    if (levels.length <= 1)
+        return 0;
+    let issues = 0;
+    for (let i = 1; i < levels.length; i += 1) {
+        const previous = levels[i - 1];
+        const current = levels[i];
+        if (current - previous > 1)
+            issues += 1;
+    }
+    return issues;
+};
+const pushIssue = (issues, { url, ruleID, category, severity, message, recommendation, }) => {
+    issues.push({
+        fingerprint: (0, helpers_1.createIssueFingerprint)(url, ruleID, message),
+        ruleID,
+        category,
+        severity,
+        message,
+        recommendation,
+    });
+};
+const runSEOChecks = (url, html) => {
+    const issues = [];
+    const origin = new URL(url).origin;
+    const title = getTagContent(html, /<title[^>]*>([^<]+)<\/title>/i);
+    const metaDescription = getTagContent(html, /<meta[^>]*name=["']description["'][^>]*content=["']([^"']+)["'][^>]*>/i);
+    const canonical = getTagContent(html, /<link[^>]*rel=["']canonical["'][^>]*href=["']([^"']+)["'][^>]*>/i);
+    const robotsMeta = getTagContent(html, /<meta[^>]*name=["']robots["'][^>]*content=["']([^"']+)["'][^>]*>/i);
+    const h1Count = (html.match(/<h1\b[^>]*>/gi) || []).length;
+    const headingLevels = getHeadingLevels(html);
+    const headingOrderIssues = countHeadingOrderIssues(headingLevels);
+    const { internal, external } = countAnchors(html, origin);
+    const { imagesTotal, imagesMissingAlt } = countImageAltGaps(html);
+    const structuredDataBlocks = extractJsonLdBlocks(html);
+    if (!title) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'title-missing',
+            category: 'metadata',
+            severity: 'critical',
+            message: 'Page is missing a title tag.',
+            recommendation: 'Add a unique, descriptive <title> tag for this page.',
+        });
+    }
+    else if (title.length < 20 || title.length > 65) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'title-length',
+            category: 'metadata',
+            severity: 'medium',
+            message: `Title length is ${title.length} characters.`,
+            recommendation: 'Keep titles between 20 and 65 characters where possible.',
+        });
+    }
+    if (!metaDescription) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'meta-description-missing',
+            category: 'metadata',
+            severity: 'high',
+            message: 'Page is missing a meta description.',
+            recommendation: 'Add a compelling meta description around 120-160 characters.',
+        });
+    }
+    else if (metaDescription.length < 70 || metaDescription.length > 165) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'meta-description-length',
+            category: 'metadata',
+            severity: 'low',
+            message: `Meta description length is ${metaDescription.length} characters.`,
+            recommendation: 'Aim for roughly 120-160 characters.',
+        });
+    }
+    if (!canonical) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'canonical-missing',
+            category: 'indexability',
+            severity: 'high',
+            message: 'Page is missing a canonical URL tag.',
+            recommendation: 'Add a canonical URL to avoid duplicate indexing signals.',
+        });
+    }
+    if (robotsMeta?.toLowerCase().includes('noindex')) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'robots-noindex',
+            category: 'indexability',
+            severity: 'info',
+            message: 'Page contains a noindex robots directive.',
+            recommendation: 'Confirm this URL should not be indexed.',
+        });
+    }
+    if (h1Count === 0) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'h1-missing',
+            category: 'structure',
+            severity: 'high',
+            message: 'Page is missing an H1 heading.',
+            recommendation: 'Include one clear H1 describing the primary page topic.',
+        });
+    }
+    else if (h1Count > 1) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'h1-multiple',
+            category: 'structure',
+            severity: 'medium',
+            message: `Page has ${h1Count} H1 headings.`,
+            recommendation: 'Use one H1 and structure the rest as H2-H6.',
+        });
+    }
+    if (headingOrderIssues > 0) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'heading-order',
+            category: 'structure',
+            severity: 'low',
+            message: `Detected ${headingOrderIssues} heading-level jumps.`,
+            recommendation: 'Keep heading order sequential (for example H2 to H3).',
+        });
+    }
+    if (internal < 2) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'internal-links-low',
+            category: 'links',
+            severity: 'low',
+            message: `Only ${internal} internal links found.`,
+            recommendation: 'Add contextual internal links to relevant service and conversion pages.',
+        });
+    }
+    if (imagesMissingAlt > 0) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'image-alt-missing',
+            category: 'media',
+            severity: imagesMissingAlt > 3 ? 'high' : 'medium',
+            message: `${imagesMissingAlt} image(s) are missing alt attributes.`,
+            recommendation: 'Add descriptive alt text for meaningful images.',
+        });
+    }
+    if (structuredDataBlocks.length === 0) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'structured-data-missing',
+            category: 'structuredData',
+            severity: 'low',
+            message: 'No JSON-LD structured data detected.',
+            recommendation: 'Add schema markup relevant to the page type.',
+        });
+    }
+    else {
+        const invalidBlocks = structuredDataBlocks.filter((block) => {
+            try {
+                JSON.parse(block);
+                return false;
+            }
+            catch {
+                return true;
+            }
+        });
+        if (invalidBlocks.length > 0) {
+            pushIssue(issues, {
+                url,
+                ruleID: 'structured-data-invalid',
+                category: 'structuredData',
+                severity: 'medium',
+                message: `${invalidBlocks.length} JSON-LD block(s) could not be parsed.`,
+                recommendation: 'Validate schema JSON and fix invalid syntax.',
+            });
+        }
+    }
+    const bodyText = stripHtml(html);
+    const wordCount = bodyText ? bodyText.split(/\s+/).length : 0;
+    if (wordCount < 120) {
+        pushIssue(issues, {
+            url,
+            ruleID: 'content-thin',
+            category: 'structure',
+            severity: 'info',
+            message: `Very low visible word count (${wordCount}).`,
+            recommendation: 'Ensure the page has meaningful content for search intent.',
+        });
+    }
+    return {
+        title,
+        metaDescription,
+        canonical,
+        robotsMeta,
+        h1Count,
+        headingOrderIssues,
+        internalLinks: internal,
+        externalLinks: external,
+        imagesTotal,
+        imagesMissingAlt,
+        structuredDataBlocks: structuredDataBlocks.length,
+        issues,
+    };
+};
+exports.runSEOChecks = runSEOChecks;

package/dist/utilities/crawler.d.ts

@@ -0,0 +1,14 @@
+import type { SEOSiteRecord } from '../utilities/types';
+export type CrawledPage = {
+    url: string;
+    path: string;
+    statusCode: number;
+    html: string;
+};
+type CrawlResult = {
+    pages: CrawledPage[];
+    visitedCount: number;
+};
+export declare const crawlSiteForSEO: (site: SEOSiteRecord) => Promise<CrawlResult>;
+export {};
+//# sourceMappingURL=crawler.d.ts.map

package/dist/utilities/crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../../src/utilities/crawler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGvD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAsED,eAAO,MAAM,eAAe,GAAU,MAAM,aAAa,KAAG,OAAO,CAAC,WAAW,CAgF9E,CAAA"}