mongo.do 0.1.0

package/dist/client/mongo-client.js

@@ -0,0 +1,190 @@
+/**
+ * MongoClient - MongoDB-compatible client for mondodb
+ *
+ * Provides connection management and database access for
+ * MongoDB-compatible operations backed by Cloudflare Durable Objects SQLite.
+ */
+import { MongoDatabase } from './mongo-database';
+import { ClientSession, SessionId, } from './session';
+// Re-export session types
+export { ClientSession, SessionId, };
+/**
+ * Parse a mondodb:// 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 !== 'mondodb' && scheme !== 'mongodb') {
+        throw new Error(`Invalid URI scheme: Expected "mondodb://" 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';
+    }
+    return {
+        scheme,
+        host,
+        port,
+        database,
+        username,
+        password,
+        options,
+    };
+}
+export class MongoClient {
+    uri;
+    parsedURI;
+    _options;
+    _isConnected = false;
+    databaseCache = new Map();
+    constructor(uri, options) {
+        this.uri = uri;
+        this.parsedURI = parseURI(uri);
+        // 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,
+            ...options,
+        };
+    }
+    /**
+     * Get the client options
+     */
+    get options() {
+        return this._options;
+    }
+    /**
+     * Check if the client is currently connected
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Connect to the database
+     * Returns this client for chaining
+     */
+    async connect() {
+        if (this._isConnected) {
+            return this;
+        }
+        // In a real implementation, this would establish connection
+        // For mondodb backed by Durable Objects, connection is lazy
+        this._isConnected = true;
+        return this;
+    }
+    /**
+     * Close the connection
+     */
+    async close() {
+        if (!this._isConnected) {
+            return;
+        }
+        // Clear database cache
+        this.databaseCache.clear();
+        this._isConnected = false;
+    }
+    /**
+     * Get a database instance
+     * @param dbName - Database name (optional, uses default from URI if not provided)
+     */
+    db(dbName) {
+        const name = dbName || this.parsedURI.database;
+        // Return cached instance if available
+        let database = this.databaseCache.get(name);
+        if (database) {
+            return database;
+        }
+        // Create new database instance
+        database = new MongoDatabase(this, name);
+        this.databaseCache.set(name, database);
+        return database;
+    }
+    /**
+     * Get the default database name from the connection URI
+     */
+    get defaultDatabase() {
+        return this.parsedURI.database;
+    }
+    /**
+     * Start a client session for transaction support
+     *
+     * @param options - Session options including default transaction options
+     * @returns A new ClientSession instance
+     */
+    startSession(options) {
+        return new ClientSession(this, options);
+    }
+}
+export default MongoClient;
+//# sourceMappingURL=mongo-client.js.map

package/dist/client/mongo-client.js.map

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

package/dist/client/mongo-collection.d.ts

@@ -0,0 +1,359 @@
+/**
+ * MongoCollection - MongoDB-compatible collection interface
+ *
+ * Provides CRUD operations and query support for documents.
+ * This is the client-side in-memory implementation for testing.
+ */
+import { MongoDatabase } from './mongo-database';
+import { ObjectId } from '../types/objectid';
+import { FindCursor } from './cursor';
+import { BulkWriteOperation, BulkWriteOptions, BulkWriteResult } from './bulk-write';
+import { ChangeStream, ChangeStreamPipeline, ChangeStreamOptions } from './change-stream';
+import { ClientSession, TransactableCollection } from './session';
+import { AggregationCursor, AggregationCursorOptions } from './aggregation-cursor';
+import type { PipelineStage } from '../translator/stages/types';
+export type Document = Record<string, unknown>;
+export interface InsertOneResult {
+    acknowledged: boolean;
+    insertedId: ObjectId;
+}
+export interface InsertManyResult {
+    acknowledged: boolean;
+    insertedCount: number;
+    insertedIds: Record<number, ObjectId>;
+}
+export interface UpdateResult {
+    acknowledged: boolean;
+    matchedCount: number;
+    modifiedCount: number;
+    upsertedId?: ObjectId;
+    upsertedCount?: number;
+}
+export interface DeleteResult {
+    acknowledged: boolean;
+    deletedCount: number;
+}
+export interface SessionOption {
+    session?: ClientSession;
+}
+export interface FindOptions extends SessionOption {
+    projection?: Record<string, 0 | 1> | undefined;
+    sort?: Record<string, 1 | -1> | undefined;
+    limit?: number | undefined;
+    skip?: number | undefined;
+}
+export interface InsertOneOptions extends SessionOption {
+}
+export interface InsertManyOptions extends SessionOption {
+}
+export interface UpdateOptions extends SessionOption {
+    upsert?: boolean | undefined;
+    arrayFilters?: object[] | undefined;
+}
+export interface ReplaceOptions extends SessionOption {
+    upsert?: boolean | undefined;
+}
+export interface DeleteOptions extends SessionOption {
+}
+export interface FindOneAndUpdateOptions extends SessionOption {
+    projection?: Record<string, 0 | 1> | undefined;
+    sort?: Record<string, 1 | -1> | undefined;
+    upsert?: boolean | undefined;
+    returnDocument?: 'before' | 'after' | undefined;
+}
+export interface FindOneAndDeleteOptions extends SessionOption {
+    projection?: Record<string, 0 | 1> | undefined;
+    sort?: Record<string, 1 | -1> | undefined;
+}
+export interface FindOneAndReplaceOptions extends SessionOption {
+    projection?: Record<string, 0 | 1> | undefined;
+    sort?: Record<string, 1 | -1> | undefined;
+    upsert?: boolean | undefined;
+    returnDocument?: 'before' | 'after' | undefined;
+}
+/**
+ * MongoCollection provides CRUD operations for documents
+ */
+export declare class MongoCollection<TSchema extends Document = Document> implements TransactableCollection {
+    private readonly database;
+    private readonly _collectionName;
+    private documents;
+    private readonly _changeEventStore;
+    private readonly _activeChangeStreams;
+    constructor(database: MongoDatabase, name: string);
+    /**
+     * Get the collection name
+     */
+    get collectionName(): string;
+    /**
+     * Ensure collection is created in the database
+     * @internal
+     */
+    _ensureCreated(): Promise<void>;
+    /**
+     * Drop collection data
+     * @internal
+     */
+    _drop(): Promise<void>;
+    /**
+     * Get a unique key for this collection (used for transaction tracking)
+     * @internal
+     */
+    _getCollectionKey(): string;
+    /**
+     * Create a snapshot of the current collection data
+     * @internal
+     */
+    _createSnapshot(): Map<string, Record<string, unknown>>;
+    /**
+     * Restore collection data from a snapshot (used for transaction rollback)
+     * @internal
+     */
+    _restoreFromSnapshot(snapshot: Map<string, Record<string, unknown>>): void;
+    /**
+     * Track this collection in a session for transaction support
+     * @internal
+     */
+    private _trackInSession;
+    /**
+     * Insert a single document
+     */
+    insertOne(doc: TSchema, options?: InsertOneOptions): Promise<InsertOneResult>;
+    /**
+     * Insert multiple documents
+     */
+    insertMany(docs: TSchema[], options?: InsertManyOptions): Promise<InsertManyResult>;
+    /**
+     * Find a single document
+     */
+    findOne(filter?: object, options?: FindOptions): Promise<(TSchema & {
+        _id: ObjectId;
+    }) | null>;
+    /**
+     * Find multiple documents, returns a cursor
+     */
+    find(filter?: object, options?: FindOptions): FindCursor<TSchema & {
+        _id: ObjectId;
+    }>;
+    /**
+     * Internal method to execute find query
+     * @internal
+     */
+    _findDocuments(filter: object, options?: {
+        sort?: Record<string, 1 | -1>;
+        skip?: number;
+        limit?: number;
+    }): (TSchema & {
+        _id: ObjectId;
+    })[];
+    /**
+     * Update a single document
+     */
+    updateOne(filter: object, update: object, options?: UpdateOptions): Promise<UpdateResult>;
+    /**
+     * Update multiple documents
+     */
+    updateMany(filter: object, update: object, options?: UpdateOptions): Promise<UpdateResult>;
+    /**
+     * Replace a single document
+     */
+    replaceOne(filter: object, replacement: TSchema, options?: ReplaceOptions): Promise<UpdateResult>;
+    /**
+     * Delete a single document
+     */
+    deleteOne(filter: object, options?: DeleteOptions): Promise<DeleteResult>;
+    /**
+     * Delete multiple documents
+     */
+    deleteMany(filter: object, options?: DeleteOptions): Promise<DeleteResult>;
+    /**
+     * Count documents matching filter
+     */
+    countDocuments(filter?: object): Promise<number>;
+    /**
+     * Find one and update
+     */
+    findOneAndUpdate(filter: object, update: object, options?: FindOneAndUpdateOptions): Promise<(TSchema & {
+        _id: ObjectId;
+    }) | null>;
+    /**
+     * Find one and delete
+     */
+    findOneAndDelete(filter: object, options?: FindOneAndDeleteOptions): Promise<(TSchema & {
+        _id: ObjectId;
+    }) | null>;
+    /**
+     * Find one and replace
+     */
+    findOneAndReplace(filter: object, replacement: TSchema, options?: FindOneAndReplaceOptions): Promise<(TSchema & {
+        _id: ObjectId;
+    }) | null>;
+    /**
+     * Execute multiple write operations in a single batch
+     *
+     * @param operations - Array of bulk write operations
+     * @param options - Bulk write options
+     * @returns BulkWriteResult with operation counts
+     */
+    bulkWrite(operations: BulkWriteOperation<TSchema>[], options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    /**
+     * Drop the collection
+     */
+    drop(): Promise<boolean>;
+    /**
+     * Watch for changes on this collection
+     *
+     * Creates a change stream that emits events for insert, update, replace, and delete operations.
+     *
+     * @param pipeline - Optional aggregation pipeline for filtering events (supports $match)
+     * @param options - Change stream options
+     * @returns A ChangeStream instance
+     *
+     * @example
+     * ```typescript
+     * const changeStream = collection.watch([
+     *   { $match: { operationType: 'insert' } }
+     * ])
+     *
+     * for await (const event of changeStream) {
+     *   console.log('Change:', event.operationType, event.fullDocument)
+     * }
+     * ```
+     */
+    watch(pipeline?: ChangeStreamPipeline, options?: ChangeStreamOptions): ChangeStream<TSchema>;
+    /**
+     * Check if a document matches a filter
+     * @internal
+     */
+    private _matchesFilter;
+    /**
+     * Check if a value matches operator conditions
+     */
+    private _matchesOperators;
+    /**
+     * Compare two values for equality
+     */
+    private _valuesEqual;
+    /**
+     * Get nested value from document using dot notation
+     */
+    private _getNestedValue;
+    /**
+     * Apply update operators to a document
+     */
+    private _applyUpdate;
+    /**
+     * Set a nested value in an object
+     */
+    private _setNestedValue;
+    /**
+     * Delete a nested value from an object
+     */
+    private _deleteNestedValue;
+    /**
+     * Sort documents by the given sort specification
+     */
+    private _sortDocuments;
+    /**
+     * Apply projection to a document
+     * @internal
+     */
+    _applyProjection(doc: TSchema & {
+        _id: ObjectId;
+    }, projection: Record<string, 0 | 1>): TSchema & {
+        _id: ObjectId;
+    };
+    /**
+     * Extract updated and removed fields from an update object
+     * @internal
+     */
+    private _extractUpdateChanges;
+    /**
+     * Execute an aggregation pipeline on the collection
+     *
+     * Returns an AggregationCursor 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)`
+     *
+     * Supports async stages like $function and $lookup with pipeline.
+     *
+     * @param pipeline - Array of aggregation pipeline stages
+     * @param options - Aggregation options
+     * @returns AggregationCursor 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 = TSchema>(pipeline: PipelineStage[], options?: AggregationCursorOptions): AggregationCursor<TResult>;
+    /**
+     * Execute $function stage on a document
+     * @internal
+     */
+    private _executeFunctionStage;
+    /**
+     * Execute aggregation pipeline on documents (in-memory implementation)
+     * @internal
+     */
+    private _executeAggregationPipeline;
+    /**
+     * Execute $project stage
+     * @internal
+     */
+    private _executeProjectStage;
+    /**
+     * Execute $group stage
+     * @internal
+     */
+    private _executeGroupStage;
+    /**
+     * Execute $sort stage
+     * @internal
+     */
+    private _executeSortStage;
+    /**
+     * Execute $unwind stage
+     * @internal
+     */
+    private _executeUnwindStage;
+    /**
+     * Execute $addFields/$set stage
+     * @internal
+     */
+    private _executeAddFieldsStage;
+    /**
+     * Execute $lookup stage
+     * @internal
+     */
+    private _executeLookupStage;
+    /**
+     * Evaluate an expression (simplified)
+     * @internal
+     */
+    private _evaluateExpression;
+    /**
+     * Evaluate a condition
+     * @internal
+     */
+    private _evaluateCondition;
+    /**
+     * Compare two expression values
+     * @internal
+     */
+    private _compareExprValues;
+}
+export default MongoCollection;
+//# sourceMappingURL=mongo-collection.d.ts.map

package/dist/client/mongo-collection.d.ts.map

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