@plyaz/types 1.14.5 → 1.14.7

package/dist/errors/index.js

@@ -444,7 +444,85 @@ var ERROR_CODES = {
   // ===== Errors Package Errors =====
   ERROR_SYSTEM_NOT_INITIALIZED: "error.system.not.initialized",
   EVENT_FACTORY_NOT_REGISTERED: "error.event.factory.not.registered",
-  DATABASE_ERROR: "error.database"
+  DATABASE_ERROR: "error.database",
+  // ===== Database Errors =====
+  // Connection & Configuration
+  DB_ACCESS_DENIED: "DB_ACCESS_DENIED",
+  DB_CONFIG_REQUIRED: "DB_CONFIG_REQUIRED",
+  DB_CONNECT_FAILED: "DB_CONNECT_FAILED",
+  DB_DISCONNECT_FAILED: "DB_DISCONNECT_FAILED",
+  DB_INIT_FAILED: "DB_INIT_FAILED",
+  // Query & Execution
+  DB_QUERY_FAILED: "DB_QUERY_FAILED",
+  DB_BUILD_WHERE_FAILED: "DB_BUILD_WHERE_FAILED",
+  DB_INVALID_SQL: "DB_INVALID_SQL",
+  DB_TRANSACTION_FAILED: "DB_TRANSACTION_FAILED",
+  DB_UNSUPPORTED_OPERATOR: "DB_UNSUPPORTED_OPERATOR",
+  // CRUD Operations
+  DB_CREATE_FAILED: "DB_CREATE_FAILED",
+  DB_CREATION_FAILED: "DB_CREATION_FAILED",
+  DB_FETCH_FAILED: "DB_FETCH_FAILED",
+  DB_FIND_FAILED: "DB_FIND_FAILED",
+  DB_FIND_MANY_FAILED: "DB_FIND_MANY_FAILED",
+  DB_FIND_BY_ID_FAILED: "DB_FIND_BY_ID_FAILED",
+  DB_UPDATE_FAILED: "DB_UPDATE_FAILED",
+  DB_UPDATE_NO_CHANGES: "DB_UPDATE_NO_CHANGES",
+  DB_DELETE_FAILED: "DB_DELETE_FAILED",
+  DB_INSERT_FAILED: "DB_INSERT_FAILED",
+  DB_RECORD_NOT_FOUND: "DB_RECORD_NOT_FOUND",
+  DB_EXISTS_FAILED: "DB_EXISTS_FAILED",
+  // Schema & Columns
+  DB_COLUMN_NOT_EXISTS: "DB_COLUMN_NOT_EXISTS",
+  DB_TABLE_NOT_REGISTERED: "DB_TABLE_NOT_REGISTERED",
+  DB_TABLE_REGISTRATION_FAILED: "DB_TABLE_REGISTRATION_FAILED",
+  DB_ID_COLUMN_NOT_REGISTERED: "DB_ID_COLUMN_NOT_REGISTERED",
+  DB_INVALID_COLUMN: "DB_INVALID_COLUMN",
+  DB_INVALID_TABLE_NAME: "DB_INVALID_TABLE_NAME",
+  DB_GET_ID_COLUMN_FAILED: "DB_GET_ID_COLUMN_FAILED",
+  DB_GET_TABLE_FAILED: "DB_GET_TABLE_FAILED",
+  // Validation & Parameters
+  DB_INVALID_PARAMETERS: "DB_INVALID_PARAMETERS",
+  DB_INVALID_PARAMS: "DB_INVALID_PARAMS",
+  DB_INVALID_FILTER: "DB_INVALID_FILTER",
+  DB_INVALID_ID: "DB_INVALID_ID",
+  DB_INVALID_ENTITY: "DB_INVALID_ENTITY",
+  DB_INVALID_UPDATE_PARAMS: "DB_INVALID_UPDATE_PARAMS",
+  DB_INVALID_FIELD_NAME: "DB_INVALID_FIELD_NAME",
+  DB_INVALID_RESULT: "DB_INVALID_RESULT",
+  DB_NO_UPDATE_FIELDS: "DB_NO_UPDATE_FIELDS",
+  // Count & Data
+  DB_COUNT_FAILED: "DB_COUNT_FAILED",
+  DB_COUNT_NO_RESULTS: "DB_COUNT_NO_RESULTS",
+  DB_NO_DATA: "DB_NO_DATA",
+  // Multi-tenant Context
+  DB_NO_TENANT_CONTEXT: "DB_NO_TENANT_CONTEXT",
+  DB_NO_TENANT_ID: "DB_NO_TENANT_ID",
+  DB_TENANT_VALIDATION_FAILED: "DB_TENANT_VALIDATION_FAILED",
+  // Backup & Restore
+  DB_BACKUP_CLEANUP_FAILED: "DB_BACKUP_CLEANUP_FAILED",
+  DB_BACKUP_FILE_NOT_FOUND: "DB_BACKUP_FILE_NOT_FOUND",
+  DB_LIST_BACKUPS_FAILED: "DB_LIST_BACKUPS_FAILED",
+  DB_INVALID_BACKUP_INFO: "DB_INVALID_BACKUP_INFO",
+  DB_RESTORE_FAILED: "DB_RESTORE_FAILED",
+  // Cache Operations
+  DB_CACHE_DELETE_FAILED: "DB_CACHE_DELETE_FAILED",
+  DB_CACHE_HEALTH_CHECK_FAILED: "DB_CACHE_HEALTH_CHECK_FAILED",
+  DB_CACHE_INVALIDATE_FAILED: "DB_CACHE_INVALIDATE_FAILED",
+  DB_CACHE_SET_FAILED: "DB_CACHE_SET_FAILED",
+  DB_CACHE_GET_FAILED: "DB_CACHE_GET_FAILED",
+  // File & Storage
+  DB_INVALID_FILEPATH: "DB_INVALID_FILEPATH",
+  DB_S3_DELETE_FAILED: "DB_S3_DELETE_FAILED",
+  DB_S3_DOWNLOAD_FAILED: "DB_S3_DOWNLOAD_FAILED",
+  DB_S3_NOT_CONFIGURED: "DB_S3_NOT_CONFIGURED",
+  DB_S3_UPLOAD_FAILED: "DB_S3_UPLOAD_FAILED",
+  // Misc
+  DB_SCHEDULE_SETUP_FAILED: "DB_SCHEDULE_SETUP_FAILED",
+  DB_DECRYPTION_FAILED: "DB_DECRYPTION_FAILED",
+  DB_INVALID_SHELL_ARG: "DB_INVALID_SHELL_ARG",
+  DB_INVALID_BETWEEN_OPERATOR: "DB_INVALID_BETWEEN_OPERATOR",
+  DB_INVALID_IN_OPERATOR: "DB_INVALID_IN_OPERATOR",
+  DB_INVALID_COUNT: "DB_INVALID_COUNT"
 };
 var API_ERROR_CODES = {
   CLIENT_INITIALIZATION_FAILED: ERROR_CODES.CLIENT_INITIALIZATION_FAILED,
@@ -1436,6 +1514,546 @@ var ERROR_DEFINITIONS = {
     severity: ERROR_SEVERITY.High,
     retryable: false,
     userMessage: "errors.database"
+  },
+  // ===== Database Error Definitions =====
+  // Connection & Configuration
+  [ERROR_CODES.DB_ACCESS_DENIED]: {
+    code: ERROR_CODES.DB_ACCESS_DENIED,
+    status: HTTP_STATUS.FORBIDDEN,
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "db.connection.access_denied",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_CONFIG_REQUIRED]: {
+    code: ERROR_CODES.DB_CONFIG_REQUIRED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Configuration,
+    userMessage: "db.connection.config_required",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_CONNECT_FAILED]: {
+    code: ERROR_CODES.DB_CONNECT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.connection.connect_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.DB_DISCONNECT_FAILED]: {
+    code: ERROR_CODES.DB_DISCONNECT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.connection.disconnect_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INIT_FAILED]: {
+    code: ERROR_CODES.DB_INIT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.connection.init_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  // Query & Execution
+  [ERROR_CODES.DB_QUERY_FAILED]: {
+    code: ERROR_CODES.DB_QUERY_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.query.failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_BUILD_WHERE_FAILED]: {
+    code: ERROR_CODES.DB_BUILD_WHERE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.query.build_where_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_SQL]: {
+    code: ERROR_CODES.DB_INVALID_SQL,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.query.invalid_sql",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_TRANSACTION_FAILED]: {
+    code: ERROR_CODES.DB_TRANSACTION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.query.transaction_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.DB_UNSUPPORTED_OPERATOR]: {
+    code: ERROR_CODES.DB_UNSUPPORTED_OPERATOR,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.query.unsupported_operator",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  // CRUD Operations
+  [ERROR_CODES.DB_CREATE_FAILED]: {
+    code: ERROR_CODES.DB_CREATE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.create_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_CREATION_FAILED]: {
+    code: ERROR_CODES.DB_CREATION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.create_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_FETCH_FAILED]: {
+    code: ERROR_CODES.DB_FETCH_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.fetch_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_FIND_FAILED]: {
+    code: ERROR_CODES.DB_FIND_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.find_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_FIND_MANY_FAILED]: {
+    code: ERROR_CODES.DB_FIND_MANY_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.find_many_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_FIND_BY_ID_FAILED]: {
+    code: ERROR_CODES.DB_FIND_BY_ID_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.find_by_id_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_UPDATE_FAILED]: {
+    code: ERROR_CODES.DB_UPDATE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.update_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_UPDATE_NO_CHANGES]: {
+    code: ERROR_CODES.DB_UPDATE_NO_CHANGES,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.crud.update_no_changes",
+    severity: ERROR_SEVERITY.Low,
+    retryable: false
+  },
+  [ERROR_CODES.DB_DELETE_FAILED]: {
+    code: ERROR_CODES.DB_DELETE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.delete_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INSERT_FAILED]: {
+    code: ERROR_CODES.DB_INSERT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.insert_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_RECORD_NOT_FOUND]: {
+    code: ERROR_CODES.DB_RECORD_NOT_FOUND,
+    status: HTTP_STATUS.NOT_FOUND,
+    category: ERROR_CATEGORY.NotFound,
+    userMessage: "db.crud.record_not_found",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_EXISTS_FAILED]: {
+    code: ERROR_CODES.DB_EXISTS_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.crud.exists_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  // Schema & Columns
+  [ERROR_CODES.DB_COLUMN_NOT_EXISTS]: {
+    code: ERROR_CODES.DB_COLUMN_NOT_EXISTS,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.schema.column_not_exists",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_TABLE_NOT_REGISTERED]: {
+    code: ERROR_CODES.DB_TABLE_NOT_REGISTERED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.schema.table_not_registered",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_TABLE_REGISTRATION_FAILED]: {
+    code: ERROR_CODES.DB_TABLE_REGISTRATION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.schema.table_registration_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_ID_COLUMN_NOT_REGISTERED]: {
+    code: ERROR_CODES.DB_ID_COLUMN_NOT_REGISTERED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.schema.id_column_not_registered",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_COLUMN]: {
+    code: ERROR_CODES.DB_INVALID_COLUMN,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.schema.invalid_column",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_TABLE_NAME]: {
+    code: ERROR_CODES.DB_INVALID_TABLE_NAME,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.schema.invalid_table_name",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_GET_ID_COLUMN_FAILED]: {
+    code: ERROR_CODES.DB_GET_ID_COLUMN_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.schema.get_id_column_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_GET_TABLE_FAILED]: {
+    code: ERROR_CODES.DB_GET_TABLE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.schema.get_table_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  // Validation & Parameters
+  [ERROR_CODES.DB_INVALID_PARAMETERS]: {
+    code: ERROR_CODES.DB_INVALID_PARAMETERS,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_parameters",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_PARAMS]: {
+    code: ERROR_CODES.DB_INVALID_PARAMS,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_parameters",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_FILTER]: {
+    code: ERROR_CODES.DB_INVALID_FILTER,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_filter",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_ID]: {
+    code: ERROR_CODES.DB_INVALID_ID,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_id",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_ENTITY]: {
+    code: ERROR_CODES.DB_INVALID_ENTITY,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_entity",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_UPDATE_PARAMS]: {
+    code: ERROR_CODES.DB_INVALID_UPDATE_PARAMS,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_update_params",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_FIELD_NAME]: {
+    code: ERROR_CODES.DB_INVALID_FIELD_NAME,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.invalid_field_name",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_RESULT]: {
+    code: ERROR_CODES.DB_INVALID_RESULT,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.validation.invalid_result",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_NO_UPDATE_FIELDS]: {
+    code: ERROR_CODES.DB_NO_UPDATE_FIELDS,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.validation.no_update_fields",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  // Count & Data
+  [ERROR_CODES.DB_COUNT_FAILED]: {
+    code: ERROR_CODES.DB_COUNT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.count.failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.DB_COUNT_NO_RESULTS]: {
+    code: ERROR_CODES.DB_COUNT_NO_RESULTS,
+    status: HTTP_STATUS.NOT_FOUND,
+    category: ERROR_CATEGORY.NotFound,
+    userMessage: "db.count.no_results",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_NO_DATA]: {
+    code: ERROR_CODES.DB_NO_DATA,
+    status: HTTP_STATUS.NOT_FOUND,
+    category: ERROR_CATEGORY.NotFound,
+    userMessage: "db.count.no_results",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  // Multi-tenant Context
+  [ERROR_CODES.DB_NO_TENANT_CONTEXT]: {
+    code: ERROR_CODES.DB_NO_TENANT_CONTEXT,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.tenant.no_context",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_NO_TENANT_ID]: {
+    code: ERROR_CODES.DB_NO_TENANT_ID,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.tenant.no_tenant_id",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_TENANT_VALIDATION_FAILED]: {
+    code: ERROR_CODES.DB_TENANT_VALIDATION_FAILED,
+    status: HTTP_STATUS.FORBIDDEN,
+    category: ERROR_CATEGORY.Authorization,
+    userMessage: "db.tenant.validation_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  // Backup & Restore
+  [ERROR_CODES.DB_BACKUP_CLEANUP_FAILED]: {
+    code: ERROR_CODES.DB_BACKUP_CLEANUP_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.backup.cleanup_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_BACKUP_FILE_NOT_FOUND]: {
+    code: ERROR_CODES.DB_BACKUP_FILE_NOT_FOUND,
+    status: HTTP_STATUS.NOT_FOUND,
+    category: ERROR_CATEGORY.NotFound,
+    userMessage: "db.backup.file_not_found",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_LIST_BACKUPS_FAILED]: {
+    code: ERROR_CODES.DB_LIST_BACKUPS_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.backup.list_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_BACKUP_INFO]: {
+    code: ERROR_CODES.DB_INVALID_BACKUP_INFO,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.backup.invalid_info",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_RESTORE_FAILED]: {
+    code: ERROR_CODES.DB_RESTORE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.backup.restore_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  // Cache Operations
+  [ERROR_CODES.DB_CACHE_DELETE_FAILED]: {
+    code: ERROR_CODES.DB_CACHE_DELETE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Cache,
+    userMessage: "db.cache.delete_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  [ERROR_CODES.DB_CACHE_HEALTH_CHECK_FAILED]: {
+    code: ERROR_CODES.DB_CACHE_HEALTH_CHECK_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Cache,
+    userMessage: "db.cache.health_check_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  [ERROR_CODES.DB_CACHE_INVALIDATE_FAILED]: {
+    code: ERROR_CODES.DB_CACHE_INVALIDATE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Cache,
+    userMessage: "db.cache.invalidate_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  [ERROR_CODES.DB_CACHE_SET_FAILED]: {
+    code: ERROR_CODES.DB_CACHE_SET_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Cache,
+    userMessage: "db.cache.set_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  [ERROR_CODES.DB_CACHE_GET_FAILED]: {
+    code: ERROR_CODES.DB_CACHE_GET_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Cache,
+    userMessage: "db.cache.get_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  // File & Storage
+  [ERROR_CODES.DB_INVALID_FILEPATH]: {
+    code: ERROR_CODES.DB_INVALID_FILEPATH,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.file.invalid_filepath",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_S3_DELETE_FAILED]: {
+    code: ERROR_CODES.DB_S3_DELETE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.file.s3_delete_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.DB_S3_DOWNLOAD_FAILED]: {
+    code: ERROR_CODES.DB_S3_DOWNLOAD_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.file.s3_download_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.DB_S3_NOT_CONFIGURED]: {
+    code: ERROR_CODES.DB_S3_NOT_CONFIGURED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Configuration,
+    userMessage: "db.file.s3_not_configured",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_S3_UPLOAD_FAILED]: {
+    code: ERROR_CODES.DB_S3_UPLOAD_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.file.s3_upload_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  // Misc
+  [ERROR_CODES.DB_SCHEDULE_SETUP_FAILED]: {
+    code: ERROR_CODES.DB_SCHEDULE_SETUP_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.misc.schedule_setup_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_DECRYPTION_FAILED]: {
+    code: ERROR_CODES.DB_DECRYPTION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.misc.decryption_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_SHELL_ARG]: {
+    code: ERROR_CODES.DB_INVALID_SHELL_ARG,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_shell_arg",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_BETWEEN_OPERATOR]: {
+    code: ERROR_CODES.DB_INVALID_BETWEEN_OPERATOR,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_between_operator",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_IN_OPERATOR]: {
+    code: ERROR_CODES.DB_INVALID_IN_OPERATOR,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_in_operator",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_COUNT]: {
+    code: ERROR_CODES.DB_INVALID_COUNT,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_count",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
   }
 };