validators

type DetectionConfig struct {
	// MinScore is the minimum total detection score for this provider to be
	// considered a match. The default detector scoring produces scores well
	// over 100 for a confident match; values in the 50-150 range are typical
	// tuning points.
	MinScore int `yaml:"min_score,omitempty"`
}

type DetectionResult struct {
	Provider    string
	Suggestions []string
	Message     string
	Entropy     float64
	// Score is the detection confidence score for the chosen provider. Higher
	// is more confident; providers without an entry get a default of 0.
	Score int
}

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

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

type EndpointConfig struct {
	URL     string            `yaml:"url"`
	Region  string            `yaml:"region,omitempty"`
	Headers map[string]string `yaml:"headers,omitempty"`
}

type ErrorCheck struct {
	JSONPath string `yaml:"json_path,omitempty"`
}

type FactoryOptions struct {
	// PersistentCachePath enables the cross-run positive cache when non-empty.
	// When empty, the factory uses only the in-memory ValidationCache.
	PersistentCachePath string
	// PersistentCacheTTL is the freshness window for persistent entries.
	// Zero means use the default (5 minutes).
	PersistentCacheTTL time.Duration
	// DisableCache disables both layers; validators will always hit the
	// network. Used when the user passes --no-cache.
	DisableCache bool
}

type FailureWhen struct {
	BodyRegex     string `yaml:"body_regex,omitempty"`
	BodyJSONPath  string `yaml:"body_jsonpath,omitempty"`
	JSONPathValue string `yaml:"jsonpath_value,omitempty"`
}

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

type LintIssue struct {
	Severity LintSeverity `json:"severity"`
	Provider string       `json:"provider,omitempty"`
	Field    string       `json:"field,omitempty"`
	Message  string       `json:"message"`
}

type LintSeverity string

type MetadataConfig struct {
	URL               string            `yaml:"url"`
	Method            string            `yaml:"method"`
	Auth              string            `yaml:"auth"`
	Headers           map[string]string `yaml:"headers"`
	BalancePath       string            `yaml:"balance_path"`
	Extract           string            `yaml:"extract"`
	StoreAs           string            `yaml:"store_as"`
	RegexExtract      string            `yaml:"regex_extract"`
	RegexExtractMatch int               `yaml:"regex_extract_match"`
}

type MetadataFromValidation struct {
	BalancePath         string `yaml:"balance_path"`
	BalanceSubtractPath string `yaml:"balance_subtract_path"`
	NamePath            string `yaml:"name_path"`
	NameFallbackPath    string `yaml:"name_fallback_path"`
	EmailPath           string `yaml:"email_path"`
	QuotaPath           string `yaml:"quota_path"`
	CreditsPath         string `yaml:"credits_path"`
	VIPLevelPath        string `yaml:"vip_level_path"`
	TeamNamePath        string `yaml:"team_name_path"`
	UsernamePath        string `yaml:"username_path"`
	RegexExtract        string `yaml:"regex_extract"`
	RegexExtractMatch   int    `yaml:"regex_extract_match"`
}

type PatternEntry struct {
	Regex    *regexp.Regexp
	Provider string
	Category string
}

type PrefixEntry struct {
	Prefix   string
	Provider string
	Category string
}

type PrefixIndex map[string][]PrefixEntry

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

type ProviderConfig struct {
	Name                   string                  `yaml:"name"`
	Category               string                  `yaml:"category"`
	KeyPrefixes            []string                `yaml:"key_prefixes"`
	KeyPatterns            []string                `yaml:"key_patterns"`
	SyntaxCheck            string                  `yaml:"syntax_check,omitempty"`
	CanaryPatterns         []string                `yaml:"canary_patterns,omitempty"`
	Validation             ValidationConfig        `yaml:"validation"`
	Metadata               []MetadataConfig        `yaml:"metadata,omitempty"`
	MetadataFromValidation *MetadataFromValidation `yaml:"metadata_from_validation,omitempty"`
	// Detection tunes how aggressively this provider matches unknown keys.
	// MinScore, when > 0, requires the detector to score at least this high
	// before reporting this provider as a match.
	Detection *DetectionConfig `yaml:"detection,omitempty"`
	// CacheTTLSeconds overrides the global positive-cache TTL for entries
	// produced by this provider. Zero means "use the global default".
	CacheTTLSeconds int `yaml:"cache_ttl_seconds,omitempty"`
	// RetryPolicy overrides the global retry budget. MaxAttempts is total
	// tries (1 = no retries). Backoff is exponential with cap.
	RetryPolicy *RetryPolicy `yaml:"retry_policy,omitempty"`
	// RegionalEndpoints lists alternative validation URLs to race against
	// the primary validation.url. The first 200 wins and the endpoint that
	// succeeded is recorded on the result.
	RegionalEndpoints []EndpointConfig `yaml:"regional_endpoints,omitempty"`
	IsCustom          bool             `yaml:"-"`
}

type ProviderInfo struct {
	Name        string
	Category    string
	KeyPrefixes []string
}

type ResponseMatch struct {
	BodyRegex      string `yaml:"body_regex,omitempty"`
	BodyJSONPath   string `yaml:"body_jsonpath,omitempty"`
	JSONPathValue  string `yaml:"jsonpath_value,omitempty"`
	HeaderContains string `yaml:"header_contains,omitempty"`
}

type RetryPolicy struct {
	MaxAttempts      int   `yaml:"max_attempts"`
	OnStatus         []int `yaml:"on_status,omitempty"`
	InitialBackoffMs int   `yaml:"initial_backoff_ms,omitempty"`
	MaxBackoffMs     int   `yaml:"max_backoff_ms,omitempty"`
}

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

type ValidationConfig struct {
	Method         string            `yaml:"method"`
	URL            string            `yaml:"url"`
	Auth           string            `yaml:"auth"`
	Headers        map[string]string `yaml:"headers"`
	Body           string            `yaml:"body"`
	Endpoints      []EndpointConfig  `yaml:"endpoints,omitempty"`
	ErrorCheck     *ErrorCheck       `yaml:"error_check,omitempty"`
	ExpectedStatus []int             `yaml:"expected_status,omitempty"`
	ResponseMatch  *ResponseMatch    `yaml:"response_match,omitempty"`
	RetryOnStatus  []int             `yaml:"retry_on_status,omitempty"`
	FailureWhen    *FailureWhen      `yaml:"failure_when,omitempty"`
}

type Validator interface {
	Name() string
	KeyPatterns() []string
	Validate(ctx context.Context, apiKey string) (*models.ValidationResult, error)
	SetSkipMetadata(bool)
	SetCanaryCheck(bool)
	FetchMetadata(ctx context.Context, apiKey string, result *models.ValidationResult)
}

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