@ndiinginc/router 4.6.1 → 4.7.0

package/README.md

@@ -198,18 +198,18 @@ Jika tidak ada handler yang mengirim response, router mengirim JSON otomatis:
 
 ## Timeout
 
-Aktifkan lewat opsi `timeout` (milidetik) pada `App`. Jika seluruh chain handler melebihi waktu tersebut, error `504 Gateway Timeout` dilempar dan diteruskan ke error handler.
+Aktifkan lewat opsi `requestTimeout` (milidetik) pada `App`. Jika seluruh chain handler melebihi waktu tersebut, error `504 Gateway Timeout` dilempar dan diteruskan ke error handler.
 
 ```js
-const app = new App({ timeout: 5000 });
+const app = new App({ requestTimeout: 5000 });
 ```
 
-- Tanpa opsi `timeout` (atau bernilai `0`), tidak ada batas waktu
+- Tanpa opsi `requestTimeout` (atau bernilai `0`), tidak ada batas waktu
 - Handler yang sudah berjalan tidak dihentikan paksa. Tetapi setelah response dikirim, `res.json()` dan `res.send()` mengabaikan penulisan berikutnya, dan handler selanjutnya di chain tidak dipanggil
 
 ### `req.signal`
 
-Saat `timeout` aktif, `req.signal` adalah `AbortSignal` yang di-abort ketika timeout terjadi (reason-nya error 504) atau ketika salah satu handler melempar error (reason-nya error tersebut). Teruskan ke operasi yang mendukungnya agar pekerjaan ikut dibatalkan:
+Saat `requestTimeout` aktif, `req.signal` adalah `AbortSignal` yang di-abort ketika timeout terjadi (reason-nya error 504) atau ketika salah satu handler melempar error (reason-nya error tersebut). Teruskan ke operasi yang mendukungnya agar pekerjaan ikut dibatalkan:
 
 ```js
 app.get("/proxy", async (req, res) => {
@@ -218,7 +218,7 @@ app.get("/proxy", async (req, res) => {
 });
 ```
 
-`req.signal` bernilai `undefined` jika `timeout` tidak diaktifkan.
+`req.signal` bernilai `undefined` jika `requestTimeout` tidak diaktifkan.
 
 ## Request
 
@@ -228,7 +228,7 @@ app.get("/proxy", async (req, res) => {
 | `req.query` | Object query string, di-parse secara lazy. Key yang berulang menjadi array, dan `+` di-decode menjadi spasi |
 | `req.params` | Parameter dari route dinamis (sudah di-decode) |
 | `req.body` | Hasil parse body (butuh middleware `json()`) |
-| `req.signal` | `AbortSignal` yang di-abort saat timeout atau error handler (hanya jika `timeout` aktif) |
+| `req.signal` | `AbortSignal` yang di-abort saat timeout atau error handler (hanya jika `requestTimeout` aktif) |
 
 ```js
 // GET /search?tag=a&tag=b&page=2
@@ -310,21 +310,21 @@ Perilaku:
 ## Opsi
 
 ```js
-const app = new App({ size: 1000, timeout: 5000 });
+const app = new App({ cacheSize: 1000, requestTimeout: 5000 });
 ```
 
 | Opsi | Default | Keterangan |
 | --- | --- | --- |
-| `size` | `1000` | Jumlah maksimum entri LRU cache untuk hasil lookup `METHOD path` |
-| `timeout` | - | Batas waktu handler dalam ms (khusus `App`). Lihat bagian [Timeout](#timeout) |
+| `cacheSize` | `1000` | Jumlah maksimum entri LRU cache untuk hasil lookup `METHOD path` |
+| `requestTimeout` | - | Batas waktu handler dalam ms (khusus `App`). Lihat bagian [Timeout](#requestTimeout) |
 
-`Router` hanya menerima `size`.
+`Router` hanya menerima `cacheSize`.
 
 ## API
 
 ### `new App([options])` / `new Router([options])`
 
-Membuat instance baru. `App` adalah `Router` ditambah `listen()` dan dukungan `timeout`.
+Membuat instance baru. `App` adalah `Router` ditambah `listen()` dan dukungan `requestTimeout`.
 
 ### `router.use([path], ...handlers | router)`
 
@@ -355,11 +355,12 @@ console.log(server.address().port);
 
 Hello world dengan satu route `GET /`, diuji memakai `autocannon -c 100 -d 40 -p 10` di mesin lokal.
 
-| | Req/sec (avg) | Latency (avg) |
-| --- | --- | --- |
-| Fastify | 31.475 | 31,27 ms |
-| **@ndiinginc/router** | 29.735 | 33,12 ms |
-| Express | 20.211 | 48,93 ms |
+| package           | Latency  | Req/Sec  | Bytes/Sec | Result                                |
+| ----------------- | -------- | -------- | --------- | ------------------------------------- |
+| fastify           | 25.3 ms  | 38,738.4 | 7.24 MB   | 1550k requests in 40.06s, 290 MB read |
+| @ndiinginc/router | 28.45 ms | 34,541.4 | 5.91 MB   | 1383k requests in 40.06s, 236 MB read |
+| express           | 41 ms    | 24,095.6 | 6.05 MB   | 965k requests in 40.06s, 242 MB read  |
+
 
 Hasil bervariasi tergantung mesin, versi Node.js, dan jumlah route. Benchmark ini hanya menggambarkan overhead dasar, bukan performa aplikasi nyata.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ndiinginc/router",
-  "version": "4.6.1",
+  "version": "4.7.0",
   "description": "",
   "main": "./src/index.js",
   "scripts": {
@@ -19,8 +19,8 @@
   "type": "commonjs",
   "devDependencies": {
     "@ndiinginc/commit": "^1.0.1",
-    "@ndiinginc/test": "^1.5.1",
+    "@ndiinginc/test": "^1.7.1",
     "@types/jest": "^30.0.0",
-    "@types/node": "^26.6.4"
+    "@types/node": "^26.6.5"
   }
 }

package/src/app.js

@@ -19,7 +19,7 @@ class App extends Router {
 
         const timeout = setTimeout(() => {
             controller.abort(ErrorResponse.status(504));
-        }, this.timeout);
+        }, this.requestTimeout);
 
         let handleAbort;
         const timeoutPromise = new Promise((_, reject) => {
@@ -54,7 +54,7 @@ class App extends Router {
                     await handler(req, res);
                 }
             };
-            if (this.timeout) await this.withTimeout(req, handlerPromise);
+            if (this.requestTimeout) await this.withTimeout(req, handlerPromise);
             else await handlerPromise();
         } catch (error) {
             err = error;

package/src/response.js

@@ -7,7 +7,7 @@ class Response extends http.ServerResponse {
     }
     send(chunk) {
         if (this.writableEnded) return;
-        this.end(chunk);
+        this.end(chunk,null,null);//avoid ArgumentsAdaptorTrampoline from V8
     }
     json(value) {
         if (this.writableEnded) return;
@@ -16,7 +16,7 @@ class Response extends http.ServerResponse {
             return;
         }
         this.setHeader("Content-Type", "application/json");
-        this.end(JSON.stringify(value));
+        this.end(JSON.stringify(value),null,null);//avoid ArgumentsAdaptorTrampoline from V8
     }
 }
 exports.Response = Response;

package/src/router.js

@@ -4,8 +4,8 @@ const {  decodePathParam } = require("./util.js");
 
 class Router {
     constructor(options = {}) {
-        this.timeout = options.timeout ?? 0;
-        this.cacheSize = options.size ?? 1000;
+        this.requestTimeout = options.requestTimeout ?? 0;
+        this.cacheSize = options.cacheSize ?? 1000;
         this.root = new Node();
         this.seq = 0;
         this.cache = new Cache(this.cacheSize);