contracts

type CompiledSchema struct {
	RootPath      string            `json:"root_path"`
	LoadedDocs    []LoadedDocDigest `json:"loaded_docs"`    // all schema files referenced (sorted)
	HashSHA256    string            `json:"hash_sha256"`    // hash of CanonicalJSON
	CanonicalJSON []byte            `json:"canonical_json"` // deterministic JSON bytes
	JSON          map[string]any    `json:"json"`           // compiled tree
}

type LoadedDocDigest struct {
	Path   string `json:"path"`
	SHA256 string `json:"sha256"`
}

type Report struct {
	GeneratedAt      time.Time `json:"generated_at"`
	ValidatorVersion string    `json:"validator_version"`

	SchemaRootPath string `json:"schema_root_path,omitempty"`
	SchemaHash     string `json:"schema_hash,omitempty"`

	CheckedNodes int `json:"checked_nodes"`
	Errors       int `json:"errors"`
	Warnings     int `json:"warnings"`
	Infos        int `json:"infos"`

	Violations []Violation `json:"violations"`
}

type SchemaDoc struct {
	Path     string         `json:"path"`      // normalized rel path (slashes)
	LoadedAt time.Time      `json:"loaded_at"` // UTC
	SHA256   string         `json:"sha256"`    // hash of raw bytes
	JSON     map[string]any `json:"json"`      // parsed JSON object
}

type Severity string

type Store struct {
	// contains filtered or unexported fields
}

type StoreOptions struct {
	MaxFiles          int   // default 5000
	MaxFileBytes      int64 // default 2 MiB per schema
	MaxRefDepth       int   // default 64
	MaxRefs           int   // default 20000 (total resolved refs)
	MaxCanonicalBytes int64 // default 4 MiB compiled canonical JSON
	MaxCompiledNodes  int   // default 500000 nodes emitted during compilation
}

type VOptions struct {
	MaxDepth      int `json:"max_depth"`       // default 64
	MaxNodes      int `json:"max_nodes"`       // default 250000
	MaxIssues     int `json:"max_issues"`      // default 10000
	MaxRegexCache int `json:"max_regex_cache"` // default 128

	// big.Float precision for numeric comparisons (enum/const, min/max, etc.)
	NumberPrecision uint `json:"number_precision"` // default 512

	// If true, stop after first error.
	FailFast bool `json:"fail_fast"`

	// If true, warn when ignored keywords are present (format, $comment, title, description, etc.)
	WarnIgnoredKeywords bool `json:"warn_ignored_keywords"`
}

type Validator struct {
	// contains filtered or unexported fields
}

type Violation struct {
	Severity Severity `json:"severity"`
	Code     string   `json:"code"`
	Path     string   `json:"path,omitempty"`      // instance path: $.a.b[0]
	SchemaAt string   `json:"schema_at,omitempty"` // schema path: #/properties/x
	Message  string   `json:"message"`
}