@orion-studios/payload-seo-audit 1.0.0

package/dist/api/index.d.ts

@@ -0,0 +1,10 @@
+export { handleSeoRun } from './run';
+export { handleSeoRunStream } from './run-stream';
+export { handleSeoSnapshots } from './snapshots';
+export { handleSeoSnapshotReport } from './snapshot-report';
+export { handleSeoPageResults } from './page-results';
+export { handleSeoPageResult } from './page-result';
+export { handleSeoTrend } from './trend';
+export { handleSeoCron } from './cron';
+export { handleSeoBacklinksImport } from './backlinks-import';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/api/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSeoBacklinksImport = exports.handleSeoCron = exports.handleSeoTrend = exports.handleSeoPageResult = exports.handleSeoPageResults = exports.handleSeoSnapshotReport = exports.handleSeoSnapshots = exports.handleSeoRunStream = exports.handleSeoRun = void 0;
+var run_1 = require("./run");
+Object.defineProperty(exports, "handleSeoRun", { enumerable: true, get: function () { return run_1.handleSeoRun; } });
+var run_stream_1 = require("./run-stream");
+Object.defineProperty(exports, "handleSeoRunStream", { enumerable: true, get: function () { return run_stream_1.handleSeoRunStream; } });
+var snapshots_1 = require("./snapshots");
+Object.defineProperty(exports, "handleSeoSnapshots", { enumerable: true, get: function () { return snapshots_1.handleSeoSnapshots; } });
+var snapshot_report_1 = require("./snapshot-report");
+Object.defineProperty(exports, "handleSeoSnapshotReport", { enumerable: true, get: function () { return snapshot_report_1.handleSeoSnapshotReport; } });
+var page_results_1 = require("./page-results");
+Object.defineProperty(exports, "handleSeoPageResults", { enumerable: true, get: function () { return page_results_1.handleSeoPageResults; } });
+var page_result_1 = require("./page-result");
+Object.defineProperty(exports, "handleSeoPageResult", { enumerable: true, get: function () { return page_result_1.handleSeoPageResult; } });
+var trend_1 = require("./trend");
+Object.defineProperty(exports, "handleSeoTrend", { enumerable: true, get: function () { return trend_1.handleSeoTrend; } });
+var cron_1 = require("./cron");
+Object.defineProperty(exports, "handleSeoCron", { enumerable: true, get: function () { return cron_1.handleSeoCron; } });
+var backlinks_import_1 = require("./backlinks-import");
+Object.defineProperty(exports, "handleSeoBacklinksImport", { enumerable: true, get: function () { return backlinks_import_1.handleSeoBacklinksImport; } });

package/dist/api/page-result.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from 'payload';
+import type { NextRequest, NextResponse } from 'next/server';
+export declare function handleSeoPageResult(payload: Payload, request: NextRequest): Promise<NextResponse>;
+//# sourceMappingURL=page-result.d.ts.map

package/dist/api/page-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-result.d.ts","sourceRoot":"","sources":["../../src/api/page-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO5D,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA0EvB"}

package/dist/api/page-result.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSeoPageResult = handleSeoPageResult;
+const auth_1 = require("../utilities/auth");
+async function handleSeoPageResult(payload, request) {
+    const { NextResponse } = await Promise.resolve().then(() => __importStar(require('next/server')));
+    try {
+        const user = await (0, auth_1.authenticateSEOAdmin)(payload, request);
+        if (!user) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+        const { searchParams } = new URL(request.url);
+        const idParam = searchParams.get('id');
+        if (idParam) {
+            const pageResultID = Number.isFinite(Number(idParam)) ? Number(idParam) : idParam;
+            const doc = await payload.findByID({
+                collection: 'seo-page-results',
+                id: pageResultID,
+                depth: 1,
+                overrideAccess: true,
+            });
+            if (!doc) {
+                return NextResponse.json({ error: 'Page result not found.' }, { status: 404 });
+            }
+            return NextResponse.json({ pageResult: doc });
+        }
+        const pageURL = searchParams.get('url');
+        const snapshotParam = searchParams.get('snapshot');
+        const snapshotID = snapshotParam && Number.isFinite(Number(snapshotParam)) ? Number(snapshotParam) : null;
+        if (!pageURL) {
+            return NextResponse.json({ error: 'id or url query param is required.' }, { status: 400 });
+        }
+        const conditions = [{ url: { equals: pageURL } }];
+        if (snapshotID) {
+            conditions.push({
+                snapshot: { equals: snapshotID },
+            });
+        }
+        const where = {
+            and: conditions,
+        };
+        const results = await payload.find({
+            collection: 'seo-page-results',
+            where,
+            limit: 1,
+            sort: '-checkedAt',
+            depth: 1,
+            overrideAccess: true,
+        });
+        const doc = results.docs[0];
+        if (!doc) {
+            return NextResponse.json({ error: 'Page result not found.' }, { status: 404 });
+        }
+        return NextResponse.json({ pageResult: doc });
+    }
+    catch (error) {
+        console.error('SEO page-result error:', error);
+        return NextResponse.json({ error: error instanceof Error ? error.message : 'Failed to load page result.' }, { status: 500 });
+    }
+}

package/dist/api/page-results.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from 'payload';
+import type { NextRequest, NextResponse } from 'next/server';
+export declare function handleSeoPageResults(payload: Payload, request: NextRequest): Promise<NextResponse>;
+//# sourceMappingURL=page-results.d.ts.map

package/dist/api/page-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-results.d.ts","sourceRoot":"","sources":["../../src/api/page-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM5D,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA0DvB"}

package/dist/api/page-results.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSeoPageResults = handleSeoPageResults;
+const auth_1 = require("../utilities/auth");
+async function handleSeoPageResults(payload, request) {
+    const { NextResponse } = await Promise.resolve().then(() => __importStar(require('next/server')));
+    try {
+        const user = await (0, auth_1.authenticateSEOAdmin)(payload, request);
+        if (!user) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+        const { searchParams } = new URL(request.url);
+        const snapshotParam = searchParams.get('snapshot');
+        const snapshotID = snapshotParam && Number.isFinite(Number(snapshotParam)) ? Number(snapshotParam) : null;
+        if (!snapshotID) {
+            return NextResponse.json({ error: 'snapshot query param is required.' }, { status: 400 });
+        }
+        const sortField = searchParams.get('sort') || 'overallScore';
+        const order = searchParams.get('order') || 'asc';
+        const limit = Math.max(1, Math.min(100, Number(searchParams.get('limit') || 50)));
+        const page = Math.max(1, Number(searchParams.get('page') || 1));
+        const allowedSorts = ['overallScore', 'url', 'checkedAt', '-overallScore', '-url', '-checkedAt'];
+        const sortPrefix = order === 'desc' ? '-' : '';
+        let sortKey = `${sortPrefix}${sortField}`;
+        if (!allowedSorts.includes(sortKey) && !allowedSorts.includes(sortField)) {
+            sortKey = 'overallScore';
+        }
+        const results = await payload.find({
+            collection: 'seo-page-results',
+            where: { snapshot: { equals: snapshotID } },
+            limit,
+            page,
+            sort: sortKey,
+            depth: 0,
+            overrideAccess: true,
+        });
+        return NextResponse.json({
+            docs: results.docs,
+            totalDocs: results.totalDocs,
+            totalPages: results.totalPages,
+            page: results.page,
+            hasNextPage: results.hasNextPage,
+            hasPrevPage: results.hasPrevPage,
+        });
+    }
+    catch (error) {
+        console.error('SEO page-results error:', error);
+        return NextResponse.json({ error: error instanceof Error ? error.message : 'Failed to load page results.' }, { status: 500 });
+    }
+}

package/dist/api/run-stream.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from 'payload';
+import type { NextRequest } from 'next/server';
+export declare function handleSeoRunStream(payload: Payload, request: NextRequest): Promise<Response>;
+//# sourceMappingURL=run-stream.d.ts.map

package/dist/api/run-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stream.d.ts","sourceRoot":"","sources":["../../src/api/run-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAuE9C,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmQlG"}

package/dist/api/run-stream.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSeoRunStream = handleSeoRunStream;
+const auth_1 = require("../utilities/auth");
+const index_1 = require("../index");
+const checks_1 = require("../utilities/checks");
+const crawler_1 = require("../utilities/crawler");
+const helpers_1 = require("../utilities/helpers");
+const gsc_1 = require("../utilities/gsc");
+const pagespeed_1 = require("../utilities/pagespeed");
+const scoring_1 = require("../utilities/scoring");
+const providers_1 = require("../utilities/providers");
+const resolveRunType = (value) => {
+    if (value === 'scheduled' || value === 'publish-triggered')
+        return value;
+    return 'manual';
+};
+const average = (values) => {
+    if (!values.length)
+        return 0;
+    return Math.round(values.reduce((sum, value) => sum + value, 0) / values.length);
+};
+const applyPerformanceIssues = (issues, pageSpeed, site) => {
+    if (!pageSpeed)
+        return issues;
+    const nextIssues = [...issues];
+    if (typeof pageSpeed.averagePerformanceScore === 'number' && pageSpeed.averagePerformanceScore < 70) {
+        nextIssues.push({
+            fingerprint: `perf-score-${pageSpeed.averagePerformanceScore}`,
+            ruleID: 'pagespeed-performance-low',
+            category: 'performance',
+            severity: pageSpeed.averagePerformanceScore < 50 ? 'high' : 'medium',
+            message: `Average Lighthouse performance score is ${pageSpeed.averagePerformanceScore}.`,
+            recommendation: 'Optimize render-blocking assets, image delivery, and JS execution.',
+        });
+    }
+    const targetLCP = Number(site.thresholds?.targetLCPMs || 2500);
+    if (typeof pageSpeed.averageLCPMs === 'number' && pageSpeed.averageLCPMs > targetLCP) {
+        nextIssues.push({
+            fingerprint: `perf-lcp-${pageSpeed.averageLCPMs}`,
+            ruleID: 'pagespeed-lcp-high',
+            category: 'performance',
+            severity: pageSpeed.averageLCPMs > targetLCP * 1.5 ? 'high' : 'medium',
+            message: `Average LCP is ${pageSpeed.averageLCPMs}ms.`,
+            recommendation: 'Improve server response times, preload key assets, and optimize hero content.',
+        });
+    }
+    const targetCLS = Number(site.thresholds?.targetCLS || 0.1);
+    if (typeof pageSpeed.averageCLS === 'number' && pageSpeed.averageCLS > targetCLS) {
+        nextIssues.push({
+            fingerprint: `perf-cls-${pageSpeed.averageCLS}`,
+            ruleID: 'pagespeed-cls-high',
+            category: 'performance',
+            severity: pageSpeed.averageCLS > targetCLS * 2 ? 'high' : 'medium',
+            message: `Average CLS is ${pageSpeed.averageCLS}.`,
+            recommendation: 'Set explicit media dimensions and reduce layout shifts from dynamic UI elements.',
+        });
+    }
+    return nextIssues;
+};
+async function handleSeoRunStream(payload, request) {
+    const body = (await request.json().catch(() => ({})));
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+        async start(controller) {
+            const send = (event, data) => {
+                controller.enqueue(encoder.encode(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`));
+            };
+            try {
+                send('progress', { step: 'auth', message: 'Authenticating...' });
+                const [user, secretAuthorized] = await Promise.all([
+                    (0, auth_1.authenticateSEOAdmin)(payload, request),
+                    Promise.resolve((0, auth_1.isValidSEOSecret)(request)),
+                ]);
+                if (!user && !secretAuthorized) {
+                    send('error', { message: 'Unauthorized' });
+                    controller.close();
+                    return;
+                }
+                send('progress', { step: 'site', message: 'Loading site configuration...' });
+                const seoConfig = (0, index_1.getSeoConfig)(payload);
+                if (!seoConfig) {
+                    send('error', { message: 'SEO Audit plugin not configured' });
+                    controller.close();
+                    return;
+                }
+                const site = {
+                    id: 1,
+                    name: seoConfig.site.name,
+                    domain: seoConfig.site.domain,
+                    canonicalHost: seoConfig.site.canonicalHost,
+                    sitemapURL: seoConfig.site.sitemapURL,
+                    keyURLs: seoConfig.site.keyURLs.map((url) => ({ url })),
+                    crawlSettings: {
+                        maxPages: seoConfig.crawl.maxPages,
+                        maxDepth: seoConfig.crawl.maxDepth,
+                        requestTimeoutMs: seoConfig.crawl.requestTimeoutMs,
+                        includePatterns: seoConfig.crawl.includePatterns.map((pattern) => ({ pattern })),
+                        excludePatterns: seoConfig.crawl.excludePatterns.map((pattern) => ({ pattern })),
+                    },
+                    integrations: {
+                        enablePageSpeed: seoConfig.integrations.enablePageSpeed,
+                        enableSearchConsole: seoConfig.integrations.enableSearchConsole,
+                    },
+                    thresholds: {
+                        targetLCPMs: seoConfig.thresholds.targetLCPMs,
+                        targetCLS: seoConfig.thresholds.targetCLS,
+                    },
+                };
+                const runLabel = `${site.name} SEO Snapshot ${new Date().toISOString()}`;
+                send('progress', { step: 'snapshot', message: 'Creating snapshot record...' });
+                const snapshot = await payload.create({
+                    collection: 'seo-snapshots',
+                    data: {
+                        runLabel,
+                        runType: resolveRunType(body.runType),
+                        status: 'pending',
+                        startedAt: new Date().toISOString(),
+                    },
+                    overrideAccess: true,
+                });
+                send('progress', { step: 'crawl', message: 'Crawling site pages...' });
+                const crawl = await (0, crawler_1.crawlSiteForSEO)(site);
+                send('progress', {
+                    step: 'crawl-complete',
+                    message: `Found ${crawl.pages.length} pages`,
+                    data: { pagesFound: crawl.pages.length },
+                });
+                send('progress', { step: 'checks', message: 'Running SEO checks on all pages...' });
+                const pageResults = crawl.pages.map((page) => {
+                    const check = (0, checks_1.runSEOChecks)(page.url, page.html);
+                    const score = (0, scoring_1.scoreSEOIssues)(check.issues);
+                    return {
+                        url: page.url,
+                        path: page.path,
+                        statusCode: page.statusCode,
+                        check,
+                        score,
+                    };
+                });
+                send('progress', { step: 'checks-complete', message: 'SEO checks complete' });
+                send('progress', { step: 'pagespeed', message: 'Analyzing page performance...' });
+                const pageSpeedSummary = site.integrations?.enablePageSpeed !== false
+                    ? await (0, pagespeed_1.getPageSpeedSummary)(pageResults.map((page) => page.url))
+                    : null;
+                if (pageSpeedSummary) {
+                    send('progress', {
+                        step: 'pagespeed-complete',
+                        message: `Performance analysis complete (avg: ${pageSpeedSummary.averagePerformanceScore})`,
+                    });
+                }
+                else {
+                    send('progress', { step: 'pagespeed-skipped', message: 'PageSpeed analysis disabled' });
+                }
+                send('progress', { step: 'gsc', message: 'Syncing Google Search Console data...' });
+                const keywordVisibilitySync = await (0, gsc_1.syncGSCKeywordVisibility)({
+                    payload,
+                    site,
+                });
+                if (keywordVisibilitySync.enabled) {
+                    send('progress', {
+                        step: 'gsc-complete',
+                        message: `Imported ${keywordVisibilitySync.imported} GSC keywords`,
+                    });
+                }
+                else {
+                    send('progress', { step: 'gsc-skipped', message: 'GSC sync disabled' });
+                }
+                const allIssues = applyPerformanceIssues(pageResults.flatMap((result) => result.check.issues), pageSpeedSummary, site);
+                const issueCounts = (0, helpers_1.countIssuesBySeverity)(allIssues);
+                const providerAdapter = (0, providers_1.getSEOProviderAdapter)();
+                const summaryText = keywordVisibilitySync.enabled
+                    ? `Automated audit completed using ${providerAdapter.name} authority adapter. GSC rows imported: ${keywordVisibilitySync.imported}.`
+                    : `Automated audit completed using ${providerAdapter.name} authority adapter.`;
+                const scores = {
+                    metadata: average(pageResults.map((result) => result.score.metadata)),
+                    indexability: average(pageResults.map((result) => result.score.indexability)),
+                    structure: average(pageResults.map((result) => result.score.structure)),
+                    links: average(pageResults.map((result) => result.score.links)),
+                    media: average(pageResults.map((result) => result.score.media)),
+                    structuredData: average(pageResults.map((result) => result.score.structuredData)),
+                    performance: typeof pageSpeedSummary?.averagePerformanceScore === 'number'
+                        ? pageSpeedSummary.averagePerformanceScore
+                        : average(pageResults.map((result) => result.score.performance)),
+                };
+                const overallScore = Math.round(scores.metadata * 0.2 +
+                    scores.indexability * 0.2 +
+                    scores.structure * 0.15 +
+                    scores.links * 0.1 +
+                    scores.media * 0.1 +
+                    scores.structuredData * 0.1 +
+                    scores.performance * 0.15);
+                send('progress', { step: 'saving', message: 'Saving results to database...' });
+                const batchSize = 10;
+                for (let i = 0; i < pageResults.length; i += batchSize) {
+                    const batch = pageResults.slice(i, i + batchSize);
+                    await Promise.all(batch.map((result) => payload.create({
+                        collection: 'seo-page-results',
+                        data: {
+                            snapshot: snapshot.id,
+                            url: result.url,
+                            path: result.path,
+                            statusCode: result.statusCode,
+                            title: result.check.title,
+                            metaDescription: result.check.metaDescription,
+                            canonical: result.check.canonical,
+                            robotsMeta: result.check.robotsMeta,
+                            h1Count: result.check.h1Count,
+                            internalLinks: result.check.internalLinks,
+                            externalLinks: result.check.externalLinks,
+                            imagesTotal: result.check.imagesTotal,
+                            imagesMissingAlt: result.check.imagesMissingAlt,
+                            structuredDataBlocks: result.check.structuredDataBlocks,
+                            headingOrderIssues: result.check.headingOrderIssues,
+                            scoreBreakdown: result.score,
+                            overallScore: Math.round(result.score.metadata * 0.2 +
+                                result.score.indexability * 0.2 +
+                                result.score.structure * 0.15 +
+                                result.score.links * 0.1 +
+                                result.score.media * 0.1 +
+                                result.score.structuredData * 0.1 +
+                                result.score.performance * 0.15),
+                            issues: result.check.issues,
+                            checkedAt: new Date().toISOString(),
+                        },
+                        overrideAccess: true,
+                    })));
+                }
+                await payload.update({
+                    collection: 'seo-snapshots',
+                    id: snapshot.id,
+                    data: {
+                        status: 'completed',
+                        completedAt: new Date().toISOString(),
+                        scores: { ...scores, overall: overallScore },
+                        metrics: {
+                            pagesCrawled: crawl.pages.length,
+                            pagesChecked: pageResults.length,
+                            avgLighthousePerformance: pageSpeedSummary?.averagePerformanceScore,
+                            avgLCPMs: pageSpeedSummary?.averageLCPMs,
+                            avgCLS: pageSpeedSummary?.averageCLS,
+                        },
+                        issueCounts,
+                        summary: summaryText,
+                    },
+                    overrideAccess: true,
+                });
+                send('complete', {
+                    message: 'Audit complete!',
+                    data: {
+                        pagesChecked: pageResults.length,
+                        overallScore,
+                        snapshotId: snapshot.id,
+                    },
+                });
+                controller.close();
+            }
+            catch (error) {
+                send('error', {
+                    message: error instanceof Error ? error.message : 'Failed to run SEO audit.',
+                });
+                controller.close();
+            }
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        },
+    });
+}

package/dist/api/run.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from 'payload';
+import type { NextRequest, NextResponse } from 'next/server';
+export declare function handleSeoRun(payload: Payload, request: NextRequest): Promise<NextResponse>;
+//# sourceMappingURL=run.d.ts.map

package/dist/api/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/api/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAc5D,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA4EhG"}

package/dist/api/run.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSeoRun = handleSeoRun;
+const auth_1 = require("../utilities/auth");
+const runAudit_1 = require("../utilities/runAudit");
+const index_1 = require("../index");
+const resolveRunType = (value) => {
+    if (value === 'scheduled' || value === 'publish-triggered')
+        return value;
+    return 'manual';
+};
+async function handleSeoRun(payload, request) {
+    const { NextResponse } = await Promise.resolve().then(() => __importStar(require('next/server')));
+    try {
+        const [user, secretAuthorized] = await Promise.all([
+            (0, auth_1.authenticateSEOAdmin)(payload, request),
+            Promise.resolve((0, auth_1.isValidSEOSecret)(request)),
+        ]);
+        if (!user && !secretAuthorized) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+        const seoConfig = (0, index_1.getSeoConfig)(payload);
+        if (!seoConfig) {
+            return NextResponse.json({ error: 'SEO Audit plugin not configured' }, { status: 500 });
+        }
+        const body = (await request.json().catch(() => ({})));
+        const site = {
+            id: 1,
+            name: seoConfig.site.name,
+            domain: seoConfig.site.domain,
+            canonicalHost: seoConfig.site.canonicalHost,
+            sitemapURL: seoConfig.site.sitemapURL,
+            keyURLs: seoConfig.site.keyURLs.map(url => ({ url })),
+            crawlSettings: {
+                maxPages: seoConfig.crawl.maxPages,
+                maxDepth: seoConfig.crawl.maxDepth,
+                requestTimeoutMs: seoConfig.crawl.requestTimeoutMs,
+                includePatterns: seoConfig.crawl.includePatterns.map(pattern => ({ pattern })),
+                excludePatterns: seoConfig.crawl.excludePatterns.map(pattern => ({ pattern })),
+            },
+            integrations: {
+                enablePageSpeed: seoConfig.integrations.enablePageSpeed,
+                enableSearchConsole: seoConfig.integrations.enableSearchConsole,
+            },
+            thresholds: {
+                targetLCPMs: seoConfig.thresholds.targetLCPMs,
+                targetCLS: seoConfig.thresholds.targetCLS,
+            },
+        };
+        const result = await (0, runAudit_1.runSEOSnapshot)({
+            payload,
+            site,
+            runType: resolveRunType(body.runType),
+        });
+        return NextResponse.json({
+            success: true,
+            snapshotID: result.snapshotID,
+            pagesChecked: result.pagesChecked,
+            overallScore: result.overallScore,
+            issueCounts: result.issueCounts,
+            status: 'completed',
+            completedAt: new Date().toISOString(),
+        });
+    }
+    catch (error) {
+        console.error('SEO run error:', error);
+        return NextResponse.json({ error: error instanceof Error ? error.message : 'Failed to run SEO audit.' }, { status: 500 });
+    }
+}

package/dist/api/snapshot-report.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from 'payload';
+import type { NextRequest, NextResponse } from 'next/server';
+export declare function handleSeoSnapshotReport(payload: Payload, request: NextRequest): Promise<NextResponse>;
+//# sourceMappingURL=snapshot-report.d.ts.map

package/dist/api/snapshot-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-report.d.ts","sourceRoot":"","sources":["../../src/api/snapshot-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM5D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAuHvB"}