datapages-server

Server entry point

Read datapages first for the build loop, hard rules and naming conventions.

On its first run, datapages gen writes the server command's main.go. It does not regenerate that file on later runs.

NewServer

datapages gen reads the type arguments to find the app package and output directory.

s, err := datapages.NewServer[
	app.App,                     // App
	app.SessionData,             // or datapages.DisableSessions
	datapages.DisablePrometheus, // or datapages.EnablePrometheus
	datapagesgen.Server,         // the datapagesgen of that app package
](&a, broker, opts...) // the app is passed by pointer

Keep the call inside the module. Import datapages with a package name because the scanner rejects dot imports. Generated code is always in datapagesgen directly below its app package. 1 module can contain several apps. Run one with datapages watch --app app/frontend, the directory of its app package.

datapages.EnablePrometheus requires WithPrometheus, DisablePrometheus rejects it.

Broker

A broker is always required. It sends events between server instances and to SSE subscribers. Use modules/messaging/natscore for multiple instances. Use modules/messaging/inmem only for 1 instance. The generated server uses NATS. Start it with make up before starting the server.

Options

var opts []datapages.ServerOption
opts = append(opts,
	datapages.WithLogger(slog.Default()),
	datapages.WithMiddleware(mw),
	datapages.WithSessions(datapages.SessionsConfig{}),
	datapages.WithSessionManager[app.SessionData](mgr),
	datapages.WithAssets(app.StaticFS, false),
	datapages.WithHTTPServer(&http.Server{ReadHeaderTimeout: 10 * time.Second}),
	datapages.WithDatastarJS("https://cdn.example.com/datastar.js"),
	datapages.WithShutdownTimeout(30*time.Second),
	datapages.WithFileSendTimeout(time.Minute),
	datapages.WithAssetsCache(datapages.AssetsCacheConfig{}),
	datapages.WithBodySizeLimit(1<<20),
	datapages.WithLogSampling(datapages.LogSamplingConfig{Interval: time.Minute}),
	datapages.WithSSECompression(datapages.SSECompressionConfig{}),
	datapages.WithPrometheus(datapages.PrometheusConfig{Host: ":9091"}),
)