@scpxl/nodejs-framework 1.0.46 → 1.0.49

package/dist/webserver/webserver.js

@@ -171,6 +171,11 @@ class WebServer {
     if (request.requestId) {
       reply.header("X-Request-ID", request.requestId);
     }
+    const em = request.__entityManager;
+    if (em && typeof em.clear === "function") {
+      em.clear();
+      delete request.__entityManager;
+    }
     if (!request.startTime) {
       return;
     }

package/dist/webserver/webserver.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/webserver/webserver.ts"],
-  "sourcesContent": ["import crypto from 'node:crypto';\nimport Fastify, {\n  type FastifyInstance,\n  type FastifyReply,\n  type FastifyRequest,\n  type FastifySchema,\n  type HTTPMethods,\n} from 'fastify';\nimport cors from '@fastify/cors';\nimport helmet from '@fastify/helmet';\nimport rateLimit from '@fastify/rate-limit';\nimport multipart from '@fastify/multipart';\nimport {\n  type AnyRouteSchemaDefinition,\n  type WebServerConstructorParams,\n  type WebServerOptions,\n  type WebServerRoute,\n  WebServerRouteType,\n} from './webserver.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { File, Helper, Loader, Time } from '../util/index.js';\nimport WebServerUtil from './util.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { DatabaseInstance } from '../database/index.js';\nimport type { ControllerAction, WebServerBaseControllerType } from './controller/base.interface.js';\nimport type { QueueManager } from '../queue/index.js';\nimport { WebServerHealthController } from '../index.js';\nimport type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\nimport { enterRequestContext } from '../request-context/index.js';\nimport { type ZodTypeProvider, serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    startTime?: number;\n    requestId?: string;\n  }\n}\n\nclass WebServer {\n  private logger: typeof Logger = Logger;\n\n  private applicationConfig: ApplicationConfig;\n\n  private options: WebServerOptions;\n  private routes: WebServerRoute[];\n  private readonly explicitRoutesConfigured: boolean;\n\n  private redisInstance: RedisInstance;\n  private queueManager: QueueManager;\n  private eventManager: EventManager;\n  private databaseInstance: DatabaseInstance;\n\n  public fastifyServer: FastifyInstance<any, any, any, any, ZodTypeProvider>;\n\n  private lifecycleManager: LifecycleManager;\n  private _isReady = false;\n\n  constructor(params: WebServerConstructorParams & { lifecycleManager: LifecycleManager }) {\n    // Define default options\n    const defaultOptions: Partial<WebServerOptions> = {\n      host: '0.0.0.0',\n      port: 3001,\n      cors: {\n        enabled: false,\n      },\n      errors: {\n        verbose: false,\n      },\n      debug: {\n        printRoutes: false,\n        simulateSlowConnection: {\n          enabled: false,\n          delay: 250,\n        },\n      },\n      log: {\n        startUp: true,\n      },\n    };\n\n    // Merge default options\n    const mergedOptions = Helper.defaultsDeep(params.options, defaultOptions);\n\n    this.applicationConfig = params.applicationConfig;\n\n    this.options = mergedOptions;\n\n    const staticRoutes = Array.isArray(params.routes) ? params.routes : [];\n    this.explicitRoutesConfigured = Array.isArray(params.routes);\n    this.routes = [...staticRoutes];\n\n    this.redisInstance = params.redisInstance;\n    this.queueManager = params.queueManager;\n    this.eventManager = params.eventManager;\n    this.databaseInstance = params.databaseInstance;\n    this.lifecycleManager = params.lifecycleManager;\n\n    // Create Fastify server\n    const defaultBodyLimit = 25 * 1024 * 1024; // 25MB (safer default)\n    const defaultConnectionTimeout = 10 * 1000; // 10 seconds (safer default)\n\n    this.fastifyServer = Fastify({\n      logger: false,\n      bodyLimit: this.options.bodyLimit ?? defaultBodyLimit,\n      connectionTimeout: this.options.connectionTimeout ?? defaultConnectionTimeout,\n    }).withTypeProvider<ZodTypeProvider>();\n\n    // Set up Zod validators and serializers for automatic schema validation\n    this.fastifyServer.setValidatorCompiler(validatorCompiler);\n    this.fastifyServer.setSerializerCompiler(serializerCompiler);\n  }\n\n  /**\n   * Load web server.\n   */\n  public async load(): Promise<void> {\n    // Configure security (helmet, rate limiting)\n    await this.configureSecurity();\n\n    // Configure hooks\n    this.configureHooks();\n\n    // Configure CORS\n    this.configureCORS();\n\n    // Configure multipart uploads\n    this.configureMultipartUploads();\n\n    // Configure routes\n    await this.configureRoutes();\n  }\n\n  /**\n   * Configure security features (Helmet, Rate Limiting)\n   */\n  private async configureSecurity(): Promise<void> {\n    const security = this.options.security ?? {};\n\n    // Configure Helmet for security headers\n    const helmetConfig = security.helmet ?? { enabled: true };\n    if (helmetConfig.enabled !== false) {\n      await this.fastifyServer.register(helmet, {\n        contentSecurityPolicy: helmetConfig.contentSecurityPolicy !== false,\n        crossOriginEmbedderPolicy: helmetConfig.crossOriginEmbedderPolicy !== false,\n        crossOriginOpenerPolicy: helmetConfig.crossOriginOpenerPolicy !== false,\n        crossOriginResourcePolicy: helmetConfig.crossOriginResourcePolicy !== false,\n        dnsPrefetchControl: helmetConfig.dnsPrefetchControl !== false,\n        frameguard: helmetConfig.frameguard !== false,\n        hidePoweredBy: helmetConfig.hidePoweredBy !== false,\n        hsts: helmetConfig.hsts !== false,\n        ieNoOpen: helmetConfig.ieNoOpen !== false,\n        noSniff: helmetConfig.noSniff !== false,\n        originAgentCluster: helmetConfig.originAgentCluster !== false,\n        permittedCrossDomainPolicies: helmetConfig.permittedCrossDomainPolicies !== false,\n        referrerPolicy: helmetConfig.referrerPolicy !== false,\n        xssFilter: helmetConfig.xssFilter !== false,\n      });\n    }\n\n    // Configure rate limiting\n    const rateLimitConfig = security.rateLimit ?? { enabled: true };\n    if (rateLimitConfig.enabled !== false) {\n      await this.fastifyServer.register(rateLimit, {\n        max: rateLimitConfig.max ?? 1000,\n        timeWindow: rateLimitConfig.timeWindow ?? '1 minute',\n        ban: rateLimitConfig.ban,\n        cache: rateLimitConfig.cache ?? 5000,\n      });\n    }\n\n    // Warn about wildcard CORS in production\n    if (process.env.NODE_ENV === 'production' && this.options.cors?.enabled) {\n      const corsConfig = this.options.cors as { enabled: true; urls: string[] };\n      if (corsConfig.urls?.includes('*')) {\n        this.logger.warn({\n          message: 'Wildcard CORS (*) is enabled in production - this is a security risk',\n          meta: {\n            recommendation: 'Specify allowed origins explicitly',\n          },\n        });\n      }\n    }\n  }\n\n  /**\n   * Configure hooks.\n   */\n  private configureHooks(): void {\n    this.fastifyServer.addHook('onListen', async () => this.onListen());\n    this.fastifyServer.addHook('onRequest', async request => this.onRequest(request));\n    this.fastifyServer.addHook('onResponse', async (request, reply) => this.onResponse(request, reply));\n    this.fastifyServer.addHook('onError', async (request, reply, error) => this.onError(request, reply, error));\n    this.fastifyServer.addHook('onClose', async () => this.onClose());\n\n    // if (process.env.NODE_ENV === 'local') {\n    //   this.fastifyServer.addHook('onSend', (request, reply, payload, done) => {\n    //     reply.header('Cache-Control', 'no-store');\n    //     done();\n    //   });\n    // }\n  }\n\n  private async onListen(): Promise<void> {\n    const address = this.fastifyServer.server.address();\n    const port = typeof address === 'string' ? address : address?.port;\n\n    if (this.options.log?.startUp) {\n      this.log('Started', {\n        Host: this.options.host,\n        Port: port,\n        // CORS: this.options.cors?.enabled && this.options.cors?..length > 0 ? this.options.corsUrls.join(', ') : 'Disabled',\n        CORS: this.options.cors?.enabled ? this.options.cors.urls.join(', ') : 'Disabled',\n        'Fastify Version': this.fastifyServer.version,\n      });\n    }\n  }\n\n  private async onRequest(request: FastifyRequest): Promise<void> {\n    if (\n      this.options.debug?.simulateSlowConnection?.enabled &&\n      this.options.debug?.simulateSlowConnection?.delay &&\n      this.options.debug?.simulateSlowConnection?.delay > 0\n    ) {\n      await new Promise(resolve => setTimeout(resolve, this.options.debug?.simulateSlowConnection?.delay));\n    }\n\n    // Generate or use existing request ID for correlation\n    const requestId = (request.headers['x-request-id'] as string | undefined) ?? crypto.randomUUID();\n    request.requestId = requestId;\n\n    // Default health check paths to ignore from logging\n    const defaultPathsToIgnore: string[] = [];\n    const configuredExcludePaths = this.options.log?.excludePaths ?? [];\n    const pathsToIgnore = [...defaultPathsToIgnore, ...configuredExcludePaths];\n\n    if (pathsToIgnore.includes(request.url) || request.method === 'OPTIONS') {\n      // ...\n    } else {\n      const startTime = Time.now();\n      request.startTime = startTime;\n\n      // Initialize AsyncLocalStorage context for this request\n      // Using enterWith() to set context for the current async execution\n      enterRequestContext({ requestId, startTime });\n    }\n  }\n\n  private async onResponse(request: FastifyRequest, reply: FastifyReply): Promise<void> {\n    // Add request ID to response headers for client-side correlation\n    if (request.requestId) {\n      reply.header('X-Request-ID', request.requestId);\n    }\n\n    if (!request.startTime) {\n      return;\n    }\n\n    const executionTime = Time.calculateElapsedTimeMs({\n      startTime: request.startTime,\n    });\n    const formattedExecutionTime = Time.formatTime({\n      time: executionTime,\n      numDecimals: 3,\n    });\n\n    const ip = request.headers['x-forwarded-for'] ?? request.ip;\n\n    const logParams: Record<string, unknown> = {\n      Method: request.method,\n      Path: request.url,\n      Status: reply.statusCode,\n    };\n\n    if (process.env.NODE_ENV !== 'development') {\n      logParams.IP = ip.toString();\n    }\n\n    logParams.Time = formattedExecutionTime;\n\n    // if (cluster.isWorker && cluster.worker) {\n    //   logParams.Worker = cluster.worker.id;\n    // }\n\n    this.log('API Request', logParams);\n  }\n\n  private async onError(request: FastifyRequest, reply: FastifyReply, error: Error): Promise<void> {\n    // Adjusted for Fastify types\n    Logger.error({ error });\n    // Implement any additional logic here\n  }\n\n  private async onClose(): Promise<void> {\n    this.log('Stopped');\n  }\n\n  private configureCORS(): void {\n    if (!this.options.cors?.enabled) {\n      return;\n    }\n\n    // Handle wildcard origin for development\n    const origin = this.options.cors.urls.includes('*') ? true : this.options.cors.urls;\n\n    this.fastifyServer.register(cors, {\n      origin,\n      methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],\n      allowedHeaders: ['Content-Type', 'Authorization'],\n      preflightContinue: false,\n      optionsSuccessStatus: 204,\n      // credentials: true,\n    });\n  }\n\n  private configureMultipartUploads(): void {\n    this.fastifyServer.register(multipart, {\n      // attachFieldsToBody: true,\n      limits: {\n        fieldNameSize: 100,\n        fieldSize: 1024 * 1024 * 10,\n        fields: 10,\n        fileSize: 1024 * 1024 * 1024 * 10, // 10GB file size limit\n        files: 1,\n        headerPairs: 2000,\n      },\n    });\n  }\n\n  /**\n   * Configure routes.\n   */\n  private async configureRoutes(): Promise<void> {\n    if (this.options.routesDirectory && this.explicitRoutesConfigured) {\n      const baseMessage =\n        'Invalid web server configuration: choose either \"routesDirectory\" for automatic discovery or provide a \"routes\" array.';\n      const guidance =\n        this.routes.length === 0\n          ? ' Remove the empty routes array when using \"routesDirectory\".'\n          : ' Remove one of these options so only a single routes source is configured.';\n\n      throw new Error(`${baseMessage}${guidance}`);\n    }\n\n    await this.loadRoutesFromDirectory();\n\n    // Check if controllers directory exists\n    const controllersDirectoryExists = await File.pathExists(this.options.controllersDirectory ?? '');\n\n    if (!controllersDirectoryExists) {\n      const routesRequiringControllers = this.routes.length === 0 || this.routes.some(route => !route.handler);\n\n      if (routesRequiringControllers) {\n        Logger.warn({\n          message: 'Web server controllers directory not found',\n          meta: {\n            Directory: this.options.controllersDirectory,\n          },\n        });\n\n        return;\n      }\n    }\n\n    // Load controllers\n    const controllers = controllersDirectoryExists\n      ? await Loader.loadModulesInDirectory({\n          directory: this.options.controllersDirectory,\n          extensions: ['.ts', '.js'],\n        })\n      : {};\n\n    // Add health check routes\n    this.routes.push(\n      {\n        type: WebServerRouteType.Default,\n        method: 'GET',\n        path: '/health/live',\n        controller: WebServerHealthController,\n        action: 'live',\n      },\n      {\n        type: WebServerRouteType.Default,\n        method: 'GET',\n        path: '/health/ready',\n        controller: WebServerHealthController,\n        action: 'ready',\n      },\n    );\n\n    // Go through each route\n    for (const route of this.routes) {\n      let ControllerClass: WebServerBaseControllerType;\n\n      let controllerName;\n\n      if (route.handler && !route.controller && !route.controllerName) {\n        if (route.type && route.type !== WebServerRouteType.Default) {\n          throw new Error('Handler-only routes are only supported for default route type');\n        }\n\n        if (!('method' in route)) {\n          throw new Error('Handler-only routes require an HTTP method');\n        }\n\n        const schema = this.buildFastifySchema(route.schema);\n\n        this.fastifyServer.route({\n          method: route.method,\n          url: route.path,\n          handler: route.handler,\n          ...(schema ? { schema } : {}),\n        });\n\n        continue;\n      }\n\n      if (route.controller) {\n        ControllerClass = route.controller;\n\n        controllerName = ControllerClass.name;\n      } else if (route.controllerName) {\n        ControllerClass = controllers[route.controllerName] as WebServerBaseControllerType;\n\n        controllerName = route.controllerName;\n      } else {\n        throw new Error('Web server controller config not found');\n      }\n\n      if (typeof ControllerClass !== 'function') {\n        const controllerPath = `${this.options.controllersDirectory}/${route.controllerName}.ts`;\n\n        Logger.warn({\n          message: 'Web server controller not found',\n          meta: {\n            Controller: route.controllerName,\n            Path: controllerPath,\n            Route: `${route.path}`,\n          },\n        });\n\n        continue;\n      }\n\n      // Initialize controller instance\n      const controllerInstance = new ControllerClass({\n        applicationConfig: this.applicationConfig,\n        webServerOptions: this.options,\n        redisInstance: this.redisInstance,\n        queueManager: this.queueManager,\n        eventManager: this.eventManager,\n        databaseInstance: this.databaseInstance,\n        lifecycleManager: this.lifecycleManager,\n      });\n\n      let routeMethod;\n      let routeAction;\n      let routePath;\n\n      switch (route.type) {\n        case WebServerRouteType.Default: {\n          routeMethod = route.method;\n          routeAction = route.action;\n          routePath = route.path;\n\n          this.defineRoute({\n            controllerInstance,\n            controllerName,\n            routeMethod,\n            routePath,\n            routeAction,\n            routeSchema: route.schema,\n            handlerOverride: route.handler?.bind(controllerInstance),\n          });\n\n          break;\n        }\n        case WebServerRouteType.Entity: {\n          if (this.applicationConfig.database?.enabled === true) {\n            const entityModel = await Loader.loadEntityModule({\n              entitiesDirectory: this.applicationConfig.database.entitiesDirectory,\n              entityName: route.entityName,\n            });\n\n            const entitySchemaSource = (entityModel as { schema?: { describe?: () => unknown } }).schema;\n\n            if (entitySchemaSource && typeof entitySchemaSource.describe !== 'function') {\n              const reportedType =\n                typeof entitySchemaSource === 'object'\n                  ? (entitySchemaSource?.constructor?.name ?? 'object')\n                  : typeof entitySchemaSource;\n\n              throw new Error(\n                `Entity route auto-validation requires a Joi schema with a describe() method. ` +\n                  `Entity \"${route.entityName}\" provided a ${reportedType}. ` +\n                  `If you're using Zod (schema/schemaUpdate) for this entity, migrate to the new DynamicEntity helpers or ` +\n                  `attach typed route validators instead of relying on WebServerRouteType.Entity auto-validation.`,\n              );\n            }\n\n            const entitySchemaDescription =\n              typeof entitySchemaSource?.describe === 'function'\n                ? (entitySchemaSource.describe() as\n                    | {\n                        keys?: Record<string, { type: string; flags?: { presence?: string }; [key: string]: unknown }>;\n                        [key: string]: unknown;\n                      }\n                    | undefined)\n                : undefined;\n\n            if (\n              entitySchemaSource &&\n              (entitySchemaDescription === undefined ||\n                typeof entitySchemaDescription !== 'object' ||\n                !('keys' in entitySchemaDescription))\n            ) {\n              const detectedType =\n                entitySchemaDescription && typeof entitySchemaDescription === 'object'\n                  ? (entitySchemaDescription.constructor?.name ?? 'object')\n                  : typeof entitySchemaDescription;\n\n              throw new Error(\n                `Entity route auto-validation expected Joi.describe() output with a \"keys\" map, ` +\n                  `but entity \"${route.entityName}\" returned ${detectedType}. ` +\n                  `This usually means the entity uses Zod schemas. ` +\n                  `Switch the entity to use DynamicEntity.defineSchemas or provide Joi-based validation for \"${route.path}\".`,\n              );\n            }\n\n            const schemaKeys = entitySchemaDescription?.keys;\n\n            const formattedEntityValidationSchema =\n              entitySchemaDescription && schemaKeys\n                ? {\n                    type: 'object',\n                    properties: Object.fromEntries(\n                      Object.entries(schemaKeys).map(([key, value]) => [key, { type: value.type }]),\n                    ),\n                    required: Object.keys(schemaKeys).filter(\n                      // Dynamic schema inspection of joi describe output; keys are from trusted entity definitions\n                      // eslint-disable-next-line security/detect-object-injection\n                      key => schemaKeys[key].flags?.presence === 'required',\n                    ),\n                  }\n                : {};\n\n            const entityRouteDefinitions = WebServerUtil.getEntityRouteDefinitions({\n              basePath: route.path,\n              entityValidationSchema: formattedEntityValidationSchema,\n            });\n\n            for (const entityRouteDefinition of entityRouteDefinitions) {\n              this.defineRoute({\n                controllerInstance,\n                controllerName,\n                routeMethod: entityRouteDefinition.method,\n                routePath: entityRouteDefinition.path,\n                routeAction: entityRouteDefinition.action,\n                routeSchema: route.schema,\n                handlerOverride: route.handler?.bind(controllerInstance),\n              });\n            }\n          }\n\n          break;\n        }\n      }\n    }\n\n    if (this.options.debug?.printRoutes) {\n      this.log(`Routes:\\n${this.fastifyServer.printRoutes()}`);\n    }\n  }\n\n  private async loadRoutesFromDirectory(): Promise<void> {\n    const { routesDirectory } = this.options;\n\n    if (!routesDirectory) {\n      return;\n    }\n\n    const directoryExists = await File.pathExists(routesDirectory);\n\n    if (!directoryExists) {\n      this.logger.warn({\n        message: 'Web server routes directory not found',\n        meta: {\n          Directory: routesDirectory,\n        },\n      });\n\n      return;\n    }\n\n    const routeModules = await Loader.loadModulesInDirectory<\n      WebServerRoute | WebServerRoute[] | { routes?: WebServerRoute[] }\n    >({\n      directory: routesDirectory,\n      extensions: ['.ts', '.js'],\n    });\n\n    const loadedRoutes: WebServerRoute[] = [];\n\n    for (const [moduleName, exportedRoutes] of Object.entries(routeModules)) {\n      const normalizedRoutes = this.normalizeRouteExport(exportedRoutes, moduleName);\n\n      if (normalizedRoutes.length === 0) {\n        continue;\n      }\n\n      loadedRoutes.push(...normalizedRoutes);\n    }\n\n    if (loadedRoutes.length > 0) {\n      this.routes.push(...loadedRoutes);\n    }\n  }\n\n  private normalizeRouteExport(exportedValue: unknown, moduleName: string): WebServerRoute[] {\n    const ensureRouteArray = (value: unknown): WebServerRoute[] => {\n      if (Array.isArray(value)) {\n        return value;\n      }\n\n      if (value && typeof value === 'object') {\n        const maybeRoute = value as { routes?: unknown };\n\n        if (Array.isArray(maybeRoute.routes)) {\n          return maybeRoute.routes as WebServerRoute[];\n        }\n      }\n\n      return value ? [value as WebServerRoute] : [];\n    };\n\n    const routeCandidates = ensureRouteArray(exportedValue);\n    const validRoutes: WebServerRoute[] = [];\n\n    for (const [index, candidate] of routeCandidates.entries()) {\n      if (this.isValidRoute(candidate)) {\n        validRoutes.push(candidate);\n      } else {\n        this.logger.warn({\n          message: 'Invalid web server route definition skipped',\n          meta: {\n            Module: moduleName,\n            Index: index,\n          },\n        });\n      }\n    }\n\n    if (validRoutes.length === 0 && routeCandidates.length > 0) {\n      this.logger.warn({\n        message: 'No valid routes exported from module',\n        meta: {\n          Module: moduleName,\n        },\n      });\n    }\n\n    return validRoutes;\n  }\n\n  private isValidRoute(route: unknown): route is WebServerRoute {\n    if (!route || typeof route !== 'object') {\n      return false;\n    }\n\n    const candidate = route as Record<string, unknown>;\n    const routePath = candidate.path;\n\n    if (typeof routePath !== 'string' || routePath.length === 0) {\n      return false;\n    }\n\n    const routeType = candidate.type ?? WebServerRouteType.Default;\n\n    const controllerProvided =\n      typeof candidate.controller === 'function' || typeof candidate.controllerName === 'string';\n    const handlerProvided = typeof candidate.handler === 'function';\n\n    if (routeType === WebServerRouteType.Entity || routeType === 'entity') {\n      return controllerProvided && typeof candidate.entityName === 'string' && candidate.entityName.length > 0;\n    }\n\n    // For default routes, either controller+action OR handler must be provided\n    if (!controllerProvided && !handlerProvided) {\n      return false;\n    }\n\n    const method = candidate.method;\n\n    const isValidMethod =\n      typeof method === 'string' ||\n      (Array.isArray(method) && method.length > 0 && method.every(m => typeof m === 'string'));\n\n    // If handler is provided, we don't need action\n    if (handlerProvided) {\n      return isValidMethod;\n    }\n\n    // If controller is provided, we need action\n    const action = candidate.action;\n    const isValidAction = typeof action === 'string' && action.length > 0;\n\n    return isValidMethod && isValidAction;\n  }\n\n  public async defineRoute({\n    controllerInstance,\n    controllerName,\n    routeMethod,\n    routePath,\n    routeAction,\n    routeSchema,\n    handlerOverride,\n  }: {\n    controllerInstance: any;\n    controllerName: string;\n    routeMethod: HTTPMethods | HTTPMethods[];\n    routePath: string;\n    routeAction?: string;\n    routeSchema?: AnyRouteSchemaDefinition;\n    handlerOverride?: ControllerAction<any>;\n  }): Promise<void> {\n    let handler = handlerOverride;\n\n    if (!handler) {\n      if (!routeAction) {\n        throw new Error('Route action is required when handler override is not provided');\n      }\n\n      if (!/^[A-Za-z0-9_]+$/.test(routeAction) || ['__proto__', 'prototype', 'constructor'].includes(routeAction)) {\n        throw new Error('Invalid controller action name');\n      }\n\n      const controllerHandler = controllerInstance[routeAction as keyof typeof controllerInstance];\n\n      if (!controllerHandler) {\n        Logger.warn({\n          message: 'Web server controller action not found',\n          meta: {\n            Controller: controllerName,\n            Action: routeAction,\n          },\n        });\n\n        throw new Error('Web server controller action not found');\n      }\n\n      handler = controllerHandler.bind(controllerInstance) as ControllerAction<any>;\n    }\n\n    const fastifySchema = this.buildFastifySchema(routeSchema);\n\n    if (!handler) {\n      throw new Error('Route handler could not be resolved');\n    }\n\n    this.fastifyServer.route({\n      method: routeMethod,\n      url: routePath,\n      handler: handler as unknown as (request: FastifyRequest, reply: FastifyReply) => unknown,\n      ...(fastifySchema ? { schema: fastifySchema } : {}),\n    });\n  }\n\n  /**\n   * Start web server.\n   */\n  public async start(): Promise<void> {\n    try {\n      await this.fastifyServer.listen({\n        host: this.options.host,\n        port: this.options.port,\n      });\n      this._isReady = true;\n    } catch (error) {\n      Logger.error({ error });\n      throw error;\n    }\n  }\n\n  /**\n   * Stop web server.\n   */\n  public async stop(): Promise<void> {\n    this._isReady = false;\n    // Close Fastify server\n    await this.fastifyServer.close();\n  }\n\n  private buildFastifySchema(routeSchema?: AnyRouteSchemaDefinition): FastifySchema | undefined {\n    if (!routeSchema) {\n      return undefined;\n    }\n\n    const schema: FastifySchema = {};\n\n    // With ZodTypeProvider, we can pass Zod schemas directly\n    // The type provider handles validation automatically\n    if (routeSchema.params) {\n      schema.params = routeSchema.params;\n    }\n\n    if (routeSchema.querystring) {\n      schema.querystring = routeSchema.querystring;\n    }\n\n    if (routeSchema.body) {\n      schema.body = routeSchema.body;\n    }\n\n    if (routeSchema.headers) {\n      schema.headers = routeSchema.headers;\n    }\n\n    if (routeSchema.response) {\n      schema.response = routeSchema.response;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Check if web server is ready to accept traffic.\n   */\n  public isReady(): boolean {\n    return this._isReady && this.fastifyServer.server?.listening === true;\n  }\n\n  /**\n   * Log web server message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'webServer', message, meta });\n  }\n}\n\nexport default WebServer;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import crypto from 'node:crypto';\nimport Fastify, {\n  type FastifyInstance,\n  type FastifyReply,\n  type FastifyRequest,\n  type FastifySchema,\n  type HTTPMethods,\n} from 'fastify';\nimport cors from '@fastify/cors';\nimport helmet from '@fastify/helmet';\nimport rateLimit from '@fastify/rate-limit';\nimport multipart from '@fastify/multipart';\nimport {\n  type AnyRouteSchemaDefinition,\n  type WebServerConstructorParams,\n  type WebServerOptions,\n  type WebServerRoute,\n  WebServerRouteType,\n} from './webserver.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { File, Helper, Loader, Time } from '../util/index.js';\nimport WebServerUtil from './util.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { DatabaseInstance } from '../database/index.js';\nimport type { ControllerAction, WebServerBaseControllerType } from './controller/base.interface.js';\nimport type { QueueManager } from '../queue/index.js';\nimport { WebServerHealthController } from '../index.js';\nimport type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\nimport { enterRequestContext } from '../request-context/index.js';\nimport { type ZodTypeProvider, serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    startTime?: number;\n    requestId?: string;\n  }\n}\n\nclass WebServer {\n  private logger: typeof Logger = Logger;\n\n  private applicationConfig: ApplicationConfig;\n\n  private options: WebServerOptions;\n  private routes: WebServerRoute[];\n  private readonly explicitRoutesConfigured: boolean;\n\n  private redisInstance: RedisInstance;\n  private queueManager: QueueManager;\n  private eventManager: EventManager;\n  private databaseInstance: DatabaseInstance;\n\n  public fastifyServer: FastifyInstance<any, any, any, any, ZodTypeProvider>;\n\n  private lifecycleManager: LifecycleManager;\n  private _isReady = false;\n\n  constructor(params: WebServerConstructorParams & { lifecycleManager: LifecycleManager }) {\n    // Define default options\n    const defaultOptions: Partial<WebServerOptions> = {\n      host: '0.0.0.0',\n      port: 3001,\n      cors: {\n        enabled: false,\n      },\n      errors: {\n        verbose: false,\n      },\n      debug: {\n        printRoutes: false,\n        simulateSlowConnection: {\n          enabled: false,\n          delay: 250,\n        },\n      },\n      log: {\n        startUp: true,\n      },\n    };\n\n    // Merge default options\n    const mergedOptions = Helper.defaultsDeep(params.options, defaultOptions);\n\n    this.applicationConfig = params.applicationConfig;\n\n    this.options = mergedOptions;\n\n    const staticRoutes = Array.isArray(params.routes) ? params.routes : [];\n    this.explicitRoutesConfigured = Array.isArray(params.routes);\n    this.routes = [...staticRoutes];\n\n    this.redisInstance = params.redisInstance;\n    this.queueManager = params.queueManager;\n    this.eventManager = params.eventManager;\n    this.databaseInstance = params.databaseInstance;\n    this.lifecycleManager = params.lifecycleManager;\n\n    // Create Fastify server\n    const defaultBodyLimit = 25 * 1024 * 1024; // 25MB (safer default)\n    const defaultConnectionTimeout = 10 * 1000; // 10 seconds (safer default)\n\n    this.fastifyServer = Fastify({\n      logger: false,\n      bodyLimit: this.options.bodyLimit ?? defaultBodyLimit,\n      connectionTimeout: this.options.connectionTimeout ?? defaultConnectionTimeout,\n    }).withTypeProvider<ZodTypeProvider>();\n\n    // Set up Zod validators and serializers for automatic schema validation\n    this.fastifyServer.setValidatorCompiler(validatorCompiler);\n    this.fastifyServer.setSerializerCompiler(serializerCompiler);\n  }\n\n  /**\n   * Load web server.\n   */\n  public async load(): Promise<void> {\n    // Configure security (helmet, rate limiting)\n    await this.configureSecurity();\n\n    // Configure hooks\n    this.configureHooks();\n\n    // Configure CORS\n    this.configureCORS();\n\n    // Configure multipart uploads\n    this.configureMultipartUploads();\n\n    // Configure routes\n    await this.configureRoutes();\n  }\n\n  /**\n   * Configure security features (Helmet, Rate Limiting)\n   */\n  private async configureSecurity(): Promise<void> {\n    const security = this.options.security ?? {};\n\n    // Configure Helmet for security headers\n    const helmetConfig = security.helmet ?? { enabled: true };\n    if (helmetConfig.enabled !== false) {\n      await this.fastifyServer.register(helmet, {\n        contentSecurityPolicy: helmetConfig.contentSecurityPolicy !== false,\n        crossOriginEmbedderPolicy: helmetConfig.crossOriginEmbedderPolicy !== false,\n        crossOriginOpenerPolicy: helmetConfig.crossOriginOpenerPolicy !== false,\n        crossOriginResourcePolicy: helmetConfig.crossOriginResourcePolicy !== false,\n        dnsPrefetchControl: helmetConfig.dnsPrefetchControl !== false,\n        frameguard: helmetConfig.frameguard !== false,\n        hidePoweredBy: helmetConfig.hidePoweredBy !== false,\n        hsts: helmetConfig.hsts !== false,\n        ieNoOpen: helmetConfig.ieNoOpen !== false,\n        noSniff: helmetConfig.noSniff !== false,\n        originAgentCluster: helmetConfig.originAgentCluster !== false,\n        permittedCrossDomainPolicies: helmetConfig.permittedCrossDomainPolicies !== false,\n        referrerPolicy: helmetConfig.referrerPolicy !== false,\n        xssFilter: helmetConfig.xssFilter !== false,\n      });\n    }\n\n    // Configure rate limiting\n    const rateLimitConfig = security.rateLimit ?? { enabled: true };\n    if (rateLimitConfig.enabled !== false) {\n      await this.fastifyServer.register(rateLimit, {\n        max: rateLimitConfig.max ?? 1000,\n        timeWindow: rateLimitConfig.timeWindow ?? '1 minute',\n        ban: rateLimitConfig.ban,\n        cache: rateLimitConfig.cache ?? 5000,\n      });\n    }\n\n    // Warn about wildcard CORS in production\n    if (process.env.NODE_ENV === 'production' && this.options.cors?.enabled) {\n      const corsConfig = this.options.cors as { enabled: true; urls: string[] };\n      if (corsConfig.urls?.includes('*')) {\n        this.logger.warn({\n          message: 'Wildcard CORS (*) is enabled in production - this is a security risk',\n          meta: {\n            recommendation: 'Specify allowed origins explicitly',\n          },\n        });\n      }\n    }\n  }\n\n  /**\n   * Configure hooks.\n   */\n  private configureHooks(): void {\n    this.fastifyServer.addHook('onListen', async () => this.onListen());\n    this.fastifyServer.addHook('onRequest', async request => this.onRequest(request));\n    this.fastifyServer.addHook('onResponse', async (request, reply) => this.onResponse(request, reply));\n    this.fastifyServer.addHook('onError', async (request, reply, error) => this.onError(request, reply, error));\n    this.fastifyServer.addHook('onClose', async () => this.onClose());\n\n    // if (process.env.NODE_ENV === 'local') {\n    //   this.fastifyServer.addHook('onSend', (request, reply, payload, done) => {\n    //     reply.header('Cache-Control', 'no-store');\n    //     done();\n    //   });\n    // }\n  }\n\n  private async onListen(): Promise<void> {\n    const address = this.fastifyServer.server.address();\n    const port = typeof address === 'string' ? address : address?.port;\n\n    if (this.options.log?.startUp) {\n      this.log('Started', {\n        Host: this.options.host,\n        Port: port,\n        // CORS: this.options.cors?.enabled && this.options.cors?..length > 0 ? this.options.corsUrls.join(', ') : 'Disabled',\n        CORS: this.options.cors?.enabled ? this.options.cors.urls.join(', ') : 'Disabled',\n        'Fastify Version': this.fastifyServer.version,\n      });\n    }\n  }\n\n  private async onRequest(request: FastifyRequest): Promise<void> {\n    if (\n      this.options.debug?.simulateSlowConnection?.enabled &&\n      this.options.debug?.simulateSlowConnection?.delay &&\n      this.options.debug?.simulateSlowConnection?.delay > 0\n    ) {\n      await new Promise(resolve => setTimeout(resolve, this.options.debug?.simulateSlowConnection?.delay));\n    }\n\n    // Generate or use existing request ID for correlation\n    const requestId = (request.headers['x-request-id'] as string | undefined) ?? crypto.randomUUID();\n    request.requestId = requestId;\n\n    // Default health check paths to ignore from logging\n    const defaultPathsToIgnore: string[] = [];\n    const configuredExcludePaths = this.options.log?.excludePaths ?? [];\n    const pathsToIgnore = [...defaultPathsToIgnore, ...configuredExcludePaths];\n\n    if (pathsToIgnore.includes(request.url) || request.method === 'OPTIONS') {\n      // ...\n    } else {\n      const startTime = Time.now();\n      request.startTime = startTime;\n\n      // Initialize AsyncLocalStorage context for this request\n      // Using enterWith() to set context for the current async execution\n      enterRequestContext({ requestId, startTime });\n    }\n  }\n\n  private async onResponse(request: FastifyRequest, reply: FastifyReply): Promise<void> {\n    // Add request ID to response headers for client-side correlation\n    if (request.requestId) {\n      reply.header('X-Request-ID', request.requestId);\n    }\n\n    // Clean up request-scoped EntityManager if it exists\n    const em = (request as any).__entityManager;\n    if (em && typeof em.clear === 'function') {\n      em.clear();\n      delete (request as any).__entityManager;\n    }\n\n    if (!request.startTime) {\n      return;\n    }\n\n    const executionTime = Time.calculateElapsedTimeMs({\n      startTime: request.startTime,\n    });\n    const formattedExecutionTime = Time.formatTime({\n      time: executionTime,\n      numDecimals: 3,\n    });\n\n    const ip = request.headers['x-forwarded-for'] ?? request.ip;\n\n    const logParams: Record<string, unknown> = {\n      Method: request.method,\n      Path: request.url,\n      Status: reply.statusCode,\n    };\n\n    if (process.env.NODE_ENV !== 'development') {\n      logParams.IP = ip.toString();\n    }\n\n    logParams.Time = formattedExecutionTime;\n\n    // if (cluster.isWorker && cluster.worker) {\n    //   logParams.Worker = cluster.worker.id;\n    // }\n\n    this.log('API Request', logParams);\n  }\n\n  private async onError(request: FastifyRequest, reply: FastifyReply, error: Error): Promise<void> {\n    // Adjusted for Fastify types\n    Logger.error({ error });\n    // Implement any additional logic here\n  }\n\n  private async onClose(): Promise<void> {\n    this.log('Stopped');\n  }\n\n  private configureCORS(): void {\n    if (!this.options.cors?.enabled) {\n      return;\n    }\n\n    // Handle wildcard origin for development\n    const origin = this.options.cors.urls.includes('*') ? true : this.options.cors.urls;\n\n    this.fastifyServer.register(cors, {\n      origin,\n      methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],\n      allowedHeaders: ['Content-Type', 'Authorization'],\n      preflightContinue: false,\n      optionsSuccessStatus: 204,\n      // credentials: true,\n    });\n  }\n\n  private configureMultipartUploads(): void {\n    this.fastifyServer.register(multipart, {\n      // attachFieldsToBody: true,\n      limits: {\n        fieldNameSize: 100,\n        fieldSize: 1024 * 1024 * 10,\n        fields: 10,\n        fileSize: 1024 * 1024 * 1024 * 10, // 10GB file size limit\n        files: 1,\n        headerPairs: 2000,\n      },\n    });\n  }\n\n  /**\n   * Configure routes.\n   */\n  private async configureRoutes(): Promise<void> {\n    if (this.options.routesDirectory && this.explicitRoutesConfigured) {\n      const baseMessage =\n        'Invalid web server configuration: choose either \"routesDirectory\" for automatic discovery or provide a \"routes\" array.';\n      const guidance =\n        this.routes.length === 0\n          ? ' Remove the empty routes array when using \"routesDirectory\".'\n          : ' Remove one of these options so only a single routes source is configured.';\n\n      throw new Error(`${baseMessage}${guidance}`);\n    }\n\n    await this.loadRoutesFromDirectory();\n\n    // Check if controllers directory exists\n    const controllersDirectoryExists = await File.pathExists(this.options.controllersDirectory ?? '');\n\n    if (!controllersDirectoryExists) {\n      const routesRequiringControllers = this.routes.length === 0 || this.routes.some(route => !route.handler);\n\n      if (routesRequiringControllers) {\n        Logger.warn({\n          message: 'Web server controllers directory not found',\n          meta: {\n            Directory: this.options.controllersDirectory,\n          },\n        });\n\n        return;\n      }\n    }\n\n    // Load controllers\n    const controllers = controllersDirectoryExists\n      ? await Loader.loadModulesInDirectory({\n          directory: this.options.controllersDirectory,\n          extensions: ['.ts', '.js'],\n        })\n      : {};\n\n    // Add health check routes\n    this.routes.push(\n      {\n        type: WebServerRouteType.Default,\n        method: 'GET',\n        path: '/health/live',\n        controller: WebServerHealthController,\n        action: 'live',\n      },\n      {\n        type: WebServerRouteType.Default,\n        method: 'GET',\n        path: '/health/ready',\n        controller: WebServerHealthController,\n        action: 'ready',\n      },\n    );\n\n    // Go through each route\n    for (const route of this.routes) {\n      let ControllerClass: WebServerBaseControllerType;\n\n      let controllerName;\n\n      if (route.handler && !route.controller && !route.controllerName) {\n        if (route.type && route.type !== WebServerRouteType.Default) {\n          throw new Error('Handler-only routes are only supported for default route type');\n        }\n\n        if (!('method' in route)) {\n          throw new Error('Handler-only routes require an HTTP method');\n        }\n\n        const schema = this.buildFastifySchema(route.schema);\n\n        this.fastifyServer.route({\n          method: route.method,\n          url: route.path,\n          handler: route.handler,\n          ...(schema ? { schema } : {}),\n        });\n\n        continue;\n      }\n\n      if (route.controller) {\n        ControllerClass = route.controller;\n\n        controllerName = ControllerClass.name;\n      } else if (route.controllerName) {\n        ControllerClass = controllers[route.controllerName] as WebServerBaseControllerType;\n\n        controllerName = route.controllerName;\n      } else {\n        throw new Error('Web server controller config not found');\n      }\n\n      if (typeof ControllerClass !== 'function') {\n        const controllerPath = `${this.options.controllersDirectory}/${route.controllerName}.ts`;\n\n        Logger.warn({\n          message: 'Web server controller not found',\n          meta: {\n            Controller: route.controllerName,\n            Path: controllerPath,\n            Route: `${route.path}`,\n          },\n        });\n\n        continue;\n      }\n\n      // Initialize controller instance\n      const controllerInstance = new ControllerClass({\n        applicationConfig: this.applicationConfig,\n        webServerOptions: this.options,\n        redisInstance: this.redisInstance,\n        queueManager: this.queueManager,\n        eventManager: this.eventManager,\n        databaseInstance: this.databaseInstance,\n        lifecycleManager: this.lifecycleManager,\n      });\n\n      let routeMethod;\n      let routeAction;\n      let routePath;\n\n      switch (route.type) {\n        case WebServerRouteType.Default: {\n          routeMethod = route.method;\n          routeAction = route.action;\n          routePath = route.path;\n\n          this.defineRoute({\n            controllerInstance,\n            controllerName,\n            routeMethod,\n            routePath,\n            routeAction,\n            routeSchema: route.schema,\n            handlerOverride: route.handler?.bind(controllerInstance),\n          });\n\n          break;\n        }\n        case WebServerRouteType.Entity: {\n          if (this.applicationConfig.database?.enabled === true) {\n            const entityModel = await Loader.loadEntityModule({\n              entitiesDirectory: this.applicationConfig.database.entitiesDirectory,\n              entityName: route.entityName,\n            });\n\n            const entitySchemaSource = (entityModel as { schema?: { describe?: () => unknown } }).schema;\n\n            if (entitySchemaSource && typeof entitySchemaSource.describe !== 'function') {\n              const reportedType =\n                typeof entitySchemaSource === 'object'\n                  ? (entitySchemaSource?.constructor?.name ?? 'object')\n                  : typeof entitySchemaSource;\n\n              throw new Error(\n                `Entity route auto-validation requires a Joi schema with a describe() method. ` +\n                  `Entity \"${route.entityName}\" provided a ${reportedType}. ` +\n                  `If you're using Zod (schema/schemaUpdate) for this entity, migrate to the new DynamicEntity helpers or ` +\n                  `attach typed route validators instead of relying on WebServerRouteType.Entity auto-validation.`,\n              );\n            }\n\n            const entitySchemaDescription =\n              typeof entitySchemaSource?.describe === 'function'\n                ? (entitySchemaSource.describe() as\n                    | {\n                        keys?: Record<string, { type: string; flags?: { presence?: string }; [key: string]: unknown }>;\n                        [key: string]: unknown;\n                      }\n                    | undefined)\n                : undefined;\n\n            if (\n              entitySchemaSource &&\n              (entitySchemaDescription === undefined ||\n                typeof entitySchemaDescription !== 'object' ||\n                !('keys' in entitySchemaDescription))\n            ) {\n              const detectedType =\n                entitySchemaDescription && typeof entitySchemaDescription === 'object'\n                  ? (entitySchemaDescription.constructor?.name ?? 'object')\n                  : typeof entitySchemaDescription;\n\n              throw new Error(\n                `Entity route auto-validation expected Joi.describe() output with a \"keys\" map, ` +\n                  `but entity \"${route.entityName}\" returned ${detectedType}. ` +\n                  `This usually means the entity uses Zod schemas. ` +\n                  `Switch the entity to use DynamicEntity.defineSchemas or provide Joi-based validation for \"${route.path}\".`,\n              );\n            }\n\n            const schemaKeys = entitySchemaDescription?.keys;\n\n            const formattedEntityValidationSchema =\n              entitySchemaDescription && schemaKeys\n                ? {\n                    type: 'object',\n                    properties: Object.fromEntries(\n                      Object.entries(schemaKeys).map(([key, value]) => [key, { type: value.type }]),\n                    ),\n                    required: Object.keys(schemaKeys).filter(\n                      // Dynamic schema inspection of joi describe output; keys are from trusted entity definitions\n                      // eslint-disable-next-line security/detect-object-injection\n                      key => schemaKeys[key].flags?.presence === 'required',\n                    ),\n                  }\n                : {};\n\n            const entityRouteDefinitions = WebServerUtil.getEntityRouteDefinitions({\n              basePath: route.path,\n              entityValidationSchema: formattedEntityValidationSchema,\n            });\n\n            for (const entityRouteDefinition of entityRouteDefinitions) {\n              this.defineRoute({\n                controllerInstance,\n                controllerName,\n                routeMethod: entityRouteDefinition.method,\n                routePath: entityRouteDefinition.path,\n                routeAction: entityRouteDefinition.action,\n                routeSchema: route.schema,\n                handlerOverride: route.handler?.bind(controllerInstance),\n              });\n            }\n          }\n\n          break;\n        }\n      }\n    }\n\n    if (this.options.debug?.printRoutes) {\n      this.log(`Routes:\\n${this.fastifyServer.printRoutes()}`);\n    }\n  }\n\n  private async loadRoutesFromDirectory(): Promise<void> {\n    const { routesDirectory } = this.options;\n\n    if (!routesDirectory) {\n      return;\n    }\n\n    const directoryExists = await File.pathExists(routesDirectory);\n\n    if (!directoryExists) {\n      this.logger.warn({\n        message: 'Web server routes directory not found',\n        meta: {\n          Directory: routesDirectory,\n        },\n      });\n\n      return;\n    }\n\n    const routeModules = await Loader.loadModulesInDirectory<\n      WebServerRoute | WebServerRoute[] | { routes?: WebServerRoute[] }\n    >({\n      directory: routesDirectory,\n      extensions: ['.ts', '.js'],\n    });\n\n    const loadedRoutes: WebServerRoute[] = [];\n\n    for (const [moduleName, exportedRoutes] of Object.entries(routeModules)) {\n      const normalizedRoutes = this.normalizeRouteExport(exportedRoutes, moduleName);\n\n      if (normalizedRoutes.length === 0) {\n        continue;\n      }\n\n      loadedRoutes.push(...normalizedRoutes);\n    }\n\n    if (loadedRoutes.length > 0) {\n      this.routes.push(...loadedRoutes);\n    }\n  }\n\n  private normalizeRouteExport(exportedValue: unknown, moduleName: string): WebServerRoute[] {\n    const ensureRouteArray = (value: unknown): WebServerRoute[] => {\n      if (Array.isArray(value)) {\n        return value;\n      }\n\n      if (value && typeof value === 'object') {\n        const maybeRoute = value as { routes?: unknown };\n\n        if (Array.isArray(maybeRoute.routes)) {\n          return maybeRoute.routes as WebServerRoute[];\n        }\n      }\n\n      return value ? [value as WebServerRoute] : [];\n    };\n\n    const routeCandidates = ensureRouteArray(exportedValue);\n    const validRoutes: WebServerRoute[] = [];\n\n    for (const [index, candidate] of routeCandidates.entries()) {\n      if (this.isValidRoute(candidate)) {\n        validRoutes.push(candidate);\n      } else {\n        this.logger.warn({\n          message: 'Invalid web server route definition skipped',\n          meta: {\n            Module: moduleName,\n            Index: index,\n          },\n        });\n      }\n    }\n\n    if (validRoutes.length === 0 && routeCandidates.length > 0) {\n      this.logger.warn({\n        message: 'No valid routes exported from module',\n        meta: {\n          Module: moduleName,\n        },\n      });\n    }\n\n    return validRoutes;\n  }\n\n  private isValidRoute(route: unknown): route is WebServerRoute {\n    if (!route || typeof route !== 'object') {\n      return false;\n    }\n\n    const candidate = route as Record<string, unknown>;\n    const routePath = candidate.path;\n\n    if (typeof routePath !== 'string' || routePath.length === 0) {\n      return false;\n    }\n\n    const routeType = candidate.type ?? WebServerRouteType.Default;\n\n    const controllerProvided =\n      typeof candidate.controller === 'function' || typeof candidate.controllerName === 'string';\n    const handlerProvided = typeof candidate.handler === 'function';\n\n    if (routeType === WebServerRouteType.Entity || routeType === 'entity') {\n      return controllerProvided && typeof candidate.entityName === 'string' && candidate.entityName.length > 0;\n    }\n\n    // For default routes, either controller+action OR handler must be provided\n    if (!controllerProvided && !handlerProvided) {\n      return false;\n    }\n\n    const method = candidate.method;\n\n    const isValidMethod =\n      typeof method === 'string' ||\n      (Array.isArray(method) && method.length > 0 && method.every(m => typeof m === 'string'));\n\n    // If handler is provided, we don't need action\n    if (handlerProvided) {\n      return isValidMethod;\n    }\n\n    // If controller is provided, we need action\n    const action = candidate.action;\n    const isValidAction = typeof action === 'string' && action.length > 0;\n\n    return isValidMethod && isValidAction;\n  }\n\n  public async defineRoute({\n    controllerInstance,\n    controllerName,\n    routeMethod,\n    routePath,\n    routeAction,\n    routeSchema,\n    handlerOverride,\n  }: {\n    controllerInstance: any;\n    controllerName: string;\n    routeMethod: HTTPMethods | HTTPMethods[];\n    routePath: string;\n    routeAction?: string;\n    routeSchema?: AnyRouteSchemaDefinition;\n    handlerOverride?: ControllerAction<any>;\n  }): Promise<void> {\n    let handler = handlerOverride;\n\n    if (!handler) {\n      if (!routeAction) {\n        throw new Error('Route action is required when handler override is not provided');\n      }\n\n      if (!/^[A-Za-z0-9_]+$/.test(routeAction) || ['__proto__', 'prototype', 'constructor'].includes(routeAction)) {\n        throw new Error('Invalid controller action name');\n      }\n\n      const controllerHandler = controllerInstance[routeAction as keyof typeof controllerInstance];\n\n      if (!controllerHandler) {\n        Logger.warn({\n          message: 'Web server controller action not found',\n          meta: {\n            Controller: controllerName,\n            Action: routeAction,\n          },\n        });\n\n        throw new Error('Web server controller action not found');\n      }\n\n      handler = controllerHandler.bind(controllerInstance) as ControllerAction<any>;\n    }\n\n    const fastifySchema = this.buildFastifySchema(routeSchema);\n\n    if (!handler) {\n      throw new Error('Route handler could not be resolved');\n    }\n\n    this.fastifyServer.route({\n      method: routeMethod,\n      url: routePath,\n      handler: handler as unknown as (request: FastifyRequest, reply: FastifyReply) => unknown,\n      ...(fastifySchema ? { schema: fastifySchema } : {}),\n    });\n  }\n\n  /**\n   * Start web server.\n   */\n  public async start(): Promise<void> {\n    try {\n      await this.fastifyServer.listen({\n        host: this.options.host,\n        port: this.options.port,\n      });\n      this._isReady = true;\n    } catch (error) {\n      Logger.error({ error });\n      throw error;\n    }\n  }\n\n  /**\n   * Stop web server.\n   */\n  public async stop(): Promise<void> {\n    this._isReady = false;\n    // Close Fastify server\n    await this.fastifyServer.close();\n  }\n\n  private buildFastifySchema(routeSchema?: AnyRouteSchemaDefinition): FastifySchema | undefined {\n    if (!routeSchema) {\n      return undefined;\n    }\n\n    const schema: FastifySchema = {};\n\n    // With ZodTypeProvider, we can pass Zod schemas directly\n    // The type provider handles validation automatically\n    if (routeSchema.params) {\n      schema.params = routeSchema.params;\n    }\n\n    if (routeSchema.querystring) {\n      schema.querystring = routeSchema.querystring;\n    }\n\n    if (routeSchema.body) {\n      schema.body = routeSchema.body;\n    }\n\n    if (routeSchema.headers) {\n      schema.headers = routeSchema.headers;\n    }\n\n    if (routeSchema.response) {\n      schema.response = routeSchema.response;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Check if web server is ready to accept traffic.\n   */\n  public isReady(): boolean {\n    return this._isReady && this.fastifyServer.server?.listening === true;\n  }\n\n  /**\n   * Log web server message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'webServer', message, meta });\n  }\n}\n\nexport default WebServer;\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/websocket/controller/server/base.d.ts

@@ -3,6 +3,38 @@ import type QueueManager from '../../../queue/manager.js';
 import type { RedisInstance } from '../../../redis/index.js';
 import type WebSocketServer from '../../websocket-server.js';
 import type { WebSocketServerBaseControllerConstructorParams } from './base.interface.js';
+/**
+ * Base WebSocket Server Controller
+ *
+ * ⚠️ IMPORTANT MEMORY MANAGEMENT:
+ *
+ * WebSocket controllers are LONG-LIVED SINGLETONS - one instance handles
+ * ALL client connections and messages throughout the application lifetime.
+ *
+ * ❌ WRONG - Memory Leak:
+ * ```typescript
+ * class MyController extends WebSocketServerBaseController {
+ *   private em = this.databaseInstance.getEntityManager(); // LEAK!
+ *   async handleMessage(ws, data) {
+ *     await this.em.findOne('User', { id: data.userId }); // Identity map grows forever
+ *   }
+ * }
+ * ```
+ *
+ * ✅ CORRECT - Per-message EntityManager:
+ * ```typescript
+ * class MyController extends WebSocketServerBaseController {
+ *   async handleMessage(ws, data) {
+ *     await this.databaseInstance.withEntityManager(async (em) => {
+ *       const user = await em.findOne('User', { id: data.userId });
+ *       // em automatically cleaned up after this block
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @see DatabaseInstance.withEntityManager for safe EntityManager usage
+ */
 export default abstract class WebSocketServerBaseController {
     protected webSocketServer: WebSocketServer;
     protected redisInstance: RedisInstance;

package/dist/websocket/controller/server/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/websocket/controller/server/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,8CAA8C,EAAE,MAAM,qBAAqB,CAAC;AAE1F,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,6BAA6B;IACzD,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAC3C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,EAAE,8CAA8C;CAMlD"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/websocket/controller/server/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,8CAA8C,EAAE,MAAM,qBAAqB,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,6BAA6B;IACzD,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAC3C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,EAAE,8CAA8C;CAMlD"}

package/dist/websocket/controller/server/base.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/websocket/controller/server/base.ts"],
-  "sourcesContent": ["import type DatabaseInstance from '../../../database/instance.js';\nimport type QueueManager from '../../../queue/manager.js';\nimport type { RedisInstance } from '../../../redis/index.js';\nimport type WebSocketServer from '../../websocket-server.js';\nimport type { WebSocketServerBaseControllerConstructorParams } from './base.interface.js';\n\nexport default abstract class WebSocketServerBaseController {\n  protected webSocketServer: WebSocketServer;\n  protected redisInstance: RedisInstance;\n  protected queueManager: QueueManager;\n  protected databaseInstance: DatabaseInstance;\n\n  constructor({\n    webSocketServer,\n    redisInstance,\n    queueManager,\n    databaseInstance,\n  }: WebSocketServerBaseControllerConstructorParams) {\n    this.webSocketServer = webSocketServer;\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.databaseInstance = databaseInstance;\n  }\n}\n"],
-  "mappings": ";;AAMA,MAAO,8BAAqD;AAAA,EAN5D,OAM4D;AAAA;AAAA;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEV,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAmD;AACjD,SAAK,kBAAkB;AACvB,SAAK,gBAAgB;AACrB,SAAK,eAAe;AACpB,SAAK,mBAAmB;AAAA,EAC1B;AACF;",
+  "sourcesContent": ["import type DatabaseInstance from '../../../database/instance.js';\nimport type QueueManager from '../../../queue/manager.js';\nimport type { RedisInstance } from '../../../redis/index.js';\nimport type WebSocketServer from '../../websocket-server.js';\nimport type { WebSocketServerBaseControllerConstructorParams } from './base.interface.js';\n\n/**\n * Base WebSocket Server Controller\n *\n * \u26A0\uFE0F IMPORTANT MEMORY MANAGEMENT:\n *\n * WebSocket controllers are LONG-LIVED SINGLETONS - one instance handles\n * ALL client connections and messages throughout the application lifetime.\n *\n * \u274C WRONG - Memory Leak:\n * ```typescript\n * class MyController extends WebSocketServerBaseController {\n *   private em = this.databaseInstance.getEntityManager(); // LEAK!\n *   async handleMessage(ws, data) {\n *     await this.em.findOne('User', { id: data.userId }); // Identity map grows forever\n *   }\n * }\n * ```\n *\n * \u2705 CORRECT - Per-message EntityManager:\n * ```typescript\n * class MyController extends WebSocketServerBaseController {\n *   async handleMessage(ws, data) {\n *     await this.databaseInstance.withEntityManager(async (em) => {\n *       const user = await em.findOne('User', { id: data.userId });\n *       // em automatically cleaned up after this block\n *     });\n *   }\n * }\n * ```\n *\n * @see DatabaseInstance.withEntityManager for safe EntityManager usage\n */\nexport default abstract class WebSocketServerBaseController {\n  protected webSocketServer: WebSocketServer;\n  protected redisInstance: RedisInstance;\n  protected queueManager: QueueManager;\n  protected databaseInstance: DatabaseInstance;\n\n  constructor({\n    webSocketServer,\n    redisInstance,\n    queueManager,\n    databaseInstance,\n  }: WebSocketServerBaseControllerConstructorParams) {\n    this.webSocketServer = webSocketServer;\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.databaseInstance = databaseInstance;\n  }\n}\n"],
+  "mappings": ";;AAsCA,MAAO,8BAAqD;AAAA,EAtC5D,OAsC4D;AAAA;AAAA;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEV,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAmD;AACjD,SAAK,kBAAkB;AACvB,SAAK,gBAAgB;AACrB,SAAK,eAAe;AACpB,SAAK,mBAAmB;AAAA,EAC1B;AACF;",
   "names": []
 }

package/dist/websocket/websocket-server.js

@@ -937,18 +937,19 @@ class WebSocketServer extends WebSocketBase {
     }
     let userData = {};
     if (userId) {
-      const dbEntityManager = this.databaseInstance.getEntityManager();
-      const getUserQuery = "SELECT email FROM users WHERE id = ?";
-      const getUserParams = [userId];
-      const getUserResult = await dbEntityManager.execute(getUserQuery, getUserParams);
-      if (!getUserResult || getUserResult.length === 0) {
-        throw new Error("User not found in database");
-      }
-      const user = getUserResult[0];
-      userData = {
-        id: userId,
-        ...user
-      };
+      userData = await this.databaseInstance.withEntityManager(async (em) => {
+        const getUserQuery = "SELECT email FROM users WHERE id = ?";
+        const getUserParams = [userId];
+        const getUserResult = await em.execute(getUserQuery, getUserParams);
+        if (!getUserResult || getUserResult.length === 0) {
+          throw new Error("User not found in database");
+        }
+        const user = getUserResult[0];
+        return {
+          id: userId,
+          ...user
+        };
+      });
     }
     if (username) {
       userData.username = username;