@flusys/nestjs-shared 5.4.0 → 5.5.0

package/cjs/classes/api-service.class.js

@@ -69,7 +69,7 @@ let ApiService = class ApiService {
             await this.beforeInsertOperation(dto, user, qr);
             const entities = await this.convertRequestDtoToEntity(dto, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterInsertOperation(this.ensureArray(saved), user, qr);
+            await this.afterInsertOperation(this.ensureArray(saved), dto, user, qr);
             return {
                 saved,
                 returnFirst: true
@@ -81,7 +81,7 @@ let ApiService = class ApiService {
             await this.beforeInsertOperation(dtos, user, qr);
             const entities = await this.convertRequestDtoToEntity(dtos, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterInsertOperation(this.ensureArray(saved), user, qr);
+            await this.afterInsertOperation(this.ensureArray(saved), dtos, user, qr);
             return {
                 saved,
                 returnFirst: false
@@ -93,7 +93,7 @@ let ApiService = class ApiService {
             await this.beforeUpdateOperation(dto, user, qr);
             const entities = await this.convertRequestDtoToEntity(dto, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterUpdateOperation(this.ensureArray(saved), user, qr);
+            await this.afterUpdateOperation(this.ensureArray(saved), dto, user, qr);
             return {
                 saved,
                 returnFirst: true
@@ -105,7 +105,7 @@ let ApiService = class ApiService {
             await this.beforeUpdateOperation(dtos, user, qr);
             const entities = await this.convertRequestDtoToEntity(dtos, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterUpdateOperation(this.ensureArray(saved), user, qr);
+            await this.afterUpdateOperation(this.ensureArray(saved), dtos, user, qr);
             return {
                 saved,
                 returnFirst: false
@@ -119,14 +119,14 @@ let ApiService = class ApiService {
                 await this.beforeInsertOperation(toInsert, user, qr);
                 const insertedEntities = await this.convertRequestDtoToEntity(toInsert, user);
                 const insertedSaved = await qr.manager.save(this.repository.target, insertedEntities);
-                await this.afterInsertOperation(this.ensureArray(insertedSaved), user, qr);
+                await this.afterInsertOperation(this.ensureArray(insertedSaved), toInsert, user, qr);
                 allResults.push(...this.ensureArray(insertedSaved));
             }
             if (toUpdate.length > 0) {
                 await this.beforeUpdateOperation(toUpdate, user, qr);
                 const updatedEntities = await this.convertRequestDtoToEntity(toUpdate, user);
                 const updatedSaved = await qr.manager.save(this.repository.target, updatedEntities);
-                await this.afterUpdateOperation(this.ensureArray(updatedSaved), user, qr);
+                await this.afterUpdateOperation(this.ensureArray(updatedSaved), toUpdate, user, qr);
                 allResults.push(...this.ensureArray(updatedSaved));
             }
             return {
@@ -329,7 +329,7 @@ let ApiService = class ApiService {
                     id
                 };
             });
-            await this.afterDeleteOperation(ids, user, queryRunner);
+            await this.afterDeleteOperation(ids, option, user, queryRunner);
             await queryRunner.commitTransaction();
             await Promise.all([
                 this.clearCacheForAll(),
@@ -390,11 +390,11 @@ let ApiService = class ApiService {
         }
     }
     async beforeInsertOperation(_dto, _user, _queryRunner) {}
-    async afterInsertOperation(_entity, _user, _queryRunner) {}
+    async afterInsertOperation(_entity, _dto, _user, _queryRunner) {}
     async beforeUpdateOperation(_dto, _user, _queryRunner) {}
-    async afterUpdateOperation(_entity, _user, _queryRunner) {}
+    async afterUpdateOperation(_entity, _dto, _user, _queryRunner) {}
     async beforeDeleteOperation(_dto, _user, _queryRunner) {}
-    async afterDeleteOperation(_entity, _user, _queryRunner) {}
+    async afterDeleteOperation(_entity, _dto, _user, _queryRunner) {}
     async getFilterQuery(query, filter, _user) {
         Object.entries(filter).forEach(([key, value])=>{
             query.andWhere(`${this.entityName}.${key} = :value`, {

package/cjs/classes/{handle-custome-db-column-type.js → handle-custome-db.js}

@@ -9,6 +9,9 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get buildQuery () {
+        return buildQuery;
+    },
     get getCastIntType () {
         return getCastIntType;
     },
@@ -27,3 +30,8 @@ function getCastIntType() {
     const driver = _nestjscore.envConfig.getTypeOrmConfig().type;
     return driver === 'postgres' ? 'INTEGER' : 'UNSIGNED';
 }
+function buildQuery(sql, dbType) {
+    if (dbType !== 'postgres') return sql;
+    let index = 0;
+    return sql.replace(/\?/g, ()=>`$${++index}`);
+}

package/cjs/classes/index.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 _export_star(require("./api-controller.class"), exports);
 _export_star(require("./api-service.class"), exports);
-_export_star(require("./handle-custome-db-column-type"), exports);
+_export_star(require("./handle-custome-db"), exports);
 _export_star(require("./hybrid-cache.class"), exports);
 _export_star(require("./winston.logger.class"), exports);
 _export_star(require("../constants/permissions"), exports);

package/cjs/constants/message-keys.js

@@ -35,6 +35,10 @@ const ERROR_MESSAGES = {
     CONFLICT: 'error.conflict',
     DB_FOREIGN_KEY: 'error.db.foreign.key',
     DB_NOT_NULL: 'error.db.not.null',
+    DB_INVALID_INPUT: 'error.db.invalid.input',
+    DB_VALUE_TOO_LONG: 'error.db.value.too.long',
+    DB_CHECK_CONSTRAINT: 'error.db.check.constraint',
+    DB_DEADLOCK: 'error.db.deadlock',
     INTERNAL: 'error.internal',
     SERVICE_UNAVAILABLE: 'error.service.unavailable',
     UNKNOWN: 'error.unknown',

package/cjs/filters/global-exception.filter.js

@@ -163,15 +163,27 @@ let GlobalExceptionFilter = class GlobalExceptionFilter {
         const dbError = exception;
         const code = dbError.driverError?.code ?? dbError.code;
         const number = dbError.driverError?.number ?? dbError.number;
+        const errno = dbError.driverError?.errno ?? dbError.errno;
+        const sqlMessage = dbError.driverError?.sqlMessage ?? '';
         const detail = dbError.driverError?.detail ?? dbError.detail ?? '';
-        const table = dbError.driverError?.table ?? dbError.table ?? 'record';
+        const table = dbError.driverError?.table ?? dbError.table ?? '';
         const column = dbError.driverError?.column ?? dbError.column;
-        const field = detail.match(/Key \(([^)]+)\)/)?.[1] ?? column;
-        if (code === '23505' || number === 2627) {
-            return new _baseappexception.ConflictException(this.toHumanReadable(table), field ? this.toHumanReadable(field) : undefined);
+        const pgField = detail.match(/Key \(([^)]+)\)/)?.[1] ?? column;
+        // DUPLICATE / UNIQUE VIOLATION
+        // PG: 23505 | MSSQL: 2627 (constraint), 2601 (index) | MySQL: ER_DUP_ENTRY / errno 1062
+        if (code === '23505' || number === 2627 || number === 2601 || code === 'ER_DUP_ENTRY' || errno === 1062) {
+            const mysqlTable = sqlMessage.match(/for key '([^'.]+)\./)?.[1];
+            const mysqlIndex = sqlMessage.match(/for key '(?:[^.]+\.)?([^']+)'/)?.[1];
+            const resolvedTable = table || mysqlTable || 'record';
+            const resolvedField = pgField ? this.toHumanReadable(pgField) : mysqlIndex ? this.toHumanReadable(mysqlIndex) : undefined;
+            return new _baseappexception.ConflictException(this.toHumanReadable(resolvedTable), resolvedField);
         }
-        if (code === '23503' || number === 547) {
-            const humanField = field ? this.toHumanReadable(field) : undefined;
+        // FOREIGN KEY VIOLATION
+        // PG: 23503 | MSSQL: 547 | MySQL: ER_NO_REFERENCED_ROW_2/1452 (insert), ER_ROW_IS_REFERENCED_2/1451 (delete)
+        if (code === '23503' || number === 547 || code === 'ER_NO_REFERENCED_ROW_2' || code === 'ER_ROW_IS_REFERENCED_2' || errno === 1452 || errno === 1451) {
+            const mysqlColumn = sqlMessage.match(/FOREIGN KEY \(`([^`]+)`\)/)?.[1];
+            const raw = pgField ?? mysqlColumn;
+            const humanField = raw ? this.toHumanReadable(raw) : undefined;
             return new _baseappexception.BaseAppException({
                 message: humanField ? `Invalid reference for '${humanField}'` : 'Invalid reference',
                 messageKey: _messagekeys.ERROR_MESSAGES.DB_FOREIGN_KEY,
@@ -181,8 +193,11 @@ let GlobalExceptionFilter = class GlobalExceptionFilter {
                 status: _common.HttpStatus.BAD_REQUEST
             });
         }
-        if (code === '23502' || number === 515) {
-            const humanField = this.toHumanReadable(column ?? 'field');
+        // NOT NULL VIOLATION
+        // PG: 23502 | MSSQL: 515 | MySQL: ER_BAD_NULL_ERROR / errno 1048
+        if (code === '23502' || number === 515 || code === 'ER_BAD_NULL_ERROR' || errno === 1048) {
+            const mysqlColumn = sqlMessage.match(/Column '([^']+)' cannot be null/)?.[1];
+            const humanField = this.toHumanReadable(column ?? mysqlColumn ?? 'field');
             return new _baseappexception.BaseAppException({
                 message: `Required field '${humanField}' cannot be null`,
                 messageKey: _messagekeys.ERROR_MESSAGES.DB_NOT_NULL,
@@ -192,6 +207,64 @@ let GlobalExceptionFilter = class GlobalExceptionFilter {
                 status: _common.HttpStatus.BAD_REQUEST
             });
         }
+        // INVALID INPUT SYNTAX — PostgreSQL only (MySQL silently coerces types)
+        if (code === '22P02') {
+            const typeMatch = exception.message.match(/invalid input syntax for(?:\s+type)?\s+(\w+)/i);
+            const type = typeMatch?.[1] ?? 'value';
+            const humanField = column ? this.toHumanReadable(column) : undefined;
+            return new _baseappexception.BaseAppException({
+                message: humanField ? `Invalid ${type} value for '${humanField}'` : `Invalid ${type} value`,
+                messageKey: _messagekeys.ERROR_MESSAGES.DB_INVALID_INPUT,
+                messageVariables: {
+                    type,
+                    ...humanField !== undefined && {
+                        field: humanField
+                    }
+                },
+                status: _common.HttpStatus.BAD_REQUEST
+            });
+        }
+        // VALUE TOO LONG
+        // PG: 22001 | MySQL: ER_DATA_TOO_LONG / errno 1406
+        if (code === '22001' || code === 'ER_DATA_TOO_LONG' || errno === 1406) {
+            const mysqlColumn = sqlMessage.match(/Data too long for column '([^']+)'/)?.[1];
+            const resolvedColumn = column ?? mysqlColumn;
+            const humanField = resolvedColumn ? this.toHumanReadable(resolvedColumn) : undefined;
+            return new _baseappexception.BaseAppException({
+                message: humanField ? `Value too long for '${humanField}'` : 'Value exceeds maximum length',
+                messageKey: _messagekeys.ERROR_MESSAGES.DB_VALUE_TOO_LONG,
+                messageVariables: humanField !== undefined ? {
+                    field: humanField
+                } : undefined,
+                status: _common.HttpStatus.BAD_REQUEST
+            });
+        }
+        // CHECK CONSTRAINT VIOLATION
+        // PG: 23514 | MySQL 8.0+: ER_CHECK_CONSTRAINT_VIOLATED / errno 3819
+        if (code === '23514' || code === 'ER_CHECK_CONSTRAINT_VIOLATED' || errno === 3819) {
+            const constraint = dbError.driverError?.constraint ?? dbError.constraint;
+            const humanTable = this.toHumanReadable(table || 'record');
+            return new _baseappexception.BaseAppException({
+                message: `${humanTable} violates a validation rule`,
+                messageKey: _messagekeys.ERROR_MESSAGES.DB_CHECK_CONSTRAINT,
+                messageVariables: {
+                    entity: humanTable,
+                    ...constraint !== undefined && {
+                        constraint
+                    }
+                },
+                status: _common.HttpStatus.BAD_REQUEST
+            });
+        }
+        // DEADLOCK
+        // PG: 40P01 | MSSQL: 1205 | MySQL: ER_LOCK_DEADLOCK / errno 1213
+        if (code === '40P01' || number === 1205 || code === 'ER_LOCK_DEADLOCK' || errno === 1213) {
+            return new _baseappexception.BaseAppException({
+                message: 'The request could not be completed due to a conflict, please try again',
+                messageKey: _messagekeys.ERROR_MESSAGES.DB_DEADLOCK,
+                status: _common.HttpStatus.SERVICE_UNAVAILABLE
+            });
+        }
         return null;
     }
     toHumanReadable(dbName) {

package/classes/api-service.class.d.ts

@@ -41,13 +41,13 @@ export declare abstract class ApiService<CreateDtoT extends object, UpdateDtoT e
     private ensureArray;
     private executeInTransaction;
     protected beforeInsertOperation(_dto: CreateDtoT | Array<CreateDtoT>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
-    protected afterInsertOperation(_entity: EntityT[], _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
+    protected afterInsertOperation(_entity: EntityT[], _dto: CreateDtoT | Array<CreateDtoT>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
     protected beforeUpdateOperation(_dto: UpdateDtoT | Array<UpdateDtoT>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
-    protected afterUpdateOperation(_entity: EntityT[], _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
+    protected afterUpdateOperation(_entity: EntityT[], _dto: UpdateDtoT | Array<UpdateDtoT>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
     protected beforeDeleteOperation(_dto: DeleteDto, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
     protected afterDeleteOperation(_entity: Array<{
         id: string;
-    }>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
+    }>, _dto: DeleteDto, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
     protected getFilterQuery(query: SelectQueryBuilder<EntityT>, filter: Record<string, unknown>, _user: ILoggedUserInfo | null): Promise<{
         query: SelectQueryBuilder<EntityT>;
         isRaw: boolean;

package/classes/{handle-custome-db-column-type.d.ts → handle-custome-db.d.ts}

@@ -1,2 +1,3 @@
 export declare function getJsonColumnType(): "simple-json" | "json" | "jsonb";
 export declare function getCastIntType(): string;
+export declare function buildQuery(sql: string, dbType: string): string;

package/classes/index.d.ts

@@ -1,6 +1,6 @@
 export * from './api-controller.class';
 export * from './api-service.class';
-export * from './handle-custome-db-column-type';
+export * from './handle-custome-db';
 export * from './hybrid-cache.class';
 export * from './winston.logger.class';
 export * from '../constants/permissions';

package/constants/message-keys.d.ts

@@ -12,6 +12,10 @@ export declare const ERROR_MESSAGES: {
     readonly CONFLICT: "error.conflict";
     readonly DB_FOREIGN_KEY: "error.db.foreign.key";
     readonly DB_NOT_NULL: "error.db.not.null";
+    readonly DB_INVALID_INPUT: "error.db.invalid.input";
+    readonly DB_VALUE_TOO_LONG: "error.db.value.too.long";
+    readonly DB_CHECK_CONSTRAINT: "error.db.check.constraint";
+    readonly DB_DEADLOCK: "error.db.deadlock";
     readonly INTERNAL: "error.internal";
     readonly SERVICE_UNAVAILABLE: "error.service.unavailable";
     readonly UNKNOWN: "error.unknown";

package/fesm/classes/api-service.class.js

@@ -59,7 +59,7 @@ export class ApiService {
             await this.beforeInsertOperation(dto, user, qr);
             const entities = await this.convertRequestDtoToEntity(dto, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterInsertOperation(this.ensureArray(saved), user, qr);
+            await this.afterInsertOperation(this.ensureArray(saved), dto, user, qr);
             return {
                 saved,
                 returnFirst: true
@@ -71,7 +71,7 @@ export class ApiService {
             await this.beforeInsertOperation(dtos, user, qr);
             const entities = await this.convertRequestDtoToEntity(dtos, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterInsertOperation(this.ensureArray(saved), user, qr);
+            await this.afterInsertOperation(this.ensureArray(saved), dtos, user, qr);
             return {
                 saved,
                 returnFirst: false
@@ -83,7 +83,7 @@ export class ApiService {
             await this.beforeUpdateOperation(dto, user, qr);
             const entities = await this.convertRequestDtoToEntity(dto, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterUpdateOperation(this.ensureArray(saved), user, qr);
+            await this.afterUpdateOperation(this.ensureArray(saved), dto, user, qr);
             return {
                 saved,
                 returnFirst: true
@@ -95,7 +95,7 @@ export class ApiService {
             await this.beforeUpdateOperation(dtos, user, qr);
             const entities = await this.convertRequestDtoToEntity(dtos, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterUpdateOperation(this.ensureArray(saved), user, qr);
+            await this.afterUpdateOperation(this.ensureArray(saved), dtos, user, qr);
             return {
                 saved,
                 returnFirst: false
@@ -109,14 +109,14 @@ export class ApiService {
                 await this.beforeInsertOperation(toInsert, user, qr);
                 const insertedEntities = await this.convertRequestDtoToEntity(toInsert, user);
                 const insertedSaved = await qr.manager.save(this.repository.target, insertedEntities);
-                await this.afterInsertOperation(this.ensureArray(insertedSaved), user, qr);
+                await this.afterInsertOperation(this.ensureArray(insertedSaved), toInsert, user, qr);
                 allResults.push(...this.ensureArray(insertedSaved));
             }
             if (toUpdate.length > 0) {
                 await this.beforeUpdateOperation(toUpdate, user, qr);
                 const updatedEntities = await this.convertRequestDtoToEntity(toUpdate, user);
                 const updatedSaved = await qr.manager.save(this.repository.target, updatedEntities);
-                await this.afterUpdateOperation(this.ensureArray(updatedSaved), user, qr);
+                await this.afterUpdateOperation(this.ensureArray(updatedSaved), toUpdate, user, qr);
                 allResults.push(...this.ensureArray(updatedSaved));
             }
             return {
@@ -319,7 +319,7 @@ export class ApiService {
                     id
                 };
             });
-            await this.afterDeleteOperation(ids, user, queryRunner);
+            await this.afterDeleteOperation(ids, option, user, queryRunner);
             await queryRunner.commitTransaction();
             await Promise.all([
                 this.clearCacheForAll(),
@@ -380,11 +380,11 @@ export class ApiService {
         }
     }
     async beforeInsertOperation(_dto, _user, _queryRunner) {}
-    async afterInsertOperation(_entity, _user, _queryRunner) {}
+    async afterInsertOperation(_entity, _dto, _user, _queryRunner) {}
     async beforeUpdateOperation(_dto, _user, _queryRunner) {}
-    async afterUpdateOperation(_entity, _user, _queryRunner) {}
+    async afterUpdateOperation(_entity, _dto, _user, _queryRunner) {}
     async beforeDeleteOperation(_dto, _user, _queryRunner) {}
-    async afterDeleteOperation(_entity, _user, _queryRunner) {}
+    async afterDeleteOperation(_entity, _dto, _user, _queryRunner) {}
     async getFilterQuery(query, filter, _user) {
         Object.entries(filter).forEach(([key, value])=>{
             query.andWhere(`${this.entityName}.${key} = :value`, {

package/fesm/classes/{handle-custome-db-column-type.js → handle-custome-db.js}

@@ -9,3 +9,11 @@ export function getCastIntType() {
     const driver = envConfig.getTypeOrmConfig().type;
     return driver === 'postgres' ? 'INTEGER' : 'UNSIGNED';
 }
+/**
+ * Converts MySQL-style `?` placeholders to PostgreSQL `$1, $2, ...` placeholders.
+ * No-op for MySQL/MariaDB.
+ */ export function buildQuery(sql, dbType) {
+    if (dbType !== 'postgres') return sql;
+    let index = 0;
+    return sql.replace(/\?/g, ()=>`$${++index}`);
+}

package/fesm/classes/index.js

@@ -1,6 +1,6 @@
 export * from './api-controller.class';
 export * from './api-service.class';
-export * from './handle-custome-db-column-type';
+export * from './handle-custome-db';
 export * from './hybrid-cache.class';
 export * from './winston.logger.class';
 // Re-export permission constants for convenience

package/fesm/constants/message-keys.js

@@ -15,6 +15,10 @@ export const ERROR_MESSAGES = {
     CONFLICT: 'error.conflict',
     DB_FOREIGN_KEY: 'error.db.foreign.key',
     DB_NOT_NULL: 'error.db.not.null',
+    DB_INVALID_INPUT: 'error.db.invalid.input',
+    DB_VALUE_TOO_LONG: 'error.db.value.too.long',
+    DB_CHECK_CONSTRAINT: 'error.db.check.constraint',
+    DB_DEADLOCK: 'error.db.deadlock',
     INTERNAL: 'error.internal',
     SERVICE_UNAVAILABLE: 'error.service.unavailable',
     UNKNOWN: 'error.unknown',

package/fesm/filters/global-exception.filter.js

@@ -153,15 +153,27 @@ export class GlobalExceptionFilter {
         const dbError = exception;
         const code = dbError.driverError?.code ?? dbError.code;
         const number = dbError.driverError?.number ?? dbError.number;
+        const errno = dbError.driverError?.errno ?? dbError.errno;
+        const sqlMessage = dbError.driverError?.sqlMessage ?? '';
         const detail = dbError.driverError?.detail ?? dbError.detail ?? '';
-        const table = dbError.driverError?.table ?? dbError.table ?? 'record';
+        const table = dbError.driverError?.table ?? dbError.table ?? '';
         const column = dbError.driverError?.column ?? dbError.column;
-        const field = detail.match(/Key \(([^)]+)\)/)?.[1] ?? column;
-        if (code === '23505' || number === 2627) {
-            return new ConflictException(this.toHumanReadable(table), field ? this.toHumanReadable(field) : undefined);
+        const pgField = detail.match(/Key \(([^)]+)\)/)?.[1] ?? column;
+        // DUPLICATE / UNIQUE VIOLATION
+        // PG: 23505 | MSSQL: 2627 (constraint), 2601 (index) | MySQL: ER_DUP_ENTRY / errno 1062
+        if (code === '23505' || number === 2627 || number === 2601 || code === 'ER_DUP_ENTRY' || errno === 1062) {
+            const mysqlTable = sqlMessage.match(/for key '([^'.]+)\./)?.[1];
+            const mysqlIndex = sqlMessage.match(/for key '(?:[^.]+\.)?([^']+)'/)?.[1];
+            const resolvedTable = table || mysqlTable || 'record';
+            const resolvedField = pgField ? this.toHumanReadable(pgField) : mysqlIndex ? this.toHumanReadable(mysqlIndex) : undefined;
+            return new ConflictException(this.toHumanReadable(resolvedTable), resolvedField);
         }
-        if (code === '23503' || number === 547) {
-            const humanField = field ? this.toHumanReadable(field) : undefined;
+        // FOREIGN KEY VIOLATION
+        // PG: 23503 | MSSQL: 547 | MySQL: ER_NO_REFERENCED_ROW_2/1452 (insert), ER_ROW_IS_REFERENCED_2/1451 (delete)
+        if (code === '23503' || number === 547 || code === 'ER_NO_REFERENCED_ROW_2' || code === 'ER_ROW_IS_REFERENCED_2' || errno === 1452 || errno === 1451) {
+            const mysqlColumn = sqlMessage.match(/FOREIGN KEY \(`([^`]+)`\)/)?.[1];
+            const raw = pgField ?? mysqlColumn;
+            const humanField = raw ? this.toHumanReadable(raw) : undefined;
             return new BaseAppException({
                 message: humanField ? `Invalid reference for '${humanField}'` : 'Invalid reference',
                 messageKey: ERROR_MESSAGES.DB_FOREIGN_KEY,
@@ -171,8 +183,11 @@ export class GlobalExceptionFilter {
                 status: HttpStatus.BAD_REQUEST
             });
         }
-        if (code === '23502' || number === 515) {
-            const humanField = this.toHumanReadable(column ?? 'field');
+        // NOT NULL VIOLATION
+        // PG: 23502 | MSSQL: 515 | MySQL: ER_BAD_NULL_ERROR / errno 1048
+        if (code === '23502' || number === 515 || code === 'ER_BAD_NULL_ERROR' || errno === 1048) {
+            const mysqlColumn = sqlMessage.match(/Column '([^']+)' cannot be null/)?.[1];
+            const humanField = this.toHumanReadable(column ?? mysqlColumn ?? 'field');
             return new BaseAppException({
                 message: `Required field '${humanField}' cannot be null`,
                 messageKey: ERROR_MESSAGES.DB_NOT_NULL,
@@ -182,6 +197,64 @@ export class GlobalExceptionFilter {
                 status: HttpStatus.BAD_REQUEST
             });
         }
+        // INVALID INPUT SYNTAX — PostgreSQL only (MySQL silently coerces types)
+        if (code === '22P02') {
+            const typeMatch = exception.message.match(/invalid input syntax for(?:\s+type)?\s+(\w+)/i);
+            const type = typeMatch?.[1] ?? 'value';
+            const humanField = column ? this.toHumanReadable(column) : undefined;
+            return new BaseAppException({
+                message: humanField ? `Invalid ${type} value for '${humanField}'` : `Invalid ${type} value`,
+                messageKey: ERROR_MESSAGES.DB_INVALID_INPUT,
+                messageVariables: {
+                    type,
+                    ...humanField !== undefined && {
+                        field: humanField
+                    }
+                },
+                status: HttpStatus.BAD_REQUEST
+            });
+        }
+        // VALUE TOO LONG
+        // PG: 22001 | MySQL: ER_DATA_TOO_LONG / errno 1406
+        if (code === '22001' || code === 'ER_DATA_TOO_LONG' || errno === 1406) {
+            const mysqlColumn = sqlMessage.match(/Data too long for column '([^']+)'/)?.[1];
+            const resolvedColumn = column ?? mysqlColumn;
+            const humanField = resolvedColumn ? this.toHumanReadable(resolvedColumn) : undefined;
+            return new BaseAppException({
+                message: humanField ? `Value too long for '${humanField}'` : 'Value exceeds maximum length',
+                messageKey: ERROR_MESSAGES.DB_VALUE_TOO_LONG,
+                messageVariables: humanField !== undefined ? {
+                    field: humanField
+                } : undefined,
+                status: HttpStatus.BAD_REQUEST
+            });
+        }
+        // CHECK CONSTRAINT VIOLATION
+        // PG: 23514 | MySQL 8.0+: ER_CHECK_CONSTRAINT_VIOLATED / errno 3819
+        if (code === '23514' || code === 'ER_CHECK_CONSTRAINT_VIOLATED' || errno === 3819) {
+            const constraint = dbError.driverError?.constraint ?? dbError.constraint;
+            const humanTable = this.toHumanReadable(table || 'record');
+            return new BaseAppException({
+                message: `${humanTable} violates a validation rule`,
+                messageKey: ERROR_MESSAGES.DB_CHECK_CONSTRAINT,
+                messageVariables: {
+                    entity: humanTable,
+                    ...constraint !== undefined && {
+                        constraint
+                    }
+                },
+                status: HttpStatus.BAD_REQUEST
+            });
+        }
+        // DEADLOCK
+        // PG: 40P01 | MSSQL: 1205 | MySQL: ER_LOCK_DEADLOCK / errno 1213
+        if (code === '40P01' || number === 1205 || code === 'ER_LOCK_DEADLOCK' || errno === 1213) {
+            return new BaseAppException({
+                message: 'The request could not be completed due to a conflict, please try again',
+                messageKey: ERROR_MESSAGES.DB_DEADLOCK,
+                status: HttpStatus.SERVICE_UNAVAILABLE
+            });
+        }
         return null;
     }
     toHumanReadable(dbName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-shared",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "description": "Common shared utilities for Flusys NestJS applications",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -103,15 +103,15 @@
     "@nestjs/typeorm": "^11.0.0",
     "cacheable": "^2.1.0",
     "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.0 || ^0.15.0",
+    "class-validator": "^0.15.0",
     "keyv": "^5.0.0",
     "typeorm": "^0.3.0",
     "winston": "^3.0.0",
     "winston-daily-rotate-file": "^5.0.0",
-    "express": "^4.18.0 || ^5.0.0",
+    "express": "^5.0.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "5.4.0"
+    "@flusys/nestjs-core": "5.5.0"
   }
 }