mongo.do 0.1.0 → 0.1.1

package/dist/cli/server.js

@@ -1,441 +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 { WorkersProxyBackend } from '../wire/backend/workers-proxy.js';
-// Lazy imports for Bun-specific modules (deferred to avoid bun:sqlite in Node tests)
-let LocalSQLiteBackend;
-let WireProtocolServer;
-/**
- * Lazy load Bun-specific modules to avoid issues in Node.js environments.
- * These modules depend on bun:sqlite which is not available in Node.
- *
- * @internal
- */
-async function loadBunModules() {
-    if (!LocalSQLiteBackend) {
-        const localModule = await import('../wire/backend/local-sqlite.js');
-        LocalSQLiteBackend = localModule.LocalSQLiteBackend;
-    }
-    if (!WireProtocolServer) {
-        const serverModule = await import('../wire/server.js');
-        WireProtocolServer = serverModule.WireProtocolServer;
-    }
-}
-// ============================================================================
-// Argument Parsing
-// ============================================================================
-/**
- * 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 function parseArgs(args) {
-    const options = {
-        port: 27017,
-        host: 'localhost',
-        dataDir: './data',
-        verbose: false,
-        help: false,
-    };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (!arg)
-            continue;
-        // Handle --help / -h
-        if (arg === '--help' || arg === '-h') {
-            options.help = true;
-            continue;
-        }
-        // Handle --verbose / -v
-        if (arg === '--verbose' || arg === '-v') {
-            options.verbose = true;
-            continue;
-        }
-        // Handle --port / -p
-        if (arg.startsWith('--port=')) {
-            options.port = parseInt(arg.slice(7), 10);
-            continue;
-        }
-        if (arg.startsWith('-p=')) {
-            options.port = parseInt(arg.slice(3), 10);
-            continue;
-        }
-        if (arg === '--port' || arg === '-p') {
-            const nextArg = args[++i];
-            if (nextArg) {
-                options.port = parseInt(nextArg, 10);
-            }
-            continue;
-        }
-        // Handle --host / -H (note: -h is for help)
-        if (arg.startsWith('--host=')) {
-            options.host = arg.slice(7);
-            continue;
-        }
-        if (arg.startsWith('-H=')) {
-            options.host = arg.slice(3);
-            continue;
-        }
-        if (arg === '--host' || arg === '-H') {
-            const nextArg = args[++i];
-            if (nextArg) {
-                options.host = nextArg;
-            }
-            continue;
-        }
-        // Handle --data / -d
-        if (arg.startsWith('--data=')) {
-            options.dataDir = arg.slice(7);
-            continue;
-        }
-        if (arg.startsWith('-d=')) {
-            options.dataDir = arg.slice(3);
-            continue;
-        }
-        if (arg === '--data' || arg === '-d') {
-            const nextArg = args[++i];
-            if (nextArg) {
-                options.dataDir = nextArg;
-            }
-            continue;
-        }
-        // Handle --remote / -r
-        if (arg.startsWith('--remote=')) {
-            options.remote = arg.slice(9);
-            continue;
-        }
-        if (arg.startsWith('-r=')) {
-            options.remote = arg.slice(3);
-            continue;
-        }
-        if (arg === '--remote' || arg === '-r') {
-            const nextArg = args[++i];
-            if (nextArg) {
-                options.remote = nextArg;
-            }
-            continue;
-        }
-        // Unknown options are ignored
-    }
-    return options;
-}
-/**
- * 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 function validateOptions(options) {
-    const errors = [];
-    // Validate port
-    if (typeof options.port !== 'number' ||
-        isNaN(options.port) ||
-        !Number.isInteger(options.port) ||
-        options.port < 1 ||
-        options.port > 65535) {
-        errors.push(`Invalid port: ${options.port}. Port must be an integer between 1 and 65535.`);
-    }
-    // Validate host
-    if (!options.host || typeof options.host !== 'string' || options.host.trim() === '') {
-        errors.push('Invalid host: host cannot be empty');
-    }
-    // Validate dataDir only if not in remote mode
-    if (!options.remote) {
-        if (!options.dataDir || typeof options.dataDir !== 'string' || options.dataDir.trim() === '') {
-            errors.push('Invalid data directory: path cannot be empty');
-        }
-    }
-    // Validate remote URL if provided
-    if (options.remote !== undefined) {
-        if (!options.remote || typeof options.remote !== 'string' || options.remote.trim() === '') {
-            errors.push('Invalid remote URL: URL cannot be empty. Use https://your-worker.workers.dev');
-        }
-        else {
-            try {
-                const url = new URL(options.remote);
-                if (url.protocol !== 'http:' && url.protocol !== 'https:') {
-                    errors.push(`Invalid remote URL: protocol must be http or https, got "${url.protocol.slice(0, -1)}"`);
-                }
-            }
-            catch {
-                errors.push(`Invalid remote URL: "${options.remote}" is not a valid URL. Use https://your-worker.workers.dev`);
-            }
-        }
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-    };
-}
-// ============================================================================
-// Backend Creation
-// ============================================================================
-/**
- * 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 async function createBackend(options) {
-    if (options.remote) {
-        // Use WorkersProxyBackend for remote mode
-        return new WorkersProxyBackend({
-            endpoint: options.remote,
-        });
-    }
-    // Use LocalSQLiteBackend for local mode (lazy load Bun modules)
-    await loadBunModules();
-    return new LocalSQLiteBackend(options.dataDir);
-}
-// ============================================================================
-// Output Functions
-// ============================================================================
-/**
- * Print usage help message to stdout.
- * Displays all available command-line options with descriptions and examples.
- */
-export function printHelp() {
-    console.log(`
-Usage: mongo.do serve [options]
-
-Start a MongoDB wire protocol server backed by SQLite.
-
-Options:
-  -p, --port <port>     Port to listen on (default: 27017)
-  -H, --host <host>     Host to bind to (default: localhost)
-  -d, --data <path>     Data directory for local SQLite storage (default: ./data)
-  -r, --remote <url>    Proxy/forward to remote Cloudflare Workers endpoint
-  -v, --verbose         Enable verbose logging
-  -V, --version         Show version number
-  -h, --help            Show this help message
-
-Examples:
-  # Start local server on default port
-  mongo.do serve
-
-  # Start on custom port with verbose logging
-  mongo.do serve --port 27018 --verbose
-
-  # Bind to all interfaces
-  mongo.do serve --host 0.0.0.0
-
-  # Use custom data directory
-  mongo.do serve --data /var/lib/mongodo
-
-  # Proxy to remote Cloudflare Workers
-  mongo.do serve --remote https://my-mongo-do.workers.dev
-
-  # Combine options
-  mongo.do serve --port 27018 --host 0.0.0.0 --verbose
-`);
-}
-/**
- * Print server startup message to stdout.
- * Displays connection string and backend mode information.
- *
- * @param options - CLI options used to start the server
- */
-export function printStartupMessage(options) {
-    const connectionString = `mongodb://${options.host}:${options.port}`;
-    if (options.remote) {
-        console.log(`MondoDB server started in proxy/remote mode`);
-        console.log(`  Connect: ${connectionString}`);
-        console.log(`  Proxying to: ${options.remote}`);
-    }
-    else {
-        console.log(`MondoDB server started in local/SQLite mode`);
-        console.log(`  Connect: ${connectionString}`);
-        console.log(`  Data directory: ${options.dataDir}`);
-    }
-}
-/**
- * Print server shutdown message to stdout.
- * Called after graceful server shutdown completes.
- */
-export function printShutdownMessage() {
-    console.log('MondoDB server gracefully shutdown. Clean stop complete.');
-}
-// ============================================================================
-// Server Runner
-// ============================================================================
-/**
- * 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 async function runServer(options, backend) {
-    // Validate options first
-    const validationResult = validateOptions(options);
-    if (!validationResult.valid) {
-        throw new Error(validationResult.errors[0]);
-    }
-    // Create backend if not provided
-    const serverBackend = backend ?? await createBackend(options);
-    // Test remote connection if using remote backend
-    if (options.remote && !backend) {
-        try {
-            // Try to list databases to verify connection
-            await serverBackend.listDatabases();
-        }
-        catch (e) {
-            throw new Error(`Failed to connect to remote worker: ${options.remote}. Network unreachable or worker not responding.`);
-        }
-    }
-    // Lazy load WireProtocolServer
-    await loadBunModules();
-    // Create and start the wire protocol server
-    const wireServer = new WireProtocolServer(serverBackend, {
-        port: options.port,
-        host: options.host,
-        verbose: options.verbose,
-    });
-    let running = false;
-    let acceptingConnections = false;
-    let connectionCount = 0;
-    // Signal handlers
-    const handleSignal = async () => {
-        if (running) {
-            await controller.stop();
-        }
-    };
-    const sigintHandler = handleSignal;
-    const sigtermHandler = handleSignal;
-    // Controller object
-    const controller = {
-        get isRunning() {
-            return running;
-        },
-        get isAcceptingConnections() {
-            return acceptingConnections;
-        },
-        get activeConnections() {
-            return connectionCount;
-        },
-        get address() {
-            return { host: options.host, port: options.port };
-        },
-        async stop() {
-            if (!running)
-                return;
-            running = false;
-            acceptingConnections = false;
-            connectionCount = 0;
-            // Stop the wire server
-            await wireServer.stop();
-            // Clean up backend if it has a close method
-            if ('close' in serverBackend && typeof serverBackend.close === 'function') {
-                await serverBackend.close();
-            }
-            // Remove signal handlers
-            process.removeListener('SIGINT', sigintHandler);
-            process.removeListener('SIGTERM', sigtermHandler);
-        },
-    };
-    // Register signal handlers
-    process.on('SIGINT', sigintHandler);
-    process.on('SIGTERM', sigtermHandler);
-    // Start the server
-    try {
-        await wireServer.start();
-        running = true;
-        acceptingConnections = true;
-    }
-    catch (e) {
-        // Clean up signal handlers on failure
-        process.removeListener('SIGINT', sigintHandler);
-        process.removeListener('SIGTERM', sigtermHandler);
-        // Rethrow with better error message for port in use
-        if (e instanceof Error && e.message.includes('EADDRINUSE')) {
-            throw new Error(`Port ${options.port} is already in use (EADDRINUSE)`);
-        }
-        throw e;
-    }
-    return controller;
-}
-//# sourceMappingURL=server.js.map

package/dist/cli/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/cli/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAEtE,qFAAqF;AACrF,IAAI,kBAAuF,CAAA;AAC3F,IAAI,kBAAyE,CAAA;AAE7E;;;;;GAKG;AACH,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAA;QACnE,kBAAkB,GAAG,WAAW,CAAC,kBAAkB,CAAA;IACrD,CAAC;IACD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;QACtD,kBAAkB,GAAG,YAAY,CAAC,kBAAkB,CAAA;IACtD,CAAC;AACH,CAAC;AAyCD,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,OAAO,GAAe;QAC1B,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;KACZ,CAAA;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,CAAC,GAAG;YAAE,SAAQ;QAElB,qBAAqB;QACrB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA;YACnB,SAAQ;QACV,CAAC;QAED,wBAAwB;QACxB,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;YACtB,SAAQ;QACV,CAAC;QAED,qBAAqB;QACrB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;YACtC,CAAC;YACD,SAAQ;QACV,CAAC;QAED,4CAA4C;QAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,GAAG,OAAO,CAAA;YACxB,CAAC;YACD,SAAQ;QACV,CAAC;QAED,qBAAqB;QACrB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC9B,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC9B,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,GAAG,OAAO,CAAA;YAC3B,CAAC;YACD,SAAQ;QACV,CAAC;QAED,uBAAuB;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC7B,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC7B,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,MAAM,GAAG,OAAO,CAAA;YAC1B,CAAC;YACD,SAAQ;QACV,CAAC;QAED,8BAA8B;IAChC,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,gBAAgB;IAChB,IACE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACnB,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/B,OAAO,CAAC,IAAI,GAAG,CAAC;QAChB,OAAO,CAAC,IAAI,GAAG,KAAK,EACpB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,gDAAgD,CAAC,CAAA;IAC5F,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpF,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;IACnD,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7F,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1F,MAAM,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAA;QAC7F,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBACnC,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC1D,MAAM,CAAC,IAAI,CAAC,4DAA4D,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;gBACvG,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,MAAM,2DAA2D,CAAC,CAAA;YAChH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAA;AACH,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAmB;IACrD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,0CAA0C;QAC1C,OAAO,IAAI,mBAAmB,CAAC;YAC7B,QAAQ,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC,CAAA;IACJ,CAAC;IAED,gEAAgE;IAChE,MAAM,cAAc,EAAE,CAAA;IACtB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAChD,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCb,CAAC,CAAA;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmB;IACrD,MAAM,gBAAgB,GAAG,aAAa,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA;IAEpE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAA;QAC1D,OAAO,CAAC,GAAG,CAAC,cAAc,gBAAgB,EAAE,CAAC,CAAA;QAC7C,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACjD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAA;QAC1D,OAAO,CAAC,GAAG,CAAC,cAAc,gBAAgB,EAAE,CAAC,CAAA;QAC7C,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IACrD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAA;AACzE,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAmB,EACnB,OAAsB;IAEtB,yBAAyB;IACzB,MAAM,gBAAgB,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,iCAAiC;IACjC,MAAM,aAAa,GAAG,OAAO,IAAI,MAAM,aAAa,CAAC,OAAO,CAAC,CAAA;IAE7D,iDAAiD;IACjD,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,6CAA6C;YAC7C,MAAM,aAAa,CAAC,aAAa,EAAE,CAAA;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,CAAC,MAAM,iDAAiD,CAAC,CAAA;QACzH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,cAAc,EAAE,CAAA;IAEtB,4CAA4C;IAC5C,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,aAAa,EAAE;QACvD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAA;IAEF,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,oBAAoB,GAAG,KAAK,CAAA;IAChC,IAAI,eAAe,GAAG,CAAC,CAAA;IAEvB,kBAAkB;IAClB,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;QAC9B,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,UAAU,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;IACH,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,YAAY,CAAA;IAClC,MAAM,cAAc,GAAG,YAAY,CAAA;IAEnC,oBAAoB;IACpB,MAAM,UAAU,GAAqB;QACnC,IAAI,SAAS;YACX,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,sBAAsB;YACxB,OAAO,oBAAoB,CAAA;QAC7B,CAAC;QACD,IAAI,iBAAiB;YACnB,OAAO,eAAe,CAAA;QACxB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAA;QACnD,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,OAAO,GAAG,KAAK,CAAA;YACf,oBAAoB,GAAG,KAAK,CAAA;YAC5B,eAAe,GAAG,CAAC,CAAA;YAEnB,uBAAuB;YACvB,MAAM,UAAU,CAAC,IAAI,EAAE,CAAA;YAEvB,4CAA4C;YAC5C,IAAI,OAAO,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC1E,MAAO,aAAgD,CAAC,KAAK,EAAE,CAAA;YACjE,CAAC;YAED,yBAAyB;YACzB,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;YAC/C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QACnD,CAAC;KACF,CAAA;IAED,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;IACnC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;IAErC,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,EAAE,CAAA;QACxB,OAAO,GAAG,IAAI,CAAA;QACd,oBAAoB,GAAG,IAAI,CAAA;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,sCAAsC;QACtC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;QAC/C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QAEjD,oDAAoD;QACpD,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,IAAI,iCAAiC,CAAC,CAAA;QACxE,CAAC;QACD,MAAM,CAAC,CAAA;IACT,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/client/Collection.d.ts

@@ -1,199 +0,0 @@
-/**
- * Collection - MongoDB-compatible collection interface
- *
- * Provides CRUD operations on documents within a collection.
- */
-import type { Env } from '../types/env';
-import type { Document, Filter, UpdateFilter, FindOptions, InsertOneResult, InsertManyResult, UpdateResult, DeleteResult, AggregationStage, AggregateOptions, IndexSpecification } from '../types/mongodb';
-import { HttpFindCursor, HttpAggregationCursor } from './http-cursor';
-/**
- * Collection class
- *
- * Provides MongoDB-compatible operations on a collection of documents.
- */
-export declare class Collection<TDocument extends Document = Document> {
-    private env;
-    private dbName;
-    private collectionName;
-    /**
-     * Create a new Collection instance
-     *
-     * @param env - Cloudflare Workers environment with MONDO_DATABASE binding
-     * @param dbName - The name of the database
-     * @param collectionName - The name of the collection
-     */
-    constructor(env: Env, dbName: string, collectionName: string);
-    /**
-     * Get the Durable Object stub for this collection's database
-     */
-    private getStub;
-    /**
-     * Make a request to the Durable Object
-     */
-    private request;
-    /**
-     * Insert a single document
-     *
-     * @param doc - The document to insert
-     * @returns InsertOneResult with the inserted document's _id
-     */
-    insertOne(doc: Omit<TDocument, '_id'> | TDocument): Promise<InsertOneResult>;
-    /**
-     * Insert multiple documents
-     *
-     * @param docs - Array of documents to insert
-     * @returns InsertManyResult with count and inserted IDs
-     */
-    insertMany(docs: Array<Omit<TDocument, '_id'> | TDocument>): Promise<InsertManyResult>;
-    /**
-     * Find a single document matching the filter
-     *
-     * @param filter - Query filter
-     * @param options - Find options (projection, sort, etc.)
-     * @returns The matching document or null
-     */
-    findOne(filter?: Filter<TDocument>, options?: FindOptions<TDocument>): Promise<TDocument | null>;
-    /**
-     * Find all documents matching the filter
-     *
-     * Returns a cursor that supports:
-     * - Async iteration with `for await (const doc of cursor)`
-     * - Converting to array with `await cursor.toArray()`
-     * - Chainable modifiers: sort(), limit(), skip(), project()
-     *
-     * @param filter - Query filter
-     * @param options - Find options (projection, sort, skip, limit, etc.)
-     * @returns HttpFindCursor for iterating over results
-     *
-     * @example
-     * ```typescript
-     * // Using toArray
-     * const docs = await collection.find({ status: 'active' }).toArray()
-     *
-     * // Using async iterator
-     * for await (const doc of collection.find({ status: 'active' })) {
-     *   console.log(doc)
-     * }
-     *
-     * // Using chainable modifiers
-     * const docs = await collection.find({})
-     *   .sort({ name: 1 })
-     *   .limit(10)
-     *   .skip(5)
-     *   .toArray()
-     * ```
-     */
-    find(filter?: Filter<TDocument>, options?: FindOptions<TDocument>): HttpFindCursor<TDocument>;
-    /**
-     * Update a single document matching the filter
-     *
-     * @param filter - Query filter
-     * @param update - Update operations
-     * @returns UpdateResult with match and modify counts
-     */
-    updateOne(filter: Filter<TDocument>, update: UpdateFilter<TDocument>): Promise<UpdateResult>;
-    /**
-     * Update all documents matching the filter
-     *
-     * @param filter - Query filter
-     * @param update - Update operations
-     * @returns UpdateResult with match and modify counts
-     */
-    updateMany(filter: Filter<TDocument>, update: UpdateFilter<TDocument>): Promise<UpdateResult>;
-    /**
-     * Replace a single document matching the filter
-     *
-     * @param filter - Query filter
-     * @param replacement - The replacement document
-     * @returns UpdateResult
-     */
-    replaceOne(filter: Filter<TDocument>, replacement: Omit<TDocument, '_id'>): Promise<UpdateResult>;
-    /**
-     * Delete a single document matching the filter
-     *
-     * @param filter - Query filter
-     * @returns DeleteResult with deleted count
-     */
-    deleteOne(filter: Filter<TDocument>): Promise<DeleteResult>;
-    /**
-     * Delete all documents matching the filter
-     *
-     * @param filter - Query filter
-     * @returns DeleteResult with deleted count
-     */
-    deleteMany(filter: Filter<TDocument>): Promise<DeleteResult>;
-    /**
-     * Count documents matching the filter
-     *
-     * @param filter - Query filter
-     * @returns Number of matching documents
-     */
-    countDocuments(filter?: Filter<TDocument>): Promise<number>;
-    /**
-     * Get estimated document count (faster but less accurate)
-     *
-     * @returns Estimated number of documents
-     */
-    estimatedDocumentCount(): Promise<number>;
-    /**
-     * Execute an aggregation pipeline
-     *
-     * Returns a cursor that supports:
-     * - Async iteration with `for await (const doc of cursor)`
-     * - Converting to array with `await cursor.toArray()`
-     * - forEach iteration with `await cursor.forEach(callback)`
-     *
-     * @param pipeline - Array of aggregation stages
-     * @param options - Aggregation options
-     * @returns HttpAggregationCursor for iterating over results
-     *
-     * @example
-     * ```typescript
-     * // Using toArray
-     * const results = await collection.aggregate([
-     *   { $match: { status: 'active' } },
-     *   { $group: { _id: '$category', count: { $sum: 1 } } }
-     * ]).toArray()
-     *
-     * // Using async iterator
-     * for await (const doc of collection.aggregate([
-     *   { $match: { status: 'active' } }
-     * ])) {
-     *   console.log(doc)
-     * }
-     * ```
-     */
-    aggregate<TResult extends Document = Document>(pipeline: AggregationStage[], options?: AggregateOptions): HttpAggregationCursor<TResult>;
-    /**
-     * Get distinct values for a field
-     *
-     * @param field - The field to get distinct values for
-     * @param filter - Optional filter
-     * @returns Array of distinct values
-     */
-    distinct<TValue = unknown>(field: keyof TDocument, filter?: Filter<TDocument>): Promise<TValue[]>;
-    /**
-     * Create an index on this collection
-     *
-     * @param indexSpec - Index specification
-     * @returns Name of the created index
-     */
-    createIndex(indexSpec: IndexSpecification): Promise<string>;
-    /**
-     * Drop an index from this collection
-     *
-     * @param indexName - Name of the index to drop
-     */
-    dropIndex(indexName: string): Promise<void>;
-    /**
-     * List all indexes on this collection
-     *
-     * @returns Array of index information
-     */
-    listIndexes(): Promise<IndexSpecification[]>;
-    /**
-     * Drop this collection
-     */
-    drop(): Promise<void>;
-}
-//# sourceMappingURL=Collection.d.ts.map

package/dist/client/Collection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../src/client/Collection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EACV,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErE;;;;GAIG;AACH,qBAAa,UAAU,CAAC,SAAS,SAAS,QAAQ,GAAG,QAAQ;IAC3D,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,cAAc,CAAQ;IAE9B;;;;;;OAMG;gBACS,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAM5D;;OAEG;IACH,OAAO,CAAC,OAAO;IAKf;;OAEG;YACW,OAAO;IAoBrB;;;;;OAKG;IACG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlF;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI5F;;;;;;OAMG;IACG,OAAO,CACX,MAAM,GAAE,MAAM,CAAC,SAAS,CAAM,EAC9B,OAAO,GAAE,WAAW,CAAC,SAAS,CAAM,GACnC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAI5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,IAAI,CACF,MAAM,GAAE,MAAM,CAAC,SAAS,CAAM,EAC9B,OAAO,GAAE,WAAW,CAAC,SAAS,CAAM,GACnC,cAAc,CAAC,SAAS,CAAC;IAQ5B;;;;;;OAMG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,EACzB,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC;IAIxB;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,EACzB,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC;IAIxB;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,EACzB,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAClC,OAAO,CAAC,YAAY,CAAC;IAIxB;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjE;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlE;;;;;OAKG;IACG,cAAc,CAAC,MAAM,GAAE,MAAM,CAAC,SAAS,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrE;;;;OAIG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC;IAK/C;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,SAAS,CAAC,OAAO,SAAS,QAAQ,GAAG,QAAQ,EAC3C,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,qBAAqB,CAAC,OAAO,CAAC;IAQjC;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,GAAG,OAAO,EAC7B,KAAK,EAAE,MAAM,SAAS,EACtB,MAAM,GAAE,MAAM,CAAC,SAAS,CAAM,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpB;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE;;;;OAIG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIlD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}