@scpxl/nodejs-framework 1.0.13

package/README.md

@@ -0,0 +1,195 @@
+# PXL Node.js Framework
+
+A comprehensive Node.js framework for building modern applications with support for web servers, databases, queues, caching, and more.
+
+## Installation
+
+Install the framework from NPM:
+
+```sh
+npm install @scpxl/nodejs-framework
+```
+
+## Quick Start
+
+```ts
+import { WebApplication } from '@scpxl/nodejs-framework/application';
+
+const app = new WebApplication({
+  webServer: {
+    port: 3000,
+    host: '0.0.0.0'
+  },
+  database: {
+    host: 'localhost',
+    port: 5432,
+    dbName: 'myapp',
+    user: 'user',
+    password: 'password'
+  }
+});
+
+await app.start();
+```
+
+## Features
+
+- 🚀 **FastAPI-powered Web Server** with auto-routing
+- 🗄️ **Database Integration** with MikroORM and PostgreSQL
+- 📦 **Queue System** using BullMQ and Redis
+- 🔄 **WebSocket Support** for real-time communication
+- 🗄️ **Caching Layer** with Redis integration
+- ☁️ **AWS S3 Integration** for file storage
+- 🔐 **Authentication System** with JWT
+- 📊 **Structured Logging** with Winston
+- 🧪 **Built-in Testing Utils**
+- ⚡ **Performance Monitoring**
+
+## Development (Framework Contributors)
+
+### Local Development
+
+Clone this repository and switch to the project specific Node.js version:
+
+```sh
+git clone https://github.com/PXLbros/pxl-nodejs-framework.git
+cd pxl-nodejs-framework
+nvm use
+npm install
+```
+
+### Build
+
+```sh
+npm run build
+```
+
+### Testing with Yalc (Local Development)
+
+For local testing before publishing to NPM:
+
+```sh
+# Build and publish locally
+npm run build:local
+
+# In your project
+yalc add @pxl/nodejs-framework
+```
+
+## Development
+
+### Local Development
+
+For local development with automatic publishing through **Yalc**:
+
+```sh
+npm run dev
+```
+
+For building locally with Yalc publishing:
+
+```sh
+npm run build:local
+```
+
+For building without Yalc (CI/production build):
+
+```sh
+npm run build
+```
+
+## CI/CD Pipeline
+
+This project uses GitHub Actions for continuous integration and deployment:
+
+### Build and Test (CI)
+
+- Runs on all pull requests
+- Installs dependencies, runs linting, builds the project, and runs tests
+
+### Build and Publish
+
+- Runs on pushes to `main`/`master` branches and version tags
+- Builds the project and publishes to npm
+- Beta releases are published on pushes to main/master branches
+- Stable releases are published when version tags are created
+
+### Setup for Publishing
+
+To enable automatic publishing, configure the following repository secret:
+
+- `NPM_TOKEN`: Your npm authentication token
+
+> **Note**: The `dist/` folder is gitignored and automatically generated during the CI/CD process. Do not commit built files to the repository.
+
+## Releasing
+
+Use the built-in release script to create new versions:
+
+### Quick Release Commands
+
+```sh
+# Patch release (1.0.0 → 1.0.1)
+npm run release -- --patch
+
+# Minor release (1.0.0 → 1.1.0)
+npm run release -- --minor
+
+# Major release (1.0.0 → 2.0.0)
+npm run release -- --major
+
+# Specific version
+npm run release -- --version 2.1.3
+```
+
+### Release Process
+
+The release script will:
+
+1. Check that your working directory is clean
+2. Verify you're on the main/master branch
+3. Update the version in `package.json`
+4. Create a git commit and tag
+5. Push to origin, triggering GitHub Actions
+
+### Dry Run
+
+Preview what the release script will do without making changes:
+
+```sh
+npm run release -- --patch --dry-run
+```
+
+### Help
+
+For more information about the release script:
+
+```sh
+npm run release -- --help
+```
+
+## Documentation
+
+The API documentation is automatically generated using TypeDoc and deployed via GitHub Actions to GitHub Pages.
+
+### Local Documentation Development
+
+To generate and view documentation locally:
+
+```sh
+npm run docs
+```
+
+This will generate the documentation in the `docs/` folder. You can then open `docs/index.html` in your browser.
+
+### Automated Documentation Deployment
+
+Documentation is automatically built and deployed to GitHub Pages when:
+
+- Code is pushed to the `main` or `master` branch
+- Pull requests are opened against `main` or `master` branch
+- Manual workflow dispatch is triggered
+
+The documentation will be available at: `https://[your-username].github.io/[repository-name]/`
+
+> **Note**: The `docs/` folder is gitignored and should not be committed to the repository as it's automatically generated by the CI/CD pipeline.

package/dist/api-requester/api-requester.d.ts

@@ -0,0 +1,11 @@
+import { type AxiosRequestConfig, type AxiosResponse } from 'axios';
+export default class ApiRequester {
+    private axiosInstance;
+    constructor(baseURL: string, headers?: Record<string, string>);
+    get<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T> | undefined>;
+    post<T, R>(url: string, data: T, config?: AxiosRequestConfig): Promise<AxiosResponse<R> | undefined>;
+    put<T, R>(url: string, data: T, config?: AxiosRequestConfig): Promise<AxiosResponse<R> | undefined>;
+    delete<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T> | undefined>;
+    private handleError;
+}
+//# sourceMappingURL=api-requester.d.ts.map

package/dist/api-requester/api-requester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-requester.d.ts","sourceRoot":"","sources":["../../src/api-requester/api-requester.ts"],"names":[],"mappings":"AAAA,OAAc,EAAsB,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAE/F,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IASvF,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IASpG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IASnG,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IASvG,OAAO,CAAC,WAAW;CAUpB"}

package/dist/api-requester/api-requester.js

@@ -0,0 +1,59 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import axios from "axios";
+class ApiRequester {
+  static {
+    __name(this, "ApiRequester");
+  }
+  axiosInstance;
+  constructor(baseURL, headers) {
+    this.axiosInstance = axios.create({
+      baseURL,
+      headers
+    });
+  }
+  async get(url, config) {
+    try {
+      const response = await this.axiosInstance.get(url, config);
+      return response;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async post(url, data, config) {
+    try {
+      const response = await this.axiosInstance.post(url, data, config);
+      return response;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async put(url, data, config) {
+    try {
+      const response = await this.axiosInstance.put(url, data, config);
+      return response;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async delete(url, config) {
+    try {
+      const response = await this.axiosInstance.delete(url, config);
+      return response;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  handleError(error) {
+    if (axios.isAxiosError(error)) {
+      console.error("Axios error:", error.response?.data);
+    } else {
+      console.error("Unexpected error:", error);
+    }
+    throw error;
+  }
+}
+export {
+  ApiRequester as default
+};
+//# sourceMappingURL=api-requester.js.map

package/dist/api-requester/api-requester.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/api-requester/api-requester.ts"],
+  "sourcesContent": ["import axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\n\nexport default class ApiRequester {\n  private axiosInstance: AxiosInstance;\n\n  constructor(baseURL: string, headers?: Record<string, string>) {\n    this.axiosInstance = axios.create({\n      baseURL,\n      headers,\n    });\n  }\n\n  public async get<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T> | undefined> {\n    try {\n      const response = await this.axiosInstance.get<T>(url, config);\n      return response;\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  public async post<T, R>(url: string, data: T, config?: AxiosRequestConfig): Promise<AxiosResponse<R> | undefined> {\n    try {\n      const response = await this.axiosInstance.post<R>(url, data, config);\n      return response;\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  public async put<T, R>(url: string, data: T, config?: AxiosRequestConfig): Promise<AxiosResponse<R> | undefined> {\n    try {\n      const response = await this.axiosInstance.put<R>(url, data, config);\n      return response;\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  public async delete<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T> | undefined> {\n    try {\n      const response = await this.axiosInstance.delete<T>(url, config);\n      return response;\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private handleError(error: any): void {\n    if (axios.isAxiosError(error)) {\n      // Handle Axios-specific errors here\n      console.error('Axios error:', error.response?.data);\n    } else {\n      // Handle non-Axios errors here\n      console.error('Unexpected error:', error);\n    }\n    throw error;\n  }\n}\n"],
+  "mappings": ";;AAAA,OAAO,WAAgF;AAEvF,MAAO,aAA2B;AAAA,EAFlC,OAEkC;AAAA;AAAA;AAAA,EACxB;AAAA,EAER,YAAY,SAAiB,SAAkC;AAC7D,SAAK,gBAAgB,MAAM,OAAO;AAAA,MAChC;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAa,IAAO,KAAa,QAAoE;AACnG,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,cAAc,IAAO,KAAK,MAAM;AAC5D,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAa,KAAW,KAAa,MAAS,QAAoE;AAChH,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,cAAc,KAAQ,KAAK,MAAM,MAAM;AACnE,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAa,IAAU,KAAa,MAAS,QAAoE;AAC/G,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,cAAc,IAAO,KAAK,MAAM,MAAM;AAClE,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAa,OAAU,KAAa,QAAoE;AACtG,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,cAAc,OAAU,KAAK,MAAM;AAC/D,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEQ,YAAY,OAAkB;AACpC,QAAI,MAAM,aAAa,KAAK,GAAG;AAE7B,cAAQ,MAAM,gBAAgB,MAAM,UAAU,IAAI;AAAA,IACpD,OAAO;AAEL,cAAQ,MAAM,qBAAqB,KAAK;AAAA,IAC1C;AACA,UAAM;AAAA,EACR;AACF;",
+  "names": []
+}

package/dist/api-requester/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ApiRequester } from './api-requester.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api-requester/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-requester/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/api-requester/index.js

@@ -0,0 +1,5 @@
+import { default as default2 } from "./api-requester.js";
+export {
+  default2 as ApiRequester
+};
+//# sourceMappingURL=index.js.map

package/dist/api-requester/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/api-requester/index.ts"],
+  "sourcesContent": ["export { default as ApiRequester } from './api-requester.js';\n"],
+  "mappings": "AAAA,SAAoB,WAAXA,gBAA+B;",
+  "names": ["default"]
+}

package/dist/application/base-application.d.ts

@@ -0,0 +1,110 @@
+import { type DatabaseInstance, DatabaseManager } from '../database/index.js';
+import QueueManager from '../queue/manager.js';
+import RedisManager from '../redis/manager.js';
+import type { ApplicationConfig } from './base-application.interface.js';
+import type RedisInstance from '../redis/instance.js';
+import CacheManager from '../cache/manager.js';
+import EventManager from '../event/manager.js';
+import { PerformanceMonitor } from '../performance/performance-monitor.js';
+export type { ApplicationConfig } from './base-application.interface.js';
+export default abstract class BaseApplication {
+    /** Unique instance ID */
+    uniqueInstanceId: string;
+    /** Shutdown signals */
+    protected shutdownSignals: NodeJS.Signals[];
+    /** Application start time */
+    protected startTime: [number, number];
+    /** Whether application is stopping */
+    protected isStopping: boolean;
+    /** Shutdown timeout (30 seconds) */
+    protected shutdownTimeout: number;
+    /** Cache for application version to avoid repeated imports */
+    private static applicationVersionCache;
+    /** Cluster worker ID */
+    protected workerId: number | null;
+    /** Application config */
+    protected config: ApplicationConfig;
+    /** Application version */
+    protected applicationVersion?: string;
+    /** Redis manager */
+    redisManager: RedisManager;
+    /** Cache manager */
+    cacheManager: CacheManager;
+    /** Database manager */
+    databaseManager?: DatabaseManager;
+    /** Queue manager */
+    queueManager?: QueueManager;
+    /** Event manager */
+    eventManager?: EventManager;
+    /** Performance monitor */
+    performanceMonitor?: PerformanceMonitor;
+    get Name(): string;
+    /**
+     * Application constructor
+     */
+    constructor(config: ApplicationConfig);
+    /**
+     * Get application version
+     */
+    getApplicationVersion(): Promise<string>;
+    /**
+     * Start application
+     */
+    start(): Promise<void>;
+    /**
+     * Before application start
+     */
+    private onBeforeStart;
+    /**
+     * Application started event
+     */
+    protected onStarted({ startupTime: _startupTime }: {
+        startupTime: number;
+    }): void;
+    /**
+     * Application stopped event
+     */
+    protected onStopped({ runtime: _runtime }: {
+        runtime: number;
+    }): void;
+    /**
+     * Before application stop event
+     */
+    private onBeforeStop;
+    /**
+     * Start application instance
+     */
+    private startInstance;
+    protected abstract startHandler({ redisInstance, databaseInstance, queueManager, eventManager, }: {
+        redisInstance: RedisInstance;
+        databaseInstance?: DatabaseInstance | null;
+        queueManager: QueueManager;
+        eventManager?: EventManager | null;
+    }): Promise<void>;
+    protected abstract stopCallback(): void;
+    /**
+     * Set up global error handlers
+     */
+    /**
+     * Initialize performance monitor
+     */
+    private initializePerformanceMonitor;
+    private setupGlobalErrorHandlers;
+    /**
+     * Initiate graceful shutdown
+     */
+    private initiateGracefulShutdown;
+    /**
+     * Handle shutdown
+     */
+    handleShutdown({ onStopped }: {
+        onStopped?: ({ runtime }: {
+            runtime: number;
+        }) => void;
+    }): void;
+    /**
+     * Stop application
+     */
+    private stop;
+}
+//# sourceMappingURL=base-application.d.ts.map

package/dist/application/base-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-application.d.ts","sourceRoot":"","sources":["../../src/application/base-application.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAC/C,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AAEtD,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAE/C,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAI3E,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,eAAe;IAC3C,yBAAyB;IAClB,gBAAgB,EAAE,MAAM,CAAC;IAEhC,uBAAuB;IACvB,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAyB;IAEpE,6BAA6B;IAC7B,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAU;IAE/C,sCAAsC;IACtC,SAAS,CAAC,UAAU,UAAS;IAE7B,oCAAoC;IACpC,SAAS,CAAC,eAAe,SAAS;IAElC,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAqB;IAE3D,wBAAwB;IACxB,SAAS,CAAC,QAAQ,gBAAiE;IAEnF,yBAAyB;IACzB,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEpC,0BAA0B;IAC1B,SAAS,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAEtC,oBAAoB;IACb,YAAY,EAAE,YAAY,CAAC;IAElC,oBAAoB;IACb,YAAY,EAAE,YAAY,CAAC;IAElC,uBAAuB;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAEzC,oBAAoB;IACb,YAAY,CAAC,EAAE,YAAY,CAAC;IAEnC,oBAAoB;IACb,YAAY,CAAC,EAAE,YAAY,CAAC;IAEnC,0BAA0B;IACnB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAE/C,IAAW,IAAI,WAEd;IAED;;OAEG;gBACS,MAAM,EAAE,iBAAiB;IA4ErC;;OAEG;IACU,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC;IAyBrD;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8DnC;;OAEG;YACW,aAAa;IAoD3B;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAEjF;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAErE;;OAEG;YACW,YAAY;IAU1B;;OAEG;YACW,aAAa;IA8B3B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC9B,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,EAAE;QACD,aAAa,EAAE,aAAa,CAAC;QAC7B,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC3C,YAAY,EAAE,YAAY,CAAC;QAC3B,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjB,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IAEvC;;OAEG;IACH;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAyCpC,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAehC;;OAEG;IACI,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAA;KAAE,GAAG,IAAI;IAStG;;OAEG;YACW,IAAI;CAuCnB"}

package/dist/application/base-application.interface.d.ts

@@ -0,0 +1,161 @@
+import type { ClusterManagerConfig } from '../cluster/cluster-manager.interface.js';
+import type DatabaseInstance from '../database/instance.js';
+import type { EventDefinition } from '../event/manager.interface.js';
+import type { PerformanceMonitorOptions, PerformanceThresholds } from '../performance/performance-monitor.js';
+import type { QueueItem } from '../queue/index.interface.js';
+import type { WebServerDebugOptions, WebServerLogConfig, WebServerOptions, WebServerRoute } from '../webserver/webserver.interface.js';
+import type WebSocketServer from '../websocket/websocket-server.js';
+import type { WebSocketOptions, WebSocketRoute, WebSocketType } from '../websocket/websocket.interface.js';
+export type OnStartedEvent = ({ startupTime }: {
+    startupTime: number;
+}) => void;
+export type OnStoppedEvent = ({ runtime }: {
+    runtime: number;
+}) => void;
+export interface ApplicationStartInstanceOptions {
+    /** On started event */
+    onStarted?: OnStartedEvent;
+}
+export interface ApplicationStopInstanceOptions {
+    /** On stopped event */
+    onStopped?: OnStoppedEvent;
+}
+export interface ApplicationRedisConfig {
+    /** Redis host */
+    host: string;
+    /** Redis port */
+    port: number;
+    /** Redis password */
+    password?: string;
+}
+export interface ApplicationCacheConfig {
+}
+export interface ApplicationDatabaseConfig {
+    /** Whether to enable database */
+    enabled: boolean;
+    /** Database host */
+    host: string;
+    /** Database port */
+    port: number;
+    /** Database username */
+    username: string;
+    /** Database password */
+    password: string;
+    /** Database name */
+    databaseName: string;
+    /** Entities directory */
+    entitiesDirectory: string;
+}
+export interface ApplicationQueueConfig {
+    /** Initial queues */
+    queues: QueueItem[];
+    /** Queue processors directory */
+    processorsDirectory: string;
+    log?: {
+        jobRegistered?: boolean;
+        jobAdded?: boolean;
+        jobCompleted?: boolean;
+        queueRegistered?: boolean;
+        queuesRegistered?: boolean;
+        queueWaiting?: boolean;
+    };
+}
+export interface ApplicationEventConfig {
+    /** Whether to enable event system */
+    enabled: boolean;
+    /** Event controllers directory */
+    controllersDirectory: string;
+    /** Event definitions */
+    events: EventDefinition[];
+}
+export interface ApplicationEmailConfig {
+}
+export interface ApplicationAuthConfig {
+    /** JWT secret key for token verification */
+    jwtSecretKey: string;
+}
+export interface ApplicationWebSocketConfig extends WebSocketOptions {
+    /** WebSocket type */
+    type: WebSocketType;
+    /** Whether to enable WebSocket */
+    enabled: boolean;
+    /** WebSocket routes */
+    routes: WebSocketRoute[];
+    /** WebSocket server message handler */
+    serverMessageHandler?: (options: {
+        ws: WebSocket;
+        clientId: string;
+        parsedMessage: any;
+    }) => void;
+    /** WebSocket subscriber event handler */
+    subscriberEventHandler?: (options: {
+        channel: string;
+        message: any;
+        webSocketServer: WebSocketServer;
+        databaseInstance: DatabaseInstance;
+    }) => void;
+}
+export interface ApplicationWebServerConfig extends WebServerOptions {
+    /** Whether to enable web server */
+    enabled: boolean;
+    /** Web server routes */
+    routes: WebServerRoute[];
+    log?: WebServerLogConfig;
+    debug: WebServerDebugOptions;
+}
+export interface ApplicationCommandsConfig {
+    commandsDirectory: string;
+}
+export interface ApplicationLogConfig {
+    startUp?: boolean;
+    shutdown?: boolean;
+}
+export interface ApplicationPerformanceConfig extends PerformanceMonitorOptions {
+    /** Whether to enable performance monitoring */
+    enabled?: boolean;
+    /** Performance thresholds for different operations */
+    thresholds?: Partial<PerformanceThresholds>;
+    /** Whether to monitor HTTP requests */
+    monitorHttpRequests?: boolean;
+    /** Whether to monitor database operations */
+    monitorDatabaseOperations?: boolean;
+    /** Whether to monitor WebSocket operations */
+    monitorWebSocketOperations?: boolean;
+    /** Whether to monitor queue operations */
+    monitorQueueOperations?: boolean;
+    /** Whether to monitor cache operations */
+    monitorCacheOperations?: boolean;
+    /** Performance report generation interval in milliseconds */
+    reportInterval?: number;
+    /** Performance report format: 'simple' for one-line, 'detailed' for multi-line */
+    reportFormat?: 'simple' | 'detailed';
+}
+export interface ApplicationConfig {
+    /** Application name */
+    name: string;
+    /** Application instance ID */
+    instanceId: string;
+    /** Root directory */
+    rootDirectory: string;
+    /** Cluster configuration */
+    cluster?: ClusterManagerConfig;
+    /** Redis configuration */
+    redis: ApplicationRedisConfig;
+    /** Cache configuration */
+    cache?: ApplicationCacheConfig;
+    /** Database configuration */
+    database?: ApplicationDatabaseConfig;
+    /** Queue configuration */
+    queue: ApplicationQueueConfig;
+    /** Event configuration */
+    event?: ApplicationEventConfig;
+    /** Log configuration */
+    log?: ApplicationLogConfig;
+    /** Performance monitoring configuration */
+    performanceMonitoring?: ApplicationPerformanceConfig;
+    /** Email configuration */
+    email?: ApplicationEmailConfig;
+    /** Authentication configuration */
+    auth?: ApplicationAuthConfig;
+}
+//# sourceMappingURL=base-application.interface.d.ts.map

package/dist/application/base-application.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-application.interface.d.ts","sourceRoot":"","sources":["../../src/application/base-application.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,eAAe,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAE3G,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,+BAA+B;IAC9C,uBAAuB;IACvB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AACD,MAAM,WAAW,8BAA8B;IAC7C,uBAAuB;IACvB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IAEjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,GAAG,CAAC,EAAE;QACJ,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,kCAAkC;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,wBAAwB;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,qBAAqB;IACrB,IAAI,EAAE,aAAa,CAAC;IAEpB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,uBAAuB;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IAEzB,uCAAuC;IACvC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI,CAAC;IAElG,yCAAyC;IACzC,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,GAAG,CAAC;QACb,eAAe,EAAE,eAAe,CAAC;QACjC,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IAWjB,wBAAwB;IACxB,MAAM,EAAE,cAAc,EAAE,CAAC;IAKzB,GAAG,CAAC,EAAE,kBAAkB,CAAC;IAEzB,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,4BAA6B,SAAQ,yBAAyB;IAC7E,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE5C,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,6CAA6C;IAC7C,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC,8CAA8C;IAC9C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kFAAkF;IAClF,YAAY,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAE/B,0BAA0B;IAC1B,KAAK,EAAE,sBAAsB,CAAC;IAE9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAErC,0BAA0B;IAC1B,KAAK,EAAE,sBAAsB,CAAC;IAE9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B,wBAAwB;IACxB,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAE3B,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,4BAA4B,CAAC;IAErD,0BAA0B;IAC1B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B,mCAAmC;IACnC,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B"}

package/dist/application/base-application.interface.js

@@ -0,0 +1 @@
+//# sourceMappingURL=base-application.interface.js.map

package/dist/application/base-application.interface.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}