nylas 5.9.1 → 5.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c62ff2cfcd6e73840a14c281b0d46da494dcea2d49f42da51eb94a30080307e8
-  data.tar.gz: 957a04e0146a2cea58a2fe064d11814462a7aae36c88fee38d2c4b71ad5c3d97
+  metadata.gz: 5f59eea98b61cf99f73b87277cf360310f9fa8584a4164297d58faa2ef2575cd
+  data.tar.gz: 1afd54d9481f76af4330d8e12a2f90b8fe667628247e455453211425b198f470
 SHA512:
-  metadata.gz: 8316f1b5ebb2470a0154c1a8c33bfcd23ede0318555546e8fcf3f23b19fb5a84f052621d1150b38d10893db07c98c71a6ba997487b8bae9a1562d58dd95f1f25
-  data.tar.gz: da299c0110d2755b5514dc6e604b6ad3ecf3fecffca0998fc61ab417ffb096f52c775a360728724487688cada34c3bef4f7285cc1d9e09633b278a2dc91ab4dc
+  metadata.gz: ebf09713be0037d694e9d43c3aa5b3c3c4a5557296593773bbd792f21f281662ef96fb2079ca34d1325a0c43b4810f0805a80e963de29eef0b0762b805a74581
+  data.tar.gz: cb2c8c558dd67b36aa446d7b92a91902978b0e41af1f1a24e3629c833817ad3038fa71f2c1c42f0e79f3ab32c8bb02f836fc10f1481eaf0fb9f78ed021fbb44e

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,7 +32,10 @@ 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 :reminder_minutes, :string
+    attribute :reminder_method, :string
     attribute :job_status_id, :string, read_only: true
 
     attr_accessor :notify_participants
@@ -44,12 +49,8 @@ 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
+      format_reminder_minutes
 
       super
     end
@@ -81,6 +82,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
@@ -101,6 +114,13 @@ module Nylas
       payload
     end
 
+    # Formats the reminder minute field to match the API format: "[%d]"
+    def format_reminder_minutes
+      return if reminder_minutes.nil? || reminder_minutes.empty? || reminder_minutes.match(/\[\d+\]/)
+
+      self.reminder_minutes = "[#{reminder_minutes}]"
+    end
+
     def query_params
       if notify_participants.nil?
         {}

data/lib/nylas/http_client.rb

@@ -5,7 +5,7 @@ module Nylas
   require "base64"
 
   # Plain HTTP client that can be used to interact with the Nylas API sans any type casting.
-  class HttpClient # rubocop:disable Metrics/ClassLength
+  class HttpClient
     module AuthMethod
       BEARER = 1
       BASIC = 2

data/lib/nylas/job_status.rb

@@ -16,6 +16,7 @@ module Nylas
     attribute :status, :string, read_only: true
     attribute :created_at, :unix_timestamp, read_only: true
     attribute :reason, :string, read_only: true
+    attribute :metadata, :hash, read_only: true
 
     # Returns the status of a job as a boolean
     # @return [Boolean] If the job was successful

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.1"
+  VERSION = "5.11.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.1
+  version: 5.11.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-20 00:00:00.000000000 Z
+date: 2022-07-08 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
@@ -379,7 +380,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.3.11
 signing_key:
 specification_version: 4
 summary: Gem for interacting with the Nylas API