nylas 6.1.1 → 6.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2876cab1f609fb357369d692fa8ed5b0fa04754d8b95b30b9d483856bbcff2e
-  data.tar.gz: 94db4b8a8c253c4737348dcdb2fbdddf0fbdf021ac626ef0318ade71da4bf247
+  metadata.gz: d91ae3ccc20cfd009bfd1d7faf5e2d67488b1eee292823b0e0ec35cf56f56b58
+  data.tar.gz: 22f379f3e2d40936efbab14391e21ec92a26551917286e6451ed99047e258bb7
 SHA512:
-  metadata.gz: bade836048e4f19c3a1aebcf03a792bb73d38d850473fe9e60ff116fe6e7ca613f5e48c7f4d4f959f36cf0b361f3b2e7414cc96d5347c60bd7d306961da13e55
-  data.tar.gz: 76d8048ed9eb92a1a660e3edc4d04cda08d7a676898c40092739f60c87250b99afefb19cf04ceef79b08a8cc7bf5425b87178d02e019f74c9937694a86d953e7
+  metadata.gz: aa88cd03b9163346a7b944203ab6882c337d74a7c034987f378eedd80d2b97d3b22c066d651ec6ffa220895d999df6b343c66e30a6914a10fe47ddd46d8584c0
+  data.tar.gz: 6dc249dbc302dcbe07f93fa582c16fd93d4f3c0e33dc2bdf40dfcbcf5c29aca4b1e254f254b58658dd13cada5b5dcaf2ed5ced0a24b2a9b4e9983707da582463

data/lib/nylas/client.rb

@@ -8,6 +8,7 @@ require_relative "resources/auth"
 require_relative "resources/webhooks"
 require_relative "resources/applications"
 require_relative "resources/folders"
+require_relative "resources/scheduler"
 
 module Nylas
   # Methods to retrieve data from the Nylas API as Ruby objects.
@@ -117,5 +118,11 @@ module Nylas
     def webhooks
       Webhooks.new(self)
     end
+
+    # The Scheduler resources for your Nylas application.
+    # @return [Nylas::Scheduler] Scheduler resources for your Nylas application.
+    def scheduler
+      Scheduler.new(self)
+    end
   end
 end

data/lib/nylas/resources/availability.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Messages API
+  class Availability < Resource
+    include ApiOperations::Get
+
+    # Return availabilities for a configuration.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String, String)] The list of configurations, API Request ID,
+    # and next cursor.
+    def list(query_params: nil)
+      get_list(
+        path: "#{api_uri}/v3/scheduling/availability",
+        query_params: query_params
+      )
+    end
+  end
+end

data/lib/nylas/resources/bookings.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Messages API
+  class Bookings < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+    include ApiOperations::Patch
+
+    # Return a booking.
+    # @param booking_id [String] The id of the booking to return.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The booking and API request ID.
+    def find(booking_id:, query_params:)
+      get(
+        path: "#{api_uri}/v3/scheduling/bookings/#{booking_id}",
+        query_params: query_params
+      )
+    end
+
+    # Create a booking.
+    # @param request_body [Hash] The values to create the booking with.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The created booking and API Request ID.
+    def create(request_body:, query_params:)
+      post(
+        path: "#{api_uri}/v3/scheduling/bookings",
+        request_body: request_body,
+        query_params: query_params
+      )
+    end
+
+    # Create a booking.
+    # @param request_body [Hash] The values to update the booking with.
+    # @param booking_id [String] The id of the booking to update.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The created booking and API Request ID.
+    def update(request_body:, booking_id:, query_params:)
+      patch(
+        path: "#{api_uri}/v3/scheduling/bookings/#{booking_id}",
+        request_body: request_body,
+        query_params: query_params
+      )
+    end
+
+    # Confirm a booking.
+    # @param booking_id [String] The id of the booking to confirm.
+    # @param request_body [Hash] The values to update the booking with
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The updated booking and API Request ID.
+    def confirm_booking(booking_id:, request_body:, query_params:)
+      put(
+        path: "#{api_uri}/v3/scheduling/bookings/#{booking_id}",
+        request_body: request_body,
+        query_params: query_params
+      )
+    end
+
+    # Delete a booking.
+    # @param booking_id [String] The id of the booking to delete.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(booking_id:, query_params:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/scheduling/bookings/#{booking_id}",
+        query_params: query_params
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/configurations.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Scheduler Configurations API
+  class Configurations < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all Scheduler Configurations.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String, String)] The list of configurations, API Request ID,
+    # and next cursor.
+    def list(identifier:, query_params: nil)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/scheduling/configurations",
+        query_params: query_params
+      )
+    end
+
+    # Return a Configuration.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param configuration_id [String] The id of the configuration to return.
+    # @return [Array(Hash, String)] The configuration and API request ID.
+    def find(identifier:, configuration_id:)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/scheduling/configurations/#{configuration_id}"
+      )
+    end
+
+    # Create a configuration.
+    #
+    # @param identifier [String] Grant ID or email account in which to create the object.
+    # @param request_body [Hash] The values to create the configuration with.
+    # @return [Array(Hash, String)] The created configuration and API Request ID.
+    def create(identifier:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/scheduling/configurations",
+        request_body: request_body
+      )
+    end
+
+    # Update a configuration.
+    #
+    # @param identifier [String] Grant ID or email account in which to update an object.
+    # @param configuration_id [String] The id of the configuration to update.
+    # @param request_body [Hash] The values to update the configuration with
+    # @return [Array(Hash, String)] The updated configuration and API Request ID.
+    def update(identifier:, configuration_id:, request_body:)
+      put(
+        path: "#{api_uri}/v3/grants/#{identifier}/scheduling/configurations/#{configuration_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a configuration.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete an object.
+    # @param configuration_id [String] The id of the configuration to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, configuration_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/scheduling/configurations/#{configuration_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/folders.rb

@@ -14,10 +14,12 @@ module Nylas
     # Return all folders.
     #
     # @param identifier [String] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
     # @return [Array(Array(Hash), String, String)] The list of folders, API Request ID, and next cursor.
-    def list(identifier:)
+    def list(identifier:, query_params: nil)
       get_list(
-        path: "#{api_uri}/v3/grants/#{identifier}/folders"
+        path: "#{api_uri}/v3/grants/#{identifier}/folders",
+        query_params: query_params
       )
     end
 
@@ -25,10 +27,12 @@ module Nylas
     #
     # @param identifier [String] Grant ID or email account to query.
     # @param folder_id [String] The id of the folder to return.
+    # @param query_params [Hash, nil] Query params to pass to the request.
     # @return [Array(Hash, String)] The folder and API request ID.
-    def find(identifier:, folder_id:)
+    def find(identifier:, folder_id:, query_params: nil)
       get(
-        path: "#{api_uri}/v3/grants/#{identifier}/folders/#{folder_id}"
+        path: "#{api_uri}/v3/grants/#{identifier}/folders/#{folder_id}",
+        query_params: query_params
       )
     end
 

data/lib/nylas/resources/scheduler.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative "./configurations"
+require_relative "./sessions"
+require_relative "./bookings"
+require_relative "./availability"
+
+module Nylas
+  # Nylas Scheduler API
+  # This class provides access to the Scheduler resources, including
+  # configurations, bookings, sessions, and availability.
+  #
+  # @attr_reader [Nylas::Configurations] configurations The Scheduler configurations resource for your
+  # Nylas application.
+  # @attr_reader [Nylas::Bookings] bookings The Scheduler bookings resource for your
+  # Nylas application.
+  # @attr_reader [Nylas::Sessions] sessions The Scheduler sessions resource for your
+  # Nylas application.
+  # @attr_reader [Nylas::Availability] availability The Scheduler availability resource for your
+  # Nylas application.
+  class Scheduler
+    attr_reader :configurations, :sessions, :bookings, :availability
+
+    # Initializes the Scheduler class.
+    #
+    # @param api_client [APIClient] The Nylas API client instance for making requests.
+    def initialize(api_client)
+      @api_client = api_client
+      @configurations = Configurations.new(@api_client)
+      @bookings = Bookings.new(@api_client)
+      @sessions = Sessions.new(@api_client)
+      @availability = Availability.new(@api_client)
+    end
+  end
+end

data/lib/nylas/resources/sessions.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Messages API
+  class Sessions < Resource
+    include ApiOperations::Post
+    include ApiOperations::Delete
+
+    # Create a session for a configuration.
+    # @param request_body [Hash] The values to create a configuration sessions.
+    # @return [Array(Hash, String)] The created configuration and API Request ID.
+    def create(request_body:)
+      post(
+        path: "#{api_uri}/v3/scheduling/sessions",
+        request_body: request_body
+      )
+    end
+
+    # Delete a session for a configuration.
+    # @param session_id [String] The id of the session to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(session_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/scheduling/sessions/#{session_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/threads.rb

@@ -26,10 +26,12 @@ module Nylas
     #
     # @param identifier [String] Grant ID or email account to query.
     # @param thread_id [String] The id of the thread to return.
+    # @param query_params [Hash, nil] Query params to pass to the request.
     # @return [Array(Hash, String)] The thread and API request ID.
-    def find(identifier:, thread_id:)
+    def find(identifier:, thread_id:, query_params: nil)
       get(
-        path: "#{api_uri}/v3/grants/#{identifier}/threads/#{thread_id}"
+        path: "#{api_uri}/v3/grants/#{identifier}/threads/#{thread_id}",
+        query_params: query_params
       )
     end
 

data/lib/nylas/utils/file_utils.rb

@@ -13,20 +13,29 @@ module Nylas
     # @return The form data to send to the API and the opened files.
     # @!visibility private
     def self.build_form_request(request_body)
-      attachments = request_body.delete(:attachments) || request_body.delete("attachments") || []
+      attachments = request_body[:attachments] || request_body["attachments"] || []
+      serializable_body = request_body.reject { |key, _| [:attachments, "attachments"].include?(key) }
+      request_body_copy = Marshal.load(Marshal.dump(serializable_body))
 
       # RestClient will not send a multipart request if there are no attachments
-      # so we need to return the message payload to be used as a json payload
-      return [request_body, []] if attachments.empty?
+      return [request_body_copy, []] if attachments.empty?
 
       # Prepare the data to return
-      message_payload = request_body.to_json
+      message_payload = request_body_copy.to_json
 
       form_data = {}
       opened_files = []
 
       attachments.each_with_index do |attachment, index|
         file = attachment[:content] || attachment["content"]
+        if file.respond_to?(:closed?) && file.closed?
+          unless attachment[:file_path]
+            raise ArgumentError, "The file at index #{index} is closed and no file_path was provided."
+          end
+
+          file = File.open(attachment[:file_path], "rb")
+        end
+
         form_data.merge!({ "file#{index}" => file })
         opened_files << file
       end
@@ -82,9 +91,10 @@ module Nylas
 
     # Build the request to attach a file to a message/draft object.
     # @param file_path [String] The path to the file to attach.
+    # @param filename [String] The name of the attached file. Optional, derived from file_path by default.
     # @return [Hash] The request that will attach the file to the message/draft
-    def self.attach_file_request_builder(file_path)
-      filename = File.basename(file_path)
+    def self.attach_file_request_builder(file_path, filename = nil)
+      filename ||= File.basename(file_path)
       content_type = MIME::Types.type_for(file_path)
       content_type = if !content_type.nil? && !content_type.empty?
                        content_type.first.to_s
@@ -98,7 +108,8 @@ module Nylas
         filename: filename,
         content_type: content_type,
         size: size,
-        content: content
+        content: content,
+        file_path: file_path
       }
     end
   end

data/lib/nylas/version.rb

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

data/lib/nylas.rb

@@ -43,5 +43,6 @@ require_relative "nylas/resources/smart_compose"
 require_relative "nylas/resources/threads"
 require_relative "nylas/resources/redirect_uris"
 require_relative "nylas/resources/webhooks"
+require_relative "nylas/resources/scheduler"
 
 require_relative "nylas/utils/file_utils"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 6.1.1
+  version: 6.2.1
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-20 00:00:00.000000000 Z
+date: 2024-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -31,12 +31,26 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.5.1
 - !ruby/object:Gem::Dependency
-  name: rest-client
+  name: ostruct
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -44,9 +58,9 @@ dependencies:
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: 2.0.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -237,7 +251,10 @@ files:
 - lib/nylas/resources/applications.rb
 - lib/nylas/resources/attachments.rb
 - lib/nylas/resources/auth.rb
+- lib/nylas/resources/availability.rb
+- lib/nylas/resources/bookings.rb
 - lib/nylas/resources/calendars.rb
+- lib/nylas/resources/configurations.rb
 - lib/nylas/resources/connectors.rb
 - lib/nylas/resources/contacts.rb
 - lib/nylas/resources/credentials.rb
@@ -248,6 +265,8 @@ files:
 - lib/nylas/resources/messages.rb
 - lib/nylas/resources/redirect_uris.rb
 - lib/nylas/resources/resource.rb
+- lib/nylas/resources/scheduler.rb
+- lib/nylas/resources/sessions.rb
 - lib/nylas/resources/smart_compose.rb
 - lib/nylas/resources/threads.rb
 - lib/nylas/resources/webhooks.rb
@@ -278,7 +297,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Gem for interacting with the Nylas API