@voltx/server 0.4.5 → 0.4.6

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(index_exports, {
   registerSSR: () => registerSSR,
   registerStaticFiles: () => registerStaticFiles,
   scanAndRegisterRoutes: () => scanAndRegisterRoutes,
+  voltxAPI: () => voltxAPI,
   voltxRouter: () => voltxRouter
 });
 module.exports = __toCommonJS(index_exports);
@@ -392,6 +393,86 @@ export { Link, NavLink, useNavigate, useParams, useLocation, useSearchParams } f
   };
 }
 
+// src/vite-api-plugin.ts
+function voltxAPI(options = {}) {
+  const apiDir = options.apiDir ?? "api";
+  const PUBLIC_ID = "voltx/api";
+  const RESOLVED_ID = "\0voltx/api";
+  return {
+    name: "voltx-api",
+    enforce: "pre",
+    resolveId(id) {
+      if (id === PUBLIC_ID) {
+        return RESOLVED_ID;
+      }
+    },
+    load(id) {
+      if (id === RESOLVED_ID) {
+        return `
+const modules = import.meta.glob("/${apiDir}/**/*.ts", { eager: true });
+
+const HTTP_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+
+function fileToRoute(filePath) {
+  let route = filePath
+    .replace("/${apiDir}", "/${apiDir}")
+    .replace(/\\.ts$/, "")
+    .replace(/\\/index$/, "");
+
+  // Convert [param] -> :param
+  route = route.replace(/\\[([^\\]\\.]+)\\]/g, ":$1");
+  // Convert [...slug] -> *
+  route = route.replace(/\\[\\.\\.\\.([^\\]]+)\\]/g, "*");
+
+  if (!route || route === "/${apiDir}") route = "/${apiDir}";
+  return route;
+}
+
+export function registerRoutes(app) {
+  const registered = [];
+
+  // Sort: static routes first, dynamic (:param) second, catch-all (*) last
+  const entries = Object.entries(modules).sort(([a], [b]) => {
+    const ra = fileToRoute(a);
+    const rb = fileToRoute(b);
+    const sa = ra.includes("*") ? 2 : ra.includes(":") ? 1 : 0;
+    const sb = rb.includes("*") ? 2 : rb.includes(":") ? 1 : 0;
+    if (sa !== sb) return sa - sb;
+    return ra.localeCompare(rb);
+  });
+
+  for (const [filePath, mod] of entries) {
+    const route = fileToRoute(filePath);
+
+    for (const method of HTTP_METHODS) {
+      const handler = mod[method];
+      if (typeof handler === "function") {
+        app.on(method, route, handler);
+        registered.push({ method, path: route });
+      }
+    }
+  }
+
+  return registered;
+}
+
+export { modules as apiModules };
+`;
+      }
+    },
+    // HMR: when a file in api/ is added/removed, invalidate the virtual module
+    handleHotUpdate({ file, server }) {
+      if (file.includes(`/${apiDir}/`) || file.endsWith(`/${apiDir}`)) {
+        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
+        if (mod) {
+          server.moduleGraph.invalidateModule(mod);
+          server.ws.send({ type: "full-reload" });
+        }
+      }
+    }
+  };
+}
+
 // src/ssr.ts
 var import_node_path3 = require("path");
 var import_node_fs = require("fs");
@@ -532,7 +613,7 @@ ${cssLinks}
 }
 
 // src/index.ts
-var VERSION = "0.4.5";
+var VERSION = "0.4.6";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Hono,
@@ -546,5 +627,6 @@ var VERSION = "0.4.5";
   registerSSR,
   registerStaticFiles,
   scanAndRegisterRoutes,
+  voltxAPI,
   voltxRouter
 });

package/dist/index.d.cts

@@ -198,6 +198,24 @@ interface VoltxRouterOptions {
  */
 declare function voltxRouter(options?: VoltxRouterOptions): Plugin;
 
+interface VoltxAPIOptions {
+    /** Directory to scan for API route files (default: "api") */
+    apiDir?: string;
+}
+/**
+ * VoltX file-based API routing plugin for Vite.
+ *
+ * Usage in server.ts:
+ *   import { registerRoutes } from "voltx/api";
+ *   registerRoutes(app);
+ *
+ * Convention:
+ *   api/index.ts       → /api
+ *   api/users.ts       → /api/users
+ *   api/users/[id].ts  → /api/users/:id
+ */
+declare function voltxAPI(options?: VoltxAPIOptions): Plugin;
+
 interface SSROptions {
     /** Path to entry-server module (default: src/entry-server.tsx) */
     entryServer?: string;
@@ -245,6 +263,6 @@ interface ViteDevServer {
  */
 declare function registerSSR(app: Hono, vite: ViteDevServer | null, options?: SSROptions): void;
 
-declare const VERSION = "0.4.5";
+declare const VERSION = "0.4.6";
 
-export { type CorsConfig, type HttpMethod, type MiddlewareHandler, type RouteEntry, type RouteHandler, type RouteModule, type SSROptions, type ServerConfig, type ServerInfo, VERSION, type ViteDevOptions, type VoltxRouterOptions, type VoltxServer, createCorsMiddleware, createErrorHandler, createLoggerMiddleware, createServer, createViteDevConfig, filePathToUrlPath, registerSSR, registerStaticFiles, scanAndRegisterRoutes, voltxRouter };
+export { type CorsConfig, type HttpMethod, type MiddlewareHandler, type RouteEntry, type RouteHandler, type RouteModule, type SSROptions, type ServerConfig, type ServerInfo, VERSION, type ViteDevOptions, type VoltxAPIOptions, type VoltxRouterOptions, type VoltxServer, createCorsMiddleware, createErrorHandler, createLoggerMiddleware, createServer, createViteDevConfig, filePathToUrlPath, registerSSR, registerStaticFiles, scanAndRegisterRoutes, voltxAPI, voltxRouter };

package/dist/index.d.ts

@@ -198,6 +198,24 @@ interface VoltxRouterOptions {
  */
 declare function voltxRouter(options?: VoltxRouterOptions): Plugin;
 
+interface VoltxAPIOptions {
+    /** Directory to scan for API route files (default: "api") */
+    apiDir?: string;
+}
+/**
+ * VoltX file-based API routing plugin for Vite.
+ *
+ * Usage in server.ts:
+ *   import { registerRoutes } from "voltx/api";
+ *   registerRoutes(app);
+ *
+ * Convention:
+ *   api/index.ts       → /api
+ *   api/users.ts       → /api/users
+ *   api/users/[id].ts  → /api/users/:id
+ */
+declare function voltxAPI(options?: VoltxAPIOptions): Plugin;
+
 interface SSROptions {
     /** Path to entry-server module (default: src/entry-server.tsx) */
     entryServer?: string;
@@ -245,6 +263,6 @@ interface ViteDevServer {
  */
 declare function registerSSR(app: Hono, vite: ViteDevServer | null, options?: SSROptions): void;
 
-declare const VERSION = "0.4.5";
+declare const VERSION = "0.4.6";
 
-export { type CorsConfig, type HttpMethod, type MiddlewareHandler, type RouteEntry, type RouteHandler, type RouteModule, type SSROptions, type ServerConfig, type ServerInfo, VERSION, type ViteDevOptions, type VoltxRouterOptions, type VoltxServer, createCorsMiddleware, createErrorHandler, createLoggerMiddleware, createServer, createViteDevConfig, filePathToUrlPath, registerSSR, registerStaticFiles, scanAndRegisterRoutes, voltxRouter };
+export { type CorsConfig, type HttpMethod, type MiddlewareHandler, type RouteEntry, type RouteHandler, type RouteModule, type SSROptions, type ServerConfig, type ServerInfo, VERSION, type ViteDevOptions, type VoltxAPIOptions, type VoltxRouterOptions, type VoltxServer, createCorsMiddleware, createErrorHandler, createLoggerMiddleware, createServer, createViteDevConfig, filePathToUrlPath, registerSSR, registerStaticFiles, scanAndRegisterRoutes, voltxAPI, voltxRouter };

package/dist/index.js

@@ -345,6 +345,86 @@ export { Link, NavLink, useNavigate, useParams, useLocation, useSearchParams } f
   };
 }
 
+// src/vite-api-plugin.ts
+function voltxAPI(options = {}) {
+  const apiDir = options.apiDir ?? "api";
+  const PUBLIC_ID = "voltx/api";
+  const RESOLVED_ID = "\0voltx/api";
+  return {
+    name: "voltx-api",
+    enforce: "pre",
+    resolveId(id) {
+      if (id === PUBLIC_ID) {
+        return RESOLVED_ID;
+      }
+    },
+    load(id) {
+      if (id === RESOLVED_ID) {
+        return `
+const modules = import.meta.glob("/${apiDir}/**/*.ts", { eager: true });
+
+const HTTP_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+
+function fileToRoute(filePath) {
+  let route = filePath
+    .replace("/${apiDir}", "/${apiDir}")
+    .replace(/\\.ts$/, "")
+    .replace(/\\/index$/, "");
+
+  // Convert [param] -> :param
+  route = route.replace(/\\[([^\\]\\.]+)\\]/g, ":$1");
+  // Convert [...slug] -> *
+  route = route.replace(/\\[\\.\\.\\.([^\\]]+)\\]/g, "*");
+
+  if (!route || route === "/${apiDir}") route = "/${apiDir}";
+  return route;
+}
+
+export function registerRoutes(app) {
+  const registered = [];
+
+  // Sort: static routes first, dynamic (:param) second, catch-all (*) last
+  const entries = Object.entries(modules).sort(([a], [b]) => {
+    const ra = fileToRoute(a);
+    const rb = fileToRoute(b);
+    const sa = ra.includes("*") ? 2 : ra.includes(":") ? 1 : 0;
+    const sb = rb.includes("*") ? 2 : rb.includes(":") ? 1 : 0;
+    if (sa !== sb) return sa - sb;
+    return ra.localeCompare(rb);
+  });
+
+  for (const [filePath, mod] of entries) {
+    const route = fileToRoute(filePath);
+
+    for (const method of HTTP_METHODS) {
+      const handler = mod[method];
+      if (typeof handler === "function") {
+        app.on(method, route, handler);
+        registered.push({ method, path: route });
+      }
+    }
+  }
+
+  return registered;
+}
+
+export { modules as apiModules };
+`;
+      }
+    },
+    // HMR: when a file in api/ is added/removed, invalidate the virtual module
+    handleHotUpdate({ file, server }) {
+      if (file.includes(`/${apiDir}/`) || file.endsWith(`/${apiDir}`)) {
+        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
+        if (mod) {
+          server.moduleGraph.invalidateModule(mod);
+          server.ws.send({ type: "full-reload" });
+        }
+      }
+    }
+  };
+}
+
 // src/ssr.ts
 import { resolve as resolve2 } from "path";
 import { readFileSync, existsSync } from "fs";
@@ -485,7 +565,7 @@ ${cssLinks}
 }
 
 // src/index.ts
-var VERSION = "0.4.5";
+var VERSION = "0.4.6";
 export {
   Hono2 as Hono,
   VERSION,
@@ -498,5 +578,6 @@ export {
   registerSSR,
   registerStaticFiles,
   scanAndRegisterRoutes,
+  voltxAPI,
   voltxRouter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltx/server",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "VoltX Server — Hono-based HTTP server with file-based routing, SSE streaming, and static file serving",
   "type": "module",
   "main": "./dist/index.cjs",