mongo.do 0.1.0

package/dist/client/change-stream.js

@@ -0,0 +1,429 @@
+/**
+ * ChangeStream - MongoDB-compatible change stream implementation
+ *
+ * Provides real-time notifications for data changes in a collection.
+ * Supports filtering with $match pipeline stages and resume tokens for
+ * reliable resumption after disconnections.
+ *
+ * @see https://www.mongodb.com/docs/manual/changeStreams/
+ */
+import { ObjectId } from '../types/objectid';
+/**
+ * Utility class for generating and parsing resume tokens
+ */
+export const ResumeToken = {
+    /**
+     * Generate a new resume token
+     */
+    generate(database, collection, sequence) {
+        const timestamp = Date.now();
+        const data = {
+            db: database,
+            coll: collection,
+            seq: sequence,
+            ts: timestamp,
+        };
+        // Encode as base64 for compact representation
+        const encoded = btoa(JSON.stringify(data));
+        // Pad with timestamp prefix for ordering
+        const paddedTs = timestamp.toString(36).padStart(12, '0');
+        const paddedSeq = sequence.toString(36).padStart(8, '0');
+        return { _data: `${paddedTs}${paddedSeq}${encoded}` };
+    },
+    /**
+     * Parse a resume token back to its components
+     */
+    parse(token) {
+        try {
+            // Extract the base64 portion (after timestamp and sequence prefixes)
+            const encoded = token._data.slice(20); // 12 for ts + 8 for seq
+            const decoded = atob(encoded);
+            const data = JSON.parse(decoded);
+            return {
+                database: data.db,
+                collection: data.coll,
+                sequence: data.seq,
+                timestamp: data.ts,
+            };
+        }
+        catch (error) {
+            throw new Error(`Invalid resume token: ${token._data}`);
+        }
+    },
+    /**
+     * Compare two tokens for ordering
+     */
+    compare(a, b) {
+        return a._data.localeCompare(b._data);
+    },
+};
+// ============================================================================
+// ChangeStream Class
+// ============================================================================
+/**
+ * MongoDB-compatible change stream cursor
+ *
+ * Allows watching for changes on a collection in real-time.
+ * Supports filtering, resume tokens, and async iteration.
+ *
+ * @example
+ * ```typescript
+ * const changeStream = collection.watch([
+ *   { $match: { operationType: 'insert' } }
+ * ])
+ *
+ * for await (const event of changeStream) {
+ *   console.log('Change:', event.operationType, event.fullDocument)
+ * }
+ * ```
+ */
+export class ChangeStream {
+    database;
+    collection;
+    pipeline;
+    options;
+    getDocumentById;
+    getChangeEvents;
+    onClose;
+    _closed = false;
+    _resumeToken = null;
+    _currentSequence = 0;
+    _pendingEvents = [];
+    constructor(database, collection, pipeline, options, callbacks) {
+        this.database = database;
+        this.collection = collection;
+        this.pipeline = pipeline || [];
+        this.options = options || {};
+        this.getDocumentById = callbacks.getDocumentById;
+        this.getChangeEvents = callbacks.getChangeEvents;
+        // Start from the current sequence by default (real-time watching)
+        // This follows MongoDB's behavior where change streams only see future events
+        this._currentSequence = callbacks.getCurrentSequence();
+        this.onClose = callbacks.onClose;
+        // Handle resume/start tokens - resume after the specified sequence
+        // This allows resuming from a previous point in the event stream
+        if (options.resumeAfter || options.startAfter) {
+            const token = options.resumeAfter || options.startAfter;
+            try {
+                const parsed = ResumeToken.parse(token);
+                this._currentSequence = parsed.sequence;
+            }
+            catch {
+                // Invalid token, start from current position
+            }
+        }
+    }
+    /**
+     * Whether the change stream is closed
+     */
+    get closed() {
+        return this._closed;
+    }
+    /**
+     * Get the current resume token (for the last received event)
+     */
+    getResumeToken() {
+        return this._resumeToken;
+    }
+    /**
+     * Get the next change event (blocking)
+     * Returns null if the stream is closed
+     */
+    async next() {
+        if (this._closed) {
+            return null;
+        }
+        // Check for pending events first
+        if (this._pendingEvents.length > 0) {
+            const event = this._pendingEvents.shift();
+            this._resumeToken = event._id;
+            return event;
+        }
+        // Poll for new events
+        const maxWait = this.options.maxAwaitTimeMS || 30000;
+        const pollInterval = 50;
+        const startTime = Date.now();
+        while (!this._closed && Date.now() - startTime < maxWait) {
+            const events = await this.fetchNewEvents();
+            if (events.length > 0) {
+                // Store remaining events for subsequent calls
+                this._pendingEvents = events.slice(1);
+                const event = events[0];
+                if (event) {
+                    this._resumeToken = event._id;
+                    return event;
+                }
+            }
+            // Wait before next poll
+            await new Promise(resolve => setTimeout(resolve, pollInterval));
+        }
+        return null;
+    }
+    /**
+     * Try to get the next event without blocking
+     * Returns null immediately if no events are available
+     */
+    async tryNext() {
+        if (this._closed) {
+            return null;
+        }
+        // Check pending events
+        if (this._pendingEvents.length > 0) {
+            const event = this._pendingEvents.shift();
+            this._resumeToken = event._id;
+            return event;
+        }
+        // Fetch new events without waiting
+        const events = await this.fetchNewEvents();
+        if (events.length > 0) {
+            this._pendingEvents = events.slice(1);
+            const event = events[0];
+            if (event) {
+                this._resumeToken = event._id;
+                return event;
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if there are more events available
+     */
+    async hasNext() {
+        if (this._closed) {
+            return false;
+        }
+        if (this._pendingEvents.length > 0) {
+            return true;
+        }
+        const events = await this.fetchNewEvents();
+        if (events.length > 0) {
+            this._pendingEvents = events;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Close the change stream
+     */
+    async close() {
+        if (!this._closed) {
+            this._closed = true;
+            this._pendingEvents = [];
+            if (this.onClose) {
+                this.onClose();
+            }
+        }
+    }
+    /**
+     * Get a stream interface for the change stream
+     */
+    stream() {
+        return this;
+    }
+    /**
+     * Async iterator implementation
+     */
+    async *[Symbol.asyncIterator]() {
+        while (!this._closed) {
+            const event = await this.tryNext();
+            if (event) {
+                yield event;
+            }
+            else if (!this._closed) {
+                // Small delay to prevent busy-waiting
+                await new Promise(resolve => setTimeout(resolve, 10));
+            }
+        }
+    }
+    /**
+     * Fetch new events from the change event store
+     */
+    async fetchNewEvents() {
+        const stored = await this.getChangeEvents(this._currentSequence);
+        const events = [];
+        for (const storedEvent of stored) {
+            const event = await this.transformStoredEvent(storedEvent);
+            // Apply pipeline filters
+            if (this.matchesPipeline(event)) {
+                events.push(event);
+            }
+            // Update current sequence
+            this._currentSequence = storedEvent.sequence;
+        }
+        return events;
+    }
+    /**
+     * Transform a stored event into a ChangeEvent
+     */
+    async transformStoredEvent(stored) {
+        const documentKey = {
+            _id: typeof stored.documentId === 'string'
+                ? new ObjectId(stored.documentId)
+                : stored.documentId,
+        };
+        const event = {
+            _id: ResumeToken.generate(this.database, this.collection, stored.sequence),
+            operationType: stored.operationType,
+            clusterTime: new Date(stored.timestamp),
+            ns: {
+                db: this.database,
+                coll: this.collection,
+            },
+            documentKey,
+        };
+        // Handle fullDocument based on operation type and options
+        if (stored.operationType === 'insert' || stored.operationType === 'replace') {
+            event.fullDocument = stored.fullDocument;
+        }
+        else if (stored.operationType === 'update') {
+            // Include updateDescription for updates
+            event.updateDescription = {
+                updatedFields: stored.updatedFields || {},
+                removedFields: stored.removedFields || [],
+            };
+            // Include fullDocument if updateLookup option is set
+            if (this.options.fullDocument === 'updateLookup') {
+                const doc = await this.getDocumentById(documentKey._id);
+                if (doc) {
+                    event.fullDocument = doc;
+                }
+            }
+        }
+        // delete operations don't include fullDocument
+        return event;
+    }
+    /**
+     * Check if an event matches the pipeline filters
+     */
+    matchesPipeline(event) {
+        for (const stage of this.pipeline) {
+            if ('$match' in stage) {
+                if (!this.matchesCondition(event, stage.$match)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Check if an event matches a $match condition
+     */
+    matchesCondition(event, condition) {
+        for (const [key, value] of Object.entries(condition)) {
+            // Handle logical operators
+            if (key === '$or') {
+                const conditions = value;
+                if (!conditions.some(c => this.matchesCondition(event, c))) {
+                    return false;
+                }
+                continue;
+            }
+            if (key === '$and') {
+                const conditions = value;
+                if (!conditions.every(c => this.matchesCondition(event, c))) {
+                    return false;
+                }
+                continue;
+            }
+            // Get the value from the event
+            const eventValue = this.getNestedValue(event, key);
+            // Handle comparison operators
+            if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                const operators = value;
+                for (const [op, opValue] of Object.entries(operators)) {
+                    if (!this.matchesOperator(eventValue, op, opValue)) {
+                        return false;
+                    }
+                }
+                continue;
+            }
+            // Direct comparison
+            if (eventValue !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Match a comparison operator
+     */
+    matchesOperator(value, operator, operand) {
+        switch (operator) {
+            case '$eq':
+                return value === operand;
+            case '$ne':
+                return value !== operand;
+            case '$gt':
+                return typeof value === 'number' && value > operand;
+            case '$gte':
+                return typeof value === 'number' && value >= operand;
+            case '$lt':
+                return typeof value === 'number' && value < operand;
+            case '$lte':
+                return typeof value === 'number' && value <= operand;
+            case '$in':
+                return Array.isArray(operand) && operand.includes(value);
+            case '$nin':
+                return Array.isArray(operand) && !operand.includes(value);
+            default:
+                return true;
+        }
+    }
+    /**
+     * Get a nested value from an object using dot notation
+     */
+    getNestedValue(obj, path) {
+        const parts = path.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || current === undefined) {
+                return undefined;
+            }
+            current = current[part];
+        }
+        return current;
+    }
+}
+// ============================================================================
+// ChangeEventStore Class
+// ============================================================================
+/**
+ * In-memory store for change events (for testing)
+ * In production, this would be backed by SQLite
+ */
+export class ChangeEventStore {
+    events = [];
+    sequence = 0;
+    /**
+     * Record a new change event
+     */
+    addEvent(event) {
+        this.sequence++;
+        this.events.push({
+            ...event,
+            sequence: this.sequence,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Get events after a given sequence number
+     */
+    getEventsAfter(sequence) {
+        return this.events.filter(e => e.sequence > sequence);
+    }
+    /**
+     * Get the current sequence number
+     */
+    getCurrentSequence() {
+        return this.sequence;
+    }
+    /**
+     * Clear all events
+     */
+    clear() {
+        this.events = [];
+        this.sequence = 0;
+    }
+}
+export default ChangeStream;
+//# sourceMappingURL=change-stream.js.map

package/dist/client/change-stream.js.map

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

package/dist/client/cursor.d.ts

@@ -0,0 +1,85 @@
+/**
+ * FindCursor - MongoDB-compatible cursor for query results
+ *
+ * Provides chainable methods for sorting, limiting, skipping, and projecting
+ * query results. Supports async iteration and array conversion.
+ */
+import type { MongoCollection } from './mongo-collection';
+export type Document = Record<string, unknown>;
+export interface FindOptions {
+    projection?: Record<string, 0 | 1>;
+    sort?: Record<string, 1 | -1>;
+    limit?: number;
+    skip?: number;
+}
+/**
+ * FindCursor provides lazy evaluation of MongoDB queries
+ */
+export declare class FindCursor<TSchema extends Document = Document> {
+    private readonly collection;
+    private readonly filter;
+    private _projection?;
+    private _sort?;
+    private _limit?;
+    private _skip?;
+    private _executed;
+    private _results;
+    constructor(collection: MongoCollection<any>, filter: object, options?: FindOptions);
+    /**
+     * Set the sort order
+     */
+    sort(spec: Record<string, 1 | -1>): this;
+    /**
+     * Set the maximum number of documents to return
+     */
+    limit(count: number): this;
+    /**
+     * Set the number of documents to skip
+     */
+    skip(count: number): this;
+    /**
+     * Set the projection for returned documents
+     */
+    project(spec: Record<string, 0 | 1>): this;
+    /**
+     * Execute the query and return all documents as an array
+     */
+    toArray(): Promise<TSchema[]>;
+    /**
+     * Execute callback for each document
+     */
+    forEach(callback: (doc: TSchema) => void): Promise<void>;
+    /**
+     * Count documents matching the query
+     */
+    count(): Promise<number>;
+    /**
+     * Check if there are any documents
+     */
+    hasNext(): Promise<boolean>;
+    /**
+     * Get the next document (simple implementation)
+     */
+    next(): Promise<TSchema | null>;
+    /**
+     * Map over documents
+     */
+    map<U>(fn: (doc: TSchema) => U): MappedCursor<TSchema, U>;
+    /**
+     * Async iterator support
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<TSchema>;
+}
+/**
+ * Cursor with map transformation applied
+ */
+declare class MappedCursor<TSchema extends Document, U> {
+    private readonly cursor;
+    private readonly mapFn;
+    constructor(cursor: FindCursor<TSchema>, mapFn: (doc: TSchema) => U);
+    toArray(): Promise<U[]>;
+    forEach(callback: (doc: U) => void): Promise<void>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<U>;
+}
+export default FindCursor;
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/client/cursor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGzD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,qBAAa,UAAU,CAAC,OAAO,SAAS,QAAQ,GAAG,QAAQ;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAuB;IAC3C,OAAO,CAAC,KAAK,CAAC,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAgB;gBAG9B,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW;IAYvB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI;IAK1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAoBnC;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;IAIzD;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC;CAMhE;AAED;;GAEG;AACH,cAAM,YAAY,CAAC,OAAO,SAAS,QAAQ,EAAE,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;gBAE/B,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC;IAK7D,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAKvB,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;CAM1D;AAED,eAAe,UAAU,CAAA"}

package/dist/client/cursor.js

@@ -0,0 +1,156 @@
+/**
+ * FindCursor - MongoDB-compatible cursor for query results
+ *
+ * Provides chainable methods for sorting, limiting, skipping, and projecting
+ * query results. Supports async iteration and array conversion.
+ */
+/**
+ * FindCursor provides lazy evaluation of MongoDB queries
+ */
+export class FindCursor {
+    collection;
+    filter;
+    _projection;
+    _sort;
+    _limit;
+    _skip;
+    _executed = false;
+    _results = [];
+    constructor(collection, filter, options) {
+        this.collection = collection;
+        this.filter = filter;
+        if (options) {
+            if (options.projection !== undefined)
+                this._projection = options.projection;
+            if (options.sort !== undefined)
+                this._sort = options.sort;
+            if (options.limit !== undefined)
+                this._limit = options.limit;
+            if (options.skip !== undefined)
+                this._skip = options.skip;
+        }
+    }
+    /**
+     * Set the sort order
+     */
+    sort(spec) {
+        this._sort = spec;
+        return this;
+    }
+    /**
+     * Set the maximum number of documents to return
+     */
+    limit(count) {
+        this._limit = count;
+        return this;
+    }
+    /**
+     * Set the number of documents to skip
+     */
+    skip(count) {
+        this._skip = count;
+        return this;
+    }
+    /**
+     * Set the projection for returned documents
+     */
+    project(spec) {
+        this._projection = spec;
+        return this;
+    }
+    /**
+     * Execute the query and return all documents as an array
+     */
+    async toArray() {
+        if (!this._executed) {
+            const options = {};
+            if (this._sort !== undefined)
+                options.sort = this._sort;
+            if (this._skip !== undefined)
+                options.skip = this._skip;
+            if (this._limit !== undefined)
+                options.limit = this._limit;
+            this._results = this.collection._findDocuments(this.filter, options);
+            // Apply projection
+            if (this._projection) {
+                this._results = this._results.map(doc => this.collection._applyProjection(doc, this._projection));
+            }
+            this._executed = true;
+        }
+        return [...this._results];
+    }
+    /**
+     * Execute callback for each document
+     */
+    async forEach(callback) {
+        const docs = await this.toArray();
+        for (const doc of docs) {
+            callback(doc);
+        }
+    }
+    /**
+     * Count documents matching the query
+     */
+    async count() {
+        const docs = await this.toArray();
+        return docs.length;
+    }
+    /**
+     * Check if there are any documents
+     */
+    async hasNext() {
+        const docs = await this.toArray();
+        return docs.length > 0;
+    }
+    /**
+     * Get the next document (simple implementation)
+     */
+    async next() {
+        const docs = await this.toArray();
+        return docs.length > 0 ? docs[0] ?? null : null;
+    }
+    /**
+     * Map over documents
+     */
+    map(fn) {
+        return new MappedCursor(this, fn);
+    }
+    /**
+     * Async iterator support
+     */
+    async *[Symbol.asyncIterator]() {
+        const docs = await this.toArray();
+        for (const doc of docs) {
+            yield doc;
+        }
+    }
+}
+/**
+ * Cursor with map transformation applied
+ */
+class MappedCursor {
+    cursor;
+    mapFn;
+    constructor(cursor, mapFn) {
+        this.cursor = cursor;
+        this.mapFn = mapFn;
+    }
+    async toArray() {
+        const docs = await this.cursor.toArray();
+        return docs.map(this.mapFn);
+    }
+    async forEach(callback) {
+        const docs = await this.toArray();
+        for (const doc of docs) {
+            callback(doc);
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        const docs = await this.toArray();
+        for (const doc of docs) {
+            yield doc;
+        }
+    }
+}
+export default FindCursor;
+//# sourceMappingURL=cursor.js.map