#Alepha - Server

#Installation

Part of the alepha package. Import from alepha/server.

npm install alepha

#Overview

Convention-driven HTTP server with automatic validation and type inference.

Features:

• Type-safe API endpoints with schema validation
• Lower-level HTTP route definitions
• Automatic request/response validation via Zod
• Convention-based URL generation (/api/{ActionName})
• Direct invocation (run()) or HTTP (fetch())
• Built-in authentication integration
• Multipart file upload handling
• Response compression (gzip, brotli, zstd)
• Security headers (HSTS, CSP, X-Frame-Options, etc.)
• Content-type auto-negotiation (JSON, form-data, text)
• HTTP methods: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
• Error handling: BadRequestError, ValidationError, ForbiddenError, UnauthorizedError, ConflictError, NotFoundError

#API Reference

#Primitives

• $action - Creates a server action primitive for defining type-safe HTTP endpoints.
• $circuit - Middleware that implements the circuit breaker pattern.
• $middleware - Applies middleware functions to every route whose path starts with a prefix.
• $route - Create a basic endpoint.
• $sse - Creates a Server-Sent Events (SSE) primitive for streaming typed events to clients.

#Providers

• ServerHealthProvider - Registers GET /health and GET /healthz.
• ServerHelmetProvider - Provides a configurable way to apply essential HTTP security headers
• ServerMultipartProvider - Parses multipart/form-data request bodies into route handler input.
• ServerNotReadyProvider - On every request, this provider checks if the server is ready.
• ServerProvider - Base server provider to handle incoming requests and route them.
• ServerRouterProvider - Main router for all routes server side.

#Environment Variables

Environment variables used to configure this module. These can be set in your .env file or through your deployment configuration.