public sealed interface Server extends AutoCloseable {
    void start();
    void stop();
    int port();
    static ServerBuilder builder();
}

Router.builder()
    .get(path, handler)
    .post(path, handler)
    .put(path, handler)
    .delete(path, handler)
    .patch(path, handler)
    .head(path, handler)            // also auto for GET
    .options(path, handler)
    .group(prefix, sub -> sub.filter(...).get(...))
    .mount(prefix, handler)
    .filter(filter)
    .notFound(handler)
    .build();

public interface Filter {
    Handler apply(Handler next);

    static Filter addHeader(String name, String value);
    static Filter addHeaderIf(BooleanSupplier when, String name, String value);
    static Filter addHeaderIfEnv(String envVar, String expected, String name, String value);
    static Filter gzip();
    static Filter gzip(int threshold);
    static Filter accessLog();                          (1)
    static Filter accessLog(Consumer<String> sink);     (2)

    default Filter andThen(Filter next);
}

public final class BuildInfo {
    public static String version();          // e.g. "0.1.0-SNAPSHOT"
    public static String gitCommit();        // e.g. "8d670fb0"
    public static String buildTimestamp();   // e.g. "2026-05-09T19:43:04Z"
    public static String javaVersion();      // e.g. "25.0.3"
    public static String serverHeader();     // e.g. "Chappe/0.1.0-SNAPSHOT+8d670fb0 (2026-05-09T19:43:04Z)"
}

StaticFileHandler.builder()
    .addPath(Path)                       // filesystem (zero-copy sendfile)
    .addClasspath(String resourceRoot)   // classpath (jar, module)
    .cacheInMemory(boolean)              // ETag cache for classpath resources
    .cacheControl(String)
    .preferPrecompressed(boolean)        // .br / .gz sidecars when Accept-Encoding allows
    .spaFallback(String)                 // 200 on 404 (SPA mode)
    .notFoundFile(String)                // 404 on 404 (mutually exclusive)
    .indexFiles(String...)
    .build();

record Entry(String coding, double qvalue) {}

List<Entry>  AcceptEncoding.parse(String header);
boolean      AcceptEncoding.accepts(String header, String coding);

String mime = MimeTypes.detect(path);    // 26+ types: text/html, application/json, image/png, ...

public final class RequestContext {
    public static final ScopedValue<RequestContext> CURRENT;
    public static Request currentRequest();
    public Map<String, Object> attributes();
}

server:
  port: 8080
  bind: 0.0.0.0

static:
  root: /var/www/site
  fallback: /404.html               # status 404
  spa-fallback: /index.html         # status 200 (mutually exclusive with fallback)
  index-files: [index.html]
  cache-control: "max-age=3600, public"
  gzip: true                         # negotiated through Accept-Encoding

headers:
  always:                            # injected on every response
    X-Content-Type-Options: "nosniff"
    Referrer-Policy: "strict-origin-when-cross-origin"
  staging:                           # active when env var STAGING=true
    X-Robots-Tag: "noindex, nofollow"

logging:
  level: INFO
  access-log: false

Server: Chappe/0.1.0-SNAPSHOT+8d670fb0 (2026-05-09T19:43:04Z)
X-Chappe-Build: Chappe/0.1.0-SNAPSHOT+8d670fb0 (2026-05-09T19:43:04Z)

1.2.3.4 - yann.blazart@gmail.com [09/May/2026:18:50:54 +0000] "GET /a.png HTTP/1.1" 200 877719 12ms