seam 2.0.0b5 → 2.0.0.prerelease.1

data/lib/seam/clients/thermostats_climate_setting_schedules.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class ThermostatsClimateSettingSchedules < BaseClient
+      def create(device_id:, schedule_ends_at:, schedule_starts_at:, automatic_cooling_enabled: nil, automatic_heating_enabled: nil, cooling_set_point_celsius: nil, cooling_set_point_fahrenheit: nil, heating_set_point_celsius: nil, heating_set_point_fahrenheit: nil, hvac_mode_setting: nil, manual_override_allowed: nil, name: nil, schedule_type: nil)
+        request_seam_object(
+          :post,
+          "/thermostats/climate_setting_schedules/create",
+          Seam::ClimateSettingSchedule,
+          "climate_setting_schedule",
+          body: {device_id: device_id, schedule_ends_at: schedule_ends_at, schedule_starts_at: schedule_starts_at, automatic_cooling_enabled: automatic_cooling_enabled, automatic_heating_enabled: automatic_heating_enabled, cooling_set_point_celsius: cooling_set_point_celsius, cooling_set_point_fahrenheit: cooling_set_point_fahrenheit, 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, schedule_type: schedule_type}.compact
+        )
+      end
+
+      def delete(climate_setting_schedule_id:)
+        request_seam(
+          :post,
+          "/thermostats/climate_setting_schedules/delete",
+          body: {climate_setting_schedule_id: climate_setting_schedule_id}.compact
+        )
+
+        nil
+      end
+
+      def get(climate_setting_schedule_id: nil, device_id: nil)
+        request_seam_object(
+          :post,
+          "/thermostats/climate_setting_schedules/get",
+          Seam::ClimateSettingSchedule,
+          "climate_setting_schedule",
+          body: {climate_setting_schedule_id: climate_setting_schedule_id, device_id: device_id}.compact
+        )
+      end
+
+      def list(device_id:, user_identifier_key: nil)
+        request_seam_object(
+          :post,
+          "/thermostats/climate_setting_schedules/list",
+          Seam::ClimateSettingSchedule,
+          "climate_setting_schedules",
+          body: {device_id: device_id, user_identifier_key: user_identifier_key}.compact
+        )
+      end
+
+      def update(climate_setting_schedule_id:, automatic_cooling_enabled: nil, automatic_heating_enabled: nil, cooling_set_point_celsius: nil, cooling_set_point_fahrenheit: nil, heating_set_point_celsius: nil, heating_set_point_fahrenheit: nil, hvac_mode_setting: nil, manual_override_allowed: nil, name: nil, schedule_ends_at: nil, schedule_starts_at: nil, schedule_type: nil)
+        request_seam(
+          :post,
+          "/thermostats/climate_setting_schedules/update",
+          body: {climate_setting_schedule_id: climate_setting_schedule_id, automatic_cooling_enabled: automatic_cooling_enabled, automatic_heating_enabled: automatic_heating_enabled, cooling_set_point_celsius: cooling_set_point_celsius, cooling_set_point_fahrenheit: cooling_set_point_fahrenheit, 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, schedule_ends_at: schedule_ends_at, schedule_starts_at: schedule_starts_at, schedule_type: schedule_type}.compact
+        )
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/clients/user_identities.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class UserIdentities < BaseClient
+      def enrollment_automations
+        @enrollment_automations ||= Seam::Clients::UserIdentitiesEnrollmentAutomations.new(self)
+      end
+
+      def add_acs_user(acs_user_id:, user_identity_id:)
+        request_seam(
+          :post,
+          "/user_identities/add_acs_user",
+          body: {acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact
+        )
+
+        nil
+      end
+
+      def create(email_address: nil, full_name: nil, phone_number: nil, user_identity_key: nil)
+        request_seam_object(
+          :post,
+          "/user_identities/create",
+          Seam::UserIdentity,
+          "user_identity",
+          body: {email_address: email_address, full_name: full_name, phone_number: phone_number, user_identity_key: user_identity_key}.compact
+        )
+      end
+
+      def delete(user_identity_id:)
+        request_seam(
+          :post,
+          "/user_identities/delete",
+          body: {user_identity_id: user_identity_id}.compact
+        )
+
+        nil
+      end
+
+      def get(user_identity_id: nil, user_identity_key: nil)
+        request_seam_object(
+          :post,
+          "/user_identities/get",
+          Seam::UserIdentity,
+          "user_identity",
+          body: {user_identity_id: user_identity_id, user_identity_key: user_identity_key}.compact
+        )
+      end
+
+      def grant_access_to_device(device_id:, user_identity_id:)
+        request_seam(
+          :post,
+          "/user_identities/grant_access_to_device",
+          body: {device_id: device_id, user_identity_id: user_identity_id}.compact
+        )
+
+        nil
+      end
+
+      def list(credential_manager_acs_system_id: nil)
+        request_seam_object(
+          :post,
+          "/user_identities/list",
+          Seam::UserIdentity,
+          "user_identities",
+          body: {credential_manager_acs_system_id: credential_manager_acs_system_id}.compact
+        )
+      end
+
+      def list_accessible_devices(user_identity_id:)
+        request_seam_object(
+          :post,
+          "/user_identities/list_accessible_devices",
+          Seam::Device,
+          "devices",
+          body: {user_identity_id: user_identity_id}.compact
+        )
+      end
+
+      def list_acs_systems(user_identity_id:)
+        request_seam_object(
+          :post,
+          "/user_identities/list_acs_systems",
+          Seam::AcsSystem,
+          "acs_systems",
+          body: {user_identity_id: user_identity_id}.compact
+        )
+      end
+
+      def list_acs_users(user_identity_id:)
+        request_seam_object(
+          :post,
+          "/user_identities/list_acs_users",
+          Seam::AcsUser,
+          "acs_users",
+          body: {user_identity_id: user_identity_id}.compact
+        )
+      end
+
+      def remove_acs_user(acs_user_id:, user_identity_id:)
+        request_seam(
+          :post,
+          "/user_identities/remove_acs_user",
+          body: {acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact
+        )
+
+        nil
+      end
+
+      def revoke_access_to_device(device_id:, user_identity_id:)
+        request_seam(
+          :post,
+          "/user_identities/revoke_access_to_device",
+          body: {device_id: device_id, user_identity_id: user_identity_id}.compact
+        )
+
+        nil
+      end
+
+      def update(user_identity_id:, email_address: nil, full_name: nil, phone_number: nil, user_identity_key: nil)
+        request_seam(
+          :post,
+          "/user_identities/update",
+          body: {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
+        )
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/clients/user_identities_enrollment_automations.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class UserIdentitiesEnrollmentAutomations < BaseClient
+      def delete(enrollment_automation_id:)
+        request_seam(
+          :post,
+          "/user_identities/enrollment_automations/delete",
+          body: {enrollment_automation_id: enrollment_automation_id}.compact
+        )
+
+        nil
+      end
+
+      def get(enrollment_automation_id:)
+        request_seam_object(
+          :post,
+          "/user_identities/enrollment_automations/get",
+          Seam::EnrollmentAutomation,
+          "enrollment_automation",
+          body: {enrollment_automation_id: enrollment_automation_id}.compact
+        )
+      end
+
+      def launch(credential_manager_acs_system_id:, user_identity_id:, acs_credential_pool_id: nil, create_credential_manager_user: nil, credential_manager_acs_user_id: nil)
+        request_seam(
+          :post,
+          "/user_identities/enrollment_automations/launch",
+          body: {credential_manager_acs_system_id: credential_manager_acs_system_id, user_identity_id: user_identity_id, acs_credential_pool_id: acs_credential_pool_id, create_credential_manager_user: create_credential_manager_user, credential_manager_acs_user_id: credential_manager_acs_user_id}.compact
+        )
+
+        nil
+      end
+
+      def list(user_identity_id:)
+        request_seam_object(
+          :post,
+          "/user_identities/enrollment_automations/list",
+          Seam::EnrollmentAutomation,
+          "enrollment_automations",
+          body: {user_identity_id: user_identity_id}.compact
+        )
+      end
+    end
+  end
+end

data/lib/seam/clients/webhooks.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Webhooks < BaseClient
+      def create(url:, event_types: nil)
+        request_seam_object(
+          :post,
+          "/webhooks/create",
+          Seam::Webhook,
+          "webhook",
+          body: {url: url, event_types: event_types}.compact
+        )
+      end
+
+      def delete(webhook_id:)
+        request_seam(
+          :post,
+          "/webhooks/delete",
+          body: {webhook_id: webhook_id}.compact
+        )
+
+        nil
+      end
+
+      def get(webhook_id:)
+        request_seam_object(
+          :post,
+          "/webhooks/get",
+          Seam::Webhook,
+          "webhook",
+          body: {webhook_id: webhook_id}.compact
+        )
+      end
+
+      def list
+        request_seam_object(
+          :post,
+          "/webhooks/list",
+          Seam::Webhook,
+          "webhooks",
+          body: {}.compact
+        )
+      end
+
+      def update(event_types:, webhook_id:)
+        request_seam(
+          :post,
+          "/webhooks/update",
+          body: {event_types: event_types, webhook_id: webhook_id}.compact
+        )
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/clients/workspaces.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Workspaces < BaseClient
+      def create(connect_partner_name:, name:, is_sandbox: nil, webview_logo_shape: nil, webview_primary_button_color: nil)
+        request_seam_object(
+          :post,
+          "/workspaces/create",
+          Seam::Workspace,
+          "workspace",
+          body: {connect_partner_name: connect_partner_name, name: name, is_sandbox: is_sandbox, webview_logo_shape: webview_logo_shape, webview_primary_button_color: webview_primary_button_color}.compact
+        )
+      end
+
+      def get
+        request_seam_object(
+          :post,
+          "/workspaces/get",
+          Seam::Workspace,
+          "workspace",
+          body: {}.compact
+        )
+      end
+
+      def list
+        request_seam_object(
+          :post,
+          "/workspaces/list",
+          Seam::Workspace,
+          "workspaces",
+          body: {}.compact
+        )
+      end
+
+      def reset_sandbox(wait_for_action_attempt: nil)
+        action_attempt = request_seam_object(
+          :post,
+          "/workspaces/reset_sandbox",
+          Seam::ActionAttempt,
+          "action_attempt",
+          body: {}.compact
+        )
+
+        action_attempt.decide_and_wait(wait_for_action_attempt)
+        action_attempt
+      end
+    end
+  end
+end

data/lib/seam/logger.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "logger"
+
+module Seam
+  class Logger
+    def self.info(message)
+      logger = ::Logger.new($stdout)
+      logger.info(message)
+    end
+  end
+end

data/lib/seam/request.rb

@@ -1,106 +1,73 @@
 # frozen_string_literal: true
 
-require "faraday"
-require "faraday/retry"
-require_relative "lts_version"
-require_relative "version"
+require "http"
 
 module Seam
-  module Http
-    module Request
-      def self.create_faraday_client(endpoint, auth_headers, faraday_options = {}, faraday_retry_options = {})
-        default_options = {
-          url: endpoint,
-          headers: auth_headers.merge(default_headers)
-        }
-
-        options = deep_merge(default_options, faraday_options)
-
-        default_faraday_retry_options = {
-          max: 2,
-          backoff_factor: 2
-        }
-
-        faraday_retry_options = default_faraday_retry_options.merge(faraday_retry_options)
-
-        Faraday.new(options) do |builder|
-          builder.request :json
-          builder.response :json
-          builder.use ResponseMiddleware
-          builder.request :retry, faraday_retry_options
-        end
-      end
+  class Request
+    attr_reader :base_uri, :api_key, :debug
+
+    class Error < StandardError
+      attr_reader :status, :response
 
-      def self.default_headers
-        {
-          "User-Agent" => "seam-ruby/#{Seam::VERSION}",
-          "Content-Type" => "application/json",
-          :"seam-sdk-name" => "seamapi/ruby",
-          :"seam-sdk-version" => Seam::VERSION,
-          :"seam-lts-version" => Seam::LTS_VERSION
-        }
+      def initialize(message, status, response)
+        super(message)
+        @status = status
+        @response = response
       end
+    end
 
-      class ResponseMiddleware < Faraday::Response::RaiseError
-        def on_complete(env)
-          return if env.success?
+    def initialize(api_key:, base_uri:, debug: false)
+      @api_key = api_key
+      @base_uri = base_uri
+      @debug = debug
+    end
 
-          status_code = env.status
-          request_id = env.response_headers["seam-request-id"]
+    def perform(method, uri, config = {})
+      Logger.info("Request: #{method} #{uri} #{config}") if debug
 
-          raise Http::UnauthorizedError.new(request_id) if status_code == 401
+      config[:body] = config[:body].to_json if config[:body]
 
-          if seam_api_error_response?(env)
-            body = JSON.parse(env.body)
-            error = body["error"]
-            error_details = {
-              type: error["type"] || "unknown_error",
-              message: error["message"] || "Unknown error",
-              data: error["data"]
-            }
+      response = HTTP.request(
+        method,
+        build_url(uri),
+        {headers: headers}.merge(config)
+      )
 
-            if error["type"] == "invalid_input"
-              error_details["validation_errors"] = error["validation_errors"]
-              raise Http::InvalidInputError.new(error_details, status_code, request_id)
-            end
+      return response.parse if response.status.success?
 
-            raise Http::ApiError.new(error_details, status_code, request_id)
-          end
+      handle_error_response(response, method, uri)
+    end
 
-          super
-        end
+    protected
 
-        def seam_api_error_response?(env)
-          return false unless env.response_headers
+    def handle_error_response(response, method, uri)
+      msg = "Api Error #{response.status.code} #{method} #{uri}"
+      code = response.status.code
 
-          content_type = env.response_headers["Content-Type"]
-          return false unless content_type&.start_with?("application/json")
+      if code >= 400 && code < 500 && (err = response.parse["error"])
+        msg = "Api Error #{err["type"]}\nrequest_id: #{err["request_id"]}\n#{err["message"]}"
+      end
 
-          begin
-            body = JSON.parse(env.body)
-            return false unless body.is_a?(Hash) && body["error"].is_a?(Hash)
+      raise Error.new(msg, code, response)
+    end
 
-            error = body["error"]
-            error["type"].is_a?(String) && error["message"].is_a?(String)
-          rescue JSON::ParserError
-            false
-          end
-        end
-      end
+    def build_url(uri)
+      "#{base_uri}#{uri}"
+    end
 
-      def self.deep_merge(hash1, hash2)
-        result = hash1.dup
-        hash2.each do |key, value|
-          result[key] = if value.is_a?(Hash) && result[key].is_a?(Hash)
-            deep_merge(result[key], value)
-          else
-            value
-          end
-        end
-        result
-      end
+    def headers
+      {
+        "User-Agent" => user_agent,
+        "Content-Type" => "application/json",
+        "Authorization" => "Bearer #{api_key}",
+        :"seam-sdk-name" => "seamapi/ruby",
+        :"seam-sdk-version" => Seam::VERSION,
+        :"seam-lts-version" => Seam::LTS_VERSION
+      }
+    end
 
-      private_class_method :deep_merge
+    def user_agent
+      "seam-ruby/#{Seam::VERSION}"
     end
   end
 end

data/lib/seam/resources/access_code.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Seam
+  class AccessCode < BaseResource
+    attr_accessor :access_code_id, :code, :common_code_key, :device_id, :is_backup, :is_backup_access_code_available, :is_external_modification_allowed, :is_managed, :is_offline_access_code, :is_one_time_use, :is_scheduled_on_device, :is_waiting_for_code_assignment, :name, :pulled_backup_access_code_id, :status, :type
+
+    date_accessor :created_at, :ends_at, :starts_at
+
+    include Seam::ResourceErrorsSupport
+    include Seam::ResourceWarningsSupport
+  end
+end

data/lib/seam/resources/acs_access_group.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsAccessGroup < BaseResource
+    attr_accessor :access_group_type, :access_group_type_display_name, :acs_access_group_id, :acs_system_id, :external_type, :external_type_display_name, :name, :workspace_id
+
+    date_accessor :created_at
+  end
+end

data/lib/seam/resources/acs_credential.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsCredential < BaseResource
+    attr_accessor :access_method, :acs_credential_id, :acs_credential_pool_id, :acs_system_id, :acs_user_id, :code, :display_name, :ends_at, :external_type, :external_type_display_name, :is_multi_phone_sync_credential, :parent_acs_credential_id, :starts_at, :visionline_metadata, :workspace_id
+
+    date_accessor :created_at
+
+    include Seam::ResourceErrorsSupport
+    include Seam::ResourceWarningsSupport
+  end
+end

data/lib/seam/resources/acs_credential_pool.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsCredentialPool < BaseResource
+    attr_accessor :acs_credential_pool_id, :acs_system_id, :display_name, :external_type, :external_type_display_name, :workspace_id
+
+    date_accessor :created_at
+  end
+end

data/lib/seam/resources/acs_credential_provisioning_automation.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsCredentialProvisioningAutomation < BaseResource
+    attr_accessor :acs_credential_provisioning_automation_id, :credential_manager_acs_system_id, :user_identity_id, :workspace_id
+
+    date_accessor :created_at
+  end
+end

data/lib/seam/resources/acs_entrance.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsEntrance < BaseResource
+    attr_accessor :acs_entrance_id, :acs_system_id, :display_name, :latch_metadata, :visionline_metadata
+
+    date_accessor :created_at
+  end
+end

data/lib/seam/resources/acs_system.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsSystem < BaseResource
+    attr_accessor :acs_system_id, :can_add_acs_users_to_acs_access_groups, :can_automate_enrollment, :can_create_acs_access_groups, :can_remove_acs_users_from_acs_access_groups, :connected_account_ids, :external_type, :external_type_display_name, :image_alt_text, :image_url, :name, :system_type, :system_type_display_name, :workspace_id
+
+    date_accessor :created_at
+  end
+end

data/lib/seam/resources/acs_user.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Seam
+  class AcsUser < BaseResource
+    attr_accessor :access_schedule, :acs_system_id, :acs_user_id, :display_name, :email, :email_address, :external_type, :external_type_display_name, :full_name, :hid_acs_system_id, :is_suspended, :phone_number, :user_identity_email_address, :user_identity_full_name, :user_identity_id, :user_identity_phone_number, :workspace_id
+
+    date_accessor :created_at
+  end
+end

data/lib/seam/resources/action_attempt.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Seam
+  class ActionAttempt < BaseResource
+    attr_accessor :action_attempt_id, :action_type, :error, :result, :status
+
+    def decide_and_wait(wait_for_action_attempt)
+      wait_decision = wait_for_action_attempt.nil? ? @client.wait_for_action_attempt : wait_for_action_attempt
+
+      if wait_decision == true
+        wait_until_finished
+      elsif wait_decision.is_a?(Hash)
+        wait_until_finished(timeout: wait_decision[:timeout], polling_interval: wait_decision[:polling_interval])
+      end
+    end
+
+    def wait_until_finished(timeout: 5.0, polling_interval: 0.5)
+      time_waiting = 0.0
+
+      while @status == "pending"
+        sleep(polling_interval)
+        time_waiting += polling_interval
+
+        raise "Timed out waiting for action attempt to be finished" if time_waiting > timeout
+
+        update!
+
+        raise "Action Attempt failed: #{error["message"]}" if @status == "failed"
+      end
+
+      self
+    end
+
+    def update!
+      response = @client.request_seam(
+        :post,
+        "/action_attempts/get",
+        body: {
+          action_attempt_id: action_attempt_id
+        }
+      )
+
+      update_from_response(response["action_attempt"])
+    end
+  end
+end