feat(api): Complete all outstanding API parity tasks

SearchConfigController (NEW):
- GET /api_public/v1/search/config
- Returns property types with counts, price options, features
- Supports bedrooms, bathrooms, sort options

PropertiesController (ENHANCED):
- Added map_markers to search response with lat/lng/title/price
- Added pagination meta (total, page, per_page, total_pages)
- Added ?highlighted=true filter for featured properties
- Added ?limit param for limiting results

ListedProperty.as_json (ENHANCED):
- Added extras, features, highlighted fields
- Added primary_image_url for convenience

ContactController (NEW):
- POST /api_public/v1/contact for general enquiries
- Separate from property-specific /enquiries endpoint

Routes:
- Added /search/config and /contact routes

Author: etewiah

app/controllers/api_public/v1/contact_controller.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module ApiPublic
+  module V1
+    # ContactController handles general (non-property) contact form submissions
+    # For property-specific enquiries, use EnquiriesController
+    class ContactController < BaseController
+      # POST /api_public/v1/contact
+      def create
+        locale = params[:locale] || I18n.default_locale
+        I18n.locale = locale
+        website = Pwb::Current.website
+
+        # Find or create contact
+        contact = website.contacts.find_or_initialize_by(primary_email: contact_params[:email])
+        contact.assign_attributes(
+          first_name: contact_params[:name],
+          primary_phone_number: contact_params[:phone]
+        )
+
+        # Create the message
+        title = contact_params[:subject].presence || I18n.t("contact.general_enquiry", default: "General Enquiry")
+        message = Pwb::Message.new(
+          website: website,
+          title: title,
+          content: contact_params[:message],
+          locale: locale,
+          url: request.referer,
+          host: request.host,
+          origin_ip: request.ip,
+          origin_email: contact_params[:email],
+          user_agent: request.user_agent,
+          delivery_email: website.agency&.email_for_contact_form.presence || website.agency&.email_primary
+        )
+
+        # Validate and save
+        unless message.valid? && contact.valid?
+          errors = contact.errors.full_messages + message.errors.full_messages
+          return render json: { success: false, errors: errors }, status: :unprocessable_entity
+        end
+
+        contact.save!
+        message.contact = contact
+        message.save!
+
+        # Send email notification asynchronously
+        delivery_email = website.agency&.email_for_contact_form.presence || website.agency&.email_primary
+        if delivery_email.present?
+          begin
+            ContactMailer.general_enquiry(contact, message).deliver_later if defined?(ContactMailer) && ContactMailer.respond_to?(:general_enquiry)
+          rescue StandardError => e
+            Rails.logger.warn("[Contact API] Email delivery failed: #{e.message}")
+          end
+        end
+
+        render json: {
+          success: true,
+          message: I18n.t("contact.success", default: "Thank you for your message. We'll get back to you soon."),
+          data: {
+            contact_id: contact.id,
+            message_id: message.id
+          }
+        }, status: :created
+
+      rescue StandardError => e
+        Rails.logger.error("[API Contact] Error: #{e.message}")
+        Rails.logger.error(e.backtrace.first(5).join("\n"))
+        render json: {
+          success: false,
+          errors: [I18n.t("contact.error", default: "An error occurred. Please try again.")]
+        }, status: :internal_server_error
+      end
+
+      private
+
+      def contact_params
+        params.require(:contact).permit(:name, :email, :phone, :message, :subject)
+      end
+    end
+  end
+end

app/controllers/api_public/v1/properties_controller.rb

@@ -16,6 +16,9 @@ def show
       end
 
       def search
+        locale = params[:locale] || I18n.default_locale
+        I18n.locale = locale
+
         # Default values matching GraphQL implementation
         args = {
           sale_or_rental: params[:sale_or_rental] || "sale",
@@ -31,7 +34,51 @@ def search
 
         # Use listed_properties (materialized view) instead of deprecated props
         properties = Pwb::Current.website.listed_properties.properties_search(**args)
-        render json: properties.as_json
+
+        # Filter by highlighted/featured if requested
+        if params[:highlighted] == 'true'
+          properties = properties.where(highlighted: true)
+        end
+
+        # Apply limit if specified
+        if params[:limit].present?
+          properties = properties.limit(params[:limit].to_i)
+        end
+
+        # Pagination support
+        page = (params[:page] || 1).to_i
+        per_page = (params[:per_page] || 12).to_i
+        
+        # Simple pagination using offset/limit
+        total_count = properties.count
+        total_pages = (total_count.to_f / per_page).ceil
+        paginated_properties = properties.offset((page - 1) * per_page).limit(per_page)
+
+        # Generate map markers
+        map_markers = paginated_properties.map do |prop|
+          next unless prop.latitude.present? && prop.longitude.present?
+          {
+            id: prop.id,
+            slug: prop.slug,
+            lat: prop.latitude,
+            lng: prop.longitude,
+            title: prop.title,
+            price: prop.formatted_price,
+            image: prop.primary_image_url,
+            url: "/properties/#{prop.slug}"
+          }
+        end.compact
+
+        render json: {
+          data: paginated_properties.as_json,
+          map_markers: map_markers,
+          meta: {
+            total: total_count,
+            page: page,
+            per_page: per_page,
+            total_pages: total_pages
+          }
+        }
       end
     end
   end

app/controllers/api_public/v1/search_config_controller.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module ApiPublic
+  module V1
+    # SearchConfigController provides filter configuration for headless frontend search pages
+    # Returns property types, price options, features, and sort options
+    class SearchConfigController < BaseController
+      # GET /api_public/v1/search/config
+      def index
+        website = Pwb::Current.website
+        locale = params[:locale] || I18n.locale
+        I18n.locale = locale
+
+        render json: {
+          property_types: property_types_with_counts(website),
+          price_options: {
+            sale: {
+              from: website.sale_price_options_from,
+              to: website.sale_price_options_till
+            },
+            rent: {
+              from: website.rent_price_options_from,
+              to: website.rent_price_options_till
+            }
+          },
+          features: available_features(website),
+          bedrooms: (0..10).to_a,
+          bathrooms: (0..6).to_a,
+          sort_options: [
+            { value: 'price_asc', label: I18n.t('search.sort.price_asc', default: 'Price: Low to High') },
+            { value: 'price_desc', label: I18n.t('search.sort.price_desc', default: 'Price: High to Low') },
+            { value: 'newest', label: I18n.t('search.sort.newest', default: 'Newest First') },
+            { value: 'bedrooms_desc', label: I18n.t('search.sort.bedrooms_desc', default: 'Most Bedrooms') }
+          ],
+          area_unit: website.default_area_unit || 'sqm',
+          currency: website.default_currency || 'EUR'
+        }
+      end
+
+      private
+
+      def property_types_with_counts(website)
+        counts = website.listed_properties
+                       .visible
+                       .group(:prop_type_key)
+                       .count
+
+        counts.map do |key, count|
+          next if key.blank?
+          {
+            key: key.to_s.split('.').last,
+            label: I18n.t("propertyTypes.#{key.to_s.split('.').last}", default: key.to_s.split('.').last.titleize),
+            count: count
+          }
+        end.compact
+      end
+
+      def available_features(website)
+        # Get features from FieldKeys if available
+        feature_keys = PwbTenant::FieldKey.where(website: website, field_key_group_tag: 'feature')
+        
+        if feature_keys.any?
+          feature_keys.map do |fk|
+            {
+              key: fk.field_key_tag,
+              label: fk.label.presence || I18n.t("features.#{fk.field_key_tag}", default: fk.field_key_tag.titleize)
+            }
+          end
+        else
+          # Fallback: extract from properties
+          all_extras = website.listed_properties.visible.pluck(:extras).compact.flatten
+          all_extras.uniq.first(20).map do |extra|
+            {
+              key: extra.to_s.parameterize,
+              label: extra.to_s.titleize
+            }
+          end
+        end
+      rescue StandardError => e
+        Rails.logger.warn("[SearchConfig] Error loading features: #{e.message}")
+        []
+      end
+    end
+  end
+end

app/models/pwb/listed_property.rb

@@ -232,6 +232,10 @@ def as_json(options = nil)
         hash['description'] = description
         hash['meta_title'] = generate_meta_title
         hash['meta_description'] = generate_meta_description
+        hash['extras'] = extras_for_display
+        hash['features'] = get_features
+        hash['highlighted'] = highlighted
+        hash['primary_image_url'] = primary_image_url
       end
     end
 

config/routes.rb

@@ -728,8 +728,10 @@
       get "/site_details" => "site_details#index"
       get "/select_values" => "select_values#index"
       get "/theme" => "theme#index"
+      get "/search/config" => "search_config#index"
       get "/testimonials" => "testimonials#index"
       post "/enquiries" => "enquiries#create"
+      post "/contact" => "contact#create"
       post "/auth/firebase" => "auth#firebase"
 
       # Embeddable Widget API

docs/js_client/API_PARITY_AUDIT.md

@@ -274,12 +274,12 @@ Pages with `is_rails_part: true` render ERB partials on the server. JS clients m
 
 ### Backend Changes Needed
 
-- [ ] Create `SearchConfigController` with filter options
-- [ ] Add map_markers to properties search response
-- [ ] Add pagination meta to search response
-- [ ] Add `?highlighted=true` query support
-- [ ] Add `extras` and `features` to ListedProperty.as_json
-- [ ] Create general contact endpoint (optional)
+- [x] Create `SearchConfigController` with filter options
+- [x] Add map_markers to properties search response
+- [x] Add pagination meta to search response
+- [x] Add `?highlighted=true` query support
+- [x] Add `extras` and `features` to ListedProperty.as_json
+- [x] Create general contact endpoint
 
 ### Frontend Implementation
 
@@ -320,8 +320,8 @@ GET /api_public/v1/testimonials
 GET /api_public/v1/select_values?field_names=property-types
 
 # Future (to be implemented)
-GET /api_public/v1/search/config
-POST /api_public/v1/contact
+# GET /api_public/v1/search/config  <-- NOW IMPLEMENTED
+# POST /api_public/v1/contact       <-- NOW IMPLEMENTED
 ```
 
 ---