levix-bot 3.3.0-rc.2 → 4.0.0

package/README.md

@@ -69,9 +69,9 @@ docker compose logs levix
 
 ### Android phone (No server required)
 
-Run Levix directly on an ARM64 Android device (Android 10+) as a self-contained background companion:
+Run Levix directly on an Android device (Android 10+, ARM64 or ARMv7) as a self-contained background companion:
 
-1. Download **`levix-android-arm64.apk`** from [Releases](https://github.com/Abdodiab2005/levix/releases).
+1. Download **`levix-android-arm64.apk`** (64-bit phones) or **`levix-android-armv7.apk`** (32-bit phones) from [Releases](https://github.com/Abdodiab2005/levix/releases).
 2. Install the APK and tap **Start Host**.
 3. Tap **Open Panel** to set your master password and link WhatsApp via 8-digit Pairing Code.
 
@@ -171,14 +171,15 @@ start.
 ## Architecture
 
 - **Node.js 24+** with ES modules and CommonJS where needed.
-- **Baileys v7** for the WhatsApp connection and LID support.
-- **`node:sqlite`** for a single-file datastore with no database server or
-  native SQLite dependency.
-- **Express + EJS** for a panel with no frontend build step or CDN dependency.
+- **Baileys v7** for the WhatsApp protocol engine, LID support, and phone pairing codes.
+- **`node:sqlite`** for a zero-dependency, single-file datastore.
+- **React + Vite Control Panel** (`frontend/`) with TypeScript, native RTL Arabic / English internationalization, Lucide icons, responsive drawer, modal dialogs, and real-time Socket.IO synchronization.
+- **Express + EJS Gateways** for lightweight setup, login, and pairing QR gateway screens.
 - **Pluggable AI providers** — Google Gemini, OpenAI / any OpenAI-compatible endpoint, or
   Anthropic — each with its own endpoint, API key, and model in the control panel, no env file.
+- **Biome** for fast formatting and linting across the codebase.
 - **GitHub Actions** validation for tests, npm packaging, Docker persistence,
-  and standalone executables on Linux, macOS, and Windows.
+  Android APK packaging, and standalone executables on Linux, macOS, and Windows.
 
 [AGENTS.md](AGENTS.md) documents the module layout, message flow, storage API,
 and architectural constraints. [PACKAGING.md](PACKAGING.md) covers npm, Docker,
@@ -190,8 +191,11 @@ systemd, installers, and single-executable releases.
 git clone https://github.com/Abdodiab2005/levix
 cd levix
 npm ci
-npm test
-npm start
+cd frontend && npm ci && cd ..
+npm run build        # compiles the React frontend to public/dashboard
+npm run lint         # runs Biome linter across the project
+npm test             # runs the full test suite
+npm start            # starts Levix
 ```
 
 Please read [CONTRIBUTING.md](CONTRIBUTING.md) before proposing a substantial

package/app.cjs

@@ -9,6 +9,8 @@
 // (port, proxy hops, extra origin) are settings in the database that the panel
 // itself can change.
 
+const fs = require("node:fs");
+const path = require("node:path");
 const http = require("node:http");
 const express = require("express");
 const { Server } = require("socket.io");
@@ -21,10 +23,9 @@ const settings = require("./src/config/settings.cjs");
 const secrets = require("./src/config/secrets.cjs");
 const { PanelSessionStore } = require("./src/panel/session-store.cjs");
 const { getQrCode } = require("./src/utils/storage.cjs");
-const {
-  clientAddress,
-  isDirectLocalRequest,
-} = require("./src/utils/requestOrigin.cjs");
+const { clientAddress, isDirectLocalRequest } = require("./src/utils/requestOrigin.cjs");
+const { blockedFor, recordFailure, clearAttempts } = require("./src/panel/login-throttle.cjs");
+const { isPanelSessionValid, stampPanelSession } = require("./src/panel/session-auth.cjs");
 
 const SESSION_COOKIE_NAME = "wa.sid";
 const SESSION_MAX_AGE_MS = 12 * 60 * 60 * 1000;
@@ -44,9 +45,10 @@ function isAllowedOrigin(origin, host) {
 // Browsers may legitimately serialize the Origin header as the literal string
 // "null" for a same-origin navigation in an opaque-origin context. Prefer
 // Fetch Metadata when the browser sends it. Some Chromium form navigations omit
-// Sec-Fetch-Site entirely, so only the two credential-gated auth forms get a
-// narrow fallback for Origin:null; every other mutation remains strict.
-const OPAQUE_ORIGIN_AUTH_PATHS = new Set(["/setup", "/login"]);
+// Sec-Fetch-Site entirely, so password-gated login gets a narrow fallback for
+// Origin:null. First-run setup is deliberately excluded: a loopback request
+// otherwise skips the setup code and could claim an unconfigured panel.
+const OPAQUE_ORIGIN_AUTH_PATHS = new Set(["/login"]);
 function isAllowedMutationRequest(req) {
   const origin = req.get("origin");
   const host = req.get("host");
@@ -60,9 +62,9 @@ function isAllowedMutationRequest(req) {
   if (fetchSite === "cross-site") return false;
 
   // Real Chromium can submit a top-level auth form with Origin:null and no
-  // Sec-Fetch-Site header. Setup is still protected by the one-time setup code
-  // for remote clients; login by the password; both share TCP-peer throttling.
-  // Do not generalize this exception to dashboard APIs or logout.
+  // Sec-Fetch-Site header. Login is still protected by the password and
+  // TCP-peer throttling. Do not generalize this exception to setup, dashboard
+  // APIs, or logout.
   if (origin === "null" && !fetchSite && OPAQUE_ORIGIN_AUTH_PATHS.has(req.path)) {
     return true;
   }
@@ -126,7 +128,7 @@ app.use((req, res, next) => {
 });
 
 function requireLoginApi(req, res, next) {
-  if (req.session?.loggedIn) return next();
+  if (isPanelSessionValid(req.session)) return next();
   return res.status(401).json({ error: "Unauthorized" });
 }
 
@@ -138,7 +140,7 @@ function noStore(req, res, next) {
 }
 
 function requireLoginPage(req, res, next) {
-  if (req.session?.loggedIn) return next();
+  if (isPanelSessionValid(req.session)) return next();
   return res.redirect("/");
 }
 
@@ -148,7 +150,10 @@ app.engine("ejs", require("ejs").__express);
 app.set("view engine", "ejs");
 app.set("views", assetPath("views"));
 // Name, tagline and credit for every template. Frozen — see brand.cjs.
-app.locals.brand = brand;
+// The one addition is the version from package.json, so the panel shows the
+// shipped version instead of a string frozen in the frontend bundle.
+const pkg = require("./package.json");
+app.locals.brand = { ...brand, version: pkg.version };
 app.use(express.static(assetPath("public")));
 app.use(express.urlencoded({ extended: true, limit: "100kb" }));
 
@@ -178,40 +183,20 @@ app.use(sessionMiddleware);
 // Every socket receives the pairing QR, so it goes through the same session.
 io.engine.use(sessionMiddleware);
 io.use((socket, next) => {
-  if (socket.request.session?.loggedIn) return next();
+  if (isPanelSessionValid(socket.request.session)) return next();
   next(new Error("unauthorized"));
 });
 
-// --- Attempt throttling ---------------------------------------------------
-// Shared by /login and /setup: both are a guess at a secret.
-//
-// Keyed on the TCP peer, never on `req.ip`: with `trust proxy` set, a client
-// picks its own `req.ip` by writing a header, so it could rotate the value and
-// never hit the limit.
-
-const ATTEMPT_WINDOW_MS = 15 * 60 * 1000;
-const MAX_ATTEMPTS = 5;
-const attempts = new Map();
-
-function blockedFor(ip) {
-  const now = Date.now();
-  for (const [key, entry] of attempts) {
-    if (now - entry.firstAt > ATTEMPT_WINDOW_MS) attempts.delete(key);
+function disconnectInvalidPanelSockets() {
+  for (const socket of io.of("/").sockets.values()) {
+    if (!isPanelSessionValid(socket.request.session)) socket.disconnect(true);
   }
-  const entry = attempts.get(ip);
-  if (!entry || entry.count < MAX_ATTEMPTS) return 0;
-  const remaining = ATTEMPT_WINDOW_MS - (now - entry.firstAt);
-  return remaining > 0 ? Math.ceil(remaining / 1000) : 0;
 }
 
-function recordFailure(ip) {
-  const now = Date.now();
-  const entry = attempts.get(ip);
-  if (!entry || now - entry.firstAt > ATTEMPT_WINDOW_MS) {
-    attempts.set(ip, { count: 1, firstAt: now });
-    return;
+function disconnectSessionSockets(sid) {
+  for (const socket of io.of("/").sockets.values()) {
+    if (socket.request.sessionID === sid) socket.disconnect(true);
   }
-  entry.count += 1;
 }
 
 // --- First run ------------------------------------------------------------
@@ -271,12 +256,12 @@ app.post("/setup", (req, res, next) => {
     return renderSetup(req, res, error.message, 400);
   }
 
-  attempts.delete(peer);
+  clearAttempts(peer);
   logger.info({ ip: peer }, "[dashboard] Password set — first run complete");
 
   req.session.regenerate((err) => {
     if (err) return next(err);
-    req.session.loggedIn = true;
+    stampPanelSession(req.session);
     req.session.save((saveErr) => {
       if (saveErr) return next(saveErr);
       res.redirect(303, "/");
@@ -288,13 +273,27 @@ app.post("/setup", (req, res, next) => {
 
 app.get("/", noStore, (req, res) => {
   if (!secrets.hasDashboardPassword()) return res.redirect("/setup");
-  if (req.session.loggedIn) return res.render("dashboard");
+  if (isPanelSessionValid(req.session)) {
+    const dashboardHtmlPath = path.join(assetPath("public"), "dashboard", "index.html");
+    if (fs.existsSync(dashboardHtmlPath)) {
+      let html = fs.readFileSync(dashboardHtmlPath, "utf8");
+      const credits = `<div class="brand-credits" style="display:none"><a href="${app.locals.brand.developerSite}">${app.locals.brand.developer}</a><a href="${app.locals.brand.studioSite}">${app.locals.brand.studio}</a></div>`;
+      html = html
+        .replace(
+          "</head>",
+          `<script>window.__BRAND__ = ${JSON.stringify(app.locals.brand)};</script></head>`,
+        )
+        .replace("</body>", `${credits}</body>`);
+      return res.type("html").send(html);
+    }
+    return res.render("dashboard");
+  }
   return res.render("login", { error: null });
 });
 
 app.get("/login", noStore, (req, res) => {
   if (!secrets.hasDashboardPassword()) return res.redirect("/setup");
-  if (req.session.loggedIn) return res.redirect("/");
+  if (isPanelSessionValid(req.session)) return res.redirect("/");
   return res.render("login", { error: null });
 });
 
@@ -316,12 +315,12 @@ app.post("/login", (req, res, next) => {
     return res.status(401).render("login", { error: "Incorrect Password" });
   }
 
-  attempts.delete(peer);
+  clearAttempts(peer);
 
   // A fresh id after login, or the id an attacker planted beforehand still works.
   req.session.regenerate((err) => {
     if (err) return next(err);
-    req.session.loggedIn = true;
+    stampPanelSession(req.session);
     req.session.save((saveErr) => {
       if (saveErr) return next(saveErr);
       res.redirect(303, "/");
@@ -332,8 +331,10 @@ app.post("/login", (req, res, next) => {
 // POST, not GET: a link that changes state gets fired by an <img> or by the
 // browser's prefetch.
 app.post("/logout", (req, res, next) => {
+  const sid = req.sessionID;
   req.session.destroy((err) => {
     if (err) return next(err);
+    disconnectSessionSockets(sid);
     res.clearCookie(SESSION_COOKIE_NAME, {
       httpOnly: true,
       sameSite: "lax",
@@ -375,4 +376,6 @@ module.exports = {
   requireLoginPage,
   noStore,
   installFinalHandlers,
+  disconnectInvalidPanelSockets,
+  disconnectSessionSockets,
 };

package/package.json

@@ -1,13 +1,20 @@
 {
   "name": "levix-bot",
-  "version": "3.3.0-rc.2",
+  "version": "4.0.0",
   "description": "A self-hosted personal WhatsApp bot with an AI agent, group moderation and a web control panel.",
   "main": "src/index.js",
   "scripts": {
     "start": "node bin/levix.js",
     "dev": "nodemon bin/levix.js",
     "test": "node tests/run.mjs",
+    "lint": "biome lint",
+    "format": "biome format --write .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
     "brand:assets": "node scripts/build-brand-assets.mjs",
+    "build": "npm run build:frontend",
+    "build:frontend": "node scripts/build-frontend.mjs",
+    "prepack": "npm run build:frontend",
     "build:sea": "node scripts/build-sea.mjs",
     "validate:tarball": "node scripts/validate-tarball.mjs",
     "validate:sea": "node scripts/validate-sea.mjs",
@@ -68,6 +75,7 @@
     "node": ">=24"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.5.14",
     "esbuild": "^0.28.2",
     "postject": "^1.0.0-alpha.6",
     "sharp": "^0.35.3"