Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

utils

package

Go to main page

Versions in this module

v0

v0.12.0

Jul 16, 2026

Changes in this version

+ func FetchOpenAPISpecFromURL(ctx context.Context, rawURL string, maxBytes int64) (string, error)

v0.11.2

Jul 10, 2026

v0.11.1

Jul 8, 2026

Changes in this version

+ const ClientName

+ const ClientVersion

+ const GatewayArtifactsZipEntry

+ const ImportStatusDeployed

+ const ImportStatusFailed

+ const ImportStatusPending

+ const ImportStatusUndeployed

+ const JsonRpcVersion

+ const McpSessionHeader

+ const MethodInitialize

+ const MethodInitialized

+ const MethodPromptsList

+ const MethodResourcesList

+ const MethodToolsList

+ const ProtocolVersion

+ func APIKeyETag(artifactUUID, name string, updatedAt time.Time) string

+ func ArtifactImportRank(kind string) int

+ func BoolPtr(value bool) *bool

+ func CheckURLReachability(rawURL string, timeout time.Duration) error

+ func CreateAPIYamlZip(apiYamlMap map[string]string) ([]byte, error)

+ func CreateBatchDeploymentTarGz(deploymentContentMap map[string]*model.DeploymentContent) ([]byte, error)

+ func CreateLLMProviderYamlZip(providerYamlMap map[string]string) ([]byte, error)

+ func CreateLLMProxyYamlZip(proxyYamlMap map[string]string) ([]byte, error)

+ func CreateMCPProxyYamlZip(proxyYamlMap map[string]string) ([]byte, error)

+ func CreateWebBrokerAPIYamlZip(apiYamlMap map[string]string) ([]byte, error)

+ func CreateWebSubAPIYamlZip(apiYamlMap map[string]string) ([]byte, error)

+ func DecodeSpec(spec map[string]interface{}, out interface{}) error

+ func DecryptSubscriptionToken(key []byte, ciphertextB64 string) (string, error)

+ func DefaultStringPtr(v *string, def string) string

+ func DeriveEncryptionKey(keyStr string) ([]byte, error)

+ func EncryptSubscriptionToken(key []byte, plaintext string) (string, error)

+ func FetchMCPServerInfo(url string, headerName string, headerValue string) (*api.MCPServerInfoFetchResponse, error)

+ func FormatValidationError(err error) string

+ func GenerateAPIKey() (string, error)

+ func GenerateDeterministicUUIDv7(entityID string, ts time.Time) string

+ func GenerateHandle(source string, existsCheck func(string) bool) (string, error)

+ func GenerateUUID() (string, error)

+ func GetErrorResponse(err error) (int, interface{})

+ func ImportDisplayName(cfg dto.ArtifactImportConfig) string

+ func ImportHandle(cfg dto.ArtifactImportConfig) string

+ func ImportVersion(cfg dto.ArtifactImportConfig) string

+ func IsNewerDeployment(incoming, current *time.Time) bool

+ func LoadLLMProviderTemplatesFromDirectory(dirPath string) ([]*model.LLMProviderTemplate, error)

+ func MapDeploymentStatus(status string) model.DeploymentStatus

+ func MapPtrIfNotEmpty(m map[string]interface{}) *map[string]interface

+ func MapValueOrEmpty(m *map[string]interface{}) map[string]interface

+ func NewValidationErrorResponse(w http.ResponseWriter, err error)

+ func NormalizeAndValidateLLMResourcePath(resource string) (string, bool)

+ func OpenAPIUUIDToString(id openapi_types.UUID) string

+ func ParseGatewayArtifactsRequest(r *http.Request) ([]dto.ImportGatewayArtifactRequest, error)

+ func ParseOpenAPIUUID(id string) (*openapi_types.UUID, error)

+ func ParseOpenAPIUUIDOrZero(id string) openapi_types.UUID

+ func ParseOptionalOpenAPIUUID(id *string) *openapi_types.UUID

+ func ResolveImportProject(md dto.ArtifactImportMetadata) string

+ func SpecString(spec map[string]interface{}, key string) string

+ func StringPtrIfNotEmpty(value string) *string

+ func StringPtrValue(ptr *string) string

+ func TimePtr(t time.Time) *time.Time

+ func TimePtrIfNotZero(value time.Time) *time.Time

+ func UnzipGatewayArtifacts(zipBytes []byte) ([]dto.ImportGatewayArtifactRequest, error)

+ func ValidateHandle(handle string) error

+ func ValidateHandleImmutable(pathHandle string, bodyHandle *string) error

+ func ValidateHandleImmutableRequired(pathHandle, bodyHandle string) error

+ func ValidateURL(rawURL string) error

+ func ValueOrEmpty(s *string) string

+ type APIUtil struct

+ func (u *APIUtil) APIYAMLDataToRESTAPI(yamlData *dto.APIYAMLData) *api.RESTAPI

+ func (u *APIUtil) BuildAPIDeploymentYAML(apiModel *model.API) (*dto.APIDeploymentYAML, error)

+ func (u *APIUtil) ChannelAPIToModel(channel *api.Channel) *model.Channel

+ func (u *APIUtil) ChannelModelToAPI(modelCh *model.Channel) *api.Channel

+ func (u *APIUtil) ChannelRequestAPIToModel(req *api.ChannelRequest) *model.ChannelRequest

+ func (u *APIUtil) ChannelRequestModelToAPI(modelReq *model.ChannelRequest) *api.ChannelRequest

+ func (u *APIUtil) ChannelsAPIToModel(channels *[]api.Channel) []model.Channel

+ func (u *APIUtil) ChannelsModelToAPI(models []model.Channel) *[]api.Channel

+ func (u *APIUtil) GenerateAPIDeploymentYAML(apiModel *model.API) (string, error)

+ func (u *APIUtil) ModelToRESTAPI(modelAPI *model.API, projectHandle string) (*api.RESTAPI, error)

+ func (u *APIUtil) OperationAPIToModel(operation *api.Operation) *model.Operation

+ func (u *APIUtil) OperationModelToAPI(modelOp *model.Operation) *api.Operation

+ func (u *APIUtil) OperationRequestAPIToModel(req *api.OperationRequest) *model.OperationRequest

+ func (u *APIUtil) OperationRequestModelToAPI(modelReq *model.OperationRequest) *api.OperationRequest

+ func (u *APIUtil) OperationsAPIToModel(operations *[]api.Operation) []model.Operation

+ func (u *APIUtil) OperationsModelToAPI(models []model.Operation) *[]api.Operation

+ func (u *APIUtil) PoliciesAPIToModel(policies *[]api.Policy) []model.Policy

+ func (u *APIUtil) PoliciesDTOToModel(dtos []dto.Policy) []model.Policy

+ func (u *APIUtil) PoliciesModelToAPI(models []model.Policy) *[]api.Policy

+ func (u *APIUtil) PoliciesModelToDTO(models []model.Policy) []dto.Policy

+ func (u *APIUtil) PolicyAPIToModel(policy *api.Policy) *model.Policy

+ func (u *APIUtil) PolicyDTOToModel(dto *dto.Policy) *model.Policy

+ func (u *APIUtil) PolicyModelToAPI(modelPolicy model.Policy) *api.Policy

+ func (u *APIUtil) PolicyModelToDTO(model *model.Policy) *dto.Policy

+ func (u *APIUtil) RESTAPIToModel(restAPI *api.RESTAPI, orgID string) *model.API

+ func (u *APIUtil) UpstreamConfigAPIToModel(upstream *api.Upstream) *model.UpstreamConfig

+ func (u *APIUtil) UpstreamConfigModelToAPI(modelUpstream *model.UpstreamConfig) api.Upstream

+ func (u *APIUtil) ValidateAPIDefinitionConsistency(openAPIContent []byte, wso2Artifact *dto.APIDeploymentYAML) error

+ func (u *APIUtil) ValidateWSO2Artifact(artifact *dto.APIDeploymentYAML) error

+ type ErrorResponse struct

+ Code int

+ Description string

+ Message string

+ func NewErrorResponse(code int, message string, description ...string) ErrorResponse

+ type InitializeResult struct

+ Error *JsonRPCError

+ Result struct{ ... }

+ type JsonRPCError struct

+ Code int

+ Message string

+ type JsonRPCRequest struct

+ ID int

+ JSONRPC string

+ Method string

+ Params any

+ type MCPUtils struct

+ func (u *MCPUtils) BuildMCPDeploymentYAML(proxy *model.MCPProxy) (*model.MCPProxyDeploymentYAML, error)

+ func (u *MCPUtils) GenerateMCPDeploymentYAML(proxy *model.MCPProxy) (string, error)

+ type MetadataWriteMode int

+ const SkipWorkingCopy

+ const WriteFullMetadata

+ const WriteGatewaySpecificOnly

+ func DecideMetadataWrite(isNew bool, origin string, currentDeployedAt, incomingDeployedAt *time.Time) MetadataWriteMode

+ type PromptsResult struct

+ Error *JsonRPCError

+ Result struct{ ... }

+ type ResourcesResult struct

+ Error *JsonRPCError

+ Result struct{ ... }

+ type ToolsResult struct

+ Error *JsonRPCError

+ Result struct{ ... }

v0.11.0-cloud1

Jul 8, 2026