Separate APIs into multiple openapi docs

[shaunho57]

Hi,

I am aware of example of https://github.com/swaggest/rest/blob/master/_examples/mount/main.go and try to replicate it, but instead of having APIs in 1 doc, I wanted to separate into multiple docs.

Here's my code

package main

import (
	"context"
	"fmt"
	"github.com/go-chi/chi/v5"
	"github.com/swaggest/openapi-go/openapi31"
	"github.com/swaggest/rest/nethttp"
	"github.com/swaggest/rest/web"
	swguiv5emb "github.com/swaggest/swgui/v5emb"
	"github.com/swaggest/usecase"
	"log"
	"net/http"
)

func main() {
	service := web.NewService(openapi31.NewReflector())
	apiService := web.NewService(openapi31.NewReflector())

	// service endpoint, `/foo`
	service.Get("/foo", func() usecase.Interactor {
		u := usecase.NewInteractor(func(ctx context.Context, input, output *string) error {
			*output = "foo"
			return nil
		})
		u.SetTitle("Foo")
		u.SetTags("Service")
		return u
	}())

	// apiService endpoint, `/api/bar` cause will be mounted onto service with `/api` later
	apiService.Group(func(router chi.Router) {
		router.Method(http.MethodGet, "/bar", nethttp.NewHandler(func() usecase.Interactor {
			u := usecase.NewInteractor(func(ctx context.Context, input, output *string) error {
				*output = "bar"
				return nil
			})
			u.SetTitle("Bar")
			u.SetTags("ApiService")
			return u
		}()))
	})
	apiService.Route("/api", func(router chi.Router) {})

	// mount apiService onto service, so we can expect all routes in apiService will prepend with `/api`
	service.Mount("/api", apiService)

	// prepare the docs
	pattern := "/docs"
	apiPattern := "/api/docs"
	apiService.Method(http.MethodGet, pattern+"/openapi.json", apiService.OpenAPICollector)
	// prepare swgui in `/api/docs`
	// use `pattern` instead of `apiPattern` because apiService will be mounted under `/api`,
	// for some reason, swaggerJSONPath and basePath must prepend with `/api` else swgui will not work
	apiService.Mount(pattern, swguiv5emb.NewHandler(apiService.OpenAPISchema().Title(), apiPattern+"/openapi.json", apiPattern))

	// prepare the docs
	adminPattern := "/admin/docs"
	service.Method(http.MethodGet, adminPattern+"/openapi.json", service.OpenAPICollector)
	service.Mount(adminPattern, swguiv5emb.NewHandler(service.OpenAPISchema().Title(), adminPattern+"/openapi.json", adminPattern))

	// serve
	fmt.Println("Swagger UI at http://localhost:8888/admin/docs and http://localhost:8888/api/docs.")
	if err := http.ListenAndServe("localhost:8888", service); err != nil {
		log.Fatal(err)
	}
}

Expected:
the routes in /api/docs should prefix with /api

Actual:
when view document at /api/docs, the api listed do not contain /api prefix as it being mounted with pattern /api

I am looking for a solution for this.
Its either a way to make the Collector to have a prefix so I can set it manually
Or a way to mount *web.Service without a pattern, so I can use apiService.Route("/api", func (router chi.Router) {}) to wrap the API
Or any suggestion to make this happened?

Thanks in advance