@hyperttp/profiler 1.0.0

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-profiler

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { withProfiler, ProfilerPlugin } from "./plugin.js";
+export * from "./utils/RequestProfiler.js";
+export type * from "./types/metrics.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,cAAc,4BAA4B,CAAC;AAC3C,mBAAmB,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { withProfiler, ProfilerPlugin } from "./plugin.js";
+export * from "./utils/RequestProfiler.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,cAAc,4BAA4B,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,11 @@
+import type { HyperCore, HyperPlugin } from "@hyperttp/core";
+export declare function withProfiler(client: HyperCore): HyperCore;
+declare module "@hyperttp/core" {
+    interface HyperttpPluginsExtension {
+        profiler?: {
+            enabled: boolean;
+        };
+    }
+}
+export declare const ProfilerPlugin: HyperPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AAGxB,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAmBzD;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,wBAAwB;QAChC,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;KACjC;CACF;AAED,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,19 @@
+import { RequestProfiler } from "./utils/RequestProfiler.js";
+export function withProfiler(client) {
+    const next = client.dispatch;
+    client.dispatch = async (req) => {
+        const { result, profile } = await RequestProfiler.profile(() => next(req));
+        if (profile.durationMs > 500) {
+            console.warn(`Slow request detected (${profile.durationMs.toFixed(2)}ms):`, req.url);
+        }
+        return result;
+    };
+    return client;
+}
+export const ProfilerPlugin = {
+    name: "hyperttp-profiler",
+    phase: "START",
+    enabled: (config) => !!config.profiler?.enabled,
+    apply: (client) => withProfiler(client),
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG,KAAK,EAAW,GAAoB,EAAc,EAAE;QACpE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAC7D,IAAI,CAAI,GAAG,CAAC,CACb,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CACV,0BAA0B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAC7D,GAAG,CAAC,GAAG,CACR,CAAC;QACJ,CAAC;QAED,OAAO,MAAsB,CAAC;IAChC,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,CAAC,MAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO;IAClE,KAAK,EAAE,CAAC,MAAiB,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;CACnD,CAAC"}

package/dist/types/metrics.d.ts

@@ -0,0 +1,143 @@
+export interface MetricsOptions {
+    /**
+     * @ru Включить сбор метрик
+     * @en Enable metrics collection
+     */
+    enabled?: boolean;
+    /**
+     * @ru Максимальное количество записей в истории.
+     * @en Maximum number of entries in history.
+     */
+    maxHistory?: number;
+    /**
+     * @ru Время хранения метрик в миллисекундах.
+     * @en Time to keep metrics in milliseconds.
+     */
+    ttl?: number;
+    /**
+     * @ru Глубина scope для circuit breaker: 1 = host + первый сегмент пути.
+     * @en Scope depth for circuit breaker: 1 = host + first path segment.
+     */
+    scopeDepth?: number;
+    /**
+     * @ru Порог ошибки, после которого circuit breaker переходит в OPEN.
+     * @en Failure score threshold that opens the circuit breaker.
+     */
+    failureThreshold?: number;
+    /**
+     * @ru Время охлаждения перед переходом в HALF_OPEN.
+     * @en Cooldown time before switching to HALF_OPEN.
+     */
+    resetTimeout?: number;
+    /**
+     * @ru Порог "медленного" запроса в миллисекундах.
+     * @en Slow request threshold in milliseconds.
+     */
+    slowRequestMs?: number;
+    /**
+     * @ru Веса ошибок для разных классов отказов.
+     * @en Failure weights for different failure classes.
+     */
+    weights?: {
+        timeout?: number;
+        serverError?: number;
+        rateLimit?: number;
+        slowRequest?: number;
+        other?: number;
+    };
+}
+export interface RequestMetrics {
+    /**
+     * @ru Время начала запроса (timestamp)
+     * @en Request start time (timestamp)
+     */
+    startTime: number;
+    /**
+     * @ru Время окончания запроса (timestamp)
+     * @en Request end time (timestamp)
+     */
+    endTime: number;
+    /**
+     * @ru Длительность запроса (мс)
+     * @en Request duration (ms)
+     */
+    duration: number;
+    /**
+     * @ru HTTP статус код ответа
+     * @en HTTP status code of response
+     */
+    statusCode?: number;
+    /**
+     * @ru Количество полученных байт
+     * @en Bytes received
+     */
+    bytesReceived: number;
+    /**
+     * @ru Количество отправленных байт
+     * @en Bytes sent
+     */
+    bytesSent: number;
+    /**
+     * @ru Количество повторных попыток
+     * @en Number of retries performed
+     */
+    retries: number;
+    /**
+     * @ru Ответ из кэша
+     * @en Response served from cache
+     */
+    cached: boolean;
+    /**
+     * @ru URL запроса
+     * @en Request URL
+     */
+    url: string;
+    /**
+     * @ru HTTP метод запроса
+     * @en HTTP method
+     */
+    method: string;
+    /**
+     * @ru Хэш тела запроса (для кэширования)
+     * @en Request body hash (for caching)
+     */
+    bodyHash?: string;
+    stages?: {
+        serializationMs?: number;
+        networkMs?: number;
+        parsingMs?: number;
+    };
+}
+export type CircuitStateName = "CLOSED" | "OPEN" | "HALF_OPEN";
+export type CircuitState = {
+    state: CircuitStateName;
+    failureScore: number;
+    consecutiveFailures: number;
+    lastFailureTime: number;
+    lastTransitionTime: number;
+    probeInFlight: boolean;
+};
+export interface MemoryUsageSnapshot {
+    rss: number;
+    heapTotal: number;
+    heapUsed: number;
+    external: number;
+    arrayBuffers: number;
+}
+export interface RequestPerformanceProfile {
+    wallClockStart: number;
+    wallClockEnd: number;
+    durationMs: number;
+    cpu: {
+        userMs: number;
+        systemMs: number;
+        totalMs: number;
+        percent: number;
+    };
+    memory: {
+        before: MemoryUsageSnapshot;
+        after: MemoryUsageSnapshot;
+        delta: MemoryUsageSnapshot;
+    };
+}
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/types/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,mBAAmB,CAAC;QAC5B,KAAK,EAAE,mBAAmB,CAAC;QAC3B,KAAK,EAAE,mBAAmB,CAAC;KAC5B,CAAC;CACH"}

package/dist/types/metrics.js

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

package/dist/types/metrics.js.map

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

package/dist/utils/RequestProfiler.d.ts

@@ -0,0 +1,10 @@
+import type { RequestPerformanceProfile } from "../types/metrics.js";
+type ProfiledResult<T> = {
+    result: T;
+    profile: RequestPerformanceProfile;
+};
+export declare class RequestProfiler {
+    static profile<T>(executor: () => Promise<T>): Promise<ProfiledResult<T>>;
+}
+export type { ProfiledResult };
+//# sourceMappingURL=RequestProfiler.d.ts.map

package/dist/utils/RequestProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestProfiler.d.ts","sourceRoot":"","sources":["../../src/utils/RequestProfiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,KAAK,cAAc,CAAC,CAAC,IAAI;IACvB,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAaF,qBAAa,eAAe;WACb,OAAO,CAAC,CAAC,EACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CA2C9B;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/utils/RequestProfiler.js

@@ -0,0 +1,51 @@
+function toMemorySnapshot() {
+    const usage = process.memoryUsage();
+    return {
+        rss: usage.rss,
+        heapTotal: usage.heapTotal,
+        heapUsed: usage.heapUsed,
+        external: usage.external,
+        arrayBuffers: usage.arrayBuffers,
+    };
+}
+export class RequestProfiler {
+    static async profile(executor) {
+        const startedAt = Date.now();
+        const hrStart = process.hrtime.bigint();
+        const cpuStart = process.cpuUsage();
+        const memoryBefore = toMemorySnapshot();
+        const result = await executor();
+        const hrEnd = process.hrtime.bigint();
+        const finishedAt = Date.now();
+        const cpuDiff = process.cpuUsage(cpuStart);
+        const memoryAfter = toMemorySnapshot();
+        const durationMs = Number(hrEnd - hrStart) / 1_000_000;
+        const cpuUserMs = cpuDiff.user / 1000;
+        const cpuSystemMs = cpuDiff.system / 1000;
+        const cpuTotalMs = cpuUserMs + cpuSystemMs;
+        const profile = {
+            wallClockStart: startedAt,
+            wallClockEnd: finishedAt,
+            durationMs,
+            cpu: {
+                userMs: cpuUserMs,
+                systemMs: cpuSystemMs,
+                totalMs: cpuTotalMs,
+                percent: durationMs > 0 ? (cpuTotalMs / durationMs) * 100 : 0,
+            },
+            memory: {
+                before: memoryBefore,
+                after: memoryAfter,
+                delta: {
+                    rss: memoryAfter.rss - memoryBefore.rss,
+                    heapTotal: memoryAfter.heapTotal - memoryBefore.heapTotal,
+                    heapUsed: memoryAfter.heapUsed - memoryBefore.heapUsed,
+                    external: memoryAfter.external - memoryBefore.external,
+                    arrayBuffers: memoryAfter.arrayBuffers - memoryBefore.arrayBuffers,
+                },
+            },
+        };
+        return { result, profile };
+    }
+}
+//# sourceMappingURL=RequestProfiler.js.map

package/dist/utils/RequestProfiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestProfiler.js","sourceRoot":"","sources":["../../src/utils/RequestProfiler.ts"],"names":[],"mappings":"AAUA,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,QAA0B;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;QAExC,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;QAEhC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,gBAAgB,EAAE,CAAC;QAEvC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QAC1C,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;QAE3C,MAAM,OAAO,GAA8B;YACzC,cAAc,EAAE,SAAS;YACzB,YAAY,EAAE,UAAU;YACxB,UAAU;YACV,GAAG,EAAE;gBACH,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,WAAW;gBACrB,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;aAC9D;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,YAAY;gBACpB,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE;oBACL,GAAG,EAAE,WAAW,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG;oBACvC,SAAS,EAAE,WAAW,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS;oBACzD,QAAQ,EAAE,WAAW,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ;oBACtD,QAAQ,EAAE,WAAW,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ;oBACtD,YAAY,EAAE,WAAW,CAAC,YAAY,GAAG,YAAY,CAAC,YAAY;iBACnE;aACF;SACF,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@hyperttp/profiler",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "hyperttp"
+  ],
+  "author": "dirold2",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IT-IF-OR/hyperttp-profiler.git"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@hyperttp/core": "^1.0.5"
+  }
+}