server

Documentation

Index

• type Option
  • func WithLogger(log *slog.Logger) Option
• type Server
  • func New(opts ...Option) *Server
  • func (s *Server) IdentityMiddleware() func(http.Handler) http.Handler
  • func (s *Server) Router() chi.Router
  • func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)
  • func (s *Server) SetFrontend(webFS fs.FS)
  • func (s *Server) SetMCP(mcpSrv *mcpserver.MCPServer, ...)
  • func (s *Server) SetTailscale(lc middleware.WhoisClient, us middleware.UserStore)

Types

type Option

type Option func(*Server)

Option configures server creation.

func WithLogger

func WithLogger(log *slog.Logger) Option

WithLogger sets the server logger.

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server is a shared HTTP server with routing, identity, and optional frontend serving.

func New

func New(opts ...Option) *Server

New creates a new Server with RequestLogging, CORS, and /healthz.

func (*Server) IdentityMiddleware

func (s *Server) IdentityMiddleware() func(http.Handler) http.Handler

IdentityMiddleware returns middleware that uses Tailscale identity if configured, otherwise falls back to DevIdentity.

func (*Server) Router

func (s *Server) Router() chi.Router

Router returns the chi.Router for adding application routes.

func (*Server) ServeHTTP

func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP implements http.Handler.

func (*Server) SetFrontend

func (s *Server) SetFrontend(webFS fs.FS)

SetFrontend mounts the embedded SPA filesystem. Unmatched routes serve index.html for client-side routing. Hashed assets get long cache; index.html is never cached.

func (*Server) SetMCP

func (s *Server) SetMCP(mcpSrv *mcpserver.MCPServer, userIDInjector func(ctx context.Context, r *http.Request) context.Context)

SetMCP mounts an MCP server at /mcp with identity middleware. userIDInjector is called to inject the user ID into the MCP context.

func (*Server) SetTailscale

func (s *Server) SetTailscale(lc middleware.WhoisClient, us middleware.UserStore)

SetTailscale configures Tailscale identity resolution.