node-server-engine 2.1.0 → 2.2.0

package/README.md

@@ -1057,16 +1057,19 @@ Sequelize.closeSequelize();
 
 It can be configured through environment variables
 
-| env                   | description                                                                                | default  |
-| --------------------- | ------------------------------------------------------------------------------------------ | -------- |
-| SQL_HOST              | Host to which connect to                                                                   |          |
-| SQL_PORT              | Port on which SQL is served                                                                | 5432     |
-| SQL_PASSWORD          | Password used to authenticate with the SQL server                                          |          |
-| SQL_USER              | User used to authenticate with the SQL server                                              |          |
-| SQL_DB                | Database to which connect to                                                               |          |
-| SQL_TYPE              | SQL type which connect to                                                                  | postgres |
-| SQL_ENCRYPT           | `mssql` only: set to `false` to disable TLS                                                | true     |
-| SQL_TRUST_SERVER_CERT | `mssql` only: `true` skips certificate verification (self-signed development servers only) | false    |
+| env                   | description                                                                                                                                    | default  |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
+| SQL_HOST              | Host to which connect to                                                                                                                       |          |
+| SQL_PORT              | Port on which SQL is served                                                                                                                    | 5432     |
+| SQL_PASSWORD          | Password used to authenticate with the SQL server                                                                                              |          |
+| SQL_USER              | User used to authenticate with the SQL server                                                                                                  |          |
+| SQL_DB                | Database to which connect to                                                                                                                   |          |
+| SQL_TYPE              | SQL type which connect to                                                                                                                      | postgres |
+| SQL_ENCRYPT           | `mssql` only: set to `false` to disable TLS                                                                                                    | true     |
+| SQL_LOWERCASE_GUIDS   | `mssql` only: `true` returns UNIQUEIDENTIFIER values in lower case, like JavaScript UUIDs                                                      | false    |
+| SQL_TRUST_SERVER_CERT | `mssql` only: `true` skips certificate verification (self-signed development servers only)                                                     | false    |
+| SQL_POOL_MAX          | Maximum connections in the pool (always 1 when `NODE_ENV=test`)                                                                                | 5        |
+| SQL_SYNC_MODELS       | `true` creates missing tables from the models in `addModels()`; always on when `NODE_ENV=test`, off otherwise so the migrations own the schema | false    |
 
 ---
 
@@ -1816,11 +1819,15 @@ if (!user) {
 
 In addition to the [common options](#common-options), WebError defines some other options specific for error reporting to clients.
 
-| option     | definition                                                       | example      | default      |
-| ---------- | ---------------------------------------------------------------- | ------------ | ------------ |
-| errorCode  | A machine readable error code that will be parsed by the client. | unknown-user | **required** |
-| statusCode | HTTP status code of the response.                                | 400          | 500          |
-| hint       | A human readable error message that is intended for developers   |              |
+| option        | definition                                                                                                                                                  | example               | default      |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ------------ |
+| errorCode     | A machine readable error code that will be parsed by the client.                                                                                            | unknown-user          | **required** |
+| statusCode    | HTTP status code of the response.                                                                                                                           | 400                   | 500          |
+| hint          | A human readable error message that is intended for developers                                                                                              |                       |
+| details       | Public structured data the client acts on, returned as `details` (attempts left, per-row errors...). Never put secrets here; `data` stays in the logs only. | `{ attemptsLeft: 2 }` |              |
+| retryAfterSec | Seconds before the client may retry, sent as the `Retry-After` header                                                                                       | 60                    |              |
+
+The error middleware answers `{ errorCode, hint, details? }` with the given status code.
 
 ## Middlewares
 

package/dist/entities/Sequelize/Sequelize.config.js

@@ -33,7 +33,7 @@ const config = {
   },
   dialectOptions: {},
   pool: {
-    max: process.env.NODE_ENV === 'test' ? 1 : 5,
+    max: process.env.NODE_ENV === 'test' ? 1 : Number(process.env.SQL_POOL_MAX) || 5,
     min: 0,
     acquire: process.env.NODE_ENV === 'test' ? 1000 : 30000,
     // Reduce acquire timeout in test
@@ -55,7 +55,9 @@ if (config.dialect === 'mssql') {
       // Encrypted connections by default; SQL_ENCRYPT=false only for servers without TLS
       encrypt: process.env.SQL_ENCRYPT !== 'false',
       // The server certificate is verified unless SQL_TRUST_SERVER_CERT=true (self-signed development servers)
-      trustServerCertificate: process.env.SQL_TRUST_SERVER_CERT === 'true'
+      trustServerCertificate: process.env.SQL_TRUST_SERVER_CERT === 'true',
+      // UNIQUEIDENTIFIER values come back upper case unless SQL_LOWERCASE_GUIDS=true (matches JS / client UUIDs)
+      lowerCaseGuids: process.env.SQL_LOWERCASE_GUIDS === 'true'
     }
   };
 }

package/dist/entities/Sequelize/Sequelize.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sequelize.config.js","names":["_Sequelize","require","validateSequelizeEnvironment","isUnixSocket","process","env","SQL_HOST","startsWith","config","username","SQL_USER","password","SQL_PASSWORD","database","SQL_DB","host","port","undefined","SQL_PORT","parseInt","dialect","SQL_TYPE","logging","SQL_LOGGING","console","log","define","freezeTableName","charset","collate","retry","max","NODE_ENV","dialectOptions","pool","min","acquire","idle","evict","options","requestTimeout","connectTimeout","encrypt","SQL_ENCRYPT","trustServerCertificate","SQL_TRUST_SERVER_CERT","timezone","ssl","PG_SSL","rejectUnauthorized","development","exports","staging","production","test","_default","default"],"sources":["../../../src/entities/Sequelize/Sequelize.config.ts"],"sourcesContent":["import { Options, Dialect } from 'sequelize';\nimport { validateSequelizeEnvironment } from './Sequelize.validate';\n\n// Check that environment variables are correctly set\nvalidateSequelizeEnvironment();\n\n// Check if SQL_HOST is a Unix socket path (Cloud SQL)\nconst isUnixSocket = process.env.SQL_HOST?.startsWith('/');\n\nconst config: Options = {\n  username: process.env.SQL_USER,\n  password: process.env.SQL_PASSWORD,\n  database: process.env.SQL_DB,\n  host: process.env.SQL_HOST,\n  // Don't set port for Unix socket connections (Cloud SQL)\n  port: isUnixSocket\n    ? undefined\n    : process.env.SQL_PORT\n      ? parseInt(process.env.SQL_PORT)\n      : 5432,\n  dialect: (process.env.SQL_TYPE ?? 'postgres') as Dialect, // Dynamically set the dialect (postgres, mysql, mssql)\n  logging: process.env.SQL_LOGGING === 'true' ? console.log : false, // Enable SQL logging with SQL_LOGGING=true\n  define: {\n    freezeTableName: false, // Prevent automatic pluralization of table names\n    charset: 'utf8mb4', // Set character set for MySQL/MariaDB\n    collate: 'utf8mb4_unicode_ci' // Set collation for MySQL/MariaDB\n  },\n  retry: {\n    max: process.env.NODE_ENV === 'test' ? 0 : 3 // Disable retries in test environment to prevent unhandled rejections\n  },\n  dialectOptions: {},\n  pool: {\n    max: process.env.NODE_ENV === 'test' ? 1 : 5,\n    min: 0,\n    acquire: process.env.NODE_ENV === 'test' ? 1000 : 30000, // Reduce acquire timeout in test\n    idle: process.env.NODE_ENV === 'test' ? 1000 : 10000, // Reduce idle time in test\n    evict: process.env.NODE_ENV === 'test' ? 100 : 1000 // How often to check for idle connections\n  }\n};\n\n// Additional configurations for MSSQL\nif (config.dialect === 'mssql') {\n  // tedious connection options live under dialectOptions.options\n  config.dialectOptions = {\n    options: {\n      requestTimeout: 30000, // Increase request timeout for MSSQL\n      connectTimeout: 30000, // Increase connection timeout for MSSQL\n      // Encrypted connections by default; SQL_ENCRYPT=false only for servers without TLS\n      encrypt: process.env.SQL_ENCRYPT !== 'false',\n      // The server certificate is verified unless SQL_TRUST_SERVER_CERT=true (self-signed development servers)\n      trustServerCertificate: process.env.SQL_TRUST_SERVER_CERT === 'true'\n    }\n  };\n}\n\n// Add specific dialect configurations if necessary for MySQL/PostgreSQL\nif (config.dialect === 'mysql') {\n  config.dialectOptions = {\n    timezone: 'Z' // Set timezone for MySQL\n  };\n}\n\nif (config.dialect === 'postgres') {\n  config.dialectOptions = {\n    ssl: process.env.PG_SSL === 'true' ? { rejectUnauthorized: false } : false // SSL options for PostgreSQL (if required)\n  };\n}\n\nexport const development = config;\nexport const staging = config;\nexport const production = config;\nexport const test = config;\nexport default config;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Sequelize.config.js","names":["_Sequelize","require","validateSequelizeEnvironment","isUnixSocket","process","env","SQL_HOST","startsWith","config","username","SQL_USER","password","SQL_PASSWORD","database","SQL_DB","host","port","undefined","SQL_PORT","parseInt","dialect","SQL_TYPE","logging","SQL_LOGGING","console","log","define","freezeTableName","charset","collate","retry","max","NODE_ENV","dialectOptions","pool","Number","SQL_POOL_MAX","min","acquire","idle","evict","options","requestTimeout","connectTimeout","encrypt","SQL_ENCRYPT","trustServerCertificate","SQL_TRUST_SERVER_CERT","lowerCaseGuids","SQL_LOWERCASE_GUIDS","timezone","ssl","PG_SSL","rejectUnauthorized","development","exports","staging","production","test","_default","default"],"sources":["../../../src/entities/Sequelize/Sequelize.config.ts"],"sourcesContent":["import { Options, Dialect } from 'sequelize';\nimport { validateSequelizeEnvironment } from './Sequelize.validate';\n\n// Check that environment variables are correctly set\nvalidateSequelizeEnvironment();\n\n// Check if SQL_HOST is a Unix socket path (Cloud SQL)\nconst isUnixSocket = process.env.SQL_HOST?.startsWith('/');\n\nconst config: Options = {\n  username: process.env.SQL_USER,\n  password: process.env.SQL_PASSWORD,\n  database: process.env.SQL_DB,\n  host: process.env.SQL_HOST,\n  // Don't set port for Unix socket connections (Cloud SQL)\n  port: isUnixSocket\n    ? undefined\n    : process.env.SQL_PORT\n      ? parseInt(process.env.SQL_PORT)\n      : 5432,\n  dialect: (process.env.SQL_TYPE ?? 'postgres') as Dialect, // Dynamically set the dialect (postgres, mysql, mssql)\n  logging: process.env.SQL_LOGGING === 'true' ? console.log : false, // Enable SQL logging with SQL_LOGGING=true\n  define: {\n    freezeTableName: false, // Prevent automatic pluralization of table names\n    charset: 'utf8mb4', // Set character set for MySQL/MariaDB\n    collate: 'utf8mb4_unicode_ci' // Set collation for MySQL/MariaDB\n  },\n  retry: {\n    max: process.env.NODE_ENV === 'test' ? 0 : 3 // Disable retries in test environment to prevent unhandled rejections\n  },\n  dialectOptions: {},\n  pool: {\n    max:\n      process.env.NODE_ENV === 'test'\n        ? 1\n        : Number(process.env.SQL_POOL_MAX) || 5,\n    min: 0,\n    acquire: process.env.NODE_ENV === 'test' ? 1000 : 30000, // Reduce acquire timeout in test\n    idle: process.env.NODE_ENV === 'test' ? 1000 : 10000, // Reduce idle time in test\n    evict: process.env.NODE_ENV === 'test' ? 100 : 1000 // How often to check for idle connections\n  }\n};\n\n// Additional configurations for MSSQL\nif (config.dialect === 'mssql') {\n  // tedious connection options live under dialectOptions.options\n  config.dialectOptions = {\n    options: {\n      requestTimeout: 30000, // Increase request timeout for MSSQL\n      connectTimeout: 30000, // Increase connection timeout for MSSQL\n      // Encrypted connections by default; SQL_ENCRYPT=false only for servers without TLS\n      encrypt: process.env.SQL_ENCRYPT !== 'false',\n      // The server certificate is verified unless SQL_TRUST_SERVER_CERT=true (self-signed development servers)\n      trustServerCertificate: process.env.SQL_TRUST_SERVER_CERT === 'true',\n      // UNIQUEIDENTIFIER values come back upper case unless SQL_LOWERCASE_GUIDS=true (matches JS / client UUIDs)\n      lowerCaseGuids: process.env.SQL_LOWERCASE_GUIDS === 'true'\n    }\n  };\n}\n\n// Add specific dialect configurations if necessary for MySQL/PostgreSQL\nif (config.dialect === 'mysql') {\n  config.dialectOptions = {\n    timezone: 'Z' // Set timezone for MySQL\n  };\n}\n\nif (config.dialect === 'postgres') {\n  config.dialectOptions = {\n    ssl: process.env.PG_SSL === 'true' ? { rejectUnauthorized: false } : false // SSL options for PostgreSQL (if required)\n  };\n}\n\nexport const development = config;\nexport const staging = config;\nexport const production = config;\nexport const test = config;\nexport default config;\n"],"mappings":";;;;;;AACA,IAAAA,UAAA,GAAAC,OAAA;AAEA;AACA,IAAAC,uCAA4B,EAAC,CAAC;;AAE9B;AACA,MAAMC,YAAY,GAAGC,OAAO,CAACC,GAAG,CAACC,QAAQ,EAAEC,UAAU,CAAC,GAAG,CAAC;AAE1D,MAAMC,MAAe,GAAG;EACtBC,QAAQ,EAAEL,OAAO,CAACC,GAAG,CAACK,QAAQ;EAC9BC,QAAQ,EAAEP,OAAO,CAACC,GAAG,CAACO,YAAY;EAClCC,QAAQ,EAAET,OAAO,CAACC,GAAG,CAACS,MAAM;EAC5BC,IAAI,EAAEX,OAAO,CAACC,GAAG,CAACC,QAAQ;EAC1B;EACAU,IAAI,EAAEb,YAAY,GACdc,SAAS,GACTb,OAAO,CAACC,GAAG,CAACa,QAAQ,GAClBC,QAAQ,CAACf,OAAO,CAACC,GAAG,CAACa,QAAQ,CAAC,GAC9B,IAAI;EACVE,OAAO,EAAGhB,OAAO,CAACC,GAAG,CAACgB,QAAQ,IAAI,UAAsB;EAAE;EAC1DC,OAAO,EAAElB,OAAO,CAACC,GAAG,CAACkB,WAAW,KAAK,MAAM,GAAGC,OAAO,CAACC,GAAG,GAAG,KAAK;EAAE;EACnEC,MAAM,EAAE;IACNC,eAAe,EAAE,KAAK;IAAE;IACxBC,OAAO,EAAE,SAAS;IAAE;IACpBC,OAAO,EAAE,oBAAoB,CAAC;EAChC,CAAC;EACDC,KAAK,EAAE;IACLC,GAAG,EAAE3B,OAAO,CAACC,GAAG,CAAC2B,QAAQ,KAAK,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;EAC/C,CAAC;EACDC,cAAc,EAAE,CAAC,CAAC;EAClBC,IAAI,EAAE;IACJH,GAAG,EACD3B,OAAO,CAACC,GAAG,CAAC2B,QAAQ,KAAK,MAAM,GAC3B,CAAC,GACDG,MAAM,CAAC/B,OAAO,CAACC,GAAG,CAAC+B,YAAY,CAAC,IAAI,CAAC;IAC3CC,GAAG,EAAE,CAAC;IACNC,OAAO,EAAElC,OAAO,CAACC,GAAG,CAAC2B,QAAQ,KAAK,MAAM,GAAG,IAAI,GAAG,KAAK;IAAE;IACzDO,IAAI,EAAEnC,OAAO,CAACC,GAAG,CAAC2B,QAAQ,KAAK,MAAM,GAAG,IAAI,GAAG,KAAK;IAAE;IACtDQ,KAAK,EAAEpC,OAAO,CAACC,GAAG,CAAC2B,QAAQ,KAAK,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;EACtD;AACF,CAAC;;AAED;AACA,IAAIxB,MAAM,CAACY,OAAO,KAAK,OAAO,EAAE;EAC9B;EACAZ,MAAM,CAACyB,cAAc,GAAG;IACtBQ,OAAO,EAAE;MACPC,cAAc,EAAE,KAAK;MAAE;MACvBC,cAAc,EAAE,KAAK;MAAE;MACvB;MACAC,OAAO,EAAExC,OAAO,CAACC,GAAG,CAACwC,WAAW,KAAK,OAAO;MAC5C;MACAC,sBAAsB,EAAE1C,OAAO,CAACC,GAAG,CAAC0C,qBAAqB,KAAK,MAAM;MACpE;MACAC,cAAc,EAAE5C,OAAO,CAACC,GAAG,CAAC4C,mBAAmB,KAAK;IACtD;EACF,CAAC;AACH;;AAEA;AACA,IAAIzC,MAAM,CAACY,OAAO,KAAK,OAAO,EAAE;EAC9BZ,MAAM,CAACyB,cAAc,GAAG;IACtBiB,QAAQ,EAAE,GAAG,CAAC;EAChB,CAAC;AACH;AAEA,IAAI1C,MAAM,CAACY,OAAO,KAAK,UAAU,EAAE;EACjCZ,MAAM,CAACyB,cAAc,GAAG;IACtBkB,GAAG,EAAE/C,OAAO,CAACC,GAAG,CAAC+C,MAAM,KAAK,MAAM,GAAG;MAAEC,kBAAkB,EAAE;IAAM,CAAC,GAAG,KAAK,CAAC;EAC7E,CAAC;AACH;AAEO,MAAMC,WAAW,GAAAC,OAAA,CAAAD,WAAA,GAAG9C,MAAM;AAC1B,MAAMgD,OAAO,GAAAD,OAAA,CAAAC,OAAA,GAAGhD,MAAM;AACtB,MAAMiD,UAAU,GAAAF,OAAA,CAAAE,UAAA,GAAGjD,MAAM;AACzB,MAAMkD,IAAI,GAAAH,OAAA,CAAAG,IAAA,GAAGlD,MAAM;AAAC,IAAAmD,QAAA,GAAAJ,OAAA,CAAAK,OAAA,GACZpD,MAAM","ignoreList":[]}

package/dist/entities/Sequelize/Sequelize.js

@@ -141,7 +141,15 @@ function addModels(models) {
       convertToPlain(result);
     }
   });
-  sequelizeClient.sync();
+
+  // Creating tables from the models is for the in-memory test database (or when explicitly asked).
+  // Elsewhere the schema belongs to the migrations: a sync racing them would create tables without
+  // their constraints and triggers.
+  if (process.env.NODE_ENV === 'test' || process.env.SQL_SYNC_MODELS === 'true') {
+    sequelizeClient.sync().catch(error => {
+      (0, _report.reportError)(error);
+    });
+  }
 }
 
 /** Create Sequelize client */

package/dist/entities/Sequelize/Sequelize.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sequelize.js","names":["_path","_interopRequireDefault","require","_sequelizeTypescript","_Sequelize","_Sequelize2","_EngineError","_LifecycleController","_report","sequelizeClient","exports","sequelize","Proxy","get","target","property","init","shutdown","addModels","EngineError","message","reportInfo","data","host","process","env","SQL_HOST","database","SQL_DB","user","SQL_USER","port","SQL_PORT","dialect","SQL_TYPE","isUnixSocket","startsWith","sqlStorage","toLowerCase","SQL_STORAGE","path","join","cwd","undefined","createSequelizeClient","NODE_ENV","authenticate","getDialect","err","reportError","error","Error","String","stack","LifecycleController","register","close","console","models","addHook","result","convertToPlain","instance","modelInstance","toJSON","plain","Object","keys","forEach","key","Array","isArray","sync","Sequelize","storage","logging","sqlType","trim","length","SQL_LOGGING","log","validateSequelizeEnvironment","username","dbConfig","poolMax","pool","max","poolMin","min","SQL_PASSWORD"],"sources":["../../../src/entities/Sequelize/Sequelize.ts"],"sourcesContent":["import path from 'path';\nimport { Sequelize, ModelCtor } from 'sequelize-typescript';\nimport dbConfig from './Sequelize.config';\nimport { Sequelize as SequelizeInterface } from './Sequelize.types';\nimport { validateSequelizeEnvironment } from './Sequelize.validate';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { reportInfo, reportError } from 'utils/report';\n\nexport let sequelizeClient: undefined | Sequelize;\n\n/**\n * We use a proxy to extend the Sequelize behavior and allow initialization of the client only when needed while keeping the same interface\n */\nexport const sequelize = new Proxy<SequelizeInterface>(\n  // Due to how we do the proxying, we are forced to ignore ts-errors, we could never create an object that respects the interface properly\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore\n  {},\n  {\n    get: function (target, property): unknown {\n      if (property === 'init') return init;\n      if (property === 'shutdown') return shutdown;\n      if (property === 'addModels') return addModels;\n      // Create the sequelize client if it does not exist\n      if (!sequelizeClient)\n        throw new EngineError({\n          message: 'Sequelize client was not initialized'\n        });\n      // Call the function on the sequelize client\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      return sequelizeClient[property] as unknown;\n    }\n  }\n);\n\n/** On init create client and connect */\nexport async function init(): Promise<void> {\n  // Ignore if already initialized\n  if (sequelizeClient) return;\n\n  reportInfo({\n    message: 'Initializing Sequelize client',\n    data: {\n      host: process.env.SQL_HOST,\n      database: process.env.SQL_DB,\n      user: process.env.SQL_USER,\n      port: process.env.SQL_PORT,\n      dialect: process.env.SQL_TYPE || 'postgres',\n      isUnixSocket: process.env.SQL_HOST?.startsWith('/'),\n      sqlStorage:\n        (process.env.SQL_TYPE ?? '').toLowerCase() === 'sqlite'\n          ? process.env.SQL_STORAGE ||\n            path.join(process.cwd(), 'database.sqlite')\n          : undefined\n    }\n  });\n\n  sequelizeClient = createSequelizeClient();\n\n  // In test environment, authentication happens automatically with SQLite\n  // For other environments, authenticate and log the result\n  if (process.env.NODE_ENV !== 'test') {\n    reportInfo({\n      message: 'Starting database authentication'\n    });\n\n    try {\n      await sequelizeClient.authenticate();\n      reportInfo({\n        message: 'Connected to database successfully',\n        data: {\n          host: process.env.SQL_HOST,\n          database: process.env.SQL_DB,\n          dialect: sequelizeClient?.getDialect()\n        }\n      });\n    } catch (err) {\n      reportError({\n        message: 'Failed to connect to database',\n        data: {\n          error: err instanceof Error ? err.message : String(err),\n          stack: err instanceof Error ? err.stack : undefined,\n          host: process.env.SQL_HOST,\n          database: process.env.SQL_DB,\n          user: process.env.SQL_USER,\n          port: process.env.SQL_PORT\n        }\n      });\n      if (err instanceof Error) {\n        reportError(err);\n      }\n      throw err;\n    }\n  }\n\n  LifecycleController.register(sequelize);\n}\n\n/** On shutdown close connection and clear client */\nexport async function shutdown(): Promise<void> {\n  if (sequelizeClient) {\n    try {\n      // For SQLite, just close the client (closing connection manager first causes SQLITE_MISUSE)\n      // For other dialects, sequelize.close() handles everything properly\n      await sequelizeClient.close();\n    } catch (error) {\n      // Ignore errors during shutdown\n      if (process.env.NODE_ENV !== 'test') {\n        console.error('Error closing sequelize client:', error);\n      }\n    }\n  }\n  sequelizeClient = undefined;\n}\n\nexport function addModels(models: Array<ModelCtor>): void {\n  if (!sequelizeClient)\n    throw new EngineError({\n      message: 'Sequelize client was not initialized'\n    });\n  sequelizeClient.addModels(models);\n\n  // Override toJSON behavior globally to ensure consistency between dev and prod\n  // In dev (ts-node), property access works directly on instances\n  // In prod (compiled), we need explicit serialization\n  // This hook intercepts all afterFind results and converts them to plain objects\n  sequelizeClient.addHook('afterFind', (result) => {\n    if (!result) return;\n\n    const convertToPlain = (instance: unknown) => {\n      if (!instance || typeof instance !== 'object') return instance;\n      const modelInstance = instance as {\n        toJSON?: () => Record<string, unknown>;\n      } & Record<string, unknown>;\n      if (!modelInstance.toJSON) return instance;\n      const plain = modelInstance.toJSON();\n      // Copy the plain object properties back to the instance\n      // This makes property access work without .toJSON() in compiled code\n      Object.keys(plain).forEach((key) => {\n        modelInstance[key] = plain[key];\n      });\n    };\n\n    if (Array.isArray(result)) {\n      result.forEach(convertToPlain);\n    } else {\n      convertToPlain(result);\n    }\n  });\n\n  sequelizeClient.sync();\n}\n\n/** Create Sequelize client */\nexport function createSequelizeClient(): Sequelize {\n  // Use in-memory SQLite for test environment to avoid real database connections\n  if (process.env.NODE_ENV === 'test') {\n    return new Sequelize({\n      dialect: 'sqlite',\n      storage: ':memory:',\n      logging: false\n    });\n  }\n\n  // File-based SQLite for local / offline dev (no SQL_HOST / live server)\n  const sqlType = (process.env.SQL_TYPE ?? '').toLowerCase();\n  if (sqlType === 'sqlite') {\n    const storage =\n      process.env.SQL_STORAGE && process.env.SQL_STORAGE.trim().length > 0\n        ? process.env.SQL_STORAGE.trim()\n        : path.join(process.cwd(), 'database.sqlite');\n    reportInfo({\n      message: 'Creating Sequelize client (SQLite file)',\n      data: { storage, dialect: 'sqlite' }\n    });\n    return new Sequelize({\n      dialect: 'sqlite',\n      storage,\n      logging: process.env.SQL_LOGGING === 'true' ? console.log : false\n    });\n  }\n\n  // Throw an error if there is no host initial\n  validateSequelizeEnvironment();\n\n  reportInfo({\n    message: 'Creating Sequelize client with config',\n    data: {\n      database: process.env.SQL_DB,\n      username: process.env.SQL_USER,\n      host: process.env.SQL_HOST,\n      port: dbConfig.port,\n      dialect: dbConfig.dialect,\n      isUnixSocket: process.env.SQL_HOST?.startsWith('/'),\n      poolMax: dbConfig.pool?.max,\n      poolMin: dbConfig.pool?.min\n    }\n  });\n\n  return new Sequelize(\n    process.env.SQL_DB as string,\n    process.env.SQL_USER as string,\n    process.env.SQL_PASSWORD as string,\n    dbConfig\n  );\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Sequelize.js","names":["_path","_interopRequireDefault","require","_sequelizeTypescript","_Sequelize","_Sequelize2","_EngineError","_LifecycleController","_report","sequelizeClient","exports","sequelize","Proxy","get","target","property","init","shutdown","addModels","EngineError","message","reportInfo","data","host","process","env","SQL_HOST","database","SQL_DB","user","SQL_USER","port","SQL_PORT","dialect","SQL_TYPE","isUnixSocket","startsWith","sqlStorage","toLowerCase","SQL_STORAGE","path","join","cwd","undefined","createSequelizeClient","NODE_ENV","authenticate","getDialect","err","reportError","error","Error","String","stack","LifecycleController","register","close","console","models","addHook","result","convertToPlain","instance","modelInstance","toJSON","plain","Object","keys","forEach","key","Array","isArray","SQL_SYNC_MODELS","sync","catch","Sequelize","storage","logging","sqlType","trim","length","SQL_LOGGING","log","validateSequelizeEnvironment","username","dbConfig","poolMax","pool","max","poolMin","min","SQL_PASSWORD"],"sources":["../../../src/entities/Sequelize/Sequelize.ts"],"sourcesContent":["import path from 'path';\nimport { Sequelize, ModelCtor } from 'sequelize-typescript';\nimport dbConfig from './Sequelize.config';\nimport { Sequelize as SequelizeInterface } from './Sequelize.types';\nimport { validateSequelizeEnvironment } from './Sequelize.validate';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { reportInfo, reportError } from 'utils/report';\n\nexport let sequelizeClient: undefined | Sequelize;\n\n/**\n * We use a proxy to extend the Sequelize behavior and allow initialization of the client only when needed while keeping the same interface\n */\nexport const sequelize = new Proxy<SequelizeInterface>(\n  // Due to how we do the proxying, we are forced to ignore ts-errors, we could never create an object that respects the interface properly\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore\n  {},\n  {\n    get: function (target, property): unknown {\n      if (property === 'init') return init;\n      if (property === 'shutdown') return shutdown;\n      if (property === 'addModels') return addModels;\n      // Create the sequelize client if it does not exist\n      if (!sequelizeClient)\n        throw new EngineError({\n          message: 'Sequelize client was not initialized'\n        });\n      // Call the function on the sequelize client\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      return sequelizeClient[property] as unknown;\n    }\n  }\n);\n\n/** On init create client and connect */\nexport async function init(): Promise<void> {\n  // Ignore if already initialized\n  if (sequelizeClient) return;\n\n  reportInfo({\n    message: 'Initializing Sequelize client',\n    data: {\n      host: process.env.SQL_HOST,\n      database: process.env.SQL_DB,\n      user: process.env.SQL_USER,\n      port: process.env.SQL_PORT,\n      dialect: process.env.SQL_TYPE || 'postgres',\n      isUnixSocket: process.env.SQL_HOST?.startsWith('/'),\n      sqlStorage:\n        (process.env.SQL_TYPE ?? '').toLowerCase() === 'sqlite'\n          ? process.env.SQL_STORAGE ||\n            path.join(process.cwd(), 'database.sqlite')\n          : undefined\n    }\n  });\n\n  sequelizeClient = createSequelizeClient();\n\n  // In test environment, authentication happens automatically with SQLite\n  // For other environments, authenticate and log the result\n  if (process.env.NODE_ENV !== 'test') {\n    reportInfo({\n      message: 'Starting database authentication'\n    });\n\n    try {\n      await sequelizeClient.authenticate();\n      reportInfo({\n        message: 'Connected to database successfully',\n        data: {\n          host: process.env.SQL_HOST,\n          database: process.env.SQL_DB,\n          dialect: sequelizeClient?.getDialect()\n        }\n      });\n    } catch (err) {\n      reportError({\n        message: 'Failed to connect to database',\n        data: {\n          error: err instanceof Error ? err.message : String(err),\n          stack: err instanceof Error ? err.stack : undefined,\n          host: process.env.SQL_HOST,\n          database: process.env.SQL_DB,\n          user: process.env.SQL_USER,\n          port: process.env.SQL_PORT\n        }\n      });\n      if (err instanceof Error) {\n        reportError(err);\n      }\n      throw err;\n    }\n  }\n\n  LifecycleController.register(sequelize);\n}\n\n/** On shutdown close connection and clear client */\nexport async function shutdown(): Promise<void> {\n  if (sequelizeClient) {\n    try {\n      // For SQLite, just close the client (closing connection manager first causes SQLITE_MISUSE)\n      // For other dialects, sequelize.close() handles everything properly\n      await sequelizeClient.close();\n    } catch (error) {\n      // Ignore errors during shutdown\n      if (process.env.NODE_ENV !== 'test') {\n        console.error('Error closing sequelize client:', error);\n      }\n    }\n  }\n  sequelizeClient = undefined;\n}\n\nexport function addModels(models: Array<ModelCtor>): void {\n  if (!sequelizeClient)\n    throw new EngineError({\n      message: 'Sequelize client was not initialized'\n    });\n  sequelizeClient.addModels(models);\n\n  // Override toJSON behavior globally to ensure consistency between dev and prod\n  // In dev (ts-node), property access works directly on instances\n  // In prod (compiled), we need explicit serialization\n  // This hook intercepts all afterFind results and converts them to plain objects\n  sequelizeClient.addHook('afterFind', (result) => {\n    if (!result) return;\n\n    const convertToPlain = (instance: unknown) => {\n      if (!instance || typeof instance !== 'object') return instance;\n      const modelInstance = instance as {\n        toJSON?: () => Record<string, unknown>;\n      } & Record<string, unknown>;\n      if (!modelInstance.toJSON) return instance;\n      const plain = modelInstance.toJSON();\n      // Copy the plain object properties back to the instance\n      // This makes property access work without .toJSON() in compiled code\n      Object.keys(plain).forEach((key) => {\n        modelInstance[key] = plain[key];\n      });\n    };\n\n    if (Array.isArray(result)) {\n      result.forEach(convertToPlain);\n    } else {\n      convertToPlain(result);\n    }\n  });\n\n  // Creating tables from the models is for the in-memory test database (or when explicitly asked).\n  // Elsewhere the schema belongs to the migrations: a sync racing them would create tables without\n  // their constraints and triggers.\n  if (\n    process.env.NODE_ENV === 'test' ||\n    process.env.SQL_SYNC_MODELS === 'true'\n  ) {\n    sequelizeClient.sync().catch((error: unknown) => {\n      reportError(error);\n    });\n  }\n}\n\n/** Create Sequelize client */\nexport function createSequelizeClient(): Sequelize {\n  // Use in-memory SQLite for test environment to avoid real database connections\n  if (process.env.NODE_ENV === 'test') {\n    return new Sequelize({\n      dialect: 'sqlite',\n      storage: ':memory:',\n      logging: false\n    });\n  }\n\n  // File-based SQLite for local / offline dev (no SQL_HOST / live server)\n  const sqlType = (process.env.SQL_TYPE ?? '').toLowerCase();\n  if (sqlType === 'sqlite') {\n    const storage =\n      process.env.SQL_STORAGE && process.env.SQL_STORAGE.trim().length > 0\n        ? process.env.SQL_STORAGE.trim()\n        : path.join(process.cwd(), 'database.sqlite');\n    reportInfo({\n      message: 'Creating Sequelize client (SQLite file)',\n      data: { storage, dialect: 'sqlite' }\n    });\n    return new Sequelize({\n      dialect: 'sqlite',\n      storage,\n      logging: process.env.SQL_LOGGING === 'true' ? console.log : false\n    });\n  }\n\n  // Throw an error if there is no host initial\n  validateSequelizeEnvironment();\n\n  reportInfo({\n    message: 'Creating Sequelize client with config',\n    data: {\n      database: process.env.SQL_DB,\n      username: process.env.SQL_USER,\n      host: process.env.SQL_HOST,\n      port: dbConfig.port,\n      dialect: dbConfig.dialect,\n      isUnixSocket: process.env.SQL_HOST?.startsWith('/'),\n      poolMax: dbConfig.pool?.max,\n      poolMin: dbConfig.pool?.min\n    }\n  });\n\n  return new Sequelize(\n    process.env.SQL_DB as string,\n    process.env.SQL_USER as string,\n    process.env.SQL_PASSWORD as string,\n    dbConfig\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/entities/WebError/WebError.d.ts

@@ -8,6 +8,10 @@ export declare class WebError extends EngineError {
     errorCode: string;
     /** HTTP status code associated with this error */
     statusCode: number;
+    /** Public structured data sent to the client as `details` */
+    details?: unknown;
+    /** Seconds before the client may retry (Retry-After header) */
+    retryAfterSec?: number;
     /**
      * Create a WebError, these errors are best suited for runtime errors
      */

package/dist/entities/WebError/WebError.js

@@ -33,8 +33,14 @@ let WebError = exports.WebError = /*#__PURE__*/function (_EngineError) {
     (0, _defineProperty2.default)(_this, "errorCode", void 0);
     /** HTTP status code associated with this error */
     (0, _defineProperty2.default)(_this, "statusCode", void 0);
+    /** Public structured data sent to the client as `details` */
+    (0, _defineProperty2.default)(_this, "details", void 0);
+    /** Seconds before the client may retry (Retry-After header) */
+    (0, _defineProperty2.default)(_this, "retryAfterSec", void 0);
     _this.statusCode = config.statusCode ?? 400;
     _this.errorCode = config.errorCode;
+    if (config.details !== undefined) _this.details = config.details;
+    if (config.retryAfterSec !== undefined) _this.retryAfterSec = config.retryAfterSec;
     return _this;
   }
   (0, _inherits2.default)(WebError, _EngineError);

package/dist/entities/WebError/WebError.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebError.js","names":["_const","require","_EngineError2","_callSuper","t","o","e","_getPrototypeOf2","default","_possibleConstructorReturn2","_isNativeReflectConstruct","Reflect","construct","constructor","apply","Boolean","prototype","valueOf","call","WebError","exports","_EngineError","config","_this","_classCallCheck2","severity","LogSeverity","WARNING","_defineProperty2","statusCode","errorCode","_inherits2","_createClass2","EngineError"],"sources":["../../../src/entities/WebError/WebError.ts"],"sourcesContent":["import { WebErrorOptions } from './WebError.types';\nimport { LogSeverity } from 'const';\nimport { EngineError } from 'entities/EngineError';\n\n/**\n * Error class used when errors should be reported to the client\n */\nexport class WebError extends EngineError {\n  /** Machine readable error code that will be sent to the client */\n  public errorCode: string;\n  /** HTTP status code associated with this error */\n  public statusCode: number;\n\n  /**\n   * Create a WebError, these errors are best suited for runtime errors\n   */\n  public constructor(config: WebErrorOptions) {\n    super({ ...config, severity: config.severity ?? LogSeverity.WARNING });\n\n    this.statusCode = config.statusCode ?? 400;\n    this.errorCode = config.errorCode;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAAmD,SAAAE,WAAAC,CAAA,EAAAC,CAAA,EAAAC,CAAA,WAAAD,CAAA,OAAAE,gBAAA,CAAAC,OAAA,EAAAH,CAAA,OAAAI,2BAAA,CAAAD,OAAA,EAAAJ,CAAA,EAAAM,yBAAA,KAAAC,OAAA,CAAAC,SAAA,CAAAP,CAAA,EAAAC,CAAA,YAAAC,gBAAA,CAAAC,OAAA,EAAAJ,CAAA,EAAAS,WAAA,IAAAR,CAAA,CAAAS,KAAA,CAAAV,CAAA,EAAAE,CAAA;AAAA,SAAAI,0BAAA,cAAAN,CAAA,IAAAW,OAAA,CAAAC,SAAA,CAAAC,OAAA,CAAAC,IAAA,CAAAP,OAAA,CAAAC,SAAA,CAAAG,OAAA,iCAAAX,CAAA,aAAAM,yBAAA,YAAAA,CAAA,aAAAN,CAAA;AAEnD;AACA;AACA;AAFA,IAGae,QAAQ,GAAAC,OAAA,CAAAD,QAAA,0BAAAE,YAAA;EAMnB;AACF;AACA;EACE,SAAAF,SAAmBG,MAAuB,EAAE;IAAA,IAAAC,KAAA;IAAA,IAAAC,gBAAA,CAAAhB,OAAA,QAAAW,QAAA;IAC1CI,KAAA,GAAApB,UAAA,OAAAgB,QAAA,GAAM;MAAE,GAAGG,MAAM;MAAEG,QAAQ,EAAEH,MAAM,CAACG,QAAQ,IAAIC,kBAAW,CAACC;IAAQ,CAAC;IATvE;IAAA,IAAAC,gBAAA,CAAApB,OAAA,EAAAe,KAAA;IAEA;IAAA,IAAAK,gBAAA,CAAApB,OAAA,EAAAe,KAAA;IASEA,KAAA,CAAKM,UAAU,GAAGP,MAAM,CAACO,UAAU,IAAI,GAAG;IAC1CN,KAAA,CAAKO,SAAS,GAAGR,MAAM,CAACQ,SAAS;IAAC,OAAAP,KAAA;EACpC;EAAC,IAAAQ,UAAA,CAAAvB,OAAA,EAAAW,QAAA,EAAAE,YAAA;EAAA,WAAAW,aAAA,CAAAxB,OAAA,EAAAW,QAAA;AAAA,EAd2Bc,yBAAW","ignoreList":[]}
+{"version":3,"file":"WebError.js","names":["_const","require","_EngineError2","_callSuper","t","o","e","_getPrototypeOf2","default","_possibleConstructorReturn2","_isNativeReflectConstruct","Reflect","construct","constructor","apply","Boolean","prototype","valueOf","call","WebError","exports","_EngineError","config","_this","_classCallCheck2","severity","LogSeverity","WARNING","_defineProperty2","statusCode","errorCode","details","undefined","retryAfterSec","_inherits2","_createClass2","EngineError"],"sources":["../../../src/entities/WebError/WebError.ts"],"sourcesContent":["import { WebErrorOptions } from './WebError.types';\nimport { LogSeverity } from 'const';\nimport { EngineError } from 'entities/EngineError';\n\n/**\n * Error class used when errors should be reported to the client\n */\nexport class WebError extends EngineError {\n  /** Machine readable error code that will be sent to the client */\n  public errorCode: string;\n  /** HTTP status code associated with this error */\n  public statusCode: number;\n  /** Public structured data sent to the client as `details` */\n  public details?: unknown;\n  /** Seconds before the client may retry (Retry-After header) */\n  public retryAfterSec?: number;\n\n  /**\n   * Create a WebError, these errors are best suited for runtime errors\n   */\n  public constructor(config: WebErrorOptions) {\n    super({ ...config, severity: config.severity ?? LogSeverity.WARNING });\n\n    this.statusCode = config.statusCode ?? 400;\n    this.errorCode = config.errorCode;\n    if (config.details !== undefined) this.details = config.details;\n    if (config.retryAfterSec !== undefined)\n      this.retryAfterSec = config.retryAfterSec;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAAmD,SAAAE,WAAAC,CAAA,EAAAC,CAAA,EAAAC,CAAA,WAAAD,CAAA,OAAAE,gBAAA,CAAAC,OAAA,EAAAH,CAAA,OAAAI,2BAAA,CAAAD,OAAA,EAAAJ,CAAA,EAAAM,yBAAA,KAAAC,OAAA,CAAAC,SAAA,CAAAP,CAAA,EAAAC,CAAA,YAAAC,gBAAA,CAAAC,OAAA,EAAAJ,CAAA,EAAAS,WAAA,IAAAR,CAAA,CAAAS,KAAA,CAAAV,CAAA,EAAAE,CAAA;AAAA,SAAAI,0BAAA,cAAAN,CAAA,IAAAW,OAAA,CAAAC,SAAA,CAAAC,OAAA,CAAAC,IAAA,CAAAP,OAAA,CAAAC,SAAA,CAAAG,OAAA,iCAAAX,CAAA,aAAAM,yBAAA,YAAAA,CAAA,aAAAN,CAAA;AAEnD;AACA;AACA;AAFA,IAGae,QAAQ,GAAAC,OAAA,CAAAD,QAAA,0BAAAE,YAAA;EAUnB;AACF;AACA;EACE,SAAAF,SAAmBG,MAAuB,EAAE;IAAA,IAAAC,KAAA;IAAA,IAAAC,gBAAA,CAAAhB,OAAA,QAAAW,QAAA;IAC1CI,KAAA,GAAApB,UAAA,OAAAgB,QAAA,GAAM;MAAE,GAAGG,MAAM;MAAEG,QAAQ,EAAEH,MAAM,CAACG,QAAQ,IAAIC,kBAAW,CAACC;IAAQ,CAAC;IAbvE;IAAA,IAAAC,gBAAA,CAAApB,OAAA,EAAAe,KAAA;IAEA;IAAA,IAAAK,gBAAA,CAAApB,OAAA,EAAAe,KAAA;IAEA;IAAA,IAAAK,gBAAA,CAAApB,OAAA,EAAAe,KAAA;IAEA;IAAA,IAAAK,gBAAA,CAAApB,OAAA,EAAAe,KAAA;IASEA,KAAA,CAAKM,UAAU,GAAGP,MAAM,CAACO,UAAU,IAAI,GAAG;IAC1CN,KAAA,CAAKO,SAAS,GAAGR,MAAM,CAACQ,SAAS;IACjC,IAAIR,MAAM,CAACS,OAAO,KAAKC,SAAS,EAAET,KAAA,CAAKQ,OAAO,GAAGT,MAAM,CAACS,OAAO;IAC/D,IAAIT,MAAM,CAACW,aAAa,KAAKD,SAAS,EACpCT,KAAA,CAAKU,aAAa,GAAGX,MAAM,CAACW,aAAa;IAAC,OAAAV,KAAA;EAC9C;EAAC,IAAAW,UAAA,CAAA1B,OAAA,EAAAW,QAAA,EAAAE,YAAA;EAAA,WAAAc,aAAA,CAAA3B,OAAA,EAAAW,QAAA;AAAA,EArB2BiB,yBAAW","ignoreList":[]}

package/dist/entities/WebError/WebError.types.d.ts

@@ -5,4 +5,11 @@ export interface WebErrorOptions extends EngineErrorOptions {
     errorCode: string;
     /** HTTP status code associated with this error (default: 400) */
     statusCode?: number;
+    /**
+     * Structured data the client acts on (e.g. attempts left, per-field errors), sent in the response body as
+     * `details`. Unlike `data`, which is only logged, this is public: never put secrets or internals here.
+     */
+    details?: unknown;
+    /** Seconds the client should wait before retrying, sent as the Retry-After header (429, 503) */
+    retryAfterSec?: number;
 }

package/dist/entities/WebError/WebError.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebError.types.js","names":[],"sources":["../../../src/entities/WebError/WebError.types.ts"],"sourcesContent":["import { EngineErrorOptions } from 'entities/EngineError';\n\n/** Options to create a Web Error */\nexport interface WebErrorOptions extends EngineErrorOptions {\n  /** Machine readable error code that will be sent to the client */\n  errorCode: string;\n  /** HTTP status code associated with this error (default: 400) */\n  statusCode?: number;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"WebError.types.js","names":[],"sources":["../../../src/entities/WebError/WebError.types.ts"],"sourcesContent":["import { EngineErrorOptions } from 'entities/EngineError';\n\n/** Options to create a Web Error */\nexport interface WebErrorOptions extends EngineErrorOptions {\n  /** Machine readable error code that will be sent to the client */\n  errorCode: string;\n  /** HTTP status code associated with this error (default: 400) */\n  statusCode?: number;\n  /**\n   * Structured data the client acts on (e.g. attempts left, per-field errors), sent in the response body as\n   * `details`. Unlike `data`, which is only logged, this is public: never put secrets or internals here.\n   */\n  details?: unknown;\n  /** Seconds the client should wait before retrying, sent as the Retry-After header (429, 503) */\n  retryAfterSec?: number;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/middleware/error/error.js

@@ -10,9 +10,13 @@ var _report = require("../../utils/report");
 function error(error, request, response, _next) {
   (0, _report.reportError)(error, request);
   if (error instanceof _WebError.WebError) {
+    if (error.retryAfterSec !== undefined) response.set('Retry-After', String(Math.max(1, Math.round(error.retryAfterSec))));
     response.status(error.statusCode).json({
       errorCode: error.errorCode,
-      hint: error.hint
+      hint: error.hint,
+      ...(error.details !== undefined ? {
+        details: error.details
+      } : {})
     });
     return;
   }

package/dist/middleware/error/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","names":["_WebError","require","_report","error","request","response","_next","reportError","WebError","status","statusCode","json","errorCode","hint"],"sources":["../../../src/middleware/error/error.ts"],"sourcesContent":["import { Request, Response, NextFunction } from 'express';\nimport { WebError } from 'entities/WebError';\nimport { reportError } from 'utils/report';\n\n/** Handle errors globally */\nexport function error(\n  error: Error,\n  request: Request,\n  response: Response,\n  _next: NextFunction\n): void {\n  reportError(error, request);\n  if (error instanceof WebError) {\n    response.status(error.statusCode).json({\n      errorCode: error.errorCode,\n      hint: error.hint\n    });\n    return;\n  }\n  response.status(500).json({ errorCode: 'server-error' });\n}\n"],"mappings":";;;;;;AACA,IAAAA,SAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAEA;AACO,SAASE,KAAKA,CACnBA,KAAY,EACZC,OAAgB,EAChBC,QAAkB,EAClBC,KAAmB,EACb;EACN,IAAAC,mBAAW,EAACJ,KAAK,EAAEC,OAAO,CAAC;EAC3B,IAAID,KAAK,YAAYK,kBAAQ,EAAE;IAC7BH,QAAQ,CAACI,MAAM,CAACN,KAAK,CAACO,UAAU,CAAC,CAACC,IAAI,CAAC;MACrCC,SAAS,EAAET,KAAK,CAACS,SAAS;MAC1BC,IAAI,EAAEV,KAAK,CAACU;IACd,CAAC,CAAC;IACF;EACF;EACAR,QAAQ,CAACI,MAAM,CAAC,GAAG,CAAC,CAACE,IAAI,CAAC;IAAEC,SAAS,EAAE;EAAe,CAAC,CAAC;AAC1D","ignoreList":[]}
+{"version":3,"file":"error.js","names":["_WebError","require","_report","error","request","response","_next","reportError","WebError","retryAfterSec","undefined","set","String","Math","max","round","status","statusCode","json","errorCode","hint","details"],"sources":["../../../src/middleware/error/error.ts"],"sourcesContent":["import { Request, Response, NextFunction } from 'express';\nimport { WebError } from 'entities/WebError';\nimport { reportError } from 'utils/report';\n\n/** Handle errors globally */\nexport function error(\n  error: Error,\n  request: Request,\n  response: Response,\n  _next: NextFunction\n): void {\n  reportError(error, request);\n  if (error instanceof WebError) {\n    if (error.retryAfterSec !== undefined)\n      response.set(\n        'Retry-After',\n        String(Math.max(1, Math.round(error.retryAfterSec)))\n      );\n    response.status(error.statusCode).json({\n      errorCode: error.errorCode,\n      hint: error.hint,\n      ...(error.details !== undefined ? { details: error.details } : {})\n    });\n    return;\n  }\n  response.status(500).json({ errorCode: 'server-error' });\n}\n"],"mappings":";;;;;;AACA,IAAAA,SAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAEA;AACO,SAASE,KAAKA,CACnBA,KAAY,EACZC,OAAgB,EAChBC,QAAkB,EAClBC,KAAmB,EACb;EACN,IAAAC,mBAAW,EAACJ,KAAK,EAAEC,OAAO,CAAC;EAC3B,IAAID,KAAK,YAAYK,kBAAQ,EAAE;IAC7B,IAAIL,KAAK,CAACM,aAAa,KAAKC,SAAS,EACnCL,QAAQ,CAACM,GAAG,CACV,aAAa,EACbC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,KAAK,CAACZ,KAAK,CAACM,aAAa,CAAC,CAAC,CACrD,CAAC;IACHJ,QAAQ,CAACW,MAAM,CAACb,KAAK,CAACc,UAAU,CAAC,CAACC,IAAI,CAAC;MACrCC,SAAS,EAAEhB,KAAK,CAACgB,SAAS;MAC1BC,IAAI,EAAEjB,KAAK,CAACiB,IAAI;MAChB,IAAIjB,KAAK,CAACkB,OAAO,KAAKX,SAAS,GAAG;QAAEW,OAAO,EAAElB,KAAK,CAACkB;MAAQ,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC,CAAC;IACF;EACF;EACAhB,QAAQ,CAACW,MAAM,CAAC,GAAG,CAAC,CAACE,IAAI,CAAC;IAAEC,SAAS,EAAE;EAAe,CAAC,CAAC;AAC1D","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-server-engine",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Framework used to develop backend services. This package ships with a lot of features to standardize the creation of services, letting you focus on the business logic.",
   "main": "dist/index.js",
   "scripts": {