qdrant_dart 0.6.0

A small, idiomatic REST client for Qdrant collections, points, payloads, and vector search.

Changelog

0.6.0 - 2026-07-17

• Made CollectionInfo.pointsCount and indexedVectorsCount nullable to match Qdrant v1.12.0 through v1.18.2 when statistics are unavailable.
• Made VectorValue and FilterCondition SDK-owned, non-sealed hierarchies so future protocol variants do not require callers to handle them exhaustively.
• Made PointSelector.filter require a non-null filter and reject base URLs containing user info so credentials cannot appear in diagnostics.
• Accepted empty sparse vectors, widened default dense point inputs to any Iterable<num>, and added default-dense plus named-sparse points.
• Mapped incompatible successful responses to QdrantException with HTTP and request context instead of leaking a bare FormatException.
• Added real-server coverage for sparse-only and mixed default-dense/sparse collections against both supported Qdrant images, plus a Dart 3.0.7 CI gate.
• Published the compatibility and deprecation policy for the v1 API freeze.

This is the final pre-v1 API candidate. Migrating from v0.5 requires handling nullable collection counts and avoiding exhaustive switches over VectorValue or FilterCondition. Code that passed null to PointSelector.filter or embedded credentials in baseUrl must use a real Filter or the apiKey parameter respectively.

0.5.0 - 2026-07-17

• Added atomic collection-alias creation, deletion, renaming, global listing, and per-collection listing for production collection cutovers.
• Added runtime optimizer indexing-threshold updates and exposed the current threshold in collection details for controlled bulk ingestion.
• Added a manual Qdrant Cloud smoke workflow that uses the same public client API as self-hosted Qdrant and cleans up its temporary collection and alias.
• Added real-server coverage for aliases and collection tuning against the minimum supported qdrant/qdrant:v1.12.0 and target qdrant/qdrant:v1.18.2 images.

This release completes the production-operations milestone. The Cloud smoke flow was verified against the target Docker image; running it against Qdrant Cloud requires QDRANT_URL and QDRANT_API_KEY secrets in the documented GitHub Environment. Snapshots, shard administration, cluster management, and broader collection tuning remain deferred until real deployments require them.

0.4.0 - 2026-07-17

• Added typed vector prefetches with named-vector selection, payload filters, and bounded candidate limits for multi-stage Query API requests.
• Added queryRrf to fuse named dense and sparse prefetch rankings with Qdrant's default Reciprocal Rank Fusion.
• Added a complete dense-plus-sparse hybrid-search flow against the minimum supported qdrant/qdrant:v1.12.0 and target qdrant/qdrant:v1.18.2 images.

This release completes the hybrid-query milestone without changing the 0.3 point or vector models. Configurable RRF constants and weights are intentionally not exposed because they require newer Qdrant versions than the declared minimum.

0.3.0 - 2026-07-17

• Added payload set, overwrite, key deletion, and clear operations for point-ID and filter selectors.
• Added partial default, named dense, and sparse vector updates plus named vector deletion without replacing the rest of a point.
• Added filter-based point deletion and exact or approximate point counts.
• Added bounded sequential batch upserts that return every Qdrant UpdateResult in request order.
• Added real-server coverage for every new operation against the minimum supported qdrant/qdrant:v1.12.0 and target qdrant/qdrant:v1.18.2 images.

This release completes the production data lifecycle milestone. Its public surface remains REST-first and standard-library-only; it does not add retries, concurrent ingestion, embeddings, or framework-specific abstractions.

0.2.0 - 2026-07-17

• Added named dense and sparse vector configuration, point values, response selectors, and queries.
• Added extensible filter conditions with nested Boolean groups and point-ID matching while retaining FieldCondition.match and FieldCondition.range.
• Added payload-index creation, inspection, and deletion for keyword, integer, float, geo, text, bool, datetime, and UUID fields.
• Added real-server failure checks and compatibility coverage against the minimum supported qdrant/qdrant:v1.12.0 and target qdrant/qdrant:v1.18.2 images.

This release makes the planned pre-1.0 vector-model revision. Replace VectorParams with CollectionVectors.dense(DenseVectorParams(...)), wrap query values in DenseVector or SparseVector, and replace withVector with withVectors plus a VectorSelector. Default dense Point construction and the PointRecord.vector convenience getter remain available.

0.1.0 - 2026-07-16

• Added HTTP/HTTPS client configuration, API-key authentication, request timeouts, and typed QdrantException failures.
• Added collection create, inspect, list, and delete operations for one default dense vector configuration.
• Added point upsert, retrieval, ID-based deletion, ID-ordered scrolling, and automatic scroll pagination.
• Added dense-vector queries with match and numeric range payload filters using must, should, and must_not clauses.
• Added Docker-backed compatibility tests against qdrant/qdrant:v1.18.2.

Compatibility is limited to the documented v0.1 surface. Named and sparse vectors, nested filters, collection tuning, gRPC, and administrative endpoints are not supported in this release.