@orion-studios/payload-seo-audit 1.0.0

package/dist/api/snapshot-report.js

@@ -0,0 +1,130 @@
+"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.handleSeoSnapshotReport = handleSeoSnapshotReport;
+const auth_1 = require("../utilities/auth");
+async function handleSeoSnapshotReport(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 snapshot = await payload.findByID({
+            collection: 'seo-snapshots',
+            id: snapshotID,
+            depth: 1,
+            overrideAccess: true,
+        });
+        if (!snapshot) {
+            return NextResponse.json({ error: 'Snapshot not found.' }, { status: 404 });
+        }
+        const pageResults = await payload.find({
+            collection: 'seo-page-results',
+            where: { snapshot: { equals: snapshotID } },
+            limit: 1000,
+            sort: 'overallScore',
+            depth: 0,
+            overrideAccess: true,
+        });
+        const docs = pageResults.docs;
+        const categoryDistribution = {};
+        const severityDistribution = {};
+        let totalIssues = 0;
+        for (const doc of docs) {
+            const issues = doc.issues || [];
+            totalIssues += issues.length;
+            for (const issue of issues) {
+                if (issue.category) {
+                    categoryDistribution[issue.category] = (categoryDistribution[issue.category] || 0) + 1;
+                }
+                if (issue.severity) {
+                    severityDistribution[issue.severity] = (severityDistribution[issue.severity] || 0) + 1;
+                }
+            }
+        }
+        console.log(`[SEO Report] Processed ${docs.length} pages with ${totalIssues} total issues`);
+        const worstPages = docs
+            .filter((d) => typeof d.overallScore === 'number')
+            .sort((a, b) => (a.overallScore ?? 100) - (b.overallScore ?? 100))
+            .slice(0, 10)
+            .map((d) => ({
+            url: d.url,
+            score: d.overallScore ?? 0,
+            issueCount: (d.issues || []).length,
+        }));
+        const bestPages = docs
+            .filter((d) => typeof d.overallScore === 'number')
+            .sort((a, b) => (b.overallScore ?? 0) - (a.overallScore ?? 0))
+            .slice(0, 5)
+            .map((d) => ({
+            url: d.url,
+            score: d.overallScore ?? 0,
+        }));
+        const buckets = Array.from({ length: 10 }, (_, i) => ({
+            range: `${i * 10}-${i * 10 + 9}`,
+            count: 0,
+        }));
+        buckets[9].range = '90-100';
+        for (const doc of docs) {
+            const score = doc.overallScore;
+            if (typeof score === 'number') {
+                const bucketIndex = score >= 100 ? 9 : Math.floor(score / 10);
+                buckets[Math.min(bucketIndex, 9)].count++;
+            }
+        }
+        return NextResponse.json({
+            snapshot,
+            pageResults: docs,
+            aggregated: {
+                worstPages,
+                bestPages,
+                categoryDistribution,
+                severityDistribution,
+                scoreHistogram: buckets,
+            },
+        });
+    }
+    catch (error) {
+        console.error('SEO snapshot-report error:', error);
+        return NextResponse.json({ error: error instanceof Error ? error.message : 'Failed to load snapshot report.' }, { status: 500 });
+    }
+}

package/dist/api/snapshots.d.ts

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

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

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

package/dist/api/snapshots.js

@@ -0,0 +1,138 @@
+"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.handleSeoSnapshots = handleSeoSnapshots;
+const auth_1 = require("../utilities/auth");
+const first = (value) => (Array.isArray(value) ? value[0] : value);
+async function handleSeoSnapshots(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 url = new URL(request.url);
+        const limit = Math.max(1, Math.min(52, Number(url.searchParams.get('limit') || 12)));
+        const format = url.searchParams.get('format') || 'json';
+        const snapshots = await payload.find({
+            collection: 'seo-snapshots',
+            limit,
+            sort: '-startedAt',
+            depth: 0,
+            overrideAccess: true,
+        });
+        const latestSnapshot = snapshots.docs[0];
+        let latestIssues = [];
+        if (latestSnapshot) {
+            const pageResults = await payload.find({
+                collection: 'seo-page-results',
+                where: {
+                    snapshot: { equals: latestSnapshot.id },
+                },
+                limit: 15,
+                sort: 'overallScore',
+                depth: 0,
+                overrideAccess: true,
+            });
+            const priority = { critical: 0, high: 1, medium: 2, low: 3, info: 4 };
+            const collectedIssues = [];
+            for (const doc of pageResults.docs) {
+                const issues = doc.issues || [];
+                for (const issue of issues) {
+                    if (issue?.severity && issue?.message) {
+                        collectedIssues.push({
+                            url: doc.url,
+                            severity: issue.severity,
+                            message: issue.message,
+                            recommendation: issue.recommendation,
+                        });
+                    }
+                }
+                if (collectedIssues.length >= 50)
+                    break;
+            }
+            latestIssues = collectedIssues
+                .sort((a, b) => {
+                return (priority[a.severity || 'info'] ?? 5) - (priority[b.severity || 'info'] ?? 5);
+            })
+                .slice(0, 20);
+        }
+        if (format === 'csv') {
+            const header = [
+                'snapshot_id',
+                'run_label',
+                'status',
+                'started_at',
+                'completed_at',
+                'overall_score',
+                'critical',
+                'high',
+                'medium',
+                'low',
+                'info',
+            ];
+            const rows = snapshots.docs.map((snapshot) => [
+                snapshot.id,
+                snapshot.runLabel || '',
+                snapshot.status || '',
+                snapshot.startedAt || '',
+                snapshot.completedAt || '',
+                snapshot.scores?.overall ?? '',
+                snapshot.issueCounts?.critical ?? 0,
+                snapshot.issueCounts?.high ?? 0,
+                snapshot.issueCounts?.medium ?? 0,
+                snapshot.issueCounts?.low ?? 0,
+                snapshot.issueCounts?.info ?? 0,
+            ]
+                .map((value) => `"${String(value).replace(/"/g, '""')}"`)
+                .join(','));
+            return new NextResponse([header.join(','), ...rows].join('\n'), {
+                status: 200,
+                headers: {
+                    'content-type': 'text/csv; charset=utf-8',
+                    'content-disposition': 'attachment; filename="seo-snapshots.csv"',
+                },
+            });
+        }
+        return NextResponse.json({
+            snapshots: snapshots.docs,
+            latestIssues,
+        });
+    }
+    catch (error) {
+        console.error('SEO snapshots error:', error);
+        return NextResponse.json({ error: error instanceof Error ? error.message : 'Failed to load SEO snapshots.' }, { status: 500 });
+    }
+}

package/dist/api/trend.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"trend.d.ts","sourceRoot":"","sources":["../../src/api/trend.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,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAwClG"}

package/dist/api/trend.js

@@ -0,0 +1,71 @@
+"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.handleSeoTrend = handleSeoTrend;
+const auth_1 = require("../utilities/auth");
+async function handleSeoTrend(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 limit = Math.max(1, Math.min(52, Number(searchParams.get('limit') || 12)));
+        const snapshots = await payload.find({
+            collection: 'seo-snapshots',
+            where: {
+                status: { equals: 'completed' },
+            },
+            limit,
+            sort: '-startedAt',
+            depth: 0,
+            overrideAccess: true,
+        });
+        const points = snapshots.docs.map((doc) => ({
+            snapshotId: doc.id,
+            startedAt: doc.startedAt,
+            runLabel: doc.runLabel || '',
+            scores: doc.scores || {},
+            issueCounts: doc.issueCounts || {},
+            metrics: doc.metrics || {},
+        }));
+        return NextResponse.json({ points });
+    }
+    catch (error) {
+        console.error('SEO trend error:', error);
+        return NextResponse.json({ error: error instanceof Error ? error.message : 'Failed to load trend data.' }, { status: 500 });
+    }
+}

package/dist/collections/SeoAuthoritySnapshots.d.ts

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

package/dist/collections/SeoAuthoritySnapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoAuthoritySnapshots.d.ts","sourceRoot":"","sources":["../../src/collections/SeoAuthoritySnapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,eAAO,MAAM,qBAAqB,EAAE,gBA8EnC,CAAA"}

package/dist/collections/SeoAuthoritySnapshots.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoAuthoritySnapshots = void 0;
+const access_1 = require("../utilities/access");
+exports.SeoAuthoritySnapshots = {
+    slug: 'seo-authority-snapshots',
+    admin: {
+        useAsTitle: 'label',
+        defaultColumns: ['label', 'capturedAt', 'referringDomains', 'totalBacklinks'],
+        group: 'SEO',
+    },
+    access: {
+        read: access_1.seoAdminAccess,
+        create: access_1.seoAdminAccess,
+        update: access_1.seoAdminAccess,
+        delete: access_1.seoAdminAccess,
+    },
+    fields: [
+        {
+            name: 'label',
+            type: 'text',
+            required: true,
+        },
+        {
+            name: 'capturedAt',
+            type: 'date',
+            required: true,
+            admin: {
+                date: { pickerAppearance: 'dayAndTime' },
+            },
+        },
+        {
+            name: 'source',
+            type: 'select',
+            required: true,
+            options: [
+                { label: 'Manual CSV', value: 'manual-csv' },
+                { label: 'Google Search Console', value: 'gsc' },
+                { label: 'Provider API', value: 'provider' },
+            ],
+        },
+        {
+            name: 'totalBacklinks',
+            type: 'number',
+        },
+        {
+            name: 'referringDomains',
+            type: 'number',
+        },
+        {
+            name: 'domainAuthorityProxy',
+            type: 'number',
+        },
+        {
+            name: 'backlinks',
+            type: 'array',
+            fields: [
+                { name: 'sourceURL', type: 'text' },
+                { name: 'targetURL', type: 'text' },
+                { name: 'anchorText', type: 'text' },
+                { name: 'firstSeen', type: 'date' },
+                { name: 'lastSeen', type: 'date' },
+                {
+                    name: 'linkType',
+                    type: 'select',
+                    options: [
+                        { label: 'Follow', value: 'follow' },
+                        { label: 'Nofollow', value: 'nofollow' },
+                        { label: 'Unknown', value: 'unknown' },
+                    ],
+                },
+            ],
+        },
+        {
+            name: 'providerMetadata',
+            type: 'json',
+        },
+        {
+            name: 'notes',
+            type: 'textarea',
+        },
+    ],
+};

package/dist/collections/SeoKeywordVisibility.d.ts

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

package/dist/collections/SeoKeywordVisibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoKeywordVisibility.d.ts","sourceRoot":"","sources":["../../src/collections/SeoKeywordVisibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,eAAO,MAAM,oBAAoB,EAAE,gBA4DlC,CAAA"}

package/dist/collections/SeoKeywordVisibility.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoKeywordVisibility = void 0;
+const access_1 = require("../utilities/access");
+exports.SeoKeywordVisibility = {
+    slug: 'seo-keyword-visibility',
+    admin: {
+        useAsTitle: 'query',
+        defaultColumns: ['query', 'page', 'impressions', 'clicks', 'ctr', 'position', 'capturedAt'],
+        group: 'SEO',
+    },
+    access: {
+        read: access_1.seoAdminAccess,
+        create: access_1.seoAdminAccess,
+        update: access_1.seoAdminAccess,
+        delete: access_1.seoAdminAccess,
+    },
+    fields: [
+        {
+            name: 'capturedAt',
+            type: 'date',
+            required: true,
+            index: true,
+            admin: {
+                date: { pickerAppearance: 'dayAndTime' },
+            },
+        },
+        {
+            name: 'query',
+            type: 'text',
+            required: true,
+        },
+        {
+            name: 'page',
+            type: 'text',
+            required: true,
+        },
+        {
+            name: 'impressions',
+            type: 'number',
+        },
+        {
+            name: 'clicks',
+            type: 'number',
+        },
+        {
+            name: 'ctr',
+            type: 'number',
+        },
+        {
+            name: 'position',
+            type: 'number',
+        },
+        {
+            name: 'source',
+            type: 'select',
+            required: true,
+            defaultValue: 'gsc',
+            options: [
+                { label: 'Google Search Console', value: 'gsc' },
+                { label: 'Manual Import', value: 'manual' },
+            ],
+        },
+    ],
+};

package/dist/collections/SeoPageResults.d.ts

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

package/dist/collections/SeoPageResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoPageResults.d.ts","sourceRoot":"","sources":["../../src/collections/SeoPageResults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,eAAO,MAAM,cAAc,EAAE,gBAqK5B,CAAA"}