@floristcloud/api-lib 1.2.95 → 1.2.97

package/constant/error.ts

@@ -28,7 +28,7 @@ export const ERRORS = {
     NOTIFICATION_NOT_UPDATED: { code: 'N003', message: 'Failed to update Notification', httpCode: 500 },
     NOTIFICATION_FETCH_FAILED: { code: 'N004', message: 'Error when retrieving a notification', httpCode: 500 },
     NOTIFICATION_MAX_RETRIES_REACHED: {
-        code: 'N004',
+        code: 'N009',
         message: 'Maximum retry attempts reached for notification',
         httpCode: 500,
     },
@@ -83,6 +83,8 @@ export const ERRORS = {
     SETTINGS_FETCH_FAILED: { code: 'S006', message: 'Error when retrieving a Settings', httpCode: 500 },
 
     FORBIDDEN_API: { code: 'A011', message: 'Access denied', httpCode: 403 },
+    RESOURCE_ACCESS_DENIED: { code: 'A022', message: 'Resource does not belong to your company', httpCode: 400 },
+    RESOURCE_NOT_FOUND: { code: 'A023', message: 'Resource not found', httpCode: 404 },
     FAILED_TO_DEFINE_ROLE: { code: 'A008', message: 'User role could not be determined', httpCode: 400 },
     ACCOUNT_WITH_PAYLOAD_NOT_FOUND: { code: 'A016', message: 'Account not be found based on information from the token', httpCode: 404 },
 
@@ -99,12 +101,14 @@ export const ERRORS = {
     USER_UPDATE_FAILED: { code: 'U009', message: 'Failed to update user', httpCode: 400 },
     USER_LIST_FETCH_FAILED: { code: 'U010', message: 'Failed fetching user list', httpCode: 500 },
     USER_NO_BELONGS_COMPANY: { code: 'U011', message: 'This user does not belongs to the company ', httpCode: 403 },
-    USER_MISSING_EMAIL_OR_PHONE: { code: 'U012', message: 'Не указан email или телефон ', httpCode: 400 },
+    USER_MISSING_EMAIL_OR_PHONE: { code: 'U012', message: 'Email or phone is required', httpCode: 400 },
     USER_ROLE_MISMATCH_CLIENT: { code: 'U013', message: 'User does not have BUYER role required for client login', httpCode: 403 },
     USER_ROLE_MISMATCH_EMPLOYEE: { code: 'U014', message: 'User does not have employee role required for employee login', httpCode: 403 },
     USER_CANNOT_DEACTIVATE_SELF: { code: 'U015', message: 'You cannot deactivate your own account', httpCode: 400 },
     USER_CANNOT_REMOVE_OWN_ADMIN_ROLE: { code: 'U016', message: 'You cannot remove the ADMIN role from your own account', httpCode: 400 },
     USER_CANNOT_REMOVE_LAST_ADMIN: { code: 'U017', message: 'The company must keep at least one active administrator', httpCode: 400 },
+    USER_EMAIL_REQUIRED_FOR_NOTIFICATION: { code: 'U018', message: 'User email is required for email notification', httpCode: 400 },
+    USER_PASSWORD_GENERATION_FAILED: { code: 'U019', message: 'Failed to generate and send password', httpCode: 500 },
 
     //AUTH
     FAILED_TO_UPDATE: { code: 'A010', message: 'User update failed', httpCode: 500 },
@@ -141,6 +145,7 @@ export const ERRORS = {
     CLIENT_NOT_FOUND: { code: 'CL004', message: 'The client with the specified UUID was not found', httpCode: 404 },
     CLIENT_FETCH_FAILED: { code: 'CL005', message: 'Error when retrieving a list of clients', httpCode: 500 },
     CLIENT_ALREADY_EXIST: { code: 'CL006', message: 'Client with this properties already exist', httpCode: 409 },
+    CLIENT_ACCESS_DENIED: { code: 'CL043', message: 'You are not responsible for this client', httpCode: 403 },
     CLIENT_EMAIL_ALREADY_EXIST: { code: 'CL007', message: 'Client with this email already exist', httpCode: 409 },
     CLIENT_PHONE_ALREADY_EXIST: { code: 'CL008', message: 'Client with this phone already exist', httpCode: 409 },
     CLIENT_WITH_SAME_USER_ALREADY_EXIST: { code: 'CL009', message: 'Client with same user already exist', httpCode: 409 },
@@ -161,7 +166,7 @@ export const ERRORS = {
     CLIENT_HAS_ORDERS: { code: 'CL025', message: 'Client has orders', httpCode: 400 },
     CLIENT_IMPORT_FAILED: {
         code: 'CL024',
-        message: 'Ошибка при импорте клиентов',
+        message: 'Failed to import clients',
         httpCode: 400,
     },
     CLIENT_FILTERS_VALUES_FETCH_FAILED: {
@@ -173,6 +178,7 @@ export const ERRORS = {
     CLIENT_MARKING_NOT_DELETED: { code: 'CL028', message: 'Client marking not deleted', httpCode: 500 },
     CLIENT_MARKING_ALREADY_EXISTS: { code: 'CL029', message: 'Client marking already exists', httpCode: 409 },
     CLIENT_MARKING_NOT_UPDATED: { code: 'CL030', message: 'Client marking not updated', httpCode: 500 },
+    CLIENT_MARKING_FETCH_FAILED: { code: 'CL044', message: 'Error when retrieving client marking', httpCode: 500 },
     CLIENT_HAS_TRANSACTIONS: { code: 'CL031', message: 'Client has transactions', httpCode: 400 },
     CLIENT_DEBT_LIST_FETCH_FAILED: { code: 'CL032', message: 'Failed to get client debt list', httpCode: 500 },
     CLIENT_OVERDUE_STATUS_FETCH_FAILED: { code: 'CL033', message: 'Failed to get client overdue status', httpCode: 500 },
@@ -263,6 +269,12 @@ export const ERRORS = {
     CONSIGNMENT_IMPORT_TOO_MANY_ROWS: { code: 'CON024', message: 'Too many rows for this import mode', httpCode: 400 },
     CONSIGNMENT_PRODUCT_UPDATE_SCHEMA_NOT_FOUND: { code: 'CON025', message: 'Update schema not found', httpCode: 404 },
     CONSIGNMENT_PRODUCT_UPDATE_SCHEMA_NO_HEADERS_MATCHED: { code: 'CON026', message: 'No schema headers matched the file', httpCode: 400 },
+    CONSIGNMENT_PRODUCT_UPDATE_NOT_IN_CONSIGNMENT: {
+        code: 'CON027',
+        message: 'Product does not belong to this consignment',
+        httpCode: 400,
+    },
+    CONSIGNMENT_PRODUCT_UPDATE_ITEM_FAILED: { code: 'CON028', message: 'Product update failed', httpCode: 400 },
 
     // CONSIGNMENT-IMPORT-SCHEME
     CONSIGNMENT_IMPORT_SCHEME_NOT_CREATED: { code: 'CS001', message: 'Failed to create consignment import scheme', httpCode: 500 },
@@ -409,6 +421,9 @@ export const ERRORS = {
         message: 'Delivery information will be transferred to the target order.',
         httpCode: 400,
     },
+    ORDER_MERGE_TARGET_IN_SOURCE_LIST: { code: 'O036', message: 'Target order must not be in source list', httpCode: 400 },
+    ORDER_INVOICE_NOTIFICATION_INVALID_TYPE: { code: 'O037', message: 'Invalid notification type', httpCode: 400 },
+    ORDER_INVOICE_NOTIFICATION_ORDER_UUID_MISSING: { code: 'O038', message: 'Order UUID missing in payload', httpCode: 400 },
 
     //SERVICE
     SERVICE_NOT_CREATED: { code: 'SV001', message: 'Failed to create service', httpCode: 500 },
@@ -518,6 +533,11 @@ export const ERRORS = {
         message: 'Order product not found in the order',
         httpCode: 404,
     },
+    ORDER_PRODUCT_MOVE_SAME_ORDER: {
+        code: 'OP025',
+        message: 'Source and destination orders must differ',
+        httpCode: 400,
+    },
 
     //TRANSACTION
     TRANSACTION_NOT_CREATED: { code: 'TR001', message: 'Failed to transaction product', httpCode: 500 },
@@ -533,7 +553,7 @@ export const ERRORS = {
     TRANSACTION_NOT_APPLIED: { code: 'TR011', message: 'Transaction not applied', httpCode: 500 },
     MONEY_ACCOUNT_REQUIRED: { code: 'TR012', message: 'moneyAccountUUID is required to apply bank payment event', httpCode: 400 },
     TRANSACTION_CREATE_FAILED: { code: 'TR013', message: 'Failed to create transaction', httpCode: 500 },
-    TRANSACTION_IMPORT_FAILED: { code: 'TR014', message: 'Ошибка при импорте транзакций', httpCode: 400 },
+    TRANSACTION_IMPORT_FAILED: { code: 'TR014', message: 'Failed to import transactions', httpCode: 400 },
     TRANSACTION_IMPORT_TOO_MANY_ROWS: { code: 'TR015', message: 'Too many rows for transaction import', httpCode: 400 },
     TRANSACTION_IMPORT_INVALID_FILE_FORMAT: { code: 'TR016', message: 'Invalid file format for transaction import', httpCode: 400 },
     TRANSACTION_IMPORT_MISSING_REQUIRED_COLUMNS: {
@@ -590,6 +610,13 @@ export const ERRORS = {
         httpCode: 500,
     },
 
+    // COMMON (transport-level codes the catch-all HttpExceptionFilter emits for non-business failures)
+    COMMON_NO_DATA_RETURNED: { code: 'E900', message: 'No data returned', httpCode: 500 },
+    COMMON_UNKNOWN_ERROR: { code: 'E901', message: 'Unknown error', httpCode: 500 },
+    COMMON_VALIDATION_FAILED: { code: 'E902', message: 'Validation failed', httpCode: 400 },
+    COMMON_UNAUTHORIZED: { code: 'E903', message: 'Unauthorized', httpCode: 401 },
+    COMMON_BAD_REQUEST: { code: 'E904', message: 'Bad request', httpCode: 400 },
+
     // EXCEL
     EXCEL_CREATE_FAILED: { code: 'E001', message: 'Failed to create excel', httpCode: 500 },
     EXCEL_GET_DATA_BY_BUFFER_FAILED: { code: 'E002', message: 'Failed to get buffer', httpCode: 500 },
@@ -602,6 +629,7 @@ export const ERRORS = {
     CATEGORY_NOT_DELETED: { code: 'CA011', message: 'Failed to delete category', httpCode: 500 },
     CATEGORY_NOT_GET_BY_UUID: { code: 'CA012', message: 'Failed to get category by uuid', httpCode: 500 },
     CATEGORY_FETCH_FAILED: { code: 'CA013', message: 'Error when retrieving a list of categories', httpCode: 500 },
+    CATEGORY_NOT_DETERMINED: { code: 'CA019', message: 'Could not determine category for product', httpCode: 400 },
     CATEGORY_NOT_UPDATED: { code: 'CA014', message: 'Failed to update category', httpCode: 500 },
     CATEGORY_CREATE_MANY_FAILED: { code: 'CA015', message: 'Failed to create many categories', httpCode: 500 },
     CATEGORY_USE_IN_PRODUCT: { code: 'CA016', message: 'Category use in product', httpCode: 500 },
@@ -642,16 +670,16 @@ export const ERRORS = {
     FILE_NOT_SUPPORTED: { code: 'F006', message: 'File not supported', httpCode: 400 },
     FILE_TOO_LARGE: { code: 'F007', message: 'File size exceeds the allowed limit', httpCode: 413 },
     FILE_UPLOAD_FAILED: { code: 'F008', message: 'File upload failed', httpCode: 400 },
-    FILE_S3_FORBIDDEN: { code: 'F007', message: 'File S3 forbidden', httpCode: 403 },
+    FILE_S3_FORBIDDEN: { code: 'F009', message: 'File S3 forbidden', httpCode: 403 },
 
     //WHATSAPP
-    WHATSAPP_TEXT_NOT_SENT: { code: 'W001', message: 'Failed to send text message', httpCode: 500 },
-    WHATSAPP_FILE_NOT_SENT: { code: 'W002', message: 'Failed to send file message', httpCode: 500 },
-    WHATSAPP_FETCH_FAILED_NOTIFICATIONS: { code: 'W003', message: 'Failed to fetch notifications', httpCode: 500 },
-    WHATSAPP_PHONE_NOT_FOUND: { code: 'W004', message: 'Phone number not found or invalid', httpCode: 400 },
-    WHATSAPP_STATUS_CHECK_FAILED: { code: 'W005', message: 'Failed to check WhatsApp message status', httpCode: 500 },
-    WHATSAPP_MESSAGE_NOT_FOUND: { code: 'W006', message: 'Message not found in notification', httpCode: 400 },
-    WHATSAPP_CHANNEL_NOT_IN_USE: { code: 'W007', message: 'WhatsApp channel is not in use', httpCode: 410 },
+    WHATSAPP_TEXT_NOT_SENT: { code: 'WH001', message: 'Failed to send text message', httpCode: 500 },
+    WHATSAPP_FILE_NOT_SENT: { code: 'WH002', message: 'Failed to send file message', httpCode: 500 },
+    WHATSAPP_FETCH_FAILED_NOTIFICATIONS: { code: 'WH003', message: 'Failed to fetch notifications', httpCode: 500 },
+    WHATSAPP_PHONE_NOT_FOUND: { code: 'WH004', message: 'Phone number not found or invalid', httpCode: 400 },
+    WHATSAPP_STATUS_CHECK_FAILED: { code: 'WH005', message: 'Failed to check WhatsApp message status', httpCode: 500 },
+    WHATSAPP_MESSAGE_NOT_FOUND: { code: 'WH006', message: 'Message not found in notification', httpCode: 400 },
+    WHATSAPP_CHANNEL_NOT_IN_USE: { code: 'WH007', message: 'WhatsApp channel is not in use', httpCode: 410 },
 
     //MAX MESSENGER
     MAX_MESSENGER_TEXT_NOT_SENT: { code: 'MX001', message: 'Failed to send text message via Max Messenger', httpCode: 500 },
@@ -719,7 +747,7 @@ export const ERRORS = {
     //PRE ORDER
     PRE_ORDER_NOT_CREATED: { code: 'PO001', message: 'Failed to create pre order', httpCode: 500 },
     PRE_ORDER_NOT_DELETED: { code: 'PO002', message: 'Failed to delete pre order', httpCode: 500 },
-    PRE_ORDER_MANY_NOT_DELETED: { code: 'PO002', message: 'Failed to delete pre orders', httpCode: 500 },
+    PRE_ORDER_MANY_NOT_DELETED: { code: 'PO036', message: 'Failed to delete pre orders', httpCode: 500 },
     PRE_ORDER_NOT_UPDATED: { code: 'PO003', message: 'Failed to update pre order', httpCode: 500 },
     PRE_ORDER_NOT_FOUND: { code: 'PO004', message: 'The pre order with the specified UUID was not found', httpCode: 404 },
     PRE_ORDER_FETCH_FAILED: { code: 'PO006', message: 'Error when retrieving a list of pre orders', httpCode: 500 },
@@ -778,11 +806,74 @@ export const ERRORS = {
         httpCode: 400,
     },
     PRE_ORDER_INVALID_COLLECTION: {
-        code: 'PO013',
+        code: 'PO037',
         message: 'Pre order invalid collection',
         httpCode: 400,
     },
 
+    // PRE ORDER — standing-order → pre-order conversion per-item warnings
+    PRE_ORDER_SO_ITEM_NOT_LINKED_TO_CATALOG: {
+        code: 'PO024',
+        message: 'Standing-order item is not linked to a STANDING_ORDER_CATALOG item; matching is impossible',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_ITEM_NO_MATCHES: {
+        code: 'PO025',
+        message: 'No matches found in the available collections for the catalog item',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_ITEM_INSUFFICIENT_QUANTITY: {
+        code: 'PO026',
+        message: 'Insufficient available quantity in collections for the catalog item; item added partially or not added',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_ITEM_PARTIALLY_ALLOCATED: {
+        code: 'PO027',
+        message: 'Not enough balance for the catalog item; part of the quantity was left unallocated',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_ITEM_NOT_ADDED_IN_COLLECTION: {
+        code: 'PO028',
+        message: 'Standing-order item was not added to the pre-order for this collection because no match was found in this collection',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_PRODUCT_NOT_CREATED: {
+        code: 'PO029',
+        message: 'Failed to create pre-order product from standing-order item',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_CRITICAL_ERROR: {
+        code: 'PO030',
+        message: 'Critical error during pre-order creation from standing order',
+        httpCode: 400,
+    },
+    PRE_ORDER_SO_NO_PRE_ORDERS_CREATED: {
+        code: 'PO031',
+        message: 'No pre-orders were created for this standing order: no matching items found in the selected collections',
+        httpCode: 400,
+    },
+    // PRE ORDER — copy pre-order per-item warnings
+    PRE_ORDER_COPY_ITEM_NO_MATCHES: {
+        code: 'PO032',
+        message: 'No matches found in the target collection for the item',
+        httpCode: 400,
+    },
+    PRE_ORDER_COPY_ITEM_INSUFFICIENT_QUANTITY: {
+        code: 'PO033',
+        message: 'Insufficient balance for the item; part of the quantity was left unallocated',
+        httpCode: 400,
+    },
+    PRE_ORDER_COPY_SOURCE_NOT_FOUND_OR_EMPTY: {
+        code: 'PO034',
+        message: 'Source pre-order not found or contains no products',
+        httpCode: 400,
+    },
+    PRE_ORDER_COPY_PRODUCT_CREATE_FAILED: {
+        code: 'PO035',
+        message: 'Failed to create product during pre-order copy',
+        httpCode: 400,
+    },
+
     //PRE ORDER PRODUCT
     PRE_ORDER_PRODUCT_NOT_CREATED: { code: 'POP001', message: 'Failed to create pre order product', httpCode: 500 },
     PRE_ORDER_PRODUCT_NOT_DELETED: { code: 'POP002', message: 'Failed to delete pre order product', httpCode: 500 },
@@ -982,6 +1073,11 @@ export const ERRORS = {
         message: 'Missing required columns in pre order collection item import file',
         httpCode: 400,
     },
+    PRE_ORDER_COLLECTION_ITEM_UPDATE_BATCH_TOO_LARGE: {
+        code: 'POCI028',
+        message: 'Batch size too large',
+        httpCode: 400,
+    },
 
     // EMPLOYEE SCHEDULE
     EMPLOYEE_SCHEDULE_NOT_CREATED: { code: 'ES001', message: 'Failed to create employee schedule', httpCode: 500 },
@@ -1101,6 +1197,9 @@ export const ERRORS = {
 
     NOT_IMPLEMENTED: { code: 'G001', message: 'Not implemented', httpCode: 501 },
 
+    // Neutral 2xx success — lets the frontend localize a success body by code instead of raw text
+    OPERATION_SUCCESS: { code: 'OK001', message: 'Operation completed successfully', httpCode: 200 },
+
     // SESSION
     SESSION_NOT_FOUND: { code: 'SES001', message: 'Session not found', httpCode: 401 },
     SESSION_REVOKED: { code: 'SES002', message: 'Session has been revoked', httpCode: 401 },
@@ -1154,6 +1253,11 @@ export const ERRORS = {
     PUBLIC_ACCOUNT_DELETION_INVALID_CODE: { code: 'ADR009', message: 'Invalid or expired verification code', httpCode: 400 },
     PUBLIC_ACCOUNT_DELETION_INVALID_TOKEN: { code: 'ADR010', message: 'Invalid or expired verification token', httpCode: 400 },
     PUBLIC_ACCOUNT_DELETION_NO_TENANTS_SELECTED: { code: 'ADR011', message: 'No valid tenants selected for deletion', httpCode: 400 },
+    ACCOUNT_DELETION_REQUEST_SUBMITTED: {
+        code: 'ADR012',
+        message: 'If the account exists, a verification code has been sent',
+        httpCode: 200,
+    },
 
     // MOYSKLAD INTEGRATION
     MOYSKLAD_INVALID_TOKEN: { code: 'MS001', message: 'MoySklad token is invalid or has insufficient permissions', httpCode: 400 },

package/constant/index.ts

@@ -2,3 +2,5 @@ export * from './error';
 export * from './verbose';
 export * from './error-i18n-key';
 export * from './import.constant';
+export * from './validation-i18n-key';
+export * from './validation-i18n-message';

package/constant/validation-i18n-key.ts

@@ -0,0 +1,38 @@
+/**
+ * Stable i18n tokens for Zod validation messages.
+ *
+ * The global ZodValidationPipe surfaces a schema's `message` verbatim to the client with no error
+ * code, so raw English/Russian prose there is not localizable. Use these dot-notation tokens as the
+ * Zod `message` instead — the frontend maps the token to a localized string. The token itself is the
+ * stable contract; the English text lives only in the frontend dictionary.
+ */
+export const ValidationI18nKey = {
+    dateRange: 'validation.dateRange',
+    reportPeriodMax: 'validation.reportPeriodMax',
+    emailOrPhoneRequired: 'validation.emailOrPhoneRequired',
+    allowedRoles: 'validation.allowedRoles',
+    statusNotAllowedWebshop: 'validation.statusNotAllowedWebshop',
+    targetOrderInList: 'validation.targetOrderInList',
+    productListOrConsignment: 'validation.productListOrConsignment',
+    consignmentOrProducts: 'validation.consignmentOrProducts',
+    rejectionReasonRequired: 'validation.rejectionReasonRequired',
+    targetOrNewConsignment: 'validation.targetOrNewConsignment',
+    serviceOrNamePrice: 'validation.serviceOrNamePrice',
+    quantityPositive: 'validation.quantityPositive',
+    nameRequired: 'validation.nameRequired',
+    categoryRequired: 'validation.categoryRequired',
+    quantityRequired: 'validation.quantityRequired',
+    atLeastOneItem: 'validation.atLeastOneItem',
+    atLeastOneClient: 'validation.atLeastOneClient',
+    fieldRequired: 'validation.fieldRequired',
+    phoneFormat: 'validation.phoneFormat',
+    emailFormat: 'validation.emailFormat',
+    dateFormat: 'validation.dateFormat',
+    invalidClientType: 'validation.invalidClientType',
+    standingOrderClientNameRequired: 'validation.standingOrderClientNameRequired',
+    standingOrderCategoryRequired: 'validation.standingOrderCategoryRequired',
+    standingOrderNameRequired: 'validation.standingOrderNameRequired',
+    standingOrderQuantityRequired: 'validation.standingOrderQuantityRequired',
+} as const;
+
+export type ValidationI18nKeyType = (typeof ValidationI18nKey)[keyof typeof ValidationI18nKey];

package/constant/validation-i18n-message.ts

@@ -0,0 +1,46 @@
+import { ValidationI18nKey, ValidationI18nKeyType } from './validation-i18n-key';
+
+/**
+ * English fallback text for every stable Zod validation token (see validation-i18n-key.ts).
+ *
+ * The global ZodValidationPipe puts the token into an issue's `message`. The catch-all
+ * HttpExceptionFilter detects that a message is a token and, using this map, moves the token to the
+ * `i18nKey` field while replacing `message` with the EN text below. The frontend localizes off
+ * `i18nKey`; `message` is only the human-readable fallback (see api-error.schema.ts).
+ *
+ * Every token in ValidationI18nKey MUST have an entry here (enforced by the Record type).
+ */
+export const VALIDATION_I18N_MESSAGE: Record<ValidationI18nKeyType, string> = {
+    [ValidationI18nKey.dateRange]: 'Start date must be before or equal to end date',
+    [ValidationI18nKey.reportPeriodMax]: 'The selected period exceeds the maximum allowed range',
+    [ValidationI18nKey.emailOrPhoneRequired]: 'Either email or phone is required',
+    [ValidationI18nKey.allowedRoles]: 'The specified role is not allowed',
+    [ValidationI18nKey.statusNotAllowedWebshop]: 'This status is not allowed in the webshop',
+    [ValidationI18nKey.targetOrderInList]: 'The target order must not be included in the source order list',
+    [ValidationI18nKey.productListOrConsignment]: 'Either a product list or a consignment must be provided',
+    [ValidationI18nKey.consignmentOrProducts]: 'Either a consignment or products must be provided',
+    [ValidationI18nKey.rejectionReasonRequired]: 'A rejection reason is required',
+    [ValidationI18nKey.targetOrNewConsignment]: 'Either a target consignment or a new consignment must be provided',
+    [ValidationI18nKey.serviceOrNamePrice]: 'Either a service or a name and price must be provided',
+    [ValidationI18nKey.quantityPositive]: 'Quantity must be a positive number',
+    [ValidationI18nKey.nameRequired]: 'Name is required',
+    [ValidationI18nKey.categoryRequired]: 'Category is required',
+    [ValidationI18nKey.quantityRequired]: 'Quantity is required',
+    [ValidationI18nKey.atLeastOneItem]: 'At least one item is required',
+    [ValidationI18nKey.atLeastOneClient]: 'At least one client is required',
+    [ValidationI18nKey.fieldRequired]: 'This field is required',
+    [ValidationI18nKey.phoneFormat]: 'Invalid phone number format',
+    [ValidationI18nKey.emailFormat]: 'Invalid email format',
+    [ValidationI18nKey.dateFormat]: 'Invalid date format',
+    [ValidationI18nKey.invalidClientType]: 'Invalid client type',
+    [ValidationI18nKey.standingOrderClientNameRequired]: 'Client name is required',
+    [ValidationI18nKey.standingOrderCategoryRequired]: 'Category is required',
+    [ValidationI18nKey.standingOrderNameRequired]: 'Name is required',
+    [ValidationI18nKey.standingOrderQuantityRequired]: 'Quantity is required',
+};
+
+/**
+ * A validation `message` is a stable i18n token when it matches this pattern (e.g. `validation.dateRange`).
+ * Anything else is a custom Zod message that stays in `message` with no `i18nKey`.
+ */
+export const VALIDATION_I18N_TOKEN_PATTERN = /^validation\.[A-Za-z0-9.]+$/;

package/constant/verbose.ts

@@ -1,20 +1,21 @@
+// Success messages: `message` is the EN fallback, the frontend localizes by `code` (same model as ERRORS).
 export const VERBOSE = {
-    USER_SUCCESSFULLY_CREATED: { code: 'SM001', message: 'Пользователь успешно зарегистрирован' },
+    USER_SUCCESSFULLY_CREATED: { code: 'SM001', message: 'User registered successfully' },
     EMAIL_VERIFICATION_SEND: {
         code: 'SM002',
-        message: 'Подтверждение адреса электронной почти отправлено успешно! Проверьте свой почтовый ящик.',
+        message: 'Email verification sent successfully! Check your inbox.',
     },
-    EMAIL_VERIFICATION_SUCCESS: { code: 'SM003', message: 'Подтверждение почты прошло успешно!' },
-    PASSWORD_SUCCESSFULLY_SET: { code: 'SM004', message: 'Пароль пользователя успешно установлен!' },
+    EMAIL_VERIFICATION_SUCCESS: { code: 'SM003', message: 'Email verified successfully!' },
+    PASSWORD_SUCCESSFULLY_SET: { code: 'SM004', message: 'User password set successfully!' },
     PASSWORD_SUCCESSFULLY_RESTORED: {
         code: 'SM005',
-        message: 'Вам на почту выслано письмо с подтверждением сброса пароля. Проверьте свой почтовый ящик!',
+        message: 'A password reset confirmation email has been sent to you. Check your inbox!',
     },
-    PASSWORD_SUCCESSFULLY_RESET: { code: 'SM006', message: 'Пароль успешно сброшен' },
-    CABINET_SUCCESSFULLY_UPDATED: { code: 'SM007', message: 'Кабинет успешно обновлён' },
-    PROJECT_SUCCESSFULLY_CREATED: { code: 'SM008', message: 'Проект успешно создан.' },
-    PROJECT_SUCCESSFULLY_UPDATED: { code: 'SM009', message: 'Проект успешно обновлён.' },
+    PASSWORD_SUCCESSFULLY_RESET: { code: 'SM006', message: 'Password reset successfully' },
+    CABINET_SUCCESSFULLY_UPDATED: { code: 'SM007', message: 'Cabinet updated successfully' },
+    PROJECT_SUCCESSFULLY_CREATED: { code: 'SM008', message: 'Project created successfully.' },
+    PROJECT_SUCCESSFULLY_UPDATED: { code: 'SM009', message: 'Project updated successfully.' },
 
     // SMS GATEWAY
-    SMS_SUCCESSFULLY_SENT: { code: 'SM010', message: 'SMS сообщение успешно отправлено' },
+    SMS_SUCCESSFULLY_SENT: { code: 'SM010', message: 'SMS message sent successfully' },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.95",
+    "version": "1.2.97",
     "description": "",
     "main": "./build/index.js",
     "scripts": {

package/schemas/api-error.schema.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+
+// Per-field issue of a VALIDATION error (Zod): `path` addresses the offending field.
+// `i18nKey` is the stable token the frontend translates; it is set only when the schema used a
+// registered `validation.*` token as its Zod message (see validation-i18n-key.ts). In that case
+// `message` carries the EN fallback text from VALIDATION_I18N_MESSAGE. For custom Zod messages that
+// are not tokens, `i18nKey` is omitted and `message` holds the raw Zod string as-is.
+export const ApiErrorValidationIssueSchema = z.object({
+    path: z.array(z.union([z.string(), z.number()])),
+    message: z.string(),
+    i18nKey: z.string().optional(),
+});
+
+/**
+ * Unified HTTP error envelope: every non-2xx response of the API has exactly this shape
+ * (enforced by the catch-all HttpExceptionFilter on the backend).
+ *
+ * - `errorCode` — a code from ERRORS (business) or ApiGenericErrorCodeEnum (validation/transport);
+ *   the frontend maps it to a localized text, `message` is only the EN fallback.
+ * - `errors` — present only when `errorCode` is VALIDATION (per-field issues).
+ * - `data` — optional machine-readable payload attached by business errors.
+ */
+export const ApiErrorSchema = z.object({
+    statusCode: z.number().int(),
+    errorCode: z.string(),
+    message: z.string(),
+    timestamp: z.string(),
+    path: z.string(),
+    errors: z.array(ApiErrorValidationIssueSchema).optional(),
+    data: z.unknown().optional(),
+});
+
+export type ApiErrorValidationIssue = z.infer<typeof ApiErrorValidationIssueSchema>;
+export type ApiError = z.infer<typeof ApiErrorSchema>;

package/schemas/consignment-transfer/accept-consignment-transfer.schema.ts

@@ -23,7 +23,7 @@ export const AcceptConsignmentTransferRequestSchema = z
             .min(1),
     })
     .refine(data => Boolean(data.targetConsignmentUUID) !== Boolean(data.newConsignment), {
-        message: 'Provide either targetConsignmentUUID or newConsignment, not both',
+        message: 'validation.targetOrNewConsignment',
         path: ['targetConsignmentUUID'],
     });
 

package/schemas/index.ts

@@ -67,4 +67,5 @@ export * from './messenger-profile';
 export * from './error-message.schema';
 export * from './account-deletion-request/account-deletion-request.schema';
 export * from './consignment-transfer';
+export * from './api-error.schema';
 export * from './access-policy';

package/schemas/order-service-line/order-service-line.schema.ts

@@ -28,7 +28,7 @@ export const CreateOrderServiceLineRequestSchema = z
         comment: z.string().max(1000).optional(),
     })
     .refine(data => data.serviceUUID || (data.name && data.price !== undefined), {
-        message: 'Either serviceUUID or both name and price must be provided',
+        message: 'validation.serviceOrNamePrice',
     });
 
 export const UpdateOrderServiceLineRequestSchema = z.object({

package/schemas/pre-order/pre-order-copy.schema.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { PreOrderWithClientSchema } from './pre-order.schema';
 import { PreOrderProductExtendedSchema } from '../pre-order-product/pre-order-product.schema';
 import { PreOrderCollectionItemSchema } from '../pre-order-collection-item/pre-order-collection-item.schema';
+import { ErrorMessageSchema } from '../error-message.schema';
 
 export const CopyAnalysisMatchSchema = z.object({
     collectionItem: PreOrderCollectionItemSchema,
@@ -17,5 +18,5 @@ export const CopyAnalysisMappingSchema = z.object({
 export const CopyAnalysisSchema = z.object({
     preOrder: PreOrderWithClientSchema,
     mappings: z.record(z.string(), CopyAnalysisMappingSchema),
-    warnings: z.record(z.string(), z.array(z.string())),
+    warnings: z.record(z.string(), z.array(ErrorMessageSchema)),
 });

package/schemas/settings/settings.schema.ts

@@ -91,6 +91,7 @@ export const SettingsSchema = z.object({
     importantMessage: ImportantMessageSchema.nullable(),
     deliveryPricingEnabled: z.boolean(),
     deliveryPricingTiers: z.array(DeliveryPricingTierSchema).nullable(),
+    employeeClientScopeEnabled: z.boolean(),
     telegramStaffBotName: z.string().nullable().optional(),
 });
 
@@ -244,6 +245,7 @@ export const UpdateSettingsRequestSchema = z.object({
     importantMessage: ImportantMessageSchema.nullable().optional(),
     deliveryPricingEnabled: z.coerce.boolean().optional(),
     deliveryPricingTiers: z.array(DeliveryPricingTierSchema).nullable().optional(),
+    employeeClientScopeEnabled: z.coerce.boolean().optional(),
     // post terminal settings
     vatTag: z.string().nullable().optional(),
     taxMode: z.string().nullable().optional(),