@scpxl/nodejs-framework 1.0.22 → 1.0.25

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;AAKzE;;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/database/manager.js

@@ -4,6 +4,7 @@ import { MikroORM } from "@mikro-orm/postgresql";
 import DatabaseInstance from "./instance.js";
 import { Logger } from "../logger/index.js";
 import { DatabasePerformanceWrapper } from "../performance/index.js";
+import { safeSerializeError } from "../error/error-reporter.js";
 class DatabaseManager {
   static {
     __name(this, "DatabaseManager");
@@ -48,7 +49,7 @@ class DatabaseManager {
       } catch (error) {
         const duration = performance.now() - startTime;
         this.logger.error({
-          error: error instanceof Error ? error : new Error(String(error)),
+          error: error instanceof Error ? error : new Error(safeSerializeError(error)),
           message: "Database connection failed",
           meta: {
             Host: this.options.host,
@@ -86,7 +87,7 @@ class DatabaseManager {
       } catch (error) {
         const duration = performance.now() - startTime;
         this.logger.error({
-          error: error instanceof Error ? error : new Error(String(error)),
+          error: error instanceof Error ? error : new Error(safeSerializeError(error)),
           message: "Database disconnection failed",
           meta: {
             Host: this.options.host,

package/dist/database/manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/database/manager.ts"],
-  "sourcesContent": ["import { MikroORM } from '@mikro-orm/postgresql';\nimport DatabaseInstance from './instance.js';\nimport type { ApplicationDatabaseOptions } from './manager.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { DatabasePerformanceWrapper } from '../performance/index.js';\n\n/**\n * Database manager\n */\nexport default class DatabaseManager {\n  private logger: typeof Logger = Logger;\n\n  private readonly options: ApplicationDatabaseOptions;\n\n  private instances: DatabaseInstance[] = [];\n\n  /**\n   * Database manager constructor\n   */\n  constructor(options: ApplicationDatabaseOptions) {\n    this.options = options;\n  }\n\n  /**\n   * Connect to database\n   */\n  public async connect(): Promise<DatabaseInstance> {\n    return DatabasePerformanceWrapper.monitorConnection('connect', async () => {\n      const startTime = performance.now();\n\n      try {\n        const orm = await MikroORM.init();\n\n        const databaseInstance = new DatabaseInstance({\n          databaseManager: this,\n          applicationConfig: this.options.applicationConfig,\n          orm,\n        });\n\n        this.instances.push(databaseInstance);\n\n        const duration = performance.now() - startTime;\n        const ormConfig = typeof orm.config?.getAll === 'function' ? orm.config.getAll() : undefined;\n        const logMeta = {\n          Host: ormConfig?.host ?? this.options.host,\n          User: ormConfig?.user ?? this.options.username,\n          Database: ormConfig?.dbName ?? this.options.databaseName,\n          Duration: `${duration.toFixed(2)}ms`,\n        };\n\n        if (this.options.applicationConfig.log?.startUp) {\n          this.log('Connected', logMeta);\n        } else {\n          this.logger.debug({ message: 'Database connected', meta: logMeta });\n        }\n\n        return databaseInstance;\n      } catch (error) {\n        const duration = performance.now() - startTime;\n\n        this.logger.error({\n          error: error instanceof Error ? error : new Error(String(error)),\n          message: 'Database connection failed',\n          meta: {\n            Host: this.options.host,\n            Database: this.options.databaseName,\n            Duration: `${duration.toFixed(2)}ms`,\n          },\n        });\n\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Disconnect from database\n   */\n  public async disconnect(): Promise<void> {\n    await DatabasePerformanceWrapper.monitorConnection('disconnect', async () => {\n      const startTime = performance.now();\n      const instanceCount = this.instances.length;\n\n      try {\n        await Promise.all(this.instances.map(instance => instance.disconnect()));\n\n        const duration = performance.now() - startTime;\n\n        if (instanceCount > 0) {\n          const meta = {\n            Host: this.options.host,\n            Instances: instanceCount,\n            Duration: `${duration.toFixed(2)}ms`,\n          };\n\n          if (this.options.applicationConfig.log?.startUp) {\n            this.log('Disconnected all database instances', meta);\n          } else {\n            this.logger.debug({ message: 'Database instances disconnected', meta });\n          }\n        }\n\n        this.instances = [];\n      } catch (error) {\n        const duration = performance.now() - startTime;\n\n        this.logger.error({\n          error: error instanceof Error ? error : new Error(String(error)),\n          message: 'Database disconnection failed',\n          meta: {\n            Host: this.options.host,\n            Duration: `${duration.toFixed(2)}ms`,\n            Instances: instanceCount,\n          },\n        });\n\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Log database message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'database', message, meta });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { MikroORM } from '@mikro-orm/postgresql';\nimport DatabaseInstance from './instance.js';\nimport type { ApplicationDatabaseOptions } from './manager.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { DatabasePerformanceWrapper } from '../performance/index.js';\nimport { safeSerializeError } from '../error/error-reporter.js';\n\n/**\n * Database manager\n */\nexport default class DatabaseManager {\n  private logger: typeof Logger = Logger;\n\n  private readonly options: ApplicationDatabaseOptions;\n\n  private instances: DatabaseInstance[] = [];\n\n  /**\n   * Database manager constructor\n   */\n  constructor(options: ApplicationDatabaseOptions) {\n    this.options = options;\n  }\n\n  /**\n   * Connect to database\n   */\n  public async connect(): Promise<DatabaseInstance> {\n    return DatabasePerformanceWrapper.monitorConnection('connect', async () => {\n      const startTime = performance.now();\n\n      try {\n        const orm = await MikroORM.init();\n\n        const databaseInstance = new DatabaseInstance({\n          databaseManager: this,\n          applicationConfig: this.options.applicationConfig,\n          orm,\n        });\n\n        this.instances.push(databaseInstance);\n\n        const duration = performance.now() - startTime;\n        const ormConfig = typeof orm.config?.getAll === 'function' ? orm.config.getAll() : undefined;\n        const logMeta = {\n          Host: ormConfig?.host ?? this.options.host,\n          User: ormConfig?.user ?? this.options.username,\n          Database: ormConfig?.dbName ?? this.options.databaseName,\n          Duration: `${duration.toFixed(2)}ms`,\n        };\n\n        if (this.options.applicationConfig.log?.startUp) {\n          this.log('Connected', logMeta);\n        } else {\n          this.logger.debug({ message: 'Database connected', meta: logMeta });\n        }\n\n        return databaseInstance;\n      } catch (error) {\n        const duration = performance.now() - startTime;\n\n        this.logger.error({\n          error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n          message: 'Database connection failed',\n          meta: {\n            Host: this.options.host,\n            Database: this.options.databaseName,\n            Duration: `${duration.toFixed(2)}ms`,\n          },\n        });\n\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Disconnect from database\n   */\n  public async disconnect(): Promise<void> {\n    await DatabasePerformanceWrapper.monitorConnection('disconnect', async () => {\n      const startTime = performance.now();\n      const instanceCount = this.instances.length;\n\n      try {\n        await Promise.all(this.instances.map(instance => instance.disconnect()));\n\n        const duration = performance.now() - startTime;\n\n        if (instanceCount > 0) {\n          const meta = {\n            Host: this.options.host,\n            Instances: instanceCount,\n            Duration: `${duration.toFixed(2)}ms`,\n          };\n\n          if (this.options.applicationConfig.log?.startUp) {\n            this.log('Disconnected all database instances', meta);\n          } else {\n            this.logger.debug({ message: 'Database instances disconnected', meta });\n          }\n        }\n\n        this.instances = [];\n      } catch (error) {\n        const duration = performance.now() - startTime;\n\n        this.logger.error({\n          error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n          message: 'Database disconnection failed',\n          meta: {\n            Host: this.options.host,\n            Duration: `${duration.toFixed(2)}ms`,\n            Instances: instanceCount,\n          },\n        });\n\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Log database message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'database', message, meta });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -0,0 +1,109 @@
+import { type ErrorEnvelope, type ErrorReportOptions } from './error.interface.js';
+/**
+ * Safely serialize any error to a string, handling circular references gracefully
+ *
+ * This utility handles MikroORM errors and other complex error objects that may
+ * contain circular references which would cause String(error) or JSON.stringify
+ * to fail.
+ *
+ * @param error - The error to serialize
+ * @returns String representation of the error
+ *
+ * @example
+ * ```typescript
+ * // Safe for MikroORM errors with circular entity metadata
+ * const message = safeSerializeError(mikroOrmError);
+ *
+ * // Works with any error type
+ * const message = safeSerializeError(unknownError);
+ * ```
+ */
+export declare function safeSerializeError(error: unknown): string;
+/**
+ * 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;
+}
+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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiCzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;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;CAgBjC;;AAGD,wBAA2C"}

package/dist/error/error-reporter.js

@@ -5,6 +5,35 @@ import { getRequestId } from "../request-context/index.js";
 import Logger from "../logger/logger.js";
 import { ErrorCode, ErrorSeverity } from "./error.interface.js";
 import { FrameworkError } from "./framework-errors.js";
+function safeSerializeError(error) {
+  try {
+    if (error === null) return "null";
+    if (error === void 0) return "undefined";
+    if (typeof error === "object") {
+      if ("message" in error && typeof error.message === "string") {
+        return error.message;
+      }
+      if ("toString" in error && typeof error.toString === "function") {
+        try {
+          const str = error.toString();
+          if (str !== "[object Object]") {
+            return str;
+          }
+        } catch {
+        }
+      }
+      try {
+        return JSON.stringify(error);
+      } catch {
+        return "[object Object] (circular reference detected)";
+      }
+    }
+    return String(error);
+  } catch {
+    return "Unknown error (serialization failed)";
+  }
+}
+__name(safeSerializeError, "safeSerializeError");
 class ErrorReporter {
   static {
     __name(this, "ErrorReporter");
@@ -90,7 +119,7 @@ class ErrorReporter {
       };
     }
     return {
-      message: this.serializeUnknownError(error),
+      message: safeSerializeError(error),
       code: options?.code ?? ErrorCode.UNKNOWN,
       severity: options?.severity ?? ErrorSeverity.ERROR,
       requestId,
@@ -192,37 +221,11 @@ class ErrorReporter {
         return "error";
     }
   }
-  /**
-   * Serialize unknown error types to string
-   *
-   * @param error - Unknown error
-   * @returns String representation
-   */
-  serializeUnknownError(error) {
-    try {
-      if (error === null) return "null";
-      if (error === void 0) return "undefined";
-      if (typeof error === "object") {
-        if ("message" in error && typeof error.message === "string") {
-          return error.message;
-        }
-        if ("toString" in error && typeof error.toString === "function") {
-          const str = error.toString();
-          if (str !== "[object Object]") {
-            return str;
-          }
-        }
-        return JSON.stringify(error);
-      }
-      return String(error);
-    } catch {
-      return "Unknown error (serialization failed)";
-    }
-  }
 }
 var error_reporter_default = ErrorReporter.getInstance();
 export {
   ErrorReporter,
-  error_reporter_default as default
+  error_reporter_default as default,
+  safeSerializeError
 };
 //# sourceMappingURL=error-reporter.js.map

package/dist/error/error-reporter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/error/error-reporter.ts"],
-  "sourcesContent": ["import * as Sentry from '@sentry/node';\nimport { getRequestId } from '../request-context/index.js';\nimport Logger from '../logger/logger.js';\nimport { ErrorCode, type ErrorEnvelope, type ErrorReportOptions, ErrorSeverity } from './error.interface.js';\nimport { FrameworkError } from './framework-errors.js';\n\n/**\n * Centralized error reporter for the framework\n *\n * Provides a unified interface for error reporting, normalization, logging,\n * and external error tracking (Sentry). Eliminates inconsistent error handling\n * and ensures all errors are properly structured and correlated.\n *\n * @example\n * ```typescript\n * const errorReporter = ErrorReporter.getInstance();\n *\n * // Report an error\n * errorReporter.report(error, {\n *   context: { userId: '123', operation: 'fetchUser' },\n *   severity: ErrorSeverity.CRITICAL\n * });\n *\n * // Report with custom code\n * errorReporter.report(\n *   new Error('Database connection lost'),\n *   {\n *     code: ErrorCode.DATABASE_CONNECTION_FAILED,\n *     captureInSentry: true\n *   }\n * );\n * ```\n */\nexport class ErrorReporter {\n  private static instance: ErrorReporter;\n\n  private constructor() {\n    // Private constructor for singleton\n  }\n\n  /**\n   * Get the singleton instance\n   */\n  public static getInstance(): ErrorReporter {\n    if (!ErrorReporter.instance) {\n      ErrorReporter.instance = new ErrorReporter();\n    }\n    return ErrorReporter.instance;\n  }\n\n  /**\n   * Report an error through the centralized error pipeline\n   *\n   * This method:\n   * 1. Normalizes the error into a standard envelope\n   * 2. Logs the error with appropriate severity\n   * 3. Optionally captures the error in Sentry\n   * 4. Adds request correlation if available\n   *\n   * @param error - The error to report (Error, string, or unknown)\n   * @param options - Reporting options (context, severity, etc.)\n   * @returns Normalized error envelope\n   */\n  public report(error: Error | unknown, options?: ErrorReportOptions): ErrorEnvelope {\n    // Normalize the error into an envelope\n    const envelope = this.normalizeError(error, options);\n\n    // Log the error (unless explicitly disabled)\n    if (options?.log !== false) {\n      this.logError(envelope);\n    }\n\n    // Capture in Sentry (if enabled and error is significant enough)\n    if (this.shouldCaptureInSentry(envelope, options)) {\n      this.captureInSentry(error, envelope);\n    }\n\n    return envelope;\n  }\n\n  /**\n   * Normalize any error into a standardized ErrorEnvelope\n   *\n   * @param error - The error to normalize\n   * @param options - Optional configuration\n   * @returns Normalized error envelope\n   */\n  private normalizeError(error: Error | unknown, options?: ErrorReportOptions): ErrorEnvelope {\n    // Extract request ID from context (if available)\n    const requestId = getRequestId();\n\n    // Handle FrameworkError instances\n    if (error instanceof FrameworkError) {\n      return {\n        message: error.message,\n        code: options?.code ?? error.code,\n        severity: options?.severity ?? error.severity,\n        stack: error.stack,\n        requestId,\n        context: { ...error.context, ...options?.context },\n        cause: error.cause,\n        timestamp: error.timestamp,\n        name: error.name,\n      };\n    }\n\n    // Handle standard Error instances\n    if (error instanceof Error) {\n      return {\n        message: error.message,\n        code: options?.code ?? ErrorCode.UNKNOWN,\n        severity: options?.severity ?? ErrorSeverity.ERROR,\n        stack: error.stack,\n        requestId,\n        context: options?.context,\n        cause: error.cause,\n        timestamp: new Date(),\n        name: error.name,\n      };\n    }\n\n    // Handle string errors\n    if (typeof error === 'string') {\n      return {\n        message: error,\n        code: options?.code ?? ErrorCode.UNKNOWN,\n        severity: options?.severity ?? ErrorSeverity.ERROR,\n        requestId,\n        context: options?.context,\n        timestamp: new Date(),\n      };\n    }\n\n    // Handle unknown error types\n    return {\n      message: this.serializeUnknownError(error),\n      code: options?.code ?? ErrorCode.UNKNOWN,\n      severity: options?.severity ?? ErrorSeverity.ERROR,\n      requestId,\n      context: { ...options?.context, originalError: error },\n      timestamp: new Date(),\n    };\n  }\n\n  /**\n   * Log the error with appropriate severity\n   *\n   * @param envelope - Normalized error envelope\n   */\n  private logError(envelope: ErrorEnvelope): void {\n    const meta: Record<string, unknown> = {\n      code: envelope.code,\n      severity: envelope.severity,\n    };\n\n    if (envelope.requestId) {\n      meta.requestId = envelope.requestId;\n    }\n\n    if (envelope.context) {\n      Object.assign(meta, envelope.context);\n    }\n\n    // Map severity to logger level\n    switch (envelope.severity) {\n      case ErrorSeverity.FATAL:\n      case ErrorSeverity.CRITICAL:\n      case ErrorSeverity.ERROR:\n        Logger.error({ error: envelope.message, meta });\n        break;\n      case ErrorSeverity.WARNING:\n        Logger.warn({ message: envelope.message, meta });\n        break;\n      case ErrorSeverity.INFO:\n        Logger.info({ message: envelope.message, meta });\n        break;\n    }\n  }\n\n  /**\n   * Determine if error should be captured in Sentry\n   *\n   * @param envelope - Normalized error envelope\n   * @param options - Reporting options\n   * @returns Whether to capture in Sentry\n   */\n  private shouldCaptureInSentry(envelope: ErrorEnvelope, options?: ErrorReportOptions): boolean {\n    // Explicitly disabled\n    if (options?.captureInSentry === false) {\n      return false;\n    }\n\n    // Explicitly enabled\n    if (options?.captureInSentry === true) {\n      return true;\n    }\n\n    // Auto-capture for errors and above (not warnings/info)\n    return (\n      envelope.severity === ErrorSeverity.FATAL ||\n      envelope.severity === ErrorSeverity.CRITICAL ||\n      envelope.severity === ErrorSeverity.ERROR\n    );\n  }\n\n  /**\n   * Capture error in Sentry with enriched context\n   *\n   * @param error - Original error\n   * @param envelope - Normalized error envelope\n   */\n  private captureInSentry(error: Error | unknown, envelope: ErrorEnvelope): void {\n    // Only capture if Sentry is initialized\n    if (!Logger.isSentryInitialized) {\n      return;\n    }\n\n    // Prepare Sentry scope with enriched context\n    Sentry.withScope(scope => {\n      // Add severity\n      scope.setLevel(this.mapSeverityToSentryLevel(envelope.severity));\n\n      // Add tags\n      scope.setTag('error_code', envelope.code);\n      if (envelope.requestId) {\n        scope.setTag('request_id', envelope.requestId);\n      }\n\n      // Add context\n      if (envelope.context) {\n        scope.setContext('error_context', envelope.context);\n      }\n\n      // Capture the error\n      if (error instanceof Error) {\n        Sentry.captureException(error);\n      } else {\n        Sentry.captureMessage(envelope.message, 'error');\n      }\n    });\n  }\n\n  /**\n   * Map framework error severity to Sentry severity level\n   *\n   * @param severity - Framework error severity\n   * @returns Sentry severity level\n   */\n  private mapSeverityToSentryLevel(severity: ErrorSeverity): Sentry.SeverityLevel {\n    switch (severity) {\n      case ErrorSeverity.FATAL:\n        return 'fatal';\n      case ErrorSeverity.CRITICAL:\n        return 'error';\n      case ErrorSeverity.ERROR:\n        return 'error';\n      case ErrorSeverity.WARNING:\n        return 'warning';\n      case ErrorSeverity.INFO:\n        return 'info';\n      default:\n        return 'error';\n    }\n  }\n\n  /**\n   * Serialize unknown error types to string\n   *\n   * @param error - Unknown error\n   * @returns String representation\n   */\n  private serializeUnknownError(error: unknown): string {\n    try {\n      if (error === null) return 'null';\n      if (error === undefined) return 'undefined';\n\n      if (typeof error === 'object') {\n        // Try to extract meaningful properties\n        if ('message' in error && typeof error.message === 'string') {\n          return error.message;\n        }\n        if ('toString' in error && typeof error.toString === 'function') {\n          const str = error.toString();\n          if (str !== '[object Object]') {\n            return str;\n          }\n        }\n        // Fallback to JSON stringification\n        return JSON.stringify(error);\n      }\n\n      return String(error);\n    } catch {\n      return 'Unknown error (serialization failed)';\n    }\n  }\n}\n\n// Export singleton instance for convenience\nexport default ErrorReporter.getInstance();\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as Sentry from '@sentry/node';\nimport { getRequestId } from '../request-context/index.js';\nimport Logger from '../logger/logger.js';\nimport { ErrorCode, type ErrorEnvelope, type ErrorReportOptions, ErrorSeverity } from './error.interface.js';\nimport { FrameworkError } from './framework-errors.js';\n\n/**\n * Safely serialize any error to a string, handling circular references gracefully\n *\n * This utility handles MikroORM errors and other complex error objects that may\n * contain circular references which would cause String(error) or JSON.stringify\n * to fail.\n *\n * @param error - The error to serialize\n * @returns String representation of the error\n *\n * @example\n * ```typescript\n * // Safe for MikroORM errors with circular entity metadata\n * const message = safeSerializeError(mikroOrmError);\n *\n * // Works with any error type\n * const message = safeSerializeError(unknownError);\n * ```\n */\nexport function safeSerializeError(error: unknown): string {\n  try {\n    if (error === null) return 'null';\n    if (error === undefined) return 'undefined';\n\n    if (typeof error === 'object') {\n      // Try to extract meaningful properties\n      if ('message' in error && typeof error.message === 'string') {\n        return error.message;\n      }\n      if ('toString' in error && typeof error.toString === 'function') {\n        try {\n          const str = error.toString();\n          if (str !== '[object Object]') {\n            return str;\n          }\n        } catch {\n          // toString() itself may throw\n        }\n      }\n      // Fallback to JSON stringification with circular reference handling\n      try {\n        return JSON.stringify(error);\n      } catch {\n        // JSON.stringify can fail on circular references\n        return '[object Object] (circular reference detected)';\n      }\n    }\n\n    return String(error);\n  } catch {\n    return 'Unknown error (serialization failed)';\n  }\n}\n\n/**\n * Centralized error reporter for the framework\n *\n * Provides a unified interface for error reporting, normalization, logging,\n * and external error tracking (Sentry). Eliminates inconsistent error handling\n * and ensures all errors are properly structured and correlated.\n *\n * @example\n * ```typescript\n * const errorReporter = ErrorReporter.getInstance();\n *\n * // Report an error\n * errorReporter.report(error, {\n *   context: { userId: '123', operation: 'fetchUser' },\n *   severity: ErrorSeverity.CRITICAL\n * });\n *\n * // Report with custom code\n * errorReporter.report(\n *   new Error('Database connection lost'),\n *   {\n *     code: ErrorCode.DATABASE_CONNECTION_FAILED,\n *     captureInSentry: true\n *   }\n * );\n * ```\n */\nexport class ErrorReporter {\n  private static instance: ErrorReporter;\n\n  private constructor() {\n    // Private constructor for singleton\n  }\n\n  /**\n   * Get the singleton instance\n   */\n  public static getInstance(): ErrorReporter {\n    if (!ErrorReporter.instance) {\n      ErrorReporter.instance = new ErrorReporter();\n    }\n    return ErrorReporter.instance;\n  }\n\n  /**\n   * Report an error through the centralized error pipeline\n   *\n   * This method:\n   * 1. Normalizes the error into a standard envelope\n   * 2. Logs the error with appropriate severity\n   * 3. Optionally captures the error in Sentry\n   * 4. Adds request correlation if available\n   *\n   * @param error - The error to report (Error, string, or unknown)\n   * @param options - Reporting options (context, severity, etc.)\n   * @returns Normalized error envelope\n   */\n  public report(error: Error | unknown, options?: ErrorReportOptions): ErrorEnvelope {\n    // Normalize the error into an envelope\n    const envelope = this.normalizeError(error, options);\n\n    // Log the error (unless explicitly disabled)\n    if (options?.log !== false) {\n      this.logError(envelope);\n    }\n\n    // Capture in Sentry (if enabled and error is significant enough)\n    if (this.shouldCaptureInSentry(envelope, options)) {\n      this.captureInSentry(error, envelope);\n    }\n\n    return envelope;\n  }\n\n  /**\n   * Normalize any error into a standardized ErrorEnvelope\n   *\n   * @param error - The error to normalize\n   * @param options - Optional configuration\n   * @returns Normalized error envelope\n   */\n  private normalizeError(error: Error | unknown, options?: ErrorReportOptions): ErrorEnvelope {\n    // Extract request ID from context (if available)\n    const requestId = getRequestId();\n\n    // Handle FrameworkError instances\n    if (error instanceof FrameworkError) {\n      return {\n        message: error.message,\n        code: options?.code ?? error.code,\n        severity: options?.severity ?? error.severity,\n        stack: error.stack,\n        requestId,\n        context: { ...error.context, ...options?.context },\n        cause: error.cause,\n        timestamp: error.timestamp,\n        name: error.name,\n      };\n    }\n\n    // Handle standard Error instances\n    if (error instanceof Error) {\n      return {\n        message: error.message,\n        code: options?.code ?? ErrorCode.UNKNOWN,\n        severity: options?.severity ?? ErrorSeverity.ERROR,\n        stack: error.stack,\n        requestId,\n        context: options?.context,\n        cause: error.cause,\n        timestamp: new Date(),\n        name: error.name,\n      };\n    }\n\n    // Handle string errors\n    if (typeof error === 'string') {\n      return {\n        message: error,\n        code: options?.code ?? ErrorCode.UNKNOWN,\n        severity: options?.severity ?? ErrorSeverity.ERROR,\n        requestId,\n        context: options?.context,\n        timestamp: new Date(),\n      };\n    }\n\n    // Handle unknown error types\n    return {\n      message: safeSerializeError(error),\n      code: options?.code ?? ErrorCode.UNKNOWN,\n      severity: options?.severity ?? ErrorSeverity.ERROR,\n      requestId,\n      context: { ...options?.context, originalError: error },\n      timestamp: new Date(),\n    };\n  }\n\n  /**\n   * Log the error with appropriate severity\n   *\n   * @param envelope - Normalized error envelope\n   */\n  private logError(envelope: ErrorEnvelope): void {\n    const meta: Record<string, unknown> = {\n      code: envelope.code,\n      severity: envelope.severity,\n    };\n\n    if (envelope.requestId) {\n      meta.requestId = envelope.requestId;\n    }\n\n    if (envelope.context) {\n      Object.assign(meta, envelope.context);\n    }\n\n    // Map severity to logger level\n    switch (envelope.severity) {\n      case ErrorSeverity.FATAL:\n      case ErrorSeverity.CRITICAL:\n      case ErrorSeverity.ERROR:\n        Logger.error({ error: envelope.message, meta });\n        break;\n      case ErrorSeverity.WARNING:\n        Logger.warn({ message: envelope.message, meta });\n        break;\n      case ErrorSeverity.INFO:\n        Logger.info({ message: envelope.message, meta });\n        break;\n    }\n  }\n\n  /**\n   * Determine if error should be captured in Sentry\n   *\n   * @param envelope - Normalized error envelope\n   * @param options - Reporting options\n   * @returns Whether to capture in Sentry\n   */\n  private shouldCaptureInSentry(envelope: ErrorEnvelope, options?: ErrorReportOptions): boolean {\n    // Explicitly disabled\n    if (options?.captureInSentry === false) {\n      return false;\n    }\n\n    // Explicitly enabled\n    if (options?.captureInSentry === true) {\n      return true;\n    }\n\n    // Auto-capture for errors and above (not warnings/info)\n    return (\n      envelope.severity === ErrorSeverity.FATAL ||\n      envelope.severity === ErrorSeverity.CRITICAL ||\n      envelope.severity === ErrorSeverity.ERROR\n    );\n  }\n\n  /**\n   * Capture error in Sentry with enriched context\n   *\n   * @param error - Original error\n   * @param envelope - Normalized error envelope\n   */\n  private captureInSentry(error: Error | unknown, envelope: ErrorEnvelope): void {\n    // Only capture if Sentry is initialized\n    if (!Logger.isSentryInitialized) {\n      return;\n    }\n\n    // Prepare Sentry scope with enriched context\n    Sentry.withScope(scope => {\n      // Add severity\n      scope.setLevel(this.mapSeverityToSentryLevel(envelope.severity));\n\n      // Add tags\n      scope.setTag('error_code', envelope.code);\n      if (envelope.requestId) {\n        scope.setTag('request_id', envelope.requestId);\n      }\n\n      // Add context\n      if (envelope.context) {\n        scope.setContext('error_context', envelope.context);\n      }\n\n      // Capture the error\n      if (error instanceof Error) {\n        Sentry.captureException(error);\n      } else {\n        Sentry.captureMessage(envelope.message, 'error');\n      }\n    });\n  }\n\n  /**\n   * Map framework error severity to Sentry severity level\n   *\n   * @param severity - Framework error severity\n   * @returns Sentry severity level\n   */\n  private mapSeverityToSentryLevel(severity: ErrorSeverity): Sentry.SeverityLevel {\n    switch (severity) {\n      case ErrorSeverity.FATAL:\n        return 'fatal';\n      case ErrorSeverity.CRITICAL:\n        return 'error';\n      case ErrorSeverity.ERROR:\n        return 'error';\n      case ErrorSeverity.WARNING:\n        return 'warning';\n      case ErrorSeverity.INFO:\n        return 'info';\n      default:\n        return 'error';\n    }\n  }\n}\n\n// Export singleton instance for convenience\nexport default ErrorReporter.getInstance();\n"],
+  "mappings": ";;AAAA,YAAY,YAAY;AACxB,SAAS,oBAAoB;AAC7B,OAAO,YAAY;AACnB,SAAS,WAAwD,qBAAqB;AACtF,SAAS,sBAAsB;AAqBxB,SAAS,mBAAmB,OAAwB;AACzD,MAAI;AACF,QAAI,UAAU,KAAM,QAAO;AAC3B,QAAI,UAAU,OAAW,QAAO;AAEhC,QAAI,OAAO,UAAU,UAAU;AAE7B,UAAI,aAAa,SAAS,OAAO,MAAM,YAAY,UAAU;AAC3D,eAAO,MAAM;AAAA,MACf;AACA,UAAI,cAAc,SAAS,OAAO,MAAM,aAAa,YAAY;AAC/D,YAAI;AACF,gBAAM,MAAM,MAAM,SAAS;AAC3B,cAAI,QAAQ,mBAAmB;AAC7B,mBAAO;AAAA,UACT;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AAEA,UAAI;AACF,eAAO,KAAK,UAAU,KAAK;AAAA,MAC7B,QAAQ;AAEN,eAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO,OAAO,KAAK;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAjCgB;AA8DT,MAAM,cAAc;AAAA,EAvF3B,OAuF2B;AAAA;AAAA;AAAA,EACzB,OAAe;AAAA,EAEP,cAAc;AAAA,EAEtB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAc,cAA6B;AACzC,QAAI,CAAC,cAAc,UAAU;AAC3B,oBAAc,WAAW,IAAI,cAAc;AAAA,IAC7C;AACA,WAAO,cAAc;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeO,OAAO,OAAwB,SAA6C;AAEjF,UAAM,WAAW,KAAK,eAAe,OAAO,OAAO;AAGnD,QAAI,SAAS,QAAQ,OAAO;AAC1B,WAAK,SAAS,QAAQ;AAAA,IACxB;AAGA,QAAI,KAAK,sBAAsB,UAAU,OAAO,GAAG;AACjD,WAAK,gBAAgB,OAAO,QAAQ;AAAA,IACtC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,eAAe,OAAwB,SAA6C;AAE1F,UAAM,YAAY,aAAa;AAG/B,QAAI,iBAAiB,gBAAgB;AACnC,aAAO;AAAA,QACL,SAAS,MAAM;AAAA,QACf,MAAM,SAAS,QAAQ,MAAM;AAAA,QAC7B,UAAU,SAAS,YAAY,MAAM;AAAA,QACrC,OAAO,MAAM;AAAA,QACb;AAAA,QACA,SAAS,EAAE,GAAG,MAAM,SAAS,GAAG,SAAS,QAAQ;AAAA,QACjD,OAAO,MAAM;AAAA,QACb,WAAW,MAAM;AAAA,QACjB,MAAM,MAAM;AAAA,MACd;AAAA,IACF;AAGA,QAAI,iBAAiB,OAAO;AAC1B,aAAO;AAAA,QACL,SAAS,MAAM;AAAA,QACf,MAAM,SAAS,QAAQ,UAAU;AAAA,QACjC,UAAU,SAAS,YAAY,cAAc;AAAA,QAC7C,OAAO,MAAM;AAAA,QACb;AAAA,QACA,SAAS,SAAS;AAAA,QAClB,OAAO,MAAM;AAAA,QACb,WAAW,oBAAI,KAAK;AAAA,QACpB,MAAM,MAAM;AAAA,MACd;AAAA,IACF;AAGA,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,SAAS,QAAQ,UAAU;AAAA,QACjC,UAAU,SAAS,YAAY,cAAc;AAAA,QAC7C;AAAA,QACA,SAAS,SAAS;AAAA,QAClB,WAAW,oBAAI,KAAK;AAAA,MACtB;AAAA,IACF;AAGA,WAAO;AAAA,MACL,SAAS,mBAAmB,KAAK;AAAA,MACjC,MAAM,SAAS,QAAQ,UAAU;AAAA,MACjC,UAAU,SAAS,YAAY,cAAc;AAAA,MAC7C;AAAA,MACA,SAAS,EAAE,GAAG,SAAS,SAAS,eAAe,MAAM;AAAA,MACrD,WAAW,oBAAI,KAAK;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,SAAS,UAA+B;AAC9C,UAAM,OAAgC;AAAA,MACpC,MAAM,SAAS;AAAA,MACf,UAAU,SAAS;AAAA,IACrB;AAEA,QAAI,SAAS,WAAW;AACtB,WAAK,YAAY,SAAS;AAAA,IAC5B;AAEA,QAAI,SAAS,SAAS;AACpB,aAAO,OAAO,MAAM,SAAS,OAAO;AAAA,IACtC;AAGA,YAAQ,SAAS,UAAU;AAAA,MACzB,KAAK,cAAc;AAAA,MACnB,KAAK,cAAc;AAAA,MACnB,KAAK,cAAc;AACjB,eAAO,MAAM,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAC9C;AAAA,MACF,KAAK,cAAc;AACjB,eAAO,KAAK,EAAE,SAAS,SAAS,SAAS,KAAK,CAAC;AAC/C;AAAA,MACF,KAAK,cAAc;AACjB,eAAO,KAAK,EAAE,SAAS,SAAS,SAAS,KAAK,CAAC;AAC/C;AAAA,IACJ;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,sBAAsB,UAAyB,SAAuC;AAE5F,QAAI,SAAS,oBAAoB,OAAO;AACtC,aAAO;AAAA,IACT;AAGA,QAAI,SAAS,oBAAoB,MAAM;AACrC,aAAO;AAAA,IACT;AAGA,WACE,SAAS,aAAa,cAAc,SACpC,SAAS,aAAa,cAAc,YACpC,SAAS,aAAa,cAAc;AAAA,EAExC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,gBAAgB,OAAwB,UAA+B;AAE7E,QAAI,CAAC,OAAO,qBAAqB;AAC/B;AAAA,IACF;AAGA,WAAO,UAAU,WAAS;AAExB,YAAM,SAAS,KAAK,yBAAyB,SAAS,QAAQ,CAAC;AAG/D,YAAM,OAAO,cAAc,SAAS,IAAI;AACxC,UAAI,SAAS,WAAW;AACtB,cAAM,OAAO,cAAc,SAAS,SAAS;AAAA,MAC/C;AAGA,UAAI,SAAS,SAAS;AACpB,cAAM,WAAW,iBAAiB,SAAS,OAAO;AAAA,MACpD;AAGA,UAAI,iBAAiB,OAAO;AAC1B,eAAO,iBAAiB,KAAK;AAAA,MAC/B,OAAO;AACL,eAAO,eAAe,SAAS,SAAS,OAAO;AAAA,MACjD;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,yBAAyB,UAA+C;AAC9E,YAAQ,UAAU;AAAA,MAChB,KAAK,cAAc;AACjB,eAAO;AAAA,MACT,KAAK,cAAc;AACjB,eAAO;AAAA,MACT,KAAK,cAAc;AACjB,eAAO;AAAA,MACT,KAAK,cAAc;AACjB,eAAO;AAAA,MACT,KAAK,cAAc;AACjB,eAAO;AAAA,MACT;AACE,eAAO;AAAA,IACX;AAAA,EACF;AACF;AAGA,IAAO,yBAAQ,cAAc,YAAY;",
   "names": []
 }

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":"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"}

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, safeSerializeError } 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,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,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"}