db: extract core DB layer and fix MySQL driver include path

- Introduce vix::db as core anti-ORM module
- Move MySQL driver under include/vix/db/mysql/
- Fix Database.cpp include to match new driver layout
- Prepare DB module for future drivers (SQLite, Postgres, Redis)
- Add tools directory for DB-level utilities (migrator moved out of ORM)

Author: GaspardKirira

.gitignore

@@ -43,7 +43,6 @@ hello_server
 *.bak
 db.sql
 revoir.md
-main.cpp
 .vix-scripts
 
 

CMakeLists.txt

@@ -234,8 +234,15 @@ endif()
 
 # Postgres driver sources (future placeholders)
 if (VIX_DB_HAS_POSTGRES)
-  list(APPEND VIX_DB_PUBLIC_HEADERS include/vix/db/postgres/PostgresDriver.hpp)
-  list(APPEND VIX_DB_SOURCES        src/postgres/PostgresDriver.cpp)
+  if (EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/include/vix/db/postgres/PostgresDriver.hpp"
+      AND EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/src/postgres/PostgresDriver.cpp")
+    list(APPEND VIX_DB_PUBLIC_HEADERS include/vix/db/postgres/PostgresDriver.hpp)
+    list(APPEND VIX_DB_SOURCES        src/postgres/PostgresDriver.cpp)
+  else()
+    message(WARNING "[vix_db] postgres enabled but driver sources not found; disabling.")
+    set(VIX_DB_HAS_POSTGRES OFF)
+    set(VIX_DB_USE_POSTGRES OFF)
+  endif()
 endif()
 
 # Redis client sources (future placeholders)
@@ -244,6 +251,28 @@ if (VIX_DB_HAS_REDIS)
   list(APPEND VIX_DB_SOURCES        src/redis/RedisClient.cpp)
 endif()
 
+if (VIX_DB_BUILD_TOOLS)
+  add_executable(vix_db_migrator)
+
+  target_sources(vix_db_migrator PRIVATE
+    ${CMAKE_CURRENT_SOURCE_DIR}/tools/migrator/main.cpp
+    ${CMAKE_CURRENT_SOURCE_DIR}/tools/migrator/MigratorCLI.cpp
+  )
+
+  target_link_libraries(vix_db_migrator PRIVATE vix::db)
+  target_compile_features(vix_db_migrator PRIVATE cxx_std_20)
+
+  if (MSVC)
+    target_compile_options(vix_db_migrator PRIVATE ${_WARNINGS_MSVC})
+  else()
+    target_compile_options(vix_db_migrator PRIVATE ${_WARNINGS_GNU})
+  endif()
+
+  install(TARGETS vix_db_migrator
+    RUNTIME DESTINATION ${CMAKE_INSTALL_LIBEXECDIR}/vix
+  )
+endif()
+
 # ------------------------------------------------------------------------------
 # If building DB standalone (not from umbrella), bring core as subdir
 # ------------------------------------------------------------------------------

include/vix/db/db.hpp

@@ -19,7 +19,7 @@
 #include <vix/db/Errors.hpp>
 #include <vix/db/Drivers.hpp>
 #if VIX_DB_HAS_MYSQL
-#include <vix/db/MySQLDriver.hpp>
+#include <vix/db/mysql/MySQLDriver.hpp>
 #endif
 #include <vix/db/ConnectionPool.hpp>
 #include <vix/db/Transaction.hpp>

src/Database.cpp

@@ -12,7 +12,7 @@
  */
 #include <vix/db/Database.hpp>
 #if VIX_DB_HAS_MYSQL
-#include <vix/db/MySQLDriver.hpp>
+#include <vix/db/mysql/MySQLDriver.hpp>
 #endif
 #include <vix/config/Config.hpp>
 

tools/migrator/MigratorCLI.cpp

@@ -0,0 +1,226 @@
+/**
+ *
+ *  @file MigratorCLI.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ */
+#include "MigratorCLI.hpp"
+
+#include <vix/db/db.hpp>
+#include <vix/db/FileMigrationsRunner.hpp>
+#include <vix/db/Drivers.hpp>
+
+#include <iostream>
+#include <stdexcept>
+#include <memory>
+
+namespace vix::db::tools
+{
+  void MigratorCLI::printUsage(const char *prog)
+  {
+    std::cout
+        << "Vix ORM Migrator\n\n"
+        << "Usage:\n"
+        << "  " << prog << " <host> <user> <pass> <db> migrate   [--dir <migrations_dir>]\n"
+        << "  " << prog << " <host> <user> <pass> <db> rollback  --steps <n> [--dir <migrations_dir>]\n"
+        << "  " << prog << " <host> <user> <pass> <db> status    [--dir <migrations_dir>]\n\n"
+        << "Examples:\n"
+        << "  " << prog << " tcp://127.0.0.1:3306 root '' mydb migrate --dir ./migrations\n"
+        << "  " << prog << " tcp://127.0.0.1:3306 root '' mydb rollback --steps 1\n"
+        << "  " << prog << " tcp://127.0.0.1:3306 root '' mydb status --dir db/migrations\n";
+  }
+
+  std::string MigratorCLI::getFlagValue(
+      const std::vector<std::string> &args,
+      const std::string &key)
+  {
+    for (size_t i = 0; i + 1 < args.size(); ++i)
+    {
+      if (args[i] == key)
+        return args[i + 1];
+    }
+    return {};
+  }
+
+  bool MigratorCLI::hasFlag(
+      const std::vector<std::string> &args,
+      const std::string &key)
+  {
+    for (const auto &a : args)
+    {
+      if (a == key)
+        return true;
+    }
+    return false;
+  }
+
+  std::string MigratorCLI::parseDir(const std::vector<std::string> &args)
+  {
+    std::string v = getFlagValue(args, "--dir");
+    if (!v.empty())
+      return v;
+
+    for (const auto &a : args)
+    {
+      const std::string p = "--dir=";
+      if (a.rfind(p, 0) == 0)
+      {
+        std::string vv = a.substr(p.size());
+        if (!vv.empty())
+          return vv;
+      }
+    }
+
+    return "migrations";
+  }
+
+  int MigratorCLI::parseStepsOrThrow(const std::vector<std::string> &args)
+  {
+    std::string steps_s = getFlagValue(args, "--steps");
+    if (steps_s.empty())
+      throw std::runtime_error("rollback requires --steps <n>");
+
+    int steps = 0;
+    try
+    {
+      steps = std::stoi(steps_s);
+    }
+    catch (...)
+    {
+      throw std::runtime_error("invalid --steps value (must be an integer)");
+    }
+
+    if (steps <= 0)
+      throw std::runtime_error("--steps must be >= 1");
+
+    return steps;
+  }
+
+  void MigratorCLI::validateOrThrow(const Options &opt)
+  {
+    if (opt.help)
+      return;
+
+    if (opt.host.empty() || opt.user.empty() || opt.db.empty())
+      throw std::runtime_error("missing required args: <host> <user> <pass> <db> <command>");
+
+    if (opt.command != "migrate" && opt.command != "rollback" && opt.command != "status")
+      throw std::runtime_error("unknown command: " + opt.command);
+
+    if (opt.command == "rollback" && opt.steps <= 0)
+      throw std::runtime_error("rollback requires --steps <n>");
+
+    if (opt.migrationsDir.empty())
+      throw std::runtime_error("migrations dir is empty (use --dir <path>)");
+  }
+
+  MigratorCLI::Options MigratorCLI::parseArgsOrThrow(int argc, char **argv)
+  {
+    Options opt;
+
+    std::vector<std::string> all;
+    all.reserve(static_cast<size_t>(argc));
+    for (int i = 0; i < argc; ++i)
+      all.emplace_back(argv[i]);
+
+    if (argc <= 1 || hasFlag(all, "-h") || hasFlag(all, "--help"))
+    {
+      opt.help = true;
+      return opt;
+    }
+
+    if (argc < 6)
+      throw std::runtime_error("not enough arguments");
+
+    opt.host = argv[1];
+    opt.user = argv[2];
+    opt.pass = argv[3];
+    opt.db = argv[4];
+    opt.command = argv[5];
+
+    std::vector<std::string> extra;
+    for (int i = 6; i < argc; ++i)
+      extra.emplace_back(argv[i]);
+
+    opt.migrationsDir = parseDir(extra);
+
+    if (opt.command == "rollback")
+      opt.steps = parseStepsOrThrow(extra);
+
+    validateOrThrow(opt);
+    return opt;
+  }
+
+  int MigratorCLI::run(int argc, char **argv)
+  {
+    try
+    {
+      Options opt = parseArgsOrThrow(argc, argv);
+
+      if (opt.help)
+      {
+        printUsage(argv[0]);
+        return 0;
+      }
+
+      vix::db::ConnectionPtr conn;
+      std::unique_ptr<vix::db::FileMigrationsRunner> runner;
+
+#if VIX_DB_HAS_MYSQL
+      {
+        auto factory = vix::db::make_mysql_factory(opt.host, opt.user, opt.pass, opt.db);
+        conn = factory();
+        runner = std::make_unique<vix::db::FileMigrationsRunner>(*conn, opt.migrationsDir);
+      }
+#elif VIX_DB_HAS_SQLITE
+      {
+        auto factory = vix::db::make_sqlite_factory(opt.db);
+        conn = factory();
+        runner = std::make_unique<vix::db::FileMigrationsRunner>(*conn, opt.migrationsDir);
+      }
+#else
+      std::cerr << "[ERR] vix_db_migrator built without DB drivers.\n"
+                << "Enable one with:\n"
+                << "  -DVIX_DB_HAS_MYSQL=1 (or add SQLite support)\n";
+      return 1;
+#endif
+
+      if (opt.command == "migrate")
+      {
+        runner->applyAll();
+        std::cout << "[OK] migrations applied\n";
+        return 0;
+      }
+
+      if (opt.command == "rollback")
+      {
+        runner->rollback(opt.steps);
+        std::cout << "[OK] rollback " << opt.steps << " step(s)\n";
+        return 0;
+      }
+
+      if (opt.command == "status")
+      {
+        std::cout << "[OK] migrations dir: " << opt.migrationsDir << "\n";
+        std::cout << "Tip: implement FileMigrationsRunner::status() to show applied vs pending.\n";
+        return 0;
+      }
+
+      printUsage(argv[0]);
+      return 1;
+    }
+    catch (const std::exception &e)
+    {
+      std::cerr << "[ERR] " << e.what() << "\n";
+      std::cerr << "Tip: run with --help\n";
+      return 1;
+    }
+  }
+
+} // namespace vix::db::tools

tools/migrator/MigratorCLI.hpp

@@ -0,0 +1,59 @@
+/**
+ *
+ *  @file MigratorCLI.hpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ */
+#ifndef VIX_DB_MIGRATOR_CLI_HPP
+#define VIX_DB_MIGRATOR_CLI_HPP
+
+#include <string>
+#include <vector>
+
+namespace vix::db::tools
+{
+  class MigratorCLI
+  {
+  public:
+    struct Options
+    {
+      std::string host;
+      std::string user;
+      std::string pass;
+      std::string db;
+
+      std::string command; // migrate | rollback | status
+      std::string migrationsDir = "migrations";
+
+      int steps = 0; // rollback steps
+      bool help = false;
+    };
+
+    static int run(int argc, char **argv);
+
+  private:
+    static void printUsage(const char *prog);
+
+    static Options parseArgsOrThrow(int argc, char **argv);
+
+    static std::string getFlagValue(const std::vector<std::string> &args,
+                                    const std::string &key);
+
+    static bool hasFlag(const std::vector<std::string> &args,
+                        const std::string &key);
+
+    static std::string parseDir(const std::vector<std::string> &args);
+
+    static int parseStepsOrThrow(const std::vector<std::string> &args);
+
+    static void validateOrThrow(const Options &opt);
+  };
+} // namespace vix::db::tools
+
+#endif

tools/migrator/main.cpp

@@ -0,0 +1,18 @@
+/**
+ *
+ *  @file main.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ */
+#include "MigratorCLI.hpp"
+
+int main(int argc, char **argv)
+{
+  return vix::db::tools::MigratorCLI::run(argc, argv);
+}