@carno.js/core 1.1.1 → 1.2.0

package/src/exceptions/HttpException.ts

@@ -1,99 +1,99 @@
-/**
- * Base HTTP Exception class.
- * Throw this from handlers to return custom HTTP error responses.
- */
-export class HttpException extends Error {
-    constructor(
-        public readonly statusCode: number,
-        message: string,
-        public readonly errors?: any[]
-    ) {
-        super(message);
-        this.name = 'HttpException';
-    }
-
-    /**
-     * Convert exception to Response.
-     */
-    toResponse(): Response {
-        const body = {
-            statusCode: this.statusCode,
-            message: this.message,
-            ...(this.errors && { errors: this.errors })
-        };
-
-        return Response.json(body, { status: this.statusCode });
-    }
-}
-
-// Common HTTP Exceptions
-
-export class BadRequestException extends HttpException {
-    constructor(message: string = 'Bad Request', errors?: any[]) {
-        super(400, message, errors);
-        this.name = 'BadRequestException';
-    }
-}
-
-export class UnauthorizedException extends HttpException {
-    constructor(message: string = 'Unauthorized') {
-        super(401, message);
-        this.name = 'UnauthorizedException';
-    }
-}
-
-export class ForbiddenException extends HttpException {
-    constructor(message: string = 'Forbidden') {
-        super(403, message);
-        this.name = 'ForbiddenException';
-    }
-}
-
-export class NotFoundException extends HttpException {
-    constructor(message: string = 'Not Found') {
-        super(404, message);
-        this.name = 'NotFoundException';
-    }
-}
-
-export class MethodNotAllowedException extends HttpException {
-    constructor(message: string = 'Method Not Allowed') {
-        super(405, message);
-        this.name = 'MethodNotAllowedException';
-    }
-}
-
-export class ConflictException extends HttpException {
-    constructor(message: string = 'Conflict') {
-        super(409, message);
-        this.name = 'ConflictException';
-    }
-}
-
-export class UnprocessableEntityException extends HttpException {
-    constructor(message: string = 'Unprocessable Entity', errors?: any[]) {
-        super(422, message, errors);
-        this.name = 'UnprocessableEntityException';
-    }
-}
-
-export class TooManyRequestsException extends HttpException {
-    constructor(message: string = 'Too Many Requests') {
-        super(429, message);
-        this.name = 'TooManyRequestsException';
-    }
-}
-
-export class InternalServerErrorException extends HttpException {
-    constructor(message: string = 'Internal Server Error') {
-        super(500, message);
-        this.name = 'InternalServerErrorException';
-    }
-}
-
-export class ServiceUnavailableException extends HttpException {
-    constructor(message: string = 'Service Unavailable') {
-        super(503, message);
-        this.name = 'ServiceUnavailableException';
-    }
-}
+/**
+ * Base HTTP Exception class.
+ * Throw this from handlers to return custom HTTP error responses.
+ */
+export class HttpException extends Error {
+    constructor(
+        public readonly statusCode: number,
+        message: string,
+        public readonly errors?: any[]
+    ) {
+        super(message);
+        this.name = 'HttpException';
+    }
+
+    /**
+     * Convert exception to Response.
+     */
+    toResponse(): Response {
+        const body = {
+            statusCode: this.statusCode,
+            message: this.message,
+            ...(this.errors && { errors: this.errors })
+        };
+
+        return Response.json(body, { status: this.statusCode });
+    }
+}
+
+// Common HTTP Exceptions
+
+export class BadRequestException extends HttpException {
+    constructor(message: string = 'Bad Request', errors?: any[]) {
+        super(400, message, errors);
+        this.name = 'BadRequestException';
+    }
+}
+
+export class UnauthorizedException extends HttpException {
+    constructor(message: string = 'Unauthorized') {
+        super(401, message);
+        this.name = 'UnauthorizedException';
+    }
+}
+
+export class ForbiddenException extends HttpException {
+    constructor(message: string = 'Forbidden') {
+        super(403, message);
+        this.name = 'ForbiddenException';
+    }
+}
+
+export class NotFoundException extends HttpException {
+    constructor(message: string = 'Not Found') {
+        super(404, message);
+        this.name = 'NotFoundException';
+    }
+}
+
+export class MethodNotAllowedException extends HttpException {
+    constructor(message: string = 'Method Not Allowed') {
+        super(405, message);
+        this.name = 'MethodNotAllowedException';
+    }
+}
+
+export class ConflictException extends HttpException {
+    constructor(message: string = 'Conflict') {
+        super(409, message);
+        this.name = 'ConflictException';
+    }
+}
+
+export class UnprocessableEntityException extends HttpException {
+    constructor(message: string = 'Unprocessable Entity', errors?: any[]) {
+        super(422, message, errors);
+        this.name = 'UnprocessableEntityException';
+    }
+}
+
+export class TooManyRequestsException extends HttpException {
+    constructor(message: string = 'Too Many Requests') {
+        super(429, message);
+        this.name = 'TooManyRequestsException';
+    }
+}
+
+export class InternalServerErrorException extends HttpException {
+    constructor(message: string = 'Internal Server Error') {
+        super(500, message);
+        this.name = 'InternalServerErrorException';
+    }
+}
+
+export class ServiceUnavailableException extends HttpException {
+    constructor(message: string = 'Service Unavailable') {
+        super(503, message);
+        this.name = 'ServiceUnavailableException';
+    }
+}

package/src/index.ts

@@ -1,95 +1,99 @@
-/**
- * Carno - Ultra-Fast HTTP Framework
- * 
- * Design principles:
- * 1. ZERO abstraction at runtime - everything compiled at startup
- * 2. Direct Bun.serve() with native routes
- * 3. JIT compiled handlers with AOT async detection
- * 4. No intermediate layers in hot path
- * 5. Radix tree router for dynamic routes
- */
-
-// Import reflect-metadata globally for decorator support
-import 'reflect-metadata';
-
-// Application
-export { Carno } from './Carno';
-export type { MiddlewareHandler, CarnoConfig } from './Carno';
-
-// Context
-export { Context } from './context/Context';
-
-// Decorators - Controller
-export { Controller } from './decorators/Controller';
-export type { ControllerOptions } from './metadata';
-
-// Decorators - HTTP Methods
-export { Get, Post, Put, Delete, Patch, Head, Options } from './decorators/methods';
-
-// Decorators - Parameters
-export { Param, Query, Body, Header, Req, Ctx, Locals } from './decorators/params';
-
-// Decorators - Middleware
-export { Use, Use as Middleware } from './decorators/Middleware';
-
-// Middleware Interface
-export type { CarnoMiddleware, CarnoClosure } from './middleware/CarnoMiddleware';
-
-// Decorators - DI
-export { Service } from './decorators/Service';
-export { Inject } from './decorators/Inject';
-
-// Container
-export { Container, Scope } from './container/Container';
-export type { Token, ProviderConfig } from './container/Container';
-
-// Router
-export { RadixRouter } from './router/RadixRouter';
-export type { RouteMatch } from './router/RadixRouter';
-
-// CORS
-export { CorsHandler } from './cors/CorsHandler';
-export type { CorsConfig, CorsOrigin } from './cors/CorsHandler';
-
-// Validation
-export type { ValidatorAdapter, ValidationResult, ValidationError, ValidationConfig } from './validation/ValidatorAdapter';
-export { Schema, getSchema, VALIDATION_SCHEMA } from './validation/ValidatorAdapter';
-export { ZodAdapter, ValidationException } from './validation/ZodAdapter';
-export { ValibotAdapter } from './validation/ValibotAdapter';
-
-// Exceptions
-export {
-    HttpException,
-    BadRequestException,
-    UnauthorizedException,
-    ForbiddenException,
-    NotFoundException,
-    MethodNotAllowedException,
-    ConflictException,
-    UnprocessableEntityException,
-    TooManyRequestsException,
-    InternalServerErrorException,
-    ServiceUnavailableException
-} from './exceptions/HttpException';
-
-// Lifecycle Events
-export {
-    EventType,
-    OnApplicationInit,
-    OnApplicationBoot,
-    OnApplicationShutdown
-} from './events/Lifecycle';
-
-// Cache
-export { CacheService } from './cache/CacheService';
-export { MemoryDriver } from './cache/MemoryDriver';
-export { RedisDriver } from './cache/RedisDriver';
-export type { RedisConfig } from './cache/RedisDriver';
-export type { CacheDriver, CacheConfig } from './cache/CacheDriver';
-
-// Testing
-export { createTestHarness, withTestApp } from './testing/TestHarness';
-export type { TestHarness, TestOptions } from './testing/TestHarness';
-
-// Utils
-export { Metadata, isObject, isString } from './utils/Metadata';
+/**
+ * Carno - Ultra-Fast HTTP Framework
+ * 
+ * Design principles:
+ * 1. ZERO abstraction at runtime - everything compiled at startup
+ * 2. Direct Bun.serve() with native routes
+ * 3. JIT compiled handlers with AOT async detection
+ * 4. No intermediate layers in hot path
+ * 5. Radix tree router for dynamic routes
+ */
+
+// Import reflect-metadata globally for decorator support
+import 'reflect-metadata';
+
+// Application
+export { Carno } from './Carno';
+export type { MiddlewareHandler, MiddlewareClass, MiddlewareEntry, CarnoConfig } from './Carno';
+
+// Context
+export { Context } from './context/Context';
+
+// Decorators - Controller
+export { Controller } from './decorators/Controller';
+export type { ControllerOptions } from './metadata';
+
+// Decorators - HTTP Methods
+export { Get, Post, Put, Delete, Patch, Head, Options } from './decorators/methods';
+
+// Decorators - Parameters
+export { Param, Query, Body, Header, Req, Ctx, Locals } from './decorators/params';
+
+// Decorators - Middleware
+export { Use, Use as Middleware } from './decorators/Middleware';
+
+// Middleware Interface
+export type { CarnoMiddleware, CarnoClosure } from './middleware/CarnoMiddleware';
+
+// Decorators - DI
+export { Service } from './decorators/Service';
+export { Inject } from './decorators/Inject';
+
+// Container
+export { Container, Scope } from './container/Container';
+export type { Token, ProviderConfig } from './container/Container';
+
+// Router
+export { RadixRouter } from './router/RadixRouter';
+export type { RouteMatch } from './router/RadixRouter';
+
+// CORS
+export { CorsHandler } from './cors/CorsHandler';
+export type { CorsConfig, CorsOrigin } from './cors/CorsHandler';
+
+// Compression
+export { CompressionMiddleware } from './compression/CompressionMiddleware';
+export type { CompressionConfig } from './compression/CompressionMiddleware';
+
+// Validation
+export type { ValidatorAdapter, ValidationResult, ValidationError, ValidationConfig } from './validation/ValidatorAdapter';
+export { Schema, getSchema, VALIDATION_SCHEMA } from './validation/ValidatorAdapter';
+export { ZodAdapter, ValidationException } from './validation/ZodAdapter';
+export { ValibotAdapter } from './validation/ValibotAdapter';
+
+// Exceptions
+export {
+    HttpException,
+    BadRequestException,
+    UnauthorizedException,
+    ForbiddenException,
+    NotFoundException,
+    MethodNotAllowedException,
+    ConflictException,
+    UnprocessableEntityException,
+    TooManyRequestsException,
+    InternalServerErrorException,
+    ServiceUnavailableException
+} from './exceptions/HttpException';
+
+// Lifecycle Events
+export {
+    EventType,
+    OnApplicationInit,
+    OnApplicationBoot,
+    OnApplicationShutdown
+} from './events/Lifecycle';
+
+// Cache
+export { CacheService } from './cache/CacheService';
+export { MemoryDriver } from './cache/MemoryDriver';
+export { RedisDriver } from './cache/RedisDriver';
+export type { RedisConfig } from './cache/RedisDriver';
+export type { CacheDriver, CacheConfig } from './cache/CacheDriver';
+
+// Testing
+export { createTestHarness, withTestApp } from './testing/TestHarness';
+export type { TestHarness, TestOptions } from './testing/TestHarness';
+
+// Utils
+export { Metadata, isObject, isString } from './utils/Metadata';

package/src/metadata.ts

@@ -1,46 +1,46 @@
-import { Scope } from './container/Container';
-
-/**
- * Controller options for the @Controller decorator.
- */
-export interface ControllerOptions {
-    path?: string;
-    scope?: Scope;
-    children?: any[];
-}
-
-/**
- * Controller metadata stored on controller classes.
- */
-export interface ControllerMeta {
-    path: string;
-    scope?: Scope;
-    children?: any[];
-}
-
-/**
- * Route metadata stored on controllers.
- */
-export interface RouteInfo {
-    method: 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
-    path: string;
-    handlerName: string;
-}
-
-/**
- * Middleware metadata.
- */
-export interface MiddlewareInfo {
-    handler: Function;
-    target?: string;
-}
-
-/**
- * Metadata keys.
- */
-export const CONTROLLER_META = Symbol('turbo:controller');
-export const ROUTES_META = Symbol('turbo:routes');
-export const PARAMS_META = Symbol('turbo:params');
-export const MIDDLEWARE_META = Symbol('turbo:middleware');
-export const SERVICE_META = Symbol('turbo:service');
-export const INJECT_META = Symbol('turbo:inject');
+import { Scope } from './container/Container';
+
+/**
+ * Controller options for the @Controller decorator.
+ */
+export interface ControllerOptions {
+    path?: string;
+    scope?: Scope;
+    children?: any[];
+}
+
+/**
+ * Controller metadata stored on controller classes.
+ */
+export interface ControllerMeta {
+    path: string;
+    scope?: Scope;
+    children?: any[];
+}
+
+/**
+ * Route metadata stored on controllers.
+ */
+export interface RouteInfo {
+    method: 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
+    path: string;
+    handlerName: string;
+}
+
+/**
+ * Middleware metadata.
+ */
+export interface MiddlewareInfo {
+    handler: Function;
+    target?: string;
+}
+
+/**
+ * Metadata keys.
+ */
+export const CONTROLLER_META = Symbol('turbo:controller');
+export const ROUTES_META = Symbol('turbo:routes');
+export const PARAMS_META = Symbol('turbo:params');
+export const MIDDLEWARE_META = Symbol('turbo:middleware');
+export const SERVICE_META = Symbol('turbo:service');
+export const INJECT_META = Symbol('turbo:inject');

package/src/middleware/CarnoMiddleware.ts

@@ -1,14 +1,20 @@
-import type { Context } from '../context/Context';
-
-/**
- * Closure function to call the next middleware in the chain.
- */
-export type CarnoClosure = () => void | Promise<void>;
-
-/**
- * Interface for onion-style middleware.
- * Middleware must call next() to continue the chain.
- */
-export interface CarnoMiddleware {
-  handle(ctx: Context, next: CarnoClosure): void | Promise<void>;
-}
+import type { Context } from '../context/Context';
+
+/**
+ * Closure function to call the next middleware in the chain.
+ * Returns the Response produced by the next layer, allowing
+ * middlewares to inspect or transform it.
+ */
+export type CarnoClosure = () => Promise<Response>;
+
+/**
+ * Interface for onion-style middleware.
+ * Middleware must call next() to continue the chain.
+ *
+ * Returning a Response from handle() replaces the response
+ * produced by the downstream chain (useful for response transformers
+ * like compression).
+ */
+export interface CarnoMiddleware {
+  handle(ctx: Context, next: CarnoClosure): void | Response | Promise<void | Response>;
+}