mongo.do 0.1.0 → 0.1.1

package/dist/cli/mcp.js

@@ -1,418 +0,0 @@
-/**
- * CLI MCP Command
- *
- * Implements the `mcp` command for the MondoDB CLI.
- * Starts an MCP (Model Context Protocol) server that communicates via stdio.
- *
- * Features:
- * - --connection <url>: Connect to a remote MondoDB Worker
- * - --local <path>: Use a local SQLite database
- *
- * Usage:
- *   mongo.do mcp --connection https://my-worker.workers.dev
- *   mongo.do mcp --local ./data/local.db
- *
- * The MCP server exposes tools for AI agents to interact with the database:
- * - search: Query documents
- * - fetch: Retrieve full documents by ID
- * - do: Execute operations (when enabled)
- *
- * @module cli/mcp
- */
-import { createMcpServer } from '../mcp/server.js';
-import { createStdioTransport } from '../mcp/transport/stdio.js';
-import { RpcClient } from '../rpc/rpc-client.js';
-// Lazy import for LocalSQLiteBackend to avoid issues in non-Bun environments
-let LocalSQLiteBackend = null;
-async function getLocalSQLiteBackend() {
-    if (!LocalSQLiteBackend) {
-        try {
-            const module = await import('../wire/backend/local-sqlite.js');
-            LocalSQLiteBackend = module.LocalSQLiteBackend;
-        }
-        catch (error) {
-            throw new Error('Local SQLite backend requires Bun runtime. Use --connection for remote database access.');
-        }
-    }
-    return LocalSQLiteBackend;
-}
-/**
- * Register the MCP command with the CLI program
- *
- * @param program - The CLI program to register the command with
- */
-export function registerMcpCommand(program) {
-    program
-        .command('mcp')
-        .description('Start an MCP server for AI agents to interact with the database via stdio')
-        .option('-c, --connection <url>', 'Remote MondoDB Worker URL (e.g., https://my-worker.workers.dev)')
-        .option('-l, --local <path>', 'Local SQLite database path')
-        .action(async (options) => {
-        const controller = await startMcpServer(options);
-        // Handle graceful shutdown on SIGINT/SIGTERM
-        const handleSignal = async () => {
-            await controller.stop();
-            process.exit(0);
-        };
-        process.on('SIGINT', handleSignal);
-        process.on('SIGTERM', handleSignal);
-    });
-}
-/**
- * Validate that a string is a valid HTTP or HTTPS URL.
- *
- * @param urlString - The URL string to validate
- * @returns true if the URL is valid HTTP/HTTPS, false otherwise
- * @internal
- */
-function isValidUrl(urlString) {
-    try {
-        const url = new URL(urlString);
-        return url.protocol === 'http:' || url.protocol === 'https:';
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Start the MCP server with the given configuration.
- *
- * The server communicates via stdio using the Model Context Protocol (MCP).
- * It exposes database operations as tools that AI agents can invoke.
- *
- * @param options - Server configuration options
- * @returns Promise resolving to a controller for managing the server lifecycle
- * @throws {Error} If neither --connection nor --local is provided
- * @throws {Error} If both --connection and --local are provided
- * @throws {Error} If the connection URL is invalid
- *
- * @example
- * ```typescript
- * // Remote connection
- * const controller = await startMcpServer({
- *   connection: 'https://my-worker.workers.dev'
- * })
- *
- * // Local SQLite database
- * const controller = await startMcpServer({
- *   local: './data/local.db'
- * })
- *
- * // Graceful shutdown
- * await controller.stop()
- * ```
- */
-export async function startMcpServer(options) {
-    // Validate options
-    if (!options.connection && !options.local) {
-        throw new Error('Either --connection or --local option is required');
-    }
-    if (options.connection && options.local) {
-        throw new Error('Cannot use both --connection and --local options - they are mutually exclusive');
-    }
-    if (options.connection && !isValidUrl(options.connection)) {
-        throw new Error(`Invalid connection URL: ${options.connection}`);
-    }
-    // Create database access
-    const dbAccess = await createMcpDatabaseAccess({
-        connection: options.connection,
-        local: options.local,
-    });
-    // Create MCP server
-    const mcpServer = createMcpServer({
-        dbAccess,
-        name: 'mongo.do',
-        version: '1.0.0',
-    });
-    // Create stdio transport
-    const transport = createStdioTransport({
-        stdin: options.stdin ?? process.stdin,
-        stdout: options.stdout ?? process.stdout,
-        onMessage: async (request) => {
-            return await mcpServer.handleRequest(request);
-        },
-        onError: (error) => {
-            // Log errors to stderr to avoid interfering with MCP protocol on stdout
-            console.error('MCP transport error:', error.message);
-        },
-    });
-    // Start the transport
-    transport.start();
-    // Track running state
-    let running = true;
-    // Return controller
-    return {
-        get isRunning() {
-            return running && transport.isRunning;
-        },
-        async stop() {
-            if (!running) {
-                return;
-            }
-            running = false;
-            transport.close();
-        },
-    };
-}
-/**
- * Create a DatabaseAccess instance for the MCP server.
- *
- * This factory function creates the appropriate database access implementation
- * based on the provided options:
- * - Remote: Uses RPC client to communicate with a MondoDB Worker
- * - Local: Uses LocalSQLiteBackend for file-based storage (requires Bun)
- *
- * @param options - Connection options (either connection URL or local path)
- * @returns Promise resolving to a DatabaseAccess instance
- * @throws {Error} If neither connection nor local option is provided
- *
- * @example
- * ```typescript
- * // Remote database access
- * const dbAccess = await createMcpDatabaseAccess({
- *   connection: 'https://my-worker.workers.dev'
- * })
- *
- * // Local database access
- * const dbAccess = await createMcpDatabaseAccess({
- *   local: './data/local.db'
- * })
- * ```
- */
-export async function createMcpDatabaseAccess(options) {
-    if (options.connection) {
-        // Create remote database access via HTTP
-        return createRemoteDatabaseAccess(options.connection);
-    }
-    if (options.local) {
-        // Create local SQLite database access
-        return createLocalDatabaseAccess(options.local);
-    }
-    throw new Error('Either connection or local option must be provided');
-}
-/**
- * Create a DatabaseAccess implementation for remote MondoDB Workers.
- *
- * Uses RPC over HTTP to communicate with the remote worker.
- * All operations are proxied through the RPC client.
- *
- * @param connectionUrl - Base URL of the MondoDB Worker endpoint
- * @returns DatabaseAccess implementation for remote operations
- * @internal
- */
-function createRemoteDatabaseAccess(connectionUrl) {
-    const rpcClient = new RpcClient(connectionUrl + '/rpc');
-    return {
-        async findOne(collection, filter) {
-            const results = await this.find(collection, filter, { limit: 1 });
-            return results[0] ?? null;
-        },
-        async find(collection, filter, options) {
-            try {
-                const result = await rpcClient.call('find', ['test', collection, filter, options]);
-                return result?.documents ?? [];
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async insertOne(collection, document) {
-            try {
-                const result = await rpcClient.call('insertOne', ['test', collection, document]);
-                return result;
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async insertMany(collection, documents) {
-            try {
-                const result = await rpcClient.call('insertMany', ['test', collection, documents]);
-                const insertResult = result;
-                const ids = [];
-                if (insertResult.insertedIds instanceof Map) {
-                    for (const [, id] of insertResult.insertedIds) {
-                        ids.push(String(id));
-                    }
-                }
-                return { insertedIds: ids };
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async updateOne(collection, filter, update) {
-            try {
-                const result = await rpcClient.call('updateOne', ['test', collection, filter, update]);
-                return result;
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async updateMany(collection, filter, update) {
-            try {
-                const result = await rpcClient.call('updateMany', ['test', collection, filter, update]);
-                return result;
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async deleteOne(collection, filter) {
-            try {
-                const result = await rpcClient.call('deleteOne', ['test', collection, filter]);
-                return result;
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async deleteMany(collection, filter) {
-            try {
-                const result = await rpcClient.call('deleteMany', ['test', collection, filter]);
-                return result;
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async aggregate(collection, pipeline) {
-            try {
-                const result = await rpcClient.call('aggregate', ['test', collection, pipeline]);
-                return result?.documents ?? [];
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async countDocuments(collection, filter) {
-            try {
-                const result = await rpcClient.call('count', ['test', collection, filter ?? {}]);
-                return result;
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async listCollections() {
-            try {
-                const result = await rpcClient.call('listCollections', ['test']);
-                return result.map((c) => c.name);
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        async listDatabases() {
-            try {
-                const result = await rpcClient.call('listDatabases', []);
-                return result.map((d) => d.name);
-            }
-            catch (error) {
-                throw new Error(`Failed to connect to remote database: ${error instanceof Error ? error.message : 'Network error'}`);
-            }
-        },
-        getProxy() {
-            return this;
-        },
-    };
-}
-/**
- * Create a DatabaseAccess implementation for local SQLite database.
- *
- * Uses LocalSQLiteBackend which requires the Bun runtime.
- * The database file is created in the specified directory.
- *
- * @param localPath - Path to the local database file
- * @returns Promise resolving to a DatabaseAccess implementation
- * @throws {Error} If Bun runtime is not available
- * @internal
- */
-async function createLocalDatabaseAccess(localPath) {
-    // Extract directory from path for the backend
-    const path = await import('path');
-    const dataDir = path.dirname(localPath);
-    const BackendClass = await getLocalSQLiteBackend();
-    const backend = new BackendClass(dataDir);
-    // Default database name
-    const dbName = 'test';
-    const dbAccess = {
-        async findOne(collection, filter) {
-            const result = await backend.find(dbName, collection, {
-                filter,
-                limit: 1,
-            });
-            return result.documents[0] ?? null;
-        },
-        async find(collection, filter, options) {
-            // Build find options, only including defined properties
-            const findOptions = { filter };
-            if (options?.limit !== undefined)
-                findOptions.limit = options.limit;
-            if (options?.skip !== undefined)
-                findOptions.skip = options.skip;
-            if (options?.sort !== undefined)
-                findOptions.sort = options.sort;
-            if (options?.projection !== undefined)
-                findOptions.projection = options.projection;
-            const result = await backend.find(dbName, collection, findOptions);
-            return result.documents;
-        },
-        async insertOne(collection, document) {
-            const result = await backend.insertOne(dbName, collection, document);
-            const insertedId = result.insertedIds.get(0);
-            return { insertedId: String(insertedId) };
-        },
-        async insertMany(collection, documents) {
-            const result = await backend.insertMany(dbName, collection, documents);
-            const ids = [];
-            for (const [, id] of result.insertedIds) {
-                ids.push(String(id));
-            }
-            return { insertedIds: ids };
-        },
-        async updateOne(collection, filter, update) {
-            const result = await backend.updateOne(dbName, collection, filter, update);
-            return {
-                matchedCount: result.matchedCount,
-                modifiedCount: result.modifiedCount,
-            };
-        },
-        async updateMany(collection, filter, update) {
-            const result = await backend.updateMany(dbName, collection, filter, update);
-            return {
-                matchedCount: result.matchedCount,
-                modifiedCount: result.modifiedCount,
-            };
-        },
-        async deleteOne(collection, filter) {
-            const result = await backend.deleteOne(dbName, collection, filter);
-            return { deletedCount: result.deletedCount };
-        },
-        async deleteMany(collection, filter) {
-            const result = await backend.deleteMany(dbName, collection, filter);
-            return { deletedCount: result.deletedCount };
-        },
-        async aggregate(collection, pipeline) {
-            const result = await backend.aggregate(dbName, collection, pipeline);
-            return result.documents;
-        },
-        async countDocuments(collection, filter) {
-            return await backend.count(dbName, collection, filter);
-        },
-        async listCollections() {
-            const collections = await backend.listCollections(dbName);
-            return collections.map((c) => c.name);
-        },
-        async listDatabases() {
-            const databases = await backend.listDatabases();
-            return databases.map((d) => d.name);
-        },
-        getProxy() {
-            return dbAccess;
-        },
-    };
-    return dbAccess;
-}
-//# sourceMappingURL=mcp.js.map

package/dist/cli/mcp.js.map

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

package/dist/cli/server.d.ts

@@ -1,179 +0,0 @@
-/**
- * CLI Server Module
- *
- * Enhanced CLI for MondoDB wire protocol server with support for
- * local SQLite backend and remote Cloudflare Workers proxy.
- *
- * @module cli/server
- *
- * @example
- * ```typescript
- * import { parseArgs, runServer, printStartupMessage } from './server'
- *
- * const options = parseArgs(process.argv.slice(2))
- * if (options.help) {
- *   printHelp()
- *   process.exit(0)
- * }
- *
- * const controller = await runServer(options)
- * printStartupMessage(options)
- *
- * // Later, gracefully shutdown
- * await controller.stop()
- * ```
- */
-import type { MondoBackend } from '../wire/backend/interface.js';
-/**
- * Command-line options for the MondoDB server.
- */
-export interface CLIOptions {
-    /** Port number to listen on (1-65535) */
-    port: number;
-    /** Host address to bind to (e.g., 'localhost', '0.0.0.0') */
-    host: string;
-    /** Directory path for local SQLite data storage */
-    dataDir: string;
-    /** Optional URL for remote Cloudflare Workers endpoint */
-    remote?: string;
-    /** Enable verbose logging output */
-    verbose: boolean;
-    /** Display help message and exit */
-    help: boolean;
-}
-/**
- * Controller interface for managing a running server instance.
- * Provides methods and properties to monitor and control the server lifecycle.
- */
-export interface ServerController {
-    /** Gracefully stop the server and close all connections */
-    stop(): Promise<void>;
-    /** Whether the server is currently running */
-    isRunning: boolean;
-    /** Whether the server is accepting new connections */
-    isAcceptingConnections: boolean;
-    /** Number of currently active client connections */
-    activeConnections: number;
-    /** The address the server is bound to */
-    address: {
-        host: string;
-        port: number;
-    };
-}
-/**
- * Parse command-line arguments into a CLIOptions object.
- *
- * Supports both long-form (--port) and short-form (-p) arguments.
- * Unknown arguments are silently ignored.
- *
- * @param args - Array of command-line arguments (typically process.argv.slice(2))
- * @returns Parsed CLI options with defaults applied
- *
- * @example
- * ```typescript
- * const options = parseArgs(['--port', '27018', '--verbose'])
- * // options.port === 27018
- * // options.verbose === true
- * ```
- */
-export declare function parseArgs(args: string[]): CLIOptions;
-/**
- * Validation result returned by validateOptions.
- */
-export interface ValidationResult {
-    /** Whether all options are valid */
-    valid: boolean;
-    /** Array of error messages (empty if valid) */
-    errors: string[];
-}
-/**
- * Validate CLI options and return a result with all validation errors.
- *
- * Validates:
- * - Port is a valid integer between 1 and 65535
- * - Host is a non-empty string
- * - Data directory is a non-empty string (unless in remote mode)
- * - Remote URL (if provided) is a valid HTTP/HTTPS URL
- *
- * @param options - CLI options to validate
- * @returns ValidationResult with valid boolean and errors array
- *
- * @example
- * ```typescript
- * const result = validateOptions({ port: 0, host: 'localhost', ... })
- * if (!result.valid) {
- *   console.error(result.errors.join('\n'))
- * }
- * ```
- */
-export declare function validateOptions(options: CLIOptions): ValidationResult;
-/**
- * Create the appropriate storage backend based on CLI options.
- *
- * - If `options.remote` is set, creates a WorkersProxyBackend that forwards
- *   requests to a remote Cloudflare Workers endpoint.
- * - Otherwise, creates a LocalSQLiteBackend for local file-based storage.
- *
- * @param options - CLI options containing backend configuration
- * @returns Promise resolving to the configured backend instance
- *
- * @example
- * ```typescript
- * // Local backend
- * const local = await createBackend({ dataDir: './data', ... })
- *
- * // Remote backend
- * const remote = await createBackend({ remote: 'https://my-worker.dev', ... })
- * ```
- */
-export declare function createBackend(options: CLIOptions): Promise<MondoBackend>;
-/**
- * Print usage help message to stdout.
- * Displays all available command-line options with descriptions and examples.
- */
-export declare function printHelp(): void;
-/**
- * Print server startup message to stdout.
- * Displays connection string and backend mode information.
- *
- * @param options - CLI options used to start the server
- */
-export declare function printStartupMessage(options: CLIOptions): void;
-/**
- * Print server shutdown message to stdout.
- * Called after graceful server shutdown completes.
- */
-export declare function printShutdownMessage(): void;
-/**
- * Start the MongoDB wire protocol server with the given options.
- *
- * This is the main entry point for starting a MondoDB server. It:
- * 1. Validates the provided options
- * 2. Creates the appropriate backend (local or remote)
- * 3. Starts the wire protocol server
- * 4. Sets up signal handlers for graceful shutdown
- *
- * @param options - Server configuration options
- * @param backend - Optional pre-configured backend (for testing)
- * @returns Promise resolving to a ServerController for managing the server
- * @throws {Error} If options are invalid or server fails to start
- *
- * @example
- * ```typescript
- * const controller = await runServer({
- *   port: 27017,
- *   host: 'localhost',
- *   dataDir: './data',
- *   verbose: false,
- *   help: false,
- * })
- *
- * // Check server status
- * console.log(controller.isRunning) // true
- *
- * // Graceful shutdown
- * await controller.stop()
- * ```
- */
-export declare function runServer(options: CLIOptions, backend?: MondoBackend): Promise<ServerController>;
-//# sourceMappingURL=server.d.ts.map

package/dist/cli/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/cli/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AA4BhE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAA;IAClB,sDAAsD;IACtD,sBAAsB,EAAE,OAAO,CAAA;IAC/B,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACxC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiGpD;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,CA8CrE;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAW9E;AAMD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAkChC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAY7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAqG3B"}