@techiev2/vajra 1.0.2 → 1.2.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,16 +5,19 @@ 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();
 });
 
 get('/', (req, res) => {
+  res.cookie('session', 'abc');
+  res.cookie('theme', 'dark');
+  res.cookie('user', 'test');
   res.writeMessage('Hello from Vajra ⚡');
 });
 

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) => {
@@ -56,6 +59,11 @@ export default class Vajra {
         res.sent = true; res.setHeader('Content-Type', 'text/html'); res.setHeader('Content-Length', Buffer.from(content).byteLength); res.write(content); res.end(); return res
       }
       req._headers = { ...req.headers }; req.headers = Object.fromEntries(req.rawHeaders.map((e, i) => i % 2 ? false : [e, req.rawHeaders[i + 1]]).filter(Boolean)); req.isPossibleJSON = req._headers['content-type'] === 'application/json'; req.params = {}
+      res.cookie = (k, v, options) => {
+        let { expires, path, maxAge, domain, secure, httpOnly, sameSite } = typeof options === 'object' ? options : typeof v === 'object' ? v : {}; const cookieOpts = [];!isNaN(+maxAge) && cookieOpts.push(`Max-Age=${Math.floor(maxAge)}`); !isNaN(+expires) && cookieOpts.push(`Expires=${new Date(expires).toUTCString()}`); expires instanceof Date && cookieOpts.push(`Expires=${expires.toUTCString()}`)
+        path && cookieOpts.push(`Path=${path}`); domain && cookieOpts.push(`Domain=${domain}`); !!secure && cookieOpts.push(`Secure`); !!httpOnly && cookieOpts.push(`HttpOnly`); sameSite = sameSite && (sameSite === true ? 'Strict' : typeof sameSite === 'string' ? sameSite.charAt(0).toUpperCase() + sameSite.slice(1).toLowerCase() : ''); !['Strict', 'Lax', 'None'].includes(sameSite) ? sameSite = 'Strict' : sameSite = sameSite; cookieOpts.push(`SameSite=${sameSite}`)
+        res.setHeader('Set-Cookie', (typeof k === 'object') ? Object.entries(k).map(([k_, v_]) => `${k_}=${encodeURIComponent(v_)}${cookieOpts.length ? `; ${cookieOpts.join('; ')}` : ''}`) : [...(res.getHeader('Set-Cookie') || []).filter(Boolean), `${k}=${encodeURIComponent(v)}${cookieOpts.length ? `; ${cookieOpts.join('; ')}` : ''}`])
+      }
       let url = `http://${req.headers.host || req.headers.host}/${req.url}`; req.query = Object.fromEntries(new URL(url).searchParams)
       if (req.method === 'GET' || req.method === 'HEAD') { return runMiddlwares() }
       async function runMiddlwares() {
@@ -63,19 +71,21 @@ export default class Vajra {
         await next();
       }
       setImmediate(() => {
-        req.body = {}; req.rawData = ''; req.formData = {};let dataSize = 0
+        req.body = {}; req.rawData = ''; req.formData = {}; let dataSize = 0
         req.on('data', (chunk) => { dataSize += chunk.length; if (dataSize > Vajra.#MAX_FILE_SIZE) { return default_413(res) }; req.rawData+=chunk })
-        const formDataMatcher = /Content-Disposition: form-data; name=['"](?<name>[^"']+)['"]\s+(?<value>.*?)$/smi; const multiPartMatcher = /--------------------------.*?\r\n/gsmi
-        const fileDataMatcher = /^Content-Disposition:.*?name=["'](?<field>[^"']+)["'].*?filename=["'](?<fileName>[^"']+)["'].*?Content-Type:\s*(?<contentType>[^\r\n]*)\r?\n\r?\n(?<content>[\s\S]*)$/ims
+        const formDataMatcher = /Content-Disposition: form-data; name=['"](?<name>[^"']+)['"]\s+(?<value>.*?)$/smi;
+        let boundaryMatch = (req.headers['Content-Type'] || '').match(/boundary=(.*)/); const boundary = boundaryMatch ? '--' + boundaryMatch[1] : null; const fileDataMatcher = /^Content-Disposition:.*?name=["'](?<field>[^"']+)["'].*?filename=["'](?<fileName>[^"']+)["'].*?Content-Type:\s*(?<contentType>[^\r\n]*)\r?\n\r?\n(?<content>[\s\S]*)$/ims
         req.on('end', async () => {
-          req.files = []; req.rawData.split(multiPartMatcher).filter(Boolean).map((line) => {
-            let key, value; if (line.includes('filename')) { req.files.push(fileDataMatcher.exec(line)?.groups || {}); return }
-            [key, value] = Object.values(line.match(formDataMatcher)?.groups || {}); (key && value) && Object.assign(req.formData, { [key]: value });  return
-          })
+          req.files = []; if (boundary) { req.rawData.split(boundary).filter(Boolean).map((line) => {
+              let key, value; if (line.includes('filename')) { req.files.push(fileDataMatcher.exec(line)?.groups || {}); return }
+              [key, value] = Object.values(line.match(formDataMatcher)?.groups || {}); (key && value) && Object.assign(req.formData, { [key]: value });  return
+            })
+          }
           if (Object.keys(req.formData).length) { req.body = req.formData } else {
             try { req.body = JSON.parse(req.rawData); req.isPossibleJSON = true } catch (_) { req.body = Object.fromEntries(req.rawData.split('&').map((pair) => pair.split('='))) }
           }; setImmediate(runMiddlwares)
         })
+        req.cookies = Object.fromEntries((req.headers.Cookie || req.headers.cookie || '').split(/;\s*/).map((k) => k.split('=')).map(([k, v]) => [k.trim(), decodeURIComponent(v).trim()]))
       })
       async function handleRoute() {
         let match_; const directHandler = (Vajra.#straightRoutes[req.url] || {})[req.method.toLowerCase()]
@@ -104,8 +114,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.2.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",