nylas 4.6.2 → 4.6.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25e0ba2a96bed5ddf666a1dfd4ca590039b555d4e3917ec2c9a5b24bb2b97c1a
-  data.tar.gz: e8f459d8ce121e5fbf26ecfac41836f173cb55eed5423f883bb3ce3f5092ae1f
+  metadata.gz: 6dd52077bca505902f8fe016a103318a1c426f74f01235a36c27a2463478f101
+  data.tar.gz: 91f2addf66e656561881e721402955080f6e040536c3168737f7b62a4b74a9dd
 SHA512:
-  metadata.gz: 3c4df432759f47064f5e1601cfc70a36d6bf80551df7a067d74766be2fba1a048a6af5d222f2b1a25b356f579d110e036d1155d2351fc8fa7cf7e6bdaa19fa56
-  data.tar.gz: 66f9f88677d6d3893fa4dc35742e8d05457bcd69a2d6b94b9afe8bff8cf40c4eb80d30edd4813d8d82431fdc00dced2223f24a73513178617704ddc081e33f0d
+  metadata.gz: ed82717d82cdc4b5fed03a09e7ee1553ba16071e4603b8cedce2518871fc44e2b34c8bd0ce5d9e077bb492a1d216de577264da104014c75e9964b44f7a238e52
+  data.tar.gz: be58aff204cad1ce196f8fbeb766708d407d135a8247c484292a5a16fd821119727d21ded457b2b80650b58fc9c70d2a07c38dfc4beea94dc143454bc9377136

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,6 +4,7 @@ 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
 
@@ -149,6 +150,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: {}
+        )
+      )
+      model.from_hash(response, api: api)
     end
 
     # @return [Hash] Specification for request to be passed to {API#execute}
@@ -140,7 +145,7 @@ 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
   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/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

@@ -33,9 +33,13 @@ module Nylas
     attribute :folder, :folder
     has_n_of_attribute :labels, :label
 
+    attribute :tracking, :message_tracking
+
     transfer :api, to: %i[events files folder labels]
 
     def send!
+      return execute(method: :post, path: "/send", payload: to_json) if tracking
+
       save
       execute(method: :post, path: "/send", payload: JSON.dump(draft_id: id, version: version))
     end

data/lib/nylas/errors.rb

@@ -14,6 +14,8 @@ module Nylas
   class ModelNotUpdatableError < ModelActionError; end
   class ModelNotDestroyableError < ModelActionError; end
 
+  class JsonParseError < Error; end
+
   # Raised when attempting to set a field that is not on a model with mass assignment
   class ModelMissingFieldError < ModelActionError
     def initialize(field, model)
@@ -48,6 +50,10 @@ module Nylas
   ResourceNotFound = Class.new(APIError)
   MethodNotAllowed = Class.new(APIError)
   InvalidRequest = Class.new(APIError)
+  UnauthorizedRequest = Class.new(APIError)
+  ResourceRemoved = Class.new(APIError)
+  TeapotError = Class.new(APIError)
+  RequestTimedOut = Class.new(APIError)
   MessageRejected = Class.new(APIError)
   SendingQuotaExceeded = Class.new(APIError)
   ServiceUnavailable = Class.new(APIError)

data/lib/nylas/event.rb

@@ -29,6 +29,8 @@ module Nylas
     attribute :when, :when
     attribute :original_start_time, :unix_timestamp
 
+    attr_accessor :notify_participants
+
     def busy?
       busy
     end
@@ -42,5 +44,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
@@ -56,7 +58,9 @@ module Nylas
     def retrieve_file
       response = api.get(path: "#{resource_path}/download")
       filename = response.headers.fetch(:content_disposition, "").gsub("attachment; filename=", "")
-      temp_file = Tempfile.new(filename, encoding: "ascii-8bit")
+      # The returned filename can be longer than 256 chars which isn't supported by rb_sysopen.
+      # 128 chars here is more than enough given that TempFile ensure the filename will be unique.
+      temp_file = Tempfile.new(filename[0..127], encoding: "ascii-8bit")
       temp_file.write(response.body)
       temp_file.seek(0)
       temp_file

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

@@ -1,20 +1,26 @@
 # frozen_string_literal: true
 
 module Nylas
+  require "yajl"
+
   # Plain HTTP client that can be used to interact with the Nylas API sans any type casting.
   class HttpClient # rubocop:disable Metrics/ClassLength
     HTTP_CODE_TO_EXCEPTIONS = {
       400 => InvalidRequest,
+      401 => UnauthorizedRequest,
       402 => MessageRejected,
       403 => AccessDenied,
       404 => ResourceNotFound,
       405 => MethodNotAllowed,
+      410 => ResourceRemoved,
+      418 => TeapotError,
       422 => MailProviderError,
       429 => SendingQuotaExceeded,
       500 => InternalError,
       501 => EndpointNotYetImplemented,
       502 => BadGateway,
-      503 => ServiceUnavailable
+      503 => ServiceUnavailable,
+      504 => RequestTimedOut
     }.freeze
 
     ENDPOINT_TIMEOUTS = {
@@ -80,7 +86,14 @@ module Nylas
         timeout: timeout
       )
       rest_client_execute(**request) do |response, _request, result|
-        response = parse_response(response)
+        content_type = nil
+
+        if response.headers && response.headers[:content_type]
+          content_type = response.headers[:content_type].downcase
+        end
+
+        response = parse_response(response) if content_type == "application/json"
+
         handle_failed_response(result: result, response: response)
         response
       end
@@ -130,9 +143,12 @@ module Nylas
     end
 
     def parse_response(response)
-      response.is_a?(Enumerable) ? response : JSON.parse(response, symbolize_names: true)
-    rescue JSON::ParserError
-      response
+      return response if response.is_a?(Enumerable)
+
+      json = StringIO.new(response)
+      Yajl::Parser.new(symbolize_names: true).parse(json)
+    rescue Yajl::ParseError
+      raise Nylas::JsonParseError
     end
     inform_on :parse_response, level: :debug, also_log: { result: true }
 

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

@@ -56,7 +56,7 @@ module Nylas
         allowed_attributes: UPDATABLE_ATTRIBUTES
       ).check
 
-      super(payload)
+      super(**payload)
     end
 
     def update_folder(folder_id)
@@ -66,8 +66,26 @@ 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
+
+    def save_call
+      handle_folder
+
+      execute(
+        method: :put,
+        payload: attributes.serialize(keys: allowed_keys_for_save),
+        path: resource_path
+      )
+    end
+
+    def handle_folder
+      return if folder.nil?
+
+      self.folder_id = folder.id if folder_id.nil? && !self.to_h.dig(:folder, :id).nil?
+
+      self.folder = nil
+    end
   end
 end

data/lib/nylas/model.rb

@@ -39,28 +39,38 @@ 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,
+        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)
+      execute(
+        method: :put,
+        payload: attributes.serialize(keys: data.keys),
+        path: resource_path,
+        query: query_params
+      )
       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 +85,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.
@@ -99,6 +109,10 @@ module Nylas
       )
     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/attribute_definition.rb

@@ -7,6 +7,7 @@ module Nylas
       extend Forwardable
       def_delegators :type, :cast, :serialize
       attr_accessor :type_name, :exclude_when, :default
+
       def initialize(type_name:, exclude_when:, default:)
         self.type_name = type_name
         self.exclude_when = exclude_when

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/new_message.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Nylas
-  # Data structure for seending a message via the Nylas API
+  # Data structure for sending a message via the Nylas API
   class NewMessage
     include Model
     self.creatable = false
@@ -15,6 +15,7 @@ module Nylas
     has_n_of_attribute :from, :email_address
     has_n_of_attribute :cc, :email_address
     has_n_of_attribute :bcc, :email_address
+    has_n_of_attribute :reply_to, :email_address
 
     attribute :subject, :string
     attribute :body, :string

data/lib/nylas/physical_address.rb

@@ -12,5 +12,6 @@ module Nylas
     attribute :state, :string
     attribute :city, :string
     attribute :country, :string
+    attribute :secondary_address, :string
   end
 end

data/lib/nylas/raw_message.rb

@@ -4,6 +4,7 @@ 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

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/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.2"
+  VERSION = "4.6.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 4.6.2
+  version: 4.6.7
 platform: ruby
 authors:
 - Nylas, Inc.
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-09-09 00:00:00.000000000 Z
+date: 2021-04-22 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
@@ -240,7 +226,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '2.0'
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -250,10 +236,30 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '2.0'
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
 description: Gem for interacting with the Nylas API.
 email: support@nylas.com
 executables: []
@@ -280,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
@@ -305,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:
@@ -321,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
@@ -336,8 +345,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.8
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: Gem for interacting with the Nylas API
 test_files: []