feat: added system requirements checker

Author: mrepol742

package-lock.json

@@ -42,6 +42,7 @@
     "openai": "^5.10.2",
     "qrcode-terminal": "^0.12.0",
     "redis": "^5.6.0",
+    "semver": "^7.7.2",
     "systeminformation": "^5.27.7",
     "whatsapp-web.js": "^1.31.0",
     "youtubei.js": "^15.0.0"
@@ -51,6 +52,7 @@
     "@types/dotenv": "^6.1.1",
     "@types/node": "^24.0.14",
     "@types/npmlog": "^7.0.0",
+    "@types/semver": "^7.7.1",
     "prisma": "^6.12.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"

package.json

@@ -0,0 +1,86 @@
+import { execSync } from "child_process";
+import * as process from "process";
+import semver from "semver";
+import log from "./log";
+import url from "url";
+
+function checkNodeVersion() {
+  const current = process.versions.node;
+  const required = ">=24.0.0";
+  if (!semver.satisfies(current, required)) {
+    log.warn("Requirements", `Node.js ${required} required, found ${current}`);
+  } else {
+    log.info("Requirements", `Node.js version OK: ${current}`);
+  }
+}
+
+function safePrintDBUrl(dbUrl: string, fallback: string) {
+  try {
+    const parsed = new url.URL(dbUrl);
+    return `${parsed.protocol}//${parsed.hostname}:${parsed.port || ""}`;
+  } catch {
+    return fallback;
+  }
+}
+
+function checkMySQL() {
+  const dbUrl = process.env.DATABASE_URL || "mysql://root@127.0.0.1:3306";
+  try {
+    const version = execSync("mysql --version").toString().trim();
+    log.info(
+      "Requirements",
+      `MySQL available at ${safePrintDBUrl(dbUrl, "mysql://127.0.0.1:3306")} | ${version}`,
+    );
+  } catch {
+    log.error("Requirements", "MySQL is required but not found (install mysql-client or ensure server is accessible).");
+    process.exit(1);
+  }
+}
+
+function checkRedis() {
+  const redisUrl = process.env.REDIS_URL || "redis://localhost:6379";
+  try {
+    const version = execSync("redis-cli --version").toString().trim();
+    log.info(
+      "Requirements",
+      `Redis available at ${safePrintDBUrl(redisUrl, "redis://localhost:6379")} | ${version}`,
+    );
+  } catch {
+    log.error("Requirements", "Redis is required but not found (install redis-cli or ensure server is running).");
+    process.exit(1);
+  }
+}
+
+function checkChrome() {
+  try {
+    const version = execSync("google-chrome-stable --version").toString().trim();
+    log.info("Requirements", `Google Chrome installed | ${version}`);
+  } catch {
+    try {
+      const version = execSync("chromium --version").toString().trim();
+      log.info("Requirements", `Chromium installed | ${version}`);
+    } catch {
+      log.error("Requirements", "Google Chrome/Chromium is required but not found.");
+      process.exit(1);
+    }
+  }
+}
+
+function checkFFMPEG() {
+  try {
+    const version = execSync("ffmpeg -version").toString().split("\n")[0].trim();
+    log.info("Requirements", `FFmpeg installed | ${version}`);
+  } catch {
+    log.warn("Requirements", "FFmpeg not found. Some features may not work.");
+  }
+}
+
+export function checkRequirements() {
+  log.info("Requirements", "Checking system requirements...");
+  checkNodeVersion();
+  checkMySQL();
+  checkRedis();
+  checkChrome();
+  checkFFMPEG();
+  log.info("Requirements", "System check complete.");
+}

src/components/utils/requirements.ts

@@ -1,6 +1,7 @@
 import dotenv from "dotenv";
 dotenv.config();
 
+import { checkRequirements } from "./components/utils/requirements";
 import { Message } from "whatsapp-web.js";
 import fs from "fs";
 import path from "path";
@@ -20,6 +21,8 @@ import {
   greetings,
 } from "./components/utils/data";
 
+checkRequirements();
+
 const commandPrefix = process.env.COMMAND_PREFIX || "!";
 const botName = process.env.PROJECT_CANIS_ALIAS || "Canis";
 const autoReload = process.env.AUTO_RELOAD === "true";