NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #3172 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 5 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.
New FileLimited: expose Fili limit handling.
New FileLimited: expose Fili limit handling.
FileLimitExtension: use FileLimited.global.
APIServerResponseCache:
_fileLimited for file operations.File operations to prioritize async and limited operations.shelf_letsencrypt: ^2.0.3
build_runner: ^2.10.4
test: ^1.28.0
Added statLimited, deleteLimited.
FileLimitExtension:
statLimited, deleteLimited.DBObjectGCSAdapter:
deleteLimited() instead of delete()statLimited() instead of stat()Too many open files errors during cache cleanup and maintenance...Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added readAsBytesLimited() and writeAsBytesLimited() methods to safely limit concurrent file I/O operations and prevent Too many open files errors.
FileLimitExtension:
readAsBytesLimited() and writeAsBytesLimited() methods to
safely limit concurrent file I/O operations and prevent Too many open files errors.DBObjectGCSAdapter:
FileLimitExtension.readAsBytesLimited() to control concurrent I/O and prevent
Too many open files errors during cache access.async_locks: ^4.0.2
build_runner: ^2.10.2
test: ^1.27.0
Fix calculation of needed deleting and extra 20%.
DBObjectGCSAdapter:
_checkCacheDirectoryLimit:
Added properties: cacheDevelopment, cacheFilesLimit, cacheCheckMaxSkips and cacheCheckTimeout.
DBObjectGCSAdapter:
cacheDevelopment, cacheFilesLimit, cacheCheckMaxSkips and cacheCheckTimeout.cacheDirectory on cacheDevelopment._checkCacheDirectoryLimit:
cacheFilesLimit.DBObjectDirectoryAdapter:
development.directory on development.reflection_factory: ^2.7.2
postgres: ^3.5.9
crypto: ^3.0.7
http: ^1.6.0
_discoveryapis_commons: ^1.0.7
build_runner: ^2.10.1
resolveFieldsValues: when resolving an EntityReference and the value can't be resolved, pass the ID to the EntityReference.
EntityHandler:
resolveFieldsValues: when resolving an EntityReference and the value can't be resolved, pass the ID to the EntityReference.resolveValueByType: optimize for null value.LoggerHandler:
_buildMsg: handle long debugName starting with test_suite:.ClassProxyListener:
onCall: On response error, throw an exception using response.stackTrace when available.- DBEntityRepository: - Optimize resolveEntities. - build_runner: ^2.7.1
DBEntityRepository:
resolveEntities.build_runner: ^2.7.1
Added notifyAPITokenInfoChange, disposeAuthenticationPermission, disposeAuthenticationDataAndPermission.
APISecurity:
notifyAPITokenInfoChange, disposeAuthenticationPermission, disposeAuthenticationDataAndPermission.APITokenStore:
removeTokenPermissions, removeTokenDataAndPermissions.APIRequest:
APIRequest and getPayloadParameterIgnoreCase.Comment: dependency_validator: ^4.1.3.
sdk: '>=3.7.0 <4.0.0'
reflection_factory: ^2.6.0
collection: ^1.19.1
mime: ^2.0.0
http: ^1.5.0
build_runner: ^2.7.0
Comment: dependency_validator: ^4.1.3.
EntityAccessRules: added totalRules.
EntityAccessRules: added totalRules.
APIModule:
addRouteHandler.APIRouteBuilder:
addRouteHandler.apiMethod: optimize the built routeHandler.Now APIRouteHandler is abstract:
function.APIRouteHandlerFunction.MethodReflectionExtension:
returnsAPIResponse: do not accept dynamic.APIServer:
reflection_factory: ^2.5.3
Fix serverTimingEntryName default value from obj->json->gzip to obj-json-gzip.
APIServer:
_defineGZipEncodedHeaders:
serverTimingEntryName default value from obj->json->gzip to obj-json-gzip.Log errors while encoding payload to JSON.
APIServer:
_resolveBodyImpl:
OutOfMemoryError and log.apiResponse.asError on errors._jsonEncodePayload:
AutoGZipSink and Json.encodeToSink to stream JSON encoding with automatic GZip compression based on output size.Added AutoGZipSink, GZipSink and BytesSink and BytesBuffer.
Json:
encodeToSink.reflection_factory: ^2.5.2
swiss_knife: ^3.3.3
test: ^1.26.3
Main updates (see v1.9.4-beta.* for more):
Main updates (see v1.9.4-beta.* for more):
APIServerConfig:
defaultStaticFilesCacheControl: removed must-revalidate (conflicts with stale-while-revalidate).longLivedStaticFilesCacheControl and longLivedStaticFilesCached
/, /index.html, styles.css, /pwa_sw.jsapiConfig:CacheControl:
mustRevalidate from the default directives (conflicts with staleWhileRevalidate).coverage: ^1.15.0
Fix normalizeHeaderValue resolution when using apiConfig.
APIServerConfig:
normalizeHeaderValue resolution when using apiConfig.defaultLongLivedStaticFilesCacheControl: changed max-age from 86400 (1 day) to 3600 (1 hour).
APIServerConfig:
defaultLongLivedStaticFilesCacheControl: changed max-age from 86400 (1 day) to 3600 (1 hour).apiConfig:
cookieless, useSessionID.maxPayloadLength, decompressPayload.apiCacheControl, staticFilesCacheControl.longLivedStaticFilesCacheControl, longLivedStaticFilesCached.Removed mustRevalidate from the default directives (conflicts with staleWhileRevalidate).
CacheControl:
mustRevalidate from the default directives (conflicts with staleWhileRevalidate).APIServerConfig:
defaultStaticFilesCacheControl: removed must-revalidate (conflicts with stale-while-revalidate).longLivedStaticFilesCacheControl and longLivedStaticFilesCached
/, /index.html, styles.css, /pwa_sw.jsAPIServerResponseCache:
Cache-Control and Server.Last-Modified on 304 responses.DBEntityRepositoryProvider: check for duplicated repositories.
DBPostgreSQLAdapter:
postgres API v3.DBEntityRepositoryProvider: check for duplicated repositories.
APIServerConfig, APIServerWorker, APIServer:
maxPayloadLength and decompressPayload options for request handling.APIServer:
_loadPayloadBytes:
_decodePayloadGzip to handled GZip decompression and check the decompressed size in header before decompression.Time.parse: accept format Time(hh:mm:ss.sss)
Fix SQL column generation type if min/max is defined for the field.
postgres: ^3.5.6
Added _checkDuplicatedRepositories: check for duplicated repositores, by Type and name.
DBEntityRepositoryProvider:
_checkDuplicatedRepositories: check for duplicated repositores, by Type and name.Initializable:
_doInitializationImpl: add extra timeout when new parents are added.DBMySQLAdapter, DBPostgreSQLAdapter:
DBMySQLAdapter, DBPostgreSQLAdapter:
typeToSQLType: fix for int/BigInt ID (isID: true).Fix for int: use entityFieldAnnotations min/max to define SQL type (TINYINT,SMALLINT,MEDIUMINT,INT,BIGINT).
DBMySQLAdapter:
typeToSQLType:
int: use entityFieldAnnotations min/max to define SQL type (TINYINT,SMALLINT,MEDIUMINT,INT,BIGINT).BigInt and DynamicInt: DECIMAL(65, 0)DBPostgreSQLAdapter:
typeToSQLType:
int: use entityFieldAnnotations min/max to define SQL type (SMALLINT,INT,BIGINT).BigInt and DynamicInt: NUMERICAPIServerConfig, APIServerWorker, APIServer:
APIServerConfig, APIServerWorker, APIServer:
maxPayloadLength and decompressPayload options for request handling.APIServer:
_loadPayloadBytes:
_decodePayloadGzip to handled GZip decompression and check the decompressed size in header before decompression.GenericEntityHandler, ClassReflectionEntityHandler:
GenericEntityHandler, ClassReflectionEntityHandler:
getFieldType: if the field doesn't have a setter do not use cached fields types.meta: ^1.17.0
gcloud: ^0.8.19
http: ^1.4.0
googleapis_auth: ^2.0.0
test: ^1.26.2
coverage: ^1.14.1
vm_service: ^15.0.2
TypeInfoEntityExtension, TypeReflectionEntityExtension:
TypeInfoEntityExtension, TypeReflectionEntityExtension:
entityType: also handle List<E>, returning the List generic type (E).TypeInfoEntityExtension:
toCastedList.DBSQLAdapter:
_checkDBTableScheme:
referenceFields and collectionReferenceFields._DBTableCheck: added field missingCollectionReferenceColumns.EntityHandler:
resolveFieldsValues: ensure that List<E> fields are casted to the list, using entityType.toCastedList(val).New InitializationError.
Initializable: better handling of errors of dependencies while initializing.
async_extension: ^1.2.15
args: ^2.7.0
postgres: ^3.5.6
archive: ^4.0.7
coverage: ^1.12.0
Added fields username, host, port, database, secure.
DBPostgreSQLAdapter:
PostgreSQLConnectionWrapper:
_endpoint.username, host, port, database, secure.connectionURL: appended query string with sslmode._connectSSLImpl, _connectNoSSLImpl: simplify error handling.
DBPostgreSQLAdapter:
_connectSSLImpl, _connectNoSSLImpl: simplify error handling.Remove filed onlySecureConnections.
New DBAdapterConnectivity.
DBAdapter:
connectivity.DBPostgreSQLAdapter:
onlySecureConnections.connectivity field.New DBAdapterCapabilityConnectivity.
New DBAdapterCapabilityConnectivity.
DBAdapterCapability:
connectivity.DBPostgreSQLAdapter:
onlySecureConnections.dependency_validator: ^4.1.3
Time.parse: accept format Time(hhss.sss)
DBPostgreSQLAdapter:
postgres API v3.Time.parse: accept format Time(hh:mm:ss.sss)
postgres: ^3.5.4
project_template: ^1.1.1
archive: ^4.0.4
resolveFiledName: improve field matching.
FieldsFromMap:
resolveFiledName: improve field matching.EntityHandler
getFieldType: added parameter resolveFiledName: false.GenericEntityHandler, ClassReflectionEntityHandler:
- async_events: ^1.3.0 - reflection_factory: ^2.5.1 - web: ^1.1.1
Change use of dart:html (deprecated) to package web.
APIPlatformBrowser:
dart:html (deprecated) to package web.Json:
defaultFieldValueResolver: optimize primitives parsing (String, bool, int, double, num) .dumpRuntimeTypes.sdk: '>=3.6.0 <4.0.0'
reflection_factory: ^2.5.0
statistics: ^1.2.0
swiss_knife: ^3.3.0
yaml_writer: ^2.1.0
mercury_client: ^2.3.0
resource_portable: ^3.1.2
collection: ^1.19.0
web: ^1.1.0
- reflection_factory: ^2.4.10 - petitparser: ^6.1.0 - hotreloader: ^4.3.0 - stream_channel: ^2.1.4 - http: ^1.3.0 - lints: ^5.1.1 - build_runner: ^2.4
reflection_factory: ^2.4.10
petitparser: ^6.1.0
hotreloader: ^4.3.0
stream_channel: ^2.1.4
http: ^1.3.0
lints: ^5.1.1
build_runner: ^2.4.15
test: ^1.25.15
✨♻️ Improve cast method in APIResponse
🔨 improve payload handling in resolveBody and resolveBodySync
refactor(api):
UNAUTHORIZED, BAD_REQUEST: Allow error as payload in response generation.swiss_knife: ^3.2.3
yaml: ^3.1.3
stream_channel: ^2.1.3
_callZoned: allow an APIResponse to be thrown as response.
APIRoot:
_callZoned: allow an APIResponse to be thrown as response.createContextZone: added parameter zoneValues.
ZoneField:
createContextZone: added parameter zoneValues.createSafeContextZone:
zoneSpecification and zoneValueshandleUncaughtError to named parameter.APIRoot:
_callZoned:
handleUncaughtError for every Zone created
through currentAPIRequest.createSafeContextZone. Now using a single ZoneSpecification instance.currentAPIRequest.disposeContextZone(callZone) is always called.async_extension: ^1.2.14
test: ^1.25.14
✨♻️ Add Time operators for addition + and subtraction -.
✨♻️ Add Time operators for addition + and subtraction -.
New DurationToTimeExtension: Duration.toTime()
async_extension: ^1.2.13
reflection_factory: ^2.4.8
build_runner: ^2.4.14
test: ^1.25.13
- map_history: ^1.0.6 - shelf_letsencrypt: ^2.0.1
Added createSafeContextZone (handles Uncaught Errors).
ZoneField:
_zones: optimize using Queue.createSafeContextZone (handles Uncaught Errors).APIRoot
_callZoned: use currentAPIRequest.createSafeContextZone and avoid Uncaught Errors that can quit a server.APIServerWorker:
_startLetsEncrypt: allow multiple domains.letsEncrypt.startServer:
checkCertificate: letsEncryptProduction,sdk: '>=3.5.0 <4.0.0'
shelf_letsencrypt: ^2.0.0
map_history: ^1.0.4
gcloud: ^0.8.18
lints: ^4.0.0
dependency_validator: ^4.1.2
test: ^1.25.12
coverage: ^1.11.1
build_runner: ^2.4.13
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- reflection_factory: ^2.4.7
HTMLInput._resolveInput: ensure that DataTime values are UTC.
HTMLInput._resolveInput: ensure that DataTime values are UTC.
APIDBModule:
_addScriptFixDateTime and _fixParametersDateTime (used by insert)._writeInputTable: id with link to the select route.select:
Added fields postgresPort, maxConnections and logStatement.
APITestConfigDockerDB:
cleanContainer.APITestConfigDockerPostgreSQL:
postgresPort, maxConnections and logStatement.super.cleanContainer.APITestConfigDockerMySQL:
super.cleanContainer.docker_commander: ^2.1.7
- reflection_factory: ^2.4.6
- EntityAccessRules._simplified: - Fix: Added parameter masker.
EntityAccessRules._simplified:
masker.- EntityAccessRuleType: - Added mask. - EntityAccessRules: - Added field masker. - Added getter cached. - Added hasRuleType. - gcloud: ^0.8.17 - cover
EntityAccessRuleType:
mask.EntityAccessRules:
masker.cached.hasRuleType.gcloud: ^0.8.17
coverage: ^1.11.0
- reflection_factory: ^2.4.5 - gcloud: ^0.8.16
onNewAPIToken: added parameter request.
APISecurity:
onNewAPIToken: added parameter request.yaml_writer: ^2.0.1
args: ^2.6.0
logging: ^1.3.0
crypto: ^3.0.6
path: ^1.9.1
coverage: ^1.10.0
refreshAPIToken: after refreshToken and create a new token, populate permissions calling getCredentialPermissions.
APISecurity:
refreshAPIToken: after refreshToken and create a new token, populate permissions calling getCredentialPermissions.gcloud: ^0.8.15
Added copy, isSharedDummy, and ensureNotSharedDummy.
SQL:
copy, isSharedDummy, and ensureNotSharedDummy.generateInsertRelationshipSQLs: use ensureNotSharedDummy.meta: ^1.16.0
Only use responseType = 'arraybuffer' if the returnType is Uint8List; otherwise, use responseType = 'text'.
APIModuleProxyHttpCaller:
parseResponse.doRequest:
returnType.responseType = 'arraybuffer' if the returnType is Uint8List; otherwise, use responseType = 'text'.HTMLInput:
statistics: ^1.1.3
swiss_knife: ^3.2.2
mercury_client: ^2.2.4
shelf_static: ^1.1.3
gcloud: ^0.8.13
Handle 7 bytes encoding from PostgreSQL.
Time.fromBytes:
removeFromPool: call closePoolElement.
Pool:
removeFromPool: call closePoolElement._catchFromPopulatedPool: call disposePoolElement on invalid elements.
Pool:
_catchFromPopulatedPool: call disposePoolElement on invalid elements.Added disposeInternalHandlers and resolve.
EntityReferenceBase:
disposeInternalHandlers and resolve.coverage: ^1.9.1
One column per quarter.