intelicoreact 2.0.9 → 2.0.10

package/dist/Classes/RESTAPI/index.d.ts

@@ -1,9 +1,31 @@
-export default RESTAPI;
-declare class RESTAPI extends ApiBase {
-    sendMessage: any;
-    credentialsProcessing: CredentialsProcessing;
-    doRequest(inputRequests: any, settings: any): Promise<any>;
-    doMonoRequest(requestSettings: any): Promise<any>;
-}
+import type { DoRequestSettings, RequestDescriptor, RequestInput, RESTAPISettings } from './partials/types';
 import ApiBase from './partials/ApiBase';
 import CredentialsProcessing from './partials/CredentialsProcessing';
+/**
+ * Класс REST API поверх AbortableFetch: формирует и выполняет запросы (одиночные и мультизапросы),
+ * управляет токенами авторизации (через {@link CredentialsProcessing}) и информированием пользователя.
+ * Расширяется реквест-крейтерами, утилитами и константами через объект настроек.
+ */
+declare class RESTAPI extends ApiBase {
+    /** Функция показа сообщений пользователю (или null, если информирование отключено). */
+    sendMessage: ((...args: unknown[]) => unknown) | null;
+    /** Обработчик учётных данных (создаётся при наличии настройки credentialsProcessing). */
+    credentialsProcessing?: CredentialsProcessing;
+    constructor(settings: RESTAPISettings);
+    /**
+     * Основной (базовый) метод API: выполняет мультизапрос (или одиночный запрос).
+     *
+     * @param inputRequests - путь, объект описания запроса или их массив.
+     * @param settings      - общие настройки запроса (формат ответа, тосты, сообщения и т.п.).
+     * @returns Промис с результатом (форма зависит от isResponseAsObject).
+     */
+    doRequest(inputRequests: RequestInput, settings?: DoRequestSettings): Promise<unknown>;
+    /**
+     * Метод API для одиночных запросов: применяет крейтер по `type` и делегирует в {@link RESTAPI.doRequest}.
+     *
+     * @param requestSettings - объект описания одиночного запроса (с необязательным `type`).
+     * @returns Промис с результатом запроса.
+     */
+    doMonoRequest(requestSettings: RequestDescriptor): Promise<unknown>;
+}
+export default RESTAPI;

package/dist/Classes/RESTAPI/partials/AbortableFetch.d.ts

@@ -1,43 +1,48 @@
-export default AbortableFetch;
+import type { HttpMethod, UnknownRecord } from './types';
+type ResponseCallback = (this: AbortableFetch, response: unknown) => unknown;
+export type AbortablePromise<T> = Promise<T> & {
+    abort: () => void;
+};
 declare class AbortableFetch {
-    constructor(input: any);
-    getPathPrefix(): any;
-    setPathPrefix(value: any): void;
-    getMethod(): any;
-    setMethod(value: any): void;
-    getQueryParameters(): any;
-    getQueryString(value: any): string;
-    setQueryParameters(value: any): void;
-    getHeaders(): any;
-    getHeadersObj(obj: any): Headers;
-    setHeaders(value: any): void;
-    getBody(): any;
-    setBody(value: any): void;
-    getOptions(): any;
-    setOptions(value: any): void;
-    getCallback(): any;
-    setCallback(value: any): void;
-    getCatchCallback(): any;
-    setCatchCallback(value: any): void;
-    getEveryPromiseCallback(): any;
-    setEveryPromiseCallback(value: any): void;
-    getIsResponseAsObject(): boolean;
-    setIsResponseAsObject(value: any): void;
-    getProps(): {
-        pathPrefix: any;
-        method: any;
-        queryParameters: any;
-        headers: any;
-        body: any;
-        options: any;
-        callback: any;
-        everyPromiseCallback: any;
-        isResponseAsObject: boolean;
-    };
-    setProps(input: any): void;
-    request(props: any): Promise<any>;
-    repeatRequest(): Promise<any>;
-    requestInput: any;
-    getQueryArray(value: any): any[];
     #private;
+    requestInput: string | UnknownRecord | Array<string | UnknownRecord>;
+    constructor(input?: UnknownRecord);
+    /**
+     * Выполняет один или несколько HTTP-запросов (нативный fetch) с возможностью отмены.
+     *
+     * Метод `abort()` навешивается на прототип возвращаемого промиса (как в исходной реализации),
+     * что позволяет отменить всю цепочку запросов вызовом `abort()` на возвращённом промисе.
+     *
+     * @param props - путь, объект описания запроса или их массив.
+     * @returns Промис с результатом (форма зависит от isResponseAsObject); на прототипе доступен `abort()`.
+     */
+    request(props: string | UnknownRecord | Array<string | UnknownRecord>): Promise<unknown>;
+    /** Повторяет последний выполненный запрос (ту же пачку). */
+    repeatRequest(): Promise<unknown>;
+    getPathPrefix(): string | null;
+    setPathPrefix(value?: string | null): void;
+    getMethod(): HttpMethod | null;
+    setMethod(value?: HttpMethod | null): void;
+    getQueryParameters(): string[] | null;
+    getQueryArray(value: unknown): string[];
+    getQueryString(value: string[] | null): string;
+    setQueryParameters(value?: string[] | null): void;
+    getHeaders(): UnknownRecord | null;
+    getHeadersObj(obj: UnknownRecord): Headers;
+    setHeaders(value?: UnknownRecord | null): void;
+    getBody(): unknown;
+    setBody(value: unknown): void;
+    getOptions(): UnknownRecord | null;
+    setOptions(value?: UnknownRecord | null): void;
+    getCallback(): ResponseCallback | null;
+    setCallback(value?: ResponseCallback | null): void;
+    getCatchCallback(): ResponseCallback | null;
+    setCatchCallback(value?: ResponseCallback | null): void;
+    getEveryPromiseCallback(): ResponseCallback | null;
+    setEveryPromiseCallback(value?: ResponseCallback | null): void;
+    getIsResponseAsObject(): boolean | 'always';
+    setIsResponseAsObject(value: unknown): void;
+    getProps(): UnknownRecord;
+    setProps(input: UnknownRecord): void;
 }
+export default AbortableFetch;

package/dist/Classes/RESTAPI/partials/ApiBase.d.ts

@@ -1,10 +1,21 @@
-export default ApiBase;
+import type { RESTAPISettings } from './types';
+import ApiRequestCreators from './ApiRequestCreators';
+/**
+ * Базовый класс API: разбирает и валидирует константы из настроек
+ * (API_PATH, тексты сообщений, REJECT_CODES) и раскладывает их на экземпляр.
+ * Кастомные константы прокидываются на экземпляр как есть.
+ */
 declare class ApiBase extends ApiRequestCreators {
-    API_PATH: string;
+    /** Текст ошибки невалидных данных запроса. */
     BAD_REQUEST_DATA_TEXT: string;
+    /** Текст сообщения об успехе по умолчанию. */
     DEFAULT_SUCCESS_MESSAGE: string;
+    /** Текст сообщения об ошибке по умолчанию. */
     DEFAULT_ERROR_MESSAGE: string;
+    /** Текст сообщения об отсутствии сети. */
     NO_INET: string;
+    /** Коды ответа, по которым запрос считается отклонённым. */
     REJECT_CODES: number[];
+    constructor(settings: RESTAPISettings);
 }
-import ApiRequestCreators from './ApiRequestCreators';
+export default ApiBase;

package/dist/Classes/RESTAPI/partials/ApiRequestCreators.d.ts

@@ -1,9 +1,58 @@
-export default ApiRequestCreators;
+import type { RequestDescriptor, RESTAPISettings, UnknownRecord } from './types';
+import ApiUtils from './ApiUtils';
+type CreatorResult = Promise<UnknownRecord | UnknownRecord[]>;
+/**
+ * Слой реквест-крейтеров: методы `createRequest_<type>`, которые конфигурируют обработку ответа
+ * под конкретный сценарий (toJson, blob, sse и т.д.) и возвращают аргументы для doRequest.
+ * Пользовательские крейтеры подключаются через настройку `requestsCreators`.
+ */
 declare class ApiRequestCreators extends ApiUtils {
-    createRequest_toJson(props: any, variant: any): Promise<any>;
-    createRequest_toJsonAdvanced(props: any, variant: any): Promise<any>;
-    createRequest_blob(props: any, variant: any): Promise<any>;
-    createRequest_testBadResponse(props: any, variant: any): Promise<any>;
-    createRequest_default(props: any, variant: any): Promise<any>;
+    constructor(settings?: RESTAPISettings);
+    /**
+     * Крейтер типа `toJson`: пользовательский callback получит тело ответа (Response.json()).
+     *
+     * @param props   - объект описания запроса.
+     * @param variant - вариант обработки splitProperties.
+     */
+    createRequest_toJson(props: RequestDescriptor, variant?: string): CreatorResult;
+    /**
+     * Крейтер типа `toJsonAdvanced`: callback получит структуру `{ response, result }`.
+     *
+     * @param props   - объект описания запроса.
+     * @param variant - вариант обработки splitProperties.
+     */
+    createRequest_toJsonAdvanced(props: RequestDescriptor, variant?: string): CreatorResult;
+    /**
+     * Крейтер типа `blob`: callback получит тело ответа (Response.blob()).
+     *
+     * @param props   - объект описания запроса.
+     * @param variant - вариант обработки splitProperties.
+     */
+    createRequest_blob(props: RequestDescriptor, variant?: string): CreatorResult;
+    /**
+     * Крейтер типа `sse`: обрабатывает ответ как поток Server-Sent Events (text/event-stream).
+     *
+     * Дополнительные пропы объекта описания запроса: `onEvent`, `onChunk`, `handlers`, `parseJson`.
+     * По умолчанию добавляется заголовок `Accept: text/event-stream`. Метод doRequest резолвится
+     * массивом всех событий ПОСЛЕ закрытия потока; отмена — методом `.abort()` возвращённого промиса.
+     *
+     * @param props   - объект описания запроса (плюс onEvent/onChunk/handlers/parseJson).
+     * @param variant - вариант обработки splitProperties.
+     */
+    createRequest_sse(props: RequestDescriptor, variant?: string): CreatorResult;
+    /**
+     * Крейтер типа `testBadResponse`: callback получит синтетический Response со статусом 401.
+     *
+     * @param props   - объект описания запроса.
+     * @param variant - вариант обработки splitProperties.
+     */
+    createRequest_testBadResponse(props: RequestDescriptor, variant?: string): CreatorResult;
+    /**
+     * Крейтер по умолчанию: callback получит объект Response (или тело ответа при isGetBody: 'first').
+     *
+     * @param props   - объект описания запроса.
+     * @param variant - вариант обработки splitProperties.
+     */
+    createRequest_default(props: RequestDescriptor, variant?: string): CreatorResult;
 }
-import ApiUtils from './ApiUtils';
+export default ApiRequestCreators;

package/dist/Classes/RESTAPI/partials/ApiUtils.d.ts

@@ -1,12 +1,63 @@
-export default ApiUtils;
+import type { AddAsCommonResult, RESTAPISettings, UnknownRecord } from './types';
+import Utils from './Utils';
+/**
+ * Утилитарный слой API: разбор настроек на части (splitProperties), извлечение тела ответа,
+ * проверка кода ответа и точки расширения (getRootPath / addAsCommon / processQueryParams).
+ * Поддерживает добавление пользовательских методов-утилит через настройку `utils`.
+ */
 declare class ApiUtils extends Utils {
-    constructor(settings: any);
-    splitProperties(apiParams: any, variant: any): Promise<any>;
-    getRootPath(): Promise<any>;
-    getResponseBody(response: any, getBodyAs: any): Promise<any>;
-    getErrorMessage(res: any): Promise<any>;
-    checkResponseCode(res: any, settings: any): Promise<any>;
-    addAsCommon(): Promise<{}>;
-    processQueryParams(queryParams: any): Promise<any>;
+    /** Корневой путь API (раскладывается в ApiBase из constants.API_PATH). */
+    API_PATH: string;
+    constructor(settings?: RESTAPISettings);
+    /**
+     * Разбирает единый объект параметров запроса на части в зависимости от варианта использования.
+     *
+     * @param apiParams - объединённые параметры запроса.
+     * @param variant   - `'doRequestMapping'` для мультизапроса либо `undefined` для одиночного.
+     * @returns Для `doRequestMapping` — объект параметров; иначе кортеж `[параметры, настройки]`.
+     */
+    splitProperties(apiParams: UnknownRecord, variant?: string): Promise<UnknownRecord | UnknownRecord[]>;
+    /**
+     * Обработчик пропы `api` из объекта описания запроса — возвращает корневой путь API.
+     *
+     * @returns Корневой путь (по умолчанию — API_PATH).
+     */
+    getRootPath(): Promise<string>;
+    /**
+     * Извлекает тело ответа в нужном виде (json/blob/text/arrayBuffer/formData) либо по content-type.
+     *
+     * @param response  - объект Response (иначе значение возвращается как есть).
+     * @param getBodyAs - желаемый способ извлечения тела.
+     * @returns Промис с телом ответа (или исходным значением / null при ошибке).
+     */
+    getResponseBody(response: unknown, getBodyAs?: string): Promise<unknown>;
+    /**
+     * Формирует структуру ошибки из тела ответа (точка расширения под формат бэкенда).
+     *
+     * @param res - уже извлечённое тело ответа.
+     * @returns Структура сообщения об ошибке.
+     */
+    getErrorMessage(res: unknown): Promise<unknown>;
+    /**
+     * Проверяет код ответа и (если задан sendMessage) информирует пользователя об успехе/ошибке.
+     *
+     * @param res      - объект Response (или совместимый с полем `ok`).
+     * @param settings - сообщения и настройки тостов для данного запроса.
+     * @returns Исходный `res` (метод не меняет ответ, только сигналит сообщением).
+     */
+    checkResponseCode(res: unknown, settings?: UnknownRecord): Promise<unknown>;
+    /**
+     * Структуры, которые будут использоваться для КАЖДОГО запроса, сделанного экземпляром RESTAPI.
+     *
+     * @returns Объект `{ headers, queryParameters, options }` (по умолчанию пустой).
+     */
+    addAsCommon(): Promise<AddAsCommonResult>;
+    /**
+     * Общий обработчик query-параметров (точка расширения, напр. кодирование/приведение к массиву).
+     *
+     * @param queryParams - входные query-параметры.
+     * @returns Обработанные query-параметры (по умолчанию — без изменений).
+     */
+    processQueryParams(queryParams: unknown): Promise<unknown>;
 }
-import Utils from './Utils';
+export default ApiUtils;

package/dist/Classes/RESTAPI/partials/CredentialsProcessing.d.ts

@@ -1,24 +1,79 @@
-export function decodeJWT(token: any): any;
-export default CredentialsProcessing;
+import type { CredentialsState, RESTAPISettings, UnknownRecord } from './types';
+/**
+ * Декодирует payload JWT-токена.
+ *
+ * @param token - JWT-строка вида `header.payload.signature`.
+ * @returns Распарсенный payload (объект) либо `null`, если декодирование не удалось.
+ */
+export declare function decodeJWT(token: string): UnknownRecord | null;
+/**
+ * Обработчик учётных данных (токенов): добавляет токен в запросы и (опционально) реализует
+ * флоу рефреша токенов. Конфигурируется через настройку `credentialsProcessing`.
+ */
 declare class CredentialsProcessing {
-    constructor(settings: any);
-    isUseRefreshTokensPropcessing: any;
-    DEFAULT_CREDENTIALS: {};
-    getCredentialsByOuter: any;
-    getHeadersForAuthorize: any;
-    importCredentials: any;
-    saveCredentials: any;
-    refreshCredentialsByOuter: any;
-    REFRESH_TOKEN_PATH: any;
-    CODES_USING_THE_REFRESH_ATTEMPT: number[];
+    [key: string]: unknown;
+    /** Включён ли флоу рефреша токенов. */
+    isUseRefreshTokensPropcessing: boolean;
+    /** Учётные данные по умолчанию (пустые). */
+    DEFAULT_CREDENTIALS: CredentialsState;
+    /** Внешний метод получения учётных данных. */
+    getCredentialsByOuter: () => unknown;
+    /** Внешний метод формирования заголовков авторизации по токену. */
+    getHeadersForAuthorize: (token: string) => UnknownRecord;
+    /** Необязательный преобразователь учётных данных после getCredentials. */
+    importCredentials?: (cred: unknown) => unknown;
+    /** Необязательный метод сохранения учётных данных (обязателен для флоу рефреша). */
+    saveCredentials?: (cred: unknown) => unknown;
+    /** Внешний метод рефреша учётных данных. */
+    refreshCredentialsByOuter?: (cred: CredentialsState) => unknown;
+    /** Полный путь до эндпоинта рефреша токена. */
+    REFRESH_TOKEN_PATH?: string;
+    /** Коды ответа, по которым триггерится попытка рефреша. */
+    CODES_USING_THE_REFRESH_ATTEMPT?: number[];
+    /** Ключ флага «рефреш начат» в localStorage. */
     REFRESH_TOKEN_FLAG: string;
+    /** Интервал опроса флага обновления токена, мс. */
     INTERVAL_FOR_CHECKING_TOKEN_UPDATE: number;
-    callbackAfterRejectRefresh: any;
-    getIsTokenStartRefresh(): string;
+    /** Колбэк, вызываемый после неудачного рефреша. */
+    callbackAfterRejectRefresh?: () => unknown;
+    /** Доступ к верхнему контексту RESTAPI (навешивается из конструктора RESTAPI). */
+    getRESTAPIContext?: () => unknown;
+    constructor(settings: RESTAPISettings);
+    /** Возвращает значение флага «рефреш начат» из localStorage. */
+    getIsTokenStartRefresh(): string | null;
+    /** Выставляет флаг «рефреш начат» в localStorage. */
     setIsTokenStartRefresh(): void;
+    /** Снимает флаг «рефреш начат» из localStorage. */
     removeIsTokenStartRefresh(): void;
-    getCredentials(isCatchCallbackProcess: any, callback: any): Promise<any>;
-    refreshCredentials(currentCredentials: any, callback: any): Promise<any>;
-    waitRefresh(isNeedRefresh: any): Promise<any>;
-    processCredentials(cred: any): Promise<any>;
+    /**
+     * Возвращает текущие учётные данные (с учётом importCredentials и проверки истечения JWT).
+     *
+     * @param isCatchCallbackProcess - флаг процесса обработки ошибки (отключает проверку истечения).
+     * @param callback               - необязательный колбэк, получающий итоговые учётные данные.
+     * @returns Промис с учётными данными.
+     */
+    getCredentials(isCatchCallbackProcess?: boolean, callback?: (cred: CredentialsState) => unknown): Promise<CredentialsState>;
+    /**
+     * Выполняет рефреш учётных данных (внешним методом либо дефолтным OAuth-флоу).
+     *
+     * @param currentCredentials - текущие учётные данные.
+     * @param callback           - необязательный колбэк сохранения новых учётных данных.
+     * @returns Промис с новыми учётными данными.
+     */
+    refreshCredentials(currentCredentials: CredentialsState, callback?: (cred: CredentialsState) => unknown): Promise<CredentialsState>;
+    /**
+     * Ожидает завершения рефреша токена (или запускает его флаг при необходимости).
+     *
+     * @param isNeedRefresh - выставить ли флаг «рефреш начат» при отсутствии активного рефреша.
+     * @returns Промис, который резолвится по завершении ожидания.
+     */
+    waitRefresh(isNeedRefresh?: boolean): Promise<void>;
+    /**
+     * Обрабатывает учётные данные: при необходимости рефрешит токен и возвращает актуальные данные.
+     *
+     * @param cred - текущие учётные данные.
+     * @returns Промис с актуальными учётными данными (с флагом isRefreshFailed при неудаче).
+     */
+    processCredentials(cred: CredentialsState): Promise<CredentialsState>;
 }
+export default CredentialsProcessing;

package/dist/Classes/RESTAPI/partials/Utils.d.ts

@@ -1,4 +1,20 @@
-export default Utils;
+import type { UnknownRecord } from './types';
+interface NormalizeQueryParamsSettings {
+    isEncode?: boolean;
+    outputAs?: 'string' | 'object' | 'array';
+}
 declare class Utils {
-    normalizeQueryParams(queryParams: any, settings: any): {};
+    [key: string]: unknown;
+    /**
+     * Нормализатор сложных query-параметров.
+     *
+     * Например: `&key1=&&&===&&&key2====&&&&&&&&key3=...`. Для корректной работы на вход нужно подавать
+     * НЕ кодированные значения. По умолчанию выходные значения query-параметров НЕ кодируются.
+     *
+     * @param queryParams - query в виде строки, массива или объекта.
+     * @param settings    - формат вывода (`array` | `string` | `object`) и флаг кодирования.
+     * @returns Нормализованные query-параметры в выбранном формате.
+     */
+    normalizeQueryParams(queryParams: unknown, settings?: NormalizeQueryParamsSettings): string | UnknownRecord | string[];
 }
+export default Utils;

package/dist/Classes/RESTAPI/partials/_utils.d.ts

@@ -1,9 +1,54 @@
-export function getIsOnlyAnObject(input: any): boolean;
-export function addCustomMethods(data: any, prefix: any): void;
-export class addCustomMethods {
-    constructor(data: any, prefix: any);
-}
-export function getInstanceOfFetchSystem(isGetBody: any): Promise<any>;
-export function clone(input: any): any;
-export function omitKeys(obj?: {}, keys?: any[]): any;
-export function getResponseClone(res: any): Promise<any>;
+import type { FetchSystemContext, UnknownRecord } from './types';
+import AbortableFetch from './AbortableFetch';
+/**
+ * Type-guard: значение является «чистым» объектом-словарём.
+ * Отсекает примитивы, функции, null, массивы, Set и Map.
+ *
+ * @param input - проверяемое значение.
+ * @returns `true`, если значение — обычный объект (с сужением типа до {@link UnknownRecord}).
+ */
+export declare function getIsOnlyAnObject(input: unknown): input is UnknownRecord;
+/**
+ * Рекурсивно клонирует значение (примитивы возвращаются как есть, массивы и объекты — глубоко).
+ *
+ * @param input - клонируемое значение.
+ * @returns Глубокая копия значения.
+ */
+export declare function clone(input: unknown): unknown;
+/**
+ * Возвращает копию объекта без указанных ключей.
+ * (принимает обьект и массив ключей обьекта, возвращает обьект с теми полями, которых нет в массиве ключей)
+ *
+ * @param obj  - исходный объект.
+ * @param keys - ключи, которые нужно исключить.
+ * @returns Новый объект без перечисленных ключей.
+ */
+export declare function omitKeys(obj?: UnknownRecord, keys?: string[]): UnknownRecord;
+/**
+ * Клонирует Response через нативный `clone()`, а прочие значения — глубоким {@link clone}.
+ *
+ * @param res - объект Response либо произвольное значение.
+ * @returns Промис с клоном значения.
+ */
+export declare function getResponseClone(res: unknown): Promise<unknown>;
+/**
+ * Добавляет на экземпляр (`this`) пользовательские методы из объекта `data` (опционально с префиксом).
+ * Копируются только значения-функции.
+ *
+ * @param this   - целевой экземпляр (передаётся через `.call`).
+ * @param data   - словарь методов для добавления.
+ * @param prefix - необязательный префикс имени метода.
+ */
+export declare function addCustomMethods(this: UnknownRecord, data: UnknownRecord, prefix?: string): void;
+/**
+ * Готовит и настраивает экземпляр {@link AbortableFetch} для текущего контекста API.
+ *
+ * Подмешивает токены авторизации (если включён credentialsProcessing), общие заголовки/опции
+ * из `addAsCommon`, а также навешивает everyPromiseCallback (обработка кодов ответа) и
+ * catchCallback (флоу рефреша токенов).
+ *
+ * @param this      - контекст экземпляра API (см. {@link FetchSystemContext}).
+ * @param isGetBody - извлекать ли тело ответа в everyPromiseCallback.
+ * @returns Промис с экземпляром {@link AbortableFetch} либо `null`, если рефреш токена не удался.
+ */
+export declare function getInstanceOfFetchSystem(this: FetchSystemContext, isGetBody?: boolean): Promise<AbortableFetch | null>;

package/dist/Classes/RESTAPI/partials/sse.d.ts

@@ -0,0 +1,27 @@
+import type { SSEEvent, SSEReadOptions, StreamResponseLike } from './types';
+/**
+ * Парсит один блок SSE (текст между пустыми строками) в объект события.
+ *
+ * Возвращает `null`, если в блоке не оказалось ни одного значимого поля
+ * (например, блок состоял только из комментариев/heartbeat-а).
+ *
+ * @param block - сырой текстовый блок SSE (без завершающей пустой строки).
+ * @returns Разобранное событие {@link SSEEvent} либо `null`.
+ */
+export declare function parseSSEEvent(block: string): SSEEvent | null;
+/**
+ * Читает тело Response как поток Server-Sent Events.
+ *
+ * Резолвится массивом всех полученных событий ПОСЛЕ закрытия потока.
+ * Прерывание потока через `AbortController` трактуется как штатное завершение
+ * (возвращается то, что успели собрать); любая иная ошибка чтения пробрасывается выше.
+ *
+ * @param response          - объект Response (или duck-typed с `body.getReader()`).
+ * @param options           - колбэки и опции обработки потока (см. {@link SSEReadOptions}).
+ * @param options.onEvent   - вызывается на каждое распарсенное событие.
+ * @param options.onChunk   - вызывается на полезную нагрузку (поле data) каждого события.
+ * @param options.handlers  - карта `{ имяСобытия: cb }` для обработки по полю `event`.
+ * @param options.parseJson - если `true`, поле `data` прогоняется через `JSON.parse`.
+ * @returns Промис с массивом всех распарсенных событий {@link SSEEvent}.
+ */
+export declare function readSSE(response: StreamResponseLike, { onEvent, onChunk, handlers, parseJson }?: SSEReadOptions): Promise<SSEEvent[]>;