spry 8.3.0

Next-generation Dart server framework. Build modern servers and deploy them to the runtime you prefer.

8.3.0

Migration guide: Not required.

Highlights

Spry adds first-class OpenAPI 3.1 generation driven by filesystem routes and typed route metadata.

This work introduces document generation from spry.config.dart, typed OpenAPI builders under package:spry/openapi.dart, analyzer-validated route-level openapi metadata, lifted route globalComponents, and a focused example plus documentation for the full authoring flow.

Breaking Changes

• None.

What's New

OpenAPI generation

• Added openapi configuration in spry.config.dart, including document root metadata, output selection, component merge strategy, and root-level webhook declarations by @medz in #171.
• Added a public typed OpenAPI authoring surface under package:spry/openapi.dart, including builders for schemas, parameters, headers, request bodies, responses, security schemes, OAuth flows, callbacks, path items, tags, servers, and document components by @medz in #171.
• Added route-level top-level openapi metadata with analyzer-backed truth source validation, so route docs must resolve to Spry's real OpenAPI types rather than raw maps or local lookalikes by @medz in #171.
• Added support for deeply reusable shared spec values, including nested child and sub-child values such as parameters, request bodies, responses, callbacks, security requirements, server variables, and globalComponents buckets by @medz in #171.
• Added OpenAPI document generation to the build pipeline, including route-path conversion, method expansion for any-method routes, explicit-method override rules, HEAD handling, and lifted route globalComponents by @medz in #171.
• Added strict and deep-merge component merge strategies with source-aware conflict diagnostics by @medz in #171.

Documentation and examples

• Added a dedicated OpenAPI guide covering config, route metadata, reusable spec composition, schemas, request/response modeling, security, callbacks, webhooks, merge behavior, and output rules by @medz in #171.
• Added a standalone example/openapi/ project that generates public/openapi.json from document-level components and route-level globalComponents by @medz in #171.
• Aligned the README runtime-target overview with the v8.2 target surface by @medz in eaa9ff7.

Migration note

• No migration is required. OpenAPI support is additive. To adopt it, add an openapi block to defineSpryConfig(...), import package:spry/openapi.dart, and start attaching typed openapi metadata to route files.

Full Changelog

• https://github.com/medz/spry/compare/v8.2.0...v8.3.0

8.2.0

Migration guide: https://spry.medz.dev/migration

Highlights

Spry 8.2.0 reshapes generated output around a clearer target layout and adds new Dart-native deployment targets.

This release renames the Dart runtime target to BuildTarget.vm, moves generated Dart source into .spry/src/, renames JS runtime entrypoints to their deploy-facing filenames, adds exe / aot / jit / kernel targets, and removes the synthetic wildcard-param alias for named catch-all routes.

Breaking Changes

• Renamed BuildTarget.dart to BuildTarget.vm by @medz in #170.
• Generated Dart source files now live under .spry/src/ instead of the .spry/ root, and JS target entrypoints now use deploy-facing filenames such as .spry/node/index.cjs and .spry/cloudflare/index.js by @medz in #170.
• Removed RouteParams.wildcard / event.params.wildcard for named catch-all routes. Read the declared param directly, for example event.params.get('slug') by @medz in dab62e9.

What's New

Build and deployment

• Added Dart-native deployment targets for executable, AOT snapshot, JIT snapshot, and kernel snapshot output via BuildTarget.exe, BuildTarget.aot, BuildTarget.jit, and BuildTarget.kernel by @medz in #170.
• Reworked generated output layout and deployment documentation across Node, Bun, Deno, Cloudflare, Vercel, and Netlify to match the new target-specific entrypoints by @medz in #170.
• Synced public/ assets into Dart compiled output workspaces so native builds can be deployed directly by @medz in #170.

Runtime performance

• Cached parsed request URLs and query params per request to remove duplicate parsing in the main request pipeline by @medz in #167.
• Simplified the static asset serving pipeline and unified public-asset resolution across JS and IO runtimes by @medz in #169.

Routing runtime

• Removed generated _withWildcardParam wrappers and the per-request Event / RouteParams rebuild they performed for named catch-all routes by @medz in dab62e9.

Migration note

• Rename BuildTarget.dart to BuildTarget.vm in spry.config.dart.
• If your tooling reads generated output directly, update paths from .spry/*.dart to .spry/src/*.dart, and switch JS entrypoints to the new filenames (node/index.cjs, bun/index.js, deno/index.js, cloudflare/index.js).
• Replace event.params.wildcard with event.params.get('<name>'), where <name> is the identifier declared in [...name].dart.

Full Changelog

• https://github.com/medz/spry/compare/v8.1.0...v8.2.0

8.1.0

Migration guide: Not required.

Highlights

Spry 8.1.0 expands runtime coverage and adds first-class route-level WebSocket handling without changing the filesystem routing model.

This release adds Deno and Netlify targets, exposes public osrv runtime entrypoints for target-aware integrations, upgrades Spry to osrv 0.6.x, and introduces the new event.ws API for WebSocket upgrades inside normal route handlers.

Breaking Changes

• None.

What's New

Runtime targets

• Added a Deno target and deploy documentation by @medz in #164.
• Added a Netlify target, example project, and deploy documentation by @medz in #163.

Runtime integration

• Added public package:spry/osrv.dart runtime entrypoints, including target-specific exports for Dart, Node, Bun, Cloudflare, Deno, Vercel, and Netlify by @medz in #162.
• Upgraded Spry to osrv 0.6.x as part of the Deno runtime work by @medz in #164.

WebSocket support

• Added event.ws with runtime support checks, upgrade-request detection, requested protocol access, and upgrade(...) for route-level WebSocket handling by @medz in #165.
• Added WebSocket documentation covering handshake semantics, session boundaries, and runtime support expectations by @medz in #165.

Migration note

• No migration is required for existing applications. To adopt WebSockets, import package:spry/websocket.dart and use event.ws inside a normal route handler.
• If you integrate directly with osrv, prefer the new public exports under package:spry/osrv.dart and its target-specific entrypoints.

Full Changelog

• https://github.com/medz/spry/compare/v8.0.0...v8.1.0

8.0.0

Migration guide: https://spry.medz.dev/migration

Highlights

Spry 8.0.0 aligns the framework with the latest upstream HTTP and routing foundations.

This release upgrades Spry to the Fetch-style Request / Response model from ht 0.3.x and osrv 0.4.x, adopts the roux 0.5.x route syntax changes, and expands filesystem routing with more expressive segment patterns.

Breaking Changes

• Spry now follows the upstream Fetch-style Request / Response construction model by @medz in #157.
• Manual string-path remainder matches must now use /** instead of /* when constructing Spry, MiddlewareRoute, or ErrorRoute by @medz in #155.

Request / Response construction

If you construct exported Request / Response values directly, migrate to the new init-object form:

• Request(uri, method: 'GET') -> Request(uri, RequestInit(method: HttpMethod.get))
• Response(status: 404, headers: ..., body: ...) -> Response(body, ResponseInit(status: 404, headers: ...))

What's New

HTTP foundation upgrade

• Upgraded to ht 0.3.1 and osrv 0.4.x by @medz in #157.
• Re-exported RequestInit and ResponseInit from package:spry/spry.dart and package:spry/app.dart by @medz in #157.

Routing upgrade

• Upgraded to roux 0.5.x by @medz in #155.
• Kept Spry catch-all scopes aligned with the new ** remainder syntax by @medz in #155.
• Added richer filesystem route syntax for embedded params, regex params, optional params, repeated params, and single-segment wildcards by @medz in #155.

Examples and docs

• Split examples by target runtime and added a knex_dart example project by @medz in 13fed0d.
• Refreshed migration docs and release-facing website copy for the v8 release by @medz in #159.
• Upgraded project dependencies by @medz in #160.

Migration note

• Replace manual /* route strings with /** in Spry, MiddlewareRoute, and ErrorRoute, then re-run your route matching tests after upgrading to roux 0.5.x.
• If you construct exported Request / Response types directly, migrate to the new Fetch-style init objects. For example: Request(uri, method: 'GET') -> Request(uri, RequestInit(method: HttpMethod.get)) Response(status: 404, headers: ..., body: ...) -> Response(body, ResponseInit(status: 404, headers: ...)) Response.text(...) / Response.empty(...) -> Response(..., ResponseInit(...))

Full Changelog

• https://github.com/medz/spry/compare/v7.0.0...v8.0.0

7.0.0

Migration guide: https://spry.medz.dev/migration

What's Changed

• BREAKING: replace the imperative app DSL with the v7 file-based runtime model built around routes/, scoped _middleware.dart / _error.dart, and spry.config.dart.
• feat(cli): add spry serve and spry build workflows for generated runtimes, including watch mode and explicit root support.
• feat(runtime): add generated targets for Dart VM, Node.js, Bun, Cloudflare Workers, and Vercel.
• feat(builder): add config loading, route scanning, runtime generation, and public asset syncing for the new build pipeline.
• docs: rewrite the documentation site for Spry v7, including the new getting started, runtime, deploy, and migration guides.

6.2.0

• feat: support middleware operators (| Pipe middleware, > middleware with handler)
• feat: support group routing (app.group(...))
• docs: add group routes docs

6.1.0

• perf(datr, server): pointless waiting
• perf: avoid creating event id
• refactor: Remove event.id

6.0.1

• fix: avoid http response status

6.0.0

Migration guide: https://spry.medz.dev/migration

What's Changed

• refactor: remove group router (The app.group/app.grouped).
• refactor: rename app.stack to app.middleware.
• refactor: remove useRequest(), now use event.request.
• refactor: remove useHeaders(), now use event.headers/event.request.headers.
• refactor: remove getClientAddress(), now use event.address.
• refactor: remove useRequestURI(), now use event.url.
• refactor: remove useParams(), now use event.params.
• refactor: rename factory Response.text() to Response.fromString().
• refactor: rename factory Response.json() to Response.fromJson().
• refactor: remove all adapter, now is cross-platform.