nylas 6.3.0 → 6.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d6aa010eb2b2938c69724103ee74d3a3898320bf31631e2d8838223ce4779a09
-  data.tar.gz: 0b91f115c36a87cab0ab5110eaffbe4a042168e5f2b152df4be16702a6040be9
+  metadata.gz: 275a09b48ad361ba1f441efa8b32a026fa547c0296ea3b681da440e6c7652516
+  data.tar.gz: 813293f38fabeb6cbfae1a9974a6e27622c68352442982a49890c176c354a2d5
 SHA512:
-  metadata.gz: 873debe33d40035191e712eb7239840e4343bc6180e657f25dac7c39b73dec6c597d57ce63e204358f8b266f237a2fa4b7a7f52766a07e6f2ef95f8f0cbeb8ff
-  data.tar.gz: efb90a1bd1930a0536b418c16de61d84bc6925e3f6fb5f9c39cde4dd77bb406dacd6fee2f7799257a3dd430e7ec9da23221ab9222d387bba75be96f806aec3e4
+  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/http_client.rb

@@ -119,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
@@ -191,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
 
@@ -217,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:)

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.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.3.0
+  version: 6.4.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-03 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