@catbee/utils 0.0.8-rc.1 → 0.0.8-rc.2

package/build/esm/utils/decorators.utils.d.ts

@@ -1,24 +1,26 @@
 import type { RequestHandler, Router } from 'express';
 import 'reflect-metadata';
-import { rateLimit } from 'express-rate-limit';
-/**
- * RateLimiter cache that uses TTLCache for automatic TTL and LRU handling.
- */
-export declare class RateLimiterCache {
-    private cache;
-    constructor(maxSize?: number, ttlMs?: number);
-    private generateKey;
-    get(options: {
-        max: number;
-        windowMs: number;
-        standardHeaders: boolean;
-        legacyHeaders: boolean;
-    }): ReturnType<typeof rateLimit>;
+type Constructor<T = any> = new (...args: any[]) => T;
+export declare class DIContainer {
+    private instances;
+    private constructing;
+    register<T>(target: Constructor<T>): void;
+    get<T>(target: Constructor<T>): T;
     clear(): void;
-    size(): number;
-    destroy(): void;
 }
-declare const rateLimiterCache: RateLimiterCache;
+/**
+ * Injectable decorator for marking classes as injectable.
+ *
+ * @returns Class decorator that marks a class as injectable and registers it with the DI container.
+ */
+export declare function Injectable(): ClassDecorator;
+/**
+ * Inject decorator for injecting dependencies into class properties.
+ *
+ * @param targetClass - The class to inject
+ * @returns Property decorator that injects the specified class into the property
+ */
+export declare function Inject<T>(targetClass: new (...args: any[]) => T): PropertyDecorator;
 /**
  * Decorator for GET HTTP method routes.
  *
@@ -244,7 +246,7 @@ export declare function HttpCode(status: number): MethodDecorator;
  *   return { data: '...' };
  * }
  */
-export declare function Header(name: string, value: string): MethodDecorator;
+export declare function Header(name: string, value: string): MethodDecorator & ClassDecorator;
 /**
  * Decorator that adds a custom HTTP headers to the response.
  *
@@ -274,7 +276,7 @@ export declare function Header(name: string, value: string): MethodDecorator;
  *
  * ```
  */
-export declare function Headers(headers: Record<string, string> | string, value?: string): MethodDecorator;
+export declare function Headers(headers: Record<string, string> | string, value?: string): MethodDecorator & ClassDecorator;
 /**
  * Decorator that registers a function to run before route handler execution.
  * Useful for pre-processing or logging.
@@ -314,6 +316,8 @@ export declare function After(fn: Function): MethodDecorator;
  * Decorator that requires specific roles for accessing a route.
  * Must be used with authentication middleware.
  *
+ * Check req.user.roles for user roles[].
+ *
  * @param roles - List of roles that can access this route
  * @returns Method decorator
  *
@@ -327,7 +331,7 @@ export declare function After(fn: Function): MethodDecorator;
  * }
  * ```
  */
-export declare function Roles(...roles: string[]): MethodDecorator;
+export declare function Roles(...roles: string[]): MethodDecorator & ClassDecorator;
 /**
  * Decorator that redirects to another URL.
  *
@@ -367,7 +371,7 @@ export declare function Redirect(url?: string, statusCode?: number): MethodDecor
  * }
  * ```
  */
-export declare function Cache(ttlSeconds: number): MethodDecorator;
+export declare function Cache(ttlSeconds: number): MethodDecorator & ClassDecorator;
 /**
  * Decorator that applies rate limiting to a route.
  * Note: Requires 'express-rate-limit' package to be installed.
@@ -394,7 +398,7 @@ export declare function RateLimit(options: {
     windowMs: number;
     standardHeaders?: boolean;
     legacyHeaders?: boolean;
-}): MethodDecorator;
+}): MethodDecorator & ClassDecorator;
 /**
  * Decorator that sets the content type for the response.
  *
@@ -444,7 +448,7 @@ export declare function Version(version: string, options?: {
     addPrefix?: boolean;
     addHeader?: boolean;
     headerName?: string;
-}): MethodDecorator;
+}): MethodDecorator & ClassDecorator;
 /**
  * Decorator that sets a timeout for route execution.
  *
@@ -460,7 +464,7 @@ export declare function Version(version: string, options?: {
  * }
  * ```
  */
-export declare function Timeout(ms: number): MethodDecorator;
+export declare function Timeout(ms: number): MethodDecorator & ClassDecorator;
 /**
  * Decorator that adds comprehensive logging to a route.
  *
@@ -495,7 +499,7 @@ export declare function Log(options?: {
     logBody?: boolean;
     logParams?: boolean;
     logResponse?: boolean;
-}): MethodDecorator;
+}): MethodDecorator & ClassDecorator;
 /**
  * Registers all controller classes with the provided router.
  * This function processes all decorators and sets up the Express routes.
@@ -504,5 +508,4 @@ export declare function Log(options?: {
  * @param controllers - Array of controller classes
  */
 export declare function registerControllers(router: Router, controllers: any[]): void;
-export { rateLimiterCache };
-//# sourceMappingURL=decorators.utils.d.ts.map
+export {};