@scpxl/nodejs-framework 1.0.22 → 1.0.25

package/dist/util/num.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+    getRandomNumber: ({ min, max }: {
+        min: number;
+        max: number;
+    }) => number;
+    clamp: ({ value, min, max }: {
+        value: number;
+        min: number;
+        max: number;
+    }) => number;
+};
+export default _default;
+//# sourceMappingURL=num.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"num.d.ts","sourceRoot":"","sources":["../../src/util/num.ts"],"names":[],"mappings":";oCAAuC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM;iCAIxC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM;;AAIxF,wBAGE"}

package/dist/util/os.d.ts

@@ -0,0 +1,6 @@
+declare function getUniqueComputerId(): string;
+declare const _default: {
+    getUniqueComputerId: typeof getUniqueComputerId;
+};
+export default _default;
+//# sourceMappingURL=os.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"os.d.ts","sourceRoot":"","sources":["../../src/util/os.ts"],"names":[],"mappings":"AAGA,iBAAS,mBAAmB,IAAI,MAAM,CAarC;;;;AAED,wBAEE"}

package/dist/util/str.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Generate a unique id.
+ */
+declare function generateUniqueId(): string;
+/**
+ * Slugify string.
+ */
+declare function slugify({ text }: {
+    text: string;
+}): string;
+/**
+ * Make text title case.
+ */
+declare function titleCase({ text }: {
+    text: string;
+}): string;
+/**
+ * Remove file extension from filename.
+ */
+declare function removeFileExtension({ filename }: {
+    filename: string;
+}): string;
+/**
+ * Get file extension from filename.
+ * @param filename
+ * @returns File extension
+ */
+declare function getFileExtension({ filename }: {
+    filename: string;
+}): string;
+declare const _default: {
+    generateUniqueId: typeof generateUniqueId;
+    slugify: typeof slugify;
+    titleCase: typeof titleCase;
+    removeFileExtension: typeof removeFileExtension;
+    getFileExtension: typeof getFileExtension;
+};
+export default _default;
+//# sourceMappingURL=str.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"str.d.ts","sourceRoot":"","sources":["../../src/util/str.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,iBAAS,gBAAgB,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,iBAAS,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQnD;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMrD;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpE;;;;;;;;AAED,wBAME"}

package/dist/util/time.d.ts

@@ -0,0 +1,19 @@
+import type { FormatRelativeTimeOptions, FormatTimeOptions } from './time.interface.js';
+import Timing from './timing.js';
+declare const _default: {
+    calculateElapsedTimeMs: ({ startTime }: {
+        startTime: number;
+    }) => number;
+    formatTime: ({ time, format, numDecimals, showUnit }: FormatTimeOptions) => string;
+    formatRelativeTime: ({ date, baseDate, includeSeconds, }: FormatRelativeTimeOptions) => string;
+    sleep: ({ seconds }: {
+        seconds: number;
+    }) => Promise<void>;
+    now: typeof Timing.now;
+    start: typeof Timing.start;
+    measure: typeof Timing.measure;
+    measureSync: typeof Timing.measureSync;
+    duration: typeof Timing.duration;
+};
+export default _default;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/util/time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,MAAM,MAAM,aAAa,CAAC;;4CAMc;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM;0DAOI,iBAAiB,KAAG,MAAM;8DA4CxG,yBAAyB,KAAG,MAAM;yBAbT;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;AA6D/D,wBAWE"}

package/dist/util/time.interface.d.ts

@@ -0,0 +1,12 @@
+export interface FormatTimeOptions {
+    time: number;
+    format?: 'ms' | 's' | 'auto' | 'hh:mm:ss';
+    numDecimals?: number;
+    showUnit?: boolean;
+}
+export interface FormatRelativeTimeOptions {
+    date: Date;
+    baseDate?: Date;
+    includeSeconds?: boolean;
+}
+//# sourceMappingURL=time.interface.d.ts.map

package/dist/util/time.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.interface.d.ts","sourceRoot":"","sources":["../../src/util/time.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/util/timing.d.ts

@@ -0,0 +1,36 @@
+import type { MeasureOptions, Timer, TimingResult } from './timing.interface.js';
+/**
+ * Modern high-resolution timing utility using performance.now()
+ *
+ * Provides simple APIs for measuring function execution time and manual timing.
+ * All durations are returned in milliseconds with decimal precision.
+ */
+declare class Timing {
+    /**
+     * Get current high-resolution timestamp in milliseconds.
+     * Uses performance.now() which provides sub-millisecond precision.
+     */
+    static now(): number;
+    /**
+     * Start a timer and return a Timer instance.
+     * Call timer.stop() to get elapsed time in milliseconds.
+     */
+    static start(): Timer;
+    /**
+     * Measure the execution time of a function (async or sync).
+     * Returns both the function result and timing information.
+     */
+    static measure<T>(fn: () => T | Promise<T>, options?: MeasureOptions): Promise<TimingResult<T>>;
+    /**
+     * Measure the execution time of a synchronous function.
+     * Returns both the function result and timing information.
+     */
+    static measureSync<T>(fn: () => T, options?: MeasureOptions): TimingResult<T>;
+    /**
+     * Calculate duration between two timestamps in milliseconds.
+     * Both timestamps should be from performance.now().
+     */
+    static duration(startTime: number, endTime: number): number;
+}
+export default Timing;
+//# sourceMappingURL=timing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/util/timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAqBjF;;;;;GAKG;AACH,cAAM,MAAM;IACV;;;OAGG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,KAAK;IAIrB;;;OAGG;WACU,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAwBzG;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CAAC,CAAC,CAAC;IAwBjF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAG5D;AAED,eAAe,MAAM,CAAC"}

package/dist/util/timing.interface.d.ts

@@ -0,0 +1,47 @@
+export interface Timer {
+    /**
+     * Stop the timer and return elapsed time in milliseconds with decimal precision.
+     */
+    stop(): number;
+    /**
+     * Get elapsed time since timer start without stopping the timer.
+     */
+    elapsed(): number;
+    /**
+     * The start timestamp in milliseconds (performance.now() format).
+     */
+    readonly startTime: number;
+}
+export interface TimingResult<T = unknown> {
+    /**
+     * Duration in milliseconds with decimal precision.
+     */
+    duration: number;
+    /**
+     * The result returned by the measured function.
+     */
+    result: T;
+    /**
+     * Start timestamp in milliseconds (performance.now() format).
+     */
+    startTime: number;
+    /**
+     * End timestamp in milliseconds (performance.now() format).
+     */
+    endTime: number;
+}
+export interface MeasureOptions {
+    /**
+     * Optional name for the measurement (useful for logging/debugging).
+     */
+    name?: string;
+    /**
+     * Whether to log the timing result automatically.
+     */
+    log?: boolean;
+    /**
+     * Custom logger function to use if log is true.
+     */
+    logger?: (message: string, duration: number) => void;
+}
+//# sourceMappingURL=timing.interface.d.ts.map

package/dist/util/timing.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.interface.d.ts","sourceRoot":"","sources":["../../src/util/timing.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD"}

package/dist/util/url.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    buildQueryString: (params: {
+        [key: string]: string | number | boolean;
+    }) => string;
+};
+export default _default;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/util/url.ts"],"names":[],"mappings":";+BAAkC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,KAAG,MAAM;;AAOvF,wBAEE"}

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

@@ -0,0 +1,21 @@
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import type { AuthenticatedUser } from './base.js';
+export type { AuthenticatedUser } from './base.js';
+export interface AuthenticatedRequest extends FastifyRequest {
+    user: AuthenticatedUser;
+}
+export type AuthenticatedRouteHandler = (request: AuthenticatedRequest, reply: FastifyReply) => Promise<void>;
+export type RouteHandler = (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+/**
+ * Higher-order function that wraps a route handler with authentication
+ * @param handler The route handler that requires authentication
+ * @param authenticateRequest The authentication method from the controller
+ * @returns A new route handler with authentication built-in
+ */
+export declare function withAuth(handler: AuthenticatedRouteHandler, authenticateRequest: (request: FastifyRequest, reply: FastifyReply) => Promise<AuthenticatedUser | null>): RouteHandler;
+/**
+ * Method decorator for class-based controllers
+ * Usage: @requiresAuth()
+ */
+export declare function requiresAuth(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=auth-middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/auth-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9G,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,yBAAyB,EAClC,mBAAmB,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GACvG,YAAY,CAed;AAED;;;GAGG;AACH,wBAAgB,YAAY,KACT,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAoBlF"}

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;AAI7E,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;IA4CD,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/base.js

@@ -4,6 +4,7 @@ import { StatusCodes } from "http-status-codes";
 import { Logger } from "../../logger/index.js";
 import cluster from "cluster";
 import Jwt from "../../auth/jwt.js";
+import { safeSerializeError } from "../../error/error-reporter.js";
 class BaseController {
   static {
     __name(this, "BaseController");
@@ -73,7 +74,7 @@ class BaseController {
         publicErrorMessage = error.stack ?? error.message;
         errorDetails = { stack: error.stack, name: error.name };
       } else {
-        publicErrorMessage = String(error);
+        publicErrorMessage = safeSerializeError(error);
       }
     } else {
       if (process.env.NODE_ENV === "production") {
@@ -89,12 +90,11 @@ class BaseController {
           publicErrorMessage = error.stack ?? error.message;
           errorDetails = { stack: error.stack, name: error.name };
         } else {
-          publicErrorMessage = String(error);
+          publicErrorMessage = safeSerializeError(error);
         }
       }
     }
-    Logger.custom({ level: "webServer", message: error });
-    console.error(error);
+    Logger.error({ error });
     const apiError = {
       message: publicErrorMessage,
       type: errorType ?? this.getErrorType(statusCode),

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<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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",
+  "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';\nimport { safeSerializeError } from '../../error/error-reporter.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 = safeSerializeError(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 = safeSerializeError(error);\n        }\n      }\n    }\n\n    Logger.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/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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"}