@nestia/benchmark 14.0.0 → 14.0.2

package/lib/internal/DynamicBenchmarkReporter.js

@@ -1,14 +1,40 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamicBenchmarkReporter = void 0;
-const os_1 = __importDefault(require("os"));
+/**
+ * Renders a benchmark report as markdown.
+ *
+ * @evidence contracts/common.md#principled-implementation The reporter formats one report into fixed sections (specifications, arguments, time, statistics, memory chart, endpoints, failures) using a fixed locale.
+ * @evidence contracts/common.md#clear-and-simple-design A one-function namespace, internal to the package, that keeps presentation out of the benchmark logic.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The content is computed from the report and host facts; no numbers are hardcoded.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its single job.
+ */
 var DynamicBenchmarkReporter;
 (function (DynamicBenchmarkReporter) {
-    DynamicBenchmarkReporter.markdown = (report) => {
-        const format = (value) => value === null ? "N/A" : (Math.floor(value * 100) / 100).toLocaleString();
+    /**
+     * Renders the report as markdown.
+     *
+     * Numbers use the fixed `en-US` locale, so a report reads the same on every
+     * machine. Decimals are truncated, not rounded, to two places. The CPU model
+     * is `unknown` when the platform exposes no CPU information.
+     *
+     * Processing cost: Endpoint and failure ordering require comparison sorts,
+     * costing O(E log E); four memory series each scan M samples, and temporary
+     * rows and final text scale with displayed data. Sorting copies preserve the
+     * caller's endpoint order.
+     *
+     * @evidence contracts/common.md#principled-implementation Each table row is built from the same statistics record; `Math.trunc` on the value scaled by 100 truncates toward zero to two decimals, including negative elapsed values after a wall-clock adjustment. `en-US` fixes separators, and an absent CPU model is displayed as `unknown`.
+     * @evidence contracts/common.md#clear-and-simple-design Small local helpers (`integer`, `format`, `row`, `line`) share the formatting rules inside one function, so one place decides how a number reads.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The report states only the report's measurements and supplied host facts; nothing describes an unmeasured backend server or changes foreign runtime methods.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the locale, the truncation, and the CPU fallback.
+     */
+    DynamicBenchmarkReporter.markdown = (report, host) => {
+        var _a;
+        // one fixed locale, so a report reads the same on every machine
+        const integer = (value) => value.toLocaleString("en-US");
+        const format = (value) => value === null
+            ? "N/A"
+            : (Math.trunc(value * 100) / 100).toLocaleString("en-US");
         const head = () => [
             "Type",
             "Count",
@@ -22,8 +48,8 @@ var DynamicBenchmarkReporter;
             new Array(7).fill("----").join("|");
         const row = (title, s) => [
             title,
-            s.count.toLocaleString(),
-            s.success.toLocaleString(),
+            integer(s.count),
+            integer(s.success),
             format(s.mean),
             format(s.stdev),
             format(s.minimum),
@@ -35,18 +61,17 @@ var DynamicBenchmarkReporter;
             "> Generated by [`@nestia/benchmark`](https://github.com/samchon/nestia)",
             ``,
             `  - Specifications`,
-            `    - CPU: ${os_1.default.cpus()[0].model}`,
-            `    - RAM: ${Math.floor(os_1.default.totalmem() / 1024 / 1024 / 1024).toLocaleString()} GB`,
-            `    - NodeJS Version: ${process.version}`,
-            `    - Backend Server: 1 core / 1 thread`,
+            `    - CPU: ${(_a = host.cpu) !== null && _a !== void 0 ? _a : "unknown"}`,
+            `    - RAM: ${integer(Math.floor(host.memory / 1024 / 1024 / 1024))} GB`,
+            `    - NodeJS Version: ${host.node}`,
             `  - Arguments`,
-            `    - Count: ${report.count.toLocaleString()}`,
-            `    - Threads: ${report.threads.toLocaleString()}`,
-            `    - Simultaneous: ${report.simultaneous.toLocaleString()}`,
+            `    - Count: ${integer(report.count)}`,
+            `    - Threads: ${integer(report.threads)}`,
+            `    - Simultaneous: ${integer(report.simultaneous)}`,
             `  - Time`,
             `    - Start: ${report.started_at}`,
             `    - Complete: ${report.completed_at}`,
-            `    - Elapsed: ${(new Date(report.completed_at).getTime() - new Date(report.started_at).getTime()).toLocaleString()} ms`,
+            `    - Elapsed: ${integer(new Date(report.completed_at).getTime() - new Date(report.started_at).getTime())} ms`,
             ``,
             head(),
             row("Total", report.statistics),
@@ -88,8 +113,8 @@ var DynamicBenchmarkReporter;
                 .map((e) => [
                 e.method,
                 e.path,
-                e.count.toLocaleString(),
-                (e.count - e.success).toLocaleString(),
+                integer(e.count),
+                integer(e.count - e.success),
             ].join(" | ")),
         ].join("\n");
     };

package/lib/internal/DynamicBenchmarkReporter.js.map

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

package/lib/internal/DynamicBenchmarkStatistics.d.ts

@@ -0,0 +1,25 @@
+import type { DynamicBenchmarker } from "../DynamicBenchmarker";
+import type { IBenchmarkEvent } from "../IBenchmarkEvent";
+/**
+ * Statistics of benchmarked events.
+ *
+ * @evidence contracts/common.md#principled-implementation The success count uses one reduction without retaining a filtered event array, while mean, population standard deviation, minimum and maximum share one pass over event start/completion durations. Both operations are linear in the event population.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with one exported function; the elapsed-time measures are a private helper of it.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The formulas are standard statistics without tuning to any benchmark result.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its single job.
+ */
+export declare namespace DynamicBenchmarkStatistics {
+    /**
+     * Summarizes events into counts and elapsed-time statistics.
+     *
+     * Durations are milliseconds. The empty set has `null` measures, and the
+     * standard deviation is the population deviation computed with Welford's
+     * update.
+     *
+     * @evidence contracts/common.md#principled-implementation Welford's update accumulates deviations from a running mean, avoiding the subtraction of nearly equal large squared averages that caused cancellation in constant durations. The variance divisor is the population count; floating-point arithmetic remains approximate rather than a claim of exact arithmetic for every possible input.
+     * @evidence contracts/common.md#clear-and-simple-design One shared pass computes the elapsed measures, a separate reduction counts successes, and the empty elapsed population is answered before the loop.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The method is the recognized single-pass algorithm rather than a compensating clamp.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the unit, the empty-set convention, and the algorithm.
+     */
+    const of: (events: IBenchmarkEvent[]) => DynamicBenchmarker.IReport.IStatistics;
+}

package/lib/internal/DynamicBenchmarkStatistics.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicBenchmarkStatistics = void 0;
+/**
+ * Statistics of benchmarked events.
+ *
+ * @evidence contracts/common.md#principled-implementation The success count uses one reduction without retaining a filtered event array, while mean, population standard deviation, minimum and maximum share one pass over event start/completion durations. Both operations are linear in the event population.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with one exported function; the elapsed-time measures are a private helper of it.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The formulas are standard statistics without tuning to any benchmark result.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its single job.
+ */
+var DynamicBenchmarkStatistics;
+(function (DynamicBenchmarkStatistics) {
+    /**
+     * Summarizes events into counts and elapsed-time statistics.
+     *
+     * Durations are milliseconds. The empty set has `null` measures, and the
+     * standard deviation is the population deviation computed with Welford's
+     * update.
+     *
+     * @evidence contracts/common.md#principled-implementation Welford's update accumulates deviations from a running mean, avoiding the subtraction of nearly equal large squared averages that caused cancellation in constant durations. The variance divisor is the population count; floating-point arithmetic remains approximate rather than a claim of exact arithmetic for every possible input.
+     * @evidence contracts/common.md#clear-and-simple-design One shared pass computes the elapsed measures, a separate reduction counts successes, and the empty elapsed population is answered before the loop.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The method is the recognized single-pass algorithm rather than a compensating clamp.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the unit, the empty-set convention, and the algorithm.
+     */
+    DynamicBenchmarkStatistics.of = (events) => (Object.assign({ count: events.length, success: events.reduce((count, event) => count + Number(event.success), 0) }, elapsed(events)));
+    const elapsed = (events) => {
+        if (events.length === 0)
+            return { mean: null, stdev: null, minimum: null, maximum: null };
+        // Welford's single pass keeps the sum of squared deviations from the
+        // running mean, so it stays non-negative where the difference between the
+        // mean of squares and the squared mean cancels to a negative value and the
+        // square root returns NaN.
+        let count = 0;
+        let mean = 0;
+        let deviations = 0;
+        let minimum = Number.POSITIVE_INFINITY;
+        let maximum = Number.NEGATIVE_INFINITY;
+        for (const event of events) {
+            const value = new Date(event.completed_at).getTime() -
+                new Date(event.started_at).getTime();
+            const delta = value - mean;
+            mean += delta / ++count;
+            deviations += delta * (value - mean);
+            minimum = Math.min(minimum, value);
+            maximum = Math.max(maximum, value);
+        }
+        return { mean, stdev: Math.sqrt(deviations / count), minimum, maximum };
+    };
+})(DynamicBenchmarkStatistics || (exports.DynamicBenchmarkStatistics = DynamicBenchmarkStatistics = {}));
+//# sourceMappingURL=DynamicBenchmarkStatistics.js.map

package/lib/internal/DynamicBenchmarkStatistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicBenchmarkStatistics.js","sourceRoot":"","sources":["../../src/internal/DynamicBenchmarkStatistics.ts"],"names":[],"mappings":";;;AAGA;;;;;;;GAOG;AACH,IAAiB,0BAA0B,CAkD1C;AAlDD,WAAiB,0BAA0B;IACzC;;;;;;;;;;;OAWG;IACU,6BAAE,GAAG,CAChB,MAAyB,EACe,EAAE,CAAC,iBAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IACvE,OAAO,CAAC,MAAM,CAAC,EAClB,CAAC;IAEH,MAAM,OAAO,GAAG,CACd,MAAyB,EAIzB,EAAE;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YACrB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnE,qEAAqE;QACrE,0EAA0E;QAC1E,2EAA2E;QAC3E,2BAA2B;QAC3B,IAAI,KAAK,GAAW,CAAC,CAAC;QACtB,IAAI,IAAI,GAAW,CAAC,CAAC;QACrB,IAAI,UAAU,GAAW,CAAC,CAAC;QAC3B,IAAI,OAAO,GAAW,MAAM,CAAC,iBAAiB,CAAC;QAC/C,IAAI,OAAO,GAAW,MAAM,CAAC,iBAAiB,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GACT,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;gBACtC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,KAAK,GAAW,KAAK,GAAG,IAAI,CAAC;YACnC,IAAI,IAAI,KAAK,GAAG,EAAE,KAAK,CAAC;YACxB,UAAU,IAAI,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACnC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC,EAlDgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QAkD1C"}

package/lib/internal/IBenchmarkMaster.d.ts

@@ -1,4 +1,30 @@
+/**
+ * The operations a servant may call on the master through the worker
+ * connection.
+ *
+ * @evidence contracts/common.md#principled-implementation The interface lists the two calls the servant makes back to the master: whether to load a file and how many benchmark function invocations have completed.
+ * @evidence contracts/common.md#clear-and-simple-design Two members, one per callback, with no behavior in the type.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is the RPC contract of the master, not a test-specific seam.
+ * @evidence contracts/common.md#meaningful-documentation The comment states which side implements it.
+ */
 export interface IBenchmarkMaster {
+    /**
+     * Asks the master whether a benchmark file, by basename, may be imported.
+     *
+     * @evidence contracts/common.md#principled-implementation The servant asks before every import so the master's predicate decides which modules load.
+     * @evidence contracts/common.md#clear-and-simple-design One predicate over a file name.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The answer is the caller's filter, not a fixed list.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the argument and the meaning of the answer.
+     */
     filter: (file: string) => boolean;
+    /**
+     * Reports the number of benchmark function invocations this servant has
+     * completed so far, independently of logged HTTP event count.
+     *
+     * @evidence contracts/common.md#principled-implementation A servant reports its own cumulative count, and the master sums the servants' counts.
+     * @evidence contracts/common.md#clear-and-simple-design One notification with one number.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The count is measured by the servant, not estimated.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that the value is cumulative and per servant.
+     */
     progress: (current: number) => void;
 }

package/lib/internal/IBenchmarkServant.d.ts

@@ -1,5 +1,24 @@
 import { IBenchmarkEvent } from "../IBenchmarkEvent";
+/**
+ * The operations the master may call on a servant through the worker
+ * connection.
+ *
+ * @evidence contracts/common.md#principled-implementation The interface lists the one call the master makes: run a share of benchmark function invocations and return their logged HTTP events.
+ * @evidence contracts/common.md#clear-and-simple-design One member, no behavior in the type.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is the RPC contract of the servant, not a test-specific seam.
+ * @evidence contracts/common.md#meaningful-documentation The comment states which side implements it.
+ */
 export interface IBenchmarkServant {
+    /**
+     * Runs the requested number of benchmark function invocations with the given
+     * simultaneous budget and returns every logged HTTP event. One invocation can
+     * log zero, one or several events.
+     *
+     * @evidence contracts/common.md#principled-implementation The master gives each servant its share of the count and of the simultaneous budget, and the servant returns the events for its share.
+     * @evidence contracts/common.md#clear-and-simple-design One request-response operation with two numbers in and events out.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The servant runs what the master assigned, without adjusting the budget.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the arguments and the returned events.
+     */
     execute(props: {
         count: number;
         simultaneous: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/benchmark",
-  "version": "14.0.0",
+  "version": "14.0.2",
   "description": "NestJS Performance Benchmark Program",
   "main": "lib/index.js",
   "exports": {
@@ -30,7 +30,7 @@
   "dependencies": {
     "tgrid": "^1.2.1",
     "tstl": "^3.0.0",
-    "@nestia/fetcher": "^14.0.0"
+    "@nestia/fetcher": "^14.0.2"
   },
   "devDependencies": {
     "@types/node": "^25.3.3",
@@ -48,7 +48,8 @@
   },
   "scripts": {
     "build": "rimraf lib && ttsc",
-    "dev": "rimraf lib && ttsc --watch"
+    "dev": "rimraf lib && ttsc --watch",
+    "evidence": "evidence"
   },
   "types": "lib/index.d.ts"
 }