orpc-file-based-router 0.0.18 → 0.1.1

package/README.md

@@ -1,15 +1,15 @@
 # orpc-file-based-router
 
-A plugin for [oRPC](https://orpc.unnoq.com) that automatically creates an oRPC router configuration based on your file
-structure, similar to Next.js, express-file-routing
+A plugin for [oRPC](https://orpc.unnoq.com) that automatically generates an oRPC router configuration based on your file
+structure, inspired by Next.js and express-file-routing approaches.
 
-## Highlights
+## ✨ Highlights
 
-- 📁 **File-based structure**: Organize your API endpoints intuitively through your filesystem
-- 🔄 **Zero configuration**: Generate routes automatically based on your directory structure
-- ⚡️ **Development speed**: Eliminate boilerplate code and reduce maintenance overhead
-- 🔍 **Dynamic routing**: Support for path parameters using `{param}` syntax in file names
-- 📑 **Index handling**: Support for index routes via `index.ts` files
+- 📁 **File-based Structure**: Organize your API endpoints intuitively through your filesystem
+- 🔄 **Zero Configuration**: Generate routes automatically based on your directory structure
+- ⚡️ **Development Speed**: Eliminate boilerplate code and reduce maintenance overhead
+- 🔍 **Dynamic Routing**: Support for path parameters using `{param}` syntax in file names
+- 📑 **Index Routes**: Support for index routes via `index.ts` files
 
 > ⚠️ **IMPORTANT:** At this time, the plugin's functionality is only guaranteed
 > in nodejs runtime
@@ -72,11 +72,11 @@ const handler = new RPCHandler(router);
 > startServer();
 > ```
 
-## Type-Safe Client Configuration (Optional)
+## 🔒 Type-Safe Client Configuration (Optional)
 
-If you plan to use [oRPC client](https://orpc.unnoq.com/docs/client/client-side), you can set up automatic configuration generation, which can be used for client typing.
+For users of the [oRPC client](https://orpc.unnoq.com/docs/client/client-side), we provide automatic configuration generation for enhanced type safety and improved developer experience.
 
-1. Add the following code to your main server file (e.g., `server.ts` or `main.ts`) or anywhere else. This will automatically regenerate the router configuration each time your server starts:
+1. Add the following code to your main server file (e.g., `server.ts` or `main.ts`). This will automatically regenerate the router configuration each time your server starts:
 
 ```typescript
 import { generateRouter } from "orpc-file-based-router";
@@ -121,6 +121,16 @@ const client: RouterClient<typeof router> = createORPCClient(link)
 
 ```
 
-## License
+## 🛠 Configuration Options
 
-MIT
+When using `generateRouter`, you can provide additional options to customize the output:
+
+| Field              | Type      | Required | Default Value | Description                                                                                                                     |
+|-------------------|----------|--------------|-----------------------|------------------------------------------------------------------------------------------------------------------------------|
+| `importExtension` | string   | false         | `""`(No extension) | File extension to append to import statements in the generated router. Useful when your build setup requires specific extensions. <br>Example: `.js` → `import { me } from "./routes/auth/me.js"` |
+
+
+
+## 📄 License
+
+MIT License - feel free to use this in your own projects!

package/dist/index.cjs

@@ -36,26 +36,27 @@ async function createRouter(routesDir) {
     return r.exports[e].route({ path: `${r.path}` });
   });
 }
-async function generateRouter(routesDir, outputFile) {
+async function generateRouter(routesDir, outputFile, options) {
   const files = walkTree(
     routesDir
   );
   const exports = await generateRoutes(files);
   const importPaths = exports.map((x) => path.relative(path.dirname(outputFile), routesDir).concat(x.path));
   const content = buildRouter(exports, (r, e) => {
-    return `${e}.route({ path: '${r.path}' })`;
+    return `${e}.route({ path: '${r.path.replace(/\/{0,1}index$/, "")}' })`;
   });
   let routerContent = `// This file is auto-generated
 
 `;
-  routerContent += importPaths.map((x, i) => `import { ${Object.keys(exports[i].exports).join(", ")} } from "./${x}"`).join("\n");
+  const extension = options?.importExtension || "";
+  routerContent += importPaths.map((x, i) => `import { ${Object.keys(exports[i].exports).join(", ")} } from "./${x}${extension}"`).join("\n");
   routerContent += "\n\nexport const router = ";
   routerContent += JSON.stringify(content, null, 2).replace(/"/g, "").replace(/(\s*)([a-zA-Z0-9]+-[a-zA-Z0-9-]+):/g, '$1"$2":');
   node_fs.writeFileSync(path.join(outputFile), routerContent);
 }
 function buildRoutePath(parsedFile) {
   const directory = parsedFile.dir === parsedFile.root ? "" : parsedFile.dir;
-  const name = parsedFile.name.startsWith("index") ? parsedFile.name.replace("index", "") : `/${parsedFile.name}`;
+  const name = `/${parsedFile.name}`;
   return directory + name;
 }
 function buildRouter(routes, mapper) {

package/dist/index.d.cts

@@ -1,5 +1,14 @@
 declare function createRouter(routesDir: string): Promise<Router>;
-declare function generateRouter(routesDir: string, outputFile: string): Promise<void>;
+type GeneratorOptions = {
+    /**
+     * File extension to append to import statements in the generated router.
+     * Useful when your build setup requires specific extensions.
+     * @example ".js" will generate imports like: import { me } from "./routes/auth/me.js"
+     * @default "" (no extension)
+     */
+    importExtension?: string;
+};
+declare function generateRouter(routesDir: string, outputFile: string, options?: GeneratorOptions): Promise<void>;
 type Router = Record<string, any>;
 
 export { createRouter, generateRouter };

package/dist/index.d.mts

@@ -1,5 +1,14 @@
 declare function createRouter(routesDir: string): Promise<Router>;
-declare function generateRouter(routesDir: string, outputFile: string): Promise<void>;
+type GeneratorOptions = {
+    /**
+     * File extension to append to import statements in the generated router.
+     * Useful when your build setup requires specific extensions.
+     * @example ".js" will generate imports like: import { me } from "./routes/auth/me.js"
+     * @default "" (no extension)
+     */
+    importExtension?: string;
+};
+declare function generateRouter(routesDir: string, outputFile: string, options?: GeneratorOptions): Promise<void>;
 type Router = Record<string, any>;
 
 export { createRouter, generateRouter };

package/dist/index.d.ts

@@ -1,5 +1,14 @@
 declare function createRouter(routesDir: string): Promise<Router>;
-declare function generateRouter(routesDir: string, outputFile: string): Promise<void>;
+type GeneratorOptions = {
+    /**
+     * File extension to append to import statements in the generated router.
+     * Useful when your build setup requires specific extensions.
+     * @example ".js" will generate imports like: import { me } from "./routes/auth/me.js"
+     * @default "" (no extension)
+     */
+    importExtension?: string;
+};
+declare function generateRouter(routesDir: string, outputFile: string, options?: GeneratorOptions): Promise<void>;
 type Router = Record<string, any>;
 
 export { createRouter, generateRouter };

package/dist/index.mjs

@@ -30,26 +30,27 @@ async function createRouter(routesDir) {
     return r.exports[e].route({ path: `${r.path}` });
   });
 }
-async function generateRouter(routesDir, outputFile) {
+async function generateRouter(routesDir, outputFile, options) {
   const files = walkTree(
     routesDir
   );
   const exports = await generateRoutes(files);
   const importPaths = exports.map((x) => relative(dirname(outputFile), routesDir).concat(x.path));
   const content = buildRouter(exports, (r, e) => {
-    return `${e}.route({ path: '${r.path}' })`;
+    return `${e}.route({ path: '${r.path.replace(/\/{0,1}index$/, "")}' })`;
   });
   let routerContent = `// This file is auto-generated
 
 `;
-  routerContent += importPaths.map((x, i) => `import { ${Object.keys(exports[i].exports).join(", ")} } from "./${x}"`).join("\n");
+  const extension = options?.importExtension || "";
+  routerContent += importPaths.map((x, i) => `import { ${Object.keys(exports[i].exports).join(", ")} } from "./${x}${extension}"`).join("\n");
   routerContent += "\n\nexport const router = ";
   routerContent += JSON.stringify(content, null, 2).replace(/"/g, "").replace(/(\s*)([a-zA-Z0-9]+-[a-zA-Z0-9-]+):/g, '$1"$2":');
   writeFileSync(join(outputFile), routerContent);
 }
 function buildRoutePath(parsedFile) {
   const directory = parsedFile.dir === parsedFile.root ? "" : parsedFile.dir;
-  const name = parsedFile.name.startsWith("index") ? parsedFile.name.replace("index", "") : `/${parsedFile.name}`;
+  const name = `/${parsedFile.name}`;
   return directory + name;
 }
 function buildRouter(routes, mapper) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orpc-file-based-router",
-  "version": "0.0.18",
+  "version": "0.1.1",
   "description": "File-based router plugin for oRPC - automatically generate oRPC router from your file structure",
   "author": "zeeeeby",
   "license": "MIT",
@@ -30,7 +30,8 @@
   ],
   "scripts": {
     "build": "npm run type-check && unbuild",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "playground": "tsx playground/src/generator.ts"
   },
   "devDependencies": {
     "@orpc/client": "^1.8.5",
@@ -40,4 +41,4 @@
     "vitest": "^3.2.4",
     "zod": "^4.1.3"
   }
-}
+}