@voltx/server 0.4.3 → 0.4.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Promptly AI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -40,7 +40,8 @@ __export(index_exports, {
   filePathToUrlPath: () => filePathToUrlPath,
   registerSSR: () => registerSSR,
   registerStaticFiles: () => registerStaticFiles,
-  scanAndRegisterRoutes: () => scanAndRegisterRoutes
+  scanAndRegisterRoutes: () => scanAndRegisterRoutes,
+  voltxRouter: () => voltxRouter
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -309,6 +310,86 @@ 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;
+  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;
+      }
+    },
+    load(id) {
+      if (id === resolvedVirtualModuleId) {
+        return `
+import { createElement } from "react";
+import { Routes, Route } from "react-router";
+
+const pages = import.meta.glob("/${pagesDir}/**/*.tsx", { eager: true });
+
+function buildRoutes() {
+  const routes = [];
+  for (const [filePath, mod] of Object.entries(pages)) {
+    const Component = mod.default;
+    if (!Component) continue;
+
+    let routePath = filePath
+      .replace("/${pagesDir}", "")
+      .replace(/\\.tsx$/, "")
+      .replace(/\\/index$/, "/")
+      .replace(/\\[([^\\]]+)\\]/g, ":$1");
+
+    if (!routePath.startsWith("/")) routePath = "/" + routePath;
+    if (routePath !== "/" && routePath.endsWith("/")) {
+      routePath = routePath.slice(0, -1);
+    }
+
+    routes.push({ path: routePath, Component });
+  }
+  return routes;
+}
+
+const routes = buildRoutes();
+
+export function VoltxRoutes() {
+  return createElement(
+    Routes,
+    null,
+    routes.map(({ path, Component }) =>
+      createElement(Route, { key: path, path, element: createElement(Component) })
+    )
+  );
+}
+
+export { routes };
+`;
+      }
+    },
+    // 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);
+        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");
@@ -449,7 +530,7 @@ ${cssLinks}
 }
 
 // src/index.ts
-var VERSION = "0.4.3";
+var VERSION = "0.4.4";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Hono,
@@ -462,5 +543,6 @@ var VERSION = "0.4.3";
   filePathToUrlPath,
   registerSSR,
   registerStaticFiles,
-  scanAndRegisterRoutes
+  scanAndRegisterRoutes,
+  voltxRouter
 });

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as hono from 'hono';
 import { Context, Hono } from 'hono';
 export { Context, Hono } from 'hono';
+import { Plugin } from 'vite';
 
 interface ServerConfig {
     /** Port to listen on (default: 3000) */
@@ -176,6 +177,24 @@ declare function createViteDevConfig(options?: ViteDevOptions): {
     entry: string;
 };
 
+interface VoltxRouterOptions {
+    /** Directory to scan for page files (default: "src/pages") */
+    pagesDir?: string;
+}
+/**
+ * VoltX file-based router plugin for Vite.
+ *
+ * Scans `src/pages/` and generates a virtual module that maps
+ * file paths to routes — just like Next.js.
+ *
+ * Convention:
+ *   src/pages/index.tsx       → /
+ *   src/pages/about.tsx       → /about
+ *   src/pages/blog/index.tsx  → /blog
+ *   src/pages/blog/[slug].tsx → /blog/:slug
+ */
+declare function voltxRouter(options?: VoltxRouterOptions): Plugin;
+
 interface SSROptions {
     /** Path to entry-server module (default: src/entry-server.tsx) */
     entryServer?: string;
@@ -223,6 +242,6 @@ interface ViteDevServer {
  */
 declare function registerSSR(app: Hono, vite: ViteDevServer | null, options?: SSROptions): void;
 
-declare const VERSION = "0.4.3";
+declare const VERSION = "0.4.4";
 
-export { type CorsConfig, type HttpMethod, type MiddlewareHandler, type RouteEntry, type RouteHandler, type RouteModule, type SSROptions, type ServerConfig, type ServerInfo, VERSION, type ViteDevOptions, type VoltxServer, createCorsMiddleware, createErrorHandler, createLoggerMiddleware, createServer, createViteDevConfig, filePathToUrlPath, registerSSR, registerStaticFiles, scanAndRegisterRoutes };
+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 };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as hono from 'hono';
 import { Context, Hono } from 'hono';
 export { Context, Hono } from 'hono';
+import { Plugin } from 'vite';
 
 interface ServerConfig {
     /** Port to listen on (default: 3000) */
@@ -176,6 +177,24 @@ declare function createViteDevConfig(options?: ViteDevOptions): {
     entry: string;
 };
 
+interface VoltxRouterOptions {
+    /** Directory to scan for page files (default: "src/pages") */
+    pagesDir?: string;
+}
+/**
+ * VoltX file-based router plugin for Vite.
+ *
+ * Scans `src/pages/` and generates a virtual module that maps
+ * file paths to routes — just like Next.js.
+ *
+ * Convention:
+ *   src/pages/index.tsx       → /
+ *   src/pages/about.tsx       → /about
+ *   src/pages/blog/index.tsx  → /blog
+ *   src/pages/blog/[slug].tsx → /blog/:slug
+ */
+declare function voltxRouter(options?: VoltxRouterOptions): Plugin;
+
 interface SSROptions {
     /** Path to entry-server module (default: src/entry-server.tsx) */
     entryServer?: string;
@@ -223,6 +242,6 @@ interface ViteDevServer {
  */
 declare function registerSSR(app: Hono, vite: ViteDevServer | null, options?: SSROptions): void;
 
-declare const VERSION = "0.4.3";
+declare const VERSION = "0.4.4";
 
-export { type CorsConfig, type HttpMethod, type MiddlewareHandler, type RouteEntry, type RouteHandler, type RouteModule, type SSROptions, type ServerConfig, type ServerInfo, VERSION, type ViteDevOptions, type VoltxServer, createCorsMiddleware, createErrorHandler, createLoggerMiddleware, createServer, createViteDevConfig, filePathToUrlPath, registerSSR, registerStaticFiles, scanAndRegisterRoutes };
+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 };

package/dist/index.js

@@ -263,6 +263,86 @@ 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;
+  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;
+      }
+    },
+    load(id) {
+      if (id === resolvedVirtualModuleId) {
+        return `
+import { createElement } from "react";
+import { Routes, Route } from "react-router";
+
+const pages = import.meta.glob("/${pagesDir}/**/*.tsx", { eager: true });
+
+function buildRoutes() {
+  const routes = [];
+  for (const [filePath, mod] of Object.entries(pages)) {
+    const Component = mod.default;
+    if (!Component) continue;
+
+    let routePath = filePath
+      .replace("/${pagesDir}", "")
+      .replace(/\\.tsx$/, "")
+      .replace(/\\/index$/, "/")
+      .replace(/\\[([^\\]]+)\\]/g, ":$1");
+
+    if (!routePath.startsWith("/")) routePath = "/" + routePath;
+    if (routePath !== "/" && routePath.endsWith("/")) {
+      routePath = routePath.slice(0, -1);
+    }
+
+    routes.push({ path: routePath, Component });
+  }
+  return routes;
+}
+
+const routes = buildRoutes();
+
+export function VoltxRoutes() {
+  return createElement(
+    Routes,
+    null,
+    routes.map(({ path, Component }) =>
+      createElement(Route, { key: path, path, element: createElement(Component) })
+    )
+  );
+}
+
+export { routes };
+`;
+      }
+    },
+    // 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);
+        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";
@@ -403,7 +483,7 @@ ${cssLinks}
 }
 
 // src/index.ts
-var VERSION = "0.4.3";
+var VERSION = "0.4.4";
 export {
   Hono2 as Hono,
   VERSION,
@@ -415,5 +495,6 @@ export {
   filePathToUrlPath,
   registerSSR,
   registerStaticFiles,
-  scanAndRegisterRoutes
+  scanAndRegisterRoutes,
+  voltxRouter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltx/server",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "VoltX Server — Hono-based HTTP server with file-based routing, SSE streaming, and static file serving",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -13,31 +13,47 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "clean": "rm -rf dist"
-  },
+  "files": [
+    "dist"
+  ],
   "dependencies": {
-    "hono": "^4.7.0",
-    "@hono/node-server": "^1.14.0"
+    "@hono/node-server": "^1.14.0",
+    "hono": "^4.7.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "vite": ">=5.0.0"
   },
   "peerDependenciesMeta": {
-    "react": { "optional": true },
-    "react-dom": { "optional": true }
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0"
+    "vite": "^8.0.1"
   },
-  "keywords": ["voltx", "server", "hono", "http", "routing", "file-based", "sse", "streaming", "middleware"],
+  "keywords": [
+    "voltx",
+    "server",
+    "hono",
+    "http",
+    "routing",
+    "file-based",
+    "sse",
+    "streaming",
+    "middleware"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -45,5 +61,10 @@
     "directory": "packages/server"
   },
   "homepage": "https://voltx.co.in",
-  "author": "Promptly AI Team"
-}
+  "author": "Promptly AI Team",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external vite",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "clean": "rm -rf dist"
+  }
+}