NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
Connector for Azure Cosmos DB on Dart and Flutter platforms. Supports Cosmos DB SQL API, indexing policies, users, permissions, and spatial types.
Last release 5 months ago
05 May 2026
Ships unpredictably
gaps range from 8 days to 1.2 years
Nearly every release is documented
notes for 22 of 22 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
22 releases · first in 2022
One column per quarter.
- Bump murmur3 to ^3.0.0.
murmur3 to ^3.0.0.Add support for stored procedures, user-defined functions and triggers. See accessors sprocs, udfs and triggers in CosmosDbContainer. Please refer to
sprocs, udfs and triggers in CosmosDbContainer. Please refer to unit tests for examples calling custom scripts.conflictResolutionPolicy on containers.defaultTtl on containers.analyticalStorageTtl on containers (experimental, untested).BREAKING CHANGE: reworked the access-control classes and methods. useAuthorization()/usePermission() are deprecated in favor of grantAccess(), and cle…
useAuthorization()/usePermission() are deprecated in favor of grantAccess(), and clearAuthorization()/clearPermission() in favor of revokeAccess(). Optional arguments authorization and permission are replaced by accessControl.Object instead of dynamic).Rename Authorization to CosmosDbAuthorization and make it public.
Authorization to CosmosDbAuthorization and make it public.authorization parameter to methods already supporting CosmosDbPermission.usePermission obsolete: please use useAuthorization instead. A CosmosDbAuthorization can be built from a CosmosDbPermission.InvalidTokenException to ParsingException.InvalidTokenException as an HTTP exception for invalid or missing tokens.Fix lints warnings reported by pub.dev.
Add support for older containers where PartitionKeySpec.version is null -- fixes https://github.com/d-markey/azure_cosmosdb/issues/12.
PartitionKeySpec.version is null -- fixes https://github.com/d-markey/azure_cosmosdb/issues/12.Add none constructor to throughput for serverless config - PR https://github.com/d-markey/azure_cosmosdb/pull/10 by https://github.com/djkingCanada -
- Upgrade version of http.
http.- Enable support for Dart 3.
- Upgrade version of murmur3.
murmur3.Improved documentation & tests.
Breaking changes - several classes have been renamed e.g. [CosmosDbCollection] --> [CosmosDbContainer], APIs dealing with bare String partition keys n…
['/id']. When opening an existing collection, the [PartitionKeySpec] is loaded from the Cosmos DB response. [PartitionKeySpec.from] extracts the partition key from a [BaseDocument] according to the partition key definition.preview: true.String partition keys now use [PartitionKey]/[PartitionKeySpec], etc._client.dart: return early with null upon a "204 - No Content" status code (fix for https://github.com/d-markey/azure_cosmosdb/issues/1). Also skip pa
_client.dart: return early with null upon a "204 - No Content" status code (fix for https://github.com/d-markey/azure_cosmosdb/issues/1). Also skip parsing the response body if content-length is zero.When provided, the document attributes takes over the id value. The id parameter is deprecated and will eventually be removed.
@.CosmosDbCollection.get() to retrieve the latest version of a document. When the document has mixin EtagMixin, the value of the _etag field is sent to Cosmos DB in the If-None-Match header (causing a response with HTTP status code 304 "Not modified", in which case the document is returned as is).document parameter for CosmosDbCollection.delete(). When provided, the document attributes takes over the id value. The id parameter is deprecated and will eventually be removed.checkEtag parameter (default value: true) for CosmosDbCollection.delete() and CosmosDbCollection.replace(). When the document has mixin EtagMixin and checkEtag is true, the value of the _etag field is sent to Cosmos DB in the If-Match header. If the document has been updated in the meantime, a PreconditionFailureException exception will be thrown because the _etag field's value will have changed in Cosmos DB (causing a response with HTTP status code 412 "Precondition failure").PartitionKey field on CosmosDbCollection and marked PartitionKeys as obsolete. Use PartitionKey instead.PartitionKeyMixin to support custom partition keys in documents.Added support for throughput when creating a database or a collection.
Renamed Line class to LineString.
Line class to LineString.Renamed Exception class to CosmosDbException (could be a breaking change).
Point to represent spatial positions.
Line, Polygon, MultiPolygon.Exception class to CosmosDbException (could be a breaking change).ClassName have also been renamed to CosmosDbClassName.
User, Collection, ... were too generic and could cause conflict with your code or other libraries.DebugHttpClient from the mainstream azure_cosmosdb library (could be a breaking change).
azure_cosmosdb_debug instead.Add support for indexing policies when creating collections.
Re-enable Web platforms support.
- Improve description.
Added default retry policy from package https://pub.dev/packages/retry.
Support for Server, Databases, Collections, Users and Permissions
Your coding agent can read these notes before it upgrades. Set up the MCP server →