@scpxl/nodejs-framework 1.0.20 → 1.0.24

package/dist/webserver/controller/base.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/webserver/controller/base.ts"],
-  "sourcesContent": ["import { StatusCodes } from 'http-status-codes';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { QueueManager } from '../../queue/index.js';\nimport type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport type EventManager from '../../event/manager.js';\nimport cluster from 'cluster';\nimport type { WebServerOptions } from '../webserver.interface.js';\nimport type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';\nimport Jwt from '../../auth/jwt.js';\n\nexport interface AuthenticatedUser {\n  userId: number;\n  payload: any;\n}\n\nexport default abstract class BaseController {\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n  protected webServerOptions: WebServerOptions;\n\n  protected redisInstance: RedisInstance;\n  protected queueManager: QueueManager;\n  protected eventManager: EventManager;\n  protected databaseInstance: DatabaseInstance;\n  protected lifecycleManager: LifecycleManager;\n\n  constructor({\n    applicationConfig,\n    webServerOptions,\n    redisInstance,\n    queueManager,\n    eventManager,\n    databaseInstance,\n    lifecycleManager,\n  }: WebServerBaseControllerConstructorParams) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n    this.webServerOptions = webServerOptions;\n\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.eventManager = eventManager;\n    this.databaseInstance = databaseInstance;\n    this.lifecycleManager = lifecycleManager;\n  }\n\n  protected sendSuccessResponse<T = any>({\n    reply,\n    data,\n    statusCode = StatusCodes.OK,\n    meta,\n  }: {\n    reply: FastifyReply;\n    data: T;\n    statusCode?: StatusCodes;\n    meta?: ApiResponse<T>['meta'];\n  }) {\n    const response: ApiResponse<T> = {\n      data,\n      meta: {\n        timestamp: new Date().toISOString(),\n        requestId: reply.request.id || 'unknown',\n        ...meta,\n      },\n    };\n    reply.status(statusCode).send(response);\n  }\n\n  protected sendNotFoundResponse(reply: FastifyReply, message: string = 'Resource not found') {\n    const error: ApiError = {\n      message,\n      type: 'not_found',\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n    };\n    const response: ApiResponse = { error };\n    reply.status(StatusCodes.NOT_FOUND).send(response);\n  }\n\n  protected sendErrorResponse({\n    reply,\n    error,\n    statusCode = StatusCodes.BAD_REQUEST,\n    errorType,\n  }: {\n    reply: FastifyReply;\n    error: unknown;\n    statusCode?: StatusCodes;\n    errorType?: ApiError['type'];\n  }) {\n    let publicErrorMessage: string;\n    let errorDetails: any = undefined;\n\n    if (this.webServerOptions.errors?.verbose === true) {\n      if (error instanceof Error) {\n        publicErrorMessage = error.stack ?? error.message;\n        errorDetails = { stack: error.stack, name: error.name };\n      } else {\n        publicErrorMessage = String(error);\n      }\n    } else {\n      if (process.env.NODE_ENV === 'production') {\n        if (error instanceof Error) {\n          publicErrorMessage = 'Something went wrong';\n        } else if (typeof error === 'string') {\n          publicErrorMessage = error;\n        } else {\n          publicErrorMessage = 'An unknown error occurred';\n        }\n      } else {\n        if (error instanceof Error) {\n          publicErrorMessage = error.stack ?? error.message;\n          errorDetails = { stack: error.stack, name: error.name };\n        } else {\n          publicErrorMessage = String(error);\n        }\n      }\n    }\n\n    Logger.custom({ level: 'webServer', message: error });\n    console.error(error);\n\n    const apiError: ApiError = {\n      message: publicErrorMessage,\n      type: errorType ?? this.getErrorType(statusCode),\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n      ...(errorDetails && { details: errorDetails }),\n    };\n\n    const response: ApiResponse = { error: apiError };\n    reply.status(statusCode).send(response);\n  }\n\n  private getErrorType(statusCode: StatusCodes): ApiError['type'] {\n    switch (statusCode) {\n      case StatusCodes.UNAUTHORIZED:\n        return 'authentication';\n      case StatusCodes.FORBIDDEN:\n        return 'authorization';\n      case StatusCodes.NOT_FOUND:\n        return 'not_found';\n      case StatusCodes.BAD_REQUEST:\n      case StatusCodes.UNPROCESSABLE_ENTITY:\n        return 'validation';\n      case StatusCodes.INTERNAL_SERVER_ERROR:\n      case StatusCodes.BAD_GATEWAY:\n      case StatusCodes.SERVICE_UNAVAILABLE:\n        return 'server_error';\n      default:\n        return 'client_error';\n    }\n  }\n\n  protected async authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null> {\n    // Get JWT secret key from application config\n    const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n    if (!jwtSecretKey) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Authentication not configured.',\n        statusCode: StatusCodes.INTERNAL_SERVER_ERROR,\n        errorType: 'server_error',\n      });\n      return null;\n    }\n\n    const authHeader = request.headers.authorization;\n\n    if (!authHeader) {\n      this.sendErrorResponse({\n        reply,\n        error: 'No token provided.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    if (!authHeader.startsWith('Bearer ')) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    try {\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Remove \"Bearer \" from token\n      const jwtAccessToken = authHeader.substring(7);\n\n      const { payload } = await Jwt.jwtVerify(jwtAccessToken, importedJwtSecretKey);\n\n      if (!payload.sub) {\n        this.sendErrorResponse({\n          reply,\n          error: 'Invalid token payload.',\n          statusCode: StatusCodes.UNAUTHORIZED,\n          errorType: 'authentication',\n        });\n        return null;\n      }\n\n      const userId = parseInt(payload.sub);\n\n      return {\n        userId,\n        payload,\n      };\n    } catch {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid or expired token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { StatusCodes } from 'http-status-codes';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { QueueManager } from '../../queue/index.js';\nimport type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport type EventManager from '../../event/manager.js';\nimport cluster from 'cluster';\nimport type { WebServerOptions } from '../webserver.interface.js';\nimport type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';\nimport Jwt from '../../auth/jwt.js';\n\nexport interface AuthenticatedUser<TPayload = Record<string, unknown>> {\n  userId: number;\n  payload: TPayload;\n}\n\nexport default abstract class BaseController<\n  TQueueManager extends QueueManager = QueueManager,\n  TRedisInstance extends RedisInstance = RedisInstance,\n  TEventManager extends EventManager = EventManager,\n  TDatabaseInstance extends DatabaseInstance = DatabaseInstance,\n> {\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n  protected webServerOptions: WebServerOptions;\n\n  protected redisInstance: TRedisInstance;\n  protected queueManager: TQueueManager;\n  protected eventManager: TEventManager;\n  protected databaseInstance: TDatabaseInstance;\n  protected lifecycleManager: LifecycleManager;\n\n  constructor({\n    applicationConfig,\n    webServerOptions,\n    redisInstance,\n    queueManager,\n    eventManager,\n    databaseInstance,\n    lifecycleManager,\n  }: WebServerBaseControllerConstructorParams<TQueueManager, TRedisInstance, TEventManager, TDatabaseInstance>) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n    this.webServerOptions = webServerOptions;\n\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.eventManager = eventManager;\n    this.databaseInstance = databaseInstance;\n    this.lifecycleManager = lifecycleManager;\n  }\n\n  protected sendSuccessResponse<T = unknown>({\n    reply,\n    data,\n    statusCode = StatusCodes.OK,\n    meta,\n  }: {\n    reply: FastifyReply;\n    data: T;\n    statusCode?: StatusCodes;\n    meta?: ApiResponse<T>['meta'];\n  }) {\n    const response: ApiResponse<T> = {\n      data,\n      meta: {\n        timestamp: new Date().toISOString(),\n        requestId: reply.request.id || 'unknown',\n        ...meta,\n      },\n    };\n    reply.status(statusCode).send(response);\n  }\n\n  protected sendNotFoundResponse(reply: FastifyReply, message: string = 'Resource not found') {\n    const error: ApiError = {\n      message,\n      type: 'not_found',\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n    };\n    const response: ApiResponse = { error };\n    reply.status(StatusCodes.NOT_FOUND).send(response);\n  }\n\n  protected sendErrorResponse({\n    reply,\n    error,\n    statusCode = StatusCodes.BAD_REQUEST,\n    errorType,\n  }: {\n    reply: FastifyReply;\n    error: unknown;\n    statusCode?: StatusCodes;\n    errorType?: ApiError['type'];\n  }) {\n    let publicErrorMessage: string;\n    let errorDetails: Record<string, unknown> | undefined = undefined;\n\n    if (this.webServerOptions.errors?.verbose === true) {\n      if (error instanceof Error) {\n        publicErrorMessage = error.stack ?? error.message;\n        errorDetails = { stack: error.stack, name: error.name };\n      } else {\n        publicErrorMessage = String(error);\n      }\n    } else {\n      if (process.env.NODE_ENV === 'production') {\n        if (error instanceof Error) {\n          publicErrorMessage = 'Something went wrong';\n        } else if (typeof error === 'string') {\n          publicErrorMessage = error;\n        } else {\n          publicErrorMessage = 'An unknown error occurred';\n        }\n      } else {\n        if (error instanceof Error) {\n          publicErrorMessage = error.stack ?? error.message;\n          errorDetails = { stack: error.stack, name: error.name };\n        } else {\n          publicErrorMessage = String(error);\n        }\n      }\n    }\n\n    Logger.custom({ level: 'webServer', message: error });\n    console.error(error);\n\n    const apiError: ApiError = {\n      message: publicErrorMessage,\n      type: errorType ?? this.getErrorType(statusCode),\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n      ...(errorDetails && { details: errorDetails }),\n    };\n\n    const response: ApiResponse = { error: apiError };\n    reply.status(statusCode).send(response);\n  }\n\n  private getErrorType(statusCode: StatusCodes): ApiError['type'] {\n    switch (statusCode) {\n      case StatusCodes.UNAUTHORIZED:\n        return 'authentication';\n      case StatusCodes.FORBIDDEN:\n        return 'authorization';\n      case StatusCodes.NOT_FOUND:\n        return 'not_found';\n      case StatusCodes.BAD_REQUEST:\n      case StatusCodes.UNPROCESSABLE_ENTITY:\n        return 'validation';\n      case StatusCodes.INTERNAL_SERVER_ERROR:\n      case StatusCodes.BAD_GATEWAY:\n      case StatusCodes.SERVICE_UNAVAILABLE:\n        return 'server_error';\n      default:\n        return 'client_error';\n    }\n  }\n\n  protected async authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null> {\n    // Get JWT secret key from application config\n    const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n    if (!jwtSecretKey) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Authentication not configured.',\n        statusCode: StatusCodes.INTERNAL_SERVER_ERROR,\n        errorType: 'server_error',\n      });\n      return null;\n    }\n\n    const authHeader = request.headers.authorization;\n\n    if (!authHeader) {\n      this.sendErrorResponse({\n        reply,\n        error: 'No token provided.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    if (!authHeader.startsWith('Bearer ')) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    try {\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Remove \"Bearer \" from token\n      const jwtAccessToken = authHeader.substring(7);\n\n      const { payload } = await Jwt.jwtVerify(jwtAccessToken, importedJwtSecretKey);\n\n      if (!payload.sub) {\n        this.sendErrorResponse({\n          reply,\n          error: 'Invalid token payload.',\n          statusCode: StatusCodes.UNAUTHORIZED,\n          errorType: 'authentication',\n        });\n        return null;\n      }\n\n      const userId = parseInt(payload.sub);\n\n      return {\n        userId,\n        payload,\n      };\n    } catch {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid or expired token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/webserver/define-action.d.ts

@@ -0,0 +1,26 @@
+import type { RouteSchemaDefinition } from './webserver.interface.js';
+import type { ControllerAction } from './controller/base.interface.js';
+/**
+ * Define a typed controller action with schema inference.
+ * This helper provides TypeScript type inference for controller methods based on Zod schemas.
+ *
+ * @example
+ * const helloSchema = {
+ *   body: z.object({ name: z.string() }),
+ *   response: { 200: z.object({ message: z.string() }) }
+ * } satisfies RouteSchemaDefinition;
+ *
+ * class MyController extends WebServerBaseController {
+ *   hello = defineAction(helloSchema, async (request, reply) => {
+ *     // request.body is typed as { name: string }
+ *     return reply.send({ message: `Hello ${request.body.name}` });
+ *   });
+ * }
+ */
+export declare function defineAction<Schema extends RouteSchemaDefinition<any, any, any, any, any>>(schema: Schema, handler: ControllerAction<Schema>): ControllerAction<Schema>;
+/**
+ * Define a controller action without a schema.
+ * Useful for actions that don't need validation or type inference.
+ */
+export declare function defineAction<Schema extends undefined = undefined>(handler: ControllerAction<Schema>): ControllerAction<Schema>;
+//# sourceMappingURL=define-action.d.ts.map

package/dist/webserver/define-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-action.d.ts","sourceRoot":"","sources":["../../src/webserver/define-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACxF,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAChC,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5B;;;GAGG;AAEH,wBAAgB,YAAY,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,EAC/D,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAChC,gBAAgB,CAAC,MAAM,CAAC,CAAC"}

package/dist/webserver/define-action.js

@@ -0,0 +1,16 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function defineAction(schemaOrHandler, handler) {
+  if (typeof schemaOrHandler === "function") {
+    return schemaOrHandler;
+  }
+  if (!handler) {
+    throw new Error("Handler is required when schema is provided");
+  }
+  return handler;
+}
+__name(defineAction, "defineAction");
+export {
+  defineAction
+};
+//# sourceMappingURL=define-action.js.map

package/dist/webserver/define-action.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/webserver/define-action.ts"],
+  "sourcesContent": ["import type { RouteSchemaDefinition } from './webserver.interface.js';\nimport type { ControllerAction } from './controller/base.interface.js';\n\n/**\n * Define a typed controller action with schema inference.\n * This helper provides TypeScript type inference for controller methods based on Zod schemas.\n *\n * @example\n * const helloSchema = {\n *   body: z.object({ name: z.string() }),\n *   response: { 200: z.object({ message: z.string() }) }\n * } satisfies RouteSchemaDefinition;\n *\n * class MyController extends WebServerBaseController {\n *   hello = defineAction(helloSchema, async (request, reply) => {\n *     // request.body is typed as { name: string }\n *     return reply.send({ message: `Hello ${request.body.name}` });\n *   });\n * }\n */\nexport function defineAction<Schema extends RouteSchemaDefinition<any, any, any, any, any>>(\n  schema: Schema,\n  handler: ControllerAction<Schema>,\n): ControllerAction<Schema>;\n\n/**\n * Define a controller action without a schema.\n * Useful for actions that don't need validation or type inference.\n */\n// eslint-disable-next-line no-redeclare\nexport function defineAction<Schema extends undefined = undefined>(\n  handler: ControllerAction<Schema>,\n): ControllerAction<Schema>;\n\n// eslint-disable-next-line no-redeclare\nexport function defineAction<Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined>(\n  schemaOrHandler: Schema | ControllerAction<Schema>,\n  handler?: ControllerAction<Schema>,\n): ControllerAction<Schema> {\n  if (typeof schemaOrHandler === 'function') {\n    // No schema provided, just return the handler\n    return schemaOrHandler;\n  }\n\n  // Schema provided, return the handler\n  // Note: The schema is attached for documentation/IDE purposes only\n  // Actual validation happens at the route level\n  if (!handler) {\n    throw new Error('Handler is required when schema is provided');\n  }\n\n  return handler;\n}\n"],
+  "mappings": ";;AAmCO,SAAS,aACd,iBACA,SAC0B;AAC1B,MAAI,OAAO,oBAAoB,YAAY;AAEzC,WAAO;AAAA,EACT;AAKA,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAEA,SAAO;AACT;AAjBgB;",
+  "names": []
+}

package/dist/webserver/define-route.d.ts

@@ -0,0 +1,53 @@
+import type { HTTPMethods } from 'fastify';
+import { type RouteSchemaDefinition, type WebServerRoute } from './webserver.interface.js';
+import type { ControllerAction, WebServerBaseControllerType } from './controller/base.interface.js';
+export interface DefineRouteConfig<Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined, Handler extends ControllerAction<Schema>> {
+    method: HTTPMethods | HTTPMethods[];
+    path: string;
+    schema?: Schema;
+    handler: Handler;
+}
+export interface DefineRouteWithControllerConfig<Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined = undefined> {
+    method: HTTPMethods | HTTPMethods[];
+    path: string;
+    schema?: Schema;
+    controller: WebServerBaseControllerType;
+    action: string;
+}
+/**
+ * Define a route with an inline handler function.
+ * Provides full type inference for request parameters based on the schema.
+ *
+ * @example
+ * const helloSchema = {
+ *   body: z.object({ name: z.string() }),
+ *   response: { 200: z.object({ message: z.string() }) }
+ * } satisfies RouteSchemaDefinition;
+ *
+ * defineRoute({
+ *   method: 'POST',
+ *   path: '/hello',
+ *   schema: helloSchema,
+ *   handler: async (request, reply) => {
+ *     // request.body is typed as { name: string }
+ *     return reply.send({ message: `Hello ${request.body.name}` });
+ *   }
+ * });
+ */
+export declare function defineRoute<Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined, Handler extends ControllerAction<Schema>>(config: DefineRouteConfig<Schema, Handler>): WebServerRoute;
+/**
+ * Define a route with a controller and action method.
+ * Note: Type inference for controller actions is limited. Consider using inline handlers for full type safety.
+ *
+ * @example
+ * defineRoute({
+ *   method: 'POST',
+ *   path: '/hello',
+ *   controller: HelloController,
+ *   action: 'create',
+ *   schema: helloSchema
+ * });
+ */
+export declare function defineRoute<Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined = undefined>(config: DefineRouteWithControllerConfig<Schema>): WebServerRoute;
+export type DefineRoute = typeof defineRoute;
+//# sourceMappingURL=define-route.d.ts.map

package/dist/webserver/define-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-route.d.ts","sourceRoot":"","sources":["../../src/webserver/define-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAEpG,MAAM,WAAW,iBAAiB,CAChC,MAAM,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,EACzE,OAAO,SAAS,gBAAgB,CAAC,MAAM,CAAC;IAExC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,+BAA+B,CAC9C,MAAM,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS;IAErF,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,2BAA2B,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,MAAM,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,EACzE,OAAO,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACxC,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC;AAE9D;;;;;;;;;;;;GAYG;AAEH,wBAAgB,WAAW,CAAC,MAAM,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EAC/G,MAAM,EAAE,+BAA+B,CAAC,MAAM,CAAC,GAC9C,cAAc,CAAC;AA2BlB,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC"}

package/dist/webserver/define-route.js

@@ -0,0 +1,27 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import {
+  WebServerRouteType
+} from "./webserver.interface.js";
+function defineRoute(config) {
+  const route = {
+    type: WebServerRouteType.Default,
+    method: config.method,
+    path: config.path
+  };
+  if ("handler" in config) {
+    route.handler = config.handler;
+  } else if ("controller" in config && "action" in config) {
+    route.controller = config.controller;
+    route.action = config.action;
+  }
+  if (config.schema) {
+    route.schema = config.schema;
+  }
+  return route;
+}
+__name(defineRoute, "defineRoute");
+export {
+  defineRoute
+};
+//# sourceMappingURL=define-route.js.map

package/dist/webserver/define-route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/webserver/define-route.ts"],
+  "sourcesContent": ["import type { HTTPMethods } from 'fastify';\nimport {\n  type AnyRouteSchemaDefinition,\n  type RouteSchemaDefinition,\n  type WebServerRoute,\n  WebServerRouteType,\n} from './webserver.interface.js';\nimport type { ControllerAction, WebServerBaseControllerType } from './controller/base.interface.js';\n\nexport interface DefineRouteConfig<\n  Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined,\n  Handler extends ControllerAction<Schema>,\n> {\n  method: HTTPMethods | HTTPMethods[];\n  path: string;\n  schema?: Schema;\n  handler: Handler;\n}\n\nexport interface DefineRouteWithControllerConfig<\n  Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined = undefined,\n> {\n  method: HTTPMethods | HTTPMethods[];\n  path: string;\n  schema?: Schema;\n  controller: WebServerBaseControllerType;\n  action: string;\n}\n\n/**\n * Define a route with an inline handler function.\n * Provides full type inference for request parameters based on the schema.\n *\n * @example\n * const helloSchema = {\n *   body: z.object({ name: z.string() }),\n *   response: { 200: z.object({ message: z.string() }) }\n * } satisfies RouteSchemaDefinition;\n *\n * defineRoute({\n *   method: 'POST',\n *   path: '/hello',\n *   schema: helloSchema,\n *   handler: async (request, reply) => {\n *     // request.body is typed as { name: string }\n *     return reply.send({ message: `Hello ${request.body.name}` });\n *   }\n * });\n */\nexport function defineRoute<\n  Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined,\n  Handler extends ControllerAction<Schema>,\n>(config: DefineRouteConfig<Schema, Handler>): WebServerRoute;\n\n/**\n * Define a route with a controller and action method.\n * Note: Type inference for controller actions is limited. Consider using inline handlers for full type safety.\n *\n * @example\n * defineRoute({\n *   method: 'POST',\n *   path: '/hello',\n *   controller: HelloController,\n *   action: 'create',\n *   schema: helloSchema\n * });\n */\n// eslint-disable-next-line no-redeclare\nexport function defineRoute<Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined = undefined>(\n  config: DefineRouteWithControllerConfig<Schema>,\n): WebServerRoute;\n\n// eslint-disable-next-line no-redeclare\nexport function defineRoute<\n  Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined,\n  Handler extends ControllerAction<Schema>,\n>(config: DefineRouteConfig<Schema, Handler> | DefineRouteWithControllerConfig<Schema>): WebServerRoute {\n  const route: WebServerRoute = {\n    type: WebServerRouteType.Default,\n    method: config.method,\n    path: config.path,\n  };\n\n  if ('handler' in config) {\n    route.handler = config.handler as ControllerAction<any>;\n  } else if ('controller' in config && 'action' in config) {\n    route.controller = config.controller;\n    route.action = config.action;\n  }\n\n  if (config.schema) {\n    route.schema = config.schema as AnyRouteSchemaDefinition;\n  }\n\n  return route;\n}\n\nexport type DefineRoute = typeof defineRoute;\n"],
+  "mappings": ";;AACA;AAAA,EAIE;AAAA,OACK;AAmEA,SAAS,YAGd,QAAsG;AACtG,QAAM,QAAwB;AAAA,IAC5B,MAAM,mBAAmB;AAAA,IACzB,QAAQ,OAAO;AAAA,IACf,MAAM,OAAO;AAAA,EACf;AAEA,MAAI,aAAa,QAAQ;AACvB,UAAM,UAAU,OAAO;AAAA,EACzB,WAAW,gBAAgB,UAAU,YAAY,QAAQ;AACvD,UAAM,aAAa,OAAO;AAC1B,UAAM,SAAS,OAAO;AAAA,EACxB;AAEA,MAAI,OAAO,QAAQ;AACjB,UAAM,SAAS,OAAO;AAAA,EACxB;AAEA,SAAO;AACT;AAtBgB;",
+  "names": []
+}

package/dist/webserver/index.d.ts

@@ -1,12 +1,14 @@
 export { default as WebServer } from './webserver.js';
-export type { WebServerConstructorParams, WebServerOptions, WebServerRoute } from './webserver.interface.js';
+export type { RouteHandler as TypedRouteHandler, RouteHandlerContext, RouteSchemaDefinition, WebServerConstructorParams, WebServerOptions, WebServerRoute, } from './webserver.interface.js';
 export { WebServerRouteType } from './webserver.interface.js';
 export { default as WebServerBaseController } from './controller/base.js';
-export type { WebServerBaseControllerConstructorParams } from './controller/base.interface.js';
+export type { ControllerAction, ControllerRequest, WebServerBaseControllerConstructorParams, } from './controller/base.interface.js';
 export { default as WebServerHealthController } from './controller/health.js';
 export { default as WebServerEntityController } from './controller/entity.js';
 export { default as ExampleAuthController } from './controller/example-auth.js';
 export { default as RouteUtil } from './util.js';
 export type { AuthenticatedUser, AuthenticatedRequest, AuthenticatedRouteHandler, RouteHandler, } from './controller/auth-middleware.js';
 export { withAuth } from './controller/auth-middleware.js';
+export { defineRoute } from './define-route.js';
+export { defineAction } from './define-action.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/webserver/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webserver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,wCAAwC,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webserver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EACV,YAAY,IAAI,iBAAiB,EACjC,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,wCAAwC,GACzC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/webserver/index.js

@@ -6,6 +6,8 @@ import { default as default5 } from "./controller/entity.js";
 import { default as default6 } from "./controller/example-auth.js";
 import { default as default7 } from "./util.js";
 import { withAuth } from "./controller/auth-middleware.js";
+import { defineRoute } from "./define-route.js";
+import { defineAction } from "./define-action.js";
 export {
   default6 as ExampleAuthController,
   default7 as RouteUtil,
@@ -14,6 +16,8 @@ export {
   default5 as WebServerEntityController,
   default4 as WebServerHealthController,
   WebServerRouteType,
+  defineAction,
+  defineRoute,
   withAuth
 };
 //# sourceMappingURL=index.js.map

package/dist/webserver/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/webserver/index.ts"],
-  "sourcesContent": ["export { default as WebServer } from './webserver.js';\nexport type { WebServerConstructorParams, WebServerOptions, WebServerRoute } from './webserver.interface.js';\nexport { WebServerRouteType } from './webserver.interface.js';\nexport { default as WebServerBaseController } from './controller/base.js';\nexport type { WebServerBaseControllerConstructorParams } from './controller/base.interface.js';\nexport { default as WebServerHealthController } from './controller/health.js';\nexport { default as WebServerEntityController } from './controller/entity.js';\nexport { default as ExampleAuthController } from './controller/example-auth.js';\nexport { default as RouteUtil } from './util.js';\nexport type {\n  AuthenticatedUser,\n  AuthenticatedRequest,\n  AuthenticatedRouteHandler,\n  RouteHandler,\n} from './controller/auth-middleware.js';\nexport { withAuth } from './controller/auth-middleware.js';\n"],
-  "mappings": "AAAA,SAAoB,WAAXA,gBAA4B;AAErC,SAAS,0BAA0B;AACnC,SAAoB,WAAXA,gBAA0C;AAEnD,SAAoB,WAAXA,gBAA4C;AACrD,SAAoB,WAAXA,gBAA4C;AACrD,SAAoB,WAAXA,gBAAwC;AACjD,SAAoB,WAAXA,gBAA4B;AAOrC,SAAS,gBAAgB;",
+  "sourcesContent": ["export { default as WebServer } from './webserver.js';\nexport type {\n  RouteHandler as TypedRouteHandler,\n  RouteHandlerContext,\n  RouteSchemaDefinition,\n  WebServerConstructorParams,\n  WebServerOptions,\n  WebServerRoute,\n} from './webserver.interface.js';\nexport { WebServerRouteType } from './webserver.interface.js';\nexport { default as WebServerBaseController } from './controller/base.js';\nexport type {\n  ControllerAction,\n  ControllerRequest,\n  WebServerBaseControllerConstructorParams,\n} from './controller/base.interface.js';\nexport { default as WebServerHealthController } from './controller/health.js';\nexport { default as WebServerEntityController } from './controller/entity.js';\nexport { default as ExampleAuthController } from './controller/example-auth.js';\nexport { default as RouteUtil } from './util.js';\nexport type {\n  AuthenticatedUser,\n  AuthenticatedRequest,\n  AuthenticatedRouteHandler,\n  RouteHandler,\n} from './controller/auth-middleware.js';\nexport { withAuth } from './controller/auth-middleware.js';\nexport { defineRoute } from './define-route.js';\nexport { defineAction } from './define-action.js';\n"],
+  "mappings": "AAAA,SAAoB,WAAXA,gBAA4B;AASrC,SAAS,0BAA0B;AACnC,SAAoB,WAAXA,gBAA0C;AAMnD,SAAoB,WAAXA,gBAA4C;AACrD,SAAoB,WAAXA,gBAA4C;AACrD,SAAoB,WAAXA,gBAAwC;AACjD,SAAoB,WAAXA,gBAA4B;AAOrC,SAAS,gBAAgB;AACzB,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;",
   "names": ["default"]
 }

package/dist/webserver/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/webserver/util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAyB,MAAM,0BAA0B,CAAC;AAE7F,iBAAS,yBAAyB,CAAC,EACjC,QAAQ,EACR,sBAAsB,GACvB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,GAAG,CAAC;CAC7B,GAAG,qBAAqB,EAAE,CA6D1B;;;;AAED,wBAGE"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/webserver/util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAyB,MAAM,0BAA0B,CAAC;AAE7F,iBAAS,yBAAyB,CAAC,EACjC,QAAQ,EACR,sBAAsB,GACvB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,GAAG,CAAC;CAC7B,GAAG,qBAAqB,EAAE,CAkE1B;;;;AAED,wBAGE"}

package/dist/webserver/util.js

@@ -37,12 +37,15 @@ function getEntityRouteDefinitions({
     action: "createOne",
     validationSchema: entityValidationSchema
   });
+  const updateOneValidationSchemas = [idValidationSchema];
+  if (entityValidationSchema) {
+    updateOneValidationSchemas.push(entityValidationSchema);
+  }
   routeDefinitions.push({
     path: `${basePath}/:id`,
     method: "PUT",
     action: "updateOne",
-    validationSchema: entityValidationSchema
-    // TODO: Need to merge with idValidationSchema
+    validationSchema: updateOneValidationSchemas
   });
   routeDefinitions.push({
     path: `${basePath}/:id`,

package/dist/webserver/util.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/webserver/util.ts"],
-  "sourcesContent": ["import type { HTTPMethods } from 'fastify';\nimport type { EntityRouteDefinition, RouteValidationSchema } from './webserver.interface.js';\n\nfunction getEntityRouteDefinitions({\n  basePath,\n  entityValidationSchema,\n}: {\n  basePath: string;\n  entityValidationSchema: any;\n}): EntityRouteDefinition[] {\n  const routeDefinitions: EntityRouteDefinition[] = [];\n\n  const idValidationSchema: RouteValidationSchema = {\n    type: 'params',\n    schema: {\n      properties: {\n        id: { type: 'integer' },\n      },\n      required: ['id'],\n      type: 'object',\n    },\n  };\n\n  // Options\n  routeDefinitions.push({\n    path: `${basePath}/options`,\n    method: 'GET' as HTTPMethods,\n    action: 'options',\n  });\n\n  // Get many\n  routeDefinitions.push({\n    path: `${basePath}`,\n    method: 'GET' as HTTPMethods,\n    action: 'getMany',\n  });\n\n  // Get one\n  routeDefinitions.push({\n    path: `${basePath}/:id`,\n    method: 'GET' as HTTPMethods,\n    action: 'getOne',\n    validationSchema: idValidationSchema,\n  });\n\n  // Create one\n  routeDefinitions.push({\n    path: `${basePath}`,\n    method: 'POST' as HTTPMethods,\n    action: 'createOne',\n    validationSchema: entityValidationSchema,\n  });\n\n  // Update one\n  routeDefinitions.push({\n    path: `${basePath}/:id`,\n    method: 'PUT' as HTTPMethods,\n    action: 'updateOne',\n    validationSchema: entityValidationSchema, // TODO: Need to merge with idValidationSchema\n  });\n\n  // Delete one\n  routeDefinitions.push({\n    path: `${basePath}/:id`,\n    method: 'DELETE' as HTTPMethods,\n    action: 'deleteOne',\n    validationSchema: idValidationSchema,\n  });\n\n  return routeDefinitions;\n}\n\nexport default {\n  // getEntityRoutes,\n  getEntityRouteDefinitions,\n};\n"],
-  "mappings": ";;AAGA,SAAS,0BAA0B;AAAA,EACjC;AAAA,EACA;AACF,GAG4B;AAC1B,QAAM,mBAA4C,CAAC;AAEnD,QAAM,qBAA4C;AAAA,IAChD,MAAM;AAAA,IACN,QAAQ;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU;AAAA,MACxB;AAAA,MACA,UAAU,CAAC,IAAI;AAAA,MACf,MAAM;AAAA,IACR;AAAA,EACF;AAGA,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA;AAAA,EACpB,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAED,SAAO;AACT;AAnES;AAqET,IAAO,eAAQ;AAAA;AAAA,EAEb;AACF;",
+  "sourcesContent": ["import type { HTTPMethods } from 'fastify';\nimport type { EntityRouteDefinition, RouteValidationSchema } from './webserver.interface.js';\n\nfunction getEntityRouteDefinitions({\n  basePath,\n  entityValidationSchema,\n}: {\n  basePath: string;\n  entityValidationSchema: any;\n}): EntityRouteDefinition[] {\n  const routeDefinitions: EntityRouteDefinition[] = [];\n\n  const idValidationSchema: RouteValidationSchema = {\n    type: 'params',\n    schema: {\n      properties: {\n        id: { type: 'integer' },\n      },\n      required: ['id'],\n      type: 'object',\n    },\n  };\n\n  // Options\n  routeDefinitions.push({\n    path: `${basePath}/options`,\n    method: 'GET' as HTTPMethods,\n    action: 'options',\n  });\n\n  // Get many\n  routeDefinitions.push({\n    path: `${basePath}`,\n    method: 'GET' as HTTPMethods,\n    action: 'getMany',\n  });\n\n  // Get one\n  routeDefinitions.push({\n    path: `${basePath}/:id`,\n    method: 'GET' as HTTPMethods,\n    action: 'getOne',\n    validationSchema: idValidationSchema,\n  });\n\n  // Create one\n  routeDefinitions.push({\n    path: `${basePath}`,\n    method: 'POST' as HTTPMethods,\n    action: 'createOne',\n    validationSchema: entityValidationSchema,\n  });\n\n  // Update one - merge params and body validation\n  const updateOneValidationSchemas: RouteValidationSchema[] = [idValidationSchema];\n  if (entityValidationSchema) {\n    updateOneValidationSchemas.push(entityValidationSchema);\n  }\n\n  routeDefinitions.push({\n    path: `${basePath}/:id`,\n    method: 'PUT' as HTTPMethods,\n    action: 'updateOne',\n    validationSchema: updateOneValidationSchemas,\n  });\n\n  // Delete one\n  routeDefinitions.push({\n    path: `${basePath}/:id`,\n    method: 'DELETE' as HTTPMethods,\n    action: 'deleteOne',\n    validationSchema: idValidationSchema,\n  });\n\n  return routeDefinitions;\n}\n\nexport default {\n  // getEntityRoutes,\n  getEntityRouteDefinitions,\n};\n"],
+  "mappings": ";;AAGA,SAAS,0BAA0B;AAAA,EACjC;AAAA,EACA;AACF,GAG4B;AAC1B,QAAM,mBAA4C,CAAC;AAEnD,QAAM,qBAA4C;AAAA,IAChD,MAAM;AAAA,IACN,QAAQ;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU;AAAA,MACxB;AAAA,MACA,UAAU,CAAC,IAAI;AAAA,MACf,MAAM;AAAA,IACR;AAAA,EACF;AAGA,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAGD,QAAM,6BAAsD,CAAC,kBAAkB;AAC/E,MAAI,wBAAwB;AAC1B,+BAA2B,KAAK,sBAAsB;AAAA,EACxD;AAEA,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAGD,mBAAiB,KAAK;AAAA,IACpB,MAAM,GAAG,QAAQ;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA,EACpB,CAAC;AAED,SAAO;AACT;AAxES;AA0ET,IAAO,eAAQ;AAAA;AAAA,EAEb;AACF;",
   "names": []
 }

package/dist/webserver/webserver.d.ts

@@ -1,6 +1,8 @@
 import { type FastifyInstance, type HTTPMethods } from 'fastify';
-import { type WebServerConstructorParams } from './webserver.interface.js';
+import { type AnyRouteSchemaDefinition, type WebServerConstructorParams } from './webserver.interface.js';
+import type { ControllerAction } from './controller/base.interface.js';
 import type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';
+import { type ZodTypeProvider } from 'fastify-type-provider-zod';
 declare module 'fastify' {
     interface FastifyRequest {
         startTime?: number;
@@ -16,7 +18,7 @@ declare class WebServer {
     private queueManager;
     private eventManager;
     private databaseInstance;
-    fastifyServer: FastifyInstance;
+    fastifyServer: FastifyInstance<any, any, any, any, ZodTypeProvider>;
     private lifecycleManager;
     private _isReady;
     constructor(params: WebServerConstructorParams & {
@@ -45,18 +47,28 @@ declare class WebServer {
      * Configure routes.
      */
     private configureRoutes;
-    defineRoute({ controllerInstance, controllerName, routeMethod, routePath, routeAction, routeValidation, }: {
+    private loadRoutesFromDirectory;
+    private normalizeRouteExport;
+    private isValidRoute;
+    defineRoute({ controllerInstance, controllerName, routeMethod, routePath, routeAction, routeSchema, handlerOverride, legacyValidation, }: {
         controllerInstance: any;
         controllerName: string;
         routeMethod: HTTPMethods | HTTPMethods[];
         routePath: string;
-        routeAction: string;
-        routeValidation?: {
+        routeAction?: string;
+        routeSchema?: AnyRouteSchemaDefinition;
+        handlerOverride?: ControllerAction<any>;
+        legacyValidation?: {
             type: 'body' | 'query' | 'params';
             schema: {
                 [key: string]: any;
             };
-        };
+        } | Array<{
+            type: 'body' | 'query' | 'params';
+            schema: {
+                [key: string]: any;
+            };
+        }>;
     }): Promise<void>;
     /**
      * Start web server.
@@ -66,6 +78,8 @@ declare class WebServer {
      * Stop web server.
      */
     stop(): Promise<void>;
+    private buildFastifySchema;
+    private buildLegacySchema;
     /**
      * Check if web server is ready to accept traffic.
      */

package/dist/webserver/webserver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webserver.d.ts","sourceRoot":"","sources":["../../src/webserver/webserver.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,eAAe,EAA0C,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAKlH,OAAO,EACL,KAAK,0BAA0B,EAIhC,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAK1E,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,cAAM,SAAS;IACb,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAEpC,aAAa,EAAE,eAAe,CAAC;IAEtC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,0BAA0B,GAAG;QAAE,gBAAgB,EAAE,gBAAgB,CAAA;KAAE;IAgDvF;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC;;OAEG;YACW,iBAAiB;IAiD/B;;OAEG;IACH,OAAO,CAAC,cAAc;YAeR,QAAQ;YAeR,SAAS;YA2BT,UAAU;YAuCV,OAAO;YAMP,OAAO;IAIrB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;YACW,eAAe;IA+JhB,WAAW,CAAC,EACvB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,eAAe,GAChB,EAAE;QACD,kBAAkB,EAAE,GAAG,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE;YAChB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;YAClC,MAAM,EAAE;gBAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;aAAE,CAAC;SAChC,CAAC;KACH,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DjB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"webserver.d.ts","sourceRoot":"","sources":["../../src/webserver/webserver.ts"],"names":[],"mappings":"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"}

package/dist/webserver/webserver.interface.d.ts

@@ -1,11 +1,30 @@
-import type { HTTPMethods } from 'fastify';
+import type { FastifyReply, FastifyRequest, HTTPMethods, RouteGenericInterface } from 'fastify';
 import type { DatabaseInstance } from '../database/index.js';
 import type { QueueManager } from '../queue/index.js';
 import type { RedisInstance } from '../redis/index.js';
-import type { WebServerBaseControllerType } from './controller/base.interface.js';
+import type { ControllerAction, WebServerBaseControllerType } from './controller/base.interface.js';
 import type { ApplicationConfig } from '../application/base-application.interface.js';
 import type EventManager from '../event/manager.js';
 import type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';
+import type { z } from 'zod';
+export interface RouteSchemaDefinition<TParams extends z.ZodTypeAny | undefined = undefined, TQuery extends z.ZodTypeAny | undefined = undefined, TBody extends z.ZodTypeAny | undefined = undefined, TReply extends Record<number | `${number}`, z.ZodTypeAny> | undefined = undefined, THeaders extends z.ZodTypeAny | undefined = undefined> {
+    params?: TParams;
+    querystring?: TQuery;
+    body?: TBody;
+    response?: TReply;
+    headers?: THeaders;
+}
+type InferOrDefault<TZod extends z.ZodTypeAny | undefined, TFallback> = TZod extends z.ZodTypeAny ? z.input<TZod> : TFallback;
+type InferResponse<TResponse> = TResponse extends Record<number | `${number}`, z.ZodTypeAny> ? z.output<TResponse[keyof TResponse]> : RouteGenericInterface['Reply'];
+export interface RouteHandlerContext<Schema extends RouteSchemaDefinition | undefined = undefined> extends RouteGenericInterface {
+    Params?: Schema extends RouteSchemaDefinition<infer TParams, any, any, any, any> ? InferOrDefault<TParams, RouteGenericInterface['Params']> : RouteGenericInterface['Params'];
+    Querystring?: Schema extends RouteSchemaDefinition<any, infer TQuery, any, any, any> ? InferOrDefault<TQuery, RouteGenericInterface['Querystring']> : RouteGenericInterface['Querystring'];
+    Body?: Schema extends RouteSchemaDefinition<any, any, infer TBody, any, any> ? InferOrDefault<TBody, RouteGenericInterface['Body']> : RouteGenericInterface['Body'];
+    Headers?: Schema extends RouteSchemaDefinition<any, any, any, any, infer THeaders> ? InferOrDefault<THeaders, RouteGenericInterface['Headers']> : RouteGenericInterface['Headers'];
+    Reply?: Schema extends RouteSchemaDefinition<any, any, any, infer TReply, any> ? InferResponse<TReply> : RouteGenericInterface['Reply'];
+}
+export type AnyRouteSchemaDefinition = RouteSchemaDefinition<z.ZodTypeAny | undefined, z.ZodTypeAny | undefined, z.ZodTypeAny | undefined, Record<number | `${number}`, z.ZodTypeAny> | undefined, z.ZodTypeAny | undefined>;
+export type RouteHandler<Schema extends RouteSchemaDefinition | undefined = undefined> = (request: FastifyRequest<RouteHandlerContext<Schema>>, reply: FastifyReply) => Promise<RouteHandlerContext<Schema>['Reply'] | void> | RouteHandlerContext<Schema>['Reply'] | void;
 export interface WebServerConstructorParams {
     /** Application configuration */
     applicationConfig: ApplicationConfig;
@@ -37,6 +56,8 @@ export interface BaseWebServerRoute {
     controllerName?: string;
     /** Route controller */
     controller?: WebServerBaseControllerType;
+    /** Typed route handler */
+    handler?: ControllerAction<any>;
     /** Route validation */
     validation?: {
         /** Validation type */
@@ -46,13 +67,15 @@ export interface BaseWebServerRoute {
             [key: string]: any;
         };
     };
+    /** Zod-based schema definition */
+    schema?: AnyRouteSchemaDefinition;
 }
 export interface DefaultWebServerRoute extends BaseWebServerRoute {
     type: WebServerRouteType.Default;
     /** Route method */
     method: HTTPMethods | HTTPMethods[];
     /** Route action */
-    action: string;
+    action?: string;
 }
 export interface EntityWebServerRoute extends BaseWebServerRoute {
     type: WebServerRouteType.Entity;
@@ -74,7 +97,7 @@ export interface EntityRouteDefinition {
     path: string;
     method: HTTPMethods | HTTPMethods[];
     action: string;
-    validationSchema?: RouteValidationSchema;
+    validationSchema?: RouteValidationSchema | RouteValidationSchema[];
 }
 export interface WebServerLogConfig {
     startUp?: boolean;
@@ -146,10 +169,13 @@ export interface WebServerOptions {
     errors?: WebServerErrorsOptions;
     /** Web server controllers directory */
     controllersDirectory: string;
+    /** Optional directory containing route definition files */
+    routesDirectory?: string;
     log?: WebServerLogConfig;
     /** Web server security options (helmet, rate limiting) */
     security?: WebServerSecurityOptions;
     /** Web server debug options */
     debug?: WebServerDebugOptions;
 }
+export {};
 //# sourceMappingURL=webserver.interface.d.ts.map

package/dist/webserver/webserver.interface.d.ts.map

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

package/dist/webserver/webserver.interface.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/webserver/webserver.interface.ts"],
-  "sourcesContent": ["import type { HTTPMethods } from 'fastify';\nimport type { DatabaseInstance } from '../database/index.js';\nimport type { QueueManager } from '../queue/index.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { WebServerBaseControllerType } from './controller/base.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\nimport type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';\n\nexport interface WebServerConstructorParams {\n  /** Application configuration */\n  applicationConfig: ApplicationConfig;\n\n  /** Web server options */\n  options: WebServerOptions;\n\n  /** Web server routes */\n  routes: WebServerRoute[];\n\n  /** Redis instance */\n  redisInstance: RedisInstance;\n\n  /** Queue manager */\n  queueManager: QueueManager;\n\n  /** Event manager */\n  eventManager: EventManager;\n\n  /** Database instance */\n  databaseInstance: DatabaseInstance;\n\n  /** Lifecycle manager */\n  lifecycleManager: LifecycleManager;\n}\n\nexport enum WebServerRouteType {\n  Default = 'default',\n  Entity = 'entity',\n}\n\nexport interface BaseWebServerRoute {\n  /** Route type */\n  type?: WebServerRouteType;\n\n  /** Route path */\n  path: string;\n\n  /** Route controller name */\n  controllerName?: string;\n\n  /** Route controller */\n  controller?: WebServerBaseControllerType;\n\n  /** Route validation */\n  validation?: {\n    /** Validation type */\n    type: 'body' | 'query' | 'params';\n\n    /** Validation schema */\n    schema: { [key: string]: any };\n  };\n}\n\nexport interface DefaultWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Default;\n\n  /** Route method */\n  method: HTTPMethods | HTTPMethods[];\n\n  /** Route action */\n  action: string;\n}\n\nexport interface EntityWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Entity;\n\n  /** Entity name */\n  entityName: string;\n}\n\nexport type WebServerRoute = DefaultWebServerRoute | EntityWebServerRoute;\n\nexport interface RouteValidationSchema {\n  type: 'body' | 'query' | 'params';\n  schema: {\n    type: 'object';\n    properties: { [key: string]: any };\n    required: string[];\n  };\n}\n\nexport interface EntityRouteDefinition {\n  path: string;\n  method: HTTPMethods | HTTPMethods[];\n  action: string;\n  validationSchema?: RouteValidationSchema;\n}\n\nexport interface WebServerLogConfig {\n  startUp?: boolean;\n}\n\nexport interface WebServerDebugOptions {\n  printRoutes?: boolean;\n  simulateSlowConnection?: {\n    enabled?: boolean;\n    delay?: number;\n  };\n}\n\nexport interface WebServerCorsBaseOptions {\n  /** Whether CORS is enabled */\n  enabled: boolean;\n}\n\nexport interface WebServerCorsDisabledOptionsBase {\n  enabled: false;\n}\n\nexport interface WebServerCorsEnabledOptionsBase {\n  enabled: true;\n}\n\nexport interface WebServerCorsEnabledOptions extends WebServerCorsEnabledOptionsBase {\n  urls: string[];\n}\n\nexport type WebServerCorsOptions = WebServerCorsDisabledOptionsBase | WebServerCorsEnabledOptions;\n\nexport interface WebServerErrorsOptions {\n  verbose: boolean;\n}\n\nexport interface WebServerSecurityHelmetOptions {\n  enabled?: boolean;\n  contentSecurityPolicy?: boolean;\n  crossOriginEmbedderPolicy?: boolean;\n  crossOriginOpenerPolicy?: boolean;\n  crossOriginResourcePolicy?: boolean;\n  dnsPrefetchControl?: boolean;\n  frameguard?: boolean;\n  hidePoweredBy?: boolean;\n  hsts?: boolean;\n  ieNoOpen?: boolean;\n  noSniff?: boolean;\n  originAgentCluster?: boolean;\n  permittedCrossDomainPolicies?: boolean;\n  referrerPolicy?: boolean;\n  xssFilter?: boolean;\n}\n\nexport interface WebServerSecurityRateLimitOptions {\n  enabled?: boolean;\n  max?: number;\n  timeWindow?: string;\n  ban?: number;\n  cache?: number;\n}\n\nexport interface WebServerSecurityOptions {\n  helmet?: WebServerSecurityHelmetOptions;\n  rateLimit?: WebServerSecurityRateLimitOptions;\n}\n\nexport interface WebServerOptions {\n  /** Web server host */\n  host: string;\n\n  /** Web server port */\n  port: number;\n\n  /** Maximum request body size in bytes (default: 100MB) */\n  bodyLimit?: number;\n\n  /** Connection timeout in milliseconds (default: 30s) */\n  connectionTimeout?: number;\n\n  /** Web server CORS options */\n  cors?: WebServerCorsOptions;\n\n  /** Web server error options */\n  errors?: WebServerErrorsOptions;\n\n  /** Web server controllers directory */\n  controllersDirectory: string;\n\n  log?: WebServerLogConfig;\n\n  /** Web server security options (helmet, rate limiting) */\n  security?: WebServerSecurityOptions;\n\n  /** Web server debug options */\n  debug?: WebServerDebugOptions;\n}\n\n// export interface WebServerLogParams {\n//   /** Method */\n//   Method: string;\n\n//   /** Path */\n//   Path: string;\n\n//   /** Status code */\n//   Status: number;\n\n//   /** IP address */\n//   IP?: string;\n\n//   /** Execution time */\n//   Time?: string;\n\n//   [key: string]: unknown;\n// }\n"],
-  "mappings": "AAmCO,IAAK,qBAAL,kBAAKA,wBAAL;AACL,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;",
+  "sourcesContent": ["import type { FastifyReply, FastifyRequest, HTTPMethods, RouteGenericInterface } from 'fastify';\nimport type { DatabaseInstance } from '../database/index.js';\nimport type { QueueManager } from '../queue/index.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { ControllerAction, WebServerBaseControllerType } from './controller/base.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\nimport type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';\nimport type { z } from 'zod';\n\nexport interface RouteSchemaDefinition<\n  TParams extends z.ZodTypeAny | undefined = undefined,\n  TQuery extends z.ZodTypeAny | undefined = undefined,\n  TBody extends z.ZodTypeAny | undefined = undefined,\n  TReply extends Record<number | `${number}`, z.ZodTypeAny> | undefined = undefined,\n  THeaders extends z.ZodTypeAny | undefined = undefined,\n> {\n  params?: TParams;\n  querystring?: TQuery;\n  body?: TBody;\n  response?: TReply;\n  headers?: THeaders;\n}\n\ntype InferOrDefault<TZod extends z.ZodTypeAny | undefined, TFallback> = TZod extends z.ZodTypeAny\n  ? z.input<TZod>\n  : TFallback;\n\ntype InferResponse<TResponse> =\n  TResponse extends Record<number | `${number}`, z.ZodTypeAny>\n    ? z.output<TResponse[keyof TResponse]>\n    : RouteGenericInterface['Reply'];\n\nexport interface RouteHandlerContext<Schema extends RouteSchemaDefinition | undefined = undefined>\n  extends RouteGenericInterface {\n  Params?: Schema extends RouteSchemaDefinition<infer TParams, any, any, any, any>\n    ? InferOrDefault<TParams, RouteGenericInterface['Params']>\n    : RouteGenericInterface['Params'];\n  Querystring?: Schema extends RouteSchemaDefinition<any, infer TQuery, any, any, any>\n    ? InferOrDefault<TQuery, RouteGenericInterface['Querystring']>\n    : RouteGenericInterface['Querystring'];\n  Body?: Schema extends RouteSchemaDefinition<any, any, infer TBody, any, any>\n    ? InferOrDefault<TBody, RouteGenericInterface['Body']>\n    : RouteGenericInterface['Body'];\n  Headers?: Schema extends RouteSchemaDefinition<any, any, any, any, infer THeaders>\n    ? InferOrDefault<THeaders, RouteGenericInterface['Headers']>\n    : RouteGenericInterface['Headers'];\n  Reply?: Schema extends RouteSchemaDefinition<any, any, any, infer TReply, any>\n    ? InferResponse<TReply>\n    : RouteGenericInterface['Reply'];\n}\n\nexport type AnyRouteSchemaDefinition = RouteSchemaDefinition<\n  z.ZodTypeAny | undefined,\n  z.ZodTypeAny | undefined,\n  z.ZodTypeAny | undefined,\n  Record<number | `${number}`, z.ZodTypeAny> | undefined,\n  z.ZodTypeAny | undefined\n>;\n\nexport type RouteHandler<Schema extends RouteSchemaDefinition | undefined = undefined> = (\n  request: FastifyRequest<RouteHandlerContext<Schema>>,\n  reply: FastifyReply,\n) => Promise<RouteHandlerContext<Schema>['Reply'] | void> | RouteHandlerContext<Schema>['Reply'] | void;\n\nexport interface WebServerConstructorParams {\n  /** Application configuration */\n  applicationConfig: ApplicationConfig;\n\n  /** Web server options */\n  options: WebServerOptions;\n\n  /** Web server routes */\n  routes: WebServerRoute[];\n\n  /** Redis instance */\n  redisInstance: RedisInstance;\n\n  /** Queue manager */\n  queueManager: QueueManager;\n\n  /** Event manager */\n  eventManager: EventManager;\n\n  /** Database instance */\n  databaseInstance: DatabaseInstance;\n\n  /** Lifecycle manager */\n  lifecycleManager: LifecycleManager;\n}\n\nexport enum WebServerRouteType {\n  Default = 'default',\n  Entity = 'entity',\n}\n\nexport interface BaseWebServerRoute {\n  /** Route type */\n  type?: WebServerRouteType;\n\n  /** Route path */\n  path: string;\n\n  /** Route controller name */\n  controllerName?: string;\n\n  /** Route controller */\n  controller?: WebServerBaseControllerType;\n\n  /** Typed route handler */\n  handler?: ControllerAction<any>;\n\n  /** Route validation */\n  validation?: {\n    /** Validation type */\n    type: 'body' | 'query' | 'params';\n\n    /** Validation schema */\n    schema: { [key: string]: any };\n  };\n\n  /** Zod-based schema definition */\n  schema?: AnyRouteSchemaDefinition;\n}\n\nexport interface DefaultWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Default;\n\n  /** Route method */\n  method: HTTPMethods | HTTPMethods[];\n\n  /** Route action */\n  action?: string;\n}\n\nexport interface EntityWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Entity;\n\n  /** Entity name */\n  entityName: string;\n}\n\nexport type WebServerRoute = DefaultWebServerRoute | EntityWebServerRoute;\n\nexport interface RouteValidationSchema {\n  type: 'body' | 'query' | 'params';\n  schema: {\n    type: 'object';\n    properties: { [key: string]: any };\n    required: string[];\n  };\n}\n\nexport interface EntityRouteDefinition {\n  path: string;\n  method: HTTPMethods | HTTPMethods[];\n  action: string;\n  validationSchema?: RouteValidationSchema | RouteValidationSchema[];\n}\n\nexport interface WebServerLogConfig {\n  startUp?: boolean;\n}\n\nexport interface WebServerDebugOptions {\n  printRoutes?: boolean;\n  simulateSlowConnection?: {\n    enabled?: boolean;\n    delay?: number;\n  };\n}\n\nexport interface WebServerCorsBaseOptions {\n  /** Whether CORS is enabled */\n  enabled: boolean;\n}\n\nexport interface WebServerCorsDisabledOptionsBase {\n  enabled: false;\n}\n\nexport interface WebServerCorsEnabledOptionsBase {\n  enabled: true;\n}\n\nexport interface WebServerCorsEnabledOptions extends WebServerCorsEnabledOptionsBase {\n  urls: string[];\n}\n\nexport type WebServerCorsOptions = WebServerCorsDisabledOptionsBase | WebServerCorsEnabledOptions;\n\nexport interface WebServerErrorsOptions {\n  verbose: boolean;\n}\n\nexport interface WebServerSecurityHelmetOptions {\n  enabled?: boolean;\n  contentSecurityPolicy?: boolean;\n  crossOriginEmbedderPolicy?: boolean;\n  crossOriginOpenerPolicy?: boolean;\n  crossOriginResourcePolicy?: boolean;\n  dnsPrefetchControl?: boolean;\n  frameguard?: boolean;\n  hidePoweredBy?: boolean;\n  hsts?: boolean;\n  ieNoOpen?: boolean;\n  noSniff?: boolean;\n  originAgentCluster?: boolean;\n  permittedCrossDomainPolicies?: boolean;\n  referrerPolicy?: boolean;\n  xssFilter?: boolean;\n}\n\nexport interface WebServerSecurityRateLimitOptions {\n  enabled?: boolean;\n  max?: number;\n  timeWindow?: string;\n  ban?: number;\n  cache?: number;\n}\n\nexport interface WebServerSecurityOptions {\n  helmet?: WebServerSecurityHelmetOptions;\n  rateLimit?: WebServerSecurityRateLimitOptions;\n}\n\nexport interface WebServerOptions {\n  /** Web server host */\n  host: string;\n\n  /** Web server port */\n  port: number;\n\n  /** Maximum request body size in bytes (default: 100MB) */\n  bodyLimit?: number;\n\n  /** Connection timeout in milliseconds (default: 30s) */\n  connectionTimeout?: number;\n\n  /** Web server CORS options */\n  cors?: WebServerCorsOptions;\n\n  /** Web server error options */\n  errors?: WebServerErrorsOptions;\n\n  /** Web server controllers directory */\n  controllersDirectory: string;\n\n  /** Optional directory containing route definition files */\n  routesDirectory?: string;\n\n  log?: WebServerLogConfig;\n\n  /** Web server security options (helmet, rate limiting) */\n  security?: WebServerSecurityOptions;\n\n  /** Web server debug options */\n  debug?: WebServerDebugOptions;\n}\n\n// export interface WebServerLogParams {\n//   /** Method */\n//   Method: string;\n\n//   /** Path */\n//   Path: string;\n\n//   /** Status code */\n//   Status: number;\n\n//   /** IP address */\n//   IP?: string;\n\n//   /** Execution time */\n//   Time?: string;\n\n//   [key: string]: unknown;\n// }\n"],
+  "mappings": "AA2FO,IAAK,qBAAL,kBAAKA,wBAAL;AACL,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;",
   "names": ["WebServerRouteType"]
 }