@dxtmisha/wiki 0.59.0 → 0.64.0

package/src/media/functional/functional/composables/useApiPost/useApiPost.vi.mdx

@@ -1,34 +1,39 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional/Composables/useApiPost - Thực hiện yêu cầu POST'/>
+<Meta title='@dxtmisha/vi/functional/Composables/useApiPost - POST Request Execution'/>
 
 # `useApiPost`
 
-Trả về một đối tượng với trạng thái tải và phương thức `send` để thực hiện các yêu cầu API `POST`.
+Trả về một đối tượng với trạng thái tải và phương thức `send` để thực hiện các yêu cầu API `POST`. Đây là một trình bao bọc tiện lợi trên `useApiRequest` được điền sẵn phương thức `POST`. Nhận các thiết lập dưới dạng một đối tượng `UseApiPostSetup` duy nhất.
 
 **Tham số:**
-- `path?: RefOrNormal<string | undefined>` — Đường dẫn đến endpoint API (có thể phản ứng).
-- `action?: (data: Return | undefined) => Promise<void> | void` — Hành động (callback) thực hiện sau khi yêu cầu hoàn tất thành công.
-- `transformation?: (data: T) => Return` — Hàm chuyển đổi dữ liệu phản hồi từ máy chủ trước khi trả về hoặc truyền vào `action`.
-- `toData: boolean = true` — Việc trích xuất trường `data` từ phản hồi hay không.
-- `options?: ApiOptions` — Các tùy chọn bổ sung cho yêu cầu (đối tượng tham số `ApiFetch`).
-- `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
-
-**Giá trị trả về:**
+- `setup: UseApiPostSetup` — Đối tượng thiết lập cấu hình:
+  - `path?: RefOrNormal<string | undefined>` — Đường dẫn đến endpoint API (có thể phản ứng).
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Hành động (callback) thực hiện sau khi yêu cầu hoàn tất thành công.
+  - `transformation?: (data: T) => Return` — Hàm chuyển đổi dữ liệu phản hồi từ máy chủ trước khi trả về hoặc truyền vào `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Hàm xác thực hợp đồng yêu cầu.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Hàm xác thực hợp đồng phản hồi.
+  - `errorContract?: ApiErrorStorageList` — nơi lưu trữ hợp đồng lỗi phản hồi.
+  - `toData?: boolean` — Việc trích xuất trường `data` từ phản hồi hay không. Mặc định: `true`.
+  - `options?: ApiOptions` — Các tùy chọn bổ sung cho yêu cầu (đối tượng tham số `ApiFetch`).
+  - `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
+
+**Trả về:**
 Một đối tượng với các thuộc tính sau:
 - `loading: Ref<boolean>` — Trạng thái tải phản ứng. Sẽ là `true` trong khi yêu cầu đang thực hiện và `false` sau khi hoàn thành hoặc có lỗi.
-- `send(request?: Request): Promise<Return | undefined>` — Phương thức bất đồng bộ để gửi yêu cầu `POST`. Nó tự động quản lý trạng thái `loading`, áp dụng hàm biến đổi cho phản hồi, thực hiện callback `action` khi thành công và xử lý lỗi một cách an toàn bằng cách ghi log ra console.
+- `send(request?: Request): Promise<Return | undefined>` — Phương thức bất đồng bộ để gửi yêu cầu `POST`. Nó tự động quản lý trạng thái `loading`, xác thực hợp đồng yêu cầu và phản hồi, áp dụng hàm biến đổi cho phản hồi, thực hiện callback `action` khi thành công và xử lý lỗi một cách an toàn bằng cách ghi log ra console.
 
 ```typescript
 import { useApiPost } from '@dxtmisha/functional'
 
-const { loading, send } = useApiPost(
-  '/api/submit',
-  (data) => console.log('Hành động hoàn tất:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiPost({
+  path: '/api/submit',
+  action: (data) => console.log('Hành động hoàn tất:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  toData: true,
+  options: { cache: false }
+})
 
 const handleSubmit = async () => {
   const result = await send({ name: 'User' })

package/src/media/functional/functional/composables/useApiPut/useApiPut.en.mdx

@@ -4,34 +4,39 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiPut`
 
-Returns an object with a loading state and a `send` method for executing API `PUT` requests.
+Returns an object with a loading state and a `send` method for executing API `PUT` requests. It is a convenient wrapper over `useApiRequest` that pre-fills the `PUT` method. Accepts settings as a single `UseApiPutSetup` object.
 
 **Parameters:**
-- `path?: RefOrNormal<string | undefined>` — Path to the API endpoint (can be reactive).
-- `action?: (data: Return | undefined) => Promise<void> | void` — Callback action to perform after the request completes successfully.
-- `transformation?: (data: T) => Return` — Function to transform the response data before it is returned or passed to the `action`.
-- `toData: boolean = true` — Whether to extract the `data` field from the response.
-- `options?: ApiOptions` — Additional request options (`ApiFetch` object parameter).
-- `apiInstance?: ApiInstance` — API instance to use for the request. Defaults to `Api.getItem()`.
+- `setup: UseApiPutSetup` — Configuration setup object:
+  - `path?: RefOrNormal<string | undefined>` — Path to the API endpoint (can be reactive).
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Callback action to perform after the request completes successfully.
+  - `transformation?: (data: T) => Return` — Function to transform the response data before it is returned or passed to the `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Request contract validation function.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Response contract validation function.
+  - `errorContract?: ApiErrorStorageList` — storage of response error contracts.
+  - `toData?: boolean` — Whether to extract the `data` field from the response. Defaults to `true`.
+  - `options?: ApiOptions` — Additional request options (`ApiFetch` object parameter).
+  - `apiInstance?: ApiInstance` — API instance to use for the request. Defaults to `Api.getItem()`.
 
 **Returns:**
 An object with the following properties:
 - `loading: Ref<boolean>` — Reactive loading state. It becomes `true` while the request is in progress and `false` after it completes or fails.
-- `send(request?: Request): Promise<Return | undefined>` — An asynchronous method for sending the `PUT` request. It automatically manages the `loading` state, applies the transformation function to the response, executes the `action` callback on success, and safely handles errors by logging them to the console.
+- `send(request?: Request): Promise<Return | undefined>` — An asynchronous method for sending the `PUT` request. It automatically manages the `loading` state, validates the request and response contracts, applies the transformation function to the response, executes the `action` callback on success, and safely handles errors by logging them to the console.
 
 ```typescript
 import { useApiPut } from '@dxtmisha/functional'
 
-const { loading, send } = useApiPut(
-  '/api/update',
-  (data) => console.log('Action complete:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
-
-const handleUpdate = async () => {
-  const result = await send({ id: 1, name: 'New Name' })
+const { loading, send } = useApiPut({
+  path: '/api/update',
+  action: (data) => console.log('Action complete:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  toData: true,
+  options: { cache: false }
+})
+
+const handleSubmit = async () => {
+  const result = await send({ id: 1, name: 'Updated User' })
   console.log('Final Result:', result)
 }
 ```

package/src/media/functional/functional/composables/useApiPut/useApiPut.ru.mdx

@@ -4,34 +4,39 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiPut`
 
-Возвращает объект с состоянием загрузки и методом `send` для выполнения `PUT`-запросов к API.
+Возвращает объект с состоянием загрузки и методом `send` для выполнения `PUT`-запросов к API. Является удобной оберткой над `useApiRequest` с предустановленным методом `PUT`. Принимает настройки в виде единого объекта `UseApiPutSetup`.
 
 **Параметры:**
-- `path?: RefOrNormal<string | undefined>` — Путь к endpoint API (может быть реактивным).
-- `action?: (data: Return | undefined) => Promise<void> | void` — Действие (коллбэк), выполняемое после успешного завершения запроса.
-- `transformation?: (data: T) => Return` — Функция трансформации ответа от сервера перед возвращением или передачей в `action`.
-- `toData: boolean = true` — Извлекать ли поле `data` из ответа.
-- `options?: ApiOptions` — Дополнительные опции запроса (объект параметров `ApiFetch`).
-- `apiInstance?: ApiInstance` — Экземпляр API, используемый для выполнения запроса. По умолчанию `Api.getItem()`.
+- `setup: UseApiPutSetup` — Объект настроек запроса:
+  - `path?: RefOrNormal<string | undefined>` — Путь к endpoint API (может быть реактивным).
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Действие (коллбэк), выполняемое после успешного завершения запроса.
+  - `transformation?: (data: T) => Return` — Функция трансформации ответа от сервера перед возвращением или передачей в `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Функция валидации контракта отправляемого запроса.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Функция валидации контракта полученного ответа.
+  - `errorContract?: ApiErrorStorageList` — хранилище контрактов ошибок ответа.
+  - `toData?: boolean` — Извлекать ли поле `data` из ответа. По умолчанию `true`.
+  - `options?: ApiOptions` — Дополнительные опции запроса (объект параметров `ApiFetch`).
+  - `apiInstance?: ApiInstance` — Экземпляр API, используемый для выполнения запроса. По умолчанию `Api.getItem()`.
 
 **Возвращает:**
 Объект со следующими свойствами:
 - `loading: Ref<boolean>` — Реактивное состояние загрузки. Принимает значение `true` во время выполнения запроса и `false` после его завершения или ошибки.
-- `send(request?: Request): Promise<Return | undefined>` — Асинхронный метод для отправки `PUT`-запроса. Он автоматически управляет состоянием `loading`, применяет функцию трансформации к ответу, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки.
+- `send(request?: Request): Promise<Return | undefined>` — Асинхронный метод для отправки `PUT`-запроса. Он автоматически управляет состоянием `loading`, проверяет контракты валидации запроса и ответа, применяет функцию трансформации к ответам, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки.
 
 ```typescript
 import { useApiPut } from '@dxtmisha/functional'
 
-const { loading, send } = useApiPut(
-  '/api/update',
-  (data) => console.log('Действие завершено:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
-
-const handleUpdate = async () => {
-  const result = await send({ id: 1, name: 'New Name' })
+const { loading, send } = useApiPut({
+  path: '/api/update',
+  action: (data) => console.log('Действие завершено:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  toData: true,
+  options: { cache: false }
+})
+
+const handleSubmit = async () => {
+  const result = await send({ id: 1, name: 'Updated User' })
   console.log('Итоговый результат:', result)
 }
 ```

package/src/media/functional/functional/composables/useApiPut/useApiPut.vi.mdx

@@ -1,37 +1,42 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional/Composables/useApiPut - Thực hiện yêu cầu PUT'/>
+<Meta title='@dxtmisha/vi/functional/Composables/useApiPut - PUT Request Execution'/>
 
 # `useApiPut`
 
-Trả về một đối tượng với trạng thái tải và phương thức `send` để thực hiện các yêu cầu API `PUT`.
+Trả về một đối tượng với trạng thái tải và phương thức `send` để thực hiện các yêu cầu API `PUT`. Đây là một trình bao bọc tiện lợi trên `useApiRequest` được điền sẵn phương thức `PUT`. Nhận các thiết lập dưới dạng một đối tượng `UseApiPutSetup` duy nhất.
 
 **Tham số:**
-- `path?: RefOrNormal<string | undefined>` — Đường dẫn đến endpoint API (có thể phản ứng).
-- `action?: (data: Return | undefined) => Promise<void> | void` — Hành động (callback) thực hiện sau khi yêu cầu hoàn tất thành công.
-- `transformation?: (data: T) => Return` — Hàm chuyển đổi dữ liệu phản hồi từ máy chủ trước khi trả về hoặc truyền vào `action`.
-- `toData: boolean = true` — Việc trích xuất trường `data` từ phản hồi hay không.
-- `options?: ApiOptions` — Các tùy chọn bổ sung cho yêu cầu (đối tượng tham số `ApiFetch`).
-- `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
-
-**Giá trị trả về:**
+- `setup: UseApiPutSetup` — Đối tượng thiết lập cấu hình:
+  - `path?: RefOrNormal<string | undefined>` — Đường dẫn đến endpoint API (có thể phản ứng).
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Hành động (callback) thực hiện sau khi yêu cầu hoàn tất thành công.
+  - `transformation?: (data: T) => Return` — Hàm chuyển đổi dữ liệu phản hồi từ máy chủ trước khi trả về hoặc truyền vào `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Hàm xác thực hợp đồng yêu cầu.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Hàm xác thực hợp đồng phản hồi.
+  - `errorContract?: ApiErrorStorageList` — nơi lưu trữ hợp đồng lỗi phản hồi.
+  - `toData?: boolean` — Việc trích xuất trường `data` từ phản hồi hay không. Mặc định: `true`.
+  - `options?: ApiOptions` — Các tùy chọn bổ sung cho yêu cầu (đối tượng tham số `ApiFetch`).
+  - `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
+
+**Trả về:**
 Một đối tượng với các thuộc tính sau:
 - `loading: Ref<boolean>` — Trạng thái tải phản ứng. Sẽ là `true` trong khi yêu cầu đang thực hiện và `false` sau khi hoàn thành hoặc có lỗi.
-- `send(request?: Request): Promise<Return | undefined>` — Phương thức bất đồng bộ để gửi yêu cầu `PUT`. Nó tự động quản lý trạng thái `loading`, áp dụng hàm biến đổi cho phản hồi, thực hiện callback `action` khi thành công và xử lý lỗi một cách an toàn bằng cách ghi log ra console.
+- `send(request?: Request): Promise<Return | undefined>` — Phương thức bất đồng bộ để gửi yêu cầu `PUT`. Nó tự động quản lý trạng thái `loading`, xác thực hợp đồng yêu cầu và phản hồi, áp dụng hàm biến đổi cho phản hồi, thực hiện callback `action` khi thành công và xử lý lỗi một cách an toàn bằng cách ghi log ra console.
 
 ```typescript
 import { useApiPut } from '@dxtmisha/functional'
 
-const { loading, send } = useApiPut(
-  '/api/update',
-  (data) => console.log('Hành động hoàn tất:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
-
-const handleUpdate = async () => {
-  const result = await send({ id: 1, name: 'New Name' })
+const { loading, send } = useApiPut({
+  path: '/api/update',
+  action: (data) => console.log('Hành động hoàn tất:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  toData: true,
+  options: { cache: false }
+})
+
+const handleSubmit = async () => {
+  const result = await send({ id: 1, name: 'Updated User' })
   console.log('Kết quả cuối cùng:', result)
 }
 ```

package/src/media/functional/functional/composables/useApiRef/useApiRef.en.mdx

@@ -15,6 +15,7 @@ A composable for working with API requests in Vue components. Returns reactive d
 - `conditions?: RefType<boolean>` — reactive execution condition. If `false` — the request is not made and data is cleared.
 - `transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>` — response transformation function applied before saving to `data`. Receives the contract validation result as the second argument.
 - `validateResponseContract?: (data: T) => ApiDataValidation` — function to validate the response data contract.
+- `errorContract?: ApiErrorStorageList` — storage of response error contracts.
 - `unmounted?: boolean` — if `true` (default), data is cleared and the watcher is stopped when the component unmounts. When `false`, `EffectScopeGlobal` is used for background persistence.
 - `apiInstance?: ApiInstance` — API instance to use for the request. Defaults to `Api.getItem()`.
 
@@ -25,6 +26,7 @@ Reactive states:
 - `item: Ref<ApiData<R> | undefined>` — Direct reference to data (Ref). Also initiates lazy initialization upon access.
 - `isResponseContractValid: ComputedRef<boolean>` — `true` if the response contract is valid (`success` status).
 - `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — the full contract validation result object.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — current error object if the request failed.
 - `starting: ComputedRef<boolean>` — Returns `true` if data has never been requested yet or is in the process of fetching the first portion of data (`data` is still `undefined`).
 - `loading: Ref<boolean>` — Returns `true` if any network request (initial or subsequent `reset`) is currently in progress.
 - `reading: Ref<boolean>` — A flag for an active data reading/processing process.

package/src/media/functional/functional/composables/useApiRef/useApiRef.ru.mdx

@@ -17,6 +17,7 @@ Composable для удобной работы с API-запросами во Vue
 - `conditions?: RefType<boolean>` — реактивное условие выполнения. Если `false` — запрос не выполняется, данные сбрасываются.
 - `transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>` — функция преобразования ответа перед сохранением в `data`. Получает вторым аргументом результат валидации контракта.
 - `validateResponseContract?: (data: T) => ApiDataValidation` — функция для проверки контракта данных ответа.
+- `errorContract?: ApiErrorStorageList` — хранилище контрактов ошибок ответа.
 - `unmounted?: boolean` — если `true` (по умолчанию), данные сбрасываются и watcher останавливается при размонтировании компонента. При `false` используется `EffectScopeGlobal` для фоновой работы.
 - `apiInstance?: ApiInstance` — Экземпляр API, используемый для выполнения запроса. По умолчанию `Api.getItem()`.
 
@@ -27,6 +28,7 @@ Composable для удобной работы с API-запросами во Vue
 - `item: Ref<ApiData<R> | undefined>` — Прямая ссылка на данные (Ref). Также инициирует ленивую инициализацию при доступе.
 - `isResponseContractValid: ComputedRef<boolean>` — `true`, если контракт ответа валиден (статус `success`).
 - `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — полный объект результата валидации контракта.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — текущий объект ошибки, если запрос не удался.
 - `starting: ComputedRef<boolean>` — Возвращает `true`, если данные еще ни разу не запрашивались или находятся в процессе получения первой порции данных (`data` еще `undefined`).
 - `loading: Ref<boolean>` — Возвращает `true`, если в данный момент выполняется любой сетевой запрос (первичный или последующий `reset`).
 - `reading: Ref<boolean>` — Флаг активного процесса чтения/обработки данных.

package/src/media/functional/functional/composables/useApiRef/useApiRef.vi.mdx

@@ -17,6 +17,7 @@ Composable để làm việc với các yêu cầu API trong Vue component. Tr
 - `conditions?: RefType<boolean>` — điều kiện thực thi phản ứng. Nếu `false` — yêu cầu không được thực hiện và dữ liệu bị xóa.
 - `transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>` — hàm chuyển đổi phản hồi trước khi lưu vào `data`. Nhận kết quả xác thực hợp đồng ở đối số thứ hai.
 - `validateResponseContract?: (data: T) => ApiDataValidation` — hàm xác thực hợp đồng dữ liệu phản hồi.
+- `errorContract?: ApiErrorStorageList` — nơi lưu trữ hợp đồng lỗi phản hồi.
 - `unmounted?: boolean` — nếu `true` (mặc định), dữ liệu bị xóa và watcher dừng lại khi component unmount. Khi `false`, `EffectScopeGlobal` được sử dụng để duy trì chạy nền.
 - `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
 
@@ -27,6 +28,7 @@ Trạng thái phản ứng:
 - `item: Ref<ApiData<R> | undefined>` — Tham chiếu trực tiếp đến dữ liệu (Ref). Cũng bắt đầu khởi tạo lười khi truy cập.
 - `isResponseContractValid: ComputedRef<boolean>` — `true` nếu hợp đồng phản hồi hợp lệ (trạng thái `success`).
 - `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — đối tượng kết quả xác thực hợp đồng đầy đủ.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — đối tượng lỗi hiện tại nếu yêu cầu thất bại.
 - `starting: ComputedRef<boolean>` — Trả về `true` nếu dữ liệu chưa bao giờ được yêu cầu hoặc đang trong quá trình lấy phần dữ liệu đầu tiên (`data` vẫn là `undefined`).
 - `loading: Ref<boolean>` — Trả về `true` nếu bất kỳ yêu cầu mạng nào (ban đầu hoặc `reset` sau đó) hiện đang được thực hiện.
 - `reading: Ref<boolean>` — Cờ cho quá trình đọc/xử lý dữ liệu đang hoạt động.

package/src/media/functional/functional/composables/useApiRequest/useApiRequest.en.mdx

@@ -4,21 +4,25 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiRequest`
 
-Returns an object with a loading state and a `send` method for executing API requests.
+Returns an object with a loading state and a `send` method for executing API requests. Accepts settings as a single `UseApiRequestSetup` object.
 
 **Parameters:**
-- `path?: RefOrNormal<string | undefined>` — Path to the API endpoint (can be reactive).
-- `method: ApiMethodItem = ApiMethodItem.post` — HTTP method to use for the request.
-- `action?: (data: Return | undefined) => Promise<void> | void` — Callback action to perform after the request completes successfully.
-- `transformation?: (data: T) => Return` — Function to transform the response data before it is returned or passed to the `action`.
-- `toData: boolean = true` — Whether to extract the `data` field from the response.
-- `options?: ApiOptions` — Additional request options (`ApiFetch` object parameter).
-- `apiInstance?: ApiInstance` — API instance to use for the request. Defaults to `Api.getItem()`.
+- `setup: UseApiRequestSetup` — Configuration setup object:
+  - `path?: RefOrNormal<string | undefined>` — Path to the API endpoint (can be reactive).
+  - `method?: ApiMethodItem` — HTTP method to use for the request. Defaults to `ApiMethodItem.post`.
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Callback action to perform after the request completes successfully.
+  - `transformation?: (data: T) => Return` — Function to transform the response data before it is returned or passed to the `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Request contract validation function.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Response contract validation function.
+  - `errorContract?: ApiErrorStorageList` — storage of response error contracts.
+  - `toData?: boolean` — Whether to extract the `data` field from the response. Defaults to `true`.
+  - `options?: ApiOptions` — Additional request options (`ApiFetch` object parameter).
+  - `apiInstance?: ApiInstance` — API instance to use for the request. Defaults to `Api.getItem()`.
 
 **Returns:**
 An object with the following properties:
 - `loading: Ref<boolean>` — Reactive loading state. It becomes `true` while the request is in progress and `false` after it completes or fails.
-- `send(request?: Request): Promise<Return | undefined>` — An asynchronous method for sending the request. It automatically manages the `loading` state, applies the transformation function to the response, executes the `action` callback on success, and handles errors safely by logging them to the console.
+- `send(request?: Request): Promise<Return | undefined>` — An asynchronous method for sending the request. It automatically manages the `loading` state, validates the request and response contracts, applies the transformation function to the response, executes the `action` callback on success, and handles errors safely by logging them to the console.
 
 ## ApiOptions Object
 
@@ -44,14 +48,16 @@ An object with the following properties:
 import { useApiRequest } from '@dxtmisha/functional'
 import { ApiMethodItem } from '@dxtmisha/functional-basic'
 
-const { loading, send } = useApiRequest(
-  '/api/submit',
-  ApiMethodItem.post,
-  (data) => console.log('Action complete:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiRequest({
+  path: '/api/submit',
+  method: ApiMethodItem.post,
+  action: (data) => console.log('Action complete:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  validateResponseContract: (res) => ({ success: true, ...res }),
+  toData: true,
+  options: { cache: false }
+})
 
 const handleSubmit = async () => {
   const result = await send({ name: 'User' })

package/src/media/functional/functional/composables/useApiRequest/useApiRequest.ru.mdx

@@ -4,21 +4,25 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiRequest`
 
-Возвращает объект с состоянием загрузки и методом `send` для выполнения запросов к API.
+Возвращает объект с состоянием загрузки и методом `send` для выполнения запросов к API. Принимает настройки в виде единого объекта `UseApiRequestSetup`.
 
 **Параметры:**
-- `path?: RefOrNormal<string | undefined>` — Путь к endpoint API (может быть реактивным).
-- `method: ApiMethodItem = ApiMethodItem.post` — HTTP метод для запроса.
-- `action?: (data: Return | undefined) => Promise<void> | void` — Действие (коллбэк), выполняемое после успешного завершения запроса.
-- `transformation?: (data: T) => Return` — Функция трансформации ответа от сервера перед возвращением или передачей в `action`.
-- `toData: boolean = true` — Извлекать ли поле `data` из ответа.
-- `options?: ApiOptions` — Дополнительные опции запроса (объект параметров `ApiFetch`).
-- `apiInstance?: ApiInstance` — Экземпляр API, используемый для выполнения запроса. По умолчанию `Api.getItem()`.
+- `setup: UseApiRequestSetup` — Объект настроек запроса:
+  - `path?: RefOrNormal<string | undefined>` — Путь к endpoint API (может быть реактивным).
+  - `method?: ApiMethodItem` — HTTP метод для запроса. По умолчанию `ApiMethodItem.post`.
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Действие (коллбэк), выполняемое после успешного завершения запроса.
+  - `transformation?: (data: T) => Return` — Функция трансформации ответа от сервера перед возвращением или передачей в `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Функция валидации контракта отправляемого запроса.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Функция валидации контракта полученного ответа.
+  - `errorContract?: ApiErrorStorageList` — хранилище контрактов ошибок ответа.
+  - `toData?: boolean` — Извлекать ли поле `data` из ответа. По умолчанию `true`.
+  - `options?: ApiOptions` — Дополнительные опции запроса (объект параметров `ApiFetch`).
+  - `apiInstance?: ApiInstance` — Экземпляр API, используемый для выполнения запроса. По умолчанию `Api.getItem()`.
 
 **Возвращает:**
 Объект со следующими свойствами:
 - `loading: Ref<boolean>` — Реактивное состояние загрузки. Принимает значение `true` во время выполнения запроса и `false` после его завершения или ошибки.
-- `send(request?: Request): Promise<Return | undefined>` — Асинхронный метод для отправки запроса. Он автоматически управляет состоянием `loading`, применяет функцию трансформации к ответу, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки, выводя их в консоль.
+- `send(request?: Request): Promise<Return | undefined>` — Асинхронный метод для отправки запроса. Он автоматически управляет состоянием `loading`, проверяет контракты валидации запроса и ответа, применяет функцию трансформации к ответу, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки, выводя их в консоль.
 
 ## Объект ApiOptions
 
@@ -44,14 +48,16 @@ import { Meta } from '@storybook/addon-docs/blocks'
 import { useApiRequest } from '@dxtmisha/functional'
 import { ApiMethodItem } from '@dxtmisha/functional-basic'
 
-const { loading, send } = useApiRequest(
-  '/api/submit',
-  ApiMethodItem.post,
-  (data) => console.log('Действие завершено:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiRequest({
+  path: '/api/submit',
+  method: ApiMethodItem.post,
+  action: (data) => console.log('Действие завершено:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  validateResponseContract: (res) => ({ success: true, ...res }),
+  toData: true,
+  options: { cache: false }
+})
 
 const handleSubmit = async () => {
   const result = await send({ name: 'User' })

package/src/media/functional/functional/composables/useApiRequest/useApiRequest.vi.mdx

@@ -4,28 +4,32 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiRequest`
 
-Trả về một đối tượng với trạng thái tải và phương thức `send` để thực hiện các yêu cầu API.
+Trả về một đối tượng với trạng thái tải và phương thức `send` để thực hiện các yêu cầu API. Nhận các thiết lập dưới dạng một đối tượng `UseApiRequestSetup` duy nhất.
 
 **Tham số:**
-- `path?: RefOrNormal<string | undefined>` — Đường dẫn đến endpoint API (có thể phản ứng).
-- `method: ApiMethodItem = ApiMethodItem.post` — Phương thức HTTP cho yêu cầu.
-- `action?: (data: Return | undefined) => Promise<void> | void` — Hành động (callback) thực hiện sau khi yêu cầu hoàn tất thành công.
-- `transformation?: (data: T) => Return` — Hàm chuyển đổi dữ liệu phản hồi từ máy chủ trước khi trả về hoặc truyền vào `action`.
-- `toData: boolean = true` — Việc trích xuất trường `data` từ phản hồi hay không.
-- `options?: ApiOptions` — Các tùy chọn bổ sung cho yêu cầu (đối tượng tham số `ApiFetch`).
-- `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
-
-**Giá trị t**Trả về:**
+- `setup: UseApiRequestSetup` — Đối tượng thiết lập cấu hình:
+  - `path?: RefOrNormal<string | undefined>` — Đường dẫn đến endpoint API (có thể phản ứng).
+  - `method?: ApiMethodItem` — Phương thức HTTP cho yêu cầu. Mặc định là `ApiMethodItem.post`.
+  - `action?: (data: Return | undefined) => Promise<void> | void` — Hành động (callback) thực hiện sau khi yêu cầu hoàn tất thành công.
+  - `transformation?: (data: T) => Return` — Hàm chuyển đổi dữ liệu phản hồi từ máy chủ trước khi trả về hoặc truyền vào `action`.
+  - `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — Hàm xác thực hợp đồng yêu cầu.
+  - `validateResponseContract?: (data: T) => ApiDataValidation & Return` — Hàm xác thực hợp đồng phản hồi.
+  - `errorContract?: ApiErrorStorageList` — nơi lưu trữ hợp đồng lỗi phản hồi.
+  - `toData?: boolean` — Việc trích xuất trường `data` từ phản hồi hay không. Mặc định: `true`.
+  - `options?: ApiOptions` — Các tùy chọn bổ sung cho yêu cầu (đối tượng tham số `ApiFetch`).
+  - `apiInstance?: ApiInstance` — Phiên bản API sử dụng cho yêu cầu. Mặc định là `Api.getItem()`.
+
+**Trả về:**
 Một đối tượng với các thuộc tính sau:
 - `loading: Ref<boolean>` — Trạng thái tải phản ứng. Sẽ là `true` trong khi yêu cầu đang thực hiện và `false` sau khi hoàn thành hoặc có lỗi.
-- `send(request?: Request): Promise<Return | undefined>` — Phương thức bất đồng bộ để gửi yêu cầu. Nó tự động quản lý trạng thái `loading`, áp dụng hàm biến đổi cho phản hồi, thực hiện callback `action` khi thành công và xử lý lỗi một cách an toàn bằng cách ghi log ra console.
+- `send(request?: Request): Promise<Return | undefined>` — Phương thức bất đồng bộ để gửi yêu cầu. Nó tự động quản lý trạng thái `loading`, xác thực hợp đồng yêu cầu và phản hồi, áp dụng hàm biến đổi cho phản hồi, thực hiện callback `action` khi thành công và xử lý lỗi một cách an toàn bằng cách ghi log ra console.
 
 ## Đối tượng ApiOptions
 
 `ApiOptions` — có thể nhận một chuỗi tên `method` (ví dụ: `'GET'`) hoặc một đối tượng kiểu `ApiFetch`. Các trường của đối tượng `ApiFetch`:
 
 - `path?: string` — đường dẫn đến endpoint script tương đối so với URL cơ bản (ví dụ: `'users/list'`).
-- `pathFull?: string` — URL đầy đủ của yêu cầu. Nếu được chỉ định, sẽ bỏ qua `api` và `path`.
+- `pathFull?: string` — URL đầy đủ của yêu cầu. Nếu được chỉ định, sẽ bỏ qua `api` and `path`.
 - `api?: boolean` — có thêm URL cơ bản trước `path` hay không. Mặc định: `true`.
 - `method?: ApiMethod` — phương thức HTTP (`'GET'`, `'POST'`, `'PUT'`, `'DELETE'`). Mặc định: `'GET'`.
 - `request?: FormData | Record<string, any> | string` — thân yêu cầu (cho POST/PUT) hoặc các tham số truy vấn (cho GET). Được truyền dưới dạng JSON hoặc `FormData`.
@@ -44,14 +48,16 @@ Một đối tượng với các thuộc tính sau:
 import { useApiRequest } from '@dxtmisha/functional'
 import { ApiMethodItem } from '@dxtmisha/functional-basic'
 
-const { loading, send } = useApiRequest(
-  '/api/submit',
-  ApiMethodItem.post,
-  (data) => console.log('Hành động hoàn tất:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiRequest({
+  path: '/api/submit',
+  method: ApiMethodItem.post,
+  action: (data) => console.log('Hành động hoàn tất:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateRequestContract: (req) => ({ success: true, ...req }),
+  validateResponseContract: (res) => ({ success: true, ...res }),
+  toData: true,
+  options: { cache: false }
+})
 
 const handleSubmit = async () => {
   const result = await send({ name: 'User' })

package/src/media/functional/functional/dxt-functional-plugin/dxt-functional-plugin.en.mdx

@@ -28,7 +28,20 @@ const functionalOptions: FunctionalPluginOptions = {
   // Suffix to be appended to all page <title>
   metaSuffix: ' | My App',
   // Pass the router so services can access navigation
-  router
+  router,
+  // Error causes for error center
+  errorCauses: [
+    { code: 'access_denied', message: 'Access denied' }
+  ],
+  // Error handlers
+  errorHandlers: [
+    {
+      group: 'auth',
+      handlers: [
+        (cause) => console.error('Auth error:', cause.message)
+      ]
+    }
+  ]
 }
 
 // Use functional plugin
@@ -46,7 +59,8 @@ When you call `app.use(dxtFunctionalPlugin)`, the following steps occur automati
 3. **`Icons` Initialization**: Configures the global SVG icon registry.
 4. **`Meta` Initialization**: Automatically sets the browser tab suffix (via `useMeta().setSuffix()`) if provided.
 5. **Vue Router Integration**: Globally registers the router object in the library's memory (`RouterItemRef`), allowing other functional services to use navigation even outside Vue components.
-6. **`executeUseGlobalInit()` Execution**: Automatically triggers the initialization of absolutely all global singletons created via `executeUseGlobal`. You no longer need to call it manually!
+6. **`ErrorCenter` Setup**: Configures predefined error causes (`ErrorCenter.addList`) and registers global error handlers (`ErrorCenter.addHandlerList`) in the central error registry.
+7. **`executeUseGlobalInit()` Execution**: Automatically triggers the initialization of absolutely all global singletons created via `executeUseGlobal`. You no longer need to call it manually!
 
 ## Service Configuration
 

package/src/media/functional/functional/dxt-functional-plugin/dxt-functional-plugin.ru.mdx

@@ -28,7 +28,20 @@ const functionalOptions: FunctionalPluginOptions = {
   // Суффикс, который будет добавляться ко всем <title> страниц
   metaSuffix: ' | Мое приложение',
   // Передача роутера для работы навигации внутри сервисов
-  router
+  router,
+  // Причины ошибок для центра ошибок
+  errorCauses: [
+    { code: 'access_denied', message: 'Доступ ограничен' }
+  ],
+  // Обработчики ошибок
+  errorHandlers: [
+    {
+      group: 'auth',
+      handlers: [
+        (cause) => console.error('Ошибка авторизации:', cause.message)
+      ]
+    }
+  ]
 }
 
 // Подключаем функциональный плагин
@@ -46,7 +59,8 @@ app.mount('#app')
 3. **Инициализация `Icons`**: Запускает конфигурацию глобального реестра иконок (SVG).
 4. **Инициализация `Meta`**: Автоматически прописывает суффикс вкладки браузера (через `useMeta().setSuffix()`), если он был передан.
 5. **Интеграция с Vue Router**: Глобально регистрирует объект роутера в памяти библиотеки (`RouterItemRef`), чтобы другие функциональные сервисы имели доступ к навигации даже за пределами компонентов.
-6. **Запуск `executeUseGlobalInit()`**: Автоматически триггерит инициализацию абсолютно всех глобальных синглтонов на базе `executeUseGlobal`. Заботиться о ручном вызове больше не нужно!
+6. **Настройка `ErrorCenter`**: Настраивает предопределенный список причин ошибок (`ErrorCenter.addList`) и регистрирует обработчики (`ErrorCenter.addHandlerList`) в едином хранилище.
+7. **Запуск `executeUseGlobalInit()`**: Автоматически триггерит инициализацию абсолютно всех глобальных синглтонов на базе `executeUseGlobal`. Заботиться о ручном вызове больше не нужно!
 
 ## Конфигурация сервисов