@buenojs/bueno 0.8.10 → 0.8.11

package/dist/modules/interceptors.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Interceptors System
+ *
+ * Interceptors wrap around the handler execution and can modify both the
+ * request before it reaches the handler and the response after.
+ * They run after guards but before pipes in the request pipeline.
+ *
+ * Execution Order:
+ * Incoming Request → Guards → Interceptors (pre) → Pipes → Handler → Interceptors (post) → Response
+ *
+ * Interceptors can:
+ * - Log request/response information
+ * - Transform response data
+ * - Handle timeouts
+ * - Cache responses
+ * - Add headers or modify request/response
+ */
+import type { Token } from "../container";
+import type { Context } from "../context";
+/**
+ * Call handler interface for continuing the interceptor chain
+ *
+ * @example
+ * ```typescript
+ * const result = await next.handle();
+ * ```
+ */
+export interface CallHandler<T = unknown> {
+    /**
+     * Execute the next handler in the chain
+     * @returns Promise of the handler result
+     */
+    handle(): Promise<T>;
+}
+/**
+ * Interceptor interface for request/response transformation
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class LoggingInterceptor implements NestInterceptor {
+ *   async intercept(context: Context, next: CallHandler) {
+ *     console.log('Before...');
+ *     const result = await next.handle();
+ *     console.log('After...');
+ *     return result;
+ *   }
+ * }
+ * ```
+ */
+export interface NestInterceptor<T = unknown, R = unknown> {
+    intercept(context: Context, next: CallHandler<T>): Promise<R> | R;
+}
+/**
+ * Interceptor function type (for functional interceptors)
+ *
+ * @example
+ * ```typescript
+ * const loggingInterceptor: InterceptorFn = async (context, next) => {
+ *   console.log('Request started');
+ *   const result = await next();
+ *   console.log('Request completed');
+ *   return result;
+ * };
+ * ```
+ */
+export type InterceptorFn = (context: Context, next: () => Promise<unknown>) => Promise<unknown> | unknown;
+/**
+ * Interceptor type - can be:
+ * - A token for an interceptor class registered in the container
+ * - An interceptor class instance
+ * - An interceptor function
+ */
+export type Interceptor = Token<NestInterceptor> | NestInterceptor | InterceptorFn;
+type Constructor = new (...args: unknown[]) => unknown;
+/**
+ * Get interceptors from a class constructor
+ */
+export declare function getClassInterceptors(target: Constructor): Interceptor[] | undefined;
+/**
+ * Get interceptors from a method
+ */
+export declare function getMethodInterceptors(target: object, propertyKey: string | symbol): Interceptor[] | undefined;
+/**
+ * Decorator to apply interceptors to a controller class or method.
+ * Interceptors are executed in the order they are provided.
+ *
+ * @param interceptors - Interceptors to apply
+ * @returns ClassDecorator & MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * // Apply to all methods in controller
+ * @Controller('users')
+ * @UseInterceptors(LoggingInterceptor)
+ * class UsersController {
+ *   @Get()
+ *   @UseInterceptors(TransformInterceptor) // Additional interceptor
+ *   getUsers() {}
+ * }
+ * ```
+ */
+export declare function UseInterceptors(...interceptors: Interceptor[]): MethodDecorator & ClassDecorator;
+/**
+ * LoggingInterceptor - Logs request start, end, and duration
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseInterceptors(LoggingInterceptor)
+ * class ApiController {
+ *   @Get('users')
+ *   getUsers() {}
+ * }
+ * // Output:
+ * // [GET] /api/users - Started
+ * // [GET] /api/users - Completed in 15ms
+ * ```
+ */
+export declare class LoggingInterceptor implements NestInterceptor {
+    intercept(context: Context, next: CallHandler): Promise<unknown>;
+}
+/**
+ * Response wrapper interface for TransformInterceptor
+ */
+export interface TransformResponse<T> {
+    data: T;
+    timestamp: string;
+}
+/**
+ * TransformInterceptor - Wraps response in standard format
+ *
+ * @example
+ * ```typescript
+ * @Get()
+ * @UseInterceptors(new TransformInterceptor())
+ * getUsers() {
+ *   return [{ id: 1, name: 'John' }];
+ * }
+ * // Response: { data: [{ id: 1, name: 'John' }], timestamp: '2024-01-15T10:30:00.000Z' }
+ * ```
+ */
+export declare class TransformInterceptor<T = unknown> implements NestInterceptor<T, TransformResponse<T>> {
+    intercept(context: Context, next: CallHandler<T>): Promise<TransformResponse<T>>;
+}
+/**
+ * TimeoutInterceptor - Aborts request after specified timeout
+ *
+ * @example
+ * ```typescript
+ * @Get('slow-endpoint')
+ * @UseInterceptors(new TimeoutInterceptor(5000)) // 5 second timeout
+ * slowOperation() {}
+ * ```
+ */
+export declare class TimeoutInterceptor implements NestInterceptor {
+    private timeoutMs;
+    constructor(timeoutMs: number);
+    intercept(context: Context, next: CallHandler): Promise<unknown>;
+}
+/**
+ * CacheInterceptor - Caches responses in memory
+ *
+ * Note: This is a simple in-memory cache. For production use,
+ * consider using a distributed cache like Redis.
+ *
+ * @example
+ * ```typescript
+ * @Get('users')
+ * @UseInterceptors(new CacheInterceptor(60000)) // Cache for 60 seconds
+ * getUsers() {
+ *   return this.userService.findAll(); // Only called if not cached
+ * }
+ * ```
+ */
+export declare class CacheInterceptor implements NestInterceptor {
+    private ttlMs;
+    private static cache;
+    private static cleanupInterval;
+    constructor(ttlMs?: number);
+    private static setupCleanup;
+    /**
+     * Generate cache key from context
+     */
+    private getCacheKey;
+    /**
+     * Clear all cached entries
+     */
+    static clearCache(): void;
+    /**
+     * Clear cache for a specific key pattern
+     */
+    static clearCachePattern(pattern: string): void;
+    intercept(context: Context, next: CallHandler): Promise<unknown>;
+}
+/**
+ * HeaderInterceptor - Adds custom headers to responses
+ *
+ * @example
+ * ```typescript
+ * @Get('api/data')
+ * @UseInterceptors(new HeaderInterceptor({ 'X-Custom-Header': 'value' }))
+ * getData() {}
+ * ```
+ */
+export declare class HeaderInterceptor implements NestInterceptor {
+    private headers;
+    constructor(headers: Record<string, string>);
+    intercept(context: Context, next: CallHandler): Promise<unknown>;
+}
+/**
+ * Interceptor executor options
+ */
+export interface InterceptorExecutorOptions {
+    /** Global interceptors applied to all routes */
+    globalInterceptors?: Interceptor[];
+    /** Interceptors from controller class */
+    classInterceptors?: Interceptor[];
+    /** Interceptors from method */
+    methodInterceptors?: Interceptor[];
+    /** Container for resolving interceptor instances */
+    resolveInterceptor?: (interceptor: Interceptor) => NestInterceptor | InterceptorFn | null;
+}
+/**
+ * Execute interceptors wrapping around the handler
+ *
+ * @param context - Request context
+ * @param handler - The final handler to execute
+ * @param options - Interceptor executor options
+ * @returns Promise of the result
+ */
+export declare function executeInterceptors(context: Context, handler: () => Promise<unknown>, options: InterceptorExecutorOptions): Promise<unknown>;
+/**
+ * Check if a value is a NestInterceptor instance
+ */
+export declare function isNestInterceptor(value: unknown): value is NestInterceptor;
+/**
+ * Check if a value is an interceptor function
+ */
+export declare function isInterceptorFn(value: unknown): value is InterceptorFn;
+export {};
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/modules/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../src/modules/interceptors.ts"],"names":[],"mappings":"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"}

package/dist/modules/interceptors.js

@@ -0,0 +1,407 @@
+/**
+ * Interceptors System
+ *
+ * Interceptors wrap around the handler execution and can modify both the
+ * request before it reaches the handler and the response after.
+ * They run after guards but before pipes in the request pipeline.
+ *
+ * Execution Order:
+ * Incoming Request → Guards → Interceptors (pre) → Pipes → Handler → Interceptors (post) → Response
+ *
+ * Interceptors can:
+ * - Log request/response information
+ * - Transform response data
+ * - Handle timeouts
+ * - Cache responses
+ * - Add headers or modify request/response
+ */
+// WeakMap for storing interceptors metadata on classes
+const interceptorsClassMetadata = new WeakMap();
+// WeakMap for storing interceptors metadata on method prototypes
+const interceptorsMethodMetadata = new WeakMap();
+/**
+ * Set interceptors on a class constructor
+ */
+function setClassInterceptors(target, interceptors) {
+    interceptorsClassMetadata.set(target, interceptors);
+}
+/**
+ * Get interceptors from a class constructor
+ */
+export function getClassInterceptors(target) {
+    return interceptorsClassMetadata.get(target);
+}
+/**
+ * Set interceptors on a method
+ */
+function setMethodInterceptors(target, propertyKey, interceptors) {
+    if (!interceptorsMethodMetadata.has(target)) {
+        interceptorsMethodMetadata.set(target, new Map());
+    }
+    interceptorsMethodMetadata.get(target)?.set(propertyKey, interceptors);
+}
+/**
+ * Get interceptors from a method
+ */
+export function getMethodInterceptors(target, propertyKey) {
+    return interceptorsMethodMetadata.get(target)?.get(propertyKey);
+}
+// ============= Decorators =============
+/**
+ * Decorator to apply interceptors to a controller class or method.
+ * Interceptors are executed in the order they are provided.
+ *
+ * @param interceptors - Interceptors to apply
+ * @returns ClassDecorator & MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * // Apply to all methods in controller
+ * @Controller('users')
+ * @UseInterceptors(LoggingInterceptor)
+ * class UsersController {
+ *   @Get()
+ *   @UseInterceptors(TransformInterceptor) // Additional interceptor
+ *   getUsers() {}
+ * }
+ * ```
+ */
+export function UseInterceptors(...interceptors) {
+    const decorator = (target, propertyKey, descriptor) => {
+        if (propertyKey !== undefined && descriptor !== undefined) {
+            // Method decorator
+            const targetObj = target;
+            const existingInterceptors = getMethodInterceptors(targetObj, propertyKey) ?? [];
+            setMethodInterceptors(targetObj, propertyKey, [
+                ...existingInterceptors,
+                ...interceptors,
+            ]);
+            return descriptor;
+        }
+        else {
+            // Class decorator
+            const targetClass = target;
+            const existingInterceptors = getClassInterceptors(targetClass) ?? [];
+            setClassInterceptors(targetClass, [
+                ...existingInterceptors,
+                ...interceptors,
+            ]);
+        }
+    };
+    return decorator;
+}
+// ============= Built-in Interceptors =============
+/**
+ * LoggingInterceptor - Logs request start, end, and duration
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseInterceptors(LoggingInterceptor)
+ * class ApiController {
+ *   @Get('users')
+ *   getUsers() {}
+ * }
+ * // Output:
+ * // [GET] /api/users - Started
+ * // [GET] /api/users - Completed in 15ms
+ * ```
+ */
+export class LoggingInterceptor {
+    async intercept(context, next) {
+        const method = context.method;
+        const path = context.path;
+        const startTime = Date.now();
+        console.log(`[${method}] ${path} - Started`);
+        try {
+            const result = await next.handle();
+            const duration = Date.now() - startTime;
+            console.log(`[${method}] ${path} - Completed in ${duration}ms`);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            console.error(`[${method}] ${path} - Failed in ${duration}ms`, error);
+            throw error;
+        }
+    }
+}
+/**
+ * TransformInterceptor - Wraps response in standard format
+ *
+ * @example
+ * ```typescript
+ * @Get()
+ * @UseInterceptors(new TransformInterceptor())
+ * getUsers() {
+ *   return [{ id: 1, name: 'John' }];
+ * }
+ * // Response: { data: [{ id: 1, name: 'John' }], timestamp: '2024-01-15T10:30:00.000Z' }
+ * ```
+ */
+export class TransformInterceptor {
+    async intercept(context, next) {
+        const result = await next.handle();
+        return {
+            data: result,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+/**
+ * TimeoutInterceptor - Aborts request after specified timeout
+ *
+ * @example
+ * ```typescript
+ * @Get('slow-endpoint')
+ * @UseInterceptors(new TimeoutInterceptor(5000)) // 5 second timeout
+ * slowOperation() {}
+ * ```
+ */
+export class TimeoutInterceptor {
+    timeoutMs;
+    constructor(timeoutMs) {
+        this.timeoutMs = timeoutMs;
+    }
+    async intercept(context, next) {
+        // Create a timeout promise that rejects
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Request timeout after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+        });
+        // Race between the handler and timeout
+        return Promise.race([next.handle(), timeoutPromise]);
+    }
+}
+/**
+ * CacheInterceptor - Caches responses in memory
+ *
+ * Note: This is a simple in-memory cache. For production use,
+ * consider using a distributed cache like Redis.
+ *
+ * @example
+ * ```typescript
+ * @Get('users')
+ * @UseInterceptors(new CacheInterceptor(60000)) // Cache for 60 seconds
+ * getUsers() {
+ *   return this.userService.findAll(); // Only called if not cached
+ * }
+ * ```
+ */
+export class CacheInterceptor {
+    ttlMs;
+    static cache = new Map();
+    static cleanupInterval = null;
+    constructor(ttlMs = 60000) {
+        this.ttlMs = ttlMs;
+        // Setup periodic cleanup of expired entries
+        CacheInterceptor.setupCleanup();
+    }
+    static setupCleanup() {
+        if (CacheInterceptor.cleanupInterval === null) {
+            CacheInterceptor.cleanupInterval = setInterval(() => {
+                const now = Date.now();
+                for (const [key, entry] of CacheInterceptor.cache.entries()) {
+                    if (entry.expiresAt < now) {
+                        CacheInterceptor.cache.delete(key);
+                    }
+                }
+            }, 60000); // Cleanup every minute
+        }
+    }
+    /**
+     * Generate cache key from context
+     */
+    getCacheKey(context) {
+        return `${context.method}:${context.path}:${context.url.search}`;
+    }
+    /**
+     * Clear all cached entries
+     */
+    static clearCache() {
+        CacheInterceptor.cache.clear();
+    }
+    /**
+     * Clear cache for a specific key pattern
+     */
+    static clearCachePattern(pattern) {
+        for (const key of CacheInterceptor.cache.keys()) {
+            if (key.includes(pattern)) {
+                CacheInterceptor.cache.delete(key);
+            }
+        }
+    }
+    async intercept(context, next) {
+        const cacheKey = this.getCacheKey(context);
+        const now = Date.now();
+        // Check if we have a valid cached response
+        const cached = CacheInterceptor.cache.get(cacheKey);
+        if (cached && cached.expiresAt > now) {
+            return cached.value;
+        }
+        // Execute handler and cache the result
+        const result = await next.handle();
+        // Only cache successful responses
+        CacheInterceptor.cache.set(cacheKey, {
+            value: result,
+            expiresAt: now + this.ttlMs,
+        });
+        return result;
+    }
+}
+/**
+ * HeaderInterceptor - Adds custom headers to responses
+ *
+ * @example
+ * ```typescript
+ * @Get('api/data')
+ * @UseInterceptors(new HeaderInterceptor({ 'X-Custom-Header': 'value' }))
+ * getData() {}
+ * ```
+ */
+export class HeaderInterceptor {
+    headers;
+    constructor(headers) {
+        this.headers = headers;
+    }
+    async intercept(context, next) {
+        const result = await next.handle();
+        // If result is a Response object, add headers
+        if (result instanceof Response) {
+            const newHeaders = new Headers(result.headers);
+            for (const [key, value] of Object.entries(this.headers)) {
+                newHeaders.set(key, value);
+            }
+            return new Response(result.body, {
+                status: result.status,
+                statusText: result.statusText,
+                headers: newHeaders,
+            });
+        }
+        return result;
+    }
+}
+/**
+ * Create a call handler that chains interceptors
+ */
+function createCallHandler(interceptors, context, finalHandler, resolveInterceptor) {
+    let index = 0;
+    const execute = async () => {
+        if (index >= interceptors.length) {
+            return finalHandler();
+        }
+        const interceptor = interceptors[index++];
+        let interceptorInstance = interceptor;
+        // Resolve if needed
+        if (resolveInterceptor &&
+            !isNestInterceptor(interceptor) &&
+            !isInterceptorFn(interceptor)) {
+            interceptorInstance = resolveInterceptor(interceptor);
+        }
+        if (!interceptorInstance) {
+            console.warn("Interceptor could not be resolved:", interceptor);
+            return execute();
+        }
+        // Create the next call handler
+        const next = {
+            handle: () => execute(),
+        };
+        // Execute the interceptor
+        if (isInterceptorFn(interceptorInstance)) {
+            return interceptorInstance(context, () => execute());
+        }
+        else {
+            return interceptorInstance.intercept(context, next);
+        }
+    };
+    return {
+        handle: execute,
+    };
+}
+/**
+ * Execute interceptors wrapping around the handler
+ *
+ * @param context - Request context
+ * @param handler - The final handler to execute
+ * @param options - Interceptor executor options
+ * @returns Promise of the result
+ */
+export async function executeInterceptors(context, handler, options) {
+    const { globalInterceptors = [], classInterceptors = [], methodInterceptors = [], resolveInterceptor, } = options;
+    // Combine all interceptors in execution order
+    // Global → Class → Method
+    const allInterceptors = [
+        ...globalInterceptors,
+        ...classInterceptors,
+        ...methodInterceptors,
+    ];
+    // If no interceptors, just execute the handler
+    if (allInterceptors.length === 0) {
+        return handler();
+    }
+    // Resolve all interceptors
+    const resolvedInterceptors = [];
+    for (const interceptor of allInterceptors) {
+        let instance = null;
+        // Resolve the interceptor
+        if (typeof interceptor === "function") {
+            // Check if it's an interceptor function or a class constructor
+            const funcInterceptor = interceptor;
+            if (funcInterceptor.prototype &&
+                typeof funcInterceptor.prototype === "object" &&
+                "intercept" in funcInterceptor.prototype) {
+                // It's a class constructor - try to resolve from container or create instance
+                instance = resolveInterceptor ? resolveInterceptor(interceptor) : null;
+                if (!instance) {
+                    // Create a new instance if not in container
+                    const InterceptorClass = interceptor;
+                    instance = new InterceptorClass();
+                }
+            }
+            else {
+                // It's an interceptor function
+                instance = interceptor;
+            }
+        }
+        else if (typeof interceptor === "object" && interceptor !== null) {
+            // It's a token or already an instance
+            const objInterceptor = interceptor;
+            if ("intercept" in objInterceptor &&
+                typeof objInterceptor.intercept === "function") {
+                // It's already a NestInterceptor instance
+                instance = interceptor;
+            }
+            else {
+                // It's a token - try to resolve
+                instance = resolveInterceptor ? resolveInterceptor(interceptor) : null;
+            }
+        }
+        if (instance) {
+            resolvedInterceptors.push(instance);
+        }
+        else {
+            console.warn("Interceptor could not be resolved:", interceptor);
+        }
+    }
+    // Create the call handler chain
+    const callHandler = createCallHandler(resolvedInterceptors, context, handler, resolveInterceptor);
+    return callHandler.handle();
+}
+// ============= Type Guards =============
+/**
+ * Check if a value is a NestInterceptor instance
+ */
+export function isNestInterceptor(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "intercept" in value &&
+        typeof value.intercept === "function");
+}
+/**
+ * Check if a value is an interceptor function
+ */
+export function isInterceptorFn(value) {
+    return typeof value === "function" && !isNestInterceptor(value);
+}
+//# sourceMappingURL=interceptors.js.map

package/dist/modules/interceptors.js.map

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