@jay-framework/dev-server 0.5.0

package/dist/index.cjs

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const vite = require("vite");
+const stackRouteScanner = require("@jay-framework/stack-route-scanner");
+const stackServerRuntime = require("@jay-framework/stack-server-runtime");
+const vitePlugin = require("@jay-framework/vite-plugin");
+const path = require("node:path");
+async function initRoutes(pagesBaseFolder) {
+  return await stackRouteScanner.scanRoutes(pagesBaseFolder, {
+    jayHtmlFilename: "page.jay-html",
+    compFilename: "page.ts"
+  });
+}
+function defaults(options) {
+  const serverBase = options.serverBase || process.env.BASE || "/";
+  const pagesBase = path.resolve(serverBase, options.pagesBase || "./src/pages");
+  const tsConfigFilePath = options.jayRollupConfig.tsConfigFilePath || path.resolve(serverBase, "./tsconfig.json");
+  return {
+    serverBase,
+    pagesBase,
+    dontCacheSlowly: options.dontCacheSlowly,
+    jayRollupConfig: {
+      ...options.jayRollupConfig || {},
+      tsConfigFilePath
+    }
+  };
+}
+function handleOtherResponseCodes(res, renderedResult) {
+  if (renderedResult.kind === `ServerError`)
+    res.status(renderedResult.status).end("server error");
+  else if (renderedResult.kind === `ClientError`)
+    res.status(renderedResult.status).end("client error");
+  else
+    res.status(renderedResult.status).end("redirect to " + renderedResult.location);
+}
+function mkRoute(route, vite2, slowlyPhase, options) {
+  const path2 = stackRouteScanner.routeToExpressRoute(route);
+  const handler = async (req, res) => {
+    try {
+      const url = req.originalUrl.replace(options.serverBase, "");
+      const pageParams = req.params;
+      const pageProps = {
+        language: "en",
+        url
+      };
+      let viewState, carryForward;
+      const pageParts = await stackServerRuntime.loadPageParts(
+        vite2,
+        route,
+        options.pagesBase,
+        options.jayRollupConfig
+      );
+      if (pageParts.val) {
+        const renderedSlowly = await slowlyPhase.runSlowlyForPage(
+          pageParams,
+          pageProps,
+          pageParts.val
+        );
+        if (renderedSlowly.kind === "PartialRender") {
+          const renderedFast = await stackServerRuntime.renderFastChangingData(
+            pageParams,
+            pageProps,
+            renderedSlowly.carryForward,
+            pageParts.val
+          );
+          if (renderedFast.kind === "PartialRender") {
+            viewState = { ...renderedSlowly.rendered, ...renderedFast.rendered };
+            carryForward = renderedFast.carryForward;
+            const pageHtml = stackServerRuntime.generateClientScript(
+              viewState,
+              carryForward,
+              pageParts.val,
+              route.jayHtmlPath
+            );
+            const compiledPageHtml = await vite2.transformIndexHtml(
+              !!url ? url : "/",
+              pageHtml
+            );
+            res.status(200).set({ "Content-Type": "text/html" }).send(compiledPageHtml);
+          } else {
+            handleOtherResponseCodes(res, renderedFast);
+          }
+        } else if (renderedSlowly.kind === "ClientError") {
+          handleOtherResponseCodes(res, renderedSlowly);
+        }
+      } else {
+        console.log(pageParts.validations.join("\n"));
+        res.status(500).end(pageParts.validations.join("\n"));
+      }
+    } catch (e) {
+      vite2?.ssrFixStacktrace(e);
+      console.log(e.stack);
+      res.status(500).end(e.stack);
+    }
+  };
+  return { path: path2, handler };
+}
+async function mkDevServer(options) {
+  const { serverBase, pagesBase, jayRollupConfig, dontCacheSlowly } = defaults(options);
+  const vite$1 = await vite.createServer({
+    server: { middlewareMode: true },
+    plugins: [vitePlugin.jayRuntime(jayRollupConfig)],
+    appType: "custom",
+    base: serverBase,
+    root: pagesBase
+  });
+  const routes = await initRoutes(pagesBase);
+  const slowlyPhase = new stackServerRuntime.DevSlowlyChangingPhase(dontCacheSlowly);
+  const devServerRoutes = routes.map(
+    (route) => mkRoute(route, vite$1, slowlyPhase, options)
+  );
+  return {
+    server: vite$1.middlewares,
+    viteServer: vite$1,
+    routes: devServerRoutes
+  };
+}
+exports.mkDevServer = mkDevServer;

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { Connect, ViteDevServer } from 'vite';
+import { RequestHandler } from 'express-serve-static-core';
+import { JayRollupConfig } from '@jay-framework/rollup-plugin';
+
+interface DevServerOptions {
+    serverBase?: string;
+    pagesBase?: string;
+    jayRollupConfig: JayRollupConfig;
+    dontCacheSlowly: boolean;
+}
+
+interface DevServerRoute {
+    path: string;
+    handler: RequestHandler;
+}
+interface DevServer {
+    server: Connect.Server;
+    viteServer: ViteDevServer;
+    routes: DevServerRoute[];
+}
+declare function mkDevServer(options: DevServerOptions): Promise<DevServer>;
+
+export { type DevServer, type DevServerOptions, type DevServerRoute, mkDevServer };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@jay-framework/dev-server",
+  "version": "0.5.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "dist/index.cjs",
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "npm run build:js && npm run build:types",
+    "build:watch": "npm run build:js -- --watch & npm run build:types -- --watch",
+    "build:js": "vite build",
+    "build:types": "tsup lib/index.ts --dts-only --format esm",
+    "build:check-types": "tsc",
+    "test-definitions": "jay-cli definitions test",
+    "test-runtime": "jay-cli runtime test",
+    "clean": "rimraf dist",
+    "confirm": "npm run clean && npm run build && npm run build:check-types && npm run test",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@jay-framework/component": "workspace:^",
+    "@jay-framework/fullstack-component": "workspace:^",
+    "@jay-framework/runtime": "workspace:^",
+    "@jay-framework/stack-client-runtime": "workspace:^",
+    "@jay-framework/stack-route-scanner": "workspace:^",
+    "@jay-framework/stack-server-runtime": "workspace:^",
+    "vite": "^5.0.11"
+  },
+  "devDependencies": {
+    "@jay-framework/dev-environment": "workspace:^",
+    "@jay-framework/jay-cli": "workspace:^",
+    "@jay-framework/stack-client-runtime": "workspace:^",
+    "@types/express": "^5.0.2",
+    "@types/node": "^22.15.21",
+    "nodemon": "^3.0.3",
+    "replace-in-file": "^7.1.0",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.1"
+  }
+}