@dxtmisha/wiki 0.39.7 → 0.39.8

package/src/media/functional/functional-basic/classes/ApiResponse/ApiResponse.ru.mdx

@@ -1,46 +1,75 @@
 import {Meta} from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiResponse - Эмуляция API запросов'/>
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiResponse - Эмуляция ответов API'/>
 
 # Класс ApiResponse
 
-Класс для управления и эмуляции ответов API. Позволяет перехватывать API-запросы и возвращать заранее определенные (заглушки) ответы. Это крайне полезно при разработке клиентской части, тестировании или при отсутствии полностью функционального бэкенда.
+Класс-менеджер для перехвата, кэширования и эмуляции ответов API. Он позволяет перехватывать исходящие API-запросы и возвращать предопределенные мок-данные вместо выполнения реального сетевого трафика.
+
+> `ApiResponse` является **вспомогательным классом**, предназначенным для эмуляции и мокирования API. В большинстве случаев рекомендуется регистрировать мок-ответы через параметр `response` в глобальной конфигурации `Api`.
 
 ## Ключевые особенности
 
-- **Перехват запросов** — сопоставляет исходящие запросы на основе пути, HTTP-метода и отправляемых данных.
-- **Динамические заглушки** — ответы могут быть как статическими объектами, так и динамическими функциями, выполняемыми во время запроса.
-- **Симуляция задержки** — реалистичная эмуляция задержки сети для определенных заглушек.
-- **Режим разработчика** — опциональное логирование совпадений эмулятора для отладки.
+- **Перехват запросов** — интеллектуально сопоставляет исходящие запросы на основе пути, HTTP-метода и объекта данных.
+- **Динамические возможности** — поддерживает как статические объекты, так и выполнение динамических функций-коллбэков для обработки контекста запроса.
+- **Симуляция задержки сети** — встроенная система для имитации сетевых задержек с помощью рандомизированных таймеров.
+- **Режим разработчика** — выводит полезную отладочную информацию в консоль браузера, показывая, какие данные сопоставились с конкретным моком.
 
 ## Инициализация
 
 Для инициализации объекта вызовите конструктор `ApiResponse(requestDefault)`.
 
 **Параметры:**
-- `requestDefault: ApiDefault` — экземпляр класса для обработки параметров запроса по умолчанию.
+- `requestDefault: ApiDefault` — класс запросов по умолчанию, используемый для конфигурации и хранения.
 
 ```typescript
-import { ApiResponse, ApiDefault } from '@dxtmisha/functional'
-
-// 1. Инициализация зависимостей
-const apiDefault = new ApiDefault()
-
-// 2. Создание экземпляра эмулятора
-const apiResponse = new ApiResponse(apiDefault)
+import { ApiResponse } from '@dxtmisha/functional-basic'
 
-// 3. Добавление мок-ответа
-apiResponse.add({
-  path: 'user/get',
-  method: 'get',
-  response: { id: 1, name: 'Admin' }
-})
+const apiResponse = new ApiResponse(myApiDefault)
 ```
 
 ## Методы
 
-- `get(path: string = '', method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Проверяет наличие глобального кэшированного запроса и возвращает его (синхронно).
-- `getList(): (ApiResponseItem & Record<string, any>)[]` — Возвращает список всех зарегистрированных моков эмулятора.
-- `add(response: ApiResponseItem | ApiResponseItem[]): this` — Регистрирует и добавляет мок-ответ(ы) в эмулятор.
-- `setDevMode(devMode: boolean): this` — Включает или отключает режим разработчика с предупреждениями в консоли при срабатывании заглушек.
-- `emulator<T>(apiFetch: ApiFetch): Promise<T | undefined>` — Выполняет эмуляцию запроса, если подходящий мок существует, включая обработку задержки.
+### Действие
+
+#### `emulator`
+
+Основной цикл движка, который проверяет конфигурации запросов и выполняет соответствующие эмулированные ответы. Этот метод работает только в среде DOM.
+
+**Параметры:**
+- `apiFetch: ApiFetch` — Свойства запроса для эмуляции.
+
+**Возвращает:** `Promise<T | undefined>` — Данные эмулированного ответа.
+
+### Проверка
+
+- `get(path: string, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Синхронно проверяет наличие подходящего мок-запроса в кэше.
+- `getList(): (ApiResponseItem & Record<string, any>)[]` — Возвращает список всех зарегистрированных конфигураций эмулятора.
+
+### Конфигурация
+
+- `add(response: ApiResponseItem | ApiResponseItem[]): this` — Добавляет объекты мок-ответов в локальный реестр.
+- `setDevMode(devMode: boolean): this` — Включает или выключает режим отладочного вывода в консоль.
+
+## Типы
+
+#### `ApiResponseItem`
+Объект, определяющий конфигурацию мок-ответа.
+- `path: string | RegExp` — Путь или шаблон URL.
+- `method: ApiMethod` — HTTP-метод (GET, POST и т.д.).
+- `response: any | ((request?: any) => any)` — Данные мока или функция для их генерации.
+- `request?: ApiFetch['request'] | '*any'` — Опциональные данные запроса для сопоставления.
+- `lag?: boolean` — Нужно ли имитировать задержку сети.
+- `disable?: any` — Условие для отключения мока (boolean или функция).
+- `isForGlobal?: boolean` — Пометить как глобальный мок (скрыт из getList).
+
+## Руководство: Эмуляция API
+
+Следующие правила и условия определяют, как система эмуляции перехватывает и подменяет сетевые запросы:
+
+- **Регистрация моков** — ответы, добавленные через `add()`, имеют приоритет и проверяются перед выполнением любого реального сетевого вызова.
+- **Критерии сопоставления** — мок срабатывает только в том случае, если путь (строка или RegExp), HTTP-метод и тело запроса полностью соответствуют конфигурации.
+- **Wildcard для тела** — использование значения `*any` для запроса позволяет моку соответствовать любой полезной нагрузке, пропуская глубокое сравнение объектов.
+- **Динамические данные** — свойство `response` может быть функцией, что позволяет генерировать динамические данные мока на основе входящих параметров запроса.
+- **Симуляция задержки** — установка `lag: true` добавляет случайную задержку (0–2000 мс) и активирует общее состояние загрузки (класс `d-response-loading` на body).
+- **Повторные срабатывания** — по умолчанию конфигурация эмулятора срабатывает только один раз, если не включен `devMode`, что предотвращает дублирование моков для одного и того же состояния.

package/src/media/functional/functional-basic/classes/ApiResponse/ApiResponse.vi.mdx

@@ -1,46 +1,75 @@
 import {Meta} from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiResponse - Giả lập yêu cầu API'/>
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiResponse - Giả lập phản hồi API'/>
 
 # Lớp ApiResponse
 
-Một lớp trình quản lý hệ thống phản hồi API. Giúp cung cấp cơ sở để bạn thu phục và chặn dòng yêu cầu mạng để tự thiết kế ra các câu trả lời giả lập (mock responses). Rất đắc lực và hữu ích trong quy trình thiết kế giao diện front-end, thời điểm máy chủ backend chưa hoàn chỉnh, hoặc khi cần bổ sung dữ liệu giả lập cho công tác test phần mềm offline.
+Một lớp quản lý để chặn, lưu trữ và giả lập các phản hồi API. Nó cho phép bạn chặn các yêu cầu API đi và trả về dữ liệu mẫu (mock data) đã được định nghĩa trước thay vì kích hoạt lưu lượng mạng thực tế.
+
+> `ApiResponse` là một **lớp bổ trợ** (auxiliary class), được thiết kế để giả lập và tạo mock API. Trong hầu hết các trường hợp, bạn nên đăng ký các phản hồi mock thông qua tham số `response` trong cấu hình `Api` toàn cục.
 
 ## Các tính năng chính
 
-- **Đón chặn yêu cầu (Request Interception)** — đối chiếu và phát hiện các yêu cầu ra bên ngoài thông minh dựa trên đường dẫn đích tới, giao thức kết nối HTTP, cũng như những biến tải trọng dữ liệu đi kèm.
-- **Giả lập dữ liệu động (Dynamic Capabilities)** — không chỉ hiển thị các dòng phản hồi tĩnh đóng gói sẵn (static template), bản đối chiếu mock cũng hỗ trợ cung cấp trả lời tự động hàm chức năng nội tiếp đọc hiểu ngay tải trọng client gắn kèm.
-- **Giả lập mạng trục trặc (Network Lag Simulation)** — thiết kế cấu trúc hàm trễ mạng `timeouts` chạy ngẫu nhiên mô phỏng khoảng ngắt quãng tín hiệu vật lý.
-- **Kiểm soát cho Nhà phát triển (Developer Mode)** — in chuỗi thông tin cảnh báo ra bảng console xác minh yêu cầu nào đang bị chặn và đang lấy được các đoạn tín hiệu mẫu nào.
+- **Chặn yêu cầu** — khớp các yêu cầu đi một cách thông minh dựa trên đường dẫn mục tiêu, phương thức HTTP và đối tượng dữ liệu.
+- **Khả năng linh hoạt** — hỗ trợ cả các đối tượng tĩnh được định nghĩa trước hoặc thực thi các logic callback động có khả năng diễn giải ngữ cảnh yêu cầu.
+- **Mô phỏng độ trễ mạng** — hệ thống tích hợp được thiết kế riêng để mô phỏng các kịch bản độ trễ thực tế (bộ hẹn giờ bù ngẫu nhiên).
+- **Chế độ nhà phát triển** — in các thông tin gỡ lỗi hữu ích trong console trình duyệt cho biết dữ liệu nào đã khớp trực tiếp với một điểm mock cụ thể.
 
 ## Khởi tạo
 
-Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `ApiResponse(requestDefault)`.
+Để khởi tạo đối tượng, hãy gọi hàm dựng `ApiResponse(requestDefault)`.
 
 **Tham số:**
-- `requestDefault: ApiDefault` — một thực thể để xử lý các tham số yêu cầu mặc định.
+- `requestDefault: ApiDefault` — lớp yêu cầu mặc định được sử dụng để cấu hình và lưu trữ.
 
 ```typescript
-import { ApiResponse, ApiDefault } from '@dxtmisha/functional'
-
-// 1. Khởi tạo các phụ thuộc
-const apiDefault = new ApiDefault()
-
-// 2. Tạo thực thể giả lập
-const apiResponse = new ApiResponse(apiDefault)
+import { ApiResponse } from '@dxtmisha/functional-basic'
 
-// 3. Thêm một phản hồi giả lập
-apiResponse.add({
-  path: 'user/get',
-  method: 'get',
-  response: { id: 1, name: 'Admin' }
-})
+const apiResponse = new ApiResponse(myApiDefault)
 ```
 
 ## Các phương thức
 
-- `get(path: string = '', method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Kiểm tra đồng bộ để tìm kiếm nếu có một mã yêu cầu nằm trong bộ nhớ cache toàn cục khớp hay không và trả về mốc dữ liệu.
-- `getList(): (ApiResponseItem & Record<string, any>)[]` — Trả về danh sách cấu trúc tất cả các mock giả lập đã thực thi đăng ký từ đầu hệ thống.
-- `add(response: ApiResponseItem | ApiResponseItem[]): this` — Thêm vào (hoặc dán lên liên tục) các phản hồi mock-data vào mạng registry quản lý hệ điều hành giả.
-- `setDevMode(devMode: boolean): this` — Bật hoặc tắt thiết lập luồng chế độ dành cho Nhà phát triển (nhìn luồng dữ liệu console.warn báo tin).
-- `emulator<T>(apiFetch: ApiFetch): Promise<T | undefined>` — Khối lệnh mấu chốt được cấu trúc để thực thi việc xác thưc liên kết mô phỏng một lệnh lấy mạng ảo, kèm hiệu ứng mô phỏng dòng kéo trễ.
+### Hành động
+
+#### `emulator`
+
+Vòng lặp công cụ chính để xác thực các cấu hình yêu cầu và thực thi các phản hồi mock có độ trễ tương ứng. Phương thức này chỉ chạy trong môi trường DOM.
+
+**Tham số:**
+- `apiFetch: ApiFetch` — Các thuộc tính của yêu cầu cần giả lập.
+
+**Trả về:** `Promise<T | undefined>` — Dữ liệu phản hồi đã giả lập.
+
+### Kiểm tra
+
+- `get(path: string, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Kiểm tra đồng bộ một yêu cầu mock đã lưu khớp với các tham số.
+- `getList(): (ApiResponseItem & Record<string, any>)[]` — Trả về danh sách tất cả các cấu hình giả lập đã đăng ký.
+
+### Cấu hình
+
+- `add(response: ApiResponseItem | ApiResponseItem[]): this` — Thêm các đối tượng phản hồi mock vào bộ đăng ký cục bộ.
+- `setDevMode(devMode: boolean): this` — Bật/tắt chế độ nhật ký gỡ lỗi phát triển.
+
+## Các kiểu dữ liệu
+
+#### `ApiResponseItem`
+Một đối tượng định nghĩa cấu hình phản hồi mock.
+- `path: string | RegExp` — Đường dẫn hoặc mẫu URL khớp.
+- `method: ApiMethod` — Phương thức HTTP (GET, POST, v.v.).
+- `response: any | ((request?: any) => any)` — Dữ liệu mock hoặc hàm trả về dữ liệu đó.
+- `request?: ApiFetch['request'] | '*any'` — Dữ liệu yêu cầu tùy chọn để khớp.
+- `lag?: boolean` — Có mô phỏng độ trễ mạng hay không.
+- `disable?: any` — Điều kiện để vô hiệu hóa mock (boolean hoặc hàm).
+- `isForGlobal?: boolean` — Đánh dấu là mock toàn cục (ẩn khỏi getList).
+
+## Hướng dẫn: Giả lập API
+
+Các quy tắc và điều kiện sau đây xác định cách hệ thống giả lập chặn và tạo mock cho các yêu cầu mạng:
+
+- **Đăng ký Mock** — các phản hồi được thêm qua `add()` sẽ được ưu tiên và kiểm tra trước khi bất kỳ cuộc gọi mạng thực tế nào được khởi tạo.
+- **Tiêu chí khớp** — một mock chỉ được kích hoạt nếu đường dẫn (chuỗi hoặc RegExp), phương thức HTTP và nội dung yêu cầu đều khớp với cấu hình.
+- **Ký tự đại diện cho Body** — sử dụng `*any` làm giá trị yêu cầu cho phép mock khớp với bất kỳ payload nào, bỏ qua việc so sánh đối tượng chuyên sâu.
+- **Dữ liệu động** — thuộc tính `response` có thể là một hàm, cho phép bạn tạo dữ liệu mock động dựa trên các tham số yêu cầu đầu vào.
+- **Mô phỏng độ trễ** — thiết lập `lag: true` sẽ thêm một khoảng trễ ngẫu nhiên (0-2000ms) và kích hoạt trạng thái tải chung (lớp `d-response-loading` trên body).
+- **Tính duy trì của khớp** — theo mặc định, một cấu hình giả lập chỉ khớp một lần trừ khi `devMode` được bật, điều này ngăn chặn việc kích hoạt mock trùng lặp cho cùng một trạng thái.

package/src/media/functional/functional-basic/classes/ApiStatus/ApiStatus.en.mdx

@@ -6,48 +6,45 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 A class dedicated to tracking and managing the state of an API request. It securely holds the current HTTP status, error messages, and the parsed response body, allowing applications to react to real-time changes utilizing state abstractions.
 
+> `ApiStatus` is an **auxiliary class**, designed for tracking request states. In most cases, it is recommended to interact with request status through the `status` property of the `ApiInstance` result or the global `Api` execution flow.
+
 ## Key Features
 
 - **Centralized State** — holds everything related to the result of an API call: HTTP status, custom texts, raw response data, and generated messages.
 - **Chainable API** — setters return `this`, allowing multiple state changes to be chained elegantly.
 - **Automatic Message Extraction** — intelligently attempts to parse and pull human-readable `message` fields directly from structured server responses.
 
-## Initialization
-
-To initialize the object, call the `ApiStatus()` constructor.
-
-```typescript
-import { ApiStatus } from '@dxtmisha/functional'
-
-// 1. Simple initialization
-const apiStatus = new ApiStatus()
+## Methods
 
-// 2. Setting response status
-apiStatus.setStatus(200, 'OK')
+### Action
 
-// 3. Setting response data and automatic message extraction
-apiStatus.setLastResponse({
-  status: 'success',
-  message: 'Data retrieved successfully',
-  data: { id: 1 }
-})
-```
+- `getResponse<T>(): T | undefined` — Returns the raw data payload from the last successful request.
+- `getMessage(): string` — Returns the server message pulled from a successful response or a manually set message.
 
-## Methods
+### Check
 
-### Value Retrieval Methods
-- `get(): ApiStatusItem` — Returns the complete status data object of the last response.
-- `getStatus(): number | undefined` — Returns the HTTP status code (e.g., `200`, `404`).
-- `getStatusText(): string | undefined` — Returns the status text message string (e.g., `"OK"`, `"Not Found"`).
+- `get(): ApiStatusItem | undefined` — Returns the complete status data object.
+- `getStatus(): number | undefined` — Returns the HTTP status code (e.g., `200`).
+- `getStatusText(): string | undefined` — Returns the status text (e.g., `"OK"`).
 - `getStatusType(): ApiStatusType | undefined` — Returns the last status validation type.
-- `getError(): string | undefined` — Returns the explicitly recorded error message.
-- `getResponse<T>(): T | undefined` — Returns the raw data payload from the last successful request.
-- `getMessage(): string` — Returns the server message pulled from a successful response.
+- `getError(): string | undefined` — Returns the recorded error message.
+
+### Configuration
 
-### Value Setting Methods
 - `set(data: ApiStatusItem): this` — Sets multiple status fields at once.
-- `setStatus(status?: number, statusText?: string): this` — Sets the HTTP status code and an optional text explanation.
-- `setError(error?: string): this` — Records an error message string when a request fails or is rejected.
-- `setLastResponse(response?: any): this` — Records a server response completely and optionally updates related statuses (like extraction of `.message`).
-- `setLastStatus(status?: ApiStatusType): this` — Sets the final custom API status type.
-- `setLastMessage(message?: string): this` — Forcibly overrides or explicitly records a message.
+- `setStatus(status?: number, statusText?: string): this` — Sets the HTTP status code and text.
+- `setError(error?: string): this` — Records an error message string.
+- `setLastResponse(response?: any): this` — Records a server response and automatically extracts `message` and `status` if present.
+- `setLastStatus(status?: ApiStatusType): this` — Sets the custom API status type.
+- `setLastMessage(message?: string): this` — Explicitly records a message.
+
+## Types
+
+#### `ApiStatusItem`
+A complete representation of a request status.
+- `status?: number` — HTTP status code.
+- `statusText?: string` — HTTP status text.
+- `error?: string` — Error message.
+- `lastResponse?: any` — Last response data.
+- `lastStatus?: ApiStatusType` — Last status type.
+- `lastMessage?: string` — Last message.

package/src/media/functional/functional-basic/classes/ApiStatus/ApiStatus.ru.mdx

@@ -4,50 +4,47 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс ApiStatus
 
-Класс для отслеживания и управления состоянием API-запроса. Надежно хранит текущий HTTP-статус, сообщения об ошибках и обработанное тело ответа, позволяя приложениям реагировать на изменения в реальном времени, используя абстракции состояния.
+Класс, предназначенный для отслеживания и управления состоянием API-запроса. Он надежно хранит текущий HTTP-статус, сообщения об ошибках и тело ответа, позволяя приложениям реагировать на изменения в реальном времени с помощью абстракций состояния.
+
+> `ApiStatus` является **вспомогательным классом**, предназначенным для отслеживания состояний запросов. В большинстве случаев рекомендуется взаимодействовать со статусом запроса через свойство `status` результата `ApiInstance` или глобальный цикл выполнения `Api`.
 
 ## Ключевые особенности
 
-- **Централизованное состояние** — хранит всё, что связано с результатом вызова API: HTTP-статус, пользовательские тексты, сырые данные ответа и сгенерированные сообщения.
-- **Цепочки вызовов** — методы возвращают `this`, позволяя лаконично обновлять несколько полей состояния друг за другом.
-- **Автоматическое извлечение сообщений** — интеллектуально пытается разобрать и извлечь читаемые человеком поля `message` напрямую из структурированных ответов сервера.
+- **Централизованное состояние** — содержит всё, что связано с результатом вызова API: HTTP-статус, пользовательские тексты, необработанные данные ответа и сгенерированные сообщения.
+- **Chainable API** — сеттеры возвращают `this`, что позволяет элегантно выстраивать цепочки изменений состояния.
+- **Автоматическое извлечение сообщений** — интеллектуально пытается разобрать и извлечь человекочитаемые поля `message` напрямую из структурированных ответов сервера.
+
+## Методы
 
-## Инициализация
+### Действие
 
-Для инициализации объекта вызовите конструктор `ApiStatus()`.
+- `getResponse<T>(): T | undefined` — Возвращает необработанный объем данных из последнего успешного запроса.
+- `getMessage(): string` — Возвращает сообщение сервера, извлеченное из успешного ответа, или сообщение, установленное вручную.
 
-```typescript
-import { ApiStatus } from '@dxtmisha/functional'
+### Проверка
 
-// 1. Простая инициализация
-const apiStatus = new ApiStatus()
+- `get(): ApiStatusItem | undefined` — Возвращает полный объект данных статуса.
+- `getStatus(): number | undefined` — Возвращает код HTTP-статуса (например, `200`).
+- `getStatusText(): string | undefined` — Возвращает текст статуса (например, `"OK"`).
+- `getStatusType(): ApiStatusType | undefined` — Возвращает последний тип валидации статуса.
+- `getError(): string | undefined` — Возвращает записанное сообщение об ошибке.
 
-// 2. Установка статуса ответа
-apiStatus.setStatus(200, 'OK')
+### Конфигурация
 
-// 3. Установка данных ответа и автоматическое извлечение сообщения
-apiStatus.setLastResponse({
-  status: 'success',
-  message: 'Данные успешно получены',
-  data: { id: 1 }
-})
-```
+- `set(data: ApiStatusItem): this` — Устанавливает несколько полей статуса одновременно.
+- `setStatus(status?: number, statusText?: string): this` — Устанавливает код и текст HTTP-статуса.
+- `setError(error?: string): this` — Записывает строку сообщения об ошибке.
+- `setLastResponse(response?: any): this` — Записывает ответ сервера и автоматически извлекает `message` и `status`, если они есть.
+- `setLastStatus(status?: ApiStatusType): this` — Устанавливает пользовательский тип статуса API.
+- `setLastMessage(message?: string): this` — Явно записывает сообщение.
 
-## Методы
+## Типы
 
-### Методы получения значений
-- `get(): ApiStatusItem` — Возвращает полный объект состояния последнего ответа.
-- `getStatus(): number | undefined` — Возвращает числовой HTTP статус (`200`, `404`).
-- `getStatusText(): string | undefined` — Возвращает текстовое объяснение (`"OK"`, `"Not Found"`).
-- `getStatusType(): ApiStatusType | undefined` — Возвращает тип последнего статуса.
-- `getError(): string | undefined` — Возвращает заданную строку ошибки.
-- `getResponse<T>(): T | undefined` — Возвращает переданные в качестве последнего ответа данные.
-- `getMessage(): string` — Возвращает последнюю сгенерированную или извлечённую строку сообщения сервера.
-
-### Методы установки значений
-- `set(data: ApiStatusItem): this` — Единовременно устанавливает несколько полей статуса.
-- `setStatus(status?: number, statusText?: string): this` — Устанавливает код ответов HTTP и опциональное текстовое пояснение.
-- `setError(error?: string): this` — Отмечает и сохраняет строку ошибки при неудачных запросах.
-- `setLastResponse(response?: any): this` — Сохраняет сырой ответ сервера и при наличии поля `message` автоматически заполняет его.
-- `setLastStatus(status?: ApiStatusType): this` — Задает конкретный тип финального статуса.
-- `setLastMessage(message?: string): this` — Принудительно задает текстовое сообщение из ответа сервера.
+#### `ApiStatusItem`
+Полное представление статуса запроса.
+- `status?: number` — Код HTTP-статуса.
+- `statusText?: string` — Текст HTTP-статуса.
+- `error?: string` — Сообщение об ошибке.
+- `lastResponse?: any` — Данные последнего ответа.
+- `lastStatus?: ApiStatusType` — Последний тип статуса.
+- `lastMessage?: string` — Последнее сообщение.

package/src/media/functional/functional-basic/classes/ApiStatus/ApiStatus.vi.mdx

@@ -4,50 +4,47 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Lớp ApiStatus
 
-Một lớp chuyên biệt dùng để theo dõi và quản lý các trạng thái của một yêu cầu API. Nó nắm giữ cục diện trạng thái HTTP hiện tại, thông báo báo lỗi, và hệ thống phân tích phản hồi data trả về, cho phép ứng dụng phản ứng kịp thời với những diễn biến theo thời gian thực chuẩn xác.
+Một lớp chuyên dụng để theo dõi và quản lý trạng thái của một yêu cầu API. Nó lưu trữ an toàn trạng thái HTTP hiện tại, thông điệp lỗi và nội dung phản hồi đã được phân tích cú pháp, cho phép các ứng dụng phản ứng với những thay đổi trong thời gian thực bằng cách sử dụng các trừu tượng trạng thái.
+
+> `ApiStatus` là một **lớp bổ trợ** (auxiliary class), được thiết kế để theo dõi trạng thái yêu cầu. Trong hầu hết các trường hợp, bạn nên tương tác với trạng thái yêu cầu thông qua thuộc tính `status` của kết quả `ApiInstance` hoặc luồng thực thi `Api` toàn cục.
 
 ## Các tính năng chính
 
-- **Trạng thái tập trung** — lưu giữ tất cả những yếu tố liên đới kết quả trả về của một API: mã luồng sự kiện HTTP, thông báo đặc quyền, giao thức đối tượng gốc...
-- **Nối tuyến API (Chainable API)** — bộ thiết lập trả về đối tượng luồng `this`, cho phép ghép nối và biến chuyển trạng thái nhiều cấp tiện lợi.
-- **Giải mã văn bản tự động** — thuật toán thiết lập cố gắng tự thân đọc hàm và bóc tách thư mục mang tên `message` thông dụng dưới tầng mã trực tiếp trích lấy từ chuỗi dữ liệu chủ lưu server.
+- **Trạng thái tập trung** — lưu giữ mọi thứ liên quan đến kết quả của một cuộc gọi API: trạng thái HTTP, văn bản tùy chỉnh, dữ liệu phản hồi thô và các thông điệp được tạo ra.
+- **Chainable API** — các phương thức thiết lập (setters) trả về `this`, cho phép xâu chuỗi nhiều thay đổi trạng thái một cách thanh lịch.
+- **Tự động trích xuất thông điệp** — cố gắng phân tích và lấy các trường `message` có thể đọc được trực tiếp từ các phản hồi có cấu trúc của máy chủ.
+
+## Các phương thức
 
-## Khởi tạo
+### Hành động
 
-Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `ApiStatus()`.
+- `getResponse<T>(): T | undefined` — Trả về dữ liệu thô từ yêu cầu thành công cuối cùng.
+- `getMessage(): string` — Trả về thông điệp máy chủ được lấy từ phản hồi thành công hoặc thông điệp được thiết lập thủ công.
 
-```typescript
-import { ApiStatus } from '@dxtmisha/functional'
+### Kiểm tra
 
-// 1. Khởi tạo đơn giản
-const apiStatus = new ApiStatus()
+- `get(): ApiStatusItem | undefined` — Trả về đối tượng dữ liệu trạng thái đầy đủ.
+- `getStatus(): number | undefined` — Trả về mã trạng thái HTTP (ví dụ: `200`).
+- `getStatusText(): string | undefined` — Trả về văn bản trạng thái (ví dụ: `"OK"`).
+- `getStatusType(): ApiStatusType | undefined` — Trả về loại xác thực trạng thái cuối cùng.
+- `getError(): string | undefined` — Trả về thông điệp lỗi đã ghi lại.
 
-// 2. Thiết lập trạng thái phản hồi
-apiStatus.setStatus(200, 'OK')
+### Cấu hình
 
-// 3. Thiết lập dữ liệu phản hồi và tự động trích xuất thông báo
-apiStatus.setLastResponse({
-  status: 'success',
-  message: 'Dữ liệu đã được tải thành công',
-  data: { id: 1 }
-})
-```
+- `set(data: ApiStatusItem): this` — Thiết lập nhiều trường trạng thái cùng một lúc.
+- `setStatus(status?: number, statusText?: string): this` — Thiết lập mã và văn bản trạng thái HTTP.
+- `setError(error?: string): this` — Ghi lại một chuỗi thông điệp lỗi.
+- `setLastResponse(response?: any): this` — Ghi lại phản hồi máy chủ và trích xuất siêu dữ liệu liên quan.
+- `setLastStatus(status?: ApiStatusType): this` — Thiết lập loại trạng thái API tùy chỉnh.
+- `setLastMessage(message?: string): this` — Ghi lại một thông điệp một cách rõ ràng.
 
-## Các phương thức
+## Các kiểu dữ liệu
 
-### Các phương thức lấy giá trị
-- `get(): ApiStatusItem` — Trả về mảng dữ liệu hiện thể trạng thái đầy đủ của đợt truy vấn cuối cùng.
-- `getStatus(): number | undefined` — Trả về số hạng trạng thái HTTP (như `200`, `404`).
-- `getStatusText(): string | undefined` — Trả về thông báo phân tích hiện trạng thái bằng mã lệnh chữ (ví dụ: `"OK"`).
-- `getStatusType(): ApiStatusType | undefined` — Trả về loại giao thức đối tượng xác thực kiểm duyệt chuỗi mới nhất.
-- `getError(): string | undefined` — Trả về dải cấu trúc lỗi đã được chủ ý ghi hình trước đó.
-- `getResponse<T>(): T | undefined` — Xuất thông tin gói cơ sở tài liệu gốc từ lệnh truy xuất gọi API thành công mới đây.
-- `getMessage(): string` — Lôi trực xuất lấy thông báo hệ thống được server kéo thả trong gói thành công.
-
-### Các phương thức thiết lập giá trị
-- `set(data: ApiStatusItem): this` — Thiết lập cùng lúc hàng loạt thông số hiện trạng vào máy móc.
-- `setStatus(status?: number, statusText?: string): this` — Nạp mã thông số báo HTTP và chuỗi mã số xác nhận tùy chọn vào guồng.
-- `setError(error?: string): this` — Khóa ghi lại thông báo tình trạng bị sập hầm mạng khi lệnh fetch cự tuyệt.
-- `setLastResponse(response?: any): this` — Gắn lưu hoàn chỉnh nguyên vẹn một chuỗi kết xuất server và đồng bộ tự nhận dạng mảng `.message`.
-- `setLastStatus(status?: ApiStatusType): this` — Trực tiếp định danh loại trạng thái cho tác vụ kết thúc chót.
-- `setLastMessage(message?: string): this` — Chủ định ép điền thông số hoặc đánh đè lên mã phản hồi `message`.
+#### `ApiStatusItem`
+Một đại diện đầy đủ của trạng thái yêu cầu.
+- `status?: number` — Mã trạng thái HTTP.
+- `statusText?: string` — Văn bản trạng thái HTTP.
+- `error?: string` — Thông điệp lỗi.
+- `lastResponse?: any` — Dữ liệu phản hồi thô.
+- `lastStatus?: ApiStatusType` — Danh mục xác thực.
+- `lastMessage?: string` — Thông điệp hiển thị đã trích xuất.