@riktajs/core 0.1.0

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

@@ -0,0 +1,134 @@
+import type { FastifyRequest, FastifyReply, FastifyError } from 'fastify';
+/**
+ * Exception context passed to filters
+ */
+export interface ExceptionContext {
+    /** The caught exception */
+    exception: Error;
+    /** Fastify request object */
+    request: FastifyRequest;
+    /** Fastify reply object */
+    reply: FastifyReply;
+    /** Request path */
+    path: string;
+    /** HTTP method */
+    method: string;
+    /** Request ID (if available) */
+    requestId?: string;
+}
+/**
+ * Exception Filter Interface
+ *
+ * Implement this interface to create custom exception handlers.
+ * Filters can catch specific exception types or handle all exceptions.
+ *
+ * @example
+ * ```typescript
+ * @Catch(ValidationException)
+ * class ValidationExceptionFilter implements ExceptionFilter {
+ *   catch(exception: ValidationException, context: ExceptionContext) {
+ *     const { reply } = context;
+ *     reply.status(422).send({
+ *       statusCode: 422,
+ *       errors: exception.errors,
+ *       timestamp: new Date().toISOString()
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export interface ExceptionFilter<T extends Error = Error> {
+    /**
+     * Handle the caught exception
+     *
+     * @param exception - The caught exception
+     * @param context - Exception context with request/reply
+     */
+    catch(exception: T, context: ExceptionContext): void | Promise<void>;
+}
+/**
+ * Standard error response format
+ */
+export interface ErrorResponse {
+    /** HTTP status code */
+    statusCode: number;
+    /** Error message */
+    message: string;
+    /** Error type/name (e.g., "Bad Request", "Not Found") */
+    error: string;
+    /** ISO timestamp when the error occurred */
+    timestamp: string;
+    /** Request path that caused the error */
+    path: string;
+    /** Request ID for tracing (optional) */
+    requestId?: string;
+    /** Additional error details (optional) */
+    details?: unknown;
+    /** Application-specific error code (optional) */
+    code?: string;
+    /** Stack trace (only in development mode) */
+    stack?: string;
+}
+/**
+ * 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
+ *   }
+ * });
+ * ```
+ */
+export declare class GlobalExceptionFilter implements ExceptionFilter {
+    private readonly includeStack;
+    private readonly logErrors;
+    constructor(options?: GlobalExceptionFilterOptions);
+    /**
+     * Handle any exception and send standardized response
+     */
+    catch(exception: Error, context: ExceptionContext): void;
+    /**
+     * Build standardized error response
+     */
+    private buildResponse;
+    /**
+     * Check if error is a Fastify validation error
+     */
+    private isFastifyValidationError;
+    /**
+     * Check if error is a Fastify error with statusCode
+     */
+    private isFastifyError;
+    /**
+     * Log error to console
+     */
+    private logError;
+}
+/**
+ * Options for GlobalExceptionFilter
+ */
+export interface GlobalExceptionFilterOptions {
+    /** Include stack trace in response (default: true in development) */
+    includeStack?: boolean;
+    /** Log errors to console (default: true) */
+    logErrors?: boolean;
+}
+/**
+ * Create exception handler function for Fastify
+ */
+export declare function createExceptionHandler(filter: ExceptionFilter, customFilters?: Map<Function, ExceptionFilter>): (error: FastifyError | Error, request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+//# sourceMappingURL=exception-filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/exception-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,SAAS,EAAE,KAAK,CAAC;IAEjB,6BAA6B;IAC7B,OAAO,EAAE,cAAc,CAAC;IAExB,2BAA2B;IAC3B,KAAK,EAAE,YAAY,CAAC;IAEpB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IACtD;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IAEd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,OAAO,GAAE,4BAAiC;IAKtD;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAgBxD;;OAEG;IACH,OAAO,CAAC,aAAa;IA6DrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAuBjB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,aAAa,GAAE,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAa,IAGvD,OAAO,YAAY,GAAG,KAAK,EAC3B,SAAS,cAAc,EACvB,OAAO,YAAY,mBAqBtB"}

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

@@ -0,0 +1,161 @@
+"use strict";
+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;
+    constructor(options = {}) {
+        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 {
+                statusCode: httpResponse.statusCode,
+                message: httpResponse.message,
+                error: httpResponse.error,
+                timestamp: httpResponse.timestamp,
+                path,
+                ...(requestId ? { requestId } : {}),
+                ...(httpResponse.details ? { details: httpResponse.details } : {}),
+                ...(httpResponse.code ? { code: httpResponse.code } : {}),
+                ...(this.includeStack ? { stack: exception.stack } : {}),
+            };
+        }
+        // Handle Fastify validation errors
+        if (this.isFastifyValidationError(exception)) {
+            return {
+                statusCode: 400,
+                message: 'Validation failed',
+                error: 'Bad Request',
+                timestamp: new Date().toISOString(),
+                path,
+                ...(requestId && { requestId }),
+                details: exception.validation,
+                ...(this.includeStack && { stack: exception.stack }),
+            };
+        }
+        // Handle Fastify errors with statusCode
+        if (this.isFastifyError(exception)) {
+            const fastifyError = exception;
+            return {
+                statusCode: fastifyError.statusCode ?? 500,
+                message: fastifyError.message,
+                error: fastifyError.code ?? 'Error',
+                timestamp: new Date().toISOString(),
+                path,
+                ...(requestId && { requestId }),
+                ...(this.includeStack && { stack: exception.stack }),
+            };
+        }
+        // Handle unknown errors as 500
+        return {
+            statusCode: 500,
+            message: this.includeStack ? exception.message : 'Internal Server Error',
+            error: 'Internal Server Error',
+            timestamp: new Date().toISOString(),
+            path,
+            ...(requestId && { requestId }),
+            ...(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
+            ? exception.getStatus()
+            : 500;
+        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 = {
+            exception: error,
+            request,
+            reply,
+            path: request.url,
+            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/exception-filter.js.map

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

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

@@ -0,0 +1,212 @@
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMpE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,QAAQ,GAAE,MAAM,GAAG,iBAAiC;CAGjE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,QAAQ,GAAE,MAAM,GAAG,iBAAkC;CAGlE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,QAAQ,GAAE,MAAM,GAAG,iBAA+B;CAG/D;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,QAAQ,GAAE,MAAM,GAAG,iBAA+B;CAG/D;AAED;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,QAAQ,GAAE,MAAM,GAAG,iBAAwC;CAGxE;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,QAAQ,GAAE,MAAM,GAAG,iBAAoC;CAGpE;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,QAAQ,GAAE,MAAM,GAAG,iBAAqC;CAGrE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,QAAQ,GAAE,MAAM,GAAG,iBAA8B;CAG9D;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAClC,QAAQ,GAAE,MAAM,GAAG,iBAA0B;CAG1D;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,QAAQ,GAAE,MAAM,GAAG,iBAAuC;CAGvE;AAED;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,aAAa;gBAClD,QAAQ,GAAE,MAAM,GAAG,iBAA4C;CAG5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,4BAA6B,SAAQ,aAAa;gBACjD,QAAQ,GAAE,MAAM,GAAG,iBAA0C;CAG1E;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,QAAQ,GAAE,MAAM,GAAG,iBAAuC;CAGvE;AAMD;;;;;;;;;GASG;AACH,qBAAa,4BAA6B,SAAQ,aAAa;gBACjD,QAAQ,GAAE,MAAM,GAAG,iBAA2C;CAG3E;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,QAAQ,GAAE,MAAM,GAAG,iBAAqC;CAGrE;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,QAAQ,GAAE,MAAM,GAAG,iBAAiC;CAGjE;AAED;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,QAAQ,GAAE,MAAM,GAAG,iBAAyC;CAGzE;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,QAAQ,GAAE,MAAM,GAAG,iBAAqC;CAGrE"}