@hazeljs/core 0.3.1 → 0.4.1

package/dist/index.js

@@ -7,9 +7,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpError = exports.Scope = exports.Container = exports.CUSTOM_METADATA_PREFIX = exports.createParamDecorator = exports.getMetadata = exports.SetMetadata = exports.ApiOperation = exports.ApiTags = exports.Retry = exports.Session = exports.Optional = exports.Timeout = exports.AITask = exports.SkipAuth = exports.Public = exports.UseGuards = exports.UseInterceptors = exports.UsePipes = exports.Inject = exports.Redirect = exports.Header = exports.HttpCode = exports.Headers = exports.Host = exports.Ip = exports.Res = exports.Req = exports.Query = exports.Param = exports.Body = exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = exports.Service = exports.Injectable = exports.Controller = exports.TimeoutMiddleware = exports.BuiltInHealthChecks = exports.HealthCheckManager = exports.ShutdownManager = exports.collectControllersFromModule = exports.collectModulesFromModule = exports.getModuleMetadata = exports.HazelModuleInstance = exports.Module = exports.HazelModule = exports.HazelApp = void 0;
-exports.sanitizeSql = exports.sanitizeEmail = exports.sanitizeUrl = exports.sanitizeString = exports.sanitizeHtml = exports.RequestParser = exports.Router = exports.Validator = exports.default = exports.logger = exports.UploadedFiles = exports.UploadedFile = exports.FileUploadInterceptor = exports.CsrfMiddleware = exports.RateLimitMiddleware = exports.SecurityHeadersMiddleware = exports.LoggerMiddleware = exports.CorsMiddleware = exports.GlobalMiddlewareManager = exports.extractVersion = exports.matchVersion = exports.getVersionMetadata = exports.VersioningType = exports.Version = exports.RouteMatcher = exports.TestingModuleBuilder = exports.TestingModule = exports.Test = exports.HttpExceptionFilter = exports.getFilterExceptions = exports.Catch = exports.ArgumentsHostImpl = exports.RetryInterceptor = exports.ValidationPipe = exports.ParseIntPipe = exports.ValidationError = exports.RequestTimeoutError = exports.InternalServerErrorException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.HttpException = exports.InternalServerError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = void 0;
-exports.escapeHtml = exports.sanitizeObject = void 0;
+exports.Scope = exports.Container = exports.CUSTOM_METADATA_PREFIX = exports.Lazy = exports.createParamDecorator = exports.getMetadata = exports.SetMetadata = exports.ApiOperation = exports.ApiTags = exports.Retry = exports.Session = exports.Optional = exports.Timeout = exports.AITask = exports.SkipAuth = exports.Public = exports.UseGuards = exports.UseInterceptors = exports.UsePipes = exports.Inject = exports.Redirect = exports.Header = exports.HttpCode = exports.Headers = exports.Host = exports.Ip = exports.Res = exports.Req = exports.Query = exports.Param = exports.Body = exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = exports.Service = exports.Injectable = exports.Controller = exports.TimeoutMiddleware = exports.BuiltInHealthChecks = exports.HealthCheckManager = exports.ShutdownManager = exports.collectControllersFromModule = exports.collectModulesFromModule = exports.getModuleMetadata = exports.HazelModuleInstance = exports.Module = exports.HazelModule = exports.HazelApp = void 0;
+exports.sanitizeEmail = exports.sanitizeUrl = exports.sanitizeString = exports.sanitizeHtml = exports.RequestParser = exports.Router = exports.Validator = exports.default = exports.logger = exports.UploadedFiles = exports.UploadedFile = exports.FileUploadInterceptor = exports.CsrfMiddleware = exports.RateLimitMiddleware = exports.SecurityHeadersMiddleware = exports.LoggerMiddleware = exports.CorsMiddleware = exports.GlobalMiddlewareManager = exports.extractVersion = exports.matchVersion = exports.getVersionMetadata = exports.VersioningType = exports.Version = exports.RouteMatcher = exports.TestingModuleBuilder = exports.TestingModule = exports.Test = exports.HttpExceptionFilter = exports.getFilterExceptions = exports.Catch = exports.ArgumentsHostImpl = exports.RetryInterceptor = exports.ValidationPipe = exports.ParseIntPipe = exports.ValidationError = exports.RequestTimeoutError = exports.InternalServerErrorException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.HttpException = exports.InternalServerError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = exports.HttpError = void 0;
+exports.EnhancedErrors = exports.createEnhancedError = exports.ErrorHandler = exports.BuiltinPerformanceHooks = exports.PerformanceMonitor = exports.escapeHtml = exports.sanitizeObject = exports.sanitizeSql = void 0;
 // Import reflect-metadata to enable decorator metadata
 // Users don't need to import this manually
 require("reflect-metadata");
@@ -69,6 +69,7 @@ Object.defineProperty(exports, "ApiOperation", { enumerable: true, get: function
 Object.defineProperty(exports, "SetMetadata", { enumerable: true, get: function () { return decorators_1.SetMetadata; } });
 Object.defineProperty(exports, "getMetadata", { enumerable: true, get: function () { return decorators_1.getMetadata; } });
 Object.defineProperty(exports, "createParamDecorator", { enumerable: true, get: function () { return decorators_1.createParamDecorator; } });
+Object.defineProperty(exports, "Lazy", { enumerable: true, get: function () { return decorators_1.Lazy; } });
 Object.defineProperty(exports, "CUSTOM_METADATA_PREFIX", { enumerable: true, get: function () { return decorators_1.CUSTOM_METADATA_PREFIX; } });
 // Container & DI
 var container_1 = require("./container");
@@ -160,3 +161,12 @@ Object.defineProperty(exports, "sanitizeEmail", { enumerable: true, get: functio
 Object.defineProperty(exports, "sanitizeSql", { enumerable: true, get: function () { return sanitize_1.sanitizeSql; } });
 Object.defineProperty(exports, "sanitizeObject", { enumerable: true, get: function () { return sanitize_1.sanitizeObject; } });
 Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return sanitize_1.escapeHtml; } });
+// Performance monitoring
+var performance_1 = require("./performance");
+Object.defineProperty(exports, "PerformanceMonitor", { enumerable: true, get: function () { return performance_1.PerformanceMonitor; } });
+Object.defineProperty(exports, "BuiltinPerformanceHooks", { enumerable: true, get: function () { return performance_1.BuiltinPerformanceHooks; } });
+// Enhanced error handling
+var enhanced_errors_1 = require("./enhanced-errors");
+Object.defineProperty(exports, "ErrorHandler", { enumerable: true, get: function () { return enhanced_errors_1.ErrorHandler; } });
+Object.defineProperty(exports, "createEnhancedError", { enumerable: true, get: function () { return enhanced_errors_1.createEnhancedError; } });
+Object.defineProperty(exports, "EnhancedErrors", { enumerable: true, get: function () { return enhanced_errors_1.EnhancedErrors; } });

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAwQvD,eAAO,MAAM,aAAa,GACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,MAAM,IAAI,KACf,IAyBF,CAAC;AAQF,QAAA,MAAM,cAAc;0BALO,OAAO;CAOhC,CAAC;AAGH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAoSvD,eAAO,MAAM,aAAa,GACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,MAAM,IAAI,KACf,IAyBF,CAAC;AAQF,QAAA,MAAM,cAAc;0BALO,OAAO;CAOhC,CAAC;AAGH,eAAe,cAAc,CAAC"}

package/dist/logger.js

@@ -178,10 +178,24 @@ if (logEnabled) {
                 const { level, message, timestamp, ...metadata } = info;
                 let msg = `${timestamp} [${String(level).toUpperCase()}] ${message}`;
                 if (Object.keys(metadata).length > 0) {
+                    // Use the same comprehensive circular reference handling as console logger
+                    const seen = new WeakSet();
                     msg += ` | ${JSON.stringify(metadata, (key, val) => {
+                        // Skip known circular references
                         if (key === 'socket' || key === 'parser' || key === 'res' || key === 'req') {
                             return '[Circular]';
                         }
+                        // Skip Node.js internal objects
+                        if (key === '_idlePrev' || key === '_idleNext' || key === 'cleanupInterval') {
+                            return '[Internal]';
+                        }
+                        // Handle circular references
+                        if (typeof val === 'object' && val !== null) {
+                            if (seen.has(val)) {
+                                return '[Circular]';
+                            }
+                            seen.add(val);
+                        }
                         return val;
                     })}`;
                 }
@@ -194,10 +208,24 @@ if (logEnabled) {
                 const { level, message, timestamp, ...metadata } = info;
                 let msg = `${timestamp} [${String(level).toUpperCase()}] ${message}`;
                 if (Object.keys(metadata).length > 0) {
+                    // Use the same comprehensive circular reference handling as console logger
+                    const seen = new WeakSet();
                     msg += ` | ${JSON.stringify(metadata, (key, val) => {
+                        // Skip known circular references
                         if (key === 'socket' || key === 'parser' || key === 'res' || key === 'req') {
                             return '[Circular]';
                         }
+                        // Skip Node.js internal objects
+                        if (key === '_idlePrev' || key === '_idleNext' || key === 'cleanupInterval') {
+                            return '[Internal]';
+                        }
+                        // Handle circular references
+                        if (typeof val === 'object' && val !== null) {
+                            if (seen.has(val)) {
+                                return '[Circular]';
+                            }
+                            seen.add(val);
+                        }
                         return val;
                     })}`;
                 }

package/dist/performance.d.ts

@@ -0,0 +1,49 @@
+import { Request } from './types';
+export interface PerformanceMetrics {
+    requestId: string;
+    method: string;
+    path: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    statusCode?: number;
+    memoryUsage?: NodeJS.MemoryUsage;
+    cpuUsage?: NodeJS.CpuUsage;
+    error?: Error;
+}
+export interface PerformanceHook {
+    name: string;
+    onRequest?: (metrics: PerformanceMetrics) => void | Promise<void>;
+    onResponse?: (metrics: PerformanceMetrics) => void | Promise<void>;
+    onError?: (metrics: PerformanceMetrics) => void | Promise<void>;
+}
+export interface PerformanceOptions {
+    enableMetrics?: boolean;
+    slowRequestThreshold?: number;
+    maxRequestsWindow?: number;
+    rateLimitWindow?: number;
+}
+export declare class PerformanceMonitor {
+    private hooks;
+    private activeRequests;
+    constructor();
+    addHook(hook: PerformanceHook): void;
+    removeHook(name: string): void;
+    startRequest(req: Request): string;
+    endRequest(requestId: string, statusCode: number, error?: Error): void;
+    getActiveRequests(): PerformanceMetrics[];
+    getMetrics(): {
+        activeRequests: number;
+        totalHooks: number;
+        averageResponseTime?: number;
+    };
+    private generateRequestId;
+    private executeHooks;
+}
+export declare const BuiltinPerformanceHooks: {
+    slowRequestLogger: (threshold?: number) => PerformanceHook;
+    memoryMonitor: () => PerformanceHook;
+    rateLimiter: (maxRequests?: number, windowMs?: number) => PerformanceHook;
+    metricsCollector: () => PerformanceHook;
+};
+//# sourceMappingURL=performance.d.ts.map

package/dist/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../src/performance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,cAAc,CAA8C;;IAMpE,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAKpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAmBlC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAmBtE,iBAAiB,IAAI,kBAAkB,EAAE;IAIzC,UAAU,IAAI;QACZ,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B;IAOD,OAAO,CAAC,iBAAiB;YAIX,YAAY;CAgB3B;AAGD,eAAO,MAAM,uBAAuB;oCAEH,MAAM,KAAU,eAAe;yBAY3C,eAAe;gCAaP,MAAM,aAAkB,MAAM,KAAW,eAAe;4BA0B7D,eAAe;CAwBtC,CAAC"}

package/dist/performance.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuiltinPerformanceHooks = exports.PerformanceMonitor = void 0;
+const logger_1 = __importDefault(require("./logger"));
+class PerformanceMonitor {
+    constructor() {
+        this.hooks = [];
+        this.activeRequests = new Map();
+        logger_1.default.debug('PerformanceMonitor initialized');
+    }
+    addHook(hook) {
+        this.hooks.push(hook);
+        logger_1.default.debug(`Added performance hook: ${hook.name}`);
+    }
+    removeHook(name) {
+        this.hooks = this.hooks.filter(hook => hook.name !== name);
+        logger_1.default.debug(`Removed performance hook: ${name}`);
+    }
+    startRequest(req) {
+        const requestId = this.generateRequestId();
+        const metrics = {
+            requestId,
+            method: req.method || 'GET',
+            path: req.url || '/',
+            startTime: Date.now(),
+            memoryUsage: process.memoryUsage(),
+            cpuUsage: process.cpuUsage(),
+        };
+        this.activeRequests.set(requestId, metrics);
+        // Execute request hooks
+        this.executeHooks('onRequest', metrics);
+        return requestId;
+    }
+    endRequest(requestId, statusCode, error) {
+        const metrics = this.activeRequests.get(requestId);
+        if (!metrics)
+            return;
+        metrics.endTime = Date.now();
+        metrics.duration = metrics.endTime - metrics.startTime;
+        metrics.statusCode = statusCode;
+        metrics.error = error;
+        // Execute response or error hooks
+        if (error) {
+            this.executeHooks('onError', metrics);
+        }
+        else {
+            this.executeHooks('onResponse', metrics);
+        }
+        this.activeRequests.delete(requestId);
+    }
+    getActiveRequests() {
+        return Array.from(this.activeRequests.values());
+    }
+    getMetrics() {
+        return {
+            activeRequests: this.activeRequests.size,
+            totalHooks: this.hooks.length,
+        };
+    }
+    generateRequestId() {
+        return `req_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    async executeHooks(hookType, metrics) {
+        const promises = this.hooks
+            .filter(hook => hook[hookType])
+            .map(async (hook) => {
+            try {
+                await hook[hookType](metrics);
+            }
+            catch (error) {
+                logger_1.default.error(`Error in performance hook ${hook.name}:`, error);
+            }
+        });
+        await Promise.allSettled(promises);
+    }
+}
+exports.PerformanceMonitor = PerformanceMonitor;
+// Built-in performance hooks
+exports.BuiltinPerformanceHooks = {
+    // Log slow requests
+    slowRequestLogger: (threshold = 1000) => ({
+        name: 'slow-request-logger',
+        onResponse: (metrics) => {
+            if (metrics.duration && metrics.duration > threshold) {
+                logger_1.default.warn(`Slow request detected: ${metrics.method} ${metrics.path} took ${metrics.duration}ms`);
+            }
+        },
+    }),
+    // Memory usage monitoring
+    memoryMonitor: () => ({
+        name: 'memory-monitor',
+        onRequest: (metrics) => {
+            const memUsage = metrics.memoryUsage;
+            if (memUsage.heapUsed > 100 * 1024 * 1024) { // 100MB
+                logger_1.default.warn(`High memory usage during request ${metrics.requestId}: ${Math.round(memUsage.heapUsed / 1024 / 1024)}MB`);
+            }
+        },
+    }),
+    // Request rate limiting
+    rateLimiter: (maxRequests = 100, windowMs = 60000) => {
+        const requests = [];
+        return {
+            name: 'rate-limiter',
+            onRequest: (_metrics) => {
+                const now = Date.now();
+                const windowStart = now - windowMs;
+                // Remove old requests
+                while (requests.length > 0 && requests[0] < windowStart) {
+                    requests.shift();
+                }
+                requests.push(now);
+                if (requests.length > maxRequests) {
+                    logger_1.default.warn(`Rate limit exceeded: ${requests.length} requests in ${windowMs}ms`);
+                }
+            },
+        };
+    },
+    // Performance metrics collector
+    metricsCollector: () => {
+        const metrics = [];
+        return {
+            name: 'metrics-collector',
+            onResponse: (metricsData) => {
+                metrics.push(metricsData);
+                // Keep only last 1000 metrics
+                if (metrics.length > 1000) {
+                    metrics.splice(0, 100);
+                }
+                // Calculate average response time
+                const avgTime = metrics.reduce((sum, m) => sum + (m.duration || 0), 0) / metrics.length;
+                if (metrics.length % 100 === 0) {
+                    logger_1.default.debug(`Performance metrics - Avg response time: ${Math.round(avgTime)}ms, Requests: ${metrics.length}`);
+                }
+            },
+        };
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazeljs/core",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Core HazelJS framework - Dependency injection, routing, decorators, and base functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -63,5 +63,5 @@
     "url": "https://github.com/hazeljs/hazel-js/issues"
   },
   "homepage": "https://hazeljs.ai",
-  "gitHead": "db6df492988e5d7b03253a98977c71c7a4540e1c"
+  "gitHead": "151d5678aa2aeddd75fb75b1b5c55fabe8cb8050"
 }