import type { Auth } from './auth.js';
export interface GeoBBox {
    latMin: number;
    latMax: number;
    lonMin: number;
    lonMax: number;
    latField?: string;
    lonField?: string;
}
export interface QueryOptions {
    owner?: string;
    limit?: number;
    offset?: number;
    orderBy?: string;
    order?: 'asc' | 'desc';
    /** Filter documents by geo bounding box on JSON fields (default: lat/lon). */
    bbox?: GeoBBox;
}
export interface QueryResult<T> {
    documents: (T & {
        id: string;
    })[];
    total: number;
}
/** Document database — organize data into named collections. */
export declare class Collections {
    private readonly appId;
    private readonly apiBase;
    private readonly auth;
    constructor(appId: string, apiBase: string, auth: Auth);
    /** Get a collection handle for the given name. */
    collection(name: string): Collection;
}
/** A named collection of JSON documents. */
export declare class Collection {
    private readonly appId;
    private readonly name;
    private readonly apiBase;
    private readonly auth;
    constructor(appId: string, name: string, apiBase: string, auth: Auth);
    /** Create a new document. Auth required. Returns the document with its generated `id`. */
    create<T extends Record<string, unknown>>(doc: T): Promise<T & {
        id: string;
    }>;
    /** Get a document by ID. Returns null if not found. Public read. */
    get<T = Record<string, unknown>>(id: string): Promise<(T & {
        id: string;
    }) | null>;
    /** Query documents with optional filtering and pagination. Public read. */
    query<T = Record<string, unknown>>(opts?: QueryOptions): Promise<QueryResult<T>>;
    /** Update a document by merging the patch into the existing data. Auth required, owner only. */
    update<T extends Record<string, unknown>>(id: string, patch: Partial<T>): Promise<T & {
        id: string;
    }>;
    /** Delete a document. Auth required, owner only. */
    delete(id: string): Promise<void>;
}
//# sourceMappingURL=db.d.ts.map