feat: Add TCK compliance tests to all drivers

Copilot · hotlong · Copilot · commit 4c942a368a62 · 2026-02-02T00:43:58.000Z
- Added TCK test files for Memory driver (reference implementation)
- Added TCK test files for SQL driver (with SQLite in-memory)
- Added TCK test files for MongoDB driver (with MongoMemoryReplSet)
- Added TCK test files for Redis driver
- Added TCK test files for Excel driver
- Added TCK test files for FileSystem driver
- Added TCK test files for LocalStorage driver (with mock)
- Memory driver passes all 36 TCK tests

Co-authored-by: hotlong &lt;50353452+hotlong@users.noreply.github.com&gt;
diff --git a/packages/drivers/excel/test/tck.test.ts b/packages/drivers/excel/test/tck.test.ts
@@ -0,0 +1,59 @@
+/**
+ * ObjectQL Excel Driver TCK Tests
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Excel Driver TCK (Technology Compatibility Kit) Tests
+ * 
+ * This test suite verifies that the Excel driver passes all TCK requirements.
+ */
+
+import { runDriverTCK } from '@objectql/driver-tck';
+import { ExcelDriver } from '../src';
+import * as fs from 'fs';
+import * as path from 'path';
+
+describe('ExcelDriver TCK Compliance', () => {
+    const testFilePath = path.join(__dirname, 'tck-test.xlsx');
+    let driver: ExcelDriver;
+    
+    afterEach(() => {
+        // Clean up test file
+        if (fs.existsSync(testFilePath)) {
+            fs.unlinkSync(testFilePath);
+        }
+    });
+    
+    runDriverTCK(
+        () => {
+            driver = new ExcelDriver({
+                filePath: testFilePath,
+                autoSave: true
+            });
+            return driver;
+        },
+        {
+            skip: {
+                aggregations: true,  // Excel driver doesn't support aggregations
+                transactions: true,  // Excel doesn't support transactions
+                joins: true,         // Excel doesn't support joins
+            },
+            timeout: 30000,
+            hooks: {
+                beforeEach: async () => {
+                    // Create fresh Excel file
+                    if (fs.existsSync(testFilePath)) {
+                        fs.unlinkSync(testFilePath);
+                    }
+                },
+                afterEach: async () => {
+                    // Cleanup handled in test afterEach
+                }
+            }
+        }
+    );
+});
diff --git a/packages/drivers/fs/test/tck.test.ts b/packages/drivers/fs/test/tck.test.ts
@@ -0,0 +1,60 @@
+/**
+ * ObjectQL FileSystem Driver TCK Tests
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * FileSystem Driver TCK (Technology Compatibility Kit) Tests
+ * 
+ * This test suite verifies that the FS driver passes all TCK requirements.
+ */
+
+import { runDriverTCK } from '@objectql/driver-tck';
+import { FileSystemDriver } from '../src';
+import * as fs from 'fs';
+import * as path from 'path';
+
+describe('FileSystemDriver TCK Compliance', () => {
+    const testDir = path.join(__dirname, 'tck-test-data');
+    let driver: FileSystemDriver;
+    
+    afterEach(() => {
+        // Clean up test directory
+        if (fs.existsSync(testDir)) {
+            fs.rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    
+    runDriverTCK(
+        () => {
+            driver = new FileSystemDriver({
+                rootPath: testDir,
+                format: 'json'
+            });
+            return driver;
+        },
+        {
+            skip: {
+                aggregations: true,  // FS driver doesn't support aggregations
+                transactions: true,  // FS doesn't support transactions
+                joins: true,         // FS doesn't support joins
+            },
+            timeout: 30000,
+            hooks: {
+                beforeEach: async () => {
+                    // Create fresh directory
+                    if (fs.existsSync(testDir)) {
+                        fs.rmSync(testDir, { recursive: true, force: true });
+                    }
+                    fs.mkdirSync(testDir, { recursive: true });
+                },
+                afterEach: async () => {
+                    // Cleanup handled in test afterEach
+                }
+            }
+        }
+    );
+});
diff --git a/packages/drivers/localstorage/test/tck.test.ts b/packages/drivers/localstorage/test/tck.test.ts
@@ -0,0 +1,82 @@
+/**
+ * ObjectQL LocalStorage Driver TCK Tests
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * LocalStorage Driver TCK (Technology Compatibility Kit) Tests
+ * 
+ * This test suite verifies that the LocalStorage driver passes all TCK requirements.
+ */
+
+import { runDriverTCK } from '@objectql/driver-tck';
+import { LocalStorageDriver } from '../src';
+
+// Mock localStorage for Node.js environment
+class LocalStorageMock {
+    private store: Map<string, string> = new Map();
+    
+    getItem(key: string): string | null {
+        return this.store.get(key) || null;
+    }
+    
+    setItem(key: string, value: string): void {
+        this.store.set(key, value);
+    }
+    
+    removeItem(key: string): void {
+        this.store.delete(key);
+    }
+    
+    clear(): void {
+        this.store.clear();
+    }
+    
+    get length(): number {
+        return this.store.size;
+    }
+    
+    key(index: number): string | null {
+        const keys = Array.from(this.store.keys());
+        return keys[index] || null;
+    }
+}
+
+describe('LocalStorageDriver TCK Compliance', () => {
+    let driver: LocalStorageDriver;
+    let mockStorage: LocalStorageMock;
+    
+    runDriverTCK(
+        () => {
+            mockStorage = new LocalStorageMock();
+            (global as any).localStorage = mockStorage;
+            
+            driver = new LocalStorageDriver({
+                namespace: 'tck_test'
+            });
+            return driver;
+        },
+        {
+            skip: {
+                aggregations: true,  // LocalStorage driver doesn't support aggregations
+                transactions: true,  // LocalStorage doesn't support transactions
+                joins: true,         // LocalStorage doesn't support joins
+            },
+            timeout: 30000,
+            hooks: {
+                beforeEach: async () => {
+                    // Clear localStorage
+                    if (mockStorage) {
+                        mockStorage.clear();
+                    }
+                },
+                afterEach: async () => {
+                    // Cleanup handled in beforeEach
+                }
+            }
+        }
+    );
+});
diff --git a/packages/drivers/memory/test/tck.test.ts b/packages/drivers/memory/test/tck.test.ts
@@ -0,0 +1,38 @@
+/**
+ * ObjectQL Memory Driver TCK Tests
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Memory Driver TCK (Technology Compatibility Kit) Tests
+ * 
+ * This test suite verifies that the Memory driver passes all TCK requirements.
+ * The Memory driver serves as the reference implementation for all ObjectQL drivers.
+ */
+
+import { runDriverTCK } from '@objectql/driver-tck';
+import { MemoryDriver } from '../src';
+
+describe('MemoryDriver TCK Compliance', () => {
+    runDriverTCK(
+        () => new MemoryDriver(),
+        {
+            // Memory driver supports all features
+            skip: {
+                // No features to skip - Memory driver is the reference implementation
+            },
+            timeout: 30000,
+            hooks: {
+                beforeEach: async () => {
+                    // No special setup needed
+                },
+                afterEach: async () => {
+                    // Cleanup handled by driver.clear() in TCK
+                }
+            }
+        }
+    );
+});
diff --git a/packages/drivers/mongo/test/tck.test.ts b/packages/drivers/mongo/test/tck.test.ts
@@ -0,0 +1,70 @@
+/**
+ * ObjectQL MongoDB Driver TCK Tests
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * MongoDB Driver TCK (Technology Compatibility Kit) Tests
+ * 
+ * This test suite verifies that the MongoDB driver passes all TCK requirements.
+ */
+
+import { runDriverTCK } from '@objectql/driver-tck';
+import { MongoDriver } from '../src';
+import { MongoMemoryReplSet } from 'mongodb-memory-server';
+
+describe('MongoDriver TCK Compliance', () => {
+    let mongoServer: MongoMemoryReplSet;
+    let driver: MongoDriver;
+    
+    beforeAll(async () => {
+        // Start MongoDB Memory Server with replica set (required for transactions)
+        mongoServer = await MongoMemoryReplSet.create({
+            replSet: { count: 1, storageEngine: 'wiredTiger' }
+        });
+    }, 120000);
+    
+    afterAll(async () => {
+        if (driver) {
+            await driver.disconnect();
+        }
+        if (mongoServer) {
+            await mongoServer.stop();
+        }
+    }, 60000);
+    
+    runDriverTCK(
+        () => {
+            const uri = mongoServer.getUri();
+            driver = new MongoDriver({
+                url: uri,
+                dbName: 'tck_test'
+            });
+            return driver;
+        },
+        {
+            // MongoDB supports all features
+            skip: {
+                // No features to skip
+            },
+            timeout: 30000,
+            hooks: {
+                beforeEach: async () => {
+                    // Clear all collections
+                    if (driver && driver['db']) {
+                        const collections = await driver['db'].listCollections().toArray();
+                        for (const collection of collections) {
+                            await driver['db'].collection(collection.name).deleteMany({});
+                        }
+                    }
+                },
+                afterEach: async () => {
+                    // Cleanup handled in beforeEach
+                }
+            }
+        }
+    );
+});
diff --git a/packages/drivers/redis/test/tck.test.ts b/packages/drivers/redis/test/tck.test.ts
@@ -0,0 +1,49 @@
+/**
+ * ObjectQL Redis Driver TCK Tests
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Redis Driver TCK (Technology Compatibility Kit) Tests
+ * 
+ * This test suite verifies that the Redis driver passes all TCK requirements.
+ */
+
+import { runDriverTCK } from '@objectql/driver-tck';
+import { RedisDriver } from '../src';
+
+describe('RedisDriver TCK Compliance', () => {
+    let driver: RedisDriver;
+    
+    runDriverTCK(
+        () => {
+            driver = new RedisDriver({
+                host: process.env.REDIS_HOST || 'localhost',
+                port: parseInt(process.env.REDIS_PORT || '6379'),
+                db: 15 // Use a separate DB for testing
+            });
+            return driver;
+        },
+        {
+            skip: {
+                aggregations: true,  // Redis driver doesn't support full aggregations
+                joins: true,         // Redis doesn't support joins
+            },
+            timeout: 30000,
+            hooks: {
+                beforeEach: async () => {
+                    // Clear the test database
+                    if (driver && driver['redis']) {
+                        await driver['redis'].flushdb();
+                    }
+                },
+                afterEach: async () => {
+                    // Cleanup handled in beforeEach
+                }
+            }
+        }
+    );
+});
diff --git a/packages/drivers/sql/test/tck.test.ts b/packages/drivers/sql/test/tck.test.ts
