suggest

type AddressResponse struct {
	Suggestions []*AddressSuggestion `json:"suggestions"`
}

type AddressSuggestion struct {
	Value             string         `json:"value"`
	UnrestrictedValue string         `json:"unrestricted_value"`
	Data              *model.Address `json:"data"`
}

type Api struct {
	Client Requester
}

type BankResponse struct {
	Suggestions []*BankSuggestion `json:"suggestions"`
}

type BankSuggestion struct {
	Value             string      `json:"value"`
	UnrestrictedValue string      `json:"unrestricted_value"`
	Data              *model.Bank `json:"data"`
}

type Bound struct {
	Value model.BoundValue `json:"value"`
}

type CountryResponse struct {
	Suggestions []*CountrySuggestion `json:"suggestions"`
}

type CountrySuggestion struct {
	Value string         `json:"value"`
	Data  *model.Country `json:"data"`
}

type EmailResponse struct {
	Suggestions []*EmailSuggestion `json:"suggestions"`
}

type EmailSuggestion struct {
	Value             string       `json:"value"`
	UnrestrictedValue string       `json:"unrestricted_value"`
	Data              *model.Email `json:"data"`
}

type FMSUnitResponse struct {
	Suggestions []*FMSUnitSuggestion `json:"suggestions"`
}

type FMSUnitSuggestion struct {
	Value             string         `json:"value"`
	UnrestrictedValue string         `json:"unrestricted_value"`
	Data              *model.FMSUnit `json:"data"`
}

type GeoIPResponse struct {
	Location *AddressSuggestion `json:"location"`
}

type NameOption func(params *NameParams)

type NameParams struct {
	Query  string   `json:"query"`
	Count  int      `json:"count"`
	Parts  []string `json:"parts"`
	Gender string   `json:"gender"`
}

type NameResponse struct {
	Suggestions []*NameSuggestion `json:"suggestions"`
}

type NameSuggestion struct {
	Value             string      `json:"value"`
	UnrestrictedValue string      `json:"unrestricted_value"`
	Data              *model.Name `json:"data"`
}

type PartyBranchType string

type PartyByIDParams struct {
	Query      string           `json:"query"`
	Count      *int             `json:"count,omitempty"`
	KPP        *string          `json:"kpp,omitempty"`
	Type       *PartyType       `json:"type,omitempty"`
	BranchType *PartyBranchType `json:"branch_type,omitempty"`
}

type PartyResponse struct {
	Suggestions []*PartySuggestion `json:"suggestions"`
}

type PartySuggestion struct {
	Value             string       `json:"value"`
	UnrestrictedValue string       `json:"unrestricted_value"`
	Data              *model.Party `json:"data"`
}

type PartyType string

type RequestParams struct {
	Query         string                   `json:"query"` // user input for suggestion
	Count         int                      `json:"count"` // ligmit for results
	Locations     []*RequestParamsLocation `json:"locations"`
	RestrictValue bool                     `json:"restrict_value"` // don't show restricts (region) on results

	FromBound *Bound `json:"from_bound"`
	ToBound   *Bound `json:"to_bound"`
}

type RequestParamsLocation struct {
	FiasID               string `json:"fias_id,omitempty"`
	KladrID              string `json:"kladr_id,omitempty"`
	Region               string `json:"region,omitempty"`
	RegionFiasID         string `json:"region_fias_id,omitempty"`
	RegionKladrID        string `json:"region_kladr_id,omitempty"`
	RegionTypeFull       string `json:"region_type_full,omitempty"`
	City                 string `json:"city,omitempty"`
	CityFiasID           string `json:"city_fias_id,omitempty"` // search only in this area
	CityKladrID          string `json:"city_kladr_id,omitempty"`
	CityTypeFull         string `json:"city_type_full,omitempty"`
	CityDistrictTypeFull string `json:"city_district_type_full,omitempty"`
	Settlement           string `json:"settlement,omitempty"`
	SettlementFiasID     string `json:"settlement_fias_id,omitempty"`
	SettlementKladrID    string `json:"settlement_kladr_id,omitempty"`
	SettlementTypeFull   string `json:"settlement_type_full,omitempty"`
	Street               string `json:"street,omitempty"`
	StreetFiasID         string `json:"street_fias_id,omitempty"`
	StreetKladrID        string `json:"street_kladr_id,omitempty"`
	StreetTypeFull       string `json:"street_type_full,omitempty"`
	AreaTypeFull         string `json:"area_type_full,omitempty"`
	Country              string `json:"country,omitempty"`
	CountryISOCode       string `json:"country_iso_code,omitempty"`
}

type Requester interface {
	// Get makes a GET API call. Assumes sending params in a request query string.
	Get(ctx context.Context, apiMethod string, params url.Values, result interface{}) error
	// Post makes a POST API call. Assumes sending json-encoded params in a request body.
	Post(ctx context.Context, apiMethod string, params, result interface{}) error
}