// SPDX-License-Identifier: EUPL-1.2

package api

import (
	"slices"
	"strings"
)

// OpenAPISpecBuilder returns a SpecBuilder populated from the engine's current
// Swagger and transport metadata.
//
// Example:
//
//	builder := engine.OpenAPISpecBuilder()
func (e *Engine) OpenAPISpecBuilder() *SpecBuilder {
	if e == nil {
		return &SpecBuilder{}
	}

	builder := &SpecBuilder{
		Title:                   e.swaggerTitle,
		Description:             e.swaggerDesc,
		Version:                 e.swaggerVersion,
		TermsOfService:          e.swaggerTermsOfService,
		ContactName:             e.swaggerContactName,
		ContactURL:              e.swaggerContactURL,
		ContactEmail:            e.swaggerContactEmail,
		Servers:                 slices.Clone(e.swaggerServers),
		LicenseName:             e.swaggerLicenseName,
		LicenseURL:              e.swaggerLicenseURL,
		ExternalDocsDescription: e.swaggerExternalDocsDescription,
		ExternalDocsURL:         e.swaggerExternalDocsURL,
	}

	if e.swaggerEnabled || strings.TrimSpace(e.swaggerPath) != "" {
		builder.SwaggerPath = resolveSwaggerPath(e.swaggerPath)
	}

	if e.graphql != nil {
		builder.GraphQLPath = e.graphql.path
		builder.GraphQLPlayground = e.graphql.playground
	}
	if e.wsHandler != nil || strings.TrimSpace(e.wsPath) != "" {
		builder.WSPath = resolveWSPath(e.wsPath)
	}
	if e.sseBroker != nil || strings.TrimSpace(e.ssePath) != "" {
		builder.SSEPath = resolveSSEPath(e.ssePath)
	}
	builder.PprofEnabled = e.pprofEnabled
	builder.ExpvarEnabled = e.expvarEnabled

	return builder
}