nylas 4.3.1 → 4.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1e945b844e954e39741b61d93783e5ed42803c3f6880cab4b497f68632aac43
-  data.tar.gz: 5e933fe3f10e94576c224a1afba2ae2e17949c6f1039f73b981bfcba523a2dcd
+  metadata.gz: 25e0ba2a96bed5ddf666a1dfd4ca590039b555d4e3917ec2c9a5b24bb2b97c1a
+  data.tar.gz: e8f459d8ce121e5fbf26ecfac41836f173cb55eed5423f883bb3ce3f5092ae1f
 SHA512:
-  metadata.gz: 4659f0f22c32eb962094312ecdea1e0d142f58966aecf44f2014464a7868f43e3cc43ce485249730db749e4bea86bd7fdf5081d7f5007de0fa10fc9f6d8c4d20
-  data.tar.gz: f0186a146957f40d1a72607c14a60a23a91def1fc0df5a643933e21c5fc2fb31c430ba5bbcd6d4669a164ce758973d5b9f52f12b0564964d961db135aa3feeef
+  metadata.gz: 3c4df432759f47064f5e1601cfc70a36d6bf80551df7a067d74766be2fba1a048a6af5d222f2b1a25b356f579d110e036d1155d2351fc8fa7cf7e6bdaa19fa56
+  data.tar.gz: 66f9f88677d6d3893fa4dc35742e8d05457bcd69a2d6b94b9afe8bff8cf40c4eb80d30edd4813d8d82431fdc00dced2223f24a73513178617704ddc081e33f0d

data/lib/nylas.rb

@@ -35,6 +35,7 @@ require_relative "nylas/rsvp"
 require_relative "nylas/timespan"
 require_relative "nylas/web_page"
 require_relative "nylas/nylas_date"
+require_relative "nylas/when"
 
 # Custom collection types
 require_relative "nylas/search_collection"
@@ -60,6 +61,7 @@ require_relative "nylas/native_authentication"
 require_relative "nylas/http_client"
 require_relative "nylas/api"
 
+require_relative "nylas/filter_attributes"
 # an SDK for interacting with the Nylas API
 # @see https://docs.nylas.com/reference
 module Nylas
@@ -86,4 +88,5 @@ module Nylas
   Types.registry[:web_page] = Types::ModelType.new(model: WebPage)
   Types.registry[:nylas_date] = NylasDateType.new
   Types.registry[:contact_group] = Types::ModelType.new(model: ContactGroup)
+  Types.registry[:when] = Types::ModelType.new(model: When)
 end

data/lib/nylas/api.rb

@@ -36,11 +36,28 @@ module Nylas
       )
     end
 
+    def exchange_code_for_token(code)
+      data = {
+        "client_id" => app_id,
+        "client_secret" => client.app_secret,
+        "grant_type" => "authorization_code",
+        "code" => code
+      }
+
+      response_json = execute(method: :post, path: "/oauth/token", payload: data)
+      response_json[:access_token]
+    end
+
     # @return [Collection<Contact>] A queryable collection of Contacts
     def contacts
       @contacts ||= Collection.new(model: Contact, api: self)
     end
 
+    # @return [Collection<ContactGroup>] A queryable collection of Contact Groups
+    def contact_groups
+      @contact_groups ||= Collection.new(model: ContactGroup, api: self)
+    end
+
     # @return [CurrentAccount] The account details for whomevers access token is set
     def current_account
       prevent_calling_if_missing_access_token(:current_account)
@@ -99,6 +116,14 @@ module Nylas
       response.code == 200 && response.empty?
     end
 
+    # Returns list of IP addresses
+    # @return [Hash]
+    # hash has keys of :updated_at (unix timestamp) and :ip_addresses (array of strings)
+    def ip_addresses
+      path = "/a/#{app_id}/ip_addresses"
+      client.as(client.app_secret).get(path: path)
+    end
+
     # @param message [Hash, String, #send!]
     # @return [Message] The resulting message
     def send!(message)

data/lib/nylas/calendar.rb

@@ -15,6 +15,9 @@ module Nylas
 
     attribute :name, :string
     attribute :description, :string
+    attribute :is_primary, :boolean
+    attribute :location, :string
+    attribute :timezone, :string
 
     attribute :read_only, :boolean
 
@@ -22,6 +25,10 @@ module Nylas
       read_only == true
     end
 
+    def primary?
+      is_primary
+    end
+
     def events
       api.events.where(calendar_id: id)
     end

data/lib/nylas/contact.rb

@@ -29,7 +29,7 @@ module Nylas
     attribute :manager_name, :string
     attribute :office_location, :string
     attribute :notes, :string
-    attribute :web_page, :web_page
+    attribute :source, :string
 
     has_n_of_attribute :groups, :contact_group
     has_n_of_attribute :emails, :email_address

data/lib/nylas/contact_group.rb

@@ -4,7 +4,16 @@ module Nylas
   # Structure to represent the Contact Group schema
   # @see https://docs.nylas.com/reference#contactsid
   class ContactGroup
-    include Model::Attributable
+    include Model
+    self.resources_path = "/contacts/groups"
+
+    self.creatable = false
+    self.destroyable = false
+    self.filterable = false
+    self.listable = true
+    self.showable = false
+    self.updatable = false
+
     attribute :id, :string
     attribute :object, :string
     attribute :account_id, :string

data/lib/nylas/draft.rb

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

data/lib/nylas/event.rb

@@ -13,9 +13,9 @@ module Nylas
     attribute :object, :string
     attribute :account_id, :string
     attribute :calendar_id, :string
-    attribute :ical_uid, :string
     attribute :master_event_id, :string
     attribute :message_id, :string
+    attribute :ical_uid, :string
 
     attribute :busy, :boolean
     attribute :description, :string
@@ -26,7 +26,7 @@ module Nylas
     attribute :read_only, :boolean
     attribute :status, :string
     attribute :title, :string
-    attribute :when, :timespan
+    attribute :when, :when
     attribute :original_start_time, :unix_timestamp
 
     def busy?

data/lib/nylas/file.rb

@@ -56,7 +56,7 @@ 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)
+      temp_file = Tempfile.new(filename, encoding: "ascii-8bit")
       temp_file.write(response.body)
       temp_file.seek(0)
       temp_file

data/lib/nylas/filter_attributes.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Methods to check and raise error if extra attributes are present
+  class FilterAttributes
+    def initialize(attributes:, allowed_attributes:)
+      @attributes = attributes
+      @allowed_attributes = allowed_attributes
+    end
+
+    def check
+      return if extra_attributes.empty?
+
+      raise ArgumentError, "Only #{allowed_attributes} are allowed to be sent"
+    end
+
+    private
+
+    attr_reader :attributes, :allowed_attributes
+
+    def extra_attributes
+      attributes - allowed_attributes
+    end
+  end
+end

data/lib/nylas/message.rb

@@ -8,6 +8,7 @@ module Nylas
     self.raw_mime_type = "message/rfc822"
     self.resources_path = "/messages"
     allows_operations(showable: true, listable: true, filterable: true, searchable: true, updatable: true)
+    UPDATABLE_ATTRIBUTES = %i[label_ids folder_id starred unread].freeze
 
     attribute :id, :string
     attribute :object, :string
@@ -34,7 +35,12 @@ module Nylas
     has_n_of_attribute :events, :event
     has_n_of_attribute :files, :file
     attribute :folder, :folder
-    has_n_of_attribute :labels, :label
+    attribute :folder_id, :string
+
+    has_n_of_attribute :labels, :label, exclude_when: [:saving]
+    has_n_of_attribute :label_ids, :string
+
+    transfer :api, to: %i[events files folder labels]
 
     def starred?
       starred
@@ -44,6 +50,19 @@ module Nylas
       unread
     end
 
+    def update(payload)
+      FilterAttributes.new(
+        attributes: payload.keys,
+        allowed_attributes: UPDATABLE_ATTRIBUTES
+      ).check
+
+      super(payload)
+    end
+
+    def update_folder(folder_id)
+      update(folder_id: folder_id)
+    end
+
     def expanded
       return self unless headers.nil?
 

data/lib/nylas/model.rb

@@ -4,6 +4,7 @@ require_relative "model/attribute_definition"
 require_relative "model/list_attribute_definition"
 require_relative "model/attributable"
 require_relative "model/attributes"
+require_relative "model/transferable"
 module Nylas
   # Include this to define a class to represent an object returned from the API
   module Model
@@ -15,6 +16,7 @@ module Nylas
 
     def self.included(model)
       model.include(Attributable)
+      model.include(Transferable)
       model.extend(ClassMethods)
       model.extend(Forwardable)
       model.def_delegators :model_class, :creatable?, :filterable?, :listable?, :searchable?, :showable?,
@@ -26,7 +28,7 @@ module Nylas
       result = if persisted?
                  raise ModelNotUpdatableError, self unless updatable?
 
-                 execute(method: :put, payload: attributes.serialize, path: resource_path)
+                 save_call
                else
                  create
                end
@@ -77,10 +79,26 @@ module Nylas
     end
 
     # @return [String] JSON String of the model.
-    def to_json
+    def to_json(_opts = {})
       JSON.dump(to_h)
     end
 
+    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),
+        path: resource_path
+      )
+    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

@@ -2,7 +2,7 @@
 
 module Nylas
   module Model
-    # Allows defining of tyypecastable attributes on a model
+    # Allows defining of typecastable attributes on a model
     module Attributable
       def self.included(model)
         model.extend(ClassMethods)
@@ -12,16 +12,6 @@ module Nylas
         assign(**initial_data)
       end
 
-      protected def assign(**data) # rubocop:disable Style/AccessModifierDeclarations
-        data.each do |attribute_name, value|
-          if respond_to?(:"#{attribute_name}=")
-            send(:"#{attribute_name}=", value)
-          else
-            Logging.logger.warn("#{attribute_name} is not defined as an attribute on #{self.class.name}")
-          end
-        end
-      end
-
       def attributes
         @attributes ||= Attributes.new(self.class.attribute_definitions)
       end
@@ -31,6 +21,16 @@ module Nylas
         attributes.to_h
       end
 
+      protected
+
+      def assign(**data)
+        data.each do |attribute_name, value|
+          if respond_to?(:"#{attribute_name}=")
+            send(:"#{attribute_name}=", value)
+          end
+        end
+      end
+
       # Methods to call when tweaking Attributable classes
       module ClassMethods
         # rubocop:disable Naming/PredicateName

data/lib/nylas/model/attributes.rb

@@ -17,6 +17,8 @@ module Nylas
 
       def []=(key, value)
         data[key] = cast(key, value)
+      rescue Nylas::Registry::MissingKeyError
+        # Don't crash when a new attribute is added
       end
 
       # Merges data into the registry while casting input types correctly

data/lib/nylas/model/transferable.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Nylas
+  module Model
+    # Allows definition of attributes, which should transfer to other dependent attributes
+    module Transferable
+      def self.included(model)
+        model.extend(ClassMethods)
+        model.init_attribute_recipients
+      end
+
+      def initialize(**initial_data)
+        assign(**initial_data)
+        transfer_attributes
+      end
+
+      private
+
+      def transfer_attributes
+        self.class.attribute_recipients.each_pair do |name, recipient_names|
+          value = send(:"#{name}")
+          next if value.nil?
+
+          recipient_names.each do |recipient_name|
+            recipient = send(:"#{recipient_name}")
+            transfer_to_recipient(name, value, recipient) unless recipient.nil?
+          end
+        end
+      end
+
+      def transfer_to_recipient(name, value, recipient)
+        if recipient.respond_to?(:each)
+          recipient.each { |item| item.send(:"#{name}=", value) }
+        else
+          recipient.send(:"#{name}=", value)
+        end
+      end
+
+      # Methods to call when tweaking Transferable classes
+      module ClassMethods
+        attr_accessor :attribute_recipients
+        def init_attribute_recipients
+          self.attribute_recipients ||= {}
+        end
+
+        def transfer(*attributes, **opts)
+          attributes.each { |name| self.attribute_recipients[name] = opts[:to] }
+        end
+      end
+    end
+  end
+end

data/lib/nylas/thread.rb

@@ -33,6 +33,8 @@ module Nylas
 
     has_n_of_attribute :label_ids, :string
 
+    transfer :api, to: %i[labels folders]
+
     UPDATABLE_ATTRIBUTES = %i[label_ids folder_id starred unread].freeze
     def update(data)
       unupdatable_attributes = data.keys.reject { |name| UPDATABLE_ATTRIBUTES.include?(name) }
@@ -43,6 +45,10 @@ module Nylas
       super(data)
     end
 
+    def update_folder(folder_id)
+      update(folder_id: folder_id)
+    end
+
     def starred?
       starred
     end

data/lib/nylas/types.rb

@@ -86,6 +86,7 @@ module Nylas
       end
 
       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.3.1"
+  VERSION = "4.6.2"
 end

data/lib/nylas/when.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Structure to represent all the Nylas time types.
+  # @see https://docs.nylas.com/reference#section-time
+  class When
+    extend Forwardable
+
+    include Model::Attributable
+
+    attribute :object, :string
+
+    # when object == 'date'
+    attribute :date, :date
+
+    # when object == 'datespan'
+    attribute :start_date, :date
+    attribute :end_date, :date
+
+    # when object == 'time'
+    attribute :time, :unix_timestamp
+
+    # when object == 'timespan'
+    attribute :start_time, :unix_timestamp
+    attribute :end_time, :unix_timestamp
+
+    def_delegators :range, :cover?
+
+    def as_timespan
+      return unless object == "timespan"
+
+      Timespan.new(object: object, start_time: start_time, end_time: end_time)
+    end
+
+    def range
+      case object
+      when "timespan"
+        Range.new(start_time, end_time)
+      when "datespan"
+        Range.new(start_date, end_date)
+      when "date"
+        Range.new(date, date)
+      when "time"
+        Range.new(time, time)
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 4.3.1
+  version: 4.6.2
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-07 00:00:00.000000000 Z
+date: 2020-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -278,6 +278,7 @@ files:
 - lib/nylas/event.rb
 - lib/nylas/event_collection.rb
 - lib/nylas/file.rb
+- lib/nylas/filter_attributes.rb
 - lib/nylas/folder.rb
 - lib/nylas/http_client.rb
 - lib/nylas/im_address.rb
@@ -291,6 +292,7 @@ files:
 - lib/nylas/model/attribute_definition.rb
 - lib/nylas/model/attributes.rb
 - lib/nylas/model/list_attribute_definition.rb
+- lib/nylas/model/transferable.rb
 - lib/nylas/native_authentication.rb
 - lib/nylas/new_message.rb
 - lib/nylas/nylas_date.rb
@@ -308,6 +310,7 @@ files:
 - lib/nylas/version.rb
 - lib/nylas/web_page.rb
 - lib/nylas/webhook.rb
+- lib/nylas/when.rb
 homepage: 
 licenses:
 - MIT
@@ -326,15 +329,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: Gem for interacting with the Nylas API