@hyperttp/core 1.0.0

package/dist/types/request.d.ts

@@ -0,0 +1,189 @@
+/**
+ * @ru Представляет HTTP заголовки запроса
+ * @en Represents HTTP request headers
+ */
+export type RequestHeaders = Record<string, string>;
+/**
+ * @ru Представляет параметры URL query
+ * @en Represents URL query parameters
+ */
+export type RequestQuery = Record<string, string | string[] | number | boolean | undefined | null>;
+/**
+ * @ru Данные тела запроса
+ * @en Request body data
+ */
+export type RequestBodyData = any | null | undefined;
+/**
+ * @ru Конфигурация для создания запроса
+ * @en Configuration for request creation
+ */
+export type RequestConfig = {
+    /**
+     * @ru Схема протокола (http/https)
+     * @en Protocol scheme (http/https)
+     */
+    scheme: string;
+    /**
+     * @ru Хост сервера
+     * @en Server host
+     */
+    host: string;
+    /**
+     * @ru Порт сервера
+     * @en Server port
+     */
+    port?: number;
+    /**
+     * @ru Путь ресурса
+     * @en Resource path
+     */
+    path?: string;
+    /**
+     * @ru Заголовки запроса
+     * @en Request headers
+     */
+    headers?: RequestHeaders;
+    /**
+     * @ru Параметры query строки
+     * @en Query string parameters
+     */
+    query?: RequestQuery;
+    /**
+     * @ru Данные тела запроса
+     * @en Request body data
+     */
+    bodyData?: RequestBodyData;
+};
+/**
+ * @ru Основной интерфейс запроса
+ * @en Main request interface
+ */
+export interface RequestInterface {
+    /**
+     * @ru Возвращает полный URL запроса
+     * @en Returns full request URL
+     * @returns constructed URL string
+     */
+    getURL(): string;
+    /**
+     * @ru Возвращает заголовки запроса
+     * @en Returns request headers
+     * @returns headers object
+     */
+    getHeaders(): RequestHeaders;
+    /**
+     * @ru Возвращает данные тела запроса
+     * @en Returns request body data
+     * @returns body data
+     */
+    getBodyData(): RequestBodyData;
+    /**
+     * @ru Устанавливает путь ресурса
+     * @en Sets resource path
+     * @param path - new path
+     * @returns this for chaining
+     */
+    setPath?(path: string): RequestInterface;
+    /**
+     * @ru Устанавливает хост сервера
+     * @en Sets server host
+     * @param host - server host
+     * @returns this for chaining
+     */
+    setHost?(host: string): RequestInterface;
+    /**
+     * @ru Устанавливает заголовки запроса
+     * @en Sets request headers
+     * @param headers - headers object
+     * @returns this for chaining
+     */
+    setHeaders?(headers: RequestHeaders): RequestInterface;
+    /**
+     * @ru Добавляет заголовки к существующим
+     * @en Adds headers to existing ones
+     * @param headers - headers to add
+     * @returns this for chaining
+     */
+    addHeaders?(headers: RequestHeaders): RequestInterface;
+    /**
+     * @ru Возвращает query параметры
+     * @en Returns query parameters
+     * @returns query object
+     */
+    getQuery?(): RequestQuery;
+    /**
+     * @ru Устанавливает query параметры
+     * @en Sets query parameters
+     * @param query - query object
+     * @returns this for chaining
+     */
+    setQuery?(query: RequestQuery): RequestInterface;
+    /**
+     * @ru Добавляет query параметры
+     * @en Adds query parameters
+     * @param query - query to add
+     * @returns this for chaining
+     */
+    addQuery?(query: RequestQuery): RequestInterface;
+    /**
+     * @ru Возвращает query строку
+     * @en Returns query string
+     * @returns encoded query string
+     */
+    getQueryAsString?(): string;
+    /**
+     * @ru Возвращает тело запроса как строку
+     * @en Returns body data as string
+     * @returns body string representation
+     */
+    getBodyDataString?(): string;
+    /**
+     * @ru Устанавливает данные тела запроса
+     * @en Sets request body data
+     * @param bodyData - body data
+     * @returns this for chaining
+     */
+    setBodyData?(bodyData: RequestBodyData): RequestInterface;
+    /**
+     * @ru Добавляет данные к телу запроса
+     * @en Adds data to request body
+     * @param bodyData - data to add
+     * @returns this for chaining
+     */
+    addBodyData?(bodyData: RequestBodyData): RequestInterface;
+    /**
+     * @ru Устанавливает AbortSignal для отмены
+     * @en Sets AbortSignal for cancellation
+     * @param signal - AbortSignal instance
+     * @returns this for chaining
+     */
+    setSignal?(signal: AbortSignal): RequestInterface;
+    /**
+     * @ru Возвращает AbortSignal
+     * @en Returns AbortSignal
+     * @returns AbortSignal or undefined
+     */
+    getSignal?(): AbortSignal | undefined;
+}
+/**
+ * @ru Метаданные для конвертации ответа
+ * @en Response conversion metadata
+ */
+export interface ConversionMeta {
+    /**
+     * @ru Content-Type заголовок
+     * @en Content-Type header
+     */
+    contentType?: string;
+    /**
+     * @ru Content-Encoding заголовок
+     * @en Content-Encoding header
+     */
+    contentEncoding?: string;
+    /**
+     * @ru URL запроса
+     * @en Request URL
+     */
+    url?: string;
+}
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/types/request.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CACxD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,IAAI,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,IAAI,cAAc,CAAC;IAE7B;;;;OAIG;IACH,WAAW,IAAI,eAAe,CAAC;IAE/B;;;;;OAKG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAEzC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAEzC;;;;;OAKG;IACH,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAEvD;;;;;OAKG;IACH,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAEvD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,YAAY,CAAC;IAE1B;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAAC;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAAC;IAEjD;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,MAAM,CAAC;IAE5B;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAE1D;;;;;OAKG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAE1D;;;;;OAKG;IACH,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAAC;IAElD;;;;OAIG;IACH,SAAS,CAAC,IAAI,WAAW,GAAG,SAAS,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/types/request.js

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

package/dist/types/request.js.map

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

package/dist/types/retry.d.ts

@@ -0,0 +1,28 @@
+export interface RetryOptions {
+    /**
+     * @ru Максимальное количество повторных попыток
+     * @en Maximum number of retry attempts
+     */
+    maxRetries?: number;
+    /**
+     * @ru Базовая задержка между попытками (мс)
+     * @en Base delay between retries (ms)
+     */
+    baseDelay?: number;
+    /**
+     * @ru Максимальная задержка между попытками (мс)
+     * @en Maximum retry delay (ms)
+     */
+    maxDelay?: number;
+    /**
+     * @ru Коды HTTP, при которых выполняется retry
+     * @en HTTP status codes that trigger retry logic
+     */
+    retryStatusCodes?: readonly number[];
+    /**
+     * @ru Добавлять случайный jitter к задержке
+     * @en Add randomness (jitter) to retry delay
+     */
+    jitter?: boolean;
+}
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/types/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/retry.js

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

package/dist/types/retry.js.map

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

package/dist/types/stream.d.ts

@@ -0,0 +1,39 @@
+import { Readable } from "node:stream";
+export interface StreamResponse<TBody = Readable> {
+    /**
+     * @ru HTTP статус код ответа
+     * @en HTTP status code
+     */
+    status: number;
+    /**
+     * @ru Заголовки ответа (сырые)
+     * @en Response headers (raw)
+     */
+    headers: Record<string, string | string[] | undefined>;
+    /**
+     * @ru Потоковое тело (низкоуровневые чанки)
+     * @en Streamed body (low-level chunks)
+     */
+    body: TBody;
+    /**
+     * @ru Финальный URL (после редиректов)
+     * @en Final resolved URL (after redirects)
+     */
+    url: string;
+    /**
+     * @ru Сигнал для отслеживания abort (pipeline control)
+     * @en Optional signal for abort tracking (useful for pipeline control)
+     */
+    signal?: AbortSignal;
+    /**
+     * @ru Content-Length если известен (zero-copy оптимизации)
+     * @en Content-Length if known (zero-copy optimizations)
+     */
+    contentLength?: number;
+    /**
+     * @ru Hint кодировки (gzip/br/etc)
+     * @en Encoding hint (gzip/br/etc)
+     */
+    encoding?: string;
+}
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/types/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,QAAQ;IAC9C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAEvD;;;OAGG;IACH,IAAI,EAAE,KAAK,CAAC;IAEZ;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/stream.js

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

package/dist/types/stream.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@hyperttp/core",
+  "version": "1.0.0",
+  "private": false,
+  "description": "High-performance, extensible HTTP client for Node.js and Bun",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "http",
+    "client",
+    "high-performance",
+    "undici",
+    "fetch",
+    "bun"
+  ],
+  "author": "dirold2",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IT-IF-OR/hyperttp-core.git"
+  },
+  "dependencies": {
+    "http-cookie-agent": "^8.0.0",
+    "undici": "^8.3.0"
+  }
+}