NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #3101 most downloaded on pub.dev
Bones_API - A powerful API backend framework for Dart. It comes with a built-in HTTP Server, route handler, entity handler, SQL translator, and DB adapters.
Latest stable
1.35.1
Last release 8 days ago
08 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
388 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
- EntityReference: - Fix set for null value.
EntityReference:
set for null value.Optimize _resolveEntityHandler: avoid multiple null resolutions.
EntityReferenceBase:
_resolveEntityHandler: avoid multiple null resolutions._resolveEntity: avoid uncessary call to entityProvider when entity and id are null.resolveTypeName: avoid type.toString()._isInvalidEntityType: avoid multiple == calls.data_serializer: ^1.2.1
crypto: ^3.0.5
Your coding agent can read these notes before it upgrades. Set up the MCP server →
encodeConditionValuesWithOperator: Fix encoding for null values to use IS NULL and IS NOT NULL.
ConditionSQLEncoder:
encodeConditionValuesWithOperator: Fix encoding for null values to use IS NULL and IS NOT NULL.statistics: ^1.1.2
isJsonResponse: Improve logic for determining JSON response types.
APIModuleProxyHttpCaller:
isJsonResponse: Improve logic for determining JSON response types.isByteArrayResponse: Improve logic for determining raw bytes response types.swiss_knife: ^3.2.1
Added fieldsWithTypeAndAnnotations.
EntityHandler:
fieldsEntityAnnotations.fieldsWithTypeAndAnnotations.fieldsWithEntityReference, fieldsWithEntityReferenceList: ensure unmodifiable.fieldsWithTypeListEntityOrReference: do not return hidden fields (@EntityField.hidden()).sdk: '>=3.4.0 <4.0.0'
data_serializer: ^1.2.0
reflection_factory: ^2.4.4
statistics: ^1.1.1
collection: ^1.19.0
shelf: ^1.4.2
http: ^1.2.2
test: ^1.25.8
coverage: ^1.9.0
resolveRequestCredentials: call validateUnknownToken to allow external tokens.
APISecurity:
resolveRequestCredentials: call validateUnknownToken to allow external tokens.LoggerHandler: optimize logBuffered.
LoggerHandler: optimize logBuffered.APIToken, APICredential: added field refreshToken.
APIToken, APICredential: added field refreshToken.
APISecurity:
onNewAPIToken, validateUnknownToken, validateRefreshToken.shared_map: ^1.1.9
reflection_factory: ^2.4.3
Optimize _getEntityHandlerImpl.
EntityHandlerProvider:
_getEntityHandlerImpl.ClassReflectionEntityHandler:
copy.DBEntityRepository:
hasReferencedEntities.EntityResolutionRules:
isAnyEagerEntityType, isAnyEagerEntityTypeInfo, isAnyLazyEntityType, isAnyLazyEntityTypeInfo.EntityReference
fromEntityInstantiator and hasEntity.New EntityInstantiator and EntityInstantiatorHandler.
EntityHandler:
getIDFromMap and toEntitiesMapByIdMap.EntityRepository: added getEntityMapID.
Time: set all fields final.
APIResponse: added metric API-response-json.
reflection_factory: ^2.4.2
_selectEntries: add support for limit.
DBSQLMemoryAdapter:
_selectEntries: add support for limit._resolveValueAsUInt8List: handle hex: and base64: prefixed data.
EntityHandler:
_resolveValueAsUInt8List: handle hex: and base64: prefixed data.Change whereNotNull() to nonNulls.
EntitySource, EntityRepository:
EntityHandler:
getIDs.EntitySource, EntityRepository:
existIDs, selectIDsBy and selectIDsByQuery.DBRelationalAdapter:
parseIDs.New IterableEntityReferenceExtension and IterableEntityReferenceListExtension.
v1.7.5
New IterableEntityReferenceExtension and IterableEntityReferenceListExtension.
EntityReference: added idAsInt and idNotNullAsInt.
EntityReferenceList: added idsAsInt and idsNotNullAsInt.
## 1.7.4 - TimedMap: - Added keyTimeoutChecker ## 1.7.3 - MapAsCacheExtension: - Added getIfCached. - Exposed checkCachedEntry.
TimedMap:
MapAsCacheExtension:
getIfCached.checkCachedEntry.- MapAsCacheExtension: - Added getIfCached. - Exposed checkCachedEntry.
MapAsCacheExtension:
getIfCached.checkCachedEntry.New MapOfCachesExtension and RecordExtension.
New MapOfCachesExtension and RecordExtension.
reflection_factory: ^2.4.0
docker_commander: ^2.1.6
meta: ^1.15.0
archive: ^3.5.1
build_runner: ^2.4.10
test: ^1.25.5
coverage: ^1.8.0
Fix _parseConstraint for enums with single values.
DBPostgreSQLAdapter:
_parseConstraint for enums with single values.Added contextKeyPosition with the parameters position of the key.
ConditionParameter:
contextKeyPosition with the parameters position of the key.getValue: improve key and index resolution.contextPosition: the index is now resolved using all parameters, not only the positional ones.
baz will resolve contextPosition as 2 and not 1: foo == ? || bar == ?:x || baz == ?args: ^2.5.0
meta: ^1.14.0
googleapis_auth: ^1.6.0
test: ^1.25.3
Removed deprecated APIModuleHttpProxy (use APIModuleProxyHttpCaller).
APIModuleProxyTargetResolver: added parameter errorHandler.
APIModuleProxyCaller.resolveTarget: added parameter errorHandler.
APIModuleProxyDirectCaller and APIModuleProxyHttpCaller:
errorHandler.defaultErrorHandler.APIModuleProxyCallerListener
defaultErrorHandler.APIModuleProxyCallerResponseError:
request, responseStatus, module, methodName and parameters.Removed deprecated APIModuleHttpProxy (use APIModuleProxyHttpCaller).
APIToken: fix the constructor initialization of field duration.
APIToken: fix the constructor initialization of field duration.DBSQLMemoryAdapter: optimize _selectEntries for Conditions that only depends on IDs.
Condition: added isIDCondition
DBSQLMemoryAdapter: optimize _selectEntries for Conditions that only depends on IDs.
Added isLoggingAll and isLoggingDB.
LoggerHandler:
isLoggingAll and isLoggingDB.parent, rootLogger and root.TableScheme: optimize getFieldReferencedTable.
TableScheme: optimize getFieldReferencedTable.
DBSQLMemoryAdapter:
_resolveEntityMap and _resolveEntityFieldRelationshipTable.APIServerConfig: added logQueue.
EntityRepository:
_storeAllFromJsonImpl: optimize loading of entities from JSON (split in blocks of 100 entries per store).- reflection_factory: ^2.3.4
getFields: call reflection.getJsonFieldsVisibleValues (avoid issues with JsonHidden.fields).
ClassReflectionEntityHandler:
getFields: call reflection.getJsonFieldsVisibleValues (avoid issues with JsonHidden.fields).reflection_factory: ^2.3.3
Added useLogQueue, disableLogQueue and enableLogQueue.
LoggerHandler:
useLogQueue, disableLogQueue and enableLogQueue.New APIModuleProxyCallerError:
APIModuleProxyCallerResponseError.APIModuleProxyDirectCaller:
APIModuleProxyCallerResponseError for APIResponses with ERROR status.APIModuleProxyHttpCaller:
APIModuleProxyCallerResponseError for error HttpResponses.Optimize DBAdapter and DBEntityRepository.
async_extension: ^1.2.12
mercury_client: ^2.2.2
async_extension: ^1.2.9
googleapis_auth: ^1.5.1
build_runner: ^2.4.9
EntityHandler: added normalizeID and normalizeIDs.
EntityHandler: added normalizeID and normalizeIDs.
EntityReference.fromID: use _normalizeID.
EntityReferenceList.fromIDs: use _normalizeIDs.
Added field development and serverResponseDelay.
APIServerConfig:
development and serverResponseDelay.server-response-delay.APISecurity:
disposeAuthenticationData.disposeAuthenticationToken.APITokenStore:
removeTokenData.Fix toJsonEncodable to allow rules to be applied to sub-entities.
EntityAccessRules:
toJsonEncodable to allow rules to be applied to sub-entities.APIResponse extension on Future and FutureOr:
payloadAsyncOr.LoggerHandler:
flushMessages: added parameter delay.async_extension: ^1.2.7
reflection_factory: ^2.3.1
postgres: ^2.6.4
googleapis_auth: ^1.5.0
Added idNotNull, idAs and idNotNullAs
1.6.4
EntityReference:
idNotNull, idAs and idNotNullAsEntityReferenceList:
idsAs and idsNotNullAs.LoggerHandler:
flushMessages.APIServer and APIServerWorker:
_startImpl: call flushMessages before return.APIServer: allow return of List<int> as JSON.APIServer: allow return of List as JSON.
APIServer: allow return of List<int> as JSON.Optimize _resolveRelationshipFields.
DBEntityRepository:
_resolveRelationshipFields.LoggerHandlerIO:
printMessage: add a message queue for printing log messages asynchronously.http: ^1.2.1
- statistics: ^1.1.0 - swiss_knife: ^3.2.0 - shared_map: ^1.1.8 - mercury_client: ^2.2.1 - meta: ^1.12.0 - logging: ^1.2.0 - mime: ^1.0.5 - gcloud: ^0
statistics: ^1.1.0
swiss_knife: ^3.2.0
shared_map: ^1.1.8
mercury_client: ^2.2.1
meta: ^1.12.0
logging: ^1.2.0
mime: ^1.0.5
gcloud: ^0.8.12
path: ^1.9.0
archive: ^3.4.10
http: ^1.2.0
build_runner: ^2.4.8
test: ^1.25.2
Dart 3.3.0 compatibility. - sdk: '>=3.3.0 <4.0.0' - data_serializer: ^1.1.0 - yaml_writer: ^2.0.0 - project_template: ^1.1.0 - hotreloader: ^4.2.0
Dart 3.3.0 compatibility.
sdk: '>=3.3.0 <4.0.0'
data_serializer: ^1.1.0
yaml_writer: ^2.0.0
project_template: ^1.1.0
hotreloader: ^4.2.0
ClassReflectionEntityHandler.getFields: optimize using reflection.getFieldsValues.
ClassReflectionEntityHandler.getFields: optimize using reflection.getFieldsValues.
async_events: ^1.1.0
reflection_factory: ^2.3.0
Added generateAddUniqueConstraintAlterTableSQL.
SQLGenerator:
generateAddUniqueConstraintAlterTableSQL.DBSQLAdapter:
_checkDBTablesImpl: Added check for missingReferenceConstraintsSQLs, missingUniqueConstraintsSQLs and missingEnumConstraintsSQLs.TableUniqueConstraint.EntityHandler:
getFieldsEnumTypes, getFieldsEntityTypes and getAllFieldsWithEntityAnnotation.DBException and TransactionErrorResolver.DBAdapterException:
previousError.DBPostgreSQLAdapter:
resolveError: pass previousError.RecursiveToString.RecursiveToString interface to EntityFieldInvalid and TransactionOperation.Added index for relationship tables.
DBSQLMemoryAdapter:
InitializationStatus:
_initializingTime and _initializedTime.Fix DBPostgreSQLAdapter._parseConstraint.
DBPostgreSQLAdapter._parseConstraint.APIModuleProxyCallerListener: fix resolveResponse for null response.
APIModuleProxyCallerListener: fix resolveResponse for null response.EntityAccessRules:
toJsonEncodable (moved from APIServer).New APIModuleProxyCallerListener base class.
APIModuleProxyDirectCaller:
responsesAsJson.reflection_factory: ^2.2.8
Added toJsonEncodable (moved from APIServer).
EntityAccessRules:
toJsonEncodable (moved from APIServer).New APIModuleProxyCallerListener base class.
APIModuleProxyDirectCaller:
responsesAsJson.reflection_factory: ^2.2.8
v1.5.22 - check enum constraints by @gmpassos in https://github.com/Colossus-Services/bones_api/pull/60
Full Changelog: https://github.com/Colossus-Services/bones_api/compare/1.5.21...1.5.22
DBAdapterCapability:
constraintSupport.TableScheme:
constraints.TableConstraint, TablePrimaryKeyConstraint and TableEnumConstraint.SQLGenerator:
generateAddEnumConstraintAlterTableSQL.MapAsCacheExtension:
_checkCachedEntry to handle TimedMap.checkEntry._resolveRequestParameterValueAsBytes: allow hex:... format.
APIRouteBuilder:
_resolveRequestParameterValueAsBytes: allow hex:... format.Better error message for null getRepositoryAdapterByTableName and getEntityRepositoryByType.
getRepositoryAdapterByTableName and getEntityRepositoryByType.- New DateTimeToTimeExtension: - New toTime. - reflection_factory: ^2.2.7 - coverage: ^1.7.2
New DateTimeToTimeExtension:
toTime.reflection_factory: ^2.2.7
coverage: ^1.7.2
- shelf_gzip: ^4.1.0
- APIServerWorker: - Improve error 500 logging.
APIServerWorker:
added resolveBodySync -APIRequest, APIResponse and Transaction.
APIServer:
resolveBodySync
-APIRequest, APIResponse and Transaction.disposeAsync.APIServerWorker:
_processAPIResponse: optimize Response resolution.APIResponse.disposeAsync instead of .dispose.-APIRequest, APIResponse and Transaction.
-APIRequest, APIResponse and Transaction.
dispose.APIServerWorker._processAPIResponse: call APIResponse.dispose.DBMySQLAdapter and DBPostgreSQLAdapter:
DBMySQLAdapter and DBPostgreSQLAdapter:
bones_api.log.max_file_length, bones_api.log.max_rotation_files.
LoggerHandlerIO:
APIPlatform properties:
bones_api.log.max_file_length, bones_api.log.max_rotation_files.LogFileRotate:
needRotation.APIPlatform:
getPropertyAs, propertiesKeys, setProperty and applyProperties.DBAdapter:
isConnectionValid: added parameter checkUsage.Added properties: cacheStaticFilesResponses, staticFilesCacheMaxMemorySize and staticFilesCacheMaxContentLength.
APIServerConfig:
cacheStaticFilesResponses, staticFilesCacheMaxMemorySize and staticFilesCacheMaxContentLength.APIConfig:
getAs and getPath: also tries to parse the value to the returned type.- New APIServerResponseCache.
APIServerResponseCache.printZoneError: reduce print calls.
printZoneError: reduce print calls.
shared_map: ^1.1.7
petitparser: ^6.0.2
- reflection_factory: ^2.2.5 - shared_map: ^1.1.6
Added _resolveTransaction: improve current Transaction resolution.
EntityHandler:
_resolveTransaction: improve current Transaction resolution.DBSQLMemoryAdapter:
catchFromPool/releaseIntoPool to simulate connection/context usage
and indicate heavy use of connections in tests.generateCreateTableSQL: fix CONSTRAINT of fields with EntityReference.
SQLGenerator:
generateCreateTableSQL: fix CONSTRAINT of fields with EntityReference.- APIRepository: - Expose countByQuery.
APIRepository:
countByQuery.- lints: ^3.0.0 - Apply new lints fixes. - shared_map: ^1.1.5
Ensure that _sessionSet (APISessionSet) is using _sharedStoreField.
APISecurity:
_sessionSet (APISessionSet) is using _sharedStoreField.APITokenStore:
_resolveSharedTokensByUsername from constructor, to fully pre-initialize it.shared_map: ^1.1.4
- shared_map: ^1.1.1
One column per quarter.