wynkjs 1.0.3 → 1.0.4

package/dist/filters/exception.filters.d.ts

@@ -0,0 +1,124 @@
+import { NotFoundException, WynkExceptionFilter } from "../decorators/exception.decorators";
+import { ExecutionContext } from "../decorators/guard.decorators";
+/**
+ * Database Exception Filter - Handles database errors ONLY (not HttpExceptions)
+ *
+ * This filter catches actual database errors (like unique constraint violations,
+ * foreign key errors, etc.) and converts them to user-friendly messages.
+ *
+ * It will NOT catch HttpException or its subclasses (ConflictException, etc.)
+ * that you throw manually - those will pass through to be handled correctly.
+ *
+ * @example
+ * // Use as global filter
+ * app.useGlobalFilters(new DatabaseExceptionFilter());
+ *
+ * // Use on specific controller
+ * @UseFilters(DatabaseExceptionFilter)
+ * @Controller('/users')
+ * export class UserController {
+ *   @Post()
+ *   async create(@Body() data: any) {
+ *     // If you throw manually, it passes through:
+ *     if (await this.userExists(data.email)) {
+ *       throw new ConflictException('User with this email already exists'); // ✅ Works correctly
+ *     }
+ *
+ *     // If database throws error, filter catches it:
+ *     return await this.db.insert(users).values(data); // ❌ DB unique constraint error → caught by filter
+ *   }
+ * }
+ *
+ * Handles these database error codes:
+ * - 23505: Unique constraint violation → 409 Conflict
+ * - 23503: Foreign key constraint violation → 400 Bad Request
+ * - 23502: Not null constraint violation → 400 Bad Request
+ */
+export declare class DatabaseExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+    };
+}
+/**
+ * Not Found Exception Filter - Handles 404 errors with smart detection
+ *
+ * This filter is SMART - it only handles NotFoundExceptionFilter if:
+ * 1. The exception is NotFoundException, AND
+ * 2. No response data has been set (empty, null, empty array, or empty object)
+ *
+ * This allows it to be used globally without breaking routes that return
+ * legitimate empty responses or have their own error handling.
+ *
+ * @example
+ * // ✅ Can be used globally - smart filtering
+ * app.useGlobalFilters(
+ *   new NotFoundExceptionFilter(),  // Safe to use globally now!
+ *   new GlobalExceptionFilter()
+ * );
+ *
+ */
+export declare class NotFoundExceptionFilter implements WynkExceptionFilter<NotFoundException> {
+    catch(exception: NotFoundException, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+        suggestion: string;
+    };
+    /**
+     * Check if response has meaningful data
+     * Returns false for: null, undefined, {}, [], ""
+     * Returns true for: anything else
+     */
+    private hasResponseData;
+}
+/**
+ * File Upload Exception Filter - Handles file upload errors
+ * @example
+ * @UseFilters(FileUploadExceptionFilter)
+ * @Post('/upload')
+ * async upload(@UploadedFile() file: any) {}
+ */
+export declare class FileUploadExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+    };
+}
+/**
+ * Global Exception Filter - Catches all unhandled exceptions
+ * @example
+ * app.useGlobalFilters(new GlobalExceptionFilter());
+ */
+export declare class GlobalExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        stack?: any;
+        statusCode: any;
+        error: any;
+        message: any;
+        timestamp: string;
+        path: any;
+    };
+}
+/**
+// ============================================================================
+// KEY TAKEAWAYS
+// ============================================================================
+//
+// 1. Order matters: Specific → General
+// 2. Filters can re-throw exceptions they don't handle
+// 3. HttpException and subclasses should pass through specialized filters
+// 4. Global filters catch everything not handled by controller/method filters
+// 5. Always have a GlobalExceptionFilter as the last filter (catch-all)
+//
+// ============================================================================
+*/
+//# sourceMappingURL=exception.filters.d.ts.map

package/dist/filters/exception.filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.filters.d.ts","sourceRoot":"","sources":["../../core/filters/exception.filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;CAuChD;AAED;;;;;;;;;;;;;;;;;GAiBG;AAEH,qBAAa,uBACX,YAAW,mBAAmB,CAAC,iBAAiB,CAAC;IAEjD,KAAK,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;IAmB7D;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAuBxB;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IACnE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;CA2BhD;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;CA2BhD;AAED;;;;;;;;;;;;EAYE"}

package/dist/filters/exception.filters.js

@@ -0,0 +1,208 @@
+import { HttpException, } from "../decorators/exception.decorators";
+/**
+ * Database Exception Filter - Handles database errors ONLY (not HttpExceptions)
+ *
+ * This filter catches actual database errors (like unique constraint violations,
+ * foreign key errors, etc.) and converts them to user-friendly messages.
+ *
+ * It will NOT catch HttpException or its subclasses (ConflictException, etc.)
+ * that you throw manually - those will pass through to be handled correctly.
+ *
+ * @example
+ * // Use as global filter
+ * app.useGlobalFilters(new DatabaseExceptionFilter());
+ *
+ * // Use on specific controller
+ * @UseFilters(DatabaseExceptionFilter)
+ * @Controller('/users')
+ * export class UserController {
+ *   @Post()
+ *   async create(@Body() data: any) {
+ *     // If you throw manually, it passes through:
+ *     if (await this.userExists(data.email)) {
+ *       throw new ConflictException('User with this email already exists'); // ✅ Works correctly
+ *     }
+ *
+ *     // If database throws error, filter catches it:
+ *     return await this.db.insert(users).values(data); // ❌ DB unique constraint error → caught by filter
+ *   }
+ * }
+ *
+ * Handles these database error codes:
+ * - 23505: Unique constraint violation → 409 Conflict
+ * - 23503: Foreign key constraint violation → 400 Bad Request
+ * - 23502: Not null constraint violation → 400 Bad Request
+ */
+export class DatabaseExceptionFilter {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        // Don't catch HttpException or its subclasses (like ConflictException)
+        // These are intentionally thrown by the user
+        if (exception instanceof HttpException) {
+            throw exception;
+        }
+        // Check for common database errors
+        let message = "Database error occurred";
+        let statusCode = 500;
+        if (exception.code === "23505" || exception.message?.includes("unique")) {
+            message = "Resource already exists";
+            statusCode = 409; // Conflict
+        }
+        else if (exception.code === "23503" ||
+            exception.message?.includes("foreign key")) {
+            message = "Referenced resource does not exist";
+            statusCode = 400;
+        }
+        else if (exception.code === "23502" ||
+            exception.message?.includes("not null")) {
+            message = "Required field is missing";
+            statusCode = 400;
+        }
+        return {
+            statusCode,
+            error: "Database Error",
+            message,
+            timestamp: new Date().toISOString(),
+            path: request.url,
+        };
+    }
+}
+/**
+ * Not Found Exception Filter - Handles 404 errors with smart detection
+ *
+ * This filter is SMART - it only handles NotFoundExceptionFilter if:
+ * 1. The exception is NotFoundException, AND
+ * 2. No response data has been set (empty, null, empty array, or empty object)
+ *
+ * This allows it to be used globally without breaking routes that return
+ * legitimate empty responses or have their own error handling.
+ *
+ * @example
+ * // ✅ Can be used globally - smart filtering
+ * app.useGlobalFilters(
+ *   new NotFoundExceptionFilter(),  // Safe to use globally now!
+ *   new GlobalExceptionFilter()
+ * );
+ *
+ */
+export class NotFoundExceptionFilter {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        const hasResponseData = this.hasResponseData(response);
+        if (hasResponseData) {
+            throw exception;
+        }
+        return {
+            statusCode: exception.statusCode,
+            error: "Not Found",
+            message: exception.message || "Resource not found",
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            suggestion: "Please check the resource ID or URL",
+        };
+    }
+    /**
+     * Check if response has meaningful data
+     * Returns false for: null, undefined, {}, [], ""
+     * Returns true for: anything else
+     */
+    hasResponseData(response) {
+        if (response === null || response === undefined) {
+            return false;
+        }
+        // Check for empty object
+        if (typeof response === "object" && !Array.isArray(response)) {
+            return Object.keys(response).length > 0;
+        }
+        // Check for empty array
+        if (Array.isArray(response)) {
+            return response.length > 0;
+        }
+        // Check for empty string
+        if (typeof response === "string") {
+            return response.length > 0;
+        }
+        // For numbers, booleans, etc. - consider them as having data
+        return true;
+    }
+}
+/**
+ * File Upload Exception Filter - Handles file upload errors
+ * @example
+ * @UseFilters(FileUploadExceptionFilter)
+ * @Post('/upload')
+ * async upload(@UploadedFile() file: any) {}
+ */
+export class FileUploadExceptionFilter {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        // Don't catch HttpException or its subclasses
+        if (exception instanceof HttpException) {
+            throw exception;
+        }
+        let message = "File upload failed";
+        if (exception.message?.includes("size")) {
+            message = "File size exceeds limit";
+        }
+        else if (exception.message?.includes("type")) {
+            message = "Invalid file type";
+        }
+        else if (exception.message?.includes("required")) {
+            message = "File is required";
+        }
+        return {
+            statusCode: 400,
+            error: "File Upload Error",
+            message,
+            timestamp: new Date().toISOString(),
+            path: request.url,
+        };
+    }
+}
+/**
+ * Global Exception Filter - Catches all unhandled exceptions
+ * @example
+ * app.useGlobalFilters(new GlobalExceptionFilter());
+ */
+export class GlobalExceptionFilter {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        const statusCode = exception.statusCode || 500;
+        const message = exception.message || "Internal server error";
+        // Log the error for debugging
+        console.error("❌ Unhandled exception:", {
+            statusCode,
+            message,
+            path: request.url,
+            method: request.method,
+            stack: exception.stack,
+        });
+        return {
+            statusCode,
+            error: exception.name || "Error",
+            message,
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            ...(process.env.NODE_ENV === "development" && {
+                stack: exception.stack,
+            }),
+        };
+    }
+}
+/**
+// ============================================================================
+// KEY TAKEAWAYS
+// ============================================================================
+//
+// 1. Order matters: Specific → General
+// 2. Filters can re-throw exceptions they don't handle
+// 3. HttpException and subclasses should pass through specialized filters
+// 4. Global filters catch everything not handled by controller/method filters
+// 5. Always have a GlobalExceptionFilter as the last filter (catch-all)
+//
+// ============================================================================
+*/

package/dist/index.d.ts

@@ -17,9 +17,11 @@ export * from "./decorators/interceptor.advanced";
 export * from "./decorators/pipe.decorators";
 export * from "./decorators/pipe.advanced";
 export * from "./decorators/exception.decorators";
-export * from "./decorators/exception.advanced";
+export * from "./decorators/formatter.decorators";
+export * from "./filters/exception.filters";
 export * from "./decorators/database.decorators";
 export * from "./dto";
+export { schemaRegistry } from "./schema-registry";
 export * from "./factory";
 export * from "./testing";
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EACL,UAAU,EACV,MAAM,EACN,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EACL,UAAU,IAAI,UAAU,EACxB,MAAM,IAAI,MAAM,EAChB,SAAS,IAAI,SAAS,EACtB,cAAc,IAAI,cAAc,EAChC,QAAQ,IAAI,QAAQ,EACpB,SAAS,IAAI,SAAS,GACvB,MAAM,UAAU,CAAC;AAGlB,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAI3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAIhD,cAAc,kCAAkC,CAAC;AASjD,cAAc,OAAO,CAAC;AAGtB,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EACL,UAAU,EACV,MAAM,EACN,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EACL,UAAU,IAAI,UAAU,EACxB,MAAM,IAAI,MAAM,EAChB,SAAS,IAAI,SAAS,EACtB,cAAc,IAAI,cAAc,EAChC,QAAQ,IAAI,QAAQ,EACpB,SAAS,IAAI,SAAS,GACvB,MAAM,UAAU,CAAC;AAGlB,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAI3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAI5C,cAAc,kCAAkC,CAAC;AASjD,cAAc,OAAO,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -28,7 +28,8 @@ export * from "./decorators/pipe.advanced";
 // Note: validation.pipe.ts is deprecated, use pipe.decorators.ts instead
 // Exception Filters
 export * from "./decorators/exception.decorators";
-export * from "./decorators/exception.advanced";
+export * from "./decorators/formatter.decorators";
+export * from "./filters/exception.filters";
 // Database Registry (General-Purpose)
 // Works with ANY ORM/ODM: Drizzle, Mongoose, Prisma, TypeORM, custom Database classes
 export * from "./decorators/database.decorators";
@@ -39,6 +40,8 @@ export * from "./decorators/database.decorators";
 // See: plugins/drizzle and plugins/mongoose
 // DTO Utilities
 export * from "./dto";
+// Schema Registry for custom error messages
+export { schemaRegistry } from "./schema-registry";
 // Application Factory
 export * from "./factory";
 // Testing Module

package/dist/pipes/validation.pipe.d.ts

@@ -63,12 +63,12 @@ export declare class ValidationPipe implements ValidationPipeTransform {
      */
     protected parseValidationError(exception: any): ElysiaValidationError;
     /**
-     * Default error formatting
+     * Default error formatting with custom errorMessage support
      */
-    protected defaultFormatError(error: ElysiaValidationError): any;
+    protected defaultFormatError(error: ElysiaValidationError, schemaKey?: string): any;
 }
 /**
- * Custom Format Error Pipe (like NestJS example)
+ * Custom Format Error Pipe
  * Formats validation errors as { [field]: [messages] }
  */
 export declare class FormatErrorPipe extends ValidationPipe {

package/dist/pipes/validation.pipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.pipe.d.ts","sourceRoot":"","sources":["../../core/pipes/validation.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IACvD,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,GAAG,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,SAAS,CAAC,OAAO,EAAE;QACjB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,GAAG,CAAC;QAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;gBAEU,OAAO,CAAC,EAAE;QACpB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,GAAG,CAAC;QAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;IAID;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,GAAG,GAAG;IAItD;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG;IAahC;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,SAAS,EAAE,GAAG,GAAG,qBAAqB;IAgBrE;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,GAAG;CAyBhE;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,cAAc;;CA2BlD;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,cAAc;;CAsBlD;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;;CAgCpD"}
+{"version":3,"file":"validation.pipe.d.ts","sourceRoot":"","sources":["../../core/pipes/validation.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IACvD,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,GAAG,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,SAAS,CAAC,OAAO,EAAE;QACjB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,GAAG,CAAC;QAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;gBAEU,OAAO,CAAC,EAAE;QACpB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,GAAG,CAAC;QAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;IAID;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,GAAG,GAAG;IAItD;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG;IAahC;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,SAAS,EAAE,GAAG,GAAG,qBAAqB;IAgBrE;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAC1B,KAAK,EAAE,qBAAqB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,GAAG;CA2CP;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,cAAc;;CAiClD;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,cAAc;;CA4BlD;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;;CAoCpD"}

package/dist/pipes/validation.pipe.js

@@ -1,4 +1,5 @@
 import "reflect-metadata";
+import { schemaRegistry } from "../schema-registry";
 /**
  * Base Validation Pipe
  * Handles Elysia validation errors and formats them
@@ -47,23 +48,35 @@ export class ValidationPipe {
         return validationData;
     }
     /**
-     * Default error formatting
+     * Default error formatting with custom errorMessage support
      */
-    defaultFormatError(error) {
+    defaultFormatError(error, schemaKey) {
         const errors = [];
         if (error.errors && error.errors.length > 0) {
             error.errors.forEach((err) => {
+                const fieldPath = err.path?.replace(/^\//, "") || "unknown";
+                // Try to get custom message from schema registry first
+                let message = err.summary || err.message;
+                if (schemaKey) {
+                    const customMessage = schemaRegistry.getErrorMessage(schemaKey, fieldPath);
+                    if (customMessage) {
+                        message = customMessage;
+                    }
+                }
                 errors.push({
-                    field: err.path?.replace(/^\//, "") || "unknown",
-                    message: err.summary || err.message,
+                    field: fieldPath,
+                    message: message,
                     value: err.value,
                 });
             });
         }
         else {
+            // Check schema for custom errorMessage
+            const customMessage = error.schema?.errorMessage;
+            const message = customMessage || error.summary || error.message;
             errors.push({
                 field: error.property?.replace(/^\//, "") || "unknown",
-                message: error.summary || error.message,
+                message: message,
                 value: error.value,
             });
         }
@@ -75,7 +88,7 @@ export class ValidationPipe {
     }
 }
 /**
- * Custom Format Error Pipe (like NestJS example)
+ * Custom Format Error Pipe
  * Formats validation errors as { [field]: [messages] }
  */
 export class FormatErrorPipe extends ValidationPipe {
@@ -89,12 +102,18 @@ export class FormatErrorPipe extends ValidationPipe {
                         if (!formattedErrors[field]) {
                             formattedErrors[field] = [];
                         }
-                        formattedErrors[field].push(err.summary || err.message);
+                        // Use custom errorMessage if available
+                        const customMessage = err.schema?.errorMessage;
+                        const message = customMessage || err.summary || err.message;
+                        formattedErrors[field].push(message);
                     });
                 }
                 else {
                     const field = error.property?.replace(/^\//, "") || "unknown";
-                    formattedErrors[field] = [error.summary || error.message];
+                    // Use custom errorMessage if available
+                    const customMessage = error.schema?.errorMessage;
+                    const message = customMessage || error.summary || error.message;
+                    formattedErrors[field] = [message];
                 }
                 return {
                     statusCode: 400,
@@ -116,11 +135,17 @@ export class SimpleErrorPipe extends ValidationPipe {
                 const messages = [];
                 if (error.errors && error.errors.length > 0) {
                     error.errors.forEach((err) => {
-                        messages.push(err.summary || err.message);
+                        // Use custom errorMessage if available
+                        const customMessage = err.schema?.errorMessage;
+                        const message = customMessage || err.summary || err.message;
+                        messages.push(message);
                     });
                 }
                 else {
-                    messages.push(error.summary || error.message);
+                    // Use custom errorMessage if available
+                    const customMessage = error.schema?.errorMessage;
+                    const message = customMessage || error.summary || error.message;
+                    messages.push(message);
                 }
                 return {
                     statusCode: 400,
@@ -142,9 +167,12 @@ export class DetailedErrorPipe extends ValidationPipe {
                 const errors = [];
                 if (error.errors && error.errors.length > 0) {
                     error.errors.forEach((err) => {
+                        // Use custom errorMessage if available
+                        const customMessage = err.schema?.errorMessage;
+                        const message = customMessage || err.summary || err.message;
                         errors.push({
                             field: err.path?.replace(/^\//, "") || "unknown",
-                            message: err.summary || err.message,
+                            message: message,
                             value: err.value,
                             expected: err.schema?.format
                                 ? `${err.schema.type} (format: ${err.schema.format})`

package/dist/schema-registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Schema Registry for storing and retrieving custom error messages
+ * This allows validation pipes to look up custom error messages from schemas
+ */
+declare class SchemaRegistry {
+    private static instance;
+    private errorMessages;
+    private routeSchemas;
+    private constructor();
+    static getInstance(): SchemaRegistry;
+    /**
+     * Register custom error messages for a schema
+     * @param schemaKey Unique key for the schema (e.g., class name + method)
+     * @param schema The TypeBox schema object
+     */
+    registerSchema(schemaKey: string, schema: any): void;
+    /**
+     * Register route-to-schema mapping
+     * @param method HTTP method (GET, POST, etc.)
+     * @param path Route path
+     * @param schemaKey The schema key
+     * @param validationType Type of validation (body, query, params)
+     */
+    registerRoute(method: string, path: string, schemaKey: string, validationType: "body" | "query" | "params"): void;
+    /**
+     * Get schema key for a route and validation type
+     * @param method HTTP method
+     * @param path Route path (actual request path with values)
+     * @param validationType Type of validation
+     * @returns Schema key or undefined
+     */
+    getSchemaKeyForRoute(method: string, path: string, validationType: "body" | "query" | "params"): string | undefined;
+    /**
+     * Recursively extract error messages from schema
+     */
+    private extractErrorMessages;
+    /**
+     * Get custom error message for a field path
+     * @param schemaKey The schema key
+     * @param fieldPath The field path (e.g., "user.email")
+     * @returns Custom error message or undefined
+     */
+    getErrorMessage(schemaKey: string, fieldPath: string): string | undefined;
+    /**
+     * Clear all registered schemas (useful for testing)
+     */
+    clear(): void;
+}
+export declare const schemaRegistry: SchemaRegistry;
+export {};
+//# sourceMappingURL=schema-registry.d.ts.map

package/dist/schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../core/schema-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,YAAY,CAAsB;IAE1C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAWpD;;;;;;OAMG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAC1C,IAAI;IAUP;;;;;;OAMG;IACH,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAC1C,MAAM,GAAG,SAAS;IAyCrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBzE;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,eAAO,MAAM,cAAc,gBAA+B,CAAC"}