rockauto_api 0.1.0

data/lib/rockauto_api/endpoints/part_search.rb

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Endpoints
+    module PartSearch
+      def get_manufacturers
+        cache.fetch("rockauto:manufacturers", ttl: 86400) do
+          html = get("/en/partsearch/")
+          opts = Parsers::HtmlHelpers.select_options(html, "manufacturer_partsearch_007")
+          manufacturers = opts.map { |o| Models::PartSearchOption.new(value: o[:value], text: o[:text]) }
+          Models::ManufacturerOptions.new(
+            manufacturers: manufacturers,
+            count: manufacturers.size
+          )
+        end
+      end
+
+      def get_part_groups
+        cache.fetch("rockauto:part_groups", ttl: 86400) do
+          html = get("/en/partsearch/")
+          opts = Parsers::HtmlHelpers.select_options(html, "partgroup_partsearch_007")
+          groups = opts.map { |o| Models::PartSearchOption.new(value: o[:value], text: o[:text]) }
+          Models::PartGroupOptions.new(
+            part_groups: groups,
+            count: groups.size
+          )
+        end
+      end
+
+      def get_part_types
+        cache.fetch("rockauto:part_types", ttl: 86400) do
+          html = get("/en/partsearch/")
+          opts = Parsers::HtmlHelpers.select_options(html, "parttype_partsearch_007")
+          types = opts.map { |o| Models::PartSearchOption.new(value: o[:value], text: o[:text]) }
+          Models::PartTypeOptions.new(
+            part_types: types,
+            count: types.size
+          )
+        end
+      end
+
+      def search_parts_by_number(part_number, manufacturer: nil, part_group: nil, part_type: nil, part_name: nil, include_fitments: false)
+        man_value = ""
+        group_value = ""
+        type_value = ""
+
+        if manufacturer
+          mans = get_manufacturers
+          match = mans.lookup(manufacturer)
+          man_value = match&.value || ""
+        end
+
+        if part_group
+          groups = get_part_groups
+          match = groups.lookup(part_group)
+          group_value = match&.value || ""
+        end
+
+        if part_type
+          types = get_part_types
+          match = types.lookup(part_type)
+          type_value = match&.value || ""
+        end
+
+        form_data = {
+          "dopartsearch" => "1",
+          "partsearch[partnum][partsearch_007]" => part_number,
+          "partsearch[manufacturer][partsearch_007]" => man_value,
+          "partsearch[partgroup][partsearch_007]" => group_value,
+          "partsearch[parttype][partsearch_007]" => type_value,
+          "partsearch[partname][partsearch_007]" => part_name || "",
+          "partsearch[do][partsearch_007]" => "Search"
+        }
+
+        html = post_with_csrf("/en/partsearch/", form_data)
+        doc = Nokogiri::HTML(html)
+
+        parts = parse_part_search_results(doc)
+        parts = parts.map do |p|
+          attrs = p.to_h
+          if include_fitments && attrs[:listing_data]
+            fitment_result = get_fitment_for_part(attrs[:listing_data])
+          end
+          Models::PartInfo.new(**attrs)
+        end
+
+        Models::PartSearchResult.new(
+          parts: parts,
+          count: parts.size,
+          search_term: part_number,
+          manufacturer: manufacturer || "All",
+          part_group: part_group || "All"
+        )
+      end
+
+      def what_is_part_called(search_query)
+        html = post("/en/partsearch/", {
+          "topsearchinput[input]" => search_query,
+          "topsearchinput[submit]" => "Search"
+        })
+        doc = Nokogiri::HTML(html)
+        results = parse_what_is_called_results(doc)
+
+        Models::WhatIsPartCalledResults.new(
+          results: results,
+          count: results.size,
+          search_term: search_query
+        )
+      end
+
+      private
+
+      def parse_part_search_results(doc)
+        doc.css("table tr").map { |row|
+          cells = row.css("td")
+          next nil if cells.size < 3
+
+          part = Parsers::PartExtractor.extract_from_row(row)
+          next nil unless part
+
+          listing_data = extract_listing_data_from_row(row)
+
+          attrs = part.to_h
+          attrs[:listing_data] = listing_data if listing_data
+          Models::PartInfo.new(**attrs)
+        }.compact
+      end
+
+      def extract_listing_data_from_row(row)
+        data = {}
+
+        row.css("[data-groupindex], [data-carcode], [data-parttype], [data-partkey], [data-partnumber], [data-catalogname], [data-optkey]").each do |el|
+          data["groupindex"] = el["data-groupindex"] if el["data-groupindex"]
+          data["car"] = { "carcode" => el["data-carcode"], "parttype" => el["data-parttype"], "partkey" => el["data-partkey"] }
+          data["supplemental"] = { "partnumber" => el["data-partnumber"], "catalogname" => el["data-catalogname"] }
+          data["optkey"] = el["data-optkey"] if el["data-optkey"]
+        end
+
+        row.css("a").each do |a|
+          onclick = a["onclick"]
+          next unless onclick
+          match = onclick.match(/getbuyersguide\('([^']+)'/)
+          data["buyersguide_key"] = match[1] if match
+        end
+
+        data.empty? ? nil : data
+      end
+
+      def parse_what_is_called_results(doc)
+        doc.css("a").map { |a|
+          text = a.text.strip
+          next nil if text.empty?
+          path_parts = text.split(">").map(&:strip)
+          main_category = path_parts[0]
+          subcategory = path_parts[1]
+          Models::WhatIsPartCalledResult.new(
+            main_category: main_category || "",
+            subcategory: subcategory || "",
+            full_path: text
+          )
+        }.compact
+      end
+    end
+  end
+end

data/lib/rockauto_api/endpoints/tools.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Endpoints
+    module Tools
+      def get_tool_categories(path = "/en/tools/")
+        html = get(path)
+        doc = Nokogiri::HTML(html)
+
+        categories = doc.css("a").map { |a|
+          text = a.text.strip
+          href = a["href"]
+          next nil if text.empty? || href.nil? || !href.include?("tools")
+          Models::ToolCategory.new(
+            name: text,
+            group_name: text,
+            href: Parsers::HtmlHelpers.make_absolute_url(href),
+            level: path.scan("/").size - 1
+          )
+        }.compact
+
+        Models::ToolCategories.new(
+          categories: categories,
+          count: categories.size,
+          level: path.scan("/").size - 1,
+          parent_path: path
+        )
+      end
+
+      def get_tools_by_category(category_path)
+        html = get(category_path)
+        doc = Nokogiri::HTML(html)
+        tools = parse_tools_from_table(doc)
+        category_name = category_path.split("/").last
+
+        Models::ToolsResult.new(
+          tools: tools,
+          count: tools.size,
+          category: category_name,
+          category_path: category_path
+        )
+      end
+
+      private
+
+      def parse_tools_from_table(doc)
+        doc.css("table tr").map { |row|
+          cells = row.css("td")
+          next nil if cells.size < 3
+
+          texts = cells.map { |c| c.text.strip }
+
+          link = row.at_css("a")
+          img = row.at_css("img")
+
+          Models::ToolInfo.new(
+            name: texts[1] || texts.first || "",
+            part_number: texts[0] || "",
+            brand: texts[2],
+            description: texts[3],
+            url: link ? Parsers::HtmlHelpers.make_absolute_url(link["href"]) : nil,
+            image_url: img ? Parsers::HtmlHelpers.make_absolute_url(img["src"]) : nil,
+            info_url: nil,
+            video_url: nil,
+            specifications: nil,
+            category: nil,
+            features: nil,
+            warranty_info: nil
+          )
+        }.compact
+      end
+    end
+  end
+end

data/lib/rockauto_api/endpoints/vehicles.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Endpoints
+    module Vehicles
+      BASE_CATALOG_URL = "https://www.rockauto.com/en/catalog/"
+
+      def get_makes
+        html = get("/en/catalog/")
+        results = Models::VehicleMakes.from_html(html)
+        results
+      end
+
+      def get_years_for_make(make)
+        simulate_navigation_context(make: make)
+
+        path = "/en/catalog/#{make}"
+        html = get(path)
+        doc = Nokogiri::HTML(html)
+
+        years = doc.css('a[href*="catalog"]').map { |a|
+          href = a["href"]
+          next nil if href.nil?
+          match = href.match(/#{Regexp.escape(make)},(\d{4})/i)
+          match ? match[1].to_i : nil
+        }.compact.uniq.sort
+
+        Models::VehicleYears.new(
+          make: make,
+          years: years,
+          count: years.size
+        )
+      end
+
+      def get_models_for_make_year(make, year)
+        simulate_navigation_context(make: make, year: year.to_s)
+
+        path = "/en/catalog/#{make},#{year}"
+        html = get(path)
+        doc = Nokogiri::HTML(html)
+
+        models = doc.css('a[href*="catalog"]').map { |a|
+          href = a["href"]
+          next nil if href.nil?
+          match = href.match(/#{Regexp.escape(make)},#{year},(.+)/i)
+          next nil unless match
+          model = match[1].split(",").first
+          model&.strip
+        }.compact.uniq
+
+        Models::VehicleModels.new(
+          make: make,
+          year: year,
+          models: models,
+          count: models.size
+        )
+      end
+
+      def get_engines_for_vehicle(make, year, model)
+        path = "/en/catalog/#{make},#{year},#{model}"
+        html = get(path)
+        doc = Nokogiri::HTML(html)
+
+        engines = doc.css('a[href*="carcode"]').map { |a|
+          href = a["href"]
+          next nil unless href
+          match = href.match(/carcode=(\d+)/)
+          next nil unless match
+          Models::Engine.new(
+            description: a.text.strip,
+            carcode: match[1],
+            href: Parsers::HtmlHelpers.make_absolute_url(href)
+          )
+        }.compact
+
+        Models::VehicleEngines.new(
+          make: make,
+          year: year,
+          model: model,
+          engines: engines,
+          count: engines.size
+        )
+      end
+    end
+  end
+end

data/lib/rockauto_api/errors.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class CaptchaError < Error; end
+  class NetworkError < Error; end
+  class ParseError < Error; end
+  class NotFoundError < Error; end
+end

data/lib/rockauto_api/models/account.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Models
+    class SavedAddress < Dry::Struct
+      attribute? :name, Types::String.optional
+      attribute? :full_name, Types::String.optional
+      attribute? :address_line1, Types::String.optional
+      attribute? :address_line2, Types::String.optional
+      attribute? :city, Types::String.optional
+      attribute? :state, Types::String.optional
+      attribute? :postal_code, Types::String.optional
+      attribute? :country, Types::String.optional
+      attribute? :phone, Types::String.optional
+      attribute :is_default, Types::Bool.default(false)
+      attribute? :address_id, Types::String.optional
+    end
+
+    class SavedAddressesResult < Dry::Struct
+      attribute :addresses, Types::Array.of(SavedAddress)
+      attribute :count, Types::Integer
+      attribute :has_default, Types::Bool.default(false)
+    end
+
+    class SavedVehicle < Dry::Struct
+      attribute :year, Types::Coercible::Integer
+      attribute :make, Types::String
+      attribute :model, Types::String
+      attribute? :engine, Types::String.optional
+      attribute? :carcode, Types::String.optional
+      attribute? :display_name, Types::String.optional
+      attribute? :catalog_url, Types::String.optional
+      attribute? :vehicle_id, Types::String.optional
+    end
+
+    class SavedVehiclesResult < Dry::Struct
+      attribute :vehicles, Types::Array.of(SavedVehicle)
+      attribute :count, Types::Integer
+    end
+
+    class OrderHistoryItem < Dry::Struct
+      attribute :order_number, Types::String
+      attribute? :date, Types::String.optional
+      attribute? :status, Types::String.optional
+      attribute? :total, Types::String.optional
+      attribute? :vehicle, Types::String.optional
+      attribute? :order_url, Types::String.optional
+    end
+
+    class OrderHistoryResult < Dry::Struct
+      attribute :orders, Types::Array.of(OrderHistoryItem)
+      attribute :count, Types::Integer
+      attribute? :filter_applied, Types::String.optional
+      attribute? :search_time, Types::String.optional
+    end
+
+    class AccountActivityResult < Dry::Struct
+      attribute :order_history, OrderHistoryResult.optional
+      attribute :saved_addresses, SavedAddressesResult.optional
+      attribute :saved_vehicles, SavedVehiclesResult.optional
+      attribute :has_discount_codes, Types::Bool.default(false)
+      attribute :has_store_credit, Types::Bool.default(false)
+      attribute :has_alerts, Types::Bool.default(false)
+    end
+  end
+end

data/lib/rockauto_api/models/fitment.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Models
+    class FitmentInfo < Dry::Struct
+      attribute :year, Types::Integer
+      attribute :make, Types::String
+      attribute :model, Types::String
+      attribute? :engine, Types::String.optional
+      attribute? :transmission, Types::String.optional
+      attribute? :drivetrain, Types::String.optional
+      attribute? :notes, Types::String.optional
+    end
+
+    class BuyersGuideResult < Dry::Struct
+      attribute :part_number, Types::String
+      attribute :brand, Types::String
+      attribute :fitments, Types::Array.of(FitmentInfo)
+      attribute :count, Types::Integer
+    end
+  end
+end

data/lib/rockauto_api/models/order.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Models
+    class OrderItem < Dry::Struct
+      attribute :part_number, Types::String
+      attribute :description, Types::String
+      attribute? :brand, Types::String.optional
+      attribute? :quantity, Types::String.optional
+      attribute? :unit_price, Types::String.optional
+      attribute? :total_price, Types::String.optional
+      attribute? :status, Types::String.optional
+      attribute? :tracking_number, Types::String.optional
+    end
+
+    class BillingInfo < Dry::Struct
+      attribute? :subtotal, Types::String.optional
+      attribute? :shipping_cost, Types::String.optional
+      attribute? :tax, Types::String.optional
+      attribute? :total, Types::String.optional
+      attribute? :payment_method, Types::String.optional
+      attribute? :payment_status, Types::String.optional
+    end
+
+    class ShippingInfo < Dry::Struct
+      attribute? :method, Types::String.optional
+      attribute? :cost, Types::String.optional
+      attribute? :carrier, Types::String.optional
+      attribute? :tracking_number, Types::String.optional
+      attribute? :estimated_delivery, Types::String.optional
+      attribute? :actual_delivery, Types::String.optional
+    end
+
+    class OrderStatus < Dry::Struct
+      attribute :order_number, Types::String
+      attribute? :order_date, Types::String.optional
+      attribute? :status, Types::String.optional
+      attribute? :customer_email, Types::String.optional
+      attribute? :customer_phone, Types::String.optional
+      attribute :items, Types::Array.of(OrderItem).default([].freeze)
+      attribute :billing, BillingInfo.optional
+      attribute :shipping, ShippingInfo.optional
+      attribute? :notes, Types::String.optional
+      attribute? :return_eligibility, Types::String.optional
+    end
+
+    class OrderStatusError < Dry::Struct
+      attribute :error_type, Types::String
+      attribute :message, Types::String
+      attribute :order_number, Types::String
+      attribute :suggestions, Types::Array.of(Types::String).default([].freeze)
+    end
+
+    class OrderStatusResult < Dry::Struct
+      attribute :success, Types::Bool
+      attribute :order, OrderStatus.optional
+      attribute :error, OrderStatusError.optional
+      attribute? :lookup_time, Types::String.optional
+    end
+  end
+end

data/lib/rockauto_api/models/part.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Models
+    class PartInfo < Dry::Struct
+      attribute :name, Types::String
+      attribute :part_number, Types::String
+      attribute? :brand, Types::String.optional
+      attribute? :price, Types::String.optional
+      attribute? :url, Types::String.optional
+      attribute? :image_url, Types::String.optional
+      attribute? :info_url, Types::String.optional
+      attribute? :video_url, Types::String.optional
+      attribute? :category, Types::String.optional
+      attribute? :specifications, Types::String.optional
+      attribute? :compatibility_notes, Types::String.optional
+      attribute? :listing_data, Types::Hash
+    end
+
+    class PartSearchResult < Dry::Struct
+      attribute :parts, Types::Array.of(PartInfo)
+      attribute :count, Types::Integer
+      attribute :search_term, Types::String
+      attribute :manufacturer, Types::String.default("All")
+      attribute :part_group, Types::String.default("All")
+    end
+
+    class PartSearchOption < Dry::Struct
+      attribute :value, Types::String
+      attribute :text, Types::String
+    end
+
+    class ManufacturerOptions < Dry::Struct
+      attribute :manufacturers, Types::Array.of(PartSearchOption)
+      attribute :count, Types::Integer
+      attribute? :last_updated, Types::String.optional
+
+      def lookup(name)
+        manufacturers.find { |m| m.text.casecmp(name).zero? }
+      end
+    end
+
+    class PartGroupOptions < Dry::Struct
+      attribute :part_groups, Types::Array.of(PartSearchOption)
+      attribute :count, Types::Integer
+      attribute? :last_updated, Types::String.optional
+
+      def lookup(name)
+        part_groups.find { |g| g.text.casecmp(name).zero? }
+      end
+    end
+
+    class PartTypeOptions < Dry::Struct
+      attribute :part_types, Types::Array.of(PartSearchOption)
+      attribute :count, Types::Integer
+      attribute? :last_updated, Types::String.optional
+
+      def lookup(name)
+        part_types.find { |t| t.text.casecmp(name).zero? }
+      end
+    end
+
+    class WhatIsPartCalledResult < Dry::Struct
+      attribute :main_category, Types::String
+      attribute :subcategory, Types::String
+      attribute :full_path, Types::String
+    end
+
+    class WhatIsPartCalledResults < Dry::Struct
+      attribute :results, Types::Array.of(WhatIsPartCalledResult)
+      attribute :count, Types::Integer
+      attribute :search_term, Types::String
+    end
+  end
+end

data/lib/rockauto_api/models/tool.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Models
+    class ToolCategory < Dry::Struct
+      attribute :name, Types::String
+      attribute :group_name, Types::String
+      attribute? :href, Types::String.optional
+      attribute :level, Types::Integer.default(0)
+    end
+
+    class ToolCategories < Dry::Struct
+      attribute :categories, Types::Array.of(ToolCategory)
+      attribute :count, Types::Integer
+      attribute :level, Types::Integer.default(0)
+      attribute? :parent_path, Types::String.optional
+    end
+
+    class ToolInfo < Dry::Struct
+      attribute :name, Types::String
+      attribute :part_number, Types::String
+      attribute? :brand, Types::String.optional
+      attribute? :description, Types::String.optional
+      attribute? :url, Types::String.optional
+      attribute? :image_url, Types::String.optional
+      attribute? :info_url, Types::String.optional
+      attribute? :video_url, Types::String.optional
+      attribute? :specifications, Types::String.optional
+      attribute? :category, Types::String.optional
+      attribute? :features, Types::String.optional
+      attribute? :warranty_info, Types::String.optional
+    end
+
+    class ToolsResult < Dry::Struct
+      attribute :tools, Types::Array.of(ToolInfo)
+      attribute :count, Types::Integer
+      attribute :category, Types::String
+      attribute? :category_path, Types::String.optional
+    end
+  end
+end

data/lib/rockauto_api/models/vehicle.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module RockautoApi
+  module Types
+    include Dry.Types()
+  end
+
+  module Models
+    class VehicleMakes < Dry::Struct
+      attribute :makes, Types::Array.of(Types::String)
+      attribute :count, Types::Integer
+
+      def self.from_html(html)
+        doc = Nokogiri::HTML(html)
+        makes = doc.css('a[href*="/en/catalog/"]').map { |a|
+          href = a["href"]
+          next nil if href.nil? || href == "/en/catalog/" || href.include?(",")
+          a.text.strip
+        }.compact.uniq
+        new(makes: makes, count: makes.size)
+      end
+    end
+
+    class VehicleYears < Dry::Struct
+      attribute :make, Types::String
+      attribute :years, Types::Array.of(Types::Integer)
+      attribute :count, Types::Integer
+    end
+
+    class VehicleModels < Dry::Struct
+      attribute :make, Types::String
+      attribute :year, Types::Integer
+      attribute :models, Types::Array.of(Types::String)
+      attribute :count, Types::Integer
+    end
+
+    class Engine < Dry::Struct
+      attribute :description, Types::String
+      attribute :carcode, Types::String
+      attribute? :href, Types::String.optional
+    end
+
+    class VehicleEngines < Dry::Struct
+      attribute :make, Types::String
+      attribute :year, Types::Integer
+      attribute :model, Types::String
+      attribute :engines, Types::Array.of(Engine)
+      attribute :count, Types::Integer
+    end
+
+    class PartCategory < Dry::Struct
+      attribute :name, Types::String
+      attribute :group_name, Types::String
+      attribute? :href, Types::String.optional
+    end
+
+    class VehiclePartCategories < Dry::Struct
+      attribute :make, Types::String
+      attribute :year, Types::Integer
+      attribute :model, Types::String
+      attribute :carcode, Types::String
+      attribute :categories, Types::Array.of(PartCategory)
+      attribute :count, Types::Integer
+    end
+
+    class VehiclePartsResult < Dry::Struct
+      attribute :make, Types::String
+      attribute :year, Types::Integer
+      attribute :model, Types::String
+      attribute :carcode, Types::String
+      attribute :category, Types::String
+      attribute :parts, Types::Array
+      attribute :count, Types::Integer
+    end
+  end
+end