@hyperttp/parser 1.0.2 → 1.0.10

package/package.json

@@ -1,13 +1,10 @@
 {
   "name": "@hyperttp/parser",
-  "version": "1.0.2",
+  "version": "1.0.10",
   "description": "Automated response parsing and content conversion plugin for Hyperttp client",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "main": "./index.js",
+  "types": "./index.d.ts",
   "keywords": [
     "hyperttp"
   ],
@@ -26,4 +23,4 @@
     "fast-xml-builder": "^1.2.0",
     "fast-xml-parser": "^5.8.0"
   }
-}
+}

package/{dist/plugin.js → plugin.js}

@@ -2,6 +2,19 @@ import { ResponseConverter } from "./utils/ResponseConverter.js";
 export function withParser(client, options) {
     const next = client.dispatch.bind(client);
     const converter = new ResponseConverter(options);
+    const safeDestroy = (body) => {
+        if (!body)
+            return;
+        if (typeof body.on === "function")
+            body.on("error", () => { });
+        if (typeof body.cancel === "function") {
+            body.cancel().catch(() => { });
+        }
+        else if (typeof body.destroy === "function") {
+            if (!body.destroyed)
+                body.destroy();
+        }
+    };
     client.dispatch = async (req) => {
         const responseType = req.meta?.responseType || "auto";
         if (req.method === "HEAD" ||
@@ -10,21 +23,11 @@ export function withParser(client, options) {
             return next(req);
         }
         const rawResponse = await next(req);
-        if (!rawResponse ||
-            rawResponse.body === undefined ||
-            rawResponse.body === null) {
+        if (!rawResponse?.body) {
             return rawResponse;
         }
         if (rawResponse.status && rawResponse.status >= 400) {
-            if (typeof rawResponse.body.cancel === "function") {
-                await rawResponse.body.cancel().catch(() => { });
-            }
-            else if (typeof rawResponse.body.destroy === "function") {
-                rawResponse.body.destroy();
-            }
-            else {
-                await converter.readBody(rawResponse.body).catch(() => { });
-            }
+            safeDestroy(rawResponse.body);
             return rawResponse;
         }
         const { headers, body } = rawResponse;
@@ -34,10 +37,9 @@ export function withParser(client, options) {
         try {
             bufferBody = await converter.readBody(body);
         }
-        catch (readError) {
-            if (typeof body.cancel === "function")
-                await body.cancel().catch(() => { });
-            throw readError;
+        catch (readErr) {
+            safeDestroy(body);
+            throw readErr;
         }
         const currentUrl = (rawResponse.url || req.url);
         const parsedData = await converter.convert(bufferBody, responseType, {

package/plugin.js.map

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

package/LICENSE

@@ -1,21 +0,0 @@
-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

@@ -1,109 +0,0 @@
-# @hyperttp/parser
-
-Официальный плагин автоматического парсинга и
-конвертации ответов для HTTP-клиента **Hyperttp**.
-Работает на фазе `FORMAT`, вычитывает входящий поток данных (body stream) и
-преобразует его в JavaScript-объекты, XML, строки или
-полноценные DOM-деревья Cheerio на основе заголовков `Content-Type` или
-параметра `responseType`.
-
-## Особенности
-
-- 🤖 **Автоматическое определение (`auto`)**:
-Самостоятельно распознает форматы `JSON`, `XML` и `Text`,
-избавляя от необходимости вызывать `.json()` вручную.
-- 🦅 **Интеграция с Cheerio**:
-При получении HTML-страниц автоматически оборачивает тело ответа в
-инстанс `cheerio`,
-позволяя сразу выполнять jQuery-подобные запросы для парсинга и скрейпинга.
-- ⏱️ **Метрики производительности**: Точно замеряет время,
-затраченное на десериализацию данных, и
-сохраняет результат в `req.meta.timings.parsingMs` (при включенном `trackTimings`).
-- 🧹 **Безопасная очистка (Stream Cleanup)**:
-В случае ответов с ошибками (HTTP Status >= 400) или
-сбоев вычитки плагин корректно закрывает/вызывает `cancel()` / `destroy()` у
-нативных стримов, предотвращая утечки памяти.
-
-## Установка
-
-```bash
-# С использованием bun
-bun add @hyperttp/parser
-
-# С использованием npm/pnpm
-npm install @hyperttp/parser
-
-```
-
-## Использование
-
-Плагин автоматически активируется на фазе `FORMAT` для всех типов запросов,
-кроме `HEAD`, `buffer` и `stream`.
-
-### Базовый пример
-
-```typescript
-import { HyperClient } from "@hyperttp/core";
-import "@hyperttp/parser"; // Подключение расширения типов HttpClientOptions
-
-const client = new HyperClient({
-  responseConverter: {
-    // Опции конфигурации парсера (передаются в экземпляр ResponseConverter)
-    charset: "utf-8"
-  }
-});
-
-// 1. Автоматический парсинг JSON
-const jsonResult = await client.get<{ id: number }>("https://api.example.com/user/1");
-console.log(jsonResult.id);
-
-// 2. Автоматический парсинг HTML в Cheerio
-const $ = await client.get<any>("https://example.com/page", {
-  meta: { responseType: "html" } 
-});
-const pageTitle = $("head title").text();
-
-```
-
-### Мониторинг времени парсинга
-
-Если активирован трекинг таймингов, плагин обогатит объект `meta`:
-
-```typescript
-const req = {
-  url: "[https://api.example.com/heavy-data](https://api.example.com/heavy-data)",
-  method: "GET",
-  meta: { trackTimings: true }
-};
-
-const data = await client.execute(req);
-console.log(Время парсинга: ${req.meta.timings?.parsingMs} ms);
-
-```
-
-## Как это работает (Архитектура)
-
-Плагин перехватывает управление в момент возврата ответа из сети на фазе **`FORMAT`**:
-
-```mermaid
-graph TD
-    Net[Ответ из сети NETWORK] --> Hook[Фаза FORMAT]
-    Hook --> CheckType{Тип ответа HEAD, buffer или stream?}
-    
-    CheckType -- Да --> Bypass[Пропустить без изменений] --> Return[Возврат пользователю]
-    CheckType -- Нет --> CheckStatus{Status >= 400?}
-    
-    CheckStatus -- Да --> Clean[Очистка/Закрытие Стрима] --> Return
-    CheckStatus -- Нет --> Read[Вычитка потока данных в буфер]
-    
-    Read --> Convert[Конвертация: JSON / XML / Cheerio / Text]
-    Convert --> Track{trackTimings === true?}
-    
-    Track -- Да --> Calc[Вычисление parsingMs] --> Return
-    Track -- Нет --> Return
-
-```
-
-## Лицензия
-
-MIT © dirold2

package/dist/plugin.js.map

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