feat: release managed service generation and contract diagnostics

examples/managedService/internal/handler/appGen.go

@@ -0,0 +1,36 @@
+// Code generated by go-omni api. DO NOT EDIT.
+package handler
+
+import (
+	"fmt"
+	omni "git.yuntuo.hk/k2safe/go-omni"
+
+	"example.com/managed/internal/svc"
+)
+
+// NewApp is generated HTTP composition. The caller owns deps and its logger.
+func NewApp(deps *svc.ServiceContext) (*omni.App, error) {
+	if deps == nil || deps.Health == nil {
+		return nil, fmt.Errorf("service context and health checker required")
+	}
+	cfg := deps.Config.Server
+	for _, option := range deps.AppOptions() {
+		if option != nil {
+			option(&cfg)
+		}
+	}
+	cfg.Response = newResponseTemplate("{\"body\":null,\"errorBody\":null,\"messageField\":\"msg\",\"requestIdField\":\"-\",\"codeType\":\"int32\",\"successCode\":0,\"errorCode\":9999,\"dataMode\":\"always\"}").Config()
+	cfg.ResponseEncoder = nil
+	if err := cfg.Validate(); err != nil {
+		return nil, err
+	}
+	app := omni.New(omni.WithConfig(cfg))
+	app.Use(deps.GlobalMiddleware()...)
+	if err := RegisterRoutes(app, deps); err != nil {
+		return nil, err
+	}
+	app.GET("/openapi.json", OpenAPI)
+	app.GET("/health/live", deps.Health.LivenessHandler())
+	app.GET("/health/ready", deps.Health.ReadinessHandler())
+	return app, nil
+}

examples/managedService/internal/handler/demo/handlersGen.go

@@ -0,0 +1,134 @@
+// Code generated by go-omni api. DO NOT EDIT.
+package demo
+
+import (
+	"context"
+	"example.com/managed/internal/svc"
+	"example.com/managed/internal/types"
+	"fmt"
+	"git.yuntuo.hk/k2safe/go-omni/contract"
+	"git.yuntuo.hk/k2safe/go-omni/httpx"
+)
+
+type Logic interface {
+	Check(ctx context.Context, req *types.CheckReq) (*types.Receipt, error)
+	Other(ctx context.Context, req *types.CheckReq) (*types.Receipt, error)
+	RawJSON(ctx context.Context) (*types.Receipt, error)
+	Upload(ctx context.Context, body *httpx.Body) (*types.Receipt, error)
+	Callback(ctx context.Context, body *httpx.Body) (*httpx.Stream, error)
+	Download(ctx context.Context) (*httpx.Stream, error)
+	Slow(ctx context.Context) (*types.Receipt, error)
+}
+type Handler struct {
+	logic Logic
+	deps  *svc.ServiceContext
+}
+
+func New(s Logic, deps ...*svc.ServiceContext) *Handler {
+	h := &Handler{logic: s}
+	if len(deps) > 0 {
+		h.deps = deps[0]
+	}
+	return h
+}
+
+var checkRequest = contract.MustNew[types.CheckReq]()
+
+func (h *Handler) Check(c *httpx.Context) error {
+	var req types.CheckReq
+	if err := checkRequest.Bind(c.Request(), httpx.RouteParams(c.Context()), &req); err != nil {
+		return err
+	}
+	resp, err := h.logic.Check(c.Context(), &req)
+	if err != nil {
+		return err
+	}
+	if resp == nil {
+		return fmt.Errorf("Check returned a nil response")
+	}
+	return c.OK(resp)
+}
+
+var otherRequest = contract.MustNew[types.CheckReq]()
+
+func (h *Handler) Other(c *httpx.Context) error {
+	var req types.CheckReq
+	if err := otherRequest.Bind(c.Request(), httpx.RouteParams(c.Context()), &req); err != nil {
+		return err
+	}
+	resp, err := h.logic.Other(c.Context(), &req)
+	if err != nil {
+		return err
+	}
+	if resp == nil {
+		return fmt.Errorf("Other returned a nil response")
+	}
+	return c.OK(resp)
+}
+func (h *Handler) RawJSON(c *httpx.Context) error {
+	resp, err := h.logic.RawJSON(c.Context())
+	if err != nil {
+		return err
+	}
+	if resp == nil {
+		return fmt.Errorf("RawJSON returned a nil response")
+	}
+	return c.OK(resp)
+}
+func (h *Handler) Upload(c *httpx.Context) error {
+	body, err := httpx.NewBody(c.Request(), "multipart")
+	if err != nil {
+		return err
+	}
+	resp, err := h.logic.Upload(c.Context(), body)
+	if err != nil {
+		return err
+	}
+	if resp == nil {
+		return fmt.Errorf("Upload returned a nil response")
+	}
+	if err := body.Complete(); err != nil {
+		return err
+	}
+	return c.OK(resp)
+}
+func (h *Handler) Callback(c *httpx.Context) error {
+	body, err := httpx.NewBody(c.Request(), "raw")
+	if err != nil {
+		return err
+	}
+	resp, err := h.logic.Callback(c.Context(), body)
+	if err != nil {
+		if resp != nil {
+			_ = resp.Close()
+		}
+		return err
+	}
+	if err := body.Complete(); err != nil {
+		if resp != nil {
+			_ = resp.Close()
+		}
+		return err
+	}
+	return c.WriteStream(200, "text/plain", resp)
+}
+func (h *Handler) Download(c *httpx.Context) error {
+	resp, err := h.logic.Download(c.Context())
+	if err != nil {
+		if resp != nil {
+			_ = resp.Close()
+		}
+		return err
+	}
+	return c.WriteStream(200, "application/octet-stream", resp)
+}
+func (h *Handler) Slow(c *httpx.Context) error {
+	resp, err := h.logic.Slow(c.Context())
+	if err != nil {
+		return err
+	}
+	if resp == nil {
+		return fmt.Errorf("Slow returned a nil response")
+	}
+	return c.OK(resp)
+}

examples/managedService/internal/handler/responseGen.go

@@ -0,0 +1,41 @@
+// Code generated by go-omni api. DO NOT EDIT.
+package handler
+
+import (
+	"encoding/json"
+	omnierrors "git.yuntuo.hk/k2safe/go-omni/errors"
+	"git.yuntuo.hk/k2safe/go-omni/response"
+	"strings"
+)
+
+var responseTemplates = map[string]response.Encoder{"": response.Default(),
+	"CommonResponse":    newResponseTemplate("{\"body\":null,\"errorBody\":null,\"messageField\":\"msg\",\"requestIdField\":\"-\",\"codeType\":\"int32\",\"successCode\":0,\"errorCode\":9999,\"dataMode\":\"always\"}"),
+	"AlternateResponse": newResponseTemplate("{\"body\":null,\"errorBody\":null,\"messageField\":\"detail\",\"requestIdField\":\"-\",\"codeType\":\"int32\",\"successCode\":0,\"errorCode\":9999,\"dataMode\":\"always\"}"),
+}
+
+func newResponseTemplate(raw string) *response.Formatter {
+	var cfg response.Config
+	decoder := json.NewDecoder(strings.NewReader(raw))
+	decoder.UseNumber()
+	if err := decoder.Decode(&cfg); err != nil {
+		panic(err)
+	}
+	return response.MustNew(cfg)
+}
+func responseEncoder(name string, raw bool, catalogJSON string) response.Encoder {
+	encoder := responseTemplates[name]
+	if encoder == nil {
+		panic("unknown response template")
+	}
+	var catalog omnierrors.Catalog
+	if err := json.Unmarshal([]byte(catalogJSON), &catalog); err != nil {
+		panic(err)
+	}
+	if len(catalog.Definitions) > 0 {
+		encoder = response.MustWithErrors(catalog, encoder)
+	}
+	if raw {
+		encoder = response.RawJSON(encoder)
+	}
+	return encoder
+}

examples/managedService/internal/handler/routesGen.go

@@ -0,0 +1,26 @@
+// Code generated by go-omni api. DO NOT EDIT.
+package handler
+
+import (
+	h0 "example.com/managed/internal/handler/demo"
+	s0 "example.com/managed/internal/logic/demo"
+	"example.com/managed/internal/svc"
+	"fmt"
+	"git.yuntuo.hk/k2safe/go-omni/httpx"
+	"git.yuntuo.hk/k2safe/go-omni/openapi"
+)
+
+func RegisterRoutes(router openapi.Registrar, deps *svc.ServiceContext) error {
+	if router == nil || deps == nil {
+		return fmt.Errorf("router and dependencies required")
+	}
+	h0 := h0.New(s0.New(deps), deps)
+	httpx.HandleWithResponse(router, "GET", "/check", responseEncoder("CommonResponse", false, "{\"definitions\":{}}"), h0.Check)
+	httpx.HandleWithResponse(router, "GET", "/other", responseEncoder("AlternateResponse", false, "{\"definitions\":{}}"), h0.Other)
+	httpx.HandleWithResponse(router, "GET", "/raw", responseEncoder("CommonResponse", true, "{\"definitions\":{}}"), h0.RawJSON)
+	httpx.HandleWithBodyLimit(router, "POST", "/upload", 2048, responseEncoder("CommonResponse", false, "{\"definitions\":{}}"), h0.Upload)
+	httpx.HandleWithBodyLimit(router, "POST", "/callback", 64, responseEncoder("CommonResponse", false, "{\"definitions\":{}}"), h0.Callback)
+	httpx.HandleWithResponse(router, "GET", "/download", responseEncoder("CommonResponse", false, "{\"definitions\":{}}"), h0.Download)
+	httpx.HandleWithResponse(router, "GET", "/slow", responseEncoder("CommonResponse", false, "{\"definitions\":{}}"), h0.Slow)
+	return nil
+}