seam 2.159.0 → 2.161.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9738e059d61a1d27652beb8e6e7307ce7a1b3fb9b1aca822fe39b7c8c9e1339
-  data.tar.gz: bd0b5915f52913e661522bf7bb3d184c958b65d7073a63088363dc26dbb37c6a
+  metadata.gz: 7cc9d1dfaecd365b64e591da220ce5063278d507c6e0e44bde36c826dcfb66ba
+  data.tar.gz: 70afc25cd775515ffd34e040a5515a5ee2d1359279a90ab8ac09ce0b6ed17338
 SHA512:
-  metadata.gz: 2ac80c17ff2b1c0825e118c35d0d0921df478060db11c0629f707c3c22124d69628eb52aa9fddef390ca310568940db7009c3b10e334c7711b2b25679c1da194
-  data.tar.gz: a9c7462968b1148781ce3d48f5fec5f444f3f1b1469121a28321bbd67a6ec4f90a3a1aa6891aa699a6f9c05db81125e312a7105ffd52e1e0b5866ffab52f732b
+  metadata.gz: 8c27d9dcee2e2d54358134660ee38476479fb7fbb78242a424bba593a95d1d8b19a83b03d193d92d5020f9d9b16459d687d29a43e4fc634b978c36f00df67734
+  data.tar.gz: 33c02f6c6856b7e24b634f91131d72e7bc689c0577881cb2b712c47e3e54e74f7a64ae611330cd823f51ab2c08002189e05be238b87a02b3267e9cfd3c71fa1b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    seam (2.159.0)
+    seam (2.161.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.159.0)
+  seam (2.161.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_code.rb

@@ -308,7 +308,7 @@ module Seam
           date_accessor :created_at
         end
 
-        # Indicates that Seam's integration user does not have sufficient permissions on the provider's system to which this device belongs, so Seam cannot manage access codes or unlock the device. See the error message for specifics, then either reauthorize the connected account in Seam or grant the integration user the required permissions in the provider's system.
+        # Indicates that the provider's system to which this device belongs is not letting Seam act on it, so Seam cannot manage access codes or unlock the device. The error message says which of three causes applies. Seam's integration user may not have sufficient permissions on the provider's system, or may have been suspended there: grant the integration user the required permissions in the provider's system, or reauthorize the connected account in Seam. The provider account or site may not have a valid subscription with the provider: set up or renew that subscription with the provider. Or the provider may have rejected the credential Seam uses to operate the device's hub: contact Seam support to re-activate it.
         class InsufficientPermissions < Errors
           # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
           # @return [String]

data/lib/seam/resources/acs_system.rb

@@ -78,7 +78,7 @@ module Seam
           date_accessor :created_at
         end
 
-        # Indicates that Seam's integration user does not have sufficient permissions on the provider's system backing this [access control system](https://www.seam.co/docs/low-level-apis/access-systems). Access cannot be managed until permissions are restored. See the error message for specifics, then either reauthorize the connected account in Seam or grant the integration user the required permissions in the provider's system.
+        # 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.
           # @return [String]

data/lib/seam/resources/action_attempt.rb

@@ -1264,6 +1264,46 @@ module Seam
         attr_accessor :status
       end
 
+      # Activating the weekly program is pending.
+      class ActivateWeeklyProgram < 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 returning a thermostat to its weekly program.
+        # @return [String]
+        # Known values:
+        # - `ACTIVATE_WEEKLY_PROGRAM`
+        attr_accessor :action_type
+        # @return [String]
+        # Known values:
+        # - `success`
+        # - `pending`
+        # - `error`
+        attr_accessor :status
+      end
+
       # Simulating a keypad code entry is pending.
       class SimulateKeypadCodeEntry < ActionAttempt
         class Error < BaseResource
@@ -1732,6 +1772,7 @@ module Seam
       # - `SET_FAN_MODE`
       # - `SET_HVAC_MODE`
       # - `ACTIVATE_CLIMATE_PRESET`
+      # - `ACTIVATE_WEEKLY_PROGRAM`
       # - `SIMULATE_KEYPAD_CODE_ENTRY`
       # - `SIMULATE_MANUAL_LOCK_VIA_KEYPAD`
       # - `PUSH_THERMOSTAT_PROGRAMS`
@@ -1762,6 +1803,7 @@ module Seam
         "SET_FAN_MODE" => SetFanMode,
         "SET_HVAC_MODE" => SetHvacMode,
         "ACTIVATE_CLIMATE_PRESET" => ActivateClimatePreset,
+        "ACTIVATE_WEEKLY_PROGRAM" => ActivateWeeklyProgram,
         "SIMULATE_KEYPAD_CODE_ENTRY" => SimulateKeypadCodeEntry,
         "SIMULATE_MANUAL_LOCK_VIA_KEYPAD" => SimulateManualLockViaKeypad,
         "PUSH_THERMOSTAT_PROGRAMS" => PushThermostatPrograms,

data/lib/seam/resources/camera_live_view_answer.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Seam
+  module Resources
+    # Represents the WebRTC SDP answer that starts streaming video from a camera for a live view session.
+    class CameraLiveViewAnswer < BaseResource
+      # WebRTC SDP answer for the offer, limited to 64 KiB of UTF-8 data.
+      # @return [String]
+      attr_accessor :sdp_answer
+    end
+  end
+end

data/lib/seam/resources/camera_live_view_session.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Seam
+  module Resources
+    # Represents a short-lived live view session for a single camera. Use the session ID and token to start a WebRTC stream and to stop the session.
+    class CameraLiveViewSession < BaseResource
+      # ID of the camera live view session.
+      # @return [String]
+      attr_accessor :camera_live_view_session_id
+      # ID of the camera.
+      # @return [String]
+      attr_accessor :device_id
+      # Token that authorizes the offer and stop requests for this session.
+      # @return [String]
+      attr_accessor :token
+
+      # Date and time at which the live view session expires.
+      # @return [Time]
+      date_accessor :expires_at
+    end
+  end
+end

data/lib/seam/resources/device.rb

@@ -75,7 +75,7 @@ module Seam
           date_accessor :created_at
         end
 
-        # Indicates that Seam's integration user does not have sufficient permissions on the provider's system to which this device belongs, so Seam cannot manage access codes or unlock the device. See the error message for specifics, then either reauthorize the connected account in Seam or grant the integration user the required permissions in the provider's system.
+        # Indicates that the provider's system to which this device belongs is not letting Seam act on it, so Seam cannot manage access codes or unlock the device. The error message says which of three causes applies. Seam's integration user may not have sufficient permissions on the provider's system, or may have been suspended there: grant the integration user the required permissions in the provider's system, or reauthorize the connected account in Seam. The provider account or site may not have a valid subscription with the provider: set up or renew that subscription with the provider. Or the provider may have rejected the credential Seam uses to operate the device's hub: contact Seam support to re-activate it.
         class InsufficientPermissions < Errors
           # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
           # @return [String]
@@ -1023,6 +1023,18 @@ module Seam
           attr_accessor :timezone_raw_offset_ms
         end
 
+        class ReolinkMetadata < BaseResource
+          # Firmware version reported by the camera.
+          # @return [String, nil]
+          attr_accessor :firmware_version
+          # Hardware version reported by the camera.
+          # @return [String, nil]
+          attr_accessor :hardware_version
+          # Model reported by the Reolink camera.
+          # @return [String, nil]
+          attr_accessor :model
+        end
+
         class RingMetadata < BaseResource
           # Device ID for a Ring device.
           # @return [String, nil]
@@ -1889,6 +1901,9 @@ module Seam
         # Metadata for an Omnitec device.
         # @return [OmnitecMetadata, nil]
         resource_accessor :omnitec_metadata, OmnitecMetadata
+        # Metadata for a Reolink camera.
+        # @return [ReolinkMetadata, nil]
+        resource_accessor :reolink_metadata, ReolinkMetadata
         # Metadata for a Ring device.
         # @return [RingMetadata, nil]
         resource_accessor :ring_metadata, RingMetadata
@@ -2659,6 +2674,9 @@ module Seam
       # Array of warnings associated with the device. Each warning object within the array contains two fields: `warning_code` and `message`. `warning_code` is a string that uniquely identifies the type of warning, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the warning, offering insights into the issue and potentially how to rectify it.
       # @return [Array<Warnings>]
       resource_list_accessor :warnings, Warnings
+      # Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.
+      # @return [Boolean, nil]
+      attr_accessor :can_activate_weekly_program
       # Indicates whether the lock supports configuring automatic locking.
       # @return [Boolean, nil]
       attr_accessor :can_configure_auto_lock
@@ -2713,6 +2731,9 @@ module Seam
       # Indicates whether the device supports simulating removal in a sandbox.
       # @return [Boolean, nil]
       attr_accessor :can_simulate_removal
+      # Indicates whether the camera supports streaming live video through a camera live view session.
+      # @return [Boolean, nil]
+      attr_accessor :can_stream_live_video
       # Indicates whether the thermostat can be turned off.
       # @return [Boolean, nil]
       attr_accessor :can_turn_off_hvac
@@ -2786,6 +2807,7 @@ module Seam
       # - `ring_camera`
       # - `tapo_camera`
       # - `arlo_camera`
+      # - `reolink_camera`
       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]

data/lib/seam/resources/device_provider.rb

@@ -3,6 +3,9 @@
 module Seam
   module Resources
     class DeviceProvider < BaseResource
+      # Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.
+      # @return [Boolean, nil]
+      attr_accessor :can_activate_weekly_program
       # Indicates whether the lock supports configuring automatic locking.
       # @return [Boolean, nil]
       attr_accessor :can_configure_auto_lock
@@ -57,6 +60,9 @@ module Seam
       # Indicates whether the device supports simulating removal in a sandbox.
       # @return [Boolean, nil]
       attr_accessor :can_simulate_removal
+      # Indicates whether the camera supports streaming live video through a camera live view session.
+      # @return [Boolean, nil]
+      attr_accessor :can_stream_live_video
       # Indicates whether the thermostat can be turned off.
       # @return [Boolean, nil]
       attr_accessor :can_turn_off_hvac
@@ -125,6 +131,7 @@ module Seam
       # - `ring`
       # - `tapo`
       # - `arlo`
+      # - `reolink`
       # - `ical`
       # - `lodgify`
       # - `hostaway`

data/lib/seam/resources/event.rb

@@ -4866,6 +4866,9 @@ module Seam
         # URL to a thumbnail image captured at the time of activation.
         # @return [String, nil]
         attr_accessor :image_url
+        # IDs of the media, such as a video clip and a thumbnail image, captured for this activation. Use `/media/get` to retrieve each one.
+        # @return [Array<String>]
+        attr_accessor :media_ids
         # Sub-type of motion detected, if available.
         # @return [String, nil]
         # Known values:
@@ -4918,6 +4921,9 @@ module Seam
         # URL to a thumbnail image captured at the time the doorbell was pressed.
         # @return [String, nil]
         attr_accessor :image_url
+        # IDs of the media, such as a video clip and a thumbnail image, captured when the doorbell was pressed. Use `/media/get` to retrieve each one.
+        # @return [Array<String>]
+        attr_accessor :media_ids
         # URL to a short video clip captured at the time the doorbell was pressed.
         # @return [String, nil]
         attr_accessor :video_url

data/lib/seam/resources/index.rb

@@ -12,6 +12,8 @@ require_relative "acs_system"
 require_relative "acs_user"
 require_relative "action_attempt"
 require_relative "batch"
+require_relative "camera_live_view_answer"
+require_relative "camera_live_view_session"
 require_relative "client_session"
 require_relative "connect_webview"
 require_relative "connected_account"
@@ -20,6 +22,7 @@ require_relative "device"
 require_relative "device_provider"
 require_relative "event"
 require_relative "instant_key"
+require_relative "media"
 require_relative "noise_threshold"
 require_relative "pagination"
 require_relative "phone"

data/lib/seam/resources/media.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Seam
+  module Resources
+    # Represents a piece of media, such as a video clip or a thumbnail image, that a device captured for an event. Media is in beta.
+    class Media < BaseResource
+      # MIME type of the media, such as `video/mp4` or `image/jpeg`.
+      # @return [String, nil]
+      attr_accessor :content_type
+      # ID of the device that captured the media.
+      # @return [String, nil]
+      attr_accessor :device_id
+      # ID of the event that the media belongs to.
+      # @return [String, nil]
+      attr_accessor :event_id
+      # ID of the media.
+      # @return [String]
+      attr_accessor :media_id
+      # Type of the media: a video clip or a still image.
+      # @return [String]
+      # Known values:
+      # - `video`
+      # - `image`
+      attr_accessor :media_type
+      # Status of the media. `pending` means that Seam is still retrieving the media. `available` means that `url` can be used to download it. `unavailable` means that no media exists for the event, and `failed` means that Seam could not retrieve it.
+      # @return [String]
+      # Known values:
+      # - `pending`
+      # - `available`
+      # - `unavailable`
+      # - `failed`
+      attr_accessor :status
+      # Short-lived URL from which you can download the media. Null unless `status` is `available`. The URL expires after about five minutes. Call `/media/get` again for a new URL.
+      # @return [String, nil]
+      attr_accessor :url
+      # Video codec used to encode the media. Only present for video media. `hevc` (H.265) playback support varies by browser and device, so check compatibility before assuming a clip plays inline.
+      # @return [String, nil]
+      # Known values:
+      # - `h264`
+      # - `hevc`
+      attr_accessor :video_codec
+      # ID of the workspace that contains the media.
+      # @return [String]
+      attr_accessor :workspace_id
+
+      # Date and time at which the media was created.
+      # @return [Time]
+      date_accessor :created_at
+
+      # Date and time at which the media stops being available. Null when Seam does not know when the media expires.
+      # @return [Time, nil]
+      date_accessor :expires_at
+    end
+  end
+end

data/lib/seam/resources/unmanaged_access_code.rb

@@ -310,7 +310,7 @@ module Seam
           date_accessor :created_at
         end
 
-        # Indicates that Seam's integration user does not have sufficient permissions on the provider's system to which this device belongs, so Seam cannot manage access codes or unlock the device. See the error message for specifics, then either reauthorize the connected account in Seam or grant the integration user the required permissions in the provider's system.
+        # Indicates that the provider's system to which this device belongs is not letting Seam act on it, so Seam cannot manage access codes or unlock the device. The error message says which of three causes applies. Seam's integration user may not have sufficient permissions on the provider's system, or may have been suspended there: grant the integration user the required permissions in the provider's system, or reauthorize the connected account in Seam. The provider account or site may not have a valid subscription with the provider: set up or renew that subscription with the provider. Or the provider may have rejected the credential Seam uses to operate the device's hub: contact Seam support to re-activate it.
         class InsufficientPermissions < Errors
           # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
           # @return [String]

data/lib/seam/resources/unmanaged_device.rb

@@ -48,7 +48,7 @@ module Seam
           date_accessor :created_at
         end
 
-        # Indicates that Seam's integration user does not have sufficient permissions on the provider's system to which this device belongs, so Seam cannot manage access codes or unlock the device. See the error message for specifics, then either reauthorize the connected account in Seam or grant the integration user the required permissions in the provider's system.
+        # Indicates that the provider's system to which this device belongs is not letting Seam act on it, so Seam cannot manage access codes or unlock the device. The error message says which of three causes applies. Seam's integration user may not have sufficient permissions on the provider's system, or may have been suspended there: grant the integration user the required permissions in the provider's system, or reauthorize the connected account in Seam. The provider account or site may not have a valid subscription with the provider: set up or renew that subscription with the provider. Or the provider may have rejected the credential Seam uses to operate the device's hub: contact Seam support to re-activate it.
         class InsufficientPermissions < Errors
           # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
           # @return [String]
@@ -934,6 +934,9 @@ module Seam
       # Array of warnings associated with the device. Each warning object within the array contains two fields: `warning_code` and `message`. `warning_code` is a string that uniquely identifies the type of warning, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the warning, offering insights into the issue and potentially how to rectify it.
       # @return [Array<Warnings>]
       resource_list_accessor :warnings, Warnings
+      # Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.
+      # @return [Boolean, nil]
+      attr_accessor :can_activate_weekly_program
       # Indicates whether the lock supports configuring automatic locking.
       # @return [Boolean, nil]
       attr_accessor :can_configure_auto_lock
@@ -988,6 +991,9 @@ module Seam
       # Indicates whether the device supports simulating removal in a sandbox.
       # @return [Boolean, nil]
       attr_accessor :can_simulate_removal
+      # Indicates whether the camera supports streaming live video through a camera live view session.
+      # @return [Boolean, nil]
+      attr_accessor :can_stream_live_video
       # Indicates whether the thermostat can be turned off.
       # @return [Boolean, nil]
       attr_accessor :can_turn_off_hvac
@@ -1061,6 +1067,7 @@ module Seam
       # - `ring_camera`
       # - `tapo_camera`
       # - `arlo_camera`
+      # - `reolink_camera`
       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]

data/lib/seam/routes/cameras.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Cameras
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      def live_views
+        @live_views ||= Seam::Clients::CamerasLiveViews.new(client: @client, defaults: @defaults)
+      end
+    end
+  end
+end

data/lib/seam/routes/cameras_live_views.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class CamerasLiveViews
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Creates a short-lived live view session for a single camera. Pass the returned session ID and token to `/cameras/live_views/offer` to start a WebRTC stream, and to `/cameras/live_views/stop` to end the session.
+      #
+      # Camera live view is in beta. To enable it for your workspace, contact Seam support. To check whether a camera supports live view, use `device.can_stream_live_video`.
+      # @param device_id [String] ID of the camera to view.
+      # @param duration_seconds [Integer, nil] Number of seconds for which the live view session is valid, up to 600.
+      # @param include_audio [Boolean, nil] Indicates whether to include the camera's audio.
+      # @return [Seam::Resources::CameraLiveViewSession] OK
+      def create(device_id:, duration_seconds: nil, include_audio: nil)
+        res = @client.post("/cameras/live_views/create", {device_id: device_id, duration_seconds: duration_seconds, include_audio: include_audio}.compact)
+
+        Seam::Resources::CameraLiveViewSession.load_from_response(res.body["camera_live_view_session"])
+      end
+
+      # Exchanges a WebRTC SDP offer for an SDP answer that starts streaming video from the camera, for a live view session that you created using `/cameras/live_views/create`.
+      #
+      # Camera live view is in beta. To enable it for your workspace, contact Seam support.
+      # @param camera_live_view_session_id [String] ID of the camera live view session.
+      # @param sdp_offer [String] WebRTC SDP offer from the viewer, limited to 64 KiB of UTF-8 data.
+      # @param token [String] Token returned when the camera live view session was created.
+      # @return [Seam::Resources::CameraLiveViewAnswer] OK
+      def offer(camera_live_view_session_id:, sdp_offer:, token:)
+        res = @client.post("/cameras/live_views/offer", {camera_live_view_session_id: camera_live_view_session_id, sdp_offer: sdp_offer, token: token}.compact)
+
+        Seam::Resources::CameraLiveViewAnswer.load_from_response(res.body["camera_live_view_answer"])
+      end
+
+      # Stops a camera live view session that the current client session owns.
+      #
+      # Camera live view is in beta. To enable it for your workspace, contact Seam support.
+      # @param camera_live_view_session_id [String] ID of the camera live view session.
+      # @param token [String] Token returned when the camera live view session was created.
+      # @return [nil] OK
+      def stop(camera_live_view_session_id:, token:)
+        @client.post("/cameras/live_views/stop", {camera_live_view_session_id: camera_live_view_session_id, token: token}.compact)
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/routes/client_sessions.rb

@@ -14,7 +14,7 @@ module Seam
       # @param customer_id [String, nil] Customer ID that you want to associate with the new client session.
       # @param customer_key [String, nil] Customer key that you want to associate with the new client session.
       # @param expires_at [Time, nil] Date and time at which the client session should expire, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
-      # @param user_identifier_key [String, nil] Your user ID for the user for whom you want to create a client session.
+      # @param user_identifier_key [String, nil] Your user ID for the user for whom you want to create a client session. When you authenticate with a publishable key, the `user_identifier_key` must be a high-entropy secret that only the user knows, such as a UUIDv4 or a salted hash. Do not use an email address, name, phone number, or other guessable value, because anyone who knows the `user_identifier_key` can retrieve the client session.
       # @param user_identity_id [String, nil] ID of the [user identity](https://www.seam.co/docs/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) for which you want to create a client session.
       # @param user_identity_ids [Array<String>, nil] IDs of the [user identities](https://www.seam.co/docs/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
       # @deprecated user_identity_ids: Use `user_identity_id` instead.
@@ -48,7 +48,7 @@ module Seam
       # @param connect_webview_ids [Array<String>, nil] IDs of the [Connect Webviews](https://www.seam.co/docs/core-concepts/connect-webviews) that you want to associate with the client session (or that are already associated with the existing client session).
       # @param connected_account_ids [Array<String>, nil] IDs of the [connected accounts](https://www.seam.co/docs/api/connected_accounts/object) that you want to associate with the client session (or that are already associated with the existing client session).
       # @param expires_at [Time, nil] Date and time at which the client session should expire in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. If the client session already exists, this will update the expiration before returning it.
-      # @param user_identifier_key [String, nil] Your user ID for the user that you want to associate with the client session (or that is already associated with the existing client session).
+      # @param user_identifier_key [String, nil] Your user ID for the user that you want to associate with the client session (or that is already associated with the existing client session). When you authenticate with a publishable key, the `user_identifier_key` must be a high-entropy secret that only the user knows, such as a UUIDv4 or a salted hash. Do not use an email address, name, phone number, or other guessable value, because anyone who knows the `user_identifier_key` can retrieve the client session.
       # @param user_identity_id [String, nil] ID of the [user identity](https://www.seam.co/docs/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session (or that are already associated with the existing client session).
       # @param user_identity_ids [Array<String>, nil] IDs of the [user identities](https://www.seam.co/docs/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
       # @deprecated user_identity_ids: Use `user_identity_id`.

data/lib/seam/routes/index.rb

@@ -16,6 +16,8 @@ require_relative "acs_entrances"
 require_relative "acs_systems"
 require_relative "acs_users"
 require_relative "action_attempts"
+require_relative "cameras"
+require_relative "cameras_live_views"
 require_relative "client_sessions"
 require_relative "connect_webviews"
 require_relative "connected_accounts"
@@ -28,6 +30,7 @@ require_relative "events"
 require_relative "instant_keys"
 require_relative "locks"
 require_relative "locks_simulate"
+require_relative "media"
 require_relative "noise_sensors"
 require_relative "noise_sensors_noise_thresholds"
 require_relative "noise_sensors_simulate"

data/lib/seam/routes/media.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Media
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Returns a specified piece of media, such as a video clip or thumbnail image captured for a camera event, with a short-lived URL from which you can download it. Camera events list their media in `media_ids`. This endpoint is in beta.
+      # @param media_id [String] ID of the media that you want to get.
+      # @param format [String, nil] Response format. `json` returns the media object. `redirect` responds with a `302` redirect to the media's download URL, so you can use this endpoint directly as the source of an image or video.
+      # @return [Seam::Resources::Media] OK
+      def get(media_id:, format: nil)
+        res = @client.get("/media/get", {media_id: media_id, format: format}.compact)
+
+        Seam::Resources::Media.load_from_response(res.body["media"])
+      end
+    end
+  end
+end

data/lib/seam/routes/routes.rb

@@ -22,6 +22,10 @@ module Seam
       @action_attempts ||= Seam::Clients::ActionAttempts.new(client: @client, defaults: @defaults)
     end
 
+    def cameras
+      @cameras ||= Seam::Clients::Cameras.new(client: @client, defaults: @defaults)
+    end
+
     def client_sessions
       @client_sessions ||= Seam::Clients::ClientSessions.new(client: @client, defaults: @defaults)
     end
@@ -54,6 +58,10 @@ module Seam
       @locks ||= Seam::Clients::Locks.new(client: @client, defaults: @defaults)
     end
 
+    def media
+      @media ||= Seam::Clients::Media.new(client: @client, defaults: @defaults)
+    end
+
     def noise_sensors
       @noise_sensors ||= Seam::Clients::NoiseSensors.new(client: @client, defaults: @defaults)
     end

data/lib/seam/routes/thermostats.rb

@@ -34,6 +34,17 @@ module Seam
         Seam::ActionAttemptResolver.resolve(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
+      # Returns a specified [thermostat](https://www.seam.co/docs/capability-guides/thermostats) to its [weekly program](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-programs), the schedule that is configured on the device itself, releasing any hold that Seam has set. Seam stops managing the thermostat's climate until you [activate a climate preset](https://www.seam.co/docs/capability-guides/thermostats/configure-current-climate-settings), make a direct climate setting change, or one of the thermostat's [scheduled](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules) presets reaches its activation time.
+      # @param device_id [String] ID of the thermostat device that you want to return to its weekly program.
+      # @return [Seam::Resources::ActionAttempt] OK
+      def activate_weekly_program(device_id:, wait_for_action_attempt: nil)
+        res = @client.post("/thermostats/activate_weekly_program", {device_id: device_id}.compact)
+
+        wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : 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://www.seam.co/docs/capability-guides/thermostats) to [cool mode](https://www.seam.co/docs/capability-guides/thermostats/configure-current-climate-settings).
       # @param device_id [String] ID of the thermostat device that you want to set to cool mode.
       # @param cooling_set_point_celsius [Float, nil] [Cooling set point](https://www.seam.co/docs/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.

data/lib/seam/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: seam
 version: !ruby/object:Gem::Version
-  version: 2.159.0
+  version: 2.161.0
 platform: ruby
 authors:
 - Seam Labs, Inc.
@@ -213,6 +213,8 @@ files:
 - lib/seam/resources/acs_user.rb
 - lib/seam/resources/action_attempt.rb
 - lib/seam/resources/batch.rb
+- lib/seam/resources/camera_live_view_answer.rb
+- lib/seam/resources/camera_live_view_session.rb
 - lib/seam/resources/client_session.rb
 - lib/seam/resources/connect_webview.rb
 - lib/seam/resources/connected_account.rb
@@ -222,6 +224,7 @@ files:
 - lib/seam/resources/event.rb
 - lib/seam/resources/index.rb
 - lib/seam/resources/instant_key.rb
+- lib/seam/resources/media.rb
 - lib/seam/resources/noise_threshold.rb
 - lib/seam/resources/pagination.rb
 - lib/seam/resources/phone.rb
@@ -252,6 +255,8 @@ files:
 - lib/seam/routes/acs_systems.rb
 - lib/seam/routes/acs_users.rb
 - lib/seam/routes/action_attempts.rb
+- lib/seam/routes/cameras.rb
+- lib/seam/routes/cameras_live_views.rb
 - lib/seam/routes/client_sessions.rb
 - lib/seam/routes/connect_webviews.rb
 - lib/seam/routes/connected_accounts.rb
@@ -265,6 +270,7 @@ files:
 - lib/seam/routes/instant_keys.rb
 - lib/seam/routes/locks.rb
 - lib/seam/routes/locks_simulate.rb
+- lib/seam/routes/media.rb
 - lib/seam/routes/noise_sensors.rb
 - lib/seam/routes/noise_sensors_noise_thresholds.rb
 - lib/seam/routes/noise_sensors_simulate.rb