nylas 6.2.3 → 6.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb37db614a1d3567334d0d7217d50e81a94a3d31bc758c916fa752953fc7369e
-  data.tar.gz: 123be60d4794edb9ea702ae62c2768d39fda98afa7b53157d3e7b53def4b3b98
+  metadata.gz: 275a09b48ad361ba1f441efa8b32a026fa547c0296ea3b681da440e6c7652516
+  data.tar.gz: 813293f38fabeb6cbfae1a9974a6e27622c68352442982a49890c176c354a2d5
 SHA512:
-  metadata.gz: 4d26327e107d0a911397a30a8f2f2d2fc7836dcf8d9c4f9448b4ec8ab58aa2cd37595fa7cdcea8c5ade7643d6d9ec8b33451dbf297237501ce0834494946f331
-  data.tar.gz: 9340849392790c37b9c86334a97afe8b5b991c6d681313dee3158f26371953d698114bd38796e02f28c49e6de028594bfee4adae9b9e11d62d7e29cf10ccdb22
+  metadata.gz: 3453ab99f8e2ab3bec6abd2f2cad0c8ea0d43e26a328eb3ff318b2c250f3cc4d699396c7638648118f4b2af47d37aca767f4106ad04dc5a0858b2c99f6814d5e
+  data.tar.gz: 236711014f51f24b29c64fbe578cf0eea851cb44bb486dec3ec39c73a9311cb84a42d1f78d5c29e5eeae8025aef154e9e2ae74789fc50c9b5ebfe39eb9226a93

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/notetakers"
 require_relative "resources/scheduler"
 
 module Nylas
@@ -124,5 +125,11 @@ module Nylas
     def scheduler
       Scheduler.new(self)
     end
+
+    # The Notetaker resources for your Nylas application.
+    # @return [Nylas::Notetakers] Notetaker resources for your Nylas application.
+    def notetakers
+      Notetakers.new(self)
+    end
   end
 end

data/lib/nylas/errors.rb

@@ -14,7 +14,7 @@ module Nylas
 
   # Error class representing a failed response from the Nylas API.
   class NylasApiError < AbstractNylasApiError
-    attr_accessor :type, :request_id, :provider_error, :status_code
+    attr_accessor :type, :request_id, :provider_error, :status_code, :headers
 
     # Initializes an error and assigns the given attributes to it.
     #
@@ -23,24 +23,26 @@ module Nylas
     # @param status_code [Integer] Error status code.
     # @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)
+    def initialize(type, message, status_code, provider_error = nil, request_id = nil, headers = nil)
       super(message)
       self.type = type
       self.status_code = status_code
       self.provider_error = provider_error
       self.request_id = request_id
+      self.headers = headers
     end
 
     # Parses the error response.
     #
     # @param response [Hash] Response from the Nylas API.
     # @param status_code [Integer] Error status code.
-    def self.parse_error_response(response, status_code)
+    def self.parse_error_response(response, status_code, headers = nil)
       new(
         response["type"],
         response["message"],
         status_code,
-        response["provider_error"]
+        response["provider_error"],
+        headers
       )
     end
   end

data/lib/nylas/handler/api_operations.rb

@@ -15,22 +15,23 @@ module Nylas
       #
       # @param path [String] Destination path for the call.
       # @param query_params [Hash, {}] Query params to pass to the call.
-      # @return [Array([Hash, Array], String)] Nylas data object and API Request ID.
+      # @return [Array([Hash, Array], String, Hash)] Nylas data object, API Request ID, and response headers.
       def get(path:, query_params: {})
         response = get_raw(path: path, query_params: query_params)
 
-        [response[:data], response[:request_id]]
+        [response[:data], response[:request_id], response[:headers]]
       end
 
       # Performs a GET call to the Nylas API for a list response.
       #
       # @param path [String] Destination path for the call.
       # @param query_params [Hash, {}] Query params to pass to the call.
-      # @return [Array(Array(Hash), String, String)] Nylas data array, API Request ID, and next cursor.
+      # @return [Array<Array<Hash>, String, String, Hash>]
+      #   Nylas data array, API Request ID, next cursor, and response headers.response headers.
       def get_list(path:, query_params: {})
         response = get_raw(path: path, query_params: query_params)
 
-        [response[:data], response[:request_id], response[:next_cursor]]
+        [response[:data], response[:request_id], response[:next_cursor], response[:headers]]
       end
 
       private
@@ -63,7 +64,7 @@ module Nylas
       # @param query_params [Hash, {}] Query params to pass to the call.
       # @param request_body [Hash, nil] Request body to pass to the call.
       # @param headers [Hash, {}] Additional HTTP headers to include in the payload.
-      # @return Nylas data object and API Request ID.
+      # @return [Array(Hash, String, Hash)] Nylas data object, API Request ID, and response headers.
       def post(path:, query_params: {}, request_body: nil, headers: {})
         response = execute(
           method: :post,
@@ -75,7 +76,7 @@ module Nylas
           timeout: timeout
         )
 
-        [response[:data], response[:request_id]]
+        [response[:data], response[:request_id], response[:headers]]
       end
     end
 

data/lib/nylas/handler/http_client.rb

@@ -40,7 +40,10 @@ module Nylas
             content_type = response.headers[:content_type].downcase
           end
 
-          parse_json_evaluate_error(result.code.to_i, response, path, content_type)
+          parsed_response = parse_json_evaluate_error(result.code.to_i, response, path, content_type)
+          # Include headers in the response
+          parsed_response[:headers] = response.headers unless parsed_response.nil?
+          parsed_response
         end
       rescue RestClient::Exceptions::OpenTimeout, RestClient::Exceptions::ReadTimeout
         raise Nylas::NylasSdkTimeoutError.new(request[:path], timeout)
@@ -116,7 +119,7 @@ module Nylas
     def parse_response(response)
       return response if response.is_a?(Enumerable)
 
-      Yajl::Parser.new(symbolize_names: true).parse(response)
+      Yajl::Parser.new(symbolize_names: true).parse(response) || raise(Nylas::JsonParseError)
     rescue Yajl::ParseError
       raise Nylas::JsonParseError
     end
@@ -188,22 +191,26 @@ module Nylas
     def error_hash_to_exception(response, status_code, path)
       return if !response || !response.key?(:error)
 
+      # Safely get headers without risking KeyError
+      headers = response.key?(:headers) ? response[:headers] : nil
+
       if %W[#{api_uri}/v3/connect/token #{api_uri}/v3/connect/revoke].include?(path)
         NylasOAuthError.new(response[:error], response[:error_description], response[:error_uri],
                             response[:error_code], status_code)
       else
-        throw_error(response, status_code)
+        throw_error(response, status_code, headers)
       end
     end
 
-    def throw_error(response, status_code)
+    def throw_error(response, status_code, headers = nil)
       error_obj = response[:error]
 
       # If `error_obj` is just a string, turn it into a hash with default keys.
       if error_obj.is_a?(String)
         error_obj = {
           type: "NylasApiError",
-          message: error_obj
+          message: error_obj,
+          headers: headers
         }
       end
 
@@ -214,7 +221,8 @@ module Nylas
         error_obj[:message],
         status_code,
         provider_error,
-        response[:request_id]
+        response[:request_id],
+        headers
       )
     end
 

data/lib/nylas/resources/calendars.rb

@@ -39,6 +39,7 @@ module Nylas
     #
     # @param identifier [String] Grant ID or email account in which to create the object.
     # @param request_body [Hash] The values to create the calendar with.
+    #   This can include a `notetaker` object with settings and calendar sync rules for the Notetaker bot.
     # @return [Array(Hash, String)] The created calendar and API Request ID.
     def create(identifier:, request_body:)
       post(
@@ -52,7 +53,8 @@ module Nylas
     # @param identifier [String] Grant ID or email account in which to update an object.
     # @param calendar_id [String] The id of the calendar to update.
     #   Use "primary" to refer to the primary calendar associated with grant.
-    # @param request_body [Hash] The values to update the calendar with
+    # @param request_body [Hash] The values to update the calendar with.
+    #   This can include a `notetaker` object with settings and calendar sync rules for the Notetaker bot.
     # @return [Array(Hash, String)] The updated calendar and API Request ID.
     def update(identifier:, calendar_id:, request_body:)
       put(

data/lib/nylas/resources/events.rb

@@ -40,6 +40,7 @@ module Nylas
     #
     # @param identifier [String] Grant ID or email account in which to create the object.
     # @param request_body [Hash] The values to create the event with.
+    #   This can include a `notetaker` object with settings for the Notetaker bot.
     # @param query_params [Hash] The query parameters to include in the request.
     # @return [Array(Hash, String)] The created event and API Request ID.
     def create(identifier:, request_body:, query_params:)
@@ -54,7 +55,8 @@ module Nylas
     #
     # @param identifier [String] Grant ID or email account in which to update an object.
     # @param event_id [String] The id of the event to update.
-    # @param request_body [Hash] The values to update the event with
+    # @param request_body [Hash] The values to update the event with.
+    #   This can include a `notetaker` object with settings for the Notetaker bot.
     # @param query_params [Hash] The query parameters to include in the request
     # @return [Array(Hash, String)] The updated event and API Request ID.
     def update(identifier:, event_id:, request_body:, query_params:)
@@ -94,5 +96,19 @@ module Nylas
         request_body: request_body
       )
     end
+
+    # Returns a list of recurring events, recurring event exceptions, and single events
+    # from the specified calendar within a given time frame. This is useful when you
+    # want to import, store, and synchronize events from the time frame to your application
+    #
+    # @param identifier [String] Grant ID or email account to import events from.
+    # @param query_params [Hash] The query parameters to include in the request
+    # @return [(Array(Hash), String, String)] The list of events, API Request ID, and next cursor.
+    def list_import_events(identifier:, query_params:)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/events/import",
+        query_params: query_params
+      )
+    end
   end
 end

data/lib/nylas/resources/notetakers.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Notetaker API
+  class Notetakers < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+    include ApiOperations::Patch
+
+    # Return all notetakers.
+    #
+    # @param identifier [String, nil] 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 notetakers, API Request ID, and next cursor.
+    def list(identifier: nil, query_params: nil)
+      path = identifier ? "#{api_uri}/v3/grants/#{identifier}/notetakers" : "#{api_uri}/v3/notetakers"
+
+      get_list(
+        path: path,
+        query_params: query_params
+      )
+    end
+
+    # Return a notetaker.
+    #
+    # @param notetaker_id [String] The id of the notetaker to return.
+    # @param identifier [String, nil] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The notetaker and API request ID.
+    def find(notetaker_id:, identifier: nil, query_params: nil)
+      base_path = "#{api_uri}/v3"
+      path = if identifier
+               "#{base_path}/grants/#{identifier}/notetakers/#{notetaker_id}"
+             else
+               "#{base_path}/notetakers/#{notetaker_id}"
+             end
+
+      get(
+        path: path,
+        query_params: query_params
+      )
+    end
+
+    # Invite a notetaker to a meeting.
+    #
+    # @param request_body [Hash] The values to create the notetaker with.
+    # @param identifier [String, nil] Grant ID or email account in which to create the object.
+    # @return [Array(Hash, String)] The created notetaker and API Request ID.
+    def create(request_body:, identifier: nil)
+      path = identifier ? "#{api_uri}/v3/grants/#{identifier}/notetakers" : "#{api_uri}/v3/notetakers"
+
+      post(
+        path: path,
+        request_body: request_body
+      )
+    end
+
+    # Update a scheduled notetaker.
+    #
+    # @param notetaker_id [String] The id of the notetaker to update.
+    # @param request_body [Hash] The values to update the notetaker with
+    # @param identifier [String, nil] Grant ID or email account in which to update an object.
+    # @return [Array(Hash, String)] The updated notetaker and API Request ID.
+    def update(notetaker_id:, request_body:, identifier: nil)
+      base_path = "#{api_uri}/v3"
+      path = if identifier
+               "#{base_path}/grants/#{identifier}/notetakers/#{notetaker_id}"
+             else
+               "#{base_path}/notetakers/#{notetaker_id}"
+             end
+
+      patch(
+        path: path,
+        request_body: request_body
+      )
+    end
+
+    # Download notetaker media.
+    #
+    # @param notetaker_id [String] The id of the notetaker to download media from.
+    # @param identifier [String, nil] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The media data and API request ID.
+    def download_media(notetaker_id:, identifier: nil, query_params: nil)
+      base_path = "#{api_uri}/v3"
+      path = if identifier
+               "#{base_path}/grants/#{identifier}/notetakers/#{notetaker_id}/media"
+             else
+               "#{base_path}/notetakers/#{notetaker_id}/media"
+             end
+
+      get(
+        path: path,
+        query_params: query_params
+      )
+    end
+
+    # Remove a notetaker from a meeting.
+    #
+    # @param notetaker_id [String] The id of the notetaker to remove.
+    # @param identifier [String, nil] Grant ID or email account to query.
+    # @return [Array(Hash, String)] The response data and API request ID.
+    def leave(notetaker_id:, identifier: nil)
+      base_path = "#{api_uri}/v3"
+      path = if identifier
+               "#{base_path}/grants/#{identifier}/notetakers/#{notetaker_id}/leave"
+             else
+               "#{base_path}/notetakers/#{notetaker_id}/leave"
+             end
+
+      post(
+        path: path,
+        request_body: {}
+      )
+    end
+
+    # Cancel a scheduled notetaker.
+    #
+    # @param notetaker_id [String] The id of the notetaker to cancel.
+    # @param identifier [String, nil] Grant ID or email account from which to delete an object.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the cancel operation.
+    def cancel(notetaker_id:, identifier: nil)
+      base_path = "#{api_uri}/v3"
+      path = if identifier
+               "#{base_path}/grants/#{identifier}/notetakers/#{notetaker_id}/cancel"
+             else
+               "#{base_path}/notetakers/#{notetaker_id}/cancel"
+             end
+
+      _, request_id = delete(
+        path: path
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/webhooks.rb

@@ -22,6 +22,7 @@ module Nylas
     MESSAGE_CREATED = "message.created"
     MESSAGE_UPDATED = "message.updated"
     MESSAGE_OPENED = "message.opened"
+    MESSAGE_BOUNCE_DETECTED = "message.bounce_detected"
     MESSAGE_LINK_CLICKED = "message.link_clicked"
     THREAD_REPLIED = "thread.replied"
     FOLDER_CREATED = "folder.created"

data/lib/nylas/utils/file_utils.rb

@@ -62,6 +62,7 @@ module Nylas
       opened_files = []
 
       attachments.each_with_index do |attachment, _index|
+        attachment.delete(:file_path)
         current_attachment = attachment[:content]
         next unless current_attachment
 

data/lib/nylas/version.rb

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

data/lib/nylas.rb

@@ -39,6 +39,7 @@ require_relative "nylas/resources/events"
 require_relative "nylas/resources/folders"
 require_relative "nylas/resources/grants"
 require_relative "nylas/resources/messages"
+require_relative "nylas/resources/notetakers"
 require_relative "nylas/resources/smart_compose"
 require_relative "nylas/resources/threads"
 require_relative "nylas/resources/redirect_uris"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 6.2.3
+  version: 6.4.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-23 00:00:00.000000000 Z
+date: 2025-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -154,6 +154,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.22'
+- !ruby/object:Gem::Dependency
+  name: rubocop-capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -277,6 +291,7 @@ files:
 - lib/nylas/resources/folders.rb
 - lib/nylas/resources/grants.rb
 - lib/nylas/resources/messages.rb
+- lib/nylas/resources/notetakers.rb
 - lib/nylas/resources/redirect_uris.rb
 - lib/nylas/resources/resource.rb
 - lib/nylas/resources/scheduler.rb