@minisylar/express-typed-router 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,3 @@
1
- "use strict";
2
1
  //#region rolldown:runtime
3
2
  var __create = Object.create;
4
3
  var __defProp = Object.defineProperty;
@@ -32,18 +31,14 @@ var TypedRouter = class {
32
31
  this.router = express.default.Router();
33
32
  }
34
33
  /**
35
-
36
34
  * Add typed middleware that extends the request with additional properties
37
-
38
35
  */
39
36
  useTypedMiddleware(middleware) {
40
37
  this.router.use(middleware);
41
38
  return this;
42
39
  }
43
40
  /**
44
-
45
41
  * Get the underlying Express router
46
-
47
42
  */
48
43
  getRouter() {
49
44
  return this.router;
@@ -114,79 +109,44 @@ var TypedRouter = class {
114
109
  }
115
110
  };
116
111
  /**
117
-
118
112
  * Create a new strongly-typed Express router instance.
119
-
120
113
  *
121
-
122
114
  * This is the simplest way to get started with @minisylar/express-typed-router.
123
-
124
115
  *
125
-
126
116
  * @example
127
-
128
117
  * import { createTypedRouter } from '@minisylar/express-typed-router';
129
-
130
118
  *
131
-
132
119
  * // Create a router and add a typed GET route
133
-
134
120
  * const router = createTypedRouter();
135
-
136
121
  * router.get('/hello/:name', (req, res) => {
137
-
138
122
  * // req.params.name is typed as string
139
-
140
123
  * res.json({ message: `Hello, ${req.params.name}!` });
141
-
142
124
  * });
143
-
144
125
  *
145
-
146
126
  * // Use with Express
147
-
148
127
  * import express from 'express';
149
-
150
128
  * const app = express();
151
-
152
129
  * app.use('/api', router.getRouter());
153
-
154
130
  */
155
131
  function createTypedRouter() {
156
132
  return new TypedRouter();
157
133
  }
158
134
  /**
159
-
160
135
  * Create a new typed router with optional configuration.
161
-
162
136
  *
163
-
164
137
  * Use this if you want to add a global error handler or future global options.
165
-
166
138
  *
167
-
168
139
  * @param config - Optional configuration for the router (e.g. error handler).
169
-
170
140
  * @returns A new TypedRouter instance.
171
-
172
141
  *
173
-
174
142
  * @example
175
-
176
143
  * import { createTypedRouterWithConfig } from '@minisylar/express-typed-router';
177
-
178
144
  *
179
-
180
145
  * const router = createTypedRouterWithConfig({
181
-
182
146
  * errorHandler: (err, req, res, next) => {
183
-
184
147
  * res.status(500).json({ error: 'Something went wrong', details: err });
185
-
186
148
  * }
187
-
188
149
  * });
189
-
190
150
  */
191
151
  function createTypedRouterWithConfig(config) {
192
152
  const router = new TypedRouter();
@@ -194,29 +154,17 @@ function createTypedRouterWithConfig(config) {
194
154
  return router;
195
155
  }
196
156
  /**
197
-
198
157
  * Create a new typed router with pre-configured middleware.
199
-
200
158
  *
201
-
202
159
  * This is useful for setting up router-level middleware in a single call.
203
-
204
160
  *
205
-
206
161
  * @param middleware - One or more TypedMiddleware functions to apply to all routes.
207
-
208
162
  * @returns A new TypedRouter instance with the middleware applied.
209
-
210
163
  *
211
-
212
164
  * @example
213
-
214
165
  * import { createTypedRouterWithMiddleware } from '@minisylar/express-typed-router';
215
-
216
166
  *
217
-
218
167
  * const router = createTypedRouterWithMiddleware(authMiddleware, loggingMiddleware);
219
-
220
168
  */
221
169
  function createTypedRouterWithMiddleware(...middleware) {
222
170
  let router = new TypedRouter();
@@ -225,8 +173,8 @@ function createTypedRouterWithMiddleware(...middleware) {
225
173
  }
226
174
 
227
175
  //#endregion
228
- exports.TypedRouter = TypedRouter
229
- exports.createTypedRouter = createTypedRouter
230
- exports.createTypedRouterWithConfig = createTypedRouterWithConfig
231
- exports.createTypedRouterWithMiddleware = createTypedRouterWithMiddleware
176
+ exports.TypedRouter = TypedRouter;
177
+ exports.createTypedRouter = createTypedRouter;
178
+ exports.createTypedRouterWithConfig = createTypedRouterWithConfig;
179
+ exports.createTypedRouterWithMiddleware = createTypedRouterWithMiddleware;
232
180
  //# sourceMappingURL=zod-router.cjs.map
@@ -1 +1 @@
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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"}
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","z","config?: RouterConfig"],"sources":["../src/zod-router.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * @module @minisylar/express-typed-router\n *\n * @title @minisylar/express-typed-router\n *\n * A strongly-typed Express router with Zod validation and automatic type inference for params, body, query, and middleware.\n *\n * @example\n * // Example 1: Basic usage with router-level middleware\n * const router = createTypedRouter()\n * .useTypedMiddleware(timestampMiddleware)\n * .useTypedMiddleware(requestIdMiddleware)\n *\n * router.get('/posts/:postId', (req, res) => {\n * const { postId } = req.params // Typed as { postId: string }\n * const { timestamp, requestId } = req // Both properties are now typed correctly!\n * res.json({ postId, timestamp, requestId })\n * })\n *\n * @example\n * // Example 2: Per-route middleware with automatic type inference\n * router.post(\n * '/posts',\n * {\n * bodySchema: CreatePostSchema,\n * middleware: [timestampMiddleware, requestIdMiddleware] as const\n * },\n * (req, res) => {\n * const { title, content, tags } = req.body // From schema validation\n * const { timestamp, requestId } = req // From middleware - should be automatically typed!\n * res.json({ title, content, tags, timestamp, requestId })\n * }\n * )\n *\n * @example\n * // Example 3: Mixed middleware\n * const router = createTypedRouter().useTypedMiddleware(requestIdMiddleware)\n * router.get(\n * '/posts/:postId',\n * {\n * middleware: [authMiddleware] as const\n * },\n * (req, res) => {\n * const { postId } = req.params\n * const { requestId } = req // From router-level middleware\n * const { userId, hasPermission } = req // From per-route middleware\n * res.json({ postId, requestId, userId, hasPermission })\n * }\n * )\n *\n * @example\n * // Example 4: Using factory with pre-configured middleware\n * const router = createTypedRouterWithMiddleware(timestampMiddleware, requestIdMiddleware)\n * router.get('/simple/:id', (req, res) => {\n * const { id } = req.params\n * const { timestamp, requestId } = req // Already available from factory setup!\n * res.json({ id, timestamp, requestId })\n * })\n *\n * @example\n * // Example 5: Demonstrating all HTTP methods\n * const router = createTypedRouter().useTypedMiddleware(requestIdMiddleware)\n *\n * // GET with query validation\n * router.get('/posts', { querySchema: QuerySchema }, (req, res) => {\n * const { limit, offset } = req.query // Typed from schema\n * const { requestId } = req // From router middleware\n * res.json({ posts: [], limit, offset, requestId })\n * })\n *\n * // POST with body validation and middleware\n * router.post(\n * '/posts',\n * {\n * bodySchema: CreatePostSchema,\n * middleware: [timestampMiddleware] as const\n * },\n * (req, res) => {\n * const { title, content } = req.body // From body schema\n * const { requestId, timestamp } = req // From middleware\n * res.json({ id: 'new-post', title, content, requestId, timestamp })\n * }\n * )\n *\n * // PUT for full updates\n * router.put(\n * '/posts/:postId',\n * {\n * bodySchema: CreatePostSchema,\n * middleware: [authMiddleware] as const\n * },\n * (req, res) => {\n * const { postId } = req.params\n * const { title, content } = req.body\n * const { requestId, userId, hasPermission } = req\n * res.json({ postId, title, content, requestId, userId, hasPermission })\n * }\n * )\n *\n * // PATCH for partial updates\n * router.patch('/posts/:postId', { bodySchema: UpdatePostSchema }, (req, res) => {\n * const { postId } = req.params\n * const updates = req.body // Partial update object\n * const { requestId } = req\n * res.json({ postId, updates, requestId })\n * })\n *\n * // DELETE\n * router.delete('/posts/:postId', (req, res) => {\n * const { postId } = req.params\n * const { requestId } = req\n * res.json({ deleted: postId, requestId })\n * })\n *\n * // OPTIONS for CORS preflight\n * router.options('/posts/*', (req, res) => {\n * res.header('Access-Control-Allow-Methods', 'GET,POST,PUT,PATCH,DELETE')\n * res.header('Access-Control-Allow-Headers', 'Content-Type')\n * res.status(200).end()\n * })\n *\n * // HEAD for metadata only\n * router.head('/posts/:postId', (req, res) => {\n * const { postId } = req.params\n * res.header('X-Post-ID', postId)\n * res.status(200).end()\n * })\n *\n * // ALL method for catch-all routes\n * router.all('/debug/*', (req, res) => {\n * const { requestId } = req\n * res.json({\n * method: req.method,\n * path: req.path,\n * requestId\n * })\n * })\n */\n/* eslint-disable @typescript-eslint/no-empty-object-type */\nimport express, {\n type Request,\n type Response,\n type NextFunction,\n} from \"express\";\nimport { z, type ZodType } from \"zod\";\n\n/**\n * Extract route parameters from Express.js route patterns.\n *\n * Supports all Express.js routing patterns:\n * - Named parameters: /users/:userId → { userId: string }\n * - Multiple parameters: /users/:userId/books/:bookId → { userId: string; bookId: string }\n * - Parameters with separators: /flights/:from-:to → { from: string; to: string }\n * - Dot notation: /plantae/:genus.:species → { genus: string; species: string }\n * - Regex constraints: /user/:id(\\\\d+) → { id: string }\n * - Optional parameters: /posts/:year/:month? → { year: string; month?: string }\n * - Wildcard parameters: /files/* → { \"0\": string }\n * - Multiple wildcards: /a/star/b/star → { \"0\": string; \"1\": string }\n */\nexport type ExtractRouteParams<Path extends string> = string extends Path\n ? Record<string, string>\n : ExtractParams<Path>;\n\n/**\n * Main parameter extraction logic - enhanced for Express 5 support\n */\ntype ExtractParams<Path extends string> =\n // Handle Express 5 braces for optional segments: {/:param} or {/path/:param}\n Path extends `${infer Before}{${infer OptionalContent}}${infer After}`\n ? ExtractOptionalSegment<OptionalContent> &\n ExtractParams<`${Before}${After}`>\n : // Handle named parameters :paramName\n Path extends `${infer _Before}:${infer Rest}`\n ? ExtractSingleParam<Rest> & ExtractParams<RemoveFirstParam<Path>>\n : // Handle wildcards *\n Path extends `${infer _Before}*${infer After}`\n ? { [K in CountWildcards<_Before>]: string } & ExtractParams<After>\n : // No more parameters\n {};\n\n/**\n * Extract parameters from Express 5 optional segments in braces\n * Handles patterns like {/:param}, {.:ext}, {/optional/:param}\n */\ntype ExtractOptionalSegment<Content extends string> =\n // Handle optional parameter patterns like /:param\n Content extends `/:${infer Rest}`\n ? ExtractOptionalParam<Rest>\n : Content extends `.:${infer Rest}`\n ? ExtractOptionalParam<Rest>\n : Content extends `${infer _Path}:${infer Rest}`\n ? ExtractOptionalParam<Rest>\n : {};\n\n/**\n * Extract a single optional parameter from brace content\n */\ntype ExtractOptionalParam<Rest extends string> =\n Rest extends `${infer ParamName}/${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}-${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}.${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}`\n ? { [K in ParamName]?: string }\n : {};\n\n/**\n * Extract a single parameter name from the rest of the path\n * Enhanced to handle Express 5 patterns and optional parameters correctly\n * Special handling for consecutive parameters like :from-:to\n * Order matters: regex constraints must be handled before repeating parameters\n */\ntype ExtractSingleParam<Rest extends string> =\n // Handle regex constraints FIRST (before +, *, ?) to avoid conflicts\n Rest extends `${infer ParamName}(${infer _Constraint})${infer _After}`\n ? { [K in ParamName]: string } // Handle consecutive parameters with separators first: param-:nextParam\n : Rest extends `${infer ParamName}-:${infer _NextParam}`\n ? { [K in ParamName]: string }\n : Rest extends `${infer ParamName}.:${infer _NextParam}`\n ? { [K in ParamName]: string }\n : // Handle optional parameters followed by delimiters (before regular delimiters)\n Rest extends `${infer ParamName}?/${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}?-${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}?.${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}?#${infer _After}`\n ? { [K in ParamName]?: string }\n : Rest extends `${infer ParamName}?:${infer _After}`\n ? { [K in ParamName]?: string }\n : // Then handle regular delimiters (after optional parameter patterns)\n Rest extends `${infer ParamName}/${infer _After}`\n ? { [K in ParamName]: string }\n : Rest extends `${infer ParamName}-${infer _After}`\n ? { [K in ParamName]: string }\n : Rest extends `${infer ParamName}.${infer _After}`\n ? { [K in ParamName]: string }\n : Rest extends `${infer ParamName}#${infer _After}`\n ? { [K in ParamName]: string }\n : Rest extends `${infer ParamName}:${infer _After}`\n ? { [K in ParamName]: string }\n : // Handle Express 5 repeating parameters (after regular delimiters)\n Rest extends `${infer ParamName}+${infer _After}`\n ? { [K in ParamName]: string[] }\n : Rest extends `${infer ParamName}*${infer _After}`\n ? { [K in ParamName]?: string[] }\n : // Handle optional parameters with ? (Express 4) - only at the end of a segment\n Rest extends `${infer ParamName}?${infer _After}`\n ? { [K in ParamName]?: string } // Parameter at absolute end of string\n : Rest extends string\n ? Rest extends \"\"\n ? {}\n : Rest extends `${infer ParamName}?`\n ? { [K in ParamName]?: string } // ParamName here doesn't include the ?\n : Rest extends `${infer ParamName}+`\n ? { [K in ParamName]: string[] }\n : Rest extends `${infer ParamName}*`\n ? { [K in ParamName]?: string[] }\n : { [K in Rest]: string }\n : {};\n\n/**\n * Remove the first parameter from path to continue parsing\n * Enhanced to handle Express 5 patterns and optional parameters\n * Handles patterns like :from-:to by removing just :from and keeping -:to\n * Order matters: regex constraints must be handled before repeating parameters\n */\ntype RemoveFirstParam<Path extends string> =\n Path extends `${infer Before}:${infer Rest}`\n ? // Handle regex constraints FIRST (before +, *, ?) to avoid conflicts\n Rest extends `${infer _ParamName}(${infer _Constraint})${infer After}`\n ? `${Before}${After}` // Handle consecutive parameters: :param-:nextParam -> -:nextParam\n : Rest extends `${infer _ParamName}-:${infer After}`\n ? `${Before}-:${After}`\n : Rest extends `${infer _ParamName}.:${infer After}`\n ? `${Before}.:${After}`\n : // Handle optional parameters followed by delimiters (before regular delimiters)\n Rest extends `${infer _ParamName}?/${infer After}`\n ? `${Before}/${After}`\n : Rest extends `${infer _ParamName}?-${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}?.${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}?#${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}?:${infer After}`\n ? `${Before}:${After}`\n : // Handle regular separators (after optional parameter patterns)\n Rest extends `${infer _ParamName}/${infer After}`\n ? `${Before}/${After}`\n : Rest extends `${infer _ParamName}-${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}.${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}#${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}:${infer After}`\n ? `${Before}:${After}`\n : // Handle Express 5 repeating parameters (after regular separators)\n Rest extends `${infer _ParamName}+${infer After}`\n ? `${Before}${After}`\n : Rest extends `${infer _ParamName}*${infer After}`\n ? `${Before}${After}`\n : // Handle optional parameters with ?\n Rest extends `${infer _ParamName}?${infer After}`\n ? `${Before}${After}`\n : Before\n : Path;\n\n/**\n * Count wildcards to assign proper numeric indices\n */\ntype CountWildcards<\n Path extends string,\n Count extends string = \"0\"\n> = Path extends `${infer _Before}*${infer Rest}`\n ? CountWildcards<Rest, IncrementWildcard<Count>>\n : Count;\n\n/**\n * Helper type to increment wildcard count as string\n */\ntype IncrementWildcard<T extends string> = T extends \"0\"\n ? \"1\"\n : T extends \"1\"\n ? \"2\"\n : T extends \"2\"\n ? \"3\"\n : T extends \"3\"\n ? \"4\"\n : T extends \"4\"\n ? \"5\"\n : T extends \"5\"\n ? \"6\"\n : T extends \"6\"\n ? \"7\"\n : T extends \"7\"\n ? \"8\"\n : T extends \"8\"\n ? \"9\"\n : \"10\"; // Reasonable limit for wildcards\n\n/**\n * Express middleware that adds custom properties to the request object.\n *\n * @template T - The shape of the properties added to the request.\n * @param req - The Express request object, extended with T.\n * @param res - The Express response object.\n * @param next - The next middleware function.\n */\nexport type TypedMiddleware<T extends Record<string, any>> = (\n req: Request & T,\n res: Response,\n next: NextFunction\n) => void | Promise<void>;\n\n// Utility type to infer props from middleware array\ntype InferMiddlewareProps<T extends readonly TypedMiddleware<any>[]> =\n T extends readonly [infer First, ...infer Rest]\n ? First extends TypedMiddleware<infer FirstType>\n ? Rest extends readonly TypedMiddleware<any>[]\n ? FirstType & InferMiddlewareProps<Rest>\n : FirstType\n : {}\n : {};\n\n// Enhanced Request type with proper inference\nexport type ZodRequest<\n Path extends string = string,\n BodySchema extends ZodType<any, any, any> | unknown = unknown,\n QuerySchema extends ZodType<any, any, any> | unknown = unknown,\n MiddlewareProps extends Record<string, any> = {}\n> = Omit<Request, \"params\" | \"query\" | \"body\"> & {\n params: ExtractRouteParams<Path>;\n body: BodySchema extends ZodType<any, any, any>\n ? z.infer<BodySchema>\n : unknown;\n query: QuerySchema extends ZodType<any, any, any>\n ? z.infer<QuerySchema>\n : unknown;\n} & MiddlewareProps;\n\n// Route handler type\nexport type ZodRouteHandler<\n Path extends string = string,\n BodySchema extends ZodType<any, any, any> | unknown = unknown,\n QuerySchema extends ZodType<any, any, any> | unknown = unknown,\n MiddlewareProps extends Record<string, any> = {}\n> = (\n req: ZodRequest<Path, BodySchema, QuerySchema, MiddlewareProps>,\n res: Response,\n next?: NextFunction\n) => void | Promise<void> | Response | Promise<Response>;\n\n/**\n * Options for defining a typed route, including schemas and middleware.\n *\n * @template BodySchema - Zod schema for request body validation.\n * @template QuerySchema - Zod schema for query parameter validation.\n * @property bodySchema - Optional Zod schema for validating the request body.\n * @property querySchema - Optional Zod schema for validating the query string.\n * @property middleware - Optional array of TypedMiddleware for this route.\n */\nexport interface RouteOptions<\n BodySchema extends ZodType<any, any, any> | unknown = unknown,\n QuerySchema extends ZodType<any, any, any> | unknown = unknown\n> {\n bodySchema?: BodySchema extends ZodType<any, any, any> ? BodySchema : never;\n querySchema?: QuerySchema extends ZodType<any, any, any>\n ? QuerySchema\n : never;\n middleware?: readonly TypedMiddleware<any>[];\n}\n\n// HTTP methods\nexport type HttpMethod =\n | \"get\"\n | \"post\"\n | \"put\"\n | \"delete\"\n | \"patch\"\n | \"options\"\n | \"head\"\n | \"all\";\n\n// Main typed router class\nexport class TypedRouter<\n RouterMiddlewareProps extends Record<string, any> = {}\n> {\n private router: express.Router;\n\n constructor() {\n this.router = express.Router();\n }\n\n /**\n * Add typed middleware that extends the request with additional properties\n */\n useTypedMiddleware<T extends Record<string, any>>(\n middleware: TypedMiddleware<T>\n ): TypedRouter<RouterMiddlewareProps & T> {\n this.router.use(middleware as any);\n return this as any;\n }\n\n /**\n * Get the underlying Express router\n */\n getRouter(): express.Router {\n return this.router;\n }\n\n // Method overloads for GET requests with automatic middleware type inference\n get<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n get<\n Path extends string,\n BodySchema extends ZodType<any, any, any> | unknown,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: RouteOptions<BodySchema, QuerySchema>,\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Special overload for middleware type inference\n get<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Combined overload for body/query schema + middleware\n get<\n Path extends string,\n BodySchema extends ZodType<any, any, any> | unknown,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: RouteOptions<BodySchema, QuerySchema> & { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Implementation\n get(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"get\", path, optionsOrHandler, handler);\n }\n\n // Combined overload for body/query schema + middleware (most specific first)\n post<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: {\n bodySchema: BodySchema;\n querySchema?: QuerySchema;\n middleware: Middleware;\n },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Body schema only + middleware\n post<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { bodySchema: BodySchema; middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Middleware only\n post<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Body + Query schema without middleware\n post<\n Path extends string,\n BodySchema extends ZodType<any, any, any> | unknown,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: RouteOptions<BodySchema, QuerySchema>,\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n // Just handler, no options\n post<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n post(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"post\", path, optionsOrHandler, handler);\n }\n\n // PUT method with all the same overloads as POST\n put<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: {\n bodySchema: BodySchema;\n querySchema?: QuerySchema;\n middleware: Middleware;\n },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n put<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { bodySchema: BodySchema; middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n put<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n put<\n Path extends string,\n BodySchema extends ZodType<any, any, any> | unknown,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: RouteOptions<BodySchema, QuerySchema>,\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n put<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n put(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"put\", path, optionsOrHandler, handler);\n }\n\n // PATCH method with all the same overloads as POST\n patch<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: {\n bodySchema: BodySchema;\n querySchema?: QuerySchema;\n middleware: Middleware;\n },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n patch<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { bodySchema: BodySchema; middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n patch<\n Path extends string,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n patch<\n Path extends string,\n BodySchema extends ZodType<any, any, any> | unknown,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: RouteOptions<BodySchema, QuerySchema>,\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n patch<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n patch(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"patch\", path, optionsOrHandler, handler);\n }\n\n // DELETE method (typically no body, but can have query params and middleware)\n delete<\n Path extends string,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n delete<\n Path extends string,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { querySchema: QuerySchema; middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n delete<\n Path extends string,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: { querySchema: QuerySchema },\n handler: ZodRouteHandler<Path, unknown, QuerySchema, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n delete<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n delete(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"delete\", path, optionsOrHandler, handler);\n }\n\n // OPTIONS method (typically no body, used for CORS preflight)\n options<\n Path extends string,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n options<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n options(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"options\", path, optionsOrHandler, handler);\n }\n\n // HEAD method (like GET but only returns headers)\n head<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n head<\n Path extends string,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { querySchema: QuerySchema; middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n head<\n Path extends string,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: { querySchema: QuerySchema },\n handler: ZodRouteHandler<Path, unknown, QuerySchema, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n head<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n head(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"head\", path, optionsOrHandler, handler);\n }\n\n // ALL method (matches all HTTP methods)\n all<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n QuerySchema extends ZodType<any, any, any> | unknown,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: {\n bodySchema: BodySchema;\n querySchema?: QuerySchema;\n middleware: Middleware;\n },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n all<\n Path extends string,\n BodySchema extends ZodType<any, any, any>,\n Middleware extends readonly TypedMiddleware<any>[]\n >(\n path: Path,\n options: { bodySchema: BodySchema; middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n all<Path extends string, Middleware extends readonly TypedMiddleware<any>[]>(\n path: Path,\n options: { middleware: Middleware },\n handler: ZodRouteHandler<\n Path,\n unknown,\n unknown,\n RouterMiddlewareProps & InferMiddlewareProps<Middleware>\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n all<\n Path extends string,\n BodySchema extends ZodType<any, any, any> | unknown,\n QuerySchema extends ZodType<any, any, any> | unknown\n >(\n path: Path,\n options: RouteOptions<BodySchema, QuerySchema>,\n handler: ZodRouteHandler<\n Path,\n BodySchema,\n QuerySchema,\n RouterMiddlewareProps\n >\n ): TypedRouter<RouterMiddlewareProps>;\n\n all<Path extends string>(\n path: Path,\n handler: ZodRouteHandler<Path, unknown, unknown, RouterMiddlewareProps>\n ): TypedRouter<RouterMiddlewareProps>;\n\n all(\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n return this.registerRoute(\"all\", path, optionsOrHandler, handler);\n }\n\n // Helper method to register routes\n private registerRoute(\n method: HttpMethod,\n path: string,\n optionsOrHandler: any,\n handler?: any\n ): TypedRouter<RouterMiddlewareProps> {\n const middlewares: any[] = [];\n\n if (typeof optionsOrHandler === \"object\") {\n const options = optionsOrHandler as RouteOptions<any, any>;\n\n // Add per-route middleware first\n if (options.middleware) {\n middlewares.push(...options.middleware);\n }\n\n // Add schema validation middleware\n if (options.bodySchema) {\n middlewares.push(\n this.createBodyValidationMiddleware(options.bodySchema)\n );\n }\n if (options.querySchema) {\n middlewares.push(\n this.createQueryValidationMiddleware(options.querySchema)\n );\n }\n\n // Add the main handler\n middlewares.push(handler);\n } else {\n // Direct handler without options\n middlewares.push(optionsOrHandler);\n }\n\n // Register with Express router\n (this.router as any)[method](path, ...middlewares);\n\n return this;\n }\n\n private createBodyValidationMiddleware(schema: ZodType<any, any, any>) {\n return (req: Request, res: Response, next: NextFunction) => {\n try {\n req.body = schema.parse(req.body);\n next();\n } catch (error) {\n if (error instanceof z.ZodError) {\n res.status(400).json({\n error: \"Validation failed\",\n details: error.errors,\n });\n } else {\n next(error);\n }\n }\n };\n }\n\n private createQueryValidationMiddleware(schema: ZodType<any, any, any>) {\n return (req: Request, res: Response, next: NextFunction) => {\n try {\n req.query = schema.parse(req.query);\n next();\n } catch (error) {\n if (error instanceof z.ZodError) {\n res.status(400).json({\n error: \"Validation failed\",\n details: error.errors,\n });\n } else {\n next(error);\n }\n }\n };\n }\n}\n\n/**\n * Create a new strongly-typed Express router instance.\n *\n * This is the simplest way to get started with @minisylar/express-typed-router.\n *\n * @example\n * import { createTypedRouter } from '@minisylar/express-typed-router';\n *\n * // Create a router and add a typed GET route\n * const router = createTypedRouter();\n * router.get('/hello/:name', (req, res) => {\n * // req.params.name is typed as string\n * res.json({ message: `Hello, ${req.params.name}!` });\n * });\n *\n * // Use with Express\n * import express from 'express';\n * const app = express();\n * app.use('/api', router.getRouter());\n */\nexport function createTypedRouter<\n RouterMiddlewareProps extends Record<string, any> = {}\n>(): TypedRouter<RouterMiddlewareProps> {\n return new TypedRouter<RouterMiddlewareProps>();\n}\n\n// Option 2: Factory with optional configuration\n\n/**\n * Configuration options for createTypedRouterWithConfig.\n *\n * @property validateInput - (Future) Whether to enable global input validation.\n * @property errorHandler - Optional global error handler middleware for the router.\n */\nexport interface RouterConfig {\n validateInput?: boolean;\n errorHandler?: (\n error: any,\n req: Request,\n res: Response,\n next: NextFunction\n ) => void;\n}\n\n/**\n * Create a new typed router with optional configuration.\n *\n * Use this if you want to add a global error handler or future global options.\n *\n * @param config - Optional configuration for the router (e.g. error handler).\n * @returns A new TypedRouter instance.\n *\n * @example\n * import { createTypedRouterWithConfig } from '@minisylar/express-typed-router';\n *\n * const router = createTypedRouterWithConfig({\n * errorHandler: (err, req, res, next) => {\n * res.status(500).json({ error: 'Something went wrong', details: err });\n * }\n * });\n */\nexport function createTypedRouterWithConfig<\n RouterMiddlewareProps extends Record<string, any> = {}\n>(config?: RouterConfig): TypedRouter<RouterMiddlewareProps> {\n const router = new TypedRouter<RouterMiddlewareProps>();\n if (config?.errorHandler) {\n router.getRouter().use(config.errorHandler);\n }\n return router;\n}\n\n// Option 3: Factory with pre-configured middleware\n\n/**\n * Create a new typed router with pre-configured middleware.\n *\n * This is useful for setting up router-level middleware in a single call.\n *\n * @param middleware - One or more TypedMiddleware functions to apply to all routes.\n * @returns A new TypedRouter instance with the middleware applied.\n *\n * @example\n * import { createTypedRouterWithMiddleware } from '@minisylar/express-typed-router';\n *\n * const router = createTypedRouterWithMiddleware(authMiddleware, loggingMiddleware);\n */\nexport function createTypedRouterWithMiddleware<T extends Record<string, any>>(\n ...middleware: TypedMiddleware<any>[]\n): TypedRouter<T> {\n let router = new TypedRouter() as any;\n for (const mw of middleware) {\n router = router.useTypedMiddleware(mw);\n }\n return router;\n}\n"],"mappings":"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"}
@@ -8,18 +8,14 @@ var TypedRouter = class {
8
8
  this.router = express.Router();
9
9
  }
10
10
  /**
11
-
12
11
  * Add typed middleware that extends the request with additional properties
13
-
14
12
  */
15
13
  useTypedMiddleware(middleware) {
16
14
  this.router.use(middleware);
17
15
  return this;
18
16
  }
19
17
  /**
20
-
21
18
  * Get the underlying Express router
22
-
23
19
  */
24
20
  getRouter() {
25
21
  return this.router;
@@ -90,79 +86,44 @@ var TypedRouter = class {
90
86
  }
91
87
  };
92
88
  /**
93
-
94
89
  * Create a new strongly-typed Express router instance.
95
-
96
90
  *
97
-
98
91
  * This is the simplest way to get started with @minisylar/express-typed-router.
99
-
100
92
  *
101
-
102
93
  * @example
103
-
104
94
  * import { createTypedRouter } from '@minisylar/express-typed-router';
105
-
106
95
  *
107
-
108
96
  * // Create a router and add a typed GET route
109
-
110
97
  * const router = createTypedRouter();
111
-
112
98
  * router.get('/hello/:name', (req, res) => {
113
-
114
99
  * // req.params.name is typed as string
115
-
116
100
  * res.json({ message: `Hello, ${req.params.name}!` });
117
-
118
101
  * });
119
-
120
102
  *
121
-
122
103
  * // Use with Express
123
-
124
104
  * import express from 'express';
125
-
126
105
  * const app = express();
127
-
128
106
  * app.use('/api', router.getRouter());
129
-
130
107
  */
131
108
  function createTypedRouter() {
132
109
  return new TypedRouter();
133
110
  }
134
111
  /**
135
-
136
112
  * Create a new typed router with optional configuration.
137
-
138
113
  *
139
-
140
114
  * Use this if you want to add a global error handler or future global options.
141
-
142
115
  *
143
-
144
116
  * @param config - Optional configuration for the router (e.g. error handler).
145
-
146
117
  * @returns A new TypedRouter instance.
147
-
148
118
  *
149
-
150
119
  * @example
151
-
152
120
  * import { createTypedRouterWithConfig } from '@minisylar/express-typed-router';
153
-
154
121
  *
155
-
156
122
  * const router = createTypedRouterWithConfig({
157
-
158
123
  * errorHandler: (err, req, res, next) => {
159
-
160
124
  * res.status(500).json({ error: 'Something went wrong', details: err });
161
-
162
125
  * }
163
-
164
126
  * });
165
-
166
127
  */
167
128
  function createTypedRouterWithConfig(config) {
168
129
  const router = new TypedRouter();
@@ -170,29 +131,17 @@ function createTypedRouterWithConfig(config) {
170
131
  return router;
171
132
  }
172
133
  /**
173
-
174
134
  * Create a new typed router with pre-configured middleware.
175
-
176
135
  *
177
-
178
136
  * This is useful for setting up router-level middleware in a single call.
179
-
180
137
  *
181
-
182
138
  * @param middleware - One or more TypedMiddleware functions to apply to all routes.
183
-
184
139
  * @returns A new TypedRouter instance with the middleware applied.
185
-
186
140
  *
187
-
188
141
  * @example
189
-
190
142
  * import { createTypedRouterWithMiddleware } from '@minisylar/express-typed-router';
191
-
192
143
  *
193
-
194
144
  * const router = createTypedRouterWithMiddleware(authMiddleware, loggingMiddleware);
195
-
196
145
  */
197
146
  function createTypedRouterWithMiddleware(...middleware) {
198
147
  let router = new TypedRouter();