nylas 5.9.0 → 5.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b390b7c22a3dfcc7a4eed1db3966295d71a5f8928efd4b81bedbabd0c7bac0dc
-  data.tar.gz: d27e92177ddf12626917c2b20334bc74bcc703f04d5d68721375429aa4ce06fe
+  metadata.gz: 8dfc25b74725b0ba024320c432c69a1318f4b5524f550323d493b59aeb70e181
+  data.tar.gz: 0a50c968682d1b718aecdf7aaacfd32ea324e8d89c8db2c1f9369142189cf350
 SHA512:
-  metadata.gz: c0d5c385aa98002eceed26178f6d63e60950344fd48cd229c2c32fd4b3998c837db894ca2fd883da8886f4dd91ee8fef01b07885f7e3941ef5b17d8bb4c2afe6
-  data.tar.gz: 86d6663b12da809962c28d6284ee5a22c90951ac9055bbadce90a347a55061ac1c67ff1feeb7e22b711d2311f24df2d0928e858be3ca03074e9e109022199b62
+  metadata.gz: 439de1cc121378d1438047d4e2399faa5cd3ec3efcf5647a1dbefa4b858191c83bc0d4bcfb58d3795be30cf9627feaa17828b33ed916bb2a310778cbd64c6e91
+  data.tar.gz: 0a5a619c18eadad1a5a81fa85e528303e172bef906746cbde9bd2baba5647213e2ff0e7f5cab634bdfc9adf9dc8489b18e159618348973df452d2a50aa6295f2

data/lib/nylas/account.rb

@@ -9,6 +9,7 @@ module Nylas
     self.showable = true
     self.updatable = true
     self.destroyable = true
+    self.filterable = true
     self.auth_method = HttpClient::AuthMethod::BASIC
 
     attribute :id, :string, read_only: true

data/lib/nylas/calendar_collection.rb

@@ -4,6 +4,19 @@ module Nylas
   # Additional methods for some of Calendar's other functionality
   # @see https://developer.nylas.com/docs/connectivity/calendar
   class CalendarCollection < Collection
+    # Check multiple calendars to find available time slots for a single meeting
+    # @param duration_minutes [Integer] The total number of minutes the event should last
+    # @param interval_minutes [Integer] How many minutes it should check for availability
+    # @param start_time [Integer] The timestamp for the beginning of the event
+    # @param end_time [Integer] The timestamp for the end of the event
+    # @param emails [Array<String>] Emails on the same domain to check
+    # @param buffer [Integer] The amount of buffer time in minutes that you want around existing meetings
+    # @param round_robin [String] Finds available meeting times in a round-robin style
+    # @param event_collection_id [String] Unique identifier for a collection of events that are created
+    # @param free_busy [Array<Nylas::FreeBusy>] A list of free-busy data for users not in your organization
+    # @param open_hours [Array<Nylas::OpenHours>] Additional times email accounts are available
+    # @param calendars [Array] Check account and calendar IDs for free/busy status
+    # @return [Hash] The availability information; a list of time slots where all participants are available
     def availability(duration_minutes:,
                      interval_minutes:,
                      start_time:,
@@ -11,6 +24,7 @@ module Nylas
                      emails: [],
                      buffer: nil,
                      round_robin: nil,
+                     event_collection_id: nil,
                      free_busy: [],
                      open_hours: [],
                      calendars: [])
@@ -25,11 +39,23 @@ module Nylas
                            emails: emails,
                            buffer: buffer,
                            round_robin: round_robin,
-                           free_busy: free_busy,
-                           open_hours: open_hours,
+                           event_collection_id: event_collection_id,
+                           free_busy: free_busy.map(&:to_h),
+                           open_hours: open_hours.map(&:to_h),
                            calendars: calendars)
     end
 
+    # Check multiple calendars to find availability for multiple meetings with several participants
+    # @param duration_minutes [Integer] The total number of minutes the event should last
+    # @param interval_minutes [Integer] How many minutes it should check for availability
+    # @param start_time [Integer] The timestamp for the beginning of the event
+    # @param end_time [Integer] The timestamp for the end of the event
+    # @param emails [Array<Array<String>>] Emails on the same domain to check
+    # @param buffer [Integer] The amount of buffer time in minutes that you want around existing meetings
+    # @param free_busy [Array<Nylas::FreeBusy>] A list of free-busy data for users not in your organization
+    # @param open_hours [Array<Nylas::OpenHours>] Additional times email accounts are available
+    # @param calendars [Array] Check account and calendar IDs for free/busy status
+    # @return [Hash] The availability information; a list of all possible groupings that share time slots
     def consecutive_availability(duration_minutes:,
                                  interval_minutes:,
                                  start_time:,
@@ -49,8 +75,8 @@ module Nylas
                            end_time: end_time,
                            emails: emails,
                            buffer: buffer,
-                           free_busy: free_busy,
-                           open_hours: open_hours,
+                           free_busy: free_busy.map(&:to_h),
+                           open_hours: open_hours.map(&:to_h),
                            calendars: calendars)
     end
 

data/lib/nylas/event.rb

@@ -16,7 +16,9 @@ module Nylas
     attribute :master_event_id, :string
     attribute :message_id, :string
     attribute :ical_uid, :string
+    attribute :event_collection_id, :string
 
+    attribute :capacity, :integer
     attribute :busy, :boolean
     attribute :description, :string
     attribute :location, :string
@@ -30,6 +32,7 @@ module Nylas
     attribute :metadata, :hash
     attribute :conferencing, :event_conferencing
     has_n_of_attribute :notifications, :event_notification
+    has_n_of_attribute :round_robin_order, :string
     attribute :original_start_time, :unix_timestamp
     attribute :job_status_id, :string, read_only: true
 
@@ -44,12 +47,7 @@ module Nylas
     end
 
     def save
-      if conferencing
-        body = to_h
-        if body.dig(:conferencing, :details) && body.dig(:conferencing, :autocreate)
-          raise ArgumentError, "Cannot set both 'details' and 'autocreate' in conferencing object."
-        end
-      end
+      validate
 
       super
     end
@@ -81,6 +79,18 @@ module Nylas
 
     private
 
+    def validate
+      if conferencing
+        body = to_h
+        if body.dig(:conferencing, :details) && body.dig(:conferencing, :autocreate)
+          raise ArgumentError, "Cannot set both 'details' and 'autocreate' in conferencing object."
+        end
+      end
+      return unless capacity && capacity != -1 && participants && participants.length > capacity
+
+      raise ArgumentError, "The number of participants in the event exceeds the set capacity."
+    end
+
     def build_ics_event_payload(ical_uid, method, prodid)
       payload = {}
       if id

data/lib/nylas/new_message.rb

@@ -26,8 +26,14 @@ module Nylas
 
     attribute :tracking, :message_tracking
 
+    # Sends the new message
+    # @return [Message] The sent message
+    # @raise [RuntimeError] if the API response data was not a hash
     def send!
-      Message.new(**api.execute(method: :post, path: "/send", payload: to_json).merge(api: api))
+      message_data = api.execute(method: :post, path: "/send", payload: to_json)
+      raise "Unexpected response from the server, data received not a Message" unless message_data.is_a?(Hash)
+
+      Message.from_hash(message_data, api: api)
     end
   end
 end

data/lib/nylas/participant.rb

@@ -6,6 +6,7 @@ module Nylas
     include Model::Attributable
     attribute :name, :string
     attribute :email, :string
+    attribute :phone_number, :string
     attribute :comment, :string
     attribute :status, :string, read_only: true
   end

data/lib/nylas/time_slot.rb

@@ -10,5 +10,7 @@ module Nylas
     attribute :status, :string
     attribute :start_time, :unix_timestamp
     attribute :end_time, :unix_timestamp
+    attribute :capacity, :time_slot_capacity
+    has_n_of_attribute :emails, :string
   end
 end

data/lib/nylas/time_slot_capacity.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Nylas
+  # Capacity values for a timeslot
+  # @see https://docs.nylas.com/reference#calendars-free-busy
+  class TimeSlotCapacity
+    include Model::Attributable
+
+    attribute :event_id, :string
+    attribute :current_capacity, :integer
+    attribute :max_capacity, :integer
+  end
+end

data/lib/nylas/version.rb

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

data/lib/nylas.rb

@@ -54,6 +54,7 @@ require_relative "nylas/nylas_date"
 require_relative "nylas/when"
 require_relative "nylas/free_busy"
 require_relative "nylas/time_slot"
+require_relative "nylas/time_slot_capacity"
 require_relative "nylas/open_hours"
 require_relative "nylas/event_conferencing"
 require_relative "nylas/event_conferencing_details"
@@ -144,6 +145,7 @@ module Nylas
   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)
+  Types.registry[:time_slot_capacity] = Types::ModelType.new(model: TimeSlotCapacity)
   Types.registry[:event_conferencing] = Types::ModelType.new(model: EventConferencing)
   Types.registry[:event_conferencing_details] = Types::ModelType.new(model: EventConferencingDetails)
   Types.registry[:event_conferencing_autocreate] = Types::ModelType.new(model: EventConferencingAutocreate)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 5.9.0
+  version: 5.10.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-07 00:00:00.000000000 Z
+date: 2022-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -347,6 +347,7 @@ files:
 - lib/nylas/send_grid_verified_status.rb
 - lib/nylas/thread.rb
 - lib/nylas/time_slot.rb
+- lib/nylas/time_slot_capacity.rb
 - lib/nylas/timespan.rb
 - lib/nylas/token_info.rb
 - lib/nylas/types.rb