@hyperttp/core 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -7,4 +7,5 @@ export type * from "./types/request.js";
 export type * from "./types/stream.js";
 export type * from "./types/metrics.js";
 export type * from "./types/errors.js";
+export type * from "./types/plugins.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC"}

package/dist/types/options.d.ts

@@ -1,5 +1,6 @@
 import type { LogLevel } from "./http.js";
 import type { NetworkOptions } from "./network.js";
+import type { HyperPlugin } from "./plugins.js";
 export interface HyperttpPluginsExtension {
 }
 /**
@@ -34,7 +35,7 @@ export interface BaseHttpClientOptions {
      * @ru Список явно подключенных плагинов (готовые объекты или строки с именами npm-пакетов)
      * @en List of explicitly registered plugins (direct objects or npm package name strings)
      */
-    plugins?: any[];
+    plugins?: (HyperPlugin | string)[];
     trackMetrics?: any;
 }
 export type HttpClientOptions = BaseHttpClientOptions & HyperttpPluginsExtension;

package/dist/types/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,WAAW,wBAAwB;CAAG;AAE5C;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAEhB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GACnD,wBAAwB,CAAC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,wBAAwB;CAAG;AAE5C;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC;IAEnC,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GACnD,wBAAwB,CAAC"}

package/dist/types/plugins.d.ts

@@ -0,0 +1,45 @@
+import type { HyperCore } from "../Core/HyperCore.js";
+import type { HttpClientOptions } from "./options.js";
+/**
+ * @ru
+ * Фазы жизненного цикла запроса (выполняются строго по очереди от начала до отправки).
+ * Конвейер запроса: START -> PREPARE -> CONTROL -> FORMAT -> SEND.
+ * Конвейер ответа:  SEND -> FORMAT -> CONTROL -> PREPARE -> START.
+ * @en
+ * Request lifecycle phases (executed strictly in order from start to dispatch).
+ * Request pipeline: START -> PREPARE -> CONTROL -> FORMAT -> SEND.
+ * Response pipeline: SEND -> FORMAT -> CONTROL -> PREPARE -> START.
+ */
+export type PluginPhase = /**
+ * @ru Самое начало. Тут запускаются таймеры метрик и пишутся первые логи.
+ * @en The very beginning. Metrics timers start and initial logs are written here.
+ */ "START" /**
+ * @ru Подготовка запроса. Проверка кэша (чтобы вернуть ответ сразу) или добавление токенов авторизации.
+ * @en Request preparation. Checking cache (to return early) or injecting auth tokens.
+ */ | "PREPARE" /**
+ * @ru Контроль потока. Управление очередью запросов, лимитами частоты и повторами при ошибках.
+ * @en Flow control. Managing request queues, rate limits, and error retries.
+ */ | "CONTROL" /**
+ * @ru Форматирование. Превращение объектов в JSON/FormData перед отправкой и парсинг ответов сервера.
+ * @en Data formatting. Serializing objects to JSON/FormData before sending and parsing server responses.
+ */ | "FORMAT" /**
+ * @ru Отправка. Низкоуровневый fetch, работа через прокси или утилиты обхода (Zapret, Xray).
+ * @en Dispatching. Low-level fetch operations, proxy routing, or bypass utilities (Zapret, Xray).
+ */ | "NETWORK";
+export interface HyperPlugin {
+    name: string;
+    /**
+     * @ru
+     * Фазы жизненного цикла запроса (выполняются строго по очереди от начала до отправки).
+     * Конвейер запроса: START -> PREPARE -> CONTROL -> FORMAT -> SEND.
+     * Конвейер ответа:  SEND -> FORMAT -> CONTROL -> PREPARE -> START.
+     * @en
+     * Request lifecycle phases (executed strictly in order from start to dispatch).
+     * Request pipeline: START -> PREPARE -> CONTROL -> FORMAT -> SEND.
+     * Response pipeline: SEND -> FORMAT -> CONTROL -> PREPARE -> START.
+     */
+    phase: PluginPhase;
+    enabled: (config: HttpClientOptions) => boolean;
+    apply: (client: HyperCore, config: HttpClientOptions) => HyperCore;
+}
+//# sourceMappingURL=plugins.d.ts.map

package/dist/types/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/types/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GACnB;;;GAGC,CACH,OAAO,CAAC;;;GAGL,GACD,SAAS,CAAC;;;GAGT,GACD,SAAS,CAAC;;;GAGT,GACD,QAAQ,CAAC;;;GAGR,GACD,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAChD,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,KAAK,SAAS,CAAC;CACpE"}

package/dist/types/plugins.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugins.js.map

package/dist/types/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/types/plugins.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperttp/core",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "High-performance, extensible HTTP client for Node.js and Bun",
   "type": "module",
   "main": "./dist/index.js",