nylas 6.2.0 → 6.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66046a0bdf3cda4d6c782bba25fba8459223c97930d3bf0d15f46e000f04546a
-  data.tar.gz: cf1e2a07df881e98a6087255c654078ceefcc2dca4b47a0cc79506edbbca63c1
+  metadata.gz: 51dfbc5793db11f12c6f01c13040346b5ec3cb272e30e3464363240e3e8ebf00
+  data.tar.gz: 3f76c739a761dfc92c8dfa12f71e0555e8d56399c61a297a7daeadfc861d019e
 SHA512:
-  metadata.gz: fd94c45db1d031e7e431f7c6f09f2b6f0f8263787fd4a94c1c5978b14a8e57032febfdc5476705eb55f26c33ef3781554dcf3df9c2e4ea21b57764447cc4d7ed
-  data.tar.gz: a2aa5c353495efbdf033131569c12f5166297c760ee10ef50911bb55a4aec98f4823c5779660ba57904eb65b06751021d51a579046938e2a445b382cfa188a19
+  metadata.gz: 77d860d38046bb599e43e7cc7b3460a20b512005d4fc4bb21704d7d1adbe5e5c81b5a01761f6050121b18bb68451d8e51f9f6e2b30c835ec6abc8d71f6cdb615
+  data.tar.gz: 58fb6f352d89b3b24328da83d07f6f823e4eb77e5b1bd078069294600ec5cea538e095aa437aa18ae69893045e6510ff66e2f3719e59adae70bacf6246a73e54

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/errors.rb

@@ -21,7 +21,7 @@ module Nylas
     # @param type [Hash] Error type.
     # @param message [String] Error message.
     # @param status_code [Integer] Error status code.
-    # @param provider_error [String, nil] Provider error.
+    # @param provider_error [Hash, nil] The error from the provider.
     # @param request_id [Hash, nil] The ID of the request.
     def initialize(type, message, status_code, provider_error = nil, request_id = nil)
       super(message)

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: nil)
+      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: nil)
+      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: nil)
+      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_id:, request_body:, query_params: nil)
+      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: nil)
+      _, 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

@@ -27,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

@@ -36,7 +36,16 @@ module Nylas
           file = File.open(attachment[:file_path], "rb")
         end
 
-        form_data.merge!({ "file#{index}" => file })
+        # Setting original filename and content type if available. See rest-client#lib/restclient/payload.rb
+        filename = attachment[:filename] || attachment["filename"]
+        file.define_singleton_method(:original_filename) { filename } if filename
+
+        content_type = attachment[:content_type] || attachment["content_type"]
+        file.define_singleton_method(:content_type) { content_type } if content_type
+
+        content_id = attachment[:content_id] || attachment["content_id"] || "file#{index}"
+
+        form_data.merge!({ content_id => file })
         opened_files << file
       end
 
@@ -91,9 +100,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, content_id = 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
@@ -102,12 +112,12 @@ module Nylas
                      end
       size = File.size(file_path)
       content = File.new(file_path, "rb")
-
       {
         filename: filename,
         content_type: content_type,
         size: size,
         content: content,
+        content_id: content_id,
         file_path: file_path
       }
     end

data/lib/nylas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nylas
-  VERSION = "6.2.0"
+  VERSION = "6.2.2"
 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.2.0
+  version: 6.2.2
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-24 00:00:00.000000000 Z
+date: 2024-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -251,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
@@ -262,10 +265,11 @@ 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
-- lib/nylas/test.rb
 - lib/nylas/utils/file_utils.rb
 - lib/nylas/version.rb
 homepage:
@@ -293,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

data/lib/nylas/test.rb

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-require 'nylas'
-
-nylas = Nylas::Client.new(
-  api_key: "nyk_v0_tRgvnXpqESPGVaaf5QTDzoSYet94natpftScKTT8auH6Www49RJUQ1WJ5VAWplqu"
-)
-
-# file = Nylas::FileUtils.attach_file_request_builder("/Users/mostafa.r@nylas.com/Downloads/05i7gc9wvgv51.jpg")
-file = Nylas::FileUtils.attach_file_request_builder("/Users/mostafa.r@nylas.com/Downloads/zara_reciept.pdf")
-
-request_body = {
-  subject: "Ruby SDK attachment test - 8.30.24 x1",
-  to: [{email: "mostafa.r@nylas.com"}],
-  attachments: [file],
-}
-
-puts "Before request"
-puts request_body
-
-begin
-  email, _ = nylas.messages.send(identifier: "mostafa.r@nylas.com", request_body: request_body)
-  puts "Email sent successfully: #{email}"
-rescue StandardError => e
-  puts "An error occurred: #{e.message}"
-end
-
-puts "After request"
-puts request_body
-
-# begin
-#   email, _ = nylas.messages.send(identifier: "mostafa.r@nylas.com", request_body: request_body)
-#   puts "Email sent successfully: #{email}"
-# rescue StandardError => e1
-#   puts "An error occurred: #{e1.message}"
-# end