mongo.do 0.1.0 → 0.1.1

package/dist/client/MongoClient.js

@@ -1,307 +0,0 @@
-/**
- * MongoClient - MongoDB-compatible client for mongo.do
- *
- * Provides connection management and database access for
- * MongoDB-compatible operations. Supports two modes:
- *
- * 1. URI-based connection (for testing/in-memory):
- *    const client = new MongoClient('mongodo://localhost:27017/mydb')
- *
- * 2. Env-based connection (for Cloudflare Durable Objects):
- *    const client = new MongoClient(env)
- *
- * The URI-based mode uses in-memory storage and is suitable for testing.
- * The Env-based mode connects to Cloudflare Durable Objects for production.
- */
-import { Database } from './Database';
-import { MongoDatabase } from './mongo-database';
-import { ClientSession, SessionId, } from './session';
-// Re-export session types for convenience
-export { ClientSession, SessionId };
-/**
- * Parse a mongodo:// or mongodb:// URI into its components
- */
-function parseURI(uri) {
-    if (!uri || uri.trim() === '') {
-        throw new Error('Invalid URI: URI cannot be empty');
-    }
-    // Match scheme
-    const schemeMatch = uri.match(/^([a-zA-Z][a-zA-Z0-9+.-]*):\/\//);
-    if (!schemeMatch) {
-        throw new Error(`Invalid URI: Missing scheme in "${uri}"`);
-    }
-    const scheme = schemeMatch[1].toLowerCase();
-    if (scheme !== 'mongodo' && scheme !== 'mongodb') {
-        throw new Error(`Invalid URI scheme: Expected "mongodo://" or "mongodb://", got "${scheme}://"`);
-    }
-    // Remove scheme from URI
-    let remaining = uri.slice(schemeMatch[0].length);
-    // Extract query string
-    let queryString = '';
-    const queryIndex = remaining.indexOf('?');
-    if (queryIndex !== -1) {
-        queryString = remaining.slice(queryIndex + 1);
-        remaining = remaining.slice(0, queryIndex);
-    }
-    // Parse query parameters
-    const options = {};
-    if (queryString) {
-        for (const param of queryString.split('&')) {
-            const [key, value] = param.split('=');
-            if (key) {
-                options[key] = decodeURIComponent(value || '');
-            }
-        }
-    }
-    // Extract database name
-    let database = 'test';
-    const pathIndex = remaining.indexOf('/');
-    if (pathIndex !== -1) {
-        database = remaining.slice(pathIndex + 1) || 'test';
-        remaining = remaining.slice(0, pathIndex);
-    }
-    // Check for authentication (user:pass@)
-    let username;
-    let password;
-    const atIndex = remaining.lastIndexOf('@');
-    if (atIndex !== -1) {
-        const authPart = remaining.slice(0, atIndex);
-        remaining = remaining.slice(atIndex + 1);
-        const colonIndex = authPart.indexOf(':');
-        if (colonIndex !== -1) {
-            username = decodeURIComponent(authPart.slice(0, colonIndex));
-            password = decodeURIComponent(authPart.slice(colonIndex + 1));
-        }
-        else {
-            username = decodeURIComponent(authPart);
-        }
-    }
-    // Parse host and port
-    let host = 'localhost';
-    let port = 27017;
-    const colonIndex = remaining.lastIndexOf(':');
-    if (colonIndex !== -1) {
-        host = remaining.slice(0, colonIndex) || 'localhost';
-        const portStr = remaining.slice(colonIndex + 1);
-        if (portStr) {
-            port = parseInt(portStr, 10);
-            if (isNaN(port)) {
-                throw new Error(`Invalid port: "${portStr}"`);
-            }
-        }
-    }
-    else {
-        host = remaining || 'localhost';
-    }
-    const result = {
-        scheme,
-        host,
-        port,
-        database,
-        options,
-    };
-    // Only include auth fields if they are defined
-    if (username !== undefined) {
-        result.username = username;
-    }
-    if (password !== undefined) {
-        result.password = password;
-    }
-    return result;
-}
-/**
- * MongoClient - The main entry point for interacting with mongo.do
- *
- * Provides a MongoDB-compatible API for database operations.
- * Supports both URI-based connections (for testing) and
- * Cloudflare Workers environment bindings (for production).
- *
- * @example URI-based (testing/in-memory):
- * ```typescript
- * const client = new MongoClient('mongodo://localhost:27017/mydb')
- * await client.connect()
- * const db = client.db('mydb')
- * ```
- *
- * @example Env-based (Cloudflare Durable Objects):
- * ```typescript
- * const client = new MongoClient(env)
- * await client.connect()
- * const db = client.db('mydb')
- * ```
- */
-export class MongoClient {
-    _mode;
-    _uri;
-    _parsedURI;
-    _env;
-    _options;
-    _isConnected = false;
-    _mongoDatabaseCache = new Map();
-    _databaseCache = new Map();
-    /**
-     * Create a new MongoClient instance
-     *
-     * @param uriOrEnv - Either a connection URI string or Cloudflare Workers environment
-     * @param options - Optional connection options
-     */
-    constructor(uriOrEnv, options) {
-        this._options = options || {};
-        if (typeof uriOrEnv === 'string') {
-            // URI-based mode (for testing/in-memory)
-            this._mode = 'uri';
-            this._uri = uriOrEnv;
-            this._parsedURI = parseURI(uriOrEnv);
-            // Merge parsed options with provided options
-            const parsedOptions = {
-                host: this._parsedURI.host,
-                port: this._parsedURI.port,
-                maxPoolSize: this._parsedURI.options.maxPoolSize
-                    ? parseInt(this._parsedURI.options.maxPoolSize, 10)
-                    : 100,
-                minPoolSize: this._parsedURI.options.minPoolSize
-                    ? parseInt(this._parsedURI.options.minPoolSize, 10)
-                    : 0,
-            };
-            this._options = {
-                ...parsedOptions,
-                ...this._options,
-            };
-        }
-        else {
-            // Env-based mode (for Cloudflare Durable Objects)
-            this._mode = 'env';
-            this._env = uriOrEnv;
-        }
-    }
-    /**
-     * Get the client options
-     */
-    get options() {
-        return this._options;
-    }
-    /**
-     * Check if the client is currently connected
-     */
-    get isConnected() {
-        return this._isConnected;
-    }
-    /**
-     * Get the connection mode
-     */
-    get mode() {
-        return this._mode;
-    }
-    /**
-     * Get the connection URI (URI mode only)
-     */
-    get uri() {
-        return this._uri;
-    }
-    /**
-     * Connect to the database
-     *
-     * In mongo.do, this is mostly a no-op since connections are handled lazily.
-     * For Durable Objects mode, connections are per-request.
-     * For URI mode (in-memory), this initializes the connection state.
-     *
-     * @returns This client for chaining
-     */
-    async connect() {
-        if (this._isConnected) {
-            return this;
-        }
-        // Connection is lazy in mongo.do
-        this._isConnected = true;
-        return this;
-    }
-    /**
-     * Close the connection
-     *
-     * Clears database caches and resets connection state.
-     */
-    async close() {
-        if (!this._isConnected) {
-            return;
-        }
-        // Clear database caches
-        this._mongoDatabaseCache.clear();
-        this._databaseCache.clear();
-        this._isConnected = false;
-    }
-    /**
-     * Get a database instance
-     *
-     * In URI mode, returns a MongoDatabase (in-memory).
-     * In Env mode, returns a Database (Durable Objects).
-     *
-     * @param dbName - Database name (optional in URI mode, uses default from URI)
-     * @returns A database instance (MongoDatabase or Database based on mode)
-     */
-    db(dbName) {
-        if (this._mode === 'uri') {
-            return this._getMongoDatabase(dbName);
-        }
-        else {
-            return this._getDatabase(dbName || 'test');
-        }
-    }
-    /**
-     * Get a MongoDatabase instance (URI/in-memory mode)
-     * @internal
-     */
-    _getMongoDatabase(dbName) {
-        const name = dbName || this._parsedURI?.database || 'test';
-        // Return cached instance if available
-        let database = this._mongoDatabaseCache.get(name);
-        if (database) {
-            return database;
-        }
-        // Create new database instance
-        database = new MongoDatabase(this, name);
-        this._mongoDatabaseCache.set(name, database);
-        return database;
-    }
-    /**
-     * Get a Database instance (Env/Durable Objects mode)
-     * @internal
-     */
-    _getDatabase(dbName) {
-        // Return cached instance if available
-        let database = this._databaseCache.get(dbName);
-        if (database) {
-            return database;
-        }
-        if (!this._env) {
-            throw new Error('No environment provided for Durable Objects mode');
-        }
-        // Create new database instance
-        database = new Database(this._env, dbName);
-        this._databaseCache.set(dbName, database);
-        return database;
-    }
-    /**
-     * Get the default database name from the connection URI
-     * Only available in URI mode.
-     */
-    get defaultDatabase() {
-        if (this._parsedURI) {
-            return this._parsedURI.database;
-        }
-        return 'test';
-    }
-    /**
-     * Start a client session for transaction support
-     *
-     * Sessions are primarily used in URI/in-memory mode.
-     * Durable Objects mode uses SQLite transactions internally.
-     *
-     * @param options - Session options including default transaction options
-     * @returns A new ClientSession instance
-     */
-    startSession(options) {
-        return new ClientSession(this, options);
-    }
-}
-export default MongoClient;
-//# sourceMappingURL=MongoClient.js.map

package/dist/client/MongoClient.js.map

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

package/dist/client/aggregation-cursor.d.ts

@@ -1,210 +0,0 @@
-/**
- * AggregationCursor - Async cursor for MongoDB aggregation pipeline results
- *
- * Provides:
- * - Async iteration with for-await-of
- * - toArray() for collecting all results
- * - Support for async pipeline stages ($function, $lookup with pipeline)
- * - Proper error propagation from async stages
- */
-import { EventEmitter } from 'events';
-import type { Document } from './mongo-collection';
-import type { PipelineStage } from '../translator/stages/types';
-/**
- * Options for aggregation cursor
- */
-export interface AggregationCursorOptions {
-    /** Batch size for streaming results */
-    batchSize?: number;
-    /** Allow disk use for large result sets */
-    allowDiskUse?: boolean;
-    /** Maximum time for operation (ms) */
-    maxTimeMS?: number;
-    /** Comment for the operation */
-    comment?: string;
-}
-/**
- * Async function stage definition ($function)
- */
-export interface FunctionStage {
-    body: string | ((...args: unknown[]) => unknown | Promise<unknown>);
-    args: unknown[];
-    lang: 'js';
-}
-/**
- * Result from async stage execution
- */
-export interface AsyncStageResult<T = Document> {
-    documents: T[];
-    hasMore: boolean;
-    error?: Error;
-}
-/**
- * Executor function type for running pipeline against data
- */
-export type PipelineExecutor<T> = (documents: T[], stage: PipelineStage, context: AsyncExecutionContext) => Promise<T[]>;
-/**
- * Context for async pipeline execution
- */
-export interface AsyncExecutionContext {
-    /** Collection name being aggregated */
-    collectionName: string;
-    /** Lookup function for $lookup stages */
-    lookupCollection?: (name: string) => Promise<Document[]>;
-    /** Custom function executor for $function stages */
-    functionExecutor?: (fn: FunctionStage, doc: Document) => Promise<unknown>;
-    /** Abort signal for cancellation */
-    abortSignal?: AbortSignal;
-}
-/**
- * AggregationCursor provides async iteration over aggregation pipeline results
- */
-export declare class AggregationCursor<TSchema extends Document = Document> extends EventEmitter {
-    private readonly _pipeline;
-    private readonly _options;
-    private readonly _fetchFn;
-    private readonly _asyncExecutor;
-    private readonly _context;
-    private _buffer;
-    private _position;
-    private _fetched;
-    private _closed;
-    private _error;
-    /**
-     * Create a new AggregationCursor
-     *
-     * @param pipeline - The aggregation pipeline stages
-     * @param fetchFn - Function to fetch and execute the pipeline
-     * @param options - Cursor options
-     * @param asyncExecutor - Optional executor for async stages
-     * @param context - Execution context
-     */
-    constructor(pipeline: PipelineStage[], fetchFn: () => Promise<TSchema[]>, options?: AggregationCursorOptions, asyncExecutor?: PipelineExecutor<TSchema>, context?: AsyncExecutionContext);
-    /**
-     * Whether the cursor is closed
-     */
-    get closed(): boolean;
-    /**
-     * Get the pipeline being executed
-     */
-    get pipeline(): PipelineStage[];
-    /**
-     * Number of documents currently buffered
-     */
-    get bufferedCount(): number;
-    /**
-     * Execute the pipeline and fetch results
-     */
-    private ensureFetched;
-    /**
-     * Check if pipeline contains async stages
-     */
-    private hasAsyncStages;
-    /**
-     * Check if $lookup stage requires async execution
-     */
-    private isAsyncLookup;
-    /**
-     * Execute async stages in the pipeline
-     */
-    private executeAsyncStages;
-    /**
-     * Execute $function stage
-     */
-    private executeFunctionStage;
-    /**
-     * Execute $lookup with pipeline (async)
-     */
-    private executeAsyncLookup;
-    /**
-     * Get nested value from document
-     */
-    private getNestedValue;
-    /**
-     * Check if two values are equal
-     */
-    private valuesEqual;
-    /**
-     * Check if document matches an expression (simplified)
-     */
-    private matchesExpression;
-    /**
-     * Evaluate $expr
-     */
-    private evaluateExpr;
-    /**
-     * Evaluate a comparison operator
-     */
-    private evaluateOperator;
-    /**
-     * Get the next document
-     */
-    next(): Promise<TSchema | null>;
-    /**
-     * Check if there are more documents
-     */
-    hasNext(): Promise<boolean>;
-    /**
-     * Get all documents as an array
-     */
-    toArray(): Promise<TSchema[]>;
-    /**
-     * Execute callback for each document
-     */
-    forEach(callback: (doc: TSchema, index: number) => void | false | Promise<void | false>): Promise<void>;
-    /**
-     * Transform documents
-     */
-    map<U>(fn: (doc: TSchema, index: number) => U): MappedAggregationCursor<TSchema, U>;
-    /**
-     * Close the cursor
-     */
-    close(): Promise<void>;
-    /**
-     * Async iterator support for for-await-of
-     */
-    [Symbol.asyncIterator](): AsyncIterableIterator<TSchema>;
-    /**
-     * Clone the cursor
-     */
-    clone(): AggregationCursor<TSchema>;
-    /**
-     * Explain the aggregation plan
-     */
-    explain(): AggregationPlan;
-    /**
-     * Check if a stage is async
-     */
-    private isAsyncStage;
-}
-/**
- * Mapped cursor for transformed results
- */
-declare class MappedAggregationCursor<TSchema extends Document, U> {
-    private readonly _cursor;
-    private readonly _mapFn;
-    constructor(cursor: AggregationCursor<TSchema>, mapFn: (doc: TSchema, index: number) => U);
-    toArray(): Promise<U[]>;
-    forEach(callback: (doc: U, index: number) => void | false | Promise<void | false>): Promise<void>;
-    [Symbol.asyncIterator](): AsyncIterableIterator<U>;
-}
-/**
- * Aggregation plan interface
- */
-export interface AggregationPlan {
-    pipeline: Array<{
-        stage: string;
-        isAsync: boolean;
-    }>;
-    hasAsyncStages: boolean;
-    options: AggregationCursorOptions;
-}
-/**
- * Error class for aggregation failures
- */
-export declare class AggregationError extends Error {
-    readonly errors: Error[];
-    constructor(message: string, errors?: Error[]);
-}
-export default AggregationCursor;
-//# sourceMappingURL=aggregation-cursor.d.ts.map

package/dist/client/aggregation-cursor.d.ts.map

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