539a2ad504
All checks were successful
CI / Build and Test (push) Successful in 1m22s
Contexts that lose their SSE connection now pass through a suspended state before being fully reaped. Suspended contexts keep their shell (ID, route, CSRF token) but free page resources. On reconnect, the page init function is re-run for a seamless resume. Contexts past the TTL trigger a client-side reload instead of a silent dead page. Configurable via ContextSuspendAfter (default 15m) and ContextTTL (default 1h).
75 lines
2.4 KiB
Go
75 lines
2.4 KiB
Go
package via
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/alexedwards/scs/v2"
|
|
"github.com/rs/zerolog"
|
|
)
|
|
|
|
func ptr(l zerolog.Level) *zerolog.Level { return &l }
|
|
|
|
var (
|
|
LogLevelDebug = ptr(zerolog.DebugLevel)
|
|
LogLevelInfo = ptr(zerolog.InfoLevel)
|
|
LogLevelWarn = ptr(zerolog.WarnLevel)
|
|
LogLevelError = ptr(zerolog.ErrorLevel)
|
|
)
|
|
|
|
// Plugin is a func that can mutate the given *via.V app runtime. It is useful to integrate popular JS/CSS UI libraries or tools.
|
|
type Plugin func(v *V)
|
|
|
|
// Options defines configuration options for the via application
|
|
type Options struct {
|
|
// The development mode flag. If true, enables server and browser auto-reload on `.go` file changes.
|
|
DevMode bool
|
|
|
|
// The http server address. e.g. ':3000'
|
|
ServerAddress string
|
|
|
|
// LogLevel sets the minimum log level. nil keeps the default (Info).
|
|
LogLevel *zerolog.Level
|
|
|
|
// Logger overrides the default logger entirely. When set, LogLevel and
|
|
// DevMode have no effect on logging.
|
|
Logger *zerolog.Logger
|
|
|
|
// The title of the HTML document.
|
|
DocumentTitle string
|
|
|
|
// Plugins to extend the capabilities of the `Via` application.
|
|
Plugins []Plugin
|
|
|
|
// SessionManager enables cookie-based sessions. If set, Via wraps handlers
|
|
// with scs LoadAndSave middleware. Configure the session manager before
|
|
// passing it (lifetime, cookie settings, store, etc).
|
|
SessionManager *scs.SessionManager
|
|
|
|
// DatastarContent is the Datastar.js script content.
|
|
// If nil, the embedded default is used.
|
|
DatastarContent []byte
|
|
|
|
// DatastarPath is the URL path where the script is served.
|
|
// Defaults to "/_datastar.js" if empty.
|
|
DatastarPath string
|
|
|
|
// PubSub enables publish/subscribe messaging. Use vianats.New() for an
|
|
// embedded NATS backend, or supply any PubSub implementation.
|
|
PubSub PubSub
|
|
|
|
// ContextSuspendAfter is the time a context may be disconnected before
|
|
// the reaper suspends it (frees page resources but keeps the context
|
|
// shell for seamless re-init on reconnect). Default: 15m.
|
|
ContextSuspendAfter time.Duration
|
|
|
|
// ContextTTL is the maximum time a context may exist without an SSE
|
|
// connection before the background reaper fully disposes it.
|
|
// Default: 1h. Negative value disables the reaper.
|
|
ContextTTL time.Duration
|
|
|
|
// ActionRateLimit configures the default token-bucket rate limiter for
|
|
// action endpoints. Zero values use built-in defaults (10 req/s, burst 20).
|
|
// Set Rate to -1 to disable rate limiting entirely.
|
|
ActionRateLimit RateLimitConfig
|
|
}
|