freight_kit 0.1.20 → 0.1.21

data/freight_kit.gemspec

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 version = File.read(File.expand_path('VERSION', __dir__)).strip.freeze
 
 Gem::Specification.new do |spec|
@@ -7,17 +5,17 @@ Gem::Specification.new do |spec|
   spec.version = version
 
   spec.authors = [
-                   'Third Party Transportation Systems LLC',
-                   'Brody Hoskins',
-                   'Sub Pop Records',
-                   'Shopify',
-                 ]
+    'Third Party Transportation Systems LLC',
+    'Brody Hoskins',
+    'Sub Pop Records',
+    'Shopify'
+  ]
   spec.email = [
-                 'hello@next-tms.com',
-                 'brody@brody.digital',
-                 'webmaster@subpop.com',
-                 'integrations-team@shopify.com',
-               ]
+    'hello@next-tms.com',
+    'brody@brody.digital',
+    'webmaster@subpop.com',
+    'integrations-team@shopify.com'
+  ]
 
   spec.description = 'Freight carrier API and website abstraction library for transportation management systems (TMS)'
   spec.homepage = 'https://github.com/next-tms/freight_kit'
@@ -33,7 +31,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency('rake', '~> 13.4.2')
   spec.add_development_dependency('redcarpet', '~> 3.6.0') # for yard
   spec.add_development_dependency('rspec', '~> 3.12')
-  spec.add_development_dependency('rubocop-next', '~> 1.0.8')
+  spec.add_development_dependency('rubocop-next', '~> 1.0.9')
   spec.add_development_dependency('yard', '~> 0.9.28')
 
   spec.add_dependency('activemodel', '>= 7.1', '< 8.1.5')
@@ -42,6 +40,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency('benchmark', '~> 0.5.0')
   spec.add_dependency('brotli', '>= 0.9.2', '< 1') # CVE-2026-111497
   spec.add_dependency('business_time', '~> 0.13.0')
+  spec.add_dependency('countries', '~> 8.1')
   spec.add_dependency('httpx', '>= 1.9.0', '< 2')
   spec.add_dependency('json', '< 3') # measured
   spec.add_dependency('measured', '>= 2.0', '< 3.2.2')
@@ -50,6 +49,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency('nokogiri', '>= 1.6', '< 1.20')
   spec.add_dependency('place_kit', '~> 0.0.6')
   spec.add_dependency('savon', '>= 2.17', '< 2.18')
+  spec.add_dependency('StreetAddress', '~> 2.0')
   spec.add_dependency('tzinfo-data', '~> 1.2023', '>= 1.2023.3')
   spec.add_dependency('watir', '>= 7.0', '< 7.4')
   spec.add_dependency('zeitwerk', '>= 2.6.0', '< 2.8.4')

data/lib/freight_kit/address_normalizer.rb

@@ -0,0 +1,26 @@
+module FreightKit
+  # Normalizes US street addresses for comparison, using the StreetAddress gem's
+  # direction and street type tables.
+  class AddressNormalizer
+    UNIT_DESIGNATORS = ['apt', 'bldg', 'building', 'dept', 'fl', 'floor', 'rm', 'room', 'ste', 'suite', 'unit'].freeze
+
+    class << self
+      # Normalizes a street line so that, for example, "22205 E. 19th Ave." and
+      # "22205 East 19th Avenue" both become "22205 e 19th ave".
+      #
+      # @param address1 [String, nil]
+      # @return [String, nil]
+      def street_key(address1)
+        return if address1.blank?
+
+        words = address1.split('#').first.to_s.downcase.delete('.').gsub(/[^a-z0-9\s]/, ' ').split
+        words = words.take_while { |word| UNIT_DESIGNATORS.exclude?(word) }
+        return unless words.first&.match?(/\d/)
+
+        words.map do |word|
+          StreetAddress::US::DIRECTIONAL[word]&.downcase || StreetAddress::US::STREET_TYPES[word] || word
+        end.join(' ')
+      end
+    end
+  end
+end

data/lib/freight_kit/amazon_warehouse.rb

@@ -0,0 +1,33 @@
+module FreightKit
+  # Amazon warehouses in the United States, from OpenStreetMap.
+  #
+  # Regenerate the list with `rake amazon_warehouses:update`.
+  module AmazonWarehouse
+    extend self
+
+    def all
+      @all ||= YAML.safe_load_file(
+        File.expand_path('../../configuration/locations/amazon_warehouses.yml', __dir__),
+        permitted_classes: [Symbol]
+      )
+    end
+
+    # @param location [Location]
+    # @return [Hash, nil] The warehouse at the location, if any.
+    def find(location)
+      postal_code = location&.postal_code&.[](/\A\d{5}/)
+      return if postal_code.blank?
+
+      street_key = AddressNormalizer.street_key(location.address1)
+      return if street_key.blank?
+
+      by_postal_code[postal_code]&.find { |warehouse| warehouse[:street_key] == street_key }
+    end
+
+    def include?(location) = find(location).present?
+
+    private
+
+    def by_postal_code = @by_postal_code ||= all.group_by { |warehouse| warehouse[:postal_code] }
+  end
+end

data/lib/freight_kit/api_clients/soap_client.rb

@@ -1,15 +1,13 @@
-# frozen_string_literal: true
-
 module FreightKit
   class SoapClient
     API_EXCEPTIONS = [
-                       Savon::HTTPError,
-                       Net::ReadTimeout,
-                       Net::OpenTimeout,
-                       Errno::ECONNREFUSED,
-                       Errno::ECONNRESET,
-                       Errno::EHOSTUNREACH,
-                     ]
+      Savon::HTTPError,
+      Net::ReadTimeout,
+      Net::OpenTimeout,
+      Errno::ECONNREFUSED,
+      Errno::ECONNRESET,
+      Errno::EHOSTUNREACH
+    ].freeze
 
     def initialize(carrier:, action:, client_args:, call_args:, soap_operation:)
       @carrier = carrier