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
+}