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 11 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.
Fix name and version resolution
APIServerConfig:
name and version resolutionHolds the configuration need for APIServer and APIServerWorker.
new APIServerConfig:
APIServer and APIServerWorker.Created an abstract base class _APIServerBase for APIServer and APIServerWorker.
start and stop methods, delegating to startImpl and stopImpl.isStarting to determine if the server is in the process of starting.APIServer
APIServerWorker instances using isolates. Main worker starts normally.New APIServerWorker to handle multi-worker APIServer.
_processWhileInitializing to handle API requests while the server is still initializing,
including a timeout for initialization.APIRequest:
transactions field, automatically populated with all the Transactions of the request.APIRequest and APIResponse:
description parameter.Transactions duration to Server-Timing.APIRoot:
isIsolateCopy.DBAdapterCapability:
multiIsolateSupport;DBAdapter
auxiliaryMode and enableAuxiliaryMode.DBSQLMemoryAdapter and DBObjectMemoryAdapter don't support auxiliaryMode, since they don't support multiIsolateSupport.SQLGenerator.generateCreateTableSQL: skip annotated hidden fields.
APISessionSet: using SharedStoreField and SharedMapField to store the the sessions.
New APITokenStore:
Isolates.shared_map: ^1.0.10
args_simple: ^1.1.0
coverage: ^1.7.1
vm_service: ^13.0.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Simple workaround for Kernel/Fasta issue https://github.com/dart-lang/sdk/issues/54062
sdk: '>=3.2.0 <4.0.0'
reflection_factory: ^2.2.4
Fix cached file parent directory creation.
DBObjectGCSAdapter:
APIConfig: fix resolution of variables keys.
APIConfig: fix resolution of variables keys.
DBAdapter:
populateSourceVariables: allow variables in populate source.Improved related tests.
data_serializer: ^1.0.12
hotreloader: ^4.1.0
DBSQLMemoryAdapter._findFieldsReferencedTables: Fix referenced field name.
DBSQLMemoryAdapter._findFieldsReferencedTables: Fix referenced field name.Fix _findFieldsReferencedTables:
APIConfig: added field test.DBSQLMemoryAdapter:
_findFieldsReferencedTables:
DBSQLAdapter:
_checkDBTableScheme:
checkDBTableField:
EntityReferenceList fields.EntityReferenceBase: added isNotNull.
EntityReferenceBase: added isNotNull.NullEntityReferenceBaseExtension and NullEntityReferenceExtension.APIModuleProxy: added ignoreMethods.
APIModuleProxy: added ignoreMethods.Added EntityHandler.constructors.
Added EntityHandler.constructors.
EntityHandler._createFromMapDefaultImpl: improve UnsupportedError message.
statistics: ^1.0.26
data_serializer: ^1.0.11
docker_commander: ^2.1.5
postgres: ^2.6.3
archive: ^3.4.5
collection: ^1.18.0
dependency_validator: ^3.2.3
coverage: ^1.6.4
test: ^1.24.7
New factory constructor fetchTypes.
EntityResolutionRules:
fetchTypes.docker_commander: ^2.1.2
New abstract class DBConnectionWrapper:
New abstract class DBConnectionWrapper:
DBMySqlConnectionWrapper and PostgreSQLConnectionWrapper.Pool
createPoolElementForced (non-nullable)._catchFromPopulatedPool: now can return null.DBAdapter:
connectionInactivityLimit.isConnectionValid:
MySQL and PostgreSQL: checking connection.isInactive.Using Graph to resolve the correct order of CreateTableSQL and to populate samples.
Checking SQLBuilder order and warning invalid orders.
EntityReferenceList.fromJson:
APIRouteBuilder._apiMethodInvocation:
FutureOr<APIResponse> or return an APIResponse.error.graph_explorer: ^1.0.2
ascii_art_tree: ^1.0.6
docker_commander: ^2.1.1
petitparser: ^6.0.1
archive: ^3.3.9
getTableScheme, getTableSchemeImpl and getTableSchemeForEntityRepository:
getTableScheme, getTableSchemeImpl and getTableSchemeForEntityRepository:
contextID parameter to allow multiple calls with the
same contextID to share internal caches.DBMySQLAdapter and DBPostgreSQLAdapter:
getTableScheme and getRepositoriesSchemes
with use of contextID and internal shared caches.async_extension: ^1.2.5
_checkDBTableScheme: ignore fields annotated with EntityField.hidden.
DBSQLAdapter:
_checkDBTableScheme: ignore fields annotated with EntityField.hidden.Integrate LetsEncrypt logger with APIServer logger.
APIServer:
LetsEncrypt logger with APIServer logger.bestOrder: fix dependencies order of table relationships.
SQLBuilderListExtension:
bestOrder: fix dependencies order of table relationships.EntityRepositoryProviderExtension:
storeAllFromJson: store by allRepositories orders.- async_extension: ^1.2.3 - docker_commander: ^2.1.0
New FutureOrAPIResponseExtension and FutureAPIResponseExtension.
New FutureOrAPIResponseExtension and FutureAPIResponseExtension.
async_extension: ^1.2.2
reflection_factory: ^2.2.0
Better resolution of MimeType when content-type header is not provided.
APIServer:
_resolvePayload:
MimeType when content-type header is not provided.MimeTypes: use charsetEncoding to decode the String.Uint8List.async_extension: ^1.2.0
data_serializer: ^1.0.10
gcloud: ^0.8.11
test: ^1.24.6
vm_service: ^11.9.0
resolveValueToCompatibleType: force DateTime.toUtc() to avoid DB adapter issues.
ConditionSQLEncoder:
resolveValueToCompatibleType: force DateTime.toUtc() to avoid DB adapter issues.Transaction
waitOperation.
timeout parameter.EntityRepository:
ensureStored implementations (DBRelationalEntityRepository, DBEntityRepository, IterableEntityRepository):
store of the same entity in the same [Transaction].
RecursiveRelationshipLoopError if a loop is detected.EntityFieldInvalid:
operation.Added missing APIRequestMethod.HEAD.
EntityHandler:
_validateFieldValueImpl.APIDBModule:
HTMLInput).LogFileRotate:
needRotation for a log file not created yet.async_events: ^1.0.12
stream_channel: ^2.1.2
gcloud: ^0.8.10
postgres: ^2.6.2
petitparser: ^5.4.0
Better alias naming for _ref and _rel tables.
ConditionElement:
parent.isInner.EncodingContext:
resolveEntityAlias:
_ref and _rel tables.DBRelationalEntityRepository._getCachedEntitiesRelationships:
EntityReferenceList and EntityReference values.New LogFileRotate (used by default when logging to files).
APIServer: log Response.internalServerError (error 500 responses) as severe.
shelf_letsencrypt: ^1.2.1
http: ^1.1.0
Update bones_api_template.tar.gz.
bones_api_template.tar.gz.encodeEncodingValueList: fix SQL encoding of empty list as ( null ) and not ( ).
ConditionEncoder:
encodeEncodingValueList: fix SQL encoding of empty list as ( null ) and not ( ).logErrorMessage and logDBMessage: fix resolution of MessageLogger.
logErrorMessage and logDBMessage: fix resolution of MessageLogger.Allow log.all, log.error and log.db to files.
log.all, log.error and log.db to files.DBAdapter:
boot hierarchy.registerAsDbLogger loggers of implementations of DBAdapter.LoggerHandler:
resolveLogDestiny and logBuffered.DBAdapterException:
operation.Use internal Quick Sort algorithm for better pivot selection (producing a better order of elements).
SQLBuilderListExtension:
bestOrder:
Ignores framework methods from APIModule that could be interpreted as routes.
APIRouteBuilder.apiMethod:
APIModule that could be interpreted as routes.SQLBuilder:
mainTable getter.
sorteByName).resource_portable: ^3.1.0
collection: ^1.17.2
test: ^1.24.4
vm_service: ^11.8.0
Initializable._finalizeInitializationWithDeps:
Initializable._finalizeInitializationWithDeps:
Initializable: wait for still initializing dependencies.InitializationChain._completeCircularDependency:
Completer is already completed before call complete.ConditionSQLEncoder.keyFieldReferenceToSQL: throw exception when a field can't by found in table.
GroupConditionOR.cast.ConditionSQLEncoder.keyFieldReferenceToSQL: throw exception when a field can't by found in table.Added APIModuleProxyCaller and APIModuleProxyDirectCaller.
APIModuleProxyCaller and APIModuleProxyDirectCaller.APIModuleHttpProxy to APIModuleProxyHttpCaller.Added StringUtils.toLowerCaseSimpleCached.
Added StringUtils.toLowerCaseSimpleCached.
Optimize Json.defaultFieldNameResolver.
Optimize FieldsFromMap.getFieldsValuesFromMap.
async_extension: ^1.1.1
reflection_factory: ^2.1.4
_onErrorZoneUncaughtError: get the error's Transaction and pass it to printZoneError as message.
New WeakList.
Added DBAdapter.instances.
Transaction:
_onErrorZoneUncaughtError: get the error's Transaction and pass it to printZoneError as message.Transaction.openInstances.canPropagate to indicated that a Transaction can have multiple operations.initTime, endTime and duration getters._onExecutionError: only logs and rethrows the error in the 1st error notification._abortImpl:
_transactionCompleter.complete instead of completeError to avoid issues with hidden error Zone.TransactionOperation:
initTime, endTime and duration getters.TransactionAbortedError:
abortError to error.abortStackTrace to errorStackTrace.Added APIRouteConfig.
APIRouteHandler.call: log response time.
DBMySQLAdapter and DBPostgreSQLAdapter.
minConnections and maxConnections from config.getTableSchemeImpl and getTableFieldsTypesImpl: fix releaseIntoPool and disposePoolElement behavior.DBEntityRepository: optimize _getRelationshipFields.
DBAdapter:
isTransactionWithSingleOperation.executeTransactionOperation: identify single operation transactions.createPoolElement: respect maxConnections with correct poolAliveElementsSize calculation.cancelTransactionResultWithError, throwTransactionResultWithErrorandresolveTransactionResult`.
openTransaction result resolution.Pool:
poolDisposedElementsCount to also count _invalidatedElementsCount._catchFromEmptyPool:
createPoolElement(force: true) if reached the limit and can't catch a reused element.InitializationStatus:
finalizing status.InitializationChain:
_isParent
initializable if it exists in the parent's tree.Initializable
_doInitializationImpl: allow circular initialization with timeout.lints: ^2.1.1
build_runner: ^2.4.5
_resolveEntitiesSubEntities: fix passing of parameter resolutionRules on special case.
DBEntityRepository
_resolveEntitiesSubEntities: fix passing of parameter resolutionRules on special case.args: ^2.4.2
_redirectToHttpsMiddleware: do not redirect /.well-known/acme-challenge/ paths.
APIServer:
_redirectToHttpsMiddleware: do not redirect /.well-known/acme-challenge/ paths.Convert Enum values to String calling Enum.name.
ConditionEncoder:
_resolveValueToTypeImpl:
Enum values to String calling Enum.name.Enum values to int|num|BigInt calling Enum.index.Now checks for missing reference columns.
DBSQLAdapter:
ALTER TABLE with CONSTRAINTs.SQLGenerator:
generateAddColumnAlterTableSQL:
FOREIGN KEY and UNIQUE.buildSQL: implement ifNotExists for ADD COLUMN.
AlterTableSQL:
indexes.buildSQL: implement ifNotExists for ADD COLUMN.SQLGenerator:
generateAddColumnAlterTableSQL.DBSQLAdapter:
checkDBTables:
ALTER TABLE SQLs to fix missing table columns.Added checkDB: checks DB tables and fields.
DBAdapter:
checkDB: checks DB tables and fields.
generateTables to checkDB.createPoolElement: optimize calls to createConnection when creating multiple connections simultaneously.FieldsFromMap:
getFieldsKeysInMap.TableScheme:
relationshipTables.EntityHandler:
valueToDynamicNumber for DateTime types.APIEntityTypeNullableExtension to avoid resolution to APIEntityObjectExtension on Type? variables.SQLBuilder: added logger and messages.DBMySQLAdapter:
TIME SQL type as Time class.Fix _jsonEncodableProvider: do not use EntityHandler if there's a registered ClassReflection.
Json:
_jsonEncodableProvider: do not use EntityHandler if there's a registered ClassReflection.APIServer:
_toJsonEncodableAccessRules when there's an EntityAccessRules for
an entity but there's no encodable function.Force POST request if any parameter is a List or Map.
APIModuleHttpProxy:
POST request if any parameter is a List or Map.APIRouteBuilder.resolveValueByType:
_resolveValueType to resolveValueByTypeList, Set and Map parameters.- reflection_factory: ^2.1.0
Added _credential field to allow return (by get credential) of the APICredential instance used in the authentication process.
APIAuthentication:
_credential field to allow return (by get credential) of the APICredential instance used in the authentication process.Added authenticateMultiple for when the request has an APICredential and also a payload with credential.
APISecurity:
authenticateMultiple for when the request has an APICredential and also a payload with credential.APICredential:
originalCredential field.APICredential.fromMap and checkCredential.APIDBModule: Added credential support.- Time.toString: - Fix withSeconds parameter. - Added Time.copyWith.
Time.toString:
withSeconds parameter.Time.copyWith.- reflection_factory: ^2.0.7 - hotreloader: ^3.0.6 - statistics: ^1.0.25 - petitparser: ^5.3.0 - meta: ^1.9.1
- decodeQueryStringParameters: - Added parameter charset. - swiss_knife: ^3.1.5 - resource_portable: ^3.0.2 - archive: ^3.3.7
decodeQueryStringParameters:
charset.- APIRoot: - Added loadDependencies.
APIRoot:
loadDependencies.- New HTMLDocument. - APIDBModule: - Added insert & update support. - Added delete operation. - Added UI (HTML). - EntityHandler: - Added resolveIDs.
HTMLDocument.APIDBModule:
EntityHandler:
resolveIDs.resolveValueByType.- EntityReferenceList: - Fix add.
EntityReferenceList:
add.Added constructor EntityField.indexed().
CreateIndexSQL.EntityField:
_indexed and isIndexed.EntityField.indexed().DBSQLAdapter:
entityRepositoriesBuildOrder.DBAdapter:
allRepositories:
entityRepositoriesBuildOrder to return the repositores in the build order.APIDBModule:
tables: list repositories ordered by name.dump: list repositories in build order to allow use of the dump to populate a DB.Fix call to bucket.info: replace with _getObjectInfo & try/catch.
DBObjectGCSAdapter:
bucket.info: replace with _getObjectInfo & try/catch.New library: bones_api_db_gcp.dart.
DBObjectGCSAdapter.bones_api_db_gcp.dart.DBObjectDirectoryAdapter: clean code.DBEntityRepositoryProvider:
requiredAdapters and requiredEntityRepositoryProviders:
initializeDependencies.Base class for DBObjectMemoryAdapter and DBObjectDirectoryAdapter.
DBObjectAdapter:
DBObjectMemoryAdapter and DBObjectDirectoryAdapter.DBAdapterRegister:
DBAdapter registration, avoiding repetitive static code in
DBSQLAdapter, DBObjectAdapter and DBRelationalAdapter.EntityHandler
equalsValuesEntityMap.getEntityIDFrom.equalsValuesEntity now also using equalsValuesEntityMap.
DBSQLMemoryAdapter.disposeEntities: force _resolveID before dispose.
EntityReference:
disposeEntities: force _resolveID before dispose.EntityReferenceList:
disposeEntities: force _resolveIDs before dispose.APIRouteBuilder:
_resolveValueType: resulve List, Set, Map generic types.Added REDIRECT: to perform URL/Location redirects.
APIResponseStatus
REDIRECT: to perform URL/Location redirects._normalizeID: ensure safe ID for File path.
DBObjectDirectoryAdapter:
_normalizeID: ensure safe ID for File path.EntityReferenceBase:
_getEntityID: allow use of dynamic.id if there's not EntityHandler.- petitparser: ^5.2.0 - postgres: ^2.6.1
Added allowRequestLetsEncryptCertificate.
APIServer:
allowRequestLetsEncryptCertificate.IterableEntityRepositoryProviderExtension:
EntityHandler:
isValidEntityType.APIToken:
generateToken.IterableEntityRepositoryProviderExtension:
getEntityRepository: added parameter removeClosedProviders.Added getAsMap, getAsList, getAs.
APIConfig:
getAsMap, getAsList, getAs.WithRuntimeTypeNameSafe.ExtensionRuntimeTypeNameUnsafe:
runtimeTypeNameUnsafeavoid_dynamic_calls.avoid_type_to_string.no_runtimeType_toString.discarded_futures.no_adjacent_strings_in_list.One column per quarter.