/**
 * Cursor – lazy, chainable query result that mimics MongoDB's cursor API.
 */
import type { ProjectionSpec, SortSpec } from '@digitaldefiance/suite-core-lib';
import type { BsonDocument } from '../interfaces/storage/documentTypes';
export declare class Cursor<T extends BsonDocument = BsonDocument> {
    private readonly _source;
    private _sort;
    private _skip;
    private _limit;
    private _projection;
    private _exhausted;
    constructor(_source: () => Promise<T[]>);
    /** Set sort specification (chainable) */
    sort(spec: SortSpec<T>): this;
    /** Set number of documents to skip (chainable) */
    skip(n: number): this;
    /** Set maximum number of documents to return (chainable) */
    limit(n: number): this;
    /** Set field projection (chainable) */
    project(spec: ProjectionSpec<T>): this;
    /**
     * Execute the query and return all matching documents as an array.
     */
    toArray(): Promise<T[]>;
    /**
     * Count matching documents (applies skip/limit if set).
     */
    count(): Promise<number>;
    /**
     * Get the first matching document.
     */
    next(): Promise<T | null>;
    /**
     * Check if there are more results.
     */
    hasNext(): Promise<boolean>;
    /**
     * Iterate over all results with a callback.
     */
    forEach(fn: (doc: T) => void | Promise<void>): Promise<void>;
    /**
     * Map results through a transform function.
     */
    map<U>(fn: (doc: T) => U): Promise<U[]>;
    /**
     * Make the cursor thenable so it can be awaited directly.
     */
    then<TResult1 = T[], TResult2 = never>(onfulfilled?: ((value: T[]) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
}
//# sourceMappingURL=cursor.d.ts.map