@carecard/common-util 3.1.1 → 3.1.2

package/index.d.ts

@@ -68,6 +68,19 @@ export function throwInputNotUuidError(params?: { userMessage?: string; details?
 export function throwFileTooLargeError(params?: { userMessage?: string; details?: any }): never;
 /** Throws an Invalid_Time_Value error. */
 export function throwInvalidTimeValueError(params?: { userMessage?: string; details?: any }): never;
+/** Throws a Not_Found error. */
+export function throwNotFoundError(params?: { userMessage?: string; details?: any }): never;
+/** Throws a Record_Save_Failure error. */
+export function throwRecordSaveFailureError(params?: {
+  userMessage?: string;
+  details?: any;
+}): never;
+/** Throws an Application_Error error. */
+export function throwApplicationError(params?: { userMessage?: string; details?: any }): never;
+/** Throws a Network_Error error. */
+export function throwNetworkError(params?: { userMessage?: string; details?: any }): never;
+/** Throws an Unexpected_Error error. */
+export function throwUnexpectedError(params?: { userMessage?: string; details?: any }): never;
 
 /**
  * Application-level error handlers and throwers.
@@ -95,6 +108,11 @@ export const error: {
   throwInputNotUuidError: typeof throwInputNotUuidError;
   throwFileTooLargeError: typeof throwFileTooLargeError;
   throwInvalidTimeValueError: typeof throwInvalidTimeValueError;
+  throwNotFoundError: typeof throwNotFoundError;
+  throwRecordSaveFailureError: typeof throwRecordSaveFailureError;
+  throwApplicationError: typeof throwApplicationError;
+  throwNetworkError: typeof throwNetworkError;
+  throwUnexpectedError: typeof throwUnexpectedError;
 };
 
 /** Sets 200 OK status and optionally an ETag header. */
@@ -188,3 +206,38 @@ export function createError(params: {
   message?: string;
   fields?: Record<string, string>;
 }): ApiError;
+
+/**
+ * Standard API error codes.
+ */
+export enum ApiErrorType {
+  VALIDATION_FAILURE = 'VALIDATION_FAILURE',
+  WRONG_CREDENTIALS = 'WRONG_CREDENTIALS',
+  RECORD_NOT_FOUND = 'RECORD_NOT_FOUND',
+  RECORD_NOT_SAVED = 'RECORD_NOT_SAVED',
+  RECORD_SAVE_FAILURE = 'RECORD_SAVE_FAILURE',
+  APPLICATION_ERROR = 'APPLICATION_ERROR',
+  NOT_FOUND = 'NOT_FOUND',
+  LOGIN_REQUIRED = 'LOGIN_REQUIRED',
+  NETWORK_ERROR = 'NETWORK_ERROR',
+  UNEXPECTED_ERROR = 'UNEXPECTED_ERROR',
+  ACCOUNT_SUSPENDED = 'ACCOUNT_SUSPENDED',
+  ACCOUNT_BLOCKED = 'ACCOUNT_BLOCKED',
+  ACCOUNT_INACTIVE = 'ACCOUNT_INACTIVE',
+  RECORD_EXIST = 'RECORD_EXIST',
+  UPDATE_FAILED = 'UPDATE_FAILED',
+  TRANSACTION_FAILED = 'TRANSACTION_FAILED',
+  USED_TOKEN = 'USED_TOKEN',
+  BAD_VISITOR_TOKEN = 'BAD_VISITOR_TOKEN',
+  FILE_FORMAT_NOT_SUPPORTED = 'FILE_FORMAT_NOT_SUPPORTED',
+  NOT_AUTHORIZED = 'NOT_AUTHORIZED',
+  BAD_INPUT = 'BAD_INPUT',
+  INPUT_NOT_UUID = 'INPUT_NOT_UUID',
+  FILE_TOO_LARGE = 'FILE_TOO_LARGE',
+  INVALID_TIME_VALUE = 'INVALID_TIME_VALUE'
+}
+
+/**
+ * Extracts error message from standardized error data.
+ */
+export function getApiErrorMessage(errorData: any, t: (key: string) => string): string;

package/index.mjs

@@ -1,5 +1,55 @@
 import commonUtil from './index.js';
 
-export const { util, error, resCode, requestContext, sendResponse, createError } = commonUtil;
+export const {
+  // Legacy objects
+  util,
+  error,
+  resCode,
+
+  // Top-level utility functions
+  extractObjectWithProperties,
+
+  // Top-level error handlers/throwers
+  throwAccountSuspendedError,
+  throwAccountBlockedError,
+  throwAccountInactiveError,
+  throwNotFoundError,
+  throwRecordSaveFailureError,
+  throwApplicationError,
+  throwNetworkError,
+  throwUnexpectedError,
+  notFound404,
+  appErrorHandler,
+  throwValidationFailureError,
+  throwRecordExistError,
+  throwWrongCredentialsError,
+  throwLoginRequiredError,
+  throwRecordNotFoundError,
+  throwRecordNotSavedError,
+  throwUpdateFailedError,
+  throwTransactionFailedError,
+  throwUsedTokenError,
+  throwBadVisitorTokenError,
+  throwFileFormatNotSupportedError,
+  throwNotAuthorizedError,
+  throwBadInputError,
+  throwInputNotUuidError,
+  throwFileTooLargeError,
+  throwInvalidTimeValueError,
+
+  // Top-level response status functions
+  setOk200,
+  setCreated201,
+  setBadRequest400ClientError,
+
+  // Core functions
+  requestContext,
+  sendResponse,
+  createError,
+
+  // Constants and utils
+  ApiErrorType,
+  getApiErrorMessage
+} = commonUtil;
 
 export default commonUtil;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carecard/common-util",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Standardized API response and utility functions for Express.js and Next.js microservices",
   "main": "index.js",
   "module": "index.mjs",
@@ -28,10 +28,10 @@
   },
   "scripts": {
     "test": "export NODE_ENV=test && mocha --recursive",
-    "test:types": "tsc --noEmit && mocha -r ts-node/register test/types.test.ts",
+    "test:types": "tsc --noEmit && mocha -r ts-node/register test/types.test.mts",
     "test:coverage": "export NODE_ENV=test && nyc mocha --recursive",
-    "test:types:coverage": "tsc --noEmit && export NODE_ENV=test && nyc mocha -r ts-node/register 'test/**/*.{js,ts}'",
-    "coverage": "export NODE_ENV=test && nyc mocha --recursive -r ts-node/register 'test/**/*.{js,ts}' && nyc check-coverage",
+    "test:types:coverage": "tsc --noEmit && export NODE_ENV=test && nyc mocha -r ts-node/register 'test/**/*.{js,ts,mts}'",
+    "coverage": "export NODE_ENV=test && nyc mocha --recursive -r ts-node/register 'test/**/*.{js,ts,mts}' && nyc check-coverage",
     "prettier": "prettier --write .",
     "prettier:check": "prettier --check .",
     "prepare": "husky"

package/src/index.js

@@ -1,12 +1,29 @@
 const requestContext = require('./middleware/requestContext');
 const sendResponse = require('./utils/sendResponse');
 const createError = require('./utils/createError');
+const utilityFunctions = require('./lib/utilityFunctions');
+const appErrorHandlers = require('./lib/appErrorHandlers');
+const responseStatus = require('./lib/responseStatus');
+const errorConstants = require('./lib/errorConstants');
+const errorUtils = require('./lib/errorUtils');
 
 module.exports = {
-  util: require('./lib/utilityFunctions'),
-  error: require('./lib/appErrorHandlers'),
-  resCode: require('./lib/responseStatus'),
+  // Nested exports (Legacy/Deprecated)
+  util: utilityFunctions,
+  error: appErrorHandlers,
+  resCode: responseStatus,
+
+  // Direct top-level exports
+  ...utilityFunctions,
+  ...appErrorHandlers,
+  ...responseStatus,
+
+  // Core utilities
   requestContext,
   sendResponse,
-  createError
+  createError,
+
+  // Error system
+  ApiErrorType: errorConstants.ApiErrorType,
+  getApiErrorMessage: errorUtils.getApiErrorMessage
 };

package/src/lib/appErrorHandlers.js

@@ -2,6 +2,7 @@
 
 const sendResponse = require('../utils/sendResponse');
 const createError = require('../utils/createError');
+const { ApiErrorType } = require('./errorConstants');
 
 /**
  * These are application level error handlers. All error responses should be send using these functions.
@@ -11,6 +12,11 @@ module.exports = {
   throwAccountSuspendedError,
   throwAccountBlockedError,
   throwAccountInactiveError,
+  throwNotFoundError,
+  throwRecordSaveFailureError,
+  throwApplicationError,
+  throwNetworkError,
+  throwUnexpectedError,
   notFound404,
   appErrorHandler,
   throwValidationFailureError,
@@ -39,7 +45,7 @@ function notFound404(req, res, next) {
     success: false,
     message: 'Not found',
     error: createError({
-      code: 'NOT_FOUND',
+      code: ApiErrorType.NOT_FOUND,
       message: 'Not found',
       details: null
     })
@@ -49,11 +55,17 @@ function notFound404(req, res, next) {
 function appErrorHandler(err, req, res, next) {
   let statusCode = 500;
   const errorMessage = err?.message || 'Internal Server Error';
+  const errorCode = err?.code;
 
-  switch (err?.message) {
+  switch (errorCode || err?.message) {
     case 'Account_Suspended':
     case 'Account_Blocked':
     case 'Account_Inactive':
+    case ApiErrorType.ACCOUNT_SUSPENDED:
+    case ApiErrorType.ACCOUNT_BLOCKED:
+    case ApiErrorType.ACCOUNT_INACTIVE:
+    case 'Invalid time value':
+    case ApiErrorType.INVALID_TIME_VALUE:
       statusCode = 403;
       break;
 
@@ -63,6 +75,12 @@ function appErrorHandler(err, req, res, next) {
     case 'Bad_Visitor_Token':
     case 'Login_Required':
     case 'Not_Authorized':
+    case ApiErrorType.VALIDATION_FAILURE:
+    case ApiErrorType.USED_TOKEN:
+    case ApiErrorType.WRONG_CREDENTIALS:
+    case ApiErrorType.BAD_VISITOR_TOKEN:
+    case ApiErrorType.LOGIN_REQUIRED:
+    case ApiErrorType.NOT_AUTHORIZED:
       statusCode = 401;
       break;
 
@@ -71,27 +89,41 @@ function appErrorHandler(err, req, res, next) {
     case 'Transaction_Failed':
     case 'Bad_Input':
     case 'Input_Not_Uuid':
+    case ApiErrorType.RECORD_NOT_SAVED:
+    case ApiErrorType.UPDATE_FAILED:
+    case ApiErrorType.TRANSACTION_FAILED:
+    case ApiErrorType.BAD_INPUT:
+    case ApiErrorType.INPUT_NOT_UUID:
       statusCode = 400;
       break;
 
     case 'Record_Exist':
+    case ApiErrorType.RECORD_EXIST:
       statusCode = 409;
       break;
 
     case 'Record_NotFound':
+    case 'Not found':
+    case ApiErrorType.RECORD_NOT_FOUND:
+    case ApiErrorType.NOT_FOUND:
       statusCode = 404;
       break;
 
     case 'File_Format_Not_Supported':
+    case ApiErrorType.FILE_FORMAT_NOT_SUPPORTED:
       statusCode = 415;
       break;
 
     case 'File too large':
+    case ApiErrorType.FILE_TOO_LARGE:
       statusCode = 413;
       break;
 
-    case 'Invalid time value':
-      statusCode = 403;
+    case ApiErrorType.RECORD_SAVE_FAILURE:
+    case ApiErrorType.APPLICATION_ERROR:
+    case ApiErrorType.NETWORK_ERROR:
+    case ApiErrorType.UNEXPECTED_ERROR:
+      statusCode = 500;
       break;
 
     default:
@@ -114,7 +146,7 @@ function appErrorHandler(err, req, res, next) {
 
 function throwAccountSuspendedError(params = {}) {
   const error = new Error('Account_Suspended');
-  error.code = 'ACCOUNT_SUSPENDED';
+  error.code = ApiErrorType.ACCOUNT_SUSPENDED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -122,7 +154,7 @@ function throwAccountSuspendedError(params = {}) {
 
 function throwAccountBlockedError(params = {}) {
   const error = new Error('Account_Blocked');
-  error.code = 'ACCOUNT_BLOCKED';
+  error.code = ApiErrorType.ACCOUNT_BLOCKED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -130,7 +162,7 @@ function throwAccountBlockedError(params = {}) {
 
 function throwAccountInactiveError(params = {}) {
   const error = new Error('Account_Inactive');
-  error.code = 'ACCOUNT_INACTIVE';
+  error.code = ApiErrorType.ACCOUNT_INACTIVE;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -138,7 +170,7 @@ function throwAccountInactiveError(params = {}) {
 
 function throwValidationFailureError(params = {}) {
   const error = new Error('Validation_Failure');
-  error.code = 'VALIDATION_FAILURE';
+  error.code = ApiErrorType.VALIDATION_FAILURE;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -146,7 +178,7 @@ function throwValidationFailureError(params = {}) {
 
 function throwWrongCredentialsError(params = {}) {
   const error = new Error('Wrong_Credentials');
-  error.code = 'WRONG_CREDENTIALS';
+  error.code = ApiErrorType.WRONG_CREDENTIALS;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -154,7 +186,7 @@ function throwWrongCredentialsError(params = {}) {
 
 function throwRecordExistError(params = {}) {
   const error = new Error('Record_Exist');
-  error.code = 'RECORD_EXIST';
+  error.code = ApiErrorType.RECORD_EXIST;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -162,7 +194,7 @@ function throwRecordExistError(params = {}) {
 
 function throwRecordNotFoundError(params = {}) {
   const error = new Error('Record_NotFound');
-  error.code = 'RECORD_NOT_FOUND';
+  error.code = ApiErrorType.RECORD_NOT_FOUND;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -170,7 +202,7 @@ function throwRecordNotFoundError(params = {}) {
 
 function throwRecordNotSavedError(params = {}) {
   const error = new Error('Record_NotSaved');
-  error.code = 'RECORD_NOT_SAVED';
+  error.code = ApiErrorType.RECORD_NOT_SAVED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -178,7 +210,7 @@ function throwRecordNotSavedError(params = {}) {
 
 function throwLoginRequiredError(params = {}) {
   const error = new Error('Login_Required');
-  error.code = 'LOGIN_REQUIRED';
+  error.code = ApiErrorType.LOGIN_REQUIRED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -186,7 +218,7 @@ function throwLoginRequiredError(params = {}) {
 
 function throwUpdateFailedError(params = {}) {
   const error = new Error('Update_Failed');
-  error.code = 'UPDATE_FAILED';
+  error.code = ApiErrorType.UPDATE_FAILED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -194,7 +226,7 @@ function throwUpdateFailedError(params = {}) {
 
 function throwTransactionFailedError(params = {}) {
   const error = new Error('Transaction_Failed');
-  error.code = 'TRANSACTION_FAILED';
+  error.code = ApiErrorType.TRANSACTION_FAILED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -202,7 +234,7 @@ function throwTransactionFailedError(params = {}) {
 
 function throwUsedTokenError(params = {}) {
   const error = new Error('Used_Token');
-  error.code = 'USED_TOKEN';
+  error.code = ApiErrorType.USED_TOKEN;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -210,7 +242,7 @@ function throwUsedTokenError(params = {}) {
 
 function throwVisitorTokenError(params = {}) {
   const error = new Error('Bad_Visitor_Token');
-  error.code = 'BAD_VISITOR_TOKEN';
+  error.code = ApiErrorType.BAD_VISITOR_TOKEN;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -218,7 +250,7 @@ function throwVisitorTokenError(params = {}) {
 
 function throwFileFormatNotSupportedError(params = {}) {
   const error = new Error('File_Format_Not_Supported');
-  error.code = 'FILE_FORMAT_NOT_SUPPORTED';
+  error.code = ApiErrorType.FILE_FORMAT_NOT_SUPPORTED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -226,7 +258,7 @@ function throwFileFormatNotSupportedError(params = {}) {
 
 function throwNotAuthorizedError(params = {}) {
   const error = new Error('Not_Authorized');
-  error.code = 'NOT_AUTHORIZED';
+  error.code = ApiErrorType.NOT_AUTHORIZED;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -234,7 +266,7 @@ function throwNotAuthorizedError(params = {}) {
 
 function throwBadInputError(params = {}) {
   const error = new Error('Bad_Input');
-  error.code = 'BAD_INPUT';
+  error.code = ApiErrorType.BAD_INPUT;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -242,7 +274,7 @@ function throwBadInputError(params = {}) {
 
 function throwInputNotUuidError(params = {}) {
   const error = new Error('Input_Not_Uuid');
-  error.code = 'INPUT_NOT_UUID';
+  error.code = ApiErrorType.INPUT_NOT_UUID;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -250,7 +282,7 @@ function throwInputNotUuidError(params = {}) {
 
 function throwFileTooLargeError(params = {}) {
   const error = new Error('File too large');
-  error.code = 'FILE_TOO_LARGE';
+  error.code = ApiErrorType.FILE_TOO_LARGE;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;
@@ -258,7 +290,47 @@ function throwFileTooLargeError(params = {}) {
 
 function throwInvalidTimeValueError(params = {}) {
   const error = new Error('Invalid time value');
-  error.code = 'INVALID_TIME_VALUE';
+  error.code = ApiErrorType.INVALID_TIME_VALUE;
+  error.userMessage = params.userMessage ?? null;
+  error.details = params.details ?? null;
+  throw error;
+}
+
+function throwNotFoundError(params = {}) {
+  const error = new Error('Not found');
+  error.code = ApiErrorType.NOT_FOUND;
+  error.userMessage = params.userMessage ?? null;
+  error.details = params.details ?? null;
+  throw error;
+}
+
+function throwRecordSaveFailureError(params = {}) {
+  const error = new Error('Record_Save_Failure');
+  error.code = ApiErrorType.RECORD_SAVE_FAILURE;
+  error.userMessage = params.userMessage ?? null;
+  error.details = params.details ?? null;
+  throw error;
+}
+
+function throwApplicationError(params = {}) {
+  const error = new Error('Application_Error');
+  error.code = ApiErrorType.APPLICATION_ERROR;
+  error.userMessage = params.userMessage ?? null;
+  error.details = params.details ?? null;
+  throw error;
+}
+
+function throwNetworkError(params = {}) {
+  const error = new Error('Network_Error');
+  error.code = ApiErrorType.NETWORK_ERROR;
+  error.userMessage = params.userMessage ?? null;
+  error.details = params.details ?? null;
+  throw error;
+}
+
+function throwUnexpectedError(params = {}) {
+  const error = new Error('Unexpected_Error');
+  error.code = ApiErrorType.UNEXPECTED_ERROR;
   error.userMessage = params.userMessage ?? null;
   error.details = params.details ?? null;
   throw error;

package/src/lib/errorConstants.js

@@ -0,0 +1,39 @@
+'use strict';
+
+/**
+ * Standard API error codes used across the system.
+ * This should be kept in sync between the backend and frontend.
+ */
+const ApiErrorType = {
+  // Common codes
+  VALIDATION_FAILURE: 'VALIDATION_FAILURE',
+  WRONG_CREDENTIALS: 'WRONG_CREDENTIALS',
+  RECORD_NOT_FOUND: 'RECORD_NOT_FOUND',
+  RECORD_NOT_SAVED: 'RECORD_NOT_SAVED',
+  RECORD_SAVE_FAILURE: 'RECORD_SAVE_FAILURE',
+  APPLICATION_ERROR: 'APPLICATION_ERROR',
+  NOT_FOUND: 'NOT_FOUND',
+  LOGIN_REQUIRED: 'LOGIN_REQUIRED',
+  NETWORK_ERROR: 'NETWORK_ERROR',
+  UNEXPECTED_ERROR: 'UNEXPECTED_ERROR',
+  ACCOUNT_SUSPENDED: 'ACCOUNT_SUSPENDED',
+  ACCOUNT_BLOCKED: 'ACCOUNT_BLOCKED',
+  ACCOUNT_INACTIVE: 'ACCOUNT_INACTIVE',
+
+  // Additional codes from appErrorHandlers
+  RECORD_EXIST: 'RECORD_EXIST',
+  UPDATE_FAILED: 'UPDATE_FAILED',
+  TRANSACTION_FAILED: 'TRANSACTION_FAILED',
+  USED_TOKEN: 'USED_TOKEN',
+  BAD_VISITOR_TOKEN: 'BAD_VISITOR_TOKEN',
+  FILE_FORMAT_NOT_SUPPORTED: 'FILE_FORMAT_NOT_SUPPORTED',
+  NOT_AUTHORIZED: 'NOT_AUTHORIZED',
+  BAD_INPUT: 'BAD_INPUT',
+  INPUT_NOT_UUID: 'INPUT_NOT_UUID',
+  FILE_TOO_LARGE: 'FILE_TOO_LARGE',
+  INVALID_TIME_VALUE: 'INVALID_TIME_VALUE'
+};
+
+module.exports = {
+  ApiErrorType
+};

package/src/lib/errorUtils.js

@@ -0,0 +1,137 @@
+'use strict';
+
+const { ApiErrorType } = require('./errorConstants');
+
+/**
+ * Extracts error message from standardized error data.
+ *
+ * @param {Object} errorData - The error data from API or legacy source.
+ * @param {Function} t - Translation function (key => translated string).
+ * @returns {string} The formatted error message.
+ */
+function getApiErrorMessage(errorData, t) {
+  if (!errorData) {
+    return t('errors.unexpected_error');
+  }
+
+  // Try to get message from direct field or nested error object
+  let message;
+
+  // Prefer nested error message if available
+  if (
+    errorData.error &&
+    typeof errorData.error === 'object' &&
+    errorData.error !== null &&
+    errorData.error.message
+  ) {
+    message = errorData.error.message;
+  }
+
+  // Fallback to top-level message
+  if (!message && typeof errorData.message === 'string' && errorData.message) {
+    message = errorData.message;
+  }
+
+  if (message) {
+    return message;
+  }
+
+  // Try to get error code
+  let errorCode;
+  if (errorData.error) {
+    if (typeof errorData.error === 'string') {
+      errorCode = errorData.error;
+    } else if (
+      typeof errorData.error === 'object' &&
+      errorData.error !== null &&
+      errorData.error.code
+    ) {
+      errorCode = errorData.error.code;
+    }
+  }
+
+  if (!errorCode) {
+    return t('errors.unexpected_error');
+  }
+
+  const code = errorCode.toLowerCase();
+
+  switch (code) {
+    case ApiErrorType.VALIDATION_FAILURE.toLowerCase():
+      return t('errors.validation_failure');
+
+    case ApiErrorType.WRONG_CREDENTIALS.toLowerCase():
+      return t('errors.wrong_credentials');
+
+    case ApiErrorType.RECORD_NOT_FOUND.toLowerCase():
+      return t('errors.record_not_found');
+
+    case ApiErrorType.RECORD_NOT_SAVED.toLowerCase():
+      return t('errors.record_not_saved');
+
+    case ApiErrorType.RECORD_SAVE_FAILURE.toLowerCase():
+      return t('errors.record_save_failure');
+
+    case ApiErrorType.APPLICATION_ERROR.toLowerCase():
+      return t('errors.application_error');
+
+    case ApiErrorType.NOT_FOUND.toLowerCase():
+      return t('errors.not_found');
+
+    case ApiErrorType.LOGIN_REQUIRED.toLowerCase():
+      return t('errors.login_required');
+
+    case ApiErrorType.NETWORK_ERROR.toLowerCase():
+      return t('errors.network_error');
+
+    case ApiErrorType.ACCOUNT_SUSPENDED.toLowerCase():
+      return t('errors.account_suspended');
+
+    case ApiErrorType.ACCOUNT_BLOCKED.toLowerCase():
+      return t('errors.account_blocked');
+
+    case ApiErrorType.ACCOUNT_INACTIVE.toLowerCase():
+      return t('errors.account_inactive');
+
+    case ApiErrorType.RECORD_EXIST.toLowerCase():
+      return t('errors.record_exist');
+
+    case ApiErrorType.UPDATE_FAILED.toLowerCase():
+      return t('errors.update_failed');
+
+    case ApiErrorType.TRANSACTION_FAILED.toLowerCase():
+      return t('errors.transaction_failed');
+
+    case ApiErrorType.USED_TOKEN.toLowerCase():
+      return t('errors.used_token');
+
+    case ApiErrorType.BAD_VISITOR_TOKEN.toLowerCase():
+      return t('errors.bad_visitor_token');
+
+    case ApiErrorType.FILE_FORMAT_NOT_SUPPORTED.toLowerCase():
+      return t('errors.file_format_not_supported');
+
+    case ApiErrorType.NOT_AUTHORIZED.toLowerCase():
+      return t('errors.not_authorized');
+
+    case ApiErrorType.BAD_INPUT.toLowerCase():
+      return t('errors.bad_input');
+
+    case ApiErrorType.INPUT_NOT_UUID.toLowerCase():
+      return t('errors.input_not_uuid');
+
+    case ApiErrorType.FILE_TOO_LARGE.toLowerCase():
+      return t('errors.file_too_large');
+
+    case ApiErrorType.INVALID_TIME_VALUE.toLowerCase():
+      return t('errors.invalid_time_value');
+
+    case ApiErrorType.UNEXPECTED_ERROR.toLowerCase():
+    default:
+      return t('errors.unexpected_error');
+  }
+}
+
+module.exports = {
+  getApiErrorMessage
+};

package/src/middleware/requestContext.js

@@ -1,4 +1,14 @@
-const { randomUUID } = require('node:crypto');
+const getUuid = () => {
+  try {
+    const crypto = require('crypto');
+    if (crypto.randomUUID) {
+      return crypto.randomUUID();
+    }
+    return '00000000-0000-0000-0000-000000000000';
+  } catch (e) {
+    return '00000000-0000-0000-0000-000000000000';
+  }
+};
 
 /**
  * Express middleware to generate and attach request context.
@@ -13,8 +23,9 @@ const { randomUUID } = require('node:crypto');
  * @param {import('express').NextFunction} next
  */
 const requestContext = (req, res, next) => {
-  req.requestId = randomUUID();
-  req.traceId = req.headers['x-trace-id'] || randomUUID();
+  const requestId = getUuid();
+  req.requestId = requestId;
+  req.traceId = req.headers['x-trace-id'] || requestId;
 
   const appId = req.headers['x-app-id'];
   const ip = req.ip || req.headers['x-forwarded-for'] || req.socket.remoteAddress;