Sveltekit Prerender Missing

1// Flag SvelteKit pages that haven't declared prerender/ssr/config — they
2// default to per-request function execution. Pages that have already opted
3// in or out are skipped; the investigator agent decides actual staticness.
4
5export const metadata = {
6  id: 'sveltekit-prerender-missing',
7  title: 'SvelteKit page without explicit prerender / ISR config',
8  severity: 'low',
9  billingDimension: 'function-duration',
10  trafficIndependent: false,
11  description:
12    'SvelteKit page or +page.server.ts is missing an explicit `prerender`, `ssr`, or adapter `config.isr` declaration. Default is per-request function execution — investigate whether the route could be prerendered or ISR-cached.',
13  fix:
14    'If the page is static (no per-user / per-request data), add `export const prerender = true` in +page.ts or +page.server.ts. If the data refreshes on a schedule, prefer adapter-vercel\'s ISR option via `export const config = { isr: { expiration: 60 } }`.',
15  citations: [
16    'https://kit.svelte.dev/docs/page-options',
17    'https://kit.svelte.dev/docs/adapter-vercel',
18    'https://vercel.com/docs/incremental-static-regeneration',
19  ],
20  excludeGlobs: ['node_modules/**', '.svelte-kit/**', 'build/**', '__tests__/**'],
21  includeGlobs: ['src/routes/**/+page.svelte', 'src/routes/**/+page.server.{ts,js}', 'src/routes/+page.svelte', 'src/routes/+page.server.{ts,js}'],
22};
23
24const PRERENDER_RE = /export\s+const\s+prerender\b/;
25const SSR_RE = /export\s+const\s+ssr\b/;
26const CONFIG_RE = /export\s+const\s+config\s*=\s*\{[^}]*\b(isr|prerender|runtime|split|regions)\b/;
27
28export function scan({ files }) {
29  const out = [];
30  for (const { path, content } of files) {
31    if (!path.includes('/routes/')) continue;
32    if (PRERENDER_RE.test(content) || SSR_RE.test(content) || CONFIG_RE.test(content)) continue;
33    out.push({
34      pattern: metadata.id,
35      file: path,
36      // Absence-finding — no specific line, placeholder 1.
37      line: 1,
38      evidence: 'No `prerender`, `ssr`, or `config = { isr | runtime | ... }` export found',
39      trafficIndependent: metadata.trafficIndependent,
40    });
41  }
42  return out;
43}