Function ValidateServerJSON

internal/validators/validators.go:57–117

ValidateServerJSON performs exhaustive validation and returns all issues found opts specifies which types of validation to perform. ValidateSchema implies ValidateSchemaVersion. Empty schema is always checked and always produces an error when schema validation is performed.

(serverJSON *apiv0.ServerJSON, opts ValidationOptions)

// opts specifies which types of validation to perform. ValidateSchema implies ValidateSchemaVersion.
// Empty schema is always checked and always produces an error when schema validation is performed.
func ValidateServerJSON(serverJSON *apiv0.ServerJSON, opts ValidationOptions) *ValidationResult {
	result := &ValidationResult{Valid: true, Issues: []ValidationIssue{}}
	ctx := &ValidationContext{}

	// Schema validation (version check and/or full validation)
	if opts.ValidateSchemaVersion || opts.ValidateSchema {
		schemaResult := validateServerJSONSchema(serverJSON, opts.ValidateSchema, opts.NonCurrentSchemaPolicy)
		result.Merge(schemaResult)
	}

	// Semantic validation (only if requested)
	if !opts.ValidateSemantic {
		return result
	}

	// Validate server name exists and format
	if _, err := parseServerName(*serverJSON); err != nil {
		issue := NewValidationIssueFromError(
			ValidationIssueTypeSemantic,
			ctx.Field("name").String(),
			err,
			"invalid-server-name",
		)
		result.AddIssue(issue)
	}

	// Validate top-level server version is a specific version (not a range) & not "latest"
	versionResult := validateVersion(ctx.Field("version"), serverJSON.Version)
	result.Merge(versionResult)

	// Validate repository
	repoResult := validateRepository(ctx.Field("repository"), serverJSON.Repository)
	result.Merge(repoResult)

	// Validate website URL if provided
	websiteResult := validateWebsiteURL(ctx.Field("websiteUrl"), serverJSON.WebsiteURL)
	result.Merge(websiteResult)

	// Validate title if provided
	titleResult := validateTitle(ctx.Field("title"), serverJSON.Title)
	result.Merge(titleResult)

	// Validate icons if provided
	iconsResult := validateIcons(ctx.Field("icons"), serverJSON.Icons)
	result.Merge(iconsResult)

	// Validate all packages (basic field validation)
	// Detailed package validation (including registry checks) is done during publish
	for i, pkg := range serverJSON.Packages {
		pkgResult := validatePackageField(ctx.Field("packages").Index(i), &pkg)
		result.Merge(pkgResult)
	}

	// Validate all remotes
	for i, remote := range serverJSON.Remotes {
		remoteResult := validateRemoteTransport(ctx.Field("remotes").Index(i), &remote)
		result.Merge(remoteResult)
	}