@naturalcycles/backend-lib 9.47.0 → 9.48.0

package/dist/server/eventLoop.util.d.ts

@@ -1,5 +1,10 @@
-import type { NumberOfMilliseconds, NumberOfPercent } from '@naturalcycles/js-lib/types';
+import { PerformanceObserver } from 'node:perf_hooks';
+import type { NonNegativeInteger, NumberOfMilliseconds, NumberOfPercent } from '@naturalcycles/js-lib/types';
 /**
+ * Monitors EventLoopDelay.
+ * Also, monitors GC performance.
+ * Once per `measureInterval` sends a callback with stats.
+ *
  * @experimental
  */
 export declare class EventLoopMonitor {
@@ -11,6 +16,9 @@ export declare class EventLoopMonitor {
      * Undefined until the first interval has completed.
      */
     lastStats?: EventLoopStats;
+    po: PerformanceObserver;
+    gcCount: number;
+    gcTotalTime: number;
     stop(): void;
 }
 export interface EventLoopMonitorCfg {
@@ -43,4 +51,16 @@ export interface EventLoopStats {
      *   utilization: active / (idle + active)
      */
     elu: NumberOfPercent;
+    /**
+     * Number of times gc ran during the last `measureInterval`
+     */
+    gcCount: NonNegativeInteger;
+    /**
+     * Total time spent on gc during the last `measureInterval`
+     */
+    gcTotalTime: NumberOfMilliseconds;
+    /**
+     * % of CPU time spent on GC in the last `measureInterval`
+     */
+    gcCPU: NumberOfPercent;
 }

package/dist/server/eventLoop.util.js

@@ -1,5 +1,9 @@
-import { monitorEventLoopDelay, performance } from 'node:perf_hooks';
+import { monitorEventLoopDelay, performance, PerformanceObserver } from 'node:perf_hooks';
 /**
+ * Monitors EventLoopDelay.
+ * Also, monitors GC performance.
+ * Once per `measureInterval` sends a callback with stats.
+ *
  * @experimental
  */
 export class EventLoopMonitor {
@@ -8,9 +12,16 @@ export class EventLoopMonitor {
         this.eld = monitorEventLoopDelay({ resolution });
         this.eld.enable();
         this.lastElu = performance.eventLoopUtilization();
+        this.po = new PerformanceObserver(list => {
+            for (const entry of list.getEntries()) {
+                this.gcCount++;
+                this.gcTotalTime += entry.duration;
+            }
+        });
+        this.po.observe({ entryTypes: ['gc'] });
         this.interval = setInterval(() => {
             // Delay stats are reported in **nanoseconds**
-            const { eld } = this;
+            const { eld, gcCount, gcTotalTime } = this;
             const p50 = Math.round(eld.percentile(50) / 1e6);
             const p90 = Math.round(eld.percentile(90) / 1e6);
             const p99 = Math.round(eld.percentile(99) / 1e6);
@@ -20,6 +31,7 @@ export class EventLoopMonitor {
             const deltaElu = performance.eventLoopUtilization(this.lastElu, currentElu);
             this.lastElu = currentElu;
             const elu = Math.round(deltaElu.utilization * 100);
+            const gcCPU = Math.round((gcTotalTime / measureInterval) * 100);
             this.lastStats = {
                 p50,
                 p90,
@@ -27,9 +39,14 @@ export class EventLoopMonitor {
                 max,
                 mean,
                 elu,
+                gcCount,
+                gcTotalTime,
+                gcCPU,
             };
             cfg.onStats?.(this.lastStats);
             eld.reset();
+            this.gcCount = 0;
+            this.gcTotalTime = 0;
         }, measureInterval);
     }
     interval;
@@ -39,8 +56,12 @@ export class EventLoopMonitor {
      * Undefined until the first interval has completed.
      */
     lastStats;
+    po;
+    gcCount = 0;
+    gcTotalTime = 0;
     stop() {
-        this.interval.close();
+        clearInterval(this.interval);
         this.eld.disable();
+        this.po.disconnect();
     }
 }

package/dist/validation/ajv/ajvValidateRequest.js

@@ -2,7 +2,7 @@ import { AjvSchema, getCoercingAjv, } from '@naturalcycles/nodejs-lib/ajv';
 import { handleValidationError } from '../validateRequest.util.js';
 class AjvValidateRequest {
     body(req, schema, opt = {}) {
-        return this.validate(req, 'body', schema, req.rawBody ? () => JSON.parse(req.rawBody.toString()) : undefined, opt);
+        return this.validate(req, 'body', schema, req.rawBody?.byteLength ? () => JSON.parse(req.rawBody.toString()) : undefined, opt);
     }
     /**
      * Query validation uses type coercion (unlike body validation),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/backend-lib",
   "type": "module",
-  "version": "9.47.0",
+  "version": "9.48.0",
   "peerDependencies": {
     "@sentry/node": "^10"
   },

package/src/server/eventLoop.util.ts

@@ -1,8 +1,16 @@
 import type { EventLoopUtilization, IntervalHistogram } from 'node:perf_hooks'
-import { monitorEventLoopDelay, performance } from 'node:perf_hooks'
-import type { NumberOfMilliseconds, NumberOfPercent } from '@naturalcycles/js-lib/types'
+import { monitorEventLoopDelay, performance, PerformanceObserver } from 'node:perf_hooks'
+import type {
+  NonNegativeInteger,
+  NumberOfMilliseconds,
+  NumberOfPercent,
+} from '@naturalcycles/js-lib/types'
 
 /**
+ * Monitors EventLoopDelay.
+ * Also, monitors GC performance.
+ * Once per `measureInterval` sends a callback with stats.
+ *
  * @experimental
  */
 export class EventLoopMonitor {
@@ -14,9 +22,18 @@ export class EventLoopMonitor {
 
     this.lastElu = performance.eventLoopUtilization()
 
+    this.po = new PerformanceObserver(list => {
+      for (const entry of list.getEntries()) {
+        this.gcCount++
+        this.gcTotalTime += entry.duration
+      }
+    })
+
+    this.po.observe({ entryTypes: ['gc'] })
+
     this.interval = setInterval(() => {
       // Delay stats are reported in **nanoseconds**
-      const { eld } = this
+      const { eld, gcCount, gcTotalTime } = this
       const p50 = Math.round(eld.percentile(50) / 1e6)
       const p90 = Math.round(eld.percentile(90) / 1e6)
       const p99 = Math.round(eld.percentile(99) / 1e6)
@@ -28,6 +45,7 @@ export class EventLoopMonitor {
       this.lastElu = currentElu
 
       const elu = Math.round(deltaElu.utilization * 100)
+      const gcCPU = Math.round((gcTotalTime / measureInterval) * 100)
 
       this.lastStats = {
         p50,
@@ -36,11 +54,16 @@ export class EventLoopMonitor {
         max,
         mean,
         elu,
+        gcCount,
+        gcTotalTime,
+        gcCPU,
       }
 
       cfg.onStats?.(this.lastStats)
 
       eld.reset()
+      this.gcCount = 0
+      this.gcTotalTime = 0
     }, measureInterval)
   }
 
@@ -51,10 +74,14 @@ export class EventLoopMonitor {
    * Undefined until the first interval has completed.
    */
   lastStats?: EventLoopStats
+  po: PerformanceObserver
+  gcCount = 0
+  gcTotalTime = 0
 
   stop(): void {
-    this.interval.close()
+    clearInterval(this.interval)
     this.eld.disable()
+    this.po.disconnect()
   }
 
   // cfg: Required<EventLoopMonitorCfg>
@@ -92,4 +119,16 @@ export interface EventLoopStats {
    *   utilization: active / (idle + active)
    */
   elu: NumberOfPercent
+  /**
+   * Number of times gc ran during the last `measureInterval`
+   */
+  gcCount: NonNegativeInteger
+  /**
+   * Total time spent on gc during the last `measureInterval`
+   */
+  gcTotalTime: NumberOfMilliseconds
+  /**
+   * % of CPU time spent on GC in the last `measureInterval`
+   */
+  gcCPU: NumberOfPercent
 }

package/src/validation/ajv/ajvValidateRequest.ts

@@ -17,7 +17,7 @@ class AjvValidateRequest {
       req,
       'body',
       schema,
-      req.rawBody ? () => JSON.parse(req.rawBody!.toString()) : undefined,
+      req.rawBody?.byteLength ? () => JSON.parse(req.rawBody!.toString()) : undefined,
       opt,
     )
   }