primitives

type AgeOverThresholdsArgs struct {
	// Input is the birthdate claim name (value must be ISO YYYY-MM-DD).
	Input string `yaml:"input" validate:"required" doc_example:"birthdate"`

	// Thresholds are the ages (in years) to expose. Each N produces
	// age_over_N and over_N_this_year (booleans). Every entry must be
	// positive.
	Thresholds []int `yaml:"thresholds" validate:"required,min=1,dive,gt=0" doc_example:"[13, 15, 18, 21, 65]"`
}

type Applier interface {
	Apply(claims map[string]any, now time.Time) (map[string]any, error)
}

type CountryAlpha2Args struct {
	Input  string `yaml:"input" validate:"required" doc_example:"nationalities"`
	Output string `yaml:"output,omitempty" doc_example:"nationalities"`
}

type CountryAlpha3Args struct {
	Input  string `yaml:"input" validate:"required" doc_example:"nationalities"`
	Output string `yaml:"output,omitempty" doc_example:"nationalities"`
}

type Derivation struct {
	// AgeOverThresholds emits two boolean claims per configured threshold
	// N from an ISO YYYY-MM-DD birthdate: age_over_N (completed years at
	// `now`) and over_N_this_year (reaches N at some point in `now`'s
	// calendar year).
	AgeOverThresholds *AgeOverThresholdsArgs `yaml:"age_over_thresholds,omitempty"`

	// Lowercase applies strings.ToLower elementwise.
	Lowercase *LowercaseArgs `yaml:"lowercase,omitempty"`

	// Uppercase applies strings.ToUpper elementwise.
	Uppercase *UppercaseArgs `yaml:"uppercase,omitempty"`

	// Trim applies strings.TrimSpace elementwise.
	Trim *TrimArgs `yaml:"trim,omitempty"`

	// CountryAlpha2 maps country names or alpha-3 codes to ISO 3166-1
	// alpha-2 codes elementwise. Unknown inputs pass through unchanged.
	CountryAlpha2 *CountryAlpha2Args `yaml:"country_alpha2,omitempty"`

	// CountryAlpha3 maps country names or alpha-2 codes to ISO 3166-1
	// alpha-3 codes elementwise. Unknown inputs pass through unchanged.
	CountryAlpha3 *CountryAlpha3Args `yaml:"country_alpha3,omitempty"`

	// YYYYMMDDToISO converts a SCHAC schacDateOfBirth ("YYYYMMDD") claim to
	// ISO full-date ("YYYY-MM-DD"). Impossible calendar dates are an error.
	YYYYMMDDToISO *YYYYMMDDToISOArgs `yaml:"yyyymmdd_to_iso,omitempty"`

	// SWAMIDHighestAssuranceLevel reduces a multi-valued eduPersonAssurance
	// claim to the strongest recognised SWAMID Assurance Framework URI.
	SWAMIDHighestAssuranceLevel *SWAMIDHighestAssuranceLevelArgs `yaml:"swamid_highest_assurance_level,omitempty"`
}

type LowercaseArgs struct {
	// Input is the source claim name. Supports dot-notation claim paths
	// (e.g. "identity.email") so this primitive can target the same nested
	// claims that AttributeMapper materialises.
	Input string `yaml:"input" validate:"required" doc_example:"email"`

	// Output is the target claim name. Defaults to Input (in-place).
	// Supports dot-notation claim paths.
	Output string `yaml:"output,omitempty" doc_example:"email"`
}

type SWAMIDHighestAssuranceLevelArgs struct {
	// Input is the source claim (string or list of strings).
	Input string `yaml:"input" validate:"required" doc_example:"assurance_level"`

	// Output is the target claim. Defaults to Input (in-place).
	Output string `yaml:"output,omitempty" doc_example:"assurance_level"`
}

type TrimArgs struct {
	Input  string `yaml:"input" validate:"required" doc_example:"name"`
	Output string `yaml:"output,omitempty" doc_example:"name"`
}

type UppercaseArgs struct {
	Input  string `yaml:"input" validate:"required" doc_example:"country"`
	Output string `yaml:"output,omitempty" doc_example:"country"`
}

type YYYYMMDDToISOArgs struct {
	// Input is the source claim name (must be a non-empty YYYYMMDD string).
	Input string `yaml:"input" validate:"required" doc_example:"birthdate"`

	// Output is the target claim name. Defaults to Input.
	Output string `yaml:"output,omitempty" doc_example:"birthdate"`
}