mongo.do 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env bun
+/**
+ * MondoDB CLI Entry Point
+ *
+ * Main entry point for the MondoDB command-line interface.
+ * Provides a MongoDB-compatible database backed by SQLite or Cloudflare Workers.
+ *
+ * Usage:
+ *   mongo.do [options]
+ *   bun run src/cli/index.ts [options]
+ *
+ * @module cli
+ */
+import { version } from '../../package.json';
+import { parseArgs, validateOptions, printHelp, printShutdownMessage, runServer, } from './server.js';
+// ============================================================================
+// ANSI Color Codes (no external dependencies)
+// ============================================================================
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    // Foreground colors
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+};
+/**
+ * Check if stdout supports colors
+ */
+function supportsColor() {
+    // Check for NO_COLOR environment variable
+    if (process.env.NO_COLOR !== undefined) {
+        return false;
+    }
+    // Check for FORCE_COLOR environment variable
+    if (process.env.FORCE_COLOR !== undefined) {
+        return true;
+    }
+    // Check if running in a TTY
+    return process.stdout.isTTY ?? false;
+}
+const useColors = supportsColor();
+/**
+ * Apply color to text if colors are supported
+ */
+function colorize(text, color) {
+    if (!useColors)
+        return text;
+    return `${colors[color]}${text}${colors.reset}`;
+}
+// ============================================================================
+// Output Functions
+// ============================================================================
+/**
+ * Print the ASCII banner for MondoDB
+ */
+function printBanner() {
+    const banner = `
+${colorize('MondoDB', 'cyan')} ${colorize(`v${version}`, 'dim')}
+${colorize('MongoDB-compatible database backed by SQLite', 'dim')}
+`;
+    console.log(banner);
+}
+/**
+ * Print version information
+ */
+function printVersion() {
+    console.log(`mongo.do version ${version}`);
+}
+/**
+ * Print an error message
+ */
+function printError(message) {
+    console.error(`${colorize('error:', 'red')} ${message}`);
+}
+/**
+ * Print enhanced startup message with colors
+ */
+function printColoredStartupMessage(options) {
+    const connectionString = `mongodb://${options.host}:${options.port}`;
+    console.log('');
+    if (options.remote) {
+        console.log(`${colorize('Mode:', 'bold')} ${colorize('Proxy/Remote', 'magenta')}`);
+        console.log(`${colorize('Connect:', 'bold')} ${colorize(connectionString, 'cyan')}`);
+        console.log(`${colorize('Proxying to:', 'bold')} ${colorize(options.remote, 'blue')}`);
+    }
+    else {
+        console.log(`${colorize('Mode:', 'bold')} ${colorize('Local/SQLite', 'green')}`);
+        console.log(`${colorize('Connect:', 'bold')} ${colorize(connectionString, 'cyan')}`);
+        console.log(`${colorize('Data directory:', 'bold')} ${options.dataDir}`);
+    }
+    if (options.verbose) {
+        console.log(`${colorize('Verbose logging:', 'bold')} ${colorize('enabled', 'yellow')}`);
+    }
+    console.log('');
+    console.log(`${colorize('Ready to accept connections.', 'green')} Press ${colorize('Ctrl+C', 'bold')} to stop.`);
+    console.log('');
+}
+/**
+ * Parse command line arguments with version flag support
+ */
+function parseArgsExtended(args) {
+    const baseOptions = parseArgs(args);
+    // Check for version flag
+    const hasVersion = args.some((arg) => arg === '--version' || arg === '-V');
+    return {
+        ...baseOptions,
+        version: hasVersion,
+    };
+}
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Main CLI function
+ */
+async function main() {
+    try {
+        // Parse arguments
+        const options = parseArgsExtended(process.argv.slice(2));
+        // Handle --version flag
+        if (options.version) {
+            printVersion();
+            process.exit(0);
+        }
+        // Handle --help flag
+        if (options.help) {
+            printHelp();
+            process.exit(0);
+        }
+        // Validate options
+        try {
+            validateOptions(options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                printError(error.message);
+            }
+            else {
+                printError('Invalid options');
+            }
+            console.log('');
+            console.log(`Run ${colorize('mongo.do --help', 'cyan')} for usage information.`);
+            process.exit(1);
+        }
+        // Print banner
+        printBanner();
+        // Start the server
+        const controller = await runServer(options);
+        // Print startup message
+        printColoredStartupMessage(options);
+        // Handle graceful shutdown
+        const shutdown = async (signal) => {
+            console.log('');
+            console.log(`${colorize(`Received ${signal}, shutting down...`, 'yellow')}`);
+            try {
+                await controller.stop();
+                printShutdownMessage();
+                process.exit(0);
+            }
+            catch (error) {
+                printError(`Error during shutdown: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                process.exit(1);
+            }
+        };
+        // Register signal handlers
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        // Handle uncaught exceptions
+        process.on('uncaughtException', (error) => {
+            printError(`Uncaught exception: ${error.message}`);
+            if (options.verbose) {
+                console.error(error.stack);
+            }
+            process.exit(1);
+        });
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', (reason) => {
+            printError(`Unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}`);
+            if (options.verbose && reason instanceof Error) {
+                console.error(reason.stack);
+            }
+            process.exit(1);
+        });
+    }
+    catch (error) {
+        // Handle startup errors gracefully
+        if (error instanceof Error) {
+            printError(error.message);
+            // Provide helpful hints for common errors
+            if (error.message.includes('EADDRINUSE')) {
+                console.log('');
+                console.log(`${colorize('Hint:', 'yellow')} The port is already in use. Try a different port with ${colorize('--port', 'cyan')}.`);
+            }
+            else if (error.message.includes('EACCES')) {
+                console.log('');
+                console.log(`${colorize('Hint:', 'yellow')} Permission denied. Ports below 1024 require root privileges.`);
+                console.log(`      Try using a port number above 1024, e.g., ${colorize('--port=27017', 'cyan')}.`);
+            }
+            else if (error.message.includes('Failed to connect to remote')) {
+                console.log('');
+                console.log(`${colorize('Hint:', 'yellow')} Could not connect to the remote worker.`);
+                console.log(`      Check that the URL is correct and the worker is running.`);
+            }
+        }
+        else {
+            printError('An unexpected error occurred');
+        }
+        process.exit(1);
+    }
+}
+// Run the CLI
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/mcp.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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 type { DatabaseAccess } from '../mcp/types.js';
+/**
+ * Options for the MCP command
+ */
+export interface McpCommandOptions {
+    /** Remote connection URL (e.g., https://my-worker.workers.dev) */
+    connection?: string;
+    /** Local database file path */
+    local?: string;
+    /** Custom stdin stream (for testing) */
+    stdin?: NodeJS.ReadableStream;
+    /** Custom stdout stream (for testing) */
+    stdout?: NodeJS.WritableStream;
+}
+/**
+ * Controller for managing the MCP server lifecycle
+ */
+export interface McpServerController {
+    /** Whether the server is currently running */
+    readonly isRunning: boolean;
+    /** Stop the MCP server */
+    stop(): Promise<void>;
+}
+/**
+ * Program interface for command registration
+ * Compatible with Commander.js Command interface
+ */
+export interface McpProgram {
+    command(name: string): McpProgram;
+    description(desc: string): McpProgram;
+    option(flags: string, description?: string, defaultValue?: unknown): McpProgram;
+    action(fn: (...args: unknown[]) => void | Promise<void>): McpProgram;
+}
+/**
+ * Register the MCP command with the CLI program
+ *
+ * @param program - The CLI program to register the command with
+ */
+export declare function registerMcpCommand(program: McpProgram): void;
+/**
+ * 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 declare function startMcpServer(options: McpCommandOptions): Promise<McpServerController>;
+/**
+ * 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 declare function createMcpDatabaseAccess(options: {
+    connection?: string | undefined;
+    local?: string | undefined;
+}): Promise<DatabaseAccess>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,iBAAiB,CAAA;AAoBlE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0BAA0B;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC/E,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAA;CACrE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAkB5D;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4D7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvE,OAAO,CAAC,cAAc,CAAC,CAYzB"}