@hyperttp/interceptors 1.0.4 → 1.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IT IF OR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# hyperttp-interceptors

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "@hyperttp/interceptors",
-  "version": "1.0.4",
+  "version": "1.1.5",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "hyperttp"
   ],
@@ -14,7 +22,7 @@
     "url": "git+https://github.com/IT-IF-OR/hyperttp-interceptors.git"
   },
   "peerDependencies": {
-    "typescript": "^5",
-    "@hyperttp/core": "^1"
-  }
+    "@hyperttp/types": "^0.1.5"
+  },
+  "private": false
 }

package/plugin.d.ts

@@ -1,14 +1,34 @@
-import type { HyperPlugin } from "@hyperttp/core";
+import type { HyperPlugin } from "@hyperttp/types";
 import { InterceptorManager } from "./utils/InterceptorManager.js";
 import type { InterceptorOptions } from "./types/interceptors.js";
-export type Method = "GET" | "POST" | "PUT" | "PATCH" | "OPTIONS" | "DELETE" | "HEAD";
-declare module "@hyperttp/core" {
+/**
+ * @en Extends PluginContext to include the interceptor manager instance.
+ * @ru Расширяет PluginContext, добавляя экземпляр менеджера интерцепторов.
+ */
+declare module "@hyperttp/types" {
     interface PluginContext {
+        /**
+         * @en The active interceptor manager instance.
+         * @ru Активный экземпляр менеджера интерцепторов.
+         */
         interceptors?: InterceptorManager;
     }
+    /**
+     * @en Extends HttpClientOptions to include interceptor configuration.
+     * @ru Расширяет HttpClientOptions, добавляя конфигурацию интерцепторов.
+     */
     interface HttpClientOptions {
+        /**
+         * @en Interceptor plugin configuration options.
+         * @ru Опции конфигурации плагина интерцепторов.
+         */
         interceptors?: InterceptorOptions;
     }
 }
+/**
+ * @en Plugin for integrating custom request and response interceptors (Axios-like Interceptors).
+ * @ru Плагин для интеграции кастомных интерцепторов запросов и ответов (Axios-like Interceptors).
+ * @returns HyperPlugin object instance.
+ */
 export declare function withInterceptors(): HyperPlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,MAAM,MAAM,GACd,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,aAAa;QACrB,YAAY,CAAC,EAAE,kBAAkB,CAAC;KACnC;IAED,UAAU,iBAAiB;QACzB,YAAY,CAAC,EAAE,kBAAkB,CAAC;KACnC;CACF;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAmC9C"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;GAGG;AACH,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,aAAa;QACrB;;;WAGG;QACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;KACnC;IAED;;;OAGG;IACH,UAAU,iBAAiB;QACzB;;;WAGG;QACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;KACnC;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAsD9C"}

package/plugin.js

@@ -1,27 +1,55 @@
 import { InterceptorManager } from "./utils/InterceptorManager.js";
+/**
+ * @en Plugin for integrating custom request and response interceptors (Axios-like Interceptors).
+ * @ru Плагин для интеграции кастомных интерцепторов запросов и ответов (Axios-like Interceptors).
+ * @returns HyperPlugin object instance.
+ */
 export function withInterceptors() {
     let manager;
     return {
         name: "hyperttp-interceptors",
-        phase: "PREPARE",
+        /**
+         * @en Evaluates plugin activation based on the provided client configuration.
+         * @ru Проверяет активацию плагина на основе переданной конфигурации.
+         * @param config - The current client configuration.
+         * @returns True if interceptors are enabled.
+         */
         enabled: (config) => !!config.interceptors?.enabled,
-        setup(core) {
+        /**
+         * @en Initialization hook. Creates the interceptor manager and registers it within the core context.
+         * @ru Хук инициализации. Создает менеджер интерцепторов и регистрирует его в контексте ядра.
+         * @param ctx - Shared plugin orchestration context.
+         */
+        setup(ctx) {
             manager = new InterceptorManager();
-            core.interceptors = manager;
+            ctx.interceptors = manager;
         },
-        wrapDispatch: (next) => {
-            return (req) => {
-                if (!manager.hasRequest && !manager.hasResponse) {
-                    return next(req);
-                }
-                const reqResult = manager.applyRequest(req);
-                if (reqResult instanceof Promise) {
-                    return reqResult.then((finalReq) => {
-                        return next(finalReq || req).then((res) => manager.applyResponse(res));
-                    });
-                }
-                return next(reqResult || req).then((res) => manager.applyResponse(res));
-            };
+        /**
+         * @en Request phase interceptor hook. Sequentially applies all registered interceptors to the request configuration.
+         * @ru Перехватчик фазы запроса. Последовательно применяет все зарегистрированные интерцепторы к конфигурации запроса.
+         * @param req - Contextual internal request parameters.
+         */
+        async onRequest(req) {
+            if (!manager.hasRequest)
+                return;
+            const reqResult = await manager.applyRequest(req);
+            if (reqResult) {
+                Object.assign(req, reqResult);
+            }
+        },
+        /**
+         * @en Response phase interceptor hook. Passes the response object through the chain of custom modification interceptors.
+         * @ru Перехватчик фазы успешного ответа. Пропускает объект ответа через цепочку пользовательских интерцепторов модификации.
+         * @param res - Output HTTP client response reference.
+         * @param req - Contextual internal request parameters.
+         */
+        async onResponse(res) {
+            if (!manager.hasResponse)
+                return;
+            const resResult = await manager.applyResponse(res);
+            if (resResult) {
+                Object.assign(res, resResult);
+            }
         },
     };
 }

package/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAsBnE,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAA2B,CAAC;IAEhC,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC,MAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO;QAEtE,KAAK,CAAC,IAAI;YACR,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC9B,CAAC;QAED,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,OAAO,CAAI,GAAoB,EAA4B,EAAE;gBAC3D,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBAChD,OAAO,IAAI,CAAI,GAAG,CAAC,CAAC;gBACtB,CAAC;gBAED,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBAE5C,IAAI,SAAS,YAAY,OAAO,EAAE,CAAC;oBACjC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBACjC,OAAO,IAAI,CAAI,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAC3C,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAC3B,CAAC;oBACJ,CAAC,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,IAAI,CAAI,SAAS,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5C,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CACC,CAAC;YAChC,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AA6BnE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAA2B,CAAC;IAEhC,OAAO;QACL,IAAI,EAAE,uBAAuB;QAE7B;;;;;WAKG;QACH,OAAO,EAAE,CAAC,MAAyB,EAAW,EAAE,CAC9C,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO;QAEhC;;;;WAIG;QACH,KAAK,CAAC,GAAkB;YACtB,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC;QAC7B,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,SAAS,CAAC,GAAoB;YAClC,IAAI,CAAC,OAAO,CAAC,UAAU;gBAAE,OAAO;YAEhC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,UAAU,CAAC,GAAsB;YACrC,IAAI,CAAC,OAAO,CAAC,WAAW;gBAAE,OAAO;YAEjC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/types/interceptors.d.ts

@@ -1,20 +1,35 @@
+import type { InternalRequest, HttpResponse } from "@hyperttp/types";
+/**
+ * @en Configuration options for the interceptors plugin.
+ * @ru Опции конфигурации для плагина интерцепторов.
+ */
 export interface InterceptorOptions {
     /**
-     * @ru Включить перехватчики
-     * @en Enable interceptors
+     * @en Enable interceptor processing for the client.
+     * @ru Включить обработку интерцепторов для клиента.
      */
     enabled?: boolean;
 }
-export type RequestInterceptor = (config: {
-    url: string;
-    method: string;
-    headers: Record<string, string | string[]>;
-    body?: any;
-}) => any | Promise<any>;
-export type ResponseInterceptor = (response: {
-    status: number;
-    headers: Record<string, string | string[]>;
-    body: any;
-    url: string;
-}) => any | Promise<any>;
+/**
+ * @en Request interceptor function signature.
+ * Accepts the core internal request object. Can return a modified configuration
+ * or `void` (if modifications are applied directly to the passed object reference).
+ * @ru Перехватчик запроса.
+ * Принимает внутренний объект запроса ядра. Может вернуть модифицированный объект
+ * или `void` (если изменения вносятся напрямую в переданный объект по ссылке).
+ * @param config - The internal request configuration.
+ * @returns A modified request object, void, or a Promise resolving to either.
+ */
+export type RequestInterceptor = (config: InternalRequest) => InternalRequest | void | Promise<InternalRequest | void>;
+/**
+ * @en Response interceptor function signature.
+ * Accepts a response object with any body layout (`HttpResponse<any>`). Can return
+ * a transformed response container or `void` (if the object is mutated in-place).
+ * @ru Перехватчик ответа.
+ * Принимает объект ответа с любым типом тела (`HttpResponse<any>`). Может вернуть
+ * трансформированный объект ответа или `void` (если объект мутирует по ссылке).
+ * @param response - The HTTP response object.
+ * @returns A modified response object, void, or a Promise resolving to either.
+ */
+export type ResponseInterceptor = (response: HttpResponse<any>) => HttpResponse<any> | void | Promise<HttpResponse<any> | void>;
 //# sourceMappingURL=interceptors.d.ts.map

package/types/interceptors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../src/types/interceptors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,IAAI,EAAE,GAAG,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;CACb,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../src/types/interceptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,eAAe,KACpB,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,KACxB,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC"}

package/utils/InterceptorManager.d.ts

@@ -1,22 +1,84 @@
+import { InternalRequest, HttpResponse } from "@hyperttp/types";
 import { RequestInterceptor, ResponseInterceptor } from "../types/interceptors.js";
+/**
+ * @en Interceptor manager for pipeline execution of requests and responses.
+ * Uses a hybrid loop (fast-path): runs synchronously until a Promise is encountered.
+ * @ru Менеджер перехватчиков (интерцепторов) для сквозной обработки запросов и ответов.
+ * Использует гибридный цикл (fast-path): выполняется синхронно до тех пор, пока не встретит Promise.
+ */
 export declare class InterceptorManager {
+    /**
+     * @en Array of registered request interceptors.
+     * @ru Массив зарегистрированных перехватчиков запроса.
+     * @private
+     */
     private requestInterceptors;
+    /**
+     * @en Array of registered response interceptors.
+     * @ru Массив зарегистрированных перехватчиков ответа.
+     * @private
+     */
     private responseInterceptors;
+    /**
+     * @en Flag indicating presence of active request interceptors for fast branch short-circuiting.
+     * @ru Флаг наличия активных перехватчиков запроса для быстрого ветвления.
+     */
     hasRequest: boolean;
+    /**
+     * @en Flag indicating presence of active response interceptors for fast branch short-circuiting.
+     * @ru Флаг наличия активных перехватчиков ответа для быстрого ветвления.
+     */
     hasResponse: boolean;
+    /**
+     * @en Registers a new request interceptor in the pipeline.
+     * @ru Регистрирует новый перехватчик запроса в конвейере.
+     * @param interceptor - Target request interceptor function.
+     */
     addRequest(interceptor: RequestInterceptor): void;
+    /**
+     * @en Registers a new response interceptor in the pipeline.
+     * @ru Регистрирует новый перехватчик ответа в конвейере.
+     * @param interceptor - Target response interceptor function.
+     */
     addResponse(interceptor: ResponseInterceptor): void;
     /**
-     * Применяет реквест-интерцепторы.
-     * Возвращает либо измененный config, либо Promise с ним.
+     * @en Sequentially applies the chain of interceptors to the request configuration.
+     * @ru Последовательно применяет цепочку перехватчиков к конфигурации запроса.
+     * @param config - Initial internal request configuration object.
+     * @returns Modified configuration or a Promise resolving to it.
+     */
+    applyRequest(config: InternalRequest): InternalRequest | Promise<InternalRequest>;
+    /**
+     * @en Asynchronous fallback to process the remaining request chain after encountering a Promise.
+     * @ru Асинхронный фолбек для обработки оставшейся цепочки запросов после обнаружения Promise.
+     * @param startIndex - Index of the interceptor that returned a Promise.
+     * @param currentPromise - The pending Promise from the current interceptor step.
+     * @param currentResult - Cumulative configuration result before the Promise step.
+     * @private
      */
-    applyRequest(config: any): any;
     private applyRequestAsync;
     /**
-     * Применяет респонс-интерцепторы аналогичным гибридным способом.
+     * @en Sequentially applies the chain of interceptors to the incoming response container.
+     * @ru Последовательно применяет цепочку перехватчиков к полученному объекту ответа.
+     * @template T - Type mapping descriptor for the expected response payload body.
+     * @param response - Target HTTP response context wrapper.
+     * @returns Transformed response context or a Promise resolving to it.
+     */
+    applyResponse<T = unknown>(response: HttpResponse<T>): HttpResponse<T> | Promise<HttpResponse<T>>;
+    /**
+     * @en Asynchronous fallback to process the remaining response chain after encountering a Promise.
+     * @ru Асинхронный фолбек для обработки оставшейся цепочки ответов после обнаружения Promise.
+     * @template T - Type mapping descriptor for the expected response payload body.
+     * @param startIndex - Index of the interceptor that returned a Promise.
+     * @param currentPromise - The pending Promise from the current interceptor step.
+     * @param currentResult - Cumulative response result before the Promise step.
+     * @private
      */
-    applyResponse(response: any): any;
     private applyResponseAsync;
+    /**
+     * @en Completely flushes internal interceptor registers and resets state indicators.
+     * @ru Полностью очищает списки зарегистрированных перехватчиков и сбрасывает флаги.
+     */
     clear(): void;
 }
 //# sourceMappingURL=InterceptorManager.d.ts.map

package/utils/InterceptorManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InterceptorManager.d.ts","sourceRoot":"","sources":["../../src/utils/InterceptorManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,oBAAoB,CAA6B;IAElD,UAAU,UAAS;IACnB,WAAW,UAAS;IAE3B,UAAU,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAKjD,WAAW,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAKnD;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;YAgBhB,iBAAiB;IAuB/B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG;YAgBnB,kBAAkB;IAsBhC,KAAK,IAAI,IAAI;CAMd"}
+{"version":3,"file":"InterceptorManager.d.ts","sourceRoot":"","sources":["../../src/utils/InterceptorManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAA4B;IAEvD;;;;OAIG;IACH,OAAO,CAAC,oBAAoB,CAA6B;IAEzD;;;OAGG;IACI,UAAU,UAAS;IAE1B;;;OAGG;IACI,WAAW,UAAS;IAE3B;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAKjD;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAKnD;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,eAAe,GACtB,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAa7C;;;;;;;OAOG;YACW,iBAAiB;IAc/B;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,GAAG,OAAO,EACvB,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAgB7C;;;;;;;;OAQG;YACW,kBAAkB;IAsBhC;;;OAGG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/utils/InterceptorManager.js

@@ -1,54 +1,90 @@
+/**
+ * @en Interceptor manager for pipeline execution of requests and responses.
+ * Uses a hybrid loop (fast-path): runs synchronously until a Promise is encountered.
+ * @ru Менеджер перехватчиков (интерцепторов) для сквозной обработки запросов и ответов.
+ * Использует гибридный цикл (fast-path): выполняется синхронно до тех пор, пока не встретит Promise.
+ */
 export class InterceptorManager {
+    /**
+     * @en Array of registered request interceptors.
+     * @ru Массив зарегистрированных перехватчиков запроса.
+     * @private
+     */
     requestInterceptors = [];
+    /**
+     * @en Array of registered response interceptors.
+     * @ru Массив зарегистрированных перехватчиков ответа.
+     * @private
+     */
     responseInterceptors = [];
+    /**
+     * @en Flag indicating presence of active request interceptors for fast branch short-circuiting.
+     * @ru Флаг наличия активных перехватчиков запроса для быстрого ветвления.
+     */
     hasRequest = false;
+    /**
+     * @en Flag indicating presence of active response interceptors for fast branch short-circuiting.
+     * @ru Флаг наличия активных перехватчиков ответа для быстрого ветвления.
+     */
     hasResponse = false;
+    /**
+     * @en Registers a new request interceptor in the pipeline.
+     * @ru Регистрирует новый перехватчик запроса в конвейере.
+     * @param interceptor - Target request interceptor function.
+     */
     addRequest(interceptor) {
         this.requestInterceptors.push(interceptor);
         this.hasRequest = true;
     }
+    /**
+     * @en Registers a new response interceptor in the pipeline.
+     * @ru Регистрирует новый перехватчик ответа в конвейере.
+     * @param interceptor - Target response interceptor function.
+     */
     addResponse(interceptor) {
         this.responseInterceptors.push(interceptor);
         this.hasResponse = true;
     }
     /**
-     * Применяет реквест-интерцепторы.
-     * Возвращает либо измененный config, либо Promise с ним.
+     * @en Sequentially applies the chain of interceptors to the request configuration.
+     * @ru Последовательно применяет цепочку перехватчиков к конфигурации запроса.
+     * @param config - Initial internal request configuration object.
+     * @returns Modified configuration or a Promise resolving to it.
      */
     applyRequest(config) {
         let result = config;
-        const len = this.requestInterceptors.length;
-        for (let i = 0; i < len; i++) {
-            const nextConfig = this.requestInterceptors[i](result);
-            if (nextConfig instanceof Promise) {
-                return this.applyRequestAsync(i, nextConfig, result);
+        for (let i = 0; i < this.requestInterceptors.length; i++) {
+            const next = this.requestInterceptors[i](result);
+            if (next instanceof Promise) {
+                return this.applyRequestAsync(i + 1, next, result);
             }
-            if (nextConfig)
-                result = nextConfig;
+            if (next)
+                result = next;
         }
         return result;
     }
+    /**
+     * @en Asynchronous fallback to process the remaining request chain after encountering a Promise.
+     * @ru Асинхронный фолбек для обработки оставшейся цепочки запросов после обнаружения Promise.
+     * @param startIndex - Index of the interceptor that returned a Promise.
+     * @param currentPromise - The pending Promise from the current interceptor step.
+     * @param currentResult - Cumulative configuration result before the Promise step.
+     * @private
+     */
     async applyRequestAsync(startIndex, currentPromise, currentResult) {
-        let result = currentResult;
-        const resolved = await currentPromise;
-        if (resolved)
-            result = resolved;
-        const len = this.requestInterceptors.length;
-        for (let i = startIndex + 1; i < len; i++) {
-            const nextConfig = this.requestInterceptors[i](result);
-            if (nextConfig instanceof Promise) {
-                const res = await nextConfig;
-                if (res)
-                    result = res;
-            }
-            else if (nextConfig) {
-                result = nextConfig;
-            }
+        let result = (await currentPromise) ?? currentResult;
+        for (let i = startIndex; i < this.requestInterceptors.length; i++) {
+            const next = this.requestInterceptors[i](result);
+            result = (next instanceof Promise ? await next : next) ?? result;
         }
         return result;
     }
     /**
-     * Применяет респонс-интерцепторы аналогичным гибридным способом.
+     * @en Sequentially applies the chain of interceptors to the incoming response container.
+     * @ru Последовательно применяет цепочку перехватчиков к полученному объекту ответа.
+     * @template T - Type mapping descriptor for the expected response payload body.
+     * @param response - Target HTTP response context wrapper.
+     * @returns Transformed response context or a Promise resolving to it.
      */
     applyResponse(response) {
         let result = response;
@@ -63,6 +99,15 @@ export class InterceptorManager {
         }
         return result;
     }
+    /**
+     * @en Asynchronous fallback to process the remaining response chain after encountering a Promise.
+     * @ru Асинхронный фолбек для обработки оставшейся цепочки ответов после обнаружения Promise.
+     * @template T - Type mapping descriptor for the expected response payload body.
+     * @param startIndex - Index of the interceptor that returned a Promise.
+     * @param currentPromise - The pending Promise from the current interceptor step.
+     * @param currentResult - Cumulative response result before the Promise step.
+     * @private
+     */
     async applyResponseAsync(startIndex, currentPromise, currentResult) {
         let result = currentResult;
         const resolved = await currentPromise;
@@ -82,6 +127,10 @@ export class InterceptorManager {
         }
         return result;
     }
+    /**
+     * @en Completely flushes internal interceptor registers and resets state indicators.
+     * @ru Полностью очищает списки зарегистрированных перехватчиков и сбрасывает флаги.
+     */
     clear() {
         this.requestInterceptors = [];
         this.responseInterceptors = [];

package/utils/InterceptorManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"InterceptorManager.js","sourceRoot":"","sources":["../../src/utils/InterceptorManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"InterceptorManager.js","sourceRoot":"","sources":["../../src/utils/InterceptorManager.ts"],"names":[],"mappings":"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"}