Module: Opendoor::PartnerSdk::AnswerKeyMapping

Defined in:
lib/opendoor/partner_sdk/answer_key_mapping.rb

Constant Summary collapse

DOT_TO_CAMEL = 
{
  "home.bedrooms" => "homeBedrooms",
  "home.bathrooms.full" => "homeBathroomsFull",
  "home.bathrooms.half" => "homeBathroomsPartial",
  "home.above_grade_sq_ft" => "homeAboveGradeSqFt",
  "home.dwelling_type" => "homeDwellingType",
  "home.year_built" => "homeYearBuilt",
  "home.exterior_stories" => "homeExteriorStories",
  "home.entry_type" => "homeEntryType",
  "home.covered_parking_type" => "homeCoveredParkingType",
  "home.garage_spaces" => "homeGarageSpaces",
  "home.carport_spaces" => "homeCarportSpaces",
  "home.pool_type" => "homePoolType",
  "home.has_basement" => "homeHasBasement",
  "home.basement_finished_sq_ft" => "homeBasementFinishedSqFt",
  "home.basement_unfinished_sq_ft" => "homeBasementUnfinishedSqFt",
  "home.kitchen_counter_type" => "homeKitchenCounterType",
  "home.hoa" => "homeHoa",
  "home.hoa_fees" => "homeHoaFees",
  "home.has_upgrades" => "homeHasUpgrades",
  "home.kitchen_seller_score" => "homeKitchenCondition",
  "home.bathroom_seller_score" => "homeBathroomCondition",
  "home.living_room_seller_score" => "homeLivingRoomCondition",
  "home.exterior_seller_score" => "homeExteriorCondition",
  "home.eligibility_criteria.leased_solar_panels" => "homeEligibilityCriteriaLeasedSolarPanels",
  "home.eligibility_criteria.known_foundation_issues" => "homeEligibilityCriteriaKnownFoundationIssues",
  "home.eligibility_criteria.fire_damage" => "homeEligibilityCriteriaFireDamage",
  "home.eligibility_criteria.well_water" => "homeEligibilityCriteriaWellWater",
  "home.eligibility_criteria.septic" => "homeEligibilityCriteriaSeptic",
  "home.eligibility_criteria.asbestos_siding" => "homeEligibilityCriteriaAsbestosSiding",
  "home.eligibility_criteria.livestock" => "homeEligibilityCriteriaLivestock",
  "home.eligibility_criteria.mobile_manufactured_home" => "homeEligibilityCriteriaMobileManufacturedHome",
  "seller.full_name" => "sellerFullName",
  "seller.email" => "sellerEmail",
  "seller.phone_number" => "sellerPhoneNumber",
  "seller.sms_opt_in" => "sellerSmsOptIn",
  "seller.relation_to_owner" => "sellerRelationToOwner",
  "seller.relation_to_owner.other" => "sellerRelationToOwnerOther",
  "seller.sale_timeline" => "sellerSaleTimeline",
  "seller.working_with_home_builder" => "sellerWorkingWithHomeBuilder",
  "seller.home_builder" => "sellerHomeBuilder",
  "seller.home_builder_email" => "sellerHomeBuilderEmail",
  "seller.home_builder_community" => "sellerHomeBuilderCommunity"
}.freeze
SKIP_KEYS = 
["offerId"].freeze
NUMERIC_KEYS = 
[
  "home.bedrooms",
  "home.bathrooms.full",
  "home.bathrooms.half",
  "home.above_grade_sq_ft",
  "home.exterior_stories",
  "home.year_built",
  "home.garage_spaces",
  "home.carport_spaces",
  "home.hoa_fees",
  "home.basement_finished_sq_ft",
  "home.basement_unfinished_sq_ft"
].freeze
EXPERIMENTAL_KEYS = 
[
  "home.mortgage_balance",
  "home.lot_sq_ft",
  "home.upper_level_sq_ft",
  "home.basement_sq_ft"
].freeze
POOL_TYPE_NORMALIZE = 
{
  "none" => "no_pool",
  "community" => "community_pool"
}.freeze

Class Method Summary collapse

Class Method Details

.coerce_mapped_value(key, value) ⇒ Object 



151
152
153
154
155
156
157
158
159
160
161
162
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 151

def coerce_mapped_value(key, value)
  return true if value == "yes"
  return false if value == "no"
  return true if value == "true"
  return false if value == "false"

  if value.is_a?(String) && !value.empty? && NUMERIC_KEYS.include?(key) && numeric_string?(value)
    return value.include?(".") ? value.to_f : value.to_i
  end

  value
end

.experimental_key?(key) ⇒ Boolean

Returns:

  • (Boolean) 


170
171
172
173
174
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 170

def experimental_key?(key)
  key.start_with?("home.condition.") ||
    key.start_with?("home.features.") ||
    EXPERIMENTAL_KEYS.include?(key)
end

.map_eligibility_criteria(offer_input, value) ⇒ Object 



130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 130

def map_eligibility_criteria(offer_input, value)
  values = value.is_a?(Array) ? value : []
  criteria_map = {
    "leased_solar_panels" => "homeEligibilityCriteriaLeasedSolarPanels",
    "known_foundation_issues" => "homeEligibilityCriteriaKnownFoundationIssues",
    "fire_damage" => "homeEligibilityCriteriaFireDamage",
    "well_water" => "homeEligibilityCriteriaWellWater",
    "septic" => "homeEligibilityCriteriaSeptic",
    "asbestos_siding" => "homeEligibilityCriteriaAsbestosSiding",
    "livestock" => "homeEligibilityCriteriaLivestock",
    "mobile_manufactured_home" => "homeEligibilityCriteriaMobileManufacturedHome",
    "unique_ownership_structure" => "homeEligibilityCriteriaUniqueOwnershipStructure",
    "below_market_rate_ownership" => "homeEligibilityCriteriaBelowMarketRateOwnership",
    "rent_controlled_tenant_occupied" => "homeEligibilityCriteriaRentControlledTenantOccupied"
  }

  criteria_map.each do |criteria_value, graphql_field|
    offer_input[graphql_field] = values.include?(criteria_value)
  end
end

.normalize_pool_type(key, value) ⇒ Object 



123
124
125
126
127
128
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 123

def normalize_pool_type(key, value)
  return value unless key == "home.pool_type"
  return value unless value.is_a?(String)

  POOL_TYPE_NORMALIZE.fetch(value, value)
end

.numeric_string?(value) ⇒ Boolean

Returns:

  • (Boolean) 


164
165
166
167
168
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 164

def numeric_string?(value)
  !!Float(value)
rescue ArgumentError, TypeError
  false
end

.to_experimental_entry(key, value) ⇒ Object 



176
177
178
179
180
181
182
183
184
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 176

def to_experimental_entry(key, value)
  if value.is_a?(Array)
    { "questionKey" => key, "stringValues" => value }
  elsif value.is_a?(Numeric)
    { "questionKey" => key, "doubleValue" => value }
  elsif value == true || value == false
    { "questionKey" => key, "stringValues" => [value ? "true" : "false"] }
  end
end

.transform_answers_to_offer_input(answers) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 79

def transform_answers_to_offer_input(answers)
  offer_input = {}
  experimental = []

  answers.each do |raw_key, raw_value|
    key = raw_key.to_s
    next if raw_value.nil? || SKIP_KEYS.include?(key)

    value = normalize_pool_type(key, raw_value)

    if key == "home.hoa_type"
      values = value.is_a?(Array) ? value : [value]
      next if values.length == 1 && values.first == "none"

      offer_input["homeHoaTypeAgeRestrictedCommunity"] = values.include?("age_restricted_community")
      offer_input["homeHoaTypeGatedCommunity"] = values.include?("gated_community")
      next
    end

    if key == "home.eligibility_criteria"
      map_eligibility_criteria(offer_input, value)
      next
    end

    if key == "home.hoa_type.guarded_gated_community"
      offer_input["homeHoaTypeGuardedGatedCommunity"] = value == "has_guard"
      next
    end

    camel_key = DOT_TO_CAMEL[key]
    if camel_key
      offer_input[camel_key] = coerce_mapped_value(key, value)
    elsif experimental_key?(key)
      experimental_value = to_experimental_entry(key, value)
      experimental << experimental_value if experimental_value
    else
      offer_input[key] = value
    end
  end

  offer_input["experimental"] = experimental unless experimental.empty?
  offer_input
end