@pleaseai/context-please-core 0.1.0

package/dist/vectordb/qdrant-vectordb.d.ts

@@ -0,0 +1,124 @@
+import { VectorDocument, SearchOptions, VectorSearchResult, HybridSearchRequest, HybridSearchOptions, HybridSearchResult } from './types';
+import { BaseVectorDatabase, BaseDatabaseConfig } from './base/base-vector-database';
+import { SimpleBM25, BM25Config } from './sparse/simple-bm25';
+export interface QdrantConfig extends BaseDatabaseConfig {
+    /**
+     * API key for Qdrant Cloud
+     * Optional for self-hosted instances
+     */
+    apiKey?: string;
+    /**
+     * Connection timeout in milliseconds
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * BM25 configuration for sparse vector generation
+     */
+    bm25Config?: BM25Config;
+}
+/**
+ * Qdrant Vector Database implementation using gRPC client
+ *
+ * Features:
+ * - Named vectors (dense + sparse)
+ * - Hybrid search with RRF fusion
+ * - BM25 sparse vector generation
+ * - Self-hosted and cloud support
+ *
+ * Architecture:
+ * - Dense vectors: From embedding providers (OpenAI, VoyageAI, etc.)
+ * - Sparse vectors: Generated using SimpleBM25 for keyword matching
+ * - Hybrid search: Combines both using Qdrant's prefetch + RRF
+ */
+export declare class QdrantVectorDatabase extends BaseVectorDatabase<QdrantConfig> {
+    private client;
+    private bm25Generator;
+    private readonly DENSE_VECTOR_NAME;
+    private readonly SPARSE_VECTOR_NAME;
+    constructor(config: QdrantConfig);
+    /**
+     * Initialize Qdrant client connection
+     */
+    protected initialize(): Promise<void>;
+    /**
+     * Create Qdrant client instance
+     */
+    private initializeClient;
+    /**
+     * Resolve address from config
+     * Unlike Milvus, Qdrant doesn't have auto-provisioning
+     */
+    protected resolveAddress(): Promise<string>;
+    /**
+     * Override to add client null check
+     */
+    protected ensureInitialized(): Promise<void>;
+    /**
+     * Qdrant doesn't require explicit collection loading
+     * Collections are loaded on-demand automatically
+     */
+    protected ensureLoaded(collectionName: string): Promise<void>;
+    /**
+     * Create collection with dense vectors only
+     */
+    createCollection(collectionName: string, dimension: number, description?: string): Promise<void>;
+    /**
+     * Create collection with hybrid search support (dense + sparse vectors)
+     */
+    createHybridCollection(collectionName: string, dimension: number, description?: string): Promise<void>;
+    /**
+     * Drop collection
+     */
+    dropCollection(collectionName: string): Promise<void>;
+    /**
+     * Check if collection exists
+     */
+    hasCollection(collectionName: string): Promise<boolean>;
+    /**
+     * List all collections
+     */
+    listCollections(): Promise<string[]>;
+    /**
+     * Insert documents with dense vectors only
+     */
+    insert(collectionName: string, documents: VectorDocument[]): Promise<void>;
+    /**
+     * Insert documents with hybrid vectors (dense + sparse)
+     */
+    insertHybrid(collectionName: string, documents: VectorDocument[]): Promise<void>;
+    /**
+     * Search with dense vectors only
+     */
+    search(collectionName: string, queryVector: number[], options?: SearchOptions): Promise<VectorSearchResult[]>;
+    /**
+     * Hybrid search with dense + sparse vectors using RRF fusion
+     */
+    hybridSearch(collectionName: string, searchRequests: HybridSearchRequest[], options?: HybridSearchOptions): Promise<HybridSearchResult[]>;
+    /**
+     * Delete documents by IDs
+     */
+    delete(collectionName: string, ids: string[]): Promise<void>;
+    /**
+     * Query documents with filter conditions
+     */
+    query(collectionName: string, filter: string, outputFields: string[], limit?: number): Promise<Record<string, any>[]>;
+    /**
+     * Check collection limit
+     * Qdrant doesn't have hard collection limits like Zilliz Cloud
+     */
+    checkCollectionLimit(): Promise<boolean>;
+    /**
+     * Parse Milvus-style filter expression to Qdrant filter format
+     *
+     * Example:
+     * - "fileExtension == '.ts'" -> { must: [{ key: 'fileExtension', match: { value: '.ts' } }] }
+     * - "fileExtension in ['.ts', '.js']" -> { must: [{ key: 'fileExtension', match: { any: ['.ts', '.js'] } }] }
+     */
+    private parseFilterExpression;
+    /**
+     * Get BM25 generator (for testing/debugging)
+     */
+    getBM25Generator(): SimpleBM25;
+}
+//# sourceMappingURL=qdrant-vectordb.d.ts.map

package/dist/vectordb/qdrant-vectordb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vectordb.d.ts","sourceRoot":"","sources":["../../src/vectordb/qdrant-vectordb.ts"],"names":[],"mappings":"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"}