seam 2.164.0 → 2.166.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29b629f49ba1b506fe148294d4847134e07fec1cc84b75ab4308a72260dfc245
-  data.tar.gz: 2d8ad86b113c0791a9558a84d8fd38561b8be20f2b89a2df6a3ee4bd606d4200
+  metadata.gz: 5a1766e6be523652f696d57db1da959002d72ffb446a531a0fc55a75e1a77d0d
+  data.tar.gz: 80591311035a9fde297bbd39e15f1c8d87685c9b3f2e117349d525476bc7c776
 SHA512:
-  metadata.gz: 1971e10d29dec2cd3586a9cb4ea46695057ad9c39fae07ef766438b38abf5c1cd705ba48458c3d06cb44570553a0e3a87eb2650091d34f7ae5ffb1c505135d96
-  data.tar.gz: 3ea56b8dd69b13a194a0e6b93edd5a45e5561d250189c6267fbbdd9d93fa0b9e4b9c1291d4153d066036ac6ca399a91c68861a438da38dc1da643f41ab53d904
+  metadata.gz: 0a911571db84e8e849bd2e5e7d20234fffadebdba4e116759e6a44a741e1ac607bd4631f7071df457e2cce8f75259b82191c7bb8a1a60a7d7e5caa0fccc57c50
+  data.tar.gz: 1eb9b6a9e35557ea83a9547e8a1349df079dbe60d74de7ba29ac17fc9ce67f03216b6a22be8db575d52ac4eef44ceb60f02d9e22e5aada590b2e84dc5db29fe8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    seam (2.164.0)
+    seam (2.166.0)
       faraday (~> 2.7)
       faraday-retry (~> 2.2)
       svix (~> 1.30)
@@ -171,7 +171,7 @@ CHECKSUMS
   rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db
   rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
-  seam (2.164.0)
+  seam (2.166.0)
   simplecov (1.1.1) sha256=25825ef13f0b2e74694d769817dad6ab8e90131dabdaa666e522fea105521e78
   simplecov-console (0.9.5) sha256=b1108bcfff5f210143e2b8301698c367b01586f20d25a73e95475a5df6fc6ff6
   standard (1.56.0) sha256=ae2af4d9669589162ac69ed5ef59dcf9f346d4afc81f7e62b84339310dfcb787

data/lib/seam/resources/access_grant.rb

@@ -169,8 +169,10 @@ module Seam
             # Device whose access code could not be revoked.
             # @return [String]
             attr_accessor :device_id
-            # Reason the access code could not be revoked (e.g. `offline_access_code_not_revocable`).
+            # Reason the access code could not be revoked.
             # @return [String]
+            # Known values:
+            # - `offline_access_code_not_revocable`
             attr_accessor :error_code
             # Human-readable description of why revocation failed.
             # @return [String]
@@ -211,10 +213,13 @@ module Seam
           date_accessor :created_at
         end
 
-        # Indicates that the requested PIN code was already in use on a device, so a different code was assigned.
+        # Indicates that the requested PIN code could not be used, so a different code was assigned. For example, the code was already in use on a device, or the access system rejected it because it did not meet its PIN rules.
         class RequestedCodeUnavailable < Warnings
-          # ID of the device where the requested code was unavailable.
-          # @return [String]
+          # ID of the access method whose requested code was unavailable. Present when an access system, such as Salto KS, assigned a different code.
+          # @return [String, nil]
+          attr_accessor :access_method_id
+          # ID of the device where the requested code was unavailable. Present when the code was set directly on a device.
+          # @return [String, nil]
           attr_accessor :device_id
           # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
           # @return [String]

data/lib/seam/resources/access_method.rb

@@ -189,6 +189,27 @@ module Seam
           date_accessor :created_at
         end
 
+        # Indicates that the access system could not use the PIN code requested for this [access method](https://www.seam.co/docs/use-cases/granting-access/creating-an-access-grant), for example because it did not meet the access system's PIN rules, so the access system assigned a different code. Give the recipient the assigned code.
+        class RequestedCodeUnavailable < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # The PIN code that was assigned instead.
+          # @return [String]
+          attr_accessor :new_code
+          # The originally requested PIN code that could not be used.
+          # @return [String]
+          attr_accessor :original_code
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `requested_code_unavailable`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
         # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
         # @return [String]
         attr_accessor :message
@@ -201,6 +222,7 @@ module Seam
         # - `delay_in_issuing`
         # - `user_identity_missing_email_address`
         # - `user_identity_missing_phone_number`
+        # - `requested_code_unavailable`
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
         # @return [Time]
@@ -212,7 +234,8 @@ module Seam
           "pulled_backup_access_code" => PulledBackupAccessCode,
           "delay_in_issuing" => DelayInIssuing,
           "user_identity_missing_email_address" => UserIdentityMissingEmailAddress,
-          "user_identity_missing_phone_number" => UserIdentityMissingPhoneNumber
+          "user_identity_missing_phone_number" => UserIdentityMissingPhoneNumber,
+          "requested_code_unavailable" => RequestedCodeUnavailable
         }.freeze
       end
 
@@ -258,7 +281,7 @@ module Seam
       # Indicates whether the access method is ready for card assignment. This is true when the access method is in card mode, has not yet been issued, and the system supports credential assignment.
       # @return [Boolean, nil]
       attr_accessor :is_ready_for_assignment
-      # Indicates whether the access method is ready to be encoded. This is true when the credential has been created and the card has not yet been issued.
+      # Indicates whether the access method is ready to be encoded. This is true when the card has not yet been issued and the access system has received all the access the card needs. While it is false, `pending_mutations` contains `waiting_for_access_on_acs_system`.
       # @return [Boolean, nil]
       attr_accessor :is_ready_for_encoding
       # Access method mode. Supported values: `code`, `card`, `mobile_key`, `cloud_key`.

data/lib/seam/resources/acs_entrance.rb

@@ -101,9 +101,27 @@ module Seam
         attr_accessor :access_point_profile
       end
 
+      # Known `error_code` values load as subclasses; unknown values remain Errors instances for forward compatibility.
       class Errors < BaseResource
+        # Indicates that the [entrance](https://www.seam.co/docs/low-level-apis/access-systems/retrieving-entrance-details) was removed from the connected account, so Seam can no longer sync it.
+        class EntranceRemoved < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `entrance_removed`
+          attr_accessor :error_code
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `entrance_removed`
         attr_accessor :error_code
         # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
         # @return [String]
@@ -111,6 +129,10 @@ module Seam
         # Date and time at which Seam created the error.
         # @return [Time]
         date_accessor :created_at
+
+        discriminated_by :error_code, {
+          "entrance_removed" => EntranceRemoved
+        }.freeze
       end
 
       class HotekMetadata < BaseResource

data/lib/seam/resources/acs_system.rb

@@ -78,6 +78,21 @@ module Seam
           date_accessor :created_at
         end
 
+        # Indicates that the access control system has reached the maximum number of users its license allows, so Seam cannot create new users on it and access for new guests is not provisioned. Remove unused users from the access control system or increase its license. The error clears once Seam can create users again.
+        class UserLicenseLimitReached < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `user_license_limit_reached`
+          attr_accessor :error_code
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
         # Indicates that the provider's system backing this [access control system](https://www.seam.co/docs/low-level-apis/access-systems) is not letting Seam act on it, so access cannot be managed until this is resolved. The error message says which of two causes applies. Either Seam's integration user does not have sufficient permissions on the provider's system, or has been suspended there: grant the integration user the required permissions in the provider's system, or reauthorize the connected account in Seam. Or the provider account or site does not have a valid subscription with the provider: set up or renew that subscription with the provider.
         class InsufficientPermissions < Errors
           # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
@@ -160,6 +175,7 @@ module Seam
         # - `bridge_disconnected`
         # - `visionline_instance_unreachable`
         # - `salto_ks_subscription_limit_exceeded`
+        # - `user_license_limit_reached`
         # - `insufficient_permissions`
         # - `acs_system_disconnected`
         # - `account_disconnected`
@@ -178,6 +194,7 @@ module Seam
           "bridge_disconnected" => BridgeDisconnected,
           "visionline_instance_unreachable" => VisionlineInstanceUnreachable,
           "salto_ks_subscription_limit_exceeded" => SaltoKsSubscriptionLimitExceeded,
+          "user_license_limit_reached" => UserLicenseLimitReached,
           "insufficient_permissions" => InsufficientPermissions,
           "acs_system_disconnected" => AcsSystemDisconnected,
           "account_disconnected" => AccountDisconnected,

data/lib/seam/resources/action_attempt.rb

@@ -974,20 +974,21 @@ module Seam
             end
 
             # Previous access time configuration.
-            # @return [From]
+            # @return [From, nil]
             resource_accessor :from, From
             # New access time configuration.
-            # @return [To]
+            # @return [To, nil]
             resource_accessor :to, To
             # Detailed description of the mutation.
             # @return [String]
             attr_accessor :message
-            # Mutation code to indicate that Seam is in the process of updating the access times for this access method.
+            # Mutation code to indicate that the access system has not yet received all the access this card needs, so the card is not ready to be encoded.
             # @return [String]
             # Known values:
             # - `provisioning_access`
             # - `revoking_access`
             # - `updating_access_times`
+            # - `waiting_for_access_on_acs_system`
             attr_accessor :mutation_code
             # Date and time at which the mutation was created.
             # @return [Time]
@@ -1007,10 +1008,17 @@ module Seam
             # - `delay_in_issuing`
             # - `user_identity_missing_email_address`
             # - `user_identity_missing_phone_number`
+            # - `requested_code_unavailable`
             attr_accessor :warning_code
             # ID of the original access method from which this backup access method was split, if applicable.
             # @return [String, nil]
             attr_accessor :original_access_method_id
+            # The PIN code that was assigned instead.
+            # @return [String, nil]
+            attr_accessor :new_code
+            # The originally requested PIN code that could not be used.
+            # @return [String, nil]
+            attr_accessor :original_code
             # Date and time at which Seam created the warning.
             # @return [Time]
             date_accessor :created_at
@@ -1058,7 +1066,7 @@ module Seam
           # Indicates whether the access method is ready for card assignment. This is true when the access method is in card mode, has not yet been issued, and the system supports credential assignment.
           # @return [Boolean, nil]
           attr_accessor :is_ready_for_assignment
-          # Indicates whether the access method is ready to be encoded. This is true when the credential has been created and the card has not yet been issued.
+          # Indicates whether the access method is ready to be encoded. This is true when the card has not yet been issued and the access system has received all the access the card needs. While it is false, `pending_mutations` contains `waiting_for_access_on_acs_system`.
           # @return [Boolean, nil]
           attr_accessor :is_ready_for_encoding
           # Access method mode. Supported values: `code`, `card`, `mobile_key`, `cloud_key`.
@@ -1505,6 +1513,212 @@ module Seam
         attr_accessor :status
       end
 
+      # Setting the speaker volume is pending.
+      class SetSpeakerVolume < ActionAttempt
+        class Error < BaseResource
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Type of the error.
+          # @return [String]
+          attr_accessor :type
+        end
+
+        class Result < BaseResource
+        end
+
+        # Error associated with the action.
+        # @return [Error, nil]
+        # Only present when `status` is `error`; `nil` otherwise.
+        resource_accessor :error, Error
+        available_only_for_statuses :error, ["error"]
+        # Result of the action.
+        # @return [Result, nil]
+        # Only present when `status` is `success`; `nil` otherwise.
+        resource_accessor :result, Result
+        available_only_for_statuses :result, ["success"]
+        # ID of the action attempt.
+        # @return [String]
+        attr_accessor :action_attempt_id
+        # Action attempt to track the status of setting the volume on a speaker.
+        # @return [String]
+        # Known values:
+        # - `SET_SPEAKER_VOLUME`
+        attr_accessor :action_type
+        # @return [String]
+        # Known values:
+        # - `success`
+        # - `pending`
+        # - `error`
+        attr_accessor :status
+      end
+
+      # Muting or unmuting the speaker is pending.
+      class SetSpeakerMute < ActionAttempt
+        class Error < BaseResource
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Type of the error.
+          # @return [String]
+          attr_accessor :type
+        end
+
+        class Result < BaseResource
+        end
+
+        # Error associated with the action.
+        # @return [Error, nil]
+        # Only present when `status` is `error`; `nil` otherwise.
+        resource_accessor :error, Error
+        available_only_for_statuses :error, ["error"]
+        # Result of the action.
+        # @return [Result, nil]
+        # Only present when `status` is `success`; `nil` otherwise.
+        resource_accessor :result, Result
+        available_only_for_statuses :result, ["success"]
+        # ID of the action attempt.
+        # @return [String]
+        attr_accessor :action_attempt_id
+        # Action attempt to track the status of muting or unmuting a speaker.
+        # @return [String]
+        # Known values:
+        # - `SET_SPEAKER_MUTE`
+        attr_accessor :action_type
+        # @return [String]
+        # Known values:
+        # - `success`
+        # - `pending`
+        # - `error`
+        attr_accessor :status
+      end
+
+      # Pausing playback on the speaker is pending.
+      class PauseSpeakerPlayback < ActionAttempt
+        class Error < BaseResource
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Type of the error.
+          # @return [String]
+          attr_accessor :type
+        end
+
+        class Result < BaseResource
+          # IDs of the speakers whose playback was paused, including speakers grouped with the requested speaker.
+          # @return [Array<String>]
+          attr_accessor :affected_device_ids
+        end
+
+        # Error associated with the action.
+        # @return [Error, nil]
+        # Only present when `status` is `error`; `nil` otherwise.
+        resource_accessor :error, Error
+        available_only_for_statuses :error, ["error"]
+        # Result of the action.
+        # @return [Result, nil]
+        # Only present when `status` is `success`; `nil` otherwise.
+        resource_accessor :result, Result
+        available_only_for_statuses :result, ["success"]
+        # ID of the action attempt.
+        # @return [String]
+        attr_accessor :action_attempt_id
+        # Action attempt to track the status of pausing playback on a speaker.
+        # @return [String]
+        # Known values:
+        # - `PAUSE_SPEAKER_PLAYBACK`
+        attr_accessor :action_type
+        # @return [String]
+        # Known values:
+        # - `success`
+        # - `pending`
+        # - `error`
+        attr_accessor :status
+      end
+
+      # Resuming playback on the speaker is pending.
+      class ResumeSpeakerPlayback < ActionAttempt
+        class Error < BaseResource
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Type of the error.
+          # @return [String]
+          attr_accessor :type
+        end
+
+        class Result < BaseResource
+          # IDs of the speakers whose playback was resumed, including speakers grouped with the requested speaker.
+          # @return [Array<String>]
+          attr_accessor :affected_device_ids
+        end
+
+        # Error associated with the action.
+        # @return [Error, nil]
+        # Only present when `status` is `error`; `nil` otherwise.
+        resource_accessor :error, Error
+        available_only_for_statuses :error, ["error"]
+        # Result of the action.
+        # @return [Result, nil]
+        # Only present when `status` is `success`; `nil` otherwise.
+        resource_accessor :result, Result
+        available_only_for_statuses :result, ["success"]
+        # ID of the action attempt.
+        # @return [String]
+        attr_accessor :action_attempt_id
+        # Action attempt to track the status of resuming playback on a speaker.
+        # @return [String]
+        # Known values:
+        # - `RESUME_SPEAKER_PLAYBACK`
+        attr_accessor :action_type
+        # @return [String]
+        # Known values:
+        # - `success`
+        # - `pending`
+        # - `error`
+        attr_accessor :status
+      end
+
+      # Playing a chime on the speaker is pending.
+      class PlaySpeakerChime < ActionAttempt
+        class Error < BaseResource
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Type of the error.
+          # @return [String]
+          attr_accessor :type
+        end
+
+        class Result < BaseResource
+        end
+
+        # Error associated with the action.
+        # @return [Error, nil]
+        # Only present when `status` is `error`; `nil` otherwise.
+        resource_accessor :error, Error
+        available_only_for_statuses :error, ["error"]
+        # Result of the action.
+        # @return [Result, nil]
+        # Only present when `status` is `success`; `nil` otherwise.
+        resource_accessor :result, Result
+        available_only_for_statuses :result, ["success"]
+        # ID of the action attempt.
+        # @return [String]
+        attr_accessor :action_attempt_id
+        # Action attempt to track the status of playing a chime on a speaker.
+        # @return [String]
+        # Known values:
+        # - `PLAY_SPEAKER_CHIME`
+        attr_accessor :action_type
+        # @return [String]
+        # Known values:
+        # - `success`
+        # - `pending`
+        # - `error`
+        attr_accessor :status
+      end
+
       class SyncAccessCodes < ActionAttempt
         class Error < BaseResource
           # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
@@ -1819,6 +2033,11 @@ module Seam
       # - `PUSH_THERMOSTAT_PROGRAMS`
       # - `CONFIGURE_AUTO_LOCK`
       # - `CONVERT_ACCESS_CODE_TO_MANAGED`
+      # - `SET_SPEAKER_VOLUME`
+      # - `SET_SPEAKER_MUTE`
+      # - `PAUSE_SPEAKER_PLAYBACK`
+      # - `RESUME_SPEAKER_PLAYBACK`
+      # - `PLAY_SPEAKER_CHIME`
       # - `SYNC_ACCESS_CODES`
       # - `CREATE_ACCESS_CODE`
       # - `DELETE_ACCESS_CODE`
@@ -1851,6 +2070,11 @@ module Seam
         "PUSH_THERMOSTAT_PROGRAMS" => PushThermostatPrograms,
         "CONFIGURE_AUTO_LOCK" => ConfigureAutoLock,
         "CONVERT_ACCESS_CODE_TO_MANAGED" => ConvertAccessCodeToManaged,
+        "SET_SPEAKER_VOLUME" => SetSpeakerVolume,
+        "SET_SPEAKER_MUTE" => SetSpeakerMute,
+        "PAUSE_SPEAKER_PLAYBACK" => PauseSpeakerPlayback,
+        "RESUME_SPEAKER_PLAYBACK" => ResumeSpeakerPlayback,
+        "PLAY_SPEAKER_CHIME" => PlaySpeakerChime,
         "SYNC_ACCESS_CODES" => SyncAccessCodes,
         "CREATE_ACCESS_CODE" => CreateAccessCode,
         "DELETE_ACCESS_CODE" => DeleteAccessCode,

data/lib/seam/resources/connect_webview.rb

@@ -22,6 +22,7 @@ module Seam
       # - `noise_sensor`
       # - `access_control`
       # - `camera`
+      # - `speaker`
       attr_accessor :accepted_capabilities
       # List of accepted [provider keys](https://www.seam.co/docs/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-brands-to-display-in-your-connect-webviews).
       # @return [Array<String>]

data/lib/seam/resources/connected_account.rb

@@ -355,6 +355,7 @@ module Seam
       # - `noise_sensor`
       # - `access_control`
       # - `camera`
+      # - `speaker`
       attr_accessor :accepted_capabilities
       # Type of connected account.
       # @return [String, nil]

data/lib/seam/resources/device.rb

@@ -1135,7 +1135,7 @@ module Seam
           # Device name for a Sensi device.
           # @return [String, nil]
           attr_accessor :device_name
-          # Set to true when the device does not support the /dual-setpoints API endpoint.
+          # Deprecated. Seam no longer sets this field.
           # @return [Boolean, nil]
           attr_accessor :dual_setpoints_not_supported
           # Product type for a Sensi device.
@@ -1158,6 +1158,30 @@ module Seam
           attr_accessor :model
         end
 
+        class SonosMetadata < BaseResource
+          # Models of the speakers bonded to this speaker, such as surrounds or a subwoofer.
+          # @return [Array<String>]
+          attr_accessor :bonded_member_models
+          # Color of the speaker, as reported by Sonos.
+          # @return [String, nil]
+          attr_accessor :color
+          # ID of the Sonos household that the speaker belongs to.
+          # @return [String, nil]
+          attr_accessor :household_id
+          # Model name of the speaker, as reported by Sonos.
+          # @return [String, nil]
+          attr_accessor :model_display_name
+          # ID of the Sonos player for the speaker.
+          # @return [String, nil]
+          attr_accessor :player_id
+          # Name of the speaker, as set in the Sonos app.
+          # @return [String, nil]
+          attr_accessor :player_name
+          # Software version running on the speaker.
+          # @return [String, nil]
+          attr_accessor :software_version
+        end
+
         class TadoMetadata < BaseResource
           # Device type for a tado° device.
           # @return [String, nil]
@@ -1442,6 +1466,60 @@ module Seam
           attr_accessor :time_zone
         end
 
+        class Speaker < BaseResource
+          class NowPlaying < BaseResource
+            # Album of the content that is currently playing.
+            # @return [String, nil]
+            attr_accessor :album
+            # Artist of the content that is currently playing.
+            # @return [String, nil]
+            attr_accessor :artist
+            # Title of the content that is currently playing.
+            # @return [String, nil]
+            attr_accessor :title
+          end
+
+          # Content that is currently playing on the speaker.
+          # @return [NowPlaying, nil]
+          resource_accessor :now_playing, NowPlaying
+          # IDs of the other speakers that are currently grouped with this speaker. Pausing or resuming playback on a speaker also affects the speakers in its group.
+          # @return [Array<String>]
+          attr_accessor :grouped_with_device_ids
+          # Indicates whether the speaker's volume is fixed, for example, because the speaker's line-out level is controlled by an external amplifier. A speaker with a fixed volume cannot have its volume set through Seam.
+          # @return [Boolean]
+          attr_accessor :has_fixed_volume
+          # Indicates whether the speaker is muted.
+          # @return [Boolean]
+          attr_accessor :is_muted
+          # Maximum volume that you can set on the speaker. This is the ceiling of the speaker's native volume scale, not a limit configured for guests.
+          # @return [Float]
+          attr_accessor :max_volume
+          # Minimum volume that you can set on the speaker.
+          # @return [Float]
+          attr_accessor :min_volume
+          # Playback state of the speaker.
+          # @return [String]
+          # Known values:
+          # - `playing`
+          # - `paused`
+          # - `idle`
+          # - `buffering`
+          # - `unknown`
+          attr_accessor :playback_state
+          # Indicates whether the speaker can play a chime.
+          # @return [Boolean]
+          attr_accessor :supports_chime
+          # Current volume of the speaker, on the speaker's native volume scale from `min_volume` to `max_volume`. This is the native volume setting, not a decibel level.
+          # @return [Float]
+          attr_accessor :volume
+          # Increment between the volume values that you can set on the speaker.
+          # @return [Float]
+          attr_accessor :volume_step
+          # Date and time at which the speaker first reported its current volume.
+          # @return [Time, nil]
+          date_accessor :volume_reported_at
+        end
+
         class ActiveThermostatSchedule < BaseResource
           class Errors < BaseResource
             # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
@@ -1925,6 +2003,9 @@ module Seam
         # Metadata for a SmartThings device.
         # @return [SmartthingsMetadata, nil]
         resource_accessor :smartthings_metadata, SmartthingsMetadata
+        # Metadata for a Sonos speaker.
+        # @return [SonosMetadata, nil]
+        resource_accessor :sonos_metadata, SonosMetadata
         # Metadata for a tado° device.
         # @return [TadoMetadata, nil]
         resource_accessor :tado_metadata, TadoMetadata
@@ -1955,6 +2036,9 @@ module Seam
         # Keypad battery status.
         # @return [KeypadBattery, nil]
         resource_accessor :keypad_battery, KeypadBattery
+        # Audio state and capabilities of the speaker.
+        # @return [Speaker, nil]
+        resource_accessor :speaker, Speaker
         # Active [thermostat schedule](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
         # @return [ActiveThermostatSchedule, nil]
         resource_accessor :active_thermostat_schedule, ActiveThermostatSchedule
@@ -2689,6 +2773,15 @@ module Seam
       # Indicates whether the thermostat supports simultaneous heating and cooling.
       # @return [Boolean, nil]
       attr_accessor :can_hvac_heat_cool
+      # Indicates whether the speaker supports muting and unmuting.
+      # @return [Boolean, nil]
+      attr_accessor :can_mute_speaker
+      # Indicates whether the speaker supports pausing and resuming playback.
+      # @return [Boolean, nil]
+      attr_accessor :can_pause_speaker_playback
+      # Indicates whether the speaker supports playing a chime.
+      # @return [Boolean, nil]
+      attr_accessor :can_play_speaker_chime
       # Indicates whether the device supports programming offline access codes.
       # @return [Boolean, nil]
       attr_accessor :can_program_offline_access_codes
@@ -2713,6 +2806,9 @@ module Seam
       # Indicates whether the thermostat supports running climate programs.
       # @return [Boolean, nil]
       attr_accessor :can_run_thermostat_programs
+      # Indicates whether the speaker supports setting its volume.
+      # @return [Boolean, nil]
+      attr_accessor :can_set_speaker_volume
       # Indicates whether the device supports simulating connection in a sandbox.
       # @return [Boolean, nil]
       attr_accessor :can_simulate_connection
@@ -2808,6 +2904,7 @@ module Seam
       # - `tapo_camera`
       # - `arlo_camera`
       # - `reolink_camera`
+      # - `sonos_speaker`
       attr_accessor :device_type
       # Display name of the device, defaults to nickname (if it is set) or `properties.appearance.name`, otherwise. Enables administrators and users to identify the device easily, especially when there are numerous devices.
       # @return [String]