feat(ws): release generic WebSocket client and server v0.31.0-preview

examples/managedService/.goOmni/apiManifest.json

@@ -13,7 +13,7 @@
   "generated": {
     "docs/openapi.json": "0370fd6bd6a387e2ef21f6b42b009ce66749846b8bea3d481009a34f3af039a5",
     "internal/config/loadGen.go": "d85e3123e4c96c95cb0886e60e4760230426efca4d2bbbfc981822da08b90d13",
-    "internal/handler/appGen.go": "f5251b4dc33e2312b0bdb71ead70d2171977d851265e124f640458d705a2cc9d",
+    "internal/handler/appGen.go": "66e54c8f60fc273b4dc856c9578390b15604d99ad2e581a1899cc4b7ebb70f3b",
     "internal/handler/demo/handlersGen.go": "3c76d85dbe89eb5127d9d134dc625203ecf9719dd11d174c1f335691b99e1375",
     "internal/handler/openapiGen.go": "f24cab3abbb8557a3fc4dd93fba23cc0b093f3e0c944d3ba1bd5b0eeff2d96f3",
     "internal/handler/responseGen.go": "84397a502bba4777ebfa6fae3d3bc418297acab4f26b04b42e3c31b36c735399",

examples/managedService/internal/handler/appGen.go

@@ -2,6 +2,7 @@
 package handler
 
 import (
+	"errors"
 	"fmt"
 	omni "git.yuntuo.hk/k2safe/go-omni"
 	"git.yuntuo.hk/k2safe/go-omni/contract"
@@ -66,5 +67,11 @@ func NewApp(deps *svc.ServiceContext) (*omni.App, error) {
 		}
 		app.GET(cfg.Endpoints.Readiness.Path, deps.Health.ReadinessHandler(options...))
 	}
+	// Optional project-owned extension; no generated file needs hand edits.
+	if extension, ok := any(deps).(interface{ RegisterCustomRoutes(*omni.App) error }); ok {
+		if err := extension.RegisterCustomRoutes(app); err != nil {
+			return nil, errors.Join(err, app.Close())
+		}
+	}
 	return app, nil
 }