@techiev2/vajra 1.0.2 → 1.1.0

package/README.md

@@ -14,15 +14,16 @@ Vajra draws from the Rigvedic thunderbolt weapon of Indra — crafted from the b
 Like the Vajra, this server delivers maximum power in minimal form.
 
 
-[![npm version](https://img.shields.io/npm/v/vajra.svg?style=flat-square)](https://www.npmjs.com/package/vajra)
-[![npm downloads](https://img.shields.io/npm/dm/vajra.svg?style=flat-square)](https://www.npmjs.com/package/vajra)
-[![Node.js version](https://img.shields.io/node/v/vajra.svg?style=flat-square)](https://nodejs.org)
-[![License](https://img.shields.io/npm/l/vajra.svg?style=flat-square)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/@techiev2/vajra.svg?style=flat-square)](https://www.npmjs.com/package/@techiev2/vajra)
+[![npm downloads](https://img.shields.io/npm/dm/vajra.svg?style=flat-square)](https://www.npmjs.com/package/@techiev2/vajra)
+[![Node.js version](https://img.shields.io/node/v/@techiev2/vajra.svg?style=flat-square)](https://nodejs.org)
+[![License](https://img.shields.io/npm/l/@techiev2/vajra.svg?style=flat-square)](LICENSE)
 
 ## Features
 
 - Zero external dependencies
 - Built-in routing with named parameters (`:id`)
+- Asynchronous batched logging for performance
 - Global middleware support with `next()` chaining
 - JSON, urlencoded, and **multipart/form-data** body parsing
 - Fast HTML templating with loops, nested objects, and simple array headers
@@ -59,14 +60,17 @@ async function getUsers(query = {}) {
   return (await fetch(`https://jsonplaceholder.typicode.com/users?${encode(query)}`)).json()
 }
 
-const { get, post, use, start, setProperty } = Vajra.create();
+const { get, post, use, start, setProperty, log } = Vajra.create();
 
 setProperty({ viewsRoot: `${import.meta.url}/views` })
 // Or as a key-value pair
 // setProperty('viewsRoot', `${import.meta.url}/views`)
 
 use((req, res, next) => {
-  console.log(`${req.method} ${req.url}`);
+  // Vajra provides an async batched logger to provide a balance between 100% log coverage and performance.
+  // If you prefer blocking immediate logs, you can switch to console.log
+  // or any other library of your choice.
+  log(`${req.method} ${req.url}`);
   next();
 });
 
@@ -156,6 +160,7 @@ app.setProperty('viewRoot', './views');
 - `use(middleware)`
 - `start({ port, host }, callback?)`
 - `setProperty(key, value)` or `setProperty({ key: value })`
+- `log(message)`
 
 
 #### Response helpers:

package/examples/api.js

@@ -5,12 +5,12 @@ async function getUsers(query = {}) {
   return (await fetch(`https://jsonplaceholder.typicode.com/users?${encode(query)}`)).json()
 }
 
-const { get, post, use, start, setProperty } = Vajra.create();
+const { get, post, use, start, setProperty, log } = Vajra.create();
 
 setProperty({ viewRoot: `${import.meta.dirname}/views` })
 
 use((req, res, next) => {
-  console.log(`${req.method} ${req.url}`);
+  log(`${req.method} ${req.url}`)
   next();
 });
 

package/index.js

@@ -25,8 +25,11 @@ const MAX_MB = 2; const MAX_FILE_SIZE = MAX_MB * 1024 * 1024
 export default class Vajra {
   static #app; static #routes = {}; static #middlewares = []; static #straightRoutes = {}; static #MAX_FILE_SIZE; static #onCreate; static #props = {}
   static create({ maxFileSize } = { maxFileSize: 2 }) {
-    Vajra.#MAX_FILE_SIZE = !+MAX_FILE_SIZE ? +maxFileSize * 1024 * 1024 : MAX_FILE_SIZE
     Vajra.#app = createServer()
+    const _queue = []; const LOG_QUEUE_SIZE = 100; const logOut = () => { if (_queue.length) { process.stdout.write(`${_queue.join('').trim()}\n`) }; _queue.length = 0 };
+    const flushAndShutDown = () => { logOut(); Vajra.#app.close(() => { process.exit(0); }); }; 'SIGINT_SIGTERM_SIGABRT'.split('_').map((evt) => process.on(evt, flushAndShutDown));
+    process.on('exit', logOut); function log(message) { _queue.push(`${message}\n`); if (_queue.length >= LOG_QUEUE_SIZE) { logOut(); _queue.length = 0; } }
+    Vajra.#MAX_FILE_SIZE = !+MAX_FILE_SIZE ? +maxFileSize * 1024 * 1024 : MAX_FILE_SIZE
     Vajra.#app.on('request', async (req, res) => {
       res.sent = false;
       res.status = (/**@type{code} Number*/ code) => {
@@ -104,8 +107,6 @@ export default class Vajra {
       if (typeof fn !== "function") { throw new Error(`${fn} is not a function. Can't use as middleware`) }
       Vajra.#middlewares.push(fn);  return defaults
     }
-    const defaults = Object.freeze(
-      Object.assign({}, { use, setProperty, start }, Object.fromEntries('get__post__put__patch__delete__head__options'.split('__').map((method) => [method, (...args) => register(method, ...args)]))
-    )); return Object.assign({}, { start }, defaults)
+    const defaults = Object.freeze(Object.assign({}, { use, setProperty, start, log }, Object.fromEntries('get__post__put__patch__delete__head__options'.split('__').map((method) => [method, (...args) => register(method, ...args)])))); return Object.assign({}, { start }, defaults)
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techiev2/vajra",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Blazing-fast, zero-dependency Node.js server with routing, middleware, multipart uploads, and templating. 111 lines · ~95k req/s · ~52 MB idle.",
   "keywords": [
     "http-server",