@absolutejs/absolute 0.19.0-beta.172 → 0.19.0-beta.174

package/ROADMAP.md

@@ -4,29 +4,6 @@ Features missing from AbsoluteJS that Next.js provides, ordered by priority. Eac
 
 ---
 
-## P0 — Static Site Generation (SSG)
-
-**What Next.js does:**
-Pages can be pre-rendered at build time into static HTML. `generateStaticParams()` tells the framework which dynamic routes to pre-render. The output is plain HTML + JS that can be served from a CDN with zero server runtime. Next.js also supports a full `output: 'export'` mode that produces a completely static site.
-
-**What AbsoluteJS has today:**
-Nothing. Every page is rendered at request time via streaming SSR. The `handleHTMLPageRequest` serves pre-written HTML files, but there's no mechanism to run a React/Svelte/Vue component through SSR at build time and save the output.
-
-**What needs to be built:**
-- A `static` option per-route or per-page that tells the build to render the component and write the HTML to disk
-- For dynamic routes, a way to declare the set of params to pre-render (equivalent to `generateStaticParams`)
-- A static export mode that produces a directory of HTML/CSS/JS with no server dependency
-- The build pipeline already has streaming SSR for all frameworks — the core work is calling those renderers during `build()` instead of at request time, and writing the output to files
-- Static pages should still hydrate on the client (same as today, just the initial HTML comes from disk instead of runtime SSR)
-
-**Files likely involved:**
-- `src/core/build.ts` — add a static rendering pass after bundling
-- Each framework's `pageHandler.ts` — extract the rendering logic so it can be called at build time without an HTTP request
-- `src/build/generateManifest.ts` — static pages need manifest entries pointing to `.html` files
-- New: a config option or per-page export to opt into static rendering
-
----
-
 ## P0 — Metadata API / SEO
 
 **What Next.js does:**

package/dist/cli/index.js

@@ -529,12 +529,27 @@ var init_devCert = __esm(() => {
 // src/core/prerender.ts
 var exports_prerender = {};
 __export(exports_prerender, {
+  routeToFilename: () => routeToFilename,
+  rerenderRoute: () => rerenderRoute,
+  readTimestamp: () => readTimestamp,
   prerenderWithServer: () => prerenderWithServer,
-  prerender: () => prerender
+  prerender: () => prerender,
+  PRERENDER_BYPASS_HEADER: () => PRERENDER_BYPASS_HEADER
 });
 import { mkdirSync as mkdirSync3 } from "fs";
 import { join as join5 } from "path";
-var routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1).replace(/\//g, "-")}.html`, crawlRoutes = async (baseUrl, log) => {
+var PRERENDER_BYPASS_HEADER = "X-Absolute-Prerender-Bypass", routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1).replace(/\//g, "-")}.html`, writeTimestamp = async (htmlPath) => {
+  const metaPath = htmlPath.replace(/\.html$/, ".meta");
+  await Bun.write(metaPath, String(Date.now()));
+}, readTimestamp = (htmlPath) => {
+  const metaPath = htmlPath.replace(/\.html$/, ".meta");
+  try {
+    const content = __require("fs").readFileSync(metaPath, "utf-8");
+    return Number(content) || 0;
+  } catch {
+    return 0;
+  }
+}, crawlRoutes = async (baseUrl) => {
   const visited = new Set;
   const queue = ["/"];
   const routes = [];
@@ -563,6 +578,22 @@ var routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1
     } catch {}
   }
   return routes;
+}, rerenderRoute = async (route, port, prerenderDir) => {
+  try {
+    const res = await fetch(`http://localhost:${port}${route}`, {
+      headers: { [PRERENDER_BYPASS_HEADER]: "1" }
+    });
+    if (!res.ok)
+      return false;
+    const html = await res.text();
+    const fileName = routeToFilename(route);
+    const filePath = join5(prerenderDir, fileName);
+    await Bun.write(filePath, html);
+    await writeTimestamp(filePath);
+    return true;
+  } catch {
+    return false;
+  }
 }, prerender = async (port, outDir, staticConfig, log) => {
   const prerenderDir = join5(outDir, "_prerendered");
   mkdirSync3(prerenderDir, { recursive: true });
@@ -570,7 +601,7 @@ var routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1
   let routes;
   if (staticConfig.routes === "all") {
     log?.("Crawling routes...");
-    routes = await crawlRoutes(baseUrl, log);
+    routes = await crawlRoutes(baseUrl);
   } else {
     routes = staticConfig.routes;
   }
@@ -589,6 +620,7 @@ var routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1
       const fileName = routeToFilename(route);
       const filePath = join5(prerenderDir, fileName);
       await Bun.write(filePath, html);
+      await writeTimestamp(filePath);
       result.routes.set(route, filePath);
       log?.(`  Pre-rendered ${route} \u2192 ${fileName} (${html.length} bytes)`);
     } catch {
@@ -637,7 +669,7 @@ import {
   readFileSync as readFileSync7,
   unlinkSync
 } from "fs";
-import { basename as basename3, join as join6, relative, resolve as resolve6 } from "path";
+import { basename as basename2, join as join6, relative, resolve as resolve6 } from "path";
 var cliTag3 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[cli]\x1B[0m ${color}${message}\x1B[0m`, collectFiles2 = (dir) => {
   const results = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
@@ -668,7 +700,7 @@ var cliTag3 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   return;
 }, generateEntrypoint = (distDir, serverEntry, prerenderMap, version2) => {
   const allFiles = collectFiles2(distDir);
-  const serverBundleName = basename3(serverEntry).replace(/\.[^.]+$/, "") + ".js";
+  const serverBundleName = basename2(serverEntry).replace(/\.[^.]+$/, "") + ".js";
   const skip = new Set([
     serverBundleName,
     "manifest.json",
@@ -837,7 +869,7 @@ console.log(\`
 }), FRAMEWORK_EXTERNALS, compile = async (serverEntry, outdir, outfile, configPath2) => {
   const prerenderPort = Number(env3.COMPILE_PORT) || Number(env3.PORT) || DEFAULT_PORT + 1;
   killStaleProcesses(prerenderPort);
-  const entryName = basename3(serverEntry).replace(/\.[^.]+$/, "");
+  const entryName = basename2(serverEntry).replace(/\.[^.]+$/, "");
   const resolvedOutdir = resolve6(outdir ?? "dist");
   const resolvedOutfile = resolve6(outfile ?? "compiled-server");
   const absoluteVersion = resolvePackageVersion2([
@@ -886,7 +918,7 @@ console.log(\`
   }
   console.log(` \x1B[2m(${getDurationString(performance.now() - bundleStart)})\x1B[0m`);
   const prerenderStart = performance.now();
-  console.log(cliTag3("\x1B[36m", "Pre-rendering pages..."));
+  process.stdout.write(cliTag3("\x1B[36m", "Pre-rendering pages"));
   const staticConfig = buildConfig.static ?? { routes: "all" };
   const prerenderResult = await prerenderWithServer(outputPath, prerenderPort, resolvedOutdir, staticConfig, {
     ABSOLUTE_BUILD_DIR: resolvedOutdir,
@@ -894,9 +926,9 @@ console.log(\`
     FORCE_COLOR: "0",
     NODE_ENV: "production",
     ...configPath2 ? { ABSOLUTE_CONFIG: configPath2 } : {}
-  }, (msg) => console.log(cliTag3("\x1B[36m", msg)));
+  });
   const prerenderMap = prerenderResult.routes;
-  console.log(cliTag3("\x1B[36m", `Pre-rendered ${prerenderMap.size} pages (${getDurationString(performance.now() - prerenderStart)})`));
+  console.log(` \x1B[2m(${prerenderMap.size} pages, ${getDurationString(performance.now() - prerenderStart)})\x1B[0m`);
   const compileStart = performance.now();
   process.stdout.write(cliTag3("\x1B[36m", "Compiling standalone executable"));
   const entrypointCode = generateEntrypoint(resolvedOutdir, serverEntry, prerenderMap, absoluteVersion);
@@ -920,7 +952,7 @@ console.log(\`
   const size = (Bun.file(resolvedOutfile).size / 1048576).toFixed(0);
   const totalDuration = getDurationString(performance.now() - totalStart);
   console.log(cliTag3("\x1B[32m", `Compiled to ${resolvedOutfile} (${size}MB) in ${totalDuration}`));
-  console.log(cliTag3("\x1B[2m", `Run with: ./${basename3(resolvedOutfile)}`));
+  console.log(cliTag3("\x1B[2m", `Run with: ./${basename2(resolvedOutfile)}`));
   sendTelemetryEvent("compile:complete", {
     durationMs: Math.round(performance.now() - totalStart),
     entry: serverEntry,
@@ -1803,7 +1835,7 @@ init_telemetryEvent();
 init_utils();
 var {env: env2 } = globalThis.Bun;
 import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
-import { basename as basename2, resolve as resolve5 } from "path";
+import { basename, resolve as resolve5 } from "path";
 var cliTag2 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[cli]\x1B[0m ${color}${message}\x1B[0m`;
 var resolvePackageVersion = (candidates) => {
   for (const candidate of candidates) {
@@ -1857,7 +1889,7 @@ var handleBundleFailure = (serverBundle, bundleStart, serverEntry) => {
 var start = async (serverEntry, outdir, configPath2) => {
   const port = Number(env2.PORT) || DEFAULT_PORT;
   killStaleProcesses(port);
-  const entryName = basename2(serverEntry).replace(/\.[^.]+$/, "");
+  const entryName = basename(serverEntry).replace(/\.[^.]+$/, "");
   const resolvedOutdir = resolve5(outdir ?? "dist");
   const absoluteVersion = resolvePackageVersion([
     resolve5(import.meta.dir, "..", "..", "..", "package.json"),
@@ -1989,7 +2021,7 @@ var start = async (serverEntry, outdir, configPath2) => {
   });
   if (buildConfig.static) {
     const prerenderStart = performance.now();
-    console.log(cliTag2("\x1B[36m", "Pre-rendering static pages..."));
+    process.stdout.write(cliTag2("\x1B[36m", "Pre-rendering static pages"));
     const { prerenderWithServer: prerenderWithServer2 } = await Promise.resolve().then(() => (init_prerender(), exports_prerender));
     const prerenderPort = port + 1;
     try {
@@ -2000,9 +2032,9 @@ var start = async (serverEntry, outdir, configPath2) => {
         FORCE_COLOR: "0",
         NODE_ENV: "production",
         ...configPath2 ? { ABSOLUTE_CONFIG: configPath2 } : {}
-      }, (msg) => console.log(cliTag2("\x1B[36m", msg)));
+      });
       const prerenderDuration = getDurationString(performance.now() - prerenderStart);
-      console.log(cliTag2("\x1B[36m", `Pre-rendered ${result.routes.size} pages (${prerenderDuration})`));
+      console.log(` \x1B[2m(${result.routes.size} pages, ${prerenderDuration})\x1B[0m`);
     } catch (err) {
       console.error(cliTag2("\x1B[33m", "Pre-rendering failed, pages will use SSR."));
       console.error(err);

package/dist/index.js

@@ -205630,6 +205630,137 @@ var init_hmr = __esm(() => {
   init_webSocket();
 });
 
+// src/core/prerender.ts
+var exports_prerender = {};
+__export(exports_prerender, {
+  routeToFilename: () => routeToFilename,
+  rerenderRoute: () => rerenderRoute,
+  readTimestamp: () => readTimestamp,
+  prerenderWithServer: () => prerenderWithServer,
+  prerender: () => prerender,
+  PRERENDER_BYPASS_HEADER: () => PRERENDER_BYPASS_HEADER
+});
+import { mkdirSync as mkdirSync10 } from "fs";
+import { join as join17 } from "path";
+var PRERENDER_BYPASS_HEADER = "X-Absolute-Prerender-Bypass", routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1).replace(/\//g, "-")}.html`, writeTimestamp = async (htmlPath) => {
+  const metaPath = htmlPath.replace(/\.html$/, ".meta");
+  await Bun.write(metaPath, String(Date.now()));
+}, readTimestamp = (htmlPath) => {
+  const metaPath = htmlPath.replace(/\.html$/, ".meta");
+  try {
+    const content = __require("fs").readFileSync(metaPath, "utf-8");
+    return Number(content) || 0;
+  } catch {
+    return 0;
+  }
+}, crawlRoutes = async (baseUrl) => {
+  const visited = new Set;
+  const queue = ["/"];
+  const routes = [];
+  while (queue.length > 0) {
+    const path = queue.shift();
+    if (visited.has(path))
+      continue;
+    visited.add(path);
+    try {
+      const res = await fetch(`${baseUrl}${path}`);
+      if (!res.ok)
+        continue;
+      const contentType = res.headers.get("content-type") ?? "";
+      if (!contentType.includes("text/html"))
+        continue;
+      const html = await res.text();
+      routes.push(path);
+      const linkRegex = /href=["'](\/[^"']*?)["']/g;
+      let match;
+      while ((match = linkRegex.exec(html)) !== null) {
+        const href = match[1] ?? "";
+        if (!href || href.includes(".") || href.includes("#") || visited.has(href))
+          continue;
+        queue.push(href);
+      }
+    } catch {}
+  }
+  return routes;
+}, rerenderRoute = async (route, port, prerenderDir) => {
+  try {
+    const res = await fetch(`http://localhost:${port}${route}`, {
+      headers: { [PRERENDER_BYPASS_HEADER]: "1" }
+    });
+    if (!res.ok)
+      return false;
+    const html = await res.text();
+    const fileName = routeToFilename(route);
+    const filePath = join17(prerenderDir, fileName);
+    await Bun.write(filePath, html);
+    await writeTimestamp(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}, prerender = async (port, outDir, staticConfig, log2) => {
+  const prerenderDir = join17(outDir, "_prerendered");
+  mkdirSync10(prerenderDir, { recursive: true });
+  const baseUrl = `http://localhost:${port}`;
+  let routes;
+  if (staticConfig.routes === "all") {
+    log2?.("Crawling routes...");
+    routes = await crawlRoutes(baseUrl);
+  } else {
+    routes = staticConfig.routes;
+  }
+  const result = {
+    routes: new Map,
+    dir: prerenderDir
+  };
+  for (const route of routes) {
+    try {
+      const res = await fetch(`${baseUrl}${route}`);
+      if (!res.ok) {
+        log2?.(`  Skipped ${route} (HTTP ${res.status})`);
+        continue;
+      }
+      const html = await res.text();
+      const fileName = routeToFilename(route);
+      const filePath = join17(prerenderDir, fileName);
+      await Bun.write(filePath, html);
+      await writeTimestamp(filePath);
+      result.routes.set(route, filePath);
+      log2?.(`  Pre-rendered ${route} \u2192 ${fileName} (${html.length} bytes)`);
+    } catch {
+      log2?.(`  Failed to pre-render ${route}`);
+    }
+  }
+  return result;
+}, prerenderWithServer = async (serverBundlePath, port, outDir, staticConfig, env3, log2) => {
+  const serverProcess = Bun.spawn(["bun", "run", serverBundlePath], {
+    cwd: process.cwd(),
+    env: { ...process.env, ...env3, PORT: String(port) },
+    stdout: "pipe",
+    stderr: "pipe"
+  });
+  let ready = false;
+  for (let i = 0;i < 50; i++) {
+    try {
+      const res = await fetch(`http://localhost:${port}/`);
+      if (res.ok) {
+        ready = true;
+        break;
+      }
+    } catch {}
+    await Bun.sleep(100);
+  }
+  if (!ready) {
+    serverProcess.kill();
+    throw new Error("Server failed to start for pre-rendering");
+  }
+  const result = await prerender(port, outDir, staticConfig, log2);
+  serverProcess.kill();
+  await serverProcess.exited;
+  return result;
+};
+var init_prerender = () => {};
+
 // src/dev/devCert.ts
 var exports_devCert = {};
 __export(exports_devCert, {
@@ -205639,9 +205770,9 @@ __export(exports_devCert, {
   hasCert: () => hasCert,
   ensureDevCert: () => ensureDevCert
 });
-import { existsSync as existsSync17, mkdirSync as mkdirSync10, readFileSync as readFileSync11, rmSync as rmSync2 } from "fs";
+import { existsSync as existsSync17, mkdirSync as mkdirSync11, readFileSync as readFileSync11, rmSync as rmSync2 } from "fs";
 import { platform as platform3 } from "os";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, devLog = (msg) => console.log(`\x1B[2m${new Date().toLocaleTimeString()}\x1B[0m \x1B[36m[dev]\x1B[0m ${msg}`), devWarn = (msg) => console.log(`\x1B[2m${new Date().toLocaleTimeString()}\x1B[0m \x1B[33m[dev]\x1B[0m \x1B[33m${msg}\x1B[0m`), certFilesExist = () => existsSync17(CERT_PATH) && existsSync17(KEY_PATH), isCertExpired = () => {
   try {
     const certPem = readFileSync11(CERT_PATH, "utf-8");
@@ -205713,7 +205844,7 @@ var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, devLog = (msg) => c
     generateSelfSigned();
   }
 }, ensureDevCert = () => {
-  mkdirSync10(CERT_DIR, { recursive: true });
+  mkdirSync11(CERT_DIR, { recursive: true });
   if (hasCert()) {
     return { cert: CERT_PATH, key: KEY_PATH };
   }
@@ -205840,16 +205971,16 @@ var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, devLog = (msg) => c
   }
   rmSync2(CERT_PATH, { force: true });
   rmSync2(KEY_PATH, { force: true });
-  mkdirSync10(CERT_DIR, { recursive: true });
+  mkdirSync11(CERT_DIR, { recursive: true });
   generateWithMkcert();
   console.log("");
   devLog("mkcert installed \u2014 HTTPS certificates are now locally trusted");
   return true;
 };
 var init_devCert = __esm(() => {
-  CERT_DIR = join18(process.cwd(), ".absolutejs");
-  CERT_PATH = join18(CERT_DIR, "cert.pem");
-  KEY_PATH = join18(CERT_DIR, "key.pem");
+  CERT_DIR = join19(process.cwd(), ".absolutejs");
+  CERT_PATH = join19(CERT_DIR, "cert.pem");
+  KEY_PATH = join19(CERT_DIR, "key.pem");
 });
 // types/client.ts
 var hmrState = {
@@ -205877,7 +206008,7 @@ var handleHTMLPageRequest = (pagePath) => file(pagePath);
 var handleHTMXPageRequest = (pagePath) => file(pagePath);
 // src/core/prepare.ts
 import { existsSync as existsSync16, readdirSync as readdirSync2, readFileSync as readFileSync10 } from "fs";
-import { basename as basename9, join as join17, relative as relative10, resolve as resolve23 } from "path";
+import { basename as basename9, join as join18, relative as relative10, resolve as resolve23 } from "path";
 
 // src/utils/loadConfig.ts
 import { resolve } from "path";
@@ -206015,7 +206146,7 @@ var loadPrerenderMap = (prerenderDir) => {
         continue;
       const name = basename9(entry, ".html");
       const route = name === "index" ? "/" : `/${name}`;
-      map.set(route, join17(prerenderDir, entry));
+      map.set(route, join18(prerenderDir, entry));
     }
   } catch {}
   return map;
@@ -206030,15 +206161,33 @@ var prepare = async (configOrPath) => {
   const manifest = JSON.parse(readFileSync10(`${buildDir}/manifest.json`, "utf-8"));
   const { staticPlugin } = await import("@elysiajs/static");
   const staticFiles = staticPlugin({ assets: buildDir, prefix: "" });
-  const prerenderDir = join17(buildDir, "_prerendered");
+  const prerenderDir = join18(buildDir, "_prerendered");
   const prerenderMap = loadPrerenderMap(prerenderDir);
   if (prerenderMap.size > 0) {
     const { Elysia } = await import("elysia");
+    const {
+      PRERENDER_BYPASS_HEADER: PRERENDER_BYPASS_HEADER2,
+      readTimestamp: readTimestamp2,
+      rerenderRoute: rerenderRoute2
+    } = await Promise.resolve().then(() => (init_prerender(), exports_prerender));
+    const revalidateMs = config.static?.revalidate ? config.static.revalidate * 1000 : 0;
+    const port = Number(process.env.PORT) || 3000;
+    const rerendering = new Set;
     const prerenderPlugin = new Elysia({ name: "prerendered-pages" }).onRequest(({ request }) => {
       const url = new URL(request.url);
+      if (request.headers.get(PRERENDER_BYPASS_HEADER2))
+        return;
       const filePath = prerenderMap.get(url.pathname);
       if (!filePath)
         return;
+      if (revalidateMs > 0 && !rerendering.has(url.pathname)) {
+        const renderedAt = readTimestamp2(filePath);
+        const age = Date.now() - renderedAt;
+        if (age > revalidateMs) {
+          rerendering.add(url.pathname);
+          rerenderRoute2(url.pathname, port, prerenderDir).finally(() => rerendering.delete(url.pathname));
+        }
+      }
       return new Response(Bun.file(filePath), {
         headers: { "content-type": "text/html; charset=utf-8" }
       });
@@ -206229,5 +206378,5 @@ export {
   ANGULAR_INIT_TIMEOUT_MS
 };
 
-//# debugId=B51D68800393AB0664756E2164756E21
+//# debugId=D0959AF290C10FEC64756E2164756E21
 //# sourceMappingURL=index.js.map