import type { SearchMatch } from "./search";
/**
 * New or existing status
 * @group Models
 */
export type EntityStatus = "new" | "existing" | "copy";
/**
 * Representation of a entity fetched from the driver
 * @group Models
 */
export interface Entity<M extends Record<string, unknown> = Record<string, unknown>> {
    /**
     * ID of the entity
     */
    id: string | number;
    /**
     * A string representing the path of the referenced document (relative
     * to the root of the database).
     */
    path: string;
    /**
     * Current values
     */
    values: EntityValues<M>;
    /**
     * Why this entity is in a search result: which declared fields matched, and
     * the text around each hit.
     *
     * Present only on rows returned by a search that asked for it. A sibling of
     * `values` rather than a key inside it, because it describes the *query*,
     * not the record — nothing in the collection declares it, no form edits it,
     * and a record fetched by id never has one.
     */
    searchMatches?: SearchMatch[];
    /**
     * Which driver this entity belongs to (e.g., 'postgres', 'firestore').
     * If not specified, the default driver is assumed.
     */
    driver?: string;
    /**
     * Which database within the driver (e.g., for Firestore multi-database).
     * If not specified, the default database of the driver is used.
     */
    databaseId?: string;
}
/**
 * This type represents a record of key value pairs as described in an
 * entity collection.
 * @group Models
 */
export type EntityValues<M extends Record<string, unknown>> = M;
/**
 * Props for creating a EntityReference
 */
export interface EntityReferenceProps {
    /** ID of the entity */
    id: string;
    /** Path of the collection (relative to the root of the database) */
    path: string;
    /** Which driver (e.g., 'postgres', 'firestore'). Defaults to "(default)" */
    driver?: string;
    /** Which database within the driver. Defaults to "(default)" */
    databaseId?: string;
}
/**
 * Class used to create a reference to a entity in a different path.
 *
 * @example
 * // Simple reference (most common case - single driver, single db)
 * new EntityReference({ id: "123", path: "users" })
 *
 * // Reference to a different driver (e.g., Firestore)
 * new EntityReference({ id: "123", path: "analytics", driver: "firestore" })
 *
 * // Reference to a specific database within a driver
 * new EntityReference({ id: "123", path: "orders", driver: "postgres", databaseId: "orders_db" })
 */
export declare class EntityReference {
    readonly __type = "reference";
    /**
     * ID of the entity
     */
    readonly id: string;
    /**
     * A string representing the path of the referenced document (relative
     * to the root of the database).
     */
    readonly path: string;
    /**
     * Which driver (e.g., 'postgres', 'firestore').
     * Defaults to "(default)" if not specified.
     */
    readonly driver?: string;
    /**
     * Which database within the driver.
     * Defaults to "(default)" if not specified.
     */
    readonly databaseId?: string;
    /**
     * Create a reference to a entity.
     *
     * @example
     * // Simple reference (most common case)
     * new EntityReference({ id: "123", path: "users" })
     *
     * // With driver
     * new EntityReference({ id: "123", path: "analytics", driver: "firestore" })
     */
    constructor(props: EntityReferenceProps);
    get pathWithId(): string;
    /**
     * Get the full path including driver and database prefixes if specified.
     * For the common case (single driver, single db), this just returns pathWithId.
     */
    get fullPath(): string;
    isEntityReference(): boolean;
}
/**
 * Class used to create a reference to a entity in a different path
 */
export declare class EntityRelation {
    readonly __type = "relation";
    /**
     * ID of the entity
     */
    readonly id: string | number;
    /**
     * A string representing the path of the referenced document (relative
     * to the root of the database).
     */
    readonly path: string;
    /**
     * Pre-fetched data payload to eliminate N+1 queries.
     * When present, clients can use this directly instead of fetching.
     */
    readonly data?: Record<string, unknown>;
    constructor(id: string | number, path: string, data?: Record<string, unknown>);
    get pathWithId(): string;
    isEntityReference(): boolean;
    isEntityRelation(): boolean;
}
export declare class GeoPoint {
    /**
     * The latitude of this GeoPoint instance.
     */
    readonly latitude: number;
    /**
     * The longitude of this GeoPoint instance.
     */
    readonly longitude: number;
    constructor(latitude: number, longitude: number);
}
export declare class Vector {
    readonly value: number[];
    constructor(value: number[]);
}