mini-nest 1.0.0

package/dist/examples/container.example.js

@@ -0,0 +1,31 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// This file is an example of how the DI container works. 
+require("reflect-metadata");
+const container_1 = require("../container");
+const injectable_1 = require("../injectable");
+const LoggerService_1 = require("./services/LoggerService");
+let UserService = class UserService {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    hello() {
+        this.logger.log('Hello from UserService');
+    }
+};
+UserService = __decorate([
+    (0, injectable_1.Injectable)(),
+    __metadata("design:paramtypes", [LoggerService_1.LoggerService])
+], UserService);
+const c = container_1.container;
+const service = c.resolve(UserService);
+service.hello();

package/dist/examples/container.example.mjs

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import "reflect-metadata";
+import { container } from "../container";
+function Injectable() {
+    return function (target) {
+        const dependencies = Reflect.getMetadata('design:paramtypes', target);
+        console.log('Dependencies for', target.name, ':', dependencies);
+        container.register(target, dependencies); // 👈 让 container 知道这个类依赖谁
+    };
+}
+let Logger = class Logger {
+    log(msg) {
+        console.log('[Logger]', msg);
+    }
+};
+Logger = __decorate([
+    Injectable()
+], Logger);
+let UserService = class UserService {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    hello() {
+        this.logger.log('Hello from UserService');
+    }
+};
+UserService = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Logger])
+], UserService);
+const c = container;
+const service = c.resolve(UserService);
+service.hello();

package/dist/examples/controllers/LogController.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogController = void 0;
+const controller_1 = require("../../controller");
+const createMethodDecorator_1 = require("../../request/createMethodDecorator");
+const interceptor_1 = require("../../request/interceptor");
+const LoggerInterceptor_1 = require("../interceptors/LoggerInterceptor");
+let LogController = class LogController {
+    test() {
+        console.log('[Handler] Executing');
+        return { ok: true };
+    }
+};
+exports.LogController = LogController;
+__decorate([
+    (0, createMethodDecorator_1.Get)('/test'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], LogController.prototype, "test", null);
+exports.LogController = LogController = __decorate([
+    (0, controller_1.Controller)('/log'),
+    (0, interceptor_1.UseInterceptor)(LoggerInterceptor_1.LoggerInterceptor)
+], LogController);

package/dist/examples/controllers/UserController.js

@@ -0,0 +1,68 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserController = void 0;
+const controller_1 = require("../../controller");
+const createMethodDecorator_1 = require("../../request/createMethodDecorator");
+const createParamDecorator_1 = require("../../request/createParamDecorator");
+const UserService_1 = require("../services/UserService");
+let UserController = class UserController {
+    constructor(userService) {
+        this.userService = userService;
+    }
+    getAll() {
+        return this.userService.getUsers();
+    }
+    getUser(id, v) {
+        if (v === 'true') {
+            return this.userService.getVerboseUser(id);
+        }
+        else {
+            return this.userService.getUserById(id);
+        }
+    }
+    createUser(id, expand, name, token) {
+        console.log('Injected parameters:', { id, expand, name, token });
+        return this.userService.createUser(id, name, expand, token);
+    }
+};
+exports.UserController = UserController;
+__decorate([
+    (0, createMethodDecorator_1.Get)('/'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], UserController.prototype, "getAll", null);
+__decorate([
+    (0, createMethodDecorator_1.Get)('/:id'),
+    __param(0, (0, createParamDecorator_1.Param)('id')),
+    __param(1, (0, createParamDecorator_1.Query)('verbose')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", void 0)
+], UserController.prototype, "getUser", null);
+__decorate([
+    (0, createMethodDecorator_1.Post)('/:id'),
+    __param(0, (0, createParamDecorator_1.Param)('id')),
+    __param(1, (0, createParamDecorator_1.Query)('expand')),
+    __param(2, (0, createParamDecorator_1.Body)('name')),
+    __param(3, (0, createParamDecorator_1.Header)('authorization')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, String, String, String]),
+    __metadata("design:returntype", void 0)
+], UserController.prototype, "createUser", null);
+exports.UserController = UserController = __decorate([
+    (0, controller_1.Controller)('/users'),
+    __metadata("design:paramtypes", [UserService_1.UserService])
+], UserController);

package/dist/examples/createTestApp.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestApp = createTestApp;
+const container_1 = require("../container");
+const simulateRequest_1 = require("../simulateRequest");
+require("reflect-metadata");
+async function createTestApp(controller, route, method, options) {
+    // auto register controller & its dependencies
+    if (!container_1.container.resolve(controller)) {
+        container_1.container.register(controller, undefined);
+    }
+    // optional manual service registration
+    options?.services?.forEach(serviceClass => {
+        if (!container_1.container.resolve(serviceClass)) {
+            container_1.container.register(serviceClass, new serviceClass());
+        }
+    });
+    // simulate request
+    return await (0, simulateRequest_1.simulateRequest)(route, method, {
+        body: options?.body,
+        headers: options?.headers,
+    });
+}

package/dist/examples/interceptors/LoggerInterceptor.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerInterceptor = void 0;
+class LoggerInterceptor {
+    async intercept(next) {
+        console.log('[Logger] Before handler');
+        const result = await next();
+        console.log('[Logger] After handler', result);
+        return result;
+    }
+}
+exports.LoggerInterceptor = LoggerInterceptor;

package/dist/examples/log.example.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const simulateRequest_1 = require("../simulateRequest");
+require("./controllers/LogController");
+require("reflect-metadata");
+(0, simulateRequest_1.simulateRequest)('/log/test', 'GET');

package/dist/examples/services/LoggerService.js

@@ -0,0 +1,19 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerService = void 0;
+const injectable_1 = require("../../injectable");
+let LoggerService = class LoggerService {
+    log(msg) {
+        console.log('[LoggerService]', msg);
+    }
+};
+exports.LoggerService = LoggerService;
+exports.LoggerService = LoggerService = __decorate([
+    (0, injectable_1.Injectable)()
+], LoggerService);

package/dist/examples/services/UserService.js

@@ -0,0 +1,40 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserService = void 0;
+const injectable_1 = require("../../injectable");
+const LoggerService_1 = require("./LoggerService");
+let UserService = class UserService {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    getUsers() {
+        this.logger.log('Fetching users...');
+        return ['Alice', 'Bob', 'Charlie'];
+    }
+    getUserById(id) {
+        this.logger.log(`Fetching user with id: ${id}`);
+        return { id, name: 'Alice' };
+    }
+    getVerboseUser(id) {
+        this.logger.log(`Fetching verbose user with id: ${id}`);
+        return { id, name: 'Alice', age: 30, email: 'example@example.com' };
+    }
+    createUser(id, name, expand, token) {
+        this.logger.log(`Creating user with id: ${id}, name: ${name}, expand: ${expand}, token: ${token}`);
+        return { id, name, expand, token };
+    }
+};
+exports.UserService = UserService;
+exports.UserService = UserService = __decorate([
+    (0, injectable_1.Injectable)(),
+    __metadata("design:paramtypes", [LoggerService_1.LoggerService])
+], UserService);

package/dist/exceptions/HTTPExceptions.d.ts

@@ -0,0 +1,36 @@
+import { BaseHTTPException, HttpExceptionResponse } from "./baseHTTPException";
+export interface ValidationError {
+    field: string;
+    message: string;
+    value?: any;
+}
+export interface ValidationExceptionResponse extends HttpExceptionResponse {
+    errors: ValidationError[];
+}
+export declare class BadRequestException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class UnauthorizedException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class ForbiddenException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class NotFoundException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class InternalServerErrorException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class NotImplementedException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class BadGatewayException extends BaseHTTPException {
+    constructor(message?: string);
+}
+export declare class ValidationException extends BaseHTTPException {
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[], message?: string);
+    getResponse(): ValidationExceptionResponse;
+}
+//# sourceMappingURL=HTTPExceptions.d.ts.map

package/dist/exceptions/HTTPExceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPExceptions.d.ts","sourceRoot":"","sources":["../../src/exceptions/HTTPExceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,GAAG,CAAC;CACf;AAED,MAAM,WAAW,2BAA4B,SAAQ,qBAAqB;IACtE,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;gBAC1C,OAAO,GAAE,MAAsB;CAG9C;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC5C,OAAO,GAAE,MAAuB;CAG/C;AAED,qBAAa,kBAAmB,SAAQ,iBAAiB;gBACzC,OAAO,GAAE,MAAoB;CAG5C;AAED,qBAAa,iBAAkB,SAAQ,iBAAiB;gBACxC,OAAO,GAAE,MAAoB;CAG5C;AAED,qBAAa,4BAA6B,SAAQ,iBAAiB;gBACnD,OAAO,GAAE,MAAgC;CAGxD;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAC9C,OAAO,GAAE,MAA0B;CAGlD;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;gBAC1C,OAAO,GAAE,MAAsB;CAG9C;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;aAElC,MAAM,EAAE,eAAe,EAAE;gBAAzB,MAAM,EAAE,eAAe,EAAE,EACzC,OAAO,GAAE,MAA4B;IAKhC,WAAW,IAAI,2BAA2B;CAQtD"}

package/dist/exceptions/HTTPExceptions.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationException = exports.BadGatewayException = exports.NotImplementedException = exports.InternalServerErrorException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = void 0;
+const baseHTTPException_1 = require("./baseHTTPException");
+class BadRequestException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Bad Request') {
+        super(message, 400, 'Bad Request');
+    }
+}
+exports.BadRequestException = BadRequestException;
+class UnauthorizedException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Unauthorized') {
+        super(message, 401, 'Unauthorized');
+    }
+}
+exports.UnauthorizedException = UnauthorizedException;
+class ForbiddenException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Forbidden') {
+        super(message, 403, 'Forbidden');
+    }
+}
+exports.ForbiddenException = ForbiddenException;
+class NotFoundException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Not Found') {
+        super(message, 404, 'Not Found');
+    }
+}
+exports.NotFoundException = NotFoundException;
+class InternalServerErrorException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Internal Server Error') {
+        super(message, 500, 'Internal Server Error');
+    }
+}
+exports.InternalServerErrorException = InternalServerErrorException;
+class NotImplementedException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Not Implemented') {
+        super(message, 501, 'Not Implemented');
+    }
+}
+exports.NotImplementedException = NotImplementedException;
+class BadGatewayException extends baseHTTPException_1.BaseHTTPException {
+    constructor(message = 'Bad Gateway') {
+        super(message, 502, 'Bad Gateway');
+    }
+}
+exports.BadGatewayException = BadGatewayException;
+class ValidationException extends baseHTTPException_1.BaseHTTPException {
+    constructor(errors, message = 'Validation failed') {
+        super(message, 422, 'Validation Error');
+        this.errors = errors;
+    }
+    getResponse() {
+        return {
+            statusCode: this.statusCode,
+            message: this.message,
+            error: this.error,
+            errors: this.errors,
+        };
+    }
+}
+exports.ValidationException = ValidationException;
+//# sourceMappingURL=HTTPExceptions.js.map

package/dist/exceptions/HTTPExceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPExceptions.js","sourceRoot":"","sources":["../../src/exceptions/HTTPExceptions.ts"],"names":[],"mappings":";;;AAAA,2DAA+E;AAW/E,MAAa,mBAAoB,SAAQ,qCAAiB;IACtD,YAAY,UAAkB,aAAa;QACvC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACvC,CAAC;CACJ;AAJD,kDAIC;AAED,MAAa,qBAAsB,SAAQ,qCAAiB;IACxD,YAAY,UAAkB,cAAc;QACxC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC;CACJ;AAJD,sDAIC;AAED,MAAa,kBAAmB,SAAQ,qCAAiB;IACrD,YAAY,UAAkB,WAAW;QACrC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;CACJ;AAJD,gDAIC;AAED,MAAa,iBAAkB,SAAQ,qCAAiB;IACpD,YAAY,UAAkB,WAAW;QACrC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;CACJ;AAJD,8CAIC;AAED,MAAa,4BAA6B,SAAQ,qCAAiB;IAC/D,YAAY,UAAkB,uBAAuB;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;IACjD,CAAC;CACJ;AAJD,oEAIC;AAED,MAAa,uBAAwB,SAAQ,qCAAiB;IAC1D,YAAY,UAAkB,iBAAiB;QAC3C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAC3C,CAAC;CACJ;AAJD,0DAIC;AAED,MAAa,mBAAoB,SAAQ,qCAAiB;IACtD,YAAY,UAAkB,aAAa;QACvC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACvC,CAAC;CACJ;AAJD,kDAIC;AAED,MAAa,mBAAoB,SAAQ,qCAAiB;IACtD,YACoB,MAAyB,EACzC,UAAkB,mBAAmB;QAErC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAHxB,WAAM,GAAN,MAAM,CAAmB;IAI7C,CAAC;IAEQ,WAAW;QAChB,OAAO;YACH,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAM;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC;IACN,CAAC;CACJ;AAhBD,kDAgBC"}

package/dist/exceptions/baseHTTPException.d.ts

@@ -0,0 +1,16 @@
+export interface HttpExceptionResponse {
+    statusCode: number;
+    message: string;
+    error: string;
+    timestamp?: string;
+    path?: string;
+}
+export declare class BaseHTTPException extends Error {
+    readonly message: string;
+    readonly statusCode: number;
+    readonly error?: string | undefined;
+    constructor(message: string, statusCode: number, error?: string | undefined);
+    getResponse(): HttpExceptionResponse;
+    getStatus(): number;
+}
+//# sourceMappingURL=baseHTTPException.d.ts.map

package/dist/exceptions/baseHTTPException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseHTTPException.d.ts","sourceRoot":"","sources":["../../src/exceptions/baseHTTPException.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACZ,OAAO,EAAE,MAAM;aAAkB,UAAU,EAAE,MAAM;aAAkB,KAAK,CAAC,EAAE,MAAM;gBAAnF,OAAO,EAAE,MAAM,EAAkB,UAAU,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA;IAM/G,WAAW,IAAI,qBAAqB;IAQpC,SAAS;CAGZ"}

package/dist/exceptions/baseHTTPException.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseHTTPException = void 0;
+class BaseHTTPException extends Error {
+    constructor(message, statusCode, error) {
+        super(message);
+        this.message = message;
+        this.statusCode = statusCode;
+        this.error = error;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    getResponse() {
+        return {
+            statusCode: this.statusCode,
+            message: this.message,
+            error: this.error || this.name,
+        };
+    }
+    getStatus() {
+        return this.statusCode;
+    }
+}
+exports.BaseHTTPException = BaseHTTPException;
+//# sourceMappingURL=baseHTTPException.js.map

package/dist/exceptions/baseHTTPException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseHTTPException.js","sourceRoot":"","sources":["../../src/exceptions/baseHTTPException.ts"],"names":[],"mappings":";;;AAQA,MAAa,iBAAkB,SAAQ,KAAK;IACxC,YAA4B,OAAe,EAAkB,UAAkB,EAAkB,KAAc;QAC3G,KAAK,CAAC,OAAO,CAAC,CAAC;QADS,YAAO,GAAP,OAAO,CAAQ;QAAkB,eAAU,GAAV,UAAU,CAAQ;QAAkB,UAAK,GAAL,KAAK,CAAS;QAE3G,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,WAAW;QACP,OAAO;YACH,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI;SACjC,CAAA;IACL,CAAC;IAED,SAAS;QACL,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;CACJ;AAlBD,8CAkBC"}

package/dist/exceptions/defaultExceptionFilter.d.ts

@@ -0,0 +1,10 @@
+import { ExecutionContext } from "../core/pipeline/ExecutionContext";
+import { ExceptionFilter } from "./exceptionFilter";
+export declare class DefaultExceptionFilter implements ExceptionFilter<any> {
+    catch(exception: unknown, context: ExecutionContext): void;
+    canHandle(_: unknown): boolean;
+    private handleHttpException;
+    private handleError;
+    private handleUnknown;
+}
+//# sourceMappingURL=defaultExceptionFilter.d.ts.map

package/dist/exceptions/defaultExceptionFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultExceptionFilter.d.ts","sourceRoot":"","sources":["../../src/exceptions/defaultExceptionFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAIrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,sBAAuB,YAAW,eAAe,CAAC,GAAG,CAAC;IAC/D,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAa1D,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAK9B,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;CAexB"}

package/dist/exceptions/defaultExceptionFilter.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultExceptionFilter = void 0;
+const log_1 = require("../utils/log");
+const baseHTTPException_1 = require("./baseHTTPException");
+class DefaultExceptionFilter {
+    catch(exception, context) {
+        const response = context.getResponse();
+        if (exception instanceof baseHTTPException_1.BaseHTTPException) {
+            this.handleHttpException(exception, response, context);
+        }
+        else if (exception instanceof Error) {
+            this.handleError(exception, response, context);
+        }
+        else {
+            this.handleUnknown(exception, response, context);
+        }
+    }
+    //by design this filter can handle any exception
+    canHandle(_) {
+        return true;
+    }
+    handleHttpException(exception, response, context) {
+        const exceptionResponse = exception.getResponse();
+        const request = context.getRequest();
+        const errorResponse = {
+            ...exceptionResponse,
+            timestamp: new Date().toISOString(),
+            path: request.path,
+        };
+        response.status(exceptionResponse.statusCode).json(errorResponse);
+        if (exception.statusCode >= 500) {
+            log_1.Log.error(`[HTTP Exception:] ${exceptionResponse.statusCode} ${exceptionResponse.message} on ${request.method} ${request.path}`, exception.stack);
+        }
+        else {
+            log_1.Log.warn(`[HTTP Exception:] ${exceptionResponse.statusCode} ${exceptionResponse.message} on ${request.method} ${request.path}`);
+        }
+    }
+    handleError(error, response, context) {
+        const request = context.getRequest();
+        const errorResponse = {
+            statusCode: 500,
+            message: 'Internal Server Error',
+            error: 'InternalServerError',
+            timestamp: new Date().toISOString(),
+            path: request.path,
+        };
+        response.status(500).json(errorResponse);
+        log_1.Log.error(`[Unhandled Exception:] 500 ${error.message} on ${request.method} ${request.path}`, error.stack);
+    }
+    handleUnknown(cause, response, context) {
+        const request = context.getRequest();
+        const errorResponse = {
+            statusCode: 500,
+            message: 'Internal Server Error',
+            error: 'InternalServerError',
+            timestamp: new Date().toISOString(),
+            path: request.path,
+        };
+        response.status(500).json(errorResponse);
+        log_1.Log.error(`[Unhandled Critical Exception:] Unknown error on ${request.method} ${request.path}, it is more likely the framework's fault than yours.`, JSON.stringify(cause));
+    }
+}
+exports.DefaultExceptionFilter = DefaultExceptionFilter;
+//# sourceMappingURL=defaultExceptionFilter.js.map

package/dist/exceptions/defaultExceptionFilter.js.map

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

package/dist/exceptions/exceptionFilter.d.ts

@@ -0,0 +1,6 @@
+import { ExecutionContext } from "../core/pipeline/ExecutionContext";
+export interface ExceptionFilter<T = any> {
+    catch(exception: T, context: ExecutionContext): void | Promise<void>;
+    canHandle(exception: unknown): boolean;
+}
+//# sourceMappingURL=exceptionFilter.d.ts.map

package/dist/exceptions/exceptionFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptionFilter.d.ts","sourceRoot":"","sources":["../../src/exceptions/exceptionFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACpC,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;CAC1C"}

package/dist/exceptions/exceptionFilter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=exceptionFilter.js.map

package/dist/exceptions/exceptionFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptionFilter.js","sourceRoot":"","sources":["../../src/exceptions/exceptionFilter.ts"],"names":[],"mappings":""}

package/dist/exceptions/exceptionHandler.d.ts

@@ -0,0 +1,12 @@
+import { ExecutionContext } from "../core/pipeline/ExecutionContext";
+import { HttpResponse } from "../http/HttpResponse";
+import { ExceptionFilter } from "./exceptionFilter";
+export declare class ExceptionHandler {
+    private filters;
+    private defaultFilter;
+    registerFilter(filter: ExceptionFilter, order: number): void;
+    handleException(exception: unknown, context: ExecutionContext): Promise<HttpResponse>;
+    clearCache(): void;
+}
+export declare const exceptionHandler: ExceptionHandler;
+//# sourceMappingURL=exceptionHandler.d.ts.map

package/dist/exceptions/exceptionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptionHandler.d.ts","sourceRoot":"","sources":["../../src/exceptions/exceptionHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQpD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,aAAa,CAAgC;IAErD,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM;IAK/C,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B3F,UAAU;CAGb;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/exceptions/exceptionHandler.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exceptionHandler = exports.ExceptionHandler = void 0;
+const log_1 = require("../utils/log");
+const defaultExceptionFilter_1 = require("./defaultExceptionFilter");
+//TODO: Improve Exception Handler to support async filters and filter chaining
+class ExceptionHandler {
+    constructor() {
+        this.filters = [];
+        this.defaultFilter = new defaultExceptionFilter_1.DefaultExceptionFilter();
+    }
+    registerFilter(filter, order) {
+        this.filters.push({ filter, order });
+        this.filters.sort((a, b) => a.order - b.order);
+    }
+    async handleException(exception, context) {
+        const response = context.getResponse();
+        for (const { filter } of this.filters) {
+            if (filter.canHandle && !filter.canHandle(exception)) {
+                continue;
+            }
+            try {
+                await filter.catch(exception, context);
+                return response;
+            }
+            catch (filterError) {
+                log_1.Log.error(`[Exception Filter Error:] Error in exception filter ${filter.constructor.name}`);
+            }
+        }
+        try {
+            await this.defaultFilter.catch(exception, context);
+        }
+        catch (defaultExceptionFilterError) {
+            log_1.Log.error(`[Default Exception Filter Error:] Error in default exception filter`);
+            response.status(500).json({
+                statusCode: 500,
+                message: 'Critical Internal Server Error, unable to process exception',
+                error: 'InternalServerError',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        return response;
+    }
+    clearCache() {
+        this.filters = [];
+    }
+}
+exports.ExceptionHandler = ExceptionHandler;
+exports.exceptionHandler = new ExceptionHandler();
+//# sourceMappingURL=exceptionHandler.js.map

package/dist/exceptions/exceptionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptionHandler.js","sourceRoot":"","sources":["../../src/exceptions/exceptionHandler.ts"],"names":[],"mappings":";;;AAEA,sCAAmC;AACnC,qEAAkE;AAQlE,8EAA8E;AAC9E,MAAa,gBAAgB;IAA7B;QACY,YAAO,GAAyB,EAAE,CAAC;QACnC,kBAAa,GAAG,IAAI,+CAAsB,EAAE,CAAC;IAwCzD,CAAC;IAtCG,cAAc,CAAC,MAAuB,EAAE,KAAa;QACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,SAAkB,EAAE,OAAyB;QAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnD,SAAS;YACb,CAAC;YACD,IAAI,CAAC;gBACD,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACvC,OAAO,QAAQ,CAAC;YACpB,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACnB,SAAG,CAAC,KAAK,CAAC,uDAAuD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;YAChG,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEvD,CAAC;QAAC,OAAO,2BAA2B,EAAE,CAAC;YACnC,SAAG,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;YACjF,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACtB,UAAU,EAAE,GAAG;gBACf,OAAO,EAAE,6DAA6D;gBACtE,KAAK,EAAE,qBAAqB;gBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,UAAU;QACN,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACtB,CAAC;CACJ;AA1CD,4CA0CC;AAGY,QAAA,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,6 @@
+export * from './baseHTTPException';
+export * from './HTTPExceptions';
+export * from './defaultExceptionFilter';
+export * from './exceptionHandler';
+export * from './exceptionFilter';
+//# sourceMappingURL=index.d.ts.map

package/dist/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}