@fishka/express 0.9.16 → 0.9.17

package/dist/cjs/utils/type-validators.d.ts

@@ -2,9 +2,9 @@
  * URL parameter validators for Express path/query params.
  * All params are strings from Express, so validation starts with string.
  */
-import { TypeValidator } from '../api.types';
+import { ParamValidator } from '../api.types';
 /** Makes validator optional - returns undefined if value missing */
-export declare function optional<T>(validator: TypeValidator<T>): TypeValidator<T | undefined>;
+export declare function optional<T>(validator: ParamValidator<T>): ParamValidator<T | undefined>;
 /** Operator that transforms string to T */
 export type ParamOperator<T> = (value: string) => T;
 /** Operator that transforms T to R */
@@ -14,18 +14,18 @@ export type Operator<T, R = T> = (value: T) => R;
  * Operators are applied in sequence to validate/transform the value.
  *
  * @example
- * param()                      // string
- * param(toInt)                 // number
- * param(toInt, min(1))         // number >= 1
- * param(minLength(3))          // string with min length
- * param(trim, lowercase)       // trimmed lowercase string
+ * transform()                      // string
+ * transform(toInt)                 // number
+ * transform(toInt, min(1))         // number >= 1
+ * transform(minLength(3))          // string with min length
+ * transform(trim, lowercase)       // trimmed lowercase string
  */
-export declare function param(): TypeValidator<string>;
-export declare function param<A>(op1: ParamOperator<A>): TypeValidator<A>;
-export declare function param<A, B>(op1: ParamOperator<A>, op2: Operator<A, B>): TypeValidator<B>;
-export declare function param<A, B, C>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>): TypeValidator<C>;
-export declare function param<A, B, C, D>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>, op4: Operator<C, D>): TypeValidator<D>;
-export declare function param<A, B, C, D, E>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>, op4: Operator<C, D>, op5: Operator<D, E>): TypeValidator<E>;
+export declare function transform(): ParamValidator<string>;
+export declare function transform<A>(op1: ParamOperator<A>): ParamValidator<A>;
+export declare function transform<A, B>(op1: ParamOperator<A>, op2: Operator<A, B>): ParamValidator<B>;
+export declare function transform<A, B, C>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>): ParamValidator<C>;
+export declare function transform<A, B, C, D>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>, op4: Operator<C, D>): ParamValidator<D>;
+export declare function transform<A, B, C, D, E>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>, op4: Operator<C, D>, op5: Operator<D, E>): ParamValidator<E>;
 /** Parses string to integer */
 export declare const toInt: (message?: string) => ParamOperator<number>;
 /** Parses string to number */
@@ -52,7 +52,14 @@ export declare const min: (n: number, message?: string) => Operator<number>;
 export declare const max: (n: number, message?: string) => Operator<number>;
 /** Requires value to be in range [minVal, maxVal] */
 export declare const range: (minVal: number, maxVal: number, message?: string) => Operator<number>;
-/** Adds custom validation */
-export declare const check: <T>(predicate: (value: T) => boolean, message: string) => Operator<T>;
+/** Adds custom validation with predicate */
+export declare const assert: <T>(predicate: (value: T) => boolean, message: string) => Operator<T>;
 /** Transforms the value */
 export declare const map: <T, R>(fn: (value: T) => R) => Operator<T, R>;
+/**
+ * Creates a simple validator that returns error message or undefined.
+ * Can be used directly in transform().
+ * @example
+ * transform(validator(s => s === 'valid' ? undefined : 'Invalid ID'))
+ */
+export declare function validator<T>(validateFn: (value: T) => string | undefined): (value: T) => T;

package/dist/cjs/utils/type-validators.js

@@ -4,9 +4,10 @@
  * All params are strings from Express, so validation starts with string.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.map = exports.check = exports.range = exports.max = exports.min = exports.uppercase = exports.lowercase = exports.trim = exports.matches = exports.maxLength = exports.minLength = exports.oneOf = exports.toBool = exports.toNumber = exports.toInt = void 0;
+exports.map = exports.assert = exports.range = exports.max = exports.min = exports.uppercase = exports.lowercase = exports.trim = exports.matches = exports.maxLength = exports.minLength = exports.oneOf = exports.toBool = exports.toNumber = exports.toInt = void 0;
 exports.optional = optional;
-exports.param = param;
+exports.transform = transform;
+exports.validator = validator;
 const assertions_1 = require("@fishka/assertions");
 /** Makes validator optional - returns undefined if value missing */
 function optional(validator) {
@@ -17,7 +18,7 @@ function optional(validator) {
         return validator(value);
     };
 }
-function param(...operators) {
+function transform(...operators) {
     return (value) => {
         (0, assertions_1.assertTruthy)(typeof value === 'string', `Expected string, got ${typeof value}`);
         let result = value;
@@ -27,11 +28,10 @@ function param(...operators) {
         return result;
     };
 }
-// ============================================================================
 // String → T operators (first in chain)
-// ============================================================================
 /** Parses string to integer */
 const toInt = (message) => (value) => {
+    (0, assertions_1.assertTruthy)(value !== undefined && value !== null && value !== '', message ?? 'Expected integer, got undefined or empty');
     const num = Number(value);
     (0, assertions_1.assertTruthy)(Number.isInteger(num), message ?? `Expected integer, got '${value}'`);
     return num;
@@ -39,6 +39,7 @@ const toInt = (message) => (value) => {
 exports.toInt = toInt;
 /** Parses string to number */
 const toNumber = (message) => (value) => {
+    (0, assertions_1.assertTruthy)(value !== undefined && value !== null && value !== '', message ?? 'Expected number, got undefined or empty');
     const num = Number(value);
     (0, assertions_1.assertTruthy)(!isNaN(num), message ?? `Expected number, got '${value}'`);
     return num;
@@ -46,6 +47,7 @@ const toNumber = (message) => (value) => {
 exports.toNumber = toNumber;
 /** Parses string to boolean ('true'/'false') */
 const toBool = (message) => (value) => {
+    (0, assertions_1.assertTruthy)(value !== undefined && value !== null && value !== '', message ?? 'Expected boolean, got undefined or empty');
     (0, assertions_1.assertTruthy)(value === 'true' || value === 'false', message ?? `Expected 'true' or 'false', got '${value}'`);
     return value === 'true';
 };
@@ -56,9 +58,7 @@ const oneOf = (...allowedValues) => (value) => {
     return value;
 };
 exports.oneOf = oneOf;
-// ============================================================================
 // String operators (string → string)
-// ============================================================================
 /** Requires minimum string length */
 const minLength = (n, message) => (value) => {
     (0, assertions_1.assertTruthy)(value.length >= n, message ?? `Must be at least ${n} characters`);
@@ -86,9 +86,7 @@ exports.lowercase = lowercase;
 /** Converts string to uppercase */
 const uppercase = (value) => value.toUpperCase();
 exports.uppercase = uppercase;
-// ============================================================================
 // Number operators (number → number)
-// ============================================================================
 /** Requires minimum value */
 const min = (n, message) => (value) => {
     (0, assertions_1.assertTruthy)(value >= n, message ?? `Must be at least ${n}`);
@@ -107,16 +105,29 @@ const range = (minVal, maxVal, message) => (value) => {
     return value;
 };
 exports.range = range;
-// ============================================================================
 // Generic operators
-// ============================================================================
-/** Adds custom validation */
-const check = (predicate, message) => (value) => {
+/** Adds custom validation with predicate */
+const assert = (predicate, message) => (value) => {
     (0, assertions_1.assertTruthy)(predicate(value), message);
     return value;
 };
-exports.check = check;
+exports.assert = assert;
 /** Transforms the value */
 const map = (fn) => (value) => fn(value);
 exports.map = map;
+/**
+ * Creates a simple validator that returns error message or undefined.
+ * Can be used directly in transform().
+ * @example
+ * transform(validator(s => s === 'valid' ? undefined : 'Invalid ID'))
+ */
+function validator(validateFn) {
+    return (value) => {
+        const error = validateFn(value);
+        if (error !== undefined) {
+            (0, assertions_1.assertTruthy)(false, error);
+        }
+        return value;
+    };
+}
 //# sourceMappingURL=type-validators.js.map

package/dist/cjs/utils/type-validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-validators.js","sourceRoot":"","sources":["../../../src/utils/type-validators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"type-validators.js","sourceRoot":"","sources":["../../../src/utils/type-validators.ts"],"names":[],"mappings":"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"}

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

@@ -1,11 +1,11 @@
-/** Validator function that validates and returns typed value */
-export type TypeValidator<T> = (value: unknown) => T;
+/** Validator function that validates and returns a typed value */
+export type ParamValidator<T> = (value: unknown) => T;
 /** Map of param name to type validator */
-export type TypedValidatorMap = Record<string, TypeValidator<unknown>>;
+export type ParamValidatorMap = Record<string, ParamValidator<unknown>>;
 /** Infer validated types from validator map */
-export type InferValidated<T extends TypedValidatorMap | undefined> = T extends TypedValidatorMap ? {
+export type ValidatedParams<T extends ParamValidatorMap | undefined> = T extends ParamValidatorMap ? {
     [K in keyof T]: ReturnType<T[K]>;
-} : Record<string, string>;
+} : Record<string, never>;
 export declare class HttpError extends Error {
     readonly status: number;
     readonly details?: Record<string, unknown> | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"api.types.js","sourceRoot":"","sources":["../../src/api.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAclD,MAAM,OAAO,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;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,OAAe;IACxE,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AA0BD,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAc,MAAS;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"api.types.js","sourceRoot":"","sources":["../../src/api.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAalD,MAAM,OAAO,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;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,OAAe;IACxE,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AA0BD,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAc,MAAS;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

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

@@ -1,4 +1,3 @@
-import { TypedValidatorMap } from './api.types';
 import { DeleteEndpoint, GetEndpoint, PatchEndpoint, PostEndpoint, PutEndpoint, RequestContext, ResponseOrValue } from './router';
 import { ExpressRouter } from './utils/express.utils';
 /**
@@ -8,19 +7,25 @@ import { ExpressRouter } from './utils/express.utils';
 export declare class RouteTable {
     private readonly app;
     constructor(app: ExpressRouter);
-    /** 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. */
+    /** Register a GET endpoint. */
+    get<Result>(path: string, endpoint: GetEndpoint<Result>): this;
+    /** Register a 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. */
+    /** Register a POST endpoint. */
+    post<Result = void>(path: string, endpoint: PostEndpoint<Result>): this;
+    /** Register a POST endpoint with function shorthand. */
+    post<Result = void>(path: string, run: (ctx: RequestContext) => ResponseOrValue<Result> | Promise<ResponseOrValue<Result>>): this;
+    /** Register a PATCH endpoint. */
+    patch<Result = void>(path: string, endpoint: PatchEndpoint<Result>): this;
+    /** Register a PATCH endpoint with function shorthand. */
+    patch<Result = void>(path: string, run: (ctx: RequestContext) => ResponseOrValue<Result> | Promise<ResponseOrValue<Result>>): this;
+    /** Register a PUT endpoint. */
+    put<Result = void>(path: string, endpoint: PutEndpoint<Result>): this;
+    /** Register a PUT endpoint with function shorthand. */
+    put<Result = void>(path: string, run: (ctx: RequestContext) => ResponseOrValue<Result> | Promise<ResponseOrValue<Result>>): this;
+    /** Register a DELETE endpoint with a full endpoint object. */
+    delete(path: string, endpoint: DeleteEndpoint): this;
+    /** Register a DELETE endpoint with function shorthand. */
     delete(path: string, run: (ctx: RequestContext) => void | Promise<void>): this;
 }
 /**

package/dist/esm/route-table.js

@@ -12,18 +12,18 @@ export class RouteTable {
         mountGet(this.app, path, endpoint);
         return this;
     }
-    /** Register POST endpoint with full type inference for path/query params. */
-    post(path, endpoint) {
+    post(path, endpointOrRun) {
+        const endpoint = typeof endpointOrRun === 'function' ? { run: endpointOrRun } : endpointOrRun;
         mountPost(this.app, path, endpoint);
         return this;
     }
-    /** Register PATCH endpoint with full type inference for path/query params. */
-    patch(path, endpoint) {
+    patch(path, endpointOrRun) {
+        const endpoint = typeof endpointOrRun === 'function' ? { run: endpointOrRun } : endpointOrRun;
         mountPatch(this.app, path, endpoint);
         return this;
     }
-    /** Register PUT endpoint with full type inference for path/query params. */
-    put(path, endpoint) {
+    put(path, endpointOrRun) {
+        const endpoint = typeof endpointOrRun === 'function' ? { run: endpointOrRun } : endpointOrRun;
         mountPut(this.app, path, endpoint);
         return this;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../../src/route-table.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,GAMT,MAAM,UAAU,CAAC;AAGlB;;;GAGG;AACH,MAAM,OAAO,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,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAgC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAKF,IAAY,EAAE,QAA6D;QAC3E,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA4C,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAKH,IAAY,EAAE,QAA8D;QAC5E,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA6C,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,GAAG,CAKD,IAAY,EAAE,QAA4D;QAC1E,QAAQ,CAAC,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,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA0B,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,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":"AAAA,OAAO,EAGL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,GAMT,MAAM,UAAU,CAAC;AAGlB;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,YAA6B,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;IAAG,CAAC;IAQnD,GAAG,CACD,IAAY,EACZ,aAA0H;QAE1H,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAgC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAQD,IAAI,CACF,IAAY,EACZ,aAA2H;QAE3H,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAiC,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAQD,KAAK,CACH,IAAY,EACZ,aAA4H;QAE5H,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAkC,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAQD,GAAG,CACD,IAAY,EACZ,aAA0H;QAE1H,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAgC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAQD,MAAM,CACJ,IAAY,EACZ,aAA+E;QAE/E,MAAM,QAAQ,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9F,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAA0B,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAkB;IACjD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/esm/router.d.ts

@@ -1,5 +1,5 @@
-import { Assertion, ObjectAssertion } from '@fishka/assertions';
-import { ApiResponse, InferValidated, TypedValidatorMap } from './api.types';
+import { Assertion } from '@fishka/assertions';
+import { ApiResponse, ParamValidator } from './api.types';
 import { AuthUser } from './auth/auth.types';
 import { ExpressRequest, ExpressResponse, ExpressRouter } from './utils/express.utils';
 /** Express API allows handlers to return a response in the raw form. */
@@ -10,19 +10,36 @@ export type ResponseOrValue<ResponseEntity> = ApiResponse<ResponseEntity> | Resp
  */
 export type EndpointMiddleware<Context = RequestContext> = (run: () => Promise<unknown>, context: Context) => Promise<unknown>;
 /** Generic request context passed to all handlers. Database-agnostic and extensible. */
-export interface RequestContext<Body = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> {
-    /** Parsed and validated request body (for POST/PATCH/PUT handlers). */
-    body: Body;
+export interface RequestContext {
     /** Express Request object. */
     req: ExpressRequest;
     /** Express Response object. */
     res: ExpressResponse;
     /** Authenticated user (if any). Populated by auth middleware. */
     authUser?: AuthUser;
-    /** Validated path parameters (typed from $path validators). */
-    path: InferValidated<PathParams>;
-    /** Validated query parameters (typed from $query validators). */
-    query: InferValidated<QueryParams>;
+    /**
+     * Get and validate a path parameter.
+     * @param name - Name of the path parameter
+     * @param validator - Optional validator. If not provided, returns the raw string value.
+     * @returns Validated value of type T (or string if no validator)
+     * @throws {HttpError} 400 Bad Request if validation fails
+     */
+    path<T = string>(name: string, validator?: ParamValidator<T>): T;
+    /**
+     * Get and validate a query parameter.
+     * @param name - Name of the query parameter
+     * @param validator - Optional validator. If not provided, returns the raw string value or undefined.
+     * @returns Validated value of type T, or undefined if parameter is not present
+     * @throws {HttpError} 400 Bad Request if validation fails
+     */
+    query<T = string>(name: string, validator?: ParamValidator<T>): T | undefined;
+    /**
+     * Get and validate the request body.
+     * @param validator - Validator function or object assertion
+     * @returns Validated body of type T
+     * @throws {HttpError} 400 Bad Request if validation fails
+     */
+    body<T>(validator: Assertion<T>): T;
     /**
      * Generic state storage for middleware to attach data.
      * Allows middleware to pass information to handlers and other middleware.
@@ -30,31 +47,24 @@ export interface RequestContext<Body = void, PathParams extends TypedValidatorMa
     state: Map<string, unknown>;
 }
 /** Base interface with common endpoint properties. */
-export interface EndpointBase<PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap, Body = void, Result = unknown> {
-    /** Path parameter validators (typed). */
-    $path?: PathParams;
-    /** Query parameter validators (typed). */
-    $query?: QueryParams;
+export interface EndpointBase<Result = unknown> {
     /** Optional middleware to execute before the handler. */
     middlewares?: Array<EndpointMiddleware>;
     /** Handler function. Can be sync or async. */
-    run: (ctx: RequestContext<Body, PathParams, QueryParams>) => ResponseOrValue<Result> | Promise<ResponseOrValue<Result>>;
+    run: (ctx: RequestContext) => ResponseOrValue<Result> | Promise<ResponseOrValue<Result>>;
 }
 /** Descriptor for GET list routes. */
-export type GetListEndpoint<ResultElementType, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> = EndpointBase<PathParams, QueryParams, void, Array<ResultElementType>>;
+export type GetListEndpoint<ResultElementType> = EndpointBase<Array<ResultElementType>>;
 /** Descriptor for GET routes. */
-export type GetEndpoint<Result, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> = EndpointBase<PathParams, QueryParams, void, Result>;
+export type GetEndpoint<Result> = EndpointBase<Result>;
 /** Descriptor for POST routes. */
-export interface PostEndpoint<Body, Result = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> extends EndpointBase<PathParams, QueryParams, Body, Result> {
-    /** Request body validator. */
-    $body: Body extends object ? ObjectAssertion<Body> : Assertion<Body>;
-}
+export type PostEndpoint<Result = void> = EndpointBase<Result>;
 /** Same as POST. Used for full object updates. */
-export type PutEndpoint<Body, Result = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> = PostEndpoint<Body, Result, PathParams, QueryParams>;
+export type PutEndpoint<Result = void> = EndpointBase<Result>;
 /** Same as PUT. While PUT is used for the whole object update, PATCH is used for a partial update. */
-export type PatchEndpoint<Body, Result = void, PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> = PutEndpoint<Body, Result, PathParams, QueryParams>;
+export type PatchEndpoint<Result = void> = EndpointBase<Result>;
 /** Descriptor for DELETE routes. */
-export type DeleteEndpoint<PathParams extends TypedValidatorMap = TypedValidatorMap, QueryParams extends TypedValidatorMap = TypedValidatorMap> = EndpointBase<PathParams, QueryParams, void, void>;
+export type DeleteEndpoint = EndpointBase<void>;
 /** Union type for all route registration info objects. */
 export type RouteRegistrationInfo = ({
     method: 'get';
@@ -77,11 +87,11 @@ export type RouteRegistrationInfo = ({
 /** Registers a GET route. */
 export declare const mountGet: (app: ExpressRouter, path: string, endpoint: GetEndpoint<unknown> | GetListEndpoint<unknown>) => void;
 /** Registers a POST route. */
-export declare const mountPost: <Body, Result>(app: ExpressRouter, path: string, endpoint: PostEndpoint<Body, Result>) => void;
+export declare const mountPost: <Result>(app: ExpressRouter, path: string, endpoint: PostEndpoint<Result>) => void;
 /** Registers a PATCH route. */
-export declare const mountPatch: <Body, Result>(app: ExpressRouter, path: string, endpoint: PatchEndpoint<Body, Result>) => void;
+export declare const mountPatch: <Result>(app: ExpressRouter, path: string, endpoint: PatchEndpoint<Result>) => void;
 /** Registers a PUT route. */
-export declare const mountPut: <Body, Result>(app: ExpressRouter, path: string, endpoint: PutEndpoint<Body, Result>) => void;
+export declare const mountPut: <Result>(app: ExpressRouter, path: string, endpoint: PutEndpoint<Result>) => void;
 /** Registers a DELETE route. */
 export declare const mountDelete: (app: ExpressRouter, path: string, endpoint: DeleteEndpoint) => void;
 /** Mounts a route with the given method, endpoint, and path. */

package/dist/esm/router.js

@@ -5,9 +5,94 @@ import { catchRouteErrors } from './error-handling';
 import { HTTP_BAD_REQUEST, HTTP_OK } from './http-status-codes';
 import { getRequestLocalStorage } from './thread-local/thread-local-storage';
 import { wrapAsApiResponse } from './utils/conversion.utils';
-// ============================================================================
-// Internal implementation details
-// ============================================================================
+/** Implementation of RequestContext with caching for validated parameters. */
+class RequestContextImpl {
+    constructor(
+    /** Express request object. */
+    req, 
+    /** Express response object. */
+    res, 
+    /** Authenticated user (if any). */
+    authUser, 
+    /** Request-scoped state storage. */
+    state = new Map()) {
+        this.req = req;
+        this.res = res;
+        this.authUser = authUser;
+        this.state = state;
+    }
+    /**
+     * Validates a parameter with optional validator and caching.
+     * @param name Parameter name.
+     * @param rawValue Raw parameter value from request.
+     * @param validator Optional validator function.
+     * @param cache Cache map for this parameter type.
+     * @param isRequired Whether parameter is required (path=true, query=false).
+     * @returns Validated value or undefined for optional missing parameters.
+     */
+    validateParam(name, rawValue, validator, isRequired) {
+        try {
+            let result;
+            if (validator) {
+                // Pass value to validator even if it's undefined/null/empty
+                result = validator(rawValue);
+            }
+            else {
+                // Without validator
+                if (rawValue === undefined || rawValue === null || rawValue === '') {
+                    if (isRequired) {
+                        assertHttp(false, HTTP_BAD_REQUEST, `Missing required parameter: ${name}`);
+                    }
+                    return undefined;
+                }
+                result = rawValue;
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof HttpError)
+                throw error;
+            throw new HttpError(HTTP_BAD_REQUEST, getMessageFromError(error));
+        }
+    }
+    path(name, validator) {
+        const rawValue = this.req.params[name];
+        const result = this.validateParam(name, rawValue, validator, true);
+        assertHttp(result !== undefined, HTTP_BAD_REQUEST, `Missing required path parameter: ${name}`);
+        return result;
+    }
+    query(name, validator) {
+        const parsedUrl = url.parse(this.req.url, true);
+        const rawValue = parsedUrl.query[name];
+        const value = Array.isArray(rawValue) ? rawValue[0] : rawValue;
+        return this.validateParam(name, value, validator, false);
+    }
+    body(validator) {
+        const apiRequest = this.req.body;
+        try {
+            // Handle validation based on whether the validator is an object or function
+            if (typeof validator === 'function') {
+                // It's a ValueAssertion (function) - call it directly
+                validator(apiRequest);
+            }
+            else {
+                // It's an ObjectAssertion - use validateObject
+                const objectValidator = validator;
+                const isEmptyValidator = Object.keys(objectValidator).length === 0;
+                const errorMessage = validateObject(apiRequest, objectValidator, `${HTTP_BAD_REQUEST}: request body`, {
+                    failOnUnknownFields: !isEmptyValidator,
+                });
+                assertHttp(!errorMessage, HTTP_BAD_REQUEST, errorMessage || 'Request body validation failed');
+            }
+            return apiRequest;
+        }
+        catch (error) {
+            if (error instanceof HttpError)
+                throw error;
+            throw new HttpError(HTTP_BAD_REQUEST, getMessageFromError(error));
+        }
+    }
+}
 /** Registers a GET route. */
 export const mountGet = (app, path, endpoint) => mount(app, { method: 'get', endpoint, path });
 /** Registers a POST route. */
@@ -54,48 +139,12 @@ function createRouteHandler(method, endpoint) {
         res.send(response);
     };
 }
-/**
- * @Internal
- * Validates and builds typed path/query parameters using $path and $query validators.
- */
-function buildValidatedParams(req, $path, $query) {
-    const pathResult = {};
-    const queryResult = {};
-    try {
-        // Validate path params
-        if ($path) {
-            for (const [key, validator] of Object.entries($path)) {
-                const value = req.params[key];
-                pathResult[key] = validator(value);
-            }
-        }
-        // Validate query params
-        if ($query) {
-            const parsedUrl = url.parse(req.url, true);
-            for (const [key, validator] of Object.entries($query)) {
-                const rawValue = parsedUrl.query[key];
-                const value = Array.isArray(rawValue) ? rawValue[0] : rawValue;
-                queryResult[key] = validator(value);
-            }
-        }
-    }
-    catch (error) {
-        if (error instanceof HttpError)
-            throw error;
-        throw new HttpError(HTTP_BAD_REQUEST, getMessageFromError(error));
-    }
-    return {
-        path: pathResult,
-        query: queryResult,
-    };
-}
 /**
  * @Internal
  * Runs GET handler with optional middleware.
  */
 async function executeGetEndpoint(route, req, res) {
-    const validated = buildValidatedParams(req, route.$path, route.$query);
-    const requestContext = newRequestContext(undefined, req, res, validated.path, validated.query);
+    const requestContext = new RequestContextImpl(req, res);
     return await executeWithMiddleware(() => route.run(requestContext), route.middlewares || [], requestContext);
 }
 /**
@@ -103,8 +152,7 @@ async function executeGetEndpoint(route, req, res) {
  * Runs DELETE handler with optional middleware.
  */
 async function executeDeleteEndpoint(route, req, res) {
-    const validated = buildValidatedParams(req, route.$path, route.$query);
-    const requestContext = newRequestContext(undefined, req, res, validated.path, validated.query);
+    const requestContext = new RequestContextImpl(req, res);
     await executeWithMiddleware(() => route.run(requestContext), route.middlewares || [], requestContext);
     return undefined;
 }
@@ -113,32 +161,8 @@ async function executeDeleteEndpoint(route, req, res) {
  * Runs POST/PUT/PATCH handler with optional middleware.
  */
 async function executeBodyEndpoint(route, req, res) {
-    const validator = route.$body;
-    const apiRequest = req.body;
-    try {
-        // Handle validation based on whether the validator is an object or function
-        if (typeof validator === 'function') {
-            // It's a ValueAssertion (function) - call it directly
-            validator(apiRequest);
-        }
-        else {
-            // It's an ObjectAssertion - use validateObject
-            const objectValidator = validator;
-            const isEmptyValidator = Object.keys(objectValidator).length === 0;
-            const errorMessage = validateObject(apiRequest, objectValidator, `${HTTP_BAD_REQUEST}: request body`, {
-                failOnUnknownFields: !isEmptyValidator,
-            });
-            assertHttp(!errorMessage, HTTP_BAD_REQUEST, errorMessage || 'Request body validation failed');
-        }
-    }
-    catch (error) {
-        if (error instanceof HttpError)
-            throw error;
-        throw new HttpError(HTTP_BAD_REQUEST, getMessageFromError(error));
-    }
-    const validated = buildValidatedParams(req, route.$path, route.$query);
-    const requestContext = newRequestContext(apiRequest, req, res, validated.path, validated.query);
-    return await executeWithMiddleware(() => route.run(requestContext), (route.middlewares || []), requestContext);
+    const requestContext = new RequestContextImpl(req, res);
+    return await executeWithMiddleware(() => route.run(requestContext), route.middlewares || [], requestContext);
 }
 /**
  * @Internal
@@ -155,18 +179,4 @@ async function executeWithMiddleware(run, middlewares, context) {
     };
     return await current(0);
 }
-/**
- * @Internal
- * Creates a new RequestContext instance.
- */
-function newRequestContext(requestBody, req, res, validatedPath, validatedQuery) {
-    return {
-        body: requestBody,
-        req,
-        res,
-        path: validatedPath,
-        query: validatedQuery,
-        state: new Map(),
-    };
-}
 //# sourceMappingURL=router.js.map