/**
 * ToonDB gRPC Client - Thin SDK Wrapper
 *
 * This module provides a thin gRPC client wrapper for the ToonDB server.
 * All business logic runs on the server (Thick Server / Thin Client architecture).
 *
 * The client is approximately ~250 lines of code, delegating all operations to the server.
 */
export interface SearchResult {
    id: number;
    distance: number;
}
export interface Document {
    id: string;
    content: string;
    embedding: number[];
    metadata: Record<string, string>;
}
export interface GraphNode {
    id: string;
    nodeType: string;
    properties: Record<string, string>;
}
export interface GraphEdge {
    fromId: string;
    edgeType: string;
    toId: string;
    properties: Record<string, string>;
}
export interface ToonDBClientOptions {
    address?: string;
    secure?: boolean;
    protoPath?: string;
}
/**
 * Thin gRPC client for ToonDB.
 *
 * All operations are delegated to the ToonDB gRPC server.
 * This client provides a TypeScript interface over the gRPC protocol.
 *
 * Usage:
 * ```typescript
 * const client = new ToonDBClient({ address: 'localhost:50051' });
 *
 * // Create collection
 * await client.createCollection('docs', { dimension: 384 });
 *
 * // Add documents
 * await client.addDocuments('docs', [
 *   { id: '1', content: 'Hello', embedding: [...] }
 * ]);
 *
 * // Search
 * const results = await client.search('docs', queryVector, 5);
 * ```
 */
export declare class ToonDBClient {
    private address;
    private credentials;
    private stubs;
    private protoPath;
    private packageDefinition;
    private proto;
    constructor(options?: ToonDBClientOptions);
    private getStub;
    private promisify;
    /**
     * Close all gRPC connections.
     */
    close(): void;
    createIndex(name: string, dimension: number, options?: {
        metric?: string;
        m?: number;
        efConstruction?: number;
    }): Promise<boolean>;
    insertVectors(indexName: string, ids: number[], vectors: number[][]): Promise<number>;
    search(indexName: string, query: number[], k?: number, ef?: number): Promise<SearchResult[]>;
    createCollection(name: string, options: {
        dimension: number;
        namespace?: string;
        metric?: string;
    }): Promise<boolean>;
    addDocuments(collectionName: string, documents: Array<{
        id?: string;
        content?: string;
        embedding?: number[];
        metadata?: Record<string, string>;
    }>, namespace?: string): Promise<string[]>;
    searchCollection(collectionName: string, query: number[], k?: number, options?: {
        namespace?: string;
        filter?: Record<string, string>;
    }): Promise<Document[]>;
    addNode(nodeId: string, nodeType: string, properties?: Record<string, string>, namespace?: string): Promise<boolean>;
    addEdge(fromId: string, edgeType: string, toId: string, properties?: Record<string, string>, namespace?: string): Promise<boolean>;
    traverse(startNode: string, options?: {
        maxDepth?: number;
        order?: 'bfs' | 'dfs';
        namespace?: string;
    }): Promise<{
        nodes: GraphNode[];
        edges: GraphEdge[];
    }>;
    cacheGet(cacheName: string, queryEmbedding: number[], threshold?: number): Promise<string | null>;
    cachePut(cacheName: string, key: string, value: string, keyEmbedding: number[], ttlSeconds?: number): Promise<boolean>;
    startTrace(name: string): Promise<{
        traceId: string;
        rootSpanId: string;
    }>;
    startSpan(traceId: string, parentSpanId: string, name: string): Promise<string>;
    endSpan(traceId: string, spanId: string, status?: 'ok' | 'error' | 'unset'): Promise<number>;
    get(key: Buffer, namespace?: string): Promise<Buffer | null>;
    put(key: Buffer, value: Buffer, namespace?: string, ttlSeconds?: number): Promise<boolean>;
    delete(key: Buffer, namespace?: string): Promise<boolean>;
}
/**
 * Connect to ToonDB gRPC server.
 */
export declare function connect(address?: string, options?: Omit<ToonDBClientOptions, 'address'>): ToonDBClient;
export declare const GrpcClient: typeof ToonDBClient;
//# sourceMappingURL=grpc-client.d.ts.map