@minisylar/express-typed-router 1.0.0

package/README.md

@@ -0,0 +1,164 @@
+# @minisylar/express-typed-router
+
+A strongly-typed Express router with Zod validation and automatic type inference for params, body, query, and middleware.
+
+## Features
+
+- 🚀 **Full TypeScript support** with automatic type inference for route parameters
+- 🛡️ **Zod validation** for request body, query parameters, and route params
+- 🔗 **Express.js compatibility** - works with Express 4 and Express 5
+- 📝 **JSDoc documentation** with comprehensive examples
+- 📦 **ES Modules** and CommonJS support
+- 🎯 **Zero runtime overhead** for type checking
+
+## Installation
+
+```bash
+npm install @minisylar/express-typed-router
+# or
+pnpm add @minisylar/express-typed-router
+# or
+yarn add @minisylar/express-typed-router
+```
+
+## Quick Start
+
+```typescript
+import express from "express";
+import { z } from "zod";
+import { createTypedRouter } from "@minisylar/express-typed-router";
+
+const app = express();
+app.use(express.json());
+
+// Create a typed router
+const router = createTypedRouter();
+
+// Define routes with automatic type inference
+router.get(
+  "/users/:userId",
+  {
+    params: z.object({
+      userId: z.string(),
+    }),
+    query: z.object({
+      include: z.string().optional(),
+    }),
+  },
+  (req, res) => {
+    // req.params.userId is automatically typed as string
+    // req.query.include is automatically typed as string | undefined
+    res.json({
+      userId: req.params.userId,
+      include: req.query.include,
+    });
+  }
+);
+
+router.post(
+  "/users",
+  {
+    body: z.object({
+      name: z.string(),
+      email: z.string().email(),
+    }),
+  },
+  (req, res) => {
+    // req.body is automatically typed as { name: string; email: string }
+    const { name, email } = req.body;
+    res.json({ id: "123", name, email });
+  }
+);
+
+app.use("/api", router.getRouter());
+app.listen(3000);
+```
+
+## Advanced Usage
+
+### Custom Error Handling
+
+```typescript
+import { createTypedRouterWithConfig } from "@minisylar/express-typed-router";
+
+const router = createTypedRouterWithConfig({
+  errorHandler: (error, req, res, next) => {
+    if (error.name === "ZodError") {
+      res.status(400).json({
+        error: "Validation failed",
+        details: error.errors,
+      });
+    } else {
+      next(error);
+    }
+  },
+});
+```
+
+### With Middleware
+
+```typescript
+import { createTypedRouterWithMiddleware } from "@minisylar/express-typed-router";
+
+const authMiddleware = (req, res, next) => {
+  // Your auth logic here
+  next();
+};
+
+const router = createTypedRouterWithMiddleware([authMiddleware]);
+```
+
+## Route Parameter Support
+
+This library supports all Express.js routing patterns with automatic TypeScript inference:
+
+- **Named parameters**: `/users/:userId` → `{ userId: string }`
+- **Multiple parameters**: `/users/:userId/books/:bookId` → `{ userId: string; bookId: string }`
+- **Consecutive parameters**: `/flights/:from-:to` → `{ from: string; to: string }`
+- **Optional parameters (Express 4)**: `/posts/:id?` → `{ id?: string }`
+- **Repeating parameters (Express 5)**: `/files/:path+` → `{ path: string[] }`
+- **Wildcard parameters (Express 5)**: `/files/:path*` → `{ path: string[] }`
+- **Optional segments (Express 5)**: `{/:optional}` → `{ optional?: string }`
+- **Regex constraints**: `/users/:id(\\d+)` → `{ id: string }`
+
+## API Reference
+
+### `createTypedRouter()`
+
+Creates a basic typed router instance.
+
+### `createTypedRouterWithConfig(config)`
+
+Creates a typed router with custom configuration.
+
+### `createTypedRouterWithMiddleware(middleware)`
+
+Creates a typed router with pre-applied middleware.
+
+### `TypedMiddleware<T>`
+
+Type for middleware functions with typed request parameters.
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the library
+pnpm build
+
+# Run type checking
+pnpm type-check
+
+# Build in watch mode
+pnpm build:watch
+```
+
+## License
+
+ISC
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/zod-router.cjs

@@ -0,0 +1,232 @@
+"use strict";
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const express = __toESM(require("express"));
+const zod = __toESM(require("zod"));
+
+//#region src/zod-router.ts
+var TypedRouter = class {
+	router;
+	constructor() {
+		this.router = express.default.Router();
+	}
+	/**
+	
+	* Add typed middleware that extends the request with additional properties
+	
+	*/
+	useTypedMiddleware(middleware) {
+		this.router.use(middleware);
+		return this;
+	}
+	/**
+	
+	* Get the underlying Express router
+	
+	*/
+	getRouter() {
+		return this.router;
+	}
+	get(path, optionsOrHandler, handler) {
+		return this.registerRoute("get", path, optionsOrHandler, handler);
+	}
+	post(path, optionsOrHandler, handler) {
+		return this.registerRoute("post", path, optionsOrHandler, handler);
+	}
+	put(path, optionsOrHandler, handler) {
+		return this.registerRoute("put", path, optionsOrHandler, handler);
+	}
+	patch(path, optionsOrHandler, handler) {
+		return this.registerRoute("patch", path, optionsOrHandler, handler);
+	}
+	delete(path, optionsOrHandler, handler) {
+		return this.registerRoute("delete", path, optionsOrHandler, handler);
+	}
+	options(path, optionsOrHandler, handler) {
+		return this.registerRoute("options", path, optionsOrHandler, handler);
+	}
+	head(path, optionsOrHandler, handler) {
+		return this.registerRoute("head", path, optionsOrHandler, handler);
+	}
+	all(path, optionsOrHandler, handler) {
+		return this.registerRoute("all", path, optionsOrHandler, handler);
+	}
+	registerRoute(method, path, optionsOrHandler, handler) {
+		const middlewares = [];
+		if (typeof optionsOrHandler === "object") {
+			const options = optionsOrHandler;
+			if (options.middleware) middlewares.push(...options.middleware);
+			if (options.bodySchema) middlewares.push(this.createBodyValidationMiddleware(options.bodySchema));
+			if (options.querySchema) middlewares.push(this.createQueryValidationMiddleware(options.querySchema));
+			middlewares.push(handler);
+		} else middlewares.push(optionsOrHandler);
+		this.router[method](path, ...middlewares);
+		return this;
+	}
+	createBodyValidationMiddleware(schema) {
+		return (req, res, next) => {
+			try {
+				req.body = schema.parse(req.body);
+				next();
+			} catch (error) {
+				if (error instanceof zod.z.ZodError) res.status(400).json({
+					error: "Validation failed",
+					details: error.errors
+				});
+				else next(error);
+			}
+		};
+	}
+	createQueryValidationMiddleware(schema) {
+		return (req, res, next) => {
+			try {
+				req.query = schema.parse(req.query);
+				next();
+			} catch (error) {
+				if (error instanceof zod.z.ZodError) res.status(400).json({
+					error: "Validation failed",
+					details: error.errors
+				});
+				else next(error);
+			}
+		};
+	}
+};
+/**
+
+* Create a new strongly-typed Express router instance.
+
+*
+
+* This is the simplest way to get started with @minisylar/express-typed-router.
+
+*
+
+* @example
+
+* import { createTypedRouter } from '@minisylar/express-typed-router';
+
+*
+
+* // Create a router and add a typed GET route
+
+* const router = createTypedRouter();
+
+* router.get('/hello/:name', (req, res) => {
+
+*   // req.params.name is typed as string
+
+*   res.json({ message: `Hello, ${req.params.name}!` });
+
+* });
+
+*
+
+* // Use with Express
+
+* import express from 'express';
+
+* const app = express();
+
+* app.use('/api', router.getRouter());
+
+*/
+function createTypedRouter() {
+	return new TypedRouter();
+}
+/**
+
+* Create a new typed router with optional configuration.
+
+*
+
+* Use this if you want to add a global error handler or future global options.
+
+*
+
+* @param config - Optional configuration for the router (e.g. error handler).
+
+* @returns A new TypedRouter instance.
+
+*
+
+* @example
+
+* import { createTypedRouterWithConfig } from '@minisylar/express-typed-router';
+
+*
+
+* const router = createTypedRouterWithConfig({
+
+*   errorHandler: (err, req, res, next) => {
+
+*     res.status(500).json({ error: 'Something went wrong', details: err });
+
+*   }
+
+* });
+
+*/
+function createTypedRouterWithConfig(config) {
+	const router = new TypedRouter();
+	if (config?.errorHandler) router.getRouter().use(config.errorHandler);
+	return router;
+}
+/**
+
+* Create a new typed router with pre-configured middleware.
+
+*
+
+* This is useful for setting up router-level middleware in a single call.
+
+*
+
+* @param middleware - One or more TypedMiddleware functions to apply to all routes.
+
+* @returns A new TypedRouter instance with the middleware applied.
+
+*
+
+* @example
+
+* import { createTypedRouterWithMiddleware } from '@minisylar/express-typed-router';
+
+*
+
+* const router = createTypedRouterWithMiddleware(authMiddleware, loggingMiddleware);
+
+*/
+function createTypedRouterWithMiddleware(...middleware) {
+	let router = new TypedRouter();
+	for (const mw of middleware) router = router.useTypedMiddleware(mw);
+	return router;
+}
+
+//#endregion
+exports.TypedRouter = TypedRouter
+exports.createTypedRouter = createTypedRouter
+exports.createTypedRouterWithConfig = createTypedRouterWithConfig
+exports.createTypedRouterWithMiddleware = createTypedRouterWithMiddleware
+//# sourceMappingURL=zod-router.cjs.map

package/dist/zod-router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-router.cjs","names":["middleware: TypedMiddleware<T>","path: string","optionsOrHandler: any","handler?: any","method: HttpMethod","middlewares: any[]","schema: ZodType<any, any, any>","req: Request","res: Response","next: NextFunction","config?: RouterConfig"],"sources":["../src/zod-router.ts"],"sourcesContent":["/**\r\n * @packageDocumentation\r\n * @module @minisylar/express-typed-router\r\n *\r\n * @title @minisylar/express-typed-router\r\n *\r\n * A strongly-typed Express router with Zod validation and automatic type inference for params, body, query, and middleware.\r\n *\r\n * @example\r\n * // Example 1: Basic usage with router-level middleware\r\n * const router = createTypedRouter()\r\n *   .useTypedMiddleware(timestampMiddleware)\r\n *   .useTypedMiddleware(requestIdMiddleware)\r\n *\r\n * router.get('/posts/:postId', (req, res) => {\r\n *   const { postId } = req.params // Typed as { postId: string }\r\n *   const { timestamp, requestId } = req // Both properties are now typed correctly!\r\n *   res.json({ postId, timestamp, requestId })\r\n * })\r\n *\r\n * @example\r\n * // Example 2: Per-route middleware with automatic type inference\r\n * router.post(\r\n *   '/posts',\r\n *   {\r\n *     bodySchema: CreatePostSchema,\r\n *     middleware: [timestampMiddleware, requestIdMiddleware] as const\r\n *   },\r\n *   (req, res) => {\r\n *     const { title, content, tags } = req.body // From schema validation\r\n *     const { timestamp, requestId } = req // From middleware - should be automatically typed!\r\n *     res.json({ title, content, tags, timestamp, requestId })\r\n *   }\r\n * )\r\n *\r\n * @example\r\n * // Example 3: Mixed middleware\r\n * const router = createTypedRouter().useTypedMiddleware(requestIdMiddleware)\r\n * router.get(\r\n *   '/posts/:postId',\r\n *   {\r\n *     middleware: [authMiddleware] as const\r\n *   },\r\n *   (req, res) => {\r\n *     const { postId } = req.params\r\n *     const { requestId } = req // From router-level middleware\r\n *     const { userId, hasPermission } = req // From per-route middleware\r\n *     res.json({ postId, requestId, userId, hasPermission })\r\n *   }\r\n * )\r\n *\r\n * @example\r\n * // Example 4: Using factory with pre-configured middleware\r\n * const router = createTypedRouterWithMiddleware(timestampMiddleware, requestIdMiddleware)\r\n * router.get('/simple/:id', (req, res) => {\r\n *   const { id } = req.params\r\n *   const { timestamp, requestId } = req // Already available from factory setup!\r\n *   res.json({ id, timestamp, requestId })\r\n * })\r\n *\r\n * @example\r\n * // Example 5: Demonstrating all HTTP methods\r\n * const router = createTypedRouter().useTypedMiddleware(requestIdMiddleware)\r\n *\r\n * // GET with query validation\r\n * router.get('/posts', { querySchema: QuerySchema }, (req, res) => {\r\n *   const { limit, offset } = req.query // Typed from schema\r\n *   const { requestId } = req // From router middleware\r\n *   res.json({ posts: [], limit, offset, requestId })\r\n * })\r\n *\r\n * // POST with body validation and middleware\r\n * router.post(\r\n *   '/posts',\r\n *   {\r\n *     bodySchema: CreatePostSchema,\r\n *     middleware: [timestampMiddleware] as const\r\n *   },\r\n *   (req, res) => {\r\n *     const { title, content } = req.body // From body schema\r\n *     const { requestId, timestamp } = req // From middleware\r\n *     res.json({ id: 'new-post', title, content, requestId, timestamp })\r\n *   }\r\n * )\r\n *\r\n * // PUT for full updates\r\n * router.put(\r\n *   '/posts/:postId',\r\n *   {\r\n *     bodySchema: CreatePostSchema,\r\n *     middleware: [authMiddleware] as const\r\n *   },\r\n *   (req, res) => {\r\n *     const { postId } = req.params\r\n *     const { title, content } = req.body\r\n *     const { requestId, userId, hasPermission } = req\r\n *     res.json({ postId, title, content, requestId, userId, hasPermission })\r\n *   }\r\n * )\r\n *\r\n * // PATCH for partial updates\r\n * router.patch('/posts/:postId', { bodySchema: UpdatePostSchema }, (req, res) => {\r\n *   const { postId } = req.params\r\n *   const updates = req.body // Partial update object\r\n *   const { requestId } = req\r\n *   res.json({ postId, updates, requestId })\r\n * })\r\n *\r\n * // DELETE\r\n * router.delete('/posts/:postId', (req, res) => {\r\n *   const { postId } = req.params\r\n *   const { requestId } = req\r\n *   res.json({ deleted: postId, requestId })\r\n * })\r\n *\r\n * // OPTIONS for CORS preflight\r\n * router.options('/posts/*', (req, res) => {\r\n *   res.header('Access-Control-Allow-Methods', 'GET,POST,PUT,PATCH,DELETE')\r\n *   res.header('Access-Control-Allow-Headers', 'Content-Type')\r\n *   res.status(200).end()\r\n * })\r\n *\r\n * // HEAD for metadata only\r\n * router.head('/posts/:postId', (req, res) => {\r\n *   const { postId } = req.params\r\n *   res.header('X-Post-ID', postId)\r\n *   res.status(200).end()\r\n * })\r\n *\r\n * // ALL method for catch-all routes\r\n * router.all('/debug/*', (req, res) => {\r\n *   const { requestId } = req\r\n *   res.json({\r\n *     method: req.method,\r\n *     path: req.path,\r\n *     requestId\r\n *   })\r\n * })\r\n */\r\n/* eslint-disable @typescript-eslint/no-empty-object-type */\r\nimport express, {\r\n  type Request,\r\n  type Response,\r\n  type NextFunction,\r\n} from \"express\";\r\nimport { z, type ZodType } from \"zod\";\r\n\r\n/**\r\n * Extract route parameters from Express.js route patterns.\r\n *\r\n * Supports all Express.js routing patterns:\r\n * - Named parameters: /users/:userId → { userId: string }\r\n * - Multiple parameters: /users/:userId/books/:bookId → { userId: string; bookId: string }\r\n * - Parameters with separators: /flights/:from-:to → { from: string; to: string }\r\n * - Dot notation: /plantae/:genus.:species → { genus: string; species: string }\r\n * - Regex constraints: /user/:id(\\\\d+) → { id: string }\r\n * - Optional parameters: /posts/:year/:month? → { year: string; month?: string }\r\n * - Wildcard parameters: /files/* → { \"0\": string }\r\n * - Multiple wildcards: /a/star/b/star → { \"0\": string; \"1\": string }\r\n */\r\nexport type ExtractRouteParams<Path extends string> = string extends Path\r\n  ? Record<string, string>\r\n  : ExtractParams<Path>;\r\n\r\n/**\r\n * Main parameter extraction logic - enhanced for Express 5 support\r\n */\r\ntype ExtractParams<Path extends string> =\r\n  // Handle Express 5 braces for optional segments: {/:param} or {/path/:param}\r\n  Path extends `${infer Before}{${infer OptionalContent}}${infer After}`\r\n    ? ExtractOptionalSegment<OptionalContent> &\r\n        ExtractParams<`${Before}${After}`>\r\n    : // Handle named parameters :paramName\r\n    Path extends `${infer _Before}:${infer Rest}`\r\n    ? ExtractSingleParam<Rest> & ExtractParams<RemoveFirstParam<Path>>\r\n    : // Handle wildcards *\r\n    Path extends `${infer _Before}*${infer After}`\r\n    ? { [K in CountWildcards<_Before>]: string } & ExtractParams<After>\r\n    : // No more parameters\r\n      {};\r\n\r\n/**\r\n * Extract parameters from Express 5 optional segments in braces\r\n * Handles patterns like {/:param}, {.:ext}, {/optional/:param}\r\n */\r\ntype ExtractOptionalSegment<Content extends string> =\r\n  // Handle optional parameter patterns like /:param\r\n  Content extends `/:${infer Rest}`\r\n    ? ExtractOptionalParam<Rest>\r\n    : Content extends `.:${infer Rest}`\r\n    ? ExtractOptionalParam<Rest>\r\n    : Content extends `${infer _Path}:${infer Rest}`\r\n    ? ExtractOptionalParam<Rest>\r\n    : {};\r\n\r\n/**\r\n * Extract a single optional parameter from brace content\r\n */\r\ntype ExtractOptionalParam<Rest extends string> =\r\n  Rest extends `${infer ParamName}/${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}-${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}.${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}`\r\n    ? { [K in ParamName]?: string }\r\n    : {};\r\n\r\n/**\r\n * Extract a single parameter name from the rest of the path\r\n * Enhanced to handle Express 5 patterns and optional parameters correctly\r\n * Special handling for consecutive parameters like :from-:to\r\n * Order matters: regex constraints must be handled before repeating parameters\r\n */\r\ntype ExtractSingleParam<Rest extends string> =\r\n  // Handle regex constraints FIRST (before +, *, ?) to avoid conflicts\r\n  Rest extends `${infer ParamName}(${infer _Constraint})${infer _After}`\r\n    ? { [K in ParamName]: string } // Handle consecutive parameters with separators first: param-:nextParam\r\n    : Rest extends `${infer ParamName}-:${infer _NextParam}`\r\n    ? { [K in ParamName]: string }\r\n    : Rest extends `${infer ParamName}.:${infer _NextParam}`\r\n    ? { [K in ParamName]: string }\r\n    : // Handle optional parameters followed by delimiters (before regular delimiters)\r\n    Rest extends `${infer ParamName}?/${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}?-${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}?.${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}?#${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : Rest extends `${infer ParamName}?:${infer _After}`\r\n    ? { [K in ParamName]?: string }\r\n    : // Then handle regular delimiters (after optional parameter patterns)\r\n    Rest extends `${infer ParamName}/${infer _After}`\r\n    ? { [K in ParamName]: string }\r\n    : Rest extends `${infer ParamName}-${infer _After}`\r\n    ? { [K in ParamName]: string }\r\n    : Rest extends `${infer ParamName}.${infer _After}`\r\n    ? { [K in ParamName]: string }\r\n    : Rest extends `${infer ParamName}#${infer _After}`\r\n    ? { [K in ParamName]: string }\r\n    : Rest extends `${infer ParamName}:${infer _After}`\r\n    ? { [K in ParamName]: string }\r\n    : // Handle Express 5 repeating parameters (after regular delimiters)\r\n    Rest extends `${infer ParamName}+${infer _After}`\r\n    ? { [K in ParamName]: string[] }\r\n    : Rest extends `${infer ParamName}*${infer _After}`\r\n    ? { [K in ParamName]?: string[] }\r\n    : // Handle optional parameters with ? (Express 4) - only at the end of a segment\r\n    Rest extends `${infer ParamName}?${infer _After}`\r\n    ? { [K in ParamName]?: string } // Parameter at absolute end of string\r\n    : Rest extends string\r\n    ? Rest extends \"\"\r\n      ? {}\r\n      : Rest extends `${infer ParamName}?`\r\n      ? { [K in ParamName]?: string } // ParamName here doesn't include the ?\r\n      : Rest extends `${infer ParamName}+`\r\n      ? { [K in ParamName]: string[] }\r\n      : Rest extends `${infer ParamName}*`\r\n      ? { [K in ParamName]?: string[] }\r\n      : { [K in Rest]: string }\r\n    : {};\r\n\r\n/**\r\n * Remove the first parameter from path to continue parsing\r\n * Enhanced to handle Express 5 patterns and optional parameters\r\n * Handles patterns like :from-:to by removing just :from and keeping -:to\r\n * Order matters: regex constraints must be handled before repeating parameters\r\n */\r\ntype RemoveFirstParam<Path extends string> =\r\n  Path extends `${infer Before}:${infer Rest}`\r\n    ? // Handle regex constraints FIRST (before +, *, ?) to avoid conflicts\r\n      Rest extends `${infer _ParamName}(${infer _Constraint})${infer After}`\r\n      ? `${Before}${After}` // Handle consecutive parameters: :param-:nextParam -> -:nextParam\r\n      : Rest extends `${infer _ParamName}-:${infer After}`\r\n      ? `${Before}-:${After}`\r\n      : Rest extends `${infer _ParamName}.:${infer After}`\r\n      ? `${Before}.:${After}`\r\n      : // Handle optional parameters followed by delimiters (before regular delimiters)\r\n      Rest extends `${infer _ParamName}?/${infer After}`\r\n      ? `${Before}/${After}`\r\n      : Rest extends `${infer _ParamName}?-${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}?.${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}?#${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}?:${infer After}`\r\n      ? `${Before}:${After}`\r\n      : // Handle regular separators (after optional parameter patterns)\r\n      Rest extends `${infer _ParamName}/${infer After}`\r\n      ? `${Before}/${After}`\r\n      : Rest extends `${infer _ParamName}-${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}.${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}#${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}:${infer After}`\r\n      ? `${Before}:${After}`\r\n      : // Handle Express 5 repeating parameters (after regular separators)\r\n      Rest extends `${infer _ParamName}+${infer After}`\r\n      ? `${Before}${After}`\r\n      : Rest extends `${infer _ParamName}*${infer After}`\r\n      ? `${Before}${After}`\r\n      : // Handle optional parameters with ?\r\n      Rest extends `${infer _ParamName}?${infer After}`\r\n      ? `${Before}${After}`\r\n      : Before\r\n    : Path;\r\n\r\n/**\r\n * Count wildcards to assign proper numeric indices\r\n */\r\ntype CountWildcards<\r\n  Path extends string,\r\n  Count extends string = \"0\"\r\n> = Path extends `${infer _Before}*${infer Rest}`\r\n  ? CountWildcards<Rest, IncrementWildcard<Count>>\r\n  : Count;\r\n\r\n/**\r\n * Helper type to increment wildcard count as string\r\n */\r\ntype IncrementWildcard<T extends string> = T extends \"0\"\r\n  ? \"1\"\r\n  : T extends \"1\"\r\n  ? \"2\"\r\n  : T extends \"2\"\r\n  ? \"3\"\r\n  : T extends \"3\"\r\n  ? \"4\"\r\n  : T extends \"4\"\r\n  ? \"5\"\r\n  : T extends \"5\"\r\n  ? \"6\"\r\n  : T extends \"6\"\r\n  ? \"7\"\r\n  : T extends \"7\"\r\n  ? \"8\"\r\n  : T extends \"8\"\r\n  ? \"9\"\r\n  : \"10\"; // Reasonable limit for wildcards\r\n\r\n/**\r\n * Express middleware that adds custom properties to the request object.\r\n *\r\n * @template T - The shape of the properties added to the request.\r\n * @param req - The Express request object, extended with T.\r\n * @param res - The Express response object.\r\n * @param next - The next middleware function.\r\n */\r\nexport type TypedMiddleware<T extends Record<string, any>> = (\r\n  req: Request & T,\r\n  res: Response,\r\n  next: NextFunction\r\n) => void | Promise<void>;\r\n\r\n// Utility type to infer props from middleware array\r\ntype InferMiddlewareProps<T extends readonly TypedMiddleware<any>[]> =\r\n  T extends readonly [infer First, ...infer Rest]\r\n    ? First extends TypedMiddleware<infer FirstType>\r\n      ? Rest extends readonly TypedMiddleware<any>[]\r\n        ? FirstType & InferMiddlewareProps<Rest>\r\n        : FirstType\r\n      : {}\r\n    : {};\r\n\r\n// Enhanced Request type with proper inference\r\nexport type ZodRequest<\r\n  Path extends string = string,\r\n  BodySchema extends ZodType<any, any, any> | unknown = unknown,\r\n  QuerySchema extends ZodType<any, any, any> | unknown = unknown,\r\n  MiddlewareProps extends Record<string, any> = {}\r\n> = Omit<Request, \"params\" | \"query\" | \"body\"> & {\r\n  params: ExtractRouteParams<Path>;\r\n  body: BodySchema extends ZodType<any, any, any>\r\n    ? z.infer<BodySchema>\r\n    : unknown;\r\n  query: QuerySchema extends ZodType<any, any, any>\r\n    ? z.infer<QuerySchema>\r\n    : unknown;\r\n} & MiddlewareProps;\r\n\r\n// Route handler type\r\nexport type ZodRouteHandler<\r\n  Path extends string = string,\r\n  BodySchema extends ZodType<any, any, any> | unknown = unknown,\r\n  QuerySchema extends ZodType<any, any, any> | unknown = unknown,\r\n  MiddlewareProps extends Record<string, any> = {}\r\n> = (\r\n  req: ZodRequest<Path, BodySchema, QuerySchema, MiddlewareProps>,\r\n  res: Response,\r\n  next?: NextFunction\r\n) => void | Promise<void> | Response | Promise<Response>;\r\n\r\n/**\r\n * Options for defining a typed route, including schemas and middleware.\r\n *\r\n * @template BodySchema - Zod schema for request body validation.\r\n * @template QuerySchema - Zod schema for query parameter validation.\r\n * @property bodySchema - Optional Zod schema for validating the request body.\r\n * @property querySchema - Optional Zod schema for validating the query string.\r\n * @property middleware - Optional array of TypedMiddleware for this route.\r\n */\r\nexport interface RouteOptions<\r\n  BodySchema extends ZodType<any, any, any> | unknown = unknown,\r\n  QuerySchema extends ZodType<any, any, any> | unknown = unknown\r\n> {\r\n  bodySchema?: BodySchema extends ZodType<any, any, any> ? BodySchema : never;\r\n  querySchema?: QuerySchema extends ZodType<any, any, any>\r\n    ? QuerySchema\r\n    : never;\r\n  middleware?: readonly TypedMiddleware<any>[];\r\n}\r\n\r\n// HTTP methods\r\nexport type HttpMethod =\r\n  | \"get\"\r\n  | \"post\"\r\n  | \"put\"\r\n  | \"delete\"\r\n  | \"patch\"\r\n  | \"options\"\r\n  | \"head\"\r\n  | \"all\";\r\n\r\n// Main typed router class\r\nexport class TypedRouter<\r\n  RouterMiddlewareProps extends Record<string, any> = {}\r\n> {\r\n  private router: express.Router;\r\n\r\n  constructor() {\r\n    this.router = express.Router();\r\n  }\r\n\r\n  /**\r\n   * Add typed middleware that extends the request with additional properties\r\n   */\r\n  useTypedMiddleware<T extends Record<string, any>>(\r\n    middleware: TypedMiddleware<T>\r\n  ): TypedRouter<RouterMiddlewareProps & T> {\r\n    this.router.use(middleware as any);\r\n    return this as any;\r\n  }\r\n\r\n  /**\r\n   * Get the underlying Express router\r\n   */\r\n  getRouter(): express.Router {\r\n    return this.router;\r\n  }\r\n\r\n  // Method overloads for GET requests with automatic middleware type inference\r\n  get<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  get<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any> | unknown,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: RouteOptions<BodySchema, QuerySchema>,\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Special overload for middleware type inference\r\n  get<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Combined overload for body/query schema + middleware\r\n  get<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any> | unknown,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: RouteOptions<BodySchema, QuerySchema> & { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Implementation\r\n  get(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"get\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // Combined overload for body/query schema + middleware (most specific first)\r\n  post<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: {\r\n      bodySchema: BodySchema;\r\n      querySchema?: QuerySchema;\r\n      middleware: Middleware;\r\n    },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Body schema only + middleware\r\n  post<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { bodySchema: BodySchema; middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Middleware only\r\n  post<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Body + Query schema without middleware\r\n  post<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any> | unknown,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: RouteOptions<BodySchema, QuerySchema>,\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  // Just handler, no options\r\n  post<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  post(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"post\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // PUT method with all the same overloads as POST\r\n  put<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: {\r\n      bodySchema: BodySchema;\r\n      querySchema?: QuerySchema;\r\n      middleware: Middleware;\r\n    },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  put<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { bodySchema: BodySchema; middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  put<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  put<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any> | unknown,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: RouteOptions<BodySchema, QuerySchema>,\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  put<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  put(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"put\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // PATCH method with all the same overloads as POST\r\n  patch<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: {\r\n      bodySchema: BodySchema;\r\n      querySchema?: QuerySchema;\r\n      middleware: Middleware;\r\n    },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  patch<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { bodySchema: BodySchema; middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  patch<\r\n    Path extends string,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  patch<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any> | unknown,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: RouteOptions<BodySchema, QuerySchema>,\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  patch<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  patch(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"patch\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // DELETE method (typically no body, but can have query params and middleware)\r\n  delete<\r\n    Path extends string,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  delete<\r\n    Path extends string,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { querySchema: QuerySchema; middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  delete<\r\n    Path extends string,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: { querySchema: QuerySchema },\r\n    handler: ZodRouteHandler<Path, unknown, QuerySchema, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  delete<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  delete(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"delete\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // OPTIONS method (typically no body, used for CORS preflight)\r\n  options<\r\n    Path extends string,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  options<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  options(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"options\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // HEAD method (like GET but only returns headers)\r\n  head<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  head<\r\n    Path extends string,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { querySchema: QuerySchema; middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  head<\r\n    Path extends string,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: { querySchema: QuerySchema },\r\n    handler: ZodRouteHandler<Path, unknown, QuerySchema, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  head<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  head(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"head\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // ALL method (matches all HTTP methods)\r\n  all<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    QuerySchema extends ZodType<any, any, any> | unknown,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: {\r\n      bodySchema: BodySchema;\r\n      querySchema?: QuerySchema;\r\n      middleware: Middleware;\r\n    },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  all<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any>,\r\n    Middleware extends readonly TypedMiddleware<any>[]\r\n  >(\r\n    path: Path,\r\n    options: { bodySchema: BodySchema; middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  all<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\r\n    path: Path,\r\n    options: { middleware: Middleware },\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      unknown,\r\n      unknown,\r\n      RouterMiddlewareProps & InferMiddlewareProps<Middleware>\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  all<\r\n    Path extends string,\r\n    BodySchema extends ZodType<any, any, any> | unknown,\r\n    QuerySchema extends ZodType<any, any, any> | unknown\r\n  >(\r\n    path: Path,\r\n    options: RouteOptions<BodySchema, QuerySchema>,\r\n    handler: ZodRouteHandler<\r\n      Path,\r\n      BodySchema,\r\n      QuerySchema,\r\n      RouterMiddlewareProps\r\n    >\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  all<Path extends string>(\r\n    path: Path,\r\n    handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\r\n  ): TypedRouter<RouterMiddlewareProps>;\r\n\r\n  all(\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    return this.registerRoute(\"all\", path, optionsOrHandler, handler);\r\n  }\r\n\r\n  // Helper method to register routes\r\n  private registerRoute(\r\n    method: HttpMethod,\r\n    path: string,\r\n    optionsOrHandler: any,\r\n    handler?: any\r\n  ): TypedRouter<RouterMiddlewareProps> {\r\n    const middlewares: any[] = [];\r\n\r\n    if (typeof optionsOrHandler === \"object\") {\r\n      const options = optionsOrHandler as RouteOptions<any, any>;\r\n\r\n      // Add per-route middleware first\r\n      if (options.middleware) {\r\n        middlewares.push(...options.middleware);\r\n      }\r\n\r\n      // Add schema validation middleware\r\n      if (options.bodySchema) {\r\n        middlewares.push(\r\n          this.createBodyValidationMiddleware(options.bodySchema)\r\n        );\r\n      }\r\n      if (options.querySchema) {\r\n        middlewares.push(\r\n          this.createQueryValidationMiddleware(options.querySchema)\r\n        );\r\n      }\r\n\r\n      // Add the main handler\r\n      middlewares.push(handler);\r\n    } else {\r\n      // Direct handler without options\r\n      middlewares.push(optionsOrHandler);\r\n    }\r\n\r\n    // Register with Express router\r\n    (this.router as any)[method](path, ...middlewares);\r\n\r\n    return this;\r\n  }\r\n\r\n  private createBodyValidationMiddleware(schema: ZodType<any, any, any>) {\r\n    return (req: Request, res: Response, next: NextFunction) => {\r\n      try {\r\n        req.body = schema.parse(req.body);\r\n        next();\r\n      } catch (error) {\r\n        if (error instanceof z.ZodError) {\r\n          res.status(400).json({\r\n            error: \"Validation failed\",\r\n            details: error.errors,\r\n          });\r\n        } else {\r\n          next(error);\r\n        }\r\n      }\r\n    };\r\n  }\r\n\r\n  private createQueryValidationMiddleware(schema: ZodType<any, any, any>) {\r\n    return (req: Request, res: Response, next: NextFunction) => {\r\n      try {\r\n        req.query = schema.parse(req.query);\r\n        next();\r\n      } catch (error) {\r\n        if (error instanceof z.ZodError) {\r\n          res.status(400).json({\r\n            error: \"Validation failed\",\r\n            details: error.errors,\r\n          });\r\n        } else {\r\n          next(error);\r\n        }\r\n      }\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Create a new strongly-typed Express router instance.\r\n *\r\n * This is the simplest way to get started with @minisylar/express-typed-router.\r\n *\r\n * @example\r\n * import { createTypedRouter } from '@minisylar/express-typed-router';\r\n *\r\n * // Create a router and add a typed GET route\r\n * const router = createTypedRouter();\r\n * router.get('/hello/:name', (req, res) => {\r\n *   // req.params.name is typed as string\r\n *   res.json({ message: `Hello, ${req.params.name}!` });\r\n * });\r\n *\r\n * // Use with Express\r\n * import express from 'express';\r\n * const app = express();\r\n * app.use('/api', router.getRouter());\r\n */\r\nexport function createTypedRouter<\r\n  RouterMiddlewareProps extends Record<string, any> = {}\r\n>(): TypedRouter<RouterMiddlewareProps> {\r\n  return new TypedRouter<RouterMiddlewareProps>();\r\n}\r\n\r\n// Option 2: Factory with optional configuration\r\n\r\n/**\r\n * Configuration options for createTypedRouterWithConfig.\r\n *\r\n * @property validateInput - (Future) Whether to enable global input validation.\r\n * @property errorHandler - Optional global error handler middleware for the router.\r\n */\r\nexport interface RouterConfig {\r\n  validateInput?: boolean;\r\n  errorHandler?: (\r\n    error: any,\r\n    req: Request,\r\n    res: Response,\r\n    next: NextFunction\r\n  ) => void;\r\n}\r\n\r\n/**\r\n * Create a new typed router with optional configuration.\r\n *\r\n * Use this if you want to add a global error handler or future global options.\r\n *\r\n * @param config - Optional configuration for the router (e.g. error handler).\r\n * @returns A new TypedRouter instance.\r\n *\r\n * @example\r\n * import { createTypedRouterWithConfig } from '@minisylar/express-typed-router';\r\n *\r\n * const router = createTypedRouterWithConfig({\r\n *   errorHandler: (err, req, res, next) => {\r\n *     res.status(500).json({ error: 'Something went wrong', details: err });\r\n *   }\r\n * });\r\n */\r\nexport function createTypedRouterWithConfig<\r\n  RouterMiddlewareProps extends Record<string, any> = {}\r\n>(config?: RouterConfig): TypedRouter<RouterMiddlewareProps> {\r\n  const router = new TypedRouter<RouterMiddlewareProps>();\r\n  if (config?.errorHandler) {\r\n    router.getRouter().use(config.errorHandler);\r\n  }\r\n  return router;\r\n}\r\n\r\n// Option 3: Factory with pre-configured middleware\r\n\r\n/**\r\n * Create a new typed router with pre-configured middleware.\r\n *\r\n * This is useful for setting up router-level middleware in a single call.\r\n *\r\n * @param middleware - One or more TypedMiddleware functions to apply to all routes.\r\n * @returns A new TypedRouter instance with the middleware applied.\r\n *\r\n * @example\r\n * import { createTypedRouterWithMiddleware } from '@minisylar/express-typed-router';\r\n *\r\n * const router = createTypedRouterWithMiddleware(authMiddleware, loggingMiddleware);\r\n */\r\nexport function createTypedRouterWithMiddleware<T extends Record<string, any>>(\r\n  ...middleware: TypedMiddleware<any>[]\r\n): TypedRouter<T> {\r\n  let router = new TypedRouter() as any;\r\n  for (const mw of middleware) {\r\n    router = router.useTypedMiddleware(mw);\r\n  }\r\n  return router;\r\n}\r\n"],"mappings":"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"}