mongolite-ts 0.3.0 → 0.4.0

package/README.md

@@ -15,6 +15,7 @@ A MongoDB-like client that uses SQLite as its underlying persistent store. Writt
 * Support for querying JSON fields.
 * Written in TypeScript with strong typing.
 * 100% test coverage (aiming for).
+* **Interactive Query Debugger** - Debug complex queries with `npx mongolite-debug`
 
 ## Installation
 
@@ -112,6 +113,29 @@ async function main() {
 main();
 ```
 
+## Query Debugger
+
+MongoLite includes an interactive query debugger to help you debug complex queries and understand how MongoDB-style filters are converted to SQL.
+
+```bash
+# Start the debugger
+npx mongolite-debug
+
+# Use with your specific database
+npx mongolite-debug -d ./path/to/your/database.db
+
+# Start with a specific collection
+npx mongolite-debug -c users --verbose
+```
+
+The debugger provides interactive commands to:
+- Convert find queries to SQL and see the generated queries
+- Execute raw SQL queries for testing
+- Sample data from collections  
+- Compare MongoDB-style queries with optimized SQL
+
+See [DEBUGGER.md](./docs/DEBUGGER.md) for detailed usage instructions and examples.
+
 ## API
 
 ### `MongoLite`

package/dist/bin/mongolite-debug.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/mongolite-debug.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import { QueryDebugger } from '../debugger/query-debugger.js';
+import path from 'path';
+// CLI argument parsing
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--verbose' || arg === '-v') {
+            options.verbose = true;
+        }
+        else if (arg === '--collection' || arg === '-c') {
+            options.collection = args[++i];
+        }
+        else if (arg === '--database' || arg === '-d') {
+            options.database = args[++i];
+        }
+        else if (arg === '--help' || arg === '-h') {
+            options.help = true;
+        }
+    }
+    return options;
+}
+function showHelp() {
+    console.log('MongoLite Query Debugger');
+    console.log('');
+    console.log('Interactive debugging tool for MongoLite queries.');
+    console.log('');
+    console.log('Usage: npx mongolite-debug [options]');
+    console.log('');
+    console.log('Options:');
+    console.log('  -d, --database <path>     Database file path (default: ./mongolite.db)');
+    console.log('  -c, --collection <name>   Initial collection to use');
+    console.log('  -v, --verbose             Enable verbose output');
+    console.log('  -h, --help                Show this help');
+    console.log('');
+    console.log('Interactive Commands:');
+    console.log('  .help                     Show available commands');
+    console.log('  .collections              List all collections');
+    console.log('  .use <collection>         Select a collection to work with');
+    console.log('  .find <filter>            Convert find filter to SQL and execute');
+    console.log('  .sql <query>              Execute raw SQL query');
+    console.log('  .last                     Show last generated SQL');
+    console.log('  .sample [count]           Show sample documents from current collection');
+    console.log('  .exit                     Exit the debugger');
+    console.log('');
+    console.log('Examples:');
+    console.log('  npx mongolite-debug -d ./myapp.db -c users');
+    console.log('  npx mongolite-debug --verbose');
+    console.log('');
+    console.log('  # Inside the debugger:');
+    console.log('  .use users');
+    console.log('  .find {"age": {"$gt": 25}}');
+    console.log('  .sql SELECT * FROM users WHERE json_extract(data, "$.age") > 25');
+    console.log('');
+}
+async function main() {
+    const options = parseArgs();
+    if (options.help) {
+        showHelp();
+        process.exit(0);
+    }
+    // Set default database path if not provided
+    if (!options.database) {
+        // Look for common database files in the current directory
+        const cwd = process.cwd();
+        const commonNames = [
+            'mongolite.db',
+            'mongolite.sqlite',
+            'database.db',
+            'database.sqlite',
+            'app.db',
+            'app.sqlite'
+        ];
+        // Check if any common database files exist
+        const { existsSync } = await import('fs');
+        let foundDb = false;
+        for (const name of commonNames) {
+            const dbPath = path.join(cwd, name);
+            if (existsSync(dbPath)) {
+                options.database = dbPath;
+                foundDb = true;
+                break;
+            }
+        }
+        if (!foundDb) {
+            options.database = path.join(cwd, 'mongolite.db');
+        }
+    }
+    console.log('🔍 MongoLite Query Debugger (npx version)');
+    console.log(`📁 Database: ${options.database}`);
+    if (options.collection) {
+        console.log(`📋 Initial collection: ${options.collection}`);
+    }
+    console.log('');
+    try {
+        const queryDebugger = new QueryDebugger(options);
+        await queryDebugger.start();
+    }
+    catch (error) {
+        console.error('Fatal error:', error instanceof Error ? error.message : error);
+        if (error instanceof Error && error.message.includes('SQLITE_CANTOPEN')) {
+            console.error('');
+            console.error('💡 Tip: Make sure the database file exists or specify a different path with -d');
+            console.error('   Example: npx mongolite-debug -d ./path/to/your/database.db');
+        }
+        process.exit(1);
+    }
+}
+main().catch(error => {
+    console.error('Unexpected error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=mongolite-debug.js.map

package/dist/bin/mongolite-debug.js.map

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

package/dist/debugger/query-debugger.d.ts

@@ -0,0 +1,22 @@
+export interface DebuggerOptions {
+    verbose?: boolean;
+    collection?: string;
+    database?: string;
+}
+export declare class QueryDebugger {
+    private client;
+    private rl;
+    private currentCollection;
+    private lastFilter;
+    private lastSqlQuery;
+    constructor(options?: DebuggerOptions);
+    start(): Promise<void>;
+    private handleCommand;
+    private showHelp;
+    private listCollections;
+    private handleFindCommand;
+    private handleSqlCommand;
+    private showLastQuery;
+    private showSample;
+    private cleanup;
+}

package/dist/debugger/query-debugger.js

@@ -0,0 +1,258 @@
+import { MongoLite } from '../index.js';
+import { FindCursor } from '../cursors/findCursor.js';
+import * as readline from 'readline';
+import path from 'path';
+export class QueryDebugger {
+    constructor(options = {}) {
+        this.currentCollection = null;
+        this.lastFilter = null;
+        this.lastSqlQuery = null;
+        const dbPath = options.database || path.join(process.cwd(), 'mongolite.db');
+        this.client = new MongoLite(dbPath, { verbose: options.verbose });
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: 'mongolite-debug> '
+        });
+        if (options.collection) {
+            this.currentCollection = options.collection;
+        }
+    }
+    async start() {
+        console.log('Commands:');
+        console.log('  .help                     - Show this help');
+        console.log('  .collections              - List all collections');
+        console.log('  .use <collection>         - Select a collection to work with');
+        console.log('  .find <filter>            - Convert find filter to SQL and execute');
+        console.log('  .sql <query>              - Execute raw SQL query');
+        console.log('  .last                     - Show last generated SQL');
+        console.log('  .sample [count]           - Show sample documents from current collection');
+        console.log('  .exit                     - Exit the debugger');
+        console.log('');
+        try {
+            await this.client.connect();
+            console.log('✅ Connected to database.');
+        }
+        catch (error) {
+            console.error('❌ Failed to connect to database:', error instanceof Error ? error.message : error);
+            throw error;
+        }
+        if (this.currentCollection) {
+            console.log(`Current collection: ${this.currentCollection}`);
+        }
+        this.rl.prompt();
+        this.rl.on('line', async (input) => {
+            const trimmed = input.trim();
+            if (trimmed === '.exit') {
+                await this.cleanup();
+                return;
+            }
+            try {
+                await this.handleCommand(trimmed);
+            }
+            catch (error) {
+                console.error('Error:', error instanceof Error ? error.message : error);
+            }
+            this.rl.prompt();
+        });
+        this.rl.on('close', async () => {
+            await this.cleanup();
+        });
+    }
+    async handleCommand(input) {
+        if (input === '.help') {
+            this.showHelp();
+            return;
+        }
+        if (input === '.collections') {
+            await this.listCollections();
+            return;
+        }
+        if (input.startsWith('.use ')) {
+            const collection = input.slice(5).trim();
+            this.currentCollection = collection;
+            console.log(`Switched to collection: ${collection}`);
+            return;
+        }
+        if (input.startsWith('.find ')) {
+            await this.handleFindCommand(input.slice(6).trim());
+            return;
+        }
+        if (input.startsWith('.sql ')) {
+            await this.handleSqlCommand(input.slice(5).trim());
+            return;
+        }
+        if (input === '.last') {
+            this.showLastQuery();
+            return;
+        }
+        if (input.startsWith('.sample')) {
+            const parts = input.split(' ');
+            const count = parts.length > 1 ? parseInt(parts[1]) || 5 : 5;
+            await this.showSample(count);
+            return;
+        }
+        console.log('Unknown command. Type .help for available commands.');
+    }
+    showHelp() {
+        console.log('');
+        console.log('Available commands:');
+        console.log('  .help                     - Show this help');
+        console.log('  .collections              - List all collections');
+        console.log('  .use <collection>         - Select a collection to work with');
+        console.log('  .find <filter>            - Convert find filter to SQL and execute');
+        console.log('  .sql <query>              - Execute raw SQL query');
+        console.log('  .last                     - Show last generated SQL');
+        console.log('  .sample [count]           - Show sample documents from current collection');
+        console.log('  .exit                     - Exit the debugger');
+        console.log('');
+        console.log('Examples:');
+        console.log('  .use users');
+        console.log('  .find {"age": {"$gt": 25}}');
+        console.log('  .find {"name": "John", "age": {"$in": [25, 30, 35]}}');
+        console.log('  .sql SELECT * FROM users WHERE json_extract(data, "$.age") > 25');
+        console.log('');
+    }
+    async listCollections() {
+        try {
+            const collections = await this.client.listCollections().toArray();
+            if (collections.length === 0) {
+                console.log('No collections found.');
+            }
+            else {
+                console.log('Collections:');
+                collections.forEach(collection => {
+                    const marker = collection === this.currentCollection ? ' (current)' : '';
+                    console.log(`  - ${collection}${marker}`);
+                });
+            }
+        }
+        catch (error) {
+            console.error('Error listing collections:', error instanceof Error ? error.message : error);
+        }
+    }
+    async handleFindCommand(filterStr) {
+        if (!this.currentCollection) {
+            console.log('No collection selected. Use .use <collection> first.');
+            return;
+        }
+        let filter;
+        try {
+            filter = JSON.parse(filterStr);
+        }
+        catch (error) {
+            console.log('Invalid JSON filter:', error instanceof Error ? error.message : error);
+            return;
+        }
+        this.lastFilter = filter;
+        // Create a collection and a find cursor to extract the SQL
+        const collection = this.client.collection(this.currentCollection);
+        // We need to access the internal SQL generation. Let's create a custom cursor
+        // that exposes the SQL generation logic
+        const debugCursor = new DebugFindCursor(collection.db, this.currentCollection, filter, { verbose: true });
+        this.lastSqlQuery = debugCursor.getSQL();
+        console.log('');
+        console.log('📝 Generated SQL:');
+        console.log('Query:', this.lastSqlQuery.sql);
+        console.log('Parameters:', JSON.stringify(this.lastSqlQuery.params));
+        console.log('');
+        // Execute the query and show results
+        try {
+            const results = await debugCursor.toArray();
+            console.log(`📊 Results (${results.length} documents):`);
+            if (results.length > 0) {
+                results.forEach((doc, index) => {
+                    console.log(`[${index}]`, JSON.stringify(doc, null, 2));
+                });
+            }
+            else {
+                console.log('No documents found.');
+            }
+        }
+        catch (error) {
+            console.error('Execution error:', error instanceof Error ? error.message : error);
+        }
+    }
+    async handleSqlCommand(sqlQuery) {
+        if (!this.currentCollection) {
+            console.log('No collection selected. Use .use <collection> first.');
+            return;
+        }
+        try {
+            // Get the database instance to execute raw SQL
+            const db = this.client.db;
+            console.log('');
+            console.log('🔧 Executing SQL:');
+            console.log(sqlQuery);
+            console.log('');
+            const results = await db.all(sqlQuery);
+            console.log(`📊 Results (${results.length} rows):`);
+            if (results.length > 0) {
+                results.forEach((row, index) => {
+                    console.log(`[${index}]`, JSON.stringify(row, null, 2));
+                });
+            }
+            else {
+                console.log('No rows returned.');
+            }
+        }
+        catch (error) {
+            console.error('SQL execution error:', error instanceof Error ? error.message : error);
+        }
+    }
+    showLastQuery() {
+        if (!this.lastSqlQuery) {
+            console.log('No previous query to show.');
+            return;
+        }
+        console.log('');
+        console.log('📝 Last Generated SQL:');
+        console.log('Query:', this.lastSqlQuery.sql);
+        console.log('Parameters:', JSON.stringify(this.lastSqlQuery.params));
+        if (this.lastFilter) {
+            console.log('Original Filter:', JSON.stringify(this.lastFilter, null, 2));
+        }
+        console.log('');
+    }
+    async showSample(count) {
+        if (!this.currentCollection) {
+            console.log('No collection selected. Use .use <collection> first.');
+            return;
+        }
+        try {
+            const collection = this.client.collection(this.currentCollection);
+            const results = await collection.find({}).limit(count).toArray();
+            console.log('');
+            console.log(`📋 Sample documents from "${this.currentCollection}" (${results.length} of ${count} requested):`);
+            if (results.length > 0) {
+                results.forEach((doc, index) => {
+                    console.log(`[${index}]`, JSON.stringify(doc, null, 2));
+                });
+            }
+            else {
+                console.log('Collection is empty.');
+            }
+            console.log('');
+        }
+        catch (error) {
+            console.error('Error fetching sample:', error instanceof Error ? error.message : error);
+        }
+    }
+    async cleanup() {
+        console.log('\nClosing database connection...');
+        await this.client.close();
+        this.rl.close();
+        process.exit(0);
+    }
+}
+// Extended FindCursor that exposes SQL generation
+class DebugFindCursor extends FindCursor {
+    constructor(db, collectionName, filter, options = {}) {
+        super(db, collectionName, filter, options);
+    }
+    getSQL() {
+        // Access the private queryParts property
+        return this.queryParts;
+    }
+}
+//# sourceMappingURL=query-debugger.js.map

package/dist/debugger/query-debugger.js.map

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

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "mongolite-ts",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A MongoDB-like client using SQLite as a persistent store, written in TypeScript.",
   "main": "dist/index.js",
   "type": "module",
   "types": "dist/index.d.ts",
+  "bin": {
+    "mongolite-debug": "dist/bin/mongolite-debug.js"
+  },
   "scripts": {
     "build": "tsc",
     "test": "node --import tsx --test tests/*.test.ts",
@@ -15,7 +18,8 @@
     "verify-build": "node --import tsx scripts/verify-build.js",
     "test-third-party": "node scripts/test-third-party-usage.js",
     "test:all": "npm run lint && npm run test && npm run verify-build && npm run test-third-party",
-    "benchmark": "npx tsx scripts/benchmark.ts"
+    "benchmark": "npx tsx scripts/benchmark.ts",
+    "debug-queries": "npx tsx scripts/query-debugger.ts"
   },
   "repository": {
     "type": "git",