@riktajs/core 0.4.5 → 0.4.7

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

@@ -3,30 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GlobalExceptionFilter = void 0;
 exports.createExceptionHandler = createExceptionHandler;
 const http_exception_1 = require("./http-exception");
-/**
- * Global Exception Filter
- *
- * Default exception handler that catches all errors and returns
- * a standardized JSON response.
- *
- * Features:
- * - Handles HttpException with proper status codes
- * - Handles Fastify validation errors
- * - Handles unknown errors as 500 Internal Server Error
- * - Includes stack traces in development mode
- *
- * @example
- * ```typescript
- * // The filter is automatically registered by Rikta
- * // But you can customize behavior via options:
- * const app = await Rikta.create({
- *   exceptionFilter: {
- *     includeStack: process.env.NODE_ENV !== 'production',
- *     logErrors: true
- *   }
- * });
- * ```
- */
 class GlobalExceptionFilter {
     includeStack;
     logErrors;
@@ -34,26 +10,16 @@ class GlobalExceptionFilter {
         this.includeStack = options.includeStack ?? process.env.NODE_ENV !== 'production';
         this.logErrors = options.logErrors ?? true;
     }
-    /**
-     * Handle any exception and send standardized response
-     */
     catch(exception, context) {
         const { request, reply, path, method } = context;
         const requestId = request.id ?? undefined;
-        // Log the error
         if (this.logErrors) {
             this.logError(exception, method, path, requestId);
         }
-        // Build error response
         const response = this.buildResponse(exception, path, requestId);
-        // Send response
         reply.status(response.statusCode).send(response);
     }
-    /**
-     * Build standardized error response
-     */
     buildResponse(exception, path, requestId) {
-        // Handle HttpException
         if (exception instanceof http_exception_1.HttpException) {
             const httpResponse = exception.getResponse();
             return {
@@ -68,7 +34,6 @@ class GlobalExceptionFilter {
                 ...(this.includeStack ? { stack: exception.stack } : {}),
             };
         }
-        // Handle Fastify validation errors
         if (this.isFastifyValidationError(exception)) {
             return {
                 statusCode: 400,
@@ -81,7 +46,6 @@ class GlobalExceptionFilter {
                 ...(this.includeStack && { stack: exception.stack }),
             };
         }
-        // Handle Fastify errors with statusCode
         if (this.isFastifyError(exception)) {
             const fastifyError = exception;
             return {
@@ -94,7 +58,6 @@ class GlobalExceptionFilter {
                 ...(this.includeStack && { stack: exception.stack }),
             };
         }
-        // Handle unknown errors as 500
         return {
             statusCode: 500,
             message: this.includeStack ? exception.message : 'Internal Server Error',
@@ -105,21 +68,12 @@ class GlobalExceptionFilter {
             ...(this.includeStack && { stack: exception.stack }),
         };
     }
-    /**
-     * Check if error is a Fastify validation error
-     */
     isFastifyValidationError(error) {
         return 'validation' in error && Array.isArray(error.validation);
     }
-    /**
-     * Check if error is a Fastify error with statusCode
-     */
     isFastifyError(error) {
         return 'statusCode' in error;
     }
-    /**
-     * Log error to console
-     */
     logError(exception, method, path, requestId) {
         const timestamp = new Date().toISOString();
         const status = exception instanceof http_exception_1.HttpException
@@ -128,16 +82,12 @@ class GlobalExceptionFilter {
         const prefix = status >= 500 ? '❌' : '⚠️';
         const reqIdStr = requestId ? ` [${requestId}]` : '';
         console.error(`${prefix} [${timestamp}]${reqIdStr} ${method} ${path} - ${status} ${exception.message}`);
-        // Log stack trace for 5xx errors in development
         if (status >= 500 && this.includeStack && exception.stack) {
             console.error(exception.stack);
         }
     }
 }
 exports.GlobalExceptionFilter = GlobalExceptionFilter;
-/**
- * Create exception handler function for Fastify
- */
 function createExceptionHandler(filter, customFilters = new Map()) {
     return async (error, request, reply) => {
         const context = {
@@ -148,14 +98,11 @@ function createExceptionHandler(filter, customFilters = new Map()) {
             method: request.method,
             requestId: request.id,
         };
-        // Try to find a custom filter for this exception type
         for (const [ExceptionType, customFilter] of customFilters) {
             if (error instanceof ExceptionType) {
                 return customFilter.catch(error, context);
             }
         }
-        // Use global filter
         return filter.catch(error, context);
     };
 }
-//# sourceMappingURL=exception-filter.js.map

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

@@ -1,212 +1,55 @@
 import { HttpException, HttpExceptionBody } from './http-exception';
-/**
- * 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' }
- * });
- * ```
- */
 export declare class BadRequestException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 401 Unauthorized
- *
- * Authentication is required and has failed or not been provided.
- *
- * @example
- * ```typescript
- * throw new UnauthorizedException('Invalid credentials');
- * throw new UnauthorizedException('Token expired');
- * ```
- */
 export declare class UnauthorizedException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 403 Forbidden
- *
- * The server understood the request but refuses to authorize it.
- *
- * @example
- * ```typescript
- * throw new ForbiddenException('Access denied');
- * throw new ForbiddenException('Insufficient permissions');
- * ```
- */
 export declare class ForbiddenException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 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`);
- * ```
- */
 export declare class NotFoundException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 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');
- * ```
- */
 export declare class MethodNotAllowedException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 406 Not Acceptable
- *
- * The requested resource is not capable of generating content acceptable
- * according to the Accept headers sent in the request.
- */
 export declare class NotAcceptableException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 408 Request Timeout
- *
- * The server timed out waiting for the request.
- */
 export declare class RequestTimeoutException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 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');
- * ```
- */
 export declare class ConflictException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 410 Gone
- *
- * The resource is no longer available and will not be available again.
- */
 export declare class GoneException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 413 Payload Too Large
- *
- * The request entity is larger than limits defined by the server.
- */
 export declare class PayloadTooLargeException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 415 Unsupported Media Type
- *
- * The media format of the requested data is not supported by the server.
- */
 export declare class UnsupportedMediaTypeException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 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' }
- *   ]
- * });
- * ```
- */
 export declare class UnprocessableEntityException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 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.');
- * ```
- */
 export declare class TooManyRequestsException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 500 Internal Server Error
- *
- * A generic server error occurred.
- *
- * @example
- * ```typescript
- * throw new InternalServerErrorException('An unexpected error occurred');
- * ```
- */
 export declare class InternalServerErrorException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 501 Not Implemented
- *
- * The server does not support the functionality required to fulfill the request.
- */
 export declare class NotImplementedException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 502 Bad Gateway
- *
- * The server received an invalid response from an upstream server.
- */
 export declare class BadGatewayException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 503 Service Unavailable
- *
- * The server is not ready to handle the request.
- *
- * @example
- * ```typescript
- * throw new ServiceUnavailableException('Service is under maintenance');
- * ```
- */
 export declare class ServiceUnavailableException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-/**
- * 504 Gateway Timeout
- *
- * The server did not receive a timely response from an upstream server.
- */
 export declare class GatewayTimeoutException extends HttpException {
     constructor(response?: string | HttpExceptionBody);
 }
-//# sourceMappingURL=exceptions.d.ts.map

package/dist/core/exceptions/exceptions.js

@@ -2,274 +2,111 @@
 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/http-exception.d.ts

@@ -1,79 +1,24 @@
-/**
- * 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