intelicoreact 2.0.18 → 2.0.19

package/dist/es/Classes/RESTAPI/partials/ApiRequestCreators.js

@@ -0,0 +1,151 @@
+import { addCustomMethods, getIsOnlyAnObject, getResponseClone, omitKeys } from "./_utils.js";
+import ApiUtils from "./ApiUtils.js";
+import { readSSE } from "./sse.js";
+//#region src/Classes/RESTAPI/partials/ApiRequestCreators.ts
+function isStreamResponse(value) {
+	if (!getIsOnlyAnObject(value) || !value.ok) return false;
+	const body = value.body;
+	return typeof body === "object" && body !== null && "getReader" in body && typeof body.getReader === "function";
+}
+var PREFIX_OF_CLASS_UTILS = "createRequest_";
+/**
+* Слой реквест-крейтеров: методы `createRequest_<type>`, которые конфигурируют обработку ответа
+* под конкретный сценарий (toJson, blob, sse и т.д.) и возвращают аргументы для doRequest.
+* Пользовательские крейтеры подключаются через настройку `requestsCreators`.
+*/
+var ApiRequestCreators = class extends ApiUtils {
+	constructor(settings) {
+		super(settings);
+		const { requestsCreators } = settings || {};
+		if (getIsOnlyAnObject(requestsCreators)) addCustomMethods.call(this, requestsCreators, PREFIX_OF_CLASS_UTILS);
+	}
+	/**
+	* Крейтер типа `toJson`: пользовательский callback получит тело ответа (Response.json()).
+	*
+	* @param props   - объект описания запроса.
+	* @param variant - вариант обработки splitProperties.
+	*/
+	async createRequest_toJson(props, variant) {
+		const safelyProps = omitKeys(props, ["getBodyAs"]);
+		return this.splitProperties({
+			...safelyProps,
+			isGetBody: false,
+			callback: async (res) => {
+				const output = await this.getResponseBody(res, "json");
+				return await (props.callback?.(output) ?? output);
+			}
+		}, variant);
+	}
+	/**
+	* Крейтер типа `toJsonAdvanced`: callback получит структуру `{ response, result }`.
+	*
+	* @param props   - объект описания запроса.
+	* @param variant - вариант обработки splitProperties.
+	*/
+	async createRequest_toJsonAdvanced(props, variant) {
+		const safelyProps = omitKeys(props, ["getBodyAs"]);
+		return this.splitProperties({
+			...safelyProps,
+			isGetBody: false,
+			callback: async (res) => {
+				const output = {
+					response: res,
+					result: await this.getResponseBody(await getResponseClone(res), "json")
+				};
+				return await (props.callback?.(output) ?? output);
+			}
+		}, variant);
+	}
+	/**
+	* Крейтер типа `blob`: callback получит тело ответа (Response.blob()).
+	*
+	* @param props   - объект описания запроса.
+	* @param variant - вариант обработки splitProperties.
+	*/
+	async createRequest_blob(props, variant) {
+		const safelyProps = omitKeys(props, ["getBodyAs"]);
+		return this.splitProperties({
+			...safelyProps,
+			isGetBody: false,
+			callback: async (res) => {
+				const output = await this.getResponseBody(await getResponseClone(res), "blob");
+				return await (props.callback?.(output) ?? output);
+			}
+		}, variant);
+	}
+	/**
+	* Крейтер типа `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.
+	*/
+	async createRequest_sse(props, variant) {
+		const safelyProps = omitKeys(props, [
+			"getBodyAs",
+			"onChunk",
+			"onEvent",
+			"handlers",
+			"parseJson"
+		]);
+		const { onChunk, onEvent, handlers, parseJson } = props;
+		const sseOptions = {
+			onChunk: typeof onChunk === "function" ? (data, event) => onChunk(data, event) : void 0,
+			onEvent: typeof onEvent === "function" ? (event) => onEvent(event) : void 0,
+			parseJson: Boolean(parseJson),
+			handlers: getIsOnlyAnObject(handlers) ? Object.keys(handlers).reduce((acc, key) => {
+				const fn = handlers[key];
+				acc[key] = typeof fn === "function" ? (data, event) => fn(data, event) : void 0;
+				return acc;
+			}, {}) : void 0
+		};
+		return this.splitProperties({
+			...safelyProps,
+			headers: {
+				Accept: "text/event-stream",
+				...getIsOnlyAnObject(safelyProps.headers) ? safelyProps.headers : {}
+			},
+			isGetBody: false,
+			callback: async (res) => {
+				const output = isStreamResponse(res) ? await readSSE(res, sseOptions) : res;
+				return await (props.callback?.(output) ?? output);
+			}
+		}, variant);
+	}
+	/**
+	* Крейтер типа `testBadResponse`: callback получит синтетический Response со статусом 401.
+	*
+	* @param props   - объект описания запроса.
+	* @param variant - вариант обработки splitProperties.
+	*/
+	async createRequest_testBadResponse(props, variant) {
+		return this.splitProperties({
+			...props,
+			callback: async () => Promise.resolve(new Response(JSON.stringify({ errors: [{ message: "test bad Response" }] }), {
+				status: 401,
+				statusText: "test bad Response",
+				headers: (() => {
+					const headers = new Headers();
+					headers.append("content-type", "application/json");
+					return headers;
+				})()
+			})).then((res) => props.callback?.(res) ?? res)
+		}, variant);
+	}
+	/**
+	* Крейтер по умолчанию: callback получит объект Response (или тело ответа при isGetBody: 'first').
+	*
+	* @param props   - объект описания запроса.
+	* @param variant - вариант обработки splitProperties.
+	*/
+	async createRequest_default(props, variant) {
+		return this.splitProperties(props, variant);
+	}
+};
+//#endregion
+export { ApiRequestCreators as default };
+
+//# sourceMappingURL=ApiRequestCreators.js.map

package/dist/es/Classes/RESTAPI/partials/ApiRequestCreators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiRequestCreators.js","names":[],"sources":["../../../../../src/Classes/RESTAPI/partials/ApiRequestCreators.ts"],"sourcesContent":["import type { RequestDescriptor, RESTAPISettings, SSEEvent, SSEReadOptions, StreamResponseLike, UnknownRecord } from './types';\nimport { addCustomMethods, getIsOnlyAnObject, getResponseClone, omitKeys } from './_utils';\nimport ApiUtils from './ApiUtils';\nimport { readSSE } from './sse';\n\n// ? Результат любого крейтера — то, что возвращает splitProperties.\ntype CreatorResult = Promise<UnknownRecord | UnknownRecord[]>;\n\n// ? Type-guard: ответ пригоден для чтения как поток (есть тело с getReader и код ok).\nfunction isStreamResponse(value: unknown): value is StreamResponseLike {\n  if (!getIsOnlyAnObject(value) || !value.ok) return false;\n  const body = value.body;\n  return typeof body === 'object' && body !== null && 'getReader' in body && typeof body.getReader === 'function';\n}\n\n// ? Префикс createRequest_ добавляется к крейтерам с целью разгрузить пространство имен\nconst PREFIX_OF_CLASS_UTILS = 'createRequest_';\n\n/**\n * Слой реквест-крейтеров: методы `createRequest_<type>`, которые конфигурируют обработку ответа\n * под конкретный сценарий (toJson, blob, sse и т.д.) и возвращают аргументы для doRequest.\n * Пользовательские крейтеры подключаются через настройку `requestsCreators`.\n */\nclass ApiRequestCreators extends ApiUtils {\n  constructor(settings?: RESTAPISettings) {\n    super(settings);\n    const { requestsCreators } = settings || {};\n\n    if (getIsOnlyAnObject(requestsCreators)) addCustomMethods.call(this, requestsCreators, PREFIX_OF_CLASS_UTILS);\n  }\n\n  /**\n   * Крейтер типа `toJson`: пользовательский callback получит тело ответа (Response.json()).\n   *\n   * @param props   - объект описания запроса.\n   * @param variant - вариант обработки splitProperties.\n   */\n  // ? При типе toJson пользовательский callback на вход получит тело ответа реализованное методом Response.json()\n  // ? независимо от насторойки isGetBody\n  async createRequest_toJson(props: RequestDescriptor, variant?: string): CreatorResult {\n    const safelyProps = omitKeys(props, ['getBodyAs']);\n\n    return this.splitProperties(\n      {\n        ...safelyProps,\n        isGetBody: false,\n        callback: async (res: unknown) => {\n          const output = await this.getResponseBody(res, 'json');\n          return await (props.callback?.(output) ?? output);\n        },\n      },\n      variant,\n    );\n  }\n\n  /**\n   * Крейтер типа `toJsonAdvanced`: callback получит структуру `{ response, result }`.\n   *\n   * @param props   - объект описания запроса.\n   * @param variant - вариант обработки splitProperties.\n   */\n  // ? При типе toJsonAdvanced пользовательский callback на вход получит структуру { response, result },\n  // ? где response - объект Response, result - тело ответа реализованное методом Response.json()\n  // ? независимо от насторойки isGetBody\n  async createRequest_toJsonAdvanced(props: RequestDescriptor, variant?: string): CreatorResult {\n    const safelyProps = omitKeys(props, ['getBodyAs']);\n\n    return this.splitProperties(\n      {\n        ...safelyProps,\n        isGetBody: false,\n        callback: async (res: unknown) => {\n          const output = {\n            response: res,\n            result: await this.getResponseBody(await getResponseClone(res), 'json'),\n          };\n          return await (props.callback?.(output) ?? output);\n        },\n      },\n      variant,\n    );\n  }\n\n  /**\n   * Крейтер типа `blob`: callback получит тело ответа (Response.blob()).\n   *\n   * @param props   - объект описания запроса.\n   * @param variant - вариант обработки splitProperties.\n   */\n  // ? При типе blob пользовательский callback на вход получит тело ответа реализованное методом Response.blob(),\n  // ? независимо от насторойки isGetBody\n  async createRequest_blob(props: RequestDescriptor, variant?: string): CreatorResult {\n    const safelyProps = omitKeys(props, ['getBodyAs']);\n\n    return this.splitProperties(\n      {\n        ...safelyProps,\n        isGetBody: false,\n        callback: async (res: unknown) => {\n          const output = await this.getResponseBody(await getResponseClone(res), 'blob');\n          return await (props.callback?.(output) ?? output);\n        },\n      },\n      variant,\n    );\n  }\n\n  /**\n   * Крейтер типа `sse`: обрабатывает ответ как поток Server-Sent Events (text/event-stream).\n   *\n   * Дополнительные пропы объекта описания запроса: `onEvent`, `onChunk`, `handlers`, `parseJson`.\n   * По умолчанию добавляется заголовок `Accept: text/event-stream`. Метод doRequest резолвится\n   * массивом всех событий ПОСЛЕ закрытия потока; отмена — методом `.abort()` возвращённого промиса.\n   *\n   * @param props   - объект описания запроса (плюс onEvent/onChunk/handlers/parseJson).\n   * @param variant - вариант обработки splitProperties.\n   */\n  // ? При типе sse запрос обрабатывается как поток Server-Sent Events (text/event-stream).\n  // ? Дополнительные пропы объекта описания запроса:\n  // ?   - onEvent(event) — вызывается на каждое распарсенное событие { event, data, id, retry };\n  // ?   - onChunk(data, event) — вызывается на полезную нагрузку (поле data) каждого события;\n  // ?   - handlers — карта { имяСобытия: cb } для типизированной обработки по полю event\n  // ?     (например { delta, status, done }); cb получает (data, event);\n  // ?   - parseJson — если true, поле data каждого события прогоняется через JSON.parse.\n  // ? По умолчанию добавляется заголовок Accept: text/event-stream (его можно переопределить через headers).\n  // ? Пользовательский callback (если передан) на вход получит итоговый массив всех событий.\n  // ? Метод doRequest резолвится массивом всех событий ПОСЛЕ закрытия потока;\n  // ? отмена потока выполняется методом .abort() возвращённого промиса (через встроенный AbortController).\n  async createRequest_sse(props: RequestDescriptor, variant?: string): CreatorResult {\n    const safelyProps = omitKeys(props, ['getBodyAs', 'onChunk', 'onEvent', 'handlers', 'parseJson']);\n    const { onChunk, onEvent, handlers, parseJson } = props;\n\n    // ? Типобезопасно собираем опции потока из «сырых» пропов запроса (значения сужаем guard-ами).\n    const sseOptions: SSEReadOptions = {\n      onChunk: typeof onChunk === 'function' ? (data: unknown, event: SSEEvent) => onChunk(data, event) : undefined,\n      onEvent: typeof onEvent === 'function' ? (event: SSEEvent) => onEvent(event) : undefined,\n      parseJson: Boolean(parseJson),\n      handlers: getIsOnlyAnObject(handlers)\n        ? Object.keys(handlers).reduce<Record<string, ((data: unknown, event: SSEEvent) => void) | undefined>>((acc, key) => {\n          const fn = handlers[key];\n          acc[key] = typeof fn === 'function' ? (data: unknown, event: SSEEvent) => fn(data, event) : undefined;\n          return acc;\n        }, {})\n        : undefined,\n    };\n\n    return this.splitProperties(\n      {\n        ...safelyProps,\n        headers: { Accept: 'text/event-stream', ...(getIsOnlyAnObject(safelyProps.headers) ? safelyProps.headers : {}) },\n        isGetBody: false,\n        callback: async (res: unknown) => {\n          // ? Стримим только успешный ответ с читаемым телом.\n          // ? Иначе (ошибка/нет тела) отдаём res как есть — обработают checkResponseCode/catchCallback/пользователь.\n          const output = isStreamResponse(res) ? await readSSE(res, sseOptions) : res;\n          return await (props.callback?.(output) ?? output);\n        },\n      },\n      variant,\n    );\n  }\n\n  /**\n   * Крейтер типа `testBadResponse`: callback получит синтетический Response со статусом 401.\n   *\n   * @param props   - объект описания запроса.\n   * @param variant - вариант обработки splitProperties.\n   */\n  // ? При типе testBadResponse пользовательский callback на вход получит объект Response в 401-м статусе\n  // ? независимо независимо вообще ни от чего\n  async createRequest_testBadResponse(props: RequestDescriptor, variant?: string): CreatorResult {\n    return this.splitProperties(\n      {\n        ...props,\n        callback: async () =>\n          Promise.resolve(\n            new Response(JSON.stringify({ errors: [{ message: 'test bad Response' }] }), {\n              status: 401,\n              statusText: 'test bad Response',\n              headers: (() => {\n                const headers = new Headers();\n                headers.append('content-type', 'application/json');\n                return headers;\n              })(),\n            }),\n          ).then(res => props.callback?.(res) ?? res),\n      },\n      variant,\n    );\n  }\n\n  /**\n   * Крейтер по умолчанию: callback получит объект Response (или тело ответа при isGetBody: 'first').\n   *\n   * @param props   - объект описания запроса.\n   * @param variant - вариант обработки splitProperties.\n   */\n  // ? По умолчанию пользовательский callback на вход получит\n  // ?   - либо объект Response\n  // ?   - либо тело ответа (в случае isGetBody: 'first') полученное методом getResponseBody (смотри класс ApiUtils)\n  async createRequest_default(props: RequestDescriptor, variant?: string): CreatorResult {\n    return this.splitProperties(props, variant);\n  }\n}\n\nexport default ApiRequestCreators;\n"],"mappings":"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"}

package/dist/es/Classes/RESTAPI/partials/ApiUtils.js

@@ -0,0 +1,142 @@
+import { addCustomMethods, getIsOnlyAnObject, getResponseClone } from "./_utils.js";
+import Utils from "./Utils.js";
+//#region src/Classes/RESTAPI/partials/ApiUtils.ts
+/**
+* Утилитарный слой API: разбор настроек на части (splitProperties), извлечение тела ответа,
+* проверка кода ответа и точки расширения (getRootPath / addAsCommon / processQueryParams).
+* Поддерживает добавление пользовательских методов-утилит через настройку `utils`.
+*/
+var ApiUtils = class extends Utils {
+	/** Корневой путь API (раскладывается в ApiBase из constants.API_PATH). */
+	API_PATH;
+	constructor(settings) {
+		super();
+		const { utils } = settings || {};
+		if (getIsOnlyAnObject(utils)) addCustomMethods.call(this, utils);
+	}
+	/**
+	* Разбирает единый объект параметров запроса на части в зависимости от варианта использования.
+	*
+	* @param apiParams - объединённые параметры запроса.
+	* @param variant   - `'doRequestMapping'` для мультизапроса либо `undefined` для одиночного.
+	* @returns Для `doRequestMapping` — объект параметров; иначе кортеж `[параметры, настройки]`.
+	*/
+	async splitProperties(apiParams, variant) {
+		const { isResponseAsObject, isGetBody, finalCallback, isToastResult, toastOptions, isNoToastSuccess, isNoToastError, isNoToast, successMess, commonSuccessMessage, successMessages, successMessageType, errorMess, commonErrorMessage, errorMessages, ...restParams } = apiParams || {};
+		switch (variant) {
+			case "doRequestMapping": return {
+				...restParams,
+				isGetBody,
+				isToastResult,
+				toastOptions,
+				isNoToastSuccess,
+				isNoToastError,
+				isNoToast,
+				successMess,
+				commonSuccessMessage,
+				successMessages,
+				successMessageType,
+				errorMess,
+				commonErrorMessage,
+				errorMessages
+			};
+			default: return [restParams, {
+				isGetBody,
+				isResponseAsObject,
+				...finalCallback ? { callback: finalCallback } : {},
+				isToastResult,
+				toastOptions,
+				isNoToastSuccess,
+				isNoToastError,
+				isNoToast,
+				commonSuccessMessage: successMess || commonSuccessMessage,
+				successMessages,
+				successMessageType,
+				commonErrorMessage: errorMess || commonErrorMessage,
+				errorMessages
+			}];
+		}
+	}
+	/**
+	* Обработчик пропы `api` из объекта описания запроса — возвращает корневой путь API.
+	*
+	* @returns Корневой путь (по умолчанию — API_PATH).
+	*/
+	async getRootPath(_apiProp) {
+		return this.API_PATH;
+	}
+	/**
+	* Извлекает тело ответа в нужном виде (json/blob/text/arrayBuffer/formData) либо по content-type.
+	*
+	* @param response  - объект Response (иначе значение возвращается как есть).
+	* @param getBodyAs - желаемый способ извлечения тела.
+	* @returns Промис с телом ответа (или исходным значением / null при ошибке).
+	*/
+	async getResponseBody(response, getBodyAs) {
+		if (!(response instanceof Response)) return response;
+		const contentType = response.headers.get("content-type");
+		if (!contentType) return "";
+		const bodyReaders = {
+			json: (r) => r.json(),
+			blob: (r) => r.blob(),
+			text: (r) => r.text(),
+			arrayBuffer: (r) => r.arrayBuffer(),
+			formData: (r) => r.formData()
+		};
+		const isBodyKey = (key) => key in bodyReaders;
+		const reader = typeof getBodyAs === "string" && isBodyKey(getBodyAs) ? bodyReaders[getBodyAs] : contentType.includes("text/csv") ? bodyReaders.blob : contentType.includes("json") ? bodyReaders.json : bodyReaders.text;
+		try {
+			return await reader(response);
+		} catch {
+			console.log("Failed to extract the body");
+			return null;
+		}
+	}
+	/**
+	* Формирует структуру ошибки из тела ответа (точка расширения под формат бэкенда).
+	*
+	* @param res - уже извлечённое тело ответа.
+	* @returns Структура сообщения об ошибке.
+	*/
+	async getErrorMessage(res) {
+		return res;
+	}
+	/**
+	* Проверяет код ответа и (если задан sendMessage) информирует пользователя об успехе/ошибке.
+	*
+	* @param res      - объект Response (или совместимый с полем `ok`).
+	* @param settings - сообщения и настройки тостов для данного запроса.
+	* @returns Исходный `res` (метод не меняет ответ, только сигналит сообщением).
+	*/
+	async checkResponseCode(res, settings) {
+		const send = this.sendMessage;
+		if (typeof send !== "function") return res;
+		const { successMess, errorMess } = settings || {};
+		const message = (getIsOnlyAnObject(res) ? Boolean(res.ok) : false) ? successMess || this.DEFAULT_SUCCESS_MESSAGE : errorMess || await this.getErrorMessage(await this.getResponseBody(await getResponseClone(res)));
+		try {
+			send(message, settings, await getResponseClone(res));
+		} catch {}
+		return res;
+	}
+	/**
+	* Структуры, которые будут использоваться для КАЖДОГО запроса, сделанного экземпляром RESTAPI.
+	*
+	* @returns Объект `{ headers, queryParameters, options }` (по умолчанию пустой).
+	*/
+	async addAsCommon() {
+		return {};
+	}
+	/**
+	* Общий обработчик query-параметров (точка расширения, напр. кодирование/приведение к массиву).
+	*
+	* @param queryParams - входные query-параметры.
+	* @returns Обработанные query-параметры (по умолчанию — без изменений).
+	*/
+	async processQueryParams(queryParams) {
+		return queryParams;
+	}
+};
+//#endregion
+export { ApiUtils as default };
+
+//# sourceMappingURL=ApiUtils.js.map

package/dist/es/Classes/RESTAPI/partials/ApiUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiUtils.js","names":[],"sources":["../../../../../src/Classes/RESTAPI/partials/ApiUtils.ts"],"sourcesContent":["import type { AddAsCommonResult, RESTAPISettings, UnknownRecord } from './types';\nimport { addCustomMethods, getIsOnlyAnObject, getResponseClone } from './_utils';\nimport Utils from './Utils';\n\n/**\n * Утилитарный слой API: разбор настроек на части (splitProperties), извлечение тела ответа,\n * проверка кода ответа и точки расширения (getRootPath / addAsCommon / processQueryParams).\n * Поддерживает добавление пользовательских методов-утилит через настройку `utils`.\n */\nclass ApiUtils extends Utils {\n  /** Корневой путь API (раскладывается в ApiBase из constants.API_PATH). */\n  API_PATH!: string;\n\n  constructor(settings?: RESTAPISettings) {\n    super();\n    const { utils } = settings || {};\n    if (getIsOnlyAnObject(utils)) addCustomMethods.call(this, utils);\n  }\n\n  /**\n   * Разбирает единый объект параметров запроса на части в зависимости от варианта использования.\n   *\n   * @param apiParams - объединённые параметры запроса.\n   * @param variant   - `'doRequestMapping'` для мультизапроса либо `undefined` для одиночного.\n   * @returns Для `doRequestMapping` — объект параметров; иначе кортеж `[параметры, настройки]`.\n   */\n  // ? Планируется, что метод будет использоваться неизменно, однако технически его можно перегрузить на экземпляре\n  // ? Метод не планировался как асинхронный,\n  // ? однако ввиду того что он может быть перегружен на экземпляре асинхронность предусматривается\n  async splitProperties(apiParams: UnknownRecord, variant?: string): Promise<UnknownRecord | UnknownRecord[]> {\n    const {\n      isResponseAsObject,\n      isGetBody,\n      finalCallback,\n\n      isToastResult,\n      toastOptions,\n      isNoToastSuccess,\n      isNoToastError,\n      isNoToast,\n\n      successMess,\n      commonSuccessMessage,\n      successMessages,\n      successMessageType,\n\n      errorMess,\n      commonErrorMessage,\n      errorMessages,\n\n      ...restParams\n    } = apiParams || {};\n\n    switch (variant) {\n      case 'doRequestMapping':\n        return {\n          ...restParams,\n\n          isGetBody,\n\n          isToastResult,\n          toastOptions,\n          isNoToastSuccess,\n          isNoToastError,\n          isNoToast,\n\n          successMess,\n          commonSuccessMessage,\n          successMessages,\n          successMessageType,\n\n          errorMess,\n          commonErrorMessage,\n          errorMessages,\n        };\n      default:\n        return [\n          restParams,\n          {\n            isGetBody,\n            isResponseAsObject,\n            ...(finalCallback ? { callback: finalCallback } : {}),\n\n            isToastResult,\n            toastOptions,\n            isNoToastSuccess,\n            isNoToastError,\n            isNoToast,\n\n            commonSuccessMessage: successMess || commonSuccessMessage,\n            successMessages,\n            successMessageType,\n\n            commonErrorMessage: errorMess || commonErrorMessage,\n            errorMessages,\n          },\n        ];\n    }\n  }\n\n  /**\n   * Обработчик пропы `api` из объекта описания запроса — возвращает корневой путь API.\n   *\n   * @returns Корневой путь (по умолчанию — API_PATH).\n   */\n  // ! Обработчик пропы api из объекта описания запроса\n  // ? Планируется, что метод будет перегружаться на экземпляре,\n  // ? т.к. на разных проектах могут быть разные интерпретации пропы api\n  // ? Метод не планировался как асинхронный,\n  // ? однако ввиду того что он может быть перегружен на экземпляре асинхронность предусматривается\n  async getRootPath(_apiProp?: unknown): Promise<string> {\n    // ? Базовая реализация игнорирует apiProp и отдаёт API_PATH.\n    // ? Переопределяется на экземпляре (через settings.utils), где apiProp (поле `api`\n    // ? объекта описания запроса) используется для вычисления корневого пути.\n    return this.API_PATH;\n  }\n\n  /**\n   * Извлекает тело ответа в нужном виде (json/blob/text/arrayBuffer/formData) либо по content-type.\n   *\n   * @param response  - объект Response (иначе значение возвращается как есть).\n   * @param getBodyAs - желаемый способ извлечения тела.\n   * @returns Промис с телом ответа (или исходным значением / null при ошибке).\n   */\n  // ? Планируется, что метод будет использоваться неизменно, однако технически его можно перегрузить на экземпляре\n  // ? Метод планировался как асинхронный\n  async getResponseBody(response: unknown, getBodyAs?: string): Promise<unknown> {\n    // ? Если response не экземпляр Response, то вернуть по факту\n    if (!(response instanceof Response)) return response;\n\n    // ? В этом месте все методы должны быть, т.к. response точно экземпляр Response.\n    // ? А вот contentType-а походу может не быть. Наверное...\n    const contentType = response.headers.get('content-type');\n    if (!contentType) return '';\n\n    // ? Набор «читателей» тела Response — типобезопасная замена динамического response[getBodyAs].\n    const bodyReaders = {\n      json: (r: Response) => r.json(),\n      blob: (r: Response) => r.blob(),\n      text: (r: Response) => r.text(),\n      arrayBuffer: (r: Response) => r.arrayBuffer(),\n      formData: (r: Response) => r.formData(),\n    };\n    const isBodyKey = (key: string): key is keyof typeof bodyReaders => key in bodyReaders;\n\n    // ToDo - ошибка была в получении executor-а...\n    // ToDo - Все было через if. В случае, если не попадало ни в одну if-ку, то возвращался undefined по умолчанию,\n    // ToDo - а после этот undefined пытался запустить через call...\n    const reader\n      = typeof getBodyAs === 'string' && isBodyKey(getBodyAs)\n        ? bodyReaders[getBodyAs]\n        : contentType.includes('text/csv')\n          ? bodyReaders.blob\n          : contentType.includes('json')\n            ? bodyReaders.json\n            : bodyReaders.text;\n\n    // обработка случаев краша метода json при отсутствии тела ответа\n    try {\n      return await reader(response);\n    }\n    catch {\n      // ? думаю стоит знать места, где ожидалось тело, а бэк его не положил\n      // eslint-disable-next-line no-console\n      console.log('Failed to extract the body');\n      return null;\n    }\n  }\n\n  /**\n   * Формирует структуру ошибки из тела ответа (точка расширения под формат бэкенда).\n   *\n   * @param res - уже извлечённое тело ответа.\n   * @returns Структура сообщения об ошибке.\n   */\n  // ! Обработчик структуры для ошибки (не рендер месседжа, а имеено формирование ошибки),\n  // ? Планируется, что метод будет перегружаться на экземпляре,\n  // ? т.к. на разных проектах могут быть разные структуры тела ответа для ошибки\n  // ? Метод не планировался как асинхронный,\n  // ? однако ввиду того что он может быть перегружен на экземпляре асинхронность предусматривается\n  // ? res - уже тело ответа\n  async getErrorMessage(res: unknown): Promise<unknown> {\n    return res;\n  }\n\n  /**\n   * Проверяет код ответа и (если задан sendMessage) информирует пользователя об успехе/ошибке.\n   *\n   * @param res      - объект Response (или совместимый с полем `ok`).\n   * @param settings - сообщения и настройки тостов для данного запроса.\n   * @returns Исходный `res` (метод не меняет ответ, только сигналит сообщением).\n   */\n  // ? Планируется, что метод будет использоваться неизменно, однако технически его можно перегрузить на экземпляре\n  // ? Метод планировался как асинхронный\n  async checkResponseCode(res: unknown, settings?: UnknownRecord): Promise<unknown> {\n    // ! При получении экземпляра, если sendMessage не является ф-ей,\n    // ! то это воспринимается как отключение шага информирования об ошибке запроса как такового\n    const send = this.sendMessage;\n    if (typeof send !== 'function') return res;\n\n    const { successMess, errorMess } = settings || {};\n\n    const isOk = getIsOnlyAnObject(res) ? Boolean(res.ok) : false;\n\n    const message = isOk\n      ? successMess || this.DEFAULT_SUCCESS_MESSAGE\n      : errorMess || (await this.getErrorMessage(await this.getResponseBody(await getResponseClone(res))));\n\n    try {\n      send(message, settings, await getResponseClone(res));\n    }\n    catch {\n      /* ошибки информирования не должны влиять на обработку ответа */\n    }\n    return res;\n  }\n\n  /**\n   * Структуры, которые будут использоваться для КАЖДОГО запроса, сделанного экземпляром RESTAPI.\n   *\n   * @returns Объект `{ headers, queryParameters, options }` (по умолчанию пустой).\n   */\n  // ? Суть метода:\n  // ? передать из вне структуры, которые будут использоваться для КАЖДОГО запроса сделанного экземпляром RESTAPI\n  // ! Данные затрут прочие настройки КРОМЕ данных по логике авторизации\n  // ? Планируется, что метод будет перегружаться на экземпляре\n  // ? Метод не планировался как асинхронный,\n  // ? однако ввиду того что он может быть перегружен на экземпляре асинхронность предусматривается\n  async addAsCommon(): Promise<AddAsCommonResult> {\n    // ! Планируемая структура { headers, queryParameters, options }, где\n    // !   - headers и options - объекты,\n    // !   - queryParameters - строка, массив или объект\n    return {};\n  }\n\n  /**\n   * Общий обработчик query-параметров (точка расширения, напр. кодирование/приведение к массиву).\n   *\n   * @param queryParams - входные query-параметры.\n   * @returns Обработанные query-параметры (по умолчанию — без изменений).\n   */\n  // ! Обработчик квери-параметров для общего процессинга,\n  // ! Например для кодирования decodeURIComponent или/и приведения в формат массива\n  // ? Планируется, что метод будет перегружаться на экземпляре,\n  // ? т.к. на разных проектах могут быть разные договоренности по форматам\n  // ? Метод не планировался как асинхронный,\n  // ? однако ввиду того что он может быть перегружен на экземпляре асинхронность предусматривается\n  async processQueryParams(queryParams: unknown): Promise<unknown> {\n    return queryParams;\n  }\n}\n\nexport default ApiUtils;\n"],"mappings":";;;;;;;;AASA,IAAM,WAAN,cAAuB,MAAM;;CAE3B;CAEA,YAAY,UAA4B;EACtC,MAAM;EACN,MAAM,EAAE,UAAU,YAAY,CAAC;EAC/B,IAAI,kBAAkB,KAAK,GAAG,iBAAiB,KAAK,MAAM,KAAK;CACjE;;;;;;;;CAYA,MAAM,gBAAgB,WAA0B,SAA4D;EAC1G,MAAM,EACJ,oBACA,WACA,eAEA,eACA,cACA,kBACA,gBACA,WAEA,aACA,sBACA,iBACA,oBAEA,WACA,oBACA,eAEA,GAAG,eACD,aAAa,CAAC;EAElB,QAAQ,SAAR;GACE,KAAK,oBACH,OAAO;IACL,GAAG;IAEH;IAEA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IAEA;IACA;IACA;GACF;GACF,SACE,OAAO,CACL,YACA;IACE;IACA;IACA,GAAI,gBAAgB,EAAE,UAAU,cAAc,IAAI,CAAC;IAEnD;IACA;IACA;IACA;IACA;IAEA,sBAAsB,eAAe;IACrC;IACA;IAEA,oBAAoB,aAAa;IACjC;GACF,CACF;EACJ;CACF;;;;;;CAYA,MAAM,YAAY,UAAqC;EAIrD,OAAO,KAAK;CACd;;;;;;;;CAWA,MAAM,gBAAgB,UAAmB,WAAsC;EAE7E,IAAI,EAAE,oBAAoB,WAAW,OAAO;EAI5C,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc;EACvD,IAAI,CAAC,aAAa,OAAO;EAGzB,MAAM,cAAc;GAClB,OAAO,MAAgB,EAAE,KAAK;GAC9B,OAAO,MAAgB,EAAE,KAAK;GAC9B,OAAO,MAAgB,EAAE,KAAK;GAC9B,cAAc,MAAgB,EAAE,YAAY;GAC5C,WAAW,MAAgB,EAAE,SAAS;EACxC;EACA,MAAM,aAAa,QAAiD,OAAO;EAK3E,MAAM,SACF,OAAO,cAAc,YAAY,UAAU,SAAS,IAClD,YAAY,aACZ,YAAY,SAAS,UAAU,IAC7B,YAAY,OACZ,YAAY,SAAS,MAAM,IACzB,YAAY,OACZ,YAAY;EAGtB,IAAI;GACF,OAAO,MAAM,OAAO,QAAQ;EAC9B,QACM;GAGJ,QAAQ,IAAI,4BAA4B;GACxC,OAAO;EACT;CACF;;;;;;;CAcA,MAAM,gBAAgB,KAAgC;EACpD,OAAO;CACT;;;;;;;;CAWA,MAAM,kBAAkB,KAAc,UAA4C;EAGhF,MAAM,OAAO,KAAK;EAClB,IAAI,OAAO,SAAS,YAAY,OAAO;EAEvC,MAAM,EAAE,aAAa,cAAc,YAAY,CAAC;EAIhD,MAAM,WAFO,kBAAkB,GAAG,IAAI,QAAQ,IAAI,EAAE,IAAI,SAGpD,eAAe,KAAK,0BACpB,aAAc,MAAM,KAAK,gBAAgB,MAAM,KAAK,gBAAgB,MAAM,iBAAiB,GAAG,CAAC,CAAC;EAEpG,IAAI;GACF,KAAK,SAAS,UAAU,MAAM,iBAAiB,GAAG,CAAC;EACrD,QACM,CAEN;EACA,OAAO;CACT;;;;;;CAaA,MAAM,cAA0C;EAI9C,OAAO,CAAC;CACV;;;;;;;CAcA,MAAM,mBAAmB,aAAwC;EAC/D,OAAO;CACT;AACF"}

package/dist/es/Classes/RESTAPI/partials/CredentialsProcessing.js

@@ -0,0 +1,212 @@
+import { getIsOnlyAnObject } from "./_utils.js";
+//#region src/Classes/RESTAPI/partials/CredentialsProcessing.ts
+/**
+* Декодирует payload JWT-токена.
+*
+* @param token - JWT-строка вида `header.payload.signature`.
+* @returns Распарсенный payload (объект) либо `null`, если декодирование не удалось.
+*/
+function decodeJWT(token) {
+	try {
+		const payload = token.split(".")[1] ?? "";
+		const decoded = JSON.parse(atob(payload));
+		return getIsOnlyAnObject(decoded) ? decoded : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Обработчик учётных данных (токенов): добавляет токен в запросы и (опционально) реализует
+* флоу рефреша токенов. Конфигурируется через настройку `credentialsProcessing`.
+*/
+var CredentialsProcessing = class {
+	/** Включён ли флоу рефреша токенов. */
+	isUseRefreshTokensPropcessing = false;
+	/** Учётные данные по умолчанию (пустые). */
+	DEFAULT_CREDENTIALS = {};
+	/** Внешний метод получения учётных данных. */
+	getCredentialsByOuter;
+	/** Внешний метод формирования заголовков авторизации по токену. */
+	getHeadersForAuthorize;
+	/** Необязательный преобразователь учётных данных после getCredentials. */
+	importCredentials;
+	/** Необязательный метод сохранения учётных данных (обязателен для флоу рефреша). */
+	saveCredentials;
+	/** Внешний метод рефреша учётных данных. */
+	refreshCredentialsByOuter;
+	/** Полный путь до эндпоинта рефреша токена. */
+	REFRESH_TOKEN_PATH;
+	/** Коды ответа, по которым триггерится попытка рефреша. */
+	CODES_USING_THE_REFRESH_ATTEMPT;
+	/** Ключ флага «рефреш начат» в localStorage. */
+	REFRESH_TOKEN_FLAG = "refreshTokenFlag";
+	/** Интервал опроса флага обновления токена, мс. */
+	INTERVAL_FOR_CHECKING_TOKEN_UPDATE = 50;
+	/** Колбэк, вызываемый после неудачного рефреша. */
+	callbackAfterRejectRefresh;
+	/** Доступ к верхнему контексту RESTAPI (навешивается из конструктора RESTAPI). */
+	getRESTAPIContext;
+	constructor(settings) {
+		const { credentialsProcessing } = settings;
+		const { getCredentials, getHeadersForAuthorize, importCredentials, saveCredentials, isUseRefreshTokensPropcessing = false, refreshCredentials, REFRESH_TOKEN_PATH, CODES_USING_THE_REFRESH_ATTEMPT, REFRESH_TOKEN_FLAG = "refreshTokenFlag", INTERVAL_FOR_CHECKING_TOKEN_UPDATE = 50, callbackAfterRejectRefresh } = credentialsProcessing || {};
+		if (typeof getCredentials !== "function") throw new Error("No getCredentials method [CredentialsProcessing]");
+		if (typeof getHeadersForAuthorize !== "function") throw new TypeError("No getHeadersForAuthorize method [CredentialsProcessing]");
+		if (importCredentials && typeof importCredentials !== "function") throw new Error("Bad importCredentials method [CredentialsProcessing]");
+		this.isUseRefreshTokensPropcessing = Boolean(isUseRefreshTokensPropcessing);
+		this.DEFAULT_CREDENTIALS = {};
+		this.getCredentialsByOuter = () => getCredentials();
+		this.getHeadersForAuthorize = (token) => {
+			const result = getHeadersForAuthorize(token);
+			return getIsOnlyAnObject(result) ? result : {};
+		};
+		if (typeof importCredentials === "function") this.importCredentials = (cred) => importCredentials(cred);
+		if (saveCredentials || isUseRefreshTokensPropcessing) if (typeof saveCredentials !== "function") throw new Error("No saveCredentials method [CredentialsProcessing]");
+		else this.saveCredentials = (cred) => saveCredentials(cred);
+		if (isUseRefreshTokensPropcessing) {
+			if (typeof refreshCredentials === "function") this.refreshCredentialsByOuter = (cred) => refreshCredentials(cred);
+			else {
+				if (typeof this.refreshCredentialsByOuter === "function" && typeof REFRESH_TOKEN_PATH !== "string") throw new TypeError("No REFRESH_TOKEN_PATH [CredentialsProcessing]");
+				this.REFRESH_TOKEN_PATH = typeof REFRESH_TOKEN_PATH === "string" ? REFRESH_TOKEN_PATH : void 0;
+			}
+			if (!Array.isArray(CODES_USING_THE_REFRESH_ATTEMPT)) throw new TypeError("No CODES_USING_THE_REFRESH_ATTEMPT [CredentialsProcessing]");
+			if (!CODES_USING_THE_REFRESH_ATTEMPT.every((i) => typeof i === "number")) throw new Error("Invalid format of CODES_USING_THE_REFRESH_ATTEMPT elements [CredentialsProcessing]");
+			if (typeof REFRESH_TOKEN_FLAG !== "string") throw new Error("Bad REFRESH_TOKEN_FLAG [CredentialsProcessing]");
+			if (typeof INTERVAL_FOR_CHECKING_TOKEN_UPDATE !== "number") throw new TypeError("Bad INTERVAL_FOR_CHECKING_TOKEN_UPDATE [CredentialsProcessing]");
+			if (typeof INTERVAL_FOR_CHECKING_TOKEN_UPDATE !== "number") throw new TypeError("Bad INTERVAL_FOR_CHECKING_TOKEN_UPDATE [CredentialsProcessing]");
+			if (callbackAfterRejectRefresh && typeof callbackAfterRejectRefresh !== "function") throw new Error("Bad INTERVAL_FOR_CHECKING_TOKEN_UPDATE [CredentialsProcessing]");
+			this.CODES_USING_THE_REFRESH_ATTEMPT = CODES_USING_THE_REFRESH_ATTEMPT;
+			this.REFRESH_TOKEN_FLAG = REFRESH_TOKEN_FLAG;
+			this.INTERVAL_FOR_CHECKING_TOKEN_UPDATE = INTERVAL_FOR_CHECKING_TOKEN_UPDATE;
+			if (typeof callbackAfterRejectRefresh === "function") this.callbackAfterRejectRefresh = () => callbackAfterRejectRefresh();
+		}
+	}
+	/** Возвращает значение флага «рефреш начат» из localStorage. */
+	getIsTokenStartRefresh() {
+		return localStorage.getItem(this.REFRESH_TOKEN_FLAG);
+	}
+	/** Выставляет флаг «рефреш начат» в localStorage. */
+	setIsTokenStartRefresh() {
+		localStorage.setItem(this.REFRESH_TOKEN_FLAG, String(true));
+	}
+	/** Снимает флаг «рефреш начат» из localStorage. */
+	removeIsTokenStartRefresh() {
+		localStorage.removeItem(this.REFRESH_TOKEN_FLAG);
+	}
+	/**
+	* Возвращает текущие учётные данные (с учётом importCredentials и проверки истечения JWT).
+	*
+	* @param isCatchCallbackProcess - флаг процесса обработки ошибки (отключает проверку истечения).
+	* @param callback               - необязательный колбэк, получающий итоговые учётные данные.
+	* @returns Промис с учётными данными.
+	*/
+	async getCredentials(isCatchCallbackProcess, callback) {
+		let credentials = await this.getCredentialsByOuter();
+		if (typeof this.importCredentials === "function") credentials = await this.importCredentials(credentials);
+		const credObj = getIsOnlyAnObject(credentials) ? credentials : {};
+		const token = credObj.token || null;
+		if (token && !isCatchCallbackProcess) {
+			let decoded;
+			try {
+				decoded = decodeJWT(token);
+			} catch {
+				decoded = null;
+			}
+			const currentTime = Date.now() / 1e3;
+			if (decoded !== null && Number(decoded.exp) < currentTime) credObj.isNeedRefresh = true;
+		}
+		if (callback) await callback({
+			...credObj,
+			isCatchCallbackProcess
+		});
+		return {
+			...credObj,
+			isCatchCallbackProcess
+		};
+	}
+	/**
+	* Выполняет рефреш учётных данных (внешним методом либо дефолтным OAuth-флоу).
+	*
+	* @param currentCredentials - текущие учётные данные.
+	* @param callback           - необязательный колбэк сохранения новых учётных данных.
+	* @returns Промис с новыми учётными данными.
+	*/
+	async refreshCredentials(currentCredentials, callback) {
+		const CONTEXT = this;
+		async function finalize(cred) {
+			if (callback) await callback(cred);
+			return Promise.resolve(cred).then(async (res) => {
+				CONTEXT.removeIsTokenStartRefresh();
+				return res;
+			});
+		}
+		if (!currentCredentials?.token || !currentCredentials?.refreshToken) return finalize(CONTEXT.DEFAULT_CREDENTIALS);
+		async function refreshCredentialsByDefault() {
+			const { token, refreshToken } = currentCredentials;
+			const headers = new Headers(Object.entries(CONTEXT.getHeadersForAuthorize(token || "")).map(([key, value]) => [key, `${value}`]));
+			const body = new FormData();
+			body.append("grant_type", "refresh_token");
+			body.append("refresh_token", refreshToken || "");
+			body.append("client_id", "oauth");
+			body.append("client_secret", "secret");
+			body.append("access_type", "offline");
+			return fetch(`${CONTEXT.REFRESH_TOKEN_PATH}`, {
+				mode: "cors",
+				method: "POST",
+				headers,
+				body,
+				redirect: "follow"
+			});
+		}
+		const newCredentials = typeof CONTEXT.refreshCredentialsByOuter === "function" ? await CONTEXT.refreshCredentialsByOuter(currentCredentials) : await refreshCredentialsByDefault();
+		return finalize(getIsOnlyAnObject(newCredentials) ? newCredentials : CONTEXT.DEFAULT_CREDENTIALS);
+	}
+	/**
+	* Ожидает завершения рефреша токена (или запускает его флаг при необходимости).
+	*
+	* @param isNeedRefresh - выставить ли флаг «рефреш начат» при отсутствии активного рефреша.
+	* @returns Промис, который резолвится по завершении ожидания.
+	*/
+	async waitRefresh(isNeedRefresh) {
+		return new Promise((resolve) => {
+			if (!this.getIsTokenStartRefresh()) {
+				if (isNeedRefresh) this.setIsTokenStartRefresh();
+				resolve();
+			} else {
+				const intervalId = setInterval(() => {
+					if (!this.getIsTokenStartRefresh()) {
+						clearInterval(intervalId);
+						resolve();
+					}
+				}, this.INTERVAL_FOR_CHECKING_TOKEN_UPDATE);
+			}
+		});
+	}
+	/**
+	* Обрабатывает учётные данные: при необходимости рефрешит токен и возвращает актуальные данные.
+	*
+	* @param cred - текущие учётные данные.
+	* @returns Промис с актуальными учётными данными (с флагом isRefreshFailed при неудаче).
+	*/
+	async processCredentials(cred) {
+		if (!cred.isNeedRefresh && !cred.isCatchCallbackProcess) return cred;
+		const CONTEXT = this;
+		return CONTEXT.refreshCredentials(cred, (response) => CONTEXT.saveCredentials?.(response)).then(() => {
+			return new Promise((resolve) => {
+				setTimeout(async () => {
+					const newCredentials = await CONTEXT.getCredentials();
+					if (!newCredentials?.token) {
+						newCredentials.isRefreshFailed = true;
+						setTimeout(() => {
+							CONTEXT?.callbackAfterRejectRefresh?.();
+						}, 0);
+					}
+					resolve(newCredentials);
+				}, 0);
+			});
+		});
+	}
+};
+//#endregion
+export { decodeJWT, CredentialsProcessing as default };
+
+//# sourceMappingURL=CredentialsProcessing.js.map

package/dist/es/Classes/RESTAPI/partials/CredentialsProcessing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialsProcessing.js","names":[],"sources":["../../../../../src/Classes/RESTAPI/partials/CredentialsProcessing.ts"],"sourcesContent":["import type { CredentialsState, RESTAPISettings, UnknownRecord } from './types';\nimport { getIsOnlyAnObject } from './_utils';\n\n/**\n * Декодирует payload JWT-токена.\n *\n * @param token - JWT-строка вида `header.payload.signature`.\n * @returns Распарсенный payload (объект) либо `null`, если декодирование не удалось.\n */\nexport function decodeJWT(token: string): UnknownRecord | null {\n  try {\n    const payload = token.split('.')[1] ?? '';\n    const decoded: unknown = JSON.parse(atob(payload));\n    return getIsOnlyAnObject(decoded) ? decoded : null;\n  }\n  catch {\n    return null;\n  }\n}\n\n/**\n * Обработчик учётных данных (токенов): добавляет токен в запросы и (опционально) реализует\n * флоу рефреша токенов. Конфигурируется через настройку `credentialsProcessing`.\n */\nclass CredentialsProcessing {\n  // ? Индекс-сигнатура: getRESTAPIContext навешивается извне (из конструктора RESTAPI).\n  [key: string]: unknown;\n\n  /** Включён ли флоу рефреша токенов. */\n  isUseRefreshTokensPropcessing = false;\n\n  /** Учётные данные по умолчанию (пустые). */\n  DEFAULT_CREDENTIALS: CredentialsState = {};\n\n  /** Внешний метод получения учётных данных. */\n  getCredentialsByOuter!: () => unknown;\n\n  /** Внешний метод формирования заголовков авторизации по токену. */\n  getHeadersForAuthorize!: (token: string) => UnknownRecord;\n\n  /** Необязательный преобразователь учётных данных после getCredentials. */\n  importCredentials?: (cred: unknown) => unknown;\n\n  /** Необязательный метод сохранения учётных данных (обязателен для флоу рефреша). */\n  saveCredentials?: (cred: unknown) => unknown;\n\n  /** Внешний метод рефреша учётных данных. */\n  refreshCredentialsByOuter?: (cred: CredentialsState) => unknown;\n\n  /** Полный путь до эндпоинта рефреша токена. */\n  REFRESH_TOKEN_PATH?: string;\n\n  /** Коды ответа, по которым триггерится попытка рефреша. */\n  CODES_USING_THE_REFRESH_ATTEMPT?: number[];\n\n  /** Ключ флага «рефреш начат» в localStorage. */\n  REFRESH_TOKEN_FLAG = 'refreshTokenFlag';\n\n  /** Интервал опроса флага обновления токена, мс. */\n  INTERVAL_FOR_CHECKING_TOKEN_UPDATE = 50;\n\n  /** Колбэк, вызываемый после неудачного рефреша. */\n  callbackAfterRejectRefresh?: () => unknown;\n\n  /** Доступ к верхнему контексту RESTAPI (навешивается из конструктора RESTAPI). */\n  getRESTAPIContext?: () => unknown;\n\n  constructor(settings: RESTAPISettings) {\n    const { credentialsProcessing } = settings;\n    const {\n      // ? Для корректной работы установки токенов в запросы от API\n      // ? нужно передавать методы getCredentials и getHeadersForAuthorize\n      getCredentials,\n      getHeadersForAuthorize, // ? На вход получит токен, должна вернуть объект для коструктора Headers\n\n      // ? Так же опционально можно передавать\n      importCredentials, // ? если он передается, то он будет применяться к выводу от вызова getCredentials\n      saveCredentials, // ? можно будет найти в объекте credentialsProcessing, чтобы использовать кастомными методами\n\n      // ! Либо вызов getCredentials, либо цепочка вызовов importCredentials(getCredentials())\n      // ! должна возвращать требуемую классом структуру\n      // ! Класс требует структуры\n      // !   - { token }, если флоу рефреш токена НЕ используется\n      // !   - { token, refreshToken, expires }, если используется флоу рефреш токена\n\n      // *********\n\n      // ? Подключает флоу рефреша токенов\n      isUseRefreshTokensPropcessing = false,\n\n      // ! Для корректной работы флоу рефреша токенов передача метода saveCredentials становится ОБЯЗАТЕЛЬНОЙ\n\n      // ? Так же для корректной работы флоу рефреша токенов нужно\n      // ?   - либо\n      refreshCredentials, // ! метод должен возвращать такую же структуру как и метод getCredentials,\n      // ? на вход получит текущие креды, к выходу будет применен importCredentials, если этот метод передавался\n      // ?   - либо\n      REFRESH_TOKEN_PATH, // ! REFRESH_TOKEN_PATH передается ПОЛНОСТЬЮ (глобальная адресация)!\n      CODES_USING_THE_REFRESH_ATTEMPT, // ? указывает по каким кодам ответа триггериться рефреш, массив чисел\n\n      // ? Опционально\n      REFRESH_TOKEN_FLAG = 'refreshTokenFlag',\n      INTERVAL_FOR_CHECKING_TOKEN_UPDATE = 50, // ms\n      callbackAfterRejectRefresh,\n    } = credentialsProcessing || {};\n\n    if (typeof getCredentials !== 'function') throw new Error('No getCredentials method [CredentialsProcessing]');\n    if (typeof getHeadersForAuthorize !== 'function') {\n      throw new TypeError('No getHeadersForAuthorize method [CredentialsProcessing]');\n    }\n    if (importCredentials && typeof importCredentials !== 'function') {\n      throw new Error('Bad importCredentials method [CredentialsProcessing]');\n    }\n\n    this.isUseRefreshTokensPropcessing = Boolean(isUseRefreshTokensPropcessing);\n    this.DEFAULT_CREDENTIALS = {};\n    // ? Внешние функции оборачиваем в типизированные обёртки (без приведения типов / типа Function).\n    this.getCredentialsByOuter = () => getCredentials();\n    this.getHeadersForAuthorize = (token: string) => {\n      const result = getHeadersForAuthorize(token);\n      return getIsOnlyAnObject(result) ? result : {};\n    };\n    if (typeof importCredentials === 'function') this.importCredentials = (cred: unknown) => importCredentials(cred);\n\n    // ? Если метод передан или если не передан, но включен флоу обновления токенов (тогда saveCredentials обязателен)\n    if (saveCredentials || isUseRefreshTokensPropcessing) {\n      if (typeof saveCredentials !== 'function') throw new Error('No saveCredentials method [CredentialsProcessing]');\n      else this.saveCredentials = (cred: unknown) => saveCredentials(cred);\n    }\n\n    if (isUseRefreshTokensPropcessing) {\n      if (typeof refreshCredentials === 'function') {\n        this.refreshCredentialsByOuter = (cred: CredentialsState) => refreshCredentials(cred);\n      }\n      else {\n        if (typeof this.refreshCredentialsByOuter === 'function' && typeof REFRESH_TOKEN_PATH !== 'string') {\n          throw new TypeError('No REFRESH_TOKEN_PATH [CredentialsProcessing]');\n        }\n        this.REFRESH_TOKEN_PATH = typeof REFRESH_TOKEN_PATH === 'string' ? REFRESH_TOKEN_PATH : undefined;\n      }\n\n      if (!Array.isArray(CODES_USING_THE_REFRESH_ATTEMPT)) {\n        throw new TypeError('No CODES_USING_THE_REFRESH_ATTEMPT [CredentialsProcessing]');\n      }\n      if (!CODES_USING_THE_REFRESH_ATTEMPT.every(i => typeof i === 'number')) {\n        throw new Error('Invalid format of CODES_USING_THE_REFRESH_ATTEMPT elements [CredentialsProcessing]');\n      }\n\n      if (typeof REFRESH_TOKEN_FLAG !== 'string') throw new Error('Bad REFRESH_TOKEN_FLAG [CredentialsProcessing]');\n      if (typeof INTERVAL_FOR_CHECKING_TOKEN_UPDATE !== 'number') {\n        throw new TypeError('Bad INTERVAL_FOR_CHECKING_TOKEN_UPDATE [CredentialsProcessing]');\n      }\n      if (typeof INTERVAL_FOR_CHECKING_TOKEN_UPDATE !== 'number') {\n        throw new TypeError('Bad INTERVAL_FOR_CHECKING_TOKEN_UPDATE [CredentialsProcessing]');\n      }\n      if (callbackAfterRejectRefresh && typeof callbackAfterRejectRefresh !== 'function') {\n        throw new Error('Bad INTERVAL_FOR_CHECKING_TOKEN_UPDATE [CredentialsProcessing]');\n      }\n\n      this.CODES_USING_THE_REFRESH_ATTEMPT = CODES_USING_THE_REFRESH_ATTEMPT;\n      this.REFRESH_TOKEN_FLAG = REFRESH_TOKEN_FLAG;\n      this.INTERVAL_FOR_CHECKING_TOKEN_UPDATE = INTERVAL_FOR_CHECKING_TOKEN_UPDATE;\n\n      if (typeof callbackAfterRejectRefresh === 'function') this.callbackAfterRejectRefresh = () => callbackAfterRejectRefresh();\n    }\n  }\n\n  /** Возвращает значение флага «рефреш начат» из localStorage. */\n  getIsTokenStartRefresh(): string | null {\n    return localStorage.getItem(this.REFRESH_TOKEN_FLAG);\n  }\n\n  /** Выставляет флаг «рефреш начат» в localStorage. */\n  setIsTokenStartRefresh(): void {\n    localStorage.setItem(this.REFRESH_TOKEN_FLAG, String(true));\n  }\n\n  /** Снимает флаг «рефреш начат» из localStorage. */\n  removeIsTokenStartRefresh(): void {\n    localStorage.removeItem(this.REFRESH_TOKEN_FLAG);\n  }\n\n  /**\n   * Возвращает текущие учётные данные (с учётом importCredentials и проверки истечения JWT).\n   *\n   * @param isCatchCallbackProcess - флаг процесса обработки ошибки (отключает проверку истечения).\n   * @param callback               - необязательный колбэк, получающий итоговые учётные данные.\n   * @returns Промис с учётными данными.\n   */\n  async getCredentials(isCatchCallbackProcess?: boolean, callback?: (cred: CredentialsState) => unknown): Promise<CredentialsState> {\n    let credentials: unknown = await this.getCredentialsByOuter();\n\n    if (typeof this.importCredentials === 'function') credentials = await this.importCredentials(credentials);\n    const credObj: CredentialsState = getIsOnlyAnObject(credentials) ? credentials : {};\n\n    const token = credObj.token || null;\n\n    if (token && !isCatchCallbackProcess) {\n      let decoded: UnknownRecord | null;\n      try {\n        decoded = decodeJWT(token);\n      }\n      catch {\n        decoded = null;\n      }\n      const currentTime = Date.now() / 1000;\n      if (decoded !== null && Number(decoded.exp) < currentTime) credObj.isNeedRefresh = true;\n    }\n\n    if (callback) await callback({ ...credObj, isCatchCallbackProcess });\n    return { ...credObj, isCatchCallbackProcess };\n  }\n\n  /**\n   * Выполняет рефреш учётных данных (внешним методом либо дефолтным OAuth-флоу).\n   *\n   * @param currentCredentials - текущие учётные данные.\n   * @param callback           - необязательный колбэк сохранения новых учётных данных.\n   * @returns Промис с новыми учётными данными.\n   */\n  async refreshCredentials(currentCredentials: CredentialsState, callback?: (cred: CredentialsState) => unknown): Promise<CredentialsState> {\n    const CONTEXT = this;\n\n    async function finalize(cred: CredentialsState): Promise<CredentialsState> {\n      if (callback) await callback(cred);\n      return Promise.resolve(cred).then(async (res) => {\n        CONTEXT.removeIsTokenStartRefresh();\n        return res;\n      });\n    }\n\n    if (!currentCredentials?.token || !currentCredentials?.refreshToken) return finalize(CONTEXT.DEFAULT_CREDENTIALS);\n\n    // ! ВНИМАНИЕ! Данный механизм рефреша принят на проекте finturfreactfrontend (админка)\n    // ! На кабинете он ТОЧНО НЕ ТАКОЙ\n    async function refreshCredentialsByDefault(): Promise<Response> {\n      const { token, refreshToken } = currentCredentials;\n      // ? Заголовки авторизации формируем через конструктор Headers из пар «ключ-значение».\n      const headers = new Headers(Object.entries(CONTEXT.getHeadersForAuthorize(token || '')).map(([key, value]): [string, string] => [key, `${value}`]));\n\n      const body = new FormData();\n      body.append('grant_type', 'refresh_token');\n      body.append('refresh_token', refreshToken || '');\n      body.append('client_id', 'oauth');\n      body.append('client_secret', 'secret');\n      body.append('access_type', 'offline');\n\n      return fetch(`${CONTEXT.REFRESH_TOKEN_PATH}`, {\n        mode: 'cors',\n        method: 'POST',\n        headers,\n        body,\n        redirect: 'follow',\n      });\n    }\n\n    // ? Передавайте собственный refreshCredentials при получении экземляра RESTAPI, если не уверены,\n    // ? что механизм рефреша токенов ИМЕННО ТАКОЙ как в ф-и refreshCredentialsByDefault!\n    // ! currentCredentials передаются в формате класса! ({ token, refreshToken, expires })\n    const newCredentials\n      = typeof CONTEXT.refreshCredentialsByOuter === 'function'\n        ? await CONTEXT.refreshCredentialsByOuter(currentCredentials)\n        : await refreshCredentialsByDefault();\n\n    return finalize(getIsOnlyAnObject(newCredentials) ? newCredentials : CONTEXT.DEFAULT_CREDENTIALS);\n  }\n\n  /**\n   * Ожидает завершения рефреша токена (или запускает его флаг при необходимости).\n   *\n   * @param isNeedRefresh - выставить ли флаг «рефреш начат» при отсутствии активного рефреша.\n   * @returns Промис, который резолвится по завершении ожидания.\n   */\n  async waitRefresh(isNeedRefresh?: boolean): Promise<void> {\n    return new Promise<void>((resolve) => {\n      if (!this.getIsTokenStartRefresh()) {\n        if (isNeedRefresh) this.setIsTokenStartRefresh();\n        resolve();\n      }\n      else {\n        const intervalId = setInterval(() => {\n          if (!this.getIsTokenStartRefresh()) {\n            clearInterval(intervalId);\n            resolve();\n          }\n        }, this.INTERVAL_FOR_CHECKING_TOKEN_UPDATE);\n      }\n    });\n  }\n\n  /**\n   * Обрабатывает учётные данные: при необходимости рефрешит токен и возвращает актуальные данные.\n   *\n   * @param cred - текущие учётные данные.\n   * @returns Промис с актуальными учётными данными (с флагом isRefreshFailed при неудаче).\n   */\n  async processCredentials(cred: CredentialsState): Promise<CredentialsState> {\n    if (!cred.isNeedRefresh && !cred.isCatchCallbackProcess) return cred;\n\n    const CONTEXT = this;\n\n    return CONTEXT.refreshCredentials(cred, response => CONTEXT.saveCredentials?.(response)).then(() => {\n      return new Promise<CredentialsState>((resolve) => {\n        setTimeout(async () => {\n          const newCredentials = await CONTEXT.getCredentials();\n          if (!newCredentials?.token) {\n            newCredentials.isRefreshFailed = true;\n            setTimeout(() => {\n              CONTEXT?.callbackAfterRejectRefresh?.();\n            }, 0);\n          }\n          resolve(newCredentials);\n        }, 0);\n      });\n    });\n  }\n}\n\nexport default CredentialsProcessing;\n"],"mappings":"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"}