trilha

Sep 9, 2026

Changes in this version

+ const ErrRedirectAbsolute

+ const ErrSecretShort

+ func RedirectExternal(url string) error

type Ctx

+ func (c *Ctx) RedirectExternal(url string) error

+ type Hint struct

+ Code string

+ Docs string

+ Repair string

+ func HintOf(err error) *Hint

+ func NewHint(code string, err error) *Hint

+ func (h *Hint) Doc(path string) *Hint

+ func (h *Hint) Error() string

+ func (h *Hint) Fix(repair string) *Hint

+ func (h *Hint) Unwrap() error

Sep 9, 2026

Changes in this version

+ func RegisteredEnums() map[string]Enum

type Enum

+ func LookupEnum(name string) (Enum, bool)

Sep 9, 2026

Changes in this version

type Actor

+ Tenant string

Sep 9, 2026

Changes in this version

+ var ErrNoLink = errors.New("trilha: invalid or expired link")

type Config

+ Links LinkStore

type Ctx

+ func (c *Ctx) Claim(name string) (*Link, error)

+ func (c *Ctx) Link(name string, o LinkOpts) (string, error)

+ type Link struct

+ Data map[string]string

+ ExpiresAt time.Time

+ ID string

+ Name string

+ Uses int

+ func (l *Link) Consume() error

+ type LinkOpts struct

+ Data map[string]string

+ Path string

+ TTL time.Duration

+ Uses int

+ type LinkStore interface

+ Consume func(id string, max int) (ok bool, err error)

+ Forget func(id string) error

+ Used func(id string) (int, error)

Sep 9, 2026

Changes in this version

+ func Pepper(data []byte) ([]byte, error)

+ type Limiter struct

+ func NewLimiter(rl RateLimit) *Limiter

+ func (l *Limiter) Allow(key string) (ok bool, retryAfter int)

Sep 9, 2026

Changes in this version

+ var ErrSealed = errors.New("trilha: could not open the sealed value")

+ func Open(sealed []byte) ([]byte, error)

+ func Seal(plain []byte) ([]byte, error)

+ type Secret string

+ func SecretFrom(sealed []byte) (Secret, error)

+ func (s *Secret) Scan(v any) error

+ func (s *Secret) UnmarshalJSON(b []byte) error

+ func (s Secret) Empty() bool

+ func (s Secret) LogValue() slog.Value

+ func (s Secret) MarshalJSON() ([]byte, error)

+ func (s Secret) Reveal() string

+ func (s Secret) Sealed() ([]byte, error)

+ func (s Secret) String() string

+ func (s Secret) Value() (driver.Value, error)

Sep 9, 2026

Changes in this version

type Schema

+ func SchemaOf[T any]() Schema

+ type Settings struct

+ func NewSettings[T any](key string, def T) *Settings[T]

+ func (s *Settings[T]) Bind(a *App, store SettingsStore) error

+ func (s *Settings[T]) Get() T

+ func (s *Settings[T]) Key() string

+ func (s *Settings[T]) Schema() Schema

+ func (s *Settings[T]) Set(v T) error

+ func (s *Settings[T]) Update(c *Ctx) error

+ func (s *Settings[T]) Values() map[string]string

+ type SettingsStore interface

+ Load func(key string) ([]byte, bool)

+ Save func(key string, data []byte) error

Sep 9, 2026

Changes in this version

+ var ErrNoDraft = errors.New("trilha: no draft")

type Config

+ Drafts DraftStore

type Ctx

+ func (c *Ctx) Draft(name string) *Draft

+ type Draft struct

+ func (d *Draft) Clear()

+ func (d *Draft) Load(v any) error

+ func (d *Draft) Save(v any, ttl time.Duration) error

+ type DraftStore interface

+ Delete func(key string) error

+ Load func(key string) ([]byte, bool)

+ Save func(key string, data []byte, ttl time.Duration) error

Sep 9, 2026

Changes in this version

+ func CanInline(ctype string) bool

Sep 8, 2026

Changes in this version

+ type CSVError struct

+ Column string

+ Line int

+ Message string

+ type CSVResult struct

+ Errors []CSVError

+ Rows int

+ Warnings []string

+ func BindCSV(r io.Reader, dst any, rules ...CSVRules) (CSVResult, error)

+ func (r CSVResult) OK() bool

+ type CSVRules struct

+ MaxRows int

+ Separator rune

type Ctx

+ func (c *Ctx) CSV(name string, rows any) error

type Upload

+ func (u *Upload) Read(p []byte) (int, error)

Sep 8, 2026

Changes in this version

+ type Actor struct

+ Email string

+ Name string

+ Subject string

+ Via string

+ type AuditFunc func(AuditRecord) error

+ func (f AuditFunc) Write(r AuditRecord) error

+ type AuditRecord struct

+ Action string

+ Actor Actor

+ At time.Time

+ Fields Fields

+ IP string

+ RequestID string

+ Route string

+ Target string

+ type AuditSink interface

+ Write func(AuditRecord) error

type Config

+ Audit AuditSink

type Ctx

+ func (c *Ctx) Actor() Actor

+ func (c *Ctx) Audit(action, target string, fields ...Fields)

+ func (c *Ctx) SetActor(a Actor)

+ type Fields map[string]any

Sep 8, 2026

Changes in this version

type Config

+ Locale string

+ TimeZone string

type Ctx

+ func (c *Ctx) Locale() string

+ func (c *Ctx) Location() *time.Location

Sep 8, 2026

Changes in this version

+ func RegisterEnum(name string, e Enum)

+ type Enum []EnumValue

+ func (e Enum) Has(value string) bool

+ func (e Enum) Label(value string) string

+ func (e Enum) Labels() []string

+ func (e Enum) Options(current string, placeholder ...string) h.Node

+ func (e Enum) Tone(value string) string

+ func (e Enum) Values() []string

+ type EnumValue struct

+ Label string

+ Tone string

+ Value string

Sep 8, 2026

Changes in this version

+ const IslandRuntime

Sep 8, 2026

Changes in this version

+ const DefaultPerPage

+ const MaxPerPage

+ var MaxItems = 1000

+ var SchemaTypes = []string

+ func BindSchema(c *Ctx, s Schema) (map[string]string, error)

+ func RequireCSRF(c *Ctx, next Next) error

type Config

+ Upstreams map[string]Upstream

type Ctx

+ func (c *Ctx) Attachment(name string, body io.Reader, ctype string) error

+ func (c *Ctx) AttachmentFile(path string, ctype string) error

+ func (c *Ctx) Files(field string, rules FileRules) ([]*Upload, error)

+ func (c *Ctx) Inline(name string, body io.Reader, ctype string) error

+ func (c *Ctx) InlineFile(path string, ctype string) error

+ func (c *Ctx) Pipe(res *http.Response) error

+ func (c *Ctx) PollEvery(d time.Duration)

+ func (c *Ctx) PollStop()

type FileRules

+ MaxFiles int

+ type ListParams struct

+ Dir string

+ Page int

+ PerPage int

+ Q string

+ Sort string

+ func (p *ListParams) Restrict(cols ...string) bool

+ func (p ListParams) Asc() bool

+ func (p ListParams) Href(pairs ...string) string

+ func (p ListParams) Limit() int

+ func (p ListParams) Offset() int

+ func (p ListParams) PageHref(n int) string

+ func (p ListParams) TotalPages(total int) int

+ type Schema []SchemaField

+ func (s Schema) Check() error

+ type SchemaField struct

+ Help string

+ Label string

+ Max string

+ Min string

+ Name string

+ Options []SchemaOption

+ Pattern string

+ Required bool

+ Rows int

+ Text string

+ Type string

+ type SchemaOption struct

+ Label string

+ Value string

type Stream

+ func (s *Stream) Notify(name string) error

+ type Upstream struct

+ CSRF string

+ Headers func(c *Ctx, hdr http.Header)

+ Target string

+ Timeout time.Duration

+ Transport http.RoundTripper

Sep 6, 2026

Changes in this version

+ func CSRFTokenFrom(r *http.Request) string

+ func NonceFrom(r *http.Request) string

type Ctx

+ func (c *Ctx) Flash(kind, text string)

+ func (c *Ctx) Flashes() []Flash

+ func (c *Ctx) Pattern() string

+ type Flash struct

+ Kind string

+ Text string

type Route

+ CORS *CORS

Sep 6, 2026

Changes in this version

+ func Provide[T any](a *App, v T)

+ func Use[T any](b Bag) T

+ type Bag interface

+ type CSRF struct

+ Cookie string

+ Field string

+ Header string

type Config

+ CSRF CSRF

type Security

+ Delegated bool

+ Nonce func(*http.Request) string

Sep 6, 2026

Changes in this version

+ func StatusOf(err error) int

type Route

+ MiddlewaresByMethod map[string][]MiddlewareFunc

Sep 6, 2026

Changes in this version

type Config

+ AllowedHosts []string

Sep 6, 2026

Changes in this version

+ type TestClient struct

+ func NewTestClient(t TestingT, a *App) *TestClient

+ func (c *TestClient) Get(target string, opts ...TestOption) *TestResponse

+ func (c *TestClient) PostForm(target string, form url.Values, opts ...TestOption) *TestResponse

+ func (c *TestClient) PostJSON(target string, v any, opts ...TestOption) *TestResponse

+ func (c *TestClient) Request(method, target string, opts ...TestOption) *TestResponse

+ type TestOption func(*testOptions)

+ func WithApp(a *App) TestOption

+ func WithBody(contentType, body string) TestOption

+ func WithCookie(name, value string) TestOption

+ func WithForm(form url.Values) TestOption

+ func WithHeader(name, value string) TestOption

+ func WithJSON(v any) TestOption

+ func WithSigned(name, value string) TestOption

+ func WithoutCSRF() TestOption

+ type TestResponse struct

+ Node h.Node

+ Request *http.Request

+ func TestPage(t TestingT, r Route, target string, opts ...TestOption) *TestResponse

+ func TestRequest(t TestingT, a *App, method, target string, opts ...TestOption) *TestResponse

+ func TestRoute(t TestingT, r Route, method, target string, opts ...TestOption) *TestResponse

+ func (r *TestResponse) Cookie(name string) *http.Cookie

+ func (r *TestResponse) JSON(v any) *TestResponse

+ func (r *TestResponse) WantContains(subs ...string) *TestResponse

+ func (r *TestResponse) WantHeader(name, want string) *TestResponse

+ func (r *TestResponse) WantStatus(code int) *TestResponse

+ type TestingT interface

+ Fatalf func(format string, args ...any)

+ Helper func()

Sep 6, 2026

Changes in this version

+ const ProblemMediaType

+ var ProblemType func(status int) string

type Ctx

+ func (c *Ctx) Accepts(offers ...string) string

+ type Problem struct

+ Detail string

+ Extra map[string]any

+ Fields FieldErrors

+ Instance string

+ Status int

+ Title string

+ Type string

+ func (p *Problem) Error() string

+ func (p *Problem) MarshalJSON() ([]byte, error)

Sep 6, 2026

Changes in this version

+ type CORS struct

+ Credentials bool

+ Expose []string

+ Headers []string

+ MaxAge time.Duration

+ Methods []string

+ Origins []string

type Config

+ CORS CORS

Sep 6, 2026

Changes in this version

type Ctx

+ func (c *Ctx) File(field string, rules FileRules) (*Upload, error)

+ type FileRules struct

+ Accept []string

+ MaxSize int64

+ Optional bool

+ type Upload struct

+ Ext string

+ File multipart.File

+ MIME string

+ Name string

+ Size int64

+ func (u *Upload) Close() error

+ func (u *Upload) Save(dir string) (string, error)

Sep 6, 2026

Changes in this version

+ var ValidationMessages = map[string]string

+ func AddRule(name string, fn func(Field) bool)

+ func UseValidationPTBR()

+ type Field struct

+ Name string

+ Param string

+ Text string

+ Value any

+ func (f Field) Other(name string) string

+ type Validator interface

+ Validate func() error

Sep 6, 2026

Changes in this version

type Ctx

+ func (c *Ctx) CacheControl(v string)

+ func (c *Ctx) ETag(tag string) bool

+ func (c *Ctx) LastModified(t time.Time) bool

Sep 6, 2026

Changes in this version

type Ctx

+ func (c *Ctx) AllowBody(n int64)

+ func (c *Ctx) Hijack() (net.Conn, *bufio.ReadWriter, error)

+ func (c *Ctx) NoReadDeadline() error

Sep 5, 2026

Changes in this version

type Ctx

+ func (c *Ctx) Island(src string, props any, children ...h.Node) h.Node

Sep 5, 2026

Changes in this version

type Config

+ LogRequest func(c *Ctx, status int, dur time.Duration) bool

+ Mounts map[string]fs.FS

Sep 5, 2026

Changes in this version

type Ctx

+ func (c *Ctx) Fragment() string

Sep 5, 2026

Changes in this version

type App

+ func (a *App) Asset(p string) string

type Ctx

+ func (c *Ctx) Asset(p string) string

Sep 5, 2026

Changes in this version

+ const StatusFail

+ const StatusPass

type App

+ func (a *App) Check(name string, fn func(context.Context) error)

+ func (a *App) HealthReport(ctx context.Context) HealthReport

+ func (a *App) Metrics() *Metrics

+ type CheckResult struct

+ DurationMS float64

+ Error string

+ Name string

+ Status string

type Config

+ Observability Observability

+ type Counter struct

+ func (c *Counter) Add(v float64)

+ func (c *Counter) Inc()

+ func (c *Counter) With(values ...string) *Counter

type Ctx

+ func (c *Ctx) Log() *slog.Logger

+ func (c *Ctx) TraceID() string

+ type Gauge struct

+ func (g *Gauge) Add(v float64)

+ func (g *Gauge) Dec()

+ func (g *Gauge) Inc()

+ func (g *Gauge) Set(v float64)

+ func (g *Gauge) With(values ...string) *Gauge

+ type HealthReport struct

+ Checks []CheckResult

+ Status string

+ UptimeSeconds float64

+ type Histogram struct

+ func (h *Histogram) Observe(v float64)

+ func (h *Histogram) With(values ...string) *Histogram

+ type Metrics struct

+ MaxSeries int

+ func (m *Metrics) Counter(name, help string, labels ...string) *Counter

+ func (m *Metrics) Gauge(name, help string, labels ...string) *Gauge

+ func (m *Metrics) Histogram(name, help string, buckets []float64, labels ...string) *Histogram

+ type Observability struct

+ CacheFor time.Duration

+ Details string

+ Health string

+ Metrics string

+ Timeout time.Duration

+ Token string

+ Trusted []string

Sep 5, 2026

Changes in this version

+ var BindInvalid = "valor inválido"

type Ctx

+ func (c *Ctx) Bind(v any) error

+ func (c *Ctx) Render(code int, node h.Node) error

+ type FieldErrors map[string]string

+ func (e FieldErrors) Add(field, msg string)

+ func (e FieldErrors) Any() bool

+ func (e FieldErrors) Error() string

+ func (e FieldErrors) Get(field string) string

+ func (e FieldErrors) Has(field string) bool

+ func (e FieldErrors) OrNil() error

Sep 5, 2026

Changes in this version

type App

+ func (a *App) OnShutdown(fn func(*App) error)

type Config

+ DevReload string

type Route

+ Kind RouteKind

+ type RouteKind int

+ const KindAPI

+ const KindAuto

+ const KindPage

type Timeouts

+ Shutdown time.Duration

Sep 5, 2026

Changes in this version

+ const MinSecretLen

+ const NoTimeout

+ const Off

+ var ErrNoSecret = errors.New("trilha: TRILHA_SECRET não definido; cookies assinados indisponíveis")

+ var ErrRateLimited = &HTTPError

+ func NonceAttr(c *Ctx) h.Node

+ func Run(a *App)

type App

+ func (a *App) AddExportPath(paths ...string)

+ func (a *App) BasePath() string

+ func (a *App) Config() *Config

+ func (a *App) Export(dir string) error

+ func (a *App) ExportPaths() []string

+ func (a *App) Security() *Security

type Config

+ BasePath string

+ OnSecurityEvent func(SecurityEvent)

+ PreviousSecret []byte

+ RateLimit RateLimit

+ Secret []byte

+ Security Security

+ StaticCacheControl string

+ StaticHeaders func(name string, hdr http.Header)

+ Timeouts Timeouts

+ TrustedProxies []string

type Ctx

+ func (c *Ctx) Base() string

+ func (c *Ctx) ClearCookie(name string)

+ func (c *Ctx) ClientIP() string

+ func (c *Ctx) NoWriteDeadline() error

+ func (c *Ctx) Nonce() string

+ func (c *Ctx) SetContext(ctx context.Context)

+ func (c *Ctx) SetRequest(r *http.Request)

+ func (c *Ctx) SetSigned(name, value string, ttl time.Duration) error

+ func (c *Ctx) Signed(name string) (value string, ok bool)

+ func (c *Ctx) Stream() *Stream

type MiddlewareFunc

+ func Limit(rps float64, burst int) MiddlewareFunc

+ type RateLimit struct

+ Burst int

+ RPS float64

+ type Security struct

+ COOP string

+ CSP string

+ CSPExtra map[string][]string

+ FrameOptions string

+ HSTS string

+ PermissionsPolicy string

+ Referrer string

+ type SecurityEvent struct

+ IP string

+ Kind string

+ Method string

+ Path string

+ RequestID string

+ Status int

+ type Signer struct

+ func NewSigner(keys ...[]byte) *Signer

+ func (s *Signer) Sign(value string, exp time.Time) (string, error)

+ func (s *Signer) Verify(token string, now time.Time) (string, bool)

+ type Stream struct

+ func (s *Stream) Comment(text string) error

+ func (s *Stream) Done() <-chan struct{}

+ func (s *Stream) Flush()

+ func (s *Stream) JSON(event string, v any) error

+ func (s *Stream) Send(event, data string) error

+ type Timeouts struct

+ Idle time.Duration

+ MaxHeaderBytes int

+ Read time.Duration

+ ReadHeader time.Duration

+ Write time.Duration

Sep 5, 2026

Changes in this version

+ const CSRFCookie

+ const CSRFField

+ const CSRFHeader

+ var ErrNotFound = errors.New("trilha: not found")

+ func CSRFInput(c *Ctx) h.Node

+ func CompileErrorPage(output string) string

+ func Errorf(code int, format string, a ...any) error

+ func Fatal(err error)

+ func PublicFS(embedded fs.FS, dir string) fs.FS

+ func Redirect(url string) error

+ func RedirectCode(url string, code int) error

+ type App struct

+ func New(cfg Config) *App

+ func (a *App) Env() Env

+ func (a *App) Handler() http.Handler

+ func (a *App) ListenAndServe() error

+ func (a *App) Logger() *slog.Logger

+ func (a *App) Register(r Route)

+ func (a *App) Routes() map[string][]string

+ func (a *App) SetErrorPage(e ErrorPageFunc)

+ func (a *App) SetNotFound(p PageFunc)

+ func (a *App) SetRootLayout(l LayoutFunc)

+ func (a *App) Values() map[string]any

+ type Config struct

+ Addr string

+ CSRFForAPI bool

+ Env Env

+ Logger *slog.Logger

+ MaxBodyBytes int64

+ Public fs.FS

+ func ConfigFromEnv() Config

+ type Ctx struct

+ func (c *Ctx) App() *App

+ func (c *Ctx) BindJSON(v any) error

+ func (c *Ctx) CSRFToken() string

+ func (c *Ctx) Context() context.Context

+ func (c *Ctx) Cookie(name string) (*http.Cookie, error)

+ func (c *Ctx) Env() Env

+ func (c *Ctx) Form(name string) string

+ func (c *Ctx) FormErr() error

+ func (c *Ctx) Get(key string) any

+ func (c *Ctx) HTML(code int, n h.Node) error

+ func (c *Ctx) Header(k, v string)

+ func (c *Ctx) JSON(code int, v any) error

+ func (c *Ctx) Param(name string) string

+ func (c *Ctx) Query(name string) string

+ func (c *Ctx) Redirect(url string) error

+ func (c *Ctx) Request() *http.Request

+ func (c *Ctx) RequestID() string

+ func (c *Ctx) Set(key string, v any)

+ func (c *Ctx) SetCookie(ck *http.Cookie)

+ func (c *Ctx) SetTitle(t string)

+ func (c *Ctx) Status(code int)

+ func (c *Ctx) Text(code int, s string) error

+ func (c *Ctx) Title() string

+ func (c *Ctx) Writer() http.ResponseWriter

+ func (c *Ctx) Written() bool

+ type Env string

+ const Dev

+ const Prod

+ type ErrorPageFunc func(*Ctx, error) (h.Node, error)

+ type HTTPError struct

+ Code int

+ Message string

+ func (e *HTTPError) Error() string

+ type HandlerFunc func(*Ctx) error

+ type LayoutFunc func(*Ctx, h.Node) (h.Node, error)

+ type MiddlewareFunc func(*Ctx, Next) error

+ type Next func() error

+ type PageFunc func(*Ctx) (h.Node, error)

+ type RedirectError struct

+ Code int

+ URL string

+ func (e *RedirectError) Error() string

+ type Route struct

+ Layouts []LayoutFunc

+ Methods map[string]HandlerFunc

+ Middlewares []MiddlewareFunc

+ Page PageFunc

+ Pattern string