feat: metona-sqlark v0.1.12 — 前端TypeScript关系型数据库

- 4种存储引擎：Memory / IndexedDB / OPFS / Hybrid - 完整SQL支持：SELECT/INSERT/UPDATE/DELETE/JOIN/GROUP BY/HAVING/DISTINCT - Query Builder链式API + TypeScript泛型支持 - 聚合函数：COUNT/SUM/AVG/MIN/MAX - 事务、插件系统(14 hooks)、发布订阅、数据迁移、导入导出 - React/Vue框架集成 - 264个测试用例，93.46%覆盖率 - 零运行时依赖
2026-07-26 15:00:01 +08:00
commit e2a590c5b1
60 changed files with 16359 additions and 0 deletions
@@ -0,0 +1,118 @@
+/**
+ * GROUP BY + 聚合函数测试 (v0.1.2)
+ */
+
+import { MetonaSqlark } from '../src/core';
+import { parse } from '../src/sql/parser';
+
+describe('GROUP BY (v0.1.2)', () => {
+  let db: MetonaSqlark;
+
+  beforeEach(async () => {
+    db = new MetonaSqlark({ name: 'test-groupby', mode: 'memory' });
+    await db.init();
+
+    await db.defineTable('employees', {
+      id: { type: 'string', primaryKey: true },
+      name: { type: 'string', required: true },
+      dept: { type: 'string' },
+      salary: { type: 'number' },
+    });
+
+    await db.table('employees').insertMany([
+      { id: '1', name: 'Alice', dept: 'Eng', salary: 1000 },
+      { id: '2', name: 'Bob', dept: 'Eng', salary: 1200 },
+      { id: '3', name: 'Charlie', dept: 'Sales', salary: 900 },
+      { id: '4', name: 'Diana', dept: 'Sales', salary: 1100 },
+      { id: '5', name: 'Eve', dept: 'HR', salary: 800 },
+    ]);
+  });
+
+  afterEach(async () => {
+    await db.close();
+  });
+
+  // ===================================================================
+  //  SQL GROUP BY
+  // ===================================================================
+
+  describe('SQL GROUP BY', () => {
+    it('GROUP BY + COUNT', async () => {
+      const result = await db.query(
+        'SELECT dept, COUNT(*) FROM employees GROUP BY dept',
+      ) as Record<string, unknown>[];
+      expect(result).toHaveLength(3);
+      const eng = result.find((r: any) => r.dept === 'Eng');
+      expect(eng!['COUNT(*)']).toBe(2);
+    });
+
+    it('GROUP BY + SUM', async () => {
+      const result = await db.query(
+        'SELECT dept, SUM(salary) FROM employees GROUP BY dept',
+      ) as Record<string, unknown>[];
+      const eng = result.find((r: any) => r.dept === 'Eng');
+      expect(eng!['SUM(salary)']).toBe(2200);
+    });
+
+    it('GROUP BY + AVG', async () => {
+      const result = await db.query(
+        'SELECT dept, AVG(salary) FROM employees GROUP BY dept',
+      ) as Record<string, unknown>[];
+      const eng = result.find((r: any) => r.dept === 'Eng');
+      expect(eng!['AVG(salary)']).toBe(1100);
+    });
+
+    it('GROUP BY + MIN/MAX', async () => {
+      const result = await db.query(
+        'SELECT dept, MIN(salary), MAX(salary) FROM employees GROUP BY dept',
+      ) as Record<string, unknown>[];
+      const eng = result.find((r: any) => r.dept === 'Eng');
+      expect(eng!['MIN(salary)']).toBe(1000);
+      expect(eng!['MAX(salary)']).toBe(1200);
+    });
+
+    it('GROUP BY + HAVING', async () => {
+      const result = await db.query(
+        'SELECT dept, COUNT(*) FROM employees GROUP BY dept HAVING COUNT(*) > 1',
+      ) as Record<string, unknown>[];
+      expect(result).toHaveLength(2); // Eng(2) + Sales(2)
+    });
+
+    it('GROUP BY + WHERE + HAVING', async () => {
+      const result = await db.query(
+        "SELECT dept, SUM(salary) FROM employees WHERE dept != 'HR' GROUP BY dept HAVING SUM(salary) > 2000",
+      ) as Record<string, unknown>[];
+      expect(result).toHaveLength(1); // Only Eng
+    });
+
+    it('聚合函数别名', async () => {
+      const result = await db.query(
+        'SELECT dept, COUNT(*) AS cnt, SUM(salary) AS total FROM employees GROUP BY dept',
+      ) as Record<string, unknown>[];
+      const eng = result.find((r: any) => r.dept === 'Eng');
+      expect(eng!.cnt).toBe(2);
+      expect(eng!.total).toBe(2200);
+    });
+  });
+
+  // ===================================================================
+  //  Parser 测试
+  // ===================================================================
+
+  describe('Parser', () => {
+    it('解析 COUNT(*)', () => {
+      const ast = parse('SELECT COUNT(*) FROM employees');
+      expect(ast.columns[0]).toBe('COUNT(*)');
+    });
+
+    it('解析 GROUP BY', () => {
+      const ast = parse('SELECT dept, COUNT(*) FROM employees GROUP BY dept');
+      expect(ast.groupBy).toEqual(['dept']);
+    });
+
+    it('解析 HAVING', () => {
+      const ast = parse('SELECT dept, COUNT(*) FROM employees GROUP BY dept HAVING COUNT(*) > 1');
+      expect(ast.having).toBeDefined();
+    });
+  });
+});