@semics-tech/mongolite 1.0.0

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/changeStream.d.ts

@@ -0,0 +1,114 @@
+import { EventEmitter } from 'events';
+import type { IDatabaseAdapter } from './db.js';
+import { DocumentWithId, Filter } from './types.js';
+export type ChangeOperationType = 'insert' | 'update' | 'delete' | 'replace';
+export interface ChangeStreamDocument<T extends DocumentWithId = DocumentWithId> {
+    _id: string;
+    operationType: ChangeOperationType;
+    clusterTime?: Date;
+    fullDocument?: T;
+    fullDocumentBeforeChange?: T;
+    documentKey: {
+        _id: string;
+    };
+    ns: {
+        db: string;
+        coll: string;
+    };
+    updateDescription?: {
+        updatedFields: Record<string, unknown>;
+        removedFields: string[];
+    };
+}
+export interface ChangeStreamOptions<T extends DocumentWithId = DocumentWithId> {
+    /**
+     * Filter to apply to change events
+     */
+    filter?: Filter<ChangeStreamDocument<T>>;
+    /**
+     * Whether to include the full document in insert and update operations
+     */
+    fullDocument?: 'default' | 'updateLookup' | 'whenAvailable' | 'required';
+    /**
+     * Whether to include the full document before the change for update operations
+     */
+    fullDocumentBeforeChange?: 'off' | 'whenAvailable' | 'required';
+    /**
+     * Resume token for resuming change streams (not implemented in this version)
+     */
+    resumeAfter?: string;
+    /**
+     * Maximum number of events to buffer
+     */
+    maxBufferSize?: number;
+}
+export declare class ChangeStream<T extends DocumentWithId = DocumentWithId> extends EventEmitter {
+    private readonly db;
+    private readonly collectionName;
+    private readonly options;
+    private closed;
+    private pollInterval;
+    private lastProcessedId;
+    private buffer;
+    private readonly maxBufferSize;
+    constructor(db: IDatabaseAdapter, collectionName: string, options?: ChangeStreamOptions<T>);
+    /**
+     * Sets up the change tracking infrastructure
+     */
+    private setupChangeTracking;
+    /**
+     * Creates the change log table if it doesn't exist
+     */
+    private ensureChangeLogTable;
+    /**
+     * Sets up triggers for tracking changes on the collection
+     */
+    private setupTriggers;
+    /**
+     * Starts polling for new changes
+     */
+    private startPolling;
+    /**
+     * Polls for new changes from the change log
+     */
+    private pollForChanges;
+    /**
+     * Transforms a raw change event from the database into a ChangeStreamDocument
+     */
+    private transformChangeEvent;
+    /**
+     * Computes the update description by comparing before and after documents
+     */
+    private computeUpdateDescription;
+    /**
+     * Determines if the full document should be included
+     */
+    private shouldIncludeFullDocument;
+    /**
+     * Determines if the full document before change should be included
+     */
+    private shouldIncludeFullDocumentBefore;
+    /**
+     * Checks if a change document passes the filter
+     */
+    private passesFilter;
+    /**
+     * Returns an async iterator for the change stream
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<ChangeStreamDocument<T>>;
+    /**
+     * Closes the change stream
+     */
+    close(): void;
+    /**
+     * Returns the next change document
+     */
+    next(): Promise<{
+        value: ChangeStreamDocument<T>;
+        done: boolean;
+    }>;
+    /**
+     * Cleanup triggers when the change stream is destroyed
+     */
+    cleanup(): Promise<void>;
+}

package/dist/changeStream.js

@@ -0,0 +1,338 @@
+import { EventEmitter } from 'events';
+export class ChangeStream extends EventEmitter {
+    constructor(db, collectionName, options = {}) {
+        super();
+        this.db = db;
+        this.collectionName = collectionName;
+        this.options = options;
+        this.closed = false;
+        this.pollInterval = null;
+        this.lastProcessedId = 0;
+        this.buffer = [];
+        this.maxBufferSize = options.maxBufferSize || 1000;
+        this.setupChangeTracking();
+        this.startPolling();
+    }
+    /**
+     * Sets up the change tracking infrastructure
+     */
+    async setupChangeTracking() {
+        await this.ensureChangeLogTable();
+        await this.setupTriggers();
+    }
+    /**
+     * Creates the change log table if it doesn't exist
+     */
+    async ensureChangeLogTable() {
+        const createTableSQL = `
+      CREATE TABLE IF NOT EXISTS __mongolite_changes__ (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+        operation_type TEXT NOT NULL,
+        collection_name TEXT NOT NULL,
+        document_id TEXT NOT NULL,
+        full_document TEXT,
+        full_document_before TEXT,
+        updated_fields TEXT,
+        removed_fields TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+    `;
+        const createIndexSQL = `
+      CREATE INDEX IF NOT EXISTS idx_mongolite_changes_collection_timestamp 
+      ON __mongolite_changes__ (collection_name, timestamp);
+    `;
+        await this.db.exec(createTableSQL);
+        await this.db.exec(createIndexSQL);
+    }
+    /**
+     * Sets up triggers for tracking changes on the collection
+     */
+    async setupTriggers() {
+        const collectionName = this.collectionName;
+        // Drop existing triggers for this collection
+        await this.db.exec(`DROP TRIGGER IF EXISTS "${collectionName}_insert_trigger"`);
+        await this.db.exec(`DROP TRIGGER IF EXISTS "${collectionName}_update_trigger"`);
+        await this.db.exec(`DROP TRIGGER IF EXISTS "${collectionName}_delete_trigger"`);
+        // Insert trigger
+        const insertTriggerSQL = `
+      CREATE TRIGGER "${collectionName}_insert_trigger"
+      AFTER INSERT ON "${collectionName}"
+      FOR EACH ROW
+      BEGIN
+        INSERT INTO __mongolite_changes__ (
+          operation_type, collection_name, document_id, full_document
+        ) VALUES (
+          'insert', '${collectionName}', NEW._id, NEW.data
+        );
+      END;
+    `;
+        // Update trigger
+        const updateTriggerSQL = `
+      CREATE TRIGGER "${collectionName}_update_trigger"
+      AFTER UPDATE ON "${collectionName}"
+      FOR EACH ROW
+      BEGIN
+        INSERT INTO __mongolite_changes__ (
+          operation_type, collection_name, document_id, 
+          full_document, full_document_before
+        ) VALUES (
+          'update', '${collectionName}', NEW._id, 
+          NEW.data, OLD.data
+        );
+      END;
+    `;
+        // Delete trigger
+        const deleteTriggerSQL = `
+      CREATE TRIGGER "${collectionName}_delete_trigger"
+      AFTER DELETE ON "${collectionName}"
+      FOR EACH ROW
+      BEGIN
+        INSERT INTO __mongolite_changes__ (
+          operation_type, collection_name, document_id, full_document_before
+        ) VALUES (
+          'delete', '${collectionName}', OLD._id, OLD.data
+        );
+      END;
+    `;
+        await this.db.exec(insertTriggerSQL);
+        await this.db.exec(updateTriggerSQL);
+        await this.db.exec(deleteTriggerSQL);
+    }
+    /**
+     * Starts polling for new changes
+     */
+    startPolling() {
+        if (this.closed)
+            return;
+        this.pollInterval = setInterval(async () => {
+            try {
+                await this.pollForChanges();
+            }
+            catch (error) {
+                this.emit('error', error);
+            }
+        }, 100); // Poll every 100ms
+    }
+    /**
+     * Polls for new changes from the change log
+     */
+    async pollForChanges() {
+        if (this.closed)
+            return;
+        const changes = await this.db.all(`SELECT * FROM __mongolite_changes__ 
+       WHERE collection_name = ? AND id > ? 
+       ORDER BY id ASC LIMIT 100`, [this.collectionName, this.lastProcessedId]);
+        for (const change of changes) {
+            if (this.closed)
+                break;
+            const changeDoc = await this.transformChangeEvent(change);
+            if (this.passesFilter(changeDoc)) {
+                this.buffer.push(changeDoc);
+                // Emit the change event
+                this.emit('change', changeDoc);
+                // Clean buffer if it gets too large
+                if (this.buffer.length > this.maxBufferSize) {
+                    this.buffer = this.buffer.slice(-this.maxBufferSize);
+                }
+            }
+            this.lastProcessedId = change.id;
+        }
+    }
+    /**
+     * Transforms a raw change event from the database into a ChangeStreamDocument
+     */
+    async transformChangeEvent(change) {
+        const fullDocument = change.full_document ? JSON.parse(change.full_document) : undefined;
+        const fullDocumentBefore = change.full_document_before
+            ? JSON.parse(change.full_document_before)
+            : undefined;
+        let updateDescription;
+        if (change.operation_type === 'update' && fullDocument && fullDocumentBefore) {
+            updateDescription = this.computeUpdateDescription(fullDocumentBefore, fullDocument);
+        }
+        const changeDoc = {
+            _id: `${change.id}`, // Use the change log ID as the change stream document ID
+            operationType: change.operation_type,
+            clusterTime: new Date(change.timestamp),
+            documentKey: { _id: change.document_id },
+            ns: {
+                db: 'mongolite', // You could make this configurable
+                coll: change.collection_name,
+            },
+        };
+        // Add full document based on options
+        if (this.shouldIncludeFullDocument(change.operation_type)) {
+            changeDoc.fullDocument = fullDocument
+                ? { _id: change.document_id, ...fullDocument }
+                : undefined;
+        }
+        // Add full document before change based on options
+        if (this.shouldIncludeFullDocumentBefore(change.operation_type)) {
+            changeDoc.fullDocumentBeforeChange = fullDocumentBefore
+                ? { _id: change.document_id, ...fullDocumentBefore }
+                : undefined;
+        }
+        if (updateDescription) {
+            changeDoc.updateDescription = updateDescription;
+        }
+        return changeDoc;
+    }
+    /**
+     * Computes the update description by comparing before and after documents
+     */
+    computeUpdateDescription(before, after) {
+        const updatedFields = {};
+        const removedFields = [];
+        // Type guard to ensure we have objects to compare
+        if (typeof before !== 'object' ||
+            before === null ||
+            typeof after !== 'object' ||
+            after === null) {
+            return { updatedFields, removedFields };
+        }
+        // Simple comparison - this could be made more sophisticated
+        const beforeObj = before;
+        const afterObj = after;
+        const allKeys = new Set([...Object.keys(beforeObj), ...Object.keys(afterObj)]);
+        for (const key of allKeys) {
+            if (!(key in afterObj)) {
+                removedFields.push(key);
+            }
+            else if (!(key in beforeObj) ||
+                JSON.stringify(beforeObj[key]) !== JSON.stringify(afterObj[key])) {
+                updatedFields[key] = afterObj[key];
+            }
+        }
+        return { updatedFields, removedFields };
+    }
+    /**
+     * Determines if the full document should be included
+     */
+    shouldIncludeFullDocument(operationType) {
+        const option = this.options.fullDocument || 'default';
+        switch (option) {
+            case 'default':
+                return operationType === 'insert';
+            case 'updateLookup':
+            case 'whenAvailable':
+            case 'required':
+                return (operationType === 'insert' || operationType === 'update' || operationType === 'replace');
+            default:
+                return false;
+        }
+    }
+    /**
+     * Determines if the full document before change should be included
+     */
+    shouldIncludeFullDocumentBefore(operationType) {
+        const option = this.options.fullDocumentBeforeChange || 'off';
+        if (option === 'off')
+            return false;
+        return operationType === 'update' || operationType === 'replace' || operationType === 'delete';
+    }
+    /**
+     * Checks if a change document passes the filter
+     */
+    passesFilter(changeDoc) {
+        if (!this.options.filter)
+            return true;
+        // Simple filter implementation - could be enhanced
+        // For now, just check basic equality filters
+        for (const [key, value] of Object.entries(this.options.filter)) {
+            const docValue = changeDoc[key];
+            if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                // Handle operators like $in, $eq, etc.
+                // This is a simplified implementation
+                continue;
+            }
+            else if (docValue !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Returns an async iterator for the change stream
+     */
+    async *[Symbol.asyncIterator]() {
+        while (!this.closed) {
+            if (this.buffer.length > 0) {
+                yield this.buffer.shift();
+            }
+            else {
+                // Wait for next change
+                await new Promise((resolve) => {
+                    const onChange = () => {
+                        this.removeListener('change', onChange);
+                        this.removeListener('close', onClose);
+                        resolve();
+                    };
+                    const onClose = () => {
+                        this.removeListener('change', onChange);
+                        this.removeListener('close', onClose);
+                        resolve();
+                    };
+                    this.once('change', onChange);
+                    this.once('close', onClose);
+                });
+            }
+        }
+    }
+    /**
+     * Closes the change stream
+     */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+        }
+        this.emit('close');
+        this.removeAllListeners();
+    }
+    /**
+     * Returns the next change document
+     */
+    async next() {
+        if (this.closed) {
+            return { value: {}, done: true };
+        }
+        if (this.buffer.length > 0) {
+            return { value: this.buffer.shift(), done: false };
+        }
+        // Wait for next change
+        return new Promise((resolve) => {
+            const onChange = (changeDoc) => {
+                this.removeListener('change', onChange);
+                this.removeListener('close', onClose);
+                resolve({ value: changeDoc, done: false });
+            };
+            const onClose = () => {
+                this.removeListener('change', onChange);
+                this.removeListener('close', onClose);
+                resolve({ value: {}, done: true });
+            };
+            this.once('change', onChange);
+            this.once('close', onClose);
+        });
+    }
+    /**
+     * Cleanup triggers when the change stream is destroyed
+     */
+    async cleanup() {
+        const collectionName = this.collectionName;
+        try {
+            await this.db.exec(`DROP TRIGGER IF EXISTS "${collectionName}_insert_trigger"`);
+            await this.db.exec(`DROP TRIGGER IF EXISTS "${collectionName}_update_trigger"`);
+            await this.db.exec(`DROP TRIGGER IF EXISTS "${collectionName}_delete_trigger"`);
+        }
+        catch (error) {
+            // Ignore errors during cleanup
+            console.warn('Error during change stream cleanup:', error);
+        }
+    }
+}
+//# sourceMappingURL=changeStream.js.map

package/dist/changeStream.js.map

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

package/dist/cloudflare.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Cloudflare-safe entry point for MongoLite.
+ *
+ * Import from `@semics-tech/mongolite/cloudflare` inside Cloudflare Workers / Durable Objects.
+ * This module does **not** import `better-sqlite3`, so it bundles cleanly with `wrangler`.
+ *
+ * ## Requirements
+ *
+ * - Enable **Node.js compatibility** in your Worker configuration (e.g. `nodejs_compat`
+ *   flag in `wrangler.toml`/`wrangler.jsonc`). The `ChangeStream` class depends on
+ *   Node's built-in `events` module, which requires this flag even if you don't use
+ *   change streams directly.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { DurableObject } from 'cloudflare:workers';
+ * import { MongoLite, CloudflareDurableObjectAdapter } from '@semics-tech/mongolite/cloudflare';
+ *
+ * export class MyDurableObject extends DurableObject {
+ *   private client: MongoLite;
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env);
+ *     this.client = new MongoLite(new CloudflareDurableObjectAdapter(ctx.storage.sql));
+ *     ctx.blockConcurrencyWhile(() => this.client.collection('users').ensureTable());
+ *   }
+ * }
+ * ```
+ */
+export { MongoLite } from './mongo-client.js';
+export type { MongoLiteBaseOptions } from './mongo-client.js';
+export { CloudflareDurableObjectAdapter } from './adapters/cloudflare.js';
+export type { SqlStorage, SqlStorageCursor, SqlStorageValue, } from './adapters/cloudflare.js';
+export type { IDatabaseAdapter } from './db.js';
+export { MongoLiteCollection } from './collection.js';
+export * from './types.js';
+export { ChangeStream } from './changeStream.js';
+export type { ChangeStreamDocument, ChangeStreamOptions, ChangeOperationType, } from './changeStream.js';

package/dist/cloudflare.js

@@ -0,0 +1,39 @@
+/**
+ * Cloudflare-safe entry point for MongoLite.
+ *
+ * Import from `@semics-tech/mongolite/cloudflare` inside Cloudflare Workers / Durable Objects.
+ * This module does **not** import `better-sqlite3`, so it bundles cleanly with `wrangler`.
+ *
+ * ## Requirements
+ *
+ * - Enable **Node.js compatibility** in your Worker configuration (e.g. `nodejs_compat`
+ *   flag in `wrangler.toml`/`wrangler.jsonc`). The `ChangeStream` class depends on
+ *   Node's built-in `events` module, which requires this flag even if you don't use
+ *   change streams directly.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { DurableObject } from 'cloudflare:workers';
+ * import { MongoLite, CloudflareDurableObjectAdapter } from '@semics-tech/mongolite/cloudflare';
+ *
+ * export class MyDurableObject extends DurableObject {
+ *   private client: MongoLite;
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env);
+ *     this.client = new MongoLite(new CloudflareDurableObjectAdapter(ctx.storage.sql));
+ *     ctx.blockConcurrencyWhile(() => this.client.collection('users').ensureTable());
+ *   }
+ * }
+ * ```
+ */
+// Core MongoLite class — accepts any IDatabaseAdapter, no better-sqlite3 dependency.
+export { MongoLite } from './mongo-client.js';
+// Cloudflare-specific adapter
+export { CloudflareDurableObjectAdapter } from './adapters/cloudflare.js';
+export { MongoLiteCollection } from './collection.js';
+export * from './types.js';
+// Change streams (requires nodejs_compat in Workers)
+export { ChangeStream } from './changeStream.js';
+//# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,qFAAqF;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,8BAA8B;AAC9B,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAS1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,YAAY,CAAC;AAE3B,qDAAqD;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}