@dxtmisha/wiki 0.59.1 → 0.64.0

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

@@ -1,34 +1,38 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional/Composables/useApiDelete - Thực hiện yêu cầu DELETE'/>
+<Meta title='@dxtmisha/vi/functional/Composables/useApiDelete - DELETE Request Execution'/>
 
 # `useApiDelete`
 
-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 `DELETE`.
+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 `DELETE`. Đâ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 `DELETE`. Nhận các thiết lập dưới dạng một đối tượng `UseApiDeleteSetup` 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: UseApiDeleteSetup` — Đố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 `DELETE`. 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 `DELETE`. 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 { useApiDelete } from '@dxtmisha/functional'
 
-const { loading, send } = useApiDelete(
-  '/api/delete',
-  (data) => console.log('Hành động hoàn tất:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiDelete({
+  path: '/api/delete',
+  action: (data) => console.log('Hành động hoàn tất:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  toData: true,
+  options: { cache: false }
+})
 
 const handleDelete = async () => {
   const result = await send({ id: 1 })

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

@@ -4,31 +4,36 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiGet`
 
-Returns an object with a loading state and a `send` method for executing API `GET` requests.
+Returns an object with a loading state and a `send` method for executing API `GET` requests. It is a convenient wrapper over `useApiRequest` that pre-fills the `GET` method. Accepts settings as a single `UseApiGetSetup` 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: UseApiGetSetup` — 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 `GET` 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 `GET` 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 { useApiGet } from '@dxtmisha/functional'
 
-const { loading, send } = useApiGet(
-  '/api/data',
-  (data) => console.log('Action complete:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiGet({
+  path: '/api/data',
+  action: (data) => console.log('Action complete:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateResponseContract: (res) => ({ success: true, ...res }),
+  toData: true,
+  options: { cache: false }
+})
 
 const fetchData = async () => {
   const result = await send({ id: 1 })

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

@@ -4,31 +4,36 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiGet`
 
-Возвращает объект с состоянием загрузки и методом `send` для выполнения `GET`-запросов к API.
+Возвращает объект с состоянием загрузки и методом `send` для выполнения `GET`-запросов к API. Является удобной оберткой над `useApiRequest` с предустановленным методом `GET`. Принимает настройки в виде единого объекта `UseApiGetSetup`.
 
 **Параметры:**
-- `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: UseApiGetSetup` — Объект настроек запроса:
+  - `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>` — Асинхронный метод для отправки `GET`-запроса. Он автоматически управляет состоянием `loading`, применяет функцию трансформации к ответу, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки.
+- `send(request?: Request): Promise<Return | undefined>` — Асинхронный метод для отправки `GET`-запроса. Он автоматически управляет состоянием `loading`, проверяет контракты валидации запроса и ответа, применяет функцию трансформации к ответам, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки.
 
 ```typescript
 import { useApiGet } from '@dxtmisha/functional'
 
-const { loading, send } = useApiGet(
-  '/api/data',
-  (data) => console.log('Действие завершено:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiGet({
+  path: '/api/data',
+  action: (data) => console.log('Действие завершено:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateResponseContract: (res) => ({ success: true, ...res }),
+  toData: true,
+  options: { cache: false }
+})
 
 const fetchData = async () => {
   const result = await send({ id: 1 })

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

@@ -1,34 +1,39 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional/Composables/useApiGet - Thực hiện yêu cầu GET'/>
+<Meta title='@dxtmisha/vi/functional/Composables/useApiGet - GET Request Execution'/>
 
 # `useApiGet`
 
-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 `GET`.
+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 `GET`. Đâ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 `GET`. Nhận các thiết lập dưới dạng một đối tượng `UseApiGetSetup` 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: UseApiGetSetup` — Đố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 `GET`. 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 `GET`. 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 { useApiGet } from '@dxtmisha/functional'
 
-const { loading, send } = useApiGet(
-  '/api/data',
-  (data) => console.log('Hành động hoàn tất:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiGet({
+  path: '/api/data',
+  action: (data) => console.log('Hành động hoàn tất:', data),
+  transformation: (raw) => ({ ...raw, processed: true }),
+  validateResponseContract: (res) => ({ success: true, ...res }),
+  toData: true,
+  options: { cache: false }
+})
 
 const fetchData = async () => {
   const result = await send({ id: 1 })

package/src/media/functional/functional/composables/{useApiManagementRef → useApiManagementAsyncRef}/useApiManagementAsyncRef.en.mdx

@@ -20,11 +20,24 @@ Parameters are identical to [`useApiManagementRef`](./useApiManagementRef.en.mdx
 - `formattersOptions?: FormattersOptions` — formatting rules.
 - `searchOptions?: ApiManagementSearch<Item, Columns>` — search settings.
 - `postRequest / putRequest / deleteRequest` — mutation settings.
-- `action?: function` — callback after mutation.
+- `action?: (data: any) => Promise<void> | void` — a common callback to perform after any successful mutation.
 - `apiInstance?: ApiInstance` — API instance.
 
 ## Returns
-Returns an API management object. The return object structure is identical to [`useApiManagementRef`](./useApiManagementRef.en.mdx).
+Returns an API management object. The return object structure is identical to [`useApiManagementRef`](./useApiManagementRef.en.mdx):
+
+- `isValid: ComputedRef<boolean>` — `true` if data matches `typeData` check.
+- `isResponseContractValid: ComputedRef<boolean>` — `true` if the response data matches the defined contract.
+- `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — detailed result of the contract validation.
+- `list: ComputedRef` — processed data array with support for Skeleton, formatters, and search.
+- `data: ComputedRef<ApiData<Return> | undefined>` — raw reactive data from `useApiRef`.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — current error object if the request failed.
+- `length: ComputedRef<number>` — current length of the `list`.
+- `starting / loading / reading` — request status flags.
+- `loadingSearch / loadingPost / loadingPut / loadingDelete` — loading states for search and mutations.
+- `isSearch / search` — search status and reactive search string.
+- `sendPost / sendPut / sendDelete` — mutation execution methods.
+- `reset / abort` — control methods.
 
 ## Example
 

package/src/media/functional/functional/composables/{useApiManagementRef → useApiManagementAsyncRef}/useApiManagementAsyncRef.ru.mdx

@@ -20,11 +20,24 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `formattersOptions?: FormattersOptions` — правила форматирования.
 - `searchOptions?: ApiManagementSearch<Item, Columns>` — настройки поиска.
 - `postRequest / putRequest / deleteRequest` — настройки мутаций.
-- `action?: function` — коллбэк после мутации.
+- `action?: (data: any) => Promise<void> | void` — общий коллбэк, выполняемый после любой успешной мутации.
 - `apiInstance?: ApiInstance` — экземпляр API.
 
 ## Возвращаемое значение
-Возвращает объект управления API. Состав возвращаемого значения полностью идентичен [`useApiManagementRef`](./useApiManagementRef.ru.mdx).
+Возвращает объект управления API. Состав возвращаемого значения полностью идентичен [`useApiManagementRef`](./useApiManagementRef.ru.mdx):
+
+- `isValid: ComputedRef<boolean>` — `true`, если данные прошли проверку `typeData`.
+- `isResponseContractValid: ComputedRef<boolean>` — `true`, если данные ответа соответствуют определенному контракту.
+- `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — подробный результат валидации контракта.
+- `list: ComputedRef` — обработанный массив данных с поддержкой Skeleton, форматтеров и поиска.
+- `data: ComputedRef<ApiData<Return> | undefined>` — «сырые» реактивные данные из `useApiRef`.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — текущий объект ошибки, если запрос не удался.
+- `length: ComputedRef<number>` — текущее количество элементов в `list`.
+- `starting / loading / reading` — флаги состояния запроса.
+- `loadingSearch / loadingPost / loadingPut / loadingDelete` — состояния загрузки для поиска и мутаций.
+- `isSearch / search` — статус поиска и реактивная строка поиска.
+- `sendPost / sendPut / sendDelete` — методы для выполнения мутаций.
+- `reset / abort` — методы управления.
 
 ## Пример
 

package/src/media/functional/functional/composables/{useApiManagementRef → useApiManagementAsyncRef}/useApiManagementAsyncRef.vi.mdx

@@ -20,11 +20,24 @@ Các tham số giống hệt với [`useApiManagementRef`](./useApiManagementRef
 - `formattersOptions?: FormattersOptions` — quy tắc định dạng.
 - `searchOptions?: ApiManagementSearch<Item, Columns>` — cài đặt tìm kiếm.
 - `postRequest / putRequest / deleteRequest` — cài đặt mutation.
-- `action?: function` — callback sau mutation.
+- `action?: (data: any) => Promise<void> | void` — callback chung để thực thi sau bất kỳ mutation nào thành công.
 - `apiInstance?: ApiInstance` — instance của API.
 
 ## Giá trị trả về
-Trả về một đối tượng quản lý API. Cấu trúc đối tượng trả về giống hệt với [`useApiManagementRef`](./useApiManagementRef.vi.mdx).
+Trả về một đối tượng quản lý API. Cấu trúc đối tượng trả về giống hệt với [`useApiManagementRef`](./useApiManagementRef.vi.mdx):
+
+- `isValid: ComputedRef<boolean>` — `true` nếu dữ liệu khớp với kiểm tra `typeData`.
+- `isResponseContractValid: ComputedRef<boolean>` — `true` nếu dữ liệu phản hồi khớp với hợp đồng đã xác định.
+- `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — kết quả chi tiết của việc xác thực hợp đồng.
+- `list: ComputedRef` — mảng dữ liệu đã qua xử lý với sự hỗ trợ của Skeleton, formatter và tìm kiếm.
+- `data: ComputedRef<ApiData<Return> | undefined>` — dữ liệu reactive thô từ `useApiRef`.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — đối tượng lỗi hiện tại nếu yêu cầu thất bại.
+- `length: ComputedRef<number>` — độ dài hiện tại của `list`.
+- `starting / loading / reading` — các cờ trạng thái yêu cầu.
+- `loadingSearch / loadingPost / loadingPut / loadingDelete` — trạng thái loading cho tìm kiếm và mutation.
+- `isSearch / search` — trạng thái tìm kiếm và chuỗi tìm kiếm reactive.
+- `sendPost / sendPut / sendDelete` — các phương thức để thực thi mutation.
+- `reset / abort` — các phương thức điều khiển.
 
 ## Ví dụ
 

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

@@ -18,8 +18,11 @@ A powerful composable for comprehensive API request orchestration. It manages da
 
 ## Returns
 - `isValid: ComputedRef<boolean>` — `true` if data matches `typeData` check.
+- `isResponseContractValid: ComputedRef<boolean>` — `true` if the response data matches the defined contract.
+- `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — detailed result of the contract validation.
 - `list: ComputedRef` — the processed data array. **Supports Skeleton**: if data is not yet loaded and a `skeleton()` is provided, it returns placeholders. Accounts for search filters and formatters.
 - `data: ComputedRef<ApiData<Return> | undefined>` — the raw reactive data from `useApiRef`.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — current error object if the request failed.
 - `length: ComputedRef<number>` — current length of the `list` (dynamically updates when searching).
 - `lengthData: ComputedRef<number>` — original length of the data in `data.value`.
 - `starting: ComputedRef<boolean>` — `true` if the request is still in its initial loading phase.
@@ -84,7 +87,9 @@ If you are using the standard `useApiManagementRef`, you can manually include it
 - `options?: ApiOptions` — request options (method, headers, etc.).
 - `reactivity?: boolean` — whether to automatically refetch when `path` or `options` change.
 - `conditions?: Ref<boolean>` — condition under which the request is executed.
-- `transformation?: (data: Type) => ApiData<Return>` — function to transform data after fetching.
+- `transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>` — function to transform data after fetching.
+- `validateResponseContract?: (data: Type) => ApiDataValidation` — function to validate the response data contract.
+- `errorContract?: ApiErrorStorageList` — storage of response error contracts.
 - `typeData?: ((data: Return) => boolean) | any` — data validation function or constructor (e.g., `Array`).
 - `unmounted?: boolean` — whether to clear data after component unmount.
 - `skeleton?: () => Return` — function returning placeholder data during loading.
@@ -98,7 +103,10 @@ If you are using the standard `useApiManagementRef`, you can manually include it
 - `path?: string | Ref<string>` — path for the mutation request.
 - `action?: (data: Return | undefined) => Promise<void> | void` — callback after request execution.
 - `transformation?: (data: T) => Return` — data transformation before sending.
-- `toData?: boolean` — whether to send data in the request body (under `data`).
+- `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 wrap the payload in a 'data' property.
 - `options?: ApiOptions` — additional request options.
 
 ## Usage Example

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

@@ -18,8 +18,11 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 ## Возвращает
 - `isValid: ComputedRef<boolean>` — `true`, если данные прошли проверку `typeData`.
+- `isResponseContractValid: ComputedRef<boolean>` — `true`, если данные ответа соответствуют определенному контракту.
+- `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — подробный результат валидации контракта.
 - `list: ComputedRef` — обработанный массив данных. **Поддерживает Skeleton**: если данные ещё не загружены и передан `skeleton()`, вернет заглушки. Учитывает фильтры поиска и форматтеры.
 - `data: ComputedRef<ApiData<Return> | undefined>` — «сырые» реактивные данные из `useApiRef`.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — текущий объект ошибки, если запрос не удался.
 - `length: ComputedRef<number>` — текущее количество элементов в `list` (динамически меняется при поиске).
 - `lengthData: ComputedRef<number>` — общее количество элементов в исходном `data`.
 - `starting: ComputedRef<boolean>` — флаг первичной загрузки (когда данных еще нет).
@@ -83,10 +86,12 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `path?: string | Ref<string>` — путь к API.
 - `options?: ApiOptions` — параметры запроса (метод, заголовки и т.д.).
 - `reactivity?: boolean` — включить ли автоматическое обновление при изменении `path` или `options`.
-- `conditions?: Ref<boolean>` — условие, при котором выполняется запрос.
-- `transformation?: (data: Type) => ApiData<Return>` — функция для трансформации данных после получения.
+- `conditions?: Ref<boolean>` — условие выполнения запроса.
+- `transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>` — функция трансформации данных после получения.
+- `validateResponseContract?: (data: Type) => ApiDataValidation` — функция для проверки контракта данных ответа.
+- `errorContract?: ApiErrorStorageList` — хранилище контрактов ошибок ответа.
 - `typeData?: ((data: Return) => boolean) | any` — функция проверки данных или конструктор (например, `Array`).
-- `unmounted?: boolean` — удалять ли данные после размонтирования компонента.
+- `unmounted?: boolean` — очищать ли данные после размонтирования компонента.
 - `skeleton?: () => Return` — функция, возвращающая данные-заглушки во время загрузки.
 
 ### `ApiManagementSearch<T, K>`
@@ -98,7 +103,10 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `path?: string | Ref<string>` — путь для запроса мутации.
 - `action?: (data: Return | undefined) => Promise<void> | void` — коллбэк, вызываемый после выполнения запроса.
 - `transformation?: (data: T) => Return` — трансформация данных перед отправкой.
-- `toData?: boolean` — отправлять ли данные в теле запроса (в свойстве `data`).
+- `validateRequestContract?: (data: Request) => ApiDataValidation & Return` — функция валидации контракта запроса.
+- `validateResponseContract?: (data: T) => ApiDataValidation & Return` — функция валидации контракта ответа.
+- `errorContract?: ApiErrorStorageList` — хранилище контрактов ошибок ответа.
+- `toData?: boolean` — оборачивать ли полезную нагрузку в свойство 'data'.
 - `options?: ApiOptions` — дополнительные параметры запроса.
 
 ## Пример использования

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

@@ -18,8 +18,11 @@ Một composable mạnh mẽ để điều phối toàn diện các request API.
 
 ## Giá trị trả về
 - `isValid: ComputedRef<boolean>` — `true` nếu dữ liệu khớp với kiểm tra `typeData`.
+- `isResponseContractValid: ComputedRef<boolean>` — `true` nếu dữ liệu phản hồi khớp với hợp đồng đã xác định.
+- `responseValidationResult: ComputedRef<ApiDataValidation | undefined>` — kết quả chi tiết của việc xác thực hợp đồng.
 - `list: ComputedRef` — mảng dữ liệu đã qua xử lý. **Hỗ trợ Skeleton**: nếu dữ liệu chưa được tải và `skeleton()` được cung cấp, nó sẽ trả về các giá trị giả. Tính toán dựa trên bộ lọc tìm kiếm và formatter.
 - `data: ComputedRef<ApiData<Return> | undefined>` — dữ liệu reactive thô từ `useApiRef`.
+- `errorItem: ComputedRef<ApiErrorItem | undefined>` — đối tượng lỗi hiện tại nếu yêu cầu thất bại.
 - `length: ComputedRef<number>` — độ dài hiện tại của `list` (cập nhật động khi tìm kiếm).
 - `lengthData: ComputedRef<number>` — độ dài gốc của dữ liệu trong `data.value`.
 - `starting: ComputedRef<boolean>` — `true` nếu yêu cầu vẫn đang trong giai đoạn tải ban đầu.
@@ -78,7 +81,9 @@ Nếu bạn đang sử dụng `useApiManagementRef` tiêu chuẩn, bạn có th
 - `options?: ApiOptions` — các tùy chọn request (method, headers, v.v.).
 - `reactivity?: boolean` — có tự động refetch khi `path` hoặc `options` thay đổi hay không.
 - `conditions?: Ref<boolean>` — điều kiện để thực thi request.
-- `transformation?: (data: Type) => ApiData<Return>` — hàm transform dữ liệu sau khi fetch.
+- `transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>` — hàm transform dữ liệu sau khi fetch.
+- `validateResponseContract?: (data: Type) => 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.
 - `typeData?: ((data: Return) => boolean) | any` — hàm kiểm tra dữ liệu hoặc constructor (ví dụ: `Array`).
 - `unmounted?: boolean` — có xóa dữ liệu khi component bị unmount hay không.
 - `skeleton?: () => Return` — hàm trả về dữ liệu giả (placeholder) trong khi loading.
@@ -92,7 +97,10 @@ Nếu bạn đang sử dụng `useApiManagementRef` tiêu chuẩn, bạn có th
 - `path?: string | Ref<string>` — đường dẫn cho mutation request.
 - `action?: (data: Return | undefined) => Promise<void> | void` — callback sau khi thực thi request.
 - `transformation?: (data: T) => Return` — hàm transform dữ liệu trước khi gửi.
-- `toData?: boolean` — có gửi dữ liệu trong body của request (dưới thuộc tính `data`) hay không.
+- `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` — có bao bọc dữ liệu trong thuộc tính 'data' hay không.
 - `options?: ApiOptions` — các tùy chọn request bổ sung.
 
 ## Ví dụ sử dụng

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

@@ -4,31 +4,36 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiPost`
 
-Returns an object with a loading state and a `send` method for executing API `POST` requests.
+Returns an object with a loading state and a `send` method for executing API `POST` requests. It is a convenient wrapper over `useApiRequest` that pre-fills the `POST` method. Accepts settings as a single `UseApiPostSetup` 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: UseApiPostSetup` — 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 `POST` 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 `POST` 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 { useApiPost } from '@dxtmisha/functional'
 
-const { loading, send } = useApiPost(
-  '/api/submit',
-  (data) => console.log('Action complete:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiPost({
+  path: '/api/submit',
+  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({ name: 'User' })

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

@@ -4,31 +4,36 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `useApiPost`
 
-Возвращает объект с состоянием загрузки и методом `send` для выполнения `POST`-запросов к API.
+Возвращает объект с состоянием загрузки и методом `send` для выполнения `POST`-запросов к API. Является удобной оберткой над `useApiRequest` с предустановленным методом `POST`. Принимает настройки в виде единого объекта `UseApiPostSetup`.
 
 **Параметры:**
-- `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: UseApiPostSetup` — Объект настроек запроса:
+  - `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>` — Асинхронный метод для отправки `POST`-запроса. Он автоматически управляет состоянием `loading`, применяет функцию трансформации к ответу, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки.
+- `send(request?: Request): Promise<Return | undefined>` — Асинхронный метод для отправки `POST`-запроса. Он автоматически управляет состоянием `loading`, проверяет контракты валидации запроса и ответа, применяет функцию трансформации к ответам, вызывает коллбэк `action` при успехе и безопасно обрабатывает ошибки.
 
 ```typescript
 import { useApiPost } from '@dxtmisha/functional'
 
-const { loading, send } = useApiPost(
-  '/api/submit',
-  (data) => console.log('Действие завершено:', data),
-  (raw) => ({ ...raw, processed: true }),
-  true,
-  { cache: false }
-)
+const { loading, send } = useApiPost({
+  path: '/api/submit',
+  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({ name: 'User' })