@orion-studios/payload-seo-audit 1.0.0

package/dist/utilities/scoring.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreSEOIssues = void 0;
+const helpers_1 = require("../utilities/helpers");
+const categories = [
+    'metadata',
+    'indexability',
+    'structure',
+    'links',
+    'media',
+    'structuredData',
+    'performance',
+];
+const scoreCategory = (issues, category) => {
+    const penalty = issues
+        .filter((issue) => issue.category === category)
+        .reduce((sum, issue) => sum + helpers_1.severityWeights[issue.severity], 0);
+    return Math.max(0, Math.min(100, 100 - penalty));
+};
+const scoreSEOIssues = (issues) => {
+    const scores = categories.reduce((acc, category) => {
+        acc[category] = scoreCategory(issues, category);
+        return acc;
+    }, {
+        metadata: 100,
+        indexability: 100,
+        structure: 100,
+        links: 100,
+        media: 100,
+        structuredData: 100,
+        performance: 100,
+    });
+    const weightedOverall = 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;
+    return {
+        ...scores,
+        overall: Math.round(weightedOverall),
+    };
+};
+exports.scoreSEOIssues = scoreSEOIssues;

package/dist/utilities/triggers.d.ts

@@ -0,0 +1,3 @@
+export declare const triggerSeoAuditForCollection: (slug: string) => Promise<void>;
+export declare const triggerSeoAuditForGlobal: (slug: string) => Promise<void>;
+//# sourceMappingURL=triggers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/utilities/triggers.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,4BAA4B,GAAU,MAAM,MAAM,kBAG9D,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAU,MAAM,MAAM,kBAG1D,CAAA"}

package/dist/utilities/triggers.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.triggerSeoAuditForGlobal = exports.triggerSeoAuditForCollection = void 0;
+const SEO_TRIGGER_COLLECTIONS = new Set(['projects', 'services', 'posts', 'authors', 'categories', 'tags']);
+const SEO_TRIGGER_GLOBALS = new Set(['home', 'services-page', 'work-page', 'blog-page', 'about', 'contact']);
+const shouldTriggerFromCollection = (slug) => SEO_TRIGGER_COLLECTIONS.has(slug);
+const shouldTriggerFromGlobal = (slug) => SEO_TRIGGER_GLOBALS.has(slug);
+const getBaseUrl = () => (process.env.NEXT_PUBLIC_SERVER_URL || '').replace(/\/$/, '');
+const triggerSEOAudit = async () => {
+    const baseUrl = getBaseUrl();
+    const secret = process.env.SEO_AUDIT_SECRET;
+    if (!baseUrl || !secret)
+        return;
+    try {
+        await fetch(`${baseUrl}/api/seo/run`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                'x-seo-audit-secret': secret,
+            },
+            body: JSON.stringify({ runType: 'publish-triggered' }),
+        });
+    }
+    catch (error) {
+        console.warn('SEO publish-triggered run failed:', error);
+    }
+};
+const triggerSeoAuditForCollection = async (slug) => {
+    if (!shouldTriggerFromCollection(slug))
+        return;
+    await triggerSEOAudit();
+};
+exports.triggerSeoAuditForCollection = triggerSeoAuditForCollection;
+const triggerSeoAuditForGlobal = async (slug) => {
+    if (!shouldTriggerFromGlobal(slug))
+        return;
+    await triggerSEOAudit();
+};
+exports.triggerSeoAuditForGlobal = triggerSeoAuditForGlobal;

package/dist/utilities/types.d.ts

@@ -0,0 +1,87 @@
+export type SEOIssueSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+export type SEOIssueCategory = 'metadata' | 'indexability' | 'structure' | 'links' | 'media' | 'structuredData' | 'performance';
+export type SEOIssue = {
+    fingerprint: string;
+    ruleID: string;
+    category: SEOIssueCategory;
+    severity: SEOIssueSeverity;
+    message: string;
+    recommendation?: string;
+};
+export type SEOCheckResult = {
+    title?: string;
+    metaDescription?: string;
+    canonical?: string;
+    robotsMeta?: string;
+    h1Count: number;
+    headingOrderIssues: number;
+    internalLinks: number;
+    externalLinks: number;
+    imagesTotal: number;
+    imagesMissingAlt: number;
+    structuredDataBlocks: number;
+    issues: SEOIssue[];
+};
+export type SEOPageScore = {
+    metadata: number;
+    indexability: number;
+    structure: number;
+    links: number;
+    media: number;
+    structuredData: number;
+    performance: number;
+    overall: number;
+};
+export type SEOPageResult = {
+    url: string;
+    path: string;
+    statusCode: number;
+    check: SEOCheckResult;
+    score: SEOPageScore;
+};
+export type SEOSnapshotSummary = {
+    pagesCrawled: number;
+    pagesChecked: number;
+    issueCounts: Record<SEOIssueSeverity, number>;
+    scores: SEOPageScore;
+};
+export type SEOPageSpeedSummary = {
+    averagePerformanceScore?: number;
+    averageLCPMs?: number;
+    averageCLS?: number;
+};
+export type SEOAuditRunType = 'scheduled' | 'manual' | 'publish-triggered';
+export type SEOSiteRecord = {
+    id: number | string;
+    name?: string | null;
+    domain?: string | null;
+    canonicalHost?: string | null;
+    sitemapURL?: string | null;
+    keyURLs?: Array<{
+        url?: string | null;
+    }> | null;
+    crawlSettings?: {
+        maxPages?: number | null;
+        maxDepth?: number | null;
+        requestTimeoutMs?: number | null;
+        includePatterns?: Array<{
+            pattern?: string | null;
+        }> | null;
+        excludePatterns?: Array<{
+            pattern?: string | null;
+        }> | null;
+    } | null;
+    integrations?: {
+        enablePageSpeed?: boolean | null;
+        enableSearchConsole?: boolean | null;
+    } | null;
+    thresholds?: {
+        targetLCPMs?: number | null;
+        targetCLS?: number | null;
+    } | null;
+};
+export type SEOProviderAdapter = {
+    name: string;
+    isConfigured: () => boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/utilities/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@orion-studios/payload-seo-audit",
+  "version": "1.0.0",
+  "description": "Professional SEO audit system for Payload CMS 3.0 + Next.js 15 projects",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "default": "./dist/api/index.js"
+    },
+    "./components": {
+      "types": "./dist/exports/components.d.ts",
+      "default": "./dist/exports/components.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "bin": {
+    "payload-seo-audit": "./bin/init.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "cms",
+    "seo",
+    "audit",
+    "nextjs",
+    "lighthouse",
+    "analytics"
+  ],
+  "author": "Orion Studios",
+  "license": "MIT",
+  "peerDependencies": {
+    "next": "^15.0.0",
+    "payload": "^3.0.0",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "payload": "^3.75.0",
+    "typescript": "^5.6.0"
+  },
+  "dependencies": {
+    "cheerio": "^1.0.0",
+    "googleapis": "^144.0.0",
+    "html2pdf.js": "^0.10.2",
+    "lucide-react": "^0.460.0",
+    "recharts": "^2.15.0"
+  }
+}