@fishka/express 0.9.13 → 0.9.15

package/README.md

@@ -12,56 +12,105 @@ npm install @fishka/express
 
 ```typescript
 import express from 'express';
-import { createRouteTable } from '@fishka/express';
+import { createRouteTable, param, toInt } from '@fishka/express';
+import { assertString } from '@fishka/assertions';
 
 const app = express();
 app.use(express.json());
 
 const routes = createRouteTable(app);
 
-// GET /users/:id - using function shorthand
-routes.get<{ id: string; name: string }>('users/:id', async ctx => ({
-  id: ctx.params.get('id'),
-  name: 'John',
-}));
+// GET /users/:id - with typed path params
+routes.get('users/:id', {
+  $path: { id: param(toInt()) },
+  run: async ctx => ({
+    id: ctx.path.id,  // number - typed from $path
+    name: 'John',
+  }),
+});
 
-// GET /users - using full endpoint object
-routes.get<Array<{ id: string; name: string }>>('users', async () => [
-  { id: '1', name: 'John' },
-  { id: '2', name: 'Jane' },
+// GET /users - list all users
+routes.get('users', async () => [
+  { id: 1, name: 'John' },
+  { id: 2, name: 'Jane' },
 ]);
 
-// POST /users
-routes.post<{ name: string }, { id: string }>('users', {
+// POST /users - with body validation
+routes.post<{ name: string }, { id: number }>('users', {
   $body: { name: v => assertString(v, 'name required') },
-  run: async ctx => ({ id: '1' }),
+  run: async ctx => ({ id: 1 }),
 });
 
-// DELETE /users/:id - using function shorthand
-routes.delete('users/:id', async () => {
-  // Delete user logic
-});
+// DELETE /users/:id
+routes.delete('users/:id', async () => {});
 
 app.listen(3000);
 ```
 
-## URL Parameters
+## URL Parameter Validation
 
-Global validation can be enforced for specific URL parameters (e.g., `:id`, `:orgId`) across all routes.
+Use `param()` to validate and transform path/query parameters. All operators are composable:
 
 ```typescript
-import { registerUrlParameter } from '@fishka/express';
-import { assertString, assertTruthy } from '@fishka/assertions';
-
-// Register parameters with optional validation
-registerUrlParameter('orgId', {
-  validator: val => {
-    assertString(val);
-    assertTruthy(val.startsWith('org-'), 'Invalid Organization ID');
+import { param, toInt, minLength, matches, min, range, oneOf } from '@fishka/express';
+
+routes.get('users/:id', {
+  $path: {
+    id: param(toInt()),                      // string → number
+  },
+  $query: {
+    page: param(toInt(), min(1)),            // number >= 1
+    limit: param(toInt(), range(1, 100)),    // number 1-100
+    sort: param(oneOf('asc', 'desc')),       // enum
+    search: param(minLength(3)),             // string min 3 chars
   },
+  run: async ctx => ({
+    id: ctx.path.id,       // number
+    page: ctx.query.page,  // number
+    sort: ctx.query.sort,  // 'asc' | 'desc'
+  }),
 });
+```
+
+### Available Operators
+
+**Transformations (string → T):**
+- `toInt()` - parse to integer
+- `toNumber()` - parse to number
+- `toBool()` - parse 'true'/'false' to boolean
+- `oneOf('a', 'b')` - enum values
 
-// Now /orgs/:orgId will automatically validate that orgId starts with 'org-'
+**String validators:**
+- `minLength(n)` - minimum length
+- `maxLength(n)` - maximum length
+- `matches(/regex/)` - regex match
+- `trim` - trim whitespace
+- `lowercase` / `uppercase` - case transform
+
+**Number validators:**
+- `min(n)` - minimum value
+- `max(n)` - maximum value
+- `range(min, max)` - value range
+
+**Generic:**
+- `check(fn, msg)` - custom validation
+- `map(fn)` - transform value
+
+### Optional Parameters
+
+Use `optional()` to make parameters optional:
+
+```typescript
+import { optional, param, toInt } from '@fishka/express';
+
+routes.get('users', {
+  $query: {
+    page: optional(param(toInt())),  // number | undefined
+  },
+  run: async ctx => {
+    const page = ctx.query.page ?? 1;
+  },
+});
 ```
 
 ## Authentication
@@ -110,12 +159,11 @@ assertHttp(user.isAdmin, HTTP_FORBIDDEN, 'Admin access required');
 
 ## Complete Example
 
-Here is a full initialization including TLS context, global validation, and proper error handling.
+Full initialization with TLS context, validation, and error handling:
 
 ```typescript
 import express from 'express';
-import { createRouteTable, createTlsMiddleware, catchAllMiddleware, registerUrlParameter } from '@fishka/express';
-import { assertString, assertTruthy } from '@fishka/assertions';
+import { createRouteTable, createTlsMiddleware, catchAllMiddleware, param, toInt } from '@fishka/express';
 
 const app = express();
 
@@ -125,21 +173,43 @@ app.use(express.json());
 // 2. Initialize TLS context (Request IDs, etc.)
 app.use(createTlsMiddleware());
 
-// 3. Register global URL parameters
-registerUrlParameter('id', {
-  validator: val => assertString(val),
-});
-
-// 4. Define routes
+// 3. Define routes with typed parameters
 const routes = createRouteTable(app);
+
 routes.get('health', async () => ({ status: 'UP' }));
 
-// 5. Global error handler (Must be after route definitions)
+routes.get('users/:id', {
+  $path: { id: param(toInt()) },
+  run: async ctx => ({ id: ctx.path.id }),
+});
+
+// 4. Error handler - catches middleware/parsing errors
 app.use(catchAllMiddleware);
 
 app.listen(3000);
 ```
 
+## Process Handlers
+
+Handle uncaught errors and graceful shutdown in one place:
+
+```typescript
+import { installProcessHandlers } from '@fishka/express';
+
+installProcessHandlers({
+  // Error handlers
+  onUncaughtException: err => sendToMonitoring(err),
+  onUnhandledRejection: reason => sendToMonitoring(reason),
+
+  // Graceful shutdown
+  onShutdown: async () => {
+    await database.close();
+    await server.close();
+  },
+  shutdownTimeout: 15000, // Force exit after 15s (default: 10s)
+});
+```
+
 ## License
 
 MIT

package/dist/cjs/api.types.d.ts

@@ -1,5 +1,11 @@
-import { ValueAssertion } from '@fishka/assertions';
-export type UrlTokensValidator = Record<string, ValueAssertion<string>>;
+/** Validator function that validates and returns typed value */
+export type TypeValidator<T> = (value: unknown) => T;
+/** Map of param name to type validator */
+export type TypedValidatorMap = Record<string, TypeValidator<unknown>>;
+/** Infer validated types from validator map */
+export type InferValidated<T extends TypedValidatorMap | undefined> = T extends TypedValidatorMap ? {
+    [K in keyof T]: ReturnType<T[K]>;
+} : Record<string, never>;
 export declare class HttpError extends Error {
     readonly status: number;
     readonly details?: Record<string, unknown> | undefined;
@@ -62,22 +68,3 @@ export interface ApiResponse<ResponseEntity = unknown> {
 }
 /** Converts an API response value into a standardized ApiResponse structure. */
 export declare function response<T = unknown>(result: T): ApiResponse<T>;
-/** Globally identified URL (path or query) parameter info. */
-export interface UrlParameterInfo {
-    /** Optional global validator for this parameter. */
-    validator?: ValueAssertion<string>;
-    /** Description for documentation. */
-    description?: string;
-}
-/**
- * Default documentation and validation for URL parameters.
- * @Internal
- */
-export declare const URL_PARAMETER_INFO: Record<string, UrlParameterInfo>;
-/** Registers a new URL parameter. */
-export declare function registerUrlParameter(name: string, info: UrlParameterInfo): void;
-/**
- * Asserts that the value is a registered URL parameter name.
- * @Internal
- */
-export declare function assertUrlParameter(name: unknown): asserts name is string;

package/dist/cjs/api.types.js

@@ -1,12 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.URL_PARAMETER_INFO = exports.HttpError = void 0;
+exports.HttpError = void 0;
 exports.assertHttp = assertHttp;
 exports.response = response;
-exports.registerUrlParameter = registerUrlParameter;
-exports.assertUrlParameter = assertUrlParameter;
 const assertions_1 = require("@fishka/assertions");
-const http_status_codes_1 = require("./http-status-codes");
 class HttpError extends Error {
     constructor(status, message, details) {
         super(message);
@@ -55,21 +52,4 @@ function assertHttp(value, status, message) {
 function response(result) {
     return { result };
 }
-/**
- * Default documentation and validation for URL parameters.
- * @Internal
- */
-exports.URL_PARAMETER_INFO = {};
-/** Registers a new URL parameter. */
-function registerUrlParameter(name, info) {
-    exports.URL_PARAMETER_INFO[name] = info;
-}
-/**
- * Asserts that the value is a registered URL parameter name.
- * @Internal
- */
-function assertUrlParameter(name) {
-    assertHttp(typeof name === 'string', http_status_codes_1.HTTP_BAD_REQUEST, 'Url parameter name must be a string');
-    assertHttp(exports.URL_PARAMETER_INFO[name], http_status_codes_1.HTTP_BAD_REQUEST, `Invalid URL parameter: '${name}'. Please register it using 'registerUrlParameter('${name}', ...)'`);
-}
 //# sourceMappingURL=api.types.js.map

package/dist/cjs/api.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.types.js","sourceRoot":"","sources":["../../src/api.types.ts"],"names":[],"mappings":";;;AAgDA,gCAEC;AA2BD,4BAEC;AAiBD,oDAEC;AAMD,gDAOC;AA/GD,mDAAkE;AAClE,2DAAuD;AAIvD,MAAa,SAAU,SAAQ,KAAK;IAClC,YACkB,MAAc,EAC9B,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QAEd,YAAO,GAAP,OAAO,CAA0B;QAGjD,qDAAqD;QACrD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAVD,8BAUC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,OAAe;IACxE,IAAA,yBAAY,EAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AA0BD,gFAAgF;AAChF,SAAgB,QAAQ,CAAc,MAAS;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAUD;;;GAGG;AACU,QAAA,kBAAkB,GAAqC,EAAE,CAAC;AAEvE,qCAAqC;AACrC,SAAgB,oBAAoB,CAAC,IAAY,EAAE,IAAsB;IACvE,0BAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,IAAa;IAC9C,UAAU,CAAC,OAAO,IAAI,KAAK,QAAQ,EAAE,oCAAgB,EAAE,qCAAqC,CAAC,CAAC;IAC9F,UAAU,CACR,0BAAkB,CAAC,IAAI,CAAC,EACxB,oCAAgB,EAChB,2BAA2B,IAAI,sDAAsD,IAAI,UAAU,CACpG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"api.types.js","sourceRoot":"","sources":["../../src/api.types.ts"],"names":[],"mappings":";;;AAyDA,gCAEC;AA2BD,4BAEC;AAxFD,mDAAkD;AAclD,MAAa,SAAU,SAAQ,KAAK;IAClC,YACkB,MAAc,EAC9B,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QAEd,YAAO,GAAP,OAAO,CAA0B;QAGjD,qDAAqD;QACrD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAVD,8BAUC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,OAAe;IACxE,IAAA,yBAAY,EAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AA0BD,gFAAgF;AAChF,SAAgB,QAAQ,CAAc,MAAS;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/cjs/error-handling.d.ts

@@ -1,9 +1,78 @@
 import { NextFunction } from 'express';
 import { ExpressFunction, ExpressRequest, ExpressResponse } from './utils/express.utils';
-/** Catches all kinds of unprocessed exceptions thrown from a single route. */
+/**
+ * @Internal
+ * Wraps a route handler to catch and convert errors to API responses.
+ * Applied automatically to all routes registered via createRouteTable().
+ *
+ * Catches:
+ * - Errors thrown in validators ($path, $query, $body)
+ * - Errors thrown in the run() handler
+ * - Errors thrown in endpoint middlewares
+ *
+ * Logs errors to console (error level for 5xx).
+ */
 export declare function catchRouteErrors(fn: ExpressFunction): ExpressFunction;
 /**
- * Catches all errors in Express.js and is installed as global middleware.
- * Note that individual routes are wrapped with 'catchRouteErrors' middleware.
+ * Express error-handling middleware (4 parameters) for catching errors.
+ * Can be mounted at any level - global, path-specific, or router-specific.
+ *
+ * @example
+ * // Global
+ * app.use(catchAllMiddleware);
+ *
+ * // Path-specific
+ * app.use('/api', catchAllMiddleware);
+ *
+ * // Router-specific
+ * const router = express.Router();
+ * router.use(catchAllMiddleware);
+ *
+ * Catches:
+ * - Errors from Express middleware (passed via next(error))
+ * - JSON parsing errors (SyntaxError) - returns 400
+ * - Any errors that escape catchRouteErrors
+ *
+ * Note: Individual routes are already wrapped with catchRouteErrors(),
+ * so this middleware primarily catches middleware and parsing errors.
  */
 export declare function catchAllMiddleware(error: unknown, _: ExpressRequest, res: ExpressResponse, next: NextFunction): Promise<void>;
+/** Options for installProcessHandlers(). */
+export interface ProcessHandlersOptions {
+    /** Custom handler for uncaught exceptions. Called before default logging. */
+    onUncaughtException?: (error: Error) => void;
+    /** Custom handler for unhandled promise rejections. Called before default logging. */
+    onUnhandledRejection?: (reason: unknown) => void;
+    /** Async cleanup function called on shutdown signals. */
+    onShutdown?: () => Promise<void>;
+    /** Force exit timeout in ms if shutdown hangs. Default: 10000 */
+    shutdownTimeout?: number;
+    /** Signals to handle for graceful shutdown. Default: ['SIGTERM', 'SIGINT'] */
+    shutdownSignals?: NodeJS.Signals[];
+}
+/**
+ * Installs process-level handlers for errors and graceful shutdown.
+ * Call once at application startup, before app.listen().
+ *
+ * Error handling:
+ * - Uncaught exceptions (sync throws outside Express middleware)
+ * - Unhandled promise rejections (forgotten await, missing .catch())
+ *
+ * Graceful shutdown:
+ * - SIGTERM (Docker/K8s/systemd stop)
+ * - SIGINT (Ctrl+C)
+ * - Timeout protection (force exit if shutdown hangs)
+ * - Double-shutdown prevention
+ *
+ * @example
+ * installProcessHandlers({
+ *   onUncaughtException: (error) => sendToMonitoring(error),
+ *   onUnhandledRejection: (reason) => sendToMonitoring(reason),
+ *   onShutdown: async () => {
+ *     await database.close();
+ *     await server.close();
+ *   },
+ *   shutdownTimeout: 15000,
+ * });
+ */
+export declare function installProcessHandlers(options?: ProcessHandlersOptions): void;

package/dist/cjs/error-handling.js

@@ -2,11 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.catchRouteErrors = catchRouteErrors;
 exports.catchAllMiddleware = catchAllMiddleware;
+exports.installProcessHandlers = installProcessHandlers;
 const assertions_1 = require("@fishka/assertions");
 const api_types_1 = require("./api.types");
 const http_status_codes_1 = require("./http-status-codes");
 const thread_local_storage_1 = require("./thread-local/thread-local-storage");
 const conversion_utils_1 = require("./utils/conversion.utils");
+/**
+ * Converts any error into a standardized API response format.
+ * - HttpError: Uses the error's status code and message
+ * - Other errors: Returns 500 with the error message or 'Internal error'
+ * Attaches requestId from thread-local storage if available.
+ */
 function buildApiResponse(error) {
     const tls = (0, thread_local_storage_1.getRequestLocalStorage)();
     const requestId = tls?.requestId;
@@ -32,7 +39,18 @@ function buildApiResponse(error) {
     }
     return response;
 }
-/** Catches all kinds of unprocessed exceptions thrown from a single route. */
+/**
+ * @Internal
+ * Wraps a route handler to catch and convert errors to API responses.
+ * Applied automatically to all routes registered via createRouteTable().
+ *
+ * Catches:
+ * - Errors thrown in validators ($path, $query, $body)
+ * - Errors thrown in the run() handler
+ * - Errors thrown in endpoint middlewares
+ *
+ * Logs errors to console (error level for 5xx).
+ */
 function catchRouteErrors(fn) {
     return async (req, res, next) => {
         try {
@@ -43,17 +61,33 @@ function catchRouteErrors(fn) {
             if (apiResponse.status >= http_status_codes_1.HTTP_INTERNAL_SERVER_ERROR) {
                 console.error(`catchRouteErrors: ${req.path}`, error);
             }
-            else {
-                console.log(`catchRouteErrors: ${req.path}`, error);
-            }
             res.status(apiResponse.status);
             res.send(apiResponse);
         }
     };
 }
 /**
- * Catches all errors in Express.js and is installed as global middleware.
- * Note that individual routes are wrapped with 'catchRouteErrors' middleware.
+ * Express error-handling middleware (4 parameters) for catching errors.
+ * Can be mounted at any level - global, path-specific, or router-specific.
+ *
+ * @example
+ * // Global
+ * app.use(catchAllMiddleware);
+ *
+ * // Path-specific
+ * app.use('/api', catchAllMiddleware);
+ *
+ * // Router-specific
+ * const router = express.Router();
+ * router.use(catchAllMiddleware);
+ *
+ * Catches:
+ * - Errors from Express middleware (passed via next(error))
+ * - JSON parsing errors (SyntaxError) - returns 400
+ * - Any errors that escape catchRouteErrors
+ *
+ * Note: Individual routes are already wrapped with catchRouteErrors(),
+ * so this middleware primarily catches middleware and parsing errors.
  */
 async function catchAllMiddleware(error, _, res, next) {
     if (!error) {
@@ -63,9 +97,75 @@ async function catchAllMiddleware(error, _, res, next) {
     // Report as critical. This kind of error should never happen.
     console.error('catchAllMiddleware:', (0, assertions_1.getMessageFromError)(error));
     const apiResponse = error instanceof SyntaxError // JSON body parsing error.
-        ? buildApiResponse(`${http_status_codes_1.HTTP_BAD_REQUEST}: Failed to parse request: ${error.message}`)
+        ? buildApiResponse(new api_types_1.HttpError(http_status_codes_1.HTTP_BAD_REQUEST, `Failed to parse request: ${error.message}`))
         : buildApiResponse(error);
     res.status(apiResponse.status);
     res.send(apiResponse);
 }
+/**
+ * Installs process-level handlers for errors and graceful shutdown.
+ * Call once at application startup, before app.listen().
+ *
+ * Error handling:
+ * - Uncaught exceptions (sync throws outside Express middleware)
+ * - Unhandled promise rejections (forgotten await, missing .catch())
+ *
+ * Graceful shutdown:
+ * - SIGTERM (Docker/K8s/systemd stop)
+ * - SIGINT (Ctrl+C)
+ * - Timeout protection (force exit if shutdown hangs)
+ * - Double-shutdown prevention
+ *
+ * @example
+ * installProcessHandlers({
+ *   onUncaughtException: (error) => sendToMonitoring(error),
+ *   onUnhandledRejection: (reason) => sendToMonitoring(reason),
+ *   onShutdown: async () => {
+ *     await database.close();
+ *     await server.close();
+ *   },
+ *   shutdownTimeout: 15000,
+ * });
+ */
+function installProcessHandlers(options) {
+    // Error handlers
+    process.on('uncaughtException', (error) => {
+        options?.onUncaughtException?.(error);
+        console.error('CRITICAL - Uncaught Exception:', error);
+    });
+    process.on('unhandledRejection', (reason) => {
+        options?.onUnhandledRejection?.(reason);
+        console.error('CRITICAL - Unhandled Rejection:', reason);
+    });
+    // Graceful shutdown
+    const onShutdown = options?.onShutdown;
+    if (onShutdown) {
+        let isShuttingDown = false;
+        const signals = options?.shutdownSignals ?? ['SIGTERM', 'SIGINT'];
+        const timeout = options?.shutdownTimeout ?? 10000;
+        const shutdown = async (signal) => {
+            if (isShuttingDown)
+                return;
+            isShuttingDown = true;
+            console.log(`${signal} received, shutting down gracefully...`);
+            const timer = setTimeout(() => {
+                console.error('Shutdown timeout, forcing exit');
+                process.exit(1);
+            }, timeout);
+            try {
+                await onShutdown();
+                clearTimeout(timer);
+                process.exit(0);
+            }
+            catch (err) {
+                console.error('Shutdown error:', err);
+                clearTimeout(timer);
+                process.exit(1);
+            }
+        };
+        for (const signal of signals) {
+            process.on(signal, () => shutdown(signal));
+        }
+    }
+}
 //# sourceMappingURL=error-handling.js.map

package/dist/cjs/error-handling.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling.js","sourceRoot":"","sources":["../../src/error-handling.ts"],"names":[],"mappings":";;AAoCA,4CAeC;AAMD,gDAkBC;AA3ED,mDAAyD;AAEzD,2CAAqD;AACrD,2DAAmF;AACnF,8EAA6E;AAC7E,+DAA6D;AAG7D,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,GAAG,GAAG,IAAA,6CAAsB,GAAE,CAAC;IACrC,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,CAAC;IACjC,IAAI,QAA0C,CAAC;IAE/C,IAAI,KAAK,YAAY,qBAAS,EAAE,CAAC;QAC/B,QAAQ,GAAG;YACT,GAAG,IAAA,oCAAiB,EAAC,SAAS,CAAC;YAC/B,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,GAAG,IAAA,gCAAmB,EAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpD,QAAQ,GAAG;YACT,GAAG,IAAA,oCAAiB,EAAC,SAAS,CAAC;YAC/B,KAAK,EAAE,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB;YAChF,MAAM,EAAE,8CAA0B;SACnC,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,SAAgB,gBAAgB,CAAC,EAAmB;IAClD,OAAO,KAAK,EAAE,GAAmB,EAAE,GAAoB,EAAE,IAAkB,EAAiB,EAAE;QAC5F,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,WAAW,CAAC,MAAM,IAAI,8CAA0B,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CACtC,KAAc,EACd,CAAiB,EACjB,GAAoB,EACpB,IAAkB;IAElB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,EAAE,CAAC;QACP,OAAO;IACT,CAAC;IACD,8DAA8D;IAC9D,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,IAAA,gCAAmB,EAAC,KAAK,CAAC,CAAC,CAAC;IACjE,MAAM,WAAW,GACf,KAAK,YAAY,WAAW,CAAC,2BAA2B;QACtD,CAAC,CAAC,gBAAgB,CAAC,GAAG,oCAAgB,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAAC;QACpF,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"error-handling.js","sourceRoot":"","sources":["../../src/error-handling.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -13,3 +13,4 @@ export * from './router';
 export * from './thread-local/thread-local-storage';
 export * from './thread-local/thread-local-storage-middleware';
 export * from './utils/express.utils';
+export * from './utils/type-validators';

package/dist/cjs/index.js

@@ -29,4 +29,5 @@ __exportStar(require("./router"), exports);
 __exportStar(require("./thread-local/thread-local-storage"), exports);
 __exportStar(require("./thread-local/thread-local-storage-middleware"), exports);
 __exportStar(require("./utils/express.utils"), exports);
+__exportStar(require("./utils/type-validators"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,uDAAqC;AACrC,oDAAkC;AAClC,oDAAkC;AAClC,8DAA4C;AAC5C,2CAAyB;AACzB,mDAAiC;AACjC,sDAAoC;AACpC,sEAAoD;AACpD,gEAA8C;AAC9C,gDAA8B;AAC9B,2CAAyB;AACzB,sEAAoD;AACpD,iFAA+D;AAC/D,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,uDAAqC;AACrC,oDAAkC;AAClC,oDAAkC;AAClC,8DAA4C;AAC5C,2CAAyB;AACzB,mDAAiC;AACjC,sDAAoC;AACpC,sEAAoD;AACpD,gEAA8C;AAC9C,gDAA8B;AAC9B,2CAAyB;AACzB,sEAAoD;AACpD,iFAA+D;AAC/D,wDAAsC;AACtC,0DAAwC"}

package/dist/cjs/route-table.d.ts

@@ -1,3 +1,4 @@
+import { TypedValidatorMap } from './api.types';
 import { DeleteEndpoint, GetEndpoint, PatchEndpoint, PostEndpoint, PutEndpoint, RequestContext, ResponseOrValue } from './router';
 import { ExpressRouter } from './utils/express.utils';
 /**
@@ -7,13 +8,20 @@ import { ExpressRouter } from './utils/express.utils';
 export declare class RouteTable {
     private readonly app;
     constructor(app: ExpressRouter);
-    get<T>(path: string, endpoint: GetEndpoint<T> | GetEndpoint<T[]>): this;
-    get<T>(path: string, run: (ctx: RequestContext) => Promise<ResponseOrValue<T>>): this;
-    post<Body, Result>(path: string, endpoint: PostEndpoint<Body, Result>): this;
-    patch<Body, Result>(path: string, endpoint: PatchEndpoint<Body, Result>): this;
-    put<Body, Result>(path: string, endpoint: PutEndpoint<Body, Result>): this;
-    delete(path: string, endpoint: DeleteEndpoint): this;
-    delete(path: string, run: (ctx: RequestContext) => Promise<void>): this;
+    /** Register GET endpoint with full type inference for path/query params. */
+    get<Result, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap>(path: string, endpoint: GetEndpoint<Result, PathParams, QueryParams>): this;
+    /** Register GET endpoint with function shorthand. */
+    get<Result>(path: string, run: (ctx: RequestContext) => ResponseOrValue<Result> | Promise<ResponseOrValue<Result>>): this;
+    /** Register POST endpoint with full type inference for path/query params. */
+    post<Body, Result = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap>(path: string, endpoint: PostEndpoint<Body, Result, PathParams, QueryParams>): this;
+    /** Register PATCH endpoint with full type inference for path/query params. */
+    patch<Body, Result = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap>(path: string, endpoint: PatchEndpoint<Body, Result, PathParams, QueryParams>): this;
+    /** Register PUT endpoint with full type inference for path/query params. */
+    put<Body, Result = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap>(path: string, endpoint: PutEndpoint<Body, Result, PathParams, QueryParams>): this;
+    /** Register DELETE endpoint with full endpoint object. */
+    delete<PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap>(path: string, endpoint: DeleteEndpoint<PathParams, QueryParams>): this;
+    /** Register DELETE endpoint with function shorthand. */
+    delete(path: string, run: (ctx: RequestContext) => void | Promise<void>): this;
 }
 /**
  * Factory function to create a new route table.

package/dist/cjs/route-table.js

@@ -16,14 +16,17 @@ class RouteTable {
         (0, router_1.mountGet)(this.app, path, endpoint);
         return this;
     }
+    /** Register POST endpoint with full type inference for path/query params. */
     post(path, endpoint) {
         (0, router_1.mountPost)(this.app, path, endpoint);
         return this;
     }
+    /** Register PATCH endpoint with full type inference for path/query params. */
     patch(path, endpoint) {
         (0, router_1.mountPatch)(this.app, path, endpoint);
         return this;
     }
+    /** Register PUT endpoint with full type inference for path/query params. */
     put(path, endpoint) {
         (0, router_1.mountPut)(this.app, path, endpoint);
         return this;

package/dist/cjs/route-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../../src/route-table.ts"],"names":[],"mappings":";;;AA+DA,4CAEC;AAjED,qCAakB;AAGlB;;;GAGG;AACH,MAAa,UAAU;IACrB,YAA6B,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;IAAG,CAAC;IAInD,GAAG,CACD,IAAY,EACZ,aAAyG;QAEzG,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,IAAA,iBAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA0B,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAe,IAAY,EAAE,QAAoC;QACnE,IAAA,kBAAS,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAe,IAAY,EAAE,QAAqC;QACrE,IAAA,mBAAU,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAe,IAAY,EAAE,QAAmC;QACjE,IAAA,iBAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAID,MAAM,CAAC,IAAY,EAAE,aAAwE;QAC3F,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,IAAA,oBAAW,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AApCD,gCAoCC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,GAAkB;IACjD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../../src/route-table.ts"],"names":[],"mappings":";;;AA6GA,4CAEC;AA9GD,qCAakB;AAGlB;;;GAGG;AACH,MAAa,UAAU;IACrB,YAA6B,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;IAAG,CAAC;IAYnD,GAAG,CAKD,IAAY,EACZ,aAEyF;QAEzF,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,IAAA,iBAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAgC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAKF,IAAY,EAAE,QAA6D;QAC3E,IAAA,kBAAS,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA4C,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAKH,IAAY,EAAE,QAA8D;QAC5E,IAAA,mBAAU,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA6C,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,GAAG,CAKD,IAAY,EAAE,QAA4D;QAC1E,IAAA,iBAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA2C,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAWD,MAAM,CAIJ,IAAY,EACZ,aAAwG;QAExG,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,IAAA,oBAAW,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA0B,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAjFD,gCAiFC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,GAAkB;IACjD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}