@scpxl/nodejs-framework 1.0.22 → 1.0.24

package/dist/webserver/controller/base.d.ts

@@ -0,0 +1,41 @@
+import { StatusCodes } from 'http-status-codes';
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import type { DatabaseInstance } from '../../database/index.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type { QueueManager } from '../../queue/index.js';
+import type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+import type EventManager from '../../event/manager.js';
+import type { WebServerOptions } from '../webserver.interface.js';
+import type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';
+export interface AuthenticatedUser<TPayload = Record<string, unknown>> {
+    userId: number;
+    payload: TPayload;
+}
+export default abstract class BaseController<TQueueManager extends QueueManager = QueueManager, TRedisInstance extends RedisInstance = RedisInstance, TEventManager extends EventManager = EventManager, TDatabaseInstance extends DatabaseInstance = DatabaseInstance> {
+    protected workerId: number | undefined;
+    protected applicationConfig: ApplicationConfig;
+    protected webServerOptions: WebServerOptions;
+    protected redisInstance: TRedisInstance;
+    protected queueManager: TQueueManager;
+    protected eventManager: TEventManager;
+    protected databaseInstance: TDatabaseInstance;
+    protected lifecycleManager: LifecycleManager;
+    constructor({ applicationConfig, webServerOptions, redisInstance, queueManager, eventManager, databaseInstance, lifecycleManager, }: WebServerBaseControllerConstructorParams<TQueueManager, TRedisInstance, TEventManager, TDatabaseInstance>);
+    protected sendSuccessResponse<T = unknown>({ reply, data, statusCode, meta, }: {
+        reply: FastifyReply;
+        data: T;
+        statusCode?: StatusCodes;
+        meta?: ApiResponse<T>['meta'];
+    }): void;
+    protected sendNotFoundResponse(reply: FastifyReply, message?: string): void;
+    protected sendErrorResponse({ reply, error, statusCode, errorType, }: {
+        reply: FastifyReply;
+        error: unknown;
+        statusCode?: StatusCodes;
+        errorType?: ApiError['type'];
+    }): void;
+    private getErrorType;
+    protected authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc,CAC1C,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,cAAc,SAAS,aAAa,GAAG,aAAa,EACpD,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,iBAAiB,SAAS,gBAAgB,GAAG,gBAAgB;IAE7D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC/C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;IACxC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;IACtC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;IACtC,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC9C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,wCAAwC,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,CAAC;IAa5G,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,EACzC,KAAK,EACL,IAAI,EACJ,UAA2B,EAC3B,IAAI,GACL,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC;QACR,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KAC/B;IAYD,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,MAA6B;IAW1F,SAAS,CAAC,iBAAiB,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,UAAoC,EACpC,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC9B;IA6CD,OAAO,CAAC,YAAY;cAoBJ,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAwErH"}

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

@@ -0,0 +1,50 @@
+import type { FastifyRequest } from 'fastify';
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+import type { DatabaseInstance } from '../../database/index.js';
+import type EventManager from '../../event/manager.js';
+import type { QueueManager } from '../../queue/index.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type { RouteHandler, RouteHandlerContext, RouteSchemaDefinition, WebServerOptions } from '../webserver.interface.js';
+import type WebServerBaseController from './base.js';
+import type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';
+export interface WebServerBaseControllerConstructorParams<TQueueManager extends QueueManager = QueueManager, TRedisInstance extends RedisInstance = RedisInstance, TEventManager extends EventManager = EventManager, TDatabaseInstance extends DatabaseInstance = DatabaseInstance> {
+    applicationConfig: ApplicationConfig;
+    webServerOptions: WebServerOptions;
+    redisInstance: TRedisInstance;
+    queueManager: TQueueManager;
+    eventManager: TEventManager;
+    databaseInstance: TDatabaseInstance;
+    lifecycleManager: LifecycleManager;
+}
+export type WebServerBaseControllerType<TQueueManager extends QueueManager = QueueManager, TRedisInstance extends RedisInstance = RedisInstance, TEventManager extends EventManager = EventManager, TDatabaseInstance extends DatabaseInstance = DatabaseInstance> = new (params: WebServerBaseControllerConstructorParams<TQueueManager, TRedisInstance, TEventManager, TDatabaseInstance>) => WebServerBaseController<TQueueManager, TRedisInstance, TEventManager, TDatabaseInstance>;
+export type ControllerAction<Schema extends RouteSchemaDefinition | undefined = undefined> = RouteHandler<Schema>;
+export type ControllerRequest<Schema extends RouteSchemaDefinition | undefined = undefined> = FastifyRequest<RouteHandlerContext<Schema>>;
+export interface ApiResponse<T = unknown> {
+    data?: T;
+    meta?: {
+        pagination?: {
+            page: number;
+            limit: number;
+            total: number;
+            totalPages: number;
+        };
+        timestamp: string;
+        requestId: string;
+    };
+    error?: ApiError;
+}
+export interface ApiError {
+    message: string;
+    code?: string;
+    type: 'validation' | 'authentication' | 'authorization' | 'not_found' | 'server_error' | 'client_error';
+    details?: Record<string, unknown>;
+    timestamp: string;
+    requestId: string;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+//# sourceMappingURL=base.interface.d.ts.map

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

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

package/dist/webserver/controller/entity.d.ts

@@ -0,0 +1,94 @@
+import 'reflect-metadata';
+import type { EntityManager } from '@mikro-orm/core';
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import BaseController from './base.js';
+import type { DynamicEntity } from '../../database/dynamic-entity.js';
+import type { WebServerBaseControllerConstructorParams } from './base.interface.js';
+export default abstract class EntityController extends BaseController {
+    protected abstract entityName: string;
+    protected entityManager: EntityManager;
+    private static entityCache;
+    constructor(props: WebServerBaseControllerConstructorParams);
+    protected getEntity: () => Promise<typeof DynamicEntity | undefined>;
+    private getEntityProperties;
+    options: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    metadata: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    protected preGetMany(_: {
+        entityManager: EntityManager;
+        request: FastifyRequest;
+        reply: FastifyReply;
+    }): Promise<void>;
+    protected postGetMany(_: {
+        entityManager: EntityManager;
+        request: FastifyRequest;
+        reply: FastifyReply;
+        data: {
+            items: any[];
+            total: number;
+            page: number;
+            totalPages: number;
+            limit: number;
+        };
+    }): Promise<void>;
+    getMany: (request: FastifyRequest<{
+        Querystring: {
+            page: string;
+            limit: string;
+            filters: string;
+            sort: string;
+            "sort-order": string;
+            search: string;
+            [key: string]: any;
+        };
+    }>, reply: FastifyReply) => Promise<void>;
+    protected preGetOne(_: {
+        entityManager: EntityManager;
+        request: FastifyRequest;
+        reply: FastifyReply;
+    }): Promise<void>;
+    protected postGetOne(_: {
+        entityManager: EntityManager;
+        request: FastifyRequest;
+        reply: FastifyReply;
+        item: any;
+    }): Promise<void>;
+    getOne: (request: FastifyRequest<{
+        Params: {
+            id: number;
+        };
+        Querystring: {
+            populate: string;
+        };
+    }>, reply: FastifyReply) => Promise<void>;
+    protected preCreateOne: ({ request, reply, }: {
+        request: FastifyRequest;
+        reply: FastifyReply;
+    }) => {
+        request: FastifyRequest;
+        reply: FastifyReply;
+    };
+    protected postCreateOne(_: {
+        entityManager: EntityManager;
+        request: FastifyRequest;
+        reply: FastifyReply;
+        item: any;
+    }): Promise<void>;
+    createOne: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    protected postUpdateOne(_: {
+        entityManager: EntityManager;
+        request: FastifyRequest;
+        reply: FastifyReply;
+        item: any;
+    }): Promise<void>;
+    updateOne: (request: FastifyRequest<{
+        Params: {
+            id: number;
+        };
+    }>, reply: FastifyReply) => Promise<void>;
+    deleteOne: (request: FastifyRequest<{
+        Params: {
+            id: number;
+        };
+    }>, reply: FastifyReply) => Promise<void>;
+}
+//# sourceMappingURL=entity.d.ts.map

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

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

package/dist/webserver/controller/example-auth.d.ts

@@ -0,0 +1,12 @@
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import WebServerBaseController from './base.js';
+/**
+ * Example controller demonstrating simplified authentication
+ */
+export default class ExampleAuthController extends WebServerBaseController {
+    getUserTickers: import("./auth-middleware.js").RouteHandler;
+    getUserOrders: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    getUserProfile: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    private withAuthentication;
+}
+//# sourceMappingURL=example-auth.d.ts.map

package/dist/webserver/controller/example-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-auth.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/example-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,uBAAmD,MAAM,WAAW,CAAC;AAG5E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,uBAAuB;IAEjE,cAAc,8CAWmB;IAGjC,aAAa,GAAU,SAAS,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAexF;IAGK,cAAc,GAAU,SAAS,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAWzF;YAGY,kBAAkB;CAcjC"}

package/dist/webserver/controller/health.d.ts

@@ -0,0 +1,15 @@
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import BaseController from './base.js';
+export default class HealthController extends BaseController {
+    /**
+     * Liveness probe: process is up and not in stopping phase.
+     */
+    live: (_: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    /**
+     * Readiness probe: service dependencies are available & lifecycle is RUNNING with aggregated readiness.
+     */
+    ready: (_: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    private checkDatabaseConnection;
+    private checkRedisConnection;
+}
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,cAAc,MAAM,WAAW,CAAC;AAGvC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IAC1D;;OAEG;IACI,IAAI,GAAU,GAAG,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;IAEF;;OAEG;IACI,KAAK,GAAU,GAAG,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CA6B1E;YAEY,uBAAuB;YAQvB,oBAAoB;CAOnC"}

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

@@ -3,15 +3,20 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 import {
   WebServerRouteType
 } from "./webserver.interface.js";
-function defineRoute({ method, path, schema, handler }) {
+function defineRoute(config) {
   const route = {
     type: WebServerRouteType.Default,
-    method,
-    path,
-    handler
+    method: config.method,
+    path: config.path
   };
-  if (schema) {
-    route.schema = schema;
+  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;
 }

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

@@ -1,7 +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 } 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 function defineRoute<\n  Schema extends RouteSchemaDefinition<any, any, any, any, any> | undefined,\n  Handler extends ControllerAction<Schema>,\n>({ method, path, schema, handler }: DefineRouteConfig<Schema, Handler>): WebServerRoute {\n  const route: WebServerRoute = {\n    type: WebServerRouteType.Default,\n    method,\n    path,\n    handler: handler as ControllerAction<any>,\n  };\n\n  if (schema) {\n    route.schema = schema as AnyRouteSchemaDefinition;\n  }\n\n  return route;\n}\n\nexport type DefineRoute = typeof defineRoute;\n"],
-  "mappings": ";;AACA;AAAA,EAIE;AAAA,OACK;AAaA,SAAS,YAGd,EAAE,QAAQ,MAAM,QAAQ,QAAQ,GAAuD;AACvF,QAAM,QAAwB;AAAA,IAC5B,MAAM,mBAAmB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,QAAQ;AACV,UAAM,SAAS;AAAA,EACjB;AAEA,SAAO;AACT;AAhBgB;",
+  "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

@@ -0,0 +1,14 @@
+export { default as WebServer } from './webserver.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 { 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

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

@@ -7,6 +7,7 @@ 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,
@@ -15,6 +16,7 @@ export {
   default5 as WebServerEntityController,
   default4 as WebServerHealthController,
   WebServerRouteType,
+  defineAction,
   defineRoute,
   withAuth
 };

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 {\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';\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;",
+  "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

@@ -0,0 +1,10 @@
+import type { EntityRouteDefinition } from './webserver.interface.js';
+declare function getEntityRouteDefinitions({ basePath, entityValidationSchema, }: {
+    basePath: string;
+    entityValidationSchema: any;
+}): EntityRouteDefinition[];
+declare const _default: {
+    getEntityRouteDefinitions: typeof getEntityRouteDefinitions;
+};
+export default _default;
+//# sourceMappingURL=util.d.ts.map

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

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

@@ -0,0 +1,93 @@
+import { type FastifyInstance, type HTTPMethods } from 'fastify';
+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;
+        requestId?: string;
+    }
+}
+declare class WebServer {
+    private logger;
+    private applicationConfig;
+    private options;
+    private routes;
+    private redisInstance;
+    private queueManager;
+    private eventManager;
+    private databaseInstance;
+    fastifyServer: FastifyInstance<any, any, any, any, ZodTypeProvider>;
+    private lifecycleManager;
+    private _isReady;
+    constructor(params: WebServerConstructorParams & {
+        lifecycleManager: LifecycleManager;
+    });
+    /**
+     * Load web server.
+     */
+    load(): Promise<void>;
+    /**
+     * Configure security features (Helmet, Rate Limiting)
+     */
+    private configureSecurity;
+    /**
+     * Configure hooks.
+     */
+    private configureHooks;
+    private onListen;
+    private onRequest;
+    private onResponse;
+    private onError;
+    private onClose;
+    private configureCORS;
+    private configureMultipartUploads;
+    /**
+     * Configure routes.
+     */
+    private configureRoutes;
+    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;
+        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.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop web server.
+     */
+    stop(): Promise<void>;
+    private buildFastifySchema;
+    private buildLegacySchema;
+    /**
+     * Check if web server is ready to accept traffic.
+     */
+    isReady(): boolean;
+    /**
+     * Log web server message
+     */
+    log(message: string, meta?: Record<string, unknown>): void;
+}
+export default WebServer;
+//# sourceMappingURL=webserver.d.ts.map

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

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