Add public API for property search with filtering, sorting, and pagination

Implements GET /api_public/v1/properties endpoint with:
- Advanced search filtering (price, bedrooms, bathrooms, property type)
- Pagination and limit support
- Sorting by price, date, and bedroom count
- Map markers generation for frontend mapping
- Grouped results by sale/rental type for landing pages
- JSON-LD schema generation for SEO
- Image variant support with CDN handling
- Similar property recommendations by city/region
- Comprehensive test coverage

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

Author: etewiah

app/controllers/api_public/v1/properties_controller.rb

@@ -118,14 +118,16 @@ def apply_sorting(scope, sort_param)
         return scope if sort_param.blank?
 
         case sort_param
-        when 'price-asc', 'price_asc'
+        when 'price-asc', 'price_asc', 'price_low_high'
           scope.order(price_sale_current_cents: :asc, price_rental_monthly_current_cents: :asc)
-        when 'price-desc', 'price_desc'
+        when 'price-desc', 'price_desc', 'price_high_low'
           scope.order(price_sale_current_cents: :desc, price_rental_monthly_current_cents: :desc)
         when 'newest', 'date-desc', 'date_desc'
           scope.order(created_at: :desc)
         when 'oldest', 'date-asc', 'date_asc'
           scope.order(created_at: :asc)
+        when 'beds_high_low'
+          scope.order(count_bedrooms: :desc)
         else
           scope
         end
@@ -348,6 +350,8 @@ def property_summary_json(property)
           count_bedrooms: property.count_bedrooms,
           count_bathrooms: property.count_bathrooms,
           count_garages: property.count_garages,
+          constructed_area: property.respond_to?(:constructed_area) ? property.constructed_area : nil,
+          area_unit: property.respond_to?(:area_unit) ? property.area_unit : nil,
           highlighted: property.highlighted,
           for_sale: property.for_sale?,
           for_rent: property.for_rent?,

spec/requests/api_public/v1/properties_spec.rb

@@ -124,6 +124,56 @@
       expect(ordered_ids.first).to eq(priciest_asset.id)
     end
 
+    it "supports sort_by price_low_high (alias for price_asc)" do
+      host! 'properties-test.example.com'
+      get "/api_public/v1/properties", params: { sale_or_rental: "sale", sort_by: "price_low_high" }
+      json = response.parsed_body
+      prices = json["data"].map { |property| property["price_sale_current_cents"] }
+      expect(prices).to eq(prices.sort)
+    end
+
+    it "supports sort_by price_high_low (alias for price_desc)" do
+      host! 'properties-test.example.com'
+      get "/api_public/v1/properties", params: { sale_or_rental: "sale", sort_by: "price_high_low" }
+      json = response.parsed_body
+      prices = json["data"].map { |property| property["price_sale_current_cents"] }
+      expect(prices).to eq(prices.sort.reverse)
+    end
+
+    context "with varying bedroom counts" do
+      let!(:few_bed_asset) { FactoryBot.create(:pwb_realty_asset, website: website, count_bedrooms: 1) }
+      let!(:few_bed_listing) { FactoryBot.create(:pwb_sale_listing, :visible, realty_asset: few_bed_asset) }
+      let!(:many_bed_asset) { FactoryBot.create(:pwb_realty_asset, website: website, count_bedrooms: 5) }
+      let!(:many_bed_listing) { FactoryBot.create(:pwb_sale_listing, :visible, realty_asset: many_bed_asset) }
+
+      before { Pwb::ListedProperty.refresh(concurrently: false) }
+
+      it "supports sort_by beds_high_low" do
+        host! 'properties-test.example.com'
+        get "/api_public/v1/properties", params: { sale_or_rental: "sale", sort_by: "beds_high_low" }
+        json = response.parsed_body
+        bedrooms = json["data"].map { |property| property["count_bedrooms"] }
+        expect(bedrooms).to eq(bedrooms.sort.reverse)
+      end
+    end
+
+    it "includes constructed_area in property response" do
+      host! 'properties-test.example.com'
+      get "/api_public/v1/properties", params: { sale_or_rental: "sale" }
+      json = response.parsed_body
+      property = json["data"].first
+      expect(property).to have_key("constructed_area")
+    end
+
+    it "includes area_unit in property response" do
+      host! 'properties-test.example.com'
+      get "/api_public/v1/properties", params: { sale_or_rental: "sale" }
+      json = response.parsed_body
+      property = json["data"].first
+      expect(property).to have_key("area_unit")
+      expect(property["area_unit"]).to be_in(%w[sqmt sqft])
+    end
+
     context "with group_by=sale_or_rental" do
       let!(:rental_asset) { FactoryBot.create(:pwb_realty_asset, website: website) }
       let!(:rental_listing) { FactoryBot.create(:pwb_rental_listing, :visible, realty_asset: rental_asset) }