@riktajs/core 0.1.0

package/dist/core/exceptions/exceptions.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GatewayTimeoutException = exports.ServiceUnavailableException = exports.BadGatewayException = exports.NotImplementedException = exports.InternalServerErrorException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.UnsupportedMediaTypeException = exports.PayloadTooLargeException = exports.GoneException = exports.ConflictException = exports.RequestTimeoutException = exports.NotAcceptableException = exports.MethodNotAllowedException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = void 0;
+const http_exception_1 = require("./http-exception");
+// ============================================================================
+// 4xx Client Errors
+// ============================================================================
+/**
+ * 400 Bad Request
+ *
+ * The server cannot process the request due to client error.
+ *
+ * @example
+ * ```typescript
+ * throw new BadRequestException('Invalid input data');
+ *
+ * throw new BadRequestException({
+ *   message: 'Validation failed',
+ *   details: { email: 'Invalid format' }
+ * });
+ * ```
+ */
+class BadRequestException extends http_exception_1.HttpException {
+    constructor(response = 'Bad Request') {
+        super(response, 400);
+    }
+}
+exports.BadRequestException = BadRequestException;
+/**
+ * 401 Unauthorized
+ *
+ * Authentication is required and has failed or not been provided.
+ *
+ * @example
+ * ```typescript
+ * throw new UnauthorizedException('Invalid credentials');
+ * throw new UnauthorizedException('Token expired');
+ * ```
+ */
+class UnauthorizedException extends http_exception_1.HttpException {
+    constructor(response = 'Unauthorized') {
+        super(response, 401);
+    }
+}
+exports.UnauthorizedException = UnauthorizedException;
+/**
+ * 403 Forbidden
+ *
+ * The server understood the request but refuses to authorize it.
+ *
+ * @example
+ * ```typescript
+ * throw new ForbiddenException('Access denied');
+ * throw new ForbiddenException('Insufficient permissions');
+ * ```
+ */
+class ForbiddenException extends http_exception_1.HttpException {
+    constructor(response = 'Forbidden') {
+        super(response, 403);
+    }
+}
+exports.ForbiddenException = ForbiddenException;
+/**
+ * 404 Not Found
+ *
+ * The requested resource could not be found.
+ *
+ * @example
+ * ```typescript
+ * throw new NotFoundException('User not found');
+ * throw new NotFoundException(`Resource ${id} not found`);
+ * ```
+ */
+class NotFoundException extends http_exception_1.HttpException {
+    constructor(response = 'Not Found') {
+        super(response, 404);
+    }
+}
+exports.NotFoundException = NotFoundException;
+/**
+ * 405 Method Not Allowed
+ *
+ * The request method is not supported for the requested resource.
+ *
+ * @example
+ * ```typescript
+ * throw new MethodNotAllowedException('POST not allowed on this endpoint');
+ * ```
+ */
+class MethodNotAllowedException extends http_exception_1.HttpException {
+    constructor(response = 'Method Not Allowed') {
+        super(response, 405);
+    }
+}
+exports.MethodNotAllowedException = MethodNotAllowedException;
+/**
+ * 406 Not Acceptable
+ *
+ * The requested resource is not capable of generating content acceptable
+ * according to the Accept headers sent in the request.
+ */
+class NotAcceptableException extends http_exception_1.HttpException {
+    constructor(response = 'Not Acceptable') {
+        super(response, 406);
+    }
+}
+exports.NotAcceptableException = NotAcceptableException;
+/**
+ * 408 Request Timeout
+ *
+ * The server timed out waiting for the request.
+ */
+class RequestTimeoutException extends http_exception_1.HttpException {
+    constructor(response = 'Request Timeout') {
+        super(response, 408);
+    }
+}
+exports.RequestTimeoutException = RequestTimeoutException;
+/**
+ * 409 Conflict
+ *
+ * The request conflicts with the current state of the server.
+ *
+ * @example
+ * ```typescript
+ * throw new ConflictException('Email already exists');
+ * throw new ConflictException('Version conflict');
+ * ```
+ */
+class ConflictException extends http_exception_1.HttpException {
+    constructor(response = 'Conflict') {
+        super(response, 409);
+    }
+}
+exports.ConflictException = ConflictException;
+/**
+ * 410 Gone
+ *
+ * The resource is no longer available and will not be available again.
+ */
+class GoneException extends http_exception_1.HttpException {
+    constructor(response = 'Gone') {
+        super(response, 410);
+    }
+}
+exports.GoneException = GoneException;
+/**
+ * 413 Payload Too Large
+ *
+ * The request entity is larger than limits defined by the server.
+ */
+class PayloadTooLargeException extends http_exception_1.HttpException {
+    constructor(response = 'Payload Too Large') {
+        super(response, 413);
+    }
+}
+exports.PayloadTooLargeException = PayloadTooLargeException;
+/**
+ * 415 Unsupported Media Type
+ *
+ * The media format of the requested data is not supported by the server.
+ */
+class UnsupportedMediaTypeException extends http_exception_1.HttpException {
+    constructor(response = 'Unsupported Media Type') {
+        super(response, 415);
+    }
+}
+exports.UnsupportedMediaTypeException = UnsupportedMediaTypeException;
+/**
+ * 422 Unprocessable Entity
+ *
+ * The server understands the content type, but was unable to process the contained instructions.
+ *
+ * @example
+ * ```typescript
+ * throw new UnprocessableEntityException({
+ *   message: 'Validation failed',
+ *   details: [
+ *     { field: 'email', message: 'Invalid email format' },
+ *     { field: 'age', message: 'Must be a positive number' }
+ *   ]
+ * });
+ * ```
+ */
+class UnprocessableEntityException extends http_exception_1.HttpException {
+    constructor(response = 'Unprocessable Entity') {
+        super(response, 422);
+    }
+}
+exports.UnprocessableEntityException = UnprocessableEntityException;
+/**
+ * 429 Too Many Requests
+ *
+ * The user has sent too many requests in a given amount of time.
+ *
+ * @example
+ * ```typescript
+ * throw new TooManyRequestsException('Rate limit exceeded. Try again in 60 seconds.');
+ * ```
+ */
+class TooManyRequestsException extends http_exception_1.HttpException {
+    constructor(response = 'Too Many Requests') {
+        super(response, 429);
+    }
+}
+exports.TooManyRequestsException = TooManyRequestsException;
+// ============================================================================
+// 5xx Server Errors
+// ============================================================================
+/**
+ * 500 Internal Server Error
+ *
+ * A generic server error occurred.
+ *
+ * @example
+ * ```typescript
+ * throw new InternalServerErrorException('An unexpected error occurred');
+ * ```
+ */
+class InternalServerErrorException extends http_exception_1.HttpException {
+    constructor(response = 'Internal Server Error') {
+        super(response, 500);
+    }
+}
+exports.InternalServerErrorException = InternalServerErrorException;
+/**
+ * 501 Not Implemented
+ *
+ * The server does not support the functionality required to fulfill the request.
+ */
+class NotImplementedException extends http_exception_1.HttpException {
+    constructor(response = 'Not Implemented') {
+        super(response, 501);
+    }
+}
+exports.NotImplementedException = NotImplementedException;
+/**
+ * 502 Bad Gateway
+ *
+ * The server received an invalid response from an upstream server.
+ */
+class BadGatewayException extends http_exception_1.HttpException {
+    constructor(response = 'Bad Gateway') {
+        super(response, 502);
+    }
+}
+exports.BadGatewayException = BadGatewayException;
+/**
+ * 503 Service Unavailable
+ *
+ * The server is not ready to handle the request.
+ *
+ * @example
+ * ```typescript
+ * throw new ServiceUnavailableException('Service is under maintenance');
+ * ```
+ */
+class ServiceUnavailableException extends http_exception_1.HttpException {
+    constructor(response = 'Service Unavailable') {
+        super(response, 503);
+    }
+}
+exports.ServiceUnavailableException = ServiceUnavailableException;
+/**
+ * 504 Gateway Timeout
+ *
+ * The server did not receive a timely response from an upstream server.
+ */
+class GatewayTimeoutException extends http_exception_1.HttpException {
+    constructor(response = 'Gateway Timeout') {
+        super(response, 504);
+    }
+}
+exports.GatewayTimeoutException = GatewayTimeoutException;
+//# sourceMappingURL=exceptions.js.map

package/dist/core/exceptions/exceptions.js.map

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

package/dist/core/exceptions/http-exception.d.ts

@@ -0,0 +1,79 @@
+/**
+ * HTTP Exception Base Class
+ *
+ * Base class for all HTTP exceptions in Rikta.
+ * Provides a standard structure for error responses.
+ *
+ * @example
+ * ```typescript
+ * // Throw directly
+ * throw new HttpException('Something went wrong', 500);
+ *
+ * // With additional details
+ * throw new HttpException({
+ *   message: 'Validation failed',
+ *   error: 'Bad Request',
+ *   details: { field: 'email', reason: 'Invalid format' }
+ * }, 400);
+ * ```
+ */
+export declare class HttpException extends Error {
+    /**
+     * HTTP status code
+     */
+    readonly statusCode: number;
+    /**
+     * Error response object
+     */
+    readonly response: HttpExceptionResponse;
+    /**
+     * Timestamp when the exception was created
+     */
+    readonly timestamp: string;
+    constructor(response: string | HttpExceptionBody, statusCode?: number);
+    /**
+     * Get the response object for JSON serialization
+     */
+    getResponse(): HttpExceptionResponse;
+    /**
+     * Get the HTTP status code
+     */
+    getStatus(): number;
+    /**
+     * Get default error name for status code
+     */
+    private getDefaultError;
+}
+/**
+ * Exception body structure for custom responses
+ */
+export interface HttpExceptionBody {
+    /** Error message */
+    message: string;
+    /** Error type/name (e.g., "Bad Request", "Validation Error") */
+    error?: string;
+    /** Additional error details */
+    details?: unknown;
+    /** Application-specific error code */
+    code?: string;
+}
+/**
+ * Standard HTTP exception response format
+ */
+export interface HttpExceptionResponse {
+    /** HTTP status code */
+    statusCode: number;
+    /** Error message */
+    message: string;
+    /** Error type/name */
+    error: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Additional error details (optional) */
+    details?: unknown;
+    /** Application-specific error code (optional) */
+    code?: string;
+    /** Request path (added by filter) */
+    path?: string;
+}
+//# sourceMappingURL=http-exception.d.ts.map

package/dist/core/exceptions/http-exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exception.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/http-exception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGzB,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EACpC,UAAU,GAAE,MAAY;IAmC1B;;OAEG;IACH,WAAW,IAAI,qBAAqB;IAIpC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,OAAO,CAAC,eAAe;CAuBxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/core/exceptions/http-exception.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpException = void 0;
+/**
+ * HTTP Exception Base Class
+ *
+ * Base class for all HTTP exceptions in Rikta.
+ * Provides a standard structure for error responses.
+ *
+ * @example
+ * ```typescript
+ * // Throw directly
+ * throw new HttpException('Something went wrong', 500);
+ *
+ * // With additional details
+ * throw new HttpException({
+ *   message: 'Validation failed',
+ *   error: 'Bad Request',
+ *   details: { field: 'email', reason: 'Invalid format' }
+ * }, 400);
+ * ```
+ */
+class HttpException extends Error {
+    /**
+     * HTTP status code
+     */
+    statusCode;
+    /**
+     * Error response object
+     */
+    response;
+    /**
+     * Timestamp when the exception was created
+     */
+    timestamp;
+    constructor(response, statusCode = 500) {
+        const message = typeof response === 'string'
+            ? response
+            : response.message;
+        super(message);
+        this.name = this.constructor.name;
+        this.statusCode = statusCode;
+        this.timestamp = new Date().toISOString();
+        // Build response object
+        if (typeof response === 'string') {
+            this.response = {
+                statusCode,
+                message,
+                error: this.getDefaultError(statusCode),
+                timestamp: this.timestamp,
+            };
+        }
+        else {
+            this.response = {
+                statusCode,
+                message: response.message,
+                error: response.error ?? this.getDefaultError(statusCode),
+                timestamp: this.timestamp,
+                ...(response.details ? { details: response.details } : {}),
+                ...(response.code ? { code: response.code } : {}),
+            };
+        }
+        // Capture stack trace
+        Error.captureStackTrace(this, this.constructor);
+    }
+    /**
+     * Get the response object for JSON serialization
+     */
+    getResponse() {
+        return this.response;
+    }
+    /**
+     * Get the HTTP status code
+     */
+    getStatus() {
+        return this.statusCode;
+    }
+    /**
+     * Get default error name for status code
+     */
+    getDefaultError(statusCode) {
+        const errors = {
+            400: 'Bad Request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not Found',
+            405: 'Method Not Allowed',
+            406: 'Not Acceptable',
+            408: 'Request Timeout',
+            409: 'Conflict',
+            410: 'Gone',
+            413: 'Payload Too Large',
+            415: 'Unsupported Media Type',
+            422: 'Unprocessable Entity',
+            429: 'Too Many Requests',
+            500: 'Internal Server Error',
+            501: 'Not Implemented',
+            502: 'Bad Gateway',
+            503: 'Service Unavailable',
+            504: 'Gateway Timeout',
+        };
+        return errors[statusCode] ?? 'Error';
+    }
+}
+exports.HttpException = HttpException;
+//# sourceMappingURL=http-exception.js.map

package/dist/core/exceptions/http-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exception.js","sourceRoot":"","sources":["../../../src/core/exceptions/http-exception.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC;;OAEG;IACM,UAAU,CAAS;IAE5B;;OAEG;IACM,QAAQ,CAAwB;IAEzC;;OAEG;IACM,SAAS,CAAS;IAE3B,YACE,QAAoC,EACpC,aAAqB,GAAG;QAExB,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ;YAC1C,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE1C,wBAAwB;QACxB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG;gBACd,UAAU;gBACV,OAAO;gBACP,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC;gBACvC,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG;gBACd,UAAU;gBACV,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC;gBACzD,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD,CAAC;QACJ,CAAC;QAED,sBAAsB;QACtB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,UAAkB;QACxC,MAAM,MAAM,GAA2B;YACrC,GAAG,EAAE,aAAa;YAClB,GAAG,EAAE,cAAc;YACnB,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE,oBAAoB;YACzB,GAAG,EAAE,gBAAgB;YACrB,GAAG,EAAE,iBAAiB;YACtB,GAAG,EAAE,UAAU;YACf,GAAG,EAAE,MAAM;YACX,GAAG,EAAE,mBAAmB;YACxB,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,sBAAsB;YAC3B,GAAG,EAAE,mBAAmB;YACxB,GAAG,EAAE,uBAAuB;YAC5B,GAAG,EAAE,iBAAiB;YACtB,GAAG,EAAE,aAAa;YAClB,GAAG,EAAE,qBAAqB;YAC1B,GAAG,EAAE,iBAAiB;SACvB,CAAC;QACF,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC;IACvC,CAAC;CACF;AA7FD,sCA6FC"}

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

@@ -0,0 +1,5 @@
+export { HttpException, HttpExceptionBody, HttpExceptionResponse } from './http-exception';
+export { BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, MethodNotAllowedException, NotAcceptableException, RequestTimeoutException, ConflictException, GoneException, PayloadTooLargeException, UnsupportedMediaTypeException, UnprocessableEntityException, TooManyRequestsException, InternalServerErrorException, NotImplementedException, BadGatewayException, ServiceUnavailableException, GatewayTimeoutException, } from './exceptions';
+export { ExceptionFilter, ExceptionContext, ErrorResponse, GlobalExceptionFilter, GlobalExceptionFilterOptions, createExceptionHandler, } from './exception-filter';
+export { Catch, CatchMetadata, CATCH_METADATA, getCatchMetadata } from './catch.decorator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAEL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EAExB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/exceptions/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCatchMetadata = exports.CATCH_METADATA = exports.Catch = exports.createExceptionHandler = exports.GlobalExceptionFilter = exports.GatewayTimeoutException = exports.ServiceUnavailableException = exports.BadGatewayException = exports.NotImplementedException = exports.InternalServerErrorException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.UnsupportedMediaTypeException = exports.PayloadTooLargeException = exports.GoneException = exports.ConflictException = exports.RequestTimeoutException = exports.NotAcceptableException = exports.MethodNotAllowedException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.HttpException = void 0;
+// HTTP Exception
+var http_exception_1 = require("./http-exception");
+Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return http_exception_1.HttpException; } });
+// Specific Exceptions
+var exceptions_1 = require("./exceptions");
+// 4xx Client Errors
+Object.defineProperty(exports, "BadRequestException", { enumerable: true, get: function () { return exceptions_1.BadRequestException; } });
+Object.defineProperty(exports, "UnauthorizedException", { enumerable: true, get: function () { return exceptions_1.UnauthorizedException; } });
+Object.defineProperty(exports, "ForbiddenException", { enumerable: true, get: function () { return exceptions_1.ForbiddenException; } });
+Object.defineProperty(exports, "NotFoundException", { enumerable: true, get: function () { return exceptions_1.NotFoundException; } });
+Object.defineProperty(exports, "MethodNotAllowedException", { enumerable: true, get: function () { return exceptions_1.MethodNotAllowedException; } });
+Object.defineProperty(exports, "NotAcceptableException", { enumerable: true, get: function () { return exceptions_1.NotAcceptableException; } });
+Object.defineProperty(exports, "RequestTimeoutException", { enumerable: true, get: function () { return exceptions_1.RequestTimeoutException; } });
+Object.defineProperty(exports, "ConflictException", { enumerable: true, get: function () { return exceptions_1.ConflictException; } });
+Object.defineProperty(exports, "GoneException", { enumerable: true, get: function () { return exceptions_1.GoneException; } });
+Object.defineProperty(exports, "PayloadTooLargeException", { enumerable: true, get: function () { return exceptions_1.PayloadTooLargeException; } });
+Object.defineProperty(exports, "UnsupportedMediaTypeException", { enumerable: true, get: function () { return exceptions_1.UnsupportedMediaTypeException; } });
+Object.defineProperty(exports, "UnprocessableEntityException", { enumerable: true, get: function () { return exceptions_1.UnprocessableEntityException; } });
+Object.defineProperty(exports, "TooManyRequestsException", { enumerable: true, get: function () { return exceptions_1.TooManyRequestsException; } });
+// 5xx Server Errors
+Object.defineProperty(exports, "InternalServerErrorException", { enumerable: true, get: function () { return exceptions_1.InternalServerErrorException; } });
+Object.defineProperty(exports, "NotImplementedException", { enumerable: true, get: function () { return exceptions_1.NotImplementedException; } });
+Object.defineProperty(exports, "BadGatewayException", { enumerable: true, get: function () { return exceptions_1.BadGatewayException; } });
+Object.defineProperty(exports, "ServiceUnavailableException", { enumerable: true, get: function () { return exceptions_1.ServiceUnavailableException; } });
+Object.defineProperty(exports, "GatewayTimeoutException", { enumerable: true, get: function () { return exceptions_1.GatewayTimeoutException; } });
+// Exception Filter
+var exception_filter_1 = require("./exception-filter");
+Object.defineProperty(exports, "GlobalExceptionFilter", { enumerable: true, get: function () { return exception_filter_1.GlobalExceptionFilter; } });
+Object.defineProperty(exports, "createExceptionHandler", { enumerable: true, get: function () { return exception_filter_1.createExceptionHandler; } });
+// Catch Decorator
+var catch_decorator_1 = require("./catch.decorator");
+Object.defineProperty(exports, "Catch", { enumerable: true, get: function () { return catch_decorator_1.Catch; } });
+Object.defineProperty(exports, "CATCH_METADATA", { enumerable: true, get: function () { return catch_decorator_1.CATCH_METADATA; } });
+Object.defineProperty(exports, "getCatchMetadata", { enumerable: true, get: function () { return catch_decorator_1.getCatchMetadata; } });
+//# sourceMappingURL=index.js.map

package/dist/core/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,iBAAiB;AACjB,mDAA2F;AAAlF,+GAAA,aAAa,OAAA;AAEtB,sBAAsB;AACtB,2CAqBsB;AApBpB,oBAAoB;AACpB,iHAAA,mBAAmB,OAAA;AACnB,mHAAA,qBAAqB,OAAA;AACrB,gHAAA,kBAAkB,OAAA;AAClB,+GAAA,iBAAiB,OAAA;AACjB,uHAAA,yBAAyB,OAAA;AACzB,oHAAA,sBAAsB,OAAA;AACtB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AACb,sHAAA,wBAAwB,OAAA;AACxB,2HAAA,6BAA6B,OAAA;AAC7B,0HAAA,4BAA4B,OAAA;AAC5B,sHAAA,wBAAwB,OAAA;AACxB,oBAAoB;AACpB,0HAAA,4BAA4B,OAAA;AAC5B,qHAAA,uBAAuB,OAAA;AACvB,iHAAA,mBAAmB,OAAA;AACnB,yHAAA,2BAA2B,OAAA;AAC3B,qHAAA,uBAAuB,OAAA;AAGzB,mBAAmB;AACnB,uDAO4B;AAH1B,yHAAA,qBAAqB,OAAA;AAErB,0HAAA,sBAAsB,OAAA;AAGxB,kBAAkB;AAClB,qDAA2F;AAAlF,wGAAA,KAAK,OAAA;AAAiB,iHAAA,cAAc,OAAA;AAAE,mHAAA,gBAAgB,OAAA"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types';
+export * from './constants';
+export * from './container';
+export * from './registry';
+export * from './discovery';
+export * from './lifecycle';
+export * from './router/router';
+export * from './application';
+export * from './decorators';
+export * from './exceptions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core exports
+__exportStar(require("./types"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./container"), exports);
+__exportStar(require("./registry"), exports);
+__exportStar(require("./discovery"), exports);
+__exportStar(require("./lifecycle"), exports);
+__exportStar(require("./router/router"), exports);
+__exportStar(require("./application"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./exceptions"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B"}

package/dist/core/lifecycle/event-bus.d.ts

@@ -0,0 +1,96 @@
+import { Constructor } from '../types';
+/**
+ * Event payload types for built-in lifecycle events
+ */
+export interface EventPayload {
+    'app:discovery': {
+        files: string[];
+    };
+    'app:providers': {
+        count: number;
+    };
+    'provider:init': {
+        provider: Constructor;
+        name: string;
+        priority: number;
+    };
+    'app:routes': {
+        count: number;
+    };
+    'app:bootstrap': {
+        providerCount: number;
+    };
+    'app:listen': {
+        address: string;
+        port: number;
+    };
+    'app:shutdown': {
+        signal?: string;
+    };
+    'provider:destroy': {
+        provider: Constructor;
+        name: string;
+    };
+    'app:destroy': {
+        uptime: number;
+    };
+}
+export type LifecycleEvent = keyof EventPayload;
+type Listener<E extends LifecycleEvent> = (payload: EventPayload[E]) => void | Promise<void>;
+/**
+ * EventBus - Central event system for lifecycle and custom events
+ *
+ * Provides a flexible pub/sub mechanism that works alongside
+ * the interface-based lifecycle hooks.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MonitoringService {
+ *   constructor(private events: EventBus) {
+ *     events.on('app:listen', ({ address }) => {
+ *       console.log(`Server started at ${address}`);
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare class EventBus {
+    private listeners;
+    private onceListeners;
+    /**
+     * Subscribe to an event
+     * @returns Unsubscribe function
+     */
+    on<E extends LifecycleEvent>(event: E, listener: Listener<E>): () => void;
+    on<T = unknown>(event: string, listener: (payload: T) => void | Promise<void>): () => void;
+    /**
+     * Subscribe to an event once
+     */
+    once<E extends LifecycleEvent>(event: E, listener: Listener<E>): void;
+    once<T = unknown>(event: string, listener: (payload: T) => void | Promise<void>): void;
+    /**
+     * Emit an event to all subscribers
+     */
+    emit<E extends LifecycleEvent>(event: E, payload: EventPayload[E]): Promise<void>;
+    emit<T = unknown>(event: string, payload: T): Promise<void>;
+    /**
+     * Wait for an event (Promise-based)
+     */
+    waitFor<E extends LifecycleEvent>(event: E): Promise<EventPayload[E]>;
+    waitFor<T = unknown>(event: string): Promise<T>;
+    /**
+     * Remove all listeners for an event
+     */
+    off(event: string): void;
+    /**
+     * Remove all listeners
+     */
+    clear(): void;
+    /**
+     * Get listener count for an event
+     */
+    listenerCount(event: string): number;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map