Expand description
Modules§
- extend
- Extension API (handlers, bodies,
Bind, …) — seesova_core::extend. - prelude
- Everyday imports for application code.
Structs§
- App
- Application builder — thin wrapper over
sova_core::App. - Bound
App - Bound app —
serve/runreturn facadeResult. - Cell
- Shared
Clonevalue with change notifications (tokio::sync::watchunder the hood). - Check
Result - Outcome of one named check from
App::run_checks. - Client
Addr - Peer address stored on each request for rate-limiting etc.
- Config
Doc - Full parsed
sova.toml(raw root for plugins; profile name for overlays). - Form
Data - Parsed form body: text fields + file uploads (urlencoded or multipart).
- Html
- HTML body (
text/html; charset=utf-8). - Json
- JSON body (
application/json). - LogConfig
- Tracing install options (stdout and/or file).
- Matched
Route - Matched route path template (e.g.
/users/:id), set after route match. - Matched
Route Capture - Capture for root middleware: filled when a route matches (low-cardinality metrics).
- NoContent
- Empty 204 response.
- OnUpgrade
- Handle to finish an HTTP upgrade (e.g. WebSocket).
- Plugin
Meta - Human-readable plugin metadata (CLI, docs, introspection).
- Plugin
SdkVersion - Semantic version of the Plugin SDK (
major.minor.patch). - Rate
Limit Identity - Authenticated principal for rate-limit identity keys. Set by auth / passport when a user is hydrated; rate-limit falls back to IP if absent.
- Redirect
- HTTP redirect with explicit status.
- Request
- Incoming HTTP request with Express-style helpers.
- Request
Id - Per-request correlation id (inbound
x-request-idor generated). - Response
- Express-style HTTP response.
- Router
- Express-style router. Return from modules and
app.mount("/blog", routes()). - Server
- Compiled app ready to handle requests without recompiling the router.
- Shutdown
- Unified shutdown signal for
BackgroundServices. - Slot
- One-item ownership handoff between tasks (sockets, streams, anything non-
Clone). - Static
- Mount a directory behind Express-style routes (
mount+mount/*path). - Test
Client - Test client over a compiled
Server, always tracking cookies. - Text
- Plain text (
text/plain; charset=utf-8). - Upload
- One uploaded file (or any multipart part with a filename).
- Upload
Rules - Per-file constraints for
Upload::validate.
Enums§
- AppError
- Unified handler /
mainerror for apps that use thesovafacade. - Check
Kind - Kind of app check — readiness probes vs deploy-time audits.
- Error
- Framework and application errors mapped to HTTP responses.
- Http
- HTTP protocol mode for a bound app.
- LogRotate
- How to rotate the log file when
LogConfig::fileis set.
Constants§
- PLUGIN_
SDK_ VERSION - Current Plugin SDK version (author-facing surface, not crate semver).
Traits§
- Background
Service - Long-running work started after
on_startup, stopped after connection drain. - Into
Response - Convert a value into an HTTP response.
- Plugin
- Single extension trait for the framework.
- Response
Assert - Fluent assertions for HTTP responses in tests.
Functions§
- ensure_
request_ id - Set
RequestIdfromx-request-idor generate one (idempotent). - init_
tracing - Install a default
tracingsubscriber (LogConfig::from_env). - logger
- Request logger (
method,path,status,latency_ms, optionalrequest_id). - referer_
or Refererheader value, orfallbackwhen absent/empty.- request_
id - Ensure
RequestId, echox-request-id, wrap in anhttp.serverspan. - with_
state - Middleware with owned state — hides the
Arc::clonedance.