/**
 * Turbopuffer index handle implementation.
 */
import type Turbopuffer from "@turbopuffer/turbopuffer";
import type { IndexHandle, DocumentPatch, UpsertResult, PatchResult, DeleteResult, QueryInput, SearchHit, FieldSchema, UnknownDocument } from "@kernl-sdk/retrieval";
/**
 * Handle for operating on a specific Turbopuffer namespace (index).
 */
export declare class TurbopufferIndexHandle<TDocument = UnknownDocument> implements IndexHandle<TDocument> {
    readonly id: string;
    private client;
    constructor(client: Turbopuffer, id: string);
    /**
     * Query the index.
     */
    query(query: QueryInput): Promise<SearchHit<TDocument>[]>;
    /**
     * Upsert one or more documents.
     */
    upsert(docs: TDocument | TDocument[]): Promise<UpsertResult>;
    /**
     * Patch one or more documents.
     */
    patch(patches: DocumentPatch<TDocument> | DocumentPatch<TDocument>[]): Promise<PatchResult>;
    /**
     * Delete one or more documents by ID.
     */
    delete(ids: string | string[]): Promise<DeleteResult>;
    /**
     * Add a field to the index schema.
     */
    addField(_field: string, _schema: FieldSchema): Promise<void>;
}
//# sourceMappingURL=handle.d.ts.map