smartystreets_ruby_sdk 10.0.0 → 10.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dfe1e04d687c3c2b33c116f12115c921092875761773196e70b05686642147d
-  data.tar.gz: c48c629d5c11195f679fe264b0fe4557e0fc78355e8f51b3ff62ebc463f27da8
+  metadata.gz: 451e124efa79d87aed1df0f4a4a595b698463835d8ffc4461168d439da9e2b56
+  data.tar.gz: dbd7c8c731275bd1bc62e8fb0cc0e930e18ad0ce886b26e8bd570f84f0a4f4a7
 SHA512:
-  metadata.gz: 1fdef4159968f9cdfd3a6e67afefc68ffdddbf527bc4331f424410274b27812c1cfce78c18ca81e8a3ccc817d4b0db267513a116c55e182d43e71e8ffee694c8
-  data.tar.gz: 5fc398cc1452df089d87f0f13869b6ead3ebe387a9698d47881a064b498b8a10b992381e5ec26d95626e0dfdceb56ec47833f15e91601a60f6bbb9de513c4a6c
+  metadata.gz: 8e4c92f2f87638cfb7ae504599040b5745eec1d6553333409648077e5962d112f5d66a771435a78f3701d12e555d034e6821ad7d690fc97aa45214923f4b42e1
+  data.tar.gz: e3c2516ec819aab127324cd4ae3f211e2ec1fe363a80aa2ff490993ce3b0859cccc85c2b99244080f95b90b5ef67d32d93c104e7afd171922b50a7490eb79fdc

data/CLAUDE.md

@@ -44,7 +44,7 @@ URLPrefixSender → CustomQuerySender → LicenseSender → RetrySender → Sign
 ```
 `CustomHeaderSender` is only included when custom headers are configured; `RetrySender` only when max_retries > 0.
 
-**Authentication**: Three credential types — `StaticCredentials` (auth-id/auth-token), `SharedCredentials` (website key/hostname), and `BasicAuthCredentials` (basic auth header). Credentials are passed to `ClientBuilder` and injected into the sender chain via `SigningSender`.
+**Authentication**: Three credential types — `StaticCredentials` (auth-id/auth-token), `SharedCredentials` (website key/hostname), and `BasicAuthCredentials` (basic auth header). Credentials are passed to `ClientBuilder` and injected into the sender chain via `SigningSender`. Embedded/website keys are GET-only, so they are not valid for batch (POST) requests or the US Extract API (POST-only): https://www.smarty.com/docs/cloud/authentication
 
 ### Key Components
 

data/examples/international_autocomplete_example.rb

@@ -4,9 +4,11 @@ require '../lib/smartystreets_ruby_sdk/basic_auth_credentials'
 require '../lib/smartystreets_ruby_sdk/client_builder'
 require '../lib/smartystreets_ruby_sdk/international_autocomplete/lookup'
 require '../lib/smartystreets_ruby_sdk/international_autocomplete/client'
+require '../lib/smartystreets_ruby_sdk/international_autocomplete/language_mode'
 
 class InternationalAutocompleteExample
   Lookup = SmartyStreets::InternationalAutocomplete::Lookup
+  LanguageMode = SmartyStreets::InternationalAutocomplete::LanguageMode
 
   def run
     # key = 'Your SmartyStreets Auth Key here'
@@ -30,6 +32,7 @@ class InternationalAutocompleteExample
     lookup.locality = "Paris"
     lookup.max_group_results = 5
     lookup.geolocation = true
+    lookup.language = LanguageMode::NATIVE
 
     # lookup.add_custom_parameter('parameter', 'value')
 

data/examples/us_extract_example.rb

@@ -1,5 +1,4 @@
 require '../lib/smartystreets_ruby_sdk/static_credentials'
-require '../lib/smartystreets_ruby_sdk/shared_credentials'
 require '../lib/smartystreets_ruby_sdk/basic_auth_credentials'
 require '../lib/smartystreets_ruby_sdk/client_builder'
 require '../lib/smartystreets_ruby_sdk/us_extract/lookup'
@@ -10,12 +9,10 @@ class USExtractExample
   Lookup = SmartyStreets::USExtract::Lookup
 
   def run
-    # key = 'Your SmartyStreets Auth Key here'
-    # referer = 'Your host name here'
-    # We recommend storing your secret keys in environment variables instead---it's safer!
-    # key = ENV['SMARTY_AUTH_WEB']
-    # referer = ENV['SMARTY_AUTH_REFERER']
-    # credentials = SmartyStreets::SharedCredentials.new(key, referer)
+    # We recommend storing your secret keys in environment variables.
+    #
+    # The US Extract API is POST-only and embedded keys are restricted to GET, so this
+    # API requires secret keys: https://www.smarty.com/docs/cloud/authentication
 
     id = ENV['SMARTY_AUTH_ID']
     token = ENV['SMARTY_AUTH_TOKEN']

data/examples/us_street_match_strategy_example.rb

@@ -1,5 +1,4 @@
 require '../lib/smartystreets_ruby_sdk/static_credentials'
-require '../lib/smartystreets_ruby_sdk/shared_credentials'
 require '../lib/smartystreets_ruby_sdk/basic_auth_credentials'
 require '../lib/smartystreets_ruby_sdk/client_builder'
 require '../lib/smartystreets_ruby_sdk/batch'
@@ -11,7 +10,11 @@ class USStreetLookupsWithMatchStrategyExample
   MatchType = SmartyStreets::USStreet::MatchType
 
   def run
-    # We recommend storing your secret keys in environment variables instead---it's safer!
+    # We recommend storing your secret keys in environment variables.
+    #
+    # Batch requests are sent via HTTP POST. Embedded keys are restricted to GET, so
+    # batches require secret keys: https://www.smarty.com/docs/cloud/authentication
+
     id = ENV['SMARTY_AUTH_ID']
     token = ENV['SMARTY_AUTH_TOKEN']
     credentials = SmartyStreets::BasicAuthCredentials.new(id, token)

data/examples/us_street_multiple_address_example.rb

@@ -1,5 +1,4 @@
 require '../lib/smartystreets_ruby_sdk/static_credentials'
-require '../lib/smartystreets_ruby_sdk/shared_credentials'
 require '../lib/smartystreets_ruby_sdk/basic_auth_credentials'
 require '../lib/smartystreets_ruby_sdk/client_builder'
 require '../lib/smartystreets_ruby_sdk/batch'
@@ -10,12 +9,10 @@ class USStreetMultipleAddressExample
   Lookup = SmartyStreets::USStreet::Lookup
 
   def run
-    # key = 'Your SmartyStreets Auth Key here'
-    # referer = 'Your host name here'
-    # We recommend storing your secret keys in environment variables instead---it's safer!
-    # key = ENV['SMARTY_AUTH_WEB']
-    # referer = ENV['SMARTY_AUTH_REFERER']
-    # credentials = SmartyStreets::SharedCredentials.new(key, referer)
+    # We recommend storing your secret keys in environment variables.
+    #
+    # Batch requests are sent via HTTP POST. Embedded keys are restricted to GET, so
+    # batches require secret keys: https://www.smarty.com/docs/cloud/authentication
 
     id = ENV['SMARTY_AUTH_ID']
     token = ENV['SMARTY_AUTH_TOKEN']

data/examples/us_zipcode_multiple_lookup_example.rb

@@ -1,5 +1,4 @@
 require '../lib/smartystreets_ruby_sdk/static_credentials'
-require '../lib/smartystreets_ruby_sdk/shared_credentials'
 require '../lib/smartystreets_ruby_sdk/basic_auth_credentials'
 require '../lib/smartystreets_ruby_sdk/client_builder'
 require '../lib/smartystreets_ruby_sdk/batch'
@@ -9,12 +8,10 @@ class USZipcodeMultipleLookupExample
   Lookup = SmartyStreets::USZipcode::Lookup
 
   def run
-    # key = 'Your SmartyStreets Auth Key here'
-    # referer = 'Your host name here'
-    # We recommend storing your secret keys in environment variables instead---it's safer!
-    # key = ENV['SMARTY_AUTH_WEB']
-    # referer = ENV['SMARTY_AUTH_REFERER']
-    # credentials = SmartyStreets::SharedCredentials.new(key, referer)
+    # We recommend storing your secret keys in environment variables.
+    #
+    # Batch requests are sent via HTTP POST. Embedded keys are restricted to GET, so
+    # batches require secret keys: https://www.smarty.com/docs/cloud/authentication
 
     id = ENV['SMARTY_AUTH_ID']
     token = ENV['SMARTY_AUTH_TOKEN']

data/lib/smartystreets_ruby_sdk/international_autocomplete/client.rb

@@ -1,6 +1,7 @@
 require_relative '../request'
 require_relative '../exceptions'
 require_relative 'suggestion'
+require_relative 'language_mode'
 
 module SmartyStreets
   module InternationalAutocomplete
@@ -43,6 +44,7 @@ module SmartyStreets
         add_parameter(request, 'geolocation', 'on') if lookup.geolocation
         add_parameter(request, 'include_only_locality', lookup.locality)
         add_parameter(request, 'include_only_postal_code', lookup.postal_code)
+        add_parameter(request, 'language', normalized_language(lookup.language))
 
         for key in lookup.custom_param_hash.keys do
           add_parameter(request, key, lookup.custom_param_hash[key])
@@ -65,6 +67,12 @@ module SmartyStreets
       def add_parameter(request, key, value)
         request.parameters[key] = value unless value.nil? or value.empty?
       end
+
+      def normalized_language(language)
+        return nil if language.nil?
+
+        LanguageMode.from_value(language).value
+      end
     end
   end
 end

data/lib/smartystreets_ruby_sdk/international_autocomplete/language_mode.rb

@@ -0,0 +1,26 @@
+require_relative '../exceptions'
+
+module SmartyStreets
+  module InternationalAutocomplete
+    # A closed set of valid Language values, the closest Ruby equivalent to an enum: a fixed set of frozen
+    # instances rather than an arbitrary string.
+    class LanguageMode < Data.define(:value)
+      NATIVE = new('native')
+      LATIN = new('latin')
+
+      ALL = [NATIVE, LATIN].freeze
+
+      # Resolves a LanguageMode instance or a raw value (eg. from user input or config) into a LanguageMode,
+      # matching 'native'/'latin' regardless of case.
+      def self.from_value(value)
+        return value if value.is_a?(LanguageMode)
+
+        match = ALL.find { |mode| mode.value.casecmp?(value.to_s) }
+        raise SmartyStreets::UnprocessableEntityError,
+              "invalid Language value; must be unset, 'native', or 'latin' (case-insensitive)" if match.nil?
+
+        match
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/international_autocomplete/lookup.rb

@@ -4,9 +4,13 @@ module SmartyStreets
   module InternationalAutocomplete
     # In addition to holding all of the input data for this lookup, this class also will contain the result
     # of the lookup after it comes back from the API.
+    #
+    # @language:: When not set, the output language will match the default for the country.
+    #     When set to language_mode.NATIVE, the results will always be in the language of the output country.
+    #     When set to language_mode.LATIN, the results will always be provided using a Latin character set.
     class Lookup < JSONAble
 
-      attr_accessor :result, :search, :address_id, :country, :max_results, :max_group_results, :geolocation, :locality, :postal_code, :custom_param_hash
+      attr_accessor :result, :search, :address_id, :country, :max_results, :max_group_results, :geolocation, :locality, :postal_code, :language, :custom_param_hash
 
       def initialize(search = nil, address_id = nil, country = nil, max_results = nil, max_group_results = 100, geolocation = false, locality = nil, postal_code = nil, custom_param_hash = nil)
         @result = []
@@ -18,6 +22,7 @@ module SmartyStreets
         @geolocation = geolocation
         @locality = locality
         @postal_code = postal_code
+        @language = nil
         @custom_param_hash = {}
       end
 

data/lib/smartystreets_ruby_sdk/international_autocomplete.rb

@@ -1,6 +1,7 @@
 require_relative './international_autocomplete/lookup'
 require_relative './international_autocomplete/suggestion'
 require_relative './international_autocomplete/client'
+require_relative './international_autocomplete/language_mode'
 
 module SmartyStreets
   module InternationalAutocomplete 

data/lib/smartystreets_ruby_sdk/version.rb

@@ -1,3 +1,3 @@
 module SmartyStreets
-  VERSION = '10.0.0' # DO NOT EDIT (this is updated by a build job when a new release is published)
+  VERSION = '10.1.0' # DO NOT EDIT (this is updated by a build job when a new release is published)
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartystreets_ruby_sdk
 version: !ruby/object:Gem::Version
-  version: 10.0.0
+  version: 10.1.0
 platform: ruby
 authors:
 - SmartyStreets SDK Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-19 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -123,6 +123,7 @@ files:
 - lib/smartystreets_ruby_sdk/exceptions.rb
 - lib/smartystreets_ruby_sdk/international_autocomplete.rb
 - lib/smartystreets_ruby_sdk/international_autocomplete/client.rb
+- lib/smartystreets_ruby_sdk/international_autocomplete/language_mode.rb
 - lib/smartystreets_ruby_sdk/international_autocomplete/lookup.rb
 - lib/smartystreets_ruby_sdk/international_autocomplete/suggestion.rb
 - lib/smartystreets_ruby_sdk/international_postal_code.rb