@cfdez11/vex 0.8.2 → 0.9.0

package/server/index.js

@@ -1,135 +0,0 @@
-import "dotenv/config";
-import express from "express";
-import path from "path";
-import { pathToFileURL } from "url";
-import { handlePageRequest, revalidatePath } from "./utils/router.js";
-import { initializeDirectories, CLIENT_DIR, USER_GENERATED_DIR } from "./utils/files.js";
-
-await initializeDirectories();
-
-let serverRoutes;
-
-if (process.env.NODE_ENV === "production") {
-  try {
-    const routesPath = path.join(process.cwd(), ".vexjs", "_routes.js");
-    const { routes } = await import(pathToFileURL(routesPath).href);
-    serverRoutes = routes;
-    console.log("Routes loaded.");
-  } catch {
-    console.error("ERROR: No build found. Run 'vex build' before starting in production.");
-    process.exit(1);
-  }
-} else {
-  const { build } = await import("./utils/component-processor.js");
-  const result = await build();
-  console.log("Components and routes generated.");
-  serverRoutes = result.serverRoutes;
-}
-
-const app = express();
-
-// Serve generated client component bundles at /_vexjs/_components/
-app.use(
-  "/_vexjs/_components",
-  express.static(path.join(process.cwd(), ".vexjs", "_components"), {
-    setHeaders(res, filePath) {
-      if (filePath.endsWith(".js")) {
-        res.setHeader("Content-Type", "application/javascript");
-      }
-    },
-  })
-);
-
-// Serve framework runtime JS + generated files (_routes.js) at /_vexjs/services/
-// initializeDirectories() pre-populates this dir with framework files; build()
-// adds generated files (_routes.js). Single source of truth for all /_vexjs/services/*.
-app.use(
-  "/_vexjs/services",
-  express.static(path.join(process.cwd(), ".vexjs", "services"), {
-    setHeaders(res, filePath) {
-      if (filePath.endsWith(".js")) {
-        res.setHeader("Content-Type", "application/javascript");
-      }
-    },
-  })
-);
-
-// Serve pre-bundled user JS utility files at /_vexjs/user/
-// Registered before the generic /_vexjs mount so requests don't fall through
-// to CLIENT_DIR unnecessarily. esbuild bundles each file with npm packages
-// inlined; vex/*, @/*, and relative user imports stay external (singletons).
-app.use(
-  "/_vexjs/user",
-  express.static(USER_GENERATED_DIR, {
-    setHeaders(res, filePath) {
-      if (filePath.endsWith(".js")) {
-        res.setHeader("Content-Type", "application/javascript");
-      }
-    },
-  })
-);
-
-// Serve static framework assets (favicon.ico, app.webmanifest) from CLIENT_DIR.
-// Runtime JS files (reactive.js, index.js, etc.) are already in .vexjs/services/
-// via initializeDirectories() and are served by the /_vexjs/services route above.
-app.use(
-  "/_vexjs",
-  express.static(CLIENT_DIR, {
-    setHeaders(res, filePath) {
-      if (filePath.endsWith(".js")) {
-        res.setHeader("Content-Type", "application/javascript");
-      }
-    },
-  })
-);
-
-// Serve user's public directory at /
-app.use("/", express.static(path.join(process.cwd(), "public")));
-
-app.get("/revalidate", revalidatePath);
-
-// HMR SSE endpoint — dev only
-if (process.env.NODE_ENV !== "production") {
-  const { hmrEmitter } = await import("./utils/hmr.js");
-
-  app.get("/_vexjs/hmr", (req, res) => {
-    res.setHeader("Content-Type", "text/event-stream");
-    res.setHeader("Cache-Control", "no-cache");
-    res.setHeader("Connection", "keep-alive");
-    res.flushHeaders();
-
-    const onReload = (filename) => {
-      res.write(`event: reload\ndata: ${filename}\n\n`);
-    };
-
-    hmrEmitter.on("reload", onReload);
-    req.on("close", () => hmrEmitter.off("reload", onReload));
-  });
-}
-
-const registerSSRRoutes = (app, routes) => {
-  routes.forEach((route) => {
-    app.get(
-      route.serverPath,
-      async (req, res) => await handlePageRequest(req, res, route)
-    );
-  });
-};
-
-registerSSRRoutes(app, serverRoutes);
-
-app.use(async (req, res) => {
-  const notFoundRoute = serverRoutes.find((r) => r.isNotFound);
-  if (notFoundRoute) {
-    return handlePageRequest(req, res, notFoundRoute);
-  }
-
-  res.status(404).send("Page not found");
-});
-
-const PORT = process.env.VEX_PORT || process.env.PORT || 3001;
-app.listen(PORT, () => {
-  console.log(`Server running on port ${PORT}`);
-});
-
-export default app;

package/server/prebuild.js

@@ -1,13 +0,0 @@
-import "dotenv/config";
-import { build } from "./utils/component-processor.js";
-import { initializeDirectories } from "./utils/files.js";
-
-console.log("🔨 Starting prebuild...");
-
-console.log("📁 Creating directories...");
-await initializeDirectories();
-
-console.log("⚙️  Generating components and routes...");
-await build();
-
-console.log("✅ Prebuild complete!");

package/server/utils/cache.js

@@ -1,89 +0,0 @@
-import { getComponentHtmlDisk, markComponentHtmlStale, saveComponentHtmlDisk } from "./files.js";
-
-/**
- * Retrieves cached HTML for a component or page from disk and determines if it is stale.
- * 
- * This function supports Incremental Static Regeneration (ISR) semantics:
- * - If the cache does not exist, `html` will be null.
- * - If the cache exists, `isStale` indicates whether the cached HTML should be regenerated.
- *
- * @async
- * @param {Object} options
- * @param {string} options.componentPath - Unique identifier or path of the component/page to retrieve.
- * @param {number} [options.revalidateSeconds=0] - Number of seconds before the cached HTML is considered stale.
- *    - `-1` indicates the cache never becomes stale (always fresh).
- *    - `0` indicates the cache is always stale (regenerate on every request).
- * @returns {Promise<{ html: string|null, isStale: boolean }>} 
- *    - `html`: The cached HTML content, or null if not cached.
- *    - `isStale`: True if the cache is stale or explicitly invalidated, false otherwise.
- */
-export async function getCachedComponentHtml({ componentPath, revalidateSeconds = 0 }) {
-  const { html, meta } =  await getComponentHtmlDisk({ componentPath, revalidateSeconds });
-
-  if (!html) {
-    return { html: null };
-  }
-
-  let staleByTime = false;
-  if (revalidateSeconds !== -1) {
-    staleByTime = Date.now() - meta.generatedAt > revalidateSeconds * 1000;
-  }
-
-  const isStale = meta.isStale === true || staleByTime;
-
-  return { html, isStale };
-}
-
-/**
- * Stores HTML content of a component/page on disk along with metadata.
- * 
- * Metadata includes:
- * - `generatedAt`: Timestamp of when the HTML was generated
- * - `isStale`: Indicates if the cache is stale (always false when saving)
- *
- * @async
- * @param {Object} options
- * @param {string} options.componentPath - Unique identifier or path of the component/page to cache.
- * @param {string} options.html - The HTML content to store in the cache.
- * @returns {Promise<void>} Resolves when the HTML and metadata have been successfully saved.
- */
-export async function saveCachedComponentHtml({ componentPath, html }) {
-  await saveComponentHtmlDisk({ componentPath, html });
-}
-
-/**
- * Marks a cached component as stale without regenerating it.
- * 
- * This is useful for manual revalidation or triggering ISR.
- *
- * @async
- * @param {string} componentPath - Unique identifier or path of the component/page to invalidate.
- * @returns {Promise<void>} Resolves when the cache metadata has been updated.
- */
-export async function revalidateCachedComponentHtml(componentPath) {
-  await markComponentHtmlStale({ componentPath });
-}
-
-/**
- * Converts a revalidation setting into seconds for ISR purposes.
- *
- * @param {number|boolean|string} revalidate - Revalidation setting.
- *   - If a number, it represents the number of seconds before the cache becomes stale.
- *   - If `true`, defaults to 60 seconds.
- *   - If `0`, cache is always stale.
- *   - If `false` or `"never"`, cache never becomes stale.
- * @returns {number} Number of seconds for revalidation, or -1 for no revalidation.
- */
-export function getRevalidateSeconds(revalidate) {
-  if (typeof revalidate === "number") {
-    return revalidate;
-  } if (typeof revalidate === "string" && !Number.isNaN(Number(revalidate))) {
-    return Number(revalidate);
-  }else if (revalidate === true) {
-    return 60; // default to 60 seconds
-  } else if (revalidate === 'never' || revalidate === false) {
-    return -1; // never revalidate
-  } else {
-    return 0; // always revalidate
-  } 
-}