feat(api): add pave spec to route /v1/spec and add seed to it

Exposes the API spec in pave format, which intends to show information
about all API routes.

Also pave V1SeedPOST and V1SpecGET

cmd/server.go

@@ -13,12 +13,15 @@ import (
 	"io"
 	"net/http"
 
+	"codeberg.org/vlbeaudoin/pave"
 	"codeberg.org/vlbeaudoin/serpents"
 	"github.com/spf13/cobra"
 	"github.com/spf13/viper"
 
 	"git.agecem.com/agecem/agecem-org/api"
 	"git.agecem.com/agecem/agecem-org/apihandler"
+	"git.agecem.com/agecem/agecem-org/apirequest"
+	"git.agecem.com/agecem/agecem-org/apiresponse"
 	"git.agecem.com/agecem/agecem-org/config"
 	"git.agecem.com/agecem/agecem-org/media"
 	"git.agecem.com/agecem/agecem-org/public"
@@ -205,14 +208,27 @@ func RunServer() {
 		log.Fatal("Error during NewMediaClientFromViper for API handlers")
 	}
 
+	p := pave.New()
+
 	v1Handler := apihandler.V1Handler{
 		Config:      cfg,
 		MediaClient: mediaClient,
+		Pave:        &p,
 	}
 
 	groupV1.GET("", v1Handler.HandleV1)
 
-	groupV1.POST("/seed", v1Handler.HandleV1Seed)
+	if err := pave.EchoRegister[
+		apirequest.V1SeedPOST,
+		apiresponse.V1SeedPOST](groupV1, &p, "/v1", http.MethodPost, "/seed", "Créer buckets manquants définis dans `server.documents.buckets`", "V1SeedPOST", v1Handler.HandleV1Seed); err != nil {
+		log.Fatal(err)
+	}
+
+	if err := pave.EchoRegister[
+		apirequest.V1SpecGET,
+		apiresponse.V1SpecGET](groupV1, &p, "/v1", http.MethodGet, "/spec", apihandler.DescriptionV1SpecGET, "V1SpecGET", v1Handler.HandleV1Spec); err != nil {
+		log.Fatal(err)
+	}
 
 	groupV1.GET("/bucket", v1Handler.HandleV1BucketList)