Added openapi spec

pkg/restheadspec/handler.go

@@ -24,11 +24,12 @@ type FallbackHandler func(w common.ResponseWriter, r common.Request, params map[
 // Handler handles API requests using database and model abstractions
 // This handler reads filters, columns, and options from HTTP headers
 type Handler struct {
-	db              common.Database
-	registry        common.ModelRegistry
-	hooks           *HookRegistry
-	nestedProcessor *common.NestedCUDProcessor
-	fallbackHandler FallbackHandler
+	db                 common.Database
+	registry           common.ModelRegistry
+	hooks              *HookRegistry
+	nestedProcessor    *common.NestedCUDProcessor
+	fallbackHandler    FallbackHandler
+	openAPIGenerator   func() (string, error)
 }
 
 // NewHandler creates a new API handler with database and registry abstractions
@@ -78,6 +79,12 @@ func (h *Handler) Handle(w common.ResponseWriter, r common.Request, params map[s
 		}
 	}()
 
+	// Check for ?openapi query parameter
+	if r.UnderlyingRequest().URL.Query().Get("openapi") != "" {
+		h.HandleOpenAPI(w, r)
+		return
+	}
+
 	ctx := r.UnderlyingRequest().Context()
 
 	schema := params["schema"]
@@ -208,6 +215,12 @@ func (h *Handler) HandleGet(w common.ResponseWriter, r common.Request, params ma
 		}
 	}()
 
+	// Check for ?openapi query parameter
+	if r.UnderlyingRequest().URL.Query().Get("openapi") != "" {
+		h.HandleOpenAPI(w, r)
+		return
+	}
+
 	schema := params["schema"]
 	entity := params["entity"]
 
@@ -2379,3 +2392,32 @@ func (h *Handler) extractTagValue(tag, key string) string {
 	}
 	return ""
 }
+
+// HandleOpenAPI generates and returns the OpenAPI specification
+func (h *Handler) HandleOpenAPI(w common.ResponseWriter, r common.Request) {
+	// Import needed here to avoid circular dependency
+	// The import is done inline
+	// We'll use a factory function approach instead
+	if h.openAPIGenerator == nil {
+		logger.Error("OpenAPI generator not configured")
+		h.sendError(w, http.StatusInternalServerError, "openapi_not_configured", "OpenAPI generation not configured", nil)
+		return
+	}
+
+	spec, err := h.openAPIGenerator()
+	if err != nil {
+		logger.Error("Failed to generate OpenAPI spec: %v", err)
+		h.sendError(w, http.StatusInternalServerError, "openapi_generation_error", "Failed to generate OpenAPI specification", err)
+		return
+	}
+
+	w.SetHeader("Content-Type", "application/json")
+	w.WriteHeader(http.StatusOK)
+	w.Write([]byte(spec))
+}
+
+// SetOpenAPIGenerator sets the OpenAPI generator function
+// This allows avoiding circular dependencies
+func (h *Handler) SetOpenAPIGenerator(generator func() (string, error)) {
+	h.openAPIGenerator = generator
+}

pkg/restheadspec/restheadspec.go

@@ -99,6 +99,16 @@ type MiddlewareFunc func(http.Handler) http.Handler
 // authMiddleware is optional - if provided, routes will be protected with the middleware
 // Example: SetupMuxRoutes(router, handler, func(h http.Handler) http.Handler { return security.NewAuthHandler(securityList, h) })
 func SetupMuxRoutes(muxRouter *mux.Router, handler *Handler, authMiddleware MiddlewareFunc) {
+	// Add global /openapi route
+	openAPIHandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		corsConfig := common.DefaultCORSConfig()
+		respAdapter := router.NewHTTPResponseWriter(w)
+		common.SetCORSHeaders(respAdapter, corsConfig)
+		reqAdapter := router.NewHTTPRequest(r)
+		handler.HandleOpenAPI(respAdapter, reqAdapter)
+	})
+	muxRouter.Handle("/openapi", openAPIHandler).Methods("GET", "OPTIONS")
+
 	// Get all registered models from the registry
 	allModels := handler.registry.GetAllModels()
 
@@ -264,12 +274,27 @@ func ExampleWithBun(bunDB *bun.DB) {
 func SetupBunRouterRoutes(bunRouter *router.StandardBunRouterAdapter, handler *Handler) {
 	r := bunRouter.GetBunRouter()
 
-	// Get all registered models from the registry
-	allModels := handler.registry.GetAllModels()
-
 	// CORS config
 	corsConfig := common.DefaultCORSConfig()
 
+	// Add global /openapi route
+	r.Handle("GET", "/openapi", func(w http.ResponseWriter, req bunrouter.Request) error {
+		respAdapter := router.NewHTTPResponseWriter(w)
+		common.SetCORSHeaders(respAdapter, corsConfig)
+		reqAdapter := router.NewBunRouterRequest(req)
+		handler.HandleOpenAPI(respAdapter, reqAdapter)
+		return nil
+	})
+
+	r.Handle("OPTIONS", "/openapi", func(w http.ResponseWriter, req bunrouter.Request) error {
+		respAdapter := router.NewHTTPResponseWriter(w)
+		common.SetCORSHeaders(respAdapter, corsConfig)
+		return nil
+	})
+
+	// Get all registered models from the registry
+	allModels := handler.registry.GetAllModels()
+
 	// Loop through each registered model and create explicit routes
 	for fullName := range allModels {
 		// Parse the full name (e.g., "public.users" or just "users")