feat: add bounded native http server

app/app.go

@@ -29,6 +29,13 @@ type App struct {
 	closeErr    error
 }
 
+// Runner is the small lifecycle boundary used by an HTTP server
+// implementation. The default App.RunContext uses net/http; a custom runner
+// can own the listener, protocol parser and connection lifecycle.
+type Runner interface {
+	Run(context.Context, http.Handler, string) error
+}
+
 // New creates an application using GoOmni's standard-library router.
 func New(options ...config.Option) *App {
 	settings := configure(options...)
@@ -150,6 +157,25 @@ func (a *App) RunContext(ctx context.Context, address ...string) error {
 	return a.serveContext(ctx, server, listener)
 }
 
+// RunWith starts a custom server runner while keeping App-owned cleanup in the
+// same lifecycle. The runner receives the transport-neutral App handler.
+func (a *App) RunWith(ctx context.Context, runner Runner, address ...string) error {
+	if runner == nil {
+		return errors.Join(errors.New("go-omni: nil runner"), a.Close())
+	}
+	if ctx == nil {
+		ctx = context.Background()
+	}
+	listenOn := a.config.Address
+	if listenOn == "" {
+		listenOn = ":8080"
+	}
+	if len(address) > 0 && address[0] != "" {
+		listenOn = address[0]
+	}
+	return errors.Join(runner.Run(ctx, a, listenOn), a.Close())
+}
+
 func (a *App) serveContext(ctx context.Context, server *http.Server, listener net.Listener) error {
 	serveErr := make(chan error, 1)
 	go func() { serveErr <- server.Serve(listener) }()