@semics-tech/mongolite 1.0.0

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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,MAAM,OAAO,aAAa;IAOxB,YAAY,UAA2B,EAAE;QAJjC,sBAAiB,GAAkB,IAAI,CAAC;QACxC,eAAU,GAAuB,IAAI,CAAC;QACtC,iBAAY,GAA8C,IAAI,CAAC;QAGrE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QAC5E,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAElE,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,mBAAmB;SAC5B,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,kCAAkC,EAClC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QAEjB,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE;YACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAE7B,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC1E,CAAC;YAED,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YAC7B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAa;QACvC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IAEO,QAAQ;QACd,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC;YAClE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC5B,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;oBACjC,MAAM,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,OAAO,CAAC,GAAG,CAAC,OAAO,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;gBAC5C,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,MAAmB,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QAEzB,2DAA2D;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAElE,8EAA8E;QAC9E,wCAAwC;QACxC,MAAM,WAAW,GAAG,IAAI,eAAe,CACpC,UAAkB,CAAC,EAAE,EACtB,IAAI,CAAC,iBAAiB,EACtB,MAAM,EACN,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QAEzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;oBAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1D,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QAC7C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,+CAA+C;YAC/C,MAAM,EAAE,GAAI,IAAI,CAAC,MAAc,CAAC,EAAE,CAAC;YAEnC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;YAEpD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,KAAa,EAAE,EAAE;oBAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1D,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAErE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAa;QACpC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAEjE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CACT,6BAA6B,IAAI,CAAC,iBAAiB,MAAM,OAAO,CAAC,MAAM,OAAO,KAAK,cAAc,CAClG,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;oBAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1D,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,eAAgE,SAAQ,UAAa;IACzF,YACE,EAAO,EACP,cAAsB,EACtB,MAAiB,EACjB,UAAiC,EAAE;QAEnC,KAAK,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEM,MAAM;QACX,yCAAyC;QACzC,OAAQ,IAAY,CAAC,UAAU,CAAC;IAClC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { IDatabaseAdapter, MongoLiteOptions as DBMongoLiteOptions } from './db.js';
+import { MongoLite as MongoLiteBase, MongoLiteBaseOptions } from './mongo-client.js';
+export { MongoLiteCollection } from './collection.js';
+export * from './types.js';
+export { ChangeStream } from './changeStream.js';
+export type { ChangeStreamDocument, ChangeStreamOptions, ChangeOperationType, } from './changeStream.js';
+export type { IDatabaseAdapter } from './db.js';
+export { CloudflareDurableObjectAdapter, } from './adapters/cloudflare.js';
+export type { SqlStorage, SqlStorageCursor, SqlStorageValue, } from './adapters/cloudflare.js';
+export { BrowserSqliteAdapter } from './adapters/browser.js';
+export type { SqlJsDatabase, SqlJsStatement } from './adapters/browser.js';
+export interface MongoLiteClientOptions extends DBMongoLiteOptions {
+}
+/**
+ * MongoLite class is the main entry point for interacting with the SQLite-backed database.
+ *
+ * You can construct it with:
+ * - A file path string — uses the built-in `better-sqlite3` adapter.
+ * - A `MongoLiteClientOptions` object — uses the built-in adapter with options.
+ * - An `IDatabaseAdapter` instance — use a custom adapter such as
+ *   `CloudflareDurableObjectAdapter` for Cloudflare Durable Objects.
+ */
+export declare class MongoLite extends MongoLiteBase {
+    /**
+     * Creates a new MongoLite client instance.
+     * @param dbPathOrOptions Path to the SQLite database file, an options object,
+     *                        or an `IDatabaseAdapter` for custom backends.
+     */
+    constructor(dbPathOrOptions: string | MongoLiteClientOptions | IDatabaseAdapter, options?: MongoLiteBaseOptions);
+}

package/dist/index.js

@@ -0,0 +1,40 @@
+import { SQLiteDB } from './db.js';
+import { MongoLite as MongoLiteBase } from './mongo-client.js';
+export { MongoLiteCollection } from './collection.js';
+export * from './types.js';
+export { ChangeStream } from './changeStream.js';
+export { CloudflareDurableObjectAdapter, } from './adapters/cloudflare.js';
+export { BrowserSqliteAdapter } from './adapters/browser.js';
+/**
+ * MongoLite class is the main entry point for interacting with the SQLite-backed database.
+ *
+ * You can construct it with:
+ * - A file path string — uses the built-in `better-sqlite3` adapter.
+ * - A `MongoLiteClientOptions` object — uses the built-in adapter with options.
+ * - An `IDatabaseAdapter` instance — use a custom adapter such as
+ *   `CloudflareDurableObjectAdapter` for Cloudflare Durable Objects.
+ */
+export class MongoLite extends MongoLiteBase {
+    /**
+     * Creates a new MongoLite client instance.
+     * @param dbPathOrOptions Path to the SQLite database file, an options object,
+     *                        or an `IDatabaseAdapter` for custom backends.
+     */
+    constructor(dbPathOrOptions, options = {}) {
+        if (dbPathOrOptions &&
+            typeof dbPathOrOptions === 'object' &&
+            typeof dbPathOrOptions.connect === 'function' &&
+            typeof dbPathOrOptions.run === 'function' &&
+            typeof dbPathOrOptions.get === 'function' &&
+            typeof dbPathOrOptions.all === 'function' &&
+            typeof dbPathOrOptions.exec === 'function' &&
+            typeof dbPathOrOptions.close === 'function') {
+            // Custom adapter (e.g. CloudflareDurableObjectAdapter)
+            super(dbPathOrOptions, options);
+        }
+        else {
+            super(new SQLiteDB(dbPathOrOptions), options);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA4D,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,SAAS,IAAI,aAAa,EAAwB,MAAM,mBAAmB,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD,OAAO,EACL,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAK7D;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAU,SAAQ,aAAa;IAC1C;;;;OAIG;IACH,YACE,eAAmE,EACnE,UAAgC,EAAE;QAElC,IACE,eAAe;YACf,OAAO,eAAe,KAAK,QAAQ;YACnC,OAAQ,eAAoC,CAAC,OAAO,KAAK,UAAU;YACnE,OAAQ,eAAoC,CAAC,GAAG,KAAK,UAAU;YAC/D,OAAQ,eAAoC,CAAC,GAAG,KAAK,UAAU;YAC/D,OAAQ,eAAoC,CAAC,GAAG,KAAK,UAAU;YAC/D,OAAQ,eAAoC,CAAC,IAAI,KAAK,UAAU;YAChE,OAAQ,eAAoC,CAAC,KAAK,KAAK,UAAU,EACjE,CAAC;YACD,uDAAuD;YACvD,KAAK,CAAC,eAAmC,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,QAAQ,CAAC,eAAkD,CAAC,EAAE,OAAO,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;CACF"}

package/dist/mongo-client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Cloudflare-safe MongoLite client base class.
+ *
+ * This module does NOT import `better-sqlite3` and is safe to use inside
+ * Cloudflare Workers / Durable Objects. It exports the core `MongoLite` class
+ * that accepts any `IDatabaseAdapter` implementation.
+ *
+ * Node.js consumers should import from the package root (`@semics-tech/mongolite`) which
+ * provides additional constructor overloads accepting a file path or options object.
+ */
+import type { IDatabaseAdapter } from './db.js';
+import { MongoLiteCollection } from './collection.js';
+import { DocumentWithId } from './types.js';
+export type { IDatabaseAdapter };
+export type MongoLiteBaseOptions = {
+    verbose?: boolean;
+};
+/**
+ * Core MongoLite client. Accepts any `IDatabaseAdapter` implementation.
+ *
+ * This class is intentionally free of `better-sqlite3` dependencies so that it
+ * can be bundled for Cloudflare Workers / Durable Objects. For Node.js use, prefer
+ * importing `MongoLite` from the package root, which adds convenient constructor
+ * overloads for file paths and options objects.
+ */
+export declare class MongoLite {
+    protected db: IDatabaseAdapter;
+    protected options: MongoLiteBaseOptions;
+    constructor(adapter: IDatabaseAdapter, options?: MongoLiteBaseOptions);
+    /**
+     * Connects to the database.
+     * For most custom adapters (e.g. Cloudflare) this is a no-op.
+     */
+    connect(): Promise<void>;
+    /**
+     * Returns the underlying database adapter instance.
+     */
+    get database(): IDatabaseAdapter;
+    /**
+     * Closes the database connection.
+     * For most custom adapters (e.g. Cloudflare) this is a no-op.
+     */
+    close(): Promise<void>;
+    /**
+     * Lists all collections (tables) in the database.
+     * @returns An object with a `toArray` method that resolves to an array of collection names.
+     */
+    listCollections(): {
+        toArray: () => Promise<string[]>;
+    };
+    /**
+     * Returns a typed collection handle.
+     * @param name The collection (table) name.
+     */
+    collection<T extends DocumentWithId = DocumentWithId>(name: string): MongoLiteCollection<T>;
+}

package/dist/mongo-client.js

@@ -0,0 +1,55 @@
+import { MongoLiteCollection } from './collection.js';
+/**
+ * Core MongoLite client. Accepts any `IDatabaseAdapter` implementation.
+ *
+ * This class is intentionally free of `better-sqlite3` dependencies so that it
+ * can be bundled for Cloudflare Workers / Durable Objects. For Node.js use, prefer
+ * importing `MongoLite` from the package root, which adds convenient constructor
+ * overloads for file paths and options objects.
+ */
+export class MongoLite {
+    constructor(adapter, options = {}) {
+        this.db = adapter;
+        this.options = options;
+    }
+    /**
+     * Connects to the database.
+     * For most custom adapters (e.g. Cloudflare) this is a no-op.
+     */
+    async connect() {
+        return this.db.connect();
+    }
+    /**
+     * Returns the underlying database adapter instance.
+     */
+    get database() {
+        return this.db;
+    }
+    /**
+     * Closes the database connection.
+     * For most custom adapters (e.g. Cloudflare) this is a no-op.
+     */
+    async close() {
+        return this.db.close();
+    }
+    /**
+     * Lists all collections (tables) in the database.
+     * @returns An object with a `toArray` method that resolves to an array of collection names.
+     */
+    listCollections() {
+        return {
+            toArray: async () => {
+                const result = await this.db.all(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'`);
+                return result.map((row) => row.name);
+            },
+        };
+    }
+    /**
+     * Returns a typed collection handle.
+     * @param name The collection (table) name.
+     */
+    collection(name) {
+        return new MongoLiteCollection(this.db, name, this.options);
+    }
+}
+//# sourceMappingURL=mongo-client.js.map

package/dist/mongo-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-client.js","sourceRoot":"","sources":["../src/mongo-client.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAStD;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IAIpB,YAAY,OAAyB,EAAE,UAAgC,EAAE;QACvE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO;YACL,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAC9B,gFAAgF,CACjF,CAAC;gBACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,UAAU,CAA4C,IAAY;QAChE,OAAO,IAAI,mBAAmB,CAAI,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;CACF"}