feat: release managed service generation and contract diagnostics

examples/managedService/internal/svc/close.go

@@ -0,0 +1,36 @@
+package svc
+
+import "errors"
+
+// Close is idempotent, including startup failure and graceful shutdown.
+func (c *ServiceContext) Close() error {
+	if c == nil {
+		return nil
+	}
+	c.closeOnce.Do(func() {
+		c.closeMu.Lock()
+		c.closed = true
+		cleanups := c.cleanups
+		c.cleanups = nil
+		c.closeMu.Unlock()
+		for i := len(cleanups) - 1; i >= 0; i-- {
+			c.closeErr = errors.Join(c.closeErr, cleanups[i]())
+		}
+
+	})
+	return c.closeErr
+}
+
+// OnClose transfers a resource cleanup to this context immediately after creation.
+// Hooks run once in reverse order, also when later initialization fails.
+func (c *ServiceContext) OnClose(cleanup func() error) {
+	if cleanup == nil {
+		return
+	}
+	c.closeMu.Lock()
+	defer c.closeMu.Unlock()
+	if c.closed {
+		panic("svc: register cleanup after Close")
+	}
+	c.cleanups = append(c.cleanups, cleanup)
+}

examples/managedService/internal/svc/options.go

@@ -0,0 +1,24 @@
+package svc
+
+import (
+	"example.com/managed/internal/apierrors"
+	omni "git.yuntuo.hk/k2safe/go-omni"
+	omnierrors "git.yuntuo.hk/k2safe/go-omni/errors"
+	"git.yuntuo.hk/k2safe/go-omni/httpx"
+)
+
+func (c *ServiceContext) AppOptions() []omni.Option {
+	return []omni.Option{omni.WithErrors(apierrors.Catalog())}
+}
+func (c *ServiceContext) GlobalMiddleware() []httpx.Middleware {
+	return []httpx.Middleware{
+		func(next httpx.Handler) httpx.Handler {
+			return func(c *httpx.Context) error {
+				if c.Header("X-Fail") != "" {
+					return omnierrors.ByCode("INVALID")
+				}
+				return next(c)
+			}
+		},
+	}
+}

examples/managedService/internal/svc/serviceContext.go

@@ -0,0 +1,59 @@
+package svc
+
+import (
+	"context"
+	"errors"
+	"sync"
+
+	"example.com/managed/internal/config"
+	"example.com/managed/internal/middleware"
+	"git.yuntuo.hk/k2safe/go-omni/health"
+	"git.yuntuo.hk/k2safe/go-omni/httpx"
+	"git.yuntuo.hk/k2safe/go-omni/logx"
+)
+
+// Context owns infrastructure, while Logger is borrowed from main.
+// Add business repositories here; HTTP contracts do not define database tables.
+type ServiceContext struct {
+	Config      config.Config
+	cleanups    []func() error
+	Logger      *logx.Logger
+	Health      *health.Checker
+	Middlewares map[string]httpx.Middleware
+
+	closeMu   sync.Mutex
+	closed    bool
+	closeOnce sync.Once
+	closeErr  error
+}
+
+// Pass the settings loaded by main. The optional form supports lightweight
+// tests without infrastructure; selected adapters still require valid config.
+func New(ctx context.Context, logger *logx.Logger, configs ...config.Config) (result *ServiceContext, err error) {
+	if ctx == nil {
+		ctx = context.Background()
+	}
+	if err = ctx.Err(); err != nil {
+		return nil, err
+	}
+	if len(configs) > 1 {
+		return nil, errors.New("expected at most one configuration")
+	}
+	cfg := config.Default()
+	if len(configs) == 1 {
+		cfg = configs[0]
+	}
+	_ = cfg
+	checker, err := health.New()
+	if err != nil {
+		return nil, err
+	}
+	c := &ServiceContext{Config: cfg, Logger: logger, Health: checker, Middlewares: middleware.Defaults()}
+	defer func() {
+		if err != nil {
+			err = errors.Join(err, c.Close())
+		}
+	}()
+
+	return c, nil
+}