@aetherframework/database 1.1.0 → 1.1.2

package/examples/test-direct.js

@@ -0,0 +1,116 @@
+// test-direct.js
+import DatabaseManager from "../src/DatabaseManager.js";
+
+const config = {
+  default: "primary",
+  connections: {
+    primary: {
+      type: "mysql",
+      enabled: true,
+      host: "127.0.0.1",
+      port: 3306,
+      user: "root",
+      password: "123456",
+      database: "test_db",
+      connectionLimit: 10,
+    },
+  },
+};
+
+console.log("🚀 Aether QueryBuilder 最终功能验证测试\n");
+
+const db = new DatabaseManager(config);
+
+async function runTest() {
+  try {
+    await db.init();
+    console.log("✅ DatabaseManager 初始化成功\n");
+
+    // 准备测试环境
+    await db.execute("DROP TABLE IF EXISTS users");
+    await db.execute(`
+      CREATE TABLE users (
+        id INT AUTO_INCREMENT PRIMARY KEY,
+        name VARCHAR(255) NOT NULL,
+        email VARCHAR(255) UNIQUE,
+        age INT,
+        status BOOLEAN DEFAULT true,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
+    `);
+    console.log("✅ 测试表已重建\n");
+
+    // ==================== 业务测试 ====================
+    console.log("📝 1. 插入测试数据");
+    await db
+      .table("users")
+      .insert({
+        name: "张三",
+        email: "zhangsan@example.com",
+        age: 25,
+      })
+      .execute();
+
+    await db
+      .table("users")
+      .insert({
+        name: "李四",
+        email: "lisi@example.com",
+        age: 28,
+      })
+      .execute();
+
+    console.log("🔍 2. 查询所有用户");
+    const users = await db.table("users").select("*").execute();
+    console.table(users);
+
+    console.log("\n📊 3. 条件查询 + 排序");
+    const youngUsers = await db
+      .table("users")
+      .select("id", "name", "age")
+      .where("age", ">", 20)
+      .orderBy("age", "DESC")
+      .execute();
+    console.table(youngUsers);
+
+    console.log("\n✏️  4. 更新数据");
+    await db
+      .table("users")
+      .where("name", "张三")
+      .update({ age: 30, status: false })
+      .execute();
+
+    console.log("\n🗑️  5. 删除数据");
+    await db.table("users").where("name", "李四").delete().execute();
+
+    console.log("\n📦 6. 批量插入");
+    await db
+      .table("users")
+      .insert([
+        { name: "王五", email: "wangwu@example.com", age: 32 },
+        { name: "赵六", email: "zhaoliu@example.com", age: 29 },
+        { name: "孙七", email: "sunqi@example.com", age: 35 },
+      ])
+      .execute();
+
+    console.log("\n🎯 7. 复杂查询测试");
+    const result = await db
+      .table("users")
+      .select("id", "name", "age")
+      .where("age", ">=", 30)
+      .orderBy("age", "DESC")
+      .execute();
+    console.table(result);
+
+    console.log("\n✅ 所有测试全部通过！");
+    console.log("🎉 QueryBuilder 已达到生产可用标准");
+  } catch (error) {
+    console.error("\n❌ 测试失败:", error.message);
+    console.error(error);
+  } finally {
+    await db.close();
+    console.log("\n🔌 数据库连接已安全关闭");
+  }
+}
+
+runTest();

package/examples/transaction_example.js

@@ -0,0 +1,127 @@
+// packages/database/examples/transaction_example.js
+import DatabaseManager from '../src/DatabaseManager.js';
+
+async function transactionExample() {
+  console.log("🚀 Starting transaction examples...\n");
+
+  try {
+    // Single database configuration with retry settings
+    const singleDbConfig = {
+      enabled: true,
+      default: "primary",
+      connections: {
+        primary: {
+          type: "mysql",
+          host: "127.0.0.1",
+          port: 3306,
+          user: "root",
+          password: "123456",
+          database: "transaction_db",
+          enabled: true,
+          retry: {
+            maxAttempts: 3,
+            delay: 1000,
+            backoff: true
+          },
+          pool: {
+            min: 0,
+            max: 10
+          }
+        },
+      },
+    };
+
+    // 在函数作用域内定义变量
+    let singleDb = null;
+    let multiDb = null;
+    let orderId = null;
+
+    try {
+      // EXAMPLE 1: Basic transaction (single database)
+      console.log("💳 Example 1: Basic transaction (single database)");
+      singleDb = new DatabaseManager(singleDbConfig);
+      await singleDb.init();
+
+      // 执行简单事务
+      const singleResult = await singleDb.transaction(async (trx) => {
+        // 创建测试表 - 使用原始查询而不是预处理语句
+        await trx.query(`
+          CREATE TABLE IF NOT EXISTS test_transactions (
+            id INT AUTO_INCREMENT PRIMARY KEY,
+            name VARCHAR(100) NOT NULL,
+            amount DECIMAL(10,2) NOT NULL,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+
+        // 插入数据 - 使用预处理语句
+        const insertResult = await trx.query(
+          "INSERT INTO test_transactions (name, amount) VALUES (?, ?)",
+          ["Test Transaction", 100.50]
+        );
+
+        console.log(`✅ Inserted record with ID: ${insertResult.insertId}`);
+
+        // 查询数据 - 使用预处理语句
+        const selectResult = await trx.query(
+          "SELECT * FROM test_transactions WHERE id = ?",
+          [insertResult.insertId]
+        );
+
+        console.log(`✅ Retrieved record:`, selectResult);
+
+        // 更新数据 - 使用预处理语句
+        await trx.query(
+          "UPDATE test_transactions SET amount = ? WHERE id = ?",
+          [200.75, insertResult.insertId]
+        );
+
+        console.log(`✅ Updated record ${insertResult.insertId}`);
+
+        return {
+          success: true,
+          insertedId: insertResult.insertId,
+          message: "Single database transaction completed successfully"
+        };
+      });
+
+      console.log(`🎉 Single database transaction result:`, singleResult);
+
+      // 清理测试表
+      await singleDb.query("DROP TABLE IF EXISTS test_transactions");
+      console.log("🧹 Cleaned up test table");
+
+      return {
+        success: true,
+        message: "Transaction examples completed successfully"
+      };
+
+    } catch (error) {
+      console.error("❌ Transaction example failed:", error.message);
+      console.error("Error stack:", error.stack);
+
+      // 清理代码
+      if (singleDb) {
+        try {
+          console.log("🔄 Starting cleanup after transaction failure...");
+          await singleDb.query("DROP TABLE IF EXISTS test_transactions");
+          console.log("✅ Cleanup completed");
+        } catch (cleanupError) {
+          console.error("⚠️ Cleanup failed:", cleanupError.message);
+        }
+      }
+
+      return {
+        success: false,
+        error: error.message,
+        timestamp: new Date().toISOString()
+      };
+    }
+
+  } catch (error) {
+    console.error("❌ Transaction example failed:", error.message);
+    throw error;
+  }
+}
+
+export default transactionExample;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aetherframework/database",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Zero-dependency, multi-database integration for AetherJS API framework with advanced query builder and connection pooling",
   "main": "index.js",
   "type": "module", 
@@ -48,6 +48,8 @@
     "connection-pool.js",
     "query-builder.js",
     "drivers/",
+    "src",
+    "examples",
     "types.js",
     "README.md",
     "LICENSE"