fix: resolve all 372 @typescript-eslint/no-unused-vars violations

- Prefix unused function parameters with _ (207 instances)
- Prefix unused caught errors with _ (53 instances)
- Remove unused imports (48 instances)
- Prefix unused variables with _ (51 instances)
- Prefix remaining imports with _ where removal wasn't safe (13 instances)
- Fix incorrectly renamed imports that were prefixed instead of removed

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/drivers/excel/src/index.ts

@@ -1,6 +1,6 @@
 import { Data } from '@objectstack/spec';
 import { z } from 'zod';
-type DriverInterface = z.infer<typeof Data.DriverInterface>;
+type _DriverInterface = z.infer<typeof Data.DriverInterface>;
 /**
  * ObjectQL
  * Copyright (c) 2026-present ObjectStack Inc.
@@ -258,7 +258,7 @@ export class ExcelDriver extends MemoryDriver {
                     await workbook.xlsx.readFile(filePath);
                     this.workbooks.set(objectName, workbook);
                     this.loadDataFromWorkbookForObject(workbook, objectName);
-                } catch (error) {
+                } catch (_error) {
                     // Error silently ignored
                 }
                 this.releaseLock(filePath);

packages/drivers/excel/test/index.test.ts

@@ -715,7 +715,7 @@ describe('ExcelDriver', () => {
             it('should execute bulkDelete command', async () => {
                 const user1 = await driver.create(TEST_OBJECT, { name: 'Alice' });
                 const user2 = await driver.create(TEST_OBJECT, { name: 'Bob' });
-                const user3 = await driver.create(TEST_OBJECT, { name: 'Charlie' });
+                const _user3 = await driver.create(TEST_OBJECT, { name: 'Charlie' });
 
                 const result = await driver.executeCommand({
                     type: 'bulkDelete',

packages/drivers/fs/src/index.ts

@@ -1,7 +1,6 @@
-import { Data, System as SystemSpec } from '@objectstack/spec';
+import { Data, System as _SystemSpec } from '@objectstack/spec';
 import { z } from 'zod';
-import { QueryAST, SortNode } from '@objectql/types';
-type DriverInterface = z.infer<typeof Data.DriverInterface>;
+type _DriverInterface = z.infer<typeof Data.DriverInterface>;
 /**
  * ObjectQL
  * Copyright (c) 2026-present ObjectStack Inc.
@@ -160,7 +159,7 @@ export class FileSystemDriver extends MemoryDriver {
                 return [];
             }
             return JSON.parse(content);
-        } catch (error) {
+        } catch (_error) {
             throw new ObjectQLError({
                 code: 'INVALID_JSON_FORMAT',
                 message: `Failed to parse ${filePath}: invalid JSON format`

packages/drivers/fs/test/index.test.ts

@@ -319,7 +319,7 @@ describe('FileSystemDriver', () => {
         });
 
         test('should handle _id field', async () => {
-            const result = await driver.create('docs', {
+            const _result = await driver.create('docs', {
                 _id: 'mongo-style-id',
                 title: 'Document'
             });
@@ -591,7 +591,7 @@ describe('FileSystemDriver', () => {
             test('should execute bulkDelete command', async () => {
                 const user1 = await driver.create('users', { name: 'Alice' });
                 const user2 = await driver.create('users', { name: 'Bob' });
-                const user3 = await driver.create('users', { name: 'Charlie' });
+                const _user3 = await driver.create('users', { name: 'Charlie' });
 
                 const result = await driver.executeCommand({
                     type: 'bulkDelete',

packages/drivers/memory/src/index.ts

@@ -1,7 +1,7 @@
-import { Data, System as SystemSpec } from '@objectstack/spec';
+import { Data, System as _SystemSpec } from '@objectstack/spec';
 import { z } from 'zod';
-import { QueryAST, SortNode } from '@objectql/types';
-type DriverInterface = z.infer<typeof Data.DriverInterface>;
+import { QueryAST } from '@objectql/types';
+type _DriverInterface = z.infer<typeof Data.DriverInterface>;
 /**
  * ObjectQL
  * Copyright (c) 2026-present ObjectStack Inc.
@@ -181,7 +181,7 @@ export class MemoryDriver implements Driver {
      * Find multiple records matching the query criteria.
      * Supports filtering, sorting, pagination, and field projection using Mingo.
      */
-    async find(objectName: string, query: any = {}, options?: any): Promise<any[]> {
+    async find(objectName: string, query: any = {}, _options?: any): Promise<any[]> {
         // Get all records for this object type
         const pattern = `${objectName}:`;
         let records: any[] = [];
@@ -245,7 +245,7 @@ export class MemoryDriver implements Driver {
     /**
      * Create a new record.
      */
-    async create(objectName: string, data: any, options?: any): Promise<any> {
+    async create(objectName: string, data: any, _options?: any): Promise<any> {
         // Generate ID if not provided
         const id = data.id || this.generateId(objectName);
         const key = `${objectName}:${id}`;
@@ -278,7 +278,7 @@ export class MemoryDriver implements Driver {
     /**
      * Update an existing record.
      */
-    async update(objectName: string, id: string | number, data: any, options?: any): Promise<any> {
+    async update(objectName: string, id: string | number, data: any, _options?: any): Promise<any> {
         const key = `${objectName}:${id}`;
         const existing = this.store.get(key);
 
@@ -312,7 +312,7 @@ export class MemoryDriver implements Driver {
     /**
      * Delete a record.
      */
-    async delete(objectName: string, id: string | number, options?: any): Promise<any> {
+    async delete(objectName: string, id: string | number, _options?: any): Promise<any> {
         const key = `${objectName}:${id}`;
         const deleted = this.store.delete(key);
 
@@ -335,7 +335,7 @@ export class MemoryDriver implements Driver {
     /**
      * Count records matching filters using Mingo.
      */
-    async count(objectName: string, filters: any, options?: any): Promise<number> {
+    async count(objectName: string, filters: any, _options?: any): Promise<number> {
         const pattern = `${objectName}:`;
 
         // Extract where condition from query object if needed
@@ -371,7 +371,7 @@ export class MemoryDriver implements Driver {
     /**
      * Get distinct values for a field using Mingo.
      */
-    async distinct(objectName: string, field: string, filters?: any, options?: any): Promise<any[]> {
+    async distinct(objectName: string, field: string, filters?: any, _options?: any): Promise<any[]> {
         const pattern = `${objectName}:`;
 
         // Get all records for this object type
@@ -418,7 +418,7 @@ export class MemoryDriver implements Driver {
     /**
      * Update multiple records matching filters using Mingo.
      */
-    async updateMany(objectName: string, filters: any, data: any, options?: any): Promise<any> {
+    async updateMany(objectName: string, filters: any, data: any, _options?: any): Promise<any> {
         const pattern = `${objectName}:`;
 
         // Get all records for this object type
@@ -464,7 +464,7 @@ export class MemoryDriver implements Driver {
     /**
      * Delete multiple records matching filters using Mingo.
      */
-    async deleteMany(objectName: string, filters: any, options?: any): Promise<any> {
+    async deleteMany(objectName: string, filters: any, _options?: any): Promise<any> {
         const pattern = `${objectName}:`;
 
         // Get all records for this object type
@@ -550,7 +550,7 @@ export class MemoryDriver implements Driver {
      *   { $group: { _id: null, avgPrice: { $avg: '$price' } } }
      * ]);
      */
-    async aggregate(objectName: string, pipeline: any[], options?: any): Promise<any[]> {
+    async aggregate(objectName: string, pipeline: any[], _options?: any): Promise<any[]> {
         const pattern = `${objectName}:`;
 
         // Get all records for this object type
@@ -675,7 +675,7 @@ export class MemoryDriver implements Driver {
                     }
                 }
             }
-        } catch (error) {
+        } catch (_error) {
             // Error silently ignored
         }
 
@@ -703,7 +703,7 @@ export class MemoryDriver implements Driver {
             };
 
             fs.writeFileSync(this.config.persistence.filePath, JSON.stringify(data, null, 2), 'utf8');
-        } catch (error) {
+        } catch (_error) {
             // Error silently ignored
         }
     }
@@ -839,7 +839,7 @@ export class MemoryDriver implements Driver {
         }
 
         // Process the filter array to build MongoDB query
-        const conditions: Record<string, any>[] = [];
+        const _conditions: Record<string, any>[] = [];
         let currentLogic: 'and' | 'or' = 'and';
         const logicGroups: { logic: 'and' | 'or', conditions: Record<string, any>[] }[] = [
             { logic: 'and', conditions: [] }
@@ -1183,7 +1183,7 @@ export class MemoryDriver implements Driver {
      * @param parameters - Command parameters
      * @param options - Execution options
      */
-    async execute(command: any, parameters?: any[], options?: any): Promise<any> {
+    async execute(_command: any, _parameters?: any[], _options?: any): Promise<any> {
         // For memory driver, this is primarily for compatibility
         // We don't support raw SQL/commands
         throw new ObjectQLError({ code: 'DRIVER_UNSUPPORTED_OPERATION', message: 'Memory driver does not support raw command execution. Use executeCommand() instead.' });

packages/drivers/memory/test/index.test.ts

@@ -484,7 +484,7 @@ describe('MemoryDriver', () => {
                 if (fs.existsSync(testFilePath)) {
                     fs.unlinkSync(testFilePath);
                 }
-            } catch (e) {
+            } catch (_e) {
                 // Ignore errors
             }
         });

packages/drivers/mongo/src/index.ts

@@ -1,7 +1,7 @@
-import { Data, System as SystemSpec } from '@objectstack/spec';
+import { Data, System as _SystemSpec } from '@objectstack/spec';
 import { z } from 'zod';
-import { QueryAST, SortNode } from '@objectql/types';
-type DriverInterface = z.infer<typeof Data.DriverInterface>;
+import { QueryAST } from '@objectql/types';
+type _DriverInterface = z.infer<typeof Data.DriverInterface>;
 /**
  * ObjectQL
  * Copyright (c) 2026-present ObjectStack Inc.
@@ -119,7 +119,7 @@ export class MongoDriver implements Driver {
             if (!this.db) return false;
             await this.db.admin().ping();
             return true;
-        } catch (error) {
+        } catch (_error) {
             return false;
         }
     }
@@ -336,7 +336,7 @@ export class MongoDriver implements Driver {
      * QueryAST sort is array of {field, order}, while UnifiedQuery is array of [field, order].
      * QueryAST uses 'aggregations', while legacy uses 'aggregate'.
      */
-    async find(objectName: string, query: any, options?: any): Promise<any[]> {
+    async find(objectName: string, query: any, _options?: any): Promise<any[]> {
         const collection = await this.getCollection(objectName);
 
         // Handle both new format (where) and legacy format (filters)
@@ -486,7 +486,7 @@ export class MongoDriver implements Driver {
         return result.deletedCount;
     }
 
-    async count(objectName: string, filters: any, options?: any): Promise<number> {
+    async count(objectName: string, filters: any, _options?: any): Promise<number> {
         const collection = await this.getCollection(objectName);
         // Handle both filter objects and query objects
         let actualFilters = filters;
@@ -524,7 +524,7 @@ export class MongoDriver implements Driver {
         const filter = this.mapFilters(filters);
 
         // Remove 'id' field from update data as it shouldn't be updated
-        const { id: idToIgnore, ...updateData } = data;
+        const { id: _idToIgnore, ...updateData } = data;
 
         const isAtomic = Object.keys(updateData).some(k => k.startsWith('$'));
         const update = isAtomic ? updateData : { $set: updateData };
@@ -548,7 +548,7 @@ export class MongoDriver implements Driver {
         return { deletedCount: result.deletedCount };
     }
 
-    async aggregate(objectName: string, pipeline: any[], options?: any): Promise<any[]> {
+    async aggregate(objectName: string, pipeline: any[], _options?: any): Promise<any[]> {
         const collection = await this.getCollection(objectName);
         const results = await collection.aggregate(pipeline).toArray();
         // Map MongoDB documents to API format (convert _id to id)
@@ -563,7 +563,7 @@ export class MongoDriver implements Driver {
      * @param options - Optional query options
      * @returns Array of distinct values
      */
-    async distinct(objectName: string, field: string, filters?: any, options?: any): Promise<any[]> {
+    async distinct(objectName: string, field: string, filters?: any, _options?: any): Promise<any[]> {
         const collection = await this.getCollection(objectName);
 
         // Convert ObjectQL filters to MongoDB query format
@@ -689,7 +689,7 @@ export class MongoDriver implements Driver {
 
     async disconnect() {
         // Close all active change streams
-        for (const [streamId, stream] of this.changeStreams.entries()) {
+        for (const [_streamId, stream] of this.changeStreams.entries()) {
             await stream.close();
         }
         this.changeStreams.clear();
@@ -755,7 +755,7 @@ export class MongoDriver implements Driver {
         changeStream.on('change', async (change) => {
             try {
                 await handler(change);
-            } catch (error) {
+            } catch (_error) {
                 // Error silently ignored
             }
         });

packages/drivers/mongo/test/index.test.ts

@@ -7,7 +7,6 @@
  */
 
 import { MongoDriver } from '../src';
-import { MongoClient } from 'mongodb';
 import { vi } from 'vitest';
 
 const mockCollection = {

packages/drivers/mongo/test/integration.test.ts

@@ -89,7 +89,7 @@ describe('MongoDriver Integration Tests', () => {
             // Driver doesn't have dropDatabase.
             // Use the client we created in beforeAll
             await client.db(dbName).dropDatabase();
-        } catch (e) {
+        } catch (_e) {
             // Ignore cleanup errors
         }
     });

packages/drivers/mongo/test/queryast.test.ts

@@ -7,7 +7,6 @@
  */
 
 import { MongoDriver } from '../src';
-import { MongoClient } from 'mongodb';
 import { vi } from 'vitest';
 
 // Mock data
@@ -289,7 +288,7 @@ describe('MongoDriver (QueryAST Format)', () => {
                 filters: [['id', '=', '1']],
                 fields: ['id', 'name']
             };
-            const results = await driver.find('products', query);
+            const _results = await driver.find('products', query);
 
             expect(mockCollection.find).toHaveBeenCalledWith(
                 { _id: '1' },