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",
  "seller.signed_listing_agreement" => "signedListingAgreement",
  "seller.listing_agent.full_name" => "listingAgentFullName",
  "seller.listing_agent.email" => "listingAgentEmail",
  "seller.listing_agent.phone_number" => "listingAgentPhoneNumber"
}.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 



155
156
157
158
159
160
161
162
163
164
165
166
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 155

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) 


174
175
176
177
178
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 174

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 



134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 134

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 



127
128
129
130
131
132
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 127

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) 


168
169
170
171
172
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 168

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

.to_experimental_entry(key, value) ⇒ Object 



180
181
182
183
184
185
186
187
188
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 180

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 



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
122
123
124
125
 
# File 'lib/opendoor/partner_sdk/answer_key_mapping.rb', line 83

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