refactor(http-router): enhance logging for validation errors in Router class

Author: ggazzo

packages/http-router/src/Router.ts

@@ -202,7 +202,12 @@ export class Router<
 			if (options.query) {
 				const validatorFn = options.query;
 				if (typeof options.query === 'function' && !validatorFn(queryParams)) {
-					logger.warn('Invalid query params', { error: validatorFn.errors?.map((error: any) => error.message).join('\n ') });
+					logger.warn({
+						msg: 'Query parameters validation failed - route spec does not match request payload',
+						method: req.method,
+						path: req.url,
+						error: validatorFn.errors?.map((error: any) => error.message).join('\n '),
+					});
 					return c.json(
 						{
 							success: false,
@@ -219,7 +224,12 @@ export class Router<
 			if (options.body) {
 				const validatorFn = options.body;
 				if (typeof options.body === 'function' && !validatorFn((req as any).bodyParams || bodyParams)) {
-					logger.warn('Invalid body params', { error: validatorFn.errors?.map((error: any) => error.message).join('\n ') });
+					logger.warn({
+						msg: 'Request body validation failed - route spec does not match request payload',
+						method: req.method,
+						path: req.url,
+						error: validatorFn.errors?.map((error: any) => error.message).join('\n '),
+					});
 					return c.json(
 						{
 							success: false,
@@ -245,7 +255,12 @@ export class Router<
 					throw new Error(`Missing response validator for endpoint ${req.method} - ${req.url} with status code ${statusCode}`);
 				}
 				if (responseValidatorFn && !responseValidatorFn(coerceDatesToStrings(body))) {
-					logger.warn('Invalid response', { error: responseValidatorFn.errors?.map((error: any) => error.message).join('\n ') });
+					logger.warn({
+						msg: 'Response validation failed - response does not match route spec',
+						method: req.method,
+						path: req.url,
+						error: responseValidatorFn.errors?.map((error: any) => error.message).join('\n '),
+					});
 					return c.json(
 						{
 							success: false,