seam 2.140.0 → 2.141.1

data/lib/seam/routes/locks_simulate.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "seam/helpers/action_attempt"
+require "seam/action_attempt_resolver"
 
 module Seam
   module Clients
@@ -19,7 +19,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Simulates a manual lock action using a keypad. You can only perform this action for [August](https://docs.seam.co/device-and-system-integration-guides/august-locks) devices within [sandbox workspaces](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces).
@@ -30,7 +30,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
     end
   end

data/lib/seam/routes/spaces.rb

@@ -95,7 +95,7 @@ module Seam
       # Returns a list of all spaces.
       # @param customer_key [String, nil] Customer key for which you want to list spaces.
       # @param limit [Float, nil] Maximum number of records to return per page.
-      # @param page_cursor [String, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param page_cursor [String, Seam::Null, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
       # @param search [String, nil] String for which to search. Filters returned spaces to include all records that satisfy a partial match using `name`, `space_key`, or `customer_key`.
       # @param space_key [String, nil] Filter spaces by space_key.
       # @return [Seam::Resources::Space] OK

data/lib/seam/routes/thermostats.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "seam/helpers/action_attempt"
+require "seam/action_attempt_resolver"
 
 module Seam
   module Clients
@@ -31,7 +31,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Sets a specified [thermostat](https://docs.seam.co/capability-guides/thermostats) to [cool mode](https://docs.seam.co/capability-guides/thermostats/configure-current-climate-settings).
@@ -44,7 +44,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Creates a [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets) for a specified [thermostat](https://docs.seam.co/capability-guides/thermostats).
@@ -60,7 +60,7 @@ module Seam
       # @param hvac_mode_setting [String, nil] Desired [HVAC mode](https://docs.seam.co/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.
       # @param manual_override_allowed [Boolean, nil] Indicates whether a person at the thermostat or using the API can change the thermostat's settings.
       # @deprecated manual_override_allowed: Use 'thermostat_schedule.is_override_allowed'
-      # @param name [String, nil] User-friendly name to identify the [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets).
+      # @param name [String, Seam::Null, nil] User-friendly name to identify the [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets).
       # @return [nil] OK
       def create_climate_preset(climate_preset_key:, device_id:, climate_preset_mode: nil, cooling_set_point_celsius: nil, cooling_set_point_fahrenheit: nil, ecobee_metadata: nil, fan_mode_setting: nil, heating_set_point_celsius: nil, heating_set_point_fahrenheit: nil, hvac_mode_setting: nil, manual_override_allowed: nil, name: nil)
         @client.post("/thermostats/create_climate_preset", {climate_preset_key: climate_preset_key, device_id: device_id, climate_preset_mode: climate_preset_mode, cooling_set_point_celsius: cooling_set_point_celsius, cooling_set_point_fahrenheit: cooling_set_point_fahrenheit, ecobee_metadata: ecobee_metadata, fan_mode_setting: fan_mode_setting, heating_set_point_celsius: heating_set_point_celsius, heating_set_point_fahrenheit: heating_set_point_fahrenheit, hvac_mode_setting: hvac_mode_setting, manual_override_allowed: manual_override_allowed, name: name}.compact)
@@ -88,7 +88,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Sets a specified [thermostat](https://docs.seam.co/capability-guides/thermostats) to [heat-cool ("auto") mode](https://docs.seam.co/capability-guides/thermostats/configure-current-climate-settings).
@@ -103,7 +103,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Returns a list of all [thermostats](https://docs.seam.co/capability-guides/thermostats).
@@ -128,7 +128,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Sets a specified [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets) as the ["fallback"](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets/setting-the-fallback-climate-preset) preset for a specified [thermostat](https://docs.seam.co/capability-guides/thermostats).
@@ -152,7 +152,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Sets the [HVAC mode](https://docs.seam.co/capability-guides/thermostats/configure-current-climate-settings) for a specified [thermostat](https://docs.seam.co/capability-guides/thermostats).
@@ -168,15 +168,15 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Sets a [temperature threshold](https://docs.seam.co/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) for a specified thermostat. Seam emits a `thermostat.temperature_threshold_exceeded` event and adds a warning on a thermostat if it reports a temperature outside the threshold range.
       # @param device_id [String] ID of the thermostat device for which you want to set a temperature threshold.
-      # @param lower_limit_celsius [Float, nil] Lower temperature limit in in °C. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.
-      # @param lower_limit_fahrenheit [Float, nil] Lower temperature limit in in °F. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.
-      # @param upper_limit_celsius [Float, nil] Upper temperature limit in in °C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.
-      # @param upper_limit_fahrenheit [Float, nil] Upper temperature limit in in °C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.
+      # @param lower_limit_celsius [Float, Seam::Null, nil] Lower temperature limit in in °C. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.
+      # @param lower_limit_fahrenheit [Float, Seam::Null, nil] Lower temperature limit in in °F. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.
+      # @param upper_limit_celsius [Float, Seam::Null, nil] Upper temperature limit in in °C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.
+      # @param upper_limit_fahrenheit [Float, Seam::Null, nil] Upper temperature limit in in °C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.
       # @return [nil] OK
       def set_temperature_threshold(device_id:, lower_limit_celsius: nil, lower_limit_fahrenheit: nil, upper_limit_celsius: nil, upper_limit_fahrenheit: nil)
         @client.patch("/thermostats/set_temperature_threshold", {device_id: device_id, lower_limit_celsius: lower_limit_celsius, lower_limit_fahrenheit: lower_limit_fahrenheit, upper_limit_celsius: upper_limit_celsius, upper_limit_fahrenheit: upper_limit_fahrenheit}.compact)
@@ -197,7 +197,7 @@ module Seam
       # @param hvac_mode_setting [String, nil] Desired [HVAC mode](https://docs.seam.co/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.
       # @param manual_override_allowed [Boolean, nil] Indicates whether a person at the thermostat can change the thermostat's settings. See [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
       # @deprecated manual_override_allowed: Use 'thermostat_schedule.is_override_allowed'
-      # @param name [String, nil] User-friendly name to identify the [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets).
+      # @param name [String, Seam::Null, nil] User-friendly name to identify the [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets).
       # @return [nil] OK
       def update_climate_preset(climate_preset_key:, device_id:, climate_preset_mode: nil, cooling_set_point_celsius: nil, cooling_set_point_fahrenheit: nil, ecobee_metadata: nil, fan_mode_setting: nil, heating_set_point_celsius: nil, heating_set_point_fahrenheit: nil, hvac_mode_setting: nil, manual_override_allowed: nil, name: nil)
         @client.patch("/thermostats/update_climate_preset", {climate_preset_key: climate_preset_key, device_id: device_id, climate_preset_mode: climate_preset_mode, cooling_set_point_celsius: cooling_set_point_celsius, cooling_set_point_fahrenheit: cooling_set_point_fahrenheit, ecobee_metadata: ecobee_metadata, fan_mode_setting: fan_mode_setting, heating_set_point_celsius: heating_set_point_celsius, heating_set_point_fahrenheit: heating_set_point_fahrenheit, hvac_mode_setting: hvac_mode_setting, manual_override_allowed: manual_override_allowed, name: name}.compact)
@@ -207,20 +207,20 @@ module Seam
 
       # Updates the thermostat weekly program for a thermostat device. To configure a weekly program, specify the ID of the daily program that you want to use for each day of the week. When you update a weekly program, the set of programs that you specify overwrites any previous weekly program for the thermostat.
       # @param device_id [String] ID of the thermostat device for which you want to update the weekly program.
-      # @param friday_program_id [String, nil] ID of the thermostat daily program to run on Fridays.
-      # @param monday_program_id [String, nil] ID of the thermostat daily program to run on Mondays.
-      # @param saturday_program_id [String, nil] ID of the thermostat daily program to run on Saturdays.
-      # @param sunday_program_id [String, nil] ID of the thermostat daily program to run on Sundays.
-      # @param thursday_program_id [String, nil] ID of the thermostat daily program to run on Thursdays.
-      # @param tuesday_program_id [String, nil] ID of the thermostat daily program to run on Tuesdays.
-      # @param wednesday_program_id [String, nil] ID of the thermostat daily program to run on Wednesdays.
+      # @param friday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Fridays.
+      # @param monday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Mondays.
+      # @param saturday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Saturdays.
+      # @param sunday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Sundays.
+      # @param thursday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Thursdays.
+      # @param tuesday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Tuesdays.
+      # @param wednesday_program_id [String, Seam::Null, nil] ID of the thermostat daily program to run on Wednesdays.
       # @return [Seam::Resources::ActionAttempt] OK
       def update_weekly_program(device_id:, friday_program_id: nil, monday_program_id: nil, saturday_program_id: nil, sunday_program_id: nil, thursday_program_id: nil, tuesday_program_id: nil, wednesday_program_id: nil, wait_for_action_attempt: nil)
         res = @client.post("/thermostats/update_weekly_program", {device_id: device_id, friday_program_id: friday_program_id, monday_program_id: monday_program_id, saturday_program_id: saturday_program_id, sunday_program_id: sunday_program_id, thursday_program_id: thursday_program_id, tuesday_program_id: tuesday_program_id, wednesday_program_id: wednesday_program_id}.compact)
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
     end
   end

data/lib/seam/routes/thermostats_daily_programs.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "seam/helpers/action_attempt"
+require "seam/action_attempt_resolver"
 
 module Seam
   module Clients
@@ -40,7 +40,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
     end
   end

data/lib/seam/routes/thermostats_schedules.rb

@@ -14,7 +14,7 @@ module Seam
       # @param ends_at [String] Date and time at which the new thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
       # @param starts_at [String] Date and time at which the new thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
       # @param is_override_allowed [Boolean, nil] Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the new schedule is active. See also [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
-      # @param max_override_period_minutes [Integer, nil] Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
+      # @param max_override_period_minutes [Integer, Seam::Null, nil] Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
       # @param name [String, nil] Name of the thermostat schedule.
       # @return [Seam::Resources::ThermostatSchedule] OK
       def create(climate_preset_key:, device_id:, ends_at:, starts_at:, is_override_allowed: nil, max_override_period_minutes: nil, name: nil)
@@ -56,7 +56,7 @@ module Seam
       # @param climate_preset_key [String, nil] Key of the [climate preset](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the thermostat schedule.
       # @param ends_at [String, nil] Date and time at which the thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
       # @param is_override_allowed [Boolean, nil] Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the schedule is active. See also [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
-      # @param max_override_period_minutes [Integer, nil] Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
+      # @param max_override_period_minutes [Integer, Seam::Null, nil] Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
       # @param name [String, nil] Name of the thermostat schedule.
       # @param starts_at [String, nil] Date and time at which the thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
       # @return [nil] OK

data/lib/seam/routes/user_identities.rb

@@ -29,10 +29,10 @@ module Seam
 
       # Creates a new [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).
       # @param acs_system_ids [Array<String>, nil] List of access system IDs to associate with the new user identity through access system users. If there's no user with the same email address or phone number in the specified access systems, a new access system user is created. If there is an existing user with the same email or phone number in the specified access systems, the user is linked to the user identity.
-      # @param email_address [String, nil] Unique email address for the new user identity.
-      # @param full_name [String, nil] Full name of the user associated with the new user identity.
-      # @param phone_number [String, nil] Unique phone number for the new user identity in E.164 format (for example, +15555550100).
-      # @param user_identity_key [String, nil] Unique key for the new user identity.
+      # @param email_address [String, Seam::Null, nil] Unique email address for the new user identity.
+      # @param full_name [String, Seam::Null, nil] Full name of the user associated with the new user identity.
+      # @param phone_number [String, Seam::Null, nil] Unique phone number for the new user identity in E.164 format (for example, +15555550100).
+      # @param user_identity_key [String, Seam::Null, nil] Unique key for the new user identity.
       # @return [Seam::Resources::UserIdentity] OK
       def create(acs_system_ids: nil, email_address: nil, full_name: nil, phone_number: nil, user_identity_key: nil)
         res = @client.post("/user_identities/create", {acs_system_ids: acs_system_ids, email_address: email_address, full_name: full_name, phone_number: phone_number, user_identity_key: user_identity_key}.compact)
@@ -88,7 +88,7 @@ module Seam
       # @param created_before [Time, nil] Timestamp by which to limit returned user identities. Returns user identities created before this timestamp.
       # @param credential_manager_acs_system_id [String, nil] `acs_system_id` of the credential manager by which you want to filter the list of user identities.
       # @param limit [Integer, nil] Maximum number of records to return per page.
-      # @param page_cursor [String, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param page_cursor [String, Seam::Null, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
       # @param search [String, nil] String for which to search. Filters returned user identities to include all records that satisfy a partial match using `full_name`, `phone_number`, `email_address` or `user_identity_id`.
       # @param user_identity_ids [Array<String>, nil] Array of user identity IDs by which to filter the list of user identities.
       # @return [Seam::Resources::UserIdentity] OK
@@ -156,10 +156,10 @@ module Seam
 
       # Updates a specified [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).
       # @param user_identity_id [String] ID of the user identity that you want to update.
-      # @param email_address [String, nil] Unique email address for the user identity.
-      # @param full_name [String, nil] Full name of the user associated with the user identity.
-      # @param phone_number [String, nil] Unique phone number for the user identity.
-      # @param user_identity_key [String, nil] Unique key for the user identity.
+      # @param email_address [String, Seam::Null, nil] Unique email address for the user identity.
+      # @param full_name [String, Seam::Null, nil] Full name of the user associated with the user identity.
+      # @param phone_number [String, Seam::Null, nil] Unique phone number for the user identity.
+      # @param user_identity_key [String, Seam::Null, nil] Unique key for the user identity.
       # @return [nil] OK
       def update(user_identity_id:, email_address: nil, full_name: nil, phone_number: nil, user_identity_key: nil)
         @client.patch("/user_identities/update", {user_identity_id: user_identity_id, email_address: email_address, full_name: full_name, phone_number: phone_number, user_identity_key: user_identity_key}.compact)

data/lib/seam/routes/user_identities_unmanaged.rb

@@ -20,7 +20,7 @@ module Seam
       # Returns a list of all unmanaged [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) (where is_managed = false).
       # @param created_before [Time, nil] Timestamp by which to limit returned unmanaged user identities. Returns user identities created before this timestamp.
       # @param limit [Integer, nil] Maximum number of records to return per page.
-      # @param page_cursor [String, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param page_cursor [String, Seam::Null, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
       # @param search [String, nil] String for which to search. Filters returned unmanaged user identities to include all records that satisfy a partial match using `full_name`, `phone_number`, `email_address`,  `user_identity_id` or `acs_system_id`.
       # @return [Seam::Resources::UnmanagedUserIdentity] OK
       def list(created_before: nil, limit: nil, page_cursor: nil, search: nil)

data/lib/seam/routes/workspaces.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "seam/helpers/action_attempt"
+require "seam/action_attempt_resolver"
 
 module Seam
   module Clients
@@ -13,7 +13,7 @@ module Seam
       # Creates a new [workspace](https://docs.seam.co/core-concepts/workspaces).
       # @param name [String] Name of the new workspace.
       # @param company_name [String, nil] Company name for the new workspace.
-      # @param connect_partner_name [String, nil] Connect partner name for the new workspace.
+      # @param connect_partner_name [String, Seam::Null, nil] Connect partner name for the new workspace.
       # @deprecated connect_partner_name: Use `company_name` instead.
       # @param connect_webview_customization [Hash, nil] [Connect Webview](https://docs.seam.co/core-concepts/connect-webviews) customizations for the new workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).
       # @param is_sandbox [Boolean, nil] Indicates whether the new workspace is a [sandbox workspace](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces).
@@ -56,7 +56,7 @@ module Seam
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
-        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+        Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
       # Updates the [workspace](https://docs.seam.co/core-concepts/workspaces) associated with the authentication value.

data/lib/seam/strict_url_search_params_serializer.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "url_search_params_serializer"
+
+# Strict serialization, used by the SDK itself: _strict=true is added to any
+# non-empty query so the Seam API uses strict, schema-aware parsing.
+module Seam
+  # (see UrlSearchParamsSerializer.serialize_url_search_params)
+  def self.serialize_url_search_params(params)
+    UrlSearchParamsSerializer.serialize_url_search_params(params, strict: true)
+  end
+
+  # (see UrlSearchParamsSerializer.update_url_search_params)
+  def self.update_url_search_params(search_params, params)
+    UrlSearchParamsSerializer.update_url_search_params(search_params, params, strict: true)
+  end
+end

data/lib/seam/url_search_params.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module Seam
+  # A mutable, ordered list of name/value string pairs modeling the parts of
+  # the WHATWG URLSearchParams interface that the Seam URL search params
+  # serializer needs.
+  class UrlSearchParams
+    include Enumerable
+
+    # @param init [String, Hash, Enumerable, nil]
+    def initialize(init = nil)
+      @pairs = []
+      return if init.nil?
+
+      case init
+      when String
+        query = init.delete_prefix("?")
+        URI.decode_www_form(query).each { |name, value| append(name, value) } unless query.empty?
+      when Hash
+        init.each { |name, value| append(name, value) }
+      else
+        init.each { |name, value| append(name, value) }
+      end
+    end
+
+    def append(name, value)
+      @pairs << [name.to_s, value.to_s]
+      nil
+    end
+
+    def set(name, value)
+      name = name.to_s
+      replaced = false
+      @pairs = @pairs.filter_map do |pair|
+        next pair unless pair.first == name
+        next nil if replaced
+
+        replaced = true
+        [name, value.to_s]
+      end
+      append(name, value) unless replaced
+      nil
+    end
+
+    def get(name)
+      name = name.to_s
+      @pairs.each { |pair_name, value| return value if pair_name == name }
+      nil
+    end
+
+    def get_all(name)
+      name = name.to_s
+      @pairs.filter_map { |pair_name, value| value if pair_name == name }
+    end
+
+    def has?(name)
+      name = name.to_s
+      @pairs.any? { |pair_name, _| pair_name == name }
+    end
+
+    def delete(name)
+      name = name.to_s
+      @pairs.reject! { |pair_name, _| pair_name == name }
+      nil
+    end
+
+    def sort!
+      @pairs = @pairs.each_with_index.sort_by do |(name, _), index|
+        [name.encode(Encoding::UTF_16BE).b, index]
+      end.map(&:first)
+      nil
+    end
+
+    def each(&block)
+      return @pairs.each unless block
+
+      @pairs.each(&block)
+      self
+    end
+
+    def size
+      @pairs.size
+    end
+    alias_method :length, :size
+
+    def empty?
+      @pairs.empty?
+    end
+
+    def to_s
+      @pairs.map do |name, value|
+        "#{self.class.encode_component(name)}=#{self.class.encode_component(value)}"
+      end.join("&")
+    end
+
+    def self.encode_component(string)
+      URI.encode_www_form_component(string.encode(Encoding::UTF_8))
+    end
+  end
+end

data/lib/seam/url_search_params_serializer.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+require "date"
+
+require_relative "null"
+require_relative "url_search_params"
+
+module Seam
+  class UnserializableParamError < StandardError
+    attr_reader :param_name
+
+    def initialize(param_name, reason)
+      @param_name = param_name
+      super("Could not serialize parameter: '#{param_name}' #{reason}")
+    end
+  end
+
+  def self.replace_null(value)
+    case value
+    when Seam::Null then nil
+    when Hash then value.transform_values { |v| replace_null(v) }
+    when Array then value.map { |v| replace_null(v) }
+    else value
+    end
+  end
+
+  # Serializes parameters to a URL query string following the
+  # @seamapi/url-search-params-serializer standard:
+  # https://github.com/seamapi/url-search-params-serializer
+  module UrlSearchParamsSerializer
+    # @param params [Hash]
+    # @param strict [Boolean] Whether to add +_strict=true+ to a non-empty
+    #   query string
+    # @return [String] The query string, without a leading +?+
+    # @raise [UnserializableParamError]
+    def self.serialize_url_search_params(params, strict: false)
+      search_params = UrlSearchParams.new
+      update_url_search_params(search_params, params, strict: strict)
+      search_params.to_s
+    end
+
+    # Serializes parameters into an existing {UrlSearchParams} collection,
+    # preserving pairs it does not overwrite.
+    #
+    # @param search_params [UrlSearchParams]
+    # @param params [Hash]
+    # @param strict [Boolean] Whether to add +_strict=true+ when the
+    #   resulting collection is non-empty
+    # @return [nil]
+    # @raise [UnserializableParamError]
+    def self.update_url_search_params(search_params, params, strict: false)
+      nested_update(search_params, params, [])
+      search_params.sort!
+
+      if strict && !search_params.empty?
+        search_params.delete("_strict")
+        search_params.append("_strict", "true")
+      end
+
+      nil
+    end
+
+    def self.nested_update(search_params, params, path)
+      params.each do |key, value|
+        unless key.is_a?(String) || key.is_a?(Symbol)
+          raise UnserializableParamError.new(
+            key.inspect,
+            "has a name that is not a string which is unsupported"
+          )
+        end
+        key = key.to_s
+
+        if key.include?(".")
+          raise UnserializableParamError.new(
+            key,
+            'contains one or more dots "." in its name which is unsupported'
+          )
+        end
+
+        current_path = [*path, key]
+
+        if value.is_a?(Hash)
+          nested_update(search_params, value, current_path)
+          next
+        end
+
+        name = current_path.join(".")
+
+        next if value.nil?
+
+        value = value.to_s if value.is_a?(Symbol)
+
+        next if value.is_a?(String) && value.empty?
+
+        if value.is_a?(Array)
+          serialize_array(search_params, name, value)
+          next
+        end
+
+        search_params.set(name, serialize_value(name, value))
+      end
+    end
+
+    def self.serialize_array(search_params, name, values)
+      # The parser reads a single pair with an empty value as an empty array.
+      if values.empty?
+        search_params.set(name, "")
+        return
+      end
+
+      values = values.map { |value| value.is_a?(Symbol) ? value.to_s : value }
+
+      if values.length == 1 && values.first == ""
+        raise UnserializableParamError.new(
+          name,
+          "is a single element array containing the empty string which is unsupported"
+        )
+      end
+
+      if values.any? { |value| value == "" }
+        raise UnserializableParamError.new(
+          name,
+          "is an array containing the empty string which is unsupported"
+        )
+      end
+
+      if values.any? { |value| value.nil? || value.is_a?(Seam::Null) }
+        raise UnserializableParamError.new(
+          name,
+          "is an array containing null or undefined values which is unsupported"
+        )
+      end
+
+      values.each { |value| search_params.append(name, serialize_value(name, value)) }
+    end
+
+    def self.serialize_value(name, value)
+      case value
+      when Seam::Null then ""
+      when String then value
+      when true, false then value.to_s
+      when Integer then value.to_s
+      when Float then serialize_float(name, value)
+      when Time then serialize_time(value)
+      when DateTime then serialize_time(value.to_time)
+      when Date then serialize_time(Time.utc(value.year, value.month, value.day))
+      else
+        raise UnserializableParamError.new(name, "is a #{value.class}")
+      end
+    end
+
+    # Formats a float exactly like ECMAScript Number::toString.
+    def self.serialize_float(name, value)
+      raise UnserializableParamError.new(name, "is NaN") if value.nan?
+      if value.infinite?
+        raise UnserializableParamError.new(name, "is #{value.positive? ? "Infinity" : "-Infinity"}")
+      end
+      return "0" if value.zero?
+
+      digits, point = shortest_decimal(value.abs)
+      count = digits.length
+
+      formatted = if point.between?(count, 21)
+        digits + "0" * (point - count)
+      elsif point.positive? && point <= 21
+        "#{digits[0, point]}.#{digits[point..]}"
+      elsif point > -6 && point <= 0
+        "0.#{"0" * -point}#{digits}"
+      else
+        mantissa = (count == 1) ? digits : "#{digits[0]}.#{digits[1..]}"
+        exponent = point - 1
+        "#{mantissa}e#{(exponent >= 0) ? "+" : "-"}#{exponent.abs}"
+      end
+
+      value.negative? ? "-#{formatted}" : formatted
+    end
+
+    # Returns the shortest round-tripping decimal digits of a positive float
+    # and the position of the decimal point relative to the first digit.
+    def self.shortest_decimal(value)
+      repr = value.to_s
+
+      if repr.include?("e")
+        mantissa, exponent = repr.split("e")
+        integer_part, fraction_part = mantissa.split(".")
+        digits = integer_part + (fraction_part || "")
+        point = integer_part.length + exponent.to_i
+      else
+        integer_part, fraction_part = repr.split(".")
+        digits = integer_part + (fraction_part || "")
+        point = integer_part.length
+      end
+
+      leading_zeros = digits[/\A0*/].length
+      digits = digits[leading_zeros..]
+      point -= leading_zeros
+
+      [digits.sub(/0+\z/, ""), point]
+    end
+
+    # Formats a time exactly like JavaScript's Date#toISOString.
+    def self.serialize_time(time)
+      utc = time.getutc
+      year = if utc.year.between?(0, 9999)
+        format("%04d", utc.year)
+      elsif utc.year > 9999
+        format("+%06d", utc.year)
+      else
+        format("-%06d", -utc.year)
+      end
+      format(
+        "%s-%02d-%02dT%02d:%02d:%02d.%03dZ",
+        year, utc.month, utc.day, utc.hour, utc.min, utc.sec, utc.nsec / 1_000_000
+      )
+    end
+  end
+end

data/lib/seam/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Seam
-  VERSION = "2.140.0"
+  VERSION = "2.141.1"
 end

data/lib/seam.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative "seam/null"
+require_relative "seam/url_search_params"
+require_relative "seam/strict_url_search_params_serializer"
 require_relative "seam/http"
 require_relative "seam/http_without_workspace"
 require_relative "seam/webhook"