brahma-firelight

🗿 Brahma-JS (brahma-firelight)

JavaScript convenience, turbo-charged by Rust.

Brahma-JS is an ultra-low-latency orchestrator for JS, blending familiar Express-style middleware and routing with a high-performance core built in Rust. Ideal for micro-service and API use-cases where speed matters.

The Vision: Why Brahma-JS?

• Rust-level performance, without needing to write Rust.
• Express-like API, so JS devs can jump in instantly.
• Built with Tokio + Hyper, delivering asynchronous speed and efficiency.
• Lightweight, zero-dependency binary — no build headaches.

Performance Benchmarks

Benchmarks were run with wrk on an Intel® Core™ i5-12450H (12 vCPUs available under virtualization, 200 concurrent connections, 10s duration):

wrk output (Brahma-JS):

Running 10s test @ [http://127.0.0.1:2000/hi](http://127.0.0.1:2000/hi)
1 threads and 200 connections
Thread Stats   Avg      Stdev     Max   +/- Stdev
Latency     1.51ms  479.16us   7.89ms   78.17%
Req/Sec   131.57k     9.13k  146.78k    79.00%
1309338 requests in 10.00s, 186.05MB read
Requests/sec: 130899.58
Transfer/sec: 18.60MB

Takeaway: Brahma-JS sustains 130k+ requests/sec with low latency, powered by its Rust core and Express-style developer API.

🔬 How to Reproduce

• Start Brahma-JS server:

node server.js
# server listens on 0.0.0.0:2000

• Run wrk against the /hi endpoint:

wrk http://127.0.0.1:2000/hi -d 10 -t 1 -c 200

• -d 10 → run for 10 seconds
• -t 1 → 1 worker thread
• -c 200 → 200 concurrent connections

• Test machine info (lscpu):

Architecture:           x86_64
CPU(s):                 12
Model name:             12th Gen Intel(R) Core(TM) i5-12450H
Threads per core:       2
Cores per socket:       6
Virtualization:         Microsoft Hyper-V (full)

Quick Start

npm install brahma-firelight
# or
yarn add brahma-firelight
# or
pnpm add brahma-firelight
# or
bun add brahma-firelight
# or
nypm add brahma-firelight

const {
  createApp,
  getJsResponseTimeout,
  getMaxBodyBytes,
  setJsResponseTimeout,
  setMaxBodyBytes,
} = require("brahma-firelight");

const app = createApp();

// save production from disasters by locking in Rust
// defaults to 30 seconds and 4mb limit.
// set 2 minutes timeout (120 seconds)
setJsResponseTimeout(120);

// set max body to 50 MiB
setMaxBodyBytes(50 * 1024 * 1024); // 52_428_800

console.log("timeout secs:", getJsResponseTimeout()); // prints 120
console.log("max body bytes:", getMaxBodyBytes()); // prints 52428800

// CORS config
app.use((req, res, next) => {
  const origin = req.headers.origin;

  if (origin) {
    res.setHeader("Access-Control-Allow-Origin", origin); // echo back client origin
    res.setHeader("Access-Control-Allow-Credentials", "true");
  } else {
    // fallback (same-origin or no Origin header)
    res.setHeader("Access-Control-Allow-Origin", "*");
  }

  res.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
  res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");

  if (req.method === "OPTIONS") {
    res.send(204);
  } else {
    next();
  }
});

// Middlewares

function authMiddleware(req, res, next) {
  if (!req.headers["authorization"]) return res.text("Unauthorized", 401);
  next();
}

// utils.js
function sleep(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

app.get("/hi", (req, res) => {
  res.json({ message: "Hello World from Brahma-JS!" });
});

// // Async handler returning an object
app.get("/time", async (req) => {
  await sleep(20000);
  return {
    status: 400,
    headers: { "Content-Type": "application/json" }, // Custom Returns
    body: JSON.stringify({ now: Date.now() }),
  };
});

// To send HTML response
app.get("/page", (req, res) => {
  res.html(`<h1>Hello HTML</h1><p>Served by Brahma-JS id: ${req.reqId}</p>`);
});

app.post("/submit", (req, res) => {
  let formData = JSON.parse(req.body);
  console.log("bodyData:", formData);
  res.json(formData, 201); // return the JSON response with http-status-code
});

// Set-Up cookies and User Sessions

app.get("/set-cookies", (req, res) => {
  console.log("Request:-->", req); // Request Parameters-> contains all info + additional meta data
  res.send(
    200, // http-status code
    { "Content-Type": "text/plain" }, // headers Content-Type
    ["a=1; Path=/; HttpOnly", "b=2; Path=/; Secure; Max-Age=3600"], // manual cookie setup
    "hello" // optional Return Body
  );
});

app.get("/redirect", (req, res) => {
  res.redirect("https://google.com");
});

app.post("/protected", authMiddleware, (req, res) =>
  res.json({ success: true })
);

app.listen("0.0.0.0", 2000, () => {
  console.log("Server listening on port 2000");
});

// Enable built in Graceful Shutdown (optional for production use)

// process.on('SIGINT', async () => {
//   console.log('SIGINT → shutting down...');
//   await app.close(5000); // wait up to 5s for requests
//   process.exit(0);
// });

// process.on('SIGTERM', async () => {
//   console.log('SIGTERM → shutting down...');
//   await app.close(5000);
//   process.exit(0);
// });

Familiar API, Turbo-Charged ⚡ Backend

Just like Express:

app.get("/healthz", (req, res) => {
  res.send(200);
});

But under the hood:

• Execution occurs in Rust (Tokio + Hyper).
• Handlers (sync or async) run without sacrificing speed.
• Middleware works seamlessly — same developer experience, turbo-charged engine.

More Examples

Async Fetch

app.get("/data", async (req, res) => {
  const result = await fetch(
    "https://jsonplaceholder.typicode.com/todos/1"
  ).then((r) => r.json());
  res.json({ result });
});

Middleware + Delay

app.use((req, res, next) => {
  req.startTime = Date.now();
  next();
});

app.get("/delay", async (req, res) => {
  await new Promise((r) => setTimeout(r, 200));
  res.json({ elapsed: Date.now() - req.startTime });
});

Status & Feedback

• Beta / experimental — actively refined based on usage.
• Feedback and early adopters highly encouraged.

Platform binaries / Prebuilds

Brahma-Firelight ships prebuilt native binaries for macOS, Linux and Windows so you don't need to compile the native addon locally.

Supported artifact filenames (what the JS loader will try to load):

• macOS (Apple Silicon): brahma-js.darwin-arm64.node
• macOS (Intel x64): brahma-js.darwin-x64.node
• Linux (x64, GNU): brahma-js.linux-x64-gnu.node
• Linux (arm64, GNU): brahma-js.linux-arm64-gnu.node
• Windows (x64, MSVC): brahma-js.win32-x64-msvc.node

👉 Forked from Brahma-Core. An open source repository Brahma-Core.

🧾 License

MIT © LICENSE