sqlew 3.6.9 → 3.7.0

package/dist/tests/utils/test-helpers.js

@@ -0,0 +1,407 @@
+/**
+ * Shared Test Utilities for Cross-Database Migration Tests
+ *
+ * DRY principle: All common test setup, assertions, and helpers in one place.
+ * Used by all 5 test suites to avoid code duplication.
+ */
+import knex from 'knex';
+import assert from 'node:assert';
+import { join } from 'node:path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Migration directories - resolve based on whether we're in dist/ or src/
+// When running tests, we're in dist/tests/utils/, so ../../config/knex/ is wrong
+// We need to go to the project root first
+const projectRoot = join(__dirname, '../../../'); // dist/tests/utils/ -> project root
+const migrationDirs = [
+    join(projectRoot, 'dist/config/knex/bootstrap'),
+    join(projectRoot, 'dist/config/knex/upgrades'),
+    join(projectRoot, 'dist/config/knex/enhancements'),
+];
+/**
+ * Get database configuration by type
+ */
+export function getDbConfig(type, customPath) {
+    switch (type) {
+        case 'sqlite':
+            return {
+                type: 'sqlite',
+                knexConfig: {
+                    client: 'better-sqlite3',
+                    connection: { filename: customPath || ':memory:' },
+                    useNullAsDefault: true,
+                    migrations: {
+                        directory: migrationDirs,
+                        extension: 'js',
+                        tableName: 'knex_migrations',
+                        loadExtensions: ['.js'],
+                    },
+                },
+            };
+        case 'mysql':
+            return {
+                type: 'mysql',
+                containerName: 'mcp-sqlew-mysql-test',
+                knexConfig: {
+                    client: 'mysql2',
+                    connection: {
+                        host: 'localhost',
+                        port: 3307,
+                        user: 'mcp_user',
+                        password: 'mcp_pass',
+                        database: 'mcp_test',
+                    },
+                },
+            };
+        case 'mariadb':
+            return {
+                type: 'mariadb',
+                containerName: 'mcp-sqlew-mariadb-test',
+                knexConfig: {
+                    client: 'mysql2',
+                    connection: {
+                        host: 'localhost',
+                        port: 3308,
+                        user: 'mcp_user',
+                        password: 'mcp_pass',
+                        database: 'mcp_test',
+                    },
+                },
+            };
+        case 'postgresql':
+            return {
+                type: 'postgresql',
+                containerName: 'mcp-sqlew-postgres-test',
+                knexConfig: {
+                    client: 'pg',
+                    connection: {
+                        host: 'localhost',
+                        port: 5432,
+                        user: 'mcp_user',
+                        password: 'mcp_pass',
+                        database: 'mcp_test',
+                    },
+                },
+            };
+    }
+}
+// ============================================================================
+// Database Connection Helpers (DRY)
+// ============================================================================
+/**
+ * Create and verify database connection
+ */
+export async function connectDb(config) {
+    const db = knex(config.knexConfig);
+    try {
+        await db.raw('SELECT 1');
+        return db;
+    }
+    catch (error) {
+        throw new Error(`Failed to connect to ${config.type}: ${error.message}`);
+    }
+}
+/**
+ * Close database connection safely
+ */
+export async function disconnectDb(db) {
+    try {
+        await db.destroy();
+    }
+    catch (error) {
+        // Ignore disconnect errors
+    }
+}
+/**
+ * Drop all tables and views from database
+ */
+export async function dropAllTables(db, type) {
+    if (type === 'sqlite') {
+        // SQLite: Get all tables and views, then drop them
+        const objects = await db.raw(`
+      SELECT name, type FROM sqlite_master
+      WHERE type IN ('table', 'view') AND name NOT LIKE 'sqlite_%'
+    `);
+        await db.raw('PRAGMA foreign_keys = OFF');
+        for (const row of objects) {
+            if (row.type === 'view') {
+                await db.raw(`DROP VIEW IF EXISTS "${row.name}"`);
+            }
+            else {
+                await db.raw(`DROP TABLE IF EXISTS "${row.name}"`);
+            }
+        }
+        await db.raw('PRAGMA foreign_keys = ON');
+    }
+    else if (type === 'mysql' || type === 'mariadb') {
+        // MySQL/MariaDB: Drop all views first, then tables
+        await db.raw('SET FOREIGN_KEY_CHECKS=0');
+        // Drop views
+        const views = await db.raw(`
+      SELECT TABLE_NAME
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = 'mcp_test' AND TABLE_TYPE = 'VIEW'
+    `);
+        for (const row of views[0]) {
+            await db.raw(`DROP VIEW IF EXISTS ??`, [row.TABLE_NAME]);
+        }
+        // Drop tables
+        const tables = await db.raw(`
+      SELECT TABLE_NAME
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = 'mcp_test' AND TABLE_TYPE = 'BASE TABLE'
+    `);
+        for (const row of tables[0]) {
+            await db.raw(`DROP TABLE IF EXISTS ??`, [row.TABLE_NAME]);
+        }
+        await db.raw('SET FOREIGN_KEY_CHECKS=1');
+    }
+    else if (type === 'postgresql') {
+        // PostgreSQL: Drop and recreate schema (drops both tables and views)
+        await db.raw('DROP SCHEMA IF EXISTS public CASCADE');
+        await db.raw('CREATE SCHEMA public');
+    }
+}
+/**
+ * Get list of tables in database
+ */
+export async function getTables(db, type) {
+    if (type === 'sqlite') {
+        const result = await db.raw(`
+      SELECT name FROM sqlite_master
+      WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name != 'knex_migrations'
+      ORDER BY name
+    `);
+        return result.map((r) => r.name);
+    }
+    else if (type === 'mysql' || type === 'mariadb') {
+        const result = await db.raw(`
+      SELECT TABLE_NAME
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = 'mcp_test'
+        AND TABLE_TYPE = 'BASE TABLE'
+        AND TABLE_NAME != 'knex_migrations'
+      ORDER BY TABLE_NAME
+    `);
+        return result[0].map((r) => r.TABLE_NAME);
+    }
+    else if (type === 'postgresql') {
+        const result = await db.raw(`
+      SELECT tablename
+      FROM pg_tables
+      WHERE schemaname = 'public' AND tablename != 'knex_migrations'
+      ORDER BY tablename
+    `);
+        return result.rows.map((r) => r.tablename);
+    }
+    return [];
+}
+/**
+ * Get table information (columns, rows)
+ */
+export async function getTableInfo(db, tableName) {
+    const columnInfo = await db(tableName).columnInfo();
+    const rowCount = await db(tableName).count('* as count').first();
+    return {
+        name: tableName,
+        columnCount: Object.keys(columnInfo).length,
+        rowCount: Number(rowCount?.count || 0),
+    };
+}
+/**
+ * Assert table counts match between two databases
+ */
+export async function assertTableCountsMatch(sourceDb, sourceType, targetDb, targetType, message) {
+    const sourceTables = await getTables(sourceDb, sourceType);
+    const targetTables = await getTables(targetDb, targetType);
+    assert.strictEqual(targetTables.length, sourceTables.length, message || `Table count mismatch: ${sourceType} has ${sourceTables.length}, ${targetType} has ${targetTables.length}`);
+}
+/**
+ * Assert row counts match for a specific table
+ */
+export async function assertRowCountsMatch(sourceDb, targetDb, tableName, message) {
+    const sourceCount = await sourceDb(tableName).count('* as count').first();
+    const targetCount = await targetDb(tableName).count('* as count').first();
+    assert.strictEqual(Number(targetCount?.count || 0), Number(sourceCount?.count || 0), message || `Row count mismatch in ${tableName}`);
+}
+/**
+ * Get foreign key constraints from database
+ */
+export async function getFKConstraints(db, type, tableName) {
+    const constraints = [];
+    if (type === 'sqlite') {
+        const result = await db.raw(`PRAGMA foreign_key_list(${tableName})`);
+        for (const fk of result) {
+            constraints.push({
+                tableName,
+                columnName: fk.from,
+                referencedTable: fk.table,
+                referencedColumn: fk.to,
+                onDelete: fk.on_delete,
+                onUpdate: fk.on_update,
+            });
+        }
+    }
+    else if (type === 'mysql' || type === 'mariadb') {
+        const result = await db.raw(`
+      SELECT
+        COLUMN_NAME,
+        REFERENCED_TABLE_NAME,
+        REFERENCED_COLUMN_NAME
+      FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
+      WHERE TABLE_SCHEMA = 'mcp_test'
+        AND TABLE_NAME = ?
+        AND REFERENCED_TABLE_NAME IS NOT NULL
+    `, [tableName]);
+        for (const fk of result[0]) {
+            constraints.push({
+                tableName,
+                columnName: fk.COLUMN_NAME,
+                referencedTable: fk.REFERENCED_TABLE_NAME,
+                referencedColumn: fk.REFERENCED_COLUMN_NAME,
+            });
+        }
+    }
+    else if (type === 'postgresql') {
+        const result = await db.raw(`
+      SELECT
+        kcu.column_name,
+        ccu.table_name AS referenced_table,
+        ccu.column_name AS referenced_column
+      FROM information_schema.table_constraints AS tc
+      JOIN information_schema.key_column_usage AS kcu
+        ON tc.constraint_name = kcu.constraint_name
+      JOIN information_schema.constraint_column_usage AS ccu
+        ON ccu.constraint_name = tc.constraint_name
+      WHERE tc.constraint_type = 'FOREIGN KEY'
+        AND tc.table_name = ?
+    `, [tableName]);
+        for (const fk of result.rows) {
+            constraints.push({
+                tableName,
+                columnName: fk.column_name,
+                referencedTable: fk.referenced_table,
+                referencedColumn: fk.referenced_column,
+            });
+        }
+    }
+    return constraints;
+}
+/**
+ * Assert FK constraints exist for a table
+ */
+export async function assertFKConstraintsExist(db, type, tableName, expectedCount, message) {
+    const constraints = await getFKConstraints(db, type, tableName);
+    assert.ok(constraints.length >= expectedCount, message || `Expected at least ${expectedCount} FK constraints on ${tableName}, found ${constraints.length}`);
+}
+// ============================================================================
+// Data Seeding Helpers (DRY)
+// ============================================================================
+/**
+ * Seed test data with FK relationships
+ * Creates a simple schema: projects → agents → context_keys → decisions
+ */
+export async function seedTestData(db) {
+    const now = Math.floor(Date.now() / 1000);
+    // Clear existing test data (use test IDs 10, 20, 100, 101 to avoid conflicts with migration-created data)
+    await db('t_decisions').where('key_id', '>=', 100).andWhere('key_id', '<=', 101).del();
+    await db('m_context_keys').where('id', '>=', 100).andWhere('id', '<=', 101).del();
+    await db('m_agents').where('name', 'test-agent').del();
+    await db('m_projects').where('name', 'like', 'test-project-%').del();
+    // Seed m_projects (use IDs 10, 20 to avoid conflicts)
+    await db('m_projects').insert([
+        { id: 10, name: 'test-project-1', display_name: 'Test Project 1', detection_source: 'test', created_ts: now, last_active_ts: now },
+        { id: 20, name: 'test-project-2', display_name: 'Test Project 2', detection_source: 'test', created_ts: now, last_active_ts: now },
+    ]);
+    // Seed m_agents (use ID 100 to avoid conflicts)
+    await db('m_agents').insert([
+        { id: 100, name: 'test-agent' },
+    ]);
+    // Seed m_context_keys (use IDs 100, 101 to avoid conflicts)
+    await db('m_context_keys').insert([
+        { id: 100, key: 'test/key1' },
+        { id: 101, key: 'test/key2' },
+    ]);
+    // Seed t_decisions (has FK to m_projects, m_agents, m_context_keys)
+    await db('t_decisions').insert([
+        { key_id: 100, project_id: 10, value: 'test-value-1', ts: now, agent_id: 100 },
+        { key_id: 101, project_id: 20, value: 'test-value-2', ts: now, agent_id: 100 },
+    ]);
+}
+/**
+ * Verify seeded data exists
+ * Note: Migrations may create a default project (ID 1), so we check for our test projects specifically
+ */
+export async function assertSeededDataExists(db) {
+    // Check for our specific test projects (IDs 10, 20)
+    const testProjects = await db('m_projects').whereIn('id', [10, 20]);
+    assert.strictEqual(testProjects.length, 2, 'Should have 2 test projects (IDs 10, 20)');
+    // Check for our test decisions
+    const testDecisions = await db('t_decisions').whereIn('key_id', [100, 101]);
+    assert.strictEqual(testDecisions.length, 2, 'Should have 2 test decisions (key_ids 100, 101)');
+}
+// ============================================================================
+// SQL Import Helpers (DRY)
+// ============================================================================
+/**
+ * Import SQL dump to database via Docker container
+ */
+export async function importSqlToDocker(sql, containerName, type) {
+    const tempFile = `/tmp/sqlew-test-${Date.now()}.sql`;
+    writeFileSync(tempFile, sql);
+    try {
+        // Copy file to container
+        await execAsync(`docker cp ${tempFile} ${containerName}:/tmp/import.sql`);
+        // Import based on database type
+        if (type === 'mysql' || type === 'mariadb') {
+            await execAsync(`docker exec ${containerName} mysql -u mcp_user -pmcp_pass mcp_test -e "SOURCE /tmp/import.sql"`);
+        }
+        else if (type === 'postgresql') {
+            await execAsync(`docker exec ${containerName} psql -U mcp_user -d mcp_test -f /tmp/import.sql -v ON_ERROR_STOP=1 -q`);
+        }
+    }
+    finally {
+        // Clean up temp file
+        if (existsSync(tempFile)) {
+            unlinkSync(tempFile);
+        }
+    }
+}
+/**
+ * Setup test context with multiple databases
+ */
+export async function setupTestContext(types) {
+    const dbs = new Map();
+    const configs = new Map();
+    for (const type of types) {
+        const config = getDbConfig(type);
+        configs.set(type, config);
+        try {
+            const db = await connectDb(config);
+            dbs.set(type, db);
+        }
+        catch (error) {
+            // Clean up already connected databases
+            for (const [, db] of dbs) {
+                await disconnectDb(db);
+            }
+            throw error;
+        }
+    }
+    return { dbs, configs };
+}
+/**
+ * Teardown test context (close all connections)
+ */
+export async function teardownTestContext(context) {
+    for (const [, db] of context.dbs) {
+        await disconnectDb(db);
+    }
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/tests/utils/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/tests/utils/test-helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Config tool for MCP Shared Context Server
+ * Manages per-project configuration with inheritance (project-specific > global)
+ *
+ * CONVERTED: Using Knex.js query builder only (NO knex.raw())
+ */
+import { DatabaseAdapter } from '../adapters/index.js';
+/**
+ * Get configuration value with per-project inheritance
+ *
+ * Lookup priority:
+ * 1. Project-specific config (project_id = current project)
+ * 2. Global config (project_id = NULL)
+ *
+ * @param params - Config key to retrieve
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Config value or null if not found
+ */
+export declare function getConfig(params: {
+    key: string;
+}, adapter?: DatabaseAdapter): Promise<{
+    key: string;
+    value: string | null;
+    scope: 'project' | 'global' | 'not_found';
+}>;
+/**
+ * Update configuration value (project-specific or global)
+ *
+ * @param params - Config key, value, and optional scope
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Success status
+ */
+export declare function updateConfig(params: {
+    key: string;
+    value: string;
+    scope?: 'project' | 'global';
+}, adapter?: DatabaseAdapter): Promise<{
+    success: boolean;
+    key: string;
+    value: string;
+    scope: 'project' | 'global';
+}>;
+/**
+ * Get help documentation for config tool
+ * @returns Help documentation object
+ */
+export declare function configHelp(): any;
+/**
+ * Get comprehensive examples for config tool
+ * @returns Examples documentation object
+ */
+export declare function configExample(): any;
+/**
+ * Get use case documentation for config tool
+ * @returns Use case documentation object
+ */
+export declare function configUseCase(): any;
+//# sourceMappingURL=config.d.ts.map

package/dist/tools/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/tools/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;CAAE,CAAC,CAkD3F;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE;IACN,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B,EACD,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,CAqCxF;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,GAAG,CA2BhC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAyEnC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,GAAG,CA0DnC"}