Add IANA timezone example and clean up enrichment example output

Author: RyanLCox1

CLAUDE.md

@@ -38,10 +38,13 @@ client = SmartyStreets::ClientBuilder.new(credentials)
     .build_us_street_api_client
 ```
 
-**Chain of Responsibility**: HTTP requests flow through a middleware chain of "Sender" objects. Each sender wraps an inner sender:
+**Chain of Responsibility**: HTTP requests flow through a middleware chain of "Sender" objects. Each sender wraps an inner sender (outermost to innermost):
 ```
-URLPrefixSender → LicenseSender → RetrySender → SigningSender → StatusCodeSender → NativeSender
+URLPrefixSender → CustomQuerySender → LicenseSender → RetrySender → SigningSender → CustomHeaderSender → StatusCodeSender → NativeSender
 ```
+`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`.
 
 ### Key Components
 

Makefile

@@ -46,7 +46,7 @@ us_reverse_geo_api:
 	cd examples && ruby us_reverse_geo_example.rb
 
 us_street_api:
-	cd examples && ruby us_street_single_address_example.rb && ruby us_street_multiple_address_example.rb && ruby us_street_component_analysis_example.rb && ruby us_street_component_analysis_example.rb
+	cd examples && ruby us_street_single_address_example.rb && ruby us_street_multiple_address_example.rb && ruby us_street_component_analysis_example.rb && ruby us_street_iana_timezone_example.rb
 
 us_zipcode_api:
 	cd examples && ruby us_zipcode_single_lookup_example.rb && ruby us_zipcode_multiple_lookup_example.rb

examples/us_enrichment_example.rb

@@ -44,8 +44,6 @@ def run
     freeform_lookup = SmartyStreets::USEnrichment::Lookup.new
     freeform_lookup.freeform = "56 Union Ave Somerville NJ 08876"
 
-    
-
     begin
       # Send a lookup with a smarty key using the line below
       # result = client.send_property_principal_lookup("325023201")
@@ -70,8 +68,67 @@ def run
       return
     end
 
-    puts "Lookup Successful! Here is the result: "
-    puts result[0].inspect
+    puts "Lookup Successful! Here is the result:"
+    puts
+
+    response = result[0]
+    attrs = response.attributes
+
+    puts "Smarty Key: #{response.smarty_key}"
+    puts "Data Set: #{response.data_set_name}/#{response.data_subset_name}"
+    puts "ETag: #{response.etag}"
+    puts
+
+    puts "Property Address:"
+    puts "\tFull Address: #{attrs.property_address_full}"
+    puts "\tCity: #{attrs.property_address_city}"
+    puts "\tState: #{attrs.property_address_state}"
+    puts "\tZIP: #{attrs.property_address_zipcode}"
+    puts
+
+    puts "Owner:"
+    puts "\tName: #{attrs.owner_full_name}"
+    puts "\tOccupancy: #{attrs.owner_occupancy_status}"
+    puts
+
+    puts "Property Details:"
+    puts "\tLand Use: #{attrs.land_use_standard}"
+    puts "\tYear Built: #{attrs.year_built}"
+    puts "\tBuilding Sqft: #{attrs.building_sqft}"
+    puts "\tLot Sqft: #{attrs.lot_sqft}"
+    puts "\tAcres: #{attrs.acres}"
+    puts "\tBathrooms: #{attrs.bathrooms_total}"
+    puts "\tBedrooms: #{attrs.bedrooms}"
+    puts "\tStories: #{attrs.stories_number}"
+    puts "\tFireplace: #{attrs.fireplace}"
+    puts "\tGarage: #{attrs.garage}"
+    puts
+
+    puts "Assessment:"
+    puts "\tAssessed Value: #{attrs.assessed_value}"
+    puts "\tTotal Market Value: #{attrs.total_market_value}"
+    puts "\tTax Year: #{attrs.tax_assess_year}"
+    puts "\tTax Billed: #{attrs.tax_billed_amount}"
+    puts
+
+    puts "Location:"
+    puts "\tCounty: #{attrs.situs_county}"
+    puts "\tLatitude: #{attrs.latitude}"
+    puts "\tLongitude: #{attrs.longitude}"
+    puts "\tElevation (ft): #{attrs.elevation_feet}"
+    puts
+
+    unless attrs.financial_history.nil? || attrs.financial_history.empty?
+      puts "Financial History (#{attrs.financial_history.length} entries):"
+      attrs.financial_history.each_with_index do |entry, i|
+        puts "\tEntry #{i + 1}:"
+        puts "\t\tDocument Type: #{entry.document_type_description}"
+        puts "\t\tLender: #{entry.lender_name}"
+        puts "\t\tMortgage Amount: #{entry.mortgage_amount}"
+        puts "\t\tMortgage Type: #{entry.mortgage_type}"
+        puts "\t\tRecording Date: #{entry.mortgage_recording_date}"
+      end
+    end
   end
 end
 

examples/us_street_iana_timezone_example.rb

@@ -0,0 +1,54 @@
+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_street/lookup'
+require '../lib/smartystreets_ruby_sdk/us_street/match_type'
+
+class USStreetIANATimezoneExample
+  def run
+    # For client-side requests (browser/mobile), use this code:
+    # key = ENV['SMARTY_AUTH_WEB']
+    # referer = ENV['SMARTY_AUTH_REFERER']
+    # credentials = SmartyStreets::SharedCredentials.new(key, referer)
+
+    # For server-to-server requests, use this code:
+    id = ENV['SMARTY_AUTH_ID']
+    token = ENV['SMARTY_AUTH_TOKEN']
+    credentials = SmartyStreets::BasicAuthCredentials.new(id, token)
+
+    client = SmartyStreets::ClientBuilder.new(credentials)
+      .with_feature_iana_time_zone()
+      .build_us_street_api_client
+
+    lookup = SmartyStreets::USStreet::Lookup.new
+    lookup.street = "1 Rosedale"
+    lookup.secondary = "APT 2"
+    lookup.city = "Baltimore"
+    lookup.state = "MD"
+    lookup.zipcode = "21229"
+    lookup.match = SmartyStreets::USStreet::MatchType::ENHANCED
+
+    begin
+      client.send_lookup(lookup)
+    rescue SmartyStreets::SmartyError => err
+      puts err
+      return
+    end
+
+    result = lookup.result
+
+    if result.empty?
+      return
+    end
+
+    first_candidate = result[0]
+
+    puts "IANA Time Zone: #{first_candidate.metadata.iana_time_zone}"
+    puts "IANA UTC Offset: #{first_candidate.metadata.iana_utc_offset}"
+    puts "IANA Obeys DST: #{first_candidate.metadata.iana_obeys_dst}"
+  end
+end
+
+example = USStreetIANATimezoneExample.new
+example.run