@cedarjs/vite 4.0.1-next.0 → 4.1.0-rc.70

package/dist/apiDevServer.d.ts

@@ -0,0 +1,18 @@
+import type { ViteDevServer } from 'vite';
+/**
+ * Start the Cedar API dev server using Vite's SSR module runner for HMR.
+ *
+ * This replaces the previous system of:
+ *   nodemon → api-server-watch (chokidar + esbuild + forked child process)
+ *
+ * With:
+ *   Vite SSR dev server (module graph + HMR) + Fastify (same process)
+ *
+ * When API source files change, Vite invalidates the affected modules and
+ * re-loads them on the next call – no process restart needed.
+ */
+export declare function startApiDevServer(port: number): Promise<{
+    viteServer: ViteDevServer;
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=apiDevServer.d.ts.map

package/dist/apiDevServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiDevServer.d.ts","sourceRoot":"","sources":["../src/apiDevServer.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,MAAM,CAAA;AAsLrD;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAC,CAiCD"}

package/dist/apiDevServer.js

@@ -0,0 +1,335 @@
+import { glob } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import fastifyUrlData from "@fastify/url-data";
+import ansis from "ansis";
+import fastify from "fastify";
+import fastifyRawBody from "fastify-raw-body";
+import { createServer as createViteServer, normalizePath } from "vite";
+import { requestHandler } from "@cedarjs/api-server/requestHandlers";
+import {
+  getApiSideBabelPlugins,
+  transformWithBabel
+} from "@cedarjs/babel-config";
+import { getAsyncStoreInstance } from "@cedarjs/context/dist/store";
+import { createGraphQLYoga } from "@cedarjs/graphql-server";
+import { getConfig, getPaths, projectSideIsEsm } from "@cedarjs/project-config";
+import { getWorkspacePackageAliases } from "./lib/workspacePackageAliases.js";
+const LAMBDA_FUNCTIONS = {};
+let graphqlYoga = null;
+let loadApiFunctionsInFlight = null;
+let needsReloadAfterInFlight = false;
+async function loadApiFunctions(viteServer) {
+  if (loadApiFunctionsInFlight) {
+    needsReloadAfterInFlight = true;
+    return;
+  }
+  do {
+    needsReloadAfterInFlight = false;
+    loadApiFunctionsInFlight = internalLoadApiFunctions(viteServer);
+    try {
+      await loadApiFunctionsInFlight;
+    } finally {
+      loadApiFunctionsInFlight = null;
+    }
+  } while (needsReloadAfterInFlight);
+}
+async function internalLoadApiFunctions(viteServer) {
+  const cedarPaths = getPaths();
+  for (const key of Object.keys(LAMBDA_FUNCTIONS)) {
+    delete LAMBDA_FUNCTIONS[key];
+  }
+  let srcFunctions = [];
+  try {
+    srcFunctions = await Array.fromAsync(
+      glob("**/*.{ts,tsx,js,jsx}", {
+        cwd: cedarPaths.api.functions,
+        exclude: [
+          "**/*.test.{ts,tsx,js,jsx}",
+          "**/*.scenarios.{ts,tsx,js,jsx}",
+          "**/*.fixtures.{ts,tsx,js,jsx}",
+          "**/*.d.ts"
+        ]
+      }),
+      (entry) => path.join(cedarPaths.api.functions, entry)
+    );
+  } catch {
+    srcFunctions = [];
+  }
+  const graphqlFunctionIndex = srcFunctions.findIndex(
+    (f) => path.basename(f).startsWith("graphql.")
+  );
+  if (graphqlFunctionIndex > 0) {
+    const [graphqlFn] = srcFunctions.splice(graphqlFunctionIndex, 1);
+    srcFunctions.unshift(graphqlFn);
+  }
+  console.log(ansis.dim.italic("Importing Server Functions... "));
+  const tsImport = Date.now();
+  let extractedGraphqlOptions = null;
+  const imports = srcFunctions.map(async (fnPath) => {
+    const ts = Date.now();
+    const routeName = path.basename(fnPath).replace(/\.(ts|tsx|js|jsx)$/, "");
+    try {
+      const mod = await viteServer.ssrLoadModule(pathToFileURL(fnPath).href);
+      const handler = (() => {
+        if ("handler" in mod) {
+          return mod.handler;
+        }
+        if ("default" in mod && mod.default && "handler" in mod.default) {
+          return mod.default.handler;
+        }
+        return void 0;
+      })();
+      if (handler) {
+        LAMBDA_FUNCTIONS[routeName] = handler;
+        console.log(
+          ansis.magenta("/" + routeName),
+          ansis.dim.italic(Date.now() - ts + " ms")
+        );
+      } else {
+        console.warn(
+          `[apiDevServer] No handler export found in function: ${fnPath}`
+        );
+      }
+      if (routeName === "graphql" && "__rw_graphqlOptions" in mod) {
+        extractedGraphqlOptions = mod.__rw_graphqlOptions;
+      }
+    } catch (err) {
+      viteServer.ssrFixStacktrace(err);
+      console.error(
+        `[apiDevServer] Failed to load function "${routeName}" from ${fnPath}:`,
+        err
+      );
+    }
+  });
+  await Promise.all(imports);
+  if (extractedGraphqlOptions) {
+    const { yoga } = await createGraphQLYoga(extractedGraphqlOptions);
+    graphqlYoga = yoga;
+  }
+  console.log(
+    ansis.dim.italic("...Done importing in " + (Date.now() - tsImport) + " ms")
+  );
+}
+function createFetchRequestFromFastify(req) {
+  const requestBody = req.method === "GET" || req.method === "HEAD" ? void 0 : typeof req.body === "string" ? req.body : req.body ? JSON.stringify(req.body) : void 0;
+  const href = `${req.protocol}://${req.host}${req.raw.url ?? "/"}`;
+  return new Request(href, {
+    method: req.method,
+    headers: req.headers,
+    body: requestBody
+  });
+}
+async function startApiDevServer(port) {
+  const cedarPaths = getPaths();
+  const cedarConfig = getConfig();
+  const apiPort = port || cedarConfig.api.port || 8911;
+  const apiHost = cedarConfig.api.host || "::";
+  const isEsm = projectSideIsEsm("api");
+  const normalizedBase = normalizePath(cedarPaths.base);
+  const normalizedApiSrc = normalizePath(cedarPaths.api.src);
+  const normalizedApiBase = normalizePath(cedarPaths.api.base);
+  const viteServer = await createViteDevServer(
+    cedarPaths,
+    cedarConfig,
+    isEsm,
+    normalizedBase
+  );
+  console.log(ansis.dim.italic("Starting API dev server..."));
+  await loadApiFunctions(viteServer);
+  setupHmrHandlers(viteServer, normalizedApiSrc, normalizedApiBase);
+  const app = await createFastifyApp(apiPort, apiHost);
+  const close = async () => {
+    await app.close();
+    await viteServer.close();
+  };
+  return { viteServer, close };
+}
+async function createViteDevServer(cedarPaths, cedarConfig, projectIsEsm, normalizedBase) {
+  const babelPlugins = getApiSideBabelPlugins({
+    openTelemetry: (cedarConfig.experimental?.opentelemetry?.enabled ?? false) && (cedarConfig.experimental?.opentelemetry?.wrapApi ?? false),
+    projectIsEsm
+  });
+  const workspacePkgSourceMap = Object.fromEntries(
+    Object.entries(getWorkspacePackageAliases(cedarPaths, cedarConfig)).map(
+      ([name, sourceFile]) => [name, normalizePath(sourceFile)]
+    )
+  );
+  const viteServer = await createViteServer({
+    configFile: false,
+    root: cedarPaths.api.base,
+    appType: "custom",
+    clearScreen: false,
+    logLevel: "warn",
+    server: {
+      middlewareMode: true
+    },
+    resolve: {
+      // Map workspace package names directly to their TypeScript source entry
+      // files. This is processed by Vite's built-in alias plugin (enforce:
+      // 'pre') which runs before vite:resolve and correctly intercepts imports
+      // in the SSR module runner context.
+      alias: workspacePkgSourceMap
+    },
+    plugins: [
+      {
+        name: "cedar-api-babel-transform",
+        async transform(_code, id) {
+          if (!/\.(ts|tsx|js|jsx)$/.test(id)) {
+            return null;
+          }
+          if (id.includes("node_modules")) {
+            return null;
+          }
+          if (!id.startsWith(normalizedBase)) {
+            return null;
+          }
+          try {
+            const result = await transformWithBabel(id, babelPlugins);
+            if (!result?.code) {
+              return null;
+            }
+            return {
+              code: result.code,
+              map: result.map ?? null
+            };
+          } catch (err) {
+            this.warn(
+              `[cedar-api-babel-transform] Failed to transform ${id}: ${String(err)}`
+            );
+            return null;
+          }
+        }
+      }
+    ]
+  });
+  return viteServer;
+}
+function invalidateApiModules(viteServer, normalizedApiSrc) {
+  const invalidated = /* @__PURE__ */ new Set();
+  const invalidateWithImporters = (mod) => {
+    if (!mod || invalidated.has(mod.id ?? mod.url)) {
+      return;
+    }
+    invalidated.add(mod.id ?? mod.url);
+    viteServer.moduleGraph.invalidateModule(mod);
+    for (const importer of mod.importers) {
+      invalidateWithImporters(importer);
+    }
+  };
+  for (const mod of viteServer.moduleGraph.idToModuleMap.values()) {
+    if (mod.id?.startsWith(normalizedApiSrc)) {
+      invalidateWithImporters(mod);
+    }
+  }
+}
+function setupHmrHandlers(viteServer, normalizedApiSrc, normalizedApiBase) {
+  viteServer.watcher.on("change", async (filePath) => {
+    const normalizedFilePath = normalizePath(filePath);
+    if (!normalizedFilePath.startsWith(normalizedApiSrc)) {
+      return;
+    }
+    const displayPath = path.relative(normalizedApiBase, normalizedFilePath);
+    console.log(ansis.dim(`[change] ${displayPath}`));
+    const fileUrl = pathToFileURL(normalizedFilePath).href;
+    const mod = viteServer.moduleGraph.getModuleById(normalizedFilePath) ?? viteServer.moduleGraph.getModuleById(fileUrl);
+    if (mod) {
+      const invalidated = /* @__PURE__ */ new Set();
+      const invalidateWithImporters = (m) => {
+        if (!m || invalidated.has(m.id ?? m.url)) {
+          return;
+        }
+        invalidated.add(m.id ?? m.url);
+        viteServer.moduleGraph.invalidateModule(m);
+        for (const importer of m.importers) {
+          invalidateWithImporters(importer);
+        }
+      };
+      invalidateWithImporters(mod);
+    }
+    await loadApiFunctions(viteServer);
+  });
+  viteServer.watcher.on("add", async (filePath) => {
+    const normalizedFilePath = normalizePath(filePath);
+    if (!normalizedFilePath.startsWith(normalizedApiSrc)) {
+      return;
+    }
+    console.log(
+      ansis.dim(
+        `[add] ${path.relative(normalizedApiBase, normalizedFilePath)}`
+      )
+    );
+    invalidateApiModules(viteServer, normalizedApiSrc);
+    await loadApiFunctions(viteServer);
+  });
+  viteServer.watcher.on("unlink", async (filePath) => {
+    const normalizedFilePath = normalizePath(filePath);
+    if (!normalizedFilePath.startsWith(normalizedApiSrc)) {
+      return;
+    }
+    console.log(
+      ansis.dim(
+        `[unlink] ${path.relative(normalizedApiBase, normalizedFilePath)}`
+      )
+    );
+    invalidateApiModules(viteServer, normalizedApiSrc);
+    await loadApiFunctions(viteServer);
+  });
+}
+async function createFastifyApp(apiPort, apiHost) {
+  const logLevel = process.env.NODE_ENV === "development" ? "debug" : "info";
+  const app = fastify({ logger: { level: logLevel } });
+  await app.register(fastifyRawBody);
+  app.register(fastifyUrlData);
+  app.addContentTypeParser(
+    ["application/x-www-form-urlencoded", "multipart/form-data"],
+    { parseAs: "string" },
+    app.defaultTextParser
+  );
+  const lambdaRequestHandler = async (req, reply) => {
+    const { routeName } = req.params;
+    const handler = LAMBDA_FUNCTIONS[routeName];
+    if (!handler) {
+      const errorMessage = `Function "${routeName}" was not found.`;
+      req.log.error(errorMessage);
+      reply.status(404);
+      reply.send({
+        error: errorMessage,
+        availableFunctions: Object.keys(LAMBDA_FUNCTIONS)
+      });
+      return;
+    }
+    return requestHandler(req, reply, handler);
+  };
+  const graphqlHandler = async (req, reply) => {
+    if (!graphqlYoga) {
+      return reply.status(503).send({ error: "GraphQL Yoga instance not initialized" });
+    }
+    const request = createFetchRequestFromFastify(req);
+    const yoga = graphqlYoga;
+    const response = await getAsyncStoreInstance().run(/* @__PURE__ */ new Map(), async () => {
+      return yoga.handle(request, { req, reply });
+    });
+    return response;
+  };
+  app.all("/graphql", graphqlHandler);
+  app.all("/graphql/*", graphqlHandler);
+  app.all("/:routeName", lambdaRequestHandler);
+  app.all("/:routeName/*", lambdaRequestHandler);
+  app.addHook("onListen", (done) => {
+    const addr = app.server.address();
+    const listenPort = addr && typeof addr === "object" ? addr.port : apiPort;
+    console.log(
+      `API dev server listening at ${ansis.magenta(`http://localhost:${listenPort}/`)}`
+    );
+    console.log(
+      `GraphQL endpoint at ${ansis.magenta(`http://localhost:${listenPort}/graphql`)}`
+    );
+    done();
+  });
+  await app.listen({ port: apiPort, host: apiHost });
+  return app;
+}
+export {
+  startApiDevServer
+};

package/dist/buildUDApiServer.d.ts

@@ -0,0 +1,22 @@
+export interface BuildUDApiServerOptions {
+    verbose?: boolean;
+    apiRootPath?: string;
+}
+/**
+ * Builds the API server Universal Deploy Node entry using Vite.
+ *
+ * Runs a Vite server build that:
+ *   1. Installs `cedarUniversalDeployPlugin()` to register `virtual:cedar-api`
+ *      and resolve `virtual:ud:catch-all` → Cedar's aggregate fetch dispatcher
+ *   2. Installs `node()` from `@universal-deploy/node/vite` to emit a
+ *      self-contained Node server entry at `api/dist/ud/index.js`
+ *
+ * The emitted entry can be launched directly:  node api/dist/ud/index.js
+ * That is what `cedar serve api` does.
+ *
+ * NOTE: The Vite "ssr" build target used here is a server-side module build
+ * concern — it is NOT related to Cedar HTML SSR or RSC. "ssr" simply means
+ * Vite produces a Node-compatible bundle rather than a browser bundle.
+ */
+export declare const buildUDApiServer: ({ verbose, apiRootPath, }?: BuildUDApiServerOptions) => Promise<void>;
+//# sourceMappingURL=buildUDApiServer.d.ts.map

package/dist/buildUDApiServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildUDApiServer.d.ts","sourceRoot":"","sources":["../src/buildUDApiServer.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,GAAU,4BAGpC,uBAA4B,kBA+D9B,CAAA"}

package/dist/buildUDApiServer.js

@@ -0,0 +1,59 @@
+import path from "node:path";
+import { getPaths } from "@cedarjs/project-config";
+const buildUDApiServer = async ({
+  verbose = false,
+  apiRootPath
+} = {}) => {
+  const { build } = await import("vite");
+  const { cedarUniversalDeployPlugin } = await import("./plugins/vite-plugin-cedar-universal-deploy.js");
+  const { node } = await import("@universal-deploy/node/vite");
+  const rwPaths = getPaths();
+  const outDir = path.join(rwPaths.api.dist, "ud");
+  await build({
+    // No configFile — we configure everything inline so this build is
+    // self-contained and does not require a vite.config.ts in api/.
+    configFile: false,
+    envFile: false,
+    logLevel: verbose ? "info" : "warn",
+    plugins: [
+      // Registers virtual:cedar-api with @universal-deploy/store and resolves
+      // virtual:ud:catch-all → virtual:cedar-api → Cedar's aggregate fetchable.
+      cedarUniversalDeployPlugin({ apiRootPath }),
+      // Emits a self-contained Node server entry (api/dist/ud/index.js) that
+      // imports virtual:ud:catch-all and starts an srvx HTTP server.
+      // This is a Vite server-build concern, not Cedar HTML SSR.
+      ...node()
+    ],
+    // The ssr environment is the Vite mechanism for server-side builds.
+    // Reminder: "ssr" here means "server-side module execution", NOT
+    // Cedar HTML SSR / streaming / RSC.
+    environments: {
+      ssr: {
+        build: {
+          outDir,
+          // Ensure @universal-deploy/node is bundled into the output so the
+          // emitted entry is self-contained.
+          rollupOptions: {
+            output: {
+              // Produce a single-file entry where possible; srvx chunks are
+              // split by the node() plugin automatically.
+              entryFileNames: "[name].js"
+            }
+          }
+        },
+        resolve: {
+          // Do not externalise @universal-deploy/node — the node() plugin
+          // requires it to be bundled into the server entry.
+          noExternal: ["@universal-deploy/node"]
+        }
+      }
+    },
+    build: {
+      // This is a server (Node) build, not a browser build.
+      ssr: true
+    }
+  });
+};
+export {
+  buildUDApiServer
+};

package/dist/cedar-unified-dev.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cedar-unified-dev.d.ts.map

package/dist/cedar-unified-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cedar-unified-dev.d.ts","sourceRoot":"","sources":["../src/cedar-unified-dev.ts"],"names":[],"mappings":""}

package/dist/cedar-unified-dev.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { createServer } from "vite";
+import yargsParser from "yargs-parser";
+import { getPaths, getConfig } from "@cedarjs/project-config";
+import { startApiDevServer } from "./apiDevServer.js";
+const startUnifiedDevServer = async () => {
+  const rwPaths = getPaths();
+  const cedarConfig = getConfig();
+  const configFile = rwPaths.web.viteConfig;
+  if (!configFile) {
+    throw new Error("Could not locate your web/vite.config.{js,ts} file");
+  }
+  const {
+    force: forceOptimize,
+    debug,
+    port: portArg,
+    apiPort: apiPortArg,
+    _: _positional,
+    ...serverArgs
+  } = yargsParser(process.argv.slice(2), {
+    boolean: ["https", "open", "strictPort", "force", "cors", "debug"],
+    number: ["port", "apiPort"]
+  });
+  const webPort = portArg ?? cedarConfig.web.port ?? 8910;
+  const apiPort = apiPortArg ?? cedarConfig.api.port ?? 8911;
+  const { close: closeApi } = await startApiDevServer(apiPort);
+  const devServer = await createServer({
+    configFile,
+    // env file is handled by Cedar's plugins
+    envFile: false,
+    optimizeDeps: {
+      // This is the only value that isn't a server option
+      force: forceOptimize
+    },
+    server: {
+      port: webPort,
+      ...serverArgs
+    },
+    logLevel: debug ? "info" : void 0
+  });
+  await devServer.listen();
+  process.stdin.on("data", async (data) => {
+    const str = data.toString().trim().toLowerCase();
+    if (str === "rs" || str === "restart") {
+      await devServer.restart(true);
+    }
+  });
+  devServer.printUrls();
+  if (debug) {
+    console.log("~~~ Vite Server Config ~~~");
+    console.log(JSON.stringify(devServer.config, null, 2));
+    console.log("~~~~~~~~~~~~~~~~~~~~~~~~~~");
+  }
+  const shutdown = async () => {
+    await devServer.close();
+    await closeApi();
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+};
+startUnifiedDevServer().catch((err) => {
+  console.error("Failed to start unified dev server:", err);
+  process.exit(1);
+});