@voltx/server 0.4.4 → 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);
@@ -313,26 +314,26 @@ function createViteDevConfig(options = {}) {
 // src/vite-plugin.ts
 function voltxRouter(options = {}) {
   const pagesDir = options.pagesDir ?? "src/pages";
-  const virtualModuleId = "virtual:voltx-routes";
-  const resolvedVirtualModuleId = "\0" + virtualModuleId;
+  const PUBLIC_ID = "voltx/router";
+  const LEGACY_ID = "virtual:voltx-routes";
+  const RESOLVED_ID = "\0voltx/router";
   return {
     name: "voltx-router",
     enforce: "pre",
     config() {
       return {
         ssr: {
-          // react-router ships CJS — force Vite to bundle its .mjs for SSR
           noExternal: ["react-router"]
         }
       };
     },
     resolveId(id) {
-      if (id === virtualModuleId) {
-        return resolvedVirtualModuleId;
+      if (id === PUBLIC_ID || id === LEGACY_ID) {
+        return RESOLVED_ID;
       }
     },
     load(id) {
-      if (id === resolvedVirtualModuleId) {
+      if (id === RESOLVED_ID) {
         return `
 import { createElement } from "react";
 import { Routes, Route } from "react-router";
@@ -374,13 +375,95 @@ export function VoltxRoutes() {
 }
 
 export { routes };
+
+// Navigation primitives \u2014 single import source
+export { Link, NavLink, useNavigate, useParams, useLocation, useSearchParams } from "react-router";
 `;
       }
     },
-    // HMR: when a file in src/pages/ is added/removed, invalidate the virtual module
     handleHotUpdate({ file, server }) {
       if (file.includes(pagesDir.replace(/\//g, "/"))) {
-        const mod = server.moduleGraph.getModuleById(resolvedVirtualModuleId);
+        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
+        if (mod) {
+          server.moduleGraph.invalidateModule(mod);
+          server.ws.send({ type: "full-reload" });
+        }
+      }
+    }
+  };
+}
+
+// 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" });
@@ -530,7 +613,7 @@ ${cssLinks}
 }
 
 // src/index.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.6";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Hono,
@@ -544,5 +627,6 @@ var VERSION = "0.4.4";
   registerSSR,
   registerStaticFiles,
   scanAndRegisterRoutes,
+  voltxAPI,
   voltxRouter
 });

package/dist/index.d.cts

@@ -187,6 +187,9 @@ interface VoltxRouterOptions {
  * Scans `src/pages/` and generates a virtual module that maps
  * file paths to routes — just like Next.js.
  *
+ * Usage:
+ *   import { Link, VoltxRoutes, useNavigate } from "voltx/router";
+ *
  * Convention:
  *   src/pages/index.tsx       → /
  *   src/pages/about.tsx       → /about
@@ -195,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;
@@ -242,6 +263,6 @@ interface ViteDevServer {
  */
 declare function registerSSR(app: Hono, vite: ViteDevServer | null, options?: SSROptions): void;
 
-declare const VERSION = "0.4.4";
+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

@@ -187,6 +187,9 @@ interface VoltxRouterOptions {
  * Scans `src/pages/` and generates a virtual module that maps
  * file paths to routes — just like Next.js.
  *
+ * Usage:
+ *   import { Link, VoltxRoutes, useNavigate } from "voltx/router";
+ *
  * Convention:
  *   src/pages/index.tsx       → /
  *   src/pages/about.tsx       → /about
@@ -195,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;
@@ -242,6 +263,6 @@ interface ViteDevServer {
  */
 declare function registerSSR(app: Hono, vite: ViteDevServer | null, options?: SSROptions): void;
 
-declare const VERSION = "0.4.4";
+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

@@ -266,26 +266,26 @@ function createViteDevConfig(options = {}) {
 // src/vite-plugin.ts
 function voltxRouter(options = {}) {
   const pagesDir = options.pagesDir ?? "src/pages";
-  const virtualModuleId = "virtual:voltx-routes";
-  const resolvedVirtualModuleId = "\0" + virtualModuleId;
+  const PUBLIC_ID = "voltx/router";
+  const LEGACY_ID = "virtual:voltx-routes";
+  const RESOLVED_ID = "\0voltx/router";
   return {
     name: "voltx-router",
     enforce: "pre",
     config() {
       return {
         ssr: {
-          // react-router ships CJS — force Vite to bundle its .mjs for SSR
           noExternal: ["react-router"]
         }
       };
     },
     resolveId(id) {
-      if (id === virtualModuleId) {
-        return resolvedVirtualModuleId;
+      if (id === PUBLIC_ID || id === LEGACY_ID) {
+        return RESOLVED_ID;
       }
     },
     load(id) {
-      if (id === resolvedVirtualModuleId) {
+      if (id === RESOLVED_ID) {
         return `
 import { createElement } from "react";
 import { Routes, Route } from "react-router";
@@ -327,13 +327,95 @@ export function VoltxRoutes() {
 }
 
 export { routes };
+
+// Navigation primitives \u2014 single import source
+export { Link, NavLink, useNavigate, useParams, useLocation, useSearchParams } from "react-router";
 `;
       }
     },
-    // HMR: when a file in src/pages/ is added/removed, invalidate the virtual module
     handleHotUpdate({ file, server }) {
       if (file.includes(pagesDir.replace(/\//g, "/"))) {
-        const mod = server.moduleGraph.getModuleById(resolvedVirtualModuleId);
+        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
+        if (mod) {
+          server.moduleGraph.invalidateModule(mod);
+          server.ws.send({ type: "full-reload" });
+        }
+      }
+    }
+  };
+}
+
+// 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" });
@@ -483,7 +565,7 @@ ${cssLinks}
 }
 
 // src/index.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.6";
 export {
   Hono2 as Hono,
   VERSION,
@@ -496,5 +578,6 @@ export {
   registerSSR,
   registerStaticFiles,
   scanAndRegisterRoutes,
+  voltxAPI,
   voltxRouter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltx/server",
-  "version": "0.4.4",
+  "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",