import type { DocumentSnapshot, FieldPath, OrderByDirection, Query, WhereFilterOp } from 'firebase/firestore';
/**
 * Where clause tuple format: [fieldPath, operator, value]
 *
 * @example
 * ['age', '>=', 18]
 * ['status', '==', 'active']
 */
export type WhereClause = [fieldPath: string | FieldPath, opStr: WhereFilterOp, value: unknown];
/**
 * Query condition configuration
 *
 * Defines filtering, ordering, pagination and cursor options for Firestore queries.
 * The `where` field is required to distinguish Condition from Key when used as first argument.
 *
 * @example
 * ```typescript
 * const condition: Condition = {
 *   where: [
 *     ['age', '>=', 18],
 *     ['status', '==', 'active']
 *   ],
 *   orderBy: ['createdAt', 'desc'],
 *   limit: 10
 * };
 *
 * // Just orderBy or limit - use empty where array
 * const condition2: Condition = {
 *   where: [],
 *   orderBy: ['createdAt', 'desc'],
 *   limit: 10
 * };
 * ```
 */
export interface Condition {
    /** Array of where clauses (all conditions are AND-ed together). Required field. */
    where: WhereClause[];
    /** Maximum number of documents to return */
    limit?: number;
    /** Maximum number of documents to return from the end of the result set */
    limitToLast?: number;
    /** Order by field and direction: [fieldPath, direction] */
    orderBy?: [fieldPath: string | FieldPath, directionStr?: OrderByDirection];
    /** Start after this document snapshot (for pagination) */
    startAfter?: DocumentSnapshot<unknown>;
    /** Start at this document snapshot (inclusive) */
    startAt?: DocumentSnapshot<unknown>;
    /** End before this document snapshot (for pagination) */
    endBefore?: DocumentSnapshot<unknown>;
    /** End at this document snapshot (inclusive) */
    endAt?: DocumentSnapshot<unknown>;
}
/**
 * Builds a Firestore query from a base query reference and condition object
 *
 * Applies where clauses, ordering, limits, and cursor operations in the correct order
 * to construct a complete Firestore query.
 *
 * @param ref - Base Firestore query reference
 * @param condition - Query conditions to apply
 * @returns Modified query with conditions applied, or undefined if ref is not provided
 *
 * @example
 * ```typescript
 * const baseQuery = collection(db, 'users');
 * const query = buildQuery(baseQuery, {
 *   where: [['age', '>=', 18]],
 *   orderBy: ['name', 'asc'],
 *   limit: 10
 * });
 * ```
 */
export declare function buildQuery(ref?: Query<unknown>, condition?: Condition): Query<unknown> | undefined;
//# sourceMappingURL=query.d.ts.map