@scpxl/nodejs-framework 1.0.22 → 1.0.24

package/dist/database/dynamic-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-entity.d.ts","sourceRoot":"","sources":["../../src/database/dynamic-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAEpD,8BAAsB,aAAc,SAAQ,UAAU;IACpD,OAAc,MAAM,EAAE,MAAM,CAAC;IAC7B,OAAc,YAAY,EAAE,MAAM,CAAC;IAEnC,WAAkB,YAAY,IAAI,MAAM,CAEvC;IAED,WAAkB,UAAU,IAAI,MAAM,CAErC;IAED,WAAkB,qBAAqB,IAAI,MAAM,CAEhD;IAED,WAAkB,mBAAmB,IAAI,MAAM,CAE9C;IAED,WAAkB,uBAAuB,IAAI,MAAM,CAElD;IAED,WAAkB,qBAAqB,IAAI,MAAM,CAEhD;WAEa,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB;WAa3D,eAAe,IAAI,MAAM,EAAE;CAG1C"}

package/dist/database/index.d.ts

@@ -0,0 +1,5 @@
+export { default as DatabaseManager } from './manager.js';
+export { default as DatabaseInstance } from './instance.js';
+export { FormField, FormFieldType } from './dynamic-entity-form-decorators.js';
+export { DynamicEntity } from './dynamic-entity.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/database/instance.d.ts

@@ -0,0 +1,36 @@
+import type { EntityManager, MikroORM } from '@mikro-orm/postgresql';
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type DatabaseManager from './manager.js';
+/**
+ * Database Instance
+ */
+export default class DatabaseInstance {
+    /** Database manager */
+    private databaseManager;
+    /** Application config */
+    private applicationConfig;
+    /** MikroORM instance */
+    private orm;
+    /**
+     * Database Instance constructor
+     * @param orm MikroORM instance
+     */
+    constructor({ databaseManager, applicationConfig, orm, }: {
+        databaseManager: DatabaseManager;
+        applicationConfig: ApplicationConfig;
+        orm: MikroORM;
+    });
+    /**
+     * Check if database is connected
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Get EntityManager
+     */
+    getEntityManager(): EntityManager;
+    /**
+     * Disconnect
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/database/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/database/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,eAAe,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,uBAAuB;IACvB,OAAO,CAAC,eAAe,CAAkB;IAEzC,yBAAyB;IACzB,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,wBAAwB;IACxB,OAAO,CAAC,GAAG,CAAW;IAEtB;;;OAGG;gBACS,EACV,eAAe,EACf,iBAAiB,EACjB,GAAG,GACJ,EAAE;QACD,eAAe,EAAE,eAAe,CAAC;QACjC,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,GAAG,EAAE,QAAQ,CAAC;KACf;IAMD;;OAEG;IACI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAItC;;OAEG;IACI,gBAAgB,IAAI,aAAa;IAIxC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAKzC"}

package/dist/database/instance.interface.d.ts

@@ -0,0 +1,5 @@
+import type { MikroORM } from '@mikro-orm/postgresql';
+export interface DatabaseInstanceConstructorParams {
+    orm: MikroORM;
+}
+//# sourceMappingURL=instance.interface.d.ts.map

package/dist/database/instance.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.interface.d.ts","sourceRoot":"","sources":["../../src/database/instance.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,iCAAiC;IAChD,GAAG,EAAE,QAAQ,CAAC;CACf"}

package/dist/database/manager.d.ts

@@ -0,0 +1,27 @@
+import DatabaseInstance from './instance.js';
+import type { ApplicationDatabaseOptions } from './manager.interface.js';
+/**
+ * Database manager
+ */
+export default class DatabaseManager {
+    private logger;
+    private readonly options;
+    private instances;
+    /**
+     * Database manager constructor
+     */
+    constructor(options: ApplicationDatabaseOptions);
+    /**
+     * Connect to database
+     */
+    connect(): Promise<DatabaseInstance>;
+    /**
+     * Disconnect from database
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Log database message
+     */
+    log(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/database/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/database/manager.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAIzE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,OAAO,CAAC,SAAS,CAA0B;IAE3C;;OAEG;gBACS,OAAO,EAAE,0BAA0B;IAI/C;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAiDjD;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CxC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}

package/dist/database/manager.interface.d.ts

@@ -0,0 +1,18 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+export interface ApplicationDatabaseOptions {
+    /** Application config */
+    applicationConfig: ApplicationConfig;
+    /** Database host */
+    host: string;
+    /** Database port */
+    port: number;
+    /** Database username */
+    username: string;
+    /** Database password */
+    password: string;
+    /** Database name */
+    databaseName: string;
+    /** Entities directory */
+    entitiesDirectory: string;
+}
+//# sourceMappingURL=manager.interface.d.ts.map

package/dist/database/manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.interface.d.ts","sourceRoot":"","sources":["../../src/database/manager.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEtF,MAAM,WAAW,0BAA0B;IACzC,yBAAyB;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,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"}

package/dist/error/error-reporter.d.ts

@@ -0,0 +1,96 @@
+import { type ErrorEnvelope, type ErrorReportOptions } from './error.interface.js';
+/**
+ * Centralized error reporter for the framework
+ *
+ * Provides a unified interface for error reporting, normalization, logging,
+ * and external error tracking (Sentry). Eliminates inconsistent error handling
+ * and ensures all errors are properly structured and correlated.
+ *
+ * @example
+ * ```typescript
+ * const errorReporter = ErrorReporter.getInstance();
+ *
+ * // Report an error
+ * errorReporter.report(error, {
+ *   context: { userId: '123', operation: 'fetchUser' },
+ *   severity: ErrorSeverity.CRITICAL
+ * });
+ *
+ * // Report with custom code
+ * errorReporter.report(
+ *   new Error('Database connection lost'),
+ *   {
+ *     code: ErrorCode.DATABASE_CONNECTION_FAILED,
+ *     captureInSentry: true
+ *   }
+ * );
+ * ```
+ */
+export declare class ErrorReporter {
+    private static instance;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): ErrorReporter;
+    /**
+     * Report an error through the centralized error pipeline
+     *
+     * This method:
+     * 1. Normalizes the error into a standard envelope
+     * 2. Logs the error with appropriate severity
+     * 3. Optionally captures the error in Sentry
+     * 4. Adds request correlation if available
+     *
+     * @param error - The error to report (Error, string, or unknown)
+     * @param options - Reporting options (context, severity, etc.)
+     * @returns Normalized error envelope
+     */
+    report(error: Error | unknown, options?: ErrorReportOptions): ErrorEnvelope;
+    /**
+     * Normalize any error into a standardized ErrorEnvelope
+     *
+     * @param error - The error to normalize
+     * @param options - Optional configuration
+     * @returns Normalized error envelope
+     */
+    private normalizeError;
+    /**
+     * Log the error with appropriate severity
+     *
+     * @param envelope - Normalized error envelope
+     */
+    private logError;
+    /**
+     * Determine if error should be captured in Sentry
+     *
+     * @param envelope - Normalized error envelope
+     * @param options - Reporting options
+     * @returns Whether to capture in Sentry
+     */
+    private shouldCaptureInSentry;
+    /**
+     * Capture error in Sentry with enriched context
+     *
+     * @param error - Original error
+     * @param envelope - Normalized error envelope
+     */
+    private captureInSentry;
+    /**
+     * Map framework error severity to Sentry severity level
+     *
+     * @param severity - Framework error severity
+     * @returns Sentry severity level
+     */
+    private mapSeverityToSentryLevel;
+    /**
+     * Serialize unknown error types to string
+     *
+     * @param error - Unknown error
+     * @returns String representation
+     */
+    private serializeUnknownError;
+}
+declare const _default: ErrorReporter;
+export default _default;
+//# sourceMappingURL=error-reporter.d.ts.map

package/dist/error/error-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporter.d.ts","sourceRoot":"","sources":["../../src/error/error-reporter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAiB,MAAM,sBAAsB,CAAC;AAG7G;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IAEvC,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,aAAa;IAO1C;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa;IAiBlF;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAyDtB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IA8BhB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CAyB9B;;AAGD,wBAA2C"}

package/dist/error/error.interface.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Error severity levels for classification and handling
+ */
+export declare enum ErrorSeverity {
+    /**
+     * Fatal errors that require immediate attention and may cause application failure
+     */
+    FATAL = "fatal",
+    /**
+     * Critical errors that significantly impact functionality
+     */
+    CRITICAL = "critical",
+    /**
+     * Major errors that affect features but don't crash the application
+     */
+    ERROR = "error",
+    /**
+     * Warnings about potential issues
+     */
+    WARNING = "warning",
+    /**
+     * Informational messages about error conditions
+     */
+    INFO = "info"
+}
+/**
+ * Standard error codes for framework errors
+ */
+export declare enum ErrorCode {
+    INVALID_CONFIG = "ERR_INVALID_CONFIG",
+    MISSING_CONFIG = "ERR_MISSING_CONFIG",
+    CONFIG_VALIDATION_FAILED = "ERR_CONFIG_VALIDATION_FAILED",
+    LIFECYCLE_INIT_FAILED = "ERR_LIFECYCLE_INIT_FAILED",
+    LIFECYCLE_START_FAILED = "ERR_LIFECYCLE_START_FAILED",
+    LIFECYCLE_SHUTDOWN_FAILED = "ERR_LIFECYCLE_SHUTDOWN_FAILED",
+    LIFECYCLE_TIMEOUT = "ERR_LIFECYCLE_TIMEOUT",
+    DATABASE_CONNECTION_FAILED = "ERR_DATABASE_CONNECTION_FAILED",
+    DATABASE_QUERY_FAILED = "ERR_DATABASE_QUERY_FAILED",
+    DATABASE_MIGRATION_FAILED = "ERR_DATABASE_MIGRATION_FAILED",
+    REDIS_CONNECTION_FAILED = "ERR_REDIS_CONNECTION_FAILED",
+    REDIS_COMMAND_FAILED = "ERR_REDIS_COMMAND_FAILED",
+    QUEUE_JOB_FAILED = "ERR_QUEUE_JOB_FAILED",
+    QUEUE_CONNECTION_FAILED = "ERR_QUEUE_CONNECTION_FAILED",
+    QUEUE_PROCESSOR_NOT_FOUND = "ERR_QUEUE_PROCESSOR_NOT_FOUND",
+    WEB_SERVER_START_FAILED = "ERR_WEB_SERVER_START_FAILED",
+    WEB_SERVER_REQUEST_FAILED = "ERR_WEB_SERVER_REQUEST_FAILED",
+    WEB_CONTROLLER_NOT_FOUND = "ERR_WEB_CONTROLLER_NOT_FOUND",
+    WEB_ACTION_NOT_FOUND = "ERR_WEB_ACTION_NOT_FOUND",
+    WEBSOCKET_CONNECTION_FAILED = "ERR_WEBSOCKET_CONNECTION_FAILED",
+    WEBSOCKET_MESSAGE_FAILED = "ERR_WEBSOCKET_MESSAGE_FAILED",
+    VALIDATION_FAILED = "ERR_VALIDATION_FAILED",
+    INVALID_INPUT = "ERR_INVALID_INPUT",
+    RESOURCE_NOT_FOUND = "ERR_RESOURCE_NOT_FOUND",
+    RESOURCE_ALREADY_EXISTS = "ERR_RESOURCE_ALREADY_EXISTS",
+    RESOURCE_LOCKED = "ERR_RESOURCE_LOCKED",
+    UNKNOWN = "ERR_UNKNOWN",
+    INTERNAL = "ERR_INTERNAL",
+    NOT_IMPLEMENTED = "ERR_NOT_IMPLEMENTED"
+}
+/**
+ * Normalized error envelope for consistent error handling
+ */
+export interface ErrorEnvelope {
+    /**
+     * Error message (human-readable)
+     */
+    message: string;
+    /**
+     * Error code (machine-readable)
+     */
+    code: ErrorCode | string;
+    /**
+     * Error severity level
+     */
+    severity: ErrorSeverity;
+    /**
+     * Original error stack trace
+     */
+    stack?: string;
+    /**
+     * Request ID for correlation (if available)
+     */
+    requestId?: string;
+    /**
+     * Additional context about the error
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Underlying cause (if error was wrapped)
+     */
+    cause?: unknown;
+    /**
+     * Timestamp when error occurred
+     */
+    timestamp: Date;
+    /**
+     * Error name/type
+     */
+    name?: string;
+}
+/**
+ * Options for error reporting
+ */
+export interface ErrorReportOptions {
+    /**
+     * Additional context to include with the error
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Override error severity
+     */
+    severity?: ErrorSeverity;
+    /**
+     * Override error code
+     */
+    code?: ErrorCode | string;
+    /**
+     * Whether to capture this error in Sentry
+     */
+    captureInSentry?: boolean;
+    /**
+     * Whether to log this error
+     */
+    log?: boolean;
+}
+//# sourceMappingURL=error.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.interface.d.ts","sourceRoot":"","sources":["../../src/error/error.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACvB;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,SAAS;IAEnB,cAAc,uBAAuB;IACrC,cAAc,uBAAuB;IACrC,wBAAwB,iCAAiC;IAGzD,qBAAqB,8BAA8B;IACnD,sBAAsB,+BAA+B;IACrD,yBAAyB,kCAAkC;IAC3D,iBAAiB,0BAA0B;IAG3C,0BAA0B,mCAAmC;IAC7D,qBAAqB,8BAA8B;IACnD,yBAAyB,kCAAkC;IAG3D,uBAAuB,gCAAgC;IACvD,oBAAoB,6BAA6B;IAGjD,gBAAgB,yBAAyB;IACzC,uBAAuB,gCAAgC;IACvD,yBAAyB,kCAAkC;IAG3D,uBAAuB,gCAAgC;IACvD,yBAAyB,kCAAkC;IAC3D,wBAAwB,iCAAiC;IACzD,oBAAoB,6BAA6B;IAGjD,2BAA2B,oCAAoC;IAC/D,wBAAwB,iCAAiC;IAGzD,iBAAiB,0BAA0B;IAC3C,aAAa,sBAAsB;IAGnC,kBAAkB,2BAA2B;IAC7C,uBAAuB,gCAAgC;IACvD,eAAe,wBAAwB;IAGvC,OAAO,gBAAgB;IACvB,QAAQ,iBAAiB;IACzB,eAAe,wBAAwB;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}

package/dist/error/framework-errors.d.ts

@@ -0,0 +1,113 @@
+import { ErrorCode, ErrorSeverity } from './error.interface.js';
+/**
+ * Base framework error class
+ *
+ * All framework-specific errors extend this class for consistent error handling
+ */
+export declare class FrameworkError extends Error {
+    readonly code: ErrorCode | string;
+    readonly severity: ErrorSeverity;
+    readonly context?: Record<string, unknown>;
+    readonly timestamp: Date;
+    constructor(message: string, options?: {
+        code?: ErrorCode | string;
+        severity?: ErrorSeverity;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Configuration error
+ */
+export declare class ConfigurationError extends FrameworkError {
+    constructor(message: string, options?: {
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Validation error
+ */
+export declare class ValidationError extends FrameworkError {
+    constructor(message: string, options?: {
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Database error
+ */
+export declare class DatabaseError extends FrameworkError {
+    constructor(message: string, options?: {
+        code?: ErrorCode;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Redis error
+ */
+export declare class RedisError extends FrameworkError {
+    constructor(message: string, options?: {
+        code?: ErrorCode;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Queue error
+ */
+export declare class QueueError extends FrameworkError {
+    constructor(message: string, options?: {
+        code?: ErrorCode;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Web server error
+ */
+export declare class WebServerError extends FrameworkError {
+    constructor(message: string, options?: {
+        code?: ErrorCode;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * WebSocket error
+ */
+export declare class WebSocketError extends FrameworkError {
+    constructor(message: string, options?: {
+        code?: ErrorCode;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Lifecycle error
+ */
+export declare class LifecycleError extends FrameworkError {
+    constructor(message: string, options?: {
+        code?: ErrorCode;
+        context?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * Resource not found error
+ */
+export declare class ResourceNotFoundError extends FrameworkError {
+    constructor(message: string, options?: {
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Not implemented error
+ */
+export declare class NotImplementedError extends FrameworkError {
+    constructor(message: string, options?: {
+        context?: Record<string, unknown>;
+    });
+}
+//# sourceMappingURL=framework-errors.d.ts.map

package/dist/error/framework-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-errors.d.ts","sourceRoot":"","sources":["../../src/error/framework-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzC,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAgB,SAAS,EAAE,IAAI,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAmBJ;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ9F;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ9F;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAShH;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAShH;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAShH;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAShH;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAShH;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAShH;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAQ7E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAQ7E"}

package/dist/error/index.d.ts

@@ -0,0 +1,6 @@
+export type { ErrorEnvelope, ErrorReportOptions } from './error.interface.js';
+export { ErrorCode, ErrorSeverity } from './error.interface.js';
+export { ErrorReporter } from './error-reporter.js';
+export { FrameworkError, ConfigurationError, ValidationError, DatabaseError, RedisError, QueueError, WebServerError, WebSocketError, LifecycleError, ResourceNotFoundError, NotImplementedError, } from './framework-errors.js';
+export { default as errorReporter } from './error-reporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { DatabaseInstance } from '../../database/index.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type { EventControllerConstructorParams } from './base.interface.js';
+import { Logger } from '../../logger/index.js';
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+export default abstract class BaseEventController {
+    protected logger: typeof Logger;
+    protected workerId: number | undefined;
+    protected applicationConfig: ApplicationConfig;
+    protected redisInstance: RedisInstance;
+    protected databaseInstance: DatabaseInstance | null;
+    constructor({ applicationConfig, redisInstance, databaseInstance }: EventControllerConstructorParams);
+    /**
+     * Enhanced logger with structured methods
+     */
+    log: {
+        error: (error: Error | unknown, message?: string, meta?: Record<string, unknown>) => void;
+        info: (message: string, meta?: Record<string, unknown>) => void;
+        warn: (message: string, meta?: Record<string, unknown>) => void;
+        debug: (message: string, meta?: Record<string, unknown>) => void;
+    };
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/event/controller/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,mBAAmB;IAC/C,SAAS,CAAC,MAAM,EAAE,OAAO,MAAM,CAAU;IAEzC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAE/C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IAEvC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;gBAExC,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE,gCAAgC;IAUpG;;OAEG;IACI,GAAG;uBACO,KAAK,GAAG,OAAO,YAAY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAavE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAI7C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;yBAI5C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;MAG9D;CACH"}

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

@@ -0,0 +1,11 @@
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+import type { DatabaseInstance } from '../../database/index.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type EventBaseController from './base.js';
+export interface EventControllerConstructorParams {
+    applicationConfig: ApplicationConfig;
+    redisInstance: RedisInstance;
+    databaseInstance: DatabaseInstance | null;
+}
+export type EventControllerType = new (params: EventControllerConstructorParams) => EventBaseController;
+//# sourceMappingURL=base.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.interface.d.ts","sourceRoot":"","sources":["../../../src/event/controller/base.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,mBAAmB,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,gCAAgC;IAC/C,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,aAAa,EAAE,aAAa,CAAC;IAE7B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,MAAM,EAAE,gCAAgC,KAAK,mBAAmB,CAAC"}

package/dist/event/index.d.ts

@@ -0,0 +1,5 @@
+export { default as EventManager } from './manager.js';
+export * from './manager.interface.js';
+export { default as EventBaseController } from './controller/base.js';
+export * from './controller/base.interface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtE,cAAc,gCAAgC,CAAC"}

package/dist/event/manager.d.ts

@@ -0,0 +1,21 @@
+import type { EventManagerConstructorParams } from './manager.interface.js';
+export default class EventManager {
+    private logger;
+    private applicationConfig;
+    private options;
+    private events;
+    private redisInstance;
+    private databaseInstance;
+    private eventHandlers;
+    constructor(params: EventManagerConstructorParams);
+    load(): Promise<void>;
+    run<TPayload = unknown>({ name, data }: {
+        name: string;
+        data: TPayload;
+    }): Promise<void>;
+    /**
+     * Log event message
+     */
+    log(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/event/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/event/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,6BAA6B,EAE9B,MAAM,wBAAwB,CAAC;AAMhC,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAgB;IAErC,OAAO,CAAC,gBAAgB,CAA0B;IAElD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,6BAA6B;IAqBpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoFrB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BrG;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}