Interface VectorStore

Abstract interface for vector store operations.

Enables dependency inversion and easier testing.

interface VectorStore {
    delete(ids: string[]): Promise<void>;
    ensureCollection(): Promise<void>;
    ensureTextIndex(fieldName: string): Promise<void>;
    getCollectionInfo(): Promise<CollectionInfo>;
    getPayload(id: string): Promise<Record<string, unknown> | null>;
    hybridSearch(
        vector: number[],
        queryText: string,
        limit: number,
        textWeight: number,
        filter?: Record<string, unknown>,
    ): Promise<SearchResult[]>;
    scroll(
        filter?: Record<string, unknown>,
        limit?: number,
    ): AsyncGenerator<ScrolledPoint>;
    search(
        vector: number[],
        limit: number,
        filter?: Record<string, unknown>,
        offset?: number,
    ): Promise<SearchResult[]>;
    setPayload(ids: string[], payload: Record<string, unknown>): Promise<void>;
    upsert(points: VectorPoint[]): Promise<void>;
}

Implemented by

VectorStoreClient

Index

Methods

delete ensureCollection ensureTextIndex getCollectionInfo getPayload hybridSearch scroll search setPayload upsert

Methods

delete

delete(ids: string[]): Promise<void>
Delete points by their IDs.
Parameters
- ids: string[]
  The point IDs to delete.
Returns Promise<void>
- Defined in vectorStore/types.ts:81

ensureCollection

ensureCollection(): Promise<void>
Ensure the collection exists with correct configuration.

Returns Promise<void>
- Defined in vectorStore/types.ts:67

ensureTextIndex

ensureTextIndex(fieldName: string): Promise<void>
Create a full-text payload index on the specified field.
Parameters
- fieldName: string
  The payload field to index.
Returns Promise<void>
- Defined in vectorStore/types.ts:137

getCollectionInfo

getCollectionInfo(): Promise<CollectionInfo>
Get collection info including point count, dimensions, and payload field schema.

Returns Promise<CollectionInfo>
- Defined in vectorStore/types.ts:102

getPayload

getPayload(id: string): Promise<Record<string, unknown> | null>
Get the payload of a point by ID.
Parameters
- id: string
  The point ID.
Returns Promise<Record<string, unknown> | null>
The payload, or null if the point doesn't exist.
- Defined in vectorStore/types.ts:97

hybridSearch

hybridSearch(
    vector: number[],
    queryText: string,
    limit: number,
    textWeight: number,
    filter?: Record<string, unknown>,
): Promise<SearchResult[]>
Hybrid search combining dense vector and full-text match with RRF fusion.
Parameters
- vector: number[]
  The query vector.
- queryText: string
  The raw query text for full-text matching.
- limit: number
  Maximum results to return.
- textWeight: number
  Weight for text results in RRF (0–1).
- Optionalfilter: Record<string, unknown>
  Optional Qdrant filter.
Returns Promise<SearchResult[]>
An array of search results.
- Defined in vectorStore/types.ts:149

scroll

scroll(
filter?: Record<string, unknown>,
limit?: number,
): AsyncGenerator<ScrolledPoint>
Scroll through all points matching a filter.
Parameters
- Optionalfilter: Record<string, unknown>
  Optional Qdrant filter.
- Optionallimit: number
  Page size for scrolling.
Returns AsyncGenerator<ScrolledPoint>
Yields
Scrolled points.
- Defined in vectorStore/types.ts:127

search

search(
    vector: number[],
    limit: number,
    filter?: Record<string, unknown>,
    offset?: number,
): Promise<SearchResult[]>
Search for similar vectors.
Parameters
- vector: number[]
  The query vector.
- limit: number
  Maximum results to return.
- Optionalfilter: Record<string, unknown>
  Optional Qdrant filter.
- Optionaloffset: number
  Optional result offset.
Returns Promise<SearchResult[]>
An array of search results.
- Defined in vectorStore/types.ts:113

setPayload

setPayload(ids: string[], payload: Record<string, unknown>): Promise<void>
Set payload fields for the specified point IDs.
Parameters
- ids: string[]
  Point IDs to update.
- payload: Record<string, unknown>
  Payload fields to set.
Returns Promise<void>
- Defined in vectorStore/types.ts:89

upsert

upsert(points: VectorPoint[]): Promise<void>
Upsert points into the collection.
Parameters
- points: VectorPoint[]
  The points to upsert.
Returns Promise<void>
- Defined in vectorStore/types.ts:74

Interface VectorStore

Implemented by

Index

Methods

Methods

delete

Parameters

Returns Promise<void>

ensureCollection

Returns Promise<void>

ensureTextIndex

Parameters

Returns Promise<void>

getCollectionInfo

Returns Promise<CollectionInfo>

getPayload

Parameters

Returns Promise<Record<string, unknown> | null>

hybridSearch

Parameters

Returns Promise<SearchResult[]>

scroll

Parameters

Returns AsyncGenerator<ScrolledPoint>

Yields

search

Parameters

Returns Promise<SearchResult[]>

setPayload

Parameters

Returns Promise<void>

upsert

Parameters

Returns Promise<void>

Settings

On This Page