npm - @cfdez11/vex - Versions diffs - 0.8.2 → 0.9.0 - Mend

@cfdez11/vex 0.8.2 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (71) hide show

package/dist/bin/vex.js +3 -0
package/dist/client/services/cache.js +1 -0
package/dist/client/services/hmr-client.js +1 -0
package/dist/client/services/html.js +1 -0
package/dist/client/services/hydrate-client-components.js +1 -0
package/dist/client/services/hydrate.js +1 -0
package/dist/client/services/index.js +1 -0
package/dist/client/services/navigation/create-layouts.js +1 -0
package/dist/client/services/navigation/create-navigation.js +1 -0
package/dist/client/services/navigation/index.js +1 -0
package/dist/client/services/navigation/link-interceptor.js +1 -0
package/dist/client/services/navigation/metadata.js +1 -0
package/dist/client/services/navigation/navigate.js +1 -0
package/dist/client/services/navigation/prefetch.js +1 -0
package/dist/client/services/navigation/render-page.js +1 -0
package/dist/client/services/navigation/render-ssr.js +1 -0
package/dist/client/services/navigation/router.js +1 -0
package/dist/client/services/navigation/use-query-params.js +1 -0
package/dist/client/services/navigation/use-route-params.js +1 -0
package/dist/client/services/navigation.js +1 -0
package/dist/client/services/reactive.js +1 -0
package/dist/server/build-static.js +6 -0
package/dist/server/index.js +4 -0
package/dist/server/prebuild.js +1 -0
package/dist/server/utils/cache.js +1 -0
package/dist/server/utils/component-processor.js +68 -0
package/dist/server/utils/data-cache.js +1 -0
package/dist/server/utils/esbuild-plugin.js +1 -0
package/dist/server/utils/files.js +28 -0
package/dist/server/utils/hmr.js +1 -0
package/dist/server/utils/router.js +11 -0
package/dist/server/utils/streaming.js +1 -0
package/dist/server/utils/template.js +1 -0
package/package.json +8 -7
package/bin/vex.js +0 -69
package/client/favicon.ico +0 -0
package/client/services/cache.js +0 -55
package/client/services/hmr-client.js +0 -22
package/client/services/html.js +0 -377
package/client/services/hydrate-client-components.js +0 -97
package/client/services/hydrate.js +0 -25
package/client/services/index.js +0 -9
package/client/services/navigation/create-layouts.js +0 -172
package/client/services/navigation/create-navigation.js +0 -103
package/client/services/navigation/index.js +0 -8
package/client/services/navigation/link-interceptor.js +0 -39
package/client/services/navigation/metadata.js +0 -23
package/client/services/navigation/navigate.js +0 -64
package/client/services/navigation/prefetch.js +0 -43
package/client/services/navigation/render-page.js +0 -45
package/client/services/navigation/render-ssr.js +0 -157
package/client/services/navigation/router.js +0 -48
package/client/services/navigation/use-query-params.js +0 -225
package/client/services/navigation/use-route-params.js +0 -76
package/client/services/navigation.js +0 -6
package/client/services/reactive.js +0 -247
package/server/build-static.js +0 -138
package/server/index.js +0 -135
package/server/prebuild.js +0 -13
package/server/utils/cache.js +0 -89
package/server/utils/component-processor.js +0 -1631
package/server/utils/data-cache.js +0 -62
package/server/utils/delay.js +0 -1
package/server/utils/esbuild-plugin.js +0 -110
package/server/utils/files.js +0 -845
package/server/utils/hmr.js +0 -21
package/server/utils/router.js +0 -375
package/server/utils/streaming.js +0 -324
package/server/utils/template.js +0 -274
/package/{client → dist/client}/app.webmanifest +0 -0
/package/{server → dist/server}/root.html +0 -0

package/server/utils/hmr.js DELETED Viewed

@@ -1,21 +0,0 @@
-/**
- * HMR (Hot Module Replacement) event bus for dev mode (FEAT-03).
- *
- * When a `.html` file changes in dev:
- *   1. The file watcher in `component-processor.js` invalidates the in-memory
- *      caches (processHtmlFileCache, parsedTemplateCache, etc.) and re-generates
- *      the client bundle for that file, then calls `hmrEmitter.emit('reload')`.
- *   2. The SSE endpoint in `index.js` listens on `hmrEmitter` and forwards the
- *      event to all connected browsers.
- *   3. The HMR client script in the browser receives the event and triggers a
- *      full-page reload so the user sees the updated page immediately.
- *
- * Using a single shared EventEmitter avoids coupling the file watcher
- * (component-processor.js) directly to the HTTP server (index.js).
- *
- * This module is a no-op in production — nothing imports it there.
- */
-import { EventEmitter } from "events";
-export const hmrEmitter = new EventEmitter();

package/server/utils/router.js DELETED Viewed

@@ -1,375 +0,0 @@
-import {
-  renderSuspenseComponent,
-  generateReplacementContent,
-} from "./streaming.js";
-import { getCachedComponentHtml, getRevalidateSeconds, revalidateCachedComponentHtml, saveCachedComponentHtml } from "./cache.js";
-import { getPagePath } from "./files.js";
-import { renderPageWithLayout } from "./component-processor.js";
-/**
- * Routes currently being regenerated in the background.
- *
- * When an ISR page is stale we serve the cached version immediately and kick off
- * a background re-render. This Set prevents multiple concurrent requests from
- * all triggering their own regeneration for the same route simultaneously —
- * only the first one wins; the others get the stale cache until it is replaced.
- */
-const revalidatingRoutes = new Set();
-const FALLBACK_ERROR_HTML = `
-  <!DOCTYPE html>
-  <html>
-  <head><title>Error 500</title></head>
-  <body>
-    <h1>Error 500 - Internal Server Error</h1>
-    <p>An unexpected error has occurred.</p>
-    <p><a href="/">Back to home</a></p>
-  </body>
-  </html>
-`;
-/**
- * Sends HTML response
- * @param {import("http").ServerResponse} res
- * @param {number} statusCode
- * @param {string} html
- */
-const sendResponse = (res, statusCode, html) => {
-  res.writeHead(statusCode, { "Content-Type": "text/html" });
-  res.end(html);
-};
-/**
- * Start stream response, sending html and update html chunks
- * @param {import("http").ServerResponse} res
- * @param {string[]} htmlChunks
- */
-const sendStartStreamChunkResponse = (res, statusCode, html, htmlChunks) => {
-  res.writeHead(statusCode, {
-    "Content-Type": "text/html; charset=utf-8",
-    "Transfer-Encoding": "chunked",
-    "X-Content-Type-Options": "nosniff",
-  });
-  sendStreamChunkResponse(res, html, htmlChunks)
-};
-/**
- * Send html and update html chunks
- * @param {import("http").ServerResponse} res
- * @param {string[]} htmlChunks
- */
-const sendStreamChunkResponse = (res, html, htmlChunks) => {
-  res.write(html);
-  htmlChunks.push(html);
-}
-/**
- * Close html and end response
- * @param {import("http").ServerResponse} res
- * @param {string[]} htmlChunks
- */
-const endStreamResponse = (res, htmlChunks) => {
-  res.write("</body></html>");
-  res.end();
-  htmlChunks.push("</body></html>")
-}
-/**
- * Renders a page using SSR, optionally streams suspense components,
- * applies Incremental Static Regeneration (ISR) when enabled,
- * and sends the resulting HTML response to the client.
- *
- * This function supports:
- * - Full server-side rendering
- * - Streaming suspense components
- * - ISR with cache revalidation
- * - Graceful abort handling on client disconnect
- *
- * @async
- * @function renderAndSendPage
- *
- * @param {Object} params
- * @param {string} params.pageName
- *   Name of the page to be rendered (resolved to a server component path).
- *
- * @param {number} [params.statusCode=200]
- *   HTTP status code used for the response.
- *
- * @param {Object} [params.context={}]
- *   Rendering context shared across server components.
- *
- * @param {import("http").IncomingMessage} params.context.req
- *   Incoming HTTP request instance.
- *
- * @param {import("http").ServerResponse} params.context.res
- *   HTTP response instance used to stream or send HTML.
- *
- * @param {Object.<string, any>} [params.context]
- *   Additional arbitrary values exposed to the rendering pipeline.
- *
- * @param {Object} params.route
- *   Matched route configuration.
- *
- * @param {string} params.route.path
- *   Public route path (e.g. "/home").
- *
- * @param {string} params.route.serverPath
- *   Internal server path used for resolution.
- *
- * @param {Object} params.route.meta
- *   Route metadata.
- *
- * @param {boolean} params.route.meta.ssr
- *   Whether the route supports server-side rendering.
- *
- * @param {boolean} params.route.meta.requiresAuth
- *   Indicates if authentication is required.
- *
- * @param {number} params.route.meta.revalidate
- *   ISR revalidation interval in seconds. A value > 0 enables ISR.
- *
- * @returns {Promise<void>}
- *   Resolves once the response has been fully sent.
- *
- * @throws {Error}
- *   Throws if rendering or streaming fails before the response is committed.
- */
-/**
- * Re-renders a stale ISR page and saves the result to cache without sending
- * any HTTP response.
- *
- * Renders with `awaitSuspenseComponents = true` so all Suspense boundaries
- * are resolved synchronously and the full HTML is available in one pass.
- *
- * @param {string} pagePath    - Absolute path to the page .html file.
- * @param {object} context     - Request context (provides req.params for getData).
- * @param {string} cacheKey    - Normalised pathname used as the ISR cache key.
- */
-async function revalidateInBackground(pagePath, context, cacheKey) {
-  try {
-    // awaitSuspenseComponents=true resolves all suspense boundaries synchronously
-    // so we get the complete HTML in a single renderPageWithLayout call.
-    const { html } = await renderPageWithLayout(pagePath, context, true);
-    await saveCachedComponentHtml({ componentPath: cacheKey, html });
-  } catch (error) {
-    console.error(`[ISR] Background revalidation failed for ${cacheKey}:`, error.message);
-  }
-}
-async function renderAndSendPage({
-  pageName,
-  statusCode = 200,
-  context = {},
-  route,
-}) {
-  const pagePath = getPagePath(pageName);
-  const revalidateSeconds = getRevalidateSeconds(route.meta?.revalidate ?? 0);
-  const isISR = revalidateSeconds !== 0;
-  // Normalise the cache key to pathname only
-  // `context.req.url` includes the query string (e.g. `/page?debug=true`).
-  // Using the full URL as a cache key means `/page` and `/page?debug=true`
-  // generate two separate cache entries for the same page content.
-  const isrCacheKey = new URL(context.req.url, "http://x").pathname;
-  if(isISR) {
-    const { html: cachedHtml, isStale } = await getCachedComponentHtml({
-      componentPath: isrCacheKey,
-      revalidateSeconds: revalidateSeconds,
-    });
-    if (cachedHtml && !isStale) {
-      sendResponse(context.res, statusCode, cachedHtml);
-      return;
-    }
-    // Stale-while-revalidate: serve stale content immediately so the
-    // user never waits for a re-render, then regenerate the page in the background.
-    // The lock prevents multiple concurrent requests from all re-rendering at once.
-    if (cachedHtml && isStale) {
-      sendResponse(context.res, statusCode, cachedHtml);
-      if (!revalidatingRoutes.has(isrCacheKey)) {
-        revalidatingRoutes.add(isrCacheKey);
-        revalidateInBackground(pagePath, context, isrCacheKey)
-          .finally(() => revalidatingRoutes.delete(isrCacheKey));
-      }
-      return;
-    }
-  }
-  const { html, suspenseComponents, serverComponents } =
-    await renderPageWithLayout(pagePath, context);
-  // if no suspense components, send immediately
-  if (suspenseComponents.length === 0) {
-    sendResponse(context.res, statusCode, html);
-    if(isISR) {
-      saveCachedComponentHtml({ componentPath: isrCacheKey, html });
-    }
-    return;
-  }
-  const htmlChunks = [];
-  let abortedStream = false;
-  let errorStream = false
-  context.res.on("close", () => abortedStream = true);
-  // send initial HTML (before </body>)
-  const [beforeClosing] = html.split("</body>");
-  sendStartStreamChunkResponse(context.res, 200, beforeClosing, htmlChunks)
-  // stream suspense components
-  const renderPromises = suspenseComponents.map(async (suspenseComponent) => {
-    try {
-      const renderedContent = await renderSuspenseComponent(
-        suspenseComponent,
-        serverComponents
-      );
-      const replacementContent = generateReplacementContent(
-        suspenseComponent.id,
-        renderedContent
-      );
-      sendStreamChunkResponse(context.res, replacementContent, htmlChunks)
-    } catch (error) {
-      console.error(`Error rendering suspense ${suspenseComponent.id}:`, error);
-      const errorContent = generateReplacementContent(
-        suspenseComponent.id,
-        `<div class="text-red-500">Error loading content</div>`
-      );
-      context.res.write(errorContent);
-      errorStream = true;
-    }
-  });
-  await Promise.all(renderPromises);
-  endStreamResponse(context.res, htmlChunks);
-  if(isISR && !abortedStream && !errorStream) {
-    saveCachedComponentHtml({
-      componentPath: isrCacheKey,
-      html: htmlChunks.join("")
-    });
-  }
-}
-/**
- * Handles an incoming HTTP request for a page route.
- *
- * Resolves the appropriate route, builds the rendering context,
- * delegates rendering to `renderAndSendPage`, and ensures that
- * errors are handled gracefully by rendering a fallback error page.
- *
- * @async
- * @function handlePageRequest
- *
- * @param {import("http").IncomingMessage} req
- *   Incoming HTTP request.
- *
- * @param {import("http").ServerResponse} res
- *   HTTP response used to send rendered content.
- *
- * @param {Object|null} route
- *   Matched route definition. If null, a fallback 404 route is used.
- *
- * @param {string} route.path
- *   Public URL path of the route.
- *
- * @param {Object} route.meta
- *   Route metadata used during rendering.
- *
- * @returns {Promise<void>}
- *   Resolves once the response has been fully handled.
- */
-export async function handlePageRequest(req, res, route) {
-  const pageName = route.path.slice(1);
-  const context = { req, res };
-  try {
-    await renderAndSendPage({ pageName, context, route });
-  } catch (e) {
-    console.error(`[500] Error rendering page "${route.path}":`, e);
-    // redirect() in a server script throws a structured error.
-    // Intercept it before the generic 500 handler so the browser gets a proper redirect.
-    if (e.redirect) {
-      res.redirect(e.redirect.statusCode, e.redirect.path);
-      return;
-    }
-    const errorData = {
-      message: e.message || "Internal server error",
-      code: 500,
-      details: "Could not load the requested page",
-      path: route.path,
-      stack: e.stack,
-    };
-    try {
-      await renderAndSendPage({
-        pageName: "error",
-        statusCode: 500,
-        context: {
-          ...context,
-          ...errorData,
-        },
-        route,
-      });
-    } catch (err) {
-      console.warn('error}}}}}}}}}}', err)
-      console.error(`Failed to render error page: ${err.message}`);
-      sendResponse(res, 500, FALLBACK_ERROR_HTML);
-    }
-  }
-}
-/**
- * Handler to mark a cached component or page as stale for ISR-like revalidation.
- *
- * This endpoint allows clients to request that the server invalidate the cached HTML
- * of a specific component or page. The cache will be regenerated automatically
- * on the next request for that component.
- *
- * @async
- * @param {import('express').Request} req - The Express request object. Expects a query parameter `path` specifying the component/page path to revalidate.
- * @param {import('express').Response} res - The Express response object. Will send a JSON response indicating success or failure.
- *
- * @returns {Promise<import('express').Response>} JSON response with:
- *   - 200: { message: string } if the cache was successfully marked as stale
- *   - 400: { error: string } if the required `path` query parameter is missing
- *   - 500: { error: string } if an unexpected error occurs during revalidation
- *
- * @example
- * Client request:
- * POST /revalidate?path=/about
- *
- * Response:
- * {
- *   "message": "Cache for '/about' marked as stale. It will regenerate on next request."
- * }
- */
-export async function revalidatePath(req, res) {
-  try {
-    const componentPath = req.query.path;
-    if (!componentPath) {
-      return res.status(400).json({ error: "Missing 'path' query parameter" });
-    }
-    await revalidateCachedComponentHtml(componentPath);
-    return res.status(200).json({
-      message: `Cache for '${componentPath}' marked as stale. It will regenerate on next request.`
-    });
-  } catch (err) {
-    console.error("Error revalidating cache:", err);
-    return res.status(500).json({ error: "Failed to revalidate cache" });
-  }
-}