@scpxl/nodejs-framework 1.0.17 → 1.0.20

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

@@ -1 +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;WAU3D,eAAe,IAAI,MAAM,EAAE;CAG1C"}
+{"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/dynamic-entity.js

@@ -27,10 +27,14 @@ class DynamicEntity extends BaseEntity {
   }
   static validate(item, isCreating) {
     const schemaName = isCreating ? "schema" : "schemaUpdate";
-    if (!this[schemaName]) {
+    if (!["schema", "schemaUpdate"].includes(schemaName)) {
+      throw new Error("Invalid schema reference");
+    }
+    const selectedSchema = schemaName === "schema" ? this.schema : this.schemaUpdate;
+    if (!selectedSchema) {
       throw new Error("Schema not defined in entity.");
     }
-    return this[schemaName].validate(item, { abortEarly: false });
+    return selectedSchema.validate(item, { abortEarly: false });
   }
   static getSearchFields() {
     return [];

package/dist/database/dynamic-entity.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/database/dynamic-entity.ts"],
-  "sourcesContent": ["import { BaseEntity } from '@mikro-orm/core';\nimport type { Schema, ValidationResult } from 'joi';\n\nexport abstract class DynamicEntity extends BaseEntity {\n  public static schema: Schema;\n  public static schemaUpdate: Schema;\n\n  public static get singularName(): string {\n    return 'Item';\n  }\n\n  public static get pluralName(): string {\n    return 'Items';\n  }\n\n  public static get singularNameLowerCase(): string {\n    return this.singularName.toLowerCase();\n  }\n\n  public static get pluralNameLowerCase(): string {\n    return this.pluralName.toLowerCase();\n  }\n\n  public static get singularNameCapitalized(): string {\n    return this.singularName.charAt(0).toUpperCase() + this.singularName.slice(1).toLowerCase();\n  }\n\n  public static get pluralNameCapitalized(): string {\n    return this.pluralName.charAt(0).toUpperCase() + this.pluralName.slice(1).toLowerCase();\n  }\n\n  public static validate<T>(item: T, isCreating: boolean): ValidationResult {\n    const schemaName = isCreating ? 'schema' : 'schemaUpdate';\n\n    if (!this[schemaName]) {\n      throw new Error('Schema not defined in entity.');\n    }\n\n    return this[schemaName].validate(item, { abortEarly: false });\n  }\n\n  public static getSearchFields(): string[] {\n    return [];\n  }\n}\n"],
-  "mappings": ";;AAAA,SAAS,kBAAkB;AAGpB,MAAe,sBAAsB,WAAW;AAAA,EAHvD,OAGuD;AAAA;AAAA;AAAA,EACrD,OAAc;AAAA,EACd,OAAc;AAAA,EAEd,WAAkB,eAAuB;AACvC,WAAO;AAAA,EACT;AAAA,EAEA,WAAkB,aAAqB;AACrC,WAAO;AAAA,EACT;AAAA,EAEA,WAAkB,wBAAgC;AAChD,WAAO,KAAK,aAAa,YAAY;AAAA,EACvC;AAAA,EAEA,WAAkB,sBAA8B;AAC9C,WAAO,KAAK,WAAW,YAAY;AAAA,EACrC;AAAA,EAEA,WAAkB,0BAAkC;AAClD,WAAO,KAAK,aAAa,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,aAAa,MAAM,CAAC,EAAE,YAAY;AAAA,EAC5F;AAAA,EAEA,WAAkB,wBAAgC;AAChD,WAAO,KAAK,WAAW,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,WAAW,MAAM,CAAC,EAAE,YAAY;AAAA,EACxF;AAAA,EAEA,OAAc,SAAY,MAAS,YAAuC;AACxE,UAAM,aAAa,aAAa,WAAW;AAE3C,QAAI,CAAC,KAAK,UAAU,GAAG;AACrB,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AAEA,WAAO,KAAK,UAAU,EAAE,SAAS,MAAM,EAAE,YAAY,MAAM,CAAC;AAAA,EAC9D;AAAA,EAEA,OAAc,kBAA4B;AACxC,WAAO,CAAC;AAAA,EACV;AACF;",
+  "sourcesContent": ["import { BaseEntity } from '@mikro-orm/core';\nimport type { Schema, ValidationResult } from 'joi';\n\nexport abstract class DynamicEntity extends BaseEntity {\n  public static schema: Schema;\n  public static schemaUpdate: Schema;\n\n  public static get singularName(): string {\n    return 'Item';\n  }\n\n  public static get pluralName(): string {\n    return 'Items';\n  }\n\n  public static get singularNameLowerCase(): string {\n    return this.singularName.toLowerCase();\n  }\n\n  public static get pluralNameLowerCase(): string {\n    return this.pluralName.toLowerCase();\n  }\n\n  public static get singularNameCapitalized(): string {\n    return this.singularName.charAt(0).toUpperCase() + this.singularName.slice(1).toLowerCase();\n  }\n\n  public static get pluralNameCapitalized(): string {\n    return this.pluralName.charAt(0).toUpperCase() + this.pluralName.slice(1).toLowerCase();\n  }\n\n  public static validate<T>(item: T, isCreating: boolean): ValidationResult {\n    const schemaName = isCreating ? 'schema' : 'schemaUpdate';\n    // Explicit whitelist of schema properties to prevent object injection\n    if (!['schema', 'schemaUpdate'].includes(schemaName)) {\n      throw new Error('Invalid schema reference');\n    }\n    const selectedSchema: Schema | undefined = schemaName === 'schema' ? this.schema : this.schemaUpdate;\n    if (!selectedSchema) {\n      throw new Error('Schema not defined in entity.');\n    }\n    return selectedSchema.validate(item, { abortEarly: false });\n  }\n\n  public static getSearchFields(): string[] {\n    return [];\n  }\n}\n"],
+  "mappings": ";;AAAA,SAAS,kBAAkB;AAGpB,MAAe,sBAAsB,WAAW;AAAA,EAHvD,OAGuD;AAAA;AAAA;AAAA,EACrD,OAAc;AAAA,EACd,OAAc;AAAA,EAEd,WAAkB,eAAuB;AACvC,WAAO;AAAA,EACT;AAAA,EAEA,WAAkB,aAAqB;AACrC,WAAO;AAAA,EACT;AAAA,EAEA,WAAkB,wBAAgC;AAChD,WAAO,KAAK,aAAa,YAAY;AAAA,EACvC;AAAA,EAEA,WAAkB,sBAA8B;AAC9C,WAAO,KAAK,WAAW,YAAY;AAAA,EACrC;AAAA,EAEA,WAAkB,0BAAkC;AAClD,WAAO,KAAK,aAAa,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,aAAa,MAAM,CAAC,EAAE,YAAY;AAAA,EAC5F;AAAA,EAEA,WAAkB,wBAAgC;AAChD,WAAO,KAAK,WAAW,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,WAAW,MAAM,CAAC,EAAE,YAAY;AAAA,EACxF;AAAA,EAEA,OAAc,SAAY,MAAS,YAAuC;AACxE,UAAM,aAAa,aAAa,WAAW;AAE3C,QAAI,CAAC,CAAC,UAAU,cAAc,EAAE,SAAS,UAAU,GAAG;AACpD,YAAM,IAAI,MAAM,0BAA0B;AAAA,IAC5C;AACA,UAAM,iBAAqC,eAAe,WAAW,KAAK,SAAS,KAAK;AACxF,QAAI,CAAC,gBAAgB;AACnB,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AACA,WAAO,eAAe,SAAS,MAAM,EAAE,YAAY,MAAM,CAAC;AAAA,EAC5D;AAAA,EAEA,OAAc,kBAA4B;AACxC,WAAO,CAAC;AAAA,EACV;AACF;",
   "names": []
 }

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

@@ -1 +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;IAgBD;;OAEG;IACI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAItC;;OAEG;IACI,gBAAgB,IAAI,aAAa;IAIxC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAKzC"}
+{"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.js

@@ -22,14 +22,6 @@ class DatabaseInstance {
     this.databaseManager = databaseManager;
     this.applicationConfig = applicationConfig;
     this.orm = orm;
-    const config = orm.config.getAll();
-    if (this.applicationConfig.log?.startUp) {
-      this.databaseManager.log("Connected", {
-        Host: config.host,
-        User: config.user,
-        Database: config.dbName
-      });
-    }
   }
   /**
    * Check if database is connected

package/dist/database/instance.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/database/instance.ts"],
-  "sourcesContent": ["import type { EntityManager, MikroORM } from '@mikro-orm/postgresql';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type DatabaseManager from './manager.js';\n\n/**\n * Database Instance\n */\nexport default class DatabaseInstance {\n  /** Database manager */\n  private databaseManager: DatabaseManager;\n\n  /** Application config */\n  private applicationConfig: ApplicationConfig;\n\n  /** MikroORM instance */\n  private orm: MikroORM;\n\n  /**\n   * Database Instance constructor\n   * @param orm MikroORM instance\n   */\n  constructor({\n    databaseManager,\n    applicationConfig,\n    orm,\n  }: {\n    databaseManager: DatabaseManager;\n    applicationConfig: ApplicationConfig;\n    orm: MikroORM;\n  }) {\n    this.databaseManager = databaseManager;\n    this.applicationConfig = applicationConfig;\n    this.orm = orm;\n\n    const config = orm.config.getAll();\n\n    if (this.applicationConfig.log?.startUp) {\n      this.databaseManager.log('Connected', {\n        Host: config.host,\n        User: config.user,\n        Database: config.dbName,\n      });\n    }\n  }\n\n  /**\n   * Check if database is connected\n   */\n  public isConnected(): Promise<boolean> {\n    return this.orm.isConnected();\n  }\n\n  /**\n   * Get EntityManager\n   */\n  public getEntityManager(): EntityManager {\n    return this.orm.em.fork();\n  }\n\n  /**\n   * Disconnect\n   */\n  public async disconnect(): Promise<void> {\n    await this.orm.close();\n\n    this.databaseManager.log('Disconnected');\n  }\n}\n"],
-  "mappings": ";;AAOA,MAAO,iBAA+B;AAAA,EAPtC,OAOsC;AAAA;AAAA;AAAA;AAAA,EAE5B;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,SAAK,kBAAkB;AACvB,SAAK,oBAAoB;AACzB,SAAK,MAAM;AAEX,UAAM,SAAS,IAAI,OAAO,OAAO;AAEjC,QAAI,KAAK,kBAAkB,KAAK,SAAS;AACvC,WAAK,gBAAgB,IAAI,aAAa;AAAA,QACpC,MAAM,OAAO;AAAA,QACb,MAAM,OAAO;AAAA,QACb,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,cAAgC;AACrC,WAAO,KAAK,IAAI,YAAY;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKO,mBAAkC;AACvC,WAAO,KAAK,IAAI,GAAG,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,aAA4B;AACvC,UAAM,KAAK,IAAI,MAAM;AAErB,SAAK,gBAAgB,IAAI,cAAc;AAAA,EACzC;AACF;",
+  "sourcesContent": ["import type { EntityManager, MikroORM } from '@mikro-orm/postgresql';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type DatabaseManager from './manager.js';\n\n/**\n * Database Instance\n */\nexport default class DatabaseInstance {\n  /** Database manager */\n  private databaseManager: DatabaseManager;\n\n  /** Application config */\n  private applicationConfig: ApplicationConfig;\n\n  /** MikroORM instance */\n  private orm: MikroORM;\n\n  /**\n   * Database Instance constructor\n   * @param orm MikroORM instance\n   */\n  constructor({\n    databaseManager,\n    applicationConfig,\n    orm,\n  }: {\n    databaseManager: DatabaseManager;\n    applicationConfig: ApplicationConfig;\n    orm: MikroORM;\n  }) {\n    this.databaseManager = databaseManager;\n    this.applicationConfig = applicationConfig;\n    this.orm = orm;\n  }\n\n  /**\n   * Check if database is connected\n   */\n  public isConnected(): Promise<boolean> {\n    return this.orm.isConnected();\n  }\n\n  /**\n   * Get EntityManager\n   */\n  public getEntityManager(): EntityManager {\n    return this.orm.em.fork();\n  }\n\n  /**\n   * Disconnect\n   */\n  public async disconnect(): Promise<void> {\n    await this.orm.close();\n\n    this.databaseManager.log('Disconnected');\n  }\n}\n"],
+  "mappings": ";;AAOA,MAAO,iBAA+B;AAAA,EAPtC,OAOsC;AAAA;AAAA;AAAA;AAAA,EAE5B;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,SAAK,kBAAkB;AACvB,SAAK,oBAAoB;AACzB,SAAK,MAAM;AAAA,EACb;AAAA;AAAA;AAAA;AAAA,EAKO,cAAgC;AACrC,WAAO,KAAK,IAAI,YAAY;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKO,mBAAkC;AACvC,WAAO,KAAK,IAAI,GAAG,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,aAA4B;AACvC,UAAM,KAAK,IAAI,MAAM;AAErB,SAAK,gBAAgB,IAAI,cAAc;AAAA,EACzC;AACF;",
   "names": []
 }

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

@@ -1 +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;AAGzE;;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;IAcjD;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}
+{"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.js

@@ -3,6 +3,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 import { MikroORM } from "@mikro-orm/postgresql";
 import DatabaseInstance from "./instance.js";
 import { Logger } from "../logger/index.js";
+import { DatabasePerformanceWrapper } from "../performance/index.js";
 class DatabaseManager {
   static {
     __name(this, "DatabaseManager");
@@ -20,21 +21,82 @@ class DatabaseManager {
    * Connect to database
    */
   async connect() {
-    const orm = await MikroORM.init();
-    const databaseInstance = new DatabaseInstance({
-      databaseManager: this,
-      applicationConfig: this.options.applicationConfig,
-      orm
+    return DatabasePerformanceWrapper.monitorConnection("connect", async () => {
+      const startTime = performance.now();
+      try {
+        const orm = await MikroORM.init();
+        const databaseInstance = new DatabaseInstance({
+          databaseManager: this,
+          applicationConfig: this.options.applicationConfig,
+          orm
+        });
+        this.instances.push(databaseInstance);
+        const duration = performance.now() - startTime;
+        const ormConfig = typeof orm.config?.getAll === "function" ? orm.config.getAll() : void 0;
+        const logMeta = {
+          Host: ormConfig?.host ?? this.options.host,
+          User: ormConfig?.user ?? this.options.username,
+          Database: ormConfig?.dbName ?? this.options.databaseName,
+          Duration: `${duration.toFixed(2)}ms`
+        };
+        if (this.options.applicationConfig.log?.startUp) {
+          this.log("Connected", logMeta);
+        } else {
+          this.logger.debug({ message: "Database connected", meta: logMeta });
+        }
+        return databaseInstance;
+      } catch (error) {
+        const duration = performance.now() - startTime;
+        this.logger.error({
+          error: error instanceof Error ? error : new Error(String(error)),
+          message: "Database connection failed",
+          meta: {
+            Host: this.options.host,
+            Database: this.options.databaseName,
+            Duration: `${duration.toFixed(2)}ms`
+          }
+        });
+        throw error;
+      }
     });
-    this.instances.push(databaseInstance);
-    return databaseInstance;
   }
   /**
    * Disconnect from database
    */
   async disconnect() {
-    await Promise.all(this.instances.map((instance) => instance.disconnect()));
-    this.instances = [];
+    await DatabasePerformanceWrapper.monitorConnection("disconnect", async () => {
+      const startTime = performance.now();
+      const instanceCount = this.instances.length;
+      try {
+        await Promise.all(this.instances.map((instance) => instance.disconnect()));
+        const duration = performance.now() - startTime;
+        if (instanceCount > 0) {
+          const meta = {
+            Host: this.options.host,
+            Instances: instanceCount,
+            Duration: `${duration.toFixed(2)}ms`
+          };
+          if (this.options.applicationConfig.log?.startUp) {
+            this.log("Disconnected all database instances", meta);
+          } else {
+            this.logger.debug({ message: "Database instances disconnected", meta });
+          }
+        }
+        this.instances = [];
+      } catch (error) {
+        const duration = performance.now() - startTime;
+        this.logger.error({
+          error: error instanceof Error ? error : new Error(String(error)),
+          message: "Database disconnection failed",
+          meta: {
+            Host: this.options.host,
+            Duration: `${duration.toFixed(2)}ms`,
+            Instances: instanceCount
+          }
+        });
+        throw error;
+      }
+    });
   }
   /**
    * Log database message

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';\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    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    return databaseInstance;\n  }\n\n  /**\n   * Disconnect from database\n   */\n  public async disconnect(): Promise<void> {\n    await Promise.all(this.instances.map(instance => instance.disconnect()));\n\n    this.instances = [];\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": ";;AAAA,SAAS,gBAAgB;AACzB,OAAO,sBAAsB;AAE7B,SAAS,cAAc;AAKvB,MAAO,gBAA8B;AAAA,EARrC,OAQqC;AAAA;AAAA;AAAA,EAC3B,SAAwB;AAAA,EAEf;AAAA,EAET,YAAgC,CAAC;AAAA;AAAA;AAAA;AAAA,EAKzC,YAAY,SAAqC;AAC/C,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,UAAqC;AAChD,UAAM,MAAM,MAAM,SAAS,KAAK;AAEhC,UAAM,mBAAmB,IAAI,iBAAiB;AAAA,MAC5C,iBAAiB;AAAA,MACjB,mBAAmB,KAAK,QAAQ;AAAA,MAChC;AAAA,IACF,CAAC;AAED,SAAK,UAAU,KAAK,gBAAgB;AAEpC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,aAA4B;AACvC,UAAM,QAAQ,IAAI,KAAK,UAAU,IAAI,cAAY,SAAS,WAAW,CAAC,CAAC;AAEvE,SAAK,YAAY,CAAC;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKO,IAAI,SAAiB,MAAsC;AAChE,SAAK,OAAO,OAAO,EAAE,OAAO,YAAY,SAAS,KAAK,CAAC;AAAA,EACzD;AACF;",
+  "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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",
   "names": []
 }

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-reporter.js

@@ -0,0 +1,228 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import * as Sentry from "@sentry/node";
+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";
+class ErrorReporter {
+  static {
+    __name(this, "ErrorReporter");
+  }
+  static instance;
+  constructor() {
+  }
+  /**
+   * Get the singleton instance
+   */
+  static getInstance() {
+    if (!ErrorReporter.instance) {
+      ErrorReporter.instance = new ErrorReporter();
+    }
+    return ErrorReporter.instance;
+  }
+  /**
+   * 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, options) {
+    const envelope = this.normalizeError(error, options);
+    if (options?.log !== false) {
+      this.logError(envelope);
+    }
+    if (this.shouldCaptureInSentry(envelope, options)) {
+      this.captureInSentry(error, envelope);
+    }
+    return envelope;
+  }
+  /**
+   * Normalize any error into a standardized ErrorEnvelope
+   *
+   * @param error - The error to normalize
+   * @param options - Optional configuration
+   * @returns Normalized error envelope
+   */
+  normalizeError(error, options) {
+    const requestId = getRequestId();
+    if (error instanceof FrameworkError) {
+      return {
+        message: error.message,
+        code: options?.code ?? error.code,
+        severity: options?.severity ?? error.severity,
+        stack: error.stack,
+        requestId,
+        context: { ...error.context, ...options?.context },
+        cause: error.cause,
+        timestamp: error.timestamp,
+        name: error.name
+      };
+    }
+    if (error instanceof Error) {
+      return {
+        message: error.message,
+        code: options?.code ?? ErrorCode.UNKNOWN,
+        severity: options?.severity ?? ErrorSeverity.ERROR,
+        stack: error.stack,
+        requestId,
+        context: options?.context,
+        cause: error.cause,
+        timestamp: /* @__PURE__ */ new Date(),
+        name: error.name
+      };
+    }
+    if (typeof error === "string") {
+      return {
+        message: error,
+        code: options?.code ?? ErrorCode.UNKNOWN,
+        severity: options?.severity ?? ErrorSeverity.ERROR,
+        requestId,
+        context: options?.context,
+        timestamp: /* @__PURE__ */ new Date()
+      };
+    }
+    return {
+      message: this.serializeUnknownError(error),
+      code: options?.code ?? ErrorCode.UNKNOWN,
+      severity: options?.severity ?? ErrorSeverity.ERROR,
+      requestId,
+      context: { ...options?.context, originalError: error },
+      timestamp: /* @__PURE__ */ new Date()
+    };
+  }
+  /**
+   * Log the error with appropriate severity
+   *
+   * @param envelope - Normalized error envelope
+   */
+  logError(envelope) {
+    const meta = {
+      code: envelope.code,
+      severity: envelope.severity
+    };
+    if (envelope.requestId) {
+      meta.requestId = envelope.requestId;
+    }
+    if (envelope.context) {
+      Object.assign(meta, envelope.context);
+    }
+    switch (envelope.severity) {
+      case ErrorSeverity.FATAL:
+      case ErrorSeverity.CRITICAL:
+      case ErrorSeverity.ERROR:
+        Logger.error({ error: envelope.message, meta });
+        break;
+      case ErrorSeverity.WARNING:
+        Logger.warn({ message: envelope.message, meta });
+        break;
+      case ErrorSeverity.INFO:
+        Logger.info({ message: envelope.message, meta });
+        break;
+    }
+  }
+  /**
+   * Determine if error should be captured in Sentry
+   *
+   * @param envelope - Normalized error envelope
+   * @param options - Reporting options
+   * @returns Whether to capture in Sentry
+   */
+  shouldCaptureInSentry(envelope, options) {
+    if (options?.captureInSentry === false) {
+      return false;
+    }
+    if (options?.captureInSentry === true) {
+      return true;
+    }
+    return envelope.severity === ErrorSeverity.FATAL || envelope.severity === ErrorSeverity.CRITICAL || envelope.severity === ErrorSeverity.ERROR;
+  }
+  /**
+   * Capture error in Sentry with enriched context
+   *
+   * @param error - Original error
+   * @param envelope - Normalized error envelope
+   */
+  captureInSentry(error, envelope) {
+    if (!Logger.isSentryInitialized) {
+      return;
+    }
+    Sentry.withScope((scope) => {
+      scope.setLevel(this.mapSeverityToSentryLevel(envelope.severity));
+      scope.setTag("error_code", envelope.code);
+      if (envelope.requestId) {
+        scope.setTag("request_id", envelope.requestId);
+      }
+      if (envelope.context) {
+        scope.setContext("error_context", envelope.context);
+      }
+      if (error instanceof Error) {
+        Sentry.captureException(error);
+      } else {
+        Sentry.captureMessage(envelope.message, "error");
+      }
+    });
+  }
+  /**
+   * Map framework error severity to Sentry severity level
+   *
+   * @param severity - Framework error severity
+   * @returns Sentry severity level
+   */
+  mapSeverityToSentryLevel(severity) {
+    switch (severity) {
+      case ErrorSeverity.FATAL:
+        return "fatal";
+      case ErrorSeverity.CRITICAL:
+        return "error";
+      case ErrorSeverity.ERROR:
+        return "error";
+      case ErrorSeverity.WARNING:
+        return "warning";
+      case ErrorSeverity.INFO:
+        return "info";
+      default:
+        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
+};
+//# sourceMappingURL=error-reporter.js.map

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

@@ -0,0 +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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",
+  "names": []
+}