@vertz/ui-server 0.2.45 → 0.2.47

package/dist/bun-dev-server.d.ts

@@ -43,7 +43,17 @@ interface BunDevServerOptions {
 	host?: string;
 	/** API handler for full-stack mode */
 	apiHandler?: (req: Request) => Promise<Response>;
-	/** Paths to skip SSR (delegate to apiHandler). @default ['/api/'] */
+	/**
+	* API route prefix for full-stack mode. Used to build route keys and
+	* skipSSRPaths when skipSSRPaths is not provided explicitly.
+	*
+	* Must be non-empty when `apiHandler` is provided — the dev server uses
+	* the prefix to distinguish API requests from SSR requests.
+	*
+	* @default '/api'
+	*/
+	apiPrefix?: string;
+	/** Paths to skip SSR (delegate to apiHandler). @default [`${apiPrefix}/`] */
 	skipSSRPaths?: string[];
 	/** OpenAPI spec options */
 	openapi?: {

package/dist/bun-dev-server.js

@@ -3596,7 +3596,6 @@ function createBunDevServer(options) {
     port = 3000,
     host = "localhost",
     apiHandler,
-    skipSSRPaths = ["/api/"],
     openapi,
     clientEntry: clientEntryOption,
     title = "Vertz App",
@@ -3609,6 +3608,11 @@ function createBunDevServer(options) {
     themeFromRequest,
     onRestartNeeded
   } = options;
+  const apiPrefix = options.apiPrefix ?? "/api";
+  if (apiHandler && apiPrefix === "") {
+    throw new Error("apiPrefix cannot be empty in full-stack mode. The dev server uses the " + "API prefix to distinguish API requests from SSR requests. Use a non-empty " + "prefix like '/api' or '/v1'. Note: '/' normalizes to empty string.");
+  }
+  const skipSSRPaths = options.skipSSRPaths ?? (apiPrefix ? [`${apiPrefix}/`] : []);
   const faviconTag = detectFaviconTag(projectRoot);
   const headTags = [faviconTag, headTagsOption].filter(Boolean).join(`
 `);
@@ -4118,11 +4122,11 @@ if (import.meta.hot) import.meta.hot.accept();
     const routes = {
       "/__vertz_hmr": hmrShellModule
     };
-    if (openapi) {
-      routes["/api/openapi.json"] = () => serveOpenAPISpec();
+    if (openapi && apiPrefix) {
+      routes[`${apiPrefix}/openapi.json`] = () => serveOpenAPISpec();
     }
-    if (apiHandler) {
-      routes["/api/*"] = (req) => apiHandler(req);
+    if (apiHandler && apiPrefix) {
+      routes[`${apiPrefix}/*`] = (req) => apiHandler(req);
     }
     killStaleProcess(port);
     server = Bun.serve({
@@ -4231,7 +4235,7 @@ if (import.meta.hot) import.meta.hot.accept();
           }
           return new Response("Not Found", { status: 404 });
         }
-        if (openapi && request.method === "GET" && pathname === "/api/openapi.json") {
+        if (openapi && apiPrefix && request.method === "GET" && pathname === `${apiPrefix}/openapi.json`) {
           return serveOpenAPISpec();
         }
         if (apiHandler && skipSSRPaths.some((p) => pathname.startsWith(p))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/ui-server",
-  "version": "0.2.45",
+  "version": "0.2.47",
   "description": "Vertz UI server-side rendering runtime",
   "license": "MIT",
   "repository": {
@@ -67,15 +67,15 @@
     "@ampproject/remapping": "^2.3.0",
     "@capsizecss/unpack": "^4.0.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@vertz/core": "^0.2.43",
-    "@vertz/ui": "^0.2.43",
+    "@vertz/core": "^0.2.46",
+    "@vertz/ui": "^0.2.46",
     "magic-string": "^0.30.0",
     "sharp": "^0.34.5"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.3",
     "@playwright/test": "^1.58.2",
-    "@vertz/codegen": "^0.2.43",
+    "@vertz/codegen": "^0.2.46",
     "bun-types": "^1.3.10",
     "bunup": "^0.16.31",
     "happy-dom": "^20.8.3",