@consilioweb/payload-seo-analyzer 1.16.0 → 1.17.0

package/README.md

@@ -724,10 +724,12 @@ The site-wide audit (`/admin/seo` dashboard) is the heaviest operation. On const
 
 | Env var | Default | Purpose |
 |---|---|---|
-| `SEO_AUDIT_BATCH_SIZE` | `15` | Documents processed per batch. Lower it on very small hosts. |
+| `SEO_AUDIT_BATCH_SIZE` | `10` | Documents processed per batch. Lower it on very small hosts. |
+| `SEO_AUDIT_BATCH_DELAY_MS` | `100` | **Pause between batches** — throttles CPU so the build never saturates the site. Raise it (e.g. `300`) on the tiniest shared hosts; lower it (`0`) for speed on a beefy server. |
+| `SEO_AUDIT_DEPTH` | `1` | Relationship depth when loading docs. Set `0` to cut memory/CPU (image-dimension sub-checks then see IDs, a minor score difference). |
 | `SEO_AUDIT_MAX_DOCS` | `1500` | Hard cap on documents audited. |
 
-For the lowest-memory tiers you can also set `features: { warmCache: false }` to skip the startup/hourly pre-load entirely.
+The audit runs **single-flight in the background and throttled** — a constrained host (Infomaniak) stays responsive while it builds, then the dashboard polls until ready. If it still feels heavy, raise `SEO_AUDIT_BATCH_DELAY_MS` and/or set `SEO_AUDIT_DEPTH=0`. For the lowest-memory tiers you can also set `features: { warmCache: false }` to skip the startup/hourly pre-load entirely.
 
 <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="line">
 

package/dist/index.cjs

@@ -1686,8 +1686,11 @@ var CACHE_KEY = "audit";
 var auditBuildsInFlight = /* @__PURE__ */ new Set();
 async function buildAuditCache(payload, collections, globals, seoConfig, reqLocale) {
   const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig, { reqLocale });
-  const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "15", 10) || 15));
+  const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "10", 10) || 10));
   const MAX_DOCS2 = Math.max(1, parseInt(process.env.SEO_AUDIT_MAX_DOCS || "1500", 10) || 1500);
+  const BATCH_DELAY_MS = Math.min(5e3, Math.max(0, parseInt(process.env.SEO_AUDIT_BATCH_DELAY_MS || "100", 10) || 0));
+  const rawDepth = parseInt(process.env.SEO_AUDIT_DEPTH ?? "1", 10);
+  const DEPTH = Number.isNaN(rawDepth) ? 1 : Math.min(2, Math.max(0, rawDepth));
   const allResults = [];
   let capped = false;
   collectionsLoop:
@@ -1700,7 +1703,7 @@ async function buildAuditCache(payload, collections, globals, seoConfig, reqLoca
             collection: collectionSlug,
             limit: BATCH_SIZE,
             page,
-            depth: 1,
+            depth: DEPTH,
             overrideAccess: true
           });
           for (const doc of result.docs) {
@@ -1720,7 +1723,7 @@ async function buildAuditCache(payload, collections, globals, seoConfig, reqLoca
           }
           hasMore = result.hasNextPage;
           page++;
-          await new Promise((resolve) => setImmediate(resolve));
+          await new Promise((resolve) => setTimeout(resolve, BATCH_DELAY_MS));
         }
       } catch {
       }

package/dist/index.js

@@ -1684,8 +1684,11 @@ var CACHE_KEY = "audit";
 var auditBuildsInFlight = /* @__PURE__ */ new Set();
 async function buildAuditCache(payload, collections, globals, seoConfig, reqLocale) {
   const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig, { reqLocale });
-  const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "15", 10) || 15));
+  const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "10", 10) || 10));
   const MAX_DOCS2 = Math.max(1, parseInt(process.env.SEO_AUDIT_MAX_DOCS || "1500", 10) || 1500);
+  const BATCH_DELAY_MS = Math.min(5e3, Math.max(0, parseInt(process.env.SEO_AUDIT_BATCH_DELAY_MS || "100", 10) || 0));
+  const rawDepth = parseInt(process.env.SEO_AUDIT_DEPTH ?? "1", 10);
+  const DEPTH = Number.isNaN(rawDepth) ? 1 : Math.min(2, Math.max(0, rawDepth));
   const allResults = [];
   let capped = false;
   collectionsLoop:
@@ -1698,7 +1701,7 @@ async function buildAuditCache(payload, collections, globals, seoConfig, reqLoca
             collection: collectionSlug,
             limit: BATCH_SIZE,
             page,
-            depth: 1,
+            depth: DEPTH,
             overrideAccess: true
           });
           for (const doc of result.docs) {
@@ -1718,7 +1721,7 @@ async function buildAuditCache(payload, collections, globals, seoConfig, reqLoca
           }
           hasMore = result.hasNextPage;
           page++;
-          await new Promise((resolve) => setImmediate(resolve));
+          await new Promise((resolve) => setTimeout(resolve, BATCH_DELAY_MS));
         }
       } catch {
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@consilioweb/payload-seo-analyzer",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Payload CMS SEO plugin — 50+ checks, dashboard, Lexical JSON support, Flesch FR/EN readability, i18n",
   "type": "module",
   "main": "./dist/index.cjs",