@carno.js/core 1.1.1 → 1.2.0

package/src/decorators/Inject.ts

@@ -1,16 +1,16 @@
-import { INJECT_META } from '../metadata';
-import type { Token } from '../container/Container';
-
-/**
- * Explicitly specifies which token to inject.
- * Useful for interfaces or when automatic detection fails.
- */
-export function Inject(token: Token): ParameterDecorator {
-    return (target, propertyKey, parameterIndex) => {
-        const existing: Map<number, Token> = Reflect.getMetadata(INJECT_META, target) || new Map();
-
-        existing.set(parameterIndex, token);
-
-        Reflect.defineMetadata(INJECT_META, existing, target);
-    };
-}
+import { INJECT_META } from '../metadata';
+import type { Token } from '../container/Container';
+
+/**
+ * Explicitly specifies which token to inject.
+ * Useful for interfaces or when automatic detection fails.
+ */
+export function Inject(token: Token): ParameterDecorator {
+    return (target, propertyKey, parameterIndex) => {
+        const existing: Map<number, Token> = Reflect.getMetadata(INJECT_META, target) || new Map();
+
+        existing.set(parameterIndex, token);
+
+        Reflect.defineMetadata(INJECT_META, existing, target);
+    };
+}

package/src/decorators/Middleware.ts

@@ -1,22 +1,22 @@
-import { MIDDLEWARE_META, type MiddlewareInfo } from '../metadata';
-
-/**
- * Middleware decorator.
- * Can be applied to controllers or individual methods.
- */
-export function Use(...middlewares: Function[]): ClassDecorator & MethodDecorator {
-    return function (target: any, propertyKey?: string) {
-        const isMethod = propertyKey !== undefined;
-        const metaTarget = isMethod ? target.constructor : target;
-        const existing: MiddlewareInfo[] = Reflect.getMetadata(MIDDLEWARE_META, metaTarget) || [];
-
-        for (const handler of middlewares) {
-            existing.push({
-                handler,
-                target: isMethod ? propertyKey : undefined
-            });
-        }
-
-        Reflect.defineMetadata(MIDDLEWARE_META, existing, metaTarget);
-    } as ClassDecorator & MethodDecorator;
-}
+import { MIDDLEWARE_META, type MiddlewareInfo } from '../metadata';
+
+/**
+ * Middleware decorator.
+ * Can be applied to controllers or individual methods.
+ */
+export function Use(...middlewares: Function[]): ClassDecorator & MethodDecorator {
+    return function (target: any, propertyKey?: string) {
+        const isMethod = propertyKey !== undefined;
+        const metaTarget = isMethod ? target.constructor : target;
+        const existing: MiddlewareInfo[] = Reflect.getMetadata(MIDDLEWARE_META, metaTarget) || [];
+
+        for (const handler of middlewares) {
+            existing.push({
+                handler,
+                target: isMethod ? propertyKey : undefined
+            });
+        }
+
+        Reflect.defineMetadata(MIDDLEWARE_META, existing, metaTarget);
+    } as ClassDecorator & MethodDecorator;
+}

package/src/decorators/Service.ts

@@ -1,18 +1,18 @@
-import { SERVICE_META } from '../metadata';
-import { Scope } from '../container/Container';
-
-export interface ServiceOptions {
-    scope?: Scope;
-}
-
-/**
- * Marks a class as an injectable service.
- * Services are singleton by default.
- */
-export function Service(options: ServiceOptions = {}): ClassDecorator {
-    return (target) => {
-        Reflect.defineMetadata(SERVICE_META, {
-            scope: options.scope ?? Scope.SINGLETON
-        }, target);
-    };
-}
+import { SERVICE_META } from '../metadata';
+import { Scope } from '../container/Container';
+
+export interface ServiceOptions {
+    scope?: Scope;
+}
+
+/**
+ * Marks a class as an injectable service.
+ * Services are singleton by default.
+ */
+export function Service(options: ServiceOptions = {}): ClassDecorator {
+    return (target) => {
+        Reflect.defineMetadata(SERVICE_META, {
+            scope: options.scope ?? Scope.SINGLETON
+        }, target);
+    };
+}

package/src/decorators/methods.ts

@@ -1,58 +1,58 @@
-import { ROUTES_META, type RouteInfo } from '../metadata';
-
-type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
-
-/**
- * Creates a method decorator for HTTP methods.
- * Supports both legacy decorators (experimentalDecorators) and TS5 stage 3 decorators.
- */
-function createMethodDecorator(method: HttpMethod) {
-    return function (path: string = ''): any {
-        return function (
-            targetOrMethod: any,
-            contextOrPropertyKey?: string | symbol | ClassMethodDecoratorContext,
-            descriptor?: PropertyDescriptor
-        ): any {
-            // TS5 Stage 3 decorators: context is ClassMethodDecoratorContext
-            if (contextOrPropertyKey && typeof contextOrPropertyKey === 'object' && 'kind' in contextOrPropertyKey) {
-                const context = contextOrPropertyKey as ClassMethodDecoratorContext;
-
-                context.addInitializer(function (this: any) {
-                    const constructor = this.constructor;
-                    const routes: RouteInfo[] = Reflect.getMetadata(ROUTES_META, constructor) || [];
-
-                    routes.push({
-                        method,
-                        path: path.startsWith('/') ? path : '/' + path,
-                        handlerName: String(context.name)
-                    });
-
-                    Reflect.defineMetadata(ROUTES_META, routes, constructor);
-                });
-
-                return targetOrMethod;
-            }
-
-            // Legacy decorators (experimentalDecorators: true)
-            const constructor = targetOrMethod.constructor;
-            const propertyKey = contextOrPropertyKey as string | symbol;
-            const routes: RouteInfo[] = Reflect.getMetadata(ROUTES_META, constructor) || [];
-
-            routes.push({
-                method,
-                path: path.startsWith('/') ? path : '/' + path,
-                handlerName: String(propertyKey)
-            });
-
-            Reflect.defineMetadata(ROUTES_META, routes, constructor);
-        };
-    };
-}
-
-export const Get = createMethodDecorator('get');
-export const Post = createMethodDecorator('post');
-export const Put = createMethodDecorator('put');
-export const Delete = createMethodDecorator('delete');
-export const Patch = createMethodDecorator('patch');
-export const Head = createMethodDecorator('head');
-export const Options = createMethodDecorator('options');
+import { ROUTES_META, type RouteInfo } from '../metadata';
+
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
+
+/**
+ * Creates a method decorator for HTTP methods.
+ * Supports both legacy decorators (experimentalDecorators) and TS5 stage 3 decorators.
+ */
+function createMethodDecorator(method: HttpMethod) {
+    return function (path: string = ''): any {
+        return function (
+            targetOrMethod: any,
+            contextOrPropertyKey?: string | symbol | ClassMethodDecoratorContext,
+            descriptor?: PropertyDescriptor
+        ): any {
+            // TS5 Stage 3 decorators: context is ClassMethodDecoratorContext
+            if (contextOrPropertyKey && typeof contextOrPropertyKey === 'object' && 'kind' in contextOrPropertyKey) {
+                const context = contextOrPropertyKey as ClassMethodDecoratorContext;
+
+                context.addInitializer(function (this: any) {
+                    const constructor = this.constructor;
+                    const routes: RouteInfo[] = Reflect.getMetadata(ROUTES_META, constructor) || [];
+
+                    routes.push({
+                        method,
+                        path: path.startsWith('/') ? path : '/' + path,
+                        handlerName: String(context.name)
+                    });
+
+                    Reflect.defineMetadata(ROUTES_META, routes, constructor);
+                });
+
+                return targetOrMethod;
+            }
+
+            // Legacy decorators (experimentalDecorators: true)
+            const constructor = targetOrMethod.constructor;
+            const propertyKey = contextOrPropertyKey as string | symbol;
+            const routes: RouteInfo[] = Reflect.getMetadata(ROUTES_META, constructor) || [];
+
+            routes.push({
+                method,
+                path: path.startsWith('/') ? path : '/' + path,
+                handlerName: String(propertyKey)
+            });
+
+            Reflect.defineMetadata(ROUTES_META, routes, constructor);
+        };
+    };
+}
+
+export const Get = createMethodDecorator('get');
+export const Post = createMethodDecorator('post');
+export const Put = createMethodDecorator('put');
+export const Delete = createMethodDecorator('delete');
+export const Patch = createMethodDecorator('patch');
+export const Head = createMethodDecorator('head');
+export const Options = createMethodDecorator('options');

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