parameter

type NamedParameter struct {
	Name      string
	Parameter Parameter
}

type Parameter interface {
	// GetType returns the type of the parameter.
	GetType() string

	// GetReferences returns a slice of all other parameters this parameter references.
	// this is need in the sorting phase to first deploy references, so that
	// they an be resolved during deployment phase.
	GetReferences() []ParameterReference

	// ResolveValue resolves the value of this parameter. the context offers some more information
	// on the current deployment and resolving phase. if the value cannot be resolved,
	// an error should be returned.
	ResolveValue(context ResolveContext) (interface{}, error)
}

type ParameterParser func(ParameterParserContext) (Parameter, error)

type ParameterParserContext struct {
	WorkingDirectory string
	Coordinate       coordinate.Coordinate
	Group            string
	Environment      string
	ParameterName    string
	Fs               afero.Fs
	Value            map[string]any
}

type ParameterParserError struct {
	// Location (coordinate) of the config the error happened in
	Location coordinate.Coordinate `json:"location"`
	// EnvironmentDetails of the environment the parsing of the parameter failed for
	EnvironmentDetails errors.EnvironmentDetails `json:"environmentDetails"`
	// ParameterName holds the name of the parameter triggering the error
	ParameterName string `json:"parameterName"`
	// Reason is a text describing what went wrong
	Reason string `json:"reason"`
}

type ParameterReference struct {
	Config   coordinate.Coordinate
	Property string
}

type ParameterResolveValueError struct {
	// Location (coordinate) of the config.Config in which a parameter failed to be resolved
	Location coordinate.Coordinate `json:"location"`
	// EnvironmentDetails of the environment the resolving failed for
	EnvironmentDetails errors.EnvironmentDetails `json:"environmentDetails"`
	// ParameterName is the name of the parameter that failed to be resolved
	ParameterName string `json:"parameterName"`
	// Reason describing what went wrong
	Reason string `json:"reason"`
}

type ParameterSerDe struct {
	Serializer   ParameterWriter
	Deserializer ParameterParser
}

type ParameterWriter func(ParameterWriterContext) (map[string]interface{}, error)

type ParameterWriterContext struct {
	// coordinates of the current config to parse
	Coordinate  coordinate.Coordinate
	Group       string
	Environment string
	// name of the current parameter to parse
	ParameterName string
	// current value to parse
	Parameter Parameter
}

type ParameterWriterError struct {
	// Location (coordinate) of the config the error happened in
	Location coordinate.Coordinate `json:"location"`
	// EnvironmentDetails of the environment the parsing of the parameter failed for
	EnvironmentDetails errors.EnvironmentDetails `json:"environmentDetails"`
	// name of the parameter triggering the error
	ParameterName string `json:"parameterName"`
	// text describing what went wrong
	Reason string `json:"reason"`
}

type Properties map[string]interface{}

type PropertyResolver interface {
	GetResolvedProperty(coordinate coordinate.Coordinate, propertyName string) (any, bool)
}

type ResolveContext struct {
	PropertyResolver PropertyResolver

	// coordinates of the current config
	ConfigCoordinate coordinate.Coordinate

	// group of the current config
	Group string

	// environment of the current config
	Environment string

	// name of the parameter to resolve
	ParameterName string

	// resolved values of the current config
	ResolvedParameterValues Properties
}