Skip to main content

orbiter 0.1.7 copy "orbiter: ^0.1.7" to clipboard
orbiter: ^0.1.7 copied to clipboard

High-throughput, low-allocation HTTP backend framework for Dart. Designed for maximum concurrency and minimal GC pressure over dart:io.

Changelog #

0.1.7 #

  • ConcurrencyLimit.rejectResponse: builds the refusal from the request (for example with CORS headers, so a browser sees the 503), written like a handler response; Retry-After is added when missing, and the default refusal goes out if the builder fails. Cleanup hooks registered on the request run after the write.
  • ConcurrencyLimit.exempt: requests for which the predicate returns true skip the limit (no slot, no queue, no refusal); meant for cheap probes such as /ready.
  • New exported typedefs RejectResponseBuilder and ExemptPredicate. Under MultiWorkerServer both functions travel to the worker isolates and must be sendable, or the server fails to start. Without them nothing changes.

0.1.6 #

  • ConcurrencyLimit: opt-in admission control for BackendServer.bind, MultiWorkerServer.start (per worker) and HttpDispatcher. At most maxInFlight requests run at once, each holding its slot until its cleanup hooks finish; up to maxQueued wait in arrival order for at most queueTimeout; the rest get 503 with Retry-After and a JSON body, without running the handler. HttpDispatcher gains admitted, queued and rejected. Without the option nothing changes.

0.1.5 #

  • MultiWorkerServer: one BackendServer per isolate on the same port, built by a WorkerSetup that runs inside each worker (WorkerApp, WorkerContext), with coordinated shutdown. Start failures throw MultiWorkerStartException; a worker that dies is reported as WorkerExitedException. No change to the existing API.

0.1.4 #

Documentation only: README rewritten, a runnable example (example/main.dart), dartdoc on the Request, Response and PayloadTooLargeException constructors. No API change.

0.1.3 #

First release on pub.dev. No API change.

0.1.2 #

Renamed from dart_backend_framework to orbiter; the repository moved with it. No API change: only the package name, the library import (package:orbiter/orbiter.dart) and the dependency key change.

0.1.1 #

Documentation only; no code change.

  • README: new sections "Writing an interceptor" (function and class forms, short-circuit, typed request context, cleanup hooks) and "Errors and logging" (errorHandler versus onError, why a custom errorHandler must answer 413 itself, requestLogger(logFn:)).
  • README: the PostgreSQL package is described as the database kit it is (rlsTransaction and prefixTsQuery), one kit per database.

0.1.0 #

First public release, consumed by git reference to the tag v0.1.0.

  • BackendServer over dart:io, with a request body limit (maxBodySize), an error boundary that answers a generic 500, onError reporting and a graceful close() that waits for in-flight requests and their hooks.
  • Request / Response with typed per-request context (RequestContext, no Zone) and LIFO cleanup hooks that run after the response is fully written, including streamed bodies and client disconnects.
  • Pipeline of interceptors, folded once at startup, with short-circuit.
  • Radix/trie Router: static routes, :param, *wildcard, 404 and 405 with Allow.
  • Middlewares: cors(), requestLogger(), securityHeaders().
  • No database dependency.
1
likes
160
points
731
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

High-throughput, low-allocation HTTP backend framework for Dart. Designed for maximum concurrency and minimal GC pressure over dart:io.

Repository (GitHub)
View/report issues

Topics

#server #http #backend #framework

License

MIT (license)

Dependencies

meta

More

Packages that depend on orbiter