nylas 4.6.4 → 5.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eac1943c9596d6042676b8c5eb3356e6986a5f41088b419fd6dcd8295ef41fd7
-  data.tar.gz: a6207a0b0004fcfcaf251675fe6ad9d70c0c3cd57bcb9b7ca6e83d95decdb8e6
+  metadata.gz: d2f677958900566f6aeb941f450e9bbe3b4dfd54f57c4cf4b87bb403f968f731
+  data.tar.gz: 5f4eb58cf5835a43a4034229d506d7662923fa110c4fe5e352f9d867ac69b295
 SHA512:
-  metadata.gz: '018f5931707cc9bbb8ab43908619fd7fabb9eea0992cbcc486bc35c2d67ff9ae8ffb52a49a9bfa0beecf4eca4897849e4e2bcd1c33878a89f06756de24f60c59'
-  data.tar.gz: 0a215f1bcc5e9b19bbd5229ed350fefe07bfb415f7e1118f451f2e31998604fa1b730d325d68083cfe09fb9a9efc84a18a247f8a85ad41b48231732f37c57c81
+  metadata.gz: c727f58c5ecaeaca411d346b23d2176f8114f1cc441347326c8c26239f3ef78626007a443f89932fc955c68c295229d238a647cb7f42234f11d31fc0d02ec7e9
+  data.tar.gz: e1ce86d59fcdc7c7193688faf95833978e106fb5e0ea5166f009f9f06234e9a724e363b21133b6636c14398e4dcc177853347b13a5c821af765deaf5900a0cc4

data/lib/nylas.rb

@@ -3,6 +3,21 @@
 require "json"
 require "rest-client"
 
+# BUGFIX
+#   See https://github.com/sparklemotion/http-cookie/issues/27
+#   and https://github.com/sparklemotion/http-cookie/issues/6
+#
+# CookieJar uses unsafe class caching for dynamically loading cookie jars
+# If 2 rest-client instances are instantiated at the same time, (in threads)
+# non-deterministic behaviour can occur whereby the Hash cookie jar isn't
+# properly loaded and cached.
+# Forcing an instantiation of the jar onload will force the CookieJar to load
+# before the system has a chance to spawn any threads.
+# Note this should technically be fixed in rest-client itself however that
+# library appears to be stagnant so we're forced to fix it here
+# This object should get GC'd as it's not referenced by anything
+HTTP::CookieJar.new
+
 require "ostruct"
 require "forwardable"
 
@@ -36,10 +51,13 @@ require_relative "nylas/timespan"
 require_relative "nylas/web_page"
 require_relative "nylas/nylas_date"
 require_relative "nylas/when"
+require_relative "nylas/free_busy"
+require_relative "nylas/time_slot"
 
 # Custom collection types
 require_relative "nylas/search_collection"
 require_relative "nylas/deltas_collection"
+require_relative "nylas/free_busy_collection"
 
 # Models supported by the API
 require_relative "nylas/account"
@@ -89,4 +107,5 @@ module Nylas
   Types.registry[:nylas_date] = NylasDateType.new
   Types.registry[:contact_group] = Types::ModelType.new(model: ContactGroup)
   Types.registry[:when] = Types::ModelType.new(model: When)
+  Types.registry[:time_slot] = Types::ModelType.new(model: TimeSlot)
 end

data/lib/nylas/account.rb

@@ -12,6 +12,7 @@ module Nylas
     attribute :account_id, :string
     attribute :billing_state, :string
     attribute :sync_state, :string
+    attribute :provider, :string
 
     attribute :email, :string
     attribute :trial, :boolean

data/lib/nylas/api.rb

@@ -4,8 +4,9 @@ module Nylas
   # Methods to retrieve data from the Nylas API as Ruby objects
   class API
     attr_accessor :client
+
     extend Forwardable
-    def_delegators :client, :execute, :get, :post, :put, :delete, :app_id
+    def_delegators :client, :execute, :get, :post, :put, :delete, :app_id, :api_server
 
     include Logging
 
@@ -36,6 +37,19 @@ module Nylas
       )
     end
 
+    def authentication_url(redirect_uri:, scopes:, response_type: "code", login_hint: nil, state: nil)
+      params = {
+        client_id: app_id,
+        redirect_uri: redirect_uri,
+        response_type: response_type,
+        login_hint: login_hint
+      }
+      params[:state] = state if state
+      params[:scopes] = scopes.join(",") if scopes
+
+      "#{api_server}/oauth/authorize?#{URI.encode_www_form(params)}"
+    end
+
     def exchange_code_for_token(code)
       data = {
         "client_id" => app_id,
@@ -149,6 +163,15 @@ module Nylas
       @webhooks ||= Collection.new(model: Webhook, api: as(client.app_secret))
     end
 
+    def free_busy(emails:, start_time:, end_time:)
+      FreeBusyCollection.new(
+        api: self,
+        emails: emails,
+        start_time: start_time.to_i,
+        end_time: end_time.to_i
+      )
+    end
+
     private
 
     def prevent_calling_if_missing_access_token(method_name)

data/lib/nylas/collection.rb

@@ -4,6 +4,7 @@ module Nylas
   # An enumerable for working with index and search endpoints
   class Collection
     attr_accessor :model, :api, :constraints
+
     extend Forwardable
     def_delegators :each, :map, :select, :reject, :to_a, :take
     def_delegators :to_a, :first, :last, :[]
@@ -20,7 +21,7 @@ module Nylas
     end
 
     def create(**attributes)
-      instance = model.new(attributes.merge(api: api))
+      instance = model.new(**attributes.merge(api: api))
       instance.save
       instance
     end
@@ -68,7 +69,7 @@ module Nylas
       return enum_for(:each) unless block_given?
 
       execute.each do |result|
-        yield(model.new(result.merge(api: api)))
+        yield(model.new(**result.merge(api: api)))
       end
     end
 
@@ -118,7 +119,7 @@ module Nylas
     end
 
     def find_raw(id)
-      api.execute(to_be_executed.merge(path: "#{resources_path}/#{id}")).to_s
+      api.execute(**to_be_executed.merge(path: "#{resources_path}/#{id}")).to_s
     end
 
     def resources_path
@@ -126,9 +127,13 @@ module Nylas
     end
 
     def find_model(id)
-      instance = model.from_hash({ id: id }, api: api)
-      instance.reload
-      instance
+      response = api.execute(
+        **to_be_executed.merge(
+          path: "#{resources_path}/#{id}",
+          query: view_query
+        )
+      )
+      model.from_hash(response, api: api)
     end
 
     # @return [Hash] Specification for request to be passed to {API#execute}
@@ -140,7 +145,17 @@ module Nylas
     # Retrieves the data from the API for the particular constraints
     # @return [Hash,Array]
     def execute
-      api.execute(to_be_executed)
+      api.execute(**to_be_executed)
+    end
+
+    private
+
+    def view_query
+      if constraints.view
+        { view: constraints.view }
+      else
+        {}
+      end
     end
   end
 end

data/lib/nylas/constraints.rb

@@ -4,6 +4,7 @@ module Nylas
   # The constraints a particular GET request will include in their query params
   class Constraints
     attr_accessor :where, :limit, :offset, :view, :per_page, :accept
+
     def initialize(where: {}, limit: nil, offset: 0, view: nil, per_page: 100, accept: "application/json")
       self.where = where
       self.limit = limit

data/lib/nylas/contact.rb

@@ -13,9 +13,9 @@ module Nylas
     self.updatable = true
     self.destroyable = true
 
-    attribute :id, :string, exclude_when: %i[creating updating]
+    attribute :id, :string, read_only: true
     attribute :object, :string, default: "contact"
-    attribute :account_id, :string, exclude_when: %i[creating updating]
+    attribute :account_id, :string, read_only: true
 
     attribute :given_name, :string
     attribute :middle_name, :string

data/lib/nylas/delta.rb

@@ -6,6 +6,7 @@ module Nylas
   # @see https://docs.nylas.com/reference#deltas
   class Delta
     include Model::Attributable
+
     attribute :id, :string
     attribute :type, :string
     attribute :object, :string
@@ -24,6 +25,8 @@ module Nylas
       @model ||= Types.registry[object.to_sym].cast(object_attributes_with_ids)
     end
 
+    private
+
     def object_attributes_with_ids
       (object_attributes || {}).merge(id: id, account_id: account_id)
     end
@@ -42,8 +45,10 @@ module Nylas
              else
                data
              end
+
+      data = data.merge(data[:attributes]) if data[:attributes]
       data[:object_attributes] = data.delete(:attributes)
-      super(data)
+      super(**data)
     end
   end
 end

data/lib/nylas/deltas.rb

@@ -14,6 +14,6 @@ module Nylas
     attribute :cursor_end, :string
 
     extend Forwardable
-    def_delegators :deltas, :count, :length, :each, :map, :first, :to_a, :empty?
+    def_delegators :deltas, :count, :length, :each, :map, :first, :last, :to_a, :empty?
   end
 end

data/lib/nylas/deltas_collection.rb

@@ -4,6 +4,7 @@ module Nylas
   # Special collection for delta objects
   class DeltasCollection < Collection
     attr_accessor :deltas
+
     extend Forwardable
     def_delegators :execute, :cursor_start, :cursor_end,
                    :count, :each, :to_h, :to_a, :empty?
@@ -33,7 +34,7 @@ module Nylas
     # Retrieves the data from the API for the particular constraints
     # @return [Detlas]
     def execute
-      self.deltas ||= Deltas.new(api.execute(to_be_executed))
+      self.deltas ||= Deltas.new(**api.execute(**to_be_executed))
     end
   end
 end

data/lib/nylas/draft.rb

@@ -29,7 +29,8 @@ module Nylas
     attribute :unread, :boolean
 
     has_n_of_attribute :events, :event
-    has_n_of_attribute :files, :file
+    has_n_of_attribute :files, :file, read_only: true
+    has_n_of_attribute :file_ids, :string
     attribute :folder, :folder
     has_n_of_attribute :labels, :label
 
@@ -37,6 +38,20 @@ module Nylas
 
     transfer :api, to: %i[events files folder labels]
 
+    def update(**data)
+      self.files = data[:files] if data[:files]
+      extract_file_ids!
+      data[:file_ids] = file_ids
+
+      super
+    end
+
+    def create
+      extract_file_ids!
+
+      super
+    end
+
     def send!
       return execute(method: :post, path: "/send", payload: to_json) if tracking
 
@@ -53,7 +68,21 @@ module Nylas
     end
 
     def destroy
-      execute(method: :delete, path: resource_path, payload: attributes.serialize(keys: [:version]))
+      execute(method: :delete, path: resource_path, payload: attributes.serialize_for_api(keys: [:version]))
+    end
+
+    private
+
+    def save_call
+      extract_file_ids!
+
+      super
+    end
+
+    def extract_file_ids!
+      files = self.files || []
+
+      self.file_ids = files.map(&:id)
     end
   end
 end

data/lib/nylas/event.rb

@@ -9,9 +9,9 @@ module Nylas
     allows_operations(creatable: true, listable: true, filterable: true, showable: true, updatable: true,
                       destroyable: true)
 
-    attribute :id, :string
-    attribute :object, :string
-    attribute :account_id, :string
+    attribute :id, :string, read_only: true
+    attribute :object, :string, read_only: true
+    attribute :account_id, :string, read_only: true
     attribute :calendar_id, :string
     attribute :master_event_id, :string
     attribute :message_id, :string
@@ -27,8 +27,11 @@ module Nylas
     attribute :status, :string
     attribute :title, :string
     attribute :when, :when
+    attribute :metadata, :hash
     attribute :original_start_time, :unix_timestamp
 
+    attr_accessor :notify_participants
+
     def busy?
       busy
     end
@@ -42,5 +45,17 @@ module Nylas
                       event_id: id, account_id: account_id)
       rsvp.save
     end
+
+    private
+
+    def query_params
+      if notify_participants.nil?
+        {}
+      else
+        {
+          notify_participants: notify_participants
+        }
+      end
+    end
   end
 end

data/lib/nylas/file.rb

@@ -18,8 +18,10 @@ module Nylas
     attribute :content_type, :string
     attribute :filename, :string
     attribute :size, :integer
+    attribute :content_disposition, :string
 
     attr_accessor :file
+
     # Downloads and caches a local copy of the file.
     # @return [Tempfile] - Local copy of the file
     def download

data/lib/nylas/free_busy.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Query free/busy information for a calendar during a certain time period
+  # @see https://docs.nylas.com/reference#calendars-free-busy
+  class FreeBusy
+    include Model::Attributable
+
+    attribute :email, :string
+    attribute :object, :string
+    has_n_of_attribute :time_slots, :time_slot
+  end
+end

data/lib/nylas/free_busy_collection.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Helper to get and build `FreeBusy` objects
+  class FreeBusyCollection
+    extend Forwardable
+    def_delegators :each, :map, :select, :reject, :to_a, :take
+    def_delegators :to_a, :first, :last, :[]
+
+    def initialize(emails:, start_time:, end_time:, api:)
+      @api = api
+      @emails = emails
+      @start_time = start_time
+      @end_time = end_time
+    end
+
+    def each
+      return enum_for(:each) unless block_given?
+
+      execute.each do |result|
+        yield(FreeBusy.new(**result))
+      end
+    end
+
+    private
+
+    attr_reader :api, :emails, :start_time, :end_time
+
+    PATH = "/calendars/free-busy"
+    private_constant :PATH
+
+    def execute
+      api.execute(
+        method: :post,
+        path: PATH,
+        payload: payload
+      )
+    end
+
+    def payload
+      JSON.dump(
+        emails: emails,
+        start_time: start_time,
+        end_time: end_time
+      )
+    end
+  end
+end

data/lib/nylas/http_client.rb

@@ -31,6 +31,7 @@ module Nylas
       "/delta/longpoll" => 3650,
       "/delta/streaming" => 3650
     }.freeze
+    SUPPORTED_API_VERSION = "2.2"
 
     include Logging
     attr_accessor :api_server, :service_domain
@@ -103,8 +104,8 @@ module Nylas
                         also_log: { result: true, values: %i[method url path headers query payload] }
 
     def build_request(method:, path: nil, headers: {}, query: {}, payload: nil, timeout: nil)
-      headers[:params] = query
       url ||= url_for_path(path)
+      url = add_query_params_to_url(url, query)
       resulting_headers = default_headers.merge(headers)
       { method: method, url: url, payload: payload, headers: resulting_headers, timeout: timeout }
     end
@@ -137,6 +138,7 @@ module Nylas
       @default_headers ||= {
         "X-Nylas-API-Wrapper" => "ruby",
         "X-Nylas-Client-Id" => @app_id,
+        "Nylas-API-Version" => SUPPORTED_API_VERSION,
         "User-Agent" => "Nylas Ruby SDK #{Nylas::VERSION} - #{RUBY_VERSION}",
         "Content-types" => "application/json"
       }
@@ -176,10 +178,39 @@ module Nylas
 
     def handle_anticipated_failure_mode(http_code:, response:)
       return if http_code == 200
-      return unless response.is_a?(Hash)
 
       exception = HTTP_CODE_TO_EXCEPTIONS.fetch(http_code, APIError)
-      raise exception.new(response[:type], response[:message], response.fetch(:server_error, nil))
+      parsed_response = parse_response(response)
+
+      raise exception.new(
+        parsed_response[:type],
+        parsed_response[:message],
+        parsed_response.fetch(:server_error, nil)
+      )
+    end
+
+    def add_query_params_to_url(url, query)
+      unless query.empty?
+        uri = URI.parse(url)
+        query = custom_params(query)
+        params = URI.decode_www_form(uri.query || "") + query.to_a
+        uri.query = URI.encode_www_form(params)
+        url = uri.to_s
+      end
+
+      url
+    end
+
+    def custom_params(query)
+      # Convert hash to "<key>:<value>" form for metadata_pair query
+      if query.key?(:metadata_pair)
+        pairs = query[:metadata_pair].map do |key, value|
+          "#{key}:#{value}"
+        end
+        query[:metadata_pair] = pairs
+      end
+
+      query
     end
   end
 end

data/lib/nylas/logging.rb

@@ -1,12 +1,9 @@
 # frozen_string_literal: true
 
-# We are explicitely choosing to allow clients to use or not use informed at their discretion
-# rubocop:disable Lint/HandleExceptions
 begin
   require "informed"
 rescue LoadError
 end
-# rubocop:enable Lint/HandleExceptions
 
 module Nylas
   # Exposes a shared logger for debugging purposes

data/lib/nylas/message.rb

@@ -37,7 +37,7 @@ module Nylas
     attribute :folder, :folder
     attribute :folder_id, :string
 
-    has_n_of_attribute :labels, :label, exclude_when: [:saving]
+    has_n_of_attribute :labels, :label, read_only: true
     has_n_of_attribute :label_ids, :string
 
     transfer :api, to: %i[events files folder labels]
@@ -56,7 +56,7 @@ module Nylas
         allowed_attributes: UPDATABLE_ATTRIBUTES
       ).check
 
-      super(payload)
+      super(**payload)
     end
 
     def update_folder(folder_id)
@@ -66,7 +66,7 @@ module Nylas
     def expanded
       return self unless headers.nil?
 
-      assign(api.execute(method: :get, path: resource_path, query: { view: "expanded" }))
+      assign(**api.execute(method: :get, path: resource_path, query: { view: "expanded" }))
       self
     end
 
@@ -75,7 +75,7 @@ module Nylas
 
       execute(
         method: :put,
-        payload: attributes.serialize(keys: allowed_keys_for_save),
+        payload: attributes.serialize_for_api,
         path: resource_path
       )
     end

data/lib/nylas/model.rb

@@ -39,28 +39,63 @@ module Nylas
       !id.nil?
     end
 
-    def execute(method:, payload: nil, path:)
-      api.execute(method: method, payload: payload, path: path)
+    def execute(method:, payload: nil, path:, query: {})
+      api.execute(method: method, payload: payload, path: path, query: query)
     end
 
     def create
       raise ModelNotCreatableError, self unless creatable?
 
-      execute(method: :post, payload: attributes.serialize, path: resources_path)
+      execute(
+        method: :post,
+        payload: attributes.serialize_for_api,
+        path: resources_path,
+        query: query_params
+      )
     end
 
     def update(**data)
       raise ModelNotUpdatableError, model_class unless updatable?
 
       attributes.merge(**data)
-      execute(method: :put, payload: attributes.serialize(keys: data.keys), path: resource_path)
+      payload = attributes.serialize_for_api(keys: data.keys)
+      update_call(payload)
+
+      true
+    rescue Registry::MissingKeyError => e
+      raise ModelMissingFieldError.new(e.key, self)
+    end
+
+    def save_all_attributes
+      result = if persisted?
+                 raise ModelNotUpdatableError, self unless updatable?
+
+                 execute(
+                   method: :put,
+                   payload: attributes.serialize_all_for_api,
+                   path: resource_path
+                 )
+               else
+                 create
+               end
+
+      attributes.merge(result)
+    end
+
+    def update_all_attributes(**data)
+      raise ModelNotUpdatableError, model_class unless updatable?
+
+      attributes.merge(**data)
+      payload = attributes.serialize_all_for_api(keys: data.keys)
+      update_call(payload)
+
       true
     rescue Registry::MissingKeyError => e
       raise ModelMissingFieldError.new(e.key, self)
     end
 
     def reload
-      assign(execute(method: :get, path: resource_path))
+      assign(**execute(method: :get, path: resource_path))
       true
     end
 
@@ -75,7 +110,7 @@ module Nylas
     def destroy
       raise ModelNotDestroyableError, self unless destroyable?
 
-      execute(method: :delete, path: resource_path)
+      execute(method: :delete, path: resource_path, query: query_params)
     end
 
     # @return [String] JSON String of the model.
@@ -85,20 +120,28 @@ module Nylas
 
     private
 
-    def allowed_keys_for_save
-      attributes.attribute_definitions.to_h.reject do |_k, v|
-        v.exclude_when.include?(:saving)
-      end.keys
-    end
-
     def save_call
       execute(
         method: :put,
-        payload: attributes.serialize(keys: allowed_keys_for_save),
+        payload: attributes.serialize_for_api,
         path: resource_path
       )
     end
 
+    def update_call(payload)
+      result = execute(
+        method: :put,
+        payload: payload,
+        path: resource_path,
+        query: query_params
+      )
+      attributes.merge(result) if result
+    end
+
+    def query_params
+      {}
+    end
+
     # Allows you to narrow in exactly what kind of model you're working with
     module ClassMethods
       attr_accessor :raw_mime_type, :creatable, :showable, :filterable, :searchable, :listable, :updatable,

data/lib/nylas/model/attributable.rb

@@ -34,17 +34,22 @@ module Nylas
       # Methods to call when tweaking Attributable classes
       module ClassMethods
         # rubocop:disable Naming/PredicateName
-        def has_n_of_attribute(name, type_name, exclude_when: [], default: [])
-          attribute_definitions[name] = ListAttributeDefinition.new(type_name: type_name,
-                                                                    exclude_when: exclude_when,
-                                                                    default: default)
+        def has_n_of_attribute(name, type_name, read_only: false, default: [])
+          attribute_definitions[name] = ListAttributeDefinition.new(
+            type_name: type_name,
+            read_only: read_only,
+            default: default
+          )
           define_accessors(name)
         end
         # rubocop:enable Naming/PredicateName
 
-        def attribute(name, type_name, exclude_when: [], default: nil)
-          attribute_definitions[name] = AttributeDefinition.new(type_name: type_name,
-                                                                exclude_when: exclude_when, default: default)
+        def attribute(name, type_name, read_only: false, default: nil)
+          attribute_definitions[name] = AttributeDefinition.new(
+            type_name: type_name,
+            read_only: read_only,
+            default: default
+          )
           define_accessors(name)
         end
 

data/lib/nylas/model/attribute_definition.rb

@@ -6,10 +6,11 @@ module Nylas
     class AttributeDefinition
       extend Forwardable
       def_delegators :type, :cast, :serialize
-      attr_accessor :type_name, :exclude_when, :default
-      def initialize(type_name:, exclude_when:, default:)
+      attr_accessor :type_name, :read_only, :default
+
+      def initialize(type_name:, read_only:, default:)
         self.type_name = type_name
-        self.exclude_when = exclude_when
+        self.read_only = read_only
         self.default = default
       end
 

data/lib/nylas/model/attributes.rb

@@ -39,6 +39,22 @@ module Nylas
         JSON.dump(to_h(keys: keys))
       end
 
+      def serialize_for_api(keys: attribute_definitions.keys)
+        api_keys = keys.delete_if { |key| attribute_definitions[key].read_only == true }
+
+        serialize(keys: api_keys)
+      end
+
+      def serialize_all_for_api(keys: attribute_definitions.keys)
+        api_keys = keys.delete_if { |key| attribute_definitions[key].read_only == true }
+
+        JSON.dump(
+          api_keys.each_with_object({}) do |key, casted_data|
+            casted_data[key] = attribute_definitions[key].serialize(self[key])
+          end
+        )
+      end
+
       private
 
       def cast(key, value)

data/lib/nylas/model/list_attribute_definition.rb

@@ -4,11 +4,11 @@ module Nylas
   module Model
     # Allows models to have an attribute which is a lists of another type of thing
     class ListAttributeDefinition
-      attr_accessor :type_name, :exclude_when, :default
+      attr_accessor :type_name, :read_only, :default
 
-      def initialize(type_name:, exclude_when:, default:)
+      def initialize(type_name:, read_only:, default:)
         self.type_name = type_name
-        self.exclude_when = exclude_when
+        self.read_only = read_only
         self.default = default
       end
 

data/lib/nylas/model/transferable.rb

@@ -39,6 +39,7 @@ module Nylas
       # Methods to call when tweaking Transferable classes
       module ClassMethods
         attr_accessor :attribute_recipients
+
         def init_attribute_recipients
           self.attribute_recipients ||= {}
         end

data/lib/nylas/native_authentication.rb

@@ -5,6 +5,7 @@ module Nylas
   # @see https://docs.nylas.com/reference#native-authentication-1
   class NativeAuthentication
     attr_accessor :api
+
     def initialize(api:)
       self.api = api
     end

data/lib/nylas/raw_message.rb

@@ -4,14 +4,22 @@ module Nylas
   # Allows sending of email with nylas from an rfc822 compatible string
   class RawMessage
     attr_accessor :api, :mime_compatible_string
+
     def initialize(mime_compatible_string, api:)
       self.api = api
       self.mime_compatible_string = mime_compatible_string
     end
 
     def send!
-      Message.new(api.execute(method: :post, path: "/send", payload: mime_compatible_string,
-                              headers: { "Content-type" => "message/rfc822" }).merge(api: api))
+      Message.new(**api.execute(
+        method: :post,
+        path: "/send",
+        payload: mime_compatible_string,
+        headers: HEADERS
+      ).merge(api: api))
     end
+
+    HEADERS = { "Content-type" => "message/rfc822" }.freeze
+    private_constant :HEADERS
   end
 end

data/lib/nylas/registry.rb

@@ -8,6 +8,7 @@ module Nylas
     # Includes the list of keys in the registry for debug purposes.
     class MissingKeyError < Error
       attr_accessor :key
+
       def initialize(key, keys)
         super("key #{key} not in #{keys}")
         self.key = key

data/lib/nylas/rsvp.rb

@@ -13,8 +13,12 @@ module Nylas
     attr_accessor :notify_participants
 
     def save
-      api.execute(method: :post, path: "/send-rsvp", payload: attributes.serialize,
-                  query: { notify_participants: notify_participants })
+      api.execute(
+        method: :post,
+        path: "/send-rsvp",
+        payload: attributes.serialize_for_api,
+        query: { notify_participants: notify_participants }
+      )
     end
   end
 end

data/lib/nylas/thread.rb

@@ -42,7 +42,7 @@ module Nylas
         raise ArgumentError, "Cannot update #{unupdatable_attributes} only " \
                              "#{UPDATABLE_ATTRIBUTES} are updatable"
       end
-      super(data)
+      super(**data)
     end
 
     def update_folder(folder_id)

data/lib/nylas/time_slot.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Query free/busy information for a calendar during a certain time period
+  # @see https://docs.nylas.com/reference#calendars-free-busy
+  class TimeSlot
+    include Model::Attributable
+
+    attribute :object, :string
+    attribute :status, :string
+    attribute :start_time, :unix_timestamp
+    attribute :end_time, :unix_timestamp
+  end
+end

data/lib/nylas/types.rb

@@ -24,6 +24,7 @@ module Nylas
     # {Model} or Model-like thing.
     class ModelType
       attr_accessor :model
+
       def initialize(model:)
         self.model = model
       end
@@ -87,6 +88,7 @@ module Nylas
 
       def serialize(object)
         return nil if object.nil?
+
         object.to_i
       end
     end

data/lib/nylas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nylas
-  VERSION = "4.6.4"
+  VERSION = "5.1.0"
 end

data/lib/nylas/when.rb

@@ -8,7 +8,7 @@ module Nylas
 
     include Model::Attributable
 
-    attribute :object, :string
+    attribute :object, :string, read_only: true
 
     # when object == 'date'
     attribute :date, :date

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 4.6.4
+  version: 5.1.0
 platform: ruby
 authors:
 - Nylas, Inc.
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-02-04 00:00:00.000000000 Z
+date: 2021-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.0
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -300,6 +286,8 @@ files:
 - lib/nylas/file.rb
 - lib/nylas/filter_attributes.rb
 - lib/nylas/folder.rb
+- lib/nylas/free_busy.rb
+- lib/nylas/free_busy_collection.rb
 - lib/nylas/http_client.rb
 - lib/nylas/im_address.rb
 - lib/nylas/label.rb
@@ -325,13 +313,14 @@ files:
 - lib/nylas/rsvp.rb
 - lib/nylas/search_collection.rb
 - lib/nylas/thread.rb
+- lib/nylas/time_slot.rb
 - lib/nylas/timespan.rb
 - lib/nylas/types.rb
 - lib/nylas/version.rb
 - lib/nylas/web_page.rb
 - lib/nylas/webhook.rb
 - lib/nylas/when.rb
-homepage: 
+homepage:
 licenses:
 - MIT
 metadata:
@@ -341,7 +330,7 @@ metadata:
   homepage_uri: https://www.nylas.com
   source_code_uri: https://github.com/nylas/nylas-ruby
   wiki_uri: https://github.com/nylas/nylas-ruby/wiki
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -356,8 +345,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.5
-signing_key: 
+rubygems_version: 3.2.17
+signing_key:
 specification_version: 4
 summary: Gem for interacting with the Nylas API
 test_files: []