@bluelibs/runner-dev 5.1.0 → 5.3.0

package/dist/utils/healthCollectors.d.ts

@@ -0,0 +1,37 @@
+/** Mean event‐loop delay in nanoseconds. */
+export declare function getEventLoopMeanNs(): number;
+/** Reset the event‐loop delay histogram (for the optional `reset` arg). */
+export declare function resetEventLoopHistogram(): void;
+/** Total GC collections observed since process start. */
+export declare let gcTotalCollections: number;
+/** Total GC pause duration (ms) since process start. */
+export declare let gcTotalDurationMs: number;
+/** Return GC stats within a sliding time window. */
+export declare function getGcWindow(windowMs: number): {
+    collections: number;
+    duration: number;
+};
+export declare function getCpuEluUtilization(): number;
+export interface HealthSnapshot {
+    memory: {
+        heapUsed: number;
+        heapTotal: number;
+        rss: number;
+    };
+    cpu: {
+        usage: number;
+        loadAverage: number;
+    };
+    eventLoop: {
+        lag: number;
+    };
+    gc: {
+        collections: number;
+        duration: number;
+    };
+}
+export declare function getHealthSnapshot(gcWindowMs?: number): HealthSnapshot;
+/** Extract the latest `timestampMs` from one or more arrays of timestamped entries. */
+export declare function latestTimestamp(...arrays: Array<{
+    timestampMs: number;
+}[]>): number | undefined;

package/dist/utils/healthCollectors.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gcTotalDurationMs = exports.gcTotalCollections = void 0;
+exports.getEventLoopMeanNs = getEventLoopMeanNs;
+exports.resetEventLoopHistogram = resetEventLoopHistogram;
+exports.getGcWindow = getGcWindow;
+exports.getCpuEluUtilization = getCpuEluUtilization;
+exports.getHealthSnapshot = getHealthSnapshot;
+exports.latestTimestamp = latestTimestamp;
+/**
+ * Shared system health collectors used by both the GraphQL live resolvers
+ * and the SSE stream handler. Centralises event‐loop delay, GC tracking,
+ * and CPU ELU measurement so only one set of observers exists per process.
+ */
+const os = __importStar(require("node:os"));
+const node_perf_hooks_1 = require("node:perf_hooks");
+// ---------------------------------------------------------------------------
+// Event‐loop delay histogram
+// ---------------------------------------------------------------------------
+let histogram;
+try {
+    histogram = (0, node_perf_hooks_1.monitorEventLoopDelay)({ resolution: 10 });
+    histogram.enable();
+}
+catch {
+    // Unsupported runtime (e.g. older Node or non‐Node)
+}
+/** Mean event‐loop delay in nanoseconds. */
+function getEventLoopMeanNs() {
+    return histogram?.mean ?? 0;
+}
+/** Reset the event‐loop delay histogram (for the optional `reset` arg). */
+function resetEventLoopHistogram() {
+    try {
+        histogram?.reset();
+    }
+    catch {
+        // ignore
+    }
+}
+// ---------------------------------------------------------------------------
+// GC tracking — both lifetime totals and a windowed ring buffer
+// ---------------------------------------------------------------------------
+/** Total GC collections observed since process start. */
+exports.gcTotalCollections = 0;
+/** Total GC pause duration (ms) since process start. */
+exports.gcTotalDurationMs = 0;
+const gcEvents = [];
+const GC_EVENTS_MAX = 10_000;
+function pushGcEvent(duration) {
+    gcEvents.push({ ts: Date.now(), duration });
+    if (gcEvents.length > GC_EVENTS_MAX) {
+        gcEvents.splice(0, Math.floor(GC_EVENTS_MAX * 0.1));
+    }
+}
+try {
+    const obs = new node_perf_hooks_1.PerformanceObserver((list) => {
+        for (const entry of list.getEntries()) {
+            exports.gcTotalCollections += 1;
+            exports.gcTotalDurationMs += entry.duration;
+            pushGcEvent(entry.duration);
+        }
+    });
+    obs.observe({ entryTypes: ["gc"], buffered: true });
+}
+catch {
+    // noop — GC observation not available
+}
+/** Return GC stats within a sliding time window. */
+function getGcWindow(windowMs) {
+    const since = Date.now() - windowMs;
+    let collections = 0;
+    let duration = 0;
+    for (let i = gcEvents.length - 1; i >= 0; i--) {
+        if (gcEvents[i].ts < since)
+            break;
+        collections += 1;
+        duration += gcEvents[i].duration;
+    }
+    return { collections, duration };
+}
+// ---------------------------------------------------------------------------
+// CPU utilisation via Event Loop Utilisation (ELU)
+// ---------------------------------------------------------------------------
+let prevElu;
+function getCpuEluUtilization() {
+    try {
+        const current = prevElu
+            ? node_perf_hooks_1.performance.eventLoopUtilization(prevElu)
+            : node_perf_hooks_1.performance.eventLoopUtilization();
+        prevElu = current;
+        return Number.isFinite(current.utilization) ? current.utilization : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function getHealthSnapshot(gcWindowMs = 30_000) {
+    const m = process.memoryUsage();
+    const meanNs = getEventLoopMeanNs();
+    const gc = getGcWindow(gcWindowMs);
+    return {
+        memory: { heapUsed: m.heapUsed, heapTotal: m.heapTotal, rss: m.rss },
+        cpu: { usage: getCpuEluUtilization(), loadAverage: os.loadavg()[0] ?? 0 },
+        eventLoop: { lag: Number.isFinite(meanNs) ? meanNs / 1e6 : 0 },
+        gc,
+    };
+}
+// ---------------------------------------------------------------------------
+// Timestamp helpers
+// ---------------------------------------------------------------------------
+/** Extract the latest `timestampMs` from one or more arrays of timestamped entries. */
+function latestTimestamp(...arrays) {
+    let max;
+    for (const arr of arrays) {
+        for (const entry of arr) {
+            if (max === undefined || entry.timestampMs > max) {
+                max = entry.timestampMs;
+            }
+        }
+    }
+    return max;
+}
+//# sourceMappingURL=healthCollectors.js.map

package/dist/utils/healthCollectors.js.map

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

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const v = "5.1.0";
+declare const v = "5.3.0";
 export default v;

package/dist/version.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 // Auto-generated by scripts/sync-version.ts. Do not edit manually.
-const v = "5.1.0";
+const v = "5.3.0";
 exports.default = v;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluelibs/runner-dev",
-  "version": "5.1.0",
+  "version": "5.3.0",
   "description": "BlueLibs Runner DevTools",
   "main": "dist/index.js",
   "repository": {
@@ -104,6 +104,7 @@
     "@adobe/jsonschema2md": "^8.0.5",
     "@apollo/server": "^5.0.0",
     "@as-integrations/express5": "^1.1.2",
+    "@bluelibs/runner": "^5.5.0",
     "@bluelibs/smart": "^2.2.1",
     "@modelcontextprotocol/sdk": "^1.17.2",
     "@types/prismjs": "^1.26.5",
@@ -117,9 +118,6 @@
     "zod": "3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },
-  "peerDependencies": {
-    "@bluelibs/runner": "^5.3.0"
-  },
   "overrides": {
     "react": "18.3.1",
     "react-dom": "18.3.1",