Catd graphql play

cmd/catalogd/main.go

@@ -365,11 +365,11 @@ func run(ctx context.Context) error {
 		return err
 	}
 
-	localStorage = &storage.LocalDirV1{
-		RootDir:            storeDir,
-		RootURL:            baseStorageURL,
-		EnableMetasHandler: features.CatalogdFeatureGate.Enabled(features.APIV1MetasHandler),
-	}
+	localStorage = storage.NewLocalDirV1(
+		storeDir,
+		baseStorageURL,
+		features.CatalogdFeatureGate.Enabled(features.APIV1MetasHandler),
+	)
 
 	// Config for the catalogd web server
 	catalogServerConfig := serverutil.CatalogServerConfig{

go.mod

@@ -136,6 +136,7 @@ require (
 	github.com/gorilla/mux v1.8.1 // indirect
 	github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674 // indirect
 	github.com/gosuri/uitable v0.0.4 // indirect
+	github.com/graphql-go/graphql v0.8.1 // indirect
 	github.com/gregjones/httpcache v0.0.0-20190611155906-901d90724c79 // indirect
 	github.com/grpc-ecosystem/grpc-gateway/v2 v2.27.0 // indirect
 	github.com/h2non/filetype v1.1.3 // indirect

go.sum

@@ -261,6 +261,8 @@ github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674 h1:JeSE6pjso5T
 github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674/go.mod h1:r4w70xmWCQKmi1ONH4KIaBptdivuRPyosB9RmPlGEwA=
 github.com/gosuri/uitable v0.0.4 h1:IG2xLKRvErL3uhY6e1BylFzG+aJiwQviDDTfOKeKTpY=
 github.com/gosuri/uitable v0.0.4/go.mod h1:tKR86bXuXPZazfOTG1FIzvjIdXzd0mo4Vtn16vt0PJo=
+github.com/graphql-go/graphql v0.8.1 h1:p7/Ou/WpmulocJeEx7wjQy611rtXGQaAcXGqanuMMgc=
+github.com/graphql-go/graphql v0.8.1/go.mod h1:nKiHzRM0qopJEwCITUuIsxk9PlVlwIiiI8pnJEhordQ=
 github.com/gregjones/httpcache v0.0.0-20190611155906-901d90724c79 h1:+ngKgrYPPJrOjhax5N+uePQ0Fh1Z7PheYoUI/0nzkPA=
 github.com/gregjones/httpcache v0.0.0-20190611155906-901d90724c79/go.mod h1:FecbI9+v66THATjSRHfNgh1IVFe/9kFxbXtjV0ctIMA=
 github.com/grpc-ecosystem/go-grpc-prometheus v1.2.1-0.20210315223345-82c243799c99 h1:JYghRBlGCZyCF2wNUJ8W0cwaQdtpcssJ4CgC406g+WU=

internal/catalogd/features/features.go

@@ -10,10 +10,12 @@ import (
 
 const (
 	APIV1MetasHandler = featuregate.Feature("APIV1MetasHandler")
+	GraphQLCatalogQueries = featuregate.Feature("GraphQLCatalogQueries")
 )
 
 var catalogdFeatureGates = map[featuregate.Feature]featuregate.FeatureSpec{
 	APIV1MetasHandler: {Default: false, PreRelease: featuregate.Alpha},
+	GraphQLCatalogQueries: {Default: false, PreRelease: featuregate.Alpha},
 }
 
 var CatalogdFeatureGate featuregate.MutableFeatureGate = featuregate.NewFeatureGate()

internal/catalogd/graphql/README.md

@@ -0,0 +1,106 @@
+# GraphQL Integration
+
+This package provides dynamic GraphQL schema generation for operator catalog data, integrated into the catalogd storage server.
+
+## Usage
+
+The GraphQL endpoint is now available as part of the catalogd storage server at:
+
+```
+{catalog}/api/v1/graphql
+```
+
+Where `{catalog}` is replaced by the actual catalog name at runtime.
+
+## Example Usage
+
+### Making a GraphQL Request
+
+```bash
+curl -X POST http://localhost:8080/my-catalog/api/v1/graphql \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "{ summary { totalSchemas schemas { name totalObjects totalFields } } }"
+  }'
+```
+
+### Sample Queries
+
+#### Get catalog summary:
+```graphql
+{
+  summary {
+    totalSchemas
+    schemas {
+      name
+      totalObjects
+      totalFields
+    }
+  }
+}
+```
+
+#### Get bundles with pagination:
+```graphql
+{
+  bundles(limit: 5, offset: 0) {
+    name
+    package
+    version
+  }
+}
+```
+
+#### Get packages:
+```graphql
+{
+  packages(limit: 10) {
+    name
+    description
+  }
+}
+```
+
+#### Get bundle properties (union types):
+```graphql
+{
+  bundles(limit: 5) {
+    name
+    properties {
+      type
+      value {
+        ... on PropertyValueFeaturesOperatorsOpenshiftIo {
+          disconnected
+          cnf
+          cni
+          csi
+          fips
+        }
+      }
+    }
+  }
+}
+```
+
+## Features
+
+- **Dynamic Schema Generation**: Automatically discovers schema structure from catalog metadata
+- **Union Types**: Supports complex bundle properties with variable structures
+- **Pagination**: Built-in limit/offset pagination for all queries
+- **Field Name Sanitization**: Converts JSON field names to valid GraphQL identifiers
+- **Catalog-Specific**: Each catalog gets its own dynamically generated schema
+
+## Integration
+
+The GraphQL functionality is integrated into the `LocalDirV1` storage handler in `internal/catalogd/storage/localdir.go`:
+
+- `handleV1GraphQL()`: Handles POST requests to the GraphQL endpoint
+- `createCatalogFS()`: Creates filesystem interface for catalog data
+- `buildCatalogGraphQLSchema()`: Builds dynamic GraphQL schema for specific catalogs
+
+## Technical Details
+
+- Uses `declcfg.WalkMetasFS` to discover schema structure
+- Generates GraphQL object types dynamically from discovered fields
+- Creates union types for bundle properties with variable structures
+- Supports all standard GraphQL features including introspection