📂 AETHERX

UltraFast Server – Lightweight Bun-powered HTTP framework with routes, middleware, plugins, request/response management, and modern logging

📦 Installation

npm install aetherx
# or
yarn add aetherx
# or
bun add aetherx

Note: Bun must be installed globally:

npm install -g bun

🚀 Running HTTP Server

import { Sether } from "aetherx";

const server = new Sether({
  port: 3000,
  settings: {
    logger: true,
    development: false,
    error: new Response(`<pre>500 Internal Server Error</pre>`, {
      status: 500,
      headers: { "Content-Type": "text/html" },
    }),
  },
});

🛣️ Adding Routes

app.get("/", (req, res) => res.status(200).text("Welcome!"));
app.get("/html", (req, res) => res.render("./src/pages/index.html"));
app.get("/ejs", (req, res) => 
  res.render("./src/pages/index.ejs", { title: "EJS Page" }) // requires npm i ejs
);

📌 Aether Router

import { Sether, Router } from "aetherx";

const router = new Router();

router.create({
  routeName: "myUserRoute",
  name: "/user",
  category: "/api",
  method: "get",
  run: (req, res) => res.render("./src/pages/index.html"),
});

router.create({
  routeName: "userProfile",
  name: "/user/profile",
  category: "/api",
  method: "get",
  run: (req, res) => res.render("./src/pages/profile.html"),
});

const server = new Sether({
  port: 3000,
  routes: ["myUserRoute", "userProfile"], // routeName references
  settings: {
    logger: true,
    development: false,
    error: new Response(`<pre>500 Internal Server Error</pre>`, {
      status: 500,
      headers: { "Content-Type": "text/html" },
    }),
  },
});

🔌 Plugins

Available plugins: AI, CORS, Helmet, RateLimit

import { Sether, AiPlugin, chat, CorsPlugin, HelmetPlugin, RateLimitPlugin } from "aetherx";

const server = new Sether({
  port: 3000,
  plugins: [
    new AiPlugin({
      apiKey: "YOUR_OPENAI_KEY",
      model: "gpt-4",
      chat: async (messages) => await chat("gemini", messages)
    }),
    new HelmetPlugin({
      contentSecurityPolicy: true,
      referrerPolicy: "no-referrer",
      xssProtection: true
    }),
    new CorsPlugin({
      origin: "*",
      methods: ["GET", "POST"],
      credentials: true
    }),
    new RateLimitPlugin({
      windowMs: 60000,
      max: 100,
      identifier: (req) => req.ip || "anon"
    }),
  ],
  settings: {
    logger: true,
    development: false,
  },
});

// Using AI chat
const reply = await chat("gemini", [
  { role: "user", content: "Hello Gemini!" }
]);
console.log(reply); // Gemini's response

🗓️ Events

server.on("ready", () => console.log("Server started!"));

server.emit("yourCustomEvent", "args");

server.on("yourCustomEvent", (...args) => console.log("Event triggered:", args));

⚡ API

Sether (Server)

| Method | Description | | ------------------------------ | -------------------------------- | | on(event: string, callback) | Listen for server events | | emit(event: string, ...args) | Emit custom events | | routes | Array of route names to register | | plugins | Array of plugins to use |

Router

| Method | Description | | ------------------------- | ------------------------------- | | create(params) | Create a new route | | getRouter() | Return all routes | | findRoute(name, method) | Find a route by name and method |

ReqManager

| Method | Description | | ------------------------ | -------------------------- | | json() | Parse request body as JSON | | text() | Get raw text body | | form() | Parse as FormData | | getHeader(name) | Get specific header | | getQuery(key, default) | Get query param | | getParam(key) | Get route param | | device() | Detect device/browser info | | ip | Get client IP |

ResponseBuilder

| Method | Description | | -------------------- | ------------------------ | | status(code) | Set response status | | json(data) | Send JSON response | | text(data) | Send plain text response | | render(path, data) | Render HTML/EJS template |