nylas 6.3.0 → 6.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d6aa010eb2b2938c69724103ee74d3a3898320bf31631e2d8838223ce4779a09
-  data.tar.gz: 0b91f115c36a87cab0ab5110eaffbe4a042168e5f2b152df4be16702a6040be9
+  metadata.gz: f9529fffa30430e822edf113d38aa1a179f0995b29d2bec8c3ac5f9a26d4d8c7
+  data.tar.gz: 8710b98962a46bef277461df24f5e64dedd9bdbe7949838b2b3d8aab38b36f10
 SHA512:
-  metadata.gz: 873debe33d40035191e712eb7239840e4343bc6180e657f25dac7c39b73dec6c597d57ce63e204358f8b266f237a2fa4b7a7f52766a07e6f2ef95f8f0cbeb8ff
-  data.tar.gz: efb90a1bd1930a0536b418c16de61d84bc6925e3f6fb5f9c39cde4dd77bb406dacd6fee2f7799257a3dd430e7ec9da23221ab9222d387bba75be96f806aec3e4
+  metadata.gz: 20e35b192df7f3dfaf0d50065556d3ef0c19e959504dc124ec3bd2a6f657ffebb7a61b4808517494b2d79d4ceccdd8ce88e45d49109c142ad366592481a67b56
+  data.tar.gz: d957251f63c3c8aa8b90adde51ba2ea7fe52be3b08ca8017e1b91a22c4e42c4d428a720c1b3a18191d1861d2bf379ebd93e481b30547ffbe4ce8f99578e85fb1

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

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
-require "rest-client"
+require "httparty"
+require "net/http"
 
 require_relative "../errors"
 require_relative "../version"
@@ -34,18 +35,18 @@ module Nylas
       request = build_request(method: method, path: path, headers: headers,
                               query: query, payload: payload, api_key: api_key, timeout: timeout)
       begin
-        rest_client_execute(**request) do |response, _request, result|
+        httparty_execute(**request) do |response, _request, result|
           content_type = nil
-          if response.headers && response.headers[:content_type]
-            content_type = response.headers[:content_type].downcase
+          if response.headers && response.headers["content-type"]
+            content_type = response.headers["content-type"].downcase
           end
 
-          parsed_response = parse_json_evaluate_error(result.code.to_i, response, path, content_type)
+          parsed_response = parse_json_evaluate_error(result.code.to_i, response.body, 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
+      rescue Net::OpenTimeout, Net::ReadTimeout
         raise Nylas::NylasSdkTimeoutError.new(request[:path], timeout)
       end
     end
@@ -97,11 +98,17 @@ module Nylas
     )
       url = build_url(path, query)
       resulting_headers = default_headers.merge(headers).merge(auth_header(api_key))
-      if !payload.nil? && !payload["multipart"]
+
+      # Check for multipart flag using both string and symbol keys for backwards compatibility
+      is_multipart = !payload.nil? && (payload["multipart"] || payload[:multipart])
+
+      if !payload.nil? && !is_multipart
         payload = payload&.to_json
         resulting_headers["Content-type"] = "application/json"
-      elsif !payload.nil? && payload["multipart"]
+      elsif is_multipart
+        # Remove multipart flag from both possible key types
         payload.delete("multipart")
+        payload.delete(:multipart)
       end
 
       { method: method, url: url, payload: payload, headers: resulting_headers, timeout: timeout }
@@ -119,23 +126,59 @@ 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
 
     private
 
-    # Sends a request to the Nylas REST API.
+    # Sends a request to the Nylas REST API using HTTParty.
     #
     # @param method [Symbol] HTTP method for the API call. Either :get, :post, :delete, or :patch.
     # @param url [String] URL for the API call.
     # @param headers [Hash] HTTP headers to include in the payload.
     # @param payload [String, Hash] Body to send with the request.
     # @param timeout [Hash] Timeout value to send with the request.
-    def rest_client_execute(method:, url:, headers:, payload:, timeout:, &block)
-      ::RestClient::Request.execute(method: method, url: url, payload: payload,
-                                    headers: headers, timeout: timeout, &block)
+    def httparty_execute(method:, url:, headers:, payload:, timeout:)
+      options = {
+        headers: headers,
+        timeout: timeout
+      }
+
+      # Handle multipart uploads
+      if payload.is_a?(Hash) && file_upload?(payload)
+        options[:multipart] = true
+        options[:body] = payload
+      elsif payload
+        options[:body] = payload
+      end
+
+      response = HTTParty.send(method, url, options)
+
+      # Create a compatible response object that mimics RestClient::Response
+      result = create_response_wrapper(response)
+
+      # Call the block with the response in the same format as rest-client
+      if block_given?
+        yield response, nil, result
+      else
+        response
+      end
+    end
+
+    # Create a response wrapper that mimics RestClient::Response.code behavior
+    def create_response_wrapper(response)
+      OpenStruct.new(code: response.code)
+    end
+
+    # Check if payload contains file uploads
+    def file_upload?(payload)
+      return false unless payload.is_a?(Hash)
+
+      payload.values.any? do |value|
+        value.respond_to?(:read) || (value.is_a?(File) && !value.closed?)
+      end
     end
 
     def setup_http(path, timeout, headers, query, api_key)
@@ -191,22 +234,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
 
@@ -217,7 +264,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:)

data/lib/nylas/resources/messages.rb

@@ -6,6 +6,19 @@ require_relative "../handler/api_operations"
 require_relative "../utils/file_utils"
 
 module Nylas
+  # Module representing the possible 'fields' values for Messages API requests.
+  # @see https://developer.nylas.com/docs/api/messages#get-/v3/grants/-identifier-/messages
+  module MessageFields
+    # Return the standard message payload (default)
+    STANDARD = "standard"
+    # Return messages and their custom headers
+    INCLUDE_HEADERS = "include_headers"
+    # Return messages and their tracking settings
+    INCLUDE_TRACKING_OPTIONS = "include_tracking_options"
+    # Return the grant_id, object, id, and raw_mime fields only
+    RAW_MIME = "raw_mime"
+  end
+
   # Nylas Messages API
   class Messages < Resource
     include ApiOperations::Get
@@ -26,6 +39,11 @@ module Nylas
     #
     # @param identifier [String] Grant ID or email account to query.
     # @param query_params [Hash, nil] Query params to pass to the request.
+    #   You can use the fields parameter to specify which data to return:
+    #   - MessageFields::STANDARD (default): Returns the standard message payload
+    #   - MessageFields::INCLUDE_HEADERS: Returns messages and their custom headers
+    #   - MessageFields::INCLUDE_TRACKING_OPTIONS: Returns messages and their tracking settings
+    #   - MessageFields::RAW_MIME: Returns the grant_id, object, id, and raw_mime fields only
     # @return [Array(Array(Hash), String, String)] The list of messages, API Request ID, and next cursor.
     def list(identifier:, query_params: nil)
       get_list(
@@ -39,6 +57,11 @@ module Nylas
     # @param identifier [String] Grant ID or email account to query.
     # @param message_id [String] The id of the message to return.
     # @param query_params [Hash, nil] Query params to pass to the request.
+    #   You can use the fields parameter to specify which data to return:
+    #   - MessageFields::STANDARD (default): Returns the standard message payload
+    #   - MessageFields::INCLUDE_HEADERS: Returns messages and their custom headers
+    #   - MessageFields::INCLUDE_TRACKING_OPTIONS: Returns messages and their tracking settings
+    #   - MessageFields::RAW_MIME: Returns the grant_id, object, id, and raw_mime fields only
     # @return [Array(Hash, String)] The message and API request ID.
     def find(identifier:, message_id:, query_params: nil)
       get(

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

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

data/lib/nylas.rb

@@ -1,21 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
-require "rest-client"
-
-# BUGFIX
-#   See https://github.com/sparklemotion/http-cookie/issues/27
-#   and https://github.com/sparklemotion/http-cookie/issues/6
-#
-# CookieJar uses unsafe class caching for dynamically loading cookie jars.
-# If two rest-client instances are instantiated at the same time (in threads), non-deterministic
-# behaviour can occur whereby the Hash cookie jar isn't properly loaded and cached.
-# Forcing an instantiation of the jar onload will force the CookieJar to load before the system has
-# a chance to spawn any threads.
-# Note that this should technically be fixed in rest-client itself, however that library appears to
-# be stagnant so we're forced to fix it here.
-# This object should get GC'd as it's not referenced by anything.
-HTTP::CookieJar.new
+require "httparty"
 
 require "ostruct"
 require "forwardable"
@@ -39,6 +25,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.3.0
+  version: 6.5.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-03 00:00:00.000000000 Z
+date: 2025-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
 - !ruby/object:Gem::Dependency
   name: mime-types
   requirement: !ruby/object:Gem::Requirement
@@ -58,26 +72,6 @@ dependencies:
     - - "~>"
       - !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'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.0.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: yajl-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -154,6 +148,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 +285,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