QdrantRepository

A Mantle VectorRepository<T> implementation backed by a Qdrant vector collection.

Records are stored as Qdrant points. The idField value is the Qdrant point ID; all other fields are stored in the point payload. Call upsertVector to attach a real embedding — save / saveAll insert a zero vector placeholder that is later replaced.

The collection is created automatically on the first write if it does not exist.

Type Parameters

T

T extends Record<string, unknown>

The entity shape. Must extend Record<string, unknown>.

D

D = Partial<T>

The write shape (defaults to Partial<T>).

Implements

VectorRepository<T, D>

Constructors

Constructor

new QdrantRepository<T, D>(app): QdrantRepository<T, D>

Defined in: qdrant-repository.ts:49

Parameters

app

MantleApplication

Returns

QdrantRepository<T, D>

Properties

client

protected readonly client: QdrantClient

Defined in: qdrant-repository.ts:25

collectionName

abstract readonly collectionName: string

Defined in: qdrant-repository.ts:28

The Qdrant collection name to target.

createdAtField

readonly createdAtField: string = "createdAt"

Defined in: qdrant-repository.ts:37

Payload key written for auto-managed creation timestamps.

Default

"createdAt"

fieldMap

readonly fieldMap: Record<string, string> = {}

Defined in: qdrant-repository.ts:45

Entity-field-to-payload-key overrides, for a collection whose payload keys don’t match the entity (e.g. a brownfield collection using snake_case). Does not apply to idField — the point id is never stored in the payload.

Default

{}

idField

readonly idField: string = "id"

Defined in: qdrant-repository.ts:33

The payload key that stores the record id.

Default

"id"

timestamps

readonly timestamps: boolean = true

Defined in: qdrant-repository.ts:35

When true, save / saveAll / updateById / patchById write ISO-8601 timestamps.

Default

true

updatedAtField

readonly updatedAtField: string = "updatedAt"

Defined in: qdrant-repository.ts:39

Payload key written for auto-managed update timestamps.

Default

"updatedAt"

vectorSize

abstract readonly vectorSize: number

Defined in: qdrant-repository.ts:30

Number of dimensions for the vector space — must match the collection’s configuration.

Methods

count()

count(params?): Promise<number>

Defined in: qdrant-repository.ts:359

Parameters

params?

QueryParams

Returns

Promise<number>

Implementation of

VectorRepository.count

deleteById()

deleteById(id): Promise<T>

Defined in: qdrant-repository.ts:347

Parameters

id

Id

Returns

Promise<T>

Implementation of

VectorRepository.deleteById

deleteVector()

deleteVector(id): Promise<T>

Defined in: qdrant-repository.ts:112

Delete a vector and its associated record

Parameters

id

Id

Returns

Promise<T>

Implementation of

VectorRepository.deleteVector

describe()

describe(): RepositoryCapabilities

Defined in: qdrant-repository.ts:66

Optional capability introspection. All

Returns

RepositoryCapabilities

Mantlejs

adapters implement it; user repositories may omit it.

Implementation of

VectorRepository.describe

ensureCollection()

protected ensureCollection(): Promise<void>

Defined in: qdrant-repository.ts:55

Returns

Promise<void>

findAll()

findAll(params?): Promise<T[]>

Defined in: qdrant-repository.ts:118

Parameters

params?

QueryParams

Returns

Promise<T[]>

Implementation of

VectorRepository.findAll

findById()

findById(id): Promise<T | null>

Defined in: qdrant-repository.ts:228

Parameters

id

Id

Returns

Promise<T | null>

Implementation of

VectorRepository.findById

findPage()

findPage(params?): Promise<CursorPage<T>>

Defined in: qdrant-repository.ts:171

Fetch one page of results using Qdrant’s native scroll pagination. The returned cursor encodes Qdrant’s next_page_offset; pass it back as params.cursor for the next page. skip and sort are rejected — Qdrant does not return a next-page offset when order_by is in play, and offsets don’t compose with cursors.