@hazeljs/core 0.2.0-alpha.1

package/dist/index.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * HazelJS Core Framework
+ * A modern, modular Node.js framework with TypeScript support
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnauthorizedError = exports.BadRequestError = 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.getModuleMetadata = exports.HazelModuleInstance = exports.Module = exports.HazelModule = exports.HazelApp = void 0;
+exports.escapeHtml = exports.sanitizeObject = 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 = void 0;
+// Import reflect-metadata to enable decorator metadata
+// Users don't need to import this manually
+require("reflect-metadata");
+// Core exports
+var hazel_app_1 = require("./hazel-app");
+Object.defineProperty(exports, "HazelApp", { enumerable: true, get: function () { return hazel_app_1.HazelApp; } });
+var hazel_module_1 = require("./hazel-module");
+Object.defineProperty(exports, "HazelModule", { enumerable: true, get: function () { return hazel_module_1.HazelModule; } });
+Object.defineProperty(exports, "Module", { enumerable: true, get: function () { return hazel_module_1.Module; } });
+Object.defineProperty(exports, "HazelModuleInstance", { enumerable: true, get: function () { return hazel_module_1.HazelModuleInstance; } });
+Object.defineProperty(exports, "getModuleMetadata", { enumerable: true, get: function () { return hazel_module_1.getModuleMetadata; } });
+// Shutdown & Health
+var shutdown_1 = require("./shutdown");
+Object.defineProperty(exports, "ShutdownManager", { enumerable: true, get: function () { return shutdown_1.ShutdownManager; } });
+var health_1 = require("./health");
+Object.defineProperty(exports, "HealthCheckManager", { enumerable: true, get: function () { return health_1.HealthCheckManager; } });
+Object.defineProperty(exports, "BuiltInHealthChecks", { enumerable: true, get: function () { return health_1.BuiltInHealthChecks; } });
+// Timeout Middleware (new)
+var timeout_middleware_1 = require("./middleware/timeout.middleware");
+Object.defineProperty(exports, "TimeoutMiddleware", { enumerable: true, get: function () { return timeout_middleware_1.TimeoutMiddleware; } });
+// Decorators
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return decorators_1.Controller; } });
+Object.defineProperty(exports, "Injectable", { enumerable: true, get: function () { return decorators_1.Injectable; } });
+Object.defineProperty(exports, "Service", { enumerable: true, get: function () { return decorators_1.Service; } });
+Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return decorators_1.Get; } });
+Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return decorators_1.Post; } });
+Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return decorators_1.Put; } });
+Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return decorators_1.Delete; } });
+Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return decorators_1.Patch; } });
+Object.defineProperty(exports, "Body", { enumerable: true, get: function () { return decorators_1.Body; } });
+Object.defineProperty(exports, "Param", { enumerable: true, get: function () { return decorators_1.Param; } });
+Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return decorators_1.Query; } });
+Object.defineProperty(exports, "Req", { enumerable: true, get: function () { return decorators_1.Req; } });
+Object.defineProperty(exports, "Res", { enumerable: true, get: function () { return decorators_1.Res; } });
+Object.defineProperty(exports, "Ip", { enumerable: true, get: function () { return decorators_1.Ip; } });
+Object.defineProperty(exports, "Host", { enumerable: true, get: function () { return decorators_1.Host; } });
+Object.defineProperty(exports, "Headers", { enumerable: true, get: function () { return decorators_1.Headers; } });
+Object.defineProperty(exports, "HttpCode", { enumerable: true, get: function () { return decorators_1.HttpCode; } });
+Object.defineProperty(exports, "Header", { enumerable: true, get: function () { return decorators_1.Header; } });
+Object.defineProperty(exports, "Redirect", { enumerable: true, get: function () { return decorators_1.Redirect; } });
+Object.defineProperty(exports, "Inject", { enumerable: true, get: function () { return decorators_1.Inject; } });
+Object.defineProperty(exports, "UsePipes", { enumerable: true, get: function () { return decorators_1.UsePipes; } });
+Object.defineProperty(exports, "UseInterceptors", { enumerable: true, get: function () { return decorators_1.UseInterceptors; } });
+Object.defineProperty(exports, "UseGuards", { enumerable: true, get: function () { return decorators_1.UseGuards; } });
+Object.defineProperty(exports, "Public", { enumerable: true, get: function () { return decorators_1.Public; } });
+Object.defineProperty(exports, "SkipAuth", { enumerable: true, get: function () { return decorators_1.SkipAuth; } });
+Object.defineProperty(exports, "AITask", { enumerable: true, get: function () { return decorators_1.AITask; } });
+Object.defineProperty(exports, "Timeout", { enumerable: true, get: function () { return decorators_1.Timeout; } });
+Object.defineProperty(exports, "Optional", { enumerable: true, get: function () { return decorators_1.Optional; } });
+Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return decorators_1.Session; } });
+Object.defineProperty(exports, "Retry", { enumerable: true, get: function () { return decorators_1.Retry; } });
+Object.defineProperty(exports, "ApiTags", { enumerable: true, get: function () { return decorators_1.ApiTags; } });
+Object.defineProperty(exports, "ApiOperation", { enumerable: true, get: function () { return decorators_1.ApiOperation; } });
+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, "CUSTOM_METADATA_PREFIX", { enumerable: true, get: function () { return decorators_1.CUSTOM_METADATA_PREFIX; } });
+// Container & DI
+var container_1 = require("./container");
+Object.defineProperty(exports, "Container", { enumerable: true, get: function () { return container_1.Container; } });
+Object.defineProperty(exports, "Scope", { enumerable: true, get: function () { return container_1.Scope; } });
+// Errors
+var http_error_1 = require("./errors/http.error");
+Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return http_error_1.HttpError; } });
+Object.defineProperty(exports, "BadRequestError", { enumerable: true, get: function () { return http_error_1.BadRequestError; } });
+Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return http_error_1.UnauthorizedError; } });
+Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return http_error_1.ForbiddenError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return http_error_1.NotFoundError; } });
+Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return http_error_1.ConflictError; } });
+Object.defineProperty(exports, "InternalServerError", { enumerable: true, get: function () { return http_error_1.InternalServerError; } });
+Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return http_error_1.HttpException; } });
+Object.defineProperty(exports, "BadRequestException", { enumerable: true, get: function () { return http_error_1.BadRequestException; } });
+Object.defineProperty(exports, "UnauthorizedException", { enumerable: true, get: function () { return http_error_1.UnauthorizedException; } });
+Object.defineProperty(exports, "ForbiddenException", { enumerable: true, get: function () { return http_error_1.ForbiddenException; } });
+Object.defineProperty(exports, "NotFoundException", { enumerable: true, get: function () { return http_error_1.NotFoundException; } });
+Object.defineProperty(exports, "ConflictException", { enumerable: true, get: function () { return http_error_1.ConflictException; } });
+Object.defineProperty(exports, "InternalServerErrorException", { enumerable: true, get: function () { return http_error_1.InternalServerErrorException; } });
+Object.defineProperty(exports, "RequestTimeoutError", { enumerable: true, get: function () { return http_error_1.RequestTimeoutError; } });
+// Pipes
+var pipe_1 = require("./pipes/pipe");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return pipe_1.ValidationError; } });
+Object.defineProperty(exports, "ParseIntPipe", { enumerable: true, get: function () { return pipe_1.ParseIntPipe; } });
+var validation_pipe_1 = require("./pipes/validation.pipe");
+Object.defineProperty(exports, "ValidationPipe", { enumerable: true, get: function () { return validation_pipe_1.ValidationPipe; } });
+// Interceptors
+var interceptor_1 = require("./interceptors/interceptor");
+Object.defineProperty(exports, "RetryInterceptor", { enumerable: true, get: function () { return interceptor_1.RetryInterceptor; } });
+// Filters
+var exception_filter_1 = require("./filters/exception-filter");
+Object.defineProperty(exports, "ArgumentsHostImpl", { enumerable: true, get: function () { return exception_filter_1.ArgumentsHostImpl; } });
+Object.defineProperty(exports, "Catch", { enumerable: true, get: function () { return exception_filter_1.Catch; } });
+Object.defineProperty(exports, "getFilterExceptions", { enumerable: true, get: function () { return exception_filter_1.getFilterExceptions; } });
+var http_exception_filter_1 = require("./filters/http-exception.filter");
+Object.defineProperty(exports, "HttpExceptionFilter", { enumerable: true, get: function () { return http_exception_filter_1.HttpExceptionFilter; } });
+// Testing
+var testing_module_1 = require("./testing/testing.module");
+Object.defineProperty(exports, "Test", { enumerable: true, get: function () { return testing_module_1.Test; } });
+Object.defineProperty(exports, "TestingModule", { enumerable: true, get: function () { return testing_module_1.TestingModule; } });
+Object.defineProperty(exports, "TestingModuleBuilder", { enumerable: true, get: function () { return testing_module_1.TestingModuleBuilder; } });
+// Routing
+var route_matcher_1 = require("./routing/route-matcher");
+Object.defineProperty(exports, "RouteMatcher", { enumerable: true, get: function () { return route_matcher_1.RouteMatcher; } });
+var version_decorator_1 = require("./routing/version.decorator");
+Object.defineProperty(exports, "Version", { enumerable: true, get: function () { return version_decorator_1.Version; } });
+Object.defineProperty(exports, "VersioningType", { enumerable: true, get: function () { return version_decorator_1.VersioningType; } });
+Object.defineProperty(exports, "getVersionMetadata", { enumerable: true, get: function () { return version_decorator_1.getVersionMetadata; } });
+Object.defineProperty(exports, "matchVersion", { enumerable: true, get: function () { return version_decorator_1.matchVersion; } });
+Object.defineProperty(exports, "extractVersion", { enumerable: true, get: function () { return version_decorator_1.extractVersion; } });
+// Middleware
+var global_middleware_1 = require("./middleware/global-middleware");
+Object.defineProperty(exports, "GlobalMiddlewareManager", { enumerable: true, get: function () { return global_middleware_1.GlobalMiddlewareManager; } });
+Object.defineProperty(exports, "CorsMiddleware", { enumerable: true, get: function () { return global_middleware_1.CorsMiddleware; } });
+Object.defineProperty(exports, "LoggerMiddleware", { enumerable: true, get: function () { return global_middleware_1.LoggerMiddleware; } });
+var security_headers_middleware_1 = require("./middleware/security-headers.middleware");
+Object.defineProperty(exports, "SecurityHeadersMiddleware", { enumerable: true, get: function () { return security_headers_middleware_1.SecurityHeadersMiddleware; } });
+var rate_limit_middleware_1 = require("./middleware/rate-limit.middleware");
+Object.defineProperty(exports, "RateLimitMiddleware", { enumerable: true, get: function () { return rate_limit_middleware_1.RateLimitMiddleware; } });
+var csrf_middleware_1 = require("./middleware/csrf.middleware");
+Object.defineProperty(exports, "CsrfMiddleware", { enumerable: true, get: function () { return csrf_middleware_1.CsrfMiddleware; } });
+// File Upload
+var file_upload_1 = require("./upload/file-upload");
+Object.defineProperty(exports, "FileUploadInterceptor", { enumerable: true, get: function () { return file_upload_1.FileUploadInterceptor; } });
+Object.defineProperty(exports, "UploadedFile", { enumerable: true, get: function () { return file_upload_1.UploadedFileDecorator; } });
+Object.defineProperty(exports, "UploadedFiles", { enumerable: true, get: function () { return file_upload_1.UploadedFilesDecorator; } });
+// Logger
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return __importDefault(logger_1).default; } });
+var logger_2 = require("./logger");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(logger_2).default; } });
+// Validator
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "Validator", { enumerable: true, get: function () { return validator_1.Validator; } });
+// Router
+var router_1 = require("./router");
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_1.Router; } });
+// Request utilities
+var request_parser_1 = require("./request-parser");
+Object.defineProperty(exports, "RequestParser", { enumerable: true, get: function () { return request_parser_1.RequestParser; } });
+// Security utilities
+var sanitize_1 = require("./utils/sanitize");
+Object.defineProperty(exports, "sanitizeHtml", { enumerable: true, get: function () { return sanitize_1.sanitizeHtml; } });
+Object.defineProperty(exports, "sanitizeString", { enumerable: true, get: function () { return sanitize_1.sanitizeString; } });
+Object.defineProperty(exports, "sanitizeUrl", { enumerable: true, get: function () { return sanitize_1.sanitizeUrl; } });
+Object.defineProperty(exports, "sanitizeEmail", { enumerable: true, get: function () { return sanitize_1.sanitizeEmail; } });
+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; } });

package/dist/interceptors/interceptor.d.ts

@@ -0,0 +1,30 @@
+import { RequestContext } from '../request-context';
+export interface Interceptor {
+    intercept(context: RequestContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+export interface InterceptorMetadata {
+    type: Type<Interceptor>;
+    options?: unknown;
+}
+export interface CacheOptions {
+    ttl?: number;
+}
+export declare class LoggingInterceptor implements Interceptor {
+    intercept(context: RequestContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+export declare class CacheInterceptor implements Interceptor {
+    private static cache;
+    private readonly ttl;
+    constructor(options?: CacheOptions);
+    intercept(context: RequestContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+export interface RetryOptions {
+    count: number;
+    delay?: number;
+    retryIf?: (err: Error) => boolean;
+}
+export declare class RetryInterceptor implements Interceptor {
+    intercept(context: RequestContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+export type Type<T = unknown> = new (...args: unknown[]) => T;
+//# sourceMappingURL=interceptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/interceptors/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAmB,YAAW,WAAW;IAC9C,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAgBzF;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAA2D;IAC/E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,CAAC,EAAE,YAAY;IAI5B,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAgBzF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;CACnC;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAC5C,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAqBzF;AAED,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC"}

package/dist/interceptors/interceptor.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryInterceptor = exports.CacheInterceptor = exports.LoggingInterceptor = void 0;
+const logger_1 = __importDefault(require("../logger"));
+class LoggingInterceptor {
+    async intercept(context, next) {
+        const startTime = Date.now();
+        logger_1.default.info(`[${context.method}] ${context.url}`);
+        try {
+            const result = await next();
+            const duration = Date.now() - startTime;
+            logger_1.default.info(`[${context.method}] ${context.url} - ${duration}ms`);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const err = error;
+            logger_1.default.error(`[${context.method}] ${context.url} - ${err.message} (${duration}ms)`);
+            throw error;
+        }
+    }
+}
+exports.LoggingInterceptor = LoggingInterceptor;
+class CacheInterceptor {
+    constructor(options) {
+        this.ttl = options?.ttl || 60000;
+    }
+    async intercept(context, next) {
+        if (context.method !== 'GET') {
+            return next();
+        }
+        const cacheKey = `${context.method}:${context.url}`;
+        const cached = CacheInterceptor.cache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < this.ttl) {
+            return cached.data;
+        }
+        const result = await next();
+        CacheInterceptor.cache.set(cacheKey, { data: result, timestamp: Date.now() });
+        return result;
+    }
+}
+exports.CacheInterceptor = CacheInterceptor;
+CacheInterceptor.cache = new Map();
+class RetryInterceptor {
+    async intercept(context, next) {
+        const opts = context.retryOptions;
+        if (!opts || opts.count < 1) {
+            return next();
+        }
+        const delayMs = opts.delay ?? 100;
+        const shouldRetry = opts.retryIf ?? (() => true);
+        let lastError;
+        for (let attempt = 0; attempt <= opts.count; attempt++) {
+            try {
+                return await next();
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (attempt === opts.count || !shouldRetry(lastError)) {
+                    throw lastError;
+                }
+                await new Promise((r) => setTimeout(r, delayMs));
+            }
+        }
+        throw lastError;
+    }
+}
+exports.RetryInterceptor = RetryInterceptor;

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+import winston from 'winston';
+import { IncomingMessage, ServerResponse } from 'http';
+export declare const requestLogger: (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+declare const enhancedLogger: winston.Logger & {
+    isDebugEnabled: () => boolean;
+};
+export default enhancedLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +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"}

package/dist/logger.js

@@ -0,0 +1,261 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestLogger = void 0;
+const winston_1 = __importDefault(require("winston"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+// Load environment variables
+dotenv_1.default.config();
+const logLevel = process.env.LOG_LEVEL || 'info';
+const logDir = process.env.LOG_DIR || 'logs';
+const logEnabled = process.env.LOG_ENABLED !== 'false'; // default: true
+const logPackage = process.env.LOG_PACKAGE || ''; // e.g. "http" = only HTTP request logs
+// Ensure log directory exists
+if (logDir && !fs_1.default.existsSync(logDir)) {
+    fs_1.default.mkdirSync(logDir, { recursive: true });
+}
+// Professional color scheme for different log levels
+const colors = {
+    error: chalk_1.default.red,
+    warn: chalk_1.default.yellow,
+    info: chalk_1.default.blue,
+    http: chalk_1.default.magenta,
+    debug: chalk_1.default.gray,
+    silly: chalk_1.default.gray,
+};
+// Professional category-based coloring
+const categoryColors = {
+    // Module operations
+    'Initializing HazelModule': chalk_1.default.blue.bold,
+    'Initializing module': chalk_1.default.blue.bold,
+    'Initializing imported modules': chalk_1.default.blue,
+    'Initializing HazelApp': chalk_1.default.cyan.bold,
+    // Provider operations
+    'Registering providers': chalk_1.default.green.bold,
+    'Registering provider': chalk_1.default.green,
+    'Created instance of': chalk_1.default.green,
+    // Controller operations
+    'Registering controllers': chalk_1.default.yellow.bold,
+    'Registering controller': chalk_1.default.yellow,
+    // Route operations
+    'Registering route': chalk_1.default.magenta.bold,
+    // Server operations
+    'Server listening on': chalk_1.default.green.bold,
+    'Application started': chalk_1.default.cyan.bold,
+    'Connected to database': chalk_1.default.green.bold,
+    'Disconnected from database': chalk_1.default.yellow,
+    // Cache operations
+    'Cache service initialized': chalk_1.default.blue,
+    'Cache registered': chalk_1.default.green,
+    'Configuring cache module': chalk_1.default.blue,
+    // Configuration
+    'Configuration loaded': chalk_1.default.green,
+    Configuring: chalk_1.default.blue,
+    // Container
+    'Container initialized': chalk_1.default.cyan.bold,
+};
+// Helper to detect log category and apply appropriate color
+const getCategoryColor = (message) => {
+    for (const [category, colorFn] of Object.entries(categoryColors)) {
+        if (message.includes(category)) {
+            return colorFn;
+        }
+    }
+    return chalk_1.default.white;
+};
+// Custom format for better readability with enhanced colors
+const customFormat = winston_1.default.format.printf((info) => {
+    const { level, message, timestamp, ...metadata } = info;
+    // Get the appropriate color for the log level
+    const levelColor = colors[level] || chalk_1.default.white;
+    // Format the timestamp with subtle color
+    const time = chalk_1.default.gray.dim(String(timestamp ?? ''));
+    // Format the level with color and padding (no icons for professional look)
+    const levelStr = levelColor.bold(`[${String(level).toUpperCase()}]`.padEnd(9));
+    // Convert message to string
+    const messageStr = String(message ?? '');
+    // Detect category and apply appropriate color to message
+    const categoryColor = getCategoryColor(messageStr);
+    let msg = categoryColor(messageStr);
+    // Special formatting for important messages
+    if (messageStr.includes('Server listening on')) {
+        msg = chalk_1.default.green.bold(messageStr);
+    }
+    else if (messageStr.includes('Application started')) {
+        msg = chalk_1.default.cyan.bold(messageStr);
+    }
+    else if (messageStr.includes('→ Local:') || messageStr.includes('→ Network:')) {
+        msg = chalk_1.default.green(messageStr);
+    }
+    // Format metadata if present with enhanced colors
+    let metaStr = '';
+    if (Object.keys(metadata).length > 0) {
+        metaStr = Object.entries(metadata)
+            .map(([key, value]) => {
+            // Color keys based on their type
+            let keyColor = chalk_1.default.cyan;
+            if (key.includes('module') || key.includes('Module')) {
+                keyColor = chalk_1.default.blue;
+            }
+            else if (key.includes('provider') ||
+                key.includes('Provider') ||
+                key.includes('Service')) {
+                keyColor = chalk_1.default.green;
+            }
+            else if (key.includes('controller') || key.includes('Controller')) {
+                keyColor = chalk_1.default.yellow;
+            }
+            else if (key.includes('route') || key.includes('Route')) {
+                keyColor = chalk_1.default.magenta;
+            }
+            const formattedKey = keyColor.bold(key);
+            // Use a custom replacer function to handle circular references
+            const seen = new WeakSet();
+            const safeValue = JSON.stringify(value, (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;
+            });
+            // Color values based on their content
+            let valueColor = chalk_1.default.yellow;
+            if (typeof value === 'string') {
+                if (value.includes('Module') ||
+                    value.includes('Service') ||
+                    value.includes('Controller')) {
+                    valueColor = chalk_1.default.cyan;
+                }
+                else if (value.includes('http://') || value.includes('localhost')) {
+                    valueColor = chalk_1.default.green;
+                }
+            }
+            const formattedValue = valueColor(safeValue);
+            return `${formattedKey}=${formattedValue}`;
+        })
+            .join(' ');
+        metaStr = chalk_1.default.gray.dim(' | ') + metaStr;
+    }
+    return `${time} ${levelStr} ${msg}${metaStr}`;
+});
+// When LOG_PACKAGE=http, only allow logs that look like HTTP requests
+const isHttpLog = (info) => {
+    const msg = String(info.message ?? '');
+    return /^(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD)\s+/i.test(msg) || msg.includes(' → ') || msg.includes(' ← ');
+};
+const transports = [];
+if (logEnabled) {
+    if (logPackage === 'http') {
+        transports.push(new winston_1.default.transports.Console({
+            format: winston_1.default.format.combine(winston_1.default.format((info) => (isHttpLog(info) ? info : false))(), customFormat),
+        }));
+    }
+    else {
+        transports.push(new winston_1.default.transports.Console({
+            format: winston_1.default.format.combine(customFormat),
+        }));
+    }
+    if (logDir) {
+        transports.push(new winston_1.default.transports.File({
+            filename: path_1.default.join(logDir, 'combined.log'),
+            format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.printf((info) => {
+                const { level, message, timestamp, ...metadata } = info;
+                let msg = `${timestamp} [${String(level).toUpperCase()}] ${message}`;
+                if (Object.keys(metadata).length > 0) {
+                    msg += ` | ${JSON.stringify(metadata, (key, val) => {
+                        if (key === 'socket' || key === 'parser' || key === 'res' || key === 'req') {
+                            return '[Circular]';
+                        }
+                        return val;
+                    })}`;
+                }
+                return msg;
+            })),
+        }), new winston_1.default.transports.File({
+            filename: path_1.default.join(logDir, 'error.log'),
+            level: 'error',
+            format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.printf((info) => {
+                const { level, message, timestamp, ...metadata } = info;
+                let msg = `${timestamp} [${String(level).toUpperCase()}] ${message}`;
+                if (Object.keys(metadata).length > 0) {
+                    msg += ` | ${JSON.stringify(metadata, (key, val) => {
+                        if (key === 'socket' || key === 'parser' || key === 'res' || key === 'req') {
+                            return '[Circular]';
+                        }
+                        return val;
+                    })}`;
+                }
+                return msg;
+            })),
+        }));
+    }
+}
+else {
+    transports.push(new winston_1.default.transports.Console({ silent: true }));
+}
+// Create logger instance
+const logger = winston_1.default.createLogger({
+    level: logLevel,
+    format: winston_1.default.format.combine(winston_1.default.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), customFormat),
+    transports,
+});
+// Log application info when starting
+const appInfo = {
+    service: process.env.APP_NAME || 'hazeljs',
+    version: process.env.APP_VERSION || '0.1.0',
+    environment: process.env.NODE_ENV || 'development',
+};
+logger.info(chalk_1.default.cyan.bold('Application started'), appInfo);
+// Add request logging middleware with beautiful formatting
+const requestLogger = (req, res, next) => {
+    const start = Date.now();
+    res.on('finish', () => {
+        const pathname = (req.url ?? '').split('?')[0];
+        if (pathname === '/favicon.ico')
+            return;
+        const duration = Date.now() - start;
+        const statusColor = res.statusCode >= 500
+            ? chalk_1.default.red
+            : res.statusCode >= 400
+                ? chalk_1.default.yellow
+                : res.statusCode >= 300
+                    ? chalk_1.default.cyan
+                    : res.statusCode >= 200
+                        ? chalk_1.default.green
+                        : chalk_1.default.white;
+        logger.info(`${chalk_1.default.bold(req.method ?? '')} ${req.url ?? ''}`, {
+            status: statusColor(String(res.statusCode)),
+            duration: chalk_1.default.yellow(`${duration}ms`),
+            userAgent: chalk_1.default.gray(String(req.headers['user-agent'] ?? '')),
+            ip: chalk_1.default.gray(String(req.socket.remoteAddress ?? '')),
+        });
+    });
+    next();
+};
+exports.requestLogger = requestLogger;
+// Add helper method to check if debug is enabled
+const isDebugEnabled = () => {
+    return logger.isLevelEnabled('debug');
+};
+// Extend logger with helper method
+const enhancedLogger = Object.assign(logger, {
+    isDebugEnabled,
+});
+// Export logger instance
+exports.default = enhancedLogger;

package/dist/middleware/cors.middleware.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CORS Middleware
+ * Handles Cross-Origin Resource Sharing
+ */
+import { Request, Response } from '../types';
+export interface CorsOptions {
+    origin?: string | string[] | ((origin: string) => boolean);
+    methods?: string[];
+    allowedHeaders?: string[];
+    exposedHeaders?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+    preflightContinue?: boolean;
+    optionsSuccessStatus?: number;
+}
+export declare class CorsMiddleware {
+    private options;
+    constructor(options?: CorsOptions);
+    /**
+     * Check if origin is allowed
+     */
+    private isOriginAllowed;
+    /**
+     * Set CORS headers
+     */
+    private setCorsHeaders;
+    /**
+     * Handle preflight request
+     */
+    private handlePreflight;
+    /**
+     * Handle CORS request
+     */
+    handle(req: Request, res: Response, next: () => void): void;
+    /**
+     * Create middleware function
+     */
+    static create(options?: CorsOptions): (req: Request, res: Response, next: () => void) => void;
+}
+/**
+ * Simple CORS helper for common use cases
+ */
+export declare function enableCors(options?: CorsOptions): (req: Request, res: Response, next: () => void) => void;
+//# sourceMappingURL=cors.middleware.d.ts.map

package/dist/middleware/cors.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/cors.middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;gBAE3B,OAAO,GAAE,WAAgB;IAarC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI;IAa3D;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI;CAI9F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAEzG"}