@carno.js/core 1.1.1 → 1.1.2

package/src/decorators/params.ts

@@ -1,47 +1,47 @@
-import { PARAMS_META } from '../metadata';
-
-export type ParamType = 'param' | 'query' | 'body' | 'header' | 'req' | 'ctx' | 'locals';
-
-export interface ParamMetadata {
-    type: ParamType;
-    key?: string;
-    index: number;
-}
-
-function createParamDecorator(type: ParamType, key?: string) {
-    return function (target: any, propertyKey: string, index: number) {
-        const params: ParamMetadata[] = Reflect.getMetadata(PARAMS_META, target.constructor, propertyKey) || [];
-
-        params.push({ type, key, index });
-
-        Reflect.defineMetadata(PARAMS_META, params, target.constructor, propertyKey);
-    };
-}
-
-export function Param(key?: string): ParameterDecorator {
-    return createParamDecorator('param', key) as ParameterDecorator;
-}
-
-export function Query(key?: string): ParameterDecorator {
-    return createParamDecorator('query', key) as ParameterDecorator;
-}
-
-export function Body(key?: string): ParameterDecorator {
-    return createParamDecorator('body', key) as ParameterDecorator;
-}
-
-export function Header(key?: string): ParameterDecorator {
-    return createParamDecorator('header', key) as ParameterDecorator;
-}
-
-export function Req(): ParameterDecorator {
-    return createParamDecorator('req') as ParameterDecorator;
-}
-
-export function Ctx(): ParameterDecorator {
-    return createParamDecorator('ctx') as ParameterDecorator;
-}
-
-export function Locals(key?: string): ParameterDecorator {
-    return createParamDecorator('locals', key) as ParameterDecorator;
-}
+import { PARAMS_META } from '../metadata';
+
+export type ParamType = 'param' | 'query' | 'body' | 'header' | 'req' | 'ctx' | 'locals';
+
+export interface ParamMetadata {
+    type: ParamType;
+    key?: string;
+    index: number;
+}
+
+function createParamDecorator(type: ParamType, key?: string) {
+    return function (target: any, propertyKey: string, index: number) {
+        const params: ParamMetadata[] = Reflect.getMetadata(PARAMS_META, target.constructor, propertyKey) || [];
+
+        params.push({ type, key, index });
+
+        Reflect.defineMetadata(PARAMS_META, params, target.constructor, propertyKey);
+    };
+}
+
+export function Param(key?: string): ParameterDecorator {
+    return createParamDecorator('param', key) as ParameterDecorator;
+}
+
+export function Query(key?: string): ParameterDecorator {
+    return createParamDecorator('query', key) as ParameterDecorator;
+}
+
+export function Body(key?: string): ParameterDecorator {
+    return createParamDecorator('body', key) as ParameterDecorator;
+}
+
+export function Header(key?: string): ParameterDecorator {
+    return createParamDecorator('header', key) as ParameterDecorator;
+}
+
+export function Req(): ParameterDecorator {
+    return createParamDecorator('req') as ParameterDecorator;
+}
+
+export function Ctx(): ParameterDecorator {
+    return createParamDecorator('ctx') as ParameterDecorator;
+}
+
+export function Locals(key?: string): ParameterDecorator {
+    return createParamDecorator('locals', key) as ParameterDecorator;
+}

package/src/events/Lifecycle.ts

@@ -1,97 +1,97 @@
-/**
- * Lifecycle Event Types.
- */
-export enum EventType {
-    /** Called when DI container initializes, before server starts */
-    INIT = 'onInit',
-    /** Called right after application is fully bootstrapped */
-    BOOT = 'onBoot',
-    /** Called when application receives SIGTERM/SIGINT */
-    SHUTDOWN = 'onShutdown'
-}
-
-/**
- * Stored event handler info.
- */
-export interface EventHandler {
-    target: any;
-    methodName: string;
-    priority: number;
-}
-
-/**
- * Metadata key for storing events.
- */
-export const EVENTS_META = Symbol('turbo:events');
-
-/**
- * Event registry - stores all decorated event handlers.
- * Populated at decoration time, read at bootstrap.
- */
-const eventRegistry = new Map<EventType, EventHandler[]>();
-
-/**
- * Register an event handler (called by decorators).
- */
-export function registerEvent(type: EventType, target: any, methodName: string, priority: number = 0): void {
-    let handlers = eventRegistry.get(type);
-    if (!handlers) {
-        handlers = [];
-        eventRegistry.set(type, handlers);
-    }
-    handlers.push({ target, methodName, priority });
-}
-
-/**
- * Get all handlers for an event type, sorted by priority (descending).
- */
-export function getEventHandlers(type: EventType): EventHandler[] {
-    const handlers = eventRegistry.get(type) || [];
-    return handlers.sort((a, b) => b.priority - a.priority);
-}
-
-/**
- * Check if any handlers exist for an event type.
- */
-export function hasEventHandlers(type: EventType): boolean {
-    return (eventRegistry.get(type)?.length ?? 0) > 0;
-}
-
-/**
- * Clear all event handlers (for testing).
- */
-export function clearEventRegistry(): void {
-    eventRegistry.clear();
-}
-
-// ============ Decorators ============
-
-/**
- * Called when DI container initializes, before the server starts.
- * Use for database connections, cache warming, etc.
- */
-export function OnApplicationInit(priority: number = 0) {
-    return function (target: any, propertyKey: string) {
-        registerEvent(EventType.INIT, target.constructor, propertyKey, priority);
-    };
-}
-
-/**
- * Called right after the application is fully bootstrapped and server is ready.
- * Use for logging, health checks, etc.
- */
-export function OnApplicationBoot(priority: number = 0) {
-    return function (target: any, propertyKey: string) {
-        registerEvent(EventType.BOOT, target.constructor, propertyKey, priority);
-    };
-}
-
-/**
- * Called when application receives SIGTERM or SIGINT.
- * Use for graceful cleanup, closing connections, etc.
- */
-export function OnApplicationShutdown(priority: number = 0) {
-    return function (target: any, propertyKey: string) {
-        registerEvent(EventType.SHUTDOWN, target.constructor, propertyKey, priority);
-    };
-}
+/**
+ * Lifecycle Event Types.
+ */
+export enum EventType {
+    /** Called when DI container initializes, before server starts */
+    INIT = 'onInit',
+    /** Called right after application is fully bootstrapped */
+    BOOT = 'onBoot',
+    /** Called when application receives SIGTERM/SIGINT */
+    SHUTDOWN = 'onShutdown'
+}
+
+/**
+ * Stored event handler info.
+ */
+export interface EventHandler {
+    target: any;
+    methodName: string;
+    priority: number;
+}
+
+/**
+ * Metadata key for storing events.
+ */
+export const EVENTS_META = Symbol('turbo:events');
+
+/**
+ * Event registry - stores all decorated event handlers.
+ * Populated at decoration time, read at bootstrap.
+ */
+const eventRegistry = new Map<EventType, EventHandler[]>();
+
+/**
+ * Register an event handler (called by decorators).
+ */
+export function registerEvent(type: EventType, target: any, methodName: string, priority: number = 0): void {
+    let handlers = eventRegistry.get(type);
+    if (!handlers) {
+        handlers = [];
+        eventRegistry.set(type, handlers);
+    }
+    handlers.push({ target, methodName, priority });
+}
+
+/**
+ * Get all handlers for an event type, sorted by priority (descending).
+ */
+export function getEventHandlers(type: EventType): EventHandler[] {
+    const handlers = eventRegistry.get(type) || [];
+    return handlers.sort((a, b) => b.priority - a.priority);
+}
+
+/**
+ * Check if any handlers exist for an event type.
+ */
+export function hasEventHandlers(type: EventType): boolean {
+    return (eventRegistry.get(type)?.length ?? 0) > 0;
+}
+
+/**
+ * Clear all event handlers (for testing).
+ */
+export function clearEventRegistry(): void {
+    eventRegistry.clear();
+}
+
+// ============ Decorators ============
+
+/**
+ * Called when DI container initializes, before the server starts.
+ * Use for database connections, cache warming, etc.
+ */
+export function OnApplicationInit(priority: number = 0) {
+    return function (target: any, propertyKey: string) {
+        registerEvent(EventType.INIT, target.constructor, propertyKey, priority);
+    };
+}
+
+/**
+ * Called right after the application is fully bootstrapped and server is ready.
+ * Use for logging, health checks, etc.
+ */
+export function OnApplicationBoot(priority: number = 0) {
+    return function (target: any, propertyKey: string) {
+        registerEvent(EventType.BOOT, target.constructor, propertyKey, priority);
+    };
+}
+
+/**
+ * Called when application receives SIGTERM or SIGINT.
+ * Use for graceful cleanup, closing connections, etc.
+ */
+export function OnApplicationShutdown(priority: number = 0) {
+    return function (target: any, propertyKey: string) {
+        registerEvent(EventType.SHUTDOWN, target.constructor, propertyKey, priority);
+    };
+}

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';
+    }
+}