nylas 5.4.1 → 5.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29f07de83f9f9129d2604b28ad5efd02d21cdc81075e92b16129d6ebfb3509fc
-  data.tar.gz: f1259c4907de58f04082c6c2e0a80a7d2d50b99a13efc70714f7370ead25d420
+  metadata.gz: 23edacaacec01d7cfd4c182647c30287d27b6ef790ec4abb7a83f98afa17782a
+  data.tar.gz: 3303d603caaf9a5be367fd5983f5350a61460575ddd7978c475c7eaf8be88727
 SHA512:
-  metadata.gz: 9117a61ff796ee58ee596d2ce7f1d41874a0f79f452d678f66dc768e8cf7db59580085f069946e4d4a634b47a85ebd4696f59b59960ecdec805c0244575bbc7a
-  data.tar.gz: b53cedb0c8c2334da1f6e092819eea787ec4c856eafdb606ce29713605eed834044e780dfd6ed6fafc0ee47c6c1bfd48d947237dc4dd9a6d84d531c4c5cc1daf
+  metadata.gz: af4b7703eb190cbebcc2dac2777ea8cc3a9dbc77dc07604ffd11b3d5aaf4b8085afe60512cca8698bae58f1729c6adee6dd3fe03ae68bb0139ce0c0f208f91cb
+  data.tar.gz: f2060e79d3fe69ba18cb7fc35647504b4f5c66c0ba7c8e41d861b058991e109c5c2a0ec3c1a505eb9ec11d45c8ee9f359f988ade593685af5bf6a157b1029833

data/lib/nylas/api.rb

@@ -83,7 +83,7 @@ module Nylas
 
     # @return [Collection<Calendar>] A queryable collection of {Calendar}s
     def calendars
-      @calendars ||= Collection.new(model: Calendar, api: self)
+      @calendars ||= CalendarCollection.new(model: Calendar, api: self)
     end
 
     # @return [DeltasCollection<Delta>] A queryable collection of Deltas, which are themselves a collection.
@@ -126,11 +126,24 @@ module Nylas
       @room_resources ||= Collection.new(model: RoomResource, api: self)
     end
 
+    # @return[Collection<Scheduler>] A queryable collection of {Scheduler} objects
+    def scheduler
+      # Make a deep copy of the API as the scheduler API uses a different base URL
+      scheduler_api = Marshal.load(Marshal.dump(self))
+      scheduler_api.client.api_server = "https://api.schedule.nylas.com"
+      @scheduler ||= Collection.new(model: Scheduler, api: scheduler_api)
+    end
+
     # @return[Neural] A {Neural} object that provides
     def neural
       @neural ||= Neural.new(api: self)
     end
 
+    # @return [Collection<Component>] A queryable collection of {Component}s
+    def components
+      @components ||= ComponentCollection.new(model: Component, api: as(client.app_secret))
+    end
+
     # Revokes access to the Nylas API for the given access token
     # @return [Boolean]
     def revoke(access_token)
@@ -171,6 +184,7 @@ module Nylas
       @webhooks ||= Collection.new(model: Webhook, api: as(client.app_secret))
     end
 
+    # TODO: Move this into calendar collection
     def free_busy(emails:, start_time:, end_time:)
       FreeBusyCollection.new(
         api: self,

data/lib/nylas/calendar_collection.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Additional methods for some of Calendar's other functionality
+  # @see https://developer.nylas.com/docs/connectivity/calendar
+  class CalendarCollection < Collection
+    def availability(duration_minutes:,
+                     interval:,
+                     start_time:,
+                     end_time:,
+                     emails:,
+                     buffer: nil,
+                     round_robin: nil,
+                     free_busy: [],
+                     open_hours: [])
+      validate_open_hours(emails, free_busy, open_hours) unless open_hours.empty?
+
+      execute_availability("/calendars/availability",
+                           duration_minutes: duration_minutes,
+                           interval: interval,
+                           start_time: start_time,
+                           end_time: end_time,
+                           emails: emails,
+                           buffer: buffer,
+                           round_robin: round_robin,
+                           free_busy: free_busy,
+                           open_hours: open_hours)
+    end
+
+    def consecutive_availability(duration_minutes:,
+                                 interval:,
+                                 start_time:,
+                                 end_time:,
+                                 emails:,
+                                 buffer: nil,
+                                 free_busy: [],
+                                 open_hours: [])
+      validate_open_hours(emails, free_busy, open_hours) unless open_hours.empty?
+
+      execute_availability("/calendars/availability/consecutive",
+                           duration_minutes: duration_minutes,
+                           interval: interval,
+                           start_time: start_time,
+                           end_time: end_time,
+                           emails: emails,
+                           buffer: buffer,
+                           free_busy: free_busy,
+                           open_hours: open_hours)
+    end
+
+    private
+
+    def execute_availability(path, **payload)
+      api.execute(
+        method: :post,
+        path: path,
+        payload: JSON.dump(payload)
+      )
+    end
+
+    def validate_open_hours(emails, free_busy, open_hours)
+      raise TypeError, "open_hours' must be an array." unless open_hours.is_a?(Array)
+
+      open_hours_emails = map_open_hours_emails(open_hours)
+      free_busy_emails = map_free_busy_emails(free_busy)
+      emails = merge_arrays(emails) if emails[0].is_a?(Array)
+
+      open_hours_emails.each do |email|
+        next if emails.include?(email) || free_busy_emails.include?(email)
+
+        raise ArgumentError, "Open Hours cannot contain an email not present in the main email list or
+the free busy email list."
+      end
+    end
+
+    def map_open_hours_emails(open_hours)
+      open_hours_emails = []
+      open_hours.map do |oh|
+        open_hours_emails += oh.emails
+      end
+      open_hours_emails
+    end
+
+    def map_free_busy_emails(free_busy)
+      free_busy_emails = []
+      free_busy.map do |fb|
+        free_busy_emails.append(fb.email)
+      end
+      free_busy_emails
+    end
+
+    def merge_arrays(array)
+      list = []
+      array.each do |x|
+        list += x
+      end
+      list
+    end
+  end
+end

data/lib/nylas/component.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Structure to represent a the Component Schema.
+  class Component
+    include Model
+    allows_operations(creatable: true, listable: true, filterable: true, showable: true, updatable: true,
+                      destroyable: true)
+
+    attribute :id, :string, read_only: true
+    attribute :account_id, :string
+    attribute :name, :string
+    attribute :type, :string
+    attribute :action, :integer
+    attribute :active, :boolean
+    attribute :settings, :hash
+    attribute :public_account_id, :string
+    attribute :public_token_id, :string
+    attribute :public_application_id, :string, read_only: true
+    attribute :access_token, :string
+    attribute :created_at, :date, read_only: true
+    attribute :updated_at, :date, read_only: true
+
+    has_n_of_attribute :allowed_domains, :string
+
+    def resources_path(*)
+      "/component/#{api.client.app_id}"
+    end
+  end
+end

data/lib/nylas/component_collection.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Additional configuration for the Component CRUD API
+  class ComponentCollection < Collection
+    def resources_path
+      "/component/#{api.client.app_id}"
+    end
+  end
+end

data/lib/nylas/draft.rb

@@ -86,7 +86,7 @@ module Nylas
     def extract_file_ids!
       files = self.files || []
 
-      self.file_ids = files.map(&:id)
+      self.file_ids ||= files.map(&:id)
     end
   end
 end

data/lib/nylas/file.rb

@@ -6,7 +6,7 @@ module Nylas
   class File
     include Model
     self.resources_path = "/files"
-    allows_operations(listable: true, showable: true, filterable: true, creatable: true)
+    allows_operations(listable: true, showable: true, filterable: true, creatable: true, destroyable: true)
 
     attribute :id, :string
     attribute :account_id, :string

data/lib/nylas/open_hours.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Additional times email accounts are available
+  # @see https://developer.nylas.com/docs/api/#post/calendars/availability
+  class OpenHours
+    include Model::Attributable
+
+    attribute :timezone, :string
+    attribute :start, :string
+    attribute :end, :string
+    has_n_of_attribute :emails, :string
+    has_n_of_attribute :days, :integer
+  end
+end

data/lib/nylas/scheduler.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Ruby representation of a the Nylas Scheduler API
+  # @see https://developer.nylas.com/docs/api/scheduler/#overview
+  class Scheduler
+    include Model
+    self.resources_path = "/manage/pages"
+    allows_operations(creatable: true, listable: true, filterable: true, showable: true, updatable: true,
+                      destroyable: true)
+
+    attribute :id, :integer, read_only: true
+    attribute :app_client_id, :string
+    attribute :app_organization_id, :integer
+    attribute :config, :scheduler_config
+    attribute :edit_token, :string
+    attribute :name, :string
+    attribute :slug, :string
+    attribute :created_at, :date
+    attribute :modified_at, :date
+
+    has_n_of_attribute :access_tokens, :string
+
+    def get_available_calendars
+      raise ArgumentError, "Cannot get calendars for a page without an ID." if id.nil?
+
+      api.execute(
+        method: :get,
+        path: "/manage/pages/#{id}/calendars"
+      )
+    end
+
+    def upload_image(content_type:, object_name:)
+      raise ArgumentError, "Cannot upload an image to a page without an ID." if id.nil?
+
+      payload = {
+        contentType: content_type,
+        objectName: object_name
+      }
+      api.execute(
+        method: :put,
+        path: "/manage/pages/#{id}/upload-image",
+        payload: JSON.dump(payload)
+      )
+    end
+  end
+end

data/lib/nylas/scheduler_config.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Configuration settings for a Scheduler page
+  # @see https://developer.nylas.com/docs/api/scheduler
+  class SchedulerConfig
+    include Model::Attributable
+
+    attribute :appearance, :hash
+    attribute :booking, :hash
+    attribute :calendar_ids, :hash
+    attribute :event, :hash
+    attribute :expire_after, :hash
+    attribute :locale, :string
+    attribute :locale_for_guests, :string
+    attribute :timezone, :string
+
+    has_n_of_attribute :reminders, :hash
+  end
+end

data/lib/nylas/version.rb

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

data/lib/nylas.rb

@@ -35,7 +35,6 @@ require_relative "nylas/model"
 # Attribute types supported by the API
 require_relative "nylas/email_address"
 require_relative "nylas/event"
-require_relative "nylas/event_collection"
 require_relative "nylas/file"
 require_relative "nylas/folder"
 require_relative "nylas/im_address"
@@ -53,14 +52,19 @@ require_relative "nylas/nylas_date"
 require_relative "nylas/when"
 require_relative "nylas/free_busy"
 require_relative "nylas/time_slot"
+require_relative "nylas/open_hours"
 require_relative "nylas/event_conferencing"
 require_relative "nylas/event_conferencing_details"
 require_relative "nylas/event_conferencing_autocreate"
+require_relative "nylas/component"
 
 # Custom collection types
+require_relative "nylas/event_collection"
 require_relative "nylas/search_collection"
 require_relative "nylas/deltas_collection"
 require_relative "nylas/free_busy_collection"
+require_relative "nylas/calendar_collection"
+require_relative "nylas/component_collection"
 
 # Models supported by the API
 require_relative "nylas/account"
@@ -77,6 +81,7 @@ require_relative "nylas/new_message"
 require_relative "nylas/raw_message"
 require_relative "nylas/thread"
 require_relative "nylas/webhook"
+require_relative "nylas/scheduler"
 
 # Neural specific types
 require_relative "nylas/neural"
@@ -90,6 +95,7 @@ require_relative "nylas/neural_signature_contact"
 require_relative "nylas/neural_signature_extraction"
 require_relative "nylas/neural_message_options"
 require_relative "nylas/categorize"
+require_relative "nylas/scheduler_config"
 
 require_relative "nylas/native_authentication"
 
@@ -134,4 +140,5 @@ module Nylas
   Types.registry[:neural_signature_contact] = Types::ModelType.new(model: NeuralSignatureContact)
   Types.registry[:neural_contact_link] = Types::ModelType.new(model: NeuralContactLink)
   Types.registry[:neural_contact_name] = Types::ModelType.new(model: NeuralContactName)
+  Types.registry[:scheduler_config] = Types::ModelType.new(model: SchedulerConfig)
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 5.4.1
+  version: 5.5.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-27 00:00:00.000000000 Z
+date: 2021-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -270,8 +270,11 @@ files:
 - lib/nylas/account.rb
 - lib/nylas/api.rb
 - lib/nylas/calendar.rb
+- lib/nylas/calendar_collection.rb
 - lib/nylas/categorize.rb
 - lib/nylas/collection.rb
+- lib/nylas/component.rb
+- lib/nylas/component_collection.rb
 - lib/nylas/constraints.rb
 - lib/nylas/contact.rb
 - lib/nylas/contact_group.rb
@@ -318,6 +321,7 @@ files:
 - lib/nylas/neural_signature_extraction.rb
 - lib/nylas/new_message.rb
 - lib/nylas/nylas_date.rb
+- lib/nylas/open_hours.rb
 - lib/nylas/participant.rb
 - lib/nylas/phone_number.rb
 - lib/nylas/physical_address.rb
@@ -326,6 +330,8 @@ files:
 - lib/nylas/registry.rb
 - lib/nylas/room_resource.rb
 - lib/nylas/rsvp.rb
+- lib/nylas/scheduler.rb
+- lib/nylas/scheduler_config.rb
 - lib/nylas/search_collection.rb
 - lib/nylas/thread.rb
 - lib/nylas/time_slot.rb
@@ -360,7 +366,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.2.17
 signing_key:
 specification_version: 4
 summary: Gem for interacting with the Nylas API