refrakt

Runtime helpers for Refrakt, a convention-first web framework for Gleam built on Wisp, Lustre and Mist.

This is the small library that Refrakt apps import at runtime. The code generator lives in the separate refrakt_cli package, which apps only need as a dev-dependency.

gleam add refrakt
gleam add --dev refrakt_cli

New to Refrakt? Start with the installation guide and the tutorial.

Modules

Module	What it does
`refrakt/validate`	Composable validators that return `List(#(String, String))` errors
`refrakt/flash`	Flash messages on signed cookies
`refrakt/csrf`	Rejects cross-site form posts (`Sec-Fetch-Site`, `Origin`, `Referer`)
`refrakt/migrate`	Runs SQL migration files and tracks them in a `_migrations` table
`refrakt/testing`	Request builders for handler tests
`refrakt/dev_error`	Development error page
`refrakt/jobs`	Background jobs in OTP processes, with a concurrency limit (experimental)
`refrakt/token`	Signed, expiring tokens bound to a purpose
`refrakt/mailer`	Email builder with pluggable delivery adapters (experimental)
`refrakt/paginate`	Pagination helpers for list views
`refrakt/upload`	Multipart file upload handling
`refrakt/cors`	CORS middleware (experimental)
`refrakt/rate_limit`	Sliding-window rate-limiting middleware (experimental)
`refrakt/pubsub`	Topic-based publish/subscribe (experimental)
`refrakt/telemetry`	Request counts, response times and error rates (experimental)

Modules marked experimental are lightly used and may change or move to their own package (#28).

import refrakt/validate

pub fn validate_post(title: String, body: String) -> List(#(String, String)) {
  []
  |> validate.required(title, "title", "Title is required")
  |> validate.max_length(title, "title", 200, "Title is too long")
  |> validate.required(body, "body", "Body is required")
}

Further documentation can be found at https://hexdocs.pm/refrakt.

License

MIT